Struct ToolContext 

pub struct ToolContext<Ctx> {
    pub app: Ctx,
    pub metadata: HashMap<String, Value>,
    /* private fields */
}

Context passed to tool execution

Fields

app: Ctx

Application-specific context (e.g., user_id, db connection)

metadata: HashMap<String, Value>

Tool-specific metadata

Implementations

impl<Ctx> ToolContext<Ctx>

pub fn new(app: Ctx) -> Self

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

pub fn with_event_tx(self, tx: Sender<AgentEvent>) -> Self

Set the event channel for tools that need to emit events during execution.

pub fn emit_event(&self, event: AgentEvent)

Emit an event through the event channel (if set).

This uses try_send to avoid blocking and to ensure the future is Send. The event is silently dropped if the channel is full.

pub fn event_tx(&self) -> Option<Sender<AgentEvent>>

Get a clone of the event channel sender (if set).

This is useful for tools that spawn subprocesses (like subagents) and need to forward events to the parent’s event stream.