@polka-codes/core 0.8.20 → 0.8.22

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { replaceInFileHelper } from './_tsup-dts-rollup.js';
-export { editFileHelper } from './_tsup-dts-rollup.js';
 export { AiServiceProvider } from './_tsup-dts-rollup.js';
 export { defaultModels } from './_tsup-dts-rollup.js';
 export { createService } from './_tsup-dts-rollup.js';
@@ -62,7 +61,6 @@ export { ToolUse } from './_tsup-dts-rollup.js';
 export { AssistantMessageContent } from './_tsup-dts-rollup.js';
 export { KnowledgeManagementPolicy } from './_tsup-dts-rollup.js';
 export { TruncateContextPolicy } from './_tsup-dts-rollup.js';
-export { editFile } from './_tsup-dts-rollup.js';
 export { allTools } from './_tsup-dts-rollup.js';
 export { FilesystemProvider } from './_tsup-dts-rollup.js';
 export { CommandProvider } from './_tsup-dts-rollup.js';

package/dist/index.js

@@ -914,40 +914,6 @@ var ToolResponseType = /* @__PURE__ */ ((ToolResponseType2) => {
   return ToolResponseType2;
 })(ToolResponseType || {});
 
-// src/tools/utils/editFile.ts
-var START_OF_FILE = "<<<START_OF_FILE>>>";
-var END_OF_FILE = "<<<END_OF_FILE>>>";
-var editFile = async (fileContent, operations) => {
-  if (!operations || operations.length === 0) {
-    throw new Error("At least one edit operation is required");
-  }
-  let updatedContent = fileContent;
-  for (const operation of operations) {
-    updatedContent = await applyEditOperation(updatedContent, operation);
-  }
-  return updatedContent;
-};
-async function applyEditOperation(fileContent, operation) {
-  const { search, replace } = operation;
-  if (search === START_OF_FILE && replace === END_OF_FILE) {
-    throw new Error("Cannot search for START_OF_FILE and replace with END_OF_FILE");
-  }
-  if (search === END_OF_FILE && replace === START_OF_FILE) {
-    throw new Error("Cannot search for END_OF_FILE and replace with START_OF_FILE");
-  }
-  if (search === START_OF_FILE) {
-    return replace + fileContent;
-  }
-  if (search === END_OF_FILE) {
-    return fileContent + replace;
-  }
-  const index = fileContent.indexOf(search);
-  if (index === -1) {
-    throw new Error(`Could not find text: ${search}`);
-  }
-  return fileContent.slice(0, index) + replace + fileContent.slice(index + search.length);
-}
-
 // src/tools/utils/getArg.ts
 var getString = (args, name, defaultValue) => {
   if (typeof args !== "object" || Array.isArray(args)) {
@@ -1559,29 +1525,29 @@ var toolInfo7 = {
     {
       name: "diff",
       description: `One or more SEARCH/REPLACE blocks following this exact format:
-  \`\`\`
-  <<<<<<< SEARCH
-  [exact content to find]
-  =======
-  [new content to replace with]
-  >>>>>>> REPLACE
-  \`\`\`
-  Critical rules:
-  1. SEARCH content must match the associated file section to find EXACTLY:
-     * Match character-for-character including whitespace, indentation, line endings
-     * Include all comments, docstrings, etc.
-  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.
-     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.
-     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.
-     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.
-  3. Keep SEARCH/REPLACE blocks concise:
-     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.
-     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.
-     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.
-     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.
-  4. Special operations:
-     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)
-     * To delete code: Use empty REPLACE section`,
+\`\`\`
+<<<<<<< SEARCH
+[exact content to find]
+=======
+[new content to replace with]
+>>>>>>> REPLACE
+\`\`\`
+Critical rules:
+1. SEARCH content must match the associated file section to find EXACTLY:
+    * Match character-for-character including whitespace, indentation, line endings
+    * Include all comments, docstrings, etc.
+2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.
+    * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.
+    * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.
+    * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.
+3. Keep SEARCH/REPLACE blocks concise:
+    * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.
+    * Include just the changing lines, and a few surrounding lines if needed for uniqueness.
+    * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.
+    * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.
+4. Special operations:
+    * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)
+    * To delete code: Use empty REPLACE section`,
       required: true,
       usageValue: "Search and replace blocks here"
     }
@@ -1624,6 +1590,73 @@ function handleSubmit() {
 return (
   <div>
 >>>>>>> REPLACE
+`
+        }
+      ]
+    },
+    {
+      description: "Request to perform a simple, single-line replacement",
+      parameters: [
+        {
+          name: "path",
+          value: "src/config.js"
+        },
+        {
+          name: "diff",
+          value: `
+<<<<<<< SEARCH
+const API_URL = 'https://api.example.com';
+=======
+const API_URL = 'https://api.staging.example.com';
+>>>>>>> REPLACE
+`
+        }
+      ]
+    },
+    {
+      description: "Request to add a new function to a file",
+      parameters: [
+        {
+          name: "path",
+          value: "src/utils.js"
+        },
+        {
+          name: "diff",
+          value: `
+<<<<<<< SEARCH
+function helperA() {
+  // ...
+}
+=======
+function helperA() {
+  // ...
+}
+
+function newHelper() {
+  // implementation
+}
+>>>>>>> REPLACE
+`
+        }
+      ]
+    },
+    {
+      description: "Request to delete a block of code from a file",
+      parameters: [
+        {
+          name: "path",
+          value: "src/app.js"
+        },
+        {
+          name: "diff",
+          value: `
+<<<<<<< SEARCH
+function oldFeature() {
+  // This is no longer needed
+}
+
+=======
+>>>>>>> REPLACE
 `
         }
       ]
@@ -1740,8 +1773,59 @@ var searchFiles_default = {
 };
 
 // src/tools/updateKnowledge.ts
-import { join } from "node:path";
 import YAML from "yaml";
+
+// 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 toolInfo9 = {
   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.",
@@ -2251,158 +2335,6 @@ var renameFile_default = {
   isAvailable: isAvailable13
 };
 
-// src/tools/editFile.ts
-var toolInfo14 = {
-  name: "edit_file",
-  description: "Request to edit file contents using search/replace operations. Supports multiple edit operations in a single call.",
-  parameters: [
-    {
-      name: "path",
-      description: "The path of the file to edit",
-      required: true,
-      usageValue: "File path here"
-    },
-    {
-      name: "operations",
-      description: "Edit operation with search and replace parameters",
-      required: true,
-      allowMultiple: true,
-      children: [
-        {
-          name: "search",
-          description: `Text to search for and replace (use ${START_OF_FILE} to insert at file start, ${END_OF_FILE} to insert at file end)`,
-          required: true,
-          usageValue: "Text to find and replace"
-        },
-        {
-          name: "replace",
-          description: "Text to replace the search text with",
-          required: true,
-          usageValue: "Replacement text"
-        }
-      ],
-      usageValue: "operations here"
-    }
-  ],
-  examples: [
-    {
-      description: "Replace specific text",
-      parameters: [
-        {
-          name: "path",
-          value: "src/main.ts"
-        },
-        {
-          name: "operations",
-          value: {
-            search: "function oldFunction() {\n  return 42;\n}",
-            replace: 'function newFunction() {\n  return "new implementation";\n}'
-          }
-        }
-      ]
-    },
-    {
-      description: "Insert at start of file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/header.ts"
-        },
-        {
-          name: "operations",
-          value: {
-            search: START_OF_FILE,
-            replace: "// File header comment\n"
-          }
-        }
-      ]
-    },
-    {
-      description: "Multiple operations in one call",
-      parameters: [
-        {
-          name: "path",
-          value: "src/utils.ts"
-        },
-        {
-          name: "operations",
-          value: [
-            {
-              search: 'import React from "react"',
-              replace: 'import React, { useState } from "react"'
-            },
-            {
-              search: "function Component() {\n  return (",
-              replace: "function Component() {\n  const [state, setState] = useState(false);\n  return ("
-            }
-          ]
-        }
-      ]
-    },
-    {
-      description: "Append content at end of file",
-      parameters: [
-        {
-          name: "path",
-          value: "src/footer.ts"
-        },
-        {
-          name: "operations",
-          value: {
-            search: END_OF_FILE,
-            replace: "\n// End of file appended comment\n"
-          }
-        }
-      ]
-    }
-  ],
-  permissionLevel: 2 /* Write */
-};
-var handler14 = async (provider, args) => {
-  if (!provider.readFile || !provider.writeFile) {
-    return {
-      type: "Error" /* Error */,
-      message: "Not possible to edit file. Abort."
-    };
-  }
-  const path = getString(args, "path");
-  const operations = getArray(args, "operations");
-  if (!operations || operations.length === 0) {
-    return {
-      type: "Error" /* Error */,
-      message: `<error><edit_file_path>${path}</edit_file_path><error_message>At least one edit operation is required</error_message></error>`
-    };
-  }
-  const fileContent = await provider.readFile(path);
-  if (fileContent == null) {
-    return {
-      type: "Error" /* Error */,
-      message: `<error><edit_file_path>${path}</edit_file_path><error_message>File not found</error_message></error>`
-    };
-  }
-  try {
-    const result = await editFile(fileContent, operations);
-    await provider.writeFile(path, result);
-    return {
-      type: "Reply" /* Reply */,
-      message: `<edit_file_path>${path}</edit_file_path>`
-    };
-  } catch (error) {
-    return {
-      type: "Error" /* Error */,
-      message: `<error><edit_file_path>${path}</edit_file_path><error_message>${error instanceof Error ? error.message : String(error)}</error_message></error>`
-    };
-  }
-};
-var isAvailable14 = (provider) => {
-  return !!provider.readFile && !!provider.writeFile;
-};
-var editFile_default = {
-  ...toolInfo14,
-  handler: handler14,
-  isAvailable: isAvailable14
-};
-
 // src/getAvailableTools.ts
 var getAvailableTools = ({
   provider,
@@ -2623,6 +2555,8 @@ Tool use is formatted using XML-style tags. The tool name is enclosed in opening
 ...
 </${toolNamePrefix}tool_name>
 
+**It is crucial that all tags are correctly nested and closed.**
+
 ## Array Parameters
 
 To create an array of values for a parameter, repeat the parameter tag multiple times:
@@ -2657,7 +2591,7 @@ You can also combine array parameters with nested objects:
 </${parameterPrefix}key>
 </${toolNamePrefix}example_tool>
 
-Always adhere to this format for the tool use to ensure proper parsing and execution.
+Always adhere to this format, ensuring every opening tag has a matching closing tag, to ensure proper parsing and execution.
 
 NEVER surround tool use with triple backticks (\`\`\`).
 
@@ -3009,8 +2943,8 @@ ${instance.prompt}`;
   }
   async #invokeTool(name, args) {
     try {
-      const handler15 = this.handlers[name]?.handler;
-      if (!handler15) {
+      const handler14 = this.handlers[name]?.handler;
+      if (!handler14) {
         return {
           type: "Error" /* Error */,
           message: responsePrompts.errorInvokeTool(name, "Tool not found"),
@@ -3029,7 +2963,7 @@ ${instance.prompt}`;
       if (resp) {
         return resp;
       }
-      return await handler15(this.config.provider, args);
+      return await handler14(this.config.provider, args);
     } catch (error) {
       return {
         type: "Error" /* Error */,
@@ -3387,7 +3321,7 @@ var editingFilesPrompt = (toolNamePrefix) => `
 
 EDITING FILES
 
-You have two file-manipulation tools: **${toolNamePrefix}write_to_file** (full overwrite) and **${toolNamePrefix}edit_file** (targeted anchor-based edits). Choose the smallest safe operation for every change.
+You have two file-manipulation tools: **${toolNamePrefix}write_to_file** (full overwrite) and **${toolNamePrefix}replace_in_file** (targeted anchor-based edits). Choose the smallest safe operation for every change.
 
 # ${toolNamePrefix}write_to_file
 
@@ -3399,16 +3333,16 @@ You have two file-manipulation tools: **${toolNamePrefix}write_to_file** (full o
 
 - Initial file creation, such as when scaffolding a new project.
 - Overwriting large boilerplate files where you want to replace the entire content at once.
-- When the complexity or number of changes would make ${toolNamePrefix}edit_file unwieldy or error-prone.
+- When the complexity or number of changes would make ${toolNamePrefix}replace_in_file unwieldy or error-prone.
 - When you need to completely restructure a file's content or change its fundamental organization.
 
 ## Important Considerations
 
 - Using ${toolNamePrefix}write_to_file requires providing the file's complete final content.
-- If you only need to make small changes to an existing file, consider using ${toolNamePrefix}edit_file instead to avoid unnecessarily rewriting the entire file.
+- If you only need to make small changes to an existing file, consider using ${toolNamePrefix}replace_in_file instead to avoid unnecessarily rewriting the entire file.
 - While ${toolNamePrefix}write_to_file should not be your default choice, don't hesitate to use it when the situation truly calls for it.
 
-# ${toolNamePrefix}edit_file
+# ${toolNamePrefix}replace_in_file
 
 ## Purpose
 
@@ -3427,10 +3361,10 @@ You have two file-manipulation tools: **${toolNamePrefix}write_to_file** (full o
 
 # Choosing the Appropriate Tool
 
-- **Default to ${toolNamePrefix}edit_file** for most changes. It keeps diffs small and reduces risk.
+- **Default to ${toolNamePrefix}replace_in_file** for most changes. It keeps diffs small and reduces risk.
 - **Use ${toolNamePrefix}write_to_file** when:
   - Creating new files
-  - The changes are so extensive that using ${toolNamePrefix}edit_file would be more complex or risky
+  - The changes are so extensive that using ${toolNamePrefix}replace_in_file would be more complex or risky
   - You need to completely reorganize or restructure a file
   - The file is relatively small and the changes affect most of its content
   - You're generating boilerplate or template files
@@ -3438,9 +3372,9 @@ You have two file-manipulation tools: **${toolNamePrefix}write_to_file** (full o
 # Workflow Tips
 
 1. Before editing, assess the scope of your changes and decide which tool to use.
-2. For targeted edits, apply ${toolNamePrefix}edit_file with carefully crafted before/after text anchors. If you need multiple changes, you can stack multiple operations within a single ${toolNamePrefix}edit_file call.
+2. For targeted edits, apply ${toolNamePrefix}replace_in_file with carefully crafted before/after text anchors. If you need multiple changes, you can stack multiple operations within a single ${toolNamePrefix}replace_in_file call.
 3. For major overhauls or initial file creation, rely on ${toolNamePrefix}write_to_file.
-4. Once the file has been edited with either ${toolNamePrefix}write_to_file or ${toolNamePrefix}edit_file, the system will provide you with the final state of the modified file. Use this updated content as the reference point for any subsequent operations, since it reflects any auto-formatting or user-applied changes.
+4. Once the file has been edited with either ${toolNamePrefix}write_to_file or ${toolNamePrefix}replace_in_file, the system will provide you with the final state of the modified file. Use this updated content as the reference point for any subsequent operations, since it reflects any auto-formatting or user-applied changes.
 
 Picking the right tool keeps edits minimal, safe, and easy to review.
 `;
@@ -3454,10 +3388,10 @@ RULES
   For text files (e.g. README.md), append a footer with the same notice.
 - Never describe what changed inside code comments; comments must focus on purpose or usage only.
 - Before using ${toolNamePrefix}execute_command, consider SYSTEM INFORMATION to ensure commands suit the user's OS. If a command must run in a subdirectory, prepend a single \`cd childDir &&\` segment.
-- Use ${toolNamePrefix}search_files for broad analysis, then ${toolNamePrefix}read_file to inspect context, and finally ${toolNamePrefix}edit_file or ${toolNamePrefix}write_to_file to modify.
-- Prefer ${toolNamePrefix}edit_file for focused edits; choose ${toolNamePrefix}write_to_file for new files or complete rewrites.
+- Use ${toolNamePrefix}search_files for broad analysis, then ${toolNamePrefix}read_file to inspect context, and finally ${toolNamePrefix}replace_in_file or ${toolNamePrefix}write_to_file to modify.
+- Prefer ${toolNamePrefix}replace_in_file for focused edits; choose ${toolNamePrefix}write_to_file for new files or complete rewrites.
 - When creating a new file, look for existing files with similar content or patterns; if found, read them and use their structure or conventions as a reference.
-- Use before/after text anchors in ${toolNamePrefix}edit_file to target changes. If multiple operations are needed, list them in file order.
+- Use before/after text anchors in ${toolNamePrefix}replace_in_file to target changes. If multiple operations are needed, list them in file order.
 - Do not guess unseen content. Read existing files first unless creating new ones.
 - Follow existing style, lint, and naming conventions. Ensure all changes compile and pass tests where applicable.
 - ALWAYS wait for the user's confirmation after each tool call before starting the next step.
@@ -3662,9 +3596,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({
@@ -3828,7 +3759,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);
@@ -4356,8 +4287,6 @@ export {
   deepSeekModels,
   defaultModels,
   delegate_default as delegate,
-  editFile_default as editFile,
-  editFile as editFileHelper,
   executeAgentTool,
   executeCommand_default as executeCommand,
   executeTool,

package/package.json

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