@mastra/memory 1.4.0 → 1.5.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-memory
 description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
 metadata:
   package: "@mastra/memory"
-  version: "1.4.0"
+  version: "1.5.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,71 +1,71 @@
 {
-  "version": "1.4.0",
+  "version": "1.5.0",
   "package": "@mastra/memory",
   "exports": {
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js"
+      "implementation": "dist/chunk-DF7NDDSM.js"
     },
     "OBSERVATION_CONTEXT_INSTRUCTIONS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js"
+      "implementation": "dist/chunk-DF7NDDSM.js"
     },
     "OBSERVATION_CONTEXT_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js"
+      "implementation": "dist/chunk-DF7NDDSM.js"
     },
     "OBSERVATION_CONTINUATION_HINT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js"
+      "implementation": "dist/chunk-DF7NDDSM.js"
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js"
+      "implementation": "dist/chunk-DF7NDDSM.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 1273
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 1251
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 936
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 912
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 606
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 533
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 357
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 281
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 692
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 662
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 452
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 376
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 680
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 650
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 703
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 673
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-D4AWAGLM.js",
-      "line": 637
+      "implementation": "dist/chunk-DF7NDDSM.js",
+      "line": 564
     },
     "extractWorkingMemoryContent": {
       "types": "dist/index.d.ts",
@@ -96,7 +96,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-D4AWAGLM.js"
+        "chunk-DF7NDDSM.js"
       ]
     }
   }

package/dist/docs/references/docs-memory-observational-memory.md

@@ -180,6 +180,8 @@ As the agent converses, message tokens accumulate. At regular intervals (`buffer
 
 When message tokens reach the `messageTokens` threshold, buffered chunks activate: their observations move into the active observation log, and the corresponding raw messages are removed from the context window. The agent never pauses.
 
+Buffered observations also include continuation hints — a suggested next response and the current task — so the main agent maintains conversational continuity after activation shrinks the context window.
+
 If the agent produces messages faster than the Observer can process them, a `blockAfter` safety threshold forces a synchronous observation as a last resort.
 
 Reflection works similarly — the Reflector runs in the background when observations reach a fraction of the reflection threshold.

package/dist/docs/references/reference-memory-memory-class.md

@@ -36,7 +36,7 @@ export const agent = new Agent({
 
 ### Options parameters
 
-**lastMessages?:** (`number | false`): Number of most recent messages to retrieve. Set to false to disable. (Default: `10`)
+**lastMessages?:** (`number | false`): Number of most recent messages to include in context. Set to \`false\` to disable loading conversation history into context. Use \`Number.MAX\_SAFE\_INTEGER\` to retrieve all messages with no limit. To prevent saving new messages, use the \`readOnly\` option instead. (Default: `10`)
 
 **readOnly?:** (`boolean`): When true, prevents memory from saving new messages and provides working memory as read-only context (without the updateWorkingMemory tool). Useful for read-only operations like previews, internal routing agents, or sub agents that should reference but not modify memory. (Default: `false`)
 

package/dist/docs/references/reference-memory-observational-memory.md

@@ -221,6 +221,7 @@ Default settings:
 
 - `observation.bufferTokens: 0.2` — buffer every 20% of `messageTokens` (e.g. every \~6k tokens with a 30k threshold)
 - `observation.bufferActivation: 0.8` — on activation, remove enough messages to keep only 20% of the threshold remaining
+- Buffered observations include continuation hints (`suggestedResponse`, `currentTask`) that survive activation to maintain conversational continuity
 - `reflection.bufferActivation: 0.5` — start background reflection at 50% of observation threshold
 
 To customize:

package/dist/index.cjs

@@ -12534,7 +12534,7 @@ async function getVercelRequestId2() {
   var _a932;
   return (_a932 = (0, import_oidc3.getContext)().headers) == null ? void 0 : _a932["x-vercel-id"];
 }
-var VERSION5 = "3.0.50";
+var VERSION5 = "3.0.52";
 var AI_GATEWAY_PROTOCOL_VERSION2 = "0.0.1";
 function createGatewayProvider2(options = {}) {
   var _a932, _b92;
@@ -13602,7 +13602,7 @@ function getTotalTimeoutMs(timeout) {
   }
   return timeout.totalMs;
 }
-var VERSION33 = "6.0.91";
+var VERSION33 = "6.0.94";
 var dataContentSchema3 = z4.z.union([
   z4.z.string(),
   z4.z.instanceof(Uint8Array),
@@ -16377,7 +16377,7 @@ Notes:
         "Observational memory async buffering is enabled by default but the installed version of @mastra/core does not support it. Either upgrade @mastra/core, @mastra/memory, and your storage adapter (@mastra/libsql, @mastra/pg, or @mastra/mongodb) to the latest version, or explicitly disable async buffering by setting `observation: { bufferTokens: false }` in your observationalMemory config."
       );
     }
-    const { ObservationalMemory } = await import('./observational-memory-UCOMAMSF.cjs');
+    const { ObservationalMemory } = await import('./observational-memory-4PCXEZIS.cjs');
     return new ObservationalMemory({
       storage: memoryStore,
       scope: omConfig.scope,