@juspay/neurolink 9.30.0 → 9.31.0

package/dist/lib/files/fileTools.d.ts

@@ -15,7 +15,6 @@
  *
  * @module files/fileTools
  */
-import { z } from "zod";
 import type { FileReferenceRegistry } from "./fileReferenceRegistry.js";
 /**
  * Create file access tools bound to a FileReferenceRegistry instance.
@@ -35,7 +34,7 @@ import type { FileReferenceRegistry } from "./fileReferenceRegistry.js";
  * ```
  */
 export declare function createFileTools(registry: FileReferenceRegistry): {
-    list_attached_files: import("ai").Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, {
+    list_attached_files: import("ai").Tool<Record<string, never>, {
         success: boolean;
         message: string;
         fileCount: number;
@@ -69,59 +68,13 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
         fileCount?: undefined;
         files?: undefined;
         formatted?: undefined;
-    }> & {
-        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: boolean;
-            message: string;
-            fileCount: number;
-            files?: undefined;
-            formatted?: undefined;
-            error?: undefined;
-        } | {
-            success: boolean;
-            fileCount: number;
-            files: {
-                index: number;
-                id: string;
-                filename: string;
-                type: import("../index.js").FileType;
-                size: string;
-                sizeBytes: number;
-                sizeTier: import("./types.js").SizeTier;
-                estimatedTokens: number;
-                status: import("./types.js").FileReferenceStatus;
-                hasPreview: boolean;
-                hasSummary: boolean;
-                totalLines: number | null;
-            }[];
-            formatted: string;
-            message?: undefined;
-            error?: undefined;
-        } | {
-            success: boolean;
-            error: string;
-            message?: undefined;
-            fileCount?: undefined;
-            files?: undefined;
-            formatted?: undefined;
-        }>;
-    };
-    read_file_section: import("ai").Tool<z.ZodObject<{
-        file_id: z.ZodString;
-        start_line: z.ZodDefault<z.ZodNumber>;
-        end_line: z.ZodOptional<z.ZodNumber>;
-        token_budget: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
+    }>;
+    read_file_section: import("ai").Tool<{
         file_id: string;
         start_line: number;
         token_budget: number;
         end_line?: number | undefined;
     }, {
-        file_id: string;
-        start_line?: number | undefined;
-        end_line?: number | undefined;
-        token_budget?: number | undefined;
-    }>, {
         success: boolean;
         error: string;
         content?: undefined;
@@ -141,47 +94,12 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
         estimatedTokens: number;
         guidance: string | undefined;
         error?: undefined;
-    }> & {
-        execute: (args: {
-            file_id: string;
-            start_line: number;
-            token_budget: number;
-            end_line?: number | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: boolean;
-            error: string;
-            content?: undefined;
-            startLine?: undefined;
-            endLine?: undefined;
-            totalLines?: undefined;
-            truncated?: undefined;
-            estimatedTokens?: undefined;
-            guidance?: undefined;
-        } | {
-            success: boolean;
-            content: string;
-            startLine: number;
-            endLine: number;
-            totalLines: number;
-            truncated: boolean;
-            estimatedTokens: number;
-            guidance: string | undefined;
-            error?: undefined;
-        }>;
-    };
-    search_in_file: import("ai").Tool<z.ZodObject<{
-        file_id: z.ZodString;
-        pattern: z.ZodString;
-        max_matches: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        pattern: string;
+    }>;
+    search_in_file: import("ai").Tool<{
         file_id: string;
+        pattern: string;
         max_matches: number;
     }, {
-        pattern: string;
-        file_id: string;
-        max_matches?: number | undefined;
-    }>, {
         success: boolean;
         error: string;
         pattern?: undefined;
@@ -204,43 +122,10 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
             } | undefined;
         }[];
         error?: undefined;
-    }> & {
-        execute: (args: {
-            pattern: string;
-            file_id: string;
-            max_matches: number;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: boolean;
-            error: string;
-            pattern?: undefined;
-            totalMatches?: undefined;
-            matchesReturned?: undefined;
-            truncated?: undefined;
-            matches?: undefined;
-        } | {
-            success: boolean;
-            pattern: string;
-            totalMatches: number;
-            matchesReturned: number;
-            truncated: boolean;
-            matches: {
-                lineNumber: number;
-                line: string;
-                context: {
-                    before: string[];
-                    after: string[];
-                } | undefined;
-            }[];
-            error?: undefined;
-        }>;
-    };
-    get_file_preview: import("ai").Tool<z.ZodObject<{
-        file_id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
+    }>;
+    get_file_preview: import("ai").Tool<{
         file_id: string;
     }, {
-        file_id: string;
-    }>, {
         success: boolean;
         error: string;
         filename?: undefined;
@@ -270,108 +155,26 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
         summary: string | null;
         hasSummary: boolean;
         error?: undefined;
-    }> & {
-        execute: (args: {
-            file_id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: boolean;
-            error: string;
-            filename?: undefined;
-            type?: undefined;
-            size?: undefined;
-            sizeBytes?: undefined;
-            sizeTier?: undefined;
-            mimeType?: undefined;
-            estimatedTokens?: undefined;
-            status?: undefined;
-            totalLines?: undefined;
-            preview?: undefined;
-            summary?: undefined;
-            hasSummary?: undefined;
-        } | {
-            success: boolean;
-            filename: string;
-            type: import("../index.js").FileType;
-            size: string;
-            sizeBytes: number;
-            sizeTier: import("./types.js").SizeTier;
-            mimeType: string;
-            estimatedTokens: number;
-            status: import("./types.js").FileReferenceStatus;
-            totalLines: number | null;
-            preview: string;
-            summary: string | null;
-            hasSummary: boolean;
-            error?: undefined;
-        }>;
-    };
-    extract_file_content: import("ai").Tool<z.ZodObject<{
-        file_id: z.ZodString;
-        start_time: z.ZodOptional<z.ZodNumber>;
-        end_time: z.ZodOptional<z.ZodNumber>;
-        frame_count: z.ZodOptional<z.ZodNumber>;
-        pages: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-        page_range: z.ZodOptional<z.ZodObject<{
-            start: z.ZodNumber;
-            end: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            end: number;
-            start: number;
-        }, {
-            end: number;
-            start: number;
-        }>>;
-        sheet: z.ZodOptional<z.ZodString>;
-        row_range: z.ZodOptional<z.ZodObject<{
-            start: z.ZodNumber;
-            end: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            end: number;
-            start: number;
-        }, {
-            end: number;
-            start: number;
-        }>>;
-        columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        entry_path: z.ZodOptional<z.ZodString>;
-        format: z.ZodOptional<z.ZodEnum<["text", "detailed", "summary"]>>;
-    }, "strip", z.ZodTypeAny, {
+    }>;
+    extract_file_content: import("ai").Tool<{
         file_id: string;
-        end_time?: number | undefined;
         start_time?: number | undefined;
-        format?: "text" | "summary" | "detailed" | undefined;
-        sheet?: string | undefined;
-        columns?: string[] | undefined;
+        end_time?: number | undefined;
         frame_count?: number | undefined;
         pages?: number[] | undefined;
         page_range?: {
-            end: number;
             start: number;
-        } | undefined;
-        row_range?: {
             end: number;
-            start: number;
         } | undefined;
-        entry_path?: string | undefined;
-    }, {
-        file_id: string;
-        end_time?: number | undefined;
-        start_time?: number | undefined;
-        format?: "text" | "summary" | "detailed" | undefined;
         sheet?: string | undefined;
-        columns?: string[] | undefined;
-        frame_count?: number | undefined;
-        pages?: number[] | undefined;
-        page_range?: {
-            end: number;
-            start: number;
-        } | undefined;
         row_range?: {
-            end: number;
             start: number;
+            end: number;
         } | undefined;
+        columns?: string[] | undefined;
         entry_path?: string | undefined;
-    }>, {
+        format?: "text" | "summary" | "detailed" | undefined;
+    }, {
         success: false;
         error: string | undefined;
         text: string | undefined;
@@ -385,39 +188,5 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
         imageCount: number;
         _images: Buffer<ArrayBufferLike>[] | undefined;
         error: string | undefined;
-    }> & {
-        execute: (args: {
-            file_id: string;
-            end_time?: number | undefined;
-            start_time?: number | undefined;
-            format?: "text" | "summary" | "detailed" | undefined;
-            sheet?: string | undefined;
-            columns?: string[] | undefined;
-            frame_count?: number | undefined;
-            pages?: number[] | undefined;
-            page_range?: {
-                end: number;
-                start: number;
-            } | undefined;
-            row_range?: {
-                end: number;
-                start: number;
-            } | undefined;
-            entry_path?: string | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: false;
-            error: string | undefined;
-            text: string | undefined;
-            metadata: Record<string, unknown> | undefined;
-            imageCount: number;
-            _images: Buffer[] | undefined;
-        } | {
-            success: true;
-            text: string | undefined;
-            metadata: Record<string, unknown> | undefined;
-            imageCount: number;
-            _images: Buffer<ArrayBufferLike>[] | undefined;
-            error: string | undefined;
-        }>;
-    };
+    }>;
 };

package/dist/lib/files/fileTools.js

@@ -57,7 +57,7 @@ function createListAttachedFilesTool(registry) {
             "Each file has a unique UUID 'id' field — use that ID (or the filename) " +
             "as the file_id parameter in read_file_section, search_in_file, and get_file_preview. " +
             "Always call this first to discover available files.",
-        parameters: z.object({}),
+        inputSchema: z.object({}),
         execute: async () => {
             try {
                 const files = registry.list();
@@ -108,7 +108,7 @@ function createReadFileSectionTool(registry) {
             "(UUID from list_attached_files, or the exact filename), start line, and end line. " +
             "Uses a token budget to prevent reading too much content at once. " +
             "For large files, read in sections rather than all at once.",
-        parameters: z.object({
+        inputSchema: z.object({
             file_id: z
                 .string()
                 .describe("The file ID (UUID from list_attached_files) or the exact filename"),
@@ -178,7 +178,7 @@ function createSearchInFileTool(registry) {
             "Supports plain text and regex patterns. Returns matching lines " +
             "with context lines before and after each match. " +
             "Use this to find specific content without reading the entire file.",
-        parameters: z.object({
+        inputSchema: z.object({
             file_id: z
                 .string()
                 .describe("The file ID (UUID from list_attached_files) or the exact filename"),
@@ -244,7 +244,7 @@ function createGetFilePreviewTool(registry) {
             "Specify file_id as the UUID from list_attached_files or the exact filename. " +
             "Returns the file's initial preview (first ~2000 chars) or its " +
             "LLM-generated summary if available. Includes file metadata.",
-        parameters: z.object({
+        inputSchema: z.object({
             file_id: z
                 .string()
                 .describe("The file ID (UUID from list_attached_files) or the exact filename"),
@@ -303,7 +303,7 @@ function createExtractFileContentTool(registry) {
             "- TEXT/CODE: Use page_range as line range for targeted reading\n\n" +
             "For video extraction, the result includes images (frames) that will be visible to you. " +
             "Always call list_attached_files first to discover file IDs.",
-        parameters: z.object({
+        inputSchema: z.object({
             file_id: z
                 .string()
                 .describe("File ID (UUID) or exact filename from list_attached_files"),
@@ -405,22 +405,23 @@ function createExtractFileContentTool(registry) {
                 };
             }
         },
-        experimental_toToolResultContent: (result) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        toModelOutput: ({ output }) => {
             const parts = [];
             // Add text content
-            if (result.text) {
-                parts.push({ type: "text", text: result.text });
+            if (output.text) {
+                parts.push({ type: "text", text: output.text });
             }
-            else if (result.error) {
-                parts.push({ type: "text", text: `Error: ${result.error}` });
+            else if (output.error) {
+                parts.push({ type: "text", text: `Error: ${output.error}` });
             }
             // Add images as image content parts so the LLM can see them
-            if (result._images && result._images.length > 0) {
-                for (const img of result._images) {
+            if (output._images && output._images.length > 0) {
+                for (const img of output._images) {
                     parts.push({
-                        type: "image",
+                        type: "image-data",
                         data: img.toString("base64"),
-                        mimeType: "image/jpeg",
+                        mediaType: "image/jpeg",
                     });
                 }
             }
@@ -428,7 +429,7 @@ function createExtractFileContentTool(registry) {
             if (parts.length === 0) {
                 parts.push({ type: "text", text: "(No content extracted)" });
             }
-            return parts;
+            return { type: "content", value: parts };
         },
     });
 }

package/dist/lib/index.d.ts

@@ -23,7 +23,7 @@
  * const result = await neurolink.generate({
  *   input: { text: 'Explain quantum computing' },
  *   provider: 'vertex',
- *   model: 'gemini-3-flash'
+ *   model: 'gemini-3-flash-preview'
  * });
  *
  * console.log(result.content);
@@ -35,6 +35,8 @@ import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
 export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.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 type { ClientConfig, RequestOptions, ApiResponse, ApiError, RetryConfig, Middleware as ClientMiddleware, MiddlewareRequest, MiddlewareResponse, MiddlewareContext as ClientMiddlewareContext, StreamCallbacks, StreamEvent, StreamResult, GenerateRequestOptions, GenerateResponse, StreamRequestOptions, AgentExecuteOptions, AgentExecuteResult, AgentInfo, WorkflowExecuteOptions, WorkflowExecuteResult, WorkflowInfo, ToolInfo as ClientToolInfo, ProviderStatus, WebSocketOptions, WebSocketState, WebSocketMessageHandler, NeuroLinkProviderOptions, ModelOptions, LanguageModel, LanguageModelCallOptions, LanguageModelResponse, LanguageModelStreamResponse, LoggingInterceptorOptions, RetryInterceptorOptions, RateLimiterOptions, CacheInterceptorOptions, TimeoutInterceptorOptions, ErrorHandlerOptions, SSEConnectionOptions, SSEConnectionState, StreamingRequestOptions, StreamingEventEmitter, StreamingClientConfig, SpeechRecognitionResult, SpeechSynthesisOptions, AuthConfig as ClientAuthConfig, OAuth2Config, TokenRefreshResult, ErrorCodeType, } from "./client/index.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export { validateTool } from "./sdk/toolRegistration.js";
@@ -90,7 +92,7 @@ export declare const VERSION = "1.0.0";
  *
  * @example With custom model
  * ```typescript
- * const provider = await createAIProvider('vertex', 'gemini-3-flash');
+ * const provider = await createAIProvider('vertex', 'gemini-3-flash-preview');
  * ```
  *
  * @see {@link AIProviderFactory.createProvider}
@@ -201,7 +203,7 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * await writeFile('output.txt', 'Hello from MCP!');
  * ```
  */
-export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, MCPToolRegistry, ExternalServerManager, MCPClientFactory, ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, ElicitationManager, globalElicitationManager, EnhancedToolDiscovery, MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, MCPServerBase, MultiServerManager, globalMultiServerManager, AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
+export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, CircuitBreakerOpenError, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, MCPToolRegistry, ExternalServerManager, MCPClientFactory, ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, ElicitationManager, globalElicitationManager, EnhancedToolDiscovery, MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, MCPServerBase, MultiServerManager, globalMultiServerManager, AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
 export type { RoutingStrategy, ToolRouterConfig, RoutingDecision, MCPTool, ToolRouterEvents, AffinityRule, CategoryMapping, RouterServerWeight, CacheStrategy, CacheConfig as MCPCacheConfig, CacheStats, CacheEvents, BatchConfig, BatchResult, BatchExecutor, BatcherEvents, MCPToolAnnotations, MCPServerTool, ToolConverterOptions, MCPProtocolTool, NeuroLinkTool, ToolMiddleware, EnhancedExecutionContext, ToolWrapperOptions, ExposableAgent, ExposableWorkflow, ExposureOptions, ExposureResult, MCPResource, MCPPrompt, ServerCapabilitiesConfig, PromptGenerator, PromptMessage, PromptResult, RegisteredPrompt, RegisteredResource, ResourceContent, ResourceReader, ResourceSubscriptionCallback, RegistryEntry, RegistrySearchOptions, RegistrySearchResult, RegistrySourceType, RegistryConfig, MCPRegistryClientConfig, LoadBalancingStrategy, ServerGroup, UnifiedTool, MultiServerManagerConfig, ServerWeight, MCPServerBaseConfig, MCPServerEvents, EnhancedToolInfo, ToolSearchCriteria, ToolSearchResult, CompatibilityCheckResult, ElicitationType, Elicitation, ElicitationResponse, ElicitationHandler, ElicitationManagerConfig, ElicitationRequest, ElicitationContext, TextElicitation, SelectElicitation, SelectOption, MultiSelectElicitation, ConfirmationElicitation, FileElicitation, SecretElicitation, FormElicitation, FormField, ElicitationProtocolMessage, ElicitationProtocolMessageType, ElicitationProtocolPayload, ElicitationProtocolHandler, ElicitationProtocolAdapterConfig, ElicitationRequestMessage, ElicitationRequestParams, ElicitationResponseMessage, ElicitationResponseParams, ElicitationCancelMessage, ElicitationCancelParams, } from "./mcp/index.js";
 export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens as McpOAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
 export type { ExecutionContext, ToolExecutionResult, ToolInfo, } from "./types/tools.js";

package/dist/lib/index.js

@@ -23,7 +23,7 @@
  * const result = await neurolink.generate({
  *   input: { text: 'Explain quantum computing' },
  *   provider: 'vertex',
- *   model: 'gemini-3-flash'
+ *   model: 'gemini-3-flash-preview'
  * });
  *
  * console.log(result.content);
@@ -37,6 +37,23 @@ export { AIProviderFactory };
 export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 // Config Manager export
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
+// ============================================================================
+// 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'.
+// ============================================================================
+export { 
+// HTTP Client
+NeuroLinkClient, createClient, NeuroLinkApiError, 
+// AI SDK Adapter
+NeuroLinkLanguageModel, NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink as neuroLinkAIInstance, 
+// Interceptors
+createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, 
+// Streaming Client
+SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, 
+// Authentication
+OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, 
+// 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";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 // Dynamic Models exports
 export { dynamicModelProvider } from "./core/dynamicModels.js";
@@ -107,7 +124,7 @@ export const VERSION = "1.0.0";
  *
  * @example With custom model
  * ```typescript
- * const provider = await createAIProvider('vertex', 'gemini-3-flash');
+ * const provider = await createAIProvider('vertex', 'gemini-3-flash-preview');
  * ```
  *
  * @see {@link AIProviderFactory.createProvider}
@@ -238,7 +255,7 @@ InMemoryTokenStorage,
 // Simplified MCP exports
 initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, 
 // Circuit Breaker
-MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, 
+CircuitBreakerOpenError, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, 
 // Core MCP Components
 MCPToolRegistry, ExternalServerManager, MCPClientFactory, 
 // MCP Enhancements - Routing, Caching, Batching

package/dist/lib/mcp/batching/requestBatcher.js

@@ -230,7 +230,7 @@ export class RequestBatcher extends EventEmitter {
                 args: r.args,
                 serverId: r.serverId,
             })));
-            const timeoutMs = 30_000;
+            const timeoutMs = Math.max(5000, Number(process.env.MCP_TOOL_TIMEOUT) || 60000);
             let timeoutHandle;
             const timeoutPromise = new Promise((_, reject) => {
                 timeoutHandle = setTimeout(() => reject(ErrorFactory.toolTimeout("batchExecution", timeoutMs)), timeoutMs);

package/dist/lib/mcp/externalServerManager.js

@@ -174,9 +174,12 @@ export class ExternalServerManager extends EventEmitter {
     constructor(config = {}, options = {}) {
         super();
         // Set defaults for configuration
+        // Default timeout increased to 60s and made configurable via MCP_CLIENT_TIMEOUT
+        // to accommodate MCP server startup latency (especially concurrent stdio servers)
+        const defaultMcpTimeout = Math.max(5000, Number(process.env.MCP_CLIENT_TIMEOUT) || 60000);
         this.config = {
             maxServers: config.maxServers ?? 10,
-            defaultTimeout: config.defaultTimeout ?? 10000,
+            defaultTimeout: config.defaultTimeout ?? defaultMcpTimeout,
             defaultHealthCheckInterval: config.defaultHealthCheckInterval ?? 30000,
             enableAutoRestart: config.enableAutoRestart ?? true,
             maxRestartAttempts: config.maxRestartAttempts ?? 3,
@@ -1401,7 +1404,7 @@ export class ExternalServerManager extends EventEmitter {
                         else {
                             // Other HITL error (configuration, system error, etc.)
                             mcpLogger.error(`[ExternalServerManager] HITL confirmation failed for external tool '${toolName}':`, error);
-                            throw new Error(`HITL confirmation failed: ${error instanceof Error ? error.message : String(error)}`);
+                            throw new Error(`HITL confirmation failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
                         }
                     }
                 }

package/dist/lib/mcp/factory.js

@@ -28,7 +28,7 @@ const ServerConfigSchema = z.object({
     ])
         .optional(),
     visibility: z.enum(["public", "private", "organization"]).optional(),
-    metadata: z.record(z.unknown()).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
     dependencies: z.array(z.string()).optional(),
     capabilities: z.array(z.string()).optional(),
 });

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

@@ -17,7 +17,7 @@ export { createMCPServer, getServerInfo, validateServerTools, validateTool, } fr
 export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
 export { DEFAULT_RATE_LIMIT_CONFIG, globalRateLimiterManager, HTTPRateLimiter, RateLimiterManager, } from "./httpRateLimiter.js";
 export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableHTTPError, isRetryableStatusCode, withHTTPRetry, } from "./httpRetryHandler.js";
-export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, } from "./mcpCircuitBreaker.js";
+export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, CircuitBreakerOpenError, } from "./mcpCircuitBreaker.js";
 export { MCPToolRegistry } from "./toolRegistry.js";
 export { ExternalServerManager } from "./externalServerManager.js";
 export { MCPClientFactory } from "./mcpClientFactory.js";

package/dist/lib/mcp/index.js

@@ -9,7 +9,7 @@ export { DEFAULT_RATE_LIMIT_CONFIG, globalRateLimiterManager, HTTPRateLimiter, R
 // HTTP Retry Handler
 export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableHTTPError, isRetryableStatusCode, withHTTPRetry, } from "./httpRetryHandler.js";
 // Circuit Breaker
-export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, } from "./mcpCircuitBreaker.js";
+export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, CircuitBreakerOpenError, } from "./mcpCircuitBreaker.js";
 // Core MCP Components
 export { MCPToolRegistry } from "./toolRegistry.js";
 export { ExternalServerManager } from "./externalServerManager.js";

package/dist/lib/mcp/mcpCircuitBreaker.d.ts

@@ -5,6 +5,7 @@
  */
 import { EventEmitter } from "events";
 import type { CircuitBreakerConfig, CircuitBreakerStats } from "../types/mcpTypes.js";
+export { CircuitBreakerOpenError } from "../types/circuitBreakerErrors.js";
 /**
  * MCPCircuitBreaker
  * Implements circuit breaker pattern for fault tolerance

package/dist/lib/mcp/mcpCircuitBreaker.js

@@ -6,6 +6,16 @@
 import { EventEmitter } from "events";
 import { trace } from "@opentelemetry/api";
 import { mcpLogger } from "../utils/logger.js";
+import { CircuitBreakerOpenError } from "../types/circuitBreakerErrors.js";
+// Re-export CircuitBreakerOpenError from shared types to preserve public API
+export { CircuitBreakerOpenError } from "../types/circuitBreakerErrors.js";
+/**
+ * Default operation timeout for circuit breaker protected operations.
+ * Configurable via MCP_OPERATION_TIMEOUT env var (in milliseconds).
+ * Increased from 30s to 60s to accommodate MCP server startup latency,
+ * especially when multiple servers start concurrently.
+ */
+const DEFAULT_OPERATION_TIMEOUT = Math.max(10000, Number(process.env.MCP_OPERATION_TIMEOUT) || 60000);
 /**
  * MCPCircuitBreaker
  * Implements circuit breaker pattern for fault tolerance
@@ -28,7 +38,7 @@ export class MCPCircuitBreaker extends EventEmitter {
             failureThreshold: config.failureThreshold ?? 5,
             resetTimeout: config.resetTimeout ?? 60000,
             halfOpenMaxCalls: config.halfOpenMaxCalls ?? 3,
-            operationTimeout: config.operationTimeout ?? 30000,
+            operationTimeout: config.operationTimeout ?? DEFAULT_OPERATION_TIMEOUT,
             minimumCallsBeforeCalculation: config.minimumCallsBeforeCalculation ?? 10,
             statisticsWindowSize: config.statisticsWindowSize ?? 300000, // 5 minutes
         };
@@ -43,8 +53,15 @@ export class MCPCircuitBreaker extends EventEmitter {
         try {
             // Check if circuit is open
             if (this.state === "open") {
-                if (Date.now() - this.lastFailureTime < this.config.resetTimeout) {
-                    throw new Error(`Circuit breaker '${this.name}' is open. Next retry at ${new Date(this.lastFailureTime + this.config.resetTimeout)}`);
+                const retryAfterMs = this.config.resetTimeout - (Date.now() - this.lastFailureTime);
+                if (retryAfterMs > 0) {
+                    throw new CircuitBreakerOpenError({
+                        breakerName: this.name,
+                        retryAfter: new Date(this.lastFailureTime + this.config.resetTimeout),
+                        retryAfterMs,
+                        breakerState: "open",
+                        failureCount: this.getStats().failedCalls,
+                    });
                 }
                 // Transition to half-open
                 this.changeState("half-open", "Reset timeout reached");
@@ -52,7 +69,16 @@ export class MCPCircuitBreaker extends EventEmitter {
             // Check half-open call limit
             if (this.state === "half-open" &&
                 this.halfOpenCalls >= this.config.halfOpenMaxCalls) {
-                throw new Error(`Circuit breaker '${this.name}' is half-open but call limit reached`);
+                // Half-open call limit exceeded — revert to open with fresh cooldown
+                this.lastFailureTime = Date.now();
+                this.changeState("open", "Half-open call limit reached, reverting to open");
+                throw new CircuitBreakerOpenError({
+                    breakerName: this.name,
+                    retryAfter: new Date(this.lastFailureTime + this.config.resetTimeout),
+                    retryAfterMs: this.config.resetTimeout,
+                    breakerState: "open",
+                    failureCount: this.getStats().failedCalls,
+                });
             }
             // NLK-GAP-009: Record half-open test event when executing in half-open state
             if (this.state === "half-open") {