Struct ToolInvocation 

pub struct ToolInvocation {
    pub tool_use_id: String,
    pub metadata: Arc<ToolMetadata>,
    pub input: Value,
    pub ctx: ExecutionContext,
}

One tool call’s identifier + descriptor + input + request-scope context.

tool_use_id carries the IR’s stable id so observability layers can correlate ToolStart / ToolComplete / ToolError events for the same dispatch even when several parallel calls share the same tool name. metadata is the dispatched tool’s full declarative descriptor — name / version / effect / idempotent / retry hint flow through the layer stack from a single source so OtelLayer, PolicyLayer, and retry middleware see one authoritative struct. Layers may mutate input (e.g. PII redaction).

Fields

tool_use_id: String

Stable tool-use id matching the originating ContentPart::ToolUse::id. Empty when the call did not originate from a model ToolUse block (e.g. recipe-driven direct dispatch); observability layers fall back to metadata.name in that case.

metadata: Arc<ToolMetadata>

Full declarative descriptor of the tool being dispatched — shared via Arc so layers don’t pay a clone per pass.

input: Value

JSON input payload.

ctx: ExecutionContext

Request-scope state.

Implementations

impl ToolInvocation

pub const fn new( tool_use_id: String, metadata: Arc<ToolMetadata>, input: Value, ctx: ExecutionContext, ) -> Self

Bundle the fields.

pub fn name(&self) -> &str

Tool name (shortcut for self.metadata.name.as_str()).

pub fn version(&self) -> Option<&str>

Tool version (shortcut for self.metadata.version.as_deref()).

Trait Implementations

impl Clone for ToolInvocation

fn clone(&self) -> ToolInvocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolInvocation

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

Formats the value using the given formatter.

impl Retryable for ToolInvocation

fn ctx(&self) -> &ExecutionContext

Borrow the ExecutionContext the retry loop checks for cancellation between attempts.

fn ctx_mut(&mut self) -> &mut ExecutionContext

Mutable handle so RetryService can stamp an idempotency key on first entry — every clone of the request that follows shares the stamped key, so vendor-side dedupe sees one logical call across N attempts.

impl<Inner> Service<ToolInvocation> for RetryToolService<Inner>

where Inner: Service<ToolInvocation, Response = Value, Error = Error> + Clone + Send + 'static, Inner::Future: Send + 'static,

type Response = Value

Responses given by the service.

type Error = Error

Errors produced by the service.

type Future = Pin<Box<dyn Future<Output = Result<Value, Error>> + Send>>

The future response value.

fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll<Result<()>>

Returns Poll::Ready(Ok(())) when the service is able to process requests.

fn call(&mut self, invocation: ToolInvocation) -> Self::Future

Process the request and return the response asynchronously.

impl<S> Service<ToolInvocation> for ScopedToolService<S>

where S: Service<ToolInvocation, Response = Value, Error = Error> + Send + 'static, S::Future: Send + 'static,

type Response = Value

Responses given by the service.

type Error = Error

Errors produced by the service.

type Future = Pin<Box<dyn Future<Output = Result<Value, Error>> + Send>>

The future response value.

fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll<Result<()>>

Returns Poll::Ready(Ok(())) when the service is able to process requests.

fn call(&mut self, invocation: ToolInvocation) -> Self::Future

Process the request and return the response asynchronously.