@polka-codes/core 0.8.22 → 0.8.24

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

@@ -11,16 +11,16 @@ declare abstract class AgentBase {
     get parameters(): Readonly<any>;
     get messages(): Readonly<MessageParam[]>;
     setMessages(messages: Readonly<MessageParam[]>): void;
-    start(prompt: string): Promise<ExitReason>;
-    step(prompt: string): Promise<AssistantMessageContent[]>;
+    start(prompt: UserContent): Promise<ExitReason>;
+    step(prompt: UserContent): Promise<AssistantMessageContent[]>;
     handleStepResponse(response: AssistantMessageContent[]): Promise<{
         type: "reply";
-        message: string;
+        message: UserContent;
     } | {
         type: "exit";
         reason: ExitReason;
     }>;
-    continueTask(userMessage: string): Promise<ExitReason>;
+    continueTask(userMessage: UserContent): Promise<ExitReason>;
     protected abstract onBeforeInvokeTool(name: string, args: Record<string, string>): Promise<ToolResponse | undefined>;
     get model(): {
         provider: string;
@@ -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,9 +929,139 @@ 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;`.";
+        readonly description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
         readonly parameters: [{
             readonly name: "path";
             readonly description: "The path of the file to write to";
@@ -956,7 +1087,7 @@ declare const _default_10: {
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "write_to_file";
-    description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;` and `&gt;`.";
+    description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
     parameters: [{
         readonly name: "path";
         readonly description: "The path of the file to write to";
@@ -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.
@@ -2028,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>;
 
@@ -2044,6 +2111,8 @@ export declare const handler_alias_8: ToolHandler<typeof toolInfo_alias_8, Files
 
 export declare const handler_alias_9: ToolHandler<typeof toolInfo_alias_9, FilesystemProvider>;
 
+export declare type ImageBlockParam = Anthropic.Messages.ImageBlockParam;
+
 declare type Input = {
     commitMessages: string;
     commitDiff: string;
@@ -2069,13 +2138,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;
 
@@ -2543,8 +2614,8 @@ 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 toolResults: (tool: string, result: string) => string;
+    readonly requireUseTool: "Error: No tool use detected. You MUST use a tool before proceeding.\ne.g. <tool_tool_name>tool_name</tool_tool_name>\n\nEnsure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.\nAvoid unnecessary text or symbols before or after the tool use.\nAvoid unnecessary escape characters or special characters.\n";
+    readonly toolResults: (tool: string, result: UserContent) => (TextBlockParam | ImageBlockParam)[];
     readonly commandResult: (command: string, exitCode: number, stdout: string, stderr: string) => string;
 };
 export { responsePrompts }
@@ -2657,7 +2728,7 @@ export { TaskEventKind as TaskEventKind_alias_2 }
  */
 declare interface TaskEventStartRequest extends TaskEventBase {
     kind: TaskEventKind.StartRequest;
-    userMessage: string;
+    userMessage: UserContent;
 }
 export { TaskEventStartRequest }
 export { TaskEventStartRequest as TaskEventStartRequest_alias_1 }
@@ -2740,6 +2811,8 @@ export { TaskEventUsageExceeded }
 export { TaskEventUsageExceeded as TaskEventUsageExceeded_alias_1 }
 export { TaskEventUsageExceeded as TaskEventUsageExceeded_alias_2 }
 
+export declare type TextBlockParam = Anthropic.Messages.TextBlockParam;
+
 declare interface TextContent {
     type: 'text';
     content: string;
@@ -2855,6 +2928,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: [{
@@ -2889,7 +3016,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: [{
@@ -2952,9 +3079,9 @@ 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 description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
     readonly parameters: [{
         readonly name: "path";
         readonly description: "The path of the file to write to";
@@ -3050,6 +3177,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: [{
@@ -3092,7 +3249,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: [{
@@ -3124,7 +3281,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: [{
@@ -3149,7 +3306,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: [{
@@ -3168,7 +3325,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: [{
@@ -3195,60 +3352,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;
@@ -3266,7 +3369,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 }
@@ -3328,7 +3431,7 @@ export { ToolResponseInvalid as ToolResponseInvalid_alias_1 }
 declare type ToolResponseOrToolPause = {
     type: 'response';
     tool: string;
-    response: string;
+    response: UserContent;
 } | {
     type: 'pause';
     tool: string;
@@ -3347,7 +3450,7 @@ export { ToolResponsePause as ToolResponsePause_alias_1 }
 
 declare type ToolResponseReply = {
     type: ToolResponseType.Reply;
-    message: string;
+    message: UserContent;
 };
 export { ToolResponseReply }
 export { ToolResponseReply as ToolResponseReply_alias_1 }
@@ -3431,4 +3534,16 @@ export { UsageMeter }
 export { UsageMeter as UsageMeter_alias_1 }
 export { UsageMeter as UsageMeter_alias_2 }
 
+declare type UserContent = string | (TextBlockParam | ImageBlockParam)[];
+export { UserContent }
+export { UserContent as UserContent_alias_1 }
+export { UserContent as UserContent_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 { }