@imdigitalashish/zpi 0.1.1

package/dist/core/tools/bash.js

@@ -0,0 +1,242 @@
+import { randomBytes } from "node:crypto";
+import { createWriteStream, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { spawn } from "child_process";
+import { getShellConfig, getShellEnv, killProcessTree } from "../../utils/shell.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateTail } from "./truncate.js";
+/**
+ * Generate a unique temp file path for bash output
+ */
+function getTempFilePath() {
+    const id = randomBytes(8).toString("hex");
+    return join(tmpdir(), `pi-bash-${id}.log`);
+}
+const bashSchema = Type.Object({
+    command: Type.String({ description: "Bash command to execute" }),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (optional, no default timeout)" })),
+});
+/**
+ * Default bash operations using local shell
+ */
+const defaultBashOperations = {
+    exec: (command, cwd, { onData, signal, timeout, env }) => {
+        return new Promise((resolve, reject) => {
+            const { shell, args } = getShellConfig();
+            if (!existsSync(cwd)) {
+                reject(new Error(`Working directory does not exist: ${cwd}\nCannot execute bash commands.`));
+                return;
+            }
+            const child = spawn(shell, [...args, command], {
+                cwd,
+                detached: true,
+                env: env ?? getShellEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let timedOut = false;
+            // Set timeout if provided
+            let timeoutHandle;
+            if (timeout !== undefined && timeout > 0) {
+                timeoutHandle = setTimeout(() => {
+                    timedOut = true;
+                    if (child.pid) {
+                        killProcessTree(child.pid);
+                    }
+                }, timeout * 1000);
+            }
+            // Stream stdout and stderr
+            if (child.stdout) {
+                child.stdout.on("data", onData);
+            }
+            if (child.stderr) {
+                child.stderr.on("data", onData);
+            }
+            // Handle shell spawn errors
+            child.on("error", (err) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (signal)
+                    signal.removeEventListener("abort", onAbort);
+                reject(err);
+            });
+            // Handle abort signal - kill entire process tree
+            const onAbort = () => {
+                if (child.pid) {
+                    killProcessTree(child.pid);
+                }
+            };
+            if (signal) {
+                if (signal.aborted) {
+                    onAbort();
+                }
+                else {
+                    signal.addEventListener("abort", onAbort, { once: true });
+                }
+            }
+            // Handle process exit
+            child.on("close", (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (signal)
+                    signal.removeEventListener("abort", onAbort);
+                if (signal?.aborted) {
+                    reject(new Error("aborted"));
+                    return;
+                }
+                if (timedOut) {
+                    reject(new Error(`timeout:${timeout}`));
+                    return;
+                }
+                resolve({ exitCode: code });
+            });
+        });
+    },
+};
+function resolveSpawnContext(command, cwd, spawnHook) {
+    const baseContext = {
+        command,
+        cwd,
+        env: { ...getShellEnv() },
+    };
+    return spawnHook ? spawnHook(baseContext) : baseContext;
+}
+export function createBashTool(cwd, options) {
+    const ops = options?.operations ?? defaultBashOperations;
+    const commandPrefix = options?.commandPrefix;
+    const spawnHook = options?.spawnHook;
+    return {
+        name: "bash",
+        label: "bash",
+        description: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,
+        parameters: bashSchema,
+        execute: async (_toolCallId, { command, timeout }, signal, onUpdate) => {
+            // Apply command prefix if configured (e.g., "shopt -s expand_aliases" for alias support)
+            const resolvedCommand = commandPrefix ? `${commandPrefix}\n${command}` : command;
+            const spawnContext = resolveSpawnContext(resolvedCommand, cwd, spawnHook);
+            return new Promise((resolve, reject) => {
+                // We'll stream to a temp file if output gets large
+                let tempFilePath;
+                let tempFileStream;
+                let totalBytes = 0;
+                // Keep a rolling buffer of the last chunk for tail truncation
+                const chunks = [];
+                let chunksBytes = 0;
+                // Keep more than we need so we have enough for truncation
+                const maxChunksBytes = DEFAULT_MAX_BYTES * 2;
+                const handleData = (data) => {
+                    totalBytes += data.length;
+                    // Start writing to temp file once we exceed the threshold
+                    if (totalBytes > DEFAULT_MAX_BYTES && !tempFilePath) {
+                        tempFilePath = getTempFilePath();
+                        tempFileStream = createWriteStream(tempFilePath);
+                        // Write all buffered chunks to the file
+                        for (const chunk of chunks) {
+                            tempFileStream.write(chunk);
+                        }
+                    }
+                    // Write to temp file if we have one
+                    if (tempFileStream) {
+                        tempFileStream.write(data);
+                    }
+                    // Keep rolling buffer of recent data
+                    chunks.push(data);
+                    chunksBytes += data.length;
+                    // Trim old chunks if buffer is too large
+                    while (chunksBytes > maxChunksBytes && chunks.length > 1) {
+                        const removed = chunks.shift();
+                        chunksBytes -= removed.length;
+                    }
+                    // Stream partial output to callback (truncated rolling buffer)
+                    if (onUpdate) {
+                        const fullBuffer = Buffer.concat(chunks);
+                        const fullText = fullBuffer.toString("utf-8");
+                        const truncation = truncateTail(fullText);
+                        onUpdate({
+                            content: [{ type: "text", text: truncation.content || "" }],
+                            details: {
+                                truncation: truncation.truncated ? truncation : undefined,
+                                fullOutputPath: tempFilePath,
+                            },
+                        });
+                    }
+                };
+                ops.exec(spawnContext.command, spawnContext.cwd, {
+                    onData: handleData,
+                    signal,
+                    timeout,
+                    env: spawnContext.env,
+                })
+                    .then(({ exitCode }) => {
+                    // Close temp file stream
+                    if (tempFileStream) {
+                        tempFileStream.end();
+                    }
+                    // Combine all buffered chunks
+                    const fullBuffer = Buffer.concat(chunks);
+                    const fullOutput = fullBuffer.toString("utf-8");
+                    // Apply tail truncation
+                    const truncation = truncateTail(fullOutput);
+                    let outputText = truncation.content || "(no output)";
+                    // Build details with truncation info
+                    let details;
+                    if (truncation.truncated) {
+                        details = {
+                            truncation,
+                            fullOutputPath: tempFilePath,
+                        };
+                        // Build actionable notice
+                        const startLine = truncation.totalLines - truncation.outputLines + 1;
+                        const endLine = truncation.totalLines;
+                        if (truncation.lastLinePartial) {
+                            // Edge case: last line alone > 30KB
+                            const lastLineSize = formatSize(Buffer.byteLength(fullOutput.split("\n").pop() || "", "utf-8"));
+                            outputText += `\n\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${tempFilePath}]`;
+                        }
+                        else if (truncation.truncatedBy === "lines") {
+                            outputText += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${tempFilePath}]`;
+                        }
+                        else {
+                            outputText += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Full output: ${tempFilePath}]`;
+                        }
+                    }
+                    if (exitCode !== 0 && exitCode !== null) {
+                        outputText += `\n\nCommand exited with code ${exitCode}`;
+                        reject(new Error(outputText));
+                    }
+                    else {
+                        resolve({ content: [{ type: "text", text: outputText }], details });
+                    }
+                })
+                    .catch((err) => {
+                    // Close temp file stream
+                    if (tempFileStream) {
+                        tempFileStream.end();
+                    }
+                    // Combine all buffered chunks for error output
+                    const fullBuffer = Buffer.concat(chunks);
+                    let output = fullBuffer.toString("utf-8");
+                    if (err.message === "aborted") {
+                        if (output)
+                            output += "\n\n";
+                        output += "Command aborted";
+                        reject(new Error(output));
+                    }
+                    else if (err.message.startsWith("timeout:")) {
+                        const timeoutSecs = err.message.split(":")[1];
+                        if (output)
+                            output += "\n\n";
+                        output += `Command timed out after ${timeoutSecs} seconds`;
+                        reject(new Error(output));
+                    }
+                    else {
+                        reject(err);
+                    }
+                });
+            });
+        },
+    };
+}
+/** Default bash tool using process.cwd() - for backwards compatibility */
+export const bashTool = createBashTool(process.cwd());
+//# sourceMappingURL=bash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/core/tools/bash.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes } from \"node:crypto\";\r\nimport { createWriteStream, existsSync } from \"node:fs\";\r\nimport { tmpdir } from \"node:os\";\r\nimport { join } from \"node:path\";\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawn } from \"child_process\";\r\nimport { getShellConfig, getShellEnv, killProcessTree } from \"../../utils/shell.js\";\r\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateTail } from \"./truncate.js\";\r\n\r\n/**\r\n * Generate a unique temp file path for bash output\r\n */\r\nfunction getTempFilePath(): string {\r\n\tconst id = randomBytes(8).toString(\"hex\");\r\n\treturn join(tmpdir(), `pi-bash-${id}.log`);\r\n}\r\n\r\nconst bashSchema = Type.Object({\r\n\tcommand: Type.String({ description: \"Bash command to execute\" }),\r\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (optional, no default timeout)\" })),\r\n});\r\n\r\nexport type BashToolInput = Static<typeof bashSchema>;\r\n\r\nexport interface BashToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tfullOutputPath?: string;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the bash tool.\r\n * Override these to delegate command execution to remote systems (e.g., SSH).\r\n */\r\nexport interface BashOperations {\r\n\t/**\r\n\t * Execute a command and stream output.\r\n\t * @param command - The command to execute\r\n\t * @param cwd - Working directory\r\n\t * @param options - Execution options\r\n\t * @returns Promise resolving to exit code (null if killed)\r\n\t */\r\n\texec: (\r\n\t\tcommand: string,\r\n\t\tcwd: string,\r\n\t\toptions: {\r\n\t\t\tonData: (data: Buffer) => void;\r\n\t\t\tsignal?: AbortSignal;\r\n\t\t\ttimeout?: number;\r\n\t\t\tenv?: NodeJS.ProcessEnv;\r\n\t\t},\r\n\t) => Promise<{ exitCode: number | null }>;\r\n}\r\n\r\n/**\r\n * Default bash operations using local shell\r\n */\r\nconst defaultBashOperations: BashOperations = {\r\n\texec: (command, cwd, { onData, signal, timeout, env }) => {\r\n\t\treturn new Promise((resolve, reject) => {\r\n\t\t\tconst { shell, args } = getShellConfig();\r\n\r\n\t\t\tif (!existsSync(cwd)) {\r\n\t\t\t\treject(new Error(`Working directory does not exist: ${cwd}\\nCannot execute bash commands.`));\r\n\t\t\t\treturn;\r\n\t\t\t}\r\n\r\n\t\t\tconst child = spawn(shell, [...args, command], {\r\n\t\t\t\tcwd,\r\n\t\t\t\tdetached: true,\r\n\t\t\t\tenv: env ?? getShellEnv(),\r\n\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\r\n\t\t\t});\r\n\r\n\t\t\tlet timedOut = false;\r\n\r\n\t\t\t// Set timeout if provided\r\n\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\r\n\t\t\tif (timeout !== undefined && timeout > 0) {\r\n\t\t\t\ttimeoutHandle = setTimeout(() => {\r\n\t\t\t\t\ttimedOut = true;\r\n\t\t\t\t\tif (child.pid) {\r\n\t\t\t\t\t\tkillProcessTree(child.pid);\r\n\t\t\t\t\t}\r\n\t\t\t\t}, timeout * 1000);\r\n\t\t\t}\r\n\r\n\t\t\t// Stream stdout and stderr\r\n\t\t\tif (child.stdout) {\r\n\t\t\t\tchild.stdout.on(\"data\", onData);\r\n\t\t\t}\r\n\t\t\tif (child.stderr) {\r\n\t\t\t\tchild.stderr.on(\"data\", onData);\r\n\t\t\t}\r\n\r\n\t\t\t// Handle shell spawn errors\r\n\t\t\tchild.on(\"error\", (err) => {\r\n\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\r\n\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\treject(err);\r\n\t\t\t});\r\n\r\n\t\t\t// Handle abort signal - kill entire process tree\r\n\t\t\tconst onAbort = () => {\r\n\t\t\t\tif (child.pid) {\r\n\t\t\t\t\tkillProcessTree(child.pid);\r\n\t\t\t\t}\r\n\t\t\t};\r\n\r\n\t\t\tif (signal) {\r\n\t\t\t\tif (signal.aborted) {\r\n\t\t\t\t\tonAbort();\r\n\t\t\t\t} else {\r\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\t// Handle process exit\r\n\t\t\tchild.on(\"close\", (code) => {\r\n\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\r\n\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tif (timedOut) {\r\n\t\t\t\t\treject(new Error(`timeout:${timeout}`));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tresolve({ exitCode: code });\r\n\t\t\t});\r\n\t\t});\r\n\t},\r\n};\r\n\r\nexport interface BashSpawnContext {\r\n\tcommand: string;\r\n\tcwd: string;\r\n\tenv: NodeJS.ProcessEnv;\r\n}\r\n\r\nexport type BashSpawnHook = (context: BashSpawnContext) => BashSpawnContext;\r\n\r\nfunction resolveSpawnContext(command: string, cwd: string, spawnHook?: BashSpawnHook): BashSpawnContext {\r\n\tconst baseContext: BashSpawnContext = {\r\n\t\tcommand,\r\n\t\tcwd,\r\n\t\tenv: { ...getShellEnv() },\r\n\t};\r\n\r\n\treturn spawnHook ? spawnHook(baseContext) : baseContext;\r\n}\r\n\r\nexport interface BashToolOptions {\r\n\t/** Custom operations for command execution. Default: local shell */\r\n\toperations?: BashOperations;\r\n\t/** Command prefix prepended to every command (e.g., \"shopt -s expand_aliases\" for alias support) */\r\n\tcommandPrefix?: string;\r\n\t/** Hook to adjust command, cwd, or env before execution */\r\n\tspawnHook?: BashSpawnHook;\r\n}\r\n\r\nexport function createBashTool(cwd: string, options?: BashToolOptions): AgentTool<typeof bashSchema> {\r\n\tconst ops = options?.operations ?? defaultBashOperations;\r\n\tconst commandPrefix = options?.commandPrefix;\r\n\tconst spawnHook = options?.spawnHook;\r\n\r\n\treturn {\r\n\t\tname: \"bash\",\r\n\t\tlabel: \"bash\",\r\n\t\tdescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,\r\n\t\tparameters: bashSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ command, timeout }: { command: string; timeout?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t\tonUpdate?,\r\n\t\t) => {\r\n\t\t\t// Apply command prefix if configured (e.g., \"shopt -s expand_aliases\" for alias support)\r\n\t\t\tconst resolvedCommand = commandPrefix ? `${commandPrefix}\\n${command}` : command;\r\n\t\t\tconst spawnContext = resolveSpawnContext(resolvedCommand, cwd, spawnHook);\r\n\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\t// We'll stream to a temp file if output gets large\r\n\t\t\t\tlet tempFilePath: string | undefined;\r\n\t\t\t\tlet tempFileStream: ReturnType<typeof createWriteStream> | undefined;\r\n\t\t\t\tlet totalBytes = 0;\r\n\r\n\t\t\t\t// Keep a rolling buffer of the last chunk for tail truncation\r\n\t\t\t\tconst chunks: Buffer[] = [];\r\n\t\t\t\tlet chunksBytes = 0;\r\n\t\t\t\t// Keep more than we need so we have enough for truncation\r\n\t\t\t\tconst maxChunksBytes = DEFAULT_MAX_BYTES * 2;\r\n\r\n\t\t\t\tconst handleData = (data: Buffer) => {\r\n\t\t\t\t\ttotalBytes += data.length;\r\n\r\n\t\t\t\t\t// Start writing to temp file once we exceed the threshold\r\n\t\t\t\t\tif (totalBytes > DEFAULT_MAX_BYTES && !tempFilePath) {\r\n\t\t\t\t\t\ttempFilePath = getTempFilePath();\r\n\t\t\t\t\t\ttempFileStream = createWriteStream(tempFilePath);\r\n\t\t\t\t\t\t// Write all buffered chunks to the file\r\n\t\t\t\t\t\tfor (const chunk of chunks) {\r\n\t\t\t\t\t\t\ttempFileStream.write(chunk);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Write to temp file if we have one\r\n\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\ttempFileStream.write(data);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Keep rolling buffer of recent data\r\n\t\t\t\t\tchunks.push(data);\r\n\t\t\t\t\tchunksBytes += data.length;\r\n\r\n\t\t\t\t\t// Trim old chunks if buffer is too large\r\n\t\t\t\t\twhile (chunksBytes > maxChunksBytes && chunks.length > 1) {\r\n\t\t\t\t\t\tconst removed = chunks.shift()!;\r\n\t\t\t\t\t\tchunksBytes -= removed.length;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Stream partial output to callback (truncated rolling buffer)\r\n\t\t\t\t\tif (onUpdate) {\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tconst fullText = fullBuffer.toString(\"utf-8\");\r\n\t\t\t\t\t\tconst truncation = truncateTail(fullText);\r\n\t\t\t\t\t\tonUpdate({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: truncation.content || \"\" }],\r\n\t\t\t\t\t\t\tdetails: {\r\n\t\t\t\t\t\t\t\ttruncation: truncation.truncated ? truncation : undefined,\r\n\t\t\t\t\t\t\t\tfullOutputPath: tempFilePath,\r\n\t\t\t\t\t\t\t},\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t}\r\n\t\t\t\t};\r\n\r\n\t\t\t\tops.exec(spawnContext.command, spawnContext.cwd, {\r\n\t\t\t\t\tonData: handleData,\r\n\t\t\t\t\tsignal,\r\n\t\t\t\t\ttimeout,\r\n\t\t\t\t\tenv: spawnContext.env,\r\n\t\t\t\t})\r\n\t\t\t\t\t.then(({ exitCode }) => {\r\n\t\t\t\t\t\t// Close temp file stream\r\n\t\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\t\ttempFileStream.end();\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Combine all buffered chunks\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tconst fullOutput = fullBuffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\t// Apply tail truncation\r\n\t\t\t\t\t\tconst truncation = truncateTail(fullOutput);\r\n\t\t\t\t\t\tlet outputText = truncation.content || \"(no output)\";\r\n\r\n\t\t\t\t\t\t// Build details with truncation info\r\n\t\t\t\t\t\tlet details: BashToolDetails | undefined;\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tdetails = {\r\n\t\t\t\t\t\t\t\ttruncation,\r\n\t\t\t\t\t\t\t\tfullOutputPath: tempFilePath,\r\n\t\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\t\t// Build actionable notice\r\n\t\t\t\t\t\t\tconst startLine = truncation.totalLines - truncation.outputLines + 1;\r\n\t\t\t\t\t\t\tconst endLine = truncation.totalLines;\r\n\r\n\t\t\t\t\t\t\tif (truncation.lastLinePartial) {\r\n\t\t\t\t\t\t\t\t// Edge case: last line alone > 30KB\r\n\t\t\t\t\t\t\t\tconst lastLineSize = formatSize(Buffer.byteLength(fullOutput.split(\"\\n\").pop() || \"\", \"utf-8\"));\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t} else if (truncation.truncatedBy === \"lines\") {\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (exitCode !== 0 && exitCode !== null) {\r\n\t\t\t\t\t\t\toutputText += `\\n\\nCommand exited with code ${exitCode}`;\r\n\t\t\t\t\t\t\treject(new Error(outputText));\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: outputText }], details });\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t})\r\n\t\t\t\t\t.catch((err: Error) => {\r\n\t\t\t\t\t\t// Close temp file stream\r\n\t\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\t\ttempFileStream.end();\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Combine all buffered chunks for error output\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tlet output = fullBuffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\tif (err.message === \"aborted\") {\r\n\t\t\t\t\t\t\tif (output) output += \"\\n\\n\";\r\n\t\t\t\t\t\t\toutput += \"Command aborted\";\r\n\t\t\t\t\t\t\treject(new Error(output));\r\n\t\t\t\t\t\t} else if (err.message.startsWith(\"timeout:\")) {\r\n\t\t\t\t\t\t\tconst timeoutSecs = err.message.split(\":\")[1];\r\n\t\t\t\t\t\t\tif (output) output += \"\\n\\n\";\r\n\t\t\t\t\t\t\toutput += `Command timed out after ${timeoutSecs} seconds`;\r\n\t\t\t\t\t\t\treject(new Error(output));\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\treject(err);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t});\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default bash tool using process.cwd() - for backwards compatibility */\r\nexport const bashTool = createBashTool(process.cwd());\r\n"]}

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

@@ -0,0 +1,63 @@
+/**
+ * Shared diff computation utilities for the edit tool.
+ * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).
+ */
+export declare function detectLineEnding(content: string): "\r\n" | "\n";
+export declare function normalizeToLF(text: string): string;
+export declare function restoreLineEndings(text: string, ending: "\r\n" | "\n"): 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;
+}
+/**
+ * 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;
+/** Strip UTF-8 BOM if present, return both the BOM (if any) and the text without it */
+export declare function stripBom(content: string): {
+    bom: string;
+    text: string;
+};
+/**
+ * Generate a unified 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): {
+    diff: string;
+    firstChangedLine: number | undefined;
+};
+export interface EditDiffResult {
+    diff: string;
+    firstChangedLine: number | undefined;
+}
+export interface EditDiffError {
+    error: string;
+}
+/**
+ * Compute the diff for an edit operation without applying it.
+ * Used for preview rendering in the TUI before the tool executes.
+ */
+export declare function computeEditDiff(path: string, oldText: string, newText: string, cwd: string): 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;AAOH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB3D;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;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAsChF;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,SAAI,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAgGxD;AAED,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,eAAe,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CA6DzC","sourcesContent":["/**\r\n * Shared diff computation utilities for the edit tool.\r\n * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).\r\n */\r\n\r\nimport * as Diff from \"diff\";\r\nimport { constants } from \"fs\";\r\nimport { access, readFile } from \"fs/promises\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\n\r\nexport function detectLineEnding(content: string): \"\\r\\n\" | \"\\n\" {\r\n\tconst crlfIdx = content.indexOf(\"\\r\\n\");\r\n\tconst lfIdx = content.indexOf(\"\\n\");\r\n\tif (lfIdx === -1) return \"\\n\";\r\n\tif (crlfIdx === -1) return \"\\n\";\r\n\treturn crlfIdx < lfIdx ? \"\\r\\n\" : \"\\n\";\r\n}\r\n\r\nexport function normalizeToLF(text: string): string {\r\n\treturn text.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\r\n}\r\n\r\nexport function restoreLineEndings(text: string, ending: \"\\r\\n\" | \"\\n\"): string {\r\n\treturn ending === \"\\r\\n\" ? text.replace(/\\n/g, \"\\r\\n\") : text;\r\n}\r\n\r\n/**\r\n * Normalize text for fuzzy matching. Applies progressive transformations:\r\n * - Strip trailing whitespace from each line\r\n * - Normalize smart quotes to ASCII equivalents\r\n * - Normalize Unicode dashes/hyphens to ASCII hyphen\r\n * - Normalize special Unicode spaces to regular space\r\n */\r\nexport function normalizeForFuzzyMatch(text: string): string {\r\n\treturn (\r\n\t\ttext\r\n\t\t\t// Strip trailing whitespace per line\r\n\t\t\t.split(\"\\n\")\r\n\t\t\t.map((line) => line.trimEnd())\r\n\t\t\t.join(\"\\n\")\r\n\t\t\t// Smart single quotes → '\r\n\t\t\t.replace(/[\\u2018\\u2019\\u201A\\u201B]/g, \"'\")\r\n\t\t\t// Smart double quotes → \"\r\n\t\t\t.replace(/[\\u201C\\u201D\\u201E\\u201F]/g, '\"')\r\n\t\t\t// Various dashes/hyphens → -\r\n\t\t\t// U+2010 hyphen, U+2011 non-breaking hyphen, U+2012 figure dash,\r\n\t\t\t// U+2013 en-dash, U+2014 em-dash, U+2015 horizontal bar, U+2212 minus\r\n\t\t\t.replace(/[\\u2010\\u2011\\u2012\\u2013\\u2014\\u2015\\u2212]/g, \"-\")\r\n\t\t\t// Special spaces → regular space\r\n\t\t\t// U+00A0 NBSP, U+2002-U+200A various spaces, U+202F narrow NBSP,\r\n\t\t\t// U+205F medium math space, U+3000 ideographic space\r\n\t\t\t.replace(/[\\u00A0\\u2002-\\u200A\\u202F\\u205F\\u3000]/g, \" \")\r\n\t);\r\n}\r\n\r\nexport interface FuzzyMatchResult {\r\n\t/** Whether a match was found */\r\n\tfound: boolean;\r\n\t/** The index where the match starts (in the content that should be used for replacement) */\r\n\tindex: number;\r\n\t/** Length of the matched text */\r\n\tmatchLength: number;\r\n\t/** Whether fuzzy matching was used (false = exact match) */\r\n\tusedFuzzyMatch: boolean;\r\n\t/**\r\n\t * The content to use for replacement operations.\r\n\t * When exact match: original content. When fuzzy match: normalized content.\r\n\t */\r\n\tcontentForReplacement: string;\r\n}\r\n\r\n/**\r\n * Find oldText in content, trying exact match first, then fuzzy match.\r\n * When fuzzy matching is used, the returned contentForReplacement is the\r\n * fuzzy-normalized version of the content (trailing whitespace stripped,\r\n * Unicode quotes/dashes normalized to ASCII).\r\n */\r\nexport function fuzzyFindText(content: string, oldText: string): FuzzyMatchResult {\r\n\t// Try exact match first\r\n\tconst exactIndex = content.indexOf(oldText);\r\n\tif (exactIndex !== -1) {\r\n\t\treturn {\r\n\t\t\tfound: true,\r\n\t\t\tindex: exactIndex,\r\n\t\t\tmatchLength: oldText.length,\r\n\t\t\tusedFuzzyMatch: false,\r\n\t\t\tcontentForReplacement: content,\r\n\t\t};\r\n\t}\r\n\r\n\t// Try fuzzy match - work entirely in normalized space\r\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\r\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\r\n\tconst fuzzyIndex = fuzzyContent.indexOf(fuzzyOldText);\r\n\r\n\tif (fuzzyIndex === -1) {\r\n\t\treturn {\r\n\t\t\tfound: false,\r\n\t\t\tindex: -1,\r\n\t\t\tmatchLength: 0,\r\n\t\t\tusedFuzzyMatch: false,\r\n\t\t\tcontentForReplacement: content,\r\n\t\t};\r\n\t}\r\n\r\n\t// When fuzzy matching, we work in the normalized space for replacement.\r\n\t// This means the output will have normalized whitespace/quotes/dashes,\r\n\t// which is acceptable since we're fixing minor formatting differences anyway.\r\n\treturn {\r\n\t\tfound: true,\r\n\t\tindex: fuzzyIndex,\r\n\t\tmatchLength: fuzzyOldText.length,\r\n\t\tusedFuzzyMatch: true,\r\n\t\tcontentForReplacement: fuzzyContent,\r\n\t};\r\n}\r\n\r\n/** Strip UTF-8 BOM if present, return both the BOM (if any) and the text without it */\r\nexport function stripBom(content: string): { bom: string; text: string } {\r\n\treturn content.startsWith(\"\\uFEFF\") ? { bom: \"\\uFEFF\", text: content.slice(1) } : { bom: \"\", text: content };\r\n}\r\n\r\n/**\r\n * Generate a unified diff string with line numbers and context.\r\n * Returns both the diff string and the first changed line number (in the new file).\r\n */\r\nexport function generateDiffString(\r\n\toldContent: string,\r\n\tnewContent: string,\r\n\tcontextLines = 4,\r\n): { diff: string; firstChangedLine: number | undefined } {\r\n\tconst parts = Diff.diffLines(oldContent, newContent);\r\n\tconst output: string[] = [];\r\n\r\n\tconst oldLines = oldContent.split(\"\\n\");\r\n\tconst newLines = newContent.split(\"\\n\");\r\n\tconst maxLineNum = Math.max(oldLines.length, newLines.length);\r\n\tconst lineNumWidth = String(maxLineNum).length;\r\n\r\n\tlet oldLineNum = 1;\r\n\tlet newLineNum = 1;\r\n\tlet lastWasChange = false;\r\n\tlet firstChangedLine: number | undefined;\r\n\r\n\tfor (let i = 0; i < parts.length; i++) {\r\n\t\tconst part = parts[i];\r\n\t\tconst raw = part.value.split(\"\\n\");\r\n\t\tif (raw[raw.length - 1] === \"\") {\r\n\t\t\traw.pop();\r\n\t\t}\r\n\r\n\t\tif (part.added || part.removed) {\r\n\t\t\t// Capture the first changed line (in the new file)\r\n\t\t\tif (firstChangedLine === undefined) {\r\n\t\t\t\tfirstChangedLine = newLineNum;\r\n\t\t\t}\r\n\r\n\t\t\t// Show the change\r\n\t\t\tfor (const line of raw) {\r\n\t\t\t\tif (part.added) {\r\n\t\t\t\t\tconst lineNum = String(newLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(`+${lineNum} ${line}`);\r\n\t\t\t\t\tnewLineNum++;\r\n\t\t\t\t} else {\r\n\t\t\t\t\t// removed\r\n\t\t\t\t\tconst lineNum = String(oldLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(`-${lineNum} ${line}`);\r\n\t\t\t\t\toldLineNum++;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tlastWasChange = true;\r\n\t\t} else {\r\n\t\t\t// Context lines - only show a few before/after changes\r\n\t\t\tconst nextPartIsChange = i < parts.length - 1 && (parts[i + 1].added || parts[i + 1].removed);\r\n\r\n\t\t\tif (lastWasChange || nextPartIsChange) {\r\n\t\t\t\t// Show context\r\n\t\t\t\tlet linesToShow = raw;\r\n\t\t\t\tlet skipStart = 0;\r\n\t\t\t\tlet skipEnd = 0;\r\n\r\n\t\t\t\tif (!lastWasChange) {\r\n\t\t\t\t\t// Show only last N lines as leading context\r\n\t\t\t\t\tskipStart = Math.max(0, raw.length - contextLines);\r\n\t\t\t\t\tlinesToShow = raw.slice(skipStart);\r\n\t\t\t\t}\r\n\r\n\t\t\t\tif (!nextPartIsChange && linesToShow.length > contextLines) {\r\n\t\t\t\t\t// Show only first N lines as trailing context\r\n\t\t\t\t\tskipEnd = linesToShow.length - contextLines;\r\n\t\t\t\t\tlinesToShow = linesToShow.slice(0, contextLines);\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Add ellipsis if we skipped lines at start\r\n\t\t\t\tif (skipStart > 0) {\r\n\t\t\t\t\toutput.push(` ${\"\".padStart(lineNumWidth, \" \")} ...`);\r\n\t\t\t\t\t// Update line numbers for the skipped leading context\r\n\t\t\t\t\toldLineNum += skipStart;\r\n\t\t\t\t\tnewLineNum += skipStart;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tfor (const line of linesToShow) {\r\n\t\t\t\t\tconst lineNum = String(oldLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(` ${lineNum} ${line}`);\r\n\t\t\t\t\toldLineNum++;\r\n\t\t\t\t\tnewLineNum++;\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Add ellipsis if we skipped lines at end\r\n\t\t\t\tif (skipEnd > 0) {\r\n\t\t\t\t\toutput.push(` ${\"\".padStart(lineNumWidth, \" \")} ...`);\r\n\t\t\t\t\t// Update line numbers for the skipped trailing context\r\n\t\t\t\t\toldLineNum += skipEnd;\r\n\t\t\t\t\tnewLineNum += skipEnd;\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\t// Skip these context lines entirely\r\n\t\t\t\toldLineNum += raw.length;\r\n\t\t\t\tnewLineNum += raw.length;\r\n\t\t\t}\r\n\r\n\t\t\tlastWasChange = false;\r\n\t\t}\r\n\t}\r\n\r\n\treturn { diff: output.join(\"\\n\"), firstChangedLine };\r\n}\r\n\r\nexport interface EditDiffResult {\r\n\tdiff: string;\r\n\tfirstChangedLine: number | undefined;\r\n}\r\n\r\nexport interface EditDiffError {\r\n\terror: string;\r\n}\r\n\r\n/**\r\n * Compute the diff for an edit operation without applying it.\r\n * Used for preview rendering in the TUI before the tool executes.\r\n */\r\nexport async function computeEditDiff(\r\n\tpath: string,\r\n\toldText: string,\r\n\tnewText: string,\r\n\tcwd: string,\r\n): Promise<EditDiffResult | EditDiffError> {\r\n\tconst absolutePath = resolveToCwd(path, cwd);\r\n\r\n\ttry {\r\n\t\t// Check if file exists and is readable\r\n\t\ttry {\r\n\t\t\tawait access(absolutePath, constants.R_OK);\r\n\t\t} catch {\r\n\t\t\treturn { error: `File not found: ${path}` };\r\n\t\t}\r\n\r\n\t\t// Read the file\r\n\t\tconst rawContent = await readFile(absolutePath, \"utf-8\");\r\n\r\n\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\r\n\t\tconst { text: content } = stripBom(rawContent);\r\n\r\n\t\tconst normalizedContent = normalizeToLF(content);\r\n\t\tconst normalizedOldText = normalizeToLF(oldText);\r\n\t\tconst normalizedNewText = normalizeToLF(newText);\r\n\r\n\t\t// Find the old text using fuzzy matching (tries exact match first, then fuzzy)\r\n\t\tconst matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\r\n\r\n\t\tif (!matchResult.found) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Count occurrences using fuzzy-normalized content for consistency\r\n\t\tconst fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\r\n\t\tconst fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\r\n\t\tconst occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\r\n\r\n\t\tif (occurrences > 1) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Compute the new content using the matched position\r\n\t\t// When fuzzy matching was used, contentForReplacement is the normalized version\r\n\t\tconst baseContent = matchResult.contentForReplacement;\r\n\t\tconst newContent =\r\n\t\t\tbaseContent.substring(0, matchResult.index) +\r\n\t\t\tnormalizedNewText +\r\n\t\t\tbaseContent.substring(matchResult.index + matchResult.matchLength);\r\n\r\n\t\t// Check if it would actually change anything\r\n\t\tif (baseContent === newContent) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `No changes would be made to ${path}. The replacement produces identical content.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Generate the diff\r\n\t\treturn generateDiffString(baseContent, newContent);\r\n\t} catch (err) {\r\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\r\n\t}\r\n}\r\n"]}

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

@@ -0,0 +1,243 @@
+/**
+ * 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 { constants } from "fs";
+import { access, readFile } from "fs/promises";
+import { resolveToCwd } from "./path-utils.js";
+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
+        // 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,
+    };
+}
+/** Strip UTF-8 BOM if present, return both the BOM (if any) and the text without it */
+export function stripBom(content) {
+    return content.startsWith("\uFEFF") ? { bom: "\uFEFF", text: content.slice(1) } : { bom: "", text: content };
+}
+/**
+ * Generate a unified 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 output = [];
+    const oldLines = oldContent.split("\n");
+    const newLines = newContent.split("\n");
+    const maxLineNum = Math.max(oldLines.length, newLines.length);
+    const lineNumWidth = String(maxLineNum).length;
+    let oldLineNum = 1;
+    let newLineNum = 1;
+    let lastWasChange = false;
+    let firstChangedLine;
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        const raw = part.value.split("\n");
+        if (raw[raw.length - 1] === "") {
+            raw.pop();
+        }
+        if (part.added || part.removed) {
+            // Capture the first changed line (in the new file)
+            if (firstChangedLine === undefined) {
+                firstChangedLine = newLineNum;
+            }
+            // Show the change
+            for (const line of raw) {
+                if (part.added) {
+                    const lineNum = String(newLineNum).padStart(lineNumWidth, " ");
+                    output.push(`+${lineNum} ${line}`);
+                    newLineNum++;
+                }
+                else {
+                    // removed
+                    const lineNum = String(oldLineNum).padStart(lineNumWidth, " ");
+                    output.push(`-${lineNum} ${line}`);
+                    oldLineNum++;
+                }
+            }
+            lastWasChange = true;
+        }
+        else {
+            // Context lines - only show a few before/after changes
+            const nextPartIsChange = i < parts.length - 1 && (parts[i + 1].added || parts[i + 1].removed);
+            if (lastWasChange || nextPartIsChange) {
+                // Show context
+                let linesToShow = raw;
+                let skipStart = 0;
+                let skipEnd = 0;
+                if (!lastWasChange) {
+                    // Show only last N lines as leading context
+                    skipStart = Math.max(0, raw.length - contextLines);
+                    linesToShow = raw.slice(skipStart);
+                }
+                if (!nextPartIsChange && linesToShow.length > contextLines) {
+                    // Show only first N lines as trailing context
+                    skipEnd = linesToShow.length - contextLines;
+                    linesToShow = linesToShow.slice(0, contextLines);
+                }
+                // Add ellipsis if we skipped lines at start
+                if (skipStart > 0) {
+                    output.push(` ${"".padStart(lineNumWidth, " ")} ...`);
+                    // Update line numbers for the skipped leading context
+                    oldLineNum += skipStart;
+                    newLineNum += skipStart;
+                }
+                for (const line of linesToShow) {
+                    const lineNum = String(oldLineNum).padStart(lineNumWidth, " ");
+                    output.push(` ${lineNum} ${line}`);
+                    oldLineNum++;
+                    newLineNum++;
+                }
+                // Add ellipsis if we skipped lines at end
+                if (skipEnd > 0) {
+                    output.push(` ${"".padStart(lineNumWidth, " ")} ...`);
+                    // Update line numbers for the skipped trailing context
+                    oldLineNum += skipEnd;
+                    newLineNum += skipEnd;
+                }
+            }
+            else {
+                // Skip these context lines entirely
+                oldLineNum += raw.length;
+                newLineNum += raw.length;
+            }
+            lastWasChange = false;
+        }
+    }
+    return { diff: output.join("\n"), firstChangedLine };
+}
+/**
+ * Compute the diff for an edit operation without applying it.
+ * Used for preview rendering in the TUI before the tool executes.
+ */
+export async function computeEditDiff(path, oldText, newText, cwd) {
+    const absolutePath = resolveToCwd(path, cwd);
+    try {
+        // Check if file exists and is readable
+        try {
+            await access(absolutePath, constants.R_OK);
+        }
+        catch {
+            return { error: `File not found: ${path}` };
+        }
+        // Read the file
+        const rawContent = await readFile(absolutePath, "utf-8");
+        // Strip BOM before matching (LLM won't include invisible BOM in oldText)
+        const { text: content } = stripBom(rawContent);
+        const normalizedContent = normalizeToLF(content);
+        const normalizedOldText = normalizeToLF(oldText);
+        const normalizedNewText = normalizeToLF(newText);
+        // Find the old text using fuzzy matching (tries exact match first, then fuzzy)
+        const matchResult = fuzzyFindText(normalizedContent, normalizedOldText);
+        if (!matchResult.found) {
+            return {
+                error: `Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,
+            };
+        }
+        // Count occurrences using fuzzy-normalized content for consistency
+        const fuzzyContent = normalizeForFuzzyMatch(normalizedContent);
+        const fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);
+        const occurrences = fuzzyContent.split(fuzzyOldText).length - 1;
+        if (occurrences > 1) {
+            return {
+                error: `Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,
+            };
+        }
+        // Compute the new content using the matched position
+        // When fuzzy matching was used, contentForReplacement is the normalized version
+        const baseContent = matchResult.contentForReplacement;
+        const newContent = baseContent.substring(0, matchResult.index) +
+            normalizedNewText +
+            baseContent.substring(matchResult.index + matchResult.matchLength);
+        // Check if it would actually change anything
+        if (baseContent === newContent) {
+            return {
+                error: `No changes would be made to ${path}. The replacement produces identical content.`,
+            };
+        }
+        // Generate the diff
+        return generateDiffString(baseContent, newContent);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=edit-diff.js.map