config

type ClaudeConfig struct {
	Transcript ClaudeTranscriptConfig
}

type ClaudeTranscriptConfig struct {
	Enabled     bool
	MaxMessages int
	MaxChars    int
}

type CodexConfig struct {
	History CodexHistoryConfig
}

type CodexHistoryConfig struct {
	Enabled     bool
	Home        string
	MaxMessages int
	MaxChars    int
}

type Config struct {
	BaseURL    string
	APIKey     string
	Model      string
	ListenAddr string
	Timeout    time.Duration
	Language   string
	// MaxContextTokens is the consumer-layer global token budget. Each
	// caller path (codex / claude / windsurf hook, future patch inject)
	// forwards this value into enhancer.Request.Options.MaxContextTokens,
	// where enhancer.assemblePrompt applies section-level truncation
	// preserving required sections (original prompt, target client,
	// workspace, enhancement contract, final instruction) and shrinking
	// optional sections (history, rules, guidelines, context.files,
	// context.retrieval). Zero (the default) keeps the historical
	// "no budget" behaviour so this field is purely additive.
	MaxContextTokens int
	// MessageStyle selects the provider message layout: "flatten" (default —
	// [system, user] with history embedded as labeled text) or "hybrid"
	// ([system, prior user/assistant turns, final user task]). Sourced from
	// OPENPE_MESSAGE_STYLE. Unknown values fall back to "flatten" so the
	// historical, eval-validated layout stays the default until hybrid is
	// promoted by eval A/B.
	MessageStyle string
	// Provider selects the model provider wire protocol: "openai" (default,
	// OpenAI-compatible /v1/chat/completions) or "anthropic" (Anthropic Messages
	// API /v1/messages). Sourced from OPENPE_PROVIDER; unknown/empty → "openai"
	// so existing setups are unaffected.
	Provider string
	// MaxTokens caps the model's response length. It is required by the
	// Anthropic provider and ignored by the OpenAI one (which lets the gateway
	// default). Sourced from OPENPE_MAX_TOKENS; 0 (default) lets the provider
	// pick its own default.
	MaxTokens int
	// SystemPrompt, when non-empty, overrides the enhancer's built-in system
	// prompt. It is populated from OPENPE_SYSTEM_PROMPT_FILE (file contents,
	// preferred) or OPENPE_SYSTEM_PROMPT (inline). Empty (the default) keeps
	// the compiled-in enhancer.defaultSystemPrompt, so this field is purely
	// additive and lets operators iterate on the prompt without recompiling.
	SystemPrompt string
	// PromptStyle selects a built-in system-prompt preset by audience:
	// "agent" (default — compact prompt for the downstream coding agent) or
	// "human" (detailed report-style expansion for human reading; the
	// former v7h default kept verbatim). Sourced from OPENPE_PROMPT_STYLE.
	// An explicit SystemPrompt overrides it. The raw value is validated at
	// service construction (enhancer.ResolveSystemPrompt), where an unknown
	// style fails startup loudly instead of silently degrading to a default.
	PromptStyle string
	// LanguageGuard configures the enhancer's post-processing language-
	// preservation guard (see internal/enhancer.LanguageGuardConfig). Sourced
	// from OPENPE_LANGUAGE_GUARD_ENABLED / OPENPE_LANGUAGE_GUARD_REANCHOR.
	LanguageGuard LanguageGuardConfig
	// Warnings configures the deterministic output-side advisory checks
	// (out-of-context numbers / undecided irreversible actions — the
	// model-independent backstop behind the v7g/v7h prompt guardrails).
	// Sourced from OPENPE_WARNINGS_ENABLED (default true),
	// OPENPE_WARNINGS_ACTIONS (comma-separated extra action words) and
	// OPENPE_WARNINGS_NUM_MAXLEN (digit-run length cap, default 5).
	Warnings WarningsConfig
	// Specs configures explicit user prompt-spec loading (`pe+<name> <task>`).
	// Dir empty means the per-user default ~/.config/openpe/specs (resolved by
	// internal/specs.DefaultDir, kept out of this package like the other
	// mirror configs); MaxChars <= 0 means the specs package default.
	Specs SpecsConfig
	// Update configures the new-version notice and its background check
	// (docs/requirements/2026-08-25-version-and-update.md U2). Notice
	// defaults to true; the actual `openpe update` command is always
	// available regardless of this switch.
	Update       UpdateConfig
	Openace      OpenaceConfig
	Codex        CodexConfig
	Claude       ClaudeConfig
	Devin        DevinConfig
	Inject       InjectConfig
	Delivery     DeliveryConfig
	Server       ServerConfig
	HookDedup    HookDedupConfig
	HookDeadline time.Duration
}

type DeliveryConfig struct {
	CacheDir               string
	CopyCommand            string
	DisableOSC52Clipboard  bool
	OSC52TTY               string
	ClaudePromptFallback   bool
	WindsurfPromptFallback bool
}

type DevinConfig struct {
	History DevinHistoryConfig
}

type DevinHistoryConfig struct {
	Enabled     bool
	DBPath      string
	MaxMessages int
	MaxChars    int
	Recency     time.Duration
}

type HookDedupConfig struct {
	Enabled bool
	Window  time.Duration
}

type InjectConfig struct {
	Codex  bool
	Claude bool
	Devin  bool
}

type LanguageGuardConfig struct {
	Enabled  bool
	Reanchor bool
}

type OpenaceConfig struct {
	Enabled           bool
	Addr              string
	Token             string
	ProviderProfileID string
	MaxOutputLength   int
	Timeout           time.Duration
	MaxRetries        int
	RetryBaseDelay    time.Duration
	RetryMaxDelay     time.Duration
	RetryJitter       time.Duration
}

type ServerConfig struct {
	// Token, when non-empty, enables bearer-token authentication on the
	// HTTP server. Use a 256-bit hex string (e.g. produced by
	// integration.GenerateToken). When LifecycleEnabled is true and Token
	// is empty, openpe-server generates an ephemeral token at startup.
	Token string
	// CORSOrigins is the list of Origin headers the server reflects in
	// Access-Control-Allow-Origin. Comma-separated in env / .env. Special
	// values: "*" allows any origin, "null" allows Electron file:// webviews.
	CORSOrigins []string
	// LifecycleEnabled controls whether openpe-server writes a descriptor
	// file at startup so IDE installers can discover its base URL and token.
	// Default false — opt in only when integrating with a patch installer
	// (Windsurf, Cursor, ...). Enabling auto-generates an ephemeral token
	// when Token is empty.
	LifecycleEnabled bool
	// DescriptorFile overrides integration.DefaultDescriptorPath when set.
	// Only consulted when LifecycleEnabled is true.
	DescriptorFile string
}

type SpecsConfig struct {
	Dir      string
	MaxChars int
}

type UpdateConfig struct {
	Notice        bool
	CheckInterval time.Duration
}

type WarningsConfig struct {
	Enabled      bool
	ExtraActions []string
	NumMaxLen    int
}