@mastra/memory 1.11.1-alpha.0 → 1.12.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @mastra/memory
 
+## 1.12.0
+
+### Minor Changes
+
+- Added more forgiving raw message browsing in the recall tool for agent follow-up calls. ([#14873](https://github.com/mastra-ai/mastra/pull/14873))
+
+  When an agent requests a `partIndex` greater than the highest visible part in a message, recall now returns the first visible part from the next visible message instead of failing. This makes it easier for agents using `recall` to keep browsing raw messages even when they guess the wrong part index.
+
+### Patch Changes
+
+- Fixed reflected observation groups so their metadata stays compact and marks reflection-derived content. ([#14791](https://github.com/mastra-ai/mastra/pull/14791))
+
+- Fixed synchronous observation error handling in Observational Memory. `observe()` now throws when synchronous (thread/resource-scoped) observation fails, instead of continuing silently with stale observations. Async buffered observation failures remain non-fatal. ([#14843](https://github.com/mastra-ai/mastra/pull/14843))
+
+- Updated dependencies [[`180aaaf`](https://github.com/mastra-ai/mastra/commit/180aaaf4d0903d33a49bc72de2d40ca69a5bc599), [`9140989`](https://github.com/mastra-ai/mastra/commit/91409890e83f4f1d9c1b39223f1af91a6a53b549), [`d7c98cf`](https://github.com/mastra-ai/mastra/commit/d7c98cfc9d75baba9ecbf1a8835b5183d0a0aec8), [`acf5fbc`](https://github.com/mastra-ai/mastra/commit/acf5fbcb890dc7ca7167bec386ce5874dfadb997), [`24ca2ae`](https://github.com/mastra-ai/mastra/commit/24ca2ae57538ec189fabb9daee6175ad27035853), [`0762516`](https://github.com/mastra-ai/mastra/commit/07625167e029a8268ea7aaf0402416e6d8832874), [`9c57f2f`](https://github.com/mastra-ai/mastra/commit/9c57f2f7241e9f94769aa99fc86c531e8207d0f9), [`5bfc691`](https://github.com/mastra-ai/mastra/commit/5bfc69104c07ba7a9b55c2f8536422c0878b9c57), [`2de3d36`](https://github.com/mastra-ai/mastra/commit/2de3d36932b7f73ad26bc403f7da26cfe89e903e), [`d3736cb`](https://github.com/mastra-ai/mastra/commit/d3736cb9ce074d2b8e8b00218a01f790fe81a1b4), [`c627366`](https://github.com/mastra-ai/mastra/commit/c6273666f9ef4c8c617c68b7d07fe878a322f85c)]:
+  - @mastra/core@1.19.0
+
+## 1.12.0-alpha.1
+
+### Minor Changes
+
+- Added more forgiving raw message browsing in the recall tool for agent follow-up calls. ([#14873](https://github.com/mastra-ai/mastra/pull/14873))
+
+  When an agent requests a `partIndex` greater than the highest visible part in a message, recall now returns the first visible part from the next visible message instead of failing. This makes it easier for agents using `recall` to keep browsing raw messages even when they guess the wrong part index.
+
+### Patch Changes
+
+- Fixed synchronous observation error handling in Observational Memory. `observe()` now throws when synchronous (thread/resource-scoped) observation fails, instead of continuing silently with stale observations. Async buffered observation failures remain non-fatal. ([#14843](https://github.com/mastra-ai/mastra/pull/14843))
+
+- Updated dependencies [[`9c57f2f`](https://github.com/mastra-ai/mastra/commit/9c57f2f7241e9f94769aa99fc86c531e8207d0f9), [`5bfc691`](https://github.com/mastra-ai/mastra/commit/5bfc69104c07ba7a9b55c2f8536422c0878b9c57)]:
+  - @mastra/core@1.19.0-alpha.2
+
 ## 1.11.1-alpha.0
 
 ### Patch Changes

package/README.md

@@ -1,3 +1,3 @@
 # Mastra Memory
 
-Memory management for Mastra agents. Visit [the docs](https://mastra.ai/docs/agents/agent-memory) for more information.
+Memory management for Mastra agents. Visit [the docs](https://mastra.ai/docs/memory/overview) for more information.

package/dist/{chunk-2NZR2XHO.js → chunk-DDQHE4NV.js}

@@ -943,7 +943,11 @@ var ObservationStrategy = class _ObservationStrategy {
   retrieval;
   /** Select the right strategy based on scope and mode. Wired up by index.ts. */
   static create;
-  /** Run the full observation lifecycle. */
+  /**
+   * Run the full observation lifecycle.
+   * @returns `true` if a full observation cycle completed; `false` if skipped (stale lock) or async-buffer failure was swallowed.
+   * @throws On sync/resource-scoped observer failure after failed markers (same as pre–Option-A contract).
+   */
   async run() {
     const { record, threadId, abortSignal, writer, reflectionHooks, requestContext } = this.opts;
     const cycleId = this.generateCycleId();
@@ -951,7 +955,7 @@ var ObservationStrategy = class _ObservationStrategy {
       if (this.needsLock) {
         const fresh = await this.storage.getObservationalMemory(record.threadId, record.resourceId);
         if (fresh?.lastObservedAt && record.lastObservedAt && fresh.lastObservedAt > record.lastObservedAt) {
-          return;
+          return false;
         }
       }
       const { messages, existingObservations } = await this.prepare();
@@ -972,23 +976,29 @@ var ObservationStrategy = class _ObservationStrategy {
           observabilityContext: this.opts.observabilityContext
         });
       }
+      return true;
     } catch (error) {
       await this.emitFailedMarkers(cycleId, error);
-      const failedMarkerForStorage = {
-        type: "data-om-observation-failed",
-        data: {
-          cycleId,
-          operationType: "observation",
-          startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          error: error instanceof Error ? error.message : String(error),
-          recordId: record.id,
-          threadId
-        }
-      };
-      await this.persistMarkerToStorage(failedMarkerForStorage, threadId, this.opts.resourceId).catch(() => {
-      });
-      if (abortSignal?.aborted) throw error;
+      if (!this.rethrowOnFailure) {
+        const failedMarkerForStorage = {
+          type: "data-om-observation-failed",
+          data: {
+            cycleId,
+            operationType: "observation",
+            startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            error: error instanceof Error ? error.message : String(error),
+            recordId: record.id,
+            threadId
+          }
+        };
+        await this.persistMarkerToStorage(failedMarkerForStorage, threadId, this.opts.resourceId).catch(() => {
+        });
+        if (abortSignal?.aborted) throw error;
+        omError("[OM] Observation failed", error);
+        return false;
+      }
       omError("[OM] Observation failed", error);
+      throw error;
     }
   }
   // ── Shared helpers ──────────────────────────────────────────
@@ -1209,6 +1219,9 @@ var SyncObservationStrategy = class extends ObservationStrategy {
   get needsReflection() {
     return true;
   }
+  get rethrowOnFailure() {
+    return true;
+  }
   async prepare() {
     const { record, threadId, messages } = this.opts;
     this.deps.emitDebugEvent({
@@ -1402,6 +1415,9 @@ var AsyncBufferObservationStrategy = class extends ObservationStrategy {
   get needsReflection() {
     return false;
   }
+  get rethrowOnFailure() {
+    return false;
+  }
   generateCycleId() {
     return this.cycleId;
   }
@@ -1538,6 +1554,9 @@ var ResourceScopedObservationStrategy = class extends ObservationStrategy {
   get needsReflection() {
     return true;
   }
+  get rethrowOnFailure() {
+    return true;
+  }
   async prepare() {
     const { record, threadId: currentThreadId, messages: currentThreadMessages } = this.opts;
     const { threads: allThreads } = await this.storage.listThreads({ filter: { resourceId: this.resourceId } });
@@ -7806,7 +7825,7 @@ ${grouped}` : grouped;
       }
       hooks?.onObservationStart?.();
       try {
-        await ObservationStrategy.create(this, {
+        observed = await ObservationStrategy.create(this, {
           record: freshRecord,
           threadId,
           resourceId,
@@ -7816,7 +7835,6 @@ ${grouped}` : grouped;
           writer: opts.writer,
           observabilityContext: opts.observabilityContext
         }).run();
-        observed = true;
       } finally {
         hooks?.onObservationEnd?.();
       }
@@ -8425,5 +8443,5 @@ function getObservationsAsOf(activeObservations, asOf) {
 }
 
 export { ModelByInputTokens, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, formatToolResultForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, resolveToolResultValue, stripEphemeralAnchorIds, stripObservationGroups, truncateStringByTokens, wrapInObservationGroup };
-//# sourceMappingURL=chunk-2NZR2XHO.js.map
-//# sourceMappingURL=chunk-2NZR2XHO.js.map
+//# sourceMappingURL=chunk-DDQHE4NV.js.map
+//# sourceMappingURL=chunk-DDQHE4NV.js.map