@nervekit/tools 0.1.0

package/dist/execution/filesystem/find.js

@@ -0,0 +1,93 @@
+import { execFile } from "node:child_process";
+import { stat } from "node:fs/promises";
+import { relative } from "node:path";
+import { promisify } from "node:util";
+import { numberArg } from "../common/args.js";
+import { boundText, FILE_OUTPUT_MAX_LINE_CHARS, textBoundaryDetails, } from "../common/output-budget.js";
+import { globToRegExp, walkFiles } from "../common/search-utils.js";
+import { isErrnoException, pathNotFoundMessage, resolveToolPath, } from "./path.js";
+const execFileAsync = promisify(execFile);
+export async function executeFind(args, context) {
+    if (typeof args.pattern !== "string" || args.pattern.length === 0) {
+        throw new Error("Tool argument 'pattern' must be a non-empty string.");
+    }
+    const input = args.path ?? ".";
+    const root = resolveToolPath(context.cwd, input);
+    await stat(root).catch((error) => {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            throw new Error(pathNotFoundMessage("find", input, root));
+        }
+        throw error;
+    });
+    const limit = Math.min(numberArg(args.limit, 1000), 5000);
+    const fd = await runFd(args.pattern, root, limit).catch(() => undefined);
+    const paths = fd ?? (await fallbackFind(root, args.pattern, limit));
+    const entries = paths
+        .slice(0, limit)
+        .map((path) => ({ path, kind: "file" }));
+    const formatted = formatFind(paths, limit);
+    return {
+        path: root,
+        entries,
+        content: formatted.content,
+        contentBlocks: [{ type: "text", text: formatted.content }],
+        details: formatted.details,
+    };
+}
+async function runFd(pattern, root, limit) {
+    const fdArgs = [
+        "--hidden",
+        "--glob",
+        "--type",
+        "file",
+        "--color=never",
+        "--no-require-git",
+        "--max-results",
+        String(limit),
+    ];
+    let effectivePattern = pattern;
+    if (pattern.includes("/")) {
+        fdArgs.push("--full-path");
+        if (!pattern.startsWith("/") && !pattern.startsWith("**/")) {
+            effectivePattern = `**/${pattern}`;
+        }
+    }
+    fdArgs.push("--", effectivePattern, root);
+    const { stdout } = await execFileAsync("fd", fdArgs, {
+        timeout: 30_000,
+        maxBuffer: 1024 * 1024,
+    });
+    return stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((path) => (relative(root, path) || path).replaceAll("\\", "/"));
+}
+async function fallbackFind(root, pattern, limit) {
+    const results = [];
+    const regex = globToRegExp(pattern);
+    await walkFiles(root, root, limit, async (_absolutePath, relativePath) => {
+        if (regex.test(relativePath))
+            results.push(relativePath.replaceAll("\\", "/"));
+    }, () => results.length >= limit);
+    return results;
+}
+function formatFind(paths, limit) {
+    const lines = paths.slice(0, limit);
+    if (lines.length === 0)
+        lines.push("No files found.");
+    if (paths.length >= limit) {
+        lines.push("", `[Result limit ${limit} reached. Increase limit or refine the pattern for more results.]`);
+    }
+    const bounded = boundText(lines.join("\n"), {
+        maxLines: Number.MAX_SAFE_INTEGER,
+        maxLineChars: FILE_OUTPUT_MAX_LINE_CHARS,
+    });
+    return {
+        content: bounded.text,
+        details: bounded.truncated
+            ? { truncation: textBoundaryDetails(bounded) }
+            : undefined,
+    };
+}
+//# sourceMappingURL=find.js.map

package/dist/execution/filesystem/find.js.map

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

package/dist/execution/filesystem/legacy-edit.d.ts

@@ -0,0 +1,9 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../../types.js";
+type NormalizedLegacyEdit = {
+    oldText: string;
+    newText: string;
+};
+export declare function executeLegacyEdit(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+export declare function normalizeLegacyEditOperations(args: Record<string, unknown>): NormalizedLegacyEdit[];
+export {};
+//# sourceMappingURL=legacy-edit.d.ts.map

package/dist/execution/filesystem/legacy-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-edit.d.ts","sourceRoot":"","sources":["../../../src/execution/filesystem/legacy-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAahF,KAAK,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAOjE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAoD9B;AA2DD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,EAAE,CA2BxB"}

package/dist/execution/filesystem/legacy-edit.js

@@ -0,0 +1,122 @@
+import { readFile } from "node:fs/promises";
+import { writeTextFileAtomically } from "./atomic-write.js";
+import { withFileMutationQueue } from "./file-mutation-queue.js";
+import { resolveToolPath } from "./path.js";
+import { detectLineEnding, firstChangedLine, generateDiffString, normalizeForTrimmedMatch, normalizeLineEndings, restoreLineEndings, } from "./text-editing.js";
+export async function executeLegacyEdit(args, context) {
+    const path = resolveToolPath(context.cwd, args.path);
+    const edits = normalizeLegacyEditOperations(args);
+    return withFileMutationQueue(path, async () => {
+        const raw = await readFile(path, "utf8");
+        const bom = raw.startsWith("\uFEFF") ? "\uFEFF" : "";
+        const withoutBom = bom ? raw.slice(1) : raw;
+        const lineEnding = detectLineEnding(withoutBom);
+        const content = normalizeLineEndings(withoutBom);
+        const normalizedEdits = edits.map((edit) => ({
+            oldText: normalizeLineEndings(edit.oldText),
+            newText: normalizeLineEndings(edit.newText),
+        }));
+        const matches = normalizedEdits.map((edit, index) => findUniqueMatch(content, edit, index));
+        const ordered = [...matches].sort((a, b) => a.start - b.start);
+        for (let i = 1; i < ordered.length; i++) {
+            const previous = ordered[i - 1];
+            const current = ordered[i];
+            if (!previous || !current)
+                continue;
+            if (current.start < previous.end) {
+                throw new Error(`edits[${current.index}] overlaps edits[${previous.index}]; merge overlapping changes.`);
+            }
+        }
+        let updated = content;
+        for (const edit of [...ordered].reverse()) {
+            updated = `${updated.slice(0, edit.start)}${edit.newText}${updated.slice(edit.end)}`;
+        }
+        if (updated === content) {
+            throw new Error("Legacy edit would not change the file.");
+        }
+        const restored = bom + restoreLineEndings(updated, lineEnding);
+        await writeTextFileAtomically(path, restored);
+        const contentMessage = `Edited file with ${edits.length} replacement(s).`;
+        return {
+            path,
+            content: contentMessage,
+            contentBlocks: [{ type: "text", text: contentMessage }],
+            details: {
+                diff: generateDiffString(content, updated),
+                firstChangedLine: firstChangedLine(content, updated),
+                lineEnding,
+                bom: Boolean(bom),
+            },
+        };
+    });
+}
+function findUniqueMatch(content, edit, index) {
+    const first = content.indexOf(edit.oldText);
+    if (first >= 0) {
+        if (content.indexOf(edit.oldText, first + edit.oldText.length) >= 0) {
+            throw new Error(`edits[${index}].oldText matched more than once; provide a unique region.`);
+        }
+        return { ...edit, index, start: first, end: first + edit.oldText.length };
+    }
+    const fuzzy = fuzzyFind(content, edit.oldText);
+    if (!fuzzy)
+        throw new Error(`edits[${index}].oldText was not found.`);
+    if (fuzzy.duplicate) {
+        throw new Error(`edits[${index}].oldText matched more than once; provide a unique region.`);
+    }
+    return { ...edit, index, start: fuzzy.start, end: fuzzy.end };
+}
+function fuzzyFind(content, needle) {
+    const normalizedNeedle = normalizeForTrimmedMatch(needle);
+    const lines = content.split("\n");
+    const needleLineCount = needle.split("\n").length;
+    const matches = [];
+    const offsets = [];
+    let offset = 0;
+    for (const line of lines) {
+        offsets.push(offset);
+        offset += line.length + 1;
+    }
+    for (let line = 0; line < lines.length; line += 1) {
+        for (let count = Math.max(1, needleLineCount - 1); count <= needleLineCount + 1; count += 1) {
+            const chunk = lines.slice(line, line + count).join("\n");
+            if (normalizeForTrimmedMatch(chunk) !== normalizedNeedle)
+                continue;
+            const start = offsets[line] ?? 0;
+            const end = start + chunk.length;
+            matches.push({ start, end });
+        }
+    }
+    const first = matches[0];
+    if (!first)
+        return undefined;
+    return { ...first, duplicate: matches.length > 1 };
+}
+export function normalizeLegacyEditOperations(args) {
+    if (Array.isArray(args.edits)) {
+        if (args.edits.length === 0) {
+            throw new Error("Tool argument 'edits' must contain at least one edit.");
+        }
+        return args.edits.map((entry, index) => {
+            if (!entry || typeof entry !== "object") {
+                throw new Error(`edits[${index}] must be an object.`);
+            }
+            const edit = entry;
+            if (typeof edit.oldText !== "string" || edit.oldText.length === 0) {
+                throw new Error(`edits[${index}].oldText must be a non-empty string.`);
+            }
+            if (typeof edit.newText !== "string") {
+                throw new Error(`edits[${index}].newText must be a string.`);
+            }
+            return { oldText: edit.oldText, newText: edit.newText };
+        });
+    }
+    if (typeof args.oldText !== "string" || args.oldText.length === 0) {
+        throw new Error("Tool argument 'oldText' must be a non-empty string.");
+    }
+    if (typeof args.newText !== "string") {
+        throw new Error("Tool argument 'newText' must be a string.");
+    }
+    return [{ oldText: args.oldText, newText: args.newText }];
+}
+//# sourceMappingURL=legacy-edit.js.map

package/dist/execution/filesystem/legacy-edit.js.map

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

package/dist/execution/filesystem/list.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../../types.js";
+export declare function executeLs(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/execution/filesystem/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/execution/filesystem/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAahF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA8C9B"}

package/dist/execution/filesystem/list.js

@@ -0,0 +1,49 @@
+import { readdir, stat } from "node:fs/promises";
+import { numberArg } from "../common/args.js";
+import { boundText, FILE_OUTPUT_MAX_LINE_CHARS, textBoundaryDetails, } from "../common/output-budget.js";
+import { isErrnoException, pathNotFoundMessage, resolveToolPath, } from "./path.js";
+export async function executeLs(args, context) {
+    const input = args.path ?? ".";
+    const root = resolveToolPath(context.cwd, input);
+    const info = await stat(root).catch((error) => {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            throw new Error(pathNotFoundMessage("ls", input, root));
+        }
+        throw error;
+    });
+    if (!info.isDirectory())
+        throw new Error("ls path is not a directory.");
+    const limit = Math.min(numberArg(args.limit, 500), 5000);
+    const dirEntries = await readdir(root, { withFileTypes: true });
+    dirEntries.sort((a, b) => a.name.toLowerCase().localeCompare(b.name.toLowerCase()));
+    const entries = [];
+    for (const entry of dirEntries.slice(0, limit)) {
+        entries.push({
+            path: `${entry.name}${entry.isDirectory() ? "/" : ""}`,
+            kind: entry.isDirectory()
+                ? "directory"
+                : entry.isFile()
+                    ? "file"
+                    : "other",
+        });
+    }
+    let content = entries.map((entry) => entry.path).join("\n");
+    if (dirEntries.length > entries.length) {
+        content += `${content ? "\n\n" : ""}[...${dirEntries.length - entries.length} more entries. Increase limit to see more.]`;
+    }
+    const bounded = boundText(content, {
+        maxLines: Number.MAX_SAFE_INTEGER,
+        maxLineChars: FILE_OUTPUT_MAX_LINE_CHARS,
+    });
+    content = bounded.text;
+    return {
+        path: root,
+        entries,
+        content,
+        contentBlocks: [{ type: "text", text: content }],
+        details: bounded.truncated
+            ? { truncation: textBoundaryDetails(bounded) }
+            : undefined,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/execution/filesystem/list.js.map

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

package/dist/execution/filesystem/path.d.ts

@@ -0,0 +1,7 @@
+export declare function expandToolPathInput(input: string): string;
+export declare function resolveToCwd(cwd: string, input: string): string;
+export declare function resolveToolPath(cwd: string, input: unknown): string;
+export declare function isErrnoException(error: unknown): error is NodeJS.ErrnoException;
+export declare function pathNotFoundMessage(toolName: string, input: unknown, resolvedPath: string): string;
+export declare function resolveReadPath(cwd: string, input: unknown): Promise<string>;
+//# sourceMappingURL=path.d.ts.map

package/dist/execution/filesystem/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/execution/filesystem/path.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,cAAc,CAEhC;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/execution/filesystem/path.js

@@ -0,0 +1,69 @@
+import { access } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, resolve } from "node:path";
+const UNICODE_SPACES = /[\u00a0\u2007\u202f]/g;
+export function expandToolPathInput(input) {
+    let path = input.trim().replace(UNICODE_SPACES, " ").normalize("NFC");
+    if (path.startsWith("@"))
+        path = path.slice(1);
+    if (path === "~")
+        return homedir();
+    if (path.startsWith("~/") || path.startsWith("~\\")) {
+        return resolve(homedir(), path.slice(2));
+    }
+    return path;
+}
+export function resolveToCwd(cwd, input) {
+    const expanded = expandToolPathInput(input);
+    return isAbsolute(expanded) ? resolve(expanded) : resolve(cwd, expanded);
+}
+export function resolveToolPath(cwd, input) {
+    if (typeof input !== "string" || input.trim().length === 0) {
+        throw new Error("Tool argument 'path' must be a non-empty string.");
+    }
+    return resolveToCwd(cwd, input);
+}
+export function isErrnoException(error) {
+    return error instanceof Error && "code" in error;
+}
+export function pathNotFoundMessage(toolName, input, resolvedPath) {
+    const label = typeof input === "string" ? JSON.stringify(input) : "path";
+    return `${toolName} path not found: ${label} (resolved to ${resolvedPath}).`;
+}
+export async function resolveReadPath(cwd, input) {
+    const initial = resolveToolPath(cwd, input);
+    const candidates = readPathCandidates(initial);
+    for (const candidate of candidates) {
+        if (await exists(candidate))
+            return candidate;
+    }
+    return initial;
+}
+function readPathCandidates(path) {
+    const variants = new Set([
+        path,
+        path.normalize("NFC"),
+        path.normalize("NFD"),
+    ]);
+    for (const value of [...variants]) {
+        variants.add(value.replace(UNICODE_SPACES, " "));
+    }
+    // macOS screenshots sometimes use narrow no-break spaces before AM/PM.
+    for (const value of [...variants]) {
+        variants.add(value.replace(/ ([AP]M)(\.[^./]+)?$/u, "\u202f$1$2"));
+        variants.add(value.replace(/\u202f([AP]M)(\.[^./]+)?$/u, " $1$2"));
+        variants.add(value.replace(/[’‘]/g, "'"));
+        variants.add(value.replace(/'/g, "’"));
+    }
+    return [...variants].filter((candidate) => candidate.length > 0);
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=path.js.map

package/dist/execution/filesystem/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/execution/filesystem/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAa;IACrD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAc;IAEd,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,KAAc,EACd,YAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzE,OAAO,GAAG,QAAQ,oBAAoB,KAAK,iBAAiB,YAAY,IAAI,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,KAAc;IAEd,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS;QAC/B,IAAI;QACJ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,uEAAuE;IACvE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1C,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/execution/filesystem/read.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../../types.js";
+export declare function executeRead(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=read.d.ts.map

package/dist/execution/filesystem/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/execution/filesystem/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqDhF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B"}

package/dist/execution/filesystem/read.js

@@ -0,0 +1,225 @@
+import { readFile } from "node:fs/promises";
+import { numberArg } from "../common/args.js";
+import { boundText, FILE_OUTPUT_MAX_LINE_CHARS, textBoundaryDetails, } from "../common/output-budget.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, } from "../common/truncate.js";
+import { isErrnoException, pathNotFoundMessage, resolveReadPath, } from "./path.js";
+const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+const READ_BYTE_DEFAULT_LIMIT = FILE_OUTPUT_MAX_LINE_CHARS;
+const READ_BYTE_MAX_LIMIT = FILE_OUTPUT_MAX_LINE_CHARS;
+function startsWith(buffer, bytes) {
+    if (buffer.length < bytes.length)
+        return false;
+    return bytes.every((byte, index) => buffer[index] === byte);
+}
+function startsWithAscii(buffer, offset, text) {
+    if (buffer.length < offset + text.length)
+        return false;
+    for (let index = 0; index < text.length; index += 1) {
+        if (buffer[offset + index] !== text.charCodeAt(index))
+            return false;
+    }
+    return true;
+}
+function detectSupportedImageMimeType(buffer) {
+    if (startsWith(buffer, [0xff, 0xd8, 0xff]))
+        return "image/jpeg";
+    if (startsWith(buffer, PNG_SIGNATURE))
+        return "image/png";
+    if (startsWithAscii(buffer, 0, "GIF"))
+        return "image/gif";
+    if (startsWithAscii(buffer, 0, "RIFF") &&
+        startsWithAscii(buffer, 8, "WEBP")) {
+        return "image/webp";
+    }
+    return null;
+}
+export async function executeRead(args, context) {
+    const path = await resolveReadPath(context.cwd, args.path);
+    const buffer = await readFile(path).catch((error) => {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            throw new Error(pathNotFoundMessage("read", args.path, path));
+        }
+        throw error;
+    });
+    const hasByteOffset = typeof args.byteOffset === "number";
+    const hasByteLimit = typeof args.byteLimit === "number";
+    const hasByteRange = hasByteOffset || hasByteLimit;
+    const hasExplicitLimit = typeof args.limit === "number";
+    const hasExplicitOffset = typeof args.offset === "number";
+    if (hasByteRange && (hasExplicitLimit || hasExplicitOffset)) {
+        throw new Error("Use either line arguments ('offset'/'limit') or byte arguments ('byteOffset'/'byteLimit'), not both.");
+    }
+    const mimeType = detectSupportedImageMimeType(buffer);
+    if (mimeType && !hasByteRange) {
+        const content = `Read image file [${mimeType}]`;
+        return {
+            path,
+            content,
+            contentBlocks: [
+                { type: "text", text: content },
+                { type: "image", data: buffer.toString("base64"), mimeType },
+            ],
+        };
+    }
+    if (hasByteRange)
+        return readByteRange(path, buffer, args);
+    const content = buffer.toString("utf8");
+    const lines = content.split(/\r?\n/);
+    const offset = numberArg(args.offset, 1);
+    if (hasExplicitLimit || hasExplicitOffset) {
+        const limit = Math.min(numberArg(args.limit, 1000), 5000);
+        const start = Math.max(0, offset - 1);
+        const selected = lines.slice(start, start + limit).join("\n");
+        const remaining = Math.max(0, lines.length - (start + limit));
+        const bounded = boundFileText(selected, { maxLines: limit });
+        const messages = [];
+        if (bounded.truncated) {
+            messages.push(formatSelectedRangeTruncation(bounded));
+        }
+        if (remaining > 0) {
+            messages.push(bounded.truncated
+                ? `[...${remaining} more lines remain after the requested range. Narrow this read range before continuing past it.]`
+                : `[...${remaining} more lines. Continue with offset ${offset + limit}.]`);
+        }
+        const output = [bounded.text, ...messages]
+            .filter((part) => part.length > 0)
+            .join("\n\n");
+        const wasTruncated = bounded.truncated || remaining > 0;
+        return {
+            path,
+            content: output,
+            contentBlocks: [{ type: "text", text: output }],
+            details: wasTruncated
+                ? {
+                    truncation: {
+                        ...textBoundaryDetails(bounded),
+                        truncated: true,
+                        omittedLines: bounded.omittedLines + remaining,
+                        nextOffset: !bounded.truncated && remaining > 0
+                            ? offset + limit
+                            : undefined,
+                    },
+                }
+                : undefined,
+        };
+    }
+    const bounded = boundFileText(content, { maxLines: DEFAULT_MAX_LINES });
+    let output = bounded.text;
+    if (bounded.truncated) {
+        output += `\n\n[...output truncated to ${DEFAULT_MAX_LINES} lines, ${formatSize(DEFAULT_MAX_BYTES)}, or ${FILE_OUTPUT_MAX_LINE_CHARS} characters per line.${formatContinuationGuidance(bounded)}]`;
+    }
+    return {
+        path,
+        content: output,
+        contentBlocks: [{ type: "text", text: output }],
+        details: bounded.truncated
+            ? { truncation: textBoundaryDetails(bounded) }
+            : undefined,
+    };
+}
+function readByteRange(path, buffer, args) {
+    const requestedOffset = Math.min(numberArg(args.byteOffset, 0), buffer.length);
+    const requestedLimit = positiveIntegerArg(args.byteLimit, READ_BYTE_DEFAULT_LIMIT, READ_BYTE_MAX_LIMIT);
+    const requestedEnd = Math.min(buffer.length, requestedOffset + requestedLimit);
+    const slice = safeUtf8Slice(buffer, requestedOffset, requestedEnd);
+    const bounded = boundText(slice.text, {
+        maxBytes: requestedLimit,
+        maxLines: Number.MAX_SAFE_INTEGER,
+        maxLineChars: requestedLimit,
+    });
+    const nextByteOffset = requestedEnd < buffer.length ? requestedEnd : undefined;
+    const messages = [];
+    if (bounded.truncated) {
+        messages.push(formatByteRangeTruncation(bounded));
+    }
+    if (nextByteOffset !== undefined) {
+        messages.push(`[...${formatSize(buffer.length - requestedEnd)} remain after this byte range. Continue with byteOffset ${nextByteOffset}.]`);
+    }
+    const output = [bounded.text, ...messages]
+        .filter((part) => part.length > 0)
+        .join("\n\n");
+    return {
+        path,
+        content: output,
+        contentBlocks: [{ type: "text", text: output }],
+        details: {
+            byteOffset: requestedOffset,
+            byteLimit: requestedLimit,
+            actualByteOffset: slice.start,
+            actualByteEnd: slice.end,
+            size: buffer.length,
+            nextByteOffset,
+            truncation: bounded.truncated ? textBoundaryDetails(bounded) : undefined,
+        },
+    };
+}
+function boundFileText(text, options) {
+    return boundText(text, {
+        maxLines: options.maxLines,
+        maxBytes: DEFAULT_MAX_BYTES,
+        maxLineChars: FILE_OUTPUT_MAX_LINE_CHARS,
+    });
+}
+function countLines(text) {
+    if (text.length === 0)
+        return 0;
+    return text.split("\n").length;
+}
+function formatSelectedRangeTruncation(truncation) {
+    const omissions = formatOmissions(truncation);
+    const guidance = truncation.partialLine || truncation.truncatedLines > 0
+        ? " Use byteOffset/byteLimit to inspect overlong lines exactly."
+        : "";
+    return `[...selected output truncated to ${formatSize(DEFAULT_MAX_BYTES)} or ${FILE_OUTPUT_MAX_LINE_CHARS} characters per line${omissions}.${guidance}]`;
+}
+function formatByteRangeTruncation(truncation) {
+    const omissions = formatOmissions(truncation);
+    return `[...byte range output truncated${omissions}. Use a smaller byteLimit to inspect this range.]`;
+}
+function formatContinuationGuidance(truncation) {
+    if (truncation.partialLine || truncation.truncatedLines > 0) {
+        return " Use byteOffset/byteLimit to inspect overlong lines exactly.";
+    }
+    return ` Continue reading with offset ${countLines(truncation.text) + 1}.`;
+}
+function formatOmissions(truncation) {
+    const parts = [];
+    if (truncation.truncatedLines > 0) {
+        parts.push(`${truncation.truncatedLines} overlong line${truncation.truncatedLines === 1 ? "" : "s"}`);
+    }
+    if (truncation.omittedLines > 0) {
+        parts.push(`${truncation.omittedLines} omitted line${truncation.omittedLines === 1 ? "" : "s"}`);
+    }
+    if (truncation.omittedBytes > 0) {
+        parts.push(`${formatSize(truncation.omittedBytes)} omitted`);
+    }
+    return parts.length > 0 ? ` (${parts.join(", ")})` : "";
+}
+function positiveIntegerArg(value, fallback, max) {
+    const number = numberArg(value, fallback);
+    if (number <= 0)
+        return fallback;
+    return Math.min(number, max);
+}
+function safeUtf8Slice(buffer, start, end) {
+    let safeStart = Math.max(0, Math.min(start, buffer.length));
+    let safeEnd = Math.max(safeStart, Math.min(end, buffer.length));
+    while (safeStart < safeEnd &&
+        isUtf8ContinuationByte(buffer[safeStart] ?? 0)) {
+        safeStart += 1;
+    }
+    while (safeEnd > safeStart &&
+        safeEnd < buffer.length &&
+        isUtf8ContinuationByte(buffer[safeEnd] ?? 0)) {
+        safeEnd -= 1;
+    }
+    return {
+        text: buffer.subarray(safeStart, safeEnd).toString("utf8"),
+        start: safeStart,
+        end: safeEnd,
+    };
+}
+function isUtf8ContinuationByte(byte) {
+    return (byte & 0xc0) === 0x80;
+}
+//# sourceMappingURL=read.js.map