@juspay/neurolink 9.39.0 → 9.40.0

package/dist/lib/neurolink.d.ts

@@ -181,6 +181,10 @@ export declare class NeuroLink {
     private registerMemoryRetrievalTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    private formatMultiUserMemoryContext;
     /**
      * Determine whether memory should be read (retrieved) for this call.
      * Respects both the global memory SDK config and per-call overrides.
@@ -192,13 +196,14 @@ export declare class NeuroLink {
      */
     private shouldWriteMemory;
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
     private retrieveMemory;
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
     private storeMemoryInBackground;
     /**

package/dist/lib/neurolink.js

@@ -823,6 +823,20 @@ export class NeuroLink {
 
 ${memoryContext}
 
+Current user's request: ${currentInput}`;
+    }
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    formatMultiUserMemoryContext(memories, currentInput) {
+        const memoryBlocks = [];
+        for (const [label, memory] of memories) {
+            memoryBlocks.push(`[${label}]\n${memory}`);
+        }
+        return `Context from previous conversations:
+
+${memoryBlocks.join("\n\n")}
+
 Current user's request: ${currentInput}`;
     }
     /**
@@ -863,32 +877,71 @@ Current user's request: ${currentInput}`;
         return true;
     }
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
-    async retrieveMemory(inputText, userId) {
+    async retrieveMemory(inputText, userId, additionalUsers) {
         const client = this.ensureMemoryReady();
         if (!client) {
             return inputText;
         }
-        const memory = await client.get(userId);
-        if (!memory) {
+        // Collect all user IDs to read (primary + additional users with read !== false)
+        const readableAdditional = (additionalUsers || []).filter((u) => u.read !== false);
+        if (readableAdditional.length === 0) {
+            // Single user — use original fast path
+            const memory = await client.get(userId);
+            if (!memory) {
+                return inputText;
+            }
+            return this.formatMemoryContext(memory, inputText);
+        }
+        // Multi-user: fetch all memories in parallel
+        // Build entries with labels for formatting
+        const entries = [
+            { id: userId, label: "User" },
+            ...readableAdditional.map((u) => ({
+                id: u.userId,
+                label: u.label || u.userId,
+            })),
+        ];
+        const results = await Promise.all(entries.map(async (entry) => {
+            const memory = await client.get(entry.id);
+            return { ...entry, memory };
+        }));
+        const memories = new Map();
+        for (const { label, memory } of results) {
+            if (memory) {
+                memories.set(label, memory);
+            }
+        }
+        if (memories.size === 0) {
             return inputText;
         }
-        return this.formatMemoryContext(memory, inputText);
+        return this.formatMultiUserMemoryContext(memories, inputText);
     }
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
-    storeMemoryInBackground(originalPrompt, responseContent, userId) {
+    storeMemoryInBackground(originalPrompt, responseContent, userId, additionalUsers) {
         setImmediate(async () => {
             try {
                 const client = this.ensureMemoryReady();
-                if (client) {
-                    const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
-                    await client.add(userId, content);
+                if (!client) {
+                    return;
                 }
+                const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
+                // Collect all users to write: primary + additional users with write !== false
+                const writeOps = [client.add(userId, content)];
+                const writableAdditional = (additionalUsers || []).filter((u) => u.write !== false);
+                for (const user of writableAdditional) {
+                    const addOptions = user.prompt || user.maxWords
+                        ? { prompt: user.prompt, maxWords: user.maxWords }
+                        : undefined;
+                    writeOps.push(client.add(user.userId, content, addOptions));
+                }
+                await Promise.all(writeOps);
             }
             catch (error) {
                 logger.warn("Memory storage failed:", error);
@@ -2428,6 +2481,17 @@ Current user's request: ${currentInput}`;
                                 });
                             }
                         }
+                        // Memory retrieval for generate path
+                        if (this.shouldReadMemory(options.memory, options.context?.userId) &&
+                            options.context?.userId) {
+                            try {
+                                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
+                                logger.debug("Memory retrieval successful (generate)");
+                            }
+                            catch (error) {
+                                logger.warn("Memory retrieval failed (generate):", error);
+                            }
+                        }
                         // 🔧 CRITICAL FIX: Convert to TextGenerationOptions while preserving the input object for multimodal support
                         const baseOptions = {
                             prompt: options.input.text,
@@ -2613,7 +2677,7 @@ Current user's request: ${currentInput}`;
         // Memory storage
         if (this.shouldWriteMemory(options.memory, options.context?.userId, generateResult.content) &&
             options.context?.userId) {
-            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId, options.memory?.additionalUsers);
         }
     }
     /**
@@ -4411,7 +4475,7 @@ Current user's request: ${currentInput}`;
         if (this.shouldReadMemory(options.memory, options.context?.userId) &&
             options.context?.userId) {
             try {
-                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId);
+                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
                 logger.debug("Memory retrieval successful");
             }
             catch (error) {
@@ -4724,7 +4788,7 @@ Current user's request: ${currentInput}`;
             }
         }
         if (this.shouldWriteMemory(enhancedOptions.memory, enhancedOptions.context?.userId, accumulatedContent)) {
-            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId, enhancedOptions.memory?.additionalUsers);
         }
     }
     /**

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

@@ -426,8 +426,37 @@ export type GenerateOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
+/**
+ * Represents an additional user whose memory should be included in a generate/stream call.
+ * Allows per-user prompt overrides for different memory condensation strategies
+ * (e.g. personal preferences vs org-level policies).
+ */
+export type AdditionalMemoryUser = {
+    /** The user/owner ID to retrieve or store memory for. */
+    userId: string;
+    /**
+     * Human-readable label used in the formatted memory context.
+     * E.g. "Organization Policy", "Team Context", "User Preferences".
+     * If not provided, defaults to userId.
+     */
+    label?: string;
+    /** Whether to read this user's memory and include in context. Defaults to true. */
+    read?: boolean;
+    /** Whether to write conversation into this user's memory. Defaults to true. */
+    write?: boolean;
+    /** Custom condensation prompt for this user. Overrides the default Hippocampus prompt. */
+    prompt?: string;
+    /** Max words for this user's condensed memory. Overrides the default maxWords. */
+    maxWords?: number;
+};
 /**
  * Generate function result type - Primary output format
  * Future-ready for multi-modal outputs while maintaining text focus

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

@@ -22,7 +22,7 @@ export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, Domai
 export * from "./evaluation.js";
 export * from "./evaluationProviders.js";
 export * from "./fileTypes.js";
-export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+export type { AdditionalMemoryUser, EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
 TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
 export * from "./middlewareTypes.js";

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

@@ -10,6 +10,7 @@ import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage } from "./conversation.js";
 import type { AIModelProviderConfig } from "./providers.js";
 import type { TTSChunk, TTSOptions } from "./ttsTypes.js";
+import type { AdditionalMemoryUser } from "./generateTypes.js";
 import type { StandardRecord, ValidationSchema } from "./typeAliases.js";
 /**
  * Progress tracking and metadata for streaming operations
@@ -435,6 +436,12 @@ export type StreamOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
 /**

package/dist/neurolink.d.ts

@@ -181,6 +181,10 @@ export declare class NeuroLink {
     private registerMemoryRetrievalTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    private formatMultiUserMemoryContext;
     /**
      * Determine whether memory should be read (retrieved) for this call.
      * Respects both the global memory SDK config and per-call overrides.
@@ -192,13 +196,14 @@ export declare class NeuroLink {
      */
     private shouldWriteMemory;
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
     private retrieveMemory;
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
     private storeMemoryInBackground;
     /**

package/dist/neurolink.js

@@ -823,6 +823,20 @@ export class NeuroLink {
 
 ${memoryContext}
 
+Current user's request: ${currentInput}`;
+    }
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    formatMultiUserMemoryContext(memories, currentInput) {
+        const memoryBlocks = [];
+        for (const [label, memory] of memories) {
+            memoryBlocks.push(`[${label}]\n${memory}`);
+        }
+        return `Context from previous conversations:
+
+${memoryBlocks.join("\n\n")}
+
 Current user's request: ${currentInput}`;
     }
     /**
@@ -863,32 +877,71 @@ Current user's request: ${currentInput}`;
         return true;
     }
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
-    async retrieveMemory(inputText, userId) {
+    async retrieveMemory(inputText, userId, additionalUsers) {
         const client = this.ensureMemoryReady();
         if (!client) {
             return inputText;
         }
-        const memory = await client.get(userId);
-        if (!memory) {
+        // Collect all user IDs to read (primary + additional users with read !== false)
+        const readableAdditional = (additionalUsers || []).filter((u) => u.read !== false);
+        if (readableAdditional.length === 0) {
+            // Single user — use original fast path
+            const memory = await client.get(userId);
+            if (!memory) {
+                return inputText;
+            }
+            return this.formatMemoryContext(memory, inputText);
+        }
+        // Multi-user: fetch all memories in parallel
+        // Build entries with labels for formatting
+        const entries = [
+            { id: userId, label: "User" },
+            ...readableAdditional.map((u) => ({
+                id: u.userId,
+                label: u.label || u.userId,
+            })),
+        ];
+        const results = await Promise.all(entries.map(async (entry) => {
+            const memory = await client.get(entry.id);
+            return { ...entry, memory };
+        }));
+        const memories = new Map();
+        for (const { label, memory } of results) {
+            if (memory) {
+                memories.set(label, memory);
+            }
+        }
+        if (memories.size === 0) {
             return inputText;
         }
-        return this.formatMemoryContext(memory, inputText);
+        return this.formatMultiUserMemoryContext(memories, inputText);
     }
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
-    storeMemoryInBackground(originalPrompt, responseContent, userId) {
+    storeMemoryInBackground(originalPrompt, responseContent, userId, additionalUsers) {
         setImmediate(async () => {
             try {
                 const client = this.ensureMemoryReady();
-                if (client) {
-                    const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
-                    await client.add(userId, content);
+                if (!client) {
+                    return;
                 }
+                const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
+                // Collect all users to write: primary + additional users with write !== false
+                const writeOps = [client.add(userId, content)];
+                const writableAdditional = (additionalUsers || []).filter((u) => u.write !== false);
+                for (const user of writableAdditional) {
+                    const addOptions = user.prompt || user.maxWords
+                        ? { prompt: user.prompt, maxWords: user.maxWords }
+                        : undefined;
+                    writeOps.push(client.add(user.userId, content, addOptions));
+                }
+                await Promise.all(writeOps);
             }
             catch (error) {
                 logger.warn("Memory storage failed:", error);
@@ -2428,6 +2481,17 @@ Current user's request: ${currentInput}`;
                                 });
                             }
                         }
+                        // Memory retrieval for generate path
+                        if (this.shouldReadMemory(options.memory, options.context?.userId) &&
+                            options.context?.userId) {
+                            try {
+                                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
+                                logger.debug("Memory retrieval successful (generate)");
+                            }
+                            catch (error) {
+                                logger.warn("Memory retrieval failed (generate):", error);
+                            }
+                        }
                         // 🔧 CRITICAL FIX: Convert to TextGenerationOptions while preserving the input object for multimodal support
                         const baseOptions = {
                             prompt: options.input.text,
@@ -2613,7 +2677,7 @@ Current user's request: ${currentInput}`;
         // Memory storage
         if (this.shouldWriteMemory(options.memory, options.context?.userId, generateResult.content) &&
             options.context?.userId) {
-            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId, options.memory?.additionalUsers);
         }
     }
     /**
@@ -4411,7 +4475,7 @@ Current user's request: ${currentInput}`;
         if (this.shouldReadMemory(options.memory, options.context?.userId) &&
             options.context?.userId) {
             try {
-                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId);
+                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
                 logger.debug("Memory retrieval successful");
             }
             catch (error) {
@@ -4724,7 +4788,7 @@ Current user's request: ${currentInput}`;
             }
         }
         if (this.shouldWriteMemory(enhancedOptions.memory, enhancedOptions.context?.userId, accumulatedContent)) {
-            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId, enhancedOptions.memory?.additionalUsers);
         }
     }
     /**

package/dist/types/generateTypes.d.ts

@@ -426,8 +426,37 @@ export type GenerateOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
+/**
+ * Represents an additional user whose memory should be included in a generate/stream call.
+ * Allows per-user prompt overrides for different memory condensation strategies
+ * (e.g. personal preferences vs org-level policies).
+ */
+export type AdditionalMemoryUser = {
+    /** The user/owner ID to retrieve or store memory for. */
+    userId: string;
+    /**
+     * Human-readable label used in the formatted memory context.
+     * E.g. "Organization Policy", "Team Context", "User Preferences".
+     * If not provided, defaults to userId.
+     */
+    label?: string;
+    /** Whether to read this user's memory and include in context. Defaults to true. */
+    read?: boolean;
+    /** Whether to write conversation into this user's memory. Defaults to true. */
+    write?: boolean;
+    /** Custom condensation prompt for this user. Overrides the default Hippocampus prompt. */
+    prompt?: string;
+    /** Max words for this user's condensed memory. Overrides the default maxWords. */
+    maxWords?: number;
+};
 /**
  * Generate function result type - Primary output format
  * Future-ready for multi-modal outputs while maintaining text focus

package/dist/types/index.d.ts

@@ -22,7 +22,7 @@ export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, Domai
 export * from "./evaluation.js";
 export * from "./evaluationProviders.js";
 export * from "./fileTypes.js";
-export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+export type { AdditionalMemoryUser, EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
 TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
 export * from "./middlewareTypes.js";

package/dist/types/streamTypes.d.ts

@@ -10,6 +10,7 @@ import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage } from "./conversation.js";
 import type { AIModelProviderConfig } from "./providers.js";
 import type { TTSChunk, TTSOptions } from "./ttsTypes.js";
+import type { AdditionalMemoryUser } from "./generateTypes.js";
 import type { StandardRecord, ValidationSchema } from "./typeAliases.js";
 /**
  * Progress tracking and metadata for streaming operations
@@ -435,6 +436,12 @@ export type StreamOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.39.0",
+  "version": "9.40.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 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",
@@ -200,7 +200,7 @@
     "@google/genai": "^1.43.0",
     "@google/generative-ai": "^0.24.1",
     "@huggingface/inference": "^4.13.14",
-    "@juspay/hippocampus": "^0.1.3",
+    "@juspay/hippocampus": "^0.1.4",
     "@langfuse/otel": "^5.0.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@openrouter/ai-sdk-provider": "^2.2.3",