@mastra/mcp-docs-server 0.13.32-alpha.0 → 0.13.32

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 (64) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +2 -0
  2. package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +3 -0
  3. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +8 -8
  4. package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +2 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +21 -21
  6. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +30 -30
  7. package/.docs/organized/changelogs/%40mastra%2Fastra.md +19 -19
  8. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +19 -19
  9. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +19 -19
  10. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +15 -15
  11. package/.docs/organized/changelogs/%40mastra%2Fcloud.md +19 -19
  12. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +19 -19
  13. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +25 -25
  14. package/.docs/organized/changelogs/%40mastra%2Fcore.md +155 -155
  15. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +19 -19
  16. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +23 -23
  17. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +21 -21
  18. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +21 -21
  19. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +21 -21
  20. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +43 -43
  21. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +19 -19
  22. package/.docs/organized/changelogs/%40mastra%2Fevals.md +21 -21
  23. package/.docs/organized/changelogs/%40mastra%2Flance.md +19 -19
  24. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +25 -25
  25. package/.docs/organized/changelogs/%40mastra%2Floggers.md +19 -19
  26. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +17 -17
  27. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +20 -20
  28. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +27 -27
  29. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +19 -19
  30. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +19 -19
  31. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +19 -19
  32. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +19 -19
  33. package/.docs/organized/changelogs/%40mastra%2Fpg.md +23 -23
  34. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +19 -19
  35. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +47 -47
  36. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +19 -19
  37. package/.docs/organized/changelogs/%40mastra%2Frag.md +19 -19
  38. package/.docs/organized/changelogs/%40mastra%2Freact.md +26 -0
  39. package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +18 -0
  40. package/.docs/organized/changelogs/%40mastra%2Fserver.md +57 -57
  41. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +19 -19
  42. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +19 -19
  43. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +19 -19
  44. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +23 -23
  45. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +19 -19
  46. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +19 -19
  47. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +19 -19
  48. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +19 -19
  49. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +18 -0
  50. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +22 -22
  51. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +19 -19
  52. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +19 -19
  53. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +19 -19
  54. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +19 -19
  55. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +19 -19
  56. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +19 -19
  57. package/.docs/organized/changelogs/create-mastra.md +17 -17
  58. package/.docs/organized/changelogs/mastra.md +33 -33
  59. package/.docs/organized/code-examples/agent.md +55 -1
  60. package/.docs/raw/observability/ai-tracing/overview.mdx +220 -0
  61. package/.docs/raw/reference/cli/create-mastra.mdx +1 -1
  62. package/.docs/raw/reference/cli/mastra.mdx +1 -1
  63. package/CHANGELOG.md +16 -0
  64. package/package.json +5 -5
@@ -1,5 +1,23 @@
1
1
  # @mastra/voice-playai
2
2
 
3
+ ## 0.11.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
8
+
9
+ - Updated dependencies [[`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e)]:
10
+ - @mastra/core@0.22.0
11
+
12
+ ## 0.11.10-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
17
+
18
+ - Updated dependencies [[`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb)]:
19
+ - @mastra/core@0.22.0-alpha.1
20
+
3
21
  ## 0.11.9
4
22
 
5
23
  ### Patch Changes
@@ -280,23 +298,5 @@
280
298
  - Updated dependencies [c30bca8]
281
299
  - Updated dependencies [3b5fec7]
282
300
  - Updated dependencies [a8f129d]
283
- - @mastra/core@0.14.0
284
-
285
- ## 0.10.8-alpha.0
286
-
287
- ### Patch Changes
288
-
289
- - 03997ae: Update peerdeps
290
- - @mastra/core@0.14.0-alpha.7
291
-
292
- ## 0.10.7
293
-
294
- ### Patch Changes
295
-
296
- - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
297
- - Updated dependencies [cb36de0]
298
- - Updated dependencies [d0496e6]
299
- - Updated dependencies [a82b851]
300
- - Updated dependencies [ea0c5f2]
301
301
 
302
- ... 1349 more lines hidden. See full changelog in package directory.
302
+ ... 1367 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,23 @@
1
1
  # @mastra/voice-sarvam
2
2
 
3
+ ## 0.11.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
8
+
9
+ - Updated dependencies [[`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e)]:
10
+ - @mastra/core@0.22.0
11
+
12
+ ## 0.11.10-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
17
+
18
+ - Updated dependencies [[`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb)]:
19
+ - @mastra/core@0.22.0-alpha.1
20
+
3
21
  ## 0.11.9
4
22
 
5
23
  ### Patch Changes
@@ -280,23 +298,5 @@
280
298
  - Updated dependencies [c30bca8]
281
299
  - Updated dependencies [3b5fec7]
282
300
  - Updated dependencies [a8f129d]
283
- - @mastra/core@0.14.0
284
-
285
- ## 0.10.8-alpha.0
286
-
287
- ### Patch Changes
288
-
289
- - 03997ae: Update peerdeps
290
- - @mastra/core@0.14.0-alpha.7
291
-
292
- ## 0.10.7
293
-
294
- ### Patch Changes
295
-
296
- - 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
297
- - Updated dependencies [cb36de0]
298
- - Updated dependencies [d0496e6]
299
- - Updated dependencies [a82b851]
300
- - Updated dependencies [ea0c5f2]
301
301
 
302
- ... 999 more lines hidden. See full changelog in package directory.
302
+ ... 1017 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,23 @@
1
1
  # @mastra/voice-speechify
2
2
 
3
+ ## 0.11.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
8
+
9
+ - Updated dependencies [[`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e)]:
10
+ - @mastra/core@0.22.0
11
+
12
+ ## 0.11.10-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
17
+
18
+ - Updated dependencies [[`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb)]:
19
+ - @mastra/core@0.22.0-alpha.1
20
+
3
21
  ## 0.11.9
4
22
 
5
23
  ### Patch Changes
@@ -280,23 +298,5 @@
280
298
  - Updated dependencies [6faaee5]
281
299
  - Updated dependencies [4232b14]
282
300
  - Updated dependencies [a89de7e]
283
- - Updated dependencies [5a37d0c]
284
- - Updated dependencies [4bde0cb]
285
- - Updated dependencies [cf4f357]
286
- - Updated dependencies [ad888a2]
287
- - Updated dependencies [481751d]
288
- - Updated dependencies [2454423]
289
- - Updated dependencies [194e395]
290
- - Updated dependencies [a722c0b]
291
- - Updated dependencies [c30bca8]
292
- - Updated dependencies [3b5fec7]
293
- - Updated dependencies [a8f129d]
294
- - @mastra/core@0.14.0
295
-
296
- ## 0.10.8-alpha.0
297
-
298
- ### Patch Changes
299
-
300
- - 03997ae: Update peerdeps
301
301
 
302
- ... 1364 more lines hidden. See full changelog in package directory.
302
+ ... 1382 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,21 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.17.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
8
+
9
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
10
+
11
+ ## 0.17.1-alpha.1
12
+
13
+ ### Patch Changes
14
+
15
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
16
+
17
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
18
+
3
19
  ## 0.17.1-alpha.0
4
20
 
5
21
  ## 0.17.0
@@ -282,21 +298,5 @@
282
298
 
283
299
  - Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
284
300
 
285
- ## 0.13.2
286
-
287
- ### Patch Changes
288
-
289
- - dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
290
- - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
291
-
292
- - Add model fallback handlers and apis ([#7378](https://github.com/mastra-ai/mastra/pull/7378))
293
-
294
- - Fix DateTimePicker style issue ([#8106](https://github.com/mastra-ai/mastra/pull/8106))
295
-
296
- - Fix getting tool link path from agent in playground ui tools page ([#8135](https://github.com/mastra-ai/mastra/pull/8135))
297
-
298
- ## 0.13.2-alpha.4
299
-
300
- ### Patch Changes
301
301
 
302
- ... 1752 more lines hidden. See full changelog in package directory.
302
+ ... 1768 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,37 @@
1
1
  # mastra
2
2
 
3
+ ## 0.17.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
8
+
9
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
10
+
11
+ - Use newer model id for anthropic during `create-mastra` ([#8996](https://github.com/mastra-ai/mastra/pull/8996))
12
+
13
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
14
+
15
+ - Updated dependencies [[`25305a2`](https://github.com/mastra-ai/mastra/commit/25305a2af1acf77cc2ac9237774ecd7d3caa31a1), [`c67ca32`](https://github.com/mastra-ai/mastra/commit/c67ca32e3c2cf69bfc146580770c720220ca44ac), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`dbc9e12`](https://github.com/mastra-ai/mastra/commit/dbc9e1216ba575ba59ead4afb727a01215f7de4f), [`99e41b9`](https://github.com/mastra-ai/mastra/commit/99e41b94957cdd25137d3ac12e94e8b21aa01b68), [`c28833c`](https://github.com/mastra-ai/mastra/commit/c28833c5b6d8e10eeffd7f7d39129d53b8bca240), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`f053e89`](https://github.com/mastra-ai/mastra/commit/f053e89160dbd0bd3333fc3492f68231b5c7c349), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`1eb156a`](https://github.com/mastra-ai/mastra/commit/1eb156ace499b34ab48bf23fb16f1affe6bb9c1c), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`9a1a485`](https://github.com/mastra-ai/mastra/commit/9a1a4859b855e37239f652bf14b1ecd1029b8c4e), [`9257233`](https://github.com/mastra-ai/mastra/commit/9257233c4ffce09b2bedc2a9adbd70d7a83fa8e2), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`0f1a4c9`](https://github.com/mastra-ai/mastra/commit/0f1a4c984fb4b104b2f0b63ba18c9fa77f567700), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`084afad`](https://github.com/mastra-ai/mastra/commit/084afadff49b168d8b6104b43c77cecc96c48ac2), [`2db6160`](https://github.com/mastra-ai/mastra/commit/2db6160e2022ff8827c15d30157e684683b934b5), [`8aeea37`](https://github.com/mastra-ai/mastra/commit/8aeea37efdde347c635a67fed56794943b7f74ec), [`02fe153`](https://github.com/mastra-ai/mastra/commit/02fe15351d6021d214da48ec982a0e9e4150bcee), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`74567b3`](https://github.com/mastra-ai/mastra/commit/74567b3d237ae3915cd0bca3cf55fa0a64e4e4a4), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`15a1733`](https://github.com/mastra-ai/mastra/commit/15a1733074cee8bd37370e1af34cd818e89fa7ac), [`fc2a774`](https://github.com/mastra-ai/mastra/commit/fc2a77468981aaddc3e77f83f0c4ad4a4af140da), [`4e08933`](https://github.com/mastra-ai/mastra/commit/4e08933625464dfde178347af5b6278fcf34188e), [`10188d6`](https://github.com/mastra-ai/mastra/commit/10188d632a729010441f9c7e2a41eab60afccb23)]:
16
+ - @mastra/deployer@0.22.0
17
+ - @mastra/core@0.22.0
18
+ - @mastra/loggers@0.10.17
19
+
20
+ ## 0.17.1-alpha.1
21
+
22
+ ### Patch Changes
23
+
24
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
25
+
26
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
27
+
28
+ - Update peerdeps to 0.23.0-0 ([#9043](https://github.com/mastra-ai/mastra/pull/9043))
29
+
30
+ - Updated dependencies [[`25305a2`](https://github.com/mastra-ai/mastra/commit/25305a2af1acf77cc2ac9237774ecd7d3caa31a1), [`efb5ed9`](https://github.com/mastra-ai/mastra/commit/efb5ed946ae7f410bc68c9430beb4b010afd25ec), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`ba201b8`](https://github.com/mastra-ai/mastra/commit/ba201b8f8feac4c72350f2dbd52c13c7297ba7b0), [`4fc4136`](https://github.com/mastra-ai/mastra/commit/4fc413652866a8d2240694fddb2562e9edbb70df), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`d10baf5`](https://github.com/mastra-ai/mastra/commit/d10baf5a3c924f2a6654e23a3e318ed03f189b76), [`038c55a`](https://github.com/mastra-ai/mastra/commit/038c55a7090fc1b1513a966386d3072617f836ac), [`182f045`](https://github.com/mastra-ai/mastra/commit/182f0458f25bd70aa774e64fd923c8a483eddbf1), [`7620d2b`](https://github.com/mastra-ai/mastra/commit/7620d2bddeb4fae4c3c0a0b4e672969795fca11a), [`b2365f0`](https://github.com/mastra-ai/mastra/commit/b2365f038dd4c5f06400428b224af963f399ad50), [`9029ba3`](https://github.com/mastra-ai/mastra/commit/9029ba34459c8859fed4c6b73efd8e2d0021e7ba), [`426cc56`](https://github.com/mastra-ai/mastra/commit/426cc561c85ae76a112ded2385532a91f9f9f074), [`00931fb`](https://github.com/mastra-ai/mastra/commit/00931fb1a21aa42c4fbc20c2c40dd62466b8fc8f), [`e473bfe`](https://github.com/mastra-ai/mastra/commit/e473bfe416c0b8e876973c2b6a6f13c394b7a93f), [`b78e04d`](https://github.com/mastra-ai/mastra/commit/b78e04d935a16ecb1e59c5c96e564903527edddd), [`8ea07b4`](https://github.com/mastra-ai/mastra/commit/8ea07b4bdc73e4218437dbb6dcb0f4b23e745a44), [`084afad`](https://github.com/mastra-ai/mastra/commit/084afadff49b168d8b6104b43c77cecc96c48ac2), [`648e2ca`](https://github.com/mastra-ai/mastra/commit/648e2ca42da54838c6ccbdaadc6fadd808fa6b86), [`b65c5e0`](https://github.com/mastra-ai/mastra/commit/b65c5e0fe6f3c390a9a8bbcf69304d972c3a4afb), [`10188d6`](https://github.com/mastra-ai/mastra/commit/10188d632a729010441f9c7e2a41eab60afccb23)]:
31
+ - @mastra/deployer@0.22.0-alpha.1
32
+ - @mastra/core@0.22.0-alpha.1
33
+ - @mastra/loggers@0.10.17-alpha.0
34
+
3
35
  ## 0.17.1-alpha.0
4
36
 
5
37
  ### Patch Changes
@@ -267,36 +299,4 @@
267
299
 
268
300
  - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
269
301
 
270
- - Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
271
-
272
- - Remove shell from dev ([#8466](https://github.com/mastra-ai/mastra/pull/8466))
273
-
274
- - Updated dependencies [[`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0)]:
275
- - @mastra/core@0.20.1-alpha.0
276
- - @mastra/deployer@0.20.1-alpha.0
277
-
278
- ## 0.14.1
279
-
280
- ### Patch Changes
281
-
282
- - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
283
-
284
- ## 0.14.1-alpha.0
285
-
286
- ### Patch Changes
287
-
288
- - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
289
-
290
- ## 0.14.0
291
-
292
- ### Minor Changes
293
-
294
- - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
295
-
296
- ### Patch Changes
297
-
298
- - Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
299
-
300
- - add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
301
-
302
- ... 6228 more lines hidden. See full changelog in package directory.
302
+ ... 6260 more lines hidden. See full changelog in package directory.
@@ -3,6 +3,7 @@
3
3
  {
4
4
  "name": "examples-agent",
5
5
  "dependencies": {
6
+ "@ai-sdk/provider": "^2.0.0",
6
7
  "@ai-sdk/google": "^1.2.22",
7
8
  "@ai-sdk/openai": "^1.3.24",
8
9
  "@ai-sdk/openai-v5": "npm:@ai-sdk/openai@2.0.15",
@@ -706,6 +707,8 @@ import { z } from 'zod';
706
707
  import { myWorkflow } from '../workflows';
707
708
  import { Memory } from '@mastra/memory';
708
709
  import { ModerationProcessor } from '@mastra/core/processors';
710
+ import { logDataMiddleware } from '../../model-middleware';
711
+ import { wrapLanguageModel } from 'ai-v5';
709
712
 
710
713
  export const weatherInfo = createTool({
711
714
  id: 'weather-info',
@@ -738,7 +741,10 @@ export const chefModelV2Agent = new Agent({
738
741
  `,
739
742
  role: 'system',
740
743
  },
741
- model: openai_v5('gpt-4o-mini'),
744
+ model: wrapLanguageModel({
745
+ model: openai_v5('gpt-4o-mini'),
746
+ middleware: logDataMiddleware,
747
+ }),
742
748
 
743
749
  tools: {
744
750
  weatherInfo,
@@ -1296,6 +1302,54 @@ export const myWorkflowX = createWorkflow({
1296
1302
 
1297
1303
  ```
1298
1304
 
1305
+ ### model-middleware.ts
1306
+ ```typescript
1307
+ import type { LanguageModelV2Middleware, LanguageModelV2StreamPart } from '@ai-sdk/provider';
1308
+ import fs from 'node:fs';
1309
+
1310
+ /**
1311
+ * A middleware that allows to log the raw response from a model.
1312
+ * Super helpful to get fixtures for kitchen-sink e2e tests.
1313
+ */
1314
+
1315
+ let i = 0;
1316
+ export const logDataMiddleware: LanguageModelV2Middleware = {
1317
+ wrapGenerate: async ({ doGenerate, params }) => {
1318
+ const result = await doGenerate();
1319
+
1320
+ console.log('doGenerate finished');
1321
+ console.log(JSON.stringify(result, null, 2));
1322
+
1323
+ return result;
1324
+ },
1325
+
1326
+ wrapStream: async ({ doStream, params }) => {
1327
+ const { stream, ...rest } = await doStream();
1328
+
1329
+ const chunks: LanguageModelV2StreamPart[] = [];
1330
+
1331
+ const transformStream = new TransformStream<LanguageModelV2StreamPart, LanguageModelV2StreamPart>({
1332
+ transform(chunk, controller) {
1333
+ chunks.push(chunk);
1334
+ controller.enqueue(chunk);
1335
+ },
1336
+
1337
+ flush() {
1338
+ i++;
1339
+
1340
+ fs.writeFileSync(`stream-${i}.json`, JSON.stringify(chunks, null, 2));
1341
+ },
1342
+ });
1343
+
1344
+ return {
1345
+ stream: stream.pipeThrough(transformStream),
1346
+ ...rest,
1347
+ };
1348
+ },
1349
+ };
1350
+
1351
+ ```
1352
+
1299
1353
  ### workflowResourceId.ts
1300
1354
  ```typescript
1301
1355
  import { randomUUID } from 'node:crypto';
@@ -367,6 +367,123 @@ execute: async ({ inputData, tracingContext }) => {
367
367
 
368
368
  Metadata set here will be shown in all configured exporters.
369
369
 
370
+ ### Automatic Metadata from RuntimeContext
371
+
372
+ Instead of manually adding metadata to each span, you can configure Mastra to automatically extract values from RuntimeContext and attach them as metadata to all spans in a trace. This is useful for consistently tracking user identifiers, environment information, feature flags, or any request-scoped data across your entire trace.
373
+
374
+ #### Configuration-Level Extraction
375
+
376
+ Define which RuntimeContext keys to extract in your tracing configuration. These keys will be automatically included as metadata for all spans created with this configuration:
377
+
378
+ ```ts filename="src/mastra/index.ts" showLineNumbers copy
379
+ export const mastra = new Mastra({
380
+ observability: {
381
+ configs: {
382
+ default: {
383
+ serviceName: 'my-service',
384
+ runtimeContextKeys: ['userId', 'environment', 'tenantId'],
385
+ exporters: [new DefaultExporter()],
386
+ },
387
+ },
388
+ },
389
+ });
390
+ ```
391
+
392
+ Now when you execute agents or workflows with a RuntimeContext, these values are automatically extracted:
393
+
394
+ ```ts showLineNumbers copy
395
+ const runtimeContext = new RuntimeContext();
396
+ runtimeContext.set('userId', 'user-123');
397
+ runtimeContext.set('environment', 'production');
398
+ runtimeContext.set('tenantId', 'tenant-456');
399
+
400
+ // All spans in this trace automatically get userId, environment, and tenantId metadata
401
+ const result = await agent.generate({
402
+ messages: [{ role: 'user', content: 'Hello' }],
403
+ runtimeContext,
404
+ });
405
+ ```
406
+
407
+ #### Per-Request Additions
408
+
409
+ You can add trace-specific keys using `tracingOptions.runtimeContextKeys`. These are merged with the configuration-level keys:
410
+
411
+ ```ts showLineNumbers copy
412
+ const runtimeContext = new RuntimeContext();
413
+ runtimeContext.set('userId', 'user-123');
414
+ runtimeContext.set('environment', 'production');
415
+ runtimeContext.set('experimentId', 'exp-789');
416
+
417
+ const result = await agent.generate({
418
+ messages: [{ role: 'user', content: 'Hello' }],
419
+ runtimeContext,
420
+ tracingOptions: {
421
+ runtimeContextKeys: ['experimentId'], // Adds to configured keys
422
+ },
423
+ });
424
+
425
+ // All spans now have: userId, environment, AND experimentId
426
+ ```
427
+
428
+ #### Nested Value Extraction
429
+
430
+ Use dot notation to extract nested values from RuntimeContext:
431
+
432
+ ```ts showLineNumbers copy
433
+ export const mastra = new Mastra({
434
+ observability: {
435
+ configs: {
436
+ default: {
437
+ runtimeContextKeys: ['user.id', 'session.data.experimentId'],
438
+ exporters: [new DefaultExporter()],
439
+ },
440
+ },
441
+ },
442
+ });
443
+
444
+ const runtimeContext = new RuntimeContext();
445
+ runtimeContext.set('user', { id: 'user-456', name: 'John Doe' });
446
+ runtimeContext.set('session', { data: { experimentId: 'exp-999' } });
447
+
448
+ // Metadata will include: { user: { id: 'user-456' }, session: { data: { experimentId: 'exp-999' } } }
449
+ ```
450
+
451
+ #### How It Works
452
+
453
+ 1. **TraceState Computation**: At the start of a trace (root span creation), Mastra computes which keys to extract by merging configuration-level and per-request keys
454
+ 2. **Automatic Extraction**: Root spans (agent runs, workflow executions) automatically extract metadata from RuntimeContext
455
+ 3. **Child Span Extraction**: Child spans can also extract metadata if you pass `runtimeContext` when creating them
456
+ 4. **Metadata Precedence**: Explicit metadata passed to span options always takes precedence over extracted metadata
457
+
458
+ #### Child Spans and Metadata Extraction
459
+
460
+ When creating child spans within tools or workflow steps, you can pass the `runtimeContext` parameter to enable metadata extraction:
461
+
462
+ ```ts showLineNumbers copy
463
+ execute: async ({ tracingContext, runtimeContext }) => {
464
+ // Create child span WITH runtimeContext - gets metadata extraction
465
+ const dbSpan = tracingContext.currentSpan?.createChildSpan({
466
+ type: 'generic',
467
+ name: 'database-query',
468
+ runtimeContext, // Pass to enable metadata extraction
469
+ });
470
+
471
+ const results = await db.query('SELECT * FROM users');
472
+ dbSpan?.end({ output: results });
473
+
474
+ // Or create child span WITHOUT runtimeContext - no metadata extraction
475
+ const cacheSpan = tracingContext.currentSpan?.createChildSpan({
476
+ type: 'generic',
477
+ name: 'cache-check',
478
+ // No runtimeContext - won't extract metadata
479
+ });
480
+
481
+ return results;
482
+ }
483
+ ```
484
+
485
+ This gives you fine-grained control over which child spans include RuntimeContext metadata. Root spans (agent/workflow executions) always extract metadata automatically, while child spans only extract when you explicitly pass `runtimeContext`.
486
+
370
487
  ## Creating Child Spans
371
488
 
372
489
  Child spans allow you to track fine-grained operations within your workflow steps or tools. They provide visibility into sub-operations like database queries, API calls, file operations, or complex calculations. This hierarchical structure helps you identify performance bottlenecks and understand the exact sequence of operations.
@@ -517,6 +634,109 @@ Once you have a trace ID, you can:
517
634
 
518
635
  The trace ID is only available when tracing is enabled. If tracing is disabled or sampling excludes the request, `traceId` will be `undefined`.
519
636
 
637
+ ## Integrating with External Tracing Systems
638
+
639
+ When running Mastra agents or workflows within applications that have existing distributed tracing (OpenTelemetry, Datadog, etc.), you can connect Mastra traces to your parent trace context. This creates a unified view of your entire request flow, making it easier to understand how Mastra operations fit into the broader system.
640
+
641
+ ### Passing External Trace IDs
642
+
643
+ Use the `tracingOptions` parameter to specify the trace context from your parent system:
644
+
645
+ ```ts showLineNumbers copy
646
+ // Get trace context from your existing tracing system
647
+ const parentTraceId = getCurrentTraceId(); // Your tracing system
648
+ const parentSpanId = getCurrentSpanId(); // Your tracing system
649
+
650
+ // Execute Mastra operations as part of the parent trace
651
+ const result = await agent.generate('Analyze this data', {
652
+ tracingOptions: {
653
+ traceId: parentTraceId,
654
+ parentSpanId: parentSpanId,
655
+ }
656
+ });
657
+
658
+ // The Mastra trace will now appear as a child in your distributed trace
659
+ ```
660
+
661
+ ### OpenTelemetry Integration
662
+
663
+ Integration with OpenTelemetry allows Mastra traces to appear seamlessly in your existing observability platform:
664
+
665
+ ```ts showLineNumbers copy
666
+ import { trace } from '@opentelemetry/api';
667
+
668
+ // Get the current OpenTelemetry span
669
+ const currentSpan = trace.getActiveSpan();
670
+ const spanContext = currentSpan?.spanContext();
671
+
672
+ if (spanContext) {
673
+ const result = await agent.generate(userMessage, {
674
+ tracingOptions: {
675
+ traceId: spanContext.traceId,
676
+ parentSpanId: spanContext.spanId,
677
+ }
678
+ });
679
+ }
680
+ ```
681
+
682
+ ### Workflow Integration
683
+
684
+ Workflows support the same pattern for trace propagation:
685
+
686
+ ```ts showLineNumbers copy
687
+ const workflow = mastra.getWorkflow('data-pipeline');
688
+ const run = await workflow.createRunAsync();
689
+
690
+ const result = await run.start({
691
+ inputData: { data: '...' },
692
+ tracingOptions: {
693
+ traceId: externalTraceId,
694
+ parentSpanId: externalSpanId,
695
+ }
696
+ });
697
+ ```
698
+
699
+ ### ID Format Requirements
700
+
701
+ Mastra validates trace and span IDs to ensure compatibility:
702
+
703
+ - **Trace IDs**: 1-32 hexadecimal characters (OpenTelemetry uses 32)
704
+ - **Span IDs**: 1-16 hexadecimal characters (OpenTelemetry uses 16)
705
+
706
+ Invalid IDs are handled gracefully — Mastra logs an error and continues:
707
+ - Invalid trace ID → generates a new trace ID
708
+ - Invalid parent span ID → ignores the parent relationship
709
+
710
+ This ensures tracing never crashes your application, even with malformed input.
711
+
712
+ ### Example: Express Middleware
713
+
714
+ Here's a complete example showing trace propagation in an Express application:
715
+
716
+ ```ts showLineNumbers copy
717
+ import { trace } from '@opentelemetry/api';
718
+ import express from 'express';
719
+
720
+ const app = express();
721
+
722
+ app.post('/api/analyze', async (req, res) => {
723
+ // Get current OpenTelemetry context
724
+ const currentSpan = trace.getActiveSpan();
725
+ const spanContext = currentSpan?.spanContext();
726
+
727
+ const result = await agent.generate(req.body.message, {
728
+ tracingOptions: spanContext ? {
729
+ traceId: spanContext.traceId,
730
+ parentSpanId: spanContext.spanId,
731
+ } : undefined,
732
+ });
733
+
734
+ res.json(result);
735
+ });
736
+ ```
737
+
738
+ This creates a single distributed trace that includes both the HTTP request handling and the Mastra agent execution, viewable in your observability platform of choice.
739
+
520
740
  ## What Gets Traced
521
741
 
522
742
  Mastra automatically creates spans for:
@@ -96,7 +96,7 @@ Instead of an interactive prompt you can also define these CLI flags.
96
96
  name: "--components",
97
97
  type: "string",
98
98
  description:
99
- "Comma-separated list of components (agents, tools, workflows)",
99
+ "Comma-separated list of components (agents, tools, workflows, scorers)",
100
100
  isOptional: true,
101
101
  },
102
102
  {
@@ -173,7 +173,7 @@ The directory where Mastra files should be saved to. Defaults to `src`.
173
173
 
174
174
  #### `--components`
175
175
 
176
- Comma-separated list of components to add. For each component a new folder will be created. Defaults to `['agents', 'tools', 'workflows']`.
176
+ Comma-separated list of components to add. For each component a new folder will be created. Choose from: `"agents" | "tools" | "workflows" | "scorers"`. Defaults to `['agents', 'tools', 'workflows']`.
177
177
 
178
178
  #### `--llm`
179
179