@mastra/mcp-docs-server 0.0.0-structured-output-errors-20260409185629 → 0.0.0-structured-output-agent-20260413221909

package/.docs/docs/agents/structured-output.md

@@ -210,6 +210,28 @@ const response = await testAgent.generate('Tell me about TypeScript.', {
 })
 ```
 
+If you want that structuring model to also see the current conversation history, set `useAgent: true`. Mastra will reuse the parent agent with the separate structuring model and attach read-only memory context when a thread is available.
+
+```typescript
+const response = await testAgent.generate('Return my profile as structured data.', {
+  memory: {
+    thread: 'thread-123',
+    resource: 'user-123',
+  },
+  structuredOutput: {
+    schema: z.object({
+      favoriteColor: z.string(),
+      hometown: z.string(),
+      petName: z.string(),
+    }),
+    model: 'openai/gpt-5.4',
+    useAgent: true,
+  },
+})
+```
+
+Leave `useAgent` unset if you want the separate structuring model to work only from the current response and not inherit prior conversation memory.
+
 ### Multi-step approach with `prepareStep`
 
 For models that don't support tools and structured outputs together, you can use `prepareStep` to handle them in separate steps.

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -8,6 +8,23 @@ Framework-agnostic handler for streaming agent chat in AI SDK-compatible format.
 
 Use [`chatRoute()`](https://mastra.ai/reference/ai-sdk/chat-route) if you want to create a chat route inside a Mastra server.
 
+## Structured output in UI streams
+
+When you pass `structuredOutput` to the underlying agent execution, the final structured output object is emitted in the AI SDK-compatible UI stream as a custom data part:
+
+```json
+{
+  "type": "data-structured-output",
+  "data": {
+    "object": {}
+  }
+}
+```
+
+The `object` field contains your full structured output value. Mastra emits this event for the final structured output object only. Partial structured output chunks are not exposed in the UI stream.
+
+Read this event with AI SDK UI's custom data handling, such as `onData`, or render it from message data parts.
+
 ## Usage example
 
 Next.js App Router example:

package/.docs/reference/ai-sdk/to-ai-sdk-stream.md

@@ -6,6 +6,21 @@ This is useful when building custom streaming endpoints outside Mastra's provide
 
 `toAISdkStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'` in the options object.
 
+## Structured output in UI streams
+
+When the source agent stream includes a final structured output object, `toAISdkStream()` emits it as a custom AI SDK UI data part:
+
+```json
+{
+  "type": "data-structured-output",
+  "data": {
+    "object": {}
+  }
+}
+```
+
+The `object` field contains your full structured output value. This maps Mastra's final structured output chunk into the AI SDK UI stream. Partial structured output chunks are not emitted.
+
 ## Usage example
 
 Next.js App Router example:

package/CHANGELOG.md

@@ -1,12 +1,12 @@
 # @mastra/mcp-docs-server
 
-## 0.0.0-structured-output-errors-20260409185629
+## 0.0.0-structured-output-agent-20260413221909
 
 ### Patch Changes
 
-- Updated dependencies [[`87df955`](https://github.com/mastra-ai/mastra/commit/87df955c028660c075873fd5d74af28233ce32eb), [`920f258`](https://github.com/mastra-ai/mastra/commit/920f258392868b1acaa9390f708a19466fff9d7f), [`075e91a`](https://github.com/mastra-ai/mastra/commit/075e91a4549baf46ad7a42a6a8ac8dfa78cc09e6)]:
-  - @mastra/core@0.0.0-structured-output-errors-20260409185629
-  - @mastra/mcp@0.0.0-structured-output-errors-20260409185629
+- Updated dependencies [[`87df955`](https://github.com/mastra-ai/mastra/commit/87df955c028660c075873fd5d74af28233ce32eb), [`5d84914`](https://github.com/mastra-ai/mastra/commit/5d84914e0e520c642a40329b210b413fcd139898), [`fd2f314`](https://github.com/mastra-ai/mastra/commit/fd2f31473d3449b6b97e837ef8641264377f41a7), [`e80fead`](https://github.com/mastra-ai/mastra/commit/e80fead1412cc0d1b2f7d6a1ce5017d9e0098ff7), [`0287b64`](https://github.com/mastra-ai/mastra/commit/0287b644a5c3272755cf3112e71338106664103b), [`5332c00`](https://github.com/mastra-ai/mastra/commit/5332c00ede9a783f0f56000240b8ed68e008d922), [`075e91a`](https://github.com/mastra-ai/mastra/commit/075e91a4549baf46ad7a42a6a8ac8dfa78cc09e6)]:
+  - @mastra/core@0.0.0-structured-output-agent-20260413221909
+  - @mastra/mcp@0.0.0-structured-output-agent-20260413221909
 
 ## 1.1.25-alpha.0
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.0.0-structured-output-errors-20260409185629",
+  "version": "0.0.0-structured-output-agent-20260413221909",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "0.0.0-structured-output-errors-20260409185629",
-    "@mastra/mcp": "0.0.0-structured-output-errors-20260409185629"
+    "@mastra/core": "0.0.0-structured-output-agent-20260413221909",
+    "@mastra/mcp": "0.0.0-structured-output-agent-20260413221909"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@internal/lint": "0.0.0-structured-output-errors-20260409185629",
-    "@internal/types-builder": "0.0.0-structured-output-errors-20260409185629",
-    "@mastra/core": "0.0.0-structured-output-errors-20260409185629"
+    "@internal/lint": "0.0.0-structured-output-agent-20260413221909",
+    "@internal/types-builder": "0.0.0-structured-output-agent-20260413221909",
+    "@mastra/core": "0.0.0-structured-output-agent-20260413221909"
   },
   "homepage": "https://mastra.ai",
   "repository": {