Struct DeferredMcpToolSet 

pub struct DeferredMcpToolSet {
    pub stubs: Vec<DeferredMcpToolStub>,
    pub registry: Arc<McpRegistry>,
}

Collection of all deferred MCP tool stubs discovered at startup. Provides keyword search for tool_search.

Fields

stubs: Vec<DeferredMcpToolStub>

All stubs — exposed for test construction.

registry: Arc<McpRegistry>

Shared registry — exposed for test construction.

Implementations

impl DeferredMcpToolSet

pub async fn from_registry(registry: Arc<McpRegistry>) -> Self

Build the set from a connected McpRegistry.

pub async fn from_registry_filtered<F>( registry: Arc<McpRegistry>, filter: F, ) -> Self

where F: Fn(&str) -> bool,

Build the set from a connected McpRegistry, including only tools whose prefixed name passes the given filter predicate.

pub fn stub_names(&self) -> Vec<&str>

All stub names (for rendering in the system prompt).

pub fn len(&self) -> usize

Number of deferred stubs.

pub fn is_empty(&self) -> bool

Whether the set is empty.

pub fn get_by_name(&self, name: &str) -> Option<&DeferredMcpToolStub>

Look up stubs by exact name, falling back to unique suffix match.

Some providers (or prompt instructions) reference MCP tools without the <server>__ prefix. When the suffix maps to exactly one stub, allow the lookup to succeed — same pattern as ActivatedToolSet::get_resolved.

pub fn search( &self, query: &str, max_results: usize, ) -> Vec<&DeferredMcpToolStub>

Keyword search — returns stubs whose name or description contains any of the query terms (case-insensitive). Results are ranked by number of matching terms (descending).

pub fn activate(&self, name: &str) -> Option<Box<dyn Tool>>

Activate a stub by name, returning a boxed Tool.

pub fn tool_spec(&self, name: &str) -> Option<ToolSpec>

Return the full ToolSpec for a stub (for inclusion in tool_search results).

Trait Implementations

impl Clone for DeferredMcpToolSet

fn clone(&self) -> DeferredMcpToolSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.