@mastra/memory 1.15.1-alpha.0 → 1.15.1-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/memory
 
+## 1.15.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`4ba3bb1`](https://github.com/mastra-ai/mastra/commit/4ba3bb1e465ad2ddaba3bbf2bc47e0faec32985e), [`2a69802`](https://github.com/mastra-ai/mastra/commit/2a69802a0fc6d8a25a77fa6a42276e9d59a83914)]:
+  - @mastra/core@1.25.0-alpha.2
+  - @mastra/schema-compat@1.2.8-alpha.0
+
 ## 1.15.1-alpha.0
 
 ### Patch Changes

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.15.1-alpha.0",
+  "version": "1.15.1-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {

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-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

@@ -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.`;