@juspay/neurolink 7.13.0 → 7.14.0

package/dist/lib/neurolink.d.ts

@@ -12,6 +12,7 @@ import type { SimpleTool } from "./sdk/toolRegistration.js";
 import type { InMemoryMCPServerConfig } from "./types/mcpTypes.js";
 import { EventEmitter } from "events";
 import type { ConversationMemoryConfig } from "./types/conversationTypes.js";
+import type { ExternalMCPServerConfig, ExternalMCPServerInstance, ExternalMCPOperationResult, ExternalMCPToolInfo } from "./types/externalMcp.js";
 export interface ProviderStatus {
     provider: string;
     status: "working" | "failed" | "not-configured";
@@ -30,6 +31,10 @@ export interface MCPStatus {
     autoDiscoveredServers: MCPServerInfo[];
     customToolsCount: number;
     inMemoryServersCount: number;
+    externalMCPServersCount?: number;
+    externalMCPConnectedCount?: number;
+    externalMCPFailedCount?: number;
+    externalMCPServers?: MCPServerInfo[];
     error?: string;
     [key: string]: unknown;
 }
@@ -48,6 +53,7 @@ export declare class NeuroLink {
     private contextManager;
     private customTools;
     private inMemoryServers;
+    private externalServerManager;
     private toolCircuitBreakers;
     private toolExecutionMetrics;
     /**
@@ -200,22 +206,7 @@ export declare class NeuroLink {
      * Get all available tools including custom and in-memory ones
      * @returns Array of available tools with metadata
      */
-    getAllAvailableTools(): Promise<({
-        toolName: string;
-        serverId: string | undefined;
-        name: string;
-        description?: string;
-        category?: string;
-        inputSchema?: Record<string, unknown>;
-        outputSchema?: Record<string, unknown>;
-    } | {
-        name: string;
-        toolName: string;
-        description: string;
-        serverId: string;
-        category: string;
-        inputSchema: {};
-    })[]>;
+    getAllAvailableTools(): Promise<any[]>;
     /**
      * Get comprehensive status of all AI providers
      * Primary method for provider health checking and diagnostics
@@ -402,6 +393,110 @@ export declare class NeuroLink {
      * Clear all conversation history (public API)
      */
     clearAllConversations(): Promise<void>;
+    /**
+     * Add an external MCP server
+     * Automatically discovers and registers tools from the server
+     * @param serverId - Unique identifier for the server
+     * @param config - External MCP server configuration
+     * @returns Operation result with server instance
+     */
+    addExternalMCPServer(serverId: string, config: ExternalMCPServerConfig): Promise<ExternalMCPOperationResult<ExternalMCPServerInstance>>;
+    /**
+     * Remove an external MCP server
+     * Stops the server and removes all its tools
+     * @param serverId - ID of the server to remove
+     * @returns Operation result
+     */
+    removeExternalMCPServer(serverId: string): Promise<ExternalMCPOperationResult<void>>;
+    /**
+     * List all external MCP servers
+     * @returns Array of server health information
+     */
+    listExternalMCPServers(): Array<{
+        serverId: string;
+        status: string;
+        toolCount: number;
+        uptime: number;
+        isHealthy: boolean;
+        config: ExternalMCPServerConfig;
+    }>;
+    /**
+     * Get external MCP server status
+     * @param serverId - ID of the server
+     * @returns Server instance or undefined if not found
+     */
+    getExternalMCPServer(serverId: string): ExternalMCPServerInstance | undefined;
+    /**
+     * Execute a tool from an external MCP server
+     * @param serverId - ID of the server
+     * @param toolName - Name of the tool
+     * @param parameters - Tool parameters
+     * @param options - Execution options
+     * @returns Tool execution result
+     */
+    executeExternalMCPTool(serverId: string, toolName: string, parameters: Record<string, any>, options?: {
+        timeout?: number;
+    }): Promise<any>;
+    /**
+     * Get all tools from external MCP servers
+     * @returns Array of external tool information
+     */
+    getExternalMCPTools(): ExternalMCPToolInfo[];
+    /**
+     * Get tools from a specific external MCP server
+     * @param serverId - ID of the server
+     * @returns Array of tool information for the server
+     */
+    getExternalMCPServerTools(serverId: string): ExternalMCPToolInfo[];
+    /**
+     * Test connection to an external MCP server
+     * @param config - Server configuration to test
+     * @returns Test result with connection status
+     */
+    testExternalMCPConnection(config: ExternalMCPServerConfig): Promise<{
+        success: boolean;
+        error?: string;
+        toolCount?: number;
+    }>;
+    /**
+     * Get external MCP server manager statistics
+     * @returns Statistics about external servers and tools
+     */
+    getExternalMCPStatistics(): {
+        totalServers: number;
+        connectedServers: number;
+        failedServers: number;
+        totalTools: number;
+        totalConnections: number;
+        totalErrors: number;
+    };
+    /**
+     * Shutdown all external MCP servers
+     * Called automatically on process exit
+     */
+    shutdownExternalMCPServers(): Promise<void>;
+    /**
+     * Convert external MCP tools to Vercel AI SDK tool format
+     * This allows AI providers to use external tools directly
+     */
+    private convertExternalMCPToolsToAISDKFormat;
+    /**
+     * Convert JSON Schema to AI SDK compatible format
+     * For now, we'll skip schema validation and let the AI SDK handle parameters dynamically
+     */
+    private convertJSONSchemaToAISDKFormat;
+    /**
+     * Unregister external MCP tools from a specific server
+     */
+    private unregisterExternalMCPToolsFromRegistry;
+    /**
+     * Unregister a specific external MCP tool from the main registry
+     */
+    private unregisterExternalMCPToolFromRegistry;
+    /**
+     * Unregister all external MCP tools from the main registry
+     */
+    private unregisterAllExternalMCPToolsFromRegistry;
 }
 export declare const neurolink: NeuroLink;
 export default neurolink;