Struct ToolCollection 

pub struct ToolCollection<M = NoMeta> { /* private fields */ }

Collection of registered tools, parameterized by a metadata type M.

M defaults to NoMeta — an empty struct that swallows any #[tool(...)] attributes a tool declared. Opt into typed metadata by setting M explicitly:

let tools = ToolCollection::<MyPolicy>::collect_tools()?;
if tools.meta("delete_file").unwrap().requires_approval { ... }

Implementations

impl<M> ToolCollection<M>

pub fn new() -> ToolCollection<M>

pub fn register<A, I, O, F, Fut>( &mut self, name: &'static str, desc: &'static str, func: F, meta: A, ) -> Result<&mut ToolCollection<M>, ToolError>

where A: MetaArg<M>, I: 'static + DeserializeOwned + Serialize + Send + ToolSchema, O: 'static + Serialize + Send + ToolSchema, F: Fn(I) -> Fut + Send + Sync + 'static, Fut: Future<Output = O> + Send + 'static,

Register a tool programmatically. Pass () as meta for ToolCollection<NoMeta>; pass an M for typed collections. Passing () to a typed collection is a compile error.

pub async fn call( &self, call: FunctionCall, ) -> Result<FunctionResponse, ToolError>

pub fn unregister(&mut self, name: &str) -> Result<(), ToolError>

pub fn get(&self, name: &str) -> Option<&ToolEntry<M>>

pub fn meta(&self, name: &str) -> Option<&M>

pub fn iter(&self) -> impl Iterator<Item = (&'static str, &ToolEntry<M>)>

pub fn descriptions(&self) -> impl Iterator<Item = (&'static str, &'static str)>

pub fn json(&self) -> Result<Value, ToolError>

impl<M> ToolCollection<M>

where M: DeserializeOwned,

pub fn collect_tools() -> Result<ToolCollection<M>, ToolError>

Collect every tool registered via #[tool]. Fails fast on the first tool whose meta_json blob does not deserialize into M.

For accumulated, CI-friendly validation use validate_tool_attrs.

Trait Implementations

impl<M> Clone for ToolCollection<M>

where M: Clone,

fn clone(&self) -> ToolCollection<M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M> Default for ToolCollection<M>

fn default() -> ToolCollection<M>

Returns the “default value” for a type.