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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,119 +1,119 @@
 {
-  "version": "1.15.0",
+  "version": "1.15.1-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 666
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js"
+      "implementation": "dist/chunk-HAEQMUD4.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 6230
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 8629
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 5782
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3412
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 2811
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 758
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 792
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3526
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3138
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 8814
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3514
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 2368
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3537
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 2341
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 727
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 3422
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 816
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 772
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 2398
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 749
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-42AZEBIK.js",
+      "implementation": "dist/chunk-HAEQMUD4.js",
       "line": 720
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
@@ -161,7 +161,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-42AZEBIK.js",
+        "chunk-HAEQMUD4.js",
         "chunk-LSJJAJAF.js"
       ]
     }

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

@@ -307,8 +307,8 @@ Both scenarios are safe - guardrails prevent inappropriate content from being pe
 
 ## Related documentation
 
-- [Processors](https://mastra.ai/docs/agents/processors) - General processor concepts and custom processor creation
-- [Guardrails](https://mastra.ai/docs/agents/guardrails) - Security and validation processors
-- [Memory Overview](https://mastra.ai/docs/memory/overview) - Memory types and configuration
+- [Processors](https://mastra.ai/docs/agents/processors): General processor concepts and custom processor creation
+- [Guardrails](https://mastra.ai/docs/agents/guardrails): Security and validation processors
+- [Memory Overview](https://mastra.ai/docs/memory/overview): Memory types and configuration
 
 When creating custom processors avoid mutating the input `messages` array or its objects directly.

package/dist/docs/references/docs-memory-message-history.md

@@ -100,8 +100,8 @@ await agent.stream('Hello', {
 
 You can use this history in two ways:
 
-- **Automatic inclusion** - Mastra automatically fetches and includes recent messages in the context window. By default, it includes the last 10 messages, keeping agents grounded in the conversation. You can adjust this number with `lastMessages`, but in most cases you don't need to think about it.
-- [**Manual querying**](#querying) - For more control, use the `recall()` function to query threads and messages directly. This lets you choose exactly which memories are included in the context window, or fetch messages to render conversation history in your UI.
+- **Automatic inclusion**: Mastra automatically fetches and includes recent messages in the context window. By default, it includes the last 10 messages, keeping agents grounded in the conversation. You can adjust this number with `lastMessages`, but in most cases you don't need to think about it.
+- [**Manual querying**](#querying): For more control, use the `recall()` function to query threads and messages directly. This lets you choose exactly which memories are included in the context window, or fetch messages to render conversation history in your UI.
 
 > **Tip:** When memory is enabled, [Studio](https://mastra.ai/docs/studio/overview) uses message history to display past conversations in the chat sidebar.
 

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

@@ -157,7 +157,7 @@ With retrieval mode enabled, OM:
 - Registers a `recall` tool the agent can call to:
 
   - Page through the raw messages behind any observation group range
-  - Search by semantic similarity (`mode: "search"` with a `query` string) — requires `vector: true`
+  - Search by semantic similarity (`mode: "search"` with a `query` string); requires `vector: true`
   - List all threads (`mode: "threads"`), browse other threads (`threadId`), and search across all threads (default `scope: 'resource'`)
   - When `scope: 'thread'`: restrict browsing and search to the current thread only
 

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

@@ -118,8 +118,6 @@ export const agent = new Agent({
 })
 ```
 
-> **Warning:** Agent-level storage isn't supported when using [Mastra Cloud Store](https://mastra.ai/docs/mastra-cloud/deployment). If you use Mastra Cloud Store, configure storage on the Mastra instance instead. This limitation doesn't apply if you bring your own database.
-
 ## Threads and resources
 
 Mastra organizes conversations using two identifiers:

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

@@ -397,4 +397,4 @@ const response = await agent.generate('What do you know about me?', {
 
 - [Working memory with template](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-template)
 - [Working memory with schema](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-schema)
-- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example) - Complete example showing resource-scoped memory persistence
+- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example): Complete example showing resource-scoped memory persistence

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkCK4U3AYR_cjs = require('./chunk-CK4U3AYR.cjs');
 var chunkIDRQZVB4_cjs = require('./chunk-IDRQZVB4.cjs');
-var chunkWNLRMAHY_cjs = require('./chunk-WNLRMAHY.cjs');
+var chunkOUMWCVQI_cjs = require('./chunk-OUMWCVQI.cjs');
 var v3 = require('zod/v3');
 var zod = require('zod');
 var z4 = require('zod/v4');
@@ -15709,7 +15709,7 @@ function formatTimestamp(date) {
 }
 function truncateByTokens(text4, maxTokens, hint) {
   if (tokenx.estimateTokenCount(text4) <= maxTokens) return { text: text4, wasTruncated: false };
-  const truncated = chunkWNLRMAHY_cjs.truncateStringByTokens(text4, maxTokens);
+  const truncated = chunkOUMWCVQI_cjs.truncateStringByTokens(text4, maxTokens);
   const suffix = hint ? ` [${hint} for more]` : "";
   return { text: truncated + suffix, wasTruncated: true };
 }
@@ -15761,11 +15761,11 @@ ${JSON.stringify(inv.args, null, 2)}`;
             });
           }
           if (inv.state === "result") {
-            const { value: resultValue } = chunkWNLRMAHY_cjs.resolveToolResultValue(
+            const { value: resultValue } = chunkOUMWCVQI_cjs.resolveToolResultValue(
               part,
               inv.result
             );
-            const resultStr = chunkWNLRMAHY_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+            const resultStr = chunkOUMWCVQI_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));
@@ -15792,7 +15792,7 @@ ${typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs, null, 2)}`;
         const toolName = part.toolName;
         if (toolName) {
           const rawResult = part.output ?? part.result;
-          const resultStr = chunkWNLRMAHY_cjs.formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const resultStr = chunkOUMWCVQI_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));
@@ -15871,7 +15871,7 @@ function renderFormattedParts(parts, timestamps, options) {
   const text4 = buildRenderedText(parts, timestamps);
   let totalTokens = tokenx.estimateTokenCount(text4);
   if (totalTokens > options.maxTokens) {
-    const truncated = chunkWNLRMAHY_cjs.truncateStringByTokens(text4, options.maxTokens);
+    const truncated = chunkOUMWCVQI_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));
@@ -15904,7 +15904,7 @@ function renderFormattedParts(parts, timestamps, options) {
   if (expandedTokens <= options.maxTokens) {
     return { text: expanded, truncated: false, tokenOffset: 0 };
   }
-  const hardTruncated = chunkWNLRMAHY_cjs.truncateStringByTokens(expanded, options.maxTokens);
+  const hardTruncated = chunkOUMWCVQI_cjs.truncateStringByTokens(expanded, options.maxTokens);
   return { text: hardTruncated, truncated: true, tokenOffset: expandedTokens - options.maxTokens };
 }
 async function recallPart({
@@ -15955,7 +15955,7 @@ async function recallPart({
 
 `;
           const fallbackText = `${fallbackNote}${firstNextPart.text}`;
-          const truncatedText2 = chunkWNLRMAHY_cjs.truncateStringByTokens(fallbackText, maxTokens);
+          const truncatedText2 = chunkOUMWCVQI_cjs.truncateStringByTokens(fallbackText, maxTokens);
           const wasTruncated2 = truncatedText2 !== fallbackText;
           return {
             text: truncatedText2,
@@ -15970,7 +15970,7 @@ async function recallPart({
     }
     throw new Error(`Part index ${partIndex} not found in message ${cursor}. Available indices: ${availableIndices}`);
   }
-  const truncatedText = chunkWNLRMAHY_cjs.truncateStringByTokens(target.text, maxTokens);
+  const truncatedText = chunkOUMWCVQI_cjs.truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
   return {
     text: truncatedText,
@@ -16453,6 +16453,25 @@ function deepMergeWorkingMemory(existing, update) {
   }
   return result;
 }
+function stripNullsFromOptional(value, schema) {
+  if (Array.isArray(value)) {
+    const itemSchema = schema.items ?? {};
+    return value.map((item) => stripNullsFromOptional(item, itemSchema));
+  }
+  if (typeof value === "object" && value !== null) {
+    const properties = schema.properties ?? {};
+    const required = schema.required ?? [];
+    const result = {};
+    for (const [key, propertyValue] of Object.entries(value)) {
+      if (propertyValue === null && !required.includes(key)) {
+        continue;
+      }
+      result[key] = stripNullsFromOptional(propertyValue, properties[key] ?? {});
+    }
+    return result;
+  }
+  return value;
+}
 var updateWorkingMemoryTool = (memoryConfig) => {
   const schema$2 = memoryConfig?.workingMemory?.schema;
   let inputSchema = zod.z.object({
@@ -16462,7 +16481,7 @@ var updateWorkingMemoryTool = (memoryConfig) => {
     const standardSchema2 = schema$1.isStandardSchemaWithJSON(schema$2) ? schema$2 : schema$1.toStandardSchema(schema$2);
     const jsonSchema4 = schema.standardSchemaToJSONSchema(standardSchema2, { io: "input" });
     delete jsonSchema4.$schema;
-    inputSchema = schema$1.toStandardSchema({
+    const wrappedSchema = schema$1.toStandardSchema({
       $schema: "http://json-schema.org/draft-07/schema#",
       type: "object",
       description: "The JSON formatted working memory content to store.",
@@ -16471,6 +16490,41 @@ var updateWorkingMemoryTool = (memoryConfig) => {
       },
       required: ["memory"]
     });
+    inputSchema = {
+      "~standard": {
+        version: 1,
+        vendor: "mastra",
+        validate: (value) => {
+          const wrappedResult = wrappedSchema["~standard"].validate(value);
+          if (wrappedResult instanceof Promise) {
+            return wrappedResult.then((result) => {
+              if (!("issues" in result) || !result.issues) {
+                return result;
+              }
+              if (!value || typeof value !== "object" || Array.isArray(value) || "memory" in value) {
+                return result;
+              }
+              return wrappedSchema["~standard"].validate({
+                memory: stripNullsFromOptional(value, jsonSchema4)
+              });
+            });
+          }
+          if (!("issues" in wrappedResult) || !wrappedResult.issues) {
+            return wrappedResult;
+          }
+          if (!value || typeof value !== "object" || Array.isArray(value) || "memory" in value) {
+            return wrappedResult;
+          }
+          return wrappedSchema["~standard"].validate({
+            memory: stripNullsFromOptional(value, jsonSchema4)
+          });
+        },
+        jsonSchema: {
+          input: (props) => wrappedSchema["~standard"].jsonSchema.input(props),
+          output: (props) => wrappedSchema["~standard"].jsonSchema.output(props)
+        }
+      }
+    };
   }
   const usesMergeSemantics = Boolean(schema$2);
   const description = schema$2 ? `Update the working memory with new information. Data is merged with existing memory - only include fields you want to add or update. To preserve existing data, omit the field entirely. Arrays are replaced entirely when provided, so pass the complete array or omit it to keep the existing values.` : `Update the working memory with new information. Any data not included will be overwritten. Always pass data as string to the memory field. Never pass an object.`;
@@ -17547,7 +17601,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-3RE2HCRV.cjs');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-TKXRH2LD.cjs');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -18470,18 +18524,18 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-3RE2HCRV.cjs');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-TKXRH2LD.cjs');
     return new ObservationalMemoryProcessor(engine, this);
   }
 };
 
 Object.defineProperty(exports, "ModelByInputTokens", {
   enumerable: true,
-  get: function () { return chunkWNLRMAHY_cjs.ModelByInputTokens; }
+  get: function () { return chunkOUMWCVQI_cjs.ModelByInputTokens; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunkWNLRMAHY_cjs.getObservationsAsOf; }
+  get: function () { return chunkOUMWCVQI_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "extractWorkingMemoryContent", {
   enumerable: true,