Struct HookContext 

pub struct HookContext { /* private fields */ }

Run-scoped context passed by shared reference to every AgentHook::on_event call.

Carries the run’s identity and a shared Scratchpad. It is a driver construct built once per run by AgentRunner; nothing here reaches the sans-IO AgentRun state machine. Hooks hold it by &, so all fields are read via accessors and run-scoped mutation goes through scratchpad.

One HookContext is shared by every hook invocation in a run. At tool_concurrency > 1 the ToolCall / ToolResult hooks for different tools in a turn can run concurrently against this shared context — see the Scratchpad concurrency note for how to store run-scoped state safely under that concurrency.

Implementations

impl HookContext

pub fn run_id(&self) -> &RunId

The run’s stable identifier.

pub fn turn(&self) -> usize

The current one-based model-call index (0 before the first turn).

pub fn is_streaming(&self) -> bool

Whether this run is driven by the streaming surface.

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

The agent’s configured name, if any.

pub fn scratchpad(&self) -> &Scratchpad

The run-scoped shared scratchpad.

Trait Implementations

impl Debug for HookContext

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

Formats the value using the given formatter.