@polka-codes/core 0.9.1 → 0.9.3

package/dist/_tsup-dts-rollup.d.ts

@@ -2,11 +2,13 @@ import type { FilePart } from 'ai';
 import type { ImagePart } from 'ai';
 import type { LanguageModelV2 } from '@ai-sdk/provider';
 import type { LanguageModelV2Usage } from '@ai-sdk/provider';
-import type { ModelMessage } from 'ai';
-import type { ModelMessage as ModelMessage_2 } from '@ai-sdk/provider-utils';
+import type { ModelMessage } from '@ai-sdk/provider-utils';
+import type { ModelMessage as ModelMessage_2 } from 'ai';
 import type { TextPart } from 'ai';
+import type { ToolModelMessage } from '@ai-sdk/provider-utils';
 import type { UserContent } from '@ai-sdk/provider-utils';
 import type { UserContent as UserContent_2 } from 'ai';
+import type { UserModelMessage } from '@ai-sdk/provider-utils';
 import { z } from 'zod';
 
 declare abstract class AgentBase {
@@ -17,13 +19,13 @@ declare abstract class AgentBase {
     constructor(name: string, ai: LanguageModelV2, config: AgentBaseConfig);
     abort(): void;
     get parameters(): Readonly<Record<string, any>>;
-    get messages(): Readonly<ModelMessage_2[]>;
-    setMessages(messages: Readonly<ModelMessage_2[]>): void;
+    get messages(): Readonly<ModelMessage[]>;
+    setMessages(messages: Readonly<ModelMessage[]>): void;
     start(prompt: UserContent): Promise<ExitReason>;
     step(prompt: UserContent): Promise<AssistantMessageContent[]>;
     handleStepResponse(response: AssistantMessageContent[]): Promise<{
         type: "reply";
-        message: UserContent;
+        message: UserModelMessage | ToolModelMessage;
     } | {
         type: "exit";
         reason: ExitReason;
@@ -89,7 +91,7 @@ declare type AgentPolicyInstance = {
     prompt?: string;
     onBeforeInvokeTool?: (name: string, args: Record<string, string>) => Promise<ToolResponse | undefined>;
     onBeforeRequest?: (agent: AgentBase) => Promise<void>;
-    prepareMessages?: (agent: AgentBase, messages: ModelMessage[]) => Promise<ModelMessage[]>;
+    prepareMessages?: (agent: AgentBase, messages: ModelMessage_2[]) => Promise<ModelMessage_2[]>;
 };
 export { AgentPolicyInstance }
 export { AgentPolicyInstance as AgentPolicyInstance_alias_1 }
@@ -106,12 +108,19 @@ declare type AiToolDefinition<Input, Output = string> = {
     prompt: string;
     formatInput: (params: Input) => string;
     parseOutput: (output: string) => Output;
-    agent?: AgentNameType;
 };
 export { AiToolDefinition }
 export { AiToolDefinition as AiToolDefinition_alias_1 }
 export { AiToolDefinition as AiToolDefinition_alias_2 }
 
+export declare type AiToolDefinitionWithAgent<Input, Output = string> = AiToolDefinition<Input, Output> & {
+    agent: (options: SharedAgentOptions) => AgentBase;
+};
+
+export declare type AiToolDefinitionWithMultiAgent<Input, Output = string> = AiToolDefinition<Input, Output> & {
+    agent: AgentNameType;
+};
+
 declare const allAgents: readonly [{
     readonly name: "architect";
     readonly responsibilities: ["Analyzing the user’s overall task and requirements.", "Creating plans and making higher-level decisions about system structure and design.", "Reviewing and analyzing existing code or components for maintainability and scalability.", "Laying out the roadmap for implementation."];
@@ -135,14 +144,14 @@ export declare namespace allTools {
         _default_3 as delegate,
         _default_4 as executeCommand,
         _default_5 as fetchUrl,
-        _default_6 as listFiles,
-        _default_7 as readFile,
-        _default_8 as replaceInFile,
-        _default_9 as searchFiles,
-        _default_10 as writeToFile,
-        _default_11 as handOver,
-        _default_12 as removeFile,
-        _default_13 as renameFile
+        _default_6 as handOver,
+        _default_7 as listFiles,
+        _default_8 as readFile,
+        _default_9 as removeFile,
+        _default_10 as renameFile,
+        _default_11 as replaceInFile,
+        _default_12 as searchFiles,
+        _default_13 as writeToFile
     }
 }
 
@@ -197,7 +206,7 @@ export declare const basePrompt = "You are a highly skilled software engineer sp
 
 export declare const basePrompt_alias_1 = "You are a highly skilled software engineer with extensive knowledge in many programming languages, frameworks, design patterns, and best practices.";
 
-declare const capabilities: (toolNamePrefix: string) => string;
+declare const capabilities: (_toolNamePrefix: string) => string;
 export { capabilities }
 export { capabilities as capabilities_alias_1 }
 export { capabilities as capabilities_alias_2 }
@@ -209,7 +218,7 @@ export { capabilities as capabilities_alias_2 }
 declare class CodeFixerAgent extends AgentBase {
     #private;
     constructor(options: CodeFixerAgentOptions);
-    protected onBeforeInvokeTool(name: string, args: Record<string, string>): Promise<ToolResponse | undefined>;
+    protected onBeforeInvokeTool(name: string, _args: Record<string, string>): Promise<ToolResponse | undefined>;
 }
 export { CodeFixerAgent }
 export { CodeFixerAgent as CodeFixerAgent_alias_1 }
@@ -238,7 +247,7 @@ export declare const codeFixingStrategies = "\n====\n\nCODE FIXING STRATEGIES\n\
  */
 declare class CoderAgent extends AgentBase {
     constructor(options: CoderAgentOptions);
-    protected onBeforeInvokeTool(name: string, args: Record<string, string>): Promise<ToolResponse | undefined>;
+    protected onBeforeInvokeTool(name: string, _args: Record<string, string>): Promise<ToolResponse | undefined>;
 }
 export { CoderAgent }
 export { CoderAgent as CoderAgent_alias_1 }
@@ -371,44 +380,6 @@ declare const _default: {
                 options: z.ZodDefault<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Single clarifying question (no options)";
-            readonly parameters: [{
-                readonly name: "questions";
-                readonly value: {
-                    readonly prompt: "What is the target deployment environment?";
-                };
-            }];
-        }, {
-            readonly description: "Single question with multiple-choice options";
-            readonly parameters: [{
-                readonly name: "questions";
-                readonly value: {
-                    readonly prompt: "Which frontend framework are you using?";
-                    readonly options: ["React", "Angular", "Vue", "Svelte"];
-                };
-            }];
-        }, {
-            readonly description: "Two related questions in one call";
-            readonly parameters: [{
-                readonly name: "questions";
-                readonly value: [{
-                    readonly prompt: "What type of application are you building?";
-                }, {
-                    readonly prompt: "Preferred programming language?";
-                    readonly options: ["JavaScript", "TypeScript", "Python", "Java"];
-                }];
-            }];
-        }, {
-            readonly description: "Binary (yes/no) confirmation";
-            readonly parameters: [{
-                readonly name: "questions";
-                readonly value: {
-                    readonly prompt: "Is it acceptable to refactor existing tests to improve performance?";
-                    readonly options: ["Yes", "No"];
-                };
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.None;
     }, InteractionProvider>;
     isAvailable: (provider: InteractionProvider) => boolean;
@@ -420,234 +391,110 @@ declare const _default: {
             options: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Single clarifying question (no options)";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "What is the target deployment environment?";
-            };
-        }];
-    }, {
-        readonly description: "Single question with multiple-choice options";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "Which frontend framework are you using?";
-                readonly options: ["React", "Angular", "Vue", "Svelte"];
-            };
-        }];
-    }, {
-        readonly description: "Two related questions in one call";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: [{
-                readonly prompt: "What type of application are you building?";
-            }, {
-                readonly prompt: "Preferred programming language?";
-                readonly options: ["JavaScript", "TypeScript", "Python", "Java"];
-            }];
-        }];
-    }, {
-        readonly description: "Binary (yes/no) confirmation";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "Is it acceptable to refactor existing tests to improve performance?";
-                readonly options: ["Yes", "No"];
-            };
-        }];
-    }];
     permissionLevel: PermissionLevel.None;
 };
 export { _default as askFollowupQuestion }
 export { _default as askFollowupQuestion_alias_1 }
 export { _default as askFollowupQuestion_alias_2 }
-export { _default as default_alias_4 }
+export { _default as default_alias_6 }
 
 declare const _default_10: {
     handler: ToolHandler<{
-        readonly name: "write_to_file";
-        readonly 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.";
+        readonly name: "rename_file";
+        readonly description: "Request to rename a file from source path to target path.";
         readonly parameters: z.ZodObject<{
-            path: z.ZodString;
-            content: z.ZodString;
+            source_path: z.ZodString;
+            target_path: z.ZodString;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to write content to a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/main.js";
-            }, {
-                readonly name: "content";
-                readonly value: "import React from 'react';\n\nfunction App() {\n  return (\n    <div>\n      <h1>Hello, World!</h1>\n    </div>\n  );\n}\n\nexport default App;\n";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    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.";
+    name: "rename_file";
+    description: "Request to rename a file from source path to target path.";
     parameters: z.ZodObject<{
-        path: z.ZodString;
-        content: z.ZodString;
+        source_path: z.ZodString;
+        target_path: z.ZodString;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to write content to a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }, {
-            readonly name: "content";
-            readonly value: "import React from 'react';\n\nfunction App() {\n  return (\n    <div>\n      <h1>Hello, World!</h1>\n    </div>\n  );\n}\n\nexport default App;\n";
-        }];
-    }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_10 as default_alias_16 }
-export { _default_10 as writeToFile }
-export { _default_10 as writeToFile_alias_1 }
-export { _default_10 as writeToFile_alias_2 }
+export { _default_10 as default_alias_15 }
+export { _default_10 as renameFile }
+export { _default_10 as renameFile_alias_1 }
+export { _default_10 as renameFile_alias_2 }
 
 declare const _default_11: {
     handler: ToolHandler<{
-        readonly name: "hand_over";
-        readonly description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.";
+        readonly name: "replace_in_file";
+        readonly 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.";
         readonly parameters: z.ZodObject<{
-            agentName: z.ZodString;
-            task: z.ZodString;
-            context: z.ZodString;
-            files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+            path: z.ZodString;
+            diff: z.ZodString;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Hand over a coding task to the coder agent";
-            readonly parameters: [{
-                readonly name: "agentName";
-                readonly value: "coder";
-            }, {
-                readonly name: "task";
-                readonly value: "Implement the login feature";
-            }, {
-                readonly name: "context";
-                readonly value: "We need a secure login system with email and password";
-            }, {
-                readonly name: "files";
-                readonly value: "src/auth/login.ts,src/auth/types.ts";
-            }];
-        }];
-        readonly permissionLevel: PermissionLevel.None;
-    }, any>;
-    isAvailable: (_provider: any) => boolean;
-    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.";
+        readonly permissionLevel: PermissionLevel.Write;
+    }, FilesystemProvider>;
+    isAvailable: (provider: FilesystemProvider) => boolean;
+    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: z.ZodObject<{
-        agentName: z.ZodString;
-        task: z.ZodString;
-        context: z.ZodString;
-        files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+        path: z.ZodString;
+        diff: z.ZodString;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Hand over a coding task to the coder agent";
-        readonly parameters: [{
-            readonly name: "agentName";
-            readonly value: "coder";
-        }, {
-            readonly name: "task";
-            readonly value: "Implement the login feature";
-        }, {
-            readonly name: "context";
-            readonly value: "We need a secure login system with email and password";
-        }, {
-            readonly name: "files";
-            readonly value: "src/auth/login.ts,src/auth/types.ts";
-        }];
-    }];
-    permissionLevel: PermissionLevel.None;
+    permissionLevel: PermissionLevel.Write;
 };
-export { _default_11 as default_alias_9 }
-export { _default_11 as handOver }
-export { _default_11 as handOver_alias_1 }
-export { _default_11 as handOver_alias_2 }
+export { _default_11 as default_alias_16 }
+export { _default_11 as replaceInFile }
+export { _default_11 as replaceInFile_alias_1 }
+export { _default_11 as replaceInFile_alias_2 }
 
 declare const _default_12: {
     handler: ToolHandler<{
-        readonly name: "remove_file";
-        readonly description: "Request to remove a file at the specified path.";
+        readonly name: "search_files";
+        readonly 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.";
         readonly parameters: z.ZodObject<{
             path: z.ZodString;
+            regex: z.ZodString;
+            filePattern: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to remove a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/main.js";
-            }];
-        }];
-        readonly permissionLevel: PermissionLevel.Write;
+        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    name: "remove_file";
-    description: "Request to remove a file at the specified path.";
+    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: z.ZodObject<{
         path: z.ZodString;
+        regex: z.ZodString;
+        filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to remove a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }];
-    }];
-    permissionLevel: PermissionLevel.Write;
+    permissionLevel: PermissionLevel.Read;
 };
-export { _default_12 as default_alias_12 }
-export { _default_12 as removeFile }
-export { _default_12 as removeFile_alias_1 }
-export { _default_12 as removeFile_alias_2 }
+export { _default_12 as default_alias_17 }
+export { _default_12 as searchFiles }
+export { _default_12 as searchFiles_alias_1 }
+export { _default_12 as searchFiles_alias_2 }
 
 declare const _default_13: {
     handler: ToolHandler<{
-        readonly name: "rename_file";
-        readonly description: "Request to rename a file from source path to target path.";
+        readonly name: "write_to_file";
+        readonly 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.";
         readonly parameters: z.ZodObject<{
-            source_path: z.ZodString;
-            target_path: z.ZodString;
+            path: z.ZodString;
+            content: z.ZodString;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to rename a file";
-            readonly parameters: [{
-                readonly name: "source_path";
-                readonly value: "src/old-name.js";
-            }, {
-                readonly name: "target_path";
-                readonly value: "src/new-name.js";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    name: "rename_file";
-    description: "Request to rename a file from source path to target path.";
+    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: z.ZodObject<{
-        source_path: z.ZodString;
-        target_path: z.ZodString;
+        path: z.ZodString;
+        content: z.ZodString;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to rename a file";
-        readonly parameters: [{
-            readonly name: "source_path";
-            readonly value: "src/old-name.js";
-        }, {
-            readonly name: "target_path";
-            readonly value: "src/new-name.js";
-        }];
-    }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_13 as default_alias_13 }
-export { _default_13 as renameFile }
-export { _default_13 as renameFile_alias_1 }
-export { _default_13 as renameFile_alias_2 }
+export { _default_13 as default_alias_18 }
+export { _default_13 as writeToFile }
+export { _default_13 as writeToFile_alias_1 }
+export { _default_13 as writeToFile_alias_2 }
 
 declare const _default_2: {
     handler: ToolHandler<{
@@ -656,34 +503,20 @@ declare const _default_2: {
         readonly parameters: z.ZodObject<{
             result: z.ZodString;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to present the result of the task";
-            readonly parameters: [{
-                readonly name: "result";
-                readonly value: "Your final result description here";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.None;
     }, InteractionProvider>;
-    isAvailable: (provider: InteractionProvider) => boolean;
+    isAvailable: (_provider: InteractionProvider) => boolean;
     name: "attempt_completion";
     description: "Use this tool when you believe the user’s requested task is complete. Indicate that your work is finished, but acknowledge the user may still provide additional instructions or questions if they want to continue. This tool MUST NOT to be used with any other tool.";
     parameters: z.ZodObject<{
         result: z.ZodString;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to present the result of the task";
-        readonly parameters: [{
-            readonly name: "result";
-            readonly value: "Your final result description here";
-        }];
-    }];
     permissionLevel: PermissionLevel.None;
 };
 export { _default_2 as attemptCompletion }
 export { _default_2 as attemptCompletion_alias_1 }
 export { _default_2 as attemptCompletion_alias_2 }
-export { _default_2 as default_alias_5 }
+export { _default_2 as default_alias_7 }
 
 declare const _default_3: {
     handler: ToolHandler<{
@@ -695,22 +528,6 @@ declare const _default_3: {
             context: z.ZodString;
             files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Delegate a code analysis task to the analyzer agent";
-            readonly parameters: [{
-                readonly name: "agentName";
-                readonly value: "analyzer";
-            }, {
-                readonly name: "task";
-                readonly value: "Analyze the authentication implementation";
-            }, {
-                readonly name: "context";
-                readonly value: "Need to understand the security implications of the current auth system";
-            }, {
-                readonly name: "files";
-                readonly value: "src/auth/login.ts,src/auth/types.ts";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.None;
     }, any>;
     isAvailable: (_provider: any) => boolean;
@@ -722,25 +539,9 @@ declare const _default_3: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Delegate a code analysis task to the analyzer agent";
-        readonly parameters: [{
-            readonly name: "agentName";
-            readonly value: "analyzer";
-        }, {
-            readonly name: "task";
-            readonly value: "Analyze the authentication implementation";
-        }, {
-            readonly name: "context";
-            readonly value: "Need to understand the security implications of the current auth system";
-        }, {
-            readonly name: "files";
-            readonly value: "src/auth/login.ts,src/auth/types.ts";
-        }];
-    }];
     permissionLevel: PermissionLevel.None;
 };
-export { _default_3 as default_alias_6 }
+export { _default_3 as default_alias_8 }
 export { _default_3 as delegate }
 export { _default_3 as delegate_alias_1 }
 export { _default_3 as delegate_alias_2 }
@@ -753,16 +554,6 @@ declare const _default_4: {
             command: z.ZodString;
             requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Make a build";
-            readonly parameters: [{
-                readonly name: "command";
-                readonly value: "npm run build";
-            }, {
-                readonly name: "requiresApproval";
-                readonly value: "false";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Arbitrary;
     }, CommandProvider>;
     isAvailable: (provider: CommandProvider) => boolean;
@@ -772,19 +563,9 @@ declare const _default_4: {
         command: z.ZodString;
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Make a build";
-        readonly parameters: [{
-            readonly name: "command";
-            readonly value: "npm run build";
-        }, {
-            readonly name: "requiresApproval";
-            readonly value: "false";
-        }];
-    }];
     permissionLevel: PermissionLevel.Arbitrary;
 };
-export { _default_4 as default_alias_7 }
+export { _default_4 as default_alias_9 }
 export { _default_4 as executeCommand }
 export { _default_4 as executeCommand_alias_1 }
 export { _default_4 as executeCommand_alias_2 }
@@ -796,25 +577,6 @@ declare const _default_5: {
         readonly parameters: z.ZodObject<{
             url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Fetch a single webpage";
-            readonly parameters: [{
-                readonly name: "url";
-                readonly value: "https://example.com";
-            }];
-        }, {
-            readonly description: "Fetch multiple webpages";
-            readonly parameters: [{
-                readonly name: "url";
-                readonly value: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP";
-            }];
-        }, {
-            readonly description: "Fetch a raw file from GitHub";
-            readonly parameters: [{
-                readonly name: "url";
-                readonly value: "https://raw.githubusercontent.com/user/repo/main/README.md";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Read;
     }, WebProvider>;
     isAvailable: (provider: WebProvider) => boolean;
@@ -823,33 +585,42 @@ declare const _default_5: {
     parameters: z.ZodObject<{
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Fetch a single webpage";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://example.com";
-        }];
-    }, {
-        readonly description: "Fetch multiple webpages";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP";
-        }];
-    }, {
-        readonly description: "Fetch a raw file from GitHub";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://raw.githubusercontent.com/user/repo/main/README.md";
-        }];
-    }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_5 as default_alias_8 }
+export { _default_5 as default_alias_10 }
 export { _default_5 as fetchUrl }
 export { _default_5 as fetchUrl_alias_1 }
 export { _default_5 as fetchUrl_alias_2 }
 
 declare const _default_6: {
+    handler: ToolHandler<{
+        readonly name: "hand_over";
+        readonly description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.";
+        readonly parameters: z.ZodObject<{
+            agentName: z.ZodString;
+            task: z.ZodString;
+            context: z.ZodString;
+            files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>;
+        readonly permissionLevel: PermissionLevel.None;
+    }, any>;
+    isAvailable: (_provider: any) => boolean;
+    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: z.ZodObject<{
+        agentName: z.ZodString;
+        task: z.ZodString;
+        context: z.ZodString;
+        files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>;
+    permissionLevel: PermissionLevel.None;
+};
+export { _default_6 as default_alias_11 }
+export { _default_6 as handOver }
+export { _default_6 as handOver_alias_1 }
+export { _default_6 as handOver_alias_2 }
+
+declare const _default_7: {
     handler: ToolHandler<{
         readonly name: "list_files";
         readonly 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.";
@@ -858,16 +629,6 @@ declare const _default_6: {
             maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
             recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to list files";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src";
-            }, {
-                readonly name: "maxCount";
-                readonly value: "100";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
@@ -878,43 +639,20 @@ declare const _default_6: {
         maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to list files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "maxCount";
-            readonly value: "100";
-        }];
-    }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_6 as default_alias_10 }
-export { _default_6 as listFiles }
-export { _default_6 as listFiles_alias_1 }
-export { _default_6 as listFiles_alias_2 }
+export { _default_7 as default_alias_12 }
+export { _default_7 as listFiles }
+export { _default_7 as listFiles_alias_1 }
+export { _default_7 as listFiles_alias_2 }
 
-declare const _default_7: {
+declare const _default_8: {
     handler: ToolHandler<{
         readonly name: "read_file";
         readonly 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.";
         readonly parameters: z.ZodObject<{
             path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to read the contents of a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/main.js";
-            }];
-        }, {
-            readonly description: "Request to read multiple files";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/main.js,src/index.js";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
@@ -923,175 +661,34 @@ declare const _default_7: {
     parameters: z.ZodObject<{
         path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to read the contents of a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }];
-    }, {
-        readonly description: "Request to read multiple files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js,src/index.js";
-        }];
-    }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_7 as default_alias_11 }
-export { _default_7 as readFile }
-export { _default_7 as readFile_alias_1 }
-export { _default_7 as readFile_alias_2 }
+export { _default_8 as default_alias_13 }
+export { _default_8 as readFile }
+export { _default_8 as readFile_alias_1 }
+export { _default_8 as readFile_alias_2 }
 
-declare const _default_8: {
+declare const _default_9: {
     handler: ToolHandler<{
-        readonly name: "replace_in_file";
-        readonly 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.";
+        readonly name: "remove_file";
+        readonly description: "Request to remove a file at the specified path.";
         readonly parameters: z.ZodObject<{
             path: z.ZodString;
-            diff: z.ZodString;
         }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to replace sections of content in a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/main.js";
-            }, {
-                readonly name: "diff";
-                readonly value: "<<<<<<< SEARCH\nimport React from 'react';\n=======\nimport React, { useState } from 'react';\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\n=======\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nreturn (\n  <div>\n=======\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\nreturn (\n  <div>\n>>>>>>> REPLACE";
-            }];
-        }, {
-            readonly description: "Request to perform a simple, single-line replacement";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/config.js";
-            }, {
-                readonly name: "diff";
-                readonly value: "<<<<<<< SEARCH\nconst API_URL = 'https://api.example.com';\n=======\nconst API_URL = 'https://api.staging.example.com';\n>>>>>>> REPLACE";
-            }];
-        }, {
-            readonly description: "Request to add a new function to a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/utils.js";
-            }, {
-                readonly name: "diff";
-                readonly value: "<<<<<<< SEARCH\nfunction helperA() {\n  // ...\n}\n=======\nfunction helperA() {\n  // ...\n}\n\nfunction newHelper() {\n  // implementation\n}\n>>>>>>> REPLACE";
-            }];
-        }, {
-            readonly description: "Request to delete a block of code from a file";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/app.js";
-            }, {
-                readonly name: "diff";
-                readonly value: "<<<<<<< SEARCH\nfunction oldFeature() {\n  // This is no longer needed\n}\n\n=======\n>>>>>>> REPLACE";
-            }];
-        }];
         readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    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.";
+    name: "remove_file";
+    description: "Request to remove a file at the specified path.";
     parameters: z.ZodObject<{
         path: z.ZodString;
-        diff: z.ZodString;
     }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to replace sections of content in a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nimport React from 'react';\n=======\nimport React, { useState } from 'react';\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\n=======\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nreturn (\n  <div>\n=======\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\nreturn (\n  <div>\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to perform a simple, single-line replacement";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/config.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nconst API_URL = 'https://api.example.com';\n=======\nconst API_URL = 'https://api.staging.example.com';\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to add a new function to a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nfunction helperA() {\n  // ...\n}\n=======\nfunction helperA() {\n  // ...\n}\n\nfunction newHelper() {\n  // implementation\n}\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to delete a block of code from a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/app.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nfunction oldFeature() {\n  // This is no longer needed\n}\n\n=======\n>>>>>>> REPLACE";
-        }];
-    }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_8 as default_alias_14 }
-export { _default_8 as replaceInFile }
-export { _default_8 as replaceInFile_alias_1 }
-export { _default_8 as replaceInFile_alias_2 }
-
-declare const _default_9: {
-    handler: ToolHandler<{
-        readonly name: "search_files";
-        readonly 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.";
-        readonly parameters: z.ZodObject<{
-            path: z.ZodString;
-            regex: z.ZodString;
-            filePattern: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-        readonly examples: [{
-            readonly description: "Request to perform a regex search across files";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src";
-            }, {
-                readonly name: "regex";
-                readonly value: "^components/";
-            }, {
-                readonly name: "filePattern";
-                readonly value: "*.ts,*.tsx";
-            }];
-        }];
-        readonly permissionLevel: PermissionLevel.Read;
-    }, FilesystemProvider>;
-    isAvailable: (provider: FilesystemProvider) => boolean;
-    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: z.ZodObject<{
-        path: z.ZodString;
-        regex: z.ZodString;
-        filePattern: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    examples: [{
-        readonly description: "Request to perform a regex search across files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "regex";
-            readonly value: "^components/";
-        }, {
-            readonly name: "filePattern";
-            readonly value: "*.ts,*.tsx";
-        }];
-    }];
-    permissionLevel: PermissionLevel.Read;
-};
-export { _default_9 as default_alias_15 }
-export { _default_9 as searchFiles }
-export { _default_9 as searchFiles_alias_1 }
-export { _default_9 as searchFiles_alias_2 }
+export { _default_9 as default_alias_14 }
+export { _default_9 as removeFile }
+export { _default_9 as removeFile_alias_1 }
+export { _default_9 as removeFile_alias_2 }
 
 /**
  * AI tool for creating new projects based on user specifications.
@@ -1100,7 +697,7 @@ export { _default_9 as searchFiles_alias_2 }
 export declare const default_alias: {
     readonly name: "createNewProject";
     readonly description: "Creates a new project";
-    readonly prompt: "You are an AiTool designed to assist users in creating new projects. Follow these guidelines:\n\n1. **Gather Information:**\n   - Begin by asking the user for essential project details, including:\n     - Project type (e.g., web, mobile, desktop, etc.)\n     - Desired programming languages\n     - Preferred frameworks or libraries\n     - Build tools and package manager preferences\n     - Testing frameworks and patterns\n     - Code style and linting preferences\n     - Any additional specifications or requirements\n\n2. **Clarification & Confirmation:**\n   - Do not make any decisions or assumptions on behalf of the user.\n   - Ask clarifying questions if any detail is ambiguous.\n   - Confirm each piece of information with the user before proceeding to the next step.\n\n3. **Avoid Redundancy:**\n   - Do not repeat questions or details that have already been confirmed.\n   - Keep interactions concise and focused on gathering complete and accurate details.\n\n4. **Generate Configuration:**\n   - Based on the collected information, generate a .polkacodes.yml configuration file that includes:\n     - scripts section with common development commands (test, format, check, etc.)\n     - rules section reflecting project conventions and tools\n     - excludeFiles section for sensitive files only\n   - Example structure:\n     ```yaml\n     scripts:\n       test:\n         command: \"[test-command]\"\n         description: \"Run tests\"\n       format:\n         command: \"[format-command]\"\n         description: \"Format code\"\n       check:\n         command: \"[check-command]\"\n         description: \"Check code\"\n\n     rules:\n       - \"[package-manager-rule]\"\n       - \"[testing-framework-rule]\"\n       - \"[code-style-rule]\"\n       - \"[other-rule]\"\n\n     excludeFiles:\n       - \".env\"\n       - \".env.*\"\n     ```\n\n5. **Generate Essential Project Files:**\n   - Create a .gitattributes file with appropriate configurations:\n     - Mark lock files as generated and exclude them from diffs\n     - Example for different package managers:\n       \n       # For Bun\n       bun.lock linguist-generated=true\n       bun.lock -diff\n       \n       # For npm\n       package-lock.json linguist-generated=true\n       package-lock.json -diff\n       \n       # For Yarn\n       yarn.lock linguist-generated=true\n       yarn.lock -diff\n       \n       # For pnpm\n       pnpm-lock.yaml linguist-generated=true\n       pnpm-lock.yaml -diff\n       \n     - Include other common configurations as needed based on project type\n\n6. **Handover to Coder Agent:**\n   - Once all required information is collected and validated by the user, compile:\n     1. The final project specifications\n     2. The .polkacodes.yml configuration content\n   - Clearly hand over these details to the coder agent, instructing them to:\n     1. Create the new project based on the confirmed specifications\n     2. Include the .polkacodes.yml file in the project root\n     3. Include the .gitattributes file with appropriate configurations\n     4. Ensure all specified tools and configurations are properly set up";
+    readonly prompt: "You are an AiTool designed to assist users in creating new projects. Follow these guidelines:\n\n1. **Gather Information:**\n   - Begin by asking the user for essential project details, including:\n     - Project type (e.g., web, mobile, desktop, etc.)\n     - Desired programming languages\n     - Preferred frameworks or libraries\n     - Build tools and package manager preferences\n     - Testing frameworks and patterns\n     - Code style and linting preferences\n     - Any additional specifications or requirements\n\n2. **Clarification & Confirmation:**\n   - Do not make any decisions or assumptions on behalf of the user.\n   - Ask clarifying questions if any detail is ambiguous.\n   - Confirm each piece of information with the user before proceeding to the next step.\n\n3. **Avoid Redundancy:**\n   - Do not repeat questions or details that have already been confirmed.\n   - Keep interactions concise and focused on gathering complete and accurate details.\n\n4. **Generate Configuration:**\n   - Based on the collected information, generate a .polkacodes.yml configuration file that includes:\n     - scripts section with common development commands (test, format, check, etc.)\n     - rules section reflecting project conventions and tools\n     - excludeFiles section for sensitive files only\n   - Example structure:\n     ```yaml\n     scripts:\n       test:\n         command: \"[test-command]\"\n         description: \"Run tests\"\n       format:\n         command: \"[format-command]\"\n         description: \"Format code\"\n       check:\n         command: \"[check-command]\"\n         description: \"Check code\"\n\n     rules:\n       - \"[package-manager-rule]\"\n       - \"[testing-framework-rule]\"\n       - \"[code-style-rule]\"\n       - \"[other-rule]\"\n\n     excludeFiles:\n       - \".env\"\n       - \".env.*\"\n     ```\n\n5. **Generate Essential Project Files:**\n   - Create a .gitattributes file with appropriate configurations:\n     - Mark lock files as generated and exclude them from diffs\n     - Example for different package managers:\n\n       # For Bun\n       bun.lock linguist-generated=true\n       bun.lock -diff\n\n       # For npm\n       package-lock.json linguist-generated=true\n       package-lock.json -diff\n\n       # For Yarn\n       yarn.lock linguist-generated=true\n       yarn.lock -diff\n\n       # For pnpm\n       pnpm-lock.yaml linguist-generated=true\n       pnpm-lock.yaml -diff\n\n     - Include other common configurations as needed based on project type\n\n6. **Handover to Coder Agent:**\n   - Once all required information is collected and validated by the user, compile:\n     1. The final project specifications\n     2. The .polkacodes.yml configuration content\n   - Clearly hand over these details to the coder agent, instructing them to:\n     1. Create the new project based on the confirmed specifications\n     2. Include the .polkacodes.yml file in the project root\n     3. Include the .gitattributes file with appropriate configurations\n     4. Ensure all specified tools and configurations are properly set up";
     readonly formatInput: (params: string) => string;
     readonly parseOutput: (output: string) => string;
     readonly agent: "architect";
@@ -1138,6 +735,37 @@ export declare const default_alias_3: {
     readonly agent: "analyzer";
 };
 
+export declare const default_alias_4: {
+    readonly name: "reviewDiff";
+    readonly description: "Reviews a git diff";
+    readonly prompt: "\n# Code Review Prompt\n\nYou are a senior software engineer reviewing code changes.\n\n## Viewing Changes\n- Use **git_diff** to inspect code.\n  - **Pull request**: use the provided commit range.\n  - **Local changes**: diff staged or unstaged files.\n- If a pull request is present you may receive:\n  - <pr_title>\n  - <pr_description>\n  - <commit_messages>\n- A <review_instructions> tag tells you the focus of the review.\n\n## Focus Areas\n- Readability and maintainability\n- Correctness, edge cases, potential bugs\n- Performance implications\n- Clarity of intent\n- Best-practice adherence\n\n## Output Format\nDo **not** include praise or positive feedback. Ignore generated files such as lock files.\n\nReturn your review as a JSON object inside a ```json block, wrapped like:\n<tool_attempt_completion>\n<tool_parameter_result>\n```json\n{\n  \"overview\": \"Summary of overall concerns.\",\n  \"specificReviews\": [\n    {\n      \"file\": \"path/filename.ext\",\n      \"lines\": \"N or N-M\",\n      \"review\": \"Describe the issue and actionable fix or improvement.\"\n    }\n  ]\n}\n```\n</tool_parameter_result>\n</tool_attempt_completion>\n";
+    readonly formatInput: (params: Input_2) => string;
+    readonly parseOutput: (output: string) => Output_2;
+    readonly agent: (options: SharedAgentOptions) => AnalyzerAgent;
+};
+
+export declare const default_alias_5: {
+    handler: ToolHandler<{
+        readonly name: "git_diff";
+        readonly 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.";
+        readonly parameters: z.ZodObject<{
+            staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+            commitRange: z.ZodOptional<z.ZodString>;
+            file: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly permissionLevel: PermissionLevel.Read;
+    }, CommandProvider>;
+    isAvailable: (provider: CommandProvider) => boolean;
+    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: z.ZodObject<{
+        staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        commitRange: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    permissionLevel: PermissionLevel.Read;
+};
+
 /**
  * Returns the directory portion of a path string.
  * Strips trailing slashes, then takes everything up to the last slash.
@@ -1152,10 +780,14 @@ export { EnableCachePolicy as EnableCachePolicy_alias_1 }
 export { EnableCachePolicy as EnableCachePolicy_alias_2 }
 export { EnableCachePolicy as EnableCachePolicy_alias_3 }
 
-declare const executeAgentTool: <T extends AiToolDefinition<any, any>>(definition: T, agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
+declare const executeAgentTool: <T extends AiToolDefinitionWithAgent<any, any>>(definition: T, options: SharedAgentOptions, params: GetInput<T>) => Promise<GetOutput<T>>;
 export { executeAgentTool }
 export { executeAgentTool as executeAgentTool_alias_1 }
 
+declare const executeMultiAgentTool: <T extends AiToolDefinitionWithMultiAgent<any, any>>(definition: T, agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
+export { executeMultiAgentTool }
+export { executeMultiAgentTool as executeMultiAgentTool_alias_1 }
+
 declare const executeTool: <T extends AiToolDefinition<any, any>>(definition: T, ai: LanguageModelV2, params: GetInput<T>, usageMeter: UsageMeter) => Promise<GetOutput<T>>;
 export { executeTool }
 export { executeTool as executeTool_alias_1 }
@@ -1188,28 +820,28 @@ export { FilesystemProvider as FilesystemProvider_alias_2 }
 
 export declare const fullSystemPrompt: (info: {
     os: string;
-}, tools: ToolInfo[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
+}, tools: FullToolInfoV2[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
     command: string;
     description: string;
 }>, useNativeTool: boolean) => string;
 
 export declare const fullSystemPrompt_alias_1: (info: {
     os: string;
-}, tools: ToolInfo[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
+}, tools: FullToolInfoV2[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
     command: string;
     description: string;
 }>, useNativeTool: boolean) => string;
 
 export declare const fullSystemPrompt_alias_2: (info: {
     os: string;
-}, tools: ToolInfo[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
+}, tools: FullToolInfoV2[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
     command: string;
     description: string;
-}>, interactive: boolean, useNativeTool: boolean) => string;
+}>, _interactive: boolean, useNativeTool: boolean) => string;
 
 export declare const fullSystemPrompt_alias_3: (info: {
     os: string;
-}, tools: ToolInfo[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
+}, tools: FullToolInfoV2[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
     command: string;
     description: string;
 }>, useNativeTool: boolean) => string;
@@ -1290,7 +922,7 @@ export declare const getString: <T extends string>(args: Partial<Record<T, strin
 
 export declare const getStringArray: <T extends string>(args: Partial<Record<T, ToolParameterValue>>, name: T, defaultValue?: string[]) => string[];
 
-export declare const handler: ToolHandler<typeof toolInfo, InteractionProvider>;
+export declare const handler: ToolHandler<typeof toolInfo, CommandProvider>;
 
 export declare const handler_alias_1: ToolHandler<typeof toolInfo_alias_1, InteractionProvider>;
 
@@ -1300,15 +932,17 @@ export declare const handler_alias_11: ToolHandler<typeof toolInfo_alias_11, Fil
 
 export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, FilesystemProvider>;
 
-export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, any>;
+export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
 
-export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, CommandProvider>;
+export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, InteractionProvider>;
 
-export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, WebProvider>;
+export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, any>;
 
-export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, any>;
+export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, CommandProvider>;
 
-export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, FilesystemProvider>;
+export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, WebProvider>;
+
+export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, any>;
 
 export declare const handler_alias_7: ToolHandler<typeof toolInfo_alias_7, FilesystemProvider>;
 
@@ -1323,6 +957,14 @@ declare type Input = {
     branchName: string;
 };
 
+declare type Input_2 = {
+    pullRequestTitle?: string;
+    pullRequestDescription?: string;
+    commitMessages?: string;
+    commitRange?: string;
+    staged?: boolean;
+};
+
 declare type InteractionProvider = {
     askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
     attemptCompletion?: (result: string) => Promise<string | undefined>;
@@ -1331,7 +973,7 @@ export { InteractionProvider }
 export { InteractionProvider as InteractionProvider_alias_1 }
 export { InteractionProvider as InteractionProvider_alias_2 }
 
-export declare const isAvailable: (provider: InteractionProvider) => boolean;
+export declare const isAvailable: (provider: CommandProvider) => boolean;
 
 export declare const isAvailable_alias_1: (provider: InteractionProvider) => boolean;
 
@@ -1341,15 +983,17 @@ export declare const isAvailable_alias_11: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_12: (provider: FilesystemProvider) => boolean;
 
-export declare const isAvailable_alias_2: (_provider: any) => boolean;
+export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boolean;
+
+export declare const isAvailable_alias_2: (_provider: InteractionProvider) => boolean;
 
-export declare const isAvailable_alias_3: (provider: CommandProvider) => boolean;
+export declare const isAvailable_alias_3: (_provider: any) => boolean;
 
-export declare const isAvailable_alias_4: (provider: WebProvider) => boolean;
+export declare const isAvailable_alias_4: (provider: CommandProvider) => boolean;
 
-export declare const isAvailable_alias_5: (_provider: any) => boolean;
+export declare const isAvailable_alias_5: (provider: WebProvider) => boolean;
 
-export declare const isAvailable_alias_6: (provider: FilesystemProvider) => boolean;
+export declare const isAvailable_alias_6: (_provider: any) => boolean;
 
 export declare const isAvailable_alias_7: (provider: FilesystemProvider) => boolean;
 
@@ -1362,28 +1006,32 @@ export declare const isAvailable_alias_9: (provider: FilesystemProvider) => bool
  */
 export declare function join(...parts: string[]): string;
 
-declare const makeAgentTool: <T extends AiToolDefinition<any, any>>(definition: T) => (agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
+declare const makeAgentTool: <T extends AiToolDefinitionWithAgent<any, any>>(definition: T) => (options: SharedAgentOptions, params: GetInput<T>) => Promise<GetOutput<T>>;
 export { makeAgentTool }
 export { makeAgentTool as makeAgentTool_alias_1 }
 
+declare const makeMultiAgentTool: <T extends AiToolDefinitionWithMultiAgent<any, any>>(definition: T) => (agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
+export { makeMultiAgentTool }
+export { makeMultiAgentTool as makeMultiAgentTool_alias_1 }
+
 declare const makeTool: <T extends AiToolDefinition<any, any>>(definition: T) => (ai: LanguageModelV2, params: GetInput<T>, usageMeter: UsageMeter) => Promise<GetOutput<T>>;
 export { makeTool }
 export { makeTool as makeTool_alias_1 }
 
 declare class MockProvider implements ToolProvider {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    removeFile(path: string): Promise<void>;
-    renameFile(sourcePath: string, targetPath: string): Promise<void>;
-    listFiles(path: string, recursive: boolean, maxCount: number): Promise<[string[], boolean]>;
-    searchFiles(path: string, regex: string, filePattern: string): Promise<string[]>;
-    executeCommand(command: string, needApprove: boolean): Promise<{
+    readFile(_path: string): Promise<string>;
+    writeFile(_path: string, _content: string): Promise<void>;
+    removeFile(_path: string): Promise<void>;
+    renameFile(_sourcePath: string, _targetPath: string): Promise<void>;
+    listFiles(_path: string, _recursive: boolean, _maxCount: number): Promise<[string[], boolean]>;
+    searchFiles(_path: string, _regex: string, _filePattern: string): Promise<string[]>;
+    executeCommand(_command: string, _needApprove: boolean): Promise<{
         stdout: string;
         stderr: string;
         exitCode: number;
     }>;
-    askFollowupQuestion(question: string, options?: string[]): Promise<string>;
-    attemptCompletion(result: string): Promise<string | undefined>;
+    askFollowupQuestion(_question: string, _options?: string[]): Promise<string>;
+    attemptCompletion(_result: string): Promise<string | undefined>;
 }
 export { MockProvider }
 export { MockProvider as MockProvider_alias_1 }
@@ -1429,6 +1077,11 @@ declare type Output = {
     description: string;
 };
 
+declare type Output_2 = {
+    overview: string;
+    specificReviews: SpecificReview[];
+};
+
 /**
  * Parse an assistant's message into an array of text content and tool use content.
  *
@@ -1528,6 +1181,7 @@ export { ReplaceResult as ReplaceResult_alias_1 }
 declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
     readonly requireUseTool: "Error: No tool use detected. You MUST use a tool before proceeding.\ne.g. <tool_tool_name>tool_name</tool_tool_name>\n\nEnsure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.\nAvoid unnecessary text or symbols before or after the tool use.\nAvoid unnecessary escape characters or special characters.\n";
+    readonly requireUseToolNative: "Error: No tool use detected. You MUST use a tool before proceeding.\n";
     readonly toolResults: (tool: string, result: UserContent_2) => Array<TextPart | ImagePart | FilePart>;
     readonly commandResult: (command: string, exitCode: number, stdout: string, stderr: string) => string;
 };
@@ -1537,6 +1191,23 @@ export { responsePrompts as responsePrompts_alias_2 }
 
 export declare const retryGuidelines = "\n====\n\nRETRY GUIDELINES\n\n1. Before Retrying\n   - Analyze previous attempt's failure\n   - Consider alternative approaches\n   - Check if similar issues were fixed\n   - Verify no new issues were introduced\n\n2. When to Retry\n   - Error message changed but issue persists\n   - New information available about the root cause\n   - Different fixing strategy available\n   - Previous attempt partially successful\n\n3. When to Stop\n   - Maximum retry limit reached\n   - Same error occurs repeatedly\n   - Fix would require major refactoring\n   - Issue requires human intervention\n\n4. After Maximum Retries\n   - Document attempted solutions\n   - Explain why the issue remains\n   - Suggest manual intervention steps\n   - Report any partial improvements";
 
+declare const reviewDiff: (options: SharedAgentOptions, params: {
+    pullRequestTitle?: string;
+    pullRequestDescription?: string;
+    commitMessages?: string;
+    commitRange?: string;
+    staged?: boolean;
+}) => Promise<{
+    overview: string;
+    specificReviews: {
+        file: string;
+        lines: string;
+        review: string;
+    }[];
+}>;
+export { reviewDiff }
+export { reviewDiff as reviewDiff_alias_1 }
+
 export declare const rules: (toolNamePrefix: string) => string;
 
 declare type SharedAgentOptions = {
@@ -1563,6 +1234,12 @@ export { SharedAgentOptions }
 export { SharedAgentOptions as SharedAgentOptions_alias_1 }
 export { SharedAgentOptions as SharedAgentOptions_alias_2 }
 
+declare type SpecificReview = {
+    file: string;
+    lines: string;
+    review: string;
+};
+
 declare const systemInformation: (info: {
     os: string;
 }) => string;
@@ -1646,7 +1323,7 @@ export { TaskEventKind as TaskEventKind_alias_2 }
  */
 declare interface TaskEventStartRequest extends TaskEventBase {
     kind: TaskEventKind.StartRequest;
-    userMessage: UserContent;
+    userMessage: ModelMessage;
 }
 export { TaskEventStartRequest }
 export { TaskEventStartRequest as TaskEventStartRequest_alias_1 }
@@ -1680,6 +1357,7 @@ export { TaskEventText as TaskEventText_alias_2 }
 declare interface TaskEventTool extends TaskEventBase {
     kind: TaskEventKind.ToolUse | TaskEventKind.ToolReply | TaskEventKind.ToolInvalid | TaskEventKind.ToolError | TaskEventKind.ToolInterrupted;
     tool: string;
+    content: any;
 }
 export { TaskEventTool }
 export { TaskEventTool as TaskEventTool_alias_1 }
@@ -1739,10 +1417,7 @@ export { TextContent as TextContent_alias_2 }
 
 declare type ToolExample = {
     description: string;
-    parameters: {
-        name: string;
-        value: ToolParameterValue;
-    }[];
+    input: Record<string, ToolParameterValue>;
 };
 export { ToolExample }
 export { ToolExample as ToolExample_alias_1 }
@@ -1751,7 +1426,7 @@ declare type ToolFormat = 'native' | 'polka-codes';
 export { ToolFormat }
 export { ToolFormat as ToolFormat_alias_1 }
 
-declare type ToolHandler<T, P> = (provider: P, args: Partial<Record<string, ToolParameterValue>>) => Promise<ToolResponse>;
+declare type ToolHandler<_T, P> = (provider: P, args: Partial<Record<string, ToolParameterValue>>) => Promise<ToolResponse>;
 export { ToolHandler }
 export { ToolHandler as ToolHandler_alias_1 }
 
@@ -1766,6 +1441,17 @@ export { ToolInfo }
 export { ToolInfo as ToolInfo_alias_1 }
 
 export declare const toolInfo: {
+    readonly name: "git_diff";
+    readonly 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.";
+    readonly parameters: z.ZodObject<{
+        staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        commitRange: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly permissionLevel: PermissionLevel.Read;
+};
+
+export declare const toolInfo_alias_1: {
     readonly name: "ask_followup_question";
     readonly 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.";
     readonly parameters: z.ZodObject<{
@@ -1774,111 +1460,30 @@ export declare const toolInfo: {
             options: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Single clarifying question (no options)";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "What is the target deployment environment?";
-            };
-        }];
-    }, {
-        readonly description: "Single question with multiple-choice options";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "Which frontend framework are you using?";
-                readonly options: ["React", "Angular", "Vue", "Svelte"];
-            };
-        }];
-    }, {
-        readonly description: "Two related questions in one call";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: [{
-                readonly prompt: "What type of application are you building?";
-            }, {
-                readonly prompt: "Preferred programming language?";
-                readonly options: ["JavaScript", "TypeScript", "Python", "Java"];
-            }];
-        }];
-    }, {
-        readonly description: "Binary (yes/no) confirmation";
-        readonly parameters: [{
-            readonly name: "questions";
-            readonly value: {
-                readonly prompt: "Is it acceptable to refactor existing tests to improve performance?";
-                readonly options: ["Yes", "No"];
-            };
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.None;
 };
 
-export declare const toolInfo_alias_1: {
-    readonly name: "attempt_completion";
-    readonly description: "Use this tool when you believe the user’s requested task is complete. Indicate that your work is finished, but acknowledge the user may still provide additional instructions or questions if they want to continue. This tool MUST NOT to be used with any other tool.";
+export declare const toolInfo_alias_10: {
+    readonly name: "rename_file";
+    readonly description: "Request to rename a file from source path to target path.";
     readonly parameters: z.ZodObject<{
-        result: z.ZodString;
+        source_path: z.ZodString;
+        target_path: z.ZodString;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to present the result of the task";
-        readonly parameters: [{
-            readonly name: "result";
-            readonly value: "Your final result description here";
-        }];
-    }];
-    readonly permissionLevel: PermissionLevel.None;
+    readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_10: {
+export declare const toolInfo_alias_11: {
     readonly name: "replace_in_file";
     readonly 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.";
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
         diff: z.ZodString;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to replace sections of content in a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nimport React from 'react';\n=======\nimport React, { useState } from 'react';\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\n=======\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nreturn (\n  <div>\n=======\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\nreturn (\n  <div>\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to perform a simple, single-line replacement";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/config.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nconst API_URL = 'https://api.example.com';\n=======\nconst API_URL = 'https://api.staging.example.com';\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to add a new function to a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nfunction helperA() {\n  // ...\n}\n=======\nfunction helperA() {\n  // ...\n}\n\nfunction newHelper() {\n  // implementation\n}\n>>>>>>> REPLACE";
-        }];
-    }, {
-        readonly description: "Request to delete a block of code from a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/app.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "<<<<<<< SEARCH\nfunction oldFeature() {\n  // This is no longer needed\n}\n\n=======\n>>>>>>> REPLACE";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_11: {
+export declare const toolInfo_alias_12: {
     readonly name: "search_files";
     readonly 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.";
     readonly parameters: z.ZodObject<{
@@ -1886,43 +1491,29 @@ export declare const toolInfo_alias_11: {
         regex: z.ZodString;
         filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to perform a regex search across files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "regex";
-            readonly value: "^components/";
-        }, {
-            readonly name: "filePattern";
-            readonly value: "*.ts,*.tsx";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_12: {
+export declare const toolInfo_alias_13: {
     readonly name: "write_to_file";
     readonly 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.";
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
         content: z.ZodString;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to write content to a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }, {
-            readonly name: "content";
-            readonly value: "import React from 'react';\n\nfunction App() {\n  return (\n    <div>\n      <h1>Hello, World!</h1>\n    </div>\n  );\n}\n\nexport default App;\n";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Write;
 };
 
 export declare const toolInfo_alias_2: {
+    readonly name: "attempt_completion";
+    readonly description: "Use this tool when you believe the user’s requested task is complete. Indicate that your work is finished, but acknowledge the user may still provide additional instructions or questions if they want to continue. This tool MUST NOT to be used with any other tool.";
+    readonly parameters: z.ZodObject<{
+        result: z.ZodString;
+    }, z.core.$strip>;
+    readonly permissionLevel: PermissionLevel.None;
+};
+
+export declare const toolInfo_alias_3: {
     readonly name: "delegate";
     readonly description: "Temporarily delegate a task to another agent and receive the result back. This tool MUST NOT to be used with any other tool.";
     readonly parameters: z.ZodObject<{
@@ -1931,74 +1522,29 @@ export declare const toolInfo_alias_2: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Delegate a code analysis task to the analyzer agent";
-        readonly parameters: [{
-            readonly name: "agentName";
-            readonly value: "analyzer";
-        }, {
-            readonly name: "task";
-            readonly value: "Analyze the authentication implementation";
-        }, {
-            readonly name: "context";
-            readonly value: "Need to understand the security implications of the current auth system";
-        }, {
-            readonly name: "files";
-            readonly value: "src/auth/login.ts,src/auth/types.ts";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.None;
 };
 
-export declare const toolInfo_alias_3: {
+export declare const toolInfo_alias_4: {
     readonly name: "execute_command";
     readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
     readonly parameters: z.ZodObject<{
         command: z.ZodString;
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Make a build";
-        readonly parameters: [{
-            readonly name: "command";
-            readonly value: "npm run build";
-        }, {
-            readonly name: "requiresApproval";
-            readonly value: "false";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Arbitrary;
 };
 
-export declare const toolInfo_alias_4: {
+export declare const toolInfo_alias_5: {
     readonly name: "fetch_url";
     readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
     readonly parameters: z.ZodObject<{
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Fetch a single webpage";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://example.com";
-        }];
-    }, {
-        readonly description: "Fetch multiple webpages";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP";
-        }];
-    }, {
-        readonly description: "Fetch a raw file from GitHub";
-        readonly parameters: [{
-            readonly name: "url";
-            readonly value: "https://raw.githubusercontent.com/user/repo/main/README.md";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_5: {
+export declare const toolInfo_alias_6: {
     readonly name: "hand_over";
     readonly description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.";
     readonly parameters: z.ZodObject<{
@@ -2007,26 +1553,10 @@ export declare const toolInfo_alias_5: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Hand over a coding task to the coder agent";
-        readonly parameters: [{
-            readonly name: "agentName";
-            readonly value: "coder";
-        }, {
-            readonly name: "task";
-            readonly value: "Implement the login feature";
-        }, {
-            readonly name: "context";
-            readonly value: "We need a secure login system with email and password";
-        }, {
-            readonly name: "files";
-            readonly value: "src/auth/login.ts,src/auth/types.ts";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.None;
 };
 
-export declare const toolInfo_alias_6: {
+export declare const toolInfo_alias_7: {
     readonly name: "list_files";
     readonly 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.";
     readonly parameters: z.ZodObject<{
@@ -2034,74 +1564,24 @@ export declare const toolInfo_alias_6: {
         maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to list files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "maxCount";
-            readonly value: "100";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_7: {
+export declare const toolInfo_alias_8: {
     readonly name: "read_file";
     readonly 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.";
     readonly parameters: z.ZodObject<{
         path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to read the contents of a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }];
-    }, {
-        readonly description: "Request to read multiple files";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js,src/index.js";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_8: {
+export declare const toolInfo_alias_9: {
     readonly name: "remove_file";
     readonly description: "Request to remove a file at the specified path.";
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
     }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to remove a file";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/main.js";
-        }];
-    }];
-    readonly permissionLevel: PermissionLevel.Write;
-};
-
-export declare const toolInfo_alias_9: {
-    readonly name: "rename_file";
-    readonly description: "Request to rename a file from source path to target path.";
-    readonly parameters: z.ZodObject<{
-        source_path: z.ZodString;
-        target_path: z.ZodString;
-    }, z.core.$strip>;
-    readonly examples: [{
-        readonly description: "Request to rename a file";
-        readonly parameters: [{
-            readonly name: "source_path";
-            readonly value: "src/old-name.js";
-        }, {
-            readonly name: "target_path";
-            readonly value: "src/new-name.js";
-        }];
-    }];
     readonly permissionLevel: PermissionLevel.Write;
 };
 
@@ -2109,7 +1589,6 @@ declare type ToolInfoV2 = {
     name: string;
     description: string;
     parameters: z.ZodObject<any>;
-    examples?: ToolExample[];
     permissionLevel: PermissionLevel;
 };
 export { ToolInfoV2 }
@@ -2195,10 +1674,12 @@ declare type ToolResponseOrToolPause = {
     type: 'response';
     tool: string;
     response: UserContent;
+    id?: string;
 } | {
     type: 'pause';
     tool: string;
     object: any;
+    id?: string;
 };
 export { ToolResponseOrToolPause }
 export { ToolResponseOrToolPause as ToolResponseOrToolPause_alias_1 }
@@ -2232,6 +1713,7 @@ export { ToolResponseType }
 export { ToolResponseType as ToolResponseType_alias_1 }
 
 declare interface ToolUse {
+    id?: string;
     type: 'tool_use';
     name: string;
     params: Record<string, any>;
@@ -2240,7 +1722,7 @@ export { ToolUse }
 export { ToolUse as ToolUse_alias_1 }
 export { ToolUse as ToolUse_alias_2 }
 
-declare const toolUsePrompt: (tools: ToolInfo[], toolNamePrefix: string) => string;
+declare const toolUsePrompt: (tools: FullToolInfoV2[], toolNamePrefix: string) => string;
 export { toolUsePrompt }
 export { toolUsePrompt as toolUsePrompt_alias_1 }
 export { toolUsePrompt as toolUsePrompt_alias_2 }
@@ -2288,6 +1770,8 @@ declare class UsageMeter {
     }>): void;
     /** Manually bump the message count (useful if you record some calls without token info). */
     incrementMessageCount(n?: number): void;
+    /** Reset the running totals. */
+    resetUsage(): void;
     /** Return true once either messages or cost exceed the configured caps. */
     isLimitExceeded(): {
         messageCount: boolean;