import type { AgentMessage } from '@earendil-works/pi-agent-core';
import type { CompactionBoundarySummary } from '../../session/types.js';
import { type TranscriptStoredRow, type XopcTranscriptCompactionEntry } from '../../session/session-context-for-llm.js';
import { type TranscriptEntryRow } from './row-mappers.js';
export declare function appendTranscriptEntry(sessionKey: string, row: TranscriptStoredRow, opts?: {
    sessionId?: string;
    tokenDelta?: number;
}): TranscriptEntryRow;
export declare function appendCompactionBoundary(sessionKey: string, row: Omit<XopcTranscriptCompactionEntry, 'baseSeq'>): TranscriptEntryRow;
export declare function loadTranscriptRowsForSession(sessionKey: string): TranscriptStoredRow[];
export declare function loadTranscriptHistoryRowsForSession(sessionKey: string): TranscriptStoredRow[];
export declare function loadTranscriptRows(sessionId: string): TranscriptStoredRow[];
export declare function loadLlmMessagesForSession(sessionKey: string): AgentMessage[];
export declare function replaceTranscriptRows(sessionKey: string, rows: TranscriptStoredRow[]): void;
export declare function paginateTranscriptMessages(sessionKey: string, options?: {
    offset?: number;
    limit?: number;
    beforeIndex?: number;
    includeContext?: boolean;
    /** Include reset/rollover transcripts for read-only conversation history. */
    includeArchived?: boolean;
}): {
    rows: TranscriptStoredRow[];
    messages: AgentMessage[];
    total: number;
    startSeq: number;
    endSeq: number;
};
export declare function listCompactionBoundaries(sessionKey: string): CompactionBoundarySummary[];
export declare function restoreBeforeCompactionBoundary(sessionKey: string, compactionId: string): void;