Struct HookRegistry 

pub struct HookRegistry { /* private fields */ }

Registry of lifecycle hooks with typed registration and timeout enforcement.

Implementations

impl HookRegistry

pub fn new() -> Self

Create an empty registry.

pub fn on_pre_tool_use<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(PreToolUseContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a pre-tool-use hook.

pub fn on_post_tool_use<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(PostToolUseContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a post-tool-use hook.

pub fn on_post_tool_use_failure<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(PostToolUseFailureContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a post-tool-use failure hook.

pub fn on_notification<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(NotificationContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a notification hook.

pub fn on_subagent_start<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(SubagentStartContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a subagent start hook.

pub fn on_subagent_stop<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(SubagentStopContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a subagent stop hook.

pub fn on_pre_compact<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(PreCompactContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a pre-compact hook.

pub fn on_post_compact<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(PostCompactContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a post-compact hook.

pub fn on_session_start<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(SessionStartContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a session start hook.

pub fn on_session_end<F>(&mut self, matcher: HookMatcher, f: F)

where F: Fn(SessionEndContext) -> BoxFuture<'static, HookResult> + Send + Sync + 'static,

Register a session end hook.

pub async fn run_pre_tool_use( &self, ctx: PreToolUseContext, ) -> Result<HookResult, AgentError>

Run all matching pre-tool-use hooks in registration order.

Returns the first Abort result encountered, or Continue if all pass. Hooks that exceed their timeout are skipped with a warn! log.

pub async fn run_post_tool_use( &self, ctx: PostToolUseContext, ) -> Result<HookResult, AgentError>

Run all matching post-tool-use hooks.

pub async fn run_post_tool_use_failure( &self, ctx: PostToolUseFailureContext, ) -> Result<HookResult, AgentError>

Run all matching post-tool-use failure hooks.

pub async fn run_notification( &self, ctx: NotificationContext, ) -> Result<HookResult, AgentError>

Run all notification hooks.

pub async fn run_session_start( &self, ctx: SessionStartContext, ) -> Result<HookResult, AgentError>

Run all session start hooks.

pub async fn run_session_end( &self, ctx: SessionEndContext, ) -> Result<HookResult, AgentError>

Run all session end hooks.

pub async fn run_subagent_start( &self, ctx: SubagentStartContext, ) -> Result<HookResult, AgentError>

Run all subagent start hooks.

pub async fn run_subagent_stop( &self, ctx: SubagentStopContext, ) -> Result<HookResult, AgentError>

Run all subagent stop hooks.

pub async fn run_pre_compact( &self, ctx: PreCompactContext, ) -> Result<HookResult, AgentError>

Run all pre-compact hooks.

pub async fn run_post_compact( &self, ctx: PostCompactContext, ) -> Result<HookResult, AgentError>

Run all post-compact hooks.

Trait Implementations

impl Debug for HookRegistry

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

Formats the value using the given formatter.

impl Default for HookRegistry

fn default() -> HookRegistry

Returns the “default value” for a type.