web

type AcceptResult struct {
	Cmd     string    `json:"cmd"`
	CmdHash string    `json:"cmd_hash"`
	Head    string    `json:"head"`
	Dirty   bool      `json:"dirty"`
	Exit    int       `json:"exit"`
	Tail    string    `json:"tail"`
	RanAt   time.Time `json:"ran_at"`
	Stale   bool      `json:"stale"`
}

type AccountUsage struct {
	Quotas    []Quota   `json:"quotas"`
	Stale     bool      `json:"stale"`
	UpdatedAt time.Time `json:"updated_at,omitzero"`
}

type AddPromptRequest struct {
	Name      string `json:"name"`
	Text      string `json:"text"`
	ProjectID string `json:"project_id"`
}

type Ask struct {
	Kind agentapi.InteractionKind `json:"kind"`
	// Title is a permission's title, or the first line of a question's text
	// (its header, else the interaction title, when the text is empty).
	Title string `json:"title"`
}

type BackgroundTaskCancellation struct {
	Accepted        bool                     `json:"accepted"`
	BackgroundTasks agentapi.BackgroundTasks `json:"background_tasks"`
}

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

type BoardCard struct {
	ID              string         `json:"id"`
	Seq             int64          `json:"seq"`
	ProjectID       string         `json:"project_id"`
	Kind            board.Kind     `json:"kind"`
	ParentID        *string        `json:"parent_id"`
	Rank            int            `json:"rank"`
	Title           string         `json:"title"`
	Desc            string         `json:"desc"`
	WinCondition    string         `json:"win_condition"`
	Status          board.Status   `json:"status"`
	Progress        *BoardProgress `json:"progress,omitempty"`
	Prio            int            `json:"prio"`
	Due             string         `json:"due,omitempty"`
	Effort          string         `json:"effort"`
	Labels          []string       `json:"labels"`
	Checklist       []board.Check  `json:"checklist"`
	Blocked         bool           `json:"blocked"`
	BlockedBy       []string       `json:"blocked_by"`
	Blocks          []string       `json:"blocks"`
	Confirmed       bool           `json:"confirmed"`
	ExpiresAt       *time.Time     `json:"expires_at,omitempty"`
	HeldBy          string         `json:"held_by,omitempty"`
	PinnedSHA       string         `json:"pinned_sha"`
	AcceptCmd       *string        `json:"accept_cmd"`
	Paths           []string       `json:"paths"`
	Stale           *Stale         `json:"stale,omitempty"`
	PendingRequests int            `json:"pending_requests"`
	Revision        int64          `json:"revision"`
	CreatedAt       time.Time      `json:"created_at"`
	UpdatedAt       time.Time      `json:"updated_at"`
	MovedAt         time.Time      `json:"moved_at"`
}

type BoardCardDetail struct {
	Card     BoardCard      `json:"card"`
	Comments []BoardComment `json:"comments"`
	Requests []BoardRequest `json:"requests"`
	Holds    []BoardHold    `json:"holds"`
}

type BoardComment struct {
	ID        string    `json:"id"`
	Author    string    `json:"author"`
	Body      string    `json:"body"`
	Automatic bool      `json:"automatic"`
	CreatedAt time.Time `json:"created_at"`
}

type BoardHold struct {
	ID            string     `json:"id"`
	TaskID        string     `json:"task_id"`
	Attempt       int        `json:"attempt"`
	StartedAt     time.Time  `json:"started_at"`
	BaselineHead  string     `json:"baseline_head"`
	BaselineDirty []string   `json:"baseline_dirty"`
	EndedAt       *time.Time `json:"ended_at,omitempty"`
	EndReason     string     `json:"end_reason,omitempty"`
}

type BoardProgress struct {
	Done     int `json:"done"`
	Total    int `json:"total"`
	Proposed int `json:"proposed"`
}

type BoardProject struct {
	AcceptCmd string `json:"accept_cmd"`
	Git       string `json:"git"`
}

type BoardRequest struct {
	ID              string              `json:"id"`
	CardID          string              `json:"card_id"`
	TaskID          string              `json:"task_id"`
	AgentID         string              `json:"agent_id"`
	Kind            board.RequestKind   `json:"kind"`
	Comment         string              `json:"comment"`
	Payload         jsonObject          `json:"payload"`
	Evidence        jsonObject          `json:"evidence"`
	Flags           []string            `json:"flags"`
	BaseRevision    int64               `json:"base_revision"`
	Status          board.RequestStatus `json:"status"`
	CreatedAt       time.Time           `json:"created_at"`
	DecidedAt       *time.Time          `json:"decided_at,omitempty"`
	DecisionComment string              `json:"decision_comment,omitempty"`
	// DecidedBy is owner, or uam for a done request accepted automatically.
	DecidedBy board.DecidedBy `json:"decided_by,omitempty"`
}

type BoardSnapshot struct {
	Cards    []BoardCard    `json:"cards"`
	Requests []BoardRequest `json:"requests"`
	Revision int64          `json:"revision"`
}

type ChangedFile struct {
	Path      string `json:"path"`
	Status    string `json:"status"`
	Additions int    `json:"additions"`
	Deletions int    `json:"deletions"`
	// Digest changes whenever the file's working-tree content may have
	// changed; it is empty where the scope cannot tell.
	Digest string `json:"digest,omitempty"`
}

type Changes struct {
	Scope     string        `json:"scope"`
	Label     string        `json:"label"`
	Supported bool          `json:"supported"`
	Reason    string        `json:"reason"`
	Files     []ChangedFile `json:"files"`
	// Counts is set on the task, turn and workspace scopes.
	Counts *ScopeCounts `json:"counts,omitempty"`
}

type Chart struct {
	ChartSpec
	ChartData
	PinnedID string `json:"pinned_id,omitempty"`
}

type ChartData struct {
	Labels []string      `json:"labels"`
	Series []ChartSeries `json:"series"`
	At     time.Time     `json:"at"`
}

type ChartSeries struct {
	Name   string    `json:"name"`
	Values []float64 `json:"values"`
}

type ChartSpec struct {
	Title   string   `json:"title"`
	Kind    string   `json:"kind"`
	XLabel  string   `json:"x_label,omitempty"`
	YLabel  string   `json:"y_label,omitempty"`
	Command string   `json:"command,omitempty"`
	Format  string   `json:"format,omitempty"`
	X       string   `json:"x"`
	Y       []string `json:"y"`
}

type CommandRequest struct {
	RequestID   string   `json:"request_id"`
	Name        string   `json:"name"`
	Arguments   string   `json:"arguments"`
	Files       []string `json:"files"`
	Attachments []string `json:"attachments"`
}

type CommitDraft struct {
	Message      string `json:"message"`
	Conventional bool   `json:"conventional"`
	Model        string `json:"model"`
}

type CreateRequest struct {
	ProjectID   string `json:"project_id"`
	Provider    string `json:"provider"`
	Model       string `json:"model"`
	Effort      string `json:"effort"`
	ContextSize string `json:"context_size"`
	Name        string `json:"name"`
	Prompt      string `json:"prompt"`
	RequestID   string `json:"request_id"`
	// Mode is safe (also when empty) or yolo.
	Mode string `json:"mode"`
	// contains filtered or unexported fields
}

type CustomModel struct {
	Name        string `json:"name"`
	DisplayName string `json:"display_name,omitempty"`
	BaseURL     string `json:"base_url"`
	ModelID     string `json:"model_id"`
	WireAPI     string `json:"wire_api,omitempty"`
	APIKeyEnv   string `json:"api_key_env"`
	KeyPresent  bool   `json:"key_present"`
}

type DaemonConfig struct {
	Listen        string
	PublicOrigins []string
	Providers     []agentapi.Provider
	Version       string
	// LogHeaders logs every request's headers (see ServerConfig).
	LogHeaders bool
}

type DaemonState struct {
	PID           int      `json:"pid"`
	StartTime     int64    `json:"start_time"`
	Listen        string   `json:"listen"`
	PublicOrigins []string `json:"public_origins,omitempty"`
	// LegacyNoAuth detects unsupported insecure daemons written by older
	// versions. New daemons never set this field.
	LegacyNoAuth bool      `json:"no_auth,omitempty"`
	LogHeaders   bool      `json:"log_headers,omitempty"`
	Version      string    `json:"version"`
	StartedAt    time.Time `json:"started_at"`
}

type DiffStat struct {
	Files     int `json:"files"`
	Additions int `json:"additions"`
	Deletions int `json:"deletions"`
}

type DirEntry struct {
	Name string `json:"name"`
	Path string `json:"path"`
	// Git means the folder holds .git, a directory or, in a linked worktree,
	// a file.
	Git    bool `json:"git"`
	Hidden bool `json:"hidden"`
	// Link means the entry is a symbolic link to a directory.
	Link bool `json:"link"`
}

type DirList struct {
	Path      string     `json:"path"`
	Parent    string     `json:"parent,omitempty"`
	Entries   []DirEntry `json:"entries"`
	Truncated bool       `json:"truncated"`
}

type DiscoverRequest struct {
	BaseURL   string `json:"base_url"`
	APIKeyEnv string `json:"api_key_env"`
	WireAPI   string `json:"wire_api"`
}

type DiscoverResult struct {
	Models     []string `json:"models"`
	Truncated  bool     `json:"truncated,omitempty"`
	KeyPresent bool     `json:"key_present"`
}

type Error struct {
	Status  int
	Message string
	// ProjectID names the existing Project when adding a directory that
	// already has one.
	ProjectID string
	// Code classifies a planner refusal (ADR 0005 §14): planner_off, no_git,
	// holds_undecided, or a board rule's code. Refs lists what a board rule
	// refused over, such as open checklist items, and Cards are the held
	// subtasks a holds_undecided refusal asks about.
	Code  string
	Refs  []string
	Cards []BoardCard
}

type Evidence struct {
	Baseline   board.Baseline      `json:"baseline"`
	Diff       EvidenceDiff        `json:"diff"`
	Commits    []EvidenceCommit    `json:"commits"`
	Accept     *AcceptResult       `json:"accept,omitempty"`
	Transcript *EvidenceTranscript `json:"transcript,omitempty"`
	Checklist  EvidenceChecklist   `json:"checklist"`
	// contains filtered or unexported fields
}

type EvidenceCheck struct {
	ItemID string `json:"item_id"`
	// Kinds are the checks it runs: test, build, lint, vet, typecheck.
	Kinds   []string `json:"kinds"`
	Command string   `json:"command"`
	// Outcome is pass, fail, unclear or running: the worst of its checks.
	Outcome string `json:"outcome"`
	Exit    *int   `json:"exit,omitempty"`
	// Counts is what its output counted ("2 packages ok").
	Counts string `json:"counts,omitempty"`
	TookMS *int64 `json:"took_ms,omitempty"`
	// Note says why the outcome is unclear, or how it passed.
	Note      string `json:"note,omitempty"`
	HasOutput bool   `json:"has_output"`
	// contains filtered or unexported fields
}

type EvidenceChecklist struct {
	Done  int `json:"done"`
	Total int `json:"total"`
}

type EvidenceClaim struct {
	Text     string `json:"text"`
	Verified bool   `json:"verified"`
	// Detail is what backs it ("go test ./... · exit 0"), or "Not verified ·
	// why".
	Detail string `json:"detail"`
}

type EvidenceCommit struct {
	SHA     string `json:"sha"`
	Subject string `json:"subject"`
}

type EvidenceDiff struct {
	Added   int            `json:"added"`
	Deleted int            `json:"deleted"`
	Files   []EvidenceFile `json:"files"`
}

type EvidenceFile struct {
	Path     string           `json:"path"`
	Added    int              `json:"added"`
	Deleted  int              `json:"deleted"`
	ByTask   bool             `json:"by_task"`
	PreDirty bool             `json:"pre_dirty"`
	Overlap  *EvidenceOverlap `json:"overlap,omitempty"`
}

type EvidenceOverlap struct {
	Card   int64  `json:"card"`
	TaskID string `json:"task_id"`
}

type EvidenceTranscript struct {
	TaskID   string `json:"task_id"`
	FromItem string `json:"from_item"`
	ToItem   string `json:"to_item"`
	Partial  bool   `json:"partial,omitempty"`
}

type FileEntry struct {
	Path string `json:"path"`
	// Type is "file" or "directory".
	Type string `json:"type"`
	// Status is set by Tree only: a file's working-tree status as Changes names
	// it ("modified", "added", "untracked", "deleted", ...), or "changed" for a
	// folder that holds changed files. Empty when unchanged or unknown.
	Status string `json:"status,omitempty"`
}

type FileList struct {
	Files  []FileEntry `json:"files"`
	Reason string      `json:"reason"`
}

type GitFile struct {
	ChangedFile
	Mine      bool `json:"mine,omitempty"`
	OtherTask bool `json:"other_task,omitempty"`
}

type GitResult struct {
	Summary string `json:"summary"`
	Commit  string `json:"commit,omitempty"`
	Output  string `json:"output,omitempty"`
}

type GitState struct {
	// Repo is false when the Task's directory is in no repository; Reason
	// then says why, and CanInit whether "Set up git here" may run.
	Repo    bool   `json:"repo"`
	Reason  string `json:"reason,omitempty"`
	CanInit bool   `json:"can_init,omitempty"`
	// Branch is empty when HEAD is detached. Upstream is the branch's
	// upstream, such as origin/main; Ahead and Behind count commits against
	// it as last fetched. Remote is whether Push has somewhere to go.
	Branch   string `json:"branch,omitempty"`
	Upstream string `json:"upstream,omitempty"`
	Ahead    int    `json:"ahead"`
	Behind   int    `json:"behind"`
	Remote   bool   `json:"remote"`
	// HasCommits is false before the first commit.
	HasCommits bool      `json:"has_commits"`
	Files      []GitFile `json:"files"`
	// TaskFilesKnown is false when this Task's edits from before its history
	// was read may be missing (after a restart), so Mine may be incomplete.
	TaskFilesKnown bool `json:"task_files_known"`
	// Busy says why write actions are refused now; empty when they may run.
	Busy string `json:"busy,omitempty"`
}

type HistoryPage struct {
	Seq    uint64          `json:"seq"`
	Items  []agentapi.Item `json:"items"`
	Before string          `json:"before"`
}

type HoldDecision struct {
	Action  string `json:"action"`
	Comment string `json:"comment"`
}

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

type MCPSecret struct {
	Key string `json:"key"`
	Set bool   `json:"set"`
}

type MCPSecretInput struct {
	Key   string  `json:"key"`
	Value *string `json:"value"`
}

type MCPServerInput struct {
	Name    string           `json:"name"`
	Type    string           `json:"type"`
	Command string           `json:"command"`
	Args    []string         `json:"args"`
	Cwd     string           `json:"cwd"`
	URL     string           `json:"url"`
	Env     []MCPSecretInput `json:"env"`
	Headers []MCPSecretInput `json:"headers"`
}

type MCPServerView struct {
	Name    string      `json:"name"`
	Type    string      `json:"type"`
	Command string      `json:"command,omitempty"`
	Args    []string    `json:"args,omitempty"`
	Cwd     string      `json:"cwd,omitempty"`
	URL     string      `json:"url,omitempty"`
	Env     []MCPSecret `json:"env"`
	Headers []MCPSecret `json:"headers"`
	Enabled bool        `json:"enabled"`
	Source  string      `json:"source"`
}

type MCPServers struct {
	Available    bool            `json:"available"`
	StdioAllowed bool            `json:"stdio_allowed"`
	Servers      []MCPServerView `json:"servers"`
}

type MCPSignIn struct {
	URL   string `json:"url,omitempty"`
	Relay bool   `json:"relay,omitempty"`
}

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

type Meta struct {
	Version         string         `json:"version"`
	Providers       []ProviderInfo `json:"providers"`
	RecentWorkdirs  []string       `json:"recent_workdirs"`
	TempRoot        string         `json:"temp_root,omitempty"`
	TempRootAliases []string       `json:"temp_root_aliases,omitempty"`
}

type PinnedChart struct {
	ID        string    `json:"id"`
	ProjectID string    `json:"project_id"`
	PinnedAt  time.Time `json:"pinned_at"`
	ChartSpec
	ChartData
	Error   string    `json:"error,omitempty"`
	ErrorAt time.Time `json:"error_at,omitzero"`
}

type PreviousConversation struct {
	Provider       string    `json:"provider"`
	ConversationID string    `json:"conversation_id"`
	Title          string    `json:"title"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
	InUse          bool      `json:"in_use"`
}

type Project struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Dir       string    `json:"dir"`
	CreatedAt time.Time `json:"created_at"`
	Badge     Badge     `json:"badge"`
	// Branch is the branch checked out in Dir's git work tree, read from git
	// and never stored. It is empty when Dir is not in a work tree, HEAD is
	// detached, or git cannot tell.
	Branch string `json:"branch,omitempty"`
	// NoGit says why Dir has no changes or git-listed files to show:
	// "not_installed" (no git in a standard location) or "not_repository"
	// (git reports Dir is in no work tree). It is empty in a work tree and
	// when git cannot tell. Read with Branch and never stored.
	NoGit string `json:"no_git,omitempty"`
	// Charts counts the charts pinned to the Project (chart_pins.go).
	Charts int `json:"charts,omitempty"`
}

type PromptRequest struct {
	Text      string `json:"text"`
	RequestID string `json:"request_id"`
	Mode      string `json:"mode"`
	// Files are project paths relative to the Task's directory, sent as
	// structured references.
	Files []string `json:"files"`
	// Attachments are IDs from POST /api/sessions/{id}/attachments.
	Attachments []string `json:"attachments"`
	// Omitted settings snapshot the Task's current selection. A running steer
	// may only use that same selection; new settings require a queued turn.
	Settings *PromptSettings `json:"settings,omitempty"`
}

type PromptSettings struct {
	Model       string `json:"model"`
	Effort      string `json:"effort"`
	ContextSize string `json:"context_size"`
}

type ProviderInfo struct {
	Name        string `json:"name"`
	DisplayName string `json:"display_name"`
	Available   bool   `json:"available"`
	Reason      string `json:"reason"`
	// SignedOut is set when the provider is unavailable because its runtime
	// has no account sign-in; Reason then says to sign in in Settings.
	SignedOut    bool                  `json:"signed_out,omitempty"`
	Capabilities agentapi.Capabilities `json:"capabilities"`
	// Models are the selectable models; empty means the provider default only.
	Models []agentapi.Model `json:"models"`
	// CheapestModel is the cheapest priced model not hidden in Settings: the
	// Utility model when Settings name none. Omitted when none is priced.
	CheapestModel string `json:"cheapest_model,omitempty"`
}

type QueuedPrompt struct {
	RequestID string    `json:"request_id"`
	Text      string    `json:"text"`
	QueuedAt  time.Time `json:"queued_at"`
	// Files are the project paths the prompt references; they are checked
	// again when it is sent.
	Files []string `json:"files,omitempty"`
	// Attachments are the uploads the prompt carries.
	Attachments []agentapi.Attachment `json:"attachments,omitempty"`
	Settings    PromptSettings        `json:"settings"`
}

type Quota struct {
	Provider         string    `json:"provider"`
	Type             string    `json:"type"`
	Used             int64     `json:"used"`
	Entitlement      int64     `json:"entitlement"`
	Unlimited        bool      `json:"unlimited"`
	RemainingPercent float64   `json:"remaining_percent"`
	Overage          float64   `json:"overage"`
	ResetAt          time.Time `json:"reset_at,omitzero"`
}

type Rejection struct {
	BoardRequest
	Steered bool `json:"steered"`
}

type RenamePromptRequest struct {
	Name string `json:"name"`
}

type RerunRequest struct {
	Model     string `json:"model"`
	RequestID string `json:"request_id"`
}

type Routine struct {
	ID            string                `json:"id"`
	ProjectID     string                `json:"project_id"`
	Name          string                `json:"name"`
	Prompt        string                `json:"prompt"`
	Provider      string                `json:"provider"`
	Model         string                `json:"model"`
	Schedule      store.RoutineSchedule `json:"schedule"`
	Enabled       bool                  `json:"enabled"`
	Mode          string                `json:"mode"`
	MaxRunsPerDay int                   `json:"max_runs_per_day"`
	MaxMinutes    int                   `json:"max_minutes"`
	CreatedAt     time.Time             `json:"created_at"`
	NextRun       time.Time             `json:"next_run,omitzero"`
	Runs          []store.WebRoutineRun `json:"runs"`
}

type RoutineInput struct {
	Name          *string                `json:"name"`
	Prompt        *string                `json:"prompt"`
	Model         *string                `json:"model"`
	Schedule      *store.RoutineSchedule `json:"schedule"`
	Enabled       *bool                  `json:"enabled"`
	Mode          *string                `json:"mode"`
	MaxRunsPerDay *int                   `json:"max_runs_per_day"`
	MaxMinutes    *int                   `json:"max_minutes"`
}

type SavedPrompt = store.WebSavedPrompt

type ScopeCounts struct {
	Task      int `json:"task"`
	Turn      int `json:"turn"`
	Workspace int `json:"workspace"`
}

type ServedFile struct {
	File *os.File
	Info fs.FileInfo
	MIME string
}

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

type ServerConfig struct {
	Manager *Manager
	// Token is the required access token browsers present at /api/login.
	Token string
	// PublicOrigins are validated origins (scheme://host[:port]) of same-host
	// reverse proxies. Authentication is bound to the request Host.
	PublicOrigins []string
	Version       string
	// Assets overrides the embedded frontend (tests).
	Assets fs.FS
	// LogHeaders logs one record per request with its headers (credentials
	// redacted) and the outcome of the checks in ServeHTTP.
	LogHeaders bool
}

type SessionDetail struct {
	TurnTimings []TurnTiming `json:"turn_timings"`
	SessionSummary
	// Seq orders this snapshot against events on the same service.
	Seq              uint64                    `json:"seq"`
	Items            []agentapi.Item           `json:"items"`
	Interactions     []agentapi.Interaction    `json:"interactions"`
	Subagents        []agentapi.Subagent       `json:"subagents"`
	HistoryTruncated bool                      `json:"history_truncated"`
	LastSubmission   *Submission               `json:"last_submission"`
	BackgroundTasks  *agentapi.BackgroundTasks `json:"background_tasks,omitempty"`
	// Queue holds the prompts waiting for the running turn, oldest first.
	Queue []QueuedPrompt `json:"queue"`
	// QueuePaused is set while the queue waits for the user to resume or
	// clear it; it is never set with an empty queue.
	QueuePaused bool `json:"queue_paused"`
	// History says whether Items and Subagents hold the conversation's
	// recorded transcript (HistoryLoaded, HistoryLoading or
	// HistoryUnavailable); HistoryReason says why it is unavailable.
	History       string `json:"history"`
	HistoryReason string `json:"history_reason,omitempty"`
	// Present for paged clients, empty when all retained items are included.
	HistoryBefore *string `json:"history_before,omitempty"`
}

type SessionSummary struct {
	ID             string    `json:"id"`
	Provider       string    `json:"provider"`
	Name           string    `json:"name"`
	Workdir        string    `json:"workdir"`
	ConversationID string    `json:"conversation_id"`
	State          string    `json:"state"`
	StateDetail    string    `json:"state_detail"`
	Open           bool      `json:"open"`
	Pending        int       `json:"pending"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
	// Capabilities come from the provider so the browser can hide controls
	// the provider does not really support.
	Capabilities agentapi.Capabilities `json:"capabilities"`
	ProjectID    string                `json:"project_id"`
	// Model is the selected model; empty means the provider default.
	Model       string            `json:"model"`
	Effort      string            `json:"effort"`
	ContextSize string            `json:"context_size"`
	Context     *agentapi.Context `json:"context,omitempty"`
	// Usage is the AI units the Task's conversation used, main agent and
	// subagents together, once the provider reports them; it is not
	// persisted and after a restart comes back only from provider history.
	Usage *agentapi.Usage `json:"usage,omitempty"`
	// Title is the provider-generated title. Name may be empty; browsers
	// display name || title || "New task".
	Title string `json:"title"`
	// LastModel is the model the provider reported for the latest turn that
	// reported one. It is not persisted.
	LastModel string `json:"last_model"`
	// SubagentsRunning counts subagents that have not ended.
	SubagentsRunning int `json:"subagents_running"`
	// BackgroundTasksRunning counts the open conversation's background shell
	// tasks that have not finished.
	BackgroundTasksRunning int `json:"background_tasks_running"`
	// Queued counts prompts waiting in the Task's queue.
	Queued int `json:"queued"`
	// Mode is safe or yolo. A yolo Task's permission requests are allowed
	// once without asking; questions still wait for the user.
	Mode      string                   `json:"mode"`
	Execution *agentapi.ExecutionState `json:"execution"`
	// Stage is omitted for an active Task, otherwise StageSettled or
	// StageArchived; SettledAt and ArchivedAt say when.
	Stage      string    `json:"stage,omitempty"`
	SettledAt  time.Time `json:"settled_at,omitzero"`
	ArchivedAt time.Time `json:"archived_at,omitzero"`
	// SpawnedBy is the ID of the Task whose uam_create_task call created
	// this one; omitted otherwise.
	SpawnedBy string `json:"spawned_by,omitempty"`
	// Ask is the request the Task waits on, for the Task list to answer in
	// place; omitted when nothing waits for the user.
	Ask *Ask `json:"ask,omitempty"`
	// EventAt is when the provider last reported anything for the open
	// conversation, to the minute, so a quiet Task can say how long it has
	// been quiet. It is not persisted.
	EventAt time.Time `json:"event_at,omitzero"`
	// RoutineID is the ID of the routine whose run created this Task;
	// omitted otherwise.
	RoutineID string `json:"routine_id,omitempty"`
	// Diff totals the Task's own changes (the task scope of Changes); omitted
	// while it has none or they are not known yet.
	Diff *DiffStat `json:"diff,omitempty"`
	// RerunOf is the ID of the Task whose last message this one runs again
	// (Run again, Try with another model); omitted otherwise.
	RerunOf string `json:"rerun_of,omitempty"`
	// Outcome is a one-line summary of the last completed turn: a short
	// phrase from the Utility model, when one ran, then what the turn's tool
	// calls show (files changed, tests, failed commands). Omitted while a
	// turn runs, after one that did not complete, and when there is nothing
	// to say.
	Outcome string `json:"outcome,omitempty"`
	// Compacting is set while the open conversation is being compacted
	// (the /compact command or the provider's automatic compaction).
	Compacting bool `json:"compacting,omitempty"`
	// CompactThreshold is the share of the context, in percent, at which
	// the open conversation starts compacting: Settings' value when it
	// opened, which a later change reaches only when it reopens. Omitted
	// while no conversation is open.
	CompactThreshold int `json:"compact_threshold,omitempty"`
}

type Settings struct {
	// SendDefault is what Enter does while a turn runs: steer or queue.
	SendDefault string `json:"send_default"`
	// Terminal lets anyone signed in open a shell, as the service user, at a
	// Project's directory (terminal.go). Off by default.
	Terminal bool `json:"terminal"`
	// Planner turns on the planner (ADR 0005, board.go). Off by default, and
	// always sent, so a browser tells off from a service without it.
	Planner bool `json:"planner"`
	// HiddenModels lists, by provider, the model IDs the browser does not
	// offer, sorted; omitted when none is hidden. IDs the provider no longer
	// lists are kept. The service never refuses a hidden model.
	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: a model ID, or
	// store.WebTitleModelNone when the provider keeps its own title. A
	// provider without an entry uses ProviderInfo.CheapestModel. Omitted when
	// no provider has an entry.
	TitleModel map[string]string `json:"title_model,omitempty"`
	// CustomModels are the OpenAI-compatible models the owner brought;
	// omitted when there are none. Their model IDs are name/model_id.
	CustomModels []CustomModel `json:"custom_models,omitempty"`
	// TaskDefaults are the settings a new Task starts with; omitted when
	// unset, and the browser then starts from the provider's own defaults.
	TaskDefaults TaskDefaults `json:"task_defaults,omitzero"`
	// UtilityDailyLimit is how many Utility model calls UAM makes a day, 0
	// for none; omitted for store.DefaultUtilityDailyLimit (utility.go).
	UtilityDailyLimit *int `json:"utility_daily_limit,omitempty"`
	// SuggestReplies is false when replies to send next are not offered
	// after a turn (assist.go); omitted while they are, the default.
	SuggestReplies *bool `json:"suggest_replies,omitempty"`
	// CompactionThreshold is the share of the context, in percent, at which
	// a Task's conversation starts compacting; omitted for the provider
	// default, store.DefaultCompactionThreshold.
	CompactionThreshold *int `json:"compact_threshold,omitempty"`
	// SavedPrompts are the prompts the owner saved (prompts.go), oldest
	// first; omitted when there are none.
	SavedPrompts []SavedPrompt `json:"saved_prompts,omitempty"`
}

type SettingsPatch struct {
	SendDefault  *string
	Terminal     *bool
	Planner      *bool
	HiddenModels map[string][]string
	TitleModel   map[string]string
	CustomModels *[]store.WebCustomModel
	TaskDefaults *TaskDefaults
	UtilityLimit **int
	// SuggestReplies turns suggested replies on or off.
	SuggestReplies      *bool
	CompactionThreshold **int
}

type SinceSummary struct {
	// Text is "the agent finished, ran the tests, and changed 3 files".
	Text string `json:"text"`
	// IDs are the main agent's items after the mark, oldest first.
	IDs []string `json:"ids"`
}

type Stale struct {
	Behind   int      `json:"behind"`
	Diverged bool     `json:"diverged"`
	Files    []string `json:"files"`
}

type SubagentDetail struct {
	// Seq is the SSE sequence captured with the transcript and metadata.
	Seq      uint64            `json:"seq"`
	Subagent agentapi.Subagent `json:"subagent"`
	Items    []agentapi.Item   `json:"items"`
}

type Submission struct {
	RequestID     string                  `json:"request_id"`
	Status        string                  `json:"status"`
	Error         string                  `json:"error"`
	Time          time.Time               `json:"time"`
	CommandResult *agentapi.CommandResult `json:"command_result,omitempty"`
}

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

type SuggestRequest struct {
	Brief    string `json:"brief"`
	Document string `json:"document"`
	Max      int    `json:"max"`
}

type Suggestions struct {
	ItemID  string   `json:"item_id"`
	Replies []string `json:"replies"`
}

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

type Triage struct {
	Verdict  string `json:"verdict"`
	Sentence string `json:"sentence"`
	Head     string `json:"head"`
}

type TurnEvidence struct {
	Checks []EvidenceCheck `json:"checks"`
	Claims []EvidenceClaim `json:"claims"`
	Files  []TurnFile      `json:"files"`
	Since  *SinceSummary   `json:"since,omitempty"`
}

type TurnFile struct {
	Path      string `json:"path"`
	Additions *int   `json:"additions,omitempty"`
	Deletions *int   `json:"deletions,omitempty"`
}

type TurnTiming = store.TurnTiming

type UtilityCall struct {
	ID           int64     `json:"id"`
	At           time.Time `json:"at"`
	Day          string    `json:"day,omitempty"`
	Purpose      string    `json:"purpose"`
	Provider     string    `json:"provider,omitempty"`
	Model        string    `json:"model,omitempty"`
	TaskID       string    `json:"task_id,omitempty"`
	ProjectID    string    `json:"project_id,omitempty"`
	PromptChars  int       `json:"prompt_chars"`
	ReplyChars   int       `json:"reply_chars"`
	InputTokens  int64     `json:"input_tokens"`
	OutputTokens int64     `json:"output_tokens"`
	Estimated    bool      `json:"estimated,omitempty"`
	Credits      float64   `json:"credits,omitempty"`
	DurationMS   int64     `json:"duration_ms"`
	Outcome      string    `json:"outcome"`
	Reason       string    `json:"reason,omitempty"`
}

type UtilityDay struct {
	Day          string  `json:"day"`
	Calls        int     `json:"calls"`
	Errors       int     `json:"errors"`
	Skipped      int     `json:"skipped"`
	PromptChars  int64   `json:"prompt_chars"`
	ReplyChars   int64   `json:"reply_chars"`
	InputTokens  int64   `json:"input_tokens"`
	OutputTokens int64   `json:"output_tokens"`
	Estimated    bool    `json:"estimated,omitempty"`
	Credits      float64 `json:"credits,omitempty"`
}

type UtilityLog struct {
	Today UtilityToday  `json:"today"`
	Days  []UtilityDay  `json:"days"`
	Calls []UtilityCall `json:"calls"`
	Next  int64         `json:"next,omitempty"`
}

type UtilityModel struct {
	Provider string
	Model    string
}

type UtilityToday struct {
	Day      string    `json:"day"`
	Calls    int       `json:"calls"`
	Limit    int       `json:"limit"`
	Paused   bool      `json:"paused"`
	ResetsAt time.Time `json:"resets_at"`
}