config

type Active struct {
	Provider     string `toml:"provider"`
	Model        string `toml:"model"`
	DefaultModel string `toml:"default_model"`
}

type CheckpointsConfig struct {
	RetentionDays int `toml:"retention_days"`
}

type Config struct {
	Context     ContextConfig     `toml:"context"`
	Retrieval   RetrievalConfig   `toml:"retrieval"`
	Memory      MemoryConfig      `toml:"memory"`
	Router      RouterConfig      `toml:"router"`
	Active      Active            `toml:"active"`
	Providers   []Provider        `toml:"providers"`
	Checkpoints CheckpointsConfig `toml:"checkpoints"`
	// MCPServers lists Model Context Protocol servers launched at
	// session start. Each entry becomes a stdio subprocess whose
	// advertised tools register into the agent tool registry under
	// the mcp/<name>/<tool> namespace. v1 supports stdio transport
	// only; absence of a `transport` field means adding HTTP/SSE
	// later is non-breaking.
	MCPServers []MCPServer `toml:"mcp_servers"`
	Theme      ThemeConfig `toml:"theme"`
	// Experimental gates non-default features behind named opt-ins.
	// Mirrors the --experimental CLI flag and the
	// $YOTTACODE_EXPERIMENTAL env var. Each entry is a feature name
	// from internal/experimental; values must be `true` to enable.
	// Unrecognized names load without error and emit a startup
	// warning so graduated/removed feature names don't break old
	// configs.
	Experimental map[string]bool `toml:"experimental"`
	// Skills carries persistent Agent Skills preferences — currently
	// just the default-on list seeded into SkillTool.SetEnabled at
	// session start. Absent block keeps the default-off behavior so
	// users without preferences see today's small-prompt experience.
	Skills SkillsConfig `toml:"skills"`
}

type ContextConfig struct {
	WarnThreshold float64 `toml:"warn_threshold"`
	AutoThreshold float64 `toml:"auto_threshold"`
	DefaultWindow int     `toml:"default_window"`
}

type MCPServer struct {
	// Name is the unique identifier used in tool namespacing and in
	// the /mcp slash command. Must match mcpNameRE.
	Name string `toml:"name"`

	// Command is the executable that runs the MCP server. Resolved
	// via exec.LookPath at session start.
	Command string `toml:"command"`

	// Args are passed to Command verbatim. Typical shape:
	//   command = "npx"
	//   args    = ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
	Args []string `toml:"args"`

	// Env supplies additional environment variables to the subprocess
	// on top of yottacode's inherited environment. Values may use
	// $VAR substitution from yottacode's process env, resolved at
	// spawn time. Unresolved $VARs surface a startup warning but
	// don't fail load.
	Env map[string]string `toml:"env"`

	// Disabled skips this entry at session start without removing it
	// from the config file. Useful for temporarily quieting a
	// misbehaving server.
	Disabled bool `toml:"disabled"`
}

type MemoryConfig struct {
	// FinalTurnOnQuit, when true, runs one last agent turn on a
	// graceful exit (/quit or Ctrl+D while idle) prompting the model
	// to persist durable learnings via memory_save before the session
	// context is gone. The turn renders in the transcript like any
	// other and is skippable (Ctrl+C / Esc cancels it and quits).
	// Ctrl+C as the quit gesture always exits immediately without the
	// final turn. Default true; set false to make every exit immediate.
	FinalTurnOnQuit bool `toml:"final_turn_on_quit"`
}

type Model struct {
	// Name is the model identifier passed to the API (e.g.
	// "claude-sonnet-4-6"). Required.
	Name string `toml:"name"`

	// Tier is a coarse cost/capability bucket used by the future
	// auto-router. Empty means unspecified. Validated at load time
	// against the whitelist below.
	Tier string `toml:"tier"`

	// ContextWindow overrides yottacode's built-in context-window
	// table for this model. 0 means use the built-in fallback.
	ContextWindow int `toml:"context_window"`
}

type Provider struct {
	// Name is the user-chosen label for this configuration, unique
	// within the file. Used by /provider use <name>.
	Name string `toml:"name"`

	// Kind selects the adapter family. One of:
	//
	//   anthropic           — native Messages API (claude-*)
	//   openai              — OpenAI's own endpoints (chat completions
	//                         + responses; auto-routes for o-series and
	//                         gpt-5*)
	//   openai-compatible   — anything that speaks /v1/chat/completions
	//                         (vLLM, Llama Stack, OpenRouter, Together,
	//                         NVIDIA NIM, Groq, …)
	//   xai                 — xAI's OpenAI-compatible Grok endpoint
	//   ollama              — Ollama's local server (OpenAI-shim variant)
	Kind string `toml:"kind"`

	// BaseURL is the HTTPS endpoint for the API. For Anthropic this is
	// typically https://api.anthropic.com; for OpenAI-compatible
	// endpoints include the /v1 suffix where the upstream expects it.
	BaseURL string `toml:"base_url"`

	// APIKeyEnv is the name of the OS environment variable that holds
	// the bearer token. Empty for local providers like Ollama. Looked
	// up at adapter-construction time, NOT stored here.
	APIKeyEnv string `toml:"api_key_env"`

	// DefaultModel is the model name to adopt when /provider use
	// switches to this provider. Must appear in Models when set.
	DefaultModel string `toml:"default_model"`

	// Models is the catalog of models available through this provider.
	// Used by /model list and as the source of truth for the future
	// auto-router.
	Models []Model `toml:"models"`

	// APIKey is reserved as a tripwire: declaring it inline produces a
	// load-time error that points the user at .env. We don't read its
	// value — declaring it at all is the failure.
	APIKey string `toml:"api_key"`
}

type ResolvedCandidate struct {
	Provider Provider
	Model    string
	Tier     string
}

type RetrievalConfig struct {
	Enabled        bool    `toml:"enabled"`
	TopK           int     `toml:"top_k"`
	MaxBytes       int     `toml:"max_bytes"`
	MinScore       float64 `toml:"min_score"`
	Strategy       string  `toml:"strategy"`
	EmbeddingModel string  `toml:"embedding_model"`

	// SemanticWeight is the fraction of the "semantic" blend given to
	// embedding cosine similarity; BM25 keyword scoring gets the remaining
	// (1 - SemanticWeight). Range [0,1]; default 0.4 (the classic 60/40
	// BM25/cosine split). 0 = pure BM25, 1 = pure cosine. Only used when the
	// effective strategy is "semantic". The blended score is re-normalized
	// afterward, so only the ratio matters — one knob covers the full space.
	SemanticWeight float64 `toml:"semantic_weight"`
}

type RouterConfig struct {
	Enabled                bool     `toml:"enabled"`
	Policy                 string   `toml:"policy"`
	Candidates             []string `toml:"candidates"`
	HealthWindowSeconds    int      `toml:"health_window_seconds"`
	HealthFailureThreshold int      `toml:"health_failure_threshold"`

	// Mode controls cache-safe task routing between a smart and a fast
	// model. "off" (default) disables it entirely. "manual" resolves the
	// fast/smart models but only routes when an agent declares an explicit
	// model. "auto" additionally routes read-only/search subagents and
	// summarization to FastModel. Routing never touches the main-thread
	// model mid-conversation (that would invalidate the prompt cache and
	// cost more) — only isolated contexts are routed.
	Mode string `toml:"mode"`
	// FastModel and SmartModel name the cheap and capable models as
	// "<provider>" or "<provider>:<model>" (same grammar as Candidates).
	// Required when Mode is not "off".
	FastModel  string `toml:"fast_model"`
	SmartModel string `toml:"smart_model"`
}

type SkillsConfig struct {
	DefaultOn []string `toml:"default_on"`
}

type ThemeConfig struct {
	Name string `toml:"name"`
}