@mastra/mcp-docs-server 1.2.15-alpha.20 → 1.2.15-alpha.22

package/.docs/{reference/voice/openai-realtime.md → integrations/voice/openai.md}

@@ -1,10 +1,107 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# OpenAI Realtime voice
+# OpenAI
+
+## Voice
+
+The OpenAIVoice class in Mastra provides text-to-speech and speech-to-text capabilities using OpenAI's models.
+
+### Usage example
+
+```typescript
+import { OpenAIVoice } from '@mastra/voice-openai'
+
+// Initialize with default configuration using environment variables
+const voice = new OpenAIVoice()
+
+// Or initialize with specific configuration
+const voiceWithConfig = new OpenAIVoice({
+  speechModel: {
+    name: 'tts-1-hd',
+    apiKey: 'your-openai-api-key',
+  },
+  listeningModel: {
+    name: 'whisper-1',
+    apiKey: 'your-openai-api-key',
+  },
+  speaker: 'alloy', // Default voice
+})
+
+// Convert text to speech
+const audioStream = await voice.speak('Hello, how can I help you?', {
+  speaker: 'nova', // Override default voice
+  speed: 1.2, // Adjust speech speed
+})
+
+// Convert speech to text
+const text = await voice.listen(audioStream, {
+  filetype: 'mp3',
+})
+```
+
+### Configuration
+
+#### Constructor options
+
+**speechModel** (`OpenAIConfig`): Configuration for text-to-speech synthesis. (Default: `{ name: 'tts-1' }`)
+
+**speechModel.name** (`'tts-1' | 'tts-1-hd' | 'whisper-1'`): Model name. Use 'tts-1-hd' for higher quality audio.
+
+**speechModel.apiKey** (`string`): OpenAI API key. Falls back to OPENAI\_API\_KEY environment variable.
+
+**listeningModel** (`OpenAIConfig`): Configuration for speech-to-text recognition. (Default: `{ name: 'whisper-1' }`)
+
+**listeningModel.name** (`'tts-1' | 'tts-1-hd' | 'whisper-1'`): Model name. Use 'tts-1-hd' for higher quality audio.
+
+**listeningModel.apiKey** (`string`): OpenAI API key. Falls back to OPENAI\_API\_KEY environment variable.
+
+**speaker** (`OpenAIVoiceId`): Default voice ID for speech synthesis. (Default: `'alloy'`)
+
+### Methods
+
+#### `speak()`
+
+Converts text to speech using OpenAI's text-to-speech models.
+
+**input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
+
+**options** (`Options`): Configuration options.
+
+**options.speaker** (`OpenAIVoiceId`): Voice ID to use for speech synthesis.
+
+**options.speed** (`number`): Speech speed multiplier.
+
+Returns: `Promise<NodeJS.ReadableStream>`
+
+#### `listen()`
+
+Transcribes audio using OpenAI's Whisper model.
+
+**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe.
+
+**options** (`Options`): Configuration options.
+
+**options.filetype** (`string`): Audio format of the input stream.
+
+Returns: `Promise<string>`
+
+#### `getSpeakers()`
+
+Returns an array of available voice options, where each node contains:
+
+**voiceId** (`string`): Unique identifier for the voice
+
+### Notes
+
+- API keys can be provided via constructor options or the `OPENAI_API_KEY` environment variable
+- The `tts-1-hd` model provides higher quality audio but may have slower processing times
+- Speech recognition supports multiple audio formats including mp3, wav, and webm
+
+## Realtime
 
 The OpenAIRealtimeVoice class provides real-time voice interaction capabilities using OpenAI's WebSocket-based API. It supports real time speech to speech, voice activity detection, and event-based audio streaming.
 
-## Usage example
+### Usage example
 
 ```typescript
 import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
@@ -55,9 +152,9 @@ await voice.send(microphoneStream)
 voice.connect()
 ```
 
-## Configuration
+### Configuration
 
-### Constructor options
+#### Constructor options
 
 **model** (`string`): The model ID to use for real-time voice interactions. (Default: `'gpt-5.1-realtime-preview-2024-12-17'`)
 
@@ -65,7 +162,7 @@ voice.connect()
 
 **speaker** (`string`): Default voice ID for speech synthesis. (Default: `'alloy'`)
 
-### Voice Activity Detection (VAD) Configuration
+#### Voice Activity Detection (VAD) Configuration
 
 **type** (`string`): Type of VAD to use. Server-side VAD provides better accuracy. (Default: `'server_vad'`)
 
@@ -75,15 +172,15 @@ voice.connect()
 
 **silence\_duration\_ms** (`number`): Milliseconds of silence before ending a turn. (Default: `1000`)
 
-## Methods
+### Methods
 
-### `connect()`
+#### `connect()`
 
 Establishes a connection to the OpenAI Realtime service. Must be called before using speak, listen, or send functions.
 
 **returns** (`Promise<void>`): Promise that resolves when the connection is established.
 
-### `speak()`
+#### `speak()`
 
 Emits a speaking event using the configured voice model. Can accept either a string or a readable stream as input.
 
@@ -95,7 +192,7 @@ Emits a speaking event using the configured voice model. Can accept either a str
 
 Returns: `Promise<void>`
 
-### `listen()`
+#### `listen()`
 
 Processes audio input for speech recognition. Takes a readable stream of audio data and emits a 'listening' event with the transcribed text.
 
@@ -103,7 +200,7 @@ Processes audio input for speech recognition. Takes a readable stream of audio d
 
 Returns: `Promise<void>`
 
-### `send()`
+#### `send()`
 
 Streams audio data in real-time to the OpenAI service for continuous audio streaming scenarios like live microphone input.
 
@@ -111,7 +208,7 @@ Streams audio data in real-time to the OpenAI service for continuous audio strea
 
 Returns: `Promise<void>`
 
-### `updateConfig()`
+#### `updateConfig()`
 
 Updates the session configuration for the voice instance. This can modify voice settings and turn detection. It can also modify other parameters.
 
@@ -119,7 +216,7 @@ Updates the session configuration for the voice instance. This can modify voice
 
 Returns: `void`
 
-### `addTools()`
+#### `addTools()`
 
 Adds a set of tools to the voice instance. Tools allow the model to perform additional actions during conversations. When OpenAIRealtimeVoice is added to an Agent, any tools configured for the Agent will automatically be available to the voice interface.
 
@@ -127,19 +224,19 @@ Adds a set of tools to the voice instance. Tools allow the model to perform addi
 
 Returns: `void`
 
-### `close()`
+#### `close()`
 
 Disconnects from the OpenAI Realtime session and cleans up resources. Should be called when you're done with the voice instance.
 
 Returns: `void`
 
-### `getSpeakers()`
+#### `getSpeakers()`
 
 Returns a list of available voice speakers.
 
 Returns: `Promise<Array<{ voiceId: string; [key: string]: any }>>`
 
-### `on()`
+#### `on()`
 
 Registers an event listener for voice events.
 
@@ -149,7 +246,7 @@ Registers an event listener for voice events.
 
 Returns: `void`
 
-### `off()`
+#### `off()`
 
 Removes a previously registered event listener.
 
@@ -159,7 +256,7 @@ Removes a previously registered event listener.
 
 Returns: `void`
 
-## Events
+### Events
 
 The OpenAIRealtimeVoice class emits the following events:
 
@@ -169,7 +266,7 @@ The OpenAIRealtimeVoice class emits the following events:
 
 **error** (`event`): Emitted when an error occurs. Callback receives the error object.
 
-### OpenAI Realtime Events
+#### OpenAI Realtime Events
 
 You can also listen to [OpenAI Realtime utility events](https://github.com/openai/openai-realtime-api-beta#reference-client-utility-events) by prefixing with 'openAIRealtime:':
 
@@ -183,7 +280,7 @@ You can also listen to [OpenAI Realtime utility events](https://github.com/opena
 
 **openAIRealtime:conversation.item.completed** (`event`): Emitted when an item in the conversation is completed.
 
-## Available voices
+### Available voices
 
 The following voice options are available:
 
@@ -196,7 +293,7 @@ The following voice options are available:
 - `shimmer`: Bright and energetic
 - `verse`: Versatile and expressive
 
-## Notes
+### Notes
 
 - API keys can be provided via constructor options or the `OPENAI_API_KEY` environment variable
 - The OpenAI Realtime Voice API uses WebSockets for real-time communication

package/.docs/integrations.md

@@ -0,0 +1,147 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Integrations
+
+Search integrations...
+
+## Channels
+
+- [![](https://cdn.simpleicons.org/discord?viewbox=auto\&size=28)Discord](https://mastra.ai/integrations/channels/discord)
+- [![](https://cdn.simpleicons.org/github/black/white?viewbox=auto\&size=28)GitHub](https://mastra.ai/integrations/channels/github)
+- [![](https://cdn.simpleicons.org/imessage?viewbox=auto\&size=28)iMessage](https://mastra.ai/integrations/channels/imessage)
+- [![](https://svgl.app/library/microsoft-teams.svg)Microsoft Teams](https://mastra.ai/integrations/channels/teams)
+- [![](https://svgl.app/library/slack.svg)Slack](https://mastra.ai/integrations/channels/slack)
+- [![](https://cdn.simpleicons.org/telegram?viewbox=auto\&size=28)Telegram](https://mastra.ai/integrations/channels/telegram)
+- [![](https://cdn.simpleicons.org/whatsapp?viewbox=auto\&size=28)WhatsApp](https://mastra.ai/integrations/channels/whatsapp)
+
+## Frameworks
+
+- [![](https://cdn.simpleicons.org/astro?viewbox=auto\&size=28)Astro](https://mastra.ai/integrations/frameworks/astro)
+- [![](https://cdn.simpleicons.org/electron?viewbox=auto\&size=28)Electron](https://mastra.ai/integrations/frameworks/electron)
+- [![](https://cdn.simpleicons.org/express/black/white?viewbox=auto\&size=28)Express](https://mastra.ai/integrations/frameworks/express)
+- [![](https://cdn.simpleicons.org/hono?viewbox=auto\&size=28)Hono](https://mastra.ai/integrations/frameworks/hono)
+- [![](https://cdn.simpleicons.org/nestjs?viewbox=auto\&size=28)NestJS](https://mastra.ai/integrations/frameworks/nestjs)
+- [![](https://cdn.simpleicons.org/nextdotjs/black/white?viewbox=auto\&size=28)Next.js](https://mastra.ai/integrations/frameworks/next-js)
+- [![](https://cdn.simpleicons.org/nuxt?viewbox=auto\&size=28)Nuxt](https://mastra.ai/integrations/frameworks/nuxt)
+- [![](https://cdn.simpleicons.org/vite?viewbox=auto\&size=28)React + Vite](https://mastra.ai/integrations/frameworks/vite-react)
+- [![](https://cdn.simpleicons.org/svelte?viewbox=auto\&size=28)SvelteKit](https://mastra.ai/integrations/frameworks/sveltekit)
+
+## Agentic UI
+
+- [![](https://cdn.simpleicons.org/vercel/black/white?viewbox=auto\&size=28)AI SDK UI](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui)
+- [![](/img/integrations/assistant-ui.svg)Assistant UI](https://mastra.ai/integrations/agentic-ui/assistant-ui)
+- [![](/img/integrations/copilotkit.svg)CopilotKit](https://mastra.ai/integrations/agentic-ui/copilotkit)
+- [![](/img/integrations/openui.svg)OpenUI](https://mastra.ai/integrations/agentic-ui/openui)
+
+## Sandboxes
+
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)AgentCore](https://mastra.ai/integrations/sandboxes/agentcore)
+- [![](https://cdn.simpleicons.org/apple/black/white?viewbox=auto\&size=28)Apple Container](https://mastra.ai/integrations/sandboxes/apple-container)
+- [![](/img/integrations/blaxel.svg)Blaxel](https://mastra.ai/integrations/sandboxes/blaxel)
+- [![](/img/integrations/daytona.svg)Daytona](https://mastra.ai/integrations/sandboxes/daytona)
+- [![](https://cdn.simpleicons.org/docker?viewbox=auto\&size=28)Docker](https://mastra.ai/integrations/sandboxes/docker)
+- [![](/img/integrations/e2b.svg)E2B](https://mastra.ai/integrations/sandboxes/e2b)
+- [![](https://cdn.simpleicons.org/modal?viewbox=auto\&size=28)Modal](https://mastra.ai/integrations/sandboxes/modal)
+- [![](https://cdn.simpleicons.org/railway/black/white?viewbox=auto\&size=28)Railway](https://mastra.ai/integrations/sandboxes/railway)
+- [![](https://cdn.simpleicons.org/vercel/black/white?viewbox=auto\&size=28)Vercel](https://mastra.ai/integrations/sandboxes/vercel)
+
+## Observability
+
+- [![](/img/integrations/arize.svg)Arize](https://mastra.ai/integrations/observability/arize)
+- [![](/img/integrations/arthur.svg)Arthur](https://mastra.ai/integrations/observability/arthur)
+- [![](https://cdn.simpleicons.org/braintrust/black/white?viewbox=auto\&size=28)Braintrust](https://mastra.ai/integrations/observability/braintrust)
+- [![](/img/integrations/confident-ai.svg)Confident AI](https://mastra.ai/integrations/observability/confident-ai)
+- [![](https://cdn.simpleicons.org/datadog?viewbox=auto\&size=28)Datadog](https://mastra.ai/integrations/observability/datadog)
+- [![](/img/integrations/laminar.svg)Laminar](https://mastra.ai/integrations/observability/laminar)
+- [![](/img/integrations/langfuse.svg)Langfuse](https://mastra.ai/integrations/observability/langfuse)
+- [![](https://cdn.simpleicons.org/langchaincorporate/black/white?viewbox=auto\&size=28)LangSmith](https://mastra.ai/integrations/observability/langsmith)
+- [![](https://cdn.simpleicons.org/opentelemetry/black/white?viewbox=auto\&size=28)OpenTelemetry](https://mastra.ai/integrations/observability/opentelemetry)
+- [![](https://cdn.simpleicons.org/posthog/black/white?viewbox=auto\&size=28)PostHog](https://mastra.ai/integrations/observability/posthog)
+- [![](https://cdn.simpleicons.org/sentry/362d59/white?viewbox=auto\&size=28)Sentry](https://mastra.ai/integrations/observability/sentry)
+
+## Databases
+
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)Aurora DSQL](https://mastra.ai/integrations/databases/aurora-dsql)
+- [![](https://cdn.simpleicons.org/clickhouse?viewbox=auto\&size=28)ClickHouse](https://mastra.ai/integrations/databases/clickhouse)
+- [![](https://cdn.simpleicons.org/cloudflare?viewbox=auto\&size=28)Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
+- [![](https://cdn.simpleicons.org/cloudflare?viewbox=auto\&size=28)Cloudflare KV](https://mastra.ai/integrations/databases/cloudflare-kv)
+- [![](https://cdn.simpleicons.org/convex?viewbox=auto\&size=28)Convex](https://mastra.ai/integrations/databases/convex)
+- [![](https://cdn.simpleicons.org/duckdb?viewbox=auto\&size=28)DuckDB](https://mastra.ai/integrations/databases/duckdb)
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
+- [![](https://cdn.simpleicons.org/googlecloudspanner?viewbox=auto\&size=28)Google Cloud Spanner](https://mastra.ai/integrations/databases/spanner)
+- [![](/img/integrations/lancedb.svg)LanceDB](https://mastra.ai/integrations/databases/lancedb)
+- [![](/img/integrations/libsql.svg)libSQL](https://mastra.ai/integrations/databases/libsql)
+- [![](https://cdn.simpleicons.org/mongodb?viewbox=auto\&size=28)MongoDB](https://mastra.ai/integrations/databases/mongodb)
+- [![](https://svgl.app/library/microsoft.svg)MSSQL](https://mastra.ai/integrations/databases/mssql)
+- [![](https://cdn.simpleicons.org/neon?viewbox=auto\&size=28)Neon Postgres](https://mastra.ai/integrations/databases/neon)
+- [![](/img/integrations/oracle.svg)OracleDB](https://mastra.ai/integrations/databases/oracledb)
+- [![](https://cdn.simpleicons.org/postgresql?viewbox=auto\&size=28)PostgreSQL](https://mastra.ai/integrations/databases/postgresql)
+- [![](https://cdn.simpleicons.org/redis?viewbox=auto\&size=28)Redis](https://mastra.ai/integrations/databases/redis)
+- [![](https://cdn.simpleicons.org/upstash?viewbox=auto\&size=28)Upstash](https://mastra.ai/integrations/databases/upstash)
+
+## Deploy
+
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)Amazon Bedrock AgentCore](https://mastra.ai/integrations/deploy/aws-bedrock-agentcore)
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)Amazon EC2](https://mastra.ai/integrations/deploy/amazon-ec2)
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)AWS Lambda](https://mastra.ai/integrations/deploy/aws-lambda)
+- [![](https://svgl.app/library/azure.svg)Azure App Services](https://mastra.ai/integrations/deploy/azure-app-services)
+- [![](https://cdn.simpleicons.org/cloudflare?viewbox=auto\&size=28)Cloudflare](https://mastra.ai/integrations/deploy/cloudflare)
+- [![](https://cdn.simpleicons.org/digitalocean?viewbox=auto\&size=28)Digital Ocean](https://mastra.ai/integrations/deploy/digital-ocean)
+- [![](/img/integrations/inngest.svg)Inngest](https://mastra.ai/integrations/deploy/inngest)
+- [![](https://cdn.simpleicons.org/kubernetes?viewbox=auto\&size=28)Kubernetes](https://mastra.ai/integrations/deploy/kubernetes)
+- [![](https://cdn.simpleicons.org/netlify?viewbox=auto\&size=28)Netlify](https://mastra.ai/integrations/deploy/netlify)
+- [![](https://cdn.simpleicons.org/temporal/black/white?viewbox=auto\&size=28)Temporal](https://mastra.ai/integrations/deploy/temporal)
+- [![](https://cdn.simpleicons.org/vercel/black/white?viewbox=auto\&size=28)Vercel](https://mastra.ai/integrations/deploy/vercel)
+
+## Tools
+
+- [![](/img/integrations/bright-data.svg)Bright Data](https://mastra.ai/integrations/tools/brightdata)
+- [![](/img/integrations/firecrawl.svg)Firecrawl](https://mastra.ai/integrations/tools/firecrawl)
+- [![](https://cdn.simpleicons.org/perplexity?viewbox=auto\&size=28)Perplexity](https://mastra.ai/integrations/tools/perplexity)
+- [![](/img/integrations/tavily.svg)Tavily](https://mastra.ai/integrations/tools/tavily)
+
+## Voice
+
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)AWS Nova Sonic](https://mastra.ai/integrations/voice/aws-nova-sonic)
+- [![](https://svgl.app/library/azure.svg)Azure](https://mastra.ai/integrations/voice/azure)
+- [![](https://cdn.simpleicons.org/cloudflare?viewbox=auto\&size=28)Cloudflare](https://mastra.ai/integrations/voice/cloudflare)
+- [![](https://cdn.simpleicons.org/deepgram?viewbox=auto\&size=28)Deepgram](https://mastra.ai/integrations/voice/deepgram)
+- [![](https://cdn.simpleicons.org/elevenlabs/black/white?viewbox=auto\&size=28)ElevenLabs](https://mastra.ai/integrations/voice/elevenlabs)
+- [![](https://svgl.app/library/google.svg)Google](https://mastra.ai/integrations/voice/google)
+- [![](/img/integrations/inworld.svg)Inworld](https://mastra.ai/integrations/voice/inworld)
+- [![](https://cdn.simpleicons.org/livekit/black/white?viewbox=auto\&size=28)LiveKit](https://mastra.ai/integrations/voice/livekit)
+- [![](https://cdn.simpleicons.org/mistralai?viewbox=auto\&size=28)Mistral](https://mastra.ai/integrations/voice/mistral)
+- [![](/img/integrations/murf.svg)Murf](https://mastra.ai/integrations/voice/murf)
+- [![](https://svgl.app/library/openai.svg)OpenAI](https://mastra.ai/integrations/voice/openai)
+- [![](/img/integrations/sarvam.svg)Sarvam](https://mastra.ai/integrations/voice/sarvam)
+- [![](/img/integrations/speechify.svg)Speechify](https://mastra.ai/integrations/voice/speechify)
+- [![](https://svgl.app/library/xai_light.svg)![](https://svgl.app/library/xai_dark.svg)xAI](https://mastra.ai/integrations/voice/xai)
+
+## Auth
+
+- [![](https://cdn.simpleicons.org/auth0?viewbox=auto\&size=28)Auth0](https://mastra.ai/integrations/auth/auth0)
+- [![](https://cdn.simpleicons.org/betterauth/black/white?viewbox=auto\&size=28)Better Auth](https://mastra.ai/integrations/auth/better-auth)
+- [![](https://cdn.simpleicons.org/clerk?viewbox=auto\&size=28)Clerk](https://mastra.ai/integrations/auth/clerk)
+- [![](https://cdn.simpleicons.org/firebase?viewbox=auto\&size=28)Firebase](https://mastra.ai/integrations/auth/firebase)
+- [![](https://svgl.app/library/google.svg)Google](https://mastra.ai/integrations/auth/google)
+- [![](https://cdn.simpleicons.org/okta?viewbox=auto\&size=28)Okta](https://mastra.ai/integrations/auth/okta)
+- [![](https://cdn.simpleicons.org/supabase?viewbox=auto\&size=28)Supabase](https://mastra.ai/integrations/auth/supabase)
+- [![](https://svgl.app/library/workos.svg)WorkOS](https://mastra.ai/integrations/auth/workos)
+
+## Browsers
+
+- [![](https://cdn.simpleicons.org/vercel/black/white?viewbox=auto\&size=28)AgentBrowser](https://mastra.ai/integrations/browsers/agent-browser)
+- [![](/img/integrations/mastra.svg)BrowserViewer](https://mastra.ai/integrations/browsers/browser-viewer)
+- [![](/img/integrations/firecrawl.svg)Firecrawl](https://mastra.ai/integrations/browsers/firecrawl)
+- [![](/img/integrations/stagehand.svg)Stagehand](https://mastra.ai/integrations/browsers/stagehand)
+
+## File storage
+
+- [![](https://cdn.simpleicons.org/turso?viewbox=auto\&size=28)AgentFS](https://mastra.ai/integrations/file-storage/agentfs)
+- [![](https://svgl.app/library/aws_light.svg)![](https://svgl.app/library/aws_dark.svg)Amazon S3](https://mastra.ai/integrations/file-storage/amazon-s3)
+- [![](/img/integrations/archil.svg)Archil](https://mastra.ai/integrations/file-storage/archil)
+- [![](https://svgl.app/library/azure.svg)Azure Blob](https://mastra.ai/integrations/file-storage/azure-blob)
+- [![](https://svgl.app/library/google-cloud.svg)Google Cloud Storage](https://mastra.ai/integrations/file-storage/google-cloud-storage)
+- [![](https://svgl.app/library/drive.svg)Google Drive](https://mastra.ai/integrations/file-storage/google-drive)
+- [![](/img/integrations/mesa.svg)Mesa](https://mastra.ai/integrations/file-storage/mesa)
+- [![](https://cdn.simpleicons.org/vercel/black/white?viewbox=auto\&size=28)Vercel Files](https://mastra.ai/integrations/file-storage/vercel-files)

package/.docs/models/embeddings.md

@@ -277,5 +277,5 @@ try {
 ## Next Steps
 
 - [Memory & Semantic Recall](https://mastra.ai/docs/memory/semantic-recall): Use embeddings for agent memory
-- [RAG & Chunking](https://mastra.ai/guides/rag/chunking-and-embedding): Build retrieval-augmented generation systems
-- [Vector Databases](https://mastra.ai/guides/rag/vector-databases): Store and query embeddings
+- [RAG & Chunking](https://mastra.ai/reference/rag/chunking-and-embedding): Build retrieval-augmented generation systems
+- [Vector Databases](https://mastra.ai/reference/rag/vector-databases): Store and query embeddings

package/.docs/models/gateways/openrouter.md

@@ -2,7 +2,7 @@
 
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 339 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 342 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -209,6 +209,7 @@ ANTHROPIC_API_KEY=ant-...
 | `nvidia/nemotron-3-ultra-550b-a55b`                        |
 | `nvidia/nemotron-3-ultra-550b-a55b:free`                   |
 | `nvidia/nemotron-3.5-content-safety:free`                  |
+| `nvidia/nemotron-3.5-lightning:free`                       |
 | `nvidia/nemotron-nano-12b-v2-vl:free`                      |
 | `nvidia/nemotron-nano-9b-v2:free`                          |
 | `openai/gpt-3.5-turbo`                                     |
@@ -339,6 +340,7 @@ ANTHROPIC_API_KEY=ant-...
 | `relace/relace-apply-3`                                    |
 | `relace/relace-search`                                     |
 | `sakana/fugu-ultra`                                        |
+| `sakana/sakana-namazu`                                     |
 | `sao10k/l3-lunaris-8b`                                     |
 | `sao10k/l3.1-euryale-70b`                                  |
 | `sao10k/l3.3-euryale-70b`                                  |
@@ -355,6 +357,7 @@ ANTHROPIC_API_KEY=ant-...
 | `thinkingmachines/inkling-small`                           |
 | `undi95/remm-slerp-l2-13b`                                 |
 | `upstage/solar-pro-3`                                      |
+| `upstage/solar-pro4`                                       |
 | `writer/palmyra-x5`                                        |
 | `x-ai/grok-4.20`                                           |
 | `x-ai/grok-4.20-multi-agent`                               |

package/.docs/models/gateways/vercel.md

@@ -2,7 +2,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 322 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 325 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -187,6 +187,7 @@ ANTHROPIC_API_KEY=ant-...
 | `meta/llama-3.3-70b`                     |
 | `meta/llama-4-maverick`                  |
 | `meta/llama-4-scout`                     |
+| `meta/muse-glimmer-30b`                  |
 | `meta/muse-spark-1.1`                    |
 | `meta/muse-spark-1.2`                    |
 | `meta/muse-spark-1.2-contributor`        |
@@ -304,6 +305,7 @@ ANTHROPIC_API_KEY=ant-...
 | `recraft/recraft-v4.1-utility`           |
 | `recraft/recraft-v4.1-utility-pro`       |
 | `sakana/fugu-ultra`                      |
+| `sakana/namazu`                          |
 | `stepfun/step-3.5-flash`                 |
 | `stepfun/step-3.7-flash`                 |
 | `tencent/hy3`                            |
@@ -333,6 +335,7 @@ ANTHROPIC_API_KEY=ant-...
 | `xai/grok-4.5`                           |
 | `xai/grok-build-0.1`                     |
 | `xai/grok-imagine-image`                 |
+| `xai/grok-imagine-image-2.0`             |
 | `xai/grok-imagine-image-2.0-preview`     |
 | `xai/grok-imagine-video`                 |
 | `xai/grok-imagine-video-1.5`             |

package/.docs/models/index.md

@@ -2,7 +2,7 @@
 
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5460 models from 169 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5476 models from 169 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/ambient.md

@@ -40,7 +40,7 @@ for await (const chunk of stream) {
 | `ambient/deepseek/deepseek-v4-flash`      | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `ambient/deepseek/deepseek-v4-flash-0731` | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `ambient/moonshotai/kimi-k2.6`            | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `ambient/moonshotai/kimi-k2.7-code`       | 262K    |       |           |       |       |       | $0.70      | $4          |
+| `ambient/moonshotai/kimi-k2.7-code`       | 262K    |       |           |       |       |       | $0.69      | $3          |
 | `ambient/stepfun/step-3.7-flash`          | 262K    |       |           |       |       |       | $0.19      | $1          |
 | `ambient/xiaomi/mimo-v2.5`                | 1.0M    |       |           |       |       |       | $0.40      | $2          |
 | `ambient/z-ai/glm-5.2`                    | 203K    |       |           |       |       |       | $1         | $4          |

package/.docs/models/providers/cortecs.md

@@ -2,7 +2,7 @@
 
 # ![Cortecs logo](https://models.dev/logos/cortecs.svg)Cortecs
 
-Access 105 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
+Access 104 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
 
 Learn more in the [Cortecs documentation](https://cortecs.ai).
 
@@ -51,7 +51,7 @@ for await (const chunk of stream) {
 | `cortecs/cosmos3-super-reasoner`              | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 | `cortecs/deepseek-r1-0528`                    | 164K    |       |           |       |       |       | $0.65      | $3          |
 | `cortecs/deepseek-v3.2`                       | 164K    |       |           |       |       |       | $0.30      | $0.49       |
-| `cortecs/deepseek-v4-flash-0731`              | 1.0M    |       |           |       |       |       | $0.25      | $0.30       |
+| `cortecs/deepseek-v4-flash-0731`              | 1.0M    |       |           |       |       |       | $0.13      | $0.28       |
 | `cortecs/deepseek-v4-pro`                     | 1.0M    |       |           |       |       |       | $2         | $3          |
 | `cortecs/devstral-2512`                       | 262K    |       |           |       |       |       | $0.45      | $2          |
 | `cortecs/gemini-2.5-flash`                    | 1.0M    |       |           |       |       |       | $0.30      | $2          |
@@ -87,7 +87,6 @@ for await (const chunk of stream) {
 | `cortecs/gpt-oss-safeguard-120b`              | 128K    |       |           |       |       |       | $0.18      | $0.70       |
 | `cortecs/hermes-4-405b`                       | 128K    |       |           |       |       |       | $1.00      | $3          |
 | `cortecs/hermes-4-70b`                        | 128K    |       |           |       |       |       | $0.13      | $0.40       |
-| `cortecs/holo2-30b-a3b`                       | 22K     |       |           |       |       |       | $0.33      | $0.78       |
 | `cortecs/kimi-k2.5`                           | 262K    |       |           |       |       |       | $0.49      | $3          |
 | `cortecs/kimi-k2.6`                           | 262K    |       |           |       |       |       | $0.77      | $3          |
 | `cortecs/kimi-k2.7-code`                      | 262K    |       |           |       |       |       | $0.75      | $4          |

package/.docs/models/providers/hetzner.md

@@ -2,7 +2,7 @@
 
 # ![Hetzner logo](https://models.dev/logos/hetzner.svg)Hetzner
 
-Access 1 Hetzner model through Mastra's model router. Authentication is handled automatically using the `HETZNER_API_KEY` environment variable.
+Access 4 Hetzner models through Mastra's model router. Authentication is handled automatically using the `HETZNER_API_KEY` environment variable.
 
 Learn more in the [Hetzner documentation](https://experiments.hetzner.com).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "hetzner/Qwen/Qwen3.6-35B-A3B-FP8"
+  model: "hetzner/DeepSeek-V4-Flash-0731"
 });
 
 // Generate a response
@@ -36,6 +36,9 @@ for await (const chunk of stream) {
 
 | Model                              | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `hetzner/DeepSeek-V4-Flash-0731`   | 512K    |       |           |       |       |       | —          | —           |
+| `hetzner/GLM-5.2-NVFP4`            | 512K    |       |           |       |       |       | —          | —           |
+| `hetzner/Kimi-K2.7-Code`           | 262K    |       |           |       |       |       | —          | —           |
 | `hetzner/Qwen/Qwen3.6-35B-A3B-FP8` | 262K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
@@ -48,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://inference.hetzner.com/api/v1",
-    id: "hetzner/Qwen/Qwen3.6-35B-A3B-FP8",
+    id: "hetzner/DeepSeek-V4-Flash-0731",
     apiKey: process.env.HETZNER_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -67,7 +70,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "hetzner/Qwen/Qwen3.6-35B-A3B-FP8"
-      : "hetzner/Qwen/Qwen3.6-35B-A3B-FP8";
+      : "hetzner/DeepSeek-V4-Flash-0731";
   }
 });
 ```

package/.docs/models/providers/kilo.md

@@ -2,7 +2,7 @@
 
 # ![Kilo Gateway logo](https://models.dev/logos/kilo.svg)Kilo Gateway
 
-Access 346 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
+Access 350 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
 
 Learn more in the [Kilo Gateway documentation](https://kilo.ai).
 
@@ -157,9 +157,10 @@ for await (const chunk of stream) {
 | `kilo/meta-llama/llama-3.2-1b-instruct`                         | 60K     |       |           |       |       |       | $0.03      | $0.20       |
 | `kilo/meta-llama/llama-3.2-3b-instruct`                         | 131K    |       |           |       |       |       | $0.05      | $0.33       |
 | `kilo/meta-llama/llama-3.3-70b-instruct`                        | 131K    |       |           |       |       |       | $0.10      | $0.32       |
-| `kilo/meta-llama/llama-4-maverick`                              | 1.0M    |       |           |       |       |       | $0.20      | $0.70       |
+| `kilo/meta-llama/llama-4-maverick`                              | 128K    |       |           |       |       |       | $0.20      | $0.70       |
 | `kilo/meta-llama/llama-4-scout`                                 | 328K    |       |           |       |       |       | $0.10      | $0.30       |
 | `kilo/meta-llama/llama-guard-4-12b`                             | 164K    |       |           |       |       |       | $0.18      | $0.18       |
+| `kilo/meta/muse-glimmer-30b`                                    | 131K    |       |           |       |       |       | $0.35      | $2          |
 | `kilo/meta/muse-spark-1.1`                                      | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `kilo/meta/muse-spark-1.2`                                      | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `kilo/microsoft/phi-4`                                          | 16K     |       |           |       |       |       | $0.07      | $0.14       |
@@ -212,6 +213,7 @@ for await (const chunk of stream) {
 | `kilo/nvidia/nemotron-3-ultra-550b-a55b`                        | 512K    |       |           |       |       |       | $0.50      | $2          |
 | `kilo/nvidia/nemotron-3-ultra-550b-a55b:free`                   | 1.0M    |       |           |       |       |       | —          | —           |
 | `kilo/nvidia/nemotron-3.5-content-safety:free`                  | 128K    |       |           |       |       |       | —          | —           |
+| `kilo/nvidia/nemotron-3.5-lightning:free`                       | 1.0M    |       |           |       |       |       | —          | —           |
 | `kilo/openai/gpt-3.5-turbo`                                     | 16K     |       |           |       |       |       | $0.50      | $2          |
 | `kilo/openai/gpt-3.5-turbo-0613`                                | 4K      |       |           |       |       |       | $1         | $2          |
 | `kilo/openai/gpt-3.5-turbo-16k`                                 | 16K     |       |           |       |       |       | $3         | $4          |
@@ -308,7 +310,7 @@ for await (const chunk of stream) {
 | `kilo/qwen/qwen3-max`                                           | 262K    |       |           |       |       |       | $0.78      | $4          |
 | `kilo/qwen/qwen3-max-thinking`                                  | 262K    |       |           |       |       |       | $0.78      | $4          |
 | `kilo/qwen/qwen3-next-80b-a3b-instruct`                         | 262K    |       |           |       |       |       | $0.10      | $0.78       |
-| `kilo/qwen/qwen3-next-80b-a3b-thinking`                         | 131K    |       |           |       |       |       | $0.15      | $1          |
+| `kilo/qwen/qwen3-next-80b-a3b-thinking`                         | 262K    |       |           |       |       |       | $0.15      | $1          |
 | `kilo/qwen/qwen3-vl-235b-a22b-instruct`                         | 131K    |       |           |       |       |       | $0.26      | $1          |
 | `kilo/qwen/qwen3-vl-235b-a22b-thinking`                         | 131K    |       |           |       |       |       | $0.40      | $4          |
 | `kilo/qwen/qwen3-vl-30b-a3b-instruct`                           | 262K    |       |           |       |       |       | $0.13      | $0.52       |
@@ -338,6 +340,7 @@ for await (const chunk of stream) {
 | `kilo/relace/relace-apply-3`                                    | 256K    |       |           |       |       |       | $0.85      | $1          |
 | `kilo/relace/relace-search`                                     | 256K    |       |           |       |       |       | $1         | $3          |
 | `kilo/sakana/fugu-ultra`                                        | 1.0M    |       |           |       |       |       | $5         | $30         |
+| `kilo/sakana/sakana-namazu`                                     | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `kilo/sao10k/l3-lunaris-8b`                                     | 8K      |       |           |       |       |       | $0.04      | $0.05       |
 | `kilo/sao10k/l3.1-euryale-70b`                                  | 131K    |       |           |       |       |       | $0.85      | $0.85       |
 | `kilo/sao10k/l3.3-euryale-70b`                                  | 131K    |       |           |       |       |       | $0.65      | $0.75       |
@@ -362,6 +365,7 @@ for await (const chunk of stream) {
 | `kilo/thinkingmachines/inkling-small`                           | 524K    |       |           |       |       |       | $0.45      | $1          |
 | `kilo/undi95/remm-slerp-l2-13b`                                 | 6K      |       |           |       |       |       | $0.45      | $0.65       |
 | `kilo/upstage/solar-pro-3`                                      | 131K    |       |           |       |       |       | $0.15      | $0.60       |
+| `kilo/upstage/solar-pro4`                                       | 524K    |       |           |       |       |       | $0.30      | $1          |
 | `kilo/writer/palmyra-x5`                                        | 1.0M    |       |           |       |       |       | $0.60      | $6          |
 | `kilo/x-ai/grok-4.20`                                           | 2.0M    |       |           |       |       |       | $1         | $3          |
 | `kilo/x-ai/grok-4.20-multi-agent`                               | 2.0M    |       |           |       |       |       | $1         | $3          |