npm - @mastra/mcp-docs-server - Versions diffs - 1.2.15-alpha.9 → 1.2.16-alpha.1 - Mend

@mastra/mcp-docs-server 1.2.15-alpha.9 → 1.2.16-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (532) hide show

package/.docs/{guides → reference}/voice/overview.md RENAMED Viewed

@@ -29,7 +29,7 @@ You can then use the following voice capabilities:
 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](https://mastra.ai/guides/voice/text-to-speech).
+For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/reference/voice/text-to-speech).
 **OpenAI**:
@@ -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,11 +300,11 @@ 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)
-Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/guides/voice/speech-to-text).
+Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/reference/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).
@@ -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,11 +533,11 @@ 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)
-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/guides/voice/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/reference/voice/speech-to-speech).
 **OpenAI**:
@@ -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/.docs/{guides → reference}/voice/speech-to-speech.md RENAMED Viewed

@@ -54,7 +54,7 @@ const micStream = getMicrophoneStream()
 await agent.voice.send(micStream)
 ```
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).
 ## Use tools in realtime sessions

package/.docs/{guides → reference}/voice/speech-to-text.md RENAMED Viewed

@@ -30,13 +30,13 @@ const voice = new OpenAIVoice()
 Mastra supports several Speech-to-Text providers, each with their own capabilities and strengths:
-- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-accuracy transcription with Whisper models
-- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech recognition with enterprise-grade reliability
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Advanced speech recognition with support for multiple languages
-- [**Google**](https://mastra.ai/reference/voice/google): Google's speech recognition with extensive language support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech recognition for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech recognition with high accuracy for various accents
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
+- [**OpenAI**](https://mastra.ai/integrations/voice/openai): High-accuracy transcription with Whisper models
+- [**Azure**](https://mastra.ai/integrations/voice/azure): Microsoft's speech recognition with enterprise-grade reliability
+- [**ElevenLabs**](https://mastra.ai/integrations/voice/elevenlabs): Advanced speech recognition with support for multiple languages
+- [**Google**](https://mastra.ai/integrations/voice/google): Google's speech recognition with extensive language support
+- [**Cloudflare**](https://mastra.ai/integrations/voice/cloudflare): Edge-optimized speech recognition for low-latency applications
+- [**Deepgram**](https://mastra.ai/integrations/voice/deepgram): AI-powered speech recognition with high accuracy for various accents
+- [**Sarvam**](https://mastra.ai/integrations/voice/sarvam): Specialized in Indic languages and accents
 Each provider is implemented as a separate package that you can install as needed:
@@ -96,4 +96,4 @@ const transcription = await agent.voice.listen(audioStream, {
 console.log(`Transcription: ${transcription}`)
 ```
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).

package/.docs/{guides → reference}/voice/text-to-speech.md RENAMED Viewed

@@ -4,7 +4,7 @@
 Text-to-Speech (TTS) in Mastra offers a unified API for synthesizing spoken audio from text using providers. By incorporating TTS into your applications, you can enhance user experience with natural voice interactions and improve accessibility for users with visual impairments, plus create more engaging multimodal interfaces.
-TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/guides/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
+TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/reference/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
 ## Configuration
@@ -35,16 +35,15 @@ const voice = new OpenAIVoice()
 Mastra supports Text-to-Speech providers, each with their own unique capabilities and voice options. You can choose the provider that best suits your application's needs:
-- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-quality voices with natural intonation and expression
-- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech service with voices and languages
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Ultra-realistic voices with emotion and fine-grained control
-- [**PlayAI**](https://mastra.ai/reference/voice/playai): Specialized in natural-sounding voices with various styles
-- [**Google**](https://mastra.ai/reference/voice/google): Google's speech synthesis with multilingual support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech synthesis for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech technology with high accuracy
-- [**Speechify**](https://mastra.ai/reference/voice/speechify): Text-to-speech optimized for readability and accessibility
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
-- [**Murf**](https://mastra.ai/reference/voice/murf): Studio-quality voice overs with customizable parameters
+- [**OpenAI**](https://mastra.ai/integrations/voice/openai): High-quality voices with natural intonation and expression
+- [**Azure**](https://mastra.ai/integrations/voice/azure): Microsoft's speech service with voices and languages
+- [**ElevenLabs**](https://mastra.ai/integrations/voice/elevenlabs): Ultra-realistic voices with emotion and fine-grained control
+- [**Google**](https://mastra.ai/integrations/voice/google): Google's speech synthesis with multilingual support
+- [**Cloudflare**](https://mastra.ai/integrations/voice/cloudflare): Edge-optimized speech synthesis for low-latency applications
+- [**Deepgram**](https://mastra.ai/integrations/voice/deepgram): AI-powered speech technology with high accuracy
+- [**Speechify**](https://mastra.ai/integrations/voice/speechify): Text-to-speech optimized for readability and accessibility
+- [**Sarvam**](https://mastra.ai/integrations/voice/sarvam): Specialized in Indic languages and accents
+- [**Murf**](https://mastra.ai/integrations/voice/murf): Studio-quality voice overs with customizable parameters
 Each provider is implemented as a separate package that you can install as needed:
@@ -102,4 +101,4 @@ await new Promise<void>((resolve, reject) => {
 })
 ```
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).

package/.docs/reference/workers/overview.md CHANGED Viewed

@@ -2,6 +2,8 @@
 # Workers
+> **Beta:** Breaking changes may occur without a major version bump until the API is stable.
 For usage patterns and deployment topologies, see [Workers](https://mastra.ai/docs/deployment/workers).
 ## Environment variables
@@ -75,13 +77,13 @@ Executes background tool calls dispatched by agents.
 A deployment running all worker types requires a storage backend that implements the `workflows`, `backgroundTasks`, and `schedules` domains. The `schedules` domain is specifically required by the SchedulerWorker. If you don't use scheduled workflows, backends without it can still support orchestration and background tasks. The following backends support all three:
-| Backend    | Package                                                          |
-| ---------- | ---------------------------------------------------------------- |
-| PostgreSQL | [`@mastra/pg`](https://mastra.ai/reference/storage/postgresql)   |
-| LibSQL     | [`@mastra/libsql`](https://mastra.ai/reference/storage/libsql)   |
-| MySQL      | `@mastra/mysql`                                                  |
-| MongoDB    | [`@mastra/mongodb`](https://mastra.ai/reference/storage/mongodb) |
-| Spanner    | [`@mastra/spanner`](https://mastra.ai/reference/storage/spanner) |
-| Convex     | [`@mastra/convex`](https://mastra.ai/reference/storage/convex)   |
+| Backend    | Package                                                               |
+| ---------- | --------------------------------------------------------------------- |
+| PostgreSQL | [`@mastra/pg`](https://mastra.ai/integrations/databases/postgresql)   |
+| LibSQL     | [`@mastra/libsql`](https://mastra.ai/integrations/databases/libsql)   |
+| MySQL      | `@mastra/mysql`                                                       |
+| MongoDB    | [`@mastra/mongodb`](https://mastra.ai/integrations/databases/mongodb) |
+| Spanner    | [`@mastra/spanner`](https://mastra.ai/integrations/databases/spanner) |
+| Convex     | [`@mastra/convex`](https://mastra.ai/integrations/databases/convex)   |
 Other storage backends (Upstash, DynamoDB, Cloudflare D1, ClickHouse, Redis) support workflows and some worker features, but are missing the `schedules` domain. They can still be used for orchestration and background task workers if you don't deploy the scheduler.

package/.docs/reference/workflows/dynamic-workflow-definition.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Dynamic workflow definition
-> **Beta:** Dynamic workflows are in beta. Breaking changes may occur without a major version bump until the API is stable.
+> **Beta:** Breaking changes may occur without a major version bump until the API is stable.
 A dynamic workflow definition is a JSON-compatible `DynamicWorkflowGraph` accepted by [`Mastra.addDynamicWorkflow()`](https://mastra.ai/reference/core/addDynamicWorkflow), the stored-workflow server routes, and the Client SDK workflows API.
@@ -132,6 +132,8 @@ Tool entries accept the same optional `description` and `options` fields as agen
 A `mapping` entry reshapes data. Its `mapConfig` is a JSON string that encodes an object. Each key becomes a key in the step output, and each descriptor defines one source.
+When you call [`Mastra.addDynamicWorkflow()`](https://mastra.ai/reference/core/addDynamicWorkflow) directly, `mapConfig` also accepts the object itself. Mastra encodes it to a JSON string before registering and storing the definition, so the persisted row is the same either way. A stored definition always carries the JSON string form.
 | Descriptor                             | Description                               |
 | -------------------------------------- | ----------------------------------------- |
 | `{ "value": ... }`                     | A constant JSON value                     |

package/.docs/reference/workflows/run-methods/timeTravel.md CHANGED Viewed

@@ -150,6 +150,7 @@ const result = await run.timeTravel({
 - When re-executing a workflow, the workflow loads the existing snapshot from storage (if available)
 - Step results before the target step are reconstructed from the snapshot or provided context
 - Execution begins from the specified step with the provided or reconstructed input data
+- If a step that precedes the target in the current workflow definition has no recorded entry in the snapshot (for example, the step was renamed since the run was recorded, or the run never reached it), `timeTravel` rejects with a descriptive error before anything executes and the stored snapshot is left unchanged
 - The workflow continues to completion from that point forward
 - Time travel can be used on workflows that haven't been run yet by providing custom context or input data for the step to start from.

package/.docs/reference/workflows/workflow.md CHANGED Viewed

@@ -127,6 +127,24 @@ export const testWorkflow = createWorkflow({
 **options.pruneSnapshot** (`(params: { snapshot: WorkflowRunState; workflowStatus: WorkflowRunStatus }) => WorkflowRunState`): Optional hook to transform the workflow snapshot immediately before it is persisted. Must return JSON-serializable data and preserve everything the workflow needs to resume (suspended step suspendPayloads, suspendedPaths, executionPath, etc.). Used internally by agent runs to keep snapshots minimal; user workflows persist full snapshots by default.
+**options.onStart** (`(info: WorkflowStartCallbackInfo) => void | Promise<void>`): Callback awaited before a run starts executing, and before any step runs. Fires only on initial start, not on resume, restart, or time travel. Unlike onFinish and onError, errors thrown here are propagated: they reject the start() or stream() call and the run never executes, so this can be used as a pre-flight gate such as a quota check. The run record created by createRun() stays at status pending.
+**options.onStart.runId** (`string`): The workflow run ID
+**options.onStart.workflowId** (`string`): The workflow identifier
+**options.onStart.resourceId** (`string`): Resource or user identifier for multi-tenant scenarios
+**options.onStart.getInitData** (`() => any`): Returns the initial workflow input data
+**options.onStart.state** (`Record<string, any>`): The initial workflow state
+**options.onStart.requestContext** (`RequestContext`): The request context for the run
+**options.onStart.mastra** (`Mastra`): The Mastra instance, when the workflow is registered
+**options.onStart.logger** (`IMastraLogger`): The Mastra logger
 **options.onFinish** (`(result: WorkflowFinishCallbackResult) => void | Promise<void>`): Callback invoked when workflow completes with any status (success, failed, suspended, tripwire). Receives the workflow result including status, output, error, and step results. Errors thrown in this callback are caught and logged, not propagated.
 **options.onFinish.status** (`WorkflowRunStatus`): The workflow status: 'success', 'failed', 'suspended', or 'tripwire'