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 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"`
}

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"`
}

type Changes struct {
	Scope     string        `json:"scope"`
	Label     string        `json:"label"`
	Supported bool          `json:"supported"`
	Reason    string        `json:"reason"`
	Files     []ChangedFile `json:"files"`
}

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 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"`
}

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 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 EvidenceChecklist struct {
	Done  int `json:"done"`
	Total int `json:"total"`
}

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"`
}

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

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 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 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"`
}

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"`
	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 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"`
}

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"`
}

type SettingsPatch struct {
	SendDefault  *string
	Terminal     *bool
	Planner      *bool
	HiddenModels map[string][]string
	TitleModel   map[string]string
	CustomModels *[]store.WebCustomModel
	TaskDefaults *TaskDefaults
}

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 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 TurnTiming = store.TurnTiming

type UtilityModel struct {
	Provider string
	Model    string
}