@juspay/neurolink 8.0.0 → 8.0.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [8.0.1](https://github.com/juspay/neurolink/compare/v8.0.0...v8.0.1) (2025-11-20)
+
+### Bug Fixes
+
+- **(lint):** prettier and lint errors ([810475c](https://github.com/juspay/neurolink/commit/810475ce5bf997e389b4ee2c769cee0c03da7dfb))
+- **(memory):** migrate to cloud-hosted mem0 API [BZ-45257] ([3a53a0c](https://github.com/juspay/neurolink/commit/3a53a0c792102fe5cd232f8b8c0ac59e73581497))
+
 ## [8.0.0](https://github.com/juspay/neurolink/compare/v7.54.0...v8.0.0) (2025-11-19)
 
 ### ⚠ BREAKING CHANGES

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

@@ -1,10 +1,15 @@
 /**
  * Mem0 Memory Initializer
- * Simple initialization logic for mem0ai/oss integration
+ * Simple initialization logic for mem0ai cloud API integration
  */
-import type { MemoryConfig } from "mem0ai/oss";
-import type { Mem0Memory } from "../types/utilities.js";
+import { MemoryClient } from "mem0ai";
 /**
- * Initialize mem0 memory instance with configuration
+ * Mem0 cloud API configuration
  */
-export declare function initializeMem0(mem0Config: MemoryConfig): Promise<Mem0Memory | null>;
+export interface Mem0Config {
+    apiKey: string;
+}
+/**
+ * Initialize mem0 memory instance with cloud API
+ */
+export declare function initializeMem0(mem0Config: Mem0Config): Promise<MemoryClient | null>;

package/dist/lib/memory/mem0Initializer.js

@@ -1,43 +1,32 @@
 /**
  * Mem0 Memory Initializer
- * Simple initialization logic for mem0ai/oss integration
+ * Simple initialization logic for mem0ai cloud API integration
  */
-import { Memory } from "mem0ai/oss";
+import { MemoryClient } from "mem0ai";
 import { logger } from "../utils/logger.js";
 /**
- * Initialize mem0 memory instance with configuration
+ * Initialize mem0 memory instance with cloud API
  */
 export async function initializeMem0(mem0Config) {
-    logger.debug("[mem0Initializer] Starting mem0 initialization");
+    // Guard: skip initialization if API key is missing
+    if (!mem0Config?.apiKey || mem0Config.apiKey.trim() === "") {
+        logger.warn("[mem0Initializer] Missing MEM0_API_KEY; skipping mem0 initialization");
+        return null;
+    }
+    logger.debug("[mem0Initializer] Starting mem0 cloud API initialization");
     try {
-        // Create Memory instance
-        const memory = new Memory(mem0Config);
-        logger.info("[mem0Initializer] Mem0 initialized successfully");
-        return memory;
+        // Create MemoryClient instance with cloud API
+        const client = new MemoryClient({
+            apiKey: mem0Config.apiKey,
+        });
+        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully");
+        return client;
     }
     catch (error) {
-        logger.warn("[mem0Initializer] Failed to initialize mem0, using fallback", {
+        logger.warn("[mem0Initializer] Failed to initialize mem0 cloud API; disabling mem0", {
             error: error instanceof Error ? error.message : String(error),
         });
-        return createFallbackMemory();
+        return null;
     }
 }
-/**
- * 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 () => { },
-    };
-}
 //# sourceMappingURL=mem0Initializer.js.map

package/dist/lib/neurolink.d.ts

@@ -134,6 +134,10 @@ export declare class NeuroLink {
     private initializeHITL;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /** Extract memory context from search results */
+    private extractMemoryContext;
+    /** Store conversation turn in mem0 */
+    private storeConversationTurn;
     /**
      * Set up HITL event forwarding to main emitter
      */

package/dist/lib/neurolink.js

@@ -45,6 +45,7 @@ import { directToolsServer } from "./mcp/servers/agent/directToolsServer.js";
 import { ModelRouter } from "./utils/modelRouter.js";
 import { BinaryTaskClassifier } from "./utils/taskClassifier.js";
 import { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, } from "./services/server/ai/observability/instrumentation.js";
+import { initializeMem0 } from "./memory/mem0Initializer.js";
 export class NeuroLink {
     mcpInitialized = false;
     emitter = new EventEmitter();
@@ -150,8 +151,6 @@ export class NeuroLink {
             this.mem0Instance = null;
             return null;
         }
-        // Import and initialize from separate file
-        const { initializeMem0 } = await import("./memory/mem0Initializer.js");
         if (!this.mem0Config) {
             this.mem0Instance = null;
             return null;
@@ -390,9 +389,28 @@ export class NeuroLink {
     /** Format memory context for prompt inclusion */
     formatMemoryContext(memoryContext, currentInput) {
         return `Context from previous conversations:
-  ${memoryContext}
 
-  Current user's request: ${currentInput}`;
+${memoryContext}
+
+Current user's request: ${currentInput}`;
+    }
+    /** Extract memory context from search results */
+    extractMemoryContext(memories) {
+        return memories
+            .map((m) => m.memory || "")
+            .filter(Boolean)
+            .join("\n");
+    }
+    /** Store conversation turn in mem0 */
+    async storeConversationTurn(mem0, userContent, userId, metadata) {
+        // Store user message only, reducing latency in mem0
+        const conversationTurn = [{ role: "user", content: userContent }];
+        await mem0.add(conversationTurn, {
+            user_id: userId,
+            metadata,
+            infer: true,
+            async_mode: true,
+        });
     }
     /**
      * Set up HITL event forwarding to main emitter
@@ -1191,14 +1209,12 @@ export class NeuroLink {
                     }
                     else {
                         const memories = await mem0.search(options.input.text, {
-                            userId: options.context.userId,
+                            user_id: options.context.userId,
                             limit: 5,
                         });
-                        if (memories?.results?.length > 0) {
+                        if (memories && memories.length > 0) {
                             // Enhance the input with memory context
-                            const memoryContext = memories.results
-                                .map((m) => m.memory)
-                                .join("\n");
+                            const memoryContext = this.extractMemoryContext(memories);
                             options.input.text = this.formatMemoryContext(memoryContext, options.input.text);
                         }
                     }
@@ -1350,20 +1366,11 @@ export class NeuroLink {
                     try {
                         const mem0 = await this.ensureMem0Ready();
                         if (mem0) {
-                            // Store complete conversation turn (user + AI messages)
-                            const conversationTurn = [
-                                { role: "user", content: options.input.text },
-                                { role: "system", content: generateResult.content },
-                            ];
-                            await mem0.add(JSON.stringify(conversationTurn), {
-                                userId: options.context?.userId,
-                                metadata: {
-                                    timestamp: new Date().toISOString(),
-                                    provider: generateResult.provider,
-                                    model: generateResult.model,
-                                    type: "conversation_turn",
-                                    async_mode: true,
-                                },
+                            await this.storeConversationTurn(mem0, originalPrompt, options.context?.userId, {
+                                timestamp: new Date().toISOString(),
+                                provider: generateResult.provider,
+                                model: generateResult.model,
+                                type: "conversation_turn",
                             });
                         }
                     }
@@ -1920,14 +1927,12 @@ export class NeuroLink {
                         }
                         else {
                             const memories = await mem0.search(options.input.text, {
-                                userId: options.context.userId,
+                                user_id: options.context.userId,
                                 limit: 5,
                             });
-                            if (memories?.results?.length > 0) {
+                            if (memories && memories.length > 0) {
                                 // Enhance the input with memory context
-                                const memoryContext = memories.results
-                                    .map((m) => m.memory)
-                                    .join("\n");
+                                const memoryContext = this.extractMemoryContext(memories);
                                 options.input.text = this.formatMemoryContext(memoryContext, options.input.text);
                             }
                         }
@@ -2009,20 +2014,11 @@ export class NeuroLink {
                                 try {
                                     const mem0 = await self.ensureMem0Ready();
                                     if (mem0) {
-                                        // Store complete conversation turn (user + AI messages)
-                                        const conversationTurn = [
-                                            { role: "user", content: originalPrompt },
-                                            { role: "system", content: accumulatedContent.trim() },
-                                        ];
-                                        await mem0.add(JSON.stringify(conversationTurn), {
-                                            userId: enhancedOptions.context?.userId,
-                                            metadata: {
-                                                timestamp: new Date().toISOString(),
-                                                type: "conversation_turn_stream",
-                                                userMessage: originalPrompt,
-                                                async_mode: true,
-                                                aiResponse: accumulatedContent.trim(),
-                                            },
+                                        await self.storeConversationTurn(mem0, originalPrompt, enhancedOptions.context?.userId, {
+                                            timestamp: new Date().toISOString(),
+                                            type: "conversation_turn_stream",
+                                            userMessage: originalPrompt,
+                                            aiResponse: accumulatedContent.trim(),
                                         });
                                     }
                                 }

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

@@ -2,10 +2,7 @@
  * Conversation Memory Types for NeuroLink
  * Provides type-safe conversation storage and context management
  */
-import type { MemoryConfig } from "mem0ai/oss";
-/**
- * Mem0 configuration type matching mem0ai/oss MemoryConfig structure
- */
+import type { Mem0Config } from "../memory/mem0Initializer.js";
 /**
  * Configuration for conversation memory feature
  */
@@ -28,8 +25,8 @@ export type ConversationMemoryConfig = {
     summarizationModel?: string;
     /** Enable mem0 integration for conversation memory */
     mem0Enabled?: boolean;
-    /** Configuration for mem0 integration */
-    mem0Config?: MemoryConfig;
+    /** Configuration for mem0 cloud API integration */
+    mem0Config?: Mem0Config;
     /** Redis configuration (optional) - overrides environment variables */
     redisConfig?: RedisStorageConfig;
 };

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

@@ -171,38 +171,3 @@ export type EnvVarValidationResult = {
     invalidVars: string[];
     warnings: string[];
 };
-/**
- * Interface for mem0 Memory instance methods based on actual mem0ai/oss API
- */
-export type 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>;
-};

package/dist/memory/mem0Initializer.d.ts

@@ -1,10 +1,15 @@
 /**
  * Mem0 Memory Initializer
- * Simple initialization logic for mem0ai/oss integration
+ * Simple initialization logic for mem0ai cloud API integration
  */
-import type { MemoryConfig } from "mem0ai/oss";
-import type { Mem0Memory } from "../types/utilities.js";
+import { MemoryClient } from "mem0ai";
 /**
- * Initialize mem0 memory instance with configuration
+ * Mem0 cloud API configuration
  */
-export declare function initializeMem0(mem0Config: MemoryConfig): Promise<Mem0Memory | null>;
+export interface Mem0Config {
+    apiKey: string;
+}
+/**
+ * Initialize mem0 memory instance with cloud API
+ */
+export declare function initializeMem0(mem0Config: Mem0Config): Promise<MemoryClient | null>;

package/dist/memory/mem0Initializer.js

@@ -1,42 +1,31 @@
 /**
  * Mem0 Memory Initializer
- * Simple initialization logic for mem0ai/oss integration
+ * Simple initialization logic for mem0ai cloud API integration
  */
-import { Memory } from "mem0ai/oss";
+import { MemoryClient } from "mem0ai";
 import { logger } from "../utils/logger.js";
 /**
- * Initialize mem0 memory instance with configuration
+ * Initialize mem0 memory instance with cloud API
  */
 export async function initializeMem0(mem0Config) {
-    logger.debug("[mem0Initializer] Starting mem0 initialization");
+    // Guard: skip initialization if API key is missing
+    if (!mem0Config?.apiKey || mem0Config.apiKey.trim() === "") {
+        logger.warn("[mem0Initializer] Missing MEM0_API_KEY; skipping mem0 initialization");
+        return null;
+    }
+    logger.debug("[mem0Initializer] Starting mem0 cloud API initialization");
     try {
-        // Create Memory instance
-        const memory = new Memory(mem0Config);
-        logger.info("[mem0Initializer] Mem0 initialized successfully");
-        return memory;
+        // Create MemoryClient instance with cloud API
+        const client = new MemoryClient({
+            apiKey: mem0Config.apiKey,
+        });
+        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully");
+        return client;
     }
     catch (error) {
-        logger.warn("[mem0Initializer] Failed to initialize mem0, using fallback", {
+        logger.warn("[mem0Initializer] Failed to initialize mem0 cloud API; disabling mem0", {
             error: error instanceof Error ? error.message : String(error),
         });
-        return createFallbackMemory();
+        return null;
     }
 }
-/**
- * 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/neurolink.d.ts

@@ -134,6 +134,10 @@ export declare class NeuroLink {
     private initializeHITL;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /** Extract memory context from search results */
+    private extractMemoryContext;
+    /** Store conversation turn in mem0 */
+    private storeConversationTurn;
     /**
      * Set up HITL event forwarding to main emitter
      */

package/dist/neurolink.js

@@ -45,6 +45,7 @@ import { directToolsServer } from "./mcp/servers/agent/directToolsServer.js";
 import { ModelRouter } from "./utils/modelRouter.js";
 import { BinaryTaskClassifier } from "./utils/taskClassifier.js";
 import { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, } from "./services/server/ai/observability/instrumentation.js";
+import { initializeMem0 } from "./memory/mem0Initializer.js";
 export class NeuroLink {
     mcpInitialized = false;
     emitter = new EventEmitter();
@@ -150,8 +151,6 @@ export class NeuroLink {
             this.mem0Instance = null;
             return null;
         }
-        // Import and initialize from separate file
-        const { initializeMem0 } = await import("./memory/mem0Initializer.js");
         if (!this.mem0Config) {
             this.mem0Instance = null;
             return null;
@@ -390,9 +389,28 @@ export class NeuroLink {
     /** Format memory context for prompt inclusion */
     formatMemoryContext(memoryContext, currentInput) {
         return `Context from previous conversations:
-  ${memoryContext}
 
-  Current user's request: ${currentInput}`;
+${memoryContext}
+
+Current user's request: ${currentInput}`;
+    }
+    /** Extract memory context from search results */
+    extractMemoryContext(memories) {
+        return memories
+            .map((m) => m.memory || "")
+            .filter(Boolean)
+            .join("\n");
+    }
+    /** Store conversation turn in mem0 */
+    async storeConversationTurn(mem0, userContent, userId, metadata) {
+        // Store user message only, reducing latency in mem0
+        const conversationTurn = [{ role: "user", content: userContent }];
+        await mem0.add(conversationTurn, {
+            user_id: userId,
+            metadata,
+            infer: true,
+            async_mode: true,
+        });
     }
     /**
      * Set up HITL event forwarding to main emitter
@@ -1191,14 +1209,12 @@ export class NeuroLink {
                     }
                     else {
                         const memories = await mem0.search(options.input.text, {
-                            userId: options.context.userId,
+                            user_id: options.context.userId,
                             limit: 5,
                         });
-                        if (memories?.results?.length > 0) {
+                        if (memories && memories.length > 0) {
                             // Enhance the input with memory context
-                            const memoryContext = memories.results
-                                .map((m) => m.memory)
-                                .join("\n");
+                            const memoryContext = this.extractMemoryContext(memories);
                             options.input.text = this.formatMemoryContext(memoryContext, options.input.text);
                         }
                     }
@@ -1350,20 +1366,11 @@ export class NeuroLink {
                     try {
                         const mem0 = await this.ensureMem0Ready();
                         if (mem0) {
-                            // Store complete conversation turn (user + AI messages)
-                            const conversationTurn = [
-                                { role: "user", content: options.input.text },
-                                { role: "system", content: generateResult.content },
-                            ];
-                            await mem0.add(JSON.stringify(conversationTurn), {
-                                userId: options.context?.userId,
-                                metadata: {
-                                    timestamp: new Date().toISOString(),
-                                    provider: generateResult.provider,
-                                    model: generateResult.model,
-                                    type: "conversation_turn",
-                                    async_mode: true,
-                                },
+                            await this.storeConversationTurn(mem0, originalPrompt, options.context?.userId, {
+                                timestamp: new Date().toISOString(),
+                                provider: generateResult.provider,
+                                model: generateResult.model,
+                                type: "conversation_turn",
                             });
                         }
                     }
@@ -1920,14 +1927,12 @@ export class NeuroLink {
                         }
                         else {
                             const memories = await mem0.search(options.input.text, {
-                                userId: options.context.userId,
+                                user_id: options.context.userId,
                                 limit: 5,
                             });
-                            if (memories?.results?.length > 0) {
+                            if (memories && memories.length > 0) {
                                 // Enhance the input with memory context
-                                const memoryContext = memories.results
-                                    .map((m) => m.memory)
-                                    .join("\n");
+                                const memoryContext = this.extractMemoryContext(memories);
                                 options.input.text = this.formatMemoryContext(memoryContext, options.input.text);
                             }
                         }
@@ -2009,20 +2014,11 @@ export class NeuroLink {
                                 try {
                                     const mem0 = await self.ensureMem0Ready();
                                     if (mem0) {
-                                        // Store complete conversation turn (user + AI messages)
-                                        const conversationTurn = [
-                                            { role: "user", content: originalPrompt },
-                                            { role: "system", content: accumulatedContent.trim() },
-                                        ];
-                                        await mem0.add(JSON.stringify(conversationTurn), {
-                                            userId: enhancedOptions.context?.userId,
-                                            metadata: {
-                                                timestamp: new Date().toISOString(),
-                                                type: "conversation_turn_stream",
-                                                userMessage: originalPrompt,
-                                                async_mode: true,
-                                                aiResponse: accumulatedContent.trim(),
-                                            },
+                                        await self.storeConversationTurn(mem0, originalPrompt, enhancedOptions.context?.userId, {
+                                            timestamp: new Date().toISOString(),
+                                            type: "conversation_turn_stream",
+                                            userMessage: originalPrompt,
+                                            aiResponse: accumulatedContent.trim(),
                                         });
                                     }
                                 }

package/dist/types/conversation.d.ts

@@ -2,10 +2,7 @@
  * Conversation Memory Types for NeuroLink
  * Provides type-safe conversation storage and context management
  */
-import type { MemoryConfig } from "mem0ai/oss";
-/**
- * Mem0 configuration type matching mem0ai/oss MemoryConfig structure
- */
+import type { Mem0Config } from "../memory/mem0Initializer.js";
 /**
  * Configuration for conversation memory feature
  */
@@ -28,8 +25,8 @@ export type ConversationMemoryConfig = {
     summarizationModel?: string;
     /** Enable mem0 integration for conversation memory */
     mem0Enabled?: boolean;
-    /** Configuration for mem0 integration */
-    mem0Config?: MemoryConfig;
+    /** Configuration for mem0 cloud API integration */
+    mem0Config?: Mem0Config;
     /** Redis configuration (optional) - overrides environment variables */
     redisConfig?: RedisStorageConfig;
 };

package/dist/types/utilities.d.ts

@@ -171,38 +171,3 @@ export type EnvVarValidationResult = {
     invalidVars: string[];
     warnings: string[];
 };
-/**
- * Interface for mem0 Memory instance methods based on actual mem0ai/oss API
- */
-export type 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>;
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "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",
@@ -293,7 +293,8 @@
       "cookie@<0.7.0": ">=0.7.0",
       "@eslint/plugin-kit@<0.3.4": ">=0.3.4",
       "tmp@<=0.2.3": ">=0.2.4",
-      "axios@<1.8.2": ">=1.8.2"
+      "axios@<1.8.2": ">=1.8.2",
+      "glob@>=10.3.7 <=11.0.3": ">=11.1.0"
     }
   },
   "os": [