easyspeak-linux 0.2.0__tar.gz → 0.3.0__tar.gz

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/.github/workflows/pipeline.yml

@@ -20,7 +20,7 @@ jobs:
         - lint --
         - types
         - package
-        - functional
+        - gate
       fail-fast: false
     steps:
     - uses: actions/checkout@v6
@@ -33,6 +33,23 @@ jobs:
         sudo apt install -y portaudio19-dev
     - run: just ${{ matrix.task }}
 
+  js:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        task:
+        - lint-js
+        - test-js
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v5
+      with:
+        node-version: '22'
+    - uses: taiki-e/install-action@just
+    - run: npm install --global eslint@10
+    - run: just ${{ matrix.task }}
+
   test:
     runs-on: ubuntu-latest
     strategy:

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/.gitignore

@@ -52,3 +52,7 @@ Thumbs.db
 # Project specific
 *.wav
 *.log
+
+# locally installed agent skills
+.agents/
+skills-lock.json

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easyspeak-linux
-Version: 0.2.0
+Version: 0.3.0
 Summary: Voice control for Linux desktops. Fully local, no cloud, Wayland-native.
 Author-email: Matt Hartley <matt@matthartley.com>
 Maintainer-email: Matt Hartley <matt@matthartley.com>
@@ -24,19 +24,28 @@ Requires-Python: <3.14,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: faster-whisper>=1.2.1
+Requires-Dist: jeepney>=0.9
 Requires-Dist: numpy>=2.2.6
 Requires-Dist: onnxruntime>=1.23.2
 Requires-Dist: onnxruntime<1.24; python_full_version < "3.11"
 Requires-Dist: pyaudio>=0.2.14
+Provides-Extra: acceptance
+Requires-Dist: pytest>=8; extra == "acceptance"
+Requires-Dist: pytest-bdd>=7; extra == "acceptance"
 Provides-Extra: benchmark
 Requires-Dist: pytest>=8; extra == "benchmark"
 Requires-Dist: pytest-benchmark>=5; extra == "benchmark"
 Provides-Extra: head-tracking
 Requires-Dist: opencv-python>=4.13.0.90; extra == "head-tracking"
 Requires-Dist: sixdrepnet>=0.1.6; extra == "head-tracking"
+Provides-Extra: integration
+Requires-Dist: pytest>=8; extra == "integration"
 Provides-Extra: mypy
 Requires-Dist: mypy>=1.19.1; extra == "mypy"
 Requires-Dist: types-pyaudio>=0.2.16.20250801; extra == "mypy"
+Provides-Extra: unittest
+Requires-Dist: coverage[toml]>=7.14; extra == "unittest"
+Requires-Dist: pytest>=8; extra == "unittest"
 Dynamic: license-file
 
 # EasySpeak [![PyPI](https://img.shields.io/pypi/v/easyspeak-linux)](https://pypi.org/project/easyspeak-linux/)
@@ -196,7 +205,10 @@ easyspeak                              # the project execution script
 
 Activate the venv each time you open a new terminal.
 
-Say "Hey Jarvis" followed by a command.
+Say "Hey Jarvis" followed by a command. After a command that gives no spoken
+reply (such as volume changes), EasySpeak keeps listening for a few seconds so
+you can chain commands — say "louder", "louder", "louder" without repeating the
+wake word each time.
 
 ## Commands
 
@@ -315,9 +327,10 @@ Built-in bookmarks: youtube, google, gmail, github, reddit, twitter, facebook, a
 | close [app] | Close application |
 
 Default apps in `plugins/apps.py` (edit to match your system):
-- firefox, steam, spotify, calculator, settings, files, terminal, browser
+- firefox, steam, spotify, calculator, settings, files, terminal, browser, music player
 
-These are just examples. Edit `apps.py` to add your own apps.
+These are just examples. Edit `apps.py` to add your own apps. Some accept
+spoken aliases — e.g. "open music app" works the same as "open music player".
 
 ### Files
 
@@ -328,6 +341,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | open pictures | Open Pictures folder |
 | open music | Open Music folder |
 | open videos | Open Videos folder |
+| open projects | Open Projects folder |
 | open home | Open home folder |
 | open desktop | Open Desktop folder |
 
@@ -336,7 +350,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | Command | Action |
 |---------|--------|
 | play | Resume playback |
-| pause | Pause playback |
+| pause / stop the music | Pause playback |
 | next / skip | Next track |
 | previous / back | Previous track |
 
@@ -344,30 +358,35 @@ These are just examples. Edit `apps.py` to add your own apps.
 
 | Command | Action |
 |---------|--------|
-| volume up/down | Adjust volume |
+| volume up/down (or louder / quieter) | Adjust volume one step (repeat to keep going) |
+| very loud / very silent | Jump straight to near-max (85%) / low (15%, not muted) |
 | mute | Toggle mute |
 | brightness up/down | Adjust brightness |
 | do not disturb on/off | Toggle notifications |
 
+Volume changes are silent — GNOME's own on-screen display and chime acknowledge them.
+
 ### General
 
 | Command | Action |
 |---------|--------|
 | help | List all commands |
-| stop / exit / quit | Exit EasySpeak |
+| go to sleep / stop listening | Release the mic (reactivate from the tray icon) |
+| quit / exit / goodbye | Exit EasySpeak |
 
 ## File Structure
 
 ```
 easyspeak/
-├── extension.js               # GNOME Shell extension
-├── metadata.json              # Extension metadata
 ├── pyproject.toml
 ├── src
+│   ├── extension.js           # GNOME Shell extension (bundled as package data)
+│   ├── metadata.json          # Extension metadata
 │   ├── core
 │   │   ├── __init__.py
 │   │   ├── __main__.py
 │   │   ├── config.py          # Tuning constants + Whisper model factory
+│   │   ├── gnome_extension.py  # Installs/refreshes/enables the extension
 │   │   └── main.py            # EasySpeak class + main loop
 │   └── plugins
 │       ├── __init__.py
@@ -386,9 +405,9 @@ easyspeak/
     └── plugins                # tests for src/plugins/
 ```
 
-On first start, the `mousegrid` plugin auto-installs the GNOME Shell
-extension to the user-local extensions directory (unless GNOME already
-sees it via a system-wide install). Files copied:
+On first start, core auto-installs the GNOME Shell extension to the
+user-local extensions directory (unless GNOME already sees it via a
+system-wide install). Files copied:
 
 ```
 ~/.local/share/gnome-shell/extensions/easyspeak-grid@local/
@@ -444,11 +463,12 @@ def handle(cmd, core):
 
 **Mouse grid: "Failed to show grid — is extension enabled?"**
 
-EasySpeak auto-installs the GNOME Shell extension to
-`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` on first
-run (look for a `mousegrid: installed ...` message at startup). On
-Wayland, GNOME Shell only scans for new extensions at login, so you
-typically have to **log out and back in** before it becomes loadable.
+You don't install the extension yourself — EasySpeak does it automatically
+on startup, copying it to
+`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` and keeping it
+up to date (look for an `easyspeak: installed ...` or `easyspeak: updated ...`
+message). On Wayland, GNOME Shell only scans for new extensions at login, so
+you typically have to **log out and back in** before it becomes loadable.
 
 After re-login, enable it from the command line:
 

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/README.md

@@ -155,7 +155,10 @@ easyspeak                              # the project execution script
 
 Activate the venv each time you open a new terminal.
 
-Say "Hey Jarvis" followed by a command.
+Say "Hey Jarvis" followed by a command. After a command that gives no spoken
+reply (such as volume changes), EasySpeak keeps listening for a few seconds so
+you can chain commands — say "louder", "louder", "louder" without repeating the
+wake word each time.
 
 ## Commands
 
@@ -274,9 +277,10 @@ Built-in bookmarks: youtube, google, gmail, github, reddit, twitter, facebook, a
 | close [app] | Close application |
 
 Default apps in `plugins/apps.py` (edit to match your system):
-- firefox, steam, spotify, calculator, settings, files, terminal, browser
+- firefox, steam, spotify, calculator, settings, files, terminal, browser, music player
 
-These are just examples. Edit `apps.py` to add your own apps.
+These are just examples. Edit `apps.py` to add your own apps. Some accept
+spoken aliases — e.g. "open music app" works the same as "open music player".
 
 ### Files
 
@@ -287,6 +291,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | open pictures | Open Pictures folder |
 | open music | Open Music folder |
 | open videos | Open Videos folder |
+| open projects | Open Projects folder |
 | open home | Open home folder |
 | open desktop | Open Desktop folder |
 
@@ -295,7 +300,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | Command | Action |
 |---------|--------|
 | play | Resume playback |
-| pause | Pause playback |
+| pause / stop the music | Pause playback |
 | next / skip | Next track |
 | previous / back | Previous track |
 
@@ -303,30 +308,35 @@ These are just examples. Edit `apps.py` to add your own apps.
 
 | Command | Action |
 |---------|--------|
-| volume up/down | Adjust volume |
+| volume up/down (or louder / quieter) | Adjust volume one step (repeat to keep going) |
+| very loud / very silent | Jump straight to near-max (85%) / low (15%, not muted) |
 | mute | Toggle mute |
 | brightness up/down | Adjust brightness |
 | do not disturb on/off | Toggle notifications |
 
+Volume changes are silent — GNOME's own on-screen display and chime acknowledge them.
+
 ### General
 
 | Command | Action |
 |---------|--------|
 | help | List all commands |
-| stop / exit / quit | Exit EasySpeak |
+| go to sleep / stop listening | Release the mic (reactivate from the tray icon) |
+| quit / exit / goodbye | Exit EasySpeak |
 
 ## File Structure
 
 ```
 easyspeak/
-├── extension.js               # GNOME Shell extension
-├── metadata.json              # Extension metadata
 ├── pyproject.toml
 ├── src
+│   ├── extension.js           # GNOME Shell extension (bundled as package data)
+│   ├── metadata.json          # Extension metadata
 │   ├── core
 │   │   ├── __init__.py
 │   │   ├── __main__.py
 │   │   ├── config.py          # Tuning constants + Whisper model factory
+│   │   ├── gnome_extension.py  # Installs/refreshes/enables the extension
 │   │   └── main.py            # EasySpeak class + main loop
 │   └── plugins
 │       ├── __init__.py
@@ -345,9 +355,9 @@ easyspeak/
     └── plugins                # tests for src/plugins/
 ```
 
-On first start, the `mousegrid` plugin auto-installs the GNOME Shell
-extension to the user-local extensions directory (unless GNOME already
-sees it via a system-wide install). Files copied:
+On first start, core auto-installs the GNOME Shell extension to the
+user-local extensions directory (unless GNOME already sees it via a
+system-wide install). Files copied:
 
 ```
 ~/.local/share/gnome-shell/extensions/easyspeak-grid@local/
@@ -403,11 +413,12 @@ def handle(cmd, core):
 
 **Mouse grid: "Failed to show grid — is extension enabled?"**
 
-EasySpeak auto-installs the GNOME Shell extension to
-`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` on first
-run (look for a `mousegrid: installed ...` message at startup). On
-Wayland, GNOME Shell only scans for new extensions at login, so you
-typically have to **log out and back in** before it becomes loadable.
+You don't install the extension yourself — EasySpeak does it automatically
+on startup, copying it to
+`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` and keeping it
+up to date (look for an `easyspeak: installed ...` or `easyspeak: updated ...`
+message). On Wayland, GNOME Shell only scans for new extensions at login, so
+you typically have to **log out and back in** before it becomes loadable.
 
 After re-login, enable it from the command line:
 

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/easyspeak_linux.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easyspeak-linux
-Version: 0.2.0
+Version: 0.3.0
 Summary: Voice control for Linux desktops. Fully local, no cloud, Wayland-native.
 Author-email: Matt Hartley <matt@matthartley.com>
 Maintainer-email: Matt Hartley <matt@matthartley.com>
@@ -24,19 +24,28 @@ Requires-Python: <3.14,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: faster-whisper>=1.2.1
+Requires-Dist: jeepney>=0.9
 Requires-Dist: numpy>=2.2.6
 Requires-Dist: onnxruntime>=1.23.2
 Requires-Dist: onnxruntime<1.24; python_full_version < "3.11"
 Requires-Dist: pyaudio>=0.2.14
+Provides-Extra: acceptance
+Requires-Dist: pytest>=8; extra == "acceptance"
+Requires-Dist: pytest-bdd>=7; extra == "acceptance"
 Provides-Extra: benchmark
 Requires-Dist: pytest>=8; extra == "benchmark"
 Requires-Dist: pytest-benchmark>=5; extra == "benchmark"
 Provides-Extra: head-tracking
 Requires-Dist: opencv-python>=4.13.0.90; extra == "head-tracking"
 Requires-Dist: sixdrepnet>=0.1.6; extra == "head-tracking"
+Provides-Extra: integration
+Requires-Dist: pytest>=8; extra == "integration"
 Provides-Extra: mypy
 Requires-Dist: mypy>=1.19.1; extra == "mypy"
 Requires-Dist: types-pyaudio>=0.2.16.20250801; extra == "mypy"
+Provides-Extra: unittest
+Requires-Dist: coverage[toml]>=7.14; extra == "unittest"
+Requires-Dist: pytest>=8; extra == "unittest"
 Dynamic: license-file
 
 # EasySpeak [![PyPI](https://img.shields.io/pypi/v/easyspeak-linux)](https://pypi.org/project/easyspeak-linux/)
@@ -196,7 +205,10 @@ easyspeak                              # the project execution script
 
 Activate the venv each time you open a new terminal.
 
-Say "Hey Jarvis" followed by a command.
+Say "Hey Jarvis" followed by a command. After a command that gives no spoken
+reply (such as volume changes), EasySpeak keeps listening for a few seconds so
+you can chain commands — say "louder", "louder", "louder" without repeating the
+wake word each time.
 
 ## Commands
 
@@ -315,9 +327,10 @@ Built-in bookmarks: youtube, google, gmail, github, reddit, twitter, facebook, a
 | close [app] | Close application |
 
 Default apps in `plugins/apps.py` (edit to match your system):
-- firefox, steam, spotify, calculator, settings, files, terminal, browser
+- firefox, steam, spotify, calculator, settings, files, terminal, browser, music player
 
-These are just examples. Edit `apps.py` to add your own apps.
+These are just examples. Edit `apps.py` to add your own apps. Some accept
+spoken aliases — e.g. "open music app" works the same as "open music player".
 
 ### Files
 
@@ -328,6 +341,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | open pictures | Open Pictures folder |
 | open music | Open Music folder |
 | open videos | Open Videos folder |
+| open projects | Open Projects folder |
 | open home | Open home folder |
 | open desktop | Open Desktop folder |
 
@@ -336,7 +350,7 @@ These are just examples. Edit `apps.py` to add your own apps.
 | Command | Action |
 |---------|--------|
 | play | Resume playback |
-| pause | Pause playback |
+| pause / stop the music | Pause playback |
 | next / skip | Next track |
 | previous / back | Previous track |
 
@@ -344,30 +358,35 @@ These are just examples. Edit `apps.py` to add your own apps.
 
 | Command | Action |
 |---------|--------|
-| volume up/down | Adjust volume |
+| volume up/down (or louder / quieter) | Adjust volume one step (repeat to keep going) |
+| very loud / very silent | Jump straight to near-max (85%) / low (15%, not muted) |
 | mute | Toggle mute |
 | brightness up/down | Adjust brightness |
 | do not disturb on/off | Toggle notifications |
 
+Volume changes are silent — GNOME's own on-screen display and chime acknowledge them.
+
 ### General
 
 | Command | Action |
 |---------|--------|
 | help | List all commands |
-| stop / exit / quit | Exit EasySpeak |
+| go to sleep / stop listening | Release the mic (reactivate from the tray icon) |
+| quit / exit / goodbye | Exit EasySpeak |
 
 ## File Structure
 
 ```
 easyspeak/
-├── extension.js               # GNOME Shell extension
-├── metadata.json              # Extension metadata
 ├── pyproject.toml
 ├── src
+│   ├── extension.js           # GNOME Shell extension (bundled as package data)
+│   ├── metadata.json          # Extension metadata
 │   ├── core
 │   │   ├── __init__.py
 │   │   ├── __main__.py
 │   │   ├── config.py          # Tuning constants + Whisper model factory
+│   │   ├── gnome_extension.py  # Installs/refreshes/enables the extension
 │   │   └── main.py            # EasySpeak class + main loop
 │   └── plugins
 │       ├── __init__.py
@@ -386,9 +405,9 @@ easyspeak/
     └── plugins                # tests for src/plugins/
 ```
 
-On first start, the `mousegrid` plugin auto-installs the GNOME Shell
-extension to the user-local extensions directory (unless GNOME already
-sees it via a system-wide install). Files copied:
+On first start, core auto-installs the GNOME Shell extension to the
+user-local extensions directory (unless GNOME already sees it via a
+system-wide install). Files copied:
 
 ```
 ~/.local/share/gnome-shell/extensions/easyspeak-grid@local/
@@ -444,11 +463,12 @@ def handle(cmd, core):
 
 **Mouse grid: "Failed to show grid — is extension enabled?"**
 
-EasySpeak auto-installs the GNOME Shell extension to
-`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` on first
-run (look for a `mousegrid: installed ...` message at startup). On
-Wayland, GNOME Shell only scans for new extensions at login, so you
-typically have to **log out and back in** before it becomes loadable.
+You don't install the extension yourself — EasySpeak does it automatically
+on startup, copying it to
+`~/.local/share/gnome-shell/extensions/easyspeak-grid@local/` and keeping it
+up to date (look for an `easyspeak: installed ...` or `easyspeak: updated ...`
+message). On Wayland, GNOME Shell only scans for new extensions at login, so
+you typically have to **log out and back in** before it becomes loadable.
 
 After re-login, enable it from the command line:
 

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/easyspeak_linux.egg-info/SOURCES.txt

@@ -1,9 +1,6 @@
 .gitignore
-CONTRIBUTING.md
 LICENSE
 README.md
-flake.lock
-flake.nix
 pyproject.toml
 uv.lock
 .github/actions/benchmark/action.yml
@@ -17,10 +14,17 @@ easyspeak_linux.egg-info/dependency_links.txt
 easyspeak_linux.egg-info/entry_points.txt
 easyspeak_linux.egg-info/requires.txt
 easyspeak_linux.egg-info/top_level.txt
+src/extension-helpers.js
+src/extension.js
+src/metadata.json
 src/core/__init__.py
 src/core/__main__.py
 src/core/config.py
+src/core/gnome_extension.py
 src/core/main.py
+src/core/mediakeys.py
+src/core/speech.py
+src/core/tray.py
 src/plugins/00_eyetrack.py
 src/plugins/00_mousegrid.py
 src/plugins/__init__.py
@@ -29,5 +33,6 @@ src/plugins/browser.py
 src/plugins/dictation.py
 src/plugins/files.py
 src/plugins/media.py
+src/plugins/sleep.py
 src/plugins/system.py
 src/plugins/zz_base.py

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/easyspeak_linux.egg-info/requires.txt

@@ -1,4 +1,5 @@
 faster-whisper>=1.2.1
+jeepney>=0.9
 numpy>=2.2.6
 onnxruntime>=1.23.2
 pyaudio>=0.2.14
@@ -6,6 +7,10 @@ pyaudio>=0.2.14
 [:python_full_version < "3.11"]
 onnxruntime<1.24
 
+[acceptance]
+pytest>=8
+pytest-bdd>=7
+
 [benchmark]
 pytest>=8
 pytest-benchmark>=5
@@ -14,6 +19,13 @@ pytest-benchmark>=5
 opencv-python>=4.13.0.90
 sixdrepnet>=0.1.6
 
+[integration]
+pytest>=8
+
 [mypy]
 mypy>=1.19.1
 types-pyaudio>=0.2.16.20250801
+
+[unittest]
+coverage[toml]>=7.14
+pytest>=8

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/pyproject.toml

@@ -43,6 +43,7 @@ readme = "README.md"
 requires-python = ">=3.10, <3.14"
 dependencies = [
   "faster-whisper>=1.2.1",
+  "jeepney>=0.9",
   "numpy>=2.2.6",
   # "openwakeword",  # requires Python <3.13 for speexdsp-ns (missing wheels)
   "onnxruntime>=1.23.2",
@@ -51,6 +52,10 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+acceptance = [
+  "pytest>=8",
+  "pytest-bdd>=7",
+]
 benchmark = [
   "pytest>=8",
   "pytest-benchmark>=5",
@@ -59,10 +64,17 @@ head-tracking = [
   "opencv-python>=4.13.0.90",
   "sixdrepnet>=0.1.6",
 ]
+integration = [
+  "pytest>=8",
+]
 mypy = [
   "mypy>=1.19.1",
   "types-pyaudio>=0.2.16.20250801",
 ]
+unittest = [
+  "coverage[toml]>=7.14",
+  "pytest>=8",
+]
 
 [project.scripts]
 easyspeak = "easyspeak.core.main:run"
@@ -72,6 +84,7 @@ easyspeak = "easyspeak.core.main:run"
 
 [tool.coverage.report]
 exclude_also = ["if __name__ == .__main__.:"]
+fail_under = 99
 show_missing = true
 
 [tool.coverage.run]
@@ -84,9 +97,13 @@ warn_unreachable = true
 warn_unused_ignores = true
 
 [tool.pytest.ini_options]
-# Whisper benchmarks download large models and take minutes; opt-in only.
-# Run them with `just benchmark` or `pytest tests/benchmarks/`.
-addopts = "--ignore=tests/benchmarks"
+# Folders excluded from default discovery are opt-in: they need preparation
+# the plain unit run doesn't (large model downloads, real external binaries,
+# an audio server). Each has its own `just` target.
+#   tests/acceptance  -> `just acceptance`  (Gherkin scenarios; needs pytest-bdd)
+#   tests/benchmarks  -> `just benchmark`   (downloads large Whisper models)
+#   tests/integration -> `just integration` (runs real piper/audio-player binaries)
+addopts = "--ignore=tests/acceptance --ignore=tests/benchmarks --ignore=tests/integration"
 
 [tool.ruff.lint]
 extend-select = ["I"]  # "ALL" one day
@@ -95,6 +112,12 @@ extend-ignore = ["D", "E722"]
 [tool.setuptools.package-dir]
 easyspeak = "src"
 
+# The bundled GNOME Shell extension is package data: core.gnome_extension
+# copies it into the user's extensions directory at startup, so it must ship
+# inside the wheel (alongside the easyspeak package), not just the sdist.
+[tool.setuptools.package-data]
+easyspeak = ["extension.js", "extension-helpers.js", "metadata.json"]
+
 [tool.setuptools_scm]
 local_scheme = "no-local-version"
 

{easyspeak_linux-0.2.0 → easyspeak_linux-0.3.0}/src/core/config.py

@@ -18,6 +18,9 @@ WAKE_COOLDOWN = 3.0  # Seconds to ignore wake word after trigger
 SILENCE_THRESHOLD = 300
 SILENCE_DURATION = 0.3
 
+MISUNDERSTAND_GRACE = 4.0  # Seconds to ignore repeat misses after feedback
+FOLLOWUP_IDLE_ROUNDS = 2  # Quiet listens tolerated before a command session ends
+
 # --- Models ---
 PIPER_MODEL = os.environ.get(
     "EASYSPEAK_PIPER_MODEL",