Documentation
¶
Overview ¶
Package session orchestrates Compozy session lifecycle around ACP-backed agents.
Index ¶
- Constants
- Variables
- func ACPOptionSelectionsFromConfig(selections []compozyconfig.ACPOptionSelection) []acp.SessionConfigOptionSelection
- func ACPOptionSelectionsFromStore(selections []store.SessionACPOptionSelection) []acp.SessionConfigOptionSelection
- func AnnotateUnpersistedRecovery(meta *store.SessionMeta, err error) store.SessionMeta
- func AttachableForInfo(info *Info, now time.Time) bool
- func BuildCreationProfile(input CreationProfileInput) store.SessionCreationProfile
- func ClassifyInactiveMetaForRecovery(now time.Time, meta *store.SessionMeta) (store.SessionMeta, bool)
- func ConfigACPOptionSelectionsFromACP(selections []acp.SessionConfigOptionSelection) []compozyconfig.ACPOptionSelection
- func DispositionValues() []string
- func IsInternalSpawnRole(role string) bool
- func MergeRuntimeACPOptions(base []acp.SessionConfigOptionSelection, ...) ([]acp.SessionConfigOptionSelection, error)
- func ResolveSessionCWD(root string, requested string) (string, error)
- func RuntimeStrategyForProvider(providerID string) acp.RuntimeApplicationStrategy
- func SanitizeSpawnWakeText(value string) string
- func StartAccepted(err error) bool
- func ValidatePermissionSubset(parent store.SessionPermissionPolicy, child store.SessionPermissionPolicy) error
- func ValidateReasoningEffort(value string) error
- func WithActingSession(ctx context.Context, sessionID string) context.Context
- func WorkSignalKindValues() []string
- type ACPDriverAdapter
- func (a *ACPDriverAdapter) Cancel(ctx context.Context, proc *AgentProcess) error
- func (a *ACPDriverAdapter) CancelCooperatively(ctx context.Context, proc *AgentProcess) error
- func (a *ACPDriverAdapter) ConfigureRuntime(ctx context.Context, proc *AgentProcess, config acp.RuntimeConfig) error
- func (a *ACPDriverAdapter) ForkSession(ctx context.Context, proc *AgentProcess, cwd string) (acp.ForkSessionResult, error)
- func (a *ACPDriverAdapter) Interrupt(ctx context.Context, sessionID string, turnID string) (toolruntime.InterruptReport, error)
- func (a *ACPDriverAdapter) Kill(ctx context.Context, proc *AgentProcess) error
- func (a *ACPDriverAdapter) NotifyExtension(ctx context.Context, proc *AgentProcess, method string, params any) error
- func (a *ACPDriverAdapter) Prompt(ctx context.Context, proc *AgentProcess, req acp.PromptRequest) (<-chan acp.AgentEvent, error)
- func (a *ACPDriverAdapter) Start(ctx context.Context, opts acp.StartOpts) (*AgentProcess, error)
- func (a *ACPDriverAdapter) Steer(ctx context.Context, proc *AgentProcess, turnID, text string) (acp.SteerResult, error)
- func (a *ACPDriverAdapter) Stop(ctx context.Context, proc *AgentProcess) error
- func (a *ACPDriverAdapter) VerifyExit(proc *AgentProcess) (bool, error)
- type ActiveTurnMismatchError
- type AgentArtifactResolver
- type AgentArtifacts
- type AgentCooperativeCanceler
- type AgentDriver
- type AgentEventNotifier
- type AgentExitVerifier
- type AgentExtensionNotifier
- type AgentHooks
- type AgentKiller
- type AgentProcess
- func (p *AgentProcess) ApprovePermission(ctx context.Context, req acp.ApproveRequest) error
- func (p *AgentProcess) CapsSnapshot() acp.Caps
- func (p *AgentProcess) Done() <-chan struct{}
- func (p *AgentProcess) ExitStatus() (subprocess.ExitStatus, bool)
- func (p *AgentProcess) HasPendingPermission() bool
- func (p *AgentProcess) HealthState() (subprocess.HealthState, bool)
- func (p *AgentProcess) RequestPermission(ctx context.Context, req acp.RequestPermissionRequest) (acp.RequestPermissionResponse, error)
- func (p *AgentProcess) Stderr() string
- func (p *AgentProcess) ToolHost() acp.ToolHost
- func (p *AgentProcess) Wait() error
- type AgentProcessOptions
- type AgentResolver
- type AgentSessionMetrics
- type AgentSteerer
- type ApprovalResult
- type AttachmentMeta
- type AttachmentOpener
- type AttentionClass
- type AttentionEvent
- type AttentionHooks
- type AttentionWorkspaceMuteReader
- type AuthoredContextHooks
- type Badge
- type BadgeInputs
- type BusyInputMode
- type BusyInputState
- type CatalogEvent
- type CatalogEventKind
- type CatalogEventName
- type CatalogScope
- type ChainOwner
- type ClearPendingInputsResult
- type CommandService
- type CompactionEnvelope
- type CompactionFiredPayload
- type CompactionHandler
- type CompactionHooks
- type CompactionRequest
- type CompactionResult
- type ContinueSessionOpts
- type ConversationHooks
- type ConversationRewindOptions
- type ConversationRewindResult
- type CreateAcceptedOpts
- type CreateOpts
- type CreationError
- type CreationProfileInput
- type DeliveryEventEnvelope
- type DeriveCut
- type DeriveFences
- type DerivePreview
- type DeriveResult
- type DeriveRuntime
- type DeriveSeed
- type Disposition
- type EffectCertainty
- type EnsureCreatedOutcome
- type EnsureCreatedResult
- type EventHooks
- type EventReadCloser
- type EventRecorder
- type FallbackRoute
- type FinalizationNotifier
- type ForkDriver
- type ForkSessionOpts
- type GoalBlockingIssue
- type GoalCommand
- type GoalCommandError
- type GoalCommandHandler
- type GoalCommandHandlerFunc
- type GoalCommandOutcome
- type GoalCommandResult
- type GoalContextSnapshot
- type GoalCriterionResult
- type GoalDiagnosticWarning
- type GoalDispatchDecision
- type GoalDispatchKind
- type GoalEvent
- type GoalObjectiveContract
- type GoalPromptMeta
- type GoalReasonCode
- type GoalSessionStopHandler
- type GoalSnapshot
- type GoalTurn
- type GoalTurnPage
- type GoalVerdictSummary
- type HealthRecoveryResult
- type HealthStore
- type HookSet
- type HostedMCPLaunchRequest
- type HostedMCPLauncher
- type IDGenerator
- type IdempotentSessionCreator
- type Info
- type InputQueueSummary
- type LedgerMaterializer
- type LifecycleHooks
- type ListPage
- type ListQuery
- type MCPResolver
- type ManagedInputClaim
- type ManagedInputEffectError
- type ManagedInputLifecycle
- type ManagedInputOwner
- type ManagedInputPromptMeta
- type ManagedInputReceipt
- type ManagedInputRejection
- type ManagedInputSubmission
- type ManagedInputTerminal
- type ManagedInputUsageReporter
- type Manager
- func (m *Manager) AcquireWorktreeDeliveryFence(ctx context.Context, workspaceID, worktreeID, callerID string) (func(), error)
- func (m *Manager) ActivePromptRun(ctx context.Context, sessionID string) (PromptRunIdentity, error)
- func (m *Manager) AddTurnEndNotifier(fn TurnEndNotifier)
- func (m *Manager) AggregateSessionsByAgent(ctx context.Context, readScope store.ReadScope, workspaceID string) (map[string]AgentSessionMetrics, error)
- func (m *Manager) AppendSessionEventIfAbsent(ctx context.Context, event GoalEvent) error
- func (m *Manager) ApplyAutomaticSessionTitle(ctx context.Context, sessionID string, title string) (bool, error)
- func (m *Manager) ApprovePermission(ctx context.Context, id string, req acp.ApproveRequest) (ApprovalResult, error)
- func (m *Manager) Archive(ctx context.Context, workspaceID string, sessionID string) (*Info, error)
- func (m *Manager) AttachSession(ctx context.Context, req store.SessionAttachRequest) (store.SessionAttach, error)
- func (m *Manager) AttentionSummary(ctx context.Context, readScope store.ReadScope) (store.SessionAttentionSummary, error)
- func (m *Manager) AwaitStopped(ctx context.Context, id string) (StopOutcome, error)
- func (m *Manager) AwaitTurnQuiesced(ctx context.Context, id, turnID string) (TurnCancelOutcome, error)
- func (m *Manager) CancelManagedInputLease(owner ManagedInputOwner) bool
- func (m *Manager) CancelPrompt(ctx context.Context, id string) (PromptCancelResult, error)
- func (m *Manager) CancelQueuedPrompt(ctx context.Context, id string, queueEntryID string) (SendPromptResult, error)
- func (m *Manager) CancelTurn(ctx context.Context, id, expectedTurn string, cause StopCause) error
- func (m *Manager) CatalogFacets(ctx context.Context, query ListQuery) (store.SessionCatalogFacetResult, error)
- func (m *Manager) ClearConversation(ctx context.Context, id string) (_ *Session, err error)
- func (m *Manager) ClearPendingInputs(ctx context.Context, id string, caller PromptCaller) (ClearPendingInputsResult, error)
- func (m *Manager) ClearRuntimeSelection(ctx context.Context, id string, expectedRevision int64) (*Info, error)
- func (m *Manager) CommandCatalog(ctx context.Context, id string) (commandpkg.Catalog, error)
- func (m *Manager) Compactions(ctx context.Context, id string) ([]CompactionEnvelope, error)
- func (m *Manager) ContinueSession(ctx context.Context, opts ContinueSessionOpts) (DeriveResult, error)
- func (m *Manager) Create(ctx context.Context, opts CreateOpts) (_ *Session, err error)
- func (m *Manager) CreateAccepted(ctx context.Context, opts CreateAcceptedOpts) (*Info, error)
- func (m *Manager) CreateLifecycleContinuation(ctx context.Context, opts CreateOpts) (_ *Session, err error)
- func (m *Manager) CreateWorktreeForkAccepted(ctx context.Context, originSessionID string, opts CreateAcceptedOpts) (*Info, error)
- func (m *Manager) Delete(ctx context.Context, id string) (err error)
- func (m *Manager) Deliveries(ctx context.Context, id string) ([]DeliveryEventEnvelope, error)
- func (m *Manager) DerivePreview(ctx context.Context, workspaceID string, sourceSessionID string, ...) (DerivePreview, error)
- func (m *Manager) EnsureCreated(ctx context.Context, opts CreateOpts) (EnsureCreatedResult, error)
- func (m *Manager) Events(ctx context.Context, id string, query store.EventQuery) (events []store.SessionEvent, err error)
- func (m *Manager) ExpireRestartInteractions(ctx context.Context, sessionID string) (int, error)
- func (m *Manager) ForkSession(ctx context.Context, opts ForkSessionOpts) (DeriveResult, error)
- func (m *Manager) Get(id string) (*Session, bool)
- func (m *Manager) GetSessionHealth(ctx context.Context, id string) (heartbeat.SessionHealth, error)
- func (m *Manager) History(ctx context.Context, id string, query store.EventQuery) (history []store.TurnHistory, err error)
- func (m *Manager) InputQueueSummary(ctx context.Context, id string) (InputQueueSummary, error)
- func (m *Manager) InvokeTransientModel(ctx context.Context, call TransientModelCall) (result TransientModelResult, operationErr error)
- func (m *Manager) IsPrompting(id string) bool
- func (m *Manager) LatestSessionEventByType(ctx context.Context, sessionID string, eventType string) (*store.SessionEvent, error)
- func (m *Manager) LatestSettledTurn(ctx context.Context, id string) (SettledTurn, error)
- func (m *Manager) List() []*Info
- func (m *Manager) ListAll(ctx context.Context) ([]*Info, error)
- func (m *Manager) ListPage(ctx context.Context, query ListQuery) (ListPage, error)
- func (m *Manager) ListPendingInputs(ctx context.Context, id string) ([]PendingInput, error)
- func (m *Manager) ListSessionHealth(ctx context.Context, query heartbeat.SessionHealthListQuery) ([]heartbeat.SessionHealth, error)
- func (m *Manager) NotifyAgentExtension(ctx context.Context, sessionID, method string, params any) error
- func (m *Manager) NotifyManagedInputReady(sessionID string)
- func (m *Manager) PendingInteractions(ctx context.Context, sessionID string, statuses []string) ([]store.PendingInteraction, error)
- func (m *Manager) PrepareWorkspaceRemoval(ctx context.Context, workspaceID string) (workspacepkg.UnregisterPreparation, error)
- func (m *Manager) PromotePendingInputToSteer(ctx context.Context, id string, entryID string, opts PromotePendingInputOpts) (SendPromptResult, error)
- func (m *Manager) Prompt(ctx context.Context, id string, msg string) (<-chan acp.AgentEvent, error)
- func (m *Manager) PromptLifecycleContinuation(ctx context.Context, id string, msg string) (<-chan acp.AgentEvent, error)
- func (m *Manager) PromptSynthetic(ctx context.Context, id string, opts SyntheticPromptOpts) (<-chan acp.AgentEvent, error)
- func (m *Manager) PromptWithOpts(ctx context.Context, id string, opts PromptOpts) (<-chan acp.AgentEvent, error)
- func (m *Manager) PublishClarifyEvent(ctx context.Context, event toolspkg.ClarifyEvent) error
- func (m *Manager) PublishOperatorNotification(ctx context.Context, req NotifyRequest) (NotifyResult, error)
- func (m *Manager) ReconcileDerivedSessionEvents(ctx context.Context, infos []*Info) (int, error)
- func (m *Manager) RecoverPendingInteractions(ctx context.Context, sessionID string) (int, error)
- func (m *Manager) RecoverPendingStops(ctx context.Context) error
- func (m *Manager) RecoverSessionHealth(ctx context.Context) (HealthRecoveryResult, error)
- func (m *Manager) RefreshSoul(ctx context.Context, id string) (SoulRefreshResult, error)
- func (m *Manager) RefreshSoulWithExpectedDigest(ctx context.Context, id string, expectedDigest string) (SoulRefreshResult, error)
- func (m *Manager) Rename(ctx context.Context, workspaceID string, sessionID string, name string) (*Info, error)
- func (m *Manager) RepairSession(ctx context.Context, opts RepairOpts) (result *RepairResult, err error)
- func (m *Manager) ReplacePendingInput(ctx context.Context, id string, entryID string, opts ReplacePendingInputOpts) (PendingInput, error)
- func (m *Manager) RequestPermission(ctx context.Context, id string, req acp.RequestPermissionRequest) (acp.RequestPermissionResponse, error)
- func (m *Manager) RequestStop(ctx context.Context, id string, cause StopCause) error
- func (m *Manager) RequestStopWithCause(ctx context.Context, id string, cause StopCause, detail string) error
- func (m *Manager) ResolveOrphanedClarification(ctx context.Context, scope toolspkg.Scope, requestID string, ...) (toolspkg.ClarifyAnswerResult, error)
- func (m *Manager) Resume(ctx context.Context, id string) (resumed *Session, err error)
- func (m *Manager) RevokeManagedInput(owner ManagedInputOwner, reason string)
- func (m *Manager) RewindConversation(ctx context.Context, id string, opts ConversationRewindOptions) (ConversationRewindResult, error)
- func (m *Manager) SendPrompt(ctx context.Context, id string, opts SendPromptOpts) (SendPromptResult, error)
- func (m *Manager) SessionAgentDefinition(id string) (compozyconfig.AgentDef, bool)
- func (m *Manager) SessionHealthForPage(ctx context.Context, infos []*Info) (map[string]heartbeat.SessionHealth, error)
- func (m *Manager) SessionMetadataHealth(ctx context.Context) (int, loggerpkg.FailureSummary, error)
- func (m *Manager) SessionOwner(ctx context.Context, sessionID string) (store.SessionDBOwner, error)
- func (m *Manager) SessionPresence(ctx context.Context, sessionID string, leaseID string, visible bool) (string, error)
- func (m *Manager) SetAttentionConfig(cfg compozyconfig.AttentionConfig) error
- func (m *Manager) SetBusyInputDefaultMode(mode string) error
- func (m *Manager) SetCompactionHandler(handler CompactionHandler)
- func (m *Manager) SetGoalCommandHandler(handler GoalCommandHandler)
- func (m *Manager) SetManagedInputLifecycle(lifecycle ManagedInputLifecycle)
- func (m *Manager) SetRuntimeSelection(ctx context.Context, id string, selection RuntimeSelection, ...) (*Info, error)
- func (m *Manager) SetSupervisedWorkRecovery(recoverWork SupervisedWorkRecovery)
- func (m *Manager) SetTurnEndNotifier(fn TurnEndNotifier)
- func (m *Manager) SetWorkSignalSources(sources ...WorkSignalSource)
- func (m *Manager) SetWorkspaceAccessPolicy(policy workspaceaccess.Policy)
- func (m *Manager) Shutdown(ctx context.Context) error
- func (m *Manager) Spawn(ctx context.Context, opts SpawnOpts) (*Session, error)
- func (m *Manager) Status(ctx context.Context, id string) (*Info, error)
- func (m *Manager) SteerPrompt(ctx context.Context, id string, opts SteerPromptOpts) (SendPromptResult, error)
- func (m *Manager) Stop(ctx context.Context, id string) error
- func (m *Manager) StopWithCause(ctx context.Context, id string, cause StopCause, detail string) error
- func (m *Manager) StopWithSpawnTTL(ctx context.Context, id string, detail string) error
- func (m *Manager) SubprocessHealthSnapshots() []SubprocessHealthSnapshot
- func (m *Manager) SubscribeSessionCatalogEvents(ctx context.Context, scope CatalogScope) (<-chan CatalogEvent, func(), error)
- func (m *Manager) SubscribeSessionEventWakes(ctx context.Context, sessionID string) (<-chan store.SessionEvent, func(), error)
- func (m *Manager) SubscribeSessionEvents(ctx context.Context, sessionID string, afterSequence int64) (<-chan store.SessionEvent, func(), error)
- func (m *Manager) Supervise(ctx context.Context, now time.Time) error
- func (m *Manager) TokenUsage(ctx context.Context, id string) (usage []store.TokenUsage, err error)
- func (m *Manager) TouchSessionPresence(ctx context.Context, id string) (heartbeat.SessionHealth, error)
- func (m *Manager) TranscriptChanges(ctx context.Context, id string, query transcript.ChangeQuery) (transcript.ChangePage, error)
- func (m *Manager) TranscriptOutline(ctx context.Context, id string) (transcript.OutlineResult, error)
- func (m *Manager) TranscriptPage(ctx context.Context, id string, query transcript.PageQuery) (transcript.Page, error)
- func (m *Manager) TranscriptSearch(ctx context.Context, id string, query transcript.SearchQuery) (transcript.SearchResult, error)
- func (m *Manager) TransportStats(sessionID string) (TransportDeliveryStats, error)
- func (m *Manager) Unarchive(ctx context.Context, workspaceID string, sessionID string) (*Info, error)
- func (m *Manager) UpgradeSessionDatabase(ctx context.Context, id string) error
- func (m *Manager) UsageEvents(ctx context.Context, id string) ([]UsageEventEnvelope, error)
- func (m *Manager) WaitForBadge(ctx context.Context, req WaitRequest) (outcome WaitOutcome, retErr error)
- func (m *Manager) WaitForFinalizations(ctx context.Context) error
- func (m *Manager) WaitForPromptDrains(ctx context.Context) error
- func (m *Manager) WaitManagedInputLease(ctx context.Context, owner ManagedInputOwner) error
- func (m *Manager) WithSoulClaimLock(ctx context.Context, sessionID string, fn func() error) error
- type Notifier
- type NotifyOutcome
- type NotifyRequest
- type NotifyResult
- type OperatorNotification
- type Option
- func WithAgentResolver(resolver AgentResolver) Option
- func WithAttachmentOpener(opener AttachmentOpener) Option
- func WithAttentionConfig(config compozyconfig.AttentionConfig) Option
- func WithAttentionWorkspaceMuteReader(reader AttentionWorkspaceMuteReader) Option
- func WithCommandService(service CommandService) Option
- func WithCompactionHandler(handler CompactionHandler) Option
- func WithDriver(driver AgentDriver) Option
- func WithEventLedger(ledger store.EventSummaryStore) Option
- func WithGoalCommandHandler(handler GoalCommandHandler) Option
- func WithHomePaths(homePaths compozyconfig.HomePaths) Option
- func WithHookSet(hooks HookSet) Option
- func WithHostedMCPLauncher(launcher HostedMCPLauncher) Option
- func WithInteractionIDGenerator(generator IDGenerator) Option
- func WithLedgerMaterializer(materializer LedgerMaterializer) Option
- func WithLifecycleContext(ctx context.Context) Option
- func WithLogger(logger *slog.Logger) Option
- func WithMCPResolver(resolver MCPResolver) Option
- func WithManagedInputLifecycle(lifecycle ManagedInputLifecycle) Option
- func WithModelCatalog(catalog modelcatalog.Service) Option
- func WithNotifier(notifier Notifier) Option
- func WithNow(now func() time.Time) Option
- func WithPresenceLeaseIDGenerator(generator IDGenerator) Option
- func WithProfileNameResolver(resolver ProfileNameResolver) Option
- func WithPromptAssembler(assembler PromptAssembler) Option
- func WithPromptBufferSize(size int) Option
- func WithPromptInputAugmenter(augmenter PromptInputAugmenter) Option
- func WithPromptRecoveryDelays(delays ...time.Duration) Option
- func WithProviderSecretResolver(resolver ProviderSecretResolver) Option
- func WithQueryStore(opener QueryStoreOpener) Option
- func WithSessionBusyInputConfig(config compozyconfig.SessionBusyInputConfig) Option
- func WithSessionCatalog(catalog store.SessionCatalog) Option
- func WithSessionCompactionConfig(config compozyconfig.SessionCompactionConfig) Option
- func WithSessionCreationStore(creationStore store.SessionCreationStore) Option
- func WithSessionDeriveConfig(cfg compozyconfig.SessionDeriveConfig) Option
- func WithSessionHealthConfig(config compozyconfig.HeartbeatConfig) Option
- func WithSessionHealthStore(store HealthStore) Option
- func WithSessionIDGenerator(generator IDGenerator) Option
- func WithSessionInputQueueStore(queueStore store.SessionInputQueueStore) Option
- func WithSessionPromptAdmissionStore(admissionStore store.SessionPromptAdmissionStore) Option
- func WithSessionStopConfig(config compozyconfig.SessionStopConfig) Option
- func WithSessionSupervision(config compozyconfig.SessionSupervisionConfig) Option
- func WithSkillRegistry(registry SkillRegistry) Option
- func WithSoulRunActivityChecker(checker SoulRunActivityChecker) Option
- func WithSoulSnapshotStore(store SoulSnapshotStore) Option
- func WithSpawnWakeNotifier(notifier SpawnWakeNotifier) Option
- func WithStartupPromptOverlay(overlay StartupPromptOverlay) Option
- func WithStore(opener StoreOpener) Option
- func WithToolUniverse(ids []toolspkg.ToolID) Option
- func WithToolsetCatalog(catalog toolspkg.ToolsetCatalog) Option
- func WithTranscriptEpochStore(epochStore store.SessionTranscriptEpochStore) Option
- func WithTurnIDGenerator(generator IDGenerator) Option
- func WithWindowReconciler(reconciler WindowReconciler) Option
- func WithWorkAdmissionChecker(checker admission.Checker) Option
- func WithWorkspaceResolver(resolver workspacepkg.RuntimeResolver) Option
- func WithWorktreeResolver(resolver WorktreeResolver) Option
- type PendingInput
- type PendingInteractionResolution
- type ProfileNameResolver
- type PromotePendingInputOpts
- type PromptAssembler
- type PromptCaller
- type PromptCancelOutcome
- type PromptCancelResult
- type PromptDelivery
- type PromptDeliveryPreparer
- type PromptHooks
- type PromptInputAugmenter
- type PromptOpts
- type PromptProvider
- type PromptRunIdentity
- type ProviderSecretResolver
- type QueryStoreOpener
- type QuietWarning
- type RepairAction
- type RepairIssue
- type RepairOpts
- type RepairResult
- type ReplacePendingInputOpts
- type ResumeContextProvider
- type RuntimeConfigurator
- type RuntimeRecoveryHooks
- type RuntimeSelection
- type RuntimeStatus
- type RuntimeTransitionStrategy
- type ScopedInterrupter
- type SendOutcome
- type SendPromptOpts
- type SendPromptResult
- type Session
- func (s *Session) AgentDefinition() compozyconfig.AgentDef
- func (s *Session) ApprovePermission(ctx context.Context, req acp.ApproveRequest) error
- func (s *Session) CurrentPromptMessage() string
- func (s *Session) CurrentPromptMeta() acp.PromptMeta
- func (s *Session) CurrentSkillInvocations() []commandpkg.Invocation
- func (s *Session) CurrentTurnID() string
- func (s *Session) CurrentTurnSource() TurnSource
- func (s *Session) DBPath() string
- func (s *Session) Info() *Info
- func (s *Session) IsPrompting() bool
- func (s *Session) Meta() store.SessionMeta
- func (s *Session) MetaPath() string
- func (s *Session) RequestPermission(ctx context.Context, req acp.RequestPermissionRequest) (acp.RequestPermissionResponse, error)
- func (s *Session) SessionDir() string
- func (s *Session) StoppingDeadline(cooperativeGrace time.Duration) time.Time
- type SettledTurn
- type SignalSource
- type SignalSourceFunc
- type SignalSourceState
- type SkillRegistry
- type SoulRefreshResult
- type SoulRunActivityChecker
- type SoulSnapshotStore
- type SpawnHooks
- type SpawnOpts
- type SpawnWakeEvent
- type SpawnWakeNotifier
- type SpawnWakeReason
- type StartupManifestAssembler
- type StartupPromptAssembler
- type StartupPromptContext
- type StartupPromptOverlay
- type State
- type SteerPromptOpts
- type StopCause
- type StopContract
- type StopOutcome
- type StopPhase
- type StoreOpener
- type SubprocessHealthNotifier
- type SubprocessHealthSnapshot
- type SupervisedWorkRecovery
- type SupervisionState
- type SyntheticPromptOpts
- type ToolHooks
- type TransientModelCall
- type TransientModelResult
- type TransportDeliveryStats
- type TurnCancelOutcome
- type TurnEndNotifier
- type TurnSource
- type Type
- type UsageEventEnvelope
- type WaitOutcome
- type WaitRequest
- type WaitResult
- type WindowReconciler
- type WorkSignal
- type WorkSignalKind
- type WorkSignalRegistry
- type WorkSignalSource
- type WorktreeResolver
Constants ¶
const ( AttachmentKindImage = attachmentspkg.KindImage AttachmentKindFile = attachmentspkg.KindFile )
const ( // DefaultListLimit is the server-owned page size for public session catalogs. DefaultListLimit = 50 // MaxListLimit is the largest public session catalog page. MaxListLimit = 100 ListSortRecent = "recent" ListSortCreated = "created" ListSortLastActivity = "last_activity" ListSortAttention = "attention" ArchiveExclude = store.SessionArchiveExclude ArchiveOnly = store.SessionArchiveOnly ArchiveInclude = store.SessionArchiveInclude )
const ( GoalCommandVerbSet = "set" GoalCommandVerbReplace = "replace" GoalCommandVerbStatus = "status" GoalCommandVerbPause = "pause" GoalCommandVerbResume = "resume" GoalCommandVerbClear = "clear" GoalCommandVerbDraft = "draft" )
const ( RepairSeverityInfo = "info" RepairSeverityWarning = "warning" RepairSeverityError = "error" RepairIssueSequenceGap = "event_sequence_gap" RepairIssueSequenceDuplicate = "event_sequence_duplicate" RepairIssueSequenceRegression = "event_sequence_regression" RepairIssueInvalidEventJSON = "invalid_event_json" RepairIssueEventTypeMismatch = "event_type_mismatch" RepairIssueNoRepairableTurn = "no_repairable_turn" RepairIssueSessionNotStopped = "session_not_stopped" RepairIssueStopReasonRequiresForce = "stop_reason_requires_force" RepairIssueDanglingToolCallMissingID = "dangling_tool_call_missing_id" RepairIssueTerminalEventAlreadyExists = "terminal_event_already_exists" RepairActionAppendInterruptedToolResult = "append_interrupted_tool_result" RepairActionAppendTerminalError = "append_terminal_error" )
const ( RuntimeStatusUnbound = store.SessionRuntimeUnbound RuntimeStatusBinding = store.SessionRuntimeBinding RuntimeStatusReady = store.SessionRuntimeReady RuntimeStatusReconfiguring = store.SessionRuntimeReconfiguring RuntimeStatusRecovering = store.SessionRuntimeRecovering RuntimeStatusFailed = store.SessionRuntimeFailed )
const ( RuntimeTransitionNone = store.SessionRuntimeTransitionNone RuntimeTransitionInitialBind = store.SessionRuntimeTransitionInitialBind RuntimeTransitionLiveConfiguration = store.SessionRuntimeTransitionLiveConfiguration RuntimeTransitionProcessReplacement = store.SessionRuntimeTransitionProcessReplacement RuntimeTransitionAutomaticRecovery = store.SessionRuntimeTransitionAutomaticRecovery )
const ( SessionCreationCodeInvalid = "session_creation_invalid" SessionCreationCodeIdentityMismatch = "session_creation_identity_mismatch" SessionCreationCodeEffectUnknown = "session_creation_effect_unknown" )
const ( NotificationTitleMaxChars = 80 NotificationBodyMaxChars = 240 NotificationRateWindow = time.Second )
const ( WaitTimeoutDefault = 5 * time.Minute WaitTimeoutMax = 30 * time.Minute WaitResumeGrace = 10 * time.Second WaitEdgeBufferSize = 64 WaitMaxPerSession = 32 )
const ( // DefaultSpawnMaxChildren is the MVP per-parent active child cap. DefaultSpawnMaxChildren = 5 // DefaultSpawnMaxDepth is the MVP maximum child depth under a root session. DefaultSpawnMaxDepth = 1 // DefaultSpawnRole is used when an agent omits the advisory child role. DefaultSpawnRole = "worker" // SpawnRoleMemoryExtractor marks daemon-owned extractor children. SpawnRoleMemoryExtractor = "memory-extractor" // SpawnRoleCheckpointSummary marks reference-only checkpoint summarization. SpawnRoleCheckpointSummary = "checkpoint-summary" // SpawnRoleAutoTitle marks daemon-owned title generator children. SpawnRoleAutoTitle = "auto-title" )
const ( // DefaultLivenessStallAfter defines how long a session may go without ACP // activity before recovery marks it stalled. DefaultLivenessStallAfter = 2 * time.Minute )
const EventTypeClarify = acp.EventTypeClarify
const EventTypeGoalSnapshotChanged = "goal_snapshot_changed"
EventTypeGoalSnapshotChanged is the persisted session projection signal for Goal changes.
const (
// EventTypeSessionStopped is emitted when a session transitions to the stopped state.
EventTypeSessionStopped = "session_stopped"
)
const RuntimeModeVerdictOnly = "verdict-only"
RuntimeModeVerdictOnly disables provider-native tools for isolated verdict sessions.
const SessionNameMaxRunes = 64
const SessionPresenceLeaseTTL = 15 * time.Second
const StopVerificationFailedCode = "stop_verification_failed"
StopVerificationFailedCode is the stable diagnostic for an unverified process exit.
Variables ¶
var ( // ErrSessionArchived reports that a runtime action requires restoring the session first. ErrSessionArchived = errors.New("session: session is archived") // ErrSessionArchiveRequiresStopped reports an archive request for a live session. ErrSessionArchiveRequiresStopped = errors.New("session: session must be stopped before archiving") ErrSessionArchiveUnavailable = errors.New("session: archive store is unavailable") )
var ( // ErrListQueryInvalid reports unsupported filters, sorts, or limits. ErrListQueryInvalid = errors.New("session: list query is invalid") // ErrListCursorInvalid reports malformed cursors or cursors reused with another query. ErrListCursorInvalid = errors.New("session: list cursor is invalid") )
var ( // ErrSessionNotDerivable rejects a continue or fork of a non-user session. ErrSessionNotDerivable = errors.New("only user sessions can be continued or forked") // ErrDeriveSourceArchived rejects a continue or fork of an archived source; it // matches ErrSessionArchived. ErrDeriveSourceArchived = fmt.Errorf("%w; unarchive it first", ErrSessionArchived) // ErrDeriveTurnInProgress reports a cut turn without a terminal event. ErrDeriveTurnInProgress = errors.New("the cut turn has not settled") // ErrDeriveFenceConflict reports client fences that differ from the snapshot. ErrDeriveFenceConflict = errors.New("transcript changed since the fences were read") // ErrDeriveIdempotencyConflict reports a derive key reused with a different request. ErrDeriveIdempotencyConflict = errors.New("idempotency key was used with a different request") // ErrDeriveRouteNotFound reports a declared route that does not exist (or changed). ErrDeriveRouteNotFound = errors.New("route_not_found") // ErrDeriveMessageNotFound reports a fork anchor that is not in the source session. ErrDeriveMessageNotFound = errors.New("message not found in session") // ErrDeriveAgentNotFound reports an unknown target agent. ErrDeriveAgentNotFound = errors.New("agent not found") )
var ( // ErrSessionNotFound reports that the requested active session does not exist. ErrSessionNotFound = errors.New("session: session not found") // ErrSessionNotActive reports that a known session cannot accept live approvals or prompts. ErrSessionNotActive = errors.New("session: session is not active") // ErrPendingPermissionNotFound reports that no waiting permission matched the approval request. ErrPendingPermissionNotFound = errors.New("session: pending permission not found") // ErrPendingPermissionConflict reports that the approval request matched multiple pending permissions. ErrPendingPermissionConflict = errors.New("session: pending permission lookup is ambiguous") // ErrInvalidPermissionDecision reports an approval decision unsupported by the pending provider request. ErrInvalidPermissionDecision = errors.New("session: invalid permission decision") // ErrInvalidRuntimeOverride reports that a session runtime override is invalid. ErrInvalidRuntimeOverride = errors.New("session: invalid runtime override") // ErrValidation reports structurally invalid session creation input. ErrValidation = errors.New("session: validation failed") ErrHostedMCPUnavailable = errors.New("session: required hosted MCP is unavailable") // ErrConversationRewindBusy reports that live session work prevents a safe rewind. ErrConversationRewindBusy = errors.New("session: conversation rewind requires an idle session") // ErrConversationRewindManaged reports that daemon-managed sessions cannot be rewound. ErrConversationRewindManaged = errors.New("session: managed sessions cannot be rewound") // ErrConversationRewindFenceConflict reports that the visible transcript changed before rewind. ErrConversationRewindFenceConflict = errors.New("session: conversation rewind transcript changed") )
var ( // ErrPromptImagesUnsupported reports an image prompt rejected by negotiated ACP capabilities. ErrPromptImagesUnsupported = errors.New("session: prompt images unsupported") // ErrPromptFilesUnsupported reports an embedded file prompt rejected by negotiated ACP capabilities. ErrPromptFilesUnsupported = errors.New("session: prompt files unsupported") // ErrPromptAttachmentDigestMismatch reports attachment bytes that differ from admitted metadata. ErrPromptAttachmentDigestMismatch = errors.New("session: prompt attachment digest mismatch") )
var ( // ErrInvalidStateTransition reports that a session state transition is not allowed. ErrInvalidStateTransition = errors.New("session: invalid state transition") // ErrPromptInProgress reports that the session already has prompt setup or execution in flight. ErrPromptInProgress = errors.New("session: prompt already in progress") // ErrPromptNotInProgress reports that an operation requires an active prompt turn. ErrPromptNotInProgress = errors.New("session: prompt is not in progress") // ErrActiveTurnMismatch reports that a busy-input command targeted a different active turn. ErrActiveTurnMismatch = errors.New("session: active turn mismatch") )
var ( ErrSessionPresenceLeaseNotFound = errors.New("session: presence lease not found") ErrSessionPresenceLeaseMismatch = errors.New("session: presence lease belongs to another session") )
var ( ErrWaitValidation = errors.New("session: invalid wait request") ErrWaitStateInvalid = errors.New("session: invalid wait state") ErrWaitLimit = errors.New("session: concurrent wait limit reached") ErrWaitExpired = errors.New("session: wait registration expired") ErrWaitInUse = errors.New("session: wait registration is already attached") )
var ( // ErrSoulRefreshConflict reports that a Soul refresh cannot run because // another session-scoped operation or an active task run is in progress. ErrSoulRefreshConflict = errors.New("session: soul refresh conflict") // ErrSoulRefreshDigestConflict reports a stale body-level expected digest. ErrSoulRefreshDigestConflict = errors.New("session: soul refresh expected digest conflict") )
var ( // ErrSpawnValidation reports a structurally invalid spawn request. ErrSpawnValidation = errors.New("session: spawn validation failed") // ErrSpawnPermissionDenied reports a failed permission narrowing check. ErrSpawnPermissionDenied = errors.New("session: spawn permission denied") // ErrSpawnLimitExceeded reports a depth, child, or workspace cap violation. ErrSpawnLimitExceeded = errors.New("session: spawn limit exceeded") )
var ( // ErrSpawnWakeValidation reports structurally invalid child wake input. ErrSpawnWakeValidation = errors.New("session: spawn wake validation failed") // ErrSpawnWakeSessionNotLive reports that the creator cannot accept a wake prompt. ErrSpawnWakeSessionNotLive = errors.New("session: spawn wake creator is not live") )
var ( // ErrBadgeFilterInvalid reports an unsupported public badge filter. ErrBadgeFilterInvalid = errors.New("session: badge filter is invalid") )
var ErrCatalogScopeInvalid = errors.New("session: catalog scope is invalid")
var ErrInvalidNotification = errors.New("session: invalid operator notification")
var ErrPromptNotActive = errors.New("session: prompt is not active")
ErrPromptNotActive reports that no authoritative prompt run is published for the session.
var ErrRecoveryPersistence = errors.New("session: recovery persistence failed")
ErrRecoveryPersistence prevents admission against an incompletely recovered session inventory.
var ( // ErrRuntimeSelectionConflict reports a stale compare-and-set revision. ErrRuntimeSelectionConflict = errors.New("session: runtime selection revision conflict") )
var ErrScopedInterruptNotFound = toolruntime.ErrProcessNotFound
ErrScopedInterruptNotFound reports that no registered tool process matched a scoped interrupt.
var ErrStopVerificationFailed = errors.New("session: stop_verification_failed")
ErrStopVerificationFailed means the session cannot yet claim terminal state.
Functions ¶
func ACPOptionSelectionsFromConfig ¶
func ACPOptionSelectionsFromConfig( selections []compozyconfig.ACPOptionSelection, ) []acp.SessionConfigOptionSelection
ACPOptionSelectionsFromConfig converts configuration-owned ACP selections to runtime values.
func ACPOptionSelectionsFromStore ¶
func ACPOptionSelectionsFromStore( selections []store.SessionACPOptionSelection, ) []acp.SessionConfigOptionSelection
ACPOptionSelectionsFromStore converts persisted ACP selections to their runtime representation.
func AnnotateUnpersistedRecovery ¶
func AnnotateUnpersistedRecovery(meta *store.SessionMeta, err error) store.SessionMeta
AnnotateUnpersistedRecovery appends persistence failure detail to the recovered stopped-state metadata returned to callers when the synthetic crash classification could not be durably written.
func AttachableForInfo ¶
AttachableForInfo computes whether a session snapshot is eligible for an explicit attach without consulting UI state or spawning a new runtime.
func BuildCreationProfile ¶
func BuildCreationProfile(input CreationProfileInput) store.SessionCreationProfile
BuildCreationProfile constructs the current canonical profile used by daemon and Manager.
func ClassifyInactiveMetaForRecovery ¶
func ClassifyInactiveMetaForRecovery(now time.Time, meta *store.SessionMeta) (store.SessionMeta, bool)
ClassifyInactiveMetaForRecovery preserves stopping until recorded process death is proven.
func ConfigACPOptionSelectionsFromACP ¶
func ConfigACPOptionSelectionsFromACP( selections []acp.SessionConfigOptionSelection, ) []compozyconfig.ACPOptionSelection
ConfigACPOptionSelectionsFromACP converts runtime ACP selections to the shared authored representation.
func DispositionValues ¶
func DispositionValues() []string
func IsInternalSpawnRole ¶
IsInternalSpawnRole reports whether a child is daemon-owned and must stay out of operator catalogs and metrics.
func MergeRuntimeACPOptions ¶
func MergeRuntimeACPOptions( base []acp.SessionConfigOptionSelection, overrides []acp.SessionConfigOptionSelection, ) ([]acp.SessionConfigOptionSelection, error)
MergeRuntimeACPOptions merges base ACP options with explicit runtime overrides in option ID order.
func ResolveSessionCWD ¶
ResolveSessionCWD normalizes a creation CWD and rejects execution-root escape.
func RuntimeStrategyForProvider ¶
func RuntimeStrategyForProvider(providerID string) acp.RuntimeApplicationStrategy
RuntimeStrategyForProvider returns the public runtime application strategy owned by the provider adapter registry.
func SanitizeSpawnWakeText ¶
SanitizeSpawnWakeText removes secrets and bounds wake-facing text to 240 runes.
func StartAccepted ¶
StartAccepted reports whether a start/bind attempt reached ACP acceptance: a nil error, or an error carrying acp.AcceptedStartError anywhere in its chain. It is the only acceptance derivation chain owners use; a nil or non-nil process never decides it.
func ValidatePermissionSubset ¶
func ValidatePermissionSubset(parent store.SessionPermissionPolicy, child store.SessionPermissionPolicy) error
ValidatePermissionSubset fails closed unless every child permission atom is present in the corresponding known parent category.
func ValidateReasoningEffort ¶
ValidateReasoningEffort validates one reasoning effort override.
func WithActingSession ¶
WithActingSession records the trusted session that initiated a cross-session action.
func WorkSignalKindValues ¶
func WorkSignalKindValues() []string
WorkSignalKindValues defines the closed vocabulary shared with public schemas.
Types ¶
type ACPDriverAdapter ¶
type ACPDriverAdapter struct {
// contains filtered or unexported fields
}
ACPDriverAdapter adapts the concrete ACP driver to the session-local interface.
func NewACPDriverAdapter ¶
func NewACPDriverAdapter(driver *acp.Driver) *ACPDriverAdapter
NewACPDriverAdapter wraps the provided ACP driver for use by the session manager.
func (*ACPDriverAdapter) Cancel ¶
func (a *ACPDriverAdapter) Cancel(ctx context.Context, proc *AgentProcess) error
Cancel lets higher layers stop prompt work without bypassing ACP-owned lifecycle handling.
func (*ACPDriverAdapter) CancelCooperatively ¶
func (a *ACPDriverAdapter) CancelCooperatively(ctx context.Context, proc *AgentProcess) error
CancelCooperatively requests agent cancellation without detaching the prompt stream.
func (*ACPDriverAdapter) ConfigureRuntime ¶
func (a *ACPDriverAdapter) ConfigureRuntime( ctx context.Context, proc *AgentProcess, config acp.RuntimeConfig, ) error
ConfigureRuntime applies mutable ACP settings to the active process.
func (*ACPDriverAdapter) ForkSession ¶
func (a *ACPDriverAdapter) ForkSession( ctx context.Context, proc *AgentProcess, cwd string, ) (acp.ForkSessionResult, error)
ForkSession calls ACP session/fork on the process's bound session for cwd.
func (*ACPDriverAdapter) Interrupt ¶
func (a *ACPDriverAdapter) Interrupt( ctx context.Context, sessionID string, turnID string, ) (toolruntime.InterruptReport, error)
Interrupt signals only registered tool processes scoped to the session turn.
func (*ACPDriverAdapter) Kill ¶
func (a *ACPDriverAdapter) Kill(ctx context.Context, proc *AgentProcess) error
Kill requests the final forced termination phase from the process owner.
func (*ACPDriverAdapter) NotifyExtension ¶
func (a *ACPDriverAdapter) NotifyExtension( ctx context.Context, proc *AgentProcess, method string, params any, ) error
NotifyExtension delivers one fire-and-forget extension notification over the live agent connection.
func (*ACPDriverAdapter) Prompt ¶
func (a *ACPDriverAdapter) Prompt( ctx context.Context, proc *AgentProcess, req acp.PromptRequest, ) (<-chan acp.AgentEvent, error)
Prompt streams prompt events from the wrapped ACP runtime.
func (*ACPDriverAdapter) Start ¶
func (a *ACPDriverAdapter) Start(ctx context.Context, opts acp.StartOpts) (*AgentProcess, error)
Start launches a new ACP-backed runtime process.
func (*ACPDriverAdapter) Steer ¶
func (a *ACPDriverAdapter) Steer( ctx context.Context, proc *AgentProcess, turnID, text string, ) (acp.SteerResult, error)
func (*ACPDriverAdapter) Stop ¶
func (a *ACPDriverAdapter) Stop(ctx context.Context, proc *AgentProcess) error
Stop stops the wrapped ACP runtime process.
func (*ACPDriverAdapter) VerifyExit ¶
func (a *ACPDriverAdapter) VerifyExit(proc *AgentProcess) (bool, error)
VerifyExit asks the ACP process owner for termination evidence.
type ActiveTurnMismatchError ¶
ActiveTurnMismatchError carries the live fence observed before accepting a command.
func (*ActiveTurnMismatchError) Error ¶
func (e *ActiveTurnMismatchError) Error() string
func (*ActiveTurnMismatchError) Unwrap ¶
func (*ActiveTurnMismatchError) Unwrap() error
type AgentArtifactResolver ¶
type AgentArtifactResolver interface {
ResolveAgentArtifacts(name string, resolved *workspacepkg.ResolvedWorkspace) (AgentArtifacts, error)
}
AgentArtifactResolver resolves agent provenance when available.
type AgentArtifacts ¶
type AgentArtifacts struct {
Agent compozyconfig.AgentDef
ResourceID string
OwnerKind string
OwnerID string
Scope resources.ResourceScope
PackageOwned bool
SoulSourcePath string
SoulBody string
HeartbeatSourcePath string
HeartbeatBody string
}
AgentArtifacts returns an agent definition and resource ownership.
type AgentCooperativeCanceler ¶
type AgentCooperativeCanceler interface {
CancelCooperatively(context.Context, *AgentProcess) error
}
AgentCooperativeCanceler requests cancellation while preserving peer completion evidence.
type AgentDriver ¶
type AgentDriver interface {
Start(ctx context.Context, opts acp.StartOpts) (*AgentProcess, error)
Prompt(ctx context.Context, proc *AgentProcess, req acp.PromptRequest) (<-chan acp.AgentEvent, error)
Cancel(ctx context.Context, proc *AgentProcess) error
Stop(ctx context.Context, proc *AgentProcess) error
}
AgentDriver defines the ACP functionality consumed by the session manager.
type AgentEventNotifier ¶
type AgentEventNotifier interface {
OnAgentEventForSession(ctx context.Context, session *Session, event any)
}
AgentEventNotifier is an optional notifier extension that receives the active session alongside streamed agent events.
type AgentExitVerifier ¶
type AgentExitVerifier interface {
VerifyExit(proc *AgentProcess) (bool, error)
}
AgentExitVerifier lets the process owner verify local or remote exit identity.
type AgentExtensionNotifier ¶
type AgentExtensionNotifier interface {
NotifyExtension(ctx context.Context, proc *AgentProcess, method string, params any) error
}
AgentExtensionNotifier is the optional driver surface for fire-and-forget agent extension delivery over a live process connection.
type AgentHooks ¶
type AgentHooks interface {
DispatchAgentPreStart(context.Context, hookspkg.AgentPreStartPayload) (hookspkg.AgentPreStartPayload, error)
DispatchAgentSpawned(context.Context, hookspkg.AgentSpawnedPayload) (hookspkg.AgentSpawnedPayload, error)
DispatchAgentCrashed(context.Context, hookspkg.AgentCrashedPayload) (hookspkg.AgentCrashedPayload, error)
DispatchAgentStopped(context.Context, hookspkg.AgentStoppedPayload) (hookspkg.AgentStoppedPayload, error)
}
AgentHooks groups agent start and stop lifecycle hook dispatch.
type AgentKiller ¶
type AgentKiller interface {
Kill(context.Context, *AgentProcess) error
}
AgentKiller is the process owner's final force-termination operation.
type AgentProcess ¶
type AgentProcess struct {
PID int
AgentName string
Command string
Args []string
Cwd string
SessionID string
StartedAt time.Time
// contains filtered or unexported fields
}
AgentProcess is the session-owned handle for a running agent process.
func NewAgentProcess ¶
func NewAgentProcess(opts AgentProcessOptions) *AgentProcess
NewAgentProcess constructs an AgentProcess for custom AgentDriver implementations.
func (*AgentProcess) ApprovePermission ¶
func (p *AgentProcess) ApprovePermission(ctx context.Context, req acp.ApproveRequest) error
ApprovePermission resolves one pending interactive permission request.
func (*AgentProcess) CapsSnapshot ¶
func (p *AgentProcess) CapsSnapshot() acp.Caps
CapsSnapshot returns the latest ACP capability/config snapshot for this process.
func (*AgentProcess) Done ¶
func (p *AgentProcess) Done() <-chan struct{}
Done reports when the underlying runtime process exits.
func (*AgentProcess) ExitStatus ¶
func (p *AgentProcess) ExitStatus() (subprocess.ExitStatus, bool)
ExitStatus returns the stable OS exit diagnostics exposed by the runtime process.
func (*AgentProcess) HasPendingPermission ¶
func (p *AgentProcess) HasPendingPermission() bool
HasPendingPermission reports whether the runtime is waiting for an interactive permission decision.
func (*AgentProcess) HealthState ¶
func (p *AgentProcess) HealthState() (subprocess.HealthState, bool)
HealthState returns the latest runtime health snapshot when the driver exposes subprocess health monitoring.
func (*AgentProcess) RequestPermission ¶
func (p *AgentProcess) RequestPermission( ctx context.Context, req acp.RequestPermissionRequest, ) (acp.RequestPermissionResponse, error)
RequestPermission asks the active runtime permission path for a tool approval decision.
func (*AgentProcess) Stderr ¶
func (p *AgentProcess) Stderr() string
Stderr returns any captured stderr output for the runtime process.
func (*AgentProcess) ToolHost ¶
func (p *AgentProcess) ToolHost() acp.ToolHost
ToolHost returns the local tool host when the process exposes one.
func (*AgentProcess) Wait ¶
func (p *AgentProcess) Wait() error
Wait blocks until the runtime process exits and returns its terminal error state.
type AgentProcessOptions ¶
type AgentProcessOptions struct {
PID int
AgentName string
Command string
Args []string
Cwd string
SessionID string
Caps acp.Caps
StartedAt time.Time
Done <-chan struct{}
Wait func() error
Stderr func() string
ExitStatus func() (subprocess.ExitStatus, bool)
HealthState func() subprocess.HealthState
PendingPermission func() bool
ApprovePermission func(context.Context, acp.ApproveRequest) error
RequestPermission func(context.Context, acp.RequestPermissionRequest) (acp.RequestPermissionResponse, error)
CapsSnapshot func() acp.Caps
ToolHost acp.ToolHost
}
AgentProcessOptions defines the exported fields and lifecycle hooks needed to construct an AgentProcess.
type AgentResolver ¶
type AgentResolver interface {
ResolveAgent(name string, resolved *workspacepkg.ResolvedWorkspace) (compozyconfig.AgentDef, error)
}
AgentResolver resolves agent definitions from the daemon-authoritative catalog.
type AgentSessionMetrics ¶
type AgentSessionMetrics struct {
Total int
Active int
Failed int
RuntimeSeconds int64
LastActivityAt time.Time
}
AgentSessionMetrics is the exact visible-session aggregate for one agent.
type AgentSteerer ¶
type AgentSteerer interface {
Steer(ctx context.Context, proc *AgentProcess, turnID, text string) (acp.SteerResult, error)
}
type ApprovalResult ¶
type ApprovalResult struct {
Outcome string
InteractionID string
RequestID string
Decision string
ResolvedDecision string
}
ApprovalResult reports the canonical outcome of one permission decision.
type AttachmentMeta ¶
type AttachmentMeta struct {
ID string
Name string
MIMEType string
Bytes int64
SHA256 string
Kind string
Width int
Height int
}
AttachmentMeta is the session-owned attachment snapshot on a prompt.
func AttachmentMetaFromRef ¶
func AttachmentMetaFromRef(ref attachmentspkg.AttachmentRef) AttachmentMeta
AttachmentMetaFromRef converts retained metadata into the session-owned prompt snapshot.
type AttachmentOpener ¶
type AttachmentOpener interface {
Open(
ctx context.Context,
workspaceID string,
sessionID string,
id string,
) (io.ReadCloser, attachmentspkg.AttachmentRef, error)
}
AttachmentOpener is the attachment storage surface consumed during prompt dispatch.
type AttentionClass ¶
type AttentionClass string
AttentionClass groups badges by the operator action they require.
const ( AttentionNeedsYou AttentionClass = "needs-you" AttentionFinished AttentionClass = "finished" AttentionNone AttentionClass = "none" )
func ClassForBadge ¶
func ClassForBadge(badge Badge) AttentionClass
ClassForBadge returns the stable attention class shared by every surface.
type AttentionEvent ¶
type AttentionEvent struct {
SessionID string
ProfileID string
WorkspaceID string
From Badge
To Badge
Class AttentionClass
At time.Time
}
AttentionEvent is the post-commit edge emitted by the canonical attention store.
type AttentionHooks ¶
type AttentionHooks interface {
DispatchSessionAttentionChanged(
context.Context,
hookspkg.SessionAttentionChangedPayload,
) (hookspkg.SessionAttentionChangedPayload, error)
}
AttentionHooks groups committed attention observation dispatch.
type AttentionWorkspaceMuteReader ¶
type AttentionWorkspaceMuteReader interface {
IsAttentionWorkspaceMuted(ctx context.Context, profileID string, workspaceID string) (bool, error)
}
AttentionWorkspaceMuteReader reads the typed profile/workspace mute relation.
type AuthoredContextHooks ¶
type AuthoredContextHooks interface {
DispatchSessionHealthUpdateAfter(
context.Context,
hookspkg.SessionHealthUpdateAfterPayload,
) (hookspkg.SessionHealthUpdateAfterPayload, error)
}
AuthoredContextHooks groups Soul, Heartbeat, and session-health observation hook dispatch.
type Badge ¶
type Badge string
Badge is the canonical user-facing session status token.
const ( BadgeRunning Badge = "running" BadgeIdle Badge = "idle" BadgeUnhealthy Badge = "unhealthy" BadgeHung Badge = "hung" BadgeWaitingForAuth Badge = "waiting-for-auth" BadgeWaitingForInput Badge = "waiting-for-input" BadgeDone Badge = "done" BadgeStopped Badge = "stopped" BadgeFailed Badge = "failed" BadgeUnknown Badge = "unknown" BadgeNeedsAttention Badge = "needs-attention" )
func BadgeForHealth ¶
func BadgeForHealth(info *Info, health heartbeat.SessionHealth) Badge
BadgeForHealth computes a badge from an explicit health row, preserving session/failure precedence from the base session info when supplied.
func BadgeForInfo ¶
BadgeForInfo computes a badge from the session manager/catalog snapshot.
func CanonicalBadge ¶
func CanonicalBadge(input BadgeInputs) Badge
CanonicalBadge collapses runtime state, health, and failure classification into the stable badge vocabulary used by API, CLI, and web clients.
func NormalizeWaitBadges ¶
NormalizeWaitBadges validates, deduplicates, and applies the settled-set default used by every wait surface.
func ParseBadgeFilters ¶
ParseBadgeFilters validates, deduplicates, and canonically orders public badge filters.
type BadgeInputs ¶
type BadgeInputs struct {
State State
StopVerificationFailed bool
SupervisionAttention bool
HealthState heartbeat.SessionHealthState
Health heartbeat.SessionHealthStatus
Failure *store.SessionFailure
PendingAuth bool
PendingClarify bool
ActivePrompt bool
Stalled bool
Unseen bool
IneligibilityReason string
}
BadgeInputs are the runtime-truth fields used to compute a session badge.
type BusyInputMode ¶
type BusyInputMode string
BusyInputMode selects how a user-facing prompt behaves while a session is busy.
const ( BusyInputModeQueue BusyInputMode = "queue" BusyInputModeInterrupt BusyInputMode = "interrupt" BusyInputModeSteer BusyInputMode = "steer" )
type BusyInputState ¶
type BusyInputState struct {
DefaultMode string `json:"default_mode"`
SteerCapability config.SteerCapability `json:"steer_capability"`
SteerDelivery store.SteerDeliveryMode `json:"steer_delivery,omitempty"`
}
BusyInputState describes the live session's follow-up behavior.
type CatalogEvent ¶
type CatalogEvent struct {
Sequence int64
Name CatalogEventName
Kind CatalogEventKind
ProfileID string
ProfileName string
WorkspaceID string
SessionID string
Attention *AttentionEvent
OperatorNotification *OperatorNotification
}
CatalogEvent identifies the workspace-scoped catalog snapshot to reconcile.
type CatalogEventKind ¶
type CatalogEventKind string
CatalogEventKind identifies a durable session-catalog mutation.
const ( // CatalogEventUpserted reports a created or changed catalog row. CatalogEventUpserted CatalogEventKind = "upserted" // CatalogEventDeleted reports a removed catalog row. CatalogEventDeleted CatalogEventKind = "deleted" )
type CatalogEventName ¶
type CatalogEventName string
CatalogEventName identifies one named SSE delivery on the catalog stream.
const ( CatalogEventNameChanged CatalogEventName = "session_catalog_changed" CatalogEventNameAttention CatalogEventName = "session_attention_changed" CatalogEventNameOperatorNotification CatalogEventName = "operator_notification" )
type CatalogScope ¶
type CatalogScope struct {
ReadScope store.ReadScope
WorkspaceID string
AllWorkspaces bool
Replay bool
ReplayAfter int64
}
CatalogScope selects one explicit workspace or the labeled aggregate stream.
func (CatalogScope) Validate ¶
func (s CatalogScope) Validate() error
type ChainOwner ¶
type ChainOwner uint8
ChainOwner declares who runs the fallback chain for one launch, so no launch ever has two chain owners (ADR-004).
const ( // ChainOwnerSession is the default: the session layer owns the agent's fallback_chain // for ordinary work sessions (HTTP/CLI/tool Create, first binds, agent-requested Spawn). ChainOwnerSession ChainOwner = iota // ChainOwnerCaller means a caller (a background role) owns its chain; the session layer // performs exactly the requested route and reports the structured acceptance outcome. ChainOwnerCaller )
type ClearPendingInputsResult ¶
type ClearPendingInputsResult struct {
Inputs []PendingInput
ClearedCount int
QueueGeneration int64
}
type CommandService ¶
type CommandService interface {
Catalog(
ctx context.Context,
info *Info,
agent compozyconfig.AgentDef,
) (commandpkg.Catalog, error)
Expand(
ctx context.Context,
info *Info,
agent compozyconfig.AgentDef,
invocations []commandpkg.Invocation,
message string,
) (string, error)
}
CommandService projects and expands slash commands for one concrete session.
type CompactionEnvelope ¶
type CompactionEnvelope struct {
Sequence int64
At time.Time
Payload CompactionFiredPayload
SpanArchived bool
}
type CompactionFiredPayload ¶
type CompactionFiredPayload struct {
WorkspaceID string `json:"workspace_id"`
SessionID string `json:"session_id"`
TurnID string `json:"turn_id"`
FromSequence int64 `json:"from_sequence"`
ToSequence int64 `json:"to_sequence"`
ContextUsed int64 `json:"context_used"`
ContextSize int64 `json:"context_size"`
Pressure float64 `json:"pressure"`
Strategy string `json:"strategy"`
}
type CompactionHandler ¶
type CompactionHandler interface {
CompactSessionContext(ctx context.Context, request CompactionRequest) (CompactionResult, error)
}
CompactionHandler updates durable memory coverage for one replay span.
type CompactionHooks ¶
type CompactionHooks interface {
DispatchContextPreCompact(
context.Context,
hookspkg.ContextPreCompactPayload,
) (hookspkg.ContextPreCompactPayload, error)
DispatchContextPostCompact(
context.Context,
hookspkg.ContextPostCompactPayload,
) (hookspkg.ContextPostCompactPayload, error)
}
CompactionHooks groups context compaction hook dispatch.
type CompactionRequest ¶
type CompactionRequest struct {
WorkspaceID string
SessionID string
AgentName string
FromSequence int64
ToSequence int64
Events []store.SessionEvent
}
CompactionRequest carries one exact persisted replay span to the memory boundary.
type CompactionResult ¶
type CompactionResult struct {
Summary string
}
CompactionResult carries the durable summary produced before event archiving.
type ContinueSessionOpts ¶
type ContinueSessionOpts struct {
SourceSessionID string
WorkspaceID string
ProfileID string
AgentName string
// Runtime is exclusive with Route.
Runtime *DeriveRuntime
// Route is the 1-based declared route of AgentName's fallback_chain; 0 = none.
Route int
Name string
Message string
IdempotencyKey string
Fences DeriveFences
}
ContinueSessionOpts continues a user session with another agent, runtime, or route.
type ConversationHooks ¶
type ConversationHooks interface {
DispatchTurnStart(context.Context, hookspkg.TurnStartPayload) (hookspkg.TurnStartPayload, error)
DispatchTurnEnd(context.Context, hookspkg.TurnEndPayload) (hookspkg.TurnEndPayload, error)
DispatchMessageStart(context.Context, hookspkg.MessageStartPayload) (hookspkg.MessageStartPayload, error)
DispatchMessageDelta(context.Context, hookspkg.MessageDeltaPayload) (hookspkg.MessageDeltaPayload, error)
DispatchMessageEnd(context.Context, hookspkg.MessageEndPayload) (hookspkg.MessageEndPayload, error)
DispatchSessionMessagePersisted(
context.Context,
hookspkg.SessionMessagePersistedPayload,
) (hookspkg.SessionMessagePersistedPayload, error)
}
ConversationHooks groups turn/message hook dispatch used during prompt streaming.
type ConversationRewindOptions ¶
type ConversationRewindOptions struct {
MessageID string
IdempotencyKey string
ExpectedEpoch int64
ExpectedGeneration int64
ExpectedMaxSequence int64
}
ConversationRewindOptions identifies one durable user message and the transcript version the caller observed before requesting a rewind.
type ConversationRewindResult ¶
type ConversationRewindResult struct {
Session *Session
TranscriptEpoch int64
TargetMessageID string
ArchivedFrom int64
ArchivedThrough int64
ArchivedEvents int64
Generation int64
MaxSequence int64
DraftText string
Replayed bool
}
ConversationRewindResult describes the committed transcript cut and the fresh runtime session that now owns the retained conversation prefix.
type CreateAcceptedOpts ¶
type CreateAcceptedOpts struct {
Session CreateOpts
}
CreateAcceptedOpts carries one logical user-session creation request.
type CreateOpts ¶
type CreateOpts struct {
DesiredSessionID string
ProfileID string
AgentName string
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
CWD string
Permissions compozyconfig.PermissionMode
Name string
Workspace string
WorkspacePath string
// Worktree names an existing ready worktree within the resolved parent workspace.
Worktree string
PromptOverlay string
ContractOverlay string
RuntimeMode string
Type Type
Lineage *store.SessionLineage
// ProvenanceParentSessionID links an internal system session to its informational origin.
// It does not grant spawn governance and is unavailable on public create surfaces.
ProvenanceParentSessionID string
ParentSoulDigest string
// AllowedToolsOverride is a concrete subset narrowing of the resolved agent tool policy.
AllowedToolsOverride []string
// DeniedToolsOverride adds internal deny patterns without widening the resolved agent policy.
DeniedToolsOverride []string
CreationProfile *store.SessionCreationProfile
CreationIdentity *store.SessionCreationIdentity
// DiscardStartFailure prevents internal retry attempts from leaving durable
// session artifacts when provider startup fails before Create returns.
DiscardStartFailure bool
// Command is an explicit launch command for this attempt (a fallback route's
// account). Empty keeps the provider-aware resolution and spawn inheritance.
Command string
// ChainOwner declares who owns the fallback chain for this launch; role-owned
// launches pass ChainOwnerCaller so the session layer performs exactly one route.
ChainOwner ChainOwner
// Derivation and ImportedContext are set only by the continue/fork derive path.
Derivation *store.SessionDerivation
ImportedContext *store.SessionImportedContext
// contains filtered or unexported fields
}
CreateOpts defines the inputs required to create a new session.
type CreationError ¶
type CreationError struct {
Effect EffectCertainty
Code string
Err error
}
CreationError carries typed session-creation effect certainty through errors.As.
func (*CreationError) Error ¶
func (e *CreationError) Error() string
func (*CreationError) Unwrap ¶
func (e *CreationError) Unwrap() error
type CreationProfileInput ¶
type CreationProfileInput struct {
AgentName string
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
ProfileID string
WorkspaceID string
CWD string
WorktreeRef string
Permissions string
AllowedTools []string
AgentTools []string
AgentToolsets []string
DeniedTools []string
RuntimeMode string
PromptOverlay string
ContractOverlay string
}
CreationProfileInput is the resolved, secret-free creation policy material.
type DeliveryEventEnvelope ¶
type DeliveryEventEnvelope struct {
Sequence int64
At time.Time
Manifest acp.DeliveryManifest
}
type DeriveFences ¶
type DeriveFences struct {
ExpectedEpoch *int64
ExpectedGeneration *int64
ExpectedMaxSequence *int64
}
DeriveFences are the optional transcript fences a client observed; all three or none.
type DerivePreview ¶
type DerivePreview struct {
MessageCount int
// SourceMessageCount is the whole source transcript's message count (inherited
// context plus every settled turn), before any fork cut or budget bounding.
SourceMessageCount int
ReplayBytes int
OmittedCount int
Truncated bool
SourceTurnInProgress bool
Cut *DeriveCut
Epoch int64
Generation int64
MaxSequence int64
NativeForkPossible bool
}
DerivePreview reports what a continue or fork of the source would carry right now.
type DeriveResult ¶
type DeriveResult struct {
// Child is the derived session's current read model; nil when the child was deleted.
Child *Info
Kind store.LineageKind
SourceSessionID string
OriginAgentName string
OriginMessageID string
Seed DeriveSeed
NativeState string
ACPSessionID string
NativeForkError string
ReplayMessageCount int
ReplayBytes int
Truncated bool
OmittedCount int
SourceTurnInProgress bool
ThroughTurnID string
FirstPrompt string
Replayed bool
ChildDeleted bool
ChildSessionID string
}
DeriveResult is the outcome of one continue or fork, fresh or replayed from its receipt.
type DeriveRuntime ¶
type DeriveRuntime struct {
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
}
DeriveRuntime is an explicit runtime for the derived session's first bind.
type DeriveSeed ¶
type DeriveSeed string
DeriveSeed names how a derived session is seeded.
const ( // DeriveSeedReplay seeds the child with the bounded carried context. DeriveSeedReplay DeriveSeed = store.SessionDerivationSeedReplay // DeriveSeedNativeFork seeds the child with the agent's own session clone. DeriveSeedNativeFork DeriveSeed = store.SessionDerivationSeedNativeFork )
type Disposition ¶
type Disposition string
const ( DispositionDirect Disposition = "direct" DispositionSteering Disposition = "steering" DispositionQueued Disposition = "queued" DispositionInterrupting Disposition = "interrupting" )
type EffectCertainty ¶
type EffectCertainty string
EffectCertainty classifies whether an external effect is proven absent.
const ( // EffectKnownFalse proves no target effect crossed its durable linearization. EffectKnownFalse EffectCertainty = "known-false" // EffectUnknown means the caller must not retry with a different identity. EffectUnknown EffectCertainty = "unknown" )
type EnsureCreatedOutcome ¶
type EnsureCreatedOutcome string
EnsureCreatedOutcome is the exhaustive idempotent creation result.
const ( EnsureCreatedOutcomeCreated EnsureCreatedOutcome = "created" EnsureCreatedOutcomeExistingMatch EnsureCreatedOutcome = "existing-match" )
type EnsureCreatedResult ¶
type EnsureCreatedResult struct {
SessionID string
Outcome EnsureCreatedOutcome
}
EnsureCreatedResult identifies the created or identity-matched session.
type EventHooks ¶
type EventHooks interface {
DispatchEventPreRecord(context.Context, hookspkg.EventPreRecordPayload) (hookspkg.EventPreRecordPayload, error)
DispatchEventPostRecord(context.Context, hookspkg.EventPostRecordPayload) (hookspkg.EventPostRecordPayload, error)
}
EventHooks groups event-record persistence hook dispatch.
type EventReadCloser ¶
type EventReadCloser = store.EventReadCloser
EventReadCloser is the read-only per-session storage surface consumed by query paths.
type EventRecorder ¶
type EventRecorder = store.EventRecorder
EventRecorder is the per-session storage surface consumed by session/.
type FallbackRoute ¶
type FallbackRoute struct {
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
// Command is the route's explicit launch command (its account); empty inherits the
// provider-aware resolution. It never leaves the resolver boundary as text.
Command string
}
FallbackRoute is one ordered pre-acceptance route for a work session.
type FinalizationNotifier ¶
FinalizationNotifier is an optional lifecycle seam invoked after the process stop, but before the recorder closes and the durable ledger is materialized.
type ForkDriver ¶
type ForkDriver interface {
ForkSession(ctx context.Context, proc *AgentProcess, cwd string) (acp.ForkSessionResult, error)
}
ForkDriver is the optional driver surface for ACP session/fork on a bound process. The clone's traffic never reaches the process's bound session (ADR-003).
type ForkSessionOpts ¶
type ForkSessionOpts struct {
SourceSessionID string
WorkspaceID string
ProfileID string
// MessageID is the durable user message to cut through; "" forks the whole session.
MessageID string
Name string
IdempotencyKey string
Fences DeriveFences
}
ForkSessionOpts forks a user session with the same agent, runtime, and account; the whole conversation, or through one durable user message and its turn.
type GoalBlockingIssue ¶
GoalBlockingIssue is one public verdict blocker without Loop/gate package coupling.
type GoalCommand ¶
type GoalCommand struct {
Verb string
Objective string
ExpectedRunID string
Runtime *RuntimeSelection
}
GoalCommand is one closed `/goal` command parsed at authenticated operator ingress.
func ParseGoalCommand ¶
func ParseGoalCommand(message string) (GoalCommand, bool, error)
ParseGoalCommand recognizes the exact leading `/goal` namespace and closed reserved verbs.
type GoalCommandError ¶
type GoalCommandError struct {
Code GoalReasonCode
Err error
}
GoalCommandError carries one deterministic parser reason.
func (*GoalCommandError) Error ¶
func (e *GoalCommandError) Error() string
func (*GoalCommandError) Unwrap ¶
func (e *GoalCommandError) Unwrap() error
type GoalCommandHandler ¶
type GoalCommandHandler interface {
Handle(
context.Context,
string,
string,
PromptCaller,
GoalCommand,
) (GoalDispatchDecision, error)
}
GoalCommandHandler is the daemon-owned command execution boundary.
type GoalCommandHandlerFunc ¶
type GoalCommandHandlerFunc func( context.Context, string, string, PromptCaller, GoalCommand, ) (GoalDispatchDecision, error)
GoalCommandHandlerFunc adapts a function to GoalCommandHandler.
func (GoalCommandHandlerFunc) Handle ¶
func (f GoalCommandHandlerFunc) Handle( ctx context.Context, workspaceID string, sessionID string, caller PromptCaller, command GoalCommand, ) (GoalDispatchDecision, error)
Handle implements GoalCommandHandler.
type GoalCommandOutcome ¶
type GoalCommandOutcome string
GoalCommandOutcome is the session-domain structured Goal result vocabulary.
const ( GoalOutcomeStarted GoalCommandOutcome = "started" GoalOutcomeReplaced GoalCommandOutcome = "replaced" GoalOutcomeStatus GoalCommandOutcome = "status" GoalOutcomePaused GoalCommandOutcome = "paused" GoalOutcomeResumed GoalCommandOutcome = "resumed" GoalOutcomeCleared GoalCommandOutcome = "cleared" GoalOutcomeError GoalCommandOutcome = "error" )
type GoalCommandResult ¶
type GoalCommandResult struct {
Outcome GoalCommandOutcome
ReasonCode *GoalReasonCode
Snapshot *GoalSnapshot
ReplacedRunID *string
}
GoalCommandResult is the session-domain structured command envelope.
type GoalContextSnapshot ¶
type GoalContextSnapshot struct {
State string
Used *int64
Size *int64
Ratio *float64
NudgeRatio float64
ReportedAt *time.Time
}
GoalContextSnapshot is the checkpoint-pinned context telemetry projection.
type GoalCriterionResult ¶
type GoalCriterionResult struct {
ID string
Type string
Outcome string
Passed bool
Broken bool
ExitCode *int
Stdout string
Stderr string
Score *float64
Evidence json.RawMessage
BlockingIssues []GoalBlockingIssue
Warnings []GoalDiagnosticWarning
Payload json.RawMessage
}
GoalCriterionResult is one sanitized Goal judge criterion result.
type GoalDiagnosticWarning ¶
GoalDiagnosticWarning is one non-terminal Goal judge diagnostic.
type GoalDispatchDecision ¶
type GoalDispatchDecision struct {
Kind GoalDispatchKind
Result *GoalCommandResult
RewrittenMessage string
BypassGoalParse bool
BusyPolicy string
BusyReason GoalReasonCode
}
GoalDispatchDecision returns either structured JSON or an ordinary streamed prompt rewrite.
type GoalDispatchKind ¶
type GoalDispatchKind string
GoalDispatchKind selects a structured response or ordinary prompt continuation.
const ( GoalDispatchRespond GoalDispatchKind = "respond" GoalDispatchPrompt GoalDispatchKind = "prompt" )
type GoalEvent ¶
type GoalEvent struct {
EventID string
SessionID string
SyntheticTurnID string
AgentName string
Type string
Content []byte
CreatedAt time.Time
}
GoalEvent is one deterministic Goal projection event for a session database.
type GoalObjectiveContract ¶
GoalObjectiveContract is the line-oriented free-form objective subset.
func ParseGoalObjective ¶
func ParseGoalObjective(raw string) (GoalObjectiveContract, error)
ParseGoalObjective extracts exact lowercase verify/constraints clauses without creating commands.
type GoalPromptMeta ¶
type GoalPromptMeta struct {
Kind string
RunID string
NodeID string
Generation int64
ItemIndex int
Turn *int
PromptAttempt int
PromptID string
}
GoalPromptMeta classifies one engine-owned Goal prompt in persisted transcript events.
type GoalReasonCode ¶
type GoalReasonCode string
GoalReasonCode is a stable machine-readable Goal outcome or transition cause.
const ( GoalReasonNotActive GoalReasonCode = "goal_not_active" GoalReasonReplaceRequired GoalReasonCode = "goal_replace_required" GoalReasonReplaceStale GoalReasonCode = "goal_replace_stale" GoalReasonObjectiveRequired GoalReasonCode = "goal_objective_required" GoalReasonObjectiveTooLarge GoalReasonCode = "goal_objective_too_large" GoalReasonContractClauseEmpty GoalReasonCode = "goal_contract_clause_empty" GoalReasonCommandInvalid GoalReasonCode = "goal_command_invalid" GoalReasonDraftRequiresIdle GoalReasonCode = "goal_draft_requires_idle" GoalReasonRuntimeInvalid GoalReasonCode = "goal_runtime_invalid" )
type GoalSessionStopHandler ¶
GoalSessionStopHandler cancels session-origin Goals when the operator stops their session.
type GoalSnapshot ¶
type GoalSnapshot struct {
RunID string
NodeID string
Objective string
OriginSessionID string
BoundSessionID string
Status string
RunStatus string
Cause *GoalReasonCode
TurnsUsed int
TurnLimit int
Live bool
ContractSummary string
LastVerdict *GoalVerdictSummary
Context GoalContextSnapshot
}
GoalSnapshot is the canonical newest session-origin Goal projection.
type GoalTurn ¶
type GoalTurn struct {
Seq int64
Generation int64
NodeID string
ItemIndex int
Turn int
PromptAttempt int
SessionID string
BindingHandle string
BindingEpoch int64
PromptID string
ResultStatus *string
ReasonCode *GoalReasonCode
StopReason *string
VerdictOutcome *string
BlockingIssues []GoalBlockingIssue
Criteria []GoalCriterionResult
Warnings []GoalDiagnosticWarning
EvidenceRef *string
PromptRef *string
TokensUsed *int64
ActorKind string
ActorID string
StartedAt time.Time
EndedAt *time.Time
}
GoalTurn is one immutable-start, optionally terminal Goal audit row.
type GoalTurnPage ¶
GoalTurnPage is one run-wide monotonic cursor page.
type GoalVerdictSummary ¶
type GoalVerdictSummary struct {
Outcome string
BlockingIssues []GoalBlockingIssue
EvidenceRef *string
EvaluatedAt time.Time
}
GoalVerdictSummary is the latest evaluated Goal verdict.
type HealthRecoveryResult ¶
HealthRecoveryResult summarizes one metadata-only restart recovery pass.
type HealthStore ¶
type HealthStore interface {
UpsertSessionHealth(ctx context.Context, health heartbeat.SessionHealth) (heartbeat.SessionHealth, error)
GetSessionHealth(ctx context.Context, sessionID string) (heartbeat.SessionHealth, error)
ListSessionHealth(ctx context.Context, query heartbeat.SessionHealthListQuery) ([]heartbeat.SessionHealth, error)
ListSessionHealthByIDs(ctx context.Context, sessionIDs []string) ([]heartbeat.SessionHealth, error)
ListSessionHealthRecoveryInputs(ctx context.Context, limit int) ([]heartbeat.SessionHealth, error)
MarkSessionHealthStale(ctx context.Context, cutoff time.Time, updatedAt time.Time) (int64, error)
}
HealthStore is the durable store used by metadata-only session health.
type HookSet ¶
type HookSet struct {
Session LifecycleHooks
RuntimeRecovery RuntimeRecoveryHooks
Prompt PromptHooks
Events EventHooks
Agent AgentHooks
Conversation ConversationHooks
Tools ToolHooks
Compaction CompactionHooks
Spawn SpawnHooks
AuthoredContext AuthoredContextHooks
Attention AttentionHooks
}
HookSet collects the grouped session hook domains. Nil groups are treated as no-op implementations so callers only provide the domains they exercise.
type HostedMCPLaunchRequest ¶
type HostedMCPLaunchRequest struct {
SessionID string
ProfileID string
WorkspaceID string
AgentName string
}
HostedMCPLaunchRequest describes the session identity for a hosted MCP entry.
type HostedMCPLauncher ¶
type HostedMCPLauncher interface {
Launch(ctx context.Context, req HostedMCPLaunchRequest) (compozyconfig.MCPServer, error)
ArmLaunch(ctx context.Context, sessionID string) error
BindRun(ctx context.Context, sessionID, runID string, generation int64) error
ReleaseRun(sessionID, runID string, generation int64)
CancelLaunch(sessionID string)
ReleaseSession(sessionID string)
}
HostedMCPLauncher mints and releases session-bound hosted MCP launch records.
type IDGenerator ¶
IDGenerator returns a unique identifier or the entropy failure that prevented allocation.
type IdempotentSessionCreator ¶
type IdempotentSessionCreator interface {
EnsureCreated(context.Context, CreateOpts) (EnsureCreatedResult, error)
}
IdempotentSessionCreator creates one preallocated session or reuses its exact identity.
type Info ¶
type Info struct {
Supervision *SupervisionState
BusyInput *BusyInputState
ID string
ProfileID string
Name string
AgentName string
Provider string
ProviderHomePolicy compozyconfig.ProviderHomePolicy
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
SpeedResolution *speedpkg.Resolution
RuntimeStatus RuntimeStatus
RuntimeTransition RuntimeTransitionStrategy
RuntimeFailure string
RuntimeGeneration int64
RuntimeRecovery *store.SessionRuntimeRecovery
SelectedRuntime *RuntimeSelection
RuntimeSelectionRevision int64
EffectivePermissions string
WorkspaceID string
Workspace string
WorktreeID string
Type Type
Lineage *store.SessionLineage
// Derivation is present only on continued or forked children.
Derivation *store.SessionDerivation
State State
PendingPermission bool
StopReason store.StopReason
StopCause StopCause
StopEscalated bool
StopVerificationFailed bool
StopDetail string
Failure *store.SessionFailure
ACPSessionID string
ACPCaps acp.Caps
ACPCapsKnown bool
AdvertisedCommands []store.SessionAdvertisedCommand
Liveness *store.SessionLivenessMeta
SoulSnapshotID string
SoulDigest string
ParentSoulDigest string
AttachedTo string
AttachExpiresAt *time.Time
TranscriptEpoch int64
PendingPermissionCount int
PendingClarifyCount int
AttentionRevision int64
LastSettledRevision int64
LastSeenRevision int64
LastSeenAt *time.Time
AttentionChangedAt *time.Time
PendingInteractions []store.PendingInteraction
ArchivedAt *time.Time
CreatedAt time.Time
UpdatedAt time.Time
}
Info is the external read model returned by session list/get operations.
type InputQueueSummary ¶
InputQueueSummary is the session package projection of durable busy-input queue state.
type LedgerMaterializer ¶
type LedgerMaterializer interface {
MaterializeSessionLedger(ctx context.Context, record store.SessionLedgerRecord) error
DiscardSessionLedger(ctx context.Context, record store.SessionLedgerRecord) error
}
LedgerMaterializer is the thin session-end seam for forensic ledger projection.
type LifecycleHooks ¶
type LifecycleHooks interface {
DispatchSessionPreCreate(
context.Context,
hookspkg.SessionPreCreatePayload,
) (hookspkg.SessionPreCreatePayload, error)
DispatchSessionPostCreate(
context.Context,
hookspkg.SessionPostCreatePayload,
) (hookspkg.SessionPostCreatePayload, error)
DispatchSessionPreResume(
context.Context,
hookspkg.SessionPreResumePayload,
) (hookspkg.SessionPreResumePayload, error)
DispatchSessionPostResume(
context.Context,
hookspkg.SessionPostResumePayload,
) (hookspkg.SessionPostResumePayload, error)
DispatchSessionPreStop(context.Context, hookspkg.SessionPreStopPayload) (hookspkg.SessionPreStopPayload, error)
DispatchSessionPostStop(context.Context, hookspkg.SessionPostStopPayload) (hookspkg.SessionPostStopPayload, error)
}
LifecycleHooks groups create/resume/stop session lifecycle hook dispatch.
type ListQuery ¶
type ListQuery struct {
ReadScope store.ReadScope
WorkspaceID string
AllWorkspaces bool
WorktreeID string
State string
SessionType Type
AgentName string
ParentSessionID string
RootSessionID string
SearchFields string
Search string
Resumable bool
AttentionOnly bool
Badges []Badge
Archive store.SessionArchiveFilter
Sort string
Cursor string
Limit int
SkipTotal bool
}
ListQuery describes one public session catalog page.
type MCPResolver ¶
type MCPResolver interface {
Resolve(skills []*skillspkg.Skill) []compozyconfig.MCPServer
}
MCPResolver resolves skill-declared MCP servers into runtime config entries.
type ManagedInputClaim ¶
type ManagedInputClaim struct {
Owner ManagedInputOwner
RequestedAt time.Time
}
ManagedInputClaim asks the daemon lifecycle to perform the durable start linearization.
type ManagedInputEffectError ¶
type ManagedInputEffectError struct {
Owner ManagedInputOwner
Certainty EffectCertainty
ReasonCode string
Finalized bool
Err error
}
ManagedInputEffectError carries typed certainty through errors.As.
func (*ManagedInputEffectError) Error ¶
func (e *ManagedInputEffectError) Error() string
func (*ManagedInputEffectError) Unwrap ¶
func (e *ManagedInputEffectError) Unwrap() error
type ManagedInputLifecycle ¶
type ManagedInputLifecycle interface {
BeginSubmission(context.Context, ManagedInputClaim) (ManagedInputSubmission, error)
RecordDriverAttached(context.Context, ManagedInputReceipt) error
RecordRejected(context.Context, ManagedInputRejection) error
RecordAmbiguous(context.Context, ManagedInputReceipt) error
RecordTerminal(context.Context, ManagedInputTerminal) error
Revoke(context.Context, ManagedInputOwner, string) error
}
ManagedInputLifecycle is the neutral daemon callback used inside the real prompt slot.
type ManagedInputOwner ¶
type ManagedInputOwner struct {
QueueEntryID string
SessionID string
OwnerKind string
LoopRunID string
TaskRunID string
RunGeneration int64
PromptAttempt int
ControlEpoch int64
BindingEpoch int64
PromptID string
PromptKind string
}
ManagedInputOwner is the complete identity persisted on a managed queue row.
type ManagedInputPromptMeta ¶
type ManagedInputPromptMeta struct {
LoopRunID string
NodeID string
PromptID string
Kind string
Generation int64
ItemIndex int
PromptAttempt int
Turn *int
}
ManagedInputPromptMeta is persisted with transcript events without importing Loop.
type ManagedInputReceipt ¶
type ManagedInputReceipt struct {
Owner ManagedInputOwner
DispatchToken string
DriverTurnID string
ReasonCode string
}
ManagedInputReceipt correlates post-claim driver evidence.
type ManagedInputRejection ¶
type ManagedInputRejection struct {
Owner ManagedInputOwner
ReasonCode string
EffectKnownFalse bool
}
ManagedInputRejection records a pre-claim effect-known-false rejection.
type ManagedInputSubmission ¶
type ManagedInputSubmission struct {
Owner ManagedInputOwner
PromptMeta ManagedInputPromptMeta
DispatchToken string
BudgetVersion int64
StartedAt time.Time
UsageReporter ManagedInputUsageReporter
}
ManagedInputSubmission proves a claim/start commit and returns its one-time token.
type ManagedInputTerminal ¶
type ManagedInputTerminal struct {
Owner ManagedInputOwner
DispatchToken string
DriverTurnID string
Outcome string
Text string
Structured []byte
EventStartSeq int64
EventEndSeq int64
TokensUsed int64
TokensReported bool
StopReason acp.PromptStopReason
ReasonCode string
TerminalAt time.Time
}
ManagedInputTerminal is the exact persisted terminal evidence from the prompt pump.
type ManagedInputUsageReporter ¶
type ManagedInputUsageReporter interface {
ReportActionTokensUsed(int64)
}
ManagedInputUsageReporter receives cumulative usage for one managed operation.
type Manager ¶
type Manager struct {
// contains filtered or unexported fields
}
Manager owns active session lifecycle and runtime orchestration.
func NewManager ¶
NewManager constructs a session manager with sensible defaults.
func (*Manager) AcquireWorktreeDeliveryFence ¶
func (m *Manager) AcquireWorktreeDeliveryFence( ctx context.Context, workspaceID, worktreeID, callerID string, ) (func(), error)
AcquireWorktreeDeliveryFence excludes new and resumed runtimes while the exact bound session hands its checkout to daemon-owned delivery. Other sessions are never stopped by this operation.
func (*Manager) ActivePromptRun ¶
ActivePromptRun returns the complete identity of the session's active prompt.
func (*Manager) AddTurnEndNotifier ¶
func (m *Manager) AddTurnEndNotifier(fn TurnEndNotifier)
AddTurnEndNotifier appends a post-construction callback without replacing callbacks already installed by other daemon subsystems.
func (*Manager) AggregateSessionsByAgent ¶
func (m *Manager) AggregateSessionsByAgent( ctx context.Context, readScope store.ReadScope, workspaceID string, ) (map[string]AgentSessionMetrics, error)
AggregateSessionsByAgent returns workspace-scoped durable metrics overlaid with the manager's current live-session snapshots.
func (*Manager) AppendSessionEventIfAbsent ¶
AppendSessionEventIfAbsent persists and publishes one deterministic Goal projection event.
func (*Manager) ApplyAutomaticSessionTitle ¶
func (m *Manager) ApplyAutomaticSessionTitle( ctx context.Context, sessionID string, title string, ) (bool, error)
ApplyAutomaticSessionTitle persists one generated title when the user session is still unnamed. Explicit names and an earlier successful generation win.
func (*Manager) ApprovePermission ¶
func (m *Manager) ApprovePermission( ctx context.Context, id string, req acp.ApproveRequest, ) (ApprovalResult, error)
ApprovePermission resolves either a live provider request or its restart-orphaned record.
func (*Manager) Archive ¶
Archive removes a stopped session from the default catalog without deleting its history or attachments, which remain readable after unarchive.
func (*Manager) AttachSession ¶
func (m *Manager) AttachSession( ctx context.Context, req store.SessionAttachRequest, ) (store.SessionAttach, error)
AttachSession acquires the durable attach lock before updating the live session snapshot.
func (*Manager) AttentionSummary ¶
func (m *Manager) AttentionSummary( ctx context.Context, readScope store.ReadScope, ) (store.SessionAttentionSummary, error)
AttentionSummary derives exact counts with the same badge authority used by row payloads.
func (*Manager) AwaitStopped ¶
AwaitStopped waits for the shared operation, including an unverified outcome.
func (*Manager) AwaitTurnQuiesced ¶
func (m *Manager) AwaitTurnQuiesced(ctx context.Context, id, turnID string) (TurnCancelOutcome, error)
AwaitTurnQuiesced joins the shared cancellation independently of its request context.
func (*Manager) CancelManagedInputLease ¶
func (m *Manager) CancelManagedInputLease(owner ManagedInputOwner) bool
CancelManagedInputLease cancels only the exact owner lease, never a newer prompt.
func (*Manager) CancelPrompt ¶
CancelPrompt cancels prompt setup/execution for a known session.
func (*Manager) CancelQueuedPrompt ¶
func (m *Manager) CancelQueuedPrompt(ctx context.Context, id string, queueEntryID string) (SendPromptResult, error)
CancelQueuedPrompt cancels one pending busy-input queue entry.
func (*Manager) CancelTurn ¶
CancelTurn requests cancellation of the current turn and preserves the session.
func (*Manager) CatalogFacets ¶
func (m *Manager) CatalogFacets(ctx context.Context, query ListQuery) (store.SessionCatalogFacetResult, error)
CatalogFacets combines exact durable metadata with authoritative active badges. Search and selected badge do not change population chips; row queries own them.
func (*Manager) ClearConversation ¶
ClearConversation resets the persisted transcript and ACP conversation context for an existing session while preserving the same session id. The session is restarted on a fresh event store so subsequent prompts start from a clean conversation. Attachments are retained because they remain scoped to the unchanged session identity and may still be referenced outside the cleared epoch.
func (*Manager) ClearPendingInputs ¶
func (m *Manager) ClearPendingInputs( ctx context.Context, id string, caller PromptCaller, ) (ClearPendingInputsResult, error)
func (*Manager) ClearRuntimeSelection ¶
func (m *Manager) ClearRuntimeSelection(ctx context.Context, id string, expectedRevision int64) (*Info, error)
ClearRuntimeSelection removes the durable runtime preference for future prompts.
func (*Manager) CommandCatalog ¶
CommandCatalog returns the authoritative slash command projection for a session.
func (*Manager) Compactions ¶
func (*Manager) ContinueSession ¶
func (m *Manager) ContinueSession(ctx context.Context, opts ContinueSessionOpts) (DeriveResult, error)
ContinueSession continues a user session with another agent, runtime, or declared route. The source is only read; the child is committed with its derive receipt in one transaction; a retry with the same key returns the recorded outcome.
func (*Manager) Create ¶
Create resolves an agent definition, opens the session store, and starts a new runtime session.
func (*Manager) CreateAccepted ¶
CreateAccepted durably creates an active logical user session. The ACP process is intentionally left unbound until the first prompt supplies its runtime snapshot.
func (*Manager) CreateLifecycleContinuation ¶
func (m *Manager) CreateLifecycleContinuation( ctx context.Context, opts CreateOpts, ) (_ *Session, err error)
CreateLifecycleContinuation starts a Dream session for daemon-owned work that was accepted before public work admission began draining.
func (*Manager) CreateWorktreeForkAccepted ¶
func (m *Manager) CreateWorktreeForkAccepted( ctx context.Context, originSessionID string, opts CreateAcceptedOpts, ) (*Info, error)
CreateWorktreeForkAccepted atomically keeps the origin idle while accepting one clean child session.
func (*Manager) Delete ¶
Delete removes one session from active runtime state and persisted history.
func (*Manager) Deliveries ¶
func (*Manager) DerivePreview ¶
func (m *Manager) DerivePreview( ctx context.Context, workspaceID string, sourceSessionID string, messageID string, ) (DerivePreview, error)
DerivePreview reports what a continue or fork of the source would carry right now, from the same snapshot and bounding the derive uses. It never writes and never repairs the source.
func (*Manager) EnsureCreated ¶
func (m *Manager) EnsureCreated(ctx context.Context, opts CreateOpts) (EnsureCreatedResult, error)
EnsureCreated creates one preallocated session exactly once by immutable creation identity.
func (*Manager) Events ¶
func (m *Manager) Events( ctx context.Context, id string, query store.EventQuery, ) (events []store.SessionEvent, err error)
Events returns persisted session events for active or stopped sessions.
func (*Manager) ExpireRestartInteractions ¶
ExpireRestartInteractions terminalizes decisions whose provider turn was lost during restart.
func (*Manager) ForkSession ¶
func (m *Manager) ForkSession(ctx context.Context, opts ForkSessionOpts) (DeriveResult, error)
ForkSession forks a user session with the same agent: the whole conversation through its last settled turn, or through one durable user message and its turn. When the agent can clone its own session (ADR-003) the child loads that clone at its first bind; otherwise, and as the clone's fallback, it carries the bounded context.
func (*Manager) GetSessionHealth ¶
GetSessionHealth returns a route-ready metadata-only health read model.
func (*Manager) History ¶
func (m *Manager) History( ctx context.Context, id string, query store.EventQuery, ) (history []store.TurnHistory, err error)
History returns turn-grouped persisted session events for active or stopped sessions.
func (*Manager) InputQueueSummary ¶
InputQueueSummary returns the durable busy-input state for one session.
func (*Manager) InvokeTransientModel ¶
func (m *Manager) InvokeTransientModel( ctx context.Context, call TransientModelCall, ) (result TransientModelResult, operationErr error)
InvokeTransientModel performs one ACP turn without publishing a session row.
func (*Manager) IsPrompting ¶
IsPrompting reports whether the target session currently has an in-flight prompt setup or active turn.
func (*Manager) LatestSessionEventByType ¶
func (m *Manager) LatestSessionEventByType( ctx context.Context, sessionID string, eventType string, ) (*store.SessionEvent, error)
LatestSessionEventByType returns the newest persisted event for one session event type.
func (*Manager) LatestSettledTurn ¶
func (*Manager) ListAll ¶
ListAll returns active and stopped sessions discovered from on-disk metadata.
func (*Manager) ListPage ¶
ListPage returns a stable, bounded union of durable and active sessions. Active snapshots replace their durable rows before filtering, counting, and cutting.
func (*Manager) ListPendingInputs ¶
ListPendingInputs returns the daemon-owned current-generation input queue.
func (*Manager) ListSessionHealth ¶
func (m *Manager) ListSessionHealth( ctx context.Context, query heartbeat.SessionHealthListQuery, ) ([]heartbeat.SessionHealth, error)
ListSessionHealth refreshes active rows, marks stale rows, and returns persisted health.
func (*Manager) NotifyAgentExtension ¶
func (m *Manager) NotifyAgentExtension( ctx context.Context, sessionID, method string, params any, ) error
NotifyAgentExtension delivers one fire-and-forget extension notification to the live agent process.
func (*Manager) NotifyManagedInputReady ¶
NotifyManagedInputReady runs the unified selector for an idle session.
func (*Manager) PendingInteractions ¶
func (m *Manager) PendingInteractions( ctx context.Context, sessionID string, statuses []string, ) ([]store.PendingInteraction, error)
PendingInteractions lists the sanitized canonical records for one session.
func (*Manager) PrepareWorkspaceRemoval ¶
func (m *Manager) PrepareWorkspaceRemoval( ctx context.Context, workspaceID string, ) (workspacepkg.UnregisterPreparation, error)
func (*Manager) PromotePendingInputToSteer ¶
func (m *Manager) PromotePendingInputToSteer( ctx context.Context, id string, entryID string, opts PromotePendingInputOpts, ) (SendPromptResult, error)
PromotePendingInputToSteer atomically prioritizes queued input and interrupts its target turn.
func (*Manager) Prompt ¶
Prompt sends one prompt turn to an active session and mirrors the runtime stream into storage and observers.
func (*Manager) PromptLifecycleContinuation ¶
func (m *Manager) PromptLifecycleContinuation( ctx context.Context, id string, msg string, ) (<-chan acp.AgentEvent, error)
PromptLifecycleContinuation submits the turn for a daemon-owned Dream session whose lifecycle work was accepted before public admission drained.
func (*Manager) PromptSynthetic ¶
func (m *Manager) PromptSynthetic( ctx context.Context, id string, opts SyntheticPromptOpts, ) (<-chan acp.AgentEvent, error)
PromptSynthetic admits daemon-owned work to the shared durable queue.
func (*Manager) PromptWithOpts ¶
func (m *Manager) PromptWithOpts(ctx context.Context, id string, opts PromptOpts) (<-chan acp.AgentEvent, error)
PromptWithOpts sends one prompt turn with daemon-local provenance metadata.
func (*Manager) PublishClarifyEvent ¶
PublishClarifyEvent durably records one typed clarification transition before SSE publication.
func (*Manager) PublishOperatorNotification ¶
func (m *Manager) PublishOperatorNotification( ctx context.Context, req NotifyRequest, ) (NotifyResult, error)
PublishOperatorNotification validates, rate-limits, and publishes one sanitized event.
func (*Manager) ReconcileDerivedSessionEvents ¶
ReconcileDerivedSessionEvents re-emits session.derived for committed derived children whose ledger row is missing (ADR-007: a crash between the child's commit and the event write). The receipt's immutable outcome is the payload source; a child that already has the event, lost its derivation (cleared conversation), or has no matching receipt is skipped. It runs at boot before new work is admitted and returns the re-emitted count.
func (*Manager) RecoverPendingInteractions ¶
RecoverPendingInteractions marks requests from a dead turn as restart-orphaned.
func (*Manager) RecoverPendingStops ¶
RecoverPendingStops settles verified exits and terminates recovered orphans before boot admits work.
func (*Manager) RecoverSessionHealth ¶
func (m *Manager) RecoverSessionHealth(ctx context.Context) (HealthRecoveryResult, error)
RecoverSessionHealth recomputes persisted rows after daemon restart before wake decisions run.
func (*Manager) RefreshSoul ¶
RefreshSoul explicitly refreshes the session's resolved Soul snapshot.
func (*Manager) RefreshSoulWithExpectedDigest ¶
func (m *Manager) RefreshSoulWithExpectedDigest( ctx context.Context, id string, expectedDigest string, ) (SoulRefreshResult, error)
RefreshSoulWithExpectedDigest explicitly refreshes a session Soul snapshot after service-owned CAS.
func (*Manager) Rename ¶
func (m *Manager) Rename( ctx context.Context, workspaceID string, sessionID string, name string, ) (*Info, error)
Rename changes the durable display name of one user session without altering its runtime lifecycle or transcript identity.
func (*Manager) RepairSession ¶
func (m *Manager) RepairSession( ctx context.Context, opts RepairOpts, ) (result *RepairResult, err error)
RepairSession inspects one persisted session transcript and, when safe, appends terminal repair events for an interrupted final prompt turn.
func (*Manager) ReplacePendingInput ¶
func (m *Manager) ReplacePendingInput( ctx context.Context, id string, entryID string, opts ReplacePendingInputOpts, ) (PendingInput, error)
ReplacePendingInput atomically swaps one queued item for a new durable identity.
func (*Manager) RequestPermission ¶
func (m *Manager) RequestPermission( ctx context.Context, id string, req acp.RequestPermissionRequest, ) (acp.RequestPermissionResponse, error)
RequestPermission asks an active session's permission path for a tool-call decision.
func (*Manager) RequestStop ¶
RequestStop starts or joins a session stop without waiting for termination.
func (*Manager) RequestStopWithCause ¶
func (m *Manager) RequestStopWithCause(ctx context.Context, id string, cause StopCause, detail string) error
RequestStopWithCause persists stopping and starts the shared escalation operation.
func (*Manager) ResolveOrphanedClarification ¶
func (m *Manager) ResolveOrphanedClarification( ctx context.Context, scope toolspkg.Scope, requestID string, request toolspkg.ClarifyAnswerRequest, ) (toolspkg.ClarifyAnswerResult, error)
ResolveOrphanedClarification atomically records and queues an answer after daemon restart.
func (*Manager) Resume ¶
Resume restarts a stopped session from its persisted metadata and event history.
func (*Manager) RevokeManagedInput ¶
func (m *Manager) RevokeManagedInput(owner ManagedInputOwner, reason string)
RevokeManagedInput reconciles durable revocation and cancels only the exact in-memory lease.
func (*Manager) RewindConversation ¶
func (m *Manager) RewindConversation( ctx context.Context, id string, opts ConversationRewindOptions, ) (ConversationRewindResult, error)
RewindConversation archives the selected user message and the active suffix, then restarts the same logical session with a fresh ACP conversation context.
func (*Manager) SendPrompt ¶
func (m *Manager) SendPrompt(ctx context.Context, id string, opts SendPromptOpts) (SendPromptResult, error)
SendPrompt submits a user-facing prompt and applies busy-input policy when a turn is active.
func (*Manager) SessionAgentDefinition ¶
func (m *Manager) SessionAgentDefinition(id string) (compozyconfig.AgentDef, bool)
SessionAgentDefinition returns the concrete definition for one live session.
func (*Manager) SessionHealthForPage ¶
func (m *Manager) SessionHealthForPage( ctx context.Context, infos []*Info, ) (map[string]heartbeat.SessionHealth, error)
SessionHealthForPage derives current health for one bounded catalog page. Durable health is loaded in one query; no session metadata files are opened.
func (*Manager) SessionMetadataHealth ¶
SessionMetadataHealth reads persisted witnesses without repairing metadata or changing warning cadence.
func (*Manager) SessionOwner ¶
SessionOwner returns the workspace that owns a session, proven against the catalog, without repairing its metadata: resolving where a session lives never writes it (a continue/fork source stays byte-for-byte unchanged, ADR-007).
func (*Manager) SessionPresence ¶
func (m *Manager) SessionPresence( ctx context.Context, sessionID string, leaseID string, visible bool, ) (string, error)
SessionPresence acquires, renews, or releases one opaque per-client lease.
func (*Manager) SetAttentionConfig ¶
func (m *Manager) SetAttentionConfig(cfg compozyconfig.AttentionConfig) error
SetAttentionConfig applies the live notification policy.
func (*Manager) SetBusyInputDefaultMode ¶
SetBusyInputDefaultMode applies the follow-up preference to subsequent admissions.
func (*Manager) SetCompactionHandler ¶
func (m *Manager) SetCompactionHandler(handler CompactionHandler)
SetCompactionHandler late-binds the daemon memory runtime after manager construction.
func (*Manager) SetGoalCommandHandler ¶
func (m *Manager) SetGoalCommandHandler(handler GoalCommandHandler)
SetGoalCommandHandler installs the late-bound daemon dispatcher before API servers start.
func (*Manager) SetManagedInputLifecycle ¶
func (m *Manager) SetManagedInputLifecycle(lifecycle ManagedInputLifecycle)
SetManagedInputLifecycle installs the late-bound daemon lifecycle adapter.
func (*Manager) SetRuntimeSelection ¶
func (m *Manager) SetRuntimeSelection( ctx context.Context, id string, selection RuntimeSelection, expectedRevision int64, ) (*Info, error)
SetRuntimeSelection durably selects the default runtime for future prompts.
func (*Manager) SetSupervisedWorkRecovery ¶
func (m *Manager) SetSupervisedWorkRecovery(recoverWork SupervisedWorkRecovery)
SetSupervisedWorkRecovery installs the task settlement hook before stop replay or live supervision begins.
func (*Manager) SetTurnEndNotifier ¶
func (m *Manager) SetTurnEndNotifier(fn TurnEndNotifier)
SetTurnEndNotifier installs a post-construction callback invoked after each prompt turn finishes.
func (*Manager) SetWorkSignalSources ¶
func (m *Manager) SetWorkSignalSources(sources ...WorkSignalSource)
SetWorkSignalSources installs the daemon's authoritative inspection adapters.
func (*Manager) SetWorkspaceAccessPolicy ¶
func (m *Manager) SetWorkspaceAccessPolicy(policy workspaceaccess.Policy)
SetWorkspaceAccessPolicy installs the late-bound cross-workspace policy.
func (*Manager) Shutdown ¶
Shutdown releases session-manager background resources after active sessions stop.
func (*Manager) Spawn ¶
Spawn creates a bounded child session after enforcing lineage, TTL, caps, workspace bounds, and permission narrowing.
func (*Manager) SteerPrompt ¶
func (m *Manager) SteerPrompt(ctx context.Context, id string, opts SteerPromptOpts) (SendPromptResult, error)
SteerPrompt durably accepts guidance that replaces the fenced active turn.
func (*Manager) StopWithCause ¶
func (m *Manager) StopWithCause(ctx context.Context, id string, cause StopCause, detail string) error
StopWithCause waits for the same operation used by asynchronous stop requests.
func (*Manager) StopWithSpawnTTL ¶
StopWithSpawnTTL stops a spawned session and classifies its prompt state atomically with the lifecycle transition.
func (*Manager) SubprocessHealthSnapshots ¶
func (m *Manager) SubprocessHealthSnapshots() []SubprocessHealthSnapshot
SubprocessHealthSnapshots returns immutable snapshots for active processes that expose health state.
func (*Manager) SubscribeSessionCatalogEvents ¶
func (m *Manager) SubscribeSessionCatalogEvents( ctx context.Context, scope CatalogScope, ) (<-chan CatalogEvent, func(), error)
SubscribeSessionCatalogEvents registers a request-owned catalog wake stream. The caller must invoke the returned cancel function on every exit.
func (*Manager) SubscribeSessionEventWakes ¶
func (m *Manager) SubscribeSessionEventWakes( ctx context.Context, sessionID string, ) (<-chan store.SessionEvent, func(), error)
SubscribeSessionEventWakes registers an unfiltered projection wake subscriber.
func (*Manager) SubscribeSessionEvents ¶
func (m *Manager) SubscribeSessionEvents( ctx context.Context, sessionID string, afterSequence int64, ) (<-chan store.SessionEvent, func(), error)
SubscribeSessionEvents registers an in-process stream subscriber for already-persisted session events. Callers must read catch-up events after registration and deduplicate by sequence.
func (*Manager) Supervise ¶
Supervise inspects live sessions; the daemon owns its joined periodic cadence.
func (*Manager) TokenUsage ¶
TokenUsage returns the per-turn usage projection for active or stopped sessions.
func (*Manager) TouchSessionPresence ¶
func (m *Manager) TouchSessionPresence(ctx context.Context, id string) (heartbeat.SessionHealth, error)
TouchSessionPresence records an idle metadata-only presence touch for an attachable session.
func (*Manager) TranscriptChanges ¶
func (m *Manager) TranscriptChanges( ctx context.Context, id string, query transcript.ChangeQuery, ) (transcript.ChangePage, error)
TranscriptChanges returns materialized entries shaped after an event cursor.
func (*Manager) TranscriptOutline ¶
func (m *Manager) TranscriptOutline(ctx context.Context, id string) (transcript.OutlineResult, error)
TranscriptOutline returns every retained operator message and its reply preview.
func (*Manager) TranscriptPage ¶
func (m *Manager) TranscriptPage( ctx context.Context, id string, query transcript.PageQuery, ) (transcript.Page, error)
TranscriptPage returns one bounded materialized transcript window.
func (*Manager) TranscriptSearch ¶
func (m *Manager) TranscriptSearch( ctx context.Context, id string, query transcript.SearchQuery, ) (transcript.SearchResult, error)
TranscriptSearch returns bounded literal matches from the session's projection.
func (*Manager) TransportStats ¶
func (m *Manager) TransportStats(sessionID string) (TransportDeliveryStats, error)
TransportStats reports the ephemeral queues used by the active session.
func (*Manager) Unarchive ¶
func (m *Manager) Unarchive(ctx context.Context, workspaceID string, sessionID string) (*Info, error)
Unarchive restores a session to the default catalog.
func (*Manager) UpgradeSessionDatabase ¶
UpgradeSessionDatabase lets the daemon migrate retained histories before publishing read-only surfaces. Only a validated, older schema opens a writer; unknown, ahead, corrupt, or foreign databases retain their refusal unchanged.
func (*Manager) UsageEvents ¶
func (*Manager) WaitForBadge ¶
func (m *Manager) WaitForBadge(ctx context.Context, req WaitRequest) (outcome WaitOutcome, retErr error)
WaitForBadge blocks until a matching transition, bounded timeout, cancellation, overflow, or target identity loss. Registration precedes the initial snapshot.
func (*Manager) WaitForFinalizations ¶
WaitForFinalizations blocks until all in-flight finalization routines finish.
func (*Manager) WaitForPromptDrains ¶
WaitForPromptDrains blocks until active prompt tasks finish.
func (*Manager) WaitManagedInputLease ¶
func (m *Manager) WaitManagedInputLease(ctx context.Context, owner ManagedInputOwner) error
WaitManagedInputLease waits until the exact prompt pump has persisted its terminal and released.
type Notifier ¶
type Notifier interface {
OnSessionCreated(ctx context.Context, session *Session)
OnSessionStopped(ctx context.Context, session *Session)
OnAgentEvent(ctx context.Context, sessionID string, event any)
}
Notifier fans out session lifecycle and prompt events to downstream observers.
type NotifyOutcome ¶
type NotifyOutcome string
const ( NotifyOutcomeDelivered NotifyOutcome = "delivered" NotifyOutcomeNoClient NotifyOutcome = "no-client" NotifyOutcomeMutedWorkspace NotifyOutcome = "muted-workspace" NotifyOutcomeRateLimited NotifyOutcome = "rate-limited" )
type NotifyRequest ¶
type NotifyResult ¶
type NotifyResult struct {
Outcome NotifyOutcome
RetryAfterMS int64
}
type OperatorNotification ¶
type Option ¶
type Option func(*Manager)
Option customizes the session manager.
func WithAgentResolver ¶
func WithAgentResolver(resolver AgentResolver) Option
WithAgentResolver injects the daemon-authoritative agent definition resolver.
func WithAttachmentOpener ¶
func WithAttachmentOpener(opener AttachmentOpener) Option
WithAttachmentOpener injects session-scoped attachment reads at prompt dispatch.
func WithAttentionConfig ¶
func WithAttentionConfig(config compozyconfig.AttentionConfig) Option
WithAttentionConfig injects the live operator notification policy.
func WithAttentionWorkspaceMuteReader ¶
func WithAttentionWorkspaceMuteReader(reader AttentionWorkspaceMuteReader) Option
WithAttentionWorkspaceMuteReader injects the per-profile workspace mute catalog.
func WithCommandService ¶
func WithCommandService(service CommandService) Option
WithCommandService injects the daemon-owned slash command authority.
func WithCompactionHandler ¶
func WithCompactionHandler(handler CompactionHandler) Option
WithCompactionHandler injects the durable summary boundary used before archiving.
func WithDriver ¶
func WithDriver(driver AgentDriver) Option
WithDriver injects the runtime driver used for session lifecycle operations.
func WithEventLedger ¶
func WithEventLedger(ledger store.EventSummaryStore) Option
WithEventLedger injects the daemon ledger that records session.fallback.used before each fallback attempt (readable through GET /api/logs).
func WithGoalCommandHandler ¶
func WithGoalCommandHandler(handler GoalCommandHandler) Option
WithGoalCommandHandler injects the daemon-owned authenticated `/goal` dispatcher.
func WithHomePaths ¶
func WithHomePaths(homePaths compozyconfig.HomePaths) Option
WithHomePaths overrides the resolved Compozy home directory layout.
func WithHookSet ¶
WithHookSet injects the grouped hook dispatch surface used by the session manager for lifecycle and runtime hook points.
func WithHostedMCPLauncher ¶
func WithHostedMCPLauncher(launcher HostedMCPLauncher) Option
WithHostedMCPLauncher injects the session-bound Compozy-hosted MCP launcher.
func WithInteractionIDGenerator ¶
func WithInteractionIDGenerator(generator IDGenerator) Option
WithInteractionIDGenerator overrides pending-interaction id allocation.
func WithLedgerMaterializer ¶
func WithLedgerMaterializer(materializer LedgerMaterializer) Option
WithLedgerMaterializer injects the forensic session-ledger materializer.
func WithLifecycleContext ¶
WithLifecycleContext injects the daemon-owned lifecycle context used by background goroutines.
func WithLogger ¶
WithLogger injects the logger used by the session manager.
func WithMCPResolver ¶
func WithMCPResolver(resolver MCPResolver) Option
WithMCPResolver injects the skill MCP resolver used during session start.
func WithManagedInputLifecycle ¶
func WithManagedInputLifecycle(lifecycle ManagedInputLifecycle) Option
WithManagedInputLifecycle injects the daemon-owned managed prompt callbacks.
func WithModelCatalog ¶
func WithModelCatalog(catalog modelcatalog.Service) Option
WithModelCatalog injects the live model catalog used to validate explicit runtime models.
func WithNotifier ¶
WithNotifier injects the async notification fan-out implementation.
func WithPresenceLeaseIDGenerator ¶
func WithPresenceLeaseIDGenerator(generator IDGenerator) Option
WithPresenceLeaseIDGenerator overrides operator-presence lease id allocation.
func WithProfileNameResolver ¶
func WithProfileNameResolver(resolver ProfileNameResolver) Option
WithProfileNameResolver injects stable-id to current-name resolution for profile-owned resources.
func WithPromptAssembler ¶
func WithPromptAssembler(assembler PromptAssembler) Option
WithPromptAssembler injects prompt assembly for session startup.
func WithPromptBufferSize ¶
WithPromptBufferSize overrides the size of the returned prompt event buffer.
func WithPromptInputAugmenter ¶
func WithPromptInputAugmenter(augmenter PromptInputAugmenter) Option
WithPromptInputAugmenter injects a bounded pre-dispatch message augmenter.
func WithPromptRecoveryDelays ¶
WithPromptRecoveryDelays overrides the bounded automatic recovery schedule.
func WithProviderSecretResolver ¶
func WithProviderSecretResolver(resolver ProviderSecretResolver) Option
WithProviderSecretResolver injects the launch-time provider secret resolver.
func WithQueryStore ¶
func WithQueryStore(opener QueryStoreOpener) Option
WithQueryStore injects the opener used for stopped-session transcript/event reads. Production uses a read-only no-create opener so stale viewers cannot recreate events.db during clear/delete races.
func WithSessionBusyInputConfig ¶
func WithSessionBusyInputConfig(config compozyconfig.SessionBusyInputConfig) Option
WithSessionBusyInputConfig overrides busy-input queue behavior.
func WithSessionCatalog ¶
func WithSessionCatalog(catalog store.SessionCatalog) Option
WithSessionCatalog injects the global session catalog updated by lifecycle transitions.
func WithSessionCompactionConfig ¶
func WithSessionCompactionConfig(config compozyconfig.SessionCompactionConfig) Option
WithSessionCompactionConfig overrides pressure-triggered context compaction guards.
func WithSessionCreationStore ¶
func WithSessionCreationStore(creationStore store.SessionCreationStore) Option
WithSessionCreationStore injects the immutable session creation catalog.
func WithSessionDeriveConfig ¶
func WithSessionDeriveConfig(cfg compozyconfig.SessionDeriveConfig) Option
WithSessionDeriveConfig sets the carried-context bounds for continue and fork.
func WithSessionHealthConfig ¶
func WithSessionHealthConfig(config compozyconfig.HeartbeatConfig) Option
WithSessionHealthConfig injects Agent Heartbeat bounds used by session health.
func WithSessionHealthStore ¶
func WithSessionHealthStore(store HealthStore) Option
WithSessionHealthStore injects durable metadata-only session health storage.
func WithSessionIDGenerator ¶
func WithSessionIDGenerator(generator IDGenerator) Option
WithSessionIDGenerator overrides session id allocation.
func WithSessionInputQueueStore ¶
func WithSessionInputQueueStore(queueStore store.SessionInputQueueStore) Option
WithSessionInputQueueStore injects durable busy-input queue storage.
func WithSessionPromptAdmissionStore ¶
func WithSessionPromptAdmissionStore(admissionStore store.SessionPromptAdmissionStore) Option
WithSessionPromptAdmissionStore injects durable at-most-once prompt command storage.
func WithSessionStopConfig ¶
func WithSessionStopConfig(config compozyconfig.SessionStopConfig) Option
WithSessionStopConfig sets the cooperative grace used before escalation.
func WithSessionSupervision ¶
func WithSessionSupervision(config compozyconfig.SessionSupervisionConfig) Option
WithSessionSupervision overrides runtime activity supervision settings.
func WithSkillRegistry ¶
func WithSkillRegistry(registry SkillRegistry) Option
WithSkillRegistry injects the active-skill registry used during session start.
func WithSoulRunActivityChecker ¶
func WithSoulRunActivityChecker(checker SoulRunActivityChecker) Option
WithSoulRunActivityChecker injects the active-run predicate used by Soul refresh.
func WithSoulSnapshotStore ¶
func WithSoulSnapshotStore(store SoulSnapshotStore) Option
WithSoulSnapshotStore injects durable Soul snapshot/session provenance storage.
func WithSpawnWakeNotifier ¶
func WithSpawnWakeNotifier(notifier SpawnWakeNotifier) Option
WithSpawnWakeNotifier injects creator wake delivery for spawned sessions.
func WithStartupPromptOverlay ¶
func WithStartupPromptOverlay(overlay StartupPromptOverlay) Option
WithStartupPromptOverlay injects a daemon-owned startup prompt overlay.
func WithStore ¶
func WithStore(opener StoreOpener) Option
WithStore injects the opener used to create per-session event recorders.
func WithToolUniverse ¶
WithToolUniverse injects the concrete native tool IDs used to materialize root-session delegation budgets from agent tool patterns and toolsets.
func WithToolsetCatalog ¶
func WithToolsetCatalog(catalog toolspkg.ToolsetCatalog) Option
WithToolsetCatalog injects the catalog used to validate toolset-backed overrides.
func WithTranscriptEpochStore ¶
func WithTranscriptEpochStore(epochStore store.SessionTranscriptEpochStore) Option
WithTranscriptEpochStore injects durable transcript reset epoch storage.
func WithTurnIDGenerator ¶
func WithTurnIDGenerator(generator IDGenerator) Option
WithTurnIDGenerator overrides prompt turn id allocation.
func WithWindowReconciler ¶
func WithWindowReconciler(reconciler WindowReconciler) Option
WithWindowReconciler injects the daemon-owned window cleanup invoked after a session catalog deletion succeeds.
func WithWorkAdmissionChecker ¶
WithWorkAdmissionChecker injects the daemon-owned new-work gate.
func WithWorkspaceResolver ¶
func WithWorkspaceResolver(resolver workspacepkg.RuntimeResolver) Option
WithWorkspaceResolver injects workspace resolution for create/resume flows.
func WithWorktreeResolver ¶
func WithWorktreeResolver(resolver WorktreeResolver) Option
WithWorktreeResolver injects ready-worktree resolution for bound sessions.
type PendingInput ¶
type PendingInput struct {
ID string
SessionID string
OwnerKind string
OwnerID string
MessageID string
IdempotencyKey string
TargetTurnID string
Status string
Mode BusyInputMode
Delivery string
SteerDelivery store.SteerDeliveryMode
Text string
QueueGeneration int64
EnqueuedAt time.Time
Runtime *RuntimeSelection
SkillInvocations []commandpkg.Invocation
Attachments []AttachmentMeta
}
PendingInput is one daemon-owned operator input waiting for dispatch.
type PendingInteractionResolution ¶
type PendingInteractionResolution struct {
Outcome string
InteractionID string
RequestID string
Resolution string
}
PendingInteractionResolution reports one canonical orphan-resolution attempt.
type ProfileNameResolver ¶
type ProfileNameResolver interface {
ProfileName(ctx context.Context, profileID string) (string, error)
}
ProfileNameResolver maps stable profile ids to the current vault/resource name.
type PromotePendingInputOpts ¶
type PromotePendingInputOpts struct {
Text string
MessageID string
IdempotencyKey string
ExpectedTurnID string
AllowCommands bool
Caller PromptCaller
}
PromotePendingInputOpts carries an atomic queue-to-steer replacement.
type PromptAssembler ¶
type PromptAssembler interface {
Assemble(
ctx context.Context,
agent compozyconfig.AgentDef,
workspace *workspacepkg.ResolvedWorkspace,
) (string, error)
}
PromptAssembler assembles the prompt context for a new session start.
type PromptCaller ¶
PromptCaller is the authenticated operator identity admitted by an external prompt ingress.
func (PromptCaller) Validate ¶
func (c PromptCaller) Validate() error
Validate rejects incomplete caller provenance.
type PromptCancelOutcome ¶
type PromptCancelOutcome string
PromptCancelOutcome is the stable result of one idempotent cancellation request.
const ( PromptCancelOutcomeCanceled PromptCancelOutcome = "canceled" PromptCancelOutcomeNothingInFlight PromptCancelOutcome = "nothing-in-flight" )
type PromptCancelResult ¶
type PromptCancelResult struct {
Outcome PromptCancelOutcome
TurnID string
}
PromptCancelResult identifies the canceled turn when one was active.
type PromptDelivery ¶
PromptDelivery identifies a prompt whose agent-event stream is ready to start.
type PromptDeliveryPreparer ¶
type PromptDeliveryPreparer func(context.Context, PromptDelivery) error
PromptDeliveryPreparer runs after the provider accepts a prompt and before its first event is pumped.
type PromptHooks ¶
type PromptHooks interface {
DispatchInputPreSubmit(context.Context, hookspkg.InputPreSubmitPayload) (hookspkg.InputPreSubmitPayload, error)
DispatchPromptPostAssemble(context.Context, hookspkg.PromptPayload) (hookspkg.PromptPayload, error)
}
PromptHooks groups prompt assembly and user-input hook dispatch.
type PromptInputAugmenter ¶
type PromptInputAugmenter func(ctx context.Context, session *Session, message string) (string, error)
PromptInputAugmenter can add bounded daemon-local context before prompt dispatch.
type PromptOpts ¶
type PromptOpts struct {
Message string
TurnSource TurnSource
PromptMeta acp.PromptMeta
DeliveryContext context.Context
PrepareDelivery PromptDeliveryPreparer
}
PromptOpts carries per-turn metadata through the session prompt pipeline.
type PromptProvider ¶
type PromptProvider interface {
PromptSection(ctx context.Context, workspace *workspacepkg.ResolvedWorkspace) (string, error)
}
PromptProvider returns one workspace-scoped prompt section for composed system-prompt assembly.
type PromptRunIdentity ¶
type PromptRunIdentity struct {
WorkspaceID string
ProfileID string
SessionID string
RunID string
Generation int64
}
PromptRunIdentity is the complete authority tuple for one active prompt run.
type ProviderSecretResolver ¶
type ProviderSecretResolver interface {
ResolveRef(ctx context.Context, ref string) (string, error)
}
ProviderSecretResolver resolves provider-bound secret refs at launch time.
type QueryStoreOpener ¶
type QueryStoreOpener func(ctx context.Context, owner store.SessionDBOwner, path string) (EventReadCloser, error)
QueryStoreOpener opens the read-only per-session events store for the exact immutable owner. Implementations must forward both owner fields unchanged.
type QuietWarning ¶
type QuietWarning struct {
QuietSince time.Time `json:"quiet_since"`
WarnedAt time.Time `json:"warned_at"`
StopAt *time.Time `json:"stop_at"`
}
QuietWarning records one quiet episode and its optional inactivity-stop deadline.
type RepairAction ¶
type RepairAction struct {
Code string
TurnID string
EventID string
ToolCallID string
ToolName string
Persisted bool
}
RepairAction is one append-only mutation planned or persisted by repair.
type RepairIssue ¶
RepairIssue is one non-mutating diagnostic discovered during repair.
type RepairOpts ¶
RepairOpts controls one persisted session repair pass.
type RepairResult ¶
type RepairResult struct {
SessionID string
Issues []RepairIssue
Actions []RepairAction
Persisted bool
}
RepairResult describes the detected inconsistencies and append-only repair events planned or persisted for a session.
type ReplacePendingInputOpts ¶
type ReplacePendingInputOpts struct {
Text string
MessageID string
IdempotencyKey string
AllowCommands bool
Caller PromptCaller
}
ReplacePendingInputOpts carries an atomic queued-input replacement.
type ResumeContextProvider ¶
type ResumeContextProvider interface {
ResumeContextSection(ctx context.Context, startup StartupPromptContext) (string, error)
}
ResumeContextProvider supplies workspace continuity that must accompany a degraded resume replay without coupling session lifecycle code to memory.
type RuntimeConfigurator ¶
type RuntimeConfigurator interface {
ConfigureRuntime(ctx context.Context, proc *AgentProcess, config acp.RuntimeConfig) error
}
RuntimeConfigurator is the optional driver surface for applying mutable ACP settings at a prompt boundary without replacing the process.
type RuntimeRecoveryHooks ¶
type RuntimeRecoveryHooks interface {
DispatchSessionRuntimeRecoveryStarted(
context.Context,
hookspkg.SessionRuntimeRecoveryStartedPayload,
) (hookspkg.SessionRuntimeRecoveryStartedPayload, error)
DispatchSessionRuntimeRecoverySucceeded(
context.Context,
hookspkg.SessionRuntimeRecoverySucceededPayload,
) (hookspkg.SessionRuntimeRecoverySucceededPayload, error)
DispatchSessionRuntimeRecoveryExhausted(
context.Context,
hookspkg.SessionRuntimeRecoveryExhaustedPayload,
) (hookspkg.SessionRuntimeRecoveryExhaustedPayload, error)
}
RuntimeRecoveryHooks groups automatic runtime recovery observation dispatch.
type RuntimeSelection ¶
type RuntimeSelection struct {
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
}
RuntimeSelection is the immutable runtime snapshot accepted with one prompt.
func NormalizeRuntimeSelection ¶
func NormalizeRuntimeSelection(selection RuntimeSelection) (RuntimeSelection, error)
NormalizeRuntimeSelection returns the canonical prompt-bound runtime input.
type RuntimeStatus ¶
type RuntimeStatus = store.SessionRuntimeStatus
RuntimeStatus reports the binding lifecycle between a logical session and its current ACP process.
type RuntimeTransitionStrategy ¶
type RuntimeTransitionStrategy = store.SessionRuntimeTransition
RuntimeTransitionStrategy identifies how the effective runtime changed at a prompt boundary.
type ScopedInterrupter ¶
type ScopedInterrupter interface {
Interrupt(ctx context.Context, sessionID string, turnID string) (toolruntime.InterruptReport, error)
}
ScopedInterrupter is the optional process-scoped interrupt surface for drivers.
type SendOutcome ¶
type SendOutcome struct {
Disposition Disposition
Delivery store.SteerDeliveryMode
TurnID string
EntryID string
MessageID string
IdempotencyKey string
QueuePosition int
Replayed bool
}
SendOutcome is the immutable acceptance shared by all prompt transports.
type SendPromptOpts ¶
type SendPromptOpts struct {
Message string
MessageID string
IdempotencyKey string
Mode BusyInputMode
Runtime *RuntimeSelection
ExpectedTurnID string
DeliveryContext context.Context
Caller PromptCaller
AllowCommands bool
Attachments []AttachmentMeta
}
SendPromptOpts carries one user-facing prompt plus optional busy-input mode.
type SendPromptResult ¶
type SendPromptResult struct {
Status string
Mode BusyInputMode
Delivery string
SteerDelivery store.SteerDeliveryMode
MessageID string
IdempotencyKey string
Replayed bool
Events <-chan acp.AgentEvent
QueueEntryID string
QueuePosition int
QueueGeneration int64
EstimatedSendAt *time.Time
PreviousTurnID string
NewTurnID string
CanceledQueuedEntries int
Goal *GoalCommandResult
}
SendPromptResult reports how and when the daemon accepted input for delivery.
func (SendPromptResult) Outcome ¶
func (r SendPromptResult) Outcome() SendOutcome
type Session ¶
type Session struct {
ID string
ProfileID string
Name string
AgentName string
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
SpeedResolution *speedpkg.Resolution
RuntimeStatus RuntimeStatus
RuntimeTransition RuntimeTransitionStrategy
RuntimeFailure string
RuntimeGeneration int64
RuntimeRecovery *store.SessionRuntimeRecovery
SelectedRuntime *RuntimeSelection
RuntimeSelectionRevision int64
EffectivePermissions string
WorkspaceID string
Workspace string
WorktreeID string
CWD string
Type Type
Lineage *store.SessionLineage
State State
ACPSessionID string
ACPCaps acp.Caps
ACPCapsKnown bool
AdvertisedCommands []store.SessionAdvertisedCommand
Liveness *store.SessionLivenessMeta
SoulSnapshotID string
SoulDigest string
ParentSoulDigest string
AttachedTo string
AttachExpiresAt *time.Time
TranscriptEpoch int64
PendingPermissionCount int
PendingClarifyCount int
AttentionRevision int64
LastSettledRevision int64
LastSeenRevision int64
LastSeenAt *time.Time
AttentionChangedAt *time.Time
PendingInteractions []store.PendingInteraction
CreatedAt time.Time
UpdatedAt time.Time
// contains filtered or unexported fields
}
Session is the in-memory runtime representation of one active or stopping session.
func NotificationSessionFromInfo ¶
NotificationSessionFromInfo builds a detached lifecycle snapshot for notifier consumers that need the same immutable read model as a managed Session.
func (*Session) AgentDefinition ¶
func (s *Session) AgentDefinition() compozyconfig.AgentDef
AgentDefinition returns the concrete definition snapshot that owns this session. The snapshot is immutable from callers' perspective.
func (*Session) ApprovePermission ¶
ApprovePermission resolves one pending permission request for an active session.
func (*Session) CurrentPromptMessage ¶
CurrentPromptMessage reports the authored text of the active prompt turn.
func (*Session) CurrentPromptMeta ¶
func (s *Session) CurrentPromptMeta() acp.PromptMeta
CurrentPromptMeta reports the normalized metadata for the currently active prompt turn.
func (*Session) CurrentSkillInvocations ¶
func (s *Session) CurrentSkillInvocations() []commandpkg.Invocation
func (*Session) CurrentTurnID ¶
CurrentTurnID reports the active prompt turn identifier.
func (*Session) CurrentTurnSource ¶
func (s *Session) CurrentTurnSource() TurnSource
CurrentTurnSource reports the provenance of the currently active prompt turn.
func (*Session) IsPrompting ¶
IsPrompting reports whether the session currently has prompt setup or turn execution in flight.
func (*Session) Meta ¶
func (s *Session) Meta() store.SessionMeta
Meta returns the current metadata snapshot for persistence.
func (*Session) RequestPermission ¶
func (s *Session) RequestPermission( ctx context.Context, req acp.RequestPermissionRequest, ) (acp.RequestPermissionResponse, error)
RequestPermission asks the active session process for a permission decision.
func (*Session) SessionDir ¶
SessionDir reports the on-disk session directory path.
type SettledTurn ¶
type SignalSource ¶
type SignalSource interface {
Signals(context.Context, string) ([]WorkSignal, error)
}
SignalSource inspects one authoritative subsystem without renewing its evidence.
type SignalSourceFunc ¶
type SignalSourceFunc func(context.Context, string) ([]WorkSignal, error)
SignalSourceFunc adapts a subsystem's existing read boundary.
func (SignalSourceFunc) Signals ¶
func (f SignalSourceFunc) Signals(ctx context.Context, id string) ([]WorkSignal, error)
type SignalSourceState ¶
type SignalSourceState struct {
Kind WorkSignalKind `json:"kind"`
State string `json:"state"`
Ref string `json:"ref,omitempty"`
Error string `json:"error,omitempty"`
}
SignalSourceState makes absence, stale evidence and failed inspections explicit.
type SkillRegistry ¶
type SkillRegistry interface {
ForWorkspace(ctx context.Context, resolved *workspacepkg.ResolvedWorkspace) ([]*skillspkg.Skill, error)
ForAgentDef(
ctx context.Context,
resolved *workspacepkg.ResolvedWorkspace,
agent compozyconfig.AgentDef,
) ([]*skillspkg.Skill, error)
}
SkillRegistry resolves the active skill set for a workspace during session start.
type SoulRefreshResult ¶
type SoulRefreshResult struct {
SessionID string
AgentName string
SoulSnapshotID string
SoulDigest string
ParentSoulDigest string
Snapshot *soul.Snapshot
Soul *soul.ResolvedSoul
ConfigProvenance soul.ConfigProvenance
RefreshedAt time.Time
}
SoulRefreshResult is the internal result returned after a session Soul refresh.
type SoulRunActivityChecker ¶
type SoulRunActivityChecker interface {
HasActiveRunForSession(ctx context.Context, sessionID string, now time.Time) (bool, error)
}
SoulRunActivityChecker reports whether a session currently owns an active run.
type SoulSnapshotStore ¶
type SoulSnapshotStore interface {
UpsertSoulSnapshot(ctx context.Context, snapshot soul.Snapshot) (soul.Snapshot, error)
GetSoulSnapshot(ctx context.Context, id string) (soul.Snapshot, error)
UpdateSessionSoulSnapshot(ctx context.Context, update store.SessionSoulSnapshotUpdate) error
}
SoulSnapshotStore is the durable storage needed by session Soul integration.
type SpawnHooks ¶
type SpawnHooks interface {
DispatchSpawnPreCreate(context.Context, hookspkg.SpawnPreCreatePayload) (hookspkg.SpawnPreCreatePayload, error)
DispatchSpawnCreated(context.Context, hookspkg.SpawnCreatedPayload) (hookspkg.SpawnCreatedPayload, error)
DispatchSpawnParentStopped(
context.Context,
hookspkg.SpawnParentStoppedPayload,
) (hookspkg.SpawnParentStoppedPayload, error)
DispatchSpawnTTLExpired(
context.Context,
hookspkg.SpawnTTLExpiredPayload,
) (hookspkg.SpawnTTLExpiredPayload, error)
DispatchSpawnReaped(
context.Context,
hookspkg.SpawnReapedPayload,
) (hookspkg.SpawnReapedPayload, error)
}
SpawnHooks groups safe child-session spawn hook dispatch.
type SpawnOpts ¶
type SpawnOpts struct {
ParentSessionID string
// InheritedWorktreeID is daemon-owned structural context copied from the parent.
// Public callers cannot select or override it.
InheritedWorktreeID string
AgentName string
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []acp.SessionConfigOptionSelection
Name string
Workspace string
WorkspacePath string
PromptOverlay string
SpawnRole string
TTL time.Duration
AutoStopOnParent bool
NotifyCreator bool
NotifyCreatorSet bool
PermissionPolicy store.SessionPermissionPolicy
IdempotencyKey string
AllowStoppedParent bool
// DiscardStartFailure is reserved for ephemeral internal role attempts.
DiscardStartFailure bool
// Command is an explicit launch command for this attempt (a fallback route's account).
Command string
// ChainOwner declares who owns the fallback chain; see CreateOpts.ChainOwner.
ChainOwner ChainOwner
}
SpawnOpts defines the safe child-session creation request accepted by the manager.
type SpawnWakeEvent ¶
type SpawnWakeEvent struct {
ChildSessionID string `json:"child_session_id"`
ChildAgentName string `json:"child_agent_name,omitempty"`
Reason SpawnWakeReason `json:"reason"`
Badge Badge `json:"badge"`
Detail string `json:"detail,omitempty"`
WakeEventID string `json:"wake_event_id"`
}
SpawnWakeEvent is the bounded child-session wake payload handed to the daemon bridge.
func (SpawnWakeEvent) Normalize ¶
func (event SpawnWakeEvent) Normalize() SpawnWakeEvent
Normalize returns canonical, redacted, bounded wake data.
func (SpawnWakeEvent) Validate ¶
func (event SpawnWakeEvent) Validate() error
Validate reports whether a normalized wake event has a complete delivery identity.
type SpawnWakeNotifier ¶
type SpawnWakeNotifier interface {
WakeSpawnCreator(ctx context.Context, creatorSessionID string, event SpawnWakeEvent) error
}
SpawnWakeNotifier delivers a child-session wake to its creator.
type SpawnWakeReason ¶
type SpawnWakeReason string
SpawnWakeReason identifies why a child woke its creator.
const ( // SpawnWakeReasonStopped wakes the creator when a child stops without failure. SpawnWakeReasonStopped SpawnWakeReason = "stopped" // SpawnWakeReasonFailed wakes the creator when a child reaches a failed badge. SpawnWakeReasonFailed SpawnWakeReason = "failed" // SpawnWakeReasonNeedsAttention wakes the creator when a child needs input or approval. SpawnWakeReasonNeedsAttention SpawnWakeReason = "needs_attention" // SpawnWakeReasonCompleted wakes the creator when a child finishes its turn normally. SpawnWakeReasonCompleted SpawnWakeReason = "completed" )
type StartupManifestAssembler ¶
type StartupManifestAssembler interface {
AssembleStartupWithManifest(
context.Context,
StartupPromptContext,
compozyconfig.AgentDef,
*workspacepkg.ResolvedWorkspace,
) (string, acp.StartupManifest, error)
}
StartupManifestAssembler retains the section boundaries of an assembled prompt.
type StartupPromptAssembler ¶
type StartupPromptAssembler interface {
AssembleStartup(
ctx context.Context,
startup StartupPromptContext,
agent compozyconfig.AgentDef,
workspace *workspacepkg.ResolvedWorkspace,
) (string, error)
}
StartupPromptAssembler optionally extends PromptAssembler with durable startup context so daemon-owned assemblers can select sections before the final system prompt is concatenated.
type StartupPromptContext ¶
type StartupPromptContext struct {
SessionID string
ProfileID string
SessionName string
AgentName string
Provider string
ProviderHomePolicy compozyconfig.ProviderHomePolicy
WorkspaceID string
Workspace string
WorktreeID string
SessionType Type
SpawnRole string
SoulSnapshot *soul.Snapshot
CreatedAt time.Time
UpdatedAt time.Time
}
StartupPromptContext carries the durable session metadata available during startup prompt assembly and overlay selection.
type StartupPromptOverlay ¶
type StartupPromptOverlay interface {
Apply(ctx context.Context, startup StartupPromptContext, prompt string) (string, error)
}
StartupPromptOverlay applies daemon-owned startup prompt overlays after the base assembler has produced the startup prompt.
type SteerPromptOpts ¶
type SteerPromptOpts struct {
Message string
MessageID string
IdempotencyKey string
ExpectedTurnID string
Runtime *RuntimeSelection
AllowCommands bool
Caller PromptCaller
}
SteerPromptOpts carries one explicitly identified steering command.
type StopCause ¶
type StopCause int
StopCause records why a session stop was initiated.
const ( CauseNone StopCause = iota CauseCompleted CauseFailed CauseUserRequested CauseShutdown CauseHookDenied CauseProcessExited CauseTimeout CauseClearConversation CauseConversationRewind // CauseSpawnTTLExpired asks the session manager to classify the stop while // holding the session lifecycle lock, so prompt admission cannot race the // TTL decision. CauseSpawnTTLExpired CauseInactivity )
type StopContract ¶
type StopContract interface {
CancelTurn(context.Context, string, string, StopCause) error
AwaitTurnQuiesced(context.Context, string, string) (TurnCancelOutcome, error)
RequestStop(context.Context, string, StopCause) error
AwaitStopped(context.Context, string) (StopOutcome, error)
}
StopContract exposes the two scopes of managed termination.
type StopOutcome ¶
type StopOutcome struct {
FinalState State
Verified bool
Cause StopCause
Escalated bool
Phase StopPhase
Elapsed time.Duration
}
StopOutcome records confirmed termination or exhausted verification.
type StoreOpener ¶
type StoreOpener func(ctx context.Context, owner store.SessionDBOwner, path string) (EventRecorder, error)
StoreOpener opens the per-session events store for the exact immutable owner. Implementations must forward both owner fields unchanged to the storage boundary.
type SubprocessHealthNotifier ¶
type SubprocessHealthNotifier interface {
OnSubprocessHealth(context.Context, SubprocessHealthSnapshot)
}
SubprocessHealthNotifier is an optional notifier extension for observed failed health verdicts.
type SubprocessHealthSnapshot ¶
type SubprocessHealthSnapshot struct {
SessionID string
WorkspaceID string
AgentName string
Health subprocess.HealthState
}
SubprocessHealthSnapshot is one immutable health observation for an active session process.
type SupervisedWorkRecovery ¶
SupervisedWorkRecovery settles task ownership while the verified inactivity stop receipt still fences session reuse.
type SupervisionState ¶
type SupervisionState struct {
WorkSignals []WorkSignal `json:"work_signals"`
Sources []SignalSourceState `json:"sources"`
QuietWarning *QuietWarning `json:"quiet_warning"`
}
SupervisionState is the session's last authoritative work inspection.
func CloneSupervisionState ¶
func CloneSupervisionState(state *SupervisionState) *SupervisionState
CloneSupervisionState isolates runtime read models and preserves empty arrays.
type SyntheticPromptOpts ¶
type SyntheticPromptOpts struct {
Message string
Metadata acp.PromptSyntheticMeta
TurnID string
SkipIfBusy bool
InterruptIfAgentWaiting bool
}
SyntheticPromptOpts carries daemon-owned synthetic prompt input plus wake-up metadata required for persistence and later reentry handling.
type ToolHooks ¶
type ToolHooks interface {
DispatchToolPreCall(context.Context, hookspkg.ToolPreCallPayload) (hookspkg.ToolPreCallPayload, error)
DispatchToolPostCall(context.Context, hookspkg.ToolPostCallPayload) (hookspkg.ToolPostCallPayload, error)
DispatchToolPostError(context.Context, hookspkg.ToolPostErrorPayload) (hookspkg.ToolPostErrorPayload, error)
}
ToolHooks groups provider-native tool execution hook dispatch.
type TransientModelCall ¶
type TransientModelCall struct {
Config *compozyconfig.Config
Provider string
Model string
ReasoningEffort string
Speed speedpkg.Speed
ACPOptions []compozyconfig.ACPOptionSelection
CWD string
SystemPrompt string
Prompt string
MaxOutputBytes int
// Command is forwarded as RuntimeOverrides.Command for the transient agent (a
// fallback route's account). Empty keeps the provider command.
Command string
}
TransientModelCall describes one provider-backed model turn that must not create a durable Compozy session.
type TransientModelResult ¶
TransientModelResult reports whether ACP accepted the transient session. Accepted is set at ACP acceptance (Driver.Start returned a process, or its error carries acp.AcceptedStartError); once accepted, higher layers must not attempt a route fallback even when a later step fails.
type TransportDeliveryStats ¶
type TransportDeliveryStats struct {
Ingest acp.IngestStats
Broadcast acp.BroadcastStats
}
TransportDeliveryStats separates durable ingestion from watcher delivery.
type TurnCancelOutcome ¶
type TurnCancelOutcome struct {
TurnID string
Quiesced bool
Escalated bool
Phase StopPhase
Elapsed time.Duration
}
TurnCancelOutcome describes verified turn quiescence and any escalation.
type TurnEndNotifier ¶
type TurnEndNotifier func(context.Context, PromptRunIdentity)
TurnEndNotifier is invoked once after a prompt run finishes dispatching.
type TurnSource ¶
type TurnSource string
TurnSource classifies the origin of a prompt turn inside the daemon runtime.
const ( TurnSourceUser TurnSource = TurnSource(acp.PromptTurnSourceUser) TurnSourceSynthetic TurnSource = TurnSource(acp.PromptTurnSourceSynthetic) )
type UsageEventEnvelope ¶
type WaitOutcome ¶
type WaitOutcome struct {
Outcome WaitResult
State Badge
Waited time.Duration
Revision int64
ResumeID string
}
WaitOutcome reports the observed edge and its catalog-owned fence.
type WaitRequest ¶
type WaitRequest struct {
SessionID string
Until []Badge
Timeout time.Duration
Epoch int64
ResumeID string
}
WaitRequest describes one always-bounded badge wait or resume attempt.
type WaitResult ¶
type WaitResult string
WaitResult is the terminal result of one bounded badge wait.
const ( WaitResultStateReached WaitResult = "state-reached" WaitResultTimeout WaitResult = "timeout" WaitResultSessionGone WaitResult = "session-gone" WaitResultCanceled WaitResult = "canceled" WaitResultOverflow WaitResult = "overflow" )
type WindowReconciler ¶
type WindowReconciler interface {
ReconcileDeletedSession(ctx context.Context, profileID, workspaceID, sessionID string) error
}
WindowReconciler removes durable session windows after a session deletion has committed its catalog mutation.
type WorkSignal ¶
type WorkSignal struct {
Kind WorkSignalKind `json:"kind"`
Since time.Time `json:"since"`
Ref string `json:"ref,omitempty"`
ValidUntil time.Time `json:"-"`
StaleAttention bool `json:"-"`
AttentionReason string `json:"-"`
}
WorkSignal is ephemeral evidence of work; it never enters session persistence.
type WorkSignalKind ¶
type WorkSignalKind string
WorkSignalKind names the authoritative sources allowed to defer inactivity stops.
const ( WorkSignalAgentProgress WorkSignalKind = "agent_progress" WorkSignalToolRunning WorkSignalKind = "tool_running" WorkSignalActiveChild WorkSignalKind = "active_child" WorkSignalLoopRun WorkSignalKind = "loop_run" WorkSignalTaskLease WorkSignalKind = "task_lease" WorkSignalScheduledWait WorkSignalKind = "scheduled_wait" )
type WorkSignalRegistry ¶
type WorkSignalRegistry struct {
// contains filtered or unexported fields
}
WorkSignalRegistry collects fresh evidence without owning the evidence's lifecycle.
func NewWorkSignalRegistry ¶
func NewWorkSignalRegistry(sources ...WorkSignalSource) *WorkSignalRegistry
func (*WorkSignalRegistry) Inspect ¶
func (r *WorkSignalRegistry) Inspect(ctx context.Context, id string, now time.Time) *SupervisionState
Inspect reports unknown sources explicitly; no failed inspection renews a signal.
func (*WorkSignalRegistry) Register ¶
func (r *WorkSignalRegistry) Register(sources ...WorkSignalSource)
type WorkSignalSource ¶
type WorkSignalSource struct {
Kind WorkSignalKind
Source SignalSource
}
WorkSignalSource binds a known kind to its authoritative inspection adapter.
Source Files
¶
- acp_driver_adapter.go
- action_actor.go
- active_turn_error.go
- advertised_commands.go
- agent_metrics.go
- agent_steer.go
- archive.go
- attachment_meta.go
- attention_hooks.go
- badge.go
- badge_filter.go
- catalog_facets.go
- catalog_page.go
- catalog_page_attention.go
- catalog_page_order.go
- catalog_search.go
- clarify_keepalive.go
- command_catalog.go
- command_parser.go
- compaction.go
- compaction_contract.go
- compaction_lifecycle.go
- crash_bundle.go
- creation_profile_builder.go
- derive.go
- derive_commit.go
- derive_cut.go
- derive_first_prompt.go
- derive_handoff.go
- derive_native.go
- derive_native_bind.go
- derive_prepare.go
- derive_preview.go
- derive_reconcile.go
- derive_replay.go
- derive_route_bind.go
- derive_snapshot.go
- derive_types.go
- effect_certainty.go
- failure.go
- fallback.go
- fallback_evidence.go
- field_keys.go
- file_mutation_verifier.go
- goal_command.go
- goal_contract.go
- goal_snapshot_event.go
- health.go
- health_derivation.go
- health_hooks.go
- health_page.go
- health_refresh.go
- health_store.go
- hook_dispatch_events.go
- hooks.go
- hooks_noop_attention.go
- hooks_noop_conversation.go
- hooks_noop_lifecycle.go
- hooks_noop_spawn.go
- interfaces.go
- ledger.go
- liveness.go
- managed_input_goal_meta.go
- managed_input_lifecycle.go
- manager.go
- manager_admission.go
- manager_allowed_tools.go
- manager_attach.go
- manager_busy_input.go
- manager_busy_input_activation.go
- manager_busy_input_config.go
- manager_busy_input_queue.go
- manager_busy_input_types.go
- manager_clarify_event.go
- manager_clear.go
- manager_clear_cleanup_operation.go
- manager_clear_family_cleanup.go
- manager_clear_family_operation.go
- manager_clear_manifest.go
- manager_clear_operation.go
- manager_context.go
- manager_conversation_operation.go
- manager_conversation_rewind.go
- manager_conversation_rewind_resume.go
- manager_create_accepted.go
- manager_create_prepare.go
- manager_defaults.go
- manager_delete.go
- manager_delete_attachment_commit.go
- manager_delete_attachments.go
- manager_delete_capabilities.go
- manager_delete_commit.go
- manager_delete_reconciliation.go
- manager_delete_staging.go
- manager_delete_tombstone.go
- manager_denied_tools.go
- manager_durable_event.go
- manager_empty_interrupt.go
- manager_finalization.go
- manager_goal_commands.go
- manager_goal_snapshot_event.go
- manager_helpers.go
- manager_hooks.go
- manager_hooks_agents.go
- manager_hooks_command.go
- manager_hooks_context.go
- manager_hooks_events.go
- manager_hooks_helpers.go
- manager_hooks_prompt.go
- manager_hooks_runtime_recovery.go
- manager_input_clear.go
- manager_input_clear_events.go
- manager_input_dispatch.go
- manager_latest_event.go
- manager_lifecycle.go
- manager_lifecycle_state.go
- manager_managed_input.go
- manager_managed_input_submit.go
- manager_managed_input_terminal.go
- manager_managed_input_usage.go
- manager_options.go
- manager_pending_input.go
- manager_process_watchers.go
- manager_prompt.go
- manager_prompt_admission.go
- manager_prompt_admission_identity.go
- manager_prompt_admission_target.go
- manager_prompt_attachments.go
- manager_prompt_batch.go
- manager_prompt_capabilities.go
- manager_prompt_context.go
- manager_prompt_delivery.go
- manager_prompt_event_observation.go
- manager_prompt_event_storage.go
- manager_prompt_failure_barrier.go
- manager_prompt_hosted.go
- manager_prompt_identity.go
- manager_prompt_input_event.go
- manager_prompt_persistence.go
- manager_prompt_post_stop.go
- manager_prompt_process_exit.go
- manager_prompt_pump.go
- manager_prompt_recovery.go
- manager_prompt_request.go
- manager_prompt_runtime.go
- manager_prompt_runtime_fallback.go
- manager_prompt_runtime_loop.go
- manager_prompt_state.go
- manager_prompt_submit.go
- manager_prompt_tasks.go
- manager_prompt_terminal.go
- manager_provenance.go
- manager_reasoning.go
- manager_resume.go
- manager_resume_affinity.go
- manager_resume_run.go
- manager_runtime_model_validation.go
- manager_runtime_precedence.go
- manager_runtime_selection.go
- manager_session_db_family.go
- manager_session_owner.go
- manager_shutdown.go
- manager_start.go
- manager_start_accept.go
- manager_start_env.go
- manager_start_fallback.go
- manager_start_launch.go
- manager_start_launch_accepted.go
- manager_start_mcp.go
- manager_start_meta.go
- manager_start_reservation.go
- manager_start_run.go
- manager_start_runtime.go
- manager_start_session.go
- manager_start_stop.go
- manager_start_storage.go
- manager_start_types.go
- manager_steer.go
- manager_steer_completion.go
- manager_stop_finalization.go
- manager_stop_receipt.go
- manager_stop_terminal_event.go
- manager_transcript_marker.go
- manager_transition.go
- manager_transition_attention.go
- manager_types.go
- manager_workspace.go
- manager_workspace_access.go
- manager_worktree_fork.go
- notifier.go
- path_containment.go
- prompt_activity.go
- prompt_activity_conversion.go
- prompt_activity_events.go
- prompt_activity_health.go
- prompt_activity_heartbeat.go
- prompt_activity_timeout.go
- prompt_attachments.go
- prompt_cancel.go
- prompt_chunk_coalescer.go
- prompt_overlay.go
- prompt_provider.go
- provider_runtime.go
- provider_runtime_adapter.go
- provider_runtime_config.go
- provider_runtime_helpers.go
- provider_runtime_native_cli.go
- provider_runtime_path.go
- provider_runtime_pi.go
- provider_runtime_secrets.go
- query.go
- query_context_usage.go
- query_health.go
- query_metadata.go
- query_recorder.go
- query_store.go
- query_workspace.go
- recovery_catalog.go
- repair.go
- repair_actions.go
- repair_event_payload.go
- repair_persistence.go
- resume_context.go
- resume_repair.go
- resume_replay.go
- runtime.go
- runtime_overrides.go
- send_outcome.go
- session.go
- session_accepted_route.go
- session_agent_definition.go
- session_attach.go
- session_attention.go
- session_attention_publish.go
- session_attention_summary.go
- session_busy_input.go
- session_catalog_stream.go
- session_clone.go
- session_creation.go
- session_derivation_state.go
- session_identity.go
- session_info.go
- session_lifecycle_state.go
- session_meta.go
- session_notify.go
- session_paths.go
- session_pending.go
- session_pending_events.go
- session_pending_resolution.go
- session_presence.go
- session_process_state.go
- session_prompt_state.go
- session_rename.go
- session_runtime_activity.go
- session_runtime_state.go
- session_skill_invocations.go
- session_stop_state.go
- session_stream_broadcast.go
- session_title.go
- session_wait.go
- session_wait_registry.go
- soul.go
- soul_locks.go
- soul_persistence.go
- soul_start.go
- spawn.go
- spawn_governance.go
- spawn_hooks.go
- spawn_internal_role.go
- spawn_permissions.go
- spawn_provider.go
- spawn_wake.go
- startup_manifest.go
- stop_cause.go
- stop_cleanup_diagnostic.go
- stop_events.go
- stop_ladder.go
- stop_operation.go
- stop_operation_start.go
- stop_reason.go
- stop_recovered.go
- stop_recovered_boot.go
- stop_recovered_events.go
- stop_recovered_finalization.go
- stop_recovered_process.go
- stop_recovered_receipt.go
- stop_verification.go
- subprocess_health.go
- supervised_work_recovery.go
- synthetic_prompt.go
- synthetic_prompt_queue.go
- tool_gateway.go
- transcript.go
- transcript_epoch.go
- transcript_navigation.go
- transient_model.go
- turn_stop.go
- turn_stop_events.go
- work_signal_progress.go
- work_signal_registry.go
- work_signals.go
- work_supervision.go
- work_supervision_events.go
- worktree_binding.go
- worktree_delivery.go