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 causes the calling operation to fail. When false (default), errors are logged but execution continues.

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<(), Error>

Formats the value using the given formatter.

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<HookDef, <__D as Deserializer<'de>>::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 as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.