@clarvis/agent-tools 0.1.0

package/dist/tools/bash.js

@@ -0,0 +1,179 @@
+import { spawn } from "node:child_process";
+import { constants as osConstants } from "node:os";
+import path from "node:path";
+import { ToolError } from "../errors.js";
+import { resolvePath, displayPath } from "../lib/paths.js";
+import { statDirectory } from "../lib/files.js";
+import { boundOrSpill, allocateBudget } from "../lib/output.js";
+import { uniqueToken } from "../lib/token.js";
+const MAX_CAPTURE_FLOOR = 8 * 1024 * 1024;
+const STDIO_DRAIN_MS = 100;
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+function spillTarget(config, stream) {
+    const name = `bash-${uniqueToken()}.${stream}.log`;
+    const absPath = path.join(config.workspaceRoot, ".clarvis", name);
+    return { absPath, displayPath: displayPath(absPath, config.workspaceRoot) };
+}
+function computeExit(code, signal) {
+    if (code !== null)
+        return code;
+    const sigNum = signal ? (osConstants.signals[signal] ?? 0) : 0;
+    return signal ? 128 + sigNum : 0;
+}
+async function finalizeOutput(config, outText, errText) {
+    const [outBudget, errBudget] = allocateBudget(Buffer.byteLength(outText, "utf8"), Buffer.byteLength(errText, "utf8"), config.maxOutputBytes);
+    const [stdout, stderr] = await Promise.all([
+        boundOrSpill(outText, outBudget, spillTarget(config, "stdout")),
+        boundOrSpill(errText, errBudget, spillTarget(config, "stderr")),
+    ]);
+    return { stdout, stderr };
+}
+export const bash = {
+    name: "bash",
+    description: "Run a shell command (sh -c) and return stdout, stderr, and exit code. The command runs to " +
+        "completion and BLOCKS until it exits, so a long-lived process (a dev server, file watcher, " +
+        "`npm run dev`, `npm start`) MUST be started in the BACKGROUND with its output redirected — e.g. " +
+        "`npm start > /tmp/server.log 2>&1 &` — and then verified separately (sleep + curl the port, or " +
+        "read the log). A server left in the foreground will block until the timeout and waste the call.",
+    bounded: true,
+    inputSchema: {
+        type: "object",
+        properties: {
+            command: {
+                type: "string",
+                description: "Shell command, run via the system shell (sh -c). stdin is closed (no interactive " +
+                    "prompts). A long-lived process MUST be backgrounded with output redirected (e.g. " +
+                    "cmd > /tmp/out.log 2>&1 &) or it blocks until timeout.",
+            },
+            cwd: { type: "string", description: "Working directory. Default: workspace root." },
+            timeout_ms: {
+                type: "integer",
+                minimum: 1,
+                description: "Max run time in ms. Default: BASH_TIMEOUT_MS (120000); may be raised up to " +
+                    "BASH_TIMEOUT_MAX_MS (600000) for a long build/test/install. On timeout the process " +
+                    "group is killed and a timeout error is returned.",
+            },
+        },
+        required: ["command"],
+        additionalProperties: false,
+    },
+    async handler(args, config) {
+        const command = args.command;
+        const cwdArg = args.cwd;
+        const cwd = cwdArg
+            ? resolvePath(cwdArg, config.workspaceRoot, config.confineToWorkspace)
+            : config.workspaceRoot;
+        const requestedTimeoutMs = args.timeout_ms ?? config.bashTimeoutMs;
+        const timeoutMs = Math.min(requestedTimeoutMs, config.bashTimeoutMaxMs, MAX_TIMER_DELAY_MS);
+        await statDirectory(cwd, cwdArg ?? cwd);
+        return runCommand(command, cwd, timeoutMs, config);
+    },
+};
+function runCommand(command, cwd, timeoutMs, config) {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn("sh", ["-c", command], {
+                cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: true,
+            });
+        }
+        catch (err) {
+            reject(new ToolError("io_error", `Failed to spawn command: ${err.message}`));
+            return;
+        }
+        const captureCap = Math.max(config.maxOutputBytes, MAX_CAPTURE_FLOOR);
+        const stdoutSink = { text: "", bytes: 0, capped: false };
+        const stderrSink = { text: "", bytes: 0, capped: false };
+        let timedOut = false;
+        let outputLimited = false;
+        let settled = false;
+        let drainTimer;
+        const killGroup = () => {
+            try {
+                if (child.pid !== undefined)
+                    process.kill(-child.pid, "SIGKILL");
+            }
+            catch {
+                child.kill("SIGKILL");
+            }
+        };
+        const onData = (sink) => (d) => {
+            if (sink.capped)
+                return;
+            sink.text += d;
+            sink.bytes += Buffer.byteLength(d, "utf8");
+            if (sink.bytes > captureCap) {
+                sink.capped = true;
+                if (!outputLimited) {
+                    outputLimited = true;
+                    killGroup();
+                }
+            }
+        };
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", onData(stdoutSink));
+        child.stderr.on("data", onData(stderrSink));
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killGroup();
+        }, timeoutMs);
+        const teardown = () => {
+            child.stdout?.removeAllListeners("data");
+            child.stderr?.removeAllListeners("data");
+            child.stdout?.destroy();
+            child.stderr?.destroy();
+            child.unref();
+        };
+        const beginSettle = () => {
+            if (settled)
+                return false;
+            settled = true;
+            clearTimeout(timer);
+            if (drainTimer)
+                clearTimeout(drainTimer);
+            teardown();
+            return true;
+        };
+        const finish = (code, signal) => {
+            if (!beginSettle())
+                return;
+            void finalizeOutput(config, stdoutSink.text, stderrSink.text).then(({ stdout, stderr }) => {
+                if (timedOut) {
+                    reject(new ToolError("timeout", `Command exceeded ${timeoutMs}ms`, {
+                        timeout_ms: timeoutMs,
+                        stdout,
+                        stderr,
+                    }));
+                    return;
+                }
+                if (outputLimited) {
+                    reject(new ToolError("output_limit", `Command output exceeded ${captureCap} bytes on a single stream and was killed`, { max_capture_bytes: captureCap, stdout, stderr }));
+                    return;
+                }
+                resolve(JSON.stringify({
+                    exit_code: computeExit(code, signal),
+                    stdout,
+                    stderr,
+                    signal: signal ?? null,
+                    timed_out: false,
+                }));
+            }, (err) => reject(new ToolError("io_error", `Failed to finalize output: ${err.message}`)));
+        };
+        child.on("error", (err) => {
+            if (!beginSettle())
+                return;
+            reject(new ToolError("io_error", `Failed to run command: ${err.message}`));
+        });
+        child.on("exit", (code, signal) => {
+            clearTimeout(timer);
+            if (drainTimer)
+                clearTimeout(drainTimer);
+            drainTimer = setTimeout(() => finish(code, signal), STDIO_DRAIN_MS);
+        });
+        child.on("close", (code, signal) => finish(code, signal));
+    });
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

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

@@ -0,0 +1,15 @@
+import type { ServerConfig } from "../config.js";
+import type { ToolDef } from "./types.js";
+export declare function editFileLocked(target: string, relPath: string, config: ServerConfig, transform: (content: string) => string, message: (rel: string) => string): Promise<string>;
+export interface EditSpec {
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+}
+export declare function applyEdit(text: string, spec: EditSpec): {
+    text: string;
+    count: number;
+    fuzzy: boolean;
+};
+export declare const editFile: ToolDef;
+//# sourceMappingURL=edit-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../src/tools/edit-file.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EACtC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAC/B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmDD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CA2DjD;AAED,eAAO,MAAM,QAAQ,EAAE,OAuEtB,CAAC"}

package/dist/tools/edit-file.js

@@ -0,0 +1,163 @@
+import { ToolError } from "../errors.js";
+import { resolvePath, displayPath } from "../lib/paths.js";
+import { writeAtomic, withFileLock } from "../lib/atomic.js";
+import { reencode } from "../lib/text.js";
+import { readTextFile } from "../lib/textfile.js";
+import { findCascadeMatch, scanLineBlocks, trimEnds } from "../lib/match-cascade.js";
+export async function editFileLocked(target, relPath, config, transform, message) {
+    return withFileLock(target, async () => {
+        const decoded = await readTextFile(target, relPath, config.maxFileBytes);
+        if (decoded.encoding !== "utf8") {
+            throw new ToolError("is_binary", `Editing ${decoded.encoding} files is not supported (the file would be rewritten as ` +
+                `UTF-8): ${relPath}`, { path: relPath, encoding: decoded.encoding });
+        }
+        const newText = transform(decoded.content);
+        await writeAtomic(target, reencode(newText, decoded));
+        return message(displayPath(target, config.workspaceRoot));
+    });
+}
+function countOccurrences(haystack, needle) {
+    if (needle === "")
+        return 0;
+    let count = 0;
+    let idx = haystack.indexOf(needle);
+    while (idx !== -1) {
+        count++;
+        idx = haystack.indexOf(needle, idx + needle.length);
+    }
+    return count;
+}
+function occurrenceLines(text, needle, cap = 20) {
+    const lines = [];
+    let idx = text.indexOf(needle);
+    while (idx !== -1 && lines.length < cap) {
+        lines.push(text.slice(0, idx).split("\n").length);
+        idx = text.indexOf(needle, idx + needle.length);
+    }
+    return lines;
+}
+function diagnoseNoMatch(text, needle) {
+    if (needle === "")
+        return "";
+    const destripped = needle
+        .split("\n")
+        .map((l) => l.replace(/^\s*\d+\t/, ""))
+        .join("\n");
+    if (destripped !== needle && destripped !== "" && text.includes(destripped)) {
+        return (" It looks like old_string still contains read_file's line-number prefixes " +
+            '(e.g. "   12\\t"): drop them so old_string is only the file\'s own text.');
+    }
+    const hay = text.split("\n");
+    const need = needle.split("\n").map(trimEnds);
+    const hits = scanLineBlocks(hay, need, (a, b) => trimEnds(a) === b, 6).map((i) => i + 1);
+    if (hits.length > 0) {
+        const shown = hits.slice(0, 5).join(", ");
+        const where = hits.length === 1 ? `line ${shown}` : `lines ${shown}${hits.length > 5 ? ", …" : ""}`;
+        return (` The text is present at ${where} but its leading/trailing whitespace differs from ` +
+            "old_string. Re-read that region with read_file and copy the indentation verbatim.");
+    }
+    return "";
+}
+export function applyEdit(text, spec) {
+    if (spec.old_string === spec.new_string) {
+        throw new ToolError("invalid_input", "old_string and new_string are identical — nothing to change.");
+    }
+    const count = countOccurrences(text, spec.old_string);
+    if (count === 0) {
+        if (!spec.replace_all) {
+            const m = findCascadeMatch(text, spec.old_string);
+            if (m && m.spans.length === 1) {
+                const { start, end } = m.spans[0];
+                return {
+                    text: text.slice(0, start) + spec.new_string + text.slice(end),
+                    count: 1,
+                    fuzzy: true,
+                };
+            }
+            if (m) {
+                const lines = m.spans.map((s) => text.slice(0, s.start).split("\n").length);
+                throw new ToolError("ambiguous_match", `old_string was not found exactly; after whitespace-tolerant matching it matched ` +
+                    `${m.spans.length} regions (at lines ${lines.join(", ")}); it must be unique. Add ` +
+                    "surrounding lines, or correct the whitespace so it matches one region exactly.", { lines });
+            }
+        }
+        throw new ToolError("no_match", "old_string not found. It must match the file byte-for-byte (whitespace, " +
+            "indentation, and line breaks included) and must NOT include the line-number " +
+            "prefixes shown by read_file. Re-read the exact region and copy the text verbatim." +
+            diagnoseNoMatch(text, spec.old_string));
+    }
+    if (count > 1 && !spec.replace_all) {
+        const lines = occurrenceLines(text, spec.old_string);
+        const at = lines.length > 0
+            ? ` (at line${lines.length === 1 ? "" : "s"} ${lines.join(", ")}${count > lines.length ? ", …" : ""})`
+            : "";
+        throw new ToolError("ambiguous_match", `old_string matched ${count} times${at}; it must be unique. Add surrounding lines to ` +
+            "make the match unique, or pass replace_all: true to replace every occurrence.");
+    }
+    if (spec.replace_all) {
+        return { text: text.split(spec.old_string).join(spec.new_string), count, fuzzy: false };
+    }
+    const idx = text.indexOf(spec.old_string);
+    return {
+        text: text.slice(0, idx) + spec.new_string + text.slice(idx + spec.old_string.length),
+        count: 1,
+        fuzzy: false,
+    };
+}
+export const editFile = {
+    name: "edit_file",
+    description: "Replace one exact occurrence of `old_string` with `new_string` in a file. `old_string` is " +
+        "matched LITERALLY (not a regex), exactly as read_file shows the text — including whitespace, " +
+        "indentation, and line breaks — but WITHOUT read_file's line-number/tab prefixes. The match " +
+        "MUST be unique: if it appears more than once the call fails (`ambiguous_match`) unless " +
+        "`replace_all` is set; if not found it fails (`no_match`). On failure, re-read the region and " +
+        "copy more surrounding lines verbatim, or set replace_all. For several edits to ONE file use " +
+        "multi_edit; to change MANY files use apply_patch.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File to edit. Relative to workspace root or absolute. Must already exist and be text " +
+                    "(binary is rejected).",
+            },
+            old_string: {
+                type: "string",
+                minLength: 1,
+                description: "Exact text to find. Copy it verbatim from read_file output with the line-number/tab " +
+                    "prefix removed; whitespace, indentation, and newlines must match. Not a regex.",
+            },
+            new_string: {
+                type: "string",
+                description: "Replacement text. May be empty to delete the matched text. Must differ from old_string.",
+            },
+            replace_all: {
+                type: "boolean",
+                default: false,
+                description: "Replace every occurrence instead of requiring a single unique match. Default false.",
+            },
+        },
+        required: ["path", "old_string", "new_string"],
+        additionalProperties: false,
+    },
+    async handler(args, config) {
+        const target = resolvePath(args.path, config.workspaceRoot, config.confineToWorkspace);
+        let count = 0;
+        let fuzzy = false;
+        return editFileLocked(target, args.path, config, (content) => {
+            const r = applyEdit(content, {
+                old_string: args.old_string,
+                new_string: args.new_string,
+                replace_all: args.replace_all,
+            });
+            count = r.count;
+            fuzzy = r.fuzzy;
+            return r.text;
+        }, (rel) => fuzzy
+            ? `Replaced 1 occurrence in ${rel} (matched after a whitespace-tolerant search; the ` +
+                "matched region — including its leading indentation — was replaced by new_string " +
+                "verbatim, so re-read the file to verify the indentation is correct)."
+            : `Replaced ${count} ${count === 1 ? "occurrence" : "occurrences"} in ${rel}.`);
+    },
+};
+//# sourceMappingURL=edit-file.js.map

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

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

package/dist/tools/glob.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const globTool: ToolDef;
+//# sourceMappingURL=glob.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,QAAQ,EAAE,OAgEtB,CAAC"}

package/dist/tools/glob.js

@@ -0,0 +1,64 @@
+import { promises as fs } from "node:fs";
+import { ToolError } from "../errors.js";
+import { resolvePath, displayPath } from "../lib/paths.js";
+import { listFiles, mapLimit, statDirectory, STAT_CONCURRENCY } from "../lib/files.js";
+export const globTool = {
+    name: "glob",
+    description: "Find files (not directories) by glob pattern, returned one path per line, " +
+        "most-recently-modified first. Use when you know part of a name or extension but not the full " +
+        "path. To search file CONTENTS use grep instead. No matches returns the line `(no matches)` — " +
+        "a success, not an error.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            pattern: {
+                type: "string",
+                description: 'Glob pattern, e.g. "**/*.ts" or "src/**/test_*.py". ** matches across directories.',
+            },
+            path: {
+                type: "string",
+                description: "Base directory for the search. Relative to workspace root or absolute. Default: " +
+                    "workspace root.",
+            },
+            respect_gitignore: {
+                type: "boolean",
+                default: true,
+                description: "When true (default), skip files ignored by .gitignore and the .git/ directory.",
+            },
+        },
+        required: ["pattern"],
+        additionalProperties: false,
+    },
+    async handler(args, config) {
+        const pattern = args.pattern;
+        const baseRel = args.path ?? ".";
+        const base = resolvePath(baseRel, config.workspaceRoot, config.confineToWorkspace);
+        const respectGitignore = args.respect_gitignore;
+        await statDirectory(base, baseRel);
+        let files;
+        try {
+            files = await listFiles(base, config.workspaceRoot, { pattern, respectGitignore });
+        }
+        catch (err) {
+            throw new ToolError("invalid_input", `Invalid glob pattern: ${err.message}`, {
+                pattern,
+            });
+        }
+        const stats = await mapLimit(files, STAT_CONCURRENCY, async (abs) => {
+            try {
+                return { abs, mtime: (await fs.stat(abs)).mtimeMs };
+            }
+            catch {
+                return null;
+            }
+        });
+        const withMtime = stats
+            .filter((s) => s !== null)
+            .map((s) => ({ rel: displayPath(s.abs, config.workspaceRoot), mtime: s.mtime }));
+        if (withMtime.length === 0)
+            return "(no matches)";
+        withMtime.sort((a, b) => b.mtime - a.mtime || (a.rel < b.rel ? -1 : 1));
+        return withMtime.map((e) => e.rel).join("\n");
+    },
+};
+//# sourceMappingURL=glob.js.map

package/dist/tools/glob.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const grep: ToolDef;
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAiB1C,eAAO,MAAM,IAAI,EAAE,OA+HlB,CAAC"}