Struct Unadvertised 

pub struct Unadvertised<S> { /* private fields */ }

A ToolSource wrapper that dispatches tools without advertising them. specs() is always empty and the inner source’s catalog events are drained but not forwarded; get() delegates unchanged, so every inner tool remains invocable by exact name.

Constructed via ToolSource::unadvertised or directly.

Implementations

impl<S> Unadvertised<S>

pub fn new(inner: S) -> Self

Creates a new dispatch-only wrapper.

Trait Implementations

impl<S> ToolSource for Unadvertised<S>

where S: ToolSource,

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.

fn unadvertised(self) -> Unadvertised<Self>

where Self: Sized,

Wraps this source so its tools stay resolvable by name but are never advertised: specs() is empty and catalog events are swallowed, while get() passes through. Use this for dispatch-only catalogs — e.g. children of a composition tool that the model should invoke through a script rather than see individually.