wizard

type CatalogEntry struct {
	// Name is the user-facing label that appears in the wizard and
	// becomes [[providers]].name in config.toml. Used by /provider use.
	Name string

	// Kind is the adapter family. Must be one of
	// internal/config.ValidKinds (anthropic | openai | gemini | xai | ollama
	// | openai-compatible). Drives both adapter dispatch and whether
	// the wizard's stepConfigure pulls a curated model list from
	// internal/catalog (anthropic/openai/gemini/xai) or falls back to
	// free-form text input (ollama, openai-compatible).
	Kind string

	// BaseURL is the API endpoint. For Anthropic / Gemini we route by
	// model prefix as well, so the base URL is informational; for
	// OpenAI-compatible endpoints the URL is the routing decision.
	BaseURL string

	// APIKeyEnv is the env-var name that holds the bearer token.
	// Empty for Ollama (local, no key). The wizard prompts for the
	// value when the variable is not already set in the environment.
	APIKeyEnv string

	// Note is a one-line hint shown next to the provider in the
	// multi-select. Keep short — anything longer than 50 chars wraps
	// awkwardly on narrow terminals.
	Note string
}

type EmbeddingModelInfo struct {
	Name string
	Desc string
	Size string
}

type EnvSnapshot struct {
	// Present maps env-var name → true for every key in os.Environ
	// that matches a known catalog entry's APIKeyEnv. Used to skip
	// the key-prompt step and to render "key present in env" badges.
	Present map[string]bool

	// SuggestedProviders is the set of catalog entry names whose key
	// is in Present, plus "ollama" if the local probe responded.
	// Order follows Catalog so the UI is deterministic.
	SuggestedProviders []string
}

type OllamaProbeResult struct {
	Reachable bool
	BaseURL   string   // the URL probed
	Models    []string // models reported by /api/tags, if any
	Err       error    // last error encountered (for diagnostics)
}

type Options struct {
	// Force replaces an existing config.toml (after backing up).
	// Without this flag, the wizard merges into the existing file.
	Force bool

	// PrintOnly renders the would-be config.toml + .env plan to
	// out and returns without writing anything.
	PrintOnly bool

	// SkipValidation suppresses the per-key validation pings.
	SkipValidation bool

	// NonInteractive accepts defaults and never prompts. Required
	// fields that can't be resolved from flags + env + catalog
	// produce an error rather than a prompt.
	NonInteractive bool

	// FromEnv pre-enables every catalog entry whose API key is in
	// the live environment, with the catalog's default model.
	// Useful in CI / dotfile bootstrap. Composes with -y.
	FromEnv bool

	// Providers is the comma-separated list passed via --provider.
	// Empty means "let the wizard ask."
	Providers []string

	// Active is the "<provider>" or "<provider>:<model>" form passed
	// via --active.
	Active string

	// EnableRouter / RouterPolicy / NoRouter mirror the flags. The
	// EnableRouter+NoRouter pair is enforced mutually-exclusive at
	// the cobra layer.
	EnableRouter bool
	RouterPolicy string
	NoRouter     bool

	// ConfigPath / EnvPath override defaults (~/.yottacode/...).
	ConfigPath string
	EnvPath    string

	// SkipEnvWrite prevents .env from being written. The wizard
	// still records api_key_env names on each provider so the
	// runtime knows where to look.
	SkipEnvWrite bool

	// Out is where stdout-style messages go: "wrote /path", the
	// print-only TOML body, the post-write hint. nil → os.Stdout.
	Out io.Writer
}

type Plan struct {
	// Providers is the ordered list of enabled providers. Order
	// matters: it's the candidate order for fallback-chain routing
	// and the display order in /provider list.
	Providers []PlanProvider

	// Active picks the session-default provider:model. ActiveProvider
	// must match one of Providers[].Name; ActiveModel must be present
	// in that provider's Models.
	ActiveProvider string
	ActiveModel    string

	// EnableRouter and Router* control the [router] config block.
	EnableRouter   bool
	RouterPolicy   string   // "fallback-chain" | "cheap-first"
	RouterCandList []string // each "<provider>" or "<provider>:<model>"

	// EnvKeys maps env-var name → secret value the user entered
	// during the wizard. Already-set environment values are NOT in
	// this map: we never copy a live key from os.Environ to .env.
	// Keys here are written to ~/.yottacode/.env (chmod 0600).
	EnvKeys map[string]string

	// SkipEnvWrite, when true, suppresses the .env write entirely.
	// The wizard still records api_key_env names on each provider so
	// the runtime knows where to look — values are expected to come
	// from the live shell or a secrets manager.
	SkipEnvWrite bool

	// RetrievalStrategy is the retrieval scoring strategy set by the
	// wizard. Empty means "wizard didn't touch retrieval; preserve
	// disk." Non-empty overrides [retrieval].strategy in config.toml.
	RetrievalStrategy string

	// EmbeddingModel is the Ollama embedding model chosen during
	// setup. Empty means "wizard didn't set one; preserve disk."
	// Non-empty overrides [retrieval].embedding_model.
	EmbeddingModel string
}

type PlanProvider struct {
	Name         string
	Kind         string
	BaseURL      string
	APIKeyEnv    string
	DefaultModel string

	// EnvAlreadySet is true when the wizard saw the API key already
	// present in os.Environ. Purely informational — it's how the
	// review screen says "key present in env" instead of "saved to
	// .env."
	EnvAlreadySet bool
}

type ValidationResult struct {
	Status     ValidationStatus
	HTTPStatus int    // 0 when no response (DNS / timeout)
	Detail     string // short message — "ok", "401 Unauthorized", "timeout", …
}

type ValidationStatus int

type WriteOptions struct {
	// ConfigPath defaults to ~/.yottacode/config.toml. Override for
	// `--config /custom/path.toml` and tests.
	ConfigPath string

	// EnvPath defaults to ~/.yottacode/.env. Override for
	// `--env-file` and tests.
	EnvPath string

	// Force=true backs up an existing config.toml to
	// `<path>.bak-<unix-ts>` and replaces it. With Force=false the
	// writer attempts a structural merge (existing tunables
	// preserved; providers union'd by name).
	Force bool

	// SkipEnvWrite skips the .env step entirely. Mirrors
	// Plan.SkipEnvWrite — supplied separately so the CLI flag wins
	// independently of the Plan content.
	SkipEnvWrite bool
}

type WriteOutcome struct {
	ConfigPath  string
	EnvPath     string
	BackupPath  string // empty when no backup was made
	WroteConfig bool
	WroteEnv    bool
	WroteBackup bool
}