@mastra/voice-google-gemini-live 0.14.6-alpha.3 → 0.14.6

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @mastra/voice-google-gemini-live
 
+## 0.14.6
+
+### Patch Changes
+
+- dependencies updates: ([#20409](https://github.com/mastra-ai/mastra/pull/20409))
+  - Updated dependency [`google-auth-library@^10.9.1` ↗︎](https://www.npmjs.com/package/google-auth-library/v/10.9.1) (from `^10.9.0`, in `dependencies`)
+
+- Fixed Gemini Live session readiness waits to release timeout resources after settling. ([#21083](https://github.com/mastra-ai/mastra/pull/21083))
+
+- Updated dependencies [[`6bff877`](https://github.com/mastra-ai/mastra/commit/6bff877e214695ff8d9c84b06c13a6e6bcf9f1ed), [`f5a17d9`](https://github.com/mastra-ai/mastra/commit/f5a17d95c19e7d4149996932bd8d1905089f031d), [`5dba2a4`](https://github.com/mastra-ai/mastra/commit/5dba2a41600385751f5aace79878904e1972609d), [`9be8878`](https://github.com/mastra-ai/mastra/commit/9be8878dcf0388e84fc4873e0eec27bd49b881a4)]:
+  - @mastra/schema-compat@1.3.6
+
+## 0.14.6-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`5dba2a4`](https://github.com/mastra-ai/mastra/commit/5dba2a41600385751f5aace79878904e1972609d)]:
+  - @mastra/schema-compat@1.3.6-alpha.3
+
 ## 0.14.6-alpha.3
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-voice-google-gemini-live
 description: Documentation for @mastra/voice-google-gemini-live. Use when working with @mastra/voice-google-gemini-live APIs, configuration, or implementation.
 metadata:
   package: "@mastra/voice-google-gemini-live"
-  version: "0.14.6-alpha.3"
+  version: "0.14.6"
 ---
 
 ## When to use
@@ -19,9 +19,9 @@ Read the individual reference documents for detailed explanations and code examp
 - [Voice in Mastra](references/guides-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-Speech capabilities in Mastra](references/guides-voice-speech-to-speech.md) - Overview of speech-to-speech capabilities in Mastra, including real-time interactions and event-driven architecture.
 
-### Reference
+### Integrations
 
-- [Reference: Google Gemini Live voice](references/reference-voice-google-gemini-live.md) - Documentation for the GeminiLiveVoice class, providing real-time multimodal voice interactions using Google's Gemini Live API with support for both Gemini API and Vertex AI.
+- [Google](references/integrations-voice-google.md) - Documentation for the Google Voice implementation, providing text-to-speech and speech-to-text capabilities with support for both API key and Vertex AI authentication.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.14.6-alpha.3",
+  "version": "0.14.6",
   "package": "@mastra/voice-google-gemini-live",
   "exports": {},
   "modules": {}

package/dist/docs/references/guides-voice-overview.md

@@ -57,7 +57,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/integrations/voice/openai) for more information on the OpenAI voice provider.
 
 **Azure**:
 
@@ -84,7 +84,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/integrations/voice/azure) for more information on the Azure voice provider.
 
 **ElevenLabs**:
 
@@ -111,34 +111,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
-
-**PlayAI**:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { PlayAIVoice } from '@mastra/voice-playai'
-import { playAudio } from '@mastra/node-audio'
-
-const voiceAgent = new Agent({
-  id: 'voice-agent',
-  name: 'Voice Agent',
-  instructions: 'You are a voice assistant that can help users with their tasks.',
-  model: 'openai/gpt-5.6-sol',
-  voice: new PlayAIVoice(),
-})
-
-const { text } = await voiceAgent.generate('What color is the sky?')
-
-// Convert text to speech to an Audio Stream
-const audioStream = await voiceAgent.voice.speak(text, {
-  speaker: 'default', // Optional: specify a speaker
-})
-
-playAudio(audioStream)
-```
-
-Visit the [PlayAI Voice Reference](https://mastra.ai/reference/voice/playai) for more information on the PlayAI voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/integrations/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
 **Google**:
 
@@ -165,7 +138,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/integrations/voice/google) for more information on the Google voice provider.
 
 **Cloudflare**:
 
@@ -192,7 +165,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/integrations/voice/cloudflare) for more information on the Cloudflare voice provider.
 
 **Deepgram**:
 
@@ -219,7 +192,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/integrations/voice/deepgram) for more information on the Deepgram voice provider.
 
 **Inworld**:
 
@@ -246,7 +219,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Inworld Voice Reference](https://mastra.ai/reference/voice/inworld) for more information on the Inworld voice provider.
+Visit the [Inworld Voice Reference](https://mastra.ai/integrations/voice/inworld) for more information on the Inworld voice provider.
 
 **Speechify**:
 
@@ -273,7 +246,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
+Visit the [Speechify Voice Reference](https://mastra.ai/integrations/voice/speechify) for more information on the Speechify voice provider.
 
 **Sarvam**:
 
@@ -300,7 +273,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
+Visit the [Sarvam Voice Reference](https://mastra.ai/integrations/voice/sarvam) for more information on the Sarvam voice provider.
 
 **Murf**:
 
@@ -327,7 +300,7 @@ const audioStream = await voiceAgent.voice.speak(text, {
 playAudio(audioStream)
 ```
 
-Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
+Visit the [Murf Voice Reference](https://mastra.ai/integrations/voice/murf) for more information on the Murf voice provider.
 
 ### Speech to Text (STT)
 
@@ -363,7 +336,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/integrations/voice/openai) for more information on the OpenAI voice provider.
 
 **Azure**:
 
@@ -392,7 +365,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/integrations/voice/azure) for more information on the Azure voice provider.
 
 **ElevenLabs**:
 
@@ -420,7 +393,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/integrations/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
 **Google**:
 
@@ -448,7 +421,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/integrations/voice/google) for more information on the Google voice provider.
 
 **Cloudflare**:
 
@@ -476,7 +449,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/integrations/voice/cloudflare) for more information on the Cloudflare voice provider.
 
 **Deepgram**:
 
@@ -504,7 +477,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/integrations/voice/deepgram) for more information on the Deepgram voice provider.
 
 **Inworld**:
 
@@ -532,7 +505,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Inworld Voice Reference](https://mastra.ai/reference/voice/inworld) for more information on the Inworld voice provider.
+Visit the [Inworld Voice Reference](https://mastra.ai/integrations/voice/inworld) for more information on the Inworld voice provider.
 
 **Sarvam**:
 
@@ -560,7 +533,7 @@ console.log(`User said: ${transcript}`)
 const { text } = await voiceAgent.generate(transcript)
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
+Visit the [Sarvam Voice Reference](https://mastra.ai/integrations/voice/sarvam) for more information on the Sarvam voice provider.
 
 ### Speech to Speech (STS)
 
@@ -594,7 +567,7 @@ const micStream = getMicrophoneStream()
 await voiceAgent.voice.send(micStream)
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai-realtime) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/integrations/voice/openai) for more information on the OpenAI voice provider.
 
 **Google**:
 
@@ -643,7 +616,7 @@ const micStream = getMicrophoneStream()
 await voiceAgent.voice.send(micStream)
 ```
 
-Visit the [Google Gemini Live Reference](https://mastra.ai/reference/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
+Visit the [Google Gemini Live Reference](https://mastra.ai/integrations/voice/google) for more information on the Google Gemini Live voice provider.
 
 **AWS Nova Sonic**:
 
@@ -686,7 +659,7 @@ const micStream = getMicrophoneStream()
 await voiceAgent.voice.send(micStream)
 ```
 
-Visit the [AWS Nova Sonic Reference](https://mastra.ai/reference/voice/aws-nova-sonic) for more information on the AWS Nova Sonic voice provider.
+Visit the [AWS Nova Sonic Reference](https://mastra.ai/integrations/voice/aws-nova-sonic) for more information on the AWS Nova Sonic voice provider.
 
 **Inworld Realtime**:
 
@@ -728,7 +701,7 @@ const micStream = getMicrophoneStream()
 await voiceAgent.voice.send(micStream)
 ```
 
-Visit the [Inworld Realtime Reference](https://mastra.ai/reference/voice/inworld-realtime) for more information on the Inworld Realtime voice provider.
+Visit the [Inworld Realtime Reference](https://mastra.ai/integrations/voice/inworld) for more information on the Inworld Realtime voice provider.
 
 **xAI**:
 
@@ -771,11 +744,11 @@ const micStream = getMicrophoneStream()
 await voiceAgent.voice.send(micStream)
 ```
 
-Visit the [xAI Realtime Voice Reference](https://mastra.ai/reference/voice/xai-realtime) for more information on the xAI voice provider.
+Visit the [xAI Realtime Voice Reference](https://mastra.ai/integrations/voice/xai) for more information on the xAI voice provider.
 
 ### Realtime voice
 
-Run live calls a user can talk over, in the browser or over the phone. Mastra hands the audio loop to LiveKit, which covers voice activity detection, semantic turn detection, and barge-in, while your agent generates each reply with its own model, tools, and memory. For setup and configuration options, check out [Realtime voice](https://mastra.ai/guides/voice/realtime-voice).
+Run live calls a user can talk over, in the browser or over the phone. Mastra hands the audio loop to LiveKit, which covers voice activity detection, semantic turn detection, and barge-in, while your agent generates each reply with its own model, tools, and memory. For setup and configuration options, check out [Realtime voice](https://mastra.ai/integrations/voice/livekit).
 
 ## Voice configuration
 
@@ -802,7 +775,7 @@ const voice = new OpenAIVoice({
 })
 ```
 
-Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
+Visit the [OpenAI Voice Reference](https://mastra.ai/integrations/voice/openai) for more information on the OpenAI voice provider.
 
 **Azure**:
 
@@ -827,7 +800,7 @@ const voice = new AzureVoice({
 })
 ```
 
-Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
+Visit the [Azure Voice Reference](https://mastra.ai/integrations/voice/azure) for more information on the Azure voice provider.
 
 **ElevenLabs**:
 
@@ -845,25 +818,7 @@ const voice = new ElevenLabsVoice({
 })
 ```
 
-Visit the [ElevenLabs Voice Reference](https://mastra.ai/reference/voice/elevenlabs) for more information on the ElevenLabs voice provider.
-
-**PlayAI**:
-
-```typescript
-// PlayAI Voice Configuration
-const voice = new PlayAIVoice({
-  speechModel: {
-    name: 'playai-voice', // Example model name
-    speaker: 'emma', // Example speaker name
-    apiKey: process.env.PLAYAI_API_KEY,
-    language: 'en-US', // Language code
-    speed: 1.0, // Speech speed
-  },
-  // PlayAI may not have a separate listening model
-})
-```
-
-Visit the [PlayAI Voice Reference](https://mastra.ai/reference/voice/playai) for more information on the PlayAI voice provider.
+Visit the [ElevenLabs Voice Reference](https://mastra.ai/integrations/voice/elevenlabs) for more information on the ElevenLabs voice provider.
 
 **Google**:
 
@@ -884,7 +839,7 @@ const voice = new GoogleVoice({
 })
 ```
 
-Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
+Visit the [Google Voice Reference](https://mastra.ai/integrations/voice/google) for more information on the Google voice provider.
 
 **Cloudflare**:
 
@@ -902,7 +857,7 @@ const voice = new CloudflareVoice({
 })
 ```
 
-Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
+Visit the [Cloudflare Voice Reference](https://mastra.ai/integrations/voice/cloudflare) for more information on the Cloudflare voice provider.
 
 **Deepgram**:
 
@@ -923,7 +878,7 @@ const voice = new DeepgramVoice({
 })
 ```
 
-Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
+Visit the [Deepgram Voice Reference](https://mastra.ai/integrations/voice/deepgram) for more information on the Deepgram voice provider.
 
 **Inworld**:
 
@@ -951,7 +906,7 @@ const audioStream = await voice.speak('Hello!', {
 })
 ```
 
-Visit the [Inworld Voice Reference](https://mastra.ai/reference/voice/inworld) for more information on the Inworld voice provider.
+Visit the [Inworld Voice Reference](https://mastra.ai/integrations/voice/inworld) for more information on the Inworld voice provider.
 
 **Speechify**:
 
@@ -969,7 +924,7 @@ const voice = new SpeechifyVoice({
 })
 ```
 
-Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
+Visit the [Speechify Voice Reference](https://mastra.ai/integrations/voice/speechify) for more information on the Speechify voice provider.
 
 **Sarvam**:
 
@@ -989,7 +944,7 @@ const voice = new SarvamVoice({
 })
 ```
 
-Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
+Visit the [Sarvam Voice Reference](https://mastra.ai/integrations/voice/sarvam) for more information on the Sarvam voice provider.
 
 **Murf**:
 
@@ -1006,7 +961,7 @@ const voice = new MurfVoice({
 })
 ```
 
-Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
+Visit the [Murf Voice Reference](https://mastra.ai/integrations/voice/murf) for more information on the Murf voice provider.
 
 **OpenAI Realtime**:
 
@@ -1027,7 +982,7 @@ const voice = new OpenAIRealtimeVoice({
 })
 ```
 
-For more information on the OpenAI Realtime voice provider, refer to the [OpenAI Realtime Voice Reference](https://mastra.ai/reference/voice/openai-realtime).
+For more information on the OpenAI Realtime voice provider, refer to the [OpenAI Realtime Voice Reference](https://mastra.ai/integrations/voice/openai).
 
 **xAI Realtime**:
 
@@ -1059,7 +1014,7 @@ const voice = new XAIRealtimeVoice({
 })
 ```
 
-Visit the [xAI Realtime Voice Reference](https://mastra.ai/reference/voice/xai-realtime) for more information on the xAI realtime voice provider.
+Visit the [xAI Realtime Voice Reference](https://mastra.ai/integrations/voice/xai) for more information on the xAI realtime voice provider.
 
 **Google Gemini Live**:
 
@@ -1075,7 +1030,7 @@ const voice = new GeminiLiveVoice({
 })
 ```
 
-Visit the [Google Gemini Live Reference](https://mastra.ai/reference/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
+Visit the [Google Gemini Live Reference](https://mastra.ai/integrations/voice/google) for more information on the Google Gemini Live voice provider.
 
 **AWS Nova Sonic**:
 
@@ -1097,7 +1052,7 @@ const voice = new NovaSonicVoice({
 })
 ```
 
-Visit the [AWS Nova Sonic Reference](https://mastra.ai/reference/voice/aws-nova-sonic) for more information on the AWS Nova Sonic voice provider.
+Visit the [AWS Nova Sonic Reference](https://mastra.ai/integrations/voice/aws-nova-sonic) for more information on the AWS Nova Sonic voice provider.
 
 **Inworld Realtime**:
 
@@ -1117,7 +1072,7 @@ const voice = new InworldRealtimeVoice({
 })
 ```
 
-Visit the [Inworld Realtime Reference](https://mastra.ai/reference/voice/inworld-realtime) for more information on the Inworld Realtime voice provider.
+Visit the [Inworld Realtime Reference](https://mastra.ai/integrations/voice/inworld) for more information on the Inworld Realtime voice provider.
 
 **AI SDK**:
 
@@ -1145,13 +1100,13 @@ const voiceAgent = new Agent({
 
 ### Using multiple voice providers
 
-This example demonstrates how to create and use two different voice providers in Mastra: OpenAI for speech-to-text (STT) and PlayAI for text-to-speech (TTS).
+This example demonstrates how to create and use two different voice providers in Mastra: OpenAI for speech-to-text (STT) and ElevenLabs for text-to-speech (TTS).
 
 Start by creating instances of the voice providers with any necessary configuration.
 
 ```typescript
 import { OpenAIVoice } from '@mastra/voice-openai'
-import { PlayAIVoice } from '@mastra/voice-playai'
+import { ElevenLabsVoice } from '@mastra/voice-elevenlabs'
 import { CompositeVoice } from '@mastra/core/voice'
 import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
 
@@ -1163,13 +1118,8 @@ const input = new OpenAIVoice({
   },
 })
 
-// Initialize PlayAI voice for TTS
-const output = new PlayAIVoice({
-  speechModel: {
-    name: 'playai-voice',
-    apiKey: process.env.PLAYAI_API_KEY,
-  },
-})
+// Initialize ElevenLabs voice for TTS
+const output = new ElevenLabsVoice()
 
 // Combine the providers using CompositeVoice
 const voice = new CompositeVoice({
@@ -1228,12 +1178,12 @@ You can also mix AI SDK models with Mastra providers:
 
 ```typescript
 import { CompositeVoice } from '@mastra/core/voice'
-import { PlayAIVoice } from '@mastra/voice-playai'
+import { ElevenLabsVoice } from '@mastra/voice-elevenlabs'
 import { groq } from '@ai-sdk/groq'
 
 const voice = new CompositeVoice({
   input: groq.transcription('whisper-large-v3'), // AI SDK for STT
-  output: new PlayAIVoice(), // Mastra provider for TTS
+  output: new ElevenLabsVoice(), // Mastra provider for TTS
 })
 ```
 
@@ -1243,15 +1193,14 @@ For more information on the CompositeVoice, refer to the [CompositeVoice Referen
 
 - [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)
-- [xAI Realtime Voice](https://mastra.ai/reference/voice/xai-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)
-- [AWS Nova Sonic Voice](https://mastra.ai/reference/voice/aws-nova-sonic)
-- [Deepgram Voice](https://mastra.ai/reference/voice/deepgram)
-- [Inworld Voice](https://mastra.ai/reference/voice/inworld)
-- [LiveKit](https://mastra.ai/reference/voice/livekit)
-- [PlayAI Voice](https://mastra.ai/reference/voice/playai)
+- [OpenAI Voice](https://mastra.ai/integrations/voice/openai)
+- [OpenAI Realtime Voice](https://mastra.ai/integrations/voice/openai)
+- [xAI Realtime Voice](https://mastra.ai/integrations/voice/xai)
+- [Azure Voice](https://mastra.ai/integrations/voice/azure)
+- [Google Voice](https://mastra.ai/integrations/voice/google)
+- [Google Gemini Live Voice](https://mastra.ai/integrations/voice/google)
+- [AWS Nova Sonic Voice](https://mastra.ai/integrations/voice/aws-nova-sonic)
+- [Deepgram Voice](https://mastra.ai/integrations/voice/deepgram)
+- [Inworld Voice](https://mastra.ai/integrations/voice/inworld)
+- [LiveKit](https://mastra.ai/integrations/voice/livekit)
 - [Voice Examples](https://github.com/mastra-ai/voice-examples)

package/dist/docs/references/{reference-voice-google-gemini-live.md → integrations-voice-google.md}

@@ -1,10 +1,285 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Google Gemini Live voice
+# Google
+
+## Speech
+
+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, advanced audio configuration options, and both standard API key authentication and Vertex AI mode for enterprise deployments.
+
+### Usage example
+
+```typescript
+import { GoogleVoice } from '@mastra/voice-google'
+
+// Initialize with default configuration (uses GOOGLE_API_KEY environment variable)
+const voice = new GoogleVoice()
+
+// Text-to-Speech (plain text)
+const audioStream = await voice.speak('Hello, world!', {
+  languageCode: 'en-US',
+  audioConfig: {
+    audioEncoding: 'LINEAR16',
+  },
+})
+
+// Text-to-Speech with SSML
+const ssmlStream = await voice.speak('ignored', {
+  input: {
+    ssml: '<speak>Take <say-as interpret-as="unit">5 mg</say-as> daily.</speak>',
+  },
+})
+
+// Text-to-Speech with Gemini-TTS model
+const geminiStream = await voice.speak('Hello from Gemini TTS!', {
+  voice: { name: 'Kore', modelName: 'gemini-2.5-flash-preview-tts' },
+  input: { prompt: 'Warm, calm tone.' },
+})
+
+// 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
+
+**speechModel** (`GoogleModelConfig`): Configuration for text-to-speech functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
+
+**speechModel.apiKey** (`string`): Google Cloud API key. Falls back to GOOGLE\_API\_KEY environment variable. Not used when vertexAI is true.
+
+**speechModel.keyFilename** (`string`): Path to service account JSON key file. Falls back to GOOGLE\_APPLICATION\_CREDENTIALS environment variable.
+
+**speechModel.credentials** (`object`): In-memory service account credentials object with client\_email and private\_key properties.
+
+**listeningModel** (`GoogleModelConfig`): Configuration for speech-to-text functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
+
+**listeningModel.apiKey** (`string`): Google Cloud API key. Falls back to GOOGLE\_API\_KEY environment variable. Not used when vertexAI is true.
+
+**listeningModel.keyFilename** (`string`): Path to service account JSON key file. Falls back to GOOGLE\_APPLICATION\_CREDENTIALS environment variable.
+
+**listeningModel.credentials** (`object`): In-memory service account credentials object with client\_email and private\_key properties.
+
+**speaker** (`string`): Default voice ID to use for text-to-speech (Default: `'en-US-Casual-K'`)
+
+**vertexAI** (`boolean`): Enable Vertex AI mode for enterprise deployments. Uses project-based authentication instead of API keys. Requires 'project' to be set. (Default: `false`)
+
+**project** (`string`): Google Cloud project ID (required when vertexAI is true). Falls back to GOOGLE\_CLOUD\_PROJECT environment variable.
+
+**location** (`string`): Google Cloud region for Vertex AI. Falls back to GOOGLE\_CLOUD\_LOCATION environment variable. (Default: `'us-central1'`)
+
+### Methods
+
+#### `speak()`
+
+Converts text to speech using Google Cloud Text-to-Speech service.
+
+**input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
+
+**options** (`object`): Speech synthesis options
+
+**options.speaker** (`string`): Voice ID to use for this request.
+
+**options.languageCode** (`string`): Language code for the voice (e.g., 'en-US'). Defaults to the language code derived from the speaker ID, or 'en-US'.
+
+**options.input** (`ISynthesizeSpeechRequest['input']`): Rich input object passed through to the Google Cloud TTS API. Supports ssml, markup, prompt (Gemini-TTS style steering), customPronunciations, and multiSpeakerMarkup. When provided without text, ssml, markup, or multiSpeakerMarkup, the positional input argument is used as the text field automatically.
+
+**options.voice** (`ISynthesizeSpeechRequest['voice']`): Voice configuration merged on top of defaults (name and languageCode). Supports modelName (e.g., 'gemini-2.5-flash-preview-tts') and multiSpeakerVoiceConfig.
+
+**options.audioConfig** (`ISynthesizeSpeechRequest['audioConfig']`): Audio configuration options from Google Cloud Text-to-Speech API.
+
+Returns: `Promise<NodeJS.ReadableStream>`
+
+#### `listen()`
+
+Converts speech to text using Google Cloud Speech-to-Text service. Supports both v1 (default) and v2 APIs. The v2 API adds support for AAC-in-MP4 audio (iOS Safari) via auto-decoding.
+
+##### v1 (default)
+
+**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe
+
+**options** (`GoogleListenOptionsV1`): v1 recognition options
+
+**options.config** (`IRecognitionConfig`): v1 recognition configuration from Google Cloud Speech-to-Text API
+
+##### v2
+
+Pass `v2: true` to use the Cloud Speech-to-Text v2 API, which supports additional audio formats like AAC-in-MP4 (iOS Safari).
+
+```typescript
+const transcript = await voice.listen(iosSafariAacStream, {
+  v2: true,
+  config: {
+    autoDecodingConfig: {},
+  },
+})
+```
+
+**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe
+
+**options** (`GoogleListenOptionsV2`): v2 recognition options
+
+**options.v2** (`true`): Enables the v2 API path
+
+**options.config** (`v2.IRecognitionConfig`): v2 recognition configuration. Defaults to auto-decoding with languageCodes: \['en-US'] and model: 'long'. Set autoDecodingConfig: {} to auto-detect the audio format, or use explicitDecodingConfig to specify an encoding like MP4\_AAC, M4A\_AAC, or MOV\_AAC.
+
+**options.recognizer** (`string`): v2 recognizer resource path. Defaults to projects/{project}/locations/global/recognizers/\_ where {project} is resolved from the constructor project option, GOOGLE\_CLOUD\_PROJECT, or the client's default project.
+
+Returns: `Promise<string>`
+
+#### `getSpeakers()`
+
+Returns an array of available voice options, where each node contains:
+
+**voiceId** (`string`): Unique identifier for the voice
+
+**languageCodes** (`string[]`): List of language codes supported by this voice
+
+#### `isUsingVertexAI()`
+
+Checks if Vertex AI mode is enabled.
+
+Returns: `boolean` - `true` if using Vertex AI, `false` otherwise
+
+#### `getProject()`
+
+Gets the configured Google Cloud project ID.
+
+Returns: `string | undefined` - The project ID or `undefined` if not set
+
+#### `getLocation()`
+
+Gets the configured Google Cloud location/region.
+
+Returns: `string` - The location (default: `'us-central1'`)
+
+### Authentication
+
+The Google Voice provider supports two authentication methods:
+
+#### Standard Mode (API Key)
+
+Uses a Google Cloud API key for authentication. Suitable for development and basic use cases.
+
+```typescript
+// Using environment variable (GOOGLE_API_KEY)
+const voice = new GoogleVoice()
+
+// Using explicit API key
+const voice = new GoogleVoice({
+  speechModel: { apiKey: 'your-api-key' },
+  listeningModel: { apiKey: 'your-api-key' },
+  speaker: 'en-US-Casual-K',
+})
+```
+
+#### Vertex AI Mode (Service Account)
+
+Uses Google Cloud project-based authentication with service accounts. Recommended for production and enterprise deployments.
+
+**Benefits:**
+
+- Better security (no API keys in code)
+- IAM-based access control
+- Project-level billing and quotas
+- Audit logging
+- Enterprise features
+
+**Configuration Options:**
+
+```typescript
+// Using Application Default Credentials (ADC)
+// Set GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT env vars
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  location: 'us-central1', // Optional, defaults to 'us-central1'
+})
+
+// Using service account key file
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  speechModel: {
+    keyFilename: '/path/to/service-account.json',
+  },
+  listeningModel: {
+    keyFilename: '/path/to/service-account.json',
+  },
+})
+
+// Using in-memory credentials
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  speechModel: {
+    credentials: {
+      client_email: 'service-account@project.iam.gserviceaccount.com',
+      private_key: '-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----',
+    },
+  },
+})
+```
+
+##### Required Permissions
+
+##### IAM Roles
+
+For Text-to-Speech:
+
+- `roles/texttospeech.admin` - Text-to-Speech Admin (full access)
+- `roles/texttospeech.editor` - Text-to-Speech Editor (create and manage)
+- `roles/texttospeech.viewer` - Text-to-Speech Viewer (read-only)
+
+For Speech-to-Text:
+
+- `roles/speech.client` - Speech-to-Text Client
+
+##### OAuth Scopes
+
+For synchronous Text-to-Speech synthesis:
+
+- `https://www.googleapis.com/auth/cloud-platform` - Full access to Google Cloud Platform services
+
+For long-audio Text-to-Speech operations:
+
+- `locations.longAudioSynthesize` - Create long-audio synthesis operations
+- `operations.get` - Get operation status
+- `operations.list` - List operations
+
+### Important notes
+
+1. **Authentication**: Either a Google Cloud API key (standard mode) or service account credentials (Vertex AI mode) is required.
+
+2. **Environment Variables**:
+
+   - `GOOGLE_API_KEY` - API key for standard mode
+   - `GOOGLE_CLOUD_PROJECT` - Project ID for Vertex AI mode
+   - `GOOGLE_CLOUD_LOCATION` - Location for Vertex AI mode (defaults to 'us-central1')
+   - `GOOGLE_APPLICATION_CREDENTIALS` - Path to service account key file
+
+3. The default voice is set to `'en-US-Casual-K'`.
+
+4. Both text-to-speech and speech-to-text services use LINEAR16 as the default audio encoding.
+
+5. The `speak()` method supports advanced audio configuration through the Google Cloud Text-to-Speech API.
+
+6. The `listen()` method supports various recognition configurations through the Google Cloud Speech-to-Text API.
+
+7. Available voices can be filtered by language code using the `getSpeakers()` method.
+
+8. Vertex AI mode provides enterprise features including IAM control, audit logs, and project-level billing.
+
+## Gemini Live
 
 The GeminiLiveVoice class provides real-time voice interaction capabilities using Google's Gemini Live API. It supports bidirectional audio streaming, tool calling, session management, and both standard Google API and Vertex AI authentication methods.
 
-## Usage example
+### Usage example
 
 ```typescript
 import { GeminiLiveVoice } from '@mastra/voice-google-gemini-live'
@@ -88,9 +363,9 @@ await voice.disconnect()
 voice.close()
 ```
 
-## Configuration
+### Configuration
 
-### Constructor options
+#### Constructor options
 
 **apiKey** (`string`): Google API key for Gemini API authentication. Required unless using Vertex AI.
 
@@ -122,9 +397,9 @@ voice.close()
 
 **debug** (`boolean`): Enable debug logging for troubleshooting. (Default: `false`)
 
-## Methods
+### Methods
 
-### `connect()`
+#### `connect()`
 
 Establishes a connection to the Gemini Live API. Must be called before using speak, listen, or send methods.
 
@@ -132,7 +407,7 @@ Establishes a connection to the Gemini Live API. Must be called before using spe
 
 **returns** (`Promise<void>`): Promise that resolves when the connection is established.
 
-### `speak()`
+#### `speak()`
 
 Converts text to speech and sends it to the model. Can accept either a string or a readable stream as input.
 
@@ -148,7 +423,7 @@ Converts text to speech and sends it to the model. Can accept either a string or
 
 Returns: `Promise<void>` (responses are emitted via `speaker` and `writing` events)
 
-### `sendContext()`
+#### `sendContext()`
 
 Sends conversation history into the live session without triggering a model response. Use this to seed prior turns (e.g. from Mastra Memory) on a cold connect so the model has context before the user speaks.
 
@@ -170,7 +445,7 @@ await voice.send(micStream)
 
 Returns: `Promise<void>`
 
-### `listen()`
+#### `listen()`
 
 Processes audio input for speech recognition. Takes a readable stream of audio data and returns the transcribed text.
 
@@ -180,7 +455,7 @@ Processes audio input for speech recognition. Takes a readable stream of audio d
 
 Returns: `Promise<string>` - The transcribed text
 
-### `send()`
+#### `send()`
 
 Streams audio data in real-time to the Gemini service for continuous audio streaming scenarios like live microphone input.
 
@@ -188,7 +463,7 @@ Streams audio data in real-time to the Gemini service for continuous audio strea
 
 Returns: `Promise<void>`
 
-### `updateSessionConfig()`
+#### `updateSessionConfig()`
 
 Updates the session configuration at runtime. This can modify voice settings and speaker selection. It can also modify other runtime configurations.
 
@@ -196,7 +471,7 @@ Updates the session configuration at runtime. This can modify voice settings and
 
 Returns: `Promise<void>`
 
-### `addTools()`
+#### `addTools()`
 
 Adds a set of tools to the voice instance. Tools allow the model to perform additional actions during conversations. When GeminiLiveVoice is added to an Agent, any tools configured for the Agent will automatically be available to the voice interface.
 
@@ -204,7 +479,7 @@ Adds a set of tools to the voice instance. Tools allow the model to perform addi
 
 Returns: `void`
 
-### `addInstructions()`
+#### `addInstructions()`
 
 Adds or updates system instructions for the model.
 
@@ -212,7 +487,7 @@ Adds or updates system instructions for the model.
 
 Returns: `void`
 
-### `answer()`
+#### `answer()`
 
 Triggers a response from the model. This method is primarily used internally when integrated with an Agent.
 
@@ -220,25 +495,25 @@ Triggers a response from the model. This method is primarily used internally whe
 
 Returns: `Promise<void>`
 
-### `getSpeakers()`
+#### `getSpeakers()`
 
 Returns a list of available voice speakers for the Gemini Live API.
 
 Returns: `Promise<Array<{ voiceId: string; description?: string }>>`
 
-### `disconnect()`
+#### `disconnect()`
 
 Disconnects from the Gemini Live session and cleans up resources. This is the async method that properly handles cleanup.
 
 Returns: `Promise<void>`
 
-### `close()`
+#### `close()`
 
 Synchronous wrapper for disconnect(). Calls disconnect() internally without awaiting.
 
 Returns: `void`
 
-### `on()`
+#### `on()`
 
 Registers an event listener for voice events.
 
@@ -248,7 +523,7 @@ Registers an event listener for voice events.
 
 Returns: `void`
 
-### `off()`
+#### `off()`
 
 Removes a previously registered event listener.
 
@@ -258,7 +533,7 @@ Removes a previously registered event listener.
 
 Returns: `void`
 
-## Events
+### Events
 
 The GeminiLiveVoice class emits the following events:
 
@@ -282,7 +557,7 @@ The GeminiLiveVoice class emits the following events:
 
 **interrupt** (`event`): Emitted on barge-in when the user starts speaking over an in-flight model response. The server cancels any further audio for the current turn. Callback receives { type: 'user', timestamp: number }.
 
-## Native-audio behavior
+### Native-audio behavior
 
 Native-audio Gemini Live models (any model whose ID contains `native-audio`, such as `gemini-2.5-flash-native-audio-preview-12-2025`) split text output across two channels:
 
@@ -293,7 +568,7 @@ On non-native-audio models there is no `output_audio_transcription` channel, so
 
 Input transcription, output transcription, and barge-in detection (`realtime_input_config.activity_handling = 'START_OF_ACTIVITY_INTERRUPTS'`) are enabled automatically in the setup payload. You don't need extra configuration.
 
-## Available models
+### Available models
 
 The following Gemini Live models are available:
 
@@ -305,7 +580,7 @@ The following Gemini Live models are available:
 - `gemini-live-2.5-flash-preview`
 - `gemini-2.6.flash-preview-tts`
 
-## Available voices
+### Available voices
 
 The following voice options are available:
 
@@ -314,9 +589,9 @@ The following voice options are available:
 - `Kore`: Neutral, professional
 - `Fenrir`: Warm, approachable
 
-## Authentication methods
+### Authentication methods
 
-### Gemini API (Development)
+#### Gemini API (Development)
 
 The simplest method using an API key from [Google AI Studio](https://makersuite.google.com/app/apikey):
 
@@ -327,7 +602,7 @@ const voice = new GeminiLiveVoice({
 })
 ```
 
-### Vertex AI (Production)
+#### Vertex AI (Production)
 
 For production use with OAuth authentication and Google Cloud Platform:
 
@@ -356,9 +631,9 @@ const voice = new GeminiLiveVoice({
 })
 ```
 
-## Advanced features
+### Advanced features
 
-### Session Management
+#### Session Management
 
 The Gemini Live API supports session resumption for handling network interruptions:
 
@@ -377,7 +652,7 @@ const voice = new GeminiLiveVoice({
 })
 ```
 
-### Tool Calling
+#### Tool Calling
 
 Enable the model to call functions during conversations:
 
@@ -402,7 +677,7 @@ voice.on('toolCall', ({ name, args, id }) => {
 })
 ```
 
-## Notes
+### Notes
 
 - The Gemini Live API uses WebSockets for real-time communication
 - Audio is processed as 16kHz PCM16 for input and 24kHz PCM16 for output

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-google-gemini-live",
-  "version": "0.14.6-alpha.3",
+  "version": "0.14.6",
   "description": "Mastra Google Gemini Live API integration",
   "type": "module",
   "files": [
@@ -27,7 +27,7 @@
     "@google/genai": "^1.52.0",
     "google-auth-library": "^10.9.1",
     "ws": "^8.21.0",
-    "@mastra/schema-compat": "1.3.6-alpha.2"
+    "@mastra/schema-compat": "1.3.6"
   },
   "devDependencies": {
     "@types/node": "22.20.1",
@@ -40,10 +40,10 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
     "zod": "^4.4.3",
-    "@internal/test-utils": "0.0.57",
-    "@internal/types-builder": "0.0.96",
-    "@internal/voice": "0.0.19",
-    "@internal/lint": "0.0.121"
+    "@internal/test-utils": "0.0.58",
+    "@internal/voice": "0.0.20",
+    "@internal/types-builder": "0.0.97",
+    "@internal/lint": "0.0.122"
   },
   "homepage": "https://mastra.ai",
   "repository": {