@mastra/memory 1.17.6-alpha.1 → 1.18.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @mastra/memory
 
+## 1.18.0-alpha.3
+
+### Patch Changes
+
+- Default top-level observational memory early activation settings to observations only, while allowing per-phase overrides under `observation` and `reflection`. ([#16367](https://github.com/mastra-ai/mastra/pull/16367))
+
+- Updated dependencies [[`7c275a8`](https://github.com/mastra-ai/mastra/commit/7c275a810595e1a6c41ccc39720531ab65734700), [`890b24c`](https://github.com/mastra-ai/mastra/commit/890b24cc7d32ed6aa4dfe253e54dc6bf4099f690), [`0f48ebf`](https://github.com/mastra-ai/mastra/commit/0f48ebfc7ac7897b2092a189f45751924cf56d1c), [`f180e49`](https://github.com/mastra-ai/mastra/commit/f180e4990e71b04c9a475b523584071712f0048f), [`9260e01`](https://github.com/mastra-ai/mastra/commit/9260e015276fb1b500f7878ee452b47476bf1583), [`2f6c54e`](https://github.com/mastra-ai/mastra/commit/2f6c54e17c041cac1def54baaa6b771647836414), [`e06a159`](https://github.com/mastra-ai/mastra/commit/e06a1598ca07a6c3778aefc2a2d288363c6294ff), [`c50ebc3`](https://github.com/mastra-ai/mastra/commit/c50ebc34da71044558315735e69bfb94fcfb74bf), [`db34bc6`](https://github.com/mastra-ai/mastra/commit/db34bc6fb36cf125bda0c46be4d3fdc774b70cc4)]:
+  - @mastra/core@1.33.0-alpha.8
+  - @mastra/schema-compat@1.2.10-alpha.0
+
+## 1.18.0-alpha.2
+
+### Minor Changes
+
+- Add metadata filtering support to semantic recall. ([#9256](https://github.com/mastra-ai/mastra/pull/9256))
+
+### Patch Changes
+
+- Fixed read-only observational memory so existing context is still loaded. ([#16059](https://github.com/mastra-ai/mastra/pull/16059))
+
+- Updated dependencies [[`6742347`](https://github.com/mastra-ai/mastra/commit/6742347d71955d7639adc9ddf6ff8282de7ee3ba), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`62666c3`](https://github.com/mastra-ai/mastra/commit/62666c367eaeac3941ead454b1d38810cc855721), [`4af2160`](https://github.com/mastra-ai/mastra/commit/4af2160322f4718cac421930cce85641e9512389), [`136c959`](https://github.com/mastra-ai/mastra/commit/136c9592fb0eeb0cd212f28629d8a29b7557a2fc), [`4df7cc7`](https://github.com/mastra-ai/mastra/commit/4df7cc79342fd065fe7fdeef93c094db14b12bcd), [`aca3121`](https://github.com/mastra-ai/mastra/commit/aca31211233dac25459f140ea4fcfb3a5af64c18), [`9cdf38e`](https://github.com/mastra-ai/mastra/commit/9cdf38e58506e1109c8b38f97cd7770978a4218e), [`990851e`](https://github.com/mastra-ai/mastra/commit/990851edcb0e30be5c2c18b6532f1a876cc2d335), [`6068a6c`](https://github.com/mastra-ai/mastra/commit/6068a6c42950fad3ebfc92346417896ba60803d2), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`e2a079c`](https://github.com/mastra-ai/mastra/commit/e2a079cc3755b1895f7bd5dc36e9be81b11c7c22), [`534a456`](https://github.com/mastra-ai/mastra/commit/534a456a25e4df1e5407e7e632f4cb3b1fa14f9d), [`36bae07`](https://github.com/mastra-ai/mastra/commit/36bae07c0e70b1b3006f2fd20830e8883dcbd066)]:
+  - @mastra/core@1.33.0-alpha.7
+
 ## 1.17.6-alpha.1
 
 ### Patch Changes

package/dist/{chunk-WNLFJKTX.cjs → chunk-ET2TVAT3.cjs}

@@ -2029,6 +2029,22 @@ ObservationStrategy.create = ((om, opts) => {
   if (deps.scope === "resource" && opts.resourceId) return new ResourceScopedObservationStrategy(deps, opts);
   return new SyncObservationStrategy(deps, opts);
 });
+
+// src/processors/observational-memory/observation-turn/load-memory-context.ts
+async function loadMemoryContextMessages({
+  memory,
+  messageList,
+  threadId,
+  resourceId
+}) {
+  const ctx = await memory.getContext({ threadId, resourceId });
+  for (const msg of ctx.messages) {
+    if (msg.role !== "system") {
+      messageList.add(msg, "memory");
+    }
+  }
+  return ctx;
+}
 var ObservationStep = class {
   constructor(turn, stepNumber) {
     this.turn = turn;
@@ -2396,12 +2412,12 @@ var ObservationTurn = class {
     this._generationCountAtStart = this._record.generationCount;
     this.memory = memory;
     if (memory) {
-      const ctx = await memory.getContext({ threadId: this.threadId, resourceId: this.resourceId });
-      for (const msg of ctx.messages) {
-        if (msg.role !== "system") {
-          this.messageList.add(msg, "memory");
-        }
-      }
+      const ctx = await loadMemoryContextMessages({
+        memory,
+        messageList: this.messageList,
+        threadId: this.threadId,
+        resourceId: this.resourceId
+      });
       this._context = {
         messages: ctx.messages,
         systemMessage: ctx.systemMessage,
@@ -6650,7 +6666,7 @@ function getCurrentModel2(model) {
   return formatModelContext2(model?.provider, model?.modelId);
 }
 function parseActivationTTL(value, fieldPath) {
-  if (value === void 0) {
+  if (value === void 0 || value === false) {
     return void 0;
   }
   if (typeof value === "number") {
@@ -6798,6 +6814,8 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
         );
       }
     }
+    const observationActivateAfterIdle = config.observation?.activateAfterIdle ?? config.activateAfterIdle;
+    const observationActivateAfterIdlePath = config.observation?.activateAfterIdle !== void 0 ? "observation.activateAfterIdle" : "activateAfterIdle";
     this.observationConfig = {
       model: observationModel,
       // When shared budget, store as range: min = base threshold, max = total budget
@@ -6815,8 +6833,8 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
         config.observation?.messageTokens ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.observation.messageTokens
       ),
       bufferActivation: asyncBufferingDisabled ? void 0 : config.observation?.bufferActivation ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.observation.bufferActivation,
-      activateAfterIdle: parseActivationTTL(config.activateAfterIdle, "activateAfterIdle"),
-      activateOnProviderChange: config.activateOnProviderChange ?? false,
+      activateAfterIdle: parseActivationTTL(observationActivateAfterIdle, observationActivateAfterIdlePath),
+      activateOnProviderChange: config.observation?.activateOnProviderChange ?? config.activateOnProviderChange ?? false,
       blockAfter: asyncBufferingDisabled ? void 0 : resolveBlockAfter(
         config.observation?.blockAfter ?? (config.observation?.bufferTokens ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.observation.bufferTokens ? 1.2 : void 0),
         config.observation?.messageTokens ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.observation.messageTokens
@@ -6835,8 +6853,8 @@ Async buffering is enabled by default \u2014 this opt-out is only needed when us
       },
       providerOptions: config.reflection?.providerOptions ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.reflection.providerOptions,
       bufferActivation: asyncBufferingDisabled ? void 0 : config?.reflection?.bufferActivation ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.reflection.bufferActivation,
-      activateAfterIdle: parseActivationTTL(config.activateAfterIdle, "activateAfterIdle"),
-      activateOnProviderChange: config.activateOnProviderChange ?? false,
+      activateAfterIdle: parseActivationTTL(config.reflection?.activateAfterIdle, "reflection.activateAfterIdle"),
+      activateOnProviderChange: config.reflection?.activateOnProviderChange ?? false,
       blockAfter: asyncBufferingDisabled ? void 0 : resolveBlockAfter(
         config.reflection?.blockAfter ?? (config.reflection?.bufferActivation ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.reflection.bufferActivation ? 1.2 : void 0),
         config.reflection?.observationTokens ?? chunkD4J4XPGM_cjs.OBSERVATIONAL_MEMORY_DEFAULTS.reflection.observationTokens
@@ -9223,6 +9241,33 @@ var GATEWAY_STATE_KEY = "__isGatewayModel";
 function isMastraGatewayModel(model) {
   return typeof model === "object" && model !== null && "gatewayId" in model && model.gatewayId === "mastra";
 }
+function injectObservationContextMessages({
+  messageList,
+  systemMessages,
+  continuationMessage,
+  threadId,
+  resourceId
+}) {
+  if (!systemMessages?.length) {
+    return;
+  }
+  messageList.clearSystemMessages("observational-memory");
+  for (const msg of systemMessages) {
+    messageList.addSystem(msg, "observational-memory");
+  }
+  const contMsg = continuationMessage ?? {
+    id: "om-continuation",
+    role: "user",
+    createdAt: /* @__PURE__ */ new Date(0),
+    content: {
+      format: 2,
+      parts: [{ type: "text", text: `<system-reminder>${chunkD4J4XPGM_cjs.OBSERVATION_CONTINUATION_HINT}</system-reminder>` }]
+    },
+    threadId,
+    resourceId
+  };
+  messageList.add(contMsg, "memory");
+}
 var ObservationalMemoryProcessor = class {
   id = "observational-memory";
   name = "Observational Memory";
@@ -9277,6 +9322,25 @@ var ObservationalMemoryProcessor = class {
       const preMessagesSnapshot = reproCaptureEnabled ? safeCaptureJson(messageList.get.all.db()) : null;
       const preSerializedMessageList = reproCaptureEnabled ? safeCaptureJson(messageList.serialize()) : null;
       if (readOnly) {
+        const ctx = await loadMemoryContextMessages({
+          memory: this.memory,
+          messageList,
+          threadId,
+          resourceId
+        });
+        const systemMessages = ctx.hasObservations && ctx.omRecord ? await this.engine.buildContextSystemMessages({
+          threadId,
+          resourceId,
+          record: ctx.omRecord,
+          unobservedContextBlocks: ctx.otherThreadsContext
+        }) : void 0;
+        injectObservationContextMessages({
+          messageList,
+          systemMessages,
+          continuationMessage: ctx.continuationMessage,
+          threadId,
+          resourceId
+        });
         return messageList;
       }
       const activeTurn = state.__omTurn ?? this.turn;
@@ -9332,26 +9396,13 @@ var ObservationalMemoryProcessor = class {
           }
           throw err;
         }
-        if (ctx.systemMessage) {
-          messageList.clearSystemMessages("observational-memory");
-          for (const msg of ctx.systemMessage) {
-            messageList.addSystem(msg, "observational-memory");
-          }
-          const contMsg = this.turn.context.continuation ?? {
-            id: "om-continuation",
-            role: "user",
-            createdAt: /* @__PURE__ */ new Date(0),
-            content: {
-              format: 2,
-              parts: [
-                { type: "text", text: `<system-reminder>${chunkD4J4XPGM_cjs.OBSERVATION_CONTINUATION_HINT}</system-reminder>` }
-              ]
-            },
-            threadId,
-            resourceId
-          };
-          messageList.add(contMsg, "memory");
-        }
+        injectObservationContextMessages({
+          messageList,
+          systemMessages: ctx.systemMessage,
+          continuationMessage: this.turn.context.continuation,
+          threadId,
+          resourceId
+        });
         const freshRecord = await this.engine.getOrCreateRecord(threadId, resourceId);
         await this.engine.emitProgress({
           record: freshRecord,
@@ -9477,5 +9528,5 @@ exports.stripEphemeralAnchorIds = stripEphemeralAnchorIds;
 exports.stripObservationGroups = stripObservationGroups;
 exports.truncateStringByTokens = truncateStringByTokens;
 exports.wrapInObservationGroup = wrapInObservationGroup;
-//# sourceMappingURL=chunk-WNLFJKTX.cjs.map
-//# sourceMappingURL=chunk-WNLFJKTX.cjs.map
+//# sourceMappingURL=chunk-ET2TVAT3.cjs.map
+//# sourceMappingURL=chunk-ET2TVAT3.cjs.map