Struct ToolCtx 

pub struct ToolCtx { /* private fields */ }

What the runtime hands a tool for one execution attempt.

This type is kept deliberately small. The only thing a handler clearly needs is the idempotency key for the current attempt: an Idempotent tool uses it so that a retried attempt reuses the same key and the provider collapses the duplicate into one effect. Everything else a tool might want (recorded clock, randomness, model calls) belongs to RunCtx in the orchestration layer, not to a single tool call, so it stays out of here.

The type is designed for additive growth. Fields are private and reached through accessors, so run identity, the current sequence number, or a tracing span can be added later without breaking a tool’s call signature.

It is constructed by the runtime, not by tools. The runtime builds one ToolCtx per dispatch from the idempotency key the replay cursor carries for that tool call; tests construct it directly.

Implementations

impl ToolCtx

pub fn new(idempotency_key: Option<String>) -> Self

Builds a context carrying the idempotency key for this attempt.

Pass None for a tool call that has no key (a Read, or a call the runtime chose not to key); pass Some(key) for the keyed retry of an Idempotent tool.

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

The idempotency key for the current attempt, if the runtime set one.

An idempotent tool that talks to a provider passes this through as the provider’s idempotency key so that a retry reuses it and does not create a second effect.

Trait Implementations

impl Clone for ToolCtx

fn clone(&self) -> ToolCtx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolCtx

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

Formats the value using the given formatter.

impl Default for ToolCtx

fn default() -> ToolCtx

Returns the “default value” for a type.

impl Eq for ToolCtx

impl PartialEq for ToolCtx

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ToolCtx