From 456b7f1ce9cd6649c21c3f24a0797e2e2a410424 Mon Sep 17 00:00:00 2001
From: emcon <emma@connor.phd>
Date: Thu, 2 Jan 2025 15:15:25 -0800
Subject: [PATCH] add fsm satellite for realtime conversations

---
 sounds/awake-quiet.wav        | Bin 0 -> 17700 bytes
 sounds/done-quiet.wav         | Bin 0 -> 49276 bytes
 wyoming_satellite/__main__.py |  62 +++-
 wyoming_satellite/fsmsat.py   | 558 ++++++++++++++++++++++++++++++++++
 wyoming_satellite/settings.py |  25 ++
 5 files changed, 641 insertions(+), 4 deletions(-)
 create mode 100644 sounds/awake-quiet.wav
 create mode 100644 sounds/done-quiet.wav
 create mode 100644 wyoming_satellite/fsmsat.py

diff --git a/sounds/awake-quiet.wav b/sounds/awake-quiet.wav
new file mode 100644
index 0000000000000000000000000000000000000000..fd44565ecac3e03b5209cdda598f9d18731a9861
GIT binary patch
literal 17700
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
br*}Ce5qBpz*SlLY`080Kbekt0vZwz89)s6H

literal 0
HcmV?d00001

diff --git a/sounds/done-quiet.wav b/sounds/done-quiet.wav
new file mode 100644
index 0000000000000000000000000000000000000000..5b51361ba5441b8f2f2f14ef36268dcd8bd96f53
GIT binary patch
literal 49276
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
H4+;D)b%I8>

literal 0
HcmV?d00001

diff --git a/wyoming_satellite/__main__.py b/wyoming_satellite/__main__.py
index 4cff57b..4adf081 100644
--- a/wyoming_satellite/__main__.py
+++ b/wyoming_satellite/__main__.py
@@ -10,6 +10,8 @@
 from wyoming.info import Attribution, Info, Satellite
 from wyoming.server import AsyncServer, AsyncTcpServer
 
+from .fsmsat import FSMSatellite
+
 from . import __version__
 from .event_handler import SatelliteEventHandler
 from .satellite import (
@@ -20,6 +22,7 @@
 )
 from .settings import (
     EventSettings,
+    FSMSettings,
     MicSettings,
     SatelliteSettings,
     SndSettings,
@@ -166,6 +169,49 @@ async def main() -> None:
         help="Seconds before going back to waiting for speech when wake word isn't detected",
     )
 
+    parser.add_argument(
+        "--fsm-stream-giveup-delay",
+        type=float,
+        default=5,
+        help=FSMSettings.stream_giveup_delay.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-stream-end-delay",
+        type=float,
+        default=1.2,
+        help=FSMSettings.stream_end_delay.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-tts-end-delay",
+        type=float,
+        default=0.5,
+        help=FSMSettings.tts_end_delay.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-followup-vad-refractory",
+        type=float,
+        default=1.5,
+        help=FSMSettings.followup_vad_refractory.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-followup-timeout",
+        type=float,
+        default=10,
+        help=FSMSettings.followup_timeout.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-listen-start-wav",
+        type=str,
+        default=None,
+        help=FSMSettings.listen_start_alert_wav.__doc__,
+    )
+    parser.add_argument(
+        "--fsm-listen-stop-wav",
+        type=str,
+        default=None,
+        help=FSMSettings.listen_stop_alert_wav.__doc__,
+    )
+
     # External event handlers
     parser.add_argument(
         "--event-uri", help="URI of Wyoming service to forward events to"
@@ -330,9 +376,6 @@ async def main() -> None:
         _LOGGER.fatal("%s does not exist", args.timer_finished_wav)
         sys.exit(1)
 
-    if args.vad and (args.wake_uri or args.wake_command):
-        _LOGGER.warning("VAD is not used with local wake word detection")
-
     logging.basicConfig(
         level=logging.DEBUG if args.debug else logging.INFO, format=args.log_format
     )
@@ -424,12 +467,23 @@ async def main() -> None:
             finished_wav_plays=int(args.timer_finished_wav_repeat[0]),
             finished_wav_delay=args.timer_finished_wav_repeat[1],
         ),
+        fsm=FSMSettings(
+            followup_timeout=args.fsm_followup_timeout,
+            stream_giveup_delay=args.fsm_stream_giveup_delay,
+            stream_end_delay=args.fsm_stream_end_delay,
+            tts_end_delay=args.fsm_tts_end_delay,
+            followup_vad_refractory=args.fsm_followup_vad_refractory,
+            listen_start_alert_wav=args.fsm_listen_start_wav,
+            listen_stop_alert_wav=args.fsm_listen_stop_wav,
+        ),
         debug_recording_dir=args.debug_recording_dir,
     )
 
     satellite: SatelliteBase
 
-    if settings.wake.enabled:
+    if settings.wake.enabled and settings.vad.enabled:
+        satellite = FSMSatellite(settings)
+    elif settings.wake.enabled:
         # Local wake word detection
         satellite = WakeStreamingSatellite(settings)
     elif settings.vad.enabled:
diff --git a/wyoming_satellite/fsmsat.py b/wyoming_satellite/fsmsat.py
new file mode 100644
index 0000000..8cf1a84
--- /dev/null
+++ b/wyoming_satellite/fsmsat.py
@@ -0,0 +1,558 @@
+from enum import Enum, StrEnum, auto
+import sys
+import math
+import logging
+import time
+import asyncio
+from typing import (
+    Any,
+    Awaitable,
+    Callable,
+    ClassVar,
+    Coroutine,
+    Final,
+    List,
+    Mapping,
+    Optional,
+)
+import queue
+
+from pyring_buffer import RingBuffer
+
+
+from wyoming.client import AsyncClient
+from wyoming.info import Describe, Info
+from wyoming.asr import Transcript
+from wyoming.audio import AudioChunk, AudioStop, AudioStart, AudioFormat
+from wyoming.error import Error
+from wyoming.event import Event
+from wyoming.satellite import (
+    PauseSatellite,
+    RunSatellite,
+)
+from wyoming.wake import Detection
+from wyoming.snd import SndProcessAsyncClient
+
+from .utils.audio import wav_to_events
+
+from .satellite import SatelliteBase
+from .settings import SatelliteSettings
+from .vad import SileroVad
+
+
+_LOGGER = logging.getLogger()
+_WAKE_INFO_TIMEOUT: Final = 2
+
+
+class SatState(Enum):
+    """Nodes in the finite state machine graph"""
+
+    PAUSED = auto()
+    """The satellite is not listening. It is waiting for a connection or a start command from a server."""
+
+    MONITOR = auto()
+    """The satellite is listening, and forwarding audio to the wakeword service. It is waiting for a wakeword detection."""
+
+    STREAM_TO_SERVER = auto()
+    """The satellite is streaming mic audio to the server."""
+
+    PLAYBACK = auto()
+    """The satellite is playing audio from the server. In this state, the satellite does not process mic input."""
+
+    FOLLOWUP = auto()
+    """The satellite recently finished playback, and we are now waiting to see if the user responds. In this state, a wakeword is not required; the satellite will start streaming audio to the server again as soon as the VAD triggers. """
+
+
+class SatEvent(StrEnum):
+    """Events which affect the state of the satellite."""
+
+    VAD = "vad"
+    """The voice activation detection service triggered."""
+
+    WAKEWORD = "wakeword"
+    """The wakeword detection service triggered."""
+
+    STATE_CHANGE = "state_change"
+    """The satellite changed states."""
+
+    TTS_START = "tts_start"
+    """The satellite started playing audio from the server."""
+
+    TTS_END = "tts_end"
+    """The satellite stopped playing audio from the server."""
+
+    SERVER_DISCONNECT = "server_disconnect"
+    """The server disconnected."""
+
+    SERVER_CONNECT = "server_connect"
+    """The server connected."""
+
+    PAUSE = "pause"
+    """The server instructed the satellite to pause."""
+
+
+StateChangeListener = Callable[
+    ["FSMSatellite", SatState, SatState], Coroutine[Any, Any, None]
+]
+StateChangePredicate = Callable[[SatState, SatState], bool]
+
+
+_state_change_listeners: list[tuple[StateChangePredicate, StateChangeListener]] = []
+
+
+def on_state_change(
+    old_state: Optional[SatState] = None,
+    new_state: Optional[SatState] = None,
+) -> Callable[[StateChangeListener], StateChangeListener]:
+    """
+    Decorator that registers a method as a state change listener. The method will be
+    invoked when the satellite changes states. If old_state is provided, then the
+    listener only triggers when the satellite is exiting the given state. Likewise,
+    if new_state is provided, the listener triggers only when the satellite is
+    entering new_state. Valid on instance methods of FSMSatellite.
+    """
+
+    def state_change_decorator(func: StateChangeListener) -> StateChangeListener:
+        key = old_state, new_state
+
+        def predicate(event_old_state: SatState, event_new_state: SatState) -> bool:
+            if old_state is not None and old_state != event_old_state:
+                return False
+            if new_state is not None and new_state != event_new_state:
+                return False
+            return True
+
+        _state_change_listeners.append((predicate, func))
+        return func
+
+    return state_change_decorator
+
+
+class FSMSatellite(SatelliteBase):
+    """
+    A satellite that uses both wakeword and VAD to support back-and-forth conversation.
+    A wakeword trigger is required for the first user speech, but for a short time
+    after TTS plays, a wakeword is not required to stream a follow-up prompt.
+
+    See SatState enum docs for full state machine details.
+    """
+
+    def __init__(self, settings: SatelliteSettings) -> None:
+        super().__init__(settings)
+        self.vad = SileroVad(
+            threshold=settings.vad.threshold, trigger_level=settings.vad.trigger_level
+        )
+        self.mic_format: AudioFormat = AudioFormat(
+            settings.mic.rate, settings.mic.width, settings.mic.channels
+        )
+
+        self.sat_events: dict[SatEvent, float] = {}
+        self.sat_state: SatState = SatState.PAUSED
+        self.wav_tasks: List[asyncio.Task] = []
+
+        # Audio from right before speech starts (circular buffer)
+        self.vad_buffer: Optional[RingBuffer] = None
+        self.vad_chunk: Optional[AudioChunk] = None
+        self.last_debug: float = time.monotonic()
+        # track a heuristic for when we expect the TTS audio from the server to stop playing.
+        # this is only a best-effort guess.
+        self.expected_playback_end: float = time.monotonic()
+
+        self._wake_info: Optional[Info] = None
+        self._wake_info_ready = asyncio.Event()
+        self._debug_recording_timestamp: Optional[int] = None
+
+        if settings.vad.buffer_seconds > 0:
+            vad_buffer_bytes = int(
+                math.ceil(
+                    settings.vad.buffer_seconds
+                    * self.mic_format.rate
+                    * self.mic_format.width
+                    * self.mic_format.channels
+                )
+            )
+            self.vad_buffer = RingBuffer(maxlen=vad_buffer_bytes)
+
+    async def run(self) -> None:
+        async with asyncio.TaskGroup() as tg:
+            tg.create_task(super().run())
+            tg.create_task(self.background_tasks())
+
+    async def background_tasks(self) -> None:
+        """Asynchronously read from stdin. When a line is read, print debug info on the current state."""
+        lines: queue.Queue[str] = queue.Queue()
+
+        def read_stdin() -> str:
+            return sys.stdin.readline()
+
+        while True:
+            line = await asyncio.to_thread(read_stdin)
+            t_since = {e.name: self.time_since_last_event(e) for e in self.sat_events}
+            _LOGGER.debug(f"current status: {self.sat_state} {t_since}")
+
+    def mark_sat_event(self, event: SatEvent) -> None:
+        """Record the time when an event occurs, overwriting previous occurrences."""
+        self.sat_events[event] = time.monotonic()
+
+    def times_since_events(self) -> Mapping[SatEvent, float | None]:
+        """
+        Return a mapping from all sat events that happened since the
+        last state change, to the number of seconds since that event occurred.
+        """
+        now = time.monotonic()
+        return {e: self.time_since_last_event(e, now) for e in self.sat_events}
+
+    def set_sat_state(self, new_state: SatState) -> None:
+        """
+        Update the satellite state, reseting all sat events.
+        """
+        old_state = self.sat_state
+        if old_state == new_state:
+            _LOGGER.warning(
+                f"Tried to change state, but we were already in the requested state {new_state}. Ignoring."
+            )
+            return
+        _LOGGER.debug(
+            f"exiting state: {old_state}  events: {self.times_since_events()}"
+        )
+        _LOGGER.info(f"entering state: {new_state}")
+        self.sat_state = new_state
+        self.sat_events = {}
+        self.mark_sat_event(SatEvent.STATE_CHANGE)
+
+    async def play_wav_background(self, wav_path: str) -> None:
+        """
+        Play a wav file asynchronously.
+        """
+
+        async def background_task() -> None:
+            client = self._make_snd_client()
+            assert client is not None
+            await client.connect()
+            try:
+                for event in wav_to_events(
+                    wav_path,
+                    samples_per_chunk=self.settings.snd.samples_per_chunk,
+                ):
+                    await client.write_event(event)
+            finally:
+                await client.disconnect()
+
+        i: int = 0
+        while i < len(self.wav_tasks):
+            task = self.wav_tasks[i]
+            if task.done():
+                await self.wav_tasks.pop(i)
+            else:
+                i += 1
+        self.wav_tasks.append(asyncio.create_task(background_task()))
+
+    async def event_from_server(self, event: Event) -> None:
+        await super().event_from_server(event)
+
+        if RunSatellite.is_type(event.type):
+            _LOGGER.info("server requested satellite start; starting")
+            if self.sat_state == SatState.PAUSED:
+                self.set_sat_state(SatState.MONITOR)
+        elif Detection.is_type(event.type):
+            # Start debug recording
+            if self.stt_audio_writer is not None:
+                self.stt_audio_writer.start()
+        elif (
+            Transcript.is_type(event.type)
+            or Error.is_type(event.type)
+            or PauseSatellite.is_type(event.type)
+        ):
+            if PauseSatellite.is_type(event.type):
+                self.mark_sat_event(SatEvent.PAUSE)
+            # Stop debug recording
+            if self.stt_audio_writer is not None:
+                self.stt_audio_writer.stop()
+
+    async def event_from_mic(
+        self, event: Event, audio_bytes: Optional[bytes] = None
+    ) -> None:
+        if (
+            (not AudioChunk.is_type(event.type))
+            or self.microphone_muted
+            or self.sat_state == SatState.PAUSED
+        ):
+            return
+        chunk = AudioChunk.from_event(event)
+        audio_bytes = chunk.audio
+        now = time.monotonic()
+        if now - self.last_debug > 1:
+            self.last_debug = now
+
+        if self.stt_audio_writer is not None and audio_bytes is not None:
+            self.stt_audio_writer.write(audio_bytes)
+
+        voice_detected = self.vad(audio_bytes)
+        if voice_detected:
+            self.mark_sat_event(SatEvent.VAD)
+
+        new_state = await self.update_state()
+
+        await self.event_to_wake(event)
+        if new_state == SatState.STREAM_TO_SERVER:
+            await self.event_to_server(event)
+        if new_state in (SatState.MONITOR, SatState.FOLLOWUP):
+            if self.vad_buffer is not None:
+                self.vad_chunk = chunk
+                self.vad_buffer.put(audio_bytes)
+
+    async def update_state(self) -> SatState:
+        """
+        Check if a state transition should happen. If so, update our state
+        and trigger appropriate listeners.
+
+        :returns: The current satellite state, which may or may not differ
+            from the old state.
+        """
+        old_state = self.sat_state
+        new_state = self.get_next_state()
+        if old_state != new_state:
+            self.set_sat_state(new_state)
+            await self.handle_state_change(old_state, new_state)
+        return new_state
+
+    @on_state_change(new_state=SatState.STREAM_TO_SERVER)
+    async def on_stream_start(self, old_state: SatState, new_state: SatState) -> None:
+        """
+        When we are about to start streaming audio to the server, send the server
+        audio and pipeline start events, then send any buffered pre-VAD audio
+        """
+        await self.event_to_server(
+            AudioStart(
+                rate=self.mic_format.rate,
+                width=self.mic_format.width,
+                channels=self.mic_format.channels,
+            ).event()
+        )
+        await self._send_run_pipeline()
+        await self.drain_vad_buffer()
+
+    @on_state_change(new_state=SatState.STREAM_TO_SERVER)
+    @on_state_change(new_state=SatState.FOLLOWUP)
+    async def on_listen_start(self, old_state: SatState, new_state: SatState) -> None:
+        """
+        When we begin streaming or start listening for a followup response,
+        play an alert sound to indicate to the user that we're listening.
+        """
+        if self.settings.fsm.listen_start_alert_wav:
+            await self.play_wav_background(self.settings.fsm.listen_start_alert_wav)
+        if self.settings.fsm.listen_stop_alert_wav:
+            await self.play_wav_background(self.settings.fsm.listen_stop_alert_wav)
+
+    @on_state_change(old_state=SatState.STREAM_TO_SERVER)
+    async def on_stream_stop(self, old_state: SatState, new_state: SatState) -> None:
+        """
+        When we stop streaming audio to the server, play an alert sound
+        to indicate to the user that we're no longer listening and send
+        and audio stop event to the server.
+        """
+        if self.settings.fsm.listen_stop_alert_wav:
+            await self.play_wav_background(self.settings.fsm.listen_stop_alert_wav)
+        await self.event_to_server(AudioStop().event())
+
+    async def handle_state_change(
+        self, old_state: SatState, new_state: SatState
+    ) -> None:
+        """
+        When the satellite transitions from old_state to new_state,
+        trigger all state change listeners that apply.
+        """
+        async with asyncio.TaskGroup() as tg:
+            for predicate, handler in _state_change_listeners:
+                if predicate(old_state, new_state):
+                    tg.create_task(handler(self, old_state, new_state))
+
+    async def drain_vad_buffer(self) -> None:
+        """Send the user speech that was buffered before VAD to the server, and reset the VAD buffer."""
+        if self.vad_buffer is not None and self.vad_chunk is not None:
+            chunk = self.vad_chunk
+            await self.event_to_server(
+                AudioChunk(
+                    rate=chunk.rate,
+                    width=chunk.width,
+                    channels=chunk.channels,
+                    audio=self.vad_buffer.getvalue(),
+                ).event()
+            )
+        self._reset_vad()
+
+    def time_since_last_event(
+        self, event_type: SatEvent, now: Optional[float] = None
+    ) -> Optional[float]:
+        """Return the time the event was last marked, in seconds"""
+        if now is None:
+            now = time.monotonic()
+        event_ts = self.sat_events.get(event_type)
+        if event_ts is None:
+            return None
+        return now - event_ts
+
+    def get_next_state(self) -> SatState:
+        """
+        Check our current state and past events to determine what the next state should be.
+        The return value is either the current state, or a new state.
+        """
+        last_state_change = self.time_since_last_event(SatEvent.STATE_CHANGE)
+        assert last_state_change is not None, "State change event should always exist"
+        last_vad = self.time_since_last_event(SatEvent.VAD)
+
+        if self.time_since_last_event(SatEvent.SERVER_DISCONNECT) is not None:
+            return SatState.PAUSED
+        elif self.sat_state == SatState.PAUSED:
+            if self.time_since_last_event(SatEvent.SERVER_CONNECT) is not None:
+                return SatState.MONITOR
+        elif self.sat_state == SatState.MONITOR:
+            last_wakeword = self.time_since_last_event(SatEvent.WAKEWORD)
+            if last_wakeword is not None:
+                return SatState.STREAM_TO_SERVER
+        elif self.sat_state == SatState.STREAM_TO_SERVER:
+            if (
+                last_vad is None
+                and last_state_change > self.settings.fsm.stream_giveup_delay
+            ):
+                return SatState.PLAYBACK
+            elif last_vad is not None and last_vad > self.settings.fsm.stream_end_delay:
+                return SatState.PLAYBACK
+        elif self.sat_state == SatState.PLAYBACK:
+            tts_end = self.time_since_last_event(SatEvent.TTS_END)
+            if self.time_since_last_event(SatEvent.PAUSE) is not None:
+                return SatState.MONITOR
+            elif tts_end is not None and tts_end > self.settings.fsm.tts_end_delay:
+                return SatState.FOLLOWUP
+        elif self.sat_state == SatState.FOLLOWUP:
+            if self.time_since_last_event(SatEvent.PAUSE) is not None:
+                return SatState.MONITOR
+            elif (
+                last_vad is not None
+                and last_state_change - last_vad
+                > self.settings.fsm.followup_vad_refractory
+            ):
+                return SatState.STREAM_TO_SERVER
+            elif last_state_change > self.settings.fsm.followup_timeout:
+                return SatState.MONITOR
+
+        # no state change, return the current state
+        return self.sat_state
+
+    async def trigger_server_disonnected(self) -> None:
+        await super().trigger_server_disonnected()
+        self.mark_sat_event(SatEvent.SERVER_DISCONNECT)
+
+    async def trigger_server_connected(self) -> None:
+        await super().trigger_server_connected()
+        self.mark_sat_event(SatEvent.SERVER_CONNECT)
+
+    async def _snd_task_proc(self) -> None:
+        """Snd service loop."""
+        snd_client: Optional[AsyncClient] = None
+
+        async def _disconnect() -> None:
+            try:
+                if snd_client is not None:
+                    await snd_client.disconnect()
+            except Exception:
+                pass  # ignore disconnect errors
+
+        while self.is_running:
+            try:
+                if self._snd_queue is None:
+                    self._snd_queue = asyncio.Queue()
+
+                snd_event = await self._snd_queue.get()
+                event = snd_event.event
+
+                if snd_client is None:
+                    snd_client = self._make_snd_client()
+                    assert snd_client is not None
+                    await snd_client.connect()
+                    _LOGGER.debug("Connected to snd service")
+
+                if AudioChunk.is_type(event.type):
+                    chunk = AudioChunk.from_event(event)
+
+                    if SatEvent.TTS_START not in self.sat_events:
+                        self.mark_sat_event(SatEvent.TTS_START)
+                    # Audio processing
+                    if self.settings.snd.needs_processing:
+                        audio_bytes = self._process_snd_audio(chunk.audio)
+                        event = AudioChunk(
+                            rate=chunk.rate,
+                            width=chunk.width,
+                            channels=chunk.channels,
+                            audio=audio_bytes,
+                        ).event()
+
+                    self.expected_playback_end = (
+                        max(time.monotonic(), self.expected_playback_end)
+                        + chunk.seconds
+                    )
+                await snd_client.write_event(event)
+
+                if self.settings.snd.disconnect_after_stop and AudioStop.is_type(
+                    event.type
+                ):
+                    if isinstance(snd_client, SndProcessAsyncClient):
+                        self.sat_events[SatEvent.TTS_END] = self.expected_playback_end
+                    await _disconnect()
+                    if snd_event.is_tts:
+                        await self.trigger_played()
+                    snd_client = None  # reconnect on next event
+            except asyncio.CancelledError:
+                break
+            except Exception:
+                _LOGGER.exception("Unexpected error in snd read task")
+                await _disconnect()
+                snd_client = None  # reconnect
+                self._snd_queue = None
+                await asyncio.sleep(self.settings.snd.reconnect_seconds)
+
+        await _disconnect()
+
+    def _reset_vad(self):
+        """Reset state of VAD."""
+        self.vad(None)
+        if self.vad_buffer is not None:
+            self.vad_buffer.put(bytes(self.vad_buffer.maxlen))
+            self.vad_chunk = None
+
+    async def event_from_wake(self, event: Event) -> None:
+        if Info.is_type(event.type):
+            self._wake_info = Info.from_event(event)
+            self._wake_info_ready.set()
+            return
+
+        if Detection.is_type(event.type):
+            detection = Detection.from_event(event)
+            # Stop debug recording (wake)
+            if self.wake_audio_writer is not None:
+                self.wake_audio_writer.stop()
+            # Start debug recording (stt)
+            if self.stt_audio_writer is not None:
+                self.stt_audio_writer.start(timestamp=self._debug_recording_timestamp)
+
+            _LOGGER.info("wakeword detected")
+            self.mark_sat_event(SatEvent.WAKEWORD)
+
+            await self.event_to_server(event)
+            await self.forward_event(event)  # forward to event service
+
+    async def update_info(self, info: Info) -> None:
+        self._wake_info = None
+        self._wake_info_ready.clear()
+        await self.event_to_wake(Describe().event())
+
+        try:
+            await asyncio.wait_for(
+                self._wake_info_ready.wait(), timeout=_WAKE_INFO_TIMEOUT
+            )
+
+            if self._wake_info is not None:
+                # Update wake info only
+                info.wake = self._wake_info.wake
+        except asyncio.TimeoutError:
+            _LOGGER.warning("Failed to get info from wake service")
diff --git a/wyoming_satellite/settings.py b/wyoming_satellite/settings.py
index fd9c959..b8139aa 100644
--- a/wyoming_satellite/settings.py
+++ b/wyoming_satellite/settings.py
@@ -132,6 +132,30 @@ class WakeSettings(ServiceSettings):
     """Seconds after a wake word detection before another detection is handled."""
 
 
+@dataclass(frozen=True)
+class FSMSettings:
+
+    stream_giveup_delay: float = 5
+    """Time in seconds after which we should give up and cancel streaming audio to the server if no vad has triggered since we started streaming."""
+
+    stream_end_delay: float = 1.2
+    """Seconds of continuos time to require with no VAD trigger before determining that user speech has ended and closing a stream. This only applies if VAD has triggered at least once since the start of the stream; othrewise, see stream_giveup_delay."""
+
+    tts_end_delay: float = 0.5
+    """Seconds to wait after TTS playback stops before we start listening for user speech again."""
+
+    followup_vad_refractory: float = 1.5
+    """Seconds to wait after entering a followup state before VAD triggers are honored. This delay helps prevent false postitive VAD triggers that might otherwise happen due to TTS feedback."""
+
+    followup_timeout: float = 10
+    """During followup, seconds to wait for VAD before returning to monitor state (i.e., requiring wakeword again)"""
+
+    listen_start_alert_wav: Optional[str] = "sounds/awake-quiet.wav"
+    """Wav file to play when the satellite detects the beginning of user speech, which means that either a wakeword detection occurs during monitor state, or VAD occurs during followup state. File plays using snd service."""
+    listen_stop_alert_wav: Optional[str] = "sounds/done-quiet.wav"
+    """Wav file to play when the satellite detects the end of user speech."""
+
+
 @dataclass(frozen=True)
 class VadSettings:
     """Voice activity detector settings."""
@@ -209,6 +233,7 @@ class SatelliteSettings:
     snd: SndSettings = field(default_factory=SndSettings)
     event: EventSettings = field(default_factory=EventSettings)
     timer: TimerSettings = field(default_factory=TimerSettings)
+    fsm: FSMSettings = field(default_factory=FSMSettings)
 
     restart_timeout: float = 5.0