@oxvo/ai-live-assist 7.4.49 → 7.4.51

package/cjs/AiLiveAssist.d.ts

@@ -39,7 +39,7 @@ export declare const resolveAiGuideProtocolVersion: (bootstrap: Pick<BootstrapCo
 export default class AiLiveAssist {
     private readonly app;
     private readonly options;
-    readonly version = "7.4.49";
+    readonly version = "7.4.51";
     private readonly siteKey;
     private tabId;
     private readonly windowId;

package/cjs/AiLiveAssist.js

@@ -6946,9 +6946,18 @@ class AiLiveAssist {
             !this.pendingLaunchMatches(this.lastLaunch, pendingLaunch)) {
             return;
         }
-        this.lastLaunch = null;
         this.clearPendingIntent();
         this.view?.showActiveElsewhere(false);
+        if (messageKey === "visitorAlreadyActive") {
+            // The explicit entry action has already staged the compact Voice/Text
+            // surface. Keep that surface as a retryable, closable recovery card.
+            // The generic unavailable presenter resets compact state while leaving
+            // the open panel mounted, which produces an empty full-height shell.
+            this.view?.showError(this.view.message(messageKey), true, false);
+            this.state("error");
+            return;
+        }
+        this.lastLaunch = null;
         this.view?.showLaunchUnavailable(this.view.message(messageKey));
         this.state("ready");
     }
@@ -13415,6 +13424,11 @@ class AiLiveAssist {
             return this.resume(resume);
         }
         if (this.lastLaunch) {
+            if (this.visitorActiveTakeoverOnly) {
+                // A deliberate retry gets one fresh bounded eligibility check. The
+                // key still prevents accidental automatic replay loops.
+                this.visitorActiveEligibilityRecheckKey = null;
+            }
             return this.launch(this.lastLaunch.mode, this.lastLaunch.scopes, this.lastLaunch.idempotencyKey, { pendingLaunch: this.lastLaunch });
         }
     }

package/cjs/context.d.ts

@@ -60,6 +60,11 @@ export declare class PageContextCollector {
     private scheduleCapture;
     private scheduleMutationCapture;
     private scheduleViewportCapture;
+    private mutationNodeIsInsideTrustedGuide;
+    private mutationIsInsideTrustedGuide;
+    private mutationNodeTouchesSemanticContext;
+    private mutationNodeContainsSemanticContext;
+    private mutationNeedsImmediateCapture;
     private handleMutations;
     private captureAndPublishIfChanged;
     private semanticSignature;

package/cjs/context.js

@@ -12,6 +12,7 @@ const CAPTURE_SETTLE_MS = 250;
 const MUTATION_CAPTURE_DEBOUNCE_MS = 350;
 const FRAMER_TOGGLE_ROOT_SELECTOR = '[data-framer-name="Toggle"]';
 const FRAMER_TOGGLE_CONTROL_SELECTOR = 'div[name="Toggle Switch"][data-highlight="true"][tabindex]';
+const ACTIONABLE_MUTATION_SELECTOR = `a[href],button,input,select,textarea,summary,[role="button"],[role="link"],[role="tab"],[role="menuitem"],[role="option"],[role="checkbox"],[role="radio"],[role="switch"],[role="combobox"],[role="listbox"],[role="treeitem"],[role="slider"],[role="spinbutton"],[role="searchbox"],[role="textbox"],${FRAMER_TOGGLE_CONTROL_SELECTOR}`;
 const MAX_FRAMER_TOGGLE_LABEL = 120;
 const PRIVATE_SELECTOR = [
     '[data-oxvo-ai-live-assist-root]',
@@ -692,9 +693,48 @@ class PageContextCollector {
         this.scheduleViewportCapture = () => {
             this.scheduleMutationCapture();
         };
+        this.mutationNodeIsInsideTrustedGuide = (node) => Boolean(this.trustedGuideRoot &&
+            (node === this.trustedGuideRoot || this.trustedGuideRoot.contains(node)));
+        this.mutationIsInsideTrustedGuide = (record) => {
+            if (this.mutationNodeIsInsideTrustedGuide(record.target))
+                return true;
+            if (record.type !== 'childList')
+                return false;
+            const changedNodes = [...record.addedNodes, ...record.removedNodes];
+            return (changedNodes.length > 0 &&
+                changedNodes.every(this.mutationNodeIsInsideTrustedGuide));
+        };
+        this.mutationNodeTouchesSemanticContext = (node) => {
+            const element = node instanceof Element
+                ? node
+                : node.nodeType === Node.TEXT_NODE
+                    ? node.parentElement
+                    : null;
+            return Boolean(element &&
+                (element.matches(ACTIONABLE_MUTATION_SELECTOR) ||
+                    element.closest(ACTIONABLE_MUTATION_SELECTOR)));
+        };
+        this.mutationNodeContainsSemanticContext = (node) => this.mutationNodeTouchesSemanticContext(node) ||
+            Boolean(node instanceof Element &&
+                node.querySelector(ACTIONABLE_MUTATION_SELECTOR));
+        this.mutationNeedsImmediateCapture = (record) => {
+            if (record.type === 'attributes') {
+                if (record.attributeName === 'class' || record.attributeName === 'style') {
+                    return false;
+                }
+                return this.mutationNodeTouchesSemanticContext(record.target);
+            }
+            if (this.mutationNodeTouchesSemanticContext(record.target))
+                return true;
+            if (record.type !== 'childList')
+                return false;
+            return [...record.addedNodes, ...record.removedNodes].some(this.mutationNodeContainsSemanticContext);
+        };
         this.handleMutations = (records) => {
-            const hasSemanticMutation = records.some((record) => record.type !== 'attributes' ||
-                (record.attributeName !== 'class' && record.attributeName !== 'style'));
+            const relevantRecords = records.filter((record) => !this.mutationIsInsideTrustedGuide(record));
+            if (relevantRecords.length === 0)
+                return;
+            const hasSemanticMutation = relevantRecords.some(this.mutationNeedsImmediateCapture);
             if (hasSemanticMutation)
                 this.scheduleCapture();
             else

package/cjs/index.js

@@ -18,8 +18,8 @@ function aiLiveAssist(options = {}) {
         if (document.querySelector('[data-oxvo-ai-live-assist-root]')) {
             return undefined;
         }
-        if (!app.checkRequiredVersion?.('7.4.49')) {
-            console.warn('OXVO AI Guide requires @oxvo/browser version 7.4.49 or newer.');
+        if (!app.checkRequiredVersion?.('7.4.51')) {
+            console.warn('OXVO AI Guide requires @oxvo/browser version 7.4.51 or newer.');
             return undefined;
         }
         const instance = new AiLiveAssist_js_1.default(app, options);

package/cjs/preview.d.ts

@@ -2,7 +2,7 @@ import type { AiGuidePreviewBridge, AiGuidePreviewController, AiGuidePreviewCont
 export declare const AI_GUIDE_PREVIEW_PARENT_SOURCE = "oxvo-ai-guide-settings-preview";
 export declare const AI_GUIDE_PREVIEW_WIDGET_SOURCE = "oxvo-ai-guide-widget-preview";
 export declare const AI_GUIDE_PREVIEW_PROTOCOL_VERSION = 1;
-export declare const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.48";
+export declare const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.49";
 export declare const buildAiGuidePreviewBootstrap: (draft: unknown, assetOrigin?: string | null) => BootstrapConfig;
 export declare class AiGuidePreviewControllerImpl implements AiGuidePreviewController {
     private readonly port;

package/cjs/preview.js

@@ -9,7 +9,7 @@ const voicePresenceUi_js_1 = require("./voicePresenceUi.js");
 exports.AI_GUIDE_PREVIEW_PARENT_SOURCE = "oxvo-ai-guide-settings-preview";
 exports.AI_GUIDE_PREVIEW_WIDGET_SOURCE = "oxvo-ai-guide-widget-preview";
 exports.AI_GUIDE_PREVIEW_PROTOCOL_VERSION = 1;
-exports.AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.48";
+exports.AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.49";
 const DEFAULT_COMPANION = {
     enabled: true,
     title: "AI Guide",

package/cjs/ui.js

@@ -6673,10 +6673,25 @@ class WidgetView {
         if (!element || !element.isConnected)
             return;
         const rect = element.getBoundingClientRect();
-        this.highlight.style.left = `${Math.max(0, rect.left - 4)}px`;
-        this.highlight.style.top = `${Math.max(0, rect.top - 4)}px`;
-        this.highlight.style.width = `${Math.max(8, rect.width + 8)}px`;
-        this.highlight.style.height = `${Math.max(8, rect.height + 8)}px`;
+        const visual = window.visualViewport;
+        const viewportLeft = visual?.offsetLeft ?? 0;
+        const viewportTop = visual?.offsetTop ?? 0;
+        const viewportRight = viewportLeft + (visual?.width ?? window.innerWidth);
+        const viewportBottom = viewportTop + (visual?.height ?? window.innerHeight);
+        if (rect.right <= viewportLeft ||
+            rect.bottom <= viewportTop ||
+            rect.left >= viewportRight ||
+            rect.top >= viewportBottom) {
+            return;
+        }
+        const left = Math.max(viewportLeft, rect.left - 4);
+        const top = Math.max(viewportTop, rect.top - 4);
+        const right = Math.min(viewportRight, rect.right + 4);
+        const bottom = Math.min(viewportBottom, rect.bottom + 4);
+        this.highlight.style.left = `${left}px`;
+        this.highlight.style.top = `${top}px`;
+        this.highlight.style.width = `${right - left}px`;
+        this.highlight.style.height = `${bottom - top}px`;
         this.highlight.classList.add("visible");
     }
     safetySurfaceVisible() {

package/cjs/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.4.49";
+export declare const VERSION = "7.4.51";

package/cjs/version.js

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

package/lib/AiLiveAssist.d.ts

@@ -39,7 +39,7 @@ export declare const resolveAiGuideProtocolVersion: (bootstrap: Pick<BootstrapCo
 export default class AiLiveAssist {
     private readonly app;
     private readonly options;
-    readonly version = "7.4.49";
+    readonly version = "7.4.51";
     private readonly siteKey;
     private tabId;
     private readonly windowId;

package/lib/AiLiveAssist.js

@@ -6938,9 +6938,18 @@ export default class AiLiveAssist {
             !this.pendingLaunchMatches(this.lastLaunch, pendingLaunch)) {
             return;
         }
-        this.lastLaunch = null;
         this.clearPendingIntent();
         this.view?.showActiveElsewhere(false);
+        if (messageKey === "visitorAlreadyActive") {
+            // The explicit entry action has already staged the compact Voice/Text
+            // surface. Keep that surface as a retryable, closable recovery card.
+            // The generic unavailable presenter resets compact state while leaving
+            // the open panel mounted, which produces an empty full-height shell.
+            this.view?.showError(this.view.message(messageKey), true, false);
+            this.state("error");
+            return;
+        }
+        this.lastLaunch = null;
         this.view?.showLaunchUnavailable(this.view.message(messageKey));
         this.state("ready");
     }
@@ -13407,6 +13416,11 @@ export default class AiLiveAssist {
             return this.resume(resume);
         }
         if (this.lastLaunch) {
+            if (this.visitorActiveTakeoverOnly) {
+                // A deliberate retry gets one fresh bounded eligibility check. The
+                // key still prevents accidental automatic replay loops.
+                this.visitorActiveEligibilityRecheckKey = null;
+            }
             return this.launch(this.lastLaunch.mode, this.lastLaunch.scopes, this.lastLaunch.idempotencyKey, { pendingLaunch: this.lastLaunch });
         }
     }

package/lib/context.d.ts

@@ -60,6 +60,11 @@ export declare class PageContextCollector {
     private scheduleCapture;
     private scheduleMutationCapture;
     private scheduleViewportCapture;
+    private mutationNodeIsInsideTrustedGuide;
+    private mutationIsInsideTrustedGuide;
+    private mutationNodeTouchesSemanticContext;
+    private mutationNodeContainsSemanticContext;
+    private mutationNeedsImmediateCapture;
     private handleMutations;
     private captureAndPublishIfChanged;
     private semanticSignature;

package/lib/context.js

@@ -9,6 +9,7 @@ const CAPTURE_SETTLE_MS = 250;
 const MUTATION_CAPTURE_DEBOUNCE_MS = 350;
 const FRAMER_TOGGLE_ROOT_SELECTOR = '[data-framer-name="Toggle"]';
 const FRAMER_TOGGLE_CONTROL_SELECTOR = 'div[name="Toggle Switch"][data-highlight="true"][tabindex]';
+const ACTIONABLE_MUTATION_SELECTOR = `a[href],button,input,select,textarea,summary,[role="button"],[role="link"],[role="tab"],[role="menuitem"],[role="option"],[role="checkbox"],[role="radio"],[role="switch"],[role="combobox"],[role="listbox"],[role="treeitem"],[role="slider"],[role="spinbutton"],[role="searchbox"],[role="textbox"],${FRAMER_TOGGLE_CONTROL_SELECTOR}`;
 const MAX_FRAMER_TOGGLE_LABEL = 120;
 const PRIVATE_SELECTOR = [
     '[data-oxvo-ai-live-assist-root]',
@@ -688,9 +689,48 @@ export class PageContextCollector {
         this.scheduleViewportCapture = () => {
             this.scheduleMutationCapture();
         };
+        this.mutationNodeIsInsideTrustedGuide = (node) => Boolean(this.trustedGuideRoot &&
+            (node === this.trustedGuideRoot || this.trustedGuideRoot.contains(node)));
+        this.mutationIsInsideTrustedGuide = (record) => {
+            if (this.mutationNodeIsInsideTrustedGuide(record.target))
+                return true;
+            if (record.type !== 'childList')
+                return false;
+            const changedNodes = [...record.addedNodes, ...record.removedNodes];
+            return (changedNodes.length > 0 &&
+                changedNodes.every(this.mutationNodeIsInsideTrustedGuide));
+        };
+        this.mutationNodeTouchesSemanticContext = (node) => {
+            const element = node instanceof Element
+                ? node
+                : node.nodeType === Node.TEXT_NODE
+                    ? node.parentElement
+                    : null;
+            return Boolean(element &&
+                (element.matches(ACTIONABLE_MUTATION_SELECTOR) ||
+                    element.closest(ACTIONABLE_MUTATION_SELECTOR)));
+        };
+        this.mutationNodeContainsSemanticContext = (node) => this.mutationNodeTouchesSemanticContext(node) ||
+            Boolean(node instanceof Element &&
+                node.querySelector(ACTIONABLE_MUTATION_SELECTOR));
+        this.mutationNeedsImmediateCapture = (record) => {
+            if (record.type === 'attributes') {
+                if (record.attributeName === 'class' || record.attributeName === 'style') {
+                    return false;
+                }
+                return this.mutationNodeTouchesSemanticContext(record.target);
+            }
+            if (this.mutationNodeTouchesSemanticContext(record.target))
+                return true;
+            if (record.type !== 'childList')
+                return false;
+            return [...record.addedNodes, ...record.removedNodes].some(this.mutationNodeContainsSemanticContext);
+        };
         this.handleMutations = (records) => {
-            const hasSemanticMutation = records.some((record) => record.type !== 'attributes' ||
-                (record.attributeName !== 'class' && record.attributeName !== 'style'));
+            const relevantRecords = records.filter((record) => !this.mutationIsInsideTrustedGuide(record));
+            if (relevantRecords.length === 0)
+                return;
+            const hasSemanticMutation = relevantRecords.some(this.mutationNeedsImmediateCapture);
             if (hasSemanticMutation)
                 this.scheduleCapture();
             else

package/lib/index.js

@@ -12,8 +12,8 @@ export default function aiLiveAssist(options = {}) {
         if (document.querySelector('[data-oxvo-ai-live-assist-root]')) {
             return undefined;
         }
-        if (!app.checkRequiredVersion?.('7.4.49')) {
-            console.warn('OXVO AI Guide requires @oxvo/browser version 7.4.49 or newer.');
+        if (!app.checkRequiredVersion?.('7.4.51')) {
+            console.warn('OXVO AI Guide requires @oxvo/browser version 7.4.51 or newer.');
             return undefined;
         }
         const instance = new AiLiveAssist(app, options);

package/lib/preview.d.ts

@@ -2,7 +2,7 @@ import type { AiGuidePreviewBridge, AiGuidePreviewController, AiGuidePreviewCont
 export declare const AI_GUIDE_PREVIEW_PARENT_SOURCE = "oxvo-ai-guide-settings-preview";
 export declare const AI_GUIDE_PREVIEW_WIDGET_SOURCE = "oxvo-ai-guide-widget-preview";
 export declare const AI_GUIDE_PREVIEW_PROTOCOL_VERSION = 1;
-export declare const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.48";
+export declare const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.49";
 export declare const buildAiGuidePreviewBootstrap: (draft: unknown, assetOrigin?: string | null) => BootstrapConfig;
 export declare class AiGuidePreviewControllerImpl implements AiGuidePreviewController {
     private readonly port;

package/lib/preview.js

@@ -6,7 +6,7 @@ import { VoicePresenceView } from "./voicePresenceUi.js";
 export const AI_GUIDE_PREVIEW_PARENT_SOURCE = "oxvo-ai-guide-settings-preview";
 export const AI_GUIDE_PREVIEW_WIDGET_SOURCE = "oxvo-ai-guide-widget-preview";
 export const AI_GUIDE_PREVIEW_PROTOCOL_VERSION = 1;
-export const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.48";
+export const AI_GUIDE_PREVIEW_RENDERER_VERSION = "1.0.49";
 const DEFAULT_COMPANION = {
     enabled: true,
     title: "AI Guide",

package/lib/ui.js

@@ -6670,10 +6670,25 @@ export class WidgetView {
         if (!element || !element.isConnected)
             return;
         const rect = element.getBoundingClientRect();
-        this.highlight.style.left = `${Math.max(0, rect.left - 4)}px`;
-        this.highlight.style.top = `${Math.max(0, rect.top - 4)}px`;
-        this.highlight.style.width = `${Math.max(8, rect.width + 8)}px`;
-        this.highlight.style.height = `${Math.max(8, rect.height + 8)}px`;
+        const visual = window.visualViewport;
+        const viewportLeft = visual?.offsetLeft ?? 0;
+        const viewportTop = visual?.offsetTop ?? 0;
+        const viewportRight = viewportLeft + (visual?.width ?? window.innerWidth);
+        const viewportBottom = viewportTop + (visual?.height ?? window.innerHeight);
+        if (rect.right <= viewportLeft ||
+            rect.bottom <= viewportTop ||
+            rect.left >= viewportRight ||
+            rect.top >= viewportBottom) {
+            return;
+        }
+        const left = Math.max(viewportLeft, rect.left - 4);
+        const top = Math.max(viewportTop, rect.top - 4);
+        const right = Math.min(viewportRight, rect.right + 4);
+        const bottom = Math.min(viewportBottom, rect.bottom + 4);
+        this.highlight.style.left = `${left}px`;
+        this.highlight.style.top = `${top}px`;
+        this.highlight.style.width = `${right - left}px`;
+        this.highlight.style.height = `${bottom - top}px`;
         this.highlight.classList.add("visible");
     }
     safetySurfaceVisible() {

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.4.49";
+export declare const VERSION = "7.4.51";

package/lib/version.js

@@ -1 +1 @@
-export const VERSION = '7.4.49';
+export const VERSION = '7.4.51';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oxvo/ai-live-assist",
   "description": "Secure AI Guide browser plugin for OXVO Sessions.",
-  "version": "7.4.49",
+  "version": "7.4.51",
   "keywords": [
     "ai-live-assist",
     "webrtc",
@@ -42,10 +42,10 @@
     "prepublishOnly": "bun run test && bun run build"
   },
   "peerDependencies": {
-    "@oxvo/browser": ">=7.4.49"
+    "@oxvo/browser": ">=7.4.51"
   },
   "devDependencies": {
-    "@oxvo/browser": "workspace:*",
+    "@oxvo/browser": "7.4.51",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "eslint": "^9.39.2",