@mastra/mcp-docs-server 1.0.0-beta.14 → 1.0.0-beta.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +10 -10
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +51 -51
  3. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +195 -195
  4. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +76 -76
  5. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +195 -195
  6. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +195 -195
  7. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +218 -0
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +308 -308
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +19 -19
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +27 -27
  11. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +195 -195
  12. package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
  13. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  14. package/.docs/organized/changelogs/%40mastra%2Flance.md +195 -195
  15. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +195 -195
  16. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +8 -8
  17. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +128 -128
  18. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +219 -219
  19. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +219 -219
  20. package/.docs/organized/changelogs/%40mastra%2Fpg.md +235 -235
  21. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +81 -81
  22. package/.docs/organized/changelogs/%40mastra%2Freact.md +70 -70
  23. package/.docs/organized/changelogs/%40mastra%2Fserver.md +125 -125
  24. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +195 -195
  25. package/.docs/organized/changelogs/create-mastra.md +11 -11
  26. package/.docs/organized/changelogs/mastra.md +40 -40
  27. package/.docs/organized/code-examples/agent-v6.md +70 -11
  28. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  29. package/.docs/raw/agents/adding-voice.mdx +8 -3
  30. package/.docs/raw/deployment/overview.mdx +3 -4
  31. package/.docs/raw/deployment/workflow-runners.mdx +14 -0
  32. package/.docs/raw/getting-started/studio.mdx +1 -1
  33. package/.docs/raw/guides/deployment/inngest.mdx +198 -140
  34. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +11 -3
  35. package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
  36. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +41 -0
  37. package/.docs/raw/mastra-cloud/deployment.mdx +39 -0
  38. package/.docs/raw/mastra-cloud/observability.mdx +9 -15
  39. package/.docs/raw/mastra-cloud/overview.mdx +14 -44
  40. package/.docs/raw/mastra-cloud/setup.mdx +64 -0
  41. package/.docs/raw/mastra-cloud/studio.mdx +35 -0
  42. package/.docs/raw/reference/logging/pino-logger.mdx +1 -1
  43. package/.docs/raw/reference/processors/token-limiter-processor.mdx +39 -18
  44. package/.docs/raw/reference/storage/cloudflare-d1.mdx +4 -2
  45. package/.docs/raw/reference/storage/lance.mdx +3 -2
  46. package/.docs/raw/reference/storage/libsql.mdx +5 -2
  47. package/.docs/raw/reference/storage/mongodb.mdx +4 -2
  48. package/.docs/raw/reference/storage/mssql.mdx +4 -2
  49. package/.docs/raw/reference/storage/postgresql.mdx +4 -2
  50. package/.docs/raw/voice/overview.mdx +1 -1
  51. package/.docs/raw/workflows/overview.mdx +1 -1
  52. package/.docs/raw/workflows/snapshots.mdx +2 -1
  53. package/CHANGELOG.md +7 -0
  54. package/package.json +4 -4
  55. package/.docs/raw/mastra-cloud/dashboard.mdx +0 -96
  56. package/.docs/raw/mastra-cloud/setting-up.mdx +0 -106
  57. package/.docs/raw/workflows/inngest-workflow.mdx +0 -362
@@ -1,5 +1,85 @@
1
1
  # @mastra/playground-ui
2
2
 
3
+ ## 7.0.0-beta.15
4
+
5
+ ### Minor Changes
6
+
7
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
8
+
9
+ ## What changed
10
+
11
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
12
+
13
+ **Before:**
14
+
15
+ ```typescript
16
+ // Old span structure
17
+ span.agentId; // 'my-agent'
18
+ span.toolId; // undefined
19
+ span.workflowId; // undefined
20
+ ```
21
+
22
+ **After:**
23
+
24
+ ```typescript
25
+ // New span structure
26
+ span.entityType; // EntityType.AGENT
27
+ span.entityId; // 'my-agent'
28
+ span.entityName; // 'My Agent'
29
+ ```
30
+
31
+ ## New `listTraces()` API
32
+
33
+ Query traces with filtering, pagination, and sorting:
34
+
35
+ ```typescript
36
+ const { spans, pagination } = await storage.listTraces({
37
+ filters: {
38
+ entityType: EntityType.AGENT,
39
+ entityId: 'my-agent',
40
+ userId: 'user-123',
41
+ environment: 'production',
42
+ status: TraceStatus.SUCCESS,
43
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
44
+ },
45
+ pagination: { page: 0, perPage: 50 },
46
+ orderBy: { field: 'startedAt', direction: 'DESC' },
47
+ });
48
+ ```
49
+
50
+ **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`.
51
+
52
+ ## New retrieval methods
53
+ - `getSpan({ traceId, spanId })` - Get a single span
54
+ - `getRootSpan({ traceId })` - Get the root span of a trace
55
+ - `getTrace({ traceId })` - Get all spans for a trace
56
+
57
+ ## Backward compatibility
58
+
59
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
60
+
61
+ ## Migration
62
+
63
+ **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`.
64
+
65
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
66
+
67
+ ### Patch Changes
68
+
69
+ - Add Mastra version footer component that displays installed packages and checks npm registry for available updates and deprecation warnings ([#11211](https://github.com/mastra-ai/mastra/pull/11211))
70
+
71
+ - Fix clicking nested workflows in sidepanel: resolve runtime error when clicking "View Nested Graph" inside an already-open nested workflow panel, and ensure the graph updates when switching between nested workflows. ([#11391](https://github.com/mastra-ai/mastra/pull/11391))
72
+
73
+ - Add resizable and collapsible side panels for agents and workflows ([#11371](https://github.com/mastra-ai/mastra/pull/11371))
74
+
75
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
76
+
77
+ - 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), [`632fdb8`](https://github.com/mastra-ai/mastra/commit/632fdb8b3cd9ff6f90399256d526db439fc1758b), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`184f01d`](https://github.com/mastra-ai/mastra/commit/184f01d1f534ec0be9703d3996f2e088b4a560eb), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
78
+ - @mastra/core@1.0.0-beta.15
79
+ - @mastra/ai-sdk@1.0.0-beta.11
80
+ - @mastra/client-js@1.0.0-beta.15
81
+ - @mastra/react@0.1.0-beta.15
82
+
3
83
  ## 7.0.0-beta.14
4
84
 
5
85
  ### Patch Changes
@@ -418,85 +498,5 @@
418
498
 
419
499
  ## Client SDK
420
500
 
421
- ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
422
-
423
- **Migration:**
424
-
425
- ```typescript
426
- // Before
427
- const response = await client.getThreadMessages(threadId, { agentId });
428
-
429
- // After
430
- const response = await client.listThreadMessages(threadId, { agentId });
431
- ```
432
-
433
- The response format remains the same.
434
-
435
- ## Type Changes
436
-
437
- ### BREAKING: Removed `StorageGetMessagesArg` type
438
-
439
- Use `StorageListMessagesInput` instead:
440
-
441
- ```typescript
442
- // Before
443
- import type { StorageGetMessagesArg } from '@mastra/core';
444
-
445
- // After
446
- import type { StorageListMessagesInput } from '@mastra/core';
447
- ```
448
-
449
- - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
450
-
451
- - Replace `getThreadsByResourceIdPaginated` with `listThreadsByResourceId` across memory handlers. Update client SDK to use `listThreads()` with `offset`/`limit` parameters instead of deprecated `getMemoryThreads()`. Consolidate `/api/memory/threads` routes to single paginated endpoint. ([#9508](https://github.com/mastra-ai/mastra/pull/9508))
452
-
453
- - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
454
-
455
- - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
456
-
457
- - **Breaking Change**: Remove legacy v1 watch events and consolidate on v2 implementation. ([#9252](https://github.com/mastra-ai/mastra/pull/9252))
458
-
459
- This change simplifies the workflow watching API by removing the legacy v1 event system and promoting v2 as the standard (renamed to just `watch`).
460
-
461
- ### What's Changed
462
- - Removed legacy v1 watch event handlers and types
463
- - Renamed `watch-v2` to `watch` throughout the codebase
464
- - Removed `.watch()` method from client-js SDK (`Workflow` and `AgentBuilder` classes)
465
- - Removed `/watch` HTTP endpoints from server and deployer
466
- - Removed `WorkflowWatchResult` and v1 `WatchEvent` types
467
-
468
- - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
469
-
470
- 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.
471
-
472
- **Affected APIs:**
473
- - `Memory.listThreadsByResourceId()`
474
- - `Memory.listMessages()`
475
- - `Storage.listWorkflowRuns()`
476
-
477
- **Migration:**
478
-
479
- ```typescript
480
- // Before
481
- await memory.listThreadsByResourceId({
482
- resourceId: 'user-123',
483
- offset: 20,
484
- limit: 10,
485
- });
486
-
487
- // After
488
- await memory.listThreadsByResourceId({
489
- resourceId: 'user-123',
490
- page: 2, // page = Math.floor(offset / limit)
491
- perPage: 10,
492
- });
493
-
494
- // Before
495
- await memory.listMessages({
496
- threadId: 'thread-456',
497
- offset: 20,
498
- limit: 10,
499
- });
500
-
501
501
 
502
- ... 4311 more lines hidden. See full changelog in package directory.
502
+ ... 4391 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,74 @@
1
1
  # @mastra/react-hooks
2
2
 
3
+ ## 0.1.0-beta.15
4
+
5
+ ### Minor Changes
6
+
7
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
8
+
9
+ ## What changed
10
+
11
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
12
+
13
+ **Before:**
14
+
15
+ ```typescript
16
+ // Old span structure
17
+ span.agentId; // 'my-agent'
18
+ span.toolId; // undefined
19
+ span.workflowId; // undefined
20
+ ```
21
+
22
+ **After:**
23
+
24
+ ```typescript
25
+ // New span structure
26
+ span.entityType; // EntityType.AGENT
27
+ span.entityId; // 'my-agent'
28
+ span.entityName; // 'My Agent'
29
+ ```
30
+
31
+ ## New `listTraces()` API
32
+
33
+ Query traces with filtering, pagination, and sorting:
34
+
35
+ ```typescript
36
+ const { spans, pagination } = await storage.listTraces({
37
+ filters: {
38
+ entityType: EntityType.AGENT,
39
+ entityId: 'my-agent',
40
+ userId: 'user-123',
41
+ environment: 'production',
42
+ status: TraceStatus.SUCCESS,
43
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
44
+ },
45
+ pagination: { page: 0, perPage: 50 },
46
+ orderBy: { field: 'startedAt', direction: 'DESC' },
47
+ });
48
+ ```
49
+
50
+ **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`.
51
+
52
+ ## New retrieval methods
53
+ - `getSpan({ traceId, spanId })` - Get a single span
54
+ - `getRootSpan({ traceId })` - Get the root span of a trace
55
+ - `getTrace({ traceId })` - Get all spans for a trace
56
+
57
+ ## Backward compatibility
58
+
59
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
60
+
61
+ ## Migration
62
+
63
+ **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`.
64
+
65
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
66
+
67
+ ### Patch Changes
68
+
69
+ - Updated dependencies [[`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`632fdb8`](https://github.com/mastra-ai/mastra/commit/632fdb8b3cd9ff6f90399256d526db439fc1758b), [`184f01d`](https://github.com/mastra-ai/mastra/commit/184f01d1f534ec0be9703d3996f2e088b4a560eb)]:
70
+ - @mastra/client-js@1.0.0-beta.15
71
+
3
72
  ## 0.1.0-beta.14
4
73
 
5
74
  ### Patch Changes
@@ -430,73 +499,4 @@
430
499
 
431
500
  ### Patch Changes
432
501
 
433
- - Updated dependencies []:
434
- - @mastra/client-js@0.15.1-alpha.0
435
-
436
- ## 0.0.3
437
-
438
- ### Patch Changes
439
-
440
- - generateVNext into react SDK + to asistant ui message ([#8345](https://github.com/mastra-ai/mastra/pull/8345))
441
-
442
- - distinguish between legacy and regular messages in agent chat for useChat usage ([#8409](https://github.com/mastra-ai/mastra/pull/8409))
443
-
444
- - Updated dependencies [[`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
445
- - @mastra/client-js@0.15.0
446
-
447
- ## 0.0.3-alpha.0
448
-
449
- ### Patch Changes
450
-
451
- - generateVNext into react SDK + to asistant ui message ([#8345](https://github.com/mastra-ai/mastra/pull/8345))
452
-
453
- - distinguish between legacy and regular messages in agent chat for useChat usage ([#8409](https://github.com/mastra-ai/mastra/pull/8409))
454
-
455
- - Updated dependencies [[`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
456
- - @mastra/client-js@0.15.0-alpha.0
457
-
458
- ## 0.0.2
459
-
460
- ### Patch Changes
461
-
462
- - Updated dependencies []:
463
- - @mastra/client-js@0.14.1
464
-
465
- ## 0.0.2-alpha.1
466
-
467
- ### Patch Changes
468
-
469
- - Updated dependencies []:
470
- - @mastra/client-js@0.14.1-alpha.1
471
-
472
- ## 0.0.2-alpha.0
473
-
474
- ### Patch Changes
475
-
476
- - Updated dependencies []:
477
- - @mastra/client-js@0.14.1-alpha.0
478
-
479
- ## 0.0.1
480
-
481
- ### Patch Changes
482
-
483
- - modify the useMastraChat hook to useChat ([#8265](https://github.com/mastra-ai/mastra/pull/8265))
484
-
485
- - Updated dependencies [[`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67), [`5cb4596`](https://github.com/mastra-ai/mastra/commit/5cb4596c644104ea817bb0c5a07b8b1f8de595a8), [`86be6be`](https://github.com/mastra-ai/mastra/commit/86be6bee7e64b7d828a6b4eec283265c820dfa43), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`67b0f00`](https://github.com/mastra-ai/mastra/commit/67b0f005b520335c71fb85cbaa25df4ce8484a81), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30)]:
486
- - @mastra/client-js@0.14.0
487
-
488
- ## 0.0.1-alpha.1
489
-
490
- ### Patch Changes
491
-
492
- - modify the useMastraChat hook to useChat ([#8265](https://github.com/mastra-ai/mastra/pull/8265))
493
-
494
- - Updated dependencies [[`5cb4596`](https://github.com/mastra-ai/mastra/commit/5cb4596c644104ea817bb0c5a07b8b1f8de595a8), [`86be6be`](https://github.com/mastra-ai/mastra/commit/86be6bee7e64b7d828a6b4eec283265c820dfa43), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30)]:
495
- - @mastra/client-js@0.14.0-alpha.1
496
-
497
- ## 0.0.1-alpha.1
498
-
499
- ### Patch Changes
500
-
501
-
502
- ... 3 more lines hidden. See full changelog in package directory.
502
+ ... 72 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,129 @@
1
1
  # @mastra/server
2
2
 
3
+ ## 1.0.0-beta.15
4
+
5
+ ### Minor Changes
6
+
7
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
8
+
9
+ ## What changed
10
+
11
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
12
+
13
+ **Before:**
14
+
15
+ ```typescript
16
+ // Old span structure
17
+ span.agentId; // 'my-agent'
18
+ span.toolId; // undefined
19
+ span.workflowId; // undefined
20
+ ```
21
+
22
+ **After:**
23
+
24
+ ```typescript
25
+ // New span structure
26
+ span.entityType; // EntityType.AGENT
27
+ span.entityId; // 'my-agent'
28
+ span.entityName; // 'My Agent'
29
+ ```
30
+
31
+ ## New `listTraces()` API
32
+
33
+ Query traces with filtering, pagination, and sorting:
34
+
35
+ ```typescript
36
+ const { spans, pagination } = await storage.listTraces({
37
+ filters: {
38
+ entityType: EntityType.AGENT,
39
+ entityId: 'my-agent',
40
+ userId: 'user-123',
41
+ environment: 'production',
42
+ status: TraceStatus.SUCCESS,
43
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
44
+ },
45
+ pagination: { page: 0, perPage: 50 },
46
+ orderBy: { field: 'startedAt', direction: 'DESC' },
47
+ });
48
+ ```
49
+
50
+ **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`.
51
+
52
+ ## New retrieval methods
53
+ - `getSpan({ traceId, spanId })` - Get a single span
54
+ - `getRootSpan({ traceId })` - Get the root span of a trace
55
+ - `getTrace({ traceId })` - Get all spans for a trace
56
+
57
+ ## Backward compatibility
58
+
59
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
60
+
61
+ ## Migration
62
+
63
+ **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`.
64
+
65
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
66
+
67
+ ### Patch Changes
68
+
69
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
70
+
71
+ ### Summary
72
+
73
+ 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.
74
+
75
+ ### Migration Guide
76
+
77
+ All direct method calls on storage instances should be updated to use `getStore()`:
78
+
79
+ ```typescript
80
+ // Before
81
+ const thread = await storage.getThreadById({ threadId });
82
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
83
+ await storage.createSpan(span);
84
+
85
+ // After
86
+ const memory = await storage.getStore('memory');
87
+ const thread = await memory?.getThreadById({ threadId });
88
+
89
+ const workflows = await storage.getStore('workflows');
90
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
91
+
92
+ const observability = await storage.getStore('observability');
93
+ await observability?.createSpan(span);
94
+ ```
95
+
96
+ ### Available Domains
97
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
98
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
99
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
100
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
101
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
102
+
103
+ ### Breaking Changes
104
+ - Passthrough methods have been removed from `MastraStorage` base class
105
+ - All storage adapters now require accessing domains via `getStore()`
106
+ - The `stores` property on storage instances is now the canonical way to access domain storage
107
+
108
+ ### Internal Changes
109
+ - Each storage adapter now initializes domain-specific stores in its constructor
110
+ - Domain stores share database connections and handle their own table initialization
111
+
112
+ - Add `/api/system/packages` endpoint that returns installed Mastra packages and versions from the dev environment ([#11211](https://github.com/mastra-ai/mastra/pull/11211))
113
+
114
+ - Add `perStep` option to workflow run methods, allowing a workflow to run just a step instead of all the workflow steps ([#11276](https://github.com/mastra-ai/mastra/pull/11276))
115
+
116
+ - Fixed voice transcription endpoint ([#11348](https://github.com/mastra-ai/mastra/pull/11348))
117
+
118
+ The voice transcription endpoint (`/api/agents/:agentId/voice/listen`) now correctly handles multipart/form-data requests for audio uploads rather than only parsing JSON request bodies.
119
+
120
+ Both Express and Hono adapters now parse multipart/form-data bodies and handle JSON-encoded form fields.
121
+
122
+ **Breaking change:** The server schema field for the transcription endpoint was renamed from `audioData` to `audio` to match the client SDK. If you are making direct API calls to the transcription endpoint (not using the SDK), you will need to update your request body to use `audio` instead of `audioData`.
123
+
124
+ - 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)]:
125
+ - @mastra/core@1.0.0-beta.15
126
+
3
127
  ## 1.0.0-beta.14
4
128
 
5
129
  ### Patch Changes
@@ -375,128 +499,4 @@
375
499
 
376
500
  - Network handler now accesses thread and resource parameters from the nested memory object instead of directly from request body. ([#10294](https://github.com/mastra-ai/mastra/pull/10294))
377
501
 
378
- - Updated dependencies [[`352a5d6`](https://github.com/mastra-ai/mastra/commit/352a5d625cfe09849b21e8f52a24c9f0366759d5), [`a0a5b4b`](https://github.com/mastra-ai/mastra/commit/a0a5b4bbebe6c701ebbadf744873aa0d5ca01371), [`69ea758`](https://github.com/mastra-ai/mastra/commit/69ea758358edd7117f191c2e69c8bb5fc79e7a1a), [`993ad98`](https://github.com/mastra-ai/mastra/commit/993ad98d7ad3bebda9ecef5fec5c94349a0d04bc), [`3ff2c17`](https://github.com/mastra-ai/mastra/commit/3ff2c17a58e312fad5ea37377262c12d92ca0908)]:
379
- - @mastra/core@1.0.0-beta.4
380
-
381
- ## 1.0.0-beta.3
382
-
383
- ### Patch Changes
384
-
385
- - Fix semantic search endpoint to return results in the correct format. Also fix the delete messages endpoint to properly normalize ids in the expected format. ([#10032](https://github.com/mastra-ai/mastra/pull/10032))
386
-
387
- - 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)]:
388
- - @mastra/core@1.0.0-beta.3
389
-
390
- ## 1.0.0-beta.2
391
-
392
- ### Patch Changes
393
-
394
- - Updated dependencies [[`465ac05`](https://github.com/mastra-ai/mastra/commit/465ac0526a91d175542091c675181f1a96c98c46)]:
395
- - @mastra/core@1.0.0-beta.2
396
-
397
- ## 1.0.0-beta.1
398
-
399
- ### Patch Changes
400
-
401
- - Updated dependencies [[`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d)]:
402
- - @mastra/core@1.0.0-beta.1
403
-
404
- ## 1.0.0-beta.0
405
-
406
- ### Major Changes
407
-
408
- - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
409
-
410
- - 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))
411
-
412
- Primitives that are added to other primitives are also automatically added to the Mastra instance
413
-
414
- - 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))
415
-
416
- - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
417
-
418
- Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
419
-
420
- **Storage changes:**
421
- - `StoragePagination.perPage` type changed from `number` to `number | false`
422
- - All storage implementations support `perPage: false`:
423
- - Memory: `listMessages()`
424
- - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
425
- - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
426
-
427
- **Memory changes:**
428
- - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
429
- - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
430
-
431
- **Stricter validation:**
432
- - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
433
-
434
- **Migration:**
435
-
436
- ```typescript
437
- // Storage/Memory: Replace getMessagesPaginated with listMessages
438
- - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
439
- + storage.listMessages({ threadId, page: 0, perPage: 20 })
440
- + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
441
-
442
- // Memory: Replace selectBy with flat parameters
443
- - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
444
- + memory.query({ threadId, perPage: 20, include: [...] })
445
-
446
- // Client SDK
447
- - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
448
- + thread.listMessages({ page: 0, perPage: 20 })
449
- ```
450
-
451
- - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
452
-
453
- ## Storage Layer
454
-
455
- ### BREAKING: Removed `storage.getMessages()`
456
-
457
- The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
458
-
459
- **Migration:**
460
-
461
- ```typescript
462
- // Before
463
- const messages = await storage.getMessages({ threadId: 'thread-1' });
464
-
465
- // After
466
- const result = await storage.listMessages({
467
- threadId: 'thread-1',
468
- page: 0,
469
- perPage: 50,
470
- });
471
- const messages = result.messages; // Access messages array
472
- console.log(result.total); // Total count
473
- console.log(result.hasMore); // Whether more pages exist
474
- ```
475
-
476
- ### Message ordering default
477
-
478
- `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
479
-
480
- **To use DESC ordering (newest first):**
481
-
482
- ```typescript
483
- const result = await storage.listMessages({
484
- threadId: 'thread-1',
485
- orderBy: { field: 'createdAt', direction: 'DESC' },
486
- });
487
- ```
488
-
489
- ## Client SDK
490
-
491
- ### BREAKING: Renamed `client.getThreadMessages()` → `client.listThreadMessages()`
492
-
493
- **Migration:**
494
-
495
- ```typescript
496
- // Before
497
- const response = await client.getThreadMessages(threadId, { agentId });
498
-
499
- // After
500
- const response = await client.listThreadMessages(threadId, { agentId });
501
-
502
- ... 4410 more lines hidden. See full changelog in package directory.
502
+ ... 4534 more lines hidden. See full changelog in package directory.