Enum HookInput 

pub enum HookInput {
    PreToolUse {
        tool_name: String,
        tool_input: Value,
        call_id: ToolCallId,
    },
    PostToolUse {
        tool_name: String,
        tool_input: Value,
        tool_output: ToolOutput,
        call_id: ToolCallId,
    },
    PostToolFailure {
        tool_name: String,
        tool_input: Value,
        error: String,
        call_id: ToolCallId,
    },
    UserPromptSubmit {
        prompt: String,
    },
    SessionStart {
        session_id: SessionId,
    },
    SessionEnd {
        session_id: SessionId,
        reason: String,
    },
    Stop {
        finish_reason: String,
    },
    SubAgentStart {
        agent_name: String,
    },
    PreCompact {
        trigger: String,
        tokens_before: u64,
    },
    PostCompact {
        trigger: String,
        tokens_after: u64,
    },
}

Hook 输入 — 每个 HookEvent 携带的上下文数据。

使用 enum 确保类型安全，Hook 实现方通过 match 获取精确类型。 所有变体均可序列化，支持跨进程 Hook（如 shell command hook）。

Examples

use katu_core::hook::{HookEvent, HookInput};
use katu_core::ToolCallId;
use serde_json::json;

let input = HookInput::PreToolUse {
    tool_name: "bash".into(),
    tool_input: json!({"command": "ls -la"}),
    call_id: ToolCallId::new("call_1"),
};
assert_eq!(input.event(), HookEvent::PreToolUse);
assert_eq!(input.tool_name(), Some("bash"));

Variants

PreToolUse

工具执行前。

Fields

tool_name: String

tool_input: Value

call_id: ToolCallId

PostToolUse

工具执行成功后。

Fields

tool_name: String

tool_input: Value

tool_output: ToolOutput

call_id: ToolCallId

PostToolFailure

工具执行失败后。

Fields

tool_name: String

tool_input: Value

error: String

call_id: ToolCallId

UserPromptSubmit

用户提交 prompt 前。

Fields

prompt: String

SessionStart

Session 开始。

Fields

session_id: SessionId

SessionEnd

Session 结束。

Fields

session_id: SessionId

reason: String

Stop

Agent loop 单步结束判定。

Fields

finish_reason: String

SubAgentStart

SubAgent 启动前。

Fields

agent_name: String

PreCompact

上下文压缩前。

Fields

trigger: String

tokens_before: u64

PostCompact

上下文压缩后。

Fields

trigger: String

tokens_after: u64

Implementations

impl HookInput

pub fn event(&self) -> HookEvent

返回此输入对应的事件类型。

pub fn tool_name(&self) -> Option<&str>

如果是 Tool 相关事件，返回工具名。

pub fn call_id(&self) -> Option<&ToolCallId>

如果是 Tool 相关事件，返回 call_id。

Trait Implementations

impl Clone for HookInput

fn clone(&self) -> HookInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookInput

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookInput

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HookInput

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

where __S: Serializer,

Serialize this value into the given Serde serializer.