serve

type ArtifactSnapshot struct {
	Kind      string `json:"kind"`
	Path      string `json:"path"`
	Label     string `json:"label"`
	SessionID string `json:"session_id"`
	ProjectID string `json:"project_id"`
	AddedAt   string `json:"added_at"`
	Missing   bool   `json:"missing,omitempty"`
}

type Change struct {
	Topics     []string
	SessionIDs []string
	Clock      bool
	// BroadTracker marks a tracker change that must rebuild the full tracker
	// snapshot, such as repo-colors edits or manifest rewrites that can alter
	// agent identity and repo grouping. It survives coalescing so a broad change
	// merged with per-session changes is not silently demoted to a delta.
	BroadTracker bool
	// Lifecycle marks a change that can alter tmux session liveness (manifest
	// create/delete, session-dir events) as opposed to a state.json/artifacts
	// content rewrite. Only lifecycle changes invalidate the tmux
	// list-sessions TTL cache. Survives coalescing like BroadTracker.
	Lifecycle bool
}

type ChangeSource interface {
	Subscribe(context.Context) (<-chan Change, func())
	Close() error
}

type CurrentSession struct {
	ID          string `json:"id"`
	Title       string `json:"title,omitempty"`
	SessionType string `json:"session_type,omitempty"`
}

type Envelope struct {
	ProtocolVersion int             `json:"protocol_version"`
	Type            string          `json:"type"`
	ID              json.RawMessage `json:"id,omitempty"`
	OK              *bool           `json:"ok,omitempty"`
	Topic           string          `json:"topic,omitempty"`
	Data            any             `json:"data,omitempty"`
	Error           string          `json:"error,omitempty"`
}

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

type MutationCommandRunner interface {
	RunMutationCommand(context.Context, []string, []byte) ([]byte, error)
}

type ProjectSnapshot struct {
	ID    string `json:"id"`
	Name  string `json:"name,omitempty"`
	Path  string `json:"path,omitempty"`
	Color string `json:"color,omitempty"`
}

type QuestSnapshot struct {
	ID          string `json:"id"`
	Content     string `json:"content"`
	ProjectID   string `json:"project_id,omitempty"`
	ProjectPath string `json:"project_path,omitempty"`
	ProjectName string `json:"project_name,omitempty"`
	Done        bool   `json:"done"`
	CreatedAt   string `json:"created_at,omitempty"`
	UpdatedAt   string `json:"updated_at,omitempty"`
	SessionID   string `json:"session_id,omitempty"`
}

type RepoSnapshot struct {
	Identity string `json:"identity,omitempty"`
	Name     string `json:"name,omitempty"`
	Color    string `json:"color,omitempty"`
}

type Request struct {
	ID     json.RawMessage `json:"id,omitempty"`
	Method string          `json:"method"`
	Topics []string        `json:"topics,omitempty"`
	Data   json.RawMessage `json:"data,omitempty"`
}

type Server struct {
	SocketPath    string
	Snapshotter   *Snapshotter
	ClockInterval time.Duration

	ChangeSource ChangeSource

	// MutationRunner is injectable for tests; production re-execs this binary
	// for CLI-owned session lifecycle mutations.
	MutationRunner MutationCommandRunner
	TmuxClient     *tmux.Client
	DirQuerier     dirsuggest.DirQuerier
}

type SessionSnapshot struct {
	ID             string             `json:"id"`
	Title          string             `json:"title,omitempty"`
	Status         string             `json:"status"`
	State          string             `json:"state,omitempty"`
	ElapsedMS      int64              `json:"elapsed_ms"`
	ElapsedSince   *time.Time         `json:"elapsed_since,omitempty"`
	LatestActivity string             `json:"latest_activity,omitempty"`
	LastKind       string             `json:"last_kind,omitempty"`
	WorktreePath   string             `json:"worktree_path,omitempty"`
	PrimaryAgent   string             `json:"primary_agent,omitempty"`
	SessionType    string             `json:"session_type,omitempty"`
	ParentID       string             `json:"parent_id,omitempty"`
	WorkerCount    int                `json:"worker_count"`
	IsCurrent      bool               `json:"is_current"`
	Artifacts      []ArtifactSnapshot `json:"artifacts,omitempty"`
	Repo           RepoSnapshot       `json:"repo,omitempty"`
	DisplayColor   string             `json:"display_color,omitempty"`
}

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

type TrackerSnapshot struct {
	ObservedAt time.Time          `json:"observed_at"`
	Current    *CurrentSession    `json:"current,omitempty"`
	Sessions   []SessionSnapshot  `json:"sessions"`
	Projects   []ProjectSnapshot  `json:"projects,omitempty"`
	Artifacts  []ArtifactSnapshot `json:"artifacts,omitempty"`
	Quests     []QuestSnapshot    `json:"quests,omitempty"`
}