@oxvo/ai-live-assist 7.5.0 → 7.5.6

package/cjs/media.d.ts

@@ -36,6 +36,7 @@ export declare class RealtimeMedia {
     connect(result: LaunchResult, mode: AssistMode, signal: AbortSignal, offerIdempotencyKey?: string, expectedSessionState?: "active_text" | "active_voice"): Promise<number>;
     setMuted(muted: boolean): void;
     get isMuted(): boolean;
+    get isConnected(): boolean;
     setAssistantPlaybackAudible(audible: boolean): void;
     setManualTurn(manual: boolean): void;
     beginPushToTalk(): void;

package/cjs/media.js

@@ -137,6 +137,9 @@ class RealtimeMedia {
     get isMuted() {
         return this.muted;
     }
+    get isConnected() {
+        return !this.closed && this.connection?.connectionState === "connected";
+    }
     setAssistantPlaybackAudible(audible) {
         if (this.closed)
             return;

package/cjs/types.d.ts

@@ -331,6 +331,7 @@ export type SanitizedTarget = {
     inputType?: string;
     autocomplete?: string;
     semanticRegion?: string;
+    navigationMenu?: true;
     destinationPath?: string;
     sensitivity: Sensitivity;
     protectedRegion?: boolean;
@@ -356,6 +357,7 @@ export type PageContextSnapshot = {
     pageId: string;
     revision: number;
     url: string;
+    locationHasQuery?: boolean;
     title: string;
     locale: string;
     viewport: {

package/cjs/ui.js

@@ -6793,7 +6793,9 @@ class WidgetView {
         this.setActionStateRunning(status === "running");
         if (this.actionStateRunning) {
             this.clearAssistantReadyVisualTimer();
+            const previousState = this.assistantState;
             this.assistantState = "thinking";
+            this.updateRemoteAudioEvidenceExpectation(previousState, "thinking");
             const assistantCaption = this.captions.querySelector('[data-caption="assistant-partial"]');
             if (!assistantCaption || assistantCaption.classList.contains("pending")) {
                 this.ensurePendingCaption("assistant", this.messages.thinking);

package/cjs/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.5.0";
+export declare const VERSION = "7.5.6";

package/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.5.0';
+exports.VERSION = '7.5.6';

package/lib/AiLiveAssist.d.ts

@@ -34,7 +34,7 @@ export declare const normalizeAiGuideOpenInput: (input?: AiGuideOpenInput) => Re
 export declare const resolveAiGuideProtocolVersion: (bootstrap: Pick<BootstrapConfig, "experienceMode" | "minimumProtocolVersion" | "protocol">) => 1 | 2;
 export default class AiLiveAssist {
     private readonly options;
-    readonly version = "7.5.0";
+    readonly version = "7.5.6";
     private readonly host;
     private readonly guideAdmission;
     private readonly standaloneAdmissionPending;
@@ -627,6 +627,7 @@ export default class AiLiveAssist {
     private submitFeedback;
     private retry;
     private scheduleReconnect;
+    private canRecoverControlTransport;
     private reconnectPendingHandoffControlInMemory;
     private reconnectMessengerTerminalControl;
     private clearReconnectTimer;

package/lib/AiLiveAssist.js

@@ -7937,7 +7937,28 @@ export default class AiLiveAssist {
             ? this.navigationConsentResetReady
             : null;
         const resumeRecordAtConnect = this.readResume();
-        const channel = new ControlChannel(result, this.tabId, VERSION, () => this.scheduleReconnect(true), this.readResume()?.clientSequence ?? 0, (sequence) => this.updateResumeSequence(sequence), () => this.handleControlSequenceGap());
+        let recoveryPath = null;
+        const channel = new ControlChannel(result, this.tabId, VERSION, () => this.scheduleReconnect(true), this.readResume()?.clientSequence ?? 0, (sequence) => this.updateResumeSequence(sequence), () => this.handleControlSequenceGap(), {
+            canRecover: () => {
+                const currentPath = path();
+                if (!this.canRecoverControlTransport(channel, result, media) ||
+                    (recoveryPath !== null && recoveryPath !== currentPath))
+                    return false;
+                recoveryPath = currentPath;
+                return true;
+            },
+            onRecovered: async () => {
+                assertCurrent();
+                const fencingToken = channel.leaseToken;
+                channel.startHeartbeat(this.heartbeatSeconds);
+                await this.replayPreFenceAuthorityEnvelopes(channel, fencingToken, assertCurrent);
+                assertCurrent();
+                await this.context?.captureAndPublish();
+                assertCurrent();
+                this.flushPlaybackState();
+                this.reapplyConservativePreFencePresence(channel, fencingToken);
+            },
+        });
         const pauseHelloStateSignal = deferredSignal();
         (this.pauseHelloStateSignals ?? (this.pauseHelloStateSignals = new WeakMap())).set(channel, pauseHelloStateSignal);
         this.handoffContextPromptReceiptChannel = null;
@@ -8307,7 +8328,7 @@ export default class AiLiveAssist {
             this.context === context;
         context = new PageContextCollector({
             onSnapshot: (snapshot) => {
-                if (isCurrent() && this.channel?.leaseToken) {
+                if (isCurrent() && this.channel?.hasFencedAuthority) {
                     this.send("context.snapshot", snapshot);
                 }
             },
@@ -9666,7 +9687,15 @@ export default class AiLiveAssist {
             this.activePageAssistanceAuthorityEpoch === null &&
             this.activeActionAuthorityEpoch === null;
         if (!exactApplied || !localAuthorityInactive) {
-            this.invalidatePageAssistanceAuthority(false);
+            // A resumed document still owes the original action's terminal result.
+            // Preserve only its grantless outbox, never browser-control authority.
+            // Delivery remains fenced by the server's exact already_started receipt.
+            const preserveNavigationResult = source === "navigation_resume" &&
+                this.awaitingNavigationConsentReset &&
+                structurallyValid &&
+                localAuthorityInactive &&
+                this.pendingNavigationActionResult?.grant === null;
+            this.invalidatePageAssistanceAuthority(false, preserveNavigationResult);
         }
         if (!structurallyValid ||
             identity.authorityEpoch < this.minimumPageAssistanceAuthorityEpoch) {
@@ -11989,15 +12018,19 @@ export default class AiLiveAssist {
                 // intentionally result-less until navigation settles, preserving the
                 // cross-document recovery contract if this click unloads the page.
                 pendingExecution.result = deliveryResult;
+                let navigationReleased = false;
                 try {
-                    if (await this.navigateTo(deferredNavigation)) {
-                        return deliveryResult;
-                    }
-                    deliveryResult = this.markDeferredNavigationUnconfirmed(pendingExecution, context.currentRevision);
+                    navigationReleased = await this.navigateTo(deferredNavigation);
                 }
                 catch {
-                    deliveryResult = this.markDeferredNavigationUnconfirmed(pendingExecution, context.currentRevision);
+                    // A rejected router and an outgoing document both settle here.
                 }
+                // Pagehide stops the old collector and settles its pending router
+                // callback. It must not replace the destination document's grantless
+                // recovery record with an unconfirmed result from the outgoing page.
+                if (navigationReleased || !authorityIsCurrent())
+                    return deliveryResult;
+                deliveryResult = this.markDeferredNavigationUnconfirmed(pendingExecution, context.currentRevision);
             }
             else if (deferredNavigation) {
                 deliveryResult = this.markDeferredNavigationUnconfirmed(pendingExecution, context.currentRevision);
@@ -14661,6 +14694,21 @@ export default class AiLiveAssist {
         }, delay + Math.floor(Math.random() * 250));
         this.reconnectTimer = timer;
     }
+    canRecoverControlTransport(channel, result, media) {
+        return (this.channel === channel &&
+            this.result === result &&
+            this.media === media && media.isConnected && navigator.onLine &&
+            !this.ended && !this.destroyed && !this.terminalRequestPending &&
+            !this.reconnecting && !this.launchInFlight && !this.isVoicePresence() &&
+            (this.lifecyclePhase === "active_text" || this.lifecyclePhase === "active_voice") &&
+            !this.pendingAction && !this.pendingConfirmation && !this.pendingPageAssistance &&
+            !this.pendingNavigationActionResult && !this.legacyActionExecution &&
+            this.actionGrantInFlight.size === 0 &&
+            !this.pendingModeUpgrade && !this.pendingTextModeTransition &&
+            !this.messengerTransferPending && !this.messengerTransferred &&
+            !this.handoffRequestLifecycleOwner && !this.readResume()?.pauseCommand &&
+            this.modeUpgradePathIsCurrent(path()));
+    }
     async reconnectPendingHandoffControlInMemory(result, record, clientSequence, fencingToken, reconnectGeneration) {
         if (reconnectGeneration !== this.reconnectGeneration ||
             this.reconnecting ||

package/lib/context.d.ts

@@ -23,6 +23,7 @@ export declare class PageContextCollector {
     private mutationObserver;
     private captureTimer;
     private mutationCaptureTimer;
+    private mutationCaptureStartedAt;
     private targetIds;
     private pageScrollIds;
     private navigationTargetBindings;
@@ -74,6 +75,7 @@ export declare class PageContextCollector {
     private waitForScrollSettlement;
     private actionApplied;
     private clippedGeometry;
+    private clearMutationCapture;
     private scheduleCapture;
     private scheduleMutationCapture;
     private scheduleViewportCapture;

package/lib/context.js

@@ -7,6 +7,7 @@ const MAX_SELECTED_TEXT = 2000;
 const SELECTION_RETENTION_MS = 120000;
 const CAPTURE_SETTLE_MS = 250;
 const MUTATION_CAPTURE_DEBOUNCE_MS = 350;
+const MUTATION_CAPTURE_MAX_WAIT_MS = 1000;
 const SCROLL_SETTLEMENT_TIMEOUT_MS = 2000;
 const SCROLL_SETTLEMENT_FRAME_FALLBACK_MS = 50;
 const SCROLL_SETTLEMENT_POSITION_TOLERANCE_PX = 1;
@@ -75,6 +76,7 @@ const navigationTargetBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -119,6 +121,7 @@ const actionTargetFingerprintBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -141,47 +144,94 @@ export const actionTargetFingerprint = async (target, subtle = globalThis.crypto
     }
 };
 const isHTMLElement = (value) => value instanceof HTMLElement;
+// Clipping is checked in document geometry, not against the viewport: a
+// rendered footer link remains discoverable before it is scrolled into view.
+// No hidden descendant text is inspected to discover a navigation menu.
+const clippedRect = (element) => {
+    const rect = element.getBoundingClientRect();
+    let { left, top, right, bottom } = rect;
+    let depth = 0;
+    for (let parent = element.parentElement; parent; parent = parent.parentElement) {
+        if (++depth > 64)
+            return null;
+        const style = window.getComputedStyle(parent);
+        if (Number.parseFloat(style.opacity) === 0 || style.visibility === 'hidden' || style.display === 'none' || style.contentVisibility === 'hidden')
+            return null;
+        if (parent === document.body || parent === document.documentElement)
+            continue;
+        const bounds = parent.getBoundingClientRect();
+        // Overflow scrolling can reveal an offscreen descendant. A collapsed or
+        // clipped disclosure cannot be revealed by scrolling the document to it.
+        if (['hidden', 'clip'].includes(style.overflowX)) {
+            left = Math.max(left, bounds.left);
+            right = Math.min(right, bounds.right);
+        }
+        if (['hidden', 'clip'].includes(style.overflowY)) {
+            top = Math.max(top, bounds.top);
+            bottom = Math.min(bottom, bounds.bottom);
+        }
+        if (right <= left || bottom <= top)
+            return null;
+    }
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
+};
 const isRendered = (element) => {
-    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR)) {
+    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR))
         return false;
-    }
     const style = window.getComputedStyle(element);
-    const opacity = Number.parseFloat(style.opacity);
-    if (style.display === 'none' ||
-        style.visibility === 'hidden' ||
-        (Number.isFinite(opacity) && opacity === 0) ||
-        style.pointerEvents === 'none') {
+    if (style.display === 'none' || style.visibility === 'hidden' ||
+        Number.parseFloat(style.opacity) === 0 || style.pointerEvents === 'none')
         return false;
-    }
-    const rect = element.getBoundingClientRect();
-    return rect.width > 0 && rect.height > 0;
+    return clippedRect(element) !== null;
 };
-const isVisible = (element) => {
+const visibleRect = (element) => {
     if (!isRendered(element))
-        return false;
-    const rect = element.getBoundingClientRect();
-    return (rect.bottom >= 0 &&
-        rect.right >= 0 &&
-        rect.top <= window.innerHeight &&
-        rect.left <= window.innerWidth);
+        return null;
+    const rect = clippedRect(element);
+    if (!rect)
+        return null;
+    const left = Math.max(0, rect.left), top = Math.max(0, rect.top);
+    const right = Math.min(window.innerWidth, rect.right), bottom = Math.min(window.innerHeight, rect.bottom);
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
 };
-const isCovered = (element, trustedGuideRoot = null) => {
-    const rect = element.getBoundingClientRect();
-    const x = Math.max(0, Math.min(window.innerWidth - 1, rect.left + rect.width / 2));
-    const y = Math.max(0, Math.min(window.innerHeight - 1, rect.top + rect.height / 2));
-    let top;
-    if (trustedGuideRoot?.isConnected &&
-        typeof document.elementsFromPoint === 'function') {
-        top =
-            document
-                .elementsFromPoint(x, y)
-                .find((candidate) => candidate !== trustedGuideRoot) ??
-                document.elementFromPoint(x, y);
-    }
-    else {
-        top = document.elementFromPoint(x, y);
-    }
-    return Boolean(top && top !== element && !element.contains(top) && !top.contains(element));
+const isVisible = (element) => visibleRect(element) !== null;
+const interactionPoint = (element, trustedGuideRoot = null) => {
+    const rect = visibleRect(element);
+    if (!rect)
+        return null;
+    // Five bounded hit tests permit an exposed part of a link without treating
+    // an ancestor, empty hit, or a covering sibling as an interactable target.
+    const insetX = Math.min(1, (rect.right - rect.left) / 4);
+    const insetY = Math.min(1, (rect.bottom - rect.top) / 4);
+    const points = [
+        [(rect.left + rect.right) / 2, (rect.top + rect.bottom) / 2],
+        [rect.left + insetX, rect.top + insetY], [rect.right - insetX, rect.top + insetY],
+        [rect.left + insetX, rect.bottom - insetY], [rect.right - insetX, rect.bottom - insetY],
+    ];
+    for (const [x, y] of points) {
+        const top = trustedGuideRoot?.isConnected && typeof document.elementsFromPoint === 'function'
+            ? document.elementsFromPoint(x, y).find(candidate => candidate !== trustedGuideRoot) ?? null
+            : document.elementFromPoint(x, y);
+        if (top !== null && (top === element || element.contains(top)))
+            return { x: x, y: y, hit: top };
+    }
+    return null;
+};
+const isCovered = (element, trustedGuideRoot = null) => interactionPoint(element, trustedGuideRoot) === null;
+const isNavigationMenu = (element, role) => {
+    if (role !== 'button' || literalBooleanAttribute(element, 'aria-expanded') === undefined ||
+        element.hasAttribute('aria-pressed') || element.hasAttribute('aria-checked') ||
+        element instanceof HTMLButtonElement && element.form !== null && element.type !== 'button')
+        return false;
+    if (element.closest('nav,[role="navigation"]'))
+        return true;
+    // aria-controls supplies identity only. Do not capture hidden menu labels,
+    // links, values or instructions before native expansion and recapture.
+    const controls = (element.getAttribute('aria-controls') ?? '').trim().split(/\s+/).slice(0, 4);
+    return controls.some(control => {
+        const menu = document.getElementById(control);
+        return menu !== null && menu.matches('nav,[role="navigation"],[role="menu"]');
+    });
 };
 const safePageUrl = () => `${window.location.origin}${window.location.pathname}`;
 const linkBrowsingTarget = (link) => (link.getAttribute('target') ?? document.querySelector('base[target]')?.getAttribute('target') ?? '').toLowerCase();
@@ -193,11 +243,13 @@ const sameNavigationDestination = (actual, expected) => {
     return left.origin === right.origin && left.pathname === right.pathname && left.search === right.search;
 };
 const safeDestinationPath = (element) => {
-    if (!(element instanceof HTMLAnchorElement))
+    // An empty href is a control, not authority to navigate to the current URL.
+    if (!(element instanceof HTMLAnchorElement) || !element.getAttribute('href')?.trim())
         return null;
     try {
         const destination = new URL(element.href, window.location.href);
         if (destination.origin !== window.location.origin ||
+            destination.username !== '' || destination.password !== '' ||
             destination.search ||
             destination.hash ||
             !destination.pathname.startsWith('/') ||
@@ -440,15 +492,17 @@ const checkedStateFor = (element) => {
     }
     return framerToggleDescriptor(element)?.checked;
 };
-const dispatchFramerPrimaryPointerSequence = (element) => {
+const dispatchFramerPrimaryPointerSequence = (element, trustedGuideRoot = null) => {
     if (typeof window.PointerEvent !== 'function') {
         throw new Error('Framer pointer interaction is unavailable.');
     }
-    const rect = element.getBoundingClientRect();
-    const clientX = rect.left + rect.width / 2;
-    const clientY = rect.top + rect.height / 2;
-    const hit = document.elementFromPoint(clientX, clientY);
-    const eventTarget = element instanceof HTMLAnchorElement && hit && element.contains(hit) ? hit : element;
+    // Capture and dispatch must agree on the exposed point and exact descendant,
+    // including when our own mobile surface covers a link's router-owned logo.
+    const point = interactionPoint(element, trustedGuideRoot);
+    if (!point)
+        throw new Error('The approved pointer target is covered.');
+    const { x: clientX, y: clientY } = point;
+    const eventTarget = element instanceof HTMLAnchorElement ? point.hit : element;
     const nestedLink = eventTarget.closest('a[href]');
     if (element instanceof HTMLAnchorElement && nestedLink instanceof HTMLAnchorElement && nestedLink !== element &&
         (!sameNavigationDestination(nestedLink.href, element.href) || nestedLink.hasAttribute('download') ||
@@ -520,11 +574,11 @@ const dispatchFramerPrimaryPointerSequence = (element) => {
         detail: 1,
     }));
 };
-const dispatchFramerTogglePrimaryPointer = (element) => {
+const dispatchFramerTogglePrimaryPointer = (element, trustedGuideRoot = null) => {
     if (!framerToggleDescriptor(element)) {
         throw new Error('Framer toggle pointer interaction is unavailable.');
     }
-    dispatchFramerPrimaryPointerSequence(element);
+    dispatchFramerPrimaryPointerSequence(element, trustedGuideRoot);
 };
 const semanticSourceSensitivity = (source) => {
     if (source.closest(PRIVATE_SELECTOR) || source.querySelector(PRIVATE_SELECTOR)) {
@@ -694,6 +748,7 @@ export class PageContextCollector {
         this.mutationObserver = null;
         this.captureTimer = null;
         this.mutationCaptureTimer = null;
+        this.mutationCaptureStartedAt = null;
         this.targetIds = new WeakMap();
         this.pageScrollIds = new WeakMap();
         this.navigationTargetBindings = new WeakMap();
@@ -721,9 +776,7 @@ export class PageContextCollector {
                 this.pendingCapture = true;
                 return;
             }
-            if (this.mutationCaptureTimer)
-                clearTimeout(this.mutationCaptureTimer);
-            this.mutationCaptureTimer = null;
+            this.clearMutationCapture();
             if (this.captureTimer)
                 return;
             this.captureTimer = setTimeout(() => {
@@ -740,12 +793,19 @@ export class PageContextCollector {
             }
             if (this.captureTimer)
                 return;
+            // Decorative animation must not indefinitely hide newly available links.
+            // Retain trailing-edge batching, with at most one forced scan per second
+            // during continuous churn. Unchanged semantic snapshots are still deduped.
+            const now = performance.now();
+            this.mutationCaptureStartedAt ?? (this.mutationCaptureStartedAt = now);
+            const delay = Math.max(0, Math.min(MUTATION_CAPTURE_DEBOUNCE_MS, MUTATION_CAPTURE_MAX_WAIT_MS - (now - this.mutationCaptureStartedAt)));
             if (this.mutationCaptureTimer)
                 clearTimeout(this.mutationCaptureTimer);
             this.mutationCaptureTimer = setTimeout(() => {
                 this.mutationCaptureTimer = null;
+                this.mutationCaptureStartedAt = null;
                 void this.captureAndPublishIfChanged();
-            }, MUTATION_CAPTURE_DEBOUNCE_MS);
+            }, delay);
         };
         this.scheduleViewportCapture = () => {
             this.scheduleMutationCapture();
@@ -818,9 +878,7 @@ export class PageContextCollector {
             if (this.captureTimer)
                 clearTimeout(this.captureTimer);
             this.captureTimer = null;
-            if (this.mutationCaptureTimer)
-                clearTimeout(this.mutationCaptureTimer);
-            this.mutationCaptureTimer = null;
+            this.clearMutationCapture();
             if (this.releasedNavigationSettlement &&
                 window.location.href !== this.releasedNavigationSettlement.fromUrl) {
                 this.finishReleasedNavigationSettlement(sameNavigationDestination(window.location.href, this.releasedNavigationSettlement.toUrl)
@@ -951,9 +1009,7 @@ export class PageContextCollector {
         if (this.captureTimer)
             clearTimeout(this.captureTimer);
         this.captureTimer = null;
-        if (this.mutationCaptureTimer)
-            clearTimeout(this.mutationCaptureTimer);
-        this.mutationCaptureTimer = null;
+        this.clearMutationCapture();
         window.removeEventListener('resize', this.scheduleViewportCapture);
         document.removeEventListener('scroll', this.scheduleViewportCapture, true);
         window.visualViewport?.removeEventListener('resize', this.scheduleViewportCapture);
@@ -1057,6 +1113,7 @@ export class PageContextCollector {
                     }
                     : {}),
                 ...(semanticRegion ? { semanticRegion } : {}),
+                ...(this.statefulButtonActionProof && isNavigationMenu(element, role) ? { navigationMenu: true } : {}),
                 ...(destinationPath ? { destinationPath } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || regionAssessment.matchedRuleDigests.length > 0,
@@ -1168,6 +1225,7 @@ export class PageContextCollector {
             pageId: this.pageId,
             revision,
             url: safePageUrl(),
+            locationHasQuery: window.location.search !== '',
             title: normalize(document.title, 512),
             locale: normalize(document.documentElement.lang || navigator.language || 'en', 16),
             viewport: {
@@ -1788,7 +1846,7 @@ export class PageContextCollector {
                 };
                 window.addEventListener('click', preventNativeNavigation);
                 try {
-                    dispatchFramerPrimaryPointerSequence(navigation.source);
+                    dispatchFramerPrimaryPointerSequence(navigation.source, this.trustedGuideRoot);
                 }
                 finally {
                     window.removeEventListener('click', preventNativeNavigation);
@@ -1870,7 +1928,7 @@ export class PageContextCollector {
         if (desiredStates.length > 0 && desiredStates.every(Boolean))
             return;
         if (desiredChecked !== undefined && framerToggleDescriptor(element)) {
-            dispatchFramerTogglePrimaryPointer(element);
+            dispatchFramerTogglePrimaryPointer(element, this.trustedGuideRoot);
             return;
         }
         if (element instanceof HTMLAnchorElement) {
@@ -2178,9 +2236,19 @@ export class PageContextCollector {
             height,
         };
     }
+    clearMutationCapture() {
+        if (this.mutationCaptureTimer)
+            clearTimeout(this.mutationCaptureTimer);
+        this.mutationCaptureTimer = null;
+        this.mutationCaptureStartedAt = null;
+    }
     async captureAndPublishIfChanged() {
-        if (this.navigationSettlement)
+        if (!this.running || this.navigationSettlement)
+            return;
+        if (this.executingActionId) {
+            this.pendingCapture = true;
             return;
+        }
         const snapshot = this.captureSnapshot(false);
         if (snapshot && this.running)
             await this.callbacks.onSnapshot(snapshot);
@@ -2265,9 +2333,7 @@ export class PageContextCollector {
         if (this.captureTimer)
             clearTimeout(this.captureTimer);
         this.captureTimer = null;
-        if (this.mutationCaptureTimer)
-            clearTimeout(this.mutationCaptureTimer);
-        this.mutationCaptureTimer = null;
+        this.clearMutationCapture();
         return settlement;
     }
     observeCausalNavigationAfterMutation(actionId, destinationPath, beforeActionUrl) {

package/lib/control.d.ts

@@ -24,6 +24,10 @@ export type ControlOutboundOperation = {
     type: string;
 };
 export type ReservedControlOperation = Readonly<ControlOutboundOperation>;
+type TransportRecovery = {
+    canRecover: () => boolean;
+    onRecovered: () => Promise<void>;
+};
 export declare class ControlChannel {
     private readonly result;
     private readonly tabId;
@@ -31,6 +35,7 @@ export declare class ControlChannel {
     private readonly onDisconnect;
     private readonly onClientSequence;
     private readonly onUnsafeDisconnect;
+    private readonly transportRecovery?;
     private socket;
     private clientSequence;
     private serverSequence;
@@ -54,7 +59,9 @@ export declare class ControlChannel {
     private pendingConnection;
     private helloOperation;
     private fencedAuthorityConfirmed;
-    constructor(result: RuntimeAuthorization, tabId: string, clientVersion: string, onDisconnect: () => void, initialClientSequence?: number, onClientSequence?: (sequence: number) => void, onUnsafeDisconnect?: () => void);
+    private transportRecoveryAttempted;
+    private recoveringTransport;
+    constructor(result: RuntimeAuthorization, tabId: string, clientVersion: string, onDisconnect: () => void, initialClientSequence?: number, onClientSequence?: (sequence: number) => void, onUnsafeDisconnect?: () => void, transportRecovery?: TransportRecovery | undefined);
     get leaseToken(): number;
     get lastClientSequence(): number;
     get isOpen(): boolean;
@@ -78,6 +85,7 @@ export declare class ControlChannel {
     private handleMessage;
     private recoverFromSequenceGap;
     private notifyUnsafeDisconnect;
+    private recoverTransport;
     private enqueueHandlers;
     private dispatchHandlers;
     private handleHandlerFailure;