Struct ToolContext

pub struct ToolContext {
    pub state: Arc<AgentStateSnapshot>,
    pub state_handle: Option<Arc<RwLock<AgentStateSnapshot>>>,
    pub tool_call_id: Option<String>,
}

Context provided to tool implementations for accessing agent state and utilities

Fields

state: Arc<AgentStateSnapshot>

Current agent state snapshot (immutable view)

state_handle: Option<Arc<RwLock<AgentStateSnapshot>>>

Optional mutable state handle for tools that need to modify state

tool_call_id: Option<String>

Tool invocation metadata (call ID for responses)

Implementations

impl ToolContext

pub fn new(state: Arc<AgentStateSnapshot>) -> ToolContext

Create a context with immutable state only

pub fn with_mutable_state( state: Arc<AgentStateSnapshot>, state_handle: Arc<RwLock<AgentStateSnapshot>>, ) -> ToolContext

Create a context with mutable state access

pub fn with_call_id(self, call_id: Option<String>) -> ToolContext

Set the tool call ID for response correlation

pub fn text_response(&self, content: impl Into<String>) -> AgentMessage

Create a tool response message with proper metadata

pub fn json_response(&self, content: Value) -> AgentMessage

Create a JSON tool response

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.