@arts1234567/arc-code 0.1.0

package/dist/state.js

@@ -0,0 +1,75 @@
+// Arc-code State Manager
+// Tracks the conversation, current directory, token count, and a list of
+// recently-known files. Per blueprint's "State Tracking" hard part.
+import { promises as fs } from "fs";
+import * as path from "path";
+import { countTokens } from "./llm/compaction.js";
+import { CONFIG } from "./config.js";
+export class StateManager {
+    cwd;
+    messages = [];
+    iteration = 0;
+    working = false;
+    workingStatus = "";
+    knownFiles = new Set();
+    mode = "build";
+    // Cache token count to avoid re-encoding on every statusbar render.
+    _tokenCache = { count: 0, len: 0 };
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    get totalTokens() {
+        // Only recount if message array length changed (simple dirty check).
+        if (this._tokenCache.len !== this.messages.length) {
+            this._tokenCache = {
+                count: countTokens(this.messages),
+                len: this.messages.length,
+            };
+        }
+        return this._tokenCache.count;
+    }
+    get contextPercent() {
+        return Math.min(100, (this.totalTokens / CONFIG.CONTEXT_LIMIT) * 100);
+    }
+    addMessage(m) {
+        this.messages.push(m);
+        // Invalidate cache.
+        this._tokenCache.len = -1;
+    }
+    setMessages(m) {
+        this.messages = m;
+        // Invalidate cache.
+        this._tokenCache.len = -1;
+    }
+    setWorking(b, status = "") {
+        this.working = b;
+        this.workingStatus = status;
+    }
+    // Lightweight snapshot of the workspace - used by the retriever and shown
+    // in the status bar. Walks the top 2 levels of the cwd.
+    async refreshKnownFiles() {
+        this.knownFiles.clear();
+        await this.walkLevel(this.cwd, 0, 2);
+    }
+    async walkLevel(dir, depth, max) {
+        if (depth > max)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name === "node_modules" || e.name === ".git" || e.name === "dist")
+                continue;
+            const full = path.join(dir, e.name);
+            this.knownFiles.add(full);
+            if (e.isDirectory()) {
+                await this.walkLevel(full, depth + 1, max);
+            }
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/tools/delete.js

@@ -0,0 +1,63 @@
+// delete_file - remove a file or directory from disk.
+import { promises as fs } from "fs";
+import * as path from "path";
+export const deleteFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "delete_file",
+            description: "Delete a file or an empty/non-empty directory. For directories, pass recursive=true to remove all contents. Use with care — this is permanent.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Path of the file or directory to delete. Relative paths resolve from cwd.",
+                    },
+                    recursive: {
+                        type: "boolean",
+                        description: "If true and path is a directory, delete it and all its contents. Default: false.",
+                    },
+                },
+                required: ["path"],
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (!args.path || typeof args.path !== "string") {
+            return `Error: 'path' must be a string.`;
+        }
+        const target = path.isAbsolute(args.path)
+            ? args.path
+            : path.resolve(ctx.cwd, args.path);
+        try {
+            const stat = await fs.stat(target);
+            if (stat.isDirectory()) {
+                const recursive = args.recursive === true;
+                if (!recursive) {
+                    // try rmdir first (only works when empty)
+                    await fs.rmdir(target);
+                    return `Deleted empty directory '${args.path}'.`;
+                }
+                else {
+                    await fs.rm(target, { recursive: true, force: true });
+                    return `Deleted directory '${args.path}' and all its contents.`;
+                }
+            }
+            else {
+                await fs.unlink(target);
+                return `Deleted file '${args.path}'.`;
+            }
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return `Error: '${args.path}' does not exist.`;
+            }
+            if (err.code === "ENOTEMPTY") {
+                return `Error: Directory '${args.path}' is not empty. Pass recursive=true to delete it along with its contents.`;
+            }
+            return `Error deleting '${args.path}': ${err?.message ?? err}`;
+        }
+    },
+};
+//# sourceMappingURL=delete.js.map

package/dist/tools/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/tools/delete.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,gJAAgJ;YAClJ,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2EAA2E;qBACzF;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,kFAAkF;qBAChG;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACvC,CAAC,CAAC,IAAI,CAAC,IAAI;YACX,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,0CAA0C;oBAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACvB,OAAO,4BAA4B,IAAI,CAAC,IAAI,IAAI,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBACtD,OAAO,sBAAsB,IAAI,CAAC,IAAI,yBAAyB,CAAC;gBAClE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxB,OAAO,iBAAiB,IAAI,CAAC,IAAI,IAAI,CAAC;YACxC,CAAC;QACH,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,WAAW,IAAI,CAAC,IAAI,mBAAmB,CAAC;YACjD,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,qBAAqB,IAAI,CAAC,IAAI,2EAA2E,CAAC;YACnH,CAAC;YACD,OAAO,mBAAmB,IAAI,CAAC,IAAI,MAAM,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/edit.js

@@ -0,0 +1,67 @@
+// edit_file - precise substring replacement in an existing file.
+import { promises as fs } from "fs";
+import * as path from "path";
+export const editFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "edit_file",
+            description: "Replace a specific substring within a file with new content. Use this for targeted edits to avoid overwriting large files.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Path to the file to edit. Relative paths resolve from cwd.",
+                    },
+                    old_string: {
+                        type: "string",
+                        description: "The exact text to be replaced. Must be a unique substring within the file, including whitespace and indentation.",
+                    },
+                    new_string: {
+                        type: "string",
+                        description: "The text to replace it with.",
+                    },
+                },
+                required: ["path", "old_string", "new_string"],
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (!args.path || typeof args.path !== "string") {
+            return `Error: 'path' must be a string.`;
+        }
+        if (typeof args.old_string !== "string" || typeof args.new_string !== "string") {
+            return `Error: 'old_string' and 'new_string' must be strings.`;
+        }
+        const target = path.isAbsolute(args.path)
+            ? args.path
+            : path.resolve(ctx.cwd, args.path);
+        try {
+            const content = await fs.readFile(target, "utf-8");
+            const count = content.split(args.old_string).length - 1;
+            if (count === 0) {
+                return `Error: Could not find 'old_string' in the file. Make sure you match whitespace and indentation exactly.`;
+            }
+            if (count > 1) {
+                return `Error: 'old_string' matched ${count} times. Provide a larger, more unique block of text to safely replace.`;
+            }
+            const updated = content.replace(args.old_string, args.new_string);
+            await fs.writeFile(target, updated, "utf-8");
+            const linesChanged = args.new_string.split('\n').length - args.old_string.split('\n').length;
+            const linesInfo = linesChanged > 0
+                ? `(+${linesChanged} lines)`
+                : linesChanged < 0
+                    ? `(${linesChanged} lines)`
+                    : `(0 lines change)`;
+            return `Successfully replaced targeted text in '${args.path}' ${linesInfo}.`;
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return `Error: File '${args.path}' does not exist. Use write_file to create it.`;
+            }
+            return `Error editing file '${args.path}': ${err?.message ?? err}`;
+        }
+    },
+};
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/execute.js

@@ -0,0 +1,85 @@
+// execute_command - run a shell command and return stdout/stderr/exit code.
+import { spawn } from "child_process";
+const DEFAULT_TIMEOUT_MS = 60_000;
+const MAX_OUTPUT_BYTES = 200_000;
+const isWindows = process.platform === "win32";
+export const executeCommandTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "execute_command",
+            description: "Run a shell command and return its stdout, stderr, and exit code. The command is run via the system shell. Use a sensible timeout.",
+            parameters: {
+                type: "object",
+                properties: {
+                    cmd: {
+                        type: "string",
+                        description: "The shell command to execute.",
+                    },
+                    timeout_ms: {
+                        type: "number",
+                        description: "Optional timeout in milliseconds. Defaults to 60000 (60s).",
+                    },
+                },
+                required: ["cmd"],
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (!args.cmd || typeof args.cmd !== "string") {
+            return `Error: 'cmd' is required and must be a string.`;
+        }
+        const cmd = args.cmd;
+        const timeout = typeof args.timeout_ms === "number" ? args.timeout_ms : DEFAULT_TIMEOUT_MS;
+        const shell = isWindows ? "cmd.exe" : "/bin/sh";
+        const shellFlag = isWindows ? "/c" : "-c";
+        return new Promise((resolve) => {
+            const child = spawn(shell, [shellFlag, cmd], {
+                cwd: ctx.cwd,
+                env: process.env,
+                windowsHide: true,
+            });
+            let out = "";
+            let err = "";
+            let killed = false;
+            const timer = setTimeout(() => {
+                killed = true;
+                child.kill();
+            }, timeout);
+            child.stdout.on("data", (d) => {
+                if (out.length < MAX_OUTPUT_BYTES) {
+                    out += d.toString();
+                }
+            });
+            child.stderr.on("data", (d) => {
+                if (err.length < MAX_OUTPUT_BYTES) {
+                    err += d.toString();
+                }
+            });
+            child.on("error", (e) => {
+                clearTimeout(timer);
+                resolve(`Error spawning command: ${e.message}`);
+            });
+            child.on("close", (code) => {
+                clearTimeout(timer);
+                let result = "";
+                if (killed) {
+                    result += `[Command killed after ${timeout}ms timeout]\n`;
+                }
+                if (out)
+                    result += `--- stdout ---\n${out}`;
+                if (err)
+                    result += `${out ? "\n" : ""}--- stderr ---\n${err}`;
+                result += `${result ? "\n" : ""}[exit code: ${code}]`;
+                if (out.length >= MAX_OUTPUT_BYTES) {
+                    result += `\n[stdout truncated at ${MAX_OUTPUT_BYTES} bytes]`;
+                }
+                if (err.length >= MAX_OUTPUT_BYTES) {
+                    result += `\n[stderr truncated at ${MAX_OUTPUT_BYTES} bytes]`;
+                }
+                resolve(result);
+            });
+        });
+    },
+};
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,36 @@
+// Arc-code Tools
+// Available tools:
+//   read_file, write_file, edit_file, delete_file, move_file,
+//   list_directory, search_files, execute_command, web_search, read_image
+import { readFileTool } from "./read.js";
+import { writeFileTool } from "./write.js";
+import { editFileTool } from "./edit.js";
+import { deleteFileTool } from "./delete.js";
+import { moveFileTool } from "./move.js";
+import { listDirectoryTool } from "./list.js";
+import { searchFilesTool } from "./search.js";
+import { executeCommandTool } from "./execute.js";
+import { webSearchTool } from "./websearch.js";
+import { readImageTool } from "./read_image.js";
+const tools = {
+    read_file: readFileTool,
+    write_file: writeFileTool,
+    edit_file: editFileTool,
+    delete_file: deleteFileTool,
+    move_file: moveFileTool,
+    list_directory: listDirectoryTool,
+    search_files: searchFilesTool,
+    execute_command: executeCommandTool,
+    web_search: webSearchTool,
+    read_image: readImageTool,
+};
+export function getTool(name) {
+    return tools[name];
+}
+export function listToolNames() {
+    return Object.keys(tools);
+}
+export function getAllDefinitions() {
+    return Object.values(tools).map((t) => t.definition);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,mBAAmB;AACnB,8DAA8D;AAC9D,0EAA0E;AAyB1E,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,KAAK,GAA2B;IACpC,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,eAAe,EAAE,kBAAkB;IACnC,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;CAC1B,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,CAAC,IAAgB,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAe,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC"}

package/dist/tools/list.js

@@ -0,0 +1,66 @@
+// list_directory - list immediate entries of a directory.
+import { promises as fs } from "fs";
+import * as path from "path";
+import { isBinaryFile } from "./read.js";
+const MAX_ENTRIES = 500;
+export const listDirectoryTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "list_directory",
+            description: "List the immediate entries (files and subdirectories) of a directory. Hidden files (starting with '.') are included. Only lists text files (source code, logs, configs) — binary files like images are excluded.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Directory to list. Defaults to the current working directory if omitted.",
+                    },
+                },
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (args.path !== undefined && typeof args.path !== "string") {
+            return `Error: 'path' must be a string if provided.`;
+        }
+        const target = args.path
+            ? path.isAbsolute(args.path)
+                ? args.path
+                : path.resolve(ctx.cwd, args.path)
+            : ctx.cwd;
+        try {
+            const stat = await fs.stat(target);
+            if (!stat.isDirectory()) {
+                return `Error: '${args.path ?? "."}' is not a directory.`;
+            }
+            const entries = await fs.readdir(target, { withFileTypes: true });
+            const sorted = entries
+                .filter((e) => e.isDirectory() || !isBinaryFile(e.name))
+                .map((e) => ({
+                name: e.name,
+                kind: e.isDirectory() ? "dir" : "file",
+            }))
+                .sort((a, b) => {
+                if (a.kind !== b.kind)
+                    return a.kind === "dir" ? -1 : 1;
+                return a.name.localeCompare(b.name);
+            });
+            const shown = sorted.slice(0, MAX_ENTRIES);
+            const lines = shown.map((e) => e.kind === "dir" ? `[d] ${e.name}` : `    ${e.name}`);
+            let out = lines.join("\n");
+            const binarySkipped = entries.length - sorted.length;
+            if (binarySkipped > 0) {
+                out += `\n\n[${binarySkipped} binary file(s) omitted]`;
+            }
+            if (sorted.length > MAX_ENTRIES) {
+                out += `\n\n[... ${sorted.length - MAX_ENTRIES} more entries]`;
+            }
+            return out;
+        }
+        catch (err) {
+            return `Error listing directory '${args.path ?? "."}': ${err?.message ?? err}`;
+        }
+    },
+};
+//# sourceMappingURL=list.js.map

package/dist/tools/list.js.map

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

package/dist/tools/move.js

@@ -0,0 +1,56 @@
+// move_file - rename or move a file/directory.
+import { promises as fs } from "fs";
+import * as path from "path";
+export const moveFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "move_file",
+            description: "Move or rename a file or directory. The destination parent directory will be created if it does not exist.",
+            parameters: {
+                type: "object",
+                properties: {
+                    source: {
+                        type: "string",
+                        description: "The path of the file or directory to move. Relative paths resolve from cwd.",
+                    },
+                    destination: {
+                        type: "string",
+                        description: "The destination path. Relative paths resolve from cwd.",
+                    },
+                },
+                required: ["source", "destination"],
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (!args.source || typeof args.source !== "string") {
+            return `Error: 'source' must be a string.`;
+        }
+        if (!args.destination || typeof args.destination !== "string") {
+            return `Error: 'destination' must be a string.`;
+        }
+        const src = path.isAbsolute(args.source)
+            ? args.source
+            : path.resolve(ctx.cwd, args.source);
+        const dst = path.isAbsolute(args.destination)
+            ? args.destination
+            : path.resolve(ctx.cwd, args.destination);
+        try {
+            // Ensure parent directory of destination exists
+            await fs.mkdir(path.dirname(dst), { recursive: true });
+            await fs.rename(src, dst);
+            return `Moved '${args.source}' → '${args.destination}'.`;
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return `Error: Source '${args.source}' does not exist.`;
+            }
+            if (err.code === "EEXIST" || err.code === "ENOTEMPTY") {
+                return `Error: Destination '${args.destination}' already exists.`;
+            }
+            return `Error moving '${args.source}' to '${args.destination}': ${err?.message ?? err}`;
+        }
+    },
+};
+//# sourceMappingURL=move.js.map

package/dist/tools/move.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.js","sourceRoot":"","sources":["../../src/tools/move.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,4GAA4G;YAC9G,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6EAA6E;qBAC3F;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACtE;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;aACpC;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,mCAAmC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,wCAAwC,CAAC;QAClD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,MAAM;YACb,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3C,CAAC,CAAC,IAAI,CAAC,WAAW;YAClB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,UAAU,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,WAAW,IAAI,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,kBAAkB,IAAI,CAAC,MAAM,mBAAmB,CAAC;YAC1D,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtD,OAAO,uBAAuB,IAAI,CAAC,WAAW,mBAAmB,CAAC;YACpE,CAAC;YACD,OAAO,iBAAiB,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,WAAW,MAAM,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/read.js

@@ -0,0 +1,84 @@
+// read_file - read the contents of a file (text files only).
+import { promises as fs } from "fs";
+import * as path from "path";
+const MAX_BYTES = 200_000;
+export const BINARY_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".webp", ".svgz",
+    ".exe", ".dll", ".so", ".dylib", ".wasm",
+    ".zip", ".tar", ".gz", ".bz2", ".7z", ".rar",
+    ".bin", ".o", ".a", ".lib", ".class", ".pyc", ".pyd",
+    ".woff", ".woff2", ".ttf", ".eot",
+    ".mp3", ".mp4", ".avi", ".mov", ".wmv", ".flv", ".webm",
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
+    ".ico", ".cur",
+]);
+const BINARY_CHECK_SIZE = 512;
+export function isBinaryFile(p) {
+    const ext = path.extname(p).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+function hasNullBytes(buf) {
+    const checkLen = Math.min(buf.length, BINARY_CHECK_SIZE);
+    for (let i = 0; i < checkLen; i++) {
+        if (buf[i] === 0)
+            return true;
+    }
+    return false;
+}
+export const readFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "read_file",
+            description: "Read the contents of a text file at the given path. Only works on text-based files (source code, config, markdown, logs, etc). Cannot read binary files like images, archives, or executables.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Path to the file to read. Relative paths are resolved from the current working directory.",
+                    },
+                },
+                required: ["path"],
+            },
+        },
+    },
+    execute: async (args, ctx) => {
+        if (!args.path || typeof args.path !== "string") {
+            return `Error: 'path' is required and must be a string.`;
+        }
+        // Reject known binary extensions by filename before checking disk.
+        if (isBinaryFile(args.path)) {
+            return `Error: cannot read '${args.path}' — it appears to be a binary/image file. This tool only reads text files (source code, logs, configs). Use list_directory to find text-only files.`;
+        }
+        const target = resolvePath(args.path, ctx.cwd);
+        try {
+            const stat = await fs.stat(target);
+            if (stat.isDirectory()) {
+                return `Error: '${args.path}' is a directory, not a file. Use list_directory instead.`;
+            }
+            const buf = await fs.readFile(target);
+            // Also check magic bytes for unknown binary formats.
+            if (hasNullBytes(buf)) {
+                return `Error: cannot read '${args.path}' — it appears to be a binary/image file. This tool only reads text files. Use list_directory to find text-only files.`;
+            }
+            if (buf.length > MAX_BYTES) {
+                const truncated = buf.slice(0, MAX_BYTES).toString("utf-8");
+                return `${truncated}\n\n[... truncated, file is ${buf.length} bytes]`;
+            }
+            return buf.toString("utf-8");
+        }
+        catch (err) {
+            return `Error reading file '${args.path}': ${err?.message ?? err}`;
+        }
+    },
+};
+function resolvePath(p, cwd) {
+    if (typeof p !== "string" || p.length === 0) {
+        return cwd;
+    }
+    if (path.isAbsolute(p))
+        return p;
+    return path.resolve(cwd, p);
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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