@mastra/memory 1.18.2 → 1.18.3-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/memory
 
+## 1.18.3-alpha.0
+
+### Patch Changes
+
+- feat(memory): start background buffering of unobserved messages when agent goes idle ([#16694](https://github.com/mastra-ai/mastra/pull/16694))
+
+  In OM buffering mode, when the agent goes idle (turn.end()), any unobserved messages are now buffered in the background via a fire-and-forget buffer() call. This ensures observations are computed proactively rather than waiting for the next turn's step.prepare().
+
 ## 1.18.2
 
 ### Patch Changes

package/dist/{chunk-4AQHFADP.cjs → chunk-BK3AYI7X.cjs}

@@ -2447,7 +2447,12 @@ var ObservationTurn = class {
     return this._currentStep;
   }
   /**
-   * Finalize the turn: save any remaining messages and return the latest record state.
+   * Finalize the turn: save any remaining messages and return the current cached record.
+   *
+   * When async observation buffering is enabled and there are unobserved messages,
+   * a background buffer operation is kicked off so that observations are computed
+   * proactively while the agent is idle, rather than waiting for the next turn.
+   * The returned record does not wait for that background buffering pass to finish.
    */
   async end() {
     if (this._ended) throw new Error("Turn already ended");
@@ -2458,6 +2463,24 @@ var ObservationTurn = class {
     if (unsavedMessages.length > 0) {
       await this.om.persistMessages(unsavedMessages, this.threadId, this.resourceId);
     }
+    if (this.om.buffering.isAsyncObservationEnabled()) {
+      const allMessages = this.messageList.get.all.db();
+      const record = this._record;
+      const unobservedMessages = this.om.getUnobservedMessages(allMessages, record);
+      if (unobservedMessages.length > 0) {
+        void this.om.buffer({
+          threadId: this.threadId,
+          resourceId: this.resourceId,
+          messages: unobservedMessages,
+          record,
+          writer: this.writer,
+          requestContext: this.requestContext,
+          observabilityContext: this.observabilityContext
+        }).catch((err) => {
+          omDebug(`[OM:turn.end] idle buffer failed: ${err?.message}`);
+        });
+      }
+    }
     return { record: this._record };
   }
   /**
@@ -9737,5 +9760,5 @@ exports.stripEphemeralAnchorIds = stripEphemeralAnchorIds;
 exports.stripObservationGroups = stripObservationGroups;
 exports.truncateStringByTokens = truncateStringByTokens;
 exports.wrapInObservationGroup = wrapInObservationGroup;
-//# sourceMappingURL=chunk-4AQHFADP.cjs.map
-//# sourceMappingURL=chunk-4AQHFADP.cjs.map
+//# sourceMappingURL=chunk-BK3AYI7X.cjs.map
+//# sourceMappingURL=chunk-BK3AYI7X.cjs.map