config

type Config struct {
	// Instructions is the list of project-instruction files (e.g. AGENTS.md)
	// whose contents the agent prepends to the system prompt.
	Instructions []string

	// Model is the default "<provider>/<model>" string. The prefix selects the
	// provider adapter (ADR-0005); the suffix is the provider-native model id.
	Model string

	// Providers maps a provider id (anthropic, openai, local, custom…) to its
	// resolved options. The id is the opencode.json key under "provider".
	Providers map[string]Provider

	// Permission is the parsed permission ruleset (ADR-0007).
	Permission Permission

	// Embedder configures the embedding model used for memory (ADR-0004).
	// Absent means memory is disabled.
	Embedder Embedder

	// Memory configures the on-disk memory store (ADR-0003).
	Memory Memory

	// Context configures the token budget and window (ADR-0008).
	Context Context

	// Coordination configures the subagent symbol coordinator (change 0013).
	Coordination Coordination

	// TUI configures the front-end's appearance (change 0017).
	TUI TUI

	// Max configures Max Mode, the best-of-N sampler (change 0016).
	Max Max

	// MCP maps a server name to its declaration (change 0015). Empty means no
	// MCP servers. The name prefixes that server's tool names.
	MCP map[string]MCPServer

	// LSP configures the language servers behind the LanguageService port
	// (change 0026, ADR-0017). Opt-in: absent means no server is ever spawned.
	LSP LSP
}

type Context struct {
	// Budget is the soft token ceiling for assembled context.
	Budget int
	// Window is the model's full context window, used for the checkpoint
	// high-water mark.
	Window int
}

type Coordination struct {
	// Backend selects the coordinator: "native" (default, ships with OpenPlus),
	// "grit" (external binary), or "none" (disable coordinated fan-out).
	Backend string
}

type Embedder struct {
	Model   string
	BaseURL string
	APIKey  string
	// Timeout bounds a single Embed call when no caller-supplied http.Client
	// is set. Zero means embed.DefaultTimeout (30s).
	Timeout time.Duration
}

type LSP struct {
	// Enabled turns the LanguageService on. Off by default — a coding agent
	// must not start subprocesses the user did not ask for.
	Enabled bool

	// Servers maps a file extension (including the dot, e.g. ".go") to the
	// language server that handles it.
	Servers map[string]LSPServer
}

type LSPServer struct {
	Command string
	Args    []string
}

type MCPServer struct {
	// Name is the config key, carried here so an error can name the server.
	Name string
	// Transport is MCPTransportStdio or MCPTransportHTTP.
	Transport string

	// Command, Args, Env and Dir describe a stdio subprocess.
	Command string
	Args    []string
	Env     map[string]string
	Dir     string

	// URL and Headers describe a streamable-HTTP endpoint.
	URL     string
	Headers map[string]string
}

type Max struct {
	// Samples is the default N for /max. Zero means orchestrate.DefaultSamples;
	// a value above the cap is clamped at use, with the clamp reported.
	Samples int
	// Model is the judge model id ("<provider>/<model>"). Empty judges with the
	// session's model — an independent judge is better, but requiring one would
	// make Max Mode unusable on a single-model setup.
	Model string
}

type Memory struct {
	// Path is the database file, relative to the project root when not absolute.
	Path string
	// AutoOpen creates the file (and its parent directory) if it does not
	// exist. Default false: a missing path is a configuration error, not a
	// silent side effect. Set true in opencode.json to opt in.
	AutoOpen bool
	// MaxEntries caps the stored chunks; oldest are pruned first on each
	// write. Zero means unbounded.
	MaxEntries int
}

type Model struct {
	Name string
}

type Permission struct {
	Tools map[string]string
	Paths map[string]string
}

type ProjectContext struct {
	// Root is the project root the context was loaded from.
	Root string
	// Config is the parsed opencode.json. Never nil: a project without the file
	// gets a zero-value Config.
	Config *Config
	// Instructions is the concatenated content of the instruction files, each
	// under a header naming its source file.
	Instructions string
}

type Provider struct {
	// ID is the opencode.json key (anthropic, openai, local, …).
	ID string

	// Name is the optional human label (opencode.json provider.<id>.name).
	Name string

	// BaseURL is options.baseURL after {env:VAR} expansion. Empty means the
	// provider's default endpoint (e.g. api.anthropic.com for the anthropic id).
	BaseURL string

	// APIKey is options.apiKey after {env:VAR} expansion.
	APIKey string

	// Models maps the provider-native model id to its display name.
	Models map[string]Model
}

type TUI struct {
	// Theme names the initial palette ("default", "deutan", "protan",
	// "tritan"). Empty means the front-end's default; an unknown name falls
	// back to it with a warning rather than failing the session, because an
	// appearance setting must never block work.
	Theme string
}