@mastra/memory 1.8.4-alpha.0 → 1.9.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/dist/{chunk-4KPXPQX3.js → chunk-JJBSFPC5.js} +518 -60
  3. package/dist/chunk-JJBSFPC5.js.map +1 -0
  4. package/dist/{chunk-LGCREJMO.cjs → chunk-LVV2RT42.cjs} +530 -59
  5. package/dist/chunk-LVV2RT42.cjs.map +1 -0
  6. package/dist/docs/SKILL.md +5 -7
  7. package/dist/docs/assets/SOURCE_MAP.json +77 -27
  8. package/dist/docs/references/docs-agents-agent-approval.md +114 -193
  9. package/dist/docs/references/docs-agents-networks.md +88 -205
  10. package/dist/docs/references/docs-agents-supervisor-agents.md +24 -18
  11. package/dist/docs/references/docs-memory-observational-memory.md +32 -2
  12. package/dist/docs/references/docs-memory-overview.md +219 -24
  13. package/dist/docs/references/docs-memory-semantic-recall.md +1 -1
  14. package/dist/docs/references/docs-memory-storage.md +4 -4
  15. package/dist/docs/references/docs-memory-working-memory.md +1 -1
  16. package/dist/docs/references/reference-core-getMemory.md +1 -2
  17. package/dist/docs/references/reference-core-listMemory.md +1 -2
  18. package/dist/docs/references/reference-memory-cloneThread.md +1 -1
  19. package/dist/docs/references/reference-memory-observational-memory.md +41 -1
  20. package/dist/index.cjs +434 -12
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +434 -11
  24. package/dist/index.js.map +1 -1
  25. package/dist/observational-memory-3XFCO6MX.js +3 -0
  26. package/dist/{observational-memory-UEDVTWS2.js.map → observational-memory-3XFCO6MX.js.map} +1 -1
  27. package/dist/observational-memory-MJJFU26W.cjs +108 -0
  28. package/dist/{observational-memory-4TV5KKFV.cjs.map → observational-memory-MJJFU26W.cjs.map} +1 -1
  29. package/dist/processors/index.cjs +56 -16
  30. package/dist/processors/index.js +1 -1
  31. package/dist/processors/observational-memory/anchor-ids.d.ts +4 -0
  32. package/dist/processors/observational-memory/anchor-ids.d.ts.map +1 -0
  33. package/dist/processors/observational-memory/index.d.ts +2 -0
  34. package/dist/processors/observational-memory/index.d.ts.map +1 -1
  35. package/dist/processors/observational-memory/markers.d.ts +10 -1
  36. package/dist/processors/observational-memory/markers.d.ts.map +1 -1
  37. package/dist/processors/observational-memory/observation-groups.d.ts +15 -0
  38. package/dist/processors/observational-memory/observation-groups.d.ts.map +1 -0
  39. package/dist/processors/observational-memory/observational-memory.d.ts +16 -0
  40. package/dist/processors/observational-memory/observational-memory.d.ts.map +1 -1
  41. package/dist/processors/observational-memory/observer-agent.d.ts +16 -6
  42. package/dist/processors/observational-memory/observer-agent.d.ts.map +1 -1
  43. package/dist/processors/observational-memory/reflector-agent.d.ts +1 -1
  44. package/dist/processors/observational-memory/reflector-agent.d.ts.map +1 -1
  45. package/dist/processors/observational-memory/tool-result-helpers.d.ts.map +1 -1
  46. package/dist/processors/observational-memory/types.d.ts +27 -1
  47. package/dist/processors/observational-memory/types.d.ts.map +1 -1
  48. package/dist/tools/om-tools.d.ts +77 -0
  49. package/dist/tools/om-tools.d.ts.map +1 -0
  50. package/package.json +5 -5
  51. package/dist/chunk-4KPXPQX3.js.map +0 -1
  52. package/dist/chunk-LGCREJMO.cjs.map +0 -1
  53. package/dist/docs/references/docs-agents-agent-memory.md +0 -209
  54. package/dist/docs/references/docs-agents-network-approval.md +0 -278
  55. package/dist/observational-memory-4TV5KKFV.cjs +0 -68
  56. package/dist/observational-memory-UEDVTWS2.js +0 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,55 @@
1
1
  # @mastra/memory
2
2
 
3
+ ## 1.9.0-alpha.2
4
+
5
+ ### Minor Changes
6
+
7
+ - Added experimental retrieval-mode recall tooling for observational memory. ([#14437](https://github.com/mastra-ai/mastra/pull/14437))
8
+
9
+ When `observationalMemory.retrieval` is enabled with `scope: 'thread'`, observation groups store colon-delimited message ranges (`startId:endId`) pointing back to the raw messages they were derived from. A `recall` tool is registered that lets agents retrieve those source messages via cursor-based pagination.
10
+
11
+ The recall tool supports:
12
+ - **Detail levels**: `detail: 'low'` (default) returns truncated text with part indices; `detail: 'high'` returns full content clamped to one part per call with continuation hints
13
+ - **Part-level fetch**: `partIndex` targets a single message part at full detail
14
+ - **Pagination flags**: `hasNextPage` and `hasPrevPage` in results
15
+ - **Token limiting**: results are capped at a token budget with `truncated` and `tokenOffset` reporting
16
+ - **Smart range detection**: passing a range as a cursor returns a helpful hint explaining how to extract individual IDs
17
+
18
+ ### Patch Changes
19
+
20
+ - Updated dependencies [[`da93115`](https://github.com/mastra-ai/mastra/commit/da931155c1a9bc63d455d3d86b4ec984db5991fe), [`0efe12a`](https://github.com/mastra-ai/mastra/commit/0efe12a5f008a939a1aac71699486ba40138054e)]:
21
+ - @mastra/core@1.15.0-alpha.4
22
+
23
+ ## 1.9.0-alpha.1
24
+
25
+ ### Minor Changes
26
+
27
+ - Added opt-in Observational Memory thread titles. ([#14436](https://github.com/mastra-ai/mastra/pull/14436))
28
+
29
+ When enabled, the Observer suggests a short thread title and updates it as the conversation topic changes. Harness consumers can detect these updates via the new `om_thread_title_updated` event.
30
+
31
+ **Example**
32
+
33
+ ```ts
34
+ const memory = new Memory({
35
+ options: {
36
+ observationalMemory: {
37
+ observation: {
38
+ threadTitle: true,
39
+ },
40
+ },
41
+ },
42
+ });
43
+ ```
44
+
45
+ ### Patch Changes
46
+
47
+ - Improved observational memory so completed tasks and answered questions are explicitly tracked and retained, reducing repeated follow-up on resolved topics. ([#14419](https://github.com/mastra-ai/mastra/pull/14419))
48
+
49
+ - Updated dependencies [[`cd7b568`](https://github.com/mastra-ai/mastra/commit/cd7b568fe427b1b4838abe744fa5367a47539db3), [`681ee1c`](https://github.com/mastra-ai/mastra/commit/681ee1c811359efd1b8bebc4bce35b9bb7b14bec)]:
50
+ - @mastra/schema-compat@1.2.6-alpha.1
51
+ - @mastra/core@1.15.0-alpha.1
52
+
3
53
  ## 1.8.4-alpha.0
4
54
 
5
55
  ### Patch Changes