@juspay/neurolink 9.27.0 → 9.28.1

package/dist/lib/constants/enums.d.ts

@@ -58,10 +58,15 @@ export declare enum BedrockModels {
     CLAUDE_4_5_HAIKU = "anthropic.claude-haiku-4-5-20251001-v1:0",
     CLAUDE_4_1_OPUS = "anthropic.claude-opus-4-1-20250805-v1:0",
     CLAUDE_4_SONNET = "anthropic.claude-sonnet-4-20250514-v1:0",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_7_SONNET = "anthropic.claude-3-7-sonnet-20250219-v1:0",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_5_SONNET = "anthropic.claude-3-5-sonnet-20241022-v1:0",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_5_HAIKU = "anthropic.claude-3-5-haiku-20241022-v1:0",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_SONNET = "anthropic.claude-3-sonnet-20240229-v1:0",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_HAIKU = "anthropic.claude-3-haiku-20240307-v1:0",
     NOVA_PREMIER = "amazon.nova-premier-v1:0",
     NOVA_PRO = "amazon.nova-pro-v1:0",
@@ -144,6 +149,10 @@ export declare enum BedrockModels {
  */
 export declare enum OpenAIModels {
     GPT_5_3_CODEX = "gpt-5.3-codex",
+    GPT_5_4 = "gpt-5.4",
+    GPT_5_4_MINI = "gpt-5.4-mini",
+    GPT_5_4_NANO = "gpt-5.4-nano",
+    GPT_5_4_PRO = "gpt-5.4-pro",
     GPT_5_2 = "gpt-5.2",
     GPT_5_2_CHAT_LATEST = "gpt-5.2-chat-latest",
     GPT_5_2_PRO = "gpt-5.2-pro",
@@ -171,7 +180,9 @@ export declare enum OpenAIModels {
     O3_PRO = "o3-pro",
     O4_MINI = "o4-mini",
     O1 = "o1",
+    /** @deprecated Turned off Jul 14, 2025. Use GPT_4_1 or O3. */
     O1_PREVIEW = "o1-preview",
+    /** @deprecated Replaced by o3-mini. */
     O1_MINI = "o1-mini",
     GPT_4 = "gpt-4",
     GPT_4_TURBO = "gpt-4-turbo",
@@ -186,6 +197,9 @@ export declare enum AzureOpenAIModels {
     GPT_5_2_CHAT = "gpt-5.2-chat",
     GPT_5_2_PRO = "gpt-5.2-pro",
     GPT_5_2_CODEX = "gpt-5.2-codex",
+    GPT_5_4 = "gpt-5.4",
+    GPT_5_4_MINI = "gpt-5.4-mini",
+    GPT_5_4_NANO = "gpt-5.4-nano",
     GPT_5_1 = "gpt-5.1",
     GPT_5_1_CHAT = "gpt-5.1-chat",
     GPT_5_1_CODEX = "gpt-5.1-codex",
@@ -228,11 +242,17 @@ export declare enum VertexModels {
     CLAUDE_4_5_HAIKU = "claude-haiku-4-5@20251001",
     CLAUDE_4_0_SONNET = "claude-sonnet-4@20250514",
     CLAUDE_4_0_OPUS = "claude-opus-4@20250514",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_7_SONNET = "claude-3-7-sonnet@20250219",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_OPUS = "claude-3-opus-20240229",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     CLAUDE_3_HAIKU = "claude-3-haiku-20240307",
     GEMINI_3_1_PRO = "gemini-3.1-pro",
     GEMINI_3_1_PRO_PREVIEW = "gemini-3.1-pro-preview",
@@ -253,9 +273,9 @@ export declare enum VertexModels {
     GEMINI_2_0_FLASH = "gemini-2.0-flash",
     GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
     GEMINI_2_0_FLASH_LITE = "gemini-2.0-flash-lite",
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GEMINI_1_5_PRO = "gemini-1.5-pro-002",
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GEMINI_1_5_FLASH = "gemini-1.5-flash-002"
 }
 /**
@@ -277,16 +297,18 @@ export declare enum GoogleAIModels {
     GEMINI_2_5_FLASH_IMAGE = "gemini-2.5-flash-image",
     GEMINI_2_5_FLASH_PREVIEW_TTS = "gemini-2.5-flash-preview-tts",
     GEMINI_2_5_PRO_PREVIEW_TTS = "gemini-2.5-pro-preview-tts",
+    /** @deprecated Retiring June 1, 2026. Use GEMINI_2_5_FLASH instead. */
     GEMINI_2_0_FLASH = "gemini-2.0-flash",
     GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
     GEMINI_2_0_FLASH_LITE = "gemini-2.0-flash-lite",
     GEMINI_2_0_FLASH_IMAGE = "gemini-2.0-flash-preview-image-generation",
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GEMINI_1_5_PRO = "gemini-1.5-pro",
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GEMINI_1_5_FLASH = "gemini-1.5-flash",
     GEMINI_EMBEDDING = "gemini-embedding-001",
-    /** @deprecated Shutdown Jan 2026. Use gemini-embedding-001 */
+    GEMINI_EMBEDDING_2_PREVIEW = "gemini-embedding-2-preview",
+    /** @deprecated SHUT DOWN Jan 14, 2026. Use GEMINI_EMBEDDING instead. */
     TEXT_EMBEDDING_004 = "text-embedding-004"
 }
 /**
@@ -301,11 +323,17 @@ export declare enum AnthropicModels {
     CLAUDE_OPUS_4_1 = "claude-opus-4-1-20250805",
     CLAUDE_OPUS_4_0 = "claude-opus-4-20250514",
     CLAUDE_SONNET_4_0 = "claude-sonnet-4-20250514",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_SONNET_3_7 = "claude-3-7-sonnet-20250219",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_3_OPUS = "claude-3-opus-20240229",
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     CLAUDE_3_HAIKU = "claude-3-haiku-20240307"
 }
 /**
@@ -341,7 +369,9 @@ export declare enum MistralModels {
     MISTRAL_OCR_LATEST = "mistral-ocr-latest",
     MISTRAL_NEMO = "mistral-nemo",
     MISTRAL_EMBED = "mistral-embed",
-    MISTRAL_MODERATION_LATEST = "mistral-moderation-latest"
+    MISTRAL_MODERATION_LATEST = "mistral-moderation-latest",
+    MISTRAL_SMALL_4 = "mistral-small-2603",
+    MISTRAL_SMALL_CREATIVE = "mistral-small-creative"
 }
 /**
  * Supported Models for Ollama (Local)

package/dist/lib/constants/enums.js

@@ -78,12 +78,17 @@ export var BedrockModels;
     BedrockModels["CLAUDE_4_1_OPUS"] = "anthropic.claude-opus-4-1-20250805-v1:0";
     BedrockModels["CLAUDE_4_SONNET"] = "anthropic.claude-sonnet-4-20250514-v1:0";
     // Claude 3.7 Series
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     BedrockModels["CLAUDE_3_7_SONNET"] = "anthropic.claude-3-7-sonnet-20250219-v1:0";
     // Claude 3.5 Series
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     BedrockModels["CLAUDE_3_5_SONNET"] = "anthropic.claude-3-5-sonnet-20241022-v1:0";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     BedrockModels["CLAUDE_3_5_HAIKU"] = "anthropic.claude-3-5-haiku-20241022-v1:0";
     // Claude 3 Series (Legacy support)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     BedrockModels["CLAUDE_3_SONNET"] = "anthropic.claude-3-sonnet-20240229-v1:0";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     BedrockModels["CLAUDE_3_HAIKU"] = "anthropic.claude-3-haiku-20240307-v1:0";
     // ============================================================================
     // AMAZON NOVA MODELS
@@ -216,6 +221,11 @@ export var OpenAIModels;
 (function (OpenAIModels) {
     // GPT-5.3 Series (Released February 2026) - Latest coding models
     OpenAIModels["GPT_5_3_CODEX"] = "gpt-5.3-codex";
+    // GPT-5.4 Series (Released March 2026) - Latest flagship models
+    OpenAIModels["GPT_5_4"] = "gpt-5.4";
+    OpenAIModels["GPT_5_4_MINI"] = "gpt-5.4-mini";
+    OpenAIModels["GPT_5_4_NANO"] = "gpt-5.4-nano";
+    OpenAIModels["GPT_5_4_PRO"] = "gpt-5.4-pro";
     // GPT-5.2 Series (Released December 11, 2025) - Flagship models
     OpenAIModels["GPT_5_2"] = "gpt-5.2";
     OpenAIModels["GPT_5_2_CHAT_LATEST"] = "gpt-5.2-chat-latest";
@@ -250,7 +260,9 @@ export var OpenAIModels;
     OpenAIModels["O3_PRO"] = "o3-pro";
     OpenAIModels["O4_MINI"] = "o4-mini";
     OpenAIModels["O1"] = "o1";
+    /** @deprecated Turned off Jul 14, 2025. Use GPT_4_1 or O3. */
     OpenAIModels["O1_PREVIEW"] = "o1-preview";
+    /** @deprecated Replaced by o3-mini. */
     OpenAIModels["O1_MINI"] = "o1-mini";
     // GPT-4 Series (Legacy)
     OpenAIModels["GPT_4"] = "gpt-4";
@@ -269,6 +281,10 @@ export var AzureOpenAIModels;
     AzureOpenAIModels["GPT_5_2_CHAT"] = "gpt-5.2-chat";
     AzureOpenAIModels["GPT_5_2_PRO"] = "gpt-5.2-pro";
     AzureOpenAIModels["GPT_5_2_CODEX"] = "gpt-5.2-codex";
+    // GPT-5.4 Series (March 2026)
+    AzureOpenAIModels["GPT_5_4"] = "gpt-5.4";
+    AzureOpenAIModels["GPT_5_4_MINI"] = "gpt-5.4-mini";
+    AzureOpenAIModels["GPT_5_4_NANO"] = "gpt-5.4-nano";
     // GPT-5.1 Series (October 2025)
     AzureOpenAIModels["GPT_5_1"] = "gpt-5.1";
     AzureOpenAIModels["GPT_5_1_CHAT"] = "gpt-5.1-chat";
@@ -323,13 +339,19 @@ export var VertexModels;
     VertexModels["CLAUDE_4_0_SONNET"] = "claude-sonnet-4@20250514";
     VertexModels["CLAUDE_4_0_OPUS"] = "claude-opus-4@20250514";
     // Claude 3.7 Series (February 2025)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_7_SONNET"] = "claude-3-7-sonnet@20250219";
     // Claude 3.5 Series (Still supported)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
     // Claude 3 Series (Legacy support)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_4_6_SONNET instead. */
     VertexModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
     // Gemini 3.1 Series (Released March 2026)
     VertexModels["GEMINI_3_1_PRO"] = "gemini-3.1-pro";
@@ -355,9 +377,9 @@ export var VertexModels;
     VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
     VertexModels["GEMINI_2_0_FLASH_LITE"] = "gemini-2.0-flash-lite";
     // Gemini 1.5 Series (Retired - returns 404)
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     VertexModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro-002";
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     VertexModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash-002";
 })(VertexModels || (VertexModels = {}));
 /**
@@ -384,18 +406,20 @@ export var GoogleAIModels;
     GoogleAIModels["GEMINI_2_5_FLASH_PREVIEW_TTS"] = "gemini-2.5-flash-preview-tts";
     GoogleAIModels["GEMINI_2_5_PRO_PREVIEW_TTS"] = "gemini-2.5-pro-preview-tts";
     // Gemini 2.0 Series (Deprecated - retiring Jun 2026)
+    /** @deprecated Retiring June 1, 2026. Use GEMINI_2_5_FLASH instead. */
     GoogleAIModels["GEMINI_2_0_FLASH"] = "gemini-2.0-flash";
     GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
     GoogleAIModels["GEMINI_2_0_FLASH_LITE"] = "gemini-2.0-flash-lite";
     GoogleAIModels["GEMINI_2_0_FLASH_IMAGE"] = "gemini-2.0-flash-preview-image-generation";
     // Gemini 1.5 Series (Retired - returns 404)
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GoogleAIModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
-    /** @deprecated Retired Sep 2025. Use Gemini 2.5+ */
+    /** @deprecated SHUT DOWN. Returns 404. Use GEMINI_2_5_FLASH or newer. */
     GoogleAIModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
     // Embedding Models
     GoogleAIModels["GEMINI_EMBEDDING"] = "gemini-embedding-001";
-    /** @deprecated Shutdown Jan 2026. Use gemini-embedding-001 */
+    GoogleAIModels["GEMINI_EMBEDDING_2_PREVIEW"] = "gemini-embedding-2-preview";
+    /** @deprecated SHUT DOWN Jan 14, 2026. Use GEMINI_EMBEDDING instead. */
     GoogleAIModels["TEXT_EMBEDDING_004"] = "text-embedding-004";
 })(GoogleAIModels || (GoogleAIModels = {}));
 /**
@@ -416,13 +440,19 @@ export var AnthropicModels;
     AnthropicModels["CLAUDE_OPUS_4_0"] = "claude-opus-4-20250514";
     AnthropicModels["CLAUDE_SONNET_4_0"] = "claude-sonnet-4-20250514";
     // Claude 3.7 Series (Legacy)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_SONNET_3_7"] = "claude-3-7-sonnet-20250219";
     // Claude 3.5 Series (Legacy)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
     // Claude 3 Series (Legacy - Deprecated)
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
+    /** @deprecated Retired from Anthropic API. Use CLAUDE_SONNET_4_6 instead. */
     AnthropicModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
 })(AnthropicModels || (AnthropicModels = {}));
 /**
@@ -474,6 +504,9 @@ export var MistralModels;
     MistralModels["MISTRAL_NEMO"] = "mistral-nemo";
     MistralModels["MISTRAL_EMBED"] = "mistral-embed";
     MistralModels["MISTRAL_MODERATION_LATEST"] = "mistral-moderation-latest";
+    // Mistral Small 4 Series (June 2026)
+    MistralModels["MISTRAL_SMALL_4"] = "mistral-small-2603";
+    MistralModels["MISTRAL_SMALL_CREATIVE"] = "mistral-small-creative";
 })(MistralModels || (MistralModels = {}));
 /**
  * Supported Models for Ollama (Local)

package/dist/lib/constants/tokens.d.ts

@@ -71,6 +71,10 @@ export declare const PROVIDER_TOKEN_LIMITS: {
     };
     /** OpenAI model limits */
     readonly OPENAI: {
+        readonly "gpt-5.4": 128000;
+        readonly "gpt-5.4-mini": 128000;
+        readonly "gpt-5.4-nano": 128000;
+        readonly "gpt-5.4-pro": 128000;
         readonly "gpt-4o": 16384;
         readonly "gpt-4o-mini": 16384;
         readonly "gpt-3.5-turbo": 4096;

package/dist/lib/constants/tokens.js

@@ -74,6 +74,10 @@ export const PROVIDER_TOKEN_LIMITS = {
     },
     /** OpenAI model limits */
     OPENAI: {
+        "gpt-5.4": 128_000,
+        "gpt-5.4-mini": 128_000,
+        "gpt-5.4-nano": 128_000,
+        "gpt-5.4-pro": 128_000,
         "gpt-4o": 16384,
         "gpt-4o-mini": 16384,
         "gpt-3.5-turbo": 4096,

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

@@ -318,6 +318,32 @@ export class ToolsManager {
                     const startTime = Date.now();
                     let executionId;
                     try {
+                        // Route through NeuroLink.executeTool() when available for MCP enhancement support
+                        // (cache, middleware, annotations, circuit breaker, routing)
+                        if (this.toolExecutor) {
+                            const result = await this.toolExecutor(toolName, params);
+                            const convertedResult = this.utilities?.convertToolResult
+                                ? await this.utilities.convertToolResult(result)
+                                : result;
+                            const endTime = Date.now();
+                            customToolSpan.setAttribute("tool.duration_ms", endTime - startTime);
+                            let errorResult = undefined;
+                            if (convertedResult &&
+                                typeof convertedResult === "object" &&
+                                "isError" in convertedResult &&
+                                convertedResult.isError) {
+                                try {
+                                    errorResult = JSON.stringify(convertedResult);
+                                }
+                                catch (error) {
+                                    logger.error(`Failed to serialize error result for ${toolName}`, error);
+                                }
+                            }
+                            customToolSpan.setAttribute("tool.result.status", errorResult ? "error" : "success");
+                            customToolSpan.setStatus({ code: SpanStatusCode.OK });
+                            return convertedResult;
+                        }
+                        // Fallback: direct execution (standalone usage without NeuroLink SDK)
                         if (this.neurolink?.emitToolStart) {
                             executionId = this.neurolink.emitToolStart(toolName, params, startTime);
                         }
@@ -350,8 +376,9 @@ export class ToolsManager {
                     catch (error) {
                         const endTime = Date.now();
                         const errorMsg = error instanceof Error ? error.message : String(error);
-                        // Emit tool end event (error)
-                        if (this.neurolink?.emitToolEnd) {
+                        // Emit tool end event (error) — only for fallback path
+                        // When toolExecutor is used, executeTool() handles event emission
+                        if (!this.toolExecutor && this.neurolink?.emitToolEnd) {
                             this.neurolink.emitToolEnd(toolName, undefined, // no result
                             errorMsg, startTime, endTime, executionId);
                             logger.debug(`Custom tool error: ${toolName} (${endTime - startTime}ms)`, { error: errorMsg });

package/dist/lib/index.d.ts

@@ -200,7 +200,8 @@ 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, } 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, 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";
 export type { LogLevel } from "./types/utilities.js";

package/dist/lib/index.js

@@ -237,7 +237,33 @@ InMemoryTokenStorage,
 // Simplified MCP exports
 initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, 
 // Circuit Breaker
-MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, 
+// Core MCP Components
+MCPToolRegistry, ExternalServerManager, MCPClientFactory, 
+// MCP Enhancements - Routing, Caching, Batching
+ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, 
+// MCP Enhancements - Tool Annotations
+inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, 
+// MCP Enhancements - Elicitation
+ElicitationManager, globalElicitationManager, 
+// MCP Enhancements - Enhanced Tool Discovery
+EnhancedToolDiscovery, 
+// MCP Enhancements - Registry Client
+MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, 
+// MCP Enhancements - Server Base
+MCPServerBase, 
+// MCP Enhancements - Multi-Server Manager
+MultiServerManager, globalMultiServerManager, 
+// MCP Enhancements - Agent Exposure
+AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, 
+// MCP Enhancements - Server Capabilities
+ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, 
+// MCP Enhancements - Tool Converter
+neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, 
+// MCP Enhancements - Tool Integration
+ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, 
+// MCP Enhancements - Elicitation Protocol
+ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
 export { logger } from "./utils/logger.js";
 export { getPoolStats } from "./utils/redis.js";
 // ============================================================================

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

@@ -0,0 +1,228 @@
+/**
+ * Agent and Workflow Exposure as MCP Tools
+ *
+ * Enables exposing NeuroLink agents and workflows as MCP tools,
+ * allowing external MCP clients to invoke complex AI operations
+ * through the standardized MCP protocol.
+ *
+ * @module mcp/agentExposure
+ * @since 8.39.0
+ */
+import type { JsonObject } from "../types/common.js";
+import type { NeuroLinkExecutionContext } from "../types/mcpTypes.js";
+import type { MCPServerTool, MCPToolAnnotations } from "./toolAnnotations.js";
+/**
+ * Agent definition for MCP exposure
+ */
+export type ExposableAgent = {
+    /**
+     * Unique agent identifier
+     */
+    id: string;
+    /**
+     * Human-readable agent name
+     */
+    name: string;
+    /**
+     * Agent description for AI models
+     */
+    description: string;
+    /**
+     * Input schema for the agent
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the agent
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Agent execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Additional agent metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        costHint?: number;
+    };
+};
+/**
+ * Workflow definition for MCP exposure
+ */
+export type ExposableWorkflow = {
+    /**
+     * Unique workflow identifier
+     */
+    id: string;
+    /**
+     * Human-readable workflow name
+     */
+    name: string;
+    /**
+     * Workflow description
+     */
+    description: string;
+    /**
+     * Workflow steps (for documentation)
+     */
+    steps?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    /**
+     * Input schema for the workflow
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the workflow
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Workflow execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Workflow metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        retriable?: boolean;
+        idempotent?: boolean;
+    };
+};
+/**
+ * Options for exposing agents/workflows as MCP tools
+ */
+export type ExposureOptions = {
+    /**
+     * Prefix for tool names
+     */
+    prefix?: string;
+    /**
+     * Default annotations for all exposed tools
+     */
+    defaultAnnotations?: MCPToolAnnotations;
+    /**
+     * Whether to include metadata in tool description
+     */
+    includeMetadataInDescription?: boolean;
+    /**
+     * Custom name transformer
+     */
+    nameTransformer?: (name: string) => string;
+    /**
+     * Add execution context wrapper
+     */
+    wrapWithContext?: boolean;
+    /**
+     * Timeout for agent/workflow execution (ms)
+     */
+    executionTimeout?: number;
+    /**
+     * Enable execution logging
+     */
+    enableLogging?: boolean;
+};
+/**
+ * Exposure result
+ */
+export type ExposureResult = {
+    /**
+     * Generated MCP tool
+     */
+    tool: MCPServerTool;
+    /**
+     * Original source type
+     */
+    sourceType: "agent" | "workflow";
+    /**
+     * Original source ID
+     */
+    sourceId: string;
+    /**
+     * Generated tool name
+     */
+    toolName: string;
+};
+/**
+ * Expose an agent as an MCP tool
+ */
+export declare function exposeAgentAsTool(agent: ExposableAgent, options?: ExposureOptions): ExposureResult;
+/**
+ * Expose a workflow as an MCP tool
+ */
+export declare function exposeWorkflowAsTool(workflow: ExposableWorkflow, options?: ExposureOptions): ExposureResult;
+/**
+ * Batch expose agents as MCP tools
+ */
+export declare function exposeAgentsAsTools(agents: ExposableAgent[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Batch expose workflows as MCP tools
+ */
+export declare function exposeWorkflowsAsTools(workflows: ExposableWorkflow[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Agent Exposure Manager
+ *
+ * Manages the lifecycle of exposed agents and workflows,
+ * providing registration, lookup, and invocation capabilities.
+ */
+export declare class AgentExposureManager {
+    private exposedTools;
+    private options;
+    constructor(options?: ExposureOptions);
+    /**
+     * Expose an agent and register it
+     */
+    exposeAgent(agent: ExposableAgent): MCPServerTool;
+    /**
+     * Expose a workflow and register it
+     */
+    exposeWorkflow(workflow: ExposableWorkflow): MCPServerTool;
+    /**
+     * Get all exposed tools
+     */
+    getExposedTools(): MCPServerTool[];
+    /**
+     * Get exposed tool by name
+     */
+    getExposedTool(toolName: string): MCPServerTool | undefined;
+    /**
+     * Get exposure result by tool name
+     */
+    getExposureResult(toolName: string): ExposureResult | undefined;
+    /**
+     * Get tools by source type
+     */
+    getToolsBySourceType(sourceType: "agent" | "workflow"): MCPServerTool[];
+    /**
+     * Remove exposed tool
+     */
+    unexpose(toolName: string): boolean;
+    /**
+     * Clear all exposed tools
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStatistics(): {
+        totalExposed: number;
+        exposedAgents: number;
+        exposedWorkflows: number;
+        toolNames: string[];
+    };
+}
+/**
+ * Global agent exposure manager instance
+ */
+export declare const globalAgentExposureManager: AgentExposureManager;