hookx

type Event string

type Hook struct {
	// Command 子进程 argv（直传无 shell）。
	Command []string
	// Events 事件匹配："*"（全部）、"|"分隔精确名（"pre_tool_use|post_tool_use"）、
	// "/正则/" 形态（"/.*tool.*/"）。空 = "*"。
	Events string
	// Timeout ≤0 → DefaultTimeout。
	Timeout time.Duration
	// Env 追加透传的环境变量白名单（叠加 procx 基础集）。
	Env []string
}

type Input struct {
	Event     Event          `json:"event"`
	Tool      string         `json:"tool,omitempty"`
	ToolInput any            `json:"input,omitempty"`
	Extra     map[string]any `json:"extra,omitempty"` // 调用方附带上下文（会话 id 等）
}

type Output struct {
	Continue      *bool  `json:"continue,omitempty"`
	StopReason    string `json:"stopReason,omitempty"`
	Reason        string `json:"reason,omitempty"`
	Decision      string `json:"decision,omitempty"` // "approve" | "block"
	SystemMessage string `json:"systemMessage,omitempty"`
	// 附加上下文（两种拼写都收——事实标准里两代拼写并存）。
	AdditionalContext  string    `json:"additionalContext,omitempty"`
	AdditionalContext2 string    `json:"additional_context,omitempty"`
	HookSpecificOutput *Specific `json:"hookSpecificOutput,omitempty"`
}

type RunResult struct {
	AdditionalContexts []string
	// BlockRequested 任一 hook 请求阻断。
	BlockRequested bool
	// PreventContinuation 阻断且该事件不允许继续（PreToolUse/PermissionRequest）。
	PreventContinuation bool
	StopReason          string
	// StopShouldContinue Stop 事件上 hook 否决停止（continue:false 或
	// decision:block——block 分支沿用阻断语义）。
	StopShouldContinue bool
	// PermissionBehavior "" | "allow" | "deny"（deny 单调——保守合并）。
	PermissionBehavior string
	// UpdatedInput 最后一个改写输入（nil=未改写）。
	UpdatedInput any
}

type Runner struct {
	Hooks []Hook
	// OnError hook 执行失败回调（nil=静默容错）。
	OnError func(h Hook, err error)
}

type Specific struct {
	HookEventName Event `json:"hookEventName"`
	// UpdatedInput 改写后的工具输入（消费方须以改写输入重走许可链）。
	UpdatedInput any `json:"updatedInput,omitempty"`
}