Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of available tools.

Implementations

impl ToolRegistry

pub fn new() -> Self

pub fn register(&mut self, tool: Arc<dyn Tool>)

Register a native Rust tool.

pub fn register_alias( &mut self, alias: impl Into<String>, canonical: impl Into<String>, )

Register a compatibility alias for an existing canonical tool name.

Aliases resolve at execution time but are intentionally omitted from tool definitions so models see the canonical surface only.

pub fn get(&self, name: &str) -> Option<&Arc<dyn Tool>>

Get a tool by canonical name or compatibility alias.

pub fn tools_map(&self) -> HashMap<String, Arc<dyn Tool>>

Get a cloned map of all tools, including compatibility aliases.

pub fn definitions(&self) -> Vec<ToolDefinition>

Get all canonical tool definitions (for LLM context). Compatibility aliases such as legacy multi_edit are intentionally hidden so models learn one canonical edit surface.

pub fn readonly_definitions(&self) -> Vec<ToolDefinition>

Get only readonly tool definitions (for readonly roles).

pub fn names(&self) -> Vec<String>

List all tool names.

pub fn retain<F>(&mut self, predicate: F)

where F: Fn(&str) -> bool,

Retain only tools whose names satisfy the predicate.

Used by AgentBuilder to filter tools based on agent mode before the agent is handed out to callers.

pub fn definitions_for_mode(&self, mode: &AgentMode) -> Vec<ToolDefinition>

Get tool definitions filtered to those allowed by an agent mode.

For Full mode (empty allow-list), returns all definitions. For all other modes, returns only the intersection.

pub fn len(&self) -> usize

Number of registered tools.

pub fn is_empty(&self) -> bool

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.