@mastra/mcp-docs-server 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

package/.docs/raw/reference/voice/azure.mdx

@@ -1,218 +0,0 @@
----
-title: "Reference: Azure Voice | Voice Providers | Mastra Docs"
-description: "Documentation for the AzureVoice class, providing text-to-speech and speech-to-text capabilities using Azure Cognitive Services."
----
-
-# Azure
-
-The AzureVoice class in Mastra provides text-to-speech and speech-to-text capabilities using Microsoft Azure Cognitive Services.
-
-## Usage Example
-
-```typescript
-import { AzureVoice } from "@mastra/voice-azure";
-
-// Initialize with configuration
-const voice = new AzureVoice({
-  speechModel: {
-    name: "neural",
-    apiKey: "your-azure-speech-api-key",
-    region: "eastus",
-  },
-  listeningModel: {
-    name: "whisper",
-    apiKey: "your-azure-speech-api-key",
-    region: "eastus",
-  },
-  speaker: "en-US-JennyNeural", // Default voice
-});
-
-// Convert text to speech
-const audioStream = await voice.speak("Hello, how can I help you?", {
-  speaker: "en-US-GuyNeural", // Override default voice
-  style: "cheerful", // Voice style
-});
-
-// Convert speech to text
-const text = await voice.listen(audioStream, {
-  filetype: "wav",
-  language: "en-US",
-});
-```
-
-## Configuration
-
-### Constructor Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "speechModel",
-      type: "AzureSpeechConfig",
-      description: "Configuration for text-to-speech synthesis.",
-      isOptional: true,
-    },
-    {
-      name: "listeningModel",
-      type: "AzureSpeechConfig",
-      description: "Configuration for speech-to-text recognition.",
-      isOptional: true,
-    },
-    {
-      name: "speaker",
-      type: "string",
-      description: "Default voice ID for speech synthesis.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-### AzureSpeechConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "'neural' | 'standard' | 'whisper'",
-      description: "Model type to use. 'neural' for TTS, 'whisper' for STT.",
-      isOptional: true,
-    },
-    {
-      name: "apiKey",
-      type: "string",
-      description:
-        "Azure Speech Services API key. Falls back to AZURE_SPEECH_KEY environment variable.",
-      isOptional: true,
-    },
-    {
-      name: "region",
-      type: "string",
-      description:
-        "Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE_SPEECH_REGION environment variable.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Methods
-
-### speak()
-
-Converts text to speech using Azure's neural text-to-speech service.
-
-<PropertiesTable
-  content={[
-    {
-      name: "input",
-      type: "string | NodeJS.ReadableStream",
-      description: "Text or text stream to convert to speech.",
-      isOptional: false,
-    },
-    {
-      name: "options.speaker",
-      type: "string",
-      description: "Voice ID to use for speech synthesis.",
-      isOptional: true,
-      defaultValue: "Constructor's speaker value",
-    },
-    {
-      name: "options.style",
-      type: "string",
-      description: "Speaking style (e.g., 'cheerful', 'sad', 'angry').",
-      isOptional: true,
-    },
-    {
-      name: "options.rate",
-      type: "string",
-      description: "Speaking rate (e.g., 'slow', 'medium', 'fast').",
-      isOptional: true,
-    },
-    {
-      name: "options.pitch",
-      type: "string",
-      description: "Voice pitch (e.g., 'low', 'medium', 'high').",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Returns: `Promise<NodeJS.ReadableStream>`
-
-### listen()
-
-Transcribes audio using Azure's speech-to-text service.
-
-<PropertiesTable
-  content={[
-    {
-      name: "audioStream",
-      type: "NodeJS.ReadableStream",
-      description: "Audio stream to transcribe.",
-      isOptional: false,
-    },
-    {
-      name: "options.filetype",
-      type: "string",
-      description: "Audio format of the input stream.",
-      isOptional: true,
-      defaultValue: "'wav'",
-    },
-    {
-      name: "options.language",
-      type: "string",
-      description: "Language code for transcription.",
-      isOptional: true,
-      defaultValue: "'en-US'",
-    },
-  ]}
-/>
-
-Returns: `Promise<string>`
-
-### getSpeakers()
-
-Returns an array of available voice options, where each node contains:
-
-<PropertiesTable
-  content={[
-    {
-      name: "voiceId",
-      type: "string",
-      description:
-        "Unique identifier for the voice (e.g., 'en-US-JennyNeural')",
-      isOptional: false,
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Human-readable name of the voice",
-      isOptional: false,
-    },
-    {
-      name: "locale",
-      type: "string",
-      description: "Language locale of the voice (e.g., 'en-US')",
-      isOptional: false,
-    },
-    {
-      name: "gender",
-      type: "string",
-      description: "Gender of the voice ('Male' or 'Female')",
-      isOptional: false,
-    },
-    {
-      name: "styles",
-      type: "string[]",
-      description: "Available speaking styles for the voice",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Notes
-
-- API keys can be provided via constructor options or environment variables (AZURE_SPEECH_KEY and AZURE_SPEECH_REGION)
-- Azure offers a wide range of neural voices across many languages
-- Some voices support speaking styles like cheerful, sad, angry, etc.
-- Speech recognition supports multiple audio formats and languages
-- Azure's speech services provide high-quality neural voices with natural-sounding speech

package/.docs/raw/reference/voice/cloudflare.mdx

@@ -1,154 +0,0 @@
----
-title: "Reference: Cloudflare Voice | Voice Providers | Mastra Docs"
-description: "Documentation for the CloudflareVoice class, providing text-to-speech capabilities using Cloudflare Workers AI."
----
-
-# Cloudflare
-
-The CloudflareVoice class in Mastra provides text-to-speech capabilities using Cloudflare Workers AI. This provider specializes in efficient, low-latency speech synthesis suitable for edge computing environments.
-
-## Usage Example
-
-```typescript
-import { CloudflareVoice } from "@mastra/voice-cloudflare";
-
-// Initialize with configuration
-const voice = new CloudflareVoice({
-  speechModel: {
-    name: "@cf/meta/m2m100-1.2b",
-    apiKey: "your-cloudflare-api-token",
-    accountId: "your-cloudflare-account-id",
-  },
-  speaker: "en-US-1", // Default voice
-});
-
-// Convert text to speech
-const audioStream = await voice.speak("Hello, how can I help you?", {
-  speaker: "en-US-2", // Override default voice
-});
-
-// Get available voices
-const speakers = await voice.getSpeakers();
-console.log(speakers);
-```
-
-## Configuration
-
-### Constructor Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "speechModel",
-      type: "CloudflareSpeechConfig",
-      description: "Configuration for text-to-speech synthesis.",
-      isOptional: true,
-    },
-    {
-      name: "speaker",
-      type: "string",
-      description: "Default voice ID for speech synthesis.",
-      isOptional: true,
-      defaultValue: "'en-US-1'",
-    },
-  ]}
-/>
-
-### CloudflareSpeechConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "string",
-      description: "Model name to use for TTS.",
-      isOptional: true,
-      defaultValue: "'@cf/meta/m2m100-1.2b'",
-    },
-    {
-      name: "apiKey",
-      type: "string",
-      description:
-        "Cloudflare API token with Workers AI access. Falls back to CLOUDFLARE_API_TOKEN environment variable.",
-      isOptional: true,
-    },
-    {
-      name: "accountId",
-      type: "string",
-      description:
-        "Cloudflare account ID. Falls back to CLOUDFLARE_ACCOUNT_ID environment variable.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Methods
-
-### speak()
-
-Converts text to speech using Cloudflare's text-to-speech service.
-
-<PropertiesTable
-  content={[
-    {
-      name: "input",
-      type: "string | NodeJS.ReadableStream",
-      description: "Text or text stream to convert to speech.",
-      isOptional: false,
-    },
-    {
-      name: "options.speaker",
-      type: "string",
-      description: "Voice ID to use for speech synthesis.",
-      isOptional: true,
-      defaultValue: "Constructor's speaker value",
-    },
-    {
-      name: "options.format",
-      type: "string",
-      description: "Output audio format.",
-      isOptional: true,
-      defaultValue: "'mp3'",
-    },
-  ]}
-/>
-
-Returns: `Promise<NodeJS.ReadableStream>`
-
-### getSpeakers()
-
-Returns an array of available voice options, where each node contains:
-
-<PropertiesTable
-  content={[
-    {
-      name: "voiceId",
-      type: "string",
-      description: "Unique identifier for the voice (e.g., 'en-US-1')",
-      isOptional: false,
-    },
-    {
-      name: "language",
-      type: "string",
-      description: "Language code of the voice (e.g., 'en-US')",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Notes
-
-- API tokens can be provided via constructor options or environment variables (CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID)
-- Cloudflare Workers AI is optimized for edge computing with low latency
-- This provider only supports text-to-speech (TTS) functionality, not speech-to-text (STT)
-- The service integrates well with other Cloudflare Workers products
-- For production use, ensure your Cloudflare account has the appropriate Workers AI subscription
-- Voice options are more limited compared to some other providers, but performance at the edge is excellent
-
-## Related Providers
-
-If you need speech-to-text capabilities in addition to text-to-speech, consider using one of these providers:
-
-- [OpenAI](./openai) - Provides both TTS and STT
-- [Google](./google) - Provides both TTS and STT
-- [Azure](./azure) - Provides both TTS and STT

package/.docs/raw/reference/voice/composite-voice.mdx

@@ -1,144 +0,0 @@
----
-title: "Reference: CompositeVoice | Voice Providers | Mastra Docs"
-description: "Documentation for the CompositeVoice class, which enables combining multiple voice providers for flexible text-to-speech and speech-to-text operations."
----
-
-# CompositeVoice
-
-The CompositeVoice class allows you to combine different voice providers for text-to-speech and speech-to-text operations. This is particularly useful when you want to use the best provider for each operation - for example, using OpenAI for speech-to-text and PlayAI for text-to-speech.
-
-CompositeVoice is used internally by the Agent class to provide flexible voice capabilities.
-
-## Usage Example
-
-```typescript
-import { CompositeVoice } from "@mastra/core/voice";
-import { OpenAIVoice } from "@mastra/voice-openai";
-import { PlayAIVoice } from "@mastra/voice-playai";
-
-// Create voice providers
-const openai = new OpenAIVoice();
-const playai = new PlayAIVoice();
-
-// Use OpenAI for listening (speech-to-text) and PlayAI for speaking (text-to-speech)
-const voice = new CompositeVoice({
-  input: openai,
-  output: playai,
-});
-
-// Convert speech to text using OpenAI
-const text = await voice.listen(audioStream);
-
-// Convert text to speech using PlayAI
-const audio = await voice.speak("Hello, world!");
-```
-
-## Constructor Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "config",
-      type: "object",
-      description: "Configuration object for the composite voice service",
-      isOptional: false,
-    },
-    {
-      name: "config.input",
-      type: "MastraVoice",
-      description: "Voice provider to use for speech-to-text operations",
-      isOptional: true,
-    },
-    {
-      name: "config.output",
-      type: "MastraVoice",
-      description: "Voice provider to use for text-to-speech operations",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Methods
-
-### speak()
-
-Converts text to speech using the configured speaking provider.
-
-<PropertiesTable
-  content={[
-    {
-      name: "input",
-      type: "string | NodeJS.ReadableStream",
-      description: "Text to convert to speech",
-      isOptional: false,
-    },
-    {
-      name: "options",
-      type: "object",
-      description: "Provider-specific options passed to the speaking provider",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Notes:
-
-- If no speaking provider is configured, this method will throw an error
-- Options are passed through to the configured speaking provider
-- Returns a stream of audio data
-
-### listen()
-
-Converts speech to text using the configured listening provider.
-
-<PropertiesTable
-  content={[
-    {
-      name: "audioStream",
-      type: "NodeJS.ReadableStream",
-      description: "Audio stream to convert to text",
-      isOptional: false,
-    },
-    {
-      name: "options",
-      type: "object",
-      description: "Provider-specific options passed to the listening provider",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Notes:
-
-- If no listening provider is configured, this method will throw an error
-- Options are passed through to the configured listening provider
-- Returns either a string or a stream of transcribed text, depending on the provider
-
-### getSpeakers()
-
-Returns a list of available voices from the speaking provider, where each node contains:
-
-<PropertiesTable
-  content={[
-    {
-      name: "voiceId",
-      type: "string",
-      description: "Unique identifier for the voice",
-      isOptional: false,
-    },
-    {
-      name: "key",
-      type: "value",
-      description:
-        "Additional voice properties that vary by provider (e.g., name, language)",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Notes:
-
-- Returns voices from the speaking provider only
-- If no speaking provider is configured, returns an empty array
-- Each voice object will have at least a voiceId property
-- Additional voice properties depend on the speaking provider

package/.docs/raw/reference/voice/deepgram.mdx

@@ -1,166 +0,0 @@
----
-title: "Reference: Deepgram Voice | Voice Providers | Mastra Docs"
-description: "Documentation for the Deepgram voice implementation, providing text-to-speech and speech-to-text capabilities with multiple voice models and languages."
----
-
-# Deepgram
-
-The Deepgram voice implementation in Mastra provides text-to-speech (TTS) and speech-to-text (STT) capabilities using Deepgram's API. It supports multiple voice models and languages, with configurable options for both speech synthesis and transcription.
-
-## Usage Example
-
-```typescript
-import { DeepgramVoice } from "@mastra/voice-deepgram";
-
-// Initialize with default configuration (uses DEEPGRAM_API_KEY environment variable)
-const voice = new DeepgramVoice();
-
-// Initialize with custom configuration
-const voice = new DeepgramVoice({
-  speechModel: {
-    name: "aura",
-    apiKey: "your-api-key",
-  },
-  listeningModel: {
-    name: "nova-2",
-    apiKey: "your-api-key",
-  },
-  speaker: "asteria-en",
-});
-
-// Text-to-Speech
-const audioStream = await voice.speak("Hello, world!");
-
-// Speech-to-Text
-const transcript = await voice.listen(audioStream);
-```
-
-## Constructor Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "speechModel",
-      type: "DeepgramVoiceConfig",
-      description: "Configuration for text-to-speech functionality.",
-      isOptional: true,
-      defaultValue: "{ name: 'aura' }",
-    },
-    {
-      name: "listeningModel",
-      type: "DeepgramVoiceConfig",
-      description: "Configuration for speech-to-text functionality.",
-      isOptional: true,
-      defaultValue: "{ name: 'nova' }",
-    },
-    {
-      name: "speaker",
-      type: "DeepgramVoiceId",
-      description: "Default voice to use for text-to-speech",
-      isOptional: true,
-      defaultValue: "'asteria-en'",
-    },
-  ]}
-/>
-
-### DeepgramVoiceConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "DeepgramModel",
-      description: "The Deepgram model to use",
-      isOptional: true,
-    },
-    {
-      name: "apiKey",
-      type: "string",
-      description:
-        "Deepgram API key. Falls back to DEEPGRAM_API_KEY environment variable",
-      isOptional: true,
-    },
-    {
-      name: "properties",
-      type: "Record<string, any>",
-      description: "Additional properties to pass to the Deepgram API",
-      isOptional: true,
-    },
-    {
-      name: "language",
-      type: "string",
-      description: "Language code for the model",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Methods
-
-### speak()
-
-Converts text to speech using the configured speech model and voice.
-
-<PropertiesTable
-  content={[
-    {
-      name: "input",
-      type: "string | NodeJS.ReadableStream",
-      description:
-        "Text to convert to speech. If a stream is provided, it will be converted to text first.",
-      isOptional: false,
-    },
-    {
-      name: "options",
-      type: "object",
-      description: "Additional options for speech synthesis",
-      isOptional: true,
-    },
-    {
-      name: "options.speaker",
-      type: "string",
-      description: "Override the default speaker for this request",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Returns: `Promise<NodeJS.ReadableStream>`
-
-### listen()
-
-Converts speech to text using the configured listening model.
-
-<PropertiesTable
-  content={[
-    {
-      name: "audioStream",
-      type: "NodeJS.ReadableStream",
-      description: "Audio stream to transcribe",
-      isOptional: false,
-    },
-    {
-      name: "options",
-      type: "object",
-      description: "Additional options to pass to the Deepgram API",
-      isOptional: true,
-    },
-  ]}
-/>
-
-Returns: `Promise<string>`
-
-### getSpeakers()
-
-Returns a list of available voice options.
-
-<PropertiesTable
-  content={[
-    {
-      name: "voiceId",
-      type: "string",
-      description: "Unique identifier for the voice",
-      isOptional: false,
-    },
-  ]}
-/>