@mastra/memory 1.3.0 → 1.4.0-alpha.0

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,71 +1,71 @@
 {
-  "version": "1.3.0",
+  "version": "1.4.0-alpha.0",
   "package": "@mastra/memory",
   "exports": {
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js"
+      "implementation": "dist/chunk-D4AWAGLM.js"
     },
     "OBSERVATION_CONTEXT_INSTRUCTIONS": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js"
+      "implementation": "dist/chunk-D4AWAGLM.js"
     },
     "OBSERVATION_CONTEXT_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js"
+      "implementation": "dist/chunk-D4AWAGLM.js"
     },
     "OBSERVATION_CONTINUATION_HINT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js"
+      "implementation": "dist/chunk-D4AWAGLM.js"
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js"
+      "implementation": "dist/chunk-D4AWAGLM.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 1294
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 1273
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 957
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 936
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 646
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 606
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 405
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 357
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 732
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 692
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 492
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 452
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 720
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 680
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 743
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 703
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-F5P5HTMC.js",
-      "line": 677
+      "implementation": "dist/chunk-D4AWAGLM.js",
+      "line": 637
     },
     "extractWorkingMemoryContent": {
       "types": "dist/index.d.ts",
@@ -96,7 +96,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-F5P5HTMC.js"
+        "chunk-D4AWAGLM.js"
       ]
     }
   }

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

@@ -42,6 +42,8 @@ The `observationalMemory` option accepts `true`, a configuration object, or `fal
 
 **model?:** (`string | LanguageModel | DynamicModel | ModelWithRetries[]`): Model for the Observer agent. Cannot be set if a top-level \`model\` is also provided. If neither this nor the top-level \`model\` is set, falls back to \`reflection.model\`.
 
+**instruction?:** (`string`): Custom instruction appended to the Observer's system prompt. Use this to customize what the Observer focuses on, such as domain-specific preferences or priorities.
+
 **messageTokens?:** (`number`): Token count of unobserved messages that triggers observation. When unobserved message tokens exceed this threshold, the Observer agent is called. (Default: `30000`)
 
 **maxTokensPerBatch?:** (`number`): Maximum tokens per batch when observing multiple threads in resource scope. Threads are chunked into batches of this size and processed in parallel. Lower values mean more parallelism but more API calls. (Default: `10000`)
@@ -58,6 +60,8 @@ The `observationalMemory` option accepts `true`, a configuration object, or `fal
 
 **model?:** (`string | LanguageModel | DynamicModel | ModelWithRetries[]`): Model for the Reflector agent. Cannot be set if a top-level \`model\` is also provided. If neither this nor the top-level \`model\` is set, falls back to \`observation.model\`.
 
+**instruction?:** (`string`): Custom instruction appended to the Reflector's system prompt. Use this to customize how the Reflector consolidates observations, such as prioritizing certain types of information.
+
 **observationTokens?:** (`number`): Token count of observations that triggers reflection. When observation tokens exceed this threshold, the Reflector agent is called to condense them. (Default: `40000`)
 
 **modelSettings?:** (`ObservationalMemoryModelSettings`): Model settings for the Reflector agent. (Default: `{ temperature: 0, maxOutputTokens: 100_000 }`)
@@ -175,6 +179,38 @@ export const agent = new Agent({
 });
 ```
 
+### Custom instructions
+
+Customize what the Observer and Reflector focus on by providing custom instructions:
+
+```typescript
+import { Memory } from "@mastra/memory";
+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",
+  memory: new Memory({
+    options: {
+      observationalMemory: {
+        model: "google/gemini-2.5-flash",
+        observation: {
+          // Focus observations on health-related preferences and goals
+          instruction:
+            "Prioritize capturing user health goals, dietary restrictions, exercise preferences, and medical considerations. Avoid capturing general chit-chat.",
+        },
+        reflection: {
+          // Guide reflection to consolidate health patterns
+          instruction:
+            "When consolidating, group related health information together. Preserve specific metrics, dates, and medical details.",
+        },
+      },
+    },
+  }),
+});
+```
+
 ### Async buffering
 
 Async buffering is **enabled by default**. It pre-computes observations in the background as the conversation grows — when the `messageTokens` threshold is reached, buffered observations activate instantly with no blocking LLM call.

package/dist/index.cjs

@@ -15229,7 +15229,7 @@ var Memory = class extends memory.MastraMemory {
       }
       await memoryStore.updateThread({
         id: threadId,
-        title: thread.title || "Untitled Thread",
+        title: thread.title || "",
         metadata: {
           ...thread.metadata,
           workingMemory
@@ -15309,7 +15309,7 @@ ${workingMemory}`;
         }
         await memoryStore.updateThread({
           id: threadId,
-          title: thread.title || "Untitled Thread",
+          title: thread.title || "",
           metadata: {
             ...thread.metadata,
             workingMemory
@@ -16146,7 +16146,7 @@ Notes:
         "Observational memory async buffering is enabled by default but the installed version of @mastra/core does not support it. Either upgrade @mastra/core, @mastra/memory, and your storage adapter (@mastra/libsql, @mastra/pg, or @mastra/mongodb) to the latest version, or explicitly disable async buffering by setting `observation: { bufferTokens: false }` in your observationalMemory config."
       );
     }
-    const { ObservationalMemory } = await import('./observational-memory-SA5RITIG.cjs');
+    const { ObservationalMemory } = await import('./observational-memory-UCOMAMSF.cjs');
     return new ObservationalMemory({
       storage: memoryStore,
       scope: omConfig.scope,
@@ -16160,7 +16160,8 @@ Notes:
         providerOptions: omConfig.observation.providerOptions,
         bufferTokens: omConfig.observation.bufferTokens,
         bufferActivation: omConfig.observation.bufferActivation,
-        blockAfter: omConfig.observation.blockAfter
+        blockAfter: omConfig.observation.blockAfter,
+        instruction: omConfig.observation.instruction
       } : void 0,
       reflection: omConfig.reflection ? {
         model: omConfig.reflection.model,
@@ -16168,7 +16169,8 @@ Notes:
         modelSettings: omConfig.reflection.modelSettings,
         providerOptions: omConfig.reflection.providerOptions,
         bufferActivation: omConfig.reflection.bufferActivation,
-        blockAfter: omConfig.reflection.blockAfter
+        blockAfter: omConfig.reflection.blockAfter,
+        instruction: omConfig.reflection.instruction
       } : void 0
     });
   }