@elevenlabs/react 0.14.3 → 1.0.0-rc.0

package/dist/conversation/ConversationProvider.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
+import { Conversation } from "@elevenlabs/client";
+import { CALLBACK_KEYS, mergeOptions, parseLocation, getOriginForLocation, getLivekitUrlForLocation, } from "@elevenlabs/client/internal";
+import { ConversationContext, } from "./ConversationContext";
+import { ConversationControlsProvider } from "./ConversationControls";
+import { ConversationStatusProvider } from "./ConversationStatus";
+import { ConversationInputProvider } from "./ConversationInput";
+import { ConversationModeProvider } from "./ConversationMode";
+import { ConversationFeedbackProvider } from "./ConversationFeedback";
+import { ConversationClientToolsProvider, buildClientTools, } from "./ConversationClientTools";
+import { ListenerMap } from "./ListenerMap";
+import { useStableCallbacks } from "./useStableCallbacks";
+const SUB_PROVIDERS = [
+    ConversationControlsProvider,
+    ConversationStatusProvider,
+    ConversationInputProvider,
+    ConversationModeProvider,
+    ConversationFeedbackProvider,
+    ConversationClientToolsProvider,
+];
+export function ConversationProvider({ children, ...defaultOptions }) {
+    /** The active conversation instance, if any. */
+    const conversationRef = useRef(null);
+    /** In-flight startSession promise, used to prevent duplicate connections. */
+    const lockRef = useRef(null);
+    /** Signals that endSession was called while a connection was still pending. */
+    const shouldEndRef = useRef(false);
+    /** Registry of hook-registered client tools. Survives across sessions. */
+    const [clientToolsRegistry] = useState(() => new Map());
+    /** Ref to the live clientTools object currently held by BaseConversation. */
+    const clientToolsRef = useRef({});
+    /** Always holds the latest provider props, avoiding stale closures in callbacks. */
+    const defaultOptionsRef = useRef(defaultOptions);
+    // eslint-disable-next-line react-hooks/refs -- intentional sync during render for latest-ref pattern
+    defaultOptionsRef.current = defaultOptions;
+    /** Callback registry for sub-providers (status, mode, feedback, etc.). */
+    const [listenerMap] = useState(() => new ListenerMap(CALLBACK_KEYS));
+    /** Reactive mirror of conversationRef, triggers re-renders for context consumers. */
+    const [conversation, setConversation] = useState(null);
+    const stableCallbacks = useStableCallbacks(defaultOptions);
+    const registerCallbacks = useCallback((callbacks) => listenerMap.register(callbacks), [listenerMap]);
+    // Sync provider state when session ends externally (agent disconnect,
+    // raw instance endSession(), etc.). Uses the listener map so it composes
+    // with user-provided onDisconnect callbacks.
+    useLayoutEffect(() => {
+        return listenerMap.register({
+            onDisconnect: () => {
+                conversationRef.current = null;
+                setConversation(null);
+            },
+        });
+    }, [listenerMap]);
+    const startSession = useCallback((options) => {
+        if (conversationRef.current) {
+            return;
+        }
+        if (lockRef.current) {
+            return;
+        }
+        shouldEndRef.current = false;
+        const defaults = defaultOptionsRef.current;
+        const resolvedServerLocation = parseLocation(options?.serverLocation || defaults?.serverLocation);
+        const origin = getOriginForLocation(resolvedServerLocation);
+        const calculatedLivekitUrl = getLivekitUrlForLocation(resolvedServerLocation);
+        // Strip raw callbacks from defaults — stableCallbacks provides
+        // ref-backed versions that won't go stale across renders.
+        const defaultConfig = { ...defaults };
+        for (const key of CALLBACK_KEYS) {
+            delete defaultConfig[key];
+        }
+        const sessionOptions = mergeOptions({ livekitUrl: calculatedLivekitUrl }, defaultConfig, stableCallbacks, listenerMap.compose(), options ?? {}, { origin });
+        const clientTools = buildClientTools(sessionOptions.clientTools, clientToolsRegistry);
+        clientToolsRef.current = clientTools;
+        sessionOptions.clientTools = clientTools;
+        lockRef.current = Conversation.startSession(sessionOptions);
+        lockRef.current.then(conv => {
+            if (shouldEndRef.current) {
+                conv.endSession();
+                lockRef.current = null;
+                return;
+            }
+            conversationRef.current = conv;
+            setConversation(conv);
+            lockRef.current = null;
+        }, () => {
+            lockRef.current = null;
+        });
+    }, [stableCallbacks, listenerMap, clientToolsRegistry, clientToolsRef]);
+    const endSession = useCallback(() => {
+        shouldEndRef.current = true;
+        const pendingConnection = lockRef.current;
+        const conv = conversationRef.current;
+        conversationRef.current = null;
+        setConversation(null);
+        if (pendingConnection) {
+            pendingConnection.then(c => c.endSession());
+        }
+        else {
+            conv?.endSession();
+        }
+    }, []);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            shouldEndRef.current = true;
+            if (lockRef.current) {
+                lockRef.current.then(conv => conv.endSession());
+            }
+            else {
+                conversationRef.current?.endSession();
+            }
+        };
+    }, []);
+    const contextValue = useMemo(() => ({
+        conversation,
+        conversationRef,
+        startSession,
+        endSession,
+        registerCallbacks,
+        clientToolsRegistry,
+        clientToolsRef,
+    }), [conversation, conversationRef, startSession, endSession, registerCallbacks, clientToolsRegistry, clientToolsRef]);
+    const wrappedChildren = SUB_PROVIDERS.reduceRight((nested, Provider) => _jsx(Provider, { children: nested }), children);
+    return (_jsx(ConversationContext.Provider, { value: contextValue, children: wrappedChildren }));
+}
+//# sourceMappingURL=ConversationProvider.js.map

package/dist/conversation/ConversationProvider.js.map

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

package/dist/conversation/ConversationStatus.d.ts

@@ -0,0 +1,19 @@
+export type ConversationStatus = "disconnected" | "connecting" | "connected" | "error";
+export type ConversationStatusValue = {
+    status: ConversationStatus;
+    message?: string;
+};
+/**
+ * Reads from `ConversationContext` and registers `onStatusChange` + `onError`
+ * callbacks. Manages its own `status`/`message` state and provides it through
+ * `ConversationStatusContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export declare function ConversationStatusProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the current conversation status and any error message.
+ * Re-renders when the connection status or error message changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversationStatus(): ConversationStatusValue;
+//# sourceMappingURL=ConversationStatus.d.ts.map

package/dist/conversation/ConversationStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationStatus.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationStatus.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,YAAY,GACZ,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CA+BzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,uBAAuB,CAQ/D"}

package/dist/conversation/ConversationStatus.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useState } from "react";
+import { useRegisterCallbacks } from "./ConversationContext";
+const ConversationStatusContext = createContext(null);
+/**
+ * Reads from `ConversationContext` and registers `onStatusChange` + `onError`
+ * callbacks. Manages its own `status`/`message` state and provides it through
+ * `ConversationStatusContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export function ConversationStatusProvider({ children, }) {
+    const [status, setStatus] = useState("disconnected");
+    const [message, setMessage] = useState(undefined);
+    useRegisterCallbacks({
+        onStatusChange({ status: newStatus }) {
+            if (newStatus === "disconnecting") {
+                // Transient state — keep current status
+                return;
+            }
+            setStatus(newStatus);
+            // Clear error message when transitioning to a non-error state
+            setMessage(undefined);
+        },
+        onError(errorMessage) {
+            setStatus("error");
+            setMessage(errorMessage);
+        },
+    });
+    const value = useMemo(() => ({ status, message }), [status, message]);
+    return (_jsx(ConversationStatusContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns the current conversation status and any error message.
+ * Re-renders when the connection status or error message changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversationStatus() {
+    const ctx = useContext(ConversationStatusContext);
+    if (!ctx) {
+        throw new Error("useConversationStatus must be used within a ConversationProvider");
+    }
+    return ctx;
+}
+//# sourceMappingURL=ConversationStatus.js.map

package/dist/conversation/ConversationStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationStatus.js","sourceRoot":"","sources":["../../src/conversation/ConversationStatus.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAa7D,MAAM,yBAAyB,GAAG,aAAa,CAC7C,IAAI,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,QAAQ,GACgB;IACxB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACvB,QAAQ,CAAoC,cAAc,CAAC,CAAC;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAEtE,oBAAoB,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE;YAClC,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;gBAClC,wCAAwC;gBACxC,OAAO;YACT,CAAC;YACD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,8DAA8D;YAC9D,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,YAAY;YAClB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAC3B,CAAC,MAAM,EAAE,OAAO,CAAC,CAClB,CAAC;IAEF,OAAO,CACL,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC7C,QAAQ,GAC0B,CACtC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conversation/ListenerMap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A map of named listener sets. Each key maps to a `ListenerSet` that can have
+ * multiple listeners registered. Typed through `T` so that `register` and
+ * `compose` preserve per-key callback signatures.
+ *
+ * All keys are pre-initialized in the constructor so `register` can validate
+ * keys. `compose()` only includes keys with at least one registered listener,
+ * preserving callback-presence semantics used by the client as feature guards.
+ * For included keys, composed functions delegate to the live listener set, so
+ * listeners added/removed after `compose()` still take effect. Keys with no
+ * listeners at compose time are omitted entirely; call `compose()` again after
+ * registering listeners to pick up newly populated keys.
+ */
+export declare class ListenerMap<T extends Record<string, ((...args: never[]) => void) | undefined>> {
+    private sets;
+    constructor(keys: readonly (keyof T & string)[]);
+    /**
+     * Register listeners for one or more keys. Returns a function that removes
+     * all listeners added by this call.
+     */
+    register(callbacks: Partial<T>): () => void;
+    /**
+     * Compose all registered listeners into a single callbacks object. Each
+     * composed function delegates to the live listener set, so listeners
+     * added/removed after this call still take effect.
+     */
+    compose(): Partial<T>;
+}
+//# sourceMappingURL=ListenerMap.d.ts.map

package/dist/conversation/ListenerMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerMap.d.ts","sourceRoot":"","sources":["../../src/conversation/ListenerMap.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW,CACtB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAElE,OAAO,CAAC,IAAI,CAA6C;gBAE7C,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE;IAM/C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAgB3C;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;CAYtB"}

package/dist/conversation/ListenerMap.js

@@ -0,0 +1,63 @@
+import { ListenerSet } from "./ListenerSet";
+function assertFunction(value, key) {
+    if (typeof value !== "function") {
+        throw new Error(`Expected function for key "${key}", got ${typeof value}`);
+    }
+}
+/**
+ * A map of named listener sets. Each key maps to a `ListenerSet` that can have
+ * multiple listeners registered. Typed through `T` so that `register` and
+ * `compose` preserve per-key callback signatures.
+ *
+ * All keys are pre-initialized in the constructor so `register` can validate
+ * keys. `compose()` only includes keys with at least one registered listener,
+ * preserving callback-presence semantics used by the client as feature guards.
+ * For included keys, composed functions delegate to the live listener set, so
+ * listeners added/removed after `compose()` still take effect. Keys with no
+ * listeners at compose time are omitted entirely; call `compose()` again after
+ * registering listeners to pick up newly populated keys.
+ */
+export class ListenerMap {
+    sets = new Map();
+    constructor(keys) {
+        for (const key of keys) {
+            this.sets.set(key, new ListenerSet());
+        }
+    }
+    /**
+     * Register listeners for one or more keys. Returns a function that removes
+     * all listeners added by this call.
+     */
+    register(callbacks) {
+        const removers = Object.entries(callbacks)
+            .filter(([, fn]) => fn !== undefined)
+            .map(([key, fn]) => {
+            assertFunction(fn, key);
+            const set = this.sets.get(key);
+            if (!set) {
+                throw new Error(`Unknown callback key "${key}"`);
+            }
+            return set.add(fn);
+        });
+        return () => {
+            for (const remove of removers)
+                remove();
+        };
+    }
+    /**
+     * Compose all registered listeners into a single callbacks object. Each
+     * composed function delegates to the live listener set, so listeners
+     * added/removed after this call still take effect.
+     */
+    compose() {
+        return Object.fromEntries(Array.from(this.sets.entries())
+            .filter(([, set]) => set.size > 0)
+            .map(([key, set]) => [
+            key,
+            (...args) => {
+                set.invoke(...args);
+            },
+        ]));
+    }
+}
+//# sourceMappingURL=ListenerMap.js.map

package/dist/conversation/ListenerMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerMap.js","sourceRoot":"","sources":["../../src/conversation/ListenerMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,SAAS,cAAc,CACrB,KAAc,EACd,GAAW;IAEX,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,UAAU,OAAO,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAW;IAGd,IAAI,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEzD,YAAY,IAAmC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,WAAW,EAAa,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAqB;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;YACjB,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,MAAM,IAAI,QAAQ;gBAAE,MAAM,EAAE,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;YACnB,GAAG;YACH,CAAC,GAAG,IAAa,EAAE,EAAE;gBACnB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACtB,CAAC;SACF,CAAC,CACS,CAAC;IAClB,CAAC;CACF"}

package/dist/conversation/ListenerSet.d.ts

@@ -0,0 +1,7 @@
+export declare class ListenerSet<Args extends unknown[]> {
+    private listeners;
+    add(fn: (...args: Args) => void): () => void;
+    invoke(...args: Args): void;
+    get size(): number;
+}
+//# sourceMappingURL=ListenerSet.d.ts.map

package/dist/conversation/ListenerSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerSet.d.ts","sourceRoot":"","sources":["../../src/conversation/ListenerSet.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE;IAC7C,OAAO,CAAC,SAAS,CAAsC;IAEvD,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAO5C,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI;IAI3B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/conversation/ListenerSet.js

@@ -0,0 +1,17 @@
+export class ListenerSet {
+    listeners = new Set();
+    add(fn) {
+        this.listeners.add(fn);
+        return () => {
+            this.listeners.delete(fn);
+        };
+    }
+    invoke(...args) {
+        for (const fn of this.listeners)
+            fn(...args);
+    }
+    get size() {
+        return this.listeners.size;
+    }
+}
+//# sourceMappingURL=ListenerSet.js.map

package/dist/conversation/ListenerSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerSet.js","sourceRoot":"","sources":["../../src/conversation/ListenerSet.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACd,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEvD,GAAG,CAAC,EAA2B;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAU;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS;YAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/conversation/types.d.ts

@@ -0,0 +1,9 @@
+import type { SessionConfig, ClientToolsConfig, InputConfig, AudioWorkletConfig, OutputConfig, FormatConfig, Callbacks, Location } from "@elevenlabs/client";
+export type ClientToolResult = string | number | void;
+export type ClientTool<Parameters extends Record<string, unknown> = Record<string, unknown>, Result extends ClientToolResult = ClientToolResult> = (parameters: Parameters) => Promise<Result> | Result;
+export type ClientTools = Record<string, ClientTool>;
+export type HookCallbacks = Pick<Callbacks, "onConnect" | "onDisconnect" | "onError" | "onMessage" | "onAudio" | "onModeChange" | "onStatusChange" | "onCanSendFeedbackChange" | "onDebug" | "onUnhandledClientToolCall" | "onVadScore" | "onInterruption" | "onAgentToolResponse" | "onAgentToolRequest" | "onConversationMetadata" | "onMCPToolCall" | "onMCPConnectionStatus" | "onAsrInitiationMetadata" | "onAgentChatResponsePart" | "onAudioAlignment">;
+export type HookOptions = Partial<SessionConfig & HookCallbacks & ClientToolsConfig & InputConfig & OutputConfig & AudioWorkletConfig & FormatConfig & {
+    serverLocation?: Location | string;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/conversation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/conversation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAEtD,MAAM,MAAM,UAAU,CACpB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,IAChD,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,SAAS,EACP,WAAW,GACX,cAAc,GACd,SAAS,GACT,WAAW,GACX,SAAS,GACT,cAAc,GACd,gBAAgB,GAChB,yBAAyB,GACzB,SAAS,GACT,2BAA2B,GAC3B,YAAY,GACZ,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,eAAe,GACf,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,kBAAkB,CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,aAAa,GACX,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,YAAY,GAAG;IACb,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACpC,CACJ,CAAC"}

package/dist/conversation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/conversation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/conversation/types.ts"],"names":[],"mappings":""}

package/dist/conversation/useConversation.d.ts

@@ -0,0 +1,45 @@
+import type { HookOptions } from "./types";
+export type UseConversationOptions = HookOptions & {
+    micMuted?: boolean;
+    volume?: number;
+};
+/**
+ * Convenience hook that combines all granular conversation hooks into a single
+ * return value. Less performant than using individual hooks because any state
+ * change in any sub-context triggers a re-render of the consuming component.
+ *
+ * Accepts optional `micMuted`, `volume`, session config, and callback props.
+ * Session config and callbacks passed here are used as defaults when calling
+ * `startSession()` without arguments. Callbacks are also registered with the
+ * provider so they stay up-to-date across re-renders.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversation(props?: UseConversationOptions): {
+    startSession: (options?: HookOptions) => void;
+    status: import("./ConversationStatus").ConversationStatus;
+    message: string | undefined;
+    isMuted: boolean;
+    setMuted: (isMuted: boolean) => void;
+    mode: "speaking" | "listening";
+    isSpeaking: boolean;
+    isListening: boolean;
+    canSendFeedback: boolean;
+    sendFeedback: (like: boolean) => void;
+    endSession: () => void;
+    sendUserMessage: (text: string) => void;
+    sendContextualUpdate: (text: string) => void;
+    sendUserActivity: () => void;
+    sendMCPToolApprovalResult: (toolCallId: string, isApproved: boolean) => void;
+    setVolume: (options: {
+        volume: number;
+    }) => void;
+    changeInputDevice: (config: import("@elevenlabs/client").FormatConfig & import("@elevenlabs/client").InputDeviceConfig) => Promise<void>;
+    changeOutputDevice: (config: import("@elevenlabs/client").FormatConfig & import("@elevenlabs/client").OutputConfig) => Promise<void>;
+    getInputByteFrequencyData: () => Uint8Array;
+    getOutputByteFrequencyData: () => Uint8Array;
+    getInputVolume: () => number;
+    getOutputVolume: () => number;
+    getId: () => string;
+};
+//# sourceMappingURL=useConversation.d.ts.map

package/dist/conversation/useConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversation.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,sBAA2B;6BAiBnD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;EA+CzB"}

package/dist/conversation/useConversation.js

@@ -0,0 +1,76 @@
+import { useCallback, useEffect, useRef } from "react";
+import { CALLBACK_KEYS } from "@elevenlabs/client/internal";
+import { useConversationControls } from "./ConversationControls";
+import { useConversationStatus } from "./ConversationStatus";
+import { useConversationInput } from "./ConversationInput";
+import { useConversationMode } from "./ConversationMode";
+import { useConversationFeedback } from "./ConversationFeedback";
+import { useRawConversation, useRegisterCallbacks, } from "./ConversationContext";
+import { useStableCallbacks } from "./useStableCallbacks";
+/**
+ * Convenience hook that combines all granular conversation hooks into a single
+ * return value. Less performant than using individual hooks because any state
+ * change in any sub-context triggers a re-render of the consuming component.
+ *
+ * Accepts optional `micMuted`, `volume`, session config, and callback props.
+ * Session config and callbacks passed here are used as defaults when calling
+ * `startSession()` without arguments. Callbacks are also registered with the
+ * provider so they stay up-to-date across re-renders.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversation(props = {}) {
+    const { micMuted, volume, ...hookOptions } = props;
+    const stableCallbacks = useStableCallbacks(hookOptions);
+    useRegisterCallbacks(stableCallbacks);
+    const hookOptionsRef = useRef(hookOptions);
+    // eslint-disable-next-line react-hooks/refs -- intentional sync during render for latest-ref pattern
+    hookOptionsRef.current = hookOptions;
+    const controls = useConversationControls();
+    const { status, message } = useConversationStatus();
+    const { isMuted, setMuted } = useConversationInput();
+    const { mode, isSpeaking, isListening } = useConversationMode();
+    const { canSendFeedback, sendFeedback } = useConversationFeedback();
+    const startSession = useCallback((options) => {
+        // Strip callbacks from the hook-level defaults: those are registered via
+        // useRegisterCallbacks and kept ref-stable across renders.
+        // NOTE: We intentionally do NOT strip callbacks from the `options` parameter
+        // here. Callbacks passed directly to startSession() are treated as one-shot
+        // per-session overrides, and may capture render-local state. This asymmetry
+        // (hook callbacks are ref-stable; startSession callbacks are one-shot) is
+        // intentional and relied on by the public API.
+        const sessionConfig = { ...hookOptionsRef.current };
+        for (const key of CALLBACK_KEYS) {
+            delete sessionConfig[key];
+        }
+        controls.startSession({
+            ...sessionConfig,
+            ...options,
+        });
+    }, [controls, hookOptionsRef]);
+    const conversation = useRawConversation();
+    useEffect(() => {
+        if (micMuted !== undefined && conversation) {
+            setMuted(micMuted);
+        }
+    }, [micMuted, conversation, setMuted]);
+    useEffect(() => {
+        if (volume !== undefined && conversation) {
+            conversation.setVolume({ volume });
+        }
+    }, [volume, conversation]);
+    return {
+        ...controls,
+        startSession,
+        status,
+        message,
+        isMuted: micMuted ?? isMuted,
+        setMuted,
+        mode,
+        isSpeaking,
+        isListening,
+        canSendFeedback,
+        sendFeedback,
+    };
+}
+//# sourceMappingURL=useConversation.js.map

package/dist/conversation/useConversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversation.js","sourceRoot":"","sources":["../../src/conversation/useConversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgC,EAAE;IAChE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC;IAEnD,MAAM,eAAe,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACxD,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAEtC,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,qGAAqG;IACrG,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;IAErC,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACpD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACrD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAChE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEpE,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,OAAqB,EAAE,EAAE;QACxB,yEAAyE;QACzE,2DAA2D;QAC3D,6EAA6E;QAC7E,4EAA4E;QAC5E,4EAA4E;QAC5E,0EAA0E;QAC1E,+CAA+C;QAC/C,MAAM,aAAa,GAAG,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,OAAQ,aAAyC,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,QAAQ,CAAC,YAAY,CAAC;YACpB,GAAG,aAAa;YAChB,GAAG,OAAO;SACI,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,QAAQ,EAAE,cAAc,CAAC,CAC3B,CAAC;IAEF,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,KAAK,SAAS,IAAI,YAAY,EAAE,CAAC;YAC3C,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,KAAK,SAAS,IAAI,YAAY,EAAE,CAAC;YACzC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAE3B,OAAO;QACL,GAAG,QAAQ;QACX,YAAY;QACZ,MAAM;QACN,OAAO;QACP,OAAO,EAAE,QAAQ,IAAI,OAAO;QAC5B,QAAQ;QACR,IAAI;QACJ,UAAU;QACV,WAAW;QACX,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/conversation/useStableCallbacks.d.ts

@@ -0,0 +1,13 @@
+import type { Callbacks } from "@elevenlabs/client";
+import type { HookOptions } from "./types";
+/**
+ * Wraps user-provided callback props in stable ref-backed functions,
+ * preventing stale closure bugs when the session outlives renders.
+ *
+ * Returns a `Partial<Callbacks>` containing only the keys the caller
+ * actually provided. Function references are stable per key across
+ * renders, but always invoke the latest prop value. The returned object
+ * reference is stable as long as the set of provided keys doesn't change.
+ */
+export declare function useStableCallbacks(props: HookOptions): Partial<Callbacks>;
+//# sourceMappingURL=useStableCallbacks.d.ts.map

package/dist/conversation/useStableCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableCallbacks.d.ts","sourceRoot":"","sources":["../../src/conversation/useStableCallbacks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CA6BzE"}

package/dist/conversation/useStableCallbacks.js

@@ -0,0 +1,33 @@
+import { useMemo, useRef } from "react";
+import { CALLBACK_KEYS } from "@elevenlabs/client/internal";
+/**
+ * Wraps user-provided callback props in stable ref-backed functions,
+ * preventing stale closure bugs when the session outlives renders.
+ *
+ * Returns a `Partial<Callbacks>` containing only the keys the caller
+ * actually provided. Function references are stable per key across
+ * renders, but always invoke the latest prop value. The returned object
+ * reference is stable as long as the set of provided keys doesn't change.
+ */
+export function useStableCallbacks(props) {
+    // Store the latest prop value for each callback in a ref.
+    // Uses Record<string, unknown> to avoid TypeScript's union-to-intersection
+    // issue when indexing Callbacks with a union of all its keys.
+    const callbackRefs = useRef({});
+    for (const key of CALLBACK_KEYS) {
+        callbackRefs.current[key] = props[key];
+    }
+    // Compute a stable scalar from the set of provided keys so we can
+    // memoize the result object.
+    const activeKeys = CALLBACK_KEYS.filter(key => props[key] !== undefined);
+    return useMemo(() => Object.fromEntries(activeKeys.map(key => [
+        key,
+        (...args) => {
+            const fn = callbackRefs.current[key];
+            fn?.(...args);
+        },
+    ])), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- joined string is a stable scalar derived from activeKeys
+    [activeKeys.join("|")]);
+}
+//# sourceMappingURL=useStableCallbacks.js.map

package/dist/conversation/useStableCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableCallbacks.js","sourceRoot":"","sources":["../../src/conversation/useStableCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,0DAA0D;IAC1D,2EAA2E;IAC3E,8DAA8D;IAC9D,MAAM,YAAY,GAAG,MAAM,CAA0B,EAAE,CAAC,CAAC;IACzD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,kEAAkE;IAClE,6BAA6B;IAC7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;IAEzE,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,MAAM,CAAC,WAAW,CAChB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,GAAG;QACH,CAAC,GAAG,IAAe,EAAE,EAAE;YACrB,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAEtB,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAChB,CAAC;KACF,CAAC,CACmB;IACzB,mHAAmH;IACnH,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACvB,CAAC;AACJ,CAAC"}