Struct Toolset 

pub struct Toolset<D = ()>
where
    D: Send + Sync + 'static,
{ /* private fields */ }

Reusable, append-only collection of tools.

D is the same typed-deps parameter used by Tool and ToolRegistry. A Toolset<D> may only be installed into a ToolRegistry<D>, preserving the operator’s dependency boundary at compile time.

Implementations

impl<D> Toolset<D>

where D: Send + Sync + 'static,

pub fn new(id: impl Into<String>) -> Result<Self>

Create an empty toolset with a stable id.

The id is operator-facing metadata used by capability manifests, test fixtures, and durable-runtime activity names. It is not sent to the model and does not alter tool names.

pub fn id(&self) -> &str

Stable toolset id.

pub fn len(&self) -> usize

Number of tools in the set.

pub fn is_empty(&self) -> bool

True when no tools are present.

pub fn names(&self) -> impl Iterator<Item = &str>

Iterate tool names in stable lexical order.

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

Borrow a tool by exact name.

pub fn tool_specs(&self) -> Arc<[ToolSpec]>

Return model-facing tool specs in stable lexical order.

This is an inspection helper for tests and capability manifests. Agents should still derive their final advertised tool catalogue from the installed ToolRegistry.

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

Append one tool to the set.

Reach for this when assembling a reusable bundle the operator installs into multiple ToolRegistry<D> instances — Toolset::new("support").register(tool_a)?.register(tool_b)? .install_into(registry)? is the canonical capability-bundle path. Duplicate names are rejected: a toolset with ambiguous names cannot be installed safely because later restriction and approval policies address tools by exact name.

pub fn restricted_to(&self, allowed: &[&str]) -> Result<Self>

Produce a strict-name restricted view of this set.

Names absent from the toolset are configuration errors. Empty names and duplicate names are also rejected, keeping the declaration surface deterministic and typo-safe.

impl<D> Toolset<D>

where D: Clone + Send + Sync + 'static,

pub fn install_into(&self, registry: ToolRegistry<D>) -> Result<ToolRegistry<D>>

Install this set into an existing registry.

The supplied registry’s deps and layer stack are preserved. Registration remains append-only; name collisions with tools already present in the registry surface as Error::Config from ToolRegistry::register.

Trait Implementations

impl<D> Clone for Toolset<D>

where D: Send + Sync + 'static,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<D> Debug for Toolset<D>

where D: Send + Sync + 'static,

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

Formats the value using the given formatter.