@cdoing/core 0.1.0

package/dist/tools/codebase-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-search.d.ts","sourceRoot":"","sources":["../../src/tools/codebase-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGpE,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,UAAU,EAAE,cAAc,CA+BxB;IAEF,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA8B;gBAEtC,UAAU,EAAE,MAAM;IAIxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YA0CpD,WAAW;CAsB1B"}

package/dist/tools/codebase-search.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Codebase Search Tool — semantic + full-text search across the indexed codebase.
+ *
+ * Uses the indexing system (SQLite FTS5 + optional embeddings) for fast,
+ * ranked code retrieval. Falls back to runtime grep if index not available.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseSearchTool = void 0;
+const indexing_1 = require("../indexing");
+class CodebaseSearchTool {
+    definition = {
+        name: "codebase_search",
+        description: `Search the entire codebase using natural language or keywords. Uses indexed full-text search (BM25) and optional semantic search (embeddings) for fast, ranked results.
+
+The codebase is automatically indexed on first use. Results include file paths, line numbers, and matching code snippets ranked by relevance.
+
+Use this for:
+- Finding where a concept is implemented ("authentication middleware")
+- Locating function/class definitions ("UserService class")
+- Understanding how something works ("how errors are handled")
+- Finding usage patterns ("all places that call sendEmail")`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language query or keywords to search for",
+                },
+                directory: {
+                    type: "string",
+                    description: "Optional: limit search to a subdirectory (e.g. 'src/api')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return. Default: 20.",
+                },
+            },
+            required: ["query"],
+        },
+        requiresPermission: false,
+    };
+    indexer = null;
+    workingDir;
+    indexPromise = null;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    async execute(input) {
+        const query = input.query;
+        const directory = input.directory;
+        const limit = input.limit || 20;
+        if (!query.trim()) {
+            return { success: false, output: "", error: "Query cannot be empty" };
+        }
+        // Ensure index exists (lazy initialization)
+        try {
+            await this.ensureIndex();
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Indexing failed: ${err.message}` };
+        }
+        if (!this.indexer) {
+            return { success: false, output: "", error: "Indexer not available" };
+        }
+        // Search
+        const results = await this.indexer.search(query, limit, directory);
+        if (results.length === 0) {
+            return { success: true, output: `No results found for: "${query}"` };
+        }
+        // Format results
+        const formatted = results.map((r, i) => {
+            const header = `### ${i + 1}. ${r.path}:${r.startLine}-${r.endLine} (${r.source}, score: ${r.score.toFixed(3)})`;
+            const content = r.content.length > 500
+                ? r.content.substring(0, 500) + "\n... [truncated]"
+                : r.content;
+            return `${header}\n\`\`\`\n${content}\n\`\`\``;
+        });
+        const stats = this.indexer.getStats();
+        const header = `Found ${results.length} results for "${query}" (searched ${stats.totalChunks} chunks across ${stats.totalFiles} files)`;
+        return { success: true, output: `${header}\n\n${formatted.join("\n\n")}` };
+    }
+    async ensureIndex() {
+        if (this.indexer)
+            return;
+        // Prevent concurrent indexing
+        if (this.indexPromise) {
+            await this.indexPromise;
+            return;
+        }
+        this.indexPromise = (async () => {
+            this.indexer = new indexing_1.CodebaseIndexer(this.workingDir);
+            const stats = this.indexer.getStats();
+            // If index is empty or stale (>1 hour), re-index
+            const oneHour = 60 * 60 * 1000;
+            if (stats.totalFiles === 0 || Date.now() - stats.lastIndexed > oneHour) {
+                await this.indexer.index();
+            }
+        })();
+        await this.indexPromise;
+    }
+}
+exports.CodebaseSearchTool = CodebaseSearchTool;
+//# sourceMappingURL=codebase-search.js.map

package/dist/tools/codebase-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-search.js","sourceRoot":"","sources":["../../src/tools/codebase-search.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,0CAA8C;AAE9C,MAAa,kBAAkB;IAC7B,UAAU,GAAmB;QAC3B,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT;;;;;;;;4DAQsD;QACxD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,kBAAkB,EAAE,KAAK;KAC1B,CAAC;IAEM,OAAO,GAA2B,IAAI,CAAC;IACvC,UAAU,CAAS;IACnB,YAAY,GAAyB,IAAI,CAAC;IAElD,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAe,CAAC;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,SAA+B,CAAC;QACxD,MAAM,KAAK,GAAI,KAAK,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE5C,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACxE,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,oBAAqB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACxE,CAAC;QAED,SAAS;QACT,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAEnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,KAAK,GAAG,EAAE,CAAC;QACvE,CAAC;QAED,iBAAiB;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACjH,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;gBACpC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,mBAAmB;gBACnD,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACd,OAAO,GAAG,MAAM,aAAa,OAAO,UAAU,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,SAAS,OAAO,CAAC,MAAM,iBAAiB,KAAK,eAAe,KAAK,CAAC,WAAW,kBAAkB,KAAK,CAAC,UAAU,SAAS,CAAC;QAExI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IAC7E,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,8BAA8B;QAC9B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,YAAY,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,0BAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAEtC,iDAAiD;YACjD,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAC/B,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,GAAG,OAAO,EAAE,CAAC;gBACvE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;CACF;AA1GD,gDA0GC"}

package/dist/tools/file-delete.d.ts

@@ -0,0 +1,26 @@
+/**
+ * File Delete Tool — permission-controlled file/directory deletion.
+ *
+ * Unlike raw `rm` via shell_exec, this tool:
+ *   - Goes through the permission system (Delete category — can be allow/deny/ask via settings)
+ *   - Checks sandbox write rules before deletion
+ *   - Reports what will be deleted (file count for directories)
+ *   - Requires explicit recursive flag for directories
+ *   - Requires force flag for large directories (>50 items)
+ *
+ * Users can control deletion via settings rules:
+ *   - Delete         → allow/deny all file deletions
+ *   - Delete(path)   → allow/deny deletion of specific paths
+ *   - Delete(*.log)  → allow/deny deletion by pattern
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SandboxManager } from "../sandbox";
+export declare class FileDeleteTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    private sandboxManager?;
+    constructor(workingDir: string, sandboxManager?: SandboxManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    private countItems;
+}
+//# sourceMappingURL=file-delete.d.ts.map

package/dist/tools/file-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-delete.d.ts","sourceRoot":"","sources":["../../src/tools/file-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,qBAAa,cAAe,YAAW,QAAQ;IAC7C,UAAU,EAAE,cAAc,CA2BxB;IAEF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc;IAKzD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA2ElE,OAAO,CAAC,UAAU;CAiBnB"}

package/dist/tools/file-delete.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * File Delete Tool — permission-controlled file/directory deletion.
+ *
+ * Unlike raw `rm` via shell_exec, this tool:
+ *   - Goes through the permission system (Delete category — can be allow/deny/ask via settings)
+ *   - Checks sandbox write rules before deletion
+ *   - Reports what will be deleted (file count for directories)
+ *   - Requires explicit recursive flag for directories
+ *   - Requires force flag for large directories (>50 items)
+ *
+ * Users can control deletion via settings rules:
+ *   - Delete         → allow/deny all file deletions
+ *   - Delete(path)   → allow/deny deletion of specific paths
+ *   - Delete(*.log)  → allow/deny deletion by pattern
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDeleteTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const path_safety_1 = require("../utils/path-safety");
+const MAX_DIR_FILES = 50;
+class FileDeleteTool {
+    definition = {
+        name: "file_delete",
+        description: `Delete a file or directory. You can also use shell_exec with rm/del for simple deletions if preferred.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Path to the file or directory to delete",
+                },
+                recursive: {
+                    type: "boolean",
+                    description: "Required for directory deletion. Deletes all contents. Default: false.",
+                },
+                force: {
+                    type: "boolean",
+                    description: "Required for directories with more than 50 items. Default: false.",
+                },
+            },
+            required: ["file_path"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => {
+            const recursive = input.recursive ? " (recursive)" : "";
+            return `Delete${recursive}: ${input.file_path}`;
+        },
+    };
+    workingDir;
+    sandboxManager;
+    constructor(workingDir, sandboxManager) {
+        this.workingDir = workingDir;
+        this.sandboxManager = sandboxManager;
+    }
+    async execute(input) {
+        let filePath;
+        try {
+            filePath = (0, path_safety_1.safePath)(input.file_path, this.workingDir);
+        }
+        catch (err) {
+            return { success: false, output: "", error: err.message };
+        }
+        const recursive = input.recursive || false;
+        const force = input.force || false;
+        // Sandbox write check (deletion requires write access to parent)
+        if (this.sandboxManager) {
+            const check = this.sandboxManager.checkFileWrite(filePath);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: delete access denied" };
+            }
+        }
+        // Existence check
+        if (!fs.existsSync(filePath)) {
+            return { success: false, output: "", error: `Path not found: ${filePath}` };
+        }
+        const stat = fs.statSync(filePath);
+        // ── File deletion ─────────────────────────────────────────────────────────
+        if (stat.isFile() || stat.isSymbolicLink()) {
+            try {
+                fs.unlinkSync(filePath);
+                return { success: true, output: `Deleted file: ${filePath}` };
+            }
+            catch (err) {
+                return { success: false, output: "", error: `Failed to delete: ${err.message}` };
+            }
+        }
+        // ── Directory deletion ────────────────────────────────────────────────────
+        if (!stat.isDirectory()) {
+            return { success: false, output: "", error: `Unsupported file type at: ${filePath}` };
+        }
+        if (!recursive) {
+            // Show what's inside so the user can make an informed decision
+            const entries = fs.readdirSync(filePath);
+            const preview = entries.slice(0, 10).join(", ");
+            const more = entries.length > 10 ? ` ... and ${entries.length - 10} more` : "";
+            return {
+                success: false,
+                output: "",
+                error: `"${filePath}" is a directory with ${entries.length} items (${preview}${more}). Set recursive=true to delete it and all its contents.`,
+            };
+        }
+        // Count files before deleting
+        const fileCount = this.countItems(filePath);
+        if (fileCount > MAX_DIR_FILES && !force) {
+            return {
+                success: false,
+                output: "",
+                error: `Directory contains ${fileCount} items. Set force=true to confirm bulk deletion of "${filePath}".`,
+            };
+        }
+        try {
+            fs.rmSync(filePath, { recursive: true, force: true });
+            return {
+                success: true,
+                output: `Deleted directory: ${filePath} (${fileCount} items removed)`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Failed to delete directory: ${err.message}` };
+        }
+    }
+    countItems(dirPath, limit = 10000) {
+        let count = 0;
+        try {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                count++;
+                if (count >= limit)
+                    return count;
+                if (entry.isDirectory()) {
+                    count += this.countItems(path.join(dirPath, entry.name), limit - count);
+                    if (count >= limit)
+                        return count;
+                }
+            }
+        }
+        catch {
+            // Permission denied — count what we can
+        }
+        return count;
+    }
+}
+exports.FileDeleteTool = FileDeleteTool;
+//# sourceMappingURL=file-delete.js.map

package/dist/tools/file-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-delete.js","sourceRoot":"","sources":["../../src/tools/file-delete.ts"],"names":[],"mappings":"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"}

package/dist/tools/file-edit.d.ts

@@ -0,0 +1,10 @@
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SandboxManager } from "../sandbox";
+export declare class FileEditTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    private sandboxManager?;
+    constructor(workingDir: string, sandboxManager?: SandboxManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-edit.d.ts.map

package/dist/tools/file-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.d.ts","sourceRoot":"","sources":["../../src/tools/file-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,UAAU,EAAE,cAAc,CAyBxB;IAEF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc;IAKzD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAsDnE"}

package/dist/tools/file-edit.js

@@ -0,0 +1,138 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileEditTool = void 0;
+const fs = __importStar(require("fs"));
+const path_safety_1 = require("../utils/path-safety");
+const search_match_1 = require("../utils/search-match");
+const lazy_apply_1 = require("../utils/lazy-apply");
+class FileEditTool {
+    definition = {
+        name: "file_edit",
+        description: `Performs string replacement in a file using multi-strategy matching (exact → trimmed → case-insensitive → whitespace-ignored). Also supports unified diff patches. Requires user permission. Access controlled by sandbox/permission rules.
+
+IMPORTANT:
+- Always read the file first before editing to see its current contents.
+- old_string should match the file content — the system tolerates minor whitespace/case differences.
+- old_string and new_string MUST be different.
+- When not using replace_all, old_string must be unique in the file. Add more surrounding context if ambiguous.
+- Use replace_all for renaming variables or strings across the file.
+- You can pass a unified diff (with @@ hunk headers) as old_string and leave new_string empty to apply the diff patch directly.
+- This tool CANNOT be called in parallel with itself on the SAME file.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: { type: "string", description: "Path to the file to edit" },
+                old_string: { type: "string", description: "The text to replace — must match file content (exact match preferred, but tolerates whitespace/case differences)" },
+                new_string: { type: "string", description: "The replacement text (MUST be different from old_string)" },
+                replace_all: { type: "boolean", description: "Replace all occurrences (default: false)" },
+            },
+            required: ["file_path", "old_string", "new_string"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => `Edit file: ${input.file_path}`,
+    };
+    workingDir;
+    sandboxManager;
+    constructor(workingDir, sandboxManager) {
+        this.workingDir = workingDir;
+        this.sandboxManager = sandboxManager;
+    }
+    async execute(input) {
+        let filePath;
+        try {
+            filePath = (0, path_safety_1.safePath)(input.file_path, this.workingDir);
+        }
+        catch (err) {
+            return { success: false, output: "", error: err.message };
+        }
+        // Sandbox write check
+        if (this.sandboxManager) {
+            const check = this.sandboxManager.checkFileWrite(filePath);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: write access denied" };
+            }
+        }
+        const oldStr = input.old_string;
+        const newStr = input.new_string;
+        const replaceAll = input.replace_all || false;
+        if (!fs.existsSync(filePath))
+            return { success: false, output: "", error: `File not found: ${filePath}` };
+        const content = fs.readFileSync(filePath, "utf-8");
+        try {
+            // Unified diff mode: detect @@ hunk headers in old_string
+            if ((0, search_match_1.isUnifiedDiff)(oldStr)) {
+                const result = (0, search_match_1.applyUnifiedDiff)(content, oldStr);
+                fs.writeFileSync(filePath, result, "utf-8");
+                return { success: true, output: `Applied unified diff patch to ${filePath}\n\n${oldStr}` };
+            }
+            // Lazy apply: expand placeholder markers in new_string before replacing
+            let expandedNewStr = newStr;
+            let lazyNote = "";
+            if ((0, lazy_apply_1.hasPlaceholders)(newStr)) {
+                const { content: expanded, placeholdersExpanded, strategy: lazyStrategy } = (0, lazy_apply_1.expandPlaceholders)(content, newStr);
+                if (placeholdersExpanded > 0) {
+                    expandedNewStr = expanded;
+                    lazyNote = ` (lazy apply: ${placeholdersExpanded} placeholder(s) expanded via ${lazyStrategy})`;
+                }
+            }
+            const { result, count, strategy } = (0, search_match_1.executeFindAndReplace)(content, oldStr, expandedNewStr, replaceAll);
+            fs.writeFileSync(filePath, result, "utf-8");
+            const diff = generateDiff(filePath, oldStr, expandedNewStr, count);
+            const strategyNote = strategy !== "exact" ? ` (matched via ${strategy} strategy)` : "";
+            return { success: true, output: `Edited ${filePath}: replaced ${count} occurrence(s)${strategyNote}${lazyNote}\n\n${diff}` };
+        }
+        catch (err) {
+            return { success: false, output: "", error: err.message };
+        }
+    }
+}
+exports.FileEditTool = FileEditTool;
+/** Generate a unified-style diff showing what changed */
+function generateDiff(filePath, oldStr, newStr, count) {
+    const oldLines = oldStr.split("\n");
+    const newLines = newStr.split("\n");
+    const parts = [
+        `--- a/${filePath}`,
+        `+++ b/${filePath}`,
+        `@@ -1,${oldLines.length} +1,${newLines.length} @@ (${count} replacement${count > 1 ? "s" : ""})`,
+    ];
+    for (const line of oldLines)
+        parts.push(`- ${line}`);
+    for (const line of newLines)
+        parts.push(`+ ${line}`);
+    return parts.join("\n");
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/tools/file-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.js","sourceRoot":"","sources":["../../src/tools/file-edit.ts"],"names":[],"mappings":"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"}

package/dist/tools/file-read.d.ts

@@ -0,0 +1,12 @@
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SandboxManager } from "../sandbox";
+export declare class FileReadTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    private sandboxManager?;
+    constructor(workingDir: string, sandboxManager?: SandboxManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    private readImage;
+    private readPdf;
+}
+//# sourceMappingURL=file-read.d.ts.map

package/dist/tools/file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../src/tools/file-read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,UAAU,EAAE,cAAc,CAuBxB;IAEF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc;IAKzD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA8DlE,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,OAAO;CA6BhB"}