@polka-codes/core 0.8.10 → 0.8.12

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

@@ -8,6 +8,7 @@ declare abstract class AgentBase {
     protected readonly config: Readonly<AgentBaseConfig>;
     protected readonly handlers: Record<string, FullToolInfo>;
     constructor(name: string, ai: AiServiceBase, config: AgentBaseConfig);
+    get parameters(): Readonly<any>;
     get messages(): Readonly<MessageParam[]>;
     setMessages(messages: Readonly<MessageParam[]>): void;
     start(prompt: string): Promise<ExitReason>;
@@ -80,6 +81,7 @@ declare type AgentPolicyInstance = {
     prompt?: string;
     updateResponse?: (response: AssistantMessageContent[]) => Promise<AssistantMessageContent[]>;
     onBeforeInvokeTool?: (name: string, args: Record<string, string>) => Promise<ToolResponse | undefined>;
+    onBeforeRequest?: (agent: AgentBase) => Promise<void>;
 };
 export { AgentPolicyInstance }
 export { AgentPolicyInstance as AgentPolicyInstance_alias_1 }
@@ -92,7 +94,8 @@ export { agentsPrompt as agentsPrompt_alias_2 }
 
 declare abstract class AiServiceBase {
     readonly usageMeter: UsageMeter;
-    constructor(usageMeter: UsageMeter);
+    readonly options: AiServiceOptions;
+    constructor(options: AiServiceOptions);
     abstract get model(): {
         provider: string;
         id: string;
@@ -161,20 +164,19 @@ export { allAgents as allAgents_alias_1 }
 
 export declare namespace allTools {
     export {
-        _default as askFollowupQuestion,
-        _default_2 as attemptCompletion,
-        _default_3 as delegate,
-        _default_4 as executeCommand,
-        _default_5 as listCodeDefinitionNames,
+        _default_2 as askFollowupQuestion,
+        _default_3 as attemptCompletion,
+        _default_4 as delegate,
+        _default_5 as executeCommand,
         _default_6 as listFiles,
         _default_7 as readFile,
-        _default_8 as replaceInFile,
-        _default_9 as searchFiles,
-        _default_10 as updateKnowledge,
-        _default_11 as writeToFile,
-        _default_12 as handOver,
-        _default_13 as removeFile,
-        _default_14 as renameFile
+        _default_8 as searchFiles,
+        _default_9 as updateKnowledge,
+        _default_10 as writeToFile,
+        _default_11 as handOver,
+        _default_12 as removeFile,
+        _default_13 as renameFile,
+        _default_14 as editFile
     }
 }
 
@@ -773,265 +775,62 @@ export declare class DeepSeekService extends AiServiceBase {
 
 declare const _default: {
     handler: ToolHandler<{
-        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: [{
-            readonly name: "questions";
-            readonly description: "One or more follow-up questions you need answered before you can continue.";
-            readonly required: true;
-            readonly allowMultiple: true;
-            readonly usageValue: "questions here";
-            readonly children: [{
-                readonly name: "prompt";
-                readonly description: "The text of the question.";
-                readonly required: true;
-                readonly usageValue: "question text here";
-            }, {
-                readonly name: "options";
-                readonly description: "Ordered list of suggested answers (omit if none).";
-                readonly required: false;
-                readonly allowMultiple: true;
-                readonly usageValue: "suggested answer here";
-            }];
-        }];
-        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;
-    name: "ask_followup_question";
-    description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
-    parameters: [{
-        readonly name: "questions";
-        readonly description: "One or more follow-up questions you need answered before you can continue.";
-        readonly required: true;
-        readonly allowMultiple: true;
-        readonly usageValue: "questions here";
-        readonly children: [{
-            readonly name: "prompt";
-            readonly description: "The text of the question.";
-            readonly required: true;
-            readonly usageValue: "question text here";
-        }, {
-            readonly name: "options";
-            readonly description: "Ordered list of suggested answers (omit if none).";
-            readonly required: false;
-            readonly allowMultiple: true;
-            readonly usageValue: "suggested answer here";
-        }];
-    }];
-    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 }
-
-declare const _default_10: {
-    handler: ToolHandler<{
-        readonly name: "update_knowledge";
-        readonly description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+        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: [{
             readonly name: "path";
-            readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+            readonly description: "The path of the file to modify";
             readonly required: true;
-            readonly usageValue: "Directory path here";
+            readonly usageValue: "File path here";
         }, {
-            readonly name: "knowledge";
-            readonly description: "YAML content to merge into the knowledge file";
+            readonly name: "diff";
+            readonly description: "One or more SEARCH/REPLACE blocks following this exact format:\n  ```\n  <<<<<<< SEARCH\n  [exact content to find]\n  =======\n  [new content to replace with]\n  >>>>>>> REPLACE\n  ```\n  Critical rules:\n  1. SEARCH content must match the associated file section to find EXACTLY:\n     * Match character-for-character including whitespace, indentation, line endings\n     * Include all comments, docstrings, etc.\n  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.\n     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.\n     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.\n     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.\n  3. Keep SEARCH/REPLACE blocks concise:\n     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.\n     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.\n     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.\n     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.\n  4. Special operations:\n     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)\n     * To delete code: Use empty REPLACE section";
             readonly required: true;
-            readonly usageValue: "YAML content with knowledge to update";
+            readonly usageValue: "Search and replace blocks here";
         }];
         readonly examples: [{
-            readonly description: "Add a new file entry";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/utils";
-            }, {
-                readonly name: "knowledge";
-                readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
-            }];
-        }, {
-            readonly description: "Update an existing file description";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/utils";
-            }, {
-                readonly name: "knowledge";
-                readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
-            }];
-        }, {
-            readonly description: "Add a new rule";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src";
-            }, {
-                readonly name: "knowledge";
-                readonly value: "rules:\n    10: \"New rule to follow\"";
-            }];
-        }, {
-            readonly description: "Remove a rule";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src";
-            }, {
-                readonly name: "knowledge";
-                readonly value: "rules:\n    5: null";
-            }];
-        }, {
-            readonly description: "Update nested properties using dot notation";
+            readonly description: "Request to replace sections of content in a file";
             readonly parameters: [{
                 readonly name: "path";
-                readonly value: "src/components";
+                readonly value: "src/main.js";
             }, {
-                readonly name: "knowledge";
-                readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+                readonly name: "diff";
+                readonly value: "\n<<<<<<< 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\n";
             }];
         }];
         readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    name: "update_knowledge";
-    description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+    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: [{
         readonly name: "path";
-        readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+        readonly description: "The path of the file to modify";
         readonly required: true;
-        readonly usageValue: "Directory path here";
+        readonly usageValue: "File path here";
     }, {
-        readonly name: "knowledge";
-        readonly description: "YAML content to merge into the knowledge file";
+        readonly name: "diff";
+        readonly description: "One or more SEARCH/REPLACE blocks following this exact format:\n  ```\n  <<<<<<< SEARCH\n  [exact content to find]\n  =======\n  [new content to replace with]\n  >>>>>>> REPLACE\n  ```\n  Critical rules:\n  1. SEARCH content must match the associated file section to find EXACTLY:\n     * Match character-for-character including whitespace, indentation, line endings\n     * Include all comments, docstrings, etc.\n  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.\n     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.\n     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.\n     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.\n  3. Keep SEARCH/REPLACE blocks concise:\n     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.\n     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.\n     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.\n     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.\n  4. Special operations:\n     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)\n     * To delete code: Use empty REPLACE section";
         readonly required: true;
-        readonly usageValue: "YAML content with knowledge to update";
+        readonly usageValue: "Search and replace blocks here";
     }];
     examples: [{
-        readonly description: "Add a new file entry";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils";
-        }, {
-            readonly name: "knowledge";
-            readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
-        }];
-    }, {
-        readonly description: "Update an existing file description";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils";
-        }, {
-            readonly name: "knowledge";
-            readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
-        }];
-    }, {
-        readonly description: "Add a new rule";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "knowledge";
-            readonly value: "rules:\n    10: \"New rule to follow\"";
-        }];
-    }, {
-        readonly description: "Remove a rule";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src";
-        }, {
-            readonly name: "knowledge";
-            readonly value: "rules:\n    5: null";
-        }];
-    }, {
-        readonly description: "Update nested properties using dot notation";
+        readonly description: "Request to replace sections of content in a file";
         readonly parameters: [{
             readonly name: "path";
-            readonly value: "src/components";
+            readonly value: "src/main.js";
         }, {
-            readonly name: "knowledge";
-            readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+            readonly name: "diff";
+            readonly value: "\n<<<<<<< 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\n";
         }];
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_10 as default_alias_16 }
-export { _default_10 as updateKnowledge }
-export { _default_10 as updateKnowledge_alias_1 }
-export { _default_10 as updateKnowledge_alias_2 }
+export { _default as default_alias_14 }
+export { _default as replaceInFile }
+export { _default as replaceInFile_alias_1 }
 
-declare const _default_11: {
+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;` and `&gt;`.";
@@ -1084,12 +883,12 @@ declare const _default_11: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_11 as default_alias_17 }
-export { _default_11 as writeToFile }
-export { _default_11 as writeToFile_alias_1 }
-export { _default_11 as writeToFile_alias_2 }
+export { _default_10 as default_alias_17 }
+export { _default_10 as writeToFile }
+export { _default_10 as writeToFile_alias_1 }
+export { _default_10 as writeToFile_alias_2 }
 
-declare const _default_12: {
+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.";
@@ -1174,12 +973,12 @@ declare const _default_12: {
     }];
     permissionLevel: PermissionLevel.None;
 };
-export { _default_12 as default_alias_8 }
-export { _default_12 as handOver }
-export { _default_12 as handOver_alias_1 }
-export { _default_12 as handOver_alias_2 }
+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 }
 
-declare const _default_13: {
+declare const _default_12: {
     handler: ToolHandler<{
         readonly name: "remove_file";
         readonly description: "Request to remove a file at the specified path.";
@@ -1216,22 +1015,22 @@ declare const _default_13: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_13 as default_alias_12 }
-export { _default_13 as removeFile }
-export { _default_13 as removeFile_alias_1 }
-export { _default_13 as removeFile_alias_2 }
+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 }
 
-declare const _default_14: {
+declare const _default_13: {
     handler: ToolHandler<{
         readonly name: "rename_file";
         readonly description: "Request to rename a file from source path to target path.";
         readonly parameters: [{
-            readonly name: "sourcePath";
+            readonly name: "source_path";
             readonly description: "The current path of the file";
             readonly required: true;
             readonly usageValue: "Source file path here";
         }, {
-            readonly name: "targetPath";
+            readonly name: "target_path";
             readonly description: "The new path for the file";
             readonly required: true;
             readonly usageValue: "Target file path here";
@@ -1239,10 +1038,10 @@ declare const _default_14: {
         readonly examples: [{
             readonly description: "Request to rename a file";
             readonly parameters: [{
-                readonly name: "sourcePath";
+                readonly name: "source_path";
                 readonly value: "src/old-name.js";
             }, {
-                readonly name: "targetPath";
+                readonly name: "target_path";
                 readonly value: "src/new-name.js";
             }];
         }];
@@ -1252,12 +1051,12 @@ declare const _default_14: {
     name: "rename_file";
     description: "Request to rename a file from source path to target path.";
     parameters: [{
-        readonly name: "sourcePath";
+        readonly name: "source_path";
         readonly description: "The current path of the file";
         readonly required: true;
         readonly usageValue: "Source file path here";
     }, {
-        readonly name: "targetPath";
+        readonly name: "target_path";
         readonly description: "The new path for the file";
         readonly required: true;
         readonly usageValue: "Target file path here";
@@ -1265,21 +1064,331 @@ declare const _default_14: {
     examples: [{
         readonly description: "Request to rename a file";
         readonly parameters: [{
-            readonly name: "sourcePath";
+            readonly name: "source_path";
             readonly value: "src/old-name.js";
         }, {
-            readonly name: "targetPath";
+            readonly name: "target_path";
             readonly value: "src/new-name.js";
         }];
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_14 as default_alias_13 }
-export { _default_14 as renameFile }
-export { _default_14 as renameFile_alias_1 }
-export { _default_14 as renameFile_alias_2 }
+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 }
+
+declare const _default_14: {
+    handler: ToolHandler<{
+        readonly name: "edit_file";
+        readonly description: "Request to edit file contents using before/after text anchors with flexible operations. Supports multiple edit operations in a single call.";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly description: "The path of the file to edit";
+            readonly required: true;
+            readonly usageValue: "File path here";
+        }, {
+            readonly name: "operations";
+            readonly description: "Edit operation with before_text, after_text, new_text, and optional line range hints";
+            readonly required: true;
+            readonly allowMultiple: true;
+            readonly children: [{
+                readonly name: "before_text";
+                readonly description: "Text to find as the start anchor (use <<<START_OF_FILE>>> for file start)";
+                readonly required: false;
+                readonly usageValue: "Text before the edit location";
+            }, {
+                readonly name: "after_text";
+                readonly description: "Text to find as the end anchor (use <<<END_OF_FILE>>> for file end)";
+                readonly required: false;
+                readonly usageValue: "Text after the edit location";
+            }, {
+                readonly name: "new_text";
+                readonly description: "Text to replace the content between before_text and after_text";
+                readonly required: true;
+                readonly usageValue: "New text content";
+            }, {
+                readonly name: "before_text_line_start";
+                readonly description: "Optional line number hint for before_text location (1-based)";
+                readonly required: false;
+                readonly usageValue: "10";
+            }, {
+                readonly name: "after_text_line_start";
+                readonly description: "Optional line number hint for after_text location (1-based)";
+                readonly required: false;
+                readonly usageValue: "20";
+            }];
+            readonly usageValue: "operations here";
+        }];
+        readonly examples: [{
+            readonly description: "Replace content between two text anchors";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/main.ts";
+            }, {
+                readonly name: "operations";
+                readonly value: {
+                    readonly before_text: "function oldFunction() {";
+                    readonly after_text: "}";
+                    readonly new_text: "\n  return \"new implementation\";\n";
+                };
+            }];
+        }, {
+            readonly description: "Insert at start of file";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/header.ts";
+            }, {
+                readonly name: "operations";
+                readonly value: {
+                    readonly before_text: "<<<START_OF_FILE>>>";
+                    readonly after_text: "export";
+                    readonly new_text: "// File header comment\n";
+                };
+            }];
+        }, {
+            readonly description: "Multiple operations in one call";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/utils.ts";
+            }, {
+                readonly name: "operations";
+                readonly value: [{
+                    readonly before_text: "import React";
+                    readonly after_text: "from \"react\"";
+                    readonly new_text: ", { useState }";
+                }, {
+                    readonly before_text: "function Component() {";
+                    readonly after_text: "return (";
+                    readonly new_text: "\n  const [state, setState] = useState(false);\n  ";
+                }];
+            }];
+        }];
+        readonly permissionLevel: PermissionLevel.Write;
+    }, FilesystemProvider>;
+    isAvailable: (provider: FilesystemProvider) => boolean;
+    name: "edit_file";
+    description: "Request to edit file contents using before/after text anchors with flexible operations. Supports multiple edit operations in a single call.";
+    parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the file to edit";
+        readonly required: true;
+        readonly usageValue: "File path here";
+    }, {
+        readonly name: "operations";
+        readonly description: "Edit operation with before_text, after_text, new_text, and optional line range hints";
+        readonly required: true;
+        readonly allowMultiple: true;
+        readonly children: [{
+            readonly name: "before_text";
+            readonly description: "Text to find as the start anchor (use <<<START_OF_FILE>>> for file start)";
+            readonly required: false;
+            readonly usageValue: "Text before the edit location";
+        }, {
+            readonly name: "after_text";
+            readonly description: "Text to find as the end anchor (use <<<END_OF_FILE>>> for file end)";
+            readonly required: false;
+            readonly usageValue: "Text after the edit location";
+        }, {
+            readonly name: "new_text";
+            readonly description: "Text to replace the content between before_text and after_text";
+            readonly required: true;
+            readonly usageValue: "New text content";
+        }, {
+            readonly name: "before_text_line_start";
+            readonly description: "Optional line number hint for before_text location (1-based)";
+            readonly required: false;
+            readonly usageValue: "10";
+        }, {
+            readonly name: "after_text_line_start";
+            readonly description: "Optional line number hint for after_text location (1-based)";
+            readonly required: false;
+            readonly usageValue: "20";
+        }];
+        readonly usageValue: "operations here";
+    }];
+    examples: [{
+        readonly description: "Replace content between two text anchors";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: {
+                readonly before_text: "function oldFunction() {";
+                readonly after_text: "}";
+                readonly new_text: "\n  return \"new implementation\";\n";
+            };
+        }];
+    }, {
+        readonly description: "Insert at start of file";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/header.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: {
+                readonly before_text: "<<<START_OF_FILE>>>";
+                readonly after_text: "export";
+                readonly new_text: "// File header comment\n";
+            };
+        }];
+    }, {
+        readonly description: "Multiple operations in one call";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: [{
+                readonly before_text: "import React";
+                readonly after_text: "from \"react\"";
+                readonly new_text: ", { useState }";
+            }, {
+                readonly before_text: "function Component() {";
+                readonly after_text: "return (";
+                readonly new_text: "\n  const [state, setState] = useState(false);\n  ";
+            }];
+        }];
+    }];
+    permissionLevel: PermissionLevel.Write;
+};
+export { _default_14 as default_alias_7 }
+export { _default_14 as editFile }
+export { _default_14 as editFile_alias_1 }
+export { _default_14 as editFile_alias_2 }
 
 declare const _default_2: {
+    handler: ToolHandler<{
+        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: [{
+            readonly name: "questions";
+            readonly description: "One or more follow-up questions you need answered before you can continue.";
+            readonly required: true;
+            readonly allowMultiple: true;
+            readonly usageValue: "questions here";
+            readonly children: [{
+                readonly name: "prompt";
+                readonly description: "The text of the question.";
+                readonly required: true;
+                readonly usageValue: "question text here";
+            }, {
+                readonly name: "options";
+                readonly description: "Ordered list of suggested answers (omit if none).";
+                readonly required: false;
+                readonly allowMultiple: true;
+                readonly usageValue: "suggested answer here";
+            }];
+        }];
+        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;
+    name: "ask_followup_question";
+    description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
+    parameters: [{
+        readonly name: "questions";
+        readonly description: "One or more follow-up questions you need answered before you can continue.";
+        readonly required: true;
+        readonly allowMultiple: true;
+        readonly usageValue: "questions here";
+        readonly children: [{
+            readonly name: "prompt";
+            readonly description: "The text of the question.";
+            readonly required: true;
+            readonly usageValue: "question text here";
+        }, {
+            readonly name: "options";
+            readonly description: "Ordered list of suggested answers (omit if none).";
+            readonly required: false;
+            readonly allowMultiple: true;
+            readonly usageValue: "suggested answer here";
+        }];
+    }];
+    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_2 as askFollowupQuestion }
+export { _default_2 as askFollowupQuestion_alias_1 }
+export { _default_2 as askFollowupQuestion_alias_2 }
+export { _default_2 as default_alias_4 }
+
+declare const _default_3: {
     handler: ToolHandler<{
         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.";
@@ -1316,12 +1425,12 @@ declare const _default_2: {
     }];
     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_3 as attemptCompletion }
+export { _default_3 as attemptCompletion_alias_1 }
+export { _default_3 as attemptCompletion_alias_2 }
+export { _default_3 as default_alias_5 }
 
-declare const _default_3: {
+declare const _default_4: {
     handler: ToolHandler<{
         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.";
@@ -1406,12 +1515,12 @@ declare const _default_3: {
     }];
     permissionLevel: PermissionLevel.None;
 };
-export { _default_3 as default_alias_6 }
-export { _default_3 as delegate }
-export { _default_3 as delegate_alias_1 }
-export { _default_3 as delegate_alias_2 }
+export { _default_4 as default_alias_6 }
+export { _default_4 as delegate }
+export { _default_4 as delegate_alias_1 }
+export { _default_4 as delegate_alias_2 }
 
-declare const _default_4: {
+declare const _default_5: {
     handler: ToolHandler<{
         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. After an `execute_command` call, no other tool calls are allowed in the same assistant response.";
@@ -1459,57 +1568,15 @@ declare const _default_4: {
             readonly value: "npm run build";
         }, {
             readonly name: "requires_approval";
-            readonly value: "false";
-        }];
-    }];
-    permissionLevel: PermissionLevel.Arbitrary;
-};
-export { _default_4 as default_alias_7 }
-export { _default_4 as executeCommand }
-export { _default_4 as executeCommand_alias_1 }
-export { _default_4 as executeCommand_alias_2 }
-
-declare const _default_5: {
-    handler: ToolHandler<{
-        readonly name: "list_code_definition_names";
-        readonly description: "Request to list definition names (classes, functions, methods, etc.) used for all files in a directory. This tool provides insights into the codebase structure and important constructs, encapsulating high-level concepts and relationships that are crucial for understanding the overall architecture.";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly description: "The path of a code file to list top level source code definitions for.";
-            readonly required: true;
-            readonly usageValue: "Directory path here";
-        }];
-        readonly examples: [{
-            readonly description: "Request to list code definition names in a directory";
-            readonly parameters: [{
-                readonly name: "path";
-                readonly value: "src/utils";
-            }];
-        }];
-        readonly permissionLevel: PermissionLevel.Read;
-    }, FilesystemProvider>;
-    isAvailable: (provider: FilesystemProvider) => boolean;
-    name: "list_code_definition_names";
-    description: "Request to list definition names (classes, functions, methods, etc.) used for all files in a directory. This tool provides insights into the codebase structure and important constructs, encapsulating high-level concepts and relationships that are crucial for understanding the overall architecture.";
-    parameters: [{
-        readonly name: "path";
-        readonly description: "The path of a code file to list top level source code definitions for.";
-        readonly required: true;
-        readonly usageValue: "Directory path here";
-    }];
-    examples: [{
-        readonly description: "Request to list code definition names in a directory";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils";
+            readonly value: "false";
         }];
     }];
-    permissionLevel: PermissionLevel.Read;
+    permissionLevel: PermissionLevel.Arbitrary;
 };
-export { _default_5 as default_alias_9 }
-export { _default_5 as listCodeDefinitionNames }
-export { _default_5 as listCodeDefinitionNames_alias_1 }
-export { _default_5 as listCodeDefinitionNames_alias_2 }
+export { _default_5 as default_alias_8 }
+export { _default_5 as executeCommand }
+export { _default_5 as executeCommand_alias_1 }
+export { _default_5 as executeCommand_alias_2 }
 
 declare const _default_6: {
     handler: ToolHandler<{
@@ -1634,64 +1701,6 @@ export { _default_7 as readFile_alias_1 }
 export { _default_7 as readFile_alias_2 }
 
 declare const _default_8: {
-    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 parameters: [{
-            readonly name: "path";
-            readonly description: "The path of the file to modify";
-            readonly required: true;
-            readonly usageValue: "File path here";
-        }, {
-            readonly name: "diff";
-            readonly description: "One or more SEARCH/REPLACE blocks following this exact format:\n  ```\n  <<<<<<< SEARCH\n  [exact content to find]\n  =======\n  [new content to replace with]\n  >>>>>>> REPLACE\n  ```\n  Critical rules:\n  1. SEARCH content must match the associated file section to find EXACTLY:\n     * Match character-for-character including whitespace, indentation, line endings\n     * Include all comments, docstrings, etc.\n  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.\n     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.\n     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.\n     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.\n  3. Keep SEARCH/REPLACE blocks concise:\n     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.\n     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.\n     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.\n     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.\n  4. Special operations:\n     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)\n     * To delete code: Use empty REPLACE section";
-            readonly required: true;
-            readonly usageValue: "Search and replace blocks here";
-        }];
-        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: "\n<<<<<<< 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\n";
-            }];
-        }];
-        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: [{
-        readonly name: "path";
-        readonly description: "The path of the file to modify";
-        readonly required: true;
-        readonly usageValue: "File path here";
-    }, {
-        readonly name: "diff";
-        readonly description: "One or more SEARCH/REPLACE blocks following this exact format:\n  ```\n  <<<<<<< SEARCH\n  [exact content to find]\n  =======\n  [new content to replace with]\n  >>>>>>> REPLACE\n  ```\n  Critical rules:\n  1. SEARCH content must match the associated file section to find EXACTLY:\n     * Match character-for-character including whitespace, indentation, line endings\n     * Include all comments, docstrings, etc.\n  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.\n     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.\n     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.\n     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.\n  3. Keep SEARCH/REPLACE blocks concise:\n     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.\n     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.\n     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.\n     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.\n  4. Special operations:\n     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)\n     * To delete code: Use empty REPLACE section";
-        readonly required: true;
-        readonly usageValue: "Search and replace blocks here";
-    }];
-    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: "\n<<<<<<< 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\n";
-        }];
-    }];
-    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.";
@@ -1760,10 +1769,140 @@ declare const _default_9: {
     }];
     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_8 as default_alias_15 }
+export { _default_8 as searchFiles }
+export { _default_8 as searchFiles_alias_1 }
+export { _default_8 as searchFiles_alias_2 }
+
+declare const _default_9: {
+    handler: ToolHandler<{
+        readonly name: "update_knowledge";
+        readonly description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+            readonly required: true;
+            readonly usageValue: "Directory path here";
+        }, {
+            readonly name: "knowledge";
+            readonly description: "YAML content to merge into the knowledge file";
+            readonly required: true;
+            readonly usageValue: "YAML content with knowledge to update";
+        }];
+        readonly examples: [{
+            readonly description: "Add a new file entry";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/utils";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
+            }];
+        }, {
+            readonly description: "Update an existing file description";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/utils";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
+            }];
+        }, {
+            readonly description: "Add a new rule";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "rules:\n    10: \"New rule to follow\"";
+            }];
+        }, {
+            readonly description: "Remove a rule";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "rules:\n    5: null";
+            }];
+        }, {
+            readonly description: "Update nested properties using dot notation";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/components";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+            }];
+        }];
+        readonly permissionLevel: PermissionLevel.Write;
+    }, FilesystemProvider>;
+    isAvailable: (provider: FilesystemProvider) => boolean;
+    name: "update_knowledge";
+    description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+    parameters: [{
+        readonly name: "path";
+        readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }, {
+        readonly name: "knowledge";
+        readonly description: "YAML content to merge into the knowledge file";
+        readonly required: true;
+        readonly usageValue: "YAML content with knowledge to update";
+    }];
+    examples: [{
+        readonly description: "Add a new file entry";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
+        }];
+    }, {
+        readonly description: "Update an existing file description";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
+        }];
+    }, {
+        readonly description: "Add a new rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    10: \"New rule to follow\"";
+        }];
+    }, {
+        readonly description: "Remove a rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    5: null";
+        }];
+    }, {
+        readonly description: "Update nested properties using dot notation";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/components";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+        }];
+    }];
+    permissionLevel: PermissionLevel.Write;
+};
+export { _default_9 as default_alias_16 }
+export { _default_9 as updateKnowledge }
+export { _default_9 as updateKnowledge_alias_1 }
+export { _default_9 as updateKnowledge_alias_2 }
 
 /**
  * AI tool for creating new projects based on user specifications.
@@ -1819,8 +1958,33 @@ declare const defaultModels: {
 export { defaultModels }
 export { defaultModels as defaultModels_alias_1 }
 
+/**
+ * Apply multiple edit operations to file content using before/after text anchors
+ * @param fileContent - The original file content
+ * @param operations - Array of edit operations to apply
+ * @returns The modified file content
+ */
+declare const editFile_2: (fileContent: string, operations: EditOperation[]) => Promise<string>;
+export { editFile_2 as editFileHelper }
+export { editFile_2 as editFile_alias_3 }
+export { editFile_2 as editFile_alias_4 }
+
 export declare const editingFilesPrompt: (toolNamePrefix: string) => string;
 
+declare interface EditOperation {
+    before_text?: string;
+    after_text?: string;
+    new_text: string;
+    before_text_line_start?: number;
+    after_text_line_start?: number;
+}
+export { EditOperation }
+export { EditOperation as EditOperation_alias_1 }
+
+declare const END_OF_FILE = "<<<END_OF_FILE>>>";
+export { END_OF_FILE }
+export { END_OF_FILE as END_OF_FILE_alias_1 }
+
 declare const executeAgentTool: <T extends AiToolDefinition<any, any>>(definition: T, agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
 export { executeAgentTool }
 export { executeAgentTool as executeAgentTool_alias_1 }
@@ -1851,7 +2015,6 @@ declare type FilesystemProvider = {
     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[]>;
-    listCodeDefinitionNames?: (path: string) => Promise<string>;
 };
 export { FilesystemProvider }
 export { FilesystemProvider as FilesystemProvider_alias_1 }
@@ -1989,11 +2152,11 @@ export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, Fil
 
 export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, any>;
 
-export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, CommandProvider>;
+export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, FilesystemProvider>;
 
-export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, any>;
+export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, CommandProvider>;
 
-export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, FilesystemProvider>;
+export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, any>;
 
 export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, FilesystemProvider>;
 
@@ -2032,11 +2195,11 @@ export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_2: (_provider: any) => boolean;
 
-export declare const isAvailable_alias_3: (provider: CommandProvider) => boolean;
+export declare const isAvailable_alias_3: (provider: FilesystemProvider) => boolean;
 
-export declare const isAvailable_alias_4: (_provider: any) => boolean;
+export declare const isAvailable_alias_4: (provider: CommandProvider) => boolean;
 
-export declare const isAvailable_alias_5: (provider: FilesystemProvider) => boolean;
+export declare const isAvailable_alias_5: (_provider: any) => boolean;
 
 export declare const isAvailable_alias_6: (provider: FilesystemProvider) => boolean;
 
@@ -2213,7 +2376,6 @@ declare class MockProvider implements ToolProvider {
     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[]>;
-    listCodeDefinitionNames(path: string): Promise<string>;
     executeCommand(command: string, needApprove: boolean): Promise<{
         stdout: string;
         stderr: string;
@@ -2462,15 +2624,16 @@ export { PermissionLevel }
 export { PermissionLevel as PermissionLevel_alias_1 }
 
 declare enum Policies {
-    KnowledgeManagement = "knowledgemanagement"
+    KnowledgeManagement = "knowledgemanagement",
+    TruncateContext = "truncatecontext"
 }
 export { Policies }
 export { Policies as Policies_alias_1 }
 
 declare const replaceInFile_2: (fileContent: string, diff: string) => Promise<string>;
 export { replaceInFile_2 as replaceInFileHelper }
+export { replaceInFile_2 as replaceInFile_alias_2 }
 export { replaceInFile_2 as replaceInFile_alias_3 }
-export { replaceInFile_2 as replaceInFile_alias_4 }
 
 declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
@@ -2505,6 +2668,10 @@ export { SharedAgentOptions }
 export { SharedAgentOptions as SharedAgentOptions_alias_1 }
 export { SharedAgentOptions as SharedAgentOptions_alias_2 }
 
+declare const START_OF_FILE = "<<<START_OF_FILE>>>";
+export { START_OF_FILE }
+export { START_OF_FILE as START_OF_FILE_alias_1 }
+
 declare const systemInformation: (info: {
     os: string;
 }) => string;
@@ -2982,6 +3149,94 @@ export declare const toolInfo_alias_2: {
 };
 
 export declare const toolInfo_alias_3: {
+    readonly name: "edit_file";
+    readonly description: "Request to edit file contents using before/after text anchors with flexible operations. Supports multiple edit operations in a single call.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the file to edit";
+        readonly required: true;
+        readonly usageValue: "File path here";
+    }, {
+        readonly name: "operations";
+        readonly description: "Edit operation with before_text, after_text, new_text, and optional line range hints";
+        readonly required: true;
+        readonly allowMultiple: true;
+        readonly children: [{
+            readonly name: "before_text";
+            readonly description: "Text to find as the start anchor (use <<<START_OF_FILE>>> for file start)";
+            readonly required: false;
+            readonly usageValue: "Text before the edit location";
+        }, {
+            readonly name: "after_text";
+            readonly description: "Text to find as the end anchor (use <<<END_OF_FILE>>> for file end)";
+            readonly required: false;
+            readonly usageValue: "Text after the edit location";
+        }, {
+            readonly name: "new_text";
+            readonly description: "Text to replace the content between before_text and after_text";
+            readonly required: true;
+            readonly usageValue: "New text content";
+        }, {
+            readonly name: "before_text_line_start";
+            readonly description: "Optional line number hint for before_text location (1-based)";
+            readonly required: false;
+            readonly usageValue: "10";
+        }, {
+            readonly name: "after_text_line_start";
+            readonly description: "Optional line number hint for after_text location (1-based)";
+            readonly required: false;
+            readonly usageValue: "20";
+        }];
+        readonly usageValue: "operations here";
+    }];
+    readonly examples: [{
+        readonly description: "Replace content between two text anchors";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: {
+                readonly before_text: "function oldFunction() {";
+                readonly after_text: "}";
+                readonly new_text: "\n  return \"new implementation\";\n";
+            };
+        }];
+    }, {
+        readonly description: "Insert at start of file";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/header.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: {
+                readonly before_text: "<<<START_OF_FILE>>>";
+                readonly after_text: "export";
+                readonly new_text: "// File header comment\n";
+            };
+        }];
+    }, {
+        readonly description: "Multiple operations in one call";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils.ts";
+        }, {
+            readonly name: "operations";
+            readonly value: [{
+                readonly before_text: "import React";
+                readonly after_text: "from \"react\"";
+                readonly new_text: ", { useState }";
+            }, {
+                readonly before_text: "function Component() {";
+                readonly after_text: "return (";
+                readonly new_text: "\n  const [state, setState] = useState(false);\n  ";
+            }];
+        }];
+    }];
+    readonly permissionLevel: PermissionLevel.Write;
+};
+
+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. After an `execute_command` call, no other tool calls are allowed in the same assistant response.";
     readonly parameters: [{
@@ -3008,7 +3263,7 @@ export declare const toolInfo_alias_3: {
     readonly permissionLevel: PermissionLevel.Arbitrary;
 };
 
-export declare const toolInfo_alias_4: {
+export declare const toolInfo_alias_5: {
     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: [{
@@ -3051,25 +3306,6 @@ export declare const toolInfo_alias_4: {
     readonly permissionLevel: PermissionLevel.None;
 };
 
-export declare const toolInfo_alias_5: {
-    readonly name: "list_code_definition_names";
-    readonly description: "Request to list definition names (classes, functions, methods, etc.) used for all files in a directory. This tool provides insights into the codebase structure and important constructs, encapsulating high-level concepts and relationships that are crucial for understanding the overall architecture.";
-    readonly parameters: [{
-        readonly name: "path";
-        readonly description: "The path of a code file to list top level source code definitions for.";
-        readonly required: true;
-        readonly usageValue: "Directory path here";
-    }];
-    readonly examples: [{
-        readonly description: "Request to list code definition names in a directory";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/utils";
-        }];
-    }];
-    readonly permissionLevel: PermissionLevel.Read;
-};
-
 export declare const toolInfo_alias_6: {
     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.";
@@ -3150,12 +3386,12 @@ 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: [{
-        readonly name: "sourcePath";
+        readonly name: "source_path";
         readonly description: "The current path of the file";
         readonly required: true;
         readonly usageValue: "Source file path here";
     }, {
-        readonly name: "targetPath";
+        readonly name: "target_path";
         readonly description: "The new path for the file";
         readonly required: true;
         readonly usageValue: "Target file path here";
@@ -3163,10 +3399,10 @@ export declare const toolInfo_alias_9: {
     readonly examples: [{
         readonly description: "Request to rename a file";
         readonly parameters: [{
-            readonly name: "sourcePath";
+            readonly name: "source_path";
             readonly value: "src/old-name.js";
         }, {
-            readonly name: "targetPath";
+            readonly name: "target_path";
             readonly value: "src/new-name.js";
         }];
     }];
@@ -3305,6 +3541,15 @@ export { toolUsePrompt }
 export { toolUsePrompt as toolUsePrompt_alias_1 }
 export { toolUsePrompt as toolUsePrompt_alias_2 }
 
+declare const TruncateContextPolicy: (tools: Parameters<AgentPolicy>[0]) => {
+    name: Policies;
+    onBeforeRequest(agent: AgentBase): Promise<void>;
+};
+export { TruncateContextPolicy }
+export { TruncateContextPolicy as TruncateContextPolicy_alias_1 }
+export { TruncateContextPolicy as TruncateContextPolicy_alias_2 }
+export { TruncateContextPolicy as TruncateContextPolicy_alias_3 }
+
 declare class UsageMeter {
     #private;
     readonly maxCost: number;