Struct HookDef 

pub struct HookDef {
    pub action: HookAction,
    pub timeout_secs: u64,
    pub fail_closed: bool,
}

A single hook definition.

Hooks are fired at specific lifecycle points. The action field determines whether the hook runs a shell command or dispatches to an MCP server tool.

Examples

[[hooks.cwd_changed]]
type = "command"
command = "echo changed to $ZEPH_NEW_CWD"
timeout_secs = 10
fail_closed = false

Fields

action: HookAction

The action to execute: shell command or MCP tool call.

timeout_secs: u64

Maximum seconds to wait for the hook before timing out. Default: 30.

fail_closed: bool

When true, a non-zero exit code or timeout aborts the remaining hooks in the same sequence (no further hooks in the list run). When false (default), errors are logged and the next hook in the sequence continues.

Note: in pre_tool_use and post_tool_use contexts this field controls hook-chain execution only — it does not block the tool call itself. Hook dispatch is always fail-open at the agent level; the tool executes regardless of hook outcomes.

Trait Implementations

impl Clone for HookDef

fn clone(&self) -> HookDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookDef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookDef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HookDef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.