Struct HookMetadata 

pub struct HookMetadata {
    pub entity_type: Option<&'static str>,
    pub phase: HookPhase,
}

Metadata describing what dispatch context a hook name belongs to. See module docs.

Fields

entity_type: Option<&'static str>

Entity type the hook applies to ("tool", "llm", "prompt", "resource"). None means “applies regardless of entity_type” — used for hooks that don’t tie to MCP’s entity-type taxonomy.

phase: HookPhase

Lifecycle phase the hook occupies.

Implementations

impl HookMetadata

pub const fn unknown() -> Self

Default — entity_type: None, phase: Unphased. Used as the fallback for hook names not in the registry. The matches function treats Unphased as “matches any phase,” so unknown hooks dispatch on the first registered entry.

pub fn matches( &self, request_entity_type: Option<&str>, requested_phase: HookPhase, ) -> bool

Whether this hook’s metadata matches a dispatch context.

Matching rules:

• entity_type: a hook tied to a specific entity_type (Some("tool")) matches only contexts with that entity type. A hook with entity_type: None matches any context. A request without an entity_type (None) matches any hook — the dispatcher hasn’t specified what entity is in play, so we can’t filter on it.
• phase: exact match between hook’s phase and the requested phase, EXCEPT Unphased is a wildcard from either side (lets custom / unregistered hooks dispatch without phase rules).

Trait Implementations

impl Clone for HookMetadata

fn clone(&self) -> HookMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HookMetadata

impl Debug for HookMetadata

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

Formats the value using the given formatter.

impl Eq for HookMetadata

impl PartialEq for HookMetadata

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HookMetadata