web

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

type CommandCenterCompletion struct {
	ID     string `json:"id"`
	Title  string `json:"title"`
	Status string `json:"status"` // the new status (waiting|idle)
	At     string `json:"at"`
}

type CommandCenterConductor struct {
	Name   string `json:"name"`   // short name, e.g. "agent-deck"
	Target string `json:"target"` // routing target, e.g. "conductor-agent-deck"
	// Status mirrors the conductor session's own status (running|waiting|idle
	// |error|...). "absent" when no conductor session exists for the group.
	Status string `json:"status"`
	// Substate is the honest-status v2 refinement of the conductor session.
	Substate string `json:"substate,omitempty"`
	// CurrentlyWorkingOn is plain-language, sourced from the conductor's
	// disk status artifact (status.json headline) or its latest prompt.
	CurrentlyWorkingOn string `json:"currentlyWorkingOn,omitempty"`
	// Sessions are the conductor's active children, error/stopped filtered out.
	Sessions []CommandCenterSession `json:"sessions"`
	Counts   CommandCenterCounts    `json:"counts"`
}

type CommandCenterCounts struct {
	Running int `json:"running"`
	Waiting int `json:"waiting"`
	Idle    int `json:"idle"`
}

type CommandCenterDecision struct {
	ID       string `json:"id"`       // e.g. "#1361"
	Question string `json:"question"` // the plain-language ask
	// Route is the conductor that owns the decision (best-effort; defaults to
	// the agent-deck conductor). Wires the two-way "answer the card" path.
	Route string `json:"route"`
}

type CommandCenterSession struct {
	ID       string `json:"id"`
	Title    string `json:"title"`
	Status   string `json:"status"`
	Substate string `json:"substate,omitempty"`
	// WorkingOn is the latest prompt/activity hint, when available.
	WorkingOn string `json:"workingOn,omitempty"`
}

type CommandCenterSnapshot struct {
	Profile     string `json:"profile"`
	GeneratedAt string `json:"generatedAt"`

	Conductors []CommandCenterConductor `json:"conductors"`
	Totals     CommandCenterTotals      `json:"totals"`

	// DecisionsWaiting is the ⭐ surface: rulings/reviews waiting on Ashesh,
	// parsed from OPEN-ITEMS.md §D. Empty when the file is absent.
	DecisionsWaiting []CommandCenterDecision `json:"decisionsWaiting"`

	// RecentlyCompleted carries the running→done/waiting transitions detected
	// since the previous snapshot, so the panel can fire "✅ X just finished"
	// notifications. It is diff-derived server-side and may be empty.
	RecentlyCompleted []CommandCenterCompletion `json:"recentlyCompleted"`

	// AskTargets is the server-authoritative allowlist of two-way input
	// targets (maestro + live conductor-* sessions). The panel populates its
	// target picker from this; the /ask handler re-validates against it.
	AskTargets []string `json:"askTargets"`
}

type CommandCenterTotals struct {
	Running int `json:"running"`
	Waiting int `json:"waiting"`
	Idle    int `json:"idle"`
}

type Config struct {
	ListenAddr   string
	Profile      string
	ReadOnly     bool
	WebMutations bool // When false, POST/PATCH/DELETE endpoints return 403
	Token        string
	// InsecureBind explicitly acknowledges binding a non-loopback address
	// with no auth token (an unauthenticated RCE surface). Without it the
	// server refuses to start in that configuration. See bind.go / report #1.
	InsecureBind        bool
	MenuData            MenuDataLoader
	PushVAPIDPublicKey  string
	PushVAPIDPrivateKey string
	PushVAPIDSubject    string
	PushTestInterval    time.Duration
}

type CreateGroupRequest struct {
	Name       string `json:"name"`
	ParentPath string `json:"parentPath,omitempty"`
}

type CreateSessionRequest struct {
	Title       string `json:"title"`
	Tool        string `json:"tool"`
	ProjectPath string `json:"projectPath"`
	GroupPath   string `json:"groupPath,omitempty"`
	ModelID     string `json:"modelId,omitempty"`
}

type MCPCatalogEntry struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Transport   string `json:"transport,omitempty"`
	Command     string `json:"command,omitempty"`
	URL         string `json:"url,omitempty"`
}

type MCPCatalogResponse struct {
	MCPs []MCPCatalogEntry `json:"mcps"`
}

type MCPManager interface {
	ListCatalog() []MCPCatalogEntry
	ListAttached(projectPath string) (map[string][]string, error)
	Attach(projectPath, name, scope string) error
	Detach(projectPath, name, scope string) error
	Move(projectPath, name, fromScope, toScope string) error
}

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

type MenuDataLoader interface {
	LoadMenuSnapshot() (*MenuSnapshot, error)
}

type MenuGroup struct {
	Name         string `json:"name"`
	Path         string `json:"path"`
	Expanded     bool   `json:"expanded"`
	Order        int    `json:"order"`
	SessionCount int    `json:"sessionCount"`
}

type MenuItem struct {
	Index               int          `json:"index"`
	Type                string       `json:"type"`
	Level               int          `json:"level"`
	Path                string       `json:"path,omitempty"`
	Group               *MenuGroup   `json:"group,omitempty"`
	Session             *MenuSession `json:"session,omitempty"`
	IsLastInGroup       bool         `json:"isLastInGroup,omitempty"`
	IsSubSession        bool         `json:"isSubSession,omitempty"`
	IsLastSubSession    bool         `json:"isLastSubSession,omitempty"`
	ParentIsLastInGroup bool         `json:"parentIsLastInGroup,omitempty"`
}

type MenuSession struct {
	ID           string         `json:"id"`
	Title        string         `json:"title"`
	Tool         string         `json:"tool"`
	ModelID      string         `json:"modelId,omitempty"`
	Model        string         `json:"model,omitempty"`
	ModelVersion string         `json:"modelVersion,omitempty"`
	CanFork      bool           `json:"canFork"`
	Status       session.Status `json:"status"`
	// Substate is the additive Honest-Status-v2 refinement of Status
	// (e.g. "model-unavailable", "auth-401", "idle-at-empty-prompt"). It
	// explains WHY a session is in its coarse status so consumers like the
	// Command Center can surface model-unavailable/401 distinctly instead of
	// hiding them as plain "running". Empty when there is no refinement.
	Substate        string `json:"substate,omitempty"`
	GroupPath       string `json:"groupPath"`
	ProjectPath     string `json:"projectPath"`
	ParentSessionID string `json:"parentSessionId,omitempty"`
	Order           int    `json:"order"`
	TmuxSession     string `json:"tmuxSession,omitempty"`
	// TmuxSocketName is the tmux -L selector captured at session creation
	// (Instance.TmuxSocketName). Surfaced so the web PTY bridge can reach
	// sessions running on an isolated socket (issue #687, v1.7.50).
	TmuxSocketName string    `json:"tmuxSocketName,omitempty"`
	CreatedAt      time.Time `json:"createdAt"`
	LastAccessedAt time.Time `json:"lastAccessedAt,omitempty"`
	ArchivedAt     time.Time `json:"archivedAt,omitempty"`

	IsConductor bool `json:"isConductor,omitempty"`

	ClaudeSessionID   string `json:"claudeSessionId,omitempty"`
	GeminiSessionID   string `json:"geminiSessionId,omitempty"`
	GeminiModel       string `json:"geminiModel,omitempty"`
	GeminiYoloMode    *bool  `json:"geminiYoloMode,omitempty"`
	CodexSessionID    string `json:"codexSessionId,omitempty"`
	OpenCodeSessionID string `json:"opencodeSessionId,omitempty"`

	LatestPrompt string `json:"latestPrompt,omitempty"`
	Notes        string `json:"notes,omitempty"`

	Color string `json:"color,omitempty"`

	Command         string          `json:"command,omitempty"`
	Wrapper         string          `json:"wrapper,omitempty"`
	Channels        []string        `json:"channels,omitempty"`
	ExtraArgs       []string        `json:"extraArgs,omitempty"`
	ToolOptionsJSON json.RawMessage `json:"toolOptions,omitempty"`

	Sandbox          *session.SandboxConfig `json:"sandbox,omitempty"`
	SandboxContainer string                 `json:"sandboxContainer,omitempty"`
	SSHHost          string                 `json:"sshHost,omitempty"`
	SSHRemotePath    string                 `json:"sshRemotePath,omitempty"`

	MultiRepoEnabled   bool                        `json:"multiRepoEnabled,omitempty"`
	AdditionalPaths    []string                    `json:"additionalPaths,omitempty"`
	MultiRepoTempDir   string                      `json:"multiRepoTempDir,omitempty"`
	MultiRepoWorktrees []session.MultiRepoWorktree `json:"multiRepoWorktrees,omitempty"`

	WorktreePath     string `json:"worktreePath,omitempty"`
	WorktreeRepoRoot string `json:"worktreeRepoRoot,omitempty"`
	WorktreeBranch   string `json:"worktreeBranch,omitempty"`

	TitleLocked        bool `json:"titleLocked,omitempty"`
	NoTransitionNotify bool `json:"noTransitionNotify,omitempty"`

	LoadedMCPNames []string `json:"loadedMcpNames,omitempty"`

	// claude_analytics has no underlying struct on *Instance so the matrix
	// keeps it MISSING; only gemini is exposed today.
	GeminiAnalytics *session.GeminiSessionAnalytics `json:"geminiAnalytics,omitempty"`
}

type MenuSessionState struct {
	Status session.Status
	Tool   string
}

type MenuSnapshot struct {
	Profile       string     `json:"profile"`
	GeneratedAt   time.Time  `json:"generatedAt"`
	TotalGroups   int        `json:"totalGroups"`
	TotalSessions int        `json:"totalSessions"`
	Items         []MenuItem `json:"items"`
}

type ProfilesResponse struct {
	Current  string   `json:"current"`
	Profiles []string `json:"profiles"`
}

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

type SSECostEvent struct {
	EventType string  `json:"eventType"`
	SessionID string  `json:"sessionId"`
	Cost      float64 `json:"cost"`
}

type SSEDeleteEvent struct {
	EventType string `json:"eventType"`
	ID        string `json:"id"`
}

type SSEGroupDeleteEvent struct {
	EventType string `json:"eventType"`
	Path      string `json:"path"`
}

type SSEGroupEvent struct {
	EventType string     `json:"eventType"`
	Group     *MenuGroup `json:"group"`
}

type SSESessionEvent struct {
	EventType string       `json:"eventType"`
	Session   *MenuSession `json:"session"`
}

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

type SessionActionResponse struct {
	SessionID string         `json:"sessionId"`
	Status    session.Status `json:"status"`
}

type SessionChildNode struct {
	*MenuSession
	Children []*SessionChildNode `json:"children"`
}

type SessionChildrenResponse struct {
	SessionID string              `json:"sessionId"`
	Children  []*SessionChildNode `json:"children"`
}

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

type SessionMCPsResponse struct {
	SessionID string   `json:"sessionId"`
	Local     []string `json:"local"`
	Global    []string `json:"global"`
	User      []string `json:"user"`
}

type SessionMutator interface {
	CreateSession(title, tool, projectPath, groupPath, modelID string) (string, error)
	StartSession(sessionID string) error
	StopSession(sessionID string) error
	RestartSession(sessionID string) error
	DeleteSession(sessionID string) error
	// CloseSession stops the session process while keeping its metadata
	// in storage (TUI Shift+D — non-destructive close).
	CloseSession(sessionID string) error
	ArchiveSession(sessionID string) error
	UnarchiveSession(sessionID string) error
	ForkSession(sessionID string) (string, error)
	// UndoDelete restores the most-recently deleted session if it was
	// deleted within the implementation's undo window. Returns the
	// restored session id. Implementations should return ErrUndoNothing
	// when the stack is empty and ErrUndoExpired when the most recent
	// entry is older than the window — the handler maps both to 404.
	UndoDelete() (string, error)
	// UpdateSession applies one or more field edits to a session. updates maps
	// session.Field* constants (raw strings — see internal/session/mutators.go)
	// to their string-encoded new values; bools are "true"/"false". Returns the
	// list of fields that actually changed (a no-op subset is permitted; only
	// fields whose new value differs from the stored value are reported) and
	// whether any updated field requires a restart to take effect. Validation
	// errors (unknown field, invalid value) leave the session unchanged.
	UpdateSession(sessionID string, updates map[string]string) (updatedFields []string, restartRequired bool, err error)
	CreateGroup(name, parentPath string) (string, error)
	RenameGroup(groupPath, newName string) error
	DeleteGroup(groupPath string) error
	// FinishWorktree merges (or skips), removes the worktree, optionally
	// deletes the source branch, kills the tmux session, and removes the
	// session from storage. Mirrors the TUI W/shift+w hotkey and the
	// `agent-deck worktree finish` CLI. Returns ErrSessionNotFound when
	// the id doesn't resolve and ErrNotAWorktree when the session exists
	// but lacks worktree metadata. See issue #1126.
	FinishWorktree(sessionID string, opts WorktreeFinishOptions) (WorktreeFinishResult, error)
}

type SettingsResponse struct {
	Profile      string `json:"profile"`
	ReadOnly     bool   `json:"readOnly"`
	WebMutations bool   `json:"webMutations"`
	Version      string `json:"version"`

	// show_only_installed_tools filter (issue #1259). ToolFilter reports the
	// flag is on; VisibleTools lists the tool names that resolved on PATH (the
	// web dialog intersects its static list against this); ToolFilterFallback
	// reports the empty-fallback so the dialog shows a "showing all" hint. With
	// the flag off ToolFilter is false and the dialog ignores the other fields.
	ToolFilter         bool     `json:"toolFilter"`
	VisibleTools       []string `json:"visibleTools"`
	ToolFilterFallback bool     `json:"toolFilterFallback"`

	// hidden_tools denylist from [ui]. HiddenTools is the configured list;
	// PickerTools is the ordered new-session picker after hidden_tools and
	// show_only_installed_tools ("" mapped to "shell" for web).
	HiddenTools []string `json:"hiddenTools"`
	PickerTools []string `json:"pickerTools"`
}

type SkillsService interface {
	ListCatalog() ([]session.SkillCandidate, error)
	ListAttached(projectPath string) ([]session.ProjectSkillAttachment, error)
	Attach(projectPath, tool, skillRef, source string) (*session.ProjectSkillAttachment, error)
	Detach(projectPath, skillRef, source string) (*session.ProjectSkillAttachment, error)
}

type UpdateSessionRequest struct {
	Title           *string `json:"title,omitempty"`
	Notes           *string `json:"notes,omitempty"`
	Color           *string `json:"color,omitempty"`
	Tool            *string `json:"tool,omitempty"`
	ExtraArgs       *string `json:"extraArgs,omitempty"`
	Plugins         *string `json:"plugins,omitempty"`
	Channels        *string `json:"channels,omitempty"`
	SkipPermissions *bool   `json:"skipPermissions,omitempty"`
	AutoMode        *bool   `json:"autoMode,omitempty"`
}

type UpdateSessionResponse struct {
	SessionID       string   `json:"sessionId"`
	UpdatedFields   []string `json:"updatedFields"`
	RestartRequired bool     `json:"restartRequired"`
}

type WorktreeFinishOptions struct {
	// Into is the target branch to merge the worktree branch into. When
	// empty the backend's default branch is used (matches the
	// `agent-deck worktree finish --into` flag).
	Into string
	// NoMerge skips the merge step (mirrors --no-merge). The branch is
	// still removed (unless KeepBranch) and the worktree torn down.
	NoMerge bool
	// KeepBranch leaves the source branch in place after finishing
	// (mirrors --keep-branch). Useful when the branch already lives on a
	// remote PR.
	KeepBranch bool
	// Force skips the dirty-worktree safety check and forces branch
	// deletion even if the merge fast-forward didn't succeed.
	Force bool
}

type WorktreeFinishRequest struct {
	Into       string `json:"into,omitempty"`
	NoMerge    bool   `json:"noMerge,omitempty"`
	KeepBranch bool   `json:"keepBranch,omitempty"`
	Force      bool   `json:"force,omitempty"`
}

type WorktreeFinishResponse struct {
	SessionID     string `json:"sessionId"`
	Branch        string `json:"branch"`
	MergedInto    string `json:"mergedInto,omitempty"`
	Merged        bool   `json:"merged"`
	BranchDeleted bool   `json:"branchDeleted"`
}

type WorktreeFinishResult struct {
	SessionID     string
	Branch        string
	MergedInto    string
	Merged        bool
	BranchDeleted bool
}