@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/tools/edit.js

@@ -0,0 +1,324 @@
+import { Text } from "@greppleai/grip-tui";
+import { createTwoFilesPatch } from "diff";
+import { Type } from "typebox";
+import { withFileMutationQueue } from "./file-mutation-queue.js";
+import { applyEdits, fmtBoundaryWarning } from "./hashline/apply.js";
+import { initHasher, lineHashes } from "./hashline/hash.js";
+import { resEdits } from "./hashline/resolve.js";
+import { resolveToCwd } from "./path-utils.js";
+import { formatBackendIcon, invalidArgText, shortenPath, str } from "./render-utils.js";
+import { detectEnding, genDiff, restoreEndings, stripBOM, toLF } from "./replace-diff.js";
+import { normReq } from "./replace-normalize.js";
+import { fmtCall, getPreviewInput } from "./replace-render.js";
+import { abortIf } from "./runtime.js";
+import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+const contentLinesSchema = Type.Array(Type.String(), {
+    description: "Literal replacement content, one string per line. Use [] to delete the range. Do not include HASH│ prefixes from read output.",
+});
+const hashRangeInclusiveSchema = Type.Array(Type.String(), {
+    description: "Inclusive hash range to replace [start_hash, end_hash]. Use hash anchors only.",
+    minItems: 2,
+    maxItems: 2,
+});
+const editItemSchema = Type.Object({
+    hash_range_inclusive: hashRangeInclusiveSchema,
+    content_lines: contentLinesSchema,
+}, { additionalProperties: false });
+const editSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to edit (relative or absolute)" }),
+    changes: Type.Array(editItemSchema, {
+        description: "One or more hash-anchored replacements. All anchors must come from the same read snapshot.",
+    }),
+}, { additionalProperties: false });
+function countDiffLines(diff, marker) {
+    let count = 0;
+    for (const line of diff.split("\n")) {
+        if (line.startsWith(marker) && !line.startsWith(`${marker}${marker}${marker}`)) {
+            count++;
+        }
+    }
+    return count;
+}
+function hashStoreKey(operations, absolutePath) {
+    const backend = operations.getBackendInfo?.();
+    if (!backend)
+        return absolutePath;
+    if (backend.type === "remote" && backend.configured)
+        return `remote:${backend.url}:${absolutePath}`;
+    return absolutePath;
+}
+function formatEditCall(args, theme, backendInfo) {
+    const previewInput = getPreviewInput(args);
+    if (previewInput) {
+        return formatBackendIcon(backendInfo, theme) + fmtCall(previewInput, {}, false, theme).replace("replace", "edit");
+    }
+    const invalidArg = invalidArgText(theme);
+    const rawPath = str(args?.file_path ?? args?.path);
+    const path = rawPath !== null ? shortenPath(rawPath) : null;
+    const pathDisplay = path === null ? invalidArg : path ? theme.fg("accent", path) : theme.fg("toolOutput", "...");
+    return `${formatBackendIcon(backendInfo, theme)}${theme.fg("toolTitle", theme.bold("edit"))} ${pathDisplay}`;
+}
+async function computePreview(request, operations) {
+    try {
+        await initHasher();
+        const absolutePath = resolveToCwd(request.path, operations.cwd);
+        await operations.access(absolutePath, "read");
+        const rawContent = (await operations.readFile(absolutePath)).toString("utf-8");
+        const { text } = stripBOM(rawContent);
+        const originalNormalized = toLF(text);
+        const originalHashes = await lineHashes(originalNormalized, hashStoreKey(operations, absolutePath));
+        const result = applyEdits(originalNormalized, resEdits(request.changes), undefined, originalHashes, request.path).content;
+        if (originalNormalized === result) {
+            return { error: `No changes made to ${request.path}. The edits produced identical content.` };
+        }
+        const resultHashes = await lineHashes(result);
+        return { diff: genDiff(originalNormalized, result, 4, resultHashes, originalHashes).diff };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+function normalizeEditArguments(input) {
+    return normReq(input);
+}
+function assertReq(request) {
+    if (!request || typeof request !== "object" || Array.isArray(request)) {
+        throw new Error("[E_BAD_SHAPE] Edit request must be an object.");
+    }
+    const record = request;
+    for (const legacyKey of ["oldText", "newText", "old_text", "new_text", "old_range", "start", "end", "lines"]) {
+        if (Object.hasOwn(record, legacyKey)) {
+            throw new Error(`[E_LEGACY_SHAPE] "${legacyKey}" is not supported. Call read first, then use {hash_range_inclusive: ["<START>", "<END>"], content_lines: [...]}.`);
+        }
+    }
+    const unknown = Object.keys(record).filter((key) => key !== "path" && key !== "changes");
+    if (unknown.length > 0) {
+        throw new Error(`[E_BAD_SHAPE] Edit request contains unknown or unsupported fields: ${unknown.join(", ")}.`);
+    }
+    if (typeof record.path !== "string" || record.path.length === 0) {
+        throw new Error('[E_BAD_SHAPE] Edit request requires a non-empty "path" string.');
+    }
+    if (!Array.isArray(record.changes) || record.changes.length === 0) {
+        throw new Error('[E_BAD_SHAPE] Edit request requires a non-empty "changes" array.');
+    }
+}
+async function readEditSource(path, absolutePath, operations) {
+    try {
+        await operations.access(absolutePath, "readwrite");
+    }
+    catch (error) {
+        const message = error instanceof Error && "code" in error ? `Error code: ${String(error.code)}` : String(error);
+        throw new Error(`Could not edit file: ${path}. ${message}.`);
+    }
+    const rawContent = (await operations.readFile(absolutePath)).toString("utf-8");
+    const { bom, text } = stripBOM(rawContent);
+    const originalContent = toLF(text);
+    const storeKey = hashStoreKey(operations, absolutePath);
+    return {
+        bom,
+        originalEnding: detectEnding(text),
+        originalContent,
+        originalHashes: await lineHashes(originalContent, storeKey),
+        storeKey,
+    };
+}
+function collectRemovedHashes(edits, originalHashes) {
+    const hashIndexes = new Map();
+    for (let index = 0; index < originalHashes.length; index++) {
+        const hash = originalHashes[index];
+        if (hash !== undefined && !hashIndexes.has(hash))
+            hashIndexes.set(hash, index);
+    }
+    const removedHashes = new Set();
+    for (const edit of edits) {
+        const startLine = hashIndexes.get(edit.hash_range_inclusive[0].hash) ?? -1;
+        const endLine = hashIndexes.get(edit.hash_range_inclusive[1].hash) ?? -1;
+        if (startLine < 0 || endLine < 0)
+            continue;
+        for (let index = startLine; index <= endLine; index++) {
+            const hash = originalHashes[index];
+            if (hash)
+                removedHashes.add(hash);
+        }
+    }
+    return removedHashes;
+}
+function indexLineOccurrences(lines) {
+    const indexesByLine = new Map();
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        const indexes = indexesByLine.get(line);
+        if (indexes)
+            indexes.push(index);
+        else
+            indexesByLine.set(line, [index]);
+    }
+    return indexesByLine;
+}
+function collectEditWarnings(anchorResult, resultContent, resultHashes) {
+    const warnings = [...(anchorResult.warnings ?? [])];
+    const resultLines = resultContent.split("\n");
+    const indexesByLine = indexLineOccurrences(resultLines);
+    for (const warning of anchorResult.boundaryWarnings ?? []) {
+        const matchIndex = indexesByLine.get(warning.survivingLineContent)?.[warning.occurrence] ?? -1;
+        if (matchIndex < 0)
+            continue;
+        warnings.push(fmtBoundaryWarning({
+            kind: warning.kind,
+            survivingContent: warning.survivingLineContent,
+            matchIndex,
+            resultLines,
+            resultHashes,
+        }));
+    }
+    return warnings;
+}
+function buildNoopEditResult(path, editCount, anchorResult, warnings) {
+    return {
+        content: [{ type: "text", text: `No changes made to ${path}. The edits produced identical content.` }],
+        details: {
+            diff: "",
+            patch: "",
+            classification: "noop",
+            metrics: {
+                edits_attempted: editCount,
+                edits_noop: anchorResult.noopEdits?.length ?? 0,
+                warnings: warnings.length,
+                classification: "noop",
+            },
+        },
+    };
+}
+function buildAppliedEditResult(options) {
+    const diffResult = genDiff(options.originalContent, options.resultContent, 2, options.resultHashes, options.originalHashes);
+    const warningBlock = options.warnings.length > 0 ? `\n\nWarnings:\n${options.warnings.join("\n")}` : "";
+    const changedLines = options.anchorResult.firstChangedLine !== undefined && options.anchorResult.lastChangedLine !== undefined
+        ? {
+            first: options.anchorResult.firstChangedLine,
+            last: options.anchorResult.lastChangedLine,
+        }
+        : undefined;
+    return {
+        content: [{ type: "text", text: `Successfully replaced in ${options.path}.${warningBlock}` }],
+        details: {
+            diff: diffResult.diff,
+            patch: createTwoFilesPatch(options.path, options.path, options.originalContent, options.resultContent),
+            firstChangedLine: options.anchorResult.firstChangedLine ?? diffResult.firstChangedLine,
+            metrics: {
+                edits_attempted: options.editCount,
+                edits_noop: options.anchorResult.noopEdits?.length ?? 0,
+                warnings: options.warnings.length,
+                classification: "applied",
+                ...(changedLines ? { changed_lines: changedLines } : {}),
+                added_lines: countDiffLines(diffResult.diff, "+"),
+                removed_lines: countDiffLines(diffResult.diff, "-"),
+            },
+        },
+    };
+}
+async function executeEditMutation(request, absolutePath, operations, signal) {
+    abortIf(signal);
+    await initHasher();
+    const source = await readEditSource(request.path, absolutePath, operations);
+    const resolvedEdits = resEdits(request.changes);
+    const anchorResult = applyEdits(source.originalContent, resolvedEdits, signal, source.originalHashes, request.path);
+    const resultContent = anchorResult.content;
+    const resultHashes = await lineHashes(resultContent, source.storeKey, {
+        content: source.originalContent,
+        hashes: source.originalHashes,
+        removedHashes: collectRemovedHashes(resolvedEdits, source.originalHashes),
+    });
+    const warnings = collectEditWarnings(anchorResult, resultContent, resultHashes);
+    if (source.originalContent === resultContent) {
+        return buildNoopEditResult(request.path, request.changes.length, anchorResult, warnings);
+    }
+    abortIf(signal);
+    await operations.writeFile(absolutePath, source.bom + restoreEndings(resultContent, source.originalEnding));
+    return buildAppliedEditResult({
+        path: request.path,
+        editCount: request.changes.length,
+        anchorResult,
+        warnings,
+        originalContent: source.originalContent,
+        resultContent,
+        originalHashes: source.originalHashes,
+        resultHashes,
+    });
+}
+export function createEditToolDefinition(operations, _options) {
+    return {
+        name: "edit",
+        label: "edit",
+        description: "Edit a file using hash-anchored line replacements. Call read first; it returns HASH│content lines. Use hash_range_inclusive with the 3-character start/end hashes and content_lines with literal replacement lines only.",
+        promptSnippet: "Edit files using hashline anchors from read output",
+        promptGuidelines: [
+            "Use read before edit to get HASH│content anchors.",
+            "Use edit with changes: [{ hash_range_inclusive: [startHash, endHash], content_lines: [...] }].",
+            "hash_range_inclusive contains only the 3-character hashes, not line numbers and not HASH│content.",
+            "content_lines contains literal file content only; do not include HASH│ prefixes. Use [] to delete a range.",
+            "After a successful edit, call read again before follow-up edits unless the response includes current warning anchors.",
+        ],
+        parameters: editSchema,
+        renderShell: "default",
+        prepareArguments: normalizeEditArguments,
+        async execute(_toolCallId, input, signal) {
+            const normalized = normReq(input);
+            assertReq(normalized);
+            const absolutePath = resolveToCwd(normalized.path, operations.cwd);
+            return withFileMutationQueue(absolutePath, () => executeEditMutation(normalized, absolutePath, operations, signal));
+        },
+        renderCall(args, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            const previewInput = getPreviewInput(args);
+            if (!context.executionStarted && context.argsComplete && previewInput) {
+                const argsKey = JSON.stringify(previewInput);
+                if (context.state.argsKey !== argsKey) {
+                    context.state.argsKey = argsKey;
+                    context.state.preview = undefined;
+                    const generation = (context.state.previewGeneration ?? 0) + 1;
+                    context.state.previewGeneration = generation;
+                    void computePreview(previewInput, operations).then((preview) => {
+                        if (context.state.argsKey === argsKey && context.state.previewGeneration === generation) {
+                            context.state.preview = preview;
+                            context.invalidate();
+                        }
+                    });
+                }
+                text.setText(formatBackendIcon(operations.getBackendInfo?.(), theme) +
+                    fmtCall(previewInput, context.state, context.expanded, theme).replace("replace", "edit"));
+                return text;
+            }
+            text.setText(formatEditCall(args, theme, operations.getBackendInfo?.()));
+            return text;
+        },
+        renderResult(result, _options, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            if (context.isError) {
+                const errorText = result.content
+                    ?.filter((entry) => entry.type === "text")
+                    .map((entry) => entry.text ?? "")
+                    .join("\n");
+                text.setText(errorText ? `\n${theme.fg("error", errorText)}` : "");
+                return text;
+            }
+            const diff = result.details?.diff;
+            if (!diff) {
+                text.setText("");
+                return text;
+            }
+            const lines = diff.split("\n").map((line) => {
+                if (line.startsWith("+") && !line.startsWith("+++"))
+                    return theme.fg("success", line);
+                if (line.startsWith("-") && !line.startsWith("---"))
+                    return theme.fg("error", line);
+                return theme.fg("dim", line);
+            });
+            text.setText(`\n${lines.join("\n")}`);
+            return text;
+        },
+    };
+}
+export function createEditTool(operations, options) {
+    return wrapToolDefinition(createEditToolDefinition(operations, options));
+}
+//# sourceMappingURL=edit.js.map

package/dist/core/tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/core/tools/edit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from \"@greppleai/grip-agent-core\";\nimport { Text } from \"@greppleai/grip-tui\";\nimport { createTwoFilesPatch } from \"diff\";\nimport { type Static, Type } from \"typebox\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { withFileMutationQueue } from \"./file-mutation-queue.ts\";\nimport { type ApplyEditsResult, applyEdits, fmtBoundaryWarning } from \"./hashline/apply.ts\";\nimport { initHasher, lineHashes } from \"./hashline/hash.ts\";\nimport { type HEdit, type HTEdit, resEdits } from \"./hashline/resolve.ts\";\nimport type { ToolBackendInfo, ToolOperations } from \"./operations.ts\";\nimport { resolveToCwd } from \"./path-utils.ts\";\nimport { formatBackendIcon, invalidArgText, shortenPath, str } from \"./render-utils.ts\";\nimport { detectEnding, genDiff, type LineEnding, restoreEndings, stripBOM, toLF } from \"./replace-diff.ts\";\nimport { normReq } from \"./replace-normalize.ts\";\nimport { fmtCall, getPreviewInput, type RPreview, type RRState } from \"./replace-render.ts\";\nimport { abortIf } from \"./runtime.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\n\nconst contentLinesSchema = Type.Array(Type.String(), {\n\tdescription:\n\t\t\"Literal replacement content, one string per line. Use [] to delete the range. Do not include HASH│ prefixes from read output.\",\n});\n\nconst hashRangeInclusiveSchema = Type.Array(Type.String(), {\n\tdescription: \"Inclusive hash range to replace [start_hash, end_hash]. Use hash anchors only.\",\n\tminItems: 2,\n\tmaxItems: 2,\n});\n\nconst editItemSchema = Type.Object(\n\t{\n\t\thash_range_inclusive: hashRangeInclusiveSchema,\n\t\tcontent_lines: contentLinesSchema,\n\t},\n\t{ additionalProperties: false },\n);\n\nconst editSchema = Type.Object(\n\t{\n\t\tpath: Type.String({ description: \"Path to the file to edit (relative or absolute)\" }),\n\t\tchanges: Type.Array(editItemSchema, {\n\t\t\tdescription: \"One or more hash-anchored replacements. All anchors must come from the same read snapshot.\",\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type EditToolInput = Static<typeof editSchema>;\n\nexport type ReqParams = {\n\tpath: string;\n\tchanges: HTEdit[];\n};\ninterface EditChangedLineRange {\n\tfirst: number;\n\tlast: number;\n}\n\nexport type RMetrics = {\n\tedits_attempted: number;\n\tedits_noop: number;\n\twarnings: number;\n\tclassification: \"applied\" | \"noop\";\n\tchanged_lines?: EditChangedLineRange;\n\tadded_lines?: number;\n\tremoved_lines?: number;\n};\n\nexport interface ReplaceDetails {\n\tdiff: string;\n\tpatch: string;\n\tfirstChangedLine?: number;\n\tclassification?: \"noop\";\n\tmetrics?: RMetrics;\n}\n\nexport type EditToolDetails = ReplaceDetails;\n\nexport interface EditToolOptions {}\n\ntype EditRenderState = RRState;\ntype DiffLineMarker = \"+\" | \"-\";\n\ntype RenderableEditArgs = {\n\tpath?: string;\n\tfile_path?: string;\n\tchanges?: HTEdit[];\n\tedits?: HTEdit[];\n\thash_range_inclusive?: [string, string];\n\tcontent_lines?: string[];\n};\n\nfunction countDiffLines(diff: string, marker: DiffLineMarker): number {\n\tlet count = 0;\n\tfor (const line of diff.split(\"\\n\")) {\n\t\tif (line.startsWith(marker) && !line.startsWith(`${marker}${marker}${marker}`)) {\n\t\t\tcount++;\n\t\t}\n\t}\n\treturn count;\n}\n\nfunction hashStoreKey(operations: ToolOperations, absolutePath: string): string {\n\tconst backend = operations.getBackendInfo?.();\n\tif (!backend) return absolutePath;\n\tif (backend.type === \"remote\" && backend.configured) return `remote:${backend.url}:${absolutePath}`;\n\treturn absolutePath;\n}\n\nfunction formatEditCall(\n\targs: RenderableEditArgs | undefined,\n\ttheme: Theme,\n\tbackendInfo: ToolBackendInfo | undefined,\n): string {\n\tconst previewInput = getPreviewInput(args);\n\tif (previewInput) {\n\t\treturn formatBackendIcon(backendInfo, theme) + fmtCall(previewInput, {}, false, theme).replace(\"replace\", \"edit\");\n\t}\n\tconst invalidArg = invalidArgText(theme);\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tconst path = rawPath !== null ? shortenPath(rawPath) : null;\n\tconst pathDisplay = path === null ? invalidArg : path ? theme.fg(\"accent\", path) : theme.fg(\"toolOutput\", \"...\");\n\treturn `${formatBackendIcon(backendInfo, theme)}${theme.fg(\"toolTitle\", theme.bold(\"edit\"))} ${pathDisplay}`;\n}\n\nasync function computePreview(request: ReqParams, operations: ToolOperations): Promise<RPreview> {\n\ttry {\n\t\tawait initHasher();\n\t\tconst absolutePath = resolveToCwd(request.path, operations.cwd);\n\t\tawait operations.access(absolutePath, \"read\");\n\t\tconst rawContent = (await operations.readFile(absolutePath)).toString(\"utf-8\");\n\t\tconst { text } = stripBOM(rawContent);\n\t\tconst originalNormalized = toLF(text);\n\t\tconst originalHashes = await lineHashes(originalNormalized, hashStoreKey(operations, absolutePath));\n\t\tconst result = applyEdits(\n\t\t\toriginalNormalized,\n\t\t\tresEdits(request.changes),\n\t\t\tundefined,\n\t\t\toriginalHashes,\n\t\t\trequest.path,\n\t\t).content;\n\t\tif (originalNormalized === result) {\n\t\t\treturn { error: `No changes made to ${request.path}. The edits produced identical content.` };\n\t\t}\n\t\tconst resultHashes = await lineHashes(result);\n\t\treturn { diff: genDiff(originalNormalized, result, 4, resultHashes, originalHashes).diff };\n\t} catch (error) {\n\t\treturn { error: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\nfunction normalizeEditArguments(input: unknown): EditToolInput {\n\treturn normReq(input) as EditToolInput;\n}\n\nfunction assertReq(request: unknown): asserts request is ReqParams {\n\tif (!request || typeof request !== \"object\" || Array.isArray(request)) {\n\t\tthrow new Error(\"[E_BAD_SHAPE] Edit request must be an object.\");\n\t}\n\tconst record = request as Record<string, unknown>;\n\tfor (const legacyKey of [\"oldText\", \"newText\", \"old_text\", \"new_text\", \"old_range\", \"start\", \"end\", \"lines\"]) {\n\t\tif (Object.hasOwn(record, legacyKey)) {\n\t\t\tthrow new Error(\n\t\t\t\t`[E_LEGACY_SHAPE] \"${legacyKey}\" is not supported. Call read first, then use {hash_range_inclusive: [\"<START>\", \"<END>\"], content_lines: [...]}.`,\n\t\t\t);\n\t\t}\n\t}\n\tconst unknown = Object.keys(record).filter((key) => key !== \"path\" && key !== \"changes\");\n\tif (unknown.length > 0) {\n\t\tthrow new Error(`[E_BAD_SHAPE] Edit request contains unknown or unsupported fields: ${unknown.join(\", \")}.`);\n\t}\n\tif (typeof record.path !== \"string\" || record.path.length === 0) {\n\t\tthrow new Error('[E_BAD_SHAPE] Edit request requires a non-empty \"path\" string.');\n\t}\n\tif (!Array.isArray(record.changes) || record.changes.length === 0) {\n\t\tthrow new Error('[E_BAD_SHAPE] Edit request requires a non-empty \"changes\" array.');\n\t}\n}\ninterface EditSourceSnapshot {\n\tbom: string;\n\toriginalEnding: LineEnding;\n\toriginalContent: string;\n\toriginalHashes: string[];\n\tstoreKey: string;\n}\n\ninterface AppliedEditResultOptions {\n\tpath: string;\n\teditCount: number;\n\tanchorResult: ApplyEditsResult;\n\twarnings: string[];\n\toriginalContent: string;\n\tresultContent: string;\n\toriginalHashes: string[];\n\tresultHashes: string[];\n}\n\nasync function readEditSource(\n\tpath: string,\n\tabsolutePath: string,\n\toperations: ToolOperations,\n): Promise<EditSourceSnapshot> {\n\ttry {\n\t\tawait operations.access(absolutePath, \"readwrite\");\n\t} catch (error) {\n\t\tconst message = error instanceof Error && \"code\" in error ? `Error code: ${String(error.code)}` : String(error);\n\t\tthrow new Error(`Could not edit file: ${path}. ${message}.`);\n\t}\n\tconst rawContent = (await operations.readFile(absolutePath)).toString(\"utf-8\");\n\tconst { bom, text } = stripBOM(rawContent);\n\tconst originalContent = toLF(text);\n\tconst storeKey = hashStoreKey(operations, absolutePath);\n\treturn {\n\t\tbom,\n\t\toriginalEnding: detectEnding(text),\n\t\toriginalContent,\n\t\toriginalHashes: await lineHashes(originalContent, storeKey),\n\t\tstoreKey,\n\t};\n}\n\nfunction collectRemovedHashes(edits: HEdit[], originalHashes: string[]): Set<string> {\n\tconst hashIndexes = new Map<string, number>();\n\tfor (let index = 0; index < originalHashes.length; index++) {\n\t\tconst hash = originalHashes[index];\n\t\tif (hash !== undefined && !hashIndexes.has(hash)) hashIndexes.set(hash, index);\n\t}\n\tconst removedHashes = new Set<string>();\n\tfor (const edit of edits) {\n\t\tconst startLine = hashIndexes.get(edit.hash_range_inclusive[0].hash) ?? -1;\n\t\tconst endLine = hashIndexes.get(edit.hash_range_inclusive[1].hash) ?? -1;\n\t\tif (startLine < 0 || endLine < 0) continue;\n\t\tfor (let index = startLine; index <= endLine; index++) {\n\t\t\tconst hash = originalHashes[index];\n\t\t\tif (hash) removedHashes.add(hash);\n\t\t}\n\t}\n\treturn removedHashes;\n}\n\nfunction indexLineOccurrences(lines: string[]): Map<string, number[]> {\n\tconst indexesByLine = new Map<string, number[]>();\n\tfor (let index = 0; index < lines.length; index++) {\n\t\tconst line = lines[index];\n\t\tconst indexes = indexesByLine.get(line);\n\t\tif (indexes) indexes.push(index);\n\t\telse indexesByLine.set(line, [index]);\n\t}\n\treturn indexesByLine;\n}\n\nfunction collectEditWarnings(anchorResult: ApplyEditsResult, resultContent: string, resultHashes: string[]): string[] {\n\tconst warnings = [...(anchorResult.warnings ?? [])];\n\tconst resultLines = resultContent.split(\"\\n\");\n\tconst indexesByLine = indexLineOccurrences(resultLines);\n\tfor (const warning of anchorResult.boundaryWarnings ?? []) {\n\t\tconst matchIndex = indexesByLine.get(warning.survivingLineContent)?.[warning.occurrence] ?? -1;\n\t\tif (matchIndex < 0) continue;\n\t\twarnings.push(\n\t\t\tfmtBoundaryWarning({\n\t\t\t\tkind: warning.kind,\n\t\t\t\tsurvivingContent: warning.survivingLineContent,\n\t\t\t\tmatchIndex,\n\t\t\t\tresultLines,\n\t\t\t\tresultHashes,\n\t\t\t}),\n\t\t);\n\t}\n\treturn warnings;\n}\n\nfunction buildNoopEditResult(\n\tpath: string,\n\teditCount: number,\n\tanchorResult: ApplyEditsResult,\n\twarnings: string[],\n): AgentToolResult<EditToolDetails> {\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `No changes made to ${path}. The edits produced identical content.` }],\n\t\tdetails: {\n\t\t\tdiff: \"\",\n\t\t\tpatch: \"\",\n\t\t\tclassification: \"noop\",\n\t\t\tmetrics: {\n\t\t\t\tedits_attempted: editCount,\n\t\t\t\tedits_noop: anchorResult.noopEdits?.length ?? 0,\n\t\t\t\twarnings: warnings.length,\n\t\t\t\tclassification: \"noop\",\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction buildAppliedEditResult(options: AppliedEditResultOptions): AgentToolResult<EditToolDetails> {\n\tconst diffResult = genDiff(\n\t\toptions.originalContent,\n\t\toptions.resultContent,\n\t\t2,\n\t\toptions.resultHashes,\n\t\toptions.originalHashes,\n\t);\n\tconst warningBlock = options.warnings.length > 0 ? `\\n\\nWarnings:\\n${options.warnings.join(\"\\n\")}` : \"\";\n\tconst changedLines =\n\t\toptions.anchorResult.firstChangedLine !== undefined && options.anchorResult.lastChangedLine !== undefined\n\t\t\t? {\n\t\t\t\t\tfirst: options.anchorResult.firstChangedLine,\n\t\t\t\t\tlast: options.anchorResult.lastChangedLine,\n\t\t\t\t}\n\t\t\t: undefined;\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `Successfully replaced in ${options.path}.${warningBlock}` }],\n\t\tdetails: {\n\t\t\tdiff: diffResult.diff,\n\t\t\tpatch: createTwoFilesPatch(options.path, options.path, options.originalContent, options.resultContent),\n\t\t\tfirstChangedLine: options.anchorResult.firstChangedLine ?? diffResult.firstChangedLine,\n\t\t\tmetrics: {\n\t\t\t\tedits_attempted: options.editCount,\n\t\t\t\tedits_noop: options.anchorResult.noopEdits?.length ?? 0,\n\t\t\t\twarnings: options.warnings.length,\n\t\t\t\tclassification: \"applied\",\n\t\t\t\t...(changedLines ? { changed_lines: changedLines } : {}),\n\t\t\t\tadded_lines: countDiffLines(diffResult.diff, \"+\"),\n\t\t\t\tremoved_lines: countDiffLines(diffResult.diff, \"-\"),\n\t\t\t},\n\t\t},\n\t};\n}\n\nasync function executeEditMutation(\n\trequest: ReqParams,\n\tabsolutePath: string,\n\toperations: ToolOperations,\n\tsignal: AbortSignal | undefined,\n): Promise<AgentToolResult<EditToolDetails>> {\n\tabortIf(signal);\n\tawait initHasher();\n\tconst source = await readEditSource(request.path, absolutePath, operations);\n\tconst resolvedEdits = resEdits(request.changes);\n\tconst anchorResult = applyEdits(source.originalContent, resolvedEdits, signal, source.originalHashes, request.path);\n\tconst resultContent = anchorResult.content;\n\tconst resultHashes = await lineHashes(resultContent, source.storeKey, {\n\t\tcontent: source.originalContent,\n\t\thashes: source.originalHashes,\n\t\tremovedHashes: collectRemovedHashes(resolvedEdits, source.originalHashes),\n\t});\n\tconst warnings = collectEditWarnings(anchorResult, resultContent, resultHashes);\n\tif (source.originalContent === resultContent) {\n\t\treturn buildNoopEditResult(request.path, request.changes.length, anchorResult, warnings);\n\t}\n\tabortIf(signal);\n\tawait operations.writeFile(absolutePath, source.bom + restoreEndings(resultContent, source.originalEnding));\n\treturn buildAppliedEditResult({\n\t\tpath: request.path,\n\t\teditCount: request.changes.length,\n\t\tanchorResult,\n\t\twarnings,\n\t\toriginalContent: source.originalContent,\n\t\tresultContent,\n\t\toriginalHashes: source.originalHashes,\n\t\tresultHashes,\n\t});\n}\n\nexport type EditToolDefinition = ToolDefinition<typeof editSchema, EditToolDetails | undefined, EditRenderState>;\n\nexport function createEditToolDefinition(operations: ToolOperations, _options?: EditToolOptions): EditToolDefinition {\n\treturn {\n\t\tname: \"edit\",\n\t\tlabel: \"edit\",\n\t\tdescription:\n\t\t\t\"Edit a file using hash-anchored line replacements. Call read first; it returns HASH│content lines. Use hash_range_inclusive with the 3-character start/end hashes and content_lines with literal replacement lines only.\",\n\t\tpromptSnippet: \"Edit files using hashline anchors from read output\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use read before edit to get HASH│content anchors.\",\n\t\t\t\"Use edit with changes: [{ hash_range_inclusive: [startHash, endHash], content_lines: [...] }].\",\n\t\t\t\"hash_range_inclusive contains only the 3-character hashes, not line numbers and not HASH│content.\",\n\t\t\t\"content_lines contains literal file content only; do not include HASH│ prefixes. Use [] to delete a range.\",\n\t\t\t\"After a successful edit, call read again before follow-up edits unless the response includes current warning anchors.\",\n\t\t],\n\t\tparameters: editSchema,\n\t\trenderShell: \"default\",\n\t\tprepareArguments: normalizeEditArguments,\n\t\tasync execute(_toolCallId, input: EditToolInput, signal?: AbortSignal) {\n\t\t\tconst normalized = normReq(input);\n\t\t\tassertReq(normalized);\n\t\t\tconst absolutePath = resolveToCwd(normalized.path, operations.cwd);\n\t\t\treturn withFileMutationQueue(absolutePath, () =>\n\t\t\t\texecuteEditMutation(normalized, absolutePath, operations, signal),\n\t\t\t);\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\tconst previewInput = getPreviewInput(args);\n\t\t\tif (!context.executionStarted && context.argsComplete && previewInput) {\n\t\t\t\tconst argsKey = JSON.stringify(previewInput);\n\t\t\t\tif (context.state.argsKey !== argsKey) {\n\t\t\t\t\tcontext.state.argsKey = argsKey;\n\t\t\t\t\tcontext.state.preview = undefined;\n\t\t\t\t\tconst generation = (context.state.previewGeneration ?? 0) + 1;\n\t\t\t\t\tcontext.state.previewGeneration = generation;\n\t\t\t\t\tvoid computePreview(previewInput, operations).then((preview) => {\n\t\t\t\t\t\tif (context.state.argsKey === argsKey && context.state.previewGeneration === generation) {\n\t\t\t\t\t\t\tcontext.state.preview = preview;\n\t\t\t\t\t\t\tcontext.invalidate();\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\ttext.setText(\n\t\t\t\t\tformatBackendIcon(operations.getBackendInfo?.(), theme) +\n\t\t\t\t\t\tfmtCall(previewInput, context.state, context.expanded, theme).replace(\"replace\", \"edit\"),\n\t\t\t\t);\n\t\t\t\treturn text;\n\t\t\t}\n\t\t\ttext.setText(formatEditCall(args as RenderableEditArgs | undefined, theme, operations.getBackendInfo?.()));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, _options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\tif (context.isError) {\n\t\t\t\tconst errorText = result.content\n\t\t\t\t\t?.filter((entry) => entry.type === \"text\")\n\t\t\t\t\t.map((entry) => entry.text ?? \"\")\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\ttext.setText(errorText ? `\\n${theme.fg(\"error\", errorText)}` : \"\");\n\t\t\t\treturn text;\n\t\t\t}\n\t\t\tconst diff = result.details?.diff;\n\t\t\tif (!diff) {\n\t\t\t\ttext.setText(\"\");\n\t\t\t\treturn text;\n\t\t\t}\n\t\t\tconst lines = diff.split(\"\\n\").map((line) => {\n\t\t\t\tif (line.startsWith(\"+\") && !line.startsWith(\"+++\")) return theme.fg(\"success\", line);\n\t\t\t\tif (line.startsWith(\"-\") && !line.startsWith(\"---\")) return theme.fg(\"error\", line);\n\t\t\t\treturn theme.fg(\"dim\", line);\n\t\t\t});\n\t\t\ttext.setText(`\\n${lines.join(\"\\n\")}`);\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\ntype CompatibleEditAgentTool = AgentTool<typeof editSchema, EditToolDetails> & {\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Record<string, unknown>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<EditToolDetails>,\n\t) => Promise<AgentToolResult<EditToolDetails>>;\n};\n\nexport function createEditTool(operations: ToolOperations, options?: EditToolOptions): CompatibleEditAgentTool {\n\treturn wrapToolDefinition(createEditToolDefinition(operations, options)) as CompatibleEditAgentTool;\n}\n"]}

package/dist/core/tools/file-mutation-queue.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serialize file mutation operations targeting the same file.
+ * Operations for different files still run in parallel.
+ */
+export declare function withFileMutationQueue<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=file-mutation-queue.d.ts.map

package/dist/core/tools/file-mutation-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mutation-queue.d.ts","sourceRoot":"","sources":["../../../src/core/tools/file-mutation-queue.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA6BjG","sourcesContent":["import { realpath } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\n\nconst fileMutationQueues = new Map<string, Promise<void>>();\nlet registrationQueue = Promise.resolve();\n\nfunction isMissingPathError(error: unknown): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error.code === \"ENOENT\" || error.code === \"ENOTDIR\")\n\t);\n}\n\nasync function getMutationQueueKey(filePath: string): Promise<string> {\n\tconst resolvedPath = resolve(filePath);\n\tconst missingSegments: string[] = [];\n\tlet existingAncestor = resolvedPath;\n\n\twhile (true) {\n\t\ttry {\n\t\t\tconst canonicalAncestor = await realpath(existingAncestor);\n\t\t\treturn missingSegments.length > 0 ? join(canonicalAncestor, ...missingSegments) : canonicalAncestor;\n\t\t} catch (error) {\n\t\t\tif (!isMissingPathError(error)) throw error;\n\t\t\tconst parent = dirname(existingAncestor);\n\t\t\tif (parent === existingAncestor) return resolvedPath;\n\t\t\tmissingSegments.unshift(basename(existingAncestor));\n\t\t\texistingAncestor = parent;\n\t\t}\n\t}\n}\n\n/**\n * Serialize file mutation operations targeting the same file.\n * Operations for different files still run in parallel.\n */\nexport async function withFileMutationQueue<T>(filePath: string, fn: () => Promise<T>): Promise<T> {\n\tconst registration = registrationQueue.then(async () => {\n\t\tconst key = await getMutationQueueKey(filePath);\n\t\tconst currentQueue = fileMutationQueues.get(key) ?? Promise.resolve();\n\n\t\tlet releaseNext!: () => void;\n\t\tconst nextQueue = new Promise<void>((resolveQueue) => {\n\t\t\treleaseNext = resolveQueue;\n\t\t});\n\t\tconst chainedQueue = currentQueue.then(() => nextQueue);\n\t\tfileMutationQueues.set(key, chainedQueue);\n\n\t\treturn { key, currentQueue, chainedQueue, releaseNext };\n\t});\n\tregistrationQueue = registration.then(\n\t\t() => undefined,\n\t\t() => undefined,\n\t);\n\n\tconst { key, currentQueue, chainedQueue, releaseNext } = await registration;\n\tawait currentQueue;\n\ttry {\n\t\treturn await fn();\n\t} finally {\n\t\treleaseNext();\n\t\tif (fileMutationQueues.get(key) === chainedQueue) {\n\t\t\tfileMutationQueues.delete(key);\n\t\t}\n\t}\n}\n"]}

package/dist/core/tools/file-mutation-queue.js

@@ -0,0 +1,60 @@
+import { realpath } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+const fileMutationQueues = new Map();
+let registrationQueue = Promise.resolve();
+function isMissingPathError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
+async function getMutationQueueKey(filePath) {
+    const resolvedPath = resolve(filePath);
+    const missingSegments = [];
+    let existingAncestor = resolvedPath;
+    while (true) {
+        try {
+            const canonicalAncestor = await realpath(existingAncestor);
+            return missingSegments.length > 0 ? join(canonicalAncestor, ...missingSegments) : canonicalAncestor;
+        }
+        catch (error) {
+            if (!isMissingPathError(error))
+                throw error;
+            const parent = dirname(existingAncestor);
+            if (parent === existingAncestor)
+                return resolvedPath;
+            missingSegments.unshift(basename(existingAncestor));
+            existingAncestor = parent;
+        }
+    }
+}
+/**
+ * Serialize file mutation operations targeting the same file.
+ * Operations for different files still run in parallel.
+ */
+export async function withFileMutationQueue(filePath, fn) {
+    const registration = registrationQueue.then(async () => {
+        const key = await getMutationQueueKey(filePath);
+        const currentQueue = fileMutationQueues.get(key) ?? Promise.resolve();
+        let releaseNext;
+        const nextQueue = new Promise((resolveQueue) => {
+            releaseNext = resolveQueue;
+        });
+        const chainedQueue = currentQueue.then(() => nextQueue);
+        fileMutationQueues.set(key, chainedQueue);
+        return { key, currentQueue, chainedQueue, releaseNext };
+    });
+    registrationQueue = registration.then(() => undefined, () => undefined);
+    const { key, currentQueue, chainedQueue, releaseNext } = await registration;
+    await currentQueue;
+    try {
+        return await fn();
+    }
+    finally {
+        releaseNext();
+        if (fileMutationQueues.get(key) === chainedQueue) {
+            fileMutationQueues.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=file-mutation-queue.js.map

package/dist/core/tools/file-mutation-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mutation-queue.js","sourceRoot":"","sources":["../../../src/core/tools/file-mutation-queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { realpath } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\n\nconst fileMutationQueues = new Map<string, Promise<void>>();\nlet registrationQueue = Promise.resolve();\n\nfunction isMissingPathError(error: unknown): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error.code === \"ENOENT\" || error.code === \"ENOTDIR\")\n\t);\n}\n\nasync function getMutationQueueKey(filePath: string): Promise<string> {\n\tconst resolvedPath = resolve(filePath);\n\tconst missingSegments: string[] = [];\n\tlet existingAncestor = resolvedPath;\n\n\twhile (true) {\n\t\ttry {\n\t\t\tconst canonicalAncestor = await realpath(existingAncestor);\n\t\t\treturn missingSegments.length > 0 ? join(canonicalAncestor, ...missingSegments) : canonicalAncestor;\n\t\t} catch (error) {\n\t\t\tif (!isMissingPathError(error)) throw error;\n\t\t\tconst parent = dirname(existingAncestor);\n\t\t\tif (parent === existingAncestor) return resolvedPath;\n\t\t\tmissingSegments.unshift(basename(existingAncestor));\n\t\t\texistingAncestor = parent;\n\t\t}\n\t}\n}\n\n/**\n * Serialize file mutation operations targeting the same file.\n * Operations for different files still run in parallel.\n */\nexport async function withFileMutationQueue<T>(filePath: string, fn: () => Promise<T>): Promise<T> {\n\tconst registration = registrationQueue.then(async () => {\n\t\tconst key = await getMutationQueueKey(filePath);\n\t\tconst currentQueue = fileMutationQueues.get(key) ?? Promise.resolve();\n\n\t\tlet releaseNext!: () => void;\n\t\tconst nextQueue = new Promise<void>((resolveQueue) => {\n\t\t\treleaseNext = resolveQueue;\n\t\t});\n\t\tconst chainedQueue = currentQueue.then(() => nextQueue);\n\t\tfileMutationQueues.set(key, chainedQueue);\n\n\t\treturn { key, currentQueue, chainedQueue, releaseNext };\n\t});\n\tregistrationQueue = registration.then(\n\t\t() => undefined,\n\t\t() => undefined,\n\t);\n\n\tconst { key, currentQueue, chainedQueue, releaseNext } = await registration;\n\tawait currentQueue;\n\ttry {\n\t\treturn await fn();\n\t} finally {\n\t\treleaseNext();\n\t\tif (fileMutationQueues.get(key) === chainedQueue) {\n\t\t\tfileMutationQueues.delete(key);\n\t\t}\n\t}\n}\n"]}

package/dist/core/tools/find.d.ts

@@ -0,0 +1,22 @@
+import type { AgentTool } from "@greppleai/grip-agent-core";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { ToolOperations } from "./operations.ts";
+import { type TruncationResult } from "./truncate.ts";
+declare const findSchema: Type.TObject<{
+    pattern: Type.TString;
+    path: Type.TOptional<Type.TString>;
+    limit: Type.TOptional<Type.TNumber>;
+}>;
+export type FindToolInput = Static<typeof findSchema>;
+export interface FindToolDetails {
+    truncation?: TruncationResult;
+    resultLimitReached?: number;
+}
+export interface FindToolOptions {
+}
+export type FindToolDefinition = ToolDefinition<typeof findSchema, FindToolDetails | undefined>;
+export declare function createFindToolDefinition(operations: ToolOperations, _options?: FindToolOptions): FindToolDefinition;
+export declare function createFindTool(operations: ToolOperations, options?: FindToolOptions): AgentTool<typeof findSchema>;
+export {};
+//# sourceMappingURL=find.d.ts.map

package/dist/core/tools/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/core/tools/find.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,4BAA4B,CAAC;AAI7E,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,EAAiC,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAMnG,QAAA,MAAM,UAAU;;;;EAMd,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAItD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;CAAG;AAwPnC,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;AAEhG,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,kBAAkB,CAoCnH;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAElH","sourcesContent":["import { createInterface } from \"node:readline\";\nimport type { AgentTool, AgentToolResult } from \"@greppleai/grip-agent-core\";\nimport { Text } from \"@greppleai/grip-tui\";\nimport { spawn } from \"child_process\";\nimport path from \"path\";\nimport { type Static, Type } from \"typebox\";\nimport { keyHint } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport { ensureTool } from \"../../utils/tools-manager.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { resolveToCwd } from \"./path-utils.ts\";\nimport { formatBackendIcon, getTextOutput, invalidArgText, shortenPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nfunction toPosixPath(value: string): string {\n\treturn value.split(path.sep).join(\"/\");\n}\n\nconst findSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: \"Directory to search in (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of results (default: 1000)\" })),\n});\n\nexport type FindToolInput = Static<typeof findSchema>;\n\nconst DEFAULT_LIMIT = 1000;\n\nexport interface FindToolDetails {\n\ttruncation?: TruncationResult;\n\tresultLimitReached?: number;\n}\n\nexport interface FindToolOptions {}\n\nfunction formatFindCall(args: FindToolInput | undefined, theme: Theme): string {\n\tconst pattern = str(args?.pattern);\n\tconst rawPath = str(args?.path);\n\tconst path = rawPath !== null ? shortenPath(rawPath || \".\") : null;\n\tconst limit = args?.limit;\n\tconst invalidArg = invalidArgText(theme);\n\tlet text =\n\t\ttheme.fg(\"toolTitle\", theme.bold(\"find\")) +\n\t\t\" \" +\n\t\t(pattern === null ? invalidArg : theme.fg(\"accent\", pattern || \"\")) +\n\t\ttheme.fg(\"toolOutput\", ` in ${path === null ? invalidArg : path}`);\n\tif (limit !== undefined) {\n\t\ttext += theme.fg(\"toolOutput\", ` (limit ${limit})`);\n\t}\n\treturn text;\n}\n\nfunction formatFindResult(\n\tresult: AgentToolResult<FindToolDetails | undefined>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n): string {\n\tconst output = getTextOutput(result, showImages).trim();\n\tlet text = \"\";\n\tif (output) {\n\t\tconst lines = output.split(\"\\n\");\n\t\tconst maxLines = options.expanded ? lines.length : 20;\n\t\tconst displayLines = lines.slice(0, maxLines);\n\t\tconst remaining = lines.length - maxLines;\n\t\ttext += `\\n${displayLines.map((line) => theme.fg(\"toolOutput\", line)).join(\"\\n\")}`;\n\t\tif (remaining > 0) {\n\t\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")})`;\n\t\t}\n\t}\n\n\tconst resultLimit = result.details?.resultLimitReached;\n\tconst truncation = result.details?.truncation;\n\tif (resultLimit || truncation?.truncated) {\n\t\tconst warnings: string[] = [];\n\t\tif (resultLimit) warnings.push(`${resultLimit} results limit`);\n\t\tif (truncation?.truncated) warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);\n\t\ttext += `\\n${theme.fg(\"warning\", `[Truncated: ${warnings.join(\", \")}]`)}`;\n\t}\n\treturn text;\n}\n\ntype FindExecutionResult = AgentToolResult<FindToolDetails | undefined>;\n\ninterface FindExecutionRequest {\n\toperations: ToolOperations;\n\tcwd: string;\n\tpattern: string;\n\tsearchDir: string | undefined;\n\tlimit: number | undefined;\n\tsignal: AbortSignal | undefined;\n}\n\ntype RegisterFindChildStop = (stop: () => void) => void;\n\nfunction throwIfFindAborted(signal: AbortSignal | undefined): void {\n\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n}\n\nfunction noFindResults(): FindExecutionResult {\n\treturn { content: [{ type: \"text\", text: \"No files found matching pattern\" }], details: undefined };\n}\n\nfunction formatFindMatches(paths: string[], limit: number, includeRefineHint: boolean): FindExecutionResult {\n\tconst resultLimitReached = paths.length >= limit;\n\tconst truncation = truncateHead(paths.join(\"\\n\"), { maxLines: Number.MAX_SAFE_INTEGER });\n\tlet output = truncation.content;\n\tconst details: FindToolDetails = {};\n\tconst notices: string[] = [];\n\tif (resultLimitReached) {\n\t\tnotices.push(\n\t\t\tincludeRefineHint\n\t\t\t\t? `${limit} results limit reached. Use limit=${limit * 2} for more, or refine pattern`\n\t\t\t\t: `${limit} results limit reached`,\n\t\t);\n\t\tdetails.resultLimitReached = limit;\n\t}\n\tif (truncation.truncated) {\n\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t\tdetails.truncation = truncation;\n\t}\n\tif (notices.length > 0) output += `\\n\\n[${notices.join(\". \")}]`;\n\treturn {\n\t\tcontent: [{ type: \"text\", text: output }],\n\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\n\t};\n}\n\nfunction relativizeGlobMatches(paths: string[], searchPath: string): string[] {\n\treturn paths.map((matchedPath) => {\n\t\tif (matchedPath.startsWith(searchPath)) return toPosixPath(matchedPath.slice(searchPath.length + 1));\n\t\treturn toPosixPath(path.relative(searchPath, matchedPath));\n\t});\n}\n\nasync function executeOperationsFind(\n\trequest: FindExecutionRequest,\n\tsearchPath: string,\n\teffectiveLimit: number,\n): Promise<FindExecutionResult> {\n\ttry {\n\t\tawait request.operations.access(searchPath, \"exists\");\n\t} catch {\n\t\tthrow new Error(`Path not found: ${searchPath}`);\n\t}\n\tthrowIfFindAborted(request.signal);\n\tif (!request.operations.glob) throw new Error(\"Glob operation is unavailable\");\n\tconst results = await request.operations.glob(request.pattern, searchPath, {\n\t\tignore: [\"**/node_modules/**\", \"**/.git/**\"],\n\t\tlimit: effectiveLimit,\n\t});\n\tthrowIfFindAborted(request.signal);\n\tif (results.length === 0) return noFindResults();\n\treturn formatFindMatches(relativizeGlobMatches(results, searchPath), effectiveLimit, false);\n}\n\nfunction buildFdArguments(pattern: string, searchPath: string, limit: number): string[] {\n\tconst args = [\"--glob\", \"--color=never\", \"--hidden\", \"--no-require-git\", \"--max-results\", String(limit)];\n\tlet effectivePattern = pattern;\n\tif (pattern.includes(\"/\")) {\n\t\targs.push(\"--full-path\");\n\t\tif (!pattern.startsWith(\"/\") && !pattern.startsWith(\"**/\") && pattern !== \"**\") {\n\t\t\teffectivePattern = `**/${pattern}`;\n\t\t}\n\t}\n\targs.push(\"--\", effectivePattern, searchPath);\n\treturn args;\n}\n\nfunction relativizeFdMatches(lines: string[], searchPath: string): string[] {\n\tconst relativized: string[] = [];\n\tfor (const rawLine of lines) {\n\t\tconst line = rawLine.replace(/\\r$/, \"\").trim();\n\t\tif (!line) continue;\n\t\tconst hadTrailingSlash = line.endsWith(\"/\") || line.endsWith(\"\\\\\");\n\t\tlet relativePath = line;\n\t\tif (line.startsWith(searchPath)) {\n\t\t\trelativePath = line.slice(searchPath.length + 1);\n\t\t} else {\n\t\t\trelativePath = path.relative(searchPath, line);\n\t\t}\n\t\tif (hadTrailingSlash && !relativePath.endsWith(\"/\")) relativePath += \"/\";\n\t\trelativized.push(toPosixPath(relativePath));\n\t}\n\treturn relativized;\n}\n\nfunction executeFdFind(\n\tfdPath: string,\n\trequest: FindExecutionRequest,\n\tsearchPath: string,\n\teffectiveLimit: number,\n\tregisterStop: RegisterFindChildStop,\n): Promise<FindExecutionResult> {\n\treturn new Promise((resolveFind, rejectFind) => {\n\t\tconst child = spawn(fdPath, buildFdArguments(request.pattern, searchPath, effectiveLimit), {\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tconst rl = createInterface({ input: child.stdout });\n\t\tlet stderr = \"\";\n\t\tconst lines: string[] = [];\n\t\tregisterStop(() => {\n\t\t\tif (!child.killed) child.kill();\n\t\t});\n\t\tconst cleanup = (): void => rl.close();\n\t\tchild.stderr?.on(\"data\", (chunk) => {\n\t\t\tstderr += chunk.toString();\n\t\t});\n\t\trl.on(\"line\", (line) => lines.push(line));\n\t\tchild.on(\"error\", (error) => {\n\t\t\tcleanup();\n\t\t\trejectFind(new Error(`Failed to run fd: ${error.message}`));\n\t\t});\n\t\tchild.on(\"close\", (code) => {\n\t\t\tcleanup();\n\t\t\tif (request.signal?.aborted) {\n\t\t\t\trejectFind(new Error(\"Operation aborted\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst output = lines.join(\"\\n\");\n\t\t\tif (code !== 0 && !output) {\n\t\t\t\trejectFind(new Error(stderr.trim() || `fd exited with code ${code}`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!output) {\n\t\t\t\tresolveFind(noFindResults());\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tresolveFind(formatFindMatches(relativizeFdMatches(lines, searchPath), effectiveLimit, true));\n\t\t});\n\t});\n}\n\nasync function dispatchFindExecution(\n\trequest: FindExecutionRequest,\n\tregisterStop: RegisterFindChildStop,\n): Promise<FindExecutionResult> {\n\tconst searchPath = resolveToCwd(request.searchDir || \".\", request.cwd);\n\tconst effectiveLimit = request.limit ?? DEFAULT_LIMIT;\n\tif (request.operations.glob) return executeOperationsFind(request, searchPath, effectiveLimit);\n\tconst fdPath = await ensureTool(\"fd\", true);\n\tthrowIfFindAborted(request.signal);\n\tif (!fdPath) throw new Error(\"fd is not available and could not be downloaded\");\n\treturn executeFdFind(fdPath, request, searchPath, effectiveLimit, registerStop);\n}\n\nfunction executeFind(request: FindExecutionRequest): Promise<FindExecutionResult> {\n\treturn new Promise((resolveFind, rejectFind) => {\n\t\tif (request.signal?.aborted) {\n\t\t\trejectFind(new Error(\"Operation aborted\"));\n\t\t\treturn;\n\t\t}\n\t\tlet settled = false;\n\t\tlet stopChild: (() => void) | undefined;\n\t\tconst settle = (complete: () => void): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\trequest.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\tstopChild = undefined;\n\t\t\tcomplete();\n\t\t};\n\t\tconst onAbort = (): void => {\n\t\t\tstopChild?.();\n\t\t\tsettle(() => rejectFind(new Error(\"Operation aborted\")));\n\t\t};\n\t\trequest.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tvoid dispatchFindExecution(request, (stop) => {\n\t\t\tstopChild = stop;\n\t\t}).then(\n\t\t\t(result) => settle(() => resolveFind(result)),\n\t\t\t(error: unknown) => {\n\t\t\t\tif (request.signal?.aborted) {\n\t\t\t\t\tsettle(() => rejectFind(new Error(\"Operation aborted\")));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsettle(() => rejectFind(error instanceof Error ? error : new Error(String(error))));\n\t\t\t},\n\t\t);\n\t});\n}\n\nexport type FindToolDefinition = ToolDefinition<typeof findSchema, FindToolDetails | undefined>;\n\nexport function createFindToolDefinition(operations: ToolOperations, _options?: FindToolOptions): FindToolDefinition {\n\tconst ops = operations;\n\tconst cwd = operations.cwd;\n\treturn {\n\t\tname: \"find\",\n\t\tlabel: \"find\",\n\t\tdescription: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} results or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\n\t\tpromptSnippet: \"Find files by glob pattern (respects .gitignore)\",\n\t\tparameters: findSchema,\n\t\tasync execute(\n\t\t\t_toolCallId,\n\t\t\t{ pattern, path: searchDir, limit }: FindToolInput,\n\t\t\tsignal?: AbortSignal,\n\t\t\t_onUpdate?,\n\t\t\t_ctx?,\n\t\t) {\n\t\t\treturn executeFind({\n\t\t\t\toperations: ops,\n\t\t\t\tcwd,\n\t\t\t\tpattern,\n\t\t\t\tsearchDir,\n\t\t\t\tlimit,\n\t\t\t\tsignal,\n\t\t\t});\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatBackendIcon(ops.getBackendInfo?.(), theme) + formatFindCall(args, theme));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatFindResult(result as any, options, theme, context.showImages));\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createFindTool(operations: ToolOperations, options?: FindToolOptions): AgentTool<typeof findSchema> {\n\treturn wrapToolDefinition(createFindToolDefinition(operations, options));\n}\n"]}