tui

type FallbackProvider struct {
	Provider string
	APIKey   string
}

type FileTickMsg struct{}

type GenerationDoneMsg struct {
	Err error
}

type GenerationProgressMsg struct {
	File   string
	Status string // "writing", "done", "error"
}

type Step interface {
	// Title returns the step's display title.
	Title() string
	// Icon returns the step's icon/emoji.
	Icon() string
	// Init returns the initial command for this step.
	Init() tea.Cmd
	// Update handles messages and returns the updated step and command.
	Update(msg tea.Msg) (Step, tea.Cmd)
	// View renders the step content.
	View(width int) string
	// Complete returns true when the step has finished.
	Complete() bool
	// Summary returns a one-line summary for the collapsed view.
	Summary() string
	// Apply writes collected data to the wizard context.
	Apply(ctx *WizardContext)
}

type StepBackMsg struct{}

type StepCompleteMsg struct{}

type StyleSet struct {
	Theme TermTheme

	// Text styles
	Title        lipgloss.Style
	Subtitle     lipgloss.Style
	AccentTxt    lipgloss.Style
	DimTxt       lipgloss.Style
	SuccessTxt   lipgloss.Style
	WarningTxt   lipgloss.Style
	ErrorTxt     lipgloss.Style
	PrimaryTxt   lipgloss.Style
	SecondaryTxt lipgloss.Style

	// Border styles
	ActiveBorder   lipgloss.Style
	InactiveBorder lipgloss.Style

	// Item styles
	SelectedItem   lipgloss.Style
	UnselectedItem lipgloss.Style
	Cursor         lipgloss.Style

	// Kbd hint
	KbdKey  lipgloss.Style
	KbdDesc lipgloss.Style

	// Banner
	Banner lipgloss.Style

	// Summary
	SummaryKey   lipgloss.Style
	SummaryValue lipgloss.Style

	// Bordered box
	BorderedBox lipgloss.Style

	// Badge styles (filled background with contrasting text)
	StepBadgeComplete lipgloss.Style
	StepBadgeActive   lipgloss.Style
	StepBadgePending  lipgloss.Style

	// Version pill
	VersionPill lipgloss.Style
}

type TermTheme struct {
	Name string

	// Brand
	Accent    lipgloss.Color
	AccentDim lipgloss.Color

	// Semantic
	Success lipgloss.Color
	Warning lipgloss.Color
	Error   lipgloss.Color

	// Text
	Primary   lipgloss.Color
	Secondary lipgloss.Color
	Dim       lipgloss.Color

	// Surfaces
	Surface      lipgloss.Color
	Border       lipgloss.Color
	ActiveBorder lipgloss.Color
	ActiveBg     lipgloss.Color
}

type ValidationResultMsg struct {
	Err error
}

type WizardContext struct {
	Name           string
	Provider       string
	APIKey         string
	AuthMethod     string // "apikey" or "oauth" — how the user authenticated
	ModelName      string // selected model ID (e.g. "gpt-5.4")
	OrganizationID string // OpenAI enterprise organization ID
	AWSRegion      string // AWS region for provider "bedrock" (model.aws_region, #205)
	Fallbacks      []FallbackProvider
	Channel        string
	ChannelTokens  map[string]string
	BuiltinTools   []string
	Skills         []string
	EgressDomains  []string
	CustomBaseURL  string
	CustomModel    string
	CustomAPIKey   string
	// CustomShape selects which wire format the custom-URL endpoint
	// speaks — "openai" (default; OpenAI Chat Completions, used by
	// litellm / vLLM / OpenRouter / self-hosted Llama proxies) or
	// "anthropic" (Anthropic Messages format, used by Bedrock's
	// Anthropic passthrough and by Anthropic-compatible proxies).
	// Drives whether normalizeCustomProvider sets ModelProvider to
	// "openai" or "anthropic" and which BASE_URL / API_KEY env names
	// are emitted to .env. See issue #202 Phase 1.
	CustomShape string
	EnvVars     map[string]string

	// Compression enables reversible context compression (ctxzip): bulky
	// tool outputs are compressed before reaching the LLM and stay
	// retrievable via the context_expand tool. Written to forge.yaml as
	// compression.enabled.
	Compression bool

	// AuthMode is the user's selection from the auth step:
	//   ""             — wizard step did not run
	//   "none"         — anonymous access (no auth: block written)
	//   "oidc"         — OIDC provider
	//   "http_verifier" — legacy external verifier
	//   "custom"       — write a commented stub; user edits manually
	AuthMode string

	// AuthSettings is the type-specific settings block for the chosen
	// provider, ready to plug into `auth.providers[0].settings` in
	// forge.yaml. Keys: "issuer", "audience", "url", "default_org",
	// "claim_map" (a nested map), etc.
	AuthSettings map[string]any

	// AuthEgressHosts is the list of bare hosts (no port) that should be
	// auto-added to the egress allowlist because the auth step requires
	// them — e.g. an OIDC issuer or http_verifier URL. The init scaffold
	// merges these into the rendered forge.yaml egress.allowed_domains.
	AuthEgressHosts []string
}

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