@mastra/mcp-docs-server 0.13.17-alpha.1 → 0.13.17-alpha.3

package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md

@@ -0,0 +1,12 @@
+# @mastra/agent-builder
+
+## 0.0.1-alpha.1
+
+### Patch Changes
+
+- [#7135](https://github.com/mastra-ai/mastra/pull/7135) [`48b9e55`](https://github.com/mastra-ai/mastra/commit/48b9e553a39528dcc20fbbeb798c3b1a1961468e) Thanks [@NikAiyer](https://github.com/NikAiyer)! - Add Agent Builder package with template installation workflow
+
+  Introduces a new package for programmatically building and managing Mastra agents with intelligent template merging capabilities. Features include automated dependency resolution, file conflict handling, and validation fixes.
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3

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

@@ -1,5 +1,19 @@
 # @mastra/client-js
 
+## 0.11.3-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+
+## 0.11.3-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
+  - @mastra/core@0.15.3-alpha.2
+
 ## 0.11.3-alpha.1
 
 ### Patch Changes
@@ -285,18 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [8388649]
-- Updated dependencies [dd94a26]
-- Updated dependencies [3ba6772]
-- Updated dependencies [2fff911]
-  - @mastra/core@0.13.2-alpha.0
-
-## 0.10.20
-
-### Patch Changes
-
-- Updated dependencies [cd0042e]
-  - @mastra/core@0.13.1
-
-
-... 2219 more lines hidden. See full changelog in package directory.
+... 2233 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,25 @@
 # @mastra/core
 
+## 0.15.3-alpha.3
+
+### Patch Changes
+
+- [#7203](https://github.com/mastra-ai/mastra/pull/7203) [`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48) Thanks [@epinzur](https://github.com/epinzur)! - Fixed wrapping of models with AI Tracing when used with structured output.
+
+- [#7127](https://github.com/mastra-ai/mastra/pull/7127) [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb) Thanks [@abhiaiyer91](https://github.com/abhiaiyer91)! - Support file download
+
+- [#7216](https://github.com/mastra-ai/mastra/pull/7216) [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b) Thanks [@DanielSLew](https://github.com/DanielSLew)! - Fix tool validation when schema uses context or inputData reserved keys
+
+- [#7090](https://github.com/mastra-ai/mastra/pull/7090) [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe) Thanks [@K-Mistele](https://github.com/K-Mistele)! - Support Inngest flow control features for Mastra Inngest workflows
+
+- [#7217](https://github.com/mastra-ai/mastra/pull/7217) [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8) Thanks [@abhiaiyer91](https://github.com/abhiaiyer91)! - Pass provider options
+
+## 0.15.3-alpha.2
+
+### Patch Changes
+
+- [#7129](https://github.com/mastra-ai/mastra/pull/7129) [`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix custom output (tool-output) in ai-sdk stream output
+
 ## 0.15.3-alpha.1
 
 ### Patch Changes
@@ -278,25 +298,5 @@
 - 121a3f8: Fixed an issue where telemetry logs were displaying promise statuses when `agent.stream` is called
 - ec510e7: Tool input validation now returns errors as tool results instead of throwing, allowing agents to understand validation failures and retry with corrected parameters.
 - Updated dependencies [dd94a26]
-- Updated dependencies [2fff911]
-- Updated dependencies [ae2eb63]
-  - @mastra/schema-compat@0.10.7
-
-## 0.13.2-alpha.3
-
-### Patch Changes
-
-- b5cf2a3: make system message always available during agent calls
-
-## 0.13.2-alpha.2
-
-### Patch Changes
-
-- d5330bf: Allow agent model to be updated after the agent is created
-- a239d41: Updated A2A syntax to v0.3.0
-- b32c50d: Filter scores by source
-- 121a3f8: Fixed an issue where telemetry logs were displaying promise statuses when `agent.stream` is called
-- ec510e7: Tool input validation now returns errors as tool results instead of throwing, allowing agents to understand validation failures and retry with corrected parameters.
-- Updated dependencies [ae2eb63]
 
-... 2826 more lines hidden. See full changelog in package directory.
+... 2846 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,21 @@
 # @mastra/deployer-cloud
 
+## 0.15.3-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`71b657b`](https://github.com/mastra-ai/mastra/commit/71b657bffebbdcfdf1ce9c6d72003041bd6e200a), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`6d98856`](https://github.com/mastra-ai/mastra/commit/6d98856ed7cf56cbd6c4e02b3254e3dfb1e455db), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+  - @mastra/deployer@0.15.3-alpha.3
+
+## 0.15.3-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
+  - @mastra/core@0.15.3-alpha.2
+  - @mastra/deployer@0.15.3-alpha.2
+
 ## 0.15.3-alpha.1
 
 ### Patch Changes

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

@@ -1,5 +1,25 @@
 # @mastra/deployer
 
+## 0.15.3-alpha.3
+
+### Patch Changes
+
+- [#7207](https://github.com/mastra-ai/mastra/pull/7207) [`71b657b`](https://github.com/mastra-ai/mastra/commit/71b657bffebbdcfdf1ce9c6d72003041bd6e200a) Thanks [@TheIsrael1](https://github.com/TheIsrael1)! - Excluding hono from being external
+
+- [#7215](https://github.com/mastra-ai/mastra/pull/7215) [`6d98856`](https://github.com/mastra-ai/mastra/commit/6d98856ed7cf56cbd6c4e02b3254e3dfb1e455db) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Correct set the root span for telemetry traces
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+  - @mastra/server@0.15.3-alpha.3
+
+## 0.15.3-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
+  - @mastra/core@0.15.3-alpha.2
+  - @mastra/server@0.15.3-alpha.2
+
 ## 0.15.3-alpha.1
 
 ### Patch Changes
@@ -278,25 +298,5 @@
 - Updated dependencies [fd3a3eb]
 - Updated dependencies [a8f129d]
   - @mastra/core@0.14.0-alpha.3
-  - @mastra/server@0.14.0-alpha.3
-
-## 0.14.0-alpha.2
-
-### Patch Changes
-
-- 022f3a2: Fix a bug for transpilePackages usage where sibling files inside transpiled packages didn't resolve correctly
-  - @mastra/core@0.14.0-alpha.2
-  - @mastra/server@0.14.0-alpha.2
-
-## 0.14.0-alpha.1
-
-### Patch Changes
-
-- bca2ba3: Fix issue where `.json` files couldn't be imported and used with deployers
-- 6313063: Implement model switcher in playground
-- 6dfc4a6: In a previous release analysis of the Mastra configuration was added. A bug was fixed to properly support TypeScript.
-- Updated dependencies [6faaee5]
-- Updated dependencies [4232b14]
-- Updated dependencies [6313063]
 
-... 3686 more lines hidden. See full changelog in package directory.
+... 3706 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,14 @@
 # @mastra/libsql
 
+## 0.13.8-alpha.0
+
+### Patch Changes
+
+- [#7200](https://github.com/mastra-ai/mastra/pull/7200) [`dbc51ef`](https://github.com/mastra-ai/mastra/commit/dbc51ef2e42604117ab90917fc284a560647a61f) Thanks [@epinzur](https://github.com/epinzur)! - Fixed dependency issue with new AI_SPAN schema
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+
 ## 0.13.7
 
 ### Patch Changes
@@ -289,14 +298,5 @@
     - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
     - Message object with id property: `deleteMessages({ id: 'msg-123' })`
     - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
-  - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
-  - Added REST API endpoint: `POST /api/memory/messages/delete`
-  - Updated client SDK: `thread.deleteMessages()` accepts all input types
-  - Updates thread timestamps when messages are deleted
-  - Added comprehensive test coverage and documentation
-
-- Updated dependencies [27cc97a]
-- Updated dependencies [41daa63]
-- Updated dependencies [254a36b]
 
-... 694 more lines hidden. See full changelog in package directory.
+... 703 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 0.13.17-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+
+## 0.13.17-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
+  - @mastra/core@0.15.3-alpha.2
+
 ## 0.13.17-alpha.1
 
 ### Patch Changes
@@ -284,19 +298,5 @@
 - Updated dependencies [cd0042e]
   - @mastra/core@0.13.1-alpha.0
 
-## 0.13.9
-
-### Patch Changes
 
-- Updated dependencies [cb36de0]
-- Updated dependencies [d0496e6]
-- Updated dependencies [a82b851]
-- Updated dependencies [ea0c5f2]
-- Updated dependencies [41a0a0e]
-- Updated dependencies [2871020]
-- Updated dependencies [9e792ef]
-- Updated dependencies [94f4812]
-- Updated dependencies [e202b82]
-- Updated dependencies [e00f6a0]
-
-... 1474 more lines hidden. See full changelog in package directory.
+... 1488 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,15 @@
 # @mastra/playground-ui
 
+## 5.2.5-alpha.1
+
+### Patch Changes
+
+- [#7210](https://github.com/mastra-ai/mastra/pull/7210) [`87de958`](https://github.com/mastra-ai/mastra/commit/87de95832a7bdfa9ecb14473c84dc874331f1a7d) Thanks [@mfrachet](https://github.com/mfrachet)! - fix chat outline
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+  - @mastra/client-js@0.11.3-alpha.3
+
 ## 5.2.5-alpha.0
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 
 - 0ebfe8a: dependencies updates:
   - Updated dependency [`motion@^12.23.12` ↗︎](https://www.npmjs.com/package/motion/v/12.23.12) (from `^12.23.9`, in `dependencies`)
-- f5853be: Added a preview button that opens a modal, rendering the markdown in the working memory text area
-- ea0c5f2: Update to support new scorer api
-- Updated dependencies [cb36de0]
-- Updated dependencies [d0496e6]
-- Updated dependencies [a82b851]
-- Updated dependencies [ea0c5f2]
-- Updated dependencies [41a0a0e]
-- Updated dependencies [2871020]
-- Updated dependencies [42dfc48]
-- Updated dependencies [94f4812]
-
-... 2647 more lines hidden. See full changelog in package directory.
+
+... 2657 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,19 @@
 # @mastra/server
 
+## 0.15.3-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+
+## 0.15.3-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
+  - @mastra/core@0.15.3-alpha.2
+
 ## 0.15.3-alpha.1
 
 ### Patch Changes
@@ -284,19 +298,5 @@
 - Updated dependencies [d5330bf]
 - Updated dependencies [a239d41]
 - Updated dependencies [b32c50d]
-- Updated dependencies [121a3f8]
-- Updated dependencies [ec510e7]
-  - @mastra/core@0.13.2-alpha.2
-
-## 0.13.2-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [2e74797]
-- Updated dependencies [63449d0]
-  - @mastra/core@0.13.2-alpha.1
-
-## 0.13.2-alpha.0
-
 
-... 3030 more lines hidden. See full changelog in package directory.
+... 3044 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,11 @@
 # create-mastra
 
+## 0.11.3-alpha.1
+
+### Patch Changes
+
+- [#7210](https://github.com/mastra-ai/mastra/pull/7210) [`87de958`](https://github.com/mastra-ai/mastra/commit/87de95832a7bdfa9ecb14473c84dc874331f1a7d) Thanks [@mfrachet](https://github.com/mfrachet)! - fix chat outline
+
 ## 0.11.3-alpha.0
 
 ### Patch Changes
@@ -292,11 +298,5 @@
 
 ## 0.10.10-alpha.1
 
-### Patch Changes
-
-- a7a836a: Highlight send event button
-
-## 0.10.10-alpha.0
-
 
-... 1274 more lines hidden. See full changelog in package directory.
+... 1280 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,17 @@
 # mastra
 
+## 0.11.3-alpha.1
+
+### Patch Changes
+
+- [#7090](https://github.com/mastra-ai/mastra/pull/7090) [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe) Thanks [@K-Mistele](https://github.com/K-Mistele)! - Support Inngest flow control features for Mastra Inngest workflows
+
+- [#7210](https://github.com/mastra-ai/mastra/pull/7210) [`87de958`](https://github.com/mastra-ai/mastra/commit/87de95832a7bdfa9ecb14473c84dc874331f1a7d) Thanks [@mfrachet](https://github.com/mfrachet)! - fix chat outline
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`71b657b`](https://github.com/mastra-ai/mastra/commit/71b657bffebbdcfdf1ce9c6d72003041bd6e200a), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`6d98856`](https://github.com/mastra-ai/mastra/commit/6d98856ed7cf56cbd6c4e02b3254e3dfb1e455db), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3
+  - @mastra/deployer@0.15.3-alpha.3
+
 ## 0.11.3-alpha.0
 
 ### Patch Changes
@@ -286,17 +298,5 @@
 
 - 63449d0: Change the globbing of tools to exclude test files. Files inside `__tests__` directory and files with `.test.` or `.spec.` in their file name are now excluded from bundling.
 - 77b6cfe: Use just modelId for gpt-5 check
-- 96169cc: Create handler that returns providers user has keys for in their env
-- 33da97c: Set temperature to 1 for gpt-5 model in playground
-- c6d2603: Properly set baseUrl in playground when user sets the host or port in Mastra instance.
-- 7aad750: Fix tool ui showing after message when chat is refreshed
-- ce04175: Add update agent model handler
-- Updated dependencies [d5330bf]
-- Updated dependencies [aaf0224]
-- Updated dependencies [2e74797]
-- Updated dependencies [42cb4e9]
-- Updated dependencies [8388649]
-- Updated dependencies [a239d41]
-- Updated dependencies [dd94a26]
-
-... 5162 more lines hidden. See full changelog in package directory.
+
+... 5174 more lines hidden. See full changelog in package directory.

package/.docs/raw/reference/agents/streamVNext.mdx

@@ -3,13 +3,11 @@ title: "Reference: Agent.streamVNext() (Experimental) | Agents | Mastra Docs"
 description: "Documentation for the `Agent.streamVNext()` method in Mastra agents, which enables real-time streaming of responses with enhanced capabilities."
 ---
 
-import { Callout } from "nextra/components";
+import { StreamVNextCallout } from "@/components/streamVNext-callout.tsx"
 
 # Agent.streamVNext() (Experimental)
 
-<Callout type="warning">
-  **Experimental Feature**: This is a new streaming implementation with support for multiple output formats, including AI SDK v5 compatibility. It will replace the existing `stream()` method once battle-tested. The API may change as we refine the feature based on feedback.
-</Callout>
+<StreamVNextCallout />
 
 The `.streamVNext()` method enables real-time streaming of responses from an agent with enhanced capabilities and format flexibility. This method accepts messages and optional streaming options, providing a next-generation streaming experience with support for both Mastra's native format and AI SDK v5 compatibility.
 

package/.docs/raw/reference/workflows/run-methods/streamVNext.mdx

@@ -3,13 +3,11 @@ title: "Reference: Run.streamVNext() | Workflows | Mastra Docs"
 description: Documentation for the `Run.streamVNext()` method in workflows, which enables real-time streaming of responses.
 ---
 
-import { Callout } from "nextra/components";
+import { StreamVNextCallout } from "@/components/streamVNext-callout.tsx"
 
-# Run.streamVNext()
+# Run.streamVNext() (Experimental)
 
-<Callout type="warning">
-  **Experimental Feature**: This is a new streaming implementation that will replace the existing `stream()` method once battle-tested. The API may change as we refine the feature based on feedback.
-</Callout>
+<StreamVNextCallout />
 
 The `.streamVNext()` method enables real-time streaming of responses from a workflow. This enhanced streaming capability will eventually replace the current `stream()` method.
 

package/.docs/raw/streaming/events.mdx

@@ -0,0 +1,115 @@
+---
+title: "Streaming Events | Streaming | Mastra"
+description: "Learn about the different types of streaming events in Mastra, including text deltas, tool calls, step events, and how to handle them in your applications."
+---
+
+# Streaming Events
+
+Streaming from agents or workflows provides real-time visibility into either the LLM’s output or the status of a workflow run. This feedback can be passed directly to the user, or used within applications to handle workflow status more effectively, creating a smoother and more responsive experience.
+
+Events emitted from agents or workflows represent different stages of generation and execution, such as when a run starts, when text is produced, or when a tool is invoked.
+
+## Event types
+
+Below is a complete list of events emitted from `.streamVNext()`.
+Depending on whether you’re streaming from an **agent** or a **workflow**, only a subset of these events will occur:
+
+- **start**: Marks the beginning of an agent or workflow run.
+- **step-start**: Indicates a workflow step has begun execution.
+- **text-delta**: Incremental text chunks as they're generated by the LLM.
+- **tool-call**: When the agent decides to use a tool, including the tool name and arguments.
+- **tool-result**: The result returned from tool execution.
+- **step-finish**: Confirms that a specific step has fully finalized, and may include metadata like the finish reason for that step.
+- **finish**: When the agent or workflow completes, including usage statistics.
+
+## Inspecting agent streams
+
+Iterate over the `stream` with a `for await` loop to inspect all emitted event chunks.
+
+```typescript {3,7} showLineNumbers copy
+const testAgent = mastra.getAgent("testAgent");
+
+const stream = await testAgent.streamVNext([
+  { role: "user", content: "Help me organize my day" },
+]);
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> See [Agent.streamVNext()](../../reference/agents/streamVNext.mdx) for more information.
+
+### Example agent output
+
+Below is an example of events that may be emitted. Each event always includes a `type` and can include additional fields like `from` and `payload`.
+
+```typescript {2,7,15}
+{
+  type: 'start',
+  from: 'AGENT',
+  // ..
+}
+{
+  type: 'step-start',
+  from: 'AGENT',
+  payload: {
+    messageId: 'msg-cdUrkirvXw8A6oE4t5lzDuxi',
+    // ...
+  }
+}
+{
+  type: 'tool-call',
+  from: 'AGENT',
+  payload: {
+    toolCallId: 'call_jbhi3s1qvR6Aqt9axCfTBMsA',
+    toolName: 'testTool'
+    // ..
+  }
+}
+```
+
+## Inspecting workflow streams
+
+Iterate over the `stream` with a `for await` loop to inspect all emitted event chunks.
+
+```typescript {5,11} showLineNumbers copy
+const testWorkflow = mastra.getWorkflow("testWorkflow");
+
+const run = await testWorkflow.createRunAsync();
+
+const stream = await run.streamVNext({
+  inputData: {
+    value: "initial data"
+  }
+});
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+### Example workflow output
+
+Below is an example of events that may be emitted. Each event always includes a `type` and can include additional fields like `from` and `payload`.
+
+```typescript {2,8,11}
+{
+  type: 'start',
+  runId: '221333ed-d9ee-4737-922b-4ab4d9de73e6',
+  from: 'WORKFLOW',
+  // ...
+}
+{
+  type: 'step-start',
+  runId: '221333ed-d9ee-4737-922b-4ab4d9de73e6',
+  from: 'WORKFLOW',
+  payload: {
+    stepName: 'step-1',
+    args: { value: 'initial data' },
+    stepCallId: '9e8c5217-490b-4fe7-8c31-6e2353a3fc98',
+    startedAt: 1755269732792,
+    status: 'running'
+  }
+}
+```

package/.docs/raw/streaming/overview.mdx

@@ -0,0 +1,137 @@
+---
+title: "Streaming Overview | Streaming | Mastra"
+description: "Streaming in Mastra enables real-time, incremental responses from both agents and workflows, providing immediate feedback as AI-generated content is produced."
+---
+
+import { StreamVNextCallout } from "@/components/streamVNext-callout.tsx"
+
+# Streaming Overview
+
+<StreamVNextCallout />
+
+Mastra supports real-time, incremental responses from agents and workflows, allowing users to see output as it’s generated instead of waiting for completion. This is useful for chat, long-form content, multi-step workflows, or any scenario where immediate feedback matters.
+
+## Getting started
+
+Mastra currently supports two streaming methods, this page explains how to use `streamVNext()`.
+
+1. **`.stream()`**: Current stable API, supports **AI SDK v1**.
+2. **`.streamVNext()`**: Experimental API, supports **AI SDK v2**.
+
+## Streaming with agents
+
+You can pass a single string for simple prompts, an array of strings when providing multiple pieces of context, or an array of message objects with `role` and `content` for precise control over roles and conversational flows.
+
+### Using `Agent.streamVNext()`
+
+A `textStream` breaks the response into chunks as it's generated, allowing output to stream progressively instead of arriving all at once.  Iterate over the `textStream` using a `for await` loop to inspect each stream chunk.
+
+```typescript {3,7} showLineNumbers copy
+const testAgent = mastra.getAgent("testAgent");
+
+const stream = await testAgent.streamVNext([
+  { role: "user", content: "Help me organize my day" },
+]);
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+> See [Agent.streamVNext()](../../reference/agents/streamVNext.mdx) for more information.
+
+### Output from `Agent.streamVNext()`
+
+The output streams the generated response from the agent.
+
+```text
+Of course!
+To help you organize your day effectively, I need a bit more information.
+Here are some questions to consider:
+...
+```
+
+## Agent stream properties
+
+An agent stream provides access to various response properties:
+
+- **`stream.textStream`**: A readable stream that emits text chunks.
+- **`stream.text`**: Promise that resolves to the full text response.
+- **`stream.finishReason`**: The reason the agent stopped streaming.
+- **`stream.usage`**: Token usage information.
+
+
+### AI SDK v5 Compatibility
+
+For integration with AI SDK v5, use `format` 'aisdk' to get an `AISDKV5OutputStream`:
+
+```typescript {5} showLineNumbers copy
+const testAgent = mastra.getAgent("testAgent");
+
+const stream = await testAgent.streamVNext(
+  [{ role: "user", content: "Help me organize my day" }],
+  { format: "aisdk" }
+);
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+## Streaming with workflows
+
+Streaming from a workflow returns a sequence of structured events describing the run lifecycle, rather than incremental text chunks. This event-based format makes it possible to track and respond to workflow progress in real time once a run is created using `.createRunAsync()`.
+
+### Using `Run.streamVNext()`
+
+This is the experimental API. It returns a `ReadableStream` of events directly.
+
+```typescript {3,9} showLineNumbers copy
+const run = await testWorkflow.createRunAsync();
+
+const stream = await run.streamVNext({
+  inputData: {
+    value: "initial data"
+  }
+});
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> See [Run.streamVNext()](../../reference/workflows/run-methods/streamVNext.mdx) for more information.
+
+### Output from `Run.streamVNext()`
+
+The experimental API event structure includes `runId` and `from` at the top level, making it easier to identify and track workflow runs without digging into the payload.
+
+```typescript
+// ...
+{
+  type: 'step-start',
+  runId: '1eeaf01a-d2bf-4e3f-8d1b-027795ccd3df',
+  from: 'WORKFLOW',
+  payload: {
+    stepName: 'step-1',
+    args: { value: 'initial data' },
+    stepCallId: '8e15e618-be0e-4215-a5d6-08e58c152068',
+    startedAt: 1755121710066,
+    status: 'running'
+  }
+}
+```
+
+## Workflow stream properties
+
+A workflow stream provides access to various response properties:
+
+- **`stream.status`**: The status of the workflow run.
+- **`stream.result`**: The result of the workflow run.
+- **`stream.usage`**: The total token usage of the workflow run.
+
+## Related
+
+- [Streaming events](./events.mdx)
+- [Using Agents](../agents/overview.mdx)
+- [Workflows overview](../workflows/overview.mdx)

package/.docs/raw/streaming/tool-streaming.mdx

@@ -0,0 +1,107 @@
+---
+title: "Tool Streaming | Streaming | Mastra"
+description: "Learn how to use tool streaming in Mastra, including handling tool calls, tool results, and tool execution events during streaming."
+---
+
+# Tool streaming
+
+Tool streaming in Mastra enables tools to send incremental results while they run, rather than waiting until execution finishes. This allows you to surface partial progress, intermediate states, or progressive data directly to users or upstream agents and workflows.
+
+Streams can be written to in two main ways:
+
+- **From within a tool**: every tool receives a `writer` argument, which is a writable stream you can use to push updates as execution progresses.
+- **From an agent stream**: you can also pipe an agent’s `streamVNext` output directly into a tool’s writer, making it easy to chain agent responses into tool results without extra glue code.
+
+By combining writable tool streams with agent streaming, you gain fine grained control over how intermediate results flow through your system and into the user experience.
+
+## Agent using tool
+
+Agent streaming can be combined with tool calls, allowing tool outputs to be written directly into the agent’s streaming response. This makes it possible to surface tool activity as part of the overall interaction.
+
+```typescript {4,10} showLineNumbers copy
+import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
+
+import { testTool } from "../tools/test-tool";
+
+export const testAgent = new Agent({
+  name: "test-agent",
+  instructions: "You are a weather agent.",
+  model: openai("gpt-4o-mini"),
+  tools: { testTool }
+});
+```
+
+### Using the `writer` argument
+
+The `writer` argument is passed to a tool’s `execute` function and can be used to emit custom events, data, or values into the active stream. This enables tools to provide intermediate results or status updates while execution is still in progress.
+
+```typescript {5,8,15} showLineNumbers copy
+import { createTool } from "@mastra/core/tools";
+
+export const testTool = createTool({
+  // ...
+  execute: async ({ context, writer }) => {
+    const { value } = context;
+
+    writer?.write({
+      type: "custom-event",
+      status: "pending"
+    });
+
+    const response = await fetch(...);
+
+    writer?.write({
+      type: "custom-event",
+      status: "success"
+    });
+
+    return {
+      value: ""
+    };
+  }
+});
+```
+
+### Inspecting stream payloads
+
+Events written to the stream are included in the emitted chunks. These chunks can be inspected to access any custom fields, such as event types, intermediate values, or tool-specific data.
+
+```typescript showLineNumbers copy
+const stream = await testAgent.streamVNext([
+  "What is the weather in London?",
+  "Use the testTool"
+]);
+
+for await (const chunk of stream) {
+  if (chunk.payload.output?.type === "custom-event") {
+    console.log(JSON.stringify(chunk, null, 2));
+  }
+}
+```
+
+## Tool using an agent
+
+Pipe an agent’s `textStream` to the tool’s `writer`. This streams partial output, and Mastra automatically aggregates the agent’s usage into the tool run.
+
+```typescript showLineNumbers copy
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+
+export const testTool = createTool({
+  // ...
+  execute: async ({ context, mastra, writer }) => {
+    const { city } = context;
+
+    const testAgent = mastra?.getAgent("testAgent");
+    const stream = await testAgent?.streamVNext(`What is the weather in ${city}?`);
+
+    await stream!.textStream.pipeTo(writer!);
+
+    return {
+      value: await stream!.text
+    };
+  }
+});
+```
+

package/.docs/raw/streaming/workflow-streaming.mdx

@@ -0,0 +1,91 @@
+---
+title: "Workflow Streaming | Streaming | Mastra"
+description: "Learn how to use workflow streaming in Mastra, including handling workflow execution events, step streaming, and workflow integration with agents and tools."
+---
+
+# Workflow streaming
+
+Workflow streaming in Mastra enables workflows to send incremental results while they execute, rather than waiting until completion. This allows you to surface partial progress, intermediate states, or progressive data directly to users or upstream agents and workflows.
+
+Streams can be written to in two main ways:
+
+- **From within a workflow step**: every workflow step receives a `writer` argument, which is a writable stream you can use to push updates as execution progresses.
+- **From an agent stream**: you can also pipe an agent's `streamVNext` output directly into a workflow step's writer, making it easy to chain agent responses into workflow results without extra glue code.
+
+By combining writable workflow streams with agent streaming, you gain fine-grained control over how intermediate results flow through your system and into the user experience.
+
+### Using the `writer` argument
+
+The `writer` argument is passed to a workflow step's `execute` function and can be used to emit custom events, data, or values into the active stream. This enables workflow steps to provide intermediate results or status updates while execution is still in progress.
+
+```typescript {5,8,15} showLineNumbers copy
+import { createStep } from "@mastra/core/workflows";
+
+export const testStep = createStep({
+  // ...
+  execute: async ({ inputData, writer }) => {
+     const { value } = inputData;
+
+    writer?.write({
+      type: "custom-event",
+      status: "pending"
+    });
+
+    const response = await fetch(...);
+
+    writer?.write({
+      type: "custom-event",
+      status: "success"
+    });
+
+    return {
+      value: ""
+    };
+  },
+});
+```
+
+### Inspecting workflow stream payloads
+
+Events written to the stream are included in the emitted chunks. These chunks can be inspected to access any custom fields, such as event types, intermediate values, or step-specific data.
+
+```typescript showLineNumbers copy
+const testWorkflow = mastra.getWorkflow("testWorkflow");
+
+const run = await testWorkflow.createRunAsync();
+
+const stream = await run.streamVNext({
+  inputData: {
+    value: "initial data"
+  }
+});
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+## Workflow using an agent
+
+Pipe an agent's `textStream` to the workflow step's `writer`. This streams partial output, and Mastra automatically aggregates the agent's usage into the workflow run.
+
+```typescript showLineNumbers copy
+import { createStep } from "@mastra/core/workflows";
+import { z } from "zod";
+
+export const testStep = createStep({
+  // ...
+  execute: async ({ inputData, mastra, writer  }) => {
+    const { city } = inputData
+
+    const testAgent = mastra?.getAgent("testAgent");
+    const stream = await testAgent?.streamVNext(`What is the weather in ${city}$?`);
+
+    await stream!.textStream.pipeTo(writer!);
+
+    return {
+      value: await stream!.text,
+    };
+  },
+});
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.17-alpha.1",
+  "version": "0.13.17-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.15.3-alpha.1",
+    "@mastra/core": "0.15.3-alpha.3",
     "@mastra/mcp": "^0.11.3-alpha.0"
   },
   "devDependencies": {
@@ -48,8 +48,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.34",
-    "@mastra/core": "0.15.3-alpha.1"
+    "@mastra/core": "0.15.3-alpha.3",
+    "@internal/lint": "0.0.34"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",

package/.docs/raw/agents/streaming.mdx

@@ -1,154 +0,0 @@
----
-title: "Using Agent Streaming | Agents | Mastra Docs"
-description: Documentation on how to stream agents
----
-
-import { Callout } from "nextra/components";
-
-# Agent Streaming (VNext)
-
-Agents in Mastra support streaming responses for real-time interaction with clients. This enables progressive rendering of responses and better user experience.
-
-<Callout type="info">
-  **Experimental API**: The `streamVNext` method shown in this guide is an experimental feature with enhanced streaming format support. It will replace the current `stream()` method after additional testing and refinement. For production use, consider using the stable [`stream()` method](/docs/agents/overview#streaming-responses) until `streamVNext` is finalized.
-</Callout>
-
-## Usage
-
-The experimental streaming protocol uses the `streamVNext` method on an agent. This method now supports multiple output stream formats, for Mastra (default) and AI SDK v5.
-
-
-## Format Parameter
-
-The `format` parameter determines the output stream type:
-
-- **`'mastra'` (default)**: Returns `MastraModelOutput` - Mastra's native streaming format
-- **`'aisdk'`**: Returns `AISDKV5OutputStream` - Compatible with AI SDK v5 interfaces like useChat.
-
-```typescript
-// Mastra format (default)
-const mastraStream = await agent.streamVNext("Hello");
-
-// AI SDK v5 format
-const aiSdkStream = await agent.streamVNext("Hello", { 
-  format: 'aisdk' 
-});
-```
-
-### Default Mastra Format
-
-By default, `streamVNext` returns a `MastraModelOutput` stream:
-
-```typescript
-const stream = await agent.streamVNext("Tell me a story.");
-
-// Access the text stream
-for await (const chunk of stream.textStream) {
-  console.log(chunk);
-}
-
-// Or get the full text after streaming
-const fullText = await stream.text;
-```
-
-### AI SDK v5 Compatibility
-
-For integration with AI SDK v5, use the `format: 'aisdk'` parameter to get an `AISDKV5OutputStream`:
-
-```typescript
-const stream = await agent.streamVNext("Tell me a story.", {
-  format: 'aisdk'
-});
-
-// The stream is now compatible with AI SDK v5 interfaces
-for await (const chunk of stream.fullStream) {
-  // Process AI SDK v5 formatted chunks
-  console.log(chunk);
-}
-```
-
-## Stream Properties
-
-Both stream formats provide access to various response properties:
-
-- `stream.textStream` - A readable stream that emits text chunks
-- `stream.text` - Promise that resolves to the full text response
-- `stream.finishReason` - The reason the agent stopped streaming
-- `stream.usage` - Token usage information
-
-### How to use the stream in a tool
-
-Each tool gets a `writer` argument, which is a writable stream with a custom write function. This write function is used to write the tool's response to the stream.
-
-```typescript filename="src/mastra/tools/test-tool.ts" showLineNumbers copy
-import { createTool } from "@mastra/core/tools";
-import { z } from "zod";
-
-export const weatherInfo = createTool({
-  id: "Get Weather Information",
-  inputSchema: z.object({
-    city: z.string(),
-  }),
-  outputSchema: z.object({
-    conditions: z.string(),
-    temperature: z.number(),
-  }),
-  description: `Fetches the current weather information for a given city`,
-  execute: async ({ context: { city }, writer }) => {
-    writer.write({
-      type: "weather-data",
-      args: {
-        city
-      },
-      status: "pending"
-    })
-    // Tool logic here (e.g., API call)
-    console.log("Using tool to fetch weather information for", city);
-
-    writer.write({
-      type: "weather-data",
-      args: {
-        city
-      },
-      status: "success",
-      result: {
-        temperature: 20,
-        conditions: "Sunny"
-      }
-    })
-
-    return { temperature: 20, conditions: "Sunny" }; // Example return
-  },
-});
-```
-
-To use streaming within an agent-based tool, call `streamVNext` on the agent and pipe it to the writer:
-
-```typescript filename="src/mastra/tools/test-tool.ts" showLineNumbers copy
-import { createTool } from "@mastra/core/tools";
-import { z } from "zod";
-
-export const weatherInfo = createTool({
-  id: "Get Weather Information",
-  description: `Fetches the current weather information for a given city`,
-  inputSchema: z.object({
-    city: z.string(),
-  }),
-  outputSchema: z.object({
-    text: z.string(),
-  }),
-  execute: async ({ context: { city }, writer, mastra }) => {
-    const agent = mastra.getAgent('weatherAgent')
-    const stream = await agent.streamVNext(`What is the weather in ${city}?`);
-
-    await stream.pipeTo(writer);
-
-    return {
-      text: await stream.text,
-    }
-  },
-});
-```
-
-Piping the stream to the writer enables automatic aggregation of token usage across nested agent calls.
-

package/.docs/raw/workflows/streaming.mdx

@@ -1,115 +0,0 @@
----
-title: "Using Workflow Streaming | Workflows | Mastra Docs"
-description: Documentation on how to stream workflows
----
-
-# Workflow Streaming
-
-Workflows in Mastra have access to a powerful streaming protocol! With seamless integration into tools or agents as a step, you can stream responses directly back to your clients, creating a more interactive and engaging experience.
-
-## Usage
-
-To use the new protocol, you can use the `streamVNext` method on an workflow. This method will return a custom MatraWorkflowStream. This stream extends a ReadableStream, so all basic stream methods are available.
-
-```typescript
-const run = await myWorkflow.createRunAsync();
-const stream = await run.streamVNext({ inputData: { city: 'New York' } });
-
-for await (const chunk of stream) {
-  console.log(chunk);
-}
-```
-
-Each chunk is a JSON object with the following properties:
-
-```json
-{
-  type: string;
-  runId: string;
-  from: string;
-  payload: Record<string, any>;
-}
-```
-
-We have a couple of utility functions on the stream to help you with the streaming process.
-
-- `stream.status` - The status of the workflow run.
-- `stream.result` - The result of the workflow run.
-- `stream.usage` - The total token usage of the workflow run.
-
-### How to use the stream in a tool
-
-Each tool gets a `writer` argument, which is a writable stream with a custom write function. This write function is used to write the tool's response to the stream.
-
-```typescript filename="src/mastra/workflows/weather.ts" showLineNumbers copy
-import { createStep } from "@mastra/core/workflows";
-import { z } from "zod";
-
-export const weatherInfo = createStep({
-  id: "weather-info",
-  inputSchema: z.object({
-    city: z.string(),
-  }),
-  outputSchema: z.object({
-    conditions: z.string(),
-    temperature: z.number(),
-  }),
-  description: `Fetches the current weather information for a given city`,
-  execute: async ({ inputData: { city }, writer }) => {
-    writer.write({
-      type: "weather-data",
-      args: {
-        city
-      },
-      status: "pending"
-    })
-    // Tool logic here (e.g., API call)
-    console.log("Using tool to fetch weather information for", city);
-
-    writer.write({
-      type: "weather-data",
-      args: {
-        city
-      },
-      status: "success",
-      result: {
-        temperature: 20,
-        conditions: "Sunny"
-      }
-    })
-
-    return { temperature: 20, conditions: "Sunny" }; // Example return
-  },
-});
-```
-
-If you want to use the stream in an agent, you can use the `streamVNext` method on the agent and pipe it to the agent's input stream.
-
-```typescript filename="src/mastra/workflows/weather.ts" showLineNumbers copy
-import { createStep } from "@mastra/core/workflows";
-import { z } from "zod";
-
-export const weatherInfo = createStep({
-  id: "weather-info",
-  inputSchema: z.object({
-    city: z.string(),
-  }),
-  outputSchema: z.object({
-    text: z.string(),
-  }),
-  description: `Fetches the current weather information for a given city`,
-  execute: async ({ inputData: { city }, writer, mastra }) => {
-    const agent = mastra.getAgent('weatherAgent')
-    const stream = await agent.streamVNext(`What is the weather in ${city}?`);
-
-    await stream.pipeTo(writer);
-
-    return {
-      text: await stream.text,
-    }
-  },
-});
-```
-
-Piping the stream to the agent's input stream will allow us to automatically sum up the usage of the agent so the total usage count can be calculated.
-