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

package/dist/context/NxtlinqAgentContext.d.ts

@@ -0,0 +1,12 @@
+import { NxtlinqAgent, type AgentConfig } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import React, { type ReactNode } from 'react';
+import { type CreateNxtlinqAgentWebOptions } from '../createNxtlinqAgent';
+type WebAgentInternalProps = 'voiceTransport' | 'voiceMode' | 'defaultModel' | 'enableWebRTC';
+export type NxtlinqAgentProviderProps = Omit<CreateNxtlinqAgentWebOptions, WebAgentInternalProps> & {
+    children: ReactNode;
+    resetOnIdentityChange?: boolean;
+};
+export declare function NxtlinqAgentProvider({ children, resetOnIdentityChange, ...options }: NxtlinqAgentProviderProps): React.ReactElement;
+export declare function useNxtlinqAgentContext(): NxtlinqAgent;
+export type { AgentConfig };
+//# sourceMappingURL=NxtlinqAgentContext.d.ts.map

package/dist/context/NxtlinqAgentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NxtlinqAgentContext.d.ts","sourceRoot":"","sources":["../../src/context/NxtlinqAgentContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EACjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,EAKZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AAI/B,KAAK,qBAAqB,GACtB,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,cAAc,CAAC;AAEnB,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,4BAA4B,EAC5B,qBAAqB,CACtB,GAAG;IACF,QAAQ,EAAE,SAAS,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,qBAA4B,EAC5B,GAAG,OAAO,EACX,EAAE,yBAAyB,GAAG,KAAK,CAAC,YAAY,CA8BhD;AAED,wBAAgB,sBAAsB,IAAI,YAAY,CAQrD;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/context/NxtlinqAgentContext.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, } from 'react';
+import { createNxtlinqAgentWeb, } from '../createNxtlinqAgent';
+const NxtlinqAgentContext = createContext(null);
+export function NxtlinqAgentProvider({ children, resetOnIdentityChange = true, ...options }) {
+    const agent = useMemo(() => createNxtlinqAgentWeb(options), [
+        options.serviceId,
+        options.apiKey,
+        options.apiSecret,
+        options.environment,
+        options.pseudoId,
+        options.externalId,
+        options.conversationId,
+        options.storage,
+        options.fetchImpl,
+        options.getTimezone,
+        options.webrtc,
+    ]);
+    useEffect(() => {
+        if (!resetOnIdentityChange)
+            return;
+        agent.setMessages([]);
+    }, [agent, resetOnIdentityChange, options.pseudoId, options.externalId, options.conversationId]);
+    useEffect(() => () => agent.destroy(), [agent]);
+    return (_jsx(NxtlinqAgentContext.Provider, { value: agent, children: children }));
+}
+export function useNxtlinqAgentContext() {
+    const agent = useContext(NxtlinqAgentContext);
+    if (!agent) {
+        throw new Error('useNxtlinqAgentContext must be used within <NxtlinqAgentProvider>');
+    }
+    return agent;
+}

package/dist/createNxtlinqAgent.d.ts

@@ -0,0 +1,9 @@
+import { NxtlinqAgent, type AgentConfig } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { type CreateWebPlatformPortsOptions } from './ports/createWebPlatformPorts';
+export type CreateNxtlinqAgentWebOptions = AgentConfig & CreateWebPlatformPortsOptions;
+/**
+ * Create a platform-ready {@link NxtlinqAgent} for React Web custom UIs.
+ * Applies browser defaults (`voiceTransport: webrtc`, `defaultModel`).
+ */
+export declare function createNxtlinqAgentWeb(options: CreateNxtlinqAgentWebOptions): NxtlinqAgent;
+//# sourceMappingURL=createNxtlinqAgent.d.ts.map

package/dist/createNxtlinqAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNxtlinqAgent.d.ts","sourceRoot":"","sources":["../src/createNxtlinqAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAEjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,gCAAgC,CAAC;AAGxC,MAAM,MAAM,4BAA4B,GAAG,WAAW,GAAG,6BAA6B,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,YAAY,CAkBzF"}

package/dist/createNxtlinqAgent.js

@@ -0,0 +1,19 @@
+import { NxtlinqAgent, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { createWebPlatformPorts, } from './ports/createWebPlatformPorts';
+import { applyWebAgentDefaults } from './webAgentDefaults';
+/**
+ * Create a platform-ready {@link NxtlinqAgent} for React Web custom UIs.
+ * Applies browser defaults (`voiceTransport: webrtc`, `defaultModel`).
+ */
+export function createNxtlinqAgentWeb(options) {
+    const { storage, fetchImpl, getTimezone, webrtc, enableWebRTC, ...rawConfig } = options;
+    const config = applyWebAgentDefaults(rawConfig);
+    const ports = createWebPlatformPorts({
+        storage,
+        fetchImpl,
+        getTimezone,
+        webrtc,
+        enableWebRTC,
+    });
+    return new NxtlinqAgent(config, ports);
+}

package/dist/hooks/useNxtlinqAgent.d.ts

@@ -0,0 +1,18 @@
+import type { Message, NxtlinqAgentSnapshot, PostTextTtsResult, SendMessageOptions } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { useNxtlinqAgentContext } from '../context/NxtlinqAgentContext';
+export type UseNxtlinqAgentResult = NxtlinqAgentSnapshot & {
+    agent: ReturnType<typeof useNxtlinqAgentContext>;
+    sendMessage: (text: string, options?: Omit<SendMessageOptions, 'text'>) => Promise<void>;
+    loadHistory: (options?: {
+        last?: number;
+    }) => Promise<void>;
+    syncVoiceTurnHistory: (options?: {
+        last?: number;
+    }) => Promise<void>;
+    setMessages: (messages: Message[]) => void;
+    postTextTts: (text: string) => Promise<PostTextTtsResult>;
+    buildTextTtsPlaybackUri: (result: PostTextTtsResult) => string;
+};
+/** Subscribe to {@link NxtlinqAgent} state for custom Web chat UIs. */
+export declare function useNxtlinqAgent(): UseNxtlinqAgentResult;
+//# sourceMappingURL=useNxtlinqAgent.d.ts.map

package/dist/hooks/useNxtlinqAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNxtlinqAgent.d.ts","sourceRoot":"","sources":["../../src/hooks/useNxtlinqAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACzD,KAAK,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACjD,WAAW,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,KACvC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,oBAAoB,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1D,uBAAuB,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,MAAM,CAAC;CAChE,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,qBAAqB,CAiDvD"}

package/dist/hooks/useNxtlinqAgent.js

@@ -0,0 +1,23 @@
+import { useCallback, useSyncExternalStore } from 'react';
+import { useNxtlinqAgentContext } from '../context/NxtlinqAgentContext';
+/** Subscribe to {@link NxtlinqAgent} state for custom Web chat UIs. */
+export function useNxtlinqAgent() {
+    const agent = useNxtlinqAgentContext();
+    const snapshot = useSyncExternalStore((onStoreChange) => agent.subscribe(onStoreChange), () => agent.getSnapshot(), () => agent.getSnapshot());
+    const sendMessage = useCallback((text, options) => agent.sendMessage(text, options), [agent]);
+    const loadHistory = useCallback((options) => agent.loadHistory(options), [agent]);
+    const syncVoiceTurnHistory = useCallback((options) => agent.syncVoiceTurnHistory(options), [agent]);
+    const setMessages = useCallback((messages) => agent.setMessages(messages), [agent]);
+    const postTextTts = useCallback((text) => agent.postTextTts(text), [agent]);
+    const buildTextTtsPlaybackUri = useCallback((result) => agent.buildTextTtsPlaybackUri(result), [agent]);
+    return {
+        agent,
+        ...snapshot,
+        sendMessage,
+        loadHistory,
+        syncVoiceTurnHistory,
+        setMessages,
+        postTextTts,
+        buildTextTtsPlaybackUri,
+    };
+}

package/dist/hooks/useNxtlinqVoice.d.ts

@@ -0,0 +1,21 @@
+import type { StartVoiceSessionOptions, VoiceGreetingOptions, VoiceSession, VoiceStatus, VoiceUserInputOptions } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export type UseNxtlinqVoiceOptions = Partial<Omit<StartVoiceSessionOptions, 'apiKey' | 'apiSecret' | 'pseudoId'>>;
+export type UseNxtlinqVoiceResult = {
+    voiceStatus: VoiceStatus;
+    voiceSessionId: string | null;
+    isVoiceActive: boolean;
+    startVoice: (options?: UseNxtlinqVoiceOptions) => Promise<VoiceSession>;
+    stopVoice: (reason?: string) => Promise<void>;
+    muteMic: (muted: boolean) => void;
+    interrupt: () => void;
+    getRemoteAudioStream: () => MediaStream | null;
+    getOutputAudioLevel: () => number;
+    sendVoiceUserInput: (options: VoiceUserInputOptions) => void;
+    triggerVoiceGreeting: (options: VoiceGreetingOptions, greetOptions?: {
+        waitForChannel?: boolean;
+        timeoutMs?: number;
+    }) => Promise<void>;
+};
+/** Voice controls for custom Web UIs (browser WebRTC). */
+export declare function useNxtlinqVoice(): UseNxtlinqVoiceResult;
+//# sourceMappingURL=useNxtlinqVoice.d.ts.map

package/dist/hooks/useNxtlinqVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNxtlinqVoice.d.ts","sourceRoot":"","sources":["../../src/hooks/useNxtlinqVoice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,qBAAqB,EACtB,MAAM,8CAA8C,CAAC;AAKtD,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC,CACpE,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACxE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,oBAAoB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC/C,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,kBAAkB,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7D,oBAAoB,EAAE,CACpB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,eAAe,IAAI,qBAAqB,CA6GvD"}

package/dist/hooks/useNxtlinqVoice.js

@@ -0,0 +1,75 @@
+import { VoiceNotSupportedError } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';
+import { useNxtlinqAgentContext } from '../context/NxtlinqAgentContext';
+/** Voice controls for custom Web UIs (browser WebRTC). */
+export function useNxtlinqVoice() {
+    const agent = useNxtlinqAgentContext();
+    const sessionRef = useRef(null);
+    const snapshot = useSyncExternalStore((onStoreChange) => agent.subscribe(onStoreChange), () => agent.getSnapshot(), () => agent.getSnapshot());
+    const refreshSessionRef = useCallback(() => {
+        sessionRef.current = agent.getVoiceSession();
+    }, [agent]);
+    const startVoice = useCallback(async (options) => {
+        try {
+            const session = await agent.startVoice(options);
+            sessionRef.current = session;
+            return session;
+        }
+        catch (err) {
+            if (err instanceof VoiceNotSupportedError) {
+                throw new Error('Voice is not available — check NxtlinqAgentProvider config and pseudoId.');
+            }
+            throw err;
+        }
+    }, [agent]);
+    const stopVoice = useCallback(async (reason) => {
+        await agent.stopVoice(reason);
+        sessionRef.current = null;
+    }, [agent]);
+    const muteMic = useCallback((muted) => {
+        refreshSessionRef();
+        sessionRef.current?.muteMic(muted);
+    }, [refreshSessionRef]);
+    const interrupt = useCallback(() => {
+        refreshSessionRef();
+        sessionRef.current?.interrupt();
+    }, [refreshSessionRef]);
+    const getRemoteAudioStream = useCallback(() => agent.getVoiceSession()?.getRemoteAudioStream() ?? null, [agent]);
+    const getOutputAudioLevel = useCallback(() => {
+        refreshSessionRef();
+        return sessionRef.current?.getOutputAudioLevel() ?? agent.getOutputAudioLevel();
+    }, [refreshSessionRef, agent]);
+    const sendVoiceUserInput = useCallback((options) => {
+        refreshSessionRef();
+        if (sessionRef.current) {
+            sessionRef.current.sendVoiceUserInput(options);
+            return;
+        }
+        agent.sendVoiceUserInput(options);
+    }, [refreshSessionRef, agent]);
+    const triggerVoiceGreeting = useCallback((options, greetOptions) => agent.triggerVoiceGreeting(options, greetOptions), [agent]);
+    return useMemo(() => ({
+        voiceStatus: snapshot.voiceStatus,
+        voiceSessionId: snapshot.voiceSessionId,
+        isVoiceActive: snapshot.voiceSessionId != null,
+        startVoice,
+        stopVoice,
+        muteMic,
+        interrupt,
+        getRemoteAudioStream,
+        getOutputAudioLevel,
+        sendVoiceUserInput,
+        triggerVoiceGreeting,
+    }), [
+        snapshot.voiceStatus,
+        snapshot.voiceSessionId,
+        startVoice,
+        stopVoice,
+        muteMic,
+        interrupt,
+        getRemoteAudioStream,
+        getOutputAudioLevel,
+        sendVoiceUserInput,
+        triggerVoiceGreeting,
+    ]);
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createNxtlinqAgentWeb, type CreateNxtlinqAgentWebOptions, } from './createNxtlinqAgent';
+export { NxtlinqAgentProvider, useNxtlinqAgentContext, type NxtlinqAgentProviderProps, type AgentConfig, } from './context/NxtlinqAgentContext';
+export { useNxtlinqAgent, type UseNxtlinqAgentResult } from './hooks/useNxtlinqAgent';
+export { useNxtlinqVoice, type UseNxtlinqVoiceResult, type UseNxtlinqVoiceOptions, } from './hooks/useNxtlinqVoice';
+export { createWebPlatformPorts, type CreateWebPlatformPortsOptions, } from './ports/createWebPlatformPorts';
+export { WEB_AGENT_DEFAULTS, applyWebAgentDefaults } from './webAgentDefaults';
+export { fileToAttachment } from './utils/fileToAttachment';
+export type { Message, Attachment, AgentResponse, SendMessageOptions, NxtlinqAgentSnapshot, ToolUse, StartVoiceSessionOptions, VoiceSession, VoiceStatus, VoiceTranscriptEvent, VoiceDoneEvent, VoiceUserInputOptions, VoiceGreetingOptions, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export { NxtlinqAgent, setApiHosts, createBrowserWebRTCPort, createBrowserStoragePort, createDefaultHttpPort, VoiceNotSupportedError, mapServerHistoryToMessages, appendServerHistoryIntoMessages, STORAGE_KEYS, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export { createNxtlinqApi, getAiAgentApiHost, startVoiceSession, createVoiceApi, useDraggable, useLocalStorage, useSessionStorage, useResizable, synthesizeSpeechToBuffer, useSpeechToTextFromMic, useVoiceMode, metakeepClient, getEthers, sleep, walletTextUtils, connectWallet, disconnectWallet, validateToken, createAITMetadata, generateAITId, prepareAITCreation, createNotification, getNotificationIcon, containsUrls, convertUrlsToLinks, convertUrlsToHtml, } from './legacy';
+export type { ResizeCorner } from './legacy';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,YAAY,EACV,OAAO,EACP,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,EACP,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,KAAK,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { createNxtlinqAgentWeb, } from './createNxtlinqAgent';
+export { NxtlinqAgentProvider, useNxtlinqAgentContext, } from './context/NxtlinqAgentContext';
+export { useNxtlinqAgent } from './hooks/useNxtlinqAgent';
+export { useNxtlinqVoice, } from './hooks/useNxtlinqVoice';
+export { createWebPlatformPorts, } from './ports/createWebPlatformPorts';
+export { WEB_AGENT_DEFAULTS, applyWebAgentDefaults } from './webAgentDefaults';
+export { fileToAttachment } from './utils/fileToAttachment';
+export { NxtlinqAgent, setApiHosts, createBrowserWebRTCPort, createBrowserStoragePort, createDefaultHttpPort, VoiceNotSupportedError, mapServerHistoryToMessages, appendServerHistoryIntoMessages, STORAGE_KEYS, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export { createNxtlinqApi, getAiAgentApiHost, startVoiceSession, createVoiceApi, useDraggable, useLocalStorage, useSessionStorage, useResizable, synthesizeSpeechToBuffer, useSpeechToTextFromMic, useVoiceMode, metakeepClient, getEthers, sleep, walletTextUtils, connectWallet, disconnectWallet, validateToken, createAITMetadata, generateAITId, prepareAITCreation, createNotification, getNotificationIcon, containsUrls, convertUrlsToLinks, convertUrlsToHtml, } from './legacy';

package/dist/legacy/api/nxtlinq-api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Web SDK wrapper: default browser storage + voice API from browser module.
+ */
+import type { AITApi } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export { setApiHosts, getAiAgentApiHost, createNxtlinqApiWithDeps, createBrowserStoragePort, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export type { CoreAITApi, ApiClientDeps } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export declare const createNxtlinqApi: (apiKey: string, apiSecret: string) => AITApi;
+//# sourceMappingURL=nxtlinq-api.d.ts.map

package/dist/legacy/api/nxtlinq-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nxtlinq-api.d.ts","sourceRoot":"","sources":["../../../src/legacy/api/nxtlinq-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAU3E,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC;AAEtD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAE9F,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,MASpE,CAAC"}

package/dist/legacy/api/nxtlinq-api.js

@@ -0,0 +1,13 @@
+import { createBrowserStoragePort, createDefaultHttpPort, createNxtlinqApiWithDeps, getAiAgentApiHost, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import { createVoiceApi } from './voice';
+export { setApiHosts, getAiAgentApiHost, createNxtlinqApiWithDeps, createBrowserStoragePort, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export const createNxtlinqApi = (apiKey, apiSecret) => {
+    const core = createNxtlinqApiWithDeps(apiKey, apiSecret, {
+        storage: createBrowserStoragePort(),
+        http: createDefaultHttpPort(),
+    });
+    return {
+        ...core,
+        voice: createVoiceApi(() => getAiAgentApiHost()),
+    };
+};

package/dist/legacy/api/voice.d.ts

@@ -0,0 +1,11 @@
+export { normalizeTranscriptKey, mergeStreamingTranscript, appendTranscriptSegment, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export type { VoicePhase, VoiceStatus, VoicePhaseExtra, VoiceTranscriptEvent, VoiceToolCallEvent, VoiceToolResultEvent, VoicePermissionRequiredEvent, VoiceBillingBlockedEvent, VoiceTtsWordEvent, VoiceDoneEvent, StartVoiceSessionOptions, VoiceSession, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import type { StartVoiceSessionOptions, VoiceSession } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/**
+ * Start a cascade voice agent session. Browser-only (uses {@link createBrowserWebRTCPort}).
+ */
+export declare function startVoiceSession(apiAgentHost: string, options: StartVoiceSessionOptions): Promise<VoiceSession>;
+export declare const createVoiceApi: (apiAgentHost: string | (() => string)) => {
+    startSession: (options: StartVoiceSessionOptions) => Promise<VoiceSession>;
+};
+//# sourceMappingURL=voice.d.ts.map

package/dist/legacy/api/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../src/legacy/api/voice.ts"],"names":[],"mappings":"AASA,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AAEtD,YAAY,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE3G;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAED,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC;4BAC1C,wBAAwB,KAAG,OAAO,CAAC,YAAY,CAAC;CAKxE,CAAC"}

package/dist/legacy/api/voice.js

@@ -0,0 +1,26 @@
+/**
+ * Web voice client — thin wrapper over core {@link startVoiceSessionWithPort}.
+ */
+import { createBrowserWebRTCPort, startVoiceSessionWithPort, startWsRealtimeSession, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export { normalizeTranscriptKey, mergeStreamingTranscript, appendTranscriptSegment, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/**
+ * Start a cascade voice agent session. Browser-only (uses {@link createBrowserWebRTCPort}).
+ */
+export async function startVoiceSession(apiAgentHost, options) {
+    const baseUrl = (options.baseUrl ?? apiAgentHost ?? '').replace(/\/+$/, '');
+    if (!baseUrl) {
+        throw new Error('startVoiceSession: API host is empty. Did you forget to call setApiHosts() before createNxtlinqApi()?');
+    }
+    const transport = options.transport ?? 'ws-realtime';
+    if (transport === 'ws-realtime') {
+        return startWsRealtimeSession({ baseUrl, fetchFn: fetch }, { ...options, baseUrl, transport });
+    }
+    return startVoiceSessionWithPort({
+        baseUrl,
+        webrtc: createBrowserWebRTCPort(),
+        fetchFn: fetch,
+    }, { ...options, baseUrl });
+}
+export const createVoiceApi = (apiAgentHost) => ({
+    startSession: (options) => startVoiceSession(typeof apiAgentHost === 'function' ? apiAgentHost() : apiAgentHost, options),
+});

package/dist/legacy/core/lib/messageHistory.d.ts

@@ -0,0 +1,2 @@
+export { appendServerHistoryIntoMessages, isVoicePlaceholderMessage, mapServerHistoryToMessages, type ServerHistoryMessage, } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+//# sourceMappingURL=messageHistory.d.ts.map

package/dist/legacy/core/lib/messageHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageHistory.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/lib/messageHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,8CAA8C,CAAC"}

package/dist/legacy/core/lib/messageHistory.js

@@ -0,0 +1 @@
+export { appendServerHistoryIntoMessages, isVoicePlaceholderMessage, mapServerHistoryToMessages, } from '@bytexbyte/nxtlinq-ai-agent-core-development';

package/dist/legacy/core/lib/textToSpeech.d.ts

@@ -0,0 +1,14 @@
+import type { ClientTtsVoiceSettings } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/**
+ * TTS for chat playback: Azure (browser Speech SDK + token from Agent) or OpenAI (audio via Agent proxy).
+ */
+export declare function synthesizeSpeechToBuffer(params: {
+    text: string;
+    apiKey: string;
+    apiSecret: string;
+    settings?: ClientTtsVoiceSettings;
+}): Promise<{
+    buffer: ArrayBuffer;
+    mimeType: string;
+} | undefined>;
+//# sourceMappingURL=textToSpeech.d.ts.map

package/dist/legacy/core/lib/textToSpeech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textToSpeech.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/lib/textToSpeech.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AA8E3F;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAsCjE"}

package/dist/legacy/core/lib/textToSpeech.js

@@ -0,0 +1,82 @@
+import { SpeechConfig, SpeechSynthesizer } from 'microsoft-cognitiveservices-speech-sdk';
+import { getAiAgentApiHost } from '../../api/nxtlinq-api';
+const DEFAULT_AZURE_VOICE = 'en-US-JennyNeural';
+async function fetchAzureTokenFromAgent(agentHost, apiKey, apiSecret) {
+    try {
+        const res = await fetch(`${agentHost}/api/cognitive/token`, {
+            method: 'GET',
+            headers: {
+                'X-API-Key': apiKey,
+                'X-API-Secret': apiSecret,
+            },
+        });
+        const data = (await res.json());
+        if (!res.ok || !data.token || !data.region) {
+            return { error: data.error || 'Failed to get speech token' };
+        }
+        return { token: data.token, region: data.region };
+    }
+    catch (e) {
+        return { error: e instanceof Error ? e.message : 'Network error' };
+    }
+}
+async function synthesizeAzureToBuffer(text, authToken, region, voiceName) {
+    const speechConfig = SpeechConfig.fromAuthorizationToken(authToken, region);
+    speechConfig.speechSynthesisVoiceName =
+        voiceName?.trim() ? voiceName.trim() : DEFAULT_AZURE_VOICE;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore — SDK typing allows null audio config
+    const synthesizer = new SpeechSynthesizer(speechConfig, null);
+    const res = await new Promise((resolve) => {
+        synthesizer.speakTextAsync(text, (result) => {
+            resolve(result);
+        }, (err) => resolve(err));
+    });
+    synthesizer.close();
+    if (typeof res === 'string') {
+        console.error('Text-to-speech error:', res);
+        return undefined;
+    }
+    return res.audioData;
+}
+async function synthesizeOpenAiToBuffer(agentHost, apiKey, apiSecret, text) {
+    const res = await fetch(`${agentHost}/api/tts/openai`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ apiKey, apiSecret, text }),
+    });
+    if (!res.ok) {
+        return undefined;
+    }
+    return res.arrayBuffer();
+}
+/**
+ * TTS for chat playback: Azure (browser Speech SDK + token from Agent) or OpenAI (audio via Agent proxy).
+ */
+export async function synthesizeSpeechToBuffer(params) {
+    const agentHost = getAiAgentApiHost();
+    if (!agentHost) {
+        console.error('AI Agent API host is not set (call setApiHosts first)');
+        return undefined;
+    }
+    const provider = params.settings?.provider ?? 'azure';
+    const resolvedVoice = params.settings?.resolvedVoice?.trim();
+    if (provider === 'openai' && resolvedVoice) {
+        const buffer = await synthesizeOpenAiToBuffer(agentHost, params.apiKey, params.apiSecret, params.text);
+        if (!buffer) {
+            console.warn('OpenAI TTS failed, falling back to Azure');
+        }
+        else {
+            return { buffer, mimeType: 'audio/mpeg' };
+        }
+    }
+    const tok = await fetchAzureTokenFromAgent(agentHost, params.apiKey, params.apiSecret);
+    if ('error' in tok) {
+        console.error('Azure speech token:', tok.error);
+        return undefined;
+    }
+    const buffer = await synthesizeAzureToBuffer(params.text, tok.token, tok.region, provider === 'azure' ? resolvedVoice : undefined);
+    if (!buffer)
+        return undefined;
+    return { buffer, mimeType: 'audio/wav' };
+}

package/dist/legacy/core/lib/useDraggable.d.ts

@@ -0,0 +1,15 @@
+interface Position {
+    x: number;
+    y: number;
+}
+export declare const useDraggable: (dimensions: {
+    width: number;
+    height: number;
+}) => {
+    position: Position;
+    handleDragStart: (event: React.PointerEvent<HTMLDivElement>) => void;
+    isDragging: boolean;
+    updatePosition: (newPosition: Position) => void;
+};
+export {};
+//# sourceMappingURL=useDraggable.d.ts.map

package/dist/legacy/core/lib/useDraggable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraggable.d.ts","sourceRoot":"","sources":["../../../../src/legacy/core/lib/useDraggable.ts"],"names":[],"mappings":"AAGA,UAAU,QAAQ;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAKD,eAAO,MAAM,YAAY,GAAI,YAAY;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;6BAuFxC,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC;;kCA8EjB,QAAQ;CAgB1D,CAAC"}

package/dist/legacy/core/lib/useDraggable.js

@@ -0,0 +1,158 @@
+import { useState, useRef, useCallback, useEffect } from 'react';
+import useLocalStorage from './useLocalStorage';
+const DEFAULT_POSITION = { x: 0, y: 0 }; // Default position, will be calculated
+const VIEWPORT_MARGIN = 20; // Keep space from viewport edges
+export const useDraggable = (dimensions) => {
+    const dragState = useRef({
+        startX: 0,
+        startY: 0,
+        startPosition: DEFAULT_POSITION
+    });
+    // Keep track of current position for saving
+    const currentPositionRef = useRef(DEFAULT_POSITION);
+    // Track if we've already loaded from localStorage to prevent loops
+    const hasLoadedFromStorage = useRef(false);
+    // Clamp position to keep window within viewport
+    const clampPosition = useCallback((pos, dims) => {
+        if (typeof window === 'undefined') {
+            return pos;
+        }
+        const maxX = Math.max(VIEWPORT_MARGIN, window.innerWidth - dims.width - VIEWPORT_MARGIN);
+        const maxY = Math.max(VIEWPORT_MARGIN, window.innerHeight - dims.height - VIEWPORT_MARGIN);
+        return {
+            x: Math.max(VIEWPORT_MARGIN, Math.min(pos.x, maxX)),
+            y: Math.max(VIEWPORT_MARGIN, Math.min(pos.y, maxY))
+        };
+    }, []);
+    // Calculate initial position from bottom/right (default behavior)
+    const calculateInitialPosition = useCallback(() => {
+        if (typeof window === 'undefined') {
+            return DEFAULT_POSITION;
+        }
+        // Default position: bottom-right corner with margin
+        const initialPos = {
+            x: window.innerWidth - dimensions.width - VIEWPORT_MARGIN,
+            y: window.innerHeight - dimensions.height - VIEWPORT_MARGIN
+        };
+        return clampPosition(initialPos, dimensions);
+    }, [dimensions.width, dimensions.height, clampPosition]);
+    // Load position from localStorage or use default
+    const [savedPosition, setSavedPosition, isPositionInitialized] = useLocalStorage('chat-window-position', null);
+    const [position, setPosition] = useState(() => {
+        // Always start with calculated initial position
+        // Will be updated when savedPosition loads from localStorage
+        const initialPos = calculateInitialPosition();
+        currentPositionRef.current = initialPos;
+        return initialPos;
+    });
+    // Update position when saved position loads from localStorage (only once)
+    useEffect(() => {
+        if (isPositionInitialized && !hasLoadedFromStorage.current) {
+            if (savedPosition) {
+                // Use saved position
+                const clampedPos = clampPosition(savedPosition, dimensions);
+                currentPositionRef.current = clampedPos;
+                setPosition(clampedPos);
+            }
+            // Mark as loaded regardless of whether we have saved position
+            hasLoadedFromStorage.current = true;
+        }
+    }, [isPositionInitialized, savedPosition, dimensions, clampPosition]);
+    // Update position when dimensions change (to keep window in viewport, but only after initial load)
+    useEffect(() => {
+        if (!isPositionInitialized || !hasLoadedFromStorage.current)
+            return;
+        setPosition((current) => {
+            const clampedPosition = clampPosition(current, dimensions);
+            if (clampedPosition.x !== current.x || clampedPosition.y !== current.y) {
+                currentPositionRef.current = clampedPosition;
+                return clampedPosition;
+            }
+            return current;
+        });
+    }, [dimensions.width, dimensions.height, isPositionInitialized, clampPosition]);
+    const [isDragging, setIsDragging] = useState(false);
+    const handleDragStart = (event) => {
+        // Don't start dragging if clicking on buttons or interactive elements
+        const target = event.target;
+        if (target.tagName === 'BUTTON' ||
+            target.closest('button') ||
+            target.closest('[role="button"]') ||
+            target.closest('input') ||
+            target.closest('select') ||
+            target.closest('textarea')) {
+            return;
+        }
+        event.preventDefault();
+        event.stopPropagation();
+        dragState.current = {
+            startX: event.clientX,
+            startY: event.clientY,
+            startPosition: position
+        };
+        setIsDragging(true);
+        document.body.style.userSelect = 'none';
+        document.body.style.cursor = 'grabbing';
+    };
+    // Handle pointer move and up events
+    useEffect(() => {
+        if (!isDragging) {
+            return;
+        }
+        const handlePointerMove = (event) => {
+            const deltaX = event.clientX - dragState.current.startX;
+            const deltaY = event.clientY - dragState.current.startY;
+            const newPosition = {
+                x: dragState.current.startPosition.x + deltaX,
+                y: dragState.current.startPosition.y + deltaY
+            };
+            const clampedPos = clampPosition(newPosition, dimensions);
+            currentPositionRef.current = clampedPos;
+            setPosition(clampedPos);
+        };
+        const handlePointerUp = () => {
+            setIsDragging(false);
+            document.body.style.userSelect = '';
+            document.body.style.cursor = '';
+            // Save position to localStorage (only after initial load)
+            if (hasLoadedFromStorage.current) {
+                setSavedPosition(currentPositionRef.current);
+            }
+        };
+        document.addEventListener('pointermove', handlePointerMove);
+        document.addEventListener('pointerup', handlePointerUp);
+        return () => {
+            document.removeEventListener('pointermove', handlePointerMove);
+            document.removeEventListener('pointerup', handlePointerUp);
+            document.body.style.userSelect = '';
+            document.body.style.cursor = '';
+        };
+    }, [isDragging, clampPosition, dimensions, setSavedPosition]);
+    // Handle window resize to keep window in viewport
+    useEffect(() => {
+        const handleResize = () => {
+            setPosition((current) => {
+                const clamped = clampPosition(current, dimensions);
+                currentPositionRef.current = clamped;
+                return clamped;
+            });
+        };
+        window.addEventListener('resize', handleResize);
+        return () => window.removeEventListener('resize', handleResize);
+    }, [clampPosition, dimensions]);
+    const updatePosition = useCallback((newPosition) => {
+        const clamped = clampPosition(newPosition, dimensions);
+        currentPositionRef.current = clamped;
+        setPosition(clamped);
+        // Save position to localStorage when updated (only after initial load)
+        if (hasLoadedFromStorage.current) {
+            setSavedPosition(clamped);
+        }
+    }, [clampPosition, dimensions, setSavedPosition]);
+    return {
+        position,
+        handleDragStart,
+        isDragging,
+        updatePosition
+    };
+};