store

type Config struct {
	SchemaVersion  int                      `json:"schema_version"`
	DefaultAgent   string                   `json:"default_agent"`
	DefaultProfile string                   `json:"default_profile"`
	Profiles       map[string]Profile       `json:"profiles"`
	Sessions       map[string]SessionRecord `json:"sessions"`
	UI             UISettings               `json:"ui"`
	// WebProjects holds the web interface's Projects, keyed by Project ID.
	WebProjects map[string]WebProject `json:"web_projects,omitempty"`
	// WebSettings are the web interface's settings, shared by every browser.
	WebSettings WebSettings `json:"web_settings,omitzero"`

	// ReadOnly is set when the on-disk file declares a SchemaVersion newer than
	// this binary understands. The app must not write such a config (doing so
	// would drop fields it does not model), so Save/Update refuse it (F33). It
	// is in-memory only and never serialized.
	ReadOnly bool
	// contains filtered or unexported fields
}

type Mode string

type MousePolicy string

type PRRecord struct {
	URL         string    `json:"url"`
	Number      int       `json:"number"`
	LastStatus  string    `json:"last_status"`
	LastChecked time.Time `json:"last_checked"`
}

type Profile struct {
	Provider        *string      `json:"provider,omitempty"`
	Mode            *Mode        `json:"mode,omitempty"`
	CommandAlias    *string      `json:"command_alias,omitempty"`
	Mouse           *MousePolicy `json:"mouse,omitempty"`
	ControlPrefix   *string      `json:"control_prefix,omitempty"`
	BackDetach      *bool        `json:"back_detach,omitempty"`
	ScrollbackLines *int         `json:"scrollback_lines,omitempty"`
	// contains filtered or unexported fields
}

type SessionExit struct {
	SessionName       string
	ProviderSessionID string
	ExitCode          int
	UAMInitiated      bool
}

type SessionProfileOverrides struct {
	Mode            *Mode        `json:"mode,omitempty"`
	CommandAlias    *string      `json:"command_alias,omitempty"`
	Mouse           *MousePolicy `json:"mouse,omitempty"`
	ControlPrefix   *string      `json:"control_prefix,omitempty"`
	BackDetach      *bool        `json:"back_detach,omitempty"`
	ScrollbackLines *int         `json:"scrollback_lines,omitempty"`
	// contains filtered or unexported fields
}

type SessionRecord struct {
	ID           string `json:"id"`
	Agent        string `json:"agent"`
	CommandAlias string `json:"command_alias,omitempty"`
	Name         string `json:"name"`
	Prompt       string `json:"prompt,omitempty"`
	Mode         Mode   `json:"mode"`
	Workdir      string `json:"workdir"`
	// SessionName is the backend session name ("uam-<agent>-<id>"). The JSON
	// key keeps its historical "tmux_session" spelling so configs written by
	// tmux-backed releases load unchanged.
	SessionName string    `json:"tmux_session"`
	CreatedAt   time.Time `json:"created_at"`
	LastSeenAt  time.Time `json:"last_seen_at"`
	Pinned      bool      `json:"pinned"`
	Group       string    `json:"group"`
	SortIndex   int       `json:"sort_index"`
	Status      Status    `json:"status,omitempty"`
	// ProviderSessionID is the agent CLI's own session id, recorded when the
	// provider lets uam seed it at dispatch (e.g. claude --session-id). A
	// resume can then target the exact provider session instead of the
	// provider's "most recent" heuristic.
	ProviderSessionID string `json:"provider_session_id,omitempty"`
	// LastExitCode records the agent process's exit status from the most
	// recent close (-1 when it died on a signal). Pointer so records from
	// older schemas stay distinguishable from a real exit 0.
	LastExitCode     *int                     `json:"last_exit_code,omitempty"`
	PR               *PRRecord                `json:"pr,omitempty"`
	Profile          string                   `json:"profile,omitempty"`
	ProfileOverrides *SessionProfileOverrides `json:"profile_overrides,omitempty"`
	// Surface names the owner of a record. Empty means a terminal session host;
	// SurfaceWeb means the web service. Terminal commands never list, attach,
	// resume or prune records with a non-empty Surface, and the web service
	// only opens its own, so neither takes over the other's conversations.
	Surface string `json:"surface,omitempty"`
	// Web is the web service's durable state for a SurfaceWeb record.
	Web *WebState `json:"web,omitempty"`
	// contains filtered or unexported fields
}

type Status string

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

type TurnTiming struct {
	ID         string    `json:"id"`
	UserItemID string    `json:"user_item_id,omitempty"`
	StartedAt  time.Time `json:"started_at"`
	EndedAt    time.Time `json:"ended_at,omitzero"`
	State      string    `json:"state"`
}

type UISettings struct {
	GroupByDir bool `json:"group_by_dir"`
	// Sort and PeekWidth are retained schema-v3 compatibility fields. They are
	// normalized and round-tripped even when the TUI exposes no direct control.
	Sort      string `json:"sort"`
	PeekWidth int    `json:"peek_width"`
}

type WebBadge struct {
	Text  string `json:"text"`
	Color string `json:"color"`
}

type WebCustomModel struct {
	Name        string `json:"name"`
	DisplayName string `json:"display_name,omitempty"`
	BaseURL     string `json:"base_url"`
	ModelID     string `json:"model_id"`
	// WireAPI is "", "completions" (the default) or "responses".
	WireAPI   string `json:"wire_api,omitempty"`
	APIKeyEnv string `json:"api_key_env"`
}

type WebProject struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Dir       string    `json:"dir"`
	CreatedAt time.Time `json:"created_at"`
	// LegacyDefaults are the per-Project Task defaults of versions before
	// WebSettings.TaskDefaults. Load reads them once, adopts the newest valid
	// ones as the setting when it is unset, and clears them, so the next save
	// drops the key. Nothing writes them.
	LegacyDefaults WebTaskDefaults `json:"defaults,omitzero"`
	// Badge is zero until the web service assigns one; it also replaces an
	// invalid one on load.
	Badge WebBadge `json:"badge,omitzero"`
	// contains filtered or unexported fields
}

type WebSettings struct {
	// SendDefault is what Enter does while a turn runs: WebSendSteer or
	// WebSendQueue. Empty or unrecognised values mean steer at runtime.
	SendDefault string `json:"send_default,omitempty"`
	// HiddenModels lists, by provider, the model IDs the browser does not
	// offer: sorted, without duplicates, at most MaxHiddenModels each. It is
	// a display preference, never a check on requests.
	HiddenModels map[string][]string `json:"hidden_models,omitempty"`
	// TitleModel maps a provider to its Utility model: the model UAM uses for
	// its own small AI jobs, such as titling new Tasks. The key keeps its
	// first name, title_model. A provider without an entry uses its cheapest
	// priced model; WebTitleModelNone opts it out (it keeps its own title).
	TitleModel map[string]string `json:"title_model,omitempty"`
	// CustomModels are the OpenAI-compatible models the owner brought
	// (BYOM), valid as ValidCustomModels checks. No key is stored: only the
	// name of the service environment variable that holds it.
	CustomModels []WebCustomModel `json:"custom_models,omitempty"`
	// TaskDefaults are the settings a new Task starts with; zero when unset.
	TaskDefaults WebTaskDefaults `json:"task_defaults,omitzero"`
	// contains filtered or unexported fields
}

type WebState struct {
	// Turn is the last known session state (for example "working" or
	// "completed").
	Turn        string       `json:"turn,omitempty"`
	TurnTimings []TurnTiming `json:"turn_timings,omitempty"`
	// RequestID is the client-generated ID of the last prompt submission.
	RequestID string `json:"request_id,omitempty"`
	// RequestStatus is that submission's outcome: accepted, rejected or
	// uncertain.
	RequestStatus      string          `json:"request_status,omitempty"`
	CommandResult      json.RawMessage `json:"command_result,omitempty"`
	CommandSubmissions json.RawMessage `json:"command_submissions,omitempty"`
	UpdatedAt          time.Time       `json:"updated_at"`
	// Detail is a sanitized, short explanation of the state (usually an error).
	Detail string `json:"detail,omitempty"`
	// ProjectID is the WebProject the session (a Task) belongs to.
	ProjectID string `json:"project_id,omitempty"`
	// Model is the selected model ID; empty means the provider default.
	Model       string `json:"model,omitempty"`
	Effort      string `json:"effort,omitempty"`
	ContextSize string `json:"context_size,omitempty"`
	// Title is the provider-generated conversation title, sanitized and
	// bounded.
	Title string `json:"title,omitempty"`
	// Stage is the Task's lifecycle stage: "" (active), "settled" or
	// "archived". Records written before stages existed are active.
	Stage string `json:"stage,omitempty"`
	// SettledAt is when the Task was settled; zero unless it is settled, or
	// was settled before it was archived.
	SettledAt time.Time `json:"settled_at,omitzero"`
	// ArchivedAt is when the Task was archived.
	ArchivedAt time.Time `json:"archived_at,omitzero"`
	// TerminalSession is the ID of the terminal session record tied to the
	// same provider conversation when the Task was imported. That record
	// stays the terminal's.
	TerminalSession string `json:"terminal_session,omitempty"`
	// Imported marks a conversation created outside this web service.
	Imported bool `json:"imported,omitempty"`
	// contains filtered or unexported fields
}

type WebTaskDefaults struct {
	Provider    string `json:"provider"`
	Model       string `json:"model"`
	Effort      string `json:"effort"`
	ContextSize string `json:"context_size"`
	Mode        string `json:"mode"`
}