@mastra/voice-cloudflare 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/voice-cloudflare
 
+## 0.12.1
+
+### Patch Changes
+
+- dependencies updates: ([#10188](https://github.com/mastra-ai/mastra/pull/10188))
+  - Updated dependency [`cloudflare@^5.2.0` ↗︎](https://www.npmjs.com/package/cloudflare/v/5.2.0) (from `^4.5.0`, in `dependencies`)
+- Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0
+
+## 0.12.1-alpha.0
+
+### Patch Changes
+
+- dependencies updates: ([#10188](https://github.com/mastra-ai/mastra/pull/10188))
+  - Updated dependency [`cloudflare@^5.2.0` ↗︎](https://www.npmjs.com/package/cloudflare/v/5.2.0) (from `^4.5.0`, in `dependencies`)
+- Updated dependencies [[`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0-alpha.3
+
 ## 0.12.0
 
 ### Minor Changes

package/LICENSE.md

@@ -1,3 +1,18 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
 # Apache License 2.0
 
 Copyright (c) 2025 Kepler Software, Inc.

package/dist/docs/SKILL.md

@@ -1,33 +1,27 @@
 ---
-name: mastra-voice-cloudflare-docs
-description: Documentation for @mastra/voice-cloudflare. Includes links to type definitions and readable implementation code in dist/.
+name: mastra-voice-cloudflare
+description: Documentation for @mastra/voice-cloudflare. Use when working with @mastra/voice-cloudflare APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/voice-cloudflare"
+  version: "0.12.1"
 ---
 
-# @mastra/voice-cloudflare Documentation
+## When to use
 
-> **Version**: 0.12.0
-> **Package**: @mastra/voice-cloudflare
+Use this skill whenever you are working with @mastra/voice-cloudflare 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) - Learn how to add voice capabilities to your Mastra agents for text-to-speech and speech-to-text interactions.
+- [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.
 
-## Top Exports
+### Reference
 
+- [Reference: Cloudflare](references/reference-voice-cloudflare.md) - Documentation for the CloudflareVoice class, providing text-to-speech capabilities using Cloudflare Workers AI.
 
 
-See SOURCE_MAP.json for the complete list.
-
-## Available Topics
-
-- [Agents](agents/) - 1 file(s)
-- [Voice](voice/) - 2 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",
   "package": "@mastra/voice-cloudflare",
   "exports": {},
   "modules": {}

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

@@ -7,39 +7,39 @@ Mastra agents can be enhanced with voice capabilities, allowing them to speak re
 The simplest way to add voice to an agent is to use a single provider for both speaking and listening:
 
 ```typescript
-import { createReadStream } from "fs";
-import path from "path";
-import { Agent } from "@mastra/core/agent";
-import { OpenAIVoice } from "@mastra/voice-openai";
+import { createReadStream } from 'fs'
+import path from 'path'
+import { Agent } from '@mastra/core/agent'
+import { OpenAIVoice } from '@mastra/voice-openai'
 
 // Initialize the voice provider with default settings
-const voice = new OpenAIVoice();
+const voice = new OpenAIVoice()
 
 // Create an agent with voice capabilities
 export const agent = new Agent({
-  id: "voice-agent",
-  name: "Voice Agent",
+  id: 'voice-agent',
+  name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: "openai/gpt-5.1",
+  model: 'openai/gpt-5.4',
   voice,
-});
+})
 
 // The agent can now use voice for interaction
 const audioStream = await agent.voice.speak("Hello, I'm your AI assistant!", {
-  filetype: "m4a",
-});
+  filetype: 'm4a',
+})
 
-playAudio(audioStream!);
+playAudio(audioStream!)
 
 try {
-  const transcription = await agent.voice.listen(audioStream);
-  console.log(transcription);
+  const transcription = await agent.voice.listen(audioStream)
+  console.log(transcription)
 } catch (error) {
-  console.error("Error transcribing audio:", error);
+  console.error('Error transcribing audio:', error)
 }
 ```
 
-## Working with Audio Streams
+## Working with audio streams
 
 The `speak()` and `listen()` methods work with Node.js streams. Here's how to save and load audio files:
 
@@ -48,20 +48,20 @@ The `speak()` and `listen()` methods work with Node.js streams. Here's how to sa
 The `speak` method returns a stream that you can pipe to a file or speaker.
 
 ```typescript
-import { createWriteStream } from "fs";
-import path from "path";
+import { createWriteStream } from 'fs'
+import path from 'path'
 
 // Generate speech and save to file
-const audio = await agent.voice.speak("Hello, World!");
-const filePath = path.join(process.cwd(), "agent.mp3");
-const writer = createWriteStream(filePath);
+const audio = await agent.voice.speak('Hello, World!')
+const filePath = path.join(process.cwd(), 'agent.mp3')
+const writer = createWriteStream(filePath)
 
-audio.pipe(writer);
+audio.pipe(writer)
 
 await new Promise<void>((resolve, reject) => {
-  writer.on("finish", () => resolve());
-  writer.on("error", reject);
-});
+  writer.on('finish', () => resolve())
+  writer.on('error', reject)
+})
 ```
 
 ### Transcribing Audio Input
@@ -69,67 +69,67 @@ await new Promise<void>((resolve, reject) => {
 The `listen` method expects a stream of audio data from a microphone or file.
 
 ```typescript
-import { createReadStream } from "fs";
-import path from "path";
+import { createReadStream } from 'fs'
+import path from 'path'
 
 // Read audio file and transcribe
-const audioFilePath = path.join(process.cwd(), "/agent.m4a");
-const audioStream = createReadStream(audioFilePath);
+const audioFilePath = path.join(process.cwd(), '/agent.m4a')
+const audioStream = createReadStream(audioFilePath)
 
 try {
-  console.log("Transcribing audio file...");
+  console.log('Transcribing audio file...')
   const transcription = await agent.voice.listen(audioStream, {
-    filetype: "m4a",
-  });
-  console.log("Transcription:", transcription);
+    filetype: 'm4a',
+  })
+  console.log('Transcription:', transcription)
 } catch (error) {
-  console.error("Error transcribing audio:", error);
+  console.error('Error transcribing audio:', error)
 }
 ```
 
-## Speech-to-Speech Voice Interactions
+## Speech-to-speech voice interactions
 
 For more dynamic and interactive voice experiences, you can use real-time voice providers that support speech-to-speech capabilities:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
-import { getMicrophoneStream } from "@mastra/node-audio";
-import { OpenAIRealtimeVoice } from "@mastra/voice-openai-realtime";
-import { search, calculate } from "../tools";
+import { Agent } from '@mastra/core/agent'
+import { getMicrophoneStream } from '@mastra/node-audio'
+import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
+import { search, calculate } from '../tools'
 
 // Initialize the realtime voice provider
 const voice = new OpenAIRealtimeVoice({
   apiKey: process.env.OPENAI_API_KEY,
-  model: "gpt-5.1-realtime",
-  speaker: "alloy",
-});
+  model: 'gpt-5.1-realtime',
+  speaker: 'alloy',
+})
 
 // Create an agent with speech-to-speech voice capabilities
 export const agent = new Agent({
-  id: "speech-to-speech-agent",
-  name: "Speech-to-Speech Agent",
+  id: 'speech-to-speech-agent',
+  name: 'Speech-to-Speech Agent',
   instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
-  model: "openai/gpt-5.1",
+  model: 'openai/gpt-5.4',
   tools: {
     // Tools configured on Agent are passed to voice provider
     search,
     calculate,
   },
   voice,
-});
+})
 
 // Establish a WebSocket connection
-await agent.voice.connect();
+await agent.voice.connect()
 
 // Start a conversation
-agent.voice.speak("Hello, I'm your AI assistant!");
+agent.voice.speak("Hello, I'm your AI assistant!")
 
 // Stream audio from a microphone
-const microphoneStream = getMicrophoneStream();
-agent.voice.send(microphoneStream);
+const microphoneStream = getMicrophoneStream()
+agent.voice.send(microphoneStream)
 
 // When done with the conversation
-agent.voice.close();
+agent.voice.close()
 ```
 
 ### Event System
@@ -138,19 +138,19 @@ The realtime voice provider emits several events you can listen for:
 
 ```typescript
 // Listen for speech audio data sent from voice provider
-agent.voice.on("speaking", ({ audio }) => {
+agent.voice.on('speaking', ({ audio }) => {
   // audio contains ReadableStream or Int16Array audio data
-});
+})
 
 // Listen for transcribed text sent from both voice provider and user
-agent.voice.on("writing", ({ text, role }) => {
-  console.log(`${role} said: ${text}`);
-});
+agent.voice.on('writing', ({ text, role }) => {
+  console.log(`${role} said: ${text}`)
+})
 
 // Listen for errors
-agent.voice.on("error", (error) => {
-  console.error("Voice error:", error);
-});
+agent.voice.on('error', error => {
+  console.error('Voice error:', error)
+})
 ```
 
 ## Examples
@@ -164,93 +164,89 @@ 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"
-import "dotenv/config";
+```typescript
+import 'dotenv/config'
 
-import path from "path";
-import { createReadStream } from "fs";
-import { Agent } from "@mastra/core/agent";
-import { CompositeVoice } from "@mastra/core/voice";
-import { OpenAIVoice } from "@mastra/voice-openai";
-import { Mastra } from "@mastra/core";
+import path from 'path'
+import { createReadStream } from 'fs'
+import { Agent } from '@mastra/core/agent'
+import { CompositeVoice } from '@mastra/core/voice'
+import { OpenAIVoice } from '@mastra/voice-openai'
+import { Mastra } from '@mastra/core'
 
 // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
 export const saveAudioToFile = async (
   audio: NodeJS.ReadableStream,
   filename: string,
 ): Promise<void> => {
-  const audioDir = path.join(process.cwd(), "audio");
-  const filePath = path.join(audioDir, filename);
+  const audioDir = path.join(process.cwd(), 'audio')
+  const filePath = path.join(audioDir, filename)
 
-  await fs.promises.mkdir(audioDir, { recursive: true });
+  await fs.promises.mkdir(audioDir, { recursive: true })
 
-  const writer = createWriteStream(filePath);
-  audio.pipe(writer);
+  const writer = createWriteStream(filePath)
+  audio.pipe(writer)
   return new Promise((resolve, reject) => {
-    writer.on("finish", resolve);
-    writer.on("error", reject);
-  });
-};
+    writer.on('finish', resolve)
+    writer.on('error', reject)
+  })
+}
 
 // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
-export const convertToText = async (
-  input: string | NodeJS.ReadableStream,
-): Promise<string> => {
-  if (typeof input === "string") {
-    return input;
+export const convertToText = async (input: string | NodeJS.ReadableStream): Promise<string> => {
+  if (typeof input === 'string') {
+    return input
   }
 
-  const chunks: Buffer[] = [];
+  const chunks: Buffer[] = []
   return new Promise((resolve, reject) => {
-    inputData.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
-    inputData.on("error", reject);
-    inputData.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
-  });
-};
+    inputData.on('data', chunk => chunks.push(Buffer.from(chunk)))
+    inputData.on('error', reject)
+    inputData.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')))
+  })
+}
 
 export const hybridVoiceAgent = new Agent({
-  id: "hybrid-voice-agent",
-  name: "Hybrid Voice Agent",
-  model: "openai/gpt-5.1",
-  instructions: "You can speak and listen using different providers.",
+  id: 'hybrid-voice-agent',
+  name: 'Hybrid Voice Agent',
+  model: 'openai/gpt-5.4',
+  instructions: 'You can speak and listen using different providers.',
   voice: new CompositeVoice({
     input: new OpenAIVoice(),
     output: new OpenAIVoice(),
   }),
-});
+})
 
 export const unifiedVoiceAgent = new Agent({
-  id: "unified-voice-agent",
-  name: "Unified Voice Agent",
-  instructions: "You are an agent with both STT and TTS capabilities.",
-  model: "openai/gpt-5.1",
+  id: 'unified-voice-agent',
+  name: 'Unified Voice Agent',
+  instructions: 'You are an agent with both STT and TTS capabilities.',
+  model: 'openai/gpt-5.4',
   voice: new OpenAIVoice(),
-});
+})
 
 export const mastra = new Mastra({
   agents: { hybridVoiceAgent, unifiedVoiceAgent },
-});
+})
 
-const hybridVoiceAgent = mastra.getAgent("hybridVoiceAgent");
-const unifiedVoiceAgent = mastra.getAgent("unifiedVoiceAgent");
+const hybridVoiceAgent = mastra.getAgent('hybridVoiceAgent')
+const unifiedVoiceAgent = mastra.getAgent('unifiedVoiceAgent')
 
-const question = "What is the meaning of life in one sentence?";
+const question = 'What is the meaning of life in one sentence?'
 
-const hybridSpoken = await hybridVoiceAgent.voice.speak(question);
+const hybridSpoken = await hybridVoiceAgent.voice.speak(question)
 
-await saveAudioToFile(hybridSpoken!, "hybrid-question.mp3");
+await saveAudioToFile(hybridSpoken!, 'hybrid-question.mp3')
 
-const audioStream = createReadStream(
-  path.join(process.cwd(), "audio", "hybrid-question.mp3"),
-);
-const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream);
+const audioStream = createReadStream(path.join(process.cwd(), 'audio', 'hybrid-question.mp3'))
+const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream)
 
-const inputText = await convertToText(unifiedHeard!);
+const inputText = await convertToText(unifiedHeard!)
 
-const unifiedResponse = await unifiedVoiceAgent.generate(inputText);
-const unifiedSpoken = await unifiedVoiceAgent.voice.speak(unifiedResponse.text);
+const unifiedResponse = await unifiedVoiceAgent.generate(inputText)
+const unifiedSpoken = await unifiedVoiceAgent.voice.speak(unifiedResponse.text)
 
-await saveAudioToFile(unifiedSpoken!, "unified-response.mp3");
+await saveAudioToFile(unifiedSpoken!, 'unified-response.mp3')
 ```
 
 ### Using Multiple Providers
@@ -258,23 +254,23 @@ await saveAudioToFile(unifiedSpoken!, "unified-response.mp3");
 For more flexibility, you can use different providers for speaking and listening using the CompositeVoice class:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
-import { CompositeVoice } from "@mastra/core/voice";
-import { OpenAIVoice } from "@mastra/voice-openai";
-import { PlayAIVoice } from "@mastra/voice-playai";
+import { Agent } from '@mastra/core/agent'
+import { CompositeVoice } from '@mastra/core/voice'
+import { OpenAIVoice } from '@mastra/voice-openai'
+import { PlayAIVoice } from '@mastra/voice-playai'
 
 export const agent = new Agent({
-  id: "voice-agent",
-  name: "Voice Agent",
+  id: 'voice-agent',
+  name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: "openai/gpt-5.1",
+  model: 'openai/gpt-5.4',
 
   // Create a composite voice using OpenAI for listening and PlayAI for speaking
   voice: new CompositeVoice({
     input: new OpenAIVoice(),
     output: new PlayAIVoice(),
   }),
-});
+})
 ```
 
 ### Using AI SDK
@@ -282,28 +278,28 @@ export const agent = new Agent({
 Mastra supports using AI SDK's transcription and speech models directly in `CompositeVoice`, giving you access to a wide range of providers through the AI SDK ecosystem:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
-import { CompositeVoice } from "@mastra/core/voice";
-import { openai } from "@ai-sdk/openai";
-import { elevenlabs } from "@ai-sdk/elevenlabs";
-import { groq } from "@ai-sdk/groq";
+import { Agent } from '@mastra/core/agent'
+import { CompositeVoice } from '@mastra/core/voice'
+import { openai } from '@ai-sdk/openai'
+import { elevenlabs } from '@ai-sdk/elevenlabs'
+import { groq } from '@ai-sdk/groq'
 
 export const agent = new Agent({
-  id: "aisdk-voice-agent",
-  name: "AI SDK Voice Agent",
+  id: 'aisdk-voice-agent',
+  name: 'AI SDK Voice Agent',
   instructions: `You are a helpful assistant with voice capabilities.`,
-  model: "openai/gpt-5.1",
+  model: 'openai/gpt-5.4',
 
   // Pass AI SDK models directly to CompositeVoice
   voice: new CompositeVoice({
-    input: openai.transcription('whisper-1'),      // AI SDK transcription model
-    output: elevenlabs.speech('eleven_turbo_v2'),  // AI SDK speech model
+    input: openai.transcription('whisper-1'), // AI SDK transcription model
+    output: elevenlabs.speech('eleven_turbo_v2'), // AI SDK speech model
   }),
-});
+})
 
 // Use voice capabilities as usual
-const audioStream = await agent.voice.speak("Hello!");
-const transcribedText = await agent.voice.listen(audioStream);
+const audioStream = await agent.voice.speak('Hello!')
+const transcribedText = await agent.voice.listen(audioStream)
 ```
 
 #### Mix and Match Providers
@@ -311,42 +307,43 @@ const transcribedText = await agent.voice.listen(audioStream);
 You can mix AI SDK models with Mastra voice providers:
 
 ```typescript
-import { CompositeVoice } from "@mastra/core/voice";
-import { PlayAIVoice } from "@mastra/voice-playai";
-import { openai } from "@ai-sdk/openai";
+import { CompositeVoice } from '@mastra/core/voice'
+import { PlayAIVoice } from '@mastra/voice-playai'
+import { openai } from '@ai-sdk/openai'
 
 // Use AI SDK for transcription and Mastra provider for speech
 const voice = new CompositeVoice({
-  input: openai.transcription('whisper-1'),  // AI SDK
-  output: new PlayAIVoice(),                  // Mastra provider
-});
+  input: openai.transcription('whisper-1'), // AI SDK
+  output: new PlayAIVoice(), // Mastra provider
+})
 ```
 
 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)
 
-## Supported Voice Providers
+- [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)    |
-
-## Next Steps
-
-- [Voice API Reference](https://mastra.ai/reference/v1/voice/mastra-voice) - Detailed API documentation for voice capabilities
+| 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/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