Struct HookPayload 

pub struct HookPayload {
    pub tool_name: String,
    pub tool_input: Value,
    pub tool_response: Value,
    pub session_id: Option<String>,
    pub cwd: Option<String>,
    pub hook_event_name: Option<String>,
    pub transcript_path: Option<String>,
    pub permission_mode: Option<String>,
    pub tool_use_id: Option<String>,
}

PostToolUse hook payload from an AI coding assistant.

tool_response is serde_json::Value because Claude Code sends it as a JSON object (not a plain string). String-valued responses still deserialize correctly into Value::String.

Fields

tool_name: String

tool_input: Value

tool_response: Value

session_id: Option<String>

cwd: Option<String>

hook_event_name: Option<String>

Name of the hook event (e.g. “PostToolUse”).

transcript_path: Option<String>

Path to the conversation transcript file.

permission_mode: Option<String>

Permission mode the assistant is running in.

tool_use_id: Option<String>

Unique ID of the tool use that triggered this hook.

Implementations

impl HookPayload

pub fn tool_response_text(&self) -> String

Extract meaningful text content from the tool response.

Handles known Claude Code response shapes before falling back to raw JSON serialization:

• Value::String → inner text (legacy / simple tools)
• Read tool: {file: {content: "..."}} → the file content
• Text-bearing: {text: "..."} → the text value
• Stdout-bearing: {stdout: "..."} → stdout value
• Value::Null → empty string
• anything else → compact JSON serialization

Trait Implementations

impl Debug for HookPayload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookPayload

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.