Struct ToolGroup 

pub struct ToolGroup {
    pub name: String,
    pub description: Option<String>,
    pub tool_count: usize,
    pub deferred_count: usize,
}

A namespace-derived grouping of tools, computed from ToolDefinition::namespace. Purely a client-side view for search results and diagnostics.

IMPORTANT DESIGN CONSTRAINT: groups are never sent to the provider as wire-level “stub” tools. Provider-hosted tool search (Anthropic’s tool_search_tool_* beta, OpenAI’s hosted tool_search) requires the full deferred tool definitions to already be present in the request payload – there is no server-side concept of a group stub the model can expand later. Sending a fake stub entry (e.g. a placeholder tool named after the group) would invite the model to hallucinate a call to a tool that does not exist. Namespace/group metadata therefore stays entirely client-side: it powers local BM25 ranking (see ToolEmbeddingIndex::build) and the by_group field in local tool search results, but is never itself placed on the wire.

Fields

name: String

The namespace name (e.g. an MCP server name).

description: Option<String>

The namespace description. Always Some for namespaced groups – tool_groups only creates a group when a tool carries a namespace, and it takes the description from that namespace, not per-tool.

tool_count: usize

Total number of tools in this group.

deferred_count: usize

Number of tools in this group that are currently deferred (defer_loading == Some(true)).

Trait Implementations

impl Clone for ToolGroup

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolGroup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for ToolGroup

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ToolGroup