@juspay/neurolink 7.14.4 → 7.14.6

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [7.14.6](https://github.com/juspay/neurolink/compare/v7.14.5...v7.14.6) (2025-08-18)
+
+### Bug Fixes
+
+- **(docs):** improve and update cli guide ([4039044](https://github.com/juspay/neurolink/commit/40390444950f763f4e360783f99256b16eb9aab0))
+
+## [7.14.5](https://github.com/juspay/neurolink/compare/v7.14.4...v7.14.5) (2025-08-18)
+
+### Bug Fixes
+
+- **(mcp):** prevent memory leak from uncleared interval timer in MCPCircuitBreaker ([1f2ae47](https://github.com/juspay/neurolink/commit/1f2ae4743dc8657baac9ba28a053c4e9d199cdbc))
+
 ## [7.14.4](https://github.com/juspay/neurolink/compare/v7.14.3...v7.14.4) (2025-08-18)
 
 ### Bug Fixes

package/README.md

@@ -9,7 +9,7 @@
 
 > **Enterprise AI Development Platform** with universal provider support, factory pattern architecture, and **access to 100+ AI models** through LiteLLM integration. Production-ready with TypeScript support.
 
-**NeuroLink** is an Enterprise AI Development Platform that unifies **11 major AI providers** with intelligent fallback and built-in tool support. Available as both a **programmatic SDK** and **professional CLI tool**. Features LiteLLM integration for **100+ models**, plus 6 core tools working across all providers. Extracted from production use at Juspay.
+**NeuroLink** is an Enterprise AI Development Platform that unifies **12 major AI providers** with intelligent fallback and built-in tool support. Available as both a **programmatic SDK** and **professional CLI tool**. Features LiteLLM integration for **100+ models**, plus 6 core tools working across all providers. Extracted from production use at Juspay.
 
 ## 🎉 **NEW: LiteLLM Integration - Access 100+ AI Models**
 
@@ -102,7 +102,7 @@ npx @juspay/neurolink generate "Hello, AI" --provider openai-compatible
 export GOOGLE_AI_API_KEY="AIza-your-google-ai-api-key"
 npx @juspay/neurolink generate "Hello, AI" --provider google-ai
 
-# Option 3: Amazon SageMaker - Use your custom deployed models
+# Option 4: Amazon SageMaker - Use your custom deployed models
 export AWS_ACCESS_KEY_ID="your-access-key"
 export AWS_SECRET_ACCESS_KEY="your-secret-key"
 export SAGEMAKER_DEFAULT_ENDPOINT="your-endpoint-name"
@@ -204,10 +204,9 @@ const neurolink = new NeuroLink({
 Method aliases that match CLI command names:
 
 ```typescript
-// All three methods are equivalent:
+// The following methods are equivalent:
 const result1 = await provider.generate({ input: { text: "Hello" } }); // Original
-const result2 = await provider.generate({ input: { text: "Hello" } }); // Matches CLI 'generate'
-const result3 = await provider.gen({ input: { text: "Hello" } }); // Matches CLI 'gen'
+const result2 = await provider.gen({ input: { text: "Hello" } }); // Matches CLI 'gen'
 
 // Use whichever style you prefer:
 const provider = createBestAIProvider();
@@ -336,7 +335,7 @@ const productData = JSON.parse(result.content);
 console.log(productData.name, productData.price, productData.features);
 ```
 
-**📖 [Complete Setup Guide](./docs/PROVIDER-CONFIGURATION.md)** - All providers with detailed instructions
+**📖 [Complete Setup Guide](./docs/CONFIGURATION.md)** - All providers with detailed instructions
 
 ## ✨ Key Features
 
@@ -807,5 +806,3 @@ MIT © [Juspay Technologies](https://juspay.in)
 <p align="center">
   <strong>Built with ❤️ by <a href="https://juspay.in">Juspay Technologies</a></strong>
 </p>
-# Force fresh deployment after GitHub Pages source change
-# Trigger fresh CI run

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

@@ -91,6 +91,7 @@ export declare class MCPCircuitBreaker extends EventEmitter {
     private lastFailureTime;
     private halfOpenCalls;
     private lastStateChange;
+    private cleanupTimer?;
     constructor(name: string, config?: Partial<CircuitBreakerConfig>);
     /**
      * Execute an operation with circuit breaker protection
@@ -144,6 +145,12 @@ export declare class MCPCircuitBreaker extends EventEmitter {
      * Check if circuit is half-open
      */
     isHalfOpen(): boolean;
+    /**
+     * Destroy the circuit breaker and clean up resources
+     * This method should be called when the circuit breaker is no longer needed
+     * to prevent memory leaks from the cleanup timer
+     */
+    destroy(): void;
 }
 /**
  * Circuit breaker manager for multiple circuit breakers
@@ -155,7 +162,7 @@ export declare class CircuitBreakerManager {
      */
     getBreaker(name: string, config?: Partial<CircuitBreakerConfig>): MCPCircuitBreaker;
     /**
-     * Remove a circuit breaker
+     * Remove a circuit breaker and clean up its resources
      */
     removeBreaker(name: string): boolean;
     /**
@@ -180,5 +187,10 @@ export declare class CircuitBreakerManager {
         halfOpenBreakers: number;
         unhealthyBreakers: string[];
     };
+    /**
+     * Destroy all circuit breakers and clean up their resources
+     * This should be called during application shutdown to prevent memory leaks
+     */
+    destroyAll(): void;
 }
 export declare const globalCircuitBreakerManager: CircuitBreakerManager;

package/dist/lib/mcp/mcpCircuitBreaker.js

@@ -17,6 +17,8 @@ export class MCPCircuitBreaker extends EventEmitter {
     lastFailureTime = 0;
     halfOpenCalls = 0;
     lastStateChange = new Date();
+    // Store the cleanup timer reference for proper cleanup
+    cleanupTimer;
     constructor(name, config = {}) {
         super();
         this.name = name;
@@ -29,8 +31,8 @@ export class MCPCircuitBreaker extends EventEmitter {
             minimumCallsBeforeCalculation: config.minimumCallsBeforeCalculation ?? 10,
             statisticsWindowSize: config.statisticsWindowSize ?? 300000, // 5 minutes
         };
-        // Clean up old call records periodically
-        setInterval(() => this.cleanupCallHistory(), 60000);
+        // Clean up old call records periodically - now storing the timer reference
+        this.cleanupTimer = setInterval(() => this.cleanupCallHistory(), 60000);
     }
     /**
      * Execute an operation with circuit breaker protection
@@ -250,6 +252,24 @@ export class MCPCircuitBreaker extends EventEmitter {
     isHalfOpen() {
         return this.state === "half-open";
     }
+    /**
+     * Destroy the circuit breaker and clean up resources
+     * This method should be called when the circuit breaker is no longer needed
+     * to prevent memory leaks from the cleanup timer
+     */
+    destroy() {
+        // Clear the interval timer to prevent memory leaks
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+            mcpLogger.debug(`[CircuitBreaker:${this.name}] Cleanup timer cleared`);
+        }
+        // Clear any remaining event listeners
+        this.removeAllListeners();
+        // Clear call history to free memory
+        this.callHistory = [];
+        mcpLogger.debug(`[CircuitBreaker:${this.name}] Destroyed and cleaned up`);
+    }
 }
 /**
  * Circuit breaker manager for multiple circuit breakers
@@ -268,14 +288,18 @@ export class CircuitBreakerManager {
         return this.breakers.get(name);
     }
     /**
-     * Remove a circuit breaker
+     * Remove a circuit breaker and clean up its resources
      */
     removeBreaker(name) {
-        const removed = this.breakers.delete(name);
-        if (removed) {
-            mcpLogger.debug(`[CircuitBreakerManager] Removed circuit breaker: ${name}`);
+        const breaker = this.breakers.get(name);
+        if (breaker) {
+            // Destroy the breaker to clean up its timer and resources
+            breaker.destroy();
+            this.breakers.delete(name);
+            mcpLogger.debug(`[CircuitBreakerManager] Removed and cleaned up circuit breaker: ${name}`);
+            return true;
         }
-        return removed;
+        return false;
     }
     /**
      * Get all circuit breaker names
@@ -333,6 +357,17 @@ export class CircuitBreakerManager {
             unhealthyBreakers,
         };
     }
+    /**
+     * Destroy all circuit breakers and clean up their resources
+     * This should be called during application shutdown to prevent memory leaks
+     */
+    destroyAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.destroy();
+        }
+        this.breakers.clear();
+        mcpLogger.info("[CircuitBreakerManager] Destroyed all circuit breakers");
+    }
 }
 // Global circuit breaker manager instance
 export const globalCircuitBreakerManager = new CircuitBreakerManager();

package/dist/mcp/mcpCircuitBreaker.d.ts

@@ -91,6 +91,7 @@ export declare class MCPCircuitBreaker extends EventEmitter {
     private lastFailureTime;
     private halfOpenCalls;
     private lastStateChange;
+    private cleanupTimer?;
     constructor(name: string, config?: Partial<CircuitBreakerConfig>);
     /**
      * Execute an operation with circuit breaker protection
@@ -144,6 +145,12 @@ export declare class MCPCircuitBreaker extends EventEmitter {
      * Check if circuit is half-open
      */
     isHalfOpen(): boolean;
+    /**
+     * Destroy the circuit breaker and clean up resources
+     * This method should be called when the circuit breaker is no longer needed
+     * to prevent memory leaks from the cleanup timer
+     */
+    destroy(): void;
 }
 /**
  * Circuit breaker manager for multiple circuit breakers
@@ -155,7 +162,7 @@ export declare class CircuitBreakerManager {
      */
     getBreaker(name: string, config?: Partial<CircuitBreakerConfig>): MCPCircuitBreaker;
     /**
-     * Remove a circuit breaker
+     * Remove a circuit breaker and clean up its resources
      */
     removeBreaker(name: string): boolean;
     /**
@@ -180,5 +187,10 @@ export declare class CircuitBreakerManager {
         halfOpenBreakers: number;
         unhealthyBreakers: string[];
     };
+    /**
+     * Destroy all circuit breakers and clean up their resources
+     * This should be called during application shutdown to prevent memory leaks
+     */
+    destroyAll(): void;
 }
 export declare const globalCircuitBreakerManager: CircuitBreakerManager;

package/dist/mcp/mcpCircuitBreaker.js

@@ -17,6 +17,8 @@ export class MCPCircuitBreaker extends EventEmitter {
     lastFailureTime = 0;
     halfOpenCalls = 0;
     lastStateChange = new Date();
+    // Store the cleanup timer reference for proper cleanup
+    cleanupTimer;
     constructor(name, config = {}) {
         super();
         this.name = name;
@@ -29,8 +31,8 @@ export class MCPCircuitBreaker extends EventEmitter {
             minimumCallsBeforeCalculation: config.minimumCallsBeforeCalculation ?? 10,
             statisticsWindowSize: config.statisticsWindowSize ?? 300000, // 5 minutes
         };
-        // Clean up old call records periodically
-        setInterval(() => this.cleanupCallHistory(), 60000);
+        // Clean up old call records periodically - now storing the timer reference
+        this.cleanupTimer = setInterval(() => this.cleanupCallHistory(), 60000);
     }
     /**
      * Execute an operation with circuit breaker protection
@@ -250,6 +252,24 @@ export class MCPCircuitBreaker extends EventEmitter {
     isHalfOpen() {
         return this.state === "half-open";
     }
+    /**
+     * Destroy the circuit breaker and clean up resources
+     * This method should be called when the circuit breaker is no longer needed
+     * to prevent memory leaks from the cleanup timer
+     */
+    destroy() {
+        // Clear the interval timer to prevent memory leaks
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+            mcpLogger.debug(`[CircuitBreaker:${this.name}] Cleanup timer cleared`);
+        }
+        // Clear any remaining event listeners
+        this.removeAllListeners();
+        // Clear call history to free memory
+        this.callHistory = [];
+        mcpLogger.debug(`[CircuitBreaker:${this.name}] Destroyed and cleaned up`);
+    }
 }
 /**
  * Circuit breaker manager for multiple circuit breakers
@@ -268,14 +288,18 @@ export class CircuitBreakerManager {
         return this.breakers.get(name);
     }
     /**
-     * Remove a circuit breaker
+     * Remove a circuit breaker and clean up its resources
      */
     removeBreaker(name) {
-        const removed = this.breakers.delete(name);
-        if (removed) {
-            mcpLogger.debug(`[CircuitBreakerManager] Removed circuit breaker: ${name}`);
+        const breaker = this.breakers.get(name);
+        if (breaker) {
+            // Destroy the breaker to clean up its timer and resources
+            breaker.destroy();
+            this.breakers.delete(name);
+            mcpLogger.debug(`[CircuitBreakerManager] Removed and cleaned up circuit breaker: ${name}`);
+            return true;
         }
-        return removed;
+        return false;
     }
     /**
      * Get all circuit breaker names
@@ -333,6 +357,17 @@ export class CircuitBreakerManager {
             unhealthyBreakers,
         };
     }
+    /**
+     * Destroy all circuit breakers and clean up their resources
+     * This should be called during application shutdown to prevent memory leaks
+     */
+    destroyAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.destroy();
+        }
+        this.breakers.clear();
+        mcpLogger.info("[CircuitBreakerManager] Destroyed all circuit breakers");
+    }
 }
 // Global circuit breaker manager instance
 export const globalCircuitBreakerManager = new CircuitBreakerManager();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.14.4",
+  "version": "7.14.6",
   "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",