Struct CatalogReader 

pub struct CatalogReader { /* private fields */ }

Read side of a dynamic tool catalog. Implements ToolSource and is the value handed to [agentkit_loop::AgentBuilder::tools]. Cloning subscribes a fresh broadcast receiver, so independent observers don’t compete for catalog events.

Implementations

impl CatalogReader

pub fn source_id(&self) -> &str

Stable source identifier appearing on emitted catalog events.

pub fn subscribe(&self) -> Receiver<ToolCatalogEvent>

Subscribes a fresh broadcast receiver — equivalent to CatalogWriter::subscribe.

Trait Implementations

impl Clone for CatalogReader

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ToolSource for CatalogReader

fn specs(&self) -> Vec<ToolSpec>

Returns the current spec for every tool in this source.

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

Looks up a tool by name, returning None if not present.

fn drain_catalog_events(&self) -> Vec<ToolCatalogEvent>

Drains pending catalog change events. Static sources return an empty list; dynamic sources surface added/removed/changed batches that the loop forwards to the model on the next turn.

fn prefixed(self, prefix: impl Into<String>) -> Prefixed<Self>

where Self: Sized,

Wraps this source so every advertised tool name is prefixed with <prefix>_. Useful for mounting the same source under multiple namespaces, or for avoiding collisions between MCP catalogs.

fn filtered<F>(self, predicate: F) -> Filtered<Self, F>

where Self: Sized, F: Fn(&ToolName) -> bool + Send + Sync + 'static,

Wraps this source so only tools whose name passes predicate are advertised and resolvable. Tools rejected by the predicate are invisible to the model and return None on lookup.

fn renamed<I>(self, mapping: I) -> Renamed<Self>

where Self: Sized, I: IntoIterator<Item = (ToolName, ToolName)>,

Wraps this source with a name remapping. Each (original, new) pair in mapping causes the tool to be advertised as new and resolved from new back to original on lookup. Tools not in the mapping pass through unchanged.