@juspay/neurolink 7.8.0 → 7.9.0

package/CHANGELOG.md

@@ -1,21 +1,32 @@
-# [7.8.0](https://github.com/juspay/neurolink/compare/v7.7.1...v7.8.0) (2025-08-11)
+## [7.9.0](https://github.com/juspay/neurolink/compare/v7.8.0...v7.9.0) (2025-08-11)
+
+### Features
 
+* **(core):**  add EventEmitter functionality for real-time event monitoring ([fd8b6b0](https://github.com/juspay/neurolink/commit/fd8b6b075ca46df4f35a58d26ad6cd4839fe2361))
 
 ### Bug Fixes
 
-* exclude _site directory from ESLint ([c0e5f1d](https://github.com/juspay/neurolink/commit/c0e5f1dce46e91ee76cd1a4954190569b4a8d1d9))
+* **(ci):**  add semantic-release configuration with dependencies and testing ([d48e274](https://github.com/juspay/neurolink/commit/d48e274bed6473df28403ae440d7109656216307))
+* **(ci):**  configure semantic-release to handle ticket prefixes with proper JSON escaping ([6d575dc](https://github.com/juspay/neurolink/commit/6d575dcf90611ad6a9854daff551dade3f06e001))
+* **(ci):**  correct JSON escaping in semantic-release configuration ([b9bbe50](https://github.com/juspay/neurolink/commit/b9bbe50461771f82e19cdbbb413ca6af6f28c31d))
+* **(cli):**  missing model name in analytics output ([416c5b7](https://github.com/juspay/neurolink/commit/416c5b74745776d1b3742557add4f501669f06f9))
+* **(providers):**  respect VERTEX_MODEL environment variable in model selection ([40eddb1](https://github.com/juspay/neurolink/commit/40eddb1d52a61891dec7fab5998b840f233352ee))
+
+# [7.8.0](https://github.com/juspay/neurolink/compare/v7.7.1...v7.8.0) (2025-08-11)
+
+### Bug Fixes
 
+- exclude \_site directory from ESLint ([c0e5f1d](https://github.com/juspay/neurolink/commit/c0e5f1dce46e91ee76cd1a4954190569b4a8d1d9))
 
 ### Features
 
-* **providers:** add comprehensive Amazon SageMaker provider integration ([9ef4ebe](https://github.com/juspay/neurolink/commit/9ef4ebeeda520a71a7461ca5f4f34a83c2062356))
+- **providers:** add comprehensive Amazon SageMaker provider integration ([9ef4ebe](https://github.com/juspay/neurolink/commit/9ef4ebeeda520a71a7461ca5f4f34a83c2062356))
 
 ## [7.7.1](https://github.com/juspay/neurolink/compare/v7.7.0...v7.7.1) (2025-08-11)
 
-
 ### Bug Fixes
 
-* **providers:** resolve ESLint errors and improve validation in Vertex AI health checker ([a5822ee](https://github.com/juspay/neurolink/commit/a5822eee3f8b6beaf3d2168ebb8888a6beaa5cb4))
+- **providers:** resolve ESLint errors and improve validation in Vertex AI health checker ([a5822ee](https://github.com/juspay/neurolink/commit/a5822eee3f8b6beaf3d2168ebb8888a6beaa5cb4))
 
 # [7.7.0](https://github.com/juspay/neurolink/compare/v7.6.1...v7.7.0) (2025-08-10)
 

package/README.md

@@ -68,6 +68,7 @@ npx @juspay/neurolink sagemaker benchmark my-endpoint  # Performance testing
 - **⚡ Performance** - Fast response times with streaming support and 68% improved status checks
 - **🛡️ Error Recovery** - Graceful failures with provider fallback and retry logic
 - **📊 Analytics & Evaluation** - Built-in usage tracking and AI-powered quality assessment
+- **🎯 Real-time Event Monitoring** - EventEmitter integration for progress tracking and debugging
 - **🔧 MCP Integration** - Model Context Protocol with 6 built-in tools and 58+ discoverable servers
 - **🚀 Lighthouse Integration** - Unified tool registration API supporting both object and array formats for seamless Lighthouse tool import
 

package/dist/cli/factories/commandFactory.js

@@ -288,8 +288,12 @@ export class CLICommandFactory {
         let analyticsText = "\n\n📊 Analytics:\n";
         // Provider and model info
         analyticsText += `   Provider: ${analytics.provider}`;
-        if (result.model) {
-            analyticsText += ` (${result.model})`;
+        // Check for model in multiple locations: result.model, analytics.model, or any model property
+        const modelName = result.model ||
+            analytics.model ||
+            analytics.modelName;
+        if (modelName) {
+            analyticsText += ` (${modelName})`;
         }
         analyticsText += "\n";
         // Token usage

package/dist/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/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/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/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/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

@@ -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/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/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/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/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/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/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/sdk/toolRegistration.js

@@ -9,15 +9,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,
@@ -211,7 +215,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)}...'`);
@@ -255,7 +261,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/utils/providerHealth.js

@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",
@@ -86,7 +86,9 @@
     "reset": "pnpm run clean && pnpm install",
     "audit": "pnpm audit && pnpm run build:analyze",
     "// Release & Publishing": "",
-    "release": "pnpm run build:complete && pnpm run test:ci && changeset publish"
+    "release": "pnpm run build:complete && pnpm run test:ci && changeset publish",
+    "test:semantic-release": "node scripts/test-semantic-release.js",
+    "release:dry-run": "npx semantic-release --dry-run"
   },
   "files": [
     "dist",
@@ -190,6 +192,7 @@
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "@vitest/coverage-v8": "^2.1.9",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
     "cors": "^2.8.5",
     "eslint": "^9.0.0",
     "express": "^5.1.0",