@mastra/mcp-docs-server 0.13.37 → 0.13.39-alpha.0

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,37 @@ 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.
-
 ### 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 +56,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 +64,7 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
-  > See [Input Data Mapping](./input-data-mapping.mdx) for more information.
+> See [.map()](/reference/workflows/workflow-methods/map) 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 +79,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 +87,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 +97,25 @@ 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.
-
 ### 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 +127,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 [.map()](/reference/workflows/workflow-methods/map) 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)