hooks schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Daemon hooks — event-driven automation entries.

Field path	Type	Required	Canonical description
`hooks`	`section`	optional	Daemon hooks — event-driven automation entries.
└ `hooks.name`	`string`	required	Stable operator-facing label for TUI, logs, and execution history.
└ `hooks.trigger`	`string`	required	Event trigger or matcher (e.g. agent_completed, bead_closed).
└ `hooks.action`	`map`	required	Structured action.
└ `hooks.action.type`	`string`	required	Action type: command or tmux_send.
└ `hooks.action.command`	`string`	optional	Shell command to execute (required when type = command).
└ `hooks.action.target`	`string`	optional	Persistent agent declaration name targeted by tmux_send.
└ `hooks.action.message`	`string`	optional	Message text sent to the target agent when type = tmux_send.
└ `hooks.action.timeout`	`u32`	optional	Timeout in seconds.
└ `hooks.nodes`	`list[string]`	optional	Node names allowed to execute; omit for all nodes.