@mastra/memory 1.17.4 → 1.17.5-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.17.4"
+  version: "1.17.5-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,119 +1,119 @@
 {
-  "version": "1.17.4",
+  "version": "1.17.5-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 745
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js"
+      "implementation": "dist/chunk-BPJLUC2F.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
-      "line": 6573
+      "implementation": "dist/chunk-BPJLUC2F.js",
+      "line": 6598
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
-      "line": 9117
+      "implementation": "dist/chunk-BPJLUC2F.js",
+      "line": 9140
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
-      "line": 6043
+      "implementation": "dist/chunk-BPJLUC2F.js",
+      "line": 6068
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3567
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 2950
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 837
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 871
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3681
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3293
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
-      "line": 9323
+      "implementation": "dist/chunk-BPJLUC2F.js",
+      "line": 9346
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3669
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 2498
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3692
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 2471
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 806
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 3577
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 895
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 851
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 2528
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 828
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-4C4ERX6N.js",
+      "implementation": "dist/chunk-BPJLUC2F.js",
       "line": 799
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
@@ -149,7 +149,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-4C4ERX6N.js",
+        "chunk-BPJLUC2F.js",
         "chunk-LSJJAJAF.js"
       ]
     }

package/dist/docs/references/docs-agents-supervisor-agents.md

@@ -167,6 +167,22 @@ const stream = await supervisor.stream('Research AI trends', {
 
 The callback receives `messages` (the full conversation history), `primitiveId` (the subagent ID), and `prompt` (the delegation prompt). Return the filtered array of messages.
 
+## Subagent result context
+
+When a subagent completes, the supervisor model receives the subagent's text response in later iterations. Nested tool calls and subagent metadata, such as thread and resource IDs, are not added to the supervisor model context.
+
+Application code and UI integrations can still inspect the raw delegation result, including `subAgentToolResults`, from the tool result payload. This keeps debugging and display data available without sending nested tool arguments or outputs back into the supervisor's next model call.
+
+Set `includeSubAgentToolResultsInModelContext` to include the full subagent result, including nested tool results and subagent metadata, in the supervisor model context.
+
+```typescript
+await supervisor.generate('Research AI trends', {
+  delegation: {
+    includeSubAgentToolResultsInModelContext: true,
+  },
+})
+```
+
 ## Iteration monitoring
 
 `onIterationComplete` is called after each iteration of the supervisor loop. Use it to log progress, inject feedback, or stop execution early.

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

@@ -24,7 +24,7 @@ export const agent = new Agent({
 })
 ```
 
-That's it. The agent now has humanlike long-term memory that persists across conversations. Setting `observationalMemory: true` uses `google/gemini-2.5-flash` by default. To use a different model or customize thresholds, pass a config object instead:
+That's it. The agent now has humanlike long-term memory that persists across conversations. Setting `observationalMemory: true` uses `google/gemini-2.5-flash` by default. Config objects also use this model unless you set a different one. To use a different model, pass it in the config object:
 
 ```typescript
 const memory = new Memory({
@@ -44,7 +44,7 @@ See [configuration options](https://mastra.ai/reference/memory/observational-mem
 >
 > For an AI SDK example, see [Using Mastra Memory](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
 
-> **Note:** OM currently only supports `@mastra/pg`, `@mastra/libsql`, and `@mastra/mongodb` storage adapters. It uses background agents for managing memory. When using `observationalMemory: true`, the default model is `google/gemini-2.5-flash`. When passing a config object, a `model` must be explicitly set.
+> **Note:** OM currently only supports `@mastra/pg`, `@mastra/libsql`, and `@mastra/mongodb` storage adapters. It uses background agents for managing memory. When no model is set, the default model is `google/gemini-2.5-flash`.
 
 ## Temporal gap markers
 
@@ -212,7 +212,7 @@ The progress bars update live while the agent is observing or reflecting, showin
 
 ## Models
 
-The Observer and Reflector run in the background. Any model that works with Mastra's [model routing](https://mastra.ai/models) (`provider/model`) can be used. When using `observationalMemory: true`, the default model is `google/gemini-2.5-flash`. When passing a config object, a `model` must be explicitly set.
+The Observer and Reflector run in the background. Any model that works with Mastra's [model routing](https://mastra.ai/models) (`provider/model`) can be used. When no model is set, the default model is `google/gemini-2.5-flash`.
 
 Generally speaking, we recommend using a model that has a large context window (128K+ tokens) and is fast enough to run in the background without slowing down your actions.
 

package/dist/docs/references/reference-vectors-mongodb.md

@@ -107,8 +107,6 @@ Searches for similar vectors with optional metadata filtering.
 
 **includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
 
-**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
-
 ### `describeIndex()`
 
 Returns information about the index (collection).

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkM6QU3KKP_cjs = require('./chunk-M6QU3KKP.cjs');
+var chunkUZDSNIGD_cjs = require('./chunk-UZDSNIGD.cjs');
 var v3 = require('zod/v3');
 var zod = require('zod');
 var z4 = require('zod/v4');
@@ -15986,7 +15986,7 @@ function formatTimestamp(date) {
 }
 function truncateByTokens(text4, maxTokens, hint) {
   if (tokenx.estimateTokenCount(text4) <= maxTokens) return { text: text4, wasTruncated: false };
-  const truncated = chunkM6QU3KKP_cjs.truncateStringByTokens(text4, maxTokens);
+  const truncated = chunkUZDSNIGD_cjs.truncateStringByTokens(text4, maxTokens);
   const suffix = hint ? ` [${hint} for more]` : "";
   return { text: truncated + suffix, wasTruncated: true };
 }
@@ -16038,11 +16038,11 @@ ${JSON.stringify(inv.args, null, 2)}`;
             });
           }
           if (inv.state === "result") {
-            const { value: resultValue } = chunkM6QU3KKP_cjs.resolveToolResultValue(
+            const { value: resultValue } = chunkUZDSNIGD_cjs.resolveToolResultValue(
               part,
               inv.result
             );
-            const resultStr = chunkM6QU3KKP_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+            const resultStr = chunkUZDSNIGD_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));
@@ -16069,7 +16069,7 @@ ${typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs, null, 2)}`;
         const toolName = part.toolName;
         if (toolName) {
           const rawResult = part.output ?? part.result;
-          const resultStr = chunkM6QU3KKP_cjs.formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const resultStr = chunkUZDSNIGD_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));
@@ -16148,7 +16148,7 @@ function renderFormattedParts(parts, timestamps, options) {
   const text4 = buildRenderedText(parts, timestamps);
   let totalTokens = tokenx.estimateTokenCount(text4);
   if (totalTokens > options.maxTokens) {
-    const truncated = chunkM6QU3KKP_cjs.truncateStringByTokens(text4, options.maxTokens);
+    const truncated = chunkUZDSNIGD_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));
@@ -16181,7 +16181,7 @@ function renderFormattedParts(parts, timestamps, options) {
   if (expandedTokens <= options.maxTokens) {
     return { text: expanded, truncated: false, tokenOffset: 0 };
   }
-  const hardTruncated = chunkM6QU3KKP_cjs.truncateStringByTokens(expanded, options.maxTokens);
+  const hardTruncated = chunkUZDSNIGD_cjs.truncateStringByTokens(expanded, options.maxTokens);
   return { text: hardTruncated, truncated: true, tokenOffset: expandedTokens - options.maxTokens };
 }
 async function recallPart({
@@ -16232,7 +16232,7 @@ async function recallPart({
 
 `;
           const fallbackText = `${fallbackNote}${firstNextPart.text}`;
-          const truncatedText2 = chunkM6QU3KKP_cjs.truncateStringByTokens(fallbackText, maxTokens);
+          const truncatedText2 = chunkUZDSNIGD_cjs.truncateStringByTokens(fallbackText, maxTokens);
           const wasTruncated2 = truncatedText2 !== fallbackText;
           return {
             text: truncatedText2,
@@ -16247,7 +16247,7 @@ async function recallPart({
     }
     throw new Error(`Part index ${partIndex} not found in message ${cursor}. Available indices: ${availableIndices}`);
   }
-  const truncatedText = chunkM6QU3KKP_cjs.truncateStringByTokens(target.text, maxTokens);
+  const truncatedText = chunkUZDSNIGD_cjs.truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
   return {
     text: truncatedText,
@@ -17058,13 +17058,30 @@ var DEFAULT_TOP_K = 4;
 var VECTOR_DELETE_BATCH_SIZE = 100;
 var Memory = class extends memory.MastraMemory {
   _omEngine;
+  _omEngineInstance;
+  _mastraInstance;
   /** The shared ObservationalMemory engine. Lazily created on first access. */
   get omEngine() {
     if (!this._omEngine) {
-      this._omEngine = this._initOMEngine();
+      this._omEngine = this._initOMEngine().then((engine) => {
+        this._omEngineInstance = engine;
+        if (engine && this._mastraInstance) {
+          engine.__registerMastra(this._mastraInstance);
+        }
+        return engine;
+      });
     }
     return this._omEngine;
   }
+  __registerMastra(mastra) {
+    super.__registerMastra(mastra);
+    this._mastraInstance = mastra;
+    if (this._omEngineInstance) {
+      this._omEngineInstance.__registerMastra(mastra);
+    } else {
+      void this._omEngine?.then((engine) => engine?.__registerMastra(mastra));
+    }
+  }
   constructor(config = {}) {
     super({ name: "Memory", ...config });
     const mergedConfig = this.getMergedThreadConfig({
@@ -17951,7 +17968,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-TC2CBKCL.cjs');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-KWFKMLG6.cjs');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -17963,6 +17980,7 @@ ${workingMemory}`;
       activateOnProviderChange: omConfig.activateOnProviderChange,
       shareTokenBudget: omConfig.shareTokenBudget,
       model: omConfig.model,
+      mastra: this._mastraInstance,
       onIndexObservations,
       observation: omConfig.observation ? {
         model: omConfig.observation.model,
@@ -18876,7 +18894,7 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-TC2CBKCL.cjs');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-KWFKMLG6.cjs');
     return new ObservationalMemoryProcessor(engine, this, {
       temporalMarkers: effectiveConfig.temporalMarkers
     });
@@ -18885,11 +18903,11 @@ Notes:
 
 Object.defineProperty(exports, "ModelByInputTokens", {
   enumerable: true,
-  get: function () { return chunkM6QU3KKP_cjs.ModelByInputTokens; }
+  get: function () { return chunkUZDSNIGD_cjs.ModelByInputTokens; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunkM6QU3KKP_cjs.getObservationsAsOf; }
+  get: function () { return chunkUZDSNIGD_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "MessageHistory", {
   enumerable: true,