@oxvo/ai-live-assist 7.5.0 → 7.5.6

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.0";
+export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.6";
 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/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/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.0";
+export declare const VERSION = "7.5.6";

package/lib/version.js

@@ -1 +1 @@
-export const VERSION = '7.5.0';
+export const VERSION = '7.5.6';

package/package.json

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