@cello-protocol/client 0.0.21 → 0.0.22

package/dist/session-manager.js

@@ -0,0 +1,605 @@
+/**
+ * SessionManager — SESSION-002, MSG-004, SESSION-007
+ *
+ * Extracted from CelloClientImpl. Owns the complete session lifecycle:
+ *   - Session assignment acceptance (receiveSessionAssignment)
+ *   - Outbound message sending (sendMessage, #sendMessageLocked)
+ *   - Content delivery (sendContentFrame, waitForOwnEcho)
+ *   - Inbound message queuing (enqueueReceivedMessage, enqueueSessionSealedEvent)
+ *   - Async blocking receive (receiveSessionMessageAsync, receiveMessageAsync)
+ *   - Session listing (listSessions)
+ *
+ * State owned here (not in facade):
+ *   - #sessions: SessionRecord map
+ *   - #sessionMessageQueues + #anyMessageQueue: inbound message queues
+ *   - #receiveWaiters + #receiveAnyWaiters: async-receive wake resolvers
+ *   - #outboundQueues: per-session send serialization chains
+ *   - #pendingAckResolvers: in-flight ack resolvers
+ *   - #ownEchoResolvers: echo wait resolvers (set by relay reader, resolved here)
+ *   - #ownPendingContent: pre-buffered own sends (keyed by content_hash_hex)
+ *   - #contentHandlerRegistered: content stream protocol guard
+ *   - #onSessionAssignmentHandler: inbound session callback
+ */
+import { createHash } from "node:crypto";
+import { Encoder } from "cbor-x";
+import * as lp from "it-length-prefixed";
+import { computeGenesisPrevRoot, buildSessionEstablishmentTbs, } from "@cello-protocol/protocol-types";
+import { verifyFrostSignature, CONTEXT_SESSION_ESTABLISHMENT } from "@cello-protocol/crypto";
+import { CELLO_CONTENT_PROTOCOL_ID } from "@cello-protocol/transport";
+const CBOR_ENC = new Encoder({ tagUint8Array: false });
+const RELAY_PROTOCOL_ID = "/cello/relay/1.0.0";
+export class SessionManager {
+    #ctx;
+    // ─── Owned state ─────────────────────────────────────────────────────────────
+    // session_id_hex → SessionRecord (SESSION-002)
+    #sessions = new Map();
+    // track whether content handler has been registered on this node
+    #contentHandlerRegistered = false;
+    // Callback for inbound session assignments (participant B role). MCP-002.
+    #onSessionAssignmentHandler;
+    // session_id_hex → Promise<void> chain for outbound serialization
+    #outboundQueues = new Map();
+    // session_id_hex → pending ack resolver (sequence_number → ack data)
+    #pendingAckResolvers = new Map();
+    // session_id_hex → own_echo_resolvers (sequence_number → resolve fn)
+    // Populated from relay stream reader via notifyOwnEcho(); resolved when echo arrives.
+    #ownEchoResolvers = new Map();
+    // session_id_hex → own-send pre-buffered content keyed by content_hash_hex
+    #ownPendingContent = new Map();
+    // session_id_hex → FIFO queue of ReceivedMessage (for receiveMessage)
+    #sessionMessageQueues = new Map();
+    // FIFO arrival order across all sessions: { sessionIdHex, message }
+    #anyMessageQueue = [];
+    // SESSION-007: wake resolvers for receiveSessionMessageAsync (per-session) and receiveMessageAsync (any-session)
+    #receiveWaiters = new Map();
+    #receiveAnyWaiters = new Set();
+    constructor(ctx) {
+        this.#ctx = ctx;
+    }
+    // ─── State accessors (called by RelayStreamManager, SealManager, facade) ─────
+    getSession(sessionIdHex) {
+        return this.#sessions.get(sessionIdHex);
+    }
+    getSessions() {
+        return this.#sessions;
+    }
+    setSession(sessionIdHex, record) {
+        this.#sessions.set(sessionIdHex, record);
+    }
+    deleteSession(sessionIdHex) {
+        this.#sessions.delete(sessionIdHex);
+    }
+    getOutboundQueue(sessionIdHex) {
+        return this.#outboundQueues.get(sessionIdHex);
+    }
+    setOutboundQueue(sessionIdHex, queue) {
+        this.#outboundQueues.set(sessionIdHex, queue);
+    }
+    deleteOutboundQueue(sessionIdHex) {
+        this.#outboundQueues.delete(sessionIdHex);
+    }
+    getPendingAckResolver(sessionIdHex) {
+        return this.#pendingAckResolvers.get(sessionIdHex);
+    }
+    setPendingAckResolver(sessionIdHex, resolve) {
+        this.#pendingAckResolvers.set(sessionIdHex, resolve);
+    }
+    deletePendingAckResolver(sessionIdHex) {
+        this.#pendingAckResolvers.delete(sessionIdHex);
+    }
+    getOwnEchoResolvers(sessionIdHex) {
+        return this.#ownEchoResolvers.get(sessionIdHex);
+    }
+    initOwnEchoResolvers(sessionIdHex) {
+        this.#ownEchoResolvers.set(sessionIdHex, new Map());
+    }
+    deleteOwnEchoResolvers(sessionIdHex) {
+        this.#ownEchoResolvers.delete(sessionIdHex);
+    }
+    getOwnPendingContent(sessionIdHex) {
+        return this.#ownPendingContent.get(sessionIdHex);
+    }
+    initOwnPendingContent(sessionIdHex) {
+        this.#ownPendingContent.set(sessionIdHex, new Map());
+    }
+    deleteOwnPendingContent(sessionIdHex) {
+        this.#ownPendingContent.delete(sessionIdHex);
+    }
+    getSessionMessageQueue(sessionIdHex) {
+        return this.#sessionMessageQueues.get(sessionIdHex);
+    }
+    deleteSessionMessageQueue(sessionIdHex) {
+        this.#sessionMessageQueues.delete(sessionIdHex);
+    }
+    /** Initialize the message queue for a session (called from loadPersistedState). */
+    initSessionMessageQueue(sessionIdHex) {
+        if (!this.#sessionMessageQueues.has(sessionIdHex)) {
+            this.#sessionMessageQueues.set(sessionIdHex, []);
+        }
+    }
+    getAnyMessageQueue() {
+        return this.#anyMessageQueue;
+    }
+    setOnSessionAssignmentHandler(handler) {
+        this.#onSessionAssignmentHandler = handler;
+    }
+    /**
+     * Clean up all per-session state owned by SessionManager.
+     * Called by facade.closeSession — companion to RelayStreamManager.closeSession and SealManager.closeSession.
+     */
+    closeSession(sessionIdHex) {
+        this.#sessions.delete(sessionIdHex);
+        this.#outboundQueues.delete(sessionIdHex);
+        this.#ownEchoResolvers.delete(sessionIdHex);
+        this.#ownPendingContent.delete(sessionIdHex);
+        this.#sessionMessageQueues.delete(sessionIdHex);
+        // Clear pending ack resolver (already unblocked by facade before calling closeSession)
+        this.#pendingAckResolvers.delete(sessionIdHex);
+        // Clear receive waiters for this session
+        this.#receiveWaiters.delete(sessionIdHex);
+    }
+    // ─── Called by RelayStreamManager after relay receives a message ─────────────
+    enqueueReceivedMessage(sessionIdHex, message) {
+        let queue = this.#sessionMessageQueues.get(sessionIdHex);
+        if (!queue) {
+            queue = [];
+            this.#sessionMessageQueues.set(sessionIdHex, queue);
+        }
+        queue.push(message);
+        this.#anyMessageQueue.push({ sessionIdHex, message });
+        this.wakeReceiveWaiters(sessionIdHex);
+    }
+    // ─── SESSION-002 ─────────────────────────────────────────────────────────────
+    /**
+     * Process a SessionAssignment pushed by the directory.
+     * SESSION-002 AC-002, AC-003, AC-004, AC-005, SI-003.
+     *
+     * Crypto refs:
+     *   Ed25519 verification: RFC 8032
+     *   SHA-256: FIPS 180-4
+     */
+    async receiveSessionAssignment(assignment, myPubkey) {
+        const { session_id, session_timestamp } = assignment;
+        const pubA = assignment.participant_a.pubkey;
+        const pubB = assignment.participant_b.pubkey;
+        // SESSION-004 Step 1: Check signature_type (SI-003, AC-003)
+        // M1 'single' frames are hard-refused in M2 — even if the single-key sig verifies.
+        if (assignment.signature_type === "single") {
+            return { ok: false, reason: "unsupported_signature_type" };
+        }
+        // SESSION-004 Step 2: Determine role and verification key (AC-007)
+        const myPubkeyHex = Buffer.from(myPubkey).toString("hex");
+        const pubAHex = Buffer.from(pubA).toString("hex");
+        const isInitiator = myPubkeyHex === pubAHex;
+        let verifyKey;
+        if (isInitiator) {
+            // CRITICAL-1: initiator MUST have a thresholdSigner injected.
+            // Falling back to assignment.signer_pubkey (frame-provided) would be attacker-controlled.
+            const thresholdSigner = this.#ctx.getThresholdSigner();
+            if (!thresholdSigner) {
+                return { ok: false, reason: "frost_signer_not_configured" };
+            }
+            verifyKey = thresholdSigner.getPrimaryPubkey();
+        }
+        else {
+            // Counterparty (B): use signer_pubkey from the frame (A's primary_pubkey).
+            // TypeScript discriminated union guarantees signer_pubkey is present for 'frost' frames.
+            verifyKey = assignment.signer_pubkey;
+        }
+        // SESSION-004 Step 3: Build TBS and verify FROST signature (AC-002, SI-001)
+        // TBS = canonical CBOR([session_id, pubA, pubB, genesis_prev_root, session_timestamp])
+        // buildSessionEstablishmentTbs imported from protocol-types (HIGH-5: single source of truth)
+        const genesis_prev_root_for_tbs = computeGenesisPrevRoot(pubA, pubB, session_id, session_timestamp);
+        const tbs = buildSessionEstablishmentTbs(session_id, pubA, pubB, genesis_prev_root_for_tbs, session_timestamp);
+        // Verify FROST signature with domain separation (context\0tbs framing)
+        if (!verifyFrostSignature(assignment.directory_signature, tbs, CONTEXT_SESSION_ESTABLISHMENT, verifyKey)) {
+            return { ok: false, reason: "frost_signature_invalid" };
+        }
+        // Step 4: Determine counterparty
+        const counterparty = isInitiator ? assignment.participant_b : assignment.participant_a;
+        // genesis_prev_root was already computed above for TBS — reuse it
+        const genesis_prev_root = genesis_prev_root_for_tbs;
+        // Step 4: Register content protocol handler on this node (if not already registered).
+        // Set the flag before awaiting handle() to prevent concurrent calls from both registering.
+        if (!this.#contentHandlerRegistered) {
+            this.#contentHandlerRegistered = true;
+            try {
+                await this.#ctx.node.handle(CELLO_CONTENT_PROTOCOL_ID, (stream) => {
+                    this.#ctx.handleContentStream(stream);
+                });
+            }
+            catch {
+                // Already registered by a concurrent call — safe to ignore.
+            }
+        }
+        // Step 5: Dial relay on /cello/relay/1.0.0 and complete challenge-response auth (AC-003)
+        const relayPeerId = assignment.relay_endpoint.peer_id;
+        const relayMultiaddr = assignment.relay_endpoint.multiaddrs[0];
+        if (relayMultiaddr) {
+            try {
+                await this.#ctx.node.dial(relayMultiaddr);
+            }
+            catch {
+                // Connection may already exist — proceed
+            }
+        }
+        let relayStream;
+        try {
+            relayStream = await this.#ctx.node.newStream(relayPeerId, RELAY_PROTOCOL_ID);
+        }
+        catch {
+            return { ok: false, reason: "relay_auth_error" };
+        }
+        // Auth challenge-response
+        let relayIter;
+        try {
+            const authResult = await this.#ctx.performRelayAuth(relayStream, myPubkey);
+            if (!authResult.ok) {
+                return { ok: false, reason: authResult.reason };
+            }
+            relayIter = authResult.iter;
+        }
+        catch {
+            return { ok: false, reason: "relay_auth_error" };
+        }
+        // Step 6: Dial counterparty on /cello/content/1.0.0 (AC-004)
+        try {
+            const counterpartyMultiaddr = counterparty.multiaddrs[0];
+            if (counterpartyMultiaddr) {
+                try {
+                    await this.#ctx.node.dial(counterpartyMultiaddr);
+                }
+                catch {
+                    // Already connected or not yet reachable — proceed
+                }
+            }
+            const contentStream = await this.#ctx.node.newStream(counterparty.peer_id, CELLO_CONTENT_PROTOCOL_ID);
+            // Close gracefully — content stream will be re-established per message in M1
+            contentStream.close().catch(() => { });
+        }
+        catch {
+            // Counterparty not yet listening — store session as active anyway.
+        }
+        // Step 7: Store session record (AC-004)
+        const sessionIdHex = Buffer.from(session_id).toString("hex");
+        const record = {
+            session_id,
+            counterparty_pubkey: counterparty.pubkey,
+            counterparty_peer_id: counterparty.peer_id,
+            counterparty_multiaddrs: counterparty.multiaddrs,
+            relay_endpoint: {
+                peer_id: assignment.relay_endpoint.peer_id,
+                multiaddrs: assignment.relay_endpoint.multiaddrs,
+            },
+            directory_endpoint: {
+                peer_id: assignment.directory_endpoint.peer_id,
+                multiaddrs: assignment.directory_endpoint.multiaddrs,
+            },
+            directory_pubkey: assignment.directory_pubkey,
+            genesis_prev_root,
+            last_seen_seq: 0,
+            last_sent_seq: 0,
+            status: "active",
+            local_tree_leaves: [],
+            next_expected_seq: 1,
+            desynchronized: false,
+        };
+        this.#sessions.set(sessionIdHex, record);
+        // PERSIST-024: persist session to DB
+        if (this.#ctx.persistence) {
+            void this.#ctx.persistence.persistSession(sessionIdHex, record);
+        }
+        // Initialize per-session state in this manager and RelayStreamManager
+        this.#outboundQueues.set(sessionIdHex, Promise.resolve());
+        this.#ownEchoResolvers.set(sessionIdHex, new Map());
+        this.#ownPendingContent.set(sessionIdHex, new Map());
+        this.#sessionMessageQueues.set(sessionIdHex, []);
+        this.#ctx.initRelaySession(sessionIdHex);
+        // Cache myPubkeyHex for the stream reader (same key across all sessions on this client)
+        if (!this.#ctx.getMyPubkeyHex())
+            this.#ctx.setMyPubkeyHex(myPubkeyHex);
+        this.#ctx.runRelayStreamReader(sessionIdHex, relayStream, myPubkeyHex, relayIter);
+        // Fire inbound session handler if this client is participant B.
+        if (myPubkeyHex !== pubAHex) {
+            const handler = this.#onSessionAssignmentHandler;
+            if (handler) {
+                handler({
+                    sessionIdHex,
+                    counterpartyPubkeyHex: Buffer.from(counterparty.pubkey).toString("hex"),
+                    genesisPrevRootHex: Buffer.from(genesis_prev_root).toString("hex"),
+                });
+            }
+        }
+        // ADAPTER-003: if the persistent signaling stream is already open, it handles
+        // session_sealed/seal_rejected events for all sessions.
+        // Only open a per-session stream when the persistent stream is not available.
+        if (!this.#ctx.getPersistentSignalingStream()) {
+            void this.#ctx.connectDirectorySignalingStream(sessionIdHex, assignment, myPubkey);
+        }
+        return { ok: true, sessionId: session_id };
+    }
+    listSessions() {
+        return Array.from(this.#sessions.values());
+    }
+    // ─── MSG-004 implementation ──────────────────────────────────────────────────
+    async sendMessage(sessionIdHex, content) {
+        // Per-session outbound serialization queue: next send not started until echo received
+        const prev = this.#outboundQueues.get(sessionIdHex) ?? Promise.resolve();
+        let release;
+        const next = new Promise((r) => { release = r; });
+        this.#outboundQueues.set(sessionIdHex, prev.then(() => next));
+        await prev;
+        try {
+            return await this.#sendMessageLocked(sessionIdHex, content);
+        }
+        finally {
+            release();
+        }
+    }
+    async #sendMessageLocked(sessionIdHex, content) {
+        const session = this.#sessions.get(sessionIdHex);
+        if (!session)
+            return { ok: false, reason: "session_not_found" };
+        if (session.desynchronized)
+            return { ok: false, reason: "session_desynchronized" };
+        if (session.status === "sealing" || session.status === "sealed" || session.status === "seal_deferred" || session.status === "seal_rejected")
+            return { ok: false, reason: "session_sealed" };
+        // SESSION-006 AC-001/AC-003: transport_lost means relay stream is gone or being reconnected
+        if (session.status === "transport_lost")
+            return { ok: false, reason: "transport_unavailable" };
+        const relayStream = this.#ctx.getRelayStream(sessionIdHex);
+        if (!relayStream || relayStream.status !== "open") {
+            return { ok: false, reason: "transport_unavailable" };
+        }
+        // content_hash = SHA-256(0x00 || content) per MERKLE-001
+        const contentHash = new Uint8Array(createHash("sha256").update(new Uint8Array([0x00])).update(content).digest());
+        // Build Structure 1 TBS: [1, content_hash, myPubkey, session_id, last_seen_seq, timestamp]
+        const myPubkeyHex = this.#ctx.getMyPubkeyHex();
+        const myPubkeyBytes = Buffer.from(myPubkeyHex, "hex");
+        const tbs = CBOR_ENC.encode([
+            1,
+            contentHash,
+            myPubkeyBytes,
+            session.session_id,
+            session.last_seen_seq,
+            Date.now(),
+        ]);
+        const signature = await this.#ctx.keyProvider.sign(tbs);
+        // Submit hash_submit to relay on the persistent relay stream
+        const hashSubmitFrame = CBOR_ENC.encode({
+            type: "hash_submit",
+            session_id: session.session_id,
+            leaf_kind: 0x00,
+            structure1_cbor: tbs,
+            sender_signature: signature,
+        });
+        const contentHashHex = Buffer.from(contentHash).toString("hex");
+        this.#ownPendingContent.get(sessionIdHex)?.set(contentHashHex, {
+            content_bytes: content,
+            arrived_at: Date.now(),
+        });
+        // PERSIST-024 AC-008: Persist pending hash BEFORE relay submission.
+        const enqueuedAt = Date.now();
+        if (this.#ctx.persistence) {
+            void this.#ctx.persistence.persistPendingHash({ sessionId: sessionIdHex, hashHex: contentHashHex, enqueuedAt });
+        }
+        // Set up ack resolver before sending to avoid race with fast relay.
+        if (this.#pendingAckResolvers.has(sessionIdHex)) {
+            throw new Error(`[cello-client] ack resolver already set for session ${sessionIdHex}; outbound queue invariant violated`);
+        }
+        let ackResolve;
+        const ackPromise = new Promise((r) => { ackResolve = r; });
+        this.#pendingAckResolvers.set(sessionIdHex, ackResolve);
+        try {
+            relayStream.send(lp.encode.single(hashSubmitFrame));
+        }
+        catch {
+            this.#pendingAckResolvers.delete(sessionIdHex);
+            this.#ownPendingContent.get(sessionIdHex)?.delete(contentHashHex);
+            if (this.#ctx.persistence) {
+                void this.#ctx.persistence.removePendingHash(sessionIdHex, contentHashHex);
+            }
+            return { ok: false, reason: "transport_unavailable" };
+        }
+        const ack = await ackPromise;
+        if (!ack.ok) {
+            if (this.#ctx.persistence) {
+                void this.#ctx.persistence.removePendingHash(sessionIdHex, contentHashHex);
+            }
+            return { ok: false, reason: "relay_rejected" };
+        }
+        const mySeq = ack.sequence_number;
+        // PERSIST-024 AC-008: Relay ACKed — remove from pending_hashes.
+        if (this.#ctx.persistence) {
+            void this.#ctx.persistence.removePendingHash(sessionIdHex, contentHashHex);
+        }
+        // Send content to counterparty on /cello/content/1.0.0
+        const sess2 = this.#sessions.get(sessionIdHex);
+        if (sess2 && !sess2.desynchronized) {
+            void this.sendContentFrame(sess2, content, contentHash);
+        }
+        // Wait for our own echoed leaf_deliver
+        await this.waitForOwnEcho(sessionIdHex, mySeq);
+        const sess3 = this.#sessions.get(sessionIdHex);
+        if (!sess3 || sess3.desynchronized)
+            return { ok: false, reason: "session_desynchronized" };
+        return { ok: true };
+    }
+    async sendContentFrame(session, content, contentHash) {
+        const counterpartyPeerId = session.counterparty_peer_id;
+        try {
+            // Dial counterparty if not connected
+            const multiaddr = session.counterparty_multiaddrs[0];
+            if (multiaddr) {
+                try {
+                    await this.#ctx.node.dial(multiaddr);
+                }
+                catch { /* already connected */ }
+            }
+            const contentStream = await this.#ctx.node.newStream(counterpartyPeerId, CELLO_CONTENT_PROTOCOL_ID);
+            const frame = CBOR_ENC.encode({
+                type: "content_frame",
+                session_id: session.session_id,
+                content_hash: contentHash,
+                content_bytes: content,
+            });
+            contentStream.send(lp.encode.single(frame));
+            await contentStream.close();
+        }
+        catch {
+            // Content path failure is silent; 30s grace timer fires if receiver doesn't get content
+        }
+    }
+    async waitForOwnEcho(sessionIdHex, seqNum) {
+        return new Promise((resolve) => {
+            const resolvers = this.#ownEchoResolvers.get(sessionIdHex);
+            if (resolvers) {
+                resolvers.set(seqNum, resolve);
+            }
+            else {
+                resolve(); // session was closed
+            }
+        });
+    }
+    receiveMessage(sessionIdHex) {
+        const queue = this.#sessionMessageQueues.get(sessionIdHex);
+        if (!queue || queue.length === 0)
+            return null;
+        return queue.shift();
+    }
+    receiveAnyMessage() {
+        return this.#anyMessageQueue.shift() ?? null;
+    }
+    // ─── SESSION-007: async blocking receive ─────────────────────────────────────
+    #computeOtherSessionsPending(excludeSessionIdHex) {
+        const pending = [];
+        for (const [sid, queue] of this.#sessionMessageQueues.entries()) {
+            if (sid !== excludeSessionIdHex && queue.length > 0) {
+                pending.push(sid);
+            }
+        }
+        return pending;
+    }
+    wakeReceiveWaiters(sessionIdHex) {
+        // Wake per-session waiters
+        const sessionWaiters = this.#receiveWaiters.get(sessionIdHex);
+        if (sessionWaiters) {
+            for (const resolve of sessionWaiters)
+                resolve();
+            sessionWaiters.clear();
+        }
+        // Wake any-session waiters
+        for (const resolve of this.#receiveAnyWaiters)
+            resolve();
+        this.#receiveAnyWaiters.clear();
+    }
+    async receiveSessionMessageAsync(sessionIdHex, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            // Check queue first (fast path: already has messages)
+            const queue = this.#sessionMessageQueues.get(sessionIdHex);
+            if (queue && queue.length > 0) {
+                const item = queue.shift();
+                // Remove from #anyMessageQueue as well to keep in sync
+                const idx = this.#anyMessageQueue.findIndex((e) => e.sessionIdHex === sessionIdHex && e.message === item);
+                if (idx !== -1)
+                    this.#anyMessageQueue.splice(idx, 1);
+                // Attach otherSessionsPending
+                const pending = this.#computeOtherSessionsPending(sessionIdHex);
+                const result = pending.length > 0 ? { ...item, otherSessionsPending: pending } : item;
+                if (pending.length > 0) {
+                    this.#ctx.logger.info("session.receive.pending_hint", {
+                        currentSessionId: sessionIdHex,
+                        pendingSessionCount: pending.length,
+                        correlationId: sessionIdHex,
+                    });
+                }
+                return result;
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return null;
+            // Register wake resolver and race against timeout
+            await new Promise((resolve) => {
+                let set = this.#receiveWaiters.get(sessionIdHex);
+                if (!set) {
+                    set = new Set();
+                    this.#receiveWaiters.set(sessionIdHex, set);
+                }
+                set.add(resolve);
+                setTimeout(() => {
+                    // Remove resolver if timeout fires before wake
+                    this.#receiveWaiters.get(sessionIdHex)?.delete(resolve);
+                    resolve();
+                }, remaining);
+            });
+        }
+    }
+    async receiveMessageAsync(timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            // Check any-session queue first (fast path)
+            if (this.#anyMessageQueue.length > 0) {
+                const entry = this.#anyMessageQueue.shift();
+                // Remove from per-session queue as well
+                const perSession = this.#sessionMessageQueues.get(entry.sessionIdHex);
+                if (perSession) {
+                    const idx = perSession.indexOf(entry.message);
+                    if (idx !== -1)
+                        perSession.splice(idx, 1);
+                }
+                // Attach otherSessionsPending
+                const pending = this.#computeOtherSessionsPending(entry.sessionIdHex);
+                const result = pending.length > 0
+                    ? { ...entry.message, sessionIdHex: entry.sessionIdHex, otherSessionsPending: pending }
+                    : { ...entry.message, sessionIdHex: entry.sessionIdHex };
+                if (pending.length > 0) {
+                    this.#ctx.logger.info("session.receive.pending_hint", {
+                        currentSessionId: entry.sessionIdHex,
+                        pendingSessionCount: pending.length,
+                        correlationId: entry.sessionIdHex,
+                    });
+                }
+                return result;
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return { type: "timeout" };
+            // Register wake resolver and race against timeout
+            await new Promise((resolve) => {
+                this.#receiveAnyWaiters.add(resolve);
+                setTimeout(() => {
+                    this.#receiveAnyWaiters.delete(resolve);
+                    resolve();
+                }, remaining);
+            });
+        }
+    }
+    enqueueSessionSealedEvent(sessionIdHex, sealedRoot, closeTimestamp) {
+        // Use sessionIdHex as correlationId — minted at session initiation, unique per session flow.
+        const correlationId = sessionIdHex;
+        this.#ctx.logger.info("session.sealed.received", {
+            sessionId: sessionIdHex,
+            sealedRoot: Buffer.from(sealedRoot).toString("hex"),
+            closeTimestamp,
+            checkpointStatus: "pending",
+            correlationId,
+        });
+        const lifecycleEvent = {
+            type: "session_sealed",
+            sessionIdHex,
+            sealedRoot: new Uint8Array(sealedRoot),
+            closeTimestamp,
+            checkpointStatus: "pending",
+        };
+        let queue = this.#sessionMessageQueues.get(sessionIdHex);
+        if (!queue) {
+            queue = [];
+            this.#sessionMessageQueues.set(sessionIdHex, queue);
+        }
+        queue.push(lifecycleEvent);
+        this.#anyMessageQueue.push({ sessionIdHex, message: lifecycleEvent });
+        this.wakeReceiveWaiters(sessionIdHex);
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"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"}