@mastra/voice-openai 0.12.0 → 0.12.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mastra/voice-openai
 
+## 0.12.1-alpha.0
+
+### Patch Changes
+
+- dependencies updates: ([#13189](https://github.com/mastra-ai/mastra/pull/13189))
+  - Updated dependency [`openai@^5.23.2` ↗︎](https://www.npmjs.com/package/openai/v/5.23.2) (from `^5.11.0`, in `dependencies`)
+- Updated dependencies:
+  - @mastra/core@1.5.0-alpha.1
+
 ## 0.12.0
 
 ### Minor Changes

package/dist/docs/SKILL.md

@@ -1,33 +1,33 @@
 ---
-name: mastra-voice-openai-docs
-description: Documentation for @mastra/voice-openai. Includes links to type definitions and readable implementation code in dist/.
+name: mastra-voice-openai
+description: Documentation for @mastra/voice-openai. Use when working with @mastra/voice-openai APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/voice-openai"
+  version: "0.12.1-alpha.0"
 ---
 
-# @mastra/voice-openai Documentation
+## When to use
 
-> **Version**: 0.12.0
-> **Package**: @mastra/voice-openai
+Use this skill whenever you are working with @mastra/voice-openai to obtain the domain-specific knowledge.
 
-## Quick Navigation
+## How to use
 
-Use SOURCE_MAP.json to find any export:
+Read the individual reference documents for detailed explanations and code examples.
 
-```bash
-cat docs/SOURCE_MAP.json
-```
+### Docs
 
-Each export maps to:
-- **types**: `.d.ts` file with JSDoc and API signatures
-- **implementation**: `.js` chunk file with readable source
-- **docs**: Conceptual documentation in `docs/`
+- [Voice](references/docs-agents-adding-voice.md)
+- [Voice in Mastra](references/docs-voice-overview.md) - Overview of voice capabilities in Mastra, including text-to-speech, speech-to-text, and real-time speech-to-speech interactions.
+- [Speech-to-Text (STT)](references/docs-voice-speech-to-text.md) - Overview of Speech-to-Text capabilities in Mastra, including configuration, usage, and integration with voice providers.
+- [Text-to-Speech (TTS)](references/docs-voice-text-to-speech.md) - Overview of Text-to-Speech capabilities in Mastra, including configuration, usage, and integration with voice providers.
 
-## Top Exports
+### Reference
 
+- [Reference: CompositeVoice](references/reference-voice-composite-voice.md) - Documentation for the CompositeVoice class, which enables combining multiple voice providers for flexible text-to-speech and speech-to-text operations.
+- [Reference: OpenAI](references/reference-voice-openai.md) - Documentation for the OpenAIVoice class, providing text-to-speech and speech-to-text capabilities.
+- [Reference: voice.getSpeakers()](references/reference-voice-voice.getSpeakers.md) - Documentation for the getSpeakers() method available in voice providers, which retrieves available voice options.
+- [Reference: voice.listen()](references/reference-voice-voice.listen.md) - Documentation for the listen() method available in all Mastra voice providers, which converts speech to text.
+- [Reference: voice.speak()](references/reference-voice-voice.speak.md) - Documentation for the speak() method available in all Mastra voice providers, which converts text to speech.
 
 
-See SOURCE_MAP.json for the complete list.
-
-## Available Topics
-
-- [Agents](agents/) - 1 file(s)
-- [Voice](voice/) - 8 file(s)
+Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/{SOURCE_MAP.json → assets/SOURCE_MAP.json}

@@ -1,5 +1,5 @@
 {
-  "version": "0.12.0",
+  "version": "0.12.1-alpha.0",
   "package": "@mastra/voice-openai",
   "exports": {},
   "modules": {}

package/dist/docs/{agents/01-adding-voice.md → references/docs-agents-adding-voice.md}

@@ -164,7 +164,7 @@ The following files are created:
 - **hybrid-question.mp3** – Hybrid agent's spoken question.
 - **unified-response.mp3** – Unified agent's spoken response.
 
-```typescript title="src/test-voice-agents.ts"
+```typescript
 import "dotenv/config";
 
 import path from "path";
@@ -323,30 +323,31 @@ const voice = new CompositeVoice({
 ```
 
 For the complete list of supported AI SDK providers and their capabilities:
-* [Transcription](https://ai-sdk.dev/docs/providers/openai/transcription)
-* [Speech](https://ai-sdk.dev/docs/providers/elevenlabs/speech)
+
+- [Transcription](https://ai-sdk.dev/docs/providers/openai/transcription)
+- [Speech](https://ai-sdk.dev/docs/providers/elevenlabs/speech)
 
 ## Supported Voice Providers
 
 Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-text (STT) capabilities:
 
-| Provider        | Package                         | Features                  | Reference                                         |
-| --------------- | ------------------------------- | ------------------------- | ------------------------------------------------- |
-| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/v1/voice/openai)          |
-| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](https://mastra.ai/reference/v1/voice/openai-realtime) |
-| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](https://mastra.ai/reference/v1/voice/elevenlabs)      |
-| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](https://mastra.ai/reference/v1/voice/playai)          |
-| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/v1/voice/google)          |
-| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](https://mastra.ai/reference/v1/voice/deepgram)        |
-| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](https://mastra.ai/reference/v1/voice/murf)            |
-| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](https://mastra.ai/reference/v1/voice/speechify)       |
-| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/v1/voice/sarvam)          |
-| Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](https://mastra.ai/reference/v1/voice/mastra-voice)    |
-| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](https://mastra.ai/reference/v1/voice/mastra-voice)    |
+| Provider        | Package                         | Features                  | Reference                                                          |
+| --------------- | ------------------------------- | ------------------------- | ------------------------------------------------------------------ |
+| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/voice/openai)          |
+| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](https://mastra.ai/reference/voice/openai-realtime) |
+| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](https://mastra.ai/reference/voice/elevenlabs)      |
+| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](https://mastra.ai/reference/voice/playai)          |
+| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/voice/google)          |
+| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](https://mastra.ai/reference/voice/deepgram)        |
+| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](https://mastra.ai/reference/voice/murf)            |
+| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](https://mastra.ai/reference/voice/speechify)       |
+| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](https://mastra.ai/reference/voice/sarvam)          |
+| Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
+| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
 
 ## Next Steps
 
-- [Voice API Reference](https://mastra.ai/reference/v1/voice/mastra-voice) - Detailed API documentation for voice capabilities
+- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice) - Detailed API documentation for voice capabilities
 - [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations
 - [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text) - Voice memo app and other STT implementations
 - [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech) - Real-time voice conversation with call analysis

package/dist/docs/{voice/01-overview.md → references/docs-voice-overview.md}

@@ -1,12 +1,10 @@
-> Overview of voice capabilities in Mastra, including text-to-speech, speech-to-text, and real-time speech-to-speech interactions.
-
 # Voice in Mastra
 
 Mastra's Voice system provides a unified interface for voice interactions, enabling text-to-speech (TTS), speech-to-text (STT), and real-time speech-to-speech (STS) capabilities in your applications.
 
 ## Adding Voice to Agents
 
-To learn how to integrate voice capabilities into your agents, check out the [Adding Voice to Agents](https://mastra.ai/docs/v1/agents/adding-voice) documentation. This section covers how to use both single and multiple voice providers, as well as real-time interactions.
+To learn how to integrate voice capabilities into your agents, check out the [Adding Voice to Agents](https://mastra.ai/docs/agents/adding-voice) documentation. This section covers how to use both single and multiple voice providers, as well as real-time interactions.
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -28,12 +26,11 @@ You can then use the following voice capabilities:
 
 ### Text to Speech (TTS)
 
-Turn your agent's responses into natural-sounding speech using Mastra's TTS capabilities.
-Choose from multiple providers like OpenAI, ElevenLabs, and more.
+Turn your agent's responses into natural-sounding speech using Mastra's TTS capabilities. Choose from multiple providers like OpenAI, ElevenLabs, and more.
 
-For detailed configuration options and advanced features, check out our [Text-to-Speech guide](./text-to-speech).
+For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/docs/voice/text-to-speech).
 
-  **openai:**
+**OpenAI**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -60,10 +57,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/v1/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
 
-  
-  **azure:**
+**Azure**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -89,10 +85,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/v1/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
 
-  
-  **elevenlabs:**
+**ElevenLabs**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -118,10 +113,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/v1/voice/elevenlabs) for more information on the ElevenLabs voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
-  
-  **playai:**
+**PlayAI**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -147,10 +141,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [PlayAI Voice Reference](https://mastra.ai/reference/v1/voice/playai) for more information on the PlayAI voice provider.
+Visit the [PlayAI Voice Reference](https://mastra.ai/reference/voice/playai) for more information on the PlayAI voice provider.
 
-  
-  **google:**
+**Google**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -176,10 +169,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/v1/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
 
-  
-  **cloudflare:**
+**Cloudflare**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -205,10 +197,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/v1/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
 
-  
-  **deepgram:**
+**Deepgram**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -234,10 +225,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/v1/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
 
-  
-  **speechify:**
+**Speechify**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -263,10 +253,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Speechify Voice Reference](https://mastra.ai/reference/v1/voice/speechify) for more information on the Speechify voice provider.
+Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
 
-  
-  **sarvam:**
+**Sarvam**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -292,10 +281,9 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/v1/voice/sarvam) for more information on the Sarvam voice provider.
+Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
 
-  
-  **murf:**
+**Murf**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -321,20 +309,17 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream);
 ```
 
-Visit the [Murf Voice Reference](https://mastra.ai/reference/v1/voice/murf) for more information on the Murf voice provider.
-
-  
+Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
 
 ### Speech to Text (STT)
 
-Transcribe spoken content using various providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](./speech-to-text).
+Transcribe spoken content using various providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/docs/voice/speech-to-text).
 
 You can download a sample audio file from [here](https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3).
 
-<br />
-<AudioPlayback audio="https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3" />
+[](https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3)
 
-  **openai:**
+**OpenAI**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -361,10 +346,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/v1/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
 
-  
-  **azure:**
+**Azure**:
 
 ```typescript
 import { createReadStream } from "fs";
@@ -392,10 +376,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/v1/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
 
-  
-  **elevenlabs:**
+**ElevenLabs**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -422,10 +405,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/v1/voice/elevenlabs) for more information on the ElevenLabs voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
-  
-  **google:**
+**Google**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -452,10 +434,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/v1/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
 
-  
-  **cloudflare:**
+**Cloudflare**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -482,10 +463,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/v1/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
 
-  
-  **deepgram:**
+**Deepgram**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -512,10 +492,9 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/v1/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
 
-  
-  **sarvam:**
+**Sarvam**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -542,16 +521,13 @@ console.log(`User said: ${transcript}`);
 const { text } = await voiceAgent.generate(transcript);
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/v1/voice/sarvam) for more information on the Sarvam voice provider.
-
-  
+Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
 
 ### Speech to Speech (STS)
 
-Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents.
-For detailed configuration options and advanced features, check out [Speech to Speech](./speech-to-speech).
+Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents. For detailed configuration options and advanced features, check out [Speech to Speech](https://mastra.ai/docs/voice/speech-to-speech).
 
-  **openai:**
+**OpenAI**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -580,10 +556,9 @@ const micStream = getMicrophoneStream();
 await voiceAgent.voice.send(micStream);
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/v1/voice/openai-realtime) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai-realtime) for more information on the OpenAI voice provider.
 
-  
-  **google:**
+**Google**:
 
 ```typescript
 import { Agent } from "@mastra/core/agent";
@@ -631,15 +606,13 @@ const micStream = getMicrophoneStream();
 await voiceAgent.voice.send(micStream);
 ```
 
-Visit the [Google Gemini Live Reference](https://mastra.ai/reference/v1/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
-
-  
+Visit the [Google Gemini Live Reference](https://mastra.ai/reference/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
 
 ## Voice Configuration
 
 Each voice provider can be configured with different models and options. Below are the detailed configuration options for all supported providers:
 
-  **openai:**
+**OpenAI**:
 
 ```typescript
 // OpenAI Voice Configuration
@@ -660,10 +633,9 @@ const voice = new OpenAIVoice({
 });
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/v1/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
 
-  
-  **azure:**
+**Azure**:
 
 ```typescript
 // Azure Voice Configuration
@@ -686,10 +658,9 @@ const voice = new AzureVoice({
 });
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/v1/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
 
-  
-  **elevenlabs:**
+**ElevenLabs**:
 
 ```typescript
 // ElevenLabs Voice Configuration
@@ -705,10 +676,9 @@ const voice = new ElevenLabsVoice({
 });
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/v1/voice/elevenlabs) for more information on the ElevenLabs voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
-  
-  **playai:**
+**PlayAI**:
 
 ```typescript
 // PlayAI Voice Configuration
@@ -724,10 +694,9 @@ const voice = new PlayAIVoice({
 });
 ```
 
-Visit the [PlayAI Voice Reference](https://mastra.ai/reference/v1/voice/playai) for more information on the PlayAI voice provider.
+Visit the [PlayAI Voice Reference](https://mastra.ai/reference/voice/playai) for more information on the PlayAI voice provider.
 
-  
-  **google:**
+**Google**:
 
 ```typescript
 // Google Voice Configuration
@@ -746,10 +715,9 @@ const voice = new GoogleVoice({
 });
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/v1/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
 
-  
-  **cloudflare:**
+**Cloudflare**:
 
 ```typescript
 // Cloudflare Voice Configuration
@@ -765,10 +733,9 @@ const voice = new CloudflareVoice({
 });
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/v1/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
 
-  
-  **deepgram:**
+**Deepgram**:
 
 ```typescript
 // Deepgram Voice Configuration
@@ -787,10 +754,9 @@ const voice = new DeepgramVoice({
 });
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/v1/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
 
-  
-  **speechify:**
+**Speechify**:
 
 ```typescript
 // Speechify Voice Configuration
@@ -806,10 +772,9 @@ const voice = new SpeechifyVoice({
 });
 ```
 
-Visit the [Speechify Voice Reference](https://mastra.ai/reference/v1/voice/speechify) for more information on the Speechify voice provider.
+Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
 
-  
-  **sarvam:**
+**Sarvam**:
 
 ```typescript
 // Sarvam Voice Configuration
@@ -824,10 +789,9 @@ const voice = new SarvamVoice({
 });
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/v1/voice/sarvam) for more information on the Sarvam voice provider.
+Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
 
-  
-  **murf:**
+**Murf**:
 
 ```typescript
 // Murf Voice Configuration
@@ -842,10 +806,9 @@ const voice = new MurfVoice({
 });
 ```
 
-Visit the [Murf Voice Reference](https://mastra.ai/reference/v1/voice/murf) for more information on the Murf voice provider.
+Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
 
-  
-  **openai-realtime:**
+**OpenAI Realtime**:
 
 ```typescript
 // OpenAI Realtime Voice Configuration
@@ -864,10 +827,9 @@ const voice = new OpenAIRealtimeVoice({
 });
 ```
 
-For more information on the OpenAI Realtime voice provider, refer to the [OpenAI Realtime Voice Reference](https://mastra.ai/reference/v1/voice/openai-realtime).
+For more information on the OpenAI Realtime voice provider, refer to the [OpenAI Realtime Voice Reference](https://mastra.ai/reference/voice/openai-realtime).
 
-  
-  **google-gemini-live:**
+**Google Gemini Live**:
 
 ```typescript
 // Google Gemini Live Voice Configuration
@@ -881,10 +843,9 @@ const voice = new GeminiLiveVoice({
 });
 ```
 
-Visit the [Google Gemini Live Reference](https://mastra.ai/reference/v1/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
+Visit the [Google Gemini Live Reference](https://mastra.ai/reference/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
 
-  
-  **aisdk:**
+**AI SDK**:
 
 ```typescript
 // AI SDK Voice Configuration
@@ -907,7 +868,6 @@ const voiceAgent = new Agent({
   voice,
 });
 ```
-  
 
 ### Using Multiple Voice Providers
 
@@ -1003,17 +963,17 @@ const voice = new CompositeVoice({
 });
 ```
 
-For more information on the CompositeVoice, refer to the [CompositeVoice Reference](https://mastra.ai/reference/v1/voice/composite-voice).
+For more information on the CompositeVoice, refer to the [CompositeVoice Reference](https://mastra.ai/reference/voice/composite-voice).
 
 ## More Resources
 
-- [CompositeVoice](https://mastra.ai/reference/v1/voice/composite-voice)
-- [MastraVoice](https://mastra.ai/reference/v1/voice/mastra-voice)
-- [OpenAI Voice](https://mastra.ai/reference/v1/voice/openai)
-- [OpenAI Realtime Voice](https://mastra.ai/reference/v1/voice/openai-realtime)
-- [Azure Voice](https://mastra.ai/reference/v1/voice/azure)
-- [Google Voice](https://mastra.ai/reference/v1/voice/google)
-- [Google Gemini Live Voice](https://mastra.ai/reference/v1/voice/google-gemini-live)
-- [Deepgram Voice](https://mastra.ai/reference/v1/voice/deepgram)
-- [PlayAI Voice](https://mastra.ai/reference/v1/voice/playai)
+- [CompositeVoice](https://mastra.ai/reference/voice/composite-voice)
+- [MastraVoice](https://mastra.ai/reference/voice/mastra-voice)
+- [OpenAI Voice](https://mastra.ai/reference/voice/openai)
+- [OpenAI Realtime Voice](https://mastra.ai/reference/voice/openai-realtime)
+- [Azure Voice](https://mastra.ai/reference/voice/azure)
+- [Google Voice](https://mastra.ai/reference/voice/google)
+- [Google Gemini Live Voice](https://mastra.ai/reference/voice/google-gemini-live)
+- [Deepgram Voice](https://mastra.ai/reference/voice/deepgram)
+- [PlayAI Voice](https://mastra.ai/reference/voice/playai)
 - [Voice Examples](https://github.com/mastra-ai/voice-examples)