@mastra/memory 1.8.3-alpha.0 → 1.8.3-alpha.2

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.8.3-alpha.0"
+  version: "1.8.3-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,71 +1,76 @@
 {
-  "version": "1.8.3-alpha.0",
+  "version": "1.8.3-alpha.2",
   "package": "@mastra/memory",
   "exports": {
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js"
+      "implementation": "dist/chunk-4KPXPQX3.js"
     },
     "OBSERVATION_CONTEXT_INSTRUCTIONS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js"
+      "implementation": "dist/chunk-4KPXPQX3.js"
     },
     "OBSERVATION_CONTEXT_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js"
+      "implementation": "dist/chunk-4KPXPQX3.js"
     },
     "OBSERVATION_CONTINUATION_HINT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js"
+      "implementation": "dist/chunk-4KPXPQX3.js"
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js"
+      "implementation": "dist/chunk-4KPXPQX3.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 2966
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 3054
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 2447
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 2543
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 1068
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 1164
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 572
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 663
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 1176
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 1272
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 827
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 923
+    },
+    "getObservationsAsOf": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 7086
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 1164
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 1260
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 1187
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 1283
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-SUU4IAZJ.js",
-      "line": 1078
+      "implementation": "dist/chunk-4KPXPQX3.js",
+      "line": 1174
     },
     "extractWorkingMemoryContent": {
       "types": "dist/index.d.ts",
@@ -96,7 +101,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-SUU4IAZJ.js"
+        "chunk-4KPXPQX3.js"
       ]
     }
   }

package/dist/docs/references/docs-agents-agent-approval.md

@@ -278,7 +278,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { weatherTool },
   memory: new Memory(),
   defaultOptions: {
@@ -343,7 +343,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { weatherTool },
   memory: new Memory(),
   defaultOptions: {
@@ -445,7 +445,7 @@ const dataAgent = new Agent({
   id: 'data-agent',
   name: 'Data Agent',
   description: 'Handles database queries and user data retrieval',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { findUserTool },
 })
 
@@ -454,7 +454,7 @@ const supervisorAgent = new Agent({
   name: 'Supervisor Agent',
   instructions: `You coordinate data retrieval tasks.
     Delegate to data-agent for user lookups.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: { dataAgent },
   memory: new Memory(),
 })

package/dist/docs/references/docs-agents-network-approval.md

@@ -176,7 +176,7 @@ const routingAgent = new Agent({
   id: 'routing-agent',
   name: 'Routing Agent',
   instructions: 'You coordinate tasks across multiple agents',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { confirmationTool },
   memory: new Memory(),
   defaultNetworkOptions: {

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

@@ -48,7 +48,7 @@ export const routingAgent = new Agent({
       Always respond with a complete report—no bullet points.
       Write in full paragraphs, like a blog post.
       Do not answer with incomplete or uncertain information.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: {
     researchAgent,
     writingAgent,

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

@@ -24,20 +24,20 @@ import { LibSQLStore } from '@mastra/libsql'
 const researchAgent = new Agent({
   id: 'research-agent',
   description: 'Gathers factual information and returns bullet-point summaries.',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
 })
 
 const writingAgent = new Agent({
   id: 'writing-agent',
   description: 'Transforms research into well-structured articles.',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
 })
 
 const supervisor = new Agent({
   id: 'supervisor',
   instructions: `You coordinate research and writing using specialized agents.
     Delegate to research-agent for facts, then writing-agent for content.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: { researchAgent, writingAgent },
   memory: new Memory({
     storage: new LibSQLStore({ id: 'storage', url: 'file:mastra.db' }),

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

@@ -45,7 +45,7 @@ const agent = new Agent({
   id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -95,7 +95,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'semantic-agent',
   instructions: 'You are a helpful assistant with semantic memory',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -148,7 +148,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'working-memory-agent',
   instructions: 'You are an assistant with working memory',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -180,7 +180,7 @@ const customMessageHistory = new MessageHistory({
 const agent = new Agent({
   name: 'custom-memory-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({ id: 'memory-store', url: 'file:memory.db' }),
     lastMessages: 10, // This would normally add MessageHistory(10)
@@ -250,7 +250,7 @@ const contentBlocker = {
 const agent = new Agent({
   name: 'safe-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs BEFORE memory saves
   outputProcessors: [contentBlocker],
@@ -289,7 +289,7 @@ const inputValidator = {
 const agent = new Agent({
   name: 'validated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs AFTER memory loads history
   inputProcessors: [inputValidator],

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -28,7 +28,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory(),
 })
 ```

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

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

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

@@ -26,7 +26,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -268,7 +268,7 @@ Schema-based working memory uses **merge semantics**, meaning the agent only nee
 ## Choosing between template and schema
 
 - Use a **template** (Markdown) if you want the agent to maintain memory as a free-form text block, such as a user profile or scratchpad. Templates use **replace semantics** — the agent must provide the complete memory content on each update.
-- Use a **schema** if you need structured, type-safe data that can be validated and programmatically accessed as JSON. Schemas use **merge semantics** — the agent only provides fields to update, and existing fields are preserved.
+- Use a **schema** if you need structured, type-safe data that can be validated and programmatically accessed as JSON. The `workingMemory.schema` field accepts any `PublicSchema`-compatible schema (including Zod v3, Zod v4, JSON Schema, or already-standard schemas). Schemas use **merge semantics** — the agent only provides fields to update, and existing fields are preserved.
 - Only one mode can be active at a time: setting both `template` and `schema` isn't supported.
 
 ## Example: Multi-step retention

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

@@ -11,7 +11,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -60,7 +60,7 @@ import { LibSQLStore, LibSQLVector } from '@mastra/libsql'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'test-agent-storage',
@@ -97,7 +97,7 @@ import { PgStore, PgVector } from '@mastra/pg'
 export const agent = new Agent({
   name: 'pg-agent',
   instructions: 'You are an agent with optimized PostgreSQL memory.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new PgStore({
       id: 'pg-agent-storage',

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

@@ -159,11 +159,11 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       observationalMemory: {
-        model: 'openai/gpt-4o-mini',
+        model: 'openai/gpt-5-mini',
       },
     },
   }),
@@ -179,7 +179,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -187,7 +187,7 @@ export const agent = new Agent({
           model: 'google/gemini-2.5-flash',
         },
         reflection: {
-          model: 'openai/gpt-4o-mini',
+          model: 'openai/gpt-5-mini',
         },
       },
     },
@@ -206,7 +206,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'health-assistant',
   instructions: 'You are a health and wellness assistant.',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       observationalMemory: {

package/dist/docs/references/reference-processors-token-limiter-processor.md

@@ -79,7 +79,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'context-limited-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     /* ... */
   }),
@@ -100,7 +100,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'multi-step-agent',
   instructions: 'You are a helpful research assistant with access to tools',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new TokenLimiterProcessor({ limit: 8000 }), // Applied at every step
   ],
@@ -123,7 +123,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'response-limited-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   outputProcessors: [
     new TokenLimiterProcessor({
       limit: 1000,

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

@@ -206,7 +206,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-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 MongoDBStore({
       uri: process.env.MONGODB_URI!,

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

@@ -332,7 +332,7 @@ export const pgAgent = new Agent({
   name: 'PG 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 PostgresStore({
       id: 'pg-agent-storage',

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

@@ -103,7 +103,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash 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 UpstashStore({
       id: 'upstash-agent-storage',

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

@@ -277,7 +277,7 @@ export const libsqlAgent = new Agent({
   name: 'libSQL 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 LibSQLStore({
       id: 'libsql-agent-storage',

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

@@ -265,7 +265,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-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 MongoDBStore({
       id: 'mongodb-storage',

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

@@ -399,7 +399,7 @@ export const pgAgent = new Agent({
   name: 'PG 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 PostgresStore({
       id: 'pg-agent-storage',

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

@@ -265,7 +265,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash 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 UpstashStore({
       id: 'upstash-agent-storage',

package/dist/index.cjs

@@ -2,6 +2,7 @@
 
 var chunkCK4U3AYR_cjs = require('./chunk-CK4U3AYR.cjs');
 var chunkIDRQZVB4_cjs = require('./chunk-IDRQZVB4.cjs');
+var chunkLGCREJMO_cjs = require('./chunk-LGCREJMO.cjs');
 var v3 = require('zod/v3');
 var zod = require('zod');
 var z4 = require('zod/v4');
@@ -39,7 +40,7 @@ function _interopNamespace(e) {
 var z4__namespace = /*#__PURE__*/_interopNamespace(z4);
 var xxhash__default = /*#__PURE__*/_interopDefault(xxhash);
 
-// ../_vendored/ai_v4/dist/chunk-GBOGIFXJ.js
+// ../_vendored/ai_v4/dist/chunk-OPIPXJLE.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -15491,7 +15492,7 @@ var updateWorkingMemoryTool = (memoryConfig) => {
     });
   }
   const usesMergeSemantics = Boolean(schema$2);
-  const description = schema$2 ? `Update the working memory with new information. Data is merged with existing memory - you only need to include fields you want to add or update. Set a field to null to remove it. Arrays are replaced entirely when provided.` : `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.`;
+  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.`;
   return tools.createTool({
     id: "update-working-memory",
     description,
@@ -15972,14 +15973,15 @@ var Memory = class extends memory.MastraMemory {
       const existingWorkingMemory = await this.getWorkingMemory({ threadId, resourceId, memoryConfig }) || "";
       const template = await this.getWorkingMemoryTemplate({ memoryConfig });
       let reason = "";
+      const templateContent = typeof template?.content === "string" ? template.content : null;
       const normalizeForComparison = (str) => str.replace(/\s+/g, " ").trim();
       const normalizedNewMemory = normalizeForComparison(workingMemory);
-      const normalizedTemplate = template?.content ? normalizeForComparison(template.content) : "";
+      const normalizedTemplate = templateContent ? normalizeForComparison(templateContent) : "";
       if (existingWorkingMemory) {
         if (searchString && existingWorkingMemory?.includes(searchString)) {
           workingMemory = existingWorkingMemory.replace(searchString, workingMemory);
           reason = `found and replaced searchString with newMemory`;
-        } else if (existingWorkingMemory.includes(workingMemory) || template?.content?.trim() === workingMemory.trim() || // Also check normalized versions to catch template variations with different whitespace
+        } else if (existingWorkingMemory.includes(workingMemory) || templateContent?.trim() === workingMemory.trim() || // Also check normalized versions to catch template variations with different whitespace
         normalizedNewMemory === normalizedTemplate) {
           return {
             success: false,
@@ -16000,7 +16002,7 @@ var Memory = class extends memory.MastraMemory {
           workingMemory = existingWorkingMemory + `
 ${workingMemory}`;
         }
-      } else if (workingMemory === template?.content || normalizedNewMemory === normalizedTemplate) {
+      } else if (workingMemory === templateContent || normalizedNewMemory === normalizedTemplate) {
         return {
           success: false,
           reason: `try again when you have data to add. newMemory was equal to the working memory template`
@@ -16008,10 +16010,10 @@ ${workingMemory}`;
       } else {
         reason = `started new working memory`;
       }
-      if (template?.content) {
-        workingMemory = workingMemory.replaceAll(template.content, "");
-        const templateWithUnixLineEndings = template.content.replace(/\r\n/g, "\n");
-        const templateWithWindowsLineEndings = template.content.replace(/\n/g, "\r\n");
+      if (templateContent) {
+        workingMemory = workingMemory.replaceAll(templateContent, "");
+        const templateWithUnixLineEndings = templateContent.replace(/\r\n/g, "\n");
+        const templateWithWindowsLineEndings = templateContent.replace(/\n/g, "\r\n");
         workingMemory = workingMemory.replaceAll(templateWithUnixLineEndings, "");
         workingMemory = workingMemory.replaceAll(templateWithWindowsLineEndings, "");
       }
@@ -17013,7 +17015,7 @@ Notes:
         "Observational memory requires @mastra/core support for request-response-id-rotation. Please bump @mastra/core to a newer version."
       );
     }
-    const { ObservationalMemory } = await import('./observational-memory-3HFM7PY2.cjs');
+    const { ObservationalMemory } = await import('./observational-memory-4TV5KKFV.cjs');
     return new ObservationalMemory({
       storage: memoryStore,
       scope: omConfig.scope,
@@ -17044,6 +17046,10 @@ Notes:
   }
 };
 
+Object.defineProperty(exports, "getObservationsAsOf", {
+  enumerable: true,
+  get: function () { return chunkLGCREJMO_cjs.getObservationsAsOf; }
+});
 Object.defineProperty(exports, "extractWorkingMemoryContent", {
   enumerable: true,
   get: function () { return memory.extractWorkingMemoryContent; }