@juspay/neurolink 7.6.1 → 7.7.0

package/dist/neurolink.d.ts

@@ -43,6 +43,8 @@ export declare class NeuroLink {
     private mcpInitialized;
     private customTools;
     private inMemoryServers;
+    private toolCircuitBreakers;
+    private toolExecutionMetrics;
     constructor();
     /**
      * Initialize MCP registry with enhanced error handling and resource cleanup
@@ -80,6 +82,15 @@ export declare class NeuroLink {
      * Create tool-aware system prompt that informs AI about available tools
      */
     private createToolAwareSystemPrompt;
+    /**
+     * Execute tools if available through centralized registry
+     * Simplified approach without domain detection - relies on tool registry
+     */
+    private detectAndExecuteTools;
+    /**
+     * Enhance prompt with tool results (domain-agnostic)
+     */
+    private enhancePromptWithToolResults;
     /**
      * BACKWARD COMPATIBILITY: Legacy streamText method
      * Internally calls stream() and converts result format
@@ -97,10 +108,16 @@ export declare class NeuroLink {
      */
     registerTool(name: string, tool: SimpleTool): void;
     /**
-     * Register multiple tools at once
-     * @param tools - Object mapping tool names to configurations
+     * Register multiple tools at once - Supports both object and array formats
+     * @param tools - Object mapping tool names to configurations OR Array of tools with names
+     *
+     * Object format (existing): { toolName: SimpleTool, ... }
+     * Array format (Lighthouse compatible): [{ name: string, tool: SimpleTool }, ...]
      */
-    registerTools(tools: Record<string, SimpleTool>): void;
+    registerTools(tools: Record<string, SimpleTool> | Array<{
+        name: string;
+        tool: SimpleTool;
+    }>): void;
     /**
      * Unregister a custom tool
      * @param name - Name of the tool to remove
@@ -125,8 +142,8 @@ export declare class NeuroLink {
      */
     getInMemoryServers(): Map<string, InMemoryMCPServerConfig>;
     /**
-     * Execute a specific tool by name (from git diff)
-     * Supports both custom tools and MCP server tools
+     * Execute a specific tool by name with robust error handling
+     * Supports both custom tools and MCP server tools with timeout, retry, and circuit breaker patterns
      * @param toolName - Name of the tool to execute
      * @param params - Parameters to pass to the tool
      * @param options - Execution options
@@ -134,12 +151,33 @@ export declare class NeuroLink {
      */
     executeTool<T = unknown>(toolName: string, params?: unknown, options?: {
         timeout?: number;
+        maxRetries?: number;
+        retryDelayMs?: number;
     }): Promise<T>;
+    /**
+     * Internal tool execution method (extracted for better error handling)
+     */
+    private executeToolInternal;
     /**
      * Get all available tools including custom and in-memory ones
      * @returns Array of available tools with metadata
      */
-    getAllAvailableTools(): Promise<import("./mcp/toolRegistry.js").ToolInfo[]>;
+    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: {};
+    })[]>;
     /**
      * Get comprehensive status of all AI providers
      * Primary method for provider health checking and diagnostics
@@ -157,12 +195,6 @@ export declare class NeuroLink {
      * Internal method to test provider connection with minimal generation call
      */
     private testProviderConnection;
-    /**
-     * Check if a provider has required environment variables configured
-     * @param providerName - Name of the provider to check
-     * @returns True if provider has required environment variables
-     */
-    hasProviderEnvVars(providerName: string): Promise<boolean>;
     /**
      * Get the best available AI provider based on configuration and availability
      * @param requestedProvider - Optional preferred provider name
@@ -196,6 +228,130 @@ export declare class NeuroLink {
      * @returns Promise resolving to true if server is reachable
      */
     testMCPServer(serverId: string): Promise<boolean>;
+    /**
+     * Check if a provider has the required environment variables configured
+     * @param providerName - Name of the provider to check
+     * @returns Promise resolving to true if provider has required env vars
+     */
+    hasProviderEnvVars(providerName: string): Promise<boolean>;
+    /**
+     * Perform comprehensive health check on a specific provider
+     * @param providerName - Name of the provider to check
+     * @param options - Health check options
+     * @returns Promise resolving to detailed health status
+     */
+    checkProviderHealth(providerName: string, options?: {
+        timeout?: number;
+        includeConnectivityTest?: boolean;
+        includeModelValidation?: boolean;
+        cacheResults?: boolean;
+    }): Promise<{
+        provider: string;
+        isHealthy: boolean;
+        isConfigured: boolean;
+        hasApiKey: boolean;
+        lastChecked: Date;
+        error?: string;
+        warning?: string;
+        responseTime?: number;
+        configurationIssues: string[];
+        recommendations: string[];
+    }>;
+    /**
+     * Check health of all supported providers
+     * @param options - Health check options
+     * @returns Promise resolving to array of health statuses for all providers
+     */
+    checkAllProvidersHealth(options?: {
+        timeout?: number;
+        includeConnectivityTest?: boolean;
+        includeModelValidation?: boolean;
+        cacheResults?: boolean;
+    }): Promise<Array<{
+        provider: string;
+        isHealthy: boolean;
+        isConfigured: boolean;
+        hasApiKey: boolean;
+        lastChecked: Date;
+        error?: string;
+        warning?: string;
+        responseTime?: number;
+        configurationIssues: string[];
+        recommendations: string[];
+    }>>;
+    /**
+     * Get a summary of provider health across all supported providers
+     * @returns Promise resolving to health summary statistics
+     */
+    getProviderHealthSummary(): Promise<{
+        total: number;
+        healthy: number;
+        configured: number;
+        hasIssues: number;
+        healthyProviders: string[];
+        unhealthyProviders: string[];
+        recommendations: string[];
+    }>;
+    /**
+     * Clear provider health cache (useful for re-testing after configuration changes)
+     * @param providerName - Optional specific provider to clear cache for
+     */
+    clearProviderHealthCache(providerName?: string): Promise<void>;
+    /**
+     * Get execution metrics for all tools
+     * @returns Object with execution metrics for each tool
+     */
+    getToolExecutionMetrics(): Record<string, {
+        totalExecutions: number;
+        successfulExecutions: number;
+        failedExecutions: number;
+        successRate: number;
+        averageExecutionTime: number;
+        lastExecutionTime: number;
+    }>;
+    /**
+     * Get circuit breaker status for all tools
+     * @returns Object with circuit breaker status for each tool
+     */
+    getToolCircuitBreakerStatus(): Record<string, {
+        state: "closed" | "open" | "half-open";
+        failureCount: number;
+        isHealthy: boolean;
+    }>;
+    /**
+     * Reset circuit breaker for a specific tool
+     * @param toolName - Name of the tool to reset circuit breaker for
+     */
+    resetToolCircuitBreaker(toolName: string): void;
+    /**
+     * Clear all tool execution metrics
+     */
+    clearToolExecutionMetrics(): void;
+    /**
+     * Get comprehensive tool health report
+     * @returns Detailed health report for all tools
+     */
+    getToolHealthReport(): {
+        totalTools: number;
+        healthyTools: number;
+        unhealthyTools: number;
+        tools: Record<string, {
+            name: string;
+            isHealthy: boolean;
+            metrics: {
+                totalExecutions: number;
+                successRate: number;
+                averageExecutionTime: number;
+                lastExecutionTime: number;
+            };
+            circuitBreaker: {
+                state: "closed" | "open" | "half-open";
+                failureCount: number;
+            };
+            issues: string[];
+            recommendations: string[];
+        }>;
+    };
 }
 export declare const neurolink: NeuroLink;
 export default neurolink;