codex

type HookInput struct {
	HookEventName string `json:"hook_event_name"`
	Prompt        string `json:"prompt"`
	CWD           string `json:"cwd"`
}

type HookOptions struct {
	Client   string
	Mode     string
	Auto     bool
	CWD      string
	Prompt   string
	Language string
	Timeout  time.Duration
	History  []enhancer.Message
	// Inject makes a manual `pe` trigger inject the enhanced prompt as
	// additional context (exit 0, hookSpecificOutput.additionalContext) instead
	// of holding the original with a clipboard/preview review. Codex CLI
	// consumes UserPromptSubmit additionalContext into the model context, so
	// this is a real injection there. Default false preserves the review model.
	Inject bool
	// MaxContextTokens forwards the consumer-layer global token budget
	// (config.Config.MaxContextTokens, sourced from
	// OPENPE_MAX_CONTEXT_TOKENS) into enhancer.Request.Options. Zero
	// means "no budget" so this field is purely additive — callers that
	// do not set it preserve the historical unbounded behaviour.
	MaxContextTokens int
	CacheDir         string
	// SpecsDir / SpecMaxChars configure explicit user prompt-spec loading
	// (`pe+<name> <task>`, config.Config.Specs). Empty dir means the per-user
	// default ~/.config/openpe/specs; MaxChars <= 0 means the specs package
	// default. Spec resolution failures BLOCK the enhancement (business
	// contract D7: never silently drop a user-named spec).
	SpecsDir     string
	SpecMaxChars int
}

type HookOutput struct {
	Continue           bool                `json:"continue,omitempty"`
	Decision           string              `json:"decision,omitempty"`
	Reason             string              `json:"reason,omitempty"`
	SystemMessage      string              `json:"systemMessage,omitempty"`
	HookSpecificOutput *HookSpecificOutput `json:"hookSpecificOutput,omitempty"`
	TerminalPreview    string              `json:"-"`
	PreviewPrompt      string              `json:"-"`
	// Warnings carries enhancer.Response.Warnings (out-of-context numbers /
	// undecided actions / language guard) so the runner folds them into the
	// user-facing disclosure before the user acts on the enhancement. Not part
	// of the wire JSON.
	Warnings []string `json:"-"`
	// AppliedSpecs lists the user spec names appended to the enhanced prompt
	// (`pe+<name>`), so the runner can disclose "applied specs: …" alongside
	// the delivery status. Not part of the wire JSON.
	AppliedSpecs []string `json:"-"`
}

type HookSpecificOutput struct {
	HookEventName     string `json:"hookEventName"`
	AdditionalContext string `json:"additionalContext,omitempty"`
}

type Mode = manual.Mode