Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of available tools. Maintains a name→tool map and a cached JSON schema array that gets sent to the API. Thread-safe via Arc<RwLock<ToolRegistry>>.

Implementations

impl ToolRegistry

pub fn new() -> Self

pub fn empty() -> Self

Empty registry for tests and narrow embedded runtimes that want to opt in to specific tools explicitly.

pub fn without_subagent() -> Self

Registry without subagent tool — used for subagent runtimes to prevent recursion.

pub fn without_subagent_with_extensions(extension_tools: &ToolRegistry) -> Self

Built-in subagent registry plus extension tools merged in from a shared registry. Used by subagents that need to invoke extension-provided tools while still excluding the recursive subagent_* tools.

Only tools whose Tool::extension_id() returns Some(_) are merged; built-ins inside extension_tools are ignored to avoid duplicating or shadowing the canonical built-in instances.

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

Register an additional tool at runtime (e.g. MCP tools, custom tools). If a tool with the same name exists, it is replaced.

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

pub fn runtime_name_for_api<'a>(&'a self, name: &'a str) -> &'a str

pub fn translate_input_for_api_tool( &self, tool_name: &str, input: Value, ) -> Value

pub fn tools_schema(&self) -> Arc<Vec<Value>>

pub fn tool_names_for_extension(&self, extension_id: &str) -> Vec<String>

Return runtime names of tools owned by the given extension id, sorted ascending. Built-in tools (which return None from Tool::extension_id) are excluded.

Trait Implementations

impl Clone for ToolRegistry

fn clone(&self) -> ToolRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.