Structs§
- Hook
Message - Lifecycle
Hook Command Preview - A lifecycle hook command exactly as the engine will execute it, with its canonical snake_case event key. Displayed to the user so an approval covers the precise command set.
- Lifecycle
Hook Engine - Permission
Request Hook Decision - Permission
Request Hook Outcome - Permission
Update Request - PreCompact
Hook Outcome - Stop
Hook Outcome
Enums§
- Hook
Message Level - Notification
Hook Type - Permission
Decision Behavior - Permission
Decision Scope - Permission
Update Destination - Permission
Update Kind - PreTool
Hook Decision - Session
EndReason - Session
Start Trigger
Functions§
- carry_
or_ restore_ workspace_ hook_ approval - Carry an in-memory approval from a previous engine onto a rebuilt engine (primary-agent switch or config reload), falling back to the persisted record. A session-only approval that could not be persisted (e.g. dot-config write failure) survives the rebuild while the command set is unchanged, instead of being silently dropped mid-session. Fails closed in every other case: a changed command set, a previously unapproved engine, or a gated engine with no matching persisted record leaves the rebuilt engine gated.
- restore_
workspace_ hook_ approval - Restore a persisted workspace lifecycle-hook approval onto a freshly built engine. The persisted record only applies when its digest still matches the engine’s exact command set; any configuration change since approval leaves the engine fail-closed.