@ponythewhite/base-context 1.0.14 → 1.0.15

package/dist/core/session-manager.d.ts

@@ -34,6 +34,12 @@ export interface SessionHeader {
     rlmDepth?: number;
     git?: GitContext;
 }
+/** Bounded source entries for a compiled view, with exact chronological suffix membership. */
+export interface CompactionSourceEntries {
+    entries: SessionEntry[];
+    suffixAnchors: ReadonlySet<string>;
+    leafKind?: string;
+}
 /** One captured branch for summary input, physical requests, and the queued compaction commit. */
 export interface BoundCompactionSink extends BoundSessionRequestSink {
     /** Original ownership and compaction input, including this sink's own acknowledged checkpoint. */
@@ -41,6 +47,7 @@ export interface BoundCompactionSink extends BoundSessionRequestSink {
     /** Internal explicit-copy read on this same held source, never a provider-view capability. */
     [readCopiedEpochSource]<T>(read: (history: SessionHistoryReadScope) => Promise<T>): Promise<T>;
     readBranch(): Promise<SessionEntry[]>;
+    readCompactionEntries(entryIds: readonly string[]): Promise<CompactionSourceEntries>;
     [appendContextEpoch](checkpoint: ContextEpochCheckpoint, tokensBefore: number | null, summary?: ContextEpochSummary, requestOutputSource?: object): Promise<string>;
     appendCompaction<T = unknown>(summary: string, firstKeptEntryId: string, tokensBefore: number | null, details?: T, fromHook?: boolean, customInstructions?: string, usage?: Usage, requestOutputSource?: object): Promise<string>;
 }
@@ -441,6 +448,7 @@ export declare class SessionManager {
     readEntryRetention(id: string): Promise<JournalFrameRetention | undefined>;
     readLabel(id: string, maxSourceBytes?: number): Promise<string | undefined>;
     readEntries(limits?: SessionHistoryReadLimits): Promise<SessionEntry[]>;
+    private _readCompactionEntriesAt;
     private _readBranchesAt;
     private _residentParentPath;
     readBranches(leafIds: readonly (string | null)[], limits?: SessionHistoryReadLimits): Promise<{