hooks

type Config struct {
	// PreToolUse hooks run before tool execution
	PreToolUse []MatcherConfig `json:"pre_tool_use,omitempty" yaml:"pre_tool_use,omitempty"`

	// PostToolUse hooks run after tool execution
	PostToolUse []MatcherConfig `json:"post_tool_use,omitempty" yaml:"post_tool_use,omitempty"`

	// SessionStart hooks run when a session begins
	SessionStart []Hook `json:"session_start,omitempty" yaml:"session_start,omitempty"`

	// SessionEnd hooks run when a session ends
	SessionEnd []Hook `json:"session_end,omitempty" yaml:"session_end,omitempty"`
}

type Decision string

type EventType string

type Executor struct {
	// contains filtered or unexported fields
}

type Hook struct {
	// Type specifies whether this is a command or prompt hook
	Type HookType `json:"type" yaml:"type"`

	// Command is the shell command to execute (for command hooks)
	Command string `json:"command,omitempty" yaml:"command,omitempty"`

	// Timeout is the execution timeout in seconds (default: 60)
	Timeout int `json:"timeout,omitempty" yaml:"timeout,omitempty"`
}

type HookSpecificOutput struct {
	// HookEventName identifies which event this output is for
	HookEventName EventType `json:"hook_event_name,omitempty"`

	// PreToolUse fields
	PermissionDecision       Decision       `json:"permission_decision,omitempty"`
	PermissionDecisionReason string         `json:"permission_decision_reason,omitempty"`
	UpdatedInput             map[string]any `json:"updated_input,omitempty"`

	// PostToolUse/SessionStart fields
	AdditionalContext string `json:"additional_context,omitempty"`
}

type HookType string

type Input struct {
	// Common fields for all hooks
	SessionID     string    `json:"session_id"`
	Cwd           string    `json:"cwd"`
	HookEventName EventType `json:"hook_event_name"`

	// Tool-related fields (for PreToolUse and PostToolUse)
	ToolName  string         `json:"tool_name,omitempty"`
	ToolUseID string         `json:"tool_use_id,omitempty"`
	ToolInput map[string]any `json:"tool_input,omitempty"`

	// PostToolUse specific
	ToolResponse any `json:"tool_response,omitempty"`

	// SessionStart specific
	Source string `json:"source,omitempty"` // "startup", "resume", "clear", "compact"

	// SessionEnd specific
	Reason string `json:"reason,omitempty"` // "clear", "logout", "prompt_input_exit", "other"
}

type MatcherConfig struct {
	// Matcher is a regex pattern to match tool names (e.g., "shell|edit_file")
	// Use "*" to match all tools
	Matcher string `json:"matcher,omitempty" yaml:"matcher,omitempty"`

	// Hooks are the hooks to execute when the matcher matches
	Hooks []Hook `json:"hooks" yaml:"hooks"`
}

type Output struct {
	// Continue indicates whether to continue execution (default: true)
	Continue *bool `json:"continue,omitempty"`

	// StopReason is the message to show when continue=false
	StopReason string `json:"stop_reason,omitempty"`

	// SuppressOutput hides stdout from transcript
	SuppressOutput bool `json:"suppress_output,omitempty"`

	// SystemMessage is a warning to show the user
	SystemMessage string `json:"system_message,omitempty"`

	// Decision is for blocking operations
	Decision string `json:"decision,omitempty"`

	// Reason is the message explaining the decision
	Reason string `json:"reason,omitempty"`

	// HookSpecificOutput contains event-specific fields
	HookSpecificOutput *HookSpecificOutput `json:"hook_specific_output,omitempty"`
}

type Result struct {
	// Allowed indicates if the operation should proceed
	Allowed bool

	// Message is feedback to include in the response
	Message string

	// ModifiedInput contains any modifications to tool input (PreToolUse only)
	ModifiedInput map[string]any

	// AdditionalContext is context to add (PostToolUse/SessionStart)
	AdditionalContext string

	// SystemMessage is a warning to show the user
	SystemMessage string

	// ExitCode is the exit code from the hook command (0 = success, 2 = blocking error)
	ExitCode int

	// Stderr contains any error output from the hook
	Stderr string
}