@juspay/neurolink 7.6.1 → 7.7.0

package/dist/lib/core/types.d.ts

@@ -77,12 +77,16 @@ export declare enum OpenAIModels {
  */
 export declare enum VertexModels {
     CLAUDE_4_0_SONNET = "claude-sonnet-4@20250514",
-    GEMINI_2_5_FLASH = "gemini-2.5-flash-preview-05-20"
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    GEMINI_2_5_PRO = "gemini-2.5-pro",
+    GEMINI_2_5_FLASH = "gemini-2.5-flash",
+    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite"
 }
 /**
  * Supported Models for Google AI Studio
  */
 export declare enum GoogleAIModels {
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
     GEMINI_2_5_PRO = "gemini-2.5-pro",
     GEMINI_2_5_FLASH = "gemini-2.5-flash",
     GEMINI_1_5_FLASH_LITE = "gemini-2.5-flash-lite"
@@ -152,8 +156,8 @@ export interface AnalyticsData {
     context?: Record<string, JsonValue>;
 }
 /**
- * Response quality evaluation scores (Lighthouse-Compatible Schema)
- * Updated to match Lighthouse's exact evaluation interface for consistency
+ * Response quality evaluation scores
+ * Comprehensive evaluation interface for response quality assessment
  */
 export interface EvaluationData {
     relevance: number;
@@ -169,6 +173,7 @@ export interface EvaluationData {
     suggestedImprovements?: string;
     evaluationModel: string;
     evaluationTime: number;
+    evaluationDomain?: string;
     evaluationProvider?: string;
     evaluationAttempt?: number;
     evaluationConfig?: {
@@ -176,6 +181,20 @@ export interface EvaluationData {
         fallbackUsed: boolean;
         costEstimate: number;
     };
+    domainConfig?: {
+        domainName: string;
+        domainDescription: string;
+        keyTerms: string[];
+        failurePatterns: string[];
+        successPatterns: string[];
+        evaluationCriteria?: Record<string, unknown>;
+    };
+    domainEvaluation?: {
+        domainRelevance: number;
+        terminologyAccuracy: number;
+        domainExpertise: number;
+        domainSpecificInsights: string[];
+    };
 }
 /**
  * BACKWARD COMPATIBILITY: Legacy evaluation interface

package/dist/lib/core/types.js

@@ -43,13 +43,17 @@ export var OpenAIModels;
 export var VertexModels;
 (function (VertexModels) {
     VertexModels["CLAUDE_4_0_SONNET"] = "claude-sonnet-4@20250514";
-    VertexModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash-preview-05-20";
+    VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    VertexModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
+    VertexModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
+    VertexModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
 })(VertexModels || (VertexModels = {}));
 /**
  * Supported Models for Google AI Studio
  */
 export var GoogleAIModels;
 (function (GoogleAIModels) {
+    GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
     GoogleAIModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
     GoogleAIModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
     GoogleAIModels["GEMINI_1_5_FLASH_LITE"] = "gemini-2.5-flash-lite";

package/dist/lib/factories/providerRegistry.js

@@ -1,5 +1,5 @@
 import { ProviderFactory } from "./providerFactory.js";
-// ✅ FINAL CIRCULAR DEPENDENCY FIX: Lazy loading all providers
+// Lazy loading all providers to avoid circular dependencies
 // Removed all static imports - providers loaded dynamically when needed
 // This breaks the circular dependency chain completely
 import { AIProviderName, GoogleAIModels, OpenAIModels } from "../core/types.js";
@@ -21,7 +21,7 @@ export class ProviderRegistry {
             return;
         }
         try {
-            // ✅ LAZY LOADING: Register providers with dynamic import factory functions
+            // Register providers with dynamic import factory functions
             const { ProviderFactory } = await import("./providerFactory.js");
             // Register Google AI Studio Provider (our validated baseline)
             ProviderFactory.registerProvider(AIProviderName.GOOGLE_AI, async (modelName, providerName, sdk) => {
@@ -55,7 +55,7 @@ export class ProviderRegistry {
             ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");
                 return new GoogleVertexProvider(modelName);
-            }, "gemini-2.5-pro", ["vertex", "googleVertex"]);
+            }, "gemini-2.5-flash", ["vertex", "googleVertex"]);
             // Register Hugging Face provider (Unified Router implementation)
             ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName) => {
                 const { HuggingFaceProvider } = await import("../providers/huggingFace.js");

package/dist/lib/index.d.ts

@@ -4,7 +4,7 @@
  * A unified AI provider interface with support for multiple providers,
  * automatic fallback, streaming, and tool integration.
  *
- * Extracted from lighthouse project's proven AI functionality.
+ * Provides comprehensive AI functionality with proven patterns.
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };

package/dist/lib/index.js

@@ -4,7 +4,7 @@
  * A unified AI provider interface with support for multiple providers,
  * automatic fallback, streaming, and tool integration.
  *
- * Extracted from lighthouse project's proven AI functionality.
+ * Provides comprehensive AI functionality with proven patterns.
  */
 // Core exports
 import { AIProviderFactory } from "./core/factory.js";

package/dist/lib/mcp/factory.d.ts

@@ -1,7 +1,7 @@
 /**
  * NeuroLink MCP Server Factory
  * Factory-First Architecture: MCP servers create tools for internal orchestration
- * Compatible with Lighthouse MCP patterns for seamless migration
+ * Compatible with MCP patterns for seamless integration
  */
 import { z } from "zod";
 import type { ExecutionContext } from "./contracts/mcpContract.js";
@@ -11,7 +11,7 @@ import type { ExecutionContext } from "./contracts/mcpContract.js";
 export type MCPServerCategory = "aiProviders" | "frameworks" | "development" | "business" | "content" | "data" | "integrations" | "automation" | "analysis" | "custom";
 /**
  * Tool execution context - Rich context passed to every tool execution
- * Following Lighthouse's pattern for rich tool context
+ * Following standard patterns for rich tool context
  * Extends ExecutionContext for compatibility
  */
 export interface NeuroLinkExecutionContext extends ExecutionContext {
@@ -71,7 +71,7 @@ export interface ToolResult {
     };
 }
 /**
- * MCP Tool Interface - Lighthouse compatible with NeuroLink enhancements
+ * MCP Tool Interface - Standard compatible with NeuroLink enhancements
  */
 export interface NeuroLinkMCPTool {
     name: string;
@@ -86,7 +86,7 @@ export interface NeuroLinkMCPTool {
     metadata?: Record<string, unknown>;
 }
 /**
- * MCP Server Interface - Lighthouse compatible
+ * MCP Server Interface - Standard compatible
  */
 export interface NeuroLinkMCPServer {
     id: string;
@@ -118,7 +118,7 @@ export interface MCPServerConfig {
 /**
  * Create MCP Server Factory Function
  *
- * Core factory function for creating Lighthouse-compatible MCP servers.
+ * Core factory function for creating MCP servers.
  * Follows Factory-First architecture where tools are internal implementation.
  *
  * @param config Server configuration with minimal required fields

package/dist/lib/mcp/factory.js

@@ -1,7 +1,7 @@
 /**
  * NeuroLink MCP Server Factory
  * Factory-First Architecture: MCP servers create tools for internal orchestration
- * Compatible with Lighthouse MCP patterns for seamless migration
+ * Compatible with MCP patterns for seamless integration
  */
 import { z } from "zod";
 /**
@@ -34,7 +34,7 @@ const ServerConfigSchema = z.object({
 /**
  * Create MCP Server Factory Function
  *
- * Core factory function for creating Lighthouse-compatible MCP servers.
+ * Core factory function for creating MCP servers.
  * Follows Factory-First architecture where tools are internal implementation.
  *
  * @param config Server configuration with minimal required fields

package/dist/lib/mcp/servers/utilities/utilityServer.d.ts

@@ -1,6 +1,6 @@
 /**
  * NeuroLink Utility Server
- * Provides general utility tools following Lighthouse patterns
+ * Provides general utility tools following standard patterns
  */
 /**
  * Utility Server - General utility tools

package/dist/lib/mcp/servers/utilities/utilityServer.js

@@ -1,6 +1,6 @@
 /**
  * NeuroLink Utility Server
- * Provides general utility tools following Lighthouse patterns
+ * Provides general utility tools following standard patterns
  */
 import { z } from "zod";
 import { createMCPServer } from "../../factory.js";

package/dist/lib/mcp/toolRegistry.js

@@ -19,7 +19,7 @@ export class MCPToolRegistry extends MCPRegistry {
      * Register all direct tools from directAgentTools
      */
     registerDirectTools() {
-        registryLogger.info("Auto-registering direct tools...");
+        registryLogger.debug("Auto-registering direct tools...");
         for (const [toolName, toolDef] of Object.entries(directAgentTools)) {
             const toolId = `direct.${toolName}`;
             const toolInfo = {
@@ -67,7 +67,7 @@ export class MCPToolRegistry extends MCPRegistry {
             });
             registryLogger.debug(`Registered direct tool: ${toolName} as ${toolId}`);
         }
-        registryLogger.info(`Auto-registered ${Object.keys(directAgentTools).length} direct tools`);
+        registryLogger.debug(`Auto-registered ${Object.keys(directAgentTools).length} direct tools`);
     }
     /**
      * Register a server with its tools (updated signature)

package/dist/lib/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("./index.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;