@oxvo/ai-live-assist 7.5.8 → 7.5.10

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

package/cjs/context.d.ts

@@ -27,6 +27,7 @@ export declare class PageContextCollector {
     private targetIds;
     private pageScrollIds;
     private navigationTargetBindings;
+    private navigationDisclosureLinks;
     private fieldTargetBindings;
     private fieldAppliedRevisions;
     private textIds;
@@ -70,6 +71,8 @@ export declare class PageContextCollector {
     private type;
     private select;
     private submit;
+    private exposedNavigationLinks;
+    private expandedState;
     private safeState;
     private scrollTargetIntoView;
     private waitForScrollSettlement;

package/cjs/context.js

@@ -20,7 +20,7 @@ const RELEASED_NAVIGATION_SETTLEMENT_TIMEOUT_MS = 5000;
 const FRAMER_GENERATED_PAGE_SELECTOR = '[data-framer-generated-page]';
 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 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"],[data-highlight="true"][tabindex],${FRAMER_TOGGLE_CONTROL_SELECTOR}`;
 const MAX_FRAMER_TOGGLE_LABEL = 120;
 const PRIVATE_SELECTOR = [
     '[data-oxvo-ai-live-assist-root]',
@@ -80,6 +80,7 @@ const navigationTargetBinding = (target) => canonicalJson({
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
     ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
+    ...(target.navigation ? { navigation: target.navigation } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -125,6 +126,7 @@ const actionTargetFingerprintBinding = (target) => canonicalJson({
     autocomplete: target.autocomplete ?? null,
     semanticRegion: target.semanticRegion ?? null,
     ...(target.navigationMenu === true ? { navigationMenu: true } : {}),
+    ...(target.navigation ? { navigation: target.navigation } : {}),
     destinationPath: target.destinationPath ?? null,
     sensitivity: target.sensitivity,
     protectedRegion: target.protectedRegion ?? null,
@@ -222,8 +224,27 @@ const interactionPoint = (element, trustedGuideRoot = null) => {
     return null;
 };
 const isCovered = (element, trustedGuideRoot = null) => interactionPoint(element, trustedGuideRoot) === null;
+const FRAMER_NAVIGATION_CONTROL_SELECTOR = 'div[data-highlight="true"][tabindex]';
+const framerNavigationRoot = (element) => {
+    if (!(element instanceof HTMLElement) || !element.matches(FRAMER_NAVIGATION_CONTROL_SELECTOR) ||
+        element.tabIndex < 0 || element.hasAttribute('role') || element.hasAttribute('aria-pressed') ||
+        element.hasAttribute('aria-checked') || !element.getAttribute('data-framer-name')?.trim() ||
+        !element.closest(FRAMER_GENERATED_PAGE_SELECTOR) || element.closest(`form,${PRIVATE_SELECTOR}`) ||
+        element.querySelector('a,button,input,select,textarea,summary,form,[role],[tabindex],[contenteditable]') ||
+        element.textContent?.trim())
+        return null;
+    const nav = element.closest('nav,[role="navigation"]');
+    if (!nav)
+        return null;
+    const candidates = nav.querySelectorAll(FRAMER_NAVIGATION_CONTROL_SELECTOR);
+    if (candidates.length > MAX_TARGETS)
+        return null;
+    const rendered = Array.from(candidates).filter(candidate => isRendered(candidate) &&
+        candidate.closest('nav,[role="navigation"]') === nav);
+    return rendered.length === 1 && rendered[0] === element ? nav : null;
+};
 const isNavigationMenu = (element, role) => {
-    if (role !== 'button' || literalBooleanAttribute(element, 'aria-expanded') === undefined ||
+    if (role !== 'button' || (literalBooleanAttribute(element, 'aria-expanded') === undefined && !framerNavigationRoot(element)) ||
         element.hasAttribute('aria-pressed') || element.hasAttribute('aria-checked') ||
         element instanceof HTMLButtonElement && element.form !== null && element.type !== 'button')
         return false;
@@ -246,27 +267,31 @@ const sameNavigationDestination = (actual, expected) => {
     const left = new URL(actual), right = new URL(expected);
     return left.origin === right.origin && left.pathname === right.pathname && left.search === right.search;
 };
-const safeDestinationPath = (element) => {
-    // An empty href is a control, not authority to navigate to the current URL.
-    if (!(element instanceof HTMLAnchorElement) || !element.getAttribute('href')?.trim())
-        return null;
+const publicNavigation = (element) => {
+    if (!(element instanceof HTMLAnchorElement) || !element.getAttribute('href')?.trim() ||
+        !supportsCurrentTabNavigation(element))
+        return undefined;
     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('/') ||
-            destination.pathname.startsWith('//') ||
-            destination.pathname.length > 1024) {
-            return null;
-        }
-        return destination.pathname;
+        if (!['http:', 'https:'].includes(destination.protocol) ||
+            (destination.origin !== window.location.origin && destination.protocol !== 'https:') ||
+            destination.username || destination.password || destination.search || destination.hash ||
+            destination.href.length > 2048 || destination.pathname.length > 1024 ||
+            !/^\/(?:[A-Za-z0-9_~-]+(?:\.[A-Za-z0-9_~-]+)*\/?)*$/.test(destination.pathname))
+            return undefined;
+        return { url: destination.href, target: linkBrowsingTarget(element) === '_blank' ? '_blank' : '_self' };
     }
     catch {
-        return null;
+        return undefined;
     }
 };
+const safeDestinationPath = (element) => {
+    const navigation = publicNavigation(element);
+    if (!navigation)
+        return null;
+    const destination = new URL(navigation.url);
+    return destination.origin === window.location.origin ? destination.pathname : null;
+};
 const sensitivityFor = (element, name) => {
     const input = element instanceof HTMLInputElement ? element : null;
     const type = input?.type.toLowerCase() ?? '';
@@ -300,6 +325,8 @@ const sensitivityFor = (element, name) => {
 const roleFor = (element) => {
     if (framerToggleDescriptor(element))
         return 'checkbox';
+    if (framerNavigationRoot(element))
+        return 'button';
     const explicit = normalize(element.getAttribute('role') ?? '', 64);
     if (explicit)
         return explicit;
@@ -367,6 +394,7 @@ const nameFor = (element) => {
     return normalize(semanticName ||
         associatedLabel ||
         attributeName ||
+        (framerNavigationRoot(element) ? safeAttribute('data-framer-name', 120) : '') ||
         (buttonValue && sensitivityFor(element, buttonValue) === 'none' ? buttonValue : '') ||
         (safeDestinationPath(element) === '/' ? 'Home' : ''), 300);
 };
@@ -768,6 +796,7 @@ class PageContextCollector {
         this.targetIds = new WeakMap();
         this.pageScrollIds = new WeakMap();
         this.navigationTargetBindings = new WeakMap();
+        this.navigationDisclosureLinks = new WeakMap();
         this.fieldTargetBindings = new WeakMap();
         this.fieldAppliedRevisions = new WeakMap();
         this.textIds = new WeakMap();
@@ -991,6 +1020,9 @@ class PageContextCollector {
                     'data-framer-name',
                     'disabled',
                     'href',
+                    'target',
+                    'download',
+                    'data-highlight',
                     'hidden',
                     'inert',
                     'role',
@@ -1037,6 +1069,7 @@ class PageContextCollector {
         document.removeEventListener('change', this.handleControlStateChange, true);
         this.restoreNavigationHooks();
         this.targets.clear();
+        this.navigationDisclosureLinks = new WeakMap();
         this.executingActionId = null;
         this.pendingNavigation = null;
         this.pendingCapture = false;
@@ -1077,7 +1110,8 @@ class PageContextCollector {
                 continue;
             const role = roleFor(element);
             const hasStatefulButtonAttribute = role === 'button' &&
-                (element.hasAttribute('aria-expanded') || element.hasAttribute('aria-pressed'));
+                (element.hasAttribute('aria-expanded') || element.hasAttribute('aria-pressed') ||
+                    Boolean(framerNavigationRoot(element)));
             const hasUnsupportedMixedPressedState = role === 'button' &&
                 element.getAttribute('aria-pressed')?.trim().toLowerCase() === 'mixed';
             if (hasUnsupportedMixedPressedState ||
@@ -1114,7 +1148,8 @@ class PageContextCollector {
                 : accessibleNameSourceSensitivity(element);
             const visible = isVisible(element);
             const destinationPath = safeDestinationPath(element);
-            const expanded = literalBooleanAttribute(element, 'aria-expanded');
+            const navigation = publicNavigation(element);
+            const expanded = this.expandedState(element);
             const pressed = literalBooleanAttribute(element, 'aria-pressed');
             const checked = checkedStateFor(element);
             const targetIdentity = {
@@ -1131,6 +1166,7 @@ class PageContextCollector {
                 ...(semanticRegion ? { semanticRegion } : {}),
                 ...(this.statefulButtonActionProof && isNavigationMenu(element, role) ? { navigationMenu: true } : {}),
                 ...(destinationPath ? { destinationPath } : {}),
+                ...(navigation ? { navigation } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || regionAssessment.matchedRuleDigests.length > 0,
                 frameOrigin: 'same_origin',
@@ -1148,7 +1184,7 @@ class PageContextCollector {
             };
             const priorTargetId = this.targetIds.get(element);
             const boundNavigation = targetIdentity.consequence === 'navigation' &&
-                typeof targetIdentity.destinationPath === 'string';
+                targetIdentity.navigation !== undefined;
             const binding = boundNavigation ? navigationTargetBinding(targetIdentity) : null;
             const priorBinding = this.navigationTargetBindings.get(element);
             const boundField = isNativeEditableField(element) && sensitivity === 'none' &&
@@ -1199,15 +1235,18 @@ class PageContextCollector {
         const visibleText = [];
         const capturedSemanticText = new Set();
         let totalText = 0;
-        const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_TEXT);
+        const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT);
         let node = walker.nextNode();
         while (node && visibleText.length < MAX_TEXT_ITEMS && totalText < MAX_TOTAL_TEXT) {
-            const parent = node.parentElement;
-            const semanticTextElement = parent?.closest('[role="img"][aria-label]') ?? null;
+            const parent = node instanceof Element ? node : node.parentElement;
+            const semanticTextElement = node instanceof Element
+                ? node.matches('[role="img"][aria-label]') ? node : null
+                : parent?.closest('[role="img"][aria-label]') ?? null;
             const textElement = semanticTextElement && isRendered(semanticTextElement)
                 ? semanticTextElement
-                : parent;
-            const text = normalize(semanticTextElement?.getAttribute('aria-label') ?? node.textContent ?? '', 500);
+                : node.nodeType === Node.TEXT_NODE ? parent : null;
+            const text = normalize(semanticTextElement?.getAttribute('aria-label') ??
+                (node.nodeType === Node.TEXT_NODE ? node.textContent ?? '' : ''), 500);
             if (parent &&
                 textElement &&
                 text &&
@@ -1420,12 +1459,13 @@ class PageContextCollector {
             grant.targetId.startsWith(`${BOUND_FIELD_TARGET_PREFIX}_`) &&
             Boolean(current && isNativeEditableField(current.element) && this.fieldTargetBindings.has(current.element));
         const stablePageScroll = (current) => grant.action === 'scroll' && Boolean(current?.pageScroll && current.element === document.scrollingElement);
+        const stableNavigation = (current) => (grant.action === 'click' || grant.action === 'scroll') &&
+            grant.targetId.startsWith(`${BOUND_NAVIGATION_TARGET_PREFIX}_`) &&
+            current?.element instanceof HTMLAnchorElement &&
+            current.target.consequence === 'navigation' && current.target.navigation !== undefined;
         const revisionMatchesOrStableTarget = () => grant.domRevision === this.revision ||
             (grant.domRevision < this.revision &&
-                (stableField(handle) || stablePageScroll(handle) || ((grant.action === 'click' || grant.action === 'scroll') &&
-                    handle?.element instanceof HTMLAnchorElement &&
-                    handle.target.consequence === 'navigation' &&
-                    typeof handle.target.destinationPath === 'string')));
+                (stableField(handle) || stablePageScroll(handle) || stableNavigation(handle)));
         if (expiresAt <= Date.now() ||
             grant.pageId !== this.pageId ||
             grant.pageUrl !== safePageUrl() ||
@@ -1462,7 +1502,7 @@ class PageContextCollector {
             grant.pageUrl !== safePageUrl() ||
             grant.policyVersion !== this.policyVersion ||
             !revisionMatchesOrStableTarget() ||
-            (handle !== fingerprintedHandle && !((stableField(handle) || stablePageScroll(handle)) &&
+            (handle !== fingerprintedHandle && !((stableField(handle) || stablePageScroll(handle) || stableNavigation(handle)) &&
                 handle?.element === fingerprintedHandle.element &&
                 actionTargetFingerprintBinding(handle.target) === actionTargetFingerprintBinding(fingerprintedHandle.target))) ||
             !handle ||
@@ -1548,6 +1588,9 @@ class PageContextCollector {
         this.releasedNavigation = null;
         this.finishReleasedNavigationSettlement('rejected');
         let postActionSnapshot = null;
+        let navigationReceipt;
+        const disclosureRoot = handle.target.navigationMenu ? framerNavigationRoot(element) : null;
+        const priorDisclosureLinks = disclosureRoot ? this.exposedNavigationLinks(disclosureRoot) : null;
         try {
             switch (grant.action) {
                 case 'scroll': {
@@ -1658,7 +1701,7 @@ class PageContextCollector {
                     element.focus({ preventScroll: false });
                     break;
                 case 'click':
-                    this.click(element, handle, grant.actionId, grant.desiredChecked, grant.desiredExpanded, grant.desiredPressed, grant.destinationPath);
+                    navigationReceipt = this.click(element, handle, grant.actionId, grant.desiredChecked, grant.desiredExpanded, grant.desiredPressed, grant.destinationPath);
                     break;
                 case 'type':
                     this.type(element, grant.value ?? '');
@@ -1680,9 +1723,28 @@ class PageContextCollector {
             if (grant.action !== 'scroll') {
                 await new Promise((resolve) => setTimeout(resolve, 80));
             }
+            if (handle.target.navigationMenu && grant.action === 'click') {
+                const deadline = Date.now() + 1000;
+                for (let frames = 0; frames < 60 && Date.now() < deadline && element.isConnected && !executionStale(); frames++) {
+                    if (disclosureRoot && priorDisclosureLinks) {
+                        const added = new Set([...this.exposedNavigationLinks(disclosureRoot)]
+                            .filter(link => !priorDisclosureLinks.has(link)));
+                        if (added.size)
+                            this.navigationDisclosureLinks.set(element, added);
+                    }
+                    if (this.actionApplied(grant, element, handle))
+                        break;
+                    await nextAnimationFrameOrTimeout(Math.min(50, deadline - Date.now()));
+                }
+            }
             const postActionStale = executionStale();
-            if (postActionStale)
-                return postActionStale;
+            if (postActionStale) {
+                this.deferredNavigation = null;
+                return navigationReceipt ? { ...postActionStale, observed: {
+                        ...postActionStale.observed, targetState: 'unknown',
+                        navigation: { url: navigationReceipt.url, outcome: 'unconfirmed' },
+                    } } : postActionStale;
+            }
             if (!this.actionApplied(grant, element, handle)) {
                 throw new Error('The approved value was not applied.');
             }
@@ -1702,16 +1764,16 @@ class PageContextCollector {
             const attached = element.isConnected;
             const after = attached ? this.safeState(element) : '';
             const expanded = attached
-                ? literalBooleanAttribute(element, 'aria-expanded')
+                ? this.expandedState(element)
                 : undefined;
             const pressed = attached
                 ? literalBooleanAttribute(element, 'aria-pressed')
                 : undefined;
             const checked = attached ? checkedStateFor(element) : undefined;
-            this.callbacks.onHighlight(attached && !handle.pageScroll ? element : null, 'success');
+            this.callbacks.onHighlight(attached && !handle.pageScroll ? element : null, navigationReceipt && navigationReceipt.outcome !== 'opened' ? 'failure' : 'success');
             return {
                 ...base,
-                status: 'executed',
+                status: navigationReceipt && navigationReceipt.outcome !== 'opened' ? 'blocked' : 'executed',
                 observed: {
                     url: safePageUrl(),
                     revision: snapshot.revision,
@@ -1720,19 +1782,24 @@ class PageContextCollector {
                         : grant.action === 'type' || grant.action === 'select' || before !== after || handle.pageScroll
                             ? 'changed'
                             : 'unchanged',
-                    safeSummary: handle.pageScroll
-                        ? `The page moved ${handle.pageScroll} by ${Math.round(Math.abs(window.scrollY - scrollStartY))} pixels.`
-                        : grant.action === 'scroll'
-                            ? 'The requested target is visible. This confirms target visibility, not a directional page scroll.'
-                            : grant.action === 'type'
-                                ? 'The requested text was applied to the approved field.'
-                                : grant.action === 'select'
-                                    ? 'The requested option was applied to the approved field.'
-                                    : grant.desiredChecked !== undefined
-                                        ? 'The requested checkbox state was applied.'
-                                        : grant.desiredExpanded !== undefined || grant.desiredPressed !== undefined
-                                            ? 'The requested button state was applied.'
-                                            : `${grant.action} executed on the approved ${roleFor(element)} target.`,
+                    ...(navigationReceipt ? { navigation: navigationReceipt } : {}),
+                    safeSummary: navigationReceipt
+                        ? navigationReceipt.outcome === 'opened'
+                            ? 'Opened a separate tab for the exact approved link. Its contents and arrival are not observed.'
+                            : 'The new tab could not be confirmed. No fallback navigation was attempted.'
+                        : handle.pageScroll
+                            ? `The page moved ${handle.pageScroll} by ${Math.round(Math.abs(window.scrollY - scrollStartY))} pixels.`
+                            : grant.action === 'scroll'
+                                ? 'The requested target is visible. This confirms target visibility, not a directional page scroll.'
+                                : grant.action === 'type'
+                                    ? 'The requested text was applied to the approved field.'
+                                    : grant.action === 'select'
+                                        ? 'The requested option was applied to the approved field.'
+                                        : grant.desiredChecked !== undefined
+                                            ? 'The requested checkbox state was applied.'
+                                            : grant.desiredExpanded !== undefined || grant.desiredPressed !== undefined
+                                                ? 'The requested button state was applied.'
+                                                : `${grant.action} executed on the approved ${roleFor(element)} target.`,
                     ...(checked !== undefined ? { checked } : {}),
                     ...(this.statefulButtonActionProof && expanded !== undefined ? { expanded } : {}),
                     ...(this.statefulButtonActionProof && pressed !== undefined ? { pressed } : {}),
@@ -1740,6 +1807,7 @@ class PageContextCollector {
             };
         }
         catch {
+            this.deferredNavigation = null;
             this.callbacks.onHighlight(element, 'failure');
             return {
                 ...base,
@@ -1747,8 +1815,12 @@ class PageContextCollector {
                 observed: {
                     url: safePageUrl(),
                     revision: this.revision,
-                    targetState: element.isConnected ? 'unchanged' : 'detached',
-                    safeSummary: 'The approved page action failed safely.',
+                    targetState: navigationReceipt ? 'unknown' : element.isConnected ? 'unchanged' : 'detached',
+                    ...(navigationReceipt ? { navigation: { url: navigationReceipt.url,
+                            outcome: 'unconfirmed' } } : {}),
+                    safeSummary: navigationReceipt
+                        ? 'The link action could not be fully confirmed. Do not retry automatically.'
+                        : 'The approved page action failed safely.',
                 },
             };
         }
@@ -1808,9 +1880,8 @@ class PageContextCollector {
             return 'rejected';
         }
         if (window.location.href !== navigation.fromUrl) {
-            return sameNavigationDestination(window.location.href, navigation.toUrl)
-                ? 'settled'
-                : 'rejected';
+            // Arrival before dispatch is not evidence that this action navigated.
+            return 'rejected';
         }
         this.captureSnapshot(false);
         const handle = this.targets.get(navigation.targetId);
@@ -1826,7 +1897,7 @@ class PageContextCollector {
             target.origin !== window.location.origin ||
             safeDestinationPath(navigation.source) !== target.pathname ||
             linkBrowsingTarget(navigation.source) !== navigation.browsingTarget ||
-            !supportsCurrentTabNavigation(navigation.source) ||
+            !supportsCurrentTabNavigation(navigation.source) || navigation.browsingTarget === '_blank' ||
             !isRendered(navigation.source) ||
             !isVisible(navigation.source) ||
             !enabled(navigation.source) ||
@@ -1840,9 +1911,6 @@ class PageContextCollector {
                 if (current?.actionId !== navigation.actionId)
                     return;
                 this.releasedNavigationSettlement = null;
-                if (this.executingActionId === navigation.actionId) {
-                    this.executingActionId = null;
-                }
                 resolve('timed_out');
             }, RELEASED_NAVIGATION_SETTLEMENT_TIMEOUT_MS);
             this.releasedNavigationSettlement = {
@@ -1853,16 +1921,8 @@ class PageContextCollector {
                 resolve,
             };
         });
-        const useCurrentTab = navigation.browsingTarget === '_blank';
         try {
-            // New-window links must stay in the observable tab. Navigate the exact
-            // approved URL only after durable release; the normal document-navigation
-            // recovery handles the new page. Dispatching their handlers can open a
-            // popup even if the DOM target is temporarily changed (e.g. React props).
-            if (useCurrentTab) {
-                window.location.assign(navigation.toUrl);
-            }
-            else if (navigation.source.closest(FRAMER_GENERATED_PAGE_SELECTOR) &&
+            if (navigation.source.closest(FRAMER_GENERATED_PAGE_SELECTOR) &&
                 typeof window.PointerEvent === 'function') {
                 const preventNativeNavigation = (event) => {
                     if (event.target === navigation.source ||
@@ -1900,7 +1960,7 @@ class PageContextCollector {
                 // failure must not turn the acknowledged action into a failed click.
             }
         }
-        else if (navigationSettled === 'rejected' &&
+        else if (navigationSettled !== 'settled' &&
             this.executingActionId === navigation.actionId) {
             // A router may consume the exact click but send the browser somewhere
             // other than the approved destination. Complete the context-side action
@@ -1938,7 +1998,7 @@ class PageContextCollector {
             }
         }
         if (desiredExpanded !== undefined) {
-            const expanded = literalBooleanAttribute(element, 'aria-expanded');
+            const expanded = this.expandedState(element);
             if (roleFor(element) !== 'button' || expanded === undefined) {
                 throw new Error('Desired expanded state requires an expandable button target.');
             }
@@ -1953,6 +2013,10 @@ class PageContextCollector {
         }
         if (desiredStates.length > 0 && desiredStates.every(Boolean))
             return;
+        if (desiredExpanded === true && framerNavigationRoot(element)) {
+            dispatchFramerPrimaryPointerSequence(element, this.trustedGuideRoot);
+            return;
+        }
         if (desiredChecked !== undefined && framerToggleDescriptor(element)) {
             dispatchFramerTogglePrimaryPointer(element, this.trustedGuideRoot);
             return;
@@ -1963,11 +2027,25 @@ class PageContextCollector {
                 safeDestinationPath(element) !== expectedDestinationPath) {
                 throw new Error('The navigation destination changed before execution.');
             }
-            if (target.origin !== window.location.origin) {
-                throw new Error('External navigation is blocked.');
+            const navigation = publicNavigation(element);
+            if (!navigation || canonicalJson(navigation) !== canonicalJson(handle.target.navigation)) {
+                throw new Error('The public link destination or browsing target changed.');
             }
-            if (!supportsCurrentTabNavigation(element)) {
-                throw new Error('Named-window and download navigation is blocked.');
+            if (navigation.target === '_blank' || target.origin !== window.location.origin) {
+                // Keep external pages outside this session's origin/credential boundary.
+                // Only the browser's native noreferrer feature can prevent the source
+                // URL from becoming the Referer on this navigation. With noopener the
+                // return value may be null even when the tab opens, so never call a
+                // null result "blocked" or try the link a second time.
+                try {
+                    const popup = window.open(navigation.url, '_blank', 'noopener,noreferrer');
+                    return { url: navigation.url, outcome: popup && !popup.closed ? 'opened' : 'unconfirmed' };
+                }
+                catch {
+                    // Some browsers throw when popups are disallowed. The exact URL was
+                    // attempted at most once, and there is no fallback navigation.
+                    return { url: navigation.url, outcome: 'unconfirmed' };
+                }
             }
             const fromUrl = window.location.href;
             if (window.location.href === fromUrl && target.href !== fromUrl) {
@@ -2065,11 +2143,26 @@ class PageContextCollector {
         }
         form.requestSubmit(submitter);
     }
+    exposedNavigationLinks(nav) {
+        const links = nav.querySelectorAll('a[href]');
+        if (links.length > MAX_TARGETS)
+            return new Set();
+        return new Set(Array.from(links).filter(link => isVisible(link) && publicNavigation(link) &&
+            !isCovered(link, this.trustedGuideRoot)));
+    }
+    expandedState(element) {
+        const explicit = literalBooleanAttribute(element, 'aria-expanded');
+        if (explicit !== undefined)
+            return explicit;
+        if (!framerNavigationRoot(element))
+            return undefined;
+        return [...(this.navigationDisclosureLinks.get(element) ?? [])].some(link => link.isConnected && isRendered(link));
+    }
     safeState(element) {
         return JSON.stringify({
             connected: element.isConnected,
             disabled: !enabled(element),
-            expanded: element.getAttribute('aria-expanded'),
+            expanded: this.expandedState(element) ?? element.getAttribute('aria-expanded'),
             pressed: element.getAttribute('aria-pressed'),
             checked: checkedStateFor(element),
             selectedIndex: element instanceof HTMLSelectElement ? element.selectedIndex : undefined,
@@ -2092,6 +2185,7 @@ class PageContextCollector {
         let documentLeft = expectedHandle.element.getBoundingClientRect().left + window.scrollX;
         let layoutCorrections = 0;
         let priorScrollY = null;
+        let intersectedViewport = false;
         let interrupted = false;
         const interrupt = () => {
             interrupted = true;
@@ -2165,10 +2259,25 @@ class PageContextCollector {
                 if (!strictlyIntersectsViewport(rect)) {
                     priorRect = null;
                     stableSince = null;
-                    // Lazy content can move the same approved link after it briefly enters
-                    // view. Follow only layout shifts, never an unchanged offscreen target
-                    // or visitor input, within the original deadline and a fixed budget.
-                    if (layoutShifted &&
+                    // A public-link reveal performs exactly one native scroll. If layout
+                    // shifts move that link away again, stop instead of chasing it and
+                    // accidentally scrolling two or three more times. Other controls
+                    // retain the existing bounded lazy-layout correction.
+                    if (expectedHandle.target.consequence === 'navigation' && intersectedViewport) {
+                        this.captureSnapshot(false);
+                        const current = this.targets.get(grant.targetId);
+                        if (!current ||
+                            current.element !== expectedHandle.element ||
+                            actionTargetFingerprintBinding(current.target) !==
+                                actionTargetFingerprintBinding(expectedHandle.target) ||
+                            grant.pageId !== this.pageId ||
+                            grant.pageUrl !== safePageUrl() ||
+                            grant.policyVersion !== this.policyVersion) {
+                            return { status: 'target_changed' };
+                        }
+                        return { status: 'unavailable' };
+                    }
+                    if (layoutShifted && expectedHandle.target.consequence !== 'navigation' &&
                         layoutCorrections < MAX_SCROLL_LAYOUT_CORRECTIONS) {
                         this.captureSnapshot(false);
                         const current = this.targets.get(grant.targetId);
@@ -2193,6 +2302,7 @@ class PageContextCollector {
                     }
                     continue;
                 }
+                intersectedViewport = true;
                 if (!priorRect || !sameSettledRect(priorRect, rect))
                     stableSince = Date.now();
                 priorRect = rect;
@@ -2215,7 +2325,7 @@ class PageContextCollector {
             return checkedStateFor(element) === grant.desiredChecked;
         }
         if (grant.desiredExpanded !== undefined &&
-            literalBooleanAttribute(element, 'aria-expanded') !== grant.desiredExpanded) {
+            this.expandedState(element) !== grant.desiredExpanded) {
             return false;
         }
         if (grant.desiredPressed !== undefined &&
@@ -2398,6 +2508,7 @@ class PageContextCollector {
     resetBoundTargetIds() {
         this.targetIds = new WeakMap();
         this.navigationTargetBindings = new WeakMap();
+        this.navigationDisclosureLinks = new WeakMap();
         this.pageScrollIds = new WeakMap();
         this.fieldTargetBindings = new WeakMap();
         this.fieldAppliedRevisions = new WeakMap();

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.8";
+export declare const LIVE_CONTROL_CLIENT_VERSION = "7.5.10";
 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

@@ -332,6 +332,10 @@ export type SanitizedTarget = {
     autocomplete?: string;
     semanticRegion?: string;
     navigationMenu?: true;
+    navigation?: {
+        url: string;
+        target: '_self' | '_blank';
+    };
     destinationPath?: string;
     sensitivity: Sensitivity;
     protectedRegion?: boolean;
@@ -441,6 +445,10 @@ export type ActionExecutionResult = {
         revision: number;
         targetState: "unchanged" | "changed" | "detached" | "unknown";
         safeSummary: string;
+        navigation?: {
+            url: string;
+            outcome: 'opened' | 'blocked' | 'unconfirmed';
+        };
         checked?: boolean;
         expanded?: boolean;
         pressed?: boolean;

package/cjs/ui.js

@@ -4885,16 +4885,15 @@ class WidgetView {
         this.syncSurfaceEffectOwner();
     }
     setRemoteStream(stream) {
-        const streamChanged = this.audio.srcObject !== stream;
-        if (streamChanged)
-            this.invalidateRemotePlayback();
+        if (this.destroyed || this.audio.srcObject === stream)
+            return;
+        // Rebinding the same stream restarts media loading, including its playout buffer.
+        this.invalidateRemotePlayback();
         this.audio.srcObject = stream;
-        if (streamChanged) {
-            this.boundRemoteAudioStreams = new WeakSet();
-            this.boundRemoteAudioTracks = new WeakSet();
-            this.bindPlaybackState();
-            this.bindRemoteAudioTrackState(stream);
-        }
+        this.boundRemoteAudioStreams = new WeakSet();
+        this.boundRemoteAudioTracks = new WeakSet();
+        this.bindPlaybackState();
+        this.bindRemoteAudioTrackState(stream);
         void this.playRemoteAudio();
     }
     bindRemoteAudioTrackState(stream) {

package/cjs/version.d.ts

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