@mastra/voice-aws-nova-sonic 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -1,17 +1,44 @@
-# Changelog
+# @mastra/voice-aws-nova-sonic
 
-All notable changes to this package will be documented in this file.
+## 0.1.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
+  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
 
-- 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)
+### Patch Changes
+
+- Updated dependencies [[`1723e09`](https://github.com/mastra-ai/mastra/commit/1723e099829892419ddbfe49287acfeac2522724), [`629f9e9`](https://github.com/mastra-ai/mastra/commit/629f9e9a7e56aa8f129515a3923c5813298790c7), [`25168fb`](https://github.com/mastra-ai/mastra/commit/25168fb9c1de9db7f8171df4f58ceb842c53aa29), [`ab34b5a`](https://github.com/mastra-ai/mastra/commit/ab34b5a2191b8e4353df1dbf7b9155e7d6628d79), [`5fb6c2a`](https://github.com/mastra-ai/mastra/commit/5fb6c2a95c1843cc231704b91354311fc1f34a71), [`2b0f355`](https://github.com/mastra-ai/mastra/commit/2b0f3553be3e9e5524da539a66e5cf82668440a4), [`394f0cf`](https://github.com/mastra-ai/mastra/commit/394f0cfc31e6b4d801219fdef2e9cc69e5bc8682), [`b2deb29`](https://github.com/mastra-ai/mastra/commit/b2deb29412b300c868655b5840463614fbb7962d), [`66644be`](https://github.com/mastra-ai/mastra/commit/66644beac1aa560f0e417956ff007c89341dc382), [`e109607`](https://github.com/mastra-ai/mastra/commit/e10960749251e34d46b480a20648c490fd30381b), [`310b953`](https://github.com/mastra-ai/mastra/commit/310b95345f302dcd5ba3ed862bdc96f059d44122), [`3d7f709`](https://github.com/mastra-ai/mastra/commit/3d7f709b615e588050bb6283c4ee5cfe2978cbde), [`48a42f1`](https://github.com/mastra-ai/mastra/commit/48a42f114a4006a95e0b7a1b5ad1a24815a175c2), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006), [`2c83efc`](https://github.com/mastra-ai/mastra/commit/2c83efc4482b3efe50830e3b8b4ba9a8d219edff), [`43f0e1d`](https://github.com/mastra-ai/mastra/commit/43f0e1d5d5a74ba6fc746f2ad89ebe0c64777a7d), [`da0b9e2`](https://github.com/mastra-ai/mastra/commit/da0b9e2ba7ecc560213b426d6c097fe63946086e), [`282a10c`](https://github.com/mastra-ai/mastra/commit/282a10c9446e9922afe80e10e3770481c8ac8a28), [`04151c7`](https://github.com/mastra-ai/mastra/commit/04151c7dcea934b4fe9076708a23fac161195414), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006)]:
+  - @mastra/core@1.31.0
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Add new `@mastra/voice-aws-nova-sonic` voice provider for AWS Bedrock Nova 2 Sonic. ([#13232](https://github.com/mastra-ai/mastra/pull/13232))
+
+  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"
+---
+
+## 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",
+  "package": "@mastra/voice-aws-nova-sonic",
+  "exports": {},
+  "modules": {}
+}