feat: add search_and_replace tool for batch text replacements

Adds a new native tool that allows multiple search/replace operations
in a single file edit, reducing round-trips for common editing patterns.

- Add search_and_replace to tool types and tool groups
- Implement SearchAndReplaceTool with streaming support
- Add native tool schema and parser support
- Support partial matching and error recovery for individual operations

Author: hannesrudolph

packages/types/src/tool.ts

@@ -20,6 +20,7 @@ export const toolNames = [
 	"write_to_file",
 	"apply_diff",
 	"insert_content",
+	"search_and_replace",
 	"search_files",
 	"list_files",
 	"list_code_definition_names",

src/core/assistant-message/NativeToolCallParser.ts

@@ -119,6 +119,15 @@ export class NativeToolCallParser {
 					}
 					break
 
+				case "search_and_replace":
+					if (args.path !== undefined && args.operations !== undefined && Array.isArray(args.operations)) {
+						nativeArgs = {
+							path: args.path,
+							operations: args.operations,
+						} as NativeArgsFor<TName>
+					}
+					break
+
 				case "ask_followup_question":
 					if (args.question !== undefined && args.follow_up !== undefined) {
 						nativeArgs = {

src/core/assistant-message/presentAssistantMessage.ts

@@ -17,6 +17,7 @@ import { shouldUseSingleFileRead, TOOL_PROTOCOL } from "@roo-code/types"
 import { writeToFileTool } from "../tools/WriteToFileTool"
 import { applyDiffTool } from "../tools/MultiApplyDiffTool"
 import { insertContentTool } from "../tools/InsertContentTool"
+import { searchAndReplaceTool } from "../tools/SearchAndReplaceTool"
 import { listCodeDefinitionNamesTool } from "../tools/ListCodeDefinitionNamesTool"
 import { searchFilesTool } from "../tools/SearchFilesTool"
 import { browserActionTool } from "../tools/BrowserActionTool"
@@ -215,6 +216,8 @@ export async function presentAssistantMessage(cline: Task) {
 						}]`
 					case "insert_content":
 						return `[${block.name} for '${block.params.path}']`
+					case "search_and_replace":
+						return `[${block.name} for '${block.params.path}']`
 					case "list_files":
 						return `[${block.name} for '${block.params.path}']`
 					case "list_code_definition_names":
@@ -624,6 +627,16 @@ export async function presentAssistantMessage(cline: Task) {
 						toolProtocol,
 					})
 					break
+				case "search_and_replace":
+					await checkpointSaveAndMark(cline)
+					await searchAndReplaceTool.handle(cline, block as ToolUse<"search_and_replace">, {
+						askApproval,
+						handleError,
+						pushToolResult,
+						removeClosingTag,
+						toolProtocol,
+					})
+					break
 				case "read_file":
 					// Check if this model should use the simplified single-file read tool
 					if (shouldUseSingleFileRead(cachedModelId)) {

src/core/prompts/tools/native-tools/index.ts

@@ -12,6 +12,7 @@ import listFiles from "./list_files"
 import newTask from "./new_task"
 import { createReadFileTool } from "./read_file"
 import runSlashCommand from "./run_slash_command"
+import searchAndReplace from "./search_and_replace"
 import searchFiles from "./search_files"
 import switchMode from "./switch_mode"
 import updateTodoList from "./update_todo_list"
@@ -43,6 +44,7 @@ export function getNativeTools(partialReadsEnabled: boolean = true): OpenAI.Chat
 		newTask,
 		createReadFileTool(partialReadsEnabled),
 		runSlashCommand,
+		searchAndReplace,
 		searchFiles,
 		switchMode,
 		updateTodoList,

src/core/prompts/tools/native-tools/search_and_replace.ts

@@ -0,0 +1,44 @@
+import type OpenAI from "openai"
+
+const SEARCH_AND_REPLACE_DESCRIPTION = `Perform one or more text replacements in a file. This tool finds and replaces exact text matches. Use this for straightforward replacements where you know the exact text to find and replace. You can perform multiple replacements in a single call by providing an array of operations. For complex multi-line changes or when you need line number precision, use apply_diff instead.`
+
+const search_and_replace = {
+	type: "function",
+	function: {
+		name: "search_and_replace",
+		description: SEARCH_AND_REPLACE_DESCRIPTION,
+		parameters: {
+			type: "object",
+			properties: {
+				path: {
+					type: "string",
+					description: "The path of the file to modify, relative to the current workspace directory.",
+				},
+				operations: {
+					type: "array",
+					description: "Array of search and replace operations to perform on the file.",
+					items: {
+						type: "object",
+						properties: {
+							search: {
+								type: "string",
+								description:
+									"The exact text to find in the file. Must match exactly, including whitespace.",
+							},
+							replace: {
+								type: "string",
+								description: "The text to replace the search text with.",
+							},
+						},
+						required: ["search", "replace"],
+					},
+					minItems: 1,
+				},
+			},
+			required: ["path", "operations"],
+			additionalProperties: false,
+		},
+	},
+} satisfies OpenAI.Chat.ChatCompletionTool
+
+export default search_and_replace