@juspay/neurolink 9.65.2 → 9.67.0

package/dist/lib/index.d.ts

@@ -33,7 +33,6 @@
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 export { BaseFactory, BaseRegistry, NeuroLinkFeatureError, createErrorFactory, withRetry, TypedEventEmitter, } from "./core/infrastructure/index.js";
 export { NeuroLinkClient, createClient, NeuroLinkApiError, NeuroLinkLanguageModel, NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, ErrorCode as ClientErrorCode, NeuroLinkError as ClientNeuroLinkError, HttpError, ClientRateLimitError, ClientValidationError, ClientAuthenticationError, ClientAuthorizationError, NotFoundError, ClientNetworkError, ClientTimeoutError, ClientConnectionError, AbortError, ClientConfigurationError, StreamError, ClientProviderError, ContextLengthError, ContentFilterError, createErrorFromResponse, createErrorFromNative, mapStatusToErrorCode, isRetryableStatus, isRetryableError, isNeuroLinkError, isApiError, } from "./client/index.js";
@@ -52,6 +51,16 @@ export { AvatarProcessor } from "./utils/avatarProcessor.js";
 export { AVATAR_ERROR_CODES, AvatarError } from "./utils/avatarProcessor.js";
 export { MusicProcessor } from "./utils/musicProcessor.js";
 export { MUSIC_ERROR_CODES, MusicError } from "./utils/musicProcessor.js";
+export { STTProcessor } from "./utils/sttProcessor.js";
+export { AzureTTS, AzureTTSHandler, CartesiaTTS, CartesiaTTSHandler, ElevenLabsTTS, ElevenLabsTTSHandler, FishAudioTTS, FishAudioTTSHandler, GoogleTTSHandler, OpenAITTS, OpenAITTSHandler, AzureSTT, AzureSTTHandler, DeepgramSTT, DeepgramSTTHandler, GoogleSTT, GoogleSTTHandler, OpenAISTT, OpenAISTTHandler, WhisperSTT, WhisperSTTHandler, BaseRealtimeHandler, GeminiLive, GeminiLiveHandler, OpenAIRealtime, OpenAIRealtimeHandler, RealtimeProcessor, RealtimeError, STTError, VoiceError, registerDefaultRealtimeHandlers, registerDefaultSTTHandlers, registerDefaultTTSHandlers, } from "./voice/index.js";
+export { BeatovenMusic, BeatovenMusicHandler, ElevenLabsMusic, ElevenLabsMusicHandler, LyriaMusic, LyriaMusicHandler, registerDefaultMusicHandlers, ReplicateMusic, ReplicateMusicHandler, } from "./music/index.js";
+export { DIDAvatar, DIDAvatarHandler, HeyGenAvatar, HeyGenAvatarHandler, registerDefaultAvatarHandlers, ReplicateAvatar, ReplicateAvatarHandler, } from "./avatar/index.js";
+export { KlingVideoHandler } from "./adapters/video/klingVideoHandler.js";
+export { ReplicateVideoHandler } from "./adapters/video/replicateVideoHandler.js";
+export { RunwayVideoHandler } from "./adapters/video/runwayVideoHandler.js";
+export { VertexVideoHandler, isVertexVideoConfigured, } from "./adapters/video/vertexVideoHandler.js";
+export { ImageGenService } from "./image-gen/ImageGenService.js";
+export { HITLManager } from "./hitl/hitlManager.js";
 export { ProviderRegistry } from "./factories/providerRegistry.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };

package/dist/lib/index.js

@@ -34,7 +34,6 @@
 // Core exports
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 // Config Manager export
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 // Core Infrastructure exports (factory + registry patterns)
@@ -81,6 +80,42 @@ export { AVATAR_ERROR_CODES, AvatarError } from "./utils/avatarProcessor.js";
 // Music utilities
 export { MusicProcessor } from "./utils/musicProcessor.js";
 export { MUSIC_ERROR_CODES, MusicError } from "./utils/musicProcessor.js";
+// STT / Realtime processors (registries for speech-to-text + live voice)
+export { STTProcessor } from "./utils/sttProcessor.js";
+// STT_ERROR_CODES is surfaced via the types barrel (export * from "./types/index.js")
+// STTError is re-exported below from the voice/index.js barrel
+// ============================================================================
+// MEDIA HANDLER CLASSES + AUTO-REGISTRATION
+// ============================================================================
+// Re-exporting from the voice/music/avatar barrels also triggers their
+// module-level auto-registration side effects. Consumers who follow the
+// documented `nl.generate(...)` flow get every shipped handler whose API
+// key is present in process.env, with no manual registerHandler() needed.
+// TTS, STT, Realtime handlers + RealtimeProcessor
+export { 
+// TTS
+AzureTTS, AzureTTSHandler, CartesiaTTS, CartesiaTTSHandler, ElevenLabsTTS, ElevenLabsTTSHandler, FishAudioTTS, FishAudioTTSHandler, GoogleTTSHandler, OpenAITTS, OpenAITTSHandler, 
+// STT
+AzureSTT, AzureSTTHandler, DeepgramSTT, DeepgramSTTHandler, GoogleSTT, GoogleSTTHandler, OpenAISTT, OpenAISTTHandler, WhisperSTT, WhisperSTTHandler, 
+// Realtime
+BaseRealtimeHandler, GeminiLive, GeminiLiveHandler, OpenAIRealtime, OpenAIRealtimeHandler, RealtimeProcessor, 
+// Voice error classes (RealtimeError + STTError + VoiceError)
+RealtimeError, STTError, VoiceError, 
+// Auto-registration functions (exposed so consumers can re-run them
+// after mutating process.env at runtime, e.g. in test setups)
+registerDefaultRealtimeHandlers, registerDefaultSTTHandlers, registerDefaultTTSHandlers, } from "./voice/index.js";
+// Music handlers
+export { BeatovenMusic, BeatovenMusicHandler, ElevenLabsMusic, ElevenLabsMusicHandler, LyriaMusic, LyriaMusicHandler, registerDefaultMusicHandlers, ReplicateMusic, ReplicateMusicHandler, } from "./music/index.js";
+// Avatar handlers
+export { DIDAvatar, DIDAvatarHandler, HeyGenAvatar, HeyGenAvatarHandler, registerDefaultAvatarHandlers, ReplicateAvatar, ReplicateAvatarHandler, } from "./avatar/index.js";
+// Video handlers (live under adapters/video; no separate video/ barrel)
+export { KlingVideoHandler } from "./adapters/video/klingVideoHandler.js";
+export { ReplicateVideoHandler } from "./adapters/video/replicateVideoHandler.js";
+export { RunwayVideoHandler } from "./adapters/video/runwayVideoHandler.js";
+export { VertexVideoHandler, isVertexVideoConfigured, } from "./adapters/video/vertexVideoHandler.js";
+// Image generation + HITL — surfaced from their dedicated barrels
+export { ImageGenService } from "./image-gen/ImageGenService.js";
+export { HITLManager } from "./hitl/hitlManager.js";
 // Provider registry (for tests, advanced consumers, and tools that need to
 // invoke registerAllProviders() outside of constructing a NeuroLink instance)
 export { ProviderRegistry } from "./factories/providerRegistry.js";

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

@@ -7,7 +7,21 @@
  * Use `MusicProcessor.generate(provider, options)` to dispatch to the
  * registered handler for `provider`.
  *
+ * Importing this module also auto-registers every shipped music handler
+ * whose backing API key is present in `process.env`. Registration is
+ * idempotent and silently skipped if a provider is already registered or
+ * its constructor throws (e.g. missing optional native dependency).
+ *
  * @module music
  */
 export { MUSIC_ERROR_CODES, MusicError, MusicProcessor, } from "../utils/musicProcessor.js";
 export { BeatovenMusic, BeatovenMusic as BeatovenMusicHandler, } from "./providers/BeatovenMusic.js";
+export { ElevenLabsMusic, ElevenLabsMusic as ElevenLabsMusicHandler, } from "./providers/ElevenLabsMusic.js";
+export { LyriaMusic, LyriaMusic as LyriaMusicHandler, } from "./providers/LyriaMusic.js";
+export { ReplicateMusic, ReplicateMusic as ReplicateMusicHandler, } from "./providers/ReplicateMusic.js";
+/**
+ * Register every shipped music handler whose backing credentials are
+ * present in the environment. Safe to call multiple times — existing
+ * registrations are preserved.
+ */
+export declare function registerDefaultMusicHandlers(): void;

package/dist/lib/music/index.js

@@ -7,8 +7,88 @@
  * Use `MusicProcessor.generate(provider, options)` to dispatch to the
  * registered handler for `provider`.
  *
+ * Importing this module also auto-registers every shipped music handler
+ * whose backing API key is present in `process.env`. Registration is
+ * idempotent and silently skipped if a provider is already registered or
+ * its constructor throws (e.g. missing optional native dependency).
+ *
  * @module music
  */
+import { logger } from "../utils/logger.js";
+import { MusicProcessor } from "../utils/musicProcessor.js";
 export { MUSIC_ERROR_CODES, MusicError, MusicProcessor, } from "../utils/musicProcessor.js";
+// ============================================================================
+// HANDLER CLASSES
+// ============================================================================
 export { BeatovenMusic, BeatovenMusic as BeatovenMusicHandler, } from "./providers/BeatovenMusic.js";
+export { ElevenLabsMusic, ElevenLabsMusic as ElevenLabsMusicHandler, } from "./providers/ElevenLabsMusic.js";
+export { LyriaMusic, LyriaMusic as LyriaMusicHandler, } from "./providers/LyriaMusic.js";
+export { ReplicateMusic, ReplicateMusic as ReplicateMusicHandler, } from "./providers/ReplicateMusic.js";
+// ============================================================================
+// AUTO-REGISTRATION
+// ============================================================================
+import { BeatovenMusic } from "./providers/BeatovenMusic.js";
+import { ElevenLabsMusic } from "./providers/ElevenLabsMusic.js";
+import { LyriaMusic } from "./providers/LyriaMusic.js";
+import { ReplicateMusic } from "./providers/ReplicateMusic.js";
+const MUSIC_HANDLER_CANDIDATES = [
+    { name: "beatoven", factory: () => new BeatovenMusic() },
+    {
+        name: "elevenlabs-music",
+        aliases: ["elevenlabs-sound"],
+        factory: () => new ElevenLabsMusic(),
+    },
+    { name: "lyria", factory: () => new LyriaMusic() },
+    {
+        name: "replicate",
+        aliases: ["musicgen"],
+        factory: () => new ReplicateMusic(),
+    },
+];
+/**
+ * Register every shipped music handler whose backing credentials are
+ * present in the environment. Safe to call multiple times — existing
+ * registrations are preserved.
+ */
+export function registerDefaultMusicHandlers() {
+    for (const { name, aliases, factory } of MUSIC_HANDLER_CANDIDATES) {
+        // Compute missingName / missingAliases separately so a pre-registered
+        // primary doesn't block alias backfill — keeps "musicgen" reachable
+        // when only "replicate" was wired up via another path (and likewise
+        // "elevenlabs-sound" vs "elevenlabs-music").
+        const missingName = !MusicProcessor.supports(name);
+        const missingAliases = (aliases ?? []).filter((alias) => !MusicProcessor.supports(alias));
+        if (!missingName && missingAliases.length === 0) {
+            continue;
+        }
+        try {
+            // Reuse the already-registered primary's handler for alias backfill
+            // when one exists — wiring an alias to a factory-fresh instance
+            // would silently diverge from the canonical primary's config.
+            let handler;
+            if (!missingName) {
+                handler = MusicProcessor.getHandler(name);
+            }
+            if (!handler) {
+                handler = factory();
+                if (!handler.isConfigured()) {
+                    continue;
+                }
+            }
+            if (missingName) {
+                MusicProcessor.registerHandler(name, handler);
+            }
+            for (const alias of missingAliases) {
+                MusicProcessor.registerHandler(alias, handler);
+            }
+        }
+        catch (err) {
+            logger.debug(`[music] ${name} auto-registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+// Run once at module import so consumers who follow the documented
+// `nl.generate(...)` flow get every configured handler without manually
+// calling `registerHandler`.
+registerDefaultMusicHandlers();
 //# sourceMappingURL=index.js.map

package/dist/lib/proxy/modelRouter.d.ts

@@ -1,4 +1,4 @@
-import type { FallbackEntry, ProxyRoutingConfig, RouteResult } from "../types/index.js";
+import type { FallbackEntry, ModelMapping, ProxyRoutingConfig, RouteResult } from "../types/index.js";
 export declare class ModelRouter {
     private readonly mappings;
     private readonly passthrough;
@@ -7,4 +7,8 @@ export declare class ModelRouter {
     resolve(requestedModel: string): RouteResult;
     isClaudeTarget(requestedModel: string): boolean;
     getFallbackChain(): FallbackEntry[];
+    /** Return the raw model mapping entries (used by /v1/models). */
+    getModelMappings(): ModelMapping[];
+    /** Return models configured for passthrough (used by /v1/models). */
+    getPassthroughModels(): string[];
 }

package/dist/lib/proxy/modelRouter.js

@@ -29,5 +29,13 @@ export class ModelRouter {
     getFallbackChain() {
         return this.fallback;
     }
+    /** Return the raw model mapping entries (used by /v1/models). */
+    getModelMappings() {
+        return Array.from(this.mappings.values());
+    }
+    /** Return models configured for passthrough (used by /v1/models). */
+    getPassthroughModels() {
+        return Array.from(this.passthrough);
+    }
 }
 //# sourceMappingURL=modelRouter.js.map

package/dist/lib/proxy/openaiFormat.d.ts

@@ -0,0 +1,137 @@
+/**
+ * OpenAI Chat Completions API format conversion layer.
+ *
+ * Provides a request parser (OpenAI -> NeuroLink), a response serializer
+ * (NeuroLink -> OpenAI), a streaming SSE state machine, and an error
+ * envelope helper.  Together they allow NeuroLink to act as a
+ * drop-in OpenAI API proxy.
+ *
+ * Reference: https://platform.openai.com/docs/api-reference/chat/create
+ */
+import type { ClaudeRequest, ClaudeResponse, InternalResult, OpenAICompletionRequest, OpenAICompletionResponse, OpenAIErrorResponse, ParsedOpenAIRequest, StreamLifecycleState } from "../types/index.js";
+/** Generate a unique chat completion ID in the OpenAI format. */
+export declare function generateChatCompletionId(): string;
+/** Generate an OpenAI-format tool call ID (`call_` + random chars). */
+export declare function generateOpenAIToolCallId(): string;
+/**
+ * Parse an incoming OpenAI Chat Completions request into an intermediate
+ * representation consumable by NeuroLink's generate/stream pipeline.
+ *
+ * Handles:
+ * - System prompt extraction from system messages
+ * - Message flattening (text + image parts)
+ * - Tool definition conversion
+ * - tool_choice mapping
+ * - top_p, temperature, max_tokens pass-through
+ */
+export declare function parseOpenAIRequest(body: OpenAICompletionRequest): ParsedOpenAIRequest;
+/**
+ * Serialize a NeuroLink GenerateResult into an OpenAI Chat Completions response.
+ */
+export declare function serializeOpenAIResponse(result: InternalResult, requestModel: string): OpenAICompletionResponse;
+/**
+ * Build an OpenAI-compatible error envelope.
+ */
+export declare function buildOpenAIError(status: number, message: string): OpenAIErrorResponse;
+/**
+ * Format a single OpenAI SSE frame.
+ * OpenAI uses only `data:` lines (no `event:` prefix unlike Claude).
+ */
+export declare function formatOpenAISSE(data: unknown): string;
+/**
+ * Stateful SSE serializer that emits a well-formed OpenAI streaming response.
+ *
+ * Tracks lifecycle state (`idle` -> `streaming` -> `done`) and the current
+ * tool call index for multi-tool streaming.
+ *
+ * Usage:
+ * ```ts
+ * const sse = new OpenAIStreamSerializer(requestModel);
+ *
+ * // Start the stream
+ * yield* sse.start();
+ *
+ * // Text deltas
+ * for await (const chunk of textStream) {
+ *   yield* sse.pushDelta(chunk);
+ * }
+ *
+ * // Tool use
+ * yield* sse.pushToolUse(toolId, toolName, toolInput);
+ *
+ * // Finalize
+ * yield* sse.finish("stop", usage);
+ * ```
+ */
+export declare class OpenAIStreamSerializer {
+    private state;
+    private readonly id;
+    private readonly model;
+    private started;
+    private toolCallIndex;
+    constructor(model: string);
+    /** Current lifecycle state (exposed for testing). */
+    getState(): StreamLifecycleState;
+    private makeChunk;
+    /**
+     * Emit the opening frame with `role: "assistant"`.
+     */
+    start(): Generator<string>;
+    /**
+     * Push a text content delta.
+     */
+    pushDelta(text: string): Generator<string>;
+    /**
+     * Push the start of a tool call (id, name, empty arguments).
+     */
+    pushToolCallStart(id: string, name: string): Generator<string>;
+    /**
+     * Push an arguments delta for the current tool call.
+     */
+    pushToolCallArgDelta(index: number, argsChunk: string): Generator<string>;
+    /**
+     * Push a complete tool use: emits tool call start followed by chunked
+     * argument deltas (~100 chars per chunk).
+     */
+    pushToolUse(id: string, name: string, input: unknown): Generator<string>;
+    /**
+     * Finalize the stream: emit finish_reason chunk, then `data: [DONE]`.
+     */
+    finish(finishReason?: string, usage?: {
+        input: number;
+        output: number;
+        total: number;
+    }): Generator<string>;
+    /**
+     * Emit an error event.  Transitions to terminal ERROR state.
+     */
+    emitError(message: string): Generator<string>;
+}
+/**
+ * Convert an OpenAI Chat Completions request to a Claude Messages API request.
+ *
+ * Used by the OpenAI proxy endpoint to internally loopback requests targeting
+ * Claude models through the proxy's native /v1/messages passthrough path,
+ * so they benefit from OAuth account rotation, retry, SSE interception, etc.
+ */
+export declare function convertOpenAIToClaudeRequest(openai: OpenAICompletionRequest): ClaudeRequest;
+/**
+ * Convert a non-streaming Claude Messages response to an OpenAI Chat
+ * Completions response by bridging through {@link InternalResult}.
+ */
+export declare function convertClaudeToOpenAIResponse(claude: ClaudeResponse, requestModel: string): OpenAICompletionResponse;
+/**
+ * Create a TransformStream that parses Claude Messages API SSE events from
+ * the upstream response and re-emits them as OpenAI Chat Completions SSE
+ * frames.
+ *
+ * Handles the canonical Claude SSE event types:
+ *  - message_start       -> emits the opening `role: "assistant"` chunk
+ *  - content_block_start -> text block: no-op; tool_use block: emit tool call start
+ *  - content_block_delta -> text_delta: emit content delta;
+ *                           input_json_delta: emit tool call argument delta
+ *  - content_block_stop  -> no-op
+ *  - message_delta       -> captures stop_reason and output token usage
+ *  - message_stop        -> emits the final `finish_reason` chunk + `[DONE]`
+ */
+export declare function createClaudeToOpenAIStreamTransform(requestModel: string): TransformStream<Uint8Array, Uint8Array>;