@juspay/neurolink 9.32.1 → 9.33.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.33.0](https://github.com/juspay/neurolink/compare/v9.32.1...v9.33.0) (2026-03-27)
+
+### Features
+
+- **(memory):** add per-call memory control options (read/write) for generate and stream in NeuroLink ([c9a354b](https://github.com/juspay/neurolink/commit/c9a354b2b3197a78a42d2a19f25757792467023f))
+
 ## [9.32.1](https://github.com/juspay/neurolink/compare/v9.32.0...v9.32.1) (2026-03-27)
 
 ### Bug Fixes

package/dist/lib/neurolink.d.ts

@@ -181,6 +181,16 @@ export declare class NeuroLink {
     private registerMemoryRetrievalTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /**
+     * Determine whether memory should be read (retrieved) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    private shouldReadMemory;
+    /**
+     * Determine whether memory should be written (stored) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    private shouldWriteMemory;
     /**
      * Retrieve condensed memory for a user.
      * Returns the input text enhanced with memory context, or unchanged if no memory.

package/dist/lib/neurolink.js

@@ -825,6 +825,43 @@ ${memoryContext}
 
 Current user's request: ${currentInput}`;
     }
+    /**
+     * Determine whether memory should be read (retrieved) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    shouldReadMemory(perCallMemory, userId) {
+        if (!this.conversationMemoryConfig?.conversationMemory?.memory?.enabled ||
+            !userId) {
+            return false;
+        }
+        if (perCallMemory?.enabled === false) {
+            return false;
+        }
+        if (perCallMemory?.read === false) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Determine whether memory should be written (stored) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    shouldWriteMemory(perCallMemory, userId, content) {
+        if (!this.conversationMemoryConfig?.conversationMemory?.memory?.enabled ||
+            !userId) {
+            return false;
+        }
+        if (!content?.trim()) {
+            return false;
+        }
+        if (perCallMemory?.enabled === false) {
+            return false;
+        }
+        if (perCallMemory?.write === false) {
+            return false;
+        }
+        return true;
+    }
     /**
      * Retrieve condensed memory for a user.
      * Returns the input text enhanced with memory context, or unchanged if no memory.
@@ -2574,9 +2611,8 @@ Current user's request: ${currentInput}`;
      */
     scheduleGenerateMemoryStorage(options, originalPrompt, generateResult) {
         // Memory storage
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
-            options.context?.userId &&
-            generateResult.content?.trim()) {
+        if (this.shouldWriteMemory(options.memory, options.context?.userId, generateResult.content) &&
+            options.context?.userId) {
             this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId);
         }
     }
@@ -4372,7 +4408,7 @@ Current user's request: ${currentInput}`;
         // Initialize MCP
         await this.initializeMCP();
         // Memory retrieval
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
+        if (this.shouldReadMemory(options.memory, options.context?.userId) &&
             options.context?.userId) {
             try {
                 options.input.text = await this.retrieveMemory(options.input.text, options.context.userId);
@@ -4687,9 +4723,7 @@ Current user's request: ${currentInput}`;
                 });
             }
         }
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
-            enhancedOptions.context?.userId &&
-            accumulatedContent?.trim()) {
+        if (this.shouldWriteMemory(enhancedOptions.memory, enhancedOptions.context?.userId, accumulatedContent)) {
             this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId);
         }
     }

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

@@ -411,6 +411,22 @@ export type GenerateOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-call memory control.
+     *
+     * Override the global memory SDK behavior for this specific call.
+     * All flags default to `true` when the global memory SDK is enabled.
+     * If the global memory SDK is disabled, these flags have no effect.
+     *
+     */
+    memory?: {
+        /** Master toggle for this call. When false, both read and write are skipped. Defaults to true. */
+        enabled?: boolean;
+        /** Whether to read condensed memory and prepend to prompt. Defaults to true. */
+        read?: boolean;
+        /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
+        write?: boolean;
+    };
 };
 /**
  * Generate function result type - Primary output format

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

@@ -421,6 +421,21 @@ export type StreamOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-call memory control.
+     *
+     * Override the global memory SDK behavior for this specific call.
+     * All flags default to `true` when the global memory SDK is enabled.
+     * If the global memory SDK is disabled, these flags have no effect.
+     */
+    memory?: {
+        /** Master toggle for this call. When false, both read and write are skipped. Defaults to true. */
+        enabled?: boolean;
+        /** Whether to read condensed memory and prepend to prompt. Defaults to true. */
+        read?: boolean;
+        /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
+        write?: boolean;
+    };
 };
 /**
  * Stream function result type - Primary output format for streaming

package/dist/neurolink.d.ts

@@ -181,6 +181,16 @@ export declare class NeuroLink {
     private registerMemoryRetrievalTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /**
+     * Determine whether memory should be read (retrieved) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    private shouldReadMemory;
+    /**
+     * Determine whether memory should be written (stored) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    private shouldWriteMemory;
     /**
      * Retrieve condensed memory for a user.
      * Returns the input text enhanced with memory context, or unchanged if no memory.

package/dist/neurolink.js

@@ -825,6 +825,43 @@ ${memoryContext}
 
 Current user's request: ${currentInput}`;
     }
+    /**
+     * Determine whether memory should be read (retrieved) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    shouldReadMemory(perCallMemory, userId) {
+        if (!this.conversationMemoryConfig?.conversationMemory?.memory?.enabled ||
+            !userId) {
+            return false;
+        }
+        if (perCallMemory?.enabled === false) {
+            return false;
+        }
+        if (perCallMemory?.read === false) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Determine whether memory should be written (stored) for this call.
+     * Respects both the global memory SDK config and per-call overrides.
+     */
+    shouldWriteMemory(perCallMemory, userId, content) {
+        if (!this.conversationMemoryConfig?.conversationMemory?.memory?.enabled ||
+            !userId) {
+            return false;
+        }
+        if (!content?.trim()) {
+            return false;
+        }
+        if (perCallMemory?.enabled === false) {
+            return false;
+        }
+        if (perCallMemory?.write === false) {
+            return false;
+        }
+        return true;
+    }
     /**
      * Retrieve condensed memory for a user.
      * Returns the input text enhanced with memory context, or unchanged if no memory.
@@ -2574,9 +2611,8 @@ Current user's request: ${currentInput}`;
      */
     scheduleGenerateMemoryStorage(options, originalPrompt, generateResult) {
         // Memory storage
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
-            options.context?.userId &&
-            generateResult.content?.trim()) {
+        if (this.shouldWriteMemory(options.memory, options.context?.userId, generateResult.content) &&
+            options.context?.userId) {
             this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId);
         }
     }
@@ -4372,7 +4408,7 @@ Current user's request: ${currentInput}`;
         // Initialize MCP
         await this.initializeMCP();
         // Memory retrieval
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
+        if (this.shouldReadMemory(options.memory, options.context?.userId) &&
             options.context?.userId) {
             try {
                 options.input.text = await this.retrieveMemory(options.input.text, options.context.userId);
@@ -4687,9 +4723,7 @@ Current user's request: ${currentInput}`;
                 });
             }
         }
-        if (this.conversationMemoryConfig?.conversationMemory?.memory?.enabled &&
-            enhancedOptions.context?.userId &&
-            accumulatedContent?.trim()) {
+        if (this.shouldWriteMemory(enhancedOptions.memory, enhancedOptions.context?.userId, accumulatedContent)) {
             this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId);
         }
     }

package/dist/types/generateTypes.d.ts

@@ -411,6 +411,22 @@ export type GenerateOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-call memory control.
+     *
+     * Override the global memory SDK behavior for this specific call.
+     * All flags default to `true` when the global memory SDK is enabled.
+     * If the global memory SDK is disabled, these flags have no effect.
+     *
+     */
+    memory?: {
+        /** Master toggle for this call. When false, both read and write are skipped. Defaults to true. */
+        enabled?: boolean;
+        /** Whether to read condensed memory and prepend to prompt. Defaults to true. */
+        read?: boolean;
+        /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
+        write?: boolean;
+    };
 };
 /**
  * Generate function result type - Primary output format

package/dist/types/streamTypes.d.ts

@@ -421,6 +421,21 @@ export type StreamOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-call memory control.
+     *
+     * Override the global memory SDK behavior for this specific call.
+     * All flags default to `true` when the global memory SDK is enabled.
+     * If the global memory SDK is disabled, these flags have no effect.
+     */
+    memory?: {
+        /** Master toggle for this call. When false, both read and write are skipped. Defaults to true. */
+        enabled?: boolean;
+        /** Whether to read condensed memory and prepend to prompt. Defaults to true. */
+        read?: boolean;
+        /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
+        write?: boolean;
+    };
 };
 /**
  * Stream function result type - Primary output format for streaming

package/package.json

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