docs: sync voice reliability updates and phase state

config/default.yaml

@@ -592,6 +592,7 @@ automation:
 #     wake_phrase: "hey flynn"
 #     timeout_ms: 120000
 #     allow_manual_toggle: true
+#     # While active, spoken/text "stop" or "cancel" maps to /stop run control.
 
 # ── Text-to-Speech (TTS) Output ──────────────────────────────────────
 # Optional voice output for assistant replies. Uses an OpenAI-compatible
@@ -600,6 +601,23 @@ automation:
 # tts:
 #   enabled: false
 #   enabled_channels: [telegram, whatsapp, discord] # Empty = all channels
+#   providers:
+#     - name: primary
+#       type: custom                                  # openai | custom
+#       endpoint: "https://tts-primary.example.com/v1/audio/speech"
+#       api_key: "${PRIMARY_TTS_API_KEY}"
+#       model: "gpt-4o-mini-tts"
+#       voice: "alloy"
+#       format: "mp3"                                 # mp3 | wav | opus
+#     - name: backup
+#       type: openai
+#       api_key: "${OPENAI_API_KEY}"
+#       model: "gpt-4o-mini-tts"
+#       voice: "nova"
+#       format: "opus"
+#   fallback:
+#     max_attempts: 2
+#     failure_cooldown_ms: 60000
 #   provider:
 #     type: openai                                  # openai | custom
 #     endpoint: "https://api.openai.com/v1/audio/speech"
@@ -607,6 +625,7 @@ automation:
 #     model: "gpt-4o-mini-tts"
 #     voice: "alloy"
 #     format: "mp3"                                 # mp3 | wav | opus
+#   # Legacy single-provider format (`provider`) is still supported.
 
 # ── Sub-Agent Configs ────────────────────────────────────────────────
 # Named agent configurations for delegation via agent.delegate tool.