cfg

type AwsSection struct {
	ReadOnly *bool `toml:"read_only"` // default: true (nil = not set → true)
}

type CellConfig struct {
	Cell     CellSection
	LLM      LLMSection     `toml:"llm"`
	Git      GitSection     `toml:"git"`
	Ports    PortsSection   `toml:"ports"`
	Op       OpSection      `toml:"op"`
	Aws      AwsSection     `toml:"aws"`
	Stealth  StealthSection `toml:"stealth"`
	Env      map[string]string
	Mise     map[string]string `toml:"mise"` // [mise] — keys map to MISE_<UPPER_KEY> env vars
	Volumes  []VolumeMount
	Packages PackagesSection
}

type CellSection struct {
	ImageTag         string   `toml:"image_tag"`
	Registry         string   `toml:"registry"`          // container registry; default: DefaultRegistry; env: DEVCELL_REGISTRY
	GUI              *bool    `toml:"gui"`               // default: true (nil = not set → true)
	Timezone         string   `toml:"timezone"`          // IANA tz (e.g. "Europe/Prague"); default: host $TZ
	Locale           string   `toml:"locale"`            // POSIX locale (e.g. "en_US.UTF-8"); default: "en_US.UTF-8"
	Stack            string   `toml:"stack"`             // nix stack name (e.g. "go", "python"); default: "base" (see ResolvedStack)
	Modules          []string `toml:"modules"`           // extra nix modules to compose on top of stack
	NixhomePath      string   `toml:"nixhome"`           // local nixhome path; overridden by DEVCELL_NIXHOME_PATH env
	Engine           string   `toml:"engine"`            // execution engine: "docker" (default) or "vagrant"
	VagrantProvider  string   `toml:"vagrant_provider"`  // vagrant provider: "utm" (default) or "libvirt"
	VagrantBox       string   `toml:"vagrant_box"`       // vagrant box name override (default: "utm/bookworm")
	DockerPrivileged bool     `toml:"docker_privileged"` // run container with --privileged; default: false
	PerCellImage     *bool    `toml:"per_cell_image"`    // tag user image per cell instead of per stack; default: false
	Hostname         string   `toml:"hostname"`          // override container hostname; default: computed "cell-<basename>-<bunk>"; env: DEVCELL_HOSTNAME
	MacAddress       string   `toml:"mac_address"`       // MAC for the container's NIC (XX:XX:XX:XX:XX:XX); pinned across restarts for infra-side identity persistence. Honored on user-defined bridge networks (devcell uses --network devcell-network). Empty → docker auto-assigns a random MAC per launch.
	Thin             *bool    `toml:"thin"`              // thin image mode; default: true; disable with thin=false or DEVCELL_THIN=0
}

type GitSection struct {
	AuthorName     string `toml:"author_name"`
	AuthorEmail    string `toml:"author_email"`
	CommitterName  string `toml:"committer_name"`
	CommitterEmail string `toml:"committer_email"`
}

type LLMModelsSection struct {
	Default   string                 `toml:"default"`
	Providers map[string]LLMProvider `toml:"providers"`
}

type LLMProvider struct {
	BaseURL string   `toml:"base_url"`
	Models  []string `toml:"models"`
}

type LLMSection struct {
	SystemPrompt     string           `toml:"system_prompt"`
	SystemPromptFile string           `toml:"system_prompt_file"`
	UseOllama        bool             `toml:"use_ollama"`
	Models           LLMModelsSection `toml:"models"`
}

type MissingEnvError struct {
	// Refs maps each missing host var name to the [env].<key> paths that
	// referenced it (the same var may be referenced from multiple [env] keys).
	Refs map[string][]string
}

type OpSection struct {
	Documents []string `toml:"documents"` // 1Password document names to resolve via `op item get`
	Items     []string `toml:"items"`     // deprecated: use documents (kept for backwards compat)
}

type PackagesSection struct {
	Npm    map[string]string `toml:"npm"`
	Python map[string]string `toml:"python"`
}

type PortsSection struct {
	Forward   []string `toml:"forward"`    // port mappings: "3000", "8080:3000"
	PublishIP string   `toml:"publish_ip"` // host interface for `docker run -p`; default "0.0.0.0". Applies to VNC, RDP, and all forward entries.
}

type StealthSection struct {
	Arch     string `toml:"arch"`
	Platform string `toml:"platform"`
}

type VolumeMount struct {
	Mount string `toml:"mount"`
}