@mastra/clickhouse 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 (32) hide show
  1. package/CHANGELOG.md +1594 -3
  2. package/README.md +51 -23
  3. package/dist/docs/README.md +31 -0
  4. package/dist/docs/SKILL.md +32 -0
  5. package/dist/docs/SOURCE_MAP.json +6 -0
  6. package/dist/docs/storage/01-reference.md +182 -0
  7. package/dist/index.cjs +1744 -1044
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.d.ts +1 -1
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +1741 -1045
  12. package/dist/index.js.map +1 -1
  13. package/dist/storage/db/index.d.ts +123 -0
  14. package/dist/storage/db/index.d.ts.map +1 -0
  15. package/dist/storage/db/utils.d.ts.map +1 -0
  16. package/dist/storage/domains/memory/index.d.ts +20 -45
  17. package/dist/storage/domains/memory/index.d.ts.map +1 -1
  18. package/dist/storage/domains/observability/index.d.ts +51 -0
  19. package/dist/storage/domains/observability/index.d.ts.map +1 -0
  20. package/dist/storage/domains/scores/index.d.ts +20 -29
  21. package/dist/storage/domains/scores/index.d.ts.map +1 -1
  22. package/dist/storage/domains/workflows/index.d.ts +18 -26
  23. package/dist/storage/domains/workflows/index.d.ts.map +1 -1
  24. package/dist/storage/index.d.ts +138 -217
  25. package/dist/storage/index.d.ts.map +1 -1
  26. package/package.json +16 -11
  27. package/dist/storage/domains/legacy-evals/index.d.ts +0 -21
  28. package/dist/storage/domains/legacy-evals/index.d.ts.map +0 -1
  29. package/dist/storage/domains/operations/index.d.ts +0 -42
  30. package/dist/storage/domains/operations/index.d.ts.map +0 -1
  31. package/dist/storage/domains/utils.d.ts.map +0 -1
  32. /package/dist/storage/{domains → db}/utils.d.ts +0 -0
package/CHANGELOG.md CHANGED
@@ -1,19 +1,1610 @@
1
1
  # @mastra/clickhouse
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
+ - 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))
17
+
18
+ - Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
19
+
20
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
21
+
22
+ **Storage changes:**
23
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
24
+ - All storage implementations support `perPage: false`:
25
+ - Memory: `listMessages()`
26
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
27
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
28
+
29
+ **Memory changes:**
30
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
31
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
32
+
33
+ **Stricter validation:**
34
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
35
+
36
+ **Migration:**
37
+
38
+ ```typescript
39
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
40
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
41
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
42
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
43
+
44
+ // Memory: Replace selectBy with flat parameters
45
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
46
+ + memory.query({ threadId, perPage: 20, include: [...] })
47
+
48
+ // Client SDK
49
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
50
+ + thread.listMessages({ page: 0, perPage: 20 })
51
+ ```
52
+
53
+ - **Removed `storage.getMessages()`** ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
54
+
55
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
56
+
57
+ **Migration:**
58
+
59
+ ```typescript
60
+ // Before
61
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
62
+
63
+ // After
64
+ const result = await storage.listMessages({
65
+ threadId: 'thread-1',
66
+ page: 0,
67
+ perPage: 50,
68
+ });
69
+ const messages = result.messages; // Access messages array
70
+ console.log(result.total); // Total count
71
+ console.log(result.hasMore); // Whether more pages exist
72
+ ```
73
+
74
+ **Message ordering default**
75
+
76
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
77
+
78
+ **To use DESC ordering (newest first):**
79
+
80
+ ```typescript
81
+ const result = await storage.listMessages({
82
+ threadId: 'thread-1',
83
+ orderBy: { field: 'createdAt', direction: 'DESC' },
84
+ });
85
+ ```
86
+
87
+ **Renamed `client.getThreadMessages()` → `client.listThreadMessages()`**
88
+
89
+ **Migration:**
90
+
91
+ ```typescript
92
+ // Before
93
+ const response = await client.getThreadMessages(threadId, { agentId });
94
+
95
+ // After
96
+ const response = await client.listThreadMessages(threadId, { agentId });
97
+ ```
98
+
99
+ The response format remains the same.
100
+
101
+ **Removed `StorageGetMessagesArg` type**
102
+
103
+ Use `StorageListMessagesInput` instead:
104
+
105
+ ```typescript
106
+ // Before
107
+ import type { StorageGetMessagesArg } from '@mastra/core';
108
+
109
+ // After
110
+ import type { StorageListMessagesInput } from '@mastra/core';
111
+ ```
112
+
113
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
114
+
115
+ - 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))
116
+
117
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
118
+
119
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
120
+
121
+ - 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))
122
+
123
+ - 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))
124
+
125
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
126
+
127
+ - Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
128
+
129
+ 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.
130
+
131
+ **Affected APIs:**
132
+ - `Memory.listThreadsByResourceId()`
133
+ - `Memory.listMessages()`
134
+ - `Storage.listWorkflowRuns()`
135
+
136
+ **Migration:**
137
+
138
+ ```typescript
139
+ // Before
140
+ await memory.listThreadsByResourceId({
141
+ resourceId: 'user-123',
142
+ offset: 20,
143
+ limit: 10,
144
+ });
145
+
146
+ // After
147
+ await memory.listThreadsByResourceId({
148
+ resourceId: 'user-123',
149
+ page: 2, // page = Math.floor(offset / limit)
150
+ perPage: 10,
151
+ });
152
+
153
+ // Before
154
+ await memory.listMessages({
155
+ threadId: 'thread-456',
156
+ offset: 20,
157
+ limit: 10,
158
+ });
159
+
160
+ // After
161
+ await memory.listMessages({
162
+ threadId: 'thread-456',
163
+ page: 2,
164
+ perPage: 10,
165
+ });
166
+
167
+ // Before
168
+ await storage.listWorkflowRuns({
169
+ workflowName: 'my-workflow',
170
+ offset: 20,
171
+ limit: 10,
172
+ });
173
+
174
+ // After
175
+ await storage.listWorkflowRuns({
176
+ workflowName: 'my-workflow',
177
+ page: 2,
178
+ perPage: 10,
179
+ });
180
+ ```
181
+
182
+ **Additional improvements:**
183
+ - Added validation for negative `page` values in all storage implementations
184
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
185
+ - Added reusable query parser utilities for consistent validation in handlers
186
+
187
+ - ```ts ([#9709](https://github.com/mastra-ai/mastra/pull/9709))
188
+ import { Mastra } from '@mastra/core';
189
+ import { Observability } from '@mastra/observability'; // Explicit import
190
+
191
+ const mastra = new Mastra({
192
+ ...other_config,
193
+ observability: new Observability({
194
+ default: { enabled: true },
195
+ }), // Instance
196
+ });
197
+ ```
198
+
199
+ Instead of:
200
+
201
+ ```ts
202
+ import { Mastra } from '@mastra/core';
203
+ import '@mastra/observability/init'; // Explicit import
204
+
205
+ const mastra = new Mastra({
206
+ ...other_config,
207
+ observability: {
208
+ default: { enabled: true },
209
+ },
210
+ });
211
+ ```
212
+
213
+ Also renamed a bunch of:
214
+ - `Tracing` things to `Observability` things.
215
+ - `AI-` things to just things.
216
+
217
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
218
+
219
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
220
+
221
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
222
+ 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
223
+
224
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
225
+
226
+ ### Minor Changes
227
+
228
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
229
+
230
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
231
+
232
+ 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.
233
+
234
+ **Key changes:**
235
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
236
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
237
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
238
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
239
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
240
+
241
+ **Why this matters:**
242
+
243
+ This enables composite storage where you can use different database adapters per domain:
244
+
245
+ ```typescript
246
+ import { Mastra } from '@mastra/core';
247
+ import { PostgresStore } from '@mastra/pg';
248
+ import { ClickhouseStore } from '@mastra/clickhouse';
249
+
250
+ // Use Postgres for most domains but Clickhouse for observability
251
+ const mastra = new Mastra({
252
+ storage: new PostgresStore({
253
+ connectionString: 'postgres://...',
254
+ }),
255
+ // Future: override specific domains
256
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
257
+ });
258
+ ```
259
+
260
+ **Standalone domain usage:**
261
+
262
+ Domains can now be used independently with flexible configuration:
263
+
264
+ ```typescript
265
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
266
+
267
+ // Option 1: Pass config to create client internally
268
+ const memory = new MemoryLibSQL({
269
+ url: 'file:./local.db',
270
+ });
271
+
272
+ // Option 2: Pass existing client for shared connections
273
+ import { createClient } from '@libsql/client';
274
+ const client = createClient({ url: 'file:./local.db' });
275
+ const memory = new MemoryLibSQL({ client });
276
+ ```
277
+
278
+ **Breaking changes:**
279
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
280
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
281
+
282
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
283
+
284
+ ### Summary
285
+
286
+ 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.
287
+
288
+ ### Migration Guide
289
+
290
+ All direct method calls on storage instances should be updated to use `getStore()`:
291
+
292
+ ```typescript
293
+ // Before
294
+ const thread = await storage.getThreadById({ threadId });
295
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
296
+ await storage.createSpan(span);
297
+
298
+ // After
299
+ const memory = await storage.getStore('memory');
300
+ const thread = await memory?.getThreadById({ threadId });
301
+
302
+ const workflows = await storage.getStore('workflows');
303
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
304
+
305
+ const observability = await storage.getStore('observability');
306
+ await observability?.createSpan(span);
307
+ ```
308
+
309
+ ### Available Domains
310
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
311
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
312
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
313
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
314
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
315
+
316
+ ### Breaking Changes
317
+ - Passthrough methods have been removed from `MastraStorage` base class
318
+ - All storage adapters now require accessing domains via `getStore()`
319
+ - The `stores` property on storage instances is now the canonical way to access domain storage
320
+
321
+ ### Internal Changes
322
+ - Each storage adapter now initializes domain-specific stores in its constructor
323
+ - Domain stores share database connections and handle their own table initialization
324
+
325
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
326
+
327
+ ## What changed
328
+
329
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
330
+
331
+ **Before:**
332
+
333
+ ```typescript
334
+ // Old span structure
335
+ span.agentId; // 'my-agent'
336
+ span.toolId; // undefined
337
+ span.workflowId; // undefined
338
+ ```
339
+
340
+ **After:**
341
+
342
+ ```typescript
343
+ // New span structure
344
+ span.entityType; // EntityType.AGENT
345
+ span.entityId; // 'my-agent'
346
+ span.entityName; // 'My Agent'
347
+ ```
348
+
349
+ ## New `listTraces()` API
350
+
351
+ Query traces with filtering, pagination, and sorting:
352
+
353
+ ```typescript
354
+ const { spans, pagination } = await storage.listTraces({
355
+ filters: {
356
+ entityType: EntityType.AGENT,
357
+ entityId: 'my-agent',
358
+ userId: 'user-123',
359
+ environment: 'production',
360
+ status: TraceStatus.SUCCESS,
361
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
362
+ },
363
+ pagination: { page: 0, perPage: 50 },
364
+ orderBy: { field: 'startedAt', direction: 'DESC' },
365
+ });
366
+ ```
367
+
368
+ **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`.
369
+
370
+ ## New retrieval methods
371
+ - `getSpan({ traceId, spanId })` - Get a single span
372
+ - `getRootSpan({ traceId })` - Get the root span of a trace
373
+ - `getTrace({ traceId })` - Get all spans for a trace
374
+
375
+ ## Backward compatibility
376
+
377
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
378
+
379
+ ## Migration
380
+
381
+ **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`.
382
+
383
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
384
+
385
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
386
+
387
+ 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.
388
+
389
+ ```typescript
390
+ // CI/CD script - run migrations
391
+ const storage = new PostgresStore({
392
+ connectionString: DATABASE_URL,
393
+ id: 'pg-storage',
394
+ });
395
+ await storage.init();
396
+
397
+ // Runtime - skip auto-init
398
+ const storage = new PostgresStore({
399
+ connectionString: DATABASE_URL,
400
+ id: 'pg-storage',
401
+ disableInit: true,
402
+ });
403
+ ```
404
+
405
+ ### Patch Changes
406
+
407
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
408
+
409
+ 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`.
410
+
411
+ Each package includes:
412
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
413
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
414
+ - **Topic folders** - Conceptual documentation organized by feature area
415
+
416
+ 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.
417
+
418
+ - 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))
419
+
420
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
421
+
422
+ **What Changed**
423
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
424
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
425
+
426
+ **Impact**
427
+ 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.
428
+
429
+ - - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
430
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
431
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
432
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
433
+
434
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
435
+
436
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
437
+
438
+ **Before:**
439
+
440
+ ```typescript
441
+ const result = await workflow.execute({ input });
442
+ if (result.status === 'failed') {
443
+ // Custom error properties were lost
444
+ console.log(result.error); // "Step execution failed" (just a string)
445
+ }
446
+ ```
447
+
448
+ **After:**
449
+
450
+ ```typescript
451
+ const result = await workflow.execute({ input });
452
+ if (result.status === 'failed') {
453
+ // Custom properties are preserved
454
+ console.log(result.error.message); // "Step execution failed"
455
+ console.log(result.error.statusCode); // 429
456
+ console.log(result.error.cause?.name); // "RateLimitError"
457
+ }
458
+ ```
459
+
460
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
461
+
462
+ Other changes:
463
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
464
+
465
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
466
+
467
+ **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.
468
+
469
+ **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.
470
+
471
+ **Example:**
472
+
473
+ ```typescript
474
+ // Get first page
475
+ const page1 = await memory.recall({
476
+ threadId: 'thread-123',
477
+ perPage: 10,
478
+ orderBy: { field: 'createdAt', direction: 'DESC' },
479
+ });
480
+
481
+ // Get next page using cursor-based pagination
482
+ const oldestMessage = page1.messages[page1.messages.length - 1];
483
+ const page2 = await memory.recall({
484
+ threadId: 'thread-123',
485
+ perPage: 10,
486
+ orderBy: { field: 'createdAt', direction: 'DESC' },
487
+ filter: {
488
+ dateRange: {
489
+ end: oldestMessage.createdAt,
490
+ endExclusive: true, // Excludes the cursor message
491
+ },
492
+ },
493
+ });
494
+ ```
495
+
496
+ - Ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
497
+
498
+ - 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))
499
+
500
+ **Deduplication rules (in priority order):**
501
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
502
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
503
+ 3. Use `createdAt` as the final tiebreaker
504
+
505
+ **What changed:**
506
+ - Added `migrateSpans()` method to observability stores for manual migration
507
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
508
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
509
+
510
+ **Usage example:**
511
+
512
+ ```typescript
513
+ const observability = await storage.getStore('observability');
514
+ const status = await observability.checkSpansMigrationStatus();
515
+ if (status.needsMigration) {
516
+ const result = await observability.migrateSpans();
517
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
518
+ }
519
+ ```
520
+
521
+ Fixes #11840
522
+
523
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
524
+
525
+ `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.
526
+
527
+ ```typescript
528
+ import { MastraStorage } from '@mastra/core/storage';
529
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
530
+ import { MemoryLibSQL } from '@mastra/libsql';
531
+
532
+ // Compose domains from different stores
533
+ const storage = new MastraStorage({
534
+ id: 'composite',
535
+ domains: {
536
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
537
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
538
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
539
+ },
540
+ });
541
+ ```
542
+
543
+ **Breaking changes:**
544
+ - `storage.supports` property no longer exists
545
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
546
+
547
+ All stores now support the same features. For domain availability, use `getStore()`:
548
+
549
+ ```typescript
550
+ const store = await storage.getStore('memory');
551
+ if (store) {
552
+ // domain is available
553
+ }
554
+ ```
555
+
556
+ - - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()` ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
557
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
558
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
559
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
560
+
561
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
562
+
563
+ ```typescript
564
+ await workflow.deleteWorkflowRunById(runId);
565
+ ```
566
+
567
+ - 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))
568
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
569
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
570
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
571
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
572
+
573
+ 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.
574
+
575
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
576
+
577
+ **New Features**
578
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
579
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
580
+ - Full pagination and sorting support
581
+
582
+ **Example Usage**
583
+
584
+ ```typescript
585
+ // List all threads
586
+ const allThreads = await memory.listThreads({});
587
+
588
+ // Filter by resourceId only
589
+ const userThreads = await memory.listThreads({
590
+ filter: { resourceId: 'user-123' },
591
+ });
592
+
593
+ // Filter by metadata only
594
+ const supportThreads = await memory.listThreads({
595
+ filter: { metadata: { category: 'support' } },
596
+ });
597
+
598
+ // Filter by both with pagination
599
+ const filteredThreads = await memory.listThreads({
600
+ filter: {
601
+ resourceId: 'user-123',
602
+ metadata: { priority: 'high', status: 'open' },
603
+ },
604
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
605
+ page: 0,
606
+ perPage: 20,
607
+ });
608
+ ```
609
+
610
+ **Security Improvements**
611
+ - Added validation to prevent SQL injection via malicious metadata keys
612
+ - Added pagination parameter validation to prevent integer overflow attacks
613
+
614
+ - 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))
615
+
616
+ **Why this change?**
617
+
618
+ 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.
619
+
620
+ **@mastra/libsql** (Breaking)
621
+
622
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
623
+
624
+ ```typescript
625
+ // Before
626
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
627
+
628
+ // After
629
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
630
+ ```
631
+
632
+ **@mastra/opensearch** (Breaking)
633
+
634
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
635
+
636
+ ```typescript
637
+ // Before
638
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
639
+
640
+ // After
641
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
642
+
643
+ // With authentication (now possible)
644
+ new OpenSearchVector({
645
+ id: 'my-vector',
646
+ node: 'https://localhost:9200',
647
+ auth: { username: 'admin', password: 'admin' },
648
+ ssl: { rejectUnauthorized: false },
649
+ });
650
+ ```
651
+
652
+ **@mastra/pinecone** (Breaking)
653
+
654
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
655
+
656
+ ```typescript
657
+ // Before
658
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
659
+
660
+ // After
661
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
662
+
663
+ // With custom controller host (if needed)
664
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
665
+ ```
666
+
667
+ **@mastra/clickhouse**
668
+
669
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
670
+
671
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
672
+
673
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
674
+
675
+ **@mastra/deployer-cloud**
676
+
677
+ Updated internal LibSQLVector configuration for compatibility with the new API.
678
+
679
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
680
+ Add status filter to `listWorkflowRuns`
681
+ Add automatic restart to restart active workflow runs when server starts
682
+
683
+ - Fixed ClickHouse metadata handling to prevent empty string crashes when storing undefined metadata. ([#11898](https://github.com/mastra-ai/mastra/pull/11898))
684
+
685
+ **What changed:**
686
+ - Applied DEFAULT '{}' constraint to metadata columns for both 'text' and 'jsonb' types (previously only 'text')
687
+ - Extended `serializeMetadata()` and `parseMetadata()` helpers to resources (previously only threads)
688
+ - ClickHouse-specific issue: undefined values become empty strings in String columns, causing JSON.parse() crashes
689
+
690
+ **Why ClickHouse needs this:**
691
+ - ClickHouse has no native JSON type - both 'text' and 'jsonb' map to String columns
692
+ - When undefined is stored in String columns, it becomes `''` (empty string)
693
+ - On retrieval, `JSON.parse('')` crashes with "Unexpected end of JSON input"
694
+
695
+ **Impact:**
696
+ - Defense-in-depth: database-level DEFAULT '{}' + application-level safe parsing
697
+ - Prevents crashes across all ClickHouse storage domains (threads, resources, scorers, spans, agents)
698
+
699
+ Related to #11882
700
+
701
+ - 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))
702
+
703
+ **Migration:**
704
+
705
+ Update your imports and usage:
706
+
707
+ ```typescript
708
+ // Before
709
+ import { MastraStorage } from '@mastra/core/storage';
710
+
711
+ const storage = new MastraStorage({
712
+ id: 'composite',
713
+ domains: { ... }
714
+ });
715
+
716
+ // After
717
+ import { MastraCompositeStore } from '@mastra/core/storage';
718
+
719
+ const storage = new MastraCompositeStore({
720
+ id: 'composite',
721
+ domains: { ... }
722
+ });
723
+ ```
724
+
725
+ 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.
726
+
727
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
728
+
729
+ **What changed**
730
+
731
+ 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.
732
+
733
+ **Example**
734
+
735
+ ```typescript
736
+ import { createClient } from '@clickhouse/client';
737
+ import { ClickhouseStore } from '@mastra/clickhouse';
738
+
739
+ // Create and configure client with custom settings
740
+ const client = createClient({
741
+ url: 'http://localhost:8123',
742
+ username: 'default',
743
+ password: '',
744
+ request_timeout: 60000,
745
+ });
746
+
747
+ // Pass pre-configured client to store
748
+ const store = new ClickhouseStore({
749
+ id: 'my-store',
750
+ client,
751
+ });
752
+ ```
753
+
754
+ **Additional improvements**
755
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
756
+
757
+ - 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)]:
758
+ - @mastra/core@1.0.0
759
+
760
+ ## 1.0.0-beta.12
761
+
762
+ ### Patch Changes
763
+
764
+ - 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))
765
+
766
+ **Deduplication rules (in priority order):**
767
+ 1. Keep completed spans (those with `endedAt` set) over incomplete spans
768
+ 2. Among spans with the same completion status, keep the one with the newest `updatedAt`
769
+ 3. Use `createdAt` as the final tiebreaker
770
+
771
+ **What changed:**
772
+ - Added `migrateSpans()` method to observability stores for manual migration
773
+ - Added `checkSpansMigrationStatus()` method to check if migration is needed
774
+ - All stores use optimized single-query deduplication to avoid memory issues on large tables
775
+
776
+ **Usage example:**
777
+
778
+ ```typescript
779
+ const observability = await storage.getStore('observability');
780
+ const status = await observability.checkSpansMigrationStatus();
781
+ if (status.needsMigration) {
782
+ const result = await observability.migrateSpans();
783
+ console.log(`Migration complete: ${result.duplicatesRemoved} duplicates removed`);
784
+ }
785
+ ```
786
+
787
+ Fixes #11840
788
+
789
+ - 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))
790
+
791
+ **Migration:**
792
+
793
+ Update your imports and usage:
794
+
795
+ ```typescript
796
+ // Before
797
+ import { MastraStorage } from '@mastra/core/storage';
798
+
799
+ const storage = new MastraStorage({
800
+ id: 'composite',
801
+ domains: { ... }
802
+ });
803
+
804
+ // After
805
+ import { MastraCompositeStore } from '@mastra/core/storage';
806
+
807
+ const storage = new MastraCompositeStore({
808
+ id: 'composite',
809
+ domains: { ... }
810
+ });
811
+ ```
812
+
813
+ 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.
814
+
815
+ - Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897)]:
816
+ - @mastra/core@1.0.0-beta.26
817
+
818
+ ## 1.0.0-beta.11
819
+
820
+ ### Patch Changes
821
+
822
+ - Added new `listThreads` method for flexible thread filtering across all storage adapters. ([#11832](https://github.com/mastra-ai/mastra/pull/11832))
823
+
824
+ **New Features**
825
+ - Filter threads by `resourceId`, `metadata`, or both (with AND logic for metadata key-value pairs)
826
+ - All filter parameters are optional, allowing you to list all threads or filter as needed
827
+ - Full pagination and sorting support
828
+
829
+ **Example Usage**
830
+
831
+ ```typescript
832
+ // List all threads
833
+ const allThreads = await memory.listThreads({});
834
+
835
+ // Filter by resourceId only
836
+ const userThreads = await memory.listThreads({
837
+ filter: { resourceId: 'user-123' },
838
+ });
839
+
840
+ // Filter by metadata only
841
+ const supportThreads = await memory.listThreads({
842
+ filter: { metadata: { category: 'support' } },
843
+ });
844
+
845
+ // Filter by both with pagination
846
+ const filteredThreads = await memory.listThreads({
847
+ filter: {
848
+ resourceId: 'user-123',
849
+ metadata: { priority: 'high', status: 'open' },
850
+ },
851
+ orderBy: { field: 'updatedAt', direction: 'DESC' },
852
+ page: 0,
853
+ perPage: 20,
854
+ });
855
+ ```
856
+
857
+ **Security Improvements**
858
+ - Added validation to prevent SQL injection via malicious metadata keys
859
+ - Added pagination parameter validation to prevent integer overflow attacks
860
+
861
+ - 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)]:
862
+ - @mastra/core@1.0.0-beta.25
863
+
864
+ ## 1.0.0-beta.10
865
+
866
+ ### Patch Changes
867
+
868
+ - 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))
869
+
870
+ **Why this change?**
871
+
872
+ 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.
873
+
874
+ **@mastra/libsql** (Breaking)
875
+
876
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
877
+
878
+ ```typescript
879
+ // Before
880
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
881
+
882
+ // After
883
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
884
+ ```
885
+
886
+ **@mastra/opensearch** (Breaking)
887
+
888
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
889
+
890
+ ```typescript
891
+ // Before
892
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
893
+
894
+ // After
895
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
896
+
897
+ // With authentication (now possible)
898
+ new OpenSearchVector({
899
+ id: 'my-vector',
900
+ node: 'https://localhost:9200',
901
+ auth: { username: 'admin', password: 'admin' },
902
+ ssl: { rejectUnauthorized: false },
903
+ });
904
+ ```
905
+
906
+ **@mastra/pinecone** (Breaking)
907
+
908
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
909
+
910
+ ```typescript
911
+ // Before
912
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
913
+
914
+ // After
915
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
916
+
917
+ // With custom controller host (if needed)
918
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
919
+ ```
920
+
921
+ **@mastra/clickhouse**
922
+
923
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
924
+
925
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
926
+
927
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
928
+
929
+ **@mastra/deployer-cloud**
930
+
931
+ Updated internal LibSQLVector configuration for compatibility with the new API.
932
+
933
+ - Fixed ClickHouse metadata handling to prevent empty string crashes when storing undefined metadata. ([#11898](https://github.com/mastra-ai/mastra/pull/11898))
934
+
935
+ **What changed:**
936
+ - Applied DEFAULT '{}' constraint to metadata columns for both 'text' and 'jsonb' types (previously only 'text')
937
+ - Extended `serializeMetadata()` and `parseMetadata()` helpers to resources (previously only threads)
938
+ - ClickHouse-specific issue: undefined values become empty strings in String columns, causing JSON.parse() crashes
939
+
940
+ **Why ClickHouse needs this:**
941
+ - ClickHouse has no native JSON type - both 'text' and 'jsonb' map to String columns
942
+ - When undefined is stored in String columns, it becomes `''` (empty string)
943
+ - On retrieval, `JSON.parse('')` crashes with "Unexpected end of JSON input"
944
+
945
+ **Impact:**
946
+ - Defense-in-depth: database-level DEFAULT '{}' + application-level safe parsing
947
+ - Prevents crashes across all ClickHouse storage domains (threads, resources, scorers, spans, agents)
948
+
949
+ Related to #11882
950
+
951
+ - 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)]:
952
+ - @mastra/core@1.0.0-beta.22
953
+
954
+ ## 1.0.0-beta.9
955
+
956
+ ### Patch Changes
957
+
958
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
959
+
960
+ 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`.
961
+
962
+ Each package includes:
963
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
964
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
965
+ - **Topic folders** - Conceptual documentation organized by feature area
966
+
967
+ 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.
968
+
969
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
970
+
971
+ **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.
972
+
973
+ **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.
974
+
975
+ **Example:**
976
+
977
+ ```typescript
978
+ // Get first page
979
+ const page1 = await memory.recall({
980
+ threadId: 'thread-123',
981
+ perPage: 10,
982
+ orderBy: { field: 'createdAt', direction: 'DESC' },
983
+ });
984
+
985
+ // Get next page using cursor-based pagination
986
+ const oldestMessage = page1.messages[page1.messages.length - 1];
987
+ const page2 = await memory.recall({
988
+ threadId: 'thread-123',
989
+ perPage: 10,
990
+ orderBy: { field: 'createdAt', direction: 'DESC' },
991
+ filter: {
992
+ dateRange: {
993
+ end: oldestMessage.createdAt,
994
+ endExclusive: true, // Excludes the cursor message
995
+ },
996
+ },
997
+ });
998
+ ```
999
+
1000
+ - 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)]:
1001
+ - @mastra/core@1.0.0-beta.20
1002
+
1003
+ ## 1.0.0-beta.8
1004
+
1005
+ ### Patch Changes
1006
+
1007
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
1008
+
1009
+ `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.
1010
+
1011
+ ```typescript
1012
+ import { MastraStorage } from '@mastra/core/storage';
1013
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
1014
+ import { MemoryLibSQL } from '@mastra/libsql';
1015
+
1016
+ // Compose domains from different stores
1017
+ const storage = new MastraStorage({
1018
+ id: 'composite',
1019
+ domains: {
1020
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
1021
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
1022
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
1023
+ },
1024
+ });
1025
+ ```
1026
+
1027
+ **Breaking changes:**
1028
+ - `storage.supports` property no longer exists
1029
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
1030
+
1031
+ All stores now support the same features. For domain availability, use `getStore()`:
1032
+
1033
+ ```typescript
1034
+ const store = await storage.getStore('memory');
1035
+ if (store) {
1036
+ // domain is available
1037
+ }
1038
+ ```
1039
+
1040
+ - 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)]:
1041
+ - @mastra/core@1.0.0-beta.16
1042
+
1043
+ ## 1.0.0-beta.7
1044
+
1045
+ ### Minor Changes
1046
+
1047
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
1048
+
1049
+ 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.
1050
+
1051
+ **Key changes:**
1052
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
1053
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
1054
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
1055
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
1056
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
1057
+
1058
+ **Why this matters:**
1059
+
1060
+ This enables composite storage where you can use different database adapters per domain:
1061
+
1062
+ ```typescript
1063
+ import { Mastra } from '@mastra/core';
1064
+ import { PostgresStore } from '@mastra/pg';
1065
+ import { ClickhouseStore } from '@mastra/clickhouse';
1066
+
1067
+ // Use Postgres for most domains but Clickhouse for observability
1068
+ const mastra = new Mastra({
1069
+ storage: new PostgresStore({
1070
+ connectionString: 'postgres://...',
1071
+ }),
1072
+ // Future: override specific domains
1073
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
1074
+ });
1075
+ ```
1076
+
1077
+ **Standalone domain usage:**
1078
+
1079
+ Domains can now be used independently with flexible configuration:
1080
+
1081
+ ```typescript
1082
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
1083
+
1084
+ // Option 1: Pass config to create client internally
1085
+ const memory = new MemoryLibSQL({
1086
+ url: 'file:./local.db',
1087
+ });
1088
+
1089
+ // Option 2: Pass existing client for shared connections
1090
+ import { createClient } from '@libsql/client';
1091
+ const client = createClient({ url: 'file:./local.db' });
1092
+ const memory = new MemoryLibSQL({ client });
1093
+ ```
1094
+
1095
+ **Breaking changes:**
1096
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
1097
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
1098
+
1099
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
1100
+
1101
+ ### Summary
1102
+
1103
+ 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.
1104
+
1105
+ ### Migration Guide
1106
+
1107
+ All direct method calls on storage instances should be updated to use `getStore()`:
1108
+
1109
+ ```typescript
1110
+ // Before
1111
+ const thread = await storage.getThreadById({ threadId });
1112
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1113
+ await storage.createSpan(span);
1114
+
1115
+ // After
1116
+ const memory = await storage.getStore('memory');
1117
+ const thread = await memory?.getThreadById({ threadId });
1118
+
1119
+ const workflows = await storage.getStore('workflows');
1120
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
1121
+
1122
+ const observability = await storage.getStore('observability');
1123
+ await observability?.createSpan(span);
1124
+ ```
1125
+
1126
+ ### Available Domains
1127
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
1128
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
1129
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
1130
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
1131
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
1132
+
1133
+ ### Breaking Changes
1134
+ - Passthrough methods have been removed from `MastraStorage` base class
1135
+ - All storage adapters now require accessing domains via `getStore()`
1136
+ - The `stores` property on storage instances is now the canonical way to access domain storage
1137
+
1138
+ ### Internal Changes
1139
+ - Each storage adapter now initializes domain-specific stores in its constructor
1140
+ - Domain stores share database connections and handle their own table initialization
1141
+
1142
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
1143
+
1144
+ ## What changed
1145
+
1146
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
1147
+
1148
+ **Before:**
1149
+
1150
+ ```typescript
1151
+ // Old span structure
1152
+ span.agentId; // 'my-agent'
1153
+ span.toolId; // undefined
1154
+ span.workflowId; // undefined
1155
+ ```
1156
+
1157
+ **After:**
1158
+
1159
+ ```typescript
1160
+ // New span structure
1161
+ span.entityType; // EntityType.AGENT
1162
+ span.entityId; // 'my-agent'
1163
+ span.entityName; // 'My Agent'
1164
+ ```
1165
+
1166
+ ## New `listTraces()` API
1167
+
1168
+ Query traces with filtering, pagination, and sorting:
1169
+
1170
+ ```typescript
1171
+ const { spans, pagination } = await storage.listTraces({
1172
+ filters: {
1173
+ entityType: EntityType.AGENT,
1174
+ entityId: 'my-agent',
1175
+ userId: 'user-123',
1176
+ environment: 'production',
1177
+ status: TraceStatus.SUCCESS,
1178
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1179
+ },
1180
+ pagination: { page: 0, perPage: 50 },
1181
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1182
+ });
1183
+ ```
1184
+
1185
+ **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`.
1186
+
1187
+ ## New retrieval methods
1188
+ - `getSpan({ traceId, spanId })` - Get a single span
1189
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1190
+ - `getTrace({ traceId })` - Get all spans for a trace
1191
+
1192
+ ## Backward compatibility
1193
+
1194
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1195
+
1196
+ ## Migration
1197
+
1198
+ **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`.
1199
+
1200
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1201
+
1202
+ ### Patch Changes
1203
+
1204
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
1205
+
1206
+ **What changed**
1207
+
1208
+ 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.
1209
+
1210
+ **Example**
1211
+
1212
+ ```typescript
1213
+ import { createClient } from '@clickhouse/client';
1214
+ import { ClickhouseStore } from '@mastra/clickhouse';
1215
+
1216
+ // Create and configure client with custom settings
1217
+ const client = createClient({
1218
+ url: 'http://localhost:8123',
1219
+ username: 'default',
1220
+ password: '',
1221
+ request_timeout: 60000,
1222
+ });
1223
+
1224
+ // Pass pre-configured client to store
1225
+ const store = new ClickhouseStore({
1226
+ id: 'my-store',
1227
+ client,
1228
+ });
1229
+ ```
1230
+
1231
+ **Additional improvements**
1232
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
1233
+
1234
+ - 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)]:
1235
+ - @mastra/core@1.0.0-beta.15
1236
+
1237
+ ## 1.0.0-beta.6
1238
+
1239
+ ### Patch Changes
1240
+
1241
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
1242
+
1243
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
1244
+
1245
+ **Before:**
1246
+
1247
+ ```typescript
1248
+ const result = await workflow.execute({ input });
1249
+ if (result.status === 'failed') {
1250
+ // Custom error properties were lost
1251
+ console.log(result.error); // "Step execution failed" (just a string)
1252
+ }
1253
+ ```
1254
+
1255
+ **After:**
1256
+
1257
+ ```typescript
1258
+ const result = await workflow.execute({ input });
1259
+ if (result.status === 'failed') {
1260
+ // Custom properties are preserved
1261
+ console.log(result.error.message); // "Step execution failed"
1262
+ console.log(result.error.statusCode); // 429
1263
+ console.log(result.error.cause?.name); // "RateLimitError"
1264
+ }
1265
+ ```
1266
+
1267
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
1268
+
1269
+ Other changes:
1270
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
1271
+
1272
+ - fix: make getSqlType consistent across storage adapters ([#11112](https://github.com/mastra-ai/mastra/pull/11112))
1273
+ - PostgreSQL: use `getSqlType()` in `createTable` instead of `toUpperCase()`
1274
+ - LibSQL: use `getSqlType()` in `createTable`, return `JSONB` for jsonb type (matches SQLite 3.45+ support)
1275
+ - ClickHouse: use `getSqlType()` in `createTable` instead of `COLUMN_TYPES` constant, add missing types (uuid, float, boolean)
1276
+ - Remove unused `getSqlType()` and `getDefaultValue()` from `MastraStorage` base class (all stores use `StoreOperations` versions)
1277
+
1278
+ - 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)]:
1279
+ - @mastra/core@1.0.0-beta.12
1280
+
1281
+ ## 1.0.0-beta.5
1282
+
1283
+ ### Patch Changes
1284
+
1285
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
1286
+
1287
+ ```typescript
1288
+ await workflow.deleteWorkflowRunById(runId);
1289
+ ```
1290
+
1291
+ - 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)]:
1292
+ - @mastra/core@1.0.0-beta.10
1293
+
1294
+ ## 1.0.0-beta.4
1295
+
1296
+ ### Patch Changes
1297
+
1298
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
1299
+
1300
+ **What Changed**
1301
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
1302
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
1303
+
1304
+ **Impact**
1305
+ 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.
1306
+
1307
+ - 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)]:
1308
+ - @mastra/core@1.0.0-beta.8
1309
+
1310
+ ## 1.0.0-beta.3
1311
+
1312
+ ### Minor Changes
1313
+
1314
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
1315
+
1316
+ 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.
1317
+
1318
+ ```typescript
1319
+ // CI/CD script - run migrations
1320
+ const storage = new PostgresStore({
1321
+ connectionString: DATABASE_URL,
1322
+ id: 'pg-storage',
1323
+ });
1324
+ await storage.init();
1325
+
1326
+ // Runtime - skip auto-init
1327
+ const storage = new PostgresStore({
1328
+ connectionString: DATABASE_URL,
1329
+ id: 'pg-storage',
1330
+ disableInit: true,
1331
+ });
1332
+ ```
1333
+
1334
+ ### Patch Changes
1335
+
1336
+ - 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))
1337
+
1338
+ - 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)]:
1339
+ - @mastra/core@1.0.0-beta.7
1340
+
1341
+ ## 1.0.0-beta.2
1342
+
1343
+ ### Patch Changes
1344
+
1345
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
1346
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
1347
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
1348
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
1349
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
1350
+
1351
+ - fix: ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
1352
+
1353
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
1354
+
1355
+ 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:
1356
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
1357
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
1358
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
1359
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
1360
+
1361
+ 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.
1362
+
1363
+ - 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)]:
1364
+ - @mastra/core@1.0.0-beta.6
1365
+
1366
+ ## 1.0.0-beta.1
1367
+
1368
+ ### Patch Changes
1369
+
1370
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
1371
+ Add status filter to `listWorkflowRuns`
1372
+ Add automatic restart to restart active workflow runs when server starts
1373
+ - 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)]:
1374
+ - @mastra/core@1.0.0-beta.3
1375
+
1376
+ ## 1.0.0-beta.0
4
1377
 
5
1378
  ### Major Changes
6
1379
 
1380
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
1381
+
1382
+ - 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))
1383
+
1384
+ - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
1385
+
1386
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
1387
+
1388
+ **Storage changes:**
1389
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
1390
+ - All storage implementations support `perPage: false`:
1391
+ - Memory: `listMessages()`
1392
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
1393
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
1394
+
1395
+ **Memory changes:**
1396
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
1397
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
1398
+
1399
+ **Stricter validation:**
1400
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
1401
+
1402
+ **Migration:**
1403
+
1404
+ ```typescript
1405
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
1406
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
1407
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
1408
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
1409
+
1410
+ // Memory: Replace selectBy with flat parameters
1411
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
1412
+ + memory.query({ threadId, perPage: 20, include: [...] })
1413
+
1414
+ // Client SDK
1415
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
1416
+ + thread.listMessages({ page: 0, perPage: 20 })
1417
+ ```
1418
+
1419
+ - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
1420
+
1421
+ ## Storage Layer
1422
+
1423
+ ### BREAKING: Removed `storage.getMessages()`
1424
+
1425
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
1426
+
1427
+ **Migration:**
1428
+
1429
+ ```typescript
1430
+ // Before
1431
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
1432
+
1433
+ // After
1434
+ const result = await storage.listMessages({
1435
+ threadId: 'thread-1',
1436
+ page: 0,
1437
+ perPage: 50,
1438
+ });
1439
+ const messages = result.messages; // Access messages array
1440
+ console.log(result.total); // Total count
1441
+ console.log(result.hasMore); // Whether more pages exist
1442
+ ```
1443
+
1444
+ ### Message ordering default
1445
+
1446
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
1447
+
1448
+ **To use DESC ordering (newest first):**
1449
+
1450
+ ```typescript
1451
+ const result = await storage.listMessages({
1452
+ threadId: 'thread-1',
1453
+ orderBy: { field: 'createdAt', direction: 'DESC' },
1454
+ });
1455
+ ```
1456
+
1457
+ ## Client SDK
1458
+
1459
+ ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
1460
+
1461
+ **Migration:**
1462
+
1463
+ ```typescript
1464
+ // Before
1465
+ const response = await client.getThreadMessages(threadId, { agentId });
1466
+
1467
+ // After
1468
+ const response = await client.listThreadMessages(threadId, { agentId });
1469
+ ```
1470
+
1471
+ The response format remains the same.
1472
+
1473
+ ## Type Changes
1474
+
1475
+ ### BREAKING: Removed `StorageGetMessagesArg` type
1476
+
1477
+ Use `StorageListMessagesInput` instead:
1478
+
1479
+ ```typescript
1480
+ // Before
1481
+ import type { StorageGetMessagesArg } from '@mastra/core';
1482
+
1483
+ // After
1484
+ import type { StorageListMessagesInput } from '@mastra/core';
1485
+ ```
1486
+
1487
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
1488
+
1489
+ - 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))
1490
+
1491
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
1492
+
1493
+ - Implement listMessages API for replacing previous methods ([#9531](https://github.com/mastra-ai/mastra/pull/9531))
1494
+
1495
+ - 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))
1496
+
1497
+ - 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))
1498
+
1499
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
1500
+
1501
+ - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
1502
+
1503
+ 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.
1504
+
1505
+ **Affected APIs:**
1506
+ - `Memory.listThreadsByResourceId()`
1507
+ - `Memory.listMessages()`
1508
+ - `Storage.listWorkflowRuns()`
1509
+
1510
+ **Migration:**
1511
+
1512
+ ```typescript
1513
+ // Before
1514
+ await memory.listThreadsByResourceId({
1515
+ resourceId: 'user-123',
1516
+ offset: 20,
1517
+ limit: 10,
1518
+ });
1519
+
1520
+ // After
1521
+ await memory.listThreadsByResourceId({
1522
+ resourceId: 'user-123',
1523
+ page: 2, // page = Math.floor(offset / limit)
1524
+ perPage: 10,
1525
+ });
1526
+
1527
+ // Before
1528
+ await memory.listMessages({
1529
+ threadId: 'thread-456',
1530
+ offset: 20,
1531
+ limit: 10,
1532
+ });
1533
+
1534
+ // After
1535
+ await memory.listMessages({
1536
+ threadId: 'thread-456',
1537
+ page: 2,
1538
+ perPage: 10,
1539
+ });
1540
+
1541
+ // Before
1542
+ await storage.listWorkflowRuns({
1543
+ workflowName: 'my-workflow',
1544
+ offset: 20,
1545
+ limit: 10,
1546
+ });
1547
+
1548
+ // After
1549
+ await storage.listWorkflowRuns({
1550
+ workflowName: 'my-workflow',
1551
+ page: 2,
1552
+ perPage: 10,
1553
+ });
1554
+ ```
1555
+
1556
+ **Additional improvements:**
1557
+ - Added validation for negative `page` values in all storage implementations
1558
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
1559
+ - Added reusable query parser utilities for consistent validation in handlers
1560
+
1561
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
1562
+ import { Mastra } from '@mastra/core';
1563
+ import { Observability } from '@mastra/observability'; // Explicit import
1564
+
1565
+ const mastra = new Mastra({
1566
+ ...other_config,
1567
+ observability: new Observability({
1568
+ default: { enabled: true }
1569
+ }) // Instance
1570
+ });
1571
+ ```
1572
+
1573
+ Instead of:
1574
+
1575
+ ```
1576
+ import { Mastra } from '@mastra/core';
1577
+ import '@mastra/observability/init'; // Explicit import
1578
+
1579
+ const mastra = new Mastra({
1580
+ ...other_config,
1581
+ observability: {
1582
+ default: { enabled: true }
1583
+ }
1584
+ });
1585
+ ```
1586
+
1587
+ Also renamed a bunch of:
1588
+ - `Tracing` things to `Observability` things.
1589
+ - `AI-` things to just things.
1590
+
7
1591
  - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
8
1592
 
1593
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
1594
+
1595
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
1596
+ 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
1597
+
1598
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
1599
+
9
1600
  ### Minor Changes
10
1601
 
11
1602
  - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
12
1603
 
13
1604
  ### Patch Changes
14
1605
 
15
- - 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)]:
16
- - @mastra/core@0.0.0-bundle-recursion-20251030002519
1606
+ - 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)]:
1607
+ - @mastra/core@1.0.0-beta.0
17
1608
 
18
1609
  ## 0.15.6
19
1610