Struct ToolContext 

pub struct ToolContext { /* private fields */ }

Context passed to every tool execution.

Callers insert typed inbound values with insert. Tools read those values with get or require, and attach host-only result metadata with insert_result. Result hooks inspect that metadata through result. Neither inbound values nor result metadata are sent to the model.

Registry, server, and agent dispatch clone inbound values once per call. Map-level mutations (inserting, replacing, or removing typed slots) affect only that execution. Value-level isolation follows each value’s Clone semantics, so intentionally shared values such as Arc<Mutex<_>> continue to share their referent across dispatches. The dispatch surface returns result metadata without replacing the caller’s inbound slots.

Implementations

impl ToolContext

pub const fn new() -> Self

Create an empty context.

pub fn insert<T>(&mut self, value: T) -> Option<T>

where T: Clone + WasmCompatSend + WasmCompatSync + 'static,

Insert an inbound typed value, returning the displaced value if present.

pub fn get<T>(&self) -> Option<&T>

where T: WasmCompatSend + WasmCompatSync + 'static,

Read an inbound typed value.

pub fn require<T>(&self) -> Result<&T, MissingToolContext>

where T: WasmCompatSend + WasmCompatSync + 'static,

Require an inbound typed value.

pub fn get_mut<T>(&mut self) -> Option<&mut T>

where T: WasmCompatSend + WasmCompatSync + 'static,

Mutably access an inbound typed value.

pub fn remove<T>(&mut self) -> Option<T>

where T: WasmCompatSend + WasmCompatSync + 'static,

Remove an inbound typed value.

pub fn insert_result<T>(&mut self, value: T) -> Option<T>

where T: Clone + WasmCompatSend + WasmCompatSync + 'static,

Attach host-only metadata to this execution’s result.

pub fn result<T>(&self) -> Option<&T>

where T: WasmCompatSend + WasmCompatSync + 'static,

Read host-only result metadata.

pub fn require_result<T>(&self) -> Result<&T, MissingToolContext>

where T: WasmCompatSend + WasmCompatSync + 'static,

Require host-only result metadata.

pub fn contains<T>(&self) -> bool

where T: WasmCompatSend + WasmCompatSync + 'static,

Whether this context contains the inbound type T.

Trait Implementations

impl Clone for ToolContext

fn clone(&self) -> ToolContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolContext

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

Formats the value using the given formatter.

impl Default for ToolContext

fn default() -> ToolContext

Returns the “default value” for a type.