api

type AgentActivity string

type AgentAttention struct {
	Kind      AgentAttentionKind `json:"kind"`
	Reason    string             `json:"reason"`
	RequestID string             `json:"requestId,omitempty"`
	Since     time.Time          `json:"since"`
}

type AgentAttentionKind string

type AgentEvent struct {
	Sequence uint64 `json:"seq"`
	Turn     uint64 `json:"turn,omitempty"`
	ID       string `json:"id,omitempty"`
	Provider string `json:"provider"`
	Type     string `json:"type"`
	Role     string `json:"role,omitempty"`
	Content  string `json:"content,omitempty"`
	// ContentDelta marks content as an append-only delta to the previous event
	// with the same provider, type, and ID. It is used by providers such as
	// OpenCode whose mutable parts are projected into the append-only event
	// stream.
	ContentDelta bool        `json:"contentDelta,omitempty"`
	Model        string      `json:"model,omitempty"`
	StopReason   string      `json:"stopReason,omitempty"`
	ToolName     string      `json:"toolName,omitempty"`
	ToolInput    any         `json:"toolInput,omitempty"`
	ToolStatus   string      `json:"toolStatus,omitempty"`
	CallID       string      `json:"callId,omitempty"`
	Output       string      `json:"output,omitempty"`
	Files        []string    `json:"files,omitempty"`
	Error        string      `json:"error,omitempty"`
	Usage        *AgentUsage `json:"usage,omitempty"`
	DurationMs   int64       `json:"durationMs,omitempty"`
	Sidechain    bool        `json:"sidechain,omitempty"`
	Timestamp    time.Time   `json:"timestamp,omitempty"`
}

type AgentHistoryResult struct {
	Epoch   uint64       `json:"epoch,omitempty"`
	Events  []AgentEvent `json:"events"`
	Cursor  uint64       `json:"cursor,omitempty"`
	HasMore bool         `json:"hasMore"`
}

type AgentMessage struct {
	Type    string `json:"t"`
	Session string `json:"session"`
	// Epoch identifies one Host process's agent projection. Clients reset
	// their event history when the epoch changes after a daemon restart.
	Epoch  uint64       `json:"epoch,omitempty"`
	Events []AgentEvent `json:"events"`
}

type AgentSnapshotResult struct {
	Epoch    uint64    `json:"epoch"`
	Turn     AgentTurn `json:"turn"`
	Sequence uint64    `json:"sequence"`
}

type AgentStatus struct {
	Activity  AgentActivity   `json:"activity"`
	Attention *AgentAttention `json:"attention"`
}

type AgentStatusMessage struct {
	Type    string      `json:"t"`
	Session string      `json:"session"`
	Epoch   uint64      `json:"epoch,omitempty"`
	Status  AgentStatus `json:"status"`
}

type AgentSubscriptionResult struct {
	Session  Session             `json:"session"`
	Snapshot AgentSnapshotResult `json:"snapshot"`
}

type AgentTranscriptChunk struct {
	Data string `json:"data"`
	Next int64  `json:"next"`
	EOF  bool   `json:"eof"`
}

type AgentTurn struct {
	ID     uint64          `json:"id"`
	Status AgentTurnStatus `json:"status"`
}

type AgentTurnMessage struct {
	Type    string          `json:"t"`
	Session string          `json:"session"`
	Epoch   uint64          `json:"epoch,omitempty"`
	Turn    uint64          `json:"turn"`
	Status  AgentTurnStatus `json:"status"`
}

type AgentTurnStatus string

type AgentUsage struct {
	InputTokens              int64 `json:"inputTokens,omitempty"`
	CacheCreationInputTokens int64 `json:"cacheCreationInputTokens,omitempty"`
	CacheReadInputTokens     int64 `json:"cacheReadInputTokens,omitempty"`
	OutputTokens             int64 `json:"outputTokens,omitempty"`
	ReasoningOutputTokens    int64 `json:"reasoningOutputTokens,omitempty"`
	TotalTokens              int64 `json:"totalTokens,omitempty"`
}

type AgentWaitResult struct {
	Session string          `json:"session"`
	Epoch   uint64          `json:"epoch"`
	Turn    uint64          `json:"turn"`
	Status  AgentTurnStatus `json:"status"`
	Events  []AgentEvent    `json:"events"`
}

type Envelope struct {
	Type         string   `json:"t"`
	ID           string   `json:"id,omitempty"`
	Token        string   `json:"token,omitempty"`
	Version      string   `json:"version,omitempty"`
	Capabilities []string `json:"capabilities,omitempty"`
	// TerminalStateFormats lists opaque terminal-state encodings the client
	// can install atomically. Protocol 2 requires at least one format shared
	// with the Host; protocol 1 clients are rejected during authentication.
	TerminalStateFormats []string       `json:"terminalStateFormats,omitempty"`
	Method               string         `json:"method,omitempty"`
	Params               map[string]any `json:"params,omitempty"`
	Session              string         `json:"session,omitempty"`
	Workspace            string         `json:"workspace,omitempty"`
	Project              string         `json:"project,omitempty"`
	Command              string         `json:"command,omitempty"`
	Kind                 string         `json:"kind,omitempty"`
	Title                string         `json:"title,omitempty"`
	Data                 string         `json:"data,omitempty"`
	Cols                 int            `json:"cols,omitempty"`
	Rows                 int            `json:"rows,omitempty"`
	Epoch                uint64         `json:"epoch,omitempty"`
	Sequence             uint64         `json:"sequence,omitempty"`
}

type GhostlineMigration struct {
	SessionID      string    `json:"sessionId"`
	SourceSocket   string    `json:"sourceSocket"`
	TargetSocket   string    `json:"targetSocket"`
	SourceProtocol string    `json:"sourceProtocol"`
	HandoffVersion string    `json:"handoffVersion,omitempty"`
	Phase          string    `json:"phase"`
	CreatedAt      time.Time `json:"createdAt"`
	UpdatedAt      time.Time `json:"updatedAt"`
}

type GitBranch struct {
	Name   string `json:"name"`
	Remote bool   `json:"remote"`
}

type GitChange struct {
	Path       string `json:"path"`
	Status     string `json:"status"`
	Staged     bool   `json:"staged,omitempty"`
	RenameFrom string `json:"renameFrom,omitempty"`
	Added      int    `json:"added,omitempty"`
	Deleted    int    `json:"deleted,omitempty"`
}

type GitCommandResult struct {
	Message string `json:"message"`
}

type GitCommit struct {
	Hash    string      `json:"hash"`
	Short   string      `json:"short"`
	Subject string      `json:"subject"`
	Author  string      `json:"author"`
	Email   string      `json:"email,omitempty"`
	Time    time.Time   `json:"time"`
	Files   []GitChange `json:"files"`
}

type GitDiff struct {
	Diff             string `json:"diff"`
	Content          string `json:"content"`
	DiffTruncated    bool   `json:"diffTruncated,omitempty"`
	ContentTruncated bool   `json:"contentTruncated,omitempty"`
}

type GitPanel struct {
	WorkspaceID      string          `json:"workspace"`
	Branch           string          `json:"branch"`
	Upstream         string          `json:"upstream,omitempty"`
	Ahead            int             `json:"ahead,omitempty"`
	Behind           int             `json:"behind,omitempty"`
	AheadOfMain      int             `json:"aheadOfMain,omitempty"`
	Remote           string          `json:"remote,omitempty"`
	MainBranch       string          `json:"mainBranch,omitempty"`
	Merged           bool            `json:"merged,omitempty"`
	Operation        string          `json:"operation,omitempty"`
	Changes          []GitChange     `json:"changes"`
	Commits          []GitCommit     `json:"commits"`
	UnmergedCommits  []GitCommit     `json:"unmergedCommits,omitempty"`
	Branches         []GitBranch     `json:"branches"`
	PullRequest      *GitPullRequest `json:"pullRequest,omitempty"`
	PullRequestError string          `json:"pullRequestError,omitempty"`
	Refreshing       bool            `json:"refreshing,omitempty"`
}

type GitPullRequest struct {
	Number int    `json:"number,omitempty"`
	Title  string `json:"title"`
	Body   string `json:"body,omitempty"`
	State  string `json:"state,omitempty"`
	Draft  bool   `json:"draft,omitempty"`
	URL    string `json:"url,omitempty"`
	Author string `json:"author,omitempty"`
	Base   string `json:"base,omitempty"`
	Head   string `json:"head,omitempty"`
}

type Host struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	User    string `json:"user,omitempty"`
	OS      string `json:"os,omitempty"`
	Version string `json:"version"`
}

type MergeState string

type OperationAudit struct {
	ID                    string     `json:"id"`
	Kind                  string     `json:"kind"`
	Resource              string     `json:"resource"`
	ResourceID            string     `json:"resourceId"`
	BeforeWorkspaceID     string     `json:"beforeWorkspace,omitempty"`
	BeforeTerminalGroupID string     `json:"beforeTerminalGroup,omitempty"`
	AfterWorkspaceID      string     `json:"afterWorkspace,omitempty"`
	AfterTerminalGroupID  string     `json:"afterTerminalGroup,omitempty"`
	AgentSessionID        string     `json:"agentSessionId,omitempty"`
	RevertsOperationID    string     `json:"revertsOperationId,omitempty"`
	CreatedAt             time.Time  `json:"createdAt"`
	RevertedAt            *time.Time `json:"revertedAt,omitempty"`
}

type Project struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Path string `json:"path"`
	// AutoImportGitWorktrees controls whether this project imports every
	// existing Git worktree when the project is added or the setting is enabled.
	// It is deliberately project-scoped; one repository's worktree policy must
	// not silently change another repository's import behavior.
	AutoImportGitWorktrees bool      `json:"autoImportGitWorktrees"`
	Pinned                 bool      `json:"pinned,omitempty"`
	Order                  int       `json:"order,omitempty"`
	CreatedAt              time.Time `json:"createdAt"`
}

type PublicAccessEnableRequest struct {
	// A nil EdgeURL keeps the existing configured override. An explicit empty
	// string clears that override and selects the release/launcher default.
	EdgeURL       *string `json:"edgeUrl,omitempty"`
	AccountName   *string `json:"accountName,omitempty"`
	InviteKey     string  `json:"inviteKey,omitempty"`
	ApprovalKey   string  `json:"approvalKey,omitempty"`
	EnrollmentKey string  `json:"enrollmentKey,omitempty"`
}

type PublicAccessStatus struct {
	// EdgeURL is the effective Edge currently selected after applying the
	// release default, launcher override, and user override.
	EdgeURL string `json:"edgeUrl"`
	// ConfiguredEdgeURL is the user's persisted override. It is empty when the
	// release/launcher default is in use.
	ConfiguredEdgeURL string `json:"configuredEdgeUrl"`
	// DefaultEdgeURL is the non-secret fallback shipped by the release or
	// supplied by the launcher.
	DefaultEdgeURL   string `json:"defaultEdgeUrl"`
	UsingDefaultEdge bool   `json:"usingDefaultEdge"`
	// AccountName is the effective non-secret account label, including the
	// system-name default used when no override is configured.
	AccountName           string `json:"accountName"`
	ConfiguredAccountName string `json:"configuredAccountName,omitempty"`
	UsingDefaultAccount   bool   `json:"usingDefaultAccount"`
	Enabled               bool   `json:"enabled"`
	// Authenticated reports that Warren has completed a gnar login or a
	// successful token-backed connection test in this daemon lifetime. It is a
	// credential-free presentation hint; gnar remains the source of truth for
	// its persisted account token.
	Authenticated  bool   `json:"authenticated"`
	Running        bool   `json:"running"`
	PublicEndpoint string `json:"publicEndpoint"`
	Error          string `json:"error"`
}

type PublicAccessTestRequest struct {
	EdgeURL       *string `json:"edgeUrl,omitempty"`
	AccountName   *string `json:"accountName,omitempty"`
	InviteKey     string  `json:"inviteKey,omitempty"`
	ApprovalKey   string  `json:"approvalKey,omitempty"`
	EnrollmentKey string  `json:"enrollmentKey,omitempty"`
}

type Response struct {
	Type   string `json:"t"`
	ID     string `json:"id,omitempty"`
	OK     bool   `json:"ok"`
	Result any    `json:"result,omitempty"`
	Error  string `json:"error,omitempty"`
}

type Session struct {
	ID          string `json:"id"`
	WorkspaceID string `json:"workspace,omitempty"`
	// TerminalGroupID is set for standalone shell Sessions. WorkspaceID and
	// TerminalGroupID are mutually exclusive ownership fields.
	TerminalGroupID string `json:"terminalGroup,omitempty"`
	// Scope is explicit for new clients and derived from the ownership fields
	// for legacy records that predate Terminal Groups.
	Scope string `json:"scope,omitempty"`
	// Title is the generated default label (kind or command name) fixed at
	// session creation; it never changes after a user renames the session.
	Title string `json:"title"`
	// CustomTitle is the user-set display name. When non-empty it takes
	// precedence over Title in every client that renders a session name.
	CustomTitle string `json:"customTitle,omitempty"`
	Kind        string `json:"kind"`
	Command     string `json:"command,omitempty"`
	// Process and Directory are live runtime metadata overlaid on roster
	// snapshots only; they are never persisted with the session record.
	Process     string `json:"process,omitempty"`
	Directory   string `json:"directory,omitempty"`
	Runtime     string `json:"runtime"`
	RuntimeKind string `json:"runtimeKind,omitempty"`
	Lifecycle   string `json:"lifecycle"`
	Epoch       uint64 `json:"epoch,omitempty"`
	Sequence    uint64 `json:"sequence,omitempty"`
	// OutputCursor is the opaque Ghostline v1 position immediately after the
	// output durably reflected by Epoch and Sequence. It is never exposed to
	// terminal clients and must not be synthesized from a byte offset.
	OutputCursor string `json:"outputCursor,omitempty"`
	Pinned       bool   `json:"pinned,omitempty"`
	// AgentSessionID is the provider's own conversation ID (Codex thread ID,
	// Claude session ID, or OpenCode SQLite session ID) bound to this Warren
	// session.
	AgentSessionID string `json:"agentSessionId,omitempty"`
	// TranscriptPath is the JSONL transcript projected by the agent watcher.
	TranscriptPath string `json:"transcriptPath,omitempty"`
	// AgentStatus is the live activity and human-attention projection of an
	// agent session. It is overlaid on roster snapshots only and is never
	// persisted with the session record.
	AgentStatus *AgentStatus `json:"agentStatus,omitempty"`
	// AgentTurn is the latest explicit lifecycle boundary for an agent. Like
	// AgentStatus, it is overlaid on roster snapshots only so clients can
	// distinguish a completed turn from an initially-ready agent.
	AgentTurn *AgentTurn `json:"agentTurn,omitempty"`
	CreatedAt time.Time  `json:"createdAt"`
	EndedAt   *time.Time `json:"endedAt,omitempty"`
	// OperationID is returned by mutating session APIs for audit and safe
	// undo. It is intentionally not persisted in the session record.
	OperationID string `json:"operationId,omitempty"`
}

type SessionMovePreflight struct {
	Allowed                    bool    `json:"allowed"`
	Session                    Session `json:"session"`
	SourceWorkspaceID          string  `json:"sourceWorkspace,omitempty"`
	SourceTerminalGroupID      string  `json:"sourceTerminalGroup,omitempty"`
	DestinationWorkspaceID     string  `json:"destinationWorkspace,omitempty"`
	DestinationTerminalGroupID string  `json:"destinationTerminalGroup,omitempty"`
	ExpectedWorkspaceID        string  `json:"expectedWorkspace,omitempty"`
	ExpectedAgentSessionID     string  `json:"expectedAgentSessionId,omitempty"`
}

type State struct {
	Schema int `json:"schema"`
	// Revision is a transient, non-zero roster token used by streaming clients
	// to validate deltas. It is populated only in observer snapshots and is
	// never written into the durable state file.
	Revision       uint64          `json:"revision,omitempty"`
	Host           Host            `json:"host"`
	Projects       []Project       `json:"projects"`
	Workspaces     []Workspace     `json:"workspaces"`
	TerminalGroups []TerminalGroup `json:"terminalGroups"`
	Sessions       []Session       `json:"sessions"`
	// GhostlineMigration is the one in-flight (or most recently completed)
	// ownership journal. It is separate from terminal Sessions because
	// Ghostline transfers the complete PTY batch atomically while Warren owns
	// only the route and process lifecycle around that transfer.
	GhostlineMigration *GhostlineMigration `json:"ghostlineMigration,omitempty"`
	// Operations is the bounded mutation audit trail. Entries are only added
	// for operations that have a safe, compare-and-swap undo representation.
	Operations []OperationAudit `json:"operations,omitempty"`
	// WorktreeOwnershipMigrated records that legacy workspace ownership has
	// been reconciled against the configured Warren worktree root.
	WorktreeOwnershipMigrated bool   `json:"worktreeOwnershipMigrated,omitempty"`
	WarrenVersion             string `json:"warrenVersion,omitempty"`
}

type TerminalGroup struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Home      string    `json:"home,omitempty"`
	Order     int       `json:"order,omitempty"`
	CreatedAt time.Time `json:"createdAt"`
}

type Workspace struct {
	ID        string `json:"id"`
	ProjectID string `json:"project"`
	Name      string `json:"name"`
	Path      string `json:"path"`
	Branch    string `json:"branch,omitempty"`
	Kind      string `json:"kind"`
	// ManagedWorktree is true only for Git worktrees created by Warren. An
	// imported checkout remains on disk when its Warren record is removed.
	ManagedWorktree bool `json:"managedWorktree,omitempty"`
	// WorktreeLocked mirrors Git's lock marker. Locked worktrees are never
	// removed automatically, even when a caller asks to remove the directory.
	WorktreeLocked bool      `json:"worktreeLocked,omitempty"`
	Pinned         bool      `json:"pinned,omitempty"`
	Order          int       `json:"order,omitempty"`
	CreatedAt      time.Time `json:"createdAt"`
	// MergeState is the live merge projection of the workspace branch against
	// the project's default branch. It is overlaid on roster snapshots only
	// and is never persisted with the workspace record.
	MergeState MergeState `json:"mergeState,omitempty"`
}

type WorkspaceCreateResult struct {
	Workspace
	Created     bool `json:"created"`
	GitWorktree bool `json:"gitWorktree"`
}

type WorktreeCandidate struct {
	Path        string `json:"path"`
	Name        string `json:"name"`
	Branch      string `json:"branch,omitempty"`
	Locked      bool   `json:"locked,omitempty"`
	Imported    bool   `json:"imported"`
	WorkspaceID string `json:"workspace,omitempty"`
}