@shogo-ai/voice 1.10.0 → 2.4.1

package/dist/react/index.d.cts

@@ -1,36 +1,13 @@
-import { B as BaseVoiceConversationOptions, a as BaseVoiceConversationResult, b as BaseChatConversationOptions, c as BaseChatConversationResult, O as OrganicSphereConfig, d as OrganicParticlesConfig } from '../organicParticlesShaders-DIva0vBO.cjs';
-export { e as BandReactivity, C as ChatClientToolFn, f as ChatConversationStatus, g as ChatToolDescriptor, D as DEFAULT_ORGANIC_PARTICLES_CONFIG, h as DEFAULT_ORGANIC_SPHERE_CONFIG, i as ORGANIC_PARTICLES_FRAGMENT_SHADER, j as ORGANIC_PARTICLES_VERTEX_SHADER, k as ORGANIC_SPHERE_FRAGMENT_SHADER, l as ORGANIC_SPHERE_VERTEX_SHADER, P as PERLIN_4D, r as resolveOrganicParticlesConfig, m as resolveOrganicSphereConfig } from '../organicParticlesShaders-DIva0vBO.cjs';
-import * as React from 'react';
-import React__default from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UseVoiceConversationOptions, UseVoiceConversationResult } from './conversation.cjs';
+export { LiveDelegationRequest, LiveTranscriptTurn, LiveVoiceSessionResponse, ShogoVoiceProvider, ShogoVoiceProviderProps, UseLiveVoiceConversationOptions, UseLiveVoiceConversationResult, useLiveVoiceConversation, useVoiceConversation } from './conversation.cjs';
+import { B as BaseChatConversationOptions, a as BaseChatConversationResult } from '../organicParticlesShaders-seZq7jYX.cjs';
+export { C as ChatClientToolFn, b as ChatConversationStatus, c as ChatToolDescriptor, O as ORGANIC_PARTICLES_FRAGMENT_SHADER, d as ORGANIC_PARTICLES_VERTEX_SHADER, e as ORGANIC_SPHERE_FRAGMENT_SHADER, f as ORGANIC_SPHERE_VERTEX_SHADER, P as PERLIN_4D } from '../organicParticlesShaders-seZq7jYX.cjs';
+export { OrganicParticles, OrganicParticlesProps, OrganicSphere, OrganicSphereProps } from './visuals.cjs';
+export { B as BandReactivity, D as DEFAULT_ORGANIC_PARTICLES_CONFIG, a as DEFAULT_ORGANIC_SPHERE_CONFIG, O as OrganicParticlesConfig, b as OrganicSphereConfig, r as resolveOrganicParticlesConfig, c as resolveOrganicSphereConfig } from '../particlesConfig-0YbdPOdY.cjs';
+import '../types-Bfhu-aQH.cjs';
+import 'react';
 import 'ai';
-
-/**
- * `useVoiceConversation` (web) — drop-in React hook wrapping
- * `@elevenlabs/react`'s `useConversation` with batteries included:
- *
- *   1. Fetches a signed URL from the consumer's server (default: `/api/voice/signed-url`).
- *   2. Registers the canonical `add_memory` client tool (POST-es to `/api/memory/add`).
- *   3. Auto-injects relevant memory as a contextual update on each user message
- *      (POST `/api/memory/retrieve`).
- *   4. Accumulates a plain-text transcript and calls `onTranscript` on disconnect,
- *      plus a `pagehide` `navigator.sendBeacon` fallback so nothing is lost on
- *      tab close.
- *
- * Consumers can mix in additional `clientTools` and override every path.
- *
- * Requires the caller's app to have `@elevenlabs/react` installed (optional
- * peer dependency). For React Native, import from
- * `@shogo-ai/sdk/voice/native` instead.
- */
-
-type UseVoiceConversationOptions = BaseVoiceConversationOptions;
-type UseVoiceConversationResult = BaseVoiceConversationResult;
-/**
- * Hook that owns the voice session lifecycle end-to-end. See module docblock
- * for the wire format of the various server endpoints.
- */
-declare function useVoiceConversation(options: UseVoiceConversationOptions): UseVoiceConversationResult;
+import 'react/jsx-runtime';
 
 /**
  * `useShogoVoice` — zero-config voice hook for generated pod apps.
@@ -312,112 +289,4 @@ declare function useChatConversation(options?: UseChatConversationOptions): UseC
 type UseShogoChatOptions = Partial<UseChatConversationOptions>;
 declare function useShogoChat(opts?: UseShogoChatOptions): UseChatConversationResult;
 
-/**
- * `ShogoVoiceProvider` — root provider that every `useShogoVoice` /
- * `useVoiceConversation` caller needs to live under.
- *
- * Why this exists
- * ---------------
- * `@elevenlabs/react` ≥ 1.1 split `useConversation` into a
- * provider-backed API: every caller of the hook (and therefore every
- * caller of our `useVoiceConversation` / `useShogoVoice` wrapper) must
- * have a `<ConversationProvider>` somewhere above it in the tree.
- * Without it the underlying `useRegisterCallbacks` throws:
- *
- *   useRegisterCallbacks must be used within a ConversationProvider
- *
- * Re-exporting the provider here keeps consumer code free of a direct
- * `@elevenlabs/react` import — pods only ever import from
- * `@shogo-ai/sdk/voice/react`, which means we can swap providers (or
- * upgrade across breaking versions) without touching every app.
- *
- * Usage
- * -----
- * Wrap the SDK's voice-aware tree once, near the root of your app:
- *
- * ```tsx
- * import { ShogoVoiceProvider } from '@shogo-ai/sdk/voice/react'
- *
- * export default function Root({ children }: { children: React.ReactNode }) {
- *   return <ShogoVoiceProvider>{children}</ShogoVoiceProvider>
- * }
- * ```
- *
- * One provider is enough for an entire app — sibling components that
- * use the voice hook share the same underlying convai session context.
- * Mounting multiple providers is supported but isolates their
- * sessions, so do that intentionally (e.g. two completely separate
- * voice surfaces in one shell).
- */
-
-interface ShogoVoiceProviderProps {
-    children: React.ReactNode;
-}
-declare function ShogoVoiceProvider(props: ShogoVoiceProviderProps): React.ReactElement;
-
-interface OrganicSphereProps {
-    /**
-     * Returns the current agent-output frequency buffer (length = fftSize,
-     * values 0–255). Typically `useVoiceConversation().getOutputByteFrequencyData`.
-     *
-     * Can also be pointed at `analyserNode.getByteFrequencyData` from any
-     * WebAudio graph for non-ElevenLabs callers.
-     */
-    getFrequencyData?: () => Uint8Array | null;
-    /**
-     * Whether audio is live. When `false` the sphere settles into its
-     * idle pose (no pulsing). Purely cosmetic — the component keeps the
-     * render loop running either way.
-     *
-     * @default true
-     */
-    active?: boolean;
-    /**
-     * Full configuration object (partial). Any unspecified keys fall back
-     * to `DEFAULT_ORGANIC_SPHERE_CONFIG`. Individual convenience props
-     * below (e.g. `lightAColor`) take precedence over the same key inside
-     * `config`, so you can combine a base preset with a single override.
-     */
-    config?: Partial<OrganicSphereConfig>;
-    /** Overrides `config.lightAColor`. */
-    lightAColor?: string;
-    /** Overrides `config.lightBColor`. */
-    lightBColor?: string;
-    /** Overrides `config.rimColor`. */
-    rimColor?: string;
-    /** Overrides `config.rimThreshold`. */
-    rimThreshold?: number;
-    /** Overrides `config.rimPower`. */
-    rimPower?: number;
-    /** Overrides `config.backgroundColor`. */
-    backgroundColor?: string | null;
-    /** Overrides `config.subdivisions` (re-init on change). */
-    subdivisions?: number;
-    /** Overrides `config.maxPixelRatio` (re-init on change). */
-    maxPixelRatio?: number;
-    /**
-     * Extra classes merged onto the wrapping `<div>`. Size the parent
-     * element; the canvas fills it.
-     */
-    className?: string;
-    /** Inline style override for the wrapping `<div>`. */
-    style?: React__default.CSSProperties;
-}
-/**
- * Audio-reactive organic sphere. See the module docblock for usage.
- */
-declare function OrganicSphere({ getFrequencyData, active, config: configProp, lightAColor, lightBColor, rimColor, rimThreshold, rimPower, backgroundColor, subdivisions, maxPixelRatio, className, style, }: OrganicSphereProps): react_jsx_runtime.JSX.Element;
-
-interface OrganicParticlesProps {
-    getFrequencyData?: () => Uint8Array | null;
-    active?: boolean;
-    config?: Partial<OrganicParticlesConfig>;
-    className?: string;
-    style?: React__default.CSSProperties;
-}
-/**
- * Audio-reactive particle cloud. See the module docblock for usage.
- */
-declare function OrganicParticles({ getFrequencyData, active, config: configProp, className, style, }: OrganicParticlesProps): react_jsx_runtime.JSX.Element;
-
-export { BaseChatConversationOptions, BaseChatConversationResult, OrganicParticles, OrganicParticlesConfig, type OrganicParticlesProps, OrganicSphere, OrganicSphereConfig, type OrganicSphereProps, ShogoVoiceProvider, type ShogoVoiceProviderProps, type UseChatConversationOptions, type UseChatConversationResult, type UseShogoChatOptions, type UseShogoVoiceOptions, type UseVoiceConversationOptions, type UseVoiceConversationResult, useChatConversation, useShogoChat, useShogoVoice, useVoiceConversation };
+export { BaseChatConversationOptions, BaseChatConversationResult, type UseChatConversationOptions, type UseChatConversationResult, type UseShogoChatOptions, type UseShogoVoiceOptions, UseVoiceConversationOptions, UseVoiceConversationResult, useChatConversation, useShogoChat, useShogoVoice };

package/dist/react/index.d.ts

@@ -1,36 +1,13 @@
-import { B as BaseVoiceConversationOptions, a as BaseVoiceConversationResult, b as BaseChatConversationOptions, c as BaseChatConversationResult, O as OrganicSphereConfig, d as OrganicParticlesConfig } from '../organicParticlesShaders-DIva0vBO.js';
-export { e as BandReactivity, C as ChatClientToolFn, f as ChatConversationStatus, g as ChatToolDescriptor, D as DEFAULT_ORGANIC_PARTICLES_CONFIG, h as DEFAULT_ORGANIC_SPHERE_CONFIG, i as ORGANIC_PARTICLES_FRAGMENT_SHADER, j as ORGANIC_PARTICLES_VERTEX_SHADER, k as ORGANIC_SPHERE_FRAGMENT_SHADER, l as ORGANIC_SPHERE_VERTEX_SHADER, P as PERLIN_4D, r as resolveOrganicParticlesConfig, m as resolveOrganicSphereConfig } from '../organicParticlesShaders-DIva0vBO.js';
-import * as React from 'react';
-import React__default from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UseVoiceConversationOptions, UseVoiceConversationResult } from './conversation.js';
+export { LiveDelegationRequest, LiveTranscriptTurn, LiveVoiceSessionResponse, ShogoVoiceProvider, ShogoVoiceProviderProps, UseLiveVoiceConversationOptions, UseLiveVoiceConversationResult, useLiveVoiceConversation, useVoiceConversation } from './conversation.js';
+import { B as BaseChatConversationOptions, a as BaseChatConversationResult } from '../organicParticlesShaders-seZq7jYX.js';
+export { C as ChatClientToolFn, b as ChatConversationStatus, c as ChatToolDescriptor, O as ORGANIC_PARTICLES_FRAGMENT_SHADER, d as ORGANIC_PARTICLES_VERTEX_SHADER, e as ORGANIC_SPHERE_FRAGMENT_SHADER, f as ORGANIC_SPHERE_VERTEX_SHADER, P as PERLIN_4D } from '../organicParticlesShaders-seZq7jYX.js';
+export { OrganicParticles, OrganicParticlesProps, OrganicSphere, OrganicSphereProps } from './visuals.js';
+export { B as BandReactivity, D as DEFAULT_ORGANIC_PARTICLES_CONFIG, a as DEFAULT_ORGANIC_SPHERE_CONFIG, O as OrganicParticlesConfig, b as OrganicSphereConfig, r as resolveOrganicParticlesConfig, c as resolveOrganicSphereConfig } from '../particlesConfig-0YbdPOdY.js';
+import '../types-Bfhu-aQH.js';
+import 'react';
 import 'ai';
-
-/**
- * `useVoiceConversation` (web) — drop-in React hook wrapping
- * `@elevenlabs/react`'s `useConversation` with batteries included:
- *
- *   1. Fetches a signed URL from the consumer's server (default: `/api/voice/signed-url`).
- *   2. Registers the canonical `add_memory` client tool (POST-es to `/api/memory/add`).
- *   3. Auto-injects relevant memory as a contextual update on each user message
- *      (POST `/api/memory/retrieve`).
- *   4. Accumulates a plain-text transcript and calls `onTranscript` on disconnect,
- *      plus a `pagehide` `navigator.sendBeacon` fallback so nothing is lost on
- *      tab close.
- *
- * Consumers can mix in additional `clientTools` and override every path.
- *
- * Requires the caller's app to have `@elevenlabs/react` installed (optional
- * peer dependency). For React Native, import from
- * `@shogo-ai/sdk/voice/native` instead.
- */
-
-type UseVoiceConversationOptions = BaseVoiceConversationOptions;
-type UseVoiceConversationResult = BaseVoiceConversationResult;
-/**
- * Hook that owns the voice session lifecycle end-to-end. See module docblock
- * for the wire format of the various server endpoints.
- */
-declare function useVoiceConversation(options: UseVoiceConversationOptions): UseVoiceConversationResult;
+import 'react/jsx-runtime';
 
 /**
  * `useShogoVoice` — zero-config voice hook for generated pod apps.
@@ -312,112 +289,4 @@ declare function useChatConversation(options?: UseChatConversationOptions): UseC
 type UseShogoChatOptions = Partial<UseChatConversationOptions>;
 declare function useShogoChat(opts?: UseShogoChatOptions): UseChatConversationResult;
 
-/**
- * `ShogoVoiceProvider` — root provider that every `useShogoVoice` /
- * `useVoiceConversation` caller needs to live under.
- *
- * Why this exists
- * ---------------
- * `@elevenlabs/react` ≥ 1.1 split `useConversation` into a
- * provider-backed API: every caller of the hook (and therefore every
- * caller of our `useVoiceConversation` / `useShogoVoice` wrapper) must
- * have a `<ConversationProvider>` somewhere above it in the tree.
- * Without it the underlying `useRegisterCallbacks` throws:
- *
- *   useRegisterCallbacks must be used within a ConversationProvider
- *
- * Re-exporting the provider here keeps consumer code free of a direct
- * `@elevenlabs/react` import — pods only ever import from
- * `@shogo-ai/sdk/voice/react`, which means we can swap providers (or
- * upgrade across breaking versions) without touching every app.
- *
- * Usage
- * -----
- * Wrap the SDK's voice-aware tree once, near the root of your app:
- *
- * ```tsx
- * import { ShogoVoiceProvider } from '@shogo-ai/sdk/voice/react'
- *
- * export default function Root({ children }: { children: React.ReactNode }) {
- *   return <ShogoVoiceProvider>{children}</ShogoVoiceProvider>
- * }
- * ```
- *
- * One provider is enough for an entire app — sibling components that
- * use the voice hook share the same underlying convai session context.
- * Mounting multiple providers is supported but isolates their
- * sessions, so do that intentionally (e.g. two completely separate
- * voice surfaces in one shell).
- */
-
-interface ShogoVoiceProviderProps {
-    children: React.ReactNode;
-}
-declare function ShogoVoiceProvider(props: ShogoVoiceProviderProps): React.ReactElement;
-
-interface OrganicSphereProps {
-    /**
-     * Returns the current agent-output frequency buffer (length = fftSize,
-     * values 0–255). Typically `useVoiceConversation().getOutputByteFrequencyData`.
-     *
-     * Can also be pointed at `analyserNode.getByteFrequencyData` from any
-     * WebAudio graph for non-ElevenLabs callers.
-     */
-    getFrequencyData?: () => Uint8Array | null;
-    /**
-     * Whether audio is live. When `false` the sphere settles into its
-     * idle pose (no pulsing). Purely cosmetic — the component keeps the
-     * render loop running either way.
-     *
-     * @default true
-     */
-    active?: boolean;
-    /**
-     * Full configuration object (partial). Any unspecified keys fall back
-     * to `DEFAULT_ORGANIC_SPHERE_CONFIG`. Individual convenience props
-     * below (e.g. `lightAColor`) take precedence over the same key inside
-     * `config`, so you can combine a base preset with a single override.
-     */
-    config?: Partial<OrganicSphereConfig>;
-    /** Overrides `config.lightAColor`. */
-    lightAColor?: string;
-    /** Overrides `config.lightBColor`. */
-    lightBColor?: string;
-    /** Overrides `config.rimColor`. */
-    rimColor?: string;
-    /** Overrides `config.rimThreshold`. */
-    rimThreshold?: number;
-    /** Overrides `config.rimPower`. */
-    rimPower?: number;
-    /** Overrides `config.backgroundColor`. */
-    backgroundColor?: string | null;
-    /** Overrides `config.subdivisions` (re-init on change). */
-    subdivisions?: number;
-    /** Overrides `config.maxPixelRatio` (re-init on change). */
-    maxPixelRatio?: number;
-    /**
-     * Extra classes merged onto the wrapping `<div>`. Size the parent
-     * element; the canvas fills it.
-     */
-    className?: string;
-    /** Inline style override for the wrapping `<div>`. */
-    style?: React__default.CSSProperties;
-}
-/**
- * Audio-reactive organic sphere. See the module docblock for usage.
- */
-declare function OrganicSphere({ getFrequencyData, active, config: configProp, lightAColor, lightBColor, rimColor, rimThreshold, rimPower, backgroundColor, subdivisions, maxPixelRatio, className, style, }: OrganicSphereProps): react_jsx_runtime.JSX.Element;
-
-interface OrganicParticlesProps {
-    getFrequencyData?: () => Uint8Array | null;
-    active?: boolean;
-    config?: Partial<OrganicParticlesConfig>;
-    className?: string;
-    style?: React__default.CSSProperties;
-}
-/**
- * Audio-reactive particle cloud. See the module docblock for usage.
- */
-declare function OrganicParticles({ getFrequencyData, active, config: configProp, className, style, }: OrganicParticlesProps): react_jsx_runtime.JSX.Element;
-
-export { BaseChatConversationOptions, BaseChatConversationResult, OrganicParticles, OrganicParticlesConfig, type OrganicParticlesProps, OrganicSphere, OrganicSphereConfig, type OrganicSphereProps, ShogoVoiceProvider, type ShogoVoiceProviderProps, type UseChatConversationOptions, type UseChatConversationResult, type UseShogoChatOptions, type UseShogoVoiceOptions, type UseVoiceConversationOptions, type UseVoiceConversationResult, useChatConversation, useShogoChat, useShogoVoice, useVoiceConversation };
+export { BaseChatConversationOptions, BaseChatConversationResult, type UseChatConversationOptions, type UseChatConversationResult, type UseShogoChatOptions, type UseShogoVoiceOptions, UseVoiceConversationOptions, UseVoiceConversationResult, useChatConversation, useShogoChat, useShogoVoice };