@oxvo/ai-live-assist 7.3.0

package/lib/tabLock.js

@@ -0,0 +1,256 @@
+const validId = (value) => typeof value === 'string' && /^[A-Za-z0-9_.:-]{8,128}$/.test(value);
+const parse = (value) => {
+    if (!value)
+        return null;
+    try {
+        const record = JSON.parse(value);
+        const ownerId = validId(record.ownerId)
+            ? record.ownerId
+            : validId(record.tabId)
+                ? record.tabId
+                : null;
+        return ownerId &&
+            typeof record.expiresAt === 'number' &&
+            Number.isFinite(record.expiresAt)
+            ? { ownerId, expiresAt: record.expiresAt }
+            : null;
+    }
+    catch {
+        return null;
+    }
+};
+export class TabActivityLock {
+    constructor(siteKey, ownerId, onOtherTabChange, onTakeoverRequest = () => undefined, onHandoff = () => undefined) {
+        this.ownerId = ownerId;
+        this.onOtherTabChange = onOtherTabChange;
+        this.onTakeoverRequest = onTakeoverRequest;
+        this.onHandoff = onHandoff;
+        this.refreshTimer = null;
+        this.takeoverRetryTimer = null;
+        this.owned = false;
+        this.takeoverRequestId = null;
+        this.takeoverOwnerId = null;
+        this.takeoverAttempts = 0;
+        this.onStorage = (event) => {
+            if (event.key !== this.key)
+                return;
+            if (this.takeoverRequestId &&
+                !this.owned &&
+                this.read()?.ownerId === this.ownerId) {
+                return;
+            }
+            this.reportOtherTab();
+        };
+        this.onMessage = (event) => {
+            const value = event.data;
+            if (value.type === 'active' && value.ownerId !== this.ownerId) {
+                this.onOtherTabChange(true);
+                return;
+            }
+            if (value.type === 'ended') {
+                this.reportOtherTab();
+                return;
+            }
+            if (value.type === 'takeover-request' &&
+                value.ownerId === this.ownerId &&
+                validId(value.requesterId) &&
+                validId(value.requestId) &&
+                this.owned) {
+                this.onTakeoverRequest(value.requesterId, value.requestId);
+                return;
+            }
+            if (value.type === 'handoff' &&
+                value.ownerId === this.ownerId &&
+                value.requesterId === this.ownerId &&
+                validId(value.requestId) &&
+                value.requestId === this.takeoverRequestId &&
+                this.read()?.ownerId === this.ownerId) {
+                this.clearTakeoverRequest();
+                this.owned = true;
+                this.startRefresh();
+                this.onOtherTabChange(false);
+                this.onHandoff(value.payload);
+            }
+        };
+        this.key = `__oxvo_ai_live_assist_active_${siteKey}`;
+        this.channel = typeof BroadcastChannel === 'undefined'
+            ? null
+            : new BroadcastChannel(`oxvo-ai-live-assist:${siteKey}`);
+        this.channel?.addEventListener('message', this.onMessage);
+        window.addEventListener('storage', this.onStorage);
+        this.reportOtherTab();
+    }
+    acquire() {
+        const current = this.read();
+        if (current &&
+            current.expiresAt > Date.now() &&
+            current.ownerId !== this.ownerId) {
+            this.onOtherTabChange(true);
+            return false;
+        }
+        this.writeOwner(this.ownerId);
+        const confirmed = this.read();
+        if (confirmed?.ownerId !== this.ownerId) {
+            this.onOtherTabChange(true);
+            return false;
+        }
+        this.owned = true;
+        this.startRefresh();
+        this.channel?.postMessage({ type: 'active', ownerId: this.ownerId });
+        this.onOtherTabChange(false);
+        return true;
+    }
+    requestTakeover() {
+        const current = this.read();
+        if (!this.channel ||
+            !current ||
+            current.expiresAt <= Date.now() ||
+            current.ownerId === this.ownerId) {
+            return false;
+        }
+        const requestId = `takeover_${crypto.randomUUID()}`;
+        this.clearTakeoverRequest();
+        this.takeoverRequestId = requestId;
+        this.takeoverOwnerId = current.ownerId;
+        this.sendTakeoverRequest();
+        return true;
+    }
+    handoff(requesterId, requestId, payload) {
+        if (!this.channel ||
+            !this.owned ||
+            !validId(requesterId) ||
+            !validId(requestId) ||
+            this.read()?.ownerId !== this.ownerId) {
+            return false;
+        }
+        this.stopRefresh();
+        this.writeOwner(requesterId);
+        if (this.read()?.ownerId !== requesterId) {
+            this.startRefresh();
+            return false;
+        }
+        this.owned = false;
+        this.channel.postMessage({
+            type: 'handoff',
+            ownerId: requesterId,
+            requesterId,
+            requestId,
+            payload,
+        });
+        this.onOtherTabChange(true);
+        return true;
+    }
+    isOwnedByOther() {
+        const current = this.read();
+        return Boolean(current &&
+            current.expiresAt > Date.now() &&
+            current.ownerId !== this.ownerId);
+    }
+    release() {
+        this.stopRefresh();
+        const released = this.owned && this.read()?.ownerId === this.ownerId;
+        if (released) {
+            try {
+                localStorage.removeItem(this.key);
+            }
+            catch {
+                // Storage may be unavailable in strict privacy modes.
+            }
+        }
+        this.owned = false;
+        this.clearTakeoverRequest();
+        if (released) {
+            this.channel?.postMessage({ type: 'ended', ownerId: this.ownerId });
+        }
+        this.reportOtherTab();
+    }
+    destroy() {
+        this.release();
+        this.channel?.removeEventListener('message', this.onMessage);
+        this.channel?.close();
+        window.removeEventListener('storage', this.onStorage);
+    }
+    read() {
+        try {
+            return parse(localStorage.getItem(this.key));
+        }
+        catch {
+            return null;
+        }
+    }
+    writeOwner(ownerId) {
+        try {
+            localStorage.setItem(this.key, JSON.stringify({ ownerId, expiresAt: Date.now() + 15000 }));
+        }
+        catch {
+            // The server's distributed lease remains authoritative.
+        }
+    }
+    startRefresh() {
+        this.stopRefresh();
+        this.refreshTimer = setInterval(() => this.writeOwner(this.ownerId), 5000);
+    }
+    stopRefresh() {
+        if (this.refreshTimer)
+            clearInterval(this.refreshTimer);
+        this.refreshTimer = null;
+    }
+    reportOtherTab() {
+        this.onOtherTabChange(this.isOwnedByOther());
+    }
+    sendTakeoverRequest() {
+        const requestId = this.takeoverRequestId;
+        const ownerId = this.takeoverOwnerId;
+        if (!this.channel || !requestId || !ownerId || this.takeoverAttempts >= 6) {
+            this.clearTakeoverRequest();
+            return;
+        }
+        const current = this.read();
+        if (!current || current.expiresAt <= Date.now()) {
+            this.clearTakeoverRequest();
+            this.reportOtherTab();
+            return;
+        }
+        if (current.ownerId !== ownerId) {
+            if (current.ownerId === this.ownerId && !this.owned) {
+                if (this.takeoverRetryTimer)
+                    clearTimeout(this.takeoverRetryTimer);
+                this.takeoverRetryTimer = setTimeout(() => this.expireIncompleteHandoff(), 5000);
+                return;
+            }
+            this.clearTakeoverRequest();
+            this.reportOtherTab();
+            return;
+        }
+        this.takeoverAttempts += 1;
+        this.channel.postMessage({
+            type: 'takeover-request',
+            ownerId,
+            requesterId: this.ownerId,
+            requestId,
+        });
+        if (this.takeoverRequestId === requestId) {
+            this.takeoverRetryTimer = setTimeout(() => this.sendTakeoverRequest(), 250);
+        }
+    }
+    clearTakeoverRequest() {
+        if (this.takeoverRetryTimer)
+            clearTimeout(this.takeoverRetryTimer);
+        this.takeoverRetryTimer = null;
+        this.takeoverRequestId = null;
+        this.takeoverOwnerId = null;
+        this.takeoverAttempts = 0;
+    }
+    expireIncompleteHandoff() {
+        if (!this.owned && this.read()?.ownerId === this.ownerId) {
+            try {
+                localStorage.removeItem(this.key);
+            }
+            catch {
+                // The distributed lease expires independently when storage is unavailable.
+            }
+        }
+        this.clearTakeoverRequest();
+        this.reportOtherTab();
+    }
+}

package/lib/types.d.ts

@@ -0,0 +1,299 @@
+export type ConsentScope = "ai_disclosure" | "text" | "microphone" | "page_context" | "browser_control" | "visual_context" | "handoff_context" | "retained_transcript" | "presentation_guidance";
+export type ExperienceMode = "standard" | "voice_presence";
+export type CapabilityTier = "standard" | "reduced_motion" | "low_power" | "static";
+export type VoicePresenceConfig = {
+    enabled: boolean;
+    strictVoiceOnly: boolean;
+    fallback: "none" | "offer_standard_assist" | "offer_human_handoff";
+    launcher: {
+        position: "bottom_right" | "bottom_left";
+        size: "compact" | "comfortable";
+        theme?: "light" | "dark";
+        offsetInlinePx: number;
+        offsetBlockPx: number;
+        showLabelOnFirstVisit: boolean;
+        customIconSvg?: string | null;
+    };
+    activation: {
+        title: string;
+        description: string;
+        primaryLabel: string;
+        secondaryLabel: string;
+        detailsLabel: string | null;
+    };
+    captions: {
+        enabled: true;
+        showVisitorFinal: boolean;
+        showAssistantFinal: boolean;
+        showInterimVisitor: boolean;
+        maxLines: number;
+        maxCharacters: number;
+        visibleMs: number;
+        placement: "adaptive" | "launcher_only" | "target_when_relevant";
+    };
+    visual: {
+        themeVersion: 1;
+        intensity: "subtle" | "balanced" | "immersive";
+        introWake: boolean;
+        spatialTrail: boolean;
+        lowPowerMode: "auto" | "always" | "never";
+    };
+    presentation: {
+        aiCursor: boolean;
+        spotlight: boolean;
+        annotations: boolean;
+        spatialCallouts: boolean;
+        sequenceMarkers: boolean;
+        maxActiveCues: number;
+        maxCuesPerMinute: number;
+    };
+};
+export type AssistMode = "text" | "voice";
+export type BrowserAction = "scroll" | "highlight" | "focus" | "click" | "type" | "select" | "submit";
+export type Sensitivity = "none" | "private" | "password" | "otp" | "payment" | "banking" | "recovery" | "authentication_secret" | "api_secret";
+export type BootstrapConfig = {
+    schemaVersion: 1;
+    protocol: {
+        min: number;
+        max: number;
+    };
+    available: boolean;
+    replayRecordingEnabled?: boolean;
+    experienceMode?: ExperienceMode;
+    minimumProtocolVersion?: 1 | 2;
+    minimumClientVersion?: string;
+    configRevision?: number;
+    configChecksum?: string;
+    widgetVersion?: string;
+    capabilities?: {
+        text: boolean;
+        voice: boolean;
+        captions: boolean;
+        pageContext: boolean;
+        browserControl: boolean;
+        visualContext: boolean;
+        voicePresence: boolean;
+        presentation: boolean;
+        aiCursor: boolean;
+        annotations: boolean;
+        spatialCallouts: boolean;
+        handoff: boolean;
+    };
+    agentAccess?: {
+        discoveryUrl: string;
+    };
+    voice?: {
+        turnMode: "semantic_vad" | "server_vad" | "manual";
+    };
+    appearance?: {
+        brandName: string;
+        launcherLabel: string;
+        accent: string;
+        position: "left" | "right";
+        panelWidth: number;
+        glassEffect: boolean;
+        hideLauncherWhenVisitorLimited: boolean;
+        attribution?: {
+            enabled: boolean;
+        };
+        welcomeMessage: string | null;
+        voicePresence?: VoicePresenceConfig;
+    };
+    visitorEligibility?: {
+        status: "eligible" | "visitor_active" | "visitor_limited" | "cooldown_limited";
+    };
+    consent?: {
+        disclosure: string;
+        disclosureChecksum: string;
+        policyUrl: string | null;
+        termsUrl: string | null;
+        requiredScopes: ConsentScope[];
+        optionalScopes: ConsentScope[];
+    };
+    locale?: {
+        default: string;
+        allowed: string[];
+    };
+    safety?: {
+        policyVersion: number;
+        selectorRegions: Array<{
+            digest: string;
+            selector: string;
+        }>;
+    };
+    cache: {
+        maxAgeSeconds: number;
+    };
+};
+export type LaunchResult = {
+    schemaVersion: 1 | 2;
+    protocolVersion: 1 | 2;
+    experienceMode: ExperienceMode;
+    capabilityTier: CapabilityTier;
+    sessionId: string;
+    launchCredential: string;
+    controlCredential: string;
+    resumeCredential: string;
+    feedbackCredential: string;
+    expiresAt: string;
+    feedbackExpiresAt: string;
+    controlUrl: string;
+    realtimeOfferUrl: string;
+    capabilities?: NonNullable<BootstrapConfig["capabilities"]>;
+    assistant?: {
+        name: string;
+        voice: string | null;
+        welcomeMessage: string | null;
+    };
+    state?: "reconnecting";
+    correlationId?: string;
+};
+export type ControlServerEnvelope = {
+    v: 1 | 2;
+    id: string;
+    type: string;
+    sessionId: string;
+    sequence: number;
+    sentAt: string;
+    payload: Record<string, unknown>;
+};
+export type SanitizedOption = {
+    id: string;
+    label: string;
+    disabled: boolean;
+};
+export type SanitizedTarget = {
+    targetId: string;
+    revision: number;
+    role: string;
+    name: string;
+    inputType?: string;
+    autocomplete?: string;
+    semanticRegion?: string;
+    sensitivity: Sensitivity;
+    protectedRegion?: boolean;
+    frameOrigin?: "same_origin" | "cross_origin";
+    consequence?: "none" | "navigation" | "state_change" | "submission" | "financial" | "account" | "destructive";
+    regionAssessment?: {
+        policyVersion: number;
+        evaluatedRuleDigests: string[];
+        matchedRuleDigests: string[];
+    };
+    state: {
+        visible: boolean;
+        enabled: boolean;
+        covered?: boolean;
+        checked?: boolean;
+    };
+    options?: SanitizedOption[];
+};
+export type PageContextSnapshot = {
+    schemaVersion: 1;
+    pageId: string;
+    revision: number;
+    url: string;
+    title: string;
+    locale: string;
+    viewport: {
+        width: number;
+        height: number;
+        scrollY: number;
+    };
+    landmarks: Array<{
+        role: string;
+        label: string;
+    }>;
+    visibleText: Array<{
+        id: string;
+        text: string;
+        provenance: "page";
+    }>;
+    selection?: {
+        text: string;
+        source: "document";
+        capturedAt: string;
+    };
+    targets: SanitizedTarget[];
+    alerts: string[];
+    truncated: boolean;
+};
+export type VisualContextCapture = {
+    source: "sanitized_layout";
+    mimeType: "image/jpeg";
+    dataUrl: string;
+    width: number;
+    height: number;
+    pageId: string;
+    revision: number;
+};
+export type VisualContextRequest = {
+    requestId: string;
+    functionCallId: string;
+    reason: string;
+    expiresAt: string;
+    approvalMode: "manual" | "automatic";
+};
+export type ActionGrant = {
+    grant: string;
+    actionId: string;
+    action: BrowserAction;
+    targetId: string;
+    domRevision: number;
+    fencingToken: number;
+    expiresAt: string;
+    value?: string;
+    optionValueId?: string;
+    desiredChecked?: boolean;
+};
+export type ActionExecutionResult = {
+    grant: string;
+    actionId: string;
+    status: "executed" | "blocked" | "stale" | "failed";
+    observed: {
+        url?: string;
+        revision: number;
+        targetState: "unchanged" | "changed" | "detached" | "unknown";
+        safeSummary: string;
+        checked?: boolean;
+    };
+};
+export type PresentationKind = "pointer" | "spotlight" | "underline" | "circle" | "arrow" | "connector" | "sequence_marker" | "callout" | "clear";
+export type PresentationIntent = {
+    presentationId: string;
+    groupId: string | null;
+    kind: PresentationKind;
+    targetId: string | null;
+    secondaryTargetId: string | null;
+    domRevision: number;
+    message: string | null;
+    emphasis: "subtle" | "normal" | "strong";
+    ttlMs: number;
+    replaceGroup: boolean;
+};
+export type PresentationResult = {
+    presentationId: string;
+    status: "shown" | "blocked" | "stale" | "unsupported" | "cleared";
+    reasonCode: "OK" | "PRESENTATION_DISABLED" | "PRESENTATION_TARGET_STALE" | "PRESENTATION_TARGET_BLOCKED" | "PRESENTATION_RATE_LIMITED" | "VISITOR_ACTIVITY" | "REDUCED_MOTION_FALLBACK" | "CAPABILITY_UNAVAILABLE" | "NAVIGATION";
+    pageId: string;
+    domRevision: number;
+    shownAt: string | null;
+};
+export type PresentationTarget = {
+    targetId: string;
+    pageId: string;
+    revision: number;
+    rect: DOMRectReadOnly;
+    safe: boolean;
+};
+export type WidgetMessageKey = "launcher" | "introTitle" | "disclosure" | "requiredConsent" | "consentAgreement" | "legalDetails" | "legalTitle" | "legalClose" | "termsOfService" | "microphoneConsent" | "pageConsent" | "controlConsent" | "visualConsent" | "visualRequest" | "shareVisual" | "declineVisual" | "visualShared" | "visualUnavailable" | "pauseVisual" | "resumeVisual" | "handoffConsent" | "retentionConsent" | "startText" | "startVoice" | "connecting" | "listening" | "thinking" | "speaking" | "ready" | "paused" | "reconnecting" | "end" | "restart" | "close" | "minimize" | "maximize" | "activeCall" | "movePanel" | "mute" | "unmute" | "interrupt" | "usePushToTalk" | "useAutomaticTurns" | "automaticTurnsUnavailable" | "startSpeaking" | "sendVoiceTurn" | "microphoneUnavailable" | "pauseActions" | "resumeActions" | "captionsOn" | "captionsOff" | "textOnly" | "send" | "messagePlaceholder" | "requestHuman" | "continueWithFullAssist" | "requestHumanFallback" | "approve" | "decline" | "actionRequest" | "actionRunning" | "actionVerified" | "actionFailed" | "limitReached" | "ended" | "idleEnded" | "feedbackQuestion" | "resolved" | "partiallyResolved" | "notResolved" | "submitFeedback" | "error" | "retry" | "activeElsewhere" | "visitorLimitReached" | "visitorCooldown" | "visitorAlreadyActive" | "safetyBoundary" | "privacyPolicy" | "moreControls" | "emptyConversation" | "audioPaused" | "humanConnected" | "humanConnecting" | "humanUnavailable" | "textMode" | "reconnectFailed" | "connectedTool" | "approvedService" | "approvedToolEffect";
+export type PluginOptions = {
+    enabled?: boolean;
+    recordReplay?: boolean;
+    runtimeUrl?: string;
+    siteKey?: string;
+    locale?: string;
+    messages?: Partial<Record<WidgetMessageKey, string>>;
+    bootstrapTimeoutMs?: number;
+    visualTestMode?: boolean;
+    onStateChange?: (state: string) => void;
+};

package/lib/types.js

@@ -0,0 +1 @@
+export {};