@mastra/libsql 0.0.0-workflow-deno-20250616130925 → 0.0.0-workflow-timeout-issue-20260213181535

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 (81) hide show
  1. package/CHANGELOG.md +3186 -3
  2. package/LICENSE.md +12 -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 +377 -0
  7. package/dist/docs/references/docs-agents-agent-memory.md +212 -0
  8. package/dist/docs/references/docs-agents-network-approval.md +275 -0
  9. package/dist/docs/references/docs-agents-networks.md +290 -0
  10. package/dist/docs/references/docs-memory-memory-processors.md +316 -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 +272 -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 +211 -0
  18. package/dist/docs/references/docs-rag-retrieval.md +521 -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 +147 -0
  25. package/dist/docs/references/reference-storage-composite.md +235 -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 +6477 -735
  30. package/dist/index.cjs.map +1 -0
  31. package/dist/index.d.ts +4 -6
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +6471 -737
  34. package/dist/index.js.map +1 -0
  35. package/dist/storage/db/index.d.ts +305 -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/mcp-clients/index.d.ts +26 -0
  42. package/dist/storage/domains/mcp-clients/index.d.ts.map +1 -0
  43. package/dist/storage/domains/memory/index.d.ts +81 -0
  44. package/dist/storage/domains/memory/index.d.ts.map +1 -0
  45. package/dist/storage/domains/observability/index.d.ts +46 -0
  46. package/dist/storage/domains/observability/index.d.ts.map +1 -0
  47. package/dist/storage/domains/prompt-blocks/index.d.ts +25 -0
  48. package/dist/storage/domains/prompt-blocks/index.d.ts.map +1 -0
  49. package/dist/storage/domains/scorer-definitions/index.d.ts +26 -0
  50. package/dist/storage/domains/scorer-definitions/index.d.ts.map +1 -0
  51. package/dist/storage/domains/scores/index.d.ts +42 -0
  52. package/dist/storage/domains/scores/index.d.ts.map +1 -0
  53. package/dist/storage/domains/workflows/index.d.ts +47 -0
  54. package/dist/storage/domains/workflows/index.d.ts.map +1 -0
  55. package/dist/storage/index.d.ts +83 -0
  56. package/dist/storage/index.d.ts.map +1 -0
  57. package/dist/vector/filter.d.ts +29 -0
  58. package/dist/vector/filter.d.ts.map +1 -0
  59. package/dist/vector/index.d.ts +80 -0
  60. package/dist/vector/index.d.ts.map +1 -0
  61. package/dist/vector/prompt.d.ts +6 -0
  62. package/dist/vector/prompt.d.ts.map +1 -0
  63. package/dist/vector/sql-builder.d.ts +9 -0
  64. package/dist/vector/sql-builder.d.ts.map +1 -0
  65. package/package.json +34 -16
  66. package/.turbo/turbo-build.log +0 -23
  67. package/dist/_tsup-dts-rollup.d.cts +0 -295
  68. package/dist/_tsup-dts-rollup.d.ts +0 -295
  69. package/dist/index.d.cts +0 -6
  70. package/eslint.config.js +0 -6
  71. package/src/index.ts +0 -3
  72. package/src/storage/index.test.ts +0 -364
  73. package/src/storage/index.ts +0 -1131
  74. package/src/vector/filter.test.ts +0 -968
  75. package/src/vector/filter.ts +0 -117
  76. package/src/vector/index.test.ts +0 -1682
  77. package/src/vector/index.ts +0 -403
  78. package/src/vector/prompt.ts +0 -101
  79. package/src/vector/sql-builder.ts +0 -530
  80. package/tsconfig.json +0 -5
  81. package/vitest.config.ts +0 -11
package/CHANGELOG.md CHANGED
@@ -1,20 +1,3203 @@
1
1
  # @mastra/libsql
2
2
 
3
- ## 0.0.0-workflow-deno-20250616130925
3
+ ## 0.0.0-workflow-timeout-issue-20260213181535
4
+
5
+ ### Patch Changes
6
+
7
+ - 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))
8
+
9
+ - 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))
10
+
11
+ **MCP Client Storage**
12
+
13
+ New storage domain for persisting MCP client configurations with CRUD operations. Each MCP client can contain multiple servers with independent tool selection:
14
+
15
+ ```ts
16
+ // Store an MCP client with multiple servers
17
+ await storage.mcpClients.create({
18
+ id: 'my-mcp',
19
+ name: 'My MCP Client',
20
+ servers: {
21
+ 'github-server': { url: 'https://mcp.github.com/sse' },
22
+ 'slack-server': { url: 'https://mcp.slack.com/sse' },
23
+ },
24
+ });
25
+ ```
26
+
27
+ LibSQL, PostgreSQL, and MongoDB storage adapters all implement the new MCP client domain.
28
+
29
+ **ToolProvider Interface**
30
+
31
+ New `ToolProvider` interface at `@mastra/core/tool-provider` enables third-party tool catalog integration (e.g., Composio, Arcade AI):
32
+
33
+ ```ts
34
+ import type { ToolProvider } from '@mastra/core/tool-provider';
35
+
36
+ # Providers implement: listToolkits(), listTools(), getToolSchema(), resolveTools()
37
+ ```
38
+
39
+ `resolveTools()` receives `requestContext` from the current request, enabling per-user API keys and credentials in multi-tenant setups:
40
+
41
+ ```ts
42
+ const tools = await provider.resolveTools(slugs, configs, {
43
+ requestContext: { apiKey: 'user-specific-key', userId: 'tenant-123' },
44
+ });
45
+ ```
46
+
47
+ **Tool Selection Semantics**
48
+
49
+ Both `mcpClients` and `integrationTools` on stored agents follow consistent three-state selection:
50
+ - `{ tools: undefined }` — provider registered, no tools selected
51
+ - `{ tools: {} }` — all tools from provider included
52
+ - `{ tools: { 'TOOL_SLUG': { description: '...' } } }` — specific tools with optional overrides
53
+
54
+ - Updated dependencies [[`7ef618f`](https://github.com/mastra-ai/mastra/commit/7ef618f3c49c27e2f6b27d7f564c557c0734325b), [`b373564`](https://github.com/mastra-ai/mastra/commit/b37356491d43b4d53067f10cb669abaf2502f218), [`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), [`eb36bd8`](https://github.com/mastra-ai/mastra/commit/eb36bd8c52fcd6ec9674ac3b7a6412405b5983e1), [`3cbf121`](https://github.com/mastra-ai/mastra/commit/3cbf121f55418141924754a83102aade89835947)]:
55
+ - @mastra/core@0.0.0-workflow-timeout-issue-20260213181535
56
+
57
+ ## 1.3.0
58
+
59
+ ### Minor Changes
60
+
61
+ - **Updated storage adapters for generic storage domain API** ([#12846](https://github.com/mastra-ai/mastra/pull/12846))
62
+
63
+ 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.
64
+
65
+ Added `scorer-definitions` domain support to all adapters.
66
+
67
+ **Before:**
68
+
69
+ ```ts
70
+ const store = storage.getStore('agents');
71
+ await store.createAgent({ agent: input });
72
+ await store.getAgentById({ id: 'abc' });
73
+ await store.deleteAgent({ id: 'abc' });
74
+ ```
75
+
76
+ **After:**
77
+
78
+ ```ts
79
+ const store = storage.getStore('agents');
80
+ await store.create({ agent: input });
81
+ await store.getById('abc');
82
+ await store.delete('abc');
83
+ ```
84
+
85
+ ### Patch Changes
86
+
87
+ - Fixed observational memory progress bars resetting to zero after agent responses finish. ([#12934](https://github.com/mastra-ai/mastra/pull/12934))
88
+
89
+ - Fixed issues with stored agents ([#12790](https://github.com/mastra-ai/mastra/pull/12790))
90
+
91
+ - 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))
92
+
93
+ - 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))
94
+
95
+ - 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)]:
96
+ - @mastra/core@1.3.0
97
+
98
+ ## 1.3.0-alpha.1
99
+
100
+ ### Patch Changes
101
+
102
+ - 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))
103
+
104
+ - Updated dependencies [[`b31c922`](https://github.com/mastra-ai/mastra/commit/b31c922215b513791d98feaea1b98784aa00803a)]:
105
+ - @mastra/core@1.3.0-alpha.2
106
+
107
+ ## 1.3.0-alpha.0
108
+
109
+ ### Minor Changes
110
+
111
+ - **Updated storage adapters for generic storage domain API** ([#12846](https://github.com/mastra-ai/mastra/pull/12846))
112
+
113
+ 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.
114
+
115
+ Added `scorer-definitions` domain support to all adapters.
116
+
117
+ **Before:**
118
+
119
+ ```ts
120
+ const store = storage.getStore('agents');
121
+ await store.createAgent({ agent: input });
122
+ await store.getAgentById({ id: 'abc' });
123
+ await store.deleteAgent({ id: 'abc' });
124
+ ```
125
+
126
+ **After:**
127
+
128
+ ```ts
129
+ const store = storage.getStore('agents');
130
+ await store.create({ agent: input });
131
+ await store.getById('abc');
132
+ await store.delete('abc');
133
+ ```
134
+
135
+ ### Patch Changes
136
+
137
+ - Fixed issues with stored agents ([#12790](https://github.com/mastra-ai/mastra/pull/12790))
138
+
139
+ - **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))
140
+
141
+ **Default settings:**
142
+ - `observation.bufferTokens: 0.2` — buffer every 20% of `messageTokens` (~6k tokens with the default 30k threshold)
143
+ - `observation.bufferActivation: 0.8` — on activation, retain 20% of the message window
144
+ - `reflection.bufferActivation: 0.5` — start background reflection at 50% of the observation threshold
145
+
146
+ **Disabling async buffering:**
147
+
148
+ Set `observation.bufferTokens: false` to disable async buffering for both observations and reflections:
149
+
150
+ ```ts
151
+ const memory = new Memory({
152
+ options: {
153
+ observationalMemory: {
154
+ model: 'google/gemini-2.5-flash',
155
+ observation: {
156
+ bufferTokens: false,
157
+ },
158
+ },
159
+ },
160
+ });
161
+ ```
162
+
163
+ **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:
164
+
165
+ ```ts
166
+ // Uses default model (google/gemini-2.5-flash)
167
+ observationalMemory: true
168
+
169
+ // Explicit model
170
+ observationalMemory: {
171
+ model: "google/gemini-2.5-flash",
172
+ }
173
+ ```
174
+
175
+ **`shareTokenBudget` requires `bufferTokens: false`** (temporary limitation). If you use `shareTokenBudget: true`, you must explicitly disable async buffering:
176
+
177
+ ```ts
178
+ observationalMemory: {
179
+ model: "google/gemini-2.5-flash",
180
+ shareTokenBudget: true,
181
+ observation: { bufferTokens: false },
182
+ }
183
+ ```
184
+
185
+ **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.
186
+
187
+ **Buffering markers:** New `data-om-buffering-start`, `data-om-buffering-end`, and `data-om-buffering-failed` streaming events for UI feedback during background operations.
188
+
189
+ - 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))
190
+
191
+ - 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)]:
192
+ - @mastra/core@1.3.0-alpha.1
193
+
194
+ ## 1.2.0
195
+
196
+ ### Minor Changes
197
+
198
+ - 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))
199
+
200
+ **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.
201
+
202
+ **Usage:**
203
+
204
+ ```ts
205
+ import { Memory } from '@mastra/memory';
206
+ import { PostgresStore } from '@mastra/pg';
207
+
208
+ const memory = new Memory({
209
+ storage: new PostgresStore({ connectionString: process.env.DATABASE_URL }),
210
+ options: {
211
+ observationalMemory: true,
212
+ },
213
+ });
214
+
215
+ const agent = new Agent({
216
+ name: 'my-agent',
217
+ model: openai('gpt-4o'),
218
+ memory,
219
+ });
220
+ ```
221
+
222
+ **What's new:**
223
+ - `observationalMemory: true` enables the three-tier memory system (recent messages → observations → reflections)
224
+ - Thread-scoped (per-conversation) and resource-scoped (shared across all threads for a user) modes
225
+ - Manual `observe()` API for triggering observation outside the normal agent loop
226
+ - New OM storage methods for pg, libsql, and mongodb adapters (conditionally enabled)
227
+ - `Agent.findProcessor()` method for looking up processors by ID
228
+ - `processorStates` for persisting processor state across loop iterations
229
+ - Abort signal propagation to processors
230
+ - `ProcessorStreamWriter` for custom stream events from processors
231
+
232
+ ### Patch Changes
233
+
234
+ - Created @mastra/editor package for managing and resolving stored agent configurations ([#12631](https://github.com/mastra-ai/mastra/pull/12631))
235
+
236
+ 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.
237
+
238
+ **Key Features:**
239
+ - **Agent Storage & Retrieval**: Store complete agent configurations including instructions, model settings, tools, workflows, nested agents, scorers, processors, and memory configuration
240
+ - **Version Management**: Create and manage multiple versions of agents, with support for activating specific versions
241
+ - **Dependency Resolution**: Automatically resolves and instantiates all agent dependencies (tools, workflows, sub-agents, etc.) from the Mastra registry
242
+ - **Caching**: Built-in caching for improved performance when repeatedly accessing stored agents
243
+ - **Type Safety**: Full TypeScript support with proper typing for stored configurations
244
+
245
+ **Usage Example:**
246
+
247
+ ```typescript
248
+ import { MastraEditor } from '@mastra/editor';
249
+ import { Mastra } from '@mastra/core';
250
+
251
+ // Initialize editor with Mastra
252
+ const mastra = new Mastra({
253
+ /* config */
254
+ editor: new MastraEditor(),
255
+ });
256
+
257
+ // Store an agent configuration
258
+ const agentId = await mastra.storage.stores?.agents?.createAgent({
259
+ name: 'customer-support',
260
+ instructions: 'Help customers with inquiries',
261
+ model: { provider: 'openai', name: 'gpt-4' },
262
+ tools: ['search-kb', 'create-ticket'],
263
+ workflows: ['escalation-flow'],
264
+ memory: { vector: 'pinecone-db' },
265
+ });
266
+
267
+ // Retrieve and use the stored agent
268
+ const agent = await mastra.getEditor()?.getStoredAgentById(agentId);
269
+ const response = await agent?.generate('How do I reset my password?');
270
+
271
+ // List all stored agents
272
+ const agents = await mastra.getEditor()?.listStoredAgents({ pageSize: 10 });
273
+ ```
274
+
275
+ **Storage Improvements:**
276
+ - Fixed JSONB handling in LibSQL, PostgreSQL, and MongoDB adapters
277
+ - Improved agent resolution queries to properly merge version data
278
+ - Enhanced type safety for serialized configurations
279
+
280
+ - 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)]:
281
+ - @mastra/core@1.2.0
282
+
283
+ ## 1.2.0-alpha.0
284
+
285
+ ### Minor Changes
286
+
287
+ - 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))
288
+
289
+ **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.
290
+
291
+ **Usage:**
292
+
293
+ ```ts
294
+ import { Memory } from '@mastra/memory';
295
+ import { PostgresStore } from '@mastra/pg';
296
+
297
+ const memory = new Memory({
298
+ storage: new PostgresStore({ connectionString: process.env.DATABASE_URL }),
299
+ options: {
300
+ observationalMemory: true,
301
+ },
302
+ });
303
+
304
+ const agent = new Agent({
305
+ name: 'my-agent',
306
+ model: openai('gpt-4o'),
307
+ memory,
308
+ });
309
+ ```
310
+
311
+ **What's new:**
312
+ - `observationalMemory: true` enables the three-tier memory system (recent messages → observations → reflections)
313
+ - Thread-scoped (per-conversation) and resource-scoped (shared across all threads for a user) modes
314
+ - Manual `observe()` API for triggering observation outside the normal agent loop
315
+ - New OM storage methods for pg, libsql, and mongodb adapters (conditionally enabled)
316
+ - `Agent.findProcessor()` method for looking up processors by ID
317
+ - `processorStates` for persisting processor state across loop iterations
318
+ - Abort signal propagation to processors
319
+ - `ProcessorStreamWriter` for custom stream events from processors
320
+
321
+ ### Patch Changes
322
+
323
+ - Created @mastra/editor package for managing and resolving stored agent configurations ([#12631](https://github.com/mastra-ai/mastra/pull/12631))
324
+
325
+ 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.
326
+
327
+ **Key Features:**
328
+ - **Agent Storage & Retrieval**: Store complete agent configurations including instructions, model settings, tools, workflows, nested agents, scorers, processors, and memory configuration
329
+ - **Version Management**: Create and manage multiple versions of agents, with support for activating specific versions
330
+ - **Dependency Resolution**: Automatically resolves and instantiates all agent dependencies (tools, workflows, sub-agents, etc.) from the Mastra registry
331
+ - **Caching**: Built-in caching for improved performance when repeatedly accessing stored agents
332
+ - **Type Safety**: Full TypeScript support with proper typing for stored configurations
333
+
334
+ **Usage Example:**
335
+
336
+ ```typescript
337
+ import { MastraEditor } from '@mastra/editor';
338
+ import { Mastra } from '@mastra/core';
339
+
340
+ // Initialize editor with Mastra
341
+ const mastra = new Mastra({
342
+ /* config */
343
+ editor: new MastraEditor(),
344
+ });
345
+
346
+ // Store an agent configuration
347
+ const agentId = await mastra.storage.stores?.agents?.createAgent({
348
+ name: 'customer-support',
349
+ instructions: 'Help customers with inquiries',
350
+ model: { provider: 'openai', name: 'gpt-4' },
351
+ tools: ['search-kb', 'create-ticket'],
352
+ workflows: ['escalation-flow'],
353
+ memory: { vector: 'pinecone-db' },
354
+ });
355
+
356
+ // Retrieve and use the stored agent
357
+ const agent = await mastra.getEditor()?.getStoredAgentById(agentId);
358
+ const response = await agent?.generate('How do I reset my password?');
359
+
360
+ // List all stored agents
361
+ const agents = await mastra.getEditor()?.listStoredAgents({ pageSize: 10 });
362
+ ```
363
+
364
+ **Storage Improvements:**
365
+ - Fixed JSONB handling in LibSQL, PostgreSQL, and MongoDB adapters
366
+ - Improved agent resolution queries to properly merge version data
367
+ - Enhanced type safety for serialized configurations
368
+
369
+ - 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)]:
370
+ - @mastra/core@1.2.0-alpha.1
371
+
372
+ ## 1.1.0
373
+
374
+ ### Minor Changes
375
+
376
+ - Restructured stored agents to use a thin metadata record with versioned configuration snapshots. ([#12488](https://github.com/mastra-ai/mastra/pull/12488))
377
+
378
+ 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.
379
+
380
+ **Key changes:**
381
+ - Stored Agent records are now thin metadata-only (StorageAgentType)
382
+ - All config lives in version snapshots (StorageAgentSnapshotType)
383
+ - New resolved type (StorageResolvedAgentType) merges agent record + active version config
384
+ - Renamed `ownerId` to `authorId` for multi-tenant filtering
385
+ - Changed `memory` field type from `string` to `Record<string, unknown>`
386
+ - Added `status` field ('draft' | 'published') to agent records
387
+ - Flattened CreateAgent/UpdateAgent input types (config fields at top level, no nested snapshot)
388
+ - Version config columns are top-level in the agent_versions table (no single snapshot jsonb column)
389
+ - List endpoints return resolved agents (thin record + active version config)
390
+ - Auto-versioning on update with retention limits and race condition handling
391
+
392
+ - Added dynamic agent management with CRUD operations and version tracking ([#12038](https://github.com/mastra-ai/mastra/pull/12038))
393
+
394
+ **New Features:**
395
+ - Create, edit, and delete agents directly from the Mastra Studio UI
396
+ - Full version history for agents with compare and restore capabilities
397
+ - Visual diff viewer to compare agent configurations across versions
398
+ - Agent creation modal with comprehensive configuration options (model selection, instructions, tools, workflows, sub-agents, memory)
399
+ - AI-powered instruction enhancement
400
+
401
+ **Storage:**
402
+ - New storage interfaces for stored agents and agent versions
403
+ - PostgreSQL, LibSQL, and MongoDB implementations included
404
+ - In-memory storage for development and testing
405
+
406
+ **API:**
407
+ - RESTful endpoints for agent CRUD operations
408
+ - Version management endpoints (create, list, activate, restore, delete, compare)
409
+ - Automatic versioning on agent updates when enabled
410
+
411
+ **Client SDK:**
412
+ - JavaScript client with full support for stored agents and versions
413
+ - Type-safe methods for all CRUD and version operations
414
+
415
+ **Usage Example:**
416
+
417
+ ```typescript
418
+ // Server-side: Configure storage
419
+ import { Mastra } from '@mastra/core';
420
+ import { PgAgentsStorage } from '@mastra/pg';
421
+
422
+ const mastra = new Mastra({
423
+ agents: { agentOne },
424
+ storage: {
425
+ agents: new PgAgentsStorage({
426
+ connectionString: process.env.DATABASE_URL,
427
+ }),
428
+ },
429
+ });
430
+
431
+ // Client-side: Use the SDK
432
+ import { MastraClient } from '@mastra/client-js';
433
+
434
+ const client = new MastraClient({ baseUrl: 'http://localhost:3000' });
435
+
436
+ // Create a stored agent
437
+ const agent = await client.createStoredAgent({
438
+ name: 'Customer Support Agent',
439
+ description: 'Handles customer inquiries',
440
+ model: { provider: 'ANTHROPIC', name: 'claude-sonnet-4-5' },
441
+ instructions: 'You are a helpful customer support agent...',
442
+ tools: ['search', 'email'],
443
+ });
444
+
445
+ // Create a version snapshot
446
+ await client.storedAgent(agent.id).createVersion({
447
+ name: 'v1.0 - Initial release',
448
+ changeMessage: 'First production version',
449
+ });
450
+
451
+ // Compare versions
452
+ const diff = await client.storedAgent(agent.id).compareVersions('version-1', 'version-2');
453
+ ```
454
+
455
+ **Why:**
456
+ 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.
457
+
458
+ - 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))
459
+
460
+ ### Patch Changes
461
+
462
+ - Stored agent edits no longer fail silently. PATCH requests now save changes correctly. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
463
+
464
+ - 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))
465
+
466
+ - 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)]:
467
+ - @mastra/core@1.1.0
468
+
469
+ ## 1.1.0-alpha.2
470
+
471
+ ### Patch Changes
472
+
473
+ - Stored agent edits no longer fail silently. PATCH requests now save changes correctly. ([#12504](https://github.com/mastra-ai/mastra/pull/12504))
474
+
475
+ - 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))
476
+
477
+ - Updated dependencies:
478
+ - @mastra/core@1.1.0-alpha.2
479
+
480
+ ## 1.1.0-alpha.1
481
+
482
+ ### Minor Changes
483
+
484
+ - Restructured stored agents to use a thin metadata record with versioned configuration snapshots. ([#12488](https://github.com/mastra-ai/mastra/pull/12488))
485
+
486
+ 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.
487
+
488
+ **Key changes:**
489
+ - Stored Agent records are now thin metadata-only (StorageAgentType)
490
+ - All config lives in version snapshots (StorageAgentSnapshotType)
491
+ - New resolved type (StorageResolvedAgentType) merges agent record + active version config
492
+ - Renamed `ownerId` to `authorId` for multi-tenant filtering
493
+ - Changed `memory` field type from `string` to `Record<string, unknown>`
494
+ - Added `status` field ('draft' | 'published') to agent records
495
+ - Flattened CreateAgent/UpdateAgent input types (config fields at top level, no nested snapshot)
496
+ - Version config columns are top-level in the agent_versions table (no single snapshot jsonb column)
497
+ - List endpoints return resolved agents (thin record + active version config)
498
+ - Auto-versioning on update with retention limits and race condition handling
499
+
500
+ ### Patch Changes
501
+
502
+ - 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)]:
503
+ - @mastra/core@1.1.0-alpha.1
504
+
505
+ ## 1.1.0-alpha.0
506
+
507
+ ### Minor Changes
508
+
509
+ - Added dynamic agent management with CRUD operations and version tracking ([#12038](https://github.com/mastra-ai/mastra/pull/12038))
510
+
511
+ **New Features:**
512
+ - Create, edit, and delete agents directly from the Mastra Studio UI
513
+ - Full version history for agents with compare and restore capabilities
514
+ - Visual diff viewer to compare agent configurations across versions
515
+ - Agent creation modal with comprehensive configuration options (model selection, instructions, tools, workflows, sub-agents, memory)
516
+ - AI-powered instruction enhancement
517
+
518
+ **Storage:**
519
+ - New storage interfaces for stored agents and agent versions
520
+ - PostgreSQL, LibSQL, and MongoDB implementations included
521
+ - In-memory storage for development and testing
522
+
523
+ **API:**
524
+ - RESTful endpoints for agent CRUD operations
525
+ - Version management endpoints (create, list, activate, restore, delete, compare)
526
+ - Automatic versioning on agent updates when enabled
527
+
528
+ **Client SDK:**
529
+ - JavaScript client with full support for stored agents and versions
530
+ - Type-safe methods for all CRUD and version operations
531
+
532
+ **Usage Example:**
533
+
534
+ ```typescript
535
+ // Server-side: Configure storage
536
+ import { Mastra } from '@mastra/core';
537
+ import { PgAgentsStorage } from '@mastra/pg';
538
+
539
+ const mastra = new Mastra({
540
+ agents: { agentOne },
541
+ storage: {
542
+ agents: new PgAgentsStorage({
543
+ connectionString: process.env.DATABASE_URL,
544
+ }),
545
+ },
546
+ });
547
+
548
+ // Client-side: Use the SDK
549
+ import { MastraClient } from '@mastra/client-js';
550
+
551
+ const client = new MastraClient({ baseUrl: 'http://localhost:3000' });
552
+
553
+ // Create a stored agent
554
+ const agent = await client.createStoredAgent({
555
+ name: 'Customer Support Agent',
556
+ description: 'Handles customer inquiries',
557
+ model: { provider: 'ANTHROPIC', name: 'claude-sonnet-4-5' },
558
+ instructions: 'You are a helpful customer support agent...',
559
+ tools: ['search', 'email'],
560
+ });
561
+
562
+ // Create a version snapshot
563
+ await client.storedAgent(agent.id).createVersion({
564
+ name: 'v1.0 - Initial release',
565
+ changeMessage: 'First production version',
566
+ });
567
+
568
+ // Compare versions
569
+ const diff = await client.storedAgent(agent.id).compareVersions('version-1', 'version-2');
570
+ ```
571
+
572
+ **Why:**
573
+ 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.
574
+
575
+ - 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))
576
+
577
+ ### Patch Changes
578
+
579
+ - 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)]:
580
+ - @mastra/core@1.1.0-alpha.0
581
+
582
+ ## 1.0.0
583
+
584
+ ### Major Changes
585
+
586
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
587
+
588
+ - 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))
589
+
590
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
591
+
592
+ - 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))
593
+
594
+ - Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
595
+
596
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
597
+
598
+ **Storage changes:**
599
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
600
+ - All storage implementations support `perPage: false`:
601
+ - Memory: `listMessages()`
602
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
603
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
604
+
605
+ **Memory changes:**
606
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
607
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
608
+
609
+ **Stricter validation:**
610
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
611
+
612
+ **Migration:**
613
+
614
+ ```typescript
615
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
616
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
617
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
618
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
619
+
620
+ // Memory: Replace selectBy with flat parameters
621
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
622
+ + memory.query({ threadId, perPage: 20, include: [...] })
623
+
624
+ // Client SDK
625
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
626
+ + thread.listMessages({ page: 0, perPage: 20 })
627
+ ```
628
+
629
+ - **Removed `storage.getMessages()`** ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
630
+
631
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
632
+
633
+ **Migration:**
634
+
635
+ ```typescript
636
+ // Before
637
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
638
+
639
+ // After
640
+ const result = await storage.listMessages({
641
+ threadId: 'thread-1',
642
+ page: 0,
643
+ perPage: 50,
644
+ });
645
+ const messages = result.messages; // Access messages array
646
+ console.log(result.total); // Total count
647
+ console.log(result.hasMore); // Whether more pages exist
648
+ ```
649
+
650
+ **Message ordering default**
651
+
652
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
653
+
654
+ **To use DESC ordering (newest first):**
655
+
656
+ ```typescript
657
+ const result = await storage.listMessages({
658
+ threadId: 'thread-1',
659
+ orderBy: { field: 'createdAt', direction: 'DESC' },
660
+ });
661
+ ```
662
+
663
+ **Renamed `client.getThreadMessages()` → `client.listThreadMessages()`**
664
+
665
+ **Migration:**
666
+
667
+ ```typescript
668
+ // Before
669
+ const response = await client.getThreadMessages(threadId, { agentId });
670
+
671
+ // After
672
+ const response = await client.listThreadMessages(threadId, { agentId });
673
+ ```
674
+
675
+ The response format remains the same.
676
+
677
+ **Removed `StorageGetMessagesArg` type**
678
+
679
+ Use `StorageListMessagesInput` instead:
680
+
681
+ ```typescript
682
+ // Before
683
+ import type { StorageGetMessagesArg } from '@mastra/core';
684
+
685
+ // After
686
+ import type { StorageListMessagesInput } from '@mastra/core';
687
+ ```
688
+
689
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
690
+
691
+ - 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))
692
+
693
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
694
+
695
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
696
+
697
+ - 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))
698
+
699
+ - 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))
700
+
701
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
702
+
703
+ - Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
704
+
705
+ 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.
706
+
707
+ **Affected APIs:**
708
+ - `Memory.listThreadsByResourceId()`
709
+ - `Memory.listMessages()`
710
+ - `Storage.listWorkflowRuns()`
711
+
712
+ **Migration:**
713
+
714
+ ```typescript
715
+ // Before
716
+ await memory.listThreadsByResourceId({
717
+ resourceId: 'user-123',
718
+ offset: 20,
719
+ limit: 10,
720
+ });
721
+
722
+ // After
723
+ await memory.listThreadsByResourceId({
724
+ resourceId: 'user-123',
725
+ page: 2, // page = Math.floor(offset / limit)
726
+ perPage: 10,
727
+ });
728
+
729
+ // Before
730
+ await memory.listMessages({
731
+ threadId: 'thread-456',
732
+ offset: 20,
733
+ limit: 10,
734
+ });
735
+
736
+ // After
737
+ await memory.listMessages({
738
+ threadId: 'thread-456',
739
+ page: 2,
740
+ perPage: 10,
741
+ });
742
+
743
+ // Before
744
+ await storage.listWorkflowRuns({
745
+ workflowName: 'my-workflow',
746
+ offset: 20,
747
+ limit: 10,
748
+ });
749
+
750
+ // After
751
+ await storage.listWorkflowRuns({
752
+ workflowName: 'my-workflow',
753
+ page: 2,
754
+ perPage: 10,
755
+ });
756
+ ```
757
+
758
+ **Additional improvements:**
759
+ - Added validation for negative `page` values in all storage implementations
760
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
761
+ - Added reusable query parser utilities for consistent validation in handlers
762
+
763
+ - ```ts ([#9709](https://github.com/mastra-ai/mastra/pull/9709))
764
+ import { Mastra } from '@mastra/core';
765
+ import { Observability } from '@mastra/observability'; // Explicit import
766
+
767
+ const mastra = new Mastra({
768
+ ...other_config,
769
+ observability: new Observability({
770
+ default: { enabled: true },
771
+ }), // Instance
772
+ });
773
+ ```
774
+
775
+ Instead of:
776
+
777
+ ```ts
778
+ import { Mastra } from '@mastra/core';
779
+ import '@mastra/observability/init'; // Explicit import
780
+
781
+ const mastra = new Mastra({
782
+ ...other_config,
783
+ observability: {
784
+ default: { enabled: true },
785
+ },
786
+ });
787
+ ```
788
+
789
+ Also renamed a bunch of:
790
+ - `Tracing` things to `Observability` things.
791
+ - `AI-` things to just things.
792
+
793
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
794
+
795
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
796
+
797
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
798
+ 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
799
+
800
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
801
+
802
+ ### Minor Changes
803
+
804
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
805
+
806
+ 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.
807
+
808
+ ```typescript
809
+ import { Mastra } from '@mastra/core';
810
+ import { LibSQLStore } from '@mastra/libsql';
811
+
812
+ const mastra = new Mastra({
813
+ storage: new LibSQLStore({ url: ':memory:' }),
814
+ tools: { myTool },
815
+ scorers: { myScorer },
816
+ });
817
+
818
+ // Create agent in storage via API or directly
819
+ await mastra.getStorage().createAgent({
820
+ agent: {
821
+ id: 'my-agent',
822
+ name: 'My Agent',
823
+ instructions: 'You are helpful',
824
+ model: { provider: 'openai', name: 'gpt-4' },
825
+ tools: { myTool: {} },
826
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
827
+ },
828
+ });
829
+
830
+ // Load and use the agent
831
+ const agent = await mastra.getStoredAgentById('my-agent');
832
+ const response = await agent.generate('Hello!');
833
+
834
+ // List all stored agents with pagination
835
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
836
+ page: 0,
837
+ perPage: 10,
838
+ });
839
+ ```
840
+
841
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
842
+
843
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
844
+
845
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
846
+
847
+ **Why this change?**
848
+
849
+ 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.
850
+
851
+ **Columns Changed:**
852
+ - `mastra_threads.metadata` - Thread metadata
853
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
854
+
855
+ **PostgreSQL**
856
+
857
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
858
+
859
+ ```sql
860
+ ALTER TABLE mastra_threads
861
+ ALTER COLUMN metadata TYPE jsonb
862
+ USING metadata::jsonb;
863
+
864
+ ALTER TABLE mastra_workflow_snapshot
865
+ ALTER COLUMN snapshot TYPE jsonb
866
+ USING snapshot::jsonb;
867
+ ```
868
+
869
+ **LibSQL**
870
+
871
+ 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:
872
+ - Existing TEXT JSON data continues to work
873
+ - New data is stored in binary JSONB format
874
+ - Both formats can coexist in the same table
875
+ - All JSON functions (`json_extract`, etc.) work on both formats
876
+
877
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
878
+
879
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
880
+
881
+ 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.
882
+
883
+ **Key changes:**
884
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
885
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
886
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
887
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
888
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
889
+
890
+ **Why this matters:**
891
+
892
+ This enables composite storage where you can use different database adapters per domain:
893
+
894
+ ```typescript
895
+ import { Mastra } from '@mastra/core';
896
+ import { PostgresStore } from '@mastra/pg';
897
+ import { ClickhouseStore } from '@mastra/clickhouse';
898
+
899
+ // Use Postgres for most domains but Clickhouse for observability
900
+ const mastra = new Mastra({
901
+ storage: new PostgresStore({
902
+ connectionString: 'postgres://...',
903
+ }),
904
+ // Future: override specific domains
905
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
906
+ });
907
+ ```
908
+
909
+ **Standalone domain usage:**
910
+
911
+ Domains can now be used independently with flexible configuration:
912
+
913
+ ```typescript
914
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
915
+
916
+ // Option 1: Pass config to create client internally
917
+ const memory = new MemoryLibSQL({
918
+ url: 'file:./local.db',
919
+ });
920
+
921
+ // Option 2: Pass existing client for shared connections
922
+ import { createClient } from '@libsql/client';
923
+ const client = createClient({ url: 'file:./local.db' });
924
+ const memory = new MemoryLibSQL({ client });
925
+ ```
926
+
927
+ **Breaking changes:**
928
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
929
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
930
+
931
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
932
+
933
+ ### Summary
934
+
935
+ 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.
936
+
937
+ ### Migration Guide
938
+
939
+ All direct method calls on storage instances should be updated to use `getStore()`:
940
+
941
+ ```typescript
942
+ // Before
943
+ const thread = await storage.getThreadById({ threadId });
944
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
945
+ await storage.createSpan(span);
946
+
947
+ // After
948
+ const memory = await storage.getStore('memory');
949
+ const thread = await memory?.getThreadById({ threadId });
950
+
951
+ const workflows = await storage.getStore('workflows');
952
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
953
+
954
+ const observability = await storage.getStore('observability');
955
+ await observability?.createSpan(span);
956
+ ```
957
+
958
+ ### Available Domains
959
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
960
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
961
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
962
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
963
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
964
+
965
+ ### Breaking Changes
966
+ - Passthrough methods have been removed from `MastraStorage` base class
967
+ - All storage adapters now require accessing domains via `getStore()`
968
+ - The `stores` property on storage instances is now the canonical way to access domain storage
969
+
970
+ ### Internal Changes
971
+ - Each storage adapter now initializes domain-specific stores in its constructor
972
+ - Domain stores share database connections and handle their own table initialization
973
+
974
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
975
+
976
+ ## What changed
977
+
978
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
979
+
980
+ **Before:**
981
+
982
+ ```typescript
983
+ // Old span structure
984
+ span.agentId; // 'my-agent'
985
+ span.toolId; // undefined
986
+ span.workflowId; // undefined
987
+ ```
988
+
989
+ **After:**
990
+
991
+ ```typescript
992
+ // New span structure
993
+ span.entityType; // EntityType.AGENT
994
+ span.entityId; // 'my-agent'
995
+ span.entityName; // 'My Agent'
996
+ ```
997
+
998
+ ## New `listTraces()` API
999
+
1000
+ Query traces with filtering, pagination, and sorting:
1001
+
1002
+ ```typescript
1003
+ const { spans, pagination } = await storage.listTraces({
1004
+ filters: {
1005
+ entityType: EntityType.AGENT,
1006
+ entityId: 'my-agent',
1007
+ userId: 'user-123',
1008
+ environment: 'production',
1009
+ status: TraceStatus.SUCCESS,
1010
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1011
+ },
1012
+ pagination: { page: 0, perPage: 50 },
1013
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1014
+ });
1015
+ ```
1016
+
1017
+ **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`.
1018
+
1019
+ ## New retrieval methods
1020
+ - `getSpan({ traceId, spanId })` - Get a single span
1021
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1022
+ - `getTrace({ traceId })` - Get all spans for a trace
1023
+
1024
+ ## Backward compatibility
1025
+
1026
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1027
+
1028
+ ## Migration
1029
+
1030
+ **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`.
1031
+
1032
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1033
+
1034
+ - 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))
1035
+
1036
+ **Why this change?**
1037
+
1038
+ 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.
1039
+
1040
+ **@mastra/libsql** (Breaking)
1041
+
1042
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
1043
+
1044
+ ```typescript
1045
+ // Before
1046
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
1047
+
1048
+ // After
1049
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
1050
+ ```
1051
+
1052
+ **@mastra/opensearch** (Breaking)
1053
+
1054
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
1055
+
1056
+ ```typescript
1057
+ // Before
1058
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
1059
+
1060
+ // After
1061
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
1062
+
1063
+ // With authentication (now possible)
1064
+ new OpenSearchVector({
1065
+ id: 'my-vector',
1066
+ node: 'https://localhost:9200',
1067
+ auth: { username: 'admin', password: 'admin' },
1068
+ ssl: { rejectUnauthorized: false },
1069
+ });
1070
+ ```
1071
+
1072
+ **@mastra/pinecone** (Breaking)
1073
+
1074
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
1075
+
1076
+ ```typescript
1077
+ // Before
1078
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
1079
+
1080
+ // After
1081
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
1082
+
1083
+ // With custom controller host (if needed)
1084
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
1085
+ ```
1086
+
1087
+ **@mastra/clickhouse**
1088
+
1089
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
1090
+
1091
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
1092
+
1093
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
1094
+
1095
+ **@mastra/deployer-cloud**
1096
+
1097
+ Updated internal LibSQLVector configuration for compatibility with the new API.
1098
+
1099
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
1100
+
1101
+ 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.
1102
+
1103
+ ```typescript
1104
+ // CI/CD script - run migrations
1105
+ const storage = new PostgresStore({
1106
+ connectionString: DATABASE_URL,
1107
+ id: 'pg-storage',
1108
+ });
1109
+ await storage.init();
1110
+
1111
+ // Runtime - skip auto-init
1112
+ const storage = new PostgresStore({
1113
+ connectionString: DATABASE_URL,
1114
+ id: 'pg-storage',
1115
+ disableInit: true,
1116
+ });
1117
+ ```
1118
+
1119
+ ### Patch Changes
1120
+
1121
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
1122
+
1123
+ 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`.
1124
+
1125
+ Each package includes:
1126
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
1127
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
1128
+ - **Topic folders** - Conceptual documentation organized by feature area
1129
+
1130
+ 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.
1131
+
1132
+ - 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))
1133
+
1134
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
1135
+
1136
+ **What Changed**
1137
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
1138
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
1139
+
1140
+ **Impact**
1141
+ 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.
1142
+
1143
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
1144
+
1145
+ - - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
1146
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
1147
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
1148
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
1149
+
1150
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
1151
+
1152
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
1153
+
1154
+ **Before:**
1155
+
1156
+ ```typescript
1157
+ const result = await workflow.execute({ input });
1158
+ if (result.status === 'failed') {
1159
+ // Custom error properties were lost
1160
+ console.log(result.error); // "Step execution failed" (just a string)
1161
+ }
1162
+ ```
1163
+
1164
+ **After:**
1165
+
1166
+ ```typescript
1167
+ const result = await workflow.execute({ input });
1168
+ if (result.status === 'failed') {
1169
+ // Custom properties are preserved
1170
+ console.log(result.error.message); // "Step execution failed"
1171
+ console.log(result.error.statusCode); // 429
1172
+ console.log(result.error.cause?.name); // "RateLimitError"
1173
+ }
1174
+ ```
1175
+
1176
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
1177
+
1178
+ Other changes:
1179
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
1180
+
1181
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
1182
+
1183
+ **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.
1184
+
1185
+ **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.
1186
+
1187
+ **Example:**
1188
+
1189
+ ```typescript
1190
+ // Get first page
1191
+ const page1 = await memory.recall({
1192
+ threadId: 'thread-123',
1193
+ perPage: 10,
1194
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1195
+ });
1196
+
1197
+ // Get next page using cursor-based pagination
1198
+ const oldestMessage = page1.messages[page1.messages.length - 1];
1199
+ const page2 = await memory.recall({
1200
+ threadId: 'thread-123',
1201
+ perPage: 10,
1202
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1203
+ filter: {
1204
+ dateRange: {
1205
+ end: oldestMessage.createdAt,
1206
+ endExclusive: true, // Excludes the cursor message
1207
+ },
1208
+ },
1209
+ });
1210
+ ```
1211
+
1212
+ - 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))
1213
+
1214
+ **Deduplication rules (in priority order):**
1215
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
1216
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
1217
+ 3. Use `createdAt` as the final tiebreaker
1218
+
1219
+ **What changed:**
1220
+ - Added `migrateSpans()` method to observability stores for manual migration
1221
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
1222
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
1223
+
1224
+ **Usage example:**
1225
+
1226
+ ```typescript
1227
+ const observability = await storage.getStore('observability');
1228
+ const status = await observability.checkSpansMigrationStatus();
1229
+ if (status.needsMigration) {
1230
+ const result = await observability.migrateSpans();
1231
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
1232
+ }
1233
+ ```
1234
+
1235
+ Fixes #11840
1236
+
1237
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
1238
+
1239
+ `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.
1240
+
1241
+ ```typescript
1242
+ import { MastraStorage } from '@mastra/core/storage';
1243
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
1244
+ import { MemoryLibSQL } from '@mastra/libsql';
1245
+
1246
+ // Compose domains from different stores
1247
+ const storage = new MastraStorage({
1248
+ id: 'composite',
1249
+ domains: {
1250
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
1251
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
1252
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
1253
+ },
1254
+ });
1255
+ ```
1256
+
1257
+ **Breaking changes:**
1258
+ - `storage.supports` property no longer exists
1259
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
1260
+
1261
+ All stores now support the same features. For domain availability, use `getStore()`:
1262
+
1263
+ ```typescript
1264
+ const store = await storage.getStore('memory');
1265
+ if (store) {
1266
+ // domain is available
1267
+ }
1268
+ ```
1269
+
1270
+ - - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()` ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
1271
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
1272
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
1273
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
1274
+
1275
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
1276
+
1277
+ ```typescript
1278
+ await workflow.deleteWorkflowRunById(runId);
1279
+ ```
1280
+
1281
+ - 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))
1282
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
1283
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
1284
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
1285
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
1286
+
1287
+ 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.
1288
+
1289
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
1290
+
1291
+ **New Features**
1292
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
1293
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
1294
+ - Full pagination and sorting support
1295
+
1296
+ **Example Usage**
1297
+
1298
+ ```typescript
1299
+ // List all threads
1300
+ const allThreads = await memory.listThreads({});
1301
+
1302
+ // Filter by resourceId only
1303
+ const userThreads = await memory.listThreads({
1304
+ filter: { resourceId: 'user-123' },
1305
+ });
1306
+
1307
+ // Filter by metadata only
1308
+ const supportThreads = await memory.listThreads({
1309
+ filter: { metadata: { category: 'support' } },
1310
+ });
1311
+
1312
+ // Filter by both with pagination
1313
+ const filteredThreads = await memory.listThreads({
1314
+ filter: {
1315
+ resourceId: 'user-123',
1316
+ metadata: { priority: 'high', status: 'open' },
1317
+ },
1318
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
1319
+ page: 0,
1320
+ perPage: 20,
1321
+ });
1322
+ ```
1323
+
1324
+ **Security Improvements**
1325
+ - Added validation to prevent SQL injection via malicious metadata keys
1326
+ - Added pagination parameter validation to prevent integer overflow attacks
1327
+
1328
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
1329
+ Add status filter to `listWorkflowRuns`
1330
+ Add automatic restart to restart active workflow runs when server starts
1331
+
1332
+ - 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))
1333
+
1334
+ **Migration:**
1335
+
1336
+ Update your imports and usage:
1337
+
1338
+ ```typescript
1339
+ // Before
1340
+ import { MastraStorage } from '@mastra/core/storage';
1341
+
1342
+ const storage = new MastraStorage({
1343
+ id: 'composite',
1344
+ domains: { ... }
1345
+ });
1346
+
1347
+ // After
1348
+ import { MastraCompositeStore } from '@mastra/core/storage';
1349
+
1350
+ const storage = new MastraCompositeStore({
1351
+ id: 'composite',
1352
+ domains: { ... }
1353
+ });
1354
+ ```
1355
+
1356
+ 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.
1357
+
1358
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
1359
+
1360
+ ```typescript
1361
+ // Clone a thread
1362
+ const { thread, clonedMessages } = await memory.cloneThread({
1363
+ sourceThreadId: 'thread-123',
1364
+ title: 'My Clone',
1365
+ options: {
1366
+ messageLimit: 10, // optional: only copy last N messages
1367
+ },
1368
+ });
1369
+
1370
+ // Check if a thread is a clone
1371
+ if (memory.isClone(thread)) {
1372
+ const source = await memory.getSourceThread(thread.id);
1373
+ }
1374
+
1375
+ // List all clones of a thread
1376
+ const clones = await memory.listClones('thread-123');
1377
+ ```
1378
+
1379
+ Includes:
1380
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
1381
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
1382
+ - Embeddings created for cloned messages (semantic recall)
1383
+ - Clone button in playground UI Memory tab
1384
+
1385
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
1386
+
1387
+ **What changed**
1388
+
1389
+ 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.
1390
+
1391
+ **Example**
1392
+
1393
+ ```typescript
1394
+ import { createClient } from '@clickhouse/client';
1395
+ import { ClickhouseStore } from '@mastra/clickhouse';
1396
+
1397
+ // Create and configure client with custom settings
1398
+ const client = createClient({
1399
+ url: 'http://localhost:8123',
1400
+ username: 'default',
1401
+ password: '',
1402
+ request_timeout: 60000,
1403
+ });
1404
+
1405
+ // Pass pre-configured client to store
1406
+ const store = new ClickhouseStore({
1407
+ id: 'my-store',
1408
+ client,
1409
+ });
1410
+ ```
1411
+
1412
+ **Additional improvements**
1413
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
1414
+
1415
+ - 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)]:
1416
+ - @mastra/core@1.0.0
1417
+
1418
+ ## 1.0.0-beta.14
1419
+
1420
+ ### Patch Changes
1421
+
1422
+ - 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))
1423
+
1424
+ **Deduplication rules (in priority order):**
1425
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
1426
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
1427
+ 3. Use `createdAt` as the final tiebreaker
1428
+
1429
+ **What changed:**
1430
+ - Added `migrateSpans()` method to observability stores for manual migration
1431
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
1432
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
1433
+
1434
+ **Usage example:**
1435
+
1436
+ ```typescript
1437
+ const observability = await storage.getStore('observability');
1438
+ const status = await observability.checkSpansMigrationStatus();
1439
+ if (status.needsMigration) {
1440
+ const result = await observability.migrateSpans();
1441
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
1442
+ }
1443
+ ```
1444
+
1445
+ Fixes #11840
1446
+
1447
+ - 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))
1448
+
1449
+ **Migration:**
1450
+
1451
+ Update your imports and usage:
1452
+
1453
+ ```typescript
1454
+ // Before
1455
+ import { MastraStorage } from '@mastra/core/storage';
1456
+
1457
+ const storage = new MastraStorage({
1458
+ id: 'composite',
1459
+ domains: { ... }
1460
+ });
1461
+
1462
+ // After
1463
+ import { MastraCompositeStore } from '@mastra/core/storage';
1464
+
1465
+ const storage = new MastraCompositeStore({
1466
+ id: 'composite',
1467
+ domains: { ... }
1468
+ });
1469
+ ```
1470
+
1471
+ 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.
1472
+
1473
+ - Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897)]:
1474
+ - @mastra/core@1.0.0-beta.26
1475
+
1476
+ ## 1.0.0-beta.13
1477
+
1478
+ ### Patch Changes
1479
+
1480
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
1481
+
1482
+ **New Features**
1483
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
1484
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
1485
+ - Full pagination and sorting support
1486
+
1487
+ **Example Usage**
1488
+
1489
+ ```typescript
1490
+ // List all threads
1491
+ const allThreads = await memory.listThreads({});
1492
+
1493
+ // Filter by resourceId only
1494
+ const userThreads = await memory.listThreads({
1495
+ filter: { resourceId: 'user-123' },
1496
+ });
1497
+
1498
+ // Filter by metadata only
1499
+ const supportThreads = await memory.listThreads({
1500
+ filter: { metadata: { category: 'support' } },
1501
+ });
1502
+
1503
+ // Filter by both with pagination
1504
+ const filteredThreads = await memory.listThreads({
1505
+ filter: {
1506
+ resourceId: 'user-123',
1507
+ metadata: { priority: 'high', status: 'open' },
1508
+ },
1509
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
1510
+ page: 0,
1511
+ perPage: 20,
1512
+ });
1513
+ ```
1514
+
1515
+ **Security Improvements**
1516
+ - Added validation to prevent SQL injection via malicious metadata keys
1517
+ - Added pagination parameter validation to prevent integer overflow attacks
1518
+
1519
+ - 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)]:
1520
+ - @mastra/core@1.0.0-beta.25
1521
+
1522
+ ## 1.0.0-beta.12
1523
+
1524
+ ### Minor Changes
1525
+
1526
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
1527
+
1528
+ **Why this change?**
1529
+
1530
+ 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.
1531
+
1532
+ **Columns Changed:**
1533
+ - `mastra_threads.metadata` - Thread metadata
1534
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
1535
+
1536
+ **PostgreSQL**
1537
+
1538
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
1539
+
1540
+ ```sql
1541
+ ALTER TABLE mastra_threads
1542
+ ALTER COLUMN metadata TYPE jsonb
1543
+ USING metadata::jsonb;
1544
+
1545
+ ALTER TABLE mastra_workflow_snapshot
1546
+ ALTER COLUMN snapshot TYPE jsonb
1547
+ USING snapshot::jsonb;
1548
+ ```
1549
+
1550
+ **LibSQL**
1551
+
1552
+ 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:
1553
+ - Existing TEXT JSON data continues to work
1554
+ - New data is stored in binary JSONB format
1555
+ - Both formats can coexist in the same table
1556
+ - All JSON functions (`json_extract`, etc.) work on both formats
1557
+
1558
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
1559
+
1560
+ - 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))
1561
+
1562
+ **Why this change?**
1563
+
1564
+ 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.
1565
+
1566
+ **@mastra/libsql** (Breaking)
1567
+
1568
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
1569
+
1570
+ ```typescript
1571
+ // Before
1572
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
1573
+
1574
+ // After
1575
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
1576
+ ```
1577
+
1578
+ **@mastra/opensearch** (Breaking)
1579
+
1580
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
1581
+
1582
+ ```typescript
1583
+ // Before
1584
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
1585
+
1586
+ // After
1587
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
1588
+
1589
+ // With authentication (now possible)
1590
+ new OpenSearchVector({
1591
+ id: 'my-vector',
1592
+ node: 'https://localhost:9200',
1593
+ auth: { username: 'admin', password: 'admin' },
1594
+ ssl: { rejectUnauthorized: false },
1595
+ });
1596
+ ```
1597
+
1598
+ **@mastra/pinecone** (Breaking)
1599
+
1600
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
1601
+
1602
+ ```typescript
1603
+ // Before
1604
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
1605
+
1606
+ // After
1607
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
1608
+
1609
+ // With custom controller host (if needed)
1610
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
1611
+ ```
1612
+
1613
+ **@mastra/clickhouse**
1614
+
1615
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
1616
+
1617
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
1618
+
1619
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
1620
+
1621
+ **@mastra/deployer-cloud**
1622
+
1623
+ Updated internal LibSQLVector configuration for compatibility with the new API.
1624
+
1625
+ ### Patch Changes
1626
+
1627
+ - 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)]:
1628
+ - @mastra/core@1.0.0-beta.22
1629
+
1630
+ ## 1.0.0-beta.11
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
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
1646
+
1647
+ **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.
1648
+
1649
+ **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.
1650
+
1651
+ **Example:**
1652
+
1653
+ ```typescript
1654
+ // Get first page
1655
+ const page1 = await memory.recall({
1656
+ threadId: 'thread-123',
1657
+ perPage: 10,
1658
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1659
+ });
1660
+
1661
+ // Get next page using cursor-based pagination
1662
+ const oldestMessage = page1.messages[page1.messages.length - 1];
1663
+ const page2 = await memory.recall({
1664
+ threadId: 'thread-123',
1665
+ perPage: 10,
1666
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1667
+ filter: {
1668
+ dateRange: {
1669
+ end: oldestMessage.createdAt,
1670
+ endExclusive: true, // Excludes the cursor message
1671
+ },
1672
+ },
1673
+ });
1674
+ ```
1675
+
1676
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
1677
+
1678
+ ```typescript
1679
+ // Clone a thread
1680
+ const { thread, clonedMessages } = await memory.cloneThread({
1681
+ sourceThreadId: 'thread-123',
1682
+ title: 'My Clone',
1683
+ options: {
1684
+ messageLimit: 10, // optional: only copy last N messages
1685
+ },
1686
+ });
1687
+
1688
+ // Check if a thread is a clone
1689
+ if (memory.isClone(thread)) {
1690
+ const source = await memory.getSourceThread(thread.id);
1691
+ }
1692
+
1693
+ // List all clones of a thread
1694
+ const clones = await memory.listClones('thread-123');
1695
+ ```
1696
+
1697
+ Includes:
1698
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
1699
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
1700
+ - Embeddings created for cloned messages (semantic recall)
1701
+ - Clone button in playground UI Memory tab
1702
+
1703
+ - 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)]:
1704
+ - @mastra/core@1.0.0-beta.20
1705
+
1706
+ ## 1.0.0-beta.10
1707
+
1708
+ ### Patch Changes
1709
+
1710
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
1711
+
1712
+ `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.
1713
+
1714
+ ```typescript
1715
+ import { MastraStorage } from '@mastra/core/storage';
1716
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
1717
+ import { MemoryLibSQL } from '@mastra/libsql';
1718
+
1719
+ // Compose domains from different stores
1720
+ const storage = new MastraStorage({
1721
+ id: 'composite',
1722
+ domains: {
1723
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
1724
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
1725
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
1726
+ },
1727
+ });
1728
+ ```
1729
+
1730
+ **Breaking changes:**
1731
+ - `storage.supports` property no longer exists
1732
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
1733
+
1734
+ All stores now support the same features. For domain availability, use `getStore()`:
1735
+
1736
+ ```typescript
1737
+ const store = await storage.getStore('memory');
1738
+ if (store) {
1739
+ // domain is available
1740
+ }
1741
+ ```
1742
+
1743
+ - 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)]:
1744
+ - @mastra/core@1.0.0-beta.16
1745
+
1746
+ ## 1.0.0-beta.9
1747
+
1748
+ ### Minor Changes
1749
+
1750
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
1751
+
1752
+ 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.
1753
+
1754
+ **Key changes:**
1755
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
1756
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
1757
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
1758
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
1759
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
1760
+
1761
+ **Why this matters:**
1762
+
1763
+ This enables composite storage where you can use different database adapters per domain:
1764
+
1765
+ ```typescript
1766
+ import { Mastra } from '@mastra/core';
1767
+ import { PostgresStore } from '@mastra/pg';
1768
+ import { ClickhouseStore } from '@mastra/clickhouse';
1769
+
1770
+ // Use Postgres for most domains but Clickhouse for observability
1771
+ const mastra = new Mastra({
1772
+ storage: new PostgresStore({
1773
+ connectionString: 'postgres://...',
1774
+ }),
1775
+ // Future: override specific domains
1776
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
1777
+ });
1778
+ ```
1779
+
1780
+ **Standalone domain usage:**
1781
+
1782
+ Domains can now be used independently with flexible configuration:
1783
+
1784
+ ```typescript
1785
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
1786
+
1787
+ // Option 1: Pass config to create client internally
1788
+ const memory = new MemoryLibSQL({
1789
+ url: 'file:./local.db',
1790
+ });
1791
+
1792
+ // Option 2: Pass existing client for shared connections
1793
+ import { createClient } from '@libsql/client';
1794
+ const client = createClient({ url: 'file:./local.db' });
1795
+ const memory = new MemoryLibSQL({ client });
1796
+ ```
1797
+
1798
+ **Breaking changes:**
1799
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
1800
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
1801
+
1802
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
1803
+
1804
+ ### Summary
1805
+
1806
+ 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.
1807
+
1808
+ ### Migration Guide
1809
+
1810
+ All direct method calls on storage instances should be updated to use `getStore()`:
1811
+
1812
+ ```typescript
1813
+ // Before
1814
+ const thread = await storage.getThreadById({ threadId });
1815
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1816
+ await storage.createSpan(span);
1817
+
1818
+ // After
1819
+ const memory = await storage.getStore('memory');
1820
+ const thread = await memory?.getThreadById({ threadId });
1821
+
1822
+ const workflows = await storage.getStore('workflows');
1823
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1824
+
1825
+ const observability = await storage.getStore('observability');
1826
+ await observability?.createSpan(span);
1827
+ ```
1828
+
1829
+ ### Available Domains
1830
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
1831
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
1832
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
1833
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
1834
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
1835
+
1836
+ ### Breaking Changes
1837
+ - Passthrough methods have been removed from `MastraStorage` base class
1838
+ - All storage adapters now require accessing domains via `getStore()`
1839
+ - The `stores` property on storage instances is now the canonical way to access domain storage
1840
+
1841
+ ### Internal Changes
1842
+ - Each storage adapter now initializes domain-specific stores in its constructor
1843
+ - Domain stores share database connections and handle their own table initialization
1844
+
1845
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
1846
+
1847
+ ## What changed
1848
+
1849
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
1850
+
1851
+ **Before:**
1852
+
1853
+ ```typescript
1854
+ // Old span structure
1855
+ span.agentId; // 'my-agent'
1856
+ span.toolId; // undefined
1857
+ span.workflowId; // undefined
1858
+ ```
1859
+
1860
+ **After:**
1861
+
1862
+ ```typescript
1863
+ // New span structure
1864
+ span.entityType; // EntityType.AGENT
1865
+ span.entityId; // 'my-agent'
1866
+ span.entityName; // 'My Agent'
1867
+ ```
1868
+
1869
+ ## New `listTraces()` API
1870
+
1871
+ Query traces with filtering, pagination, and sorting:
1872
+
1873
+ ```typescript
1874
+ const { spans, pagination } = await storage.listTraces({
1875
+ filters: {
1876
+ entityType: EntityType.AGENT,
1877
+ entityId: 'my-agent',
1878
+ userId: 'user-123',
1879
+ environment: 'production',
1880
+ status: TraceStatus.SUCCESS,
1881
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1882
+ },
1883
+ pagination: { page: 0, perPage: 50 },
1884
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1885
+ });
1886
+ ```
1887
+
1888
+ **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`.
1889
+
1890
+ ## New retrieval methods
1891
+ - `getSpan({ traceId, spanId })` - Get a single span
1892
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1893
+ - `getTrace({ traceId })` - Get all spans for a trace
1894
+
1895
+ ## Backward compatibility
1896
+
1897
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1898
+
1899
+ ## Migration
1900
+
1901
+ **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`.
1902
+
1903
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1904
+
1905
+ ### Patch Changes
1906
+
1907
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
1908
+
1909
+ **What changed**
1910
+
1911
+ 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.
1912
+
1913
+ **Example**
1914
+
1915
+ ```typescript
1916
+ import { createClient } from '@clickhouse/client';
1917
+ import { ClickhouseStore } from '@mastra/clickhouse';
1918
+
1919
+ // Create and configure client with custom settings
1920
+ const client = createClient({
1921
+ url: 'http://localhost:8123',
1922
+ username: 'default',
1923
+ password: '',
1924
+ request_timeout: 60000,
1925
+ });
1926
+
1927
+ // Pass pre-configured client to store
1928
+ const store = new ClickhouseStore({
1929
+ id: 'my-store',
1930
+ client,
1931
+ });
1932
+ ```
1933
+
1934
+ **Additional improvements**
1935
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
1936
+
1937
+ - 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)]:
1938
+ - @mastra/core@1.0.0-beta.15
1939
+
1940
+ ## 1.0.0-beta.8
1941
+
1942
+ ### Patch Changes
1943
+
1944
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
1945
+
1946
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
1947
+
1948
+ **Before:**
1949
+
1950
+ ```typescript
1951
+ const result = await workflow.execute({ input });
1952
+ if (result.status === 'failed') {
1953
+ // Custom error properties were lost
1954
+ console.log(result.error); // "Step execution failed" (just a string)
1955
+ }
1956
+ ```
1957
+
1958
+ **After:**
1959
+
1960
+ ```typescript
1961
+ const result = await workflow.execute({ input });
1962
+ if (result.status === 'failed') {
1963
+ // Custom properties are preserved
1964
+ console.log(result.error.message); // "Step execution failed"
1965
+ console.log(result.error.statusCode); // 429
1966
+ console.log(result.error.cause?.name); // "RateLimitError"
1967
+ }
1968
+ ```
1969
+
1970
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
1971
+
1972
+ Other changes:
1973
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
1974
+
1975
+ - fix: make getSqlType consistent across storage adapters ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
1976
+ - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()`
1977
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
1978
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
1979
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
1980
+
1981
+ - 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)]:
1982
+ - @mastra/core@1.0.0-beta.12
1983
+
1984
+ ## 1.0.0-beta.7
1985
+
1986
+ ### Patch Changes
1987
+
1988
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
1989
+
1990
+ ```typescript
1991
+ await workflow.deleteWorkflowRunById(runId);
1992
+ ```
1993
+
1994
+ - 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)]:
1995
+ - @mastra/core@1.0.0-beta.10
1996
+
1997
+ ## 1.0.0-beta.6
1998
+
1999
+ ### Minor Changes
2000
+
2001
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
2002
+
2003
+ 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.
2004
+
2005
+ ```typescript
2006
+ import { Mastra } from '@mastra/core';
2007
+ import { LibSQLStore } from '@mastra/libsql';
2008
+
2009
+ const mastra = new Mastra({
2010
+ storage: new LibSQLStore({ url: ':memory:' }),
2011
+ tools: { myTool },
2012
+ scorers: { myScorer },
2013
+ });
2014
+
2015
+ // Create agent in storage via API or directly
2016
+ await mastra.getStorage().createAgent({
2017
+ agent: {
2018
+ id: 'my-agent',
2019
+ name: 'My Agent',
2020
+ instructions: 'You are helpful',
2021
+ model: { provider: 'openai', name: 'gpt-4' },
2022
+ tools: { myTool: {} },
2023
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
2024
+ },
2025
+ });
2026
+
2027
+ // Load and use the agent
2028
+ const agent = await mastra.getStoredAgentById('my-agent');
2029
+ const response = await agent.generate({ messages: 'Hello!' });
2030
+
2031
+ // List all stored agents with pagination
2032
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
2033
+ page: 0,
2034
+ perPage: 10,
2035
+ });
2036
+ ```
2037
+
2038
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
2039
+
2040
+ ### Patch Changes
2041
+
2042
+ - 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)]:
2043
+ - @mastra/core@1.0.0-beta.9
2044
+
2045
+ ## 1.0.0-beta.5
2046
+
2047
+ ### Patch Changes
2048
+
2049
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
2050
+
2051
+ **What Changed**
2052
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
2053
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
2054
+
2055
+ **Impact**
2056
+ 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.
2057
+
2058
+ - 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)]:
2059
+ - @mastra/core@1.0.0-beta.8
2060
+
2061
+ ## 1.0.0-beta.4
2062
+
2063
+ ### Minor Changes
2064
+
2065
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
2066
+
2067
+ 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.
2068
+
2069
+ ```typescript
2070
+ // CI/CD script - run migrations
2071
+ const storage = new PostgresStore({
2072
+ connectionString: DATABASE_URL,
2073
+ id: 'pg-storage',
2074
+ });
2075
+ await storage.init();
2076
+
2077
+ // Runtime - skip auto-init
2078
+ const storage = new PostgresStore({
2079
+ connectionString: DATABASE_URL,
2080
+ id: 'pg-storage',
2081
+ disableInit: true,
2082
+ });
2083
+ ```
2084
+
2085
+ ### Patch Changes
2086
+
2087
+ - 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))
2088
+
2089
+ - 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)]:
2090
+ - @mastra/core@1.0.0-beta.7
2091
+
2092
+ ## 1.0.0-beta.3
2093
+
2094
+ ### Patch Changes
2095
+
2096
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
2097
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
2098
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
2099
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
2100
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
2101
+
2102
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
2103
+
2104
+ 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:
2105
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
2106
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
2107
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
2108
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
2109
+
2110
+ 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.
2111
+
2112
+ - 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)]:
2113
+ - @mastra/core@1.0.0-beta.6
2114
+
2115
+ ## 1.0.0-beta.2
2116
+
2117
+ ### Patch Changes
2118
+
2119
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
2120
+
2121
+ - 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)]:
2122
+ - @mastra/core@1.0.0-beta.5
2123
+
2124
+ ## 1.0.0-beta.1
2125
+
2126
+ ### Patch Changes
2127
+
2128
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
2129
+ Add status filter to `listWorkflowRuns`
2130
+ Add automatic restart to restart active workflow runs when server starts
2131
+ - 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)]:
2132
+ - @mastra/core@1.0.0-beta.3
2133
+
2134
+ ## 1.0.0-beta.0
2135
+
2136
+ ### Major Changes
2137
+
2138
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
2139
+
2140
+ - 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))
2141
+
2142
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
2143
+
2144
+ - 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))
2145
+
2146
+ - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
2147
+
2148
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
2149
+
2150
+ **Storage changes:**
2151
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
2152
+ - All storage implementations support `perPage: false`:
2153
+ - Memory: `listMessages()`
2154
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
2155
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
2156
+
2157
+ **Memory changes:**
2158
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
2159
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
2160
+
2161
+ **Stricter validation:**
2162
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
2163
+
2164
+ **Migration:**
2165
+
2166
+ ```typescript
2167
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
2168
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
2169
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
2170
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
2171
+
2172
+ // Memory: Replace selectBy with flat parameters
2173
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
2174
+ + memory.query({ threadId, perPage: 20, include: [...] })
2175
+
2176
+ // Client SDK
2177
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
2178
+ + thread.listMessages({ page: 0, perPage: 20 })
2179
+ ```
2180
+
2181
+ - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
2182
+
2183
+ ## Storage Layer
2184
+
2185
+ ### BREAKING: Removed `storage.getMessages()`
2186
+
2187
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
2188
+
2189
+ **Migration:**
2190
+
2191
+ ```typescript
2192
+ // Before
2193
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
2194
+
2195
+ // After
2196
+ const result = await storage.listMessages({
2197
+ threadId: 'thread-1',
2198
+ page: 0,
2199
+ perPage: 50,
2200
+ });
2201
+ const messages = result.messages; // Access messages array
2202
+ console.log(result.total); // Total count
2203
+ console.log(result.hasMore); // Whether more pages exist
2204
+ ```
2205
+
2206
+ ### Message ordering default
2207
+
2208
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
2209
+
2210
+ **To use DESC ordering (newest first):**
2211
+
2212
+ ```typescript
2213
+ const result = await storage.listMessages({
2214
+ threadId: 'thread-1',
2215
+ orderBy: { field: 'createdAt', direction: 'DESC' },
2216
+ });
2217
+ ```
2218
+
2219
+ ## Client SDK
2220
+
2221
+ ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
2222
+
2223
+ **Migration:**
2224
+
2225
+ ```typescript
2226
+ // Before
2227
+ const response = await client.getThreadMessages(threadId, { agentId });
2228
+
2229
+ // After
2230
+ const response = await client.listThreadMessages(threadId, { agentId });
2231
+ ```
2232
+
2233
+ The response format remains the same.
2234
+
2235
+ ## Type Changes
2236
+
2237
+ ### BREAKING: Removed `StorageGetMessagesArg` type
2238
+
2239
+ Use `StorageListMessagesInput` instead:
2240
+
2241
+ ```typescript
2242
+ // Before
2243
+ import type { StorageGetMessagesArg } from '@mastra/core';
2244
+
2245
+ // After
2246
+ import type { StorageListMessagesInput } from '@mastra/core';
2247
+ ```
2248
+
2249
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
2250
+
2251
+ - 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))
2252
+
2253
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
2254
+
2255
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
2256
+
2257
+ - 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))
2258
+
2259
+ - 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))
2260
+
2261
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
2262
+
2263
+ - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
2264
+
2265
+ 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.
2266
+
2267
+ **Affected APIs:**
2268
+ - `Memory.listThreadsByResourceId()`
2269
+ - `Memory.listMessages()`
2270
+ - `Storage.listWorkflowRuns()`
2271
+
2272
+ **Migration:**
2273
+
2274
+ ```typescript
2275
+ // Before
2276
+ await memory.listThreadsByResourceId({
2277
+ resourceId: 'user-123',
2278
+ offset: 20,
2279
+ limit: 10,
2280
+ });
2281
+
2282
+ // After
2283
+ await memory.listThreadsByResourceId({
2284
+ resourceId: 'user-123',
2285
+ page: 2, // page = Math.floor(offset / limit)
2286
+ perPage: 10,
2287
+ });
2288
+
2289
+ // Before
2290
+ await memory.listMessages({
2291
+ threadId: 'thread-456',
2292
+ offset: 20,
2293
+ limit: 10,
2294
+ });
2295
+
2296
+ // After
2297
+ await memory.listMessages({
2298
+ threadId: 'thread-456',
2299
+ page: 2,
2300
+ perPage: 10,
2301
+ });
2302
+
2303
+ // Before
2304
+ await storage.listWorkflowRuns({
2305
+ workflowName: 'my-workflow',
2306
+ offset: 20,
2307
+ limit: 10,
2308
+ });
2309
+
2310
+ // After
2311
+ await storage.listWorkflowRuns({
2312
+ workflowName: 'my-workflow',
2313
+ page: 2,
2314
+ perPage: 10,
2315
+ });
2316
+ ```
2317
+
2318
+ **Additional improvements:**
2319
+ - Added validation for negative `page` values in all storage implementations
2320
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
2321
+ - Added reusable query parser utilities for consistent validation in handlers
2322
+
2323
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
2324
+ import { Mastra } from '@mastra/core';
2325
+ import { Observability } from '@mastra/observability'; // Explicit import
2326
+
2327
+ const mastra = new Mastra({
2328
+ ...other_config,
2329
+ observability: new Observability({
2330
+ default: { enabled: true }
2331
+ }) // Instance
2332
+ });
2333
+ ```
2334
+
2335
+ Instead of:
2336
+
2337
+ ```
2338
+ import { Mastra } from '@mastra/core';
2339
+ import '@mastra/observability/init'; // Explicit import
2340
+
2341
+ const mastra = new Mastra({
2342
+ ...other_config,
2343
+ observability: {
2344
+ default: { enabled: true }
2345
+ }
2346
+ });
2347
+ ```
2348
+
2349
+ Also renamed a bunch of:
2350
+ - `Tracing` things to `Observability` things.
2351
+ - `AI-` things to just things.
2352
+
2353
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
2354
+
2355
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
2356
+
2357
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
2358
+ 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
2359
+
2360
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
2361
+
2362
+ ### Minor Changes
2363
+
2364
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
2365
+
2366
+ ### Patch Changes
2367
+
2368
+ - 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)]:
2369
+ - @mastra/core@1.0.0-beta.0
2370
+
2371
+ ## 0.16.0
2372
+
2373
+ ### Minor Changes
2374
+
2375
+ - Update peer dependencies to match core package version bump (0.21.2) ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2376
+
2377
+ ### Patch Changes
2378
+
2379
+ - Support for custom resume labels mapping to step to be resumed ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2380
+
2381
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
2382
+
2383
+ - 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)]:
2384
+ - @mastra/core@0.22.0
2385
+
2386
+ ## 0.16.0-alpha.1
2387
+
2388
+ ### Patch Changes
2389
+
2390
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
2391
+
2392
+ - 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)]:
2393
+ - @mastra/core@0.22.0-alpha.1
2394
+
2395
+ ## 0.16.0-alpha.0
2396
+
2397
+ ### Minor Changes
2398
+
2399
+ - Update peer dependencies to match core package version bump (0.21.2) ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2400
+
2401
+ ### Patch Changes
2402
+
2403
+ - Support for custom resume labels mapping to step to be resumed ([#8941](https://github.com/mastra-ai/mastra/pull/8941))
2404
+
2405
+ - 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)]:
2406
+ - @mastra/core@0.21.2-alpha.0
2407
+
2408
+ ## 0.15.2
2409
+
2410
+ ### Patch Changes
2411
+
2412
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8619](https://github.com/mastra-ai/mastra/pull/8619))
2413
+
2414
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
2415
+
2416
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
2417
+
2418
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
2419
+
2420
+ - 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)]:
2421
+ - @mastra/core@0.21.0
2422
+
2423
+ ## 0.15.2-alpha.0
2424
+
2425
+ ### Patch Changes
2426
+
2427
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8619](https://github.com/mastra-ai/mastra/pull/8619))
2428
+
2429
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
2430
+
2431
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
2432
+
2433
+ - Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
2434
+
2435
+ - 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)]:
2436
+ - @mastra/core@0.21.0-alpha.0
2437
+
2438
+ ## 0.15.1
2439
+
2440
+ ### Patch Changes
2441
+
2442
+ - 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))
2443
+
2444
+ - 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)]:
2445
+ - @mastra/core@0.20.0
2446
+
2447
+ ## 0.15.1-alpha.0
2448
+
2449
+ ### Patch Changes
2450
+
2451
+ - 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))
2452
+
2453
+ - 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)]:
2454
+ - @mastra/core@0.20.0-alpha.0
2455
+
2456
+ ## 0.15.0
2457
+
2458
+ ### Minor Changes
2459
+
2460
+ - Added Postgres and updated libsql storage adapters for ai-traces ([#8027](https://github.com/mastra-ai/mastra/pull/8027))
2461
+
2462
+ ### Patch Changes
2463
+
2464
+ - Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2465
+
2466
+ - Fix incorrect title and import references in README.md ([#8288](https://github.com/mastra-ai/mastra/pull/8288))
2467
+
2468
+ Fixed the package title from '@mastra/pg' to '@mastra/libsql' and corrected the import statement in the Storage usage example.
2469
+
2470
+ - Libsql get scores by span ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2471
+
2472
+ - 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)]:
2473
+ - @mastra/core@0.19.0
2474
+
2475
+ ## 0.15.0-alpha.0
2476
+
2477
+ ### Minor Changes
2478
+
2479
+ - Added Postgres and updated libsql storage adapters for ai-traces ([#8027](https://github.com/mastra-ai/mastra/pull/8027))
2480
+
2481
+ ### Patch Changes
2482
+
2483
+ - Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2484
+
2485
+ - Fix incorrect title and import references in README.md ([#8288](https://github.com/mastra-ai/mastra/pull/8288))
2486
+
2487
+ Fixed the package title from '@mastra/pg' to '@mastra/libsql' and corrected the import statement in the Storage usage example.
2488
+
2489
+ - Libsql get scores by span ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
2490
+
2491
+ - 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)]:
2492
+ - @mastra/core@0.19.0-alpha.1
2493
+
2494
+ ## 0.14.3
2495
+
2496
+ ### Patch Changes
2497
+
2498
+ - Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
2499
+
2500
+ - 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)]:
2501
+ - @mastra/core@0.18.0
2502
+
2503
+ ## 0.14.3-alpha.0
2504
+
2505
+ ### Patch Changes
2506
+
2507
+ - Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
2508
+
2509
+ - 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)]:
2510
+ - @mastra/core@0.18.0-alpha.2
2511
+
2512
+ ## 0.14.2
2513
+
2514
+ ### Patch Changes
2515
+
2516
+ - dependencies updates: ([#7742](https://github.com/mastra-ai/mastra/pull/7742))
2517
+ - Updated dependency [`@libsql/client@^0.15.15` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.15) (from `^0.15.14`, in `dependencies`)
2518
+
2519
+ - Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
2520
+
2521
+ - Add resource id to workflow run snapshots ([#7740](https://github.com/mastra-ai/mastra/pull/7740))
2522
+
2523
+ - 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)]:
2524
+ - @mastra/core@0.17.0
2525
+
2526
+ ## 0.14.2-alpha.2
2527
+
2528
+ ### Patch Changes
2529
+
2530
+ - Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
2531
+
2532
+ - 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)]:
2533
+ - @mastra/core@0.17.0-alpha.3
2534
+
2535
+ ## 0.14.2-alpha.1
2536
+
2537
+ ### Patch Changes
2538
+
2539
+ - Add resource id to workflow run snapshots ([#7740](https://github.com/mastra-ai/mastra/pull/7740))
2540
+
2541
+ - Updated dependencies [[`547c621`](https://github.com/mastra-ai/mastra/commit/547c62104af3f7a551b3754e9cbdf0a3fbba15e4)]:
2542
+ - @mastra/core@0.16.4-alpha.1
2543
+
2544
+ ## 0.14.2-alpha.0
2545
+
2546
+ ### Patch Changes
2547
+
2548
+ - dependencies updates: ([#7742](https://github.com/mastra-ai/mastra/pull/7742))
2549
+ - Updated dependency [`@libsql/client@^0.15.15` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.15) (from `^0.15.14`, in `dependencies`)
2550
+ - 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)]:
2551
+ - @mastra/core@0.16.4-alpha.0
2552
+
2553
+ ## 0.14.1
2554
+
2555
+ ### Patch Changes
2556
+
2557
+ - Fix AI Trace bug for libsql ([#7695](https://github.com/mastra-ai/mastra/pull/7695))
2558
+
2559
+ - 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)]:
2560
+ - @mastra/core@0.16.3
2561
+
2562
+ ## 0.14.1-alpha.0
2563
+
2564
+ ### Patch Changes
2565
+
2566
+ - Fix AI Trace bug for libsql ([#7695](https://github.com/mastra-ai/mastra/pull/7695))
2567
+
2568
+ - 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)]:
2569
+ - @mastra/core@0.16.3-alpha.0
2570
+
2571
+ ## 0.14.0
2572
+
2573
+ ### Minor Changes
2574
+
2575
+ - 376913a: Update peerdeps of @mastra/core
2576
+
2577
+ ### Patch Changes
2578
+
2579
+ - 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
2580
+ - Updated dependencies [8fbf79e]
2581
+ - Updated dependencies [fd83526]
2582
+ - Updated dependencies [d0b90ab]
2583
+ - Updated dependencies [6f5eb7a]
2584
+ - Updated dependencies [a01cf14]
2585
+ - Updated dependencies [a9e50ee]
2586
+ - Updated dependencies [5397eb4]
2587
+ - Updated dependencies [c9f4e4a]
2588
+ - Updated dependencies [0acbc80]
2589
+ - @mastra/core@0.16.0
2590
+
2591
+ ## 0.14.0-alpha.1
2592
+
2593
+ ### Minor Changes
2594
+
2595
+ - 376913a: Update peerdeps of @mastra/core
2596
+
2597
+ ### Patch Changes
2598
+
2599
+ - Updated dependencies [8fbf79e]
2600
+ - @mastra/core@0.16.0-alpha.1
2601
+
2602
+ ## 0.13.9-alpha.0
2603
+
2604
+ ### Patch Changes
2605
+
2606
+ - 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
2607
+ - Updated dependencies [fd83526]
2608
+ - Updated dependencies [d0b90ab]
2609
+ - Updated dependencies [6f5eb7a]
2610
+ - Updated dependencies [a01cf14]
2611
+ - Updated dependencies [a9e50ee]
2612
+ - Updated dependencies [5397eb4]
2613
+ - Updated dependencies [c9f4e4a]
2614
+ - Updated dependencies [0acbc80]
2615
+ - @mastra/core@0.16.0-alpha.0
2616
+
2617
+ ## 0.13.8
2618
+
2619
+ ### Patch Changes
2620
+
2621
+ - 8429e4c: dependencies updates:
2622
+ - Updated dependency [`@libsql/client@^0.15.14` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.14) (from `^0.15.12`, in `dependencies`)
2623
+ - de3cbc6: Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
2624
+ - f0dfcac: updated core peerdep
2625
+ - dbc51ef: Fixed dependency issue with new AI_SPAN schema
2626
+ - Updated dependencies [ab48c97]
2627
+ - Updated dependencies [85ef90b]
2628
+ - Updated dependencies [aedbbfa]
2629
+ - Updated dependencies [ff89505]
2630
+ - Updated dependencies [637f323]
2631
+ - Updated dependencies [de3cbc6]
2632
+ - Updated dependencies [c19bcf7]
2633
+ - Updated dependencies [4474d04]
2634
+ - Updated dependencies [183dc95]
2635
+ - Updated dependencies [a1111e2]
2636
+ - Updated dependencies [b42a961]
2637
+ - Updated dependencies [61debef]
2638
+ - Updated dependencies [9beaeff]
2639
+ - Updated dependencies [29de0e1]
2640
+ - Updated dependencies [f643c65]
2641
+ - Updated dependencies [00c74e7]
2642
+ - Updated dependencies [fef7375]
2643
+ - Updated dependencies [e3d8fea]
2644
+ - Updated dependencies [45e4d39]
2645
+ - Updated dependencies [9eee594]
2646
+ - Updated dependencies [7149d8d]
2647
+ - Updated dependencies [822c2e8]
2648
+ - Updated dependencies [979912c]
2649
+ - Updated dependencies [7dcf4c0]
2650
+ - Updated dependencies [4106a58]
2651
+ - Updated dependencies [ad78bfc]
2652
+ - Updated dependencies [0302f50]
2653
+ - Updated dependencies [6ac697e]
2654
+ - Updated dependencies [74db265]
2655
+ - Updated dependencies [0ce418a]
2656
+ - Updated dependencies [af90672]
2657
+ - Updated dependencies [8387952]
2658
+ - Updated dependencies [7f3b8da]
2659
+ - Updated dependencies [905352b]
2660
+ - Updated dependencies [599d04c]
2661
+ - Updated dependencies [56041d0]
2662
+ - Updated dependencies [3412597]
2663
+ - Updated dependencies [5eca5d2]
2664
+ - Updated dependencies [f2cda47]
2665
+ - Updated dependencies [5de1555]
2666
+ - Updated dependencies [cfd377a]
2667
+ - Updated dependencies [1ed5a3e]
2668
+ - @mastra/core@0.15.3
2669
+
2670
+ ## 0.13.8-alpha.3
2671
+
2672
+ ### Patch Changes
2673
+
2674
+ - [#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
2675
+
2676
+ - Updated dependencies [[`7149d8d`](https://github.com/mastra-ai/mastra/commit/7149d8d4bdc1edf0008e0ca9b7925eb0b8b60dbe)]:
2677
+ - @mastra/core@0.15.3-alpha.7
2678
+
2679
+ ## 0.13.8-alpha.2
2680
+
2681
+ ### Patch Changes
2682
+
2683
+ - [#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:
2684
+ - Updated dependency [`@libsql/client@^0.15.14` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.14) (from `^0.15.12`, in `dependencies`)
2685
+ - 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)]:
2686
+ - @mastra/core@0.15.3-alpha.6
2687
+
2688
+ ## 0.13.8-alpha.1
2689
+
2690
+ ### Patch Changes
2691
+
2692
+ - [#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`.
2693
+
2694
+ - Updated dependencies [[`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
2695
+ - @mastra/core@0.15.3-alpha.5
2696
+
2697
+ ## 0.13.8-alpha.0
2698
+
2699
+ ### Patch Changes
2700
+
2701
+ - [#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
2702
+
2703
+ - 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)]:
2704
+ - @mastra/core@0.15.3-alpha.3
2705
+
2706
+ ## 0.13.7
2707
+
2708
+ ### Patch Changes
2709
+
2710
+ - [`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdpes for @mastra/core
2711
+
2712
+ - Updated dependencies []:
2713
+ - @mastra/core@0.15.2
2714
+
2715
+ ## 0.13.6
2716
+
2717
+ ### Patch Changes
2718
+
2719
+ - [`95b2aa9`](https://github.com/mastra-ai/mastra/commit/95b2aa908230919e67efcac0d69005a2d5745298) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdeps @mastra/core
2720
+
2721
+ - Updated dependencies []:
2722
+ - @mastra/core@0.15.1
2723
+
2724
+ ## 0.13.5
2725
+
2726
+ ### Patch Changes
2727
+
2728
+ - [#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
2729
+
2730
+ - [#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
2731
+
2732
+ - 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)]:
2733
+ - @mastra/core@0.15.0
2734
+
2735
+ ## 0.13.5-alpha.0
2736
+
2737
+ ### Patch Changes
2738
+
2739
+ - [#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
2740
+
2741
+ - [#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
2742
+
2743
+ - 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)]:
2744
+ - @mastra/core@0.14.2-alpha.1
2745
+
2746
+ ## 0.13.4
2747
+
2748
+ ### Patch Changes
2749
+
2750
+ - [#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:
2751
+ - Updated dependency [`@libsql/client@^0.15.12` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.12) (from `^0.15.10`, in `dependencies`)
2752
+
2753
+ - [#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
2754
+
2755
+ - 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)]:
2756
+ - @mastra/core@0.14.1
2757
+
2758
+ ## 0.13.4-alpha.0
2759
+
2760
+ ### Patch Changes
2761
+
2762
+ - [#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:
2763
+ - Updated dependency [`@libsql/client@^0.15.12` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.12) (from `^0.15.10`, in `dependencies`)
2764
+
2765
+ - [#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
2766
+
2767
+ - Updated dependencies [[`6e7e120`](https://github.com/mastra-ai/mastra/commit/6e7e1207d6e8d8b838f9024f90bd10df1181ba27), [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02)]:
2768
+ - @mastra/core@0.14.1-alpha.0
2769
+
2770
+ ## 0.13.3
2771
+
2772
+ ### Patch Changes
2773
+
2774
+ - 03997ae: Update peerdeps
2775
+ - d6e39da: Load most recent snapshot from storage
2776
+ - Updated dependencies [227c7e6]
2777
+ - Updated dependencies [12cae67]
2778
+ - Updated dependencies [fd3a3eb]
2779
+ - Updated dependencies [6faaee5]
2780
+ - Updated dependencies [4232b14]
2781
+ - Updated dependencies [a89de7e]
2782
+ - Updated dependencies [5a37d0c]
2783
+ - Updated dependencies [4bde0cb]
2784
+ - Updated dependencies [cf4f357]
2785
+ - Updated dependencies [ad888a2]
2786
+ - Updated dependencies [481751d]
2787
+ - Updated dependencies [2454423]
2788
+ - Updated dependencies [194e395]
2789
+ - Updated dependencies [a722c0b]
2790
+ - Updated dependencies [c30bca8]
2791
+ - Updated dependencies [3b5fec7]
2792
+ - Updated dependencies [a8f129d]
2793
+ - @mastra/core@0.14.0
2794
+
2795
+ ## 0.13.3-alpha.1
2796
+
2797
+ ### Patch Changes
2798
+
2799
+ - 03997ae: Update peerdeps
2800
+ - @mastra/core@0.14.0-alpha.7
2801
+
2802
+ ## 0.13.3-alpha.0
2803
+
2804
+ ### Patch Changes
2805
+
2806
+ - d6e39da: Load most recent snapshot from storage
2807
+ - Updated dependencies [6faaee5]
2808
+ - Updated dependencies [4232b14]
2809
+ - Updated dependencies [a89de7e]
2810
+ - Updated dependencies [cf4f357]
2811
+ - Updated dependencies [a722c0b]
2812
+ - Updated dependencies [3b5fec7]
2813
+ - @mastra/core@0.14.0-alpha.1
2814
+
2815
+ ## 0.13.2
2816
+
2817
+ ### Patch Changes
2818
+
2819
+ - b5cf2a3: make system message always available during agent calls
2820
+ - b32c50d: Filter scores by source
2821
+ - Updated dependencies [d5330bf]
2822
+ - Updated dependencies [2e74797]
2823
+ - Updated dependencies [8388649]
2824
+ - Updated dependencies [a239d41]
2825
+ - Updated dependencies [dd94a26]
2826
+ - Updated dependencies [3ba6772]
2827
+ - Updated dependencies [b5cf2a3]
2828
+ - Updated dependencies [2fff911]
2829
+ - Updated dependencies [b32c50d]
2830
+ - Updated dependencies [63449d0]
2831
+ - Updated dependencies [121a3f8]
2832
+ - Updated dependencies [ec510e7]
2833
+ - @mastra/core@0.13.2
2834
+
2835
+ ## 0.13.2-alpha.1
2836
+
2837
+ ### Patch Changes
2838
+
2839
+ - b5cf2a3: make system message always available during agent calls
2840
+ - Updated dependencies [b5cf2a3]
2841
+ - @mastra/core@0.13.2-alpha.3
2842
+
2843
+ ## 0.13.2-alpha.0
2844
+
2845
+ ### Patch Changes
2846
+
2847
+ - b32c50d: Filter scores by source
2848
+ - Updated dependencies [d5330bf]
2849
+ - Updated dependencies [a239d41]
2850
+ - Updated dependencies [b32c50d]
2851
+ - Updated dependencies [121a3f8]
2852
+ - Updated dependencies [ec510e7]
2853
+ - @mastra/core@0.13.2-alpha.2
2854
+
2855
+ ## 0.13.1
2856
+
2857
+ ### Patch Changes
2858
+
2859
+ - 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
2860
+ - Updated dependencies [cd0042e]
2861
+ - @mastra/core@0.13.1
2862
+
2863
+ ## 0.13.1-alpha.0
2864
+
2865
+ ### Patch Changes
2866
+
2867
+ - 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
2868
+ - Updated dependencies [cd0042e]
2869
+ - @mastra/core@0.13.1-alpha.0
2870
+
2871
+ ## 0.13.0
2872
+
2873
+ ### Minor Changes
2874
+
2875
+ - ea0c5f2: Add store support to new score api
2876
+
2877
+ ### Patch Changes
2878
+
2879
+ - 2871020: update safelyParseJSON to check for value of param when handling parse
2880
+ - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
2881
+ - Updated dependencies [cb36de0]
2882
+ - Updated dependencies [d0496e6]
2883
+ - Updated dependencies [a82b851]
2884
+ - Updated dependencies [ea0c5f2]
2885
+ - Updated dependencies [41a0a0e]
2886
+ - Updated dependencies [2871020]
2887
+ - Updated dependencies [94f4812]
2888
+ - Updated dependencies [e202b82]
2889
+ - Updated dependencies [e00f6a0]
2890
+ - Updated dependencies [4a406ec]
2891
+ - Updated dependencies [b0e43c1]
2892
+ - Updated dependencies [5d377e5]
2893
+ - Updated dependencies [1fb812e]
2894
+ - Updated dependencies [35c5798]
2895
+ - @mastra/core@0.13.0
2896
+
2897
+ ## 0.13.0-alpha.1
2898
+
2899
+ ### Patch Changes
2900
+
2901
+ - 2871020: update safelyParseJSON to check for value of param when handling parse
2902
+ - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
2903
+ - Updated dependencies [cb36de0]
2904
+ - Updated dependencies [a82b851]
2905
+ - Updated dependencies [41a0a0e]
2906
+ - Updated dependencies [2871020]
2907
+ - Updated dependencies [4a406ec]
2908
+ - Updated dependencies [5d377e5]
2909
+ - @mastra/core@0.13.0-alpha.2
2910
+
2911
+ ## 0.13.0-alpha.0
2912
+
2913
+ ### Minor Changes
2914
+
2915
+ - ea0c5f2: Add store support to new score api
2916
+
2917
+ ### Patch Changes
2918
+
2919
+ - Updated dependencies [ea0c5f2]
2920
+ - Updated dependencies [b0e43c1]
2921
+ - Updated dependencies [1fb812e]
2922
+ - Updated dependencies [35c5798]
2923
+ - @mastra/core@0.13.0-alpha.1
2924
+
2925
+ ## 0.12.0
2926
+
2927
+ ### Minor Changes
2928
+
2929
+ - f42c4c2: update peer deps for packages to latest core range
2930
+
2931
+ ### Patch Changes
2932
+
2933
+ - 24ac5ff: dependencies updates:
2934
+ - Updated dependency [`@libsql/client@^0.15.10` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.10) (from `^0.15.9`, in `dependencies`)
2935
+ - ff9c125: enhance thread retrieval with sorting options in libsql and pg
2936
+ - a3ca14c: `LibSQLVector.doUpsert`: check if transaction is open before attempting rollback
2937
+ - b8efbb9: feat: add flexible deleteMessages method to memory API
2938
+ - Added `memory.deleteMessages(input)` method that accepts multiple input types:
2939
+ - Single message ID as string: `deleteMessages('msg-123')`
2940
+ - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
2941
+ - Message object with id property: `deleteMessages({ id: 'msg-123' })`
2942
+ - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
2943
+ - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
2944
+ - Added REST API endpoint: `POST /api/memory/messages/delete`
2945
+ - Updated client SDK: `thread.deleteMessages()` accepts all input types
2946
+ - Updates thread timestamps when messages are deleted
2947
+ - Added comprehensive test coverage and documentation
2948
+
2949
+ - Updated dependencies [510e2c8]
2950
+ - Updated dependencies [2f72fb2]
2951
+ - Updated dependencies [27cc97a]
2952
+ - Updated dependencies [3f89307]
2953
+ - Updated dependencies [9eda7d4]
2954
+ - Updated dependencies [9d49408]
2955
+ - Updated dependencies [41daa63]
2956
+ - Updated dependencies [ad0a58b]
2957
+ - Updated dependencies [254a36b]
2958
+ - Updated dependencies [2ecf658]
2959
+ - Updated dependencies [7a7754f]
2960
+ - Updated dependencies [fc92d80]
2961
+ - Updated dependencies [e0f73c6]
2962
+ - Updated dependencies [0b89602]
2963
+ - Updated dependencies [4d37822]
2964
+ - Updated dependencies [23a6a7c]
2965
+ - Updated dependencies [cda801d]
2966
+ - Updated dependencies [a77c823]
2967
+ - Updated dependencies [ff9c125]
2968
+ - Updated dependencies [09bca64]
2969
+ - Updated dependencies [b8efbb9]
2970
+ - Updated dependencies [71466e7]
2971
+ - Updated dependencies [0c99fbe]
2972
+ - @mastra/core@0.12.0
2973
+
2974
+ ## 0.12.0-alpha.2
2975
+
2976
+ ### Minor Changes
2977
+
2978
+ - f42c4c2: update peer deps for packages to latest core range
2979
+
2980
+ ### Patch Changes
2981
+
2982
+ - @mastra/core@0.12.0-alpha.5
2983
+
2984
+ ## 0.11.3-alpha.1
2985
+
2986
+ ### Patch Changes
2987
+
2988
+ - ff9c125: enhance thread retrieval with sorting options in libsql and pg
2989
+ - b8efbb9: feat: add flexible deleteMessages method to memory API
2990
+ - Added `memory.deleteMessages(input)` method that accepts multiple input types:
2991
+ - Single message ID as string: `deleteMessages('msg-123')`
2992
+ - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
2993
+ - Message object with id property: `deleteMessages({ id: 'msg-123' })`
2994
+ - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
2995
+ - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
2996
+ - Added REST API endpoint: `POST /api/memory/messages/delete`
2997
+ - Updated client SDK: `thread.deleteMessages()` accepts all input types
2998
+ - Updates thread timestamps when messages are deleted
2999
+ - Added comprehensive test coverage and documentation
3000
+
3001
+ - Updated dependencies [27cc97a]
3002
+ - Updated dependencies [41daa63]
3003
+ - Updated dependencies [254a36b]
3004
+ - Updated dependencies [0b89602]
3005
+ - Updated dependencies [4d37822]
3006
+ - Updated dependencies [ff9c125]
3007
+ - Updated dependencies [b8efbb9]
3008
+ - Updated dependencies [71466e7]
3009
+ - Updated dependencies [0c99fbe]
3010
+ - @mastra/core@0.12.0-alpha.2
3011
+
3012
+ ## 0.11.3-alpha.0
3013
+
3014
+ ### Patch Changes
3015
+
3016
+ - 24ac5ff: dependencies updates:
3017
+ - Updated dependency [`@libsql/client@^0.15.10` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.10) (from `^0.15.9`, in `dependencies`)
3018
+ - a3ca14c: `LibSQLVector.doUpsert`: check if transaction is open before attempting rollback
3019
+ - Updated dependencies [510e2c8]
3020
+ - Updated dependencies [2f72fb2]
3021
+ - Updated dependencies [3f89307]
3022
+ - Updated dependencies [9eda7d4]
3023
+ - Updated dependencies [9d49408]
3024
+ - Updated dependencies [2ecf658]
3025
+ - Updated dependencies [7a7754f]
3026
+ - Updated dependencies [fc92d80]
3027
+ - Updated dependencies [23a6a7c]
3028
+ - Updated dependencies [09bca64]
3029
+ - @mastra/core@0.12.0-alpha.0
3030
+
3031
+ ## 0.11.2
3032
+
3033
+ ### Patch Changes
3034
+
3035
+ - 3cc50c7: Update mastra core peer dep version
3036
+ - ce088f5: Update all peerdeps to latest core
3037
+ - @mastra/core@0.11.1
3038
+
3039
+ ## 0.11.1
3040
+
3041
+ ### Patch Changes
3042
+
3043
+ - 7ba91fa: Throw mastra errors methods not implemented yet
3044
+ - da168a4: increase the peer deps range
3045
+ - Updated dependencies [f248d53]
3046
+ - Updated dependencies [2affc57]
3047
+ - Updated dependencies [66e13e3]
3048
+ - Updated dependencies [edd9482]
3049
+ - Updated dependencies [18344d7]
3050
+ - Updated dependencies [9d372c2]
3051
+ - Updated dependencies [40c2525]
3052
+ - Updated dependencies [e473f27]
3053
+ - Updated dependencies [032cb66]
3054
+ - Updated dependencies [703ac71]
3055
+ - Updated dependencies [a723d69]
3056
+ - Updated dependencies [7827943]
3057
+ - Updated dependencies [5889a31]
3058
+ - Updated dependencies [bf1e7e7]
3059
+ - Updated dependencies [65e3395]
3060
+ - Updated dependencies [4933192]
3061
+ - Updated dependencies [d1c77a4]
3062
+ - Updated dependencies [bea9dd1]
3063
+ - Updated dependencies [dcd4802]
3064
+ - Updated dependencies [cbddd18]
3065
+ - Updated dependencies [7ba91fa]
3066
+ - @mastra/core@0.11.0
3067
+
3068
+ ## 0.11.1-alpha.0
3069
+
3070
+ ### Patch Changes
3071
+
3072
+ - 7ba91fa: Throw mastra errors methods not implemented yet
3073
+ - da168a4: increase the peer deps range
3074
+ - Updated dependencies [f248d53]
3075
+ - Updated dependencies [2affc57]
3076
+ - Updated dependencies [66e13e3]
3077
+ - Updated dependencies [edd9482]
3078
+ - Updated dependencies [18344d7]
3079
+ - Updated dependencies [9d372c2]
3080
+ - Updated dependencies [40c2525]
3081
+ - Updated dependencies [e473f27]
3082
+ - Updated dependencies [032cb66]
3083
+ - Updated dependencies [703ac71]
3084
+ - Updated dependencies [a723d69]
3085
+ - Updated dependencies [5889a31]
3086
+ - Updated dependencies [65e3395]
3087
+ - Updated dependencies [4933192]
3088
+ - Updated dependencies [d1c77a4]
3089
+ - Updated dependencies [bea9dd1]
3090
+ - Updated dependencies [dcd4802]
3091
+ - Updated dependencies [7ba91fa]
3092
+ - @mastra/core@0.11.0-alpha.2
3093
+
3094
+ ## 0.11.0
3095
+
3096
+ ### Minor Changes
3097
+
3098
+ - 8a3bfd2: Update peerdeps to latest core
3099
+
3100
+ ### Patch Changes
3101
+
3102
+ - 15e9d26: Added per-resource working memory for LibSQL, Upstash, and PG
3103
+ - 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.
3104
+ - 0fb9d64: [MASTRA-4018] Update saveMessages in storage adapters to upsert messages
3105
+ - 2097952: [MASTRA-4021] Fix PG getMessages and update messageLimit for all storage adapters
3106
+ - 144eb0b: [MASTRA-3669] Metadata Filter Types
3107
+ - f0150c4: Fix LibSQLStore and PgStore getMessagesPaginated implementation
3108
+ - 0e17048: Throw mastra errors in storage packages
3109
+ - Updated dependencies [15e9d26]
3110
+ - Updated dependencies [d1baedb]
3111
+ - Updated dependencies [d8f2d19]
3112
+ - Updated dependencies [4d21bf2]
3113
+ - Updated dependencies [07d6d88]
3114
+ - Updated dependencies [9d52b17]
3115
+ - Updated dependencies [2097952]
3116
+ - Updated dependencies [792c4c0]
3117
+ - Updated dependencies [5d74aab]
3118
+ - Updated dependencies [a8b194f]
3119
+ - Updated dependencies [4fb0cc2]
3120
+ - Updated dependencies [d2a7a31]
3121
+ - Updated dependencies [502fe05]
3122
+ - Updated dependencies [144eb0b]
3123
+ - Updated dependencies [8ba1b51]
3124
+ - Updated dependencies [4efcfa0]
3125
+ - Updated dependencies [0e17048]
3126
+ - @mastra/core@0.10.7
3127
+
3128
+ ## 0.11.0-alpha.3
3129
+
3130
+ ### Minor Changes
3131
+
3132
+ - 8a3bfd2: Update peerdeps to latest core
3133
+
3134
+ ### Patch Changes
3135
+
3136
+ - Updated dependencies [792c4c0]
3137
+ - Updated dependencies [502fe05]
3138
+ - Updated dependencies [4efcfa0]
3139
+ - @mastra/core@0.10.7-alpha.3
3140
+
3141
+ ## 0.10.4-alpha.2
3142
+
3143
+ ### Patch Changes
3144
+
3145
+ - 15e9d26: Added per-resource working memory for LibSQL, Upstash, and PG
3146
+ - 0fb9d64: [MASTRA-4018] Update saveMessages in storage adapters to upsert messages
3147
+ - 144eb0b: [MASTRA-3669] Metadata Filter Types
3148
+ - f0150c4: Fix LibSQLStore and PgStore getMessagesPaginated implementation
3149
+ - Updated dependencies [15e9d26]
3150
+ - Updated dependencies [07d6d88]
3151
+ - Updated dependencies [5d74aab]
3152
+ - Updated dependencies [144eb0b]
3153
+ - @mastra/core@0.10.7-alpha.2
3154
+
3155
+ ## 0.10.4-alpha.1
3156
+
3157
+ ### Patch Changes
3158
+
3159
+ - 2097952: [MASTRA-4021] Fix PG getMessages and update messageLimit for all storage adapters
3160
+ - 0e17048: Throw mastra errors in storage packages
3161
+ - Updated dependencies [d1baedb]
3162
+ - Updated dependencies [4d21bf2]
3163
+ - Updated dependencies [2097952]
3164
+ - Updated dependencies [4fb0cc2]
3165
+ - Updated dependencies [d2a7a31]
3166
+ - Updated dependencies [0e17048]
3167
+ - @mastra/core@0.10.7-alpha.1
3168
+
3169
+ ## 0.10.4-alpha.0
3170
+
3171
+ ### Patch Changes
3172
+
3173
+ - 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.
3174
+ - Updated dependencies [d8f2d19]
3175
+ - Updated dependencies [9d52b17]
3176
+ - Updated dependencies [8ba1b51]
3177
+ - @mastra/core@0.10.7-alpha.0
3178
+
3179
+ ## 0.10.3
4
3180
 
5
3181
  ### Patch Changes
6
3182
 
7
3183
  - 63f6b7d: dependencies updates:
8
3184
  - Updated dependency [`@libsql/client@^0.15.9` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.9) (from `^0.15.8`, in `dependencies`)
9
3185
  - Updated dependencies [63f6b7d]
3186
+ - Updated dependencies [12a95fc]
3187
+ - Updated dependencies [4b0f8a6]
3188
+ - Updated dependencies [51264a5]
3189
+ - Updated dependencies [8e6f677]
3190
+ - Updated dependencies [d70c420]
10
3191
  - Updated dependencies [ee9af57]
11
3192
  - Updated dependencies [36f1c36]
3193
+ - Updated dependencies [2a16996]
12
3194
  - Updated dependencies [10d352e]
13
- - Updated dependencies [3ca9a67]
3195
+ - Updated dependencies [9589624]
14
3196
  - Updated dependencies [53d3c37]
3197
+ - Updated dependencies [751c894]
15
3198
  - Updated dependencies [577ce3a]
16
3199
  - Updated dependencies [9260b3a]
17
- - @mastra/core@0.0.0-workflow-deno-20250616130925
3200
+ - @mastra/core@0.10.6
18
3201
 
19
3202
  ## 0.10.3-alpha.0
20
3203