Struct Catalog 

pub struct Catalog { /* private fields */ }

The validated tool registry built during agent creation.

Implementations

impl Catalog

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

Registers one tool and rejects invalid definitions or duplicate names.

pub fn finalize(&mut self) -> Result<()>

Freezes the registry and installs tools_search when deferred tools exist.

pub fn registered_definitions(&self) -> Arc<[ToolDefinition]>

Returns all registered definitions in stable name order.

pub fn direct_definitions(&self) -> Arc<[ToolDefinition]>

Returns definitions included in every model request in stable name order.

pub fn deferred_definitions(&self) -> Arc<[ToolDefinition]>

Returns discoverable definitions in stable name order.

pub fn revision(&self) -> Result<&str>

Returns the stable schema and exposure fingerprint of this finalized catalog.

pub fn search_deferred( &self, query: &str, searchable: &BTreeSet<String>, ) -> Result<Vec<ToolDefinition>>

Searches currently deferred tools using BM25 relevance ranking.

pub fn bind_call( &self, call: ToolCall, materialized: &BTreeSet<String>, searchable: &BTreeSet<String>, ) -> Result<BoundToolCall>

Validates a model-returned call against this catalog and its step materialization.

pub fn requires_approval(&self, name: &str) -> bool

Returns whether the named tool requires approval.

Trait Implementations

impl Default for Catalog

fn default() -> Catalog

Returns the “default value” for a type.