@ottocode/sdk 0.1.231 → 0.1.233

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ottocode/sdk",
-	"version": "0.1.231",
+	"version": "0.1.233",
 	"description": "AI agent SDK for building intelligent assistants - tree-shakable and comprehensive",
 	"author": "nitishxyz",
 	"license": "MIT",
@@ -37,10 +37,6 @@
 			"import": "./src/core/src/tools/builtin/bash.ts",
 			"types": "./src/core/src/tools/builtin/bash.ts"
 		},
-		"./tools/builtin/edit": {
-			"import": "./src/core/src/tools/builtin/edit.ts",
-			"types": "./src/core/src/tools/builtin/edit.ts"
-		},
 		"./tools/builtin/finish": {
 			"import": "./src/core/src/tools/builtin/finish.ts",
 			"types": "./src/core/src/tools/builtin/finish.ts"

package/src/core/src/index.ts

@@ -50,8 +50,6 @@ export type {
 export { buildFsTools } from './tools/builtin/fs/index';
 export { buildGitTools } from './tools/builtin/git';
 export { buildTerminalTool } from './tools/builtin/terminal';
-export { buildEditTool } from './tools/builtin/edit';
-export { buildMultiEditTool } from './tools/builtin/multiedit';
 
 // =======================
 // Terminals

package/src/core/src/tools/builtin/fs/write.txt

@@ -6,6 +6,6 @@
 Usage tips:
 - Use for creating NEW files
 - Use when replacing >70% of a file's content (almost complete rewrite)
-- NEVER use for partial/targeted edits - use apply_patch or edit instead
+- NEVER use for partial/targeted edits - use apply_patch instead
 - Using write for partial edits wastes output tokens and risks hallucinating unchanged parts
 - Prefer idempotent writes by providing the full intended content when you do use write

package/src/core/src/tools/loader.ts

@@ -8,8 +8,6 @@ import { buildBashTool } from './builtin/bash.ts';
 import { buildRipgrepTool } from './builtin/ripgrep.ts';
 import { buildGlobTool } from './builtin/glob.ts';
 import { buildApplyPatchTool } from './builtin/patch.ts';
-import { buildEditTool } from './builtin/edit.ts';
-import { buildMultiEditTool } from './builtin/multiedit.ts';
 import { updateTodosTool } from './builtin/todos.ts';
 import { buildWebSearchTool } from './builtin/websearch.ts';
 import { buildTerminalTool } from './builtin/terminal.ts';
@@ -136,11 +134,6 @@ export async function discoverProjectTools(
 	// Patch/apply
 	const ap = buildApplyPatchTool(projectRoot);
 	tools.set(ap.name, ap.tool);
-	// Edit (fuzzy string replacement)
-	const ed = buildEditTool(projectRoot);
-	tools.set(ed.name, ed.tool);
-	const med = buildMultiEditTool(projectRoot);
-	tools.set(med.name, med.tool);
 	// Todo tracking
 	tools.set('update_todos', updateTodosTool);
 	// Web search

package/src/index.ts

@@ -234,8 +234,6 @@ export {
 	OTTOCODE_BOT_EMAIL,
 	OTTOCODE_CO_AUTHOR,
 } from './core/src/tools/builtin/git-identity.ts';
-export { buildEditTool } from './core/src/index.ts';
-export { buildMultiEditTool } from './core/src/index.ts';
 
 // Terminals
 export { TerminalManager } from './core/src/index.ts';

package/src/prompts/src/agents/build.txt

@@ -202,15 +202,7 @@ Key points:
 ## When Patch Fails
 - Error means context didn't match or file changed
 - Solution: Read the file AGAIN, copy context character-by-character
-- After 2 consecutive failures on the same file: switch to the `edit` tool instead — it uses fuzzy matching (oldString/newString) and tolerates whitespace/indentation mismatches
-- If `edit` also fails, use `write` tool to rewrite the entire file
-
-## Using the `edit` Tool (Recommended Fallback)
-- Parameters: `filePath`, `oldString`, `newString`, `replaceAll` (optional)
-- Uses 9 fuzzy matching strategies: trims whitespace, normalizes indentation, anchors on first/last lines, etc.
-- Much more forgiving than `apply_patch` — handles trailing commas, whitespace differences, indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- To create a new file: use empty `oldString` with `newString` as the file contents
+- After repeated failures on the same file: use `write` only if a full-file rewrite is the safer option
 
 ## Using the `write` Tool (Last Resort)
 - Use for creating NEW files

package/src/prompts/src/base.txt

@@ -21,4 +21,4 @@ File Editing Best Practices:
 - When making multiple edits to the same file, use multiple `@@` hunks in a single `apply_patch` call
 - Never assume file content remains unchanged between separate apply_patch operations
 - If a patch fails, read the file AGAIN and copy the exact lines
-- If `apply_patch` fails 2+ times on the same file, switch to the `edit` tool (oldString/newString with fuzzy matching) or `write` to rewrite the file
+- If `apply_patch` fails repeatedly on the same file, fall back to `write` only when a full-file rewrite is appropriate

package/src/prompts/src/providers/anthropic.txt

@@ -262,9 +262,7 @@ File (10 spaces):           - os: linux
 - Don't retry with same context - read file AGAIN first
 - Check that context lines exist exactly as written
 - Verify indentation matches (spaces vs tabs)
-- If failing 2+ times, switch to the `edit` tool — it uses fuzzy matching (oldString/newString) and tolerates whitespace/indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- If `edit` also fails, use `write` tool to rewrite the entire file instead
+- If failing repeatedly, use `write` tool to rewrite the entire file only when a full rewrite is the safest option
 
 # Code References
 

package/src/prompts/src/providers/default.txt

@@ -21,8 +21,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
 - `read`: Read file contents (supports line ranges)
 - `write`: Write complete file contents
 - `apply_patch`: Apply unified diff patches (RECOMMENDED for targeted edits)
-- `edit`: Fuzzy string replacement (oldString → newString) — use when `apply_patch` fails
-- `multiedit`: Batch multiple `edit` operations on a single file
 
 **Version Control**:
 - `git_status`, `git_diff`
@@ -78,13 +76,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
  more context                 ← More context (space prefix)
 ```
 
-**Using the `edit` Tool** (Recommended Fallback When Patch Fails):
-- Parameters: `filePath`, `oldString`, `newString`, `replaceAll` (optional)
-- Uses 9 fuzzy matching strategies: trims whitespace, normalizes indentation, anchors on first/last lines
-- Much more forgiving than `apply_patch` — handles trailing commas, whitespace differences, indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- To create a new file: use empty `oldString` with `newString` as the file contents
-
 **Using the `write` Tool** (Last Resort):
 - Use for creating NEW files
 - Use when replacing >70% of a file's content (almost complete rewrite)
@@ -474,8 +465,7 @@ File (10 spaces):           - os: linux
 
 **If Patch Fails:**
 - Read file AGAIN, copy context character-by-character
-- After 2 failures: switch to `edit` tool — it uses fuzzy matching and tolerates whitespace/indentation mismatches
-- If `edit` also fails: use `write` tool to rewrite the entire file instead
+- After repeated failures: use `write` tool to rewrite the entire file only if a full-file rewrite is justified
 
 ## `update_todos`
 

package/src/prompts/src/providers/glm.txt

@@ -37,8 +37,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
 - `read`: Read file contents (supports line ranges)
 - `write`: Write complete file contents
 - `apply_patch`: Apply unified diff patches (RECOMMENDED for targeted edits)
-- `edit`: Fuzzy string replacement (oldString → newString) — use when `apply_patch` fails
-- `multiedit`: Batch multiple `edit` operations on a single file
 
 **Version Control**:
 - `git_status`, `git_diff`
@@ -167,13 +165,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
 - Lines starting with ` ` (space) are context (kept unchanged)
 - Lines starting with `@@` are optional hints/comments (not parsed as context)
 
-**Using the `edit` Tool** (Recommended Fallback When Patch Fails):
-- Parameters: `filePath`, `oldString`, `newString`, `replaceAll` (optional)
-- Uses 9 fuzzy matching strategies: trims whitespace, normalizes indentation, anchors on first/last lines
-- Much more forgiving than `apply_patch` — handles trailing commas, whitespace differences, indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- To create a new file: use empty `oldString` with `newString` as the file contents
-
 **Using the `write` Tool** (Last Resort):
 - Use for creating NEW files
 - Use when replacing >70% of a file's content (almost complete rewrite)
@@ -300,7 +291,7 @@ GLM's reasoning can cause it to "reconstruct" code from training data rather tha
 
 When patching files that contain markdown code fences (` ``` `), the fence characters can interfere with the `*** End Patch` marker detection, causing the entire patch to fail.
 
-**Rule: When patching files that contain ` ``` ` (like README.md), prefer patching them in a SEPARATE `apply_patch` call from other files, or use the `edit` tool instead.**
+**Rule: When patching files that contain ` ``` ` (like README.md), prefer patching them in a SEPARATE `apply_patch` call from other files. If patching remains too fragile, consider a full-file `write` only when the rewrite is justified.**
 
 ### Pitfall 4: Indentation Mismatch
 
@@ -338,10 +329,10 @@ Before calling `apply_patch`, verify ALL of these:
 ### Escalation Strategy When Patch Fails:
 
 1. **First failure**: Read the file AGAIN. Copy context character-by-character. Pay special attention to blank lines.
-2. **Second failure**: Switch to the `edit` tool — it uses fuzzy matching (oldString/newString) and tolerates whitespace/indentation mismatches. For multiple edits, use `multiedit`.
-3. **Third failure**: Use the `write` tool to rewrite the entire file.
+2. **Second failure**: Re-read the exact target lines and simplify the patch further.
+3. **Third failure**: Use the `write` tool to rewrite the entire file only if a full-file rewrite is warranted.
 
-**For Markdown files (README.md, docs, etc.)**: Consider using `edit` as the primary tool instead of `apply_patch`. Markdown files have many blank lines and code fences that make patch context matching fragile.
+**For Markdown files (README.md, docs, etc.)**: Keep patches small and isolated. Markdown files have many blank lines and code fences that make patch context matching fragile.
 
 ## YAML Files — Extra Caution Required
 - YAML uses spaces ONLY (never tabs) — verify exact space count

package/src/prompts/src/providers/google.txt

@@ -269,6 +269,4 @@ File (10 spaces):           - os: linux
 
 **If Patch Fails:**
 - Read file AGAIN, copy context character-by-character
-- After 2 failures: switch to `edit` tool — it uses fuzzy matching (oldString/newString) and tolerates whitespace/indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- If `edit` also fails: use `write` tool to rewrite the entire file instead
+- After repeated failures: use `write` tool to rewrite the entire file only when a full rewrite is appropriate

package/src/prompts/src/providers/moonshot.txt

@@ -37,8 +37,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
 - `read`: Read file contents (supports line ranges)
 - `write`: Write complete file contents
 - `apply_patch`: Apply unified diff patches (RECOMMENDED for targeted edits)
-- `edit`: Fuzzy string replacement (oldString → newString) — use when `apply_patch` fails
-- `multiedit`: Batch multiple `edit` operations on a single file
 
 **Version Control**:
 - `git_status`, `git_diff`
@@ -167,13 +165,6 @@ You have access to a rich set of specialized tools optimized for coding tasks:
 - Lines starting with ` ` (space) are context (kept unchanged)
 - Lines starting with `@@` are optional hints/comments (not parsed as context)
 
-**Using the `edit` Tool** (Recommended Fallback When Patch Fails):
-- Parameters: `filePath`, `oldString`, `newString`, `replaceAll` (optional)
-- Uses 9 fuzzy matching strategies: trims whitespace, normalizes indentation, anchors on first/last lines
-- Much more forgiving than `apply_patch` — handles trailing commas, whitespace differences, indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- To create a new file: use empty `oldString` with `newString` as the file contents
-
 **Using the `write` Tool** (Last Resort):
 - Use for creating NEW files
 - Use when replacing >70% of a file's content (almost complete rewrite)
@@ -296,7 +287,7 @@ When a patch fails, do NOT retry the same approach. Instead:
 2. **Re-read the exact lines** you need (use startLine/endLine)
 3. **Copy context verbatim** from the fresh read output
 4. **Patch only one contiguous block** per hunk
-5. If it fails twice more, switch to `edit` tool (fuzzy matching)
+5. If it still fails repeatedly, only then consider a full-file `write` when the rewrite is justified
 
 **Pre-Flight Checklist (EVERY call):**
 Before calling `apply_patch`, verify ALL of these:
@@ -364,7 +355,7 @@ Small, surgical, one contiguous region. This pattern succeeds reliably.
 *** Begin Patch
 *** Update File: src/capture.ts
 @@ after MUTATING_TOOLS constant
- const MUTATING_TOOLS = new Set(['write', 'apply_patch', 'edit']);
+ const MUTATING_TOOLS = new Set(['write', 'apply_patch']);
  
 +const RETRYABLE_ERRORS = new Set([
 +	'ECONNREFUSED',
@@ -402,8 +393,7 @@ Two non-adjacent edits, one patch call, tabs preserved.
 - Step 1: Read file AGAIN with `read` tool (use startLine/endLine to get just the relevant section)
 - Step 2: Copy context lines VERBATIM from fresh read — do NOT retype from memory
 - Step 3: Reduce the patch to the MINIMUM change (2-3 context lines, one contiguous block)
-- After 2+ failures: switch to `edit` tool — it uses fuzzy matching and tolerates whitespace/indentation mismatches
-- If `edit` also fails: use `write` tool to rewrite the entire file instead
+- After repeated failures: use `write` tool to rewrite the entire file only when a full rewrite is warranted
 
 ## Validating Your Work
 

package/src/prompts/src/providers/openai.txt

@@ -419,9 +419,7 @@ File (10 spaces):           - os: linux
 
 **If Your Patch Fails:**
 - Read file AGAIN, copy context character-by-character
-- After 2 failures: switch to `edit` tool — it uses fuzzy matching (oldString/newString) and tolerates whitespace/indentation mismatches
-- For multiple edits to the same file, use `multiedit` with an array of `{oldString, newString}` pairs
-- If `edit` also fails: use `write` to rewrite the entire file instead
+- After repeated failures: use `write` only if a full-file rewrite is the safer option
 
 ## `update_todos`
 

package/src/core/src/tools/builtin/edit/replacers.ts

@@ -1,461 +0,0 @@
-export type Replacer = (
-	content: string,
-	find: string,
-) => Generator<string, void, unknown>;
-
-const SINGLE_CANDIDATE_SIMILARITY_THRESHOLD = 0.0;
-const MULTIPLE_CANDIDATES_SIMILARITY_THRESHOLD = 0.3;
-
-function levenshtein(a: string, b: string): number {
-	if (a === '' || b === '') {
-		return Math.max(a.length, b.length);
-	}
-	const matrix = Array.from({ length: a.length + 1 }, (_, i) =>
-		Array.from({ length: b.length + 1 }, (_, j) =>
-			i === 0 ? j : j === 0 ? i : 0,
-		),
-	);
-
-	for (let i = 1; i <= a.length; i++) {
-		for (let j = 1; j <= b.length; j++) {
-			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-			matrix[i][j] = Math.min(
-				matrix[i - 1][j] + 1,
-				matrix[i][j - 1] + 1,
-				matrix[i - 1][j - 1] + cost,
-			);
-		}
-	}
-	return matrix[a.length][b.length];
-}
-
-export const SimpleReplacer: Replacer = function* (_content, find) {
-	yield find;
-};
-
-export const LineTrimmedReplacer: Replacer = function* (content, find) {
-	const originalLines = content.split('\n');
-	const searchLines = find.split('\n');
-
-	if (searchLines[searchLines.length - 1] === '') {
-		searchLines.pop();
-	}
-
-	for (let i = 0; i <= originalLines.length - searchLines.length; i++) {
-		let matches = true;
-
-		for (let j = 0; j < searchLines.length; j++) {
-			const originalTrimmed = originalLines[i + j].trim();
-			const searchTrimmed = searchLines[j].trim();
-
-			if (originalTrimmed !== searchTrimmed) {
-				matches = false;
-				break;
-			}
-		}
-
-		if (matches) {
-			let matchStartIndex = 0;
-			for (let k = 0; k < i; k++) {
-				matchStartIndex += originalLines[k].length + 1;
-			}
-
-			let matchEndIndex = matchStartIndex;
-			for (let k = 0; k < searchLines.length; k++) {
-				matchEndIndex += originalLines[i + k].length;
-				if (k < searchLines.length - 1) {
-					matchEndIndex += 1;
-				}
-			}
-
-			yield content.substring(matchStartIndex, matchEndIndex);
-		}
-	}
-};
-
-export const BlockAnchorReplacer: Replacer = function* (content, find) {
-	const originalLines = content.split('\n');
-	const searchLines = find.split('\n');
-
-	if (searchLines.length < 3) {
-		return;
-	}
-
-	if (searchLines[searchLines.length - 1] === '') {
-		searchLines.pop();
-	}
-
-	const firstLineSearch = searchLines[0].trim();
-	const lastLineSearch = searchLines[searchLines.length - 1].trim();
-
-	const candidates: Array<{ startLine: number; endLine: number }> = [];
-	for (let i = 0; i < originalLines.length; i++) {
-		if (originalLines[i].trim() !== firstLineSearch) {
-			continue;
-		}
-
-		for (let j = i + 2; j < originalLines.length; j++) {
-			if (originalLines[j].trim() === lastLineSearch) {
-				candidates.push({ startLine: i, endLine: j });
-				break;
-			}
-		}
-	}
-
-	if (candidates.length === 0) {
-		return;
-	}
-
-	if (candidates.length === 1) {
-		const { startLine, endLine } = candidates[0];
-		const actualBlockSize = endLine - startLine + 1;
-		const searchBlockSize = searchLines.length;
-
-		let similarity = 0;
-		const linesToCheck = Math.min(searchBlockSize - 2, actualBlockSize - 2);
-
-		if (linesToCheck > 0) {
-			for (let j = 1; j < searchBlockSize - 1 && j < actualBlockSize - 1; j++) {
-				const originalLine = originalLines[startLine + j].trim();
-				const searchLine = searchLines[j].trim();
-				const maxLen = Math.max(originalLine.length, searchLine.length);
-				if (maxLen === 0) {
-					continue;
-				}
-				const distance = levenshtein(originalLine, searchLine);
-				similarity += (1 - distance / maxLen) / linesToCheck;
-
-				if (similarity >= SINGLE_CANDIDATE_SIMILARITY_THRESHOLD) {
-					break;
-				}
-			}
-		} else {
-			similarity = 1.0;
-		}
-
-		if (similarity >= SINGLE_CANDIDATE_SIMILARITY_THRESHOLD) {
-			let matchStartIndex = 0;
-			for (let k = 0; k < startLine; k++) {
-				matchStartIndex += originalLines[k].length + 1;
-			}
-			let matchEndIndex = matchStartIndex;
-			for (let k = startLine; k <= endLine; k++) {
-				matchEndIndex += originalLines[k].length;
-				if (k < endLine) {
-					matchEndIndex += 1;
-				}
-			}
-			yield content.substring(matchStartIndex, matchEndIndex);
-		}
-		return;
-	}
-
-	let bestMatch: { startLine: number; endLine: number } | null = null;
-	let maxSimilarity = -1;
-
-	for (const candidate of candidates) {
-		const { startLine, endLine } = candidate;
-		const actualBlockSize = endLine - startLine + 1;
-		const searchBlockSize = searchLines.length;
-
-		let similarity = 0;
-		const linesToCheck = Math.min(searchBlockSize - 2, actualBlockSize - 2);
-
-		if (linesToCheck > 0) {
-			for (let j = 1; j < searchBlockSize - 1 && j < actualBlockSize - 1; j++) {
-				const originalLine = originalLines[startLine + j].trim();
-				const searchLine = searchLines[j].trim();
-				const maxLen = Math.max(originalLine.length, searchLine.length);
-				if (maxLen === 0) {
-					continue;
-				}
-				const distance = levenshtein(originalLine, searchLine);
-				similarity += 1 - distance / maxLen;
-			}
-			similarity /= linesToCheck;
-		} else {
-			similarity = 1.0;
-		}
-
-		if (similarity > maxSimilarity) {
-			maxSimilarity = similarity;
-			bestMatch = candidate;
-		}
-	}
-
-	if (maxSimilarity >= MULTIPLE_CANDIDATES_SIMILARITY_THRESHOLD && bestMatch) {
-		const { startLine, endLine } = bestMatch;
-		let matchStartIndex = 0;
-		for (let k = 0; k < startLine; k++) {
-			matchStartIndex += originalLines[k].length + 1;
-		}
-		let matchEndIndex = matchStartIndex;
-		for (let k = startLine; k <= endLine; k++) {
-			matchEndIndex += originalLines[k].length;
-			if (k < endLine) {
-				matchEndIndex += 1;
-			}
-		}
-		yield content.substring(matchStartIndex, matchEndIndex);
-	}
-};
-
-export const WhitespaceNormalizedReplacer: Replacer = function* (
-	content,
-	find,
-) {
-	const normalizeWhitespace = (text: string) =>
-		text.replace(/\s+/g, ' ').trim();
-	const normalizedFind = normalizeWhitespace(find);
-
-	const lines = content.split('\n');
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i];
-		if (normalizeWhitespace(line) === normalizedFind) {
-			yield line;
-		} else {
-			const normalizedLine = normalizeWhitespace(line);
-			if (normalizedLine.includes(normalizedFind)) {
-				const words = find.trim().split(/\s+/);
-				if (words.length > 0) {
-					const pattern = words
-						.map((word) => word.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
-						.join('\\s+');
-					try {
-						const regex = new RegExp(pattern);
-						const match = line.match(regex);
-						if (match) {
-							yield match[0];
-						}
-					} catch {
-						// skip invalid regex
-					}
-				}
-			}
-		}
-	}
-
-	const findLines = find.split('\n');
-	if (findLines.length > 1) {
-		for (let i = 0; i <= lines.length - findLines.length; i++) {
-			const block = lines.slice(i, i + findLines.length);
-			if (normalizeWhitespace(block.join('\n')) === normalizedFind) {
-				yield block.join('\n');
-			}
-		}
-	}
-};
-
-export const IndentationFlexibleReplacer: Replacer = function* (content, find) {
-	const removeIndentation = (text: string) => {
-		const lines = text.split('\n');
-		const nonEmptyLines = lines.filter((line) => line.trim().length > 0);
-		if (nonEmptyLines.length === 0) return text;
-
-		const minIndent = Math.min(
-			...nonEmptyLines.map((line) => {
-				const match = line.match(/^(\s*)/);
-				return match ? match[1].length : 0;
-			}),
-		);
-
-		return lines
-			.map((line) => (line.trim().length === 0 ? line : line.slice(minIndent)))
-			.join('\n');
-	};
-
-	const normalizedFind = removeIndentation(find);
-	const contentLines = content.split('\n');
-	const findLines = find.split('\n');
-
-	for (let i = 0; i <= contentLines.length - findLines.length; i++) {
-		const block = contentLines.slice(i, i + findLines.length).join('\n');
-		if (removeIndentation(block) === normalizedFind) {
-			yield block;
-		}
-	}
-};
-
-export const EscapeNormalizedReplacer: Replacer = function* (content, find) {
-	const unescapeString = (str: string): string => {
-		return str.replace(/\\(n|t|r|'|"|`|\\|\n|\$)/g, (match, capturedChar) => {
-			switch (capturedChar) {
-				case 'n':
-					return '\n';
-				case 't':
-					return '\t';
-				case 'r':
-					return '\r';
-				case "'":
-					return "'";
-				case '"':
-					return '"';
-				case '`':
-					return '`';
-				case '\\':
-					return '\\';
-				case '\n':
-					return '\n';
-				case '$':
-					return '$';
-				default:
-					return match;
-			}
-		});
-	};
-
-	const unescapedFind = unescapeString(find);
-
-	if (content.includes(unescapedFind)) {
-		yield unescapedFind;
-	}
-
-	const lines = content.split('\n');
-	const findLines = unescapedFind.split('\n');
-
-	for (let i = 0; i <= lines.length - findLines.length; i++) {
-		const block = lines.slice(i, i + findLines.length).join('\n');
-		const unescapedBlock = unescapeString(block);
-
-		if (unescapedBlock === unescapedFind) {
-			yield block;
-		}
-	}
-};
-
-export const TrimmedBoundaryReplacer: Replacer = function* (content, find) {
-	const trimmedFind = find.trim();
-
-	if (trimmedFind === find) {
-		return;
-	}
-
-	if (content.includes(trimmedFind)) {
-		yield trimmedFind;
-	}
-
-	const lines = content.split('\n');
-	const findLines = find.split('\n');
-
-	for (let i = 0; i <= lines.length - findLines.length; i++) {
-		const block = lines.slice(i, i + findLines.length).join('\n');
-
-		if (block.trim() === trimmedFind) {
-			yield block;
-		}
-	}
-};
-
-export const ContextAwareReplacer: Replacer = function* (content, find) {
-	const findLines = find.split('\n');
-	if (findLines.length < 3) {
-		return;
-	}
-
-	if (findLines[findLines.length - 1] === '') {
-		findLines.pop();
-	}
-
-	const contentLines = content.split('\n');
-
-	const firstLine = findLines[0].trim();
-	const lastLine = findLines[findLines.length - 1].trim();
-
-	for (let i = 0; i < contentLines.length; i++) {
-		if (contentLines[i].trim() !== firstLine) continue;
-
-		for (let j = i + 2; j < contentLines.length; j++) {
-			if (contentLines[j].trim() === lastLine) {
-				const blockLines = contentLines.slice(i, j + 1);
-
-				if (blockLines.length === findLines.length) {
-					let matchingLines = 0;
-					let totalNonEmptyLines = 0;
-
-					for (let k = 1; k < blockLines.length - 1; k++) {
-						const blockLine = blockLines[k].trim();
-						const findLine = findLines[k].trim();
-
-						if (blockLine.length > 0 || findLine.length > 0) {
-							totalNonEmptyLines++;
-							if (blockLine === findLine) {
-								matchingLines++;
-							}
-						}
-					}
-
-					if (
-						totalNonEmptyLines === 0 ||
-						matchingLines / totalNonEmptyLines >= 0.5
-					) {
-						yield blockLines.join('\n');
-						break;
-					}
-				}
-				break;
-			}
-		}
-	}
-};
-
-export const MultiOccurrenceReplacer: Replacer = function* (content, find) {
-	let startIndex = 0;
-
-	while (true) {
-		const index = content.indexOf(find, startIndex);
-		if (index === -1) break;
-
-		yield find;
-		startIndex = index + find.length;
-	}
-};
-
-export const ALL_REPLACERS: Replacer[] = [
-	SimpleReplacer,
-	LineTrimmedReplacer,
-	BlockAnchorReplacer,
-	WhitespaceNormalizedReplacer,
-	IndentationFlexibleReplacer,
-	EscapeNormalizedReplacer,
-	TrimmedBoundaryReplacer,
-	ContextAwareReplacer,
-	MultiOccurrenceReplacer,
-];
-
-export function replace(
-	content: string,
-	oldString: string,
-	newString: string,
-	replaceAll = false,
-): string {
-	if (oldString === newString) {
-		throw new Error('oldString and newString must be different');
-	}
-
-	let notFound = true;
-
-	for (const replacer of ALL_REPLACERS) {
-		for (const search of replacer(content, oldString)) {
-			const index = content.indexOf(search);
-			if (index === -1) continue;
-			notFound = false;
-			if (replaceAll) {
-				return content.replaceAll(search, newString);
-			}
-			const lastIndex = content.lastIndexOf(search);
-			if (index !== lastIndex) continue;
-			return (
-				content.substring(0, index) +
-				newString +
-				content.substring(index + search.length)
-			);
-		}
-	}
-
-	if (notFound) {
-		throw new Error('oldString not found in content');
-	}
-	throw new Error(
-		'Found multiple matches for oldString. Provide more surrounding lines in oldString to identify the correct match.',
-	);
-}

package/src/core/src/tools/builtin/edit.ts

@@ -1,166 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod/v3';
-import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative } from 'node:path';
-import DESCRIPTION from './edit.txt' with { type: 'text' };
-import { createToolError, type ToolResponse } from '../error.ts';
-import { replace } from './edit/replacers.ts';
-import { buildWriteArtifact } from './fs/util.ts';
-
-export function buildEditTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const editTool = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			filePath: z
-				.string()
-				.describe(
-					'The path to the file to modify (relative to project root or absolute)',
-				),
-			oldString: z.string().describe('The text to replace'),
-			newString: z
-				.string()
-				.describe(
-					'The text to replace it with (must be different from oldString)',
-				),
-			replaceAll: z
-				.boolean()
-				.optional()
-				.default(false)
-				.describe('Replace all occurrences of oldString (default false)'),
-		}),
-		async execute({
-			filePath,
-			oldString,
-			newString,
-			replaceAll: replaceAllFlag = false,
-		}: {
-			filePath: string;
-			oldString: string;
-			newString: string;
-			replaceAll?: boolean;
-		}): Promise<
-			ToolResponse<{
-				output: string;
-				filePath: string;
-				artifact: unknown;
-			}>
-		> {
-			if (!filePath || filePath.trim().length === 0) {
-				return createToolError(
-					'Missing required parameter: filePath',
-					'validation',
-					{
-						parameter: 'filePath',
-						value: filePath,
-						suggestion: 'Provide a file path to edit',
-					},
-				);
-			}
-
-			if (oldString === newString) {
-				return createToolError(
-					'oldString and newString must be different',
-					'validation',
-					{
-						parameter: 'oldString',
-						suggestion: 'Provide different values for oldString and newString',
-					},
-				);
-			}
-
-			const absPath = isAbsolute(filePath)
-				? filePath
-				: join(projectRoot, filePath);
-			const relPath = relative(projectRoot, absPath);
-
-			try {
-				if (oldString === '') {
-					await mkdir(dirname(absPath), { recursive: true });
-					await writeFile(absPath, newString, 'utf-8');
-					const artifact = await buildWriteArtifact(
-						relPath,
-						false,
-						'',
-						newString,
-					);
-					return {
-						ok: true,
-						output: 'File created successfully.',
-						filePath: relPath,
-						artifact,
-					};
-				}
-
-				const fileStat = await stat(absPath).catch(() => null);
-				if (!fileStat) {
-					return createToolError(`File ${relPath} not found`, 'not_found', {
-						parameter: 'filePath',
-						value: relPath,
-						suggestion: 'Check the file path exists',
-					});
-				}
-				if (fileStat.isDirectory()) {
-					return createToolError(
-						`Path is a directory, not a file: ${relPath}`,
-						'validation',
-						{
-							parameter: 'filePath',
-							value: relPath,
-							suggestion: 'Provide a path to a file, not a directory',
-						},
-					);
-				}
-
-				const contentOld = await readFile(absPath, 'utf-8');
-				let contentNew: string;
-
-				try {
-					contentNew = replace(
-						contentOld,
-						oldString,
-						newString,
-						replaceAllFlag,
-					);
-				} catch (error) {
-					const message =
-						error instanceof Error ? error.message : String(error);
-					return createToolError(message, 'execution', {
-						suggestion: message.includes('multiple matches')
-							? 'Provide more surrounding context in oldString to uniquely identify the match, or use replaceAll: true'
-							: 'Verify the oldString matches the file content exactly',
-					});
-				}
-
-				await writeFile(absPath, contentNew, 'utf-8');
-
-				const artifact = await buildWriteArtifact(
-					relPath,
-					true,
-					contentOld,
-					contentNew,
-				);
-
-				return {
-					ok: true,
-					output: 'Edit applied successfully.',
-					filePath: relPath,
-					artifact,
-				};
-			} catch (error: unknown) {
-				return createToolError(
-					`Failed to edit file: ${error instanceof Error ? error.message : String(error)}`,
-					'execution',
-					{
-						parameter: 'filePath',
-						value: relPath,
-					},
-				);
-			}
-		},
-	});
-
-	return { name: 'edit', tool: editTool };
-}

package/src/core/src/tools/builtin/edit.txt

@@ -1,10 +0,0 @@
-Performs exact string replacements in files.
-
-Usage:
-- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file.
-- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears in the file.
-- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
-- The edit will FAIL if `oldString` is not found in the file with an error "oldString not found in content".
-- The edit will FAIL if `oldString` is found multiple times in the file with an error about multiple matches. Either provide a larger string with more surrounding context to make it unique or use `replaceAll` to change every instance.
-- Use `replaceAll` for replacing and renaming strings across the file. This parameter is useful for renaming a variable.
-- To create a new file, use an empty `oldString` and set `newString` to the file contents.

package/src/core/src/tools/builtin/multiedit.ts

@@ -1,190 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod/v3';
-import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative } from 'node:path';
-import DESCRIPTION from './multiedit.txt' with { type: 'text' };
-import { createToolError, type ToolResponse } from '../error.ts';
-import { replace } from './edit/replacers.ts';
-import { buildWriteArtifact } from './fs/util.ts';
-
-export function buildMultiEditTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const multiEditTool = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			filePath: z
-				.string()
-				.describe(
-					'The path to the file to modify (relative to project root or absolute)',
-				),
-			edits: z
-				.array(
-					z.object({
-						oldString: z.string().describe('The text to replace'),
-						newString: z.string().describe('The text to replace it with'),
-						replaceAll: z
-							.boolean()
-							.optional()
-							.default(false)
-							.describe('Replace all occurrences of oldString (default false)'),
-					}),
-				)
-				.describe(
-					'Array of edit operations to perform sequentially on the file',
-				),
-		}),
-		async execute({
-			filePath,
-			edits,
-		}: {
-			filePath: string;
-			edits: Array<{
-				oldString: string;
-				newString: string;
-				replaceAll?: boolean;
-			}>;
-		}): Promise<
-			ToolResponse<{
-				output: string;
-				filePath: string;
-				editsApplied: number;
-				artifact: unknown;
-			}>
-		> {
-			if (!filePath || filePath.trim().length === 0) {
-				return createToolError(
-					'Missing required parameter: filePath',
-					'validation',
-					{
-						parameter: 'filePath',
-						value: filePath,
-						suggestion: 'Provide a file path to edit',
-					},
-				);
-			}
-
-			if (!edits || edits.length === 0) {
-				return createToolError(
-					'Missing required parameter: edits',
-					'validation',
-					{
-						parameter: 'edits',
-						suggestion: 'Provide at least one edit operation',
-					},
-				);
-			}
-
-			const absPath = isAbsolute(filePath)
-				? filePath
-				: join(projectRoot, filePath);
-			const relPath = relative(projectRoot, absPath);
-
-			try {
-				let contentOld: string;
-				let isNew = false;
-
-				if (edits[0].oldString === '') {
-					await mkdir(dirname(absPath), { recursive: true });
-					contentOld = '';
-					isNew = true;
-				} else {
-					const fileStat = await stat(absPath).catch(() => null);
-					if (!fileStat) {
-						return createToolError(`File ${relPath} not found`, 'not_found', {
-							parameter: 'filePath',
-							value: relPath,
-							suggestion: 'Check the file path exists',
-						});
-					}
-					if (fileStat.isDirectory()) {
-						return createToolError(
-							`Path is a directory, not a file: ${relPath}`,
-							'validation',
-							{
-								parameter: 'filePath',
-								value: relPath,
-								suggestion: 'Provide a path to a file, not a directory',
-							},
-						);
-					}
-					contentOld = await readFile(absPath, 'utf-8');
-				}
-
-				const originalContent = contentOld;
-				let current = contentOld;
-
-				for (let i = 0; i < edits.length; i++) {
-					const edit = edits[i];
-
-					if (edit.oldString === '' && i === 0 && isNew) {
-						current = edit.newString;
-						continue;
-					}
-
-					if (edit.oldString === edit.newString) {
-						return createToolError(
-							`Edit ${i + 1}: oldString and newString must be different`,
-							'validation',
-							{
-								parameter: `edits[${i}]`,
-								suggestion:
-									'Provide different values for oldString and newString',
-							},
-						);
-					}
-
-					try {
-						current = replace(
-							current,
-							edit.oldString,
-							edit.newString,
-							edit.replaceAll ?? false,
-						);
-					} catch (error) {
-						const message =
-							error instanceof Error ? error.message : String(error);
-						return createToolError(
-							`Edit ${i + 1} failed: ${message}`,
-							'execution',
-							{
-								parameter: `edits[${i}]`,
-								suggestion:
-									'Check that earlier edits did not change the text this edit targets',
-							},
-						);
-					}
-				}
-
-				await writeFile(absPath, current, 'utf-8');
-
-				const artifact = await buildWriteArtifact(
-					relPath,
-					!isNew,
-					originalContent,
-					current,
-				);
-
-				return {
-					ok: true,
-					output: `Applied ${edits.length} edit${edits.length === 1 ? '' : 's'} successfully.`,
-					filePath: relPath,
-					editsApplied: edits.length,
-					artifact,
-				};
-			} catch (error: unknown) {
-				return createToolError(
-					`Failed to edit file: ${error instanceof Error ? error.message : String(error)}`,
-					'execution',
-					{
-						parameter: 'filePath',
-						value: relPath,
-					},
-				);
-			}
-		},
-	});
-
-	return { name: 'multiedit', tool: multiEditTool };
-}

package/src/core/src/tools/builtin/multiedit.txt

@@ -1,15 +0,0 @@
-Makes multiple edits to a single file in one operation. Built on top of the Edit tool.
-
-Prefer this tool over Edit when you need to make multiple changes to the same file.
-
-Parameters:
-1. filePath: The path to the file to modify (relative or absolute)
-2. edits: An array of edit operations, each with:
-   - oldString: The text to replace (must match file contents)
-   - newString: The replacement text
-   - replaceAll: Optional, replace all occurrences (default false)
-
-IMPORTANT:
-- Edits are applied in sequence, each operating on the result of the previous
-- All edits must succeed or none are applied
-- Plan edits carefully to avoid conflicts between sequential operations