@mastra/memory 1.11.0-alpha.4 → 1.11.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @mastra/memory
 
+## 1.11.1-alpha.0
+
+### 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))
+
+- Updated dependencies [[`180aaaf`](https://github.com/mastra-ai/mastra/commit/180aaaf4d0903d33a49bc72de2d40ca69a5bc599)]:
+  - @mastra/core@1.18.1-alpha.0
+
+## 1.11.0
+
+### Minor Changes
+
+- feat(memory): add recall-tool history retrieval for agents using observational memory ([#14567](https://github.com/mastra-ai/mastra/pull/14567))
+
+  Agents that use observational memory can now use the `recall` tool to retrieve history from past conversations, including raw messages, thread listings, and indexed observation-group memories.
+
+  Enable observational-memory retrieval when listing tools:
+
+  ```ts
+  const tools = await memory.listTools({
+    threadId: 'thread_123',
+    resourceId: 'resource_abc',
+    observationalMemory: {
+      retrieval: { vector: true, scope: 'resource' },
+    },
+  });
+  ```
+
+  With retrieval enabled, `recall` can browse the current thread, list threads for the current resource, and search indexed observation groups with source ranges.
+
+### Patch Changes
+
+- Fixed OM repro capture so recordings keep writing usable artifacts even when live state contains circular values. ([#14744](https://github.com/mastra-ai/mastra/pull/14744))
+
+- Fixed observational memory response ID rotation at buffered chunk boundaries so assistant output continues in a fresh message slot. ([#14745](https://github.com/mastra-ai/mastra/pull/14745))
+
+- The internal architecture of observational memory has been refactored. The public API and behavior remain unchanged. ([#14453](https://github.com/mastra-ai/mastra/pull/14453))
+
+- Fixed observational memory tracing spans so observer and reflector runner work is attached to the active agent trace again. ([#14749](https://github.com/mastra-ai/mastra/pull/14749))
+
+- Improved observational memory continuation prompts to reduce leaked context-management language in long conversations. ([#14650](https://github.com/mastra-ai/mastra/pull/14650))
+
+- Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0
+
 ## 1.11.0-alpha.4
 
 ### Minor Changes

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

@@ -717,10 +717,10 @@ function stripReflectionGroupMetadata(body) {
 function generateAnchorId() {
   return randomBytes(8).toString("hex");
 }
-function wrapInObservationGroup(observations, range, id = generateAnchorId(), sourceGroupIds) {
+function wrapInObservationGroup(observations, range, id = generateAnchorId(), _sourceGroupIds, kind) {
   const content = observations.trim();
-  const sourceGroupIdsAttr = sourceGroupIds?.length ? ` source-group-ids="${sourceGroupIds.join(",")}"` : "";
-  return `<observation-group id="${id}" range="${range}"${sourceGroupIdsAttr}>
+  const kindAttr = kind ? ` kind="${kind}"` : "";
+  return `<observation-group id="${id}" range="${range}"${kindAttr}>
 ${content}
 </observation-group>`;
 }
@@ -740,8 +740,8 @@ function parseObservationGroups(observations) {
     groups.push({
       id,
       range,
-      content: match[2].trim(),
-      sourceGroupIds: attributes["source-group-ids"]?.split(",").map((part) => part.trim()).filter(Boolean)
+      kind: attributes.kind,
+      content: match[2].trim()
     });
   }
   return groups;
@@ -752,12 +752,22 @@ function stripObservationGroups(observations) {
   }
   return observations.replace(OBSERVATION_GROUP_PATTERN, (_match, _attributes, content) => content.trim()).replace(/\n{3,}/g, "\n\n").trim();
 }
+function getRangeSegments(range) {
+  return range.split(",").map((segment) => segment.trim()).filter(Boolean);
+}
 function combineObservationGroupRanges(groups) {
-  return Array.from(
-    new Set(
-      groups.flatMap((group) => group.range.split(",")).map((range) => range.trim()).filter(Boolean)
-    )
-  ).join(",");
+  const segments = groups.flatMap((group) => getRangeSegments(group.range));
+  if (segments.length === 0) {
+    return "";
+  }
+  const firstSegment = segments[0];
+  const lastSegment = segments[segments.length - 1];
+  const firstStart = firstSegment?.split(":")[0]?.trim();
+  const lastEnd = lastSegment?.split(":").at(-1)?.trim();
+  if (firstStart && lastEnd) {
+    return `${firstStart}:${lastEnd}`;
+  }
+  return Array.from(new Set(segments)).join(",");
 }
 function renderObservationGroupsForReflection(observations) {
   const groups = parseObservationGroups(observations);
@@ -794,15 +804,12 @@ function deriveObservationGroupProvenance(content, groups) {
     });
     const fallbackGroup = groups[Math.min(index, groups.length - 1)];
     const resolvedGroups = matchingGroups.length > 0 ? matchingGroups : fallbackGroup ? [fallbackGroup] : [];
-    const sourceGroupIds = Array.from(
-      new Set(resolvedGroups.flatMap((group) => [group.id, ...group.sourceGroupIds ?? []]))
-    );
     const canonicalGroupId = getCanonicalGroupId(section.heading, index);
     return {
       id: canonicalGroupId,
       range: combineObservationGroupRanges(resolvedGroups),
-      content: section.body,
-      sourceGroupIds
+      kind: "reflection",
+      content: section.body
     };
   });
 }
@@ -817,13 +824,14 @@ function reconcileObservationGroupsFromReflection(content, sourceObservations) {
   }
   const derivedGroups = deriveObservationGroupProvenance(normalizedContent, sourceGroups);
   if (derivedGroups.length > 0) {
-    return derivedGroups.map((group) => wrapInObservationGroup(group.content, group.range, group.id, group.sourceGroupIds)).join("\n\n");
+    return derivedGroups.map((group) => wrapInObservationGroup(group.content, group.range, group.id, void 0, group.kind)).join("\n\n");
   }
   return wrapInObservationGroup(
     normalizedContent,
     combineObservationGroupRanges(sourceGroups),
     generateAnchorId(),
-    Array.from(new Set(sourceGroups.flatMap((group) => [group.id, ...group.sourceGroupIds ?? []])))
+    void 0,
+    "reflection"
   );
 }
 
@@ -3821,11 +3829,10 @@ Aim for a 2/10 detail level. Fewer, more generic observations are better than ma
 };
 function buildReflectorPrompt(observations, manualPrompt, compressionLevel, skipContinuationHints) {
   const level = typeof compressionLevel === "number" ? compressionLevel : compressionLevel ? 1 : 0;
-  const reflectionView = renderObservationGroupsForReflection(observations) ?? observations;
-  const anchoredObservations = injectAnchorIds(reflectionView);
+  const reflectionView = stripObservationGroups(observations);
   let prompt = `## OBSERVATIONS TO REFLECT ON
 
-${anchoredObservations}
+${reflectionView}
 
 ---
 
@@ -8418,5 +8425,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-D4D6ZFBQ.js.map
-//# sourceMappingURL=chunk-D4D6ZFBQ.js.map
+//# sourceMappingURL=chunk-2NZR2XHO.js.map
+//# sourceMappingURL=chunk-2NZR2XHO.js.map