@mastra/react 0.0.0-error-handler-fix-20251020202607 → 0.0.0-everlasting-joggers-20260331153923

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 (112) hide show
  1. package/CHANGELOG.md +1566 -3
  2. package/LICENSE.md +15 -0
  3. package/dist/agent/hooks.d.ts +68 -0
  4. package/dist/agent/hooks.d.ts.map +1 -0
  5. package/dist/{src/agent → agent}/types.d.ts +2 -0
  6. package/dist/agent/types.d.ts.map +1 -0
  7. package/dist/index.cjs +1615 -296
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.d.ts +9 -2
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +1604 -287
  12. package/dist/index.js.map +1 -1
  13. package/dist/lib/ai-sdk/index.d.ts +5 -0
  14. package/dist/lib/ai-sdk/index.d.ts.map +1 -0
  15. package/dist/lib/ai-sdk/memory/resolveInitialMessages.d.ts +13 -0
  16. package/dist/lib/ai-sdk/memory/resolveInitialMessages.d.ts.map +1 -0
  17. package/dist/{src/lib → lib}/ai-sdk/transformers/AISdkNetworkTransformer.d.ts +4 -3
  18. package/dist/lib/ai-sdk/transformers/AISdkNetworkTransformer.d.ts.map +1 -0
  19. package/dist/lib/ai-sdk/transformers/types.d.ts +11 -0
  20. package/dist/lib/ai-sdk/transformers/types.d.ts.map +1 -0
  21. package/dist/lib/ai-sdk/types.d.ts +116 -0
  22. package/dist/lib/ai-sdk/types.d.ts.map +1 -0
  23. package/dist/lib/ai-sdk/utils/formatCompletionFeedback.d.ts +19 -0
  24. package/dist/lib/ai-sdk/utils/formatCompletionFeedback.d.ts.map +1 -0
  25. package/dist/lib/ai-sdk/utils/fromCoreUserMessageToUIMessage.d.ts +11 -0
  26. package/dist/lib/ai-sdk/utils/fromCoreUserMessageToUIMessage.d.ts.map +1 -0
  27. package/dist/{src/lib → lib}/ai-sdk/utils/toAssistantUIMessage.d.ts +3 -2
  28. package/dist/lib/ai-sdk/utils/toAssistantUIMessage.d.ts.map +1 -0
  29. package/dist/{src/lib → lib}/ai-sdk/utils/toUIMessage.d.ts +4 -3
  30. package/dist/lib/ai-sdk/utils/toUIMessage.d.ts.map +1 -0
  31. package/dist/lib/use-mutation.d.ts +28 -0
  32. package/dist/lib/use-mutation.d.ts.map +1 -0
  33. package/dist/mastra-client-context.d.ts +21 -0
  34. package/dist/mastra-client-context.d.ts.map +1 -0
  35. package/dist/mastra-react-provider.d.ts +5 -0
  36. package/dist/mastra-react-provider.d.ts.map +1 -0
  37. package/dist/react.css +184 -322
  38. package/dist/{src/ui → ui}/Code/Code.d.ts +2 -1
  39. package/dist/ui/Code/Code.d.ts.map +1 -0
  40. package/dist/ui/Code/highlight.d.ts +4 -0
  41. package/dist/ui/Code/highlight.d.ts.map +1 -0
  42. package/dist/ui/Code/index.d.ts +2 -0
  43. package/dist/ui/Code/index.d.ts.map +1 -0
  44. package/dist/{src/ui → ui}/Entity/Entity.d.ts +2 -1
  45. package/dist/ui/Entity/Entity.d.ts.map +1 -0
  46. package/dist/{src/ui → ui}/Entity/Entry.d.ts +2 -1
  47. package/dist/ui/Entity/Entry.d.ts.map +1 -0
  48. package/dist/{src/ui → ui}/Entity/ToolApproval.d.ts +1 -0
  49. package/dist/ui/Entity/ToolApproval.d.ts.map +1 -0
  50. package/dist/{src/ui → ui}/Entity/context.d.ts +4 -3
  51. package/dist/ui/Entity/context.d.ts.map +1 -0
  52. package/dist/ui/Entity/index.d.ts +5 -0
  53. package/dist/ui/Entity/index.d.ts.map +1 -0
  54. package/dist/{src/ui → ui}/Entity/types.d.ts +1 -0
  55. package/dist/ui/Entity/types.d.ts.map +1 -0
  56. package/dist/{src/ui → ui}/Icon/Icon.d.ts +2 -1
  57. package/dist/ui/Icon/Icon.d.ts.map +1 -0
  58. package/dist/ui/Icon/index.d.ts +2 -0
  59. package/dist/ui/Icon/index.d.ts.map +1 -0
  60. package/dist/{src/ui → ui}/IconButton/IconButton.d.ts +2 -1
  61. package/dist/ui/IconButton/IconButton.d.ts.map +1 -0
  62. package/dist/ui/IconButton/index.d.ts +2 -0
  63. package/dist/ui/IconButton/index.d.ts.map +1 -0
  64. package/dist/{src/ui → ui}/Icons/AgentIcon.d.ts +2 -1
  65. package/dist/ui/Icons/AgentIcon.d.ts.map +1 -0
  66. package/dist/{src/ui → ui}/Icons/ToolsIcon.d.ts +2 -1
  67. package/dist/ui/Icons/ToolsIcon.d.ts.map +1 -0
  68. package/dist/{src/ui → ui}/Icons/WorkflowIcon.d.ts +2 -1
  69. package/dist/ui/Icons/WorkflowIcon.d.ts.map +1 -0
  70. package/dist/ui/Icons/index.d.ts +4 -0
  71. package/dist/ui/Icons/index.d.ts.map +1 -0
  72. package/dist/{src/ui → ui}/Message/Message.d.ts +2 -1
  73. package/dist/ui/Message/Message.d.ts.map +1 -0
  74. package/dist/ui/Message/index.d.ts +2 -0
  75. package/dist/ui/Message/index.d.ts.map +1 -0
  76. package/dist/{src/ui → ui}/Tooltip/Tooltip.d.ts +2 -1
  77. package/dist/ui/Tooltip/Tooltip.d.ts.map +1 -0
  78. package/dist/ui/Tooltip/index.d.ts +2 -0
  79. package/dist/ui/Tooltip/index.d.ts.map +1 -0
  80. package/dist/ui/index.d.ts +8 -0
  81. package/dist/ui/index.d.ts.map +1 -0
  82. package/dist/workflows/hooks.d.ts +34 -0
  83. package/dist/workflows/hooks.d.ts.map +1 -0
  84. package/dist/workflows/index.d.ts +3 -0
  85. package/dist/workflows/index.d.ts.map +1 -0
  86. package/dist/workflows/types.d.ts +122 -0
  87. package/dist/workflows/types.d.ts.map +1 -0
  88. package/dist/workflows/use-stream-workflow.d.ts +39 -0
  89. package/dist/workflows/use-stream-workflow.d.ts.map +1 -0
  90. package/package.json +41 -30
  91. package/dist/src/agent/hooks.d.ts +0 -46
  92. package/dist/src/index.d.ts +0 -6
  93. package/dist/src/lib/ai-sdk/index.d.ts +0 -3
  94. package/dist/src/lib/ai-sdk/memory/resolveInitialMessages.d.ts +0 -2
  95. package/dist/src/lib/ai-sdk/transformers/types.d.ts +0 -10
  96. package/dist/src/lib/ai-sdk/types.d.ts +0 -14
  97. package/dist/src/lib/ai-sdk/utils/toAssistantUIMessage.test.d.ts +0 -1
  98. package/dist/src/mastra-client-context.d.ts +0 -10
  99. package/dist/src/mastra-react-provider.d.ts +0 -4
  100. package/dist/src/ui/Code/highlight.d.ts +0 -3
  101. package/dist/src/ui/Code/index.d.ts +0 -1
  102. package/dist/src/ui/Entity/Entity.stories.d.ts +0 -22
  103. package/dist/src/ui/Entity/index.d.ts +0 -4
  104. package/dist/src/ui/Icon/index.d.ts +0 -1
  105. package/dist/src/ui/IconButton/IconButton.stories.d.ts +0 -12
  106. package/dist/src/ui/IconButton/index.d.ts +0 -1
  107. package/dist/src/ui/Icons/index.d.ts +0 -3
  108. package/dist/src/ui/Message/Message.stories.d.ts +0 -13
  109. package/dist/src/ui/Message/index.d.ts +0 -1
  110. package/dist/src/ui/Tooltip/Tooltip.stories.d.ts +0 -12
  111. package/dist/src/ui/Tooltip/index.d.ts +0 -1
  112. package/dist/src/ui/index.d.ts +0 -7
package/CHANGELOG.md CHANGED
@@ -1,13 +1,1576 @@
1
- # @mastra/react-hooks
1
+ # @mastra/react
2
2
 
3
- ## 0.0.0-error-handler-fix-20251020202607
3
+ ## 0.0.0-everlasting-joggers-20260331153923
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`180aaaf`](https://github.com/mastra-ai/mastra/commit/180aaaf4d0903d33a49bc72de2d40ca69a5bc599), [`9140989`](https://github.com/mastra-ai/mastra/commit/91409890e83f4f1d9c1b39223f1af91a6a53b549), [`0762516`](https://github.com/mastra-ai/mastra/commit/07625167e029a8268ea7aaf0402416e6d8832874), [`d3736cb`](https://github.com/mastra-ai/mastra/commit/d3736cb9ce074d2b8e8b00218a01f790fe81a1b4), [`9ca7d26`](https://github.com/mastra-ai/mastra/commit/9ca7d26a8d72c78c2e846343b7af50680f7cb7a5)]:
8
+ - @mastra/core@0.0.0-everlasting-joggers-20260331153923
9
+ - @mastra/client-js@0.0.0-everlasting-joggers-20260331153923
10
+
11
+ ## 0.2.19-alpha.0
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`180aaaf`](https://github.com/mastra-ai/mastra/commit/180aaaf4d0903d33a49bc72de2d40ca69a5bc599)]:
16
+ - @mastra/core@1.18.1-alpha.0
17
+ - @mastra/client-js@1.11.1-alpha.0
18
+
19
+ ## 0.2.18
20
+
21
+ ### Patch Changes
22
+
23
+ - Added requestContext support to tool approval and decline methods, ensuring agent version context is preserved when resuming after tool approval. ([#14847](https://github.com/mastra-ai/mastra/pull/14847))
24
+
25
+ - **Fixed** React UIs getting `401` from Mastra after a successful cookie login when the app and API run on different hosts or ports (for example Mastra Studio against a custom server). API calls from `MastraReactProvider` now include session cookies by default ([#14770](https://github.com/mastra-ai/mastra/issues/14770)). ([#14777](https://github.com/mastra-ai/mastra/pull/14777))
26
+
27
+ **Added** optional `credentials` prop when you want tighter control, for example same-origin-only requests:
28
+
29
+ ```tsx
30
+ <MastraReactProvider baseUrl="http://localhost:4000" credentials="same-origin">
31
+ {children}
32
+ </MastraReactProvider>
33
+ ```
34
+
35
+ **Added** `MastraClientCredentials` and `MastraClientProviderProps` type exports.
36
+
37
+ - Fix restored subagent tool results so approval cards and nested tool state appear correctly in the dev server. ([#14348](https://github.com/mastra-ai/mastra/pull/14348))
38
+
39
+ - Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`197daf0`](https://github.com/mastra-ai/mastra/commit/197daf03a33e4650bd90391eef0ec7d0392a6c9c), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
40
+ - @mastra/core@1.18.0
41
+ - @mastra/client-js@1.11.0
42
+
43
+ ## 0.2.18-alpha.8
44
+
45
+ ### Patch Changes
46
+
47
+ - Added requestContext support to tool approval and decline methods, ensuring agent version context is preserved when resuming after tool approval. ([#14847](https://github.com/mastra-ai/mastra/pull/14847))
48
+
49
+ - Updated dependencies [[`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a)]:
50
+ - @mastra/client-js@1.11.0-alpha.8
51
+ - @mastra/core@1.18.0-alpha.5
52
+
53
+ ## 0.2.18-alpha.7
54
+
55
+ ### Patch Changes
56
+
57
+ - Updated dependencies [[`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85)]:
58
+ - @mastra/core@1.18.0-alpha.4
59
+ - @mastra/client-js@1.11.0-alpha.7
60
+
61
+ ## 0.2.18-alpha.6
62
+
63
+ ### Patch Changes
64
+
65
+ - **Fixed** React UIs getting `401` from Mastra after a successful cookie login when the app and API run on different hosts or ports (for example Mastra Studio against a custom server). API calls from `MastraReactProvider` now include session cookies by default ([#14770](https://github.com/mastra-ai/mastra/issues/14770)). ([#14777](https://github.com/mastra-ai/mastra/pull/14777))
66
+
67
+ **Added** optional `credentials` prop when you want tighter control, for example same-origin-only requests:
68
+
69
+ ```tsx
70
+ <MastraReactProvider baseUrl="http://localhost:4000" credentials="same-origin">
71
+ {children}
72
+ </MastraReactProvider>
73
+ ```
74
+
75
+ **Added** `MastraClientCredentials` and `MastraClientProviderProps` type exports.
76
+
77
+ - Fix restored subagent tool results so approval cards and nested tool state appear correctly in the dev server. ([#14348](https://github.com/mastra-ai/mastra/pull/14348))
78
+
79
+ - Updated dependencies [[`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
80
+ - @mastra/client-js@1.11.0-alpha.6
81
+ - @mastra/core@1.18.0-alpha.3
82
+
83
+ ## 0.2.18-alpha.5
84
+
85
+ ### Patch Changes
86
+
87
+ - Updated dependencies [[`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4)]:
88
+ - @mastra/core@1.18.0-alpha.2
89
+ - @mastra/client-js@1.10.1-alpha.5
90
+
91
+ ## 0.2.18-alpha.4
92
+
93
+ ### Patch Changes
94
+
95
+ - Updated dependencies [[`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0)]:
96
+ - @mastra/core@1.18.0-alpha.1
97
+ - @mastra/client-js@1.10.1-alpha.4
98
+
99
+ ## 0.2.18-alpha.3
100
+
101
+ ### Patch Changes
102
+
103
+ - Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`197daf0`](https://github.com/mastra-ai/mastra/commit/197daf03a33e4650bd90391eef0ec7d0392a6c9c), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778)]:
104
+ - @mastra/core@1.18.0-alpha.0
105
+ - @mastra/client-js@1.10.1-alpha.3
106
+
107
+ ## 0.2.18-alpha.2
108
+
109
+ ### Patch Changes
110
+
111
+ - Updated dependencies [[`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`197daf0`](https://github.com/mastra-ai/mastra/commit/197daf03a33e4650bd90391eef0ec7d0392a6c9c), [`86e3263`](https://github.com/mastra-ai/mastra/commit/86e326363edd12be5a5b25ccce4a39f66f7c9f50), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778)]:
112
+ - @mastra/core@1.17.0-alpha.2
113
+ - @mastra/client-js@1.10.1-alpha.2
114
+
115
+ ## 0.2.18-alpha.1
116
+
117
+ ### Patch Changes
118
+
119
+ - Updated dependencies [[`7302e5c`](https://github.com/mastra-ai/mastra/commit/7302e5ce0f52d769d3d63fb0faa8a7d4089cda6d)]:
120
+ - @mastra/core@1.16.1-alpha.1
121
+ - @mastra/client-js@1.10.1-alpha.1
122
+
123
+ ## 0.2.18-alpha.0
124
+
125
+ ### Patch Changes
126
+
127
+ - Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067)]:
128
+ - @mastra/core@1.16.1-alpha.0
129
+ - @mastra/client-js@1.10.1-alpha.0
130
+
131
+ ## 0.2.17
132
+
133
+ ### Patch Changes
134
+
135
+ - Fix Zod v3 and Zod v4 compatibility across public structured-output APIs. ([#14464](https://github.com/mastra-ai/mastra/pull/14464))
136
+
137
+ Mastra agent and client APIs accept schemas from either `zod/v3` or `zod/v4`, matching the documented peer dependency range and preserving TypeScript compatibility for both Zod versions.
138
+
139
+ - Updated dependencies [[`68ed4e9`](https://github.com/mastra-ai/mastra/commit/68ed4e9f118e8646b60a6112dabe854d0ef53902), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`be37de4`](https://github.com/mastra-ai/mastra/commit/be37de4391bd1d5486ce38efacbf00ca51637262), [`7dbd611`](https://github.com/mastra-ai/mastra/commit/7dbd611a85cb1e0c0a1581c57564268cb183d86e), [`f14604c`](https://github.com/mastra-ai/mastra/commit/f14604c7ef01ba794e1a8d5c7bae5415852aacec), [`4a75e10`](https://github.com/mastra-ai/mastra/commit/4a75e106bd31c283a1b3fe74c923610dcc46415b), [`f3ce603`](https://github.com/mastra-ai/mastra/commit/f3ce603fd76180f4a5be90b6dc786d389b6b3e98), [`423aa6f`](https://github.com/mastra-ai/mastra/commit/423aa6fd12406de6a1cc6b68e463d30af1d790fb), [`f21c626`](https://github.com/mastra-ai/mastra/commit/f21c6263789903ab9720b4d11373093298e97f15), [`41aee84`](https://github.com/mastra-ai/mastra/commit/41aee84561ceebe28bad1ecba8702d92838f67f0), [`2871451`](https://github.com/mastra-ai/mastra/commit/2871451703829aefa06c4a5d6eca7fd3731222ef), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`256ed46`](https://github.com/mastra-ai/mastra/commit/256ed462e260afb287ae83eed030017e9ec6a0c0), [`e06b520`](https://github.com/mastra-ai/mastra/commit/e06b520bdd5fdef844760c5e692c7852cbc5c240), [`d3930ea`](https://github.com/mastra-ai/mastra/commit/d3930eac51c30b0ecf7eaa54bb9430758b399777), [`dd9c4e0`](https://github.com/mastra-ai/mastra/commit/dd9c4e0a47962f1413e9b72114fcad912e19a0a6)]:
140
+ - @mastra/core@1.16.0
141
+ - @mastra/client-js@1.10.0
142
+
143
+ ## 0.2.17-alpha.5
144
+
145
+ ### Patch Changes
146
+
147
+ - Updated dependencies [[`f21c626`](https://github.com/mastra-ai/mastra/commit/f21c6263789903ab9720b4d11373093298e97f15)]:
148
+ - @mastra/core@1.16.0-alpha.5
149
+ - @mastra/client-js@1.10.0-alpha.5
150
+
151
+ ## 0.2.17-alpha.4
152
+
153
+ ### Patch Changes
154
+
155
+ - Updated dependencies [[`f14604c`](https://github.com/mastra-ai/mastra/commit/f14604c7ef01ba794e1a8d5c7bae5415852aacec), [`e06b520`](https://github.com/mastra-ai/mastra/commit/e06b520bdd5fdef844760c5e692c7852cbc5c240), [`dd9c4e0`](https://github.com/mastra-ai/mastra/commit/dd9c4e0a47962f1413e9b72114fcad912e19a0a6)]:
156
+ - @mastra/core@1.16.0-alpha.4
157
+ - @mastra/client-js@1.10.0-alpha.4
158
+
159
+ ## 0.2.17-alpha.3
160
+
161
+ ### Patch Changes
162
+
163
+ - Updated dependencies [[`423aa6f`](https://github.com/mastra-ai/mastra/commit/423aa6fd12406de6a1cc6b68e463d30af1d790fb), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`256ed46`](https://github.com/mastra-ai/mastra/commit/256ed462e260afb287ae83eed030017e9ec6a0c0)]:
164
+ - @mastra/core@1.16.0-alpha.3
165
+ - @mastra/client-js@1.10.0-alpha.3
166
+
167
+ ## 0.2.17-alpha.2
168
+
169
+ ### Patch Changes
170
+
171
+ - Fix Zod v3 and Zod v4 compatibility across public structured-output APIs. ([#14464](https://github.com/mastra-ai/mastra/pull/14464))
172
+
173
+ Mastra agent and client APIs accept schemas from either `zod/v3` or `zod/v4`, matching the documented peer dependency range and preserving TypeScript compatibility for both Zod versions.
174
+
175
+ - Updated dependencies [[`be37de4`](https://github.com/mastra-ai/mastra/commit/be37de4391bd1d5486ce38efacbf00ca51637262), [`f3ce603`](https://github.com/mastra-ai/mastra/commit/f3ce603fd76180f4a5be90b6dc786d389b6b3e98), [`2871451`](https://github.com/mastra-ai/mastra/commit/2871451703829aefa06c4a5d6eca7fd3731222ef), [`d3930ea`](https://github.com/mastra-ai/mastra/commit/d3930eac51c30b0ecf7eaa54bb9430758b399777)]:
176
+ - @mastra/core@1.16.0-alpha.2
177
+ - @mastra/client-js@1.10.0-alpha.2
178
+
179
+ ## 0.2.17-alpha.1
180
+
181
+ ### Patch Changes
182
+
183
+ - Updated dependencies [[`7dbd611`](https://github.com/mastra-ai/mastra/commit/7dbd611a85cb1e0c0a1581c57564268cb183d86e), [`41aee84`](https://github.com/mastra-ai/mastra/commit/41aee84561ceebe28bad1ecba8702d92838f67f0)]:
184
+ - @mastra/core@1.16.0-alpha.1
185
+ - @mastra/client-js@1.10.0-alpha.1
186
+
187
+ ## 0.2.17-alpha.0
188
+
189
+ ### Patch Changes
190
+
191
+ - Updated dependencies [[`68ed4e9`](https://github.com/mastra-ai/mastra/commit/68ed4e9f118e8646b60a6112dabe854d0ef53902), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`4a75e10`](https://github.com/mastra-ai/mastra/commit/4a75e106bd31c283a1b3fe74c923610dcc46415b), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c), [`085c1da`](https://github.com/mastra-ai/mastra/commit/085c1daf71b55a97b8ebad26623089e40055021c)]:
192
+ - @mastra/core@1.16.0-alpha.0
193
+ - @mastra/client-js@1.10.0-alpha.0
194
+
195
+ ## 0.2.16
196
+
197
+ ### Patch Changes
198
+
199
+ - Updated dependencies [[`cb611a1`](https://github.com/mastra-ai/mastra/commit/cb611a1e89a4f4cf74c97b57e0c27bb56f2eceb5), [`da93115`](https://github.com/mastra-ai/mastra/commit/da931155c1a9bc63d455d3d86b4ec984db5991fe), [`62d1d3c`](https://github.com/mastra-ai/mastra/commit/62d1d3cc08fe8182e7080237fd975de862ec8c91), [`9e1a3ed`](https://github.com/mastra-ai/mastra/commit/9e1a3ed07cfafb5e8e19a796ce0bee817002d7c0), [`8681ecb`](https://github.com/mastra-ai/mastra/commit/8681ecb86184d5907267000e4576cc442a9a83fc), [`28d0249`](https://github.com/mastra-ai/mastra/commit/28d0249295782277040ad1e0d243e695b7ab1ce4), [`681ee1c`](https://github.com/mastra-ai/mastra/commit/681ee1c811359efd1b8bebc4bce35b9bb7b14bec), [`bb0f09d`](https://github.com/mastra-ai/mastra/commit/bb0f09dbac58401b36069f483acf5673202db5b5), [`a579f7a`](https://github.com/mastra-ai/mastra/commit/a579f7a31e582674862b5679bc79af7ccf7429b8), [`5f7e9d0`](https://github.com/mastra-ai/mastra/commit/5f7e9d0db664020e1f3d97d7d18c6b0b9d4843d0), [`d7f14c3`](https://github.com/mastra-ai/mastra/commit/d7f14c3285cd253ecdd5f58139b7b6cbdf3678b5), [`0efe12a`](https://github.com/mastra-ai/mastra/commit/0efe12a5f008a939a1aac71699486ba40138054e)]:
200
+ - @mastra/core@1.15.0
201
+ - @mastra/client-js@1.9.1
202
+
203
+ ## 0.2.16-alpha.4
204
+
205
+ ### Patch Changes
206
+
207
+ - Updated dependencies [[`da93115`](https://github.com/mastra-ai/mastra/commit/da931155c1a9bc63d455d3d86b4ec984db5991fe), [`0efe12a`](https://github.com/mastra-ai/mastra/commit/0efe12a5f008a939a1aac71699486ba40138054e)]:
208
+ - @mastra/core@1.15.0-alpha.4
209
+ - @mastra/client-js@1.9.1-alpha.4
210
+
211
+ ## 0.2.16-alpha.3
212
+
213
+ ### Patch Changes
214
+
215
+ - Updated dependencies [[`d7f14c3`](https://github.com/mastra-ai/mastra/commit/d7f14c3285cd253ecdd5f58139b7b6cbdf3678b5)]:
216
+ - @mastra/core@1.15.0-alpha.3
217
+ - @mastra/client-js@1.9.1-alpha.3
218
+
219
+ ## 0.2.16-alpha.2
220
+
221
+ ### Patch Changes
222
+
223
+ - Updated dependencies [[`9e1a3ed`](https://github.com/mastra-ai/mastra/commit/9e1a3ed07cfafb5e8e19a796ce0bee817002d7c0), [`a579f7a`](https://github.com/mastra-ai/mastra/commit/a579f7a31e582674862b5679bc79af7ccf7429b8)]:
224
+ - @mastra/core@1.15.0-alpha.2
225
+ - @mastra/client-js@1.9.1-alpha.2
226
+
227
+ ## 0.2.16-alpha.1
228
+
229
+ ### Patch Changes
230
+
231
+ - Updated dependencies [[`681ee1c`](https://github.com/mastra-ai/mastra/commit/681ee1c811359efd1b8bebc4bce35b9bb7b14bec)]:
232
+ - @mastra/core@1.15.0-alpha.1
233
+ - @mastra/client-js@1.9.1-alpha.1
234
+
235
+ ## 0.2.16-alpha.0
236
+
237
+ ### Patch Changes
238
+
239
+ - Updated dependencies [[`cb611a1`](https://github.com/mastra-ai/mastra/commit/cb611a1e89a4f4cf74c97b57e0c27bb56f2eceb5), [`62d1d3c`](https://github.com/mastra-ai/mastra/commit/62d1d3cc08fe8182e7080237fd975de862ec8c91), [`8681ecb`](https://github.com/mastra-ai/mastra/commit/8681ecb86184d5907267000e4576cc442a9a83fc), [`28d0249`](https://github.com/mastra-ai/mastra/commit/28d0249295782277040ad1e0d243e695b7ab1ce4), [`bb0f09d`](https://github.com/mastra-ai/mastra/commit/bb0f09dbac58401b36069f483acf5673202db5b5), [`5f7e9d0`](https://github.com/mastra-ai/mastra/commit/5f7e9d0db664020e1f3d97d7d18c6b0b9d4843d0)]:
240
+ - @mastra/core@1.15.0-alpha.0
241
+ - @mastra/client-js@1.9.1-alpha.0
242
+
243
+ ## 0.2.15
244
+
245
+ ### Patch Changes
246
+
247
+ - Updated dependencies [[`51970b3`](https://github.com/mastra-ai/mastra/commit/51970b3828494d59a8dd4df143b194d37d31e3f5), [`4444280`](https://github.com/mastra-ai/mastra/commit/444428094253e916ec077e66284e685fde67021e), [`085e371`](https://github.com/mastra-ai/mastra/commit/085e3718a7d0fe9a210fe7dd1c867b9bdfe8d16b), [`b77aa19`](https://github.com/mastra-ai/mastra/commit/b77aa1981361c021f2c881bee8f0c703687f00da), [`dbb879a`](https://github.com/mastra-ai/mastra/commit/dbb879af0b809c668e9b3a9d8bac97d806caa267), [`8b4ce84`](https://github.com/mastra-ai/mastra/commit/8b4ce84aed0808b9805cc4fd7147c1f8a2ef7a36), [`8d4cfe6`](https://github.com/mastra-ai/mastra/commit/8d4cfe6b9a7157d3876206227ec9f04cde6dbc4a), [`dd6ca1c`](https://github.com/mastra-ai/mastra/commit/dd6ca1cdea3b8b6182f4cf61df41070ba0cc0deb), [`ce26fe2`](https://github.com/mastra-ai/mastra/commit/ce26fe2166dd90254f8bee5776e55977143e97de), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a), [`4cb4edf`](https://github.com/mastra-ai/mastra/commit/4cb4edf3c909d197ec356c1790d13270514ffef6), [`8de3555`](https://github.com/mastra-ai/mastra/commit/8de355572c6fd838f863a3e7e6fe24d0947b774f), [`b26307f`](https://github.com/mastra-ai/mastra/commit/b26307f050df39629511b0e831b8fc26973ce8b1), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a), [`8de3555`](https://github.com/mastra-ai/mastra/commit/8de355572c6fd838f863a3e7e6fe24d0947b774f)]:
248
+ - @mastra/core@1.14.0
249
+ - @mastra/client-js@1.9.0
250
+
251
+ ## 0.2.15-alpha.3
252
+
253
+ ### Patch Changes
254
+
255
+ - Updated dependencies [[`8b4ce84`](https://github.com/mastra-ai/mastra/commit/8b4ce84aed0808b9805cc4fd7147c1f8a2ef7a36), [`8d4cfe6`](https://github.com/mastra-ai/mastra/commit/8d4cfe6b9a7157d3876206227ec9f04cde6dbc4a), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a)]:
256
+ - @mastra/core@1.14.0-alpha.3
257
+ - @mastra/client-js@1.9.0-alpha.3
258
+
259
+ ## 0.2.15-alpha.2
260
+
261
+ ### Patch Changes
262
+
263
+ - Updated dependencies [[`4444280`](https://github.com/mastra-ai/mastra/commit/444428094253e916ec077e66284e685fde67021e), [`dbb879a`](https://github.com/mastra-ai/mastra/commit/dbb879af0b809c668e9b3a9d8bac97d806caa267), [`8de3555`](https://github.com/mastra-ai/mastra/commit/8de355572c6fd838f863a3e7e6fe24d0947b774f), [`8de3555`](https://github.com/mastra-ai/mastra/commit/8de355572c6fd838f863a3e7e6fe24d0947b774f)]:
264
+ - @mastra/core@1.14.0-alpha.2
265
+ - @mastra/client-js@1.9.0-alpha.2
266
+
267
+ ## 0.2.15-alpha.1
268
+
269
+ ### Patch Changes
270
+
271
+ - Updated dependencies [[`b77aa19`](https://github.com/mastra-ai/mastra/commit/b77aa1981361c021f2c881bee8f0c703687f00da), [`dd6ca1c`](https://github.com/mastra-ai/mastra/commit/dd6ca1cdea3b8b6182f4cf61df41070ba0cc0deb), [`4cb4edf`](https://github.com/mastra-ai/mastra/commit/4cb4edf3c909d197ec356c1790d13270514ffef6)]:
272
+ - @mastra/core@1.13.3-alpha.1
273
+ - @mastra/client-js@1.8.5-alpha.1
274
+
275
+ ## 0.2.15-alpha.0
276
+
277
+ ### Patch Changes
278
+
279
+ - Updated dependencies [[`51970b3`](https://github.com/mastra-ai/mastra/commit/51970b3828494d59a8dd4df143b194d37d31e3f5), [`085e371`](https://github.com/mastra-ai/mastra/commit/085e3718a7d0fe9a210fe7dd1c867b9bdfe8d16b), [`ce26fe2`](https://github.com/mastra-ai/mastra/commit/ce26fe2166dd90254f8bee5776e55977143e97de), [`b26307f`](https://github.com/mastra-ai/mastra/commit/b26307f050df39629511b0e831b8fc26973ce8b1)]:
280
+ - @mastra/core@1.13.3-alpha.0
281
+ - @mastra/client-js@1.8.5-alpha.0
282
+
283
+ ## 0.2.14
284
+
285
+ ### Patch Changes
286
+
287
+ - Updated dependencies [[`42c585b`](https://github.com/mastra-ai/mastra/commit/42c585bf863ab0a5081e7445f24a821f32b31c91), [`0ce6035`](https://github.com/mastra-ai/mastra/commit/0ce603591189f547397704e53f23c77bc5630071)]:
288
+ - @mastra/client-js@1.8.4
289
+ - @mastra/core@1.13.2
290
+
291
+ ## 0.2.14-alpha.0
292
+
293
+ ### Patch Changes
294
+
295
+ - Updated dependencies [[`0ce6035`](https://github.com/mastra-ai/mastra/commit/0ce603591189f547397704e53f23c77bc5630071)]:
296
+ - @mastra/core@1.13.2-alpha.0
297
+ - @mastra/client-js@1.8.4-alpha.0
298
+
299
+ ## 0.2.13
300
+
301
+ ### Patch Changes
302
+
303
+ - Updated dependencies [[`205e76c`](https://github.com/mastra-ai/mastra/commit/205e76c3ba652205dafb037f50a4a8eea73f6736)]:
304
+ - @mastra/core@1.13.1
305
+ - @mastra/client-js@1.8.3
306
+
307
+ ## 0.2.12
308
+
309
+ ### Patch Changes
310
+
311
+ - Updated dependencies [[`ea86967`](https://github.com/mastra-ai/mastra/commit/ea86967449426e0a3673253bd1c2c052a99d970d), [`db21c21`](https://github.com/mastra-ai/mastra/commit/db21c21a6ae5f33539262cc535342fa8757eb359), [`11f5dbe`](https://github.com/mastra-ai/mastra/commit/11f5dbe9a1e7ad8ef3b1ea34fb4a9fa3631d1587), [`6751354`](https://github.com/mastra-ai/mastra/commit/67513544d1a64be891d9de7624d40aadc895d56e), [`c958cd3`](https://github.com/mastra-ai/mastra/commit/c958cd36627c1eea122ec241b2b15492977a263a), [`86f2426`](https://github.com/mastra-ai/mastra/commit/86f242631d252a172d2f9f9a2ea0feb8647a76b0), [`950eb07`](https://github.com/mastra-ai/mastra/commit/950eb07b7e7354629630e218d49550fdd299c452)]:
312
+ - @mastra/core@1.13.0
313
+ - @mastra/client-js@1.8.2
314
+
315
+ ## 0.2.12-alpha.0
316
+
317
+ ### Patch Changes
318
+
319
+ - Updated dependencies [[`ea86967`](https://github.com/mastra-ai/mastra/commit/ea86967449426e0a3673253bd1c2c052a99d970d), [`db21c21`](https://github.com/mastra-ai/mastra/commit/db21c21a6ae5f33539262cc535342fa8757eb359), [`11f5dbe`](https://github.com/mastra-ai/mastra/commit/11f5dbe9a1e7ad8ef3b1ea34fb4a9fa3631d1587), [`6751354`](https://github.com/mastra-ai/mastra/commit/67513544d1a64be891d9de7624d40aadc895d56e), [`c958cd3`](https://github.com/mastra-ai/mastra/commit/c958cd36627c1eea122ec241b2b15492977a263a), [`86f2426`](https://github.com/mastra-ai/mastra/commit/86f242631d252a172d2f9f9a2ea0feb8647a76b0), [`950eb07`](https://github.com/mastra-ai/mastra/commit/950eb07b7e7354629630e218d49550fdd299c452)]:
320
+ - @mastra/core@1.13.0-alpha.0
321
+ - @mastra/client-js@1.8.2-alpha.0
322
+
323
+ ## 0.2.11
324
+
325
+ ### Patch Changes
326
+
327
+ - Updated dependencies [[`cddf895`](https://github.com/mastra-ai/mastra/commit/cddf895532b8ee7f9fa814136ec672f53d37a9ba), [`9cede11`](https://github.com/mastra-ai/mastra/commit/9cede110abac9d93072e0521bb3c8bcafb9fdadf), [`a59f126`](https://github.com/mastra-ai/mastra/commit/a59f1269104f54726699c5cdb98c72c93606d2df), [`ed8fd75`](https://github.com/mastra-ai/mastra/commit/ed8fd75cbff03bb5e19971ddb30ab7040fc60447), [`c510833`](https://github.com/mastra-ai/mastra/commit/c5108333e8cbc19dafee5f8bfefbcb5ee935335c), [`c4c7dad`](https://github.com/mastra-ai/mastra/commit/c4c7dadfe2e4584f079f6c24bfabdb8c4981827f), [`45c3112`](https://github.com/mastra-ai/mastra/commit/45c31122666a0cc56b94727099fcb1871ed1b3f6), [`7296fcc`](https://github.com/mastra-ai/mastra/commit/7296fcc599c876a68699a71c7054a16d5aaf2337), [`00c27f9`](https://github.com/mastra-ai/mastra/commit/00c27f9080731433230a61be69c44e39a7a7b4c7), [`5e7c287`](https://github.com/mastra-ai/mastra/commit/5e7c28701f2bce795dd5c811e4c3060bf2ea2242), [`7e17d3f`](https://github.com/mastra-ai/mastra/commit/7e17d3f656fdda2aad47c4beb8c491636d70820c), [`ee19c9b`](https://github.com/mastra-ai/mastra/commit/ee19c9ba3ec3ed91feb214ad539bdc766c53bb01)]:
328
+ - @mastra/core@1.12.0
329
+ - @mastra/client-js@1.8.1
330
+
331
+ ## 0.2.11-alpha.1
332
+
333
+ ### Patch Changes
334
+
335
+ - Updated dependencies [[`9cede11`](https://github.com/mastra-ai/mastra/commit/9cede110abac9d93072e0521bb3c8bcafb9fdadf), [`a59f126`](https://github.com/mastra-ai/mastra/commit/a59f1269104f54726699c5cdb98c72c93606d2df), [`c510833`](https://github.com/mastra-ai/mastra/commit/c5108333e8cbc19dafee5f8bfefbcb5ee935335c), [`7296fcc`](https://github.com/mastra-ai/mastra/commit/7296fcc599c876a68699a71c7054a16d5aaf2337), [`00c27f9`](https://github.com/mastra-ai/mastra/commit/00c27f9080731433230a61be69c44e39a7a7b4c7), [`ee19c9b`](https://github.com/mastra-ai/mastra/commit/ee19c9ba3ec3ed91feb214ad539bdc766c53bb01)]:
336
+ - @mastra/core@1.12.0-alpha.1
337
+ - @mastra/client-js@1.8.1-alpha.1
338
+
339
+ ## 0.2.11-alpha.0
340
+
341
+ ### Patch Changes
342
+
343
+ - Updated dependencies [[`cddf895`](https://github.com/mastra-ai/mastra/commit/cddf895532b8ee7f9fa814136ec672f53d37a9ba), [`aede3cc`](https://github.com/mastra-ai/mastra/commit/aede3cc2a83b54bbd9e9a54c8aedcd1708b2ef87), [`c4c7dad`](https://github.com/mastra-ai/mastra/commit/c4c7dadfe2e4584f079f6c24bfabdb8c4981827f), [`45c3112`](https://github.com/mastra-ai/mastra/commit/45c31122666a0cc56b94727099fcb1871ed1b3f6), [`5e7c287`](https://github.com/mastra-ai/mastra/commit/5e7c28701f2bce795dd5c811e4c3060bf2ea2242), [`7e17d3f`](https://github.com/mastra-ai/mastra/commit/7e17d3f656fdda2aad47c4beb8c491636d70820c)]:
344
+ - @mastra/core@1.12.0-alpha.0
345
+ - @mastra/client-js@1.8.1-alpha.0
346
+
347
+ ## 0.2.10
348
+
349
+ ### Patch Changes
350
+
351
+ - dependencies updates: ([#13890](https://github.com/mastra-ai/mastra/pull/13890))
352
+ - Updated dependency [`tailwind-merge@^3.5.0` ↗︎](https://www.npmjs.com/package/tailwind-merge/v/3.5.0) (from `^3.4.1`, in `dependencies`)
353
+
354
+ - Fixed @mastra/react root imports so Vite and other browser builds no longer pull in Node-only @mastra/core code. ([#14079](https://github.com/mastra-ai/mastra/pull/14079))
355
+
356
+ - Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`be60b73`](https://github.com/mastra-ai/mastra/commit/be60b731adad9f2cf3c0732d685561bc140aa827), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
357
+ - @mastra/core@1.11.0
358
+ - @mastra/client-js@1.8.0
359
+
360
+ ## 0.2.10-alpha.2
361
+
362
+ ### Patch Changes
363
+
364
+ - Updated dependencies [[`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed)]:
365
+ - @mastra/core@1.11.0-alpha.2
366
+ - @mastra/client-js@1.8.0-alpha.2
367
+
368
+ ## 0.2.10-alpha.1
369
+
370
+ ### Patch Changes
371
+
372
+ - Updated dependencies [[`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603)]:
373
+ - @mastra/core@1.11.0-alpha.1
374
+ - @mastra/client-js@1.8.0-alpha.1
375
+
376
+ ## 0.2.10-alpha.0
377
+
378
+ ### Patch Changes
379
+
380
+ - dependencies updates: ([#13890](https://github.com/mastra-ai/mastra/pull/13890))
381
+ - Updated dependency [`tailwind-merge@^3.5.0` ↗︎](https://www.npmjs.com/package/tailwind-merge/v/3.5.0) (from `^3.4.1`, in `dependencies`)
382
+
383
+ - Fixed @mastra/react root imports so Vite and other browser builds no longer pull in Node-only @mastra/core code. ([#14079](https://github.com/mastra-ai/mastra/pull/14079))
384
+
385
+ - Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`be60b73`](https://github.com/mastra-ai/mastra/commit/be60b731adad9f2cf3c0732d685561bc140aa827), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
386
+ - @mastra/core@1.11.0-alpha.0
387
+ - @mastra/client-js@1.8.0-alpha.0
388
+
389
+ ## 0.2.9
390
+
391
+ ### Patch Changes
392
+
393
+ - Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`d1e26f0`](https://github.com/mastra-ai/mastra/commit/d1e26f0091ea8685ee7219ea510124f4ed816fea), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
394
+ - @mastra/core@1.10.0
395
+ - @mastra/client-js@1.7.3
396
+
397
+ ## 0.2.9-alpha.0
398
+
399
+ ### Patch Changes
400
+
401
+ - Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`d1e26f0`](https://github.com/mastra-ai/mastra/commit/d1e26f0091ea8685ee7219ea510124f4ed816fea), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
402
+ - @mastra/core@1.10.0-alpha.0
403
+ - @mastra/client-js@1.7.3-alpha.0
404
+
405
+ ## 0.2.8
406
+
407
+ ### Patch Changes
408
+
409
+ - fix(@mastra/react): externalize @mastra/core instead of inlining it into dist ([#13703](https://github.com/mastra-ai/mastra/pull/13703))
410
+
411
+ `rollup-plugin-node-externals` doesn't catch workspace-linked packages (`workspace:*`),
412
+ so `@mastra/core` was being fully bundled into `@mastra/react`'s dist (~900KB). Switched
413
+ from Vite/Rollup to tsup with explicit externalization, and moved `@mastra/core` to
414
+ `peerDependencies` so consumers provide it rather than having it bundled inline.
415
+
416
+ - Fixed `mastra studio --server-port` so requests to local servers (`localhost` and `127.0.0.1`) correctly use local development auth behavior. ([#13492](https://github.com/mastra-ai/mastra/pull/13492))
417
+
418
+ - Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
419
+ - @mastra/core@1.9.0
420
+ - @mastra/client-js@1.7.2
421
+
422
+ ## 0.2.8-alpha.0
423
+
424
+ ### Patch Changes
425
+
426
+ - fix(@mastra/react): externalize @mastra/core instead of inlining it into dist ([#13703](https://github.com/mastra-ai/mastra/pull/13703))
427
+
428
+ `rollup-plugin-node-externals` doesn't catch workspace-linked packages (`workspace:*`),
429
+ so `@mastra/core` was being fully bundled into `@mastra/react`'s dist (~900KB). Switched
430
+ from Vite/Rollup to tsup with explicit externalization, and moved `@mastra/core` to
431
+ `peerDependencies` so consumers provide it rather than having it bundled inline.
432
+
433
+ - Fixed `mastra studio --server-port` so requests to local servers (`localhost` and `127.0.0.1`) correctly use local development auth behavior. ([#13492](https://github.com/mastra-ai/mastra/pull/13492))
434
+
435
+ - Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
436
+ - @mastra/core@1.9.0-alpha.0
437
+ - @mastra/client-js@1.7.2-alpha.0
438
+
439
+ ## 0.2.7
440
+
441
+ ### Patch Changes
442
+
443
+ - Added completionResult to MastraUIMessageMetadata ([#13323](https://github.com/mastra-ai/mastra/pull/13323))
444
+
445
+ - Updated dependencies:
446
+ - @mastra/client-js@1.7.1
447
+
448
+ ## 0.2.7-alpha.0
449
+
450
+ ### Patch Changes
451
+
452
+ - Added completionResult to MastraUIMessageMetadata ([#13323](https://github.com/mastra-ai/mastra/pull/13323))
453
+
454
+ - Updated dependencies:
455
+ - @mastra/client-js@1.7.1-alpha.0
456
+
457
+ ## 0.2.6
458
+
459
+ ### Patch Changes
460
+
461
+ - Updated dependencies [[`2b40831`](https://github.com/mastra-ai/mastra/commit/2b40831dcca2275c9570ddf09b7f25ba3e8dc7fc)]:
462
+ - @mastra/client-js@1.7.0
463
+
464
+ ## 0.2.6-alpha.0
465
+
466
+ ### Patch Changes
467
+
468
+ - Updated dependencies [[`2b40831`](https://github.com/mastra-ai/mastra/commit/2b40831dcca2275c9570ddf09b7f25ba3e8dc7fc)]:
469
+ - @mastra/client-js@1.7.0-alpha.0
470
+
471
+ ## 0.2.5
472
+
473
+ ### Patch Changes
474
+
475
+ - dependencies updates: ([#13308](https://github.com/mastra-ai/mastra/pull/13308))
476
+ - Updated dependency [`tailwind-merge@^3.4.1` ↗︎](https://www.npmjs.com/package/tailwind-merge/v/3.4.1) (from `^3.3.1`, in `dependencies`)
477
+ - Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`3f8f1b3`](https://github.com/mastra-ai/mastra/commit/3f8f1b31146d2a8316157171962ad825628aa251)]:
478
+ - @mastra/client-js@1.6.0
479
+
480
+ ## 0.2.5-alpha.0
481
+
482
+ ### Patch Changes
483
+
484
+ - dependencies updates: ([#13308](https://github.com/mastra-ai/mastra/pull/13308))
485
+ - Updated dependency [`tailwind-merge@^3.4.1` ↗︎](https://www.npmjs.com/package/tailwind-merge/v/3.4.1) (from `^3.3.1`, in `dependencies`)
486
+ - Updated dependencies [[`0d9efb4`](https://github.com/mastra-ai/mastra/commit/0d9efb47992c34aa90581c18b9f51f774f6252a5), [`3f8f1b3`](https://github.com/mastra-ai/mastra/commit/3f8f1b31146d2a8316157171962ad825628aa251)]:
487
+ - @mastra/client-js@1.6.0-alpha.0
488
+
489
+ ## 0.2.4
490
+
491
+ ### Patch Changes
492
+
493
+ - Added generic Harness class to @mastra/core for orchestrating agents with modes, state management, built-in tools (ask_user, submit_plan), subagent support, Observational Memory integration, model discovery, and permission-aware tool approval. The Harness provides a reusable foundation for building agent-powered applications with features like thread management, heartbeat monitoring, and event-driven architecture. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
494
+
495
+ - Fixed tool error results displaying as "[object Object]" during streaming in the chat UI. Error messages are now properly extracted and displayed. ([#13242](https://github.com/mastra-ai/mastra/pull/13242))
496
+
497
+ - Migrated MastraCode from the prototype harness to the generic CoreHarness from @mastra/core. The createMastraCode function is now fully configurable with optional parameters for modes, subagents, storage, tools, and more. Removed the deprecated prototype harness implementation. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
498
+
499
+ - Updated dependencies [[`55a0ab1`](https://github.com/mastra-ai/mastra/commit/55a0ab13187b3c656247a1d9bfa715077af6e422), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`55a0ab1`](https://github.com/mastra-ai/mastra/commit/55a0ab13187b3c656247a1d9bfa715077af6e422), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9)]:
500
+ - @mastra/client-js@1.5.0
501
+
502
+ ## 0.2.4-alpha.1
503
+
504
+ ### Patch Changes
505
+
506
+ - Updated dependencies:
507
+ - @mastra/client-js@1.5.0-alpha.1
508
+
509
+ ## 0.2.4-alpha.0
510
+
511
+ ### Patch Changes
512
+
513
+ - Added generic Harness class to @mastra/core for orchestrating agents with modes, state management, built-in tools (ask_user, submit_plan), subagent support, Observational Memory integration, model discovery, and permission-aware tool approval. The Harness provides a reusable foundation for building agent-powered applications with features like thread management, heartbeat monitoring, and event-driven architecture. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
514
+
515
+ - Fixed tool error results displaying as "[object Object]" during streaming in the chat UI. Error messages are now properly extracted and displayed. ([#13242](https://github.com/mastra-ai/mastra/pull/13242))
516
+
517
+ - Migrated MastraCode from the prototype harness to the generic CoreHarness from @mastra/core. The createMastraCode function is now fully configurable with optional parameters for modes, subagents, storage, tools, and more. Removed the deprecated prototype harness implementation. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
518
+
519
+ - Updated dependencies [[`55a0ab1`](https://github.com/mastra-ai/mastra/commit/55a0ab13187b3c656247a1d9bfa715077af6e422), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`55a0ab1`](https://github.com/mastra-ai/mastra/commit/55a0ab13187b3c656247a1d9bfa715077af6e422), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9)]:
520
+ - @mastra/client-js@1.5.0-alpha.0
521
+
522
+ ## 0.2.3
523
+
524
+ ### Patch Changes
525
+
526
+ - Add `workflow-step-progress` stream event for foreach workflow steps. Each iteration emits a progress event with `completedCount`, `totalCount`, `currentIndex`, `iterationStatus` (`success` | `failed` | `suspended`), and optional `iterationOutput`. Both the default and evented execution engines emit these events. ([#12838](https://github.com/mastra-ai/mastra/pull/12838))
527
+
528
+ The Mastra Studio UI now renders a progress bar with an N/total counter on foreach nodes, updating in real time as iterations complete:
529
+
530
+ ```ts
531
+ // Consuming progress events from the workflow stream
532
+ const run = workflow.createRun();
533
+ const result = await run.start({ inputData });
534
+ const stream = result.stream;
535
+
536
+ for await (const chunk of stream) {
537
+ if (chunk.type === 'workflow-step-progress') {
538
+ console.log(`${chunk.payload.completedCount}/${chunk.payload.totalCount} - ${chunk.payload.iterationStatus}`);
539
+ }
540
+ }
541
+ ```
542
+
543
+ `@mastra/react`: The `mapWorkflowStreamChunkToWatchResult` reducer now accumulates `foreachProgress` from `workflow-step-progress` events into step state, making progress data available to React consumers via the existing workflow watch hooks.
544
+
545
+ - Updated dependencies [[`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`3da8a73`](https://github.com/mastra-ai/mastra/commit/3da8a73c9b9f042d528975ca330babc99563bd12), [`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`4ba40dc`](https://github.com/mastra-ai/mastra/commit/4ba40dcb6c9ef31eedbb01b6d5b8b0b3c71e5b61), [`a5b67a3`](https://github.com/mastra-ai/mastra/commit/a5b67a3589a74415feb663a55d1858324a2afde9), [`877b02c`](https://github.com/mastra-ai/mastra/commit/877b02cdbb15e199184c7f2b8f217be8d3ebada7), [`40f224e`](https://github.com/mastra-ai/mastra/commit/40f224ec14e9b01a36802d8c5445a547a33992a5)]:
546
+ - @mastra/client-js@1.4.0
547
+
548
+ ## 0.2.3-alpha.0
549
+
550
+ ### Patch Changes
551
+
552
+ - Add `workflow-step-progress` stream event for foreach workflow steps. Each iteration emits a progress event with `completedCount`, `totalCount`, `currentIndex`, `iterationStatus` (`success` | `failed` | `suspended`), and optional `iterationOutput`. Both the default and evented execution engines emit these events. ([#12838](https://github.com/mastra-ai/mastra/pull/12838))
553
+
554
+ The Mastra Studio UI now renders a progress bar with an N/total counter on foreach nodes, updating in real time as iterations complete:
555
+
556
+ ```ts
557
+ // Consuming progress events from the workflow stream
558
+ const run = workflow.createRun();
559
+ const result = await run.start({ inputData });
560
+ const stream = result.stream;
561
+
562
+ for await (const chunk of stream) {
563
+ if (chunk.type === 'workflow-step-progress') {
564
+ console.log(`${chunk.payload.completedCount}/${chunk.payload.totalCount} - ${chunk.payload.iterationStatus}`);
565
+ }
566
+ }
567
+ ```
568
+
569
+ `@mastra/react`: The `mapWorkflowStreamChunkToWatchResult` reducer now accumulates `foreachProgress` from `workflow-step-progress` events into step state, making progress data available to React consumers via the existing workflow watch hooks.
570
+
571
+ - Updated dependencies [[`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`3da8a73`](https://github.com/mastra-ai/mastra/commit/3da8a73c9b9f042d528975ca330babc99563bd12), [`927c2af`](https://github.com/mastra-ai/mastra/commit/927c2af9792286c122e04409efce0f3c804f777f), [`4ba40dc`](https://github.com/mastra-ai/mastra/commit/4ba40dcb6c9ef31eedbb01b6d5b8b0b3c71e5b61), [`a5b67a3`](https://github.com/mastra-ai/mastra/commit/a5b67a3589a74415feb663a55d1858324a2afde9), [`877b02c`](https://github.com/mastra-ai/mastra/commit/877b02cdbb15e199184c7f2b8f217be8d3ebada7), [`40f224e`](https://github.com/mastra-ai/mastra/commit/40f224ec14e9b01a36802d8c5445a547a33992a5)]:
572
+ - @mastra/client-js@1.4.0-alpha.0
573
+
574
+ ## 0.2.2
575
+
576
+ ### Patch Changes
577
+
578
+ - Fixed chat messages flashing when loading a thread. Messages now update reactively via useEffect instead of lazy state initialization, preventing the brief flash of empty state. ([#12863](https://github.com/mastra-ai/mastra/pull/12863))
579
+
580
+ - Updated dependencies [[`6c40593`](https://github.com/mastra-ai/mastra/commit/6c40593d6d2b1b68b0c45d1a3a4c6ac5ecac3937), [`11804ad`](https://github.com/mastra-ai/mastra/commit/11804adf1d6be46ebe216be40a43b39bb8b397d7), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`2e02cd7`](https://github.com/mastra-ai/mastra/commit/2e02cd7e08ba2d84a275c80d80c069d2b8b66211), [`8109aee`](https://github.com/mastra-ai/mastra/commit/8109aeeab758e16cd4255a6c36f044b70eefc6a6), [`be42958`](https://github.com/mastra-ai/mastra/commit/be42958d62c9f3d6b3a037580a6ef362afa47240), [`a211248`](https://github.com/mastra-ai/mastra/commit/a21124845b1b1321b6075a8377c341c7f5cda1b6), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`8c90ff4`](https://github.com/mastra-ai/mastra/commit/8c90ff4d3414e7f2a2d216ea91274644f7b29133)]:
581
+ - @mastra/client-js@1.3.0
582
+
583
+ ## 0.2.2-alpha.3
584
+
585
+ ### Patch Changes
586
+
587
+ - Updated dependencies [[`2e02cd7`](https://github.com/mastra-ai/mastra/commit/2e02cd7e08ba2d84a275c80d80c069d2b8b66211)]:
588
+ - @mastra/client-js@1.3.0-alpha.3
589
+
590
+ ## 0.2.2-alpha.2
591
+
592
+ ### Patch Changes
593
+
594
+ - Updated dependencies [[`b31c922`](https://github.com/mastra-ai/mastra/commit/b31c922215b513791d98feaea1b98784aa00803a)]:
595
+ - @mastra/client-js@1.3.0-alpha.2
596
+
597
+ ## 0.2.2-alpha.1
598
+
599
+ ### Patch Changes
600
+
601
+ - Fixed chat messages flashing when loading a thread. Messages now update reactively via useEffect instead of lazy state initialization, preventing the brief flash of empty state. ([#12863](https://github.com/mastra-ai/mastra/pull/12863))
602
+
603
+ - Updated dependencies [[`6c40593`](https://github.com/mastra-ai/mastra/commit/6c40593d6d2b1b68b0c45d1a3a4c6ac5ecac3937), [`11804ad`](https://github.com/mastra-ai/mastra/commit/11804adf1d6be46ebe216be40a43b39bb8b397d7), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`be42958`](https://github.com/mastra-ai/mastra/commit/be42958d62c9f3d6b3a037580a6ef362afa47240), [`a211248`](https://github.com/mastra-ai/mastra/commit/a21124845b1b1321b6075a8377c341c7f5cda1b6), [`047635c`](https://github.com/mastra-ai/mastra/commit/047635ccd7861d726c62d135560c0022a5490aec), [`8c90ff4`](https://github.com/mastra-ai/mastra/commit/8c90ff4d3414e7f2a2d216ea91274644f7b29133)]:
604
+ - @mastra/client-js@1.3.0-alpha.1
605
+
606
+ ## 0.2.2-alpha.0
607
+
608
+ ### Patch Changes
609
+
610
+ - Updated dependencies [[`8109aee`](https://github.com/mastra-ai/mastra/commit/8109aeeab758e16cd4255a6c36f044b70eefc6a6)]:
611
+ - @mastra/client-js@1.2.1-alpha.0
612
+
613
+ ## 0.2.1
614
+
615
+ ### Patch Changes
616
+
617
+ - Updated dependencies [[`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0), [`aa37c84`](https://github.com/mastra-ai/mastra/commit/aa37c84d29b7db68c72517337932ef486c316275)]:
618
+ - @mastra/client-js@1.2.0
619
+
620
+ ## 0.2.1-alpha.1
621
+
622
+ ### Patch Changes
623
+
624
+ - Updated dependencies [[`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0)]:
625
+ - @mastra/client-js@1.2.0-alpha.1
626
+
627
+ ## 0.2.1-alpha.0
628
+
629
+ ### Patch Changes
630
+
631
+ - Updated dependencies [[`aa37c84`](https://github.com/mastra-ai/mastra/commit/aa37c84d29b7db68c72517337932ef486c316275)]:
632
+ - @mastra/client-js@1.1.1-alpha.0
633
+
634
+ ## 0.2.0
635
+
636
+ ### Minor Changes
637
+
638
+ - Added `apiPrefix` prop to `MastraClientProvider` for connecting to servers with custom API route prefixes (defaults to `/api`). ([#12295](https://github.com/mastra-ai/mastra/pull/12295))
639
+
640
+ **Default usage (no change required):**
641
+
642
+ ```tsx
643
+ <MastraClientProvider baseUrl="http://localhost:3000">{children}</MastraClientProvider>
644
+ ```
645
+
646
+ **Custom prefix usage:**
647
+
648
+ ```tsx
649
+ <MastraClientProvider baseUrl="http://localhost:3000" apiPrefix="/mastra">
650
+ {children}
651
+ </MastraClientProvider>
652
+ ```
653
+
654
+ See #12261 for more details.
655
+
656
+ - Added useCancelWorkflowRun hook to @mastra/react for canceling workflow runs. This hook was previously only available internally in playground-ui and is now exported for use in custom applications. ([#12142](https://github.com/mastra-ai/mastra/pull/12142))
657
+
658
+ - Added useStreamWorkflow hook to @mastra/react for streaming workflow execution. This hook supports streaming, observing, resuming, and time-traveling workflows. It accepts tracingOptions and onError as parameters for better customization. ([#12151](https://github.com/mastra-ai/mastra/pull/12151))
659
+
660
+ ### Patch Changes
661
+
662
+ - Use useExecuteWorkflow hook from @mastra/react instead of local implementation in playground-ui ([#12138](https://github.com/mastra-ai/mastra/pull/12138))
663
+
664
+ - Updated dependencies [[`deea43e`](https://github.com/mastra-ai/mastra/commit/deea43eb1366d03a864c5e597d16a48592b9893f), [`60d9d89`](https://github.com/mastra-ai/mastra/commit/60d9d899e44b35bc43f1bcd967a74e0ce010b1af), [`0350626`](https://github.com/mastra-ai/mastra/commit/03506267ec41b67add80d994c0c0fcce93bbc75f), [`3efbe5a`](https://github.com/mastra-ai/mastra/commit/3efbe5ae20864c4f3143457f4f3ee7dc2fa5ca76), [`dc82e6c`](https://github.com/mastra-ai/mastra/commit/dc82e6c5a05d6a9160c522af08b8c809ddbcdb66), [`a64a24c`](https://github.com/mastra-ai/mastra/commit/a64a24c9bce499b989667c7963f2f71a11d90334), [`a64a24c`](https://github.com/mastra-ai/mastra/commit/a64a24c9bce499b989667c7963f2f71a11d90334)]:
665
+ - @mastra/client-js@1.1.0
666
+
667
+ ## 0.2.0-alpha.2
668
+
669
+ ### Patch Changes
670
+
671
+ - Updated dependencies [[`a64a24c`](https://github.com/mastra-ai/mastra/commit/a64a24c9bce499b989667c7963f2f71a11d90334), [`a64a24c`](https://github.com/mastra-ai/mastra/commit/a64a24c9bce499b989667c7963f2f71a11d90334)]:
672
+ - @mastra/client-js@1.1.0-alpha.2
673
+
674
+ ## 0.2.0-alpha.1
675
+
676
+ ### Patch Changes
677
+
678
+ - Updated dependencies [[`deea43e`](https://github.com/mastra-ai/mastra/commit/deea43eb1366d03a864c5e597d16a48592b9893f)]:
679
+ - @mastra/client-js@1.1.0-alpha.1
680
+
681
+ ## 0.2.0-alpha.0
682
+
683
+ ### Minor Changes
684
+
685
+ - Added `apiPrefix` prop to `MastraClientProvider` for connecting to servers with custom API route prefixes (defaults to `/api`). ([#12295](https://github.com/mastra-ai/mastra/pull/12295))
686
+
687
+ **Default usage (no change required):**
688
+
689
+ ```tsx
690
+ <MastraClientProvider baseUrl="http://localhost:3000">{children}</MastraClientProvider>
691
+ ```
692
+
693
+ **Custom prefix usage:**
694
+
695
+ ```tsx
696
+ <MastraClientProvider baseUrl="http://localhost:3000" apiPrefix="/mastra">
697
+ {children}
698
+ </MastraClientProvider>
699
+ ```
700
+
701
+ See #12261 for more details.
702
+
703
+ - Added useCancelWorkflowRun hook to @mastra/react for canceling workflow runs. This hook was previously only available internally in playground-ui and is now exported for use in custom applications. ([#12142](https://github.com/mastra-ai/mastra/pull/12142))
704
+
705
+ - Added useStreamWorkflow hook to @mastra/react for streaming workflow execution. This hook supports streaming, observing, resuming, and time-traveling workflows. It accepts tracingOptions and onError as parameters for better customization. ([#12151](https://github.com/mastra-ai/mastra/pull/12151))
706
+
707
+ ### Patch Changes
708
+
709
+ - Use useExecuteWorkflow hook from @mastra/react instead of local implementation in playground-ui ([#12138](https://github.com/mastra-ai/mastra/pull/12138))
710
+
711
+ - Updated dependencies [[`60d9d89`](https://github.com/mastra-ai/mastra/commit/60d9d899e44b35bc43f1bcd967a74e0ce010b1af), [`0350626`](https://github.com/mastra-ai/mastra/commit/03506267ec41b67add80d994c0c0fcce93bbc75f), [`3efbe5a`](https://github.com/mastra-ai/mastra/commit/3efbe5ae20864c4f3143457f4f3ee7dc2fa5ca76), [`dc82e6c`](https://github.com/mastra-ai/mastra/commit/dc82e6c5a05d6a9160c522af08b8c809ddbcdb66)]:
712
+ - @mastra/client-js@1.1.0-alpha.0
713
+
714
+ ## 0.1.1
715
+
716
+ ### Patch Changes
717
+
718
+ - Updated dependencies:
719
+ - @mastra/client-js@1.0.1
720
+
721
+ ## 0.1.1-alpha.0
722
+
723
+ ### Patch Changes
724
+
725
+ - Updated dependencies:
726
+ - @mastra/client-js@1.0.1-alpha.0
727
+
728
+ ## 0.1.0
729
+
730
+ ### Minor Changes
731
+
732
+ - Added human-in-the-loop (HITL) tool approval support for `generate()` method. ([#12056](https://github.com/mastra-ai/mastra/pull/12056))
733
+
734
+ **Why:** This provides parity between `stream()` and `generate()` for tool approval flows, allowing non-streaming use cases to leverage `requireToolApproval` without needing to switch to streaming.
735
+
736
+ Previously, tool approval with `requireToolApproval` only worked with `stream()`. Now you can use the same approval flow with `generate()` for non-streaming use cases.
737
+
738
+ **Using tool approval with generate()**
739
+
740
+ ```typescript
741
+ const output = await agent.generate('Find user John', {
742
+ requireToolApproval: true,
743
+ });
744
+
745
+ // Check if a tool is waiting for approval
746
+ if (output.finishReason === 'suspended') {
747
+ console.log('Tool requires approval:', output.suspendPayload.toolName);
748
+
749
+ // Approve the tool call
750
+ const result = await agent.approveToolCallGenerate({
751
+ runId: output.runId,
752
+ toolCallId: output.suspendPayload.toolCallId,
753
+ });
754
+
755
+ console.log(result.text);
756
+ }
757
+ ```
758
+
759
+ **Declining a tool call**
760
+
761
+ ```typescript
762
+ if (output.finishReason === 'suspended') {
763
+ const result = await agent.declineToolCallGenerate({
764
+ runId: output.runId,
765
+ toolCallId: output.suspendPayload.toolCallId,
766
+ });
767
+ }
768
+ ```
769
+
770
+ **New methods added:**
771
+ - `agent.approveToolCallGenerate({ runId, toolCallId })` - Approves a pending tool call and returns the complete result
772
+ - `agent.declineToolCallGenerate({ runId, toolCallId })` - Declines a pending tool call and returns the complete result
773
+
774
+ **Server routes added:**
775
+ - `POST /api/agents/:agentId/approve-tool-call-generate`
776
+ - `POST /api/agents/:agentId/decline-tool-call-generate`
777
+
778
+ The playground UI now also supports tool approval when using generate mode.
779
+
780
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
781
+
782
+ - **Fixed:** Align `Agent.network` with core and update `@mastra/react` network usage. ([#12015](https://github.com/mastra-ai/mastra/pull/12015))
783
+
784
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
785
+
786
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
787
+
788
+ ## What changed
789
+
790
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
791
+
792
+ **Before:**
793
+
794
+ ```typescript
795
+ // Old span structure
796
+ span.agentId; // 'my-agent'
797
+ span.toolId; // undefined
798
+ span.workflowId; // undefined
799
+ ```
800
+
801
+ **After:**
802
+
803
+ ```typescript
804
+ // New span structure
805
+ span.entityType; // EntityType.AGENT
806
+ span.entityId; // 'my-agent'
807
+ span.entityName; // 'My Agent'
808
+ ```
809
+
810
+ ## New `listTraces()` API
811
+
812
+ Query traces with filtering, pagination, and sorting:
813
+
814
+ ```typescript
815
+ const { spans, pagination } = await storage.listTraces({
816
+ filters: {
817
+ entityType: EntityType.AGENT,
818
+ entityId: 'my-agent',
819
+ userId: 'user-123',
820
+ environment: 'production',
821
+ status: TraceStatus.SUCCESS,
822
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
823
+ },
824
+ pagination: { page: 0, perPage: 50 },
825
+ orderBy: { field: 'startedAt', direction: 'DESC' },
826
+ });
827
+ ```
828
+
829
+ **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`.
830
+
831
+ ## New retrieval methods
832
+ - `getSpan({ traceId, spanId })` - Get a single span
833
+ - `getRootSpan({ traceId })` - Get the root span of a trace
834
+ - `getTrace({ traceId })` - Get all spans for a trace
835
+
836
+ ## Backward compatibility
837
+
838
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
839
+
840
+ ## Migration
841
+
842
+ **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`.
843
+
844
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
845
+
846
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
847
+ 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
848
+
849
+ - Fix "MessagePartRuntime is not available" error when chatting with agents in Studio playground by replacing deprecated `useMessagePart` hook with `useAssistantState` ([#11039](https://github.com/mastra-ai/mastra/pull/11039))
850
+
851
+ ### Patch Changes
852
+
853
+ - Remove redundant toolCalls from network agent finalResult ([#11189](https://github.com/mastra-ai/mastra/pull/11189))
854
+
855
+ The network agent's `finalResult` was storing `toolCalls` separately even though all tool call information is already present in the `messages` array (as `tool-call` and `tool-result` type messages). This caused significant token waste since the routing agent reads this data from memory on every iteration.
856
+
857
+ **Before:** `finalResult: { text, toolCalls, messages }`
858
+ **After:** `finalResult: { text, messages }`
859
+
860
+ +**Migration:** If you were accessing `finalResult.toolCalls`, retrieve tool calls from `finalResult.messages` by filtering for messages with `type: 'tool-call'`.
861
+
862
+ Updated `@mastra/react` to extract tool calls directly from the `messages` array instead of the removed `toolCalls` field when resolving initial messages from memory.
863
+
864
+ Fixes #11059
865
+
866
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
867
+
868
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
869
+
870
+ ```typescript
871
+ const agent = new Agent({
872
+ //...agent information,
873
+ defaultAgentOptions: {
874
+ autoResumeSuspendedTools: true,
875
+ },
876
+ });
877
+ ```
878
+
879
+ - Removes the deprecated `threadId` and `resourceId` options from `AgentExecutionOptions`. These have been deprecated for months in favour of the `memory` option. ([#11897](https://github.com/mastra-ai/mastra/pull/11897))
880
+
881
+ ### Breaking Changes
882
+
883
+ #### `@mastra/core`
884
+
885
+ The `threadId` and `resourceId` options have been removed from `agent.generate()` and `agent.stream()`. Use the `memory` option instead:
886
+
887
+ ```ts
888
+ // Before
889
+ await agent.stream('Hello', {
890
+ threadId: 'thread-123',
891
+ resourceId: 'user-456',
892
+ });
893
+
894
+ // After
895
+ await agent.stream('Hello', {
896
+ memory: {
897
+ thread: 'thread-123',
898
+ resource: 'user-456',
899
+ },
900
+ });
901
+ ```
902
+
903
+ #### `@mastra/server`
904
+
905
+ The `threadId`, `resourceId`, and `resourceid` fields have been removed from the main agent execution body schema. The server now expects the `memory` option format in request bodies. Legacy routes (`/api/agents/:agentId/generate-legacy` and `/api/agents/:agentId/stream-legacy`) continue to support the deprecated fields.
906
+
907
+ #### `@mastra/react`
908
+
909
+ The `useChat` hook now internally converts `threadId` to the `memory` option format when making API calls. No changes needed in component code - the hook handles the conversion automatically.
910
+
911
+ #### `@mastra/client-js`
912
+
913
+ When using the client SDK agent methods, use the `memory` option instead of `threadId`/`resourceId`:
914
+
915
+ ```ts
916
+ const agent = client.getAgent('my-agent');
917
+
918
+ // Before
919
+ await agent.generate([...], {
920
+ threadId: 'thread-123',
921
+ resourceId: 'user-456',
922
+ });
923
+
924
+ // After
925
+ await agent.generate([...], {
926
+ memory: {
927
+ thread: 'thread-123',
928
+ resource: 'user-456',
929
+ },
930
+ });
931
+ ```
932
+
933
+ - Adjust the types to accept tracingOptions ([#10742](https://github.com/mastra-ai/mastra/pull/10742))
934
+
935
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
936
+ - Add suspend/resume capabilities to agent network
937
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
938
+
939
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
940
+
941
+ - Fix TypeScript errors during build declaration generation ([#11682](https://github.com/mastra-ai/mastra/pull/11682))
942
+
943
+ Updated test file `toUIMessage.test.ts` to match current `@mastra/core` types:
944
+ - Changed `error` property from string to `Error` object (per `StepFailure` type)
945
+ - Added missing `resumeSchema` property to `tool-call-approval` payloads (per `ToolCallApprovalPayload` type)
946
+ - Added `zod` as peer/dev dependency for test type support
947
+
948
+ - Fix text parts incorrectly merging across tool calls ([#11783](https://github.com/mastra-ai/mastra/pull/11783))
949
+
950
+ Previously, when an agent produced text before and after a tool call (e.g., "Let me search for that" → tool call → "Here's what I found"), the text parts would be merged into a single part, losing the separation. This fix introduces a `textId` property to track separate text streams, ensuring each text stream maintains its own text part in the UI message.
951
+
952
+ Fixes #11577
953
+
954
+ - Configurable resourceId in react useChat ([#10461](https://github.com/mastra-ai/mastra/pull/10461))
955
+
956
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
957
+
958
+ - Fixes issues where thread and messages were not saved before suspension when tools require approval or call suspend() during execution. This caused conversation history to be lost if users refreshed during tool approval or suspension. ([#10369](https://github.com/mastra-ai/mastra/pull/10369))
959
+
960
+ **Backend changes (@mastra/core):**
961
+ - Add assistant messages to messageList immediately after LLM execution
962
+ - Flush messages synchronously before suspension to persist state
963
+ - Create thread if it doesn't exist before flushing
964
+ - Add metadata helpers to persist and remove tool approval state
965
+ - Pass saveQueueManager and memory context through workflow for immediate persistence
966
+
967
+ **Frontend changes (@mastra/react):**
968
+ - Extract runId from pending approvals to enable resumption after refresh
969
+ - Convert `pendingToolApprovals` (DB format) to `requireApprovalMetadata` (runtime format)
970
+ - Handle both `dynamic-tool` and `tool-{NAME}` part types for approval state
971
+ - Change runId from hardcoded `agentId` to unique `uuid()`
972
+
973
+ **UI changes (@mastra/playground-ui):**
974
+ - Handle tool calls awaiting approval in message initialization
975
+ - Convert approval metadata format when loading initial messages
976
+
977
+ Fixes #9745, #9906
978
+
979
+ - Fixed compatibility with updated `@mastra/client-js` generate and stream API signatures ([#12011](https://github.com/mastra-ai/mastra/pull/12011))
980
+
981
+ - Fixed agent network not returning text response when routing agent handles requests without delegation. ([#11497](https://github.com/mastra-ai/mastra/pull/11497))
982
+
983
+ **What changed:**
984
+ - Agent networks now correctly stream text responses when the routing agent decides to handle a request itself instead of delegating to sub-agents, workflows, or tools
985
+ - Added fallback in transformers to ensure text is always returned even if core events are missing
986
+
987
+ **Why this matters:**
988
+ Previously, when using `toAISdkV5Stream` or `networkRoute()` outside of the Mastra Studio UI, no text content was returned when the routing agent handled requests directly. This fix ensures consistent behavior across all API routes.
989
+
990
+ Fixes #11219
991
+
992
+ - Fix multi modal in react sdk ([#9373](https://github.com/mastra-ai/mastra/pull/9373))
993
+
994
+ - Display network completion validation results and scorer feedback in the Playground when viewing agent network runs, letting users see pass/fail status and actionable feedback from completion scorers ([#11562](https://github.com/mastra-ai/mastra/pull/11562))
995
+
996
+ - Support new Workflow tripwire run status. Tripwires that are thrown from within a workflow will now bubble up and return a graceful state with information about tripwires. ([#10947](https://github.com/mastra-ai/mastra/pull/10947))
997
+
998
+ When a workflow contains an agent step that triggers a tripwire, the workflow returns with `status: 'tripwire'` and includes tripwire details:
999
+
1000
+ ```typescript
1001
+ const run = await workflow.createRun();
1002
+ const result = await run.start({ inputData: { message: 'Hello' } });
1003
+
1004
+ if (result.status === 'tripwire') {
1005
+ console.log('Workflow terminated by tripwire:', result.tripwire?.reason);
1006
+ console.log('Processor ID:', result.tripwire?.processorId);
1007
+ console.log('Retry requested:', result.tripwire?.retry);
1008
+ }
1009
+ ```
1010
+
1011
+ Adds new UI state for tripwire in agent chat and workflow UI.
1012
+
1013
+ This is distinct from `status: 'failed'` which indicates an unexpected error. A tripwire status means a processor intentionally stopped execution (e.g., for content moderation).
1014
+
1015
+ - - Add persistence for custom data chunks (`data-*` parts) emitted via `writer.custom()` in tools ([#10884](https://github.com/mastra-ai/mastra/pull/10884))
1016
+ - Data chunks are now saved to message storage so they survive page refreshes
1017
+ - Update `@assistant-ui/react` to v0.11.47 with native `DataMessagePart` support
1018
+ - Convert `data-*` parts to `DataMessagePart` format (`{ type: 'data', name: string, data: T }`)
1019
+ - Update related `@assistant-ui/*` packages for compatibility
1020
+ - Updated dependencies [[`6edf340`](https://github.com/mastra-ai/mastra/commit/6edf3402f6a46ee8def2f42a2287785251fbffd6), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`ed3e3dd`](https://github.com/mastra-ai/mastra/commit/ed3e3ddec69d564fe2b125e083437f76331f1283), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`3852192`](https://github.com/mastra-ai/mastra/commit/3852192c81b2a4f1f883f17d80ce50e0c60dba55), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`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), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`ad7e8f1`](https://github.com/mastra-ai/mastra/commit/ad7e8f16ac843cbd16687ad47b66ba96bcffe111), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`e1b7118`](https://github.com/mastra-ai/mastra/commit/e1b7118f42ca0a97247afc75e57dcd5fdf987752), [`461e448`](https://github.com/mastra-ai/mastra/commit/461e448852fe999506a6046d50b1efc27d8aa378), [`441c7b6`](https://github.com/mastra-ai/mastra/commit/441c7b6665915cfa7fd625fded8c0f518530bf10), [`b7de533`](https://github.com/mastra-ai/mastra/commit/b7de53361667eb51fefd89fcaed924f3c57cee8d), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`1b85674`](https://github.com/mastra-ai/mastra/commit/1b85674123708d9b85834dccc9eae601a9d0891c), [`5a1ede1`](https://github.com/mastra-ai/mastra/commit/5a1ede1f7ab527b9ead11f7eee2f73e67aeca9e4), [`47b1c16`](https://github.com/mastra-ai/mastra/commit/47b1c16a01c7ffb6765fe1e499b49092f8b7eba3), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`1ee3411`](https://github.com/mastra-ai/mastra/commit/1ee34113192b11aa8bcdd8d9d5830ae13254b345), [`dbd9db0`](https://github.com/mastra-ai/mastra/commit/dbd9db0d5c2797a210b9098e7e3e613718e5442f), [`6a86fe5`](https://github.com/mastra-ai/mastra/commit/6a86fe56b8ff53ca2eb3ed87ffc0748749ebadce), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`f93d992`](https://github.com/mastra-ai/mastra/commit/f93d992a37d5431ab4a71246835d403ef7c4ce85), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`595a3b8`](https://github.com/mastra-ai/mastra/commit/595a3b8727c901f44e333909c09843c711224440), [`ea0b8de`](https://github.com/mastra-ai/mastra/commit/ea0b8dec0d4bc86a72a7e75b2f56c6017c58786d), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`632fdb8`](https://github.com/mastra-ai/mastra/commit/632fdb8b3cd9ff6f90399256d526db439fc1758b), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`519d9e6`](https://github.com/mastra-ai/mastra/commit/519d9e6d31910457c54bdae8b7b7cb3a69f41831), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`5fe71bc`](https://github.com/mastra-ai/mastra/commit/5fe71bc925dfce597df69c89241f33b378028c63), [`dfe3f8c`](https://github.com/mastra-ai/mastra/commit/dfe3f8c7376ffe159236819e19ca522143c1f972), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`e8dcd71`](https://github.com/mastra-ai/mastra/commit/e8dcd71fa5e473c8ba1d6dad99eef182d20a0491), [`e849603`](https://github.com/mastra-ai/mastra/commit/e849603a596269069f58a438b98449ea2770493d), [`63f2f18`](https://github.com/mastra-ai/mastra/commit/63f2f1863dffe3ad23221d0660ed4e4f2b81789d), [`c23200d`](https://github.com/mastra-ai/mastra/commit/c23200ddfd60830effb39329674ba4ca93be6aac), [`9312dcd`](https://github.com/mastra-ai/mastra/commit/9312dcd1c6f5b321929e7d382e763d95fdc030f5), [`184f01d`](https://github.com/mastra-ai/mastra/commit/184f01d1f534ec0be9703d3996f2e088b4a560eb), [`363284b`](https://github.com/mastra-ai/mastra/commit/363284bb974e850f06f40f89a28c79d9f432d7e4), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`439eaf7`](https://github.com/mastra-ai/mastra/commit/439eaf75447809b05e326666675a4dcbf9c334ce), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`3bf6c5f`](https://github.com/mastra-ai/mastra/commit/3bf6c5f104c25226cd84e0c77f9dec15f2cac2db), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`6cbb549`](https://github.com/mastra-ai/mastra/commit/6cbb549475201a2fbf158f0fd7323f6495f46d08), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`106c960`](https://github.com/mastra-ai/mastra/commit/106c960df5d110ec15ac8f45de8858597fb90ad5)]:
1021
+ - @mastra/client-js@1.0.0
1022
+
1023
+ ## 0.1.0-beta.27
1024
+
1025
+ ### Patch Changes
1026
+
1027
+ - Updated dependencies:
1028
+ - @mastra/client-js@1.0.0-beta.27
1029
+
1030
+ ## 0.1.0-beta.26
1031
+
1032
+ ### Patch Changes
1033
+
1034
+ - Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac)]:
1035
+ - @mastra/client-js@1.0.0-beta.26
1036
+
1037
+ ## 0.1.0-beta.25
1038
+
1039
+ ### Minor Changes
1040
+
1041
+ - Added human-in-the-loop (HITL) tool approval support for `generate()` method. ([#12056](https://github.com/mastra-ai/mastra/pull/12056))
1042
+
1043
+ **Why:** This provides parity between `stream()` and `generate()` for tool approval flows, allowing non-streaming use cases to leverage `requireToolApproval` without needing to switch to streaming.
1044
+
1045
+ Previously, tool approval with `requireToolApproval` only worked with `stream()`. Now you can use the same approval flow with `generate()` for non-streaming use cases.
1046
+
1047
+ **Using tool approval with generate()**
1048
+
1049
+ ```typescript
1050
+ const output = await agent.generate('Find user John', {
1051
+ requireToolApproval: true,
1052
+ });
1053
+
1054
+ // Check if a tool is waiting for approval
1055
+ if (output.finishReason === 'suspended') {
1056
+ console.log('Tool requires approval:', output.suspendPayload.toolName);
1057
+
1058
+ // Approve the tool call
1059
+ const result = await agent.approveToolCallGenerate({
1060
+ runId: output.runId,
1061
+ toolCallId: output.suspendPayload.toolCallId,
1062
+ });
1063
+
1064
+ console.log(result.text);
1065
+ }
1066
+ ```
1067
+
1068
+ **Declining a tool call**
1069
+
1070
+ ```typescript
1071
+ if (output.finishReason === 'suspended') {
1072
+ const result = await agent.declineToolCallGenerate({
1073
+ runId: output.runId,
1074
+ toolCallId: output.suspendPayload.toolCallId,
1075
+ });
1076
+ }
1077
+ ```
1078
+
1079
+ **New methods added:**
1080
+ - `agent.approveToolCallGenerate({ runId, toolCallId })` - Approves a pending tool call and returns the complete result
1081
+ - `agent.declineToolCallGenerate({ runId, toolCallId })` - Declines a pending tool call and returns the complete result
1082
+
1083
+ **Server routes added:**
1084
+ - `POST /api/agents/:agentId/approve-tool-call-generate`
1085
+ - `POST /api/agents/:agentId/decline-tool-call-generate`
1086
+
1087
+ The playground UI now also supports tool approval when using generate mode.
1088
+
1089
+ ### Patch Changes
1090
+
1091
+ - Updated dependencies [[`ed3e3dd`](https://github.com/mastra-ai/mastra/commit/ed3e3ddec69d564fe2b125e083437f76331f1283), [`47b1c16`](https://github.com/mastra-ai/mastra/commit/47b1c16a01c7ffb6765fe1e499b49092f8b7eba3), [`9312dcd`](https://github.com/mastra-ai/mastra/commit/9312dcd1c6f5b321929e7d382e763d95fdc030f5)]:
1092
+ - @mastra/client-js@1.0.0-beta.25
1093
+
1094
+ ## 0.1.0-beta.23
1095
+
1096
+ ### Major Changes
1097
+
1098
+ - **Fixed:** Align `Agent.network` with core and update `@mastra/react` network usage. ([#12015](https://github.com/mastra-ai/mastra/pull/12015))
1099
+
1100
+ ### Patch Changes
1101
+
1102
+ - Fixed compatibility with updated `@mastra/client-js` generate and stream API signatures ([#12011](https://github.com/mastra-ai/mastra/pull/12011))
1103
+
1104
+ - Updated dependencies [[`461e448`](https://github.com/mastra-ai/mastra/commit/461e448852fe999506a6046d50b1efc27d8aa378)]:
1105
+ - @mastra/client-js@1.0.0-beta.24
1106
+
1107
+ ## 0.1.0-beta.23
1108
+
1109
+ ### Patch Changes
1110
+
1111
+ - Updated dependencies:
1112
+ - @mastra/client-js@1.0.0-beta.23
1113
+
1114
+ ## 0.1.0-beta.22
1115
+
1116
+ ### Patch Changes
1117
+
1118
+ - Removes the deprecated `threadId` and `resourceId` options from `AgentExecutionOptions`. These have been deprecated for months in favour of the `memory` option. ([#11897](https://github.com/mastra-ai/mastra/pull/11897))
1119
+
1120
+ ### Breaking Changes
1121
+
1122
+ #### `@mastra/core`
1123
+
1124
+ The `threadId` and `resourceId` options have been removed from `agent.generate()` and `agent.stream()`. Use the `memory` option instead:
1125
+
1126
+ ```ts
1127
+ // Before
1128
+ await agent.stream('Hello', {
1129
+ threadId: 'thread-123',
1130
+ resourceId: 'user-456',
1131
+ });
1132
+
1133
+ // After
1134
+ await agent.stream('Hello', {
1135
+ memory: {
1136
+ thread: 'thread-123',
1137
+ resource: 'user-456',
1138
+ },
1139
+ });
1140
+ ```
1141
+
1142
+ #### `@mastra/server`
1143
+
1144
+ The `threadId`, `resourceId`, and `resourceid` fields have been removed from the main agent execution body schema. The server now expects the `memory` option format in request bodies. Legacy routes (`/api/agents/:agentId/generate-legacy` and `/api/agents/:agentId/stream-legacy`) continue to support the deprecated fields.
1145
+
1146
+ #### `@mastra/react`
1147
+
1148
+ The `useChat` hook now internally converts `threadId` to the `memory` option format when making API calls. No changes needed in component code - the hook handles the conversion automatically.
1149
+
1150
+ #### `@mastra/client-js`
1151
+
1152
+ When using the client SDK agent methods, use the `memory` option instead of `threadId`/`resourceId`:
1153
+
1154
+ ```ts
1155
+ const agent = client.getAgent('my-agent');
1156
+
1157
+ // Before
1158
+ await agent.generate({
1159
+ messages: [...],
1160
+ threadId: 'thread-123',
1161
+ resourceId: 'user-456',
1162
+ });
1163
+
1164
+ // After
1165
+ await agent.generate({
1166
+ messages: [...],
1167
+ memory: {
1168
+ thread: 'thread-123',
1169
+ resource: 'user-456',
1170
+ },
1171
+ });
1172
+ ```
1173
+
1174
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
1175
+ - Add suspend/resume capabilities to agent network
1176
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
1177
+
1178
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
1179
+
1180
+ - Fix text parts incorrectly merging across tool calls ([#11783](https://github.com/mastra-ai/mastra/pull/11783))
1181
+
1182
+ Previously, when an agent produced text before and after a tool call (e.g., "Let me search for that" → tool call → "Here's what I found"), the text parts would be merged into a single part, losing the separation. This fix introduces a `textId` property to track separate text streams, ensuring each text stream maintains its own text part in the UI message.
1183
+
1184
+ Fixes #11577
1185
+
1186
+ - Updated dependencies [[`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151)]:
1187
+ - @mastra/client-js@1.0.0-beta.22
1188
+
1189
+ ## 0.1.0-beta.21
1190
+
1191
+ ### Patch Changes
1192
+
1193
+ - Updated dependencies:
1194
+ - @mastra/client-js@1.0.0-beta.21
1195
+
1196
+ ## 0.1.0-beta.20
1197
+
1198
+ ### Patch Changes
1199
+
1200
+ - Fix TypeScript errors during build declaration generation ([#11682](https://github.com/mastra-ai/mastra/pull/11682))
1201
+
1202
+ Updated test file `toUIMessage.test.ts` to match current `@mastra/core` types:
1203
+ - Changed `error` property from string to `Error` object (per `StepFailure` type)
1204
+ - Added missing `resumeSchema` property to `tool-call-approval` payloads (per `ToolCallApprovalPayload` type)
1205
+ - Added `zod` as peer/dev dependency for test type support
1206
+
1207
+ - Fixed agent network not returning text response when routing agent handles requests without delegation. ([#11497](https://github.com/mastra-ai/mastra/pull/11497))
1208
+
1209
+ **What changed:**
1210
+ - Agent networks now correctly stream text responses when the routing agent decides to handle a request itself instead of delegating to sub-agents, workflows, or tools
1211
+ - Added fallback in transformers to ensure text is always returned even if core events are missing
1212
+
1213
+ **Why this matters:**
1214
+ Previously, when using `toAISdkV5Stream` or `networkRoute()` outside of the Mastra Studio UI, no text content was returned when the routing agent handled requests directly. This fix ensures consistent behavior across all API routes.
1215
+
1216
+ Fixes #11219
1217
+
1218
+ - Display network completion validation results and scorer feedback in the Playground when viewing agent network runs, letting users see pass/fail status and actionable feedback from completion scorers ([#11562](https://github.com/mastra-ai/mastra/pull/11562))
1219
+
1220
+ - Updated dependencies [[`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`106c960`](https://github.com/mastra-ai/mastra/commit/106c960df5d110ec15ac8f45de8858597fb90ad5)]:
1221
+ - @mastra/client-js@1.0.0-beta.20
1222
+
1223
+ ## 0.1.0-beta.19
1224
+
1225
+ ### Patch Changes
1226
+
1227
+ - Updated dependencies:
1228
+ - @mastra/client-js@1.0.0-beta.19
1229
+
1230
+ ## 0.1.0-beta.18
1231
+
1232
+ ### Patch Changes
1233
+
1234
+ - Updated dependencies:
1235
+ - @mastra/client-js@1.0.0-beta.18
1236
+
1237
+ ## 0.1.0-beta.17
1238
+
1239
+ ### Patch Changes
1240
+
1241
+ - Updated dependencies:
1242
+ - @mastra/client-js@1.0.0-beta.17
1243
+
1244
+ ## 0.1.0-beta.16
1245
+
1246
+ ### Patch Changes
1247
+
1248
+ - Updated dependencies [[`6cbb549`](https://github.com/mastra-ai/mastra/commit/6cbb549475201a2fbf158f0fd7323f6495f46d08)]:
1249
+ - @mastra/client-js@1.0.0-beta.16
1250
+
1251
+ ## 0.1.0-beta.15
1252
+
1253
+ ### Minor Changes
1254
+
1255
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
1256
+
1257
+ ## What changed
1258
+
1259
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
1260
+
1261
+ **Before:**
1262
+
1263
+ ```typescript
1264
+ // Old span structure
1265
+ span.agentId; // 'my-agent'
1266
+ span.toolId; // undefined
1267
+ span.workflowId; // undefined
1268
+ ```
1269
+
1270
+ **After:**
1271
+
1272
+ ```typescript
1273
+ // New span structure
1274
+ span.entityType; // EntityType.AGENT
1275
+ span.entityId; // 'my-agent'
1276
+ span.entityName; // 'My Agent'
1277
+ ```
1278
+
1279
+ ## New `listTraces()` API
1280
+
1281
+ Query traces with filtering, pagination, and sorting:
1282
+
1283
+ ```typescript
1284
+ const { spans, pagination } = await storage.listTraces({
1285
+ filters: {
1286
+ entityType: EntityType.AGENT,
1287
+ entityId: 'my-agent',
1288
+ userId: 'user-123',
1289
+ environment: 'production',
1290
+ status: TraceStatus.SUCCESS,
1291
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
1292
+ },
1293
+ pagination: { page: 0, perPage: 50 },
1294
+ orderBy: { field: 'startedAt', direction: 'DESC' },
1295
+ });
1296
+ ```
1297
+
1298
+ **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`.
1299
+
1300
+ ## New retrieval methods
1301
+ - `getSpan({ traceId, spanId })` - Get a single span
1302
+ - `getRootSpan({ traceId })` - Get the root span of a trace
1303
+ - `getTrace({ traceId })` - Get all spans for a trace
1304
+
1305
+ ## Backward compatibility
1306
+
1307
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
1308
+
1309
+ ## Migration
1310
+
1311
+ **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`.
1312
+
1313
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
1314
+
1315
+ ### Patch Changes
1316
+
1317
+ - 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)]:
1318
+ - @mastra/client-js@1.0.0-beta.15
1319
+
1320
+ ## 0.1.0-beta.14
1321
+
1322
+ ### Patch Changes
1323
+
1324
+ - Updated dependencies [[`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7)]:
1325
+ - @mastra/client-js@1.0.0-beta.14
1326
+
1327
+ ## 0.1.0-beta.13
1328
+
1329
+ ### Patch Changes
1330
+
1331
+ - Updated dependencies:
1332
+ - @mastra/client-js@1.0.0-beta.13
1333
+
1334
+ ## 0.1.0-beta.12
1335
+
1336
+ ### Patch Changes
1337
+
1338
+ - Remove redundant toolCalls from network agent finalResult ([#11189](https://github.com/mastra-ai/mastra/pull/11189))
1339
+
1340
+ The network agent's `finalResult` was storing `toolCalls` separately even though all tool call information is already present in the `messages` array (as `tool-call` and `tool-result` type messages). This caused significant token waste since the routing agent reads this data from memory on every iteration.
1341
+
1342
+ **Before:** `finalResult: { text, toolCalls, messages }`
1343
+ **After:** `finalResult: { text, messages }`
1344
+
1345
+ +**Migration:** If you were accessing `finalResult.toolCalls`, retrieve tool calls from `finalResult.messages` by filtering for messages with `type: 'tool-call'`.
1346
+
1347
+ Updated `@mastra/react` to extract tool calls directly from the `messages` array instead of the removed `toolCalls` field when resolving initial messages from memory.
1348
+
1349
+ Fixes #11059
1350
+
1351
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
1352
+
1353
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
1354
+
1355
+ ```typescript
1356
+ const agent = new Agent({
1357
+ //...agent information,
1358
+ defaultAgentOptions: {
1359
+ autoResumeSuspendedTools: true,
1360
+ },
1361
+ });
1362
+ ```
1363
+
1364
+ - Updated dependencies [[`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`1b85674`](https://github.com/mastra-ai/mastra/commit/1b85674123708d9b85834dccc9eae601a9d0891c), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`439eaf7`](https://github.com/mastra-ai/mastra/commit/439eaf75447809b05e326666675a4dcbf9c334ce)]:
1365
+ - @mastra/client-js@1.0.0-beta.12
1366
+
1367
+ ## 0.1.0-beta.11
1368
+
1369
+ ### Patch Changes
1370
+
1371
+ - Support new Workflow tripwire run status. Tripwires that are thrown from within a workflow will now bubble up and return a graceful state with information about tripwires. ([#10947](https://github.com/mastra-ai/mastra/pull/10947))
1372
+
1373
+ When a workflow contains an agent step that triggers a tripwire, the workflow returns with `status: 'tripwire'` and includes tripwire details:
1374
+
1375
+ ```typescript showLineNumbers copy
1376
+ const run = await workflow.createRun();
1377
+ const result = await run.start({ inputData: { message: 'Hello' } });
1378
+
1379
+ if (result.status === 'tripwire') {
1380
+ console.log('Workflow terminated by tripwire:', result.tripwire?.reason);
1381
+ console.log('Processor ID:', result.tripwire?.processorId);
1382
+ console.log('Retry requested:', result.tripwire?.retry);
1383
+ }
1384
+ ```
1385
+
1386
+ Adds new UI state for tripwire in agent chat and workflow UI.
1387
+
1388
+ This is distinct from `status: 'failed'` which indicates an unexpected error. A tripwire status means a processor intentionally stopped execution (e.g., for content moderation).
1389
+
1390
+ - Updated dependencies [[`3bf6c5f`](https://github.com/mastra-ai/mastra/commit/3bf6c5f104c25226cd84e0c77f9dec15f2cac2db)]:
1391
+ - @mastra/client-js@1.0.0-beta.11
1392
+
1393
+ ## 0.1.0-beta.10
1394
+
1395
+ ### Minor Changes
1396
+
1397
+ - Fix "MessagePartRuntime is not available" error when chatting with agents in Studio playground by replacing deprecated `useMessagePart` hook with `useAssistantState` ([#11039](https://github.com/mastra-ai/mastra/pull/11039))
1398
+
1399
+ ### Patch Changes
1400
+
1401
+ - fix: persist data-\* chunks from writer.custom() to memory storage ([#10884](https://github.com/mastra-ai/mastra/pull/10884))
1402
+ - Add persistence for custom data chunks (`data-*` parts) emitted via `writer.custom()` in tools
1403
+ - Data chunks are now saved to message storage so they survive page refreshes
1404
+ - Update `@assistant-ui/react` to v0.11.47 with native `DataMessagePart` support
1405
+ - Convert `data-*` parts to `DataMessagePart` format (`{ type: 'data', name: string, data: T }`)
1406
+ - Update related `@assistant-ui/*` packages for compatibility
1407
+
1408
+ - Updated dependencies [[`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d)]:
1409
+ - @mastra/client-js@1.0.0-beta.10
1410
+
1411
+ ## 0.1.0-beta.9
1412
+
1413
+ ### Patch Changes
1414
+
1415
+ - Updated dependencies [[`5a1ede1`](https://github.com/mastra-ai/mastra/commit/5a1ede1f7ab527b9ead11f7eee2f73e67aeca9e4)]:
1416
+ - @mastra/client-js@1.0.0-beta.9
1417
+
1418
+ ## 0.1.0-beta.8
1419
+
1420
+ ### Patch Changes
1421
+
1422
+ - Updated dependencies:
1423
+ - @mastra/client-js@1.0.0-beta.8
1424
+
1425
+ ## 0.1.0-beta.7
1426
+
1427
+ ### Patch Changes
1428
+
1429
+ - Updated dependencies [[`5fe71bc`](https://github.com/mastra-ai/mastra/commit/5fe71bc925dfce597df69c89241f33b378028c63), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141)]:
1430
+ - @mastra/client-js@1.0.0-beta.7
1431
+
1432
+ ## 0.1.0-beta.6
1433
+
1434
+ ### Patch Changes
1435
+
1436
+ - Adjust the types to accept tracingOptions ([#10742](https://github.com/mastra-ai/mastra/pull/10742))
1437
+
1438
+ - Updated dependencies [[`6edf340`](https://github.com/mastra-ai/mastra/commit/6edf3402f6a46ee8def2f42a2287785251fbffd6), [`ad7e8f1`](https://github.com/mastra-ai/mastra/commit/ad7e8f16ac843cbd16687ad47b66ba96bcffe111), [`e1b7118`](https://github.com/mastra-ai/mastra/commit/e1b7118f42ca0a97247afc75e57dcd5fdf987752), [`441c7b6`](https://github.com/mastra-ai/mastra/commit/441c7b6665915cfa7fd625fded8c0f518530bf10), [`e849603`](https://github.com/mastra-ai/mastra/commit/e849603a596269069f58a438b98449ea2770493d)]:
1439
+ - @mastra/client-js@1.0.0-beta.6
1440
+
1441
+ ## 0.1.0-beta.5
1442
+
1443
+ ### Patch Changes
1444
+
1445
+ - Configurable resourceId in react useChat ([#10461](https://github.com/mastra-ai/mastra/pull/10461))
1446
+
1447
+ - fix(agent): persist messages before tool suspension ([#10369](https://github.com/mastra-ai/mastra/pull/10369))
1448
+
1449
+ Fixes issues where thread and messages were not saved before suspension when tools require approval or call suspend() during execution. This caused conversation history to be lost if users refreshed during tool approval or suspension.
1450
+
1451
+ **Backend changes (@mastra/core):**
1452
+ - Add assistant messages to messageList immediately after LLM execution
1453
+ - Flush messages synchronously before suspension to persist state
1454
+ - Create thread if it doesn't exist before flushing
1455
+ - Add metadata helpers to persist and remove tool approval state
1456
+ - Pass saveQueueManager and memory context through workflow for immediate persistence
1457
+
1458
+ **Frontend changes (@mastra/react):**
1459
+ - Extract runId from pending approvals to enable resumption after refresh
1460
+ - Convert `pendingToolApprovals` (DB format) to `requireApprovalMetadata` (runtime format)
1461
+ - Handle both `dynamic-tool` and `tool-{NAME}` part types for approval state
1462
+ - Change runId from hardcoded `agentId` to unique `uuid()`
1463
+
1464
+ **UI changes (@mastra/playground-ui):**
1465
+ - Handle tool calls awaiting approval in message initialization
1466
+ - Convert approval metadata format when loading initial messages
1467
+
1468
+ Fixes #9745, #9906
1469
+
1470
+ - Updated dependencies [[`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f)]:
1471
+ - @mastra/client-js@1.0.0-beta.5
1472
+
1473
+ ## 0.1.0-beta.4
1474
+
1475
+ ### Patch Changes
1476
+
1477
+ - Updated dependencies [[`6a86fe5`](https://github.com/mastra-ai/mastra/commit/6a86fe56b8ff53ca2eb3ed87ffc0748749ebadce), [`595a3b8`](https://github.com/mastra-ai/mastra/commit/595a3b8727c901f44e333909c09843c711224440)]:
1478
+ - @mastra/client-js@1.0.0-beta.4
1479
+
1480
+ ## 0.1.0-beta.3
1481
+
1482
+ ### Patch Changes
1483
+
1484
+ - Updated dependencies [[`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365)]:
1485
+ - @mastra/client-js@1.0.0-beta.3
1486
+
1487
+ ## 0.1.0-beta.2
1488
+
1489
+ ### Patch Changes
1490
+
1491
+ - Updated dependencies []:
1492
+ - @mastra/client-js@1.0.0-beta.2
1493
+
1494
+ ## 0.1.0-beta.1
1495
+
1496
+ ### Patch Changes
1497
+
1498
+ - Updated dependencies [[`dbd9db0`](https://github.com/mastra-ai/mastra/commit/dbd9db0d5c2797a210b9098e7e3e613718e5442f)]:
1499
+ - @mastra/client-js@1.0.0-beta.1
1500
+
1501
+ ## 0.1.0-beta.0
1502
+
1503
+ ### Minor Changes
1504
+
1505
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
1506
+
1507
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
1508
+
1509
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
1510
+ 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
1511
+
1512
+ ### Patch Changes
1513
+
1514
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
1515
+
1516
+ - Fix multi modal in react sdk ([#9373](https://github.com/mastra-ai/mastra/pull/9373))
1517
+
1518
+ - Updated dependencies [[`3852192`](https://github.com/mastra-ai/mastra/commit/3852192c81b2a4f1f883f17d80ce50e0c60dba55), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`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), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`b7de533`](https://github.com/mastra-ai/mastra/commit/b7de53361667eb51fefd89fcaed924f3c57cee8d), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`1ee3411`](https://github.com/mastra-ai/mastra/commit/1ee34113192b11aa8bcdd8d9d5830ae13254b345), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`f93d992`](https://github.com/mastra-ai/mastra/commit/f93d992a37d5431ab4a71246835d403ef7c4ce85), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`ea0b8de`](https://github.com/mastra-ai/mastra/commit/ea0b8dec0d4bc86a72a7e75b2f56c6017c58786d), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`519d9e6`](https://github.com/mastra-ai/mastra/commit/519d9e6d31910457c54bdae8b7b7cb3a69f41831), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`dfe3f8c`](https://github.com/mastra-ai/mastra/commit/dfe3f8c7376ffe159236819e19ca522143c1f972), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`e8dcd71`](https://github.com/mastra-ai/mastra/commit/e8dcd71fa5e473c8ba1d6dad99eef182d20a0491), [`63f2f18`](https://github.com/mastra-ai/mastra/commit/63f2f1863dffe3ad23221d0660ed4e4f2b81789d), [`c23200d`](https://github.com/mastra-ai/mastra/commit/c23200ddfd60830effb39329674ba4ca93be6aac), [`363284b`](https://github.com/mastra-ai/mastra/commit/363284bb974e850f06f40f89a28c79d9f432d7e4), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014)]:
1519
+ - @mastra/client-js@1.0.0-beta.0
1520
+
1521
+ ## 0.0.10
1522
+
1523
+ ### Patch Changes
1524
+
1525
+ - Updated dependencies []:
1526
+ - @mastra/client-js@0.16.4
1527
+
1528
+ ## 0.0.10-alpha.0
1529
+
1530
+ ### Patch Changes
1531
+
1532
+ - Updated dependencies []:
1533
+ - @mastra/client-js@0.16.4-alpha.0
1534
+
1535
+ ## 0.0.9
1536
+
1537
+ ### Patch Changes
1538
+
1539
+ - Updated dependencies []:
1540
+ - @mastra/client-js@0.16.3
1541
+
1542
+ ## 0.0.9-alpha.0
1543
+
1544
+ ### Patch Changes
1545
+
1546
+ - Updated dependencies []:
1547
+ - @mastra/client-js@0.16.3-alpha.0
1548
+
1549
+ ## 0.0.8
1550
+
1551
+ ### Patch Changes
1552
+
1553
+ - Fix perf issue: removed flush sync ([#9014](https://github.com/mastra-ai/mastra/pull/9014))
1554
+
1555
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
1556
+
1557
+ - Show agent tool output better in playground ([#9021](https://github.com/mastra-ai/mastra/pull/9021))
1558
+
1559
+ - Updated dependencies []:
1560
+ - @mastra/client-js@0.16.2
1561
+
1562
+ ## 0.0.8-alpha.1
4
1563
 
5
1564
  ### Patch Changes
6
1565
 
7
1566
  - Fix perf issue: removed flush sync ([#9014](https://github.com/mastra-ai/mastra/pull/9014))
8
1567
 
1568
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
1569
+
1570
+ - Show agent tool output better in playground ([#9021](https://github.com/mastra-ai/mastra/pull/9021))
1571
+
9
1572
  - Updated dependencies []:
10
- - @mastra/client-js@0.0.0-error-handler-fix-20251020202607
1573
+ - @mastra/client-js@0.16.2-alpha.1
11
1574
 
12
1575
  ## 0.0.8-alpha.0
13
1576