@mastra/memory 1.22.0-alpha.3 → 1.22.0

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 (4) hide show
  1. package/CHANGELOG.md +59 -0
  2. package/dist/docs/SKILL.md +1 -1
  3. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  4. package/package.json +8 -8
package/CHANGELOG.md CHANGED
@@ -1,5 +1,64 @@
1
1
  # @mastra/memory
2
2
 
3
+ ## 1.22.0
4
+
5
+ ### Minor Changes
6
+
7
+ - add observational memory extractors ([#18653](https://github.com/mastra-ai/mastra/pull/18653))
8
+
9
+ Introduces a public Extractor API for Observational Memory
10
+ with inline XML extraction and structured follow-up modes.
11
+ Includes built-in extractors for current task, suggested
12
+ response, and thread title. Persists extracted values into
13
+ thread OM metadata with key-level merging and carry-forward
14
+ into future observer/reflector prompts.
15
+
16
+ - add OM-managed working memory ([#18654](https://github.com/mastra-ai/mastra/pull/18654))
17
+
18
+ Adds `observationalMemory.observation.manageWorkingMemory` so the Observer can update working memory automatically instead of requiring the main agent to call the working memory tool.
19
+
20
+ ```ts
21
+ new Memory({
22
+ options: {
23
+ workingMemory: { enabled: true },
24
+ observationalMemory: {
25
+ enabled: true,
26
+ observation: { manageWorkingMemory: true },
27
+ },
28
+ },
29
+ });
30
+ ```
31
+
32
+ This option adds `WorkingMemoryExtractor`, defaults `workingMemory.agentManaged` to `false`, and defaults `workingMemory.useStateSignals` to `true` when working memory is enabled. Set `workingMemory.agentManaged: true` to keep the main agent's working memory tool and instructions enabled.
33
+
34
+ ### Patch Changes
35
+
36
+ - Expose `providerMetadata` on Observational Memory `ObserveHooks` results ([#18563](https://github.com/mastra-ai/mastra/pull/18563))
37
+
38
+ `onObservationEnd` and `onReflectionEnd` now receive the OM model call's `providerMetadata` alongside `usage`, so you can read per-call provider details — for example the AI Gateway's cost and generation id — straight from the hook instead of wrapping the observer/reflector models in a model-stream middleware:
39
+
40
+ ```ts
41
+ const hooks: ObserveHooks = {
42
+ onObservationEnd: ({ usage, providerMetadata }) => {
43
+ const gateway = providerMetadata?.gateway;
44
+ recordCost({ tokens: usage?.totalTokens, cost: gateway?.cost, generationId: gateway?.generationId });
45
+ },
46
+ onReflectionEnd: ({ usage, providerMetadata }) => {
47
+ recordCost({ tokens: usage?.totalTokens, cost: providerMetadata?.gateway?.cost });
48
+ },
49
+ };
50
+ ```
51
+
52
+ The field is additive and optional, and is omitted entirely when the provider emits no metadata, so existing hook consumers are unaffected. For batched observations and multi-attempt reflections it reflects the last batch/attempt that emitted provider metadata.
53
+
54
+ - add Studio support for observational memory extractors ([#18655](https://github.com/mastra-ai/mastra/pull/18655))
55
+
56
+ Adds `bufferedObservationChunks` and extraction metadata to the buffer-status API and client types so extracted values flow through during live streaming. Renders observational memory indicators from a normalized cycle model that preserves extraction data across streaming, refetch, reload, activation, and failure transitions.
57
+
58
+ - Updated dependencies [[`b9a2961`](https://github.com/mastra-ai/mastra/commit/b9a2961c1be81e3639c0879e58588c26dd0ae866), [`b33c77d`](https://github.com/mastra-ai/mastra/commit/b33c77d5293f14a794f3ec38dc947a6676de2764), [`1274eb3`](https://github.com/mastra-ai/mastra/commit/1274eb3a9508f579ceb3187fbce34408222d4b71), [`cdd5f93`](https://github.com/mastra-ai/mastra/commit/cdd5f939cefa67390629704dce92563ccbf492b2), [`1274eb3`](https://github.com/mastra-ai/mastra/commit/1274eb3a9508f579ceb3187fbce34408222d4b71), [`0ac14ce`](https://github.com/mastra-ai/mastra/commit/0ac14cea48e1b0a7857782153c78f7242fdf7e1a), [`9566d27`](https://github.com/mastra-ai/mastra/commit/9566d27ead3d95bdbe5a69e5a082a68222829cf2), [`8be63b0`](https://github.com/mastra-ai/mastra/commit/8be63b015fb8d72cea1220f05e7dc3bb997cc249), [`1009f77`](https://github.com/mastra-ai/mastra/commit/1009f772aa40016b49267c8566d0c29f6a16aa3c), [`1b8728a`](https://github.com/mastra-ai/mastra/commit/1b8728a57fd844205a452b0b4216d20ff60c784a), [`23c31de`](https://github.com/mastra-ai/mastra/commit/23c31de96ed8153402dcf092ac84b27a0c3638c1), [`0368766`](https://github.com/mastra-ai/mastra/commit/0368766744c7ea3df4d6059e2cc15f7bdf55f5a6), [`d0702ee`](https://github.com/mastra-ai/mastra/commit/d0702eedc1594cb2d0d83476440cfc2ec8820adb), [`9feeaa0`](https://github.com/mastra-ai/mastra/commit/9feeaa0f9a1af07039e5b4f22b932b0cb18617e8), [`6f578ac`](https://github.com/mastra-ai/mastra/commit/6f578acba84930b406b2a0700b17cfdfaf5aae56), [`345eecc`](https://github.com/mastra-ai/mastra/commit/345eecce6ba519b5d987f0e10b5de4c8e5734580), [`1917c53`](https://github.com/mastra-ai/mastra/commit/1917c53b19dac43926f29c496893b0686462dca4), [`c01012f`](https://github.com/mastra-ai/mastra/commit/c01012f50368d29eb3fc3764df42d48291973d23), [`705ba98`](https://github.com/mastra-ai/mastra/commit/705ba98726d388a596e896225f237907ca6807a9), [`95857bc`](https://github.com/mastra-ai/mastra/commit/95857bcd6669da7193f503e803f0d72a2bd66be6), [`e62c108`](https://github.com/mastra-ai/mastra/commit/e62c108409dfd6a6cac0a48ec39c5cc81d24fd52), [`2866f04`](https://github.com/mastra-ai/mastra/commit/2866f04953edb78c1637fa45cc53abe24122edcb), [`ee14cae`](https://github.com/mastra-ai/mastra/commit/ee14cae244805783bde518a6142de28b744b169c), [`e84e791`](https://github.com/mastra-ai/mastra/commit/e84e79174031d7bc8793ca6c805eb38b06e7cfb1), [`c2f0b7f`](https://github.com/mastra-ai/mastra/commit/c2f0b7f1370f4428d165f51f0d1d9a48331cc257), [`213feb8`](https://github.com/mastra-ai/mastra/commit/213feb87bfdd1d8ec00ea660e218f9bcfcb34e7b), [`58e287b`](https://github.com/mastra-ai/mastra/commit/58e287b1edaf978b13745a1795989cad3826e82b), [`e420b3c`](https://github.com/mastra-ai/mastra/commit/e420b3c3ffc98bbc5b791897ea390bb47af99696), [`be875ed`](https://github.com/mastra-ai/mastra/commit/be875ed43f856742ce58529f531b5ea0ae6911f3), [`9eefdc0`](https://github.com/mastra-ai/mastra/commit/9eefdc0ac03f989718c6d835334940a977938895), [`bfbbb01`](https://github.com/mastra-ai/mastra/commit/bfbbb01bd845ba54cdc0c678c277d08a7cb847e4), [`7d112ca`](https://github.com/mastra-ai/mastra/commit/7d112ca17078479b2659b88ba1c85b936cfc111c)]:
59
+ - @mastra/core@1.48.0
60
+ - @mastra/schema-compat@1.3.2
61
+
3
62
  ## 1.22.0-alpha.3
4
63
 
5
64
  ### Minor Changes
package/dist/docs/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: mastra-memory
3
3
  description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
4
4
  metadata:
5
5
  package: "@mastra/memory"
6
- version: "1.22.0-alpha.3"
6
+ version: "1.22.0"
7
7
  ---
8
8
 
9
9
  ## When to use
package/dist/docs/assets/SOURCE_MAP.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.22.0-alpha.3",
2
+ "version": "1.22.0",
3
3
  "package": "@mastra/memory",
4
4
  "exports": {
5
5
  "Extractor": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/memory",
3
- "version": "1.22.0-alpha.3",
3
+ "version": "1.22.0",
4
4
  "description": "",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -45,7 +45,7 @@
45
45
  "tokenx": "^1.3.0",
46
46
  "xxhash-wasm": "^1.1.0",
47
47
  "zod": "^4.4.3",
48
- "@mastra/schema-compat": "1.3.2-alpha.1"
48
+ "@mastra/schema-compat": "1.3.2"
49
49
  },
50
50
  "devDependencies": {
51
51
  "@ai-sdk/openai": "^1.3.24",
@@ -61,12 +61,12 @@
61
61
  "typescript": "^6.0.3",
62
62
  "typescript-eslint": "^8.57.0",
63
63
  "vitest": "4.1.8",
64
- "@internal/ai-sdk-v5": "0.0.56",
65
- "@internal/ai-v6": "0.0.56",
66
- "@internal/ai-sdk-v4": "0.0.56",
67
- "@internal/types-builder": "0.0.84",
68
- "@mastra/core": "1.48.0-alpha.10",
69
- "@internal/lint": "0.0.109"
64
+ "@internal/ai-v6": "0.0.57",
65
+ "@internal/lint": "0.0.110",
66
+ "@mastra/core": "1.48.0",
67
+ "@internal/types-builder": "0.0.85",
68
+ "@internal/ai-sdk-v4": "0.0.57",
69
+ "@internal/ai-sdk-v5": "0.0.57"
70
70
  },
71
71
  "peerDependencies": {
72
72
  "@mastra/core": ">=1.4.1-0 <2.0.0-0"