@vybestack/llxprt-code-core 0.11.0 → 0.12.0-nightly.260910.2aac6841e

package/dist/src/recording/RecordingIntegration.js

@@ -13,6 +13,52 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/**
+ * Two independent 32-bit multiplicative hashes of `value`, concatenated in
+ * base-36 to give a 64-bit comparison key.
+ *
+ * The low lane is FNV-1a (offset basis 0x811c9dc5, prime 0x01000193). The high
+ * lane uses the same xor-then-multiply shape with a different seed and a
+ * different odd multiplier (the murmur3 finalizer constant 0x85ebca6b) so the
+ * two lanes do not move together.
+ *
+ * This shrinks a content payload to a comparison key and is never a security
+ * boundary. A collision would additionally have to land on the same chronology
+ * `seq` before it could suppress anything.
+ */
+function fingerprint(value) {
+    let low = 0x811c9dc5;
+    let high = 0x01000193;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        low = Math.imul(low ^ code, 0x01000193);
+        high = Math.imul(high ^ code, 0x85ebca6b);
+    }
+    return `${(low >>> 0).toString(36)}.${(high >>> 0).toString(36)}`;
+}
+/**
+ * The identity of a content record for duplicate detection: its chronology
+ * `seq` paired with a fingerprint of the exact payload.
+ *
+ * Returns `null` when the content carries no chronology marker. Such content
+ * has no identity, so it is always recorded rather than risk suppressing
+ * something that was never written.
+ *
+ * `seq` alone is NOT sufficient. It is unique only within one `HistoryService`
+ * instance, `ChronologyStamper.inherit` deliberately gives a replacement entry
+ * the replaced entry's marker, and `merge` can import entries from a foreign
+ * chronology. Pairing it with the payload fingerprint means suppression can
+ * only ever discard content byte-identical to a record already written.
+ *
+ * @issue #3132
+ */
+function contentIdentity(content) {
+    const seq = content.metadata?.chronology?.seq;
+    if (typeof seq !== 'number') {
+        return null;
+    }
+    return `${seq}:${fingerprint(JSON.stringify(content))}`;
+}
 /**
  * Bridges HistoryService events to SessionRecordingService.
  *
@@ -24,9 +70,131 @@ export class RecordingIntegration {
     recording;
     historySubscription = null;
     compressionInProgress = false;
+    /**
+     * Identities of the content records this recording already contains.
+     *
+     * Several production paths rebuild history wholesale by calling
+     * `HistoryService.clear()` and then re-`add()`ing the retained entries. Each
+     * re-`add()` emits `contentAdded`, so without this set the rebuild appends a
+     * byte-identical copy of every retained entry to the session file, and
+     * `ReplayEngine` replays those copies into doubled history on resume.
+     *
+     * Scoped to the one `SessionRecordingService` this integration wraps, so it
+     * is never reset while that file is open. Bounded by the number of distinct
+     * content records written to the session.
+     *
+     * @issue #3132
+     */
+    recordedIdentities = new Set();
     disposed = false;
-    constructor(recording) {
+    persistence;
+    pendingPersistence = new Map();
+    persistenceFailures = new Map();
+    nextPersistenceGeneration = 0;
+    disposePromise;
+    constructor(recording, persistence) {
         this.recording = recording;
+        this.persistence = persistence;
+    }
+    persist(historyService) {
+        if (this.persistence === undefined)
+            return;
+        const generation = ++this.nextPersistenceGeneration;
+        let save;
+        try {
+            save = this.persistence.save([...historyService.getAll()]);
+        }
+        catch (error) {
+            this.persistenceFailures.set(generation, error);
+            return;
+        }
+        const settled = save.then(() => {
+            this.pendingPersistence.delete(generation);
+        }, (error) => {
+            this.persistenceFailures.set(generation, error);
+            this.pendingPersistence.delete(generation);
+        });
+        this.pendingPersistence.set(generation, settled);
+    }
+    async awaitPersistenceThrough(generation) {
+        const pending = [...this.pendingPersistence.entries()]
+            .filter(([pendingGeneration]) => pendingGeneration <= generation)
+            .map(([, operation]) => operation);
+        await Promise.all(pending);
+    }
+    takePersistenceFailuresThrough(generation) {
+        const failures = [];
+        for (const [failedGeneration, error] of [
+            ...this.persistenceFailures.entries(),
+        ].sort(([left], [right]) => left - right)) {
+            if (failedGeneration > generation)
+                continue;
+            this.persistenceFailures.delete(failedGeneration);
+            const detail = error instanceof Error ? error.message : String(error);
+            failures.push(new Error(`Session persistence generation ${failedGeneration} failed: ${detail}`, { cause: error }));
+        }
+        return failures;
+    }
+    throwFailures(failures, message) {
+        if (failures.length === 1)
+            throw failures[0];
+        if (failures.length > 1)
+            throw new AggregateError(failures, message);
+    }
+    async prepareBatch(publication) {
+        await this.recording.flush();
+        if (!this.recording.isActive()) {
+            throw new Error('Cannot publish history batch: recording is not active');
+        }
+        let persistence;
+        let recording;
+        try {
+            persistence = await this.persistence?.prepareSave(publication.nextHistory);
+            if (!this.compressionInProgress) {
+                recording = this.recording.prepareContentBatch(publication.contents);
+            }
+        }
+        catch (error) {
+            if (persistence === undefined)
+                throw error;
+            try {
+                await persistence.rollback();
+            }
+            catch (rollbackError) {
+                throw new AggregateError([error, rollbackError], 'History batch preparation and persistence rollback failed');
+            }
+            throw error;
+        }
+        return {
+            publish: async () => {
+                recording?.publish();
+                await persistence?.publish();
+            },
+            rollback: async () => {
+                const failures = [];
+                try {
+                    recording?.rollback();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+                try {
+                    await persistence?.rollback();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+                if (failures.length === 1)
+                    throw failures[0];
+                if (failures.length > 1) {
+                    throw new AggregateError(failures, 'History batch rollback failed');
+                }
+            },
+            finalize: async () => {
+                await persistence?.finalize();
+                recording?.finalize();
+            },
+        };
     }
     /**
      * @plan PLAN-20260211-SESSIONRECORDING.P14
@@ -38,11 +206,25 @@ export class RecordingIntegration {
         if (this.disposed) {
             return;
         }
+        // Whatever is already in history at subscribe time is content this
+        // recording either already contains (resume and fork both attach to a
+        // seeded file) or has deliberately excluded, since content added before
+        // subscribing is never recorded. Either way a later rebuild must not
+        // append it (issue #3132).
+        this.rememberExistingHistory(historyService);
         const onContentAdded = (content) => {
             if (this.disposed || this.compressionInProgress) {
                 return;
             }
+            const identity = contentIdentity(content);
+            if (identity !== null && this.recordedIdentities.has(identity)) {
+                return;
+            }
             this.recording.recordContent(content);
+            if (identity !== null) {
+                this.recordedIdentities.add(identity);
+            }
+            this.persist(historyService);
         };
         const onCompressionStarted = () => {
             if (this.disposed) {
@@ -62,18 +244,35 @@ export class RecordingIntegration {
             }
             this.compressionInProgress = false;
             this.recording.recordCompressed(summary, itemsCompressed);
+            this.persist(historyService);
         };
+        const unregisterBatchParticipant = historyService.registerBatchParticipant((publication) => this.prepareBatch(publication));
         historyService.on('contentAdded', onContentAdded);
         historyService.on('compressionStarted', onCompressionStarted);
         historyService.on('compressionLockReleased', onCompressionLockReleased);
         historyService.on('compressionEnded', onCompressionEnded);
         this.historySubscription = () => {
+            unregisterBatchParticipant();
             historyService.off('contentAdded', onContentAdded);
             historyService.off('compressionStarted', onCompressionStarted);
             historyService.off('compressionLockReleased', onCompressionLockReleased);
             historyService.off('compressionEnded', onCompressionEnded);
         };
     }
+    /**
+     * Seed {@link recordedIdentities} from the history that is already present
+     * on the service being subscribed to.
+     *
+     * @issue #3132
+     */
+    rememberExistingHistory(historyService) {
+        for (const content of historyService.getAll()) {
+            const identity = contentIdentity(content);
+            if (identity !== null) {
+                this.recordedIdentities.add(identity);
+            }
+        }
+    }
     /**
      * @plan PLAN-20260211-SESSIONRECORDING.P14
      * @requirement REQ-INT-001, REQ-INT-006
@@ -126,10 +325,16 @@ export class RecordingIntegration {
      * @pseudocode recording-integration.md lines 92-94
      */
     async flushAtTurnBoundary() {
-        if (this.disposed) {
+        if (this.disposed)
             return;
-        }
-        await this.recording.flush();
+        const generation = this.nextPersistenceGeneration;
+        const outcomes = await Promise.allSettled([
+            this.recording.flush(),
+            this.awaitPersistenceThrough(generation),
+        ]);
+        const failures = outcomes.flatMap((outcome) => outcome.status === 'rejected' ? [outcome.reason] : []);
+        failures.push(...this.takePersistenceFailuresThrough(generation));
+        this.throwFailures(failures, 'Recording and persistence flush failed');
     }
     getRecordingService() {
         return this.recording;
@@ -140,11 +345,23 @@ export class RecordingIntegration {
      * @pseudocode recording-integration.md lines 96-98
      */
     dispose() {
-        if (this.disposed) {
-            return;
-        }
+        if (this.disposePromise !== undefined)
+            return this.disposePromise;
         this.disposed = true;
         this.unsubscribeFromHistory();
+        const generation = this.nextPersistenceGeneration;
+        const operation = (async () => {
+            try {
+                await this.awaitPersistenceThrough(generation);
+                const failures = this.takePersistenceFailuresThrough(generation);
+                this.throwFailures(failures, 'Session persistence shutdown failed');
+            }
+            finally {
+                this.disposePromise = Promise.resolve();
+            }
+        })();
+        this.disposePromise = operation;
+        return operation;
     }
     /**
      * @plan PLAN-20260211-SESSIONRECORDING.P14

package/dist/src/recording/RecordingIntegration.js.map

@@ -1 +1 @@
-{"version":3,"file":"RecordingIntegration.js","sourceRoot":"","sources":["../../../src/recording/RecordingIntegration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RecordingIntegration.js","sourceRoot":"","sources":["../../../src/recording/RecordingIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH;;;;;;;;;;;;GAYG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,eAAe,CAAC,OAAiB;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,CAA0B;IAC5C,mBAAmB,GAAwB,IAAI,CAAC;IAChD,qBAAqB,GAAG,KAAK,CAAC;IACtC;;;;;;;;;;;;;;OAcG;IACc,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAChD,QAAQ,GAAG,KAAK,CAAC;IACR,WAAW,CAAwC;IACnD,kBAAkB,GAAG,IAAI,GAAG,EAAyB,CAAC;IACtD,mBAAmB,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1D,yBAAyB,GAAG,CAAC,CAAC;IAC9B,cAAc,CAA4B;IAElD,YACE,SAAkC,EAClC,WAAuC;QAEvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEO,OAAO,CAAC,cAA8B;QAC5C,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO;QAC3C,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,yBAAyB,CAAC;QACpD,IAAI,IAAmB,CAAC;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,GAAG,EAAE;YACH,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC,CACF,CAAC;QACF,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,UAAkB;QACtD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;aACnD,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC,iBAAiB,IAAI,UAAU,CAAC;aAChE,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,8BAA8B,CAAC,UAAkB;QACvD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI;YACtC,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE;SACtC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,gBAAgB,GAAG,UAAU;gBAAE,SAAS;YAC5C,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,QAAQ,CAAC,IAAI,CACX,IAAI,KAAK,CACP,kCAAkC,gBAAgB,YAAY,MAAM,EAAE,EACtE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CACF,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CAAC,QAA4B,EAAE,OAAe;QACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,WAAoC;QAEpC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,WAAgD,CAAC;QACrD,IAAI,SAA2C,CAAC;QAChD,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,WAAW,CAC/C,WAAW,CAAC,WAAW,CACxB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,WAAW,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,aAAsB,EAAE,CAAC;gBAChC,MAAM,IAAI,cAAc,CACtB,CAAC,KAAK,EAAE,aAAa,CAAC,EACtB,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,SAAS,EAAE,OAAO,EAAE,CAAC;gBACrB,MAAM,WAAW,EAAE,OAAO,EAAE,CAAC;YAC/B,CAAC;YACD,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,MAAM,QAAQ,GAAc,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,SAAS,EAAE,QAAQ,EAAE,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,WAAW,EAAE,QAAQ,EAAE,CAAC;gBAChC,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC7C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YACD,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,MAAM,WAAW,EAAE,QAAQ,EAAE,CAAC;gBAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;YACxB,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,cAA8B;QAC/C,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,mEAAmE;QACnE,sEAAsE;QACtE,wEAAwE;QACxE,qEAAqE;QACrE,2BAA2B;QAC3B,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAE7C,MAAM,cAAc,GAAG,CAAC,OAAiB,EAAE,EAAE;YAC3C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/D,OAAO;YACT,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,oBAAoB,GAAG,GAAG,EAAE;YAChC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACpC,CAAC,CAAC;QAEF,MAAM,yBAAyB,GAAG,GAAG,EAAE;YACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;QACrC,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,CAAC,OAAiB,EAAE,eAAuB,EAAE,EAAE;YACxE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,0BAA0B,GAAG,cAAc,CAAC,wBAAwB,CACxE,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAChD,CAAC;QACF,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAClD,cAAc,CAAC,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;QAC9D,cAAc,CAAC,EAAE,CAAC,yBAAyB,EAAE,yBAAyB,CAAC,CAAC;QACxE,cAAc,CAAC,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAE1D,IAAI,CAAC,mBAAmB,GAAG,GAAG,EAAE;YAC9B,0BAA0B,EAAE,CAAC;YAC7B,cAAc,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YACnD,cAAc,CAAC,GAAG,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;YAC/D,cAAc,CAAC,GAAG,CAAC,yBAAyB,EAAE,yBAAyB,CAAC,CAAC;YACzE,cAAc,CAAC,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,uBAAuB,CAAC,cAA8B;QAC5D,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,QAAgB,EAAE,KAAa;QAClD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,wBAAwB,CAAC,IAAc;QACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAChB,QAAsC,EACtC,OAAe;QAEf,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,yBAAyB,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;YACtB,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC;SACzC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5C,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CACtD,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAC;IACzE,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,yBAAyB,CAAC;QAClD,MAAM,SAAS,GAAG,CAAC,KAAK,IAAmB,EAAE;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;gBACjE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;YACtE,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,wBAAwB,CAAC,iBAAiC;QACxD,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/src/recording/ReplayEngine.d.ts

@@ -13,14 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type ReplayResult, type SessionStartPayload, type CheckpointMetadataView, type SessionRecordLine } from './types.js';
-/**
- * Fold checkpoint lifecycle events into a stable view ordered by sequence.
- * Each checkpoint is tracked by stable `checkpointId`. Created events set
- * the name, watermark, and createdAt; renamed events update the name;
- * deleted events set `deleted: true`.
- */
-export declare function foldCheckpointMetadata(events: readonly SessionRecordLine[]): CheckpointMetadataView[];
+export { foldCheckpointMetadata } from './replayCheckpointMetadata.js';
+import { type ReplayResult, type SessionStartPayload } from './types.js';
+import type { LocalMediaStore } from '../storage/local-media-store.js';
 /**
  * @plan PLAN-20260211-SESSIONRECORDING.P08
  * @requirement REQ-RPL-002, REQ-RPL-003, REQ-RPL-005, REQ-RPL-006, REQ-RPL-007, REQ-RPL-008
@@ -30,13 +25,16 @@ export declare function foldCheckpointMetadata(events: readonly SessionRecordLin
  * @param expectedProjectHash - Must match the file's projectHash
  * @returns ReplayResult discriminated union — ok: true with data, or ok: false with error
  */
-export declare function replaySession(filePath: string, expectedProjectHash: string): Promise<ReplayResult>;
+export interface ReplaySessionOptions {
+    readonly mediaStore?: LocalMediaStore;
+}
+export declare function replaySession(filePath: string, expectedProjectHash: string, options?: ReplaySessionOptions): Promise<ReplayResult>;
 /**
  * Replay a session through an inclusive maximum sequence number.
  * Processing stops at the first valid event whose `seq` exceeds maxSequence.
  * Used for checkpoint fork creation: replay through the checkpoint watermark.
  */
-export declare function replaySessionThroughSequence(filePath: string, expectedProjectHash: string, maxSequence: number): Promise<ReplayResult>;
+export declare function replaySessionThroughSequence(filePath: string, expectedProjectHash: string, maxSequence: number, options?: ReplaySessionOptions): Promise<ReplayResult>;
 /**
  * Read only the session header (first line) from a JSONL file.
  * Useful for listing sessions without replaying the entire file.