tmux-ide 2.9.3 → 2.9.5

package/packages/daemon/dist/terminal/mirror/session-channel.js

@@ -30,7 +30,7 @@ import { decodeNativeGridCapture, isNativeBootstrapCapture, } from "./native-gri
  *    keys flush pending literals first — the shared {@link InputCoalescer}
  *    discipline — leaving fire-and-forget via the channel.
  */
-import { createHash, randomBytes } from "node:crypto";
+import { randomBytes } from "node:crypto";
 import { hostname } from "node:os";
 import { WINDOW_LINK_MAX_LINKS, WORKSPACE_SEMANTIC_PANE_OPTION, WORKSPACE_SEMANTIC_WINDOW_OPTION, WorkspaceIdSchemaZ, } from "@tmux-ide/contracts";
 import { textToHexKeys } from "../protocol/control.js";
@@ -45,6 +45,7 @@ import { WindowLinkAuthority, WindowLinkResolutionError } from "./window-link-au
 import { buildNativeWindowLinkGuard, buildNativeWindowLinkPaneSelectGuard, classifyNativeWindowLinkGuardResult, } from "../../lib/tmux-window-link-guard.js";
 import { FlowLedger } from "./flow-ledger.js";
 import { PaneFeed, captureLinesFromAnsiBytes, parseCursorProbe } from "./pane-feed.js";
+import { StockPaneSnapshot } from "./stock-pane-snapshot.js";
 import { INTERNAL_READ_OPERATION_OPTION, registerInternalReadOperation, retireInternalReadOperation, } from "../../lib/tmux-interaction-options.js";
 const TMUX_SERVER_HOSTNAME = hostname();
 /** Notifications whose payload cannot be applied directly — fall back to the
@@ -69,20 +70,17 @@ const NATIVE_CLIENT_SUBSCRIPTION = "tmux-ide-native-clients";
 const SYNC_DEBOUNCE_MS = 40;
 /** Foreground-command labels follow output, but never turn a busy pane into a probe loop. */
 const DISPLAY_NAME_SYNC_INTERVAL_MS = 750;
-const RECOVERY_QUIET_MS = 40;
 const RECOVERY_COMMAND_DEADLINE_MS = 500;
 const RECOVERY_NO_PROGRESS_DEADLINE_MS = 3_000;
 const RECOVERY_ABSOLUTE_DEADLINE_MS = 5_000;
 const RECOVERY_MAX_ATTEMPTS = 4;
-const MAX_QUEUED_PLAIN_RESEEDS = 64;
+const MAX_QUEUED_SNAPSHOTS = 64;
 const RECOVERY_CAPTURE_MAX_BYTES = 16 * 1024 * 1024;
 // Budget row bookkeeping separately from wire bytes (64 bytes per retained
 // line). A fixed 8192-row ceiling rejected small captures of ordinary history.
 // Both the wire-byte cap and this finite allocation bound remain enforced.
 const RECOVERY_CAPTURE_MAX_LINES = RECOVERY_CAPTURE_MAX_BYTES / 64;
 const RECOVERY_CURSOR_MAX_BYTES = 1_024;
-const MAX_CONTINUE_NOTIFICATION_QUEUE = 32;
-const MAX_CONTINUE_NOTIFICATION_DEBT = 65_536;
 const RECOVERY_CURSOR_PROBE_FORMAT = [
     "#{cursor_x}",
     "#{cursor_y}",
@@ -125,24 +123,6 @@ const FAILED_RESEED_RESULT = Object.freeze({
     publish: () => false,
     hold: () => { },
 });
-function snapshotFingerprint(captureLines, cursorLine, fallbackSize) {
-    const hash = createHash("sha256");
-    const append = (bytes) => {
-        const length = Buffer.allocUnsafe(4);
-        length.writeUInt32BE(bytes.byteLength);
-        hash.update(length);
-        hash.update(bytes);
-    };
-    hash.update("tmux-ide/recovery-snapshot/v1\0");
-    const count = Buffer.allocUnsafe(4);
-    count.writeUInt32BE(captureLines.length);
-    hash.update(count);
-    for (const line of captureLines)
-        append(Buffer.from(line, "latin1"));
-    append(Buffer.from(cursorLine, "utf8"));
-    append(Buffer.from(fallbackSize ? `${fallbackSize.cols}x${fallbackSize.rows}` : "no-layout-fallback", "ascii"));
-    return hash.digest("hex");
-}
 // tmux concatenates adjacent quoted/unquoted fragments; doubled single quotes
 // do not escape a quote. Preserve nested commands across both parser passes.
 function tmuxSingleQuote(value) {
@@ -163,7 +143,6 @@ export function defaultMirrorWindowId() {
 export class SessionChannel {
     nativeBootstrapUnavailable = false;
     nativeBootstrapConfirmed = false;
-    nativeProbeRetried = new WeakSet();
     opts;
     io;
     ledger = new FlowLedger();
@@ -190,6 +169,7 @@ export class SessionChannel {
     fittedWindows = new Map();
     cancelSync = null;
     syncOrdinal = 0;
+    completedSyncOrdinal = 0;
     lastDisplayNameSyncAtMs = 0;
     disposed = false;
     nativeGrid;
@@ -200,12 +180,12 @@ export class SessionChannel {
     windowIdentityOrdinal = 0;
     paneIncarnation = 0;
     recoveryOrdinal = 0;
-    plainReseedActive = null;
-    plainReseedQueue = new Map();
+    snapshotQueue = new Map();
+    snapshotActive = null;
+    observedPaused = new Set();
     outputOrdinals = new Map();
     pendingLayoutOutput = new Map();
     recoveries = new Map();
-    continueNotificationQueues = new Map();
     trustedInventoryFlight = null;
     trustedInventoryFlightSessionId = null;
     attachedIdentity = null;
@@ -218,6 +198,19 @@ export class SessionChannel {
     input = new InputCoalescer((action) => {
         const startedAtMicros = action.traceIds?.length ? Math.floor(performance.now() * 1_000) : 0;
         const pendingBeforeSend = action.traceIds?.length ? (this.io.pendingCount ?? 0) : 0;
+        const pane = action.traceIds?.length ? this.panesByRuntime.get(action.pane) : undefined;
+        const semanticPaneId = !this.disposed && pane?.descriptor ? pane.semanticId : null;
+        const paneIncarnation = pane?.incarnation;
+        const paneActive = pane?.active;
+        const birth = pane?.descriptor?.nativePaneBirthId;
+        let complete;
+        try {
+            if (action.traceIds?.length)
+                complete = this.opts.captureInputWrite?.(action, semanticPaneId);
+        }
+        catch {
+            // Optional diagnostics must never suppress a dispatch.
+        }
         const onReply = action.traceIds?.length
             ? (reply) => this.opts.onInputAccepted?.(action, Math.floor(performance.now() * 1_000), reply.ok)
             : undefined;
@@ -234,6 +227,22 @@ export class SessionChannel {
         else {
             this.io.send(`send-keys -t ${action.pane} ${action.key}`, onReply);
         }
+        try {
+            complete?.(startedAtMicros, Math.floor(performance.now() * 1_000), pendingBeforeSend, !this.disposed &&
+                pane !== undefined &&
+                semanticPaneId !== null &&
+                this.panesByRuntime.get(action.pane) === pane &&
+                this.panesBySemantic.get(semanticPaneId) === pane &&
+                pane.runtimeId === action.pane &&
+                pane.semanticId === semanticPaneId &&
+                pane.incarnation === paneIncarnation &&
+                pane.active === paneActive &&
+                pane.descriptor !== null &&
+                pane.descriptor.nativePaneBirthId === birth);
+        }
+        catch {
+            // In particular, never replay an accepted owned-native dispatch.
+        }
         if (action.traceIds?.length)
             this.opts.onInputWrite?.(action, startedAtMicros, Math.floor(performance.now() * 1_000), pendingBeforeSend);
     }, (flush) => queueMicrotask(flush));
@@ -308,8 +317,12 @@ export class SessionChannel {
                     this.captureWithViewer(runtime, ["-R", "-S", "-"], (value) => {
                         marker = value;
                     }, (reply) => {
-                        if (!reply.ok && marker)
-                            this.retireInternalReadMarker(runtime, marker);
+                        if (marker) {
+                            if (reply.ok)
+                                this.clearInternalReadMarkerOption(runtime, marker);
+                            else
+                                this.retireInternalReadMarker(runtime, marker);
+                        }
                         onReply(reply);
                     }, limits);
                 }
@@ -610,6 +623,7 @@ export class SessionChannel {
             frozen: false,
             closed: false,
         };
+        sub.feed.abortCurrent();
         pane.subs.add(sub);
         // A paused pane gains an unfrozen watcher: release the park before the
         // seed so the capture reflects a flowing pane.
@@ -657,6 +671,13 @@ export class SessionChannel {
             close: () => this.closeSub(sub),
         };
     }
+    qualificationListeners() {
+        return Object.freeze({
+            pane: [...this.panesByRuntime.values()].reduce((sum, pane) => sum + pane.subs.size, 0),
+            layout: this.layoutSubscribers.size,
+            layoutAuthority: this.layoutAuthoritySubscribers.size,
+        });
+    }
     /** Session geometry without a dummy pane feed or terminal-content seed. */
     subscribeLayout(onLayout) {
         if (this.disposed)
@@ -863,6 +884,10 @@ export class SessionChannel {
         if (this.disposed)
             return;
         this.disposed = true;
+        this.snapshotActive?.cleanup?.();
+        this.snapshotActive?.cancelFence?.();
+        this.snapshotActive = null;
+        this.snapshotQueue.clear();
         this.windowLinkAuthority?.dispose();
         this.nativeGrid.dispose();
         this.settleFirstJoin();
@@ -870,7 +895,6 @@ export class SessionChannel {
         this.cancelSync = null;
         for (const runtime of [...this.recoveries.keys()])
             this.cancelRecovery(runtime);
-        this.continueNotificationQueues.clear();
         this.discovery.dispose();
         this.input.flush();
         this.opts.ownedViewer?.dispose();
@@ -879,7 +903,12 @@ export class SessionChannel {
                 if (!sub.closed) {
                     sub.closed = true;
                     sub.cancelCapture?.();
-                    sub.onEvent({ type: "closed" });
+                    try {
+                        sub.onEvent({ type: "closed" });
+                    }
+                    catch {
+                        // Close every sibling and the transport even if a consumer throws.
+                    }
                 }
             }
             pane.subs.clear();
@@ -892,6 +921,24 @@ export class SessionChannel {
     }
     // ── Byte routing ─────────────────────────────────────────────────────────
     onOutput(runtimePane, data, ageMs, timing) {
+        const stockRecovery = this.recoveries.get(runtimePane);
+        const stockPane = this.panesByRuntime.get(runtimePane);
+        if (stockRecovery?.stock && stockPane && stockRecovery.lease) {
+            const disposition = stockRecovery.stock.acceptOutput(runtimePane, data, this.snapshotContext(stockPane));
+            if (disposition !== "live" && disposition !== "unrelated") {
+                const ordinal = (this.outputOrdinals.get(runtimePane) ?? 0) + 1;
+                this.outputOrdinals.set(runtimePane, ordinal);
+                this.opts.onOutputObserved?.(stockPane.semanticId, ageMs, timing);
+                if (ageMs !== null) {
+                    this.ageByRuntime.set(runtimePane, ageMs);
+                    if (ageMs > this.maxAgeMs)
+                        this.maxAgeMs = ageMs;
+                }
+                if (disposition === "invalid")
+                    this.retrySnapshot(stockRecovery);
+                return;
+            }
+        }
         const windowId = this.panesByRuntime.get(runtimePane)?.windowRuntimeId;
         const pending = windowId ? this.pendingLayoutOutput.get(windowId) : undefined;
         if (pending) {
@@ -933,328 +980,26 @@ export class SessionChannel {
         }
         if (overflowed)
             this.restartRecoveryAfterOutputOverflow(pane);
-        this.noteRecoveryOutput(pane, outputOrdinal);
     }
     // ── Seed / reseed (the atomic recipe) ────────────────────────────────────
-    reseed(lease, onSettled, deferPublish = false, deadlineAt = this.recoveryNowMs() + RECOVERY_ABSOLUTE_DEADLINE_MS) {
-        const { sub } = lease;
-        if (sub.closed || sub.frozen || this.disposed) {
-            onSettled?.(FAILED_RESEED_RESULT);
-            return;
-        }
-        lease.cancelRecipe?.();
-        const runtime = sub.pane.runtimeId;
-        const epoch = sub.feed.beginReseed();
-        let settled = false;
-        let captureSucceeded = false;
-        let markerRetired = false;
-        let captureLines = null;
-        let capturedNativeSize = null;
-        let cancelDeadline = null;
-        let resumeLayoutCapture = null;
-        const clearLayoutWait = () => {
-            if (sub.resumeLayoutCapture === resumeLayoutCapture)
-                sub.resumeLayoutCapture = null;
-            resumeLayoutCapture = null;
-        };
-        const settle = (result) => {
-            if (settled)
-                return;
-            settled = true;
-            clearLayoutWait();
-            cancelDeadline?.();
-            lease.cancelRecipe = null;
-            onSettled?.(result);
-        };
-        // Keystroke ordering: pending coalesced input leaves before the probes.
-        this.input.flush();
-        const history = this.opts.historyLines ?? "";
-        let internalReadMarker = null;
-        const retireMarker = () => {
-            if (markerRetired)
-                return;
-            markerRetired = true;
-            if (internalReadMarker)
-                this.retireInternalReadMarker(runtime, internalReadMarker);
-        };
-        lease.cancelRecipe = () => {
-            if (settled)
-                return;
-            settled = true;
-            clearLayoutWait();
-            cancelDeadline?.();
-            lease.cancelRecipe = null;
-            sub.feed.abort(epoch);
-            if (!captureSucceeded)
-                retireMarker();
-        };
-        cancelDeadline = this.scheduleRecovery(() => {
-            if (settled)
-                return;
-            sub.feed.abort(epoch);
-            if (!captureSucceeded)
-                retireMarker();
-            settle(FAILED_RESEED_RESULT);
-        }, Math.max(0, deadlineAt - this.recoveryNowMs()));
-        // Keep retired reply slots in the control FIFO; their callbacks become
-        // no-ops so late responses cannot publish or consume a newer capture.
-        // Both probes ride one write burst; the FIFO reply order is the seam.
-        this.captureWithViewer(runtime, [...(sub.nativeBootstrap ? ["-R"] : ["-e", "-J"]), "-S", `-${history}`], (marker) => {
-            internalReadMarker = marker;
-        }, (reply) => {
-            if (settled)
-                return;
-            const native = sub.nativeBootstrap && reply.ok ? decodeNativeGridCapture(reply.lines.join("\n")) : null;
-            if (sub.nativeBootstrap &&
-                (!native || !isNativeBootstrapCapture(native)) &&
-                !nativeBootstrapUnsupported(reply.ok, reply.lines, native)) {
-                if (!this.nativeBootstrapConfirmed &&
-                    !this.nativeProbeRetried.has(sub) &&
-                    this.recoveryNowMs() < deadlineAt) {
-                    // An unknown server can swallow an unsupported command inside a
-                    // dynamic hook. Retry the ordinary probe once, with a fresh FIFO
-                    // seam and the original deadline, before invoking native recovery.
-                    this.nativeProbeRetried.add(sub);
-                    settled = true;
-                    sub.feed.abort(epoch);
-                    cancelDeadline?.();
-                    lease.cancelRecipe = null;
-                    retireMarker();
-                    this.reseed(lease, onSettled, deferPublish, deadlineAt);
-                    return;
-                }
-                sub.feed.abort(epoch);
-                retireMarker();
-                settle(FAILED_RESEED_RESULT);
-                return;
-            }
-            if (sub.nativeBootstrap && (!native || !isNativeBootstrapCapture(native))) {
-                // Unsupported/backing-only native exports fall back at a new FIFO
-                // capture seam. Never replay held bytes across these two captures.
-                settled = true;
-                retireMarker();
-                sub.feed.abort(epoch);
-                cancelDeadline?.();
-                lease.cancelRecipe = null;
-                sub.nativeBootstrap = false;
-                this.nativeBootstrapUnavailable = true;
-                this.reseed(lease, onSettled, deferPublish, deadlineAt);
-                return;
-            }
-            if (!reply.ok) {
-                // Successful captures consume the marker atomically inside the tmux
-                // after-capture-pane hook. The command-list also prevents a concurrent
-                // mirror from stealing the marker. Only failures need cleanup.
-                retireMarker();
-                sub.feed.abort(epoch);
-                settle(FAILED_RESEED_RESULT);
-                return;
-            }
-            captureSucceeded = true;
-            if (sub.closed || sub.frozen || this.disposed) {
-                sub.feed.abort(epoch);
-                settle(FAILED_RESEED_RESULT);
-                return;
-            }
-            captureLines = [...reply.lines];
-            if (native) {
-                this.nativeBootstrapConfirmed = true;
-                capturedNativeSize = { cols: native.cols, rows: native.rows };
-            }
-            if (native)
-                sub.feed.captureNativeReply(epoch, native);
-            else
-                sub.feed.captureReply(epoch, reply.lines);
-        });
-        this.io.commandInline(`display-message -p -t ${runtime} "${RECOVERY_CURSOR_PROBE_FORMAT}"`, (reply) => {
-            if (settled)
-                return;
-            if (sub.closed || sub.frozen || this.disposed) {
-                sub.feed.abort(epoch);
-                settle(FAILED_RESEED_RESULT);
-                return;
-            }
-            if (!reply.ok) {
-                if (!captureSucceeded)
-                    retireMarker();
-                sub.feed.abort(epoch);
-                settle(FAILED_RESEED_RESULT);
-                return;
-            }
-            // Native/cursor replies can precede the paired layout/border reply.
-            // Never publish that candidate against old authority, nor replay held
-            // output over its snapshot. Recapture after the latest layout releases,
-            // retaining this recipe's original deadline and one queue lease.
-            const windowId = sub.pane.windowRuntimeId;
-            const probe = parseCursorProbe(reply.lines[0] ?? "");
-            const validCaptureGeometry = probe &&
-                Number.isSafeInteger(probe.x) &&
-                Number.isSafeInteger(probe.y) &&
-                probe.y < probe.rows &&
-                (!capturedNativeSize ||
-                    (capturedNativeSize.cols === probe.cols && capturedNativeSize.rows === probe.rows));
-            const layoutSize = validCaptureGeometry ? this.layoutCaptureSizeFor(sub) : null;
-            const pendingLayout = windowId !== null && this.pendingLayoutOutput.has(windowId);
-            const aheadOfLayout = layoutSize && probe && (layoutSize.cols !== probe.cols || layoutSize.rows !== probe.rows);
-            if (windowId && layoutSize && validCaptureGeometry && (pendingLayout || aheadOfLayout)) {
-                sub.feed.abort(epoch);
-                captureLines = null;
-                const waitingAfterSyncOrdinal = this.syncOrdinal;
-                resumeLayoutCapture = (completedSyncOrdinal) => {
-                    if (settled)
-                        return;
-                    if (this.recoveryNowMs() >= deadlineAt) {
-                        settle(FAILED_RESEED_RESULT);
-                        return;
-                    }
-                    const current = this.layoutCaptureSizeFor(sub);
-                    // Only a successful truth sync started after this wait is a causal
-                    // barrier, including resize-back to identical geometry. An older
-                    // in-flight sync and cached layout emissions cannot qualify it.
-                    if (!current)
-                        return;
-                    if (completedSyncOrdinal !== undefined) {
-                        if (completedSyncOrdinal <= waitingAfterSyncOrdinal)
-                            return;
-                    }
-                    else if (!pendingLayout &&
-                        current.cols === layoutSize.cols &&
-                        current.rows === layoutSize.rows)
-                        return;
-                    settled = true;
-                    clearLayoutWait();
-                    cancelDeadline?.();
-                    lease.cancelRecipe = null;
-                    this.reseed(lease, onSettled, deferPublish, deadlineAt);
-                };
-                sub.resumeLayoutCapture = resumeLayoutCapture;
-                if (!pendingLayout)
-                    this.scheduleSync();
-                return;
-            }
-            const cursorLine = reply.lines[0] ?? "";
-            const historySize = Number(cursorLine.trim().split(/\s+/)[14]);
-            if (Number.isSafeInteger(historySize) && historySize >= 0)
-                sub.pane.historySize = historySize;
-            const fallbackSize = this.layoutSizeFor(runtime);
-            this.observeScrollOnClear(sub.pane, cursorLine);
-            const events = sub.feed.cursorReply(epoch, cursorLine, fallbackSize);
-            let published = false;
-            const publish = () => {
-                if (published)
-                    return true;
-                if (sub.closed || sub.frozen || this.disposed)
-                    return false;
-                published = true;
-                for (const event of events)
-                    sub.onEvent(event);
-                return true;
-            };
-            const ok = events.length > 0 && !sub.closed && captureLines !== null;
-            const result = {
-                ok,
-                fingerprint: ok ? snapshotFingerprint(captureLines, cursorLine, fallbackSize) : null,
-                publish,
-                hold: () => sub.feed.quarantine(epoch),
-            };
-            if (!deferPublish)
-                publish();
-            settle(result);
-        });
-    }
     reseedPlain(sub, resumeReason = null) {
         if (sub.closed || sub.frozen || this.disposed)
             return;
-        // Layout observers can request a reseed reentrantly during admission. The
-        // waiting recipe already owns that request and its absolute deadline.
-        if (sub.resumeLayoutCapture)
-            return;
-        if (this.plainReseedActive?.sub === sub)
-            sub.cancelCapture?.();
-        if (!this.plainReseedQueue.has(sub) && this.plainReseedQueue.size >= MAX_QUEUED_PLAIN_RESEEDS) {
-            this.failPlainReseed(sub);
-            return;
-        }
-        this.plainReseedQueue.set(sub, resumeReason);
-        if (this.plainReseedActive?.sub !== sub) {
-            // Output before this queued recipe starts is already in its future
-            // capture. Do not publish it using the prior geometry in the meantime.
-            sub.feed.beginReseed();
-            sub.cancelCapture = () => {
-                this.plainReseedQueue.delete(sub);
-                sub.cancelCapture = null;
-                sub.feed.abortCurrent();
-            };
-        }
-        this.drainPlainReseeds();
-    }
-    failPlainReseed(sub) {
-        if (sub.closed ||
-            sub.frozen ||
-            this.disposed ||
-            this.recoveries.has(sub.pane.runtimeId) ||
-            this.panesByRuntime.get(sub.pane.runtimeId) !== sub.pane)
-            return;
-        this.beginLocalOverflowRecovery(sub.pane);
-    }
-    drainPlainReseeds() {
-        if (this.plainReseedActive || this.disposed)
-            return;
-        const next = this.plainReseedQueue.entries().next().value;
-        if (!next)
-            return;
-        const [sub, resumeReason] = next;
-        this.plainReseedQueue.delete(sub);
-        if (sub.closed || sub.frozen) {
-            this.drainPlainReseeds();
-            return;
-        }
-        sub.cancelCapture?.();
-        const lease = { sub, cancelRecipe: null };
-        this.plainReseedActive = lease;
-        // The queue lease outlives individual native capability probes. Retrying
-        // or falling back replaces only cancelRecipe, never this queue owner.
-        sub.cancelCapture = () => {
-            if (this.plainReseedActive !== lease)
-                return;
-            lease.cancelRecipe?.();
-            sub.cancelCapture = null;
-            this.plainReseedActive = null;
-            this.drainPlainReseeds();
-        };
-        // Only the recipe actually submitted to the control FIFO owns a five
-        // second deadline. A large sibling projection cannot consume the waiting
-        // panes' entire capture budgets before their commands have been written.
-        this.reseed(lease, (result) => {
-            if (this.plainReseedActive !== lease)
-                return;
-            sub.cancelCapture = null;
-            this.plainReseedActive = null;
-            if (!result.ok) {
-                // A stalled FIFO cannot make progress for queued recipes either. Retire
-                // them together instead of granting each another wait behind that slot.
-                const waiting = [...this.plainReseedQueue.keys()];
-                this.plainReseedQueue.clear();
-                for (const queued of waiting)
-                    queued.cancelCapture?.();
-                this.failPlainReseed(sub);
-                for (const queued of waiting)
-                    this.failPlainReseed(queued);
-                return;
-            }
-            // Admit the next recipe before publishing this potentially large seed.
-            this.drainPlainReseeds();
-            result.publish();
-            if (resumeReason && !sub.closed && !sub.frozen)
-                sub.onEvent({ type: "flow", state: "resumed", reason: resumeReason });
-        }, true);
+        this.beginRecovery(sub.pane, resumeReason ?? "requested");
     }
     retireInternalReadMarker(runtime, marker) {
         if (!/^%(?:0|[1-9][0-9]*)$/u.test(runtime))
             throw new TypeError("internal read cleanup requires a runtime pane id");
         retireInternalReadOperation(marker, runtime);
+        this.clearInternalReadMarkerOption(runtime, marker);
+    }
+    clearInternalReadMarkerOption(runtime, marker) {
+        if (!/^%(?:0|[1-9][0-9]*)$/u.test(runtime))
+            throw new TypeError("internal read cleanup requires a runtime pane id");
+        // Success must keep the in-memory proof redeemable by a delayed observer.
+        // The server option must still be removed when no observer hook is installed.
         // Pane capture phases overlap under cancellation. Clear only the exact
-        // failed marker so a late A callback cannot erase the newer B authority.
+        // owned marker so a late A callback cannot erase the newer B authority.
         // Both selected branches must emit one reply in addition to if-shell's
         // own reply. An empty false branch emits none and shifts the control FIFO
         // whenever the true branch runs during capture cancellation.
@@ -1301,6 +1046,10 @@ export class SessionChannel {
             return;
         sub.frozen = true;
         sub.cancelCapture?.();
+        const activeRecovery = this.recoveries.get(sub.pane.runtimeId);
+        if (activeRecovery &&
+            [...sub.pane.subs].some((candidate) => !candidate.closed && !candidate.frozen))
+            this.retrySnapshot(activeRecovery);
         sub.onEvent({ type: "flow", state: "paused", reason: "requested" });
         const pane = sub.pane;
         const allFrozen = [...pane.subs].every((candidate) => candidate.frozen || candidate.closed);
@@ -1376,40 +1125,49 @@ export class SessionChannel {
         if (!recovery)
             return;
         recovery.retired = true;
-        recovery.cancelQuiet?.();
+        this.recoveries.delete(runtime);
+        this.snapshotQueue.delete(runtime);
         recovery.cancelCommandDeadline?.();
         recovery.cancelNoProgressDeadline?.();
         recovery.cancelAbsoluteDeadline?.();
-        if (recovery.atomicCollectorNonce)
-            this.io.retireAtomicPaneSnapshotCollector?.(recovery.atomicCollectorNonce, "retired");
-        recovery.atomicCollectorNonce = null;
-        this.recoveries.delete(runtime);
-        this.retireContinueNotificationOwner(recovery);
         const pane = this.panesByRuntime.get(runtime);
         if (pane?.incarnation === recovery.paneIncarnation)
             for (const sub of pane.subs)
                 sub.feed.abortCurrent();
+        if (recovery.lease)
+            this.retireSnapshotLease(recovery.lease);
+        else if (recovery.atomicCollectorNonce)
+            this.io.retireAtomicPaneSnapshotCollector?.(recovery.atomicCollectorNonce, "retired");
+        recovery.atomicCollectorNonce = null;
     }
     beginRecovery(pane, reason) {
-        for (const sub of pane.subs)
-            sub.cancelCapture?.();
-        const runtime = pane.runtimeId;
-        this.cancelRecovery(runtime);
+        if (this.disposed)
+            return;
+        const current = this.recoveries.get(pane.runtimeId);
+        if (current && !current.retired) {
+            if (this.snapshotQueue.get(pane.runtimeId) === current)
+                return;
+            this.retrySnapshot(current);
+            return;
+        }
+        if (this.snapshotQueue.size >= MAX_QUEUED_SNAPSHOTS) {
+            for (const sub of pane.subs) {
+                sub.feed.abortCurrent();
+                if (!sub.closed && !sub.frozen)
+                    sub.onEvent({ type: "fault", reason: "native-recovery-failed" });
+            }
+            return;
+        }
         const recovery = {
             ordinal: ++this.recoveryOrdinal,
-            runtimeId: runtime,
+            runtimeId: pane.runtimeId,
             paneIncarnation: pane.incarnation,
             reason,
             startedAtMs: this.recoveryNowMs(),
             retired: false,
-            continueReply: false,
-            continueNotify: false,
-            stage: "continue",
+            stage: "queued",
             attempts: 0,
             reseedOrdinal: 0,
-            outputOrdinal: this.outputOrdinals.get(runtime) ?? 0,
-            candidateFingerprint: null,
-            confirmationFingerprint: null,
             confirmationOrdinal: 0,
             atomicCollectorNonce: null,
             collectorStarted: false,
@@ -1420,103 +1178,349 @@ export class SessionChannel {
             collectorStatusObserved: false,
             collectorObserverEmissionObserved: false,
             collectorFailureReason: null,
-            cancelQuiet: null,
             cancelCommandDeadline: null,
             cancelNoProgressDeadline: null,
             cancelAbsoluteDeadline: null,
         };
-        this.recoveries.set(runtime, recovery);
-        for (const sub of pane.subs) {
-            if (!sub.frozen && !sub.closed)
-                sub.feed.abortCurrent();
+        this.recoveries.set(pane.runtimeId, recovery);
+        this.snapshotQueue.set(pane.runtimeId, recovery);
+        this.drainSnapshots();
+    }
+    beginLocalOverflowRecovery(pane) {
+        this.beginRecovery(pane, "backpressure");
+    }
+    snapshotContext(pane) {
+        return {
+            paneId: pane.runtimeId,
+            incarnation: pane.incarnation,
+            layoutGeneration: pane.snapshotLayoutGeneration,
+            participants: [...pane.subs].filter((sub) => !sub.closed && !sub.frozen),
+        };
+    }
+    snapshotLeaseCurrent(lease) {
+        return (this.snapshotActive === lease && !lease.retired && this.recoveryPane(lease.recovery) !== null);
+    }
+    drainSnapshots() {
+        if (this.snapshotActive || this.disposed)
+            return;
+        for (const [runtime, recovery] of this.snapshotQueue) {
+            if (recovery.waitForSyncAfter !== undefined &&
+                this.completedSyncOrdinal <= recovery.waitForSyncAfter)
+                continue;
+            this.snapshotQueue.delete(runtime);
+            const pane = this.recoveryPane(recovery);
+            if (!pane || ![...pane.subs].some((sub) => !sub.closed && !sub.frozen)) {
+                this.cancelRecovery(runtime);
+                continue;
+            }
+            if (recovery.attempts >= RECOVERY_MAX_ATTEMPTS) {
+                this.failRecovery(recovery, "attempts-exhausted");
+                continue;
+            }
+            const lease = {
+                recovery,
+                retired: false,
+                wireNonce: null,
+                retry: false,
+                fencePending: false,
+                cancelFence: null,
+            };
+            this.snapshotActive = lease;
+            recovery.lease = lease;
+            if (!recovery.cancelAbsoluteDeadline) {
+                recovery.startedAtMs = this.recoveryNowMs();
+                this.beginRecoveryConvergence(recovery);
+            }
+            else
+                this.noteRecoveryProgress(recovery);
+            for (const sub of pane.subs)
+                if (!sub.closed && !sub.frozen)
+                    sub.feed.abortCurrent();
+            const target = this.nativeRecoveryTarget(pane);
+            if (recovery.nativeOwner &&
+                (target?.serverEpoch !== recovery.nativeOwner.serverEpoch ||
+                    target?.paneBirthId !== recovery.nativeOwner.paneBirthId)) {
+                this.failRecovery(recovery, "command-error");
+                return;
+            }
+            if (target) {
+                recovery.nativeOwner ??= target;
+                recovery.stock = undefined;
+                this.recoverNativeAtomic(pane, recovery, target);
+            }
+            else
+                this.startStockSnapshot(pane, recovery, lease);
+            return;
         }
-        this.observeRecovery(pane, recovery, "pause");
-        const nativeTarget = this.nativeRecoveryTarget(pane);
-        if (nativeTarget) {
-            this.beginRecoveryConvergence(recovery);
-            this.recoverNativeAtomic(pane, recovery, nativeTarget);
+    }
+    releaseSnapshotLease(lease) {
+        if (this.snapshotActive !== lease || lease.wireNonce || lease.fencePending)
+            return;
+        lease.cancelFence?.();
+        lease.cancelFence = null;
+        const pane = this.panesByRuntime.get(lease.recovery.runtimeId);
+        if (lease.ownsPause &&
+            pane?.incarnation === lease.recovery.paneIncarnation &&
+            pane.subs.size === 0 &&
+            !this.ledger.isRequested(pane.runtimeId)) {
+            this.io.commandInline(`refresh-client -A '${pane.runtimeId}:continue'`, () => { });
+            this.ledger.noteContinued(pane.runtimeId);
+        }
+        this.snapshotActive = null;
+        if (lease.recovery.lease === lease)
+            lease.recovery.lease = undefined;
+        if (lease.retry && this.recoveryPane(lease.recovery)) {
+            lease.recovery.stage = "queued";
+            this.snapshotQueue.set(lease.recovery.runtimeId, lease.recovery);
+        }
+        this.drainSnapshots();
+    }
+    retireSnapshotLease(lease, retry = false) {
+        if (this.snapshotActive !== lease)
+            return;
+        lease.retired = true;
+        if (this.disposed) {
+            lease.cancelFence?.();
+            lease.cancelFence = null;
+            this.snapshotActive = null;
+            this.snapshotQueue.clear();
             return;
         }
-        this.observeRecovery(pane, recovery, "continue-request");
-        recovery.cancelCommandDeadline = this.scheduleRecovery(() => {
-            if (this.recoveryPane(recovery) && !recovery.continueReply)
-                this.failRecovery(recovery, "command-timeout");
-        }, RECOVERY_COMMAND_DEADLINE_MS);
-        const queue = this.continueNotificationQueues.get(runtime) ?? [];
-        if (queue.length >= MAX_CONTINUE_NOTIFICATION_QUEUE) {
-            this.failRecovery(recovery, "notification-queue-overflow");
+        lease.retry ||= retry;
+        lease.recovery.stock?.invalidate();
+        lease.cleanup?.();
+        lease.cleanup = undefined;
+        lease.recovery.cancelCommandDeadline?.();
+        lease.recovery.cancelCommandDeadline = null;
+        if (lease.wireNonce) {
+            this.io.retireAtomicPaneSnapshotCollector?.(lease.wireNonce, "retired");
             return;
         }
-        queue.push({ kind: "owner", recovery });
-        this.continueNotificationQueues.set(runtime, queue);
-        this.io.send(`refresh-client -A '${runtime}:continue'`, (reply) => {
-            const current = this.recoveryPane(recovery);
-            if (!reply.ok) {
-                this.removeContinueNotificationOwner(recovery);
-                if (current)
-                    this.failRecovery(recovery, "command-error");
+        if (lease.fencePending)
+            return;
+        // Native wrapper/setup commands still own ordinary FIFO slots. A separate
+        // bounded command proves they drained before another raw hook is admitted.
+        lease.fencePending = true;
+        const token = `tmux-ide-snapshot-admission:${randomBytes(24).toString("hex")}`;
+        const failed = () => {
+            if (this.snapshotActive !== lease)
                 return;
-            }
-            recovery.continueReply = true;
-            if (!current) {
-                this.retireContinueNotificationOwner(recovery);
+            lease.retry = false;
+            lease.cancelFence?.();
+            void this.io.dispose();
+        };
+        lease.cancelFence = this.scheduleRecovery(failed, RECOVERY_ABSOLUTE_DEADLINE_MS);
+        const done = (reply) => {
+            if (this.snapshotActive !== lease)
+                return;
+            if (!reply.ok || reply.lines.length !== 1 || reply.lines[0] !== token) {
+                failed();
                 return;
             }
-            recovery.cancelCommandDeadline?.();
-            recovery.cancelCommandDeadline = null;
-            this.beginRecoveryConvergence(recovery);
-            this.observeRecovery(current, recovery, "continue-reply");
-            this.noteRecoveryProgress(recovery);
-            this.beginFinalRecovery(recovery);
-        });
+            lease.fencePending = false;
+            this.releaseSnapshotLease(lease);
+        };
+        if (this.io.commandBoundedInline)
+            this.io.commandBoundedInline(`display-message -p -l ${token}`, { maxBytes: 256, maxLines: 1 }, done);
+        else
+            this.io.commandInline(`display-message -p -l ${token}`, done);
     }
-    beginLocalOverflowRecovery(pane) {
+    awaitSnapshotLayout(recovery) {
+        recovery.cancelNoProgressDeadline?.();
+        recovery.cancelNoProgressDeadline = null;
+        recovery.waitForSyncAfter = this.syncOrdinal;
+        this.scheduleSync();
+    }
+    retrySnapshot(recovery) {
+        const pane = this.recoveryPane(recovery);
+        if (!pane)
+            return;
         for (const sub of pane.subs)
-            sub.cancelCapture?.();
-        const runtime = pane.runtimeId;
-        this.cancelRecovery(runtime);
-        const recovery = {
-            ordinal: ++this.recoveryOrdinal,
-            runtimeId: runtime,
-            paneIncarnation: pane.incarnation,
-            reason: "backpressure",
-            startedAtMs: this.recoveryNowMs(),
-            retired: false,
-            continueReply: true,
-            continueNotify: true,
-            stage: "continue",
-            attempts: 0,
-            reseedOrdinal: 0,
-            outputOrdinal: this.outputOrdinals.get(runtime) ?? 0,
-            candidateFingerprint: null,
-            confirmationFingerprint: null,
-            confirmationOrdinal: 0,
-            atomicCollectorNonce: null,
-            collectorStarted: false,
-            collectorLastCompletedOrdinal: -1,
-            collectorCaptureLineCount: 0,
-            collectorCaptureByteCount: 0,
-            collectorContinueObserved: false,
-            collectorStatusObserved: false,
-            collectorObserverEmissionObserved: false,
-            collectorFailureReason: null,
-            cancelQuiet: null,
-            cancelCommandDeadline: null,
-            cancelNoProgressDeadline: null,
-            cancelAbsoluteDeadline: null,
-        };
-        this.recoveries.set(runtime, recovery);
-        for (const sub of pane.subs) {
-            if (!sub.frozen && !sub.closed)
-                sub.onEvent({ type: "flow", state: "paused", reason: "backpressure" });
+            if (!sub.closed && !sub.frozen)
+                sub.feed.abortCurrent();
+        recovery.stock?.invalidate();
+        if (recovery.attempts >= RECOVERY_MAX_ATTEMPTS ||
+            (recovery.cancelAbsoluteDeadline &&
+                this.recoveryNowMs() - recovery.startedAtMs >= RECOVERY_ABSOLUTE_DEADLINE_MS)) {
+            this.failRecovery(recovery, "attempts-exhausted");
+            return;
+        }
+        if (recovery.lease)
+            this.retireSnapshotLease(recovery.lease, true);
+        else {
+            recovery.stage = "queued";
+            this.snapshotQueue.set(recovery.runtimeId, recovery);
+            this.drainSnapshots();
+        }
+    }
+    startStockSnapshot(pane, recovery, lease) {
+        if (!this.io.armAtomicPaneSnapshotCollector || !this.io.retireAtomicPaneSnapshotCollector) {
+            this.failRecovery(recovery, "command-error");
+            return;
+        }
+        if (!this.nativeBootstrapConfirmed &&
+            !this.nativeBootstrapUnavailable &&
+            [...pane.subs].some((sub) => !sub.closed && !sub.frozen && sub.nativeBootstrap)) {
+            // Negotiate the live server before placing -R in a NOHOOKS transaction:
+            // an unsupported flag aborts that hook before its completion sentinel.
+            recovery.nativeProbeAttempts = (recovery.nativeProbeAttempts ?? 0) + 1;
+            let marker = null;
+            let probeSettled = false;
+            recovery.cancelCommandDeadline = this.scheduleRecovery(() => {
+                if (probeSettled || !this.snapshotLeaseCurrent(lease))
+                    return;
+                probeSettled = true;
+                if ((recovery.nativeProbeAttempts ?? 0) < 2)
+                    this.retrySnapshot(recovery);
+                else
+                    this.failRecovery(recovery, "command-timeout");
+            }, RECOVERY_COMMAND_DEADLINE_MS);
+            this.captureWithViewer(pane.runtimeId, ["-R", "-S", "-"], (value) => {
+                marker = value;
+            }, (reply) => {
+                if (marker)
+                    this.retireInternalReadMarker(pane.runtimeId, marker);
+                if (probeSettled || !this.snapshotLeaseCurrent(lease))
+                    return;
+                probeSettled = true;
+                recovery.cancelCommandDeadline?.();
+                recovery.cancelCommandDeadline = null;
+                const native = reply.ok ? decodeNativeGridCapture(reply.lines.join("\n")) : null;
+                if (native && isNativeBootstrapCapture(native))
+                    this.nativeBootstrapConfirmed = true;
+                else if (nativeBootstrapUnsupported(reply.ok, reply.lines, native)) {
+                    this.nativeBootstrapUnavailable = true;
+                    for (const current of this.panesByRuntime.values())
+                        for (const sub of current.subs)
+                            sub.nativeBootstrap = false;
+                }
+                else {
+                    if ((recovery.nativeProbeAttempts ?? 0) < 2)
+                        this.retrySnapshot(recovery);
+                    else
+                        this.failRecovery(recovery, "command-error");
+                    return;
+                }
+                this.startStockSnapshot(pane, recovery, lease);
+            }, { maxBytes: RECOVERY_CAPTURE_MAX_BYTES, maxLines: RECOVERY_CAPTURE_MAX_LINES });
+            return;
+        }
+        recovery.attempts += 1;
+        recovery.stage = "stock-pause";
+        recovery.stock = new StockPaneSnapshot(this.snapshotContext(pane));
+        // These rows were received before this pause and belong to the new seed,
+        // never to a delayed old-geometry replay after it.
+        const pending = pane.windowRuntimeId
+            ? this.pendingLayoutOutput.get(pane.windowRuntimeId)
+            : null;
+        if (pending) {
+            pending.records = pending.records.filter((record) => record.pane !== pane.runtimeId);
+            pending.bytes = pending.records.reduce((bytes, record) => bytes + record.data.byteLength, 0);
         }
         this.observeRecovery(pane, recovery, "pause");
-        this.beginRecoveryConvergence(recovery);
-        const nativeTarget = this.nativeRecoveryTarget(pane);
-        if (nativeTarget)
-            this.recoverNativeAtomic(pane, recovery, nativeTarget);
-        else
-            this.beginFinalRecovery(recovery);
+        const nonce = randomBytes(24).toString("hex");
+        const hook = `@tmux_ide_pause_${nonce}`;
+        const body = `display-message -p -l '%tmux-ide-atomic-v1 ${nonce} start'` +
+            ` ; refresh-client -A '${pane.runtimeId}:pause'` +
+            ` ; display-message -p -l '%tmux-ide-atomic-v1 ${nonce} complete'`;
+        let settled = false;
+        let accepted = false;
+        const cleanup = () => this.io.commandListInline(`if-shell -t ${pane.runtimeId} -F ${tmuxSingleQuote(`#{==:#{${hook}},${body}}`)} ` +
+            `${tmuxSingleQuote(`set-option -pu -t ${pane.runtimeId} ${hook}`)} ` +
+            `${tmuxSingleQuote("display-message -p -l pause-cleanup-skipped")}`, 2, 1, () => { });
+        lease.cleanup = cleanup;
+        const failed = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            if (this.snapshotLeaseCurrent(lease))
+                this.retrySnapshot(recovery);
+        };
+        recovery.cancelCommandDeadline = this.scheduleRecovery(failed, RECOVERY_COMMAND_DEADLINE_MS);
+        this.input.flush();
+        this.io.commandInline(`set-option -po -t ${pane.runtimeId} ${hook} ${tmuxSingleQuote(body)}`, (reply) => {
+            if (settled || !this.snapshotLeaseCurrent(lease)) {
+                cleanup();
+                return;
+            }
+            if (!reply.ok) {
+                failed();
+                return;
+            }
+            lease.wireNonce = nonce;
+            const armed = this.io.armAtomicPaneSnapshotCollector({
+                nonce,
+                kind: "pause",
+                runtimePaneId: pane.runtimeId,
+                maxCaptureBytes: 1024,
+                maxCaptureLines: 16,
+                maxCursorBytes: 128,
+                observerCommandCount: 0,
+                onSettled: (result) => {
+                    cleanup();
+                    if (settled || !this.snapshotLeaseCurrent(lease))
+                        return;
+                    if (!result.ok) {
+                        failed();
+                        return;
+                    }
+                    // The authenticated NOHOOKS body targets the same live pane as
+                    // set-hook -Rp. A successful pause is a no-op only when already
+                    // paused; its complete guard therefore fences that case too.
+                    accepted = recovery.stock.observePause(this.snapshotContext(pane));
+                    if (!accepted) {
+                        failed();
+                        return;
+                    }
+                    lease.ownsPause = true;
+                    this.observedPaused.add(pane.runtimeId);
+                    this.ledger.notePause(pane.runtimeId);
+                    settled = true;
+                    recovery.cancelCommandDeadline?.();
+                    recovery.cancelCommandDeadline = null;
+                },
+                onDrained: (reason) => {
+                    if (lease.wireNonce === nonce)
+                        lease.wireNonce = null;
+                    if (reason === "channel-exit") {
+                        lease.retry = false;
+                        return;
+                    }
+                    if (!this.snapshotLeaseCurrent(lease) || !accepted) {
+                        this.releaseSnapshotLease(lease);
+                        return;
+                    }
+                    recovery.stage = "stock-capture";
+                    this.reseedRecoverySubscribersAtomic(pane, recovery, (result) => {
+                        if (!this.snapshotLeaseCurrent(lease))
+                            return;
+                        if (!result.ok || !result.publish())
+                            this.retrySnapshot(recovery);
+                        else
+                            this.convergeRecovery(pane, recovery);
+                    }, true);
+                },
+            }, Math.max(1, Math.floor(RECOVERY_ABSOLUTE_DEADLINE_MS - (this.recoveryNowMs() - recovery.startedAtMs))));
+            if (!armed) {
+                lease.wireNonce = null;
+                failed();
+                return;
+            }
+            // Once queued, this pause may execute even if its local callback is
+            // cancelled. Return the owned pause after drain when no viewer remains.
+            lease.ownsPause = true;
+            // The option value is immutable for this attempt; compare it before
+            // dispatch so another actor cannot replace the owned NOHOOKS body.
+            this.io.commandListInline(`if-shell -t ${pane.runtimeId} -F ${tmuxSingleQuote(`#{==:#{${hook}},${body}}`)} ` +
+                `${tmuxSingleQuote(`set-hook -Rp -t ${pane.runtimeId} ${hook}`)} ` +
+                `${tmuxSingleQuote("display-message -p -l pause-hook-rejected")}`, 2, 1, (result) => {
+                if (settled || !this.snapshotLeaseCurrent(lease))
+                    return;
+                if (!result.ok || result.lines.length)
+                    failed();
+            });
+        });
     }
     nativeRecoveryTarget(pane) {
         // Mixed/plain recovery requires an explicitly negotiated dual snapshot.
@@ -1536,7 +1540,8 @@ export class SessionChannel {
             : null;
     }
     recoverNativeAtomic(pane, recovery, target) {
-        if (this.recoveryPane(recovery) !== pane)
+        const lease = recovery.lease;
+        if (!lease || !this.snapshotLeaseCurrent(lease) || this.recoveryPane(recovery) !== pane)
             return;
         const currentTarget = this.nativeRecoveryTarget(pane);
         if (currentTarget?.serverEpoch !== target.serverEpoch ||
@@ -1558,6 +1563,7 @@ export class SessionChannel {
             const current = this.nativeRecoveryTarget(pane);
             const live = [...pane.subs].filter((sub) => !sub.closed && !sub.frozen);
             return (this.recoveryPane(recovery) === pane &&
+                this.snapshotLeaseCurrent(lease) &&
                 recovery.reseedOrdinal === ordinal &&
                 current?.serverEpoch === target.serverEpoch &&
                 current.paneBirthId === target.paneBirthId &&
@@ -1576,11 +1582,12 @@ export class SessionChannel {
                 sub.feed.abortCurrent();
             // A malformed/late reply may follow a committed resume. Every retry
             // explicitly pauses first; never fall through to stock capture.
-            this.armRecoveryQuiet(recovery, () => this.recoverNativeAtomic(pane, recovery, target));
+            this.retrySnapshot(recovery);
         };
         recovery.stage = "native-pause";
         recovery.cancelCommandDeadline = this.scheduleRecovery(failed, RECOVERY_COMMAND_DEADLINE_MS);
         this.input.flush();
+        lease.ownsPause = true;
         this.io.commandInline(`refresh-client -A '${pane.runtimeId}:pause'`, (pauseReply) => {
             if (settled || !exact()) {
                 failed();
@@ -1620,12 +1627,23 @@ export class SessionChannel {
                     failed();
                     return;
                 }
+                const probe = parseCursorProbe(result.cursorLine);
+                const size = this.layoutCaptureSizeFor(participants[0].sub);
+                if (!probe ||
+                    probe.y >= probe.rows ||
+                    result.capture.cols !== probe.cols ||
+                    result.capture.rows !== probe.rows) {
+                    failed();
+                    return;
+                }
+                if ((pane.windowRuntimeId !== null && this.pendingLayoutOutput.has(pane.windowRuntimeId)) ||
+                    (size && (size.cols !== probe.cols || size.rows !== probe.rows))) {
+                    this.awaitSnapshotLayout(recovery);
+                    failed();
+                    return;
+                }
                 this.nativeBootstrapConfirmed = true;
-                this.observeScrollOnClear(pane, result.cursorLine);
-                // The selected child reply owns its inline %continue. It adds no
-                // asynchronous notification debt to the legacy continue queue.
-                recovery.continueReply = true;
-                recovery.continueNotify = true;
+                this.observeSnapshotMetadata(pane, result.cursorLine);
                 const ansiLines = result.ansiCapture
                     ? captureLinesFromAnsiBytes(result.ansiCapture)
                     : null;
@@ -1681,10 +1699,13 @@ export class SessionChannel {
         if (!this.recoveryPane(recovery) || !recovery.cancelAbsoluteDeadline)
             return;
         recovery.cancelNoProgressDeadline?.();
-        recovery.cancelNoProgressDeadline = this.scheduleRecovery(() => {
+        const cancel = this.scheduleRecovery(() => {
+            if (recovery.cancelNoProgressDeadline !== cancel)
+                return;
             if (this.recoveryPane(recovery))
                 this.failRecovery(recovery, "no-progress");
         }, RECOVERY_NO_PROGRESS_DEADLINE_MS);
+        recovery.cancelNoProgressDeadline = cancel;
     }
     noteAtomicCollectorProgress(recovery, nonce, progress) {
         if (this.recoveryPane(recovery) === null ||
@@ -1700,150 +1721,21 @@ export class SessionChannel {
         recovery.collectorObserverEmissionObserved ||= progress.observerEmissionObserved;
         this.noteRecoveryProgress(recovery);
     }
-    reseedRecoverySubscribers(pane, recovery, done, deferPublish = false) {
-        if (this.io.armAtomicPaneSnapshotCollector && this.io.retireAtomicPaneSnapshotCollector) {
-            this.reseedRecoverySubscribersAtomic(pane, recovery, done, deferPublish);
-            return;
-        }
-        const live = [...pane.subs].filter((sub) => !sub.frozen && !sub.closed);
-        if (live.length === 0) {
+    reseedRecoverySubscribersAtomic(pane, recovery, done, deferPublish) {
+        const lease = recovery.lease;
+        const stock = recovery.stock;
+        if (!lease || !stock || !this.snapshotLeaseCurrent(lease)) {
             done(FAILED_RESEED_RESULT);
             return;
         }
-        const participants = live.map((sub) => Object.freeze({ sub, epoch: sub.feed.beginReseed() }));
-        const nativeCapture = !this.nativeBootstrapUnavailable && participants.every(({ sub }) => sub.nativeBootstrap);
-        const reseedOrdinal = ++recovery.reseedOrdinal;
-        let settled = false;
-        let captureSucceeded = false;
-        let markerRetired = false;
-        let captureLines = null;
-        // One pane authority capture is enough for every subscriber. Per-feed
-        // epochs still independently fence delivery, while membership is frozen
-        // across both FIFO replies so no subscriber can join half a snapshot.
-        this.input.flush();
-        const history = this.opts.historyLines ?? "";
-        let internalReadMarker = null;
-        const participantsExact = () => {
-            if (this.recoveryPane(recovery) !== pane ||
-                recovery.reseedOrdinal !== reseedOrdinal ||
-                participants.some(({ sub }) => sub.closed || sub.frozen || sub.pane !== pane || !pane.subs.has(sub)))
-                return false;
-            const current = [...pane.subs].filter((sub) => !sub.frozen && !sub.closed);
-            return (current.length === participants.length &&
-                current.every((sub) => participants.some((participant) => participant.sub === sub)));
-        };
-        const retireMarker = () => {
-            if (markerRetired)
-                return;
-            markerRetired = true;
-            if (internalReadMarker)
-                this.retireInternalReadMarker(pane.runtimeId, internalReadMarker);
-        };
-        const fail = () => {
-            if (settled)
-                return;
-            settled = true;
-            if (!captureSucceeded)
-                retireMarker();
-            for (const { sub } of participants)
-                sub.feed.abortCurrent();
-            done(FAILED_RESEED_RESULT);
-        };
-        this.captureWithViewer(pane.runtimeId, [...(nativeCapture ? ["-R"] : ["-e", "-J"]), "-S", `-${history}`], (marker) => {
-            internalReadMarker = marker;
-        }, (reply) => {
-            if (!reply.ok) {
-                if (nativeCapture && nativeBootstrapUnsupported(false, reply.lines, null)) {
-                    this.nativeBootstrapUnavailable = true;
-                    for (const { sub } of participants)
-                        sub.nativeBootstrap = false;
-                }
-                fail();
-                return;
-            }
-            captureSucceeded = true;
-            if (!participantsExact()) {
-                fail();
-                return;
-            }
-            captureLines = Object.freeze([...reply.lines]);
-            const native = nativeCapture ? decodeNativeGridCapture(captureLines.join("\n")) : null;
-            if (nativeCapture && (!native || !isNativeBootstrapCapture(native))) {
-                if (nativeBootstrapUnsupported(true, captureLines, native)) {
-                    this.nativeBootstrapUnavailable = true;
-                    for (const { sub } of participants)
-                        sub.nativeBootstrap = false;
-                }
-                fail();
-                return;
-            }
-            if (native)
-                this.nativeBootstrapConfirmed = true;
-            for (const { sub, epoch } of participants) {
-                if (native)
-                    sub.feed.captureNativeReply(epoch, native);
-                else
-                    sub.feed.captureReply(epoch, captureLines);
-            }
-        });
-        this.io.commandInline(`display-message -p -t ${pane.runtimeId} "${RECOVERY_CURSOR_PROBE_FORMAT}"`, (reply) => {
-            if (settled)
-                return;
-            if (!participantsExact() || captureLines === null || !reply.ok) {
-                fail();
-                return;
-            }
-            const cursorLine = reply.lines[0] ?? "";
-            const fallbackSize = this.layoutSizeFor(pane.runtimeId);
-            this.observeScrollOnClear(pane, cursorLine);
-            const deliveries = participants.map(({ sub, epoch }) => ({
-                sub,
-                epoch,
-                events: sub.feed
-                    .cursorReply(epoch, cursorLine, fallbackSize)
-                    .map((event) => event.type === "seed" && sub.nativeBootstrap && !nativeCapture
-                    ? { ...event, requiresNativeRecapture: true }
-                    : event),
-            }));
-            if (!participantsExact() || deliveries.some(({ events }) => events.length === 0)) {
-                fail();
-                return;
-            }
-            let published = false;
-            const publish = () => {
-                if (published)
-                    return true;
-                if (!participantsExact())
-                    return false;
-                published = true;
-                for (const { sub, events } of deliveries)
-                    for (const event of events)
-                        sub.onEvent(event);
-                return participantsExact();
-            };
-            if (!deferPublish && !publish()) {
-                fail();
-                return;
-            }
-            for (const { sub, epoch } of deliveries)
-                sub.feed.quarantine(epoch);
-            settled = true;
-            done({
-                ok: true,
-                fingerprint: snapshotFingerprint(captureLines, cursorLine, fallbackSize),
-                publish,
-                hold: () => { },
-            });
-        });
-    }
-    reseedRecoverySubscribersAtomic(pane, recovery, done, deferPublish) {
         const live = [...pane.subs].filter((sub) => !sub.frozen && !sub.closed);
         if (live.length === 0) {
             done(FAILED_RESEED_RESULT);
             return;
         }
         const participants = live.map((sub) => Object.freeze({ sub, epoch: sub.feed.beginReseed() }));
-        const nativeCapture = !this.nativeBootstrapUnavailable && participants.every(({ sub }) => sub.nativeBootstrap);
+        const nativeCapture = !this.nativeBootstrapUnavailable && participants.some(({ sub }) => sub.nativeBootstrap);
+        const dualCapture = nativeCapture && participants.some(({ sub }) => !sub.nativeBootstrap);
         const reseedOrdinal = ++recovery.reseedOrdinal;
         const nonce = this.opts.generateAtomicHookNonce?.() ?? randomBytes(24).toString("hex");
         if (!/^[0-9a-f]{32,128}$/u.test(nonce)) {
@@ -1867,6 +1759,7 @@ export class SessionChannel {
         recovery.collectorFailureReason = null;
         const participantsExact = () => {
             if (this.recoveryPane(recovery) !== pane ||
+                !this.snapshotLeaseCurrent(lease) ||
                 recovery.reseedOrdinal !== reseedOrdinal ||
                 participants.some(({ sub }) => sub.closed || sub.frozen || sub.pane !== pane || !pane.subs.has(sub)))
                 return false;
@@ -1889,6 +1782,7 @@ export class SessionChannel {
                 tmuxSingleQuote(`set-option -pu -t ${pane.runtimeId} ${ownerName}`) +
                 ` ${tmuxSingleQuote(`display-message -p -t ${pane.runtimeId} tmux-ide-atomic-cleanup-owner-skip-v1:${nonce}`)}`, 2, 1, () => { });
         };
+        lease.cleanup = cleanupHook;
         const fail = (statusObserved = false) => {
             if (settled)
                 return;
@@ -1910,21 +1804,27 @@ export class SessionChannel {
             fail();
             return;
         }
+        const observerRequired = this.opts.internalReadHookEmission !== undefined;
         const safeObserver = observer !== null &&
             /^[A-Za-z0-9._-]{1,256}$/u.test(observer.bufferName) &&
             /^[A-Za-z0-9._-]{1,256}$/u.test(observer.signalChannel) &&
             /^[A-Za-z0-9%:._|-]{1,1024}$/u.test(observer.record);
-        if (!safeObserver) {
+        if (observerRequired && !safeObserver) {
             fail();
             return;
         }
         const sentinel = (kind) => `display-message -p -l -t ${pane.runtimeId} ` + `"%tmux-ide-atomic-v1 ${nonce} ${kind}"`;
-        const observerCommands = ` ; ${boundedTmuxInteractionAppendCommand(observer.bufferName, observer.record)}` +
-            ` ; wait-for -S ${observer.signalChannel}`;
+        const observerCommands = safeObserver
+            ? ` ; ${boundedTmuxInteractionAppendCommand(observer.bufferName, observer.record)}` +
+                ` ; wait-for -S ${observer.signalChannel}`
+            : "";
         const body = `set-option -po -t ${pane.runtimeId} ${INTERNAL_READ_OPERATION_OPTION} ${internalReadMarker}` +
             ` ; ${sentinel("start")}` +
             ` ; capture-pane -p ${nativeCapture ? "-R" : "-e -J"} -S -${this.opts.historyLines ?? ""} -t ${pane.runtimeId}` +
             ` ; ${sentinel("capture-end")}` +
+            (dualCapture
+                ? ` ; capture-pane -p -e -J -S -${this.opts.historyLines ?? ""} -t ${pane.runtimeId} ; ${sentinel("ansi-capture-end")}`
+                : "") +
             ` ; display-message -p -t ${pane.runtimeId} "${RECOVERY_CURSOR_PROBE_FORMAT}"` +
             ` ; ${sentinel("cursor-end")}` +
             ` ; refresh-client -A ${tmuxSingleQuote(`${pane.runtimeId}:continue`)}` +
@@ -1938,6 +1838,10 @@ export class SessionChannel {
             ` ; ${sentinel("complete")}`;
         this.input.flush();
         const invoke = (reply) => {
+            if (settled || !this.snapshotLeaseCurrent(lease)) {
+                cleanupHook();
+                return;
+            }
             if (!reply.ok || !participantsExact()) {
                 fail();
                 return;
@@ -1947,13 +1851,25 @@ export class SessionChannel {
                 fail();
                 return;
             }
+            lease.wireNonce = nonce;
+            this.observedPaused.delete(pane.runtimeId);
             const armed = this.io.armAtomicPaneSnapshotCollector({
                 nonce,
                 runtimePaneId: pane.runtimeId,
                 maxCaptureBytes: RECOVERY_CAPTURE_MAX_BYTES,
                 maxCaptureLines: RECOVERY_CAPTURE_MAX_LINES,
                 maxCursorBytes: RECOVERY_CURSOR_MAX_BYTES,
-                observerCommandCount: 2,
+                observerCommandCount: safeObserver ? 2 : 0,
+                dualCapture,
+                onDrained: (reason) => {
+                    if (lease.wireNonce === nonce)
+                        lease.wireNonce = null;
+                    if (reason === "channel-exit") {
+                        lease.retry = false;
+                        return;
+                    }
+                    this.releaseSnapshotLease(lease);
+                },
                 onProgress: (progress) => this.noteAtomicCollectorProgress(recovery, nonce, progress),
                 onSettled: (result) => {
                     if (recovery.atomicCollectorNonce === nonce)
@@ -1985,16 +1901,35 @@ export class SessionChannel {
                         fail(result.statusObserved);
                         return;
                     }
+                    if (dualCapture && !result.ansiCaptureLines) {
+                        fail(result.statusObserved);
+                        return;
+                    }
                     if (native)
                         this.nativeBootstrapConfirmed = true;
                     for (const { sub, epoch } of participants) {
-                        if (native)
+                        if (native && sub.nativeBootstrap)
                             sub.feed.captureNativeReply(epoch, native);
                         else
-                            sub.feed.captureReply(epoch, captureLines);
+                            sub.feed.captureReply(epoch, result.ansiCaptureLines ?? captureLines);
+                    }
+                    const probe = parseCursorProbe(result.cursorLine);
+                    const layoutSize = this.layoutCaptureSizeFor(participants[0].sub);
+                    const pendingLayout = pane.windowRuntimeId !== null && this.pendingLayoutOutput.has(pane.windowRuntimeId);
+                    if (!probe ||
+                        probe.y >= probe.rows ||
+                        (native && (native.cols !== probe.cols || native.rows !== probe.rows))) {
+                        fail(result.statusObserved);
+                        return;
+                    }
+                    if (pendingLayout ||
+                        (layoutSize && (layoutSize.cols !== probe.cols || layoutSize.rows !== probe.rows))) {
+                        this.awaitSnapshotLayout(recovery);
+                        fail(result.statusObserved);
+                        return;
                     }
                     const fallbackSize = this.layoutSizeFor(pane.runtimeId);
-                    this.observeScrollOnClear(pane, result.cursorLine);
+                    this.observeSnapshotMetadata(pane, result.cursorLine);
                     const deliveries = participants.map(({ sub, epoch }) => ({
                         sub,
                         epoch,
@@ -2014,28 +1949,28 @@ export class SessionChannel {
                             return true;
                         if (!participantsExact())
                             return false;
-                        published = true;
-                        for (const { sub, events } of deliveries)
-                            for (const event of events)
-                                sub.onEvent(event);
-                        return participantsExact();
+                        published = stock.publish(deliveries.map(({ sub, events }) => ({ participant: sub, events })), () => {
+                            if (!participantsExact())
+                                throw new Error("snapshot lease retired");
+                            return this.snapshotContext(pane);
+                        }, (participant, event) => participant.onEvent(event));
+                        return published && participantsExact();
                     };
                     if (!deferPublish && !publish()) {
                         fail(true);
                         return;
                     }
-                    for (const { sub, epoch } of deliveries)
-                        sub.feed.quarantine(epoch);
                     settled = true;
                     done({
                         ok: true,
-                        fingerprint: snapshotFingerprint(captureLines, result.cursorLine, fallbackSize),
+                        fingerprint: null,
                         publish,
                         hold: () => { },
                     });
                 },
             }, remaining);
             if (!armed) {
+                lease.wireNonce = null;
                 fail();
                 return;
             }
@@ -2053,11 +1988,19 @@ export class SessionChannel {
         // ambiguity: every accepted step has its own ordered reply and any later
         // failure can conditionally retire exactly the already-created prefix.
         this.io.commandInline(`set-option -po -t ${pane.runtimeId} ${ownerName} ${nonce}`, (ownerReply) => {
+            if (settled || !this.snapshotLeaseCurrent(lease)) {
+                cleanupHook();
+                return;
+            }
             if (!ownerReply.ok || !participantsExact()) {
                 fail();
                 return;
             }
             this.io.commandInline(`set-option -po -t ${pane.runtimeId} ${expectedName} ${tmuxSingleQuote(body)}`, (expectedReply) => {
+                if (settled || !this.snapshotLeaseCurrent(lease)) {
+                    cleanupHook();
+                    return;
+                }
                 if (!expectedReply.ok || !participantsExact()) {
                     fail();
                     return;
@@ -2066,113 +2009,6 @@ export class SessionChannel {
             });
         });
     }
-    armRecoveryQuiet(recovery, callback) {
-        recovery.cancelQuiet?.();
-        recovery.cancelQuiet = this.scheduleRecovery(() => {
-            recovery.cancelQuiet = null;
-            if (this.recoveryPane(recovery))
-                callback();
-        }, RECOVERY_QUIET_MS);
-    }
-    beginFinalRecovery(recovery) {
-        const pane = this.recoveryPane(recovery);
-        if (!pane)
-            return;
-        if (recovery.attempts >= RECOVERY_MAX_ATTEMPTS) {
-            this.failRecovery(recovery, "attempts-exhausted");
-            return;
-        }
-        recovery.attempts += 1;
-        recovery.stage = "final";
-        this.noteRecoveryProgress(recovery);
-        // The final read is only a private candidate. Publishing it here can put
-        // expensive replica projection ahead of the confirmation timers and, more
-        // importantly, exposes a snapshot that has not yet survived the two-read
-        // authority proof.
-        this.reseedRecoverySubscribers(pane, recovery, ({ ok, fingerprint }) => {
-            const current = this.recoveryPane(recovery);
-            if (!current)
-                return;
-            if (!ok || fingerprint === null) {
-                this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-                return;
-            }
-            recovery.outputOrdinal = this.outputOrdinals.get(recovery.runtimeId) ?? 0;
-            recovery.candidateFingerprint = fingerprint;
-            recovery.confirmationFingerprint = null;
-            recovery.confirmationOrdinal = 0;
-            recovery.stage = "confirm";
-            this.observeRecovery(current, recovery, "final-reseed");
-            this.noteRecoveryProgress(recovery);
-            this.armRecoveryQuiet(recovery, () => this.confirmRecovery(recovery));
-        }, true);
-    }
-    confirmRecovery(recovery) {
-        const pane = this.recoveryPane(recovery);
-        if (!pane)
-            return;
-        if ((this.outputOrdinals.get(recovery.runtimeId) ?? 0) !== recovery.outputOrdinal) {
-            this.beginFinalRecovery(recovery);
-            return;
-        }
-        recovery.stage = "final";
-        this.noteRecoveryProgress(recovery);
-        this.reseedRecoverySubscribers(pane, recovery, ({ ok, fingerprint, publish }) => {
-            const current = this.recoveryPane(recovery);
-            if (!current)
-                return;
-            if (!ok || fingerprint === null) {
-                this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-                return;
-            }
-            const outputOrdinal = this.outputOrdinals.get(recovery.runtimeId) ?? 0;
-            const ordinalExact = outputOrdinal === recovery.outputOrdinal;
-            const candidateExact = ordinalExact && fingerprint === recovery.candidateFingerprint;
-            const consecutiveExact = candidateExact &&
-                recovery.confirmationFingerprint !== null &&
-                fingerprint === recovery.confirmationFingerprint;
-            recovery.confirmationOrdinal += 1;
-            this.observeRecovery(current, recovery, "confirmation-reseed", null, consecutiveExact);
-            this.noteRecoveryProgress(recovery);
-            if (!ordinalExact) {
-                recovery.stage = "confirm";
-                this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-                return;
-            }
-            if (!candidateExact) {
-                if (recovery.attempts >= RECOVERY_MAX_ATTEMPTS) {
-                    this.failRecovery(recovery, "attempts-exhausted");
-                    return;
-                }
-                // A changed confirmation replaces the private candidate without
-                // becoming observable. Two subsequent reads must confirm this truth.
-                recovery.attempts += 1;
-                recovery.candidateFingerprint = fingerprint;
-                recovery.confirmationFingerprint = null;
-                recovery.outputOrdinal = outputOrdinal;
-                recovery.stage = "confirm";
-                this.armRecoveryQuiet(recovery, () => this.confirmRecovery(recovery));
-                return;
-            }
-            if (!consecutiveExact) {
-                recovery.confirmationFingerprint = fingerprint;
-                recovery.outputOrdinal = outputOrdinal;
-                recovery.stage = "confirm";
-                this.armRecoveryQuiet(recovery, () => this.confirmRecovery(recovery));
-                return;
-            }
-            // This publisher belongs to the current second matching read, not the
-            // older candidate. Publish exactly once while every participant is
-            // still fenced, then synchronously retire recovery before downstream
-            // projection work can run.
-            if (!publish()) {
-                recovery.stage = "confirm";
-                this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-                return;
-            }
-            this.convergeRecovery(current, recovery);
-        }, true);
-    }
     convergeRecovery(pane, recovery) {
         recovery.cancelCommandDeadline?.();
         recovery.cancelCommandDeadline = null;
@@ -2182,45 +2018,35 @@ export class SessionChannel {
         recovery.cancelAbsoluteDeadline = null;
         this.recoveries.delete(recovery.runtimeId);
         recovery.retired = true;
-        this.retireContinueNotificationOwner(recovery);
         this.ledger.noteContinued(recovery.runtimeId);
         if (recovery.reason === "requested")
             this.ledger.clearRequest(recovery.runtimeId);
         for (const sub of pane.subs) {
             if (!sub.frozen && !sub.closed) {
                 sub.feed.releaseQuarantine();
-                sub.onEvent({ type: "flow", state: "resumed", reason: recovery.reason });
+                try {
+                    sub.onEvent({ type: "flow", state: "resumed", reason: recovery.reason });
+                }
+                catch {
+                    // A consumer cannot strand shared snapshot admission for other panes.
+                }
             }
         }
-        this.observeRecovery(pane, recovery, "converged", null, true);
-    }
-    noteRecoveryOutput(pane, outputOrdinal) {
-        const recovery = this.recoveries.get(pane.runtimeId);
-        if (!recovery || recovery.paneIncarnation !== pane.incarnation)
-            return;
-        recovery.outputOrdinal = outputOrdinal;
-        if (recovery.continueReply)
-            this.noteRecoveryProgress(recovery);
-        if (recovery.stage === "quiet")
-            this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-        else if (recovery.stage === "confirm")
-            this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
+        this.observeRecovery(pane, recovery, "converged", null);
+        if (recovery.lease)
+            this.retireSnapshotLease(recovery.lease);
     }
     restartRecoveryAfterOutputOverflow(pane) {
         const recovery = this.recoveries.get(pane.runtimeId);
-        if (recovery?.paneIncarnation === pane.incarnation) {
-            if (recovery.stage === "quiet" || recovery.stage === "confirm")
-                this.armRecoveryQuiet(recovery, () => this.beginFinalRecovery(recovery));
-            return;
-        }
-        this.beginLocalOverflowRecovery(pane);
+        if (recovery)
+            this.retrySnapshot(recovery);
+        else
+            this.beginLocalOverflowRecovery(pane);
     }
     failRecovery(recovery, failureReason) {
         const pane = this.recoveryPane(recovery);
         if (!pane)
             return;
-        recovery.cancelQuiet?.();
-        recovery.cancelQuiet = null;
         recovery.cancelCommandDeadline?.();
         recovery.cancelCommandDeadline = null;
         recovery.cancelNoProgressDeadline?.();
@@ -2228,14 +2054,16 @@ export class SessionChannel {
         recovery.cancelAbsoluteDeadline?.();
         recovery.cancelAbsoluteDeadline = null;
         recovery.retired = true;
+        this.snapshotQueue.delete(recovery.runtimeId);
+        this.recoveries.delete(recovery.runtimeId);
+        for (const sub of pane.subs)
+            sub.feed.abortCurrent();
+        if (recovery.lease)
+            this.retireSnapshotLease(recovery.lease);
         const collectorNonce = recovery.atomicCollectorNonce;
         recovery.atomicCollectorNonce = null;
         if (collectorNonce)
             this.io.retireAtomicPaneSnapshotCollector?.(collectorNonce, "retired");
-        this.recoveries.delete(recovery.runtimeId);
-        this.retireContinueNotificationOwner(recovery);
-        for (const sub of pane.subs)
-            sub.feed.abortCurrent();
         this.observeRecovery(pane, recovery, "nonconverged", failureReason);
         for (const sub of pane.subs) {
             sub.cancelCapture?.();
@@ -2249,50 +2077,6 @@ export class SessionChannel {
             }
         }
     }
-    removeContinueNotificationOwner(recovery) {
-        const queue = this.continueNotificationQueues.get(recovery.runtimeId);
-        if (!queue)
-            return;
-        const index = queue.findIndex((entry) => entry.kind === "owner" && entry.recovery === recovery);
-        if (index < 0)
-            return;
-        queue.splice(index, 1);
-        this.compactContinueNotificationQueue(recovery.runtimeId, queue);
-    }
-    retireContinueNotificationOwner(recovery) {
-        if (!recovery.continueReply)
-            return;
-        const queue = this.continueNotificationQueues.get(recovery.runtimeId);
-        if (!queue)
-            return;
-        const index = queue.findIndex((entry) => entry.kind === "owner" && entry.recovery === recovery);
-        if (index < 0)
-            return;
-        queue.splice(index, 1, { kind: "debt", count: 1, saturated: false });
-        this.compactContinueNotificationQueue(recovery.runtimeId, queue);
-    }
-    compactContinueNotificationQueue(runtime, queue) {
-        for (let index = 1; index < queue.length;) {
-            const previous = queue[index - 1];
-            const current = queue[index];
-            if (previous?.kind !== "debt" || current?.kind !== "debt") {
-                index += 1;
-                continue;
-            }
-            const total = previous.count + current.count;
-            previous.count = Math.min(total, MAX_CONTINUE_NOTIFICATION_DEBT);
-            previous.saturated =
-                previous.saturated || current.saturated || total > MAX_CONTINUE_NOTIFICATION_DEBT;
-            queue.splice(index, 1);
-        }
-        if (queue.length === 0)
-            this.continueNotificationQueues.delete(runtime);
-        else
-            this.continueNotificationQueues.set(runtime, queue);
-    }
-    /** Continue + reseed EVERY backpressure-paused pane that still has an
-     *  unfrozen subscriber. %pause is sticky and hits quiet panes after any
-     *  stall — recovering only the noisy pane leaves siblings dark. */
     recoverSticky() {
         for (const runtime of this.ledger.stickyRecoverySet()) {
             if (this.recoveries.has(runtime))
@@ -2311,6 +2095,10 @@ export class SessionChannel {
         sub.cancelCapture?.();
         const pane = sub.pane;
         pane.subs.delete(sub);
+        const activeRecovery = this.recoveries.get(pane.runtimeId);
+        if (activeRecovery &&
+            [...pane.subs].some((candidate) => !candidate.closed && !candidate.frozen))
+            this.retrySnapshot(activeRecovery);
         if ([...pane.subs].every((candidate) => candidate.closed || candidate.frozen))
             this.cancelRecovery(pane.runtimeId);
         // Ticket return on departure: a pane parked by a now-gone subscriber must
@@ -2321,8 +2109,12 @@ export class SessionChannel {
         }
     }
     // ── Notifications (channel order is the invariant) ──────────────────────
-    observeScrollOnClear(pane, cursorLine) {
-        const value = cursorLine.trim().split(/\s+/)[22];
+    observeSnapshotMetadata(pane, cursorLine) {
+        const fields = cursorLine.trim().split(/\s+/);
+        const historySize = Number(fields[14]);
+        if (Number.isSafeInteger(historySize) && historySize >= 0)
+            pane.historySize = historySize;
+        const value = fields[22];
         pane.scrollOnClear = value === "0" || value === "1" ? value === "1" : undefined;
     }
     onNotify(name, rest) {
@@ -2368,9 +2160,16 @@ export class SessionChannel {
                 return;
             }
         }
-        if (name === "subscription-changed" &&
-            (/^tmux-ide-pane-borders\s+\$[0-9]+\s+@[0-9]+\s+[0-9]+\s+-\s*:\s*(top|bottom|off)\s*$/u.test(rest) ||
-                /^tmux-ide-copy-keys\s+\$[0-9]+\s+@[0-9]+\s+[0-9]+\s+-\s*:\s*(emacs|vi)\s*$/u.test(rest))) {
+        const windowOptionHint = name === "subscription-changed"
+            ? (/^tmux-ide-pane-borders\s+\$[0-9]+\s+(@[0-9]+)\s+[0-9]+\s+-\s*:\s*(?:top|bottom|off)\s*$/u.exec(rest) ??
+                /^tmux-ide-copy-keys\s+\$[0-9]+\s+(@[0-9]+)\s+[0-9]+\s+-\s*:\s*(?:emacs|vi)\s*$/u.exec(rest))
+            : null;
+        if (windowOptionHint) {
+            // Initial option samples from sibling windows are not evidence that this
+            // pane's capture context changed. Unknown membership stays conservative.
+            for (const pane of this.panesByRuntime.values())
+                if (!pane.windowRuntimeId || pane.windowRuntimeId === windowOptionHint[1])
+                    pane.snapshotLayoutGeneration += 1;
             this.windowAuthorityOrdinal += 1;
             this.windowIdentityOrdinal += 1;
             this.scheduleSync();
@@ -2381,6 +2180,9 @@ export class SessionChannel {
             name === "session-window-changed" ||
             STRUCTURAL_NOTIFICATIONS.has(name)) {
             this.windowAuthorityOrdinal += 1;
+            // Structural and layout notifications remain conservative across all panes.
+            for (const pane of this.panesByRuntime.values())
+                pane.snapshotLayoutGeneration += 1;
             if (name !== "layout-change")
                 this.windowIdentityOrdinal += 1;
         }
@@ -2395,8 +2197,19 @@ export class SessionChannel {
             const runtime = rest.trim().split(/\s+/)[0] ?? "";
             if (!runtime.startsWith("%"))
                 return;
-            if (this.recoveries.get(runtime)?.stage === "native-pause") {
+            this.observedPaused.add(runtime);
+            const stockRecovery = this.recoveries.get(runtime);
+            if (stockRecovery?.stock && stockRecovery.lease) {
+                this.ledger.notePause(runtime);
+                if (stockRecovery.stage !== "stock-pause")
+                    this.retrySnapshot(stockRecovery);
+                return;
+            }
+            const nativeRecovery = this.recoveries.get(runtime);
+            if (nativeRecovery) {
                 this.ledger.notePause(runtime);
+                if (nativeRecovery.stage !== "native-pause" && nativeRecovery.stage !== "queued")
+                    this.retrySnapshot(nativeRecovery);
                 return;
             }
             this.cancelRecovery(runtime);
@@ -2414,28 +2227,7 @@ export class SessionChannel {
         }
         if (name === "continue") {
             const runtime = rest.trim().split(/\s+/)[0] ?? "";
-            if (runtime.startsWith("%")) {
-                const queue = this.continueNotificationQueues.get(runtime);
-                const entry = queue?.[0] ?? null;
-                if (entry?.kind === "debt") {
-                    if (!entry.saturated) {
-                        entry.count -= 1;
-                        if (entry.count === 0)
-                            queue.shift();
-                    }
-                    this.compactContinueNotificationQueue(runtime, queue);
-                }
-                else if (entry?.kind === "owner") {
-                    queue.shift();
-                    this.compactContinueNotificationQueue(runtime, queue);
-                    const owner = entry.recovery;
-                    const pane = this.recoveryPane(owner);
-                    owner.continueNotify = true;
-                    if (pane) {
-                        this.observeRecovery(pane, owner, "continue-notify");
-                    }
-                }
-            }
+            this.observedPaused.delete(runtime);
             return;
         }
         if (name === "layout-change") {
@@ -2451,6 +2243,15 @@ export class SessionChannel {
                 return;
             }
             this.layoutNotificationOrdinals.set(change.windowId, this.windowAuthorityOrdinal);
+            for (const pane of this.panesByRuntime.values()) {
+                if (pane.windowRuntimeId !== change.windowId)
+                    continue;
+                const recovery = this.recoveries.get(pane.runtimeId);
+                if (recovery?.lease && !recovery.lease.retired) {
+                    this.awaitSnapshotLayout(recovery);
+                    this.retrySnapshot(recovery);
+                }
+            }
             const pendingLayout = {
                 ...parsed,
                 zoomed: change.zoomed,
@@ -2752,6 +2553,8 @@ export class SessionChannel {
             for (const sub of pane.subs)
                 sub.resumeLayoutCapture?.(syncOrdinal);
         }
+        this.completedSyncOrdinal = Math.max(this.completedSyncOrdinal, syncOrdinal);
+        this.drainSnapshots();
         this.discovery.discover(listed);
     }
     applyPaneTruth(truth) {
@@ -2777,11 +2580,12 @@ export class SessionChannel {
                 const nextWindowRuntimeId = this.truthWindow.get(runtime) ?? pane.windowRuntimeId;
                 if (nextWindowRuntimeId !== pane.windowRuntimeId && nextWindowRuntimeId !== null)
                     movedWindowRuntimeIds.add(nextWindowRuntimeId);
+                if (pane.windowRuntimeId !== nextWindowRuntimeId)
+                    pane.snapshotLayoutGeneration += 1;
                 pane.windowRuntimeId = nextWindowRuntimeId;
                 continue;
             }
             this.cancelRecovery(runtime);
-            this.continueNotificationQueues.delete(runtime);
             this.panesByRuntime.delete(runtime);
             this.outputOrdinals.delete(runtime);
             this.panesBySemantic.delete(pane.semanticId);
@@ -2791,7 +2595,12 @@ export class SessionChannel {
                 if (!sub.closed) {
                     sub.closed = true;
                     sub.cancelCapture?.();
-                    sub.onEvent({ type: "closed" });
+                    try {
+                        sub.onEvent({ type: "closed" });
+                    }
+                    catch {
+                        // Close every sibling and the transport even if a consumer throws.
+                    }
                 }
             }
             pane.subs.clear();
@@ -3292,7 +3101,6 @@ export class SessionChannel {
                 // address's bytes are a different pane's now.
                 const retiredRuntime = existingBySemantic.runtimeId;
                 this.cancelRecovery(retiredRuntime);
-                this.continueNotificationQueues.delete(retiredRuntime);
                 this.panesByRuntime.delete(retiredRuntime);
                 this.outputOrdinals.delete(retiredRuntime);
                 this.ledger.forget(retiredRuntime);
@@ -3300,6 +3108,8 @@ export class SessionChannel {
                 existingBySemantic.incarnation = ++this.paneIncarnation;
                 existingBySemantic.descriptor = descriptor;
                 existingBySemantic.active = verified.active;
+                if (existingBySemantic.windowRuntimeId !== windowRuntimeId)
+                    existingBySemantic.snapshotLayoutGeneration += 1;
                 existingBySemantic.windowRuntimeId = windowRuntimeId;
                 this.panesByRuntime.set(verified.runtimePaneId, existingBySemantic);
                 for (const sub of existingBySemantic.subs) {
@@ -3311,6 +3121,8 @@ export class SessionChannel {
             if (existingByRuntime && existingByRuntime.semanticId === verified.semanticPaneId) {
                 existingByRuntime.descriptor = descriptor;
                 existingByRuntime.active = verified.active;
+                if (existingByRuntime.windowRuntimeId !== windowRuntimeId)
+                    existingByRuntime.snapshotLayoutGeneration += 1;
                 existingByRuntime.windowRuntimeId = windowRuntimeId;
                 continue;
             }
@@ -3319,7 +3131,6 @@ export class SessionChannel {
                 // resolution). The old semantic id is gone.
                 this.panesBySemantic.delete(existingByRuntime.semanticId);
                 this.cancelRecovery(existingByRuntime.runtimeId);
-                this.continueNotificationQueues.delete(existingByRuntime.runtimeId);
                 this.ledger.forget(existingByRuntime.runtimeId);
                 this.outputOrdinals.delete(existingByRuntime.runtimeId);
                 for (const sub of existingByRuntime.subs) {
@@ -3328,13 +3139,20 @@ export class SessionChannel {
                     sub.closed = true;
                     sub.cancelCapture?.();
                     sub.feed.abortCurrent();
-                    sub.onEvent({ type: "closed" });
+                    try {
+                        sub.onEvent({ type: "closed" });
+                    }
+                    catch {
+                        // Close every sibling and the transport even if a consumer throws.
+                    }
                 }
                 existingByRuntime.subs.clear();
                 existingByRuntime.incarnation = ++this.paneIncarnation;
                 existingByRuntime.semanticId = verified.semanticPaneId;
                 existingByRuntime.descriptor = descriptor;
                 existingByRuntime.active = verified.active;
+                if (existingByRuntime.windowRuntimeId !== windowRuntimeId)
+                    existingByRuntime.snapshotLayoutGeneration += 1;
                 existingByRuntime.windowRuntimeId = windowRuntimeId;
                 this.panesBySemantic.set(verified.semanticPaneId, existingByRuntime);
                 continue;
@@ -3347,6 +3165,7 @@ export class SessionChannel {
                 windowRuntimeId,
                 subs: new Set(),
                 incarnation: ++this.paneIncarnation,
+                snapshotLayoutGeneration: 0,
             };
             this.panesByRuntime.set(record.runtimeId, record);
             this.panesBySemantic.set(record.semanticId, record);
@@ -3438,19 +3257,28 @@ export class SessionChannel {
     onChannelExit() {
         if (this.disposed)
             return;
+        this.snapshotActive?.cancelFence?.();
+        this.snapshotActive = null;
+        this.snapshotQueue.clear();
+        for (const recovery of this.recoveries.values())
+            recovery.lease = undefined;
         this.opts.ownedViewer?.dispose();
         this.windowLinkAuthority?.dispose();
         this.nativeGrid.dispose();
         this.settleFirstJoin();
         for (const runtime of [...this.recoveries.keys()])
             this.cancelRecovery(runtime);
-        this.continueNotificationQueues.clear();
         for (const pane of this.panesByRuntime.values()) {
             for (const sub of pane.subs) {
                 if (!sub.closed) {
                     sub.closed = true;
                     sub.cancelCapture?.();
-                    sub.onEvent({ type: "closed" });
+                    try {
+                        sub.onEvent({ type: "closed" });
+                    }
+                    catch {
+                        // Close every sibling and the transport even if a consumer throws.
+                    }
                 }
             }
             pane.subs.clear();