@juspay/neurolink 7.43.0 → 7.45.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [7.45.0](https://github.com/juspay/neurolink/compare/v7.44.0...v7.45.0) (2025-09-24)
+
+### Features
+
+- **(provider):** Add support to provide region while streaming or generating for few providers ([a0a5bed](https://github.com/juspay/neurolink/commit/a0a5bed2bba4118dde149713708e36d4d29e1aae))
+
+## [7.44.0](https://github.com/juspay/neurolink/compare/v7.43.0...v7.44.0) (2025-09-24)
+
+### Features
+
+- **(sdk):** Integrate mem0 for better context ([78edf08](https://github.com/juspay/neurolink/commit/78edf08467432988c968eb06f510f0198b253665))
+
 ## [7.43.0](https://github.com/juspay/neurolink/compare/v7.42.0...v7.43.0) (2025-09-23)
 
 ### Features
@@ -851,21 +863,18 @@ Co-authored-by: sachin.sharma <sachin.sharma@juspay.in>
 ### 🎯 Major Feature: Dynamic Model Configuration System
 
 - **⚡ Revolutionary Model Management**: Introduced dynamic model configuration system replacing static enums
-
   - **Self-Updating Models**: New models automatically available without code updates
   - **Cost Optimization**: Automatic selection of cheapest models for tasks
   - **Smart Resolution**: Fuzzy matching, aliases, and capability-based search
   - **Multi-Source Loading**: Configuration from API → GitHub → local with fallback
 
 - **💰 Cost Intelligence**: Built-in cost optimization and model selection algorithms
-
   - **Current Leader**: Gemini 2.0 Flash at $0.000075/1K input tokens
   - **Capability Mapping**: Find models by features (functionCalling, vision, code-execution)
   - **Real-Time Pricing**: Always current model costs and performance data
   - **Budget Controls**: Maximum price filtering and cost-aware selection
 
 - **🔧 Production-Ready Infrastructure**: Complete system with validation and monitoring
-
   - **Model Configuration Server**: REST API with search capabilities (`scripts/model-server.js`)
   - **Zod Schema Validation**: Type-safe runtime configuration validation
   - **Comprehensive Testing**: Full test suite for all dynamic model functionality
@@ -917,19 +926,16 @@ Co-authored-by: sachin.sharma <sachin.sharma@juspay.in>
 ### Bug Fixes - MCP System Restoration
 
 - **🔧 Fixed Built-in Tool Loading**: Resolved critical circular dependency issues preventing default tools from loading
-
   - **Root Cause**: Circular dependency between `config.ts` and `unified-registry.ts` preventing proper initialization
   - **Solution**: Implemented dynamic imports and restructured initialization chain
   - **Result**: Built-in tools restored from 0 → 3 tools (100% recovery rate)
 
 - **⏰ Fixed Time Tool Functionality**: Time tool now properly available and returns accurate real-time data
-
   - Fixed tool registration and execution pathway
   - Proper timezone handling and formatting
   - Verified accuracy against system time
 
 - **🔍 Enhanced External Tool Discovery**: 58+ external MCP tools now discoverable via comprehensive auto-discovery
-
   - Auto-discovery across VS Code, Claude Desktop, Cursor, Windsurf
   - Proper placeholder system for lazy activation
   - Unified registry integration
@@ -984,7 +990,6 @@ Co-authored-by: sachin.sharma <sachin.sharma@juspay.in>
 ### Features
 
 - **🛠️ Enhanced CLI with Ollama Commands**: New Ollama-specific management commands
-
   - `neurolink ollama list-models` - List installed local models
   - `neurolink ollama pull <model>` - Download models locally
   - `neurolink ollama remove <model>` - Remove installed models
@@ -1065,14 +1070,12 @@ neurolink generate-text "test" --debug
 ### Patch Changes
 
 - **🔧 Production-Ready CLI Logging System**: Fixed critical logging system for clean production output
-
   - **Issue**: CLI showed excessive debug output during normal operation, breaking demo presentations
   - **Root Cause**: Mixed console.log statements bypassed conditional logger system
   - **Solution**: Systematic replacement of all console.log with logger.debug across codebase
   - **Impact**: **Clean CLI output by default** with conditional debug available via `NEUROLINK_DEBUG=true`
 
 - **🔄 Enhanced Provider Fallback Logic**: Fixed incomplete provider fallback coverage
-
   - **Issue**: Provider fallback only attempted 4 of 6 providers (missing Anthropic & Azure)
   - **Root Cause**: Incomplete provider array in NeuroLink class fallback logic
   - **Solution**: Updated to include all 6 providers: `['openai', 'vertex', 'bedrock', 'anthropic', 'azure', 'google-ai']`
@@ -1116,7 +1119,6 @@ NEUROLINK_DEBUG=true node dist/cli/cli/index.js generate-text "test" --max-token
 ### Patch Changes
 
 - **🔧 Critical CLI Dependency Fix**: Removed peer dependencies to ensure zero-friction CLI usage
-
   - **Issue**: CLI commands failed when provider-specific SDK packages were peer dependencies
   - **Root Cause**: `npx` doesn't install peer dependencies, causing missing module errors
   - **Solution**: Moved ALL AI provider SDKs to regular dependencies

package/dist/cli/loop/optionsSchema.d.ts

@@ -12,4 +12,4 @@ export interface OptionSchema {
  * This object provides metadata for validation and help text in the CLI loop.
  * It is derived from the main TextGenerationOptions interface to ensure consistency.
  */
-export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria">, OptionSchema>;
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region">, OptionSchema>;

package/dist/core/factory.d.ts

@@ -19,9 +19,11 @@ export declare class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value

package/dist/core/factory.js

@@ -52,9 +52,11 @@ export class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static async createProvider(providerName, modelName, enableMCP = true, sdk) {
+    static async createProvider(providerName, modelName, enableMCP = true, sdk, region) {
         const functionTag = "AIProviderFactory.createProvider";
         // Providers are registered via ProviderFactory.initialize() on first use
         logger.debug(`[${functionTag}] Provider creation started`, {
@@ -198,8 +200,8 @@ export class AIProviderFactory {
                 resolvedModelName: resolvedModelName || "not resolved",
                 finalModelName: finalModelName || "using provider default",
             });
-            // Create provider with enhanced SDK
-            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk);
+            // Create provider with enhanced SDK and region support
+            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk, region);
             // Summary logging in format expected by debugging tools
             logger.debug(`[AIProviderFactory] Provider creation completed { providerName: '${normalizedName}', modelName: '${finalModelName}' }`);
             logger.debug(`[AIProviderFactory] Resolved model: ${finalModelName}`);

package/dist/factories/providerFactory.d.ts

@@ -4,8 +4,8 @@ import type { UnknownRecord } from "../types/common.js";
  * Provider constructor interface - supports both sync constructors and async factory functions
  */
 type ProviderConstructor = {
-    new (modelName?: string, providerName?: string, sdk?: UnknownRecord): AIProvider;
-} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord) => Promise<AIProvider>);
+    new (modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string): AIProvider;
+} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string) => Promise<AIProvider>);
 /**
  * Provider registration entry
  */
@@ -30,7 +30,7 @@ export declare class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Check if a provider is registered
      */

package/dist/factories/providerFactory.js

@@ -28,7 +28,7 @@ export class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static async createProvider(providerName, modelName, sdk) {
+    static async createProvider(providerName, modelName, sdk, region) {
         // Note: Providers are registered explicitly by ProviderRegistry to avoid circular dependencies
         const normalizedName = providerName.toLowerCase();
         const registration = this.providers.get(normalizedName);
@@ -54,7 +54,7 @@ export class ProviderFactory {
             }
             let result;
             try {
-                const factoryResult = registration.constructor(model, providerName, sdk);
+                const factoryResult = registration.constructor(model, providerName, sdk, region);
                 // Handle both sync and async results
                 result =
                     factoryResult instanceof Promise
@@ -66,7 +66,7 @@ export class ProviderFactory {
                     registration.constructor.prototype.constructor ===
                         registration.constructor) {
                     try {
-                        result = new registration.constructor(model, providerName, sdk);
+                        result = new registration.constructor(model, providerName, sdk, region);
                     }
                     catch (constructorError) {
                         throw new Error(`Both factory function and constructor failed. Factory error: ${factoryError}. Constructor error: ${constructorError}`);

package/dist/factories/providerRegistry.js

@@ -39,9 +39,9 @@ export class ProviderRegistry {
                 return new AnthropicProvider(modelName, sdk);
             }, "claude-3-5-sonnet-20241022", ["claude", "anthropic"]);
             // Register Amazon Bedrock provider
-            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk, region) => {
                 const { AmazonBedrockProvider } = await import("../providers/amazonBedrock.js");
-                return new AmazonBedrockProvider(modelName, sdk);
+                return new AmazonBedrockProvider(modelName, sdk, region);
             }, undefined, // Let provider read BEDROCK_MODEL from .env
             ["bedrock", "aws"]);
             // Register Azure OpenAI provider
@@ -54,9 +54,9 @@ export class ProviderRegistry {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
-            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk, region) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");
-                return new GoogleVertexProvider(modelName, providerName, sdk);
+                return new GoogleVertexProvider(modelName, providerName, sdk, region);
             }, "claude-sonnet-4@20250514", ["vertex", "googleVertex"]);
             // Register Hugging Face provider (Unified Router implementation)
             ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName) => {
@@ -85,9 +85,9 @@ export class ProviderRegistry {
             }, process.env.OPENAI_COMPATIBLE_MODEL || undefined, // Enable auto-discovery when no model specified
             ["openai-compatible", "openrouter", "vllm", "compatible"]);
             // Register Amazon SageMaker provider
-            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk, region) => {
                 const { AmazonSageMakerProvider } = await import("../providers/amazonSagemaker.js");
-                return new AmazonSageMakerProvider(modelName);
+                return new AmazonSageMakerProvider(modelName, region);
             }, process.env.SAGEMAKER_MODEL || "sagemaker-model", ["sagemaker", "aws-sagemaker"]);
             logger.debug("All providers registered successfully");
             this.registered = true;

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

@@ -19,9 +19,11 @@ export declare class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value

package/dist/lib/core/factory.js

@@ -52,9 +52,11 @@ export class AIProviderFactory {
      * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
      * @param modelName - Optional model name override
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
+     * @param sdk - SDK instance
+     * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static async createProvider(providerName, modelName, enableMCP = true, sdk) {
+    static async createProvider(providerName, modelName, enableMCP = true, sdk, region) {
         const functionTag = "AIProviderFactory.createProvider";
         // Providers are registered via ProviderFactory.initialize() on first use
         logger.debug(`[${functionTag}] Provider creation started`, {
@@ -198,8 +200,8 @@ export class AIProviderFactory {
                 resolvedModelName: resolvedModelName || "not resolved",
                 finalModelName: finalModelName || "using provider default",
             });
-            // Create provider with enhanced SDK
-            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk);
+            // Create provider with enhanced SDK and region support
+            const provider = await ProviderFactory.createProvider(normalizedName, finalModelName, sdk, region);
             // Summary logging in format expected by debugging tools
             logger.debug(`[AIProviderFactory] Provider creation completed { providerName: '${normalizedName}', modelName: '${finalModelName}' }`);
             logger.debug(`[AIProviderFactory] Resolved model: ${finalModelName}`);

package/dist/lib/factories/providerFactory.d.ts

@@ -4,8 +4,8 @@ import type { UnknownRecord } from "../types/common.js";
  * Provider constructor interface - supports both sync constructors and async factory functions
  */
 type ProviderConstructor = {
-    new (modelName?: string, providerName?: string, sdk?: UnknownRecord): AIProvider;
-} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord) => Promise<AIProvider>);
+    new (modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string): AIProvider;
+} | ((modelName?: string, providerName?: string, sdk?: UnknownRecord, region?: string) => Promise<AIProvider>);
 /**
  * Provider registration entry
  */
@@ -30,7 +30,7 @@ export declare class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createProvider(providerName: AIProviderName | string, modelName?: string, sdk?: UnknownRecord, region?: string): Promise<AIProvider>;
     /**
      * Check if a provider is registered
      */

package/dist/lib/factories/providerFactory.js

@@ -28,7 +28,7 @@ export class ProviderFactory {
     /**
      * Create a provider instance
      */
-    static async createProvider(providerName, modelName, sdk) {
+    static async createProvider(providerName, modelName, sdk, region) {
         // Note: Providers are registered explicitly by ProviderRegistry to avoid circular dependencies
         const normalizedName = providerName.toLowerCase();
         const registration = this.providers.get(normalizedName);
@@ -54,7 +54,7 @@ export class ProviderFactory {
             }
             let result;
             try {
-                const factoryResult = registration.constructor(model, providerName, sdk);
+                const factoryResult = registration.constructor(model, providerName, sdk, region);
                 // Handle both sync and async results
                 result =
                     factoryResult instanceof Promise
@@ -66,7 +66,7 @@ export class ProviderFactory {
                     registration.constructor.prototype.constructor ===
                         registration.constructor) {
                     try {
-                        result = new registration.constructor(model, providerName, sdk);
+                        result = new registration.constructor(model, providerName, sdk, region);
                     }
                     catch (constructorError) {
                         throw new Error(`Both factory function and constructor failed. Factory error: ${factoryError}. Constructor error: ${constructorError}`);

package/dist/lib/factories/providerRegistry.js

@@ -39,9 +39,9 @@ export class ProviderRegistry {
                 return new AnthropicProvider(modelName, sdk);
             }, "claude-3-5-sonnet-20241022", ["claude", "anthropic"]);
             // Register Amazon Bedrock provider
-            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.BEDROCK, async (modelName, _providerName, sdk, region) => {
                 const { AmazonBedrockProvider } = await import("../providers/amazonBedrock.js");
-                return new AmazonBedrockProvider(modelName, sdk);
+                return new AmazonBedrockProvider(modelName, sdk, region);
             }, undefined, // Let provider read BEDROCK_MODEL from .env
             ["bedrock", "aws"]);
             // Register Azure OpenAI provider
@@ -54,9 +54,9 @@ export class ProviderRegistry {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
-            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName, providerName, sdk, region) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");
-                return new GoogleVertexProvider(modelName, providerName, sdk);
+                return new GoogleVertexProvider(modelName, providerName, sdk, region);
             }, "claude-sonnet-4@20250514", ["vertex", "googleVertex"]);
             // Register Hugging Face provider (Unified Router implementation)
             ProviderFactory.registerProvider(AIProviderName.HUGGINGFACE, async (modelName) => {
@@ -85,9 +85,9 @@ export class ProviderRegistry {
             }, process.env.OPENAI_COMPATIBLE_MODEL || undefined, // Enable auto-discovery when no model specified
             ["openai-compatible", "openrouter", "vllm", "compatible"]);
             // Register Amazon SageMaker provider
-            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk) => {
+            ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk, region) => {
                 const { AmazonSageMakerProvider } = await import("../providers/amazonSagemaker.js");
-                return new AmazonSageMakerProvider(modelName);
+                return new AmazonSageMakerProvider(modelName, region);
             }, process.env.SAGEMAKER_MODEL || "sagemaker-model", ["sagemaker", "aws-sagemaker"]);
             logger.debug("All providers registered successfully");
             this.registered = true;

package/dist/lib/memory/mem0Initializer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mem0 Memory Initializer
+ * Simple initialization logic for mem0ai/oss integration
+ */
+import type { MemoryConfig } from "mem0ai/oss";
+/**
+ * Interface for mem0 Memory instance methods based on actual mem0ai/oss API
+ */
+export interface Mem0Memory {
+    search(query: string, config: {
+        userId?: string;
+        limit?: number;
+    }): Promise<{
+        results: Array<{
+            memory: string;
+            id: string;
+        }>;
+    }>;
+    add(messages: string, config: {
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        results: Array<{
+            id: string;
+            memory: string;
+        }>;
+    }>;
+    get(memoryId: string): Promise<{
+        id: string;
+        memory: string;
+    } | null>;
+    update(memoryId: string, data: string): Promise<{
+        message: string;
+    }>;
+    delete(memoryId: string): Promise<{
+        message: string;
+    }>;
+    history(memoryId: string): Promise<unknown[]>;
+    reset(): Promise<void>;
+}
+/**
+ * Initialize mem0 memory instance with configuration
+ */
+export declare function initializeMem0(mem0Config: MemoryConfig): Promise<Mem0Memory | null>;

package/dist/lib/memory/mem0Initializer.js

@@ -0,0 +1,42 @@
+/**
+ * Mem0 Memory Initializer
+ * Simple initialization logic for mem0ai/oss integration
+ */
+import { Memory } from "mem0ai/oss";
+import { logger } from "../utils/logger.js";
+/**
+ * Initialize mem0 memory instance with configuration
+ */
+export async function initializeMem0(mem0Config) {
+    logger.debug("[mem0Initializer] Starting mem0 initialization");
+    try {
+        // Create Memory instance
+        const memory = new Memory(mem0Config);
+        logger.info("[mem0Initializer] Mem0 initialized successfully");
+        return memory;
+    }
+    catch (error) {
+        logger.warn("[mem0Initializer] Failed to initialize mem0, using fallback", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return createFallbackMemory();
+    }
+}
+/**
+ * Create fallback memory implementation
+ */
+function createFallbackMemory() {
+    return {
+        search: async () => ({ results: [] }),
+        add: async () => ({ results: [] }),
+        get: async () => null,
+        update: async () => ({
+            message: "Fallback memory does not support updates",
+        }),
+        delete: async () => ({
+            message: "Fallback memory does not support deletion",
+        }),
+        history: async () => [],
+        reset: async () => { },
+    };
+}

package/dist/lib/neurolink.d.ts

@@ -70,6 +70,16 @@ export declare class NeuroLink {
     private conversationMemoryConfig?;
     private enableOrchestration;
     private hitlManager?;
+    private mem0Instance?;
+    private mem0Config?;
+    /**
+     * Simple sync config setup for mem0
+     */
+    private initializeMem0Config;
+    /**
+     * Async initialization called during generate/stream
+     */
+    private ensureMem0Ready;
     /**
      * Context storage for tool execution
      * This context will be merged with any runtime context passed by the AI model
@@ -142,6 +152,8 @@ export declare class NeuroLink {
      * Initialize HITL (Human-in-the-Loop) if enabled
      */
     private initializeHITL;
+    /** Format memory context for prompt inclusion */
+    private formatMemoryContext;
     /**
      * Set up HITL event forwarding to main emitter
      */