From cc1f4ba81c24ff0928eb336507ee20b800d5946f Mon Sep 17 00:00:00 2001
From: Paul Kompfner <paul@daily.co>
Date: Fri, 2 May 2025 11:31:56 -0400
Subject: [PATCH] [WIP] AWS Nova Sonic service - add a hacky way of
 programmatically triggering an assistant response

---
 examples/foundational/39-aws-nova-sonic.py    |  18 +++-
 pyproject.toml                                |   1 +
 src/pipecat/services/aws_nova_sonic/aws.py    |  92 ++++++++++++++++--
 src/pipecat/services/aws_nova_sonic/ready.wav | Bin 0 -> 23484 bytes
 4 files changed, 100 insertions(+), 11 deletions(-)
 create mode 100644 src/pipecat/services/aws_nova_sonic/ready.wav

diff --git a/examples/foundational/39-aws-nova-sonic.py b/examples/foundational/39-aws-nova-sonic.py
index f08cfad04..07670f75a 100644
--- a/examples/foundational/39-aws-nova-sonic.py
+++ b/examples/foundational/39-aws-nova-sonic.py
@@ -83,12 +83,16 @@ async def run_bot(webrtc_connection: SmallWebRTCConnection):
         ),
     )
 
-    # Specify initial system instruction
+    # Specify initial system instruction.
+    # HACK: note that, for now, we need to inject a special bit of text into this instruction to
+    # allow the first assistant response to be programmatically triggered (which happens in the
+    # on_client_connected handler, below)
     # TODO: looks like Nova Sonic can't handle new lines?
     system_instruction = (
-        "You are a friendly assistant. The user and you will engage in a spoken dialog "
-        "exchanging the transcripts of a natural real-time conversation. Keep your responses short, "
-        "generally two or three sentences for chatty scenarios."
+        "You are a friendly assistant. The user and you will engage in a spoken dialog exchanging "
+        "the transcripts of a natural real-time conversation. Keep your responses short, generally "
+        "two or three sentences for chatty scenarios. "
+        f"{AWSNovaSonicLLMService.AWAIT_TRIGGER_ASSISTANT_RESPONSE_INSTRUCTION}"
     )
 
     # Create the AWS Nova Sonic LLM service
@@ -117,7 +121,7 @@ async def run_bot(webrtc_connection: SmallWebRTCConnection):
             {"role": "system", "content": f"{system_instruction}"},
             {
                 "role": "user",
-                "content": "Say hello!",
+                "content": "Tell me a fun fact!",
             },
         ],
         tools=tools,
@@ -151,6 +155,10 @@ async def run_bot(webrtc_connection: SmallWebRTCConnection):
         logger.info(f"Client connected")
         # Kick off the conversation.
         await task.queue_frames([context_aggregator.user().get_context_frame()])
+        # HACK: for now, we need this special way of triggering the first assistant response in AWS
+        # Nova Sonic. Note that this trigger requires a special corresponding bit of text in the
+        # system instruction. In the future, simply queueing the context frame should be sufficient.
+        await llm.trigger_assistant_response()
 
     # Handle client disconnection events
     @transport.event_handler("on_client_disconnected")
diff --git a/pyproject.toml b/pyproject.toml
index d6d05c00c..7ce167d77 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -96,6 +96,7 @@ where = ["src"]
 
 [tool.setuptools.package-data]
 "pipecat" = ["py.typed"]
+"pipecat.services.aws_nova_sonic" = ["src/pipecat/services/aws_nova_sonic/ready.wav"]
 
 [tool.pytest.ini_options]
 addopts = "--verbose"
diff --git a/src/pipecat/services/aws_nova_sonic/aws.py b/src/pipecat/services/aws_nova_sonic/aws.py
index e7b1fd8e6..5b69810f3 100644
--- a/src/pipecat/services/aws_nova_sonic/aws.py
+++ b/src/pipecat/services/aws_nova_sonic/aws.py
@@ -8,8 +8,10 @@ import asyncio
 import base64
 import json
 import uuid
+import wave
 from dataclasses import dataclass
 from enum import Enum
+from importlib.resources import files
 from typing import Any, List, Optional
 
 from aws_sdk_bedrock_runtime.client import (
@@ -146,6 +148,8 @@ class AWSNovaSonicLLMService(LLMService):
         self._context_available = False
         self._ready_to_send_context = False
         self._handling_bot_stopped_speaking = False
+        self._triggering_assistant_response = False
+        self._assistant_response_trigger_audio: bytes = None  # Not cleared on _disconnect()
 
     #
     # standard AIService frame handling
@@ -180,8 +184,7 @@ class AWSNovaSonicLLMService(LLMService):
         if isinstance(frame, OpenAILLMContextFrame):
             await self._handle_context(frame.context)
         elif isinstance(frame, InputAudioRawFrame):
-            # TODO: check if _audio_input_paused? what causes that?
-            await self._send_user_audio_event(frame)
+            await self._handle_input_audio_frame(frame)
         elif isinstance(frame, BotStoppedSpeakingFrame):
             await self._handle_bot_stopped_speaking()
         elif isinstance(frame, AWSNovaSonicFunctionCallResultFrame):
@@ -211,6 +214,15 @@ class AWSNovaSonicLLMService(LLMService):
             self._context_available = True
             await self._finish_connecting_if_context_available()
 
+    async def _handle_input_audio_frame(self, frame: InputAudioRawFrame):
+        # Wait until we're done sending the assistant response trigger audio before sending audio
+        # from the user's mic
+        if self._triggering_assistant_response:
+            return
+
+        # TODO: check if _audio_input_paused? what causes that?
+        await self._send_user_audio_event(frame.audio)
+
     async def _handle_bot_stopped_speaking(self):
         # Protect against back-to-back BotStoppedSpeaking calls, which I've observed
         if self._handling_bot_stopped_speaking:
@@ -316,6 +328,14 @@ class AWSNovaSonicLLMService(LLMService):
         # Start receiving events
         self._receive_task = self.create_task(self._receive_task_handler())
 
+        # If we need to, send assistant response trigger
+        if self._triggering_assistant_response:
+            # If the trigger was the first audio chunk sent on this connection it'd be ignored (I'm
+            # guessing the LLM can't quite "hear" the first little bit of audio sent). So send a bit
+            # of leading blank audio first.
+            await self._send_assistant_response_trigger(lead_with_blank_audio=True)
+            self._triggering_assistant_response = False
+
     async def _disconnect(self):
         try:
             # Clean up receive task
@@ -340,6 +360,8 @@ class AWSNovaSonicLLMService(LLMService):
             self._assistant_is_responding = False
             self._context_available = False
             self._ready_to_send_context = False
+            self._handling_bot_stopped_speaking = False
+            self._triggering_assistant_response = False
         except Exception as e:
             logger.error(f"{self} error disconnecting: {e}")
 
@@ -490,11 +512,11 @@ class AWSNovaSonicLLMService(LLMService):
         '''
         await self._send_client_event(text_content_end)
 
-    async def _send_user_audio_event(self, frame: InputAudioRawFrame):
+    async def _send_user_audio_event(self, audio: bytes):
         if not self._stream:
             return
 
-        blob = base64.b64encode(frame.audio)
+        blob = base64.b64encode(audio)
         audio_event = f'''
         {{
             "event": {{
@@ -639,7 +661,7 @@ class AWSNovaSonicLLMService(LLMService):
                     elif "contentEnd" in event_json:
                         # Handle a piece of content ending
                         await self._handle_content_end_event(event_json)
-                    elif "completionStart" in event_json:
+                    elif "completionEnd" in event_json:
                         # Handle the LLM completion ending
                         await self._handle_completion_end_event(event_json)
 
@@ -839,7 +861,7 @@ class AWSNovaSonicLLMService(LLMService):
             )
 
     #
-    # Context
+    # context
     #
 
     def create_context_aggregator(
@@ -855,3 +877,61 @@ class AWSNovaSonicLLMService(LLMService):
         assistant = AWSNovaSonicAssistantContextAggregator(context=context, params=assistant_params)
 
         return AWSNovaSonicContextAggregatorPair(user, assistant)
+
+    #
+    # assistant response trigger (HACK)
+    #
+
+    # Class variable
+    AWAIT_TRIGGER_ASSISTANT_RESPONSE_INSTRUCTION = (
+        "Start speaking when you hear the user say 'ready', but don't consider that 'ready' to be "
+        "a meaningful part of the conversation other than as a trigger for you to start speaking."
+    )
+
+    async def trigger_assistant_response(self):
+        if self._triggering_assistant_response:
+            return False
+
+        self._triggering_assistant_response = True
+
+        # Read audio bytes, if we don't already have them cached
+        if not self._assistant_response_trigger_audio:
+            file_path = files("pipecat.services.aws_nova_sonic").joinpath("ready.wav")
+            with wave.open(file_path.open("rb"), "rb") as wav_file:
+                self._assistant_response_trigger_audio = wav_file.readframes(wav_file.getnframes())
+
+        # Send the trigger audio, if we're fully connected and set up
+        # NOTE: maybe there's a better way to determine whether we're done setting up?
+        if self._receive_task:
+            await self._send_assistant_response_trigger()
+            self._triggering_assistant_response = False
+
+    async def _send_assistant_response_trigger(self, lead_with_blank_audio=False):
+        # TODO: if/when we make bitrate, etc configurable, avoid hard-coding this
+        chunk_size = 640  # equivalent to what we get from InputAudioRawFrame
+        chunk_duration = 640 / (
+            16000 * 2
+        )  # 640 bytes of 16-bit (2-byte) PCM mono audio at 16kHz corresponds to 0.02 seconds
+
+        # Lead with blank audio, if needed
+        if lead_with_blank_audio:
+            blank_audio_duration = 0.5  # much less than this and it doesn't reliably work
+            blank_audio_chunk = b"\x00" * chunk_size
+            num_chunks = int(blank_audio_duration / chunk_duration)
+            for _ in range(num_chunks):
+                await self._send_user_audio_event(blank_audio_chunk)
+                await asyncio.sleep(chunk_duration)
+
+        # Send trigger audio
+        # NOTE: this audio *will* be transcribed and eventually make it into the context. That's OK:
+        # if we ever need to seed this service again with context it would make sense to include it
+        # since the instruction (i.e. the "wait for the trigger" instruction) will be part of the 
+        # context as well.
+        # print(f"[pk] sending trigger audio! {len(self._assistant_response_trigger_audio)}")
+        audio_chunks = [
+            self._assistant_response_trigger_audio[i : i + chunk_size]
+            for i in range(0, len(self._assistant_response_trigger_audio), chunk_size)
+        ]
+        for chunk in audio_chunks:
+            await self._send_user_audio_event(chunk)
+            await asyncio.sleep(chunk_duration)
diff --git a/src/pipecat/services/aws_nova_sonic/ready.wav b/src/pipecat/services/aws_nova_sonic/ready.wav
new file mode 100644
index 0000000000000000000000000000000000000000..ca932afa66d69dcf3626a54f9b171c767eb4d0e9
GIT binary patch
literal 23484
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%0A_+60amGW#y65
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
OiQ=XI7yGY0@P7cz=1kiF

literal 0
HcmV?d00001