@juspay/neurolink 9.81.3 → 9.82.0

package/dist/cli/commands/proxy.js

@@ -17,6 +17,7 @@ import ora from "ora";
 import { buildProxyHealthResponse, createProxyReadinessState, markProxyReady, waitForProxyReadiness, } from "../../lib/proxy/proxyHealth.js";
 import { logger } from "../../lib/utils/logger.js";
 import { formatUptime, isProcessRunning, StateFileManager, } from "../utils/serverUtils.js";
+import { configureProxyKeepAliveDispatcher } from "../../lib/proxy/proxyDispatcher.js";
 import { loadProxyEnvFile, resolveProxyEnvFile, } from "../../lib/proxy/proxyEnv.js";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
@@ -1285,6 +1286,10 @@ async function startProxyCommandHandler(argv) {
             await ensureProxyStartAllowed(spinner);
         }
         const loadedEnvFile = await loadProxyStartEnv(argv, spinner);
+        // Reuse upstream TCP connections (longer keep-alive + bounded pool) instead
+        // of opening a new flow per request — cuts outbound flow churn through host
+        // content-filters. Runs once, after env load so it can be tuned via env.
+        configureProxyKeepAliveDispatcher();
         const { neurolink, cleanupLogs } = await createProxyNeurolinkRuntime(devPaths?.logsDir);
         const { proxyConfig, strategy, modelRouter, passthrough, primaryAccountKey, } = await loadProxyStartConfiguration(argv, spinner);
         if (spinner) {

package/dist/cli/factories/commandFactory.d.ts

@@ -35,8 +35,9 @@ export declare class CLICommandFactory {
     private static validateAnthropicSubscriptionOptions;
     private static handleOutput;
     /**
-     * Helper method to handle TTS audio file output
+     * Helper method to handle TTS audio file output and playback
      * Saves audio to file when --tts-output flag is provided
+     * Plays audio when --tts-play flag is provided
      */
     private static handleTTSOutput;
     /**

package/dist/cli/factories/commandFactory.js

@@ -20,6 +20,7 @@ import { handleError } from "../errorHandler.js";
 import { LoopSession } from "../loop/session.js";
 import { initializeCliParser } from "../parser.js";
 import { formatFileSize, saveAudioToFile } from "../utils/audioFileUtils.js";
+import { playAudio } from "../utils/audioPlayer.js";
 import { resolveFilePaths } from "../utils/pathResolver.js";
 import { animatedWrite } from "../utils/typewriter.js";
 import { createStreamAbortHandler } from "../utils/abortHandler.js";
@@ -1040,13 +1041,15 @@ export class CLICommandFactory {
         }
     }
     /**
-     * Helper method to handle TTS audio file output
+     * Helper method to handle TTS audio file output and playback
      * Saves audio to file when --tts-output flag is provided
+     * Plays audio when --tts-play flag is provided
      */
     static async handleTTSOutput(result, options) {
-        // Check if --tts-output flag is provided
         const ttsOutputPath = options.ttsOutput;
-        if (!ttsOutputPath) {
+        const shouldPlay = options.ttsPlay;
+        // Nothing to do if neither save nor play is requested
+        if (!ttsOutputPath && !shouldPlay) {
             return;
         }
         // Extract audio from result with proper type checking
@@ -1061,20 +1064,36 @@ export class CLICommandFactory {
             }
             return;
         }
-        try {
-            // Save audio to file
-            const saveResult = await saveAudioToFile(audio, ttsOutputPath);
-            if (saveResult.success) {
-                if (!options.quiet) {
-                    logger.always(chalk.green(`🔊 Audio saved to: ${saveResult.path} (${formatFileSize(saveResult.size)})`));
+        // Save audio to file if --tts-output is provided
+        if (ttsOutputPath) {
+            try {
+                const saveResult = await saveAudioToFile(audio, ttsOutputPath);
+                if (saveResult.success) {
+                    if (!options.quiet) {
+                        logger.always(chalk.green(`🔊 Audio saved to: ${saveResult.path} (${formatFileSize(saveResult.size)})`));
+                    }
+                }
+                else {
+                    handleError(new Error(saveResult.error || "Failed to save audio file"), "TTS Output");
                 }
             }
-            else {
-                handleError(new Error(saveResult.error || "Failed to save audio file"), "TTS Output");
+            catch (error) {
+                handleError(error, "TTS Output");
             }
         }
-        catch (error) {
-            handleError(error, "TTS Output");
+        // Play audio if --tts-play is provided
+        if (shouldPlay) {
+            try {
+                if (!options.quiet) {
+                    logger.always(chalk.blue("Playing audio..."));
+                }
+                await playAudio(audio.buffer, audio.format);
+            }
+            catch (err) {
+                // Non-fatal: warn but don't crash
+                logger.always(chalk.yellow(`Audio playback failed: ${err.message}`));
+                logger.always(chalk.yellow("   Tip: Save the audio with --tts-output <file> and play manually."));
+            }
         }
     }
     /**
@@ -2898,15 +2917,16 @@ export class CLICommandFactory {
                 logger.always(`\nOutput saved to ${options.output}`);
             }
         }
-        // Handle TTS audio output if --tts-output is provided
+        // Handle TTS audio output/playback if --tts-output or --tts-play is provided
         // Note: For streaming, TTS audio is collected during the stream
         // and saved at the end if available
         const ttsOutputPath = options.ttsOutput;
-        if (ttsOutputPath) {
+        const shouldPlay = options.ttsPlay;
+        if (ttsOutputPath || shouldPlay) {
             // For now, streaming TTS output is not yet available
             // This will be enabled when the TTS streaming infrastructure is complete
             if (!options.quiet) {
-                logger.always(chalk.yellow("⚠️  TTS audio output for streaming is not yet available. Use 'generate' command for TTS output."));
+                logger.always(chalk.yellow("TTS audio for streaming is not yet available. Use 'generate' command for TTS output."));
             }
         }
         // Debug output for streaming

package/dist/cli/utils/audioPlayer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Audio playback utilities for CLI
+ *
+ * Provides functionality for playing TTS audio using platform-specific
+ * CLI tools with proper cleanup and error handling.
+ *
+ * @module cli/utils/audioPlayer
+ */
+import type { AudioFormat } from "../../lib/types/index.js";
+/**
+ * Get the file extension for an audio format
+ *
+ * @param format - Audio format
+ * @returns File extension string (e.g., "mp3", "wav")
+ */
+export declare function getAudioExtension(format: AudioFormat): string;
+/**
+ * Play audio from a buffer using platform-specific CLI tools
+ *
+ * Writes the buffer to a temporary file, plays it using the appropriate
+ * system audio player, and cleans up the temp file afterward.
+ *
+ * Supported platforms:
+ * - macOS: uses `afplay` (built-in, supports mp3/wav/aac/flac)
+ * - Linux: uses `paplay` for non-wav, `aplay` for wav
+ * - Windows: uses PowerShell SoundPlayer (wav) or WMPlayer.OCX (mp3)
+ *
+ * @param buffer - Audio data buffer
+ * @param format - Audio format (mp3, wav, ogg, opus)
+ * @throws Error if playback fails or platform is unsupported
+ *
+ * @example
+ * ```typescript
+ * await playAudio(audioBuffer, "mp3");
+ * ```
+ */
+export declare function playAudio(buffer: Buffer, format: AudioFormat): Promise<void>;

package/dist/cli/utils/audioPlayer.js

@@ -0,0 +1,138 @@
+/**
+ * Audio playback utilities for CLI
+ *
+ * Provides functionality for playing TTS audio using platform-specific
+ * CLI tools with proper cleanup and error handling.
+ *
+ * @module cli/utils/audioPlayer
+ */
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * Get the file extension for an audio format
+ *
+ * @param format - Audio format
+ * @returns File extension string (e.g., "mp3", "wav")
+ */
+export function getAudioExtension(format) {
+    switch (format) {
+        case "mp3":
+            return "mp3";
+        case "wav":
+            return "wav";
+        case "ogg":
+            return "ogg";
+        case "opus":
+            return "opus";
+        default:
+            return "mp3";
+    }
+}
+/**
+ * Get the platform-specific audio player command and arguments
+ *
+ * @param filePath - Path to the audio file
+ * @param format - Audio format
+ * @returns Object with command and args for execFile
+ */
+function getPlayerCommand(filePath, format) {
+    const platform = process.platform;
+    switch (platform) {
+        case "darwin":
+            return { command: "afplay", args: [filePath] };
+        case "linux":
+            if (format === "wav") {
+                return { command: "aplay", args: [filePath] };
+            }
+            return { command: "paplay", args: [filePath] };
+        case "win32":
+            if (format === "wav") {
+                return {
+                    command: "powershell",
+                    args: [
+                        "-NoProfile",
+                        "-Command",
+                        `(New-Object System.Media.SoundPlayer '${filePath}').PlaySync()`,
+                    ],
+                };
+            }
+            return {
+                command: "powershell",
+                args: [
+                    "-NoProfile",
+                    "-Command",
+                    `$player = New-Object -ComObject WMPlayer.OCX; $player.URL = '${filePath}'; $player.controls.play(); Start-Sleep -Seconds 1; while ($player.playState -eq 3) { Start-Sleep -Milliseconds 100 }; $player.close()`,
+                ],
+            };
+        default:
+            throw new Error(`Unsupported platform: ${platform}. Audio playback is supported on macOS, Linux, and Windows.`);
+    }
+}
+/**
+ * Play audio from a buffer using platform-specific CLI tools
+ *
+ * Writes the buffer to a temporary file, plays it using the appropriate
+ * system audio player, and cleans up the temp file afterward.
+ *
+ * Supported platforms:
+ * - macOS: uses `afplay` (built-in, supports mp3/wav/aac/flac)
+ * - Linux: uses `paplay` for non-wav, `aplay` for wav
+ * - Windows: uses PowerShell SoundPlayer (wav) or WMPlayer.OCX (mp3)
+ *
+ * @param buffer - Audio data buffer
+ * @param format - Audio format (mp3, wav, ogg, opus)
+ * @throws Error if playback fails or platform is unsupported
+ *
+ * @example
+ * ```typescript
+ * await playAudio(audioBuffer, "mp3");
+ * ```
+ */
+export async function playAudio(buffer, format) {
+    const ext = getAudioExtension(format);
+    const tempFile = path.join(os.tmpdir(), `nl-tts-${Date.now()}.${ext}`);
+    try {
+        // Write audio buffer to temp file
+        await fs.promises.writeFile(tempFile, buffer);
+        const { command, args } = getPlayerCommand(tempFile, format);
+        try {
+            await execFileAsync(command, args);
+        }
+        catch (execError) {
+            const err = execError;
+            // Handle binary not found
+            if (err.code === "ENOENT") {
+                if (process.platform === "linux" && command === "paplay") {
+                    // Fallback to aplay on Linux
+                    try {
+                        await execFileAsync("aplay", [tempFile]);
+                        return;
+                    }
+                    catch (fallbackError) {
+                        const fbErr = fallbackError;
+                        if (fbErr.code === "ENOENT") {
+                            throw new Error("Neither paplay nor aplay found. Install PulseAudio (paplay) or ALSA (aplay) for audio playback.", { cause: fallbackError });
+                        }
+                        throw fallbackError;
+                    }
+                }
+                throw new Error(`Audio player '${command}' not found. Ensure it is installed and available in PATH.`, { cause: execError });
+            }
+            throw execError;
+        }
+    }
+    finally {
+        // Always clean up temp file
+        try {
+            await fs.promises.unlink(tempFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=audioPlayer.js.map

package/dist/core/modules/GenerationHandler.js

@@ -26,6 +26,7 @@ import { coerceJsonToSchema } from "../../utils/json/coerce.js";
 import { NoObjectGeneratedError } from "../../utils/generationErrors.js";
 import { Output, stepCountIs } from "../../utils/tool.js";
 import { generateText } from "../../utils/generation.js";
+import { extractSystemMessages } from "../../utils/systemMessages.js";
 const genTracer = tracers.generation;
 /**
  * Safely preview-serialize a value for debug logging.
@@ -105,9 +106,14 @@ export class GenerationHandler {
             }
         }
         const prepareStep = options.prepareStep;
+        // Hoist system-role messages into generateText's top-level `system` option
+        // rather than passing them inside `messages` (deprecated by the AI SDK,
+        // rejected in v7). See extractSystemMessages for the rationale. (#1024)
+        const { system, messages: nonSystemMessages } = extractSystemMessages(messages);
         return await generateText({
             model,
-            messages,
+            ...(system && { system }),
+            messages: nonSystemMessages,
             ...(shouldUseTools &&
                 Object.keys(toolsWithCache).length > 0 && { tools: toolsWithCache }),
             stopWhen: stepCountIs(options.maxSteps ?? DEFAULT_MAX_STEPS),

package/dist/index.d.ts

@@ -35,7 +35,12 @@ import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
 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";
+export { NeuroLinkClient, createClient, NeuroLinkApiError, } from "./client/httpClient.js";
+export { NeuroLinkLanguageModel, NeuroLinkProvider as NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, } from "./client/aiSdkAdapter.js";
+export { createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, } from "./client/interceptors.js";
+export { SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, } from "./client/streamingClient.js";
+export { OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, } from "./client/auth.js";
+export { 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/errors.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export { validateTool } from "./sdk/toolRegistration.js";

package/dist/index.js

@@ -41,20 +41,28 @@ export { BaseFactory, BaseRegistry, NeuroLinkFeatureError, createErrorFactory, w
 // ============================================================================
 // CLIENT SDK EXPORTS - Type-safe API access for browser and Node.js
 // Note: React hooks are NOT re-exported here. Import from '@juspay/neurolink/client'.
+// These re-exports intentionally bypass ./client/index.js: that barrel statically
+// re-exports ./reactHooks.js, so routing through it makes the ROOT import require
+// `react` (an optional peer dep) and crash react-less installs at import time.
 // ============================================================================
 export { 
 // HTTP Client
-NeuroLinkClient, createClient, NeuroLinkApiError, 
+NeuroLinkClient, createClient, NeuroLinkApiError, } from "./client/httpClient.js";
+export { 
 // AI SDK Adapter
-NeuroLinkLanguageModel, NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, 
+NeuroLinkLanguageModel, NeuroLinkProvider as NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, } from "./client/aiSdkAdapter.js";
+export { 
 // Interceptors
-createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, 
+createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, } from "./client/interceptors.js";
+export { 
 // Streaming Client
-SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, 
+SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, } from "./client/streamingClient.js";
+export { 
 // Authentication
-OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, 
+OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, } from "./client/auth.js";
+export { 
 // Errors
-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";
+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/errors.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 // Dynamic Models exports
 export { dynamicModelProvider } from "./core/dynamicModels.js";

package/dist/lib/core/modules/GenerationHandler.js

@@ -26,6 +26,7 @@ import { coerceJsonToSchema } from "../../utils/json/coerce.js";
 import { NoObjectGeneratedError } from "../../utils/generationErrors.js";
 import { Output, stepCountIs } from "../../utils/tool.js";
 import { generateText } from "../../utils/generation.js";
+import { extractSystemMessages } from "../../utils/systemMessages.js";
 const genTracer = tracers.generation;
 /**
  * Safely preview-serialize a value for debug logging.
@@ -105,9 +106,14 @@ export class GenerationHandler {
             }
         }
         const prepareStep = options.prepareStep;
+        // Hoist system-role messages into generateText's top-level `system` option
+        // rather than passing them inside `messages` (deprecated by the AI SDK,
+        // rejected in v7). See extractSystemMessages for the rationale. (#1024)
+        const { system, messages: nonSystemMessages } = extractSystemMessages(messages);
         return await generateText({
             model,
-            messages,
+            ...(system && { system }),
+            messages: nonSystemMessages,
             ...(shouldUseTools &&
                 Object.keys(toolsWithCache).length > 0 && { tools: toolsWithCache }),
             stopWhen: stepCountIs(options.maxSteps ?? DEFAULT_MAX_STEPS),

package/dist/lib/index.d.ts

@@ -35,7 +35,12 @@ import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
 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";
+export { NeuroLinkClient, createClient, NeuroLinkApiError, } from "./client/httpClient.js";
+export { NeuroLinkLanguageModel, NeuroLinkProvider as NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, } from "./client/aiSdkAdapter.js";
+export { createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, } from "./client/interceptors.js";
+export { SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, } from "./client/streamingClient.js";
+export { OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, } from "./client/auth.js";
+export { 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/errors.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export { validateTool } from "./sdk/toolRegistration.js";

package/dist/lib/index.js

@@ -41,20 +41,28 @@ export { BaseFactory, BaseRegistry, NeuroLinkFeatureError, createErrorFactory, w
 // ============================================================================
 // CLIENT SDK EXPORTS - Type-safe API access for browser and Node.js
 // Note: React hooks are NOT re-exported here. Import from '@juspay/neurolink/client'.
+// These re-exports intentionally bypass ./client/index.js: that barrel statically
+// re-exports ./reactHooks.js, so routing through it makes the ROOT import require
+// `react` (an optional peer dep) and crash react-less installs at import time.
 // ============================================================================
 export { 
 // HTTP Client
-NeuroLinkClient, createClient, NeuroLinkApiError, 
+NeuroLinkClient, createClient, NeuroLinkApiError, } from "./client/httpClient.js";
+export { 
 // AI SDK Adapter
-NeuroLinkLanguageModel, NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, 
+NeuroLinkLanguageModel, NeuroLinkProvider as NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, } from "./client/aiSdkAdapter.js";
+export { 
 // Interceptors
-createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, 
+createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, } from "./client/interceptors.js";
+export { 
 // Streaming Client
-SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, 
+SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, } from "./client/streamingClient.js";
+export { 
 // Authentication
-OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, 
+OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, } from "./client/auth.js";
+export { 
 // Errors
-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";
+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/errors.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 // Dynamic Models exports
 export { dynamicModelProvider } from "./core/dynamicModels.js";

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

@@ -0,0 +1,5 @@
+/**
+ * Install the tuned global undici dispatcher. Idempotent — safe to call once at
+ * proxy startup. No-op when `NEUROLINK_PROXY_KEEPALIVE` is off/false/0.
+ */
+export declare function configureProxyKeepAliveDispatcher(): void;

package/dist/lib/proxy/proxyDispatcher.js

@@ -0,0 +1,61 @@
+/**
+ * Tuned global undici dispatcher for the proxy's upstream forwards.
+ *
+ * The Claude passthrough (`claudeProxyRoutes.ts`) forwards every request to
+ * Anthropic via the global `fetch` → undici global dispatcher. undici keep-alives
+ * by default, but with a ~4s idle timeout: between Claude Code turns (the user
+ * reads output, a tool runs, the model thinks) the idle socket closes, so the
+ * next request opens a brand-new TCP connection. Under sustained use that is a
+ * high rate of short-lived outbound flows.
+ *
+ * On hosts running a socket content-filter (CFIL) — e.g. SentinelOne or
+ * GlobalProtect network extensions — every new flow allocates per-flow kernel
+ * state, so a high flow rate amplifies any leak in that path. Reusing connections
+ * cuts the flow rate sharply, so we install a dispatcher with a longer keep-alive
+ * and a bounded, reused connection pool.
+ *
+ * Everything is overridable via env so it can be tuned (or disabled) per host:
+ *   NEUROLINK_PROXY_KEEPALIVE=off       disable; keep undici defaults
+ *   NEUROLINK_PROXY_KEEPALIVE_MS        idle keep-alive timeout (default 30000)
+ *   NEUROLINK_PROXY_KEEPALIVE_MAX_MS    keep-alive upper bound  (default 600000)
+ *   NEUROLINK_PROXY_MAX_CONNECTIONS     max pooled connections per origin (default 64)
+ */
+import { Agent, setGlobalDispatcher } from "undici";
+import { logger } from "../utils/logger.js";
+function readPositiveInt(name, fallback) {
+    const raw = process.env[name];
+    if (!raw) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+let configured = false;
+/**
+ * Install the tuned global undici dispatcher. Idempotent — safe to call once at
+ * proxy startup. No-op when `NEUROLINK_PROXY_KEEPALIVE` is off/false/0.
+ */
+export function configureProxyKeepAliveDispatcher() {
+    if (configured) {
+        return;
+    }
+    configured = true;
+    const toggle = (process.env.NEUROLINK_PROXY_KEEPALIVE ?? "").toLowerCase();
+    if (toggle === "off" || toggle === "false" || toggle === "0") {
+        logger.debug("[proxy] keep-alive dispatcher disabled via env");
+        return;
+    }
+    const keepAliveTimeout = readPositiveInt("NEUROLINK_PROXY_KEEPALIVE_MS", 30_000);
+    const keepAliveMaxTimeout = readPositiveInt("NEUROLINK_PROXY_KEEPALIVE_MAX_MS", 600_000);
+    const connections = readPositiveInt("NEUROLINK_PROXY_MAX_CONNECTIONS", 64);
+    setGlobalDispatcher(new Agent({
+        keepAliveTimeout,
+        keepAliveMaxTimeout,
+        connections,
+        pipelining: 1,
+    }));
+    logger.debug(`[proxy] tuned undici dispatcher installed ` +
+        `(keepAliveTimeout=${keepAliveTimeout}ms, ` +
+        `keepAliveMaxTimeout=${keepAliveMaxTimeout}ms, connections=${connections})`);
+}
+//# sourceMappingURL=proxyDispatcher.js.map

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

@@ -0,0 +1,29 @@
+import type { ModelMessage, SystemModelMessage } from "../types/index.js";
+/**
+ * Partition a built message array into system messages and the rest, so the
+ * system prompt can ride `generateText`'s top-level `system` option instead of
+ * the `messages` array.
+ *
+ * The AI SDK deprecates system-role entries inside `messages` (warns by default
+ * from ai@6.0.170 via the `allowSystemInMessages` option, rejected by default
+ * in v7, flagged as a prompt-injection risk). The `system` option accepts full
+ * SystemModelMessage objects, so per-message providerOptions (e.g. the anthropic
+ * cacheControl breakpoint set by buildMessagesArray) survive the move. See
+ * issue #1024.
+ *
+ * Order is preserved within both partitions and the input is not mutated.
+ *
+ * Guard: the partition only runs when it leaves a non-empty `messages` array.
+ * If every message is a system message (a system-only priming call) — or there
+ * are no system messages at all — the original array is returned untouched with
+ * `system: undefined`. The AI SDK rejects an empty `messages` array, and a
+ * system-only call has no hoisted form (the SDK also requires a non-system
+ * message), so that degenerate case is deliberately left on the old
+ * system-in-`messages` path rather than made to throw — it keeps whatever
+ * behaviour it had before #1024. The normal system-plus-conversation path is
+ * always hoisted.
+ */
+export declare function extractSystemMessages(messages: ModelMessage[]): {
+    system: SystemModelMessage[] | undefined;
+    messages: ModelMessage[];
+};

package/dist/lib/utils/systemMessages.js

@@ -0,0 +1,45 @@
+/**
+ * Partition a built message array into system messages and the rest, so the
+ * system prompt can ride `generateText`'s top-level `system` option instead of
+ * the `messages` array.
+ *
+ * The AI SDK deprecates system-role entries inside `messages` (warns by default
+ * from ai@6.0.170 via the `allowSystemInMessages` option, rejected by default
+ * in v7, flagged as a prompt-injection risk). The `system` option accepts full
+ * SystemModelMessage objects, so per-message providerOptions (e.g. the anthropic
+ * cacheControl breakpoint set by buildMessagesArray) survive the move. See
+ * issue #1024.
+ *
+ * Order is preserved within both partitions and the input is not mutated.
+ *
+ * Guard: the partition only runs when it leaves a non-empty `messages` array.
+ * If every message is a system message (a system-only priming call) — or there
+ * are no system messages at all — the original array is returned untouched with
+ * `system: undefined`. The AI SDK rejects an empty `messages` array, and a
+ * system-only call has no hoisted form (the SDK also requires a non-system
+ * message), so that degenerate case is deliberately left on the old
+ * system-in-`messages` path rather than made to throw — it keeps whatever
+ * behaviour it had before #1024. The normal system-plus-conversation path is
+ * always hoisted.
+ */
+export function extractSystemMessages(messages) {
+    const system = [];
+    const rest = [];
+    for (const message of messages) {
+        if (message.role === "system") {
+            system.push(message);
+        }
+        else {
+            rest.push(message);
+        }
+    }
+    // Only hoist when a non-empty messages array remains. A system-only call (or
+    // a no-system array) passes through unchanged: hoisting would empty
+    // `messages`, which the SDK rejects, and a system-only call has no compliant
+    // hoisted form.
+    if (system.length === 0 || rest.length === 0) {
+        return { system: undefined, messages };
+    }
+    return { system, messages: rest };
+}
+//# sourceMappingURL=systemMessages.js.map

package/dist/proxy/proxyDispatcher.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Install the tuned global undici dispatcher. Idempotent — safe to call once at
+ * proxy startup. No-op when `NEUROLINK_PROXY_KEEPALIVE` is off/false/0.
+ */
+export declare function configureProxyKeepAliveDispatcher(): void;