@polka-codes/core 0.9.26 → 0.9.28

package/dist/index.js

@@ -1,28 +1,3 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/tools/allTools.ts
-var allTools_exports = {};
-__export(allTools_exports, {
-  askFollowupQuestion: () => askFollowupQuestion_default,
-  attemptCompletion: () => attemptCompletion_default,
-  delegate: () => delegate_default,
-  executeCommand: () => executeCommand_default,
-  fetchUrl: () => fetchUrl_default,
-  handOver: () => handOver_default,
-  listFiles: () => listFiles_default,
-  readBinaryFile: () => readBinaryFile_default,
-  readFile: () => readFile_default,
-  removeFile: () => removeFile_default,
-  renameFile: () => renameFile_default,
-  replaceInFile: () => replaceInFile_default,
-  searchFiles: () => searchFiles_default,
-  writeToFile: () => writeToFile_default
-});
-
 // src/tools/askFollowupQuestion.ts
 import { z } from "zod";
 
@@ -112,9 +87,9 @@ var handler = async (provider, args) => {
   }
   const answers = [];
   for (const question of questions) {
-    const { prompt: prompt6, options } = question;
-    const answer = await provider.askFollowupQuestion(prompt6, options);
-    answers.push(`<ask_followup_question_answer question="${prompt6}">
+    const { prompt: prompt5, options } = question;
+    const answer = await provider.askFollowupQuestion(prompt5, options);
+    answers.push(`<ask_followup_question_answer question="${prompt5}">
 ${answer}
 </ask_followup_question_answer>`);
   }
@@ -287,11 +262,11 @@ var handler4 = async (provider, args) => {
       }
     };
   }
-  const { command, requiresApproval } = toolInfo4.parameters.parse(args);
+  const { command: command2, requiresApproval } = toolInfo4.parameters.parse(args);
   try {
-    console.log("Executing command:", command, "Requires approval:", requiresApproval);
-    const result = await provider.executeCommand(command, requiresApproval);
-    const message = `<command>${command}</command>
+    console.log("Executing command:", command2, "Requires approval:", requiresApproval);
+    const result = await provider.executeCommand(command2, requiresApproval);
+    const message = `<command>${command2}</command>
 <command_exit_code>${result.exitCode}</command_exit_code>
 <command_stdout>
 ${result.stdout}
@@ -542,6 +517,37 @@ var listFiles_default = {
   isAvailable: isAvailable7
 };
 
+// src/tools/provider.ts
+var MockProvider = class {
+  async readFile(_path, _includeIgnored) {
+    return "mock content";
+  }
+  async writeFile(_path, _content) {
+    return;
+  }
+  async removeFile(_path) {
+    return;
+  }
+  async renameFile(_sourcePath, _targetPath) {
+    return;
+  }
+  async listFiles(_path, _recursive, _maxCount, _includeIgnored) {
+    return [["mock-file.txt"], false];
+  }
+  async searchFiles(_path, _regex, _filePattern) {
+    return ["mock-file.txt"];
+  }
+  async executeCommand(_command, _needApprove) {
+    return { stdout: "mock output", stderr: "", exitCode: 0 };
+  }
+  async askFollowupQuestion(_question, _options) {
+    return "mock answer";
+  }
+  async attemptCompletion(_result) {
+    return "mock completion";
+  }
+};
+
 // src/tools/readBinaryFile.ts
 import { z as z8 } from "zod";
 var toolInfo8 = {
@@ -1213,47 +1219,14 @@ var writeToFile_default = {
   isAvailable: isAvailable14
 };
 
-// src/tools/provider.ts
-var MockProvider = class {
-  async readFile(_path, _includeIgnored) {
-    return "mock content";
-  }
-  async writeFile(_path, _content) {
-    return;
-  }
-  async removeFile(_path) {
-    return;
-  }
-  async renameFile(_sourcePath, _targetPath) {
-    return;
-  }
-  async listFiles(_path, _recursive, _maxCount, _includeIgnored) {
-    return [["mock-file.txt"], false];
-  }
-  async searchFiles(_path, _regex, _filePattern) {
-    return ["mock-file.txt"];
-  }
-  async executeCommand(_command, _needApprove) {
-    return { stdout: "mock output", stderr: "", exitCode: 0 };
-  }
-  async askFollowupQuestion(_question, _options) {
-    return "mock answer";
-  }
-  async attemptCompletion(_result) {
-    return "mock completion";
-  }
-};
-
 // src/getAvailableTools.ts
 var getAvailableTools = ({
   provider,
   allTools,
-  hasAgent,
-  interactive
+  hasAgent
 }) => {
-  const filteredTools = interactive ? allTools : allTools.filter((tool) => tool.name !== askFollowupQuestion_default.name);
   const tools = [];
-  for (const tool of filteredTools) {
+  for (const tool of allTools) {
     if (!hasAgent) {
       switch (tool.name) {
         case handOver_default.name:
@@ -1270,8 +1243,7 @@ var getAvailableTools = ({
 
 // src/UsageMeter.ts
 var UsageMeter = class {
-  #totals = { input: 0, output: 0, cachedRead: 0, cost: 0 };
-  #calls = 0;
+  #totals = { input: 0, output: 0, cachedRead: 0, cost: 0, messageCount: 0 };
   #modelInfos;
   #maxMessages;
   #maxCost;
@@ -1354,7 +1326,7 @@ var UsageMeter = class {
     this.#totals.output += result.output;
     this.#totals.cachedRead += result.cachedRead;
     this.#totals.cost += result.cost;
-    this.#calls++;
+    this.#totals.messageCount += 1;
   }
   /** Override the running totals (e.g., restore from saved state). */
   setUsage(newUsage) {
@@ -1362,21 +1334,20 @@ var UsageMeter = class {
     if (newUsage.output != null) this.#totals.output = newUsage.output;
     if (newUsage.cachedRead != null) this.#totals.cachedRead = newUsage.cachedRead;
     if (newUsage.cost != null) this.#totals.cost = newUsage.cost;
-    if (newUsage.calls != null) this.#calls = newUsage.calls;
+    if (newUsage.messageCount != null) this.#totals.messageCount = newUsage.messageCount;
   }
-  /** Manually bump the message count (useful if you record some calls without token info). */
+  /** Manually bump the message count (useful if you record some messages without token info). */
   incrementMessageCount(n = 1) {
-    this.#calls += n;
+    this.#totals.messageCount += n;
   }
   /** Reset the running totals. */
   resetUsage() {
-    this.#totals = { input: 0, output: 0, cachedRead: 0, cost: 0 };
-    this.#calls = 0;
+    this.#totals = { input: 0, output: 0, cachedRead: 0, cost: 0, messageCount: 0 };
   }
   /** Return true once either messages or cost exceed the configured caps. */
   isLimitExceeded() {
-    const messageCount = this.#maxMessages !== void 0 && this.#calls >= this.#maxMessages;
-    const cost = this.#maxCost !== void 0 && this.#totals.cost >= this.#maxCost;
+    const messageCount = this.#maxMessages > 0 && this.#totals.messageCount >= this.#maxMessages;
+    const cost = this.#maxCost > 0 && this.#totals.cost >= this.#maxCost;
     return {
       messageCount,
       maxMessages: this.#maxMessages,
@@ -1396,7 +1367,7 @@ var UsageMeter = class {
   }
   /** Getter for the aggregated totals (immutable copy). */
   get usage() {
-    return { ...this.#totals, messageCount: this.#calls };
+    return { ...this.#totals };
   }
   /** Print a concise usage summary to console. */
   printUsage(customConsole = console) {
@@ -1774,14 +1745,14 @@ The following additional instructions are provided by the user, and should be fo
 ${joined}`;
 };
 var customScripts = (commands) => {
-  const joined = Object.entries(commands).map(([name, command]) => {
-    if (typeof command === "string") {
+  const joined = Object.entries(commands).map(([name, command2]) => {
+    if (typeof command2 === "string") {
       return `- ${name}
-  - Command: \`${command}\``;
+  - Command: \`${command2}\``;
     }
     return `- ${name}
-  - Command: \`${command.command}\`
-  - Description: ${command.description}`;
+  - Command: \`${command2.command}\`
+  - Description: ${command2.description}`;
   }).join("\n");
   if (joined.trim() === "") {
     return "";
@@ -1866,7 +1837,7 @@ Avoid unnecessary escape characters or special characters.
         ];
     }
   },
-  commandResult: (command, exitCode, stdout, stderr) => `<command>${command}</command>
+  commandResult: (command2, exitCode, stdout, stderr) => `<command>${command2}</command>
 <command_exit_code>${exitCode}</command_exit_code>
 <command_stdout>
 ${stdout}
@@ -1972,18 +1943,18 @@ ${instance.prompt}`;
   async #callback(event) {
     await this.config.callback?.(event);
   }
-  async start(prompt6) {
+  async start(prompt5) {
     this.#callback({ kind: "StartTask" /* StartTask */, agent: this, systemPrompt: this.config.systemPrompt });
-    return await this.#processLoop(prompt6);
+    return await this.#processLoop(prompt5);
   }
-  async step(prompt6) {
+  async step(prompt5) {
     if (this.#messages.length === 0) {
       this.#callback({ kind: "StartTask" /* StartTask */, agent: this, systemPrompt: this.config.systemPrompt });
     }
     return await this.#request([
       {
         role: "user",
-        content: prompt6
+        content: prompt5
       }
     ]);
   }
@@ -2404,8 +2375,8 @@ Retrying request ${i + 2} of ${retryCount}`);
   }
   async #invokeTool(name, args) {
     try {
-      const handler16 = this.handlers[name]?.handler;
-      if (!handler16) {
+      const handler15 = this.handlers[name]?.handler;
+      if (!handler15) {
         return {
           type: "Error" /* Error */,
           message: {
@@ -2427,7 +2398,7 @@ Retrying request ${i + 2} of ${retryCount}`);
       if (resp) {
         return resp;
       }
-      return await handler16(this.config.provider, args);
+      return await handler15(this.config.provider, args);
     } catch (error) {
       return {
         type: "Error" /* Error */,
@@ -2477,15 +2448,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 agentTools = [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 ?? [], ...agentTools];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
-      hasAgent: (options.agents?.length ?? 0) > 0,
-      interactive: true
+      hasAgent: (options.agents?.length ?? 0) > 0
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt(
@@ -2503,7 +2473,6 @@ var AnalyzerAgent = class extends AgentBase {
       tools,
       toolNamePrefix,
       provider: options.provider,
-      interactive: options.interactive,
       agents: options.agents,
       scripts: options.scripts,
       callback: options.callback,
@@ -2576,15 +2545,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 agentTools2 = [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 ?? [], ...agentTools2];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
-      hasAgent: (options.agents?.length ?? 0) > 0,
-      interactive: true
+      hasAgent: (options.agents?.length ?? 0) > 0
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt2(
@@ -2602,7 +2570,6 @@ var ArchitectAgent = class extends AgentBase {
       tools,
       toolNamePrefix,
       provider: options.provider,
-      interactive: options.interactive,
       agents: options.agents,
       scripts: options.scripts,
       callback: options.callback,
@@ -2694,7 +2661,7 @@ RETRY GUIDELINES
    - Explain why the issue remains
    - Suggest manual intervention steps
    - Report any partial improvements`;
-var fullSystemPrompt3 = (info, tools, toolNamePrefix, instructions, scripts, _interactive, useNativeTool) => `
+var fullSystemPrompt3 = (info, tools, toolNamePrefix, instructions, scripts, useNativeTool) => `
 ${basePrompt}
 ${toolUsePrompt(useNativeTool, tools, toolNamePrefix)}
 ${codeFixingStrategies}
@@ -2705,16 +2672,30 @@ ${customInstructions(instructions)}
 ${customScripts(scripts)}`;
 
 // src/Agent/CodeFixerAgent/index.ts
+var agentTools3 = [
+  attemptCompletion_default,
+  delegate_default,
+  executeCommand_default,
+  fetchUrl_default,
+  handOver_default,
+  listFiles_default,
+  readBinaryFile_default,
+  readFile_default,
+  removeFile_default,
+  renameFile_default,
+  replaceInFile_default,
+  searchFiles_default,
+  writeToFile_default
+];
 var CodeFixerAgent = class extends AgentBase {
   #maxRetries;
   #retryCount = 0;
   constructor(options) {
-    const combinedTools = [...options.additionalTools ?? [], ...Object.values(allTools_exports)];
+    const combinedTools = [...options.additionalTools ?? [], ...agentTools3];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
-      hasAgent: (options.agents?.length ?? 0) > 0,
-      interactive: true
+      hasAgent: (options.agents?.length ?? 0) > 0
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt3(
@@ -2725,7 +2706,6 @@ var CodeFixerAgent = class extends AgentBase {
       toolNamePrefix,
       options.customInstructions ?? [],
       options.scripts ?? {},
-      options.interactive,
       options.toolFormat === "native"
     );
     super(codeFixerAgentInfo.name, options.ai, {
@@ -2733,7 +2713,6 @@ var CodeFixerAgent = class extends AgentBase {
       tools,
       toolNamePrefix,
       provider: options.provider,
-      interactive: options.interactive,
       agents: options.agents,
       scripts: options.scripts,
       callback: options.callback,
@@ -2920,14 +2899,28 @@ ${customScripts(scripts)}
 `;
 
 // src/Agent/CoderAgent/index.ts
+var agentTools4 = [
+  attemptCompletion_default,
+  delegate_default,
+  executeCommand_default,
+  fetchUrl_default,
+  handOver_default,
+  listFiles_default,
+  readBinaryFile_default,
+  readFile_default,
+  removeFile_default,
+  renameFile_default,
+  replaceInFile_default,
+  searchFiles_default,
+  writeToFile_default
+];
 var CoderAgent = class extends AgentBase {
   constructor(options) {
-    const combinedTools = [...options.additionalTools ?? [], ...Object.values(allTools_exports)];
+    const combinedTools = [...options.additionalTools ?? [], ...agentTools4];
     const tools = getAvailableTools({
       provider: options.provider,
       allTools: combinedTools,
-      hasAgent: (options.agents?.length ?? 0) > 0,
-      interactive: true
+      hasAgent: (options.agents?.length ?? 0) > 0
     });
     const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt4(
@@ -2945,7 +2938,6 @@ var CoderAgent = class extends AgentBase {
       tools,
       toolNamePrefix,
       provider: options.provider,
-      interactive: options.interactive,
       agents: options.agents,
       scripts: options.scripts,
       callback: options.callback,
@@ -2963,21 +2955,21 @@ var CoderAgent = class extends AgentBase {
       return;
     }
     const script = this.config.scripts?.[scriptName];
-    const command = typeof script === "string" ? script : script?.command;
-    if (command) {
+    const command2 = typeof script === "string" ? script : script?.command;
+    if (command2) {
       try {
-        const { exitCode, stdout, stderr } = await executeCommand(command, false);
+        const { exitCode, stdout, stderr } = await executeCommand(command2, false);
         if (exitCode !== 0 && shouldReplyWithError) {
           return {
             type: "Reply" /* Reply */,
             message: {
               type: "error-text",
-              value: responsePrompts.commandResult(command, exitCode, stdout, stderr)
+              value: responsePrompts.commandResult(command2, exitCode, stdout, stderr)
             }
           };
         }
       } catch (error) {
-        console.warn(`Failed to run ${scriptName} using command: ${command}`, error);
+        console.warn(`Failed to run ${scriptName} using command: ${command2}`, error);
       }
     }
   }
@@ -3018,24 +3010,24 @@ var MultiAgent = class {
     switch (exitReason.type) {
       case "HandOver" /* HandOver */: {
         this.#agents.pop();
-        const prompt6 = await this.#config.getPrompt?.(
+        const prompt5 = await this.#config.getPrompt?.(
           exitReason.agentName,
           exitReason.task,
           exitReason.context,
           exitReason.files,
           this.#originalTask
         ) ?? exitReason.task;
-        return await this.#startTask(exitReason.agentName, prompt6);
+        return await this.#startTask(exitReason.agentName, prompt5);
       }
       case "Delegate" /* Delegate */: {
-        const prompt6 = await this.#config.getPrompt?.(
+        const prompt5 = await this.#config.getPrompt?.(
           exitReason.agentName,
           exitReason.task,
           exitReason.context,
           exitReason.files,
           this.#originalTask
         ) ?? exitReason.task;
-        const delegateResult = await this.#startTask(exitReason.agentName, prompt6);
+        const delegateResult = await this.#startTask(exitReason.agentName, prompt5);
         switch (delegateResult.type) {
           case "HandOver" /* HandOver */:
           case "Delegate" /* Delegate */:
@@ -3094,6 +3086,28 @@ var MultiAgent = class {
   }
 };
 
+// src/Agent/parseJsonFromMarkdown.ts
+var parseJsonFromMarkdown = (markdown) => {
+  const jsonRegex = /```(?:json)?\n([\s\S]*?)\n```/;
+  const match = markdown.match(jsonRegex);
+  if (match?.[1]) {
+    const content = match[1].trim();
+    let parsed = JSON.parse(content);
+    if (typeof parsed === "string") {
+      try {
+        parsed = JSON.parse(parsed);
+      } catch {
+      }
+    }
+    return parsed;
+  }
+  try {
+    return JSON.parse(markdown);
+  } catch (_error) {
+  }
+  return markdown;
+};
+
 // src/config.ts
 import { z as z16 } from "zod";
 var toolFormatSchema = z16.enum(["native", "polka-codes"]).optional();
@@ -3659,304 +3673,6 @@ var generateProjectConfig_default = {
   agent: "analyzer"
 };
 
-// src/AiTool/tools/gitDiff.ts
-import { z as z17 } from "zod";
-
-// src/AiTool/tools/utils/diffLineNumbers.ts
-function parseHunkHeader(header) {
-  const match = header.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/);
-  if (!match) return null;
-  return {
-    oldStart: parseInt(match[1], 10),
-    oldCount: match[2] ? parseInt(match[2], 10) : 1,
-    newStart: parseInt(match[3], 10),
-    newCount: match[4] ? parseInt(match[4], 10) : 1,
-    header
-  };
-}
-function annotateDiffWithLineNumbers(diff) {
-  const lines = diff.split("\n");
-  const annotatedLines = [];
-  let currentNewLine = 0;
-  let currentOldLine = 0;
-  let inHunk = false;
-  for (const line of lines) {
-    if (line.startsWith("@@")) {
-      const hunk = parseHunkHeader(line);
-      if (hunk) {
-        currentOldLine = hunk.oldStart;
-        currentNewLine = hunk.newStart;
-        inHunk = true;
-      }
-      annotatedLines.push(line);
-      continue;
-    }
-    if (line.startsWith("diff --git") || line.startsWith("index ") || line.startsWith("---") || line.startsWith("+++")) {
-      annotatedLines.push(line);
-      inHunk = false;
-      continue;
-    }
-    if (!inHunk) {
-      annotatedLines.push(line);
-      continue;
-    }
-    if (line.startsWith("+") && !line.startsWith("+++")) {
-      annotatedLines.push(`${line} [Line ${currentNewLine}]`);
-      currentNewLine++;
-    } else if (line.startsWith("-") && !line.startsWith("---")) {
-      annotatedLines.push(`${line} [Line ${currentOldLine} removed]`);
-      currentOldLine++;
-    } else if (line.startsWith(" ")) {
-      annotatedLines.push(line);
-      currentOldLine++;
-      currentNewLine++;
-    } else {
-      annotatedLines.push(line);
-    }
-  }
-  return annotatedLines.join("\n");
-}
-
-// src/AiTool/tools/gitDiff.ts
-var toolInfo15 = {
-  name: "git_diff",
-  description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.",
-  parameters: z17.object({
-    staged: z17.preprocess((val) => {
-      if (typeof val === "string") {
-        const lower = val.toLowerCase();
-        if (lower === "false") return false;
-        if (lower === "true") return true;
-      }
-      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().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") {
-        const lower = val.toLowerCase();
-        if (lower === "false") return false;
-        if (lower === "true") return true;
-      }
-      return val;
-    }, z17.boolean().optional().default(false)).describe("Annotate the diff with line numbers for additions and deletions.")
-  })
-};
-var handler15 = async (provider, args) => {
-  if (!provider.executeCommand) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: "Not possible to execute command. Abort."
-      }
-    };
-  }
-  const { staged, file, commitRange, contextLines, includeLineNumbers } = toolInfo15.parameters.parse(args);
-  const commandParts = ["git", "diff", "--no-color", `-U${contextLines}`];
-  if (staged) {
-    commandParts.push("--staged");
-  }
-  if (commitRange) {
-    commandParts.push(commitRange);
-  }
-  if (file) {
-    commandParts.push("--", `'${file}'`);
-  }
-  const command = commandParts.join(" ");
-  try {
-    const result = await provider.executeCommand(command, false);
-    if (result.exitCode === 0) {
-      if (!result.stdout.trim()) {
-        return {
-          type: "Reply" /* Reply */,
-          message: {
-            type: "text",
-            value: "No diff found."
-          }
-        };
-      }
-      let diffOutput = result.stdout;
-      if (includeLineNumbers) {
-        diffOutput = annotateDiffWithLineNumbers(diffOutput);
-      }
-      return {
-        type: "Reply" /* Reply */,
-        message: {
-          type: "text",
-          value: `<diff file="${file ?? "all"}">
-${diffOutput}
-</diff>`
-        }
-      };
-    }
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: `\`${command}\` exited with code ${result.exitCode}:
-${result.stderr}`
-      }
-    };
-  } catch (error) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: error instanceof Error ? error.message : String(error)
-      }
-    };
-  }
-};
-var isAvailable15 = (provider) => {
-  return !!provider.executeCommand;
-};
-var gitDiff_default = {
-  ...toolInfo15,
-  handler: handler15,
-  isAvailable: isAvailable15
-};
-
-// src/AiTool/reviewDiff.ts
-var prompt5 = `
-# Code Review Prompt
-
-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 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
-- 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.
-- Use <file_status> to understand which files were modified, added, deleted, or renamed and to apply the inclusion/exclusion rules above.
-
-## Line Number Reporting
-- 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** unless directly tied to a specific problem visible in the diff.
-
-## What NOT to review
-- 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.
-Only include reviews for actual issues found in the changed code.
-
-Return your review as a JSON object inside a \`\`\`json block, wrapped like:
-\`\`\`json
-{
-  "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",
-      "lines": "N or N-M",
-      "review": "Specific issue with the changed code and exact actionable fix."
-    }
-  ]
-}
-\`\`\`
-`;
-var reviewDiff_default = {
-  name: "reviewDiff",
-  description: "Reviews a git diff",
-  prompt: prompt5,
-  formatInput: (params) => {
-    const parts = [];
-    if (params.pullRequestTitle) {
-      parts.push(`<pr_title>
-${params.pullRequestTitle}
-</pr_title>`);
-    }
-    if (params.pullRequestDescription) {
-      parts.push(`<pr_description>
-${params.pullRequestDescription}
-</pr_description>`);
-    }
-    if (params.commitMessages) {
-      parts.push(`<commit_messages>
-${params.commitMessages}
-</commit_messages>`);
-    }
-    if (params.changedFiles && params.changedFiles.length > 0) {
-      const fileList = params.changedFiles.map((file) => `${file.status}: ${file.path}`).join("\n");
-      parts.push(`<file_status>
-${fileList}
-</file_status>`);
-    }
-    let instructions = "";
-    if (params.commitRange) {
-      instructions = `Review the pull request. Use the git_diff tool with commit range '${params.commitRange}', contextLines: 5, and includeLineNumbers: true to inspect the actual code changes. The diff will include line number annotations to help you report accurate line numbers. File status information is already provided above.`;
-    } else if (params.staged) {
-      instructions = "Review the staged changes. Use the git_diff tool with staged: true, contextLines: 5, and includeLineNumbers: true to inspect the actual code changes. The diff will include line number annotations to help you report accurate line numbers. File status information is already provided above.";
-    } else {
-      instructions = "Review the unstaged changes. Use the git_diff tool with contextLines: 5 and includeLineNumbers: true to inspect the actual code changes. The diff will include line number annotations to help you report accurate line numbers. File status information is already provided above.";
-    }
-    parts.push(`<review_instructions>
-${instructions}
-</review_instructions>`);
-    return parts.join("\n");
-  },
-  parseOutput: (output) => {
-    const jsonBlockRegex = /```json\n([\s\S]*?)\n```/;
-    const match = output.match(jsonBlockRegex);
-    const content = match ? match[1] : output;
-    try {
-      return JSON.parse(content);
-    } catch (error) {
-      console.error("Error parsing JSON output:", error);
-      return {
-        overview: `Could not parse review output. Raw output:
-${output}`,
-        specificReviews: []
-      };
-    }
-  },
-  agent: (options) => {
-    return new AnalyzerAgent({
-      ...options,
-      additionalTools: [gitDiff_default],
-      requireToolUse: false
-    });
-  }
-};
-
 // src/AiTool/index.ts
 var executeTool = async (definition, ai, params, usageMeter) => {
   const resp = await generateText({
@@ -4011,7 +3727,6 @@ var makeAgentTool = (definition) => {
 };
 var generateGitCommitMessage = makeTool(generateGitCommitMessage_default);
 var generateGithubPullRequestDetails = makeTool(generateGithubPullRequestDetails_default);
-var reviewDiff = makeAgentTool(reviewDiff_default);
 var generateProjectConfig = makeMultiAgentTool(generateProjectConfig_default);
 var createNewProject = makeMultiAgentTool(createNewProject_default);
 
@@ -4041,50 +3756,61 @@ var WorkflowAgent = class extends AgentBase {
 };
 var makeAgentStepSpecHandler = (getModelFn) => ({
   type: "agent",
-  handler(step) {
+  handler(step2) {
     return {
-      ...step,
+      ...step2,
       async run(input, context, resumedState) {
+        if (context.verbose && context.verbose >= 1) {
+          console.log(`[agent-step] Running agent step '${step2.id}' with input:`, input);
+        }
         try {
-          const model = await getModelFn(step, context);
+          const model = await getModelFn(step2, context);
           const parameters = context.parameters ?? {};
-          const budget = step.budget ?? parameters?.budget;
-          const maxMessages = step.maxMessages ?? parameters?.maxMessages;
+          const budget = step2.budget ?? parameters?.budget;
+          const maxMessages = step2.maxMessages ?? parameters?.maxMessages;
           const usageMeter = new UsageMeter({}, { maxMessages, maxCost: budget });
-          const toolFormat = step.toolFormat ?? parameters.toolFormat ?? "native";
+          const toolFormat = step2.toolFormat ?? parameters.toolFormat ?? "native";
           const policies = parameters.policies ?? [];
-          const modelParameters = { ...parameters.modelParameters ?? {}, ...step.modelParameters ?? {} };
+          const modelParameters = { ...parameters.modelParameters ?? {}, ...step2.modelParameters ?? {} };
           if (resumedState?.usage) {
             usageMeter.setUsage(resumedState.usage);
           }
           const getAgent = () => {
-            if ("agent" in step) {
-              const agentName = step.agent;
+            if (step2.agent) {
+              const agentName = step2.agent;
               const AgentClass = agentRegistry[agentName];
               if (!AgentClass) {
                 throw new Error(`Unknown agent: ${agentName}`);
               }
+              if (context.verbose && context.verbose >= 1) {
+                console.log(`[agent-step] Using agent: ${agentName}`);
+              }
               const agentOptions = {
                 ai: model,
                 os: parameters.os ?? "linux",
                 provider: context.provider,
-                interactive: false,
                 toolFormat,
-                additionalTools: step.tools,
+                additionalTools: step2.tools,
                 policies,
                 usageMeter,
                 parameters: modelParameters,
-                scripts: parameters.scripts
+                scripts: parameters.scripts,
+                callback: context.agentCallback
               };
               return new AgentClass(agentOptions);
             } else {
-              const systemPrompt = resolveTemplatedString(step.systemPrompt, input);
+              if (!step2.systemPrompt) {
+                throw new Error("No system prompt specified for the agent step.");
+              }
+              if (context.verbose && context.verbose >= 1) {
+                console.log(`[agent-step] Using generic WorkflowAgent`);
+              }
+              const systemPrompt = resolveTemplatedString(step2.systemPrompt, input);
               return new WorkflowAgent("agent", model, {
                 systemPrompt,
-                tools: step.tools,
+                tools: step2.tools ?? [],
                 toolNamePrefix: toolFormat === "native" ? "" : "tool_",
                 provider: context.provider,
-                interactive: false,
                 agents: [],
                 scripts: parameters.scripts,
                 callback: void 0,
@@ -4100,7 +3826,7 @@ var makeAgentStepSpecHandler = (getModelFn) => ({
           if (resumedState?.messages) {
             agent.setMessages(resumedState.messages);
           }
-          const userContentArray = step.messages.map((message) => {
+          const userContentArray = step2.messages.map((message) => {
             if (typeof message === "string" || Array.isArray(message)) {
               return message;
             }
@@ -4114,14 +3840,59 @@ var makeAgentStepSpecHandler = (getModelFn) => ({
               combinedContentParts.push(...content);
             }
           }
+          if (context.verbose && context.verbose >= 1) {
+            console.log(`[agent-step] Starting agent with content:`, JSON.stringify(combinedContentParts, null, 2));
+          }
           const exitReason = await agent.start(combinedContentParts);
+          if (context.verbose && context.verbose >= 1) {
+            console.log(`[agent-step] Agent exited with reason:`, exitReason);
+          }
           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 "Exit" /* Exit */: {
+                const raw = reason.message;
+                if (step2.parseOutput) {
+                  try {
+                    const parsed = step2.parseOutput(raw);
+                    if (step2.outputSchema) {
+                      const validationResult = step2.outputSchema.safeParse(parsed);
+                      if (validationResult.success) {
+                        return { type: "success", output: validationResult.data };
+                      }
+                      return {
+                        type: "error",
+                        error: new Error(`Output validation failed: ${validationResult.error.toString()}`)
+                      };
+                    }
+                    return { type: "success", output: parsed };
+                  } catch (e) {
+                    const error = e instanceof Error ? e : new Error(String(e));
+                    error.message = `Failed to parse agent output with parseOutput: ${error.message}`;
+                    return { type: "error", error };
+                  }
+                } else if (step2.outputSchema) {
+                  try {
+                    const output = JSON.parse(raw);
+                    const validationResult = step2.outputSchema.safeParse(output);
+                    if (validationResult.success) {
+                      return { type: "success", output: validationResult.data };
+                    }
+                    return {
+                      type: "error",
+                      error: new Error(`Output validation failed: ${validationResult.error.toString()}`)
+                    };
+                  } catch (e) {
+                    const error = e instanceof Error ? e : new Error(String(e));
+                    error.message = `Failed to parse agent output as JSON: ${error.message}`;
+                    return { type: "error", error };
+                  }
+                }
+                return { type: "success", output: reason };
+              }
               case "HandOver" /* HandOver */:
               case "Delegate" /* Delegate */:
                 return { type: "success", output: reason };
@@ -4160,23 +3931,29 @@ var StepsBuilder = class {
     } : this.#steps[0];
     return rootStep;
   }
-  step(step) {
-    this.#steps.push(step);
+  step(step2) {
+    this.#steps.push(step2);
     return this;
   }
-  parallel(id, step) {
+  parallel(id, step2) {
     return this.step({
       id,
       type: "parallel",
-      step
+      step: step2
     });
   }
-  custom(id, run2) {
-    return this.step({
-      id,
-      type: "custom",
-      run: run2
-    });
+  custom(idOrSpec, run2) {
+    if (typeof idOrSpec === "string") {
+      if (!run2) {
+        throw new Error('Custom step "run" function must be provided.');
+      }
+      return this.step({
+        id: idOrSpec,
+        type: "custom",
+        run: run2
+      });
+    }
+    return this.step(idOrSpec);
   }
   agent(id, spec) {
     return this.step({
@@ -4193,16 +3970,16 @@ var builder = () => {
 // src/workflow/command.ts
 var commandStepSpecHandler = {
   type: "command",
-  handler(step) {
+  handler(step2) {
     return {
-      ...step,
+      ...step2,
       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) => {
+          const command2 = step2.command.map((arg) => resolveTemplatedString(arg, input));
+          const commandString = command2.map((arg) => {
             if (/[^A-Za-z0-9_/:=-]/.test(arg)) {
               return `"${arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
             }
@@ -4210,13 +3987,13 @@ var commandStepSpecHandler = {
           }).join(" ");
           const result = await context.provider.executeCommand(commandString, false);
           const output = {};
-          if (step.outputs?.includes("stdout")) {
+          if (step2.outputs?.includes("stdout")) {
             output.stdout = result.stdout;
           }
-          if (step.outputs?.includes("stderr")) {
+          if (step2.outputs?.includes("stderr")) {
             output.stderr = result.stderr;
           }
-          if (step.outputs?.includes("exitCode")) {
+          if (step2.outputs?.includes("exitCode")) {
             output.exitCode = result.exitCode;
           }
           return { type: "success", output };
@@ -4227,14 +4004,26 @@ var commandStepSpecHandler = {
     };
   }
 };
+var command = (id, ...command2) => ({
+  id,
+  type: "command",
+  command: command2
+});
 
 // src/workflow/runStep.ts
-var runStep = async (step, input, context, resumedState, allOutputs) => {
+var runStep = async (step2, input, context, resumedState, allOutputs) => {
+  if (context.verbose && context.verbose >= 1) {
+    console.log(`[workflow] running step: ${step2.id}`);
+    console.log(`[workflow] input: ${JSON.stringify(input, null, 2)}`);
+  }
   try {
-    const validatedInput = step.inputSchema?.parse(input) ?? input;
-    const result = await step.run({ ...validatedInput, $: allOutputs }, context, resumedState);
+    const validatedInput = step2.inputSchema?.parse(input) ?? input;
+    const result = await step2.run({ ...validatedInput, $: allOutputs }, context, resumedState);
+    if (context.verbose && context.verbose >= 1) {
+      console.log(`[workflow] step result: ${step2.id}`, JSON.stringify(result, null, 2));
+    }
     if (result.type === "success") {
-      const validatedOutput = step.outputSchema?.parse(result.output) ?? result.output;
+      const validatedOutput = step2.outputSchema?.parse(result.output) ?? result.output;
       return {
         ...result,
         output: validatedOutput
@@ -4242,6 +4031,9 @@ var runStep = async (step, input, context, resumedState, allOutputs) => {
     }
     return result;
   } catch (error) {
+    if (context.verbose && context.verbose >= 1) {
+      console.error(`[workflow] step error: ${step2.id}`, error);
+    }
     return { type: "error", error };
   }
 };
@@ -4249,26 +4041,26 @@ var runStep = async (step, input, context, resumedState, allOutputs) => {
 // 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`);
+  for (const handler15 of handlers) {
+    if (allHandlers[handler15.type]) {
+      throw new Error(`Handler with type ${handler15.type} already exists`);
     }
-    allHandlers[handler16.type] = handler16;
+    allHandlers[handler15.type] = handler15;
   }
-  return (step, rootHandler) => {
-    const handler16 = allHandlers[step.type];
-    if (!handler16) {
-      throw new Error(`No handler found for step type: ${step.type}`);
+  return (step2, rootHandler) => {
+    const handler15 = allHandlers[step2.type];
+    if (!handler15) {
+      throw new Error(`No handler found for step type: ${step2.type}`);
     }
-    return handler16.handler(step, rootHandler);
+    return handler15.handler(step2, rootHandler);
   };
 };
 var sequentialStepSpecHandler = {
   type: "sequential",
-  handler(step, rootHandler) {
-    const steps = step.steps.map((subStep) => rootHandler(subStep, rootHandler));
+  handler(step2, rootHandler) {
+    const steps = step2.steps.map((subStep) => rootHandler(subStep, rootHandler));
     return {
-      ...step,
+      ...step2,
       async run(input, context, resumedState) {
         let currentInput = input;
         const allOutputs = resumedState ? resumedState.allOutputs : {};
@@ -4301,10 +4093,10 @@ var sequentialStepSpecHandler = {
 };
 var parallelStepSpecHandler = {
   type: "parallel",
-  handler(step, rootHandler) {
-    const innerStep = rootHandler(step.step, rootHandler);
+  handler(step2, rootHandler) {
+    const innerStep = rootHandler(step2.step, rootHandler);
     return {
-      ...step,
+      ...step2,
       async run(input, context, resumedState) {
         const items = input.items ?? [];
         const promises = items.map((innerInput, index) => {
@@ -4337,19 +4129,22 @@ var parallelStepSpecHandler = {
 };
 var customStepSpecHandler = {
   type: "custom",
-  handler(step) {
+  handler(step2) {
     return {
-      ...step,
+      ...step2,
       async run(input, context, resumedState) {
-        return step.run(input, context, resumedState);
+        return step2.run(input, context, resumedState);
       }
     };
   }
 };
+function step(id, run2) {
+  return { id, type: "custom", run: run2 };
+}
 
 // src/workflow/workflow.ts
-var run = async (workflow, context, handler16, input) => {
-  const rootStep = handler16(workflow.step, handler16);
+var run = async (workflow, context, handler15, input) => {
+  const rootStep = handler15(workflow.step, handler15);
   const result = await runStep(rootStep, input, context, void 0, {});
   switch (result.type) {
     case "paused":
@@ -4369,8 +4164,8 @@ var run = async (workflow, context, handler16, input) => {
       };
   }
 };
-var resume = async (workflow, context, handler16, state, input) => {
-  const rootStep = handler16(workflow.step, handler16);
+var resume = async (workflow, context, handler15, state, input) => {
+  const rootStep = handler15(workflow.step, handler15);
   const result = await runStep(rootStep, input, context, state, {});
   switch (result.type) {
     case "paused":
@@ -4406,7 +4201,6 @@ export {
   UsageMeter,
   agentsPrompt,
   allAgents,
-  allTools_exports as allTools,
   analyzerAgentInfo,
   architectAgentInfo,
   askFollowupQuestion_default as askFollowupQuestion,
@@ -4416,6 +4210,7 @@ export {
   codeFixerAgentInfo,
   coderAgentInfo,
   combineHandlers,
+  command,
   commandStepSpecHandler,
   configSchema,
   createNewProject,
@@ -4440,6 +4235,7 @@ export {
   makeTool,
   parallelStepSpecHandler,
   parseAssistantMessage,
+  parseJsonFromMarkdown,
   readBinaryFile_default as readBinaryFile,
   readFile_default as readFile,
   removeFile_default as removeFile,
@@ -4448,10 +4244,10 @@ export {
   replaceInFile as replaceInFileHelper,
   responsePrompts,
   resume,
-  reviewDiff,
   run,
   searchFiles_default as searchFiles,
   sequentialStepSpecHandler,
+  step,
   systemInformation,
   toolUsePrompt,
   writeToFile_default as writeToFile