@juspay/neurolink 8.4.0 → 8.4.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.4.1](https://github.com/juspay/neurolink/compare/v8.4.0...v8.4.1) (2025-12-04)
+
+### Bug Fixes
+
+- **(mem0):** custom instructions support for mem0 conversation ingestion ([486c55c](https://github.com/juspay/neurolink/commit/486c55c64eeaecf6704aea7a7bf5310270476be5))
+
 ## [8.4.0](https://github.com/juspay/neurolink/compare/v8.3.0...v8.4.0) (2025-12-01)
 
 ### Features

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

@@ -8,8 +8,39 @@ import { MemoryClient } from "mem0ai";
  */
 export interface Mem0Config {
     apiKey: string;
+    /**
+     * Optional organization ID - if not provided, will be auto-populated from ping() response
+     */
+    organizationId?: string;
+    /**
+     * Optional project ID - if not provided, will be auto-populated from ping() response
+     */
+    projectId?: string;
+    /**
+     * Whether to update project-level custom instructions during initialization
+     * Default: false (don't update project settings)
+     *
+     * Note: organizationId and projectId are NOT required - they will be auto-populated
+     * from the mem0 API via ping() if not provided
+     */
+    updateProjectSettings?: boolean;
+    /**
+     * Custom instructions and categories for mem0 extraction behavior
+     * Only used if updateProjectSettings is true
+     */
+    customPrompts?: {
+        /**
+         * Custom instructions for how mem0 should extract and store memories
+         * This applies to ALL memories added to the project
+         */
+        custom_instructions?: string;
+        /**
+         * Custom categories for organizing memories
+         */
+        custom_categories?: Array<Record<string, unknown>>;
+    };
 }
 /**
- * Initialize mem0 memory instance with cloud API
+ * Initialize mem0 memory instance with cloud API and optional project settings
  */
 export declare function initializeMem0(mem0Config: Mem0Config): Promise<MemoryClient | null>;

package/dist/lib/memory/mem0Initializer.js

@@ -5,7 +5,7 @@
 import { MemoryClient } from "mem0ai";
 import { logger } from "../utils/logger.js";
 /**
- * Initialize mem0 memory instance with cloud API
+ * Initialize mem0 memory instance with cloud API and optional project settings
  */
 export async function initializeMem0(mem0Config) {
     // Guard: skip initialization if API key is missing
@@ -18,8 +18,61 @@ export async function initializeMem0(mem0Config) {
         // Create MemoryClient instance with cloud API
         const client = new MemoryClient({
             apiKey: mem0Config.apiKey,
+            organizationId: mem0Config.organizationId,
+            projectId: mem0Config.projectId,
+        });
+        // Track whether project settings were actually updated (not just requested)
+        let projectSettingsUpdated = false;
+        // Update project-level settings if requested
+        if (mem0Config.updateProjectSettings && mem0Config.customPrompts) {
+            // Build update payload - only include fields that are actually provided
+            const updatePayload = {};
+            if (mem0Config.customPrompts.custom_instructions &&
+                mem0Config.customPrompts.custom_instructions.trim() !== "") {
+                updatePayload.custom_instructions =
+                    mem0Config.customPrompts.custom_instructions;
+            }
+            if (Array.isArray(mem0Config.customPrompts.custom_categories) &&
+                mem0Config.customPrompts.custom_categories.length > 0) {
+                updatePayload.custom_categories =
+                    mem0Config.customPrompts.custom_categories;
+            }
+            // Only proceed if there's something to update
+            if (Object.keys(updatePayload).length > 0) {
+                try {
+                    // Note: updateProject() internally calls ping() first, which auto-populates
+                    // organizationId and projectId from the server, so they're not required
+                    await client.updateProject(updatePayload);
+                    projectSettingsUpdated = true; // Only set to true on successful update
+                    logger.info("[mem0Initializer] Project settings updated successfully", {
+                        hasInstructions: !!updatePayload.custom_instructions,
+                        hasCategories: !!updatePayload.custom_categories,
+                        // Note: These IDs are auto-populated by ping() inside updateProject()
+                        organizationId: client.organizationId,
+                        projectId: client.projectId,
+                    });
+                }
+                catch (error) {
+                    logger.warn("[mem0Initializer] Failed to update project settings", {
+                        error: error instanceof Error ? error.message : String(error),
+                        hint: "Ensure your MEM0_API_KEY has permission to update project settings",
+                    });
+                    // Continue initialization even if project update fails
+                    // projectSettingsUpdated remains false
+                }
+            }
+            else {
+                logger.warn("[mem0Initializer] updateProjectSettings=true but no custom instructions or categories provided - nothing to update");
+            }
+        }
+        else if (mem0Config.updateProjectSettings && !mem0Config.customPrompts) {
+            logger.warn("[mem0Initializer] updateProjectSettings=true but customPrompts not provided - nothing to update");
+        }
+        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully", {
+            hasOrgId: !!client.organizationId,
+            hasProjectId: !!client.projectId,
+            projectSettingsUpdated,
         });
-        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully");
         return client;
     }
     catch (error) {

package/dist/lib/neurolink.d.ts

@@ -137,7 +137,7 @@ export declare class NeuroLink {
     /** Extract memory context from search results */
     private extractMemoryContext;
     /** Store conversation turn in mem0 */
-    private storeConversationTurn;
+    private storeMem0ConversationTurn;
     /**
      * Set up HITL event forwarding to main emitter
      */

package/dist/lib/neurolink.js

@@ -402,9 +402,12 @@ Current user's request: ${currentInput}`;
             .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 }];
+    async storeMem0ConversationTurn(mem0, userContent, aiResponse, userId, metadata) {
+        // Store both user message and AI response for better context extraction
+        const conversationTurn = [
+            { role: "user", content: userContent },
+            { role: "assistant", content: aiResponse },
+        ];
         await mem0.add(conversationTurn, {
             user_id: userId,
             metadata,
@@ -1366,7 +1369,7 @@ Current user's request: ${currentInput}`;
                     try {
                         const mem0 = await this.ensureMem0Ready();
                         if (mem0) {
-                            await this.storeConversationTurn(mem0, originalPrompt, options.context?.userId, {
+                            await this.storeMem0ConversationTurn(mem0, originalPrompt, generateResult.content, options.context?.userId, {
                                 timestamp: new Date().toISOString(),
                                 provider: generateResult.provider,
                                 model: generateResult.model,
@@ -2037,11 +2040,9 @@ Current user's request: ${currentInput}`;
                                 try {
                                     const mem0 = await self.ensureMem0Ready();
                                     if (mem0) {
-                                        await self.storeConversationTurn(mem0, originalPrompt, enhancedOptions.context?.userId, {
+                                        await self.storeMem0ConversationTurn(mem0, originalPrompt, accumulatedContent.trim(), enhancedOptions.context?.userId, {
                                             timestamp: new Date().toISOString(),
                                             type: "conversation_turn_stream",
-                                            userMessage: originalPrompt,
-                                            aiResponse: accumulatedContent.trim(),
                                         });
                                     }
                                 }

package/dist/memory/mem0Initializer.d.ts

@@ -8,8 +8,39 @@ import { MemoryClient } from "mem0ai";
  */
 export interface Mem0Config {
     apiKey: string;
+    /**
+     * Optional organization ID - if not provided, will be auto-populated from ping() response
+     */
+    organizationId?: string;
+    /**
+     * Optional project ID - if not provided, will be auto-populated from ping() response
+     */
+    projectId?: string;
+    /**
+     * Whether to update project-level custom instructions during initialization
+     * Default: false (don't update project settings)
+     *
+     * Note: organizationId and projectId are NOT required - they will be auto-populated
+     * from the mem0 API via ping() if not provided
+     */
+    updateProjectSettings?: boolean;
+    /**
+     * Custom instructions and categories for mem0 extraction behavior
+     * Only used if updateProjectSettings is true
+     */
+    customPrompts?: {
+        /**
+         * Custom instructions for how mem0 should extract and store memories
+         * This applies to ALL memories added to the project
+         */
+        custom_instructions?: string;
+        /**
+         * Custom categories for organizing memories
+         */
+        custom_categories?: Array<Record<string, unknown>>;
+    };
 }
 /**
- * Initialize mem0 memory instance with cloud API
+ * Initialize mem0 memory instance with cloud API and optional project settings
  */
 export declare function initializeMem0(mem0Config: Mem0Config): Promise<MemoryClient | null>;

package/dist/memory/mem0Initializer.js

@@ -5,7 +5,7 @@
 import { MemoryClient } from "mem0ai";
 import { logger } from "../utils/logger.js";
 /**
- * Initialize mem0 memory instance with cloud API
+ * Initialize mem0 memory instance with cloud API and optional project settings
  */
 export async function initializeMem0(mem0Config) {
     // Guard: skip initialization if API key is missing
@@ -18,8 +18,61 @@ export async function initializeMem0(mem0Config) {
         // Create MemoryClient instance with cloud API
         const client = new MemoryClient({
             apiKey: mem0Config.apiKey,
+            organizationId: mem0Config.organizationId,
+            projectId: mem0Config.projectId,
+        });
+        // Track whether project settings were actually updated (not just requested)
+        let projectSettingsUpdated = false;
+        // Update project-level settings if requested
+        if (mem0Config.updateProjectSettings && mem0Config.customPrompts) {
+            // Build update payload - only include fields that are actually provided
+            const updatePayload = {};
+            if (mem0Config.customPrompts.custom_instructions &&
+                mem0Config.customPrompts.custom_instructions.trim() !== "") {
+                updatePayload.custom_instructions =
+                    mem0Config.customPrompts.custom_instructions;
+            }
+            if (Array.isArray(mem0Config.customPrompts.custom_categories) &&
+                mem0Config.customPrompts.custom_categories.length > 0) {
+                updatePayload.custom_categories =
+                    mem0Config.customPrompts.custom_categories;
+            }
+            // Only proceed if there's something to update
+            if (Object.keys(updatePayload).length > 0) {
+                try {
+                    // Note: updateProject() internally calls ping() first, which auto-populates
+                    // organizationId and projectId from the server, so they're not required
+                    await client.updateProject(updatePayload);
+                    projectSettingsUpdated = true; // Only set to true on successful update
+                    logger.info("[mem0Initializer] Project settings updated successfully", {
+                        hasInstructions: !!updatePayload.custom_instructions,
+                        hasCategories: !!updatePayload.custom_categories,
+                        // Note: These IDs are auto-populated by ping() inside updateProject()
+                        organizationId: client.organizationId,
+                        projectId: client.projectId,
+                    });
+                }
+                catch (error) {
+                    logger.warn("[mem0Initializer] Failed to update project settings", {
+                        error: error instanceof Error ? error.message : String(error),
+                        hint: "Ensure your MEM0_API_KEY has permission to update project settings",
+                    });
+                    // Continue initialization even if project update fails
+                    // projectSettingsUpdated remains false
+                }
+            }
+            else {
+                logger.warn("[mem0Initializer] updateProjectSettings=true but no custom instructions or categories provided - nothing to update");
+            }
+        }
+        else if (mem0Config.updateProjectSettings && !mem0Config.customPrompts) {
+            logger.warn("[mem0Initializer] updateProjectSettings=true but customPrompts not provided - nothing to update");
+        }
+        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully", {
+            hasOrgId: !!client.organizationId,
+            hasProjectId: !!client.projectId,
+            projectSettingsUpdated,
         });
-        logger.info("[mem0Initializer] Mem0 cloud API initialized successfully");
         return client;
     }
     catch (error) {

package/dist/neurolink.d.ts

@@ -137,7 +137,7 @@ export declare class NeuroLink {
     /** Extract memory context from search results */
     private extractMemoryContext;
     /** Store conversation turn in mem0 */
-    private storeConversationTurn;
+    private storeMem0ConversationTurn;
     /**
      * Set up HITL event forwarding to main emitter
      */

package/dist/neurolink.js

@@ -402,9 +402,12 @@ Current user's request: ${currentInput}`;
             .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 }];
+    async storeMem0ConversationTurn(mem0, userContent, aiResponse, userId, metadata) {
+        // Store both user message and AI response for better context extraction
+        const conversationTurn = [
+            { role: "user", content: userContent },
+            { role: "assistant", content: aiResponse },
+        ];
         await mem0.add(conversationTurn, {
             user_id: userId,
             metadata,
@@ -1366,7 +1369,7 @@ Current user's request: ${currentInput}`;
                     try {
                         const mem0 = await this.ensureMem0Ready();
                         if (mem0) {
-                            await this.storeConversationTurn(mem0, originalPrompt, options.context?.userId, {
+                            await this.storeMem0ConversationTurn(mem0, originalPrompt, generateResult.content, options.context?.userId, {
                                 timestamp: new Date().toISOString(),
                                 provider: generateResult.provider,
                                 model: generateResult.model,
@@ -2037,11 +2040,9 @@ Current user's request: ${currentInput}`;
                                 try {
                                     const mem0 = await self.ensureMem0Ready();
                                     if (mem0) {
-                                        await self.storeConversationTurn(mem0, originalPrompt, enhancedOptions.context?.userId, {
+                                        await self.storeMem0ConversationTurn(mem0, originalPrompt, accumulatedContent.trim(), enhancedOptions.context?.userId, {
                                             timestamp: new Date().toISOString(),
                                             type: "conversation_turn_stream",
-                                            userMessage: originalPrompt,
-                                            aiResponse: accumulatedContent.trim(),
                                         });
                                     }
                                 }

package/package.json

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