@oxvo/ai-live-assist 7.5.1 → 7.5.8

package/cjs/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.1";
+    readonly version = "7.5.8";
     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/cjs/AiLiveAssist.js

@@ -7945,7 +7945,28 @@ class AiLiveAssist {
             ? this.navigationConsentResetReady
             : null;
         const resumeRecordAtConnect = this.readResume();
-        const channel = new control_js_1.ControlChannel(result, this.tabId, version_js_1.VERSION, () => this.scheduleReconnect(true), this.readResume()?.clientSequence ?? 0, (sequence) => this.updateResumeSequence(sequence), () => this.handleControlSequenceGap());
+        let recoveryPath = null;
+        const channel = new control_js_1.ControlChannel(result, this.tabId, version_js_1.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;
@@ -8315,7 +8336,7 @@ class AiLiveAssist {
             this.context === context;
         context = new context_js_1.PageContextCollector({
             onSnapshot: (snapshot) => {
-                if (isCurrent() && this.channel?.leaseToken) {
+                if (isCurrent() && this.channel?.hasFencedAuthority) {
                     this.send("context.snapshot", snapshot);
                 }
             },
@@ -9674,7 +9695,15 @@ 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) {
@@ -11997,15 +12026,19 @@ 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);
@@ -14669,6 +14702,21 @@ 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/cjs/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/cjs/context.js

@@ -10,6 +10,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;
@@ -198,10 +199,10 @@ const visibleRect = (element) => {
     return right > left && bottom > top ? { left, top, right, bottom } : null;
 };
 const isVisible = (element) => visibleRect(element) !== null;
-const isCovered = (element, trustedGuideRoot = null) => {
+const interactionPoint = (element, trustedGuideRoot = null) => {
     const rect = visibleRect(element);
     if (!rect)
-        return true;
+        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);
@@ -211,13 +212,16 @@ const isCovered = (element, trustedGuideRoot = null) => {
         [rect.left + insetX, rect.top + insetY], [rect.right - insetX, rect.top + insetY],
         [rect.left + insetX, rect.bottom - insetY], [rect.right - insetX, rect.bottom - insetY],
     ];
-    return !points.some(([x, y]) => {
+    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);
-        return top !== null && (top === element || element.contains(top));
-    });
+        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') ||
@@ -492,15 +496,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') ||
@@ -572,11 +578,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)) {
@@ -634,6 +640,18 @@ const safeOptionLabel = (option) => {
     return sensitivityFor(option, label) === 'none' ? label : '';
 };
 const isActionTarget = (element) => element.matches('a[href],button,input,select,textarea,summary,form,[contenteditable="true"],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="combobox"],[role="textbox"],[tabindex]');
+const belongsToInteractiveControl = (element) => {
+    for (let current = element; current; current = current.parentElement) {
+        // Form copy can carry useful public instructions. Only controls and links
+        // already represented in targets are omitted from visible page text.
+        if (current.matches('form'))
+            continue;
+        // A bare tabindex is often a focusable Framer content card, not an action.
+        if (current.matches('a[href],button,input,select,textarea,summary,[contenteditable="true"],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="combobox"],[role="textbox"]'))
+            return true;
+    }
+    return false;
+};
 const READONLY_INPUT_TYPES = new Set([
     'date',
     'datetime-local',
@@ -746,6 +764,7 @@ 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();
@@ -773,9 +792,7 @@ class PageContextCollector {
                 this.pendingCapture = true;
                 return;
             }
-            if (this.mutationCaptureTimer)
-                clearTimeout(this.mutationCaptureTimer);
-            this.mutationCaptureTimer = null;
+            this.clearMutationCapture();
             if (this.captureTimer)
                 return;
             this.captureTimer = setTimeout(() => {
@@ -792,12 +809,19 @@ 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();
@@ -870,9 +894,7 @@ 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)
@@ -1003,9 +1025,7 @@ 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);
@@ -1177,23 +1197,33 @@ class PageContextCollector {
             });
         }
         const visibleText = [];
+        const capturedSemanticText = new Set();
         let totalText = 0;
         const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_TEXT);
         let node = walker.nextNode();
         while (node && visibleText.length < MAX_TEXT_ITEMS && totalText < MAX_TOTAL_TEXT) {
             const parent = node.parentElement;
-            const text = normalize(node.textContent ?? '', 500);
+            const semanticTextElement = parent?.closest('[role="img"][aria-label]') ?? null;
+            const textElement = semanticTextElement && isRendered(semanticTextElement)
+                ? semanticTextElement
+                : parent;
+            const text = normalize(semanticTextElement?.getAttribute('aria-label') ?? node.textContent ?? '', 500);
             if (parent &&
+                textElement &&
                 text &&
                 !parent.closest(PRIVATE_SELECTOR) &&
                 !parent.closest('script,style,noscript,template,svg') &&
                 !parent.closest('input,select,textarea,option') &&
-                isVisible(parent) &&
-                sensitivityFor(parent, nameFor(parent)) === 'none') {
+                (!semanticTextElement || !capturedSemanticText.has(semanticTextElement)) &&
+                !belongsToInteractiveControl(textElement) &&
+                isRendered(textElement) &&
+                sensitivityFor(textElement, nameFor(textElement)) === 'none') {
                 const textId = this.textIds.get(node) ?? id('text');
                 this.textIds.set(node, textId);
                 visibleText.push({ id: textId, text, provenance: 'page' });
                 totalText += text.length;
+                if (semanticTextElement)
+                    capturedSemanticText.add(semanticTextElement);
             }
             node = walker.nextNode();
         }
@@ -1842,7 +1872,7 @@ class PageContextCollector {
                 };
                 window.addEventListener('click', preventNativeNavigation);
                 try {
-                    dispatchFramerPrimaryPointerSequence(navigation.source);
+                    dispatchFramerPrimaryPointerSequence(navigation.source, this.trustedGuideRoot);
                 }
                 finally {
                     window.removeEventListener('click', preventNativeNavigation);
@@ -1924,7 +1954,7 @@ 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) {
@@ -2232,9 +2262,19 @@ 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);
@@ -2319,9 +2359,7 @@ 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/cjs/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;

package/cjs/control.js

@@ -6,6 +6,7 @@ const PROTOCOL_VIOLATION_CLOSE_CODE = 4008;
 const SERVER_SEQUENCE_GAP_CLOSE_CODE = 4009;
 const HANDLER_FAILURE_CLOSE_CODE = 4010;
 const HANDLER_TIMEOUT_MS = 15000;
+const TRANSPORT_RECOVERY_TIMEOUT_MS = 5000;
 const MAX_PENDING_HANDLER_MESSAGES = 64;
 const MAX_PENDING_STATEFUL_OPERATIONS = 64;
 const MAX_SETTLED_OPERATION_HISTORY = 100;
@@ -38,13 +39,14 @@ const STATEFUL_CONTROL_TYPES = new Set([
 ]);
 const outcomeKey = (messageId, sequence) => `${messageId}\u0000${sequence}`;
 class ControlChannel {
-    constructor(result, tabId, clientVersion, onDisconnect, initialClientSequence = 0, onClientSequence = () => undefined, onUnsafeDisconnect = () => undefined) {
+    constructor(result, tabId, clientVersion, onDisconnect, initialClientSequence = 0, onClientSequence = () => undefined, onUnsafeDisconnect = () => undefined, transportRecovery) {
         this.result = result;
         this.tabId = tabId;
         this.clientVersion = clientVersion;
         this.onDisconnect = onDisconnect;
         this.onClientSequence = onClientSequence;
         this.onUnsafeDisconnect = onUnsafeDisconnect;
+        this.transportRecovery = transportRecovery;
         this.socket = null;
         this.serverSequence = 0;
         this.serverBaselineEstablished = false;
@@ -67,6 +69,8 @@ class ControlChannel {
         this.pendingConnection = null;
         this.helloOperation = null;
         this.fencedAuthorityConfirmed = false;
+        this.transportRecoveryAttempted = false;
+        this.recoveringTransport = false;
         this.clientSequence =
             Number.isSafeInteger(initialClientSequence) && initialClientSequence >= 0
                 ? initialClientSequence
@@ -79,7 +83,7 @@ class ControlChannel {
         return this.clientSequence;
     }
     get isOpen() {
-        return this.socket?.readyState === WebSocket.OPEN;
+        return (!this.recoveringTransport && this.socket?.readyState === WebSocket.OPEN);
     }
     get connectionHelloOperation() {
         return this.helloOperation ? { ...this.helloOperation } : null;
@@ -180,10 +184,19 @@ class ControlChannel {
                     this.rejectPendingConnection(socket, generation, new Error("The AI Guide control channel could not connect."));
                 }
             }, { once: true });
-            socket.addEventListener("close", () => {
+            socket.addEventListener("close", (event) => {
                 if (!this.isCurrentSocket(socket, generation))
                     return;
                 const wasIntentionallyClosed = this.intentionallyClosed;
+                // A settled transport loss is not a new session. Keep its provider
+                // connection alive for one bounded retry, but never carry ambiguous
+                // browser writes, an active handler, or a protocol failure across it.
+                const canRecover = event.code === 1006 &&
+                    this.fencedAuthorityConfirmed &&
+                    !this.transportRecoveryAttempted &&
+                    !this.sequenceGapDetected &&
+                    this.pendingHandlerMessages === 0 &&
+                    this.unsettledStatefulOperations.size === 0;
                 this.socket = null;
                 this.socketGeneration += 1;
                 this.stopHeartbeat();
@@ -197,12 +210,24 @@ class ControlChannel {
                 this.pendingHandlerMessages = 0;
                 this.rejectPendingConnection(socket, generation, new Error("The AI Guide control channel closed before connecting."));
                 if (!wasIntentionallyClosed && !signal.aborted) {
+                    try {
+                        if (canRecover && this.transportRecovery?.canRecover()) {
+                            void this.recoverTransport(signal);
+                            return;
+                        }
+                    }
+                    catch {
+                        /* A failed eligibility check uses full recovery. */
+                    }
                     this.notifyUnsafeDisconnect();
                 }
             });
         });
     }
     send(type, payload, stableMessageId) {
+        if (this.recoveringTransport && type !== "hello" && type !== "heartbeat") {
+            throw new Error("The AI Guide control channel is reconnecting.");
+        }
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
             throw new Error("The AI Guide control channel is not connected.");
         }
@@ -513,6 +538,59 @@ class ControlChannel {
             this.onDisconnect();
         }
     }
+    async recoverTransport(signal) {
+        this.transportRecoveryAttempted = true;
+        this.recoveringTransport = true;
+        const controller = new AbortController();
+        const abort = () => controller.abort();
+        signal.addEventListener("abort", abort, { once: true });
+        let timeout;
+        const deadline = new Promise((_resolve, reject) => {
+            timeout = setTimeout(() => {
+                controller.abort();
+                reject(new Error("The control reconnect timed out."));
+            }, TRANSPORT_RECOVERY_TIMEOUT_MS);
+        });
+        const fencingToken = this.fencingToken;
+        let recovered = false;
+        try {
+            await Promise.race([
+                deadline,
+                (async () => {
+                    if (signal.aborted)
+                        throw new Error("The control connection was retired.");
+                    await this.connect(controller.signal, true);
+                    const hello = await this.waitForHelloOutcome(2000);
+                    if (hello.status !== "ack" || controller.signal.aborted) {
+                        throw new Error("The control reconnect was not acknowledged.");
+                    }
+                    const authority = await this.proveFencedAuthority(2000);
+                    if (authority.status !== "ack" ||
+                        controller.signal.aborted ||
+                        this.fencingToken !== fencingToken ||
+                        !this.transportRecovery?.canRecover()) {
+                        throw new Error("The control reconnect no longer owns this session.");
+                    }
+                    this.recoveringTransport = false;
+                    await this.transportRecovery.onRecovered();
+                    recovered = !controller.signal.aborted && this.hasFencedAuthority;
+                })(),
+            ]);
+        }
+        catch {
+            // The existing full-resume path revokes local executable authority and
+            // handles expired credentials, changed ownership, and longer outages.
+        }
+        finally {
+            clearTimeout(timeout);
+            signal.removeEventListener("abort", abort);
+            this.recoveringTransport = false;
+            if (!recovered && !signal.aborted && !this.intentionallyClosed) {
+                this.retireSocket("control reconnect failed");
+                this.notifyUnsafeDisconnect();
+            }
+        }
+    }
     enqueueHandlers(message, socket, generation) {
         const isCurrent = () => this.isMessageSourceCurrent(socket, generation);
         if (!isCurrent())

package/cjs/liveControlChannel.d.ts

@@ -1,5 +1,5 @@
 import { type LiveDuplexMediaOptions, type LiveDuplexMediaDependencies } from './liveDuplexMedia.js';
-export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.1";
+export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.8";
 export declare const LIVE_CONTROL_CLIENT_CAPABILITIES: readonly ["live_duplex_v1", "live_local_wake_v1", "live_fragment_captions_v1"];
 declare const phases: readonly ["voice_off", "local_listening", "wake_buffering", "starting", "active", "tentative_idle", "closing", "uncertain", "muted", "suspended", "budget_blocked", "ended"];
 export type LiveControlState = {

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/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.1";
+export declare const VERSION = "7.5.8";

package/cjs/version.js

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

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.1";
+    readonly version = "7.5.8";
     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;
@@ -194,10 +195,10 @@ const visibleRect = (element) => {
     return right > left && bottom > top ? { left, top, right, bottom } : null;
 };
 const isVisible = (element) => visibleRect(element) !== null;
-const isCovered = (element, trustedGuideRoot = null) => {
+const interactionPoint = (element, trustedGuideRoot = null) => {
     const rect = visibleRect(element);
     if (!rect)
-        return true;
+        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);
@@ -207,13 +208,16 @@ const isCovered = (element, trustedGuideRoot = null) => {
         [rect.left + insetX, rect.top + insetY], [rect.right - insetX, rect.top + insetY],
         [rect.left + insetX, rect.bottom - insetY], [rect.right - insetX, rect.bottom - insetY],
     ];
-    return !points.some(([x, y]) => {
+    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);
-        return top !== null && (top === element || element.contains(top));
-    });
+        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') ||
@@ -488,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') ||
@@ -568,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)) {
@@ -630,6 +636,18 @@ const safeOptionLabel = (option) => {
     return sensitivityFor(option, label) === 'none' ? label : '';
 };
 const isActionTarget = (element) => element.matches('a[href],button,input,select,textarea,summary,form,[contenteditable="true"],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="combobox"],[role="textbox"],[tabindex]');
+const belongsToInteractiveControl = (element) => {
+    for (let current = element; current; current = current.parentElement) {
+        // Form copy can carry useful public instructions. Only controls and links
+        // already represented in targets are omitted from visible page text.
+        if (current.matches('form'))
+            continue;
+        // A bare tabindex is often a focusable Framer content card, not an action.
+        if (current.matches('a[href],button,input,select,textarea,summary,[contenteditable="true"],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="combobox"],[role="textbox"]'))
+            return true;
+    }
+    return false;
+};
 const READONLY_INPUT_TYPES = new Set([
     'date',
     'datetime-local',
@@ -742,6 +760,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();
@@ -769,9 +788,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(() => {
@@ -788,12 +805,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();
@@ -866,9 +890,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)
@@ -999,9 +1021,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);
@@ -1173,23 +1193,33 @@ export class PageContextCollector {
             });
         }
         const visibleText = [];
+        const capturedSemanticText = new Set();
         let totalText = 0;
         const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_TEXT);
         let node = walker.nextNode();
         while (node && visibleText.length < MAX_TEXT_ITEMS && totalText < MAX_TOTAL_TEXT) {
             const parent = node.parentElement;
-            const text = normalize(node.textContent ?? '', 500);
+            const semanticTextElement = parent?.closest('[role="img"][aria-label]') ?? null;
+            const textElement = semanticTextElement && isRendered(semanticTextElement)
+                ? semanticTextElement
+                : parent;
+            const text = normalize(semanticTextElement?.getAttribute('aria-label') ?? node.textContent ?? '', 500);
             if (parent &&
+                textElement &&
                 text &&
                 !parent.closest(PRIVATE_SELECTOR) &&
                 !parent.closest('script,style,noscript,template,svg') &&
                 !parent.closest('input,select,textarea,option') &&
-                isVisible(parent) &&
-                sensitivityFor(parent, nameFor(parent)) === 'none') {
+                (!semanticTextElement || !capturedSemanticText.has(semanticTextElement)) &&
+                !belongsToInteractiveControl(textElement) &&
+                isRendered(textElement) &&
+                sensitivityFor(textElement, nameFor(textElement)) === 'none') {
                 const textId = this.textIds.get(node) ?? id('text');
                 this.textIds.set(node, textId);
                 visibleText.push({ id: textId, text, provenance: 'page' });
                 totalText += text.length;
+                if (semanticTextElement)
+                    capturedSemanticText.add(semanticTextElement);
             }
             node = walker.nextNode();
         }
@@ -1838,7 +1868,7 @@ export class PageContextCollector {
                 };
                 window.addEventListener('click', preventNativeNavigation);
                 try {
-                    dispatchFramerPrimaryPointerSequence(navigation.source);
+                    dispatchFramerPrimaryPointerSequence(navigation.source, this.trustedGuideRoot);
                 }
                 finally {
                     window.removeEventListener('click', preventNativeNavigation);
@@ -1920,7 +1950,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) {
@@ -2228,9 +2258,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);
@@ -2315,9 +2355,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;

package/lib/control.js

@@ -3,6 +3,7 @@ const PROTOCOL_VIOLATION_CLOSE_CODE = 4008;
 const SERVER_SEQUENCE_GAP_CLOSE_CODE = 4009;
 const HANDLER_FAILURE_CLOSE_CODE = 4010;
 const HANDLER_TIMEOUT_MS = 15000;
+const TRANSPORT_RECOVERY_TIMEOUT_MS = 5000;
 const MAX_PENDING_HANDLER_MESSAGES = 64;
 const MAX_PENDING_STATEFUL_OPERATIONS = 64;
 const MAX_SETTLED_OPERATION_HISTORY = 100;
@@ -35,13 +36,14 @@ const STATEFUL_CONTROL_TYPES = new Set([
 ]);
 const outcomeKey = (messageId, sequence) => `${messageId}\u0000${sequence}`;
 export class ControlChannel {
-    constructor(result, tabId, clientVersion, onDisconnect, initialClientSequence = 0, onClientSequence = () => undefined, onUnsafeDisconnect = () => undefined) {
+    constructor(result, tabId, clientVersion, onDisconnect, initialClientSequence = 0, onClientSequence = () => undefined, onUnsafeDisconnect = () => undefined, transportRecovery) {
         this.result = result;
         this.tabId = tabId;
         this.clientVersion = clientVersion;
         this.onDisconnect = onDisconnect;
         this.onClientSequence = onClientSequence;
         this.onUnsafeDisconnect = onUnsafeDisconnect;
+        this.transportRecovery = transportRecovery;
         this.socket = null;
         this.serverSequence = 0;
         this.serverBaselineEstablished = false;
@@ -64,6 +66,8 @@ export class ControlChannel {
         this.pendingConnection = null;
         this.helloOperation = null;
         this.fencedAuthorityConfirmed = false;
+        this.transportRecoveryAttempted = false;
+        this.recoveringTransport = false;
         this.clientSequence =
             Number.isSafeInteger(initialClientSequence) && initialClientSequence >= 0
                 ? initialClientSequence
@@ -76,7 +80,7 @@ export class ControlChannel {
         return this.clientSequence;
     }
     get isOpen() {
-        return this.socket?.readyState === WebSocket.OPEN;
+        return (!this.recoveringTransport && this.socket?.readyState === WebSocket.OPEN);
     }
     get connectionHelloOperation() {
         return this.helloOperation ? { ...this.helloOperation } : null;
@@ -177,10 +181,19 @@ export class ControlChannel {
                     this.rejectPendingConnection(socket, generation, new Error("The AI Guide control channel could not connect."));
                 }
             }, { once: true });
-            socket.addEventListener("close", () => {
+            socket.addEventListener("close", (event) => {
                 if (!this.isCurrentSocket(socket, generation))
                     return;
                 const wasIntentionallyClosed = this.intentionallyClosed;
+                // A settled transport loss is not a new session. Keep its provider
+                // connection alive for one bounded retry, but never carry ambiguous
+                // browser writes, an active handler, or a protocol failure across it.
+                const canRecover = event.code === 1006 &&
+                    this.fencedAuthorityConfirmed &&
+                    !this.transportRecoveryAttempted &&
+                    !this.sequenceGapDetected &&
+                    this.pendingHandlerMessages === 0 &&
+                    this.unsettledStatefulOperations.size === 0;
                 this.socket = null;
                 this.socketGeneration += 1;
                 this.stopHeartbeat();
@@ -194,12 +207,24 @@ export class ControlChannel {
                 this.pendingHandlerMessages = 0;
                 this.rejectPendingConnection(socket, generation, new Error("The AI Guide control channel closed before connecting."));
                 if (!wasIntentionallyClosed && !signal.aborted) {
+                    try {
+                        if (canRecover && this.transportRecovery?.canRecover()) {
+                            void this.recoverTransport(signal);
+                            return;
+                        }
+                    }
+                    catch {
+                        /* A failed eligibility check uses full recovery. */
+                    }
                     this.notifyUnsafeDisconnect();
                 }
             });
         });
     }
     send(type, payload, stableMessageId) {
+        if (this.recoveringTransport && type !== "hello" && type !== "heartbeat") {
+            throw new Error("The AI Guide control channel is reconnecting.");
+        }
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
             throw new Error("The AI Guide control channel is not connected.");
         }
@@ -510,6 +535,59 @@ export class ControlChannel {
             this.onDisconnect();
         }
     }
+    async recoverTransport(signal) {
+        this.transportRecoveryAttempted = true;
+        this.recoveringTransport = true;
+        const controller = new AbortController();
+        const abort = () => controller.abort();
+        signal.addEventListener("abort", abort, { once: true });
+        let timeout;
+        const deadline = new Promise((_resolve, reject) => {
+            timeout = setTimeout(() => {
+                controller.abort();
+                reject(new Error("The control reconnect timed out."));
+            }, TRANSPORT_RECOVERY_TIMEOUT_MS);
+        });
+        const fencingToken = this.fencingToken;
+        let recovered = false;
+        try {
+            await Promise.race([
+                deadline,
+                (async () => {
+                    if (signal.aborted)
+                        throw new Error("The control connection was retired.");
+                    await this.connect(controller.signal, true);
+                    const hello = await this.waitForHelloOutcome(2000);
+                    if (hello.status !== "ack" || controller.signal.aborted) {
+                        throw new Error("The control reconnect was not acknowledged.");
+                    }
+                    const authority = await this.proveFencedAuthority(2000);
+                    if (authority.status !== "ack" ||
+                        controller.signal.aborted ||
+                        this.fencingToken !== fencingToken ||
+                        !this.transportRecovery?.canRecover()) {
+                        throw new Error("The control reconnect no longer owns this session.");
+                    }
+                    this.recoveringTransport = false;
+                    await this.transportRecovery.onRecovered();
+                    recovered = !controller.signal.aborted && this.hasFencedAuthority;
+                })(),
+            ]);
+        }
+        catch {
+            // The existing full-resume path revokes local executable authority and
+            // handles expired credentials, changed ownership, and longer outages.
+        }
+        finally {
+            clearTimeout(timeout);
+            signal.removeEventListener("abort", abort);
+            this.recoveringTransport = false;
+            if (!recovered && !signal.aborted && !this.intentionallyClosed) {
+                this.retireSocket("control reconnect failed");
+                this.notifyUnsafeDisconnect();
+            }
+        }
+    }
     enqueueHandlers(message, socket, generation) {
         const isCurrent = () => this.isMessageSourceCurrent(socket, generation);
         if (!isCurrent())

package/lib/liveControlChannel.d.ts

@@ -1,5 +1,5 @@
 import { type LiveDuplexMediaOptions, type LiveDuplexMediaDependencies } from './liveDuplexMedia.js';
-export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.1";
+export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.8";
 export declare const LIVE_CONTROL_CLIENT_CAPABILITIES: readonly ["live_duplex_v1", "live_local_wake_v1", "live_fragment_captions_v1"];
 declare const phases: readonly ["voice_off", "local_listening", "wake_buffering", "starting", "active", "tentative_idle", "closing", "uncertain", "muted", "suspended", "budget_blocked", "ended"];
 export type LiveControlState = {

package/lib/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/lib/media.js

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

package/lib/ui.js

@@ -6790,7 +6790,9 @@ export 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/lib/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.5.1";
+export declare const VERSION = "7.5.8";

package/lib/version.js

@@ -1 +1 @@
-export const VERSION = '7.5.1';
+export const VERSION = '7.5.8';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oxvo/ai-live-assist",
   "description": "Secure AI Guide browser plugin for OXVO Sessions.",
-  "version": "7.5.1",
+  "version": "7.5.8",
   "keywords": [
     "ai-live-assist",
     "webrtc",