@mastra/mcp-docs-server 1.0.0-beta.3 → 1.0.0-beta.5

package/.docs/raw/voice/overview.mdx

@@ -17,7 +17,6 @@ To learn how to integrate voice capabilities into your agents, check out the [Ad
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { OpenAIVoice } from "@mastra/voice-openai";
 
 // Initialize OpenAI voice for TTS
@@ -27,7 +26,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new OpenAIVoice(),
 });
 ```
@@ -46,7 +45,6 @@ For detailed configuration options and advanced features, check out our [Text-to
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { OpenAIVoice } from "@mastra/voice-openai";
 import { playAudio } from "@mastra/node-audio";
 
@@ -55,7 +53,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new OpenAIVoice(),
 });
 
@@ -77,7 +75,6 @@ Visit the [OpenAI Voice Reference](/reference/v1/voice/openai) for more informat
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { AzureVoice } from "@mastra/voice-azure";
 import { playAudio } from "@mastra/node-audio";
 
@@ -86,7 +83,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new AzureVoice(),
 });
 
@@ -107,7 +104,6 @@ Visit the [Azure Voice Reference](/reference/v1/voice/azure) for more informatio
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { ElevenLabsVoice } from "@mastra/voice-elevenlabs";
 import { playAudio } from "@mastra/node-audio";
 
@@ -116,7 +112,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new ElevenLabsVoice(),
 });
 
@@ -137,7 +133,6 @@ Visit the [ElevenLabs Voice Reference](/reference/v1/voice/elevenlabs) for more
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { PlayAIVoice } from "@mastra/voice-playai";
 import { playAudio } from "@mastra/node-audio";
 
@@ -146,7 +141,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new PlayAIVoice(),
 });
 
@@ -167,7 +162,6 @@ Visit the [PlayAI Voice Reference](/reference/v1/voice/playai) for more informat
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { GoogleVoice } from "@mastra/voice-google";
 import { playAudio } from "@mastra/node-audio";
 
@@ -176,7 +170,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new GoogleVoice(),
 });
 
@@ -197,7 +191,6 @@ Visit the [Google Voice Reference](/reference/v1/voice/google) for more informat
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { CloudflareVoice } from "@mastra/voice-cloudflare";
 import { playAudio } from "@mastra/node-audio";
 
@@ -206,7 +199,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new CloudflareVoice(),
 });
 
@@ -227,7 +220,6 @@ Visit the [Cloudflare Voice Reference](/reference/v1/voice/cloudflare) for more
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { DeepgramVoice } from "@mastra/voice-deepgram";
 import { playAudio } from "@mastra/node-audio";
 
@@ -236,7 +228,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new DeepgramVoice(),
 });
 
@@ -257,7 +249,6 @@ Visit the [Deepgram Voice Reference](/reference/v1/voice/deepgram) for more info
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { SpeechifyVoice } from "@mastra/voice-speechify";
 import { playAudio } from "@mastra/node-audio";
 
@@ -266,7 +257,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new SpeechifyVoice(),
 });
 
@@ -287,7 +278,6 @@ Visit the [Speechify Voice Reference](/reference/v1/voice/speechify) for more in
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { SarvamVoice } from "@mastra/voice-sarvam";
 import { playAudio } from "@mastra/node-audio";
 
@@ -296,7 +286,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new SarvamVoice(),
 });
 
@@ -317,7 +307,6 @@ Visit the [Sarvam Voice Reference](/reference/v1/voice/sarvam) for more informat
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { MurfVoice } from "@mastra/voice-murf";
 import { playAudio } from "@mastra/node-audio";
 
@@ -326,7 +315,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new MurfVoice(),
 });
 
@@ -359,7 +348,6 @@ You can download a sample audio file from [here](https://github.com/mastra-ai/re
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { OpenAIVoice } from "@mastra/voice-openai";
 import { createReadStream } from "fs";
 
@@ -368,7 +356,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new OpenAIVoice(),
 });
 
@@ -391,7 +379,6 @@ Visit the [OpenAI Voice Reference](/reference/v1/voice/openai) for more informat
 ```typescript
 import { createReadStream } from "fs";
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { AzureVoice } from "@mastra/voice-azure";
 import { createReadStream } from "fs";
 
@@ -400,7 +387,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new AzureVoice(),
 });
 
@@ -422,7 +409,6 @@ Visit the [Azure Voice Reference](/reference/v1/voice/azure) for more informatio
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { ElevenLabsVoice } from "@mastra/voice-elevenlabs";
 import { createReadStream } from "fs";
 
@@ -431,7 +417,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new ElevenLabsVoice(),
 });
 
@@ -453,7 +439,6 @@ Visit the [ElevenLabs Voice Reference](/reference/v1/voice/elevenlabs) for more
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { GoogleVoice } from "@mastra/voice-google";
 import { createReadStream } from "fs";
 
@@ -462,7 +447,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new GoogleVoice(),
 });
 
@@ -484,7 +469,6 @@ Visit the [Google Voice Reference](/reference/v1/voice/google) for more informat
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { CloudflareVoice } from "@mastra/voice-cloudflare";
 import { createReadStream } from "fs";
 
@@ -493,7 +477,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new CloudflareVoice(),
 });
 
@@ -515,7 +499,6 @@ Visit the [Cloudflare Voice Reference](/reference/v1/voice/cloudflare) for more
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { DeepgramVoice } from "@mastra/voice-deepgram";
 import { createReadStream } from "fs";
 
@@ -524,7 +507,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new DeepgramVoice(),
 });
 
@@ -546,7 +529,6 @@ Visit the [Deepgram Voice Reference](/reference/v1/voice/deepgram) for more info
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { SarvamVoice } from "@mastra/voice-sarvam";
 import { createReadStream } from "fs";
 
@@ -555,7 +537,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new SarvamVoice(),
 });
 
@@ -585,7 +567,6 @@ For detailed configuration options and advanced features, check out [Speech to S
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { playAudio, getMicrophoneStream } from "@mastra/node-audio";
 import { OpenAIRealtimeVoice } from "@mastra/voice-openai-realtime";
 
@@ -594,7 +575,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new OpenAIRealtimeVoice(),
 });
 
@@ -618,7 +599,6 @@ Visit the [OpenAI Voice Reference](/reference/v1/voice/openai-realtime) for more
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { playAudio, getMicrophoneStream } from "@mastra/node-audio";
 import { GeminiLiveVoice } from "@mastra/voice-google-gemini-live";
 
@@ -627,7 +607,7 @@ const voiceAgent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new GeminiLiveVoice({
     // Live API mode
     apiKey: process.env.GOOGLE_API_KEY,
@@ -918,6 +898,30 @@ const voice = new GeminiLiveVoice({
 Visit the [Google Gemini Live Reference](/reference/v1/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
 
   </TabItem>
+  <TabItem value="aisdk" label="AI SDK">
+
+```typescript
+// AI SDK Voice Configuration
+import { CompositeVoice } from "@mastra/core/voice";
+import { openai } from "@ai-sdk/openai";
+import { elevenlabs } from "@ai-sdk/elevenlabs";
+
+// Use AI SDK models directly - no need to install separate packages
+const voice = new CompositeVoice({
+  input: openai.transcription('whisper-1'),      // AI SDK transcription
+  output: elevenlabs.speech('eleven_turbo_v2'),  // AI SDK speech
+});
+
+// Works seamlessly with your agent
+const voiceAgent = new Agent({
+  id: "aisdk-voice-agent",
+  name: "AI SDK Voice Agent",
+  instructions: "You are a helpful assistant with voice capabilities.",
+  model: openai("gpt-5.1"),
+  voice,
+});
+```
+  </TabItem>
 </Tabs>
 
 ### Using Multiple Voice Providers
@@ -971,6 +975,49 @@ const responseAudio = await voice.speak(`You said: ${transcript}`, {
 playAudio(responseAudio);
 ```
 
+### Using AI SDK Model Providers
+
+You can also use AI SDK models directly with `CompositeVoice`:
+
+```typescript
+import { CompositeVoice } from "@mastra/core/voice";
+import { openai } from "@ai-sdk/openai";
+import { elevenlabs } from "@ai-sdk/elevenlabs";
+import { playAudio, getMicrophoneStream } from "@mastra/node-audio";
+
+// Use AI SDK models directly - no provider setup needed
+const voice = new CompositeVoice({
+  input: openai.transcription('whisper-1'),      // AI SDK transcription
+  output: elevenlabs.speech('eleven_turbo_v2'),  // AI SDK speech
+});
+
+// Works the same way as Mastra providers
+const audioStream = getMicrophoneStream();
+const transcript = await voice.listen(audioStream);
+
+console.log("Transcribed text:", transcript);
+
+// Convert text to speech
+const responseAudio = await voice.speak(`You said: ${transcript}`, {
+  speaker: "Rachel", // ElevenLabs voice
+});
+
+playAudio(responseAudio);
+```
+
+You can also mix AI SDK models with Mastra providers:
+
+```typescript
+import { CompositeVoice } from "@mastra/core/voice";
+import { PlayAIVoice } from "@mastra/voice-playai";
+import { groq } from "@ai-sdk/groq";
+
+const voice = new CompositeVoice({
+  input: groq.transcription('whisper-large-v3'),  // AI SDK for STT
+  output: new PlayAIVoice(),                       // Mastra provider for TTS
+});
+```
+
 For more information on the CompositeVoice, refer to the [CompositeVoice Reference](/reference/v1/voice/composite-voice).
 
 ## More Resources

package/.docs/raw/voice/speech-to-speech.mdx

@@ -13,13 +13,13 @@ STS enables continuous bidirectional audio communication through listening to ev
 ## Configuration
 
 - **`apiKey`**: Your OpenAI API key. Falls back to the `OPENAI_API_KEY` environment variable.
-- **`model`**: The model ID to use for real-time voice interactions (e.g., `gpt-4o-mini-realtime`).
+- **`model`**: The model ID to use for real-time voice interactions (e.g., `gpt-5.1-realtime`).
 - **`speaker`**: The default voice ID for speech synthesis. This allows you to specify which voice to use for the speech output.
 
 ```typescript
 const voice = new OpenAIRealtimeVoice({
   apiKey: "your-openai-api-key",
-  model: "gpt-4o-mini-realtime",
+  model: "gpt-5.1-realtime",
   speaker: "alloy", // Default voice
 });
 
@@ -38,7 +38,7 @@ const agent = new Agent({
   id: "agent",
   name: "OpenAI Realtime Agent",
   instructions: `You are a helpful assistant with real-time voice capabilities.`,
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new OpenAIRealtimeVoice(),
 });
 
@@ -73,7 +73,7 @@ const agent = new Agent({
   instructions:
     "You are a helpful assistant with real-time voice capabilities.",
   // Model used for text generation; voice provider handles realtime audio
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice: new GeminiLiveVoice({
     apiKey: process.env.GOOGLE_API_KEY,
     model: "gemini-2.0-flash-exp",

package/.docs/raw/voice/speech-to-text.mdx

@@ -54,7 +54,6 @@ The primary method for STT is the `listen()` method, which converts spoken audio
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { OpenAIVoice } from "@mastra/voice-openai";
 import { getMicrophoneStream } from "@mastra/node-audio";
 
@@ -65,7 +64,7 @@ const agent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that provides recommendations based on user input.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice,
 });
 

package/.docs/raw/voice/text-to-speech.mdx

@@ -62,7 +62,6 @@ The primary method for TTS is the `speak()` method, which converts text to speec
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 import { OpenAIVoice } from "@mastra/voice-openai";
 
 const voice = new OpenAIVoice();
@@ -72,7 +71,7 @@ const agent = new Agent({
   name: "Voice Agent",
   instructions:
     "You are a voice assistant that can help users with their tasks.",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   voice,
 });
 

package/.docs/raw/workflows/control-flow.mdx

@@ -112,6 +112,70 @@ export const testWorkflow = createWorkflow({
 
 > 📹 Watch: How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/GQJxve5Hki4)
 
+### Output structure
+
+When steps run in parallel, the output is an object where each key is the step's `id` and the value is that step's output. This allows you to access each parallel step's result independently.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const step1 = createStep({
+  id: "format-step",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ formatted: z.string() }),
+  execute: async ({ inputData }) => ({
+    formatted: inputData.message.toUpperCase()
+  })
+});
+
+const step2 = createStep({
+  id: "count-step",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ count: z.number() }),
+  execute: async ({ inputData }) => ({
+    count: inputData.message.length
+  })
+});
+
+const step3 = createStep({
+  id: "combine-step",
+  // The inputSchema must match the structure of parallel outputs
+  inputSchema: z.object({
+    "format-step": z.object({ formatted: z.string() }),
+    "count-step": z.object({ count: z.number() })
+  }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => {
+    // Access each parallel step's output by its id
+    const formatted = inputData["format-step"].formatted;
+    const count = inputData["count-step"].count;
+    return {
+      result: `${formatted} (${count} characters)`
+    };
+  }
+});
+
+export const testWorkflow = createWorkflow({
+  id: "parallel-output-example",
+  inputSchema: z.object({ message: z.string() }),
+  outputSchema: z.object({ result: z.string() })
+})
+  .parallel([step1, step2])
+  .then(step3)
+  .commit();
+
+// When executed with { message: "hello" }
+// The parallel output structure will be:
+// {
+//   "format-step": { formatted: "HELLO" },
+//   "count-step": { count: 5 }
+// }
+```
+
+**Key points:**
+- Each parallel step's output is keyed by its `id`
+- All parallel steps execute simultaneously
+- The next step receives an object containing all parallel step outputs
+- You must define the `inputSchema` of the following step to match this structure
+
 ## Conditional logic with `.branch()`
 
 Use `.branch()` to choose which step to run based on a condition. All steps in a branch need the same `inputSchema` and `outputSchema` because branching requires consistent schemas so workflows can follow different paths.
@@ -158,6 +222,85 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
+### Output structure
+
+When using conditional branching, only one branch executes based on which condition evaluates to `true` first. The output structure is similar to `.parallel()`, where the result is keyed by the executed step's `id`.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const step1 = createStep({
+  id: "initial-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ value: z.number() }),
+  execute: async ({ inputData }) => inputData
+});
+
+const highValueStep = createStep({
+  id: "high-value-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => ({
+    result: `High value: ${inputData.value}`
+  })
+});
+
+const lowValueStep = createStep({
+  id: "low-value-step",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ result: z.string() }),
+  execute: async ({ inputData }) => ({
+    result: `Low value: ${inputData.value}`
+  })
+});
+
+const finalStep = createStep({
+  id: "final-step",
+  // The inputSchema must account for either branch's output
+  inputSchema: z.object({
+    "high-value-step": z.object({ result: z.string() }).optional(),
+    "low-value-step": z.object({ result: z.string() }).optional()
+  }),
+  outputSchema: z.object({ message: z.string() }),
+  execute: async ({ inputData }) => {
+    // Only one branch will have executed
+    const result = inputData["high-value-step"]?.result || 
+                   inputData["low-value-step"]?.result;
+    return { message: result };
+  }
+});
+
+export const testWorkflow = createWorkflow({
+  id: "branch-output-example",
+  inputSchema: z.object({ value: z.number() }),
+  outputSchema: z.object({ message: z.string() })
+})
+  .then(step1)
+  .branch([
+    [async ({ inputData }) => inputData.value > 10, highValueStep],
+    [async ({ inputData }) => inputData.value <= 10, lowValueStep]
+  ])
+  .then(finalStep)
+  .commit();
+
+// When executed with { value: 15 }
+// Only the high-value-step executes, output structure:
+// {
+//   "high-value-step": { result: "High value: 15" }
+// }
+
+// When executed with { value: 5 }
+// Only the low-value-step executes, output structure:
+// {
+//   "low-value-step": { result: "Low value: 5" }
+// }
+```
+
+**Key points:**
+- Only one branch executes based on condition evaluation order
+- The output is keyed by the executed step's `id`
+- Subsequent steps should handle all possible branch outputs
+- Use optional fields in the `inputSchema` when the next step needs to handle multiple possible branches
+- Conditions are evaluated in the order they're defined
+
 ## Input data mapping
 
 When using `.then()`, `.parallel()`, or `.branch()`, it is sometimes necessary to transform the output of a previous step to match the input of the next. In these cases you can use `.map()` to access the `inputData` and transform it to create a suitable data shape for the next step.
@@ -188,6 +331,43 @@ The `.map()` method provides additional helper functions for more complex mappin
 - [`getInitData()`](/reference/v1/workflows/workflow-methods/map#using-getinitdata): Access the workflow's initial input data
 - [`mapVariable()`](/reference/v1/workflows/workflow-methods/map#using-mapvariable): Use declarative object syntax to extract and rename fields
 
+### Parallel and Branch outputs
+
+When working with `.parallel()` or `.branch()` outputs, you can use `.map()` to transform the data structure before passing it to the next step. This is especially useful when you need to flatten or restructure the output.
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+export const testWorkflow = createWorkflow({...})
+  .parallel([step1, step2])
+  .map(async ({ inputData }) => {
+    // Transform the parallel output structure
+    return {
+      combined: `${inputData["step1"].value} - ${inputData["step2"].value}`
+    };
+  })
+  .then(nextStep)
+  .commit();
+```
+
+You can also use the helper functions provided by `.map()`:
+
+```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+export const testWorkflow = createWorkflow({...})
+  .branch([
+    [condition1, stepA],
+    [condition2, stepB]
+  ])
+  .map(async ({ inputData, getStepResult }) => {
+    // Access specific step results
+    const stepAResult = getStepResult("stepA");
+    const stepBResult = getStepResult("stepB");
+    
+    // Return the result from whichever branch executed
+    return stepAResult || stepBResult;
+  })
+  .then(nextStep)
+  .commit();
+```
+
 ## Looping steps
 
 Workflows support different looping methods that let you repeat steps until or while a condition is met, or iterate over arrays. Loops can be combined with other control methods like `.then()`.

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

@@ -253,7 +253,7 @@ const result = await run.stream({
   }
 });
 
-for await (const chunk of result.stream) {
+for await (const chunk of result.fullStream) {
   console.log(chunk);
 }
 ```