Enum HookKind 

pub enum HookKind {
    BeforeToolCall,
    AfterToolCall,
    BeforeMessage,
    OnMessageComplete,
    OnCompaction,
    OnSessionStart,
    OnSessionEnd,
}

All hook event kinds in the phase-1 catalog.

Each variant identifies a well-defined extension point in the agent loop. The set is intentionally closed; new kinds are added via a breaking version bump so existing permission grants stay coherent.

Variants

BeforeToolCall

Fires immediately before a tool is invoked. Handlers may block the call.

AfterToolCall

Fires immediately after a tool returns. Handlers receive the output.

BeforeMessage

Fires before an LLM message is sent. Handlers may inspect or block.

OnMessageComplete

Fires after an assistant response is completed and added to history.

OnCompaction

Fires after conversation compaction creates a replacement session.

OnSessionStart

Fires when a new session is created.

OnSessionEnd

Fires when a session is torn down.

Implementations

impl HookKind

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

Canonical string identifier for this kind, suitable for serialization keys, log output, and manifest declarations.

pub fn from_str(s: &str) -> Option<Self>

Parse from the canonical string representation.

Returns None for unrecognised strings so callers can surface a manifest validation error rather than silently dropping hooks.

pub fn allowed_action_names(&self) -> &'static [&'static str]

Supported action names for this hook in the extension contract.

pub fn allows_tool_filter(&self) -> bool

Whether this hook can be filtered by tool name in a manifest.

pub fn allows_result(&self, result: &HookResult) -> bool

Whether this hook accepts a handler result action.

pub fn required_permission(&self) -> Permission

The Permission an extension must hold to subscribe to this hook.

Called by the permission gate before delivering any event; if the extension’s PermissionSet does not include this permission, HookBus::subscribe() returns an error.

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for HookKind

impl Hash for HookKind

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

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for HookKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HookKind