Struct WriteTool 

pub struct WriteTool { /* private fields */ }

Agent tool that writes UTF-8 file contents under the mutation queue.

Implementations

impl WriteTool

pub fn new(cwd: impl Into<PathBuf>) -> Self

Creates a write tool rooted at cwd.

pub fn with_options(options: WriteToolOptions) -> Self

Creates a write tool from explicit options.

pub fn parameters_schema() -> Value

Returns the JSON Schema for write arguments (normalized TypeBox shape).

pub fn parse_input( args: &Map<String, Value>, ) -> Result<WriteToolInput, ToolError>

Validates raw tool arguments into WriteToolInput.

Errors

Returns ToolError when required fields are missing or mistyped.

pub fn utf16_length(content: &str) -> usize

JS String.prototype.length (UTF-16 code units).

pub fn success_text(path: &str, content: &str) -> String

Formats the success text using the caller’s path string and JS length.

Trait Implementations

impl AgentTool for WriteTool

fn name(&self) -> &'static str

Unique tool name.

fn label(&self) -> &'static str

Human-readable label for UI display.

fn description(&self) -> &str

Human-readable tool description.

fn parameters(&self) -> &Value

JSON Schema for tool arguments.

fn validate_arguments( &self, args: &Map<String, Value>, ) -> Result<Map<String, Value>, ToolError>

Validates prepared arguments for this tool.

fn execute( &self, _tool_call_id: &str, args: Map<String, Value>, cancel: CancellationToken, _updates: ToolUpdates, ) -> BoxFuture<'static, Result<AgentToolResult, ToolError>>

Executes the tool call.

fn execution_mode(&self) -> Option<ToolExecutionMode>

Optional per-tool execution mode override.

fn prepare_arguments( &self, raw: &Map<String, Value>, ) -> Result<Map<String, Value>, ToolError>

Optional compatibility shim for raw tool-call arguments before validation.

fn prepare_and_validate_arguments( &self, raw: Map<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<Map<String, Value>, ToolError>> + Send + '_>>

Prepares and validates raw arguments before lifecycle hooks and execution.

impl Clone for WriteTool

fn clone(&self) -> WriteTool

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WriteTool

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

Formats the value using the given formatter.