Documentation
¶
Overview ¶
Package session owns Peen's durable transport-neutral session transcript.
Index ¶
- Constants
- Variables
- type CompactionInput
- type EventInput
- type FinalizeTurnInput
- type History
- type Lease
- type ListMessagesOptions
- type MessageInput
- type MessagePage
- type OpenSessionOptions
- type OpenSessionResult
- type Options
- type PageOrder
- type StartTurnInput
- type Store
- func (s *Store) AcquireTurn(ctx context.Context, sessionID uuid.UUID, input StartTurnInput) (Lease, error)
- func (s *Store) AppendCheckpoint(ctx context.Context, lease Lease, messages []MessageInput, events []EventInput) error
- func (s *Store) Cancel(ctx context.Context, sessionID uuid.UUID) (bool, error)
- func (s *Store) CompletedHistory(ctx context.Context, sessionID uuid.UUID) (*History, error)
- func (s *Store) CreateCompaction(ctx context.Context, sessionID uuid.UUID, input CompactionInput) (*models.Compaction, error)
- func (s *Store) CreateOrResume(ctx context.Context, requestedSessionID *uuid.UUID, options OpenSessionOptions) (*OpenSessionResult, error)
- func (s *Store) FinalizeTurn(ctx context.Context, lease Lease, input FinalizeTurnInput) error
- func (s *Store) Get(ctx context.Context, sessionID uuid.UUID) (*models.Session, error)
- func (s *Store) IsActive(sessionID uuid.UUID) bool
- func (s *Store) LatestCompaction(ctx context.Context, sessionID uuid.UUID) (*models.Compaction, error)
- func (s *Store) ListMessages(ctx context.Context, sessionID uuid.UUID, options ListMessagesOptions) (*MessagePage, error)
- func (s *Store) RecoverInterrupted(ctx context.Context) (int, error)
- func (s *Store) RegisterCancellation(lease Lease, cancel context.CancelFunc)
- func (s *Store) ReleaseTurn(lease Lease)
- func (s *Store) SaveContextSnapshot(ctx context.Context, snapshot *models.ContextSnapshot) error
- func (s *Store) SavePromptSnapshot(ctx context.Context, snapshot *models.PromptSnapshot) error
Constants ¶
const ( // DefaultPageLimit is the API default for transcript pagination. DefaultPageLimit = 50 // MaximumPageLimit bounds one transcript page at the storage boundary. MaximumPageLimit = 200 )
Variables ¶
var ( // ErrSessionBusy reports a concurrent turn attempt for one session. ErrSessionBusy = commerr.ErrLockHeld // ErrInvalidPage reports invalid transcript pagination arguments. ErrInvalidPage = commerr.ErrValidationFailed )
Functions ¶
This section is empty.
Types ¶
type CompactionInput ¶
type CompactionInput struct {
ID uuid.UUID
FromMessageID uuid.UUID
ToMessageID uuid.UUID
FromSequence int64
ToSequence int64
Summary string
SourceMessageCount int64
InputTokenCount int64
SummaryTokenCount int64
ModelID string
PromptHash string
SupersedesCompactionID *uuid.UUID
}
CompactionInput stores one immutable replacement summary.
type EventInput ¶
type EventInput struct {
ID uuid.UUID
RequestID uuid.UUID
EventType string
PayloadJSON string
ParentToolCallID string
}
EventInput describes one exact internal or protocol event.
type FinalizeTurnInput ¶
type FinalizeTurnInput struct {
State models.TurnState
FailureClassification string
ContextSnapshotHash *string
PromptSnapshotHash *string
Messages []MessageInput
Events []EventInput
}
FinalizeTurnInput describes terminal turn state and durable references.
type History ¶
type History struct {
Compaction *models.Compaction
Messages []*models.Message
}
History is the active compaction followed by its uncovered completed tail.
type ListMessagesOptions ¶
ListMessagesOptions controls a bounded session-local message page.
type MessageInput ¶
type MessageInput struct {
ID uuid.UUID
Workspace string
Role models.MessageRole
Content string
ModelID string
Thinking string
ToolCallsJSON string
ToolCallID string
IsError bool
Incomplete bool
}
MessageInput describes a durable transcript record.
type MessagePage ¶
MessagePage is one complete limit-offset transcript page.
type OpenSessionOptions ¶
OpenSessionOptions supplies immutable session attribution on creation.
type OpenSessionResult ¶
OpenSessionResult is a resolved session and whether this call created it.
type Options ¶
type Options struct {
Clock func() time.Time
NewID func() uuid.UUID
// MaxStoredMessageBytes bounds one message row of any role. An assistant
// or tool message has no caller-facing size limit, so without this a
// single tool result could grow the transcript without bound. Zero takes
// the package default.
MaxStoredMessageBytes int
}
Options supplies deterministic seams for the transport-neutral store.
type StartTurnInput ¶
type StartTurnInput struct {
RequestID uuid.UUID
Workspace string
Messages []MessageInput
Events []EventInput
}
StartTurnInput describes the durable beginning of an agent turn.
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
Store persists sessions and protects each active session turn in-process.
func (*Store) AcquireTurn ¶
func (s *Store) AcquireTurn( ctx context.Context, sessionID uuid.UUID, input StartTurnInput, ) (Lease, error)
AcquireTurn starts one durable turn and records its initial transcript data.
func (*Store) AppendCheckpoint ¶
func (s *Store) AppendCheckpoint( ctx context.Context, lease Lease, messages []MessageInput, events []EventInput, ) error
AppendCheckpoint records visible messages and events without ending a turn.
func (*Store) CompletedHistory ¶
CompletedHistory returns the current summary and the raw completed tail.
func (*Store) CreateCompaction ¶
func (s *Store) CreateCompaction( ctx context.Context, sessionID uuid.UUID, input CompactionInput, ) (*models.Compaction, error)
CreateCompaction stores an immutable completed-history replacement summary.
func (*Store) CreateOrResume ¶
func (s *Store) CreateOrResume( ctx context.Context, requestedSessionID *uuid.UUID, options OpenSessionOptions, ) (*OpenSessionResult, error)
CreateOrResume creates a generated-ID session or returns a requested one.
func (*Store) FinalizeTurn ¶
FinalizeTurn atomically writes terminal transcript data and state.
func (*Store) LatestCompaction ¶
func (s *Store) LatestCompaction( ctx context.Context, sessionID uuid.UUID, ) (*models.Compaction, error)
LatestCompaction returns the current chain head, not a superseded row.
func (*Store) ListMessages ¶
func (s *Store) ListMessages( ctx context.Context, sessionID uuid.UUID, options ListMessagesOptions, ) (*MessagePage, error)
ListMessages returns a stable bounded page of one session's transcript.
func (*Store) RecoverInterrupted ¶
RecoverInterrupted marks active turns and their messages incomplete.
func (*Store) RegisterCancellation ¶
func (s *Store) RegisterCancellation(lease Lease, cancel context.CancelFunc)
RegisterCancellation associates cancellation with one exact active lease.
func (*Store) ReleaseTurn ¶
ReleaseTurn removes a lease only when it is still the registered turn.
func (*Store) SaveContextSnapshot ¶
SaveContextSnapshot stores an immutable resolved harness context.
func (*Store) SavePromptSnapshot ¶
SavePromptSnapshot stores an immutable effective prompt.