Struct EditTool 

pub struct EditTool { /* private fields */ }

Edit Tool for modifying files

Supports:

• Smart string matching with quote normalization
• Batch edits with atomic rollback
• External modification detection
• Match uniqueness validation

Requirements: 4.7, 4.8, 4.9, 4.10

Implementations

impl EditTool

pub fn new(read_history: SharedFileReadHistory) -> Self

Create a new EditTool with shared history

pub fn with_require_read_before_edit(self, require: bool) -> Self

Set whether to require read before edit

pub fn with_smart_quote_matching(self, enabled: bool) -> Self

Set whether to enable smart quote matching

pub fn read_history(&self) -> &SharedFileReadHistory

Get the shared read history

impl EditTool

pub fn normalize_quotes(s: &str) -> String

Normalize quotes in a string for matching

Converts various quote styles to standard ASCII quotes:

• Smart quotes (“ “ ’ ’) -> ASCII quotes (“ ’)
• Curly quotes -> straight quotes

Requirements: 4.7

pub fn find_matches(&self, content: &str, search: &str) -> MatchResult

Find all matches of a string in content

If smart_quote_matching is enabled, normalizes quotes before matching.

Requirements: 4.7

pub fn is_unique_match(&self, content: &str, search: &str) -> bool

Check if a match is unique (exactly one occurrence)

impl EditTool

pub async fn edit_file( &self, path: &Path, old_str: &str, new_str: &str, context: &ToolContext, ) -> Result<ToolResult, ToolError>

Apply a single edit to a file

Requirements: 4.7, 4.9, 4.10

impl EditTool

pub async fn batch_edit( &self, path: &Path, edits: &[Edit], context: &ToolContext, ) -> Result<ToolResult, ToolError>

Apply multiple edits to a file atomically

All edits are validated before any are applied. If any edit fails validation, no changes are made.

Requirements: 4.8

Trait Implementations

impl Debug for EditTool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Tool for EditTool

fn name(&self) -> &str

Returns the unique name of the tool

fn description(&self) -> &str

Returns a human-readable description of the tool

fn input_schema(&self) -> Value

Returns the JSON Schema for the tool’s input parameters

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, params: Value, context: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, ToolError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute the tool with the given parameters and context

fn check_permissions<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, params: &'life1 Value, context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = PermissionCheckResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Check permissions before executing the tool

fn options(&self) -> ToolOptions

Get the tool’s configuration options

fn dynamic_description(&self) -> Option<String>

Returns a dynamically generated description of the tool

fn get_definition(&self) -> ToolDefinition

Get the tool definition for LLM consumption