@polka-codes/core 0.9.1 → 0.9.3

package/dist/index.js

@@ -4,176 +4,6 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/UsageMeter.ts
-var UsageMeter = class {
-  #totals = { input: 0, output: 0, cachedRead: 0, cost: 0 };
-  #calls = 0;
-  #modelInfos;
-  #maxMessages;
-  #maxCost;
-  constructor(modelInfos = {}, opts = {}) {
-    const infos = {};
-    for (const [provider, providerInfo] of Object.entries(modelInfos)) {
-      for (const [model, modelInfo] of Object.entries(providerInfo)) {
-        infos[`${provider.split("-")[0]}:${model.replace(/[\.-]/g, "")}`] = {
-          inputPrice: modelInfo.inputPrice ?? 0,
-          outputPrice: modelInfo.outputPrice ?? 0,
-          cacheWritesPrice: modelInfo.cacheWritesPrice ?? 0,
-          cacheReadsPrice: modelInfo.cacheReadsPrice ?? 0
-        };
-      }
-    }
-    this.#modelInfos = infos;
-    this.#maxMessages = opts.maxMessages ?? 1e3;
-    this.#maxCost = opts.maxCost ?? 100;
-  }
-  #calculageUsage(usage, providerMetadata, modelInfo) {
-    const providerMetadataKey = Object.keys(providerMetadata ?? {})[0];
-    const metadata = providerMetadata?.[providerMetadataKey] ?? {};
-    switch (providerMetadataKey) {
-      case "openrouter":
-        return {
-          input: usage.inputTokens ?? 0,
-          output: usage.outputTokens ?? 0,
-          cachedRead: usage.cachedInputTokens ?? 0,
-          cost: metadata.usage?.cost ?? 0
-        };
-      case "anthropic": {
-        const cachedRead = usage.cachedInputTokens ?? 0;
-        const cacheWrite = metadata?.promptCacheMissTokens ?? 0;
-        const input = usage.inputTokens ?? 0;
-        const output = usage.outputTokens ?? 0;
-        return {
-          input: input + cacheWrite + cachedRead,
-          output,
-          cachedRead,
-          cost: (input * modelInfo.inputPrice + output * modelInfo.outputPrice + cacheWrite * modelInfo.cacheWritesPrice + cachedRead * modelInfo.cacheReadsPrice) / 1e6
-        };
-      }
-      case "deepseek": {
-        const cachedRead = usage.cachedInputTokens ?? 0;
-        const cacheWrite = metadata.promptCacheMissTokens ?? 0;
-        const input = usage.inputTokens ?? 0;
-        const output = usage.outputTokens ?? 0;
-        return {
-          input,
-          output,
-          cachedRead,
-          cost: (output * modelInfo.outputPrice + cacheWrite * modelInfo.inputPrice + cachedRead * modelInfo.cacheReadsPrice) / 1e6
-        };
-      }
-      default: {
-        const cachedRead = usage.cachedInputTokens ?? 0;
-        const input = usage.inputTokens ?? 0;
-        const output = usage.outputTokens ?? 0;
-        return {
-          input,
-          output,
-          cachedRead,
-          cost: (input * modelInfo.inputPrice + output * modelInfo.outputPrice) / 1e6
-        };
-      }
-    }
-  }
-  addUsage(llm, resp, options = {}) {
-    const modelInfo = options.modelInfo ?? // make google.vertex.chat to google
-    // and anthropic.messages to anthropic
-    this.#modelInfos[`${llm.provider.split(".")[0]}:${llm.modelId.replace(/[\.-]/g, "")}`] ?? {
-      inputPrice: 0,
-      outputPrice: 0,
-      cacheWritesPrice: 0,
-      cacheReadsPrice: 0
-    };
-    const usage = "totalUsage" in resp ? resp.totalUsage : resp.usage;
-    const result = this.#calculageUsage(usage, resp.providerMetadata, modelInfo);
-    this.#totals.input += result.input;
-    this.#totals.output += result.output;
-    this.#totals.cachedRead += result.cachedRead;
-    this.#totals.cost += result.cost;
-    this.#calls++;
-  }
-  /** Override the running totals (e.g., restore from saved state). */
-  setUsage(newUsage) {
-    if (newUsage.input != null) this.#totals.input = newUsage.input;
-    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;
-  }
-  /** Manually bump the message count (useful if you record some calls without token info). */
-  incrementMessageCount(n = 1) {
-    this.#calls += n;
-  }
-  /** 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;
-    return {
-      messageCount,
-      maxMessages: this.#maxMessages,
-      cost,
-      maxCost: this.#maxCost,
-      result: messageCount || cost
-    };
-  }
-  /** Same as isLimitExceeded but throws an error if a limit is hit. */
-  checkLimit() {
-    const result = this.isLimitExceeded();
-    if (result.result) {
-      throw new Error(
-        `Usage limit exceeded. Message count: ${result.messageCount}/${result.maxMessages}, cost: ${result.cost}/${result.maxCost}`
-      );
-    }
-  }
-  /** Getter for the aggregated totals (immutable copy). */
-  get usage() {
-    return { ...this.#totals, messageCount: this.#calls };
-  }
-  /** Print a concise usage summary to console. */
-  printUsage() {
-    const u = this.usage;
-    console.log(
-      `Usage - messages: ${u.messageCount}, input: ${u.input}, cached: ${u.cachedRead}, output: ${u.output}, cost: $${u.cost.toFixed(4)}`
-    );
-  }
-  onFinishHandler(llm) {
-    return (evt) => {
-      this.addUsage(llm, evt);
-    };
-  }
-};
-
-// src/tools/provider.ts
-var MockProvider = class {
-  async readFile(path) {
-    return "mock content";
-  }
-  async writeFile(path, content) {
-    return;
-  }
-  async removeFile(path) {
-    return;
-  }
-  async renameFile(sourcePath, targetPath) {
-    return;
-  }
-  async listFiles(path, recursive, maxCount) {
-    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/allTools.ts
 var allTools_exports = {};
 __export(allTools_exports, {
@@ -225,35 +55,27 @@ var toolInfo = {
   description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.",
   parameters: z.object({
     questions: z.array(questionObject).describe("One or more follow-up questions you need answered before you can continue.").meta({ usageValue: "questions here" })
-  }),
-  examples: [
-    {
-      description: "Single clarifying question (no options)",
-      parameters: [
-        {
-          name: "questions",
-          value: { prompt: "What is the target deployment environment?" }
+  }).meta({
+    examples: [
+      {
+        description: "Single clarifying question (no options)",
+        input: {
+          questions: { prompt: "What is the target deployment environment?" }
         }
-      ]
-    },
-    {
-      description: "Single question with multiple-choice options",
-      parameters: [
-        {
-          name: "questions",
-          value: {
+      },
+      {
+        description: "Single question with multiple-choice options",
+        input: {
+          questions: {
             prompt: "Which frontend framework are you using?",
             options: ["React", "Angular", "Vue", "Svelte"]
           }
         }
-      ]
-    },
-    {
-      description: "Two related questions in one call",
-      parameters: [
-        {
-          name: "questions",
-          value: [
+      },
+      {
+        description: "Two related questions in one call",
+        input: {
+          questions: [
             { prompt: "What type of application are you building?" },
             {
               prompt: "Preferred programming language?",
@@ -261,21 +83,18 @@ var toolInfo = {
             }
           ]
         }
-      ]
-    },
-    {
-      description: "Binary (yes/no) confirmation",
-      parameters: [
-        {
-          name: "questions",
-          value: {
+      },
+      {
+        description: "Binary (yes/no) confirmation",
+        input: {
+          questions: {
             prompt: "Is it acceptable to refactor existing tests to improve performance?",
             options: ["Yes", "No"]
           }
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 0 /* None */
 };
 var handler = async (provider, args) => {
@@ -294,9 +113,9 @@ var handler = async (provider, args) => {
   }
   const answers = [];
   for (const question of questions) {
-    const { prompt: prompt5, options } = question;
-    const answer = await provider.askFollowupQuestion(prompt5, options);
-    answers.push(`<ask_followup_question_answer question="${prompt5}">
+    const { prompt: prompt6, options } = question;
+    const answer = await provider.askFollowupQuestion(prompt6, options);
+    answers.push(`<ask_followup_question_answer question="${prompt6}">
 ${answer}
 </ask_followup_question_answer>`);
   }
@@ -323,18 +142,16 @@ var toolInfo2 = {
     result: z2.string().describe(
       "The result of the task. Formulate this result in a way that is final and does not require further input from the user. Don't end your result with questions or offers for further assistance."
     ).meta({ usageValue: "Your final result description here" })
-  }),
-  examples: [
-    {
-      description: "Request to present the result of the task",
-      parameters: [
-        {
-          name: "result",
-          value: "Your final result description here"
+  }).meta({
+    examples: [
+      {
+        description: "Request to present the result of the task",
+        input: {
+          result: "Your final result description here"
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 0 /* None */
 };
 var handler2 = async (provider, args) => {
@@ -358,7 +175,7 @@ var handler2 = async (provider, args) => {
     message: `<user_message>${moreMessage}</user_message>`
   };
 };
-var isAvailable2 = (provider) => {
+var isAvailable2 = (_provider) => {
   return true;
 };
 var attemptCompletion_default = {
@@ -381,30 +198,19 @@ var toolInfo3 = {
       const values = Array.isArray(val) ? val : [val];
       return values.flatMap((i) => typeof i === "string" ? i.split(",") : []).filter((s) => s.length > 0);
     }, z3.array(z3.string())).optional().describe("The files relevant to the task. Comma separated paths").meta({ usageValue: "Relevant files" })
-  }),
-  examples: [
-    {
-      description: "Delegate a code analysis task to the analyzer agent",
-      parameters: [
-        {
-          name: "agentName",
-          value: "analyzer"
-        },
-        {
-          name: "task",
-          value: "Analyze the authentication implementation"
-        },
-        {
-          name: "context",
-          value: "Need to understand the security implications of the current auth system"
-        },
-        {
-          name: "files",
-          value: "src/auth/login.ts,src/auth/types.ts"
+  }).meta({
+    examples: [
+      {
+        description: "Delegate a code analysis task to the analyzer agent",
+        input: {
+          agentName: "analyzer",
+          task: "Analyze the authentication implementation",
+          context: "Need to understand the security implications of the current auth system",
+          files: "src/auth/login.ts,src/auth/types.ts"
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 0 /* None */
 };
 var handler3 = async (_provider, args) => {
@@ -450,16 +256,17 @@ var toolInfo4 = {
     }, z4.boolean().optional().default(false)).describe(
       "Set to `true` for commands that install/uninstall software, modify or delete files, change system settings, perform network operations, or have other side effects. Use `false` for safe, read-only, or purely local development actions (e.g., listing files, make a build, running tests)."
     ).meta({ usageValue: "true | false" })
+  }).meta({
+    examples: [
+      {
+        description: "Make a build",
+        input: {
+          command: "npm run build",
+          requiresApproval: "false"
+        }
+      }
+    ]
   }),
-  examples: [
-    {
-      description: "Make a build",
-      parameters: [
-        { name: "command", value: "npm run build" },
-        { name: "requiresApproval", value: "false" }
-      ]
-    }
-  ],
   permissionLevel: 3 /* Arbitrary */
 };
 var handler4 = async (provider, args) => {
@@ -518,36 +325,28 @@ var toolInfo5 = {
       const values = Array.isArray(val) ? val : [val];
       return values.flatMap((i) => typeof i === "string" ? i.split(",") : []).filter((s) => s.length > 0);
     }, z5.array(z5.string())).describe("One or more URLs to fetch, separated by commas if multiple.").meta({ usageValue: "url" })
-  }),
-  examples: [
-    {
-      description: "Fetch a single webpage",
-      parameters: [
-        {
-          name: "url",
-          value: "https://example.com"
+  }).meta({
+    examples: [
+      {
+        description: "Fetch a single webpage",
+        input: {
+          url: "https://example.com"
         }
-      ]
-    },
-    {
-      description: "Fetch multiple webpages",
-      parameters: [
-        {
-          name: "url",
-          value: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP"
+      },
+      {
+        description: "Fetch multiple webpages",
+        input: {
+          url: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP"
         }
-      ]
-    },
-    {
-      description: "Fetch a raw file from GitHub",
-      parameters: [
-        {
-          name: "url",
-          value: "https://raw.githubusercontent.com/user/repo/main/README.md"
+      },
+      {
+        description: "Fetch a raw file from GitHub",
+        input: {
+          url: "https://raw.githubusercontent.com/user/repo/main/README.md"
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 1 /* Read */
 };
 var handler5 = async (provider, args) => {
@@ -589,109 +388,154 @@ var fetchUrl_default = {
   isAvailable: isAvailable5
 };
 
-// src/tools/listFiles.ts
+// src/tools/handOver.ts
 import { z as z6 } from "zod";
 var toolInfo6 = {
-  name: "list_files",
-  description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.",
+  name: "hand_over",
+  description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.",
   parameters: z6.object({
-    path: z6.string().describe("The path of the directory to list contents for (relative to the current working directory)").meta({ usageValue: "Directory path here" }),
-    maxCount: z6.coerce.number().optional().default(2e3).describe("The maximum number of files to list. Default to 2000").meta({ usageValue: "Maximum number of files to list (optional)" }),
-    recursive: z6.preprocess((val) => {
-      if (typeof val === "string") {
-        const lower = val.toLowerCase();
-        if (lower === "false") return false;
-        if (lower === "true") return true;
+    agentName: z6.string().describe("The name of the agent to hand over the task to").meta({ usageValue: "Name of the target agent" }),
+    task: z6.string().describe("The task to be completed by the target agent").meta({ usageValue: "Task description" }),
+    context: z6.string().describe("The context information for the task").meta({ usageValue: "Context information" }),
+    files: z6.preprocess((val) => {
+      if (!val) return [];
+      const values = Array.isArray(val) ? val : [val];
+      return values.flatMap((i) => typeof i === "string" ? i.split(",") : []).filter((s) => s.length > 0);
+    }, z6.array(z6.string())).optional().describe("The files relevant to the task. Comma separated paths").meta({ usageValue: "Relevant files" })
+  }).meta({
+    examples: [
+      {
+        description: "Hand over a coding task to the coder agent",
+        input: {
+          agentName: "coder",
+          task: "Implement the login feature",
+          context: "We need a secure login system with email and password",
+          files: "src/auth/login.ts,src/auth/types.ts"
+        }
       }
-      return val;
-    }, z6.boolean().optional().default(true)).describe("Whether to list files recursively. Use true for recursive listing, false or omit for top-level only.").meta({ usageValue: "true or false (optional)" })
+    ]
   }),
-  examples: [
-    {
-      description: "Request to list files",
-      parameters: [
-        {
-          name: "path",
-          value: "src"
-        },
-        {
-          name: "maxCount",
-          value: "100"
-        }
-      ]
-    }
-  ],
-  permissionLevel: 1 /* Read */
+  permissionLevel: 0 /* None */
 };
-var handler6 = async (provider, args) => {
-  if (!provider.listFiles) {
+var handler6 = async (_provider, args) => {
+  const parsed = toolInfo6.parameters.safeParse(args);
+  if (!parsed.success) {
     return {
-      type: "Error" /* Error */,
-      message: "Not possible to list files. Abort."
+      type: "Invalid" /* Invalid */,
+      message: `Invalid arguments for hand_over: ${parsed.error.message}`
     };
   }
-  const { path, maxCount, recursive } = toolInfo6.parameters.parse(args);
-  const [files, limitReached] = await provider.listFiles(path, recursive, maxCount);
+  const { agentName, task, context, files } = parsed.data;
   return {
-    type: "Reply" /* Reply */,
-    message: `<list_files_path>${path}</list_files_path>
-<list_files_files>
-${files.join("\n")}
-</list_files_files>
-<list_files_truncated>${limitReached}</list_files_truncated>`
+    type: "HandOver" /* HandOver */,
+    agentName,
+    task,
+    context,
+    files: files ?? []
   };
 };
-var isAvailable6 = (provider) => {
-  return !!provider.listFiles;
+var isAvailable6 = (_provider) => {
+  return true;
 };
-var listFiles_default = {
+var handOver_default = {
   ...toolInfo6,
   handler: handler6,
   isAvailable: isAvailable6
 };
 
-// src/tools/readFile.ts
+// src/tools/listFiles.ts
 import { z as z7 } from "zod";
 var toolInfo7 = {
+  name: "list_files",
+  description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.",
+  parameters: z7.object({
+    path: z7.string().describe("The path of the directory to list contents for (relative to the current working directory)").meta({ usageValue: "Directory path here" }),
+    maxCount: z7.coerce.number().optional().default(2e3).describe("The maximum number of files to list. Default to 2000").meta({ usageValue: "Maximum number of files to list (optional)" }),
+    recursive: z7.preprocess((val) => {
+      if (typeof val === "string") {
+        const lower = val.toLowerCase();
+        if (lower === "false") return false;
+        if (lower === "true") return true;
+      }
+      return val;
+    }, z7.boolean().optional().default(true)).describe("Whether to list files recursively. Use true for recursive listing, false or omit for top-level only.").meta({ usageValue: "true or false (optional)" })
+  }).meta({
+    examples: [
+      {
+        description: "Request to list files",
+        input: {
+          path: "src",
+          maxCount: "100"
+        }
+      }
+    ]
+  }),
+  permissionLevel: 1 /* Read */
+};
+var handler7 = async (provider, args) => {
+  if (!provider.listFiles) {
+    return {
+      type: "Error" /* Error */,
+      message: "Not possible to list files. Abort."
+    };
+  }
+  const { path, maxCount, recursive } = toolInfo7.parameters.parse(args);
+  const [files, limitReached] = await provider.listFiles(path, recursive, maxCount);
+  return {
+    type: "Reply" /* Reply */,
+    message: `<list_files_path>${path}</list_files_path>
+<list_files_files>
+${files.join("\n")}
+</list_files_files>
+<list_files_truncated>${limitReached}</list_files_truncated>`
+  };
+};
+var isAvailable7 = (provider) => {
+  return !!provider.listFiles;
+};
+var listFiles_default = {
+  ...toolInfo7,
+  handler: handler7,
+  isAvailable: isAvailable7
+};
+
+// src/tools/readFile.ts
+import { z as z8 } from "zod";
+var toolInfo8 = {
   name: "read_file",
   description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.",
-  parameters: z7.object({
-    path: z7.preprocess((val) => {
+  parameters: z8.object({
+    path: z8.preprocess((val) => {
       if (!val) return [];
       const values = Array.isArray(val) ? val : [val];
       return values.flatMap((i) => typeof i === "string" ? i.split(",") : []).filter((s) => s.length > 0);
-    }, z7.array(z7.string())).describe("The path of the file to read").meta({ usageValue: "Comma separated paths here" })
-  }),
-  examples: [
-    {
-      description: "Request to read the contents of a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.js"
+    }, z8.array(z8.string())).describe("The path of the file to read").meta({ usageValue: "Comma separated paths here" })
+  }).meta({
+    examples: [
+      {
+        description: "Request to read the contents of a file",
+        input: {
+          path: "src/main.js"
         }
-      ]
-    },
-    {
-      description: "Request to read multiple files",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.js,src/index.js"
+      },
+      {
+        description: "Request to read multiple files",
+        input: {
+          path: "src/main.js,src/index.js"
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 1 /* Read */
 };
-var handler7 = async (provider, args) => {
+var handler8 = async (provider, args) => {
   if (!provider.readFile) {
     return {
       type: "Error" /* Error */,
       message: "Not possible to read file. Abort."
     };
   }
-  const { path: paths } = toolInfo7.parameters.parse(args);
+  const { path: paths } = toolInfo8.parameters.parse(args);
   const resp = [];
   for (const path of paths) {
     const fileContent = await provider.readFile(path);
@@ -711,17 +555,110 @@ var handler7 = async (provider, args) => {
     message: resp.join("\n")
   };
 };
-var isAvailable7 = (provider) => {
+var isAvailable8 = (provider) => {
   return !!provider.readFile;
 };
 var readFile_default = {
-  ...toolInfo7,
-  handler: handler7,
-  isAvailable: isAvailable7
+  ...toolInfo8,
+  handler: handler8,
+  isAvailable: isAvailable8
+};
+
+// src/tools/removeFile.ts
+import { z as z9 } from "zod";
+var toolInfo9 = {
+  name: "remove_file",
+  description: "Request to remove a file at the specified path.",
+  parameters: z9.object({
+    path: z9.string().describe("The path of the file to remove").meta({ usageValue: "File path here" })
+  }).meta({
+    examples: [
+      {
+        description: "Request to remove a file",
+        input: {
+          path: "src/main.js"
+        }
+      }
+    ]
+  }),
+  permissionLevel: 2 /* Write */
+};
+var handler9 = async (provider, args) => {
+  if (!provider.removeFile) {
+    return {
+      type: "Error" /* Error */,
+      message: "Not possible to remove file. Abort."
+    };
+  }
+  const parsed = toolInfo9.parameters.safeParse(args);
+  if (!parsed.success) {
+    return {
+      type: "Invalid" /* Invalid */,
+      message: `Invalid arguments for remove_file: ${parsed.error.message}`
+    };
+  }
+  const { path } = parsed.data;
+  await provider.removeFile(path);
+  return {
+    type: "Reply" /* Reply */,
+    message: `<remove_file_path>${path}</remove_file_path><status>Success</status>`
+  };
+};
+var isAvailable9 = (provider) => {
+  return !!provider.removeFile;
+};
+var removeFile_default = {
+  ...toolInfo9,
+  handler: handler9,
+  isAvailable: isAvailable9
+};
+
+// src/tools/renameFile.ts
+import { z as z10 } from "zod";
+var toolInfo10 = {
+  name: "rename_file",
+  description: "Request to rename a file from source path to target path.",
+  parameters: z10.object({
+    source_path: z10.string().describe("The current path of the file").meta({ usageValue: "Source file path here" }),
+    target_path: z10.string().describe("The new path for the file").meta({ usageValue: "Target file path here" })
+  }).meta({
+    examples: [
+      {
+        description: "Request to rename a file",
+        input: {
+          source_path: "src/old-name.js",
+          target_path: "src/new-name.js"
+        }
+      }
+    ]
+  }),
+  permissionLevel: 2 /* Write */
+};
+var handler10 = async (provider, args) => {
+  if (!provider.renameFile) {
+    return {
+      type: "Error" /* Error */,
+      message: "Not possible to rename file. Abort."
+    };
+  }
+  const { source_path, target_path } = toolInfo10.parameters.parse(args);
+  await provider.renameFile(source_path, target_path);
+  return {
+    type: "Reply" /* Reply */,
+    message: `<rename_file_path>${target_path}</rename_file_path><status>Success</status>`
+  };
+};
+var isAvailable10 = (provider) => {
+  return !!provider.renameFile;
+};
+var renameFile_default = {
+  ...toolInfo10,
+  handler: handler10,
+  isAvailable: isAvailable10
 };
 
 // src/tools/replaceInFile.ts
-import { z as z8 } from "zod";
+import { z as z11 } from "zod";
 
 // src/tools/utils/replaceInFile.ts
 var replaceInFile = (fileContent, diff) => {
@@ -798,12 +735,12 @@ var replaceInFile = (fileContent, diff) => {
 };
 
 // src/tools/replaceInFile.ts
-var toolInfo8 = {
+var toolInfo11 = {
   name: "replace_in_file",
   description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.",
-  parameters: z8.object({
-    path: z8.string().describe("The path of the file to modify").meta({ usageValue: "File path here" }),
-    diff: z8.string().describe(
+  parameters: z11.object({
+    path: z11.string().describe("The path of the file to modify").meta({ usageValue: "File path here" }),
+    diff: z11.string().describe(
       `One or more SEARCH/REPLACE blocks following this exact format:
 \`\`\`
 <<<<<<< SEARCH
@@ -829,18 +766,13 @@ Critical rules:
     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)
     * To delete code: Use empty REPLACE section`
     ).meta({ usageValue: "Search and replace blocks here" })
-  }),
-  examples: [
-    {
-      description: "Request to replace sections of content in a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.js"
-        },
-        {
-          name: "diff",
-          value: `<<<<<<< SEARCH
+  }).meta({
+    examples: [
+      {
+        description: "Request to replace sections of content in a file",
+        input: {
+          path: "src/main.js",
+          diff: `<<<<<<< SEARCH
 import React from 'react';
 =======
 import React, { useState } from 'react';
@@ -868,35 +800,23 @@ return (
   <div>
 >>>>>>> REPLACE`
         }
-      ]
-    },
-    {
-      description: "Request to perform a simple, single-line replacement",
-      parameters: [
-        {
-          name: "path",
-          value: "src/config.js"
-        },
-        {
-          name: "diff",
-          value: `<<<<<<< SEARCH
+      },
+      {
+        description: "Request to perform a simple, single-line replacement",
+        input: {
+          path: "src/config.js",
+          diff: `<<<<<<< SEARCH
 const API_URL = 'https://api.example.com';
 =======
 const API_URL = 'https://api.staging.example.com';
 >>>>>>> REPLACE`
         }
-      ]
-    },
-    {
-      description: "Request to add a new function to a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/utils.js"
-        },
-        {
-          name: "diff",
-          value: `<<<<<<< SEARCH
+      },
+      {
+        description: "Request to add a new function to a file",
+        input: {
+          path: "src/utils.js",
+          diff: `<<<<<<< SEARCH
 function helperA() {
   // ...
 }
@@ -910,18 +830,12 @@ function newHelper() {
 }
 >>>>>>> REPLACE`
         }
-      ]
-    },
-    {
-      description: "Request to delete a block of code from a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/app.js"
-        },
-        {
-          name: "diff",
-          value: `<<<<<<< SEARCH
+      },
+      {
+        description: "Request to delete a block of code from a file",
+        input: {
+          path: "src/app.js",
+          diff: `<<<<<<< SEARCH
 function oldFeature() {
   // This is no longer needed
 }
@@ -929,12 +843,12 @@ function oldFeature() {
 =======
 >>>>>>> REPLACE`
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 2 /* Write */
 };
-var handler8 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -942,7 +856,7 @@ var handler8 = async (provider, args) => {
     };
   }
   try {
-    const { path, diff } = toolInfo8.parameters.parse(args);
+    const { path, diff } = toolInfo11.parameters.parse(args);
     const fileContent = await provider.readFile(path);
     if (fileContent == null) {
       return {
@@ -979,55 +893,47 @@ var handler8 = async (provider, args) => {
     };
   }
 };
-var isAvailable8 = (provider) => {
+var isAvailable11 = (provider) => {
   return !!provider.readFile && !!provider.writeFile;
 };
 var replaceInFile_default = {
-  ...toolInfo8,
-  handler: handler8,
-  isAvailable: isAvailable8
+  ...toolInfo11,
+  handler: handler11,
+  isAvailable: isAvailable11
 };
 
 // src/tools/searchFiles.ts
-import { z as z9 } from "zod";
-var toolInfo9 = {
+import { z as z12 } from "zod";
+var toolInfo12 = {
   name: "search_files",
   description: "Request to perform a regex search across files in a specified directory, outputting context-rich results that include surrounding lines. This tool searches for patterns or specific content across multiple files, displaying each match with encapsulating context.",
-  parameters: z9.object({
-    path: z9.string().describe(
+  parameters: z12.object({
+    path: z12.string().describe(
       "The path of the directory to search in (relative to the current working directory). This directory will be recursively searched."
     ).meta({ usageValue: "Directory path here" }),
-    regex: z9.string().describe("The regular expression pattern to search for. Uses Rust regex syntax.").meta({
+    regex: z12.string().describe("The regular expression pattern to search for. Uses Rust regex syntax.").meta({
       usageValue: "Your regex pattern here"
     }),
-    filePattern: z9.string().optional().describe(
+    filePattern: z12.string().optional().describe(
       'Comma-separated glob pattern to filter files (e.g., "*.ts" for TypeScript files or "*.ts,*.js" for both TypeScript and JavaScript files). If not provided, it will search all files (*).'
     ).meta({
       usageValue: "file pattern here (optional)"
     })
-  }),
-  examples: [
-    {
-      description: "Request to perform a regex search across files",
-      parameters: [
-        {
-          name: "path",
-          value: "src"
-        },
-        {
-          name: "regex",
-          value: "^components/"
-        },
-        {
-          name: "filePattern",
-          value: "*.ts,*.tsx"
+  }).meta({
+    examples: [
+      {
+        description: "Request to perform a regex search across files",
+        input: {
+          path: "src",
+          regex: "^components/",
+          filePattern: "*.ts,*.tsx"
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 1 /* Read */
 };
-var handler9 = async (provider, args) => {
+var handler12 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -1035,7 +941,7 @@ var handler9 = async (provider, args) => {
     };
   }
   try {
-    const { path, regex, filePattern } = toolInfo9.parameters.parse(args);
+    const { path, regex, filePattern } = toolInfo12.parameters.parse(args);
     const files = await provider.searchFiles(path, regex, filePattern ?? "*");
     return {
       type: "Reply" /* Reply */,
@@ -1054,37 +960,32 @@ ${files.join("\n")}
     };
   }
 };
-var isAvailable9 = (provider) => {
+var isAvailable12 = (provider) => {
   return !!provider.searchFiles;
 };
 var searchFiles_default = {
-  ...toolInfo9,
-  handler: handler9,
-  isAvailable: isAvailable9
+  ...toolInfo12,
+  handler: handler12,
+  isAvailable: isAvailable12
 };
 
 // src/tools/writeToFile.ts
-import { z as z10 } from "zod";
-var toolInfo10 = {
+import { z as z13 } from "zod";
+var toolInfo13 = {
   name: "write_to_file",
   description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.",
-  parameters: z10.object({
-    path: z10.string().describe("The path of the file to write to").meta({ usageValue: "File path here" }),
-    content: z10.string().describe(
+  parameters: z13.object({
+    path: z13.string().describe("The path of the file to write to").meta({ usageValue: "File path here" }),
+    content: z13.string().describe(
       "The content to write to the file. ALWAYS provide the COMPLETE intended content of the file, without any truncation or omissions. You MUST include ALL parts of the file, even if they haven't been modified."
     ).meta({ usageValue: "Your file content here" })
-  }),
-  examples: [
-    {
-      description: "Request to write content to a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.js"
-        },
-        {
-          name: "content",
-          value: `import React from 'react';
+  }).meta({
+    examples: [
+      {
+        description: "Request to write content to a file",
+        input: {
+          path: "src/main.js",
+          content: `import React from 'react';
 
 function App() {
   return (
@@ -1097,19 +998,19 @@ function App() {
 export default App;
 `
         }
-      ]
-    }
-  ],
+      }
+    ]
+  }),
   permissionLevel: 2 /* Write */
 };
-var handler10 = async (provider, args) => {
+var handler13 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
       type: "Error" /* Error */,
       message: "Not possible to write file. Abort."
     };
   }
-  const parsed = toolInfo10.parameters.safeParse(args);
+  const parsed = toolInfo13.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Invalid" /* Invalid */,
@@ -1125,179 +1026,44 @@ var handler10 = async (provider, args) => {
     message: `<write_to_file_path>${path}</write_to_file_path><status>Success</status>`
   };
 };
-var isAvailable10 = (provider) => {
+var isAvailable13 = (provider) => {
   return !!provider.writeFile;
 };
 var writeToFile_default = {
-  ...toolInfo10,
-  handler: handler10,
-  isAvailable: isAvailable10
+  ...toolInfo13,
+  handler: handler13,
+  isAvailable: isAvailable13
 };
 
-// src/tools/handOver.ts
-import { z as z11 } from "zod";
-var toolInfo11 = {
-  name: "hand_over",
-  description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.",
-  parameters: z11.object({
-    agentName: z11.string().describe("The name of the agent to hand over the task to").meta({ usageValue: "Name of the target agent" }),
-    task: z11.string().describe("The task to be completed by the target agent").meta({ usageValue: "Task description" }),
-    context: z11.string().describe("The context information for the task").meta({ usageValue: "Context information" }),
-    files: z11.preprocess((val) => {
-      if (!val) return [];
-      const values = Array.isArray(val) ? val : [val];
-      return values.flatMap((i) => typeof i === "string" ? i.split(",") : []).filter((s) => s.length > 0);
-    }, z11.array(z11.string())).optional().describe("The files relevant to the task. Comma separated paths").meta({ usageValue: "Relevant files" })
-  }),
-  examples: [
-    {
-      description: "Hand over a coding task to the coder agent",
-      parameters: [
-        {
-          name: "agentName",
-          value: "coder"
-        },
-        {
-          name: "task",
-          value: "Implement the login feature"
-        },
-        {
-          name: "context",
-          value: "We need a secure login system with email and password"
-        },
-        {
-          name: "files",
-          value: "src/auth/login.ts,src/auth/types.ts"
-        }
-      ]
-    }
-  ],
-  permissionLevel: 0 /* None */
-};
-var handler11 = async (_provider, args) => {
-  const parsed = toolInfo11.parameters.safeParse(args);
-  if (!parsed.success) {
-    return {
-      type: "Invalid" /* Invalid */,
-      message: `Invalid arguments for hand_over: ${parsed.error.message}`
-    };
+// src/tools/provider.ts
+var MockProvider = class {
+  async readFile(_path) {
+    return "mock content";
   }
-  const { agentName, task, context, files } = parsed.data;
-  return {
-    type: "HandOver" /* HandOver */,
-    agentName,
-    task,
-    context,
-    files: files ?? []
-  };
-};
-var isAvailable11 = (_provider) => {
-  return true;
-};
-var handOver_default = {
-  ...toolInfo11,
-  handler: handler11,
-  isAvailable: isAvailable11
-};
-
-// src/tools/removeFile.ts
-import { z as z12 } from "zod";
-var toolInfo12 = {
-  name: "remove_file",
-  description: "Request to remove a file at the specified path.",
-  parameters: z12.object({
-    path: z12.string().describe("The path of the file to remove").meta({ usageValue: "File path here" })
-  }),
-  examples: [
-    {
-      description: "Request to remove a file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.js"
-        }
-      ]
-    }
-  ],
-  permissionLevel: 2 /* Write */
-};
-var handler12 = async (provider, args) => {
-  if (!provider.removeFile) {
-    return {
-      type: "Error" /* Error */,
-      message: "Not possible to remove file. Abort."
-    };
+  async writeFile(_path, _content) {
+    return;
   }
-  const parsed = toolInfo12.parameters.safeParse(args);
-  if (!parsed.success) {
-    return {
-      type: "Invalid" /* Invalid */,
-      message: `Invalid arguments for remove_file: ${parsed.error.message}`
-    };
+  async removeFile(_path) {
+    return;
   }
-  const { path } = parsed.data;
-  await provider.removeFile(path);
-  return {
-    type: "Reply" /* Reply */,
-    message: `<remove_file_path>${path}</remove_file_path><status>Success</status>`
-  };
-};
-var isAvailable12 = (provider) => {
-  return !!provider.removeFile;
-};
-var removeFile_default = {
-  ...toolInfo12,
-  handler: handler12,
-  isAvailable: isAvailable12
-};
-
-// src/tools/renameFile.ts
-import { z as z13 } from "zod";
-var toolInfo13 = {
-  name: "rename_file",
-  description: "Request to rename a file from source path to target path.",
-  parameters: z13.object({
-    source_path: z13.string().describe("The current path of the file").meta({ usageValue: "Source file path here" }),
-    target_path: z13.string().describe("The new path for the file").meta({ usageValue: "Target file path here" })
-  }),
-  examples: [
-    {
-      description: "Request to rename a file",
-      parameters: [
-        {
-          name: "source_path",
-          value: "src/old-name.js"
-        },
-        {
-          name: "target_path",
-          value: "src/new-name.js"
-        }
-      ]
-    }
-  ],
-  permissionLevel: 2 /* Write */
-};
-var handler13 = async (provider, args) => {
-  if (!provider.renameFile) {
-    return {
-      type: "Error" /* Error */,
-      message: "Not possible to rename file. Abort."
-    };
+  async renameFile(_sourcePath, _targetPath) {
+    return;
+  }
+  async listFiles(_path, _recursive, _maxCount) {
+    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";
   }
-  const { source_path, target_path } = toolInfo13.parameters.parse(args);
-  await provider.renameFile(source_path, target_path);
-  return {
-    type: "Reply" /* Reply */,
-    message: `<rename_file_path>${target_path}</rename_file_path><status>Success</status>`
-  };
-};
-var isAvailable13 = (provider) => {
-  return !!provider.renameFile;
-};
-var renameFile_default = {
-  ...toolInfo13,
-  handler: handler13,
-  isAvailable: isAvailable13
 };
 
 // src/getAvailableTools.ts
@@ -1325,6 +1091,155 @@ var getAvailableTools = ({
   return tools;
 };
 
+// src/UsageMeter.ts
+var UsageMeter = class {
+  #totals = { input: 0, output: 0, cachedRead: 0, cost: 0 };
+  #calls = 0;
+  #modelInfos;
+  #maxMessages;
+  #maxCost;
+  constructor(modelInfos = {}, opts = {}) {
+    const infos = {};
+    for (const [provider, providerInfo] of Object.entries(modelInfos)) {
+      for (const [model, modelInfo] of Object.entries(providerInfo)) {
+        infos[`${provider.split("-")[0]}:${model.replace(/[.-]/g, "")}`] = {
+          inputPrice: modelInfo.inputPrice ?? 0,
+          outputPrice: modelInfo.outputPrice ?? 0,
+          cacheWritesPrice: modelInfo.cacheWritesPrice ?? 0,
+          cacheReadsPrice: modelInfo.cacheReadsPrice ?? 0
+        };
+      }
+    }
+    this.#modelInfos = infos;
+    this.#maxMessages = opts.maxMessages ?? 1e3;
+    this.#maxCost = opts.maxCost ?? 100;
+  }
+  #calculageUsage(usage, providerMetadata, modelInfo) {
+    const providerMetadataKey = Object.keys(providerMetadata ?? {})[0];
+    const metadata = providerMetadata?.[providerMetadataKey] ?? {};
+    switch (providerMetadataKey) {
+      case "openrouter":
+        return {
+          input: usage.inputTokens ?? 0,
+          output: usage.outputTokens ?? 0,
+          cachedRead: usage.cachedInputTokens ?? 0,
+          cost: metadata.usage?.cost ?? 0
+        };
+      case "anthropic": {
+        const cachedRead = usage.cachedInputTokens ?? 0;
+        const cacheWrite = metadata?.promptCacheMissTokens ?? 0;
+        const input = usage.inputTokens ?? 0;
+        const output = usage.outputTokens ?? 0;
+        return {
+          input: input + cacheWrite + cachedRead,
+          output,
+          cachedRead,
+          cost: (input * modelInfo.inputPrice + output * modelInfo.outputPrice + cacheWrite * modelInfo.cacheWritesPrice + cachedRead * modelInfo.cacheReadsPrice) / 1e6
+        };
+      }
+      case "deepseek": {
+        const cachedRead = usage.cachedInputTokens ?? 0;
+        const cacheWrite = metadata.promptCacheMissTokens ?? 0;
+        const input = usage.inputTokens ?? 0;
+        const output = usage.outputTokens ?? 0;
+        return {
+          input,
+          output,
+          cachedRead,
+          cost: (output * modelInfo.outputPrice + cacheWrite * modelInfo.inputPrice + cachedRead * modelInfo.cacheReadsPrice) / 1e6
+        };
+      }
+      default: {
+        const cachedRead = usage.cachedInputTokens ?? 0;
+        const input = usage.inputTokens ?? 0;
+        const output = usage.outputTokens ?? 0;
+        return {
+          input,
+          output,
+          cachedRead,
+          cost: (input * modelInfo.inputPrice + output * modelInfo.outputPrice) / 1e6
+        };
+      }
+    }
+  }
+  addUsage(llm, resp, options = {}) {
+    const modelInfo = options.modelInfo ?? // make google.vertex.chat to google
+    // and anthropic.messages to anthropic
+    this.#modelInfos[`${llm.provider.split(".")[0]}:${llm.modelId.replace(/[.-]/g, "")}`] ?? {
+      inputPrice: 0,
+      outputPrice: 0,
+      cacheWritesPrice: 0,
+      cacheReadsPrice: 0
+    };
+    const usage = "totalUsage" in resp ? resp.totalUsage : resp.usage;
+    const result = this.#calculageUsage(usage, resp.providerMetadata, modelInfo);
+    this.#totals.input += result.input;
+    this.#totals.output += result.output;
+    this.#totals.cachedRead += result.cachedRead;
+    this.#totals.cost += result.cost;
+    this.#calls++;
+  }
+  /** Override the running totals (e.g., restore from saved state). */
+  setUsage(newUsage) {
+    if (newUsage.input != null) this.#totals.input = newUsage.input;
+    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;
+  }
+  /** Manually bump the message count (useful if you record some calls without token info). */
+  incrementMessageCount(n = 1) {
+    this.#calls += n;
+  }
+  /** Reset the running totals. */
+  resetUsage() {
+    this.#totals = { input: 0, output: 0, cachedRead: 0, cost: 0 };
+    this.#calls = 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;
+    return {
+      messageCount,
+      maxMessages: this.#maxMessages,
+      cost,
+      maxCost: this.#maxCost,
+      result: messageCount || cost
+    };
+  }
+  /** Same as isLimitExceeded but throws an error if a limit is hit. */
+  checkLimit() {
+    const result = this.isLimitExceeded();
+    if (result.result) {
+      throw new Error(
+        `Usage limit exceeded. Message count: ${result.messageCount}/${result.maxMessages}, cost: ${result.cost}/${result.maxCost}`
+      );
+    }
+  }
+  /** Getter for the aggregated totals (immutable copy). */
+  get usage() {
+    return { ...this.#totals, messageCount: this.#calls };
+  }
+  /** Print a concise usage summary to console. */
+  printUsage() {
+    const u = this.usage;
+    console.log(
+      `Usage - messages: ${u.messageCount}, input: ${u.input}, cached: ${u.cachedRead}, output: ${u.output}, cost: $${u.cost.toFixed(4)}`
+    );
+  }
+  onFinishHandler(llm) {
+    return (evt) => {
+      this.addUsage(llm, evt);
+    };
+  }
+};
+
+// src/Agent/AgentBase.ts
+import { jsonSchema, streamText } from "ai";
+import { camelCase } from "lodash";
+import { toJSONSchema } from "zod";
+
 // src/tool-v1-compat.ts
 import { z as z14 } from "zod";
 function zodSchemaToParameters(schema) {
@@ -1359,15 +1274,17 @@ function zodSchemaToParameters(schema) {
 function toToolInfoV1(tool) {
   const { parameters: zodSchema, ...rest } = tool;
   const v1Parameters = zodSchemaToParameters(zodSchema);
-  return {
+  const examples = zodSchema.meta()?.examples;
+  const v1Tool = {
     ...rest,
     parameters: v1Parameters
   };
+  if (examples) {
+    v1Tool.examples = examples;
+  }
+  return v1Tool;
 }
 
-// src/Agent/AgentBase.ts
-import { streamText } from "ai";
-
 // src/Agent/parseAssistantMessage.ts
 function parseNestedParameters(content, parameterPrefix, childrenParams) {
   const result = {};
@@ -1538,7 +1455,7 @@ var toolInfoExamplesPrompt = (tool, example, toolNamePrefix, parameterPrefix) =>
 ## Example: ${example.description}
 
 <${toolNamePrefix}${tool.name}>
-${example.parameters.map((param) => `${renderParameterValue(param.name, param.value, parameterPrefix)}`).join("\n")}
+${Object.entries(example.input).map(([name, value]) => renderParameterValue(name, value, parameterPrefix)).join("\n")}
 </${toolNamePrefix}${tool.name}>
 `;
 var toolUsePrompt = (tools, toolNamePrefix) => {
@@ -1546,6 +1463,7 @@ var toolUsePrompt = (tools, toolNamePrefix) => {
     return "";
   }
   const parameterPrefix = `${toolNamePrefix}parameter_`;
+  const v1Tools = tools.map(toToolInfoV1);
   return `
 ====
 
@@ -1604,10 +1522,10 @@ Always adhere to this format, ensuring every opening tag has a matching closing
 NEVER surround tool use with triple backticks (\`\`\`).
 
 # Tools
-${tools.map((tool) => toolInfoPrompt(tool, toolNamePrefix, parameterPrefix)).join("\n")}
+${v1Tools.map((tool) => toolInfoPrompt(tool, toolNamePrefix, parameterPrefix)).join("\n")}
 
 # Tool Use Examples
-${tools.map((tool) => {
+${v1Tools.map((tool) => {
     let promp = "";
     for (const example of tool.examples ?? []) {
       promp += toolInfoExamplesPrompt(tool, example, toolNamePrefix, parameterPrefix);
@@ -1641,7 +1559,7 @@ ${agent.responsibilities.map((resp) => `    - ${resp}`).join("\n")}`
 - **Current Agent Role**
   You are currently acting as **${name}**. If you identify the task is beyond your current scope, use the handover or delegate tool to transition to the other agent. Include sufficient context so the new agent can seamlessly continue the work.
 `;
-var capabilities = (toolNamePrefix) => `
+var capabilities = (_toolNamePrefix) => `
 ====
 
 CAPABILITIES
@@ -1698,6 +1616,8 @@ e.g. <tool_tool_name>tool_name</tool_tool_name>
 Ensure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.
 Avoid unnecessary text or symbols before or after the tool use.
 Avoid unnecessary escape characters or special characters.
+`,
+  requireUseToolNative: `Error: No tool use detected. You MUST use a tool before proceeding.
 `,
   toolResults: (tool, result) => {
     if (typeof result === "string") {
@@ -1755,6 +1675,7 @@ var AgentBase = class {
   config;
   handlers;
   #policies;
+  #toolSet;
   #messages = [];
   #aborted = false;
   #abortController;
@@ -1792,6 +1713,20 @@ ${instance.prompt}`;
       role: "system",
       content: this.config.systemPrompt
     });
+    if (this.config.toolFormat === "native") {
+      const tools = {};
+      for (const tool of Object.values(this.handlers)) {
+        const toolName = camelCase(tool.name);
+        tools[toolName] = {
+          description: tool.description,
+          inputSchema: jsonSchema(toJSONSchema(tool.parameters))
+        };
+        this.handlers[toolName] = tool;
+      }
+      this.#toolSet = tools;
+    } else {
+      this.#toolSet = {};
+    }
   }
   abort() {
     this.#aborted = true;
@@ -1811,21 +1746,27 @@ ${instance.prompt}`;
   async #callback(event) {
     await this.config.callback?.(event);
   }
-  async start(prompt5) {
+  async start(prompt6) {
     this.#callback({ kind: "StartTask" /* StartTask */, agent: this, systemPrompt: this.config.systemPrompt });
-    return await this.#processLoop(prompt5);
+    return await this.#processLoop(prompt6);
   }
-  async step(prompt5) {
+  async step(prompt6) {
     if (this.#messages.length === 0) {
       this.#callback({ kind: "StartTask" /* StartTask */, agent: this, systemPrompt: this.config.systemPrompt });
     }
-    return await this.#request(prompt5);
+    return await this.#request({
+      role: "user",
+      content: prompt6
+    });
   }
   async handleStepResponse(response) {
     return this.#handleResponse(response);
   }
   async #processLoop(userMessage) {
-    let nextRequest = userMessage;
+    let nextRequest = {
+      role: "user",
+      content: userMessage
+    };
     while (true) {
       if (this.#aborted) {
         return { type: "Aborted" };
@@ -1854,10 +1795,7 @@ ${instance.prompt}`;
       throw new Error("userMessage is missing");
     }
     await this.#callback({ kind: "StartRequest" /* StartRequest */, agent: this, userMessage });
-    this.#messages.push({
-      role: "user",
-      content: userMessage
-    });
+    this.#messages.push(userMessage);
     for (const instance of this.#policies) {
       if (instance.onBeforeRequest) {
         await instance.onBeforeRequest(this);
@@ -1869,11 +1807,11 @@ ${instance.prompt}`;
         messages = await instance.prepareMessages(this, messages);
       }
     }
-    let currentAssistantMessage = "";
     const retryCount = this.config.retryCount ?? 5;
-    const requestTimeoutSeconds = this.config.requestTimeoutSeconds ?? 10;
+    const requestTimeoutSeconds = this.config.requestTimeoutSeconds ?? 90;
+    let respMessages = [];
     for (let i = 0; i < retryCount; i++) {
-      currentAssistantMessage = "";
+      respMessages = [];
       let timeout;
       const resetTimeout = () => {
         if (timeout) {
@@ -1887,40 +1825,22 @@ ${instance.prompt}`;
         }
       };
       this.#abortController = new AbortController();
-      const providerOptions = {};
-      const thinkingBudgetTokens = this.config.parameters?.thinkingBudgetTokens;
-      const enableThinking = thinkingBudgetTokens > 0;
-      if (enableThinking) {
-        providerOptions.anthropic = {
-          thinking: { type: "enabled", budgetTokens: thinkingBudgetTokens }
-        };
-        providerOptions.openrouter = {
-          reasoning: {
-            max_tokens: thinkingBudgetTokens
-          }
-        };
-        providerOptions.google = {
-          thinkingConfig: {
-            includeThoughts: true,
-            thinkingBudget: thinkingBudgetTokens
-          }
-        };
-      }
       try {
-        const stream = streamText({
+        const streamTextOptions = {
           model: this.ai,
           messages,
-          providerOptions,
+          providerOptions: this.config.parameters?.providerOptions,
           onChunk: async ({ chunk }) => {
             resetTimeout();
             switch (chunk.type) {
               case "text":
-                currentAssistantMessage += chunk.text;
                 await this.#callback({ kind: "Text" /* Text */, agent: this, newText: chunk.text });
                 break;
               case "reasoning":
                 await this.#callback({ kind: "Reasoning" /* Reasoning */, agent: this, newText: chunk.text });
                 break;
+              case "tool-call":
+                break;
             }
           },
           onFinish: this.config.usageMeter.onFinishHandler(this.ai),
@@ -1928,8 +1848,18 @@ ${instance.prompt}`;
             console.error("Error in stream:", error);
           },
           abortSignal: this.#abortController.signal
+        };
+        if (this.config.toolFormat === "native") {
+          streamTextOptions.tools = this.#toolSet;
+        }
+        const stream = streamText(streamTextOptions);
+        await stream.consumeStream({
+          onError: (error) => {
+            console.error("Error in stream:", error);
+          }
         });
-        await stream.consumeStream();
+        const resp = await stream.response;
+        respMessages = resp.messages;
       } catch (error) {
         if (error instanceof Error && error.name === "AbortError") {
           break;
@@ -1940,7 +1870,7 @@ ${instance.prompt}`;
           clearTimeout(timeout);
         }
       }
-      if (currentAssistantMessage) {
+      if (respMessages.length > 0) {
         break;
       }
       if (this.#aborted) {
@@ -1948,17 +1878,44 @@ ${instance.prompt}`;
       }
       console.debug(`Retrying request ${i + 1} of ${retryCount}`);
     }
-    if (!currentAssistantMessage) {
+    if (respMessages.length === 0) {
       if (this.#aborted) {
         return [];
       }
       throw new Error("No assistant message received");
     }
-    console.log("Assistant message:", currentAssistantMessage);
-    this.#messages.push({
-      role: "assistant",
-      content: currentAssistantMessage
-    });
+    this.#messages.push(...respMessages);
+    if (this.config.toolFormat === "native") {
+      return respMessages.flatMap((msg) => {
+        if (msg.role === "assistant") {
+          const content = msg.content;
+          if (typeof content === "string") {
+            return [{ type: "text", content }];
+          }
+          return content.flatMap((part) => {
+            if (part.type === "text") {
+              return [{ type: "text", content: part.text }];
+            }
+            if (part.type === "tool-call") {
+              return [{ type: "tool_use", id: part.toolCallId, name: part.toolName, params: part.input }];
+            }
+            return [];
+          });
+        }
+        return [];
+      });
+    }
+    const currentAssistantMessage = respMessages.map((msg) => {
+      if (typeof msg.content === "string") {
+        return msg.content;
+      }
+      return msg.content.map((part) => {
+        if (part.type === "text") {
+          return part.text;
+        }
+        return "";
+      });
+    }).join("\n");
     const ret = parseAssistantMessage(currentAssistantMessage, this.config.tools.map(toToolInfoV1), this.config.toolNamePrefix);
     await this.#callback({ kind: "EndRequest" /* EndRequest */, agent: this, message: currentAssistantMessage });
     return ret;
@@ -1971,12 +1928,12 @@ ${instance.prompt}`;
         case "text":
           break;
         case "tool_use": {
-          await this.#callback({ kind: "ToolUse" /* ToolUse */, agent: this, tool: content.name });
+          await this.#callback({ kind: "ToolUse" /* ToolUse */, agent: this, tool: content.name, content: content.params });
           const toolResp = await this.#invokeTool(content.name, content.params);
           switch (toolResp.type) {
             case "Reply" /* Reply */: {
-              await this.#callback({ kind: "ToolReply" /* ToolReply */, agent: this, tool: content.name });
-              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
+              await this.#callback({ kind: "ToolReply" /* ToolReply */, agent: this, tool: content.name, content: toolResp.message });
+              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message, id: content.id });
               break;
             }
             case "Exit" /* Exit */:
@@ -1985,17 +1942,17 @@ ${instance.prompt}`;
               }
               return { type: "exit", reason: toolResp };
             case "Invalid" /* Invalid */: {
-              await this.#callback({ kind: "ToolInvalid" /* ToolInvalid */, agent: this, tool: content.name });
-              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
+              await this.#callback({ kind: "ToolInvalid" /* ToolInvalid */, agent: this, tool: content.name, content: toolResp.message });
+              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message, id: content.id });
               break outer;
             }
             case "Error" /* Error */: {
-              await this.#callback({ kind: "ToolError" /* ToolError */, agent: this, tool: content.name });
-              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
+              await this.#callback({ kind: "ToolError" /* ToolError */, agent: this, tool: content.name, content: toolResp.message });
+              toolResponses.push({ type: "response", tool: content.name, response: toolResp.message, id: content.id });
               break outer;
             }
             case "Interrupted" /* Interrupted */:
-              await this.#callback({ kind: "ToolInterrupted" /* ToolInterrupted */, agent: this, tool: content.name });
+              await this.#callback({ kind: "ToolInterrupted" /* ToolInterrupted */, agent: this, tool: content.name, content: toolResp.message });
               return { type: "exit", reason: toolResp };
             case "HandOver" /* HandOver */: {
               if (toolResponses.length > 0) {
@@ -2029,7 +1986,7 @@ ${instance.prompt}`;
             }
             case "Pause" /* Pause */: {
               await this.#callback({ kind: "ToolPause" /* ToolPause */, agent: this, tool: content.name, object: toolResp.object });
-              toolResponses.push({ type: "pause", tool: content.name, object: toolResp.object });
+              toolResponses.push({ type: "pause", tool: content.name, object: toolResp.object, id: content.id });
               hasPause = true;
             }
           }
@@ -2041,15 +1998,56 @@ ${instance.prompt}`;
       return { type: "exit", reason: { type: "Pause", responses: toolResponses } };
     }
     if (toolResponses.length === 0) {
-      return { type: "reply", message: responsePrompts.requireUseTool };
+      return {
+        type: "reply",
+        message: {
+          role: "user",
+          content: responsePrompts.requireUseToolNative
+        }
+      };
+    }
+    if (this.config.toolFormat === "native") {
+      const toolResults = toolResponses.filter((resp) => resp.type === "response").map(
+        (resp) => ({
+          type: "tool-result",
+          toolCallId: resp.id,
+          toolName: resp.tool,
+          output: {
+            type: "text",
+            value: resp.response
+          }
+        })
+      );
+      return {
+        type: "reply",
+        message: {
+          role: "tool",
+          content: toolResults
+        }
+      };
+    }
+    if (toolResponses.length === 0) {
+      return {
+        type: "reply",
+        message: {
+          role: "user",
+          content: responsePrompts.requireUseTool
+        }
+      };
     }
     const finalResp = toolResponses.filter((resp) => resp.type === "response").flatMap(({ tool, response: response2 }) => responsePrompts.toolResults(tool, response2));
-    return { type: "reply", message: finalResp };
+    return {
+      type: "reply",
+      message: {
+        role: "user",
+        content: finalResp
+      }
+    };
   }
   async #invokeTool(name, args) {
     try {
-      const handler14 = this.handlers[name]?.handler;
-      if (!handler14) {
+      const handler15 = this.handlers[name]?.handler;
+      if (!handler15) {
         return {
           type: "Error" /* Error */,
           message: responsePrompts.errorInvokeTool(name, "Tool not found"),
@@ -2068,7 +2066,7 @@ ${instance.prompt}`;
       if (resp) {
         return resp;
       }
-      return await handler14(this.config.provider, args);
+      return await handler15(this.config.provider, args);
     } catch (error) {
       return {
         type: "Error" /* Error */,
@@ -2125,12 +2123,12 @@ var AnalyzerAgent = class extends AgentBase {
       permissionLevel: 1 /* Read */,
       interactive: true
     });
-    const toolNamePrefix = "tool_";
+    const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt(
       {
         os: options.os
       },
-      tools.map(toToolInfoV1),
+      tools,
       toolNamePrefix,
       options.customInstructions ?? [],
       options.scripts ?? {},
@@ -2221,12 +2219,12 @@ var ArchitectAgent = class extends AgentBase {
       permissionLevel: 1 /* Read */,
       interactive: true
     });
-    const toolNamePrefix = "tool_";
+    const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt2(
       {
         os: options.os
       },
-      tools.map(toToolInfoV1),
+      tools,
       toolNamePrefix,
       options.customInstructions ?? [],
       options.scripts ?? {},
@@ -2327,7 +2325,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, _interactive, useNativeTool) => `
 ${basePrompt}
 ${useNativeTool ? "" : toolUsePrompt(tools, toolNamePrefix)}
 ${codeFixingStrategies}
@@ -2350,12 +2348,12 @@ var CodeFixerAgent = class extends AgentBase {
       permissionLevel: 3 /* Arbitrary */,
       interactive: true
     });
-    const toolNamePrefix = "tool_";
+    const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt3(
       {
         os: options.os
       },
-      tools.map(toToolInfoV1),
+      tools,
       toolNamePrefix,
       options.customInstructions ?? [],
       options.scripts ?? {},
@@ -2378,7 +2376,7 @@ var CodeFixerAgent = class extends AgentBase {
     });
     this.#maxRetries = options.maxRetries ?? 5;
   }
-  async onBeforeInvokeTool(name, args) {
+  async onBeforeInvokeTool(name, _args) {
     if (name === attemptCompletion_default.name) {
       if (this.#retryCount > this.#maxRetries) {
         return;
@@ -2556,12 +2554,12 @@ var CoderAgent = class extends AgentBase {
       permissionLevel: 3 /* Arbitrary */,
       interactive: true
     });
-    const toolNamePrefix = "tool_";
+    const toolNamePrefix = options.toolFormat === "native" ? "" : "tool_";
     const systemPrompt = fullSystemPrompt4(
       {
         os: options.os
       },
-      tools.map(toToolInfoV1),
+      tools,
       toolNamePrefix,
       options.customInstructions ?? [],
       options.scripts ?? {},
@@ -2582,7 +2580,7 @@ var CoderAgent = class extends AgentBase {
       usageMeter: options.usageMeter ?? new UsageMeter()
     });
   }
-  async onBeforeInvokeTool(name, args) {
+  async onBeforeInvokeTool(name, _args) {
     if (name !== attemptCompletion_default.name) {
       return;
     }
@@ -2653,24 +2651,24 @@ var MultiAgent = class {
     switch (exitReason.type) {
       case "HandOver" /* HandOver */: {
         this.#agents.pop();
-        const prompt5 = await this.#config.getPrompt?.(
+        const prompt6 = await this.#config.getPrompt?.(
           exitReason.agentName,
           exitReason.task,
           exitReason.context,
           exitReason.files,
           this.#originalTask
         ) ?? exitReason.task;
-        return await this.#startTask(exitReason.agentName, prompt5);
+        return await this.#startTask(exitReason.agentName, prompt6);
       }
       case "Delegate" /* Delegate */: {
-        const prompt5 = await this.#config.getPrompt?.(
+        const prompt6 = await this.#config.getPrompt?.(
           exitReason.agentName,
           exitReason.task,
           exitReason.context,
           exitReason.files,
           this.#originalTask
         ) ?? exitReason.task;
-        const delegateResult = await this.#startTask(exitReason.agentName, prompt5);
+        const delegateResult = await this.#startTask(exitReason.agentName, prompt6);
         switch (delegateResult.type) {
           case "HandOver" /* HandOver */:
           case "Delegate" /* Delegate */:
@@ -2799,6 +2797,58 @@ var Policies = /* @__PURE__ */ ((Policies2) => {
   return Policies2;
 })(Policies || {});
 
+// src/Agent/policies/EnableCachePolicy.ts
+var CACHEABLE_MODELS = ["sonnet", "opus", "haiku", "gemini"];
+function isCacheableModel(modelId) {
+  return CACHEABLE_MODELS.some((model) => modelId.includes(model));
+}
+function getProviderKey(provider) {
+  if (provider === "openrouter") {
+    return "openrouter";
+  }
+  if (provider.includes("anthropic")) {
+    return "anthropic";
+  }
+  return void 0;
+}
+var EnableCachePolicy = () => {
+  return {
+    name: "enablecache" /* EnableCache */,
+    async prepareMessages(agent, messages) {
+      const providerKey = getProviderKey(agent.ai.provider);
+      if (!providerKey || !isCacheableModel(agent.ai.modelId)) {
+        return messages;
+      }
+      const providerOptions = { [providerKey]: { cacheControl: { type: "ephemeral" } } };
+      const newMessages = messages.slice();
+      let userMessagesToUpdate = 2;
+      for (let i = newMessages.length - 1; i >= 0; i--) {
+        const message = newMessages[i];
+        if (message.role === "user" && userMessagesToUpdate > 0) {
+          newMessages[i] = {
+            ...message,
+            providerOptions: {
+              ...providerOptions,
+              ...message.providerOptions ?? {}
+            }
+          };
+          userMessagesToUpdate--;
+        } else if (message.role === "system") {
+          newMessages[i] = {
+            ...message,
+            providerOptions: {
+              ...providerOptions,
+              ...message.providerOptions ?? {}
+            }
+          };
+          break;
+        }
+      }
+      return newMessages;
+    }
+  };
+};
+
 // src/Agent/policies/TruncateContextPolicy.ts
 var DEFAULT_MAX_TOKENS_ESTIMATE = 32e3;
 function getMaxTokens(agent) {
@@ -2896,58 +2946,6 @@ var TruncateContextPolicy = () => {
   };
 };
 
-// src/Agent/policies/EnableCachePolicy.ts
-var CACHEABLE_MODELS = ["sonnet", "opus", "haiku", "gemini"];
-function isCacheableModel(modelId) {
-  return CACHEABLE_MODELS.some((model) => modelId.includes(model));
-}
-function getProviderKey(provider) {
-  if (provider === "openrouter") {
-    return "openrouter";
-  }
-  if (provider.includes("anthropic")) {
-    return "anthropic";
-  }
-  return void 0;
-}
-var EnableCachePolicy = () => {
-  return {
-    name: "enablecache" /* EnableCache */,
-    async prepareMessages(agent, messages) {
-      const providerKey = getProviderKey(agent.ai.provider);
-      if (!providerKey || !isCacheableModel(agent.ai.modelId)) {
-        return messages;
-      }
-      const providerOptions = { [providerKey]: { cacheControl: { type: "ephemeral" } } };
-      const newMessages = messages.slice();
-      let userMessagesToUpdate = 2;
-      for (let i = newMessages.length - 1; i >= 0; i--) {
-        const message = newMessages[i];
-        if (message.role === "user" && userMessagesToUpdate > 0) {
-          newMessages[i] = {
-            ...message,
-            providerOptions: {
-              ...providerOptions,
-              ...message.providerOptions ?? {}
-            }
-          };
-          userMessagesToUpdate--;
-        } else if (message.role === "system") {
-          newMessages[i] = {
-            ...message,
-            providerOptions: {
-              ...providerOptions,
-              ...message.providerOptions ?? {}
-            }
-          };
-          break;
-        }
-      }
-      return newMessages;
-    }
-  };
-};
-
 // src/Agent/index.ts
 var allAgents = [architectAgentInfo, coderAgentInfo, analyzerAgentInfo, codeFixerAgentInfo];
 
@@ -3009,23 +3007,23 @@ var prompt = `You are an AiTool designed to assist users in creating new project
    - Create a .gitattributes file with appropriate configurations:
      - Mark lock files as generated and exclude them from diffs
      - Example for different package managers:
-       
+
        # For Bun
        bun.lock linguist-generated=true
        bun.lock -diff
-       
+
        # For npm
        package-lock.json linguist-generated=true
        package-lock.json -diff
-       
+
        # For Yarn
        yarn.lock linguist-generated=true
        yarn.lock -diff
-       
+
        # For pnpm
        pnpm-lock.yaml linguist-generated=true
        pnpm-lock.yaml -diff
-       
+
      - Include other common configurations as needed based on project type
 
 6. **Handover to Coder Agent:**
@@ -3281,6 +3279,182 @@ var generateProjectConfig_default = {
   agent: "analyzer"
 };
 
+// src/AiTool/tools/gitDiff.ts
+import { z as z16 } from "zod";
+var toolInfo14 = {
+  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: z16.object({
+    staged: z16.preprocess((val) => {
+      if (typeof val === "string") {
+        const lower = val.toLowerCase();
+        if (lower === "false") return false;
+        if (lower === "true") return true;
+      }
+      return val;
+    }, z16.boolean().optional().default(false)).describe("Get staged changes instead of unstaged changes."),
+    commitRange: z16.string().optional().describe('The commit range to get the diff for (e.g., "main...HEAD").'),
+    file: z16.string().optional().describe("Get the diff for a specific file.")
+  }),
+  permissionLevel: 1 /* Read */
+};
+var handler14 = async (provider, args) => {
+  if (!provider.executeCommand) {
+    return {
+      type: "Error" /* Error */,
+      message: "Not possible to execute command. Abort."
+    };
+  }
+  const { staged, file, commitRange } = toolInfo14.parameters.parse(args);
+  const commandParts = ["git", "diff", "--no-color"];
+  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: "No diff found."
+        };
+      }
+      return {
+        type: "Reply" /* Reply */,
+        message: `<diff file="${file ?? "all"}">
+${result.stdout}
+</diff>`
+      };
+    }
+    return {
+      type: "Error" /* Error */,
+      message: `\`${command}\` exited with code ${result.exitCode}:
+${result.stderr}`
+    };
+  } catch (error) {
+    return {
+      type: "Error" /* Error */,
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+};
+var isAvailable14 = (provider) => {
+  return !!provider.executeCommand;
+};
+var gitDiff_default = {
+  ...toolInfo14,
+  handler: handler14,
+  isAvailable: isAvailable14
+};
+
+// src/AiTool/reviewDiff.ts
+var prompt5 = `
+# Code Review Prompt
+
+You are a senior software engineer reviewing code changes.
+
+## Viewing Changes
+- Use **git_diff** to inspect code.
+  - **Pull request**: use the provided commit range.
+  - **Local changes**: diff staged or unstaged files.
+- If a pull request is present you may receive:
+  - <pr_title>
+  - <pr_description>
+  - <commit_messages>
+- A <review_instructions> tag tells you the focus of the review.
+
+## Focus Areas
+- Readability and maintainability
+- Correctness, edge cases, potential bugs
+- Performance implications
+- Clarity of intent
+- Best-practice adherence
+
+## Output Format
+Do **not** include praise or positive feedback. Ignore generated files such as lock files.
+
+Return your review as a JSON object inside a \`\`\`json block, wrapped like:
+<tool_attempt_completion>
+<tool_parameter_result>
+\`\`\`json
+{
+  "overview": "Summary of overall concerns.",
+  "specificReviews": [
+    {
+      "file": "path/filename.ext",
+      "lines": "N or N-M",
+      "review": "Describe the issue and actionable fix or improvement."
+    }
+  ]
+}
+\`\`\`
+</tool_parameter_result>
+</tool_attempt_completion>
+`;
+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>`);
+    }
+    let instructions = "";
+    if (params.commitRange) {
+      instructions = `Review the pull request. Get the diff using the git_diff tool with the commit range '${params.commitRange}'.`;
+    } else if (params.staged) {
+      instructions = "Review the staged changes. Get the diff using the git_diff tool with staged: true.";
+    } else {
+      instructions = "Review the unstaged changes. Get the diff using the git_diff tool.";
+    }
+    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]
+    });
+  }
+};
+
 // src/AiTool/index.ts
 var executeTool = async (definition, ai, params, usageMeter) => {
   const resp = await generateText({
@@ -3296,10 +3470,7 @@ var executeTool = async (definition, ai, params, usageMeter) => {
   usageMeter.addUsage(ai, resp);
   return definition.parseOutput(resp.text);
 };
-var executeAgentTool = async (definition, agent, params) => {
-  if (!definition.agent) {
-    throw new Error("Agent not specified");
-  }
+var executeMultiAgentTool = async (definition, agent, params) => {
   const exitReason = await agent.startTask({
     agentName: definition.agent,
     task: definition.prompt,
@@ -3310,20 +3481,36 @@ var executeAgentTool = async (definition, agent, params) => {
   }
   throw new Error(`Tool execution failed: ${exitReason.type}`);
 };
+var executeAgentTool = async (definition, options, params) => {
+  const agent = definition.agent(options);
+  const exitReason = await agent.start(`${definition.prompt}
+
+${definition.formatInput(params)}`);
+  if (exitReason.type === "Exit" /* Exit */) {
+    return definition.parseOutput(exitReason.message);
+  }
+  throw new Error(`Tool execution failed: ${exitReason.type}`);
+};
 var makeTool = (definition) => {
   return async (ai, params, usageMeter) => {
     return executeTool(definition, ai, params, usageMeter);
   };
 };
-var makeAgentTool = (definition) => {
+var makeMultiAgentTool = (definition) => {
   return async (agent, params) => {
-    return executeAgentTool(definition, agent, params);
+    return executeMultiAgentTool(definition, agent, params);
+  };
+};
+var makeAgentTool = (definition) => {
+  return async (options, params) => {
+    return executeAgentTool(definition, options, params);
   };
 };
 var generateGitCommitMessage = makeTool(generateGitCommitMessage_default);
 var generateGithubPullRequestDetails = makeTool(generateGithubPullRequestDetails_default);
-var generateProjectConfig = makeAgentTool(generateProjectConfig_default);
-var createNewProject = makeAgentTool(createNewProject_default);
+var reviewDiff = makeAgentTool(reviewDiff_default);
+var generateProjectConfig = makeMultiAgentTool(generateProjectConfig_default);
+var createNewProject = makeMultiAgentTool(createNewProject_default);
 export {
   AgentBase,
   AnalyzerAgent,
@@ -3356,6 +3543,7 @@ export {
   delegate_default as delegate,
   executeAgentTool,
   executeCommand_default as executeCommand,
+  executeMultiAgentTool,
   executeTool,
   fetchUrl_default as fetchUrl,
   generateGitCommitMessage,
@@ -3365,6 +3553,7 @@ export {
   handOver_default as handOver,
   listFiles_default as listFiles,
   makeAgentTool,
+  makeMultiAgentTool,
   makeTool,
   parseAssistantMessage,
   readFile_default as readFile,
@@ -3373,6 +3562,7 @@ export {
   replaceInFile_default as replaceInFile,
   replaceInFile as replaceInFileHelper,
   responsePrompts,
+  reviewDiff,
   searchFiles_default as searchFiles,
   systemInformation,
   toolUsePrompt,