Struct ToolExecutionContext 

pub struct ToolExecutionContext {

    pub requested_name: String,
    pub canonical_id: String,
    pub display_name: String,
    pub provider_id: Option<String>,
    pub registry_version: u64,
    pub policy_version: u64,
    pub runtime_control_version: u64,
    pub call_id: String,
    pub source: ToolCallSource,
    pub actor: ToolActorContext,
    pub cancellation: ToolCancellationToken,
    pub started_at: DateTime<Utc>,
    pub deadline: Option<DateTime<Utc>>,
    pub permission: ToolPolicyDecisionRecord,
    pub approval: Option<ToolApprovalRecord>,
    pub classification: ToolCallClassification,
    pub safety: ToolSafetyMetadata,
    pub limits: ToolExecutionLimits,
    pub policy_snapshot: Value,
    pub custom_config: Value,
}

Context passed unchanged from the shared executor into a tool implementation.

Fields

requested_name: String

Tool name, alias, or display name requested by the caller.

canonical_id: String

Canonical tool ID used for policy, HITL, recovery, and evidence.

display_name: String

Display name resolved from the registry.

provider_id: Option<String>

Provider ID for provider-backed tools.

registry_version: u64

Registry snapshot version used for this call.

policy_version: u64

Policy snapshot version used for this call.

runtime_control_version: u64

Runtime-control snapshot version used for this call.

call_id: String

Stable call ID used in records and history.

source: ToolCallSource

Runtime path that requested this call.

actor: ToolActorContext

Actor and sender identity for the current turn.

cancellation: ToolCancellationToken

Cooperative cancellation observer.

started_at: DateTime<Utc>

UTC time at which shared executor handling started.

deadline: Option<DateTime<Utc>>

UTC deadline derived from the timeout budget.

permission: ToolPolicyDecisionRecord

Permission decision that allowed this call to reach the tool.

approval: Option<ToolApprovalRecord>

HITL decision evidence when approval was checked.

classification: ToolCallClassification

Call-level safety classification after arguments are known.

safety: ToolSafetyMetadata

Static tool safety metadata from the resolved registration.

limits: ToolExecutionLimits

Effective limits that tools must treat as upper bounds.

policy_snapshot: Value

Raw per-tool policy snapshot when the runtime is allowed to expose it.

custom_config: Value

Custom settings from tool_security.tools.<tool_id>.config.

Implementations

impl ToolExecutionContext

pub fn test(tool_id: impl Into<String>) -> ToolExecutionContext

Builds a minimal context for unit tests and direct examples.

Trait Implementations

impl Clone for ToolExecutionContext

fn clone(&self) -> ToolExecutionContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolExecutionContext

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

Formats the value using the given formatter.