@mastra/mcp-docs-server 0.13.37 → 0.13.38

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

@@ -1,5 +1,5 @@
 ---
-title: Speech-to-Speech Capabilities in Mastra | Mastra Docs
+title: "Speech-to-Speech Capabilities in Mastra | Voice | Mastra Docs"
 description: Overview of speech-to-speech capabilities in Mastra, including real-time interactions and event-driven architecture.
 ---
 
@@ -7,7 +7,7 @@ description: Overview of speech-to-speech capabilities in Mastra, including real
 
 ## Introduction
 
-Speech-to-Speech (STS) in Mastra provides a standardized interface for real-time interactions across multiple providers.  
+Speech-to-Speech (STS) in Mastra provides a standardized interface for real-time interactions across multiple providers.
 STS enables continuous bidirectional audio communication through listening to events from Realtime models. Unlike separate TTS and STT operations, STS maintains an open connection that processes speech continuously in both directions.
 
 ## Configuration
@@ -57,7 +57,7 @@ const micStream = getMicrophoneStream();
 await agent.voice.send(micStream);
 ```
 
-For integrating Speech-to-Speech capabilities with agents, refer to the [Adding Voice to Agents](../agents/adding-voice.mdx) documentation.
+For integrating Speech-to-Speech capabilities with agents, refer to the [Adding Voice to Agents](/docs/agents/adding-voice) documentation.
 
 ## Google Gemini Live (Realtime)
 
@@ -67,18 +67,19 @@ import { GeminiLiveVoice } from "@mastra/voice-google-gemini-live";
 import { playAudio, getMicrophoneStream } from "@mastra/node-audio";
 
 const agent = new Agent({
-  name: 'Agent',
-  instructions: 'You are a helpful assistant with real-time voice capabilities.',
+  name: "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"),
   voice: new GeminiLiveVoice({
     apiKey: process.env.GOOGLE_API_KEY,
-    model: 'gemini-2.0-flash-exp',
-    speaker: 'Puck',
+    model: "gemini-2.0-flash-exp",
+    speaker: "Puck",
     debug: true,
     // Vertex AI option:
-    // vertexAI: true, 
-    // project: 'your-gcp-project', 
+    // vertexAI: true,
+    // project: 'your-gcp-project',
     // location: 'us-central1',
     // serviceAccountKeyFile: '/path/to/service-account.json',
   }),
@@ -86,20 +87,21 @@ const agent = new Agent({
 
 await agent.voice.connect();
 
-agent.voice.on('speaker', ({ audio }) => {
+agent.voice.on("speaker", ({ audio }) => {
   playAudio(audio);
 });
 
-agent.voice.on('writing', ({ role, text }) => {
+agent.voice.on("writing", ({ role, text }) => {
   console.log(`${role}: ${text}`);
 });
 
-await agent.voice.speak('How can I help you today?');
+await agent.voice.speak("How can I help you today?");
 
 const micStream = getMicrophoneStream();
 await agent.voice.send(micStream);
 ```
 
 Note:
+
 - Live API requires `GOOGLE_API_KEY`. Vertex AI requires project/location and service account credentials.
 - Events: `speaker` (audio stream), `writing` (text), `turnComplete`, `usage`, and `error`.

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

@@ -1,5 +1,5 @@
 ---
-title: Speech-to-Text (STT) in Mastra | Mastra Docs
+title: "Speech-to-Text (STT) | Voice | Mastra Docs"
 description: Overview of Speech-to-Text capabilities in Mastra, including configuration, usage, and integration with voice providers.
 ---
 
@@ -83,4 +83,4 @@ const { text } = await agent.generate(
 console.log(`Recommendation: ${text}`);
 ```
 
-Check out the [Adding Voice to Agents](../agents/adding-voice.mdx) documentation to learn how to use STT in an agent.
+Check out the [Adding Voice to Agents](/docs/agents/adding-voice) documentation to learn how to use STT in an agent.

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

@@ -1,5 +1,5 @@
 ---
-title: Text-to-Speech (TTS) in Mastra | Mastra Docs
+title: "Text-to-Speech (TTS) | Voice | Mastra Docs"
 description: Overview of Text-to-Speech capabilities in Mastra, including configuration, usage, and integration with voice providers.
 ---
 
@@ -87,4 +87,4 @@ const readableStream = await voice.speak(text, {
 });
 ```
 
-Check out the [Adding Voice to Agents](../agents/adding-voice.mdx) documentation to learn how to use TTS in an agent.
+Check out the [Adding Voice to Agents](/docs/agents/adding-voice) documentation to learn how to use TTS in an agent.

package/.docs/raw/workflows/agents-and-tools.mdx

@@ -15,36 +15,39 @@ Use agents in workflow steps when you need reasoning, language generation, or ot
 
 Call agents inside a step's `execute` function using `.generate()` or `.stream()`. This lets you modify the agent call and handle the response before passing it to the next step.
 
-```typescript {7-12} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7-12} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 const step1 = createStep({
   // ...
   execute: async ({ inputData, mastra }) => {
     const { message } = inputData;
 
     const testAgent = mastra.getAgent("testAgent");
-    const response = await testAgent.generate(`Convert this message into bullet points: ${message}`, {
-      memory: {
-        thread: "user-123",
-        resource: "test-123"
-      }
-    });
+    const response = await testAgent.generate(
+      `Convert this message into bullet points: ${message}`,
+      {
+        memory: {
+          thread: "user-123",
+          resource: "test-123",
+        },
+      },
+    );
 
     return {
-      list: response.text
+      list: response.text,
     };
-  }
+  },
 });
 ```
 
-> See [Calling Agents](../../examples/agents/calling-agents.mdx) for more examples.
+> See [Calling Agents](/examples/agents/calling-agents) for more examples.
 
 ### Agents as steps
 
 Compose an agent as a step using `createStep()` when you don't need to modify the agent call. Use `.map()` to transform the previous step's output into a `prompt` the agent can use.
 
-![Agent as step](/image/workflows/workflows-agent-tools-agent-step.jpg)
+![Agent as step](/img/workflows/workflows-agent-tools-agent-step.jpg)
 
-```typescript {1,3,8-13} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {1,3,8-13} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { testAgent } from "../agents/test-agent";
 
 const step1 = createStep(testAgent);
@@ -55,7 +58,7 @@ export const testWorkflow = createWorkflow({
   .map(async ({ inputData }) => {
     const { message } = inputData;
     return {
-      prompt: `Convert this message into bullet points: ${message}`
+      prompt: `Convert this message into bullet points: ${message}`,
     };
   })
   .then(step1)
@@ -63,7 +66,7 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
-  > See [Input Data Mapping](./input-data-mapping.mdx) for more information.
+> See [Input Data Mapping](./input-data-mapping) for more information.
 
 Mastra agents use a default schema that expects a `prompt` string as input and returns a `text` string as output:
 
@@ -78,7 +81,6 @@ Mastra agents use a default schema that expects a `prompt` string as input and r
 }
 ```
 
-
 ## Using tools in workflows
 
 Use tools in workflow steps to leverage existing tool logic. Call from a step's `execute` function when you need to prepare context or process responses. Compose tools as steps when you don't need to modify how the tool is used.
@@ -87,7 +89,7 @@ Use tools in workflow steps to leverage existing tool logic. Call from a step's
 
 Call tools inside a step's `execute` function using `.execute()`. This gives you more control over the tool's input context, or process its response before passing it to the next step.
 
-```typescript {8-13,16} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {8-13,16} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { testTool } from "../tools/test-tool";
 
 const step2 = createStep({
@@ -97,27 +99,27 @@ const step2 = createStep({
 
     const response = await testTool.execute({
       context: {
-        text: formatted
+        text: formatted,
       },
-      runtimeContext
+      runtimeContext,
     });
 
     return {
-      emphasized: response.emphasized
+      emphasized: response.emphasized,
     };
-  }
+  },
 });
 ```
 
-> See [Calling Tools](../../examples/tools/calling-tools.mdx) for more examples.
+> See [Calling Tools](/examples/workflows_legacy/using-a-tool-as-a-step) for more examples.
 
 ### Tools as steps
 
 Compose a tool as a step using `createStep()` when the previous step's output matches the tool's input context. You can use `.map()` to transform the previous step's output if they don't.
 
-![Tool as step](/image/workflows/workflows-agent-tools-tool-step.jpg)
+![Tool as step](/img/workflows/workflows-agent-tools-tool-step.jpg)
 
-```typescript {1,3,9-14} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {1,3,9-14} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { testTool } from "../tools/test-tool";
 
 const step2 = createStep(testTool);
@@ -129,17 +131,16 @@ export const testWorkflow = createWorkflow({
   .map(async ({ inputData }) => {
     const { formatted } = inputData;
     return {
-      text: formatted
+      text: formatted,
     };
   })
   .then(step2)
   .commit();
 ```
 
-> See [Input Data Mapping](./input-data-mapping.mdx) for more information.
+> See [Input Data Mapping](./input-data-mapping) for more information.
 
 ## Related
 
-- [Using Agents](../agents/overview.mdx)
-- [Using Tools](../tools-mcp/overview.mdx)
-
+- [Using Agents](/docs/agents/overview)
+- [Using Tools](../tools-mcp/overview)

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

@@ -1,5 +1,5 @@
 ---
-title: "Branching, Merging, Conditions | Workflows | Mastra Docs"
+title: "Control Flow | Workflows | Mastra Docs"
 description: "Control flow in Mastra workflows allows you to manage branching, merging, and conditions to construct workflows that meet your logic requirements."
 ---
 
@@ -8,15 +8,15 @@ description: "Control flow in Mastra workflows allows you to manage branching, m
 When you build a workflow, you typically break down operations into smaller tasks that can be linked and reused. **Steps** provide a structured way to manage these tasks by defining inputs, outputs, and execution logic.
 
 - If the schemas match, the `outputSchema` from each step is automatically passed to the `inputSchema` of the next step.
-- If the schemas don't match, use [Input data mapping](./input-data-mapping.mdx) to transform the `outputSchema` into the expected `inputSchema`.
+- If the schemas don't match, use [Input data mapping](./input-data-mapping) to transform the `outputSchema` into the expected `inputSchema`.
 
 ## Chaining steps with `.then()`
 
 Chain steps to execute sequentially using `.then()`:
 
-![Chaining steps with .then()](/image/workflows/workflows-control-flow-then.jpg)
+![Chaining steps with .then()](/img/workflows/workflows-control-flow-then.jpg)
 
-```typescript {8-9,4-5} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {8-9,4-5} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -35,9 +35,9 @@ This does what you'd expect: it executes `step1`, then it executes `step2`.
 
 Execute steps simultaneously using `.parallel()`:
 
-![Concurrent steps with .parallel()](/image/workflows/workflows-control-flow-parallel.jpg)
+![Concurrent steps with .parallel()](/img/workflows/workflows-control-flow-parallel.jpg)
 
-```typescript {9,4-5} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {9,4-5} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -53,7 +53,7 @@ export const testWorkflow = createWorkflow({...})
 
 This executes `step1` and `step2` concurrently, then continues to `step3` after both complete.
 
-> See [Parallel Execution with Steps](../../examples/workflows/parallel-steps.mdx) for more information.
+> See [Parallel Execution with Steps](/examples/workflows_legacy/parallel-steps) for more information.
 
 > 📹 Watch: How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/GQJxve5Hki4)
 
@@ -61,9 +61,9 @@ This executes `step1` and `step2` concurrently, then continues to `step3` after
 
 Execute steps conditionally using `.branch()`:
 
-![Conditional branching with .branch()](/image/workflows/workflows-control-flow-branch.jpg)
+![Conditional branching with .branch()](/img/workflows/workflows-control-flow-branch.jpg)
 
-```typescript {8-11,4-5} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {8-11,4-5} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -80,7 +80,7 @@ export const testWorkflow = createWorkflow({...})
 
 Branch conditions are evaluated sequentially, but steps with matching conditions are executed in parallel.
 
-> See [Workflow with Conditional Branching](../../examples/workflows/conditional-branching.mdx) for more information.
+> See [Workflow with Conditional Branching](/examples/workflows_legacy/conditional-branching) for more information.
 
 ## Looping steps
 
@@ -95,9 +95,9 @@ To ensure compatibility, the loop’s initial input must either match the shape
 
 Executes step repeatedly while a condition is true.
 
-![Repeating with .dowhile()](/image/workflows/workflows-control-flow-dowhile.jpg)
+![Repeating with .dowhile()](/img/workflows/workflows-control-flow-dowhile.jpg)
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -112,9 +112,9 @@ export const testWorkflow = createWorkflow({...})
 
 Executes step repeatedly until a condition becomes true.
 
-![Repeating with .dountil()](/image/workflows/workflows-control-flow-dountil.jpg)
+![Repeating with .dountil()](/img/workflows/workflows-control-flow-dountil.jpg)
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -133,7 +133,7 @@ Loop conditions can be implemented in different ways depending on how you want t
 
 The `inputData` for a loop step is the output of a previous step. Use the values in `inputData` to determine whether the loop should continue or stop.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -148,7 +148,7 @@ export const testWorkflow = createWorkflow({...})
 
 The `iterationCount` tracks how many times the loop step has run. You can use this to limit the number of iterations and prevent infinite loops. Combine it with `inputData` values to stop the loop after a set number of attempts.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -163,7 +163,7 @@ export const testWorkflow = createWorkflow({...})
 
 Use `iterationCount` to limit how many times a loop runs. If the count exceeds your threshold, throw an error to fail the step and stop the workflow.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -183,9 +183,9 @@ export const testWorkflow = createWorkflow({...})
 
 Sequentially executes the same step for each item from the `inputSchema`.
 
-![Repeating with .foreach()](/image/workflows/workflows-control-flow-foreach.jpg)
+![Repeating with .foreach()](/img/workflows/workflows-control-flow-foreach.jpg)
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -200,7 +200,7 @@ export const testWorkflow = createWorkflow({...})
 
 Use `concurrency` to execute steps in parallel with a limit on the number of concurrent executions.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -215,7 +215,7 @@ export const testWorkflow = createWorkflow({...})
 
 Use a nested workflow as a step by passing it to `.then()`. This runs each of its steps in sequence as part of the parent workflow.
 
-```typescript {4,7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {4,7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -230,7 +230,7 @@ export const testWorkflow = createWorkflow({...})
 
 Use `cloneWorkflow` to duplicate an existing workflow. This lets you reuse its structure while overriding parameters like `id`.
 
-```typescript {6,10} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {6,10} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep, cloneWorkflow } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -248,13 +248,13 @@ export const testWorkflow = createWorkflow({...})
 
 The following example demonstrates how to start a run with multiple inputs. Each input will pass through the `mapStep` sequentially.
 
-```typescript {6} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {6} title="src/test-workflow.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
 
 const result = await run.start({
-  inputData: [{ number: 10 }, { number: 100 }, { number: 200 }]
+  inputData: [{ number: 10 }, { number: 100 }, { number: 200 }],
 });
 ```
 

package/.docs/raw/workflows/error-handling.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Error Handling in Workflows | Workflows | Mastra Docs"
+title: "Error Handling | Workflows | Mastra Docs"
 description: "Learn how to handle errors in Mastra workflows using step retries, conditional branching, and monitoring."
 ---
 
@@ -11,7 +11,7 @@ Mastra provides a built-in retry mechanism for workflows or steps that fail due
 
 You can configure retries at the workflow level, which applies to all steps in the workflow:
 
-```typescript {8-11} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {8-11} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -32,7 +32,7 @@ export const testWorkflow = createWorkflow({
 
 You can configure retries for individual steps using the `retries` property. This overrides the workflow-level retry configuration for that specific step:
 
-```typescript {17} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {17} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -57,7 +57,7 @@ const step1 = createStep({
 
 You can create alternative workflow paths based on the success or failure of previous steps using conditional logic:
 
-```typescript {15,19,33-34} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {15,19,33-34} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -100,7 +100,7 @@ export const testWorkflow = createWorkflow({
 
 Use `getStepResult()` to inspect a previous step’s results.
 
-```typescript {10} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {10} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -123,7 +123,7 @@ const step2 = createStep({
 
 Use `bail()` in a step to exit early with a successful result. This returns the provided payload as the step output and ends workflow execution.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -145,7 +145,7 @@ export const testWorkflow = createWorkflow({...})
 
 Use `throw new Error()` in a step to exit with an error.
 
-```typescript {7} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript {7} title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -167,7 +167,7 @@ export const testWorkflow = createWorkflow({...})
 
 You can monitor workflows for errors using the `watch` method:
 
-```typescript {11} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {11} title="src/test-workflow.ts" showLineNumbers copy
 import { mastra } from "../src/mastra";
 
 const workflow = mastra.getWorkflow("testWorkflow");
@@ -175,19 +175,18 @@ const run = await workflow.createRunAsync();
 
 run.watch((event) => {
   const {
-    payload: { currentStep }
+    payload: { currentStep },
   } = event;
 
   console.log(currentStep?.payload?.status);
 });
-
 ```
 
 ## Monitor errors with `stream()`
 
 You can monitor workflows for errors using `stream`:
 
-```typescript {11} filename="src/test-workflow.ts" showLineNumbers copy
+```typescript {11} title="src/test-workflow.ts" showLineNumbers copy
 import { mastra } from "../src/mastra";
 
 const workflow = mastra.getWorkflow("testWorkflow");
@@ -196,18 +195,17 @@ const run = await workflow.createRunAsync();
 
 const stream = await run.stream({
   inputData: {
-    value: "initial data"
-  }
+    value: "initial data",
+  },
 });
 
 for await (const chunk of stream.stream) {
   console.log(chunk.payload.output.stats);
 }
-
 ```
 
 ## Related
 
-- [Control Flow](./control-flow.mdx)
-- [Conditional Branching](./control-flow.mdx#conditional-logic-with-branch)
-- [Running Workflows](../../examples/workflows/running-workflows.mdx)
+- [Control Flow](./control-flow)
+- [Conditional Branching](./control-flow#conditional-logic-with-branch)
+- [Running Workflows](/examples/workflows_legacy/creating-a-workflow)