neoctl 0.1.0

package/dist/tools/builtins/exec-tool.js

@@ -0,0 +1,290 @@
+import { spawn } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+import { createLocalAgentTask } from "../../agents/local-agent-task.js";
+import { globalTaskStore } from "../../tasks/task-store.js";
+import { createTextMessage } from "../../types/messages.js";
+export function createExecTool(runtime) {
+    return {
+        name: "exec",
+        aliases: ["shell", "bash", "powershell"],
+        description: "Execute a shell command in the local workspace with full permissions. Use cwd to choose the working directory and timeoutMs/maxOutputChars to bound long commands. Set background=true to run long-lived commands asynchronously and receive a task_id for later polling.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Shell command to execute." },
+                cwd: { type: "string", description: "Working directory. Defaults to the current agent cwd." },
+                timeoutMs: { type: "integer", description: "Timeout in milliseconds, 1-600000. Defaults to 120000." },
+                maxOutputChars: { type: "integer", description: "Maximum stdout/stderr chars to keep each, 1000-200000. Defaults to 40000." },
+                shell: {
+                    type: "string",
+                    enum: ["auto", "powershell", "cmd", "bash", "sh"],
+                    description: "Shell to use. Defaults to auto: PowerShell on Windows, bash/sh elsewhere.",
+                },
+                env: {
+                    type: "object",
+                    description: "Additional environment variables for the child process.",
+                    additionalProperties: true,
+                },
+                description: { type: "string", description: "Short human-readable description of the command purpose." },
+                background: { type: "boolean", description: "If true, run the command in the background and return immediately with a task_id." },
+            },
+            required: ["command"],
+            additionalProperties: false,
+        },
+        metadata: {
+            readOnly: false,
+            concurrent: false,
+            visible: true,
+            requiresApproval: false,
+            destructive: true,
+            maxResultSizeChars: 50000,
+            searchHint: "run shell commands and inspect stdout/stderr",
+        },
+        validate(input) {
+            const record = input;
+            return {
+                command: record.command ?? "",
+                cwd: record.cwd,
+                timeoutMs: record.timeoutMs ?? 120000,
+                maxOutputChars: record.maxOutputChars ?? 40000,
+                shell: record.shell ?? "auto",
+                env: normalizeEnv(record.env),
+                description: record.description,
+                background: record.background ?? false,
+            };
+        },
+        validateInput(input) {
+            if (!input.command.trim())
+                return { ok: false, message: "exec.command cannot be empty" };
+            if (!Number.isInteger(input.timeoutMs) || input.timeoutMs < 1 || input.timeoutMs > 600000) {
+                return { ok: false, message: "exec.timeoutMs must be between 1 and 600000" };
+            }
+            if (!Number.isInteger(input.maxOutputChars) || input.maxOutputChars < 1000 || input.maxOutputChars > 200000) {
+                return { ok: false, message: "exec.maxOutputChars must be between 1000 and 200000" };
+            }
+            if (!["auto", "powershell", "cmd", "bash", "sh"].includes(input.shell)) {
+                return { ok: false, message: "exec.shell must be one of auto, powershell, cmd, bash, sh" };
+            }
+            return { ok: true, value: input };
+        },
+        isConcurrencySafe(input) {
+            return Boolean(input.background);
+        },
+        async call(input, context, options) {
+            const cwd = resolveCwd(input.cwd, context);
+            const cwdStat = await fs.stat(cwd).catch(() => undefined);
+            if (!cwdStat)
+                return { ok: false, output: { error: `exec.cwd does not exist: ${cwd}` } };
+            if (!cwdStat.isDirectory())
+                return { ok: false, output: { error: `exec.cwd is not a directory: ${cwd}` } };
+            if (input.background) {
+                return launchBackgroundExec(input, cwd, runtime?.taskStore ?? globalTaskStore);
+            }
+            const resolvedShell = resolveShell(input.shell);
+            options.onProgress?.({
+                toolName: "exec",
+                message: `Running command${input.description ? `: ${input.description}` : ""}`,
+                data: { cwd, shell: resolvedShell.displayName, command: input.command },
+            });
+            const output = await runCommand({
+                command: input.command,
+                cwd,
+                timeoutMs: input.timeoutMs,
+                maxOutputChars: input.maxOutputChars,
+                shell: resolvedShell,
+                env: input.env,
+                abortSignal: context.abortSignal,
+            });
+            const ok = output.exitCode === 0 && !output.timedOut;
+            return {
+                ok,
+                output,
+                summary: summarizeExecOutput(output),
+            };
+        },
+    };
+}
+export const execTool = createExecTool();
+function launchBackgroundExec(input, cwd, taskStore) {
+    const taskId = `exec_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+    const agentId = `bg_exec_${Date.now().toString(36)}`;
+    const description = input.description ?? `exec: ${input.command.slice(0, 80)}`;
+    const abortController = new AbortController();
+    const task = createLocalAgentTask({
+        taskId,
+        agentId,
+        description,
+        prompt: input.command,
+        type: "exec",
+        abortController,
+    });
+    taskStore.upsert(task);
+    taskStore.markRunning(taskId);
+    const resolvedShell = resolveShell(input.shell);
+    void runCommand({
+        command: input.command,
+        cwd,
+        timeoutMs: input.timeoutMs,
+        maxOutputChars: input.maxOutputChars,
+        shell: resolvedShell,
+        env: input.env,
+        abortSignal: abortController.signal,
+    }).then((output) => {
+        const ok = output.exitCode === 0 && !output.timedOut;
+        taskStore.complete(taskId, {
+            agent_id: agentId,
+            agent_type: "exec",
+            content: summarizeExecOutput(output),
+            total_duration_ms: output.durationMs,
+            total_tool_use_count: 0,
+        });
+        const finished = taskStore.get(taskId);
+        if (finished) {
+            finished.messages.push(createTextMessage("user", `<task-notification agent_id="${agentId}" task_id="${taskId}" status="${ok ? "completed" : "failed"}" type="exec">\n${summarizeExecOutput(output)}\nstdout: ${output.stdout.slice(0, 2000)}\nstderr: ${output.stderr.slice(0, 2000)}\n</task-notification>`));
+            finished.notified = false;
+            taskStore.upsert(finished);
+        }
+    }).catch((error) => {
+        taskStore.fail(taskId, error instanceof Error ? error.message : String(error));
+    });
+    return {
+        ok: true,
+        output: {
+            status: "async_launched",
+            task_id: taskId,
+            agent_id: agentId,
+            description,
+            command: input.command,
+            output_file: task.outputFile,
+            message: "Command launched in background. Use TaskOutput or TaskGet to check status.",
+        },
+    };
+}
+function runCommand(options) {
+    const started = Date.now();
+    const stdout = new OutputAccumulator(options.maxOutputChars);
+    const stderr = new OutputAccumulator(options.maxOutputChars);
+    let timedOut = false;
+    let settled = false;
+    return new Promise((resolve, reject) => {
+        const child = spawn(options.shell.file, [...options.shell.args, options.command], {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            windowsHide: true,
+        });
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (!settled)
+                    child.kill("SIGKILL");
+            }, 1000).unref();
+        }, options.timeoutMs);
+        const abort = () => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        };
+        options.abortSignal?.addEventListener("abort", abort, { once: true });
+        child.stdout?.on("data", (chunk) => stdout.push(chunk.toString("utf8")));
+        child.stderr?.on("data", (chunk) => stderr.push(chunk.toString("utf8")));
+        child.on("error", (error) => {
+            clearTimeout(timeout);
+            options.abortSignal?.removeEventListener("abort", abort);
+            reject(error);
+        });
+        child.on("close", (exitCode, signal) => {
+            settled = true;
+            clearTimeout(timeout);
+            options.abortSignal?.removeEventListener("abort", abort);
+            resolve({
+                command: options.command,
+                cwd: options.cwd,
+                shell: options.shell.requested,
+                exitCode,
+                signal,
+                timedOut,
+                durationMs: Date.now() - started,
+                stdout: stdout.value(),
+                stderr: stderr.value(),
+                stdoutTruncated: stdout.truncated,
+                stderrTruncated: stderr.truncated,
+                outputBytes: {
+                    stdout: stdout.bytes,
+                    stderr: stderr.bytes,
+                },
+            });
+        });
+    });
+}
+class OutputAccumulator {
+    maxChars;
+    bytes = 0;
+    truncated = false;
+    valueText = "";
+    constructor(maxChars) {
+        this.maxChars = maxChars;
+    }
+    push(text) {
+        this.bytes += Buffer.byteLength(text);
+        if (this.valueText.length >= this.maxChars) {
+            this.truncated = true;
+            return;
+        }
+        const remaining = this.maxChars - this.valueText.length;
+        if (text.length > remaining) {
+            this.valueText += text.slice(0, remaining);
+            this.truncated = true;
+            return;
+        }
+        this.valueText += text;
+    }
+    value() {
+        if (!this.truncated)
+            return normalizeOutput(this.valueText);
+        return `${normalizeOutput(this.valueText)}\n[output truncated at ${this.maxChars} chars]`;
+    }
+}
+function resolveShell(shell) {
+    const requested = shell === "auto" ? defaultShell() : shell;
+    if (requested === "powershell") {
+        return {
+            requested,
+            displayName: "PowerShell",
+            file: "powershell.exe",
+            args: ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command"],
+        };
+    }
+    if (requested === "cmd")
+        return { requested, displayName: "cmd.exe", file: "cmd.exe", args: ["/d", "/s", "/c"] };
+    if (requested === "bash")
+        return { requested, displayName: "bash", file: "bash", args: ["-lc"] };
+    return { requested, displayName: "sh", file: "sh", args: ["-lc"] };
+}
+function defaultShell() {
+    return os.platform() === "win32" ? "powershell" : "bash";
+}
+function resolveCwd(cwd, context) {
+    const root = path.resolve(context.appState.snapshot().cwd ?? process.cwd());
+    if (!cwd?.trim())
+        return root;
+    return path.isAbsolute(cwd) ? path.normalize(cwd) : path.resolve(root, cwd);
+}
+function normalizeEnv(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return {};
+    return Object.fromEntries(Object.entries(input)
+        .filter(([, value]) => typeof value === "string")
+        .map(([key, value]) => [key, value]));
+}
+function normalizeOutput(text) {
+    return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+function summarizeExecOutput(output) {
+    const status = output.timedOut ? "timed out" : output.exitCode === 0 ? "exit 0" : `exit ${output.exitCode ?? "unknown"}`;
+    const stdout = output.stdout.trim() ? `${output.stdout.trim().split(/\n/).length} stdout line(s)` : "no stdout";
+    const stderr = output.stderr.trim() ? `${output.stderr.trim().split(/\n/).length} stderr line(s)` : "no stderr";
+    return `${status}, ${stdout}, ${stderr}, ${output.durationMs}ms`;
+}
+//# sourceMappingURL=exec-tool.js.map

package/dist/tools/builtins/exec-tool.js.map

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

package/dist/tools/builtins/filesystem-tools.d.ts

@@ -0,0 +1,16 @@
+import type { Tool } from "../tool.js";
+export interface ReadFileToolInput {
+    path: string;
+    offset: number;
+    limit: number;
+}
+export interface ListDirectoryToolInput {
+    path?: string;
+    recursive: boolean;
+    includeHidden: boolean;
+    maxEntries: number;
+    maxDepth?: number;
+    exclude: string[];
+}
+export declare const readFileTool: Tool<ReadFileToolInput>;
+export declare const listDirectoryTool: Tool<ListDirectoryToolInput>;

package/dist/tools/builtins/filesystem-tools.js

@@ -0,0 +1,306 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export const readFileTool = {
+    name: "read",
+    aliases: ["view"],
+    description: "Read a text file by line range. Use offset and limit to inspect specific locations without loading the whole file.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Absolute or cwd-relative file path to read." },
+            offset: { type: "integer", description: "1-based starting line. Defaults to 1." },
+            limit: { type: "integer", description: "Number of lines to return, 1-500. Defaults to 120." },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    },
+    metadata: {
+        readOnly: true,
+        concurrent: true,
+        visible: true,
+        maxResultSizeChars: 30000,
+        searchHint: "read a file line range",
+    },
+    validate(input) {
+        const record = input;
+        return {
+            path: record.path ?? "",
+            offset: record.offset ?? 1,
+            limit: record.limit ?? 120,
+        };
+    },
+    validateInput(input) {
+        if (!input.path.trim())
+            return { ok: false, message: "read.path cannot be empty" };
+        if (!Number.isInteger(input.offset) || input.offset < 1)
+            return { ok: false, message: "read.offset must be a positive integer" };
+        if (!Number.isInteger(input.limit) || input.limit < 1 || input.limit > 500) {
+            return { ok: false, message: "read.limit must be between 1 and 500" };
+        }
+        return { ok: true, value: input };
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async call(input, context) {
+        const root = workingDirectory(context);
+        const target = resolveTarget(root, input.path);
+        const stat = await fs.stat(target).catch(() => undefined);
+        if (!stat)
+            return { ok: false, output: { error: `read.path does not exist: ${target}` } };
+        if (!stat.isFile())
+            return { ok: false, output: { error: `read.path is not a file: ${target}` } };
+        if (stat.size > 8 * 1024 * 1024) {
+            return { ok: false, output: { error: `read.path is too large to read directly: ${stat.size} bytes`, path: target, size: stat.size } };
+        }
+        const buffer = await fs.readFile(target);
+        if (looksBinary(buffer)) {
+            return { ok: false, output: { error: "read.path appears to be binary; use list/grep metadata instead", path: target, size: stat.size } };
+        }
+        const text = buffer.toString("utf8").replace(/^\uFEFF/, "");
+        const lines = text.split(/\r\n|\n|\r/);
+        const totalLines = lines.length === 1 && lines[0] === "" ? 0 : lines.length;
+        const startIndex = Math.min(Math.max(0, input.offset - 1), totalLines);
+        const endIndex = Math.min(totalLines, startIndex + input.limit);
+        const selected = lines.slice(startIndex, endIndex).map((line, index) => ({
+            line: startIndex + index + 1,
+            text: line,
+        }));
+        return {
+            ok: true,
+            output: {
+                path: target,
+                offset: input.offset,
+                limit: input.limit,
+                startLine: selected[0]?.line,
+                endLine: selected[selected.length - 1]?.line,
+                totalLines,
+                hasMoreBefore: startIndex > 0,
+                hasMoreAfter: endIndex < totalLines,
+                content: selected.map((line) => `${String(line.line).padStart(4, " ")} | ${line.text}`).join("\n"),
+            },
+            summary: selected.length ? `lines ${selected[0].line}-${selected[selected.length - 1].line} of ${totalLines}` : `0 lines of ${totalLines}`,
+        };
+    },
+};
+export const listDirectoryTool = {
+    name: "list",
+    aliases: ["ls"],
+    description: "List a file or directory. Recursive listings are bounded and skip heavy directories by default; use exclude/maxDepth to control scope.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Absolute or cwd-relative file/directory path. Defaults to current working directory." },
+            recursive: { type: "boolean", description: "Recursively inventory descendants. Defaults to false." },
+            includeHidden: { type: "boolean", description: "Include dotfiles and hidden-looking names. Defaults to false." },
+            maxEntries: { type: "integer", description: "Maximum entries to return, 1-500. Defaults to 120." },
+            maxDepth: { type: "integer", description: "Maximum recursive depth below the target directory. 0 means only direct children. Defaults to 4 when recursive, 0 otherwise." },
+            exclude: {
+                type: "array",
+                items: { type: "string" },
+                description: "Directory or file name/path fragments to skip. Defaults to heavy directories such as .git, node_modules, dist, build, coverage.",
+            },
+        },
+        additionalProperties: false,
+    },
+    metadata: {
+        readOnly: true,
+        concurrent: true,
+        visible: true,
+        maxResultSizeChars: 30000,
+        searchHint: "list directory entries and file counts",
+    },
+    mapResult(result) {
+        return shrinkDirectoryOutputForTransport(result.output, 26000);
+    },
+    validate(input) {
+        const record = input;
+        return {
+            path: record.path,
+            recursive: record.recursive ?? false,
+            includeHidden: record.includeHidden ?? false,
+            maxEntries: record.maxEntries ?? 120,
+            maxDepth: record.maxDepth,
+            exclude: record.exclude ?? DEFAULT_LIST_EXCLUDES,
+        };
+    },
+    validateInput(input) {
+        if (input.path !== undefined && !input.path.trim())
+            return { ok: false, message: "list.path cannot be empty" };
+        if (!Number.isInteger(input.maxEntries) || input.maxEntries < 1 || input.maxEntries > 500) {
+            return { ok: false, message: "list.maxEntries must be between 1 and 500" };
+        }
+        if (input.maxDepth !== undefined && (!Number.isInteger(input.maxDepth) || input.maxDepth < 0 || input.maxDepth > 50)) {
+            return { ok: false, message: "list.maxDepth must be between 0 and 50" };
+        }
+        if (input.exclude.some((entry) => !entry.trim()))
+            return { ok: false, message: "list.exclude entries cannot be empty" };
+        return { ok: true, value: input };
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async call(input, context) {
+        const root = workingDirectory(context);
+        const target = resolveTarget(root, input.path ?? ".");
+        const stat = await fs.stat(target).catch(() => undefined);
+        if (!stat)
+            return { ok: false, output: { error: `list.path does not exist: ${target}` } };
+        if (stat.isFile()) {
+            return {
+                ok: true,
+                output: { path: target, type: "file", size: stat.size, mtime: stat.mtime.toISOString(), extension: path.extname(target) || undefined },
+                summary: "file",
+            };
+        }
+        if (!stat.isDirectory()) {
+            return { ok: false, output: { error: `list.path is not a regular file or directory: ${target}` } };
+        }
+        return listDirectory(target, input);
+    },
+};
+async function listDirectory(target, input) {
+    const entries = [];
+    const extensionCounts = new Map();
+    const excludedCounts = new Map();
+    const maxDepth = input.maxDepth ?? (input.recursive ? 4 : 0);
+    const exclude = input.exclude.length ? input.exclude : DEFAULT_LIST_EXCLUDES;
+    let totalFiles = 0;
+    let totalDirectories = 0;
+    let truncated = false;
+    const visit = async (dir, depth) => {
+        const children = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+        children.sort(compareDirectoryEntries);
+        for (const child of children) {
+            if (!input.includeHidden && child.name.startsWith("."))
+                continue;
+            const fullPath = path.join(dir, child.name);
+            const excludedBy = findExcludeMatch(target, fullPath, child.name, exclude);
+            if (excludedBy) {
+                excludedCounts.set(excludedBy, (excludedCounts.get(excludedBy) ?? 0) + 1);
+                continue;
+            }
+            const childStat = await fs.stat(fullPath).catch(() => undefined);
+            if (!childStat)
+                continue;
+            if (child.isDirectory())
+                totalDirectories += 1;
+            if (child.isFile()) {
+                totalFiles += 1;
+                const extension = path.extname(child.name).toLowerCase() || "[no extension]";
+                extensionCounts.set(extension, (extensionCounts.get(extension) ?? 0) + 1);
+            }
+            if (entries.length < input.maxEntries) {
+                entries.push({
+                    path: fullPath,
+                    name: child.name,
+                    type: child.isDirectory() ? "directory" : child.isFile() ? "file" : "other",
+                    size: childStat.size,
+                    mtime: childStat.mtime.toISOString(),
+                    depth,
+                    extension: child.isFile() ? path.extname(child.name) || undefined : undefined,
+                });
+            }
+            else {
+                truncated = true;
+            }
+            if (input.recursive && child.isDirectory() && depth < maxDepth)
+                await visit(fullPath, depth + 1);
+        }
+    };
+    await visit(target, 0);
+    return {
+        ok: true,
+        output: {
+            path: target,
+            type: "directory",
+            recursive: input.recursive,
+            maxDepth,
+            exclude,
+            totalFiles,
+            totalDirectories,
+            returnedEntries: entries.length,
+            truncated,
+            truncation: truncated ? { reason: "maxEntries", maxEntries: input.maxEntries } : undefined,
+            excludedCounts: Object.fromEntries([...excludedCounts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))),
+            extensionCounts: Object.fromEntries([...extensionCounts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))),
+            entries,
+        },
+        summary: `${totalFiles} file(s), ${totalDirectories} directory(s)${truncated ? ", truncated" : ""}`,
+    };
+}
+const DEFAULT_LIST_EXCLUDES = [
+    ".git",
+    "node_modules",
+    "dist",
+    "build",
+    "coverage",
+    ".next",
+    ".nuxt",
+    ".vite",
+    ".cache",
+    ".idea",
+    ".vscode",
+    ".agent-tasks",
+];
+function workingDirectory(context) {
+    const snapshot = context.appState.snapshot();
+    return path.resolve(snapshot.cwd ?? process.cwd());
+}
+function resolveTarget(root, targetPath) {
+    return path.isAbsolute(targetPath) ? path.normalize(targetPath) : path.resolve(root, targetPath);
+}
+function findExcludeMatch(root, fullPath, name, exclude) {
+    const relative = path.relative(root, fullPath).split(path.sep).join("/");
+    return exclude.find((entry) => {
+        const normalized = entry.replace(/\\/g, "/").replace(/\/+$/, "");
+        return name === normalized || relative === normalized || relative.startsWith(`${normalized}/`) || relative.includes(`/${normalized}/`);
+    });
+}
+function compareDirectoryEntries(left, right) {
+    return entrySortRank(left) - entrySortRank(right) || left.name.localeCompare(right.name);
+}
+function entrySortRank(entry) {
+    const typeRank = entry.isDirectory() ? 0 : entry.isFile() ? 2 : 3;
+    const hiddenRank = entry.name.startsWith(".") ? 1 : 0;
+    return typeRank + hiddenRank;
+}
+function shrinkDirectoryOutputForTransport(output, maxChars) {
+    if (!isDirectoryOutput(output))
+        return output;
+    const serialized = JSON.stringify(output);
+    if (serialized.length <= maxChars)
+        return output;
+    const originalEntries = output.entries;
+    const compacted = {
+        ...output,
+        returnedEntries: 0,
+        entries: [],
+        transportTruncation: {
+            reason: "resultSize",
+            originalLength: serialized.length,
+            entriesBeforeTransport: originalEntries.length,
+            maxChars,
+        },
+    };
+    for (let count = Math.min(originalEntries.length, output.returnedEntries); count >= 0; count -= 1) {
+        compacted.entries = originalEntries.slice(0, count);
+        compacted.returnedEntries = compacted.entries.length;
+        const candidate = JSON.stringify(compacted);
+        if (candidate.length <= maxChars)
+            return compacted;
+    }
+    return compacted;
+}
+function isDirectoryOutput(output) {
+    return typeof output === "object" && output !== null && output.type === "directory" && Array.isArray(output.entries);
+}
+function looksBinary(buffer) {
+    const sampleLength = Math.min(buffer.length, 4096);
+    for (let index = 0; index < sampleLength; index += 1) {
+        if (buffer[index] === 0)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=filesystem-tools.js.map

package/dist/tools/builtins/filesystem-tools.js.map

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