@juspay/neurolink 9.26.2 → 9.28.0

package/dist/mcp/index.d.ts

@@ -2,15 +2,52 @@
  * MCP Ecosystem - Main Export
  * Universal AI Development Platform with Extensible Plugin Architecture
  * Implementation based on research blueprint
+ *
+ * Enhanced in Phase 8.39.0 with:
+ * - MCPServerBase - Abstract base class for creating MCP servers
+ * - Tool Annotations - Enhanced tool hints and metadata
+ * - Elicitation Protocol - Interactive tool input during execution
+ * - Multi-Server Manager - Load balancing and coordination
+ * - Enhanced Tool Discovery - Advanced search and filtering
  */
 import type { McpMetadata } from "../types/mcpTypes.js";
 export type { AuthorizationUrlResult, HTTPRetryConfig, MCPOAuthConfig, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "../types/mcpTypes.js";
 export { mcpLogger } from "../utils/logger.js";
-export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
 export { createMCPServer, getServerInfo, validateServerTools, validateTool, } from "./factory.js";
+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 { MCPToolRegistry } from "./toolRegistry.js";
+export { ExternalServerManager } from "./externalServerManager.js";
+export { MCPClientFactory } from "./mcpClientFactory.js";
+export type { ExposableAgent, ExposableWorkflow, ExposureOptions, ExposureResult, } from "./agentExposure.js";
+export { AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, } from "./agentExposure.js";
+export type { ConfirmationElicitation, Elicitation, ElicitationContext, ElicitationHandler, ElicitationManagerConfig, ElicitationRequest, ElicitationResponse, ElicitationType, FileElicitation, FormElicitation, FormField, MultiSelectElicitation, SecretElicitation, SelectElicitation, SelectOption, TextElicitation, } from "./elicitation/index.js";
+export { ElicitationManager, globalElicitationManager, } from "./elicitation/index.js";
+export type { ElicitationCancelMessage, ElicitationCancelParams, ElicitationProtocolAdapterConfig, ElicitationProtocolHandler, ElicitationProtocolMessage, ElicitationProtocolMessageType, ElicitationProtocolPayload, ElicitationRequestMessage, ElicitationRequestParams, ElicitationResponseMessage, ElicitationResponseParams, } from "./elicitationProtocol.js";
+export { createConfirmationRequest, createElicitationCancel, createElicitationRequest, createElicitationResponse, createFormRequest, createSelectRequest, createTextInputRequest, ElicitationProtocolAdapter, elicitationResponseToProtocol, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, } from "./elicitationProtocol.js";
+export type { CompatibilityCheckResult, EnhancedToolInfo, ToolSearchCriteria, ToolSearchResult, } from "./enhancedToolDiscovery.js";
+export { EnhancedToolDiscovery } from "./enhancedToolDiscovery.js";
+export type { MCPRegistryClientConfig, RegistryConfig, RegistryEntry, RegistrySearchOptions, RegistrySearchResult, RegistrySourceType, } from "./mcpRegistryClient.js";
+export { getAllWellKnownServers, getWellKnownServer, globalMCPRegistryClient, MCPRegistryClient, } from "./mcpRegistryClient.js";
+export type { MCPServerBaseConfig, MCPServerEvents, MCPServerTool, MCPToolAnnotations, } from "./mcpServerBase.js";
+export { MCPServerBase } from "./mcpServerBase.js";
+export type { LoadBalancingStrategy, MultiServerManagerConfig, ServerGroup, ServerWeight, UnifiedTool, } from "./multiServerManager.js";
+export { globalMultiServerManager, MultiServerManager, } from "./multiServerManager.js";
+export type { MCPPrompt, MCPResource, PromptGenerator, PromptMessage, PromptResult, RegisteredPrompt, RegisteredResource, ResourceContent, ResourceReader, ResourceSubscriptionCallback, ServerCapabilitiesConfig, } from "./serverCapabilities.js";
+export { createJsonResource, createPrompt, createTextResource, ServerCapabilitiesManager, } from "./serverCapabilities.js";
+export { createAnnotatedTool, filterToolsByAnnotations, getAnnotationSummary, getToolSafetyLevel, inferAnnotations, isSafeToRetry, mergeAnnotations, requiresConfirmation, validateAnnotations, } from "./toolAnnotations.js";
+export type { MCPProtocolTool, NeuroLinkTool, ToolConverterOptions, } from "./toolConverter.js";
+export { batchConvertToMCP, batchConvertToNeuroLink, createToolFromFunction, mcpProtocolToolToServerTool, mcpToolToNeuroLink, neuroLinkToolToMCP, sanitizeToolName, serverToolToMCPProtocol, TOOL_COMPATIBILITY, validateToolName, } from "./toolConverter.js";
+export type { EnhancedExecutionContext, ToolMiddleware, ToolWrapperOptions, } from "./toolIntegration.js";
+export { confirmationMiddleware, createElicitationContext, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, globalToolIntegrationManager, loggingMiddleware, ToolIntegrationManager, validationMiddleware, wrapToolsWithElicitation, wrapToolWithElicitation, } from "./toolIntegration.js";
+export type { BatchConfig, BatchExecutor, BatcherEvents, BatchResult, } from "./batching/index.js";
+export { createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, RequestBatcher, ToolCallBatcher, } from "./batching/index.js";
+export type { CacheConfig, CacheEvents, CacheStats, CacheStrategy, } from "./caching/index.js";
+export { createToolCache, createToolResultCache, DEFAULT_CACHE_CONFIG, ToolCache, ToolResultCache, } from "./caching/index.js";
+export type { AffinityRule, CategoryMapping, MCPTool, RoutingDecision, RoutingStrategy, ServerWeight as RouterServerWeight, ToolRouterConfig, ToolRouterEvents, } from "./routing/index.js";
+export { createToolRouter, DEFAULT_ROUTER_CONFIG, ToolRouter, } from "./routing/index.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */

package/dist/mcp/index.js

@@ -1,14 +1,47 @@
+import { ErrorFactory } from "../utils/errorHandling.js";
 export { mcpLogger } from "../utils/logger.js";
-// OAuth Authentication
-export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
 // MCP Server Factory
 export { createMCPServer, getServerInfo, validateServerTools, validateTool, } from "./factory.js";
+// OAuth Authentication
+export { calculateExpiresAt, createOAuthProviderFromConfig, FileTokenStorage, InMemoryTokenStorage, isTokenExpired, NeuroLinkOAuthProvider, } from "./auth/index.js";
 // HTTP Rate Limiter
 export { DEFAULT_RATE_LIMIT_CONFIG, globalRateLimiterManager, HTTPRateLimiter, RateLimiterManager, } from "./httpRateLimiter.js";
 // HTTP Retry Handler
 export { DEFAULT_HTTP_RETRY_CONFIG, isRetryableHTTPError, isRetryableStatusCode, withHTTPRetry, } from "./httpRetryHandler.js";
 // Circuit Breaker
 export { CircuitBreakerManager, globalCircuitBreakerManager, MCPCircuitBreaker, } from "./mcpCircuitBreaker.js";
+// Core MCP Components
+export { MCPToolRegistry } from "./toolRegistry.js";
+export { ExternalServerManager } from "./externalServerManager.js";
+export { MCPClientFactory } from "./mcpClientFactory.js";
+// Agent and Workflow Exposure
+export { AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, } from "./agentExposure.js";
+// Elicitation Protocol - Manager
+export { ElicitationManager, globalElicitationManager, } from "./elicitation/index.js";
+// Elicitation Protocol - Protocol Layer
+export { createConfirmationRequest, createElicitationCancel, createElicitationRequest, createElicitationResponse, createFormRequest, createSelectRequest, createTextInputRequest, ElicitationProtocolAdapter, elicitationResponseToProtocol, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, } from "./elicitationProtocol.js";
+// Enhanced Tool Discovery
+export { EnhancedToolDiscovery } from "./enhancedToolDiscovery.js";
+// MCP Registry Client
+export { getAllWellKnownServers, getWellKnownServer, globalMCPRegistryClient, MCPRegistryClient, } from "./mcpRegistryClient.js";
+// MCP Server Base Class
+export { MCPServerBase } from "./mcpServerBase.js";
+// Multi-Server Manager
+export { globalMultiServerManager, MultiServerManager, } from "./multiServerManager.js";
+// Server Capabilities (Resources and Prompts)
+export { createJsonResource, createPrompt, createTextResource, ServerCapabilitiesManager, } from "./serverCapabilities.js";
+// Tool Annotations System
+export { createAnnotatedTool, filterToolsByAnnotations, getAnnotationSummary, getToolSafetyLevel, inferAnnotations, isSafeToRetry, mergeAnnotations, requiresConfirmation, validateAnnotations, } from "./toolAnnotations.js";
+// Tool Converter Utilities
+export { batchConvertToMCP, batchConvertToNeuroLink, createToolFromFunction, mcpProtocolToolToServerTool, mcpToolToNeuroLink, neuroLinkToolToMCP, sanitizeToolName, serverToolToMCPProtocol, TOOL_COMPATIBILITY, validateToolName, } from "./toolConverter.js";
+// Tool Integration with Elicitation
+export { confirmationMiddleware, createElicitationContext, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, globalToolIntegrationManager, loggingMiddleware, ToolIntegrationManager, validationMiddleware, wrapToolsWithElicitation, wrapToolWithElicitation, } from "./toolIntegration.js";
+// Request Batcher - Efficient batch processing
+export { createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, RequestBatcher, ToolCallBatcher, } from "./batching/index.js";
+// Tool Cache - Result and response caching
+export { createToolCache, createToolResultCache, DEFAULT_CACHE_CONFIG, ToolCache, ToolResultCache, } from "./caching/index.js";
+// Tool Router - Intelligent routing for multi-server environments
+export { createToolRouter, DEFAULT_ROUTER_CONFIG, ToolRouter, } from "./routing/index.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */
@@ -26,7 +59,7 @@ export async function listMCPs() {
  * Execute an MCP operation - simplified
  */
 export async function executeMCP(_name, _config, _args, _context) {
-    throw new Error("MCP execution not available - ecosystem removed");
+    throw ErrorFactory.invalidConfiguration("executeMCP", "Direct legacy MCP execution is deprecated. Use the new module APIs (createMCPServer, MultiServerManager, ToolRouter, etc.) instead.");
 }
 /**
  * Get MCP ecosystem statistics - simplified

package/dist/mcp/mcpRegistryClient.d.ts

@@ -0,0 +1,332 @@
+/**
+ * MCP Registry Client
+ *
+ * Client for discovering MCP servers from centralized registries.
+ * Supports multiple registry sources including:
+ * - Official MCP Registry
+ * - NPM packages
+ * - GitHub repositories
+ * - Custom registries
+ *
+ * @module mcp/mcpRegistryClient
+ * @since 8.39.0
+ */
+import { EventEmitter } from "events";
+import type { MCPServerInfo, MCPTransportType } from "../types/mcpTypes.js";
+import type { JsonObject } from "../types/common.js";
+/**
+ * Registry source types
+ */
+export type RegistrySourceType = "official" | "npm" | "github" | "custom";
+/**
+ * Registry entry for an MCP server
+ */
+export type RegistryEntry = {
+    /**
+     * Unique identifier
+     */
+    id: string;
+    /**
+     * Server name
+     */
+    name: string;
+    /**
+     * Server description
+     */
+    description: string;
+    /**
+     * Server version
+     */
+    version: string;
+    /**
+     * Author or maintainer
+     */
+    author?: string;
+    /**
+     * License
+     */
+    license?: string;
+    /**
+     * Homepage URL
+     */
+    homepage?: string;
+    /**
+     * Repository URL
+     */
+    repository?: string;
+    /**
+     * NPM package name (if applicable)
+     */
+    npmPackage?: string;
+    /**
+     * Installation command
+     */
+    installCommand?: string;
+    /**
+     * Command to run the server
+     */
+    command?: string;
+    /**
+     * Command arguments
+     */
+    args?: string[];
+    /**
+     * Required environment variables
+     */
+    requiredEnvVars?: string[];
+    /**
+     * Supported transport types
+     */
+    transports?: MCPTransportType[];
+    /**
+     * Server categories
+     */
+    categories?: string[];
+    /**
+     * Server tags
+     */
+    tags?: string[];
+    /**
+     * Tool names provided by the server
+     */
+    tools?: string[];
+    /**
+     * Download count (popularity metric)
+     */
+    downloads?: number;
+    /**
+     * Star count (if from GitHub)
+     */
+    stars?: number;
+    /**
+     * Last updated date
+     */
+    lastUpdated?: string;
+    /**
+     * Verification status
+     */
+    verified?: boolean;
+    /**
+     * Custom metadata
+     */
+    metadata?: JsonObject;
+};
+/**
+ * Registry configuration
+ */
+export type RegistryConfig = {
+    /**
+     * Registry type
+     */
+    type: RegistrySourceType;
+    /**
+     * Registry URL or identifier
+     */
+    url?: string;
+    /**
+     * Authentication token
+     */
+    authToken?: string;
+    /**
+     * Request timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Enable caching
+     */
+    enableCache?: boolean;
+    /**
+     * Cache TTL in milliseconds
+     */
+    cacheTTL?: number;
+};
+/**
+ * Search options for registry queries
+ */
+export type RegistrySearchOptions = {
+    /**
+     * Search query (name, description, tags)
+     */
+    query?: string;
+    /**
+     * Filter by categories
+     */
+    categories?: string[];
+    /**
+     * Filter by tags
+     */
+    tags?: string[];
+    /**
+     * Filter by transport type
+     */
+    transport?: MCPTransportType;
+    /**
+     * Only verified servers
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Sort by field
+     */
+    sortBy?: "name" | "downloads" | "stars" | "lastUpdated";
+    /**
+     * Sort direction
+     */
+    sortDirection?: "asc" | "desc";
+    /**
+     * Maximum results
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: number;
+};
+/**
+ * Search result
+ */
+export type RegistrySearchResult = {
+    entries: RegistryEntry[];
+    totalCount: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+};
+/**
+ * Registry client configuration
+ */
+export type MCPRegistryClientConfig = {
+    /**
+     * Default registries to use
+     */
+    registries?: RegistryConfig[];
+    /**
+     * Enable automatic caching
+     */
+    enableCache?: boolean;
+    /**
+     * Default cache TTL
+     */
+    defaultCacheTTL?: number;
+    /**
+     * Request timeout
+     */
+    timeout?: number;
+    /**
+     * User agent string
+     */
+    userAgent?: string;
+};
+/**
+ * MCP Registry Client
+ *
+ * Provides methods to discover and install MCP servers from registries.
+ *
+ * @example
+ * ```typescript
+ * const client = new MCPRegistryClient();
+ *
+ * // Search for servers
+ * const results = await client.search({ query: "database" });
+ *
+ * // Get server details
+ * const entry = await client.getEntry("postgres");
+ *
+ * // Convert to MCPServerInfo
+ * const serverInfo = client.toServerInfo(entry);
+ * ```
+ */
+export declare class MCPRegistryClient extends EventEmitter {
+    private config;
+    private cache;
+    private customEntries;
+    constructor(config?: MCPRegistryClientConfig);
+    /**
+     * Search the registry
+     */
+    search(options?: RegistrySearchOptions): Promise<RegistrySearchResult>;
+    /**
+     * Get a specific entry by ID
+     */
+    getEntry(id: string): Promise<RegistryEntry | undefined>;
+    /**
+     * Get all available entries
+     */
+    getAllEntries(): Promise<RegistryEntry[]>;
+    /**
+     * Get entries by category
+     */
+    getByCategory(category: string): Promise<RegistryEntry[]>;
+    /**
+     * Get entries by tag
+     */
+    getByTag(tag: string): Promise<RegistryEntry[]>;
+    /**
+     * Get all categories
+     */
+    getCategories(): Promise<string[]>;
+    /**
+     * Get all tags
+     */
+    getTags(): Promise<string[]>;
+    /**
+     * Convert registry entry to MCPServerInfo
+     */
+    toServerInfo(entry: RegistryEntry): MCPServerInfo;
+    /**
+     * Add a custom registry entry
+     */
+    addCustomEntry(entry: RegistryEntry): void;
+    /**
+     * Remove a custom registry entry
+     */
+    removeCustomEntry(id: string): boolean;
+    /**
+     * Add a registry configuration
+     */
+    addRegistry(config: RegistryConfig): void;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Check if required environment variables are set
+     */
+    checkRequiredEnvVars(entry: RegistryEntry): {
+        ready: boolean;
+        missing: string[];
+    };
+    /**
+     * Get installation command for an entry
+     */
+    getInstallCommand(entry: RegistryEntry): string | undefined;
+    /**
+     * Get popular servers
+     */
+    getPopularServers(limit?: number): Promise<RegistryEntry[]>;
+    /**
+     * Get verified servers
+     */
+    getVerifiedServers(): Promise<RegistryEntry[]>;
+    /**
+     * Get statistics
+     */
+    getStatistics(): Promise<{
+        totalEntries: number;
+        verifiedEntries: number;
+        categories: number;
+        tags: number;
+        customEntries: number;
+    }>;
+}
+/**
+ * Global MCP registry client instance
+ */
+export declare const globalMCPRegistryClient: MCPRegistryClient;
+/**
+ * Quick lookup function for well-known servers
+ */
+export declare function getWellKnownServer(id: string): RegistryEntry | undefined;
+/**
+ * Get all well-known servers
+ */
+export declare function getAllWellKnownServers(): RegistryEntry[];