@polka-codes/core 0.8.22 → 0.8.24

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { defaultModels } from './_tsup-dts-rollup.js';
 export { createService } from './_tsup-dts-rollup.js';
 export { UsageMeter } from './_tsup-dts-rollup.js';
 export { AiServiceBase } from './_tsup-dts-rollup.js';
+export { UserContent } from './_tsup-dts-rollup.js';
 export { MessageParam } from './_tsup-dts-rollup.js';
 export { AiServiceOptions } from './_tsup-dts-rollup.js';
 export { ModelInfo } from './_tsup-dts-rollup.js';
@@ -65,12 +66,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,13 +1845,13 @@ ${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
@@ -1826,7 +1908,7 @@ function join(...parts) {
 }
 
 // src/tools/updateKnowledge.ts
-var toolInfo9 = {
+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: [
@@ -2000,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 */,
@@ -2072,19 +2154,19 @@ 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;`.",
+  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: [
     {
       name: "path",
@@ -2127,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 */,
@@ -2135,24 +2217,26 @@ var handler10 = async (provider, args) => {
     };
   }
   const path = getString(args, "path");
-  const content = getString(args, "content");
+  let content = getString(args, "content");
+  const trimmedContent = content.trim();
+  if (trimmedContent.startsWith("<![CDATA[") && content.endsWith("]]>")) content = trimmedContent.slice(9, -3);
   await provider.writeFile(path, content);
   return {
     type: "Reply" /* Reply */,
     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: [
@@ -2206,7 +2290,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);
@@ -2219,17 +2303,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: [
@@ -2253,7 +2337,7 @@ var toolInfo12 = {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler12 = async (provider, args) => {
+var handler13 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
       type: "Error" /* Error */,
@@ -2267,17 +2351,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: [
@@ -2311,7 +2395,7 @@ var toolInfo13 = {
   ],
   permissionLevel: 2 /* Write */
 };
-var handler13 = async (provider, args) => {
+var handler14 = async (provider, args) => {
   if (!provider.renameFile) {
     return {
       type: "Error" /* Error */,
@@ -2326,13 +2410,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
@@ -2684,13 +2768,34 @@ ${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>",
-  toolResults: (tool, result) => `<tool_response>
-<tool_name>${tool}</tool_name>
-<tool_result>
-${result}
-</tool_result>
-</tool_response>`,
+  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) => {
+    if (typeof result === "string") {
+      return [
+        {
+          type: "text",
+          text: `<tool_response name=${tool}>${result}</tool_response>`
+        }
+      ];
+    }
+    return [
+      {
+        type: "text",
+        text: `<tool_response name=${tool}>`
+      },
+      ...result,
+      {
+        type: "text",
+        text: "</tool_response>"
+      }
+    ];
+  },
   commandResult: (command, exitCode, stdout, stderr) => `<command>${command}</command>
 <command_exit_code>${exitCode}</command_exit_code>
 <command_stdout>
@@ -2872,23 +2977,26 @@ ${instance.prompt}`;
           await this.#callback({ kind: "ToolUse" /* ToolUse */, agent: this, tool: content.name });
           const toolResp = await this.#invokeTool(content.name, content.params);
           switch (toolResp.type) {
-            case "Reply" /* Reply */:
+            case "Reply" /* Reply */: {
               await this.#callback({ kind: "ToolReply" /* ToolReply */, agent: this, tool: content.name });
               toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
               break;
+            }
             case "Exit" /* Exit */:
               if (toolResponses.length > 0) {
                 break outer;
               }
               return { type: "exit", reason: toolResp };
-            case "Invalid" /* Invalid */:
+            case "Invalid" /* Invalid */: {
               await this.#callback({ kind: "ToolInvalid" /* ToolInvalid */, agent: this, tool: content.name });
               toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
               break outer;
-            case "Error" /* Error */:
+            }
+            case "Error" /* Error */: {
               await this.#callback({ kind: "ToolError" /* ToolError */, agent: this, tool: content.name });
               toolResponses.push({ type: "response", tool: content.name, response: toolResp.message });
               break outer;
+            }
             case "Interrupted" /* Interrupted */:
               await this.#callback({ kind: "ToolInterrupted" /* ToolInterrupted */, agent: this, tool: content.name });
               return { type: "exit", reason: toolResp };
@@ -2938,13 +3046,13 @@ ${instance.prompt}`;
     if (toolResponses.length === 0) {
       return { type: "reply", message: responsePrompts.requireUseTool };
     }
-    const finalResp = toolResponses.filter((resp) => resp.type === "response").map(({ tool, response: response2 }) => responsePrompts.toolResults(tool, response2)).join("\n\n");
+    const finalResp = toolResponses.filter((resp) => resp.type === "response").flatMap(({ tool, response: response2 }) => responsePrompts.toolResults(tool, response2));
     return { type: "reply", message: finalResp };
   }
   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"),
@@ -2963,7 +3071,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 */,
@@ -4290,6 +4398,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.22",
+  "version": "0.8.24",
   "license": "AGPL-3.0",
   "author": "github@polka.codes",
   "type": "module",