@bytexbyte/nxtlinq-ai-agent-web-development 0.1.1

package/dist/legacy/core/utils/urlUtils.js

@@ -0,0 +1,135 @@
+/**
+ * URL utility functions for detecting and converting URLs to clickable links
+ */
+import * as React from 'react';
+/**
+ * Regular expression to match Markdown-style links
+ * Matches [text](url) format
+ */
+const MARKDOWN_LINK_REGEX = /\[([^\]]+)\]\(([^)]+)\)/g;
+/**
+ * Regular expression to match URLs
+ * Supports http, https, ftp, and www protocols
+ */
+const URL_REGEX = /(https?:\/\/[^\s]+|www\.[^\s]+|[a-zA-Z0-9-]+\.[a-zA-Z]{2,}(?:\/[^\s]*)?)/g;
+/**
+ * Check if a string contains URLs
+ * @param text - The text to check
+ * @returns boolean indicating if URLs are found
+ */
+export const containsUrls = (text) => {
+    return URL_REGEX.test(text);
+};
+/**
+ * Convert text with line breaks to JSX elements with <br/> tags
+ * @param text - The text containing line breaks
+ * @param keyPrefix - Prefix for React keys
+ * @returns Array of JSX elements and strings
+ */
+const convertLineBreaks = (text, keyPrefix = '') => {
+    const parts = [];
+    const lines = text.split('\n');
+    lines.forEach((line, index) => {
+        if (index > 0) {
+            parts.push(React.createElement('br', { key: `${keyPrefix}-br-${index}` }));
+        }
+        if (line) {
+            parts.push(line);
+        }
+    });
+    return parts;
+};
+/**
+ * Convert text with URLs to JSX elements with clickable links
+ * Supports both Markdown format [text](url) and plain URLs
+ * Also handles line breaks (\n)
+ * @param text - The text containing URLs
+ * @returns Array of JSX elements and strings
+ */
+export const convertUrlsToLinks = (text) => {
+    const parts = [];
+    let lastIndex = 0;
+    let keyCounter = 0;
+    // First, find all markdown links and plain URLs
+    const items = [];
+    // Find markdown links
+    let markdownMatch;
+    MARKDOWN_LINK_REGEX.lastIndex = 0;
+    while ((markdownMatch = MARKDOWN_LINK_REGEX.exec(text)) !== null) {
+        items.push({
+            type: 'markdown',
+            start: markdownMatch.index,
+            end: markdownMatch.index + markdownMatch[0].length,
+            text: markdownMatch[1],
+            url: markdownMatch[2]
+        });
+    }
+    // Find plain URLs (but exclude those already matched as markdown links)
+    let urlMatch;
+    URL_REGEX.lastIndex = 0;
+    while ((urlMatch = URL_REGEX.exec(text)) !== null) {
+        const start = urlMatch.index;
+        const end = start + urlMatch[0].length;
+        // Check if this URL is already part of a markdown link
+        const isPartOfMarkdown = items.some(item => item.type === 'markdown' && start >= item.start && end <= item.end);
+        if (!isPartOfMarkdown) {
+            items.push({
+                type: 'url',
+                start,
+                end,
+                url: urlMatch[0]
+            });
+        }
+    }
+    // Sort items by start position
+    items.sort((a, b) => a.start - b.start);
+    // Build the result
+    items.forEach(item => {
+        // Add text before this item (with line breaks)
+        if (item.start > lastIndex) {
+            const textBefore = text.slice(lastIndex, item.start);
+            const textBeforeParts = convertLineBreaks(textBefore, `text-${keyCounter}`);
+            parts.push(...textBeforeParts);
+            keyCounter++;
+        }
+        // Create clickable link
+        const href = item.url.startsWith('http') ? item.url : `https://${item.url}`;
+        const displayText = item.type === 'markdown' ? item.text : item.url;
+        parts.push(React.createElement('a', {
+            key: `link-${keyCounter++}`,
+            href: href,
+            target: '_blank',
+            rel: 'noopener noreferrer',
+            style: {
+                color: '#007bff',
+                textDecoration: 'underline',
+                cursor: 'pointer'
+            },
+            className: 'ai-agent-url-link',
+            onClick: (e) => {
+                e.preventDefault(); // Prevent default browser behavior
+                e.stopPropagation();
+                window.open(href, '_blank', 'noopener,noreferrer');
+            }
+        }, displayText));
+        lastIndex = item.end;
+    });
+    // Add remaining text after the last link (with line breaks)
+    if (lastIndex < text.length) {
+        const textAfter = text.slice(lastIndex);
+        const textAfterParts = convertLineBreaks(textAfter, `text-${keyCounter}`);
+        parts.push(...textAfterParts);
+    }
+    return parts.length > 0 ? parts : convertLineBreaks(text, 'default');
+};
+/**
+ * Simple function to wrap URLs in anchor tags for basic HTML rendering
+ * @param text - The text containing URLs
+ * @returns HTML string with clickable links
+ */
+export const convertUrlsToHtml = (text) => {
+    return text.replace(URL_REGEX, (url) => {
+        const href = url.startsWith('http') ? url : `https://${url}`;
+        return `<a href="${href}" target="_blank" rel="noopener noreferrer" style="color: #007bff; text-decoration: underline; cursor: pointer;">${url}</a>`;
+    });
+};

package/dist/legacy/core/utils/walletTextUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Adilas Service ID constant
+ */
+export declare const ADILAS_SERVICE_ID = "e48fc2b9-a7d1-49e3-85cb-9d621a0bf774";
+/**
+ * Check if the given serviceId is the Adilas service
+ */
+export declare const isAdilasService: (serviceId: string | undefined | null) => boolean;
+/**
+ * Replace "wallet" with "account" in text when serviceId is Adilas service
+ * Preserves the original case of the word
+ */
+export declare const getWalletText: (defaultText: string, serviceId: string | undefined | null) => string;
+//# sourceMappingURL=walletTextUtils.d.ts.map

package/dist/legacy/core/utils/walletTextUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletTextUtils.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/utils/walletTextUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,yCAAyC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAEtE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,aAAa,MAAM,EAAE,WAAW,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,MAQzF,CAAC"}

package/dist/legacy/core/utils/walletTextUtils.js

@@ -0,0 +1,23 @@
+/**
+ * Adilas Service ID constant
+ */
+export const ADILAS_SERVICE_ID = 'e48fc2b9-a7d1-49e3-85cb-9d621a0bf774';
+/**
+ * Check if the given serviceId is the Adilas service
+ */
+export const isAdilasService = (serviceId) => {
+    return serviceId ? serviceId.trim() === ADILAS_SERVICE_ID : false;
+};
+/**
+ * Replace "wallet" with "account" in text when serviceId is Adilas service
+ * Preserves the original case of the word
+ */
+export const getWalletText = (defaultText, serviceId) => {
+    if (!isAdilasService(serviceId))
+        return defaultText;
+    // Replace wallet with account, preserving case
+    return defaultText.replace(/\bwallet\b/gi, (match) => {
+        // Preserve original case: 'Wallet' -> 'Account', 'wallet' -> 'account'
+        return match.charAt(0) === 'W' ? 'Account' : 'account';
+    });
+};

package/dist/legacy/core/utils/walletUtils.d.ts

@@ -0,0 +1,10 @@
+import { ethers } from 'ethers';
+export interface WalletConnectionResult {
+    address: string;
+    signer: ethers.JsonRpcSigner;
+}
+export declare const connectWallet: () => Promise<WalletConnectionResult>;
+export declare const disconnectWallet: () => void;
+export declare const getStoredWalletAddress: () => string | null;
+export declare const validateToken: (token: string, expectedAddress: string) => boolean;
+//# sourceMappingURL=walletUtils.d.ts.map

package/dist/legacy/core/utils/walletUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletUtils.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/utils/walletUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,sBAAsB,CAwBpE,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,IAEnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,MAAM,GAAG,IAElD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,iBAAiB,MAAM,KAAG,OAStE,CAAC"}

package/dist/legacy/core/utils/walletUtils.js

@@ -0,0 +1,38 @@
+import { ethers } from 'ethers';
+import metakeepClient from '../metakeepClient';
+import { getEthers } from './ethersUtils';
+export const connectWallet = async () => {
+    if (typeof window === 'undefined') {
+        throw new Error('Web3 is not available in server-side rendering');
+    }
+    getEthers();
+    const web3Provider = await metakeepClient.ethereum;
+    if (!web3Provider) {
+        throw new Error('Web3 provider not available');
+    }
+    await web3Provider.enable();
+    // ethers v6: Use BrowserProvider instead of Web3Provider
+    const ethersProvider = new ethers.BrowserProvider(web3Provider);
+    // ethers v6: getSigner() and getAddress() are now async
+    const signer = await ethersProvider.getSigner();
+    const address = await signer.getAddress();
+    localStorage.setItem('walletAddress', address);
+    return { address, signer };
+};
+export const disconnectWallet = () => {
+    localStorage.removeItem('walletAddress');
+};
+export const getStoredWalletAddress = () => {
+    return localStorage.getItem('walletAddress');
+};
+export const validateToken = (token, expectedAddress) => {
+    try {
+        const payload = JSON.parse(atob(token.split('.')[1]));
+        const address = payload.address;
+        return address === expectedAddress;
+    }
+    catch (error) {
+        console.error('Error parsing token:', error);
+        return false;
+    }
+};

package/dist/legacy/index.d.ts

@@ -0,0 +1,19 @@
+export { createNxtlinqApi, setApiHosts, getAiAgentApiHost } from './api/nxtlinq-api';
+export { startVoiceSession, createVoiceApi } from './api/voice';
+export type * from './api/voice';
+export { useDraggable } from './core/lib/useDraggable';
+export { default as useLocalStorage } from './core/lib/useLocalStorage';
+export { default as useSessionStorage } from './core/lib/useSessionStorage';
+export { useResizable } from './core/lib/useResizable';
+export type { ResizeCorner } from './core/lib/useResizable';
+export { synthesizeSpeechToBuffer } from './core/lib/textToSpeech';
+export { useSpeechToTextFromMic } from './core/lib/useSpeechToTextFromMic';
+export { useVoiceMode } from './core/lib/useVoiceMode';
+export { default as metakeepClient } from './core/metakeepClient';
+export { getEthers, sleep } from './core/utils';
+export * as walletTextUtils from './core/utils/walletTextUtils';
+export { connectWallet, disconnectWallet, validateToken, } from './core/utils/walletUtils';
+export { createAITMetadata, generateAITId, prepareAITCreation, } from './core/utils/aitUtils';
+export { createNotification, getNotificationIcon, } from './core/utils/notificationUtils';
+export { containsUrls, convertUrlsToLinks, convertUrlsToHtml, } from './core/utils/urlUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/legacy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/legacy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,mBAAmB,aAAa,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,eAAe,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/legacy/index.js

@@ -0,0 +1,16 @@
+export { createNxtlinqApi, setApiHosts, getAiAgentApiHost } from './api/nxtlinq-api';
+export { startVoiceSession, createVoiceApi } from './api/voice';
+export { useDraggable } from './core/lib/useDraggable';
+export { default as useLocalStorage } from './core/lib/useLocalStorage';
+export { default as useSessionStorage } from './core/lib/useSessionStorage';
+export { useResizable } from './core/lib/useResizable';
+export { synthesizeSpeechToBuffer } from './core/lib/textToSpeech';
+export { useSpeechToTextFromMic } from './core/lib/useSpeechToTextFromMic';
+export { useVoiceMode } from './core/lib/useVoiceMode';
+export { default as metakeepClient } from './core/metakeepClient';
+export { getEthers, sleep } from './core/utils';
+export * as walletTextUtils from './core/utils/walletTextUtils';
+export { connectWallet, disconnectWallet, validateToken, } from './core/utils/walletUtils';
+export { createAITMetadata, generateAITId, prepareAITCreation, } from './core/utils/aitUtils';
+export { createNotification, getNotificationIcon, } from './core/utils/notificationUtils';
+export { containsUrls, convertUrlsToLinks, convertUrlsToHtml, } from './core/utils/urlUtils';

package/dist/ports/createWebPlatformPorts.d.ts

@@ -0,0 +1,13 @@
+import type { PlatformPorts, StoragePort, WebRTCPort } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export type CreateWebPlatformPortsOptions = {
+    /** Override default `localStorage` port. */
+    storage?: StoragePort;
+    fetchImpl?: typeof fetch;
+    getTimezone?: () => string;
+    /** Pre-built WebRTC port (overrides browser default). */
+    webrtc?: WebRTCPort;
+    /** Set `false` to disable voice (no WebRTC port). */
+    enableWebRTC?: boolean;
+};
+export declare function createWebPlatformPorts(options?: CreateWebPlatformPortsOptions): PlatformPorts;
+//# sourceMappingURL=createWebPlatformPorts.d.ts.map

package/dist/ports/createWebPlatformPorts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWebPlatformPorts.d.ts","sourceRoot":"","sources":["../../src/ports/createWebPlatformPorts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAOrH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,yDAAyD;IACzD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAOF,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,aAAa,CAkBf"}

package/dist/ports/createWebPlatformPorts.js

@@ -0,0 +1,25 @@
+import { createBrowserStoragePort, createBrowserWebRTCPort, createDefaultHttpPort, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+function resolveHttpPort(fetchImpl) {
+    if (!fetchImpl)
+        return createDefaultHttpPort();
+    return { fetch: fetchImpl };
+}
+export function createWebPlatformPorts(options = {}) {
+    const enableWebRTC = options.enableWebRTC !== false;
+    return {
+        storage: options.storage ?? createBrowserStoragePort(),
+        http: resolveHttpPort(options.fetchImpl),
+        webrtc: enableWebRTC
+            ? (options.webrtc ?? createBrowserWebRTCPort())
+            : undefined,
+        getTimezone: options.getTimezone
+            ?? (() => {
+                try {
+                    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+                }
+                catch {
+                    return 'UTC';
+                }
+            }),
+    };
+}

package/dist/utils/fileToAttachment.d.ts

@@ -0,0 +1,4 @@
+import type { Attachment } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/** Build an {@link Attachment} from a browser {@link File}. */
+export declare function fileToAttachment(file: File): Promise<Attachment>;
+//# sourceMappingURL=fileToAttachment.d.ts.map

package/dist/utils/fileToAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileToAttachment.d.ts","sourceRoot":"","sources":["../../src/utils/fileToAttachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAqB/E,+DAA+D;AAC/D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAStE"}

package/dist/utils/fileToAttachment.js

@@ -0,0 +1,28 @@
+function readFileAsDataUri(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+            if (typeof reader.result === 'string') {
+                resolve(reader.result);
+                return;
+            }
+            reject(new Error('fileToAttachment: failed to read file'));
+        };
+        reader.onerror = () => reject(reader.error ?? new Error('fileToAttachment: read error'));
+        reader.readAsDataURL(file);
+    });
+}
+function attachmentType(mimeType) {
+    return mimeType.startsWith('image/') ? 'image' : 'file';
+}
+/** Build an {@link Attachment} from a browser {@link File}. */
+export async function fileToAttachment(file) {
+    const url = await readFileAsDataUri(file);
+    return {
+        type: attachmentType(file.type || 'application/octet-stream'),
+        url,
+        name: file.name,
+        mimeType: file.type || 'application/octet-stream',
+        size: file.size,
+    };
+}

package/dist/voice/useVoiceSilenceCommit.d.ts

@@ -0,0 +1,11 @@
+import type { VoiceSession, VoiceStatus } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export declare function useVoiceSilenceCommit(getSession: () => VoiceSession | null, onMutedAfterCommit: () => void, voiceStatus: VoiceStatus): {
+    startPoll: () => void;
+    clearPoll: () => void;
+    resetTurn: () => void;
+    onSpeechRms: (rms: number) => void;
+    tryCommit: (reason: "silence" | "manual") => void;
+    consumeSkipCommitOnMute: () => boolean;
+    hasHadSpeech: () => boolean;
+};
+//# sourceMappingURL=useVoiceSilenceCommit.d.ts.map

package/dist/voice/useVoiceSilenceCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceSilenceCommit.d.ts","sourceRoot":"","sources":["../../src/voice/useVoiceSilenceCommit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAU9F,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,YAAY,GAAG,IAAI,EACrC,kBAAkB,EAAE,MAAM,IAAI,EAC9B,WAAW,EAAE,WAAW;;;;uBAmDc,MAAM;wBAhCL,SAAS,GAAG,QAAQ;;;EAmD5D"}

package/dist/voice/useVoiceSilenceCommit.js

@@ -0,0 +1,68 @@
+import { useCallback, useRef } from 'react';
+import { ASSISTANT_MIC_HOLD_STATUSES } from './voiceMicConstants';
+import { MIC_BARGE_IN_RMS_THRESHOLD, MIC_SILENCE_COMMIT_MS, MIC_SILENCE_POLL_MS, MIC_SPEECH_RMS_THRESHOLD, } from './ws/voiceSilenceConstants';
+export function useVoiceSilenceCommit(getSession, onMutedAfterCommit, voiceStatus) {
+    const lastSpeechAtRef = useRef(0);
+    const hadSpeechRef = useRef(false);
+    const commitInFlightRef = useRef(false);
+    const skipCommitOnMuteRef = useRef(false);
+    const pollRef = useRef(null);
+    const voiceStatusRef = useRef(voiceStatus);
+    voiceStatusRef.current = voiceStatus;
+    const onMutedAfterCommitRef = useRef(onMutedAfterCommit);
+    onMutedAfterCommitRef.current = onMutedAfterCommit;
+    const clearPoll = useCallback(() => {
+        if (pollRef.current) {
+            clearInterval(pollRef.current);
+            pollRef.current = null;
+        }
+    }, []);
+    const tryCommit = useCallback((reason) => {
+        const session = getSession();
+        if (commitInFlightRef.current)
+            return;
+        if (!hadSpeechRef.current) {
+            session?.clearInputAudio?.();
+            return;
+        }
+        commitInFlightRef.current = true;
+        hadSpeechRef.current = false;
+        session?.commitInputAudio?.();
+        if (reason === 'silence') {
+            skipCommitOnMuteRef.current = true;
+            onMutedAfterCommitRef.current();
+        }
+        queueMicrotask(() => { commitInFlightRef.current = false; });
+    }, [getSession]);
+    const startPoll = useCallback(() => {
+        clearPoll();
+        pollRef.current = setInterval(() => {
+            if (commitInFlightRef.current || !hadSpeechRef.current)
+                return;
+            if (Date.now() - lastSpeechAtRef.current < MIC_SILENCE_COMMIT_MS)
+                return;
+            tryCommit('silence');
+        }, MIC_SILENCE_POLL_MS);
+    }, [clearPoll, tryCommit]);
+    const resetTurn = useCallback(() => {
+        hadSpeechRef.current = false;
+        lastSpeechAtRef.current = Date.now();
+        getSession()?.clearInputAudio?.();
+    }, [getSession]);
+    const onSpeechRms = useCallback((rms) => {
+        const threshold = ASSISTANT_MIC_HOLD_STATUSES.has(voiceStatusRef.current)
+            ? MIC_BARGE_IN_RMS_THRESHOLD
+            : MIC_SPEECH_RMS_THRESHOLD;
+        if (rms >= threshold) {
+            lastSpeechAtRef.current = Date.now();
+            hadSpeechRef.current = true;
+        }
+    }, []);
+    const consumeSkipCommitOnMute = useCallback(() => {
+        const skip = skipCommitOnMuteRef.current;
+        skipCommitOnMuteRef.current = false;
+        return skip;
+    }, []);
+    const hasHadSpeech = useCallback(() => hadSpeechRef.current, []);
+    return { startPoll, clearPoll, resetTurn, onSpeechRms, tryCommit, consumeSkipCommitOnMute, hasHadSpeech };
+}

package/dist/voice/useVoiceTranscriptMessages.d.ts

@@ -0,0 +1,16 @@
+import type { Message, VoiceDoneEvent, VoiceTranscriptEvent } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+type InteractionMode = 'text' | 'voice';
+type VoiceTranscriptAgentApi = {
+    getMessages: () => Message[];
+    setMessages: (messages: Message[]) => void;
+    syncVoiceTurnHistory: (options?: {
+        last?: number;
+    }) => Promise<void>;
+};
+export declare function useVoiceTranscriptMessages(api: VoiceTranscriptAgentApi, interactionMode: InteractionMode, voiceSessionId: string | null, getVoiceSessionId?: () => string | null): {
+    handleTranscript: (event: VoiceTranscriptEvent) => void;
+    handleDone: (event: VoiceDoneEvent) => void;
+    clearVoiceStream: () => void;
+};
+export {};
+//# sourceMappingURL=useVoiceTranscriptMessages.d.ts.map

package/dist/voice/useVoiceTranscriptMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceTranscriptMessages.d.ts","sourceRoot":"","sources":["../../src/voice/useVoiceTranscriptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AAKtD,KAAK,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC,KAAK,uBAAuB,GAAG;IAC7B,WAAW,EAAE,MAAM,OAAO,EAAE,CAAC;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC3C,oBAAoB,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE,CAAC;AAWF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,uBAAuB,EAC5B,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI;8BAqG7B,oBAAoB;wBA4BpB,cAAc;;EAwBzB"}

package/dist/voice/useVoiceTranscriptMessages.js

@@ -0,0 +1,134 @@
+import { mergeStreamingTranscript } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { useCallback, useRef } from 'react';
+import { flushSync } from 'react-dom';
+const STREAM_PREFIX = 'voice-stream-';
+function voiceMeta(sessionId) {
+    return {
+        voiceRealtime: true,
+        voiceSessionId: sessionId ?? undefined,
+    };
+}
+export function useVoiceTranscriptMessages(api, interactionMode, voiceSessionId, getVoiceSessionId) {
+    const streamIdRef = useRef(null);
+    const sessionIdRef = useRef(voiceSessionId);
+    sessionIdRef.current = voiceSessionId;
+    const resolveSessionId = useCallback(() => getVoiceSessionId?.() ?? sessionIdRef.current, [getVoiceSessionId]);
+    const isVoiceUiActive = useCallback(() => interactionMode === 'voice', [interactionMode]);
+    const upsertStreaming = useCallback((text) => {
+        const messages = api.getMessages();
+        let streamId = streamIdRef.current;
+        if (!streamId) {
+            streamId = `${STREAM_PREFIX}${Date.now()}`;
+            streamIdRef.current = streamId;
+        }
+        const idx = messages.findIndex((m) => m.id === streamId);
+        const partialContent = idx >= 0
+            ? mergeStreamingTranscript(messages[idx]?.partialContent ?? '', text)
+            : text;
+        const meta = voiceMeta(resolveSessionId());
+        const apply = () => {
+            if (idx >= 0) {
+                api.setMessages(messages.map((m, i) => i === idx
+                    ? { ...m, partialContent, isStreaming: true, metadata: { ...m.metadata, ...meta } }
+                    : m));
+                return;
+            }
+            api.setMessages([
+                ...messages,
+                {
+                    id: streamId,
+                    role: 'assistant',
+                    content: '',
+                    partialContent,
+                    isStreaming: true,
+                    timestamp: new Date().toISOString(),
+                    metadata: meta,
+                },
+            ]);
+        };
+        flushSync(apply);
+    }, [api, resolveSessionId]);
+    const finalizeAssistant = useCallback((text, messageId) => {
+        const trimmed = text.trim();
+        streamIdRef.current = null;
+        if (!trimmed)
+            return;
+        const messages = api.getMessages();
+        const streamIdx = messages.findIndex((m) => m.isStreaming && m.role === 'assistant');
+        if (streamIdx >= 0) {
+            api.setMessages(messages.map((m, i) => i === streamIdx
+                ? {
+                    ...m,
+                    id: messageId ?? m.id,
+                    content: trimmed,
+                    partialContent: undefined,
+                    isStreaming: false,
+                    metadata: { ...m.metadata, ...voiceMeta(resolveSessionId()) },
+                }
+                : m));
+            return;
+        }
+        const last = messages[messages.length - 1];
+        if (last?.role === 'assistant' && last.content === trimmed)
+            return;
+        api.setMessages([
+            ...messages,
+            {
+                id: messageId ?? `voice-asst-${Date.now()}`,
+                role: 'assistant',
+                content: trimmed,
+                timestamp: new Date().toISOString(),
+                metadata: voiceMeta(resolveSessionId()),
+            },
+        ]);
+    }, [api, resolveSessionId]);
+    const handleTranscript = useCallback((event) => {
+        if (!isVoiceUiActive())
+            return;
+        const text = event.text?.trim() ?? '';
+        if (event.role === 'assistant') {
+            // Keep one streaming bubble for the whole turn; finalize only in handleDone.
+            if (text)
+                upsertStreaming(text);
+            return;
+        }
+        if (event.role === 'user' && !event.interim && text) {
+            const messages = api.getMessages();
+            const last = messages[messages.length - 1];
+            if (last?.role === 'user' && last.content === text)
+                return;
+            api.setMessages([
+                ...messages,
+                {
+                    id: `voice-user-${Date.now()}`,
+                    role: 'user',
+                    content: text,
+                    timestamp: new Date().toISOString(),
+                    metadata: voiceMeta(resolveSessionId()),
+                },
+            ]);
+        }
+    }, [api, finalizeAssistant, isVoiceUiActive, resolveSessionId, upsertStreaming]);
+    const handleDone = useCallback((event) => {
+        if (!isVoiceUiActive())
+            return;
+        if (event.guardrailsBlocked || event.billingBlocked || event.error) {
+            streamIdRef.current = null;
+            return;
+        }
+        const reply = event.replyText?.trim() ?? '';
+        if (reply) {
+            finalizeAssistant(reply, event.assistantMessageId ?? undefined);
+        }
+        else {
+            streamIdRef.current = null;
+        }
+        void api.syncVoiceTurnHistory({ last: 20 }).catch((err) => {
+            console.warn('[nxtlinq] syncVoiceTurnHistory after voice turn failed', err);
+        });
+    }, [api, finalizeAssistant, isVoiceUiActive]);
+    const clearVoiceStream = useCallback(() => {
+        streamIdRef.current = null;
+    }, []);
+    return { handleTranscript, handleDone, clearVoiceStream };
+}

package/dist/voice/useWsRealtimeAudio.d.ts

@@ -0,0 +1,18 @@
+import type { VoiceSession, VoiceStatus } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+type WsVoiceCallbacks = {
+    onOpen?: () => void;
+    onAudioDelta?: (pcm16: Int16Array | ArrayBuffer) => void;
+    onClose?: (reason: string) => void;
+    onError?: (err: Error) => void;
+};
+export type UseWsRealtimeAudioOptions = {
+    voiceStatus: VoiceStatus;
+    muteAfterSilenceCommit: () => void;
+};
+export declare function useWsRealtimeAudio(isCaptureActive: boolean, isVoiceActive: boolean, options: UseWsRealtimeAudioOptions): {
+    bindSession: (session: VoiceSession | null, captureWhenUnmuted?: boolean) => void;
+    buildCallbacks: (overrides?: Partial<WsVoiceCallbacks>) => WsVoiceCallbacks;
+    getOutputAudioLevel: () => number;
+};
+export {};
+//# sourceMappingURL=useWsRealtimeAudio.d.ts.map

package/dist/voice/useWsRealtimeAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWsRealtimeAudio.d.ts","sourceRoot":"","sources":["../../src/voice/useWsRealtimeAudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAM9F,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,yBAAyB;2BA+EQ,YAAY,GAAG,IAAI;iCAQb,OAAO,CAAC,gBAAgB,CAAC,KAAG,gBAAgB;;EAgC7F"}