@oxvo/ai-live-assist 7.5.0 → 7.5.1

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.0";
+    readonly version = "7.5.1";
     private readonly host;
     private readonly guideAdmission;
     private readonly standaloneAdmissionPending;

package/cjs/context.js

@@ -78,6 +78,7 @@ const navigationTargetBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -122,6 +123,7 @@ const actionTargetFingerprintBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -145,47 +147,91 @@ const actionTargetFingerprint = async (target, subtle = globalThis.crypto?.subtl
 };
 exports.actionTargetFingerprint = actionTargetFingerprint;
 const isHTMLElement = (value) => value instanceof HTMLElement;
+// Clipping is checked in document geometry, not against the viewport: a
+// rendered footer link remains discoverable before it is scrolled into view.
+// No hidden descendant text is inspected to discover a navigation menu.
+const clippedRect = (element) => {
+    const rect = element.getBoundingClientRect();
+    let { left, top, right, bottom } = rect;
+    let depth = 0;
+    for (let parent = element.parentElement; parent; parent = parent.parentElement) {
+        if (++depth > 64)
+            return null;
+        const style = window.getComputedStyle(parent);
+        if (Number.parseFloat(style.opacity) === 0 || style.visibility === 'hidden' || style.display === 'none' || style.contentVisibility === 'hidden')
+            return null;
+        if (parent === document.body || parent === document.documentElement)
+            continue;
+        const bounds = parent.getBoundingClientRect();
+        // Overflow scrolling can reveal an offscreen descendant. A collapsed or
+        // clipped disclosure cannot be revealed by scrolling the document to it.
+        if (['hidden', 'clip'].includes(style.overflowX)) {
+            left = Math.max(left, bounds.left);
+            right = Math.min(right, bounds.right);
+        }
+        if (['hidden', 'clip'].includes(style.overflowY)) {
+            top = Math.max(top, bounds.top);
+            bottom = Math.min(bottom, bounds.bottom);
+        }
+        if (right <= left || bottom <= top)
+            return null;
+    }
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
+};
 const isRendered = (element) => {
-    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR)) {
+    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR))
         return false;
-    }
     const style = window.getComputedStyle(element);
-    const opacity = Number.parseFloat(style.opacity);
-    if (style.display === 'none' ||
-        style.visibility === 'hidden' ||
-        (Number.isFinite(opacity) && opacity === 0) ||
-        style.pointerEvents === 'none') {
+    if (style.display === 'none' || style.visibility === 'hidden' ||
+        Number.parseFloat(style.opacity) === 0 || style.pointerEvents === 'none')
         return false;
-    }
-    const rect = element.getBoundingClientRect();
-    return rect.width > 0 && rect.height > 0;
+    return clippedRect(element) !== null;
 };
-const isVisible = (element) => {
+const visibleRect = (element) => {
     if (!isRendered(element))
-        return false;
-    const rect = element.getBoundingClientRect();
-    return (rect.bottom >= 0 &&
-        rect.right >= 0 &&
-        rect.top <= window.innerHeight &&
-        rect.left <= window.innerWidth);
+        return null;
+    const rect = clippedRect(element);
+    if (!rect)
+        return null;
+    const left = Math.max(0, rect.left), top = Math.max(0, rect.top);
+    const right = Math.min(window.innerWidth, rect.right), bottom = Math.min(window.innerHeight, rect.bottom);
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
 };
+const isVisible = (element) => visibleRect(element) !== null;
 const isCovered = (element, trustedGuideRoot = null) => {
-    const rect = element.getBoundingClientRect();
-    const x = Math.max(0, Math.min(window.innerWidth - 1, rect.left + rect.width / 2));
-    const y = Math.max(0, Math.min(window.innerHeight - 1, rect.top + rect.height / 2));
-    let top;
-    if (trustedGuideRoot?.isConnected &&
-        typeof document.elementsFromPoint === 'function') {
-        top =
-            document
-                .elementsFromPoint(x, y)
-                .find((candidate) => candidate !== trustedGuideRoot) ??
-                document.elementFromPoint(x, y);
-    }
-    else {
-        top = document.elementFromPoint(x, y);
-    }
-    return Boolean(top && top !== element && !element.contains(top) && !top.contains(element));
+    const rect = visibleRect(element);
+    if (!rect)
+        return true;
+    // Five bounded hit tests permit an exposed part of a link without treating
+    // an ancestor, empty hit, or a covering sibling as an interactable target.
+    const insetX = Math.min(1, (rect.right - rect.left) / 4);
+    const insetY = Math.min(1, (rect.bottom - rect.top) / 4);
+    const points = [
+        [(rect.left + rect.right) / 2, (rect.top + rect.bottom) / 2],
+        [rect.left + insetX, rect.top + insetY], [rect.right - insetX, rect.top + insetY],
+        [rect.left + insetX, rect.bottom - insetY], [rect.right - insetX, rect.bottom - insetY],
+    ];
+    return !points.some(([x, y]) => {
+        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));
+    });
+};
+const isNavigationMenu = (element, role) => {
+    if (role !== 'button' || literalBooleanAttribute(element, 'aria-expanded') === undefined ||
+        element.hasAttribute('aria-pressed') || element.hasAttribute('aria-checked') ||
+        element instanceof HTMLButtonElement && element.form !== null && element.type !== 'button')
+        return false;
+    if (element.closest('nav,[role="navigation"]'))
+        return true;
+    // aria-controls supplies identity only. Do not capture hidden menu labels,
+    // links, values or instructions before native expansion and recapture.
+    const controls = (element.getAttribute('aria-controls') ?? '').trim().split(/\s+/).slice(0, 4);
+    return controls.some(control => {
+        const menu = document.getElementById(control);
+        return menu !== null && menu.matches('nav,[role="navigation"],[role="menu"]');
+    });
 };
 const safePageUrl = () => `${window.location.origin}${window.location.pathname}`;
 const linkBrowsingTarget = (link) => (link.getAttribute('target') ?? document.querySelector('base[target]')?.getAttribute('target') ?? '').toLowerCase();
@@ -197,11 +243,13 @@ const sameNavigationDestination = (actual, expected) => {
     return left.origin === right.origin && left.pathname === right.pathname && left.search === right.search;
 };
 const safeDestinationPath = (element) => {
-    if (!(element instanceof HTMLAnchorElement))
+    // An empty href is a control, not authority to navigate to the current URL.
+    if (!(element instanceof HTMLAnchorElement) || !element.getAttribute('href')?.trim())
         return null;
     try {
         const destination = new URL(element.href, window.location.href);
         if (destination.origin !== window.location.origin ||
+            destination.username !== '' || destination.password !== '' ||
             destination.search ||
             destination.hash ||
             !destination.pathname.startsWith('/') ||
@@ -1061,6 +1109,7 @@ class PageContextCollector {
                     }
                     : {}),
                 ...(semanticRegion ? { semanticRegion } : {}),
+                ...(this.statefulButtonActionProof && isNavigationMenu(element, role) ? { navigationMenu: true } : {}),
                 ...(destinationPath ? { destinationPath } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || regionAssessment.matchedRuleDigests.length > 0,
@@ -1172,6 +1221,7 @@ class PageContextCollector {
             pageId: this.pageId,
             revision,
             url: safePageUrl(),
+            locationHasQuery: window.location.search !== '',
             title: normalize(document.title, 512),
             locale: normalize(document.documentElement.lang || navigator.language || 'en', 16),
             viewport: {

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.0";
+export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.1";
 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/types.d.ts

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

package/cjs/version.d.ts

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

package/cjs/version.js

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

package/lib/AiLiveAssist.d.ts

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

package/lib/context.js

@@ -75,6 +75,7 @@ const navigationTargetBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -119,6 +120,7 @@ const actionTargetFingerprintBinding = (target) => canonicalJson({
     inputType: target.inputType ?? null,
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
+    ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -141,47 +143,91 @@ export const actionTargetFingerprint = async (target, subtle = globalThis.crypto
     }
 };
 const isHTMLElement = (value) => value instanceof HTMLElement;
+// Clipping is checked in document geometry, not against the viewport: a
+// rendered footer link remains discoverable before it is scrolled into view.
+// No hidden descendant text is inspected to discover a navigation menu.
+const clippedRect = (element) => {
+    const rect = element.getBoundingClientRect();
+    let { left, top, right, bottom } = rect;
+    let depth = 0;
+    for (let parent = element.parentElement; parent; parent = parent.parentElement) {
+        if (++depth > 64)
+            return null;
+        const style = window.getComputedStyle(parent);
+        if (Number.parseFloat(style.opacity) === 0 || style.visibility === 'hidden' || style.display === 'none' || style.contentVisibility === 'hidden')
+            return null;
+        if (parent === document.body || parent === document.documentElement)
+            continue;
+        const bounds = parent.getBoundingClientRect();
+        // Overflow scrolling can reveal an offscreen descendant. A collapsed or
+        // clipped disclosure cannot be revealed by scrolling the document to it.
+        if (['hidden', 'clip'].includes(style.overflowX)) {
+            left = Math.max(left, bounds.left);
+            right = Math.min(right, bounds.right);
+        }
+        if (['hidden', 'clip'].includes(style.overflowY)) {
+            top = Math.max(top, bounds.top);
+            bottom = Math.min(bottom, bounds.bottom);
+        }
+        if (right <= left || bottom <= top)
+            return null;
+    }
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
+};
 const isRendered = (element) => {
-    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR)) {
+    if (!isHTMLElement(element) || !element.isConnected || element.closest(PRIVATE_SELECTOR))
         return false;
-    }
     const style = window.getComputedStyle(element);
-    const opacity = Number.parseFloat(style.opacity);
-    if (style.display === 'none' ||
-        style.visibility === 'hidden' ||
-        (Number.isFinite(opacity) && opacity === 0) ||
-        style.pointerEvents === 'none') {
+    if (style.display === 'none' || style.visibility === 'hidden' ||
+        Number.parseFloat(style.opacity) === 0 || style.pointerEvents === 'none')
         return false;
-    }
-    const rect = element.getBoundingClientRect();
-    return rect.width > 0 && rect.height > 0;
+    return clippedRect(element) !== null;
 };
-const isVisible = (element) => {
+const visibleRect = (element) => {
     if (!isRendered(element))
-        return false;
-    const rect = element.getBoundingClientRect();
-    return (rect.bottom >= 0 &&
-        rect.right >= 0 &&
-        rect.top <= window.innerHeight &&
-        rect.left <= window.innerWidth);
+        return null;
+    const rect = clippedRect(element);
+    if (!rect)
+        return null;
+    const left = Math.max(0, rect.left), top = Math.max(0, rect.top);
+    const right = Math.min(window.innerWidth, rect.right), bottom = Math.min(window.innerHeight, rect.bottom);
+    return right > left && bottom > top ? { left, top, right, bottom } : null;
 };
+const isVisible = (element) => visibleRect(element) !== null;
 const isCovered = (element, trustedGuideRoot = null) => {
-    const rect = element.getBoundingClientRect();
-    const x = Math.max(0, Math.min(window.innerWidth - 1, rect.left + rect.width / 2));
-    const y = Math.max(0, Math.min(window.innerHeight - 1, rect.top + rect.height / 2));
-    let top;
-    if (trustedGuideRoot?.isConnected &&
-        typeof document.elementsFromPoint === 'function') {
-        top =
-            document
-                .elementsFromPoint(x, y)
-                .find((candidate) => candidate !== trustedGuideRoot) ??
-                document.elementFromPoint(x, y);
-    }
-    else {
-        top = document.elementFromPoint(x, y);
-    }
-    return Boolean(top && top !== element && !element.contains(top) && !top.contains(element));
+    const rect = visibleRect(element);
+    if (!rect)
+        return true;
+    // Five bounded hit tests permit an exposed part of a link without treating
+    // an ancestor, empty hit, or a covering sibling as an interactable target.
+    const insetX = Math.min(1, (rect.right - rect.left) / 4);
+    const insetY = Math.min(1, (rect.bottom - rect.top) / 4);
+    const points = [
+        [(rect.left + rect.right) / 2, (rect.top + rect.bottom) / 2],
+        [rect.left + insetX, rect.top + insetY], [rect.right - insetX, rect.top + insetY],
+        [rect.left + insetX, rect.bottom - insetY], [rect.right - insetX, rect.bottom - insetY],
+    ];
+    return !points.some(([x, y]) => {
+        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));
+    });
+};
+const isNavigationMenu = (element, role) => {
+    if (role !== 'button' || literalBooleanAttribute(element, 'aria-expanded') === undefined ||
+        element.hasAttribute('aria-pressed') || element.hasAttribute('aria-checked') ||
+        element instanceof HTMLButtonElement && element.form !== null && element.type !== 'button')
+        return false;
+    if (element.closest('nav,[role="navigation"]'))
+        return true;
+    // aria-controls supplies identity only. Do not capture hidden menu labels,
+    // links, values or instructions before native expansion and recapture.
+    const controls = (element.getAttribute('aria-controls') ?? '').trim().split(/\s+/).slice(0, 4);
+    return controls.some(control => {
+        const menu = document.getElementById(control);
+        return menu !== null && menu.matches('nav,[role="navigation"],[role="menu"]');
+    });
 };
 const safePageUrl = () => `${window.location.origin}${window.location.pathname}`;
 const linkBrowsingTarget = (link) => (link.getAttribute('target') ?? document.querySelector('base[target]')?.getAttribute('target') ?? '').toLowerCase();
@@ -193,11 +239,13 @@ const sameNavigationDestination = (actual, expected) => {
     return left.origin === right.origin && left.pathname === right.pathname && left.search === right.search;
 };
 const safeDestinationPath = (element) => {
-    if (!(element instanceof HTMLAnchorElement))
+    // An empty href is a control, not authority to navigate to the current URL.
+    if (!(element instanceof HTMLAnchorElement) || !element.getAttribute('href')?.trim())
         return null;
     try {
         const destination = new URL(element.href, window.location.href);
         if (destination.origin !== window.location.origin ||
+            destination.username !== '' || destination.password !== '' ||
             destination.search ||
             destination.hash ||
             !destination.pathname.startsWith('/') ||
@@ -1057,6 +1105,7 @@ export class PageContextCollector {
                     }
                     : {}),
                 ...(semanticRegion ? { semanticRegion } : {}),
+                ...(this.statefulButtonActionProof && isNavigationMenu(element, role) ? { navigationMenu: true } : {}),
                 ...(destinationPath ? { destinationPath } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || regionAssessment.matchedRuleDigests.length > 0,
@@ -1168,6 +1217,7 @@ export class PageContextCollector {
             pageId: this.pageId,
             revision,
             url: safePageUrl(),
+            locationHasQuery: window.location.search !== '',
             title: normalize(document.title, 512),
             locale: normalize(document.documentElement.lang || navigator.language || 'en', 16),
             viewport: {

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.1";
 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/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/version.d.ts

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

package/lib/version.js

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

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.1",
   "keywords": [
     "ai-live-assist",
     "webrtc",