@mastra/pg 0.0.0-bundle-recursion-20251030002519 → 0.0.0-bundle-version-20260121091645

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 (57) hide show
  1. package/CHANGELOG.md +2092 -4
  2. package/README.md +72 -20
  3. package/dist/docs/README.md +36 -0
  4. package/dist/docs/SKILL.md +37 -0
  5. package/dist/docs/SOURCE_MAP.json +6 -0
  6. package/dist/docs/memory/01-storage.md +233 -0
  7. package/dist/docs/memory/02-working-memory.md +390 -0
  8. package/dist/docs/memory/03-semantic-recall.md +233 -0
  9. package/dist/docs/memory/04-reference.md +133 -0
  10. package/dist/docs/processors/01-reference.md +297 -0
  11. package/dist/docs/rag/01-overview.md +74 -0
  12. package/dist/docs/rag/02-vector-databases.md +643 -0
  13. package/dist/docs/rag/03-retrieval.md +548 -0
  14. package/dist/docs/rag/04-reference.md +369 -0
  15. package/dist/docs/storage/01-reference.md +824 -0
  16. package/dist/docs/tools/01-reference.md +440 -0
  17. package/dist/docs/vectors/01-reference.md +307 -0
  18. package/dist/index.cjs +3834 -2284
  19. package/dist/index.cjs.map +1 -1
  20. package/dist/index.d.ts +1 -1
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +3817 -2272
  23. package/dist/index.js.map +1 -1
  24. package/dist/shared/config.d.ts +122 -31
  25. package/dist/shared/config.d.ts.map +1 -1
  26. package/dist/storage/client.d.ts +91 -0
  27. package/dist/storage/client.d.ts.map +1 -0
  28. package/dist/storage/db/index.d.ts +216 -0
  29. package/dist/storage/db/index.d.ts.map +1 -0
  30. package/dist/storage/domains/agents/index.d.ts +39 -0
  31. package/dist/storage/domains/agents/index.d.ts.map +1 -0
  32. package/dist/storage/domains/memory/index.d.ts +44 -55
  33. package/dist/storage/domains/memory/index.d.ts.map +1 -1
  34. package/dist/storage/domains/observability/index.d.ts +55 -39
  35. package/dist/storage/domains/observability/index.d.ts.map +1 -1
  36. package/dist/storage/domains/scores/index.d.ts +30 -33
  37. package/dist/storage/domains/scores/index.d.ts.map +1 -1
  38. package/dist/storage/domains/utils.d.ts +1 -5
  39. package/dist/storage/domains/utils.d.ts.map +1 -1
  40. package/dist/storage/domains/workflows/index.d.ts +34 -28
  41. package/dist/storage/domains/workflows/index.d.ts.map +1 -1
  42. package/dist/storage/index.d.ts +52 -244
  43. package/dist/storage/index.d.ts.map +1 -1
  44. package/dist/storage/performance-indexes/performance-test.d.ts +3 -1
  45. package/dist/storage/performance-indexes/performance-test.d.ts.map +1 -1
  46. package/dist/storage/test-utils.d.ts.map +1 -1
  47. package/dist/vector/index.d.ts +45 -7
  48. package/dist/vector/index.d.ts.map +1 -1
  49. package/dist/vector/sql-builder.d.ts +4 -0
  50. package/dist/vector/sql-builder.d.ts.map +1 -1
  51. package/dist/vector/types.d.ts +10 -0
  52. package/dist/vector/types.d.ts.map +1 -1
  53. package/package.json +18 -14
  54. package/dist/storage/domains/legacy-evals/index.d.ts +0 -20
  55. package/dist/storage/domains/legacy-evals/index.d.ts.map +0 -1
  56. package/dist/storage/domains/operations/index.d.ts +0 -119
  57. package/dist/storage/domains/operations/index.d.ts.map +0 -1
package/CHANGELOG.md CHANGED
@@ -1,21 +1,2109 @@
1
1
  # @mastra/pg
2
2
 
3
- ## 0.0.0-bundle-recursion-20251030002519
3
+ ## 0.0.0-bundle-version-20260121091645
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`1cf5d2e`](https://github.com/mastra-ai/mastra/commit/1cf5d2ea1b085be23e34fb506c80c80a4e6d9c2b)]:
8
+ - @mastra/core@0.0.0-bundle-version-20260121091645
9
+
10
+ ## 1.0.0
11
+
12
+ ### Major Changes
13
+
14
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
15
+
16
+ - 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))
17
+
18
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
19
+
20
+ - 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))
21
+
22
+ - Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
23
+
24
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
25
+
26
+ **Storage changes:**
27
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
28
+ - All storage implementations support `perPage: false`:
29
+ - Memory: `listMessages()`
30
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
31
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
32
+
33
+ **Memory changes:**
34
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
35
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
36
+
37
+ **Stricter validation:**
38
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
39
+
40
+ **Migration:**
41
+
42
+ ```typescript
43
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
44
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
45
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
46
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
47
+
48
+ // Memory: Replace selectBy with flat parameters
49
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
50
+ + memory.query({ threadId, perPage: 20, include: [...] })
51
+
52
+ // Client SDK
53
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
54
+ + thread.listMessages({ page: 0, perPage: 20 })
55
+ ```
56
+
57
+ - **Removed `storage.getMessages()`** ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
58
+
59
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
60
+
61
+ **Migration:**
62
+
63
+ ```typescript
64
+ // Before
65
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
66
+
67
+ // After
68
+ const result = await storage.listMessages({
69
+ threadId: 'thread-1',
70
+ page: 0,
71
+ perPage: 50,
72
+ });
73
+ const messages = result.messages; // Access messages array
74
+ console.log(result.total); // Total count
75
+ console.log(result.hasMore); // Whether more pages exist
76
+ ```
77
+
78
+ **Message ordering default**
79
+
80
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
81
+
82
+ **To use DESC ordering (newest first):**
83
+
84
+ ```typescript
85
+ const result = await storage.listMessages({
86
+ threadId: 'thread-1',
87
+ orderBy: { field: 'createdAt', direction: 'DESC' },
88
+ });
89
+ ```
90
+
91
+ **Renamed `client.getThreadMessages()` → `client.listThreadMessages()`**
92
+
93
+ **Migration:**
94
+
95
+ ```typescript
96
+ // Before
97
+ const response = await client.getThreadMessages(threadId, { agentId });
98
+
99
+ // After
100
+ const response = await client.listThreadMessages(threadId, { agentId });
101
+ ```
102
+
103
+ The response format remains the same.
104
+
105
+ **Removed `StorageGetMessagesArg` type**
106
+
107
+ Use `StorageListMessagesInput` instead:
108
+
109
+ ```typescript
110
+ // Before
111
+ import type { StorageGetMessagesArg } from '@mastra/core';
112
+
113
+ // After
114
+ import type { StorageListMessagesInput } from '@mastra/core';
115
+ ```
116
+
117
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
118
+
119
+ - 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))
120
+
121
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
122
+
123
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
124
+
125
+ - 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))
126
+
127
+ - 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))
128
+
129
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
130
+
131
+ - Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
132
+
133
+ 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.
134
+
135
+ **Affected APIs:**
136
+ - `Memory.listThreadsByResourceId()`
137
+ - `Memory.listMessages()`
138
+ - `Storage.listWorkflowRuns()`
139
+
140
+ **Migration:**
141
+
142
+ ```typescript
143
+ // Before
144
+ await memory.listThreadsByResourceId({
145
+ resourceId: 'user-123',
146
+ offset: 20,
147
+ limit: 10,
148
+ });
149
+
150
+ // After
151
+ await memory.listThreadsByResourceId({
152
+ resourceId: 'user-123',
153
+ page: 2, // page = Math.floor(offset / limit)
154
+ perPage: 10,
155
+ });
156
+
157
+ // Before
158
+ await memory.listMessages({
159
+ threadId: 'thread-456',
160
+ offset: 20,
161
+ limit: 10,
162
+ });
163
+
164
+ // After
165
+ await memory.listMessages({
166
+ threadId: 'thread-456',
167
+ page: 2,
168
+ perPage: 10,
169
+ });
170
+
171
+ // Before
172
+ await storage.listWorkflowRuns({
173
+ workflowName: 'my-workflow',
174
+ offset: 20,
175
+ limit: 10,
176
+ });
177
+
178
+ // After
179
+ await storage.listWorkflowRuns({
180
+ workflowName: 'my-workflow',
181
+ page: 2,
182
+ perPage: 10,
183
+ });
184
+ ```
185
+
186
+ **Additional improvements:**
187
+ - Added validation for negative `page` values in all storage implementations
188
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
189
+ - Added reusable query parser utilities for consistent validation in handlers
190
+
191
+ - ```ts ([#9709](https://github.com/mastra-ai/mastra/pull/9709))
192
+ import { Mastra } from '@mastra/core';
193
+ import { Observability } from '@mastra/observability'; // Explicit import
194
+
195
+ const mastra = new Mastra({
196
+ ...other_config,
197
+ observability: new Observability({
198
+ default: { enabled: true },
199
+ }), // Instance
200
+ });
201
+ ```
202
+
203
+ Instead of:
204
+
205
+ ```ts
206
+ import { Mastra } from '@mastra/core';
207
+ import '@mastra/observability/init'; // Explicit import
208
+
209
+ const mastra = new Mastra({
210
+ ...other_config,
211
+ observability: {
212
+ default: { enabled: true },
213
+ },
214
+ });
215
+ ```
216
+
217
+ Also renamed a bunch of:
218
+ - `Tracing` things to `Observability` things.
219
+ - `AI-` things to just things.
220
+
221
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
222
+
223
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
224
+
225
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
226
+ 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
227
+
228
+ - moved ai-tracing code into @mastra/observability ([#9661](https://github.com/mastra-ai/mastra/pull/9661))
229
+
230
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
231
+
232
+ ### Minor Changes
233
+
234
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
235
+
236
+ 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.
237
+
238
+ ```typescript
239
+ import { Mastra } from '@mastra/core';
240
+ import { LibSQLStore } from '@mastra/libsql';
241
+
242
+ const mastra = new Mastra({
243
+ storage: new LibSQLStore({ url: ':memory:' }),
244
+ tools: { myTool },
245
+ scorers: { myScorer },
246
+ });
247
+
248
+ // Create agent in storage via API or directly
249
+ await mastra.getStorage().createAgent({
250
+ agent: {
251
+ id: 'my-agent',
252
+ name: 'My Agent',
253
+ instructions: 'You are helpful',
254
+ model: { provider: 'openai', name: 'gpt-4' },
255
+ tools: { myTool: {} },
256
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
257
+ },
258
+ });
259
+
260
+ // Load and use the agent
261
+ const agent = await mastra.getStoredAgentById('my-agent');
262
+ const response = await agent.generate('Hello!');
263
+
264
+ // List all stored agents with pagination
265
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
266
+ page: 0,
267
+ perPage: 10,
268
+ });
269
+ ```
270
+
271
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
272
+
273
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
274
+
275
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
276
+
277
+ **Why this change?**
278
+
279
+ 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.
280
+
281
+ **Columns Changed:**
282
+ - `mastra_threads.metadata` - Thread metadata
283
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
284
+
285
+ **PostgreSQL**
286
+
287
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
288
+
289
+ ```sql
290
+ ALTER TABLE mastra_threads
291
+ ALTER COLUMN metadata TYPE jsonb
292
+ USING metadata::jsonb;
293
+
294
+ ALTER TABLE mastra_workflow_snapshot
295
+ ALTER COLUMN snapshot TYPE jsonb
296
+ USING snapshot::jsonb;
297
+ ```
298
+
299
+ **LibSQL**
300
+
301
+ 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:
302
+ - Existing TEXT JSON data continues to work
303
+ - New data is stored in binary JSONB format
304
+ - Both formats can coexist in the same table
305
+ - All JSON functions (`json_extract`, etc.) work on both formats
306
+
307
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
308
+
309
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
310
+
311
+ 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.
312
+
313
+ **Key changes:**
314
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
315
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
316
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
317
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
318
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
319
+
320
+ **Why this matters:**
321
+
322
+ This enables composite storage where you can use different database adapters per domain:
323
+
324
+ ```typescript
325
+ import { Mastra } from '@mastra/core';
326
+ import { PostgresStore } from '@mastra/pg';
327
+ import { ClickhouseStore } from '@mastra/clickhouse';
328
+
329
+ // Use Postgres for most domains but Clickhouse for observability
330
+ const mastra = new Mastra({
331
+ storage: new PostgresStore({
332
+ connectionString: 'postgres://...',
333
+ }),
334
+ // Future: override specific domains
335
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
336
+ });
337
+ ```
338
+
339
+ **Standalone domain usage:**
340
+
341
+ Domains can now be used independently with flexible configuration:
342
+
343
+ ```typescript
344
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
345
+
346
+ // Option 1: Pass config to create client internally
347
+ const memory = new MemoryLibSQL({
348
+ url: 'file:./local.db',
349
+ });
350
+
351
+ // Option 2: Pass existing client for shared connections
352
+ import { createClient } from '@libsql/client';
353
+ const client = createClient({ url: 'file:./local.db' });
354
+ const memory = new MemoryLibSQL({ client });
355
+ ```
356
+
357
+ **Breaking changes:**
358
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
359
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
360
+
361
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
362
+
363
+ ### Summary
364
+
365
+ 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.
366
+
367
+ ### Migration Guide
368
+
369
+ All direct method calls on storage instances should be updated to use `getStore()`:
370
+
371
+ ```typescript
372
+ // Before
373
+ const thread = await storage.getThreadById({ threadId });
374
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
375
+ await storage.createSpan(span);
376
+
377
+ // After
378
+ const memory = await storage.getStore('memory');
379
+ const thread = await memory?.getThreadById({ threadId });
380
+
381
+ const workflows = await storage.getStore('workflows');
382
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
383
+
384
+ const observability = await storage.getStore('observability');
385
+ await observability?.createSpan(span);
386
+ ```
387
+
388
+ ### Available Domains
389
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
390
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
391
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
392
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
393
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
394
+
395
+ ### Breaking Changes
396
+ - Passthrough methods have been removed from `MastraStorage` base class
397
+ - All storage adapters now require accessing domains via `getStore()`
398
+ - The `stores` property on storage instances is now the canonical way to access domain storage
399
+
400
+ ### Internal Changes
401
+ - Each storage adapter now initializes domain-specific stores in its constructor
402
+ - Domain stores share database connections and handle their own table initialization
403
+
404
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
405
+
406
+ ## What changed
407
+
408
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
409
+
410
+ **Before:**
411
+
412
+ ```typescript
413
+ // Old span structure
414
+ span.agentId; // 'my-agent'
415
+ span.toolId; // undefined
416
+ span.workflowId; // undefined
417
+ ```
418
+
419
+ **After:**
420
+
421
+ ```typescript
422
+ // New span structure
423
+ span.entityType; // EntityType.AGENT
424
+ span.entityId; // 'my-agent'
425
+ span.entityName; // 'My Agent'
426
+ ```
427
+
428
+ ## New `listTraces()` API
429
+
430
+ Query traces with filtering, pagination, and sorting:
431
+
432
+ ```typescript
433
+ const { spans, pagination } = await storage.listTraces({
434
+ filters: {
435
+ entityType: EntityType.AGENT,
436
+ entityId: 'my-agent',
437
+ userId: 'user-123',
438
+ environment: 'production',
439
+ status: TraceStatus.SUCCESS,
440
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
441
+ },
442
+ pagination: { page: 0, perPage: 50 },
443
+ orderBy: { field: 'startedAt', direction: 'DESC' },
444
+ });
445
+ ```
446
+
447
+ **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`.
448
+
449
+ ## New retrieval methods
450
+ - `getSpan({ traceId, spanId })` - Get a single span
451
+ - `getRootSpan({ traceId })` - Get the root span of a trace
452
+ - `getTrace({ traceId })` - Get all spans for a trace
453
+
454
+ ## Backward compatibility
455
+
456
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
457
+
458
+ ## Migration
459
+
460
+ **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`.
461
+
462
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
463
+
464
+ - Remove pg-promise dependency and use pg.Pool directly ([#11450](https://github.com/mastra-ai/mastra/pull/11450))
465
+
466
+ **BREAKING CHANGE**: This release replaces pg-promise with vanilla node-postgres (`pg`).
467
+
468
+ ### Breaking Changes
469
+ - **Removed `store.pgp`**: The pg-promise library instance is no longer exposed
470
+ - **Config change**: `{ client: pgPromiseDb }` is no longer supported. Use `{ pool: pgPool }` instead
471
+ - **Cloud SQL config**: `max` and `idleTimeoutMillis` must now be passed via `pgPoolOptions`
472
+
473
+ ### New Features
474
+ - **`store.pool`**: Exposes the underlying `pg.Pool` for direct database access or ORM integration (e.g., Drizzle)
475
+ - **`store.db`**: Provides a `DbClient` interface with methods like `one()`, `any()`, `tx()`, etc.
476
+ - **`store.db.connect()`**: Acquire a client for session-level operations
477
+
478
+ ### Migration
479
+
480
+ ```typescript
481
+ // Before (pg-promise)
482
+ import pgPromise from 'pg-promise';
483
+ const pgp = pgPromise();
484
+ const client = pgp(connectionString);
485
+ const store = new PostgresStore({ id: 'my-store', client });
486
+
487
+ // After (pg.Pool)
488
+ import { Pool } from 'pg';
489
+ const pool = new Pool({ connectionString });
490
+ const store = new PostgresStore({ id: 'my-store', pool });
491
+
492
+ // Use store.pool with any library that accepts a pg.Pool
493
+ ```
494
+
495
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
496
+
497
+ 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.
498
+
499
+ ```typescript
500
+ // CI/CD script - run migrations
501
+ const storage = new PostgresStore({
502
+ connectionString: DATABASE_URL,
503
+ id: 'pg-storage',
504
+ });
505
+ await storage.init();
506
+
507
+ // Runtime - skip auto-init
508
+ const storage = new PostgresStore({
509
+ connectionString: DATABASE_URL,
510
+ id: 'pg-storage',
511
+ disableInit: true,
512
+ });
513
+ ```
514
+
515
+ ### Patch Changes
516
+
517
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
518
+
519
+ 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`.
520
+
521
+ Each package includes:
522
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
523
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
524
+ - **Topic folders** - Conceptual documentation organized by feature area
525
+
526
+ 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.
527
+
528
+ - Added `exportSchemas()` function to generate Mastra database schema as SQL DDL without a database connection. ([#11448](https://github.com/mastra-ai/mastra/pull/11448))
529
+
530
+ **What's New**
531
+
532
+ You can now export your Mastra database schema as SQL DDL statements without connecting to a database. This is useful for:
533
+ - Generating migration scripts
534
+ - Reviewing the schema before deployment
535
+ - Creating database schemas in environments where the application doesn't have CREATE privileges
536
+
537
+ **Example**
538
+
539
+ ```typescript
540
+ import { exportSchemas } from '@mastra/pg';
541
+
542
+ // Export schema for default 'public' schema
543
+ const ddl = exportSchemas();
544
+ console.log(ddl);
545
+
546
+ // Export schema for a custom schema
547
+ const customDdl = exportSchemas('my_schema');
548
+ // Creates: CREATE SCHEMA IF NOT EXISTS "my_schema"; and all tables within it
549
+ ```
550
+
551
+ - Fix pg listThreadsByResourceId page number validation ([#9671](https://github.com/mastra-ai/mastra/pull/9671))
552
+
553
+ - 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))
554
+
555
+ - Fix missing timezone columns during PostgreSQL spans table migration ([#11419](https://github.com/mastra-ai/mastra/pull/11419))
556
+
557
+ Fixes issue #11410 where users upgrading to observability beta.7 encountered errors about missing `startedAtZ`, `endedAtZ`, `createdAtZ`, and `updatedAtZ` columns. The migration now properly adds timezone-aware columns for all timestamp fields when upgrading existing databases, ensuring compatibility with the new observability implementation that requires these columns for batch operations.
558
+
559
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
560
+
561
+ **What Changed**
562
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
563
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
564
+
565
+ **Impact**
566
+ 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.
567
+
568
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
569
+
570
+ - PostgresStore was setting `this.stores = {}` in the constructor and only populating it in the async `init()` method. This broke Memory because it checks `storage.stores.memory` synchronously in `getInputProcessors()` before `init()` is called. ([#10943](https://github.com/mastra-ai/mastra/pull/10943))
571
+
572
+ The fix moves domain instance creation to the constructor. This is safe because pg-promise creates database connections lazily when queries are executed.
573
+
574
+ - Fix `listWorkflowRuns` failing with "unsupported Unicode escape sequence" error when filtering by status on snapshots containing null characters (`\u0000`) or unpaired Unicode surrogates (`\uD800-\uDFFF`). ([#11616](https://github.com/mastra-ai/mastra/pull/11616))
575
+
576
+ The fix uses `regexp_replace` to sanitize problematic escape sequences before casting to JSONB in the WHERE clause, while preserving the original data in the returned results.
577
+
578
+ - qualify vector type to fix schema lookup ([#10786](https://github.com/mastra-ai/mastra/pull/10786))
579
+
580
+ - - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
581
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
582
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
583
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
584
+
585
+ - Fix severe performance issue with semantic recall on large message tables ([#11365](https://github.com/mastra-ai/mastra/pull/11365))
586
+
587
+ The `_getIncludedMessages` method was using `ROW_NUMBER() OVER (ORDER BY createdAt)` which scanned all messages in a thread to assign row numbers. On tables with 1M+ rows, this caused 5-10 minute query times.
588
+
589
+ Replaced with cursor-based pagination using the existing `(thread_id, createdAt)` index:
590
+
591
+ ```sql
592
+ -- Before: scans entire thread
593
+ ROW_NUMBER() OVER (ORDER BY "createdAt" ASC)
594
+
595
+ -- After: uses index, fetches only needed rows
596
+ WHERE createdAt <= (target) ORDER BY createdAt DESC LIMIT N
597
+ ```
598
+
599
+ Performance improvement: ~49x faster (832ms → 17ms) for typical semantic recall queries.
600
+
601
+ - Fixed PostgreSQL migration errors when upgrading from v0.x to v1 ([#11633](https://github.com/mastra-ai/mastra/pull/11633))
602
+
603
+ **What changed:** PostgreSQL storage now automatically adds missing `spanId` and `requestContext` columns to the scorers table during initialization, preventing "column does not exist" errors when upgrading from v0.x to v1.0.0.
604
+
605
+ **Why:** Previously, upgrading to v1 could fail with errors like `column "requestContext" of relation "mastra_scorers" does not exist` if your database was created with an older version.
606
+
607
+ Related: #11631
608
+
609
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
610
+
611
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
612
+
613
+ **Before:**
614
+
615
+ ```typescript
616
+ const result = await workflow.execute({ input });
617
+ if (result.status === 'failed') {
618
+ // Custom error properties were lost
619
+ console.log(result.error); // "Step execution failed" (just a string)
620
+ }
621
+ ```
622
+
623
+ **After:**
624
+
625
+ ```typescript
626
+ const result = await workflow.execute({ input });
627
+ if (result.status === 'failed') {
628
+ // Custom properties are preserved
629
+ console.log(result.error.message); // "Step execution failed"
630
+ console.log(result.error.statusCode); // 429
631
+ console.log(result.error.cause?.name); // "RateLimitError"
632
+ }
633
+ ```
634
+
635
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
636
+
637
+ Other changes:
638
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
639
+
640
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
641
+
642
+ **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.
643
+
644
+ **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.
645
+
646
+ **Example:**
647
+
648
+ ```typescript
649
+ // Get first page
650
+ const page1 = await memory.recall({
651
+ threadId: 'thread-123',
652
+ perPage: 10,
653
+ orderBy: { field: 'createdAt', direction: 'DESC' },
654
+ });
655
+
656
+ // Get next page using cursor-based pagination
657
+ const oldestMessage = page1.messages[page1.messages.length - 1];
658
+ const page2 = await memory.recall({
659
+ threadId: 'thread-123',
660
+ perPage: 10,
661
+ orderBy: { field: 'createdAt', direction: 'DESC' },
662
+ filter: {
663
+ dateRange: {
664
+ end: oldestMessage.createdAt,
665
+ endExclusive: true, // Excludes the cursor message
666
+ },
667
+ },
668
+ });
669
+ ```
670
+
671
+ - Ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
672
+
673
+ - 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))
674
+
675
+ **Deduplication rules (in priority order):**
676
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
677
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
678
+ 3. Use `createdAt` as the final tiebreaker
679
+
680
+ **What changed:**
681
+ - Added `migrateSpans()` method to observability stores for manual migration
682
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
683
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
684
+
685
+ **Usage example:**
686
+
687
+ ```typescript
688
+ const observability = await storage.getStore('observability');
689
+ const status = await observability.checkSpansMigrationStatus();
690
+ if (status.needsMigration) {
691
+ const result = await observability.migrateSpans();
692
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
693
+ }
694
+ ```
695
+
696
+ Fixes #11840
697
+
698
+ - Fix thread timestamps being returned in incorrect timezone from listThreadsByResourceId ([#11498](https://github.com/mastra-ai/mastra/pull/11498))
699
+
700
+ The method was not using the timezone-aware columns (createdAtZ/updatedAtZ), causing timestamps to be interpreted in local timezone instead of UTC. Now correctly uses TIMESTAMPTZ columns with fallback for legacy data.
701
+
702
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
703
+
704
+ `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.
705
+
706
+ ```typescript
707
+ import { MastraStorage } from '@mastra/core/storage';
708
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
709
+ import { MemoryLibSQL } from '@mastra/libsql';
710
+
711
+ // Compose domains from different stores
712
+ const storage = new MastraStorage({
713
+ id: 'composite',
714
+ domains: {
715
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
716
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
717
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
718
+ },
719
+ });
720
+ ```
721
+
722
+ **Breaking changes:**
723
+ - `storage.supports` property no longer exists
724
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
725
+
726
+ All stores now support the same features. For domain availability, use `getStore()`:
727
+
728
+ ```typescript
729
+ const store = await storage.getStore('memory');
730
+ if (store) {
731
+ // domain is available
732
+ }
733
+ ```
734
+
735
+ - - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()` ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
736
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
737
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
738
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
739
+
740
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
741
+
742
+ ```typescript
743
+ await workflow.deleteWorkflowRunById(runId);
744
+ ```
745
+
746
+ - Add halfvec type support for large dimension embeddings ([#11002](https://github.com/mastra-ai/mastra/pull/11002))
747
+
748
+ Adds `vectorType` option to `createIndex()` for choosing between full precision (`vector`) and half precision (`halfvec`) storage. halfvec uses 2 bytes per dimension instead of 4, enabling indexes on embeddings up to 4000 dimensions.
749
+
750
+ ```typescript
751
+ await pgVector.createIndex({
752
+ indexName: 'large-embeddings',
753
+ dimension: 3072, // text-embedding-3-large
754
+ metric: 'cosine',
755
+ vectorType: 'halfvec',
756
+ });
757
+ ```
758
+
759
+ Requires pgvector >= 0.7.0 for halfvec support. Docker compose files updated to use pgvector 0.8.0.
760
+
761
+ - Fixes "invalid input syntax for type json" error in tracing with PostgreSQL. ([#9154](https://github.com/mastra-ai/mastra/pull/9154))
762
+
763
+ - 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))
764
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
765
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
766
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
767
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
768
+
769
+ 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.
770
+
771
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
772
+
773
+ **New Features**
774
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
775
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
776
+ - Full pagination and sorting support
777
+
778
+ **Example Usage**
779
+
780
+ ```typescript
781
+ // List all threads
782
+ const allThreads = await memory.listThreads({});
783
+
784
+ // Filter by resourceId only
785
+ const userThreads = await memory.listThreads({
786
+ filter: { resourceId: 'user-123' },
787
+ });
788
+
789
+ // Filter by metadata only
790
+ const supportThreads = await memory.listThreads({
791
+ filter: { metadata: { category: 'support' } },
792
+ });
793
+
794
+ // Filter by both with pagination
795
+ const filteredThreads = await memory.listThreads({
796
+ filter: {
797
+ resourceId: 'user-123',
798
+ metadata: { priority: 'high', status: 'open' },
799
+ },
800
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
801
+ page: 0,
802
+ perPage: 20,
803
+ });
804
+ ```
805
+
806
+ **Security Improvements**
807
+ - Added validation to prevent SQL injection via malicious metadata keys
808
+ - Added pagination parameter validation to prevent integer overflow attacks
809
+
810
+ - 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))
811
+
812
+ **Why this change?**
813
+
814
+ 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.
815
+
816
+ **@mastra/libsql** (Breaking)
817
+
818
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
819
+
820
+ ```typescript
821
+ // Before
822
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
823
+
824
+ // After
825
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
826
+ ```
827
+
828
+ **@mastra/opensearch** (Breaking)
829
+
830
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
831
+
832
+ ```typescript
833
+ // Before
834
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
835
+
836
+ // After
837
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
838
+
839
+ // With authentication (now possible)
840
+ new OpenSearchVector({
841
+ id: 'my-vector',
842
+ node: 'https://localhost:9200',
843
+ auth: { username: 'admin', password: 'admin' },
844
+ ssl: { rejectUnauthorized: false },
845
+ });
846
+ ```
847
+
848
+ **@mastra/pinecone** (Breaking)
849
+
850
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
851
+
852
+ ```typescript
853
+ // Before
854
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
855
+
856
+ // After
857
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
858
+
859
+ // With custom controller host (if needed)
860
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
861
+ ```
862
+
863
+ **@mastra/clickhouse**
864
+
865
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
866
+
867
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
868
+
869
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
870
+
871
+ **@mastra/deployer-cloud**
872
+
873
+ Updated internal LibSQLVector configuration for compatibility with the new API.
874
+
875
+ - Fixed PostgreSQL storage issues after JSONB migration. ([#11906](https://github.com/mastra-ai/mastra/pull/11906))
876
+
877
+ **Bug Fixes**
878
+ - Fixed `clearTable()` using incorrect default schema. The method was checking for table existence in the 'mastra' schema instead of PostgreSQL's default 'public' schema, causing table truncation to be skipped and leading to duplicate key violations in tests and production code that uses `dangerouslyClearAll()`.
879
+ - Fixed `listWorkflowRuns()` status filter failing with "function regexp_replace(jsonb, ...) does not exist" error. After the TEXT to JSONB migration, the query tried to use `regexp_replace()` directly on a JSONB column. Now casts to text first: `regexp_replace(snapshot::text, ...)`.
880
+ - Added Unicode sanitization when persisting workflow snapshots to handle null characters (\u0000) and unpaired surrogates (\uD800-\uDFFF) that PostgreSQL's JSONB type rejects, preventing "unsupported Unicode escape sequence" errors.
881
+
882
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
883
+ Add status filter to `listWorkflowRuns`
884
+ Add automatic restart to restart active workflow runs when server starts
885
+
886
+ - 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))
887
+
888
+ **Migration:**
889
+
890
+ Update your imports and usage:
891
+
892
+ ```typescript
893
+ // Before
894
+ import { MastraStorage } from '@mastra/core/storage';
895
+
896
+ const storage = new MastraStorage({
897
+ id: 'composite',
898
+ domains: { ... }
899
+ });
900
+
901
+ // After
902
+ import { MastraCompositeStore } from '@mastra/core/storage';
903
+
904
+ const storage = new MastraCompositeStore({
905
+ id: 'composite',
906
+ domains: { ... }
907
+ });
908
+ ```
909
+
910
+ 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.
911
+
912
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
913
+
914
+ ```typescript
915
+ // Clone a thread
916
+ const { thread, clonedMessages } = await memory.cloneThread({
917
+ sourceThreadId: 'thread-123',
918
+ title: 'My Clone',
919
+ options: {
920
+ messageLimit: 10, // optional: only copy last N messages
921
+ },
922
+ });
923
+
924
+ // Check if a thread is a clone
925
+ if (memory.isClone(thread)) {
926
+ const source = await memory.getSourceThread(thread.id);
927
+ }
928
+
929
+ // List all clones of a thread
930
+ const clones = await memory.listClones('thread-123');
931
+ ```
932
+
933
+ Includes:
934
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
935
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
936
+ - Embeddings created for cloned messages (semantic recall)
937
+ - Clone button in playground UI Memory tab
938
+
939
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
940
+
941
+ **What changed**
942
+
943
+ 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.
944
+
945
+ **Example**
946
+
947
+ ```typescript
948
+ import { createClient } from '@clickhouse/client';
949
+ import { ClickhouseStore } from '@mastra/clickhouse';
950
+
951
+ // Create and configure client with custom settings
952
+ const client = createClient({
953
+ url: 'http://localhost:8123',
954
+ username: 'default',
955
+ password: '',
956
+ request_timeout: 60000,
957
+ });
958
+
959
+ // Pass pre-configured client to store
960
+ const store = new ClickhouseStore({
961
+ id: 'my-store',
962
+ client,
963
+ });
964
+ ```
965
+
966
+ **Additional improvements**
967
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
968
+
969
+ - Add index configuration options to storage stores ([#11311](https://github.com/mastra-ai/mastra/pull/11311))
970
+
971
+ Storage stores now support two new configuration options for index management:
972
+ - `skipDefaultIndexes`: When `true`, default performance indexes are not created during `init()`. Useful for custom index strategies or reducing initialization time.
973
+ - `indexes`: Array of custom index definitions to create during `init()`. Indexes are routed to the appropriate domain based on table/collection name.
974
+
975
+ ```typescript
976
+ // Skip default indexes and use custom ones
977
+ const store = new PostgresStore({
978
+ connectionString: '...',
979
+ skipDefaultIndexes: true,
980
+ indexes: [{ name: 'threads_type_idx', table: 'mastra_threads', columns: ["metadata->>'type'"] }],
981
+ });
982
+
983
+ // MongoDB equivalent
984
+ const mongoStore = new MongoDBStore({
985
+ url: 'mongodb://...',
986
+ skipDefaultIndexes: true,
987
+ indexes: [{ collection: 'mastra_threads', keys: { 'metadata.type': 1 }, options: { name: 'threads_type_idx' } }],
988
+ });
989
+ ```
990
+
991
+ Domain classes (e.g., `MemoryPG`, `MemoryStorageMongoDB`) also accept these options for standalone usage.
992
+
993
+ - 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)]:
994
+ - @mastra/core@1.0.0
995
+
996
+ ## 1.0.0-beta.15
997
+
998
+ ### Patch Changes
999
+
1000
+ - 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))
1001
+
1002
+ **Deduplication rules (in priority order):**
1003
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
1004
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
1005
+ 3. Use `createdAt` as the final tiebreaker
1006
+
1007
+ **What changed:**
1008
+ - Added `migrateSpans()` method to observability stores for manual migration
1009
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
1010
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
1011
+
1012
+ **Usage example:**
1013
+
1014
+ ```typescript
1015
+ const observability = await storage.getStore('observability');
1016
+ const status = await observability.checkSpansMigrationStatus();
1017
+ if (status.needsMigration) {
1018
+ const result = await observability.migrateSpans();
1019
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
1020
+ }
1021
+ ```
1022
+
1023
+ Fixes #11840
1024
+
1025
+ - 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))
1026
+
1027
+ **Migration:**
1028
+
1029
+ Update your imports and usage:
1030
+
1031
+ ```typescript
1032
+ // Before
1033
+ import { MastraStorage } from '@mastra/core/storage';
1034
+
1035
+ const storage = new MastraStorage({
1036
+ id: 'composite',
1037
+ domains: { ... }
1038
+ });
1039
+
1040
+ // After
1041
+ import { MastraCompositeStore } from '@mastra/core/storage';
1042
+
1043
+ const storage = new MastraCompositeStore({
1044
+ id: 'composite',
1045
+ domains: { ... }
1046
+ });
1047
+ ```
1048
+
1049
+ 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.
1050
+
1051
+ - Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897)]:
1052
+ - @mastra/core@1.0.0-beta.26
1053
+
1054
+ ## 1.0.0-beta.14
1055
+
1056
+ ### Patch Changes
1057
+
1058
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
1059
+
1060
+ **New Features**
1061
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
1062
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
1063
+ - Full pagination and sorting support
1064
+
1065
+ **Example Usage**
1066
+
1067
+ ```typescript
1068
+ // List all threads
1069
+ const allThreads = await memory.listThreads({});
1070
+
1071
+ // Filter by resourceId only
1072
+ const userThreads = await memory.listThreads({
1073
+ filter: { resourceId: 'user-123' },
1074
+ });
1075
+
1076
+ // Filter by metadata only
1077
+ const supportThreads = await memory.listThreads({
1078
+ filter: { metadata: { category: 'support' } },
1079
+ });
1080
+
1081
+ // Filter by both with pagination
1082
+ const filteredThreads = await memory.listThreads({
1083
+ filter: {
1084
+ resourceId: 'user-123',
1085
+ metadata: { priority: 'high', status: 'open' },
1086
+ },
1087
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
1088
+ page: 0,
1089
+ perPage: 20,
1090
+ });
1091
+ ```
1092
+
1093
+ **Security Improvements**
1094
+ - Added validation to prevent SQL injection via malicious metadata keys
1095
+ - Added pagination parameter validation to prevent integer overflow attacks
1096
+
1097
+ - 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)]:
1098
+ - @mastra/core@1.0.0-beta.25
1099
+
1100
+ ## 1.0.0-beta.13
1101
+
1102
+ ### Minor Changes
1103
+
1104
+ - Changed JSON columns from TEXT to JSONB in `mastra_threads` and `mastra_workflow_snapshot` tables. ([#11853](https://github.com/mastra-ai/mastra/pull/11853))
1105
+
1106
+ **Why this change?**
1107
+
1108
+ 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.
1109
+
1110
+ **Columns Changed:**
1111
+ - `mastra_threads.metadata` - Thread metadata
1112
+ - `mastra_workflow_snapshot.snapshot` - Workflow run state
1113
+
1114
+ **PostgreSQL**
1115
+
1116
+ Migration Required - PostgreSQL enforces column types, so existing tables must be migrated. Note: Migration will fail if existing column values contain invalid JSON.
1117
+
1118
+ ```sql
1119
+ ALTER TABLE mastra_threads
1120
+ ALTER COLUMN metadata TYPE jsonb
1121
+ USING metadata::jsonb;
1122
+
1123
+ ALTER TABLE mastra_workflow_snapshot
1124
+ ALTER COLUMN snapshot TYPE jsonb
1125
+ USING snapshot::jsonb;
1126
+ ```
1127
+
1128
+ **LibSQL**
1129
+
1130
+ 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:
1131
+ - Existing TEXT JSON data continues to work
1132
+ - New data is stored in binary JSONB format
1133
+ - Both formats can coexist in the same table
1134
+ - All JSON functions (`json_extract`, etc.) work on both formats
1135
+
1136
+ New installations automatically use JSONB. Existing applications continue to work without any changes.
1137
+
1138
+ ### Patch Changes
1139
+
1140
+ - Fix `listWorkflowRuns` failing with "unsupported Unicode escape sequence" error when filtering by status on snapshots containing null characters (`\u0000`) or unpaired Unicode surrogates (`\uD800-\uDFFF`). ([#11616](https://github.com/mastra-ai/mastra/pull/11616))
1141
+
1142
+ The fix uses `regexp_replace` to sanitize problematic escape sequences before casting to JSONB in the WHERE clause, while preserving the original data in the returned results.
1143
+
1144
+ - Fixed PostgreSQL migration errors when upgrading from v0.x to v1 ([#11633](https://github.com/mastra-ai/mastra/pull/11633))
1145
+
1146
+ **What changed:** PostgreSQL storage now automatically adds missing `spanId` and `requestContext` columns to the scorers table during initialization, preventing "column does not exist" errors when upgrading from v0.x to v1.0.0.
1147
+
1148
+ **Why:** Previously, upgrading to v1 could fail with errors like `column "requestContext" of relation "mastra_scorers" does not exist` if your database was created with an older version.
1149
+
1150
+ Related: #11631
1151
+
1152
+ - 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))
1153
+
1154
+ **Why this change?**
1155
+
1156
+ 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.
1157
+
1158
+ **@mastra/libsql** (Breaking)
1159
+
1160
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
1161
+
1162
+ ```typescript
1163
+ // Before
1164
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
1165
+
1166
+ // After
1167
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
1168
+ ```
1169
+
1170
+ **@mastra/opensearch** (Breaking)
1171
+
1172
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
1173
+
1174
+ ```typescript
1175
+ // Before
1176
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
1177
+
1178
+ // After
1179
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
1180
+
1181
+ // With authentication (now possible)
1182
+ new OpenSearchVector({
1183
+ id: 'my-vector',
1184
+ node: 'https://localhost:9200',
1185
+ auth: { username: 'admin', password: 'admin' },
1186
+ ssl: { rejectUnauthorized: false },
1187
+ });
1188
+ ```
1189
+
1190
+ **@mastra/pinecone** (Breaking)
1191
+
1192
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
1193
+
1194
+ ```typescript
1195
+ // Before
1196
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
1197
+
1198
+ // After
1199
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
1200
+
1201
+ // With custom controller host (if needed)
1202
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
1203
+ ```
1204
+
1205
+ **@mastra/clickhouse**
1206
+
1207
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
1208
+
1209
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
1210
+
1211
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
1212
+
1213
+ **@mastra/deployer-cloud**
1214
+
1215
+ Updated internal LibSQLVector configuration for compatibility with the new API.
1216
+
1217
+ - Fixed PostgreSQL storage issues after JSONB migration. ([#11906](https://github.com/mastra-ai/mastra/pull/11906))
1218
+
1219
+ **Bug Fixes**
1220
+ - Fixed `clearTable()` using incorrect default schema. The method was checking for table existence in the 'mastra' schema instead of PostgreSQL's default 'public' schema, causing table truncation to be skipped and leading to duplicate key violations in tests and production code that uses `dangerouslyClearAll()`.
1221
+ - Fixed `listWorkflowRuns()` status filter failing with "function regexp_replace(jsonb, ...) does not exist" error. After the TEXT to JSONB migration, the query tried to use `regexp_replace()` directly on a JSONB column. Now casts to text first: `regexp_replace(snapshot::text, ...)`.
1222
+ - Added Unicode sanitization when persisting workflow snapshots to handle null characters (\u0000) and unpaired surrogates (\uD800-\uDFFF) that PostgreSQL's JSONB type rejects, preventing "unsupported Unicode escape sequence" errors.
1223
+
1224
+ - 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)]:
1225
+ - @mastra/core@1.0.0-beta.22
1226
+
1227
+ ## 1.0.0-beta.12
1228
+
1229
+ ### Patch Changes
1230
+
1231
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
1232
+
1233
+ 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`.
1234
+
1235
+ Each package includes:
1236
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
1237
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
1238
+ - **Topic folders** - Conceptual documentation organized by feature area
1239
+
1240
+ 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.
1241
+
1242
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
1243
+
1244
+ **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.
1245
+
1246
+ **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.
1247
+
1248
+ **Example:**
1249
+
1250
+ ```typescript
1251
+ // Get first page
1252
+ const page1 = await memory.recall({
1253
+ threadId: 'thread-123',
1254
+ perPage: 10,
1255
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1256
+ });
1257
+
1258
+ // Get next page using cursor-based pagination
1259
+ const oldestMessage = page1.messages[page1.messages.length - 1];
1260
+ const page2 = await memory.recall({
1261
+ threadId: 'thread-123',
1262
+ perPage: 10,
1263
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1264
+ filter: {
1265
+ dateRange: {
1266
+ end: oldestMessage.createdAt,
1267
+ endExclusive: true, // Excludes the cursor message
1268
+ },
1269
+ },
1270
+ });
1271
+ ```
1272
+
1273
+ - Fix thread timestamps being returned in incorrect timezone from listThreadsByResourceId ([#11498](https://github.com/mastra-ai/mastra/pull/11498))
1274
+
1275
+ The method was not using the timezone-aware columns (createdAtZ/updatedAtZ), causing timestamps to be interpreted in local timezone instead of UTC. Now correctly uses TIMESTAMPTZ columns with fallback for legacy data.
1276
+
1277
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
1278
+
1279
+ ```typescript
1280
+ // Clone a thread
1281
+ const { thread, clonedMessages } = await memory.cloneThread({
1282
+ sourceThreadId: 'thread-123',
1283
+ title: 'My Clone',
1284
+ options: {
1285
+ messageLimit: 10, // optional: only copy last N messages
1286
+ },
1287
+ });
1288
+
1289
+ // Check if a thread is a clone
1290
+ if (memory.isClone(thread)) {
1291
+ const source = await memory.getSourceThread(thread.id);
1292
+ }
1293
+
1294
+ // List all clones of a thread
1295
+ const clones = await memory.listClones('thread-123');
1296
+ ```
1297
+
1298
+ Includes:
1299
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
1300
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
1301
+ - Embeddings created for cloned messages (semantic recall)
1302
+ - Clone button in playground UI Memory tab
1303
+
1304
+ - 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)]:
1305
+ - @mastra/core@1.0.0-beta.20
1306
+
1307
+ ## 1.0.0-beta.11
1308
+
1309
+ ### Minor Changes
1310
+
1311
+ - Remove pg-promise dependency and use pg.Pool directly ([#11450](https://github.com/mastra-ai/mastra/pull/11450))
1312
+
1313
+ **BREAKING CHANGE**: This release replaces pg-promise with vanilla node-postgres (`pg`).
1314
+
1315
+ ### Breaking Changes
1316
+ - **Removed `store.pgp`**: The pg-promise library instance is no longer exposed
1317
+ - **Config change**: `{ client: pgPromiseDb }` is no longer supported. Use `{ pool: pgPool }` instead
1318
+ - **Cloud SQL config**: `max` and `idleTimeoutMillis` must now be passed via `pgPoolOptions`
1319
+
1320
+ ### New Features
1321
+ - **`store.pool`**: Exposes the underlying `pg.Pool` for direct database access or ORM integration (e.g., Drizzle)
1322
+ - **`store.db`**: Provides a `DbClient` interface with methods like `one()`, `any()`, `tx()`, etc.
1323
+ - **`store.db.connect()`**: Acquire a client for session-level operations
1324
+
1325
+ ### Migration
1326
+
1327
+ ```typescript
1328
+ // Before (pg-promise)
1329
+ import pgPromise from 'pg-promise';
1330
+ const pgp = pgPromise();
1331
+ const client = pgp(connectionString);
1332
+ const store = new PostgresStore({ id: 'my-store', client });
1333
+
1334
+ // After (pg.Pool)
1335
+ import { Pool } from 'pg';
1336
+ const pool = new Pool({ connectionString });
1337
+ const store = new PostgresStore({ id: 'my-store', pool });
1338
+
1339
+ // Use store.pool with any library that accepts a pg.Pool
1340
+ ```
1341
+
1342
+ ### Patch Changes
1343
+
1344
+ - Added `exportSchemas()` function to generate Mastra database schema as SQL DDL without a database connection. ([#11448](https://github.com/mastra-ai/mastra/pull/11448))
1345
+
1346
+ **What's New**
1347
+
1348
+ You can now export your Mastra database schema as SQL DDL statements without connecting to a database. This is useful for:
1349
+ - Generating migration scripts
1350
+ - Reviewing the schema before deployment
1351
+ - Creating database schemas in environments where the application doesn't have CREATE privileges
1352
+
1353
+ **Example**
1354
+
1355
+ ```typescript
1356
+ import { exportSchemas } from '@mastra/pg';
1357
+
1358
+ // Export schema for default 'public' schema
1359
+ const ddl = exportSchemas();
1360
+ console.log(ddl);
1361
+
1362
+ // Export schema for a custom schema
1363
+ const customDdl = exportSchemas('my_schema');
1364
+ // Creates: CREATE SCHEMA IF NOT EXISTS "my_schema"; and all tables within it
1365
+ ```
1366
+
1367
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
1368
+ - @mastra/core@1.0.0-beta.19
1369
+
1370
+ ## 1.0.0-beta.10
1371
+
1372
+ ### Patch Changes
1373
+
1374
+ - Fix missing timezone columns during PostgreSQL spans table migration ([#11419](https://github.com/mastra-ai/mastra/pull/11419))
1375
+
1376
+ Fixes issue #11410 where users upgrading to observability beta.7 encountered errors about missing `startedAtZ`, `endedAtZ`, `createdAtZ`, and `updatedAtZ` columns. The migration now properly adds timezone-aware columns for all timestamp fields when upgrading existing databases, ensuring compatibility with the new observability implementation that requires these columns for batch operations.
1377
+
1378
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
1379
+
1380
+ `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.
1381
+
1382
+ ```typescript
1383
+ import { MastraStorage } from '@mastra/core/storage';
1384
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
1385
+ import { MemoryLibSQL } from '@mastra/libsql';
1386
+
1387
+ // Compose domains from different stores
1388
+ const storage = new MastraStorage({
1389
+ id: 'composite',
1390
+ domains: {
1391
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
1392
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
1393
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
1394
+ },
1395
+ });
1396
+ ```
1397
+
1398
+ **Breaking changes:**
1399
+ - `storage.supports` property no longer exists
1400
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
1401
+
1402
+ All stores now support the same features. For domain availability, use `getStore()`:
1403
+
1404
+ ```typescript
1405
+ const store = await storage.getStore('memory');
1406
+ if (store) {
1407
+ // domain is available
1408
+ }
1409
+ ```
1410
+
1411
+ - 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)]:
1412
+ - @mastra/core@1.0.0-beta.16
1413
+
1414
+ ## 1.0.0-beta.9
1415
+
1416
+ ### Minor Changes
1417
+
1418
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
1419
+
1420
+ 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.
1421
+
1422
+ **Key changes:**
1423
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
1424
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
1425
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
1426
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
1427
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
1428
+
1429
+ **Why this matters:**
1430
+
1431
+ This enables composite storage where you can use different database adapters per domain:
1432
+
1433
+ ```typescript
1434
+ import { Mastra } from '@mastra/core';
1435
+ import { PostgresStore } from '@mastra/pg';
1436
+ import { ClickhouseStore } from '@mastra/clickhouse';
1437
+
1438
+ // Use Postgres for most domains but Clickhouse for observability
1439
+ const mastra = new Mastra({
1440
+ storage: new PostgresStore({
1441
+ connectionString: 'postgres://...',
1442
+ }),
1443
+ // Future: override specific domains
1444
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
1445
+ });
1446
+ ```
1447
+
1448
+ **Standalone domain usage:**
1449
+
1450
+ Domains can now be used independently with flexible configuration:
1451
+
1452
+ ```typescript
1453
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
1454
+
1455
+ // Option 1: Pass config to create client internally
1456
+ const memory = new MemoryLibSQL({
1457
+ url: 'file:./local.db',
1458
+ });
1459
+
1460
+ // Option 2: Pass existing client for shared connections
1461
+ import { createClient } from '@libsql/client';
1462
+ const client = createClient({ url: 'file:./local.db' });
1463
+ const memory = new MemoryLibSQL({ client });
1464
+ ```
1465
+
1466
+ **Breaking changes:**
1467
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
1468
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
1469
+
1470
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
1471
+
1472
+ ### Summary
1473
+
1474
+ 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.
1475
+
1476
+ ### Migration Guide
1477
+
1478
+ All direct method calls on storage instances should be updated to use `getStore()`:
1479
+
1480
+ ```typescript
1481
+ // Before
1482
+ const thread = await storage.getThreadById({ threadId });
1483
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1484
+ await storage.createSpan(span);
1485
+
1486
+ // After
1487
+ const memory = await storage.getStore('memory');
1488
+ const thread = await memory?.getThreadById({ threadId });
1489
+
1490
+ const workflows = await storage.getStore('workflows');
1491
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1492
+
1493
+ const observability = await storage.getStore('observability');
1494
+ await observability?.createSpan(span);
1495
+ ```
1496
+
1497
+ ### Available Domains
1498
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
1499
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
1500
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
1501
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
1502
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
1503
+
1504
+ ### Breaking Changes
1505
+ - Passthrough methods have been removed from `MastraStorage` base class
1506
+ - All storage adapters now require accessing domains via `getStore()`
1507
+ - The `stores` property on storage instances is now the canonical way to access domain storage
1508
+
1509
+ ### Internal Changes
1510
+ - Each storage adapter now initializes domain-specific stores in its constructor
1511
+ - Domain stores share database connections and handle their own table initialization
1512
+
1513
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
1514
+
1515
+ ## What changed
1516
+
1517
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
1518
+
1519
+ **Before:**
1520
+
1521
+ ```typescript
1522
+ // Old span structure
1523
+ span.agentId; // 'my-agent'
1524
+ span.toolId; // undefined
1525
+ span.workflowId; // undefined
1526
+ ```
1527
+
1528
+ **After:**
1529
+
1530
+ ```typescript
1531
+ // New span structure
1532
+ span.entityType; // EntityType.AGENT
1533
+ span.entityId; // 'my-agent'
1534
+ span.entityName; // 'My Agent'
1535
+ ```
1536
+
1537
+ ## New `listTraces()` API
1538
+
1539
+ Query traces with filtering, pagination, and sorting:
1540
+
1541
+ ```typescript
1542
+ const { spans, pagination } = await storage.listTraces({
1543
+ filters: {
1544
+ entityType: EntityType.AGENT,
1545
+ entityId: 'my-agent',
1546
+ userId: 'user-123',
1547
+ environment: 'production',
1548
+ status: TraceStatus.SUCCESS,
1549
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1550
+ },
1551
+ pagination: { page: 0, perPage: 50 },
1552
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1553
+ });
1554
+ ```
1555
+
1556
+ **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`.
1557
+
1558
+ ## New retrieval methods
1559
+ - `getSpan({ traceId, spanId })` - Get a single span
1560
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1561
+ - `getTrace({ traceId })` - Get all spans for a trace
1562
+
1563
+ ## Backward compatibility
1564
+
1565
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1566
+
1567
+ ## Migration
1568
+
1569
+ **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`.
1570
+
1571
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1572
+
1573
+ ### Patch Changes
1574
+
1575
+ - Fix severe performance issue with semantic recall on large message tables ([#11365](https://github.com/mastra-ai/mastra/pull/11365))
1576
+
1577
+ The `_getIncludedMessages` method was using `ROW_NUMBER() OVER (ORDER BY createdAt)` which scanned all messages in a thread to assign row numbers. On tables with 1M+ rows, this caused 5-10 minute query times.
1578
+
1579
+ Replaced with cursor-based pagination using the existing `(thread_id, createdAt)` index:
1580
+
1581
+ ```sql
1582
+ -- Before: scans entire thread
1583
+ ROW_NUMBER() OVER (ORDER BY "createdAt" ASC)
1584
+
1585
+ -- After: uses index, fetches only needed rows
1586
+ WHERE createdAt <= (target) ORDER BY createdAt DESC LIMIT N
1587
+ ```
1588
+
1589
+ Performance improvement: ~49x faster (832ms → 17ms) for typical semantic recall queries.
1590
+
1591
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
1592
+
1593
+ **What changed**
1594
+
1595
+ 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.
1596
+
1597
+ **Example**
1598
+
1599
+ ```typescript
1600
+ import { createClient } from '@clickhouse/client';
1601
+ import { ClickhouseStore } from '@mastra/clickhouse';
1602
+
1603
+ // Create and configure client with custom settings
1604
+ const client = createClient({
1605
+ url: 'http://localhost:8123',
1606
+ username: 'default',
1607
+ password: '',
1608
+ request_timeout: 60000,
1609
+ });
1610
+
1611
+ // Pass pre-configured client to store
1612
+ const store = new ClickhouseStore({
1613
+ id: 'my-store',
1614
+ client,
1615
+ });
1616
+ ```
1617
+
1618
+ **Additional improvements**
1619
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
1620
+
1621
+ - Add index configuration options to storage stores ([#11311](https://github.com/mastra-ai/mastra/pull/11311))
1622
+
1623
+ Storage stores now support two new configuration options for index management:
1624
+ - `skipDefaultIndexes`: When `true`, default performance indexes are not created during `init()`. Useful for custom index strategies or reducing initialization time.
1625
+ - `indexes`: Array of custom index definitions to create during `init()`. Indexes are routed to the appropriate domain based on table/collection name.
1626
+
1627
+ ```typescript
1628
+ // Skip default indexes and use custom ones
1629
+ const store = new PostgresStore({
1630
+ connectionString: '...',
1631
+ skipDefaultIndexes: true,
1632
+ indexes: [{ name: 'threads_type_idx', table: 'mastra_threads', columns: ["metadata->>'type'"] }],
1633
+ });
1634
+
1635
+ // MongoDB equivalent
1636
+ const mongoStore = new MongoDBStore({
1637
+ url: 'mongodb://...',
1638
+ skipDefaultIndexes: true,
1639
+ indexes: [{ collection: 'mastra_threads', keys: { 'metadata.type': 1 }, options: { name: 'threads_type_idx' } }],
1640
+ });
1641
+ ```
1642
+
1643
+ Domain classes (e.g., `MemoryPG`, `MemoryStorageMongoDB`) also accept these options for standalone usage.
1644
+
1645
+ - 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)]:
1646
+ - @mastra/core@1.0.0-beta.15
1647
+
1648
+ ## 1.0.0-beta.8
1649
+
1650
+ ### Patch Changes
1651
+
1652
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
1653
+
1654
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
1655
+
1656
+ **Before:**
1657
+
1658
+ ```typescript
1659
+ const result = await workflow.execute({ input });
1660
+ if (result.status === 'failed') {
1661
+ // Custom error properties were lost
1662
+ console.log(result.error); // "Step execution failed" (just a string)
1663
+ }
1664
+ ```
1665
+
1666
+ **After:**
1667
+
1668
+ ```typescript
1669
+ const result = await workflow.execute({ input });
1670
+ if (result.status === 'failed') {
1671
+ // Custom properties are preserved
1672
+ console.log(result.error.message); // "Step execution failed"
1673
+ console.log(result.error.statusCode); // 429
1674
+ console.log(result.error.cause?.name); // "RateLimitError"
1675
+ }
1676
+ ```
1677
+
1678
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
1679
+
1680
+ Other changes:
1681
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
1682
+
1683
+ - fix: make getSqlType consistent across storage adapters ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
1684
+ - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()`
1685
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
1686
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
1687
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
1688
+
1689
+ - 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)]:
1690
+ - @mastra/core@1.0.0-beta.12
1691
+
1692
+ ## 1.0.0-beta.7
1693
+
1694
+ ### Patch Changes
1695
+
1696
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
1697
+
1698
+ ```typescript
1699
+ await workflow.deleteWorkflowRunById(runId);
1700
+ ```
1701
+
1702
+ - Add halfvec type support for large dimension embeddings ([#11002](https://github.com/mastra-ai/mastra/pull/11002))
1703
+
1704
+ Adds `vectorType` option to `createIndex()` for choosing between full precision (`vector`) and half precision (`halfvec`) storage. halfvec uses 2 bytes per dimension instead of 4, enabling indexes on embeddings up to 4000 dimensions.
1705
+
1706
+ ```typescript
1707
+ await pgVector.createIndex({
1708
+ indexName: 'large-embeddings',
1709
+ dimension: 3072, // text-embedding-3-large
1710
+ metric: 'cosine',
1711
+ vectorType: 'halfvec',
1712
+ });
1713
+ ```
1714
+
1715
+ Requires pgvector >= 0.7.0 for halfvec support. Docker compose files updated to use pgvector 0.8.0.
1716
+
1717
+ - 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)]:
1718
+ - @mastra/core@1.0.0-beta.10
1719
+
1720
+ ## 1.0.0-beta.6
1721
+
1722
+ ### Minor Changes
1723
+
1724
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
1725
+
1726
+ 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.
1727
+
1728
+ ```typescript
1729
+ import { Mastra } from '@mastra/core';
1730
+ import { LibSQLStore } from '@mastra/libsql';
1731
+
1732
+ const mastra = new Mastra({
1733
+ storage: new LibSQLStore({ url: ':memory:' }),
1734
+ tools: { myTool },
1735
+ scorers: { myScorer },
1736
+ });
1737
+
1738
+ // Create agent in storage via API or directly
1739
+ await mastra.getStorage().createAgent({
1740
+ agent: {
1741
+ id: 'my-agent',
1742
+ name: 'My Agent',
1743
+ instructions: 'You are helpful',
1744
+ model: { provider: 'openai', name: 'gpt-4' },
1745
+ tools: { myTool: {} },
1746
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
1747
+ },
1748
+ });
1749
+
1750
+ // Load and use the agent
1751
+ const agent = await mastra.getStoredAgentById('my-agent');
1752
+ const response = await agent.generate({ messages: 'Hello!' });
1753
+
1754
+ // List all stored agents with pagination
1755
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
1756
+ page: 0,
1757
+ perPage: 10,
1758
+ });
1759
+ ```
1760
+
1761
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
1762
+
1763
+ ### Patch Changes
1764
+
1765
+ - 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)]:
1766
+ - @mastra/core@1.0.0-beta.9
1767
+
1768
+ ## 1.0.0-beta.5
1769
+
1770
+ ### Patch Changes
1771
+
1772
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
1773
+
1774
+ **What Changed**
1775
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
1776
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
1777
+
1778
+ **Impact**
1779
+ 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.
1780
+
1781
+ - PostgresStore was setting `this.stores = {}` in the constructor and only populating it in the async `init()` method. This broke Memory because it checks `storage.stores.memory` synchronously in `getInputProcessors()` before `init()` is called. ([#10943](https://github.com/mastra-ai/mastra/pull/10943))
1782
+
1783
+ The fix moves domain instance creation to the constructor. This is safe because pg-promise creates database connections lazily when queries are executed.
1784
+
1785
+ - 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)]:
1786
+ - @mastra/core@1.0.0-beta.8
1787
+
1788
+ ## 1.0.0-beta.4
1789
+
1790
+ ### Minor Changes
1791
+
1792
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
1793
+
1794
+ 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.
1795
+
1796
+ ```typescript
1797
+ // CI/CD script - run migrations
1798
+ const storage = new PostgresStore({
1799
+ connectionString: DATABASE_URL,
1800
+ id: 'pg-storage',
1801
+ });
1802
+ await storage.init();
1803
+
1804
+ // Runtime - skip auto-init
1805
+ const storage = new PostgresStore({
1806
+ connectionString: DATABASE_URL,
1807
+ id: 'pg-storage',
1808
+ disableInit: true,
1809
+ });
1810
+ ```
1811
+
1812
+ ### Patch Changes
1813
+
1814
+ - 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))
1815
+
1816
+ - 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)]:
1817
+ - @mastra/core@1.0.0-beta.7
1818
+
1819
+ ## 1.0.0-beta.3
1820
+
1821
+ ### Patch Changes
1822
+
1823
+ - fix(pg): qualify vector type to fix schema lookup ([#10786](https://github.com/mastra-ai/mastra/pull/10786))
1824
+
1825
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
1826
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
1827
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
1828
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
1829
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
1830
+
1831
+ - fix: ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
1832
+
1833
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
1834
+
1835
+ 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:
1836
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
1837
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
1838
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
1839
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
1840
+
1841
+ 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.
1842
+
1843
+ - 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)]:
1844
+ - @mastra/core@1.0.0-beta.6
1845
+
1846
+ ## 1.0.0-beta.2
1847
+
1848
+ ### Patch Changes
1849
+
1850
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
1851
+
1852
+ - 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)]:
1853
+ - @mastra/core@1.0.0-beta.5
1854
+
1855
+ ## 1.0.0-beta.1
1856
+
1857
+ ### Patch Changes
1858
+
1859
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
1860
+ Add status filter to `listWorkflowRuns`
1861
+ Add automatic restart to restart active workflow runs when server starts
1862
+ - 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)]:
1863
+ - @mastra/core@1.0.0-beta.3
1864
+
1865
+ ## 1.0.0-beta.0
4
1866
 
5
1867
  ### Major Changes
6
1868
 
1869
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
1870
+
1871
+ - 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))
1872
+
1873
+ Primitives that are added to other primitives are also automatically added to the Mastra instance
1874
+
1875
+ - 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))
1876
+
1877
+ - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
1878
+
1879
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
1880
+
1881
+ **Storage changes:**
1882
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
1883
+ - All storage implementations support `perPage: false`:
1884
+ - Memory: `listMessages()`
1885
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
1886
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
1887
+
1888
+ **Memory changes:**
1889
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
1890
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
1891
+
1892
+ **Stricter validation:**
1893
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
1894
+
1895
+ **Migration:**
1896
+
1897
+ ```typescript
1898
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
1899
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
1900
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
1901
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
1902
+
1903
+ // Memory: Replace selectBy with flat parameters
1904
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
1905
+ + memory.query({ threadId, perPage: 20, include: [...] })
1906
+
1907
+ // Client SDK
1908
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
1909
+ + thread.listMessages({ page: 0, perPage: 20 })
1910
+ ```
1911
+
1912
+ - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
1913
+
1914
+ ## Storage Layer
1915
+
1916
+ ### BREAKING: Removed `storage.getMessages()`
1917
+
1918
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
1919
+
1920
+ **Migration:**
1921
+
1922
+ ```typescript
1923
+ // Before
1924
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
1925
+
1926
+ // After
1927
+ const result = await storage.listMessages({
1928
+ threadId: 'thread-1',
1929
+ page: 0,
1930
+ perPage: 50,
1931
+ });
1932
+ const messages = result.messages; // Access messages array
1933
+ console.log(result.total); // Total count
1934
+ console.log(result.hasMore); // Whether more pages exist
1935
+ ```
1936
+
1937
+ ### Message ordering default
1938
+
1939
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
1940
+
1941
+ **To use DESC ordering (newest first):**
1942
+
1943
+ ```typescript
1944
+ const result = await storage.listMessages({
1945
+ threadId: 'thread-1',
1946
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1947
+ });
1948
+ ```
1949
+
1950
+ ## Client SDK
1951
+
1952
+ ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
1953
+
1954
+ **Migration:**
1955
+
1956
+ ```typescript
1957
+ // Before
1958
+ const response = await client.getThreadMessages(threadId, { agentId });
1959
+
1960
+ // After
1961
+ const response = await client.listThreadMessages(threadId, { agentId });
1962
+ ```
1963
+
1964
+ The response format remains the same.
1965
+
1966
+ ## Type Changes
1967
+
1968
+ ### BREAKING: Removed `StorageGetMessagesArg` type
1969
+
1970
+ Use `StorageListMessagesInput` instead:
1971
+
1972
+ ```typescript
1973
+ // Before
1974
+ import type { StorageGetMessagesArg } from '@mastra/core';
1975
+
1976
+ // After
1977
+ import type { StorageListMessagesInput } from '@mastra/core';
1978
+ ```
1979
+
1980
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
1981
+
1982
+ - 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))
1983
+
1984
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
1985
+
1986
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
1987
+
1988
+ - 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))
1989
+
1990
+ - 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))
1991
+
1992
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
1993
+
1994
+ - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
1995
+
1996
+ 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.
1997
+
1998
+ **Affected APIs:**
1999
+ - `Memory.listThreadsByResourceId()`
2000
+ - `Memory.listMessages()`
2001
+ - `Storage.listWorkflowRuns()`
2002
+
2003
+ **Migration:**
2004
+
2005
+ ```typescript
2006
+ // Before
2007
+ await memory.listThreadsByResourceId({
2008
+ resourceId: 'user-123',
2009
+ offset: 20,
2010
+ limit: 10,
2011
+ });
2012
+
2013
+ // After
2014
+ await memory.listThreadsByResourceId({
2015
+ resourceId: 'user-123',
2016
+ page: 2, // page = Math.floor(offset / limit)
2017
+ perPage: 10,
2018
+ });
2019
+
2020
+ // Before
2021
+ await memory.listMessages({
2022
+ threadId: 'thread-456',
2023
+ offset: 20,
2024
+ limit: 10,
2025
+ });
2026
+
2027
+ // After
2028
+ await memory.listMessages({
2029
+ threadId: 'thread-456',
2030
+ page: 2,
2031
+ perPage: 10,
2032
+ });
2033
+
2034
+ // Before
2035
+ await storage.listWorkflowRuns({
2036
+ workflowName: 'my-workflow',
2037
+ offset: 20,
2038
+ limit: 10,
2039
+ });
2040
+
2041
+ // After
2042
+ await storage.listWorkflowRuns({
2043
+ workflowName: 'my-workflow',
2044
+ page: 2,
2045
+ perPage: 10,
2046
+ });
2047
+ ```
2048
+
2049
+ **Additional improvements:**
2050
+ - Added validation for negative `page` values in all storage implementations
2051
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
2052
+ - Added reusable query parser utilities for consistent validation in handlers
2053
+
2054
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
2055
+ import { Mastra } from '@mastra/core';
2056
+ import { Observability } from '@mastra/observability'; // Explicit import
2057
+
2058
+ const mastra = new Mastra({
2059
+ ...other_config,
2060
+ observability: new Observability({
2061
+ default: { enabled: true }
2062
+ }) // Instance
2063
+ });
2064
+ ```
2065
+
2066
+ Instead of:
2067
+
2068
+ ```
2069
+ import { Mastra } from '@mastra/core';
2070
+ import '@mastra/observability/init'; // Explicit import
2071
+
2072
+ const mastra = new Mastra({
2073
+ ...other_config,
2074
+ observability: {
2075
+ default: { enabled: true }
2076
+ }
2077
+ });
2078
+ ```
2079
+
2080
+ Also renamed a bunch of:
2081
+ - `Tracing` things to `Observability` things.
2082
+ - `AI-` things to just things.
2083
+
7
2084
  - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
8
2085
 
2086
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
2087
+
2088
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
2089
+ 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
2090
+
2091
+ - moved ai-tracing code into @mastra/observability ([#9661](https://github.com/mastra-ai/mastra/pull/9661))
2092
+
2093
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
2094
+
9
2095
  ### Minor Changes
10
2096
 
11
2097
  - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
12
2098
 
13
2099
  ### Patch Changes
14
2100
 
15
- - Fixes "invalid input syntax for type json" error in AI tracing with PostgreSQL. ([#9154](https://github.com/mastra-ai/mastra/pull/9154))
2101
+ - Fix pg listThreadsByResourceId page number validation ([#9671](https://github.com/mastra-ai/mastra/pull/9671))
2102
+
2103
+ - Fixes "invalid input syntax for type json" error in tracing with PostgreSQL. ([#9154](https://github.com/mastra-ai/mastra/pull/9154))
16
2104
 
17
- - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`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), [`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), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`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), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
18
- - @mastra/core@0.0.0-bundle-recursion-20251030002519
2105
+ - 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)]:
2106
+ - @mastra/core@1.0.0-beta.0
19
2107
 
20
2108
  ## 0.17.5
21
2109