agentvibes 5.7.7 → 5.10.1

package/.agentvibes/config.json

@@ -1,5 +1,3 @@
 {
-  "audio_destination": "remote",
-  "audio_ssh_alias": "laptop-win",
   "setupCompleted": true
 }

package/.claude/config/audio-effects.cfg

@@ -1,6 +1,6 @@
 
 llm:default|light||0.15|en_US-lessac-high||piper
-llm:claude-code|light|agent_vibes_celtic_harp_v1_loop.mp3|0.05|en_US-libritts-high::Nina-13|agentvibes here|piper
-llm:copilot|light|agent_vibes_bossa_nova_v2_loop.mp3|0.15|en_US-libritts-high::Anna-11|Copilot here|piper
-llm:codex|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high|Codex here|piper
-llm:hermes|light|agent_vibes_bachata_v1_loop.mp3|0.15|en_US-libritts-high::Leo-8|Hermes here|piper
+llm:claude-code|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high||piper
+llm:copilot|light|agent_vibes_bossa_nova_v2_loop.mp3|0.15|en_US-libritts-high::Anna-11||piper
+llm:codex|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high||piper
+llm:hermes|light|agent_vibes_bachata_v1_loop.mp3|0.15|en_US-libritts-high::Leo-8||piper

package/.claude/config/background-music-enabled.txt

@@ -0,0 +1 @@
+true

package/.claude/github-star-reminder.txt

@@ -1 +1 @@
-20260517
+20260525

package/.claude/hooks/play-tts-piper.sh

@@ -73,10 +73,8 @@ TEXT=$(printf '%s' "$TEXT" | perl -CSD -pe '
   s/^\s*[-]\s*//g;                # list dashes
 ')
 
-# Source voice manager and language manager
-# Use readlink -f to handle symlinks correctly
-SCRIPT_PATH="$(readlink -f "${BASH_SOURCE[0]}")"
-SCRIPT_DIR="$(dirname "$SCRIPT_PATH")"
+# cd-based resolution works on macOS (BSD readlink lacks -f) and Linux alike
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 source "$SCRIPT_DIR/piper-voice-manager.sh"
 source "$SCRIPT_DIR/language-manager.sh"
 source "$SCRIPT_DIR/audio-cache-utils.sh"
@@ -226,11 +224,19 @@ if [[ -z "$TEXT" ]]; then
 fi
 
 # Augment PATH for non-interactive shells (pipx installs to ~/.local/bin which
-# interactive shells get via .bashrc/.zshrc, but Bash tool calls skip profile)
+# interactive shells get via .bashrc/.zshrc, but Bash tool calls skip profile).
+# Mac: add both Apple Silicon (/opt/homebrew) and Intel (/usr/local) Homebrew locations.
 export PATH="$HOME/.local/bin:$HOME/.local/share/pipx/venvs/piper-tts/bin:$PATH"
+if [[ "$(uname -s 2>/dev/null)" == "Darwin" ]]; then
+  export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
+fi
+
+# Resolve explicit piper binary path — avoids bare `piper` invocation failing when
+# PATH augmentation above hasn't propagated into nested subshells.
+PIPER_BIN=$(command -v piper 2>/dev/null || echo "")
 
 # Check if Piper is installed
-if ! command -v piper &> /dev/null; then
+if [[ -z "$PIPER_BIN" ]]; then
   echo "❌ Error: Piper TTS not installed"
   echo "Install with: pipx install piper-tts"
   echo "Or run: .claude/hooks/piper-installer.sh"
@@ -309,6 +315,8 @@ else
 fi
 
 mkdir -p "$AUDIO_DIR"
+# Normalize to canonical path (handles Git Bash /tmp→/c/Users/..., macOS /var→/private/var)
+AUDIO_DIR=$(cd "$AUDIO_DIR" && pwd -P)
 _tmp=$(mktemp "$AUDIO_DIR/tts-XXXXXX"); TEMP_FILE="${_tmp}.wav"; mv "$_tmp" "$TEMP_FILE"
 
 # @function get_speech_rate
@@ -380,6 +388,10 @@ get_speech_rate() {
 
 SPEECH_RATE=$(get_speech_rate)
 
+# Ensure piper log directory exists so stderr redirect never silently fails
+_PIPER_LOG_DIR="${AGENTVIBES_LOG_DIR:-$HOME/.local/state/agentvibes/logs}"
+mkdir -p "$_PIPER_LOG_DIR" 2>/dev/null || true
+
 # @function synthesize_with_piper
 # @intent Generate speech using Piper TTS
 # @why Provides free, offline TTS alternative
@@ -391,10 +403,10 @@ SPEECH_RATE=$(get_speech_rate)
 if [[ -n "${SPEAKER_ID:-}" ]]; then
   # Multi-speaker voice: Pass speaker ID
   # SECURITY: Use printf instead of echo for pipe safety (#134)
-  printf '%s\n' "$TEXT" | piper --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --length-scale "$SPEECH_RATE" --sentence-silence 2.0 --output_file "$TEMP_FILE" 2>/dev/null
+  printf '%s\n' "$TEXT" | "$PIPER_BIN" --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --length-scale "$SPEECH_RATE" --sentence-silence 2.0 --output_file "$TEMP_FILE" 2>>"$_PIPER_LOG_DIR/piper.log"
 else
   # Single-speaker voice
-  printf '%s\n' "$TEXT" | piper --model "$VOICE_PATH" --length-scale "$SPEECH_RATE" --sentence-silence 2.0 --output_file "$TEMP_FILE" 2>/dev/null
+  printf '%s\n' "$TEXT" | "$PIPER_BIN" --model "$VOICE_PATH" --length-scale "$SPEECH_RATE" --sentence-silence 2.0 --output_file "$TEMP_FILE" 2>>"$_PIPER_LOG_DIR/piper.log"
 fi
 
 if [[ ! -f "$TEMP_FILE" ]] || [[ ! -s "$TEMP_FILE" ]]; then
@@ -538,11 +550,6 @@ AUDIO_DIR="${TEMP_FILE%/*}"
 WRITE_LOCK_FILE="$AUDIO_DIR/$(basename "$TEMP_FILE" .wav).lock"
 touch "$WRITE_LOCK_FILE"
 
-# Get audio duration for proper lock timing
-DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$TEMP_FILE" 2>/dev/null)
-DURATION=${DURATION%.*}  # Round to integer
-DURATION=${DURATION:-1}   # Default to 1 second if detection fails
-
 # Get audio duration for proper lock timing
 DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$TEMP_FILE" 2>/dev/null || true)
 DURATION=${DURATION%.*}  # Round to integer

package/.claude/hooks/play-tts-ssh-remote.sh

@@ -60,7 +60,7 @@ SSH_PORT=""
 if [[ -n "${AGENTVIBES_SSH_HOST:-}" ]]; then
   SSH_HOST="$AGENTVIBES_SSH_HOST"
   SSH_KEY="${AGENTVIBES_SSH_KEY:-}"
-  SSH_PORT="${AGENTVIBES_SSH_PORT:-22}"
+  SSH_PORT="${AGENTVIBES_SSH_PORT:-}"
 fi
 
 # Priority 2: ~/.agentvibes/transport-config.json (ssh-remote section)
@@ -340,7 +340,7 @@ SSH_ARGS=()
 # Run ssh inside the backgrounded subshell so its exit code is reachable via $?
 # (a `wait` from outside the spawning shell would error: "pid X is not a child").
 (
-  ssh "${SSH_ARGS[@]}" "$SSH_HOST" "$ENCODED_PAYLOAD"
+  ssh -o ConnectTimeout=10 "${SSH_ARGS[@]}" "$SSH_HOST" "$ENCODED_PAYLOAD"
   _exit=$?
   if [[ $_exit -ne 0 ]]; then
     echo "$(date -Iseconds) [ERROR] SSH to $SSH_HOST failed (exit $_exit)" \

package/.claude/hooks/voice-manager.sh

@@ -513,6 +513,12 @@ case "$1" in
       fi
     fi
 
+    # Normalize to canonical path so ls output is consistent across platforms
+    # (Git Bash resolves /tmp→/c/Users/..., macOS has /var→/private/var)
+    if [[ -d "$AUDIO_DIR" ]]; then
+      AUDIO_DIR=$(cd "$AUDIO_DIR" && pwd -P)
+    fi
+
     # Default to replay last audio (N=1)
     N="${2:-1}"
 

package/.claude/hooks-windows/audio-cache-utils.ps1

@@ -1,119 +1,119 @@
-#
-# File: .claude/hooks-windows/audio-cache-utils.ps1
-#
-# AgentVibes Audio Cache Utilities for Windows
-#
-
-param(
-    [Parameter(Position = 0)]
-    [ValidateSet('cleanup', 'stats', 'clear')]
-    [string]$Command
-)
-
-# Detect project-local audio dir (same logic as TTS scripts)
-$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
-if (Test-Path $ProjectClaudeDir) {
-    $AudioDir = "$ProjectClaudeDir\audio"
-} else {
-    $AudioDir = "$env:USERPROFILE\.claude\audio"
-}
-
-function Ensure-AudioDir {
-    if (-not (Test-Path $AudioDir)) {
-        New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
-    }
-}
-
-function Get-AudioCacheSize {
-    Ensure-AudioDir
-
-    if (-not (Test-Path $AudioDir)) {
-        return 0
-    }
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
-    $totalSize = 0
-
-    foreach ($file in $files) {
-        $totalSize += $file.Length
-    }
-
-    return $totalSize
-}
-
-function Format-FileSize {
-    param([long]$Size)
-
-    if ($Size -lt 1KB) { return "$Size B" }
-    if ($Size -lt 1MB) { return "{0:N2} KB" -f ($Size / 1KB) }
-    if ($Size -lt 1GB) { return "{0:N2} MB" -f ($Size / 1MB) }
-    return "{0:N2} GB" -f ($Size / 1GB)
-}
-
-function Get-CacheStats {
-    Ensure-AudioDir
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum
-
-    $count = if ($files.Count -eq $null) { 0 } else { $files.Count }
-    $totalSize = if ($files.Sum -eq $null) { 0 } else { $files.Sum }
-
-    return @{
-        FileCount = $count
-        TotalSize = $totalSize
-        FormattedSize = Format-FileSize $totalSize
-    }
-}
-
-function Clear-Cache {
-    Ensure-AudioDir
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
-
-    if ($files.Count -eq 0) {
-        Write-Host "[OK] Cache already empty" -ForegroundColor Green
-        return
-    }
-
-    $stats = Get-CacheStats
-    Write-Host "[CLEANUP] Clearing $($stats.FileCount) audio files ($($stats.FormattedSize))" -ForegroundColor Yellow
-
-    foreach ($file in $files) {
-        Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue
-    }
-
-    Write-Host "[OK] Cache cleared" -ForegroundColor Green
-}
-
-function Show-CacheStats {
-    Ensure-AudioDir
-
-    $stats = Get-CacheStats
-
-    Write-Host ""
-    Write-Host "[STATS] Audio Cache Statistics" -ForegroundColor Cyan
-    Write-Host "   Location: $AudioDir"
-    Write-Host "   Files: $($stats.FileCount)"
-    Write-Host "   Total Size: $($stats.FormattedSize)"
-    Write-Host ""
-}
-
-# Main command routing
-switch ($Command) {
-    'stats' {
-        Show-CacheStats
-    }
-
-    'cleanup' {
-        Clear-Cache
-    }
-
-    'clear' {
-        Clear-Cache
-    }
-
-    default {
-        Show-CacheStats
-    }
-}
+#
+# File: .claude/hooks-windows/audio-cache-utils.ps1
+#
+# AgentVibes Audio Cache Utilities for Windows
+#
+
+param(
+    [Parameter(Position = 0)]
+    [ValidateSet('cleanup', 'stats', 'clear')]
+    [string]$Command
+)
+
+# Detect project-local audio dir (same logic as TTS scripts)
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+if (Test-Path $ProjectClaudeDir) {
+    $AudioDir = "$ProjectClaudeDir\audio"
+} else {
+    $AudioDir = "$env:USERPROFILE\.claude\audio"
+}
+
+function Ensure-AudioDir {
+    if (-not (Test-Path $AudioDir)) {
+        New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
+    }
+}
+
+function Get-AudioCacheSize {
+    Ensure-AudioDir
+
+    if (-not (Test-Path $AudioDir)) {
+        return 0
+    }
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
+    $totalSize = 0
+
+    foreach ($file in $files) {
+        $totalSize += $file.Length
+    }
+
+    return $totalSize
+}
+
+function Format-FileSize {
+    param([long]$Size)
+
+    if ($Size -lt 1KB) { return "$Size B" }
+    if ($Size -lt 1MB) { return "{0:N2} KB" -f ($Size / 1KB) }
+    if ($Size -lt 1GB) { return "{0:N2} MB" -f ($Size / 1MB) }
+    return "{0:N2} GB" -f ($Size / 1GB)
+}
+
+function Get-CacheStats {
+    Ensure-AudioDir
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum
+
+    $count = if ($files.Count -eq $null) { 0 } else { $files.Count }
+    $totalSize = if ($files.Sum -eq $null) { 0 } else { $files.Sum }
+
+    return @{
+        FileCount = $count
+        TotalSize = $totalSize
+        FormattedSize = Format-FileSize $totalSize
+    }
+}
+
+function Clear-Cache {
+    Ensure-AudioDir
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
+
+    if ($files.Count -eq 0) {
+        Write-Host "[OK] Cache already empty" -ForegroundColor Green
+        return
+    }
+
+    $stats = Get-CacheStats
+    Write-Host "[CLEANUP] Clearing $($stats.FileCount) audio files ($($stats.FormattedSize))" -ForegroundColor Yellow
+
+    foreach ($file in $files) {
+        Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue
+    }
+
+    Write-Host "[OK] Cache cleared" -ForegroundColor Green
+}
+
+function Show-CacheStats {
+    Ensure-AudioDir
+
+    $stats = Get-CacheStats
+
+    Write-Host ""
+    Write-Host "[STATS] Audio Cache Statistics" -ForegroundColor Cyan
+    Write-Host "   Location: $AudioDir"
+    Write-Host "   Files: $($stats.FileCount)"
+    Write-Host "   Total Size: $($stats.FormattedSize)"
+    Write-Host ""
+}
+
+# Main command routing
+switch ($Command) {
+    'stats' {
+        Show-CacheStats
+    }
+
+    'cleanup' {
+        Clear-Cache
+    }
+
+    'clear' {
+        Clear-Cache
+    }
+
+    default {
+        Show-CacheStats
+    }
+}

package/.claude/hooks-windows/bmad-speak.ps1

@@ -198,29 +198,13 @@ if ($AgentPersonality -and (Test-Path (Split-Path $PersonalityFile -Parent))) {
 }
 
 # ---------------------------------------------------------------------------
-# Temporarily patch background music config for this agent.
-# The caller (bmad-party-speak.ps1) holds a named mutex so only one speak
-# call runs at a time — these file patches are safe from concurrent clobber.
-$BgEnabledFile   = Join-Path $TtsConfigDir "background-music-enabled.txt"
-$AudioEffectsCfg = Join-Path $TtsConfigDir "audio-effects.cfg"
-$OldBgEnabled    = $null
-$TempCfgLine     = ""
-
+# Apply per-agent background music via AGENTVIBES_OVERRIDE_* env vars.
+# play-tts.ps1 reads these directly and forces BgEnabled=true when OVERRIDE_MUSIC
+# is set — no config file patching needed, and cleanup is automatic (env vars
+# are scoped to the child process spawned by & powershell below).
 if ($AgentBgEnabled -and $AgentBgTrack) {
-    # Save + enable background music
-    if (Test-Path $BgEnabledFile) {
-        $OldBgEnabled = (Get-Content $BgEnabledFile -Raw -ErrorAction SilentlyContinue).Trim()
-    }
-    Set-Content $BgEnabledFile "true" -NoNewline
-
-    # Prepend agent line to audio-effects.cfg so play-tts.ps1 finds it first
-    # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
-    $TempCfgLine = "${AgentId}||${AgentBgTrack}|${AgentBgVolume}"
-    $env:AGENTVIBES_AGENT_NAME = $AgentId
-    $existingCfg = if (Test-Path $AudioEffectsCfg) {
-        Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
-    } else { "" }
-    Set-Content $AudioEffectsCfg "${TempCfgLine}`n${existingCfg}" -NoNewline
+    $env:AGENTVIBES_OVERRIDE_MUSIC  = $AgentBgTrack
+    $env:AGENTVIBES_OVERRIDE_VOLUME = $AgentBgVolume
 }
 
 try {
@@ -243,22 +227,9 @@ try {
         }
     }
 
-    # Restore background music config
+    # Clear music override env vars (use SetEnvironmentVariable to fully remove, not just empty)
     if ($AgentBgEnabled -and $AgentBgTrack) {
-        if ($null -ne $OldBgEnabled) {
-            Set-Content $BgEnabledFile $OldBgEnabled -NoNewline
-        } elseif (Test-Path $BgEnabledFile) {
-            Remove-Item $BgEnabledFile -Force -ErrorAction SilentlyContinue
-        }
-
-        # Remove the prepended agent line from audio-effects.cfg
-        if (Test-Path $AudioEffectsCfg) {
-            $cfgRaw = Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
-            $escaped = [regex]::Escape($TempCfgLine)
-            $cfgRaw  = $cfgRaw -replace "^${escaped}\r?\n?", ""
-            Set-Content $AudioEffectsCfg $cfgRaw -NoNewline
-        }
-
-        $env:AGENTVIBES_AGENT_NAME = ""
+        [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_MUSIC",  $null, "Process")
+        [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_VOLUME", $null, "Process")
     }
 }

package/.claude/hooks-windows/play-tts-soprano.ps1

@@ -20,6 +20,13 @@ param(
 
 $ErrorActionPreference = "Stop"
 
+# Append registry PATH entries so Python-installed scripts (soprano, soprano-webui) are
+# found when spawned from Node.js. Prepend existing PATH to preserve runtime shims
+# (nvm, conda, pyenv) that were added after the process started.
+$env:Path = $env:Path + ";" +
+            [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" +
+            [System.Environment]::GetEnvironmentVariable("Path", "User")
+
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 # Validate port is numeric to prevent injection
 $SopranoPort = "7860"
@@ -101,7 +108,8 @@ if (Test-WebUI) {
     $SynthMode = "webui"
     $pythonHelper = Join-Path $ScriptDir "soprano-gradio-synth.py"
     if (Test-Path $pythonHelper) {
-        & python $pythonHelper $Text $TempFile $SopranoPort 2>$null
+        # Wrap in try/catch: PS7.3+ throws on native non-zero exit with ErrorActionPreference=Stop
+        try { & python $pythonHelper $Text $TempFile $SopranoPort 2>$null } catch { }
     } else {
         Write-Host "[ERROR] soprano-gradio-synth.py not found" -ForegroundColor Red
         exit 1
@@ -123,7 +131,8 @@ if (Test-WebUI) {
 } elseif (Test-SopranoCLI) {
     # CLI fallback - reloads model each call (slowest)
     $SynthMode = "cli"
-    & soprano $Text -o $TempFile -d $SopranoDevice 2>$null
+    # Wrap in try/catch: PS7.3+ throws on native non-zero exit with ErrorActionPreference=Stop
+    try { & soprano $Text -o $TempFile -d $SopranoDevice 2>$null } catch { }
 } else {
     Write-Host "[ERROR] Soprano TTS not installed and no server running on port $SopranoPort" -ForegroundColor Red
     Write-Host ""
@@ -156,3 +165,5 @@ if (-not $env:AGENTVIBES_NO_PLAY) {
 
 Write-Host "Saved to: $TempFile"
 Write-Host "Voice: Soprano-1.1-80M (Soprano TTS, $SynthMode mode)"
+# Output bare path so play-tts.ps1 can capture it for reverb/bg-music processing
+Write-Output $TempFile

package/.claude/hooks-windows/play-tts-windows-piper.ps1

@@ -62,15 +62,20 @@ if (-not $VoiceName) {
 }
 
 # Security: Validate voice name to prevent path traversal
-# Only allow alphanumeric, underscore, hyphen, and period
-if ($VoiceName -notmatch '^[a-zA-Z0-9_\-\.]+$') {
+# Format: <model> or <model>::<speaker> for multi-speaker Piper models
+# Only allow alphanumeric, underscore, hyphen, period, and the :: separator
+if ($VoiceName -notmatch '^[a-zA-Z0-9_\-\.]+(::[a-zA-Z0-9_\-\.]+)?$') {
     Write-Host "[ERROR] Invalid voice name: $VoiceName" -ForegroundColor Red
     exit 1
 }
 
+# Extract model name and optional speaker (multi-speaker format: model::Speaker)
+$VoiceModel  = ($VoiceName -split '::')[0]
+$SpeakerName = if ($VoiceName -match '::(.+)$') { $Matches[1] } else { "" }
+
 # Resolve voice model path and validate it stays within VoicesDir
-$VoiceModelFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceName.onnx")
-$VoiceJsonFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceName.onnx.json")
+$VoiceModelFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceModel.onnx")
+$VoiceJsonFile  = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceModel.onnx.json")
 $ResolvedVoicesDir = [System.IO.Path]::GetFullPath($VoicesDir)
 if (-not $VoiceModelFile.StartsWith($ResolvedVoicesDir)) {
     Write-Host "[ERROR] Voice path outside voices directory" -ForegroundColor Red
@@ -79,15 +84,15 @@ if (-not $VoiceModelFile.StartsWith($ResolvedVoicesDir)) {
 
 # Check if voice model exists, download if missing
 if (-not (Test-Path $VoiceModelFile)) {
-    Write-Host "[DOWNLOAD] Voice model: $VoiceName" -ForegroundColor Yellow
+    Write-Host "[DOWNLOAD] Voice model: $VoiceModel" -ForegroundColor Yellow
 
     # Try to download from Hugging Face
     # Voice name format: {lang}_{region}-{speaker}-{quality}
     # HF path format:    {lang}/{lang}_{region}/{speaker}/{quality}/{voicename}.onnx
     try {
-        # Parse voice name to build correct HF path
+        # Parse model name to build correct HF path (strip ::Speaker suffix first)
         # e.g. en_US-ryan-high -> en/en_US/ryan/high/en_US-ryan-high.onnx
-        if ($VoiceName -match '^([a-z]{2})_([A-Z]{2})-([a-zA-Z0-9_]+)-([a-z]+)$') {
+        if ($VoiceModel -match '^([a-z]{2})_([A-Z]{2})-([a-zA-Z0-9_]+)-([a-z]+)$') {
             $Lang = $Matches[1]
             $LangRegion = "$($Matches[1])_$($Matches[2])"
             $Speaker = $Matches[3]
@@ -97,8 +102,8 @@ if (-not (Test-Path $VoiceModelFile)) {
             # Fallback for non-standard voice names
             $HFBase = "https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/ryan/high"
         }
-        $ModelUrl = "$HFBase/$VoiceName.onnx"
-        $JsonUrl = "$HFBase/$VoiceName.onnx.json"
+        $ModelUrl = "$HFBase/$VoiceModel.onnx"
+        $JsonUrl = "$HFBase/$VoiceModel.onnx.json"
 
         Write-Host "   Downloading model..." -ForegroundColor Cyan
         Invoke-WebRequest -Uri $ModelUrl -OutFile $VoiceModelFile -ErrorAction Stop
@@ -127,11 +132,10 @@ $AudioFile = "$AudioDir\tts-$Timestamp.wav"
 try {
     Write-Host "[SYNTH] Synthesizing with Piper..." -ForegroundColor Cyan
 
-    # Run Piper with text input
-    $Text | & $PiperExe `
-        --model $VoiceModelFile `
-        --output-file $AudioFile `
-        2>$null
+    # Run Piper with text input; pass --speaker for multi-speaker models (model::Speaker format)
+    $piperArgs = @('--model', $VoiceModelFile, '--output-file', $AudioFile)
+    if ($SpeakerName) { $piperArgs += @('--speaker', $SpeakerName) }
+    $Text | & $PiperExe @piperArgs 2>$null
 
     if (-not (Test-Path $AudioFile)) {
         Write-Host "[ERROR] Piper synthesis failed" -ForegroundColor Red
@@ -151,12 +155,14 @@ try {
     if (-not $env:AGENTVIBES_NO_PLAY) {
         # Prefer ffplay: handles 22050 Hz → 48000 Hz resampling cleanly (SoundPlayer uses
         # WinMM's low-quality resampler which produces choppy audio at non-native rates).
-        $ffplayPath = (Get-Command ffplay -ErrorAction SilentlyContinue)?.Source
+        $ffplayCmd = Get-Command ffplay -ErrorAction SilentlyContinue
+        $ffplayPath = if ($ffplayCmd) { $ffplayCmd.Source }
         if (-not $ffplayPath) {
             # SSH/watcher sessions may have a minimal PATH — refresh from registry
             $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" +
                         [System.Environment]::GetEnvironmentVariable("Path","User")
-            $ffplayPath = (Get-Command ffplay -ErrorAction SilentlyContinue)?.Source
+            $ffplayCmd = Get-Command ffplay -ErrorAction SilentlyContinue
+            $ffplayPath = if ($ffplayCmd) { $ffplayCmd.Source }
         }
         if ($ffplayPath) {
             & $ffplayPath -autoexit -nodisp -loglevel quiet $AudioFile 2>$null

package/.mcp.json

@@ -1,20 +1,24 @@
 {
   "mcpServers": {
-    "agentvibes": {
+    "firecrawl": {
+      "command": "npx",
+      "args": [
+        "firecrawl-mcp"
+      ]
+    },
+    "context7": {
       "command": "npx",
       "args": [
         "-y",
-        "--package=agentvibes",
-        "agentvibes-mcp-server"
+        "@upstash/context7-mcp"
       ],
       "env": {
-        "AGENTVIBES_MCP_FALLBACK": "copilot"
+        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}"
       }
-    },
-    "firecrawl": {
-      "command": "npx",
-      "args": [
-        "firecrawl-mcp"
+    }
+  }
+}
+awl-mcp"
       ]
     },
     "context7": {

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.7.7
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.10.0
 
 ---
 
@@ -40,7 +40,33 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.7.7 — Party Mode Voice Restore + Polish
+## 🌟 NEW IN v5.9.0 — SSH Remote + Windows Home Directory Fixes
+
+**SSH remote no longer hangs:** The SSH transport now applies a 10-second connection
+timeout, so a stuck or unreachable remote host surfaces an error quickly instead of
+blocking forever.
+
+**Windows home directory detection fixed:** `detectRemoteLlm()` now uses null-coalescing
+(`??`) to fall back to `os.homedir()` only when `HOME` is genuinely unset — safer than
+the previous `||` which could misfire on an empty string.
+
+## v5.8.0 — Soprano Now Works + Voice Picker Fixed for All Engines
+
+**Soprano TTS actually works now:** Soprano (our neural TTS engine) was silently broken
+on Windows since launch — wrong binary name, stripped PATH, wav path sent to the wrong
+output stream, and no auto-start for the WebUI server. All fixed. Install with
+`pip install soprano-tts`, select Soprano in the setup tab, and AgentVibes handles
+the rest.
+
+**Voice picker now works for Windows SAPI and macOS Say:** Previously the picker showed
+the entire Piper voice catalog even when SAPI or macOS Say was selected, and Space-bar
+preview played through the wrong engine. The picker now shows exactly one item for each
+native engine and previews through the correct binary.
+
+**Auto-save no longer breaks your engine setting:** Saving an LLM config no longer silently
+overwrites your chosen engine back to Piper.
+
+## v5.7.7 — Party Mode Voice Restore + Polish
 
 **Party mode agents now speak again:** BMAD `/party-mode` now reliably invokes the correct AgentVibes skill, and each agent's response is spoken aloud in their unique voice with per-agent music, pretext, and reverb — loaded automatically from `~/.agentvibes/bmad-voice-map.json`.
 
@@ -220,6 +246,11 @@ Replace the default background tracks with your own audio files for complete son
 - Automatic format detection
 - Duration warnings for non-optimal lengths
 
+**Custom Track Naming Rules:**
+- Use `snake_case` filenames only — e.g. `my_focus_music.mp3` ✅
+- No spaces or uppercase letters in filenames — e.g. `My Focus Music.mp3` ❌
+- Misnamed files will not appear in the music picker and will be skipped by the audio engine
+
 **Perfect for:**
 - 🎸 **Team Audio Branding** - Company theme music
 - 🎮 **Gaming Sessions** - Epic background tracks