Replace proceed boolean parameter with decision enum in workflow tools

Co-authored-by: yaonyan <[email protected]>

Author: Copilot

packages/core/src/executors/workflow/workflow-executor.ts

@@ -96,7 +96,9 @@ export class WorkflowExecutor {
         };
       }
 
-      if (args.proceed === true) {
+      const decision = args.decision as string;
+      
+      if (decision === "proceed") {
         // Allow proceeding to completion even when at the last step
         if (
           !state.hasNextStep() &&
@@ -144,13 +146,50 @@ export class WorkflowExecutor {
         } else {
           state.start();
         }
+      } else if (decision === "complete") {
+        // Only allow completion at final step or when at last step and started
+        if (
+          (state.isAtLastStep() && state.isWorkflowStarted()) ||
+          (!state.hasNextStep() && state.isWorkflowStarted())
+        ) {
+          state.markCompleted();
+          return {
+            content: [
+              {
+                type: "text",
+                text: `## Workflow Completed!\n\n${
+                  this.formatProgress(state)
+                }\n\n${
+                  CompiledPrompts.workflowCompleted({
+                    totalSteps: state.getSteps().length,
+                    toolName: this.name,
+                    newWorkflowInstructions: this.predefinedSteps
+                      ? ""
+                      : " and new `steps` array",
+                  })
+                }`,
+              },
+            ],
+            isError: false,
+          };
+        } else {
+          return {
+            content: [
+              {
+                type: "text",
+                text: WorkflowPrompts.ERRORS.ALREADY_AT_FINAL,
+              },
+            ],
+            isError: true,
+          };
+        }
       }
-      // When proceed: false, stay at current step (retry)
+      // When decision is "retry" or undefined, stay at current step (retry)
     }
 
     // Validate arguments based on current state
-    // - If proceed: true, validate against the new step after moving
-    // - If proceed: false, validate against current step
+    // - If decision: "proceed", validate against the new step after moving
+    // - If decision: "retry" or undefined, validate against current step
     const validationSchema = this.createArgsDef.forCurrentState(state);
 
     const validationResult = this.validate(args, validationSchema);

packages/core/src/factories/args-def-factory.ts

@@ -83,10 +83,11 @@ Workflow step definitions - provide ONLY on initial call.
       enum: [true],
     }),
 
-    proceed: (): JSONSchema => ({
-      type: "boolean",
+    decision: (): JSONSchema => ({
+      type: "string",
+      enum: ["retry", "proceed", "complete"],
       description:
-        "**Step execution control. Set \`true\` to advance, \`false\`/omit to retry. For failed steps, MUST use \`false\`**",
+        "**Step execution control. Use \`proceed\` to advance to next step, \`retry\` to re-execute current step, or \`complete\` to finish workflow (only allowed at final step). For failed steps, MUST use \`retry\`**",
     }),
 
     action: (sampling?: boolean): JSONSchema => ({
@@ -115,10 +116,10 @@ Workflow step definitions - provide ONLY on initial call.
         ...pick(depGroups, currentStep.actions),
       } as Record<string, JSONSchema>;
 
-      stepDependencies["proceed"] = this.proceed();
+      stepDependencies["decision"] = this.decision();
       stepDependencies["action"] = this.action();
 
-      // Make proceed required when workflow is in progress and needs user decision
+      // Make decision required when workflow is in progress and needs user decision
       return this.common(stepDependencies);
     },
 
@@ -218,10 +219,10 @@ Workflow step definitions - provide ONLY on initial call.
         ...pick(depGroups, nextStep.actions),
       } as Record<string, JSONSchema>;
 
-      stepDependencies["proceed"] = this.proceed();
+      stepDependencies["decision"] = this.decision();
       stepDependencies["action"] = this.action();
 
-      // Make proceed required for next state transitions
+      // Make decision required for next state transitions
       return this.common(stepDependencies);
     },
 

packages/core/src/prompts/index.ts

@@ -60,13 +60,14 @@ export const SystemPrompts = {
 
 **⚡ SUBSEQUENT CALLS (Execution):**
 - Provide ONLY current step parameters
-- **ADVANCE STEP**: Set \`proceed: true\` to move to next step  
-- **RETRY STEP**: Set \`proceed: false\`
+- **ADVANCE STEP**: Set \`decision: "proceed"\` to move to next step  
+- **RETRY STEP**: Set \`decision: "retry"\`
+- **COMPLETE WORKFLOW**: Set \`decision: "complete"\` (only at final step)
 - Use \`reasoning\` action for thinking/analysis
 
 **🚫 Do NOT include \`steps\` parameter during normal execution**
 **✅ Include \`steps\` parameter ONLY when restarting workflow with \`init: true\`**
-**⚠️ CRITICAL: When retrying failed steps, NEVER use \`proceed: true\`**`,
+**⚠️ CRITICAL: When retrying failed steps, MUST use \`decision: "retry"\`**`,
 
   /**
    * Sampling execution system prompt with JSON output constraints
@@ -142,7 +143,7 @@ You MUST respond with a JSON object for workflow execution:
 **For Step Execution (Subsequent Calls):**
 - action: "{toolName}" OR "complete" when workflow is autonomously determined finished
 - reasoning: Your independent analysis of current step and next decision
-- proceed: true (advance to next step) OR false (retry/repeat current step)
+- decision: "proceed" (advance to next step), "retry" (retry/repeat current step), or "complete" (finish workflow)
 - [step parameters]: Tool-specific parameters you autonomously determine for current step
 
 **🎯 AGENTIC WORKFLOW CONSTRAINTS:**
@@ -154,7 +155,7 @@ You MUST respond with a JSON object for workflow execution:
 
 **🚫 Do NOT include \`steps\` parameter during normal execution**
 **✅ Include \`steps\` parameter ONLY when restarting workflow with \`init: true\`**
-**⚠️ CRITICAL: When retrying failed steps, NEVER use \`proceed: true\`**`,
+**⚠️ CRITICAL: When retrying failed steps, MUST use \`decision: "retry"\`**`,
 };
 
 /**
@@ -175,9 +176,10 @@ export const WorkflowPrompts = {
 - **Include 'steps' parameter ONLY when restarting workflow (with 'init: true')**
 - **Do NOT include 'steps' parameter during normal step execution**
 - **MUST Use the provided JSON schema definition above for parameter generation and validation**
-- **ADVANCE STEP: Set 'proceed' to true to advance to next step**
-- **RETRY STEP: Set 'proceed' to false to re-execute current step**
-- **⚠️ CRITICAL: When retrying failed steps, MUST set 'proceed' to false**
+- **ADVANCE STEP: Set 'decision' to "proceed" to advance to next step**
+- **RETRY STEP: Set 'decision' to "retry" to re-execute current step**
+- **COMPLETE WORKFLOW: Set 'decision' to "complete" to finish workflow (only at final step)**
+- **⚠️ CRITICAL: When retrying failed steps, MUST set 'decision' to "retry"**
 
 {workflowSteps}`,
 
@@ -208,11 +210,11 @@ Previous step completed. Choose your action:
 
 **🔄 RETRY Current Step:** 
 - Call \`{toolName}\` with current parameters
-- ⚠️ CRITICAL: Set \`proceed: false\`
+- ⚠️ CRITICAL: Set \`decision: "retry"\`
 
 **▶️ PROCEED to Next Step:** 
 - Call \`{toolName}\` with parameters below
-- Set \`proceed: true\`
+- Set \`decision: "proceed"\`
 
 Next step: \`{nextStepDescription}\`
 
@@ -227,11 +229,11 @@ Next step: \`{nextStepDescription}\`
 
 Current step executed {statusText}. Choose your next action:
 
-**1. ▶️ Complete Workflow:** Call \`{toolName}\` with \`proceed: true\` to finish
-**2. 🔄 Retry Final Step:** Call \`{toolName}\` with final step parameters  
+**1. ▶️ Complete Workflow:** Call \`{toolName}\` with \`decision: "complete"\` to finish
+**2. 🔄 Retry Final Step:** Call \`{toolName}\` with final step parameters and \`decision: "retry"\`
 **3. 🆕 New Workflow:** Call \`{toolName}\` with \`init: true\`{newWorkflowInstructions}
 
-**Note:** Use \`proceed: true\` to officially complete the workflow.`,
+**Note:** Use \`decision: "complete"\` to officially complete the workflow.`,
 
   /**
    * Workflow completion success message
@@ -306,7 +308,7 @@ Choose the next action that best advances toward completing the user's request.`
    */
   ERROR_RESPONSE: `Action argument validation failed: {errorMessage}`,
   WORKFLOW_ERROR_RESPONSE: `Action argument validation failed: {errorMessage}
-Set \`proceed: false\` to retry the current step.`,
+Set \`decision: "retry"\` to retry the current step.`,
 
   /**
    * Completion message

packages/core/src/types.ts

@@ -25,7 +25,7 @@ export interface ArgsDefCreator {
   ) => JSONSchema;
   steps: () => JSONSchema;
   init: () => JSONSchema;
-  proceed: () => JSONSchema;
+  decision: () => JSONSchema;
   action: () => JSONSchema;
   forTool: () => JSONSchema;
   forCurrentState: (