@pentoshi/clai 3.8.34 → 3.8.39

package/dist/store/history.d.ts

@@ -11,6 +11,13 @@ export interface PersistedContextUsage {
 }
 export interface HistoryRecord {
     id: string;
+    /** Unique writer generation, compared before the per-writer revision. */
+    writerGeneration?: string | undefined;
+    /**
+     * Monotonic whole-snapshot revision within one writer generation. Unlike
+     * updatedAt, this records capture order rather than I/O completion order.
+     */
+    revision?: number | undefined;
     name?: string | undefined;
     createdAt: string;
     updatedAt: string;
@@ -45,7 +52,12 @@ export interface ToolCallRecord {
     exitCode?: number | undefined;
     output: string;
 }
-/** Keep the newest version of each session id. */
+/**
+ * Compare snapshots by writer generation, then capture revision. Legacy rows
+ * without a generation retain revision/timestamp fallback for compatibility.
+ */
+export declare function compareHistoryFreshness(left: HistoryRecord, right: HistoryRecord): number;
+/** Keep the newest captured version of each session id. */
 export declare function dedupeHistoryById(records: readonly HistoryRecord[]): HistoryRecord[];
 export declare function sortHistoryByUpdatedDesc(records: readonly HistoryRecord[]): HistoryRecord[];
 /**
@@ -66,19 +78,14 @@ export declare function recoverOrphanedHistory(): Promise<{
     recovered: number;
     sources: string[];
 }>;
-export declare function saveSession(messages: ChatMessage[], name?: string | undefined, transcript?: TranscriptItem[] | undefined, contextUsage?: PersistedContextUsage | undefined): Promise<HistoryRecord>;
-export declare function upsertSession(id: string, messages: ChatMessage[], name?: string | undefined, transcript?: TranscriptItem[] | undefined, contextUsage?: PersistedContextUsage | undefined): Promise<HistoryRecord>;
+export declare function saveSession(messages: ChatMessage[], name?: string | undefined, transcript?: TranscriptItem[] | undefined, contextUsage?: PersistedContextUsage | undefined, revision?: number | undefined, writerGeneration?: string | undefined): Promise<HistoryRecord>;
+export declare function upsertSession(id: string, messages: ChatMessage[], name?: string | undefined, transcript?: TranscriptItem[] | undefined, contextUsage?: PersistedContextUsage | undefined, revision?: number | undefined, writerGeneration?: string | undefined): Promise<HistoryRecord>;
 export declare function saveToolCall(sessionId: string, call: ToolCall, result: ToolResult): Promise<ToolCallRecord>;
 export declare function listSessions(limit?: number, options?: {
     recovery?: "blocking" | "background";
 }): Promise<HistoryRecord[]>;
 export declare function getSession(sessionId: string): Promise<HistoryRecord | undefined>;
 export declare function getHistoryPath(): string;
-/**
- * Clear active history after archiving a full snapshot. Never unrecoverably
- * destroys chats — a timestamped copy is written under history-backups/ and
- * the previous active file is moved into history-archive.jsonl.
- */
 export declare function clearAllHistory(): Promise<{
     cleared: boolean;
     detail: string;