Struct HookManager 

pub struct HookManager { /* private fields */ }

Orchestrates hook execution for lifecycle events.

The manager holds a frozen snapshot of the hook configuration, an executor for running subprocess commands, and session metadata used to build stdin payloads for hook commands.

Implementations

impl HookManager

pub fn new( config: HookConfig, session_id: impl Into<String>, cwd: impl Into<String>, ) -> Self

Create a new hook manager.

The config should already have compile_all() and strip_unknown_events() called on it.

pub fn noop() -> Self

Create a manager with no hooks configured (no-op for all events).

pub fn has_hooks_for(&self, event: HookEvent) -> bool

Fast check: are there hooks registered for this event?

pub async fn run_hooks( &self, event: HookEvent, match_value: Option<&str>, event_data: Option<&Value>, ) -> HookOutcome

Run all matching hooks for an event.

Hooks execute sequentially. Short-circuits on block (exit code 2).

Arguments

• event: The lifecycle event.
• match_value: Value to test against matcher regex (e.g., tool name).
• event_data: Additional event-specific data for the stdin payload.

pub fn run_hooks_async( &self, event: HookEvent, match_value: Option<String>, event_data: Option<Value>, )

where Self: Send + Sync + 'static,

Fire-and-forget hook execution.

Spawns hook execution as a background tokio task. Used for events where we don’t need to wait for the result (e.g., PostToolUse logging).