Struct ExternalHookRunner 

pub struct ExternalHookRunner {
    pub cancel_token: Option<CancellationToken>,
    /* private fields */
}

Discovers and runs external hook executables.

External hooks are scanned from one or more directories. Each executable file is treated as a hook. When dispatch is called, the runner sends the event to each hook in order and returns the first non-Continue decision. Hooks that timeout or return invalid output are treated as Continue (fail-open).

Fields

cancel_token: Option<CancellationToken>

Optional cancellation token for asyncRewake hooks.

Implementations

impl ExternalHookRunner

pub fn discover(dirs: &[PathBuf]) -> Self

Scan the given directories and collect all executable files.

This is the legacy discovery mode: every executable in the directory is treated as a hook that fires for all events.

pub fn from_config(config: HooksConfig) -> Self

Build a runner from a structured HooksConfig.

Supports command and http types; prompt / agent require an LLM provider and are handled by [from_config_with_llm].

pub fn from_config_with_llm( config: HooksConfig, llm: Option<Arc<dyn LlmProvider>>, ) -> Self

Build a runner from a structured HooksConfig, with an optional LLM provider for prompt/agent-type hooks.

pub fn with_cancel_token(self, token: CancellationToken) -> Self

Attach a CancellationToken for asyncRewake hooks.

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

Attach an AgentEvent channel for TUI progress events.

pub fn len(&self) -> usize

Number of registered hooks.

pub fn is_empty(&self) -> bool

True when no hooks are registered.

pub async fn dispatch(&self, input: &HookInput) -> HookResult

Dispatch an event to all matching hooks.

Returns the first non-Continue HookResult. Hooks that fail, timeout, or return unparseable output are silently skipped (fail-open).

Trait Implementations

impl Clone for ExternalHookRunner

fn clone(&self) -> ExternalHookRunner

Returns a duplicate of the value.

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

Performs copy-assignment from source.