@mastra/voice-aws-nova-sonic 0.0.0 → 0.1.0-alpha.0

package/CHANGELOG.md

@@ -1,17 +1,20 @@
-# Changelog
+# @mastra/voice-aws-nova-sonic
 
-All notable changes to this package will be documented in this file.
+## 0.1.0-alpha.0
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+### Minor Changes
 
-## [0.12.0-beta.0] - 2026-02-18
+- Add new `@mastra/voice-aws-nova-sonic` voice provider for AWS Bedrock Nova 2 Sonic. ([#13232](https://github.com/mastra-ai/mastra/pull/13232))
 
-### Added
-
-- Initial release of AWS Nova 2 Sonic voice integration
-- Support for bidirectional streaming speech-to-speech
-- AWS SigV4 authentication for WebSocket connections
-- Polyglot voice support with multiple languages
-- Tool/function calling support
-- Cross-modal input (audio and text)
+  The provider exposes a real-time bidirectional voice interface backed by the
+  `InvokeModelWithBidirectionalStreamCommand` API on AWS Bedrock, including:
+  - Live microphone streaming (`send` / `listen`) and assistant audio playback
+    via `speaking` events
+  - Live transcription via `writing` events with `SPECULATIVE` / `FINAL`
+    generation stages
+  - Barge-in / interrupt detection
+  - Speaker selection across all 18 Nova Sonic voices and configurable
+    endpointing sensitivity
+  - Tool calling with per-session `RequestContext`
+  - Configurable AWS region, model id, credentials (or default credential
+    provider chain), and inference / turn-detection parameters

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/README.md

@@ -44,6 +44,7 @@ yarn add @mastra/voice-aws-nova-sonic
 You can configure AWS credentials in several ways:
 
 **Option 1: Environment Variables**
+
 ```bash
 export AWS_ACCESS_KEY_ID=your-access-key-id
 export AWS_SECRET_ACCESS_KEY=your-secret-access-key
@@ -51,6 +52,7 @@ export AWS_REGION=us-east-1
 ```
 
 **Option 2: AWS Credentials File**
+
 ```ini
 # ~/.aws/credentials
 [default]
@@ -59,9 +61,11 @@ aws_secret_access_key = your-secret-access-key
 ```
 
 **Option 3: IAM Role** (for EC2/Lambda)
+
 - Attach an IAM role with Bedrock permissions to your EC2 instance or Lambda function
 
 **Option 4: Explicit Credentials in Code**
+
 ```typescript
 import { NovaSonicVoice } from '@mastra/voice-aws-nova-sonic';
 
@@ -84,10 +88,7 @@ Your AWS credentials need the following IAM permissions:
   "Statement": [
     {
       "Effect": "Allow",
-      "Action": [
-        "bedrock:InvokeModel",
-        "bedrock:InvokeModelWithBidirectionalStream"
-      ],
+      "Action": ["bedrock:InvokeModel", "bedrock:InvokeModelWithBidirectionalStream"],
       "Resource": "arn:aws:bedrock:*::foundation-model/amazon.nova-2-sonic-v1:0"
     }
   ]
@@ -116,7 +117,7 @@ const agent = new Agent({
 await agent.voice.connect();
 
 // Listen for agent audio responses (stream of audio data)
-agent.voice.on('speaker', (audioStream) => {
+agent.voice.on('speaker', audioStream => {
   // Pipe to your audio output (e.g., speaker, WebSocket, file)
   audioStream.pipe(yourAudioOutput);
 });

package/dist/docs/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: mastra-voice-aws-nova-sonic
+description: Documentation for @mastra/voice-aws-nova-sonic. Use when working with @mastra/voice-aws-nova-sonic APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/voice-aws-nova-sonic"
+  version: "0.1.0-alpha.0"
+---
+
+## When to use
+
+Use this skill whenever you are working with @mastra/voice-aws-nova-sonic 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.
+- [Speech-to-Speech capabilities in Mastra](references/docs-voice-speech-to-speech.md) - Overview of speech-to-speech capabilities in Mastra, including real-time interactions and event-driven architecture.
+
+### Reference
+
+- [Reference: AWS Nova Sonic voice](references/reference-voice-aws-nova-sonic.md) - Documentation for the NovaSonicVoice class, providing real-time speech-to-speech capabilities via AWS Bedrock Nova 2 Sonic.
+
+
+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.1.0-alpha.0",
+  "package": "@mastra/voice-aws-nova-sonic",
+  "exports": {},
+  "modules": {}
+}