@oxvo/ai-live-assist 7.3.0 → 7.3.4

package/cjs/AiLiveAssist.d.ts

@@ -5,7 +5,7 @@ export declare const confirmationReplyIntent: (value: string) => ConfirmationRep
 export default class AiLiveAssist {
     private readonly app;
     private readonly options;
-    readonly version = "7.3.0";
+    readonly version = "7.3.4";
     private readonly siteKey;
     private tabId;
     private readonly windowId;

package/cjs/AiLiveAssist.js

@@ -1671,7 +1671,7 @@ class AiLiveAssist {
                 ? 'Microphone access was not granted. Allow microphone access to use voice assist.'
                 : 'Microphone access was not granted. You can continue with text.';
         }
-        return 'AI Live Assist is temporarily unavailable.';
+        return 'AI Guide is temporarily unavailable.';
     }
     retryable(error) {
         return error instanceof client_js_1.RuntimeClientError ? error.retryable : false;

package/cjs/client.js

@@ -20,7 +20,7 @@ class RuntimeClient {
         this.clientVersion = clientVersion;
         const url = new URL(runtimeUrl, window.location.href);
         if (!['http:', 'https:'].includes(url.protocol)) {
-            throw new Error('AI Live Assist runtime URL must use HTTP or HTTPS.');
+            throw new Error('AI Guide runtime URL must use HTTP or HTTPS.');
         }
         this.baseUrl = url.origin + url.pathname.replace(/\/$/, '');
     }
@@ -187,7 +187,7 @@ class RuntimeClient {
         }
         throw new RuntimeClientError(typeof error.code === 'string' ? error.code : 'RUNTIME_UNAVAILABLE', typeof error.message === 'string'
             ? error.message
-            : 'AI Live Assist is temporarily unavailable.', error.retryable === true, typeof error.retryAfterMs === 'number' ? error.retryAfterMs : null, response.status);
+            : 'AI Guide is temporarily unavailable.', error.retryable === true, typeof error.retryAfterMs === 'number' ? error.retryAfterMs : null, response.status);
     }
 }
 exports.RuntimeClient = RuntimeClient;

package/cjs/context.d.ts

@@ -17,6 +17,7 @@ export declare class PageContextCollector {
     private running;
     private mutationObserver;
     private captureTimer;
+    private mutationCaptureTimer;
     private targetIds;
     private textIds;
     private optionIds;
@@ -28,6 +29,7 @@ export declare class PageContextCollector {
     private pendingCapture;
     private deferredNavigation;
     private recentSelection;
+    private latestSemanticSignature;
     constructor(callbacks: ContextCallbacks, selectorRegionRules?: SelectorRegionRule[], policyVersion?: number);
     get currentRevision(): number;
     get currentPageId(): string;
@@ -36,6 +38,7 @@ export declare class PageContextCollector {
     stop(): void;
     captureAndPublish(): Promise<PageContextSnapshot>;
     capture(): PageContextSnapshot;
+    private captureSnapshot;
     captureVisualContext(): VisualContextCapture | null;
     execute(grant: ActionGrant): Promise<ActionExecutionResult>;
     completeActionExecution(actionId: string): Promise<string | null>;
@@ -47,6 +50,11 @@ export declare class PageContextCollector {
     private actionApplied;
     private clippedGeometry;
     private scheduleCapture;
+    private scheduleMutationCapture;
+    private scheduleViewportCapture;
+    private handleMutations;
+    private captureAndPublishIfChanged;
+    private semanticSignature;
     private handleSelectionChange;
     private handleControlStateChange;
     private readSafeSelection;

package/cjs/context.js

@@ -8,6 +8,8 @@ const MAX_TOTAL_TEXT = 24000;
 const MAX_OPTIONS = 100;
 const MAX_SELECTED_TEXT = 2000;
 const SELECTION_RETENTION_MS = 120000;
+const CAPTURE_SETTLE_MS = 250;
+const MUTATION_CAPTURE_DEBOUNCE_MS = 350;
 const PRIVATE_SELECTOR = [
     '[data-oxvo-ai-live-assist-root]',
     '[data-oxvo-private]',
@@ -66,6 +68,25 @@ const isCovered = (element) => {
     return Boolean(top && top !== element && !element.contains(top) && !top.contains(element));
 };
 const safePageUrl = () => `${window.location.origin}${window.location.pathname}`;
+const safeDestinationPath = (element) => {
+    if (!(element instanceof HTMLAnchorElement))
+        return null;
+    try {
+        const destination = new URL(element.href, window.location.href);
+        if (destination.origin !== window.location.origin ||
+            destination.search ||
+            destination.hash ||
+            !destination.pathname.startsWith('/') ||
+            destination.pathname.startsWith('//') ||
+            destination.pathname.length > 1024) {
+            return null;
+        }
+        return destination.pathname;
+    }
+    catch {
+        return null;
+    }
+};
 const sensitivityFor = (element, name) => {
     const input = element instanceof HTMLInputElement ? element : null;
     const type = input?.type.toLowerCase() ?? '';
@@ -235,6 +256,7 @@ class PageContextCollector {
         this.running = false;
         this.mutationObserver = null;
         this.captureTimer = null;
+        this.mutationCaptureTimer = null;
         this.targetIds = new WeakMap();
         this.textIds = new WeakMap();
         this.optionIds = new WeakMap();
@@ -246,6 +268,7 @@ class PageContextCollector {
         this.pendingCapture = false;
         this.deferredNavigation = null;
         this.recentSelection = null;
+        this.latestSemanticSignature = null;
         this.scheduleCapture = () => {
             if (!this.running)
                 return;
@@ -253,20 +276,53 @@ class PageContextCollector {
                 this.pendingCapture = true;
                 return;
             }
+            if (this.mutationCaptureTimer)
+                clearTimeout(this.mutationCaptureTimer);
+            this.mutationCaptureTimer = null;
             if (this.captureTimer)
                 return;
             this.captureTimer = setTimeout(() => {
                 this.captureTimer = null;
-                void this.captureAndPublish();
-            }, 250);
+                void this.captureAndPublishIfChanged();
+            }, CAPTURE_SETTLE_MS);
+        };
+        this.scheduleMutationCapture = () => {
+            if (!this.running)
+                return;
+            if (this.executingActionId) {
+                this.pendingCapture = true;
+                return;
+            }
+            if (this.captureTimer)
+                return;
+            if (this.mutationCaptureTimer)
+                clearTimeout(this.mutationCaptureTimer);
+            this.mutationCaptureTimer = setTimeout(() => {
+                this.mutationCaptureTimer = null;
+                void this.captureAndPublishIfChanged();
+            }, MUTATION_CAPTURE_DEBOUNCE_MS);
+        };
+        this.scheduleViewportCapture = () => {
+            this.scheduleMutationCapture();
+        };
+        this.handleMutations = (records) => {
+            const hasSemanticMutation = records.some((record) => record.type !== 'attributes' ||
+                (record.attributeName !== 'class' && record.attributeName !== 'style'));
+            if (hasSemanticMutation)
+                this.scheduleCapture();
+            else
+                this.scheduleMutationCapture();
         };
         this.handleSelectionChange = () => {
             const selection = this.readSafeSelection();
             if (selection)
                 this.recentSelection = selection;
-            this.scheduleCapture();
+            this.scheduleMutationCapture();
         };
-        this.handleControlStateChange = () => {
+        this.handleControlStateChange = (event) => {
+            if (event.target instanceof Element && event.target.closest('[data-oxvo-ai-live-assist-root]')) {
+                return;
+            }
             this.scheduleCapture();
         };
         this.handleNavigation = () => {
@@ -321,7 +377,7 @@ class PageContextCollector {
             return;
         this.running = true;
         this.installNavigationHooks();
-        this.mutationObserver = new MutationObserver(() => this.scheduleCapture());
+        this.mutationObserver = new MutationObserver(this.handleMutations);
         if (document.body) {
             this.mutationObserver.observe(document.body, {
                 subtree: true,
@@ -335,6 +391,7 @@ class PageContextCollector {
                     'aria-live',
                     'class',
                     'disabled',
+                    'href',
                     'hidden',
                     'inert',
                     'role',
@@ -342,19 +399,20 @@ class PageContextCollector {
                 ],
             });
         }
-        window.addEventListener('resize', this.scheduleCapture, { passive: true });
-        document.addEventListener('scroll', this.scheduleCapture, {
+        window.addEventListener('resize', this.scheduleViewportCapture, { passive: true });
+        document.addEventListener('scroll', this.scheduleViewportCapture, {
             capture: true,
             passive: true,
         });
-        window.visualViewport?.addEventListener('resize', this.scheduleCapture, {
+        window.visualViewport?.addEventListener('resize', this.scheduleViewportCapture, {
             passive: true,
         });
-        window.visualViewport?.addEventListener('scroll', this.scheduleCapture, {
+        window.visualViewport?.addEventListener('scroll', this.scheduleViewportCapture, {
             passive: true,
         });
         window.addEventListener('popstate', this.handleNavigation);
         document.addEventListener('selectionchange', this.handleSelectionChange);
+        document.addEventListener('click', this.handleControlStateChange, true);
         document.addEventListener('input', this.handleControlStateChange, true);
         document.addEventListener('change', this.handleControlStateChange, true);
         void this.captureAndPublish();
@@ -366,12 +424,16 @@ class PageContextCollector {
         if (this.captureTimer)
             clearTimeout(this.captureTimer);
         this.captureTimer = null;
-        window.removeEventListener('resize', this.scheduleCapture);
-        document.removeEventListener('scroll', this.scheduleCapture, true);
-        window.visualViewport?.removeEventListener('resize', this.scheduleCapture);
-        window.visualViewport?.removeEventListener('scroll', this.scheduleCapture);
+        if (this.mutationCaptureTimer)
+            clearTimeout(this.mutationCaptureTimer);
+        this.mutationCaptureTimer = null;
+        window.removeEventListener('resize', this.scheduleViewportCapture);
+        document.removeEventListener('scroll', this.scheduleViewportCapture, true);
+        window.visualViewport?.removeEventListener('resize', this.scheduleViewportCapture);
+        window.visualViewport?.removeEventListener('scroll', this.scheduleViewportCapture);
         window.removeEventListener('popstate', this.handleNavigation);
         document.removeEventListener('selectionchange', this.handleSelectionChange);
+        document.removeEventListener('click', this.handleControlStateChange, true);
         document.removeEventListener('input', this.handleControlStateChange, true);
         document.removeEventListener('change', this.handleControlStateChange, true);
         this.restoreNavigationHooks();
@@ -381,6 +443,7 @@ class PageContextCollector {
         this.pendingCapture = false;
         this.deferredNavigation = null;
         this.recentSelection = null;
+        this.latestSemanticSignature = null;
         this.callbacks.onHighlight(null, 'focus');
     }
     async captureAndPublish() {
@@ -390,8 +453,10 @@ class PageContextCollector {
         return snapshot;
     }
     capture() {
-        this.revision += 1;
-        const revision = this.revision;
+        return this.captureSnapshot(true);
+    }
+    captureSnapshot(force) {
+        const revision = this.revision + 1;
         const nextTargets = new Map();
         const targetValues = [];
         const elements = document.querySelectorAll('a[href],button,input,select,textarea,summary,form,[contenteditable="true"],[role],[tabindex]');
@@ -444,6 +509,7 @@ class PageContextCollector {
             const role = roleFor(element);
             const sensitivity = sensitivityFor(element, name);
             const visible = isVisible(element);
+            const destinationPath = safeDestinationPath(element);
             const target = {
                 targetId,
                 revision,
@@ -456,6 +522,7 @@ class PageContextCollector {
                     ? { autocomplete: normalize(element.getAttribute('autocomplete') ?? '', 128) }
                     : {}),
                 ...(semanticRegion ? { semanticRegion } : {}),
+                ...(destinationPath ? { destinationPath } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || matchedRuleDigests.length > 0,
                 frameOrigin: 'same_origin',
@@ -478,7 +545,6 @@ class PageContextCollector {
             targetValues.push(target);
             nextTargets.set(targetId, { element, revision, options: optionMap, target });
         }
-        this.targets = nextTargets;
         const visibleText = [];
         let totalText = 0;
         const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_TEXT);
@@ -518,7 +584,7 @@ class PageContextCollector {
             Date.now() - Date.parse(this.recentSelection.capturedAt) > SELECTION_RETENTION_MS) {
             this.recentSelection = null;
         }
-        return {
+        const snapshot = {
             schemaVersion: 1,
             pageId: this.pageId,
             revision,
@@ -537,6 +603,13 @@ class PageContextCollector {
             alerts,
             truncated,
         };
+        const signature = this.semanticSignature(snapshot);
+        if (!force && signature === this.latestSemanticSignature)
+            return null;
+        this.revision = revision;
+        this.targets = nextTargets;
+        this.latestSemanticSignature = signature;
+        return snapshot;
     }
     captureVisualContext() {
         if (this.revision < 1 || this.targets.size === 0)
@@ -659,7 +732,7 @@ class PageContextCollector {
                     element.focus({ preventScroll: false });
                     break;
                 case 'click':
-                    this.click(element, grant.actionId, grant.desiredChecked);
+                    this.click(element, grant.actionId, grant.desiredChecked, handle.target.destinationPath);
                     break;
                 case 'type':
                     this.type(element, grant.value ?? '');
@@ -737,7 +810,7 @@ class PageContextCollector {
             ? deferred.toUrl
             : null;
     }
-    click(element, actionId, desiredChecked) {
+    click(element, actionId, desiredChecked, expectedDestinationPath) {
         if (!(element instanceof HTMLElement))
             throw new Error('Target is not clickable.');
         if (desiredChecked !== undefined) {
@@ -752,6 +825,10 @@ class PageContextCollector {
         }
         if (element instanceof HTMLAnchorElement) {
             const target = new URL(element.href, window.location.href);
+            if (expectedDestinationPath !== undefined &&
+                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.');
             }
@@ -895,6 +972,26 @@ class PageContextCollector {
             height,
         };
     }
+    async captureAndPublishIfChanged() {
+        const snapshot = this.captureSnapshot(false);
+        if (snapshot && this.running)
+            await this.callbacks.onSnapshot(snapshot);
+    }
+    semanticSignature(snapshot) {
+        return JSON.stringify({
+            ...snapshot,
+            revision: 0,
+            ...(snapshot.selection
+                ? {
+                    selection: {
+                        text: snapshot.selection.text,
+                        source: snapshot.selection.source,
+                    },
+                }
+                : {}),
+            targets: snapshot.targets.map((target) => ({ ...target, revision: 0 })),
+        });
+    }
     readSafeSelection() {
         const selection = window.getSelection();
         if (!selection || selection.isCollapsed || selection.rangeCount !== 1)

package/cjs/control.js

@@ -31,7 +31,7 @@ class ControlChannel {
     }
     setFencingToken(value) {
         if (!Number.isSafeInteger(value) || value < 1) {
-            throw new Error('Invalid AI Live Assist fencing token.');
+            throw new Error('Invalid AI Guide fencing token.');
         }
         this.fencingToken = value;
     }
@@ -70,7 +70,7 @@ class ControlChannel {
             socket.addEventListener('error', () => {
                 signal.removeEventListener('abort', abort);
                 if (socket.readyState !== WebSocket.OPEN) {
-                    reject(new Error('The AI Live Assist control channel could not connect.'));
+                    reject(new Error('The AI Guide control channel could not connect.'));
                 }
             }, { once: true });
             socket.addEventListener('close', () => {
@@ -82,7 +82,7 @@ class ControlChannel {
     }
     send(type, payload) {
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
-            throw new Error('The AI Live Assist control channel is not connected.');
+            throw new Error('The AI Guide control channel is not connected.');
         }
         const id = `msg_${crypto.randomUUID()}`;
         this.clientSequence += 1;

package/cjs/index.js

@@ -19,7 +19,7 @@ function aiLiveAssist(options = {}) {
             return undefined;
         }
         if (!app.checkRequiredVersion?.('7.3.0')) {
-            console.warn('OXVO AI Live Assist requires @oxvo/browser version 7.3.0 or newer.');
+            console.warn('OXVO AI Guide requires @oxvo/browser version 7.3.0 or newer.');
             return undefined;
         }
         const instance = new AiLiveAssist_js_1.default(app, options);

package/cjs/messages.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultMessages = void 0;
 exports.defaultMessages = {
     launcher: "Ask AI",
-    introTitle: "AI Live Assist",
+    introTitle: "AI Guide",
     disclosure: "You are interacting with an AI assistant.",
     requiredConsent: "I understand that I am interacting with an AI assistant.",
-    consentAgreement: "I agree to use AI Live Assist.",
+    consentAgreement: "I agree to use AI Guide.",
     legalDetails: "Terms and privacy",
-    legalTitle: "AI Live Assist terms and privacy",
+    legalTitle: "AI Guide terms and privacy",
     legalClose: "Close details",
     termsOfService: "Terms of service",
     microphoneConsent: "Send microphone audio to the AI provider for this session.",
@@ -38,8 +38,8 @@ exports.defaultMessages = {
     close: "Close",
     minimize: "Minimize",
     maximize: "Expand conversation",
-    activeCall: "AI Live Assist is still active",
-    movePanel: "Move AI Live Assist",
+    activeCall: "AI Guide is still active",
+    movePanel: "Move AI Guide",
     mute: "Mute",
     unmute: "Unmute",
     interrupt: "Stop AI response",
@@ -66,19 +66,19 @@ exports.defaultMessages = {
     actionVerified: "Action completed and verified",
     actionFailed: "The action could not be verified",
     limitReached: "This session reached its configured limit.",
-    ended: "This AI Live Assist session has ended.",
+    ended: "This AI Guide session has ended.",
     idleEnded: "This session ended after no visitor activity.",
     feedbackQuestion: "Did this resolve your issue?",
     resolved: "Resolved",
     partiallyResolved: "Partly resolved",
     notResolved: "Not resolved",
     submitFeedback: "Submit feedback",
-    error: "AI Live Assist is temporarily unavailable.",
+    error: "AI Guide is temporarily unavailable.",
     retry: "Retry",
-    activeElsewhere: "AI Live Assist is active in another tab.",
-    visitorLimitReached: "The daily AI Live Assist limit has been reached for this visitor.",
-    visitorCooldown: "Please wait before starting another AI Live Assist session.",
-    visitorAlreadyActive: "An AI Live Assist session is already active for this visitor.",
+    activeElsewhere: "AI Guide is active in another tab.",
+    visitorLimitReached: "The daily AI Guide limit has been reached for this visitor.",
+    visitorCooldown: "Please wait before starting another AI Guide session.",
+    visitorAlreadyActive: "An AI Guide session is already active for this visitor.",
     safetyBoundary: "Payment details, passwords, and verification codes are always handled by you. You can pause actions or end this session at any time.",
     privacyPolicy: "Privacy policy",
     moreControls: "More controls",

package/cjs/types.d.ts

@@ -170,6 +170,7 @@ export type SanitizedTarget = {
     inputType?: string;
     autocomplete?: string;
     semanticRegion?: string;
+    destinationPath?: string;
     sensitivity: Sensitivity;
     protectedRegion?: boolean;
     frameOrigin?: "same_origin" | "cross_origin";

package/cjs/ui.js

@@ -532,18 +532,21 @@ const style = `
   .visual-request h3 { margin: 0 0 6px; font-size: 14px; line-height: 20px; }
   .visual-request p { margin: 4px 0; color: #4b5563; font-size: 12px; line-height: 17px; }
   .feedback { display: none; }
-  .feedback.visible { display: grid; gap: 12px; margin-top: 10px; padding: 8px 0 4px; }
+  .feedback.visible { display: grid; gap: 10px; margin-top: 10px; padding: 8px 0 4px; }
   .attribution-bubble {
+    justify-self: center;
     width: max-content;
     max-width: 100%;
-    padding: 8px 10px;
+    margin-top: 2px;
+    padding: 0;
     color: var(--assist-muted);
-    background: var(--assist-surface-muted);
-    border: 1px solid var(--assist-border);
-    border-radius: 8px;
-    box-shadow: 0 4px 14px rgba(15, 23, 42, .08);
-    font-size: 12px;
-    line-height: 18px;
+    background: transparent;
+    border: 0;
+    border-radius: 0;
+    box-shadow: none;
+    font-size: 11px;
+    line-height: 16px;
+    text-align: center;
     animation: attribution-in .18s ease-out both;
   }
   .attribution-bubble a {
@@ -1475,13 +1478,13 @@ class WidgetView {
         <div class="status-card" data-role="notice"></div>
         <button type="button" class="secondary" data-role="retry" hidden></button>
         <div class="feedback">
-          <div class="attribution-bubble" data-role="attribution" role="status" hidden>Powered by <a href="https://oxvo.com/" target="_blank" rel="noopener noreferrer">OXVO.com</a></div>
           <strong></strong>
           <div class="feedback-options">
             <button type="button" class="secondary" data-outcome="resolved"></button>
             <button type="button" class="secondary" data-outcome="partially_resolved"></button>
             <button type="button" class="secondary" data-outcome="not_resolved"></button>
           </div>
+          <div class="attribution-bubble" data-role="attribution" role="status" hidden>Powered by <a href="https://oxvo.com/" target="_blank" rel="noopener noreferrer">OXVO.com</a></div>
         </div>
       </div>
       <footer class="controls">
@@ -2346,7 +2349,7 @@ class WidgetView {
     require(selector) {
         const element = this.shadow.querySelector(selector);
         if (!element)
-            throw new Error(`Missing AI Live Assist UI element: ${selector}`);
+            throw new Error(`Missing AI Guide UI element: ${selector}`);
         return element;
     }
 }

package/cjs/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.3.0";
+export declare const VERSION = "7.3.4";

package/cjs/version.js

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

package/lib/AiLiveAssist.d.ts

@@ -5,7 +5,7 @@ export declare const confirmationReplyIntent: (value: string) => ConfirmationRep
 export default class AiLiveAssist {
     private readonly app;
     private readonly options;
-    readonly version = "7.3.0";
+    readonly version = "7.3.4";
     private readonly siteKey;
     private tabId;
     private readonly windowId;

package/lib/AiLiveAssist.js

@@ -1667,7 +1667,7 @@ export default class AiLiveAssist {
                 ? 'Microphone access was not granted. Allow microphone access to use voice assist.'
                 : 'Microphone access was not granted. You can continue with text.';
         }
-        return 'AI Live Assist is temporarily unavailable.';
+        return 'AI Guide is temporarily unavailable.';
     }
     retryable(error) {
         return error instanceof RuntimeClientError ? error.retryable : false;

package/lib/client.js

@@ -15,7 +15,7 @@ export class RuntimeClient {
         this.clientVersion = clientVersion;
         const url = new URL(runtimeUrl, window.location.href);
         if (!['http:', 'https:'].includes(url.protocol)) {
-            throw new Error('AI Live Assist runtime URL must use HTTP or HTTPS.');
+            throw new Error('AI Guide runtime URL must use HTTP or HTTPS.');
         }
         this.baseUrl = url.origin + url.pathname.replace(/\/$/, '');
     }
@@ -182,6 +182,6 @@ export class RuntimeClient {
         }
         throw new RuntimeClientError(typeof error.code === 'string' ? error.code : 'RUNTIME_UNAVAILABLE', typeof error.message === 'string'
             ? error.message
-            : 'AI Live Assist is temporarily unavailable.', error.retryable === true, typeof error.retryAfterMs === 'number' ? error.retryAfterMs : null, response.status);
+            : 'AI Guide is temporarily unavailable.', error.retryable === true, typeof error.retryAfterMs === 'number' ? error.retryAfterMs : null, response.status);
     }
 }

package/lib/context.d.ts

@@ -17,6 +17,7 @@ export declare class PageContextCollector {
     private running;
     private mutationObserver;
     private captureTimer;
+    private mutationCaptureTimer;
     private targetIds;
     private textIds;
     private optionIds;
@@ -28,6 +29,7 @@ export declare class PageContextCollector {
     private pendingCapture;
     private deferredNavigation;
     private recentSelection;
+    private latestSemanticSignature;
     constructor(callbacks: ContextCallbacks, selectorRegionRules?: SelectorRegionRule[], policyVersion?: number);
     get currentRevision(): number;
     get currentPageId(): string;
@@ -36,6 +38,7 @@ export declare class PageContextCollector {
     stop(): void;
     captureAndPublish(): Promise<PageContextSnapshot>;
     capture(): PageContextSnapshot;
+    private captureSnapshot;
     captureVisualContext(): VisualContextCapture | null;
     execute(grant: ActionGrant): Promise<ActionExecutionResult>;
     completeActionExecution(actionId: string): Promise<string | null>;
@@ -47,6 +50,11 @@ export declare class PageContextCollector {
     private actionApplied;
     private clippedGeometry;
     private scheduleCapture;
+    private scheduleMutationCapture;
+    private scheduleViewportCapture;
+    private handleMutations;
+    private captureAndPublishIfChanged;
+    private semanticSignature;
     private handleSelectionChange;
     private handleControlStateChange;
     private readSafeSelection;

package/lib/context.js

@@ -5,6 +5,8 @@ const MAX_TOTAL_TEXT = 24000;
 const MAX_OPTIONS = 100;
 const MAX_SELECTED_TEXT = 2000;
 const SELECTION_RETENTION_MS = 120000;
+const CAPTURE_SETTLE_MS = 250;
+const MUTATION_CAPTURE_DEBOUNCE_MS = 350;
 const PRIVATE_SELECTOR = [
     '[data-oxvo-ai-live-assist-root]',
     '[data-oxvo-private]',
@@ -63,6 +65,25 @@ const isCovered = (element) => {
     return Boolean(top && top !== element && !element.contains(top) && !top.contains(element));
 };
 const safePageUrl = () => `${window.location.origin}${window.location.pathname}`;
+const safeDestinationPath = (element) => {
+    if (!(element instanceof HTMLAnchorElement))
+        return null;
+    try {
+        const destination = new URL(element.href, window.location.href);
+        if (destination.origin !== window.location.origin ||
+            destination.search ||
+            destination.hash ||
+            !destination.pathname.startsWith('/') ||
+            destination.pathname.startsWith('//') ||
+            destination.pathname.length > 1024) {
+            return null;
+        }
+        return destination.pathname;
+    }
+    catch {
+        return null;
+    }
+};
 const sensitivityFor = (element, name) => {
     const input = element instanceof HTMLInputElement ? element : null;
     const type = input?.type.toLowerCase() ?? '';
@@ -232,6 +253,7 @@ export class PageContextCollector {
         this.running = false;
         this.mutationObserver = null;
         this.captureTimer = null;
+        this.mutationCaptureTimer = null;
         this.targetIds = new WeakMap();
         this.textIds = new WeakMap();
         this.optionIds = new WeakMap();
@@ -243,6 +265,7 @@ export class PageContextCollector {
         this.pendingCapture = false;
         this.deferredNavigation = null;
         this.recentSelection = null;
+        this.latestSemanticSignature = null;
         this.scheduleCapture = () => {
             if (!this.running)
                 return;
@@ -250,20 +273,53 @@ export class PageContextCollector {
                 this.pendingCapture = true;
                 return;
             }
+            if (this.mutationCaptureTimer)
+                clearTimeout(this.mutationCaptureTimer);
+            this.mutationCaptureTimer = null;
             if (this.captureTimer)
                 return;
             this.captureTimer = setTimeout(() => {
                 this.captureTimer = null;
-                void this.captureAndPublish();
-            }, 250);
+                void this.captureAndPublishIfChanged();
+            }, CAPTURE_SETTLE_MS);
+        };
+        this.scheduleMutationCapture = () => {
+            if (!this.running)
+                return;
+            if (this.executingActionId) {
+                this.pendingCapture = true;
+                return;
+            }
+            if (this.captureTimer)
+                return;
+            if (this.mutationCaptureTimer)
+                clearTimeout(this.mutationCaptureTimer);
+            this.mutationCaptureTimer = setTimeout(() => {
+                this.mutationCaptureTimer = null;
+                void this.captureAndPublishIfChanged();
+            }, MUTATION_CAPTURE_DEBOUNCE_MS);
+        };
+        this.scheduleViewportCapture = () => {
+            this.scheduleMutationCapture();
+        };
+        this.handleMutations = (records) => {
+            const hasSemanticMutation = records.some((record) => record.type !== 'attributes' ||
+                (record.attributeName !== 'class' && record.attributeName !== 'style'));
+            if (hasSemanticMutation)
+                this.scheduleCapture();
+            else
+                this.scheduleMutationCapture();
         };
         this.handleSelectionChange = () => {
             const selection = this.readSafeSelection();
             if (selection)
                 this.recentSelection = selection;
-            this.scheduleCapture();
+            this.scheduleMutationCapture();
         };
-        this.handleControlStateChange = () => {
+        this.handleControlStateChange = (event) => {
+            if (event.target instanceof Element && event.target.closest('[data-oxvo-ai-live-assist-root]')) {
+                return;
+            }
             this.scheduleCapture();
         };
         this.handleNavigation = () => {
@@ -318,7 +374,7 @@ export class PageContextCollector {
             return;
         this.running = true;
         this.installNavigationHooks();
-        this.mutationObserver = new MutationObserver(() => this.scheduleCapture());
+        this.mutationObserver = new MutationObserver(this.handleMutations);
         if (document.body) {
             this.mutationObserver.observe(document.body, {
                 subtree: true,
@@ -332,6 +388,7 @@ export class PageContextCollector {
                     'aria-live',
                     'class',
                     'disabled',
+                    'href',
                     'hidden',
                     'inert',
                     'role',
@@ -339,19 +396,20 @@ export class PageContextCollector {
                 ],
             });
         }
-        window.addEventListener('resize', this.scheduleCapture, { passive: true });
-        document.addEventListener('scroll', this.scheduleCapture, {
+        window.addEventListener('resize', this.scheduleViewportCapture, { passive: true });
+        document.addEventListener('scroll', this.scheduleViewportCapture, {
             capture: true,
             passive: true,
         });
-        window.visualViewport?.addEventListener('resize', this.scheduleCapture, {
+        window.visualViewport?.addEventListener('resize', this.scheduleViewportCapture, {
             passive: true,
         });
-        window.visualViewport?.addEventListener('scroll', this.scheduleCapture, {
+        window.visualViewport?.addEventListener('scroll', this.scheduleViewportCapture, {
             passive: true,
         });
         window.addEventListener('popstate', this.handleNavigation);
         document.addEventListener('selectionchange', this.handleSelectionChange);
+        document.addEventListener('click', this.handleControlStateChange, true);
         document.addEventListener('input', this.handleControlStateChange, true);
         document.addEventListener('change', this.handleControlStateChange, true);
         void this.captureAndPublish();
@@ -363,12 +421,16 @@ export class PageContextCollector {
         if (this.captureTimer)
             clearTimeout(this.captureTimer);
         this.captureTimer = null;
-        window.removeEventListener('resize', this.scheduleCapture);
-        document.removeEventListener('scroll', this.scheduleCapture, true);
-        window.visualViewport?.removeEventListener('resize', this.scheduleCapture);
-        window.visualViewport?.removeEventListener('scroll', this.scheduleCapture);
+        if (this.mutationCaptureTimer)
+            clearTimeout(this.mutationCaptureTimer);
+        this.mutationCaptureTimer = null;
+        window.removeEventListener('resize', this.scheduleViewportCapture);
+        document.removeEventListener('scroll', this.scheduleViewportCapture, true);
+        window.visualViewport?.removeEventListener('resize', this.scheduleViewportCapture);
+        window.visualViewport?.removeEventListener('scroll', this.scheduleViewportCapture);
         window.removeEventListener('popstate', this.handleNavigation);
         document.removeEventListener('selectionchange', this.handleSelectionChange);
+        document.removeEventListener('click', this.handleControlStateChange, true);
         document.removeEventListener('input', this.handleControlStateChange, true);
         document.removeEventListener('change', this.handleControlStateChange, true);
         this.restoreNavigationHooks();
@@ -378,6 +440,7 @@ export class PageContextCollector {
         this.pendingCapture = false;
         this.deferredNavigation = null;
         this.recentSelection = null;
+        this.latestSemanticSignature = null;
         this.callbacks.onHighlight(null, 'focus');
     }
     async captureAndPublish() {
@@ -387,8 +450,10 @@ export class PageContextCollector {
         return snapshot;
     }
     capture() {
-        this.revision += 1;
-        const revision = this.revision;
+        return this.captureSnapshot(true);
+    }
+    captureSnapshot(force) {
+        const revision = this.revision + 1;
         const nextTargets = new Map();
         const targetValues = [];
         const elements = document.querySelectorAll('a[href],button,input,select,textarea,summary,form,[contenteditable="true"],[role],[tabindex]');
@@ -441,6 +506,7 @@ export class PageContextCollector {
             const role = roleFor(element);
             const sensitivity = sensitivityFor(element, name);
             const visible = isVisible(element);
+            const destinationPath = safeDestinationPath(element);
             const target = {
                 targetId,
                 revision,
@@ -453,6 +519,7 @@ export class PageContextCollector {
                     ? { autocomplete: normalize(element.getAttribute('autocomplete') ?? '', 128) }
                     : {}),
                 ...(semanticRegion ? { semanticRegion } : {}),
+                ...(destinationPath ? { destinationPath } : {}),
                 sensitivity,
                 protectedRegion: sensitivity !== 'none' || matchedRuleDigests.length > 0,
                 frameOrigin: 'same_origin',
@@ -475,7 +542,6 @@ export class PageContextCollector {
             targetValues.push(target);
             nextTargets.set(targetId, { element, revision, options: optionMap, target });
         }
-        this.targets = nextTargets;
         const visibleText = [];
         let totalText = 0;
         const walker = document.createTreeWalker(document.body ?? document.documentElement, NodeFilter.SHOW_TEXT);
@@ -515,7 +581,7 @@ export class PageContextCollector {
             Date.now() - Date.parse(this.recentSelection.capturedAt) > SELECTION_RETENTION_MS) {
             this.recentSelection = null;
         }
-        return {
+        const snapshot = {
             schemaVersion: 1,
             pageId: this.pageId,
             revision,
@@ -534,6 +600,13 @@ export class PageContextCollector {
             alerts,
             truncated,
         };
+        const signature = this.semanticSignature(snapshot);
+        if (!force && signature === this.latestSemanticSignature)
+            return null;
+        this.revision = revision;
+        this.targets = nextTargets;
+        this.latestSemanticSignature = signature;
+        return snapshot;
     }
     captureVisualContext() {
         if (this.revision < 1 || this.targets.size === 0)
@@ -656,7 +729,7 @@ export class PageContextCollector {
                     element.focus({ preventScroll: false });
                     break;
                 case 'click':
-                    this.click(element, grant.actionId, grant.desiredChecked);
+                    this.click(element, grant.actionId, grant.desiredChecked, handle.target.destinationPath);
                     break;
                 case 'type':
                     this.type(element, grant.value ?? '');
@@ -734,7 +807,7 @@ export class PageContextCollector {
             ? deferred.toUrl
             : null;
     }
-    click(element, actionId, desiredChecked) {
+    click(element, actionId, desiredChecked, expectedDestinationPath) {
         if (!(element instanceof HTMLElement))
             throw new Error('Target is not clickable.');
         if (desiredChecked !== undefined) {
@@ -749,6 +822,10 @@ export class PageContextCollector {
         }
         if (element instanceof HTMLAnchorElement) {
             const target = new URL(element.href, window.location.href);
+            if (expectedDestinationPath !== undefined &&
+                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.');
             }
@@ -892,6 +969,26 @@ export class PageContextCollector {
             height,
         };
     }
+    async captureAndPublishIfChanged() {
+        const snapshot = this.captureSnapshot(false);
+        if (snapshot && this.running)
+            await this.callbacks.onSnapshot(snapshot);
+    }
+    semanticSignature(snapshot) {
+        return JSON.stringify({
+            ...snapshot,
+            revision: 0,
+            ...(snapshot.selection
+                ? {
+                    selection: {
+                        text: snapshot.selection.text,
+                        source: snapshot.selection.source,
+                    },
+                }
+                : {}),
+            targets: snapshot.targets.map((target) => ({ ...target, revision: 0 })),
+        });
+    }
     readSafeSelection() {
         const selection = window.getSelection();
         if (!selection || selection.isCollapsed || selection.rangeCount !== 1)

package/lib/control.js

@@ -28,7 +28,7 @@ export class ControlChannel {
     }
     setFencingToken(value) {
         if (!Number.isSafeInteger(value) || value < 1) {
-            throw new Error('Invalid AI Live Assist fencing token.');
+            throw new Error('Invalid AI Guide fencing token.');
         }
         this.fencingToken = value;
     }
@@ -67,7 +67,7 @@ export class ControlChannel {
             socket.addEventListener('error', () => {
                 signal.removeEventListener('abort', abort);
                 if (socket.readyState !== WebSocket.OPEN) {
-                    reject(new Error('The AI Live Assist control channel could not connect.'));
+                    reject(new Error('The AI Guide control channel could not connect.'));
                 }
             }, { once: true });
             socket.addEventListener('close', () => {
@@ -79,7 +79,7 @@ export class ControlChannel {
     }
     send(type, payload) {
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
-            throw new Error('The AI Live Assist control channel is not connected.');
+            throw new Error('The AI Guide control channel is not connected.');
         }
         const id = `msg_${crypto.randomUUID()}`;
         this.clientSequence += 1;

package/lib/index.js

@@ -13,7 +13,7 @@ export default function aiLiveAssist(options = {}) {
             return undefined;
         }
         if (!app.checkRequiredVersion?.('7.3.0')) {
-            console.warn('OXVO AI Live Assist requires @oxvo/browser version 7.3.0 or newer.');
+            console.warn('OXVO AI Guide requires @oxvo/browser version 7.3.0 or newer.');
             return undefined;
         }
         const instance = new AiLiveAssist(app, options);

package/lib/messages.js

@@ -1,11 +1,11 @@
 export const defaultMessages = {
     launcher: "Ask AI",
-    introTitle: "AI Live Assist",
+    introTitle: "AI Guide",
     disclosure: "You are interacting with an AI assistant.",
     requiredConsent: "I understand that I am interacting with an AI assistant.",
-    consentAgreement: "I agree to use AI Live Assist.",
+    consentAgreement: "I agree to use AI Guide.",
     legalDetails: "Terms and privacy",
-    legalTitle: "AI Live Assist terms and privacy",
+    legalTitle: "AI Guide terms and privacy",
     legalClose: "Close details",
     termsOfService: "Terms of service",
     microphoneConsent: "Send microphone audio to the AI provider for this session.",
@@ -35,8 +35,8 @@ export const defaultMessages = {
     close: "Close",
     minimize: "Minimize",
     maximize: "Expand conversation",
-    activeCall: "AI Live Assist is still active",
-    movePanel: "Move AI Live Assist",
+    activeCall: "AI Guide is still active",
+    movePanel: "Move AI Guide",
     mute: "Mute",
     unmute: "Unmute",
     interrupt: "Stop AI response",
@@ -63,19 +63,19 @@ export const defaultMessages = {
     actionVerified: "Action completed and verified",
     actionFailed: "The action could not be verified",
     limitReached: "This session reached its configured limit.",
-    ended: "This AI Live Assist session has ended.",
+    ended: "This AI Guide session has ended.",
     idleEnded: "This session ended after no visitor activity.",
     feedbackQuestion: "Did this resolve your issue?",
     resolved: "Resolved",
     partiallyResolved: "Partly resolved",
     notResolved: "Not resolved",
     submitFeedback: "Submit feedback",
-    error: "AI Live Assist is temporarily unavailable.",
+    error: "AI Guide is temporarily unavailable.",
     retry: "Retry",
-    activeElsewhere: "AI Live Assist is active in another tab.",
-    visitorLimitReached: "The daily AI Live Assist limit has been reached for this visitor.",
-    visitorCooldown: "Please wait before starting another AI Live Assist session.",
-    visitorAlreadyActive: "An AI Live Assist session is already active for this visitor.",
+    activeElsewhere: "AI Guide is active in another tab.",
+    visitorLimitReached: "The daily AI Guide limit has been reached for this visitor.",
+    visitorCooldown: "Please wait before starting another AI Guide session.",
+    visitorAlreadyActive: "An AI Guide session is already active for this visitor.",
     safetyBoundary: "Payment details, passwords, and verification codes are always handled by you. You can pause actions or end this session at any time.",
     privacyPolicy: "Privacy policy",
     moreControls: "More controls",

package/lib/types.d.ts

@@ -170,6 +170,7 @@ export type SanitizedTarget = {
     inputType?: string;
     autocomplete?: string;
     semanticRegion?: string;
+    destinationPath?: string;
     sensitivity: Sensitivity;
     protectedRegion?: boolean;
     frameOrigin?: "same_origin" | "cross_origin";

package/lib/ui.js

@@ -529,18 +529,21 @@ const style = `
   .visual-request h3 { margin: 0 0 6px; font-size: 14px; line-height: 20px; }
   .visual-request p { margin: 4px 0; color: #4b5563; font-size: 12px; line-height: 17px; }
   .feedback { display: none; }
-  .feedback.visible { display: grid; gap: 12px; margin-top: 10px; padding: 8px 0 4px; }
+  .feedback.visible { display: grid; gap: 10px; margin-top: 10px; padding: 8px 0 4px; }
   .attribution-bubble {
+    justify-self: center;
     width: max-content;
     max-width: 100%;
-    padding: 8px 10px;
+    margin-top: 2px;
+    padding: 0;
     color: var(--assist-muted);
-    background: var(--assist-surface-muted);
-    border: 1px solid var(--assist-border);
-    border-radius: 8px;
-    box-shadow: 0 4px 14px rgba(15, 23, 42, .08);
-    font-size: 12px;
-    line-height: 18px;
+    background: transparent;
+    border: 0;
+    border-radius: 0;
+    box-shadow: none;
+    font-size: 11px;
+    line-height: 16px;
+    text-align: center;
     animation: attribution-in .18s ease-out both;
   }
   .attribution-bubble a {
@@ -1472,13 +1475,13 @@ export class WidgetView {
         <div class="status-card" data-role="notice"></div>
         <button type="button" class="secondary" data-role="retry" hidden></button>
         <div class="feedback">
-          <div class="attribution-bubble" data-role="attribution" role="status" hidden>Powered by <a href="https://oxvo.com/" target="_blank" rel="noopener noreferrer">OXVO.com</a></div>
           <strong></strong>
           <div class="feedback-options">
             <button type="button" class="secondary" data-outcome="resolved"></button>
             <button type="button" class="secondary" data-outcome="partially_resolved"></button>
             <button type="button" class="secondary" data-outcome="not_resolved"></button>
           </div>
+          <div class="attribution-bubble" data-role="attribution" role="status" hidden>Powered by <a href="https://oxvo.com/" target="_blank" rel="noopener noreferrer">OXVO.com</a></div>
         </div>
       </div>
       <footer class="controls">
@@ -2343,7 +2346,7 @@ export class WidgetView {
     require(selector) {
         const element = this.shadow.querySelector(selector);
         if (!element)
-            throw new Error(`Missing AI Live Assist UI element: ${selector}`);
+            throw new Error(`Missing AI Guide UI element: ${selector}`);
         return element;
     }
 }

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "7.3.0";
+export declare const VERSION = "7.3.4";

package/lib/version.js

@@ -1 +1 @@
-export const VERSION = '7.3.0';
+export const VERSION = '7.3.4';

package/package.json

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