@elevenlabs/react 0.14.2 → 1.0.0-rc.0

package/dist/conversation/ConversationClientTools.d.ts

@@ -0,0 +1,39 @@
+import type { ClientToolsConfig } from "@elevenlabs/client";
+import type { ClientTool, ClientTools } from "./types";
+type ClientToolEntry = ClientToolsConfig["clientTools"][string];
+/**
+ * Creates a fresh clientTools object by merging option-provided tools with
+ * hook-registered tools from the registry. Throws if a hook-registered tool
+ * name conflicts with an option-provided tool.
+ */
+export declare function buildClientTools(optionTools: Record<string, ClientToolEntry> | undefined, registry: Map<string, ClientToolEntry>): Record<string, ClientToolEntry>;
+export declare function ConversationClientToolsProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Registers a named client tool with the nearest `ConversationProvider`.
+ * The tool is available during any active conversation and is automatically
+ * unregistered when the component unmounts.
+ *
+ * The handler always reflects the latest closure value (ref pattern),
+ * so it is safe to reference component state or props without listing
+ * them as dependencies.
+ *
+ * @typeParam TTools - An interface mapping tool names to function signatures.
+ * @typeParam TName  - The specific tool name (inferred from the first argument).
+ * @param name    - The tool name (must match the name configured on the agent).
+ * @param handler - The function invoked when the agent calls this tool.
+ *
+ * @example
+ * ```tsx
+ * type Tools = {
+ *   get_weather: (params: { city: string }) => string;
+ *   set_volume: (params: { level: number }) => void;
+ * };
+ *
+ * useConversationClientTool<Tools>("get_weather", (params) => {
+ *   return `Weather in ${params.city} is sunny.`;
+ * });
+ * ```
+ */
+export declare function useConversationClientTool<TTools extends ClientTools = Record<string, ClientTool>, TName extends string & keyof TTools = string & keyof TTools>(name: TName, handler: TTools[TName]): void;
+export {};
+//# sourceMappingURL=ConversationClientTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationClientTools.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationClientTools.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,KAAK,eAAe,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EACxD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAYjC;AAeD,wBAAgB,+BAA+B,CAAC,EAC9C,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CAqCzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,SAAS,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACvD,KAAK,SAAS,MAAM,GAAG,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,MAAM,EAC3D,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAiB3C"}

package/dist/conversation/ConversationClientTools.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useLayoutEffect, useRef } from "react";
+import { ConversationContext } from "./ConversationContext";
+/**
+ * Creates a fresh clientTools object by merging option-provided tools with
+ * hook-registered tools from the registry. Throws if a hook-registered tool
+ * name conflicts with an option-provided tool.
+ */
+export function buildClientTools(optionTools, registry) {
+    const clientTools = { ...optionTools };
+    for (const [name, handler] of registry) {
+        if (Object.hasOwn(clientTools, name)) {
+            throw new Error(`Client tool "${name}" is already provided via props/options. ` +
+                `Remove it from props or do not register it with useConversationClientTool.`);
+        }
+        clientTools[name] = handler;
+    }
+    return clientTools;
+}
+const ConversationClientToolsContext = createContext(null);
+export function ConversationClientToolsProvider({ children, }) {
+    const ctx = useContext(ConversationContext);
+    if (!ctx) {
+        throw new Error("ConversationClientToolsProvider must be rendered inside a ConversationProvider");
+    }
+    const { clientToolsRegistry, clientToolsRef } = ctx;
+    const registerClientTool = useCallback((name, handler) => {
+        if (clientToolsRegistry.has(name)) {
+            throw new Error(`Client tool "${name}" is already registered by another hook. ` +
+                `Each tool name must be unique.`);
+        }
+        clientToolsRegistry.set(name, handler);
+        clientToolsRef.current[name] = handler;
+        return () => {
+            if (clientToolsRegistry.get(name) === handler) {
+                clientToolsRegistry.delete(name);
+            }
+            if (clientToolsRef.current[name] === handler) {
+                delete clientToolsRef.current[name];
+            }
+        };
+    }, [clientToolsRegistry, clientToolsRef]);
+    return (_jsx(ConversationClientToolsContext.Provider, { value: registerClientTool, children: children }));
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Registers a named client tool with the nearest `ConversationProvider`.
+ * The tool is available during any active conversation and is automatically
+ * unregistered when the component unmounts.
+ *
+ * The handler always reflects the latest closure value (ref pattern),
+ * so it is safe to reference component state or props without listing
+ * them as dependencies.
+ *
+ * @typeParam TTools - An interface mapping tool names to function signatures.
+ * @typeParam TName  - The specific tool name (inferred from the first argument).
+ * @param name    - The tool name (must match the name configured on the agent).
+ * @param handler - The function invoked when the agent calls this tool.
+ *
+ * @example
+ * ```tsx
+ * type Tools = {
+ *   get_weather: (params: { city: string }) => string;
+ *   set_volume: (params: { level: number }) => void;
+ * };
+ *
+ * useConversationClientTool<Tools>("get_weather", (params) => {
+ *   return `Weather in ${params.city} is sunny.`;
+ * });
+ * ```
+ */
+export function useConversationClientTool(name, handler) {
+    const registerClientTool = useContext(ConversationClientToolsContext);
+    if (!registerClientTool) {
+        throw new Error("useConversationClientTool must be used within a ConversationProvider");
+    }
+    const handlerRef = useRef(handler);
+    // eslint-disable-next-line react-hooks/refs -- intentional sync during render for latest-ref pattern
+    handlerRef.current = handler;
+    useLayoutEffect(() => {
+        const stableHandler = parameters => handlerRef.current(parameters);
+        return registerClientTool(name, stableHandler);
+    }, [registerClientTool, name]);
+}
+//# sourceMappingURL=ConversationClientTools.js.map

package/dist/conversation/ConversationClientTools.js.map

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

package/dist/conversation/ConversationContext.d.ts

@@ -0,0 +1,47 @@
+import { type MutableRefObject, type RefObject } from "react";
+import type { Callbacks, ClientToolsConfig, Conversation } from "@elevenlabs/client";
+import type { HookOptions } from "./types";
+type ClientToolEntry = ClientToolsConfig["clientTools"][string];
+export type ConversationContextValue = {
+    conversation: Conversation | null;
+    /** Stable ref to the active conversation — use in callbacks to avoid re-renders. */
+    conversationRef: RefObject<Conversation | null>;
+    startSession: (options?: HookOptions) => void;
+    endSession: () => void;
+    /**
+     * For sub-providers — register callback handlers to be composed into the
+     * next `Conversation.startSession()` call. Returns an unsubscribe function.
+     */
+    registerCallbacks: (callbacks: Partial<Callbacks>) => () => void;
+    /** Registry of hook-registered client tools. Survives across sessions. */
+    clientToolsRegistry: Map<string, ClientToolEntry>;
+    /** Ref to the live clientTools object currently held by BaseConversation. */
+    clientToolsRef: MutableRefObject<Record<string, ClientToolEntry>>;
+};
+export declare const ConversationContext: import("react").Context<ConversationContextValue | null>;
+/**
+ * Returns the raw `Conversation` instance (or `null` if no session is active).
+ * This is a public escape hatch for advanced use cases that need direct access
+ * to the underlying `@elevenlabs/client` Conversation object.
+ *
+ * Can be used outside a `ConversationProvider` — returns `null` in that case.
+ */
+export declare function useRawConversation(): Conversation | null;
+/**
+ * Returns a stable ref to the active `Conversation` instance.
+ * The ref's `.current` is `null` when no session is active, and updates
+ * without causing re-renders — ideal for use inside callbacks and sub-providers.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useRawConversationRef(): RefObject<Conversation | null>;
+/**
+ * Registers callback handlers with the nearest `ConversationProvider`.
+ * Uses a ref internally so the latest callback values are always invoked
+ * without re-subscribing on every render.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useRegisterCallbacks(callbacks: Partial<Callbacks>): void;
+export {};
+//# sourceMappingURL=ConversationContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationContext.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,eAAe,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,oFAAoF;IACpF,eAAe,EAAE,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;OAGG;IACH,iBAAiB,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC;IACjE,0EAA0E;IAC1E,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAClD,6EAA6E;IAC7E,cAAc,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,mBAAmB,0DACsB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAGxD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAQtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAgCxE"}

package/dist/conversation/ConversationContext.js

@@ -0,0 +1,61 @@
+import { createContext, useContext, useLayoutEffect, useRef } from "react";
+export const ConversationContext = createContext(null);
+/**
+ * Returns the raw `Conversation` instance (or `null` if no session is active).
+ * This is a public escape hatch for advanced use cases that need direct access
+ * to the underlying `@elevenlabs/client` Conversation object.
+ *
+ * Can be used outside a `ConversationProvider` — returns `null` in that case.
+ */
+export function useRawConversation() {
+    const ctx = useContext(ConversationContext);
+    return ctx?.conversation ?? null;
+}
+/**
+ * Returns a stable ref to the active `Conversation` instance.
+ * The ref's `.current` is `null` when no session is active, and updates
+ * without causing re-renders — ideal for use inside callbacks and sub-providers.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useRawConversationRef() {
+    const ctx = useContext(ConversationContext);
+    if (!ctx) {
+        throw new Error("useRawConversationRef must be used within a ConversationProvider");
+    }
+    return ctx.conversationRef;
+}
+/**
+ * Registers callback handlers with the nearest `ConversationProvider`.
+ * Uses a ref internally so the latest callback values are always invoked
+ * without re-subscribing on every render.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useRegisterCallbacks(callbacks) {
+    const ctx = useContext(ConversationContext);
+    if (!ctx) {
+        throw new Error("useRegisterCallbacks must be used within a ConversationProvider");
+    }
+    const { registerCallbacks } = ctx;
+    const callbacksRef = useRef(callbacks);
+    callbacksRef.current = callbacks;
+    // Re-subscribe when the set of provided callback keys changes.
+    const activeKeys = Object.keys(callbacks)
+        .filter(key => callbacks[key] !== undefined)
+        .sort();
+    useLayoutEffect(() => {
+        const stableCallbacks = Object.fromEntries(activeKeys.map((key) => [
+            key,
+            (...args) => {
+                const fn = callbacksRef.current[key];
+                if (typeof fn === "function") {
+                    fn(...args);
+                }
+            },
+        ]));
+        return registerCallbacks(stableCallbacks);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- activeKeys.join() is a stable scalar derived from activeKeys; no split needed since the effect closes over activeKeys directly
+    }, [registerCallbacks, activeKeys.join("|")]);
+}
+//# sourceMappingURL=ConversationContext.js.map

package/dist/conversation/ConversationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationContext.js","sourceRoot":"","sources":["../../src/conversation/ConversationContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAyC,MAAM,OAAO,CAAC;AAuBlH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,aAAa,CAAkC,IAAI,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE,YAAY,IAAI,IAAI,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,eAAe,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC;IAEjC,+DAA+D;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;SACtC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,GAAsB,CAAC,KAAK,SAAS,CAAC;SAC9D,IAAI,EAAE,CAAC;IAEV,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC;YAC9B,GAAG;YACH,CAAC,GAAG,IAAa,EAAE,EAAE;gBACnB,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,GAAsB,CAAC,CAAC;gBACxD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;oBAC5B,EAA8B,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;SACF,CAAC,CACmB,CAAC;QACxB,OAAO,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC1C,yLAAyL;IAC3L,CAAC,EAAE,CAAC,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/conversation/ConversationControls.d.ts

@@ -0,0 +1,34 @@
+import { type FormatConfig, type InputDeviceConfig, type OutputConfig } from "@elevenlabs/client";
+import type { HookOptions } from "./types";
+export type ConversationControlsValue = {
+    startSession: (options?: HookOptions) => 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: FormatConfig & InputDeviceConfig) => Promise<void>;
+    changeOutputDevice: (config: FormatConfig & OutputConfig) => Promise<void>;
+    getInputByteFrequencyData: () => Uint8Array;
+    getOutputByteFrequencyData: () => Uint8Array;
+    getInputVolume: () => number;
+    getOutputVolume: () => number;
+    getId: () => string;
+};
+export declare const ConversationControlsContext: import("react").Context<ConversationControlsValue | null>;
+/**
+ * Reads from `ConversationContext` and provides stable action references to
+ * `ConversationControlsContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export declare function ConversationControlsProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns stable action references for controlling the conversation.
+ * All function references are stable and will never cause re-renders.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversationControls(): ConversationControlsValue;
+//# sourceMappingURL=ConversationControls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationControls.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationControls.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,yBAAyB,EAAE,CACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,OAAO,KAChB,IAAI,CAAC;IACV,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjD,iBAAiB,EAAE,CACjB,MAAM,EAAE,YAAY,GAAG,iBAAiB,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,kBAAkB,EAAE,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,yBAAyB,EAAE,MAAM,UAAU,CAAC;IAC5C,0BAA0B,EAAE,MAAM,UAAU,CAAC;IAC7C,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,2BAA2B,2DACe,CAAC;AAExD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CA+HzB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,yBAAyB,CAQnE"}

package/dist/conversation/ConversationControls.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo } from "react";
+import { VoiceConversation, } from "@elevenlabs/client";
+import { ConversationContext } from "./ConversationContext";
+export const ConversationControlsContext = createContext(null);
+/**
+ * Reads from `ConversationContext` and provides stable action references to
+ * `ConversationControlsContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export function ConversationControlsProvider({ children, }) {
+    const ctx = useContext(ConversationContext);
+    if (!ctx) {
+        throw new Error("ConversationControlsProvider must be rendered inside a ConversationProvider");
+    }
+    const { conversationRef } = ctx;
+    const getConversation = useCallback(() => {
+        const conversation = conversationRef.current;
+        if (!conversation) {
+            throw new Error("No active conversation. Call startSession() first.");
+        }
+        return conversation;
+    }, [conversationRef]);
+    const sendUserMessage = useCallback((text) => {
+        getConversation().sendUserMessage(text);
+    }, [getConversation]);
+    const sendContextualUpdate = useCallback((text) => {
+        getConversation().sendContextualUpdate(text);
+    }, [getConversation]);
+    const sendUserActivity = useCallback(() => {
+        getConversation().sendUserActivity();
+    }, [getConversation]);
+    const sendMCPToolApprovalResult = useCallback((toolCallId, isApproved) => {
+        getConversation().sendMCPToolApprovalResult(toolCallId, isApproved);
+    }, [getConversation]);
+    const setVolume = useCallback((options) => {
+        getConversation().setVolume(options);
+    }, [getConversation]);
+    const changeInputDevice = useCallback(async (config) => {
+        const conversation = getConversation();
+        if (conversation instanceof VoiceConversation) {
+            return await conversation.changeInputDevice(config);
+        }
+        throw new Error("Device switching is only available for voice conversations");
+    }, [getConversation]);
+    const changeOutputDevice = useCallback(async (config) => {
+        const conversation = getConversation();
+        if (conversation instanceof VoiceConversation) {
+            return await conversation.changeOutputDevice(config);
+        }
+        throw new Error("Device switching is only available for voice conversations");
+    }, [getConversation]);
+    const getInputByteFrequencyData = useCallback(() => {
+        return getConversation().getInputByteFrequencyData();
+    }, [getConversation]);
+    const getOutputByteFrequencyData = useCallback(() => {
+        return getConversation().getOutputByteFrequencyData();
+    }, [getConversation]);
+    const getInputVolume = useCallback(() => {
+        return getConversation().getInputVolume();
+    }, [getConversation]);
+    const getOutputVolume = useCallback(() => {
+        return getConversation().getOutputVolume();
+    }, [getConversation]);
+    const getId = useCallback(() => {
+        return getConversation().getId();
+    }, [getConversation]);
+    const value = useMemo(() => ({
+        startSession: ctx.startSession,
+        endSession: ctx.endSession,
+        sendUserMessage,
+        sendContextualUpdate,
+        sendUserActivity,
+        sendMCPToolApprovalResult,
+        setVolume,
+        changeInputDevice,
+        changeOutputDevice,
+        getInputByteFrequencyData,
+        getOutputByteFrequencyData,
+        getInputVolume,
+        getOutputVolume,
+        getId,
+    }), [
+        ctx.startSession,
+        ctx.endSession,
+        sendUserMessage,
+        sendContextualUpdate,
+        sendUserActivity,
+        sendMCPToolApprovalResult,
+        setVolume,
+        changeInputDevice,
+        changeOutputDevice,
+        getInputByteFrequencyData,
+        getOutputByteFrequencyData,
+        getInputVolume,
+        getOutputVolume,
+        getId,
+    ]);
+    return (_jsx(ConversationControlsContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns stable action references for controlling the conversation.
+ * All function references are stable and will never cause re-renders.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversationControls() {
+    const ctx = useContext(ConversationControlsContext);
+    if (!ctx) {
+        throw new Error("useConversationControls must be used within a ConversationProvider");
+    }
+    return ctx;
+}
+//# sourceMappingURL=ConversationControls.js.map

package/dist/conversation/ConversationControls.js.map

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

package/dist/conversation/ConversationFeedback.d.ts

@@ -0,0 +1,19 @@
+export type ConversationFeedbackValue = {
+    canSendFeedback: boolean;
+    sendFeedback: (like: boolean) => void;
+};
+/**
+ * Reads from `ConversationContext` and registers an `onCanSendFeedbackChange`
+ * callback. Manages its own `canSendFeedback` state and provides it along with
+ * a `sendFeedback` action through `ConversationFeedbackContext`.
+ * Must be rendered inside a `ConversationProvider`.
+ */
+export declare function ConversationFeedbackProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the current feedback state and a `sendFeedback` action.
+ * Re-renders only when `canSendFeedback` changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversationFeedback(): ConversationFeedbackValue;
+//# sourceMappingURL=ConversationFeedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationFeedback.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationFeedback.tsx"],"names":[],"mappings":"AASA,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,yBAAyB,CAQnE"}

package/dist/conversation/ConversationFeedback.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useState, } from "react";
+import { useRawConversationRef, useRegisterCallbacks } from "./ConversationContext";
+const ConversationFeedbackContext = createContext(null);
+/**
+ * Reads from `ConversationContext` and registers an `onCanSendFeedbackChange`
+ * callback. Manages its own `canSendFeedback` state and provides it along with
+ * a `sendFeedback` action through `ConversationFeedbackContext`.
+ * Must be rendered inside a `ConversationProvider`.
+ */
+export function ConversationFeedbackProvider({ children, }) {
+    const conversationRef = useRawConversationRef();
+    const [canSendFeedback, setCanSendFeedback] = useState(false);
+    useRegisterCallbacks({
+        onCanSendFeedbackChange({ canSendFeedback: newValue }) {
+            setCanSendFeedback(newValue);
+        },
+        onDisconnect() {
+            setCanSendFeedback(false);
+        },
+    });
+    const sendFeedback = useCallback((like) => {
+        conversationRef.current?.sendFeedback(like);
+    }, [conversationRef]);
+    const value = useMemo(() => ({
+        canSendFeedback,
+        sendFeedback,
+    }), [canSendFeedback, sendFeedback]);
+    return (_jsx(ConversationFeedbackContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns the current feedback state and a `sendFeedback` action.
+ * Re-renders only when `canSendFeedback` changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversationFeedback() {
+    const ctx = useContext(ConversationFeedbackContext);
+    if (!ctx) {
+        throw new Error("useConversationFeedback must be used within a ConversationProvider");
+    }
+    return ctx;
+}
+//# sourceMappingURL=ConversationFeedback.js.map

package/dist/conversation/ConversationFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationFeedback.js","sourceRoot":"","sources":["../../src/conversation/ConversationFeedback.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAOpF,MAAM,2BAA2B,GAC/B,aAAa,CAAmC,IAAI,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAC3C,QAAQ,GACgB;IACxB,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;IAChD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9D,oBAAoB,CAAC;QACnB,uBAAuB,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE;YACnD,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,YAAY;YACV,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,IAAa,EAAE,EAAE;QACjD,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,eAAe;QACf,YAAY;KACb,CAAC,EACF,CAAC,eAAe,EAAE,YAAY,CAAC,CAChC,CAAC;IAEF,OAAO,CACL,KAAC,2BAA2B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC/C,QAAQ,GAC4B,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conversation/ConversationInput.d.ts

@@ -0,0 +1,18 @@
+export type ConversationInputValue = {
+    isMuted: boolean;
+    setMuted: (isMuted: boolean) => void;
+};
+/**
+ * Reads from `ConversationContext` and manages microphone mute state.
+ * `setMuted` calls `conversation.setMicMuted()` and updates local state.
+ * Must be rendered inside a `ConversationProvider`.
+ */
+export declare function ConversationInputProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the current microphone mute state and a function to change it.
+ * Re-renders only when the mute state changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversationInput(): ConversationInputValue;
+//# sourceMappingURL=ConversationInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationInput.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationInput.tsx"],"names":[],"mappings":"AAYA,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,sBAAsB,CAQ7D"}

package/dist/conversation/ConversationInput.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useState, } from "react";
+import { useRawConversationRef, useRegisterCallbacks, } from "./ConversationContext";
+const ConversationInputContext = createContext(null);
+/**
+ * Reads from `ConversationContext` and manages microphone mute state.
+ * `setMuted` calls `conversation.setMicMuted()` and updates local state.
+ * Must be rendered inside a `ConversationProvider`.
+ */
+export function ConversationInputProvider({ children, }) {
+    const conversationRef = useRawConversationRef();
+    const [isMuted, setIsMuted] = useState(false);
+    useRegisterCallbacks({
+        onDisconnect() { setIsMuted(false); },
+    });
+    const setMuted = useCallback((muted) => {
+        const conversation = conversationRef.current;
+        if (!conversation) {
+            throw new Error("No active conversation. Call startSession() first.");
+        }
+        conversation.setMicMuted(muted);
+        setIsMuted(muted);
+    }, [conversationRef]);
+    const value = useMemo(() => ({ isMuted, setMuted }), [isMuted, setMuted]);
+    return (_jsx(ConversationInputContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns the current microphone mute state and a function to change it.
+ * Re-renders only when the mute state changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversationInput() {
+    const ctx = useContext(ConversationInputContext);
+    if (!ctx) {
+        throw new Error("useConversationInput must be used within a ConversationProvider");
+    }
+    return ctx;
+}
+//# sourceMappingURL=ConversationInput.js.map

package/dist/conversation/ConversationInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationInput.js","sourceRoot":"","sources":["../../src/conversation/ConversationInput.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAO/B,MAAM,wBAAwB,GAAG,aAAa,CAC5C,IAAI,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACxC,QAAQ,GACgB;IACxB,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,oBAAoB,CAAC;QACnB,YAAY,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACtC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC;QAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,eAAe,CAAC,CAClB,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAC7B,CAAC,OAAO,EAAE,QAAQ,CAAC,CACpB,CAAC;IAEF,OAAO,CACL,KAAC,wBAAwB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC5C,QAAQ,GACyB,CACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conversation/ConversationMode.d.ts

@@ -0,0 +1,19 @@
+export type ConversationModeValue = {
+    mode: "speaking" | "listening";
+    isSpeaking: boolean;
+    isListening: boolean;
+};
+/**
+ * Reads from `ConversationContext` and registers an `onModeChange` callback.
+ * Manages its own `mode` state and provides it through
+ * `ConversationModeContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export declare function ConversationModeProvider({ children, }: React.PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the current conversation mode (speaking/listening) and
+ * convenience booleans. Re-renders only when the mode changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export declare function useConversationMode(): ConversationModeValue;
+//# sourceMappingURL=ConversationMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMode.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationMode.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,2CA0BzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,CAQ3D"}

package/dist/conversation/ConversationMode.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useState } from "react";
+import { useRegisterCallbacks } from "./ConversationContext";
+const ConversationModeContext = createContext(null);
+/**
+ * Reads from `ConversationContext` and registers an `onModeChange` callback.
+ * Manages its own `mode` state and provides it through
+ * `ConversationModeContext`. Must be rendered inside a `ConversationProvider`.
+ */
+export function ConversationModeProvider({ children, }) {
+    const [mode, setMode] = useState("listening");
+    useRegisterCallbacks({
+        onModeChange({ mode: newMode }) {
+            setMode(newMode);
+        },
+        onDisconnect() {
+            setMode("listening");
+        },
+    });
+    const value = useMemo(() => ({
+        mode,
+        isSpeaking: mode === "speaking",
+        isListening: mode === "listening",
+    }), [mode]);
+    return (_jsx(ConversationModeContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns the current conversation mode (speaking/listening) and
+ * convenience booleans. Re-renders only when the mode changes.
+ *
+ * Must be used within a `ConversationProvider`.
+ */
+export function useConversationMode() {
+    const ctx = useContext(ConversationModeContext);
+    if (!ctx) {
+        throw new Error("useConversationMode must be used within a ConversationProvider");
+    }
+    return ctx;
+}
+//# sourceMappingURL=ConversationMode.js.map

package/dist/conversation/ConversationMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMode.js","sourceRoot":"","sources":["../../src/conversation/ConversationMode.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,MAAM,uBAAuB,GAAG,aAAa,CAC3C,IAAI,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,QAAQ,GACgB;IACxB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAO,WAAW,CAAC,CAAC;IAEpD,oBAAoB,CAAC;QACnB,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;YAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QACD,YAAY;YACV,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,IAAI;QACJ,UAAU,EAAE,IAAI,KAAK,UAAU;QAC/B,WAAW,EAAE,IAAI,KAAK,WAAW;KAClC,CAAC,EACF,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC3C,QAAQ,GACwB,CACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conversation/ConversationProvider.d.ts

@@ -0,0 +1,4 @@
+import { type HookOptions } from "./types";
+export type ConversationProviderProps = React.PropsWithChildren<HookOptions>;
+export declare function ConversationProvider({ children, ...defaultOptions }: ConversationProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationProvider.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationProvider.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AA0B3C,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAE7E,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,GAAG,cAAc,EAClB,EAAE,yBAAyB,2CA8J3B"}