@bytexbyte/nxtlinq-ai-agent-ui-react-development 0.4.0 → 0.4.2

package/dist/context/AgentAssistantContext.d.ts

@@ -1,32 +0,0 @@
-import type { VoiceStatus } from '@bytexbyte/nxtlinq-ai-agent-core-development';
-import { type UseNxtlinqAgentResult, type UseNxtlinqVoiceResult } from '@bytexbyte/nxtlinq-ai-agent-web-development';
-import React, { type ReactNode } from 'react';
-import type { AgentAssistantTheme, NxtlinqAgentChatProps, PresetMessage } from '../types';
-export type InteractionMode = 'text' | 'voice';
-export type AgentAssistantContextValue = UseNxtlinqAgentResult & UseNxtlinqVoiceResult & {
-    theme: AgentAssistantTheme;
-    title: string;
-    placeholder: string;
-    presetMessages: PresetMessage[];
-    interactionMode: InteractionMode;
-    setInteractionMode: (mode: InteractionMode) => void;
-    inputText: string;
-    setInputText: (text: string) => void;
-    isVoiceAvailable: boolean;
-    isVoiceConnecting: boolean;
-    isMicMuted: boolean;
-    isMicHeldForAssistant: boolean;
-    toggleVoiceMicMute: () => void;
-    isVoiceChannelReady: boolean;
-    enableFileUpload: boolean;
-    sendText: () => Promise<void>;
-    selectPreset: (preset: PresetMessage) => Promise<void>;
-};
-export type AgentAssistantProviderProps = {
-    children: ReactNode;
-    ui: Pick<NxtlinqAgentChatProps, 'title' | 'placeholder' | 'presetMessages' | 'enableVoice' | 'enableFileUpload' | 'theme' | 'startWithMicMuted' | 'holdMicDuringAssistant'>;
-};
-export declare function AgentAssistantProvider({ children, ui, }: AgentAssistantProviderProps): React.ReactElement;
-export declare function useAgentAssistant(): AgentAssistantContextValue;
-export declare function voiceStatusLabel(status: VoiceStatus): string;
-//# sourceMappingURL=AgentAssistantContext.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AgentAssistantContext.d.ts","sourceRoot":"","sources":["../../src/context/AgentAssistantContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAK1F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/C,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,GAC5D,qBAAqB,GAAG;IACxB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD,CAAC;AAIF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,EAAE,EAAE,IAAI,CACN,qBAAqB,EACnB,OAAO,GACP,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,kBAAkB,GAClB,OAAO,GACP,mBAAmB,GACnB,wBAAwB,CAC3B,CAAC;CACH,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,EAAE,GACH,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,CA8MlD;AAED,wBAAgB,iBAAiB,IAAI,0BAA0B,CAQ9D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAU5D"}

package/dist/context/AgentAssistantContext.js

@@ -1,179 +0,0 @@
-import { jsx as _jsx } from "@emotion/react/jsx-runtime";
-import { useNxtlinqAgent, useNxtlinqVoice, } from '@bytexbyte/nxtlinq-ai-agent-web-development';
-import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
-import { defaultAgentAssistantTheme } from '../theme/defaultTheme';
-import { useVoiceConnectOrchestration } from '../voice/useVoiceConnectOrchestration';
-import { useVoiceMicState } from '../voice/useVoiceMicState';
-import { useVoiceTranscriptMessages } from '../voice/useVoiceTranscriptMessages';
-const AgentAssistantContext = createContext(null);
-export function AgentAssistantProvider({ children, ui, }) {
-    const agent = useNxtlinqAgent();
-    const voice = useNxtlinqVoice();
-    const [interactionMode, setInteractionModeState] = useState('text');
-    const [inputText, setInputText] = useState('');
-    const [isVoiceConnecting, setIsVoiceConnecting] = useState(false);
-    const isVoiceAvailable = ui.enableVoice !== false;
-    const micStartsMuted = ui.startWithMicMuted ?? true;
-    const handleVoiceBargeIn = useCallback(() => {
-        voice.interrupt();
-    }, [voice]);
-    const { isMicMuted, isMicHeldForAssistant, toggleVoiceMicMute, prepareForVoiceConnect, resetMicState, clearAssistantMicHold, } = useVoiceMicState(voice, isVoiceConnecting, {
-        startWithMicMuted: micStartsMuted,
-        holdMicDuringAssistant: ui.holdMicDuringAssistant ?? true,
-        onBargeIn: handleVoiceBargeIn,
-    });
-    const voiceTranscriptApi = useMemo(() => ({
-        getMessages: () => agent.agent.getSnapshot().messages,
-        updateMessages: (updater) => {
-            agent.setMessages(updater(agent.agent.getSnapshot().messages));
-        },
-        syncVoiceTurnHistory: agent.syncVoiceTurnHistory,
-    }), [agent.agent, agent.setMessages, agent.syncVoiceTurnHistory]);
-    const { handleTranscript, handleDone, clearVoiceStream } = useVoiceTranscriptMessages(voiceTranscriptApi, interactionMode, voice.voiceSessionId);
-    const setInteractionMode = useCallback((mode) => {
-        if (mode === 'text' && interactionMode === 'voice') {
-            void voice.stopVoice('switch_to_text').then(() => {
-                clearVoiceStream();
-                resetMicState();
-            });
-        }
-        setInteractionModeState(mode);
-    }, [interactionMode, voice, resetMicState, clearVoiceStream]);
-    useEffect(() => {
-        if (interactionMode === 'text' && voice.voiceSessionId != null) {
-            void voice.stopVoice('mode_text_cleanup').then(() => {
-                clearVoiceStream();
-                resetMicState();
-            });
-        }
-    }, [interactionMode, voice.voiceSessionId, voice, resetMicState, clearVoiceStream]);
-    const orchestrationCallbacks = useMemo(() => ({
-        handleTranscript,
-        handleDone,
-        clearVoiceStream,
-        prepareForVoiceConnect,
-        resetMicState,
-        clearAssistantMicHold,
-        setInteractionMode,
-        setIsVoiceConnecting,
-    }), [
-        handleTranscript,
-        handleDone,
-        clearVoiceStream,
-        prepareForVoiceConnect,
-        resetMicState,
-        clearAssistantMicHold,
-        setInteractionMode,
-    ]);
-    const { wrappedStartVoice, wrappedStopVoice, wrappedInterrupt, isVoiceChannelReady, } = useVoiceConnectOrchestration(agent, voice, interactionMode, micStartsMuted, orchestrationCallbacks);
-    // iOS 切換 App 或相機後返回時，若 WebRTC App Channel 已斷開則自動停止語音 session，
-    // 避免麥克風圖示顯示活躍但狀態卡在 Idle 的問題。
-    useEffect(() => {
-        if (typeof document === 'undefined')
-            return;
-        const handleVisibilityChange = () => {
-            if (document.visibilityState !== 'visible')
-                return;
-            if (voice.voiceSessionId == null)
-                return;
-            const session = agent.agent.getVoiceSession();
-            if (!session?.isAppChannelOpen()) {
-                void wrappedStopVoice();
-            }
-        };
-        document.addEventListener('visibilitychange', handleVisibilityChange);
-        return () => document.removeEventListener('visibilitychange', handleVisibilityChange);
-    }, [voice.voiceSessionId, agent.agent, wrappedStopVoice]);
-    const theme = useMemo(() => ({
-        ...defaultAgentAssistantTheme,
-        ...ui.theme,
-        colors: { ...defaultAgentAssistantTheme.colors, ...ui.theme?.colors },
-        spacing: { ...defaultAgentAssistantTheme.spacing, ...ui.theme?.spacing },
-        radius: { ...defaultAgentAssistantTheme.radius, ...ui.theme?.radius },
-        typography: {
-            ...defaultAgentAssistantTheme.typography,
-            ...ui.theme?.typography,
-        },
-    }), [ui.theme]);
-    const sendText = useCallback(async () => {
-        const text = inputText.trim();
-        if (!text || agent.isLoading)
-            return;
-        setInputText('');
-        await agent.sendMessage(text);
-    }, [agent, inputText]);
-    const selectPreset = useCallback(async (preset) => {
-        if (preset.autoSend) {
-            await agent.sendMessage(preset.text);
-        }
-        else {
-            setInputText(preset.text);
-        }
-    }, [agent]);
-    const value = useMemo(() => ({
-        ...agent,
-        ...voice,
-        startVoice: wrappedStartVoice,
-        stopVoice: wrappedStopVoice,
-        interrupt: wrappedInterrupt,
-        theme,
-        title: ui.title ?? 'AI Assistant',
-        placeholder: ui.placeholder ?? 'Type a message…',
-        presetMessages: ui.presetMessages ?? [],
-        interactionMode,
-        setInteractionMode,
-        inputText,
-        setInputText,
-        isVoiceAvailable,
-        isVoiceConnecting,
-        isMicMuted,
-        isMicHeldForAssistant,
-        toggleVoiceMicMute,
-        isVoiceChannelReady,
-        enableFileUpload: ui.enableFileUpload !== false,
-        sendText,
-        selectPreset,
-    }), [
-        agent,
-        voice,
-        wrappedStartVoice,
-        wrappedStopVoice,
-        wrappedInterrupt,
-        theme,
-        ui.title,
-        ui.placeholder,
-        ui.presetMessages,
-        ui.enableFileUpload,
-        interactionMode,
-        setInteractionMode,
-        inputText,
-        isVoiceAvailable,
-        isVoiceConnecting,
-        isMicMuted,
-        isMicHeldForAssistant,
-        toggleVoiceMicMute,
-        isVoiceChannelReady,
-        sendText,
-        selectPreset,
-        voice.voiceStatus,
-    ]);
-    return (_jsx(AgentAssistantContext.Provider, { value: value, children: children }));
-}
-export function useAgentAssistant() {
-    const ctx = useContext(AgentAssistantContext);
-    if (!ctx) {
-        throw new Error('useAgentAssistant must be used within <NxtlinqAgentChat> or <AgentAssistantProvider>');
-    }
-    return ctx;
-}
-export function voiceStatusLabel(status) {
-    const labels = {
-        idle: 'Ready',
-        listening: 'Listening',
-        transcribing: 'Transcribing',
-        thinking: 'Thinking',
-        generating: 'Generating',
-        speaking: 'Speaking',
-    };
-    return labels[status] ?? status;
-}