Enum Event 

pub enum Event {
    SessionStart,
    Heartbeat,
    Stop,
    PromptSubmit,
    SessionEnd,
    Status,
    Call,
    Watch,
}

Lifecycle events this helper knows. Anything else is a caller mistake worth naming rather than a silent success.

Variants

SessionStart

A conversation started: publish presence and return the context the host injects into the model.

Heartbeat

Keep the window’s presence alive mid-conversation.

Stop

The turn ended; the window is still open. Reports the model idle.

PromptSubmit

The user submitted a prompt: a turn is starting. Reports the model attending.

SessionEnd

The window is closing.

Status

What this binding is, for troubleshooting. Never prints a secret.

Call

One MCP tool call as the bound window (--tool, --args), printing the tool’s structured content. Silent, like the presence events, when the binding is missing or carries no credential. Only the tools in HOOK_CALL_TOOLS are served: a hook must not be able to issue, rotate or revoke a credential, nor act on the bus beyond what its scripts need.

Watch

Watch the bus for this window while it sits idle, and return (exit 2) only when something new is addressed to it: a host that runs this as a background, rewaking hook (Claude Code’s asyncRewake) then wakes the idle session with the returned text. Silent and exit 0 when the deadline passes, the binding closes, or a newer watcher of the same window replaces this one.

Trait Implementations

impl Clone for Event

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Event

impl Debug for Event

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

Formats the value using the given formatter.

impl Eq for Event

impl FromStr for Event

type Err = Error

The associated error which can be returned from parsing.

fn from_str(raw: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq for Event

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Event