hook

type Hooks struct {
	PreToolUse        []PreToolUse
	PermissionRequest []PermissionRequest
	PostToolUse       []PostToolUse
	UserPromptSubmit  []UserPromptSubmit
	SessionStart      []SessionStart
	SessionEnd        []SessionEnd
	SubagentStart     []SubagentStart
	SubagentStop      []SubagentStop
	PreCompact        []PreCompact
	PostCompact       []PostCompact
	Stop              []Stop
}

type Outcome struct {
	// Block has event-specific Codex semantics: deny a tool/prompt, stop the
	// agentic loop, or continue a Stop/SubagentStop target.
	Block bool
	// Stop represents the universal {"continue": false} response.
	Stop              bool
	Reason            string
	AdditionalContext []string
	// UpdatedResult is an internal extension used by deterministic result
	// transforms such as truncation. Codex command hooks leave it nil.
	UpdatedResult *string
}

type PermissionBehavior string

type PermissionRequest func(ctx context.Context, call tool.ToolCall) (PermissionRequestOutcome, error)

type PermissionRequestOutcome struct {
	Behavior PermissionBehavior
	Message  string
}

type PostCompact func(ctx context.Context, trigger string) (Outcome, error)

type PostToolUse func(ctx context.Context, call tool.ToolCall, result string) (Outcome, error)

type PreCompact func(ctx context.Context, trigger string) (Outcome, error)

type PreToolUse func(ctx context.Context, call tool.ToolCall) (PreToolUseOutcome, error)

type PreToolUseOutcome struct {
	Outcome
	UpdatedInput json.RawMessage
}

type Runtime struct {
	SessionID      string
	TurnID         string
	TranscriptPath string
	CWD            string
	Model          string
	PermissionMode string
	StartSource    string
	AgentID        string
	AgentType      string
}

type SessionEnd func(ctx context.Context, reason string)

type SessionStart func(ctx context.Context, source string) (Outcome, error)

type Stop func(ctx context.Context, lastAssistantMessage string, active bool) (Outcome, error)

type SubagentStart func(ctx context.Context, agentID, agentType string) (Outcome, error)

type SubagentStop func(ctx context.Context, agentID, agentType, result string, active bool) (Outcome, error)

type UserPromptSubmit func(ctx context.Context, prompt string) (Outcome, error)