@cdoing/core 0.1.0

package/dist/tools/file-read.js

@@ -0,0 +1,211 @@
+"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.FileReadTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const path_safety_1 = require("../utils/path-safety");
+/** Binary/image extensions we can describe but not read as text */
+const IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".webp", ".svg", ".ico"]);
+const PDF_EXTENSION = ".pdf";
+class FileReadTool {
+    definition = {
+        name: "file_read",
+        description: "Read the contents of a file. Returns content with line numbers. Supports text files, images (returns metadata), and PDFs (extracts text). Always read before editing. Access is governed by the permission system — certain paths may be denied by sandbox or permission rules.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Path to the file to read",
+                },
+                offset: {
+                    type: "number",
+                    description: "Line number to start from (1-based). Optional.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max lines to read. Default: 2000.",
+                },
+            },
+            required: ["file_path"],
+        },
+        requiresPermission: false,
+    };
+    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 read check
+        if (this.sandboxManager) {
+            const check = this.sandboxManager.checkFileRead(filePath);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: read access denied" };
+            }
+        }
+        if (!fs.existsSync(filePath))
+            return { success: false, output: "", error: `File not found: ${filePath}` };
+        if (fs.statSync(filePath).isDirectory())
+            return { success: false, output: "", error: `Path is a directory: ${filePath}` };
+        const ext = path.extname(filePath).toLowerCase();
+        // Handle image files
+        if (IMAGE_EXTENSIONS.has(ext)) {
+            return this.readImage(filePath, ext);
+        }
+        // Handle PDF files
+        if (ext === PDF_EXTENSION) {
+            return this.readPdf(filePath);
+        }
+        // Regular text file
+        const offset = input.offset || 1;
+        const limit = input.limit || 2000;
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            const lines = content.split("\n");
+            const selected = lines.slice(offset - 1, offset - 1 + limit);
+            const numbered = selected
+                .map((line, i) => `${String(offset + i).padStart(5)}  ${line}`)
+                .join("\n");
+            const totalLines = lines.length;
+            const showing = selected.length;
+            const info = totalLines > showing
+                ? `\n\n[Showing lines ${offset}-${offset + showing - 1} of ${totalLines}]`
+                : "";
+            return { success: true, output: (numbered || "(empty file)") + info };
+        }
+        catch {
+            // Might be a binary file
+            const stat = fs.statSync(filePath);
+            return {
+                success: true,
+                output: `Binary file: ${filePath} (${formatBytes(stat.size)})`,
+            };
+        }
+    }
+    readImage(filePath, ext) {
+        const stat = fs.statSync(filePath);
+        const info = [
+            `Image file: ${filePath}`,
+            `Format: ${ext.substring(1).toUpperCase()}`,
+            `Size: ${formatBytes(stat.size)}`,
+        ];
+        // For SVG, we can actually read the content
+        if (ext === ".svg") {
+            try {
+                const content = fs.readFileSync(filePath, "utf-8");
+                info.push(`\nSVG Content:\n${content.substring(0, 5000)}`);
+                if (content.length > 5000)
+                    info.push(`\n... [truncated at 5000 chars]`);
+            }
+            catch {
+                // skip
+            }
+        }
+        return { success: true, output: info.join("\n") };
+    }
+    readPdf(filePath) {
+        const stat = fs.statSync(filePath);
+        // Basic PDF text extraction — reads raw text strings from PDF
+        try {
+            const buffer = fs.readFileSync(filePath);
+            const text = extractPdfText(buffer);
+            if (text.trim()) {
+                const truncated = text.length > 10000
+                    ? text.substring(0, 10000) + "\n\n... [truncated at 10000 chars]"
+                    : text;
+                return {
+                    success: true,
+                    output: `PDF: ${filePath} (${formatBytes(stat.size)})\n\n${truncated}`,
+                };
+            }
+            return {
+                success: true,
+                output: `PDF: ${filePath} (${formatBytes(stat.size)})\n(Could not extract text — may be image-based or encrypted)`,
+            };
+        }
+        catch {
+            return {
+                success: true,
+                output: `PDF: ${filePath} (${formatBytes(stat.size)})\n(Unable to read PDF content)`,
+            };
+        }
+    }
+}
+exports.FileReadTool = FileReadTool;
+/** Very basic PDF text extraction — finds text between parentheses in PDF stream */
+function extractPdfText(buffer) {
+    const content = buffer.toString("latin1");
+    const textParts = [];
+    // Extract text from Tj and TJ operators (basic PDF text rendering)
+    const tjRegex = /\(([^)]*)\)\s*Tj/g;
+    let match;
+    while ((match = tjRegex.exec(content)) !== null) {
+        const decoded = match[1]
+            .replace(/\\n/g, "\n")
+            .replace(/\\r/g, "\r")
+            .replace(/\\t/g, "\t")
+            .replace(/\\\\/g, "\\")
+            .replace(/\\([()])/g, "$1");
+        textParts.push(decoded);
+    }
+    // Also try TJ arrays
+    const tjArrayRegex = /\[((?:\([^)]*\)|[^\]])*)\]\s*TJ/gi;
+    while ((match = tjArrayRegex.exec(content)) !== null) {
+        const innerRegex = /\(([^)]*)\)/g;
+        let inner;
+        while ((inner = innerRegex.exec(match[1])) !== null) {
+            textParts.push(inner[1]);
+        }
+    }
+    return textParts.join(" ").replace(/\s+/g, " ").trim();
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=file-read.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-run.d.ts","sourceRoot":"","sources":["../../src/tools/file-run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,qBAAa,WAAY,YAAW,QAAQ;IAC1C,UAAU,EAAE,cAAc,CAwBxB;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;CAoGnE"}

package/dist/tools/file-run.js

@@ -0,0 +1,179 @@
+"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.FileRunTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const path_safety_1 = require("../utils/path-safety");
+const IS_WINDOWS = os.platform() === "win32";
+const SHELL = IS_WINDOWS ? "powershell.exe" : process.env.SHELL || "/bin/sh";
+/** Map file extensions to the command that runs them */
+const RUNNERS = {
+    ".js": "node", ".mjs": "node", ".cjs": "node",
+    ".ts": "npx ts-node", ".tsx": "npx ts-node",
+    ".py": IS_WINDOWS ? "python" : "python3", ".rb": "ruby",
+    ".sh": "bash", ".bash": "bash", ".zsh": "zsh",
+    ".bat": "cmd /c", ".cmd": "cmd /c", ".ps1": "powershell -File",
+    ".go": "go run", ".swift": "swift", ".lua": "lua",
+    ".php": "php", ".pl": "perl",
+};
+class FileRunTool {
+    definition = {
+        name: "file_run",
+        description: "Run a file. Auto-detects language from extension (node for .js, python3 for .py, etc). Use after writing a program to test it. Requires user permission. Subject to sandbox restrictions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: { type: "string", description: "Path to the file to run" },
+                args: { type: "string", description: "Command-line arguments (optional)" },
+                timeout: { type: "number", description: "Timeout in ms. Default: 30000" },
+                env_vars: {
+                    type: "object",
+                    description: "Environment variables to set (e.g., {\"PORT\": \"3001\", \"NODE_ENV\": \"test\"})",
+                    additionalProperties: { type: "string" },
+                },
+                debug: {
+                    type: "boolean",
+                    description: "Enable debug/verbose mode. Sets DEBUG=*, NODE_DEBUG=*, RUST_BACKTRACE=1, PYTHONTRACEBACK=1. Default: false",
+                },
+            },
+            required: ["file_path"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => `Run 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 };
+        }
+        const args = input.args || "";
+        const timeout = input.timeout || 30000;
+        // Sandbox read check
+        if (this.sandboxManager) {
+            const check = this.sandboxManager.checkFileRead(filePath);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: read access denied" };
+            }
+        }
+        if (!fs.existsSync(filePath))
+            return { success: false, output: "", error: `File not found: ${filePath}` };
+        const ext = path.extname(filePath).toLowerCase();
+        const runner = RUNNERS[ext];
+        if (!runner)
+            return { success: false, output: "", error: `Can't run ${ext} files. Supported: ${Object.keys(RUNNERS).join(", ")}` };
+        const command = `${runner} "${filePath}"${args ? ` ${args}` : ""}`;
+        // Build environment
+        const env = this.sandboxManager ? this.sandboxManager.getShellEnv() : { ...process.env };
+        // Merge user-provided env vars
+        const envVars = input.env_vars;
+        if (envVars && typeof envVars === "object") {
+            for (const [key, val] of Object.entries(envVars)) {
+                env[key] = String(val);
+            }
+        }
+        // Debug mode — set common debug env vars
+        if (input.debug) {
+            env.DEBUG = env.DEBUG || "*";
+            env.NODE_DEBUG = env.NODE_DEBUG || "*";
+            env.RUST_BACKTRACE = env.RUST_BACKTRACE || "1";
+            env.PYTHONTRACEBACK = env.PYTHONTRACEBACK || "1";
+            env.PYTHONFAULTHANDLER = env.PYTHONFAULTHANDLER || "1";
+        }
+        return new Promise((resolve) => {
+            const child = (0, child_process_1.exec)(command, { cwd: this.workingDir, timeout, maxBuffer: 10 * 1024 * 1024, env, shell: SHELL }, (error, stdout, stderr) => {
+                const outputParts = [];
+                if (stdout)
+                    outputParts.push(stdout.trimEnd());
+                if (stderr) {
+                    // Filter out common non-error warnings
+                    const filteredStderr = stderr.split("\n")
+                        .filter((l) => !l.includes("DeprecationWarning") && !l.includes("ExperimentalWarning"))
+                        .join("\n").trim();
+                    if (filteredStderr)
+                        outputParts.push(`STDERR:\n${filteredStderr}`);
+                }
+                const output = outputParts.join("\n\n") || "(no output)";
+                if (error?.killed) {
+                    // Timed out — but if we got output, it's likely a server/long-running process
+                    // Treat as success with note, not as an error
+                    if (output && output !== "(no output)") {
+                        resolve({
+                            success: true,
+                            output: output + `\n\n[Process timed out after ${timeout / 1000}s — this is normal for servers and long-running processes. The output above was captured before timeout. Use shell_exec instead if you need to start a server in the background.]`,
+                        });
+                    }
+                    else {
+                        resolve({ success: false, output, error: `Timed out after ${timeout}ms with no output` });
+                    }
+                    return;
+                }
+                if (error) {
+                    resolve({ success: false, output, error: `Exit code: ${error.code}` });
+                }
+                else {
+                    resolve({ success: true, output });
+                }
+            });
+            // For server-like processes: if we get output early, don't wait for timeout
+            // Kill after 5s if stdout has content (server started successfully)
+            let earlyOutput = "";
+            child.stdout?.on("data", (chunk) => {
+                earlyOutput += chunk;
+                // If output contains typical server-started messages, kill early
+                if (/listening|started|running|ready|server/i.test(earlyOutput)) {
+                    setTimeout(() => {
+                        if (!child.killed) {
+                            child.kill("SIGTERM");
+                        }
+                    }, 2000); // Give 2s for any additional startup output
+                }
+            });
+        });
+    }
+}
+exports.FileRunTool = FileRunTool;
+//# sourceMappingURL=file-run.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../../src/tools/file-write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,UAAU,EAAE,cAAc,CA0BxB;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;CA2DnE"}

package/dist/tools/file-write.js

@@ -0,0 +1,134 @@
+"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.FileWriteTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const path_safety_1 = require("../utils/path-safety");
+const lazy_apply_1 = require("../utils/lazy-apply");
+class FileWriteTool {
+    definition = {
+        name: "file_write",
+        description: `Create a new file or completely overwrite an existing file. Creates parent directories if needed. Requires user permission.
+
+Use this tool ONLY for:
+- Creating new files that don't exist yet
+- Complete file rewrites where the entire content changes
+
+Do NOT use this for partial edits — use file_edit or multi_edit instead, which preserve unchanged code and provide diffs.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Path to the file to write",
+                },
+                content: {
+                    type: "string",
+                    description: "Content to write to the file",
+                },
+            },
+            required: ["file_path", "content"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => `Write to 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" };
+            }
+        }
+        let content = input.content;
+        try {
+            const dir = path.dirname(filePath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            const existed = fs.existsSync(filePath);
+            const oldContent = existed ? fs.readFileSync(filePath, "utf-8") : "";
+            // Lazy apply: if content has placeholders and file exists, expand them
+            if (existed && (0, lazy_apply_1.hasPlaceholders)(content)) {
+                const { content: expanded, placeholdersExpanded } = (0, lazy_apply_1.expandPlaceholders)(oldContent, content);
+                if (placeholdersExpanded > 0) {
+                    content = expanded;
+                }
+            }
+            fs.writeFileSync(filePath, content, "utf-8");
+            const lines = content.split("\n").length;
+            // Generate diff for the extension to render
+            let diff = "";
+            if (existed && oldContent !== content) {
+                const oldLines = oldContent.split("\n");
+                const newLines = content.split("\n");
+                diff = `--- a/${input.file_path}\n+++ b/${input.file_path}\n@@ -1,${oldLines.length} +1,${newLines.length} @@\n`;
+                for (const line of oldLines)
+                    diff += `- ${line}\n`;
+                for (const line of newLines)
+                    diff += `+ ${line}\n`;
+            }
+            else if (!existed) {
+                const newLines = content.split("\n");
+                diff = `--- /dev/null\n+++ b/${input.file_path}\n@@ -0,0 +1,${newLines.length} @@\n`;
+                for (const line of newLines)
+                    diff += `+ ${line}\n`;
+            }
+            const summary = `${existed ? "Updated" : "Created"} file: ${filePath} (${lines} lines)`;
+            return {
+                success: true,
+                output: diff ? `${summary}\n\n${diff}` : summary,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Failed to write: ${err}` };
+        }
+    }
+}
+exports.FileWriteTool = FileWriteTool;
+//# sourceMappingURL=file-write.js.map

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

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

package/dist/tools/glob-search.d.ts

@@ -0,0 +1,8 @@
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+export declare class GlobSearchTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    constructor(workingDir: string);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=glob-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glob-search.d.ts","sourceRoot":"","sources":["../../src/tools/glob-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGpE,qBAAa,cAAe,YAAW,QAAQ;IAC7C,UAAU,EAAE,cAAc,CAmBxB;IAEF,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA8CnE"}