@juspay/neurolink 1.9.0 → 1.11.0

package/dist/lib/mcp/unified-registry.d.ts

@@ -1,269 +1,82 @@
 /**
- * NeuroLink Unified MCP Registry System
- * Combines manual configuration, auto-discovery, and default tool registry
- * Provides intelligent server selection with configurable priorities
+ * Unified MCP Registry - Combines Multiple Registration Sources
  */
-import { type ToolSearchCriteria } from "./registry.js";
-import type { NeuroLinkMCPServer, NeuroLinkExecutionContext, ToolResult } from "./factory.js";
+import type { DiscoveredMCP, ExecutionContext } from "./contracts/mcp-contract.js";
+import type { DiscoveryOptions } from "./auto-discovery.js";
+import { MCPToolRegistry, type ToolInfo, type ToolExecutionResult } from "./tool-registry.js";
 /**
- * MCP Server Configuration from manual .mcp-config.json
+ * Unified registry combining multiple sources
  */
-export interface MCPServerConfig {
-    name: string;
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    cwd?: string;
-    transport: "stdio" | "sse";
-    url?: string;
-}
-/**
- * Enhanced MCP configuration with auto-discovery settings
- */
-export interface EnhancedMCPConfig {
-    mcpServers: Record<string, MCPServerConfig>;
-    autoDiscovery?: {
-        enabled?: boolean;
-        sources?: string[];
-        autoRegister?: boolean;
-        excludeServers?: string[];
-        preferManualConfig?: boolean;
-    };
-    defaultRegistry?: {
-        enabled?: boolean;
-        includeBuiltInTools?: boolean;
-    };
-}
-/**
- * Server source information
- */
-export interface ServerSource {
-    type: "manual" | "auto" | "default";
-    priority: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Unified server entry
- */
-export interface UnifiedServerEntry {
-    id: string;
-    config?: MCPServerConfig;
-    server?: NeuroLinkMCPServer;
-    source: ServerSource;
-    status: "available" | "unavailable" | "unknown" | "activated";
-}
-/**
- * Unified execution options
- */
-export interface UnifiedExecutionOptions {
-    preferredSource?: "manual" | "auto" | "default";
-    fallbackEnabled?: boolean;
-    validateBeforeExecution?: boolean;
-    timeoutMs?: number;
-}
-/**
- * Unified MCP Registry that combines all sources
- */
-export declare class UnifiedMCPRegistry {
-    private configPath;
-    private config;
+export declare class UnifiedMCPRegistry extends MCPToolRegistry {
+    private autoDiscoveryEnabled;
+    private autoDiscoveredServers;
     private manualServers;
-    private autoServers;
-    private defaultServers;
-    private autoRegistryInstance;
-    private lastAutoDiscovery;
-    private autoDiscoveryCacheMs;
-    private _isInitialized;
-    constructor(configPath?: string);
-    /**
-     * Check if the registry has been initialized
-     */
-    get isInitialized(): boolean;
-    /**
-     * Load MCP configuration with defaults
-     */
-    private loadConfig;
-    /**
-     * Save configuration to file
-     */
-    private saveConfig;
-    /**
-     * Initialize the unified registry by loading all server sources
-     */
-    initialize(): Promise<void>;
-    /**
-     * Mark all discovered servers as available for lazy activation
-     */
-    private markServersAsAvailable;
-    /**
-     * Load manual servers from configuration
-     */
-    private loadManualServers;
-    /**
-     * Load auto-discovered servers
-     */
-    private loadAutoDiscoveredServers;
-    /**
-     * Load default registry tools
-     */
-    private loadDefaultRegistryTools;
-    /**
-     * Execute a tool using unified registry with fallback
-     */
-    executeTool(toolName: string, params: unknown, context: NeuroLinkExecutionContext, options?: UnifiedExecutionOptions): Promise<ToolResult>;
-    /**
-     * Execute tool from specific source
-     */
-    private executeFromSource;
-    /**
-     * Execute tool from manual configuration
-     */
-    private executeFromManualConfig;
-    /**
-     * Execute MCP tool using manual server configuration
-     */
-    private executeMCPTool;
-    /**
-     * Execute tool from auto-registered servers
-     */
-    private executeFromAutoRegistry;
+    private availableServers;
     /**
-     * Execute tool from default registry
+     * Initialize with auto-discovery
      */
-    private executeFromDefaultRegistry;
+    initialize(options?: DiscoveryOptions): Promise<void>;
     /**
-     * Get execution order based on preferences and tool type
+     * Enable or disable auto-discovery
      */
-    private getExecutionOrder;
+    setAutoDiscovery(enabled: boolean): void;
     /**
-     * List all available tools from all sources
+     * Refresh discovery
      */
-    listAllTools(criteria?: ToolSearchCriteria & {
-        source?: "manual" | "auto" | "default";
-    }): Promise<Array<{
-        name: string;
-        server: string;
-        source: "manual" | "auto" | "default";
-        description?: string;
-        category?: string;
-        isImplemented?: boolean;
-    }>>;
+    refresh(options?: DiscoveryOptions): Promise<void>;
     /**
-     * List all servers from all sources
-     */
-    listAllServers(): UnifiedServerEntry[];
-    /**
-     * Get total server count across all sources
+     * Get total server count
      */
     getTotalServerCount(): number;
     /**
-     * Add a manual server configuration
+     * Get available server count
      */
-    addManualServer(serverId: string, config: MCPServerConfig): void;
-    /**
-     * Remove a manual server configuration
-     */
-    removeManualServer(serverId: string): boolean;
+    getAvailableServerCount(): number;
     /**
-     * Update auto-discovery configuration
+     * Get auto-discovered servers
      */
-    updateAutoDiscoveryConfig(config: Partial<EnhancedMCPConfig["autoDiscovery"]>): void;
+    getAutoDiscoveredServers(): DiscoveredMCP[];
     /**
-     * Force refresh of auto-discovered servers
+     * Get manual servers
      */
-    refreshAutoDiscovery(): Promise<void>;
+    getManualServers(): Map<string, any>;
     /**
-     * Get current configuration
+     * List all tools from all registered plugins
      */
-    getConfig(): EnhancedMCPConfig;
+    listAllTools(): Promise<ToolInfo[]>;
     /**
-     * Get registry statistics
+     * Execute a tool through the registry
      */
-    getStats(): {
-        manual: {
-            servers: number;
-            tools: number;
-        };
-        auto: {
-            servers: number;
-            tools: number;
-        };
-        default: {
-            servers: number;
-            tools: number;
-        };
-        total: {
-            servers: number;
-            tools: number;
-        };
-    };
+    executeTool(toolName: string, args: any, context: ExecutionContext): Promise<ToolExecutionResult>;
     /**
-     * Get auto-discovered servers
+     * Lazily activate a server by ID
      */
-    getAutoDiscoveredServers(): Map<string, UnifiedServerEntry>;
+    lazyActivateServer(serverId: string): Promise<boolean>;
     /**
-     * Get manual servers
+     * Register a manual server
      */
-    getManualServers(): Map<string, UnifiedServerEntry>;
+    registerManualServer(id: string, server: any): void;
     /**
-     * Get server summary with counts and status
+     * Get registry statistics
      */
-    getServerSummary(): {
-        manual: {
-            servers: number;
-            tools: number;
-        };
-        auto: {
-            servers: number;
-            tools: number;
-        };
-        default: {
+    getStats(): Promise<{
+        total: number;
+        bySource: Record<string, number>;
+        byType: Record<string, number>;
+        manual?: {
             servers: number;
-            tools: number;
         };
-        total: {
+        auto?: {
             servers: number;
-            tools: number;
         };
-    };
-    /**
-     * Activate discovered servers by testing connectivity and loading available tools
-     */
-    private activateDiscoveredServers;
-    /**
-     * Activate a single server by testing connectivity and loading tools
-     */
-    private activateServer;
-    /**
-     * Test server connectivity
-     */
-    private testServerConnectivity;
-    /**
-     * Load tools from a server
-     */
-    private loadServerTools;
-    /**
-     * Properly cleanup child process and its streams to prevent hanging
-     */
-    private cleanupChildProcess;
-    /**
-     * Create a server instance from config and tools
-     */
-    private createServerInstance;
-    /**
-     * Get count of activated servers
-     */
-    getAvailableServerCount(): number;
-    /**
-     * Get count of tools from activated servers
-     */
-    private getActivatedToolCount;
+        tools?: number;
+    }>;
     /**
-     * Activate a server on-demand when its tools are first requested
+     * Clear all registries
      */
-    lazyActivateServer(serverId: string, entry: UnifiedServerEntry): Promise<boolean>;
+    clear(): void;
 }
 /**
  * Default unified registry instance
  */
-export declare const defaultUnifiedRegistry: UnifiedMCPRegistry;
+export declare const unifiedRegistry: UnifiedMCPRegistry;