@polka-codes/core 0.8.21 → 0.8.23

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

@@ -168,15 +168,16 @@ export declare namespace allTools {
         _default_2 as attemptCompletion,
         _default_3 as delegate,
         _default_4 as executeCommand,
-        _default_5 as listFiles,
-        _default_6 as readFile,
-        _default_7 as replaceInFile,
-        _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_5 as fetchUrl,
+        _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
     }
 }
 
@@ -928,6 +929,136 @@ 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 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_10 as default_alias_16 }
+export { _default_10 as updateKnowledge }
+export { _default_10 as updateKnowledge_alias_1 }
+export { _default_10 as updateKnowledge_alias_2 }
+
+declare const _default_11: {
     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;`.";
@@ -980,12 +1111,12 @@ declare const _default_10: {
     }];
     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_11 as default_alias_17 }
+export { _default_11 as writeToFile }
+export { _default_11 as writeToFile_alias_1 }
+export { _default_11 as writeToFile_alias_2 }
 
-declare const _default_11: {
+declare const _default_12: {
     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.";
@@ -1070,12 +1201,12 @@ declare const _default_11: {
     }];
     permissionLevel: PermissionLevel.None;
 };
-export { _default_11 as default_alias_8 }
-export { _default_11 as handOver }
-export { _default_11 as handOver_alias_1 }
-export { _default_11 as handOver_alias_2 }
+export { _default_12 as default_alias_9 }
+export { _default_12 as handOver }
+export { _default_12 as handOver_alias_1 }
+export { _default_12 as handOver_alias_2 }
 
-declare const _default_12: {
+declare const _default_13: {
     handler: ToolHandler<{
         readonly name: "remove_file";
         readonly description: "Request to remove a file at the specified path.";
@@ -1112,12 +1243,12 @@ declare const _default_12: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_12 as default_alias_11 }
-export { _default_12 as removeFile }
-export { _default_12 as removeFile_alias_1 }
-export { _default_12 as removeFile_alias_2 }
+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 }
 
-declare const _default_13: {
+declare const _default_14: {
     handler: ToolHandler<{
         readonly name: "rename_file";
         readonly description: "Request to rename a file from source path to target path.";
@@ -1170,10 +1301,10 @@ declare const _default_13: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_13 as default_alias_12 }
-export { _default_13 as renameFile }
-export { _default_13 as renameFile_alias_1 }
-export { _default_13 as renameFile_alias_2 }
+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 }
 
 declare const _default_2: {
     handler: ToolHandler<{
@@ -1366,6 +1497,70 @@ export { _default_4 as executeCommand_alias_1 }
 export { _default_4 as executeCommand_alias_2 }
 
 declare const _default_5: {
+    handler: ToolHandler<{
+        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: [{
+            readonly name: "url";
+            readonly description: "One or more URLs to fetch, separated by commas if multiple.";
+            readonly required: true;
+        }];
+        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;
+    name: "fetch_url";
+    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.";
+    parameters: [{
+        readonly name: "url";
+        readonly description: "One or more URLs to fetch, separated by commas if multiple.";
+        readonly required: true;
+    }];
+    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 fetchUrl }
+export { _default_5 as fetchUrl_alias_1 }
+export { _default_5 as fetchUrl_alias_2 }
+
+declare const _default_6: {
     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.";
@@ -1428,12 +1623,12 @@ declare const _default_5: {
     }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_5 as default_alias_9 }
-export { _default_5 as listFiles }
-export { _default_5 as listFiles_alias_1 }
-export { _default_5 as listFiles_alias_2 }
+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 }
 
-declare const _default_6: {
+declare const _default_7: {
     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.";
@@ -1482,12 +1677,12 @@ declare const _default_6: {
     }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_6 as default_alias_10 }
-export { _default_6 as readFile }
-export { _default_6 as readFile_alias_1 }
-export { _default_6 as readFile_alias_2 }
+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 }
 
-declare const _default_7: {
+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.";
@@ -1594,12 +1789,12 @@ declare const _default_7: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_7 as default_alias_13 }
-export { _default_7 as replaceInFile }
-export { _default_7 as replaceInFile_alias_1 }
-export { _default_7 as replaceInFile_alias_2 }
+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_8: {
+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.";
@@ -1668,140 +1863,10 @@ declare const _default_8: {
     }];
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_8 as default_alias_14 }
-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_15 }
-export { _default_9 as updateKnowledge }
-export { _default_9 as updateKnowledge_alias_1 }
-export { _default_9 as updateKnowledge_alias_2 }
+export { _default_9 as searchFiles }
+export { _default_9 as searchFiles_alias_1 }
+export { _default_9 as searchFiles_alias_2 }
 
 /**
  * AI tool for creating new projects based on user specifications.
@@ -1857,6 +1922,12 @@ declare const defaultModels: {
 export { defaultModels }
 export { defaultModels as defaultModels_alias_1 }
 
+/**
+ * Returns the directory portion of a path string.
+ * Strips trailing slashes, then takes everything up to the last slash.
+ */
+export declare function dirname(path: string): string;
+
 export declare const editingFilesPrompt: (toolNamePrefix: string) => string;
 
 declare const executeAgentTool: <T extends AiToolDefinition<any, any>>(definition: T, agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
@@ -2022,13 +2093,15 @@ 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_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
+
 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_4: ToolHandler<typeof toolInfo_alias_4, any>;
+export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, WebProvider>;
 
-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>;
 
@@ -2063,13 +2136,15 @@ export declare const isAvailable_alias_11: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_12: (provider: FilesystemProvider) => boolean;
 
+export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boolean;
+
 export declare const isAvailable_alias_2: (_provider: any) => boolean;
 
 export declare const isAvailable_alias_3: (provider: CommandProvider) => boolean;
 
-export declare const isAvailable_alias_4: (_provider: any) => boolean;
+export declare const isAvailable_alias_4: (provider: WebProvider) => 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;
 
@@ -2079,6 +2154,11 @@ export declare const isAvailable_alias_8: (provider: FilesystemProvider) => bool
 
 export declare const isAvailable_alias_9: (provider: FilesystemProvider) => boolean;
 
+/**
+ * Joins all given path segments, then normalizes the result.
+ */
+export declare function join(...parts: string[]): string;
+
 declare const KnowledgeManagementPolicy: (tools: Parameters<AgentPolicy>[0]) => {
     name: Policies;
     tools: {
@@ -2532,7 +2612,7 @@ export { replaceInFile_2 as replaceInFile_alias_4 }
 
 declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
-    readonly requireUseTool: "Error: You MUST use a tool before proceeding using XCM tags. e.g. <tool_tool_name>tool_name</tool_tool_name>";
+    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 toolResults: (tool: string, result: string) => string;
     readonly commandResult: (command: string, exitCode: number, stdout: string, stderr: string) => string;
 };
@@ -2844,6 +2924,60 @@ export declare const toolInfo_alias_1: {
 };
 
 export declare const toolInfo_alias_10: {
+    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```\nCritical rules:\n1. 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.\n2. 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.\n3. 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.\n4. 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 description: "Request to perform a simple, single-line replacement";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/config.js";
+        }, {
+            readonly name: "diff";
+            readonly value: "\n<<<<<<< SEARCH\nconst API_URL = 'https://api.example.com';\n=======\nconst API_URL = 'https://api.staging.example.com';\n>>>>>>> REPLACE\n";
+        }];
+    }, {
+        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: "\n<<<<<<< SEARCH\nfunction helperA() {\n  // ...\n}\n=======\nfunction helperA() {\n  // ...\n}\n\nfunction newHelper() {\n  // implementation\n}\n>>>>>>> REPLACE\n";
+        }];
+    }, {
+        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: "\n<<<<<<< SEARCH\nfunction oldFeature() {\n  // This is no longer needed\n}\n\n=======\n>>>>>>> REPLACE\n";
+        }];
+    }];
+    readonly permissionLevel: PermissionLevel.Write;
+};
+
+export declare const toolInfo_alias_11: {
     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: [{
@@ -2878,7 +3012,7 @@ export declare const toolInfo_alias_10: {
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_11: {
+export declare const toolInfo_alias_12: {
     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: [{
@@ -2941,7 +3075,7 @@ export declare const toolInfo_alias_11: {
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-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;` and `&gt;`.";
     readonly parameters: [{
@@ -3039,6 +3173,36 @@ export declare const toolInfo_alias_3: {
 };
 
 export declare const toolInfo_alias_4: {
+    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: [{
+        readonly name: "url";
+        readonly description: "One or more URLs to fetch, separated by commas if multiple.";
+        readonly required: true;
+    }];
+    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: {
     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: [{
@@ -3081,7 +3245,7 @@ export declare const toolInfo_alias_4: {
     readonly permissionLevel: PermissionLevel.None;
 };
 
-export declare const toolInfo_alias_5: {
+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.";
     readonly parameters: [{
@@ -3113,7 +3277,7 @@ export declare const toolInfo_alias_5: {
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_6: {
+export declare const toolInfo_alias_7: {
     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: [{
@@ -3138,7 +3302,7 @@ export declare const toolInfo_alias_6: {
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_7: {
+export declare const toolInfo_alias_8: {
     readonly name: "remove_file";
     readonly description: "Request to remove a file at the specified path.";
     readonly parameters: [{
@@ -3157,7 +3321,7 @@ export declare const toolInfo_alias_7: {
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_8: {
+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: [{
@@ -3184,60 +3348,6 @@ export declare const toolInfo_alias_8: {
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_9: {
-    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```\nCritical rules:\n1. 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.\n2. 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.\n3. 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.\n4. 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 description: "Request to perform a simple, single-line replacement";
-        readonly parameters: [{
-            readonly name: "path";
-            readonly value: "src/config.js";
-        }, {
-            readonly name: "diff";
-            readonly value: "\n<<<<<<< SEARCH\nconst API_URL = 'https://api.example.com';\n=======\nconst API_URL = 'https://api.staging.example.com';\n>>>>>>> REPLACE\n";
-        }];
-    }, {
-        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: "\n<<<<<<< SEARCH\nfunction helperA() {\n  // ...\n}\n=======\nfunction helperA() {\n  // ...\n}\n\nfunction newHelper() {\n  // implementation\n}\n>>>>>>> REPLACE\n";
-        }];
-    }, {
-        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: "\n<<<<<<< SEARCH\nfunction oldFeature() {\n  // This is no longer needed\n}\n\n=======\n>>>>>>> REPLACE\n";
-        }];
-    }];
-    readonly permissionLevel: PermissionLevel.Write;
-};
-
 declare type ToolParameter = {
     name: string;
     description: string;
@@ -3255,7 +3365,7 @@ declare type ToolParameterValue = string | {
 export { ToolParameterValue }
 export { ToolParameterValue as ToolParameterValue_alias_1 }
 
-declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider;
+declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider;
 export { ToolProvider }
 export { ToolProvider as ToolProvider_alias_1 }
 export { ToolProvider as ToolProvider_alias_2 }
@@ -3420,4 +3530,11 @@ export { UsageMeter }
 export { UsageMeter as UsageMeter_alias_1 }
 export { UsageMeter as UsageMeter_alias_2 }
 
+declare type WebProvider = {
+    fetchUrl?: (url: string) => Promise<string>;
+};
+export { WebProvider }
+export { WebProvider as WebProvider_alias_1 }
+export { WebProvider as WebProvider_alias_2 }
+
 export { }

package/dist/index.d.ts

@@ -65,12 +65,14 @@ export { allTools } from './_tsup-dts-rollup.js';
 export { FilesystemProvider } from './_tsup-dts-rollup.js';
 export { CommandProvider } from './_tsup-dts-rollup.js';
 export { InteractionProvider } from './_tsup-dts-rollup.js';
+export { WebProvider } from './_tsup-dts-rollup.js';
 export { ToolProvider } from './_tsup-dts-rollup.js';
 export { MockProvider } from './_tsup-dts-rollup.js';
 export { askFollowupQuestion } from './_tsup-dts-rollup.js';
 export { attemptCompletion } from './_tsup-dts-rollup.js';
 export { delegate } from './_tsup-dts-rollup.js';
 export { executeCommand } from './_tsup-dts-rollup.js';
+export { fetchUrl } from './_tsup-dts-rollup.js';
 export { listFiles } from './_tsup-dts-rollup.js';
 export { readFile } from './_tsup-dts-rollup.js';
 export { replaceInFile } from './_tsup-dts-rollup.js';

package/dist/index.js

@@ -883,6 +883,7 @@ __export(allTools_exports, {
   attemptCompletion: () => attemptCompletion_default,
   delegate: () => delegate_default,
   executeCommand: () => executeCommand_default,
+  fetchUrl: () => fetchUrl_default,
   handOver: () => handOver_default,
   listFiles: () => listFiles_default,
   readFile: () => readFile_default,
@@ -1371,8 +1372,89 @@ var executeCommand_default = {
   isAvailable: isAvailable4
 };
 
-// src/tools/listFiles.ts
+// src/tools/fetchUrl.ts
 var toolInfo5 = {
+  name: "fetch_url",
+  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.",
+  parameters: [
+    {
+      name: "url",
+      description: "One or more URLs to fetch, separated by commas if multiple.",
+      required: true
+    }
+  ],
+  examples: [
+    {
+      description: "Fetch a single webpage",
+      parameters: [
+        {
+          name: "url",
+          value: "https://example.com"
+        }
+      ]
+    },
+    {
+      description: "Fetch multiple webpages",
+      parameters: [
+        {
+          name: "url",
+          value: "https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP"
+        }
+      ]
+    },
+    {
+      description: "Fetch a raw file from GitHub",
+      parameters: [
+        {
+          name: "url",
+          value: "https://raw.githubusercontent.com/user/repo/main/README.md"
+        }
+      ]
+    }
+  ],
+  permissionLevel: 1 /* Read */
+};
+var handler5 = async (provider, args) => {
+  if (!provider.fetchUrl) {
+    return {
+      type: "Error" /* Error */,
+      message: "Not possible to fetch url. Abort."
+    };
+  }
+  const urls = getStringArray(args, "url");
+  if (urls.length === 0) {
+    return {
+      type: "Error" /* Error */,
+      message: "No URLs provided. Please provide at least one URL to fetch."
+    };
+  }
+  const results = [];
+  for (const url of urls) {
+    try {
+      const content = provider.fetchUrl(url).then((res) => `<fetch_url_content url="${url}">${res}</fetch_url_content>`);
+      results.push(content);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unknown error";
+      results.push(Promise.resolve(`<fetch_url_error url="${url}">${errorMessage}</fetch_url_error>`));
+    }
+  }
+  const resolvedResults = await Promise.all(results);
+  return {
+    type: "Reply" /* Reply */,
+    message: resolvedResults.join("\n")
+  };
+};
+var isAvailable5 = (provider) => {
+  return typeof provider.fetchUrl === "function";
+};
+var fetchUrl_default = {
+  ...toolInfo5,
+  handler: handler5,
+  isAvailable: isAvailable5
+};
+
+// src/tools/listFiles.ts
+var toolInfo6 = {
   name: "list_files",
   description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.",
   parameters: [
@@ -1412,7 +1494,7 @@ var toolInfo5 = {
   ],
   permissionLevel: 1 /* Read */
 };
-var handler5 = async (provider, args) => {
+var handler6 = async (provider, args) => {
   if (!provider.listFiles) {
     return {
       type: "Error" /* Error */,
@@ -1432,17 +1514,17 @@ ${files.join("\n")}
 <list_files_truncated>${limitReached}</list_files_truncated>`
   };
 };
-var isAvailable5 = (provider) => {
+var isAvailable6 = (provider) => {
   return !!provider.listFiles;
 };
 var listFiles_default = {
-  ...toolInfo5,
-  handler: handler5,
-  isAvailable: isAvailable5
+  ...toolInfo6,
+  handler: handler6,
+  isAvailable: isAvailable6
 };
 
 // src/tools/readFile.ts
-var toolInfo6 = {
+var toolInfo7 = {
   name: "read_file",
   description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.",
   parameters: [
@@ -1475,7 +1557,7 @@ var toolInfo6 = {
   ],
   permissionLevel: 1 /* Read */
 };
-var handler6 = async (provider, args) => {
+var handler7 = async (provider, args) => {
   if (!provider.readFile) {
     return {
       type: "Error" /* Error */,
@@ -1502,17 +1584,17 @@ var handler6 = async (provider, args) => {
     message: resp.join("\n")
   };
 };
-var isAvailable6 = (provider) => {
+var isAvailable7 = (provider) => {
   return !!provider.readFile;
 };
 var readFile_default = {
-  ...toolInfo6,
-  handler: handler6,
-  isAvailable: isAvailable6
+  ...toolInfo7,
+  handler: handler7,
+  isAvailable: isAvailable7
 };
 
 // src/tools/replaceInFile.ts
-var toolInfo7 = {
+var toolInfo8 = {
   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: [
@@ -1664,7 +1746,7 @@ function oldFeature() {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler7 = async (provider, args) => {
+var handler8 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -1687,17 +1769,17 @@ var handler7 = async (provider, args) => {
     message: `<replace_in_file_path>${path}</replace_in_file_path>`
   };
 };
-var isAvailable7 = (provider) => {
+var isAvailable8 = (provider) => {
   return !!provider.readFile && !!provider.writeFile;
 };
 var replaceInFile_default = {
-  ...toolInfo7,
-  handler: handler7,
-  isAvailable: isAvailable7
+  ...toolInfo8,
+  handler: handler8,
+  isAvailable: isAvailable8
 };
 
 // src/tools/searchFiles.ts
-var toolInfo8 = {
+var toolInfo9 = {
   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: [
@@ -1741,7 +1823,7 @@ var toolInfo8 = {
   ],
   permissionLevel: 1 /* Read */
 };
-var handler8 = async (provider, args) => {
+var handler9 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -1763,19 +1845,70 @@ ${files.join("\n")}
 `
   };
 };
-var isAvailable8 = (provider) => {
+var isAvailable9 = (provider) => {
   return !!provider.searchFiles;
 };
 var searchFiles_default = {
-  ...toolInfo8,
-  handler: handler8,
-  isAvailable: isAvailable8
+  ...toolInfo9,
+  handler: handler9,
+  isAvailable: isAvailable9
 };
 
 // src/tools/updateKnowledge.ts
-import { join } from "node:path";
 import YAML from "yaml";
-var toolInfo9 = {
+
+// src/path.ts
+function dirname(path) {
+  if (path.length === 0) return ".";
+  const isRooted = path[0] === "/";
+  let end = path.length - 1;
+  while (end > 0 && path[end] === "/") end--;
+  const idx = path.lastIndexOf("/", end);
+  if (idx < 0) {
+    return isRooted ? "/" : ".";
+  }
+  if (isRooted && idx === 0) {
+    return "/";
+  }
+  return path.slice(0, idx);
+}
+function normalize(path) {
+  const isAbsolute = path.startsWith("/");
+  const segments = path.split("/").filter(Boolean);
+  const stack = [];
+  for (const seg of segments) {
+    if (seg === ".") continue;
+    if (seg === "..") {
+      if (stack.length && stack[stack.length - 1] !== "..") {
+        stack.pop();
+      } else if (!isAbsolute) {
+        stack.push("..");
+      }
+    } else {
+      stack.push(seg);
+    }
+  }
+  let result = stack.join("/");
+  if (!result && !isAbsolute) return ".";
+  if (result && path.endsWith("/")) result += "/";
+  return (isAbsolute ? "/" : "") + result;
+}
+function join(...parts) {
+  if (parts.length === 0) return ".";
+  let combined = "";
+  for (const p of parts) {
+    if (typeof p !== "string") {
+      throw new TypeError("Arguments to join must be strings");
+    }
+    if (p) {
+      combined = combined ? `${combined}/${p}` : p;
+    }
+  }
+  return normalize(combined);
+}
+
+// src/tools/updateKnowledge.ts
+var toolInfo10 = {
   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: [
@@ -1949,7 +2082,7 @@ function deepMerge(target, source) {
   }
   return output;
 }
-var handler9 = async (provider, args) => {
+var handler10 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -2021,17 +2154,17 @@ var handler9 = async (provider, args) => {
     };
   }
 };
-var isAvailable9 = (provider) => {
+var isAvailable10 = (provider) => {
   return !!provider.readFile && !!provider.writeFile;
 };
 var updateKnowledge_default = {
-  ...toolInfo9,
-  handler: handler9,
-  isAvailable: isAvailable9
+  ...toolInfo10,
+  handler: handler10,
+  isAvailable: isAvailable10
 };
 
 // src/tools/writeToFile.ts
-var toolInfo10 = {
+var toolInfo11 = {
   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;` and `&gt;`.",
   parameters: [
@@ -2076,7 +2209,7 @@ export default App;
   ],
   permissionLevel: 2 /* Write */
 };
-var handler10 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -2091,17 +2224,17 @@ var handler10 = async (provider, args) => {
     message: `<write_to_file_path>${path}</write_to_file_path><status>Success</status>`
   };
 };
-var isAvailable10 = (provider) => {
+var isAvailable11 = (provider) => {
   return !!provider.writeFile;
 };
 var writeToFile_default = {
-  ...toolInfo10,
-  handler: handler10,
-  isAvailable: isAvailable10
+  ...toolInfo11,
+  handler: handler11,
+  isAvailable: isAvailable11
 };
 
 // src/tools/handOver.ts
-var toolInfo11 = {
+var toolInfo12 = {
   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: [
@@ -2155,7 +2288,7 @@ var toolInfo11 = {
   ],
   permissionLevel: 0 /* None */
 };
-var handler11 = async (_provider, args) => {
+var handler12 = async (_provider, args) => {
   const agentName = getString(args, "agent_name");
   const task = getString(args, "task");
   const context = getString(args, "context", void 0);
@@ -2168,17 +2301,17 @@ var handler11 = async (_provider, args) => {
     files
   };
 };
-var isAvailable11 = (_provider) => {
+var isAvailable12 = (_provider) => {
   return true;
 };
 var handOver_default = {
-  ...toolInfo11,
-  handler: handler11,
-  isAvailable: isAvailable11
+  ...toolInfo12,
+  handler: handler12,
+  isAvailable: isAvailable12
 };
 
 // src/tools/removeFile.ts
-var toolInfo12 = {
+var toolInfo13 = {
   name: "remove_file",
   description: "Request to remove a file at the specified path.",
   parameters: [
@@ -2202,7 +2335,7 @@ var toolInfo12 = {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler12 = async (provider, args) => {
+var handler13 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
       type: "Error" /* Error */,
@@ -2216,17 +2349,17 @@ var handler12 = async (provider, args) => {
     message: `<remove_file_path>${path}</remove_file_path><status>Success</status>`
   };
 };
-var isAvailable12 = (provider) => {
+var isAvailable13 = (provider) => {
   return !!provider.removeFile;
 };
 var removeFile_default = {
-  ...toolInfo12,
-  handler: handler12,
-  isAvailable: isAvailable12
+  ...toolInfo13,
+  handler: handler13,
+  isAvailable: isAvailable13
 };
 
 // src/tools/renameFile.ts
-var toolInfo13 = {
+var toolInfo14 = {
   name: "rename_file",
   description: "Request to rename a file from source path to target path.",
   parameters: [
@@ -2260,7 +2393,7 @@ var toolInfo13 = {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler13 = async (provider, args) => {
+var handler14 = async (provider, args) => {
   if (!provider.renameFile) {
     return {
       type: "Error" /* Error */,
@@ -2275,13 +2408,13 @@ var handler13 = async (provider, args) => {
     message: `<rename_file_path>${targetPath}</rename_file_path><status>Success</status>`
   };
 };
-var isAvailable13 = (provider) => {
+var isAvailable14 = (provider) => {
   return !!provider.renameFile;
 };
 var renameFile_default = {
-  ...toolInfo13,
-  handler: handler13,
-  isAvailable: isAvailable13
+  ...toolInfo14,
+  handler: handler14,
+  isAvailable: isAvailable14
 };
 
 // src/getAvailableTools.ts
@@ -2633,7 +2766,13 @@ ${joined}`;
 };
 var responsePrompts = {
   errorInvokeTool: (tool, error) => `An error occurred while invoking the tool "${tool}": ${error}`,
-  requireUseTool: "Error: You MUST use a tool before proceeding using XCM tags. e.g. <tool_tool_name>tool_name</tool_tool_name>",
+  requireUseTool: `Error: No tool use detected. You MUST use a tool before proceeding.
+e.g. <tool_tool_name>tool_name</tool_tool_name>
+
+Ensure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.
+Avoid unnecessary text or symbols before or after the tool use.
+Avoid unnecessary escape characters or special characters.
+`,
   toolResults: (tool, result) => `<tool_response>
 <tool_name>${tool}</tool_name>
 <tool_result>
@@ -2892,8 +3031,8 @@ ${instance.prompt}`;
   }
   async #invokeTool(name, args) {
     try {
-      const handler14 = this.handlers[name]?.handler;
-      if (!handler14) {
+      const handler15 = this.handlers[name]?.handler;
+      if (!handler15) {
         return {
           type: "Error" /* Error */,
           message: responsePrompts.errorInvokeTool(name, "Tool not found"),
@@ -2912,7 +3051,7 @@ ${instance.prompt}`;
       if (resp) {
         return resp;
       }
-      return await handler14(this.config.provider, args);
+      return await handler15(this.config.provider, args);
     } catch (error) {
       return {
         type: "Error" /* Error */,
@@ -3545,9 +3684,6 @@ var MultiAgent = class {
   }
 };
 
-// src/Agent/policies/KnowledgeManagement.ts
-import { dirname, join as join2 } from "node:path";
-
 // src/config.ts
 import { z } from "zod";
 var providerModelSchema = z.object({
@@ -3711,7 +3847,7 @@ var KnowledgeManagementPolicy = (tools) => {
         if (path === ".") {
           continue;
         }
-        const fullpath = join2(path, "knowledge.ai.yml");
+        const fullpath = join(path, "knowledge.ai.yml");
         if (!readFiles.has(fullpath)) {
           allFullPaths.push(fullpath);
           readFiles.add(fullpath);
@@ -4242,6 +4378,7 @@ export {
   executeAgentTool,
   executeCommand_default as executeCommand,
   executeTool,
+  fetchUrl_default as fetchUrl,
   generateGitCommitMessage,
   generateGithubPullRequestDetails,
   generateProjectConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polka-codes/core",
-  "version": "0.8.21",
+  "version": "0.8.23",
   "license": "AGPL-3.0",
   "author": "github@polka.codes",
   "type": "module",