@mastra/libsql 0.0.0-separate-trace-data-from-component-20250501141108 → 0.0.0-server-deploy-20260320063228

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 (92) hide show
  1. package/CHANGELOG.md +4085 -2
  2. package/LICENSE.md +27 -4
  3. package/README.md +32 -22
  4. package/dist/docs/SKILL.md +50 -0
  5. package/dist/docs/assets/SOURCE_MAP.json +6 -0
  6. package/dist/docs/references/docs-agents-agent-approval.md +588 -0
  7. package/dist/docs/references/docs-agents-agent-memory.md +209 -0
  8. package/dist/docs/references/docs-agents-network-approval.md +278 -0
  9. package/dist/docs/references/docs-agents-networks.md +299 -0
  10. package/dist/docs/references/docs-memory-memory-processors.md +314 -0
  11. package/dist/docs/references/docs-memory-message-history.md +260 -0
  12. package/dist/docs/references/docs-memory-overview.md +45 -0
  13. package/dist/docs/references/docs-memory-semantic-recall.md +288 -0
  14. package/dist/docs/references/docs-memory-storage.md +261 -0
  15. package/dist/docs/references/docs-memory-working-memory.md +400 -0
  16. package/dist/docs/references/docs-observability-overview.md +70 -0
  17. package/dist/docs/references/docs-observability-tracing-exporters-default.md +209 -0
  18. package/dist/docs/references/docs-rag-retrieval.md +515 -0
  19. package/dist/docs/references/docs-workflows-snapshots.md +238 -0
  20. package/dist/docs/references/guides-agent-frameworks-ai-sdk.md +140 -0
  21. package/dist/docs/references/reference-core-getMemory.md +50 -0
  22. package/dist/docs/references/reference-core-listMemory.md +56 -0
  23. package/dist/docs/references/reference-core-mastra-class.md +66 -0
  24. package/dist/docs/references/reference-memory-memory-class.md +145 -0
  25. package/dist/docs/references/reference-storage-composite.md +243 -0
  26. package/dist/docs/references/reference-storage-dynamodb.md +282 -0
  27. package/dist/docs/references/reference-storage-libsql.md +135 -0
  28. package/dist/docs/references/reference-vectors-libsql.md +305 -0
  29. package/dist/index.cjs +9899 -669
  30. package/dist/index.cjs.map +1 -0
  31. package/dist/index.d.ts +4 -5
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +9892 -676
  34. package/dist/index.js.map +1 -0
  35. package/dist/storage/db/index.d.ts +318 -0
  36. package/dist/storage/db/index.d.ts.map +1 -0
  37. package/dist/storage/db/utils.d.ts +68 -0
  38. package/dist/storage/db/utils.d.ts.map +1 -0
  39. package/dist/storage/domains/agents/index.d.ts +30 -0
  40. package/dist/storage/domains/agents/index.d.ts.map +1 -0
  41. package/dist/storage/domains/blobs/index.d.ts +17 -0
  42. package/dist/storage/domains/blobs/index.d.ts.map +1 -0
  43. package/dist/storage/domains/datasets/index.d.ts +43 -0
  44. package/dist/storage/domains/datasets/index.d.ts.map +1 -0
  45. package/dist/storage/domains/experiments/index.d.ts +29 -0
  46. package/dist/storage/domains/experiments/index.d.ts.map +1 -0
  47. package/dist/storage/domains/mcp-clients/index.d.ts +26 -0
  48. package/dist/storage/domains/mcp-clients/index.d.ts.map +1 -0
  49. package/dist/storage/domains/mcp-servers/index.d.ts +26 -0
  50. package/dist/storage/domains/mcp-servers/index.d.ts.map +1 -0
  51. package/dist/storage/domains/memory/index.d.ts +83 -0
  52. package/dist/storage/domains/memory/index.d.ts.map +1 -0
  53. package/dist/storage/domains/observability/index.d.ts +46 -0
  54. package/dist/storage/domains/observability/index.d.ts.map +1 -0
  55. package/dist/storage/domains/prompt-blocks/index.d.ts +25 -0
  56. package/dist/storage/domains/prompt-blocks/index.d.ts.map +1 -0
  57. package/dist/storage/domains/scorer-definitions/index.d.ts +26 -0
  58. package/dist/storage/domains/scorer-definitions/index.d.ts.map +1 -0
  59. package/dist/storage/domains/scores/index.d.ts +42 -0
  60. package/dist/storage/domains/scores/index.d.ts.map +1 -0
  61. package/dist/storage/domains/skills/index.d.ts +26 -0
  62. package/dist/storage/domains/skills/index.d.ts.map +1 -0
  63. package/dist/storage/domains/workflows/index.d.ts +48 -0
  64. package/dist/storage/domains/workflows/index.d.ts.map +1 -0
  65. package/dist/storage/domains/workspaces/index.d.ts +26 -0
  66. package/dist/storage/domains/workspaces/index.d.ts.map +1 -0
  67. package/dist/storage/index.d.ts +89 -0
  68. package/dist/storage/index.d.ts.map +1 -0
  69. package/dist/vector/filter.d.ts +29 -0
  70. package/dist/vector/filter.d.ts.map +1 -0
  71. package/dist/vector/index.d.ts +80 -0
  72. package/dist/vector/index.d.ts.map +1 -0
  73. package/dist/vector/prompt.d.ts +6 -0
  74. package/dist/vector/prompt.d.ts.map +1 -0
  75. package/dist/vector/sql-builder.d.ts +9 -0
  76. package/dist/vector/sql-builder.d.ts.map +1 -0
  77. package/package.json +36 -15
  78. package/dist/_tsup-dts-rollup.d.cts +0 -199
  79. package/dist/_tsup-dts-rollup.d.ts +0 -199
  80. package/dist/index.d.cts +0 -5
  81. package/eslint.config.js +0 -6
  82. package/src/index.ts +0 -3
  83. package/src/storage/index.test.ts +0 -15
  84. package/src/storage/index.ts +0 -682
  85. package/src/vector/filter.test.ts +0 -968
  86. package/src/vector/filter.ts +0 -117
  87. package/src/vector/index.test.ts +0 -1702
  88. package/src/vector/index.ts +0 -344
  89. package/src/vector/prompt.ts +0 -101
  90. package/src/vector/sql-builder.ts +0 -462
  91. package/tsconfig.json +0 -5
  92. package/vitest.config.ts +0 -11
package/CHANGELOG.md CHANGED
@@ -1,13 +1,4096 @@
1
1
  # @mastra/libsql
2
2
 
3
- ## 0.0.0-separate-trace-data-from-component-20250501141108
3
+ ## 0.0.0-server-deploy-20260320063228
4
4
 
5
5
  ### Patch Changes
6
6
 
7
+ - Updated dependencies [[`c55b527`](https://github.com/mastra-ai/mastra/commit/c55b52758a31368b2077b0dbbc3badfe4063f560)]:
8
+ - @mastra/core@0.0.0-server-deploy-20260320063228
9
+
10
+ ## 1.7.0
11
+
12
+ ### Minor Changes
13
+
14
+ - Added `requestContext` column to the spans table. Request context data from tracing is now persisted alongside other span data. ([#14020](https://github.com/mastra-ai/mastra/pull/14020))
15
+
16
+ - Added `requestContext` and `requestContextSchema` column support to dataset storage. Dataset items now persist request context alongside input and ground truth data. ([#13938](https://github.com/mastra-ai/mastra/pull/13938))
17
+
18
+ ### Patch Changes
19
+
20
+ - Added resilient column handling to insert and update operations. Unknown columns in records are now silently dropped instead of causing SQL errors, ensuring forward compatibility when newer domain packages add fields that haven't been migrated yet. ([#14021](https://github.com/mastra-ai/mastra/pull/14021))
21
+
22
+ For example, calling `db.insert({ tableName, record: { id: '1', title: 'Hello', futureField: 'value' } })` will silently ignore `futureField` if it doesn't exist in the database table, rather than throwing. The same applies to `update` — unknown fields in the data payload are dropped before building the SQL statement.
23
+
24
+ - Fixed slow semantic recall in the libsql, Cloudflare D1, and ClickHouse storage adapters. Recall performance no longer degrades as threads grow larger. (Fixes #11702) ([#14022](https://github.com/mastra-ai/mastra/pull/14022))
25
+
26
+ - Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
27
+ - @mastra/core@1.11.0
28
+
29
+ ## 1.7.0-alpha.0
30
+
31
+ ### Minor Changes
32
+
33
+ - Added `requestContext` column to the spans table. Request context data from tracing is now persisted alongside other span data. ([#14020](https://github.com/mastra-ai/mastra/pull/14020))
34
+
35
+ - Added `requestContext` and `requestContextSchema` column support to dataset storage. Dataset items now persist request context alongside input and ground truth data. ([#13938](https://github.com/mastra-ai/mastra/pull/13938))
36
+
37
+ ### Patch Changes
38
+
39
+ - Added resilient column handling to insert and update operations. Unknown columns in records are now silently dropped instead of causing SQL errors, ensuring forward compatibility when newer domain packages add fields that haven't been migrated yet. ([#14021](https://github.com/mastra-ai/mastra/pull/14021))
40
+
41
+ For example, calling `db.insert({ tableName, record: { id: '1', title: 'Hello', futureField: 'value' } })` will silently ignore `futureField` if it doesn't exist in the database table, rather than throwing. The same applies to `update` — unknown fields in the data payload are dropped before building the SQL statement.
42
+
43
+ - Fixed slow semantic recall in the libsql, Cloudflare D1, and ClickHouse storage adapters. Recall performance no longer degrades as threads grow larger. (Fixes #11702) ([#14022](https://github.com/mastra-ai/mastra/pull/14022))
44
+
45
+ - Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
46
+ - @mastra/core@1.11.0-alpha.0
47
+
48
+ ## 1.6.4
49
+
50
+ ### Patch Changes
51
+
52
+ - - Fixed experiment pending count showing negative values when experiments are triggered from the Studio ([#13831](https://github.com/mastra-ai/mastra/pull/13831))
53
+ - Fixed scorer prompt metadata (analysis context, generated prompts) being lost when saving experiment scores
54
+ - Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
55
+ - @mastra/core@1.10.0
56
+
57
+ ## 1.6.4-alpha.0
58
+
59
+ ### Patch Changes
60
+
61
+ - - Fixed experiment pending count showing negative values when experiments are triggered from the Studio ([#13831](https://github.com/mastra-ai/mastra/pull/13831))
62
+ - Fixed scorer prompt metadata (analysis context, generated prompts) being lost when saving experiment scores
63
+ - Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
64
+ - @mastra/core@1.10.0-alpha.0
65
+
66
+ ## 1.6.3
67
+
68
+ ### Patch Changes
69
+
70
+ - Added atomic `updateWorkflowResults` and `updateWorkflowState` to safely merge concurrent step results into workflow snapshots. ([#12575](https://github.com/mastra-ai/mastra/pull/12575))
71
+
72
+ - Added `insertObservationalMemoryRecord()` to PostgreSQL, LibSQL, MongoDB, and Upstash adapters for OM cloning support. ([#13569](https://github.com/mastra-ai/mastra/pull/13569))
73
+
74
+ - Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
75
+ - @mastra/core@1.9.0
76
+
77
+ ## 1.6.3-alpha.0
78
+
79
+ ### Patch Changes
80
+
81
+ - Added atomic `updateWorkflowResults` and `updateWorkflowState` to safely merge concurrent step results into workflow snapshots. ([#12575](https://github.com/mastra-ai/mastra/pull/12575))
82
+
83
+ - Added `insertObservationalMemoryRecord()` to PostgreSQL, LibSQL, MongoDB, and Upstash adapters for OM cloning support. ([#13569](https://github.com/mastra-ai/mastra/pull/13569))
84
+
85
+ - Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
86
+ - @mastra/core@1.9.0-alpha.0
87
+
88
+ ## 1.6.2
89
+
90
+ ### Patch Changes
91
+
92
+ - Fixed observation activation to always preserve a minimum amount of context. Previously, swapping buffered observation chunks could unexpectedly drop the context window to near-zero tokens. ([#13476](https://github.com/mastra-ai/mastra/pull/13476))
93
+
94
+ - Add a clear runtime error when `queryVector` is omitted for vector stores that require a vector for queries. Previously, omitting `queryVector` would produce confusing SDK-level errors; now each store throws a structured `MastraError` with `ErrorCategory.USER` explaining that metadata-only queries are not supported by that backend. ([#13286](https://github.com/mastra-ai/mastra/pull/13286))
95
+
96
+ - Updated dependencies [[`df170fd`](https://github.com/mastra-ai/mastra/commit/df170fd139b55f845bfd2de8488b16435bd3d0da), [`ae55343`](https://github.com/mastra-ai/mastra/commit/ae5534397fc006fd6eef3e4f80c235bcdc9289ef), [`c290cec`](https://github.com/mastra-ai/mastra/commit/c290cec5bf9107225de42942b56b487107aa9dce), [`f03e794`](https://github.com/mastra-ai/mastra/commit/f03e794630f812b56e95aad54f7b1993dc003add), [`aa4a5ae`](https://github.com/mastra-ai/mastra/commit/aa4a5aedb80d8d6837bab8cbb2e301215d1ba3e9), [`de3f584`](https://github.com/mastra-ai/mastra/commit/de3f58408752a8d80a295275c7f23fc306cf7f4f), [`d3fb010`](https://github.com/mastra-ai/mastra/commit/d3fb010c98f575f1c0614452667396e2653815f6), [`702ee1c`](https://github.com/mastra-ai/mastra/commit/702ee1c41be67cc532b4dbe89bcb62143508f6f0), [`f495051`](https://github.com/mastra-ai/mastra/commit/f495051eb6496a720f637fc85b6d69941c12554c), [`e622f1d`](https://github.com/mastra-ai/mastra/commit/e622f1d3ab346a8e6aca6d1fe2eac99bd961e50b), [`861f111`](https://github.com/mastra-ai/mastra/commit/861f11189211b20ddb70d8df81a6b901fc78d11e), [`00f43e8`](https://github.com/mastra-ai/mastra/commit/00f43e8e97a80c82b27d5bd30494f10a715a1df9), [`1b6f651`](https://github.com/mastra-ai/mastra/commit/1b6f65127d4a0d6c38d0a1055cb84527db529d6b), [`96a1702`](https://github.com/mastra-ai/mastra/commit/96a1702ce362c50dda20c8b4a228b4ad1a36a17a), [`cb9f921`](https://github.com/mastra-ai/mastra/commit/cb9f921320913975657abb1404855d8c510f7ac5), [`114e7c1`](https://github.com/mastra-ai/mastra/commit/114e7c146ac682925f0fb37376c1be70e5d6e6e5), [`1b6f651`](https://github.com/mastra-ai/mastra/commit/1b6f65127d4a0d6c38d0a1055cb84527db529d6b), [`72df4a8`](https://github.com/mastra-ai/mastra/commit/72df4a8f9bf1a20cfd3d9006a4fdb597ad56d10a)]:
97
+ - @mastra/core@1.8.0
98
+
99
+ ## 1.6.2-alpha.0
100
+
101
+ ### Patch Changes
102
+
103
+ - Fixed observation activation to always preserve a minimum amount of context. Previously, swapping buffered observation chunks could unexpectedly drop the context window to near-zero tokens. ([#13476](https://github.com/mastra-ai/mastra/pull/13476))
104
+
105
+ - Add a clear runtime error when `queryVector` is omitted for vector stores that require a vector for queries. Previously, omitting `queryVector` would produce confusing SDK-level errors; now each store throws a structured `MastraError` with `ErrorCategory.USER` explaining that metadata-only queries are not supported by that backend. ([#13286](https://github.com/mastra-ai/mastra/pull/13286))
106
+
107
+ - Updated dependencies [[`df170fd`](https://github.com/mastra-ai/mastra/commit/df170fd139b55f845bfd2de8488b16435bd3d0da), [`ae55343`](https://github.com/mastra-ai/mastra/commit/ae5534397fc006fd6eef3e4f80c235bcdc9289ef), [`c290cec`](https://github.com/mastra-ai/mastra/commit/c290cec5bf9107225de42942b56b487107aa9dce), [`f03e794`](https://github.com/mastra-ai/mastra/commit/f03e794630f812b56e95aad54f7b1993dc003add), [`aa4a5ae`](https://github.com/mastra-ai/mastra/commit/aa4a5aedb80d8d6837bab8cbb2e301215d1ba3e9), [`de3f584`](https://github.com/mastra-ai/mastra/commit/de3f58408752a8d80a295275c7f23fc306cf7f4f), [`d3fb010`](https://github.com/mastra-ai/mastra/commit/d3fb010c98f575f1c0614452667396e2653815f6), [`702ee1c`](https://github.com/mastra-ai/mastra/commit/702ee1c41be67cc532b4dbe89bcb62143508f6f0), [`f495051`](https://github.com/mastra-ai/mastra/commit/f495051eb6496a720f637fc85b6d69941c12554c), [`e622f1d`](https://github.com/mastra-ai/mastra/commit/e622f1d3ab346a8e6aca6d1fe2eac99bd961e50b), [`861f111`](https://github.com/mastra-ai/mastra/commit/861f11189211b20ddb70d8df81a6b901fc78d11e), [`00f43e8`](https://github.com/mastra-ai/mastra/commit/00f43e8e97a80c82b27d5bd30494f10a715a1df9), [`1b6f651`](https://github.com/mastra-ai/mastra/commit/1b6f65127d4a0d6c38d0a1055cb84527db529d6b), [`96a1702`](https://github.com/mastra-ai/mastra/commit/96a1702ce362c50dda20c8b4a228b4ad1a36a17a), [`cb9f921`](https://github.com/mastra-ai/mastra/commit/cb9f921320913975657abb1404855d8c510f7ac5), [`114e7c1`](https://github.com/mastra-ai/mastra/commit/114e7c146ac682925f0fb37376c1be70e5d6e6e5), [`1b6f651`](https://github.com/mastra-ai/mastra/commit/1b6f65127d4a0d6c38d0a1055cb84527db529d6b), [`72df4a8`](https://github.com/mastra-ai/mastra/commit/72df4a8f9bf1a20cfd3d9006a4fdb597ad56d10a)]:
108
+ - @mastra/core@1.8.0-alpha.0
109
+
110
+ ## 1.6.1
111
+
112
+ ### Patch Changes
113
+
114
+ - Fixed non-deterministic query ordering by adding secondary sort on id for dataset and dataset item queries. ([#13399](https://github.com/mastra-ai/mastra/pull/13399))
115
+
116
+ - Prompt blocks can now define their own variables schema (`requestContextSchema`), allowing you to create reusable prompt blocks with typed variable placeholders. The server now correctly computes and returns draft/published status for prompt blocks. Existing databases are automatically migrated when upgrading. ([#13351](https://github.com/mastra-ai/mastra/pull/13351))
117
+
118
+ - Updated dependencies [[`24284ff`](https://github.com/mastra-ai/mastra/commit/24284ffae306ddf0ab83273e13f033520839ef40), [`f5097cc`](https://github.com/mastra-ai/mastra/commit/f5097cc8a813c82c3378882c31178320cadeb655), [`71e237f`](https://github.com/mastra-ai/mastra/commit/71e237fa852a3ad9a50a3ddb3b5f3b20b9a8181c), [`13a291e`](https://github.com/mastra-ai/mastra/commit/13a291ebb9f9bca80befa0d9166b916bb348e8e9), [`397af5a`](https://github.com/mastra-ai/mastra/commit/397af5a69f34d4157f51a7c8da3f1ded1e1d611c), [`d4701f7`](https://github.com/mastra-ai/mastra/commit/d4701f7e24822b081b70f9c806c39411b1a712e7), [`2b40831`](https://github.com/mastra-ai/mastra/commit/2b40831dcca2275c9570ddf09b7f25ba3e8dc7fc), [`6184727`](https://github.com/mastra-ai/mastra/commit/6184727e812bf7a65cee209bacec3a2f5a16e923), [`0c338b8`](https://github.com/mastra-ai/mastra/commit/0c338b87362dcd95ff8191ca00df645b6953f534), [`6f6385b`](https://github.com/mastra-ai/mastra/commit/6f6385be5b33687cd21e71fc27e972e6928bb34c), [`14aba61`](https://github.com/mastra-ai/mastra/commit/14aba61b9cff76d72bc7ef6f3a83ae2c5d059193), [`dd9dd1c`](https://github.com/mastra-ai/mastra/commit/dd9dd1c9ae32ae79093f8c4adde1732ac6357233)]:
119
+ - @mastra/core@1.7.0
120
+
121
+ ## 1.6.1-alpha.0
122
+
123
+ ### Patch Changes
124
+
125
+ - Fixed non-deterministic query ordering by adding secondary sort on id for dataset and dataset item queries. ([#13399](https://github.com/mastra-ai/mastra/pull/13399))
126
+
127
+ - Prompt blocks can now define their own variables schema (`requestContextSchema`), allowing you to create reusable prompt blocks with typed variable placeholders. The server now correctly computes and returns draft/published status for prompt blocks. Existing databases are automatically migrated when upgrading. ([#13351](https://github.com/mastra-ai/mastra/pull/13351))
128
+
129
+ - Updated dependencies [[`24284ff`](https://github.com/mastra-ai/mastra/commit/24284ffae306ddf0ab83273e13f033520839ef40), [`f5097cc`](https://github.com/mastra-ai/mastra/commit/f5097cc8a813c82c3378882c31178320cadeb655), [`71e237f`](https://github.com/mastra-ai/mastra/commit/71e237fa852a3ad9a50a3ddb3b5f3b20b9a8181c), [`13a291e`](https://github.com/mastra-ai/mastra/commit/13a291ebb9f9bca80befa0d9166b916bb348e8e9), [`397af5a`](https://github.com/mastra-ai/mastra/commit/397af5a69f34d4157f51a7c8da3f1ded1e1d611c), [`d4701f7`](https://github.com/mastra-ai/mastra/commit/d4701f7e24822b081b70f9c806c39411b1a712e7), [`2b40831`](https://github.com/mastra-ai/mastra/commit/2b40831dcca2275c9570ddf09b7f25ba3e8dc7fc), [`6184727`](https://github.com/mastra-ai/mastra/commit/6184727e812bf7a65cee209bacec3a2f5a16e923), [`6f6385b`](https://github.com/mastra-ai/mastra/commit/6f6385be5b33687cd21e71fc27e972e6928bb34c), [`14aba61`](https://github.com/mastra-ai/mastra/commit/14aba61b9cff76d72bc7ef6f3a83ae2c5d059193), [`dd9dd1c`](https://github.com/mastra-ai/mastra/commit/dd9dd1c9ae32ae79093f8c4adde1732ac6357233)]:
130
+ - @mastra/core@1.7.0-alpha.0
131
+
132
+ ## 1.6.0
133
+
134
+ ### Minor Changes
135
+
136
+ - Added MCP server table and CRUD operations to storage adapters, enabling MCP server configurations to be persisted alongside agents and workflows. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
137
+
138
+ ### Patch Changes
139
+
140
+ - Added storage schema support for processor graphs on stored agents. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
141
+
142
+ - Storage adapters now return `suggestedContinuation` and `currentTask` fields on Observational Memory activation, enabling agents to maintain conversational context across activation boundaries. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
143
+
144
+ - Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`5caa13d`](https://github.com/mastra-ai/mastra/commit/5caa13d1b2a496e2565ab124a11de9a51ad3e3b9), [`940163f`](https://github.com/mastra-ai/mastra/commit/940163fc492401d7562301e6f106ccef4fefe06f), [`47892c8`](https://github.com/mastra-ai/mastra/commit/47892c85708eac348209f99f10f9a5f5267e11c0), [`45bb78b`](https://github.com/mastra-ai/mastra/commit/45bb78b70bd9db29678fe49476cd9f4ed01bfd0b), [`70eef84`](https://github.com/mastra-ai/mastra/commit/70eef84b8f44493598fdafa2980a0e7283415eda), [`d84e52d`](https://github.com/mastra-ai/mastra/commit/d84e52d0f6511283ddd21ed5fe7f945449d0f799), [`24b80af`](https://github.com/mastra-ai/mastra/commit/24b80af87da93bb84d389340181e17b7477fa9ca), [`608e156`](https://github.com/mastra-ai/mastra/commit/608e156def954c9604c5e3f6d9dfce3bcc7aeab0), [`2b2e157`](https://github.com/mastra-ai/mastra/commit/2b2e157a092cd597d9d3f0000d62b8bb4a7348ed), [`59d30b5`](https://github.com/mastra-ai/mastra/commit/59d30b5d0cb44ea7a1c440e7460dfb57eac9a9b5), [`453693b`](https://github.com/mastra-ai/mastra/commit/453693bf9e265ddccecef901d50da6caaea0fbc6), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`c204b63`](https://github.com/mastra-ai/mastra/commit/c204b632d19e66acb6d6e19b11c4540dd6ad5380), [`742a417`](https://github.com/mastra-ai/mastra/commit/742a417896088220a3b5560c354c45c5ca6d88b9)]:
145
+ - @mastra/core@1.6.0
146
+
147
+ ## 1.6.0-alpha.0
148
+
149
+ ### Minor Changes
150
+
151
+ - Added MCP server table and CRUD operations to storage adapters, enabling MCP server configurations to be persisted alongside agents and workflows. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
152
+
153
+ ### Patch Changes
154
+
155
+ - Added storage schema support for processor graphs on stored agents. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
156
+
157
+ - Storage adapters now return `suggestedContinuation` and `currentTask` fields on Observational Memory activation, enabling agents to maintain conversational context across activation boundaries. ([#13357](https://github.com/mastra-ai/mastra/pull/13357))
158
+
159
+ - Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`5caa13d`](https://github.com/mastra-ai/mastra/commit/5caa13d1b2a496e2565ab124a11de9a51ad3e3b9), [`940163f`](https://github.com/mastra-ai/mastra/commit/940163fc492401d7562301e6f106ccef4fefe06f), [`b260123`](https://github.com/mastra-ai/mastra/commit/b2601234bd093d358c92081a58f9b0befdae52b3), [`47892c8`](https://github.com/mastra-ai/mastra/commit/47892c85708eac348209f99f10f9a5f5267e11c0), [`45bb78b`](https://github.com/mastra-ai/mastra/commit/45bb78b70bd9db29678fe49476cd9f4ed01bfd0b), [`70eef84`](https://github.com/mastra-ai/mastra/commit/70eef84b8f44493598fdafa2980a0e7283415eda), [`d84e52d`](https://github.com/mastra-ai/mastra/commit/d84e52d0f6511283ddd21ed5fe7f945449d0f799), [`24b80af`](https://github.com/mastra-ai/mastra/commit/24b80af87da93bb84d389340181e17b7477fa9ca), [`608e156`](https://github.com/mastra-ai/mastra/commit/608e156def954c9604c5e3f6d9dfce3bcc7aeab0), [`2b2e157`](https://github.com/mastra-ai/mastra/commit/2b2e157a092cd597d9d3f0000d62b8bb4a7348ed), [`59d30b5`](https://github.com/mastra-ai/mastra/commit/59d30b5d0cb44ea7a1c440e7460dfb57eac9a9b5), [`453693b`](https://github.com/mastra-ai/mastra/commit/453693bf9e265ddccecef901d50da6caaea0fbc6), [`78d1c80`](https://github.com/mastra-ai/mastra/commit/78d1c808ad90201897a300af551bcc1d34458a20), [`c204b63`](https://github.com/mastra-ai/mastra/commit/c204b632d19e66acb6d6e19b11c4540dd6ad5380), [`742a417`](https://github.com/mastra-ai/mastra/commit/742a417896088220a3b5560c354c45c5ca6d88b9)]:
160
+ - @mastra/core@1.6.0-alpha.0
161
+
162
+ ## 1.5.0
163
+
164
+ ### Minor Changes
165
+
166
+ - Added workspace and skill storage domains with full CRUD, versioning, and implementations across LibSQL, Postgres, and MongoDB. Added `editor.workspace` and `editor.skill` namespaces for managing workspace configurations and skill definitions through the editor. Agents stored in the editor can now reference workspaces (by ID or inline config) and skills, with full hydration to runtime `Workspace` instances during agent resolution. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
167
+
168
+ **Filesystem-native skill versioning (draft → publish model):**
169
+
170
+ Skills are versioned as filesystem trees with content-addressable blob storage. The editing surface (live filesystem) is separated from the serving surface (versioned blob store), enabling a `draft → publish` workflow:
171
+ - `editor.skill.publish(skillId, source, skillPath)` — Snapshots a skill directory from the filesystem into blob storage, creates a new version with a tree manifest, and sets `activeVersionId`
172
+ - Version switching via `editor.skill.update({ id, activeVersionId })` — Points the skill to a previous version without re-publishing
173
+ - Publishing a skill automatically invalidates cached agents that reference it, so they re-hydrate with the updated version on next access
174
+
175
+ **Agent skill resolution strategies:**
176
+
177
+ Agents can reference skills with different resolution strategies:
178
+ - `strategy: 'latest'` — Resolves the skill's active version (honors `activeVersionId` for rollback)
179
+ - `pin: '<versionId>'` — Pins to a specific version, immune to publishes
180
+ - `strategy: 'live'` — Reads directly from the live filesystem (no blob store)
181
+
182
+ **Blob storage infrastructure:**
183
+ - `BlobStore` abstract class for content-addressable storage keyed by SHA-256 hash
184
+ - `InMemoryBlobStore` for testing
185
+ - LibSQL, Postgres, and MongoDB implementations
186
+ - `S3BlobStore` for storing blobs in S3 or S3-compatible storage (AWS, R2, MinIO, DO Spaces)
187
+ - `BlobStoreProvider` interface and `MastraEditorConfig.blobStores` registry for pluggable blob storage
188
+ - `VersionedSkillSource` and `CompositeVersionedSkillSource` for reading skill files from the blob store at runtime
189
+
190
+ **New storage types:**
191
+ - `StorageWorkspaceSnapshotType` and `StorageSkillSnapshotType` with corresponding input/output types
192
+ - `StorageWorkspaceRef` for ID-based or inline workspace references on agents
193
+ - `StorageSkillConfig` for per-agent skill overrides (`pin`, `strategy`, description, instructions)
194
+ - `SkillVersionTree` and `SkillVersionTreeEntry` for tree manifests
195
+ - `StorageBlobEntry` for content-addressable blob entries
196
+ - `SKILL_BLOBS_SCHEMA` for the `mastra_skill_blobs` table
197
+
198
+ **New editor namespaces:**
199
+ - `editor.workspace` — CRUD for workspace configs, plus `hydrateSnapshotToWorkspace()` for resolving to runtime `Workspace` instances
200
+ - `editor.skill` — CRUD for skill definitions, plus `publish()` for filesystem-to-blob snapshots
201
+
202
+ **Provider registries:**
203
+ - `MastraEditorConfig` accepts `filesystems`, `sandboxes`, and `blobStores` provider registries (keyed by provider ID)
204
+ - Built-in `local` filesystem and sandbox providers are auto-registered
205
+ - `editor.resolveBlobStore()` resolves from provider registry or falls back to the storage backend's blobs domain
206
+ - Providers expose `id`, `name`, `description`, `configSchema` (JSON Schema for UI form rendering), and a factory method
207
+
208
+ **Storage adapter support:**
209
+ - LibSQL: Full `workspaces`, `skills`, and `blobs` domain implementations
210
+ - Postgres: Full `workspaces`, `skills`, and `blobs` domain implementations
211
+ - MongoDB: Full `workspaces`, `skills`, and `blobs` domain implementations
212
+ - All three include `workspace`, `skills`, and `skillsFormat` fields on agent versions
213
+
214
+ **Server endpoints:**
215
+ - `GET/POST/PATCH/DELETE /stored/workspaces` — CRUD for stored workspaces
216
+ - `GET/POST/PATCH/DELETE /stored/skills` — CRUD for stored skills
217
+ - `POST /stored/skills/:id/publish` — Publish a skill from a filesystem source
218
+
219
+ ```ts
220
+ import { MastraEditor } from '@mastra/editor';
221
+ import { s3FilesystemProvider, s3BlobStoreProvider } from '@mastra/s3';
222
+ import { e2bSandboxProvider } from '@mastra/e2b';
223
+
224
+ const editor = new MastraEditor({
225
+ filesystems: { s3: s3FilesystemProvider },
226
+ sandboxes: { e2b: e2bSandboxProvider },
227
+ blobStores: { s3: s3BlobStoreProvider },
228
+ });
229
+
230
+ // Create a skill and publish it
231
+ const skill = await editor.skill.create({
232
+ name: 'Code Review',
233
+ description: 'Reviews code for best practices',
234
+ instructions: 'Analyze the code and provide feedback...',
235
+ });
236
+ await editor.skill.publish(skill.id, source, 'skills/code-review');
237
+
238
+ // Agents resolve skills by strategy
239
+ await editor.agent.create({
240
+ name: 'Dev Assistant',
241
+ model: { provider: 'openai', name: 'gpt-4' },
242
+ workspace: { type: 'id', workspaceId: workspace.id },
243
+ skills: { [skill.id]: { strategy: 'latest' } },
244
+ skillsFormat: 'xml',
245
+ });
246
+ ```
247
+
248
+ - Added draft/publish version management for all editor primitives (agents, scorers, MCP clients, prompt blocks). ([#13061](https://github.com/mastra-ai/mastra/pull/13061))
249
+
250
+ **Status filtering on list endpoints** — All list endpoints now accept a `?status=draft|published|archived` query parameter to filter by entity status. Defaults to `published` to preserve backward compatibility.
251
+
252
+ **Draft vs published resolution on get-by-id endpoints** — All get-by-id endpoints now accept `?status=draft` to resolve the entity with its latest (unpublished) version, or `?status=published` (default) to resolve with the active published version.
253
+
254
+ **Edits no longer auto-publish** — When updating any primitive, a new version is created but `activeVersionId` is no longer automatically updated. Edits stay as drafts until explicitly published via the activate endpoint.
255
+
256
+ **Full version management for all primitives** — Scorers, MCP clients, and prompt blocks now have the same version management API that agents have: list versions, create version snapshots, get specific versions, activate/publish, restore from a previous version, delete versions, and compare versions.
257
+
258
+ **New prompt block CRUD routes** — Prompt blocks now have full server routes (`GET /stored/prompt-blocks`, `GET /stored/prompt-blocks/:id`, `POST`, `PATCH`, `DELETE`).
259
+
260
+ **New version endpoints** — Each primitive now exposes 7 version management endpoints under `/stored/{type}/:id/versions` (list, create, get, activate, restore, delete, compare).
261
+
262
+ ```ts
263
+ // Fetch the published version (default behavior, backward compatible)
264
+ const published = await fetch('/api/stored/scorers/my-scorer');
265
+
266
+ // Fetch the draft version for editing in the UI
267
+ const draft = await fetch('/api/stored/scorers/my-scorer?status=draft');
268
+
269
+ // Publish a specific version
270
+ await fetch('/api/stored/scorers/my-scorer/versions/abc123/activate', { method: 'POST' });
271
+
272
+ // Compare two versions
273
+ const diff = await fetch('/api/stored/scorers/my-scorer/versions/compare?from=v1&to=v2');
274
+ ```
275
+
276
+ ### Patch Changes
277
+
278
+ - Dataset schemas now appear in the Edit Dataset dialog. Previously the `inputSchema` and `groundTruthSchema` fields were not passed to the dialog, so editing a dataset always showed empty schemas. ([#13175](https://github.com/mastra-ai/mastra/pull/13175))
279
+
280
+ Schema edits in the JSON editor no longer cause the cursor to jump to the top of the field. Typing `{"type": "object"}` in the schema editor now behaves like a normal text input instead of resetting on every keystroke.
281
+
282
+ Validation errors are now surfaced when updating a dataset schema that conflicts with existing items. For example, adding a `required: ["name"]` constraint when existing items lack a `name` field now shows "2 existing item(s) fail validation" in the dialog instead of silently dropping the error.
283
+
284
+ Disabling a dataset schema from the Studio UI now correctly clears it. Previously the server converted `null` (disable) to `undefined` (no change), so the old schema persisted and validation continued.
285
+
286
+ Workflow schemas fetched via `client.getWorkflow().getSchema()` are now correctly parsed. The server serializes schemas with `superjson`, but the client was using plain `JSON.parse`, yielding a `{json: {...}}` wrapper instead of the actual JSON Schema object.
287
+
288
+ - CMS draft support with status badges for agents. ([#13194](https://github.com/mastra-ai/mastra/pull/13194))
289
+ - Agent list now resolves the latest (draft) version for each stored agent, showing current edits rather than the last published state.
290
+ - Added `hasDraft` and `activeVersionId` fields to the agent list API response.
291
+ - Agent list badges: "Published" (green) when a published version exists, "Draft" (colored when unpublished changes exist, grayed out otherwise).
292
+ - Added `resolvedVersionId` to all `StorageResolved*Type` types so the server can detect whether the latest version differs from the active version.
293
+ - Added `status` option to `GetByIdOptions` to allow resolving draft vs published versions through the editor layer.
294
+ - Fixed editor cache not being cleared on version activate, restore, and delete — all four versioned domains (agents, scorers, prompt-blocks, mcp-clients) now clear the cache after version mutations.
295
+ - Added `ALTER TABLE` migration for `mastra_agent_versions` in libsql and pg to add newer columns (`mcpClients`, `requestContextSchema`, `workspace`, `skills`, `skillsFormat`).
296
+
297
+ - Added scorer version management and CMS draft/publish flow for scorers. ([#13194](https://github.com/mastra-ai/mastra/pull/13194))
298
+ - Added scorer version methods to the client SDK: `listVersions`, `createVersion`, `getVersion`, `activateVersion`, `restoreVersion`, `deleteVersion`, `compareVersions`.
299
+ - Added `ScorerVersionCombobox` for navigating scorer versions with Published/Draft labels.
300
+ - Scorer edit page now supports Save (draft) and Publish workflows with an "Unpublished changes" indicator.
301
+ - Storage list methods for agents and scorers no longer default to filtering only published entities, allowing drafts to appear in the playground.
302
+
303
+ - Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
304
+ - @mastra/core@1.5.0
305
+
306
+ ## 1.5.0-alpha.0
307
+
308
+ ### Minor Changes
309
+
310
+ - Added workspace and skill storage domains with full CRUD, versioning, and implementations across LibSQL, Postgres, and MongoDB. Added `editor.workspace` and `editor.skill` namespaces for managing workspace configurations and skill definitions through the editor. Agents stored in the editor can now reference workspaces (by ID or inline config) and skills, with full hydration to runtime `Workspace` instances during agent resolution. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
311
+
312
+ **Filesystem-native skill versioning (draft → publish model):**
313
+
314
+ Skills are versioned as filesystem trees with content-addressable blob storage. The editing surface (live filesystem) is separated from the serving surface (versioned blob store), enabling a `draft → publish` workflow:
315
+ - `editor.skill.publish(skillId, source, skillPath)` — Snapshots a skill directory from the filesystem into blob storage, creates a new version with a tree manifest, and sets `activeVersionId`
316
+ - Version switching via `editor.skill.update({ id, activeVersionId })` — Points the skill to a previous version without re-publishing
317
+ - Publishing a skill automatically invalidates cached agents that reference it, so they re-hydrate with the updated version on next access
318
+
319
+ **Agent skill resolution strategies:**
320
+
321
+ Agents can reference skills with different resolution strategies:
322
+ - `strategy: 'latest'` — Resolves the skill's active version (honors `activeVersionId` for rollback)
323
+ - `pin: '<versionId>'` — Pins to a specific version, immune to publishes
324
+ - `strategy: 'live'` — Reads directly from the live filesystem (no blob store)
325
+
326
+ **Blob storage infrastructure:**
327
+ - `BlobStore` abstract class for content-addressable storage keyed by SHA-256 hash
328
+ - `InMemoryBlobStore` for testing
329
+ - LibSQL, Postgres, and MongoDB implementations
330
+ - `S3BlobStore` for storing blobs in S3 or S3-compatible storage (AWS, R2, MinIO, DO Spaces)
331
+ - `BlobStoreProvider` interface and `MastraEditorConfig.blobStores` registry for pluggable blob storage
332
+ - `VersionedSkillSource` and `CompositeVersionedSkillSource` for reading skill files from the blob store at runtime
333
+
334
+ **New storage types:**
335
+ - `StorageWorkspaceSnapshotType` and `StorageSkillSnapshotType` with corresponding input/output types
336
+ - `StorageWorkspaceRef` for ID-based or inline workspace references on agents
337
+ - `StorageSkillConfig` for per-agent skill overrides (`pin`, `strategy`, description, instructions)
338
+ - `SkillVersionTree` and `SkillVersionTreeEntry` for tree manifests
339
+ - `StorageBlobEntry` for content-addressable blob entries
340
+ - `SKILL_BLOBS_SCHEMA` for the `mastra_skill_blobs` table
341
+
342
+ **New editor namespaces:**
343
+ - `editor.workspace` — CRUD for workspace configs, plus `hydrateSnapshotToWorkspace()` for resolving to runtime `Workspace` instances
344
+ - `editor.skill` — CRUD for skill definitions, plus `publish()` for filesystem-to-blob snapshots
345
+
346
+ **Provider registries:**
347
+ - `MastraEditorConfig` accepts `filesystems`, `sandboxes`, and `blobStores` provider registries (keyed by provider ID)
348
+ - Built-in `local` filesystem and sandbox providers are auto-registered
349
+ - `editor.resolveBlobStore()` resolves from provider registry or falls back to the storage backend's blobs domain
350
+ - Providers expose `id`, `name`, `description`, `configSchema` (JSON Schema for UI form rendering), and a factory method
351
+
352
+ **Storage adapter support:**
353
+ - LibSQL: Full `workspaces`, `skills`, and `blobs` domain implementations
354
+ - Postgres: Full `workspaces`, `skills`, and `blobs` domain implementations
355
+ - MongoDB: Full `workspaces`, `skills`, and `blobs` domain implementations
356
+ - All three include `workspace`, `skills`, and `skillsFormat` fields on agent versions
357
+
358
+ **Server endpoints:**
359
+ - `GET/POST/PATCH/DELETE /stored/workspaces` — CRUD for stored workspaces
360
+ - `GET/POST/PATCH/DELETE /stored/skills` — CRUD for stored skills
361
+ - `POST /stored/skills/:id/publish` — Publish a skill from a filesystem source
362
+
363
+ ```ts
364
+ import { MastraEditor } from '@mastra/editor';
365
+ import { s3FilesystemProvider, s3BlobStoreProvider } from '@mastra/s3';
366
+ import { e2bSandboxProvider } from '@mastra/e2b';
367
+
368
+ const editor = new MastraEditor({
369
+ filesystems: { s3: s3FilesystemProvider },
370
+ sandboxes: { e2b: e2bSandboxProvider },
371
+ blobStores: { s3: s3BlobStoreProvider },
372
+ });
373
+
374
+ // Create a skill and publish it
375
+ const skill = await editor.skill.create({
376
+ name: 'Code Review',
377
+ description: 'Reviews code for best practices',
378
+ instructions: 'Analyze the code and provide feedback...',
379
+ });
380
+ await editor.skill.publish(skill.id, source, 'skills/code-review');
381
+
382
+ // Agents resolve skills by strategy
383
+ await editor.agent.create({
384
+ name: 'Dev Assistant',
385
+ model: { provider: 'openai', name: 'gpt-4' },
386
+ workspace: { type: 'id', workspaceId: workspace.id },
387
+ skills: { [skill.id]: { strategy: 'latest' } },
388
+ skillsFormat: 'xml',
389
+ });
390
+ ```
391
+
392
+ - Added draft/publish version management for all editor primitives (agents, scorers, MCP clients, prompt blocks). ([#13061](https://github.com/mastra-ai/mastra/pull/13061))
393
+
394
+ **Status filtering on list endpoints** — All list endpoints now accept a `?status=draft|published|archived` query parameter to filter by entity status. Defaults to `published` to preserve backward compatibility.
395
+
396
+ **Draft vs published resolution on get-by-id endpoints** — All get-by-id endpoints now accept `?status=draft` to resolve the entity with its latest (unpublished) version, or `?status=published` (default) to resolve with the active published version.
397
+
398
+ **Edits no longer auto-publish** — When updating any primitive, a new version is created but `activeVersionId` is no longer automatically updated. Edits stay as drafts until explicitly published via the activate endpoint.
399
+
400
+ **Full version management for all primitives** — Scorers, MCP clients, and prompt blocks now have the same version management API that agents have: list versions, create version snapshots, get specific versions, activate/publish, restore from a previous version, delete versions, and compare versions.
401
+
402
+ **New prompt block CRUD routes** — Prompt blocks now have full server routes (`GET /stored/prompt-blocks`, `GET /stored/prompt-blocks/:id`, `POST`, `PATCH`, `DELETE`).
403
+
404
+ **New version endpoints** — Each primitive now exposes 7 version management endpoints under `/stored/{type}/:id/versions` (list, create, get, activate, restore, delete, compare).
405
+
406
+ ```ts
407
+ // Fetch the published version (default behavior, backward compatible)
408
+ const published = await fetch('/api/stored/scorers/my-scorer');
409
+
410
+ // Fetch the draft version for editing in the UI
411
+ const draft = await fetch('/api/stored/scorers/my-scorer?status=draft');
412
+
413
+ // Publish a specific version
414
+ await fetch('/api/stored/scorers/my-scorer/versions/abc123/activate', { method: 'POST' });
415
+
416
+ // Compare two versions
417
+ const diff = await fetch('/api/stored/scorers/my-scorer/versions/compare?from=v1&to=v2');
418
+ ```
419
+
420
+ ### Patch Changes
421
+
422
+ - Dataset schemas now appear in the Edit Dataset dialog. Previously the `inputSchema` and `groundTruthSchema` fields were not passed to the dialog, so editing a dataset always showed empty schemas. ([#13175](https://github.com/mastra-ai/mastra/pull/13175))
423
+
424
+ Schema edits in the JSON editor no longer cause the cursor to jump to the top of the field. Typing `{"type": "object"}` in the schema editor now behaves like a normal text input instead of resetting on every keystroke.
425
+
426
+ Validation errors are now surfaced when updating a dataset schema that conflicts with existing items. For example, adding a `required: ["name"]` constraint when existing items lack a `name` field now shows "2 existing item(s) fail validation" in the dialog instead of silently dropping the error.
427
+
428
+ Disabling a dataset schema from the Studio UI now correctly clears it. Previously the server converted `null` (disable) to `undefined` (no change), so the old schema persisted and validation continued.
429
+
430
+ Workflow schemas fetched via `client.getWorkflow().getSchema()` are now correctly parsed. The server serializes schemas with `superjson`, but the client was using plain `JSON.parse`, yielding a `{json: {...}}` wrapper instead of the actual JSON Schema object.
431
+
432
+ - CMS draft support with status badges for agents. ([#13194](https://github.com/mastra-ai/mastra/pull/13194))
433
+ - Agent list now resolves the latest (draft) version for each stored agent, showing current edits rather than the last published state.
434
+ - Added `hasDraft` and `activeVersionId` fields to the agent list API response.
435
+ - Agent list badges: "Published" (green) when a published version exists, "Draft" (colored when unpublished changes exist, grayed out otherwise).
436
+ - Added `resolvedVersionId` to all `StorageResolved*Type` types so the server can detect whether the latest version differs from the active version.
437
+ - Added `status` option to `GetByIdOptions` to allow resolving draft vs published versions through the editor layer.
438
+ - Fixed editor cache not being cleared on version activate, restore, and delete — all four versioned domains (agents, scorers, prompt-blocks, mcp-clients) now clear the cache after version mutations.
439
+ - Added `ALTER TABLE` migration for `mastra_agent_versions` in libsql and pg to add newer columns (`mcpClients`, `requestContextSchema`, `workspace`, `skills`, `skillsFormat`).
440
+
441
+ - Added scorer version management and CMS draft/publish flow for scorers. ([#13194](https://github.com/mastra-ai/mastra/pull/13194))
442
+ - Added scorer version methods to the client SDK: `listVersions`, `createVersion`, `getVersion`, `activateVersion`, `restoreVersion`, `deleteVersion`, `compareVersions`.
443
+ - Added `ScorerVersionCombobox` for navigating scorer versions with Published/Draft labels.
444
+ - Scorer edit page now supports Save (draft) and Publish workflows with an "Unpublished changes" indicator.
445
+ - Storage list methods for agents and scorers no longer default to filtering only published entities, allowing drafts to appear in the playground.
446
+
447
+ - Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
448
+ - @mastra/core@1.5.0-alpha.0
449
+
450
+ ## 1.4.0
451
+
452
+ ### Minor Changes
453
+
454
+ - Added datasets and experiments storage implementations. Includes dataset CRUD, item versioning with SCD-2, experiment runs with scorer results, and table/type configurations for dataset and experiment tables. ([#12747](https://github.com/mastra-ai/mastra/pull/12747))
455
+
456
+ **Requires `@mastra/core` >= 1.4.0**
457
+
458
+ ### Patch Changes
459
+
460
+ - Fixed agent version storage to persist the requestContextSchema field. Previously, requestContextSchema was defined on the agent snapshot type but was not included in the database schema, INSERT statements, or row parsing logic, causing it to be silently dropped when saving and loading agent versions. ([#13003](https://github.com/mastra-ai/mastra/pull/13003))
461
+
462
+ - Added MCP client storage domain and ToolProvider interface for integrating external tool catalogs with stored agents. ([#12974](https://github.com/mastra-ai/mastra/pull/12974))
463
+
464
+ **MCP Client Storage**
465
+
466
+ New storage domain for persisting MCP client configurations with CRUD operations. Each MCP client can contain multiple servers with independent tool selection:
467
+
468
+ ```ts
469
+ // Store an MCP client with multiple servers
470
+ await storage.mcpClients.create({
471
+ id: 'my-mcp',
472
+ name: 'My MCP Client',
473
+ servers: {
474
+ 'github-server': { url: 'https://mcp.github.com/sse' },
475
+ 'slack-server': { url: 'https://mcp.slack.com/sse' },
476
+ },
477
+ });
478
+ ```
479
+
480
+ LibSQL, PostgreSQL, and MongoDB storage adapters all implement the new MCP client domain.
481
+
482
+ **ToolProvider Interface**
483
+
484
+ New `ToolProvider` interface at `@mastra/core/tool-provider` enables third-party tool catalog integration (e.g., Composio, Arcade AI):
485
+
486
+ ```ts
487
+ import type { ToolProvider } from '@mastra/core/tool-provider';
488
+
489
+ # Providers implement: listToolkits(), listTools(), getToolSchema(), resolveTools()
490
+ ```
491
+
492
+ `resolveTools()` receives `requestContext` from the current request, enabling per-user API keys and credentials in multi-tenant setups:
493
+
494
+ ```ts
495
+ const tools = await provider.resolveTools(slugs, configs, {
496
+ requestContext: { apiKey: 'user-specific-key', userId: 'tenant-123' },
497
+ });
498
+ ```
499
+
500
+ **Tool Selection Semantics**
501
+
502
+ Both `mcpClients` and `integrationTools` on stored agents follow consistent three-state selection:
503
+ - `{ tools: undefined }` — provider registered, no tools selected
504
+ - `{ tools: {} }` — all tools from provider included
505
+ - `{ tools: { 'TOOL_SLUG': { description: '...' } } }` — specific tools with optional overrides
506
+
507
+ - Updated dependencies [[`7ef618f`](https://github.com/mastra-ai/mastra/commit/7ef618f3c49c27e2f6b27d7f564c557c0734325b), [`b373564`](https://github.com/mastra-ai/mastra/commit/b37356491d43b4d53067f10cb669abaf2502f218), [`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`b896b41`](https://github.com/mastra-ai/mastra/commit/b896b41343de7fcc14442fb40fe82d189e65bbe2), [`6415277`](https://github.com/mastra-ai/mastra/commit/6415277a438faa00db2af850ead5dee25f40c428), [`0831bbb`](https://github.com/mastra-ai/mastra/commit/0831bbb5bc750c18e9b22b45f18687c964b70828), [`63f7eda`](https://github.com/mastra-ai/mastra/commit/63f7eda605eb3e0c8c35ee3912ffe7c999c69f69), [`a5b67a3`](https://github.com/mastra-ai/mastra/commit/a5b67a3589a74415feb663a55d1858324a2afde9), [`877b02c`](https://github.com/mastra-ai/mastra/commit/877b02cdbb15e199184c7f2b8f217be8d3ebada7), [`7567222`](https://github.com/mastra-ai/mastra/commit/7567222b1366f0d39980594792dd9d5060bfe2ab), [`af71458`](https://github.com/mastra-ai/mastra/commit/af71458e3b566f09c11d0e5a0a836dc818e7a24a), [`eb36bd8`](https://github.com/mastra-ai/mastra/commit/eb36bd8c52fcd6ec9674ac3b7a6412405b5983e1), [`3cbf121`](https://github.com/mastra-ai/mastra/commit/3cbf121f55418141924754a83102aade89835947)]:
508
+ - @mastra/core@1.4.0
509
+
510
+ ## 1.4.0-alpha.0
511
+
512
+ ### Minor Changes
513
+
514
+ - Added datasets and experiments storage implementations. Includes dataset CRUD, item versioning with SCD-2, experiment runs with scorer results, and table/type configurations for dataset and experiment tables. ([#12747](https://github.com/mastra-ai/mastra/pull/12747))
515
+
516
+ **Requires `@mastra/core` >= 1.4.0**
517
+
518
+ ### Patch Changes
519
+
520
+ - Fixed agent version storage to persist the requestContextSchema field. Previously, requestContextSchema was defined on the agent snapshot type but was not included in the database schema, INSERT statements, or row parsing logic, causing it to be silently dropped when saving and loading agent versions. ([#13003](https://github.com/mastra-ai/mastra/pull/13003))
521
+
522
+ - Added MCP client storage domain and ToolProvider interface for integrating external tool catalogs with stored agents. ([#12974](https://github.com/mastra-ai/mastra/pull/12974))
523
+
524
+ **MCP Client Storage**
525
+
526
+ New storage domain for persisting MCP client configurations with CRUD operations. Each MCP client can contain multiple servers with independent tool selection:
527
+
528
+ ```ts
529
+ // Store an MCP client with multiple servers
530
+ await storage.mcpClients.create({
531
+ id: 'my-mcp',
532
+ name: 'My MCP Client',
533
+ servers: {
534
+ 'github-server': { url: 'https://mcp.github.com/sse' },
535
+ 'slack-server': { url: 'https://mcp.slack.com/sse' },
536
+ },
537
+ });
538
+ ```
539
+
540
+ LibSQL, PostgreSQL, and MongoDB storage adapters all implement the new MCP client domain.
541
+
542
+ **ToolProvider Interface**
543
+
544
+ New `ToolProvider` interface at `@mastra/core/tool-provider` enables third-party tool catalog integration (e.g., Composio, Arcade AI):
545
+
546
+ ```ts
547
+ import type { ToolProvider } from '@mastra/core/tool-provider';
548
+
549
+ # Providers implement: listToolkits(), listTools(), getToolSchema(), resolveTools()
550
+ ```
551
+
552
+ `resolveTools()` receives `requestContext` from the current request, enabling per-user API keys and credentials in multi-tenant setups:
553
+
554
+ ```ts
555
+ const tools = await provider.resolveTools(slugs, configs, {
556
+ requestContext: { apiKey: 'user-specific-key', userId: 'tenant-123' },
557
+ });
558
+ ```
559
+
560
+ **Tool Selection Semantics**
561
+
562
+ Both `mcpClients` and `integrationTools` on stored agents follow consistent three-state selection:
563
+ - `{ tools: undefined }` — provider registered, no tools selected
564
+ - `{ tools: {} }` — all tools from provider included
565
+ - `{ tools: { 'TOOL_SLUG': { description: '...' } } }` — specific tools with optional overrides
566
+
567
+ - Updated dependencies [[`7ef618f`](https://github.com/mastra-ai/mastra/commit/7ef618f3c49c27e2f6b27d7f564c557c0734325b), [`b373564`](https://github.com/mastra-ai/mastra/commit/b37356491d43b4d53067f10cb669abaf2502f218), [`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`b896b41`](https://github.com/mastra-ai/mastra/commit/b896b41343de7fcc14442fb40fe82d189e65bbe2), [`6415277`](https://github.com/mastra-ai/mastra/commit/6415277a438faa00db2af850ead5dee25f40c428), [`0831bbb`](https://github.com/mastra-ai/mastra/commit/0831bbb5bc750c18e9b22b45f18687c964b70828), [`63f7eda`](https://github.com/mastra-ai/mastra/commit/63f7eda605eb3e0c8c35ee3912ffe7c999c69f69), [`a5b67a3`](https://github.com/mastra-ai/mastra/commit/a5b67a3589a74415feb663a55d1858324a2afde9), [`877b02c`](https://github.com/mastra-ai/mastra/commit/877b02cdbb15e199184c7f2b8f217be8d3ebada7), [`7567222`](https://github.com/mastra-ai/mastra/commit/7567222b1366f0d39980594792dd9d5060bfe2ab), [`af71458`](https://github.com/mastra-ai/mastra/commit/af71458e3b566f09c11d0e5a0a836dc818e7a24a), [`eb36bd8`](https://github.com/mastra-ai/mastra/commit/eb36bd8c52fcd6ec9674ac3b7a6412405b5983e1), [`3cbf121`](https://github.com/mastra-ai/mastra/commit/3cbf121f55418141924754a83102aade89835947)]:
568
+ - @mastra/core@1.4.0-alpha.0
569
+
570
+ ## 1.3.0
571
+
572
+ ### Minor Changes
573
+
574
+ - **Updated storage adapters for generic storage domain API** ([#12846](https://github.com/mastra-ai/mastra/pull/12846))
575
+
576
+ All storage adapters now implement the unified `VersionedStorageDomain` method names. Entity-specific methods (`createAgent`, `getAgentById`, `deleteAgent`, etc.) have been replaced with generic equivalents (`create`, `getById`, `delete`, etc.) across agents, prompt blocks, and scorer definitions domains.
577
+
578
+ Added `scorer-definitions` domain support to all adapters.
579
+
580
+ **Before:**
581
+
582
+ ```ts
583
+ const store = storage.getStore('agents');
584
+ await store.createAgent({ agent: input });
585
+ await store.getAgentById({ id: 'abc' });
586
+ await store.deleteAgent({ id: 'abc' });
587
+ ```
588
+
589
+ **After:**
590
+
591
+ ```ts
592
+ const store = storage.getStore('agents');
593
+ await store.create({ agent: input });
594
+ await store.getById('abc');
595
+ await store.delete('abc');
596
+ ```
597
+
598
+ ### Patch Changes
599
+
600
+ - Fixed observational memory progress bars resetting to zero after agent responses finish. ([#12934](https://github.com/mastra-ai/mastra/pull/12934))
601
+
602
+ - Fixed issues with stored agents ([#12790](https://github.com/mastra-ai/mastra/pull/12790))
603
+
604
+ - Supporting changes for async buffering in observational memory, including new config options, streaming events, and UI markers. ([#12891](https://github.com/mastra-ai/mastra/pull/12891))
605
+
606
+ - Added prompt block storage implementations. Each store supports full CRUD for prompt blocks and their versions, including JSON serialization for rules and metadata. Also updated agent instructions serialization to support the new `AgentInstructionBlock` array format alongside plain strings. ([#12776](https://github.com/mastra-ai/mastra/pull/12776))
607
+
608
+ - Updated dependencies [[`717ffab`](https://github.com/mastra-ai/mastra/commit/717ffab42cfd58ff723b5c19ada4939997773004), [`b31c922`](https://github.com/mastra-ai/mastra/commit/b31c922215b513791d98feaea1b98784aa00803a), [`e4b6dab`](https://github.com/mastra-ai/mastra/commit/e4b6dab171c5960e340b3ea3ea6da8d64d2b8672), [`5719fa8`](https://github.com/mastra-ai/mastra/commit/5719fa8880e86e8affe698ec4b3807c7e0e0a06f), [`83cda45`](https://github.com/mastra-ai/mastra/commit/83cda4523e588558466892bff8f80f631a36945a), [`11804ad`](https://github.com/mastra-ai/mastra/commit/11804adf1d6be46ebe216be40a43b39bb8b397d7), [`aa95f95`](https://github.com/mastra-ai/mastra/commit/aa95f958b186ae5c9f4219c88e268f5565c277a2), [`90f7894`](https://github.com/mastra-ai/mastra/commit/90f7894568dc9481f40a4d29672234fae23090bb), [`f5501ae`](https://github.com/mastra-ai/mastra/commit/f5501aedb0a11106c7db7e480d6eaf3971b7bda8), [`44573af`](https://github.com/mastra-ai/mastra/commit/44573afad0a4bc86f627d6cbc0207961cdcb3bc3), [`00e3861`](https://github.com/mastra-ai/mastra/commit/00e3861863fbfee78faeb1ebbdc7c0223aae13ff), [`8109aee`](https://github.com/mastra-ai/mastra/commit/8109aeeab758e16cd4255a6c36f044b70eefc6a6), [`7bfbc52`](https://github.com/mastra-ai/mastra/commit/7bfbc52a8604feb0fff2c0a082c13c0c2a3df1a2), [`1445994`](https://github.com/mastra-ai/mastra/commit/1445994aee19c9334a6a101cf7bd80ca7ed4d186), [`61f44a2`](https://github.com/mastra-ai/mastra/commit/61f44a26861c89e364f367ff40825bdb7f19df55), [`37145d2`](https://github.com/mastra-ai/mastra/commit/37145d25f99dc31f1a9105576e5452609843ce32), [`fdad759`](https://github.com/mastra-ai/mastra/commit/fdad75939ff008b27625f5ec0ce9c6915d99d9ec), [`e4569c5`](https://github.com/mastra-ai/mastra/commit/e4569c589e00c4061a686c9eb85afe1b7050b0a8), [`7309a85`](https://github.com/mastra-ai/mastra/commit/7309a85427281a8be23f4fb80ca52e18eaffd596), [`99424f6`](https://github.com/mastra-ai/mastra/commit/99424f6862ffb679c4ec6765501486034754a4c2), [`44eb452`](https://github.com/mastra-ai/mastra/commit/44eb4529b10603c279688318bebf3048543a1d61), [`6c40593`](https://github.com/mastra-ai/mastra/commit/6c40593d6d2b1b68b0c45d1a3a4c6ac5ecac3937), [`8c1135d`](https://github.com/mastra-ai/mastra/commit/8c1135dfb91b057283eae7ee11f9ec28753cc64f), [`dd39e54`](https://github.com/mastra-ai/mastra/commit/dd39e54ea34532c995b33bee6e0e808bf41a7341), [`b6fad9a`](https://github.com/mastra-ai/mastra/commit/b6fad9a602182b1cc0df47cd8c55004fa829ad61), [`4129c07`](https://github.com/mastra-ai/mastra/commit/4129c073349b5a66643fd8136ebfe9d7097cf793), [`5b930ab`](https://github.com/mastra-ai/mastra/commit/5b930aba1834d9898e8460a49d15106f31ac7c8d), [`4be93d0`](https://github.com/mastra-ai/mastra/commit/4be93d09d68e20aaf0ea3f210749422719618b5f), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`8c90ff4`](https://github.com/mastra-ai/mastra/commit/8c90ff4d3414e7f2a2d216ea91274644f7b29133), [`ed232d1`](https://github.com/mastra-ai/mastra/commit/ed232d1583f403925dc5ae45f7bee948cf2a182b), [`3891795`](https://github.com/mastra-ai/mastra/commit/38917953518eb4154a984ee36e6ededdcfe80f72), [`4f955b2`](https://github.com/mastra-ai/mastra/commit/4f955b20c7f66ed282ee1fd8709696fa64c4f19d), [`55a4c90`](https://github.com/mastra-ai/mastra/commit/55a4c9044ac7454349b9f6aeba0bbab5ee65d10f)]:
609
+ - @mastra/core@1.3.0
610
+
611
+ ## 1.3.0-alpha.1
612
+
613
+ ### Patch Changes
614
+
615
+ - Fixed observational memory progress bars resetting to zero after agent responses finish. The messages and observations sidebar bars now retain their values on stream completion, cancellation, and page reload. Also added a buffer-status endpoint so buffering badges resolve with accurate token counts instead of spinning forever when buffering outlives the stream. ([#12934](https://github.com/mastra-ai/mastra/pull/12934))
616
+
617
+ - Updated dependencies [[`b31c922`](https://github.com/mastra-ai/mastra/commit/b31c922215b513791d98feaea1b98784aa00803a)]:
618
+ - @mastra/core@1.3.0-alpha.2
619
+
620
+ ## 1.3.0-alpha.0
621
+
622
+ ### Minor Changes
623
+
624
+ - **Updated storage adapters for generic storage domain API** ([#12846](https://github.com/mastra-ai/mastra/pull/12846))
625
+
626
+ All storage adapters now implement the unified `VersionedStorageDomain` method names. Entity-specific methods (`createAgent`, `getAgentById`, `deleteAgent`, etc.) have been replaced with generic equivalents (`create`, `getById`, `delete`, etc.) across agents, prompt blocks, and scorer definitions domains.
627
+
628
+ Added `scorer-definitions` domain support to all adapters.
629
+
630
+ **Before:**
631
+
632
+ ```ts
633
+ const store = storage.getStore('agents');
634
+ await store.createAgent({ agent: input });
635
+ await store.getAgentById({ id: 'abc' });
636
+ await store.deleteAgent({ id: 'abc' });
637
+ ```
638
+
639
+ **After:**
640
+
641
+ ```ts
642
+ const store = storage.getStore('agents');
643
+ await store.create({ agent: input });
644
+ await store.getById('abc');
645
+ await store.delete('abc');
646
+ ```
647
+
648
+ ### Patch Changes
649
+
650
+ - Fixed issues with stored agents ([#12790](https://github.com/mastra-ai/mastra/pull/12790))
651
+
652
+ - **Async buffering for observational memory is now enabled by default.** Observations are pre-computed in the background as conversations grow — when the context window fills up, buffered observations activate instantly with no blocking LLM call. This keeps agents responsive during long conversations. ([#12891](https://github.com/mastra-ai/mastra/pull/12891))
653
+
654
+ **Default settings:**
655
+ - `observation.bufferTokens: 0.2` — buffer every 20% of `messageTokens` (~6k tokens with the default 30k threshold)
656
+ - `observation.bufferActivation: 0.8` — on activation, retain 20% of the message window
657
+ - `reflection.bufferActivation: 0.5` — start background reflection at 50% of the observation threshold
658
+
659
+ **Disabling async buffering:**
660
+
661
+ Set `observation.bufferTokens: false` to disable async buffering for both observations and reflections:
662
+
663
+ ```ts
664
+ const memory = new Memory({
665
+ options: {
666
+ observationalMemory: {
667
+ model: 'google/gemini-2.5-flash',
668
+ observation: {
669
+ bufferTokens: false,
670
+ },
671
+ },
672
+ },
673
+ });
674
+ ```
675
+
676
+ **Model is now required** when passing an observational memory config object. Use `observationalMemory: true` for the default (google/gemini-2.5-flash), or set a model explicitly:
677
+
678
+ ```ts
679
+ // Uses default model (google/gemini-2.5-flash)
680
+ observationalMemory: true
681
+
682
+ // Explicit model
683
+ observationalMemory: {
684
+ model: "google/gemini-2.5-flash",
685
+ }
686
+ ```
687
+
688
+ **`shareTokenBudget` requires `bufferTokens: false`** (temporary limitation). If you use `shareTokenBudget: true`, you must explicitly disable async buffering:
689
+
690
+ ```ts
691
+ observationalMemory: {
692
+ model: "google/gemini-2.5-flash",
693
+ shareTokenBudget: true,
694
+ observation: { bufferTokens: false },
695
+ }
696
+ ```
697
+
698
+ **New streaming event:** `data-om-status` replaces `data-om-progress` with a structured status object containing active window usage, buffered observation/reflection state, and projected activation impact.
699
+
700
+ **Buffering markers:** New `data-om-buffering-start`, `data-om-buffering-end`, and `data-om-buffering-failed` streaming events for UI feedback during background operations.
701
+
702
+ - Added prompt block storage implementations. Each store supports full CRUD for prompt blocks and their versions, including JSON serialization for rules and metadata. Also updated agent instructions serialization to support the new `AgentInstructionBlock` array format alongside plain strings. ([#12776](https://github.com/mastra-ai/mastra/pull/12776))
703
+
704
+ - Updated dependencies [[`717ffab`](https://github.com/mastra-ai/mastra/commit/717ffab42cfd58ff723b5c19ada4939997773004), [`e4b6dab`](https://github.com/mastra-ai/mastra/commit/e4b6dab171c5960e340b3ea3ea6da8d64d2b8672), [`5719fa8`](https://github.com/mastra-ai/mastra/commit/5719fa8880e86e8affe698ec4b3807c7e0e0a06f), [`83cda45`](https://github.com/mastra-ai/mastra/commit/83cda4523e588558466892bff8f80f631a36945a), [`11804ad`](https://github.com/mastra-ai/mastra/commit/11804adf1d6be46ebe216be40a43b39bb8b397d7), [`aa95f95`](https://github.com/mastra-ai/mastra/commit/aa95f958b186ae5c9f4219c88e268f5565c277a2), [`f5501ae`](https://github.com/mastra-ai/mastra/commit/f5501aedb0a11106c7db7e480d6eaf3971b7bda8), [`44573af`](https://github.com/mastra-ai/mastra/commit/44573afad0a4bc86f627d6cbc0207961cdcb3bc3), [`00e3861`](https://github.com/mastra-ai/mastra/commit/00e3861863fbfee78faeb1ebbdc7c0223aae13ff), [`7bfbc52`](https://github.com/mastra-ai/mastra/commit/7bfbc52a8604feb0fff2c0a082c13c0c2a3df1a2), [`1445994`](https://github.com/mastra-ai/mastra/commit/1445994aee19c9334a6a101cf7bd80ca7ed4d186), [`61f44a2`](https://github.com/mastra-ai/mastra/commit/61f44a26861c89e364f367ff40825bdb7f19df55), [`37145d2`](https://github.com/mastra-ai/mastra/commit/37145d25f99dc31f1a9105576e5452609843ce32), [`fdad759`](https://github.com/mastra-ai/mastra/commit/fdad75939ff008b27625f5ec0ce9c6915d99d9ec), [`e4569c5`](https://github.com/mastra-ai/mastra/commit/e4569c589e00c4061a686c9eb85afe1b7050b0a8), [`7309a85`](https://github.com/mastra-ai/mastra/commit/7309a85427281a8be23f4fb80ca52e18eaffd596), [`99424f6`](https://github.com/mastra-ai/mastra/commit/99424f6862ffb679c4ec6765501486034754a4c2), [`44eb452`](https://github.com/mastra-ai/mastra/commit/44eb4529b10603c279688318bebf3048543a1d61), [`6c40593`](https://github.com/mastra-ai/mastra/commit/6c40593d6d2b1b68b0c45d1a3a4c6ac5ecac3937), [`8c1135d`](https://github.com/mastra-ai/mastra/commit/8c1135dfb91b057283eae7ee11f9ec28753cc64f), [`dd39e54`](https://github.com/mastra-ai/mastra/commit/dd39e54ea34532c995b33bee6e0e808bf41a7341), [`b6fad9a`](https://github.com/mastra-ai/mastra/commit/b6fad9a602182b1cc0df47cd8c55004fa829ad61), [`4129c07`](https://github.com/mastra-ai/mastra/commit/4129c073349b5a66643fd8136ebfe9d7097cf793), [`5b930ab`](https://github.com/mastra-ai/mastra/commit/5b930aba1834d9898e8460a49d15106f31ac7c8d), [`4be93d0`](https://github.com/mastra-ai/mastra/commit/4be93d09d68e20aaf0ea3f210749422719618b5f), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`8c90ff4`](https://github.com/mastra-ai/mastra/commit/8c90ff4d3414e7f2a2d216ea91274644f7b29133), [`ed232d1`](https://github.com/mastra-ai/mastra/commit/ed232d1583f403925dc5ae45f7bee948cf2a182b), [`3891795`](https://github.com/mastra-ai/mastra/commit/38917953518eb4154a984ee36e6ededdcfe80f72), [`4f955b2`](https://github.com/mastra-ai/mastra/commit/4f955b20c7f66ed282ee1fd8709696fa64c4f19d), [`55a4c90`](https://github.com/mastra-ai/mastra/commit/55a4c9044ac7454349b9f6aeba0bbab5ee65d10f)]:
705
+ - @mastra/core@1.3.0-alpha.1
706
+
707
+ ## 1.2.0
708
+
709
+ ### Minor Changes
710
+
711
+ - Added Observational Memory — a new memory system that keeps your agent's context window small while preserving long-term memory across conversations. ([#12599](https://github.com/mastra-ai/mastra/pull/12599))
712
+
713
+ **Why:** Long conversations cause context rot and waste tokens. Observational Memory compresses conversation history into observations (5–40x compression) and periodically condenses those into reflections. Your agent stays fast and focused, even after thousands of messages.
714
+
715
+ **Usage:**
716
+
717
+ ```ts
718
+ import { Memory } from '@mastra/memory';
719
+ import { PostgresStore } from '@mastra/pg';
720
+
721
+ const memory = new Memory({
722
+ storage: new PostgresStore({ connectionString: process.env.DATABASE_URL }),
723
+ options: {
724
+ observationalMemory: true,
725
+ },
726
+ });
727
+
728
+ const agent = new Agent({
729
+ name: 'my-agent',
730
+ model: openai('gpt-4o'),
731
+ memory,
732
+ });
733
+ ```
734
+
735
+ **What's new:**
736
+ - `observationalMemory: true` enables the three-tier memory system (recent messages → observations → reflections)
737
+ - Thread-scoped (per-conversation) and resource-scoped (shared across all threads for a user) modes
738
+ - Manual `observe()` API for triggering observation outside the normal agent loop
739
+ - New OM storage methods for pg, libsql, and mongodb adapters (conditionally enabled)
740
+ - `Agent.findProcessor()` method for looking up processors by ID
741
+ - `processorStates` for persisting processor state across loop iterations
742
+ - Abort signal propagation to processors
743
+ - `ProcessorStreamWriter` for custom stream events from processors
744
+
745
+ ### Patch Changes
746
+
747
+ - Created @mastra/editor package for managing and resolving stored agent configurations ([#12631](https://github.com/mastra-ai/mastra/pull/12631))
748
+
749
+ This major addition introduces the editor package, which provides a complete solution for storing, versioning, and instantiating agent configurations from a database. The editor seamlessly integrates with Mastra's storage layer to enable dynamic agent management.
750
+
751
+ **Key Features:**
752
+ - **Agent Storage & Retrieval**: Store complete agent configurations including instructions, model settings, tools, workflows, nested agents, scorers, processors, and memory configuration
753
+ - **Version Management**: Create and manage multiple versions of agents, with support for activating specific versions
754
+ - **Dependency Resolution**: Automatically resolves and instantiates all agent dependencies (tools, workflows, sub-agents, etc.) from the Mastra registry
755
+ - **Caching**: Built-in caching for improved performance when repeatedly accessing stored agents
756
+ - **Type Safety**: Full TypeScript support with proper typing for stored configurations
757
+
758
+ **Usage Example:**
759
+
760
+ ```typescript
761
+ import { MastraEditor } from '@mastra/editor';
762
+ import { Mastra } from '@mastra/core';
763
+
764
+ // Initialize editor with Mastra
765
+ const mastra = new Mastra({
766
+ /* config */
767
+ editor: new MastraEditor(),
768
+ });
769
+
770
+ // Store an agent configuration
771
+ const agentId = await mastra.storage.stores?.agents?.createAgent({
772
+ name: 'customer-support',
773
+ instructions: 'Help customers with inquiries',
774
+ model: { provider: 'openai', name: 'gpt-4' },
775
+ tools: ['search-kb', 'create-ticket'],
776
+ workflows: ['escalation-flow'],
777
+ memory: { vector: 'pinecone-db' },
778
+ });
779
+
780
+ // Retrieve and use the stored agent
781
+ const agent = await mastra.getEditor()?.getStoredAgentById(agentId);
782
+ const response = await agent?.generate('How do I reset my password?');
783
+
784
+ // List all stored agents
785
+ const agents = await mastra.getEditor()?.listStoredAgents({ pageSize: 10 });
786
+ ```
787
+
788
+ **Storage Improvements:**
789
+ - Fixed JSONB handling in LibSQL, PostgreSQL, and MongoDB adapters
790
+ - Improved agent resolution queries to properly merge version data
791
+ - Enhanced type safety for serialized configurations
792
+
793
+ - Updated dependencies [[`e6fc281`](https://github.com/mastra-ai/mastra/commit/e6fc281896a3584e9e06465b356a44fe7faade65), [`97be6c8`](https://github.com/mastra-ai/mastra/commit/97be6c8963130fca8a664fcf99d7b3a38e463595), [`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0), [`5fe1fe0`](https://github.com/mastra-ai/mastra/commit/5fe1fe0109faf2c87db34b725d8a4571a594f80e), [`4133d48`](https://github.com/mastra-ai/mastra/commit/4133d48eaa354cdb45920dc6265732ffbc96788d), [`5dd01cc`](https://github.com/mastra-ai/mastra/commit/5dd01cce68d61874aa3ecbd91ee17884cfd5aca2), [`13e0a2a`](https://github.com/mastra-ai/mastra/commit/13e0a2a2bcec01ff4d701274b3727d5e907a6a01), [`f6673b8`](https://github.com/mastra-ai/mastra/commit/f6673b893b65b7d273ad25ead42e990704cc1e17), [`cd6be8a`](https://github.com/mastra-ai/mastra/commit/cd6be8ad32741cd41cabf508355bb31b71e8a5bd), [`9eb4e8e`](https://github.com/mastra-ai/mastra/commit/9eb4e8e39efbdcfff7a40ff2ce07ce2714c65fa8), [`c987384`](https://github.com/mastra-ai/mastra/commit/c987384d6c8ca844a9701d7778f09f5a88da7f9f), [`cb8cc12`](https://github.com/mastra-ai/mastra/commit/cb8cc12bfadd526aa95a01125076f1da44e4afa7), [`aa37c84`](https://github.com/mastra-ai/mastra/commit/aa37c84d29b7db68c72517337932ef486c316275), [`62f5d50`](https://github.com/mastra-ai/mastra/commit/62f5d5043debbba497dacb7ab008fe86b38b8de3), [`47eba72`](https://github.com/mastra-ai/mastra/commit/47eba72f0397d0d14fbe324b97940c3d55e5a525)]:
794
+ - @mastra/core@1.2.0
795
+
796
+ ## 1.2.0-alpha.0
797
+
798
+ ### Minor Changes
799
+
800
+ - Added Observational Memory — a new memory system that keeps your agent's context window small while preserving long-term memory across conversations. ([#12599](https://github.com/mastra-ai/mastra/pull/12599))
801
+
802
+ **Why:** Long conversations cause context rot and waste tokens. Observational Memory compresses conversation history into observations (5–40x compression) and periodically condenses those into reflections. Your agent stays fast and focused, even after thousands of messages.
803
+
804
+ **Usage:**
805
+
806
+ ```ts
807
+ import { Memory } from '@mastra/memory';
808
+ import { PostgresStore } from '@mastra/pg';
809
+
810
+ const memory = new Memory({
811
+ storage: new PostgresStore({ connectionString: process.env.DATABASE_URL }),
812
+ options: {
813
+ observationalMemory: true,
814
+ },
815
+ });
816
+
817
+ const agent = new Agent({
818
+ name: 'my-agent',
819
+ model: openai('gpt-4o'),
820
+ memory,
821
+ });
822
+ ```
823
+
824
+ **What's new:**
825
+ - `observationalMemory: true` enables the three-tier memory system (recent messages → observations → reflections)
826
+ - Thread-scoped (per-conversation) and resource-scoped (shared across all threads for a user) modes
827
+ - Manual `observe()` API for triggering observation outside the normal agent loop
828
+ - New OM storage methods for pg, libsql, and mongodb adapters (conditionally enabled)
829
+ - `Agent.findProcessor()` method for looking up processors by ID
830
+ - `processorStates` for persisting processor state across loop iterations
831
+ - Abort signal propagation to processors
832
+ - `ProcessorStreamWriter` for custom stream events from processors
833
+
834
+ ### Patch Changes
835
+
836
+ - Created @mastra/editor package for managing and resolving stored agent configurations ([#12631](https://github.com/mastra-ai/mastra/pull/12631))
837
+
838
+ This major addition introduces the editor package, which provides a complete solution for storing, versioning, and instantiating agent configurations from a database. The editor seamlessly integrates with Mastra's storage layer to enable dynamic agent management.
839
+
840
+ **Key Features:**
841
+ - **Agent Storage & Retrieval**: Store complete agent configurations including instructions, model settings, tools, workflows, nested agents, scorers, processors, and memory configuration
842
+ - **Version Management**: Create and manage multiple versions of agents, with support for activating specific versions
843
+ - **Dependency Resolution**: Automatically resolves and instantiates all agent dependencies (tools, workflows, sub-agents, etc.) from the Mastra registry
844
+ - **Caching**: Built-in caching for improved performance when repeatedly accessing stored agents
845
+ - **Type Safety**: Full TypeScript support with proper typing for stored configurations
846
+
847
+ **Usage Example:**
848
+
849
+ ```typescript
850
+ import { MastraEditor } from '@mastra/editor';
851
+ import { Mastra } from '@mastra/core';
852
+
853
+ // Initialize editor with Mastra
854
+ const mastra = new Mastra({
855
+ /* config */
856
+ editor: new MastraEditor(),
857
+ });
858
+
859
+ // Store an agent configuration
860
+ const agentId = await mastra.storage.stores?.agents?.createAgent({
861
+ name: 'customer-support',
862
+ instructions: 'Help customers with inquiries',
863
+ model: { provider: 'openai', name: 'gpt-4' },
864
+ tools: ['search-kb', 'create-ticket'],
865
+ workflows: ['escalation-flow'],
866
+ memory: { vector: 'pinecone-db' },
867
+ });
868
+
869
+ // Retrieve and use the stored agent
870
+ const agent = await mastra.getEditor()?.getStoredAgentById(agentId);
871
+ const response = await agent?.generate('How do I reset my password?');
872
+
873
+ // List all stored agents
874
+ const agents = await mastra.getEditor()?.listStoredAgents({ pageSize: 10 });
875
+ ```
876
+
877
+ **Storage Improvements:**
878
+ - Fixed JSONB handling in LibSQL, PostgreSQL, and MongoDB adapters
879
+ - Improved agent resolution queries to properly merge version data
880
+ - Enhanced type safety for serialized configurations
881
+
882
+ - Updated dependencies [[`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0), [`4133d48`](https://github.com/mastra-ai/mastra/commit/4133d48eaa354cdb45920dc6265732ffbc96788d), [`5dd01cc`](https://github.com/mastra-ai/mastra/commit/5dd01cce68d61874aa3ecbd91ee17884cfd5aca2), [`13e0a2a`](https://github.com/mastra-ai/mastra/commit/13e0a2a2bcec01ff4d701274b3727d5e907a6a01), [`c987384`](https://github.com/mastra-ai/mastra/commit/c987384d6c8ca844a9701d7778f09f5a88da7f9f), [`cb8cc12`](https://github.com/mastra-ai/mastra/commit/cb8cc12bfadd526aa95a01125076f1da44e4afa7), [`62f5d50`](https://github.com/mastra-ai/mastra/commit/62f5d5043debbba497dacb7ab008fe86b38b8de3)]:
883
+ - @mastra/core@1.2.0-alpha.1
884
+
885
+ ## 1.1.0
886
+
887
+ ### Minor Changes
888
+
889
+ - Restructured stored agents to use a thin metadata record with versioned configuration snapshots. ([#12488](https://github.com/mastra-ai/mastra/pull/12488))
890
+
891
+ The agent record now only stores metadata fields (id, status, activeVersionId, authorId, metadata, timestamps). All configuration fields (name, instructions, model, tools, etc.) live exclusively in version snapshot rows, enabling full version history and rollback.
892
+
893
+ **Key changes:**
894
+ - Stored Agent records are now thin metadata-only (StorageAgentType)
895
+ - All config lives in version snapshots (StorageAgentSnapshotType)
896
+ - New resolved type (StorageResolvedAgentType) merges agent record + active version config
897
+ - Renamed `ownerId` to `authorId` for multi-tenant filtering
898
+ - Changed `memory` field type from `string` to `Record<string, unknown>`
899
+ - Added `status` field ('draft' | 'published') to agent records
900
+ - Flattened CreateAgent/UpdateAgent input types (config fields at top level, no nested snapshot)
901
+ - Version config columns are top-level in the agent_versions table (no single snapshot jsonb column)
902
+ - List endpoints return resolved agents (thin record + active version config)
903
+ - Auto-versioning on update with retention limits and race condition handling
904
+
905
+ - Added dynamic agent management with CRUD operations and version tracking ([#12038](https://github.com/mastra-ai/mastra/pull/12038))
906
+
907
+ **New Features:**
908
+ - Create, edit, and delete agents directly from the Mastra Studio UI
909
+ - Full version history for agents with compare and restore capabilities
910
+ - Visual diff viewer to compare agent configurations across versions
911
+ - Agent creation modal with comprehensive configuration options (model selection, instructions, tools, workflows, sub-agents, memory)
912
+ - AI-powered instruction enhancement
913
+
914
+ **Storage:**
915
+ - New storage interfaces for stored agents and agent versions
916
+ - PostgreSQL, LibSQL, and MongoDB implementations included
917
+ - In-memory storage for development and testing
918
+
919
+ **API:**
920
+ - RESTful endpoints for agent CRUD operations
921
+ - Version management endpoints (create, list, activate, restore, delete, compare)
922
+ - Automatic versioning on agent updates when enabled
923
+
924
+ **Client SDK:**
925
+ - JavaScript client with full support for stored agents and versions
926
+ - Type-safe methods for all CRUD and version operations
927
+
928
+ **Usage Example:**
929
+
930
+ ```typescript
931
+ // Server-side: Configure storage
932
+ import { Mastra } from '@mastra/core';
933
+ import { PgAgentsStorage } from '@mastra/pg';
934
+
935
+ const mastra = new Mastra({
936
+ agents: { agentOne },
937
+ storage: {
938
+ agents: new PgAgentsStorage({
939
+ connectionString: process.env.DATABASE_URL,
940
+ }),
941
+ },
942
+ });
943
+
944
+ // Client-side: Use the SDK
945
+ import { MastraClient } from '@mastra/client-js';
946
+
947
+ const client = new MastraClient({ baseUrl: 'http://localhost:3000' });
948
+
949
+ // Create a stored agent
950
+ const agent = await client.createStoredAgent({
951
+ name: 'Customer Support Agent',
952
+ description: 'Handles customer inquiries',
953
+ model: { provider: 'ANTHROPIC', name: 'claude-sonnet-4-5' },
954
+ instructions: 'You are a helpful customer support agent...',
955
+ tools: ['search', 'email'],
956
+ });
957
+
958
+ // Create a version snapshot
959
+ await client.storedAgent(agent.id).createVersion({
960
+ name: 'v1.0 - Initial release',
961
+ changeMessage: 'First production version',
962
+ });
963
+
964
+ // Compare versions
965
+ const diff = await client.storedAgent(agent.id).compareVersions('version-1', 'version-2');
966
+ ```
967
+
968
+ **Why:**
969
+ This feature enables teams to manage agents dynamically without code changes, making it easier to iterate on agent configurations and maintain a complete audit trail of changes.
970
+
971
+ - Added `status` field to `listTraces` response. The status field indicates the trace state: `success` (completed without error), `error` (has error), or `running` (still in progress). This makes it easier to filter and display traces by their current state without having to derive it from the `error` and `endedAt` fields. ([#12213](https://github.com/mastra-ai/mastra/pull/12213))
972
+
973
+ ### Patch Changes
974
+
975
+ - Stored agent edits no longer fail silently. PATCH requests now save changes correctly. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
976
+
977
+ - Fix PATCH request JSON-body handling in `@mastra/client-js` so stored agent edit flows work correctly. Fix stored agent schema migration in `@mastra/libsql` and `@mastra/pg` to drop and recreate the versions table when the old snapshot-based schema is detected, clean up stale draft records from partial create failures, and remove lingering legacy tables. Restores create and edit flows for stored agents. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
978
+
979
+ - Updated dependencies [[`90fc0e5`](https://github.com/mastra-ai/mastra/commit/90fc0e5717cb280c2d4acf4f0410b510bb4c0a72), [`1cf5d2e`](https://github.com/mastra-ai/mastra/commit/1cf5d2ea1b085be23e34fb506c80c80a4e6d9c2b), [`b99ceac`](https://github.com/mastra-ai/mastra/commit/b99ceace2c830dbdef47c8692d56a91954aefea2), [`deea43e`](https://github.com/mastra-ai/mastra/commit/deea43eb1366d03a864c5e597d16a48592b9893f), [`833ae96`](https://github.com/mastra-ai/mastra/commit/833ae96c3e34370e58a1e979571c41f39a720592), [`943772b`](https://github.com/mastra-ai/mastra/commit/943772b4378f625f0f4e19ea2b7c392bd8e71786), [`b5c711b`](https://github.com/mastra-ai/mastra/commit/b5c711b281dd1fb81a399a766bc9f86c55efc13e), [`3efbe5a`](https://github.com/mastra-ai/mastra/commit/3efbe5ae20864c4f3143457f4f3ee7dc2fa5ca76), [`1e49e7a`](https://github.com/mastra-ai/mastra/commit/1e49e7ab5f173582154cb26b29d424de67d09aef), [`751eaab`](https://github.com/mastra-ai/mastra/commit/751eaab4e0d3820a94e4c3d39a2ff2663ded3d91), [`69d8156`](https://github.com/mastra-ai/mastra/commit/69d81568bcf062557c24471ce26812446bec465d), [`60d9d89`](https://github.com/mastra-ai/mastra/commit/60d9d899e44b35bc43f1bcd967a74e0ce010b1af), [`5c544c8`](https://github.com/mastra-ai/mastra/commit/5c544c8d12b08ab40d64d8f37b3c4215bee95b87), [`771ad96`](https://github.com/mastra-ai/mastra/commit/771ad962441996b5c43549391a3e6a02c6ddedc2), [`2b0936b`](https://github.com/mastra-ai/mastra/commit/2b0936b0c9a43eeed9bef63e614d7e02ee803f7e), [`3b04f30`](https://github.com/mastra-ai/mastra/commit/3b04f3010604f3cdfc8a0674731700ad66471cee), [`97e26de`](https://github.com/mastra-ai/mastra/commit/97e26deaebd9836647a67b96423281d66421ca07), [`ac9ec66`](https://github.com/mastra-ai/mastra/commit/ac9ec6672779b2e6d4344e415481d1a6a7d4911a), [`10523f4`](https://github.com/mastra-ai/mastra/commit/10523f4882d9b874b40ce6e3715f66dbcd4947d2), [`cb72d20`](https://github.com/mastra-ai/mastra/commit/cb72d2069d7339bda8a0e76d4f35615debb07b84), [`42856b1`](https://github.com/mastra-ai/mastra/commit/42856b1c8aeea6371c9ee77ae2f5f5fe34400933), [`66f33ff`](https://github.com/mastra-ai/mastra/commit/66f33ff68620018513e499c394411d1d39b3aa5c), [`ab3c190`](https://github.com/mastra-ai/mastra/commit/ab3c1901980a99910ca9b96a7090c22e24060113), [`d4f06c8`](https://github.com/mastra-ai/mastra/commit/d4f06c85ffa5bb0da38fb82ebf3b040cc6b4ec4e), [`0350626`](https://github.com/mastra-ai/mastra/commit/03506267ec41b67add80d994c0c0fcce93bbc75f), [`bc9fa00`](https://github.com/mastra-ai/mastra/commit/bc9fa00859c5c4a796d53a0a5cae46ab4a3072e4), [`f46a478`](https://github.com/mastra-ai/mastra/commit/f46a4782f595949c696569e891f81c8d26338508), [`90fc0e5`](https://github.com/mastra-ai/mastra/commit/90fc0e5717cb280c2d4acf4f0410b510bb4c0a72), [`f05a3a5`](https://github.com/mastra-ai/mastra/commit/f05a3a5cf2b9a9c2d40c09cb8c762a4b6cd5d565), [`a291da9`](https://github.com/mastra-ai/mastra/commit/a291da9363efd92dafd8775dccb4f2d0511ece7a), [`c5d71da`](https://github.com/mastra-ai/mastra/commit/c5d71da1c680ce5640b1a7f8ca0e024a4ab1cfed), [`07042f9`](https://github.com/mastra-ai/mastra/commit/07042f9f89080f38b8f72713ba1c972d5b1905b8), [`0423442`](https://github.com/mastra-ai/mastra/commit/0423442b7be2dfacba95890bea8f4a810db4d603)]:
980
+ - @mastra/core@1.1.0
981
+
982
+ ## 1.1.0-alpha.2
983
+
984
+ ### Patch Changes
985
+
986
+ - Stored agent edits no longer fail silently. PATCH requests now save changes correctly. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
987
+
988
+ - Fix PATCH request JSON-body handling in `@mastra/client-js` so stored agent edit flows work correctly. Fix stored agent schema migration in `@mastra/libsql` and `@mastra/pg` to drop and recreate the versions table when the old snapshot-based schema is detected, clean up stale draft records from partial create failures, and remove lingering legacy tables. Restores create and edit flows for stored agents. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
989
+
990
+ - Updated dependencies:
991
+ - @mastra/core@1.1.0-alpha.2
992
+
993
+ ## 1.1.0-alpha.1
994
+
995
+ ### Minor Changes
996
+
997
+ - Restructured stored agents to use a thin metadata record with versioned configuration snapshots. ([#12488](https://github.com/mastra-ai/mastra/pull/12488))
998
+
999
+ The agent record now only stores metadata fields (id, status, activeVersionId, authorId, metadata, timestamps). All configuration fields (name, instructions, model, tools, etc.) live exclusively in version snapshot rows, enabling full version history and rollback.
1000
+
1001
+ **Key changes:**
1002
+ - Stored Agent records are now thin metadata-only (StorageAgentType)
1003
+ - All config lives in version snapshots (StorageAgentSnapshotType)
1004
+ - New resolved type (StorageResolvedAgentType) merges agent record + active version config
1005
+ - Renamed `ownerId` to `authorId` for multi-tenant filtering
1006
+ - Changed `memory` field type from `string` to `Record<string, unknown>`
1007
+ - Added `status` field ('draft' | 'published') to agent records
1008
+ - Flattened CreateAgent/UpdateAgent input types (config fields at top level, no nested snapshot)
1009
+ - Version config columns are top-level in the agent_versions table (no single snapshot jsonb column)
1010
+ - List endpoints return resolved agents (thin record + active version config)
1011
+ - Auto-versioning on update with retention limits and race condition handling
1012
+
1013
+ ### Patch Changes
1014
+
1015
+ - Updated dependencies [[`b99ceac`](https://github.com/mastra-ai/mastra/commit/b99ceace2c830dbdef47c8692d56a91954aefea2), [`deea43e`](https://github.com/mastra-ai/mastra/commit/deea43eb1366d03a864c5e597d16a48592b9893f), [`ac9ec66`](https://github.com/mastra-ai/mastra/commit/ac9ec6672779b2e6d4344e415481d1a6a7d4911a)]:
1016
+ - @mastra/core@1.1.0-alpha.1
1017
+
1018
+ ## 1.1.0-alpha.0
1019
+
1020
+ ### Minor Changes
1021
+
1022
+ - Added dynamic agent management with CRUD operations and version tracking ([#12038](https://github.com/mastra-ai/mastra/pull/12038))
1023
+
1024
+ **New Features:**
1025
+ - Create, edit, and delete agents directly from the Mastra Studio UI
1026
+ - Full version history for agents with compare and restore capabilities
1027
+ - Visual diff viewer to compare agent configurations across versions
1028
+ - Agent creation modal with comprehensive configuration options (model selection, instructions, tools, workflows, sub-agents, memory)
1029
+ - AI-powered instruction enhancement
1030
+
1031
+ **Storage:**
1032
+ - New storage interfaces for stored agents and agent versions
1033
+ - PostgreSQL, LibSQL, and MongoDB implementations included
1034
+ - In-memory storage for development and testing
1035
+
1036
+ **API:**
1037
+ - RESTful endpoints for agent CRUD operations
1038
+ - Version management endpoints (create, list, activate, restore, delete, compare)
1039
+ - Automatic versioning on agent updates when enabled
1040
+
1041
+ **Client SDK:**
1042
+ - JavaScript client with full support for stored agents and versions
1043
+ - Type-safe methods for all CRUD and version operations
1044
+
1045
+ **Usage Example:**
1046
+
1047
+ ```typescript
1048
+ // Server-side: Configure storage
1049
+ import { Mastra } from '@mastra/core';
1050
+ import { PgAgentsStorage } from '@mastra/pg';
1051
+
1052
+ const mastra = new Mastra({
1053
+ agents: { agentOne },
1054
+ storage: {
1055
+ agents: new PgAgentsStorage({
1056
+ connectionString: process.env.DATABASE_URL,
1057
+ }),
1058
+ },
1059
+ });
1060
+
1061
+ // Client-side: Use the SDK
1062
+ import { MastraClient } from '@mastra/client-js';
1063
+
1064
+ const client = new MastraClient({ baseUrl: 'http://localhost:3000' });
1065
+
1066
+ // Create a stored agent
1067
+ const agent = await client.createStoredAgent({
1068
+ name: 'Customer Support Agent',
1069
+ description: 'Handles customer inquiries',
1070
+ model: { provider: 'ANTHROPIC', name: 'claude-sonnet-4-5' },
1071
+ instructions: 'You are a helpful customer support agent...',
1072
+ tools: ['search', 'email'],
1073
+ });
1074
+
1075
+ // Create a version snapshot
1076
+ await client.storedAgent(agent.id).createVersion({
1077
+ name: 'v1.0 - Initial release',
1078
+ changeMessage: 'First production version',
1079
+ });
1080
+
1081
+ // Compare versions
1082
+ const diff = await client.storedAgent(agent.id).compareVersions('version-1', 'version-2');
1083
+ ```
1084
+
1085
+ **Why:**
1086
+ This feature enables teams to manage agents dynamically without code changes, making it easier to iterate on agent configurations and maintain a complete audit trail of changes.
1087
+
1088
+ - Added `status` field to `listTraces` response. The status field indicates the trace state: `success` (completed without error), `error` (has error), or `running` (still in progress). This makes it easier to filter and display traces by their current state without having to derive it from the `error` and `endedAt` fields. ([#12213](https://github.com/mastra-ai/mastra/pull/12213))
1089
+
1090
+ ### Patch Changes
1091
+
1092
+ - Updated dependencies [[`90fc0e5`](https://github.com/mastra-ai/mastra/commit/90fc0e5717cb280c2d4acf4f0410b510bb4c0a72), [`1cf5d2e`](https://github.com/mastra-ai/mastra/commit/1cf5d2ea1b085be23e34fb506c80c80a4e6d9c2b), [`833ae96`](https://github.com/mastra-ai/mastra/commit/833ae96c3e34370e58a1e979571c41f39a720592), [`943772b`](https://github.com/mastra-ai/mastra/commit/943772b4378f625f0f4e19ea2b7c392bd8e71786), [`b5c711b`](https://github.com/mastra-ai/mastra/commit/b5c711b281dd1fb81a399a766bc9f86c55efc13e), [`3efbe5a`](https://github.com/mastra-ai/mastra/commit/3efbe5ae20864c4f3143457f4f3ee7dc2fa5ca76), [`1e49e7a`](https://github.com/mastra-ai/mastra/commit/1e49e7ab5f173582154cb26b29d424de67d09aef), [`751eaab`](https://github.com/mastra-ai/mastra/commit/751eaab4e0d3820a94e4c3d39a2ff2663ded3d91), [`69d8156`](https://github.com/mastra-ai/mastra/commit/69d81568bcf062557c24471ce26812446bec465d), [`60d9d89`](https://github.com/mastra-ai/mastra/commit/60d9d899e44b35bc43f1bcd967a74e0ce010b1af), [`5c544c8`](https://github.com/mastra-ai/mastra/commit/5c544c8d12b08ab40d64d8f37b3c4215bee95b87), [`771ad96`](https://github.com/mastra-ai/mastra/commit/771ad962441996b5c43549391a3e6a02c6ddedc2), [`2b0936b`](https://github.com/mastra-ai/mastra/commit/2b0936b0c9a43eeed9bef63e614d7e02ee803f7e), [`3b04f30`](https://github.com/mastra-ai/mastra/commit/3b04f3010604f3cdfc8a0674731700ad66471cee), [`97e26de`](https://github.com/mastra-ai/mastra/commit/97e26deaebd9836647a67b96423281d66421ca07), [`10523f4`](https://github.com/mastra-ai/mastra/commit/10523f4882d9b874b40ce6e3715f66dbcd4947d2), [`cb72d20`](https://github.com/mastra-ai/mastra/commit/cb72d2069d7339bda8a0e76d4f35615debb07b84), [`42856b1`](https://github.com/mastra-ai/mastra/commit/42856b1c8aeea6371c9ee77ae2f5f5fe34400933), [`66f33ff`](https://github.com/mastra-ai/mastra/commit/66f33ff68620018513e499c394411d1d39b3aa5c), [`ab3c190`](https://github.com/mastra-ai/mastra/commit/ab3c1901980a99910ca9b96a7090c22e24060113), [`d4f06c8`](https://github.com/mastra-ai/mastra/commit/d4f06c85ffa5bb0da38fb82ebf3b040cc6b4ec4e), [`0350626`](https://github.com/mastra-ai/mastra/commit/03506267ec41b67add80d994c0c0fcce93bbc75f), [`bc9fa00`](https://github.com/mastra-ai/mastra/commit/bc9fa00859c5c4a796d53a0a5cae46ab4a3072e4), [`f46a478`](https://github.com/mastra-ai/mastra/commit/f46a4782f595949c696569e891f81c8d26338508), [`90fc0e5`](https://github.com/mastra-ai/mastra/commit/90fc0e5717cb280c2d4acf4f0410b510bb4c0a72), [`f05a3a5`](https://github.com/mastra-ai/mastra/commit/f05a3a5cf2b9a9c2d40c09cb8c762a4b6cd5d565), [`a291da9`](https://github.com/mastra-ai/mastra/commit/a291da9363efd92dafd8775dccb4f2d0511ece7a), [`c5d71da`](https://github.com/mastra-ai/mastra/commit/c5d71da1c680ce5640b1a7f8ca0e024a4ab1cfed), [`07042f9`](https://github.com/mastra-ai/mastra/commit/07042f9f89080f38b8f72713ba1c972d5b1905b8), [`0423442`](https://github.com/mastra-ai/mastra/commit/0423442b7be2dfacba95890bea8f4a810db4d603)]:
1093
+ - @mastra/core@1.1.0-alpha.0
1094
+
1095
+ ## 1.0.0
1096
+
1097
+ ### Major Changes
1098
+
1099
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
1100
+
1101
+ - Every Mastra primitive (agent, MCPServer, workflow, tool, processor, scorer, and vector) now has a get, list, and add method associated with it. Each primitive also now requires an id to be set. ([#9675](https://github.com/mastra-ai/mastra/pull/9675))
1102
+
1103
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
1104
+
1105
+ - Update handlers to use `listWorkflowRuns` instead of `getWorkflowRuns`. Fix type names from `StoragelistThreadsByResourceIdInput/Output` to `StorageListThreadsByResourceIdInput/Output`. ([#9507](https://github.com/mastra-ai/mastra/pull/9507))
1106
+
1107
+ - Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
1108
+
1109
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
1110
+
1111
+ **Storage changes:**
1112
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
1113
+ - All storage implementations support `perPage: false`:
1114
+ - Memory: `listMessages()`
1115
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
1116
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
1117
+
1118
+ **Memory changes:**
1119
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
1120
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
1121
+
1122
+ **Stricter validation:**
1123
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
1124
+
1125
+ **Migration:**
1126
+
1127
+ ```typescript
1128
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
1129
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
1130
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
1131
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
1132
+
1133
+ // Memory: Replace selectBy with flat parameters
1134
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
1135
+ + memory.query({ threadId, perPage: 20, include: [...] })
1136
+
1137
+ // Client SDK
1138
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
1139
+ + thread.listMessages({ page: 0, perPage: 20 })
1140
+ ```
1141
+
1142
+ - **Removed `storage.getMessages()`** ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
1143
+
1144
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
1145
+
1146
+ **Migration:**
1147
+
1148
+ ```typescript
1149
+ // Before
1150
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
1151
+
1152
+ // After
1153
+ const result = await storage.listMessages({
1154
+ threadId: 'thread-1',
1155
+ page: 0,
1156
+ perPage: 50,
1157
+ });
1158
+ const messages = result.messages; // Access messages array
1159
+ console.log(result.total); // Total count
1160
+ console.log(result.hasMore); // Whether more pages exist
1161
+ ```
1162
+
1163
+ **Message ordering default**
1164
+
1165
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
1166
+
1167
+ **To use DESC ordering (newest first):**
1168
+
1169
+ ```typescript
1170
+ const result = await storage.listMessages({
1171
+ threadId: 'thread-1',
1172
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1173
+ });
1174
+ ```
1175
+
1176
+ **Renamed `client.getThreadMessages()` → `client.listThreadMessages()`**
1177
+
1178
+ **Migration:**
1179
+
1180
+ ```typescript
1181
+ // Before
1182
+ const response = await client.getThreadMessages(threadId, { agentId });
1183
+
1184
+ // After
1185
+ const response = await client.listThreadMessages(threadId, { agentId });
1186
+ ```
1187
+
1188
+ The response format remains the same.
1189
+
1190
+ **Removed `StorageGetMessagesArg` type**
1191
+
1192
+ Use `StorageListMessagesInput` instead:
1193
+
1194
+ ```typescript
1195
+ // Before
1196
+ import type { StorageGetMessagesArg } from '@mastra/core';
1197
+
1198
+ // After
1199
+ import type { StorageListMessagesInput } from '@mastra/core';
1200
+ ```
1201
+
1202
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
1203
+
1204
+ - Add new list methods to storage API: `listMessages`, `listMessagesById`, `listThreadsByResourceId`, and `listWorkflowRuns`. Most methods are currently wrappers around existing methods. Full implementations will be added when migrating away from legacy methods. ([#9489](https://github.com/mastra-ai/mastra/pull/9489))
1205
+
1206
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
1207
+
1208
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
1209
+
1210
+ - Remove `getThreadsByResourceId` and `getThreadsByResourceIdPaginated` methods from storage interfaces in favor of `listThreadsByResourceId`. The new method uses `offset`/`limit` pagination and a nested `orderBy` object structure (`{ field, direction }`). ([#9536](https://github.com/mastra-ai/mastra/pull/9536))
1211
+
1212
+ - Remove `getMessagesById` method from storage interfaces in favor of `listMessagesById`. The new method only returns V2-format messages and removes the format parameter, simplifying the API surface. Users should migrate from `getMessagesById({ messageIds, format })` to `listMessagesById({ messageIds })`. ([#9534](https://github.com/mastra-ai/mastra/pull/9534))
1213
+
1214
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
1215
+
1216
+ - Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
1217
+
1218
+ All storage and memory pagination APIs have been updated to use `page` (0-indexed) and `perPage` instead of `offset` and `limit`, aligning with standard REST API patterns.
1219
+
1220
+ **Affected APIs:**
1221
+ - `Memory.listThreadsByResourceId()`
1222
+ - `Memory.listMessages()`
1223
+ - `Storage.listWorkflowRuns()`
1224
+
1225
+ **Migration:**
1226
+
1227
+ ```typescript
1228
+ // Before
1229
+ await memory.listThreadsByResourceId({
1230
+ resourceId: 'user-123',
1231
+ offset: 20,
1232
+ limit: 10,
1233
+ });
1234
+
1235
+ // After
1236
+ await memory.listThreadsByResourceId({
1237
+ resourceId: 'user-123',
1238
+ page: 2, // page = Math.floor(offset / limit)
1239
+ perPage: 10,
1240
+ });
1241
+
1242
+ // Before
1243
+ await memory.listMessages({
1244
+ threadId: 'thread-456',
1245
+ offset: 20,
1246
+ limit: 10,
1247
+ });
1248
+
1249
+ // After
1250
+ await memory.listMessages({
1251
+ threadId: 'thread-456',
1252
+ page: 2,
1253
+ perPage: 10,
1254
+ });
1255
+
1256
+ // Before
1257
+ await storage.listWorkflowRuns({
1258
+ workflowName: 'my-workflow',
1259
+ offset: 20,
1260
+ limit: 10,
1261
+ });
1262
+
1263
+ // After
1264
+ await storage.listWorkflowRuns({
1265
+ workflowName: 'my-workflow',
1266
+ page: 2,
1267
+ perPage: 10,
1268
+ });
1269
+ ```
1270
+
1271
+ **Additional improvements:**
1272
+ - Added validation for negative `page` values in all storage implementations
1273
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
1274
+ - Added reusable query parser utilities for consistent validation in handlers
1275
+
1276
+ - ```ts ([#9709](https://github.com/mastra-ai/mastra/pull/9709))
1277
+ import { Mastra } from '@mastra/core';
1278
+ import { Observability } from '@mastra/observability'; // Explicit import
1279
+
1280
+ const mastra = new Mastra({
1281
+ ...other_config,
1282
+ observability: new Observability({
1283
+ default: { enabled: true },
1284
+ }), // Instance
1285
+ });
1286
+ ```
1287
+
1288
+ Instead of:
1289
+
1290
+ ```ts
1291
+ import { Mastra } from '@mastra/core';
1292
+ import '@mastra/observability/init'; // Explicit import
1293
+
1294
+ const mastra = new Mastra({
1295
+ ...other_config,
1296
+ observability: {
1297
+ default: { enabled: true },
1298
+ },
1299
+ });
1300
+ ```
1301
+
1302
+ Also renamed a bunch of:
1303
+ - `Tracing` things to `Observability` things.
1304
+ - `AI-` things to just things.
1305
+
1306
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
1307
+
1308
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
1309
+
1310
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
1311
+ Made the return format of all methods that return db messages consistent. It's always `{ messages: MastraDBMessage[] }` now, and messages can be converted after that using `@mastra/ai-sdk/ui`'s `toAISdkV4/5Messages()` function
1312
+
1313
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
1314
+
1315
+ ### Minor Changes
1316
+
1317
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
1318
+
1319
+ Agents can now be stored in the database and loaded at runtime. This lets you persist agent configurations and dynamically create executable Agent instances from storage.
1320
+
1321
+ ```typescript
1322
+ import { Mastra } from '@mastra/core';
1323
+ import { LibSQLStore } from '@mastra/libsql';
1324
+
1325
+ const mastra = new Mastra({
1326
+ storage: new LibSQLStore({ url: ':memory:' }),
1327
+ tools: { myTool },
1328
+ scorers: { myScorer },
1329
+ });
1330
+
1331
+ // Create agent in storage via API or directly
1332
+ await mastra.getStorage().createAgent({
1333
+ agent: {
1334
+ id: 'my-agent',
1335
+ name: 'My Agent',
1336
+ instructions: 'You are helpful',
1337
+ model: { provider: 'openai', name: 'gpt-4' },
1338
+ tools: { myTool: {} },
1339
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
1340
+ },
1341
+ });
1342
+
1343
+ // Load and use the agent
1344
+ const agent = await mastra.getStoredAgentById('my-agent');
1345
+ const response = await agent.generate('Hello!');
1346
+
1347
+ // List all stored agents with pagination
1348
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
1349
+ page: 0,
1350
+ perPage: 10,
1351
+ });
1352
+ ```
1353
+
1354
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
1355
+
1356
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
1357
+
1358
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
1359
+
1360
+ **Why this change?**
1361
+
1362
+ These were the last remaining columns storing JSON as TEXT. This change aligns them with other tables that already use JSONB, enabling native JSON operators and improved performance. See [#8978](https://github.com/mastra-ai/mastra/issues/8978) for details.
1363
+
1364
+ **Columns Changed:**
1365
+ - `mastra_threads.metadata` - Thread metadata
1366
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
1367
+
1368
+ **PostgreSQL**
1369
+
1370
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
1371
+
1372
+ ```sql
1373
+ ALTER TABLE mastra_threads
1374
+ ALTER COLUMN metadata TYPE jsonb
1375
+ USING metadata::jsonb;
1376
+
1377
+ ALTER TABLE mastra_workflow_snapshot
1378
+ ALTER COLUMN snapshot TYPE jsonb
1379
+ USING snapshot::jsonb;
1380
+ ```
1381
+
1382
+ **LibSQL**
1383
+
1384
+ No Migration Required - LibSQL now uses native SQLite JSONB format (added in SQLite 3.45) for ~3x performance improvement on JSON operations. The changes are fully backwards compatible:
1385
+ - Existing TEXT JSON data continues to work
1386
+ - New data is stored in binary JSONB format
1387
+ - Both formats can coexist in the same table
1388
+ - All JSON functions (`json_extract`, etc.) work on both formats
1389
+
1390
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
1391
+
1392
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
1393
+
1394
+ Storage adapters now use a domain-based architecture where each domain (memory, workflows, scores, observability, agents) extends a `StorageDomain` base class with `init()` and `dangerouslyClearAll()` methods.
1395
+
1396
+ **Key changes:**
1397
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
1398
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
1399
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
1400
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
1401
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
1402
+
1403
+ **Why this matters:**
1404
+
1405
+ This enables composite storage where you can use different database adapters per domain:
1406
+
1407
+ ```typescript
1408
+ import { Mastra } from '@mastra/core';
1409
+ import { PostgresStore } from '@mastra/pg';
1410
+ import { ClickhouseStore } from '@mastra/clickhouse';
1411
+
1412
+ // Use Postgres for most domains but Clickhouse for observability
1413
+ const mastra = new Mastra({
1414
+ storage: new PostgresStore({
1415
+ connectionString: 'postgres://...',
1416
+ }),
1417
+ // Future: override specific domains
1418
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
1419
+ });
1420
+ ```
1421
+
1422
+ **Standalone domain usage:**
1423
+
1424
+ Domains can now be used independently with flexible configuration:
1425
+
1426
+ ```typescript
1427
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
1428
+
1429
+ // Option 1: Pass config to create client internally
1430
+ const memory = new MemoryLibSQL({
1431
+ url: 'file:./local.db',
1432
+ });
1433
+
1434
+ // Option 2: Pass existing client for shared connections
1435
+ import { createClient } from '@libsql/client';
1436
+ const client = createClient({ url: 'file:./local.db' });
1437
+ const memory = new MemoryLibSQL({ client });
1438
+ ```
1439
+
1440
+ **Breaking changes:**
1441
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
1442
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
1443
+
1444
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
1445
+
1446
+ ### Summary
1447
+
1448
+ This release introduces a new storage architecture that replaces passthrough methods on `MastraStorage` with domain-specific storage interfaces accessed via `getStore()`. This change reduces code duplication across storage adapters and provides a cleaner, more modular API.
1449
+
1450
+ ### Migration Guide
1451
+
1452
+ All direct method calls on storage instances should be updated to use `getStore()`:
1453
+
1454
+ ```typescript
1455
+ // Before
1456
+ const thread = await storage.getThreadById({ threadId });
1457
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1458
+ await storage.createSpan(span);
1459
+
1460
+ // After
1461
+ const memory = await storage.getStore('memory');
1462
+ const thread = await memory?.getThreadById({ threadId });
1463
+
1464
+ const workflows = await storage.getStore('workflows');
1465
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1466
+
1467
+ const observability = await storage.getStore('observability');
1468
+ await observability?.createSpan(span);
1469
+ ```
1470
+
1471
+ ### Available Domains
1472
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
1473
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
1474
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
1475
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
1476
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
1477
+
1478
+ ### Breaking Changes
1479
+ - Passthrough methods have been removed from `MastraStorage` base class
1480
+ - All storage adapters now require accessing domains via `getStore()`
1481
+ - The `stores` property on storage instances is now the canonical way to access domain storage
1482
+
1483
+ ### Internal Changes
1484
+ - Each storage adapter now initializes domain-specific stores in its constructor
1485
+ - Domain stores share database connections and handle their own table initialization
1486
+
1487
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
1488
+
1489
+ ## What changed
1490
+
1491
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
1492
+
1493
+ **Before:**
1494
+
1495
+ ```typescript
1496
+ // Old span structure
1497
+ span.agentId; // 'my-agent'
1498
+ span.toolId; // undefined
1499
+ span.workflowId; // undefined
1500
+ ```
1501
+
1502
+ **After:**
1503
+
1504
+ ```typescript
1505
+ // New span structure
1506
+ span.entityType; // EntityType.AGENT
1507
+ span.entityId; // 'my-agent'
1508
+ span.entityName; // 'My Agent'
1509
+ ```
1510
+
1511
+ ## New `listTraces()` API
1512
+
1513
+ Query traces with filtering, pagination, and sorting:
1514
+
1515
+ ```typescript
1516
+ const { spans, pagination } = await storage.listTraces({
1517
+ filters: {
1518
+ entityType: EntityType.AGENT,
1519
+ entityId: 'my-agent',
1520
+ userId: 'user-123',
1521
+ environment: 'production',
1522
+ status: TraceStatus.SUCCESS,
1523
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1524
+ },
1525
+ pagination: { page: 0, perPage: 50 },
1526
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1527
+ });
1528
+ ```
1529
+
1530
+ **Available filters:** date ranges (`startedAt`, `endedAt`), entity (`entityType`, `entityId`, `entityName`), identity (`userId`, `organizationId`), correlation IDs (`runId`, `sessionId`, `threadId`), deployment (`environment`, `source`, `serviceName`), `tags`, `metadata`, and `status`.
1531
+
1532
+ ## New retrieval methods
1533
+ - `getSpan({ traceId, spanId })` - Get a single span
1534
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1535
+ - `getTrace({ traceId })` - Get all spans for a trace
1536
+
1537
+ ## Backward compatibility
1538
+
1539
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1540
+
1541
+ ## Migration
1542
+
1543
+ **Automatic:** SQL-based stores (PostgreSQL, LibSQL, MSSQL) automatically add new columns to existing `spans` tables on initialization. Existing data is preserved with new columns set to `NULL`.
1544
+
1545
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1546
+
1547
+ - Aligned vector store configuration with underlying library APIs, giving you access to all library options directly. ([#11742](https://github.com/mastra-ai/mastra/pull/11742))
1548
+
1549
+ **Why this change?**
1550
+
1551
+ Previously, each vector store defined its own configuration types that only exposed a subset of the underlying library's options. This meant users couldn't access advanced features like authentication, SSL, compression, or custom headers without creating their own client instances. Now, the configuration types extend the library types directly, so all options are available.
1552
+
1553
+ **@mastra/libsql** (Breaking)
1554
+
1555
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
1556
+
1557
+ ```typescript
1558
+ // Before
1559
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
1560
+
1561
+ // After
1562
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
1563
+ ```
1564
+
1565
+ **@mastra/opensearch** (Breaking)
1566
+
1567
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
1568
+
1569
+ ```typescript
1570
+ // Before
1571
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
1572
+
1573
+ // After
1574
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
1575
+
1576
+ // With authentication (now possible)
1577
+ new OpenSearchVector({
1578
+ id: 'my-vector',
1579
+ node: 'https://localhost:9200',
1580
+ auth: { username: 'admin', password: 'admin' },
1581
+ ssl: { rejectUnauthorized: false },
1582
+ });
1583
+ ```
1584
+
1585
+ **@mastra/pinecone** (Breaking)
1586
+
1587
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
1588
+
1589
+ ```typescript
1590
+ // Before
1591
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
1592
+
1593
+ // After
1594
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
1595
+
1596
+ // With custom controller host (if needed)
1597
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
1598
+ ```
1599
+
1600
+ **@mastra/clickhouse**
1601
+
1602
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
1603
+
1604
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
1605
+
1606
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
1607
+
1608
+ **@mastra/deployer-cloud**
1609
+
1610
+ Updated internal LibSQLVector configuration for compatibility with the new API.
1611
+
1612
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
1613
+
1614
+ Adds a new `disableInit` config option to all storage providers that allows users to disable automatic table creation/migrations at runtime. This is useful for CI/CD pipelines where you want to run migrations during deployment with elevated credentials, then run the application with `disableInit: true` so it doesn't attempt schema changes at runtime.
1615
+
1616
+ ```typescript
1617
+ // CI/CD script - run migrations
1618
+ const storage = new PostgresStore({
1619
+ connectionString: DATABASE_URL,
1620
+ id: 'pg-storage',
1621
+ });
1622
+ await storage.init();
1623
+
1624
+ // Runtime - skip auto-init
1625
+ const storage = new PostgresStore({
1626
+ connectionString: DATABASE_URL,
1627
+ id: 'pg-storage',
1628
+ disableInit: true,
1629
+ });
1630
+ ```
1631
+
1632
+ ### Patch Changes
1633
+
1634
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
1635
+
1636
+ Mastra packages now include embedded documentation in the published npm package under `dist/docs/`. This enables coding agents and AI assistants to understand and use the framework by reading documentation directly from `node_modules`.
1637
+
1638
+ Each package includes:
1639
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
1640
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
1641
+ - **Topic folders** - Conceptual documentation organized by feature area
1642
+
1643
+ Documentation is driven by the `packages` frontmatter field in MDX files, which maps docs to their corresponding packages. CI validation ensures all docs include this field.
1644
+
1645
+ - Standardize error IDs across all storage and vector stores using centralized helper functions (`createStorageErrorId` and `createVectorErrorId`). This ensures consistent error ID patterns (`MASTRA_STORAGE_{STORE}_{OPERATION}_{STATUS}` and `MASTRA_VECTOR_{STORE}_{OPERATION}_{STATUS}`) across the codebase for better error tracking and debugging. ([#10913](https://github.com/mastra-ai/mastra/pull/10913))
1646
+
1647
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
1648
+
1649
+ **What Changed**
1650
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
1651
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
1652
+
1653
+ **Impact**
1654
+ Previously, calling getScoreById after saveScore would return null because the generated ID wasn't persisted to the database. This is now fixed across all store implementations, ensuring consistent behavior and data integrity.
1655
+
1656
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
1657
+
1658
+ - - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
1659
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
1660
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
1661
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
1662
+
1663
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
1664
+
1665
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
1666
+
1667
+ **Before:**
1668
+
1669
+ ```typescript
1670
+ const result = await workflow.execute({ input });
1671
+ if (result.status === 'failed') {
1672
+ // Custom error properties were lost
1673
+ console.log(result.error); // "Step execution failed" (just a string)
1674
+ }
1675
+ ```
1676
+
1677
+ **After:**
1678
+
1679
+ ```typescript
1680
+ const result = await workflow.execute({ input });
1681
+ if (result.status === 'failed') {
1682
+ // Custom properties are preserved
1683
+ console.log(result.error.message); // "Step execution failed"
1684
+ console.log(result.error.statusCode); // 429
1685
+ console.log(result.error.cause?.name); // "RateLimitError"
1686
+ }
1687
+ ```
1688
+
1689
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
1690
+
1691
+ Other changes:
1692
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
1693
+
1694
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
1695
+
1696
+ **What changed:** The `filter.dateRange` parameter in `listMessages()` and `Memory.recall()` now supports `startExclusive` and `endExclusive` boolean options. When set to `true`, messages with timestamps exactly matching the boundary are excluded from results.
1697
+
1698
+ **Why this matters:** Enables cursor-based pagination for chat applications. When new messages arrive during a session, offset-based pagination can skip or duplicate messages. Using `endExclusive: true` with the oldest message's timestamp as a cursor ensures consistent pagination without gaps or duplicates.
1699
+
1700
+ **Example:**
1701
+
1702
+ ```typescript
1703
+ // Get first page
1704
+ const page1 = await memory.recall({
1705
+ threadId: 'thread-123',
1706
+ perPage: 10,
1707
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1708
+ });
1709
+
1710
+ // Get next page using cursor-based pagination
1711
+ const oldestMessage = page1.messages[page1.messages.length - 1];
1712
+ const page2 = await memory.recall({
1713
+ threadId: 'thread-123',
1714
+ perPage: 10,
1715
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1716
+ filter: {
1717
+ dateRange: {
1718
+ end: oldestMessage.createdAt,
1719
+ endExclusive: true, // Excludes the cursor message
1720
+ },
1721
+ },
1722
+ });
1723
+ ```
1724
+
1725
+ - Fixed duplicate spans migration issue across all storage backends. When upgrading from older versions, existing duplicate (traceId, spanId) combinations in the spans table could prevent the unique constraint from being created. The migration deduplicates spans before adding the constraint. ([#12073](https://github.com/mastra-ai/mastra/pull/12073))
1726
+
1727
+ **Deduplication rules (in priority order):**
1728
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
1729
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
1730
+ 3. Use `createdAt` as the final tiebreaker
1731
+
1732
+ **What changed:**
1733
+ - Added `migrateSpans()` method to observability stores for manual migration
1734
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
1735
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
1736
+
1737
+ **Usage example:**
1738
+
1739
+ ```typescript
1740
+ const observability = await storage.getStore('observability');
1741
+ const status = await observability.checkSpansMigrationStatus();
1742
+ if (status.needsMigration) {
1743
+ const result = await observability.migrateSpans();
1744
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
1745
+ }
1746
+ ```
1747
+
1748
+ Fixes #11840
1749
+
1750
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
1751
+
1752
+ `MastraStorage` can now compose storage domains from different adapters. Use it when you need different databases for different purposes - for example, PostgreSQL for memory and workflows, but a different database for observability.
1753
+
1754
+ ```typescript
1755
+ import { MastraStorage } from '@mastra/core/storage';
1756
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
1757
+ import { MemoryLibSQL } from '@mastra/libsql';
1758
+
1759
+ // Compose domains from different stores
1760
+ const storage = new MastraStorage({
1761
+ id: 'composite',
1762
+ domains: {
1763
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
1764
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
1765
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
1766
+ },
1767
+ });
1768
+ ```
1769
+
1770
+ **Breaking changes:**
1771
+ - `storage.supports` property no longer exists
1772
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
1773
+
1774
+ All stores now support the same features. For domain availability, use `getStore()`:
1775
+
1776
+ ```typescript
1777
+ const store = await storage.getStore('memory');
1778
+ if (store) {
1779
+ // domain is available
1780
+ }
1781
+ ```
1782
+
1783
+ - - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()` ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
1784
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
1785
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
1786
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
1787
+
1788
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
1789
+
1790
+ ```typescript
1791
+ await workflow.deleteWorkflowRunById(runId);
1792
+ ```
1793
+
1794
+ - Added a unified `transformScoreRow` function in `@mastra/core/storage` that provides schema-driven row transformation for score data. This eliminates code duplication across 10 storage adapters while maintaining store-specific behavior through configurable options: ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
1795
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
1796
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
1797
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
1798
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
1799
+
1800
+ Each store adapter now uses the unified function with appropriate options, reducing ~200 lines of duplicate transformation logic while ensuring consistent behavior across all storage backends.
1801
+
1802
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
1803
+
1804
+ **New Features**
1805
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
1806
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
1807
+ - Full pagination and sorting support
1808
+
1809
+ **Example Usage**
1810
+
1811
+ ```typescript
1812
+ // List all threads
1813
+ const allThreads = await memory.listThreads({});
1814
+
1815
+ // Filter by resourceId only
1816
+ const userThreads = await memory.listThreads({
1817
+ filter: { resourceId: 'user-123' },
1818
+ });
1819
+
1820
+ // Filter by metadata only
1821
+ const supportThreads = await memory.listThreads({
1822
+ filter: { metadata: { category: 'support' } },
1823
+ });
1824
+
1825
+ // Filter by both with pagination
1826
+ const filteredThreads = await memory.listThreads({
1827
+ filter: {
1828
+ resourceId: 'user-123',
1829
+ metadata: { priority: 'high', status: 'open' },
1830
+ },
1831
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
1832
+ page: 0,
1833
+ perPage: 20,
1834
+ });
1835
+ ```
1836
+
1837
+ **Security Improvements**
1838
+ - Added validation to prevent SQL injection via malicious metadata keys
1839
+ - Added pagination parameter validation to prevent integer overflow attacks
1840
+
1841
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
1842
+ Add status filter to `listWorkflowRuns`
1843
+ Add automatic restart to restart active workflow runs when server starts
1844
+
1845
+ - Renamed MastraStorage to MastraCompositeStore for better clarity. The old MastraStorage name remains available as a deprecated alias for backward compatibility, but will be removed in a future version. ([#12093](https://github.com/mastra-ai/mastra/pull/12093))
1846
+
1847
+ **Migration:**
1848
+
1849
+ Update your imports and usage:
1850
+
1851
+ ```typescript
1852
+ // Before
1853
+ import { MastraStorage } from '@mastra/core/storage';
1854
+
1855
+ const storage = new MastraStorage({
1856
+ id: 'composite',
1857
+ domains: { ... }
1858
+ });
1859
+
1860
+ // After
1861
+ import { MastraCompositeStore } from '@mastra/core/storage';
1862
+
1863
+ const storage = new MastraCompositeStore({
1864
+ id: 'composite',
1865
+ domains: { ... }
1866
+ });
1867
+ ```
1868
+
1869
+ The new name better reflects that this is a composite storage implementation that routes different domains (workflows, traces, messages) to different underlying stores, avoiding confusion with the general "Mastra Storage" concept.
1870
+
1871
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
1872
+
1873
+ ```typescript
1874
+ // Clone a thread
1875
+ const { thread, clonedMessages } = await memory.cloneThread({
1876
+ sourceThreadId: 'thread-123',
1877
+ title: 'My Clone',
1878
+ options: {
1879
+ messageLimit: 10, // optional: only copy last N messages
1880
+ },
1881
+ });
1882
+
1883
+ // Check if a thread is a clone
1884
+ if (memory.isClone(thread)) {
1885
+ const source = await memory.getSourceThread(thread.id);
1886
+ }
1887
+
1888
+ // List all clones of a thread
1889
+ const clones = await memory.listClones('thread-123');
1890
+ ```
1891
+
1892
+ Includes:
1893
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
1894
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
1895
+ - Embeddings created for cloned messages (semantic recall)
1896
+ - Clone button in playground UI Memory tab
1897
+
1898
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
1899
+
1900
+ **What changed**
1901
+
1902
+ All storage adapters now accept pre-configured database clients in addition to connection credentials. This allows you to customize client settings (connection pools, timeouts, interceptors) before passing them to Mastra.
1903
+
1904
+ **Example**
1905
+
1906
+ ```typescript
1907
+ import { createClient } from '@clickhouse/client';
1908
+ import { ClickhouseStore } from '@mastra/clickhouse';
1909
+
1910
+ // Create and configure client with custom settings
1911
+ const client = createClient({
1912
+ url: 'http://localhost:8123',
1913
+ username: 'default',
1914
+ password: '',
1915
+ request_timeout: 60000,
1916
+ });
1917
+
1918
+ // Pass pre-configured client to store
1919
+ const store = new ClickhouseStore({
1920
+ id: 'my-store',
1921
+ client,
1922
+ });
1923
+ ```
1924
+
1925
+ **Additional improvements**
1926
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
1927
+
1928
+ - Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`d2d3e22`](https://github.com/mastra-ai/mastra/commit/d2d3e22a419ee243f8812a84e3453dd44365ecb0), [`08766f1`](https://github.com/mastra-ai/mastra/commit/08766f15e13ac0692fde2a8bd366c2e16e4321df), [`72df8ae`](https://github.com/mastra-ai/mastra/commit/72df8ae595584cdd7747d5c39ffaca45e4507227), [`ebae12a`](https://github.com/mastra-ai/mastra/commit/ebae12a2dd0212e75478981053b148a2c246962d), [`c8417b4`](https://github.com/mastra-ai/mastra/commit/c8417b41d9f3486854dc7842d977fbe5e2166264), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`39c9743`](https://github.com/mastra-ai/mastra/commit/39c97432d084294f8ba85fbf3ef28098ff21459e), [`1dbd8c7`](https://github.com/mastra-ai/mastra/commit/1dbd8c729fb6536ec52f00064d76b80253d346e9), [`c61a0a5`](https://github.com/mastra-ai/mastra/commit/c61a0a5de4904c88fd8b3718bc26d1be1c2ec6e7), [`05b8bee`](https://github.com/mastra-ai/mastra/commit/05b8bee9e50e6c2a4a2bf210eca25ee212ca24fa), [`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`3d93a15`](https://github.com/mastra-ai/mastra/commit/3d93a15796b158c617461c8b98bede476ebb43e2), [`9198899`](https://github.com/mastra-ai/mastra/commit/91988995c427b185c33714b7f3be955367911324), [`ed3e3dd`](https://github.com/mastra-ai/mastra/commit/ed3e3ddec69d564fe2b125e083437f76331f1283), [`c59e13c`](https://github.com/mastra-ai/mastra/commit/c59e13c7688284bd96b2baee3e314335003548de), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`ae8baf7`](https://github.com/mastra-ai/mastra/commit/ae8baf7d8adcb0ff9dac11880400452bc49b33ff), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`940a2b2`](https://github.com/mastra-ai/mastra/commit/940a2b27480626ed7e74f55806dcd2181c1dd0c2), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`0491e7c`](https://github.com/mastra-ai/mastra/commit/0491e7c9b714cb0ba22187ee062147ec2dd7c712), [`f6f4903`](https://github.com/mastra-ai/mastra/commit/f6f4903397314f73362061dc5a3e8e7c61ea34aa), [`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`2f897df`](https://github.com/mastra-ai/mastra/commit/2f897df208508f46f51b7625e5dd20c37f93e0e3), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`4f94ed8`](https://github.com/mastra-ai/mastra/commit/4f94ed8177abfde3ec536e3574883e075423350c), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`38380b6`](https://github.com/mastra-ai/mastra/commit/38380b60fca905824bdf6b43df307a58efb1aa15), [`6833c69`](https://github.com/mastra-ai/mastra/commit/6833c69607418d257750bbcdd84638993d343539), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`919a22b`](https://github.com/mastra-ai/mastra/commit/919a22b25876f9ed5891efe5facbe682c30ff497), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`69136e7`](https://github.com/mastra-ai/mastra/commit/69136e748e32f57297728a4e0f9a75988462f1a7), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`0d41fe2`](https://github.com/mastra-ai/mastra/commit/0d41fe245355dfc66d61a0d9c85d9400aac351ff), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`aaa40e7`](https://github.com/mastra-ai/mastra/commit/aaa40e788628b319baa8e889407d11ad626547fa), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`449aed2`](https://github.com/mastra-ai/mastra/commit/449aed2ba9d507b75bf93d427646ea94f734dfd1), [`eb648a2`](https://github.com/mastra-ai/mastra/commit/eb648a2cc1728f7678768dd70cd77619b448dab9), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ac3cc23`](https://github.com/mastra-ai/mastra/commit/ac3cc2397d1966bc0fc2736a223abc449d3c7719), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`a86f4df`](https://github.com/mastra-ai/mastra/commit/a86f4df0407311e0d2ea49b9a541f0938810d6a9), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`edb07e4`](https://github.com/mastra-ai/mastra/commit/edb07e49283e0c28bd094a60e03439bf6ecf0221), [`e0941c3`](https://github.com/mastra-ai/mastra/commit/e0941c3d7fc75695d5d258e7008fd5d6e650800c), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`798d0c7`](https://github.com/mastra-ai/mastra/commit/798d0c740232653b1d754870e6b43a55c364ffe2), [`0c0580a`](https://github.com/mastra-ai/mastra/commit/0c0580a42f697cd2a7d5973f25bfe7da9055038a), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`0131105`](https://github.com/mastra-ai/mastra/commit/0131105532e83bdcbb73352fc7d0879eebf140dc), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`47b1c16`](https://github.com/mastra-ai/mastra/commit/47b1c16a01c7ffb6765fe1e499b49092f8b7eba3), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`ffe84d5`](https://github.com/mastra-ai/mastra/commit/ffe84d54f3b0f85167fe977efd027dba027eb998), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`b00ccd3`](https://github.com/mastra-ai/mastra/commit/b00ccd325ebd5d9e37e34dd0a105caae67eb568f), [`28f5f89`](https://github.com/mastra-ai/mastra/commit/28f5f89705f2409921e3c45178796c0e0d0bbb64), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`e601b27`](https://github.com/mastra-ai/mastra/commit/e601b272c70f3a5ecca610373aa6223012704892), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`029540c`](https://github.com/mastra-ai/mastra/commit/029540ca1e582fc2dd8d288ecd4a9b0f31a954ef), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`653e65a`](https://github.com/mastra-ai/mastra/commit/653e65ae1f9502c2958a32f47a5a2df11e612a92), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`3d3366f`](https://github.com/mastra-ai/mastra/commit/3d3366f31683e7137d126a3a57174a222c5801fb), [`5a4953f`](https://github.com/mastra-ai/mastra/commit/5a4953f7d25bb15ca31ed16038092a39cb3f98b3), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`efe406a`](https://github.com/mastra-ai/mastra/commit/efe406a1353c24993280ebc2ed61dd9f65b84b26), [`eb9e522`](https://github.com/mastra-ai/mastra/commit/eb9e522ce3070a405e5b949b7bf5609ca51d7fe2), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`20e6f19`](https://github.com/mastra-ai/mastra/commit/20e6f1971d51d3ff6dd7accad8aaaae826d540ed), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`3bdfa75`](https://github.com/mastra-ai/mastra/commit/3bdfa7507a91db66f176ba8221aa28dd546e464a), [`119e5c6`](https://github.com/mastra-ai/mastra/commit/119e5c65008f3e5cfca954eefc2eb85e3bf40da4), [`c6fd6fe`](https://github.com/mastra-ai/mastra/commit/c6fd6fedd09e9cf8004b03a80925f5e94826ad7e), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`e770de9`](https://github.com/mastra-ai/mastra/commit/e770de941a287a49b1964d44db5a5763d19890a6), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`ca8041c`](https://github.com/mastra-ai/mastra/commit/ca8041cce0379fda22ed293a565bcb5b6ddca68a), [`b5dc973`](https://github.com/mastra-ai/mastra/commit/b5dc9733a5158850298dfb103acb3babdba8a318), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`52e2716`](https://github.com/mastra-ai/mastra/commit/52e2716b42df6eff443de72360ae83e86ec23993), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`4f0b3c6`](https://github.com/mastra-ai/mastra/commit/4f0b3c66f196c06448487f680ccbb614d281e2f7), [`27b4040`](https://github.com/mastra-ai/mastra/commit/27b4040bfa1a95d92546f420a02a626b1419a1d6), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`352a5d6`](https://github.com/mastra-ai/mastra/commit/352a5d625cfe09849b21e8f52a24c9f0366759d5), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`74c4f22`](https://github.com/mastra-ai/mastra/commit/74c4f22ed4c71e72598eacc346ba95cdbc00294f), [`3a76a80`](https://github.com/mastra-ai/mastra/commit/3a76a80284cb71a0faa975abb3d4b2a9631e60cd), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`2c212e7`](https://github.com/mastra-ai/mastra/commit/2c212e704c90e2db83d4109e62c03f0f6ebd2667), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`f9a2509`](https://github.com/mastra-ai/mastra/commit/f9a25093ea72d210a5e52cfcb3bcc8b5e02dc25c), [`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`b7e17d3`](https://github.com/mastra-ai/mastra/commit/b7e17d3f5390bb5a71efc112204413656fcdc18d), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`4ca4306`](https://github.com/mastra-ai/mastra/commit/4ca430614daa5fa04730205a302a43bf4accfe9f), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`74e504a`](https://github.com/mastra-ai/mastra/commit/74e504a3b584eafd2f198001c6a113bbec589fd3), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`903f67d`](https://github.com/mastra-ai/mastra/commit/903f67d184504a273893818c02b961f5423a79ad), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`e33fdbd`](https://github.com/mastra-ai/mastra/commit/e33fdbd07b33920d81e823122331b0c0bee0bb59), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`7a010c5`](https://github.com/mastra-ai/mastra/commit/7a010c56b846a313a49ae42fccd3d8de2b9f292d), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`81b6a8f`](https://github.com/mastra-ai/mastra/commit/81b6a8ff79f49a7549d15d66624ac1a0b8f5f971), [`8538a0d`](https://github.com/mastra-ai/mastra/commit/8538a0d232619bf55dad7ddc2a8b0ca77c679a87), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`a4f010b`](https://github.com/mastra-ai/mastra/commit/a4f010b22e4355a5fdee70a1fe0f6e4a692cc29e), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`8dc7f55`](https://github.com/mastra-ai/mastra/commit/8dc7f55900395771da851dc7d78d53ae84fe34ec), [`cfabdd4`](https://github.com/mastra-ai/mastra/commit/cfabdd4aae7a726b706942d6836eeca110fb6267), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`01b20fe`](https://github.com/mastra-ai/mastra/commit/01b20fefb7c67c2b7d79417598ef4e60256d1225), [`dd4f34c`](https://github.com/mastra-ai/mastra/commit/dd4f34c78cbae24063463475b0619575c415f9b8), [`8379099`](https://github.com/mastra-ai/mastra/commit/8379099fc467af6bef54dd7f80c9bd75bf8bbddf), [`0dbf199`](https://github.com/mastra-ai/mastra/commit/0dbf199110f22192ce5c95b1c8148d4872b4d119), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`a0a5b4b`](https://github.com/mastra-ai/mastra/commit/a0a5b4bbebe6c701ebbadf744873aa0d5ca01371), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`929f69c`](https://github.com/mastra-ai/mastra/commit/929f69c3436fa20dd0f0e2f7ebe8270bd82a1529), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`8c0ec25`](https://github.com/mastra-ai/mastra/commit/8c0ec25646c8a7df253ed1e5ff4863a0d3f1316c), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`69ea758`](https://github.com/mastra-ai/mastra/commit/69ea758358edd7117f191c2e69c8bb5fc79e7a1a), [`73b0bb3`](https://github.com/mastra-ai/mastra/commit/73b0bb394dba7c9482eb467a97ab283dbc0ef4db), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`6b3ba91`](https://github.com/mastra-ai/mastra/commit/6b3ba91494cc10394df96782f349a4f7b1e152cc), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`993ad98`](https://github.com/mastra-ai/mastra/commit/993ad98d7ad3bebda9ecef5fec5c94349a0d04bc), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`3ff2c17`](https://github.com/mastra-ai/mastra/commit/3ff2c17a58e312fad5ea37377262c12d92ca0908), [`a0e437f`](https://github.com/mastra-ai/mastra/commit/a0e437fac561b28ee719e0302d72b2f9b4c138f0), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`5627a8c`](https://github.com/mastra-ai/mastra/commit/5627a8c6dc11fe3711b3fa7a6ffd6eb34100a306), [`398fde3`](https://github.com/mastra-ai/mastra/commit/398fde3f39e707cda79372cdae8f9870e3b57c8d), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`3ff45d1`](https://github.com/mastra-ai/mastra/commit/3ff45d10e0c80c5335a957ab563da72feb623520), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`251df45`](https://github.com/mastra-ai/mastra/commit/251df4531407dfa46d805feb40ff3fb49769f455), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`f894d14`](https://github.com/mastra-ai/mastra/commit/f894d148946629af7b1f452d65a9cf864cec3765), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c2b9547`](https://github.com/mastra-ai/mastra/commit/c2b9547bf435f56339f23625a743b2147ab1c7a6), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`9312dcd`](https://github.com/mastra-ai/mastra/commit/9312dcd1c6f5b321929e7d382e763d95fdc030f5), [`b2e45ec`](https://github.com/mastra-ai/mastra/commit/b2e45eca727a8db01a81ba93f1a5219c7183c839), [`5d7000f`](https://github.com/mastra-ai/mastra/commit/5d7000f757cd65ea9dc5b05e662fd83dfd44e932), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`d6d49f7`](https://github.com/mastra-ai/mastra/commit/d6d49f7b8714fa19a52ff9c7cf7fb7e73751901e), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`580b592`](https://github.com/mastra-ai/mastra/commit/580b5927afc82fe460dfdf9a38a902511b6b7e7f), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`3f2faf2`](https://github.com/mastra-ai/mastra/commit/3f2faf2e2d685d6c053cc5af1bf9fedf267b2ce5), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`ff4d9a6`](https://github.com/mastra-ai/mastra/commit/ff4d9a6704fc87b31a380a76ed22736fdedbba5a), [`50fd320`](https://github.com/mastra-ai/mastra/commit/50fd320003d0d93831c230ef531bef41f5ba7b3a), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`69821ef`](https://github.com/mastra-ai/mastra/commit/69821ef806482e2c44e2197ac0b050c3fe3a5285), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`0bed332`](https://github.com/mastra-ai/mastra/commit/0bed332843f627202c6520eaf671771313cd20f3), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`bec5efd`](https://github.com/mastra-ai/mastra/commit/bec5efde96653ccae6604e68c696d1bc6c1a0bf5), [`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`7907fd1`](https://github.com/mastra-ai/mastra/commit/7907fd1c5059813b7b870b81ca71041dc807331b), [`1ed5716`](https://github.com/mastra-ai/mastra/commit/1ed5716830867b3774c4a1b43cc0d82935f32b96), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9eedf7d`](https://github.com/mastra-ai/mastra/commit/9eedf7de1d6e0022a2f4e5e9e6fe1ec468f9b43c), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176), [`4186bdd`](https://github.com/mastra-ai/mastra/commit/4186bdd00731305726fa06adba0b076a1d50b49f), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`4f0331a`](https://github.com/mastra-ai/mastra/commit/4f0331a79bf6eb5ee598a5086e55de4b5a0ada03), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`7aaf973`](https://github.com/mastra-ai/mastra/commit/7aaf973f83fbbe9521f1f9e7a4fd99b8de464617), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4), [`8a73529`](https://github.com/mastra-ai/mastra/commit/8a73529ca01187f604b1f3019d0a725ac63ae55f), [`e59e0d3`](https://github.com/mastra-ai/mastra/commit/e59e0d32afb5fcf2c9f3c00c8f81f6c21d3a63fa), [`4fba91b`](https://github.com/mastra-ai/mastra/commit/4fba91bec7c95911dc28e369437596b152b04cd0), [`465ac05`](https://github.com/mastra-ai/mastra/commit/465ac0526a91d175542091c675181f1a96c98c46), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`8a000da`](https://github.com/mastra-ai/mastra/commit/8a000da0c09c679a2312f6b3aa05b2ca78ca7393), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019), [`12b0cc4`](https://github.com/mastra-ai/mastra/commit/12b0cc4077d886b1a552637dedb70a7ade93528c), [`3bf6c5f`](https://github.com/mastra-ai/mastra/commit/3bf6c5f104c25226cd84e0c77f9dec15f2cac2db)]:
1929
+ - @mastra/core@1.0.0
1930
+
1931
+ ## 1.0.0-beta.14
1932
+
1933
+ ### Patch Changes
1934
+
1935
+ - Fixed duplicate spans migration issue across all storage backends. When upgrading from older versions, existing duplicate (traceId, spanId) combinations in the spans table could prevent the unique constraint from being created. The migration deduplicates spans before adding the constraint. ([#12073](https://github.com/mastra-ai/mastra/pull/12073))
1936
+
1937
+ **Deduplication rules (in priority order):**
1938
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
1939
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
1940
+ 3. Use `createdAt` as the final tiebreaker
1941
+
1942
+ **What changed:**
1943
+ - Added `migrateSpans()` method to observability stores for manual migration
1944
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
1945
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
1946
+
1947
+ **Usage example:**
1948
+
1949
+ ```typescript
1950
+ const observability = await storage.getStore('observability');
1951
+ const status = await observability.checkSpansMigrationStatus();
1952
+ if (status.needsMigration) {
1953
+ const result = await observability.migrateSpans();
1954
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
1955
+ }
1956
+ ```
1957
+
1958
+ Fixes #11840
1959
+
1960
+ - Renamed MastraStorage to MastraCompositeStore for better clarity. The old MastraStorage name remains available as a deprecated alias for backward compatibility, but will be removed in a future version. ([#12093](https://github.com/mastra-ai/mastra/pull/12093))
1961
+
1962
+ **Migration:**
1963
+
1964
+ Update your imports and usage:
1965
+
1966
+ ```typescript
1967
+ // Before
1968
+ import { MastraStorage } from '@mastra/core/storage';
1969
+
1970
+ const storage = new MastraStorage({
1971
+ id: 'composite',
1972
+ domains: { ... }
1973
+ });
1974
+
1975
+ // After
1976
+ import { MastraCompositeStore } from '@mastra/core/storage';
1977
+
1978
+ const storage = new MastraCompositeStore({
1979
+ id: 'composite',
1980
+ domains: { ... }
1981
+ });
1982
+ ```
1983
+
1984
+ The new name better reflects that this is a composite storage implementation that routes different domains (workflows, traces, messages) to different underlying stores, avoiding confusion with the general "Mastra Storage" concept.
1985
+
1986
+ - Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897)]:
1987
+ - @mastra/core@1.0.0-beta.26
1988
+
1989
+ ## 1.0.0-beta.13
1990
+
1991
+ ### Patch Changes
1992
+
1993
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
1994
+
1995
+ **New Features**
1996
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
1997
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
1998
+ - Full pagination and sorting support
1999
+
2000
+ **Example Usage**
2001
+
2002
+ ```typescript
2003
+ // List all threads
2004
+ const allThreads = await memory.listThreads({});
2005
+
2006
+ // Filter by resourceId only
2007
+ const userThreads = await memory.listThreads({
2008
+ filter: { resourceId: 'user-123' },
2009
+ });
2010
+
2011
+ // Filter by metadata only
2012
+ const supportThreads = await memory.listThreads({
2013
+ filter: { metadata: { category: 'support' } },
2014
+ });
2015
+
2016
+ // Filter by both with pagination
2017
+ const filteredThreads = await memory.listThreads({
2018
+ filter: {
2019
+ resourceId: 'user-123',
2020
+ metadata: { priority: 'high', status: 'open' },
2021
+ },
2022
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
2023
+ page: 0,
2024
+ perPage: 20,
2025
+ });
2026
+ ```
2027
+
2028
+ **Security Improvements**
2029
+ - Added validation to prevent SQL injection via malicious metadata keys
2030
+ - Added pagination parameter validation to prevent integer overflow attacks
2031
+
2032
+ - Updated dependencies [[`ed3e3dd`](https://github.com/mastra-ai/mastra/commit/ed3e3ddec69d564fe2b125e083437f76331f1283), [`6833c69`](https://github.com/mastra-ai/mastra/commit/6833c69607418d257750bbcdd84638993d343539), [`47b1c16`](https://github.com/mastra-ai/mastra/commit/47b1c16a01c7ffb6765fe1e499b49092f8b7eba3), [`3a76a80`](https://github.com/mastra-ai/mastra/commit/3a76a80284cb71a0faa975abb3d4b2a9631e60cd), [`8538a0d`](https://github.com/mastra-ai/mastra/commit/8538a0d232619bf55dad7ddc2a8b0ca77c679a87), [`9312dcd`](https://github.com/mastra-ai/mastra/commit/9312dcd1c6f5b321929e7d382e763d95fdc030f5)]:
2033
+ - @mastra/core@1.0.0-beta.25
2034
+
2035
+ ## 1.0.0-beta.12
2036
+
2037
+ ### Minor Changes
2038
+
2039
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
2040
+
2041
+ **Why this change?**
2042
+
2043
+ These were the last remaining columns storing JSON as TEXT. This change aligns them with other tables that already use JSONB, enabling native JSON operators and improved performance. See [#8978](https://github.com/mastra-ai/mastra/issues/8978) for details.
2044
+
2045
+ **Columns Changed:**
2046
+ - `mastra_threads.metadata` - Thread metadata
2047
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
2048
+
2049
+ **PostgreSQL**
2050
+
2051
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
2052
+
2053
+ ```sql
2054
+ ALTER TABLE mastra_threads
2055
+ ALTER COLUMN metadata TYPE jsonb
2056
+ USING metadata::jsonb;
2057
+
2058
+ ALTER TABLE mastra_workflow_snapshot
2059
+ ALTER COLUMN snapshot TYPE jsonb
2060
+ USING snapshot::jsonb;
2061
+ ```
2062
+
2063
+ **LibSQL**
2064
+
2065
+ No Migration Required - LibSQL now uses native SQLite JSONB format (added in SQLite 3.45) for ~3x performance improvement on JSON operations. The changes are fully backwards compatible:
2066
+ - Existing TEXT JSON data continues to work
2067
+ - New data is stored in binary JSONB format
2068
+ - Both formats can coexist in the same table
2069
+ - All JSON functions (`json_extract`, etc.) work on both formats
2070
+
2071
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
2072
+
2073
+ - Aligned vector store configuration with underlying library APIs, giving you access to all library options directly. ([#11742](https://github.com/mastra-ai/mastra/pull/11742))
2074
+
2075
+ **Why this change?**
2076
+
2077
+ Previously, each vector store defined its own configuration types that only exposed a subset of the underlying library's options. This meant users couldn't access advanced features like authentication, SSL, compression, or custom headers without creating their own client instances. Now, the configuration types extend the library types directly, so all options are available.
2078
+
2079
+ **@mastra/libsql** (Breaking)
2080
+
2081
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
2082
+
2083
+ ```typescript
2084
+ // Before
2085
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
2086
+
2087
+ // After
2088
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
2089
+ ```
2090
+
2091
+ **@mastra/opensearch** (Breaking)
2092
+
2093
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
2094
+
2095
+ ```typescript
2096
+ // Before
2097
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
2098
+
2099
+ // After
2100
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
2101
+
2102
+ // With authentication (now possible)
2103
+ new OpenSearchVector({
2104
+ id: 'my-vector',
2105
+ node: 'https://localhost:9200',
2106
+ auth: { username: 'admin', password: 'admin' },
2107
+ ssl: { rejectUnauthorized: false },
2108
+ });
2109
+ ```
2110
+
2111
+ **@mastra/pinecone** (Breaking)
2112
+
2113
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
2114
+
2115
+ ```typescript
2116
+ // Before
2117
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
2118
+
2119
+ // After
2120
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
2121
+
2122
+ // With custom controller host (if needed)
2123
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
2124
+ ```
2125
+
2126
+ **@mastra/clickhouse**
2127
+
2128
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
2129
+
2130
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
2131
+
2132
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
2133
+
2134
+ **@mastra/deployer-cloud**
2135
+
2136
+ Updated internal LibSQLVector configuration for compatibility with the new API.
2137
+
2138
+ ### Patch Changes
2139
+
2140
+ - Updated dependencies [[`ebae12a`](https://github.com/mastra-ai/mastra/commit/ebae12a2dd0212e75478981053b148a2c246962d), [`c61a0a5`](https://github.com/mastra-ai/mastra/commit/c61a0a5de4904c88fd8b3718bc26d1be1c2ec6e7), [`69136e7`](https://github.com/mastra-ai/mastra/commit/69136e748e32f57297728a4e0f9a75988462f1a7), [`449aed2`](https://github.com/mastra-ai/mastra/commit/449aed2ba9d507b75bf93d427646ea94f734dfd1), [`eb648a2`](https://github.com/mastra-ai/mastra/commit/eb648a2cc1728f7678768dd70cd77619b448dab9), [`0131105`](https://github.com/mastra-ai/mastra/commit/0131105532e83bdcbb73352fc7d0879eebf140dc), [`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`b00ccd3`](https://github.com/mastra-ai/mastra/commit/b00ccd325ebd5d9e37e34dd0a105caae67eb568f), [`3bdfa75`](https://github.com/mastra-ai/mastra/commit/3bdfa7507a91db66f176ba8221aa28dd546e464a), [`e770de9`](https://github.com/mastra-ai/mastra/commit/e770de941a287a49b1964d44db5a5763d19890a6), [`52e2716`](https://github.com/mastra-ai/mastra/commit/52e2716b42df6eff443de72360ae83e86ec23993), [`27b4040`](https://github.com/mastra-ai/mastra/commit/27b4040bfa1a95d92546f420a02a626b1419a1d6), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151), [`8dc7f55`](https://github.com/mastra-ai/mastra/commit/8dc7f55900395771da851dc7d78d53ae84fe34ec), [`8379099`](https://github.com/mastra-ai/mastra/commit/8379099fc467af6bef54dd7f80c9bd75bf8bbddf), [`8c0ec25`](https://github.com/mastra-ai/mastra/commit/8c0ec25646c8a7df253ed1e5ff4863a0d3f1316c), [`ff4d9a6`](https://github.com/mastra-ai/mastra/commit/ff4d9a6704fc87b31a380a76ed22736fdedbba5a), [`69821ef`](https://github.com/mastra-ai/mastra/commit/69821ef806482e2c44e2197ac0b050c3fe3a5285), [`1ed5716`](https://github.com/mastra-ai/mastra/commit/1ed5716830867b3774c4a1b43cc0d82935f32b96), [`4186bdd`](https://github.com/mastra-ai/mastra/commit/4186bdd00731305726fa06adba0b076a1d50b49f), [`7aaf973`](https://github.com/mastra-ai/mastra/commit/7aaf973f83fbbe9521f1f9e7a4fd99b8de464617)]:
2141
+ - @mastra/core@1.0.0-beta.22
2142
+
2143
+ ## 1.0.0-beta.11
2144
+
2145
+ ### Patch Changes
2146
+
2147
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
2148
+
2149
+ Mastra packages now include embedded documentation in the published npm package under `dist/docs/`. This enables coding agents and AI assistants to understand and use the framework by reading documentation directly from `node_modules`.
2150
+
2151
+ Each package includes:
2152
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
2153
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
2154
+ - **Topic folders** - Conceptual documentation organized by feature area
2155
+
2156
+ Documentation is driven by the `packages` frontmatter field in MDX files, which maps docs to their corresponding packages. CI validation ensures all docs include this field.
2157
+
2158
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
2159
+
2160
+ **What changed:** The `filter.dateRange` parameter in `listMessages()` and `Memory.recall()` now supports `startExclusive` and `endExclusive` boolean options. When set to `true`, messages with timestamps exactly matching the boundary are excluded from results.
2161
+
2162
+ **Why this matters:** Enables cursor-based pagination for chat applications. When new messages arrive during a session, offset-based pagination can skip or duplicate messages. Using `endExclusive: true` with the oldest message's timestamp as a cursor ensures consistent pagination without gaps or duplicates.
2163
+
2164
+ **Example:**
2165
+
2166
+ ```typescript
2167
+ // Get first page
2168
+ const page1 = await memory.recall({
2169
+ threadId: 'thread-123',
2170
+ perPage: 10,
2171
+ orderBy: { field: 'createdAt', direction: 'DESC' },
2172
+ });
2173
+
2174
+ // Get next page using cursor-based pagination
2175
+ const oldestMessage = page1.messages[page1.messages.length - 1];
2176
+ const page2 = await memory.recall({
2177
+ threadId: 'thread-123',
2178
+ perPage: 10,
2179
+ orderBy: { field: 'createdAt', direction: 'DESC' },
2180
+ filter: {
2181
+ dateRange: {
2182
+ end: oldestMessage.createdAt,
2183
+ endExclusive: true, // Excludes the cursor message
2184
+ },
2185
+ },
2186
+ });
2187
+ ```
2188
+
2189
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
2190
+
2191
+ ```typescript
2192
+ // Clone a thread
2193
+ const { thread, clonedMessages } = await memory.cloneThread({
2194
+ sourceThreadId: 'thread-123',
2195
+ title: 'My Clone',
2196
+ options: {
2197
+ messageLimit: 10, // optional: only copy last N messages
2198
+ },
2199
+ });
2200
+
2201
+ // Check if a thread is a clone
2202
+ if (memory.isClone(thread)) {
2203
+ const source = await memory.getSourceThread(thread.id);
2204
+ }
2205
+
2206
+ // List all clones of a thread
2207
+ const clones = await memory.listClones('thread-123');
2208
+ ```
2209
+
2210
+ Includes:
2211
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
2212
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
2213
+ - Embeddings created for cloned messages (semantic recall)
2214
+ - Clone button in playground UI Memory tab
2215
+
2216
+ - Updated dependencies [[`d2d3e22`](https://github.com/mastra-ai/mastra/commit/d2d3e22a419ee243f8812a84e3453dd44365ecb0), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`05b8bee`](https://github.com/mastra-ai/mastra/commit/05b8bee9e50e6c2a4a2bf210eca25ee212ca24fa), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`940a2b2`](https://github.com/mastra-ai/mastra/commit/940a2b27480626ed7e74f55806dcd2181c1dd0c2), [`e0941c3`](https://github.com/mastra-ai/mastra/commit/e0941c3d7fc75695d5d258e7008fd5d6e650800c), [`0c0580a`](https://github.com/mastra-ai/mastra/commit/0c0580a42f697cd2a7d5973f25bfe7da9055038a), [`28f5f89`](https://github.com/mastra-ai/mastra/commit/28f5f89705f2409921e3c45178796c0e0d0bbb64), [`e601b27`](https://github.com/mastra-ai/mastra/commit/e601b272c70f3a5ecca610373aa6223012704892), [`3d3366f`](https://github.com/mastra-ai/mastra/commit/3d3366f31683e7137d126a3a57174a222c5801fb), [`5a4953f`](https://github.com/mastra-ai/mastra/commit/5a4953f7d25bb15ca31ed16038092a39cb3f98b3), [`eb9e522`](https://github.com/mastra-ai/mastra/commit/eb9e522ce3070a405e5b949b7bf5609ca51d7fe2), [`20e6f19`](https://github.com/mastra-ai/mastra/commit/20e6f1971d51d3ff6dd7accad8aaaae826d540ed), [`4f0b3c6`](https://github.com/mastra-ai/mastra/commit/4f0b3c66f196c06448487f680ccbb614d281e2f7), [`74c4f22`](https://github.com/mastra-ai/mastra/commit/74c4f22ed4c71e72598eacc346ba95cdbc00294f), [`81b6a8f`](https://github.com/mastra-ai/mastra/commit/81b6a8ff79f49a7549d15d66624ac1a0b8f5f971), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`a4f010b`](https://github.com/mastra-ai/mastra/commit/a4f010b22e4355a5fdee70a1fe0f6e4a692cc29e), [`73b0bb3`](https://github.com/mastra-ai/mastra/commit/73b0bb394dba7c9482eb467a97ab283dbc0ef4db), [`5627a8c`](https://github.com/mastra-ai/mastra/commit/5627a8c6dc11fe3711b3fa7a6ffd6eb34100a306), [`3ff45d1`](https://github.com/mastra-ai/mastra/commit/3ff45d10e0c80c5335a957ab563da72feb623520), [`251df45`](https://github.com/mastra-ai/mastra/commit/251df4531407dfa46d805feb40ff3fb49769f455), [`f894d14`](https://github.com/mastra-ai/mastra/commit/f894d148946629af7b1f452d65a9cf864cec3765), [`c2b9547`](https://github.com/mastra-ai/mastra/commit/c2b9547bf435f56339f23625a743b2147ab1c7a6), [`580b592`](https://github.com/mastra-ai/mastra/commit/580b5927afc82fe460dfdf9a38a902511b6b7e7f), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`4fba91b`](https://github.com/mastra-ai/mastra/commit/4fba91bec7c95911dc28e369437596b152b04cd0), [`12b0cc4`](https://github.com/mastra-ai/mastra/commit/12b0cc4077d886b1a552637dedb70a7ade93528c)]:
2217
+ - @mastra/core@1.0.0-beta.20
2218
+
2219
+ ## 1.0.0-beta.10
2220
+
2221
+ ### Patch Changes
2222
+
2223
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
2224
+
2225
+ `MastraStorage` can now compose storage domains from different adapters. Use it when you need different databases for different purposes - for example, PostgreSQL for memory and workflows, but a different database for observability.
2226
+
2227
+ ```typescript
2228
+ import { MastraStorage } from '@mastra/core/storage';
2229
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
2230
+ import { MemoryLibSQL } from '@mastra/libsql';
2231
+
2232
+ // Compose domains from different stores
2233
+ const storage = new MastraStorage({
2234
+ id: 'composite',
2235
+ domains: {
2236
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
2237
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
2238
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
2239
+ },
2240
+ });
2241
+ ```
2242
+
2243
+ **Breaking changes:**
2244
+ - `storage.supports` property no longer exists
2245
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
2246
+
2247
+ All stores now support the same features. For domain availability, use `getStore()`:
2248
+
2249
+ ```typescript
2250
+ const store = await storage.getStore('memory');
2251
+ if (store) {
2252
+ // domain is available
2253
+ }
2254
+ ```
2255
+
2256
+ - Updated dependencies [[`3d93a15`](https://github.com/mastra-ai/mastra/commit/3d93a15796b158c617461c8b98bede476ebb43e2), [`efe406a`](https://github.com/mastra-ai/mastra/commit/efe406a1353c24993280ebc2ed61dd9f65b84b26), [`119e5c6`](https://github.com/mastra-ai/mastra/commit/119e5c65008f3e5cfca954eefc2eb85e3bf40da4), [`74e504a`](https://github.com/mastra-ai/mastra/commit/74e504a3b584eafd2f198001c6a113bbec589fd3), [`e33fdbd`](https://github.com/mastra-ai/mastra/commit/e33fdbd07b33920d81e823122331b0c0bee0bb59), [`929f69c`](https://github.com/mastra-ai/mastra/commit/929f69c3436fa20dd0f0e2f7ebe8270bd82a1529), [`8a73529`](https://github.com/mastra-ai/mastra/commit/8a73529ca01187f604b1f3019d0a725ac63ae55f)]:
2257
+ - @mastra/core@1.0.0-beta.16
2258
+
2259
+ ## 1.0.0-beta.9
2260
+
2261
+ ### Minor Changes
2262
+
2263
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
2264
+
2265
+ Storage adapters now use a domain-based architecture where each domain (memory, workflows, scores, observability, agents) extends a `StorageDomain` base class with `init()` and `dangerouslyClearAll()` methods.
2266
+
2267
+ **Key changes:**
2268
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
2269
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
2270
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
2271
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
2272
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
2273
+
2274
+ **Why this matters:**
2275
+
2276
+ This enables composite storage where you can use different database adapters per domain:
2277
+
2278
+ ```typescript
2279
+ import { Mastra } from '@mastra/core';
2280
+ import { PostgresStore } from '@mastra/pg';
2281
+ import { ClickhouseStore } from '@mastra/clickhouse';
2282
+
2283
+ // Use Postgres for most domains but Clickhouse for observability
2284
+ const mastra = new Mastra({
2285
+ storage: new PostgresStore({
2286
+ connectionString: 'postgres://...',
2287
+ }),
2288
+ // Future: override specific domains
2289
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
2290
+ });
2291
+ ```
2292
+
2293
+ **Standalone domain usage:**
2294
+
2295
+ Domains can now be used independently with flexible configuration:
2296
+
2297
+ ```typescript
2298
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
2299
+
2300
+ // Option 1: Pass config to create client internally
2301
+ const memory = new MemoryLibSQL({
2302
+ url: 'file:./local.db',
2303
+ });
2304
+
2305
+ // Option 2: Pass existing client for shared connections
2306
+ import { createClient } from '@libsql/client';
2307
+ const client = createClient({ url: 'file:./local.db' });
2308
+ const memory = new MemoryLibSQL({ client });
2309
+ ```
2310
+
2311
+ **Breaking changes:**
2312
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
2313
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
2314
+
2315
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
2316
+
2317
+ ### Summary
2318
+
2319
+ This release introduces a new storage architecture that replaces passthrough methods on `MastraStorage` with domain-specific storage interfaces accessed via `getStore()`. This change reduces code duplication across storage adapters and provides a cleaner, more modular API.
2320
+
2321
+ ### Migration Guide
2322
+
2323
+ All direct method calls on storage instances should be updated to use `getStore()`:
2324
+
2325
+ ```typescript
2326
+ // Before
2327
+ const thread = await storage.getThreadById({ threadId });
2328
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
2329
+ await storage.createSpan(span);
2330
+
2331
+ // After
2332
+ const memory = await storage.getStore('memory');
2333
+ const thread = await memory?.getThreadById({ threadId });
2334
+
2335
+ const workflows = await storage.getStore('workflows');
2336
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
2337
+
2338
+ const observability = await storage.getStore('observability');
2339
+ await observability?.createSpan(span);
2340
+ ```
2341
+
2342
+ ### Available Domains
2343
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
2344
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
2345
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
2346
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
2347
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
2348
+
2349
+ ### Breaking Changes
2350
+ - Passthrough methods have been removed from `MastraStorage` base class
2351
+ - All storage adapters now require accessing domains via `getStore()`
2352
+ - The `stores` property on storage instances is now the canonical way to access domain storage
2353
+
2354
+ ### Internal Changes
2355
+ - Each storage adapter now initializes domain-specific stores in its constructor
2356
+ - Domain stores share database connections and handle their own table initialization
2357
+
2358
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
2359
+
2360
+ ## What changed
2361
+
2362
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
2363
+
2364
+ **Before:**
2365
+
2366
+ ```typescript
2367
+ // Old span structure
2368
+ span.agentId; // 'my-agent'
2369
+ span.toolId; // undefined
2370
+ span.workflowId; // undefined
2371
+ ```
2372
+
2373
+ **After:**
2374
+
2375
+ ```typescript
2376
+ // New span structure
2377
+ span.entityType; // EntityType.AGENT
2378
+ span.entityId; // 'my-agent'
2379
+ span.entityName; // 'My Agent'
2380
+ ```
2381
+
2382
+ ## New `listTraces()` API
2383
+
2384
+ Query traces with filtering, pagination, and sorting:
2385
+
2386
+ ```typescript
2387
+ const { spans, pagination } = await storage.listTraces({
2388
+ filters: {
2389
+ entityType: EntityType.AGENT,
2390
+ entityId: 'my-agent',
2391
+ userId: 'user-123',
2392
+ environment: 'production',
2393
+ status: TraceStatus.SUCCESS,
2394
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
2395
+ },
2396
+ pagination: { page: 0, perPage: 50 },
2397
+ orderBy: { field: 'startedAt', direction: 'DESC' },
2398
+ });
2399
+ ```
2400
+
2401
+ **Available filters:** date ranges (`startedAt`, `endedAt`), entity (`entityType`, `entityId`, `entityName`), identity (`userId`, `organizationId`), correlation IDs (`runId`, `sessionId`, `threadId`), deployment (`environment`, `source`, `serviceName`), `tags`, `metadata`, and `status`.
2402
+
2403
+ ## New retrieval methods
2404
+ - `getSpan({ traceId, spanId })` - Get a single span
2405
+ - `getRootSpan({ traceId })` - Get the root span of a trace
2406
+ - `getTrace({ traceId })` - Get all spans for a trace
2407
+
2408
+ ## Backward compatibility
2409
+
2410
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
2411
+
2412
+ ## Migration
2413
+
2414
+ **Automatic:** SQL-based stores (PostgreSQL, LibSQL, MSSQL) automatically add new columns to existing `spans` tables on initialization. Existing data is preserved with new columns set to `NULL`.
2415
+
2416
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
2417
+
2418
+ ### Patch Changes
2419
+
2420
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
2421
+
2422
+ **What changed**
2423
+
2424
+ All storage adapters now accept pre-configured database clients in addition to connection credentials. This allows you to customize client settings (connection pools, timeouts, interceptors) before passing them to Mastra.
2425
+
2426
+ **Example**
2427
+
2428
+ ```typescript
2429
+ import { createClient } from '@clickhouse/client';
2430
+ import { ClickhouseStore } from '@mastra/clickhouse';
2431
+
2432
+ // Create and configure client with custom settings
2433
+ const client = createClient({
2434
+ url: 'http://localhost:8123',
2435
+ username: 'default',
2436
+ password: '',
2437
+ request_timeout: 60000,
2438
+ });
2439
+
2440
+ // Pass pre-configured client to store
2441
+ const store = new ClickhouseStore({
2442
+ id: 'my-store',
2443
+ client,
2444
+ });
2445
+ ```
2446
+
2447
+ **Additional improvements**
2448
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
2449
+
2450
+ - Updated dependencies [[`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
2451
+ - @mastra/core@1.0.0-beta.15
2452
+
2453
+ ## 1.0.0-beta.8
2454
+
2455
+ ### Patch Changes
2456
+
2457
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
2458
+
2459
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
2460
+
2461
+ **Before:**
2462
+
2463
+ ```typescript
2464
+ const result = await workflow.execute({ input });
2465
+ if (result.status === 'failed') {
2466
+ // Custom error properties were lost
2467
+ console.log(result.error); // "Step execution failed" (just a string)
2468
+ }
2469
+ ```
2470
+
2471
+ **After:**
2472
+
2473
+ ```typescript
2474
+ const result = await workflow.execute({ input });
2475
+ if (result.status === 'failed') {
2476
+ // Custom properties are preserved
2477
+ console.log(result.error.message); // "Step execution failed"
2478
+ console.log(result.error.statusCode); // 429
2479
+ console.log(result.error.cause?.name); // "RateLimitError"
2480
+ }
2481
+ ```
2482
+
2483
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
2484
+
2485
+ Other changes:
2486
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
2487
+
2488
+ - fix: make getSqlType consistent across storage adapters ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
2489
+ - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()`
2490
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
2491
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
2492
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
2493
+
2494
+ - Updated dependencies [[`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176)]:
2495
+ - @mastra/core@1.0.0-beta.12
2496
+
2497
+ ## 1.0.0-beta.7
2498
+
2499
+ ### Patch Changes
2500
+
2501
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
2502
+
2503
+ ```typescript
2504
+ await workflow.deleteWorkflowRunById(runId);
2505
+ ```
2506
+
2507
+ - Updated dependencies [[`edb07e4`](https://github.com/mastra-ai/mastra/commit/edb07e49283e0c28bd094a60e03439bf6ecf0221), [`b7e17d3`](https://github.com/mastra-ai/mastra/commit/b7e17d3f5390bb5a71efc112204413656fcdc18d), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`5d7000f`](https://github.com/mastra-ai/mastra/commit/5d7000f757cd65ea9dc5b05e662fd83dfd44e932), [`4f0331a`](https://github.com/mastra-ai/mastra/commit/4f0331a79bf6eb5ee598a5086e55de4b5a0ada03), [`8a000da`](https://github.com/mastra-ai/mastra/commit/8a000da0c09c679a2312f6b3aa05b2ca78ca7393)]:
2508
+ - @mastra/core@1.0.0-beta.10
2509
+
2510
+ ## 1.0.0-beta.6
2511
+
2512
+ ### Minor Changes
2513
+
2514
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
2515
+
2516
+ Agents can now be stored in the database and loaded at runtime. This lets you persist agent configurations and dynamically create executable Agent instances from storage.
2517
+
2518
+ ```typescript
2519
+ import { Mastra } from '@mastra/core';
2520
+ import { LibSQLStore } from '@mastra/libsql';
2521
+
2522
+ const mastra = new Mastra({
2523
+ storage: new LibSQLStore({ url: ':memory:' }),
2524
+ tools: { myTool },
2525
+ scorers: { myScorer },
2526
+ });
2527
+
2528
+ // Create agent in storage via API or directly
2529
+ await mastra.getStorage().createAgent({
2530
+ agent: {
2531
+ id: 'my-agent',
2532
+ name: 'My Agent',
2533
+ instructions: 'You are helpful',
2534
+ model: { provider: 'openai', name: 'gpt-4' },
2535
+ tools: { myTool: {} },
2536
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
2537
+ },
2538
+ });
2539
+
2540
+ // Load and use the agent
2541
+ const agent = await mastra.getStoredAgentById('my-agent');
2542
+ const response = await agent.generate({ messages: 'Hello!' });
2543
+
2544
+ // List all stored agents with pagination
2545
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
2546
+ page: 0,
2547
+ perPage: 10,
2548
+ });
2549
+ ```
2550
+
2551
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
2552
+
2553
+ ### Patch Changes
2554
+
2555
+ - Updated dependencies [[`72df8ae`](https://github.com/mastra-ai/mastra/commit/72df8ae595584cdd7747d5c39ffaca45e4507227), [`9198899`](https://github.com/mastra-ai/mastra/commit/91988995c427b185c33714b7f3be955367911324), [`653e65a`](https://github.com/mastra-ai/mastra/commit/653e65ae1f9502c2958a32f47a5a2df11e612a92), [`c6fd6fe`](https://github.com/mastra-ai/mastra/commit/c6fd6fedd09e9cf8004b03a80925f5e94826ad7e), [`0bed332`](https://github.com/mastra-ai/mastra/commit/0bed332843f627202c6520eaf671771313cd20f3)]:
2556
+ - @mastra/core@1.0.0-beta.9
2557
+
2558
+ ## 1.0.0-beta.5
2559
+
2560
+ ### Patch Changes
2561
+
2562
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
2563
+
2564
+ **What Changed**
2565
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
2566
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
2567
+
2568
+ **Impact**
2569
+ Previously, calling getScoreById after saveScore would return null because the generated ID wasn't persisted to the database. This is now fixed across all store implementations, ensuring consistent behavior and data integrity.
2570
+
2571
+ - Updated dependencies [[`0d41fe2`](https://github.com/mastra-ai/mastra/commit/0d41fe245355dfc66d61a0d9c85d9400aac351ff), [`6b3ba91`](https://github.com/mastra-ai/mastra/commit/6b3ba91494cc10394df96782f349a4f7b1e152cc), [`7907fd1`](https://github.com/mastra-ai/mastra/commit/7907fd1c5059813b7b870b81ca71041dc807331b)]:
2572
+ - @mastra/core@1.0.0-beta.8
2573
+
2574
+ ## 1.0.0-beta.4
2575
+
2576
+ ### Minor Changes
2577
+
2578
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
2579
+
2580
+ Adds a new `disableInit` config option to all storage providers that allows users to disable automatic table creation/migrations at runtime. This is useful for CI/CD pipelines where you want to run migrations during deployment with elevated credentials, then run the application with `disableInit: true` so it doesn't attempt schema changes at runtime.
2581
+
2582
+ ```typescript
2583
+ // CI/CD script - run migrations
2584
+ const storage = new PostgresStore({
2585
+ connectionString: DATABASE_URL,
2586
+ id: 'pg-storage',
2587
+ });
2588
+ await storage.init();
2589
+
2590
+ // Runtime - skip auto-init
2591
+ const storage = new PostgresStore({
2592
+ connectionString: DATABASE_URL,
2593
+ id: 'pg-storage',
2594
+ disableInit: true,
2595
+ });
2596
+ ```
2597
+
2598
+ ### Patch Changes
2599
+
2600
+ - Standardize error IDs across all storage and vector stores using centralized helper functions (`createStorageErrorId` and `createVectorErrorId`). This ensures consistent error ID patterns (`MASTRA_STORAGE_{STORE}_{OPERATION}_{STATUS}` and `MASTRA_VECTOR_{STORE}_{OPERATION}_{STATUS}`) across the codebase for better error tracking and debugging. ([#10913](https://github.com/mastra-ai/mastra/pull/10913))
2601
+
2602
+ - Updated dependencies [[`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
2603
+ - @mastra/core@1.0.0-beta.7
2604
+
2605
+ ## 1.0.0-beta.3
2606
+
2607
+ ### Patch Changes
2608
+
2609
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
2610
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
2611
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
2612
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
2613
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
2614
+
2615
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
2616
+
2617
+ Added a unified `transformScoreRow` function in `@mastra/core/storage` that provides schema-driven row transformation for score data. This eliminates code duplication across 10 storage adapters while maintaining store-specific behavior through configurable options:
2618
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
2619
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
2620
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
2621
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
2622
+
2623
+ Each store adapter now uses the unified function with appropriate options, reducing ~200 lines of duplicate transformation logic while ensuring consistent behavior across all storage backends.
2624
+
2625
+ - Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
2626
+ - @mastra/core@1.0.0-beta.6
2627
+
2628
+ ## 1.0.0-beta.2
2629
+
2630
+ ### Patch Changes
2631
+
2632
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
2633
+
2634
+ - Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
2635
+ - @mastra/core@1.0.0-beta.5
2636
+
2637
+ ## 1.0.0-beta.1
2638
+
2639
+ ### Patch Changes
2640
+
2641
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
2642
+ Add status filter to `listWorkflowRuns`
2643
+ Add automatic restart to restart active workflow runs when server starts
2644
+ - Updated dependencies [[`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4)]:
2645
+ - @mastra/core@1.0.0-beta.3
2646
+
2647
+ ## 1.0.0-beta.0
2648
+
2649
+ ### Major Changes
2650
+
2651
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
2652
+
2653
+ - Every Mastra primitive (agent, MCPServer, workflow, tool, processor, scorer, and vector) now has a get, list, and add method associated with it. Each primitive also now requires an id to be set. ([#9675](https://github.com/mastra-ai/mastra/pull/9675))
2654
+
2655
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
2656
+
2657
+ - Update handlers to use `listWorkflowRuns` instead of `getWorkflowRuns`. Fix type names from `StoragelistThreadsByResourceIdInput/Output` to `StorageListThreadsByResourceIdInput/Output`. ([#9507](https://github.com/mastra-ai/mastra/pull/9507))
2658
+
2659
+ - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
2660
+
2661
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
2662
+
2663
+ **Storage changes:**
2664
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
2665
+ - All storage implementations support `perPage: false`:
2666
+ - Memory: `listMessages()`
2667
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
2668
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
2669
+
2670
+ **Memory changes:**
2671
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
2672
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
2673
+
2674
+ **Stricter validation:**
2675
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
2676
+
2677
+ **Migration:**
2678
+
2679
+ ```typescript
2680
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
2681
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
2682
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
2683
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
2684
+
2685
+ // Memory: Replace selectBy with flat parameters
2686
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
2687
+ + memory.query({ threadId, perPage: 20, include: [...] })
2688
+
2689
+ // Client SDK
2690
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
2691
+ + thread.listMessages({ page: 0, perPage: 20 })
2692
+ ```
2693
+
2694
+ - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
2695
+
2696
+ ## Storage Layer
2697
+
2698
+ ### BREAKING: Removed `storage.getMessages()`
2699
+
2700
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
2701
+
2702
+ **Migration:**
2703
+
2704
+ ```typescript
2705
+ // Before
2706
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
2707
+
2708
+ // After
2709
+ const result = await storage.listMessages({
2710
+ threadId: 'thread-1',
2711
+ page: 0,
2712
+ perPage: 50,
2713
+ });
2714
+ const messages = result.messages; // Access messages array
2715
+ console.log(result.total); // Total count
2716
+ console.log(result.hasMore); // Whether more pages exist
2717
+ ```
2718
+
2719
+ ### Message ordering default
2720
+
2721
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
2722
+
2723
+ **To use DESC ordering (newest first):**
2724
+
2725
+ ```typescript
2726
+ const result = await storage.listMessages({
2727
+ threadId: 'thread-1',
2728
+ orderBy: { field: 'createdAt', direction: 'DESC' },
2729
+ });
2730
+ ```
2731
+
2732
+ ## Client SDK
2733
+
2734
+ ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
2735
+
2736
+ **Migration:**
2737
+
2738
+ ```typescript
2739
+ // Before
2740
+ const response = await client.getThreadMessages(threadId, { agentId });
2741
+
2742
+ // After
2743
+ const response = await client.listThreadMessages(threadId, { agentId });
2744
+ ```
2745
+
2746
+ The response format remains the same.
2747
+
2748
+ ## Type Changes
2749
+
2750
+ ### BREAKING: Removed `StorageGetMessagesArg` type
2751
+
2752
+ Use `StorageListMessagesInput` instead:
2753
+
2754
+ ```typescript
2755
+ // Before
2756
+ import type { StorageGetMessagesArg } from '@mastra/core';
2757
+
2758
+ // After
2759
+ import type { StorageListMessagesInput } from '@mastra/core';
2760
+ ```
2761
+
2762
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
2763
+
2764
+ - Add new list methods to storage API: `listMessages`, `listMessagesById`, `listThreadsByResourceId`, and `listWorkflowRuns`. Most methods are currently wrappers around existing methods. Full implementations will be added when migrating away from legacy methods. ([#9489](https://github.com/mastra-ai/mastra/pull/9489))
2765
+
2766
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
2767
+
2768
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
2769
+
2770
+ - Remove `getThreadsByResourceId` and `getThreadsByResourceIdPaginated` methods from storage interfaces in favor of `listThreadsByResourceId`. The new method uses `offset`/`limit` pagination and a nested `orderBy` object structure (`{ field, direction }`). ([#9536](https://github.com/mastra-ai/mastra/pull/9536))
2771
+
2772
+ - Remove `getMessagesById` method from storage interfaces in favor of `listMessagesById`. The new method only returns V2-format messages and removes the format parameter, simplifying the API surface. Users should migrate from `getMessagesById({ messageIds, format })` to `listMessagesById({ messageIds })`. ([#9534](https://github.com/mastra-ai/mastra/pull/9534))
2773
+
2774
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
2775
+
2776
+ - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
2777
+
2778
+ All storage and memory pagination APIs have been updated to use `page` (0-indexed) and `perPage` instead of `offset` and `limit`, aligning with standard REST API patterns.
2779
+
2780
+ **Affected APIs:**
2781
+ - `Memory.listThreadsByResourceId()`
2782
+ - `Memory.listMessages()`
2783
+ - `Storage.listWorkflowRuns()`
2784
+
2785
+ **Migration:**
2786
+
2787
+ ```typescript
2788
+ // Before
2789
+ await memory.listThreadsByResourceId({
2790
+ resourceId: 'user-123',
2791
+ offset: 20,
2792
+ limit: 10,
2793
+ });
2794
+
2795
+ // After
2796
+ await memory.listThreadsByResourceId({
2797
+ resourceId: 'user-123',
2798
+ page: 2, // page = Math.floor(offset / limit)
2799
+ perPage: 10,
2800
+ });
2801
+
2802
+ // Before
2803
+ await memory.listMessages({
2804
+ threadId: 'thread-456',
2805
+ offset: 20,
2806
+ limit: 10,
2807
+ });
2808
+
2809
+ // After
2810
+ await memory.listMessages({
2811
+ threadId: 'thread-456',
2812
+ page: 2,
2813
+ perPage: 10,
2814
+ });
2815
+
2816
+ // Before
2817
+ await storage.listWorkflowRuns({
2818
+ workflowName: 'my-workflow',
2819
+ offset: 20,
2820
+ limit: 10,
2821
+ });
2822
+
2823
+ // After
2824
+ await storage.listWorkflowRuns({
2825
+ workflowName: 'my-workflow',
2826
+ page: 2,
2827
+ perPage: 10,
2828
+ });
2829
+ ```
2830
+
2831
+ **Additional improvements:**
2832
+ - Added validation for negative `page` values in all storage implementations
2833
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
2834
+ - Added reusable query parser utilities for consistent validation in handlers
2835
+
2836
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
2837
+ import { Mastra } from '@mastra/core';
2838
+ import { Observability } from '@mastra/observability'; // Explicit import
2839
+
2840
+ const mastra = new Mastra({
2841
+ ...other_config,
2842
+ observability: new Observability({
2843
+ default: { enabled: true }
2844
+ }) // Instance
2845
+ });
2846
+ ```
2847
+
2848
+ Instead of:
2849
+
2850
+ ```
2851
+ import { Mastra } from '@mastra/core';
2852
+ import '@mastra/observability/init'; // Explicit import
2853
+
2854
+ const mastra = new Mastra({
2855
+ ...other_config,
2856
+ observability: {
2857
+ default: { enabled: true }
2858
+ }
2859
+ });
2860
+ ```
2861
+
2862
+ Also renamed a bunch of:
2863
+ - `Tracing` things to `Observability` things.
2864
+ - `AI-` things to just things.
2865
+
2866
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
2867
+
2868
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
2869
+
2870
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
2871
+ Made the return format of all methods that return db messages consistent. It's always `{ messages: MastraDBMessage[] }` now, and messages can be converted after that using `@mastra/ai-sdk/ui`'s `toAISdkV4/5Messages()` function
2872
+
2873
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
2874
+
2875
+ ### Minor Changes
2876
+
2877
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
2878
+
2879
+ ### Patch Changes
2880
+
2881
+ - Updated dependencies [[`39c9743`](https://github.com/mastra-ai/mastra/commit/39c97432d084294f8ba85fbf3ef28098ff21459e), [`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`0491e7c`](https://github.com/mastra-ai/mastra/commit/0491e7c9b714cb0ba22187ee062147ec2dd7c712), [`f6f4903`](https://github.com/mastra-ai/mastra/commit/f6f4903397314f73362061dc5a3e8e7c61ea34aa), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`2f897df`](https://github.com/mastra-ai/mastra/commit/2f897df208508f46f51b7625e5dd20c37f93e0e3), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`aaa40e7`](https://github.com/mastra-ai/mastra/commit/aaa40e788628b319baa8e889407d11ad626547fa), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`ca8041c`](https://github.com/mastra-ai/mastra/commit/ca8041cce0379fda22ed293a565bcb5b6ddca68a), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`903f67d`](https://github.com/mastra-ai/mastra/commit/903f67d184504a273893818c02b961f5423a79ad), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`398fde3`](https://github.com/mastra-ai/mastra/commit/398fde3f39e707cda79372cdae8f9870e3b57c8d), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`b2e45ec`](https://github.com/mastra-ai/mastra/commit/b2e45eca727a8db01a81ba93f1a5219c7183c839), [`d6d49f7`](https://github.com/mastra-ai/mastra/commit/d6d49f7b8714fa19a52ff9c7cf7fb7e73751901e), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`3f2faf2`](https://github.com/mastra-ai/mastra/commit/3f2faf2e2d685d6c053cc5af1bf9fedf267b2ce5), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`e59e0d3`](https://github.com/mastra-ai/mastra/commit/e59e0d32afb5fcf2c9f3c00c8f81f6c21d3a63fa), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
2882
+ - @mastra/core@1.0.0-beta.0
2883
+
2884
+ ## 0.16.0
2885
+
2886
+ ### Minor Changes
2887
+
2888
+ - Update peer dependencies to match core package version bump (0.21.2) ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2889
+
2890
+ ### Patch Changes
2891
+
2892
+ - Support for custom resume labels mapping to step to be resumed ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2893
+
2894
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
2895
+
2896
+ - Updated dependencies [[`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e)]:
2897
+ - @mastra/core@0.22.0
2898
+
2899
+ ## 0.16.0-alpha.1
2900
+
2901
+ ### Patch Changes
2902
+
2903
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
2904
+
2905
+ - Updated dependencies [[`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb)]:
2906
+ - @mastra/core@0.22.0-alpha.1
2907
+
2908
+ ## 0.16.0-alpha.0
2909
+
2910
+ ### Minor Changes
2911
+
2912
+ - Update peer dependencies to match core package version bump (0.21.2) ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2913
+
2914
+ ### Patch Changes
2915
+
2916
+ - Support for custom resume labels mapping to step to be resumed ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2917
+
2918
+ - Updated dependencies [[`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e)]:
2919
+ - @mastra/core@0.21.2-alpha.0
2920
+
2921
+ ## 0.15.2
2922
+
2923
+ ### Patch Changes
2924
+
2925
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8619](https://github.com/mastra-ai/mastra/pull/8619))
2926
+
2927
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
2928
+
2929
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
2930
+
2931
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
2932
+
2933
+ - Updated dependencies [[`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`f59fc1e`](https://github.com/mastra-ai/mastra/commit/f59fc1e406b8912e692f6bff6cfd4754cc8d165c), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`a1799bc`](https://github.com/mastra-ai/mastra/commit/a1799bcc1b5a1cdc188f2ac0165f17a1c4ac6f7b), [`6ff6094`](https://github.com/mastra-ai/mastra/commit/6ff60946f4ecfebdeef6e21d2b230c2204f2c9b8), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1908ca0`](https://github.com/mastra-ai/mastra/commit/1908ca0521f90e43779cc29ab590173ca560443c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb)]:
2934
+ - @mastra/core@0.21.0
2935
+
2936
+ ## 0.15.2-alpha.0
2937
+
2938
+ ### Patch Changes
2939
+
2940
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8619](https://github.com/mastra-ai/mastra/pull/8619))
2941
+
2942
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
2943
+
2944
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
2945
+
2946
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
2947
+
2948
+ - Updated dependencies [[`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb), [`59d036d`](https://github.com/mastra-ai/mastra/commit/59d036d4c2706b430b0e3f1f1e0ee853ce16ca04)]:
2949
+ - @mastra/core@0.21.0-alpha.0
2950
+
2951
+ ## 0.15.1
2952
+
2953
+ ### Patch Changes
2954
+
2955
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
2956
+
2957
+ - Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
2958
+ - @mastra/core@0.20.0
2959
+
2960
+ ## 0.15.1-alpha.0
2961
+
2962
+ ### Patch Changes
2963
+
2964
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
2965
+
2966
+ - Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
2967
+ - @mastra/core@0.20.0-alpha.0
2968
+
2969
+ ## 0.15.0
2970
+
2971
+ ### Minor Changes
2972
+
2973
+ - Added Postgres and updated libsql storage adapters for ai-traces ([#8027](https://github.com/mastra-ai/mastra/pull/8027))
2974
+
2975
+ ### Patch Changes
2976
+
2977
+ - Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2978
+
2979
+ - Fix incorrect title and import references in README.md ([#8288](https://github.com/mastra-ai/mastra/pull/8288))
2980
+
2981
+ Fixed the package title from '@mastra/pg' to '@mastra/libsql' and corrected the import statement in the Storage usage example.
2982
+
2983
+ - Libsql get scores by span ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2984
+
2985
+ - Updated dependencies [[`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67), [`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`b342a68`](https://github.com/mastra-ai/mastra/commit/b342a68e1399cf1ece9ba11bda112db89d21118c), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`303a9c0`](https://github.com/mastra-ai/mastra/commit/303a9c0d7dd58795915979f06a0512359e4532fb), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`370f8a6`](https://github.com/mastra-ai/mastra/commit/370f8a6480faec70fef18d72e5f7538f27004301), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`623ffaf`](https://github.com/mastra-ai/mastra/commit/623ffaf2d969e11e99a0224633cf7b5a0815c857), [`9fc1613`](https://github.com/mastra-ai/mastra/commit/9fc16136400186648880fd990119ac15f7c02ee4), [`61f62aa`](https://github.com/mastra-ai/mastra/commit/61f62aa31bc88fe4ddf8da6240dbcfbeb07358bd), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`3e292ba`](https://github.com/mastra-ai/mastra/commit/3e292ba00837886d5d68a34cbc0d9b703c991883), [`418c136`](https://github.com/mastra-ai/mastra/commit/418c1366843d88e491bca3f87763899ce855ca29), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`67b0f00`](https://github.com/mastra-ai/mastra/commit/67b0f005b520335c71fb85cbaa25df4ce8484a81), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`c84b7d0`](https://github.com/mastra-ai/mastra/commit/c84b7d093c4657772140cbfd2b15ef72f3315ed5), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
2986
+ - @mastra/core@0.19.0
2987
+
2988
+ ## 0.15.0-alpha.0
2989
+
2990
+ ### Minor Changes
2991
+
2992
+ - Added Postgres and updated libsql storage adapters for ai-traces ([#8027](https://github.com/mastra-ai/mastra/pull/8027))
2993
+
2994
+ ### Patch Changes
2995
+
2996
+ - Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2997
+
2998
+ - Fix incorrect title and import references in README.md ([#8288](https://github.com/mastra-ai/mastra/pull/8288))
2999
+
3000
+ Fixed the package title from '@mastra/pg' to '@mastra/libsql' and corrected the import statement in the Storage usage example.
3001
+
3002
+ - Libsql get scores by span ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
3003
+
3004
+ - Updated dependencies [[`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
3005
+ - @mastra/core@0.19.0-alpha.1
3006
+
3007
+ ## 0.14.3
3008
+
3009
+ ### Patch Changes
3010
+
3011
+ - Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
3012
+
3013
+ - Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`a61f23f`](https://github.com/mastra-ai/mastra/commit/a61f23fbbca4b88b763d94f1d784c47895ed72d7), [`4b339b8`](https://github.com/mastra-ai/mastra/commit/4b339b8141c20d6a6d80583c7e8c5c05d8c19492), [`d1dc606`](https://github.com/mastra-ai/mastra/commit/d1dc6067b0557a71190b68d56ee15b48c26d2411), [`c45298a`](https://github.com/mastra-ai/mastra/commit/c45298a0a0791db35cf79f1199d77004da0704cb), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55), [`d3bd4d4`](https://github.com/mastra-ai/mastra/commit/d3bd4d482a685bbb67bfa89be91c90dca3fa71ad), [`c591dfc`](https://github.com/mastra-ai/mastra/commit/c591dfc1e600fae1dedffe239357d250e146378f), [`1920c5c`](https://github.com/mastra-ai/mastra/commit/1920c5c6d666f687785c73021196aa551e579e0d), [`b6a3b65`](https://github.com/mastra-ai/mastra/commit/b6a3b65d830fa0ca7754ad6481661d1f2c878f21), [`af3abb6`](https://github.com/mastra-ai/mastra/commit/af3abb6f7c7585d856e22d27f4e7d2ece2186b9a)]:
3014
+ - @mastra/core@0.18.0
3015
+
3016
+ ## 0.14.3-alpha.0
3017
+
3018
+ ### Patch Changes
3019
+
3020
+ - Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
3021
+
3022
+ - Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
3023
+ - @mastra/core@0.18.0-alpha.2
3024
+
3025
+ ## 0.14.2
3026
+
3027
+ ### Patch Changes
3028
+
3029
+ - dependencies updates: ([#7742](https://github.com/mastra-ai/mastra/pull/7742))
3030
+ - Updated dependency [`@libsql/client@^0.15.15` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.15) (from `^0.15.14`, in `dependencies`)
3031
+
3032
+ - Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
3033
+
3034
+ - Add resource id to workflow run snapshots ([#7740](https://github.com/mastra-ai/mastra/pull/7740))
3035
+
3036
+ - Updated dependencies [[`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`6590763`](https://github.com/mastra-ai/mastra/commit/65907630ef4bf4127067cecd1cb21b56f55d5f1b), [`fb84c21`](https://github.com/mastra-ai/mastra/commit/fb84c21859d09bdc8f158bd5412bdc4b5835a61c), [`5802bf5`](https://github.com/mastra-ai/mastra/commit/5802bf57f6182e4b67c28d7d91abed349a8d14f3), [`5bda53a`](https://github.com/mastra-ai/mastra/commit/5bda53a9747bfa7d876d754fc92c83a06e503f62), [`c2eade3`](https://github.com/mastra-ai/mastra/commit/c2eade3508ef309662f065e5f340d7840295dd53), [`f26a8fd`](https://github.com/mastra-ai/mastra/commit/f26a8fd99fcb0497a5d86c28324430d7f6a5fb83), [`222965a`](https://github.com/mastra-ai/mastra/commit/222965a98ce8197b86673ec594244650b5960257), [`6047778`](https://github.com/mastra-ai/mastra/commit/6047778e501df460648f31decddf8e443f36e373), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`9d4fc09`](https://github.com/mastra-ai/mastra/commit/9d4fc09b2ad55caa7738c7ceb3a905e454f74cdd), [`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`0324ceb`](https://github.com/mastra-ai/mastra/commit/0324ceb8af9d16c12a531f90e575f6aab797ac81), [`d75ccf0`](https://github.com/mastra-ai/mastra/commit/d75ccf06dfd2582b916aa12624e3cd61b279edf1), [`0f9d227`](https://github.com/mastra-ai/mastra/commit/0f9d227890a98db33865abbea39daf407cd55ef7), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`de056a0`](https://github.com/mastra-ai/mastra/commit/de056a02cbb43f6aa0380ab2150ea404af9ec0dd), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`c93532a`](https://github.com/mastra-ai/mastra/commit/c93532a340b80e4dd946d4c138d9381de5f70399), [`6cb1fcb`](https://github.com/mastra-ai/mastra/commit/6cb1fcbc8d0378ffed0d17784c96e68f30cb0272), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`547c621`](https://github.com/mastra-ai/mastra/commit/547c62104af3f7a551b3754e9cbdf0a3fbba15e4), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251), [`0fed8f2`](https://github.com/mastra-ai/mastra/commit/0fed8f2aa84b167b3415ea6f8f70755775132c8d), [`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689), [`1a1fbe6`](https://github.com/mastra-ai/mastra/commit/1a1fbe66efb7d94abc373ed0dd9676adb8122454), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`87fd07f`](https://github.com/mastra-ai/mastra/commit/87fd07ff35387a38728967163460231b5d33ae3b), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`2685a78`](https://github.com/mastra-ai/mastra/commit/2685a78f224b8b04e20d4fab5ac1adb638190071), [`36f39c0`](https://github.com/mastra-ai/mastra/commit/36f39c00dc794952dc3c11aab91c2fa8bca74b11), [`239b5a4`](https://github.com/mastra-ai/mastra/commit/239b5a497aeae2e8b4d764f46217cfff2284788e), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
3037
+ - @mastra/core@0.17.0
3038
+
3039
+ ## 0.14.2-alpha.2
3040
+
3041
+ ### Patch Changes
3042
+
3043
+ - Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
3044
+
3045
+ - Updated dependencies [[`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
3046
+ - @mastra/core@0.17.0-alpha.3
3047
+
3048
+ ## 0.14.2-alpha.1
3049
+
3050
+ ### Patch Changes
3051
+
3052
+ - Add resource id to workflow run snapshots ([#7740](https://github.com/mastra-ai/mastra/pull/7740))
3053
+
3054
+ - Updated dependencies [[`547c621`](https://github.com/mastra-ai/mastra/commit/547c62104af3f7a551b3754e9cbdf0a3fbba15e4)]:
3055
+ - @mastra/core@0.16.4-alpha.1
3056
+
3057
+ ## 0.14.2-alpha.0
3058
+
3059
+ ### Patch Changes
3060
+
3061
+ - dependencies updates: ([#7742](https://github.com/mastra-ai/mastra/pull/7742))
3062
+ - Updated dependency [`@libsql/client@^0.15.15` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.15) (from `^0.15.14`, in `dependencies`)
3063
+ - Updated dependencies [[`5802bf5`](https://github.com/mastra-ai/mastra/commit/5802bf57f6182e4b67c28d7d91abed349a8d14f3), [`5bda53a`](https://github.com/mastra-ai/mastra/commit/5bda53a9747bfa7d876d754fc92c83a06e503f62), [`f26a8fd`](https://github.com/mastra-ai/mastra/commit/f26a8fd99fcb0497a5d86c28324430d7f6a5fb83), [`1a1fbe6`](https://github.com/mastra-ai/mastra/commit/1a1fbe66efb7d94abc373ed0dd9676adb8122454), [`36f39c0`](https://github.com/mastra-ai/mastra/commit/36f39c00dc794952dc3c11aab91c2fa8bca74b11)]:
3064
+ - @mastra/core@0.16.4-alpha.0
3065
+
3066
+ ## 0.14.1
3067
+
3068
+ ### Patch Changes
3069
+
3070
+ - Fix AI Trace bug for libsql ([#7695](https://github.com/mastra-ai/mastra/pull/7695))
3071
+
3072
+ - Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`2a6585f`](https://github.com/mastra-ai/mastra/commit/2a6585f7cb71f023f805d521d1c3c95fb9a3aa59), [`3d26e83`](https://github.com/mastra-ai/mastra/commit/3d26e8353a945719028f087cc6ac4b06f0ce27d2), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`56e55d1`](https://github.com/mastra-ai/mastra/commit/56e55d1e9eb63e7d9e41aa46e012aae471256812), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
3073
+ - @mastra/core@0.16.3
3074
+
3075
+ ## 0.14.1-alpha.0
3076
+
3077
+ ### Patch Changes
3078
+
3079
+ - Fix AI Trace bug for libsql ([#7695](https://github.com/mastra-ai/mastra/pull/7695))
3080
+
3081
+ - Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
3082
+ - @mastra/core@0.16.3-alpha.0
3083
+
3084
+ ## 0.14.0
3085
+
3086
+ ### Minor Changes
3087
+
3088
+ - 376913a: Update peerdeps of @mastra/core
3089
+
3090
+ ### Patch Changes
3091
+
3092
+ - 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
3093
+ - Updated dependencies [8fbf79e]
3094
+ - Updated dependencies [fd83526]
3095
+ - Updated dependencies [d0b90ab]
3096
+ - Updated dependencies [6f5eb7a]
3097
+ - Updated dependencies [a01cf14]
3098
+ - Updated dependencies [a9e50ee]
3099
+ - Updated dependencies [5397eb4]
3100
+ - Updated dependencies [c9f4e4a]
3101
+ - Updated dependencies [0acbc80]
3102
+ - @mastra/core@0.16.0
3103
+
3104
+ ## 0.14.0-alpha.1
3105
+
3106
+ ### Minor Changes
3107
+
3108
+ - 376913a: Update peerdeps of @mastra/core
3109
+
3110
+ ### Patch Changes
3111
+
3112
+ - Updated dependencies [8fbf79e]
3113
+ - @mastra/core@0.16.0-alpha.1
3114
+
3115
+ ## 0.13.9-alpha.0
3116
+
3117
+ ### Patch Changes
3118
+
3119
+ - 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
3120
+ - Updated dependencies [fd83526]
3121
+ - Updated dependencies [d0b90ab]
3122
+ - Updated dependencies [6f5eb7a]
3123
+ - Updated dependencies [a01cf14]
3124
+ - Updated dependencies [a9e50ee]
3125
+ - Updated dependencies [5397eb4]
3126
+ - Updated dependencies [c9f4e4a]
3127
+ - Updated dependencies [0acbc80]
3128
+ - @mastra/core@0.16.0-alpha.0
3129
+
3130
+ ## 0.13.8
3131
+
3132
+ ### Patch Changes
3133
+
3134
+ - 8429e4c: dependencies updates:
3135
+ - Updated dependency [`@libsql/client@^0.15.14` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.14) (from `^0.15.12`, in `dependencies`)
3136
+ - de3cbc6: Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
3137
+ - f0dfcac: updated core peerdep
3138
+ - dbc51ef: Fixed dependency issue with new AI_SPAN schema
3139
+ - Updated dependencies [ab48c97]
3140
+ - Updated dependencies [85ef90b]
3141
+ - Updated dependencies [aedbbfa]
3142
+ - Updated dependencies [ff89505]
3143
+ - Updated dependencies [637f323]
3144
+ - Updated dependencies [de3cbc6]
3145
+ - Updated dependencies [c19bcf7]
3146
+ - Updated dependencies [4474d04]
3147
+ - Updated dependencies [183dc95]
3148
+ - Updated dependencies [a1111e2]
3149
+ - Updated dependencies [b42a961]
3150
+ - Updated dependencies [61debef]
3151
+ - Updated dependencies [9beaeff]
3152
+ - Updated dependencies [29de0e1]
3153
+ - Updated dependencies [f643c65]
3154
+ - Updated dependencies [00c74e7]
3155
+ - Updated dependencies [fef7375]
3156
+ - Updated dependencies [e3d8fea]
3157
+ - Updated dependencies [45e4d39]
3158
+ - Updated dependencies [9eee594]
3159
+ - Updated dependencies [7149d8d]
3160
+ - Updated dependencies [822c2e8]
3161
+ - Updated dependencies [979912c]
3162
+ - Updated dependencies [7dcf4c0]
3163
+ - Updated dependencies [4106a58]
3164
+ - Updated dependencies [ad78bfc]
3165
+ - Updated dependencies [0302f50]
3166
+ - Updated dependencies [6ac697e]
3167
+ - Updated dependencies [74db265]
3168
+ - Updated dependencies [0ce418a]
3169
+ - Updated dependencies [af90672]
3170
+ - Updated dependencies [8387952]
3171
+ - Updated dependencies [7f3b8da]
3172
+ - Updated dependencies [905352b]
3173
+ - Updated dependencies [599d04c]
3174
+ - Updated dependencies [56041d0]
3175
+ - Updated dependencies [3412597]
3176
+ - Updated dependencies [5eca5d2]
3177
+ - Updated dependencies [f2cda47]
3178
+ - Updated dependencies [5de1555]
3179
+ - Updated dependencies [cfd377a]
3180
+ - Updated dependencies [1ed5a3e]
3181
+ - @mastra/core@0.15.3
3182
+
3183
+ ## 0.13.8-alpha.3
3184
+
3185
+ ### Patch Changes
3186
+
3187
+ - [#7394](https://github.com/mastra-ai/mastra/pull/7394) [`f0dfcac`](https://github.com/mastra-ai/mastra/commit/f0dfcac4458bdf789b975e2d63e984f5d1e7c4d3) Thanks [@NikAiyer](https://github.com/NikAiyer)! - updated core peerdep
3188
+
3189
+ - Updated dependencies [[`7149d8d`](https://github.com/mastra-ai/mastra/commit/7149d8d4bdc1edf0008e0ca9b7925eb0b8b60dbe)]:
3190
+ - @mastra/core@0.15.3-alpha.7
3191
+
3192
+ ## 0.13.8-alpha.2
3193
+
3194
+ ### Patch Changes
3195
+
3196
+ - [#7380](https://github.com/mastra-ai/mastra/pull/7380) [`8429e4c`](https://github.com/mastra-ai/mastra/commit/8429e4c0d2041d072826c4382c09187116573a77) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
3197
+ - Updated dependency [`@libsql/client@^0.15.14` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.14) (from `^0.15.12`, in `dependencies`)
3198
+ - Updated dependencies [[`c19bcf7`](https://github.com/mastra-ai/mastra/commit/c19bcf7b43542b02157b5e17303e519933a153ab), [`b42a961`](https://github.com/mastra-ai/mastra/commit/b42a961a5aefd19d6e938a7705fc0ecc90e8f756), [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e), [`0302f50`](https://github.com/mastra-ai/mastra/commit/0302f50861a53c66ff28801fc371b37c5f97e41e), [`74db265`](https://github.com/mastra-ai/mastra/commit/74db265b96aa01a72ffd91dcae0bc3b346cca0f2), [`7f3b8da`](https://github.com/mastra-ai/mastra/commit/7f3b8da6dd21c35d3672e44b4f5dd3502b8f8f92), [`905352b`](https://github.com/mastra-ai/mastra/commit/905352bcda134552400eb252bca1cb05a7975c14), [`f2cda47`](https://github.com/mastra-ai/mastra/commit/f2cda47ae911038c5d5489f54c36517d6f15bdcc), [`cfd377a`](https://github.com/mastra-ai/mastra/commit/cfd377a3a33a9c88b644f6540feed9cd9832db47)]:
3199
+ - @mastra/core@0.15.3-alpha.6
3200
+
3201
+ ## 0.13.8-alpha.1
3202
+
3203
+ ### Patch Changes
3204
+
3205
+ - [#7343](https://github.com/mastra-ai/mastra/pull/7343) [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e) Thanks [@LekoArts](https://github.com/LekoArts)! - Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
3206
+
3207
+ - Updated dependencies [[`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
3208
+ - @mastra/core@0.15.3-alpha.5
3209
+
3210
+ ## 0.13.8-alpha.0
3211
+
3212
+ ### Patch Changes
3213
+
3214
+ - [#7200](https://github.com/mastra-ai/mastra/pull/7200) [`dbc51ef`](https://github.com/mastra-ai/mastra/commit/dbc51ef2e42604117ab90917fc284a560647a61f) Thanks [@epinzur](https://github.com/epinzur)! - Fixed dependency issue with new AI_SPAN schema
3215
+
3216
+ - Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
3217
+ - @mastra/core@0.15.3-alpha.3
3218
+
3219
+ ## 0.13.7
3220
+
3221
+ ### Patch Changes
3222
+
3223
+ - [`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdpes for @mastra/core
3224
+
3225
+ - Updated dependencies []:
3226
+ - @mastra/core@0.15.2
3227
+
3228
+ ## 0.13.6
3229
+
3230
+ ### Patch Changes
3231
+
3232
+ - [`95b2aa9`](https://github.com/mastra-ai/mastra/commit/95b2aa908230919e67efcac0d69005a2d5745298) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdeps @mastra/core
3233
+
3234
+ - Updated dependencies []:
3235
+ - @mastra/core@0.15.1
3236
+
3237
+ ## 0.13.5
3238
+
3239
+ ### Patch Changes
3240
+
3241
+ - [#6994](https://github.com/mastra-ai/mastra/pull/6994) [`0594a70`](https://github.com/mastra-ai/mastra/commit/0594a70ac948d306c7f38765b171c9535e6c78d4) Thanks [@wardpeet](https://github.com/wardpeet)! - Improve type resolving for storage adapters
3242
+
3243
+ - [#6959](https://github.com/mastra-ai/mastra/pull/6959) [`704173b`](https://github.com/mastra-ai/mastra/commit/704173b0d047e8d4cf29872464f383afc2f0c054) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Implement ai spans/traces storage apis for libsql
3244
+
3245
+ - Updated dependencies [[`0778757`](https://github.com/mastra-ai/mastra/commit/07787570e4addbd501522037bd2542c3d9e26822), [`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6), [`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01), [`9613558`](https://github.com/mastra-ai/mastra/commit/9613558e6475f4710e05d1be7553a32ee7bddc20)]:
3246
+ - @mastra/core@0.15.0
3247
+
3248
+ ## 0.13.5-alpha.0
3249
+
3250
+ ### Patch Changes
3251
+
3252
+ - [#6994](https://github.com/mastra-ai/mastra/pull/6994) [`0594a70`](https://github.com/mastra-ai/mastra/commit/0594a70ac948d306c7f38765b171c9535e6c78d4) Thanks [@wardpeet](https://github.com/wardpeet)! - Improve type resolving for storage adapters
3253
+
3254
+ - [#6959](https://github.com/mastra-ai/mastra/pull/6959) [`704173b`](https://github.com/mastra-ai/mastra/commit/704173b0d047e8d4cf29872464f383afc2f0c054) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Implement ai spans/traces storage apis for libsql
3255
+
3256
+ - Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
3257
+ - @mastra/core@0.14.2-alpha.1
3258
+
3259
+ ## 0.13.4
3260
+
3261
+ ### Patch Changes
3262
+
3263
+ - [#6920](https://github.com/mastra-ai/mastra/pull/6920) [`64ad21f`](https://github.com/mastra-ai/mastra/commit/64ad21ff4f58ce8b344d163d800d9e4f84d82f6f) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
3264
+ - Updated dependency [`@libsql/client@^0.15.12` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.12) (from `^0.15.10`, in `dependencies`)
3265
+
3266
+ - [#6700](https://github.com/mastra-ai/mastra/pull/6700) [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02) Thanks [@gpanakkal](https://github.com/gpanakkal)! - Add `getMessagesById` method to `MastraStorage` adapters
3267
+
3268
+ - Updated dependencies [[`6e7e120`](https://github.com/mastra-ai/mastra/commit/6e7e1207d6e8d8b838f9024f90bd10df1181ba27), [`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869), [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236), [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02)]:
3269
+ - @mastra/core@0.14.1
3270
+
3271
+ ## 0.13.4-alpha.0
3272
+
3273
+ ### Patch Changes
3274
+
3275
+ - [#6920](https://github.com/mastra-ai/mastra/pull/6920) [`64ad21f`](https://github.com/mastra-ai/mastra/commit/64ad21ff4f58ce8b344d163d800d9e4f84d82f6f) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
3276
+ - Updated dependency [`@libsql/client@^0.15.12` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.12) (from `^0.15.10`, in `dependencies`)
3277
+
3278
+ - [#6700](https://github.com/mastra-ai/mastra/pull/6700) [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02) Thanks [@gpanakkal](https://github.com/gpanakkal)! - Add `getMessagesById` method to `MastraStorage` adapters
3279
+
3280
+ - Updated dependencies [[`6e7e120`](https://github.com/mastra-ai/mastra/commit/6e7e1207d6e8d8b838f9024f90bd10df1181ba27), [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02)]:
3281
+ - @mastra/core@0.14.1-alpha.0
3282
+
3283
+ ## 0.13.3
3284
+
3285
+ ### Patch Changes
3286
+
3287
+ - 03997ae: Update peerdeps
3288
+ - d6e39da: Load most recent snapshot from storage
3289
+ - Updated dependencies [227c7e6]
3290
+ - Updated dependencies [12cae67]
3291
+ - Updated dependencies [fd3a3eb]
3292
+ - Updated dependencies [6faaee5]
3293
+ - Updated dependencies [4232b14]
3294
+ - Updated dependencies [a89de7e]
3295
+ - Updated dependencies [5a37d0c]
3296
+ - Updated dependencies [4bde0cb]
3297
+ - Updated dependencies [cf4f357]
3298
+ - Updated dependencies [ad888a2]
3299
+ - Updated dependencies [481751d]
3300
+ - Updated dependencies [2454423]
3301
+ - Updated dependencies [194e395]
3302
+ - Updated dependencies [a722c0b]
3303
+ - Updated dependencies [c30bca8]
3304
+ - Updated dependencies [3b5fec7]
3305
+ - Updated dependencies [a8f129d]
3306
+ - @mastra/core@0.14.0
3307
+
3308
+ ## 0.13.3-alpha.1
3309
+
3310
+ ### Patch Changes
3311
+
3312
+ - 03997ae: Update peerdeps
3313
+ - @mastra/core@0.14.0-alpha.7
3314
+
3315
+ ## 0.13.3-alpha.0
3316
+
3317
+ ### Patch Changes
3318
+
3319
+ - d6e39da: Load most recent snapshot from storage
3320
+ - Updated dependencies [6faaee5]
3321
+ - Updated dependencies [4232b14]
3322
+ - Updated dependencies [a89de7e]
3323
+ - Updated dependencies [cf4f357]
3324
+ - Updated dependencies [a722c0b]
3325
+ - Updated dependencies [3b5fec7]
3326
+ - @mastra/core@0.14.0-alpha.1
3327
+
3328
+ ## 0.13.2
3329
+
3330
+ ### Patch Changes
3331
+
3332
+ - b5cf2a3: make system message always available during agent calls
3333
+ - b32c50d: Filter scores by source
3334
+ - Updated dependencies [d5330bf]
3335
+ - Updated dependencies [2e74797]
3336
+ - Updated dependencies [8388649]
3337
+ - Updated dependencies [a239d41]
3338
+ - Updated dependencies [dd94a26]
3339
+ - Updated dependencies [3ba6772]
3340
+ - Updated dependencies [b5cf2a3]
3341
+ - Updated dependencies [2fff911]
3342
+ - Updated dependencies [b32c50d]
3343
+ - Updated dependencies [63449d0]
3344
+ - Updated dependencies [121a3f8]
3345
+ - Updated dependencies [ec510e7]
3346
+ - @mastra/core@0.13.2
3347
+
3348
+ ## 0.13.2-alpha.1
3349
+
3350
+ ### Patch Changes
3351
+
3352
+ - b5cf2a3: make system message always available during agent calls
3353
+ - Updated dependencies [b5cf2a3]
3354
+ - @mastra/core@0.13.2-alpha.3
3355
+
3356
+ ## 0.13.2-alpha.0
3357
+
3358
+ ### Patch Changes
3359
+
3360
+ - b32c50d: Filter scores by source
3361
+ - Updated dependencies [d5330bf]
3362
+ - Updated dependencies [a239d41]
3363
+ - Updated dependencies [b32c50d]
3364
+ - Updated dependencies [121a3f8]
3365
+ - Updated dependencies [ec510e7]
3366
+ - @mastra/core@0.13.2-alpha.2
3367
+
3368
+ ## 0.13.1
3369
+
3370
+ ### Patch Changes
3371
+
3372
+ - 8888b57: Fix LibSQL vector metadata filtering for Memory system - corrected JSON path syntax for simple fields and changed default minScore to -1 to include all similarity results
3373
+ - Updated dependencies [cd0042e]
3374
+ - @mastra/core@0.13.1
3375
+
3376
+ ## 0.13.1-alpha.0
3377
+
3378
+ ### Patch Changes
3379
+
3380
+ - 8888b57: Fix LibSQL vector metadata filtering for Memory system - corrected JSON path syntax for simple fields and changed default minScore to -1 to include all similarity results
3381
+ - Updated dependencies [cd0042e]
3382
+ - @mastra/core@0.13.1-alpha.0
3383
+
3384
+ ## 0.13.0
3385
+
3386
+ ### Minor Changes
3387
+
3388
+ - ea0c5f2: Add store support to new score api
3389
+
3390
+ ### Patch Changes
3391
+
3392
+ - 2871020: update safelyParseJSON to check for value of param when handling parse
3393
+ - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
3394
+ - Updated dependencies [cb36de0]
3395
+ - Updated dependencies [d0496e6]
3396
+ - Updated dependencies [a82b851]
3397
+ - Updated dependencies [ea0c5f2]
3398
+ - Updated dependencies [41a0a0e]
3399
+ - Updated dependencies [2871020]
3400
+ - Updated dependencies [94f4812]
3401
+ - Updated dependencies [e202b82]
3402
+ - Updated dependencies [e00f6a0]
3403
+ - Updated dependencies [4a406ec]
3404
+ - Updated dependencies [b0e43c1]
3405
+ - Updated dependencies [5d377e5]
3406
+ - Updated dependencies [1fb812e]
3407
+ - Updated dependencies [35c5798]
3408
+ - @mastra/core@0.13.0
3409
+
3410
+ ## 0.13.0-alpha.1
3411
+
3412
+ ### Patch Changes
3413
+
3414
+ - 2871020: update safelyParseJSON to check for value of param when handling parse
3415
+ - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
3416
+ - Updated dependencies [cb36de0]
3417
+ - Updated dependencies [a82b851]
3418
+ - Updated dependencies [41a0a0e]
3419
+ - Updated dependencies [2871020]
3420
+ - Updated dependencies [4a406ec]
3421
+ - Updated dependencies [5d377e5]
3422
+ - @mastra/core@0.13.0-alpha.2
3423
+
3424
+ ## 0.13.0-alpha.0
3425
+
3426
+ ### Minor Changes
3427
+
3428
+ - ea0c5f2: Add store support to new score api
3429
+
3430
+ ### Patch Changes
3431
+
3432
+ - Updated dependencies [ea0c5f2]
3433
+ - Updated dependencies [b0e43c1]
3434
+ - Updated dependencies [1fb812e]
3435
+ - Updated dependencies [35c5798]
3436
+ - @mastra/core@0.13.0-alpha.1
3437
+
3438
+ ## 0.12.0
3439
+
3440
+ ### Minor Changes
3441
+
3442
+ - f42c4c2: update peer deps for packages to latest core range
3443
+
3444
+ ### Patch Changes
3445
+
3446
+ - 24ac5ff: dependencies updates:
3447
+ - Updated dependency [`@libsql/client@^0.15.10` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.10) (from `^0.15.9`, in `dependencies`)
3448
+ - ff9c125: enhance thread retrieval with sorting options in libsql and pg
3449
+ - a3ca14c: `LibSQLVector.doUpsert`: check if transaction is open before attempting rollback
3450
+ - b8efbb9: feat: add flexible deleteMessages method to memory API
3451
+ - Added `memory.deleteMessages(input)` method that accepts multiple input types:
3452
+ - Single message ID as string: `deleteMessages('msg-123')`
3453
+ - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
3454
+ - Message object with id property: `deleteMessages({ id: 'msg-123' })`
3455
+ - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
3456
+ - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
3457
+ - Added REST API endpoint: `POST /api/memory/messages/delete`
3458
+ - Updated client SDK: `thread.deleteMessages()` accepts all input types
3459
+ - Updates thread timestamps when messages are deleted
3460
+ - Added comprehensive test coverage and documentation
3461
+
3462
+ - Updated dependencies [510e2c8]
3463
+ - Updated dependencies [2f72fb2]
3464
+ - Updated dependencies [27cc97a]
3465
+ - Updated dependencies [3f89307]
3466
+ - Updated dependencies [9eda7d4]
3467
+ - Updated dependencies [9d49408]
3468
+ - Updated dependencies [41daa63]
3469
+ - Updated dependencies [ad0a58b]
3470
+ - Updated dependencies [254a36b]
3471
+ - Updated dependencies [2ecf658]
3472
+ - Updated dependencies [7a7754f]
3473
+ - Updated dependencies [fc92d80]
3474
+ - Updated dependencies [e0f73c6]
3475
+ - Updated dependencies [0b89602]
3476
+ - Updated dependencies [4d37822]
3477
+ - Updated dependencies [23a6a7c]
3478
+ - Updated dependencies [cda801d]
3479
+ - Updated dependencies [a77c823]
3480
+ - Updated dependencies [ff9c125]
3481
+ - Updated dependencies [09bca64]
3482
+ - Updated dependencies [b8efbb9]
3483
+ - Updated dependencies [71466e7]
3484
+ - Updated dependencies [0c99fbe]
3485
+ - @mastra/core@0.12.0
3486
+
3487
+ ## 0.12.0-alpha.2
3488
+
3489
+ ### Minor Changes
3490
+
3491
+ - f42c4c2: update peer deps for packages to latest core range
3492
+
3493
+ ### Patch Changes
3494
+
3495
+ - @mastra/core@0.12.0-alpha.5
3496
+
3497
+ ## 0.11.3-alpha.1
3498
+
3499
+ ### Patch Changes
3500
+
3501
+ - ff9c125: enhance thread retrieval with sorting options in libsql and pg
3502
+ - b8efbb9: feat: add flexible deleteMessages method to memory API
3503
+ - Added `memory.deleteMessages(input)` method that accepts multiple input types:
3504
+ - Single message ID as string: `deleteMessages('msg-123')`
3505
+ - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
3506
+ - Message object with id property: `deleteMessages({ id: 'msg-123' })`
3507
+ - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
3508
+ - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
3509
+ - Added REST API endpoint: `POST /api/memory/messages/delete`
3510
+ - Updated client SDK: `thread.deleteMessages()` accepts all input types
3511
+ - Updates thread timestamps when messages are deleted
3512
+ - Added comprehensive test coverage and documentation
3513
+
3514
+ - Updated dependencies [27cc97a]
3515
+ - Updated dependencies [41daa63]
3516
+ - Updated dependencies [254a36b]
3517
+ - Updated dependencies [0b89602]
3518
+ - Updated dependencies [4d37822]
3519
+ - Updated dependencies [ff9c125]
3520
+ - Updated dependencies [b8efbb9]
3521
+ - Updated dependencies [71466e7]
3522
+ - Updated dependencies [0c99fbe]
3523
+ - @mastra/core@0.12.0-alpha.2
3524
+
3525
+ ## 0.11.3-alpha.0
3526
+
3527
+ ### Patch Changes
3528
+
3529
+ - 24ac5ff: dependencies updates:
3530
+ - Updated dependency [`@libsql/client@^0.15.10` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.10) (from `^0.15.9`, in `dependencies`)
3531
+ - a3ca14c: `LibSQLVector.doUpsert`: check if transaction is open before attempting rollback
3532
+ - Updated dependencies [510e2c8]
3533
+ - Updated dependencies [2f72fb2]
3534
+ - Updated dependencies [3f89307]
3535
+ - Updated dependencies [9eda7d4]
3536
+ - Updated dependencies [9d49408]
3537
+ - Updated dependencies [2ecf658]
3538
+ - Updated dependencies [7a7754f]
3539
+ - Updated dependencies [fc92d80]
3540
+ - Updated dependencies [23a6a7c]
3541
+ - Updated dependencies [09bca64]
3542
+ - @mastra/core@0.12.0-alpha.0
3543
+
3544
+ ## 0.11.2
3545
+
3546
+ ### Patch Changes
3547
+
3548
+ - 3cc50c7: Update mastra core peer dep version
3549
+ - ce088f5: Update all peerdeps to latest core
3550
+ - @mastra/core@0.11.1
3551
+
3552
+ ## 0.11.1
3553
+
3554
+ ### Patch Changes
3555
+
3556
+ - 7ba91fa: Throw mastra errors methods not implemented yet
3557
+ - da168a4: increase the peer deps range
3558
+ - Updated dependencies [f248d53]
3559
+ - Updated dependencies [2affc57]
3560
+ - Updated dependencies [66e13e3]
3561
+ - Updated dependencies [edd9482]
3562
+ - Updated dependencies [18344d7]
3563
+ - Updated dependencies [9d372c2]
3564
+ - Updated dependencies [40c2525]
3565
+ - Updated dependencies [e473f27]
3566
+ - Updated dependencies [032cb66]
3567
+ - Updated dependencies [703ac71]
3568
+ - Updated dependencies [a723d69]
3569
+ - Updated dependencies [7827943]
3570
+ - Updated dependencies [5889a31]
3571
+ - Updated dependencies [bf1e7e7]
3572
+ - Updated dependencies [65e3395]
3573
+ - Updated dependencies [4933192]
3574
+ - Updated dependencies [d1c77a4]
3575
+ - Updated dependencies [bea9dd1]
3576
+ - Updated dependencies [dcd4802]
3577
+ - Updated dependencies [cbddd18]
3578
+ - Updated dependencies [7ba91fa]
3579
+ - @mastra/core@0.11.0
3580
+
3581
+ ## 0.11.1-alpha.0
3582
+
3583
+ ### Patch Changes
3584
+
3585
+ - 7ba91fa: Throw mastra errors methods not implemented yet
3586
+ - da168a4: increase the peer deps range
3587
+ - Updated dependencies [f248d53]
3588
+ - Updated dependencies [2affc57]
3589
+ - Updated dependencies [66e13e3]
3590
+ - Updated dependencies [edd9482]
3591
+ - Updated dependencies [18344d7]
3592
+ - Updated dependencies [9d372c2]
3593
+ - Updated dependencies [40c2525]
3594
+ - Updated dependencies [e473f27]
3595
+ - Updated dependencies [032cb66]
3596
+ - Updated dependencies [703ac71]
3597
+ - Updated dependencies [a723d69]
3598
+ - Updated dependencies [5889a31]
3599
+ - Updated dependencies [65e3395]
3600
+ - Updated dependencies [4933192]
3601
+ - Updated dependencies [d1c77a4]
3602
+ - Updated dependencies [bea9dd1]
3603
+ - Updated dependencies [dcd4802]
3604
+ - Updated dependencies [7ba91fa]
3605
+ - @mastra/core@0.11.0-alpha.2
3606
+
3607
+ ## 0.11.0
3608
+
3609
+ ### Minor Changes
3610
+
3611
+ - 8a3bfd2: Update peerdeps to latest core
3612
+
3613
+ ### Patch Changes
3614
+
3615
+ - 15e9d26: Added per-resource working memory for LibSQL, Upstash, and PG
3616
+ - d8f2d19: Add updateMessages API to storage classes (only support for PG and LibSQL for now) and to memory class. Additionally allow for metadata to be saved in the content field of a message.
3617
+ - 0fb9d64: [MASTRA-4018] Update saveMessages in storage adapters to upsert messages
3618
+ - 2097952: [MASTRA-4021] Fix PG getMessages and update messageLimit for all storage adapters
3619
+ - 144eb0b: [MASTRA-3669] Metadata Filter Types
3620
+ - f0150c4: Fix LibSQLStore and PgStore getMessagesPaginated implementation
3621
+ - 0e17048: Throw mastra errors in storage packages
3622
+ - Updated dependencies [15e9d26]
3623
+ - Updated dependencies [d1baedb]
3624
+ - Updated dependencies [d8f2d19]
3625
+ - Updated dependencies [4d21bf2]
3626
+ - Updated dependencies [07d6d88]
3627
+ - Updated dependencies [9d52b17]
3628
+ - Updated dependencies [2097952]
3629
+ - Updated dependencies [792c4c0]
3630
+ - Updated dependencies [5d74aab]
3631
+ - Updated dependencies [a8b194f]
3632
+ - Updated dependencies [4fb0cc2]
3633
+ - Updated dependencies [d2a7a31]
3634
+ - Updated dependencies [502fe05]
3635
+ - Updated dependencies [144eb0b]
3636
+ - Updated dependencies [8ba1b51]
3637
+ - Updated dependencies [4efcfa0]
3638
+ - Updated dependencies [0e17048]
3639
+ - @mastra/core@0.10.7
3640
+
3641
+ ## 0.11.0-alpha.3
3642
+
3643
+ ### Minor Changes
3644
+
3645
+ - 8a3bfd2: Update peerdeps to latest core
3646
+
3647
+ ### Patch Changes
3648
+
3649
+ - Updated dependencies [792c4c0]
3650
+ - Updated dependencies [502fe05]
3651
+ - Updated dependencies [4efcfa0]
3652
+ - @mastra/core@0.10.7-alpha.3
3653
+
3654
+ ## 0.10.4-alpha.2
3655
+
3656
+ ### Patch Changes
3657
+
3658
+ - 15e9d26: Added per-resource working memory for LibSQL, Upstash, and PG
3659
+ - 0fb9d64: [MASTRA-4018] Update saveMessages in storage adapters to upsert messages
3660
+ - 144eb0b: [MASTRA-3669] Metadata Filter Types
3661
+ - f0150c4: Fix LibSQLStore and PgStore getMessagesPaginated implementation
3662
+ - Updated dependencies [15e9d26]
3663
+ - Updated dependencies [07d6d88]
3664
+ - Updated dependencies [5d74aab]
3665
+ - Updated dependencies [144eb0b]
3666
+ - @mastra/core@0.10.7-alpha.2
3667
+
3668
+ ## 0.10.4-alpha.1
3669
+
3670
+ ### Patch Changes
3671
+
3672
+ - 2097952: [MASTRA-4021] Fix PG getMessages and update messageLimit for all storage adapters
3673
+ - 0e17048: Throw mastra errors in storage packages
3674
+ - Updated dependencies [d1baedb]
3675
+ - Updated dependencies [4d21bf2]
3676
+ - Updated dependencies [2097952]
3677
+ - Updated dependencies [4fb0cc2]
3678
+ - Updated dependencies [d2a7a31]
3679
+ - Updated dependencies [0e17048]
3680
+ - @mastra/core@0.10.7-alpha.1
3681
+
3682
+ ## 0.10.4-alpha.0
3683
+
3684
+ ### Patch Changes
3685
+
3686
+ - d8f2d19: Add updateMessages API to storage classes (only support for PG and LibSQL for now) and to memory class. Additionally allow for metadata to be saved in the content field of a message.
3687
+ - Updated dependencies [d8f2d19]
3688
+ - Updated dependencies [9d52b17]
3689
+ - Updated dependencies [8ba1b51]
3690
+ - @mastra/core@0.10.7-alpha.0
3691
+
3692
+ ## 0.10.3
3693
+
3694
+ ### Patch Changes
3695
+
3696
+ - 63f6b7d: dependencies updates:
3697
+ - Updated dependency [`@libsql/client@^0.15.9` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.9) (from `^0.15.8`, in `dependencies`)
3698
+ - Updated dependencies [63f6b7d]
3699
+ - Updated dependencies [12a95fc]
3700
+ - Updated dependencies [4b0f8a6]
3701
+ - Updated dependencies [51264a5]
3702
+ - Updated dependencies [8e6f677]
3703
+ - Updated dependencies [d70c420]
3704
+ - Updated dependencies [ee9af57]
3705
+ - Updated dependencies [36f1c36]
3706
+ - Updated dependencies [2a16996]
3707
+ - Updated dependencies [10d352e]
3708
+ - Updated dependencies [9589624]
3709
+ - Updated dependencies [53d3c37]
3710
+ - Updated dependencies [751c894]
3711
+ - Updated dependencies [577ce3a]
3712
+ - Updated dependencies [9260b3a]
3713
+ - @mastra/core@0.10.6
3714
+
3715
+ ## 0.10.3-alpha.0
3716
+
3717
+ ### Patch Changes
3718
+
3719
+ - 63f6b7d: dependencies updates:
3720
+ - Updated dependency [`@libsql/client@^0.15.9` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.9) (from `^0.15.8`, in `dependencies`)
3721
+ - Updated dependencies [63f6b7d]
3722
+ - Updated dependencies [36f1c36]
3723
+ - Updated dependencies [10d352e]
3724
+ - Updated dependencies [53d3c37]
3725
+ - @mastra/core@0.10.6-alpha.0
3726
+
3727
+ ## 0.10.2
3728
+
3729
+ ### Patch Changes
3730
+
3731
+ - 5d3dc1e: dependencies updates:
3732
+ - Updated dependency [`@libsql/client@^0.15.8` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.8) (from `^0.15.4`, in `dependencies`)
3733
+ - dffb67b: updated stores to add alter table and change tests
3734
+ - e0f9201: change how dedupe works for libsql and pg
3735
+ - 14a2566: Add pagination to libsql storage APIs
3736
+ - 48eddb9: update filter logic in Memory class to support semantic recall search scope
3737
+ - 66f4424: Update peerdeps
3738
+ - Updated dependencies [d1ed912]
3739
+ - Updated dependencies [f6fd25f]
3740
+ - Updated dependencies [dffb67b]
3741
+ - Updated dependencies [f1f1f1b]
3742
+ - Updated dependencies [925ab94]
3743
+ - Updated dependencies [f9816ae]
3744
+ - Updated dependencies [82090c1]
3745
+ - Updated dependencies [1b443fd]
3746
+ - Updated dependencies [ce97900]
3747
+ - Updated dependencies [f1309d3]
3748
+ - Updated dependencies [14a2566]
3749
+ - Updated dependencies [f7f8293]
3750
+ - Updated dependencies [48eddb9]
3751
+ - @mastra/core@0.10.4
3752
+
3753
+ ## 0.10.2-alpha.4
3754
+
3755
+ ### Patch Changes
3756
+
3757
+ - 66f4424: Update peerdeps
3758
+
3759
+ ## 0.10.2-alpha.3
3760
+
3761
+ ### Patch Changes
3762
+
3763
+ - e0f9201: change how dedupe works for libsql and pg
3764
+ - Updated dependencies [925ab94]
3765
+ - @mastra/core@0.10.4-alpha.3
3766
+
3767
+ ## 0.10.2-alpha.2
3768
+
3769
+ ### Patch Changes
3770
+
3771
+ - 48eddb9: update filter logic in Memory class to support semantic recall search scope
3772
+ - Updated dependencies [48eddb9]
3773
+ - @mastra/core@0.10.4-alpha.2
3774
+
3775
+ ## 0.10.2-alpha.1
3776
+
3777
+ ### Patch Changes
3778
+
3779
+ - dffb67b: updated stores to add alter table and change tests
3780
+ - Updated dependencies [f6fd25f]
3781
+ - Updated dependencies [dffb67b]
3782
+ - Updated dependencies [f1309d3]
3783
+ - Updated dependencies [f7f8293]
3784
+ - @mastra/core@0.10.4-alpha.1
3785
+
3786
+ ## 0.10.2-alpha.0
3787
+
3788
+ ### Patch Changes
3789
+
3790
+ - 5d3dc1e: dependencies updates:
3791
+ - Updated dependency [`@libsql/client@^0.15.8` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.8) (from `^0.15.4`, in `dependencies`)
3792
+ - 14a2566: Add pagination to libsql storage APIs
3793
+ - Updated dependencies [d1ed912]
3794
+ - Updated dependencies [f1f1f1b]
3795
+ - Updated dependencies [f9816ae]
3796
+ - Updated dependencies [82090c1]
3797
+ - Updated dependencies [1b443fd]
3798
+ - Updated dependencies [ce97900]
3799
+ - Updated dependencies [14a2566]
3800
+ - @mastra/core@0.10.4-alpha.0
3801
+
3802
+ ## 0.10.1
3803
+
3804
+ ### Patch Changes
3805
+
3806
+ - e5dc18d: Added a backwards compatible layer to begin storing/retrieving UIMessages in storage instead of CoreMessages
3807
+ - a3f1b39: feat(libsql): update thread timestamp when saving messages
3808
+ - 9e37877: Fixes SQLITE_BUSY error often seen when working locally on the playground
3809
+ - c5bf1ce: Add backwards compat code for new MessageList in storage
3810
+ - f0d559f: Fix peerdeps for alpha channel
3811
+ - Updated dependencies [ee77e78]
3812
+ - Updated dependencies [592a2db]
3813
+ - Updated dependencies [e5dc18d]
3814
+ - Updated dependencies [ab5adbe]
3815
+ - Updated dependencies [1e8bb40]
3816
+ - Updated dependencies [1b5fc55]
3817
+ - Updated dependencies [195c428]
3818
+ - Updated dependencies [f73e11b]
3819
+ - Updated dependencies [37643b8]
3820
+ - Updated dependencies [99fd6cf]
3821
+ - Updated dependencies [c5bf1ce]
3822
+ - Updated dependencies [add596e]
3823
+ - Updated dependencies [8dc94d8]
3824
+ - Updated dependencies [ecebbeb]
3825
+ - Updated dependencies [79d5145]
3826
+ - Updated dependencies [12b7002]
3827
+ - Updated dependencies [2901125]
3828
+ - @mastra/core@0.10.2
3829
+
3830
+ ## 0.10.1-alpha.3
3831
+
3832
+ ### Patch Changes
3833
+
3834
+ - a3f1b39: feat(libsql): update thread timestamp when saving messages
3835
+
3836
+ ## 0.10.1-alpha.2
3837
+
3838
+ ### Patch Changes
3839
+
3840
+ - c5bf1ce: Add backwards compat code for new MessageList in storage
3841
+ - Updated dependencies [c5bf1ce]
3842
+ - Updated dependencies [12b7002]
3843
+ - @mastra/core@0.10.2-alpha.4
3844
+
3845
+ ## 0.10.1-alpha.1
3846
+
3847
+ ### Patch Changes
3848
+
3849
+ - f0d559f: Fix peerdeps for alpha channel
3850
+ - Updated dependencies [1e8bb40]
3851
+ - @mastra/core@0.10.2-alpha.2
3852
+
3853
+ ## 0.10.1-alpha.0
3854
+
3855
+ ### Patch Changes
3856
+
3857
+ - e5dc18d: Added a backwards compatible layer to begin storing/retrieving UIMessages in storage instead of CoreMessages
3858
+ - 9e37877: Fixes SQLITE_BUSY error often seen when working locally on the playground
3859
+ - Updated dependencies [592a2db]
3860
+ - Updated dependencies [e5dc18d]
3861
+ - @mastra/core@0.10.2-alpha.0
3862
+
3863
+ ## 0.10.0
3864
+
3865
+ ### Minor Changes
3866
+
3867
+ - 83da932: Move @mastra/core to peerdeps
3868
+
3869
+ ### Patch Changes
3870
+
3871
+ - eabdcd9: [MASTRA-3451] SQL Injection Protection
3872
+ - d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
3873
+ - a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
3874
+ - Updated dependencies [b3a3d63]
3875
+ - Updated dependencies [344f453]
3876
+ - Updated dependencies [0a3ae6d]
3877
+ - Updated dependencies [95911be]
3878
+ - Updated dependencies [f53a6ac]
3879
+ - Updated dependencies [5eb5a99]
3880
+ - Updated dependencies [7e632c5]
3881
+ - Updated dependencies [1e9fbfa]
3882
+ - Updated dependencies [eabdcd9]
3883
+ - Updated dependencies [90be034]
3884
+ - Updated dependencies [99f050a]
3885
+ - Updated dependencies [d0ee3c6]
3886
+ - Updated dependencies [b2ae5aa]
3887
+ - Updated dependencies [23f258c]
3888
+ - Updated dependencies [a7292b0]
3889
+ - Updated dependencies [0dcb9f0]
3890
+ - Updated dependencies [2672a05]
3891
+ - @mastra/core@0.10.0
3892
+
3893
+ ## 0.1.0-alpha.1
3894
+
3895
+ ### Minor Changes
3896
+
3897
+ - 83da932: Move @mastra/core to peerdeps
3898
+
3899
+ ### Patch Changes
3900
+
3901
+ - a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
3902
+ - Updated dependencies [b3a3d63]
3903
+ - Updated dependencies [344f453]
3904
+ - Updated dependencies [0a3ae6d]
3905
+ - Updated dependencies [95911be]
3906
+ - Updated dependencies [5eb5a99]
3907
+ - Updated dependencies [7e632c5]
3908
+ - Updated dependencies [1e9fbfa]
3909
+ - Updated dependencies [b2ae5aa]
3910
+ - Updated dependencies [a7292b0]
3911
+ - Updated dependencies [0dcb9f0]
3912
+ - @mastra/core@0.10.0-alpha.1
3913
+
3914
+ ## 0.0.5-alpha.0
3915
+
3916
+ ### Patch Changes
3917
+
3918
+ - eabdcd9: [MASTRA-3451] SQL Injection Protection
3919
+ - d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
3920
+ - Updated dependencies [f53a6ac]
3921
+ - Updated dependencies [eabdcd9]
3922
+ - Updated dependencies [90be034]
3923
+ - Updated dependencies [99f050a]
3924
+ - Updated dependencies [d0ee3c6]
3925
+ - Updated dependencies [23f258c]
3926
+ - Updated dependencies [2672a05]
3927
+ - @mastra/core@0.9.5-alpha.0
3928
+
3929
+ ## 0.0.4
3930
+
3931
+ ### Patch Changes
3932
+
3933
+ - c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
3934
+ - Updated dependencies [396be50]
3935
+ - Updated dependencies [ab80e7e]
3936
+ - Updated dependencies [c3bd795]
3937
+ - Updated dependencies [da082f8]
3938
+ - Updated dependencies [a5810ce]
3939
+ - Updated dependencies [3e9c131]
3940
+ - Updated dependencies [3171b5b]
3941
+ - Updated dependencies [973e5ac]
3942
+ - Updated dependencies [daf942f]
3943
+ - Updated dependencies [0b8b868]
3944
+ - Updated dependencies [9e1eff5]
3945
+ - Updated dependencies [6fa1ad1]
3946
+ - Updated dependencies [c28d7a0]
3947
+ - Updated dependencies [edf1e88]
3948
+ - @mastra/core@0.9.4
3949
+
3950
+ ## 0.0.4-alpha.4
3951
+
3952
+ ### Patch Changes
3953
+
3954
+ - Updated dependencies [3e9c131]
3955
+ - @mastra/core@0.9.4-alpha.4
3956
+
3957
+ ## 0.0.4-alpha.3
3958
+
3959
+ ### Patch Changes
3960
+
3961
+ - c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
3962
+ - Updated dependencies [396be50]
3963
+ - Updated dependencies [c3bd795]
3964
+ - Updated dependencies [da082f8]
3965
+ - Updated dependencies [a5810ce]
3966
+ - @mastra/core@0.9.4-alpha.3
3967
+
3968
+ ## 0.0.4-alpha.2
3969
+
3970
+ ### Patch Changes
3971
+
3972
+ - Updated dependencies [3171b5b]
3973
+ - Updated dependencies [973e5ac]
3974
+ - Updated dependencies [9e1eff5]
3975
+ - @mastra/core@0.9.4-alpha.2
3976
+
3977
+ ## 0.0.4-alpha.1
3978
+
3979
+ ### Patch Changes
3980
+
3981
+ - Updated dependencies [ab80e7e]
3982
+ - Updated dependencies [6fa1ad1]
3983
+ - Updated dependencies [c28d7a0]
3984
+ - Updated dependencies [edf1e88]
3985
+ - @mastra/core@0.9.4-alpha.1
3986
+
3987
+ ## 0.0.4-alpha.0
3988
+
3989
+ ### Patch Changes
3990
+
3991
+ - Updated dependencies [daf942f]
3992
+ - Updated dependencies [0b8b868]
3993
+ - @mastra/core@0.9.4-alpha.0
3994
+
3995
+ ## 0.0.3
3996
+
3997
+ ### Patch Changes
3998
+
3999
+ - Updated dependencies [e450778]
4000
+ - Updated dependencies [8902157]
4001
+ - Updated dependencies [ca0dc88]
4002
+ - Updated dependencies [526c570]
4003
+ - Updated dependencies [d7a6a33]
4004
+ - Updated dependencies [9cd1a46]
4005
+ - Updated dependencies [b5d2de0]
4006
+ - Updated dependencies [644f8ad]
4007
+ - Updated dependencies [70dbf51]
4008
+ - @mastra/core@0.9.3
4009
+
4010
+ ## 0.0.3-alpha.1
4011
+
4012
+ ### Patch Changes
4013
+
4014
+ - Updated dependencies [e450778]
4015
+ - Updated dependencies [8902157]
4016
+ - Updated dependencies [ca0dc88]
4017
+ - Updated dependencies [9cd1a46]
4018
+ - Updated dependencies [70dbf51]
4019
+ - @mastra/core@0.9.3-alpha.1
4020
+
4021
+ ## 0.0.3-alpha.0
4022
+
4023
+ ### Patch Changes
4024
+
4025
+ - Updated dependencies [526c570]
4026
+ - Updated dependencies [b5d2de0]
4027
+ - Updated dependencies [644f8ad]
4028
+ - @mastra/core@0.9.3-alpha.0
4029
+
4030
+ ## 0.0.2
4031
+
4032
+ ### Patch Changes
4033
+
4034
+ - 4155f47: Add parameters to filter workflow runs
4035
+ Add fromDate and toDate to telemetry parameters
4036
+ - Updated dependencies [6052aa6]
4037
+ - Updated dependencies [967b41c]
4038
+ - Updated dependencies [3d2fb5c]
7
4039
  - Updated dependencies [26738f4]
4040
+ - Updated dependencies [4155f47]
4041
+ - Updated dependencies [7eeb2bc]
8
4042
  - Updated dependencies [b804723]
4043
+ - Updated dependencies [8607972]
4044
+ - Updated dependencies [ccef9f9]
9
4045
  - Updated dependencies [0097d50]
10
- - @mastra/core@0.0.0-separate-trace-data-from-component-20250501141108
4046
+ - Updated dependencies [7eeb2bc]
4047
+ - Updated dependencies [17826a9]
4048
+ - Updated dependencies [7d8b7c7]
4049
+ - Updated dependencies [fba031f]
4050
+ - Updated dependencies [3a5f1e1]
4051
+ - Updated dependencies [51e6923]
4052
+ - Updated dependencies [8398d89]
4053
+ - @mastra/core@0.9.2
4054
+
4055
+ ## 0.0.2-alpha.6
4056
+
4057
+ ### Patch Changes
4058
+
4059
+ - Updated dependencies [6052aa6]
4060
+ - Updated dependencies [7d8b7c7]
4061
+ - Updated dependencies [3a5f1e1]
4062
+ - Updated dependencies [8398d89]
4063
+ - @mastra/core@0.9.2-alpha.6
4064
+
4065
+ ## 0.0.2-alpha.5
4066
+
4067
+ ### Patch Changes
4068
+
4069
+ - Updated dependencies [3d2fb5c]
4070
+ - Updated dependencies [7eeb2bc]
4071
+ - Updated dependencies [8607972]
4072
+ - Updated dependencies [7eeb2bc]
4073
+ - Updated dependencies [fba031f]
4074
+ - @mastra/core@0.9.2-alpha.5
4075
+
4076
+ ## 0.0.2-alpha.4
4077
+
4078
+ ### Patch Changes
4079
+
4080
+ - Updated dependencies [ccef9f9]
4081
+ - Updated dependencies [51e6923]
4082
+ - @mastra/core@0.9.2-alpha.4
4083
+
4084
+ ## 0.0.2-alpha.3
4085
+
4086
+ ### Patch Changes
4087
+
4088
+ - 4155f47: Add parameters to filter workflow runs
4089
+ Add fromDate and toDate to telemetry parameters
4090
+ - Updated dependencies [967b41c]
4091
+ - Updated dependencies [4155f47]
4092
+ - Updated dependencies [17826a9]
4093
+ - @mastra/core@0.9.2-alpha.3
11
4094
 
12
4095
  ## 0.0.2-alpha.2
13
4096