ControlCommandError (voice_mode/control_channel.py)

Thread-safe control channel for managing voice playback state and commands.

# Source: https://github.com/mbailey/voicemode | License: MIT | Copyright 2026 Mike Bailey
# Provided via justclaw.it.com; keep this notice with the code.
"""In-process control-channel state and command schema for VoiceMode (VM-1676).

The control channel is a side channel that lets an external trigger -- a Stream
Deck press, a media key, a spoken keyword, or any local process -- pause /
resume / stop an in-flight TTS utterance *without* going through the MCP
protocol stream and *without* pressing ESC.

This module is the foundation: **pure logic, no sockets and no audio.** Two
pieces, kept transport-agnostic so a socket listener (or an HTTP one later) can
sit on top without playback ever caring:

* ``ControlState`` -- a thread-safe object. One side (a listener thread) calls
  ``request_pa

... (truncated -- full source via MCP)