Struct Tools 

pub struct Tools { /* private fields */ }

Tool registry for managing and calling tools by name.

Example

use aither::llm::tool::Tools;

let mut tools = Tools::new();
// tools.register(Calculator);
let definitions = tools.definitions();
// let result = tools
//     .call("calculator", r#"{"operation": "add", "a": 5, "b": 3}"#, ToolContext::new())
//     .await;

Implementations

impl Tools

pub const fn new() -> Self

Creates a new empty tools registry.

pub fn get<T>(&self) -> Option<&T>

where T: Tool + 'static,

Retrieves a tool by type.

Returns None if the tool is not found.

pub fn get_mut<T>(&mut self) -> Option<&mut T>

where T: Tool + 'static,

Retrieves a mutable reference to a tool by type.

Returns None if the tool is not found.

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

Returns definitions of all registered tools.

pub fn register<T: Tool + 'static>( &mut self, tool: T, ) -> Result<(), RegisterError>

Registers a new tool.

The tool must implement Tool and be 'static.

Errors

Returns RegisterError::DuplicateName if a tool of that name is already registered, or RegisterError::EmptyDescription if the tool has no description — a model cannot use a tool it cannot read about, so this is rejected rather than silently passed on.

pub fn register_dyn<F>( &mut self, definition: ToolDefinition, handler: F, ) -> Result<(), RegisterError>

where F: Fn(&str, ToolContext) -> Pin<Box<dyn Future<Output = Result<ToolResult>> + Send>> + Send + Sync + 'static,

Registers a dynamic tool with a pre-made definition and handler.

This is useful for type-erased tools (e.g., child terminal tools for subagents) where the concrete type isn’t known at compile time. The handler receives the JSON arguments and the call’s ToolContext.

Errors

Same conditions as Self::register.

pub fn unregister(&mut self, name: &str)

Removes a tool from the registry.

pub async fn call( &self, name: &str, args: &str, cx: ToolContext, ) -> Result<ToolResult>

Calls a tool by name with JSON arguments, running it with cx as its ToolContext.

Errors

Returns an error if the tool is not found, arguments cannot be parsed, or tool execution fails.

Trait Implementations

impl Debug for Tools

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

Formats the value using the given formatter.

impl Default for Tools

fn default() -> Self

Returns the “default value” for a type.