Struct ActivateToolsTool 

pub struct ActivateToolsTool;

Model-initiated deterministic exact activation. Every requested id must be an exact known cataloged ToolId; the whole batch validates first (host grant issuance: exact id, current generation/digest, source trust) and applies atomically in stable id order with exactly one session schema-generation advance. Requires host-supplied confirmation authority; a model-authored JSON flag can never substitute for it.

Trait Implementations

impl Tool for ActivateToolsTool

fn execute_rich<'life0, 'async_trait>( &'life0 self, params: Value, ctx: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolOutput, RuntimeError>> + Send + 'async_trait>>

where 'life0: 'async_trait, ActivateToolsTool: 'async_trait,

The text summary first (compaction, previews and non-Anthropic providers read it), then one tool_reference per activated tool, keyed by canonical tool id. On the Anthropic transport with deferred loading, the wire layer resolves each id to its wire name and sends only the references, which makes the deferred definitions callable without changing the cached prompt prefix. Everywhere else the references are dropped and the text stands alone.

fn name(&self) -> &str

Tool name as it appears in the API (e.g. “bash”, “read”).

fn description(&self) -> &str

Human-readable description sent to the model.

fn origin(&self) -> ToolOrigin

Runtime-origin identity used for catalog provenance. Conservative by default: tools that declare nothing are Unknown (fail-closed source trust), and tools that declare an owning extension classify as extension-provided. Built-in implementations override this explicitly.

fn parameters(&self) -> Value

JSON Schema for the tool’s parameters.

fn execute<'life0, 'async_trait>( &'life0 self, params: Value, ctx: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<String, RuntimeError>> + Send + 'async_trait>>

where 'life0: 'async_trait, ActivateToolsTool: 'async_trait,

Execute the tool with the given parameters.

fn extension_id(&self) -> Option<&str>

Owning extension id for tools registered by an extension. Built-in tools return None.

fn effect(&self) -> ToolEffect

Conservative effect class (Task 24, spec §8.2). The default keeps unknown/dynamic tools NonIdempotent — serialized execution; implementations opt IN to weaker classes explicitly.

fn runs_independently(&self) -> bool

Each call is its own independent actor (a subagent): sibling calls in one batch each get their own scheduler lane and run concurrently, instead of joining the shared serial lane that NonIdempotent tools use. Scheduling only — the effect class, and with it the rule that an interrupted call is never re-run automatically, is unchanged.

fn concurrency_key(&self, _validated_input: &Value) -> Option<ConcurrencyKey>

Key resolution derived from validated input. Serialize explicitly fails closed into the global mutation lane; None is the conservative default for tools with no key support.