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

package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md

@@ -1,5 +1,7 @@
 # @internal/changeset-cli
 
+## 0.0.4
+
 ## 0.0.3
 
 ## 0.0.2

package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md

@@ -1,5 +1,12 @@
 # @internal/lint
 
+## 0.0.46
+
+### Patch Changes
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.0.45
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 ## 0.0.18
 
-### Patch Changes
-
-- @mastra/core@0.11.1
-
-## 0.0.17
-
-### Patch Changes
 
-... 391 more lines hidden. See full changelog in package directory.
+... 398 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md

@@ -1,5 +1,7 @@
 # @internal/types-builder
 
+## 0.0.25
+
 ## 0.0.24
 
 ## 0.0.23

package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md

@@ -1,5 +1,14 @@
 # @mastra/ai-sdk
 
+## 0.2.1
+
+### Patch Changes
+
+- Update README to include more usage examples ([#8817](https://github.com/mastra-ai/mastra/pull/8817))
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.2.1-alpha.0
 
 ### Patch Changes
@@ -290,9 +299,4 @@
 
 ## 0.0.1-alpha.0
 
-### Patch Changes
-
-- [#7263](https://github.com/mastra-ai/mastra/pull/7263) [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c) Thanks [@wardpeet](https://github.com/wardpeet)! - Create new `@mastra/ai-sdk` package to better support `useChat()`
-
-- Updated dependencies [[`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715), [`ff89505`](https://github.com/mastra-ai/mastra/commit/ff895057c8c7e91a5535faef46c5e5391085ddfa), [`183dc95`](https://github.com/mastra-ai/mastra/commit/183dc95596f391b977bd1a2c050b8498dac74891), [`a1111e2`](https://github.com/mastra-ai/mastra/commit/a1111e24e705488adfe5e0a6f20c53bddf26cb22), [`61debef`](https://github.com/mastra-ai/mastra/commit/61debefd80ad3a7ed5737e19df6a23d40091689a), [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c), [`9eee594`](https://github.com/mastra-ai/mastra/commit/9eee594e35e0ca2a650fcc33fa82009a142b9ed0), [`979912c`](https://github.com/mastra-ai/mastra/commit/979912cfd180aad53287cda08af771df26454e2c), [`7dcf4c0`](https://github.com/mastra-ai/mastra/commit/7dcf4c04f44d9345b1f8bc5d41eae3f11ac61611), [`ad78bfc`](https://github.com/mastra-ai/mastra/commit/ad78bfc4ea6a1fff140432bf4f638e01af7af668), [`0ce418a`](https://github.com/mastra-ai/mastra/commit/0ce418a1ccaa5e125d4483a9651b635046152569), [`8387952`](https://github.com/mastra-ai/mastra/commit/838795227b4edf758c84a2adf6f7fba206c27719), [`5eca5d2`](https://github.com/mastra-ai/mastra/commit/5eca5d2655788863ea0442a46c9ef5d3c6dbe0a8)]:
-  - @mastra/core@0.15.3-alpha.4
+... 8 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.16.1
+
+### Patch Changes
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.16.1-alpha.0
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 ## 0.13.1
 
-### Patch Changes
-
-- fix workflow resuming issue in the playground ([#7988](https://github.com/mastra-ai/mastra/pull/7988))
-
-- Updated dependencies [[`fd00e63`](https://github.com/mastra-ai/mastra/commit/fd00e63759cbcca3473c40cac9843280b0557cff), [`ab610f6`](https://github.com/mastra-ai/mastra/commit/ab610f6f41dbfe6c9502368671485ca7a0aac09b), [`e6bda5f`](https://github.com/mastra-ai/mastra/commit/e6bda5f954ee8493ea18adc1a883f0a5b785ad9b)]:
-  - @mastra/core@0.17.1
-
 
-... 2906 more lines hidden. See full changelog in package directory.
+... 2913 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,17 @@
 # @mastra/core
 
+## 0.21.1
+
+### Patch Changes
+
+- Update provider registry with latest models and providers ([`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a))
+
+- Update provider registry and model documentation with latest models and providers ([`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2))
+
+- Ability to call agents as tools with .generate()/.stream() ([#8863](https://github.com/mastra-ai/mastra/pull/8863))
+
+- Add runId to `agent-execution-event-{string}` and `workflow-execution-event-{string}` event streamed in network ([#8862](https://github.com/mastra-ai/mastra/pull/8862))
+
 ## 0.21.1-alpha.0
 
 ### Patch Changes
@@ -287,16 +299,4 @@
 
 - Marked OTEL based telemetry as deprecated. ([#8586](https://github.com/mastra-ai/mastra/pull/8586))
 
-- Add support for streaming nested agent tools ([#8580](https://github.com/mastra-ai/mastra/pull/8580))
-
-- Fix TypeScript errors with provider-defined tools by updating ai-v5 and openai-v5 to matching provider-utils versions. This ensures npm deduplicates to a single provider-utils instance, resolving type incompatibility issues when passing provider tools to Agent. ([#8584](https://github.com/mastra-ai/mastra/pull/8584))
-
-  Also adds deprecation warning to Agent import from root path to encourage using the recommended subpath import.
-
-- UX for the agents page ([#8517](https://github.com/mastra-ai/mastra/pull/8517))
-
-- add icons into playground titles + a link to the entity doc ([#8518](https://github.com/mastra-ai/mastra/pull/8518))
-
-## 0.20.1-alpha.4
-
-... 4246 more lines hidden. See full changelog in package directory.
+... 4258 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md

@@ -1,5 +1,13 @@
 # @mastra/deployer-cloud
 
+## 0.21.1
+
+### Patch Changes
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
 ## 0.21.1-alpha.0
 
 ### Patch Changes
@@ -291,12 +299,4 @@
 
 ## 0.17.2-alpha.1
 
-### Patch Changes
-
-- dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
-  - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
-- Updated dependencies [[`288745a`](https://github.com/mastra-ai/mastra/commit/288745a19aa9557db3ab3c877d667ff59f14d79c), [`c45298a`](https://github.com/mastra-ai/mastra/commit/c45298a0a0791db35cf79f1199d77004da0704cb)]:
-  - @mastra/deployer@0.17.2-alpha.1
-  - @mastra/core@0.17.2-alpha.1
-
-... 490 more lines hidden. See full changelog in package directory.
+... 498 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md

@@ -1,5 +1,17 @@
 # @mastra/deployer-cloudflare
 
+## 0.14.9
+
+### Patch Changes
+
+- Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
+  - Hotfix a bug inside `@rollup/plugin-commonjs`
+  - Have more control over the versions in the future to not have breakages over night
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
 ## 0.14.9-alpha.0
 
 ### Patch Changes
@@ -286,17 +298,5 @@
   - @mastra/core@0.16.3
   - @mastra/deployer@0.16.3
 
-## 0.13.7-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`0666082`](https://github.com/mastra-ai/mastra/commit/06660820230dcb1fa7c1d51c8254107afd68cd67), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
-  - @mastra/core@0.16.3-alpha.0
-  - @mastra/deployer@0.16.3-alpha.0
-
-## 0.13.6
-
-### Patch Changes
-
 
-... 3844 more lines hidden. See full changelog in package directory.
+... 3856 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md

@@ -1,5 +1,17 @@
 # @mastra/deployer-netlify
 
+## 0.13.9
+
+### Patch Changes
+
+- Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
+  - Hotfix a bug inside `@rollup/plugin-commonjs`
+  - Have more control over the versions in the future to not have breakages over night
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
 ## 0.13.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +299,4 @@
   - @mastra/core@0.16.3-alpha.0
   - @mastra/deployer@0.16.3-alpha.0
 
-## 0.12.6
-
-### Patch Changes
-
-- Updated dependencies [[`61926ef`](https://github.com/mastra-ai/mastra/commit/61926ef40d415b805a63527cffe27a50542e15e5)]:
-  - @mastra/core@0.16.2
-  - @mastra/deployer@0.16.2
-
-## 0.12.6-alpha.0
-
-### Patch Changes
-
-... 3581 more lines hidden. See full changelog in package directory.
+... 3593 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md

@@ -1,5 +1,17 @@
 # @mastra/deployer-vercel
 
+## 0.12.9
+
+### Patch Changes
+
+- Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
+  - Hotfix a bug inside `@rollup/plugin-commonjs`
+  - Have more control over the versions in the future to not have breakages over night
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
 ## 0.12.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`0666082`](https://github.com/mastra-ai/mastra/commit/06660820230dcb1fa7c1d51c8254107afd68cd67), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
-  - @mastra/core@0.16.3-alpha.0
-  - @mastra/deployer@0.16.3-alpha.0
-
-## 0.11.22
-
-### Patch Changes
-
-- Updated dependencies [[`61926ef`](https://github.com/mastra-ai/mastra/commit/61926ef40d415b805a63527cffe27a50542e15e5)]:
-  - @mastra/core@0.16.2
-  - @mastra/deployer@0.16.2
-
-... 3539 more lines hidden. See full changelog in package directory.
+... 3551 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,21 @@
 # @mastra/deployer
 
+## 0.21.1
+
+### Patch Changes
+
+- Add undici to global external list ([#8877](https://github.com/mastra-ai/mastra/pull/8877))
+
+- Small fix for adding ESM shims when e.g. `__dirname` is used ([#8898](https://github.com/mastra-ai/mastra/pull/8898))
+
+- Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
+  - Hotfix a bug inside `@rollup/plugin-commonjs`
+  - Have more control over the versions in the future to not have breakages over night
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+  - @mastra/server@0.21.1
+
 ## 0.21.1-alpha.0
 
 ### Patch Changes
@@ -282,21 +298,5 @@
 
 - Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
   - @mastra/core@0.20.0-alpha.0
-  - @mastra/server@0.20.0-alpha.0
-
-## 0.19.1
-
-### Patch Changes
-
-- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
-
-- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead), [`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
-  - @mastra/core@0.19.1
-  - @mastra/server@0.19.1
-
-## 0.19.1-alpha.1
-
-### Patch Changes
-
 
-... 4729 more lines hidden. See full changelog in package directory.
+... 4745 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.31
+
+### Patch Changes
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.13.31-alpha.0
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 - Updated dependencies [[`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
   - @mastra/core@0.17.0-alpha.3
-  - @mastra/mcp@0.12.1-alpha.0
-
-## 0.13.22-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
 
-... 2040 more lines hidden. See full changelog in package directory.
+... 2047 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fpg.md

@@ -1,5 +1,14 @@
 # @mastra/pg
 
+## 0.17.4
+
+### Patch Changes
+
+- Add configuration documentation and tests for PgVector and PostgresStore, including examples for connection methods, SSL configuration, and pool options ([#8723](https://github.com/mastra-ai/mastra/pull/8723))
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.17.4-alpha.0
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 ### Patch Changes
 
 - Updated dependencies [8fbf79e]
-  - @mastra/core@0.16.0-alpha.1
-
-## 0.14.7-alpha.0
-
-### Patch Changes
-
-- 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
-- Updated dependencies [fd83526]
-- Updated dependencies [d0b90ab]
 
-... 2525 more lines hidden. See full changelog in package directory.
+... 2534 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,16 @@
 # @mastra/playground-ui
 
+## 6.5.1
+
+### Patch Changes
+
+- Add @mastra/react to peer deps ([#8857](https://github.com/mastra-ai/mastra/pull/8857))
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`9ba695e`](https://github.com/mastra-ai/mastra/commit/9ba695e9ff977b8f13cc71df3b452775757361e5), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+  - @mastra/react@0.0.7
+  - @mastra/client-js@0.16.1
+
 ## 6.5.1-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [[`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0)]:
   - @mastra/core@0.20.1-alpha.0
   - @mastra/client-js@0.15.1-alpha.0
-  - @mastra/react@0.0.4-alpha.0
-
-## 6.3.0
-
-### Minor Changes
-
-- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
-
-### Patch Changes
-
-- dependencies updates: ([#8298](https://github.com/mastra-ai/mastra/pull/8298))
 
-... 3698 more lines hidden. See full changelog in package directory.
+... 3709 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Freact.md

@@ -1,5 +1,14 @@
 # @mastra/react-hooks
 
+## 0.0.7
+
+### Patch Changes
+
+- Add @mastra/react to peer deps ([#8857](https://github.com/mastra-ai/mastra/pull/8857))
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.1
+
 ## 0.0.7-alpha.0
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 0.21.1
+
+### Patch Changes
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.21.1-alpha.0
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ## 0.18.0-alpha.3
 
-### Patch Changes
-
-- Add model fallback handlers and apis ([#7378](https://github.com/mastra-ai/mastra/pull/7378))
-
-- Delayed streamVNext breaking change notice by 1 week ([#8121](https://github.com/mastra-ai/mastra/pull/8121))
-
-
-... 3749 more lines hidden. See full changelog in package directory.
+... 3756 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,13 @@
 # create-mastra
 
+## 0.17.0
+
+### Patch Changes
+
+- Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
+  - Hotfix a bug inside `@rollup/plugin-commonjs`
+  - Have more control over the versions in the future to not have breakages over night
+
 ## 0.17.0-alpha.0
 
 ### Patch Changes
@@ -291,12 +299,4 @@
 
 - Fix getting tool link path from agent in playground ui tools page ([#8135](https://github.com/mastra-ai/mastra/pull/8135))
 
-## 0.13.2-alpha.3
-
-### Patch Changes
-
-- Add model fallback handlers and apis ([#7378](https://github.com/mastra-ai/mastra/pull/7378))
-
-- Fix DateTimePicker style issue ([#8106](https://github.com/mastra-ai/mastra/pull/8106))
-
-... 1742 more lines hidden. See full changelog in package directory.
+... 1750 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,20 @@
 # mastra
 
+## 0.17.0
+
+### Minor Changes
+
+- - Remove the `mastra deploy` CLI command. Use the deploy instructions of your individual platform. ([#8798](https://github.com/mastra-ai/mastra/pull/8798))
+  - Remove `--env` flag from `mastra build` command
+  - Remove `--port` flag from `mastra dev`. Use `server.port` on the `new Mastra()` class instead.
+  - Validate `--components` and `--llm` flags for `mastra create` and `mastra init`
+
+### Patch Changes
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
 ## 0.17.0-alpha.0
 
 ### Minor Changes
@@ -283,20 +298,5 @@
 - Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
 
   **Documentation generation (`@mastra/core`):**
-  - Fixed inverted dynamic model selection logic in provider examples
-  - Improved copy: replaced marketing language with action-oriented descriptions
-  - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
-
-  **Playground UI model picker (`@mastra/playground-ui`):**
-  - Fixed provider field clearing when typing in model input
-  - Added responsive layout (stacks on mobile, side-by-side on desktop)
-  - Improved general styling of provider/model pickers
-
-  **Environment variables (`@mastra/deployer`):**
-  - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
-  - Added correct singular/plural handling for "environment variable(s)"
-
-- fix playground message history initial state for v1 models ([#8427](https://github.com/mastra-ai/mastra/pull/8427))
-
 
-... 6203 more lines hidden. See full changelog in package directory.
+... 6218 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/overview.mdx

@@ -137,7 +137,7 @@ instructions: {
 
 Register your agent in the Mastra instance to make it available throughout your application. Once registered, it can be called from workflows, tools, or other agents, and has access to shared resources such as memory, logging, and observability features:
 
-```typescript showLineNumbers filename="src/mastra/index.ts" copy
+```typescript {6} showLineNumbers filename="src/mastra/index.ts" copy
 import { Mastra } from "@mastra/core/mastra";
 import { testAgent } from './agents/test-agent';
 
@@ -156,7 +156,7 @@ const testAgent = mastra.getAgent("testAgent");
 ```
 <Callout type="info">
   <p>
-    `mastra.getAgent()` is preferred over a direct import, since it preserves the Mastra instance configuration (tools registered, telemetry, vector stores configuration for agent memory, etc.)
+    `mastra.getAgent()` is preferred over a direct import, since it provides access to the Mastra instance configuration (logger, telemetry, storage, registered agents, and vector stores).
   </p>
 </Callout>
 
@@ -412,42 +412,9 @@ export const testAgent = new Agent({
 
 > See [Runtime Context](../server-db/runtime-context.mdx) for more information.
 
-## Testing agents locally
-There are two ways to run and test agents.
+## Testing with Mastra Playground
 
-<Steps>
-
-### Mastra Playground
-
-With the Mastra Dev Server running you can test an agent from the Mastra Playground by visiting [http://localhost:4111/agents](http://localhost:4111/agents) in your browser.
-
-> For more information, see the [Local Dev Playground](/docs/server-db/local-dev-playground) documentation.
-
-### Command line
-
-Create an agent response using `.generate()` or `.stream()`.
-
-```typescript {7} filename="src/test-agent.ts" showLineNumbers copy
-import "dotenv/config";
-
-import { mastra } from "./mastra";
-
-const agent = mastra.getAgent("testAgent");
-
-const response = await agent.generate("Help me organize my day");
-
-console.log(response.text);
-```
-
-> See [.generate()](../../reference/agents/generate.mdx) or [.stream()](../../reference/agents/stream.mdx) for more information.
-
-To test this agent, run the following:
-
-```bash copy
-npx tsx src/test-agent.ts
-```
-
-</Steps>
+Use the Mastra [Playground](../server-db/local-dev-playground.mdx) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
 
 ## Related
 

package/.docs/raw/tools-mcp/overview.mdx

@@ -87,43 +87,7 @@ export const testTool = createTool({
 
 > See [Runtime Context](../server-db/runtime-context.mdx) for more information.
 
-## Testing tools locally
-There are two ways to run and test tools.
+## Testing with Mastra Playground
 
-<Steps>
+Use the Mastra [Playground](../server-db/local-dev-playground.mdx) to test tools with different inputs, inspect execution results, and verify tool behavior.
 
-### Mastra Playground
-
-With the Mastra Dev Server running you can test a tool from the Mastra Playground by visiting [http://localhost:4111/tools](http://localhost:4111/tools) in your browser.
-
-> For more information, see the [Local Dev Playground](/docs/server-db/local-dev-playground) documentation.
-
-### Command line
-
-Invoke a tool using `.execute()`.
-
-```typescript filename="src/test-tool.ts" showLineNumbers copy
-import { RuntimeContext } from "@mastra/core/runtime-context";
-import { testTool } from "./mastra/tools/test-tool";
-
-const runtimeContext = new RuntimeContext();
-
-const result = await testTool.execute({
-  context: {
-    value: "foo"
-  },
-  runtimeContext
-});
-
-console.log(result);
-```
-
-> See [createTool()](../../reference/tools/create-tool.mdx) for more information.
-
-To test this tool, run the following:
-
-```bash copy
-npx tsx src/test-tool.ts
-```
-
-</Steps>

package/.docs/raw/workflows/overview.mdx

@@ -3,360 +3,268 @@ title: "Handling Complex LLM Operations | Workflows | Mastra"
 description: "Workflows in Mastra help you orchestrate complex sequences of tasks with features like branching, parallel execution, resource suspension, and more."
 ---
 
-import { Steps } from "nextra/components";
+import { Steps, Callout, Tabs } from "nextra/components";
 
 # Workflows overview
 
-Workflows allow you to define and manage complex sequences of tasks by connecting them with clear, structured processes. Unlike a single agent, which operates independently, workflows enable you to orchestrate multiple steps with specific logic, tools, and external services. This approach provides more control and predictability, ensuring consistent results by allowing you to determine what tasks are performed and when they are completed.
+Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down, how data moves between them, and what gets executed when.
 
 ![Workflows overview](/image/workflows/workflows-overview.jpg)
 
-## When to use a workflow
+## When to use workflows
 
-For example, you might want to perform a sequence of tasks:
+Use workflows for tasks that are clearly defined upfront and involve multiple steps with a specific execution order. They give you fine-grained control over how data flows and transforms between steps, and which primitives are called at each stage.
 
-1. Handle a user question like “Can I return my last order?”
-2. Fetch user-specific data from a database using their `user_id`.
-3. Check return eligibility via an external API or business logic.
-4. Make a conditional decision (e.g. approve, deny, escalate) based on the data.
-5. Generate a tailored response based on the outcome.
 
-Each of these tasks is created as a **step** in a workflow, giving you fine-grained control over data flow, execution order, and side effects.
 
 > **📹 Watch**:  → An introduction to workflows, and how they compare to agents [YouTube (7 minutes)](https://youtu.be/0jg2g3sNvgw)
 
-## Building workflows
+## Core principles
 
-You create workflows by:
+Mastra workflows operate using these principles:
 
 - Defining **steps** with `createStep`, specifying input/output schemas and business logic.
 - Composing **steps** with `createWorkflow` to define the execution flow.
 - Running **workflows** to execute the entire sequence, with built-in support for suspension, resumption, and streaming results.
 
-This structure provides full type safety and runtime validation, ensuring data integrity across the entire workflow.
+## Creating a workflow step
 
-### Visual testing
+Steps are the building blocks of workflows. Create a step using `createStep()` with `inputSchema` and `outputSchema` to define the data it accepts and returns.
 
-Use the [Playground](../server-db/local-dev-playground.mdx#workflows) to visualize workflow execution in real time. It shows which steps are running, completed, or suspended.
+```typescript {6,9,14} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+import { createStep } from "@mastra/core/workflows";
 
-
-## Getting started
-
-To use workflows, install the required dependencies:
-
-```bash
-npm install @mastra/core
-```
-
-Import the necessary functions from the `workflows` subpath:
-
-```typescript filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
-import { createWorkflow, createStep } from "@mastra/core/workflows";
-import { z } from "zod";
-```
-
-### Create step
-
-Steps are the building blocks of workflows. Create a step using `createStep`:
-
-```typescript filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
-const step1 = createStep({...});
-```
-
-> See [createStep](../../reference/workflows/step.mdx) for more information.
-
-### Create workflow
-
-Create a workflow using `createWorkflow` and complete it with `.commit()`.
-
-```typescript {6,17} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
-import { createWorkflow, createStep } from "@mastra/core/workflows";
-import { z } from "zod";
-
-const step1 = createStep({...});
-
-export const testWorkflow = createWorkflow({
-  id: "test-workflow",
-  description: 'Test workflow',
+const step1 = createStep({
+  id: "step-1",
   inputSchema: z.object({
-    input: z.string()
+    message: z.string()
   }),
   outputSchema: z.object({
-    output: z.string()
+    formatted: z.string()
   }),
-  options: {
-    // enables runtime validation of inputs and applies zod default values.
-    validateInputs: true, 
+  execute: async ({ inputData }) => {
+    const { message } = inputData;
+    return {
+      formatted: message.toUpperCase()
+    };
   }
-})
-  .then(step1)
-  .commit();
+});
 ```
 
-> See [workflow](../../reference/workflows/workflow.mdx) for more information.
+> See the [Step Class](../../reference/workflows/step.mdx) for a full list of configuration options.
 
-#### Composing steps
+## Creating a workflow
 
-Workflow steps can be composed and executed sequentially using `.then()`.
+Create a workflow using `createWorkflow()` with `inputSchema` and `outputSchema` to define the data it accepts and returns. Add steps using `.then()` and complete the workflow with `.commit()`.
 
-```typescript {17,18} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {9,12,15,16} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
 const step1 = createStep({...});
-const step2 = createStep({...});
 
 export const testWorkflow = createWorkflow({
   id: "test-workflow",
-  description: 'Test workflow',
   inputSchema: z.object({
-    input: z.string()
+    message: z.string()
   }),
   outputSchema: z.object({
     output: z.string()
   })
 })
   .then(step1)
-  .then(step2)
   .commit();
+
 ```
 
-> Steps can be composed using a number of different methods. See [Control Flow](./control-flow.mdx)  for more information.
+> See the [Workflow Class](../../reference/workflows/workflow.mdx) for a full list of configuration options.
 
-#### Cloning steps
+### Understanding control flow
 
-Workflow steps can be cloned using `cloneStep()`, and used with any workflow method.
+Workflows can be composed using a number of different methods. The method you choose determines how each step's schema should be structured.
 
-```typescript {5,19} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
-import { createWorkflow, createStep, cloneStep } from "@mastra/core/workflows";
-import { z } from "zod";
+> See [Control Flow](./control-flow.mdx) for more information.
 
-const step1 = createStep({...});
-const clonedStep = cloneStep(step1, { id: "cloned-step" });
-const step2 = createStep({...});
+#### Composing steps
+
+When using `.then()`, steps run sequentially. The `inputSchema` of each step must match the `outputSchema` of the step before it. The final step’s `outputSchema` doesn’t need to match the workflow’s `outputSchema`, which can be defined independently.
+
+```typescript {4,7,14,17,24,27} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const step1 = createStep({
+  //...
+  inputSchema: z.object({
+    message: z.string()
+  }),
+  outputSchema: z.object({
+    formatted: z.string()
+  })
+});
+
+const step2 = createStep({
+  // ...
+  inputSchema: z.object({
+    formatted: z.string()
+  }),
+  outputSchema: z.object({
+    emphasized: z.string()
+  })
+});
 
 export const testWorkflow = createWorkflow({
-  id: "test-workflow",
-  description: 'Test workflow',
+  // ...
   inputSchema: z.object({
-    input: z.string()
+    message: z.string()
   }),
   outputSchema: z.object({
     output: z.string()
   })
 })
   .then(step1)
-  .then(clonedStep)
   .then(step2)
   .commit();
 ```
 
-## Register workflow
+### Registering a workflow
 
-Register a workflow using `workflows` in the main Mastra instance:
+Register your workflow in the Mastra instance to make it available throughout your application. Once registered, it can be called from agents or tools and has access to shared resources such as logging and observability features:
 
-```typescript {8} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {6} filename="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { PinoLogger } from "@mastra/loggers";
-import { LibSQLStore } from "@mastra/libsql";
-
 import { testWorkflow } from "./workflows/test-workflow";
 
 export const mastra = new Mastra({
+  // ...
   workflows: { testWorkflow },
-  storage: new LibSQLStore({
-    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db
-    url: ":memory:"
-  }),
-  logger: new PinoLogger({
-    name: "Mastra",
-    level: "info"
-  })
 });
 ```
 
-## Using `RuntimeContext`
-
-Use `RuntimeContext` to access request-specific values. This lets you conditionally adjust behavior based on the context of the request.
-
-```typescript filename="src/mastra/workflows/test-workflow.ts" showLineNumbers
-export type UserTier = {
-  "user-tier": "enterprise" | "pro";
-};
-
-const stepOne = createStep({
-  // ...
-  execute: async ({ runtimeContext }) => {
-    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
+## Referencing a workflow
 
-    const maxResults = userTier === "enterprise"
-      ? 1000
-      : 50;
+You can run workflows from agents, tools, the Mastra Client, or the command line. Get a reference by calling `.getWorkflow()` on your `mastra` or `mastraClient` instance, depending on your setup:
 
-    return { maxResults };
-  }
-});
+```typescript showLineNumbers copy
+const testWorkflow = mastra.getWorkflow("testWorkflow");
 ```
+<Callout type="info">
+  <p>
+    `mastra.getWorkflow()` is preferred over a direct import, since it provides access to the Mastra instance configuration (logger, telemetry, storage, registered agents, and vector stores).
+  </p>
+</Callout>
 
-## Testing workflows locally
-There are two ways to run and test workflows.
-
-<Steps>
-
-### Mastra Playground
-
-With the Mastra Dev Server running you can run the workflow from the Mastra Playground by visiting [http://localhost:4111/workflows](http://localhost:4111/workflows) in your browser.
-
-> For more information, see the [Local Dev Playground](../server-db/local-dev-playground.mdx) documentation.
+> See [Running Workflows](../../examples/workflows/running-workflows.mdx) for more information.
 
-### Command line
+## Running workflows
 
-Create a workflow run instance using `createRunAsync` and `start`:
+Workflows can be run in two modes: start waits for all steps to complete before returning, and stream emits events during execution. Choose the approach that fits your use case: start when you only need the final result, and stream when you want to monitor progress or trigger actions as steps complete.
 
-```typescript {3,5} filename="src/test-workflow.ts" showLineNumbers copy
-import "dotenv/config";
+<Tabs items={["Start", "Stream"]}>
+  <Tabs.Tab>
+Create a workflow run instance using `createRunAsync()`, then call `.start()` with `inputData` matching the workflow's `inputSchema`. The workflow executes all steps and returns the final result.
 
-import { mastra } from "./mastra";
-
-const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
+```typescript showLineNumbers copy
+const run = await testWorkflow.createRunAsync();
 
 const result = await run.start({
   inputData: {
-    city: "London"
+    message: "Hello world"
   }
 });
 
 console.log(result);
-
-if (result.status === 'success') {
-  console.log(result.result.output);
-}
 ```
-> see [createRunAsync](../../reference/workflows/run.mdx) and [start](../../reference/workflows/run-methods/start.mdx) for more information.
-
-To trigger this workflow, run the following:
+  </Tabs.Tab>
+  <Tabs.Tab>
+Create a workflow run instance using `.createRunAsync()`, then call `.stream()` with `inputData` matching the workflow's `inputSchema`. The workflow emits events as each step executes, which you can iterate over to track progress.
 
-```bash copy
-npx tsx src/test-workflow.ts
-```
+```typescript showLineNumbers copy
+const run = await testWorkflow.createRunAsync();
 
-</Steps>
+const result = await run.stream({
+  inputData: {
+    message: "Hello world"
+  }
+});
 
-### Run workflow results
+for await (const chunk of result.stream) {
+  console.log(chunk);
+}
+```
+  </Tabs.Tab>
+</Tabs>
 
-The result of running a workflow using either `start()` or `resume()` will look like one of the following, depending on the outcome.
+## Workflow output
 
-#### Status success
+The workflow output includes the full execution lifecycle, showing the input and output for each step. It also includes the status of each step, the overall workflow status, and the final result. This gives you clear insight into how data moved through the workflow, what each step produced, and how the workflow completed.
 
 ```json
 {
   "status": "success",
   "steps": {
-    // ...
+    "input": {
+      "message": "Hello world"
+    },
     "step-1": {
-      // ...
+      "payload": {
+        "message": "Hello world"
+      },
       "status": "success",
+      "output": {
+        "formatted": "HELLO WORLD"
+      },
+    },
+    "step-2": {
+      "payload": {
+        "formatted": "HELLO WORLD"
+      },
+      "status": "success",
+      "output": {
+        "emphasized": "HELLO WORLD!!!"
+      },
     }
   },
+  "input": {
+    "message": "Hello world"
+  },
   "result": {
-    "output": "London + step-1"
+    "emphasized": "HELLO WORLD!!!"
   }
 }
 ```
 
-- **status**: Shows the final state of the workflow execution, either: `success`, `suspended`, or `error`
-- **steps**: Lists each step in the workflow, including inputs and outputs
-- **status**: Shows the outcome of each individual step
-- **result**: Includes the final output of the workflow, typed according to the `outputSchema`
-
-
-#### Status suspended
-
-```json
-{
-  "status": "suspended",
-  "steps": {
-    // ...
-    "step-1": {
-      // ...
-      "status": "suspended",
-    }
-  },
-  "suspended": [
-    [
-      "step-1"
-    ]
-  ]
-}
-```
-
-- **suspended**: An optional array listing any steps currently awaiting input before continuing
-
-#### Status failed
-
-```json
-{
-  "status": "failed",
-  "steps": {
-    // ...
-    "step-1": {
-      // ...
-      "status": "failed",
-      "error": "Test error",
-    }
-  },
-  "error": "Test error"
-}
-```
-- **error**: An optional field that includes the error message if the workflow fails
+## Using `RuntimeContext`
 
-## Stream workflow
+Use `RuntimeContext` to access request-specific values. This lets you conditionally adjust behavior based on the context of the request.
 
-Similar to the run method shown above, workflows can also be streamed:
+```typescript filename="src/mastra/workflows/test-workflow.ts" showLineNumbers
+export type UserTier = {
+  "user-tier": "enterprise" | "pro";
+};
 
-```typescript {5} filename="src/test-workflow.ts" showLineNumbers copy
-import { mastra } from "./mastra";
+const step1 = createStep({
+  // ...
+  execute: async ({ runtimeContext }) => {
+    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
 
-const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
+    const maxResults = userTier === "enterprise"
+      ? 1000
+      : 50;
 
-const result = await run.stream({
-  inputData: {
-    city: "London"
+    return { maxResults };
   }
 });
-
-for await (const chunk of result.stream) {
-  console.log(chunk);
-}
 ```
 
-> See [stream](../../reference/workflows/run-methods/stream.mdx) for more information.
-
-## Watch Workflow
-
-A workflow can also be watched, allowing you to inspect each event that is emitted.
+> See [Runtime Context](../server-db/runtime-context.mdx) for more information.
 
-```typescript {5} filename="src/test-workflow.ts" showLineNumbers copy
-import { mastra } from "./mastra";
+## Testing with Mastra Playground
 
-const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
+Use the Mastra [Playground](../server-db/local-dev-playground.mdx) to easily run workflows with different inputs, visualize the execution lifecycle, see the inputs and outputs for each step, and inspect each part of the workflow in more detail.
 
-run.watch((event) => {
-  console.log(event);
-});
-
-const result = await run.start({
-  inputData: {
-    city: "London"
-  }
-});
-```
-
-> See [watch](../../reference/workflows/run-methods/watch.mdx) for more information.
 
 ## Related
 
-- The [Workflow Guide](../../guides/guide/ai-recruiter.mdx) in the Guides section is a tutorial that covers the main concepts.
+For a closer look at workflows, see our [Workflow Guide](../../guides/guide/ai-recruiter.mdx), which walks through the core concepts with a practical example.
+
 - [Parallel Steps workflow example](../../examples/workflows/parallel-steps.mdx)
 - [Conditional Branching workflow example](../../examples/workflows/conditional-branching.mdx)
 - [Inngest workflow example](../../examples/workflows/inngest-workflow.mdx)

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.31
+
+### Patch Changes
+
+- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/core@0.21.1
+
 ## 0.13.31-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.31-alpha.0",
+  "version": "0.13.31",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,7 +33,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.21.1-alpha.0",
+    "@mastra/core": "0.21.1",
     "@mastra/mcp": "^0.13.5"
   },
   "devDependencies": {
@@ -49,8 +49,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@mastra/core": "0.21.1-alpha.0",
-    "@internal/lint": "0.0.49"
+    "@internal/lint": "0.0.50",
+    "@mastra/core": "0.21.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {