Struct ToolExecutionContext 

pub struct ToolExecutionContext<'a> {
    pub session_id: Option<&'a str>,
    pub tool_call_id: &'a str,
    pub event_tx: Option<&'a Sender<AgentEvent>>,
    pub available_tool_schemas: Option<&'a [ToolSchema]>,
    pub bypass_permissions: bool,
}

Context passed to tools during execution.

All fields are optional and should be treated as best-effort hints.

⚠️ Real tool dispatch must build this via ToolExecutionContext::for_dispatch (both agent loops do), NOT a struct literal — that routes every per-session flag through ToolExecutionSessionFlags so a new flag can’t be wired into one loop and silently skipped in the other. Struct literals are for tests and tools that synthesize a child context.

Fields

session_id: Option<&'a str>

Bamboo session id that is executing the tool.

tool_call_id: &'a str

Tool call id from the model (ToolCall.id).

event_tx: Option<&'a Sender<AgentEvent>>

Event sender for streaming progress to clients (agent SSE stream).

available_tool_schemas: Option<&'a [ToolSchema]>

Snapshot of tools currently available to the executing session.

bypass_permissions: bool

When true, the executing session is in “bypass permissions” mode, so tool permission checks are skipped. Sourced per-session from the session’s runtime state (runtime.json), not the global checker.

Implementations

impl<'a> ToolExecutionContext<'a>

pub fn none(tool_call_id: &'a str) -> ToolExecutionContext<'a>

pub fn for_dispatch( session_id: &'a str, tool_call_id: &'a str, event_tx: &'a Sender<AgentEvent>, available_tool_schemas: &'a [ToolSchema], flags: ToolExecutionSessionFlags, ) -> ToolExecutionContext<'a>

Build a context for a real tool dispatch, applying every per-session flag from ToolExecutionSessionFlags. This is the SINGLE place that maps session flags onto the context, and the only constructor the agent loops use — keep both loops (per_call.rs, result_handler.rs) on it so a new per-session field reaches all dispatch paths without per-site edits.

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

Clone the sender (when present) for use in spawned tasks.

pub async fn emit(&self, event: AgentEvent)

Best-effort emit of an event (ignored if no sender).

pub async fn emit_tool_token(&self, content: impl Into<String>)

Convenience helper for streaming tool-scoped output.

Trait Implementations

impl<'a> Clone for ToolExecutionContext<'a>

fn clone(&self) -> ToolExecutionContext<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ToolExecutionContext<'a>

impl<'a> Debug for ToolExecutionContext<'a>

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

Formats the value using the given formatter.