web

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

type AccountView struct {
	agentapi.Account
	Linked *store.AccountLink `json:"linked,omitempty"`
}

type Aside struct {
	ID string `json:"id"`
	// Question is what the owner asked, without the earlier asides a
	// follow-up carries as context.
	Question   string    `json:"question"`
	Answer     string    `json:"answer"`
	Truncated  bool      `json:"truncated,omitempty"`
	AskedAt    time.Time `json:"asked_at"`
	AnsweredAt time.Time `json:"answered_at"`
	// Working is set when the agent was working on a turn when it was asked.
	Working bool `json:"working,omitempty"`
	// Turn is the turn the aside belongs to: the ID of the main
	// transcript's latest message the owner sent (not a steer) when it was
	// asked. Empty when there was none.
	Turn string `json:"turn,omitempty"`
}

type AsideReply struct {
	*agentapi.AsideAnswer
	Aside *Aside `json:"aside,omitempty"`
}

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 BranchEntry struct {
	Name      string    `json:"name"`
	Remote    bool      `json:"remote"`
	UpdatedAt time.Time `json:"updated_at,omitzero"`
}

type BranchList struct {
	Branches    []BranchEntry `json:"branches"`
	Reason      string        `json:"reason,omitempty"`
	Busy        *ThreadRef    `json:"busy,omitempty"`
	Uncommitted int           `json:"uncommitted"`
}

type BudgetView struct {
	Credits      float64  `json:"credits,omitempty"`
	Spent        float64  `json:"spent"`
	QuotaPercent float64  `json:"quota_percent,omitempty"`
	QuotaUsed    *float64 `json:"quota_used,omitempty"`
	Reached      bool     `json:"reached,omitempty"`
	WrappingUp   bool     `json:"wrapping_up,omitempty"`
}

type CLIRestart struct {
	Interrupted int `json:"interrupted"`
}

type ChangedFile struct {
	CountsUnknown bool   `json:"counts_unknown,omitempty"`
	Binary        bool   `json:"binary,omitempty"`
	Truncated     bool   `json:"truncated,omitempty"`
	OldPath       string `json:"old_path,omitempty"`
	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"`
	// Prefix is the Thread's folder inside the repository, such as "sub/",
	// on the git scopes: Files are repository paths, and files open in the
	// folder ("" when it is the top level).
	Prefix string `json:"prefix,omitempty"`
	// 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"`
	Options json.RawMessage `json:"options,omitempty"`
	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 Configuration struct {
	Discovery        map[string]ConfigurationDiscovery `json:"discovery,omitempty"`
	Scope            string                            `json:"scope"`
	ProjectID        string                            `json:"project_id,omitempty"`
	TerminalAllowed  bool                              `json:"terminal_allowed"`
	Agents           []ConfigurationFile               `json:"agents"`
	Skills           []ConfigurationFile               `json:"skills"`
	Hooks            []ConfigurationFile               `json:"hooks"`
	Instructions     ConfigurationFile                 `json:"instructions"`
	InstructionFiles []ConfigurationFile               `json:"instruction_files"`
	Conflicts        []ConfigurationConflict           `json:"conflicts,omitempty"`
	ConflictWarnings []string                          `json:"conflict_warnings,omitempty"`
	ConflictDetails  []ConfigurationConflictDetail     `json:"conflict_details,omitempty"`
}

type ConfigurationConflict struct {
	Kind  string   `json:"kind"`
	Name  string   `json:"name"`
	Paths []string `json:"paths"`
}

type ConfigurationConflictDetail struct {
	Kind    string `json:"kind"`
	Path    string `json:"path,omitempty"`
	Message string `json:"message"`
}

type ConfigurationDiscovery struct {
	Supported bool     `json:"supported"`
	Ready     bool     `json:"ready"`
	Warnings  []string `json:"warnings,omitempty"`
}

type ConfigurationDraft struct {
	Name                   string                         `json:"name"`
	Description            string                         `json:"description,omitempty"`
	Prompt                 string                         `json:"prompt,omitempty"`
	Model                  string                         `json:"model,omitempty"`
	Tools                  *[]string                      `json:"tools,omitempty"`
	DisableModelInvocation *bool                          `json:"disable_model_invocation,omitempty"`
	UserInvocable          *bool                          `json:"user_invocable,omitempty"`
	Event                  string                         `json:"event,omitempty"`
	Bash                   string                         `json:"bash,omitempty"`
	Powershell             string                         `json:"powershell,omitempty"`
	Cwd                    string                         `json:"cwd,omitempty"`
	TimeoutSec             *int                           `json:"timeout_sec,omitempty"`
	Env                    map[string]string              `json:"env,omitempty"`
	Provider               string                         `json:"provider"`
	UtilityModel           string                         `json:"utility_model"`
	SimilarSkills          []ConfigurationSkillSuggestion `json:"similar_skills"`
}

type ConfigurationFile struct {
	Name    string `json:"name"`
	Path    string `json:"path"`
	Content string `json:"content"`
	// Description is the frontmatter description of a listed agent or skill.
	Description    string                            `json:"description,omitempty"`
	Revision       string                            `json:"revision"`
	Editable       bool                              `json:"editable"`
	Disabled       bool                              `json:"disabled,omitempty"`
	Error          string                            `json:"error,omitempty"`
	ReadOnlyReason string                            `json:"read_only_reason,omitempty"`
	Native         *agentapi.ConfigurationDefinition `json:"native,omitempty"`
	MetadataOnly   bool                              `json:"metadata_only,omitempty"`
}

type ConfigurationSkillSuggestion struct {
	Name      string `json:"name"`
	Path      string `json:"path"`
	ProjectID string `json:"project_id,omitempty"`
	Reason    string `json:"reason"`
}

type Connection struct {
	ID            string   `json:"id"`
	InstanceID    string   `json:"instance_id"`
	Label         string   `json:"label"`
	BaseURL       string   `json:"base_url"`
	Enabled       bool     `json:"enabled"`
	Generation    uint64   `json:"generation"`
	HasKey        bool     `json:"has_key"`
	Version       string   `json:"version"`
	ProtocolMajor int      `json:"protocol_major"`
	Capabilities  []string `json:"capabilities"`
	AllowPrivate  bool     `json:"allow_private"`
}

type ContextBreakdown struct {
	Info        *agentapi.ContextInfo        `json:"info,omitempty"`
	Attribution *agentapi.ContextAttribution `json:"attribution,omitempty"`
}

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"`
	Agent       string `json:"agent"` // custom agent ID; "" is the provider's default
	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"`
	// Place is where the Thread runs; nil is the Project's current branch.
	Place *PlaceRequest `json:"place,omitempty"`
	// 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"`
	Vision      bool   `json:"vision,omitempty"`
	WireAPI     string `json:"wire_api,omitempty"`
	APIKeyEnv   string `json:"api_key_env"`
	KeyPresent  bool   `json:"key_present"`
	KeyError    string `json:"key_error,omitempty"`
}

type DaemonConfig struct {
	Listen        string
	PublicOrigins []string
	Providers     []agentapi.Provider
	Version       string
	// LogHeaders logs every request's headers (see ServerConfig).
	LogHeaders bool
	// Executable is the real path of the uam binary, which Settings offers
	// to restart onto once another version is installed there. RunDaemon
	// resolves it when empty; runDaemon without one cannot restart.
	Executable string
	// contains filtered or unexported fields
}

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 DecisionOption struct {
	ID          string `json:"id"`
	Description string `json:"description"`
}

type DecisionRequest struct {
	Purpose      string
	Instructions string
	Input        string
	Options      []DecisionOption
	// TaskID, when set, is the Thread the decision is for, named in its
	// Utility log entry.
	TaskID string
}

type DecisionResult struct {
	Choice    string
	Abstained bool
}

type DeviceSignIn struct {
	State   string       `json:"state"`
	URL     string       `json:"verification_uri,omitempty"`
	Code    string       `json:"user_code,omitempty"`
	Notice  string       `json:"notice,omitempty"`
	Error   string       `json:"error,omitempty"`
	Account *AccountView `json:"account,omitempty"`
}

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 {
	Name      string `json:"name"`
	APIKey    string `json:"api_key"`
	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 DiskInfo struct {
	FreeBytes  uint64 `json:"free_bytes"`
	TotalBytes uint64 `json:"total_bytes"`
	Low        bool   `json:"low"`
}

type DrawIOCheck struct {
	OK       bool         `json:"ok"`
	Errors   []string     `json:"errors"`
	Warnings []string     `json:"warnings"`
	Detail   DrawIODetail `json:"detail"`
}

type DrawIODetail struct {
	Public    bool `json:"public"`
	CORS      bool `json:"cors"`
	FramingOK bool `json:"framing_ok"`
}

type DrawIOSettings struct {
	Origin  string `json:"origin,omitempty"`
	Enabled bool   `json:"enabled,omitempty"`
}

type DrawingChange struct {
	Kind string `json:"kind"`
	Text string `json:"text"`
}

type DrawingSave struct {
	Content     string `json:"content"`
	Format      string `json:"format"`
	BaseVersion *int   `json:"base_version"`
	Origin      string `json:"origin"`
	ItemID      string `json:"item_id"`
	FenceIndex  int    `json:"fence_index"`
}

type DrawingSaveResult struct {
	Version      int               `json:"version"`
	AgentVersion int               `json:"agent_version"`
	Changes      []DrawingChange   `json:"changes"`
	Status       map[string]string `json:"status"`
	Note         string            `json:"note"`
}

type DrawingSummary struct {
	Path         string `json:"path"`
	Format       string `json:"format"`
	Version      int    `json:"version"`
	AgentVersion int    `json:"agent_version"`
	ItemID       string `json:"item_id"`
	FenceIndex   int    `json:"fence_index"`
	ChangesCount int    `json:"changes_count"`
}

type DrawingView struct {
	Path         string            `json:"path"`
	Format       string            `json:"format"`
	Version      int               `json:"version"`
	AgentVersion int               `json:"agent_version"`
	Content      string            `json:"content"`
	Baseline     *string           `json:"baseline"`
	Changes      []DrawingChange   `json:"changes"`
	Status       map[string]string `json:"status"`
	Note         string            `json:"note"`
}

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 refusal, such as utility_paused. Refs lists what it
	// refused over, such as the Projects that share a name.
	Code string
	Refs []string
	// Pending is the unsaved git work a settle or archive was refused over.
	Pending *GitPending
}

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 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 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 ForkRequest struct {
	UserItemID string `json:"user_item_id"`
	Model      string `json:"model"`
	RequestID  string `json:"request_id"`
}

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

type GitLabCommit struct {
	SHA       string    `json:"sha"`
	Branch    string    `json:"branch"`
	TaskID    string    `json:"task_id"`
	TaskName  string    `json:"task_name"`
	CreatedAt time.Time `json:"created_at"`
}

type GitLabDiscussion struct {
	ID             string             `json:"id"`
	IndividualNote bool               `json:"individual_note"`
	Notes          []GitLabReviewNote `json:"notes"`
}

type GitLabItemSummary struct {
	Ref        string `json:"ref"`
	Kind       string `json:"kind"`
	Title      string `json:"title,omitempty"`
	State      string `json:"state,omitempty"`
	Draft      bool   `json:"draft,omitempty"`
	PipelineID int64  `json:"pipeline_id,omitempty"`
	// PipelineState is a merge request's head pipeline status.
	PipelineState string `json:"pipeline_state,omitempty"`
	WebURL        string `json:"web_url,omitempty"`
	Error         string `json:"error,omitempty"`
	// Stale marks the last known state, kept while GitLab rate limits reads.
	Stale bool `json:"stale,omitempty"`
	// FailureKind and FailureDetail say what a failed job failed on
	// ("Tests failed", "2 tests"); see gitlab_failure.go.
	FailureKind   string `json:"failure_kind,omitempty"`
	FailureDetail string `json:"failure_detail,omitempty"`
	// contains filtered or unexported fields
}

type GitLabJob struct {
	ID           int64    `json:"id"`
	Name         string   `json:"name"`
	Stage        string   `json:"stage"`
	Status       string   `json:"status"`
	AllowFailure bool     `json:"allow_failure"`
	WebURL       string   `json:"web_url"`
	Duration     *float64 `json:"duration,omitempty"`
	// FailureReason is GitLab's reason a failed job failed, such as
	// script_failure or runner_system_failure.
	FailureReason string `json:"failure_reason,omitempty"`
}

type GitLabJobTrace struct {
	Text      string `json:"text"`
	Truncated bool   `json:"truncated"`
}

type GitLabMergeRequest struct {
	IID    int64  `json:"iid"`
	Title  string `json:"title"`
	State  string `json:"state"`
	Draft  bool   `json:"draft"`
	WebURL string `json:"web_url"`
}

type GitLabOrigin struct {
	Host string `json:"host"`
	Path string `json:"path"`
}

type GitLabPipeline struct {
	ID        int64    `json:"id"`
	Status    string   `json:"status"`
	SHA       string   `json:"sha"`
	Ref       string   `json:"ref"`
	WebURL    string   `json:"web_url"`
	Duration  *float64 `json:"duration,omitempty"`
	CreatedAt string   `json:"created_at"`
	UpdatedAt string   `json:"updated_at"`
}

type GitLabPipelineDetail struct {
	Pipeline GitLabPipeline `json:"pipeline"`
	Jobs     []GitLabJob    `json:"jobs"`
}

type GitLabPipelineState struct {
	Supported           bool                 `json:"supported"`
	Message             string               `json:"message,omitempty"`
	AutoInvestigate     bool                 `json:"auto_investigate"`
	Commit              *GitLabCommit        `json:"commit,omitempty"`
	Pipeline            *GitLabPipeline      `json:"pipeline,omitempty"`
	MergeRequests       []GitLabMergeRequest `json:"merge_requests,omitempty"`
	Jobs                []GitLabJob          `json:"jobs,omitempty"`
	InvestigationTaskID string               `json:"investigation_task_id,omitempty"`
	CanInvestigate      bool                 `json:"can_investigate"`
	Reason              string               `json:"reason,omitempty"`
	CheckedAt           *time.Time           `json:"checked_at,omitempty"`
	Error               string               `json:"error,omitempty"`
	// Origin is the Thread's signed-in GitLab project; its items in the
	// conversation open in the side panel.
	Origin *GitLabOrigin `json:"origin,omitempty"`
	// contains filtered or unexported fields
}

type GitLabReview struct {
	MergeRequest GitLabReviewMergeRequest `json:"merge_request"`
	Discussions  []GitLabDiscussion       `json:"discussions"`
	Truncated    bool                     `json:"truncated"`
	CheckedAt    time.Time                `json:"checked_at"`
	// contains filtered or unexported fields
}

type GitLabReviewActionRequest struct {
	CommitSHA    string `json:"commit_sha"`
	DiscussionID string `json:"discussion_id"`
	Action       string `json:"action"`
	RequestID    string `json:"request_id"`
	Mode         string `json:"mode,omitempty"`
}

type GitLabReviewAuthor struct {
	Name     string `json:"name"`
	Username string `json:"username"`
}

type GitLabReviewMergeRequest struct {
	GitLabMergeRequest
	SourceBranch string              `json:"source_branch"`
	TargetBranch string              `json:"target_branch"`
	HeadSHA      string              `json:"head_sha"`
	Author       *GitLabReviewAuthor `json:"author,omitempty"`
	HeadPipeline *GitLabPipeline     `json:"head_pipeline,omitempty"`
}

type GitLabReviewNote struct {
	ID         int64                 `json:"id"`
	Body       string                `json:"body"`
	Author     GitLabReviewAuthor    `json:"author"`
	CreatedAt  string                `json:"created_at"`
	UpdatedAt  string                `json:"updated_at"`
	Resolvable bool                  `json:"resolvable"`
	Resolved   bool                  `json:"resolved"`
	System     bool                  `json:"system"`
	Position   *GitLabReviewPosition `json:"position,omitempty"`
}

type GitLabReviewPosition struct {
	OldPath  string `json:"old_path"`
	NewPath  string `json:"new_path"`
	OldLine  *int   `json:"old_line,omitempty"`
	NewLine  *int   `json:"new_line,omitempty"`
	BaseSHA  string `json:"base_sha"`
	HeadSHA  string `json:"head_sha"`
	StartSHA string `json:"start_sha"`
}

type GitLabWorkItem struct {
	Ref         string               `json:"ref"`
	IID         int64                `json:"iid"`
	Kind        string               `json:"kind"`
	Title       string               `json:"title"`
	State       string               `json:"state"`
	WebURL      string               `json:"web_url,omitempty"`
	Author      *GitLabReviewAuthor  `json:"author,omitempty"`
	CreatedAt   string               `json:"created_at,omitempty"`
	Labels      []string             `json:"labels"`
	Assignees   []GitLabReviewAuthor `json:"assignees"`
	Milestone   string               `json:"milestone,omitempty"`
	Description string               `json:"description,omitempty"`
	Parent      *GitLabWorkItemLink  `json:"parent,omitempty"`
	Children    []GitLabWorkItemLink `json:"children"`
	ChildCount  int                  `json:"child_count"`
}

type GitLabWorkItemLink struct {
	Ref    string `json:"ref,omitempty"`
	IID    int64  `json:"iid"`
	Kind   string `json:"kind"`
	Title  string `json:"title"`
	State  string `json:"state"`
	WebURL string `json:"web_url,omitempty"`
}

type GitPending struct {
	Uncommitted int `json:"uncommitted"`
	Unpushed    int `json:"unpushed"`
}

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 HarnessCollection struct {
	Status       string    `json:"status"`
	UpdatedAt    time.Time `json:"updated_at,omitzero"`
	CopilotSince time.Time `json:"copilot_since"`
}

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

type LoadedSkill struct {
	Name        string    `json:"name"`
	Description string    `json:"description,omitempty"`
	FirstAt     time.Time `json:"first_at"`
	Count       int       `json:"count"`
}

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"`
	Callback bool   `json:"callback,omitempty"`
}

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

type Meta struct {
	InstanceID      string         `json:"instance_id"`
	ProtocolMajor   int            `json:"protocol_major"`
	Capabilities    []string       `json:"capabilities"`
	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"`
	// Service is the uam installed at the service's binary path and the
	// restart onto it (GET /api/service), as last read.
	Service *ServiceStatus `json:"service,omitempty"`
	// Disk is the filesystem holding the Thread worktrees, low below 10%
	// free; omitted when it cannot be read.
	Disk *DiskInfo `json:"disk,omitempty"`
}

type ModelCalls struct {
	// Threads counts the Threads whose main agent has a model call in
	// flight, compaction included; Subagents the subagent model calls in
	// flight, in a turn or after it; Background the Background AI (Utility)
	// calls in flight.
	Threads    int `json:"threads"`
	Subagents  int `json:"subagents"`
	Background int `json:"background"`
	// Local counts the Threads running a tool, a subagent's between turns
	// included, with no model call in flight.
	Local int `json:"local"`
	// Busy counts the Threads behind any of these, each once: a Thread whose
	// subagents alone call the model is in no other count.
	Busy int `json:"busy"`
	// ModelThreads, SubagentThreads and LocalThreads name the Threads the
	// counts come from, by ID, sorted: whose main agent has a model call in
	// flight, which have subagent calls in flight, and which run a tool. At
	// most maxModelCallThreads each; the counts stay whole.
	ModelThreads    []string `json:"model_threads"`
	SubagentThreads []string `json:"subagent_threads"`
	LocalThreads    []string `json:"local_threads"`
}

type ModelTokenPrice struct {
	Provider string               `json:"provider"`
	Model    string               `json:"model"`
	Rates    *store.WebTokenPrice `json:"rates"`
	Source   string               `json:"source"` // manual, bundled, or unpriced
}

type ModelTokens struct {
	Provider string `json:"provider"`
	Model    string `json:"model"`
	TokenCounts
	CostUSD     *float64 `json:"cost_usd"`
	CostPartial bool     `json:"cost_partial,omitempty"`
}

type Phase struct {
	Kind string `json:"kind"`
	// By is PhaseByCompaction while the call shown compacts, and
	// PhaseBySubagent between turns for a subagent's call or tool; ""
	// otherwise.
	By string `json:"by,omitempty"`
	// Since is when the request, the oldest model call or the tool shown
	// started.
	Since time.Time `json:"since"`
	// Model is the model a model phase calls; Tool is the tool a local
	// phase runs.
	Model string `json:"model,omitempty"`
	Tool  string `json:"tool,omitempty"`
	// Detail is the local tool's short argument, a subagent's description
	// for its call (By subagent), or what the owner is asked: "approve
	// bash", "answer question", "review plan".
	Detail string `json:"detail,omitempty"`
	// Calls counts the model calls in flight, the main agent's (compaction
	// included) and its subagents', in any phase; Subagents how many are
	// subagents'.
	Calls     int `json:"calls,omitempty"`
	Subagents int `json:"subagents,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 PlaceRequest struct {
	Mode string `json:"mode"`
	Base string `json:"base,omitempty"`
	// Branch is the branch mode switch checks out: a local one, or with
	// Remote a remote-tracking one ("origin/main"), which a new local
	// branch of the same name then tracks.
	Branch string `json:"branch,omitempty"`
	Remote bool   `json:"remote,omitempty"`
}

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 ProviderCLI struct {
	// Installed is the release on disk; Running, while set, is the older
	// one the CLI still runs after an update, until no Task works or waits
	// and it restarts.
	Installed string `json:"installed,omitempty"`
	Running   string `json:"running,omitempty"`
	Latest    string `json:"latest,omitempty"`
	// UpdateAvailable: Latest is newer than Installed, the SDK did not
	// refuse it, and the CLI can be updated here.
	UpdateAvailable bool   `json:"update_available"`
	Manual          string `json:"manual,omitempty"`
	// Incompatible is the newest release the SDK refused; it is not offered
	// again while this service runs.
	Incompatible string `json:"incompatible,omitempty"`
	// CheckedAt is when the releases were last read; CheckError why the
	// last read failed, the releases shown being the ones read before.
	CheckedAt  time.Time `json:"checked_at,omitzero"`
	CheckError string    `json:"check_error,omitempty"`
	State      string    `json:"state"`
	// Target is the release being installed, or the last one tried.
	Target string `json:"target,omitempty"`
	Error  string `json:"error,omitempty"`
	// Stalled counts the turns the running CLI's model requests stalled
	// twice in since it started: a sign its connections are dead and a
	// restart (POST .../cli/restart) is due.
	Stalled int `json:"stalled,omitempty"`
}

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"`
	// AccountMismatch is set when the provider is unavailable because its
	// runtime is signed in as another account than the one this server is
	// linked to; Reason then says which.
	AccountMismatch bool                  `json:"account_mismatch,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"`
	// CLIUpdate is the newest release of the provider's CLI while an update
	// to it is available (ProviderCLI.UpdateAvailable).
	CLIUpdate string `json:"cli_update,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"`
	// Unit is agentapi.QuotaUnitCredits or QuotaUnitRequests, absent when
	// the provider has not said; Plan is the account's plan tier.
	Unit string `json:"unit,omitempty"`
	Plan string `json:"plan,omitempty"`
}

type RemovedWorktree struct {
	Path      string    `json:"path"`
	Branch    string    `json:"branch"`
	ProjectID string    `json:"project_id,omitempty"`
	TaskID    string    `json:"task_id,omitempty"`
	Thread    string    `json:"thread,omitempty"`
	SizeBytes int64     `json:"size_bytes,omitempty"`
	At        time.Time `json:"at"`
}

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

type ResendRequest struct {
	Rewind RewindRequest `json:"rewind"`
	Prompt PromptRequest `json:"prompt"`
}

type ResendResult struct {
	Rewind     RewindReceipt `json:"rewind"`
	Submission *Submission   `json:"submission,omitempty"`
	SendError  string        `json:"send_error,omitempty"`
	SendCode   string        `json:"send_code,omitempty"`
}

type RewindPreview struct {
	UserItemID     string                     `json:"user_item_id"`
	Token          string                     `json:"token"`
	Turns          int                        `json:"turns"`
	FilesAvailable bool                       `json:"files_available"`
	FilesReason    string                     `json:"files_reason,omitempty"`
	Files          agentapi.NativeTurnChanges `json:"files"`
}

type RewindReceipt struct {
	RequestID       string                 `json:"request_id"`
	UserItemID      string                 `json:"user_item_id"`
	Mode            string                 `json:"mode"`
	State           string                 `json:"state"`
	Result          *agentapi.RewindResult `json:"result,omitempty"`
	ReconcileFailed bool                   `json:"reconcile_failed,omitempty"`
	// Released means the owner cleared the hold with the outcome unknown.
	Released bool `json:"released,omitempty"`
}

type RewindRequest struct {
	UserItemID string `json:"user_item_id"`
	Mode       string `json:"mode"`
	Token      string `json:"token"`
	RequestID  string `json:"request_id"`
}

type RewindStatus struct {
	RequestID string `json:"request_id"`
	State     string `json:"state"`
	Mode      string `json:"mode"`
	Outcome   string `json:"outcome,omitempty"`
	// ReconcileFailed offers the explicit release.
	ReconcileFailed bool `json:"reconcile_failed,omitempty"`
}

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"`
	Autopilot     bool                  `json:"autopilot"`
	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"`
	Autopilot     *bool                  `json:"autopilot"`
	MaxRunsPerDay *int                   `json:"max_runs_per_day"`
	MaxMinutes    *int                   `json:"max_minutes"`
}

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

type SearchHit struct {
	ThreadID string        `json:"thread_id"`
	Snippet  []SnippetPart `json:"snippet"`
}

type SearchResults struct {
	Available bool        `json:"available"`
	Reason    string      `json:"reason,omitempty"`
	Hits      []SearchHit `json:"hits"`
}

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 ServiceStatus struct {
	Running string `json:"running"`
	// Installed is the version at the binary's path, read when the file
	// changed; empty while it cannot be read (Error says why).
	Installed string `json:"installed,omitempty"`
	// Restart: none, available (Installed differs from Running), pending
	// (requested, waiting for no Task to work or wait) or restarting.
	Restart string `json:"restart"`
	Error   string `json:"error,omitempty"`
}

type SessionDetail struct {
	PlanVersion uint64       `json:"plan_version,omitempty"`
	PlanPath    string       `json:"plan_path,omitempty"`
	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"`
	TurnActivity     *TurnActivity             `json:"turn_activity,omitempty"`
	// Schedules is the open conversation's native schedules, display only.
	Schedules *agentapi.ScheduleSnapshot  `json:"schedules,omitempty"`
	MCPStatus *agentapi.MCPStatusSnapshot `json:"mcp_status,omitempty"`
	// SkillsLoaded lists the skills the Task's agents loaded, first loaded
	// first; skill loads are not transcript items.
	SkillsLoaded []LoadedSkill `json:"skills_loaded,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"`
	// Drawings are the Thread's editable diagrams (drawings.go).
	Drawings []DrawingSummary `json:"drawings"`
}

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

type SessionStats struct {
	Path  string        `json:"path"`
	Stats []SessionStat `json:"stats"`
}

type SessionSummary struct {
	ID       string `json:"id"`
	Provider string `json:"provider"`
	Name     string `json:"name"`
	Workdir  string `json:"workdir"`
	// RealWorkdir is Workdir with symbolic links resolved, when that differs,
	// so a path an agent writes through either spelling names the same file.
	RealWorkdir    string    `json:"real_workdir,omitempty"`
	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"`
	Agent       string            `json:"agent,omitempty"` // custom agent ID; "" is the provider's default
	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"`
	// Budget is the Thread's spending limit and how much of it is used;
	// omitted without one.
	Budget *BudgetView `json:"budget,omitempty"`
	// Handoff is what the Thread left when it reached its budget: the main
	// agent's reply that is the handoff (reply_id; no_reply says why there
	// is none) and uam's facts in Markdown. Omitted without one; the
	// Thread's next turn clears it.
	Handoff *store.WebHandoff `json:"handoff,omitempty"`
	// Title is the provider-generated title. Name may be empty; browsers
	// display name || title || "New task".
	Title string `json:"title"`
	// TitlePending is set while a title job is queued or running, or waits
	// for the first turn's reply.
	TitlePending bool `json:"title_pending,omitempty"`
	// 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, yolo or assisted. A yolo Task's permission requests are
	// allowed once without asking, an assisted Task's when the provider's
	// assisted review approves them; questions still wait for the user.
	Mode      string                   `json:"mode"`
	Execution *agentapi.ExecutionState `json:"execution"`
	// ModeUnknown is set when a failed change left the runtime's permission
	// mode unreadable: Mode is what UAM applies at the next change or open,
	// not a fact, and nothing is allowed automatically.
	ModeUnknown bool `json:"mode_unknown,omitempty"`
	// 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"`
	// SettledBy is "auto" when the Task settled itself after a quiet week,
	// "reviewed" when it settled once the owner saw a reply checked done;
	// omitted when the owner settled it.
	SettledBy string `json:"settled_by,omitempty"`
	// 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"`
	// GitPending is the unsaved git work of the repository holding the
	// Task's directory, shared by every Task there (git_pending.go); omitted
	// outside a repository or before the first read.
	GitPending *GitPending `json:"git_pending,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"`
	// ForkOf is the source Task whose selected recorded prefix this Task copied.
	ForkOf         string `json:"fork_of,omitempty"`
	ForkUserItemID string `json:"fork_user_item_id,omitempty"`
	// NotStarted is set on a branch that has had no turn of its own: it is
	// closed only until its first message.
	NotStarted bool `json:"not_started,omitempty"`
	// Rewind is a native rewind that still holds the Task until reconciled.
	Rewind RewindStatus `json:"rewind,omitzero"`
	// Branch is the branch checked out in Workdir, as last read; omitted
	// when HEAD is detached, Workdir is in no git work tree, or git cannot
	// tell.
	Branch string `json:"branch,omitempty"`
	// Worktree is the git worktree the Thread was started in and the branch
	// made for it; omitted for a Thread in its Project's folder.
	Worktree WorktreeInfo `json:"worktree,omitzero"`
	// 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"`
	// CompactingBackground is set while the provider's automatic compaction
	// runs beside the open conversation's turn, which goes on meanwhile: the
	// Task is working, not compacting. Live only, never persisted.
	CompactingBackground bool `json:"compacting_background,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"`
	// StopReason says why the last turn was cancelled, while the Task is:
	// owner (Stop), time_limit (a routine's), credit_limit (autopilot's),
	// budget (the Thread's), remote (a remote command) or mcp (an MCP server). Omitted otherwise,
	// also when the provider gave no reason.
	StopReason string `json:"stop_reason,omitempty"`
}

type Settings struct {
	TokenPrices map[string]map[string]store.WebTokenPrice `json:"token_prices,omitempty"`
	// SendDefault is what Enter does while a turn runs: steer or queue.
	SendDefault string `json:"send_default"`
	// DefaultProjectDir is the initial folder for browsing on this instance; empty uses home.
	DefaultProjectDir string `json:"default_project_dir,omitempty"`
	// 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"`
	// 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"`
	// SubagentModels lists, by provider, the model IDs its subagents may
	// use, the fallback first; omitted when no provider is limited.
	SubagentModels map[string][]string `json:"subagent_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"`
	// UtilityUnlimited lifts the daily limit; UtilityDailyLimit is kept for
	// when it is turned off.
	UtilityUnlimited bool `json:"utility_unlimited,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"`
	// GitHubMCP lets Tasks start the provider's built-in GitHub MCP server
	// (agentapi.GitHubMCPUser); omitted while off, the default.
	GitHubMCP bool `json:"github_mcp,omitempty"`
	// GitLabAutoInvestigate starts an investigation when a Task's own
	// GitLab pipeline fails; omitted while off, the default.
	GitLabAutoInvestigate bool `json:"gitlab_auto_investigate,omitempty"`
	// GitLabMRPrompt is the owner's prompt for merge request descriptions
	// (mr_description.go); omitted while the default is used.
	GitLabMRPrompt string `json:"gitlab_mr_prompt,omitempty"`
	// WorktreesDir is the absolute folder new Thread worktrees go in;
	// omitted while the default, ~/.uam/worktrees, is used.
	WorktreesDir string `json:"worktrees_dir,omitempty"`
	// DrawIO is the opt-in draw.io editor for drawings (drawings_drawio.go);
	// omitted while unset.
	DrawIO DrawIOSettings `json:"drawio,omitzero"`
}

type SettingsPatch struct {
	TokenPrices       *map[string]map[string]store.WebTokenPrice
	SendDefault       *string
	DefaultProjectDir *string
	Terminal          *bool
	HiddenModels      map[string][]string
	SubagentModels    map[string][]string
	TitleModel        map[string]string
	CustomModels      *[]store.WebCustomModel
	TaskDefaults      *TaskDefaults
	UtilityLimit      **int
	UtilityUnlimited  *bool
	// SuggestReplies turns suggested replies on or off.
	SuggestReplies        *bool
	CompactionThreshold   **int
	GitHubMCP             *bool
	GitLabAutoInvestigate *bool
	// GitLabMRPrompt sets the merge request description prompt; "" or the
	// default itself puts the default back.
	GitLabMRPrompt *string
	// WorktreesDir sets the folder new worktrees go in; "" puts the
	// default back. A leading ~ is the home folder.
	WorktreesDir *string
	// DrawIO sets the draw.io editor's origin and whether it is enabled.
	// The HTTP handler checks the origin before it enables it.
	DrawIO *DrawIOSettings
}

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 SnippetPart struct {
	Text  string `json:"text"`
	Match bool   `json:"match,omitempty"`
}

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 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 ThreadRef struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type TimeSplit struct {
	// ModelMS is nil when the journal records no model call durations (CLIs
	// before session.usage_record), compactions or not: their time alone
	// would understate it. ModelCalls counts the compactions too, when
	// ModelMS is set.
	ModelMS    *int64 `json:"model_ms"`
	ModelCalls int    `json:"model_calls"`
	LocalMS    int64  `json:"local_ms"`
	LocalRuns  int    `json:"local_runs"`
	WaitingMS  int64  `json:"waiting_ms"`
	// Waits counts permission requests, ask_user questions and elicitations,
	// answered at once or not.
	Waits int `json:"waits"`
	// Tools is each tool's own run time without waiting, longest first; runs
	// overlapping each other or a model call count in full, so the rows may
	// add up to more than LocalMS.
	Tools []TimeSplitTool `json:"tools"`
}

type TimeSplitTool struct {
	Name string `json:"name"`
	MS   int64  `json:"ms"`
	Runs int    `json:"runs"`
}

type TodoCounts = store.TodoCounts

type TodoHistory struct {
	Live  *TodoView   `json:"live"`
	Turns []TurnTodos `json:"turns"`
}

type TodoView struct {
	// Known is false while the list could not be read, and while no
	// conversation is open.
	Known bool `json:"known"`
	// Touched is set once the list changed in the running turn; it keeps
	// the last turn's answer between turns.
	Touched bool `json:"touched"`
	// Todos holds the first maxTodoRows rows, in the provider's order.
	Todos []agentapi.Todo `json:"todos"`
	// Omitted counts the rows past them.
	Omitted int `json:"omitted,omitempty"`
	// Counts counts every row.
	Counts TodoCounts `json:"counts"`
	// Now is the id of the row in progress the work is at (todoNow).
	Now string `json:"now,omitempty"`
}

type TokenCounts struct {
	Input      int64 `json:"input"`
	Output     int64 `json:"output"`
	CacheRead  int64 `json:"cache_read"`
	CacheWrite int64 `json:"cache_write"`
	Total      int64 `json:"total"`
}

type TokenPeriod struct {
	Models         []ModelTokens `json:"models"`
	Total          TokenCounts   `json:"total"`
	CostUSD        *float64      `json:"cost_usd"`
	UnpricedModels int           `json:"unpriced_models"`
}

type TokenUsageReport struct {
	Since      time.Time              `json:"since"`
	Today      string                 `json:"today"`
	Periods    map[string]TokenPeriod `json:"periods"`
	Collection *HarnessCollection     `json:"collection,omitempty"`
}

type TurnActivity struct {
	Plan   bool            `json:"plan,omitempty"`
	Intent string          `json:"intent,omitempty"`
	Retry  *agentapi.Retry `json:"retry,omitempty"`
	Todos  TodoView        `json:"todos"`
	Phase  *Phase          `json:"phase,omitempty"`
}

type TurnChanges struct {
	TimingID string                    `json:"timing_id"`
	EndedAt  time.Time                 `json:"ended_at"`
	Counts   store.TurnChangeCounts    `json:"counts"`
	Files    []agentapi.NativeTurnFile `json:"files"`
}

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 TurnTodos struct {
	TimingID string    `json:"timing_id"`
	EndedAt  time.Time `json:"ended_at"`
	// Intent is the turn's last intent.
	Intent string         `json:"intent,omitempty"`
	Todos  []snapshotTodo `json:"todos"`
	// Counts counts every row in scope; Omitted those past Todos.
	Counts TodoCounts `json:"counts"`
}

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"`
	SessionModel bool      `json:"session_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"`
	Answer       string    `json:"answer,omitempty"`
	Valid        *bool     `json:"valid,omitempty"`
	Retry        bool      `json:"retry,omitempty"`
	Fallback     bool      `json:"fallback,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"`
	Unlimited      bool      `json:"unlimited,omitempty"`
	Paused         bool      `json:"paused"`
	PausedPurposes []string  `json:"paused_purposes,omitempty"`
	ResetsAt       time.Time `json:"resets_at"`
}

type WorktreeEntry struct {
	Path      string `json:"path"`
	Branch    string `json:"branch,omitempty"`
	ProjectID string `json:"project_id,omitempty"`
	TaskID    string `json:"task_id,omitempty"`
	Thread    string `json:"thread,omitempty"`
	Stage     string `json:"stage,omitempty"`
	// SizeBytes is omitted until measured; SizePartial says the walk
	// stopped early, so the size is at least that.
	SizeBytes   *int64 `json:"size_bytes,omitempty"`
	SizePartial bool   `json:"size_partial,omitempty"`
	// Uncommitted counts changed files, untracked ones included, which a
	// removal loses; Unpushed counts commits on no remote.
	Uncommitted int `json:"uncommitted"`
	Unpushed    int `json:"unpushed"`
}

type WorktreeInfo struct {
	Path   string `json:"path"`
	Branch string `json:"branch"`
	// SizeBytes is its size on disk once measured in the background.
	SizeBytes int64 `json:"size_bytes,omitempty"`
}

type Worktrees struct {
	Root        string            `json:"root"`
	DefaultRoot string            `json:"default_root,omitempty"`
	Disk        *DiskInfo         `json:"disk,omitempty"`
	Worktrees   []WorktreeEntry   `json:"worktrees"`
	Removed     []RemovedWorktree `json:"removed"`
}