Voice: exit hands-free mode command word — return to text mode

[proagentstore]

Summary

Add a configurable command word that exits hands-free mode and returns the UI to standard text input mode. This follows the same pattern as the other voice command words (e.g. the unmute keyword in #152).

Default keyword

stop session

Behaviour

1. While hands-free mode is active, the SpeechRecognition instance listens for the configured command word alongside normal dictation.
2. When the command word is detected:
   • Hands-free mode is deactivated.
   • The microphone / SpeechRecognition loop is stopped.
   • The UI reverts to standard text input mode (same state as if the user had manually toggled the hands-free switch off).
3. No message is sent to the agent — this is a control command only.

Configuration

• The keyword should be user-configurable (same settings surface as the other command words).
• Default value: "stop session"

Related

• Voice: unmute command word — dictation-based wake-to-record with configurable keyword and start-recording signal #152 — unmute command word (same command-word infrastructure)

Acceptance criteria

• Saying "stop session" (or the configured keyword) while in hands-free mode exits hands-free and restores text mode.
• The keyword is configurable in user settings.
• No accidental trigger when the phrase appears mid-sentence in normal dictation (debounce / exact-match check).

[serge-ivo]

Related: #228 (mute unreachable during capture in Whisper STT mode) and #152 (unmute). All three add a value to the VoiceCommand union in packages/sdk/src/voice/convo.ts:106 and wire it through the same four matchVoiceCommand call sites in use-voice.ts (:616, :684, :703, :788) plus handleControlResult (:604).

Doing them as three separate PRs means touching the same six lines three times and re-testing the same matrix three times. Recommend #228 first (it fixes the gating all three depend on), then #152 and #165 together as one vocabulary change.

Note this issue also has six closed duplicates (#166-#171), all created within the same minute on 2026-08-03 — worth checking whatever produced them before filing more voice tickets.

[serge-ivo]

Shipped in 4870fde, together with #152 as one vocabulary change.

VoiceCommand gains "exit" with per-language phrasings. Unlike mute, exit matches whether or not you are muted — it is the way out of both states — and it clears the muted flag so the next voice session doesn't start muted. Multi-word phrases, so "okay exit voice mode now" matches inside a longer utterance.

exitWords per-instance + voiceExitWords on the profile; field in Settings → Voice.

Note the six closed duplicates (#166-#171), all created within the same minute — still worth finding what produced them.