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

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

@@ -1,203 +0,0 @@
----
-title: "Reference: Google Voice | Voice Providers | Mastra Docs"
-description: "Documentation for the Google Voice implementation, providing text-to-speech and speech-to-text capabilities."
----
-
-# Google
-
-The Google Voice implementation in Mastra provides both text-to-speech (TTS) and speech-to-text (STT) capabilities using Google Cloud services. It supports multiple voices, languages, and advanced audio configuration options.
-
-## Usage Example
-
-```typescript
-import { GoogleVoice } from "@mastra/voice-google";
-
-// Initialize with default configuration (uses GOOGLE_API_KEY environment variable)
-const voice = new GoogleVoice();
-
-// Initialize with custom configuration
-const voice = new GoogleVoice({
-  speechModel: {
-    apiKey: "your-speech-api-key",
-  },
-  listeningModel: {
-    apiKey: "your-listening-api-key",
-  },
-  speaker: "en-US-Casual-K",
-});
-
-// Text-to-Speech
-const audioStream = await voice.speak("Hello, world!", {
-  languageCode: "en-US",
-  audioConfig: {
-    audioEncoding: "LINEAR16",
-  },
-});
-
-// Speech-to-Text
-const transcript = await voice.listen(audioStream, {
-  config: {
-    encoding: "LINEAR16",
-    languageCode: "en-US",
-  },
-});
-
-// Get available voices for a specific language
-const voices = await voice.getSpeakers({ languageCode: "en-US" });
-```
-
-## Constructor Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "speechModel",
-      type: "GoogleModelConfig",
-      description: "Configuration for text-to-speech functionality",
-      isOptional: true,
-      defaultValue: "{ apiKey: process.env.GOOGLE_API_KEY }",
-    },
-    {
-      name: "listeningModel",
-      type: "GoogleModelConfig",
-      description: "Configuration for speech-to-text functionality",
-      isOptional: true,
-      defaultValue: "{ apiKey: process.env.GOOGLE_API_KEY }",
-    },
-    {
-      name: "speaker",
-      type: "string",
-      description: "Default voice ID to use for text-to-speech",
-      isOptional: true,
-      defaultValue: "'en-US-Casual-K'",
-    },
-  ]}
-/>
-
-### GoogleModelConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "apiKey",
-      type: "string",
-      description:
-        "Google Cloud API key. Falls back to GOOGLE_API_KEY environment variable",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Methods
-
-### speak()
-
-Converts text to speech using Google Cloud Text-to-Speech service.
-
-<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: "Speech synthesis options",
-      isOptional: true,
-    },
-    {
-      name: "options.speaker",
-      type: "string",
-      description: "Voice ID to use for this request",
-      isOptional: true,
-    },
-    {
-      name: "options.languageCode",
-      type: "string",
-      description:
-        "Language code for the voice (e.g., 'en-US'). Defaults to the language code from the speaker ID or 'en-US'",
-      isOptional: true,
-    },
-    {
-      name: "options.audioConfig",
-      type: "ISynthesizeSpeechRequest['audioConfig']",
-      description:
-        "Audio configuration options from Google Cloud Text-to-Speech API",
-      isOptional: true,
-      defaultValue: "{ audioEncoding: 'LINEAR16' }",
-    },
-  ]}
-/>
-
-Returns: `Promise<NodeJS.ReadableStream>`
-
-### listen()
-
-Converts speech to text using Google Cloud Speech-to-Text service.
-
-<PropertiesTable
-  content={[
-    {
-      name: "audioStream",
-      type: "NodeJS.ReadableStream",
-      description: "Audio stream to transcribe",
-      isOptional: false,
-    },
-    {
-      name: "options",
-      type: "object",
-      description: "Recognition options",
-      isOptional: true,
-    },
-    {
-      name: "options.stream",
-      type: "boolean",
-      description: "Whether to use streaming recognition",
-      isOptional: true,
-    },
-    {
-      name: "options.config",
-      type: "IRecognitionConfig",
-      description:
-        "Recognition configuration from Google Cloud Speech-to-Text API",
-      isOptional: true,
-      defaultValue: "{ encoding: 'LINEAR16', languageCode: '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",
-      isOptional: false,
-    },
-    {
-      name: "languageCodes",
-      type: "string[]",
-      description: "List of language codes supported by this voice",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Important Notes
-
-1. A Google Cloud API key is required. Set it via the `GOOGLE_API_KEY` environment variable or pass it in the constructor.
-2. The default voice is set to 'en-US-Casual-K'.
-3. Both text-to-speech and speech-to-text services use LINEAR16 as the default audio encoding.
-4. The `speak()` method supports advanced audio configuration through the Google Cloud Text-to-Speech API.
-5. The `listen()` method supports various recognition configurations through the Google Cloud Speech-to-Text API.
-6. Available voices can be filtered by language code using the `getSpeakers()` method.

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

@@ -1,413 +0,0 @@
----
-title: "Reference: MastraVoice | Voice Providers | Mastra Docs"
-description: "Documentation for the MastraVoice abstract base class, which defines the core interface for all voice services in Mastra, including speech-to-speech capabilities."
----
-
-# MastraVoice
-
-The MastraVoice class is an abstract base class that defines the core interface for voice services in Mastra. All voice provider implementations (like OpenAI, Deepgram, PlayAI, Speechify) extend this class to provide their specific functionality. The class now includes support for real-time speech-to-speech capabilities through WebSocket connections.
-
-## Usage Example
-
-```typescript
-import { MastraVoice } from "@mastra/core/voice";
-
-// Create a voice provider implementation
-class MyVoiceProvider extends MastraVoice {
-  constructor(config: {
-    speechModel?: BuiltInModelConfig;
-    listeningModel?: BuiltInModelConfig;
-    speaker?: string;
-    realtimeConfig?: {
-      model?: string;
-      apiKey?: string;
-      options?: unknown;
-    };
-  }) {
-    super({
-      speechModel: config.speechModel,
-      listeningModel: config.listeningModel,
-      speaker: config.speaker,
-      realtimeConfig: config.realtimeConfig,
-    });
-  }
-
-  // Implement required abstract methods
-  async speak(
-    input: string | NodeJS.ReadableStream,
-    options?: { speaker?: string },
-  ): Promise<NodeJS.ReadableStream | void> {
-    // Implement text-to-speech conversion
-  }
-
-  async listen(
-    audioStream: NodeJS.ReadableStream,
-    options?: unknown,
-  ): Promise<string | NodeJS.ReadableStream | void> {
-    // Implement speech-to-text conversion
-  }
-
-  async getSpeakers(): Promise<
-    Array<{ voiceId: string; [key: string]: unknown }>
-  > {
-    // Return list of available voices
-  }
-
-  // Optional speech-to-speech methods
-  async connect(): Promise<void> {
-    // Establish WebSocket connection for speech-to-speech communication
-  }
-
-  async send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void> {
-    // Stream audio data in speech-to-speech
-  }
-
-  async answer(): Promise<void> {
-    // Trigger voice provider to respond
-  }
-
-  addTools(tools: Array<unknown>): void {
-    // Add tools for the voice provider to use
-  }
-
-  close(): void {
-    // Close WebSocket connection
-  }
-
-  on(event: string, callback: (data: unknown) => void): void {
-    // Register event listener
-  }
-
-  off(event: string, callback: (data: unknown) => void): void {
-    // Remove event listener
-  }
-}
-```
-
-## Constructor Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "config",
-      type: "VoiceConfig",
-      description: "Configuration object for the voice service",
-      isOptional: true,
-    },
-    {
-      name: "config.speechModel",
-      type: "BuiltInModelConfig",
-      description: "Configuration for the text-to-speech model",
-      isOptional: true,
-    },
-    {
-      name: "config.listeningModel",
-      type: "BuiltInModelConfig",
-      description: "Configuration for the speech-to-text model",
-      isOptional: true,
-    },
-    {
-      name: "config.speaker",
-      type: "string",
-      description: "Default speaker/voice ID to use",
-      isOptional: true,
-    },
-    {
-      name: "config.name",
-      type: "string",
-      description: "Name for the voice provider instance",
-      isOptional: true,
-    },
-    {
-      name: "config.realtimeConfig",
-      type: "object",
-      description: "Configuration for real-time speech-to-speech capabilities",
-      isOptional: true,
-    },
-  ]}
-/>
-
-### BuiltInModelConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "string",
-      description: "Name of the model to use",
-      isOptional: false,
-    },
-    {
-      name: "apiKey",
-      type: "string",
-      description: "API key for the model service",
-      isOptional: true,
-    },
-  ]}
-/>
-
-### RealtimeConfig
-
-<PropertiesTable
-  content={[
-    {
-      name: "model",
-      type: "string",
-      description: "Model to use for real-time speech-to-speech capabilities",
-      isOptional: true,
-    },
-    {
-      name: "apiKey",
-      type: "string",
-      description: "API key for the real-time service",
-      isOptional: true,
-    },
-    {
-      name: "options",
-      type: "unknown",
-      description: "Provider-specific options for real-time capabilities",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Abstract Methods
-
-These methods must be implemented by unknown class extending MastraVoice.
-
-### speak()
-
-Converts text to speech using the configured speech model.
-
-```typescript
-abstract speak(
-  input: string | NodeJS.ReadableStream,
-  options?: {
-    speaker?: string;
-    [key: string]: unknown;
-  }
-): Promise<NodeJS.ReadableStream | void>
-```
-
-Purpose:
-
-- Takes text input and converts it to speech using the provider's text-to-speech service
-- Supports both string and stream input for flexibility
-- Allows overriding the default speaker/voice through options
-- Returns a stream of audio data that can be played or saved
-- May return void if the audio is handled by emitting 'speaking' event
-
-### listen()
-
-Converts speech to text using the configured listening model.
-
-```typescript
-abstract listen(
-  audioStream: NodeJS.ReadableStream,
-  options?: {
-    [key: string]: unknown;
-  }
-): Promise<string | NodeJS.ReadableStream | void>
-```
-
-Purpose:
-
-- Takes an audio stream and converts it to text using the provider's speech-to-text service
-- Supports provider-specific options for transcription configuration
-- Can return either a complete text transcription or a stream of transcribed text
-- Not all providers support this functionality (e.g., PlayAI, Speechify)
-- May return void if the transcription is handled by emitting 'writing' event
-
-### getSpeakers()
-
-Returns a list of available voices supported by the provider.
-
-```typescript
-abstract getSpeakers(): Promise<Array<{ voiceId: string; [key: string]: unknown }>>
-```
-
-Purpose:
-
-- Retrieves the list of available voices/speakers from the provider
-- Each voice must have at least a voiceId property
-- Providers can include additional metadata about each voice
-- Used to discover available voices for text-to-speech conversion
-
-## Optional Methods
-
-These methods have default implementations but can be overridden by voice providers that support speech-to-speech capabilities.
-
-### connect()
-
-Establishes a WebSocket or WebRTC connection for communication.
-
-```typescript
-connect(config?: unknown): Promise<void>
-```
-
-Purpose:
-
-- Initializes a connection to the voice service for communication
-- Must be called before using features like send() or answer()
-- Returns a Promise that resolves when the connection is established
-- Configuration is provider-specific
-
-### send()
-
-Streams audio data in real-time to the voice provider.
-
-```typescript
-send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void>
-```
-
-Purpose:
-
-- Sends audio data to the voice provider for real-time processing
-- Useful for continuous audio streaming scenarios like live microphone input
-- Supports both ReadableStream and Int16Array audio formats
-- Must be in connected state before calling this method
-
-### answer()
-
-Triggers the voice provider to generate a response.
-
-```typescript
-answer(): Promise<void>
-```
-
-Purpose:
-
-- Sends a signal to the voice provider to generate a response
-- Used in real-time conversations to prompt the AI to respond
-- Response will be emitted through the event system (e.g., 'speaking' event)
-
-### addTools()
-
-Equips the voice provider with tools that can be used during conversations.
-
-```typescript
-addTools(tools: Array<Tool>): void
-```
-
-Purpose:
-
-- Adds tools that the voice provider can use during conversations
-- Tools can extend the capabilities of the voice provider
-- Implementation is provider-specific
-
-### close()
-
-Disconnects from the WebSocket or WebRTC connection.
-
-```typescript
-close(): void
-```
-
-Purpose:
-
-- Closes the connection to the voice service
-- Cleans up resources and stops any ongoing real-time processing
-- Should be called when you're done with the voice instance
-
-### on()
-
-Registers an event listener for voice events.
-
-```typescript
-on<E extends VoiceEventType>(
-  event: E,
-  callback: (data: E extends keyof VoiceEventMap ? VoiceEventMap[E] : unknown) => void,
-): void
-```
-
-Purpose:
-
-- Registers a callback function to be called when the specified event occurs
-- Standard events include 'speaking', 'writing', and 'error'
-- Providers can emit custom events as well
-- Event data structure depends on the event type
-
-### off()
-
-Removes an event listener.
-
-```typescript
-off<E extends VoiceEventType>(
-  event: E,
-  callback: (data: E extends keyof VoiceEventMap ? VoiceEventMap[E] : unknown) => void,
-): void
-```
-
-Purpose:
-
-- Removes a previously registered event listener
-- Used to clean up event handlers when they're no longer needed
-
-## Event System
-
-The MastraVoice class includes an event system for real-time communication. Standard event types include:
-
-<PropertiesTable
-  content={[
-    {
-      name: "speaking",
-      type: "{ text: string; audioStream?: NodeJS.ReadableStream; audio?: Int16Array }",
-      description:
-        "Emitted when the voice provider is speaking, contains audio data",
-    },
-    {
-      name: "writing",
-      type: "{ text: string, role: string }",
-      description: "Emitted when text is transcribed from speech",
-    },
-    {
-      name: "error",
-      type: "{ message: string; code?: string; details?: unknown }",
-      description: "Emitted when an error occurs",
-    },
-  ]}
-/>
-
-## Protected Properties
-
-<PropertiesTable
-  content={[
-    {
-      name: "listeningModel",
-      type: "BuiltInModelConfig | undefined",
-      description: "Configuration for the speech-to-text model",
-      isOptional: true,
-    },
-    {
-      name: "speechModel",
-      type: "BuiltInModelConfig | undefined",
-      description: "Configuration for the text-to-speech model",
-      isOptional: true,
-    },
-    {
-      name: "speaker",
-      type: "string | undefined",
-      description: "Default speaker/voice ID",
-      isOptional: true,
-    },
-    {
-      name: "realtimeConfig",
-      type: "{ model?: string; apiKey?: string; options?: unknown } | undefined",
-      description: "Configuration for real-time speech-to-speech capabilities",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Telemetry Support
-
-MastraVoice includes built-in telemetry support through the `traced` method, which wraps method calls with performance tracking and error monitoring.
-
-## Notes
-
-- MastraVoice is an abstract class and cannot be instantiated directly
-- Implementations must provide concrete implementations for all abstract methods
-- The class provides a consistent interface across different voice service providers
-- Speech-to-speech capabilities are optional and provider-specific
-- The event system enables asynchronous communication for real-time interactions
-- Telemetry is automatically handled for all method calls