session

Aug 3, 2026

Changes in this version

type Store

+ func (s *Store) SetTasksSavedHook(hook func(sessionID string, tasks SessionTasks))

type TaskContract

+ ProofPolicy *TaskProofPolicy

type TaskEvidence

+ ArtifactDigestsJSON json.RawMessage

+ EnvironmentJSON json.RawMessage

+ InputJSON json.RawMessage

+ ObservedAt string

+ ProofOrigin string

+ ProofState string

+ Rationale string

+ ReporterID string

+ SubjectDigest string

+ UpdatedAt string

+ Verifier string

+ VerifierID string

+ type TaskProofPolicy struct

+ AllowLLMFallback bool

+ FailureState string

+ MaxLLMCostUSD float64

+ MaxLLMTokens int64

+ Required bool

+ Verifier string

May 14, 2026

Changes in this version

type Session

+ UpstreamSessionID string

type Store

+ func (s *Store) SetUpstreamSessionID(id string, upstreamID string) error

May 14, 2026

Changes in this version

+ type PendingCriticFeedback struct

+ Feedback string

+ QueuedAt *time.Time

+ Round int

+ Trigger string

type SessionCritic

+ LastReviewedTurnSig string

+ PendingFeedback string

+ PendingFeedbackAt *time.Time

+ PendingFeedbackRound int

+ PendingFeedbackTrigger string

type Store

+ func (s *Store) TakePendingCriticFeedback(id string) (PendingCriticFeedback, error)

May 13, 2026

Changes in this version

type SessionCritic

+ func InheritCriticConfig(source *SessionCritic) *SessionCritic

May 13, 2026

Changes in this version

+ const DefaultCriticMaxIterations

+ const MaxCriticFeedbackLen

+ const MaxCriticMaxIterations

+ const SessionCriticStatusExhausted

+ const SessionCriticStatusIdle

+ const SessionCriticStatusReviewing

+ const SessionCriticStatusSatisfied

type Session

+ Critic *SessionCritic

+ type SessionCritic struct

+ CurrentIteration int

+ Enabled bool

+ LastFeedback string

+ LastReviewedPlanSig string

+ LastTrigger string

+ MaxIterations int

+ Status string

+ UpdatedAt *time.Time

+ func NormalizeCritic(c *SessionCritic) *SessionCritic

+ func (c *SessionCritic) EffectiveMaxIterations() int

+ func (c *SessionCritic) IsEnabled() bool

type Store

+ func (s *Store) SetCritic(id string, critic *SessionCritic) (Session, error)

+ func (s *Store) UpdateCriticProgress(id string, mutate func(*SessionCritic) *SessionCritic) (Session, error)

May 12, 2026

Changes in this version

+ const DefaultGoalMaxAutoContinues

+ const MaxGoalDescriptionLen

+ const MaxGoalMaxAutoContinues

+ const SessionGoalStatusActive

+ const SessionGoalStatusExhausted

+ const SessionGoalStatusSatisfied

+ var ErrSessionKindUnsupported = errors.New("session: kind does not support goals")

type Session

+ Goal *SessionGoal

+ type SessionGoal struct

+ AutoContinueCount int

+ CreatedAt time.Time

+ Description string

+ LastJudgedAt *time.Time

+ MaxAutoContinues int

+ Status string

+ func NormalizeGoal(goal *SessionGoal) *SessionGoal

+ func (g *SessionGoal) IsActive() bool

type Store

+ func (s *Store) ClearGoal(id string) (Session, error)

+ func (s *Store) SetGoal(id string, goal *SessionGoal) (Session, error)

+ func (s *Store) UpdateGoalProgress(id string, mutate func(*SessionGoal) *SessionGoal) (Session, error)

May 9, 2026

Changes in this version

type Session

+ ArchivedAt *time.Time

+ PinnedAt *time.Time

type Store

+ func (s *Store) SetArchived(id string, archived bool) (Session, error)

+ func (s *Store) SetPinned(id string, pinned bool) (Session, error)

May 9, 2026

Changes in this version

type SessionWithPlanTasks

+ StaleCompleted bool

May 5, 2026

Changes in this version

type SessionToolConfig

+ MCPCustom bool

May 5, 2026

Changes in this version

type SessionToolConfig

+ CommandsCustom bool

+ CommandsEnabled []string

May 5, 2026

Changes in this version

+ var ErrCwdNotEligible = errors.New("session: cwd not in eligible work_dirs")

+ var ErrSessionNotFound = errors.New("session not found")

type Store

+ func (s *Store) EligibleCwds(id string) ([]string, error)

+ func (s *Store) GetCurrentDir(id string) (string, error)

May 4, 2026

Changes in this version

type Task

+ RunID string

May 4, 2026

Changes in this version

+ const AutoContinueIterationWindow

+ const AutoContinueIterationsHardCap

+ const DefaultAutoContinueMaxIterations

type Plan

+ AutoContinueEnabled bool

+ AutoContinueMaxIterations int

+ func (p *Plan) EffectiveAutoContinueMaxIterations() int

May 1, 2026

Changes in this version

type Session

+ StyleControl *SessionStyleControl

+ type SessionStyleControl struct

+ Autonomy *int

+ Caution *int

+ Directness *int

+ Humor *int

+ UpdatedAt *time.Time

+ func NormalizeStyleControl(style *SessionStyleControl) *SessionStyleControl

type Store

+ func (s *Store) SetStyleControl(id string, style *SessionStyleControl) error

May 1, 2026

Changes in this version

+ const AutoResumeModeMoveToNextTask

+ const AutoResumeModeProceedWithAssumption

+ const AutoResumeModeRecordAssumptionAndProceed

+ const DefaultAutoResumeAfterMinutes

+ func NormalizeAutoResumeModes(values []string) []string

type SessionAutomationConsent

+ AllowedResumeModes []string

+ AutoResumeAfterMinutes int

+ AutoResumeEnabled bool

+ func (c *SessionAutomationConsent) AllowsAutoResume() bool

+ func (c *SessionAutomationConsent) EffectiveAllowedResumeModes() []string

+ func (c *SessionAutomationConsent) EffectiveAutoResumeAfterMinutes() int

May 1, 2026

Changes in this version

type Session

+ AutomationConsent *SessionAutomationConsent

+ type SessionAutomationConsent struct

+ AutoResume bool

+ AutonomousMutations bool

+ GitMutations bool

+ UpdatedAt *time.Time

+ func (c *SessionAutomationConsent) AllowsAutonomousMutation() bool

type Store

+ func (s *Store) SetAutomationConsent(id string, consent *SessionAutomationConsent) error

May 1, 2026

Changes in this version

+ type ForkPromotionCandidate struct

+ Category string

+ CreatedAt time.Time

+ ForkedFromIndex *int

+ ForkedFromMessageID string

+ ID string

+ MessageID string

+ MessageIndex int

+ ParentSessionID string

+ Role string

+ RootSessionID string

+ SessionID string

+ Summary string

+ func DetectForkPromotionCandidates(sess Session, messages []Message, opts ForkPromotionOptions) []ForkPromotionCandidate

+ type ForkPromotionOptions struct

+ MaxCandidates int

+ MaxSummaryRunes int

+ Now time.Time

May 1, 2026

Changes in this version

+ type ForkOptions struct

+ Reason string

+ Title string

type Store

+ func (s *Store) ForkFromMessage(parentID string, messageID string, opts ForkOptions) (Session, error)

May 1, 2026

Changes in this version

type Message

+ ID string

type Session

+ ForkReason string

+ ForkedFromIndex *int

+ ForkedFromMessageID string

+ ParentSessionID string

+ RootSessionID string

May 1, 2026

Changes in this version

+ const EvidenceTypeCommandOutputSummary

+ const EvidenceTypeImage

+ const EvidenceTypeLogExcerpt

+ const EvidenceTypePRLink

+ const EvidenceTypeReleaseTag

+ const EvidenceTypeTestResult

+ func EvidenceTypeLabel(kind string) string

+ func NextEvidenceID(tasks []Task) string

+ func ValidEvidenceType(kind string) bool

type Task

+ Evidence []TaskEvidence

+ type TaskEvidence struct

+ Command string

+ CreatedAt string

+ ID string

+ Path string

+ Status string

+ Summary string

+ Title string

+ Type string

+ URL string

May 1, 2026

Changes in this version

+ const ContractStatusApproved

+ const ContractStatusDraft

type SessionTasks

+ Contract *TaskContract

type SessionWithPlanTasks

+ Contract *TaskContract

+ type TaskContract struct

+ Artifacts []string

+ CreatedAt string

+ DoneCriteria []string

+ Goal string

+ Scope string

+ Status string

+ UpdatedAt string

+ VerificationCommands []string

May 1, 2026

Changes in this version

+ type SessionWithPlanTasks struct

+ Plan *Plan

+ Session Session

+ Summary map[string]int

+ Tasks []Task

+ UpdatedAt time.Time

type Store

+ func (s *Store) ListSessionsWithPlans(includeHidden bool, activeOnly bool) ([]SessionWithPlanTasks, error)

Apr 30, 2026

Changes in this version

type Message

+ ToolIsError bool

Apr 27, 2026

Changes in this version

+ const TasksInjectionHeader

+ func IsTasksInjectionMessage(msg Message) bool

type CompactOptions

+ PostSummaryMessages []Message

Apr 26, 2026

Changes in this version

+ const PlanStatusAborted

+ const PlanStatusCompleted

+ const PlanStatusDrafting

+ const PlanStatusExecuting

+ const PlanStatusPaused

+ const PlanStatusProposed

+ func ValidPlanStatus(s string) bool

type Plan

+ Status string

+ UpdatedAt string

Apr 12, 2026

Changes in this version

type CompactOptions

+ PreloadedMessages []Message

Apr 12, 2026

Changes in this version

+ func EstimateMessageTokenCost(msg Message) int

type CompactionSummaryOptions

+ PreviousContext string

Apr 12, 2026

Changes in this version

type Session

+ LastCompactionMode string

type SessionToolConfig

+ ToolsAllowGroups []string

+ ToolsDenyGroups []string

type Store

+ func (s *Store) SetLastCompactionMode(id string, mode string) error

Apr 5, 2026

Changes in this version

type SessionTasks

+ func (st SessionTasks) MarshalJSON() ([]byte, error)

type SessionToolConfig

+ SkillsCustom bool

+ ToolsCustom bool

Apr 5, 2026

Changes in this version

type Session

+ CurrentDir string

+ WorkDirs []string

type Store

+ func (s *Store) SetCurrentDir(id string, dir string) error

+ func (s *Store) SetWorkDirs(id string, dirs []string, currentDir string) error

Apr 4, 2026

Changes in this version

+ func ArchiveSummary(st SessionTasks) string

+ func FormatTasksForInjection(st SessionTasks) string

+ func NextTaskID(tasks []Task) string

+ func NowRFC3339() string

+ func TaskSummary(tasks []Task) map[string]int

+ func ValidTaskStatus(status string) bool

+ type Plan struct

+ Constraints string

+ CreatedAt string

+ Goal string

+ type SessionTasks struct

+ Plan *Plan

+ Tasks []Task

type Store

+ func (s *Store) GetTasks(sessionID string) (SessionTasks, error)

+ func (s *Store) SaveTasks(sessionID string, tasks SessionTasks) error

+ type Task struct

+ Description string

+ ID string

+ Status string

+ Title string

Apr 4, 2026

Changes in this version

type Session

+ PromptOverride string

+ ToolConfig *SessionToolConfig

+ type SessionToolConfig struct

+ MCPEnabled []string

+ SkillsEnabled []string

+ ToolsDisabled []string

+ ToolsEnabled []string

type Store

+ func (s *Store) SetPromptOverride(id string, override string) error

+ func (s *Store) SetToolConfig(id string, config *SessionToolConfig) error

Apr 4, 2026

Changes in this version

type Message

+ ToolArgs string

+ ToolCallID string

+ ToolName string

type Store

+ func (s *Store) SetTitle(id string, title string) error

Mar 22, 2026

Changes in this version

+ const DefaultKeepRecentFraction

+ const MaxKeepRecentFraction

+ const MinKeepRecentFraction

+ func BuildCompactionSummaryWithOptions(messages []Message, opts CompactionSummaryOptions) string

type CompactOptions

+ KeepRecentFraction float64

+ SummaryInstructions string

+ type CompactionSummaryOptions struct

+ FocusInstructions string

Mar 10, 2026

Changes in this version

+ const DefaultKeepRecentMessages

+ const DefaultKeepRecentTokens

+ const MaxKeepRecentMessages

+ const MaxKeepRecentTokens

+ const MinKeepRecentMessages

+ const MinKeepRecentTokens

+ func AppendMessage(path string, msg Message) error

+ func BuildCompactionSummary(messages []Message) string

+ func EstimateTokens(messages []Message) int

+ func RewriteMessages(path string, messages []Message) error

+ type CompactOptions struct

+ BeforeRewrite func(summary string, compactedCount int, originalCount int) error

+ KeepRecentTokens int

+ SummaryBuilder func(messages []Message) (string, error)

+ type CompactResult struct

+ Compacted bool

+ CompactedCount int

+ FinalCount int

+ OriginalCount int

+ Summary string

+ func CompactTranscript(path string, keepRecent int, now time.Time) (CompactResult, error)

+ func CompactTranscriptWithOptions(path string, keepRecent int, now time.Time, opts CompactOptions) (CompactResult, error)

+ type HistorySnapshot struct

+ CompactionUsed bool

+ Messages []Message

+ Tokens int

+ func LoadHistorySnapshot(path string, maxTokens int) (HistorySnapshot, error)

+ type Message struct

+ Content string

+ Role string

+ Timestamp time.Time

+ func LoadHistory(path string, maxTokens int) ([]Message, error)

+ func ReadMessages(path string) ([]Message, error)

+ type Session struct

+ CreatedAt time.Time

+ Hidden bool

+ ID string

+ Kind string

+ ProjectID string

+ Title string

+ UpdatedAt time.Time

+ type Store struct

+ func NewStore(dir string) *Store

+ func (s *Store) Create(title string) (Session, error)

+ func (s *Store) CreateWithOptions(title string, kind string, hidden bool) (Session, error)

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

+ func (s *Store) EnsureMain() (Session, error)

+ func (s *Store) EnsureWorker(projectID string) (Session, error)

+ func (s *Store) Get(id string) (Session, error)

+ func (s *Store) Latest() (Session, error)

+ func (s *Store) LatestAll() (Session, error)

+ func (s *Store) List() ([]Session, error)

+ func (s *Store) ListAll() ([]Session, error)

+ func (s *Store) SetProjectID(id string, projectID string) error

+ func (s *Store) Touch(id string, updatedAt time.Time) error

+ func (s *Store) TranscriptPath(id string) string

+ func (s *Store) WorkspaceDir() string