@mastra/server 1.0.0-beta.2 → 1.0.0-beta.21

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 (394) hide show
  1. package/CHANGELOG.md +708 -0
  2. package/README.md +2 -2
  3. package/dist/chunk-2UAI7X5P.js +1018 -0
  4. package/dist/chunk-2UAI7X5P.js.map +1 -0
  5. package/dist/chunk-3FEYUHHJ.js +116 -0
  6. package/dist/chunk-3FEYUHHJ.js.map +1 -0
  7. package/dist/chunk-3RAQVZUX.js +204 -0
  8. package/dist/chunk-3RAQVZUX.js.map +1 -0
  9. package/dist/{chunk-SHWNNZBL.js → chunk-3REGEJEN.js} +13 -17
  10. package/dist/chunk-3REGEJEN.js.map +1 -0
  11. package/dist/chunk-3W67K7YE.js +13 -0
  12. package/dist/chunk-3W67K7YE.js.map +1 -0
  13. package/dist/chunk-4DJ7EJRB.cjs +186 -0
  14. package/dist/chunk-4DJ7EJRB.cjs.map +1 -0
  15. package/dist/chunk-4EYONQIW.cjs +82 -0
  16. package/dist/chunk-4EYONQIW.cjs.map +1 -0
  17. package/dist/chunk-4TRYHC5Z.cjs +205 -0
  18. package/dist/chunk-4TRYHC5Z.cjs.map +1 -0
  19. package/dist/chunk-5NFRDYFN.js +77 -0
  20. package/dist/chunk-5NFRDYFN.js.map +1 -0
  21. package/dist/chunk-5VDI75UV.js +44 -0
  22. package/dist/chunk-5VDI75UV.js.map +1 -0
  23. package/dist/chunk-5W4RPVTK.cjs +49 -0
  24. package/dist/chunk-5W4RPVTK.cjs.map +1 -0
  25. package/dist/chunk-6HKMJXTF.js +234 -0
  26. package/dist/chunk-6HKMJXTF.js.map +1 -0
  27. package/dist/chunk-7S7ALPCY.js +225 -0
  28. package/dist/chunk-7S7ALPCY.js.map +1 -0
  29. package/dist/{chunk-2PLXW4ZX.cjs → chunk-AQI6GLTN.cjs} +74 -74
  30. package/dist/{chunk-2PLXW4ZX.cjs.map → chunk-AQI6GLTN.cjs.map} +1 -1
  31. package/dist/chunk-AV3CN5ZR.cjs +326 -0
  32. package/dist/chunk-AV3CN5ZR.cjs.map +1 -0
  33. package/dist/chunk-AVRO3FIN.cjs +231 -0
  34. package/dist/chunk-AVRO3FIN.cjs.map +1 -0
  35. package/dist/chunk-CGIGPJRU.js +279 -0
  36. package/dist/chunk-CGIGPJRU.js.map +1 -0
  37. package/dist/chunk-DVSCJECS.js +250 -0
  38. package/dist/chunk-DVSCJECS.js.map +1 -0
  39. package/dist/chunk-EUBTCHQC.js +83 -0
  40. package/dist/chunk-EUBTCHQC.js.map +1 -0
  41. package/dist/chunk-EZPXTOSM.cjs +928 -0
  42. package/dist/chunk-EZPXTOSM.cjs.map +1 -0
  43. package/dist/chunk-F6CHEWZT.cjs +211 -0
  44. package/dist/chunk-F6CHEWZT.cjs.map +1 -0
  45. package/dist/chunk-FBB2QKRV.js +1075 -0
  46. package/dist/chunk-FBB2QKRV.js.map +1 -0
  47. package/dist/chunk-FLLJIPD4.cjs +46 -0
  48. package/dist/chunk-FLLJIPD4.cjs.map +1 -0
  49. package/dist/chunk-FWSKVWS7.cjs +88 -0
  50. package/dist/chunk-FWSKVWS7.cjs.map +1 -0
  51. package/dist/chunk-G2AMUTU4.js +250 -0
  52. package/dist/chunk-G2AMUTU4.js.map +1 -0
  53. package/dist/{chunk-W2KMU354.cjs → chunk-GWLR6K3H.cjs} +23 -4
  54. package/dist/chunk-GWLR6K3H.cjs.map +1 -0
  55. package/dist/chunk-H27ZCWUX.cjs +33025 -0
  56. package/dist/chunk-H27ZCWUX.cjs.map +1 -0
  57. package/dist/{chunk-RQK4FQUD.js → chunk-H66LLFDL.js} +4 -46
  58. package/dist/chunk-H66LLFDL.js.map +1 -0
  59. package/dist/chunk-HT4LP3BO.js +75 -0
  60. package/dist/chunk-HT4LP3BO.js.map +1 -0
  61. package/dist/chunk-KKY4MSZO.js +314 -0
  62. package/dist/chunk-KKY4MSZO.js.map +1 -0
  63. package/dist/{chunk-QU6N55W6.cjs → chunk-L2E5RUVT.cjs} +17 -21
  64. package/dist/chunk-L2E5RUVT.cjs.map +1 -0
  65. package/dist/chunk-LJ6YRVDI.cjs +15 -0
  66. package/dist/chunk-LJ6YRVDI.cjs.map +1 -0
  67. package/dist/{chunk-ZULZ2752.js → chunk-LOA7RQYO.js} +3 -3
  68. package/dist/{chunk-ZULZ2752.js.map → chunk-LOA7RQYO.js.map} +1 -1
  69. package/dist/chunk-MCYD5LW7.cjs +90 -0
  70. package/dist/chunk-MCYD5LW7.cjs.map +1 -0
  71. package/dist/chunk-MPUVSOEU.cjs +346 -0
  72. package/dist/chunk-MPUVSOEU.cjs.map +1 -0
  73. package/dist/chunk-N4EIZSG2.js +180 -0
  74. package/dist/chunk-N4EIZSG2.js.map +1 -0
  75. package/dist/{chunk-FPBYKMIS.js → chunk-NETDNGUZ.js} +222 -30
  76. package/dist/chunk-NETDNGUZ.js.map +1 -0
  77. package/dist/chunk-NGPUSFSO.cjs +1117 -0
  78. package/dist/chunk-NGPUSFSO.cjs.map +1 -0
  79. package/dist/{chunk-UXGQZUYZ.js → chunk-ONN5EA7E.js} +13 -3
  80. package/dist/chunk-ONN5EA7E.js.map +1 -0
  81. package/dist/chunk-OQVXRANI.js +196 -0
  82. package/dist/chunk-OQVXRANI.js.map +1 -0
  83. package/dist/chunk-P3H4AZKI.cjs +252 -0
  84. package/dist/chunk-P3H4AZKI.cjs.map +1 -0
  85. package/dist/chunk-PNZQCQY4.cjs +252 -0
  86. package/dist/chunk-PNZQCQY4.cjs.map +1 -0
  87. package/dist/{chunk-D7T74TVR.js → chunk-QKXZF7YS.js} +23 -4
  88. package/dist/chunk-QKXZF7YS.js.map +1 -0
  89. package/dist/chunk-QPFYN6B5.cjs +125 -0
  90. package/dist/chunk-QPFYN6B5.cjs.map +1 -0
  91. package/dist/chunk-R25YJP3Y.cjs +269 -0
  92. package/dist/chunk-R25YJP3Y.cjs.map +1 -0
  93. package/dist/{chunk-V5WWQN7P.cjs → chunk-SUKFO7UM.cjs} +13 -2
  94. package/dist/chunk-SUKFO7UM.cjs.map +1 -0
  95. package/dist/chunk-T4SPG2GP.cjs +82 -0
  96. package/dist/chunk-T4SPG2GP.cjs.map +1 -0
  97. package/dist/chunk-TMS4LS2J.js +302 -0
  98. package/dist/chunk-TMS4LS2J.js.map +1 -0
  99. package/dist/{chunk-KJIDZQRA.cjs → chunk-U7IJEAF4.cjs} +228 -30
  100. package/dist/chunk-U7IJEAF4.cjs.map +1 -0
  101. package/dist/chunk-UST3FS67.cjs +1048 -0
  102. package/dist/chunk-UST3FS67.cjs.map +1 -0
  103. package/dist/chunk-V2BBRMP6.js +32986 -0
  104. package/dist/chunk-V2BBRMP6.js.map +1 -0
  105. package/dist/chunk-VEHQCZFU.js +903 -0
  106. package/dist/chunk-VEHQCZFU.js.map +1 -0
  107. package/dist/{chunk-LPM6BBAX.cjs → chunk-VX3VN7FN.cjs} +3 -54
  108. package/dist/chunk-VX3VN7FN.cjs.map +1 -0
  109. package/dist/chunk-WJ6DNHLW.cjs +312 -0
  110. package/dist/chunk-WJ6DNHLW.cjs.map +1 -0
  111. package/dist/chunk-XB27LCKO.js +328 -0
  112. package/dist/chunk-XB27LCKO.js.map +1 -0
  113. package/dist/chunk-XCEQ4GQW.cjs +289 -0
  114. package/dist/chunk-XCEQ4GQW.cjs.map +1 -0
  115. package/dist/chunk-XOUK3IYU.js +77 -0
  116. package/dist/chunk-XOUK3IYU.js.map +1 -0
  117. package/dist/chunk-XWGAT2DA.js +44 -0
  118. package/dist/chunk-XWGAT2DA.js.map +1 -0
  119. package/dist/{dist-G2BYZJOC.cjs → dist-7NTDEVLP.cjs} +28 -28
  120. package/dist/{dist-G2BYZJOC.cjs.map → dist-7NTDEVLP.cjs.map} +1 -1
  121. package/dist/{dist-X7XR3M3Z.js → dist-B5GMANA6.js} +3 -3
  122. package/dist/{dist-X7XR3M3Z.js.map → dist-B5GMANA6.js.map} +1 -1
  123. package/dist/dist-EDO7GEGI.js +3 -0
  124. package/dist/{dist-YREX2TJT.js.map → dist-EDO7GEGI.js.map} +1 -1
  125. package/dist/{dist-RFMYFILX.cjs → dist-OF24ZMHH.cjs} +30 -30
  126. package/dist/{dist-RFMYFILX.cjs.map → dist-OF24ZMHH.cjs.map} +1 -1
  127. package/dist/{dist-4MVGNSRL.cjs → dist-P6YSNLL3.cjs} +20 -20
  128. package/dist/{dist-4MVGNSRL.cjs.map → dist-P6YSNLL3.cjs.map} +1 -1
  129. package/dist/{dist-PQZUVLPC.js → dist-SMBO5KVB.js} +3 -3
  130. package/dist/{dist-PQZUVLPC.js.map → dist-SMBO5KVB.js.map} +1 -1
  131. package/dist/{dist-XVBSOGFK.js → dist-THPMW5QR.js} +3 -3
  132. package/dist/{dist-XVBSOGFK.js.map → dist-THPMW5QR.js.map} +1 -1
  133. package/dist/{dist-FZYCV3VB.cjs → dist-VZTG56X2.cjs} +26 -26
  134. package/dist/{dist-FZYCV3VB.cjs.map → dist-VZTG56X2.cjs.map} +1 -1
  135. package/dist/dist-ZLC23RVC.cjs +16 -0
  136. package/dist/{dist-P4MXBQ3U.cjs.map → dist-ZLC23RVC.cjs.map} +1 -1
  137. package/dist/{dist-R7WYX6LC.js → dist-ZOZ6MHJH.js} +3 -3
  138. package/dist/{dist-R7WYX6LC.js.map → dist-ZOZ6MHJH.js.map} +1 -1
  139. package/dist/docs/README.md +31 -0
  140. package/dist/docs/SKILL.md +32 -0
  141. package/dist/docs/SOURCE_MAP.json +6 -0
  142. package/dist/docs/server/01-custom-adapters.md +377 -0
  143. package/dist/docs/server/02-reference.md +828 -0
  144. package/dist/server/auth/defaults.d.ts +3 -0
  145. package/dist/server/auth/defaults.d.ts.map +1 -0
  146. package/dist/server/auth/helpers.d.ts +14 -0
  147. package/dist/server/auth/helpers.d.ts.map +1 -0
  148. package/dist/server/auth/index.cjs +137 -0
  149. package/dist/server/auth/index.cjs.map +1 -0
  150. package/dist/server/auth/index.d.ts +3 -0
  151. package/dist/server/auth/index.d.ts.map +1 -0
  152. package/dist/server/auth/index.js +127 -0
  153. package/dist/server/auth/index.js.map +1 -0
  154. package/dist/server/handlers/a2a.cjs +15 -7
  155. package/dist/server/handlers/a2a.d.ts +482 -0
  156. package/dist/server/handlers/a2a.d.ts.map +1 -1
  157. package/dist/server/handlers/a2a.js +1 -1
  158. package/dist/server/handlers/agent-builder.cjs +31 -43
  159. package/dist/server/handlers/agent-builder.d.ts +624 -77
  160. package/dist/server/handlers/agent-builder.d.ts.map +1 -1
  161. package/dist/server/handlers/agent-builder.js +1 -1
  162. package/dist/server/handlers/agents.cjs +57 -37
  163. package/dist/server/handlers/agents.d.ts +3296 -131
  164. package/dist/server/handlers/agents.d.ts.map +1 -1
  165. package/dist/server/handlers/agents.js +1 -1
  166. package/dist/server/handlers/error.cjs +6 -2
  167. package/dist/server/handlers/error.d.ts +12 -0
  168. package/dist/server/handlers/error.d.ts.map +1 -1
  169. package/dist/server/handlers/error.js +1 -1
  170. package/dist/server/handlers/logs.cjs +7 -7
  171. package/dist/server/handlers/logs.d.ts +135 -27
  172. package/dist/server/handlers/logs.d.ts.map +1 -1
  173. package/dist/server/handlers/logs.js +1 -1
  174. package/dist/server/handlers/mcp.cjs +40 -0
  175. package/dist/server/handlers/mcp.cjs.map +1 -0
  176. package/dist/server/handlers/mcp.d.ts +110 -0
  177. package/dist/server/handlers/mcp.d.ts.map +1 -0
  178. package/dist/server/handlers/mcp.js +3 -0
  179. package/dist/server/handlers/mcp.js.map +1 -0
  180. package/dist/server/handlers/memory.cjs +71 -27
  181. package/dist/server/handlers/memory.d.ts +1016 -95
  182. package/dist/server/handlers/memory.d.ts.map +1 -1
  183. package/dist/server/handlers/memory.js +1 -1
  184. package/dist/server/handlers/observability.cjs +9 -9
  185. package/dist/server/handlers/observability.d.ts +146 -42
  186. package/dist/server/handlers/observability.d.ts.map +1 -1
  187. package/dist/server/handlers/observability.js +1 -1
  188. package/dist/server/handlers/scores.cjs +13 -13
  189. package/dist/server/handlers/scores.d.ts +110 -141
  190. package/dist/server/handlers/scores.d.ts.map +1 -1
  191. package/dist/server/handlers/scores.js +1 -1
  192. package/dist/server/handlers/stored-agents.cjs +28 -0
  193. package/dist/server/handlers/stored-agents.cjs.map +1 -0
  194. package/dist/server/handlers/stored-agents.d.ts +289 -0
  195. package/dist/server/handlers/stored-agents.d.ts.map +1 -0
  196. package/dist/server/handlers/stored-agents.js +3 -0
  197. package/dist/server/handlers/stored-agents.js.map +1 -0
  198. package/dist/server/handlers/system.cjs +12 -0
  199. package/dist/server/handlers/system.cjs.map +1 -0
  200. package/dist/server/handlers/system.d.ts +7 -0
  201. package/dist/server/handlers/system.d.ts.map +1 -0
  202. package/dist/server/handlers/system.js +3 -0
  203. package/dist/server/handlers/system.js.map +1 -0
  204. package/dist/server/handlers/test-utils.cjs +15 -0
  205. package/dist/server/handlers/test-utils.cjs.map +1 -0
  206. package/dist/server/handlers/test-utils.d.ts +6 -0
  207. package/dist/server/handlers/test-utils.d.ts.map +1 -0
  208. package/dist/server/handlers/test-utils.js +13 -0
  209. package/dist/server/handlers/test-utils.js.map +1 -0
  210. package/dist/server/handlers/tools.cjs +11 -11
  211. package/dist/server/handlers/tools.d.ts +69 -23
  212. package/dist/server/handlers/tools.d.ts.map +1 -1
  213. package/dist/server/handlers/tools.js +1 -1
  214. package/dist/server/handlers/utils.cjs +11 -3
  215. package/dist/server/handlers/utils.d.ts +5 -0
  216. package/dist/server/handlers/utils.d.ts.map +1 -1
  217. package/dist/server/handlers/utils.js +1 -1
  218. package/dist/server/handlers/vector.cjs +31 -7
  219. package/dist/server/handlers/vector.d.ts +93 -9
  220. package/dist/server/handlers/vector.d.ts.map +1 -1
  221. package/dist/server/handlers/vector.js +1 -1
  222. package/dist/server/handlers/voice.cjs +21 -9
  223. package/dist/server/handlers/voice.d.ts +81 -40
  224. package/dist/server/handlers/voice.d.ts.map +1 -1
  225. package/dist/server/handlers/voice.js +1 -1
  226. package/dist/server/handlers/workflows.cjs +57 -37
  227. package/dist/server/handlers/workflows.d.ts +980 -74
  228. package/dist/server/handlers/workflows.d.ts.map +1 -1
  229. package/dist/server/handlers/workflows.js +1 -1
  230. package/dist/server/handlers.cjs +36 -31
  231. package/dist/server/handlers.d.ts +1 -0
  232. package/dist/server/handlers.d.ts.map +1 -1
  233. package/dist/server/handlers.js +12 -11
  234. package/dist/server/schemas/a2a.d.ts +786 -0
  235. package/dist/server/schemas/a2a.d.ts.map +1 -0
  236. package/dist/server/schemas/agent-builder.d.ts +225 -0
  237. package/dist/server/schemas/agent-builder.d.ts.map +1 -0
  238. package/dist/server/schemas/agents.d.ts +1401 -0
  239. package/dist/server/schemas/agents.d.ts.map +1 -0
  240. package/dist/server/schemas/common.d.ts +179 -0
  241. package/dist/server/schemas/common.d.ts.map +1 -0
  242. package/dist/server/schemas/logs.d.ts +124 -0
  243. package/dist/server/schemas/logs.d.ts.map +1 -0
  244. package/dist/server/schemas/mcp.d.ts +299 -0
  245. package/dist/server/schemas/mcp.d.ts.map +1 -0
  246. package/dist/server/schemas/memory.d.ts +1128 -0
  247. package/dist/server/schemas/memory.d.ts.map +1 -0
  248. package/dist/server/schemas/scores.d.ts +259 -0
  249. package/dist/server/schemas/scores.d.ts.map +1 -0
  250. package/dist/server/schemas/stored-agents.d.ts +792 -0
  251. package/dist/server/schemas/stored-agents.d.ts.map +1 -0
  252. package/dist/server/schemas/system.d.ts +36 -0
  253. package/dist/server/schemas/system.d.ts.map +1 -0
  254. package/dist/server/schemas/vectors.d.ts +107 -0
  255. package/dist/server/schemas/vectors.d.ts.map +1 -0
  256. package/dist/server/schemas/workflows.d.ts +863 -0
  257. package/dist/server/schemas/workflows.d.ts.map +1 -0
  258. package/dist/server/server-adapter/index.cjs +510 -0
  259. package/dist/server/server-adapter/index.cjs.map +1 -0
  260. package/dist/server/server-adapter/index.d.ts +109 -0
  261. package/dist/server/server-adapter/index.d.ts.map +1 -0
  262. package/dist/server/server-adapter/index.js +482 -0
  263. package/dist/server/server-adapter/index.js.map +1 -0
  264. package/dist/server/server-adapter/openapi-utils.d.ts +59 -0
  265. package/dist/server/server-adapter/openapi-utils.d.ts.map +1 -0
  266. package/dist/server/server-adapter/redact.d.ts +26 -0
  267. package/dist/server/server-adapter/redact.d.ts.map +1 -0
  268. package/dist/server/server-adapter/routes/a2a.d.ts +3 -0
  269. package/dist/server/server-adapter/routes/a2a.d.ts.map +1 -0
  270. package/dist/server/server-adapter/routes/agent-builder.d.ts +3 -0
  271. package/dist/server/server-adapter/routes/agent-builder.d.ts.map +1 -0
  272. package/dist/server/server-adapter/routes/agents.d.ts +3 -0
  273. package/dist/server/server-adapter/routes/agents.d.ts.map +1 -0
  274. package/dist/server/server-adapter/routes/index.d.ts +50 -0
  275. package/dist/server/server-adapter/routes/index.d.ts.map +1 -0
  276. package/dist/server/server-adapter/routes/legacy.d.ts +7 -0
  277. package/dist/server/server-adapter/routes/legacy.d.ts.map +1 -0
  278. package/dist/server/server-adapter/routes/logs.d.ts +3 -0
  279. package/dist/server/server-adapter/routes/logs.d.ts.map +1 -0
  280. package/dist/server/server-adapter/routes/mcp.d.ts +9 -0
  281. package/dist/server/server-adapter/routes/mcp.d.ts.map +1 -0
  282. package/dist/server/server-adapter/routes/memory.d.ts +3 -0
  283. package/dist/server/server-adapter/routes/memory.d.ts.map +1 -0
  284. package/dist/server/server-adapter/routes/observability.d.ts +3 -0
  285. package/dist/server/server-adapter/routes/observability.d.ts.map +1 -0
  286. package/dist/server/server-adapter/routes/route-builder.d.ts +111 -0
  287. package/dist/server/server-adapter/routes/route-builder.d.ts.map +1 -0
  288. package/dist/server/server-adapter/routes/scorers.d.ts +3 -0
  289. package/dist/server/server-adapter/routes/scorers.d.ts.map +1 -0
  290. package/dist/server/server-adapter/routes/stored-agents.d.ts +8 -0
  291. package/dist/server/server-adapter/routes/stored-agents.d.ts.map +1 -0
  292. package/dist/server/server-adapter/routes/stream-types.d.ts +10 -0
  293. package/dist/server/server-adapter/routes/stream-types.d.ts.map +1 -0
  294. package/dist/server/server-adapter/routes/system.d.ts +12 -0
  295. package/dist/server/server-adapter/routes/system.d.ts.map +1 -0
  296. package/dist/server/server-adapter/routes/tools.d.ts +3 -0
  297. package/dist/server/server-adapter/routes/tools.d.ts.map +1 -0
  298. package/dist/server/server-adapter/routes/vectors.d.ts +3 -0
  299. package/dist/server/server-adapter/routes/vectors.d.ts.map +1 -0
  300. package/dist/server/server-adapter/routes/workflows.d.ts +3 -0
  301. package/dist/server/server-adapter/routes/workflows.d.ts.map +1 -0
  302. package/dist/server/utils.d.ts +1 -1
  303. package/dist/server/utils.d.ts.map +1 -1
  304. package/dist/{token-375W3LEI.cjs → token-6GSAFR2W-K2BTU23I-5WBYUIGY.cjs} +11 -12
  305. package/dist/token-6GSAFR2W-K2BTU23I-5WBYUIGY.cjs.map +1 -0
  306. package/dist/{token-C3IMNCC4.js → token-6GSAFR2W-K2BTU23I-NW33N3NU.js} +8 -9
  307. package/dist/token-6GSAFR2W-K2BTU23I-NW33N3NU.js.map +1 -0
  308. package/dist/token-6GSAFR2W-KVDFAJ2M-EPLMGMHT.cjs +63 -0
  309. package/dist/token-6GSAFR2W-KVDFAJ2M-EPLMGMHT.cjs.map +1 -0
  310. package/dist/token-6GSAFR2W-KVDFAJ2M-VW443KIA.js +61 -0
  311. package/dist/token-6GSAFR2W-KVDFAJ2M-VW443KIA.js.map +1 -0
  312. package/dist/token-6GSAFR2W-VLY2XUPA-NCSASMWN.js +61 -0
  313. package/dist/token-6GSAFR2W-VLY2XUPA-NCSASMWN.js.map +1 -0
  314. package/dist/token-6GSAFR2W-VLY2XUPA-RKITWXKR.cjs +63 -0
  315. package/dist/token-6GSAFR2W-VLY2XUPA-RKITWXKR.cjs.map +1 -0
  316. package/dist/token-util-NEHG7TUY-DJYRKLRD-6TH3ODCN.cjs +10 -0
  317. package/dist/token-util-NEHG7TUY-DJYRKLRD-6TH3ODCN.cjs.map +1 -0
  318. package/dist/token-util-NEHG7TUY-DJYRKLRD-EACKYD4V.js +8 -0
  319. package/dist/token-util-NEHG7TUY-DJYRKLRD-EACKYD4V.js.map +1 -0
  320. package/dist/token-util-NEHG7TUY-KSXDO2NO-J6DEINGO.cjs +10 -0
  321. package/dist/token-util-NEHG7TUY-KSXDO2NO-J6DEINGO.cjs.map +1 -0
  322. package/dist/token-util-NEHG7TUY-KSXDO2NO-WH6I3PH3.js +8 -0
  323. package/dist/token-util-NEHG7TUY-KSXDO2NO-WH6I3PH3.js.map +1 -0
  324. package/dist/token-util-NEHG7TUY-TIJ3LMSH-ANFISSXX.cjs +10 -0
  325. package/dist/token-util-NEHG7TUY-TIJ3LMSH-ANFISSXX.cjs.map +1 -0
  326. package/dist/token-util-NEHG7TUY-TIJ3LMSH-SGVKOKXF.js +8 -0
  327. package/dist/token-util-NEHG7TUY-TIJ3LMSH-SGVKOKXF.js.map +1 -0
  328. package/package.json +35 -10
  329. package/dist/chunk-2IS5WICF.js +0 -23036
  330. package/dist/chunk-2IS5WICF.js.map +0 -1
  331. package/dist/chunk-2YZH5PH6.cjs +0 -200
  332. package/dist/chunk-2YZH5PH6.cjs.map +0 -1
  333. package/dist/chunk-3AMNUUZF.js +0 -124
  334. package/dist/chunk-3AMNUUZF.js.map +0 -1
  335. package/dist/chunk-3F52QCI4.js +0 -192
  336. package/dist/chunk-3F52QCI4.js.map +0 -1
  337. package/dist/chunk-4JF5WXPL.js +0 -502
  338. package/dist/chunk-4JF5WXPL.js.map +0 -1
  339. package/dist/chunk-73PAWDM5.js +0 -83
  340. package/dist/chunk-73PAWDM5.js.map +0 -1
  341. package/dist/chunk-A24TSVEZ.cjs +0 -130
  342. package/dist/chunk-A24TSVEZ.cjs.map +0 -1
  343. package/dist/chunk-A2NPD5N6.cjs +0 -517
  344. package/dist/chunk-A2NPD5N6.cjs.map +0 -1
  345. package/dist/chunk-B3Z6J745.js +0 -122
  346. package/dist/chunk-B3Z6J745.js.map +0 -1
  347. package/dist/chunk-BTWIR2B7.cjs +0 -28
  348. package/dist/chunk-BTWIR2B7.cjs.map +0 -1
  349. package/dist/chunk-D7T74TVR.js.map +0 -1
  350. package/dist/chunk-EHACNWDL.cjs +0 -681
  351. package/dist/chunk-EHACNWDL.cjs.map +0 -1
  352. package/dist/chunk-FPBYKMIS.js.map +0 -1
  353. package/dist/chunk-GLAZTMX3.cjs +0 -128
  354. package/dist/chunk-GLAZTMX3.cjs.map +0 -1
  355. package/dist/chunk-ID6JYDNL.cjs +0 -23075
  356. package/dist/chunk-ID6JYDNL.cjs.map +0 -1
  357. package/dist/chunk-KF3RI45U.cjs +0 -172
  358. package/dist/chunk-KF3RI45U.cjs.map +0 -1
  359. package/dist/chunk-KJIDZQRA.cjs.map +0 -1
  360. package/dist/chunk-KWH5QBXP.js +0 -123
  361. package/dist/chunk-KWH5QBXP.js.map +0 -1
  362. package/dist/chunk-LPM6BBAX.cjs.map +0 -1
  363. package/dist/chunk-ND5OKOMT.js +0 -165
  364. package/dist/chunk-ND5OKOMT.js.map +0 -1
  365. package/dist/chunk-PPMIB3FQ.cjs +0 -88
  366. package/dist/chunk-PPMIB3FQ.cjs.map +0 -1
  367. package/dist/chunk-QU6N55W6.cjs.map +0 -1
  368. package/dist/chunk-RQK4FQUD.js.map +0 -1
  369. package/dist/chunk-S54HNARD.cjs +0 -131
  370. package/dist/chunk-S54HNARD.cjs.map +0 -1
  371. package/dist/chunk-SHWNNZBL.js.map +0 -1
  372. package/dist/chunk-SZIFSF4T.js +0 -25
  373. package/dist/chunk-SZIFSF4T.js.map +0 -1
  374. package/dist/chunk-TOCYBDP2.js +0 -46
  375. package/dist/chunk-TOCYBDP2.js.map +0 -1
  376. package/dist/chunk-UXGQZUYZ.js.map +0 -1
  377. package/dist/chunk-V5WWQN7P.cjs.map +0 -1
  378. package/dist/chunk-W2KMU354.cjs.map +0 -1
  379. package/dist/chunk-X3MICMI2.cjs +0 -620
  380. package/dist/chunk-X3MICMI2.cjs.map +0 -1
  381. package/dist/chunk-X6C7BUWN.cjs +0 -48
  382. package/dist/chunk-X6C7BUWN.cjs.map +0 -1
  383. package/dist/chunk-Z2O5YVHY.js +0 -661
  384. package/dist/chunk-Z2O5YVHY.js.map +0 -1
  385. package/dist/chunk-ZJ6KEY6H.js +0 -600
  386. package/dist/chunk-ZJ6KEY6H.js.map +0 -1
  387. package/dist/dist-P4MXBQ3U.cjs +0 -16
  388. package/dist/dist-YREX2TJT.js +0 -3
  389. package/dist/token-375W3LEI.cjs.map +0 -1
  390. package/dist/token-C3IMNCC4.js.map +0 -1
  391. package/dist/token-util-CV3RRG6K.cjs +0 -9
  392. package/dist/token-util-CV3RRG6K.cjs.map +0 -1
  393. package/dist/token-util-E5QO2RCL.js +0 -7
  394. package/dist/token-util-E5QO2RCL.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,713 @@
1
1
  # @mastra/server
2
2
 
3
+ ## 1.0.0-beta.21
4
+
5
+ ### Patch Changes
6
+
7
+ - Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
8
+
9
+ - Fix query parameter parsing for complex nested optional types ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
10
+
11
+ Fixes an issue where complex query parameters (like `startedAt` and `endedAt` date range filters) would fail with "Expected object, received string" errors when using the `listTraces` API.
12
+
13
+ The fix addresses two issues:
14
+ - Properly unwraps all layers of nested optional/nullable types (e.g., from `.partial()` on already-optional fields)
15
+ - Ensures compatibility with both zod v3 and v4
16
+
17
+ - Updated dependencies [[`08766f1`](https://github.com/mastra-ai/mastra/commit/08766f15e13ac0692fde2a8bd366c2e16e4321df), [`ae8baf7`](https://github.com/mastra-ai/mastra/commit/ae8baf7d8adcb0ff9dac11880400452bc49b33ff), [`cfabdd4`](https://github.com/mastra-ai/mastra/commit/cfabdd4aae7a726b706942d6836eeca110fb6267), [`a0e437f`](https://github.com/mastra-ai/mastra/commit/a0e437fac561b28ee719e0302d72b2f9b4c138f0), [`bec5efd`](https://github.com/mastra-ai/mastra/commit/bec5efde96653ccae6604e68c696d1bc6c1a0bf5), [`9eedf7d`](https://github.com/mastra-ai/mastra/commit/9eedf7de1d6e0022a2f4e5e9e6fe1ec468f9b43c)]:
18
+ - @mastra/core@1.0.0-beta.21
19
+
20
+ ## 1.0.0-beta.20
21
+
22
+ ### Minor Changes
23
+
24
+ - Unified `getWorkflowRunById` and `getWorkflowRunExecutionResult` into a single API that returns `WorkflowState` with both metadata and execution state. ([#11429](https://github.com/mastra-ai/mastra/pull/11429))
25
+
26
+ **What changed:**
27
+ - `getWorkflowRunById` now returns a unified `WorkflowState` object containing metadata (runId, workflowName, resourceId, createdAt, updatedAt) along with processed execution state (status, result, error, payload, steps)
28
+ - Added optional `fields` parameter to request only specific fields for better performance
29
+ - Added optional `withNestedWorkflows` parameter to control nested workflow step inclusion
30
+ - Removed `getWorkflowRunExecutionResult` - use `getWorkflowRunById` instead (breaking change)
31
+ - Removed `/execution-result` API endpoints from server (breaking change)
32
+ - Removed `runExecutionResult()` method from client SDK (breaking change)
33
+ - Removed `GetWorkflowRunExecutionResultResponse` type from client SDK (breaking change)
34
+
35
+ **Before:**
36
+
37
+ ```typescript
38
+ // Had to call two different methods for different data
39
+ const run = await workflow.getWorkflowRunById(runId); // Returns raw WorkflowRun with snapshot
40
+ const result = await workflow.getWorkflowRunExecutionResult(runId); // Returns processed execution state
41
+ ```
42
+
43
+ **After:**
44
+
45
+ ```typescript
46
+ // Single method returns everything
47
+ const run = await workflow.getWorkflowRunById(runId);
48
+ // Returns: { runId, workflowName, resourceId, createdAt, updatedAt, status, result, error, payload, steps }
49
+
50
+ // Request only specific fields for better performance (avoids expensive step fetching)
51
+ const status = await workflow.getWorkflowRunById(runId, { fields: ['status'] });
52
+
53
+ // Skip nested workflow steps for faster response
54
+ const run = await workflow.getWorkflowRunById(runId, { withNestedWorkflows: false });
55
+ ```
56
+
57
+ **Why:** The previous API required calling two separate methods to get complete workflow run information. This unification simplifies the API surface and gives users control over performance - fetching all steps (especially nested workflows) can be expensive, so the `fields` and `withNestedWorkflows` options let users request only what they need.
58
+
59
+ ### Patch Changes
60
+
61
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
62
+
63
+ Mastra packages now include embedded documentation in the published npm package under `dist/docs/`. This enables coding agents and AI assistants to understand and use the framework by reading documentation directly from `node_modules`.
64
+
65
+ Each package includes:
66
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
67
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
68
+ - **Topic folders** - Conceptual documentation organized by feature area
69
+
70
+ Documentation is driven by the `packages` frontmatter field in MDX files, which maps docs to their corresponding packages. CI validation ensures all docs include this field.
71
+
72
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
73
+
74
+ ```diff
75
+ + const run = await workflow.createRun({ runId: '123' });
76
+ - const stream = await run.streamVNext({ inputData: { ... } });
77
+ + const stream = await run.stream({ inputData: { ... } });
78
+ ```
79
+
80
+ - Fixed inconsistent query parameter handling across server adapters. ([#11429](https://github.com/mastra-ai/mastra/pull/11429))
81
+
82
+ **What changed:** Query parameters are now processed consistently across all server adapters (Express, Hono, Fastify, Koa). Added internal helper `normalizeQueryParams` and `ParsedRequestParams` type to `@mastra/server` for adapter implementations.
83
+
84
+ **Why:** Different HTTP frameworks handle query parameters differently - some return single strings while others return arrays for repeated params like `?tag=a&tag=b`. This caused type inconsistencies that could lead to validation failures in certain adapters.
85
+
86
+ **User impact:** None for typical usage - HTTP endpoints and client SDK behavior are unchanged. If you extend server adapter classes and override `getParams` or `parseQueryParams`, update your implementation to use `Record<string, string | string[]>` for query parameters.
87
+
88
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
89
+
90
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
91
+
92
+ ```typescript
93
+ // Clone a thread
94
+ const { thread, clonedMessages } = await memory.cloneThread({
95
+ sourceThreadId: 'thread-123',
96
+ title: 'My Clone',
97
+ options: {
98
+ messageLimit: 10, // optional: only copy last N messages
99
+ },
100
+ });
101
+
102
+ // Check if a thread is a clone
103
+ if (memory.isClone(thread)) {
104
+ const source = await memory.getSourceThread(thread.id);
105
+ }
106
+
107
+ // List all clones of a thread
108
+ const clones = await memory.listClones('thread-123');
109
+ ```
110
+
111
+ Includes:
112
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
113
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
114
+ - Embeddings created for cloned messages (semantic recall)
115
+ - Clone button in playground UI Memory tab
116
+
117
+ - Make agentId optional for memory read operations (getThread, listThreads, listMessages) ([#11540](https://github.com/mastra-ai/mastra/pull/11540))
118
+
119
+ When workflows use multiple agents sharing the same threadId/resourceId, users can now retrieve threads and messages without specifying an agentId. The server falls back to using storage directly when agentId is not provided.
120
+
121
+ - Updated dependencies [[`d2d3e22`](https://github.com/mastra-ai/mastra/commit/d2d3e22a419ee243f8812a84e3453dd44365ecb0), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`05b8bee`](https://github.com/mastra-ai/mastra/commit/05b8bee9e50e6c2a4a2bf210eca25ee212ca24fa), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`940a2b2`](https://github.com/mastra-ai/mastra/commit/940a2b27480626ed7e74f55806dcd2181c1dd0c2), [`e0941c3`](https://github.com/mastra-ai/mastra/commit/e0941c3d7fc75695d5d258e7008fd5d6e650800c), [`0c0580a`](https://github.com/mastra-ai/mastra/commit/0c0580a42f697cd2a7d5973f25bfe7da9055038a), [`28f5f89`](https://github.com/mastra-ai/mastra/commit/28f5f89705f2409921e3c45178796c0e0d0bbb64), [`e601b27`](https://github.com/mastra-ai/mastra/commit/e601b272c70f3a5ecca610373aa6223012704892), [`3d3366f`](https://github.com/mastra-ai/mastra/commit/3d3366f31683e7137d126a3a57174a222c5801fb), [`5a4953f`](https://github.com/mastra-ai/mastra/commit/5a4953f7d25bb15ca31ed16038092a39cb3f98b3), [`eb9e522`](https://github.com/mastra-ai/mastra/commit/eb9e522ce3070a405e5b949b7bf5609ca51d7fe2), [`20e6f19`](https://github.com/mastra-ai/mastra/commit/20e6f1971d51d3ff6dd7accad8aaaae826d540ed), [`4f0b3c6`](https://github.com/mastra-ai/mastra/commit/4f0b3c66f196c06448487f680ccbb614d281e2f7), [`74c4f22`](https://github.com/mastra-ai/mastra/commit/74c4f22ed4c71e72598eacc346ba95cdbc00294f), [`81b6a8f`](https://github.com/mastra-ai/mastra/commit/81b6a8ff79f49a7549d15d66624ac1a0b8f5f971), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`a4f010b`](https://github.com/mastra-ai/mastra/commit/a4f010b22e4355a5fdee70a1fe0f6e4a692cc29e), [`73b0bb3`](https://github.com/mastra-ai/mastra/commit/73b0bb394dba7c9482eb467a97ab283dbc0ef4db), [`5627a8c`](https://github.com/mastra-ai/mastra/commit/5627a8c6dc11fe3711b3fa7a6ffd6eb34100a306), [`3ff45d1`](https://github.com/mastra-ai/mastra/commit/3ff45d10e0c80c5335a957ab563da72feb623520), [`251df45`](https://github.com/mastra-ai/mastra/commit/251df4531407dfa46d805feb40ff3fb49769f455), [`f894d14`](https://github.com/mastra-ai/mastra/commit/f894d148946629af7b1f452d65a9cf864cec3765), [`c2b9547`](https://github.com/mastra-ai/mastra/commit/c2b9547bf435f56339f23625a743b2147ab1c7a6), [`580b592`](https://github.com/mastra-ai/mastra/commit/580b5927afc82fe460dfdf9a38a902511b6b7e7f), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`4fba91b`](https://github.com/mastra-ai/mastra/commit/4fba91bec7c95911dc28e369437596b152b04cd0), [`12b0cc4`](https://github.com/mastra-ai/mastra/commit/12b0cc4077d886b1a552637dedb70a7ade93528c)]:
122
+ - @mastra/core@1.0.0-beta.20
123
+
124
+ ## 1.0.0-beta.19
125
+
126
+ ### Patch Changes
127
+
128
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
129
+ - @mastra/core@1.0.0-beta.19
130
+
131
+ ## 1.0.0-beta.18
132
+
133
+ ### Patch Changes
134
+
135
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
136
+ - @mastra/core@1.0.0-beta.18
137
+
138
+ ## 1.0.0-beta.17
139
+
140
+ ### Patch Changes
141
+
142
+ - Updated dependencies [[`b5dc973`](https://github.com/mastra-ai/mastra/commit/b5dc9733a5158850298dfb103acb3babdba8a318)]:
143
+ - @mastra/core@1.0.0-beta.17
144
+
145
+ ## 1.0.0-beta.16
146
+
147
+ ### Patch Changes
148
+
149
+ - Fix workflow observability view broken by invalid entityType parameter ([#11427](https://github.com/mastra-ai/mastra/pull/11427))
150
+
151
+ The UI workflow observability view was failing with a Zod validation error when trying to filter traces by workflow. The UI was sending `entityType=workflow`, but the backend's `EntityType` enum only accepts `workflow_run`.
152
+
153
+ **Root Cause**: The legacy value transformation was happening in the handler (after validation), but Zod validation occurred earlier in the request pipeline, rejecting the request before it could be transformed.
154
+
155
+ **Solution**:
156
+ - Added `z.preprocess()` to the query schema to transform `workflow` → `workflow_run` before validation
157
+ - Kept handler transformation for defense in depth
158
+ - Updated UI to use `EntityType.WORKFLOW_RUN` enum value for type safety
159
+
160
+ This maintains backward compatibility with legacy clients while fixing the validation error.
161
+
162
+ Fixes #11412
163
+
164
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
165
+
166
+ `MastraStorage` can now compose storage domains from different adapters. Use it when you need different databases for different purposes - for example, PostgreSQL for memory and workflows, but a different database for observability.
167
+
168
+ ```typescript
169
+ import { MastraStorage } from '@mastra/core/storage';
170
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
171
+ import { MemoryLibSQL } from '@mastra/libsql';
172
+
173
+ // Compose domains from different stores
174
+ const storage = new MastraStorage({
175
+ id: 'composite',
176
+ domains: {
177
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
178
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
179
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
180
+ },
181
+ });
182
+ ```
183
+
184
+ **Breaking changes:**
185
+ - `storage.supports` property no longer exists
186
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
187
+
188
+ All stores now support the same features. For domain availability, use `getStore()`:
189
+
190
+ ```typescript
191
+ const store = await storage.getStore('memory');
192
+ if (store) {
193
+ // domain is available
194
+ }
195
+ ```
196
+
197
+ - Updated dependencies [[`3d93a15`](https://github.com/mastra-ai/mastra/commit/3d93a15796b158c617461c8b98bede476ebb43e2), [`efe406a`](https://github.com/mastra-ai/mastra/commit/efe406a1353c24993280ebc2ed61dd9f65b84b26), [`119e5c6`](https://github.com/mastra-ai/mastra/commit/119e5c65008f3e5cfca954eefc2eb85e3bf40da4), [`74e504a`](https://github.com/mastra-ai/mastra/commit/74e504a3b584eafd2f198001c6a113bbec589fd3), [`e33fdbd`](https://github.com/mastra-ai/mastra/commit/e33fdbd07b33920d81e823122331b0c0bee0bb59), [`929f69c`](https://github.com/mastra-ai/mastra/commit/929f69c3436fa20dd0f0e2f7ebe8270bd82a1529), [`8a73529`](https://github.com/mastra-ai/mastra/commit/8a73529ca01187f604b1f3019d0a725ac63ae55f)]:
198
+ - @mastra/core@1.0.0-beta.16
199
+
200
+ ## 1.0.0-beta.15
201
+
202
+ ### Minor Changes
203
+
204
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
205
+
206
+ ## What changed
207
+
208
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
209
+
210
+ **Before:**
211
+
212
+ ```typescript
213
+ // Old span structure
214
+ span.agentId; // 'my-agent'
215
+ span.toolId; // undefined
216
+ span.workflowId; // undefined
217
+ ```
218
+
219
+ **After:**
220
+
221
+ ```typescript
222
+ // New span structure
223
+ span.entityType; // EntityType.AGENT
224
+ span.entityId; // 'my-agent'
225
+ span.entityName; // 'My Agent'
226
+ ```
227
+
228
+ ## New `listTraces()` API
229
+
230
+ Query traces with filtering, pagination, and sorting:
231
+
232
+ ```typescript
233
+ const { spans, pagination } = await storage.listTraces({
234
+ filters: {
235
+ entityType: EntityType.AGENT,
236
+ entityId: 'my-agent',
237
+ userId: 'user-123',
238
+ environment: 'production',
239
+ status: TraceStatus.SUCCESS,
240
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
241
+ },
242
+ pagination: { page: 0, perPage: 50 },
243
+ orderBy: { field: 'startedAt', direction: 'DESC' },
244
+ });
245
+ ```
246
+
247
+ **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`.
248
+
249
+ ## New retrieval methods
250
+ - `getSpan({ traceId, spanId })` - Get a single span
251
+ - `getRootSpan({ traceId })` - Get the root span of a trace
252
+ - `getTrace({ traceId })` - Get all spans for a trace
253
+
254
+ ## Backward compatibility
255
+
256
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
257
+
258
+ ## Migration
259
+
260
+ **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`.
261
+
262
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
263
+
264
+ ### Patch Changes
265
+
266
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
267
+
268
+ ### Summary
269
+
270
+ This release introduces a new storage architecture that replaces passthrough methods on `MastraStorage` with domain-specific storage interfaces accessed via `getStore()`. This change reduces code duplication across storage adapters and provides a cleaner, more modular API.
271
+
272
+ ### Migration Guide
273
+
274
+ All direct method calls on storage instances should be updated to use `getStore()`:
275
+
276
+ ```typescript
277
+ // Before
278
+ const thread = await storage.getThreadById({ threadId });
279
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
280
+ await storage.createSpan(span);
281
+
282
+ // After
283
+ const memory = await storage.getStore('memory');
284
+ const thread = await memory?.getThreadById({ threadId });
285
+
286
+ const workflows = await storage.getStore('workflows');
287
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
288
+
289
+ const observability = await storage.getStore('observability');
290
+ await observability?.createSpan(span);
291
+ ```
292
+
293
+ ### Available Domains
294
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
295
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
296
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
297
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
298
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
299
+
300
+ ### Breaking Changes
301
+ - Passthrough methods have been removed from `MastraStorage` base class
302
+ - All storage adapters now require accessing domains via `getStore()`
303
+ - The `stores` property on storage instances is now the canonical way to access domain storage
304
+
305
+ ### Internal Changes
306
+ - Each storage adapter now initializes domain-specific stores in its constructor
307
+ - Domain stores share database connections and handle their own table initialization
308
+
309
+ - Add `/api/system/packages` endpoint that returns installed Mastra packages and versions from the dev environment ([#11211](https://github.com/mastra-ai/mastra/pull/11211))
310
+
311
+ - Add `perStep` option to workflow run methods, allowing a workflow to run just a step instead of all the workflow steps ([#11276](https://github.com/mastra-ai/mastra/pull/11276))
312
+
313
+ - Fixed voice transcription endpoint ([#11348](https://github.com/mastra-ai/mastra/pull/11348))
314
+
315
+ The voice transcription endpoint (`/api/agents/:agentId/voice/listen`) now correctly handles multipart/form-data requests for audio uploads rather than only parsing JSON request bodies.
316
+
317
+ Both Express and Hono adapters now parse multipart/form-data bodies and handle JSON-encoded form fields.
318
+
319
+ **Breaking change:** The server schema field for the transcription endpoint was renamed from `audioData` to `audio` to match the client SDK. If you are making direct API calls to the transcription endpoint (not using the SDK), you will need to update your request body to use `audio` instead of `audioData`.
320
+
321
+ - Updated dependencies [[`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
322
+ - @mastra/core@1.0.0-beta.15
323
+
324
+ ## 1.0.0-beta.14
325
+
326
+ ### Patch Changes
327
+
328
+ - Add execution metadata to A2A message/send responses. The A2A protocol now returns detailed execution information including tool calls, tool results, token usage, and finish reason in the task metadata. This allows clients to inspect which tools were invoked during agent execution and access execution statistics without additional queries. ([#11241](https://github.com/mastra-ai/mastra/pull/11241))
329
+
330
+ - feat: Add field filtering and nested workflow control to workflow execution result endpoint ([#11246](https://github.com/mastra-ai/mastra/pull/11246))
331
+
332
+ Adds two optional query parameters to `/api/workflows/:workflowId/runs/:runId/execution-result` endpoint:
333
+ - `fields`: Request only specific fields (e.g., `status`, `result`, `error`)
334
+ - `withNestedWorkflows`: Control whether to fetch nested workflow data
335
+
336
+ This significantly reduces response payload size and improves response times for large workflows.
337
+
338
+ ## Server Endpoint Usage
339
+
340
+ ```http
341
+ # Get only status (minimal payload - fastest)
342
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status
343
+
344
+ # Get status and result
345
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status,result
346
+
347
+ # Get all fields but without nested workflow data (faster)
348
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?withNestedWorkflows=false
349
+
350
+ # Get only specific fields without nested workflow data
351
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status,steps&withNestedWorkflows=false
352
+
353
+ # Get full data (default behavior)
354
+ GET /api/workflows/:workflowId/runs/:runId/execution-result
355
+ ```
356
+
357
+ ## Client SDK Usage
358
+
359
+ ```typescript
360
+ import { MastraClient } from '@mastra/client-js';
361
+
362
+ const client = new MastraClient({ baseUrl: 'http://localhost:4111' });
363
+ const workflow = client.getWorkflow('myWorkflow');
364
+
365
+ // Get only status (minimal payload - fastest)
366
+ const statusOnly = await workflow.runExecutionResult(runId, {
367
+ fields: ['status'],
368
+ });
369
+ console.log(statusOnly.status); // 'success' | 'failed' | 'running' | etc.
370
+
371
+ // Get status and result
372
+ const statusAndResult = await workflow.runExecutionResult(runId, {
373
+ fields: ['status', 'result'],
374
+ });
375
+
376
+ // Get all fields but without nested workflow data (faster)
377
+ const resultWithoutNested = await workflow.runExecutionResult(runId, {
378
+ withNestedWorkflows: false,
379
+ });
380
+
381
+ // Get specific fields without nested workflow data
382
+ const optimized = await workflow.runExecutionResult(runId, {
383
+ fields: ['status', 'steps'],
384
+ withNestedWorkflows: false,
385
+ });
386
+
387
+ // Get full execution result (default behavior)
388
+ const fullResult = await workflow.runExecutionResult(runId);
389
+ ```
390
+
391
+ ## Core API Changes
392
+
393
+ The `Workflow.getWorkflowRunExecutionResult` method now accepts an options object:
394
+
395
+ ```typescript
396
+ await workflow.getWorkflowRunExecutionResult(runId, {
397
+ withNestedWorkflows: false, // default: true, set to false to skip nested workflow data
398
+ fields: ['status', 'result'], // optional field filtering
399
+ });
400
+ ```
401
+
402
+ ## Inngest Compatibility
403
+
404
+ The `@mastra/inngest` package has been updated to use the new options object API. This is a non-breaking internal change - no action required from inngest workflow users.
405
+
406
+ ## Performance Impact
407
+
408
+ For workflows with large step outputs:
409
+ - Requesting only `status`: ~99% reduction in payload size
410
+ - Requesting `status,result,error`: ~95% reduction in payload size
411
+ - Using `withNestedWorkflows=false`: Avoids expensive nested workflow data fetching
412
+ - Combining both: Maximum performance optimization
413
+
414
+ - Updated dependencies [[`4f94ed8`](https://github.com/mastra-ai/mastra/commit/4f94ed8177abfde3ec536e3574883e075423350c), [`ac3cc23`](https://github.com/mastra-ai/mastra/commit/ac3cc2397d1966bc0fc2736a223abc449d3c7719), [`a86f4df`](https://github.com/mastra-ai/mastra/commit/a86f4df0407311e0d2ea49b9a541f0938810d6a9), [`029540c`](https://github.com/mastra-ai/mastra/commit/029540ca1e582fc2dd8d288ecd4a9b0f31a954ef), [`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`01b20fe`](https://github.com/mastra-ai/mastra/commit/01b20fefb7c67c2b7d79417598ef4e60256d1225), [`0dbf199`](https://github.com/mastra-ai/mastra/commit/0dbf199110f22192ce5c95b1c8148d4872b4d119), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7)]:
415
+ - @mastra/core@1.0.0-beta.14
416
+
417
+ ## 1.0.0-beta.13
418
+
419
+ ### Patch Changes
420
+
421
+ - Updated dependencies [[`919a22b`](https://github.com/mastra-ai/mastra/commit/919a22b25876f9ed5891efe5facbe682c30ff497)]:
422
+ - @mastra/core@1.0.0-beta.13
423
+
424
+ ## 1.0.0-beta.12
425
+
426
+ ### Patch Changes
427
+
428
+ - Add resourceId to workflow routes ([#11166](https://github.com/mastra-ai/mastra/pull/11166))
429
+
430
+ - Fix MastraServer.tools typing to accept tools with input schemas ([`5118f38`](https://github.com/mastra-ai/mastra/commit/5118f384a70b1166012fde3b901f3227870b1009))
431
+
432
+ Fixes issue #11185 where `MastraServer.tools` was rejecting tools created with `createTool({ inputSchema })`. Changed the tools property type from `Record<string, Tool>` to `ToolsInput` to accept tools with any schema types (input, output, or none), as well as Vercel AI SDK tools and provider-defined tools.
433
+
434
+ Tools created with `createTool({ inputSchema: z.object(...) })` now work without TypeScript errors.
435
+
436
+ - Remove deprecated playground-only prompt generation handler (functionality moved to @mastra/server) ([#11074](https://github.com/mastra-ai/mastra/pull/11074))
437
+
438
+ Improve prompt enhancement UX: show toast errors when enhancement fails, disable button when no model has a configured API key, and prevent users from disabling all models in the model list
439
+
440
+ Add missing `/api/agents/:agentId/instructions/enhance` endpoint that was referenced by `@mastra/client-js` and `@mastra/playground-ui`
441
+
442
+ - Updated dependencies [[`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176)]:
443
+ - @mastra/core@1.0.0-beta.12
444
+
445
+ ## 1.0.0-beta.11
446
+
447
+ ### Patch Changes
448
+
449
+ - Fix type safety for message ordering - restrict `orderBy` to only accept `'createdAt'` field ([#11069](https://github.com/mastra-ai/mastra/pull/11069))
450
+
451
+ Messages don't have an `updatedAt` field, but the previous type allowed ordering by it, which would return empty results. This change adds compile-time type safety by making `StorageOrderBy` generic and restricting `StorageListMessagesInput.orderBy` to only accept `'createdAt'`. The API validation schemas have also been updated to reject invalid orderBy values at runtime.
452
+
453
+ - 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))
454
+
455
+ When a workflow contains an agent step that triggers a tripwire, the workflow returns with `status: 'tripwire'` and includes tripwire details:
456
+
457
+ ```typescript showLineNumbers copy
458
+ const run = await workflow.createRun();
459
+ const result = await run.start({ inputData: { message: 'Hello' } });
460
+
461
+ if (result.status === 'tripwire') {
462
+ console.log('Workflow terminated by tripwire:', result.tripwire?.reason);
463
+ console.log('Processor ID:', result.tripwire?.processorId);
464
+ console.log('Retry requested:', result.tripwire?.retry);
465
+ }
466
+ ```
467
+
468
+ Adds new UI state for tripwire in agent chat and workflow UI.
469
+
470
+ 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).
471
+
472
+ - Updated dependencies [[`38380b6`](https://github.com/mastra-ai/mastra/commit/38380b60fca905824bdf6b43df307a58efb1aa15), [`798d0c7`](https://github.com/mastra-ai/mastra/commit/798d0c740232653b1d754870e6b43a55c364ffe2), [`ffe84d5`](https://github.com/mastra-ai/mastra/commit/ffe84d54f3b0f85167fe977efd027dba027eb998), [`2c212e7`](https://github.com/mastra-ai/mastra/commit/2c212e704c90e2db83d4109e62c03f0f6ebd2667), [`4ca4306`](https://github.com/mastra-ai/mastra/commit/4ca430614daa5fa04730205a302a43bf4accfe9f), [`3bf6c5f`](https://github.com/mastra-ai/mastra/commit/3bf6c5f104c25226cd84e0c77f9dec15f2cac2db)]:
473
+ - @mastra/core@1.0.0-beta.11
474
+
475
+ ## 1.0.0-beta.10
476
+
477
+ ### Patch Changes
478
+
479
+ - ### Breaking Changes ([#11028](https://github.com/mastra-ai/mastra/pull/11028))
480
+ - Renamed `RuntimeContext` type to `ServerContext` to avoid confusion with the user-facing `RequestContext` (previously called `RuntimeContext`)
481
+ - Removed `playground` and `isDev` options from server adapter constructors - these only set context variables without any actual functionality
482
+
483
+ ### Changes
484
+
485
+ **@mastra/server**
486
+ - Renamed `RuntimeContext` type to `ServerContext` in route handler types
487
+ - Renamed `createTestRuntimeContext` to `createTestServerContext` in test utilities
488
+ - Renamed `isPlayground` parameter to `isStudio` in `formatAgent` function
489
+
490
+ **@mastra/hono**
491
+ - Removed `playground` and `isDev` from `HonoVariables` type
492
+ - Removed setting of `playground` and `isDev` context variables in middleware
493
+
494
+ **@mastra/express**
495
+ - Removed `playground` and `isDev` from `Express.Locals` interface
496
+ - Removed setting of `playground` and `isDev` in response locals
497
+
498
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
499
+
500
+ ```typescript
501
+ await workflow.deleteWorkflowRunById(runId);
502
+ ```
503
+
504
+ - Updated dependencies [[`edb07e4`](https://github.com/mastra-ai/mastra/commit/edb07e49283e0c28bd094a60e03439bf6ecf0221), [`b7e17d3`](https://github.com/mastra-ai/mastra/commit/b7e17d3f5390bb5a71efc112204413656fcdc18d), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`5d7000f`](https://github.com/mastra-ai/mastra/commit/5d7000f757cd65ea9dc5b05e662fd83dfd44e932), [`4f0331a`](https://github.com/mastra-ai/mastra/commit/4f0331a79bf6eb5ee598a5086e55de4b5a0ada03), [`8a000da`](https://github.com/mastra-ai/mastra/commit/8a000da0c09c679a2312f6b3aa05b2ca78ca7393)]:
505
+ - @mastra/core@1.0.0-beta.10
506
+
507
+ ## 1.0.0-beta.9
508
+
509
+ ### Minor Changes
510
+
511
+ - Add stored agents support ([#10953](https://github.com/mastra-ai/mastra/pull/10953))
512
+
513
+ Agents can now be stored in the database and loaded at runtime. This lets you persist agent configurations and dynamically create executable Agent instances from storage.
514
+
515
+ ```typescript
516
+ import { Mastra } from '@mastra/core';
517
+ import { LibSQLStore } from '@mastra/libsql';
518
+
519
+ const mastra = new Mastra({
520
+ storage: new LibSQLStore({ url: ':memory:' }),
521
+ tools: { myTool },
522
+ scorers: { myScorer },
523
+ });
524
+
525
+ // Create agent in storage via API or directly
526
+ await mastra.getStorage().createAgent({
527
+ agent: {
528
+ id: 'my-agent',
529
+ name: 'My Agent',
530
+ instructions: 'You are helpful',
531
+ model: { provider: 'openai', name: 'gpt-4' },
532
+ tools: { myTool: {} },
533
+ scorers: { myScorer: { sampling: { type: 'ratio', rate: 0.5 } } },
534
+ },
535
+ });
536
+
537
+ // Load and use the agent
538
+ const agent = await mastra.getStoredAgentById('my-agent');
539
+ const response = await agent.generate({ messages: 'Hello!' });
540
+
541
+ // List all stored agents with pagination
542
+ const { agents, total, hasMore } = await mastra.listStoredAgents({
543
+ page: 0,
544
+ perPage: 10,
545
+ });
546
+ ```
547
+
548
+ Also adds a memory registry to Mastra so stored agents can reference memory instances by key.
549
+
550
+ ### Patch Changes
551
+
552
+ - Updated dependencies [[`72df8ae`](https://github.com/mastra-ai/mastra/commit/72df8ae595584cdd7747d5c39ffaca45e4507227), [`9198899`](https://github.com/mastra-ai/mastra/commit/91988995c427b185c33714b7f3be955367911324), [`653e65a`](https://github.com/mastra-ai/mastra/commit/653e65ae1f9502c2958a32f47a5a2df11e612a92), [`c6fd6fe`](https://github.com/mastra-ai/mastra/commit/c6fd6fedd09e9cf8004b03a80925f5e94826ad7e), [`0bed332`](https://github.com/mastra-ai/mastra/commit/0bed332843f627202c6520eaf671771313cd20f3)]:
553
+ - @mastra/core@1.0.0-beta.9
554
+
555
+ ## 1.0.0-beta.8
556
+
557
+ ### Patch Changes
558
+
559
+ - Updated dependencies [[`0d41fe2`](https://github.com/mastra-ai/mastra/commit/0d41fe245355dfc66d61a0d9c85d9400aac351ff), [`6b3ba91`](https://github.com/mastra-ai/mastra/commit/6b3ba91494cc10394df96782f349a4f7b1e152cc), [`7907fd1`](https://github.com/mastra-ai/mastra/commit/7907fd1c5059813b7b870b81ca71041dc807331b)]:
560
+ - @mastra/core@1.0.0-beta.8
561
+
562
+ ## 1.0.0-beta.7
563
+
564
+ ### Patch Changes
565
+
566
+ - fix: standardize pagination params to page/perPage with backwards compatibility for limit/offset ([#10790](https://github.com/mastra-ai/mastra/pull/10790))
567
+ - Server now accepts both `page`/`perPage` and legacy `limit`/`offset` params for workflow runs and MCP server listing endpoints
568
+ - Client SDK sends both param formats to support older server versions
569
+ - Added `createCombinedPaginationSchema` helper for endpoints needing backwards compatibility
570
+ - Marked `limit` and `offset` as deprecated in client types
571
+
572
+ - feat: Add partial response support for agent and workflow list endpoints ([#10886](https://github.com/mastra-ai/mastra/pull/10886))
573
+
574
+ Add optional `partial` query parameter to `/api/agents` and `/api/workflows` endpoints to return minimal data without schemas, reducing payload size for list views:
575
+ - When `partial=true`: tool schemas (inputSchema, outputSchema) are omitted
576
+ - When `partial=true`: workflow steps are replaced with stepCount integer
577
+ - When `partial=true`: workflow root schemas (inputSchema, outputSchema) are omitted
578
+ - Maintains backward compatibility when partial parameter is not provided
579
+
580
+ ## Server Endpoint Usage
581
+
582
+ ```http
583
+ # Get partial agent data (no tool schemas)
584
+ GET /api/agents?partial=true
585
+
586
+ # Get full agent data (default behavior)
587
+ GET /api/agents
588
+
589
+ # Get partial workflow data (stepCount instead of steps, no schemas)
590
+ GET /api/workflows?partial=true
591
+
592
+ # Get full workflow data (default behavior)
593
+ GET /api/workflows
594
+ ```
595
+
596
+ ## Client SDK Usage
597
+
598
+ ```typescript
599
+ import { MastraClient } from '@mastra/client-js';
600
+
601
+ const client = new MastraClient({ baseUrl: 'http://localhost:4111' });
602
+
603
+ // Get partial agent list (smaller payload)
604
+ const partialAgents = await client.listAgents({ partial: true });
605
+
606
+ // Get full agent list with tool schemas
607
+ const fullAgents = await client.listAgents();
608
+
609
+ // Get partial workflow list (smaller payload)
610
+ const partialWorkflows = await client.listWorkflows({ partial: true });
611
+
612
+ // Get full workflow list with steps and schemas
613
+ const fullWorkflows = await client.listWorkflows();
614
+ ```
615
+
616
+ - Updated dependencies [[`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
617
+ - @mastra/core@1.0.0-beta.7
618
+
619
+ ## 1.0.0-beta.6
620
+
621
+ ### Patch Changes
622
+
623
+ - Unified MastraServer API with MCP transport routes ([#10644](https://github.com/mastra-ai/mastra/pull/10644))
624
+
625
+ **Breaking Changes:**
626
+ - Renamed `HonoServerAdapter` to `MastraServer` in `@mastra/hono`
627
+ - Renamed `ExpressServerAdapter` to `MastraServer` in `@mastra/express`
628
+ - Configuration now passed to constructor instead of separate method calls
629
+ - Renamed base class from `ServerAdapter` to `MastraServerBase` in `@mastra/server`
630
+
631
+ **New Features:**
632
+ - Added MCP transport routes (HTTP and SSE) to server adapters
633
+ - MCP endpoints available at `/api/mcp/:serverId/mcp` (HTTP) and `/api/mcp/:serverId/sse` (SSE)
634
+ - Added `express.json()` middleware compatibility for MCP routes
635
+ - Moved authentication helpers from deployer to `@mastra/server/auth`
636
+
637
+ **Testing:**
638
+ - Added shared MCP route and transport test suites in `@internal/server-adapter-test-utils`
639
+ - Added comprehensive MCP endpoint tests for both Hono and Express adapters
640
+ - Added GitHub Actions workflow for server adapter CI testing
641
+
642
+ - Allow direct access to server app handle directly from Mastra instance. ([#10598](https://github.com/mastra-ai/mastra/pull/10598))
643
+
644
+ ```ts
645
+ // Before: HTTP request to localhost
646
+ const response = await fetch(`http://localhost:5000/api/tools`);
647
+
648
+ // After: Direct call via app.fetch()
649
+ const app = mastra.getServerApp<Hono>();
650
+ const response = await app.fetch(new Request('http://internal/api/tools'));
651
+ ```
652
+
653
+ - Added `mastra.getServerApp<T>()` to access the underlying Hono/Express app
654
+ - Added `mastra.getMastraServer()` and `mastra.setMastraServer()` for adapter access
655
+ - Added `MastraServerBase` class in `@mastra/core/server` for adapter implementations
656
+ - Server adapters now auto-register with Mastra in their constructor
657
+
658
+ - fix(a2a): fix streaming and memory support for A2A protocol ([#10653](https://github.com/mastra-ai/mastra/pull/10653))
659
+
660
+ **Client (`@mastra/client-js`):**
661
+ - Fixed `sendStreamingMessage` to properly return a streaming response instead of attempting to parse it as JSON
662
+
663
+ **Server (`@mastra/server`):**
664
+ - Fixed A2A message handler to pass `contextId` as `threadId` for memory persistence across conversations
665
+ - Added support for user-provided `resourceId` via `params.metadata.resourceId` or `message.metadata.resourceId`, falling back to `agentId`
666
+
667
+ - Add stream data redaction to prevent sensitive information leaks in agent stream API responses. ([#10705](https://github.com/mastra-ai/mastra/pull/10705))
668
+
669
+ The `stream` API endpoint now automatically redacts `request` data from stream chunks (`step-start`, `step-finish`, `finish`) which could contain system prompts, tool definitions, and API keys. Redaction is enabled by default and can be disabled for debugging/internal services via `streamOptions.redact`.
670
+
671
+ - Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
672
+ - @mastra/core@1.0.0-beta.6
673
+
674
+ ## 1.0.0-beta.5
675
+
676
+ ### Patch Changes
677
+
678
+ - Extract routing from @deployer/server into server adapter packages. ([#10263](https://github.com/mastra-ai/mastra/pull/10263))
679
+ New packages:
680
+ - @mastra/express
681
+ - @mastra/hono
682
+
683
+ These packages support mastra server routes on express and hono respectively.
684
+ Better abstractions will be built on top of these packages in the near future, enabling users to easily attach mastra routes to any existing server framework.
685
+
686
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
687
+
688
+ - Fixed server handler bugs: filter parsing now handles colons in values (timestamps, URLs), dateRange validation now converts JSON strings to Date objects, deleteMessages schema accepts object forms, and added missing responseSchema for legacy stream route ([#10362](https://github.com/mastra-ai/mastra/pull/10362))
689
+
690
+ - Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
691
+ - @mastra/core@1.0.0-beta.5
692
+
693
+ ## 1.0.0-beta.4
694
+
695
+ ### Patch Changes
696
+
697
+ - Network handler now accesses thread and resource parameters from the nested memory object instead of directly from request body. ([#10294](https://github.com/mastra-ai/mastra/pull/10294))
698
+
699
+ - Updated dependencies [[`352a5d6`](https://github.com/mastra-ai/mastra/commit/352a5d625cfe09849b21e8f52a24c9f0366759d5), [`a0a5b4b`](https://github.com/mastra-ai/mastra/commit/a0a5b4bbebe6c701ebbadf744873aa0d5ca01371), [`69ea758`](https://github.com/mastra-ai/mastra/commit/69ea758358edd7117f191c2e69c8bb5fc79e7a1a), [`993ad98`](https://github.com/mastra-ai/mastra/commit/993ad98d7ad3bebda9ecef5fec5c94349a0d04bc), [`3ff2c17`](https://github.com/mastra-ai/mastra/commit/3ff2c17a58e312fad5ea37377262c12d92ca0908)]:
700
+ - @mastra/core@1.0.0-beta.4
701
+
702
+ ## 1.0.0-beta.3
703
+
704
+ ### Patch Changes
705
+
706
+ - Fix semantic search endpoint to return results in the correct format. Also fix the delete messages endpoint to properly normalize ids in the expected format. ([#10032](https://github.com/mastra-ai/mastra/pull/10032))
707
+
708
+ - Updated dependencies [[`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4)]:
709
+ - @mastra/core@1.0.0-beta.3
710
+
3
711
  ## 1.0.0-beta.2
4
712
 
5
713
  ### Patch Changes