Documentation
¶
Index ¶
- Variables
- func MigrationStream() store.MigrationStream
- func NewEventMetadataOpener(sessionsDir string) store.SessionEventMetadataOpener
- type ReadOnlyOpenOption
- type ReadOnlyPool
- func (p *ReadOnlyPool) Close(ctx context.Context) error
- func (p *ReadOnlyPool) CloseExpired(ctx context.Context) error
- func (p *ReadOnlyPool) Open(ctx context.Context, sessionID string, path string) (store.EventReadCloser, error)
- func (p *ReadOnlyPool) Quiesce(ctx context.Context, sessionID string, path string) (func(), error)
- type ReadOnlyPoolConfig
- type ReadOnlyPoolOpener
- type ReadOnlySessionDB
- func (s *ReadOnlySessionDB) Close(ctx context.Context) error
- func (s *ReadOnlySessionDB) History(ctx context.Context, query store.EventQuery) ([]store.TurnHistory, error)
- func (s *ReadOnlySessionDB) MaxEventSequence(ctx context.Context) (int64, error)
- func (s *ReadOnlySessionDB) Query(ctx context.Context, query store.EventQuery) (events []store.SessionEvent, err error)
- func (s *ReadOnlySessionDB) QueryEventMetadata(ctx context.Context, query store.EventQuery) (events []store.EventMetadata, err error)
- func (s *ReadOnlySessionDB) TranscriptChanges(ctx context.Context, query transcript.ChangeQuery) (transcript.ChangePage, error)
- func (s *ReadOnlySessionDB) TranscriptPage(ctx context.Context, query transcript.PageQuery) (transcript.Page, error)
- type SessionDB
- func (s *SessionDB) AppendEventIfAbsent(ctx context.Context, event store.SessionEvent) (store.SessionEvent, error)
- func (s *SessionDB) ArchiveEvents(ctx context.Context, request store.EventArchiveRequest) (store.EventArchiveResult, error)
- func (s *SessionDB) Clear(ctx context.Context) error
- func (s *SessionDB) Close(ctx context.Context) error
- func (s *SessionDB) History(ctx context.Context, query store.EventQuery) ([]store.TurnHistory, error)
- func (s *SessionDB) Path() string
- func (s *SessionDB) Query(ctx context.Context, query store.EventQuery) ([]store.SessionEvent, error)
- func (s *SessionDB) QueryHookRuns(ctx context.Context, query store.HookRunQuery) ([]hookspkg.HookRunRecord, error)
- func (s *SessionDB) Record(ctx context.Context, event store.SessionEvent) error
- func (s *SessionDB) RecordHookRun(ctx context.Context, record hookspkg.HookRunRecord) error
- func (s *SessionDB) RecordPersisted(ctx context.Context, event store.SessionEvent) (store.SessionEvent, error)
- func (s *SessionDB) RecordPersistedBatch(ctx context.Context, events []store.SessionEvent) ([]store.SessionEvent, error)
- func (s *SessionDB) RecordTokenUsage(ctx context.Context, usage store.TokenUsage) error
- func (s *SessionDB) SessionID() string
- func (s *SessionDB) TranscriptChanges(ctx context.Context, query transcript.ChangeQuery) (transcript.ChangePage, error)
- func (s *SessionDB) TranscriptPage(ctx context.Context, query transcript.PageQuery) (transcript.Page, error)
Constants ¶
This section is empty.
Variables ¶
var ErrEventIdentityCollision = errors.New("store: session event identity collision")
ErrEventIdentityCollision reports a deterministic event ID reused with different content.
var ErrReadOnlyPoolQuiescing = errors.New("store: read-only pool session is quiescing")
ErrReadOnlyPoolQuiescing reports that destructive session work has blocked new read-only leases while existing leases drain.
Functions ¶
func MigrationStream ¶
func MigrationStream() store.MigrationStream
MigrationStream returns the embedded session database migration stream.
func NewEventMetadataOpener ¶
func NewEventMetadataOpener(sessionsDir string) store.SessionEventMetadataOpener
NewEventMetadataOpener binds read-only session metadata access to one sessions directory.
Types ¶
type ReadOnlyOpenOption ¶
type ReadOnlyOpenOption func(*readOnlyOpenConfig)
ReadOnlyOpenOption customizes read-only session database opening.
func WithReadOnlyOpenRetry ¶
func WithReadOnlyOpenRetry( maxAttempts int, minRetryDelay time.Duration, maxRetryDelay time.Duration, ) ReadOnlyOpenOption
WithReadOnlyOpenRetry configures retry behavior for read-only session database opens.
type ReadOnlyPool ¶
type ReadOnlyPool struct {
// contains filtered or unexported fields
}
ReadOnlyPool reuses short-lived read-only session database handles for hot inactive sessions.
func NewReadOnlyPool ¶
func NewReadOnlyPool(config ReadOnlyPoolConfig) *ReadOnlyPool
NewReadOnlyPool constructs a read-only session recorder pool.
func (*ReadOnlyPool) Close ¶
func (p *ReadOnlyPool) Close(ctx context.Context) error
Close closes every pooled handle and rejects future opens.
func (*ReadOnlyPool) CloseExpired ¶
func (p *ReadOnlyPool) CloseExpired(ctx context.Context) error
CloseExpired closes idle handles whose TTL has elapsed.
func (*ReadOnlyPool) Open ¶
func (p *ReadOnlyPool) Open(ctx context.Context, sessionID string, path string) (store.EventReadCloser, error)
Open returns a lease for a session-keyed read-only recorder.
func (*ReadOnlyPool) Quiesce ¶
func (p *ReadOnlyPool) Quiesce( ctx context.Context, sessionID string, path string, ) (func(), error)
Quiesce prevents new leases for one session, waits for active leases to return, and closes the pooled database handle. The returned function must be called after the caller's destructive operation finishes so failed operations can resume read access.
type ReadOnlyPoolConfig ¶
type ReadOnlyPoolConfig struct {
TTL time.Duration
Now func() time.Time
Open ReadOnlyPoolOpener
}
ReadOnlyPoolConfig customizes read-only recorder pooling.
type ReadOnlyPoolOpener ¶
type ReadOnlyPoolOpener func(ctx context.Context, sessionID string, path string) (store.EventReadCloser, error)
ReadOnlyPoolOpener opens the reader stored behind a pooled read-only lease.
type ReadOnlySessionDB ¶
type ReadOnlySessionDB struct {
// contains filtered or unexported fields
}
ReadOnlySessionDB opens an existing per-session events database for queries without creating, migrating, checkpointing, or otherwise mutating it.
func OpenSessionDBReadOnly ¶
func OpenSessionDBReadOnly( ctx context.Context, sessionID string, path string, options ...ReadOnlyOpenOption, ) (*ReadOnlySessionDB, error)
OpenSessionDBReadOnly opens an existing per-session events database in SQLite read-only mode. It intentionally fails for missing paths instead of creating a fresh database during stale transcript/event reads.
func (*ReadOnlySessionDB) Close ¶
func (s *ReadOnlySessionDB) Close(ctx context.Context) error
Close closes the read-only database handle without checkpointing.
func (*ReadOnlySessionDB) History ¶
func (s *ReadOnlySessionDB) History(ctx context.Context, query store.EventQuery) ([]store.TurnHistory, error)
History returns ordered session events grouped by turn id.
func (*ReadOnlySessionDB) MaxEventSequence ¶
func (s *ReadOnlySessionDB) MaxEventSequence(ctx context.Context) (int64, error)
MaxEventSequence returns the current highest per-session event sequence.
func (*ReadOnlySessionDB) Query ¶
func (s *ReadOnlySessionDB) Query( ctx context.Context, query store.EventQuery, ) (events []store.SessionEvent, err error)
Query returns events filtered by the supplied options.
func (*ReadOnlySessionDB) QueryEventMetadata ¶
func (s *ReadOnlySessionDB) QueryEventMetadata( ctx context.Context, query store.EventQuery, ) (events []store.EventMetadata, err error)
QueryEventMetadata returns ordered session event metadata without reading content.
func (*ReadOnlySessionDB) TranscriptChanges ¶
func (s *ReadOnlySessionDB) TranscriptChanges( ctx context.Context, query transcript.ChangeQuery, ) (transcript.ChangePage, error)
TranscriptChanges returns entries changed by events after the supplied cursor.
func (*ReadOnlySessionDB) TranscriptPage ¶
func (s *ReadOnlySessionDB) TranscriptPage( ctx context.Context, query transcript.PageQuery, ) (transcript.Page, error)
TranscriptPage returns one bounded materialized transcript window.
type SessionDB ¶
type SessionDB struct {
// contains filtered or unexported fields
}
SessionDB owns a per-session SQLite database and its dedicated writer loop.
func OpenSessionDB ¶
OpenSessionDB opens or creates the per-session events database at path.
func (*SessionDB) AppendEventIfAbsent ¶
func (s *SessionDB) AppendEventIfAbsent( ctx context.Context, event store.SessionEvent, ) (store.SessionEvent, error)
AppendEventIfAbsent inserts one deterministic event or returns its byte-identical existing row.
func (*SessionDB) ArchiveEvents ¶
func (s *SessionDB) ArchiveEvents( ctx context.Context, request store.EventArchiveRequest, ) (store.EventArchiveResult, error)
ArchiveEvents marks one fixed event range as excluded from replay.
func (*SessionDB) Clear ¶
Clear removes all persisted per-session runtime records while preserving the migrated database schema and the open writer. It is used by session reset flows before the recorder is exposed to any live session goroutine.
func (*SessionDB) History ¶
func (s *SessionDB) History(ctx context.Context, query store.EventQuery) ([]store.TurnHistory, error)
History returns ordered session events grouped by turn id.
func (*SessionDB) Query ¶
func (s *SessionDB) Query(ctx context.Context, query store.EventQuery) ([]store.SessionEvent, error)
Query returns events filtered by the supplied options.
func (*SessionDB) QueryHookRuns ¶
func (s *SessionDB) QueryHookRuns(ctx context.Context, query store.HookRunQuery) ([]hookspkg.HookRunRecord, error)
QueryHookRuns returns persisted hook execution records filtered by the supplied options.
func (*SessionDB) RecordHookRun ¶
RecordHookRun stores one hook execution audit record in the per-session store.
func (*SessionDB) RecordPersisted ¶
func (s *SessionDB) RecordPersisted(ctx context.Context, event store.SessionEvent) (store.SessionEvent, error)
RecordPersisted appends a session event and returns the stored row with sequence metadata.
func (*SessionDB) RecordPersistedBatch ¶
func (s *SessionDB) RecordPersistedBatch( ctx context.Context, events []store.SessionEvent, ) ([]store.SessionEvent, error)
RecordPersistedBatch appends session events in one writer-owned transaction.
func (*SessionDB) RecordTokenUsage ¶
RecordTokenUsage stores or merges per-turn usage data for the session.
func (*SessionDB) TranscriptChanges ¶
func (s *SessionDB) TranscriptChanges( ctx context.Context, query transcript.ChangeQuery, ) (transcript.ChangePage, error)
TranscriptChanges returns entries changed by events after the supplied cursor.
func (*SessionDB) TranscriptPage ¶
func (s *SessionDB) TranscriptPage( ctx context.Context, query transcript.PageQuery, ) (transcript.Page, error)
TranscriptPage returns one bounded materialized transcript window.
Source Files
¶
- cleanup.go
- event_coalescer.go
- event_metadata_opener.go
- event_query.go
- history.go
- migration_stream.go
- read_only.go
- read_only_pool.go
- session_clear.go
- session_db.go
- session_event_archive.go
- session_event_query.go
- session_event_redaction.go
- session_event_write.go
- session_hook_runs.go
- session_lifecycle.go
- session_query_scan.go
- session_sqlc_mapping.go
- session_sqlite.go
- session_token_usage.go
- session_write_kind.go
- session_writer.go
- transcript_projection_init.go
- transcript_projection_storage.go
- transcript_query.go