@juspay/neurolink 7.8.0 → 7.10.0

package/dist/lib/agent/directTools.js

@@ -325,9 +325,7 @@ export const directAgentTools = {
         },
     }),
 };
-/**
- * Get a subset of tools for specific use cases
- */
+// eslint-disable-next-line no-redeclare
 export function getToolsForCategory(category = "all") {
     switch (category) {
         case "basic":

package/dist/lib/core/dynamicModels.js

@@ -100,6 +100,12 @@ export class DynamicModelProvider {
             // Setup timeout and abort controller
             const controller = new AbortController();
             const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            // Load from URL
+            const response = await fetch(source, {
+                headers: {
+                    "User-Agent": "NeuroLink/1.0 (+https://github.com/juspay/neurolink)",
+                },
+            });
             try {
                 // Add health check for localhost before attempting full request
                 if (source.includes("localhost") || source.includes("127.0.0.1")) {

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

@@ -78,19 +78,30 @@ export declare enum OpenAIModels {
  */
 export declare enum VertexModels {
     CLAUDE_4_0_SONNET = "claude-sonnet-4@20250514",
-    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    CLAUDE_4_0_OPUS = "claude-opus-4@20250514",
+    CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
+    CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
+    CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
+    CLAUDE_3_OPUS = "claude-3-opus-20240229",
+    CLAUDE_3_HAIKU = "claude-3-haiku-20240307",
     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"
+    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    GEMINI_1_5_PRO = "gemini-1.5-pro",
+    GEMINI_1_5_FLASH = "gemini-1.5-flash"
 }
 /**
  * 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"
+    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    GEMINI_1_5_PRO = "gemini-1.5-pro",
+    GEMINI_1_5_FLASH = "gemini-1.5-flash",
+    GEMINI_1_5_FLASH_LITE = "gemini-1.5-flash-lite"
 }
 /**
  * Union type of all supported model names

package/dist/lib/core/types.js

@@ -43,21 +43,41 @@ export var OpenAIModels;
  */
 export var VertexModels;
 (function (VertexModels) {
+    // Claude 4 Series (Latest - May 2025)
     VertexModels["CLAUDE_4_0_SONNET"] = "claude-sonnet-4@20250514";
-    VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    VertexModels["CLAUDE_4_0_OPUS"] = "claude-opus-4@20250514";
+    // Claude 3.5 Series (Still supported)
+    VertexModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
+    VertexModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
+    // Claude 3 Series (Legacy support)
+    VertexModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
+    VertexModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
+    VertexModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
+    // Gemini 2.5 Series (Latest - 2025)
     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";
+    // Gemini 2.0 Series
+    VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    // Gemini 1.5 Series (Legacy support)
+    VertexModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
+    VertexModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
 })(VertexModels || (VertexModels = {}));
 /**
  * Supported Models for Google AI Studio
  */
 export var GoogleAIModels;
 (function (GoogleAIModels) {
-    GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    // Gemini 2.5 Series (Latest - 2025)
     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";
+    GoogleAIModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
+    // Gemini 2.0 Series
+    GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    // Gemini 1.5 Series (Legacy support)
+    GoogleAIModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
+    GoogleAIModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
+    GoogleAIModels["GEMINI_1_5_FLASH_LITE"] = "gemini-1.5-flash-lite";
 })(GoogleAIModels || (GoogleAIModels = {}));
 /**
  * Default provider configurations

package/dist/lib/factories/providerFactory.js

@@ -35,7 +35,16 @@ export class ProviderFactory {
         if (!registration) {
             throw new Error(`Unknown provider: ${providerName}. Available providers: ${this.getAvailableProviders().join(", ")}`);
         }
-        const model = modelName || registration.defaultModel;
+        // Respect environment variables before falling back to registry default
+        let model = modelName;
+        if (!model) {
+            // Check for provider-specific environment variables
+            if (providerName.toLowerCase().includes("vertex")) {
+                model = process.env.VERTEX_MODEL;
+            }
+            // Fallback to registry default if no env var
+            model = model || registration.defaultModel;
+        }
         try {
             // Try calling as factory function first, then fallback to constructor
             let result;

package/dist/lib/factories/providerRegistry.js

@@ -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-flash", ["vertex", "googleVertex"]);
+            }, "claude-sonnet-4@20250514", ["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/neurolink.d.ts

@@ -10,6 +10,7 @@ import type { GenerateOptions, GenerateResult } from "./types/generateTypes.js";
 import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
 import type { SimpleTool } from "./sdk/toolRegistration.js";
 import type { InMemoryMCPServerConfig } from "./types/mcpTypes.js";
+import { EventEmitter } from "events";
 export interface ProviderStatus {
     provider: string;
     status: "working" | "failed" | "not-configured";
@@ -41,10 +42,19 @@ export interface MCPServerInfo {
 }
 export declare class NeuroLink {
     private mcpInitialized;
+    private emitter;
     private customTools;
     private inMemoryServers;
     private toolCircuitBreakers;
     private toolExecutionMetrics;
+    /**
+     * Helper method to emit tool end event in a consistent way
+     * Used by executeTool in both success and error paths
+     * @param toolName - Name of the tool
+     * @param startTime - Timestamp when tool execution started
+     * @param success - Whether the tool execution was successful
+     */
+    private emitToolEndEvent;
     constructor();
     /**
      * Initialize MCP registry with enhanced error handling and resource cleanup
@@ -101,6 +111,11 @@ export declare class NeuroLink {
      * Future-ready for multi-modal capabilities with current text focus
      */
     stream(options: StreamOptions): Promise<StreamResult>;
+    /**
+     * Get the EventEmitter to listen to NeuroLink events
+     * @returns EventEmitter instance
+     */
+    getEventEmitter(): EventEmitter<[never]>;
     /**
      * Register a custom tool that will be available to all AI providers
      * @param name - Unique name for the tool

package/dist/lib/neurolink.js

@@ -26,15 +26,32 @@ import { validateTool, createMCPServerFromTools, } from "./sdk/toolRegistration.
 import { processFactoryOptions, enhanceTextGenerationOptions, validateFactoryConfig, processStreamingFactoryOptions, createCleanStreamOptions, } from "./utils/factoryProcessing.js";
 // Enhanced error handling imports
 import { ErrorFactory, NeuroLinkError, withTimeout, withRetry, isRetriableError, logStructuredError, CircuitBreaker, } from "./utils/errorHandling.js";
+import { EventEmitter } from "events";
 // Core types imported from core/types.js
 export class NeuroLink {
     mcpInitialized = false;
+    emitter = new EventEmitter();
     // Tool registration support
     customTools = new Map();
     inMemoryServers = new Map();
     // Enhanced error handling support
     toolCircuitBreakers = new Map();
     toolExecutionMetrics = new Map();
+    /**
+     * Helper method to emit tool end event in a consistent way
+     * Used by executeTool in both success and error paths
+     * @param toolName - Name of the tool
+     * @param startTime - Timestamp when tool execution started
+     * @param success - Whether the tool execution was successful
+     */
+    emitToolEndEvent(toolName, startTime, success) {
+        this.emitter.emit("tool:end", {
+            toolName,
+            responseTime: Date.now() - startTime,
+            success,
+            timestamp: Date.now(),
+        });
+    }
     constructor() {
         // SDK always disables manual MCP config for security
         ProviderRegistry.setOptions({
@@ -91,7 +108,6 @@ export class NeuroLink {
      * Replaces both generateText and legacy methods
      */
     async generate(optionsOrPrompt) {
-        const startTime = Date.now();
         // Convert string prompt to full options
         const options = typeof optionsOrPrompt === "string"
             ? { input: { text: optionsOrPrompt } }
@@ -100,6 +116,12 @@ export class NeuroLink {
         if (!options.input?.text || typeof options.input.text !== "string") {
             throw new Error("Input text is required and must be a non-empty string");
         }
+        const startTime = Date.now();
+        // Emit generation start event
+        this.emitter.emit("generation:start", {
+            provider: options.provider || "auto",
+            timestamp: startTime,
+        });
         // Process factory configuration
         const factoryResult = processFactoryOptions(options);
         // Validate factory configuration if present
@@ -142,6 +164,13 @@ export class NeuroLink {
         }
         // Use redesigned generation logic
         const textResult = await this.generateTextInternal(textOptions);
+        // Emit generation completion event
+        this.emitter.emit("generation:end", {
+            provider: textResult.provider,
+            responseTime: Date.now() - startTime,
+            toolsUsed: textResult.toolsUsed,
+            timestamp: Date.now(),
+        });
         // Convert back to GenerateResult
         const generateResult = {
             content: textResult.content,
@@ -509,6 +538,11 @@ export class NeuroLink {
             options.input.text.trim() === "") {
             throw new Error("Stream options must include input.text as a non-empty string");
         }
+        // Emit stream start event
+        this.emitter.emit("stream:start", {
+            provider: options.provider || "auto",
+            timestamp: startTime,
+        });
         // Process factory configuration for streaming
         const factoryResult = processFactoryOptions(options);
         const streamingResult = processStreamingFactoryOptions(options);
@@ -576,6 +610,11 @@ export class NeuroLink {
                 responseTime,
                 provider: providerName,
             });
+            // Emit stream completion event
+            this.emitter.emit("stream:end", {
+                provider: providerName,
+                responseTime,
+            });
             // Convert to StreamResult format - Include analytics and evaluation from provider
             return {
                 stream,
@@ -615,6 +654,12 @@ export class NeuroLink {
             const cleanOptions = createCleanStreamOptions(enhancedOptions);
             const streamResult = await provider.stream(cleanOptions);
             const responseTime = Date.now() - startTime;
+            // Emit stream completion event for fallback
+            this.emitter.emit("stream:end", {
+                provider: providerName,
+                responseTime,
+                fallback: true,
+            });
             return {
                 stream: streamResult.stream,
                 provider: providerName,
@@ -643,6 +688,13 @@ export class NeuroLink {
             };
         }
     }
+    /**
+     * Get the EventEmitter to listen to NeuroLink events
+     * @returns EventEmitter instance
+     */
+    getEventEmitter() {
+        return this.emitter;
+    }
     // ========================================
     // Tool Registration API
     // ========================================
@@ -652,6 +704,11 @@ export class NeuroLink {
      * @param tool - Tool configuration
      */
     registerTool(name, tool) {
+        // Emit tool registration start event
+        this.emitter.emit("tools-register:start", {
+            toolName: name,
+            timestamp: Date.now(),
+        });
         try {
             // Validate tool configuration
             validateTool(name, tool);
@@ -666,6 +723,12 @@ export class NeuroLink {
             // Store as in-memory server
             this.inMemoryServers.set(serverId, mcpServer);
             logger.info(`Registered custom tool: ${name}`);
+            // Emit tool registration success event
+            this.emitter.emit("tools-register:end", {
+                toolName: name,
+                success: true,
+                timestamp: Date.now(),
+            });
         }
         catch (error) {
             logger.error(`Failed to register tool ${name}:`, error);
@@ -758,6 +821,11 @@ export class NeuroLink {
     async executeTool(toolName, params = {}, options) {
         const functionTag = "NeuroLink.executeTool";
         const executionStartTime = Date.now();
+        // Emit tool start event
+        this.emitter.emit("tool:start", {
+            toolName,
+            timestamp: executionStartTime,
+        });
         // Set default options
         const finalOptions = {
             timeout: options?.timeout || 30000, // 30 second default timeout
@@ -832,6 +900,8 @@ export class NeuroLink {
                 memoryDelta,
                 circuitBreakerState: circuitBreaker.getState(),
             });
+            // Emit tool end event using the helper method
+            this.emitToolEndEvent(toolName, executionStartTime, true);
             return result;
         }
         catch (error) {
@@ -867,6 +937,8 @@ export class NeuroLink {
             else {
                 structuredError = ErrorFactory.toolExecutionFailed(toolName, new Error(String(error)));
             }
+            // Emit tool end event using the helper method
+            this.emitToolEndEvent(toolName, executionStartTime, false);
             // Add execution context to structured error
             structuredError = new NeuroLinkError({
                 ...structuredError,

package/dist/lib/providers/googleVertex.d.ts

@@ -108,6 +108,10 @@ export declare class GoogleVertexProvider extends BaseProvider {
             maxTokens: number;
         };
     };
+    /**
+     * Get model suggestions when a model is not found
+     */
+    private getModelSuggestions;
 }
 export default GoogleVertexProvider;
 export { GoogleVertexProvider as GoogleVertexAI };

package/dist/lib/providers/googleVertex.js

@@ -40,9 +40,9 @@ const getVertexLocation = () => {
         "us-central1");
 };
 const getDefaultVertexModel = () => {
-    // Use gemini-1.5-pro as default - stable and widely supported model
+    // Use gemini-2.5-flash as default - latest and best price-performance model
     // Override with VERTEX_MODEL environment variable if needed
-    return process.env.VERTEX_MODEL || "gemini-1.5-pro";
+    return process.env.VERTEX_MODEL || "gemini-2.5-flash";
 };
 const hasGoogleCredentials = () => {
     return !!(process.env.GOOGLE_APPLICATION_CREDENTIALS ||
@@ -276,7 +276,8 @@ export class GoogleVertexProvider extends BaseProvider {
             return new Error(`❌ Google Vertex AI Permission Denied\n\nYour Google Cloud credentials don't have permission to access Vertex AI.\n\nRequired Steps:\n1. Ensure your service account has Vertex AI User role\n2. Check if Vertex AI API is enabled in your project\n3. Verify your project ID is correct\n4. Confirm your location/region has Vertex AI available`);
         }
         if (message.includes("NOT_FOUND")) {
-            return new Error(`❌ Google Vertex AI Model Not Found\n\n${message}\n\nCheck:\n1. Model name is correct (e.g., 'gemini-1.5-pro')\n2. Model is available in your region (${this.location})\n3. Your project has access to the model\n4. Model supports your request parameters`);
+            const modelSuggestions = this.getModelSuggestions(this.modelName);
+            return new Error(`❌ Google Vertex AI Model Not Found\n\n${message}\n\nModel '${this.modelName}' is not available.\n\nSuggested alternatives:\n${modelSuggestions}\n\nTroubleshooting:\n1. Check model name spelling and format\n2. Verify model is available in your region (${this.location})\n3. Ensure your project has access to the model\n4. For Claude models, enable Anthropic integration in Google Cloud Console`);
         }
         if (message.includes("QUOTA_EXCEEDED")) {
             return new Error(`❌ Google Vertex AI Quota Exceeded\n\n${message}\n\nSolutions:\n1. Check your Vertex AI quotas in Google Cloud Console\n2. Request quota increase if needed\n3. Try a different model or reduce request frequency\n4. Consider using a different region`);
@@ -520,6 +521,46 @@ export class GoogleVertexProvider extends BaseProvider {
             },
         };
     }
+    /**
+     * Get model suggestions when a model is not found
+     */
+    getModelSuggestions(requestedModel) {
+        const availableModels = {
+            google: [
+                "gemini-2.5-pro",
+                "gemini-2.5-flash",
+                "gemini-2.5-flash-lite",
+                "gemini-2.0-flash-001",
+                "gemini-1.5-pro",
+                "gemini-1.5-flash",
+            ],
+            claude: [
+                "claude-sonnet-4@20250514",
+                "claude-opus-4@20250514",
+                "claude-3-5-sonnet-20241022",
+                "claude-3-5-haiku-20241022",
+                "claude-3-sonnet-20240229",
+                "claude-3-haiku-20240307",
+                "claude-3-opus-20240229",
+            ],
+        };
+        let suggestions = "\n🤖 Google Models (always available):\n";
+        availableModels.google.forEach((model) => {
+            suggestions += `  • ${model}\n`;
+        });
+        suggestions += "\n🧠 Claude Models (requires Anthropic integration):\n";
+        availableModels.claude.forEach((model) => {
+            suggestions += `  • ${model}\n`;
+        });
+        // If the requested model looks like a Claude model, provide specific guidance
+        if (requestedModel && requestedModel.toLowerCase().includes("claude")) {
+            suggestions += `\n💡 Tip: "${requestedModel}" appears to be a Claude model.\n`;
+            suggestions +=
+                "Ensure Anthropic integration is enabled in your Google Cloud project.\n";
+            suggestions += "Try using an available Claude model from the list above.";
+        }
+        return suggestions;
+    }
 }
 export default GoogleVertexProvider;
 // Re-export for compatibility

package/dist/lib/providers/sagemaker/client.js

@@ -77,7 +77,7 @@ export class SageMakerRuntimeClient {
             if (!client) {
                 throw new Error("SageMaker client has been disposed");
             }
-            const response = await this.executeWithRetry(() => client.send(command), params.EndpointName);
+            const response = (await this.executeWithRetry(() => client.send(command), params.EndpointName));
             const duration = Date.now() - startTime;
             logger.debug("SageMaker endpoint invocation successful", {
                 endpointName: params.EndpointName,
@@ -134,7 +134,7 @@ export class SageMakerRuntimeClient {
             if (!client) {
                 throw new Error("SageMaker client has been disposed");
             }
-            const response = await this.executeWithRetry(() => client.send(command), params.EndpointName);
+            const response = (await this.executeWithRetry(() => client.send(command), params.EndpointName));
             logger.debug("SageMaker streaming invocation started", {
                 endpointName: params.EndpointName,
                 setupDuration: Date.now() - startTime,

package/dist/lib/sdk/toolRegistration.d.ts

@@ -13,7 +13,7 @@ import type { JsonValue } from "../types/common.js";
  */
 declare const VALIDATION_CONFIG: {
     readonly NAME_MIN_LENGTH: 2;
-    readonly NAME_MAX_LENGTH: 50;
+    readonly NAME_MAX_LENGTH: number;
     readonly DESCRIPTION_MIN_LENGTH: 10;
     readonly DESCRIPTION_MAX_LENGTH: number;
     readonly RESERVED_NAMES: Set<string>;

package/dist/lib/sdk/toolRegistration.js

@@ -8,15 +8,19 @@ import { logger } from "../utils/logger.js";
 /**
  * Configuration constants for tool validation
  */
-const envValue = parseInt(process.env.NEUROLINK_TOOL_DESCRIPTION_MAX_LENGTH || "200", 10);
-const DEFAULT_DESCRIPTION_MAX_LENGTH = Number.isInteger(envValue) && envValue > 0 ? envValue : 200;
+const envDescValue = parseInt(process.env.NEUROLINK_TOOL_DESCRIPTION_MAX_LENGTH || "200", 10);
+// Allow 0 to mean unlimited (no length restriction)
+const DEFAULT_DESCRIPTION_MAX_LENGTH = Number.isInteger(envDescValue) && envDescValue >= 0 ? envDescValue : 200;
+const envNameValue = parseInt(process.env.NEUROLINK_TOOL_NAME_MAX_LENGTH || "50", 10);
+// Allow 0 to mean unlimited (no length restriction)
+const DEFAULT_NAME_MAX_LENGTH = Number.isInteger(envNameValue) && envNameValue >= 0 ? envNameValue : 50;
 /**
  * Enhanced validation configuration
  */
 const VALIDATION_CONFIG = {
     // Tool name constraints
     NAME_MIN_LENGTH: 2,
-    NAME_MAX_LENGTH: 50,
+    NAME_MAX_LENGTH: DEFAULT_NAME_MAX_LENGTH,
     // Description constraints
     DESCRIPTION_MIN_LENGTH: 10,
     DESCRIPTION_MAX_LENGTH: DEFAULT_DESCRIPTION_MAX_LENGTH,
@@ -210,7 +214,9 @@ function validateToolName(name) {
             `Minimum length: ${VALIDATION_CONFIG.NAME_MIN_LENGTH} characters. ` +
             `Example: 'get_data', 'send_email'`);
     }
-    if (trimmedName.length > VALIDATION_CONFIG.NAME_MAX_LENGTH) {
+    // Only check name length if limit is greater than 0 (0 means unlimited)
+    if (VALIDATION_CONFIG.NAME_MAX_LENGTH > 0 &&
+        trimmedName.length > VALIDATION_CONFIG.NAME_MAX_LENGTH) {
         throw new Error(`Tool name too long: '${name}' (${trimmedName.length} chars). ` +
             `Maximum length: ${VALIDATION_CONFIG.NAME_MAX_LENGTH} characters. ` +
             `Consider shortening: '${trimmedName.substring(0, 20)}...'`);
@@ -254,7 +260,9 @@ function validateToolDescription(name, description) {
             `The description should clearly explain what the tool does and when to use it. ` +
             `Example: "Fetches current weather data for a specified location using coordinates or city name"`);
     }
-    if (trimmedDescription.length > VALIDATION_CONFIG.DESCRIPTION_MAX_LENGTH) {
+    // Only check description length if limit is greater than 0 (0 means unlimited)
+    if (VALIDATION_CONFIG.DESCRIPTION_MAX_LENGTH > 0 &&
+        trimmedDescription.length > VALIDATION_CONFIG.DESCRIPTION_MAX_LENGTH) {
         throw new Error(`Tool '${name}' description too long: ${trimmedDescription.length} characters. ` +
             `Maximum length: ${VALIDATION_CONFIG.DESCRIPTION_MAX_LENGTH} characters. ` +
             `Current description: "${trimmedDescription.substring(0, 50)}..." ` +

package/dist/lib/utils/providerHealth.js

@@ -21,7 +21,7 @@ export class ProviderHealthChecker {
         }
         const parsed = Number(envValue);
         if (isNaN(parsed) || parsed <= 0 || parsed > 10) {
-            console.warn(`Invalid PROVIDER_FAILURE_THRESHOLD: ${envValue} (must be between 1 and 10), using default: 3`);
+            logger.warn(`Invalid PROVIDER_FAILURE_THRESHOLD: ${envValue} (must be between 1 and 10), using default: 3`);
             return 3;
         }
         return parsed;
@@ -229,11 +229,19 @@ export class ProviderHealthChecker {
      * Check model availability (if possible without making API calls)
      */
     static async checkModelAvailability(providerName, healthStatus) {
-        // For now, we'll do basic model name validation
-        // In the future, this could be enhanced with actual API calls
+        // Basic model name validation and recommendations
         const commonModels = this.getCommonModelsForProvider(providerName);
         if (commonModels.length > 0) {
-            healthStatus.recommendations.push(`Common models for ${providerName}: ${commonModels.slice(0, 3).join(", ")}`);
+            if (providerName === AIProviderName.VERTEX) {
+                // Provide more detailed information for Vertex AI
+                healthStatus.recommendations.push(`Available models for ${providerName}:\n` +
+                    `  Google Models: gemini-1.5-pro, gemini-1.5-flash\n` +
+                    `  Claude Models: claude-3-5-sonnet-20241022, claude-3-sonnet-20240229, claude-3-haiku-20240307, claude-3-opus-20240229\n` +
+                    `  Note: Claude models require Anthropic integration to be enabled in your Google Cloud project`);
+            }
+            else {
+                healthStatus.recommendations.push(`Common models for ${providerName}: ${commonModels.slice(0, 3).join(", ")}`);
+            }
         }
     }
     /**
@@ -408,7 +416,14 @@ export class ProviderHealthChecker {
             case AIProviderName.GOOGLE_AI:
                 return ["gemini-1.5-pro", "gemini-1.5-flash", "gemini-pro"];
             case AIProviderName.VERTEX:
-                return ["gemini-1.5-pro", "gemini-1.5-flash"];
+                return [
+                    "gemini-1.5-pro",
+                    "gemini-1.5-flash",
+                    "claude-3-5-sonnet-20241022",
+                    "claude-3-sonnet-20240229",
+                    "claude-3-haiku-20240307",
+                    "claude-3-opus-20240229",
+                ];
             case AIProviderName.BEDROCK:
                 return [
                     "anthropic.claude-3-sonnet-20240229-v1:0",

package/dist/mcp/servers/agent/directToolsServer.js

@@ -2,7 +2,6 @@
  * NeuroLink Direct Tools Server
  * Wraps the agent direct tools as an MCP server for proper registration
  */
-import { z } from "zod";
 import { createMCPServer } from "../../factory.js";
 import { directAgentTools } from "../../../agent/directTools.js";
 import { logger } from "../../../utils/logger.js";

package/dist/mcp/servers/aiProviders/aiCoreServer.js

@@ -5,7 +5,6 @@
  */
 import { z } from "zod";
 import { createMCPServer } from "../../factory.js";
-import { ServiceRegistry } from "../../../core/serviceRegistry.js";
 import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
 import { logger } from "../../../utils/logger.js";
 /**

package/dist/models/modelResolver.js

@@ -3,7 +3,6 @@
  * Provides model resolution, search, and recommendation functionality
  * Part of Phase 4.1 - Models Command System
  */
-import { AIProviderName } from "../core/types.js";
 import { MODEL_REGISTRY, MODEL_ALIASES, USE_CASE_RECOMMENDATIONS, getAllModels, getModelById, getModelsByProvider, getAvailableProviders, calculateCost, formatModelForDisplay, } from "./modelRegistry.js";
 /**
  * Model resolver class with advanced search and recommendation functionality

package/dist/neurolink.d.ts

@@ -10,6 +10,7 @@ import type { GenerateOptions, GenerateResult } from "./types/generateTypes.js";
 import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
 import type { SimpleTool } from "./sdk/toolRegistration.js";
 import type { InMemoryMCPServerConfig } from "./types/mcpTypes.js";
+import { EventEmitter } from "events";
 export interface ProviderStatus {
     provider: string;
     status: "working" | "failed" | "not-configured";
@@ -41,10 +42,19 @@ export interface MCPServerInfo {
 }
 export declare class NeuroLink {
     private mcpInitialized;
+    private emitter;
     private customTools;
     private inMemoryServers;
     private toolCircuitBreakers;
     private toolExecutionMetrics;
+    /**
+     * Helper method to emit tool end event in a consistent way
+     * Used by executeTool in both success and error paths
+     * @param toolName - Name of the tool
+     * @param startTime - Timestamp when tool execution started
+     * @param success - Whether the tool execution was successful
+     */
+    private emitToolEndEvent;
     constructor();
     /**
      * Initialize MCP registry with enhanced error handling and resource cleanup
@@ -101,6 +111,11 @@ export declare class NeuroLink {
      * Future-ready for multi-modal capabilities with current text focus
      */
     stream(options: StreamOptions): Promise<StreamResult>;
+    /**
+     * Get the EventEmitter to listen to NeuroLink events
+     * @returns EventEmitter instance
+     */
+    getEventEmitter(): EventEmitter<[never]>;
     /**
      * Register a custom tool that will be available to all AI providers
      * @param name - Unique name for the tool