@juspay/neurolink 9.32.0 → 9.33.0

package/dist/client/mcp/registry.js

@@ -1,158 +0,0 @@
-/**
- * MCP Registry - Industry Standard Interface with camelCase
- */
-import { registryLogger } from "../utils/logger.js";
-/**
- * Simple MCP registry for plugin management
- * Maintains backward compatibility with existing code
- */
-export class MCPRegistry {
-    plugins = new Map();
-    /**
-     * Register a plugin
-     */
-    register(plugin) {
-        this.plugins.set(plugin.metadata.name, plugin);
-        registryLogger.debug(`Registered plugin: ${plugin.metadata.name}`);
-    }
-    /**
-     * Unregister a plugin
-     */
-    unregister(name) {
-        const removed = this.plugins.delete(name);
-        if (removed) {
-            registryLogger.debug(`Unregistered plugin: ${name}`);
-        }
-        return removed;
-    }
-    /**
-     * Get a plugin
-     */
-    get(name) {
-        return this.plugins.get(name);
-    }
-    /**
-     * List all plugins
-     */
-    list() {
-        return Array.from(this.plugins.values());
-    }
-    /**
-     * Check if plugin exists
-     */
-    has(name) {
-        return this.plugins.has(name);
-    }
-    /**
-     * Clear all plugins
-     */
-    clear() {
-        this.plugins.clear();
-        registryLogger.info("Registry cleared");
-    }
-    /**
-     * Register a server (compatible with new interface)
-     */
-    async registerServer(serverId, serverConfig, _context) {
-        const plugin = {
-            metadata: {
-                name: serverId,
-                description: typeof serverConfig === "object" && serverConfig
-                    ? serverConfig.description ||
-                        "No description"
-                    : "No description",
-            },
-            tools: typeof serverConfig === "object" && serverConfig
-                ? serverConfig.tools
-                : {},
-            configuration: typeof serverConfig === "object" && serverConfig
-                ? serverConfig
-                : {},
-        };
-        this.register(plugin);
-    }
-    /**
-     * Execute a tool (mock implementation for tests)
-     */
-    async executeTool(toolName, args, _context) {
-        registryLogger.info(`Executing tool: ${toolName}`);
-        return { result: `Mock execution of ${toolName}`, args };
-    }
-    /**
-     * List all tools (compatible with new interface)
-     */
-    async listTools(_context) {
-        const tools = this.list().map((plugin) => ({
-            name: plugin.metadata.name,
-            description: plugin.metadata.description || "No description",
-            serverId: plugin.metadata.name,
-            category: "general",
-        }));
-        return tools;
-    }
-    // Legacy methods for backward compatibility
-    /**
-     * Register a server (legacy sync version)
-     */
-    registerServerSync(plugin) {
-        this.register(plugin);
-    }
-    /**
-     * Execute a tool (legacy sync version)
-     */
-    executeToolSync(toolName, args) {
-        registryLogger.info(`Executing tool (sync): ${toolName}`);
-        return { result: `Mock execution of ${toolName}`, args };
-    }
-    /**
-     * List all tools (legacy sync version)
-     */
-    listToolsSync() {
-        const tools = this.list().map((plugin) => ({
-            name: plugin.metadata.name,
-            description: plugin.metadata.description || "No description",
-        }));
-        return tools;
-    }
-    /**
-     * List all registered server IDs
-     *
-     * Returns an array of server IDs that are currently registered in the MCP registry.
-     * This complements listTools() by providing server-level information, while listTools()
-     * provides tool-level information across all servers.
-     *
-     * @returns Array of registered server identifier strings
-     * @see listTools() for getting detailed tool information from all servers
-     * @see list() for getting complete server metadata objects
-     *
-     * @example
-     * ```typescript
-     * const serverIds = registry.listServers();
-     * // ['ai-core', 'external-api', 'database-connector']
-     *
-     * // Compare with listTools() for comprehensive overview:
-     * const servers = registry.listServers(); // ['server1', 'server2']
-     * const tools = await registry.listTools(); // [{ name: 'tool1', serverId: 'server1' }, ...]
-     * ```
-     */
-    listServers() {
-        return Array.from(this.plugins.keys());
-    }
-}
-/**
- * Enhanced MCP Registry implementation with config integration
- * Will be implemented in Phase 3.2
- */
-export class McpRegistryImpl {
-    baseRegistry = new MCPRegistry();
-    // Additional implementation will be added in Phase 3.2
-    async registerServer(serverId, serverConfig, context) {
-        return this.baseRegistry.registerServer(serverId, serverConfig, context);
-    }
-    async executeTool(toolName, args, context) {
-        return this.baseRegistry.executeTool(toolName, args, context);
-    }
-    async listTools(context) {
-        return this.baseRegistry.listTools(context);
-    }
-}

package/dist/client/mcp/routing/index.js

@@ -1,10 +0,0 @@
-/**
- * MCP Routing Module - Intelligent tool call routing
- *
- * Provides advanced routing strategies for multi-server MCP environments:
- * - Round-robin distribution
- * - Least-loaded selection
- * - Capability-based routing
- * - Session affinity
- */
-export { createToolRouter, DEFAULT_ROUTER_CONFIG, ToolRouter, } from "./toolRouter.js";

package/dist/client/mcp/routing/toolRouter.js

@@ -1,416 +0,0 @@
-/**
- * Tool Router - Routes tool calls to appropriate MCP servers
- * Based on tool categories, annotations, and server capabilities
- *
- * Provides intelligent routing strategies for multi-server MCP environments:
- * - Round-robin for even distribution
- * - Least-loaded for optimal performance
- * - Capability-based for specialized servers
- * - Affinity-based for session consistency
- */
-import { EventEmitter } from "events";
-import { ErrorFactory } from "../../utils/errorHandling.js";
-/**
- * Default router configuration for common use cases
- */
-export const DEFAULT_ROUTER_CONFIG = {
-    strategy: "least-loaded",
-    enableAffinity: false,
-    maxRetries: 3,
-    healthCheckInterval: 30000,
-    affinityTtl: 30 * 60 * 1000,
-};
-/**
- * Tool Router - Intelligent routing for MCP tool calls
- *
- * @example
- * ```typescript
- * const router = new ToolRouter({
- *   strategy: 'least-loaded',
- *   enableAffinity: true,
- *   categoryMapping: {
- *     'database': ['db-server-1', 'db-server-2'],
- *     'ai': ['ai-server-primary', 'ai-server-secondary'],
- *   },
- * });
- *
- * const decision = router.route(tool, { sessionId: 'user-123' });
- * console.log(`Routing to: ${decision.serverId}`);
- * ```
- */
-export class ToolRouter extends EventEmitter {
-    config;
-    roundRobinIndex = new Map();
-    serverLoads = new Map();
-    affinityRules = new Map();
-    healthStatus = new Map();
-    availableServers = new Set();
-    affinityCleanupTimer;
-    constructor(config = DEFAULT_ROUTER_CONFIG) {
-        super();
-        this.config = {
-            strategy: config.strategy ?? "least-loaded",
-            enableAffinity: config.enableAffinity ?? false,
-            categoryMapping: config.categoryMapping ?? {},
-            serverWeights: config.serverWeights ?? [],
-            fallbackStrategy: config.fallbackStrategy ?? "round-robin",
-            maxRetries: config.maxRetries ?? 3,
-            healthCheckInterval: config.healthCheckInterval ?? 30000,
-            affinityTtl: config.affinityTtl ?? 30 * 60 * 1000, // 30 minutes
-        };
-        if (this.config.enableAffinity) {
-            this.affinityCleanupTimer = setInterval(() => {
-                this.cleanupExpiredAffinities();
-            }, this.config.healthCheckInterval);
-            if (this.affinityCleanupTimer.unref) {
-                this.affinityCleanupTimer.unref();
-            }
-        }
-    }
-    destroy() {
-        if (this.affinityCleanupTimer) {
-            clearInterval(this.affinityCleanupTimer);
-            this.affinityCleanupTimer = undefined;
-        }
-        this.affinityRules.clear();
-    }
-    cleanupExpiredAffinities() {
-        const now = Date.now();
-        for (const [key, rule] of this.affinityRules) {
-            if (rule.expiresAt && rule.expiresAt <= now) {
-                this.affinityRules.delete(key);
-                this.emit("affinityExpired", { key });
-            }
-        }
-    }
-    /**
-     * Register a server as available for routing
-     */
-    registerServer(serverId, capabilities) {
-        this.availableServers.add(serverId);
-        this.healthStatus.set(serverId, true);
-        this.serverLoads.set(serverId, 0);
-        // Update category mapping if capabilities provided
-        if (capabilities) {
-            for (const capability of capabilities) {
-                if (!this.config.categoryMapping[capability]) {
-                    this.config.categoryMapping[capability] = [];
-                }
-                if (!this.config.categoryMapping[capability].includes(serverId)) {
-                    this.config.categoryMapping[capability].push(serverId);
-                }
-            }
-        }
-    }
-    /**
-     * Unregister a server from routing
-     */
-    unregisterServer(serverId) {
-        this.availableServers.delete(serverId);
-        this.healthStatus.delete(serverId);
-        this.serverLoads.delete(serverId);
-        // Reset all round-robin indices since any tool may have been
-        // routed to the removed server. Keys are `rr-${toolName}`.
-        this.roundRobinIndex.clear();
-        // Remove from category mappings
-        for (const category of Object.keys(this.config.categoryMapping)) {
-            const servers = this.config.categoryMapping[category];
-            const index = servers.indexOf(serverId);
-            if (index !== -1) {
-                servers.splice(index, 1);
-            }
-        }
-    }
-    /**
-     * Route a tool call to the best server
-     */
-    route(tool, context) {
-        // Check affinity first if enabled
-        if (this.config.enableAffinity && context) {
-            const affinityKey = context.sessionId ?? context.userId;
-            if (affinityKey) {
-                const affinityRule = this.affinityRules.get(affinityKey);
-                if (affinityRule && this.isServerHealthy(affinityRule.serverId)) {
-                    if (!affinityRule.expiresAt || affinityRule.expiresAt > Date.now()) {
-                        return {
-                            serverId: affinityRule.serverId,
-                            strategy: "affinity",
-                            confidence: 1.0,
-                            reason: `Affinity match for ${affinityKey}`,
-                        };
-                    }
-                    else {
-                        this.affinityRules.delete(affinityKey);
-                        this.emit("affinityExpired", { key: affinityKey });
-                    }
-                }
-            }
-        }
-        // Get candidate servers
-        const candidates = this.getCandidateServers(tool);
-        if (candidates.length === 0) {
-            const routeError = ErrorFactory.toolExecutionFailed(tool.name, new Error(`No healthy servers available (strategy: ${this.config.strategy}, registered: ${this.availableServers.size})`));
-            this.emit("routeFailed", {
-                toolName: tool.name,
-                error: routeError,
-                attemptedServers: Array.from(this.availableServers),
-            });
-            throw routeError;
-        }
-        // Apply routing strategy
-        const decision = this.applyStrategy(this.config.strategy, tool, candidates);
-        // Set affinity if enabled
-        if (this.config.enableAffinity && context) {
-            const affinityKey = context.sessionId ?? context.userId;
-            if (affinityKey) {
-                this.setAffinity(affinityKey, decision.serverId);
-            }
-        }
-        this.emit("routeDecision", { toolName: tool.name, decision });
-        return decision;
-    }
-    /**
-     * Route by tool category
-     */
-    routeByCategory(tool, category) {
-        const servers = this.config.categoryMapping[category] ?? [];
-        return servers.filter((s) => this.isServerHealthy(s));
-    }
-    /**
-     * Route by tool annotation hints
-     */
-    routeByAnnotation(tool) {
-        if (!tool.annotations) {
-            return Array.from(this.availableServers).filter((s) => this.isServerHealthy(s));
-        }
-        // Route destructive tools to primary servers only (check before readOnlyHint
-        // so that a tool with both flags is still restricted to primary servers)
-        if (tool.annotations.destructiveHint) {
-            const primaryServers = this.config.serverWeights
-                .filter((sw) => sw.weight >= 50)
-                .map((sw) => sw.serverId)
-                .filter((s) => this.isServerHealthy(s));
-            if (primaryServers.length > 0) {
-                return primaryServers;
-            }
-        }
-        // Route read-only tools to any healthy server
-        if (tool.annotations.readOnlyHint) {
-            return Array.from(this.availableServers).filter((s) => this.isServerHealthy(s));
-        }
-        // Route idempotent tools preferring cached servers
-        if (tool.annotations.idempotentHint) {
-            const cachedServers = this.config.categoryMapping["caching"] ?? [];
-            const healthyCached = cachedServers.filter((s) => this.isServerHealthy(s));
-            if (healthyCached.length > 0) {
-                return healthyCached;
-            }
-        }
-        return Array.from(this.availableServers).filter((s) => this.isServerHealthy(s));
-    }
-    /**
-     * Route by required capabilities
-     */
-    routeByCapability(tool, requiredCapabilities) {
-        const matchingServers = [];
-        for (const serverId of this.availableServers) {
-            if (!this.isServerHealthy(serverId)) {
-                continue;
-            }
-            // Check if server has all required capabilities
-            let hasAll = true;
-            for (const capability of requiredCapabilities) {
-                const serversWithCapability = this.config.categoryMapping[capability] ?? [];
-                if (!serversWithCapability.includes(serverId)) {
-                    hasAll = false;
-                    break;
-                }
-            }
-            if (hasAll) {
-                matchingServers.push(serverId);
-            }
-        }
-        return matchingServers;
-    }
-    /**
-     * Update server load for least-loaded routing
-     */
-    updateServerLoad(serverId, delta) {
-        const currentLoad = this.serverLoads.get(serverId) ?? 0;
-        this.serverLoads.set(serverId, Math.max(0, currentLoad + delta));
-    }
-    /**
-     * Update server health status
-     */
-    updateHealthStatus(serverId, healthy) {
-        const previousStatus = this.healthStatus.get(serverId);
-        this.healthStatus.set(serverId, healthy);
-        if (previousStatus !== healthy) {
-            this.emit("healthUpdate", { serverId, healthy });
-        }
-    }
-    /**
-     * Set session/user affinity
-     */
-    setAffinity(key, serverId) {
-        this.affinityRules.set(key, {
-            key,
-            serverId,
-            expiresAt: Date.now() + this.config.affinityTtl,
-        });
-        this.emit("affinitySet", { key, serverId });
-    }
-    /**
-     * Clear affinity for a key
-     */
-    clearAffinity(key) {
-        this.affinityRules.delete(key);
-    }
-    /**
-     * Get current routing statistics
-     */
-    getStats() {
-        const healthyCount = Array.from(this.healthStatus.values()).filter((h) => h).length;
-        return {
-            availableServers: this.availableServers.size,
-            healthyServers: healthyCount,
-            activeAffinities: this.affinityRules.size,
-            serverLoads: Object.fromEntries(this.serverLoads),
-        };
-    }
-    // ==================== Private Methods ====================
-    getCandidateServers(tool) {
-        // If tool has a specific server, use only that
-        if (tool.serverId && this.isServerHealthy(tool.serverId)) {
-            return [tool.serverId];
-        }
-        // Check category mapping
-        if (tool.category) {
-            const categoryServers = this.routeByCategory(tool, tool.category);
-            if (categoryServers.length > 0) {
-                return categoryServers;
-            }
-        }
-        // Check annotation-based routing
-        const annotationServers = this.routeByAnnotation(tool);
-        if (annotationServers.length > 0) {
-            return annotationServers;
-        }
-        // Fall back to all healthy servers
-        return Array.from(this.availableServers).filter((s) => this.isServerHealthy(s));
-    }
-    applyStrategy(strategy, tool, candidates) {
-        switch (strategy) {
-            case "round-robin":
-                return this.roundRobinSelect(tool.name, candidates);
-            case "least-loaded":
-                return this.leastLoadedSelect(candidates);
-            case "capability-based":
-                return this.capabilityBasedSelect(tool, candidates);
-            case "priority":
-                return this.prioritySelect(candidates);
-            case "random":
-                return this.randomSelect(candidates);
-            case "affinity":
-                // Affinity is handled at the top of route(), fall back to round-robin
-                return this.roundRobinSelect(tool.name, candidates);
-            default:
-                return this.roundRobinSelect(tool.name, candidates);
-        }
-    }
-    roundRobinSelect(toolName, candidates) {
-        const key = `rr-${toolName}`;
-        const currentIndex = this.roundRobinIndex.get(key) ?? 0;
-        const selectedIndex = currentIndex % candidates.length;
-        this.roundRobinIndex.set(key, currentIndex + 1);
-        return {
-            serverId: candidates[selectedIndex],
-            strategy: "round-robin",
-            confidence: 0.8,
-            alternates: candidates.filter((_, i) => i !== selectedIndex),
-            reason: `Round-robin selection (index ${selectedIndex})`,
-        };
-    }
-    leastLoadedSelect(candidates) {
-        let minLoad = Infinity;
-        let selectedServer = candidates[0];
-        for (const serverId of candidates) {
-            const load = this.serverLoads.get(serverId) ?? 0;
-            if (load < minLoad) {
-                minLoad = load;
-                selectedServer = serverId;
-            }
-        }
-        return {
-            serverId: selectedServer,
-            strategy: "least-loaded",
-            confidence: 0.9,
-            alternates: candidates.filter((s) => s !== selectedServer),
-            reason: `Least loaded server (load: ${minLoad})`,
-        };
-    }
-    capabilityBasedSelect(tool, candidates) {
-        // Score each candidate based on capability match
-        const scores = [];
-        for (const serverId of candidates) {
-            let score = 1;
-            // Check weight
-            const weight = this.config.serverWeights.find((sw) => sw.serverId === serverId);
-            if (weight) {
-                score += weight.weight / 100;
-            }
-            // Check capability match
-            if (tool.category) {
-                const categoryServers = this.config.categoryMapping[tool.category];
-                if (categoryServers?.includes(serverId)) {
-                    score += 0.5;
-                }
-            }
-            scores.push({ serverId, score });
-        }
-        // Sort by score descending
-        scores.sort((a, b) => b.score - a.score);
-        return {
-            serverId: scores[0].serverId,
-            strategy: "capability-based",
-            confidence: Math.min(1, scores[0].score / 2),
-            alternates: scores.slice(1).map((s) => s.serverId),
-            reason: `Capability score: ${scores[0].score.toFixed(2)}`,
-        };
-    }
-    prioritySelect(candidates) {
-        // Sort by weight
-        const weighted = candidates
-            .map((serverId) => {
-            const weight = this.config.serverWeights.find((sw) => sw.serverId === serverId)
-                ?.weight ?? 50;
-            return { serverId, weight };
-        })
-            .sort((a, b) => b.weight - a.weight);
-        return {
-            serverId: weighted[0].serverId,
-            strategy: "priority",
-            confidence: weighted[0].weight / 100,
-            alternates: weighted.slice(1).map((w) => w.serverId),
-            reason: `Priority weight: ${weighted[0].weight}`,
-        };
-    }
-    randomSelect(candidates) {
-        const randomIndex = Math.floor(Math.random() * candidates.length);
-        return {
-            serverId: candidates[randomIndex],
-            strategy: "random",
-            confidence: 0.5,
-            alternates: candidates.filter((_, i) => i !== randomIndex),
-            reason: "Random selection",
-        };
-    }
-    isServerHealthy(serverId) {
-        return (this.availableServers.has(serverId) &&
-            (this.healthStatus.get(serverId) ?? false));
-    }
-}
-/**
- * Factory function to create a ToolRouter instance
- */
-export const createToolRouter = (config) => new ToolRouter(config);