Class SessionHistoryBuffer

In-memory buffer for session history to minimize file I/O during conversation

Index

Constructors

Methods

addPlanId addTurn flush updateTurnWithTrace fromDisk

Constructors

constructor

new SessionHistoryBuffer(
    sessionDir: string,
    sessionId: string,
    agentId: string,
    created: string,
    mockMode?: "Mock" | "Live Test",
): SessionHistoryBuffer
Parameters
- sessionDir: string
- sessionId: string
- agentId: string
- created: string
- OptionalmockMode: "Mock" | "Live Test"
Returns SessionHistoryBuffer
- Defined in utils.ts:406

Methods

addPlanId

addPlanId(planId: string): void
Add a planId to the buffer (no file I/O)
Parameters
- planId: string
Returns void
- Defined in utils.ts:476

addTurn

addTurn(entry: TurnIndexEntry): void
Add a turn to the buffer (no file I/O)
Parameters
- entry: TurnIndexEntry
Returns void
- Defined in utils.ts:469

flush

flush(endTime?: string): Promise<void>
Flush all buffered data to disk Called at session start (to create initial files), after each turn (to keep real-time), and at session end (to finalize)
Parameters
- OptionalendTime: string
Returns Promise<void>
- Defined in utils.ts:495

updateTurnWithTrace

updateTurnWithTrace(turnNumber: number, planId: string): void
Update an existing turn with trace info (no file I/O)
Parameters
- turnNumber: number
- planId: string
Returns void
- Defined in utils.ts:483

`Static`fromDisk

fromDisk(
    sessionDir: string,
    sessionId: string,
    agentId: string,
): Promise<{ buffer: SessionHistoryBuffer; turnCount: number }>
Create a SessionHistoryBuffer from existing session data on disk Used when resuming an existing session
Parameters
- sessionDir: string
- sessionId: string
- agentId: string
Returns Promise<{ buffer: SessionHistoryBuffer; turnCount: number }>
- Defined in utils.ts:418