@juspay/neurolink 1.6.0 → 1.10.0

package/dist/mcp/registry.d.ts

@@ -3,8 +3,8 @@
  * Central registry for managing MCP servers and tools with execution capabilities
  * Supports tool discovery, registration, and orchestrated execution
  */
-import type { NeuroLinkMCPServer, NeuroLinkMCPTool, NeuroLinkExecutionContext, ToolResult } from './factory.js';
-import { ContextManager } from './context-manager.js';
+import type { NeuroLinkMCPServer, NeuroLinkMCPTool, NeuroLinkExecutionContext, ToolResult } from "./factory.js";
+import { ContextManager } from "./context-manager.js";
 /**
  * Tool registration information
  */
@@ -149,8 +149,16 @@ export declare class MCPToolRegistry {
     private updateExecutionMetrics;
 }
 /**
- * Default registry instance
- * Can be used across the application for consistent tool management
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export declare function getDefaultToolRegistry(): MCPToolRegistry;
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
  */
 export declare const defaultToolRegistry: MCPToolRegistry;
 /**

package/dist/mcp/registry.js

@@ -3,7 +3,8 @@
  * Central registry for managing MCP servers and tools with execution capabilities
  * Supports tool discovery, registration, and orchestrated execution
  */
-import { ContextManager, ContextValidator } from './context-manager.js';
+import { ContextManager, ContextValidator } from "./context-manager.js";
+import { registryLogger, mcpLogger } from "./logging.js";
 /**
  * Central MCP Tool Registry
  * Manages all MCP servers and their tools with advanced execution capabilities
@@ -26,9 +27,10 @@ export class MCPToolRegistry {
      * @throws Error if server ID already exists
      */
     async registerServer(server) {
-        // Check for duplicate server ID
+        // Check for duplicate server ID - if already registered, skip silently
         if (this.servers.has(server.id)) {
-            throw new Error(`Server with ID '${server.id}' is already registered`);
+            mcpLogger.debug(`Server with ID '${server.id}' is already registered, skipping registration`);
+            return;
         }
         // Register the server
         this.servers.set(server.id, server);
@@ -36,7 +38,7 @@ export class MCPToolRegistry {
         for (const [toolName, tool] of Object.entries(server.tools)) {
             await this.registerToolFromServer(server, toolName, tool);
         }
-        console.log(`[MCPRegistry] Registered server '${server.id}' with ${Object.keys(server.tools).length} tools`);
+        registryLogger.debug(`Registered server '${server.id}' with ${Object.keys(server.tools).length} tools`);
     }
     /**
      * Register a single tool from a server
@@ -55,7 +57,7 @@ export class MCPToolRegistry {
             serverCategory: server.category,
             qualifiedName,
             simpleName,
-            registeredAt: Date.now()
+            registeredAt: Date.now(),
         };
         // Register with both qualified and simple names
         this.tools.set(qualifiedName, registration);
@@ -64,7 +66,7 @@ export class MCPToolRegistry {
             this.tools.set(simpleName, registration);
         }
         else {
-            console.warn(`[MCPRegistry] Tool name conflict: '${simpleName}' already exists, use qualified name '${qualifiedName}'`);
+            registryLogger.warn(`Tool name conflict: '${simpleName}' already exists, use qualified name '${qualifiedName}'`);
         }
     }
     /**
@@ -78,7 +80,7 @@ export class MCPToolRegistry {
      */
     async executeTool(toolName, params, context, options = {}) {
         const startTime = Date.now();
-        const { validateInput = true, validatePermissions = true, trackMetrics = true, timeoutMs = 30000 } = options;
+        const { validateInput = true, validatePermissions = true, trackMetrics = true, timeoutMs = 30000, } = options;
         try {
             // Find the tool
             const registration = this.tools.get(toolName);
@@ -90,11 +92,12 @@ export class MCPToolRegistry {
             if (validatePermissions) {
                 const contextValidation = ContextValidator.validateContext(context);
                 if (!contextValidation.isValid) {
-                    throw new Error(`Context validation failed: ${contextValidation.errors.join(', ')}`);
+                    throw new Error(`Context validation failed: ${contextValidation.errors.join(", ")}`);
                 }
                 // Check tool permissions
-                if (tool.permissions && !ContextValidator.hasPermissions(context, tool.permissions)) {
-                    throw new Error(`Insufficient permissions for tool '${toolName}'. Required: ${tool.permissions.join(', ')}`);
+                if (tool.permissions &&
+                    !ContextValidator.hasPermissions(context, tool.permissions)) {
+                    throw new Error(`Insufficient permissions for tool '${toolName}'. Required: ${tool.permissions.join(", ")}`);
                 }
             }
             // Validate input parameters if schema provided
@@ -123,8 +126,8 @@ export class MCPToolRegistry {
                     serverTitle,
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
             // Track metrics
             if (trackMetrics) {
@@ -137,10 +140,10 @@ export class MCPToolRegistry {
                 }
                 catch (error) {
                     const errorMessage = error instanceof Error ? error.message : String(error);
-                    console.warn(`[MCPRegistry] Output validation warning for tool '${toolName}': ${errorMessage}`);
+                    registryLogger.warn(`Output validation warning for tool '${toolName}': ${errorMessage}`);
                 }
             }
-            console.log(`[MCPRegistry] Executed tool '${toolName}' in ${executionTime}ms - ${result.success ? 'SUCCESS' : 'FAILED'}`);
+            registryLogger.debug(`Executed tool '${toolName}' in ${executionTime}ms - ${result.success ? "SUCCESS" : "FAILED"}`);
             return enhancedResult;
         }
         catch (error) {
@@ -157,10 +160,10 @@ export class MCPToolRegistry {
                     toolName,
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
-            console.error(`[MCPRegistry] Tool execution failed '${toolName}': ${errorMessage}`);
+            registryLogger.error(`Tool execution failed '${toolName}': ${errorMessage}`);
             return errorResult;
         }
     }
@@ -175,7 +178,8 @@ export class MCPToolRegistry {
         // Get unique tools (prefer qualified names over simple names)
         const uniqueTools = new Map();
         for (const [name, registration] of this.tools) {
-            if (name.includes('.')) { // Qualified name
+            if (name.includes(".")) {
+                // Qualified name
                 uniqueTools.set(registration.qualifiedName, registration);
             }
             else if (!uniqueTools.has(registration.qualifiedName)) {
@@ -183,9 +187,10 @@ export class MCPToolRegistry {
             }
         }
         for (const registration of uniqueTools.values()) {
-            const { tool, serverId, serverTitle, serverCategory, qualifiedName, simpleName } = registration;
+            const { tool, serverId, serverTitle, serverCategory, qualifiedName, simpleName, } = registration;
             // Apply filters
-            if (criteria.name && !simpleName.toLowerCase().includes(criteria.name.toLowerCase())) {
+            if (criteria.name &&
+                !simpleName.toLowerCase().includes(criteria.name.toLowerCase())) {
                 continue;
             }
             if (criteria.category && tool.category !== criteria.category) {
@@ -194,15 +199,17 @@ export class MCPToolRegistry {
             if (criteria.serverId && serverId !== criteria.serverId) {
                 continue;
             }
-            if (criteria.serverCategory && serverCategory !== criteria.serverCategory) {
+            if (criteria.serverCategory &&
+                serverCategory !== criteria.serverCategory) {
                 continue;
             }
-            if (criteria.implemented !== undefined && tool.isImplemented !== criteria.implemented) {
+            if (criteria.implemented !== undefined &&
+                tool.isImplemented !== criteria.implemented) {
                 continue;
             }
             if (criteria.permissions && criteria.permissions.length > 0) {
                 const toolPermissions = tool.permissions || [];
-                const hasAllPermissions = criteria.permissions.every(p => toolPermissions.includes(p));
+                const hasAllPermissions = criteria.permissions.every((p) => toolPermissions.includes(p));
                 if (!hasAllPermissions) {
                     continue;
                 }
@@ -216,7 +223,7 @@ export class MCPToolRegistry {
                 category: tool.category,
                 serverCategory,
                 permissions: tool.permissions,
-                isImplemented: tool.isImplemented
+                isImplemented: tool.isImplemented,
             });
         }
         return tools.sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName));
@@ -239,7 +246,7 @@ export class MCPToolRegistry {
         return {
             tool: registration.tool,
             server,
-            registration
+            registration,
         };
     }
     /**
@@ -252,22 +259,24 @@ export class MCPToolRegistry {
         const serversByCategory = {};
         // Count tools by category
         for (const registration of this.tools.values()) {
-            const category = registration.tool.category || 'uncategorized';
+            const category = registration.tool.category || "uncategorized";
             toolsByCategory[category] = (toolsByCategory[category] || 0) + 1;
         }
         // Count servers by category
         for (const server of this.servers.values()) {
-            const category = server.category || 'uncategorized';
+            const category = server.category || "uncategorized";
             serversByCategory[category] = (serversByCategory[category] || 0) + 1;
         }
         return {
             totalServers: this.servers.size,
-            totalTools: new Set(Array.from(this.tools.values()).map(r => r.qualifiedName)).size,
+            totalTools: new Set(Array.from(this.tools.values()).map((r) => r.qualifiedName)).size,
             toolsByCategory,
             serversByCategory,
             executionCount: this.executionCount,
-            averageExecutionTime: this.executionCount > 0 ? this.totalExecutionTime / this.executionCount : 0,
-            errorRate: this.executionCount > 0 ? this.errorCount / this.executionCount : 0
+            averageExecutionTime: this.executionCount > 0
+                ? this.totalExecutionTime / this.executionCount
+                : 0,
+            errorRate: this.executionCount > 0 ? this.errorCount / this.executionCount : 0,
         };
     }
     /**
@@ -293,7 +302,7 @@ export class MCPToolRegistry {
         }
         // Remove the server
         this.servers.delete(serverId);
-        console.log(`[MCPRegistry] Unregistered server '${serverId}' and ${toolsToRemove.length} tools`);
+        registryLogger.debug(`Unregistered server '${serverId}' and ${toolsToRemove.length} tools`);
         return true;
     }
     /**
@@ -305,7 +314,7 @@ export class MCPToolRegistry {
         this.executionCount = 0;
         this.totalExecutionTime = 0;
         this.errorCount = 0;
-        console.log('[MCPRegistry] Cleared all servers and tools');
+        registryLogger.debug("Cleared all servers and tools");
     }
     /**
      * Create timeout promise wrapper
@@ -320,7 +329,7 @@ export class MCPToolRegistry {
             promise,
             new Promise((_, reject) => {
                 setTimeout(() => reject(new Error(timeoutMessage)), timeoutMs);
-            })
+            }),
         ]);
     }
     /**
@@ -341,14 +350,32 @@ export class MCPToolRegistry {
  * Default registry instance
  * Can be used across the application for consistent tool management
  */
-export const defaultToolRegistry = new MCPToolRegistry();
+let defaultRegistryInstance = null;
+/**
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export function getDefaultToolRegistry() {
+    if (!defaultRegistryInstance) {
+        defaultRegistryInstance = new MCPToolRegistry();
+    }
+    return defaultRegistryInstance;
+}
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
+ */
+export const defaultToolRegistry = getDefaultToolRegistry();
 /**
  * Utility function to register server with default registry
  *
  * @param server MCP server to register
  */
 export async function registerServer(server) {
-    return defaultToolRegistry.registerServer(server);
+    return getDefaultToolRegistry().registerServer(server);
 }
 /**
  * Utility function to execute tool with default registry
@@ -360,7 +387,7 @@ export async function registerServer(server) {
  * @returns Tool execution result
  */
 export async function executeTool(toolName, params, context, options) {
-    return defaultToolRegistry.executeTool(toolName, params, context, options);
+    return getDefaultToolRegistry().executeTool(toolName, params, context, options);
 }
 /**
  * Utility function to list tools with default registry
@@ -369,5 +396,5 @@ export async function executeTool(toolName, params, context, options) {
  * @returns Array of tool information
  */
 export function listTools(criteria) {
-    return defaultToolRegistry.listTools(criteria);
+    return getDefaultToolRegistry().listTools(criteria);
 }

package/dist/mcp/servers/ai-providers/ai-analysis-tools.d.ts

@@ -3,7 +3,7 @@
  * AI-focused MCP tools for usage analysis, performance benchmarking, and parameter optimization
  * Tools: analyze-ai-usage, benchmark-provider-performance, optimize-prompt-parameters
  */
-import type { NeuroLinkMCPTool } from '../../factory.js';
+import type { NeuroLinkMCPTool } from "../../factory.js";
 /**
  * AI Usage Analysis Tool
  * Analyzes AI usage patterns, token consumption, and cost optimization opportunities