config

type FlyMachinesPreference struct {
	APIToken string `json:"api_token,omitempty"`
	OrgSlug  string `json:"org_slug,omitempty"`
	Region   string `json:"region,omitempty"`
	Image    string `json:"image,omitempty"`
	// GatewayNetwork is the Fly private network the per-app Flycast
	// address is allocated on — where this daemon dials FROM. Empty
	// means the org's default network.
	GatewayNetwork string `json:"gateway_network,omitempty"`
	// AppNamePrefix namespaces this deployment's per-user apps within
	// the org (e.g. "clank-dev-u"). Empty defaults to "clank-u".
	AppNamePrefix string `json:"app_name_prefix,omitempty"`
	GuestCPUKind  string `json:"guest_cpu_kind,omitempty"`
	GuestCPUs     int    `json:"guest_cpus,omitempty"`
	GuestMemoryMB int    `json:"guest_memory_mb,omitempty"`
	SwapSizeMB    int    `json:"swap_size_mb,omitempty"`
	VolumeSizeGB  int    `json:"volume_size_gb,omitempty"`
}

type FlySpritesPreference struct {
	APIToken         string `json:"api_token,omitempty"`
	OrganizationSlug string `json:"organization_slug,omitempty"`
	Region           string `json:"region,omitempty"`
	// SpriteNamePrefix is prepended to the user identifier to form
	// the sprite name. Empty defaults to "clank-host" (yielding e.g.
	// "clank-host-local" in the single-user laptop daemon).
	SpriteNamePrefix string `json:"sprite_name_prefix,omitempty"`
	// Resource pins for the sprite. 0 uses Sprites' defaults.
	RamMB     int `json:"ram_mb,omitempty"`
	CPUs      int `json:"cpus,omitempty"`
	StorageGB int `json:"storage_gb,omitempty"`
}

type ModelPreference struct {
	ModelID    string `json:"model_id"`
	ProviderID string `json:"provider_id"`
}

type Preferences struct {
	// Models holds per-backend model overrides, keyed by backend
	// string (e.g. "opencode", "claude-code"). Per-backend rather
	// than a single global pick because each backend has its own
	// model catalog: a model valid for opencode (e.g. a github-copilot
	// route) will not exist in claude-code's enum and would crash the
	// CLI at spawn time. Use ModelFor/SetModelFor.
	Models map[string]ModelPreference `json:"models,omitempty"`
	// ColorScheme is the TUI color scheme name (e.g. "tokyo-night").
	// Empty string means "use the default scheme".
	ColorScheme string `json:"color_scheme,omitempty"`
	// DefaultBackend is the user's preferred coding agent backend
	// (e.g. "opencode", "claude-code"). Used when neither the CLI
	// `--backend` flag nor an explicit TUI selection overrides it.
	// Empty string means "use the built-in default" (agent.DefaultBackend).
	//
	// Stored as a plain string rather than agent.BackendType to avoid
	// pulling internal/agent into the config package's dependency graph.
	// Validate at the boundary via agent.ResolveBackendPreference.
	DefaultBackend string `json:"default_backend,omitempty"`

	// WebPreviewDictation is the dictation engine `clank preview`'s
	// browser overlay uses: "local" (the clank-voice/exec engine on
	// this machine) or "webspeech" (the browser's SpeechRecognition
	// service, which typically uploads audio to the browser vendor).
	// Empty means not chosen yet — the overlay asks on first dictation.
	//
	// Stored as a plain string (same reasoning as DefaultBackend);
	// validated at the boundary via webpreview.ParseDictationEngine.
	WebPreviewDictation string `json:"web_preview_dictation,omitempty"`

	// SidebarWidthRatio is the sidebar width as a percentage of the terminal
	// width, adjusted with +/- in the TUI. Zero means "use the built-in
	// default" (defaultSidebarWidthRatio).
	SidebarWidthRatio int `json:"sidebar_width_ratio,omitempty"`

	// SidebarHidden persists the 'w' sidebar toggle across TUI launches.
	// False (default) = visible. Width-based auto-collapse is not recorded
	// here — only explicit toggles.
	SidebarHidden bool `json:"sidebar_hidden,omitempty"`

	// SidebarExpanded is the persisted per-row expand/collapse state for the
	// IDE-style sidebar tree. Keys follow the scheme used by sidebarNode.Key
	// (e.g. "wt:<LocalPath>", "older:wt", "older:s:<LocalPath>"). Absent or
	// false entries are collapsed. Older buckets reset to collapsed at every
	// launch regardless of what's stored here; the TUI is responsible for
	// that override.
	SidebarExpanded map[string]bool `json:"sidebar_expanded,omitempty"`

	// LastSessionByCwd records the session that was most recently open
	// when the TUI exited, keyed by the absolute cwd it was launched
	// from. On startup the TUI looks up the entry for the current cwd
	// and reopens that session — so "where I left off" survives across
	// runs without dropping users into a session from an unrelated
	// repo when they launch from elsewhere.
	LastSessionByCwd map[string]string `json:"last_session_by_cwd,omitempty"`

	// FlySprites configures the cloud-hub-side Fly.io Sprites launcher.
	// Only effective on a TCP-listening hub. Empty = launcher
	// disabled (sessions requesting launch_host.provider="flysprites"
	// will 4xx).
	FlySprites *FlySpritesPreference `json:"flysprites,omitempty"`

	// FlyMachines configures the raw Fly Machines provisioner. Nil =
	// disabled (sessions requesting launch_host.provider=
	// "flymachines" will 4xx).
	FlyMachines *FlyMachinesPreference `json:"flymachines,omitempty"`

	// DefaultLaunchHostProvider, when set, is applied to every new
	// session whose StartRequest omits LaunchHost. Use this on a
	// cloud hub to make TUI-created sessions automatically spin up
	// sandboxes (e.g. "flymachines") without each client having to know
	// about launchers.
	//
	// Empty (default) = no auto-launch; sessions land on the hub's
	// "local" host (the cloud-hub machine itself).
	//
	// Stored as a plain string to avoid importing internal/agent
	// into the config package — the value is validated at the
	// hub when a launcher is looked up.
	DefaultLaunchHostProvider string `json:"default_launch_host_provider,omitempty"`

	// Remote configures the user's named clank deployments. One or more
	// remotes, each with its own gateway/auth endpoint and session, plus
	// an Active selector pointing at the live one. Modeled on git
	// remotes: same mental model, same `add/list/switch/remove` UX.
	// The TUI auth panel and `clank remote` read the active remote via
	// Preferences.ActiveRemote().
	Remote *RemoteConfig `json:"remote,omitempty"`
}

type Remote struct {
	// GatewayURL is the base URL of the cloud gateway (sessions + sync),
	// e.g. "https://gateway.example.com". Required for push/pull and
	// session proxying; also the discovery endpoint for OAuth via
	// GET /auth-config.
	GatewayURL string `json:"gateway_url,omitempty"`

	AccessToken  string `json:"access_token,omitempty"`
	RefreshToken string `json:"refresh_token,omitempty"`
	UserEmail    string `json:"user_email,omitempty"`
	UserID       string `json:"user_id,omitempty"`
	// ExpiresAt is unix-seconds. Zero when no session.
	ExpiresAt int64 `json:"expires_at,omitempty"`
}

type RemoteConfig struct {
	// Active is the key in Profiles whose endpoints/session are used by
	// push/pull/TUI right now. Empty falls back to "default".
	Active string `json:"active,omitempty"`

	// Profiles maps a user-chosen name to its configuration. At least
	// one entry is expected when Remote is set at all; an Active that
	// points at a missing entry renders ActiveRemote() nil.
	Profiles map[string]*Remote `json:"profiles,omitempty"`
}