@bytexbyte/nxtlinq-ai-agent-ui-react-native-development 0.2.0

package/dist/theme/defaultTheme.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAssistantTheme } from '../types';
+export declare const defaultAgentAssistantTheme: AgentAssistantTheme;
+//# sourceMappingURL=defaultTheme.d.ts.map

package/dist/theme/defaultTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultTheme.d.ts","sourceRoot":"","sources":["../../src/theme/defaultTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,0BAA0B,EAAE,mBAgCxC,CAAC"}

package/dist/theme/defaultTheme.js

@@ -0,0 +1,33 @@
+export const defaultAgentAssistantTheme = {
+    colors: {
+        background: '#ffffff',
+        surface: '#f8fafc',
+        border: '#e2e8f0',
+        primary: '#2563eb',
+        primaryText: '#ffffff',
+        userBubble: '#2563eb',
+        userText: '#ffffff',
+        assistantBubble: '#f1f5f9',
+        assistantText: '#0f172a',
+        mutedText: '#64748b',
+        error: '#dc2626',
+        voiceActive: '#22c55e',
+        voiceSpeaking: '#ec4899',
+    },
+    spacing: {
+        xs: 4,
+        sm: 8,
+        md: 12,
+        lg: 16,
+    },
+    radius: {
+        bubble: 16,
+        panel: 12,
+        button: 8,
+    },
+    typography: {
+        titleSize: 17,
+        bodySize: 15,
+        captionSize: 12,
+    },
+};

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import type { Message, ToolUse as CoreToolUse } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import type { NxtlinqAgentProviderProps } from '@bytexbyte/nxtlinq-ai-agent-react-native-development';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { VoiceAutoGreetConfig } from './voice/useVoiceAutoGreet';
+export type PresetMessage = {
+    text: string;
+    autoSend?: boolean;
+};
+export type AgentAssistantTheme = {
+    colors: {
+        background: string;
+        surface: string;
+        border: string;
+        primary: string;
+        primaryText: string;
+        userBubble: string;
+        userText: string;
+        assistantBubble: string;
+        assistantText: string;
+        mutedText: string;
+        error: string;
+        voiceActive: string;
+        voiceSpeaking: string;
+    };
+    spacing: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+    };
+    radius: {
+        bubble: number;
+        panel: number;
+        button: number;
+    };
+    typography: {
+        titleSize: number;
+        bodySize: number;
+        captionSize: number;
+    };
+};
+export type NxtlinqAgentAssistantProps = Omit<NxtlinqAgentProviderProps, 'children'> & {
+    children?: NxtlinqAgentProviderProps['children'];
+    /** Panel title in the header. */
+    title?: string;
+    placeholder?: string;
+    presetMessages?: PresetMessage[];
+    /** Fetch history on mount when `pseudoId` is set. */
+    loadHistoryOnMount?: boolean;
+    /** Max messages to prefetch (default 50). */
+    historyLast?: number;
+    /** Show voice mode controls (requires `webrtcModule`). */
+    enableVoice?: boolean;
+    /** Start in voice interaction mode. */
+    startInVoiceMode?: boolean;
+    /**
+     * Mute mic when voice connects (Berify hold-to-talk). Set false for open-mic demos.
+     * @default true
+     */
+    startWithMicMuted?: boolean;
+    /**
+     * Mute mic while assistant is transcribing/speaking (echo guard).
+     * Independent of `startWithMicMuted`; defaults true.
+     */
+    holdMicDuringAssistant?: boolean;
+    /** Show output RMS waveform while in voice mode (P0 / SDK-1). */
+    showVoiceWaveform?: boolean;
+    /** Show voice image URL input for P0 testing (SDK-2). */
+    showVoiceImageInput?: boolean;
+    /** Demo product image URL for greet + quick send. */
+    voiceDemoProductImageUrl?: string;
+    /** Auto-greet on first voice connect when no user history (SDK-3). */
+    voiceAutoGreet?: VoiceAutoGreetConfig | boolean;
+    /**
+     * iOS: bundled silent MP3 (`require('./assets/silent.mp3')`) to wake AVAudioSession.
+     * Strongly recommended — without it WebRTC/TTS may be silent on cold start.
+     */
+    iosSilentAudioSource?: number | {
+        uri: string;
+    };
+    /**
+     * Voice-mode assistant playback gain (WebRTC `_setVolume`, 0–10). Default 5 to
+     * match text TTS loudness (react-native-video volume 1). Default 10.
+     */
+    voiceRemoteAudioGain?: number;
+    /** Text-mode TTS volume (react-native-video, 0–1). @default 1 */
+    textTtsVolume?: number;
+    theme?: Partial<AgentAssistantTheme>;
+    style?: StyleProp<ViewStyle>;
+    headerStyle?: StyleProp<ViewStyle>;
+    onMessage?: (message: Message) => void;
+    onError?: (error: Error) => void;
+    onToolUse?: (toolUse: CoreToolUse, onProgress?: (update: {
+        status?: string;
+        progress?: number;
+        partialResult?: string;
+        steps?: string[];
+        partialContent?: string;
+    }) => void) => Promise<Message | void>;
+};
+export type ToolUse = CoreToolUse;
+export type { Message };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

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

package/dist/voice/AudioSessionWaker.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+type VideoSource = number | {
+    uri: string;
+};
+export type AudioSessionWakerProps = {
+    /**
+     * Bundled silent MP3 (e.g. `require('./assets/silent.mp3')`).
+     * Required on iOS for WebRTC + TTS until AVAudioSession is activated.
+     */
+    silentSource: VideoSource;
+};
+/**
+ * iOS-only: loop silent audio at volume 0 so react-native-video keeps AVAudioSession active.
+ * View stays mounted for app lifetime (Berify pattern — never unmount).
+ */
+export declare function AudioSessionWaker({ silentSource }: AudioSessionWakerProps): React.ReactElement | null;
+export {};
+//# sourceMappingURL=AudioSessionWaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioSessionWaker.d.ts","sourceRoot":"","sources":["../../src/voice/AudioSessionWaker.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,KAAK,WAAW,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAuC5C,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,YAAY,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,YAAY,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAoCrG"}

package/dist/voice/AudioSessionWaker.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { markIOSAudioSessionReady, setIOSAudioSessionPrewarmHandler, } from '@bytexbyte/nxtlinq-ai-agent-react-native-development';
+import { useEffect, useRef } from 'react';
+function isIOS() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Platform } = require('react-native');
+        return Platform.OS === 'ios';
+    }
+    catch {
+        return false;
+    }
+}
+let VideoComponent = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    VideoComponent = require('react-native-video').default;
+}
+catch {
+    VideoComponent = null;
+}
+/**
+ * iOS-only: loop silent audio at volume 0 so react-native-video keeps AVAudioSession active.
+ * View stays mounted for app lifetime (Berify pattern — never unmount).
+ */
+export function AudioSessionWaker({ silentSource }) {
+    const videoRef = useRef(null);
+    useEffect(() => {
+        if (!isIOS() || !VideoComponent)
+            return undefined;
+        // Seek-only replay — pausing react-native-video can drop AVAudioSession on repeated reconnects.
+        setIOSAudioSessionPrewarmHandler(() => {
+            try {
+                videoRef.current?.seek(0);
+            }
+            catch {
+                /* noop */
+            }
+        });
+        return () => setIOSAudioSessionPrewarmHandler(null);
+    }, []);
+    if (!isIOS() || !VideoComponent) {
+        return null;
+    }
+    return (_jsx(VideoComponent, { ref: videoRef, source: silentSource, paused: false, volume: 0, playInBackground: false, repeat: true, ignoreSilentSwitch: "ignore", style: { width: 0, height: 0, position: 'absolute', opacity: 0 }, onLoad: () => markIOSAudioSessionReady(), onProgress: ({ currentTime }) => {
+            if (currentTime > 0)
+                markIOSAudioSessionReady();
+        } }));
+}

package/dist/voice/TextTtsPlayer.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { PostTextTtsResult } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export declare function isTextTtsPlayerSupported(): boolean;
+export type TextTtsPlayerHandle = {
+    play: (result: PostTextTtsResult) => Promise<void>;
+    stop: () => void;
+    isAvailable: boolean;
+};
+type Props = {
+    /** react-native-video volume 0–1. @default 1 */
+    volume?: number;
+    onPlayingChange?: (playing: boolean) => void;
+    onError?: (message: string) => void;
+    playerRef: React.MutableRefObject<TextTtsPlayerHandle | null>;
+};
+/**
+ * Hidden audio player for text-mode TTS (Berify uses react-native-video the same way).
+ */
+export declare function TextTtsPlayer({ volume, onPlayingChange, onError, playerRef, }: Props): React.ReactElement | null;
+export {};
+//# sourceMappingURL=TextTtsPlayer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextTtsPlayer.d.ts","sourceRoot":"","sources":["../../src/voice/TextTtsPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwC,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AA6BtF,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,KAAK,GAAG;IACX,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAU,EACV,eAAe,EACf,OAAO,EACP,SAAS,GACV,EAAE,KAAK,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkFnC"}

package/dist/voice/TextTtsPlayer.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useCallback, useRef, useState } from 'react';
+import { StyleSheet } from 'react-native';
+import { isTtsCacheFileSupported, removeTtsCacheFile, writeTtsCacheFile } from './writeTtsCacheFile';
+let VideoComponent = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    VideoComponent = require('react-native-video').default;
+}
+catch {
+    VideoComponent = null;
+}
+export function isTextTtsPlayerSupported() {
+    return VideoComponent != null;
+}
+/**
+ * Hidden audio player for text-mode TTS (Berify uses react-native-video the same way).
+ */
+export function TextTtsPlayer({ volume = 1, onPlayingChange, onError, playerRef, }) {
+    const videoRef = useRef(null);
+    const [source, setSource] = useState();
+    const lastFileRef = useRef(null);
+    const stop = useCallback(() => {
+        const prev = lastFileRef.current;
+        lastFileRef.current = null;
+        setSource(undefined);
+        onPlayingChange?.(false);
+        if (prev && isTtsCacheFileSupported()) {
+            void removeTtsCacheFile(prev);
+        }
+    }, [onPlayingChange]);
+    const play = useCallback(async (result) => {
+        if (!VideoComponent)
+            return;
+        try {
+            const uri = await writeTtsCacheFile(result);
+            if (lastFileRef.current && lastFileRef.current !== uri) {
+                void removeTtsCacheFile(lastFileRef.current);
+            }
+            lastFileRef.current = uri;
+            setSource({ uri });
+            onPlayingChange?.(true);
+            requestAnimationFrame(() => {
+                try {
+                    videoRef.current?.seek(0);
+                }
+                catch {
+                    /* noop */
+                }
+            });
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            onError?.(message);
+            stop();
+        }
+    }, [onPlayingChange, onError, stop]);
+    React.useEffect(() => {
+        playerRef.current = {
+            play,
+            stop,
+            isAvailable: VideoComponent != null,
+        };
+        return () => {
+            playerRef.current = null;
+            stop();
+        };
+    }, [play, stop, playerRef]);
+    if (!VideoComponent)
+        return null;
+    return (_jsx(VideoComponent, { ref: videoRef, source: source, style: styles.hidden, paused: !source, volume: volume, audioOnly: true, ignoreSilentSwitch: "ignore", playInBackground: false, playWhenInactive: true, onEnd: stop, onError: (e) => {
+            const msg = e?.error?.errorString ?? 'TTS playback failed';
+            onError?.(msg);
+            stop();
+        }, bufferConfig: {
+            minBufferMs: 800,
+            maxBufferMs: 4000,
+            bufferForPlaybackMs: 150,
+            bufferForPlaybackAfterRebufferMs: 500,
+        }, preferredForwardBufferDuration: 0.2 }));
+}
+const styles = StyleSheet.create({
+    hidden: {
+        width: 1,
+        height: 1,
+        opacity: 0.01,
+        position: 'absolute',
+        left: -1000,
+        top: -1000,
+    },
+});

package/dist/voice/VoiceAutoGreetBinder.d.ts

@@ -0,0 +1,6 @@
+import type { VoiceAutoGreetConfig } from './useVoiceAutoGreet';
+export declare function VoiceAutoGreetBinder({ config, historyReady, }: {
+    config: VoiceAutoGreetConfig;
+    historyReady: boolean;
+}): null;
+//# sourceMappingURL=VoiceAutoGreetBinder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceAutoGreetBinder.d.ts","sourceRoot":"","sources":["../../src/voice/VoiceAutoGreetBinder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,YAAY,GACb,EAAE;IACD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB,GAAG,IAAI,CAyBP"}

package/dist/voice/VoiceAutoGreetBinder.js

@@ -0,0 +1,25 @@
+import { uriToVoiceImageAttachment } from '@bytexbyte/nxtlinq-ai-agent-react-native-development';
+import { useCallback, useMemo } from 'react';
+import { useAgentAssistant } from '../context/AgentAssistantContext';
+import { useVoiceAutoGreet } from './useVoiceAutoGreet';
+export function VoiceAutoGreetBinder({ config, historyReady, }) {
+    const voice = useAgentAssistant();
+    const hasUserMessage = useMemo(() => voice.messages.some((m) => m.role === 'user'), [voice.messages]);
+    const resolveAttachments = useCallback(async () => {
+        const url = config.productImageUrl?.trim();
+        if (!url)
+            return config.attachments;
+        const image = await uriToVoiceImageAttachment(url, 'product.jpg');
+        return config.attachments?.length
+            ? [...config.attachments, image]
+            : [image];
+    }, [config.attachments, config.productImageUrl]);
+    useVoiceAutoGreet(voice, {
+        enabled: true,
+        config,
+        historyReady,
+        hasUserMessage,
+        resolveAttachments: config.productImageUrl ? resolveAttachments : undefined,
+    });
+    return null;
+}

package/dist/voice/useVoiceAutoGreet.d.ts

@@ -0,0 +1,24 @@
+import type { Attachment } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+import type { UseNxtlinqVoiceResult } from '@bytexbyte/nxtlinq-ai-agent-react-native-development';
+export type VoiceAutoGreetConfig = {
+    /** Greeting user text (e.g. product intro prompt). */
+    text?: string;
+    productName?: string;
+    /** HTTPS or data URI attached on first greet. */
+    productImageUrl?: string;
+    /** Pre-built attachments (overrides productImageUrl). */
+    attachments?: Attachment[];
+    skipUserMessage?: boolean;
+};
+/**
+ * Berify Jeannie auto-greet: after voice connects + history loaded, trigger one
+ * synthetic user turn when there is no prior real user message.
+ */
+export declare function useVoiceAutoGreet(voice: Pick<UseNxtlinqVoiceResult, 'isVoiceActive' | 'triggerVoiceGreeting'>, options: {
+    enabled: boolean;
+    config?: VoiceAutoGreetConfig;
+    historyReady: boolean;
+    hasUserMessage: boolean;
+    resolveAttachments?: () => Promise<Attachment[] | undefined>;
+}): void;
+//# sourceMappingURL=useVoiceAutoGreet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceAutoGreet.d.ts","sourceRoot":"","sources":["../../src/voice/useVoiceAutoGreet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAElG,MAAM,MAAM,oBAAoB,GAAG;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAUF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CACT,qBAAqB,EACrB,eAAe,GAAG,sBAAsB,CACzC,EACD,OAAO,EAAE;IACP,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,CAAC;CAC9D,GACA,IAAI,CAuDN"}

package/dist/voice/useVoiceAutoGreet.js

@@ -0,0 +1,64 @@
+import { useEffect, useRef } from 'react';
+function buildGreetingText(config) {
+    if (config.text?.trim())
+        return config.text.trim();
+    const product = config.productName?.trim();
+    return product
+        ? `Hi! Please give me a brief introduction to ${product}.`
+        : 'Hi! Please say hello and introduce yourself.';
+}
+/**
+ * Berify Jeannie auto-greet: after voice connects + history loaded, trigger one
+ * synthetic user turn when there is no prior real user message.
+ */
+export function useVoiceAutoGreet(voice, options) {
+    const sentRef = useRef(false);
+    useEffect(() => {
+        if (!options.enabled || !options.config) {
+            sentRef.current = false;
+            return;
+        }
+        if (!voice.isVoiceActive || !options.historyReady)
+            return;
+        if (sentRef.current)
+            return;
+        if (options.hasUserMessage) {
+            sentRef.current = true;
+            return;
+        }
+        let cancelled = false;
+        sentRef.current = true;
+        (async () => {
+            try {
+                const attachments = options.config?.attachments ??
+                    (await options.resolveAttachments?.());
+                if (cancelled)
+                    return;
+                await voice.triggerVoiceGreeting({
+                    text: buildGreetingText(options.config),
+                    attachments,
+                    skipUserMessage: options.config?.skipUserMessage ?? true,
+                }, { waitForChannel: true, timeoutMs: 12000 });
+            }
+            catch {
+                sentRef.current = false;
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        voice.isVoiceActive,
+        voice.triggerVoiceGreeting,
+        options.enabled,
+        options.config,
+        options.historyReady,
+        options.hasUserMessage,
+        options.resolveAttachments,
+    ]);
+    useEffect(() => {
+        if (!voice.isVoiceActive) {
+            sentRef.current = false;
+        }
+    }, [voice.isVoiceActive]);
+}

package/dist/voice/useVoiceMicState.d.ts

@@ -0,0 +1,24 @@
+import type { UseNxtlinqVoiceResult } from '@bytexbyte/nxtlinq-ai-agent-react-native-development';
+/**
+ * Mic mute / hold behavior aligned with web SDK {@link useVoiceMode}.
+ * - Starts muted on connect (`startWithMicMuted`)
+ * - Holds mic during assistant transcribing → speaking
+ */
+export type UseVoiceMicStateOptions = {
+    /** When false, mic is open after connect (demo-friendly). Default true (Berify hold-to-talk). */
+    startWithMicMuted?: boolean;
+    /**
+     * When false, do not mute the mic (local + server) while the assistant is responding.
+     * Use with open-mic demos (`startWithMicMuted={false}`). Berify hold-to-talk keeps this true.
+     */
+    holdMicDuringAssistant?: boolean;
+};
+export declare function useVoiceMicState(voice: UseNxtlinqVoiceResult, isVoiceConnecting: boolean, options?: UseVoiceMicStateOptions): {
+    isMicMuted: boolean;
+    isMicHeldForAssistant: boolean;
+    toggleVoiceMicMute: () => void;
+    prepareForVoiceConnect: () => void;
+    resetMicState: () => void;
+    clearAssistantMicHold: () => void;
+};
+//# sourceMappingURL=useVoiceMicState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceMicState.d.ts","sourceRoot":"","sources":["../../src/voice/useVoiceMicState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAIlG;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,iBAAiB,EAAE,OAAO,EAC1B,OAAO,CAAC,EAAE,uBAAuB;;;;;;;EA4FlC"}

package/dist/voice/useVoiceMicState.js

@@ -0,0 +1,84 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ASSISTANT_MIC_HOLD_STATUSES } from './voiceMicConstants';
+export function useVoiceMicState(voice, isVoiceConnecting, options) {
+    const connectMuted = options?.startWithMicMuted !== false;
+    const holdDuringAssistant = options?.holdMicDuringAssistant !== false;
+    const userMicMutedRef = useRef(connectMuted);
+    const assistantMicHoldRef = useRef(false);
+    const userMicOptInRef = useRef(!connectMuted);
+    const [isMicMuted, setIsMicMuted] = useState(connectMuted);
+    const applyMicState = useCallback(() => {
+        const shouldMute = userMicMutedRef.current || assistantMicHoldRef.current;
+        voice.muteMic(shouldMute);
+        setIsMicMuted(shouldMute);
+    }, [voice]);
+    const resetMicState = useCallback(() => {
+        userMicMutedRef.current = false;
+        assistantMicHoldRef.current = false;
+        userMicOptInRef.current = false;
+        setIsMicMuted(false);
+    }, []);
+    const prepareForVoiceConnect = useCallback(() => {
+        userMicMutedRef.current = connectMuted;
+        userMicOptInRef.current = !connectMuted;
+        assistantMicHoldRef.current = false;
+        setIsMicMuted(connectMuted);
+        voice.muteMic(connectMuted);
+    }, [voice, connectMuted]);
+    useEffect(() => {
+        if (!isVoiceConnecting)
+            return;
+        userMicMutedRef.current = connectMuted;
+        voice.muteMic(connectMuted);
+        setIsMicMuted(connectMuted);
+    }, [isVoiceConnecting, voice, connectMuted]);
+    const prevVoiceStatusRef = useRef(voice.voiceStatus);
+    useEffect(() => {
+        const status = voice.voiceStatus;
+        const prev = prevVoiceStatusRef.current;
+        prevVoiceStatusRef.current = status;
+        if (holdDuringAssistant && ASSISTANT_MIC_HOLD_STATUSES.has(status)) {
+            assistantMicHoldRef.current = true;
+            applyMicState();
+            return;
+        }
+        if (status === 'listening' || status === 'idle') {
+            assistantMicHoldRef.current = false;
+            if (connectMuted
+                && status === 'listening'
+                && prev === 'speaking'
+                && !userMicOptInRef.current) {
+                userMicMutedRef.current = true;
+            }
+            applyMicState();
+        }
+    }, [voice.voiceStatus, applyMicState, holdDuringAssistant]);
+    const toggleVoiceMicMute = useCallback(() => {
+        if (!voice.isVoiceActive && !isVoiceConnecting)
+            return;
+        if (assistantMicHoldRef.current && userMicMutedRef.current)
+            return;
+        if (assistantMicHoldRef.current) {
+            userMicMutedRef.current = true;
+            applyMicState();
+            return;
+        }
+        const nextMuted = !userMicMutedRef.current;
+        userMicMutedRef.current = nextMuted;
+        userMicOptInRef.current = !nextMuted;
+        applyMicState();
+    }, [voice.isVoiceActive, isVoiceConnecting, applyMicState]);
+    const clearAssistantMicHold = useCallback(() => {
+        assistantMicHoldRef.current = false;
+        applyMicState();
+    }, [applyMicState]);
+    const isMicHeldForAssistant = ASSISTANT_MIC_HOLD_STATUSES.has(voice.voiceStatus);
+    return {
+        isMicMuted,
+        isMicHeldForAssistant,
+        toggleVoiceMicMute,
+        prepareForVoiceConnect,
+        resetMicState,
+        clearAssistantMicHold,
+    };
+}

package/dist/voice/voiceMicConstants.d.ts

@@ -0,0 +1,5 @@
+import type { VoiceStatus } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/** Pause mic while assistant pipeline runs (aligned with web {@link useVoiceMode}). */
+export declare const ASSISTANT_MIC_HOLD_STATUSES: ReadonlySet<VoiceStatus>;
+export declare const SPEAKER_ACTIVE_STATUSES: ReadonlySet<VoiceStatus>;
+//# sourceMappingURL=voiceMicConstants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voiceMicConstants.d.ts","sourceRoot":"","sources":["../../src/voice/voiceMicConstants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,WAAW,CAK/D,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,WAAW,CAG3D,CAAC"}

package/dist/voice/voiceMicConstants.js

@@ -0,0 +1,11 @@
+/** Pause mic while assistant pipeline runs (aligned with web {@link useVoiceMode}). */
+export const ASSISTANT_MIC_HOLD_STATUSES = new Set([
+    'transcribing',
+    'thinking',
+    'generating',
+    'speaking',
+]);
+export const SPEAKER_ACTIVE_STATUSES = new Set([
+    'generating',
+    'speaking',
+]);

package/dist/voice/voiceWaveformConstants.d.ts

@@ -0,0 +1,6 @@
+import type { VoiceStatus } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+/** Match Berify: waveform animates only while assistant output audio is active. */
+export declare const WAVEFORM_ACTIVE_STATUSES: ReadonlySet<VoiceStatus>;
+export declare const WAVEFORM_AUDIBLE_THRESHOLD = 0.01;
+export declare const WAVEFORM_AUDIBLE_HOLD_MS = 800;
+//# sourceMappingURL=voiceWaveformConstants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voiceWaveformConstants.d.ts","sourceRoot":"","sources":["../../src/voice/voiceWaveformConstants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,WAAW,CAG5D,CAAC;AAEH,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,wBAAwB,MAAM,CAAC"}

package/dist/voice/voiceWaveformConstants.js

@@ -0,0 +1,7 @@
+/** Match Berify: waveform animates only while assistant output audio is active. */
+export const WAVEFORM_ACTIVE_STATUSES = new Set([
+    'generating',
+    'speaking',
+]);
+export const WAVEFORM_AUDIBLE_THRESHOLD = 0.01;
+export const WAVEFORM_AUDIBLE_HOLD_MS = 800;

package/dist/voice/webrtcAudioGain.d.ts

@@ -0,0 +1,6 @@
+import { type RemoteAudioTrackLike } from '@bytexbyte/nxtlinq-ai-agent-core-development';
+export declare const DEFAULT_VOICE_REMOTE_AUDIO_GAIN = 10;
+export type WebRTCAudioTrackLike = RemoteAudioTrackLike;
+/** @deprecated Use {@link applyRemoteAudioPlaybackGain} */
+export declare function applyWebRTCAudioTrackGain(tracks: WebRTCAudioTrackLike[], gain: number): void;
+//# sourceMappingURL=webrtcAudioGain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webrtcAudioGain.d.ts","sourceRoot":"","sources":["../../src/voice/webrtcAudioGain.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,8CAA8C,CAAC;AAEtD,eAAO,MAAM,+BAA+B,KAA4B,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD,2DAA2D;AAC3D,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,IAAI,CAON"}