@polka-codes/core 0.9.0 → 0.9.2

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, {
@@ -358,7 +188,7 @@ var handler2 = async (provider, args) => {
     message: `<user_message>${moreMessage}</user_message>`
   };
 };
-var isAvailable2 = (provider) => {
+var isAvailable2 = (_provider) => {
   return true;
 };
 var attemptCompletion_default = {
@@ -589,22 +419,88 @@ var fetchUrl_default = {
   isAvailable: isAvailable5
 };
 
-// src/tools/listFiles.ts
+// src/tools/handOver.ts
 import { z as z6 } from "zod";
 var toolInfo6 = {
+  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({
+    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" })
+  }),
+  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 handler6 = async (_provider, args) => {
+  const parsed = toolInfo6.parameters.safeParse(args);
+  if (!parsed.success) {
+    return {
+      type: "Invalid" /* Invalid */,
+      message: `Invalid arguments for hand_over: ${parsed.error.message}`
+    };
+  }
+  const { agentName, task, context, files } = parsed.data;
+  return {
+    type: "HandOver" /* HandOver */,
+    agentName,
+    task,
+    context,
+    files: files ?? []
+  };
+};
+var isAvailable6 = (_provider) => {
+  return true;
+};
+var handOver_default = {
+  ...toolInfo6,
+  handler: handler6,
+  isAvailable: isAvailable6
+};
+
+// 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: 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) => {
+  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;
-    }, 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)" })
+    }, 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)" })
   }),
   examples: [
     {
@@ -623,14 +519,14 @@ var toolInfo6 = {
   ],
   permissionLevel: 1 /* Read */
 };
-var handler6 = async (provider, args) => {
+var handler7 = async (provider, args) => {
   if (!provider.listFiles) {
     return {
       type: "Error" /* Error */,
       message: "Not possible to list files. Abort."
     };
   }
-  const { path, maxCount, recursive } = toolInfo6.parameters.parse(args);
+  const { path, maxCount, recursive } = toolInfo7.parameters.parse(args);
   const [files, limitReached] = await provider.listFiles(path, recursive, maxCount);
   return {
     type: "Reply" /* Reply */,
@@ -641,26 +537,26 @@ ${files.join("\n")}
 <list_files_truncated>${limitReached}</list_files_truncated>`
   };
 };
-var isAvailable6 = (provider) => {
+var isAvailable7 = (provider) => {
   return !!provider.listFiles;
 };
 var listFiles_default = {
-  ...toolInfo6,
-  handler: handler6,
-  isAvailable: isAvailable6
+  ...toolInfo7,
+  handler: handler7,
+  isAvailable: isAvailable7
 };
 
 // src/tools/readFile.ts
-import { z as z7 } from "zod";
-var toolInfo7 = {
+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" })
+    }, z8.array(z8.string())).describe("The path of the file to read").meta({ usageValue: "Comma separated paths here" })
   }),
   examples: [
     {
@@ -684,14 +580,14 @@ var toolInfo7 = {
   ],
   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,26 +607,126 @@ 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/replaceInFile.ts
-import { z as z8 } from "zod";
-
-// src/tools/utils/replaceInFile.ts
-var replaceInFile = (fileContent, diff) => {
-  const blockPattern = /<<<<<+ SEARCH>?\s*\r?\n([\s\S]*?)\r?\n=======[ \t]*\r?\n([\s\S]*?)\r?\n?>>>>>+ REPLACE/g;
-  const blocks = [];
-  for (let match = blockPattern.exec(diff); match !== null; match = blockPattern.exec(diff)) {
-    blocks.push({ search: match[1], replace: match[2] });
-  }
-  if (blocks.length === 0) {
+// 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" })
+  }),
+  examples: [
+    {
+      description: "Request to remove a file",
+      parameters: [
+        {
+          name: "path",
+          value: "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" })
+  }),
+  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 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 z11 } from "zod";
+
+// src/tools/utils/replaceInFile.ts
+var replaceInFile = (fileContent, diff) => {
+  const blockPattern = /<<<<<+ SEARCH>?\s*\r?\n([\s\S]*?)\r?\n=======[ \t]*\r?\n([\s\S]*?)\r?\n?>>>>>+ REPLACE/g;
+  const blocks = [];
+  for (let match = blockPattern.exec(diff); match !== null; match = blockPattern.exec(diff)) {
+    blocks.push({ search: match[1], replace: match[2] });
+  }
+  if (blocks.length === 0) {
     throw new Error("No valid diff blocks found.");
   }
   const findAndReplace = (content, search, replace) => {
@@ -798,12 +794,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
@@ -934,7 +930,7 @@ function oldFeature() {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler8 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -942,7 +938,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,28 +975,28 @@ 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)"
@@ -1027,7 +1023,7 @@ var toolInfo9 = {
   ],
   permissionLevel: 1 /* Read */
 };
-var handler9 = async (provider, args) => {
+var handler12 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -1035,7 +1031,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,23 +1050,23 @@ ${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" })
   }),
@@ -1102,14 +1098,14 @@ 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 +1121,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
@@ -1365,6 +1226,150 @@ function toToolInfoV1(tool) {
   };
 }
 
+// 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 { streamText } from "ai";
 
@@ -1641,7 +1646,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
@@ -2327,7 +2332,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}
@@ -2378,7 +2383,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;
@@ -2582,7 +2587,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;
     }
@@ -2762,7 +2767,10 @@ var configSchema = z15.object({
     z15.object({
       apiKey: z15.string().optional(),
       defaultModel: z15.string().optional(),
-      defaultParameters: z15.record(z15.string(), z15.any()).optional()
+      defaultParameters: z15.record(z15.string(), z15.any()).optional(),
+      location: z15.string().optional(),
+      project: z15.string().optional(),
+      keyFile: z15.string().optional()
     })
   ).optional(),
   defaultProvider: z15.string().optional(),
@@ -2796,6 +2804,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) {
@@ -2893,58 +2953,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];