@polka-codes/core 0.9.24 → 0.9.26

package/dist/index.js

@@ -27,13 +27,6 @@ __export(allTools_exports, {
 import { z } from "zod";
 
 // src/tool.ts
-var PermissionLevel = /* @__PURE__ */ ((PermissionLevel2) => {
-  PermissionLevel2[PermissionLevel2["None"] = 0] = "None";
-  PermissionLevel2[PermissionLevel2["Read"] = 1] = "Read";
-  PermissionLevel2[PermissionLevel2["Write"] = 2] = "Write";
-  PermissionLevel2[PermissionLevel2["Arbitrary"] = 3] = "Arbitrary";
-  return PermissionLevel2;
-})(PermissionLevel || {});
 var ToolResponseType = /* @__PURE__ */ ((ToolResponseType2) => {
   ToolResponseType2["Reply"] = "Reply";
   ToolResponseType2["Exit"] = "Exit";
@@ -95,8 +88,7 @@ var toolInfo = {
         }
       }
     ]
-  }),
-  permissionLevel: 0 /* None */
+  })
 };
 var handler = async (provider, args) => {
   if (!provider.askFollowupQuestion) {
@@ -161,8 +153,7 @@ var toolInfo2 = {
         }
       }
     ]
-  }),
-  permissionLevel: 0 /* None */
+  })
 };
 var handler2 = async (provider, args) => {
   const parsed = toolInfo2.parameters.safeParse(args);
@@ -226,8 +217,7 @@ var toolInfo3 = {
         }
       }
     ]
-  }),
-  permissionLevel: 0 /* None */
+  })
 };
 var handler3 = async (_provider, args) => {
   const parsed = toolInfo3.parameters.safeParse(args);
@@ -285,8 +275,7 @@ var toolInfo4 = {
         }
       }
     ]
-  }),
-  permissionLevel: 3 /* Arbitrary */
+  })
 };
 var handler4 = async (provider, args) => {
   if (!provider.executeCommand) {
@@ -377,8 +366,7 @@ var toolInfo5 = {
         }
       }
     ]
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler5 = async (provider, args) => {
   if (!provider.fetchUrl) {
@@ -454,8 +442,7 @@ var toolInfo6 = {
         }
       }
     ]
-  }),
-  permissionLevel: 0 /* None */
+  })
 };
 var handler6 = async (_provider, args) => {
   const parsed = toolInfo6.parameters.safeParse(args);
@@ -520,8 +507,7 @@ var toolInfo7 = {
         }
       }
     ]
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler7 = async (provider, args) => {
   if (!provider.listFiles) {
@@ -563,8 +549,7 @@ var toolInfo8 = {
   description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.",
   parameters: z8.object({
     url: z8.string().describe("The URL or local path of the file to read.")
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler8 = async (provider, args) => {
   if (!provider.readBinaryFile) {
@@ -647,8 +632,7 @@ var toolInfo9 = {
         }
       }
     ]
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler9 = async (provider, args) => {
   if (!provider.readFile) {
@@ -708,8 +692,7 @@ var toolInfo10 = {
         }
       }
     ]
-  }),
-  permissionLevel: 2 /* Write */
+  })
 };
 var handler10 = async (provider, args) => {
   if (!provider.removeFile) {
@@ -768,8 +751,7 @@ var toolInfo11 = {
         }
       }
     ]
-  }),
-  permissionLevel: 2 /* Write */
+  })
 };
 var handler11 = async (provider, args) => {
   if (!provider.renameFile) {
@@ -988,8 +970,7 @@ function oldFeature() {
         }
       }
     ]
-  }),
-  permissionLevel: 2 /* Write */
+  })
 };
 var handler12 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
@@ -1101,8 +1082,7 @@ var toolInfo13 = {
         }
       }
     ]
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler13 = async (provider, args) => {
   if (!provider.searchFiles) {
@@ -1190,8 +1170,7 @@ export default App;
         }
       }
     ]
-  }),
-  permissionLevel: 2 /* Write */
+  })
 };
 var handler14 = async (provider, args) => {
   if (!provider.writeFile) {
@@ -1270,7 +1249,6 @@ var getAvailableTools = ({
   provider,
   allTools,
   hasAgent,
-  permissionLevel,
   interactive
 }) => {
   const filteredTools = interactive ? allTools : allTools.filter((tool) => tool.name !== askFollowupQuestion_default.name);
@@ -1283,7 +1261,7 @@ var getAvailableTools = ({
           continue;
       }
     }
-    if (tool.isAvailable(provider) && tool.permissionLevel <= permissionLevel) {
+    if (tool.isAvailable(provider)) {
       tools.push(tool);
     }
   }
@@ -2333,14 +2311,23 @@ Retrying request ${i + 2} of ${retryCount}`);
       return { type: "exit", reason: { type: "Pause", responses: toolResponses } };
     }
     if (toolResponses.length === 0) {
+      if (this.config.requireToolUse) {
+        return {
+          type: "reply",
+          message: [
+            {
+              role: "user",
+              content: responsePrompts.requireUseToolNative
+            }
+          ]
+        };
+      }
       return {
-        type: "reply",
-        message: [
-          {
-            role: "user",
-            content: responsePrompts.requireUseToolNative
-          }
-        ]
+        type: "exit",
+        reason: {
+          type: "Exit" /* Exit */,
+          message: response.filter((c) => c.type === "text").map((c) => c.content).join("")
+        }
       };
     }
     const mediaUserMessage = medias.length > 0 ? [
@@ -2384,14 +2371,23 @@ Retrying request ${i + 2} of ${retryCount}`);
       };
     }
     if (toolResponses.length === 0) {
+      if (this.config.requireToolUse) {
+        return {
+          type: "reply",
+          message: [
+            {
+              role: "user",
+              content: responsePrompts.requireUseTool
+            }
+          ]
+        };
+      }
       return {
-        type: "reply",
-        message: [
-          {
-            role: "user",
-            content: responsePrompts.requireUseTool
-          }
-        ]
+        type: "exit",
+        reason: {
+          type: "Exit" /* Exit */,
+          message: response.filter((c) => c.type === "text").map((c) => c.content).join("")
+        }
       };
     }
     const finalResp = toolResponses.filter((resp) => resp.type === "response").flatMap(({ tool, response: response2 }) => responsePrompts.toolResults(tool, response2));
@@ -2481,14 +2477,14 @@ ${customScripts(scripts)}
 `;
 
 // src/Agent/AnalyzerAgent/index.ts
+var agentTools = [askFollowupQuestion_default, attemptCompletion_default, delegate_default, fetchUrl_default, handOver_default, listFiles_default, readBinaryFile_default, readFile_default, searchFiles_default];
 var AnalyzerAgent = class extends AgentBase {
   constructor(options) {
-    const combinedTools = [...options.additionalTools ?? [], ...Object.values(allTools_exports)];
+    const combinedTools = [...options.additionalTools ?? [], ...agentTools];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
       hasAgent: (options.agents?.length ?? 0) > 0,
-      permissionLevel: 1 /* Read */,
       interactive: true
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
@@ -2515,7 +2511,8 @@ var AnalyzerAgent = class extends AgentBase {
       toolFormat: options.toolFormat,
       parameters: options.parameters ?? {},
       usageMeter: options.usageMeter ?? new UsageMeter(),
-      requestTimeoutSeconds: options.requestTimeoutSeconds
+      requestTimeoutSeconds: options.requestTimeoutSeconds,
+      requireToolUse: options.requireToolUse ?? true
     });
   }
   onBeforeInvokeTool() {
@@ -2579,14 +2576,14 @@ ${customScripts(scripts)}
 `;
 
 // src/Agent/ArchitectAgent/index.ts
+var agentTools2 = [askFollowupQuestion_default, attemptCompletion_default, delegate_default, fetchUrl_default, handOver_default, listFiles_default, readBinaryFile_default, readFile_default, searchFiles_default];
 var ArchitectAgent = class extends AgentBase {
   constructor(options) {
-    const combinedTools = [...options.additionalTools ?? [], ...Object.values(allTools_exports)];
+    const combinedTools = [...options.additionalTools ?? [], ...agentTools2];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
       hasAgent: (options.agents?.length ?? 0) > 0,
-      permissionLevel: 1 /* Read */,
       interactive: true
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
@@ -2613,7 +2610,8 @@ var ArchitectAgent = class extends AgentBase {
       toolFormat: options.toolFormat,
       parameters: options.parameters ?? {},
       usageMeter: options.usageMeter ?? new UsageMeter(),
-      requestTimeoutSeconds: options.requestTimeoutSeconds
+      requestTimeoutSeconds: options.requestTimeoutSeconds,
+      requireToolUse: options.requireToolUse ?? true
     });
   }
   onBeforeInvokeTool() {
@@ -2716,7 +2714,6 @@ var CodeFixerAgent = class extends AgentBase {
       provider: options.provider,
       allTools: combinedTools,
       hasAgent: (options.agents?.length ?? 0) > 0,
-      permissionLevel: 3 /* Arbitrary */,
       interactive: true
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
@@ -2744,7 +2741,8 @@ var CodeFixerAgent = class extends AgentBase {
       toolFormat: options.toolFormat,
       parameters: options.parameters ?? {},
       usageMeter: options.usageMeter ?? new UsageMeter(),
-      requestTimeoutSeconds: options.requestTimeoutSeconds
+      requestTimeoutSeconds: options.requestTimeoutSeconds,
+      requireToolUse: options.requireToolUse ?? true
     });
     this.#maxRetries = options.maxRetries ?? 5;
   }
@@ -2929,7 +2927,6 @@ var CoderAgent = class extends AgentBase {
       provider: options.provider,
       allTools: combinedTools,
       hasAgent: (options.agents?.length ?? 0) > 0,
-      permissionLevel: 3 /* Arbitrary */,
       interactive: true
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
@@ -2956,7 +2953,8 @@ var CoderAgent = class extends AgentBase {
       toolFormat: options.toolFormat,
       parameters: options.parameters ?? {},
       usageMeter: options.usageMeter ?? new UsageMeter(),
-      requestTimeoutSeconds: options.requestTimeoutSeconds
+      requestTimeoutSeconds: options.requestTimeoutSeconds,
+      requireToolUse: options.requireToolUse ?? true
     });
   }
   async #runScript(scriptName, shouldReplyWithError) {
@@ -3733,7 +3731,7 @@ var toolInfo15 = {
       return val;
     }, z17.boolean().optional().default(false)).describe("Get staged changes instead of unstaged changes."),
     commitRange: z17.string().optional().describe('The commit range to get the diff for (e.g., "main...HEAD").'),
-    file: z17.string().optional().describe("Get the diff for a specific file."),
+    file: z17.string().describe("Get the diff for a specific file."),
     contextLines: z17.coerce.number().optional().default(5).describe("Number of context lines to include around changes."),
     includeLineNumbers: z17.preprocess((val) => {
       if (typeof val === "string") {
@@ -3743,8 +3741,7 @@ var toolInfo15 = {
       }
       return val;
     }, z17.boolean().optional().default(false)).describe("Annotate the diff with line numbers for additions and deletions.")
-  }),
-  permissionLevel: 1 /* Read */
+  })
 };
 var handler15 = async (provider, args) => {
   if (!provider.executeCommand) {
@@ -3828,50 +3825,64 @@ var prompt5 = `
 You are a senior software engineer reviewing code changes.
 
 ## Critical Instructions
-**ONLY review the actual changes shown in the diff.** Do not comment on existing code that wasn't modified.
+- **ONLY review the actual changes shown in the diff.** Do not comment on existing code that wasn't modified.
+- **ONLY run git_diff on files that are reviewable source/config files** per the "File Selection for git_diff" rules below. Do not pass excluded files to git_diff.
+
+## File Selection for git_diff
+Use <file_status> to decide which files to diff. Include only files likely to contain human-authored source or meaningful configuration.
+
+Include (run git_diff):
+- Application/source code
+- UI/templates/assets code
+- Infra/config that affects behavior
+
+Exclude (do NOT run git_diff; do not review):
+- Lockfiles
+- Generated/build artifacts & deps
+- Test artifacts/snapshots
+- Data and fixtures
+- Binary/media/minified/maps
 
 ## Viewing Changes
-- **Use git_diff** to inspect the actual code changes for each relevant file.
-  - **Pull request**: use the provided commit range for the git_diff tool with contextLines: 5 and includeLineNumbers: true
-  - **Local changes**: diff staged or unstaged files using the git_diff tool with contextLines: 5 and includeLineNumbers: true
-- The diff will include line number annotations: [Line N] for additions and [Line N removed] for deletions
-- If a pull request is present you may receive:
+- For each included file, **use git_diff** to inspect the actual code changes:
+  - **Pull request:** use the provided commit range for the git_diff tool with contextLines: 5 and includeLineNumbers: true, but only surface and review the included files.
+  - **Local changes:** diff staged or unstaged included files using git_diff with contextLines: 5 and includeLineNumbers: true.
+- The diff will include line number annotations: [Line N] for additions and [Line N removed] for deletions.
+- You may receive:
   - <pr_title>
   - <pr_description>
   - <commit_messages>
 - A <review_instructions> tag tells you the focus of the review.
-- File status information is provided in <file_status> - use this to understand which files were modified, added, deleted, or renamed.
+- Use <file_status> to understand which files were modified, added, deleted, or renamed and to apply the inclusion/exclusion rules above.
 
 ## Line Number Reporting
-- **IMPORTANT**: Use the line numbers from the annotations in the diff output
-- For additions: Look for [Line N] annotations after the + lines
-- For deletions: Look for [Line N removed] annotations after the - lines
-- For modifications: Report the line number of the new/current code (from [Line N] annotations)
-- Report single lines as "N" and ranges as "N-M"
+- Use the line numbers from the annotations in the diff output.
+- For additions: use the number from the [Line N] annotation after the + line.
+- For deletions: use the number from the [Line N removed] annotation after the - line.
+- For modifications: report the line number of the new/current code (from [Line N]).
+- Report single lines as "N" and ranges as "N-M".
 
 ## Review Guidelines
 Focus exclusively on the changed lines (+ additions, - deletions, modified lines):
-- **Specific issues**: Point to exact problems in the changed code with accurate line references from the annotations
-- **Actionable fixes**: Provide concrete solutions, not vague suggestions
-- **Clear reasoning**: Explain why each issue matters and how to fix it
-- **Avoid generic advice**: No generic suggestions like "add more tests", "improve documentation", or "follow best practices" unless directly related to a specific problem in the diff
+- **Specific issues:** Point to exact problems in the changed code with accurate line references from the annotations.
+- **Actionable fixes:** Provide concrete solutions, not vague suggestions.
+- **Clear reasoning:** Explain why each issue matters and how to fix it.
+- **Avoid generic advice** unless directly tied to a specific problem visible in the diff.
 
 ## What NOT to review
-- Existing unchanged code
-- Overall project structure or architecture (unless directly impacted by changes)
-- Generic best practices unrelated to the specific changes
-- Missing features or functionality not part of this diff
+- Files excluded by the "File Selection for git_diff" rules (do not diff or comment on them).
+- Existing unchanged code.
+- Overall project structure/architecture unless directly impacted by the changes.
+- Missing features or functionality not part of this diff.
 
 ## Output Format
-Do **not** include praise or positive feedback. Ignore generated files such as lock files.
+Do not include praise or positive feedback.
 Only include reviews for actual issues found in the changed code.
 
 Return your review as a JSON object inside a \`\`\`json block, wrapped like:
-<tool_attempt_completion>
-<tool_parameter_result>
 \`\`\`json
 {
-  "overview": "Summary of specific issues found in the diff changes, or 'No issues found' if the changes look good.",
+  "overview": "Summary of specific issues found in the diff changes, 'No issues found', or 'No reviewable changes' if all modified files were excluded.",
   "specificReviews": [
     {
       "file": "path/filename.ext",
@@ -3881,8 +3892,6 @@ Return your review as a JSON object inside a \`\`\`json block, wrapped like:
   ]
 }
 \`\`\`
-</tool_parameter_result>
-</tool_attempt_completion>
 `;
 var reviewDiff_default = {
   name: "reviewDiff",
@@ -3942,7 +3951,8 @@ ${output}`,
   agent: (options) => {
     return new AnalyzerAgent({
       ...options,
-      additionalTools: [gitDiff_default]
+      additionalTools: [gitDiff_default],
+      requireToolUse: false
     });
   }
 };
@@ -4004,6 +4014,382 @@ var generateGithubPullRequestDetails = makeTool(generateGithubPullRequestDetails
 var reviewDiff = makeAgentTool(reviewDiff_default);
 var generateProjectConfig = makeMultiAgentTool(generateProjectConfig_default);
 var createNewProject = makeMultiAgentTool(createNewProject_default);
+
+// src/workflow/utils.ts
+import { template } from "lodash";
+var resolveTemplatedString = (templatedString, input) => {
+  if (typeof templatedString === "string") {
+    return templatedString;
+  }
+  if (templatedString.type === "function") {
+    return templatedString.fn(input);
+  }
+  return template(templatedString.template)(input);
+};
+
+// src/workflow/agent.ts
+var agentRegistry = {
+  analyzer: AnalyzerAgent,
+  architect: ArchitectAgent,
+  coder: CoderAgent,
+  codefixer: CodeFixerAgent
+};
+var WorkflowAgent = class extends AgentBase {
+  onBeforeInvokeTool(_name, _args) {
+    return Promise.resolve(void 0);
+  }
+};
+var makeAgentStepSpecHandler = (getModelFn) => ({
+  type: "agent",
+  handler(step) {
+    return {
+      ...step,
+      async run(input, context, resumedState) {
+        try {
+          const model = await getModelFn(step, context);
+          const parameters = context.parameters ?? {};
+          const budget = step.budget ?? parameters?.budget;
+          const maxMessages = step.maxMessages ?? parameters?.maxMessages;
+          const usageMeter = new UsageMeter({}, { maxMessages, maxCost: budget });
+          const toolFormat = step.toolFormat ?? parameters.toolFormat ?? "native";
+          const policies = parameters.policies ?? [];
+          const modelParameters = { ...parameters.modelParameters ?? {}, ...step.modelParameters ?? {} };
+          if (resumedState?.usage) {
+            usageMeter.setUsage(resumedState.usage);
+          }
+          const getAgent = () => {
+            if ("agent" in step) {
+              const agentName = step.agent;
+              const AgentClass = agentRegistry[agentName];
+              if (!AgentClass) {
+                throw new Error(`Unknown agent: ${agentName}`);
+              }
+              const agentOptions = {
+                ai: model,
+                os: parameters.os ?? "linux",
+                provider: context.provider,
+                interactive: false,
+                toolFormat,
+                additionalTools: step.tools,
+                policies,
+                usageMeter,
+                parameters: modelParameters,
+                scripts: parameters.scripts
+              };
+              return new AgentClass(agentOptions);
+            } else {
+              const systemPrompt = resolveTemplatedString(step.systemPrompt, input);
+              return new WorkflowAgent("agent", model, {
+                systemPrompt,
+                tools: step.tools,
+                toolNamePrefix: toolFormat === "native" ? "" : "tool_",
+                provider: context.provider,
+                interactive: false,
+                agents: [],
+                scripts: parameters.scripts,
+                callback: void 0,
+                policies,
+                toolFormat,
+                parameters: modelParameters,
+                usageMeter,
+                requireToolUse: true
+              });
+            }
+          };
+          const agent = getAgent();
+          if (resumedState?.messages) {
+            agent.setMessages(resumedState.messages);
+          }
+          const userContentArray = step.messages.map((message) => {
+            if (typeof message === "string" || Array.isArray(message)) {
+              return message;
+            }
+            return resolveTemplatedString(message, input);
+          });
+          const combinedContentParts = [];
+          for (const content of userContentArray) {
+            if (typeof content === "string") {
+              combinedContentParts.push({ type: "text", text: content });
+            } else {
+              combinedContentParts.push(...content);
+            }
+          }
+          const exitReason = await agent.start(combinedContentParts);
+          const handleExitReason = (reason) => {
+            switch (reason.type) {
+              case "Pause":
+                return { type: "paused", state: { messages: agent.messages } };
+              case "UsageExceeded":
+                return { type: "error", error: new Error("Usage limit exceeded") };
+              case "Exit" /* Exit */:
+              case "HandOver" /* HandOver */:
+              case "Delegate" /* Delegate */:
+                return { type: "success", output: reason };
+              case "Aborted":
+              case "WaitForUserInput":
+                return { type: "error", error: new Error(`Agent exited for reason: ${reason.type}`) };
+              case "Interrupted" /* Interrupted */:
+                return { type: "error", error: new Error(JSON.stringify(reason.message)) };
+              default:
+                return {
+                  type: "error",
+                  error: new Error(`Agent exited for an unhandled reason: ${JSON.stringify(reason)}`)
+                };
+            }
+          };
+          return handleExitReason(exitReason);
+        } catch (e) {
+          return { type: "error", error: e instanceof Error ? e : new Error(String(e)) };
+        }
+      }
+    };
+  }
+});
+
+// src/workflow/builder.ts
+var StepsBuilder = class {
+  #steps = [];
+  build() {
+    if (this.#steps.length === 0) {
+      throw new Error("A workflow must have at least one step.");
+    }
+    const rootStep = this.#steps.length > 1 ? {
+      id: "root",
+      type: "sequential",
+      steps: this.#steps
+    } : this.#steps[0];
+    return rootStep;
+  }
+  step(step) {
+    this.#steps.push(step);
+    return this;
+  }
+  parallel(id, step) {
+    return this.step({
+      id,
+      type: "parallel",
+      step
+    });
+  }
+  custom(id, run2) {
+    return this.step({
+      id,
+      type: "custom",
+      run: run2
+    });
+  }
+  agent(id, spec) {
+    return this.step({
+      ...spec,
+      id,
+      type: "agent"
+    });
+  }
+};
+var builder = () => {
+  return new StepsBuilder();
+};
+
+// src/workflow/command.ts
+var commandStepSpecHandler = {
+  type: "command",
+  handler(step) {
+    return {
+      ...step,
+      async run(input, context) {
+        try {
+          if (!context.provider.executeCommand) {
+            throw new Error("executeCommand is not available in the provider");
+          }
+          const command = step.command.map((arg) => resolveTemplatedString(arg, input));
+          const commandString = command.map((arg) => {
+            if (/[^A-Za-z0-9_/:=-]/.test(arg)) {
+              return `"${arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+            }
+            return arg;
+          }).join(" ");
+          const result = await context.provider.executeCommand(commandString, false);
+          const output = {};
+          if (step.outputs?.includes("stdout")) {
+            output.stdout = result.stdout;
+          }
+          if (step.outputs?.includes("stderr")) {
+            output.stderr = result.stderr;
+          }
+          if (step.outputs?.includes("exitCode")) {
+            output.exitCode = result.exitCode;
+          }
+          return { type: "success", output };
+        } catch (e) {
+          return { type: "error", error: e instanceof Error ? e : new Error(String(e)) };
+        }
+      }
+    };
+  }
+};
+
+// src/workflow/runStep.ts
+var runStep = async (step, input, context, resumedState, allOutputs) => {
+  try {
+    const validatedInput = step.inputSchema?.parse(input) ?? input;
+    const result = await step.run({ ...validatedInput, $: allOutputs }, context, resumedState);
+    if (result.type === "success") {
+      const validatedOutput = step.outputSchema?.parse(result.output) ?? result.output;
+      return {
+        ...result,
+        output: validatedOutput
+      };
+    }
+    return result;
+  } catch (error) {
+    return { type: "error", error };
+  }
+};
+
+// src/workflow/steps.ts
+var combineHandlers = (...handlers) => {
+  const allHandlers = {};
+  for (const handler16 of handlers) {
+    if (allHandlers[handler16.type]) {
+      throw new Error(`Handler with type ${handler16.type} already exists`);
+    }
+    allHandlers[handler16.type] = handler16;
+  }
+  return (step, rootHandler) => {
+    const handler16 = allHandlers[step.type];
+    if (!handler16) {
+      throw new Error(`No handler found for step type: ${step.type}`);
+    }
+    return handler16.handler(step, rootHandler);
+  };
+};
+var sequentialStepSpecHandler = {
+  type: "sequential",
+  handler(step, rootHandler) {
+    const steps = step.steps.map((subStep) => rootHandler(subStep, rootHandler));
+    return {
+      ...step,
+      async run(input, context, resumedState) {
+        let currentInput = input;
+        const allOutputs = resumedState ? resumedState.allOutputs : {};
+        const startStepIndex = resumedState ? resumedState.stepIndex : 0;
+        for (let i = startStepIndex; i < steps.length; i++) {
+          const subStep = steps[i];
+          const stateToPass = i === startStepIndex && resumedState ? resumedState.stepState : void 0;
+          const result = await runStep(subStep, currentInput, context, stateToPass, allOutputs);
+          switch (result.type) {
+            case "paused":
+              return {
+                type: "paused",
+                state: { stepIndex: i, stepState: result.state, allOutputs }
+              };
+            case "error":
+              return result;
+            // Propagate error
+            case "success":
+              if (subStep.id) {
+                allOutputs[subStep.id] = result.output;
+              }
+              currentInput = result.output;
+              break;
+          }
+        }
+        return { type: "success", output: currentInput };
+      }
+    };
+  }
+};
+var parallelStepSpecHandler = {
+  type: "parallel",
+  handler(step, rootHandler) {
+    const innerStep = rootHandler(step.step, rootHandler);
+    return {
+      ...step,
+      async run(input, context, resumedState) {
+        const items = input.items ?? [];
+        const promises = items.map((innerInput, index) => {
+          const previousResult = resumedState?.[index];
+          if (previousResult) {
+            if (previousResult.type === "paused") {
+              return runStep(innerStep, innerInput, context, previousResult.state, input.$);
+            }
+            return previousResult;
+          }
+          return runStep(innerStep, innerInput, context, void 0, input.$);
+        });
+        const results = await Promise.all(promises);
+        const errors = results.filter((r) => r.type === "error");
+        if (errors.length > 0) {
+          return {
+            type: "error",
+            error: new Error(`Multiple errors: ${errors.map((e) => e.error).join(", ")}`)
+          };
+        }
+        const isPaused = results.some((r) => r.type === "paused");
+        if (isPaused) {
+          return { type: "paused", state: results };
+        }
+        const outputs = results.map((r) => r.output);
+        return { type: "success", output: { results: outputs } };
+      }
+    };
+  }
+};
+var customStepSpecHandler = {
+  type: "custom",
+  handler(step) {
+    return {
+      ...step,
+      async run(input, context, resumedState) {
+        return step.run(input, context, resumedState);
+      }
+    };
+  }
+};
+
+// src/workflow/workflow.ts
+var run = async (workflow, context, handler16, input) => {
+  const rootStep = handler16(workflow.step, handler16);
+  const result = await runStep(rootStep, input, context, void 0, {});
+  switch (result.type) {
+    case "paused":
+      return {
+        type: "paused",
+        state: result.state
+      };
+    case "error":
+      return {
+        type: "error",
+        error: result.error
+      };
+    case "success":
+      return {
+        type: "success",
+        output: result.output
+      };
+  }
+};
+var resume = async (workflow, context, handler16, state, input) => {
+  const rootStep = handler16(workflow.step, handler16);
+  const result = await runStep(rootStep, input, context, state, {});
+  switch (result.type) {
+    case "paused":
+      return {
+        type: "paused",
+        state: result.state
+      };
+    case "error":
+      return {
+        type: "error",
+        error: result.error
+      };
+    case "success":
+      return {
+        type: "success",
+        output: result.output
+      };
+  }
+};
 export {
   AgentBase,
   AnalyzerAgent,
@@ -4013,7 +4399,6 @@ export {
   EnableCachePolicy,
   MockProvider,
   MultiAgent,
-  PermissionLevel,
   Policies,
   TaskEventKind,
   ToolResponseType,
@@ -4026,13 +4411,17 @@ export {
   architectAgentInfo,
   askFollowupQuestion_default as askFollowupQuestion,
   attemptCompletion_default as attemptCompletion,
+  builder,
   capabilities,
   codeFixerAgentInfo,
   coderAgentInfo,
+  combineHandlers,
+  commandStepSpecHandler,
   configSchema,
   createNewProject,
   customInstructions,
   customScripts,
+  customStepSpecHandler,
   delegate_default as delegate,
   executeAgentTool,
   executeCommand_default as executeCommand,
@@ -4045,9 +4434,11 @@ export {
   getAvailableTools,
   handOver_default as handOver,
   listFiles_default as listFiles,
+  makeAgentStepSpecHandler,
   makeAgentTool,
   makeMultiAgentTool,
   makeTool,
+  parallelStepSpecHandler,
   parseAssistantMessage,
   readBinaryFile_default as readBinaryFile,
   readFile_default as readFile,
@@ -4056,8 +4447,11 @@ export {
   replaceInFile_default as replaceInFile,
   replaceInFile as replaceInFileHelper,
   responsePrompts,
+  resume,
   reviewDiff,
+  run,
   searchFiles_default as searchFiles,
+  sequentialStepSpecHandler,
   systemInformation,
   toolUsePrompt,
   writeToFile_default as writeToFile