Enum HookKind 

pub enum HookKind {
    PreToolUse,
    PostToolUse,
    PostToolUseFailure,
    UserPromptSubmit,
    Stop,
    SubagentStop,
    SubagentStart,
    PreCompact,
    Notification,
    PermissionRequest,
    WorktreeCreate,
    WorktreeRemove,
    CwdChanged,
    FileChanged,
    SessionStart,
    SessionEnd,
    Unknown,
}

Identifies which hook point a callback is registered for. Sixteen event kinds mirrored from the CLI v0.1.64, plus Unknown as a fallback for forward-compatibility.

Variants

PreToolUse

Before a tool is invoked.

PostToolUse

After a tool completes successfully.

PostToolUseFailure

After a tool errors.

UserPromptSubmit

Every user prompt (can rewrite or cancel).

Stop

End of an assistant turn.

SubagentStop

End of a sub-agent turn.

SubagentStart

Start of a sub-agent turn.

PreCompact

Before session compaction.

Notification

Out-of-band notification to the caller.

PermissionRequest

Permission request observation (distinct from can_use_tool).

WorktreeCreate

Worktree created (LLM called EnterWorktree, or claude spawned with –worktree).

WorktreeRemove

Worktree removed (LLM called ExitWorktree, or claude session ended).

CwdChanged

Session cwd changed (LLM entered/exited a worktree).

FileChanged

External file modification observed by claude’s file-history watcher.

SessionStart

Session lifecycle: init.

SessionEnd

Session lifecycle: end.

Unknown

Fallback for hook events forge-sdk doesn’t yet recognise.

Implementations

impl HookKind

pub fn as_str(self) -> &'static str

Wire-name used by the claude binary.

pub fn from_wire(s: &str) -> HookKind

Parse a wire-name back into the enum. Unknown strings fall through to HookKind::Unknown - forge-sdk is forward-compatible with new hook types Anthropic introduces between our parity checks.

Trait Implementations

impl Clone for HookKind

fn clone(&self) -> HookKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HookKind

impl Debug for HookKind

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

Formats the value using the given formatter.

impl Eq for HookKind

impl Hash for HookKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for HookKind

fn eq(&self, other: &HookKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HookKind