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

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

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.10.23-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869), [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236)]:
+  - @mastra/core@0.14.1-alpha.1
+
 ## 0.10.23-alpha.0
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - b641ba3: fix: save score params
 - 9802f42: Added types and tests to ensure client-js and hono endpoints can save memory messages where the input is either a v1 or v2 mastra message
 - 1ac8f6b: deduplicate message
-- b8efbb9: feat: add flexible deleteMessages method to memory API
-  - Added `memory.deleteMessages(input)` method that accepts multiple input types:
-    - Single message ID as string: `deleteMessages('msg-123')`
-    - 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)
-
-... 2101 more lines hidden. See full changelog in package directory.
+
+... 2108 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,13 @@
 # @mastra/core
 
+## 0.14.1-alpha.1
+
+### Patch Changes
+
+- [#6864](https://github.com/mastra-ai/mastra/pull/6864) [`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869) Thanks [@TylerBarnes](https://github.com/TylerBarnes)! - Added a convertMessages(from).to("Mastra.V2" | "AIV\*") util for operating on DB messages directly
+
+- [#6927](https://github.com/mastra-ai/mastra/pull/6927) [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236) Thanks [@DanielSLew](https://github.com/DanielSLew)! - Fix output processors to match new stream types.
+
 ## 0.14.1-alpha.0
 
 ### Patch Changes
@@ -290,13 +298,5 @@
 
 ## 0.12.0
 
-### Minor Changes
-
-- 2ecf658: Added the option to provide a custom ID generator when creating an instance of Mastra. If the generator is not provided, a fallback of using UUID is used to generate IDs instead.
-
-### Patch Changes
-
-- 510e2c8: dependencies updates:
-  - Updated dependency [`radash@^12.1.1` ↗︎](https://www.npmjs.com/package/radash/v/12.1.1) (from `^12.1.0`, in `dependencies`)
 
-... 2669 more lines hidden. See full changelog in package directory.
+... 2677 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,13 @@
 # @mastra/deployer
 
+## 0.14.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869), [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236)]:
+  - @mastra/core@0.14.1-alpha.1
+  - @mastra/server@0.14.1-alpha.1
+
 ## 0.14.1-alpha.0
 
 ### Patch Changes
@@ -290,13 +298,5 @@
 
 - d0496e6: dependencies updates:
   - Updated dependency [`hono@^4.8.12` ↗︎](https://www.npmjs.com/package/hono/v/4.8.12) (from `^4.8.11`, in `dependencies`)
-- Updated dependencies [d0496e6]
-  - @mastra/core@0.13.0-alpha.3
-  - @mastra/server@0.13.0-alpha.3
-
-## 0.13.0-alpha.2
-
-### Patch Changes
-
 
-... 3534 more lines hidden. See full changelog in package directory.
+... 3542 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.13-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869), [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236)]:
+  - @mastra/core@0.14.1-alpha.1
+
 ## 0.13.13-alpha.0
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [3f89307]
 - Updated dependencies [9eda7d4]
 - Updated dependencies [9d49408]
-- Updated dependencies [41daa63]
-- Updated dependencies [ad0a58b]
-- Updated dependencies [254a36b]
-- Updated dependencies [2ecf658]
-- Updated dependencies [7a7754f]
-- Updated dependencies [fc92d80]
-- Updated dependencies [e0f73c6]
-
-... 1376 more lines hidden. See full changelog in package directory.
+
+... 1383 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 0.14.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`0f00e17`](https://github.com/mastra-ai/mastra/commit/0f00e172953ccdccadb35ed3d70f5e4d89115869), [`217cd7a`](https://github.com/mastra-ai/mastra/commit/217cd7a4ce171e9a575c41bb8c83300f4db03236)]:
+  - @mastra/core@0.14.1-alpha.1
+
 ## 0.14.1-alpha.0
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ## 0.12.0
 
-### Minor Changes
-
-- f42c4c2: update peer deps for packages to latest core range
-
-### Patch Changes
-
-
-... 2910 more lines hidden. See full changelog in package directory.
+... 2917 more lines hidden. See full changelog in package directory.

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

@@ -5,46 +5,76 @@ description: Documentation on how to stream agents
 
 import { Callout } from "nextra/components";
 
-# Agent Streaming
+# 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 that will replace the current `stream()` method after additional testing and refinement. For production use, consider using the stable [`stream()` method](/docs/agents/overview#2-generating-and-streaming-text) until `streamVNext` is finalized.
+  **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 returns a custom MastraAgentStream that extends ReadableStream with additional utilities.
+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({ role: "user", content: "Tell me a story." });
+const stream = await agent.streamVNext("Tell me a story.");
 
-for await (const chunk of stream) {
+// 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;
 ```
 
-Each chunk is a JSON object with the following properties:
+### AI SDK v5 Compatibility
 
-```json
-{
-  type: string;
-  runId: string;
-  from: string;
-  payload: Record<string, any>;
+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);
 }
 ```
 
-The stream provides several utility functions for working with streaming responses:
+## Stream Properties
+
+Both stream formats provide access to various response properties:
 
-- `stream.finishReason` - The reason the agent stopped streaming.
-- `stream.toolCalls` - The tool calls made by the agent.
-- `stream.toolResults` - The tool results returned by the agent.
-- `stream.usage` - The total token usage of the agent, including agents/workflows as a tool.
-- `stream.text` - The full text of the agent's response.
-- `stream.object` - The object of the agent's response, if you use output or experimental output.
-- `stream.textStream` - A readable stream that will emit the text of the agent's response.
+- `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
 

package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx

@@ -9,9 +9,9 @@ import { Callout, Tabs } from "nextra/components";
 
 Mastra integrates with [Vercel's AI SDK](https://sdk.vercel.ai) to support model routing, React Hooks, and data streaming methods.
 
-## AI SDK v5 (beta)
+## AI SDK v5
 
-Mastra also supports AI SDK v5 (beta) see the following section for v5 specific methods: [Vercel AI SDK v5](/docs/frameworks/agentic-uis/ai-sdk#vercel-ai-sdk-v5)
+Mastra also supports AI SDK v5 see the following section for v5 specific methods: [Vercel AI SDK v5](/docs/frameworks/agentic-uis/ai-sdk#vercel-ai-sdk-v5)
 
 <Callout type="warning">
   The code examples contained with this page assume you're using the Next.js App Router at the root of your
@@ -380,94 +380,76 @@ export async function POST(req: Request) {
 
 ## Vercel AI SDK v5
 
-This guide covers Mastra-specific considerations when migrating from AI SDK v4 to v5 beta.
+This guide covers Mastra-specific considerations when migrating from AI SDK v4 to v5.
 
 > Please add any feedback or bug reports to the [AI SDK v5 mega issue in Github.](https://github.com/mastra-ai/mastra/issues/5470)
 
+### Experimental streamVNext Support
+
+Mastra's experimental `streamVNext` method now includes native AI SDK v5 support through the `format` parameter. This provides seamless integration with AI SDK v5's streaming interfaces without requiring compatibility wrappers.
+
+```typescript
+// Use streamVNext with AI SDK v5 format
+const stream = await agent.streamVNext(messages, {
+  format: 'aisdk'  // Enable AI SDK v5 compatibility
+});
+
+// The stream is now compatible with AI SDK v5 interfaces
+return stream.toUIMessageStreamResponse();
+```
+
 ### Official migration guide
 
 Follow the official [AI SDK v5 Migration Guide](https://v5.ai-sdk.dev/docs/migration-guides/migration-guide-5-0) for all AI SDK core breaking changes, package updates, and API changes.
 
 This guide covers only the Mastra-specific aspects of the migration.
 
-- **Data compatibility**: New data stored in v5 format will no longer work if you downgrade from the beta
-- **Backup recommendation**: Keep DB backups from before you upgrade to v5 beta
-- **Production use**: Wait for the AI SDK v5 stable release before using in production applications
-- **Prerelease status**: The Mastra `ai-v5` tag is a prerelease version and may have bugs
+- **Data compatibility**: New data stored in v5 format will no longer work if you downgrade from v5 to v4
+- **Backup recommendation**: Keep DB backups from before you upgrade to v5
 
 ### Memory and Storage
 
 Mastra automatically handles AI SDK v4 data using its internal `MessageList` class, which manages format conversion—including v4 to v5. No database migrations are required; your existing messages are translated on the fly and continue working after you upgrade.
 
-### Migration strategy
-
-Migrating to AI SDK v5 with Mastra involves updating both your **backend** (Mastra server) and **frontend**.
-We provide a compatibility mode to handle stream format conversion during the transition.
-
-### Upgrade dependencies
+### Message Format Conversion
 
-Install the `@ai-v5` prerelease version of all Mastra packages:
-
-<Tabs items={["npm", "yarn", "pnpm", "bun"]}>
-  <Tabs.Tab>
-    ```bash copy
-    npm install mastra@ai-v5 @mastra/core@ai-v5 @mastra/memory@ai-v5
-    ```
-  </Tabs.Tab>
-  <Tabs.Tab>
-    ```bash copy
-    yarn add mastra@ai-v5 @mastra/core@ai-v5 @mastra/memory@ai-v5
-    ```
-  </Tabs.Tab>
-  <Tabs.Tab>
-    ```bash copy
-    pnpm add mastra@ai-v5 @mastra/core@ai-v5 @mastra/memory@ai-v5
-    ```
-  </Tabs.Tab>
-  <Tabs.Tab>
-    ```bash copy
-    bun add mastra@ai-v5 @mastra/core@ai-v5 @mastra/memory@ai-v5
-    ```
-  </Tabs.Tab>
-</Tabs>
+For cases where you need to manually convert messages between AI SDK and Mastra formats, use the `convertMessages` utility:
 
-Configure your Mastra instance with `v4` compatibility so your frontend, and the Mastra Playground will continue to work:
+```typescript
+import { convertMessages } from '@mastra/core';
 
-```typescript {7} filename="mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+// Convert AI SDK v4 messages to v5
+const aiv5Messages = convertMessages(aiv4Messages).to('AIV5.UI');
 
-import { weatherAgent } from "./agents/weather-agent";
+// Convert Mastra messages to AI SDK v5
+const aiv5Messages = convertMessages(mastraMessages).to('AIV5.Core');
 
-export const mastra = new Mastra({
-  agents: { weatherAgent },
-  aiSdkCompat: 'v4',
-});
+// Supported output formats:
+// 'Mastra.V2', 'AIV4.UI', 'AIV5.UI', 'AIV5.Core', 'AIV5.Model'
 ```
 
-### Enabling stream compatibility
+This utility is helpful when you want to fetch messages directly from your storage DB and convert them for use in AI SDK.
 
-If your frontend calls a Mastra agent using a custom API route, wrap the `toUIMessageStreamResponse()` result with `createV4CompatibleResponse` to maintain AI SDK `v4` compatibility.
+### Enabling stream compatibility
 
+To enable AI SDK v5 compatibility, use the experimental `streamVNext` method with the `format` parameter:
 
 ```typescript filename="app/api/chat/route.ts" showLineNumbers copy
 import { mastra } from "../../../mastra";
-import { createV4CompatibleResponse } from "@mastra/core/agent";
 
 export async function POST(req: Request) {
   const { messages } = await req.json();
   const myAgent = mastra.getAgent("weatherAgent");
-  const stream = await myAgent.stream(messages);
+  
+  // Use streamVNext with AI SDK v5 format (experimental)
+  const stream = await myAgent.streamVNext(messages, {
+    format: 'aisdk'
+  });
 
-  return createV4CompatibleResponse(stream.toUIMessageStreamResponse().body!);
+  return stream.toUIMessageStreamResponse();
 }
 ```
 
-### Frontend upgrade
-
-When you're ready, remove the compatibility flag and upgrade your frontend:
-
-1. Remove `aiSdkCompat: 'v4'` from your Mastra configuration
-2. Follow the AI SDK guide on upgrading your frontend dependencies
-3. Update your frontend code for v5 breaking changes
-
-
+<Callout type="info">
+  **Note**: The `streamVNext` method with format support is experimental and may change as we refine the feature based on feedback. See the [Agent Streaming documentation](/docs/agents/streaming) for more details about streamVNext.
+</Callout>

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

@@ -8,15 +8,21 @@ import { Callout } from "nextra/components";
 # Agent.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.
+  **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>
 
-The `.streamVNext()` method enables real-time streaming of responses from an agent with enhanced capabilities. This method accepts messages and optional streaming options, providing a next-generation streaming experience that will eventually replace the current `stream()` method.
+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.
 
 ## Usage example
 
 ```typescript copy
-await agent.streamVNext("message for agent");
+// Default Mastra format
+const mastraStream = await agent.streamVNext("message for agent");
+
+// AI SDK v5 compatible format
+const aiSdkStream = await agent.streamVNext("message for agent", {
+  format: 'aisdk'
+});
 ```
 
 ## Parameters
@@ -30,7 +36,7 @@ await agent.streamVNext("message for agent");
     },
     {
       name: "options",
-      type: "AgentExecutionOptions<Output, StructuredOutput>",
+      type: "AgentExecutionOptions<Output, StructuredOutput, Format>",
       isOptional: true,
       description: "Optional configuration for the streaming process.",
     },
@@ -41,6 +47,13 @@ await agent.streamVNext("message for agent");
 
 <PropertiesTable
   content={[
+    {
+      name: "format",
+      type: "'mastra' | 'aisdk'",
+      isOptional: true,
+      defaultValue: "'mastra'",
+      description: "Determines the output stream format. Use 'mastra' for Mastra's native format (default) or 'aisdk' for AI SDK v5 compatibility.",
+    },
     {
       name: "abortSignal",
       type: "AbortSignal",
@@ -167,13 +180,6 @@ await agent.streamVNext("message for agent");
         }
       ]
     },
-    {
-      name: "maxSteps",
-      type: "number",
-      isOptional: true,
-      defaultValue: "5",
-      description: "Maximum number of execution steps allowed.",
-    },
     {
       name: "maxRetries",
       type: "number",
@@ -251,11 +257,77 @@ await agent.streamVNext("message for agent");
       ]
     },
     {
-      name: "temperature",
-      type: "number",
+      name: "modelSettings",
+      type: "CallSettings",
       isOptional: true,
       description:
-        "Controls randomness in the model's output. Higher values (e.g., 0.8) make the output more random, lower values (e.g., 0.2) make it more focused and deterministic.",
+        "Model-specific settings like temperature, maxTokens, topP, etc. These are passed to the underlying language model.",
+      properties: [
+        {
+          parameters: [{
+            name: "temperature",
+            type: "number",
+            isOptional: true,
+            description: "Controls randomness in the model's output. Higher values (e.g., 0.8) make the output more random, lower values (e.g., 0.2) make it more focused and deterministic."
+          }]
+        },
+        {
+          parameters: [{
+            name: "maxTokens",
+            type: "number",
+            isOptional: true,
+            description: "Maximum number of tokens to generate."
+          }]
+        },
+        {
+          parameters: [{
+            name: "topP",
+            type: "number",
+            isOptional: true,
+            description: "Nucleus sampling. This is a number between 0 and 1. It is recommended to set either temperature or topP, but not both."
+          }]
+        },
+        {
+          parameters: [{
+            name: "topK",
+            type: "number",
+            isOptional: true,
+            description: "Only sample from the top K options for each subsequent token. Used to remove 'long tail' low probability responses."
+          }]
+        },
+        {
+          parameters: [{
+            name: "presencePenalty",
+            type: "number",
+            isOptional: true,
+            description: "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition)."
+          }]
+        },
+        {
+          parameters: [{
+            name: "frequencyPenalty",
+            type: "number",
+            isOptional: true,
+            description: "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition)."
+          }]
+        },
+        {
+          parameters: [{
+            name: "stopSequences",
+            type: "string[]",
+            isOptional: true,
+            description: "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated."
+          }]
+        },
+        {
+          parameters: [{
+            name: "seed",
+            type: "number",
+            isOptional: true,
+            description: "The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results."
+          }]
+        }
+      ]
     },
     {
       name: "threadId",
@@ -380,64 +452,16 @@ await agent.streamVNext("message for agent");
       description: "Generate a unique ID for each message.",
     },
     {
-      name: "maxTokens",
-      type: "number",
+      name: "stopWhen",
+      type: "StopCondition | StopCondition[]",
       isOptional: true,
-      description: "Maximum number of tokens to generate.",
-    },
-    {
-      name: "topP",
-      type: "number",
-      isOptional: true,
-      description: "Nucleus sampling. This is a number between 0 and 1. It is recommended to set either `temperature` or `topP`, but not both.",
-    },
-    {
-      name: "topK",
-      type: "number",
-      isOptional: true,
-      description: "Only sample from the top K options for each subsequent token. Used to remove 'long tail' low probability responses.",
-    },
-    {
-      name: "presencePenalty",
-      type: "number",
-      isOptional: true,
-      description: "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
-    },
-    {
-      name: "frequencyPenalty",
-      type: "number",
-      isOptional: true,
-      description: "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
-    },
-    {
-      name: "stopSequences",
-      type: "string[]",
-      isOptional: true,
-      description: "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.",
-    },
-    {
-      name: "seed",
-      type: "number",
-      isOptional: true,
-      description: "The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results.",
+      description: "Condition(s) that determine when to stop the agent's execution. Can be a single condition or array of conditions.",
     },
     {
       name: "headers",
       type: "Record<string, string | undefined>",
       isOptional: true,
       description: "Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.",
-    },
-    {
-      name: "system",
-      type: "string",
-      isOptional: true,
-      description: "System message to include in the prompt. Can be used with `prompt` or `messages`.",
-    },
-    {
-      name: "prompt",
-      type: "string",
-      isOptional: true,
-      description: "A simple text prompt. You can either use `prompt` or `messages` but not both.",
     }
   ]}
 />
@@ -448,25 +472,78 @@ await agent.streamVNext("message for agent");
   content={[
     {
       name: "stream",
-      type: "MastraAgentStream<Output extends ZodSchema ? z.infer<Output> : StructuredOutput extends ZodSchema ? z.infer<StructuredOutput> : unknown>",
-      description: "A streaming interface that provides enhanced streaming capabilities for text and structured output.",
+      type: "MastraModelOutput<Output> | AISDKV5OutputStream<Output>",
+      description: "Returns a streaming interface based on the format parameter. When format is 'mastra' (default), returns MastraModelOutput. When format is 'aisdk', returns AISDKV5OutputStream for AI SDK v5 compatibility.",
     },
   ]}
 />
 
 ## Extended usage example
 
+### Mastra Format (Default)
+
+```typescript showLineNumbers copy
+import { stepCountIs } from 'ai-v5';
+
+const stream = await agent.streamVNext("Tell me a story", {
+  stopWhen: stepCountIs(3), // Stop after 3 steps
+  modelSettings: {
+    temperature: 0.7,
+  },
+});
+
+// Access text stream
+for await (const chunk of stream.textStream) {
+  console.log(chunk);
+}
+
+// Get full text after streaming
+const fullText = await stream.text;
+```
+
+### AI SDK v5 Format
+
+```typescript showLineNumbers copy
+import { stepCountIs } from 'ai-v5';
+
+const stream = await agent.streamVNext("Tell me a story", {
+  format: 'aisdk',
+  stopWhen: stepCountIs(3), // Stop after 3 steps
+  modelSettings: {
+    temperature: 0.7,
+  },
+});
+
+// Use with AI SDK v5 compatible interfaces
+for await (const part of stream.fullStream) {
+  if (part.type === 'text-delta') {
+    console.log(part.text);
+  }
+}
+
+// In an API route for frontend integration
+return stream.toUIMessageStreamResponse();
+```
+
+### Advanced Example with Options
+
 ```typescript showLineNumbers copy
 import { z } from "zod";
-import { ModerationProcessor, BatchPartsProcessor } from "@mastra/core/processors";
+import { stepCountIs } from 'ai-v5';
 
 await agent.streamVNext("message for agent", {
-  temperature: 0.7,
-  maxSteps: 3,
+  format: 'aisdk', // Enable AI SDK v5 compatibility
+  stopWhen: stepCountIs(3), // Stop after 3 steps
+  modelSettings: {
+    temperature: 0.7,
+  modelSettings: {
+    temperature: 0.7,
+  },
   memory: {
     thread: "user-123",
     resource: "test-app"
   },
+  },
   toolChoice: "auto",
   // Structured output with better DX
   structuredOutput: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.13-alpha.0",
+  "version": "0.13.13",
   "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.14.1-alpha.0",
+    "@mastra/core": "0.14.1",
     "@mastra/mcp": "^0.10.12"
   },
   "devDependencies": {
@@ -48,8 +48,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.30",
-    "@mastra/core": "0.14.1-alpha.0"
+    "@mastra/core": "0.14.1",
+    "@internal/lint": "0.0.31"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",