@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/tools/edit-diff.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Shared diff computation utilities for the edit tool.
+ * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).
+ */
+import type { ToolOperations } from "./operations.ts";
+import { type LineEnding, stripBOM } from "./replace-diff.ts";
+export { stripBOM as stripBom };
+export declare function detectLineEnding(content: string): LineEnding;
+export declare function normalizeToLF(text: string): string;
+export declare function restoreLineEndings(text: string, ending: LineEnding): string;
+/**
+ * Normalize text for fuzzy matching. Applies progressive transformations:
+ * - Strip trailing whitespace from each line
+ * - Normalize smart quotes to ASCII equivalents
+ * - Normalize Unicode dashes/hyphens to ASCII hyphen
+ * - Normalize special Unicode spaces to regular space
+ */
+export declare function normalizeForFuzzyMatch(text: string): string;
+export interface FuzzyMatchResult {
+    /** Whether a match was found */
+    found: boolean;
+    /** The index where the match starts (in the content that should be used for replacement) */
+    index: number;
+    /** Length of the matched text */
+    matchLength: number;
+    /** Whether fuzzy matching was used (false = exact match) */
+    usedFuzzyMatch: boolean;
+    /**
+     * The content to use for replacement operations.
+     * When exact match: original content. When fuzzy match: normalized content.
+     */
+    contentForReplacement: string;
+}
+export interface Edit {
+    oldText: string;
+    newText: string;
+}
+export interface AppliedEditsResult {
+    baseContent: string;
+    newContent: string;
+}
+/**
+ * Find oldText in content, trying exact match first, then fuzzy match.
+ * When fuzzy matching is used, the returned contentForReplacement is the
+ * fuzzy-normalized version of the content (trailing whitespace stripped,
+ * Unicode quotes/dashes normalized to ASCII).
+ */
+export declare function fuzzyFindText(content: string, oldText: string): FuzzyMatchResult;
+/**
+ * Apply one or more exact-text replacements to LF-normalized content.
+ *
+ * All edits are matched against the same original content. Replacements are
+ * then applied in reverse order so offsets remain stable. If any edit needs
+ * fuzzy matching, the operation runs in fuzzy-normalized content space to
+ * preserve current single-edit behavior.
+ */
+export declare function applyEditsToNormalizedContent(normalizedContent: string, edits: Edit[], path: string): AppliedEditsResult;
+/** Generate a standard unified patch. */
+export declare function generateUnifiedPatch(path: string, oldContent: string, newContent: string, contextLines?: number): string;
+/**
+ * Generate a display-oriented diff string with line numbers and context.
+ * Returns both the diff string and the first changed line number (in the new file).
+ */
+export declare function generateDiffString(oldContent: string, newContent: string, contextLines?: number): EditDiffResult;
+export interface EditDiffResult {
+    diff: string;
+    firstChangedLine: number | undefined;
+}
+export interface EditDiffError {
+    error: string;
+}
+/**
+ * Compute the diff for one or more edit operations without applying them.
+ * Used for preview rendering in the TUI before the tool executes.
+ */
+export declare function computeEditsDiff(path: string, edits: Edit[], operations: ToolOperations): Promise<EditDiffResult | EditDiffError>;
+/**
+ * Compute the diff for a single edit operation without applying it.
+ * Kept as a convenience wrapper for single-edit callers.
+ */
+export declare function computeEditDiff(path: string, oldText: string, newText: string, operations: ToolOperations): Promise<EditDiffResult | EditDiffError>;
+//# sourceMappingURL=edit-diff.d.ts.map

package/dist/core/tools/edit-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-diff.d.ts","sourceRoot":"","sources":["../../../src/core/tools/edit-diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,KAAK,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAEhC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAM5D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB3D;AAED,MAAM,WAAW,gBAAgB;IAChC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,cAAc,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,IAAI;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AASD,MAAM,WAAW,kBAAkB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAsChF;AA6CD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,GACV,kBAAkB,CA+DpB;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,CAKnH;AA8FD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,cAAc,CAgC3G;AAGD,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,EAAE,cAAc,GACxB,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CAyBzC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,GACxB,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CAEzC","sourcesContent":["/**\n * Shared diff computation utilities for the edit tool.\n * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).\n */\n\nimport * as Diff from \"diff\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { resolveToCwd } from \"./path-utils.ts\";\nimport { type LineEnding, stripBOM } from \"./replace-diff.ts\";\n\nexport { stripBOM as stripBom };\n\nexport function detectLineEnding(content: string): LineEnding {\n\tconst crlfIdx = content.indexOf(\"\\r\\n\");\n\tconst lfIdx = content.indexOf(\"\\n\");\n\tif (lfIdx === -1) return \"\\n\";\n\tif (crlfIdx === -1) return \"\\n\";\n\treturn crlfIdx < lfIdx ? \"\\r\\n\" : \"\\n\";\n}\n\nexport function normalizeToLF(text: string): string {\n\treturn text.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n}\n\nexport function restoreLineEndings(text: string, ending: LineEnding): string {\n\treturn ending === \"\\r\\n\" ? text.replace(/\\n/g, \"\\r\\n\") : text;\n}\n\n/**\n * Normalize text for fuzzy matching. Applies progressive transformations:\n * - Strip trailing whitespace from each line\n * - Normalize smart quotes to ASCII equivalents\n * - Normalize Unicode dashes/hyphens to ASCII hyphen\n * - Normalize special Unicode spaces to regular space\n */\nexport function normalizeForFuzzyMatch(text: string): string {\n\treturn (\n\t\ttext\n\t\t\t.normalize(\"NFKC\")\n\t\t\t// Strip trailing whitespace per line\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => line.trimEnd())\n\t\t\t.join(\"\\n\")\n\t\t\t// Smart single quotes → '\n\t\t\t.replace(/[\\u2018\\u2019\\u201A\\u201B]/g, \"'\")\n\t\t\t// Smart double quotes → \"\n\t\t\t.replace(/[\\u201C\\u201D\\u201E\\u201F]/g, '\"')\n\t\t\t// Various dashes/hyphens → -\n\t\t\t// U+2010 hyphen, U+2011 non-breaking hyphen, U+2012 figure dash,\n\t\t\t// U+2013 en-dash, U+2014 em-dash, U+2015 horizontal bar, U+2212 minus\n\t\t\t.replace(/[\\u2010\\u2011\\u2012\\u2013\\u2014\\u2015\\u2212]/g, \"-\")\n\t\t\t// Special spaces → regular space\n\t\t\t// U+00A0 NBSP, U+2002-U+200A various spaces, U+202F narrow NBSP,\n\t\t\t// U+205F medium math space, U+3000 ideographic space\n\t\t\t.replace(/[\\u00A0\\u2002-\\u200A\\u202F\\u205F\\u3000]/g, \" \")\n\t);\n}\n\nexport interface FuzzyMatchResult {\n\t/** Whether a match was found */\n\tfound: boolean;\n\t/** The index where the match starts (in the content that should be used for replacement) */\n\tindex: number;\n\t/** Length of the matched text */\n\tmatchLength: number;\n\t/** Whether fuzzy matching was used (false = exact match) */\n\tusedFuzzyMatch: boolean;\n\t/**\n\t * The content to use for replacement operations.\n\t * When exact match: original content. When fuzzy match: normalized content.\n\t */\n\tcontentForReplacement: string;\n}\n\nexport interface Edit {\n\toldText: string;\n\tnewText: string;\n}\n\ninterface MatchedEdit {\n\teditIndex: number;\n\tmatchIndex: number;\n\tmatchLength: number;\n\tnewText: string;\n}\n\nexport interface AppliedEditsResult {\n\tbaseContent: string;\n\tnewContent: string;\n}\n\n/**\n * Find oldText in content, trying exact match first, then fuzzy match.\n * When fuzzy matching is used, the returned contentForReplacement is the\n * fuzzy-normalized version of the content (trailing whitespace stripped,\n * Unicode quotes/dashes normalized to ASCII).\n */\nexport function fuzzyFindText(content: string, oldText: string): FuzzyMatchResult {\n\t// Try exact match first\n\tconst exactIndex = content.indexOf(oldText);\n\tif (exactIndex !== -1) {\n\t\treturn {\n\t\t\tfound: true,\n\t\t\tindex: exactIndex,\n\t\t\tmatchLength: oldText.length,\n\t\t\tusedFuzzyMatch: false,\n\t\t\tcontentForReplacement: content,\n\t\t};\n\t}\n\n\t// Try fuzzy match - work entirely in normalized space\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\n\tconst fuzzyIndex = fuzzyContent.indexOf(fuzzyOldText);\n\n\tif (fuzzyIndex === -1) {\n\t\treturn {\n\t\t\tfound: false,\n\t\t\tindex: -1,\n\t\t\tmatchLength: 0,\n\t\t\tusedFuzzyMatch: false,\n\t\t\tcontentForReplacement: content,\n\t\t};\n\t}\n\n\t// When fuzzy matching, we work in the normalized space for replacement.\n\t// This means the output will have normalized whitespace/quotes/dashes,\n\t// which is acceptable since we're fixing minor formatting differences anyway.\n\treturn {\n\t\tfound: true,\n\t\tindex: fuzzyIndex,\n\t\tmatchLength: fuzzyOldText.length,\n\t\tusedFuzzyMatch: true,\n\t\tcontentForReplacement: fuzzyContent,\n\t};\n}\nfunction countOccurrences(content: string, oldText: string): number {\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\n\treturn fuzzyContent.split(fuzzyOldText).length - 1;\n}\n\nfunction getNotFoundError(path: string, editIndex: number, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\n\t\t);\n\t}\n\treturn new Error(\n\t\t`Could not find edits[${editIndex}] in ${path}. The oldText must match exactly including all whitespace and newlines.`,\n\t);\n}\n\nfunction getDuplicateError(path: string, editIndex: number, totalEdits: number, occurrences: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\n\t\t);\n\t}\n\treturn new Error(\n\t\t`Found ${occurrences} occurrences of edits[${editIndex}] in ${path}. Each oldText must be unique. Please provide more context to make it unique.`,\n\t);\n}\n\nfunction getEmptyOldTextError(path: string, editIndex: number, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(`oldText must not be empty in ${path}.`);\n\t}\n\treturn new Error(`edits[${editIndex}].oldText must not be empty in ${path}.`);\n}\n\nfunction getNoChangeError(path: string, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`,\n\t\t);\n\t}\n\treturn new Error(`No changes made to ${path}. The replacements produced identical content.`);\n}\n\n/**\n * Apply one or more exact-text replacements to LF-normalized content.\n *\n * All edits are matched against the same original content. Replacements are\n * then applied in reverse order so offsets remain stable. If any edit needs\n * fuzzy matching, the operation runs in fuzzy-normalized content space to\n * preserve current single-edit behavior.\n */\nexport function applyEditsToNormalizedContent(\n\tnormalizedContent: string,\n\tedits: Edit[],\n\tpath: string,\n): AppliedEditsResult {\n\tconst normalizedEdits = edits.map((edit) => ({\n\t\toldText: normalizeToLF(edit.oldText),\n\t\tnewText: normalizeToLF(edit.newText),\n\t}));\n\n\tfor (let i = 0; i < normalizedEdits.length; i++) {\n\t\tif (normalizedEdits[i].oldText.length === 0) {\n\t\t\tthrow getEmptyOldTextError(path, i, normalizedEdits.length);\n\t\t}\n\t}\n\n\tconst initialMatches = normalizedEdits.map((edit) => fuzzyFindText(normalizedContent, edit.oldText));\n\tconst baseContent = initialMatches.some((match) => match.usedFuzzyMatch)\n\t\t? normalizeForFuzzyMatch(normalizedContent)\n\t\t: normalizedContent;\n\n\tconst matchedEdits: MatchedEdit[] = [];\n\tfor (let i = 0; i < normalizedEdits.length; i++) {\n\t\tconst edit = normalizedEdits[i];\n\t\tconst matchResult = fuzzyFindText(baseContent, edit.oldText);\n\t\tif (!matchResult.found) {\n\t\t\tthrow getNotFoundError(path, i, normalizedEdits.length);\n\t\t}\n\n\t\tconst occurrences = countOccurrences(baseContent, edit.oldText);\n\t\tif (occurrences > 1) {\n\t\t\tthrow getDuplicateError(path, i, normalizedEdits.length, occurrences);\n\t\t}\n\n\t\tmatchedEdits.push({\n\t\t\teditIndex: i,\n\t\t\tmatchIndex: matchResult.index,\n\t\t\tmatchLength: matchResult.matchLength,\n\t\t\tnewText: edit.newText,\n\t\t});\n\t}\n\n\tmatchedEdits.sort((a, b) => a.matchIndex - b.matchIndex);\n\tfor (let i = 1; i < matchedEdits.length; i++) {\n\t\tconst previous = matchedEdits[i - 1];\n\t\tconst current = matchedEdits[i];\n\t\tif (previous.matchIndex + previous.matchLength > current.matchIndex) {\n\t\t\tthrow new Error(\n\t\t\t\t`edits[${previous.editIndex}] and edits[${current.editIndex}] overlap in ${path}. Merge them into one edit or target disjoint regions.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tlet newContent = baseContent;\n\tfor (let i = matchedEdits.length - 1; i >= 0; i--) {\n\t\tconst edit = matchedEdits[i];\n\t\tnewContent =\n\t\t\tnewContent.substring(0, edit.matchIndex) +\n\t\t\tedit.newText +\n\t\t\tnewContent.substring(edit.matchIndex + edit.matchLength);\n\t}\n\n\tif (baseContent === newContent) {\n\t\tthrow getNoChangeError(path, normalizedEdits.length);\n\t}\n\n\treturn { baseContent, newContent };\n}\n\n/** Generate a standard unified patch. */\nexport function generateUnifiedPatch(path: string, oldContent: string, newContent: string, contextLines = 4): string {\n\treturn Diff.createTwoFilesPatch(path, path, oldContent, newContent, undefined, undefined, {\n\t\tcontext: contextLines,\n\t\theaderOptions: Diff.FILE_HEADERS_ONLY,\n\t});\n}\n\ninterface DiffRenderState {\n\toutput: string[];\n\toldLineNumber: number;\n\tnewLineNumber: number;\n\tlineNumberWidth: number;\n\tfirstChangedLine: number | undefined;\n}\n\nfunction getDiffPartLines(part: Diff.Change): string[] {\n\tconst lines = part.value.split(\"\\n\");\n\tif (lines.at(-1) === \"\") lines.pop();\n\treturn lines;\n}\n\nfunction appendChangedDiffLines(state: DiffRenderState, part: Diff.Change, lines: string[]): void {\n\tstate.firstChangedLine ??= state.newLineNumber;\n\tfor (const line of lines) {\n\t\tif (part.added) {\n\t\t\tconst lineNumber = String(state.newLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\t\tstate.output.push(`+${lineNumber} ${line}`);\n\t\t\tstate.newLineNumber++;\n\t\t} else {\n\t\t\tconst lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\t\tstate.output.push(`-${lineNumber} ${line}`);\n\t\t\tstate.oldLineNumber++;\n\t\t}\n\t}\n}\n\nfunction appendContextDiffLines(state: DiffRenderState, lines: string[]): void {\n\tfor (const line of lines) {\n\t\tconst lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\tstate.output.push(` ${lineNumber} ${line}`);\n\t\tstate.oldLineNumber++;\n\t\tstate.newLineNumber++;\n\t}\n}\n\nfunction appendSkippedDiffLines(state: DiffRenderState, count: number): void {\n\tif (count <= 0) return;\n\tstate.output.push(` ${\"\".padStart(state.lineNumberWidth, \" \")} ...`);\n\tstate.oldLineNumber += count;\n\tstate.newLineNumber += count;\n}\n\nfunction appendContextBetweenChanges(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tif (lines.length <= contextLines * 2) {\n\t\tappendContextDiffLines(state, lines);\n\t\treturn;\n\t}\n\tconst leadingLines = lines.slice(0, contextLines);\n\tconst trailingLines = lines.slice(lines.length - contextLines);\n\tappendContextDiffLines(state, leadingLines);\n\tappendSkippedDiffLines(state, lines.length - leadingLines.length - trailingLines.length);\n\tappendContextDiffLines(state, trailingLines);\n}\n\nfunction appendContextAfterChange(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tconst shownLines = lines.slice(0, contextLines);\n\tappendContextDiffLines(state, shownLines);\n\tappendSkippedDiffLines(state, lines.length - shownLines.length);\n}\n\nfunction appendContextBeforeChange(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tconst skippedLines = Math.max(0, lines.length - contextLines);\n\tappendSkippedDiffLines(state, skippedLines);\n\tappendContextDiffLines(state, lines.slice(skippedLines));\n}\n\nfunction appendUnchangedDiffPart(\n\tstate: DiffRenderState,\n\tlines: string[],\n\thasLeadingChange: boolean,\n\thasTrailingChange: boolean,\n\tcontextLines: number,\n): void {\n\tif (hasLeadingChange && hasTrailingChange) {\n\t\tappendContextBetweenChanges(state, lines, contextLines);\n\t\treturn;\n\t}\n\tif (hasLeadingChange) {\n\t\tappendContextAfterChange(state, lines, contextLines);\n\t\treturn;\n\t}\n\tif (hasTrailingChange) {\n\t\tappendContextBeforeChange(state, lines, contextLines);\n\t\treturn;\n\t}\n\tstate.oldLineNumber += lines.length;\n\tstate.newLineNumber += lines.length;\n}\n\n/**\n * Generate a display-oriented diff string with line numbers and context.\n * Returns both the diff string and the first changed line number (in the new file).\n */\nexport function generateDiffString(oldContent: string, newContent: string, contextLines = 4): EditDiffResult {\n\tconst parts = Diff.diffLines(oldContent, newContent);\n\tconst maxLineNumber = Math.max(oldContent.split(\"\\n\").length, newContent.split(\"\\n\").length);\n\tconst state: DiffRenderState = {\n\t\toutput: [],\n\t\toldLineNumber: 1,\n\t\tnewLineNumber: 1,\n\t\tlineNumberWidth: String(maxLineNumber).length,\n\t\tfirstChangedLine: undefined,\n\t};\n\tlet lastWasChange = false;\n\n\tfor (let index = 0; index < parts.length; index++) {\n\t\tconst part = parts[index];\n\t\tconst lines = getDiffPartLines(part);\n\t\tif (part.added || part.removed) {\n\t\t\tappendChangedDiffLines(state, part, lines);\n\t\t\tlastWasChange = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconst nextPart = parts[index + 1];\n\t\tappendUnchangedDiffPart(\n\t\t\tstate,\n\t\t\tlines,\n\t\t\tlastWasChange,\n\t\t\tindex < parts.length - 1 && Boolean(nextPart.added || nextPart.removed),\n\t\t\tcontextLines,\n\t\t);\n\t\tlastWasChange = false;\n\t}\n\n\treturn { diff: state.output.join(\"\\n\"), firstChangedLine: state.firstChangedLine };\n}\n\n// grip-ignore noNearIdenticalDataStructures: Plain line-number diffs and hashline-anchored diffs use distinct rendering formats and evolve independently.\nexport interface EditDiffResult {\n\tdiff: string;\n\tfirstChangedLine: number | undefined;\n}\n\nexport interface EditDiffError {\n\terror: string;\n}\n\n/**\n * Compute the diff for one or more edit operations without applying them.\n * Used for preview rendering in the TUI before the tool executes.\n */\nexport async function computeEditsDiff(\n\tpath: string,\n\tedits: Edit[],\n\toperations: ToolOperations,\n): Promise<EditDiffResult | EditDiffError> {\n\tconst absolutePath = resolveToCwd(path, operations.cwd);\n\n\ttry {\n\t\t// Check if file exists and is readable\n\t\ttry {\n\t\t\tawait operations.access(absolutePath, \"read\");\n\t\t} catch (error: unknown) {\n\t\t\tconst errorMessage = error instanceof Error && \"code\" in error ? `Error code: ${error.code}` : String(error);\n\t\t\treturn { error: `Could not edit file: ${path}. ${errorMessage}.` };\n\t\t}\n\n\t\t// Read the file\n\t\tconst rawContent = (await operations.readFile(absolutePath)).toString(\"utf-8\");\n\n\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\n\t\tconst { text: content } = stripBOM(rawContent);\n\t\tconst normalizedContent = normalizeToLF(content);\n\t\tconst { baseContent, newContent } = applyEditsToNormalizedContent(normalizedContent, edits, path);\n\n\t\t// Generate the diff\n\t\treturn generateDiffString(baseContent, newContent);\n\t} catch (err) {\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\n\t}\n}\n\n/**\n * Compute the diff for a single edit operation without applying it.\n * Kept as a convenience wrapper for single-edit callers.\n */\nexport async function computeEditDiff(\n\tpath: string,\n\toldText: string,\n\tnewText: string,\n\toperations: ToolOperations,\n): Promise<EditDiffResult | EditDiffError> {\n\treturn computeEditsDiff(path, [{ oldText, newText }], operations);\n}\n"]}

package/dist/core/tools/edit-diff.js

@@ -0,0 +1,327 @@
+/**
+ * Shared diff computation utilities for the edit tool.
+ * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).
+ */
+import * as Diff from "diff";
+import { resolveToCwd } from "./path-utils.js";
+import { stripBOM } from "./replace-diff.js";
+export { stripBOM as stripBom };
+export function detectLineEnding(content) {
+    const crlfIdx = content.indexOf("\r\n");
+    const lfIdx = content.indexOf("\n");
+    if (lfIdx === -1)
+        return "\n";
+    if (crlfIdx === -1)
+        return "\n";
+    return crlfIdx < lfIdx ? "\r\n" : "\n";
+}
+export function normalizeToLF(text) {
+    return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+export function restoreLineEndings(text, ending) {
+    return ending === "\r\n" ? text.replace(/\n/g, "\r\n") : text;
+}
+/**
+ * Normalize text for fuzzy matching. Applies progressive transformations:
+ * - Strip trailing whitespace from each line
+ * - Normalize smart quotes to ASCII equivalents
+ * - Normalize Unicode dashes/hyphens to ASCII hyphen
+ * - Normalize special Unicode spaces to regular space
+ */
+export function normalizeForFuzzyMatch(text) {
+    return (text
+        .normalize("NFKC")
+        // Strip trailing whitespace per line
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .join("\n")
+        // Smart single quotes → '
+        .replace(/[\u2018\u2019\u201A\u201B]/g, "'")
+        // Smart double quotes → "
+        .replace(/[\u201C\u201D\u201E\u201F]/g, '"')
+        // Various dashes/hyphens → -
+        // U+2010 hyphen, U+2011 non-breaking hyphen, U+2012 figure dash,
+        // U+2013 en-dash, U+2014 em-dash, U+2015 horizontal bar, U+2212 minus
+        .replace(/[\u2010\u2011\u2012\u2013\u2014\u2015\u2212]/g, "-")
+        // Special spaces → regular space
+        // U+00A0 NBSP, U+2002-U+200A various spaces, U+202F narrow NBSP,
+        // U+205F medium math space, U+3000 ideographic space
+        .replace(/[\u00A0\u2002-\u200A\u202F\u205F\u3000]/g, " "));
+}
+/**
+ * Find oldText in content, trying exact match first, then fuzzy match.
+ * When fuzzy matching is used, the returned contentForReplacement is the
+ * fuzzy-normalized version of the content (trailing whitespace stripped,
+ * Unicode quotes/dashes normalized to ASCII).
+ */
+export function fuzzyFindText(content, oldText) {
+    // Try exact match first
+    const exactIndex = content.indexOf(oldText);
+    if (exactIndex !== -1) {
+        return {
+            found: true,
+            index: exactIndex,
+            matchLength: oldText.length,
+            usedFuzzyMatch: false,
+            contentForReplacement: content,
+        };
+    }
+    // Try fuzzy match - work entirely in normalized space
+    const fuzzyContent = normalizeForFuzzyMatch(content);
+    const fuzzyOldText = normalizeForFuzzyMatch(oldText);
+    const fuzzyIndex = fuzzyContent.indexOf(fuzzyOldText);
+    if (fuzzyIndex === -1) {
+        return {
+            found: false,
+            index: -1,
+            matchLength: 0,
+            usedFuzzyMatch: false,
+            contentForReplacement: content,
+        };
+    }
+    // When fuzzy matching, we work in the normalized space for replacement.
+    // This means the output will have normalized whitespace/quotes/dashes,
+    // which is acceptable since we're fixing minor formatting differences anyway.
+    return {
+        found: true,
+        index: fuzzyIndex,
+        matchLength: fuzzyOldText.length,
+        usedFuzzyMatch: true,
+        contentForReplacement: fuzzyContent,
+    };
+}
+function countOccurrences(content, oldText) {
+    const fuzzyContent = normalizeForFuzzyMatch(content);
+    const fuzzyOldText = normalizeForFuzzyMatch(oldText);
+    return fuzzyContent.split(fuzzyOldText).length - 1;
+}
+function getNotFoundError(path, editIndex, totalEdits) {
+    if (totalEdits === 1) {
+        return new Error(`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`);
+    }
+    return new Error(`Could not find edits[${editIndex}] in ${path}. The oldText must match exactly including all whitespace and newlines.`);
+}
+function getDuplicateError(path, editIndex, totalEdits, occurrences) {
+    if (totalEdits === 1) {
+        return new Error(`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`);
+    }
+    return new Error(`Found ${occurrences} occurrences of edits[${editIndex}] in ${path}. Each oldText must be unique. Please provide more context to make it unique.`);
+}
+function getEmptyOldTextError(path, editIndex, totalEdits) {
+    if (totalEdits === 1) {
+        return new Error(`oldText must not be empty in ${path}.`);
+    }
+    return new Error(`edits[${editIndex}].oldText must not be empty in ${path}.`);
+}
+function getNoChangeError(path, totalEdits) {
+    if (totalEdits === 1) {
+        return new Error(`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`);
+    }
+    return new Error(`No changes made to ${path}. The replacements produced identical content.`);
+}
+/**
+ * Apply one or more exact-text replacements to LF-normalized content.
+ *
+ * All edits are matched against the same original content. Replacements are
+ * then applied in reverse order so offsets remain stable. If any edit needs
+ * fuzzy matching, the operation runs in fuzzy-normalized content space to
+ * preserve current single-edit behavior.
+ */
+export function applyEditsToNormalizedContent(normalizedContent, edits, path) {
+    const normalizedEdits = edits.map((edit) => ({
+        oldText: normalizeToLF(edit.oldText),
+        newText: normalizeToLF(edit.newText),
+    }));
+    for (let i = 0; i < normalizedEdits.length; i++) {
+        if (normalizedEdits[i].oldText.length === 0) {
+            throw getEmptyOldTextError(path, i, normalizedEdits.length);
+        }
+    }
+    const initialMatches = normalizedEdits.map((edit) => fuzzyFindText(normalizedContent, edit.oldText));
+    const baseContent = initialMatches.some((match) => match.usedFuzzyMatch)
+        ? normalizeForFuzzyMatch(normalizedContent)
+        : normalizedContent;
+    const matchedEdits = [];
+    for (let i = 0; i < normalizedEdits.length; i++) {
+        const edit = normalizedEdits[i];
+        const matchResult = fuzzyFindText(baseContent, edit.oldText);
+        if (!matchResult.found) {
+            throw getNotFoundError(path, i, normalizedEdits.length);
+        }
+        const occurrences = countOccurrences(baseContent, edit.oldText);
+        if (occurrences > 1) {
+            throw getDuplicateError(path, i, normalizedEdits.length, occurrences);
+        }
+        matchedEdits.push({
+            editIndex: i,
+            matchIndex: matchResult.index,
+            matchLength: matchResult.matchLength,
+            newText: edit.newText,
+        });
+    }
+    matchedEdits.sort((a, b) => a.matchIndex - b.matchIndex);
+    for (let i = 1; i < matchedEdits.length; i++) {
+        const previous = matchedEdits[i - 1];
+        const current = matchedEdits[i];
+        if (previous.matchIndex + previous.matchLength > current.matchIndex) {
+            throw new Error(`edits[${previous.editIndex}] and edits[${current.editIndex}] overlap in ${path}. Merge them into one edit or target disjoint regions.`);
+        }
+    }
+    let newContent = baseContent;
+    for (let i = matchedEdits.length - 1; i >= 0; i--) {
+        const edit = matchedEdits[i];
+        newContent =
+            newContent.substring(0, edit.matchIndex) +
+                edit.newText +
+                newContent.substring(edit.matchIndex + edit.matchLength);
+    }
+    if (baseContent === newContent) {
+        throw getNoChangeError(path, normalizedEdits.length);
+    }
+    return { baseContent, newContent };
+}
+/** Generate a standard unified patch. */
+export function generateUnifiedPatch(path, oldContent, newContent, contextLines = 4) {
+    return Diff.createTwoFilesPatch(path, path, oldContent, newContent, undefined, undefined, {
+        context: contextLines,
+        headerOptions: Diff.FILE_HEADERS_ONLY,
+    });
+}
+function getDiffPartLines(part) {
+    const lines = part.value.split("\n");
+    if (lines.at(-1) === "")
+        lines.pop();
+    return lines;
+}
+function appendChangedDiffLines(state, part, lines) {
+    state.firstChangedLine ??= state.newLineNumber;
+    for (const line of lines) {
+        if (part.added) {
+            const lineNumber = String(state.newLineNumber).padStart(state.lineNumberWidth, " ");
+            state.output.push(`+${lineNumber} ${line}`);
+            state.newLineNumber++;
+        }
+        else {
+            const lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, " ");
+            state.output.push(`-${lineNumber} ${line}`);
+            state.oldLineNumber++;
+        }
+    }
+}
+function appendContextDiffLines(state, lines) {
+    for (const line of lines) {
+        const lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, " ");
+        state.output.push(` ${lineNumber} ${line}`);
+        state.oldLineNumber++;
+        state.newLineNumber++;
+    }
+}
+function appendSkippedDiffLines(state, count) {
+    if (count <= 0)
+        return;
+    state.output.push(` ${"".padStart(state.lineNumberWidth, " ")} ...`);
+    state.oldLineNumber += count;
+    state.newLineNumber += count;
+}
+function appendContextBetweenChanges(state, lines, contextLines) {
+    if (lines.length <= contextLines * 2) {
+        appendContextDiffLines(state, lines);
+        return;
+    }
+    const leadingLines = lines.slice(0, contextLines);
+    const trailingLines = lines.slice(lines.length - contextLines);
+    appendContextDiffLines(state, leadingLines);
+    appendSkippedDiffLines(state, lines.length - leadingLines.length - trailingLines.length);
+    appendContextDiffLines(state, trailingLines);
+}
+function appendContextAfterChange(state, lines, contextLines) {
+    const shownLines = lines.slice(0, contextLines);
+    appendContextDiffLines(state, shownLines);
+    appendSkippedDiffLines(state, lines.length - shownLines.length);
+}
+function appendContextBeforeChange(state, lines, contextLines) {
+    const skippedLines = Math.max(0, lines.length - contextLines);
+    appendSkippedDiffLines(state, skippedLines);
+    appendContextDiffLines(state, lines.slice(skippedLines));
+}
+function appendUnchangedDiffPart(state, lines, hasLeadingChange, hasTrailingChange, contextLines) {
+    if (hasLeadingChange && hasTrailingChange) {
+        appendContextBetweenChanges(state, lines, contextLines);
+        return;
+    }
+    if (hasLeadingChange) {
+        appendContextAfterChange(state, lines, contextLines);
+        return;
+    }
+    if (hasTrailingChange) {
+        appendContextBeforeChange(state, lines, contextLines);
+        return;
+    }
+    state.oldLineNumber += lines.length;
+    state.newLineNumber += lines.length;
+}
+/**
+ * Generate a display-oriented diff string with line numbers and context.
+ * Returns both the diff string and the first changed line number (in the new file).
+ */
+export function generateDiffString(oldContent, newContent, contextLines = 4) {
+    const parts = Diff.diffLines(oldContent, newContent);
+    const maxLineNumber = Math.max(oldContent.split("\n").length, newContent.split("\n").length);
+    const state = {
+        output: [],
+        oldLineNumber: 1,
+        newLineNumber: 1,
+        lineNumberWidth: String(maxLineNumber).length,
+        firstChangedLine: undefined,
+    };
+    let lastWasChange = false;
+    for (let index = 0; index < parts.length; index++) {
+        const part = parts[index];
+        const lines = getDiffPartLines(part);
+        if (part.added || part.removed) {
+            appendChangedDiffLines(state, part, lines);
+            lastWasChange = true;
+            continue;
+        }
+        const nextPart = parts[index + 1];
+        appendUnchangedDiffPart(state, lines, lastWasChange, index < parts.length - 1 && Boolean(nextPart.added || nextPart.removed), contextLines);
+        lastWasChange = false;
+    }
+    return { diff: state.output.join("\n"), firstChangedLine: state.firstChangedLine };
+}
+/**
+ * Compute the diff for one or more edit operations without applying them.
+ * Used for preview rendering in the TUI before the tool executes.
+ */
+export async function computeEditsDiff(path, edits, operations) {
+    const absolutePath = resolveToCwd(path, operations.cwd);
+    try {
+        // Check if file exists and is readable
+        try {
+            await operations.access(absolutePath, "read");
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error && "code" in error ? `Error code: ${error.code}` : String(error);
+            return { error: `Could not edit file: ${path}. ${errorMessage}.` };
+        }
+        // Read the file
+        const rawContent = (await operations.readFile(absolutePath)).toString("utf-8");
+        // Strip BOM before matching (LLM won't include invisible BOM in oldText)
+        const { text: content } = stripBOM(rawContent);
+        const normalizedContent = normalizeToLF(content);
+        const { baseContent, newContent } = applyEditsToNormalizedContent(normalizedContent, edits, path);
+        // Generate the diff
+        return generateDiffString(baseContent, newContent);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Compute the diff for a single edit operation without applying it.
+ * Kept as a convenience wrapper for single-edit callers.
+ */
+export async function computeEditDiff(path, oldText, newText, operations) {
+    return computeEditsDiff(path, [{ oldText, newText }], operations);
+}
+//# sourceMappingURL=edit-diff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-diff.js","sourceRoot":"","sources":["../../../src/core/tools/edit-diff.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared diff computation utilities for the edit tool.\n * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).\n */\n\nimport * as Diff from \"diff\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { resolveToCwd } from \"./path-utils.ts\";\nimport { type LineEnding, stripBOM } from \"./replace-diff.ts\";\n\nexport { stripBOM as stripBom };\n\nexport function detectLineEnding(content: string): LineEnding {\n\tconst crlfIdx = content.indexOf(\"\\r\\n\");\n\tconst lfIdx = content.indexOf(\"\\n\");\n\tif (lfIdx === -1) return \"\\n\";\n\tif (crlfIdx === -1) return \"\\n\";\n\treturn crlfIdx < lfIdx ? \"\\r\\n\" : \"\\n\";\n}\n\nexport function normalizeToLF(text: string): string {\n\treturn text.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n}\n\nexport function restoreLineEndings(text: string, ending: LineEnding): string {\n\treturn ending === \"\\r\\n\" ? text.replace(/\\n/g, \"\\r\\n\") : text;\n}\n\n/**\n * Normalize text for fuzzy matching. Applies progressive transformations:\n * - Strip trailing whitespace from each line\n * - Normalize smart quotes to ASCII equivalents\n * - Normalize Unicode dashes/hyphens to ASCII hyphen\n * - Normalize special Unicode spaces to regular space\n */\nexport function normalizeForFuzzyMatch(text: string): string {\n\treturn (\n\t\ttext\n\t\t\t.normalize(\"NFKC\")\n\t\t\t// Strip trailing whitespace per line\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => line.trimEnd())\n\t\t\t.join(\"\\n\")\n\t\t\t// Smart single quotes → '\n\t\t\t.replace(/[\\u2018\\u2019\\u201A\\u201B]/g, \"'\")\n\t\t\t// Smart double quotes → \"\n\t\t\t.replace(/[\\u201C\\u201D\\u201E\\u201F]/g, '\"')\n\t\t\t// Various dashes/hyphens → -\n\t\t\t// U+2010 hyphen, U+2011 non-breaking hyphen, U+2012 figure dash,\n\t\t\t// U+2013 en-dash, U+2014 em-dash, U+2015 horizontal bar, U+2212 minus\n\t\t\t.replace(/[\\u2010\\u2011\\u2012\\u2013\\u2014\\u2015\\u2212]/g, \"-\")\n\t\t\t// Special spaces → regular space\n\t\t\t// U+00A0 NBSP, U+2002-U+200A various spaces, U+202F narrow NBSP,\n\t\t\t// U+205F medium math space, U+3000 ideographic space\n\t\t\t.replace(/[\\u00A0\\u2002-\\u200A\\u202F\\u205F\\u3000]/g, \" \")\n\t);\n}\n\nexport interface FuzzyMatchResult {\n\t/** Whether a match was found */\n\tfound: boolean;\n\t/** The index where the match starts (in the content that should be used for replacement) */\n\tindex: number;\n\t/** Length of the matched text */\n\tmatchLength: number;\n\t/** Whether fuzzy matching was used (false = exact match) */\n\tusedFuzzyMatch: boolean;\n\t/**\n\t * The content to use for replacement operations.\n\t * When exact match: original content. When fuzzy match: normalized content.\n\t */\n\tcontentForReplacement: string;\n}\n\nexport interface Edit {\n\toldText: string;\n\tnewText: string;\n}\n\ninterface MatchedEdit {\n\teditIndex: number;\n\tmatchIndex: number;\n\tmatchLength: number;\n\tnewText: string;\n}\n\nexport interface AppliedEditsResult {\n\tbaseContent: string;\n\tnewContent: string;\n}\n\n/**\n * Find oldText in content, trying exact match first, then fuzzy match.\n * When fuzzy matching is used, the returned contentForReplacement is the\n * fuzzy-normalized version of the content (trailing whitespace stripped,\n * Unicode quotes/dashes normalized to ASCII).\n */\nexport function fuzzyFindText(content: string, oldText: string): FuzzyMatchResult {\n\t// Try exact match first\n\tconst exactIndex = content.indexOf(oldText);\n\tif (exactIndex !== -1) {\n\t\treturn {\n\t\t\tfound: true,\n\t\t\tindex: exactIndex,\n\t\t\tmatchLength: oldText.length,\n\t\t\tusedFuzzyMatch: false,\n\t\t\tcontentForReplacement: content,\n\t\t};\n\t}\n\n\t// Try fuzzy match - work entirely in normalized space\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\n\tconst fuzzyIndex = fuzzyContent.indexOf(fuzzyOldText);\n\n\tif (fuzzyIndex === -1) {\n\t\treturn {\n\t\t\tfound: false,\n\t\t\tindex: -1,\n\t\t\tmatchLength: 0,\n\t\t\tusedFuzzyMatch: false,\n\t\t\tcontentForReplacement: content,\n\t\t};\n\t}\n\n\t// When fuzzy matching, we work in the normalized space for replacement.\n\t// This means the output will have normalized whitespace/quotes/dashes,\n\t// which is acceptable since we're fixing minor formatting differences anyway.\n\treturn {\n\t\tfound: true,\n\t\tindex: fuzzyIndex,\n\t\tmatchLength: fuzzyOldText.length,\n\t\tusedFuzzyMatch: true,\n\t\tcontentForReplacement: fuzzyContent,\n\t};\n}\nfunction countOccurrences(content: string, oldText: string): number {\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\n\treturn fuzzyContent.split(fuzzyOldText).length - 1;\n}\n\nfunction getNotFoundError(path: string, editIndex: number, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\n\t\t);\n\t}\n\treturn new Error(\n\t\t`Could not find edits[${editIndex}] in ${path}. The oldText must match exactly including all whitespace and newlines.`,\n\t);\n}\n\nfunction getDuplicateError(path: string, editIndex: number, totalEdits: number, occurrences: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\n\t\t);\n\t}\n\treturn new Error(\n\t\t`Found ${occurrences} occurrences of edits[${editIndex}] in ${path}. Each oldText must be unique. Please provide more context to make it unique.`,\n\t);\n}\n\nfunction getEmptyOldTextError(path: string, editIndex: number, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(`oldText must not be empty in ${path}.`);\n\t}\n\treturn new Error(`edits[${editIndex}].oldText must not be empty in ${path}.`);\n}\n\nfunction getNoChangeError(path: string, totalEdits: number): Error {\n\tif (totalEdits === 1) {\n\t\treturn new Error(\n\t\t\t`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`,\n\t\t);\n\t}\n\treturn new Error(`No changes made to ${path}. The replacements produced identical content.`);\n}\n\n/**\n * Apply one or more exact-text replacements to LF-normalized content.\n *\n * All edits are matched against the same original content. Replacements are\n * then applied in reverse order so offsets remain stable. If any edit needs\n * fuzzy matching, the operation runs in fuzzy-normalized content space to\n * preserve current single-edit behavior.\n */\nexport function applyEditsToNormalizedContent(\n\tnormalizedContent: string,\n\tedits: Edit[],\n\tpath: string,\n): AppliedEditsResult {\n\tconst normalizedEdits = edits.map((edit) => ({\n\t\toldText: normalizeToLF(edit.oldText),\n\t\tnewText: normalizeToLF(edit.newText),\n\t}));\n\n\tfor (let i = 0; i < normalizedEdits.length; i++) {\n\t\tif (normalizedEdits[i].oldText.length === 0) {\n\t\t\tthrow getEmptyOldTextError(path, i, normalizedEdits.length);\n\t\t}\n\t}\n\n\tconst initialMatches = normalizedEdits.map((edit) => fuzzyFindText(normalizedContent, edit.oldText));\n\tconst baseContent = initialMatches.some((match) => match.usedFuzzyMatch)\n\t\t? normalizeForFuzzyMatch(normalizedContent)\n\t\t: normalizedContent;\n\n\tconst matchedEdits: MatchedEdit[] = [];\n\tfor (let i = 0; i < normalizedEdits.length; i++) {\n\t\tconst edit = normalizedEdits[i];\n\t\tconst matchResult = fuzzyFindText(baseContent, edit.oldText);\n\t\tif (!matchResult.found) {\n\t\t\tthrow getNotFoundError(path, i, normalizedEdits.length);\n\t\t}\n\n\t\tconst occurrences = countOccurrences(baseContent, edit.oldText);\n\t\tif (occurrences > 1) {\n\t\t\tthrow getDuplicateError(path, i, normalizedEdits.length, occurrences);\n\t\t}\n\n\t\tmatchedEdits.push({\n\t\t\teditIndex: i,\n\t\t\tmatchIndex: matchResult.index,\n\t\t\tmatchLength: matchResult.matchLength,\n\t\t\tnewText: edit.newText,\n\t\t});\n\t}\n\n\tmatchedEdits.sort((a, b) => a.matchIndex - b.matchIndex);\n\tfor (let i = 1; i < matchedEdits.length; i++) {\n\t\tconst previous = matchedEdits[i - 1];\n\t\tconst current = matchedEdits[i];\n\t\tif (previous.matchIndex + previous.matchLength > current.matchIndex) {\n\t\t\tthrow new Error(\n\t\t\t\t`edits[${previous.editIndex}] and edits[${current.editIndex}] overlap in ${path}. Merge them into one edit or target disjoint regions.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tlet newContent = baseContent;\n\tfor (let i = matchedEdits.length - 1; i >= 0; i--) {\n\t\tconst edit = matchedEdits[i];\n\t\tnewContent =\n\t\t\tnewContent.substring(0, edit.matchIndex) +\n\t\t\tedit.newText +\n\t\t\tnewContent.substring(edit.matchIndex + edit.matchLength);\n\t}\n\n\tif (baseContent === newContent) {\n\t\tthrow getNoChangeError(path, normalizedEdits.length);\n\t}\n\n\treturn { baseContent, newContent };\n}\n\n/** Generate a standard unified patch. */\nexport function generateUnifiedPatch(path: string, oldContent: string, newContent: string, contextLines = 4): string {\n\treturn Diff.createTwoFilesPatch(path, path, oldContent, newContent, undefined, undefined, {\n\t\tcontext: contextLines,\n\t\theaderOptions: Diff.FILE_HEADERS_ONLY,\n\t});\n}\n\ninterface DiffRenderState {\n\toutput: string[];\n\toldLineNumber: number;\n\tnewLineNumber: number;\n\tlineNumberWidth: number;\n\tfirstChangedLine: number | undefined;\n}\n\nfunction getDiffPartLines(part: Diff.Change): string[] {\n\tconst lines = part.value.split(\"\\n\");\n\tif (lines.at(-1) === \"\") lines.pop();\n\treturn lines;\n}\n\nfunction appendChangedDiffLines(state: DiffRenderState, part: Diff.Change, lines: string[]): void {\n\tstate.firstChangedLine ??= state.newLineNumber;\n\tfor (const line of lines) {\n\t\tif (part.added) {\n\t\t\tconst lineNumber = String(state.newLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\t\tstate.output.push(`+${lineNumber} ${line}`);\n\t\t\tstate.newLineNumber++;\n\t\t} else {\n\t\t\tconst lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\t\tstate.output.push(`-${lineNumber} ${line}`);\n\t\t\tstate.oldLineNumber++;\n\t\t}\n\t}\n}\n\nfunction appendContextDiffLines(state: DiffRenderState, lines: string[]): void {\n\tfor (const line of lines) {\n\t\tconst lineNumber = String(state.oldLineNumber).padStart(state.lineNumberWidth, \" \");\n\t\tstate.output.push(` ${lineNumber} ${line}`);\n\t\tstate.oldLineNumber++;\n\t\tstate.newLineNumber++;\n\t}\n}\n\nfunction appendSkippedDiffLines(state: DiffRenderState, count: number): void {\n\tif (count <= 0) return;\n\tstate.output.push(` ${\"\".padStart(state.lineNumberWidth, \" \")} ...`);\n\tstate.oldLineNumber += count;\n\tstate.newLineNumber += count;\n}\n\nfunction appendContextBetweenChanges(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tif (lines.length <= contextLines * 2) {\n\t\tappendContextDiffLines(state, lines);\n\t\treturn;\n\t}\n\tconst leadingLines = lines.slice(0, contextLines);\n\tconst trailingLines = lines.slice(lines.length - contextLines);\n\tappendContextDiffLines(state, leadingLines);\n\tappendSkippedDiffLines(state, lines.length - leadingLines.length - trailingLines.length);\n\tappendContextDiffLines(state, trailingLines);\n}\n\nfunction appendContextAfterChange(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tconst shownLines = lines.slice(0, contextLines);\n\tappendContextDiffLines(state, shownLines);\n\tappendSkippedDiffLines(state, lines.length - shownLines.length);\n}\n\nfunction appendContextBeforeChange(state: DiffRenderState, lines: string[], contextLines: number): void {\n\tconst skippedLines = Math.max(0, lines.length - contextLines);\n\tappendSkippedDiffLines(state, skippedLines);\n\tappendContextDiffLines(state, lines.slice(skippedLines));\n}\n\nfunction appendUnchangedDiffPart(\n\tstate: DiffRenderState,\n\tlines: string[],\n\thasLeadingChange: boolean,\n\thasTrailingChange: boolean,\n\tcontextLines: number,\n): void {\n\tif (hasLeadingChange && hasTrailingChange) {\n\t\tappendContextBetweenChanges(state, lines, contextLines);\n\t\treturn;\n\t}\n\tif (hasLeadingChange) {\n\t\tappendContextAfterChange(state, lines, contextLines);\n\t\treturn;\n\t}\n\tif (hasTrailingChange) {\n\t\tappendContextBeforeChange(state, lines, contextLines);\n\t\treturn;\n\t}\n\tstate.oldLineNumber += lines.length;\n\tstate.newLineNumber += lines.length;\n}\n\n/**\n * Generate a display-oriented diff string with line numbers and context.\n * Returns both the diff string and the first changed line number (in the new file).\n */\nexport function generateDiffString(oldContent: string, newContent: string, contextLines = 4): EditDiffResult {\n\tconst parts = Diff.diffLines(oldContent, newContent);\n\tconst maxLineNumber = Math.max(oldContent.split(\"\\n\").length, newContent.split(\"\\n\").length);\n\tconst state: DiffRenderState = {\n\t\toutput: [],\n\t\toldLineNumber: 1,\n\t\tnewLineNumber: 1,\n\t\tlineNumberWidth: String(maxLineNumber).length,\n\t\tfirstChangedLine: undefined,\n\t};\n\tlet lastWasChange = false;\n\n\tfor (let index = 0; index < parts.length; index++) {\n\t\tconst part = parts[index];\n\t\tconst lines = getDiffPartLines(part);\n\t\tif (part.added || part.removed) {\n\t\t\tappendChangedDiffLines(state, part, lines);\n\t\t\tlastWasChange = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconst nextPart = parts[index + 1];\n\t\tappendUnchangedDiffPart(\n\t\t\tstate,\n\t\t\tlines,\n\t\t\tlastWasChange,\n\t\t\tindex < parts.length - 1 && Boolean(nextPart.added || nextPart.removed),\n\t\t\tcontextLines,\n\t\t);\n\t\tlastWasChange = false;\n\t}\n\n\treturn { diff: state.output.join(\"\\n\"), firstChangedLine: state.firstChangedLine };\n}\n\n// grip-ignore noNearIdenticalDataStructures: Plain line-number diffs and hashline-anchored diffs use distinct rendering formats and evolve independently.\nexport interface EditDiffResult {\n\tdiff: string;\n\tfirstChangedLine: number | undefined;\n}\n\nexport interface EditDiffError {\n\terror: string;\n}\n\n/**\n * Compute the diff for one or more edit operations without applying them.\n * Used for preview rendering in the TUI before the tool executes.\n */\nexport async function computeEditsDiff(\n\tpath: string,\n\tedits: Edit[],\n\toperations: ToolOperations,\n): Promise<EditDiffResult | EditDiffError> {\n\tconst absolutePath = resolveToCwd(path, operations.cwd);\n\n\ttry {\n\t\t// Check if file exists and is readable\n\t\ttry {\n\t\t\tawait operations.access(absolutePath, \"read\");\n\t\t} catch (error: unknown) {\n\t\t\tconst errorMessage = error instanceof Error && \"code\" in error ? `Error code: ${error.code}` : String(error);\n\t\t\treturn { error: `Could not edit file: ${path}. ${errorMessage}.` };\n\t\t}\n\n\t\t// Read the file\n\t\tconst rawContent = (await operations.readFile(absolutePath)).toString(\"utf-8\");\n\n\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\n\t\tconst { text: content } = stripBOM(rawContent);\n\t\tconst normalizedContent = normalizeToLF(content);\n\t\tconst { baseContent, newContent } = applyEditsToNormalizedContent(normalizedContent, edits, path);\n\n\t\t// Generate the diff\n\t\treturn generateDiffString(baseContent, newContent);\n\t} catch (err) {\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\n\t}\n}\n\n/**\n * Compute the diff for a single edit operation without applying it.\n * Kept as a convenience wrapper for single-edit callers.\n */\nexport async function computeEditDiff(\n\tpath: string,\n\toldText: string,\n\tnewText: string,\n\toperations: ToolOperations,\n): Promise<EditDiffResult | EditDiffError> {\n\treturn computeEditsDiff(path, [{ oldText, newText }], operations);\n}\n"]}

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

@@ -0,0 +1,50 @@
+import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from "@greppleai/grip-agent-core";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type HTEdit } from "./hashline/resolve.ts";
+import type { ToolOperations } from "./operations.ts";
+import { type RRState } from "./replace-render.ts";
+declare const editSchema: Type.TObject<{
+    path: Type.TString;
+    changes: Type.TArray<Type.TObject<{
+        hash_range_inclusive: Type.TArray<Type.TString>;
+        content_lines: Type.TArray<Type.TString>;
+    }>>;
+}>;
+export type EditToolInput = Static<typeof editSchema>;
+export type ReqParams = {
+    path: string;
+    changes: HTEdit[];
+};
+interface EditChangedLineRange {
+    first: number;
+    last: number;
+}
+export type RMetrics = {
+    edits_attempted: number;
+    edits_noop: number;
+    warnings: number;
+    classification: "applied" | "noop";
+    changed_lines?: EditChangedLineRange;
+    added_lines?: number;
+    removed_lines?: number;
+};
+export interface ReplaceDetails {
+    diff: string;
+    patch: string;
+    firstChangedLine?: number;
+    classification?: "noop";
+    metrics?: RMetrics;
+}
+export type EditToolDetails = ReplaceDetails;
+export interface EditToolOptions {
+}
+type EditRenderState = RRState;
+export type EditToolDefinition = ToolDefinition<typeof editSchema, EditToolDetails | undefined, EditRenderState>;
+export declare function createEditToolDefinition(operations: ToolOperations, _options?: EditToolOptions): EditToolDefinition;
+type CompatibleEditAgentTool = AgentTool<typeof editSchema, EditToolDetails> & {
+    execute: (toolCallId: string, params: Record<string, unknown>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<EditToolDetails>) => Promise<AgentToolResult<EditToolDetails>>;
+};
+export declare function createEditTool(operations: ToolOperations, options?: EditToolOptions): CompatibleEditAgentTool;
+export {};
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/core/tools/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGtG,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EAAc,KAAK,MAAM,EAAY,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKvE,OAAO,EAA2C,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAuB5F,QAAA,MAAM,UAAU;;;;;;EAQf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AACF,UAAU,oBAAoB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,QAAQ,GAAG;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,SAAS,GAAG,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C,MAAM,WAAW,eAAe;CAAG;AAEnC,KAAK,eAAe,GAAG,OAAO,CAAC;AA2R/B,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,EAAE,eAAe,CAAC,CAAC;AAEjH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,kBAAkB,CA2EnH;AAED,KAAK,uBAAuB,GAAG,SAAS,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC,GAAG;IAC9E,OAAO,EAAE,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,uBAAuB,CAAC,eAAe,CAAC,KAC/C,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,uBAAuB,CAE7G","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"]}