agent

type Agent interface {
	// Name returns the agent identifier (e.g., "claude", "cursor", "codex").
	Name() string

	// DecodeHookInput parses the agent's native hook stdin JSON into a HookEvent.
	DecodeHookInput(input []byte) (*HookEvent, error)

	// EncodeAllow encodes an allow decision in the agent's native output format.
	EncodeAllow(event *HookEvent, reason string) ([]byte, error)

	// EncodeDeny encodes a deny decision in the agent's native output format.
	// The returned bytes are written to stdout, and the process exits with code 2.
	EncodeDeny(event *HookEvent, reason string) ([]byte, error)
}

type HookEvent struct {
	SessionID     string
	HookEventName string // "PreToolUse", "PostToolUse", "UserPromptSubmit"
	ToolName      string
	ToolInput     map[string]any
	ToolResponse  map[string]any // PostToolUse only
	ToolUseID     string
	CWD           string
}