Struct HookContext 

pub struct HookContext {
    pub session_id: String,
    pub transcript_path: PathBuf,
    pub cwd: PathBuf,
    pub hook_event_name: HookEvent,
    pub tool_name: String,
    pub tool_use_id: String,
    pub permission_mode: Option<String>,
    pub effort: Option<EffortLevel>,
    pub agent_id: Option<String>,
    pub agent_type: Option<String>,
}

Mirrors the PreToolUse / PostToolUse payload Claude Code sends to a hook on stdin. Field schema empirically verified against CC 2.1.142 (see docs/architecture.md, Appendix A).

Fields

session_id: String

transcript_path: PathBuf

cwd: PathBuf

hook_event_name: HookEvent

tool_name: String

Present on tool-use events; absent on session-level events like SubagentStop. Default to empty string so the same struct deserializes for both.

tool_use_id: String

permission_mode: Option<String>

effort: Option<EffortLevel>

agent_id: Option<String>

Present iff the call came from inside a subagent. This is the routing key.

agent_type: Option<String>

Subagent type name (e.g. “general-purpose”). Present iff agent_id is.

Implementations

impl HookContext

pub fn agent_key(&self) -> &str

"main" for the main agent, the agent_id otherwise. Stable per-agent routing key.

Trait Implementations

impl Clone for HookContext

fn clone(&self) -> HookContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookContext

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookContext

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.