agentvibes 5.1.3 → 5.2.0

package/.claude/hooks-windows/verbosity-manager.ps1

@@ -1,119 +1,126 @@
-#
-# File: .claude/hooks-windows/verbosity-manager.ps1
-#
-# AgentVibes - Finally, your AI Agents can Talk Back!
-# Website: https://agentvibes.org
-# Copyright (c) 2025 Paul Preibisch
-# Licensed under the Apache License, Version 2.0
-
-param(
-    [Parameter(Position=0)]
-    [string]$Command = "info",
-    [Parameter(Position=1)]
-    [string]$Arg1 = ""
-)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ClaudeDir = Split-Path -Parent $ScriptDir
-
-# Respect CLAUDE_PROJECT_DIR when set by MCP
-if ($env:CLAUDE_PROJECT_DIR) {
-    $ConfigClaudeDir = Join-Path $env:CLAUDE_PROJECT_DIR ".claude"
-} else {
-    $ConfigClaudeDir = $ClaudeDir
-}
-
-$VerbosityFile = Join-Path $ConfigClaudeDir "tts-verbosity.txt"
-$GlobalVerbosityFile = Join-Path $env:USERPROFILE ".claude\tts-verbosity.txt"
-
-function Get-Verbosity {
-    if (Test-Path $VerbosityFile) {
-        return (Get-Content $VerbosityFile -Raw).Trim()
-    }
-    if (Test-Path $GlobalVerbosityFile) {
-        return (Get-Content $GlobalVerbosityFile -Raw).Trim()
-    }
-    return "high"
-}
-
-function Set-Verbosity {
-    param([string]$Level)
-
-    if ($Level -notmatch '^(low|medium|high)$') {
-        Write-Output "Invalid verbosity level: $Level"
-        Write-Output "Valid options: low, medium, high"
-        exit 1
-    }
-
-    if (Test-Path $ConfigClaudeDir) {
-        Set-Content -Path $VerbosityFile -Value $Level -NoNewline
-        Write-Output "Verbosity set to: $Level (project-local)"
-    } else {
-        $globalDir = Split-Path -Parent $GlobalVerbosityFile
-        if (-not (Test-Path $globalDir)) { New-Item -ItemType Directory -Path $globalDir -Force | Out-Null }
-        Set-Content -Path $GlobalVerbosityFile -Value $Level -NoNewline
-        Write-Output "Verbosity set to: $Level (global)"
-    }
-
-    Write-Output ""
-    Write-Output "Verbosity levels:"
-    Write-Output "   LOW: Acknowledgments + Completions only"
-    Write-Output "   MEDIUM: + Major decisions and findings"
-    Write-Output "   HIGH: All reasoning (maximum transparency)"
-    Write-Output ""
-    Write-Output "Restart Claude Code for changes to take effect"
-}
-
-function Show-Info {
-    $currentLevel = Get-Verbosity
-
-    Write-Output "AgentVibes Verbosity Control"
-    Write-Output "------------------------------------"
-    Write-Output "Current level: $currentLevel"
-    Write-Output ""
-    Write-Output "Available levels:"
-    Write-Output ""
-    Write-Output "LOW (Minimal)"
-    Write-Output "  Acknowledgments only"
-    Write-Output "  Completions only"
-    Write-Output "  No reasoning spoken"
-    Write-Output ""
-    Write-Output "MEDIUM (Balanced)"
-    Write-Output "  Acknowledgments"
-    Write-Output "  Major decisions"
-    Write-Output "  Key findings"
-    Write-Output "  Completions"
-    Write-Output ""
-    Write-Output "HIGH (Maximum Transparency)"
-    Write-Output "  Acknowledgments"
-    Write-Output "  All reasoning"
-    Write-Output "  All decisions"
-    Write-Output "  All findings"
-    Write-Output "  Completions"
-    Write-Output ""
-    Write-Output "Usage:"
-    Write-Output "  verbosity-manager.ps1 get              Show current level"
-    Write-Output "  verbosity-manager.ps1 set low|medium|high  Change level"
-}
-
-switch ($Command) {
-    "get" {
-        Write-Output (Get-Verbosity)
-    }
-    "set" {
-        if (-not $Arg1) {
-            Write-Output "Error: Missing verbosity level"
-            Write-Output "Usage: verbosity-manager.ps1 set low|medium|high"
-            exit 1
-        }
-        Set-Verbosity $Arg1
-    }
-    { $_ -in "info", "" } {
-        Show-Info
-    }
-    default {
-        Write-Output "Unknown command: $Command"
-        Write-Output "Usage: verbosity-manager.ps1 {get|set|info} [level]"
-        exit 1
-    }
-}
+#
+# File: .claude/hooks-windows/verbosity-manager.ps1
+#
+# AgentVibes - Finally, your AI Agents can Talk Back!
+# Website: https://agentvibes.org
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+
+param(
+    [Parameter(Position=0)]
+    [string]$Command = "info",
+    [Parameter(Position=1)]
+    [string]$Arg1 = ""
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ClaudeDir = Split-Path -Parent $ScriptDir
+
+# Respect CLAUDE_PROJECT_DIR when set by MCP
+if ($env:CLAUDE_PROJECT_DIR) {
+    $ConfigClaudeDir = Join-Path $env:CLAUDE_PROJECT_DIR ".claude"
+} else {
+    $ConfigClaudeDir = $ClaudeDir
+}
+
+$VerbosityFile = Join-Path $ConfigClaudeDir "tts-verbosity.txt"
+$GlobalVerbosityFile = Join-Path $env:USERPROFILE ".claude\tts-verbosity.txt"
+
+function Get-Verbosity {
+    if (Test-Path $VerbosityFile) {
+        return (Get-Content $VerbosityFile -Raw).Trim()
+    }
+    if (Test-Path $GlobalVerbosityFile) {
+        return (Get-Content $GlobalVerbosityFile -Raw).Trim()
+    }
+    return "high"
+}
+
+function Set-Verbosity {
+    param([string]$Level)
+
+    if ($Level -notmatch '^(low|medium|high|caveman)$') {
+        Write-Output "Invalid verbosity level: $Level"
+        Write-Output "Valid options: low, medium, high, caveman"
+        exit 1
+    }
+
+    if (Test-Path $ConfigClaudeDir) {
+        Set-Content -Path $VerbosityFile -Value $Level -NoNewline
+        Write-Output "Verbosity set to: $Level (project-local)"
+    } else {
+        $globalDir = Split-Path -Parent $GlobalVerbosityFile
+        if (-not (Test-Path $globalDir)) { New-Item -ItemType Directory -Path $globalDir -Force | Out-Null }
+        Set-Content -Path $GlobalVerbosityFile -Value $Level -NoNewline
+        Write-Output "Verbosity set to: $Level (global)"
+    }
+
+    Write-Output ""
+    Write-Output "Verbosity levels:"
+    Write-Output "   LOW: Acknowledgments + Completions only"
+    Write-Output "   MEDIUM: + Major decisions and findings"
+    Write-Output "   HIGH: All reasoning (maximum transparency)"
+    Write-Output "   CAVEMAN: Ultra-terse fragments, max token savings"
+    Write-Output ""
+    Write-Output "Restart Claude Code for changes to take effect"
+}
+
+function Show-Info {
+    $currentLevel = Get-Verbosity
+
+    Write-Output "AgentVibes Verbosity Control"
+    Write-Output "------------------------------------"
+    Write-Output "Current level: $currentLevel"
+    Write-Output ""
+    Write-Output "Available levels:"
+    Write-Output ""
+    Write-Output "LOW (Minimal)"
+    Write-Output "  Acknowledgments only"
+    Write-Output "  Completions only"
+    Write-Output "  No reasoning spoken"
+    Write-Output ""
+    Write-Output "MEDIUM (Balanced)"
+    Write-Output "  Acknowledgments"
+    Write-Output "  Major decisions"
+    Write-Output "  Key findings"
+    Write-Output "  Completions"
+    Write-Output ""
+    Write-Output "HIGH (Maximum Transparency)"
+    Write-Output "  Acknowledgments"
+    Write-Output "  All reasoning"
+    Write-Output "  All decisions"
+    Write-Output "  All findings"
+    Write-Output "  Completions"
+    Write-Output ""
+    Write-Output "CAVEMAN (Ultra-Terse)"
+    Write-Output "  Fragments only, no filler"
+    Write-Output "  65-75% fewer output tokens"
+    Write-Output "  Abbreviations (DB/auth/config/fn/impl)"
+    Write-Output "  Arrows instead of prose (X -> Y)"
+    Write-Output ""
+    Write-Output "Usage:"
+    Write-Output "  verbosity-manager.ps1 get              Show current level"
+    Write-Output "  verbosity-manager.ps1 set low|medium|high|caveman  Change level"
+}
+
+switch ($Command) {
+    "get" {
+        Write-Output (Get-Verbosity)
+    }
+    "set" {
+        if (-not $Arg1) {
+            Write-Output "Error: Missing verbosity level"
+            Write-Output "Usage: verbosity-manager.ps1 set low|medium|high|caveman"
+            exit 1
+        }
+        Set-Verbosity $Arg1
+    }
+    { $_ -in "info", "" } {
+        Show-Info
+    }
+    default {
+        Write-Output "Unknown command: $Command"
+        Write-Output "Usage: verbosity-manager.ps1 {get|set|info} [level]"
+        exit 1
+    }
+}

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.1.3
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.2.0
 
 ---
 
@@ -43,6 +43,29 @@ Whether you're using Claude Code, GitHub Copilot, OpenAI Codex, Claude Desktop,
 
 ---
 
+## 🎯 NEW IN v5.2.0 — Remote Voice Preview + Caveman Mode + Voice Ratings
+
+- **Caveman verbosity mode** — Ultra-terse TTS fragments. Set via `/agent-vibes:verbosity caveman`.
+- **👍/👎 voice ratings** — Press `+` to thumbs up, `-` to thumbs down in any voice list. Replaces star favorites.
+- **Remote voice preview** — TUI voice preview works on headless servers via SSH receiver. No local audio needed.
+- **SSH receiver routing** — `ssh-remote` and `agentvibes-receiver` are now first-class providers.
+- **Voice validation hardened** — Multi-speaker `::` format, cross-platform base64, no backslash injection.
+
+## 🛡️ v5.1.4 — TTS Resilience Overhaul + Default LLM Provider
+
+- **Default LLM provider** — New fallback entry at the bottom of Setup → Providers. Config-only; opens the standard Configure modal. Used when a tool calls TTS without identifying its LLM.
+- **Per-LLM background music auto-enables** — Setting a bg track on the per-LLM Configure modal actually plays it now (no need to also toggle global bg music).
+- **Copilot CLI support** — `installCopilotMcp` now writes both `.vscode/mcp.json` (Copilot Chat) AND `~/.copilot/mcp-config.json` (Copilot CLI — different product, different config path).
+- **Per-client routing architecture** — `.mcp.json` no longer sets `AGENTVIBES_LLM`. Claude Code is auto-detected via `CLAUDECODE=1` env var. Copilot CLI reads its own global config. No more client config conflicts.
+- **Self-healing TTS mutex** — When a stuck `play-tts.ps1` process blocks the playback queue, the next caller auto-kills it (no manual `taskkill` needed). 25-second watchdog guarantees forward progress.
+- **No more stale audio replay** — `play-tts.ps1` captures the exact synth output filename from provider stdout instead of guessing "most recent `tts-*.wav`". Silent replay of old audio is gone.
+- **Per-LLM voice wins over explicit `VoiceOverride`** — LLMs echo back `get_config` results on every call, which was overriding per-LLM routing. Fixed.
+- **`lessac-medium` → `lessac-high`** default for codex — Silent synthesis failure workaround.
+- **Scratch file rename + ASCII-only encoding** — Eliminates accumulating compound audio files and CP1252 parse errors on Windows.
+- **Setup → Install confirmation** now advances focus to the next provider row (Install → Install → Install flow).
+
+---
+
 ## 🛡️ v5.1.3 — Hardening Pass (Adversarial Review Followup)
 
 - **Existing `.mcp.json` is now auto-migrated** — v5.1.2's installer detected an existing `.mcp.json` and printed instructions instead of fixing it, leaving v5.1.0/v5.1.1 users still broken after upgrade. v5.1.3 merges the `AGENTVIBES_LLM` env var into existing configs in-place.

package/RELEASE_NOTES.md

@@ -1,5 +1,118 @@
 # AgentVibes Release Notes
 
+## 🎯 v5.2.0 — Remote Voice Preview + Caveman Mode + Voice Ratings
+
+**Release Date:** April 2026
+
+This release adds remote TTS preview support, a new ultra-terse verbosity mode, and thumbs up/down voice ratings across the TUI.
+
+### New Features
+
+- **Caveman verbosity mode** — New `caveman` verbosity level for ultra-terse TTS output. Fragments instead of sentences. Set via `/agent-vibes:verbosity caveman` or the MCP `set_verbosity` tool. Auto-downloads a voice on fresh install if none are present.
+
+- **Thumbs up/down voice ratings** — Replace the old star favorites with 👍/👎 ratings. Press `+` to thumbs up, `-` to thumbs down in both the Voices tab and the voice picker (Setup tab). Ratings persist across sessions and are shared between all voice selection UIs.
+
+- **Remote voice preview** — Voice preview in the TUI Voices tab, voice picker, and voice browser now works on headless servers. When the active provider is `ssh-remote` or `agentvibes-receiver`, preview routes through `play-tts.sh` to play audio on the remote receiver instead of requiring local Piper + audio player. Platform-aware: uses PowerShell on Windows, bash on Linux.
+
+- **SSH receiver provider routing** — `ssh-remote` and `agentvibes-receiver` are now first-class providers in `play-tts.sh`. Both the `speak_text()` function and the main routing case statement support them, eliminating "Unknown provider" errors.
+
+### Fixes
+
+- **Auto-patch LibriTTS speaker names** — Voice download now auto-patches LibriTTS speaker names so multi-speaker voices work correctly out of the box.
+
+- **Voice validation regex hardened** — The VOICE parameter regex in `play-tts-ssh-remote.sh` and `play-tts-agentvibes-receiver.sh` now allows `::` (multi-speaker), `.` (locale), and spaces (speaker names) without accepting backslash (injection risk). Linux and Windows receiver templates updated to match.
+
+- **`base64` cross-platform compatibility** — `play-tts-agentvibes-receiver.sh` now probes for GNU `base64 -w 0`, falls back to BSD `-b 0`, then `tr -d '\n'`. Fixes script abort on macOS/BSD systems.
+
+- **Audio effects double-processing fix** — `play-tts-piper.ps1` skips its own audio-processor call when `AGENTVIBES_NO_PLAY` is set, preventing reverb/music from being applied twice.
+
+- **Exit code leak fix** — `play-tts.ps1` now exits with code 0 explicitly, preventing native command exit codes (piper, ffmpeg, sox) from leaking through and causing false TTS failure reports.
+
+- **Windows receiver-tab platform support** — Tailscale IP detection, local IP via PowerShell, sshd_config reading, and clipboard copy all work natively on Windows now.
+
+- **`llm:default` audio effects row** — New default row in `audio-effects.cfg` ensures remote receivers get reverb, music, and pretext even without a per-LLM config entry.
+
+- **Preview sample text** — Changed from "Here is a preview of your audio settings" to avoid Piper pronunciation glitch on the word "preview".
+
+---
+
+## 🛡️ v5.1.4 — TTS Resilience Overhaul + Default LLM Provider + Per-Client Routing
+
+**Release Date:** April 2026
+
+This release closes a long-running cluster of bugs around per-LLM TTS routing, parallel audio playback, stuck-process deadlocks, and stale-audio replay. It also adds a new "Default" provider slot in the Setup tab for fallback audio configuration, and switches to a per-client config scheme that correctly routes Claude Code, GitHub Copilot (Chat + CLI), and OpenAI Codex to their own voices and pretexts.
+
+### New Features
+
+- **Default LLM provider** — New entry at the bottom of Setup → Providers. Config-only (no install/remove buttons) with a Configure button that opens the standard per-LLM audio modal. When any tool calls TTS without identifying its LLM, the `llm:default` row in `audio-effects.cfg` provides the fallback voice, pretext, music, reverb, and engine. Empty pretext by default — users opt in.
+
+- **Per-LLM background music now auto-enables** — Setting a `bg_track` on any per-LLM Configure modal now actually plays that track. Previously you also had to toggle the global `backgroundMusic.enabled` flag, which made the per-LLM bg track field silently dead.
+
+- **Copilot CLI support** — `installCopilotMcp` now writes BOTH `.vscode/mcp.json` (for VS Code Copilot Chat) AND `~/.copilot/mcp-config.json` (for the standalone `copilot` CLI, which is a different product). Fresh installs support both tools automatically.
+
+### Per-Client Routing Architecture
+
+Previously `AGENTVIBES_LLM=claude-code` was set in `.mcp.json`, which broke Copilot CLI because Copilot CLI also reads `.mcp.json` with precedence over its own `~/.copilot/mcp-config.json` — so it adopted Claude Code's env and mis-routed.
+
+The new architecture splits per-LLM identification per-client:
+
+- `.mcp.json` (project) has **no `AGENTVIBES_LLM` env block**
+- `~/.copilot/mcp-config.json` sets `AGENTVIBES_LLM=copilot` for GitHub Copilot CLI
+- `~/.codex/config.toml` sets `AGENTVIBES_LLM=codex` for OpenAI Codex
+- The MCP server (`mcp-server/server.py`) **auto-detects Claude Code** via the `CLAUDECODE=1` env var that Claude Code sets on every subprocess it spawns. Copilot CLI and Codex don't set this var, so each client reliably routes to its own config.
+
+Upgrade path: re-run the AgentVibes installer in any existing project. The new `installClaudeMcp` auto-strips any stale `AGENTVIBES_LLM` env block from existing `.mcp.json` files so Copilot CLI stops mis-routing.
+
+### TTS Resilience Overhaul (`play-tts.ps1`)
+
+- **Cross-process playback mutex** — `AgentVibesPlaybackLock` (named mutex) serializes playback across all callers: Claude Code hooks, MCP `text_to_speech`, direct CLI, party mode. No more overlapping or parallel audio when multiple LLMs run in the same project.
+
+- **Self-healing on mutex timeout** — When the 15-second mutex acquisition fails, the new code queries `Win32_Process` for any stuck `play-tts.ps1` process older than 20 seconds, calls `Stop-Process -Force` on each, and logs the kill to stderr. The next TTS call succeeds immediately — no manual `taskkill` needed.
+
+- **25-second script watchdog** — A sibling PowerShell job force-kills `play-tts.ps1` after 25 seconds regardless of where it's stuck (SoundPlayer deadlock, locked audio device, zombie ffmpeg). Guarantees forward progress.
+
+- **Hard error on mutex timeout** — Replaces the old "play anyway" fallback which just stacked more stuck processes behind the first. Now exits cleanly with code 2 and a diagnostic message.
+
+- **Exact filename capture from provider stdout** — `play-tts.ps1` parses the `[OK] Saved to: <path>` line from `play-tts-piper.ps1` and uses that exact file. Replaces the old "pick most recent `tts-*.wav` in the audio dir" heuristic which silently replayed stale audio from earlier sessions whenever synthesis failed. Root cause of the "Codex speaks Claude Code's audio" bug.
+
+- **Synthesis-failure hard error** — When the provider doesn't produce an output file, `play-tts.ps1` exits with code 3 and a loud error instead of falling back to any older file in the cache.
+
+- **Scratch file rename** — Reverb post-processing now writes to `av-reverbed-scratch.wav` and mix post-processing writes to `av-mixed-scratch.wav`. Fixed names outside the `tts-XXXXXXXX` random namespace so the file lookup can never pick them up as a synth input. Eliminates the compound `tts-xxx.wav.effected-mixed-mixed-mixed-mixed.wav` chain that accumulated on every run.
+
+- **Per-LLM voice overrides explicit `VoiceOverride`** — LLMs call `get_config` at session start and echo the returned voice back on every `text_to_speech` call as an explicit MCP parameter. With the old "explicit wins" priority, that global voice overrode per-LLM routing. Now the `llm:<key>` voice row always wins when `-llm` is set.
+
+- **`$LlmBgTrack` and `$LlmBgVolume` parsed from cfg row** — Previously fields 2 and 3 of the `llm:<key>` line were ignored in the PowerShell version (the bash version already parsed them).
+
+- **Per-LLM `bg_track` force-enables `$BgEnabled`** — When a per-LLM row specifies a background track, it's auto-enabled regardless of the global `backgroundMusic.enabled` flag.
+
+- **ASCII-only encoding** — Removed em-dash `—` and right-arrow `→` from `play-tts.ps1`. PowerShell on some Windows locales loads scripts in CP1252 and choked on the UTF-8 bytes with a misleading "Missing closing `}`" parse error.
+
+- **`lessac-medium` → `lessac-high` default for codex** — `en_US-lessac-medium` silently fails to synthesize on some Windows Piper installs (loads the model, exits with empty output). `lessac-high` works reliably and is the new default in `DEFAULT_LLM_CONFIGS.codex` and the packaged `audio-effects.cfg`.
+
+### UX Improvements
+
+- **Setup → Providers Install confirmation** — Pressing Enter to dismiss the post-install confirmation page now advances focus to the NEXT provider row's same-column button (Install → Install, Configure → Configure), instead of snapping back to Claude Code's Install. Installing all three providers is now a natural Enter-Enter-Enter flow.
+
+### Testing & Hardening
+
+- **30 new/updated regression tests** in `test/unit/llm-provider-mcp-routing.test.js` and `test/unit/windows-tts.test.js` covering:
+  - Default LLM provider config shape + setup-tab wiring
+  - `CLAUDECODE` auto-detection in `server.py`
+  - `.mcp.json` template MUST NOT contain `AGENTVIBES_LLM`
+  - `~/.copilot/mcp-config.json` writer in `installCopilotMcp`
+  - `play-tts.ps1` PowerShell-parseable (catches em-dash / encoding regressions via `[System.Management.Automation.Language.Parser]`)
+
+### How to Update
+
+```
+npm cache clean --force
+npx --yes agentvibes@5.1.4
+```
+
+If you have any existing project with AgentVibes installed, re-run the installer there once so the per-client config migration takes effect. The `.mcp.json` in each project will be auto-upgraded to strip the stale `AGENTVIBES_LLM` env block, and `~/.copilot/mcp-config.json` will be created if you have the Copilot provider enabled.
+
+---
+
 ## 🛡️ v5.1.3 — Hardening Pass (Adversarial Review Followup)
 
 **Release Date:** April 2026