@mastra/memory 1.12.1 → 1.13.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/memory
 
+## 1.13.0-alpha.0
+
+### Minor Changes
+
+- Added `loadUnobservedMessages({ threadId, resourceId? })` as a public method on `ObservationalMemory`. ([#14921](https://github.com/mastra-ai/mastra/pull/14921))
+
+  This lets external consumers (e.g. the Mastra gateway proxy) load previously-stored messages that haven't been observed yet, without having to reimplement the internal storage query and part-level filtering logic. The method fetches the OM record, queries storage for messages after the `lastObservedAt` cursor, and applies part-level filtering so partially-observed messages only return their unobserved parts.
+
+  ```ts
+  const unobserved = await om.loadUnobservedMessages({
+    threadId: 'thread-123',
+    resourceId: 'user-456',
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`13f4327`](https://github.com/mastra-ai/mastra/commit/13f4327f052faebe199cefbe906d33bf90238767)]:
+  - @mastra/core@1.21.0-alpha.1
+
 ## 1.12.1
 
 ### Patch Changes

package/dist/{chunk-HLGFIN4J.cjs → chunk-O3KNDDJV.cjs}

@@ -6715,7 +6715,7 @@ ${suggestedResponse}
    * In resource scope mode, loads messages for the entire resource (all threads).
    * In thread scope mode, loads messages for just the current thread.
    */
-  async loadUnobservedMessages(threadId, resourceId, lastObservedAt) {
+  async loadMessagesFromStorage(threadId, resourceId, lastObservedAt) {
     const startDate = lastObservedAt ? new Date(lastObservedAt.getTime() + 1) : void 0;
     let result;
     if (this.scope === "resource" && resourceId) {
@@ -7403,7 +7403,7 @@ ${grouped}` : grouped;
     if (opts.messages) {
       unobservedMessages = this.getUnobservedMessages(opts.messages, record);
     } else {
-      const rawMessages = await this.loadUnobservedMessages(
+      const rawMessages = await this.loadMessagesFromStorage(
         threadId,
         resourceId,
         record.lastObservedAt ? new Date(record.lastObservedAt) : void 0
@@ -7516,6 +7516,27 @@ ${grouped}` : grouped;
     const record = await this.getOrCreateRecord(threadId, resourceId);
     return this.getUnobservedMessages(messages, record);
   }
+  /**
+   * Load unobserved messages from storage for a thread/resource.
+   *
+   * Fetches the OM record, queries storage for messages after the
+   * lastObservedAt cursor, then applies part-level filtering so
+   * partially-observed messages only include their unobserved parts.
+   *
+   * Use this when you need to load stored conversation history that
+   * hasn't been observed yet (e.g. in a stateless gateway proxy that
+   * only receives the latest message from the HTTP request).
+   */
+  async loadUnobservedMessages(opts) {
+    const { threadId, resourceId } = opts;
+    const record = await this.getOrCreateRecord(threadId, resourceId);
+    const rawMessages = await this.loadMessagesFromStorage(
+      threadId,
+      resourceId,
+      record.lastObservedAt ? new Date(record.lastObservedAt) : void 0
+    );
+    return this.getUnobservedMessages(rawMessages, record);
+  }
   /**
    * Create a buffered observation chunk without merging into active observations.
    *
@@ -7577,7 +7598,7 @@ ${grouped}` : grouped;
       if (opts.messages) {
         candidateMessages = this.getUnobservedMessages(opts.messages, record, { excludeBuffered: true });
       } else {
-        const rawMessages = await this.loadUnobservedMessages(
+        const rawMessages = await this.loadMessagesFromStorage(
           threadId,
           resourceId,
           record.lastObservedAt ? new Date(record.lastObservedAt) : void 0
@@ -7819,7 +7840,7 @@ ${grouped}` : grouped;
     await this.withLock(lockKey, async () => {
       const freshRecord = await this.getOrCreateRecord(threadId, resourceId);
       generationBefore = freshRecord.generationCount;
-      const unobservedMessages = messages ? this.getUnobservedMessages(messages, freshRecord) : await this.loadUnobservedMessages(
+      const unobservedMessages = messages ? this.getUnobservedMessages(messages, freshRecord) : await this.loadMessagesFromStorage(
         threadId,
         resourceId,
         freshRecord.lastObservedAt ? new Date(freshRecord.lastObservedAt) : void 0
@@ -8475,5 +8496,5 @@ exports.stripEphemeralAnchorIds = stripEphemeralAnchorIds;
 exports.stripObservationGroups = stripObservationGroups;
 exports.truncateStringByTokens = truncateStringByTokens;
 exports.wrapInObservationGroup = wrapInObservationGroup;
-//# sourceMappingURL=chunk-HLGFIN4J.cjs.map
-//# sourceMappingURL=chunk-HLGFIN4J.cjs.map
+//# sourceMappingURL=chunk-O3KNDDJV.cjs.map
+//# sourceMappingURL=chunk-O3KNDDJV.cjs.map