Struct Tool 

pub struct Tool {
    pub name: String,
    pub description: String,
    pub input_schema: ToolInputSchema,
    pub requires_approval: bool,
    pub defer_loading: bool,
    pub allowed_callers: Vec<ToolCaller>,
    pub input_examples: Vec<Value>,
    pub serialize: bool,
}

A tool that can be used by the AI agent

Fields

name: String

Name of the tool

description: String

Description of what the tool does

input_schema: ToolInputSchema

Input schema (JSON Schema)

requires_approval: bool

Whether this tool requires user approval before execution

defer_loading: bool

Whether this tool should be deferred from initial context loading.

allowed_callers: Vec<ToolCaller>

Specifies which contexts can call this tool.

input_examples: Vec<Value>

Example inputs that teach the AI proper parameter usage.

serialize: bool

When true, the agent loop MUST execute this tool sequentially — never concurrently with other tools in the same round.

Use for tools that mutate shared state (file writes, git operations, registry updates) where concurrent execution could corrupt data or interleave side effects. Read-only tools (read_file, search, web_fetch) should leave this false.

Trait Implementations

impl Clone for Tool

fn clone(&self) -> Tool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tool

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

Formats the value using the given formatter.

impl Default for Tool

fn default() -> Tool

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Tool

fn deserialize<__D>( __deserializer: __D, ) -> Result<Tool, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Tool

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

where __S: Serializer,

Serialize this value into the given Serde serializer.