settings

type AIConfig struct {
	Provider       string // "", "openai", "anthropic", "gemini"
	OpenAIModel    string
	OpenAIKey      string
	AnthropicModel string
	AnthropicKey   string
	GeminiModel    string
	GeminiKey      string

	// Image generation is a separate pipeline from text analysis and so
	// has its own provider + per-provider model overrides. The API keys
	// are shared with the text providers above.
	ImageProvider    string // "", "openai", "gemini"
	ImageOpenAIModel string
	ImageGeminiModel string

	// Speech-to-text pipeline (voice notes). Same shape as Image.
	SpeechProvider    string // "", "openai", "gemini"
	SpeechOpenAIModel string
	SpeechGeminiModel string

	// RecapWeatherEnabled toggles the optional weather lookup that
	// runs during trip recap generation. Off by default; the feature
	// hits an external HTTP API (Open-Meteo) so it must be opt-in.
	RecapWeatherEnabled bool

	// GPS accuracy heuristic thresholds applied client-side on the
	// drive detail page. See DefaultGPS* for the meaning of each.
	GPSMissingPct float64
	GPSStaleSec   int
	GPSJumpCount  int
}

type AIImagePublic struct {
	Provider  string `json:"provider"`            // "", openai|gemini
	Effective string `json:"effective,omitempty"` // what auto-selection picked
	// Per-provider model overrides. Empty string means "use the default".
	OpenAIModel string `json:"openai_model,omitempty"`
	GeminiModel string `json:"gemini_model,omitempty"`
	Ready       bool   `json:"ready"`
}

type AIPublic struct {
	Provider  string             `json:"provider"` // "", openai|anthropic|gemini
	Effective string             `json:"effective_provider,omitempty"`
	Model     string             `json:"effective_model,omitempty"`
	Providers map[string]ProInfo `json:"providers"`
	Ready     bool               `json:"ready"`

	// Image is the public view of the image-generation configuration.
	Image AIImagePublic `json:"image"`
	// Speech is the public view of the voice-transcription configuration.
	Speech AISpeechPublic `json:"speech"`
}

type AISpeechPublic struct {
	Provider    string `json:"provider"`
	Effective   string `json:"effective,omitempty"`
	OpenAIModel string `json:"openai_model,omitempty"`
	GeminiModel string `json:"gemini_model,omitempty"`
	Ready       bool   `json:"ready"`
}

type AIUpdate struct {
	Provider       *string `json:"provider,omitempty"`
	OpenAIModel    *string `json:"openai_model,omitempty"`
	OpenAIKey      *string `json:"openai_api_key,omitempty"`
	AnthropicModel *string `json:"anthropic_model,omitempty"`
	AnthropicKey   *string `json:"anthropic_api_key,omitempty"`
	GeminiModel    *string `json:"gemini_model,omitempty"`
	GeminiKey      *string `json:"gemini_api_key,omitempty"`

	// Image generation settings.
	ImageProvider    *string `json:"image_provider,omitempty"`
	ImageOpenAIModel *string `json:"image_openai_model,omitempty"`
	ImageGeminiModel *string `json:"image_gemini_model,omitempty"`

	// Speech-to-text settings.
	SpeechProvider    *string `json:"speech_provider,omitempty"`
	SpeechOpenAIModel *string `json:"speech_openai_model,omitempty"`
	SpeechGeminiModel *string `json:"speech_gemini_model,omitempty"`
}

type ChargingConfig struct {
	// HomePricePerKWh is the retail cost in HomeCurrency per kilowatt
	// hour. Zero means "not configured"; in that case estimated cost
	// is not computed.
	HomePricePerKWh float64 `json:"home_price_per_kwh"`
	// HomeCurrency is the ISO-4217 code displayed next to estimated
	// cost. Defaults to USD.
	HomeCurrency string `json:"home_currency"`
	// GasPricePerGallon and ComparisonMPG feed the gas-equivalent chip
	// on the trip planner. Zero on either disables the chip.
	GasPricePerGallon float64 `json:"gas_price_per_gallon"`
	ComparisonMPG     float64 `json:"comparison_mpg"`
}

type ChargingNetwork struct {
	Name         string  `json:"name"`
	PricePerKWh  float64 `json:"price_per_kwh"`
	Currency     string  `json:"currency"`
	MemberPrice  float64 `json:"member_price_per_kwh,omitempty"`
	MemberActive bool    `json:"member_active,omitempty"`
	MemberPlan   string  `json:"member_plan,omitempty"`
	Slug         string  `json:"slug,omitempty"`
	// Preferred = "rank this network high in Rivian's planner".
	// Forwarded as networkPreferences[].preference=1 on plan
	// requests. Unset / false sends nothing for that network.
	Preferred bool `json:"preferred,omitempty"`
	// Seeded is computed on read, never stored: the row's rates are still the built-in
	// table's (or blank), so the user has not entered a rate for this network. Its
	// price fields are returned as 0 ("unset"): the table's mid-2025 figures are dated
	// estimates that no network publishes as a price and are not shown or applied as
	// one. A row the user edited has Seeded false.
	Seeded bool `json:"seeded,omitempty"`
	// Lat/Lon are where a network row of the user's own (no built-in Slug) is, when they
	// gave one (#906): both or neither. Private to this user: only their charge map's
	// label and the pricing prefill read it. Never in AsOverrides, the chargers archive,
	// the DCFC Tracker links, demo data or anyone else's price book.
	Lat *float64 `json:"lat,omitempty"`
	Lon *float64 `json:"lon,omitempty"`
}

type Factory struct {
	// contains filtered or unexported fields
}

type GPSPublic struct {
	MissingPct float64 `json:"missing_pct"`
	StaleSec   int     `json:"stale_sec"`
	JumpCount  int     `json:"jump_count"`
}

type GPSUpdate struct {
	MissingPct *float64 `json:"missing_pct,omitempty"`
	StaleSec   *int     `json:"stale_sec,omitempty"`
	JumpCount  *int     `json:"jump_count,omitempty"`
}

type HomeLocation struct {
	Set       bool    `json:"set"`
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
	// Label is the short, user-visible name surfaced everywhere
	// the point is referenced (trip planner From: Home, drive
	// timeline "departed Home"). Defaults to "Home" on save when
	// the client doesn't provide one — keeps planner UI compact.
	Label string `json:"label,omitempty"`
	// Address is the full geocoded address kept for context on
	// the Settings card. Never used as the primary label.
	Address string `json:"address,omitempty"`
	// Source is how the home was set: "city", "address", "coordinates" or "charge" ("" before it was recorded).
	Source string `json:"source,omitempty"`
}

type KV interface {
	GetAll(ctx context.Context) (map[string]string, error)
	Set(ctx context.Context, key, value string) error
	Delete(ctx context.Context, key string) error
}

type Manager struct {
	// contains filtered or unexported fields
}

type NetworkPref struct {
	NetworkID  string
	Preference int
}

type PlannerFavorite struct {
	ID        string  `json:"id"`
	Label     string  `json:"label"`
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
}

type PlannerPrefs struct {
	// DriveMode is one of EVERYDAY / DISTANCE / SPORT / WINTER /
	// OFF_ROAD_AUTO. Empty string means "no default — let Rivian
	// pick" (the gateway's default is EVERYDAY, so empty and
	// EVERYDAY produce the same plan).
	DriveMode string `json:"drive_mode"`
	// HasAdapter — does the vehicle have the Tesla NACS adapter?
	// Pointer so absent/false/true are all distinguishable on the
	// wire; default is unset.
	HasAdapter *bool `json:"has_adapter,omitempty"`
}

type ProInfo struct {
	Model  string `json:"model"`
	HasKey bool   `json:"has_key"`
}

type RecapPublic struct {
	WeatherEnabled bool `json:"weather_enabled"`
}

type RecapUpdate struct {
	WeatherEnabled *bool `json:"weather_enabled,omitempty"`
}

type Store struct {
	// contains filtered or unexported fields
}

type Units struct {
	DistanceUnit      string `json:"distance_unit"`
	TemperatureUnit   string `json:"temperature_unit"`
	DistanceSource    string `json:"distance_source"`
	TemperatureSource string `json:"temperature_source"`
}