config

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

type CacheConfig struct {
	// AnthropicTTL sets the time-to-live for Anthropic's explicit
	// cache_control breakpoints: "5m" (Anthropic's own default) or "1h".
	// Empty behaves identically to "5m" — the field is simply omitted
	// from the request and Anthropic applies its server-side default.
	//
	// A longer TTL matters for two cases: sessions resumed more than 5
	// minutes after the last turn, and Plan/Auto mode round-trips when
	// [router] routes them to different models — both otherwise pay a
	// full uncached reprocess the moment the 5-minute window lapses.
	// The tradeoff is cost, not correctness: Anthropic bills a 1h cache
	// write at 2x base instead of 1.25x. See
	// yottacode-roadmap/prompt-caching.md.
	//
	// Anthropic-only. OpenAI/Gemini/xAI/Copilot manage their own cache
	// eviction with no client-exposed TTL, so this has no effect there.
	AnthropicTTL string `toml:"anthropic_ttl"`
}

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

type Config struct {
	Context     ContextConfig     `toml:"context"`
	Retrieval   RetrievalConfig   `toml:"retrieval"`
	Cache       CacheConfig       `toml:"cache"`
	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"`
	// LSP carries optional command overrides for the experimental
	// language-server code-intelligence tools. Defaults remain built in;
	// this only exists for Nix/devcontainer/custom-toolchain paths.
	LSP LSPConfig `toml:"lsp"`
	// 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"`
	// Subagents tunes the subagent subsystem (the Agent tool + background
	// runs). Absent block falls through to the defaults below.
	Subagents SubagentsConfig `toml:"subagents"`
	// Sandbox controls whether run_bash executes inside a session-scoped
	// podman container instead of directly on the host. Absent block or
	// backend="none" (the default) keeps today's host-exec behavior; gated
	// behind the "sandbox" experimental feature regardless of backend.
	Sandbox SandboxConfig `toml:"sandbox"`
}

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

type LSPConfig struct {
	Servers  map[string][]string `toml:"servers"`
	Disabled []string            `toml:"disabled"`
}

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"`

	// Transport selects how the server is reached. "" (the zero value)
	// and "stdio" both mean stdio; "http" and "sse" dial URL instead of
	// spawning Command. See Validate for which fields each transport
	// requires.
	Transport string `toml:"transport"`

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

	// Args are passed to Command verbatim. Typical shape:
	//   command = "npx"
	//   args    = ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
	// stdio only.
	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. stdio only.
	Env map[string]string `toml:"env"`

	// URL is the server's HTTP/SSE endpoint. Required when Transport is
	// "http" or "sse"; ignored for stdio.
	URL string `toml:"url"`

	// Headers are set on every outgoing request to URL — e.g. an
	// Authorization bearer token. http/sse only.
	Headers map[string]string `toml:"headers"`

	// 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"`

	// CaptureReminderEveryTurns rides a memory-capture reminder on every
	// Nth user message (history-only, like the pre-compaction reminder)
	// so sessions that never hit the summarize watermark still get
	// periodic reinforcement to persist durable learnings. It is not an
	// extra turn and not a per-turn nudge — it appends to a message the
	// user was sending anyway. 0 disables. Default 6.
	CaptureReminderEveryTurns int `toml:"capture_reminder_every_turns"`
}

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)
	//   vertex              — Gemini on Google Vertex AI, via the
	//                         project's OpenAI-compatible chat shim
	//   vertex-anthropic    — Claude on Google Vertex AI, via
	//                         :streamRawPredict (native Messages API)
	//
	// The two vertex kinds authenticate with Application Default
	// Credentials rather than an api_key_env, and carry their GCP project
	// and location inside base_url.
	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"`

	// SessionRecall governs automatic recall of prior conversations — the
	// episodic counterpart to the memory retrieval above. When enabled, each
	// turn semantically searches past sessions and injects the most relevant
	// excerpts into the system prompt, so the agent "remembers" earlier
	// discussions without the model having to call session_recall itself.
	SessionRecall SessionRecallConfig `toml:"session_recall"`
}

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 an advisor and an
	// implementer model. "off" (default) disables it entirely. "manual"
	// resolves the role models but only routes when an agent declares an
	// explicit model. "auto" makes the advisor the reasoning/planning model
	// and the implementer the fast coding/subagent/summarization model. The
	// router changes the main-thread model only at explicit session/mode
	// boundaries; child/advisor-consult contexts are isolated.
	Mode string `toml:"mode"`
	// AdvisorModel and ImplementerModel name the role models as
	// "<provider>" or "<provider>:<model>" (same grammar as Candidates).
	// Required when Mode is not "off" (unless the plural form is set).
	AdvisorModel     string `toml:"advisor_model"`
	ImplementerModel string `toml:"implementer_model"`
	// AdvisorModels and ImplementerModels are failover-chain forms: the
	// first entry is the primary, the rest are fallbacks tried in order
	// when the primary fails. A slot may set the singular OR plural form,
	// not both. Empty plural → the singular is used as a one-element chain.
	AdvisorModels     []string `toml:"advisor_models"`
	ImplementerModels []string `toml:"implementer_models"`
	// Fast*/Smart* are legacy aliases for Implementer*/Advisor* kept so
	// existing configs load. New writes use the role-named fields.
	FastModel   string   `toml:"fast_model"`
	SmartModel  string   `toml:"smart_model"`
	FastModels  []string `toml:"fast_models"`
	SmartModels []string `toml:"smart_models"`
}

type SandboxConfig struct {
	Backend        string   `toml:"backend"` // "none" (default) | "podman"
	Image          string   `toml:"image"`
	Network        string   `toml:"network"` // "none" (default) | "host"
	Mounts         []string `toml:"mounts"`
	EnvPassthrough []string `toml:"env_passthrough"`
	Memory         string   `toml:"memory"`
	CPUs           float64  `toml:"cpus"`
	PidsLimit      int      `toml:"pids_limit"`
}

type SessionRecallConfig struct {
	// Auto enables per-turn injection. Default true. Set to false to keep the
	// manual session_recall tool but stop automatic injection.
	Auto bool `toml:"auto"`

	// Scope restricts which sessions are searched: "project" (sessions from
	// the current repository — its root and everything below it, so a session
	// started in a subdirectory still counts; the safe default that never
	// mixes projects), "user"/"all" (the whole local store). Empty defaults to
	// "project".
	Scope string `toml:"scope"`

	// TopK caps how many prior-conversation excerpts are injected per turn.
	// Default 3; 0 injects nothing (unlike max_bytes below, where 0 means
	// "no bound" — a cap of zero excerpts reads as none, so that is what it
	// does).
	TopK int `toml:"top_k"`

	// MinScore is the cosine-similarity floor (0.0–1.0) an excerpt must clear
	// to be injected. Default 0.6 — calibrated for nomic-embed-text, whose
	// cosines are compressed (a strongly on-topic paraphrase lands ~0.65,
	// unrelated text ~0.37). High enough that only genuinely relevant prior
	// conversations surface, so the block stays empty when nothing matches
	// rather than padding the prompt with noise.
	MinScore float64 `toml:"min_score"`

	// MaxBytes caps the combined size of the injected block. Default 2000.
	// 0 removes the byte bound (TopK still applies).
	MaxBytes int `toml:"max_bytes"`
}

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

type SubagentsConfig struct {
	SessionTokenBudget int `toml:"session_token_budget"`
}

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