@juspay/neurolink 9.66.0 → 9.67.1

package/dist/lib/types/avatar.d.ts

@@ -20,6 +20,13 @@ export type AvatarVideoFormat = "mp4" | "webm" | "mov";
  *   - MuseTalk (Replicate): single quality only; "hd" is no-op
  */
 export type AvatarQuality = "standard" | "hd";
+/**
+ * Known avatar provider identifiers shipped with NeuroLink.
+ *
+ * `(string & {})` keeps the union open for custom provider names
+ * registered via `AvatarProcessor.registerHandler()`.
+ */
+export type AvatarProviderName = "d-id" | "heygen" | "replicate" | "musetalk" | (string & {});
 /**
  * Options for avatar video generation.
  */
@@ -42,7 +49,7 @@ export type AvatarOptions = {
     /** Voice id passed through to the TTS provider when `text` is used. */
     voice?: string;
     /** Avatar provider override (e.g. "d-id", "heygen", "replicate"). */
-    provider?: string;
+    provider?: AvatarProviderName;
     /** Output quality preset. */
     quality?: AvatarQuality;
     /** Output format (default: "mp4"). */

package/dist/lib/types/index.d.ts

@@ -35,6 +35,7 @@ export * from "./middleware.js";
 export * from "./model.js";
 export * from "./multimodal.js";
 export * from "./observability.js";
+export * from "./openaiCompatible.js";
 export * from "./ppt.js";
 export * from "./processor.js";
 export * from "./providers.js";

package/dist/lib/types/index.js

@@ -36,6 +36,7 @@ export * from "./middleware.js";
 export * from "./model.js";
 export * from "./multimodal.js";
 export * from "./observability.js";
+export * from "./openaiCompatible.js";
 export * from "./ppt.js";
 export * from "./processor.js";
 export * from "./providers.js";

package/dist/lib/types/middleware.d.ts

@@ -3,7 +3,7 @@ import type { EvaluationData, GetPromptFunction } from "./evaluation.js";
 import type { AuthenticatedUser, RouteDefinition, ServerContext } from "./server.js";
 import type { LanguageModelMiddleware as BaseLanguageModelMiddleware } from "ai";
 export type { LanguageModelMiddleware } from "ai";
-export type { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3Message, LanguageModelV3StreamPart, LanguageModelV3ToolCall, LanguageModelV3ToolChoice, LanguageModelV3Source, LanguageModelV3Middleware, JSONSchema7, } from "@ai-sdk/provider";
+export type { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3Message, LanguageModelV3Prompt, LanguageModelV3StreamPart, LanguageModelV3ToolCall, LanguageModelV3ToolChoice, LanguageModelV3Source, LanguageModelV3Middleware, JSONSchema7, } from "@ai-sdk/provider";
 import type { LanguageModelV3 } from "@ai-sdk/provider";
 export type LanguageModelV3GenerateResult = Awaited<ReturnType<LanguageModelV3["doGenerate"]>>;
 export type LanguageModelV3StreamResult = Awaited<ReturnType<LanguageModelV3["doStream"]>>;

package/dist/lib/types/multimodal.d.ts

@@ -124,6 +124,13 @@ export type AudioContent = {
         language?: string;
     };
 };
+/**
+ * Known video provider identifiers shipped with NeuroLink.
+ *
+ * `(string & {})` keeps the union open for custom provider names
+ * registered via `VideoProcessor.registerHandler()`.
+ */
+export type VideoProviderName = "vertex" | "kling" | "runway" | "replicate" | (string & {});
 /**
  * Video output configuration options for video generation
  *
@@ -148,14 +155,15 @@ export type VideoOutputOptions = {
      */
     abortSignal?: AbortSignal;
     /**
-     * Override the video-gen provider. Defaults to "vertex" or to the LLM
-     * provider name if it is also a registered video handler.
+     * Override the video-gen provider. Defaults to `"vertex"` when omitted.
      *
      * Registered providers are managed via `VideoProcessor.registerHandler`
-     * (see src/lib/utils/videoProcessor.ts). Examples: "vertex", "kling",
-     * "runway", "replicate".
+     * (see src/lib/utils/videoProcessor.ts). Examples: `"vertex"`, `"kling"`,
+     * `"runway"`, `"replicate"`. An unknown provider throws
+     * `VIDEO_ERROR_CODES.PROVIDER_NOT_SUPPORTED` — there is no implicit
+     * fallback to the LLM provider name.
      */
-    provider?: string;
+    provider?: VideoProviderName;
     /**
      * Specific model to use within the provider. Provider-specific shape
      * (e.g. "veo-3.1-generate-001" for vertex; "atonamy/wan-alpha:..." for
@@ -164,8 +172,13 @@ export type VideoOutputOptions = {
     model?: string;
     /** Output resolution - "720p" (1280x720) or "1080p" (1920x1080) */
     resolution?: "720p" | "1080p";
-    /** Video duration in seconds (4, 6, or 8 seconds supported) */
-    length?: 4 | 6 | 8;
+    /**
+     * Video duration in seconds. Provider-specific support — Vertex Veo
+     * accepts 4 / 6 / 8 s, Kling and Runway accept 5 / 10 s, Replicate is
+     * model-specific. The type intentionally enumerates the common shipped
+     * values; pass any other positive number for custom Replicate models.
+     */
+    length?: 4 | 5 | 6 | 8 | 10 | (number & {});
     /** Aspect ratio - "9:16" for portrait, "16:9" for landscape, "1:1" for square */
     aspectRatio?: "9:16" | "16:9" | "1:1";
     /** Enable audio generation (default: true) */

package/dist/lib/types/music.d.ts

@@ -27,6 +27,13 @@ export type MusicGenre = string;
  * "mysterious", "romantic", "epic".
  */
 export type MusicMood = string;
+/**
+ * Known music provider identifiers shipped with NeuroLink.
+ *
+ * `(string & {})` keeps the union open for custom provider names
+ * registered via `MusicProcessor.registerHandler()`.
+ */
+export type MusicProviderName = "beatoven" | "elevenlabs-music" | "elevenlabs-sound" | "lyria" | "replicate" | "musicgen" | (string & {});
 /**
  * Options for music generation requests.
  */
@@ -44,7 +51,7 @@ export type MusicOptions = {
     /** Tempo in BPM (provider-specific support). */
     tempo?: number;
     /** Override the music provider (e.g. "beatoven", "elevenlabs-music", "lyria", "replicate"). */
-    provider?: string;
+    provider?: MusicProviderName;
     /** Reference audio for melody / style guidance (Buffer or path). */
     referenceAudio?: Buffer | string;
     /** Output file path (optional — buffer is always returned in result). */

package/dist/lib/types/openaiCompatible.d.ts

@@ -0,0 +1,250 @@
+import type { NeuroLinkEvents, TypedEventEmitter } from "./common.js";
+import type { JSONSchema7 } from "./middleware.js";
+import type { LanguageModelV3, LanguageModelV3CallOptions } from "./middleware.js";
+import type { StreamOptions } from "./stream.js";
+import type { Tool } from "./tools.js";
+export type OpenAICompatChatRole = "system" | "user" | "assistant" | "tool";
+export type OpenAICompatTextContent = {
+    type: "text";
+    text: string;
+};
+export type OpenAICompatImageURLContent = {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+};
+export type OpenAICompatMessageContent = OpenAICompatTextContent | OpenAICompatImageURLContent;
+export type OpenAICompatToolCallWire = {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+export type OpenAICompatChatMessage = {
+    role: "system";
+    content: string | OpenAICompatMessageContent[];
+} | {
+    role: "user";
+    content: string | OpenAICompatMessageContent[];
+} | {
+    role: "assistant";
+    content?: string | OpenAICompatMessageContent[] | null;
+    tool_calls?: OpenAICompatToolCallWire[];
+} | {
+    role: "tool";
+    content: string;
+    tool_call_id: string;
+};
+export type OpenAICompatChatTool = {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters: JSONSchema7;
+        strict?: boolean;
+    };
+};
+export type OpenAICompatToolChoiceWire = "auto" | "none" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+export type OpenAICompatResponseFormat = {
+    type: "text";
+} | {
+    type: "json_object";
+} | {
+    type: "json_schema";
+    json_schema: {
+        name: string;
+        schema: JSONSchema7;
+        description?: string;
+        strict?: boolean;
+    };
+};
+export type OpenAICompatChatRequest = {
+    model: string;
+    messages: OpenAICompatChatMessage[];
+    stream?: boolean;
+    stream_options?: {
+        include_usage?: boolean;
+    };
+    max_tokens?: number;
+    max_completion_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    seed?: number;
+    stop?: string[];
+    tools?: OpenAICompatChatTool[];
+    tool_choice?: OpenAICompatToolChoiceWire;
+    response_format?: OpenAICompatResponseFormat;
+    parallel_tool_calls?: boolean;
+    user?: string;
+};
+export type OpenAICompatUsage = {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    prompt_tokens_details?: {
+        cached_tokens?: number;
+    };
+    completion_tokens_details?: {
+        reasoning_tokens?: number;
+    };
+};
+export type OpenAICompatChatChoiceMessage = {
+    role: "assistant";
+    content?: string | null;
+    tool_calls?: OpenAICompatToolCallWire[];
+    refusal?: string | null;
+};
+export type OpenAICompatChatChoice = {
+    index: number;
+    message: OpenAICompatChatChoiceMessage;
+    finish_reason: "stop" | "length" | "tool_calls" | "function_call" | "content_filter" | null;
+};
+export type OpenAICompatChatResponse = {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices: OpenAICompatChatChoice[];
+    usage?: OpenAICompatUsage;
+    system_fingerprint?: string;
+};
+export type OpenAICompatStreamDelta = {
+    role?: OpenAICompatChatRole;
+    content?: string | null;
+    tool_calls?: Array<{
+        index: number;
+        id?: string;
+        type?: "function";
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    }>;
+    refusal?: string | null;
+};
+export type OpenAICompatStreamChunkChoice = {
+    index: number;
+    delta: OpenAICompatStreamDelta;
+    finish_reason: "stop" | "length" | "tool_calls" | "function_call" | "content_filter" | null;
+};
+export type OpenAICompatChatStreamChunk = {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices: OpenAICompatStreamChunkChoice[];
+    usage?: OpenAICompatUsage;
+};
+export type OpenAICompatErrorBody = {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string | number;
+        param?: string | null;
+    };
+};
+export type OpenAICompatConfig = {
+    provider: string;
+    modelId: string;
+    baseURL: string;
+    apiKey?: string;
+    headers?: Record<string, string> | (() => Record<string, string>);
+    fetch?: typeof globalThis.fetch;
+};
+export type OpenAICompatToolWarning = NonNullable<Awaited<ReturnType<LanguageModelV3["doGenerate"]>>["warnings"]>[number];
+export type OpenAICompatV3Content = Awaited<ReturnType<LanguageModelV3["doGenerate"]>>["content"][number];
+export type OpenAICompatV3FinishReason = Awaited<ReturnType<LanguageModelV3["doGenerate"]>>["finishReason"];
+export type OpenAICompatV3Usage = Awaited<ReturnType<LanguageModelV3["doGenerate"]>>["usage"];
+export type OpenAICompatV3StreamPart = Awaited<ReturnType<LanguageModelV3["doStream"]>>["stream"] extends ReadableStream<infer P> ? P : never;
+export type OpenAICompatV3CallTools = NonNullable<LanguageModelV3CallOptions["tools"]>;
+export type OpenAICompatV3CallToolChoice = NonNullable<LanguageModelV3CallOptions["toolChoice"]>;
+export type OpenAICompatUserOrAssistantPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "file";
+    mediaType: string;
+    data: Uint8Array | string | URL;
+    filename?: string;
+};
+export type OpenAICompatMessage = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: unknown;
+    toolCallId?: string;
+    toolName?: string;
+};
+export type OpenAICompatSSEResult = {
+    text: string;
+    toolCalls: Map<number, {
+        id: string;
+        name: string;
+        argsBuffered: string;
+    }>;
+    finishReason: "stop" | "length" | "tool_calls" | "function_call" | "content_filter" | null;
+    usage?: OpenAICompatUsage;
+};
+export type OpenAICompatStreamChunk = {
+    content: string;
+} | {
+    done: true;
+};
+export type ToolExecutionSummaryInternal = {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    output?: unknown;
+    error?: string;
+    startTime: Date;
+    endTime: Date;
+};
+export type StreamLoopArgs = {
+    maxSteps: number;
+    modelId: string;
+    url: string;
+    apiKey: string;
+    fetchImpl: typeof fetch;
+    abortSignal: AbortSignal | undefined;
+    options: StreamOptions;
+    conversation: OpenAICompatChatMessage[];
+    openAITools: OpenAICompatChatTool[] | undefined;
+    openAIToolChoice: OpenAICompatToolChoiceWire | undefined;
+    toolsRecord: Record<string, Tool>;
+    emitter: TypedEventEmitter<NeuroLinkEvents> | undefined;
+    toolsUsed: string[];
+    toolExecutionSummaries: ToolExecutionSummaryInternal[];
+    pushChunk: (chunk: OpenAICompatStreamChunk) => void;
+    resolveUsage: (u: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }) => void;
+    resolveFinish: (reason: string) => void;
+};
+export type OpenAICompatBuildBodyArgs = {
+    modelId: string;
+    messages: OpenAICompatChatMessage[];
+    options: {
+        maxTokens?: number | null;
+        temperature?: number | null;
+        topP?: number | null;
+        presencePenalty?: number | null;
+        frequencyPenalty?: number | null;
+        seed?: number | null;
+        stopSequences?: string[];
+    };
+    tools?: OpenAICompatChatTool[];
+    toolChoice?: OpenAICompatToolChoiceWire;
+    streaming: boolean;
+    responseFormat?: OpenAICompatResponseFormat;
+};

package/dist/lib/types/openaiCompatible.js

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

package/dist/lib/types/tts.d.ts

@@ -17,6 +17,14 @@ export type TTSAudioFormat = "mp3" | "wav" | "ogg" | "opus" | "m4a" | "flac" | "
  * TTS quality settings
  */
 export type TTSQuality = "standard" | "hd";
+/**
+ * Known TTS provider identifiers shipped with NeuroLink.
+ *
+ * The `(string & {})` intersection keeps the union open for custom
+ * provider names registered via `TTSProcessor.registerHandler()` while
+ * still surfacing the built-in choices in editor autocomplete.
+ */
+export type TTSProviderName = "google-ai" | "vertex" | "openai-tts" | "elevenlabs" | "elevenlabs-tts" | "azure-tts" | "fish-audio" | "cartesia" | (string & {});
 /**
  * TTS configuration options
  */
@@ -69,7 +77,7 @@ export type TTSOptions = {
     /** Auto-play audio after generation (default: false) */
     play?: boolean;
     /** Override TTS provider (e.g., "elevenlabs", "openai-tts", "azure-tts") */
-    provider?: string;
+    provider?: TTSProviderName;
 };
 /**
  * TTS audio result returned from generation

package/dist/lib/utils/avatarProcessor.d.ts

@@ -56,7 +56,13 @@ export declare class AvatarProcessor {
      * List the names of all registered providers.
      */
     static listProviders(): string[];
-    private static getHandler;
+    /**
+     * Get a registered avatar handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
+     */
+    static getHandler(providerName: string): AvatarHandler | undefined;
     private static buildSpanAttributes;
     /**
      * Generate an avatar video via the registered handler.

package/dist/lib/utils/avatarProcessor.js

@@ -80,6 +80,12 @@ export class AvatarProcessor {
     static listProviders() {
         return Array.from(this.handlers.keys());
     }
+    /**
+     * Get a registered avatar handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
+     */
     static getHandler(providerName) {
         return this.handlers.get(providerName.toLowerCase());
     }

package/dist/lib/utils/musicProcessor.d.ts

@@ -55,7 +55,13 @@ export declare class MusicProcessor {
      * List the names of all registered providers.
      */
     static listProviders(): string[];
-    private static getHandler;
+    /**
+     * Get a registered music handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
+     */
+    static getHandler(providerName: string): MusicHandler | undefined;
     private static buildSpanAttributes;
     /**
      * Generate a music track via the registered handler.

package/dist/lib/utils/musicProcessor.js

@@ -79,6 +79,12 @@ export class MusicProcessor {
     static listProviders() {
         return Array.from(this.handlers.keys());
     }
+    /**
+     * Get a registered music handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
+     */
     static getHandler(providerName) {
         return this.handlers.get(providerName.toLowerCase());
     }

package/dist/lib/utils/parameterValidation.js

@@ -435,7 +435,11 @@ function toValidationError(error) {
  * Valid video generation options
  */
 const VALID_VIDEO_RESOLUTIONS = ["720p", "1080p"];
-const VALID_VIDEO_LENGTHS = [4, 6, 8];
+// Cross-provider literal whitelist: Vertex Veo uses 4 / 6 / 8 s, Kling and
+// Runway use 5 / 10 s. The handler-level adapter is the source of truth
+// for per-provider rejection (e.g. Runway 400 for length=4); this gate
+// just rejects obviously invalid integers.
+const VALID_VIDEO_LENGTHS = [4, 5, 6, 8, 10];
 const VALID_VIDEO_ASPECT_RATIOS = ["9:16", "16:9"];
 const MAX_VIDEO_PROMPT_LENGTH = 500;
 const MAX_VIDEO_IMAGE_SIZE = 10 * 1024 * 1024; // 10MB

package/dist/lib/utils/sttProcessor.d.ts

@@ -63,13 +63,15 @@ export declare class STTProcessor {
      */
     static registerHandler(providerName: string, handler: STTHandler): void;
     /**
-     * Get a registered STT handler by provider name
+     * Get a registered STT handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
      *
-     * @private
      * @param providerName - Provider identifier
      * @returns Handler instance or undefined if not registered
      */
-    private static getHandler;
+    static getHandler(providerName: string): STTHandler | undefined;
     /**
      * Check if a provider is supported (has a registered STT handler)
      *

package/dist/lib/utils/sttProcessor.js

@@ -80,9 +80,11 @@ export class STTProcessor {
         logger.debug(`[STTProcessor] Registered STT handler for provider: ${normalizedName}`);
     }
     /**
-     * Get a registered STT handler by provider name
+     * Get a registered STT handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
      *
-     * @private
      * @param providerName - Provider identifier
      * @returns Handler instance or undefined if not registered
      */

package/dist/lib/utils/ttsProcessor.d.ts

@@ -90,13 +90,16 @@ export declare class TTSProcessor {
      */
     static registerHandler(providerName: string, handler: TTSHandler): void;
     /**
-     * Get a registered TTS handler by provider name
+     * Get a registered TTS handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases —
+     * see `src/lib/voice/index.ts:registerDefaultTTSHandlers`.
      *
-     * @private
      * @param providerName - Provider identifier
      * @returns Handler instance or undefined if not registered
      */
-    private static getHandler;
+    static getHandler(providerName: string): TTSHandler | undefined;
     /**
      * Check if a provider is supported (has a registered TTS handler)
      *

package/dist/lib/utils/ttsProcessor.js

@@ -107,9 +107,12 @@ export class TTSProcessor {
         logger.debug(`[TTSProcessor] Registered TTS handler for provider: ${normalizedName}`);
     }
     /**
-     * Get a registered TTS handler by provider name
+     * Get a registered TTS handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases —
+     * see `src/lib/voice/index.ts:registerDefaultTTSHandlers`.
      *
-     * @private
      * @param providerName - Provider identifier
      * @returns Handler instance or undefined if not registered
      */

package/dist/lib/voice/RealtimeVoiceAPI.d.ts

@@ -49,9 +49,12 @@ export declare class RealtimeProcessor {
      */
     static registerHandler(providerName: string, handler: RealtimeHandler): void;
     /**
-     * Get a registered Realtime handler by provider name
+     * Get a registered Realtime handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
      */
-    private static getHandler;
+    static getHandler(providerName: string): RealtimeHandler | undefined;
     /**
      * Check if a provider is supported
      */

package/dist/lib/voice/RealtimeVoiceAPI.js

@@ -65,7 +65,10 @@ export class RealtimeProcessor {
         logger.debug(`[RealtimeProcessor] Registered Realtime handler for provider: ${normalizedName}`);
     }
     /**
-     * Get a registered Realtime handler by provider name
+     * Get a registered Realtime handler by provider name.
+     *
+     * Exposed publicly so module-level auto-registration code can reuse an
+     * already-registered primary handler when backfilling its aliases.
      */
     static getHandler(providerName) {
         const normalizedName = providerName.toLowerCase();

package/dist/lib/voice/index.d.ts

@@ -8,6 +8,10 @@
  * Use STTProcessor (src/lib/utils/sttProcessor.ts) for STT.
  * Use RealtimeProcessor for realtime voice sessions.
  *
+ * Importing this module also auto-registers every shipped TTS / STT /
+ * Realtime handler whose backing API key is present in `process.env`.
+ * Registration is idempotent and silently skipped on failure.
+ *
  * @module voice
  */
 export { AUDIO_FORMAT_DETAILS, DEFAULT_REALTIME_CONFIG, DEFAULT_STT_OPTIONS, isSTTResult, isTranscriptionSegment, isValidRealtimeConfig, isValidSTTOptions, REALTIME_ERROR_CODES, STT_ERROR_CODES, VOICE_ERROR_CODES, } from "../types/index.js";
@@ -15,8 +19,11 @@ export { RealtimeError, STTError, VoiceError } from "./errors.js";
 export { BaseRealtimeHandler, RealtimeProcessor } from "./RealtimeVoiceAPI.js";
 export { AUDIO_SIGNATURES, calculateDuration, convertAudioFormat, createPcmBuffer, createWavFile, createWavHeader, detectAudioFormat, extractPcmSamples, getFileExtension, getMimeType, MIME_TYPES, normalizeAudio, resamplePcm, splitIntoChunks, } from "./audio-utils.js";
 export { asyncIterableToStream, ChunkedAudioStream, StreamHandler, StreamMerger, StreamSplitter, streamToAsyncIterable, } from "./stream-handler.js";
+export { GoogleTTSHandler } from "../adapters/tts/googleTTSHandler.js";
 export { AzureTTS, AzureTTS as AzureTTSHandler } from "./providers/AzureTTS.js";
+export { CartesiaTTS, CartesiaTTS as CartesiaTTSHandler, } from "./providers/CartesiaTTS.js";
 export { ElevenLabsTTS, ElevenLabsTTS as ElevenLabsTTSHandler, } from "./providers/ElevenLabsTTS.js";
+export { FishAudioTTS, FishAudioTTS as FishAudioTTSHandler, } from "./providers/FishAudioTTS.js";
 export { OpenAITTS, OpenAITTS as OpenAITTSHandler, } from "./providers/OpenAITTS.js";
 export { AzureSTT, AzureSTT as AzureSTTHandler } from "./providers/AzureSTT.js";
 export { DeepgramSTT, DeepgramSTT as DeepgramSTTHandler, } from "./providers/DeepgramSTT.js";
@@ -24,3 +31,19 @@ export { GoogleSTT, GoogleSTT as GoogleSTTHandler, } from "./providers/GoogleSTT
 export { OpenAISTT, OpenAISTTHandler, WhisperSTT, WhisperSTTHandler, } from "./providers/OpenAISTT.js";
 export { GeminiLive, GeminiLive as GeminiLiveHandler, } from "./providers/GeminiLive.js";
 export { OpenAIRealtime, OpenAIRealtime as OpenAIRealtimeHandler, } from "./providers/OpenAIRealtime.js";
+/**
+ * Register every shipped TTS handler whose backing credentials are
+ * present in the environment. Safe to call multiple times.
+ */
+export declare function registerDefaultTTSHandlers(): void;
+/**
+ * Register every shipped STT handler whose backing credentials are
+ * present in the environment. Safe to call multiple times.
+ */
+export declare function registerDefaultSTTHandlers(): void;
+/**
+ * Register every shipped Realtime handler. Realtime handlers don't gate
+ * registration on isConfigured() because session-time API keys can be
+ * supplied per-call; missing creds surface when `connect()` is invoked.
+ */
+export declare function registerDefaultRealtimeHandlers(): void;