state

Jul 3, 2026

Changes in this version

+ const QuestScopeActive — darwin/amd64, linux/amd64

+ const QuestScopeAll — darwin/amd64, linux/amd64

+ const QuestScopeDone — darwin/amd64, linux/amd64

+ func OpenCodeConfigDir(root string) string — darwin/amd64, linux/amd64

+ func QuestsRegistryLockPath(root string) string — darwin/amd64, linux/amd64

+ func QuestsRegistryPath(root string) string — darwin/amd64, linux/amd64

+ func RemoveQuestAt(root, id string) (bool, error) — darwin/amd64, linux/amd64

+ type Quest struct — darwin/amd64, linux/amd64

+ Content string

+ CreatedAt string

+ Done bool

+ ID string

+ ProjectID string

+ ProjectName string

+ ProjectPath string

+ SessionID string

+ UpdatedAt string

+ func FilterQuests(quests []Quest, scope, projectID, query string) []Quest

+ func LoadQuests() ([]Quest, error)

+ func LoadQuestsAt(root string) ([]Quest, error)

+ func SetQuestDoneAt(root string, ids []string, done bool) ([]Quest, error)

+ func SortedQuests(quests []Quest) []Quest

+ func UpsertQuestAt(root string, quest Quest) (Quest, error)

Jul 2, 2026

Changes in this version

+ const ArtifactScopeAll — darwin/amd64, linux/amd64

+ const ArtifactScopeProject — darwin/amd64, linux/amd64

+ const ArtifactScopeSession — darwin/amd64, linux/amd64

+ func ArtifactsRegistryLockPath(root string) string — darwin/amd64, linux/amd64

+ func ArtifactsRegistryPath(root string) string — darwin/amd64, linux/amd64

+ func RemoveArtifactAt(root, sessionID, path string) (bool, error) — darwin/amd64, linux/amd64

+ func RemoveArtifactGlobal(root, path string) (bool, error) — darwin/amd64, linux/amd64

+ func UpsertArtifactAt(root, sessionID string, artifact Artifact) error — darwin/amd64, linux/amd64

+ func UpsertArtifactGlobal(root string, artifact Artifact) error — darwin/amd64, linux/amd64

type Artifact — darwin/amd64, linux/amd64

+ ProjectID string

+ SessionID string

+ func FilterArtifacts(artifacts []Artifact, scope, sessionID, projectID string) []Artifact

+ func LoadArtifactsGlobal(root string) ([]Artifact, error)

Jul 1, 2026

Changes in this version

+ const ArtifactKindImage — darwin/amd64, linux/amd64

+ const ArtifactKindMarkdown — darwin/amd64, linux/amd64

+ func ArtifactKindForPath(path string) string — darwin/amd64, linux/amd64

Jul 1, 2026

Changes in this version

+ const ArtifactKindHTML — darwin/amd64, linux/amd64

+ func ArtifactMissing(path string) bool — darwin/amd64, linux/amd64

+ func RemoveArtifact(sessionID, path string) (bool, error) — darwin/amd64, linux/amd64

+ func SessionArtifactsPath(root, id string) string — darwin/amd64, linux/amd64

+ func UpdateAndLog(id string, ev StateEvent, mutate func(*SessionState) bool) error — darwin/amd64, linux/amd64

+ func UpsertArtifact(sessionID string, artifact Artifact) error — darwin/amd64, linux/amd64

+ type Artifact struct — darwin/amd64, linux/amd64

+ AddedAt string

+ Kind string

+ Label string

+ Path string

+ func LoadArtifacts(sessionID string) ([]Artifact, error)

+ func LoadArtifactsAt(root, sessionID string) ([]Artifact, error)

+ func SortedArtifacts(artifacts []Artifact) []Artifact

type PaneState — darwin/amd64, linux/amd64

+ OpenCodeSessionID string

+ PendingPartMsgID string

+ PendingPartText string

type SessionState — darwin/amd64, linux/amd64

+ Artifacts []Artifact

Jun 25, 2026

Changes in this version

+ const DoneToIdleGrace — darwin/amd64, linux/amd64

+ func AppendLifecycleEvent(id string, ev StateEvent) error — darwin/amd64, linux/amd64

+ func EnsurePrivateStateRoot(root string) error — darwin/amd64, linux/amd64

+ func IsDisplayColor(color string) bool

+ func LifecycleLogLockPath(root string) string — darwin/amd64, linux/amd64

+ func LifecycleLogPath(root string) string — darwin/amd64, linux/amd64

+ func MarkSessionObserved(id string, now time.Time) (bool, error) — darwin/amd64, linux/amd64

type Store — darwin/amd64, linux/amd64

+ func (s *Store) SetDisplayColor(sessionID, color string) error

Jun 18, 2026

Changes in this version

type SessionState — darwin/amd64, linux/amd64

+ func LoadSessionStateAt(root, id string) (*SessionState, error)

Jun 16, 2026

Changes in this version

+ func DisplayColorANSIIndex(color string) string

Jun 15, 2026

Changes in this version

+ const RepoColorsFile — darwin/amd64, linux/amd64

+ func EffectiveColor(ownColor string, ownAt time.Time, repoColor string, repoAt time.Time) string — darwin/amd64, linux/amd64

+ func NowColorStamp() string — darwin/amd64, linux/amd64

+ func ParseColorStamp(s string) time.Time — darwin/amd64, linux/amd64

type DisplayMetadata

+ ColorChangedAt string

+ type RepoColor struct — darwin/amd64, linux/amd64

+ Color string

+ UpdatedAt string

+ type RepoColorStore struct — darwin/amd64, linux/amd64

+ func NewRepoColorStore(root string) *RepoColorStore

+ func (s *RepoColorStore) Get(identity string) (RepoColor, bool, error)

+ func (s *RepoColorStore) Load() (map[string]RepoColor, error)

+ func (s *RepoColorStore) Set(identity, color string) error

Jun 12, 2026

Changes in this version

+ const QuestLoopPhaseChecking — darwin/amd64, linux/amd64

+ const QuestLoopPhasePaused — darwin/amd64, linux/amd64

+ const QuestLoopPhaseWaiting — darwin/amd64, linux/amd64

+ func SetQuestLoopPhase(sessionID, phase string) error — darwin/amd64, linux/amd64

type QuestLoopState — darwin/amd64, linux/amd64

+ Phase string

Jun 4, 2026

Changes in this version

+ var ErrQuestLoopArmed = errors.New("quest loop already armed") — darwin/amd64, linux/amd64

+ func ArmQuestLoop(sessionID string, since time.Time, force bool) error — darwin/amd64, linux/amd64

+ func ClearQuestLoop(sessionID string) error — darwin/amd64, linux/amd64

+ func UpdateQuestLoop(sessionID string, iterations int, verdict string) error — darwin/amd64, linux/amd64

+ type QuestLoopState struct — darwin/amd64, linux/amd64

+ Iterations int

+ LastVerdict string

+ Since time.Time

type SessionState — darwin/amd64, linux/amd64

+ QuestLoop *QuestLoopState

Jun 4, 2026

Changes in this version

+ func ClearQuest(sessionID string) error — darwin/amd64, linux/amd64

+ func IsQuestAttached(questID string) (bool, error) — darwin/amd64, linux/amd64

+ func QuestIDForSession(sessionID string) (string, error) — darwin/amd64, linux/amd64

+ func SessionsForQuest(questID string) ([]string, error) — darwin/amd64, linux/amd64

+ func StampQuest(sessionID, questID string) error — darwin/amd64, linux/amd64

type SessionState — darwin/amd64, linux/amd64

+ QuestID string

May 29, 2026

Changes in this version

+ const DefaultDisplayColor

+ func DisplayColorOptions() []string

+ func NormalizeDisplayColor(color string) string

+ type DisplayMetadata struct

+ Color string

+ Extra map[string]json.RawMessage

+ func NewDisplayMetadata(color string) *DisplayMetadata

+ func (d *DisplayMetadata) UnmarshalJSON(data []byte) error

+ func (d DisplayMetadata) IsZero() bool

+ func (d DisplayMetadata) MarshalJSON() ([]byte, error)

type Manifest

+ Display *DisplayMetadata

+ func (m Manifest) DisplayColor() string

May 28, 2026

Changes in this version

type Manifest

+ SessionID string

May 26, 2026

Changes in this version

+ const LegacySessionEnv

+ const LegacySessionIDPrefix

+ const LegacyStateRootEnv

+ const SessionEnv

+ const SessionIDPrefix

+ const StateRootEnv

+ func HasSessionIDPrefix(id string) bool

+ func IsValidPartyID(id string) bool — js/wasm, windows/amd64

+ func IsValidSessionID(id string) bool

+ func NewSessionID(timestamp int64) string

+ func NewSessionIDWithSuffix(timestamp, suffix int64) string

+ func SessionIDFromEnv() string

+ func TrimSessionIDPrefix(id string) string

May 25, 2026

Changes in this version

type PaneState — darwin/amd64, linux/amd64

+ WorkingSince time.Time

May 22, 2026

Changes in this version

+ const SchemaVersion — darwin/amd64, linux/amd64

+ const StateJSONLMaxSize — darwin/amd64, linux/amd64

+ var ErrManifestExists = errors.New("manifest already exists") — darwin/amd64, linux/amd64

+ var ErrManifestNotFound = errors.New("manifest not found") — darwin/amd64, linux/amd64

+ func AppendStateEvent(id string, ev StateEvent) error — darwin/amd64, linux/amd64

+ func InitStartingState(id string, agentsByRole map[string]string) error — darwin/amd64, linux/amd64

+ func IsValidPartyID(id string) bool — darwin/amd64, linux/amd64

+ func NowUTC() string

+ func SanitizeResumeID(v string) string

+ func SaveSessionState(id string, ss *SessionState) error — darwin/amd64, linux/amd64

+ func SessionStateDir(root, id string) string — darwin/amd64, linux/amd64

+ func SessionStateLockPath(root, id string) string — darwin/amd64, linux/amd64

+ func SessionStateLogPath(root, id string) string — darwin/amd64, linux/amd64

+ func SessionStatePath(root, id string) string — darwin/amd64, linux/amd64

+ func SortByMtime(manifests []Manifest, root string) — darwin/amd64, linux/amd64

+ func StateRoot() string — darwin/amd64, linux/amd64

+ func UpdateSessionState(id string, mutate func(*SessionState) bool) error — darwin/amd64, linux/amd64

+ type AgentManifest struct

+ CLI string

+ Name string

+ ResumeID string

+ Role string

+ Window int

+ type Manifest struct

+ AgentPath string

+ Agents []AgentManifest

+ CreatedAt string

+ Cwd string

+ Extra map[string]json.RawMessage

+ PartyID string

+ SessionType string

+ Title string

+ UpdatedAt string

+ WindowName string

+ Workers []string

+ func (m *Manifest) SetExtra(key, value string)

+ func (m *Manifest) UnmarshalJSON(data []byte) error

+ func (m Manifest) ExtraString(key string) string

+ func (m Manifest) MarshalJSON() ([]byte, error)

+ type PaneState struct — darwin/amd64, linux/amd64

+ Activity string

+ Agent string

+ LastEvent time.Time

+ LastKind string

+ PiSessionID string

+ Recent []string

+ Role string

+ Seq int64

+ SessionFile string

+ State string

+ Tool string

+ type SessionState struct — darwin/amd64, linux/amd64

+ Panes map[string]PaneState

+ SeenAt time.Time

+ SessionID string

+ Version int

+ func LoadSessionState(id string) (*SessionState, error)

+ type StateEvent struct — darwin/amd64, linux/amd64

+ Action string

+ Activity string

+ Agent string

+ Fields map[string]interface{}

+ Kind string

+ Role string

+ State string

+ Tool string

+ Ts time.Time

+ type Store struct — darwin/amd64, linux/amd64

+ func NewStore(root string) (*Store, error)

+ func OpenStore(root string) *Store

+ func (s *Store) AddWorker(partyID, workerID string) error

+ func (s *Store) Create(m Manifest) error

+ func (s *Store) Delete(partyID string) error

+ func (s *Store) DiscoverSessions() ([]Manifest, error)

+ func (s *Store) GetWorkers(partyID string) ([]string, error)

+ func (s *Store) Read(partyID string) (Manifest, error)

+ func (s *Store) RemoveWorker(partyID, workerID string) error

+ func (s *Store) Root() string

+ func (s *Store) Update(partyID string, fn func(*Manifest)) error