@mastra/mcp-docs-server 1.2.5-alpha.1 → 1.2.5-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/mcp-docs-server
 
+## 1.2.5-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`3ffb8b7`](https://github.com/mastra-ai/mastra/commit/3ffb8b720e90f5e6977129ec1f6707d43c2bebe0), [`5ea76a7`](https://github.com/mastra-ai/mastra/commit/5ea76a723d966c72da9aa3ab30ae20276e049765), [`6445560`](https://github.com/mastra-ai/mastra/commit/6445560327045d20b239585fc63fed72e9ce36ec), [`911281c`](https://github.com/mastra-ai/mastra/commit/911281c57893ba2630428bf88d0cd0c5101ce76f), [`a2ba369`](https://github.com/mastra-ai/mastra/commit/a2ba369e796dfab610f41c6875965b488272fa55), [`ae51e81`](https://github.com/mastra-ai/mastra/commit/ae51e818825582d42500338dfc1929a082eff0ba), [`6f304ef`](https://github.com/mastra-ai/mastra/commit/6f304ef319e99725e884bdb8d3193c001b6e5964)]:
+  - @mastra/core@1.50.0-alpha.1
+  - @mastra/mcp@1.13.1-alpha.0
+
 ## 1.2.5-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.5-alpha.1",
+  "version": "1.2.5-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.50.0-alpha.0",
-    "@mastra/mcp": "^1.13.0"
+    "@mastra/core": "1.50.0-alpha.1",
+    "@mastra/mcp": "^1.13.1-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -46,8 +46,8 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.8",
     "@internal/types-builder": "0.0.86",
-    "@mastra/core": "1.50.0-alpha.0",
-    "@internal/lint": "0.0.111"
+    "@internal/lint": "0.0.111",
+    "@mastra/core": "1.50.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/docs/agents/adding-voice.md

@@ -1,383 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Voice
-
-Mastra agents can be enhanced with voice capabilities, allowing them to speak responses and listen to user input. You can configure an agent to use either a single voice provider or combine multiple providers for different operations.
-
-## Basic usage
-
-The simplest way to add voice to an agent is to use a single provider for both speaking and listening:
-
-```typescript
-import { createReadStream } from 'fs'
-import path from 'path'
-import { Agent } from '@mastra/core/agent'
-import { OpenAIVoice } from '@mastra/voice-openai'
-
-// Initialize the voice provider with default settings
-const voice = new OpenAIVoice()
-
-// Create an agent with voice capabilities
-export const agent = new Agent({
-  id: 'voice-agent',
-  name: 'Voice Agent',
-  instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.5',
-  voice,
-})
-
-// The agent can now use voice for interaction
-const audioStream = await agent.voice.speak("Hello, I'm your AI assistant!", {
-  filetype: 'm4a',
-})
-
-playAudio(audioStream!)
-
-try {
-  const transcription = await agent.voice.listen(audioStream)
-  console.log(transcription)
-} catch (error) {
-  console.error('Error transcribing audio:', error)
-}
-```
-
-## Working with audio streams
-
-The `speak()` and `listen()` methods work with Node.js streams. Here's how to save and load audio files:
-
-### Saving Speech Output
-
-The `speak` method returns a stream that you can pipe to a file or speaker.
-
-```typescript
-import { createWriteStream } from 'fs'
-import path from 'path'
-
-// Generate speech and save to file
-const audio = await agent.voice.speak('Hello, World!')
-const filePath = path.join(process.cwd(), 'agent.mp3')
-const writer = createWriteStream(filePath)
-
-audio.pipe(writer)
-
-await new Promise<void>((resolve, reject) => {
-  writer.on('finish', () => resolve())
-  writer.on('error', reject)
-})
-```
-
-### Transcribing Audio Input
-
-The `listen` method expects a stream of audio data from a microphone or file.
-
-```typescript
-import { createReadStream } from 'fs'
-import path from 'path'
-
-// Read audio file and transcribe
-const audioFilePath = path.join(process.cwd(), '/agent.m4a')
-const audioStream = createReadStream(audioFilePath)
-
-try {
-  console.log('Transcribing audio file...')
-  const transcription = await agent.voice.listen(audioStream, {
-    filetype: 'm4a',
-  })
-  console.log('Transcription:', transcription)
-} catch (error) {
-  console.error('Error transcribing audio:', error)
-}
-```
-
-## Speech-to-speech voice interactions
-
-For more dynamic and interactive voice experiences, you can use real-time voice providers that support speech-to-speech capabilities:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { getMicrophoneStream } from '@mastra/node-audio'
-import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
-import { search, calculate } from '../tools'
-
-// Initialize the realtime voice provider
-const voice = new OpenAIRealtimeVoice({
-  apiKey: process.env.OPENAI_API_KEY,
-  model: 'gpt-5.1-realtime',
-  speaker: 'alloy',
-})
-
-// Create an agent with speech-to-speech voice capabilities
-export const agent = new Agent({
-  id: 'speech-to-speech-agent',
-  name: 'Speech-to-Speech Agent',
-  instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
-  model: 'openai/gpt-5.5',
-  tools: {
-    // Tools configured on Agent are passed to voice provider
-    search,
-    calculate,
-  },
-  voice,
-})
-
-// Establish a WebSocket connection
-await agent.voice.connect()
-
-// Start a conversation
-agent.voice.speak("Hello, I'm your AI assistant!")
-
-// Stream audio from a microphone
-const microphoneStream = getMicrophoneStream()
-agent.voice.send(microphoneStream)
-
-// When done with the conversation
-agent.voice.close()
-```
-
-### Per-session voice for concurrent sessions
-
-A static `voice` instance is shared across every request. For one-shot text-to-speech this is fine, but realtime and speech-to-speech providers store one WebSocket, one set of tools, and one request context per instance. If you deploy a single agent that handles several live sessions at once, a shared instance lets one session overwrite another session's tools, instructions, and request context.
-
-To give each session its own voice, provide `voice` as a resolver. Mastra runs the resolver on every `getVoice()` call and returns a fresh, session-owned instance:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
-
-export const agent = new Agent({
-  id: 'support-line',
-  name: 'Support Line',
-  instructions: ({ requestContext }) => `Help user ${requestContext.get('user')}.`,
-  model: 'openai/gpt-5.5',
-  voice: ({ requestContext }) => new OpenAIRealtimeVoice({ apiKey: requestContext.get('apiKey') }),
-})
-
-// Each concurrent session resolves its own voice instance
-const voice = await agent.getVoice({ requestContext })
-await voice.connect()
-```
-
-When you use a resolver:
-
-- Each call to `getVoice()` returns a new instance, so concurrent sessions never share state.
-- Mastra doesn't add tools or instructions to a resolver instance. Configure those inside the resolver or on the provider.
-- You own the lifecycle of the returned instance, so call `disconnect()` or `close()` when the session ends.
-
-The `agent.voice` getter has no request context, so it throws when `voice` is a resolver. Use `agent.getVoice({ requestContext })` instead.
-
-### Event System
-
-The realtime voice provider emits several events you can listen for:
-
-```typescript
-// Listen for speech audio data sent from voice provider
-agent.voice.on('speaking', ({ audio }) => {
-  // audio contains ReadableStream or Int16Array audio data
-})
-
-// Listen for transcribed text sent from both voice provider and user
-agent.voice.on('writing', ({ text, role }) => {
-  console.log(`${role} said: ${text}`)
-})
-
-// Listen for errors
-agent.voice.on('error', error => {
-  console.error('Voice error:', error)
-})
-```
-
-## Examples
-
-### End-to-end voice interaction
-
-This example demonstrates a voice interaction between two agents. The hybrid voice agent, which uses multiple providers, speaks a question, which is saved as an audio file. The unified voice agent listens to that file, processes the question, generates a response, and speaks it back. Both audio outputs are saved to the `audio` directory.
-
-The following files are created:
-
-- **hybrid-question.mp3** – Hybrid agent's spoken question.
-- **unified-response.mp3** – Unified agent's spoken response.
-
-```typescript
-import 'dotenv/config'
-
-import path from 'path'
-import { createReadStream } from 'fs'
-import { Agent } from '@mastra/core/agent'
-import { CompositeVoice } from '@mastra/core/voice'
-import { OpenAIVoice } from '@mastra/voice-openai'
-import { Mastra } from '@mastra/core'
-
-// Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
-export const saveAudioToFile = async (
-  audio: NodeJS.ReadableStream,
-  filename: string,
-): Promise<void> => {
-  const audioDir = path.join(process.cwd(), 'audio')
-  const filePath = path.join(audioDir, filename)
-
-  await fs.promises.mkdir(audioDir, { recursive: true })
-
-  const writer = createWriteStream(filePath)
-  audio.pipe(writer)
-  return new Promise((resolve, reject) => {
-    writer.on('finish', resolve)
-    writer.on('error', reject)
-  })
-}
-
-// Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
-export const convertToText = async (input: string | NodeJS.ReadableStream): Promise<string> => {
-  if (typeof input === 'string') {
-    return input
-  }
-
-  const chunks: Buffer[] = []
-  return new Promise((resolve, reject) => {
-    inputData.on('data', chunk => chunks.push(Buffer.from(chunk)))
-    inputData.on('error', reject)
-    inputData.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')))
-  })
-}
-
-export const hybridVoiceAgent = new Agent({
-  id: 'hybrid-voice-agent',
-  name: 'Hybrid Voice Agent',
-  model: 'openai/gpt-5.5',
-  instructions: 'You can speak and listen using different providers.',
-  voice: new CompositeVoice({
-    input: new OpenAIVoice(),
-    output: new OpenAIVoice(),
-  }),
-})
-
-export const unifiedVoiceAgent = new Agent({
-  id: 'unified-voice-agent',
-  name: 'Unified Voice Agent',
-  instructions: 'You are an agent with both STT and TTS capabilities.',
-  model: 'openai/gpt-5.5',
-  voice: new OpenAIVoice(),
-})
-
-export const mastra = new Mastra({
-  agents: { hybridVoiceAgent, unifiedVoiceAgent },
-})
-
-const hybridVoiceAgent = mastra.getAgent('hybridVoiceAgent')
-const unifiedVoiceAgent = mastra.getAgent('unifiedVoiceAgent')
-
-const question = 'What is the meaning of life in one sentence?'
-
-const hybridSpoken = await hybridVoiceAgent.voice.speak(question)
-
-await saveAudioToFile(hybridSpoken!, 'hybrid-question.mp3')
-
-const audioStream = createReadStream(path.join(process.cwd(), 'audio', 'hybrid-question.mp3'))
-const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream)
-
-const inputText = await convertToText(unifiedHeard!)
-
-const unifiedResponse = await unifiedVoiceAgent.generate(inputText)
-const unifiedSpoken = await unifiedVoiceAgent.voice.speak(unifiedResponse.text)
-
-await saveAudioToFile(unifiedSpoken!, 'unified-response.mp3')
-```
-
-### Using Multiple Providers
-
-For more flexibility, you can use different providers for speaking and listening using the CompositeVoice class:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { CompositeVoice } from '@mastra/core/voice'
-import { OpenAIVoice } from '@mastra/voice-openai'
-import { PlayAIVoice } from '@mastra/voice-playai'
-
-export const agent = new Agent({
-  id: 'voice-agent',
-  name: 'Voice Agent',
-  instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.5',
-
-  // Create a composite voice using OpenAI for listening and PlayAI for speaking
-  voice: new CompositeVoice({
-    input: new OpenAIVoice(),
-    output: new PlayAIVoice(),
-  }),
-})
-```
-
-### Using AI SDK
-
-Mastra supports using AI SDK's transcription and speech models directly in `CompositeVoice`, giving you access to a wide range of providers through the AI SDK ecosystem:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { CompositeVoice } from '@mastra/core/voice'
-import { openai } from '@ai-sdk/openai'
-import { elevenlabs } from '@ai-sdk/elevenlabs'
-import { groq } from '@ai-sdk/groq'
-
-export const agent = new Agent({
-  id: 'aisdk-voice-agent',
-  name: 'AI SDK Voice Agent',
-  instructions: `You are a helpful assistant with voice capabilities.`,
-  model: 'openai/gpt-5.5',
-
-  // Pass AI SDK models directly to CompositeVoice
-  voice: new CompositeVoice({
-    input: openai.transcription('whisper-1'), // AI SDK transcription model
-    output: elevenlabs.speech('eleven_turbo_v2'), // AI SDK speech model
-  }),
-})
-
-// Use voice capabilities as usual
-const audioStream = await agent.voice.speak('Hello!')
-const transcribedText = await agent.voice.listen(audioStream)
-```
-
-#### Mix and Match Providers
-
-You can mix AI SDK models with Mastra voice providers:
-
-```typescript
-import { CompositeVoice } from '@mastra/core/voice'
-import { PlayAIVoice } from '@mastra/voice-playai'
-import { openai } from '@ai-sdk/openai'
-
-// Use AI SDK for transcription and Mastra provider for speech
-const voice = new CompositeVoice({
-  input: openai.transcription('whisper-1'), // AI SDK
-  output: new PlayAIVoice(), // Mastra provider
-})
-```
-
-For the complete list of supported AI SDK providers and their capabilities:
-
-- [Transcription](https://ai-sdk.dev/docs/providers/openai/transcription)
-- [Speech](https://ai-sdk.dev/docs/providers/elevenlabs/speech)
-
-## Supported voice providers
-
-Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-text (STT) capabilities:
-
-| Provider        | Package                         | Features                                  | Reference                                                          |
-| --------------- | ------------------------------- | ----------------------------------------- | ------------------------------------------------------------------ |
-| OpenAI          | `@mastra/voice-openai`          | TTS, STT                                  | [Documentation](https://mastra.ai/reference/voice/openai)          |
-| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech                 | [Documentation](https://mastra.ai/reference/voice/openai-realtime) |
-| AWS Nova Sonic  | `@mastra/voice-aws-nova-sonic`  | Realtime speech-to-speech via AWS Bedrock | [Documentation](https://mastra.ai/reference/voice/aws-nova-sonic)  |
-| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS                          | [Documentation](https://mastra.ai/reference/voice/elevenlabs)      |
-| PlayAI          | `@mastra/voice-playai`          | TTS                                       | [Documentation](https://mastra.ai/reference/voice/playai)          |
-| Google          | `@mastra/voice-google`          | TTS, STT                                  | [Documentation](https://mastra.ai/reference/voice/google)          |
-| Deepgram        | `@mastra/voice-deepgram`        | STT                                       | [Documentation](https://mastra.ai/reference/voice/deepgram)        |
-| Murf            | `@mastra/voice-murf`            | TTS                                       | [Documentation](https://mastra.ai/reference/voice/murf)            |
-| Speechify       | `@mastra/voice-speechify`       | TTS                                       | [Documentation](https://mastra.ai/reference/voice/speechify)       |
-| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                                  | [Documentation](https://mastra.ai/reference/voice/sarvam)          |
-| Azure           | `@mastra/voice-azure`           | TTS, STT                                  | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
-| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                                       | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
-
-## Next steps
-
-- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice): Detailed API documentation for voice capabilities
-- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech): Interactive story generator and other TTS implementations
-- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text): Voice memo app and other STT implementations
-- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech): Real-time voice conversation with call analysis

package/.docs/docs/community/contributing-templates.md

@@ -1,5 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Contributing templates
-
-The Mastra community plays a vital role in creating templates that showcase innovative application patterns. We're currently reworking our template contribution process to ensure high-quality, valuable templates for the community. For the time being, we're not accepting new template contributions. Please keep an eye on this page for updates on when contributions will reopen and the new submission process.

package/.docs/docs/community/discord.md

@@ -1,11 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Discord community
-
-The Discord server has over 1000 members and serves as the main discussion forum for Mastra. The Mastra team monitors Discord during North American and European business hours, with community members active across other time zones.
-
-[Join the Discord server](https://discord.gg/BTYqqHKUrf)
-
-## Discord MCP bot
-
-In addition to community members, we've an (experimental!) Discord bot that can also help answer questions. It uses [Model Context Protocol (MCP)](https://mastra.ai/docs/mcp/overview). You can ask it a question with `/ask` (either in public channels or DMs) and clear history (in DMs only) with `/cleardm`.