@mastra/memory 1.19.0 → 1.20.0-alpha.1

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.19.0"
+  version: "1.20.0-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,120 +1,120 @@
 {
-  "version": "1.19.0",
+  "version": "1.20.0-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 786
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 787
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js"
+      "implementation": "dist/chunk-G72RLVRT.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 7009
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 7051
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 9589
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 9619
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 6455
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 6497
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3760
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3765
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3031
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3036
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 878
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 879
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 912
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 913
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3874
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3879
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3486
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3491
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 9801
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 9831
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3862
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3867
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 2579
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 2584
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3885
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3890
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 2552
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 2557
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 847
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 848
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 3770
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 3775
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 936
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 937
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 892
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 893
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 2609
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 2614
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 869
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 870
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-NZXH5WER.js",
-      "line": 840
+      "implementation": "dist/chunk-G72RLVRT.js",
+      "line": 841
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
       "types": "dist/processors/index.d.ts",
@@ -149,7 +149,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-NZXH5WER.js",
+        "chunk-G72RLVRT.js",
         "chunk-LSJJAJAF.js"
       ]
     }

package/dist/docs/references/docs-memory-multi-user-threads.md

@@ -65,7 +65,7 @@ const memory = new Memory({
 export const collabAgent = new Agent({
   id: 'collab',
   name: 'CollabAgent',
-  model: 'openai/gpt-5.4-mini',
+  model: '__OPENAI_MODEL_MINI__',
   memory,
   instructions: `
 You are a collaborative document assistant. Multiple users talk to you in the SAME thread.

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

@@ -316,7 +316,7 @@ const memory = new Memory({
             // Faster, cheaper models for smaller inputs; stronger models for larger contexts
             5_000: 'openrouter/mistralai/ministral-8b-2512',
             20_000: 'openrouter/mistralai/mistral-small-2603',
-            40_000: 'openai/gpt-5.4-mini',
+            40_000: 'openai/gpt-5-mini',
             1_000_000: 'google/gemini-3.1-flash-lite-preview',
           },
         }),
@@ -324,7 +324,7 @@ const memory = new Memory({
       reflection: {
         model: new ModelByInputTokens({
           upTo: {
-            20_000: 'openai/gpt-5.4-mini',
+            20_000: 'openai/gpt-5-mini',
             100_000: 'google/gemini-2.5-flash',
           },
         }),

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

@@ -179,7 +179,7 @@ export const agent = new Agent({
   memory: new Memory({
     options: {
       generateTitle: {
-        model: 'openai/gpt-5-mini',
+        model: '__OPENAI_MODEL_MINI__',
         instructions: 'Generate a 1 word title',
       },
     },

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

@@ -674,7 +674,7 @@ import { ModelByInputTokens } from '@mastra/memory'
 const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
-    40_000: 'openai/gpt-5.4-mini', // Stronger for medium inputs
+    40_000: 'openai/gpt-5-mini', // Stronger for medium inputs
     1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
   },
 })

package/dist/docs/references/reference-storage-dsql.md

@@ -241,7 +241,7 @@ export const dsqlAgent = new Agent({
   name: 'DSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new DSQLStore({
       id: 'dsql-agent-storage',

package/dist/docs/references/reference-storage-redis.md

@@ -181,7 +181,7 @@ export const redisAgent = new Agent({
   name: 'Redis Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new RedisStore({
       id: 'redis-agent-storage',

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk5IJQOXJM_cjs = require('./chunk-5IJQOXJM.cjs');
+var chunkPNKMNTE6_cjs = require('./chunk-PNKMNTE6.cjs');
 var v3 = require('zod/v3');
 var zod = require('zod');
 var z4 = require('zod/v4');
@@ -16056,7 +16056,7 @@ function formatTimestamp(date) {
 }
 function truncateByTokens(text4, maxTokens, hint) {
   if (tokenx.estimateTokenCount(text4) <= maxTokens) return { text: text4, wasTruncated: false };
-  const truncated = chunk5IJQOXJM_cjs.truncateStringByTokens(text4, maxTokens);
+  const truncated = chunkPNKMNTE6_cjs.truncateStringByTokens(text4, maxTokens);
   const suffix = hint ? ` [${hint} for more]` : "";
   return { text: truncated + suffix, wasTruncated: true };
 }
@@ -16108,11 +16108,11 @@ ${JSON.stringify(inv.args, null, 2)}`;
             });
           }
           if (inv.state === "result") {
-            const { value: resultValue } = chunk5IJQOXJM_cjs.resolveToolResultValue(
+            const { value: resultValue } = chunkPNKMNTE6_cjs.resolveToolResultValue(
               part,
               inv.result
             );
-            const resultStr = chunk5IJQOXJM_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+            const resultStr = chunkPNKMNTE6_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));
@@ -16139,7 +16139,7 @@ ${typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs, null, 2)}`;
         const toolName = part.toolName;
         if (toolName) {
           const rawResult = part.output ?? part.result;
-          const resultStr = chunk5IJQOXJM_cjs.formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const resultStr = chunkPNKMNTE6_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));
@@ -16218,7 +16218,7 @@ function renderFormattedParts(parts, timestamps, options) {
   const text4 = buildRenderedText(parts, timestamps);
   let totalTokens = tokenx.estimateTokenCount(text4);
   if (totalTokens > options.maxTokens) {
-    const truncated = chunk5IJQOXJM_cjs.truncateStringByTokens(text4, options.maxTokens);
+    const truncated = chunkPNKMNTE6_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));
@@ -16251,7 +16251,7 @@ function renderFormattedParts(parts, timestamps, options) {
   if (expandedTokens <= options.maxTokens) {
     return { text: expanded, truncated: false, tokenOffset: 0 };
   }
-  const hardTruncated = chunk5IJQOXJM_cjs.truncateStringByTokens(expanded, options.maxTokens);
+  const hardTruncated = chunkPNKMNTE6_cjs.truncateStringByTokens(expanded, options.maxTokens);
   return { text: hardTruncated, truncated: true, tokenOffset: expandedTokens - options.maxTokens };
 }
 async function recallPart({
@@ -16302,7 +16302,7 @@ async function recallPart({
 
 `;
           const fallbackText = `${fallbackNote}${firstNextPart.text}`;
-          const truncatedText2 = chunk5IJQOXJM_cjs.truncateStringByTokens(fallbackText, maxTokens);
+          const truncatedText2 = chunkPNKMNTE6_cjs.truncateStringByTokens(fallbackText, maxTokens);
           const wasTruncated2 = truncatedText2 !== fallbackText;
           return {
             text: truncatedText2,
@@ -16317,7 +16317,7 @@ async function recallPart({
     }
     throw new Error(`Part index ${partIndex} not found in message ${cursor}. Available indices: ${availableIndices}`);
   }
-  const truncatedText = chunk5IJQOXJM_cjs.truncateStringByTokens(target.text, maxTokens);
+  const truncatedText = chunkPNKMNTE6_cjs.truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
   return {
     text: truncatedText,
@@ -18079,7 +18079,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-V2APY3TO.cjs');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-25PDEXBJ.cjs');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -18104,7 +18104,8 @@ ${workingMemory}`;
         blockAfter: omConfig.observation.blockAfter,
         previousObserverTokens: omConfig.observation.previousObserverTokens,
         instruction: omConfig.observation.instruction,
-        threadTitle: omConfig.observation.threadTitle
+        threadTitle: omConfig.observation.threadTitle,
+        observeAttachments: omConfig.observation.observeAttachments
       } : void 0,
       reflection: omConfig.reflection ? {
         model: omConfig.reflection.model,
@@ -19005,7 +19006,7 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-V2APY3TO.cjs');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-25PDEXBJ.cjs');
     return new ObservationalMemoryProcessor(engine, this, {
       temporalMarkers: effectiveConfig.temporalMarkers
     });
@@ -19014,11 +19015,11 @@ Notes:
 
 Object.defineProperty(exports, "ModelByInputTokens", {
   enumerable: true,
-  get: function () { return chunk5IJQOXJM_cjs.ModelByInputTokens; }
+  get: function () { return chunkPNKMNTE6_cjs.ModelByInputTokens; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunk5IJQOXJM_cjs.getObservationsAsOf; }
+  get: function () { return chunkPNKMNTE6_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "MessageHistory", {
   enumerable: true,