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