@mastra/voice-inworld 0.0.0 → 0.2.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @mastra/voice-inworld
+
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Added Inworld AI voice integration with streaming TTS and batch STT. Supports inworld-tts-2 (default), inworld-tts-1.5-max, and inworld-tts-1.5-mini models for text-to-speech, with groq/whisper-large-v3 for speech-to-text. Includes 22+ built-in voices, configurable audio encoding, per-call `deliveryMode` and `language` overrides (deliveryMode honored only by inworld-tts-2), and progressive NDJSON audio streaming with backpressure handling. ([#14945](https://github.com/mastra-ai/mastra/pull/14945))
+
+### Patch Changes
+
+- Updated dependencies [[`37c0dc5`](https://github.com/mastra-ai/mastra/commit/37c0dc5697d343db98628bf867bf71ce6deec6d7), [`ef6b584`](https://github.com/mastra-ai/mastra/commit/ef6b5847ac33c0a7e80af3a86e8801e2933dd3ee), [`4dd900d`](https://github.com/mastra-ai/mastra/commit/4dd900d75dfe9be89f8c15188b368a8622aa1e18), [`4ff5bdf`](https://github.com/mastra-ai/mastra/commit/4ff5bdfe170cba6dfb5260c6af0f4ba668430772), [`bbcd93c`](https://github.com/mastra-ai/mastra/commit/bbcd93cf7d8aa1007d6d84bfd033b8015c912087), [`308bd07`](https://github.com/mastra-ai/mastra/commit/308bd074f35cef0c75d82fc1eb19382fe04ecf6f)]:
+  - @mastra/core@1.33.0-alpha.11

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/docs/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: mastra-voice-inworld
+description: Documentation for @mastra/voice-inworld. Use when working with @mastra/voice-inworld APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/voice-inworld"
+  version: "0.2.0-alpha.0"
+---
+
+## When to use
+
+Use this skill whenever you are working with @mastra/voice-inworld to obtain the domain-specific knowledge.
+
+## How to use
+
+Read the individual reference documents for detailed explanations and code examples.
+
+### Docs
+
+- [Voice in Mastra](references/docs-voice-overview.md) - Overview of voice capabilities in Mastra, including text-to-speech, speech-to-text, and real-time speech-to-speech interactions.
+
+### Reference
+
+- [Reference: Inworld](references/reference-voice-inworld.md) - Documentation for the InworldVoice class, providing streaming text-to-speech and batch speech-to-text capabilities using Inworld AI.
+
+
+Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -0,0 +1,6 @@
+{
+  "version": "0.2.0-alpha.0",
+  "package": "@mastra/voice-inworld",
+  "exports": {},
+  "modules": {}
+}

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

@@ -0,0 +1,1112 @@
+# Voice in Mastra
+
+Mastra's Voice system provides a unified interface for voice interactions, enabling text-to-speech (TTS), speech-to-text (STT), and real-time speech-to-speech (STS) capabilities in your applications.
+
+## Adding voice to agents
+
+To learn how to integrate voice capabilities into your agents, check out the [Adding Voice to Agents](https://mastra.ai/docs/agents/adding-voice) documentation. This section covers how to use both single and multiple voice providers, as well as real-time interactions.
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { OpenAIVoice } from '@mastra/voice-openai'
+
+// Initialize OpenAI voice for TTS
+
+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.4',
+  voice: new OpenAIVoice(),
+})
+```
+
+You can then use the following voice capabilities:
+
+### Text to Speech (TTS)
+
+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/docs/voice/text-to-speech).
+
+**OpenAI**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { OpenAIVoice } from '@mastra/voice-openai'
+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.4',
+  voice: new OpenAIVoice(),
+})
+
+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
+  responseFormat: 'wav', // Optional: specify a response format
+})
+
+playAudio(audioStream)
+```
+
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
+
+**Azure**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { AzureVoice } from '@mastra/voice-azure'
+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.4',
+  voice: new AzureVoice(),
+})
+
+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: 'en-US-JennyNeural', // Optional: specify a speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
+
+**ElevenLabs**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { ElevenLabsVoice } from '@mastra/voice-elevenlabs'
+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.4',
+  voice: new ElevenLabsVoice(),
+})
+
+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 [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.4',
+  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.
+
+**Google**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { GoogleVoice } from '@mastra/voice-google'
+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.4',
+  voice: new GoogleVoice(),
+})
+
+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: 'en-US-Studio-O', // Optional: specify a speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
+
+**Cloudflare**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { CloudflareVoice } from '@mastra/voice-cloudflare'
+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.4',
+  voice: new CloudflareVoice(),
+})
+
+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 [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
+
+**Deepgram**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { DeepgramVoice } from '@mastra/voice-deepgram'
+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.4',
+  voice: new DeepgramVoice(),
+})
+
+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: 'aura-english-us', // Optional: specify a speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
+
+**Inworld**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { InworldVoice } from '@mastra/voice-inworld'
+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.4',
+  voice: new InworldVoice(),
+})
+
+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: 'Dennis', // Optional: specify a speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Inworld Voice Reference](https://mastra.ai/reference/voice/inworld) for more information on the Inworld voice provider.
+
+**Speechify**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { SpeechifyVoice } from '@mastra/voice-speechify'
+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.4',
+  voice: new SpeechifyVoice(),
+})
+
+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: 'matthew', // Optional: specify a speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
+
+**Sarvam**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { SarvamVoice } from '@mastra/voice-sarvam'
+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.4',
+  voice: new SarvamVoice(),
+})
+
+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: 'shubh', // Optional: specify a bulbul:v3 speaker
+})
+
+playAudio(audioStream)
+```
+
+Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
+
+**Murf**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { MurfVoice } from '@mastra/voice-murf'
+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.4',
+  voice: new MurfVoice(),
+})
+
+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 [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
+
+### Speech to Text (STT)
+
+Transcribe spoken content using various providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/docs/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).
+
+[](https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3)
+
+**OpenAI**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { OpenAIVoice } from '@mastra/voice-openai'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new OpenAIVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Azure**:
+
+```typescript
+import { createReadStream } from 'fs'
+import { Agent } from '@mastra/core/agent'
+import { AzureVoice } from '@mastra/voice-azure'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new AzureVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**ElevenLabs**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { ElevenLabsVoice } from '@mastra/voice-elevenlabs'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new ElevenLabsVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Google**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { GoogleVoice } from '@mastra/voice-google'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new GoogleVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Cloudflare**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { CloudflareVoice } from '@mastra/voice-cloudflare'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new CloudflareVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Deepgram**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { DeepgramVoice } from '@mastra/voice-deepgram'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new DeepgramVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Inworld**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { InworldVoice } from '@mastra/voice-inworld'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new InworldVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+**Sarvam**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { SarvamVoice } from '@mastra/voice-sarvam'
+import { createReadStream } from 'fs'
+
+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.4',
+  voice: new SarvamVoice(),
+})
+
+// Use an audio file from a URL
+const audioStream = await createReadStream('./how_can_i_help_you.mp3')
+
+// Convert audio to text
+const transcript = await voiceAgent.voice.listen(audioStream)
+console.log(`User said: ${transcript}`)
+
+// Generate a response based on the 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.
+
+### 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/docs/voice/speech-to-speech).
+
+**OpenAI**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
+import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
+
+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.4',
+  voice: new OpenAIRealtimeVoice(),
+})
+
+// Listen for agent audio responses
+voiceAgent.voice.on('speaker', ({ audio }) => {
+  playAudio(audio)
+})
+
+// Initiate the conversation
+await voiceAgent.voice.speak('How can I help you today?')
+
+// Send continuous audio from the microphone
+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.
+
+**Google**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
+import { GeminiLiveVoice } from '@mastra/voice-google-gemini-live'
+
+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.4',
+  voice: new GeminiLiveVoice({
+    // Live API mode
+    apiKey: process.env.GOOGLE_API_KEY,
+    model: 'gemini-2.0-flash-exp',
+    speaker: 'Puck',
+    debug: true,
+    // Vertex AI alternative:
+    // vertexAI: true,
+    // project: 'your-gcp-project',
+    // location: 'us-central1',
+    // serviceAccountKeyFile: '/path/to/service-account.json',
+  }),
+})
+
+// Connect before using speak/send
+await voiceAgent.voice.connect()
+
+// Listen for agent audio responses
+voiceAgent.voice.on('speaker', ({ audio }) => {
+  playAudio(audio)
+})
+
+// Listen for text responses and transcriptions
+voiceAgent.voice.on('writing', ({ text, role }) => {
+  console.log(`${role}: ${text}`)
+})
+
+// Initiate the conversation
+await voiceAgent.voice.speak('How can I help you today?')
+
+// Send continuous audio from the microphone
+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.
+
+**AWS Nova Sonic**:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
+import { NovaSonicVoice } from '@mastra/voice-aws-nova-sonic'
+
+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.4',
+  voice: new NovaSonicVoice({
+    region: 'us-east-1',
+    speaker: 'matthew',
+    // Static credentials are optional. The default AWS credential
+    // provider chain is used when none are passed.
+  }),
+})
+
+// Connect before using speak/send
+await voiceAgent.voice.connect()
+
+// Listen for assistant audio (Int16Array PCM)
+voiceAgent.voice.on('speaking', ({ audioData }) => {
+  if (audioData) playAudio(audioData)
+})
+
+// Listen for transcribed text
+voiceAgent.voice.on('writing', ({ text, role }) => {
+  console.log(`${role}: ${text}`)
+})
+
+// Initiate the conversation
+await voiceAgent.voice.speak('How can I help you today?')
+
+// Send continuous audio from the microphone
+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.
+
+## Voice configuration
+
+Each voice provider can be configured with different models and options. Below are the detailed configuration options for all supported providers:
+
+**OpenAI**:
+
+```typescript
+// OpenAI Voice Configuration
+const voice = new OpenAIVoice({
+  speechModel: {
+    name: 'gpt-3.5-turbo', // Example model name
+    apiKey: process.env.OPENAI_API_KEY,
+    language: 'en-US', // Language code
+    voiceType: 'neural', // Type of voice model
+  },
+  listeningModel: {
+    name: 'whisper-1', // Example model name
+    apiKey: process.env.OPENAI_API_KEY,
+    language: 'en-US', // Language code
+    format: 'wav', // Audio format
+  },
+  speaker: 'alloy', // Example speaker name
+})
+```
+
+Visit the [OpenAI Voice Reference](https://mastra.ai/reference/voice/openai) for more information on the OpenAI voice provider.
+
+**Azure**:
+
+```typescript
+// Azure Voice Configuration
+const voice = new AzureVoice({
+  speechModel: {
+    name: 'en-US-JennyNeural', // Example model name
+    apiKey: process.env.AZURE_SPEECH_KEY,
+    region: process.env.AZURE_SPEECH_REGION,
+    language: 'en-US', // Language code
+    style: 'cheerful', // Voice style
+    pitch: '+0Hz', // Pitch adjustment
+    rate: '1.0', // Speech rate
+  },
+  listeningModel: {
+    name: 'en-US', // Example model name
+    apiKey: process.env.AZURE_SPEECH_KEY,
+    region: process.env.AZURE_SPEECH_REGION,
+    format: 'simple', // Output format
+  },
+})
+```
+
+Visit the [Azure Voice Reference](https://mastra.ai/reference/voice/azure) for more information on the Azure voice provider.
+
+**ElevenLabs**:
+
+```typescript
+// ElevenLabs Voice Configuration
+const voice = new ElevenLabsVoice({
+  speechModel: {
+    voiceId: 'your-voice-id', // Example voice ID
+    model: 'eleven_multilingual_v2', // Example model name
+    apiKey: process.env.ELEVENLABS_API_KEY,
+    language: 'en', // Language code
+    emotion: 'neutral', // Emotion setting
+  },
+  // ElevenLabs may not have a separate listening model
+})
+```
+
+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.
+
+**Google**:
+
+```typescript
+// Google Voice Configuration
+const voice = new GoogleVoice({
+  speechModel: {
+    name: 'en-US-Studio-O', // Example model name
+    apiKey: process.env.GOOGLE_API_KEY,
+    languageCode: 'en-US', // Language code
+    gender: 'FEMALE', // Voice gender
+    speakingRate: 1.0, // Speaking rate
+  },
+  listeningModel: {
+    name: 'en-US', // Example model name
+    sampleRateHertz: 16000, // Sample rate
+  },
+})
+```
+
+Visit the [Google Voice Reference](https://mastra.ai/reference/voice/google) for more information on the Google voice provider.
+
+**Cloudflare**:
+
+```typescript
+// Cloudflare Voice Configuration
+const voice = new CloudflareVoice({
+  speechModel: {
+    name: 'cloudflare-voice', // Example model name
+    accountId: process.env.CLOUDFLARE_ACCOUNT_ID,
+    apiToken: process.env.CLOUDFLARE_API_TOKEN,
+    language: 'en-US', // Language code
+    format: 'mp3', // Audio format
+  },
+  // Cloudflare may not have a separate listening model
+})
+```
+
+Visit the [Cloudflare Voice Reference](https://mastra.ai/reference/voice/cloudflare) for more information on the Cloudflare voice provider.
+
+**Deepgram**:
+
+```typescript
+// Deepgram Voice Configuration
+const voice = new DeepgramVoice({
+  speechModel: {
+    name: 'nova-2', // Example model name
+    speaker: 'aura-english-us', // Example speaker name
+    apiKey: process.env.DEEPGRAM_API_KEY,
+    language: 'en-US', // Language code
+    tone: 'formal', // Tone setting
+  },
+  listeningModel: {
+    name: 'nova-2', // Example model name
+    format: 'flac', // Audio format
+  },
+})
+```
+
+Visit the [Deepgram Voice Reference](https://mastra.ai/reference/voice/deepgram) for more information on the Deepgram voice provider.
+
+**Inworld**:
+
+```typescript
+// Inworld Voice Configuration
+const voice = new InworldVoice({
+  speechModel: {
+    name: 'inworld-tts-2',
+    apiKey: process.env.INWORLD_API_KEY,
+  },
+  listeningModel: {
+    name: 'groq/whisper-large-v3',
+    apiKey: process.env.INWORLD_API_KEY,
+  },
+  speaker: 'Dennis',
+  audioEncoding: 'MP3',
+  sampleRateHertz: 48000,
+  language: 'en-US',
+})
+
+// Per-call options: `deliveryMode` is honored only by `inworld-tts-2`.
+const audioStream = await voice.speak('Hello!', {
+  deliveryMode: 'BALANCED', // 'STABLE' | 'BALANCED' | 'CREATIVE'
+  language: 'en-US', // BCP-47 per-call override
+})
+```
+
+Visit the [Inworld Voice Reference](https://mastra.ai/reference/voice/inworld) for more information on the Inworld voice provider.
+
+**Speechify**:
+
+```typescript
+// Speechify Voice Configuration
+const voice = new SpeechifyVoice({
+  speechModel: {
+    name: 'speechify-voice', // Example model name
+    speaker: 'matthew', // Example speaker name
+    apiKey: process.env.SPEECHIFY_API_KEY,
+    language: 'en-US', // Language code
+    speed: 1.0, // Speech speed
+  },
+  // Speechify may not have a separate listening model
+})
+```
+
+Visit the [Speechify Voice Reference](https://mastra.ai/reference/voice/speechify) for more information on the Speechify voice provider.
+
+**Sarvam**:
+
+```typescript
+// Sarvam Voice Configuration
+const voice = new SarvamVoice({
+  speechModel: {
+    model: 'bulbul:v3', // TTS model (bulbul:v2 or bulbul:v3)
+    apiKey: process.env.SARVAM_API_KEY,
+    language: 'en-IN', // BCP-47 language code
+  },
+  listeningModel: {
+    model: 'saarika:v2.5', // STT model (saarika:v2.5 or saaras:v3)
+    apiKey: process.env.SARVAM_API_KEY,
+  },
+  speaker: 'shubh', // Default bulbul:v3 speaker
+})
+```
+
+Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for more information on the Sarvam voice provider.
+
+**Murf**:
+
+```typescript
+// Murf Voice Configuration
+const voice = new MurfVoice({
+  speechModel: {
+    name: 'murf-voice', // Example model name
+    apiKey: process.env.MURF_API_KEY,
+    language: 'en-US', // Language code
+    emotion: 'happy', // Emotion setting
+  },
+  // Murf may not have a separate listening model
+})
+```
+
+Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for more information on the Murf voice provider.
+
+**OpenAI Realtime**:
+
+```typescript
+// OpenAI Realtime Voice Configuration
+const voice = new OpenAIRealtimeVoice({
+  speechModel: {
+    name: 'gpt-3.5-turbo', // Example model name
+    apiKey: process.env.OPENAI_API_KEY,
+    language: 'en-US', // Language code
+  },
+  listeningModel: {
+    name: 'whisper-1', // Example model name
+    apiKey: process.env.OPENAI_API_KEY,
+    format: 'ogg', // Audio format
+  },
+  speaker: 'alloy', // Example speaker name
+})
+```
+
+For more information on the OpenAI Realtime voice provider, refer to the [OpenAI Realtime Voice Reference](https://mastra.ai/reference/voice/openai-realtime).
+
+**Google Gemini Live**:
+
+```typescript
+// Google Gemini Live Voice Configuration
+const voice = new GeminiLiveVoice({
+  speechModel: {
+    name: 'gemini-2.0-flash-exp', // Example model name
+    apiKey: process.env.GOOGLE_API_KEY,
+  },
+  speaker: 'Puck', // Example speaker name
+  // Google Gemini Live is a realtime bidirectional API without separate speech and listening models
+})
+```
+
+Visit the [Google Gemini Live Reference](https://mastra.ai/reference/voice/google-gemini-live) for more information on the Google Gemini Live voice provider.
+
+**AWS Nova Sonic**:
+
+```typescript
+// AWS Nova Sonic Voice Configuration
+const voice = new NovaSonicVoice({
+  region: 'us-east-1',
+  speaker: 'matthew',
+  sessionConfig: {
+    inferenceConfiguration: {
+      temperature: 0.7,
+      maxTokens: 1024,
+    },
+    turnDetectionConfiguration: {
+      endpointingSensitivity: 'MEDIUM',
+    },
+  },
+  // AWS Nova Sonic is a realtime bidirectional API without separate speech and listening models
+})
+```
+
+Visit the [AWS Nova Sonic Reference](https://mastra.ai/reference/voice/aws-nova-sonic) for more information on the AWS Nova Sonic voice provider.
+
+**AI SDK**:
+
+```typescript
+// AI SDK Voice Configuration
+import { CompositeVoice } from '@mastra/core/voice'
+import { openai } from '@ai-sdk/openai'
+import { elevenlabs } from '@ai-sdk/elevenlabs'
+
+// Use AI SDK models directly - no need to install separate packages
+const voice = new CompositeVoice({
+  input: openai.transcription('whisper-1'), // AI SDK transcription
+  output: elevenlabs.speech('eleven_turbo_v2'), // AI SDK speech
+})
+
+// Works seamlessly with your agent
+const voiceAgent = new Agent({
+  id: 'aisdk-voice-agent',
+  name: 'AI SDK Voice Agent',
+  instructions: 'You are a helpful assistant with voice capabilities.',
+  model: 'openai/gpt-5.4',
+  voice,
+})
+```
+
+### 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).
+
+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 { CompositeVoice } from '@mastra/core/voice'
+import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
+
+// Initialize OpenAI voice for STT
+const input = new OpenAIVoice({
+  listeningModel: {
+    name: 'whisper-1',
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+})
+
+// Initialize PlayAI voice for TTS
+const output = new PlayAIVoice({
+  speechModel: {
+    name: 'playai-voice',
+    apiKey: process.env.PLAYAI_API_KEY,
+  },
+})
+
+// Combine the providers using CompositeVoice
+const voice = new CompositeVoice({
+  input,
+  output,
+})
+
+// Implement voice interactions using the combined voice provider
+const audioStream = getMicrophoneStream() // Assume this function gets audio input
+const transcript = await voice.listen(audioStream)
+
+// Log the transcribed text
+console.log('Transcribed text:', transcript)
+
+// Convert text to speech
+const responseAudio = await voice.speak(`You said: ${transcript}`, {
+  speaker: 'default', // Optional: specify a speaker,
+  responseFormat: 'wav', // Optional: specify a response format
+})
+
+// Play the audio response
+playAudio(responseAudio)
+```
+
+### Using AI SDK Model Providers
+
+You can also use AI SDK models directly with `CompositeVoice`:
+
+```typescript
+import { CompositeVoice } from '@mastra/core/voice'
+import { openai } from '@ai-sdk/openai'
+import { elevenlabs } from '@ai-sdk/elevenlabs'
+import { playAudio, getMicrophoneStream } from '@mastra/node-audio'
+
+// Use AI SDK models directly - no provider setup needed
+const voice = new CompositeVoice({
+  input: openai.transcription('whisper-1'), // AI SDK transcription
+  output: elevenlabs.speech('eleven_turbo_v2'), // AI SDK speech
+})
+
+// Works the same way as Mastra providers
+const audioStream = getMicrophoneStream()
+const transcript = await voice.listen(audioStream)
+
+console.log('Transcribed text:', transcript)
+
+// Convert text to speech
+const responseAudio = await voice.speak(`You said: ${transcript}`, {
+  speaker: 'Rachel', // ElevenLabs voice
+})
+
+playAudio(responseAudio)
+```
+
+You can also mix AI SDK models with Mastra providers:
+
+```typescript
+import { CompositeVoice } from '@mastra/core/voice'
+import { PlayAIVoice } from '@mastra/voice-playai'
+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
+})
+```
+
+For more information on the CompositeVoice, refer to the [CompositeVoice Reference](https://mastra.ai/reference/voice/composite-voice).
+
+## More resources
+
+- [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)
+- [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)
+- [PlayAI Voice](https://mastra.ai/reference/voice/playai)
+- [Voice Examples](https://github.com/mastra-ai/voice-examples)

package/dist/docs/references/reference-voice-inworld.md

@@ -0,0 +1,133 @@
+# Inworld
+
+The Inworld voice implementation in Mastra provides streaming text-to-speech (TTS) and batch speech-to-text (STT) capabilities using Inworld AI's API. It supports multiple TTS and STT models, configurable audio encodings, and progressive audio streaming.
+
+## Usage example
+
+```typescript
+import { InworldVoice } from '@mastra/voice-inworld'
+
+// Initialize with default configuration (uses INWORLD_API_KEY environment variable)
+const voice = new InworldVoice()
+
+// Initialize with custom configuration
+const voice = new InworldVoice({
+  speechModel: {
+    name: 'inworld-tts-2',
+    apiKey: 'your-api-key',
+  },
+  listeningModel: {
+    name: 'groq/whisper-large-v3',
+    apiKey: 'your-api-key',
+  },
+  speaker: 'Dennis',
+})
+
+// Text-to-Speech (streaming)
+const audioStream = await voice.speak('Hello, world!')
+
+// Speech-to-Text
+const transcript = await voice.listen(audioStream)
+```
+
+## Constructor parameters
+
+**speechModel** (`InworldVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'inworld-tts-2' }`)
+
+**speechModel.name** (`'inworld-tts-2' | 'inworld-tts-1.5-max' | 'inworld-tts-1.5-mini'`): The Inworld TTS model to use.
+
+**speechModel.apiKey** (`string`): Inworld API key. Falls back to INWORLD\_API\_KEY environment variable.
+
+**listeningModel** (`InworldListeningConfig`): Configuration for speech-to-text functionality. (Default: `{ name: 'groq/whisper-large-v3' }`)
+
+**listeningModel.name** (`'groq/whisper-large-v3'`): The Inworld STT model to use.
+
+**listeningModel.apiKey** (`string`): Inworld API key. Falls back to INWORLD\_API\_KEY environment variable.
+
+**speaker** (`string`): Default voice ID to use for text-to-speech. (Default: `'Dennis'`)
+
+**audioEncoding** (`'LINEAR16' | 'MP3' | 'OGG_OPUS' | 'ALAW' | 'MULAW' | 'FLAC' | 'PCM' | 'WAV'`): Default audio encoding for TTS output. (Default: `'MP3'`)
+
+**sampleRateHertz** (`number`): Default sample rate for TTS output. (Default: `48000`)
+
+**language** (`string`): Default BCP-47 language code for STT. (Default: `'en-US'`)
+
+## Methods
+
+### `speak(input, options?)`
+
+Converts text to speech using Inworld's streaming TTS endpoint. Returns a readable stream that emits audio chunks progressively as they arrive.
+
+```typescript
+const audioStream = await voice.speak('Hello, world!', {
+  speaker: 'Olivia',
+  audioEncoding: 'WAV',
+  sampleRateHertz: 24000,
+  speakingRate: 1.2,
+  temperature: 0.8,
+})
+```
+
+**input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
+
+**options** (`InworldSpeakOptions`): Additional options for speech synthesis.
+
+**options.speaker** (`string`): Override the default speaker for this request.
+
+**options.audioEncoding** (`AudioEncoding`): Override the default audio encoding.
+
+**options.sampleRateHertz** (`number`): Override the default sample rate.
+
+**options.speakingRate** (`number`): Adjust the speaking rate.
+
+**options.temperature** (`number`): Controls voice variability. Honored on \`inworld-tts-1.5-\*\` models; ignored by \`inworld-tts-2\`.
+
+**options.deliveryMode** (`'STABLE' | 'BALANCED' | 'CREATIVE'`): Steering control for delivery style. Only honored by \`inworld-tts-2\`.
+
+**options.language** (`string`): BCP-47 language code for this request. Auto-detected when omitted.
+
+**Returns:** `Promise<NodeJS.ReadableStream>`
+
+### `listen(input, options?)`
+
+Converts speech to text using Inworld's batch STT endpoint.
+
+```typescript
+const transcript = await voice.listen(audioStream, {
+  audioEncoding: 'MP3',
+  sampleRateHertz: 44100,
+  language: 'ja-JP',
+})
+```
+
+**input** (`NodeJS.ReadableStream`): Audio stream to transcribe.
+
+**options** (`InworldListenOptions`): Additional options for transcription.
+
+**options.audioEncoding** (`'LINEAR16' | 'MP3' | 'OGG_OPUS' | 'FLAC' | 'AUTO_DETECT'`): Audio encoding of the input stream.
+
+**options.sampleRateHertz** (`number`): Sample rate of the input audio.
+
+**options.language** (`string`): BCP-47 language code for transcription.
+
+**options.numberOfChannels** (`number`): Number of audio channels in the input.
+
+**Returns:** `Promise<string>`
+
+### `getSpeakers()`
+
+Returns a list of available voices from the Inworld API.
+
+```typescript
+const speakers = await voice.getSpeakers()
+// [{ voiceId: 'Dennis', name: 'Dennis', language: 'en', description: '...', tags: ['friendly'], source: 'SYSTEM' }, ...]
+```
+
+**Returns:** `Promise<Array<{ voiceId: string; name: string; language: string; description: string; tags: string[]; source: string }>>`
+
+## Notes
+
+- The TTS endpoint uses progressive NDJSON streaming, so audio playback can begin before the full response is received.
+- An API key can be provided via the `speechModel` or `listeningModel` config, or the `INWORLD_API_KEY` environment variable. TTS and STT keys are resolved independently: passing distinct `speechModel.apiKey` and `listeningModel.apiKey` values lets each service use its own credential. If only one is provided, it is reused for both services as a fallback before the env var.
+- `inworld-tts-2` is the default flagship model. Use `deliveryMode` (`STABLE` | `BALANCED` | `CREATIVE`) to steer delivery style on this model. The `temperature` option is ignored on `inworld-tts-2`.
+- The `inworld-tts-1.5-mini` model offers lower latency at the cost of reduced voice quality compared to `inworld-tts-1.5-max`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-inworld",
-  "version": "0.0.0",
+  "version": "0.2.0-alpha.0",
   "description": "Mastra Inworld AI voice integration — streaming TTS and batch STT",
   "type": "module",
   "files": [
@@ -22,26 +22,19 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsup --silent --config tsup.config.ts",
-    "prepack": "pnpx tsx ../../scripts/generate-package-docs.ts",
-    "build:watch": "tsup --watch --silent --config tsup.config.ts",
-    "test": "vitest run",
-    "lint": "eslint ."
-  },
   "license": "Apache-2.0",
   "dependencies": {},
   "devDependencies": {
-    "@internal/lint": "workspace:*",
-    "@internal/types-builder": "workspace:*",
-    "@mastra/core": "workspace:*",
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "catalog:",
-    "@vitest/ui": "catalog:",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "eslint": "^10.2.1",
     "tsup": "^8.5.1",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "@internal/lint": "0.0.92",
+    "@internal/types-builder": "0.0.67",
+    "@mastra/core": "1.33.0-alpha.13"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0",
@@ -58,5 +51,11 @@
   },
   "engines": {
     "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "test": "vitest run",
+    "lint": "eslint ."
   }
-}
+}