Struct ToolUseBlock 

pub struct ToolUseBlock {
    pub id: String,
    pub name: String,
    pub input: Value,
}

Tool use invocation block

Represents Claude invoking a tool (Read, Write, Edit, Bash, etc.)

Example

{
  "type": "tool_use",
  "id": "toolu_abc123",
  "name": "Read",
  "input": {
    "file_path": "/path/to/file.rs"
  }
}

Links

• id links to ToolResultBlock.tool_use_id in user messages
• id links to ProgressEvent.tool_use_id for progress updates

Common Tool Names

• Read - Read file contents
• Write - Write new file
• Edit - Edit existing file
• Bash - Execute bash command
• Glob - Search for files by pattern
• Grep - Search file contents
• TodoWrite - Update todo list
• Agent - Spawn sub-agent

Fields

id: String

Unique tool use ID

Links to tool result in user message Format: "toolu_{random}" or "{tool_name}-{uuid}"

name: String

Tool name

Common tools: Read, Write, Edit, Bash, Glob, Grep, Agent

input: Value

Tool input parameters (JSON object)

Structure depends on tool type:

• Read: {"file_path": "/path"}
• Write: {"file_path": "/path", "content": "..."}
• Edit: {"file_path": "/path", "old_string": "...", "new_string": "..."}
• Bash: {"command": "cargo build", "description": "..."}

Trait Implementations

impl Clone for ToolUseBlock

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolUseBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolUseBlock

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolUseBlock

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.