@mastra/memory 1.20.0-alpha.2 → 1.20.1-alpha.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.20.0-alpha.2"
+  version: "1.20.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,119 +1,119 @@
 {
-  "version": "1.20.0-alpha.2",
+  "version": "1.20.1-alpha.0",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 787
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js"
+      "implementation": "dist/chunk-LXU26UVM.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 7051
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 7060
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 9619
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 9631
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 6497
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 6506
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3765
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3774
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3036
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3045
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 879
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 913
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3879
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3888
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3491
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3500
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 9831
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 9844
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3867
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3876
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 2584
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 2593
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3890
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3899
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 2557
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 2566
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 848
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 3775
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 3784
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 937
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 893
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
-      "line": 2614
+      "implementation": "dist/chunk-LXU26UVM.js",
+      "line": 2623
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 870
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-BCWFD5J7.js",
+      "implementation": "dist/chunk-LXU26UVM.js",
       "line": 841
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
@@ -149,7 +149,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-BCWFD5J7.js",
+        "chunk-LXU26UVM.js",
         "chunk-VKRZ3O5X.js"
       ]
     }

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

@@ -117,6 +117,25 @@ const memory = new Memory({
 
 In this example, the top-level idle setting is disabled for observations, while reflections opt into idle and provider-change activation.
 
+### Buffer on idle
+
+Set `observation.bufferOnIdle` to `true` to run background observation buffering when an agent turn ends and the agent becomes idle. This is useful for apps that want short turns to be observed without waiting for the next turn or the `messageTokens` threshold.
+
+```typescript
+const memory = new Memory({
+  options: {
+    observationalMemory: {
+      model: 'openai/gpt-5-mini',
+      observation: {
+        bufferOnIdle: true,
+      },
+    },
+  },
+})
+```
+
+`bufferOnIdle` is off by default. It is separate from `bufferTokens`: `bufferTokens` controls step-time async buffering, while `bufferOnIdle` controls end-of-turn buffering for idle turns.
+
 See [the API reference](https://mastra.ai/reference/memory/observational-memory) for the full configuration shape.
 
 ## Benefits

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

@@ -68,6 +68,8 @@ OM performs thresholding with fast local token estimation. Text uses `tokenx`, a
 
 **observation.bufferTokens** (`number | false`): Token interval for async background observation buffering. Can be an absolute token count (e.g. \`5000\`) or a fraction of \`messageTokens\` (e.g. \`0.25\` = buffer every 25% of threshold). When set, observations run in the background at this interval, storing results in a buffer. When the main \`messageTokens\` threshold is reached, buffered observations activate instantly without a blocking LLM call. Must resolve to less than \`messageTokens\`. Set to \`false\` to explicitly disable all async buffering (both observation and reflection).
 
+**observation.bufferOnIdle** (`boolean`): Run background observation buffering when an agent turn ends and the agent becomes idle. This is separate from \`bufferTokens\`, which controls step-time async buffering. Set this to \`true\` to buffer short idle turns without waiting for the next turn or the \`messageTokens\` threshold.
+
 **observation.bufferActivation** (`number`): Controls how much of the message window to retain after activation. Accepts a ratio (0-1) or an absolute token count (≥ 1000). For example, \`0.8\` means: activate enough buffers to remove 80% of \`messageTokens\` and leave 20% as active message history. An absolute token count like \`4000\` targets a goal of keeping \~4k message tokens remaining after activation. Higher values remove more message history per activation when using a ratio. Higher values keep more message history when using a token count.
 
 **observation.activateAfterIdle** (`number | string | false | "auto"`): Time before buffered observations are forced to activate after inactivity. Accepts milliseconds, a duration string, \`"auto"\` for a provider-aware prompt cache TTL, or \`false\`. If unset, the top-level \`activateAfterIdle\` value is used for observations. Set \`false\` to disable the top-level idle setting for observations.

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkSMKIROLC_cjs = require('./chunk-SMKIROLC.cjs');
+var chunkR2H7SJS2_cjs = require('./chunk-R2H7SJS2.cjs');
 var chunk3Q3LOVQP_cjs = require('./chunk-3Q3LOVQP.cjs');
 var agent = require('@mastra/core/agent');
 var features = require('@mastra/core/features');
@@ -45971,7 +45971,7 @@ function formatTimestamp(date9) {
 }
 function truncateByTokens(text4, maxTokens, hint) {
   if (tokenx.estimateTokenCount(text4) <= maxTokens) return { text: text4, wasTruncated: false };
-  const truncated = chunkSMKIROLC_cjs.truncateStringByTokens(text4, maxTokens);
+  const truncated = chunkR2H7SJS2_cjs.truncateStringByTokens(text4, maxTokens);
   const suffix = hint ? ` [${hint} for more]` : "";
   return { text: truncated + suffix, wasTruncated: true };
 }
@@ -46023,11 +46023,11 @@ ${JSON.stringify(inv.args, null, 2)}`;
             });
           }
           if (inv.state === "result") {
-            const { value: resultValue } = chunkSMKIROLC_cjs.resolveToolResultValue(
+            const { value: resultValue } = chunkR2H7SJS2_cjs.resolveToolResultValue(
               part,
               inv.result
             );
-            const resultStr = chunkSMKIROLC_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+            const resultStr = chunkR2H7SJS2_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
             const fullText = `[Tool Result: ${inv.toolName}]
 ${resultStr}`;
             parts.push(makePart(msg, i, "tool-result", fullText, detail, inv.toolName));
@@ -46054,7 +46054,7 @@ ${typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs, null, 2)}`;
         const toolName = part.toolName;
         if (toolName) {
           const rawResult = part.output ?? part.result;
-          const resultStr = chunkSMKIROLC_cjs.formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const resultStr = chunkR2H7SJS2_cjs.formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
           const fullText = `[Tool Result: ${toolName}]
 ${resultStr}`;
           parts.push(makePart(msg, i, "tool-result", fullText, detail, toolName));
@@ -46133,7 +46133,7 @@ function renderFormattedParts(parts, timestamps, options) {
   const text4 = buildRenderedText(parts, timestamps);
   let totalTokens = tokenx.estimateTokenCount(text4);
   if (totalTokens > options.maxTokens) {
-    const truncated = chunkSMKIROLC_cjs.truncateStringByTokens(text4, options.maxTokens);
+    const truncated = chunkR2H7SJS2_cjs.truncateStringByTokens(text4, options.maxTokens);
     return { text: truncated, truncated: true, tokenOffset: totalTokens - options.maxTokens };
   }
   const truncatedIndices = parts.map((p, i) => ({ part: p, index: i })).filter(({ part }) => part.text !== part.fullText).sort((a, b) => expandPriority(a.part) - expandPriority(b.part));
@@ -46166,7 +46166,7 @@ function renderFormattedParts(parts, timestamps, options) {
   if (expandedTokens <= options.maxTokens) {
     return { text: expanded, truncated: false, tokenOffset: 0 };
   }
-  const hardTruncated = chunkSMKIROLC_cjs.truncateStringByTokens(expanded, options.maxTokens);
+  const hardTruncated = chunkR2H7SJS2_cjs.truncateStringByTokens(expanded, options.maxTokens);
   return { text: hardTruncated, truncated: true, tokenOffset: expandedTokens - options.maxTokens };
 }
 async function recallPart({
@@ -46217,7 +46217,7 @@ async function recallPart({
 
 `;
           const fallbackText = `${fallbackNote}${firstNextPart.text}`;
-          const truncatedText2 = chunkSMKIROLC_cjs.truncateStringByTokens(fallbackText, maxTokens);
+          const truncatedText2 = chunkR2H7SJS2_cjs.truncateStringByTokens(fallbackText, maxTokens);
           const wasTruncated2 = truncatedText2 !== fallbackText;
           return {
             text: truncatedText2,
@@ -46232,7 +46232,7 @@ async function recallPart({
     }
     throw new Error(`Part index ${partIndex} not found in message ${cursor}. Available indices: ${availableIndices}`);
   }
-  const truncatedText = chunkSMKIROLC_cjs.truncateStringByTokens(target.text, maxTokens);
+  const truncatedText = chunkR2H7SJS2_cjs.truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
   return {
     text: truncatedText,
@@ -48051,7 +48051,7 @@ ${workingMemory}`;
         "Observational memory requires @mastra/core support for request-response-id-rotation. Please bump @mastra/core to a newer version."
       );
     }
-    const { ObservationalMemory: OMClass } = await import('./observational-memory-LGCWMUEM.cjs');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-L32TPJ5J.cjs');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -48072,6 +48072,7 @@ ${workingMemory}`;
         maxTokensPerBatch: omConfig.observation.maxTokensPerBatch,
         providerOptions: omConfig.observation.providerOptions,
         bufferTokens: omConfig.observation.bufferTokens,
+        bufferOnIdle: omConfig.observation.bufferOnIdle,
         bufferActivation: omConfig.observation.bufferActivation,
         blockAfter: omConfig.observation.blockAfter,
         previousObserverTokens: omConfig.observation.previousObserverTokens,
@@ -48978,7 +48979,7 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-LGCWMUEM.cjs');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-L32TPJ5J.cjs');
     return new ObservationalMemoryProcessor(engine, this, {
       temporalMarkers: effectiveConfig.temporalMarkers
     });
@@ -48987,11 +48988,11 @@ Notes:
 
 Object.defineProperty(exports, "ModelByInputTokens", {
   enumerable: true,
-  get: function () { return chunkSMKIROLC_cjs.ModelByInputTokens; }
+  get: function () { return chunkR2H7SJS2_cjs.ModelByInputTokens; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunkSMKIROLC_cjs.getObservationsAsOf; }
+  get: function () { return chunkR2H7SJS2_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "MessageHistory", {
   enumerable: true,