devin

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, JSON hookSpecificOutput) instead of blocking
	// the original message with a clipboard/preview handoff. Devin consumes
	// additionalContext natively. (Codex CLI and Claude Code CLI also consume
	// UserPromptSubmit additionalContext — so the unified inject switch covers
	// them too; only Windsurf cannot, and there the switch is a no-op.) The
	// default (false) preserves the review/clipboard behaviour for all clients.
	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.
	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 (language guard + content
	// warnings) so the runner can fold them into the user-facing disclosure
	// (block Reason / inject SystemMessage). 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