agentvibes 5.6.8 → 5.7.0

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

@@ -561,8 +561,55 @@ case "$1" in
     fi
     ;;
 
+  sample)
+    # Play a sample phrase with the specified voice (used by /agent-vibes:sample)
+    SAMPLE_VOICE="${2:-}"
+    if [[ -z "$SAMPLE_VOICE" ]]; then
+      echo "❌ Usage: /agent-vibes:sample <voice-name>"
+      echo ""
+      echo "Examples:"
+      echo "  /agent-vibes:sample en_US-amy-medium"
+      echo "  /agent-vibes:sample Ryan"
+      exit 1
+    fi
+
+    # Source provider-manager.sh first — get_active_provider and detect_routing_llm
+    # are both defined there; sourcing after calling them silently produces empty values.
+    source "$SCRIPT_DIR/provider-manager.sh" 2>/dev/null || true
+
+    ACTIVE_PROVIDER=$(get_active_provider)
+
+    # Friendly name resolution for Piper and transport providers
+    case "$ACTIVE_PROVIDER" in
+      piper|ssh-remote|agentvibes-receiver|termux-ssh)
+        source "$SCRIPT_DIR/piper-voice-manager.sh" 2>/dev/null || true
+        SAMPLE_META="$(realpath "$SCRIPT_DIR/../../.agentvibes/config/voice-metadata.json" 2>/dev/null || echo "")"
+        if [[ -f "$SAMPLE_META" ]] && command -v jq >/dev/null 2>&1; then
+          SAMPLE_RESOLVED=$(jq -r --arg n "$(to_lower "$SAMPLE_VOICE")" '
+            .voices | to_entries[] |
+            select(.key == $n or (.value.displayName | ascii_downcase) == $n) |
+            .value.id
+          ' "$SAMPLE_META" 2>/dev/null | head -1)
+          if [[ -n "$SAMPLE_RESOLVED" ]] && [[ "$SAMPLE_RESOLVED" =~ ^[a-zA-Z0-9_.:+-]+$ ]]; then
+            echo "🔍 Resolved '${SAMPLE_VOICE}' → '${SAMPLE_RESOLVED}'"
+            SAMPLE_VOICE="$SAMPLE_RESOLVED"
+          fi
+        fi
+        ;;
+    esac
+
+    # Detect routing LLM so SSH-remote setups forward audio to the receiver
+    SAMPLE_LLM=$(detect_routing_llm 2>/dev/null || echo "")
+    SAMPLE_LLM_ARG=()
+    [[ -n "$SAMPLE_LLM" ]] && SAMPLE_LLM_ARG=(--llm "$SAMPLE_LLM")
+
+    echo "🎤 Sampling voice: $SAMPLE_VOICE"
+    "$SCRIPT_DIR/play-tts.sh" "Hi, I'm ${SAMPLE_VOICE}. How does my voice sound?" \
+      "$SAMPLE_VOICE" "${SAMPLE_LLM_ARG[@]+"${SAMPLE_LLM_ARG[@]}"}"
+    ;;
+
   *)
-    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami] [voice_name]"
+    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami|sample] [voice_name]"
     echo ""
     echo "Commands:"
     echo "  list                    - List all available voices"
@@ -570,6 +617,7 @@ case "$1" in
     echo "  get                     - Get current voice name"
     echo "  replay [N]              - Replay Nth most recent audio (default: 1)"
     echo "  whoami                  - Show current voice and personality"
+    echo "  sample <voice_name>     - Play sample audio with the given voice"
     exit 1
     ;;
-esac
+esac

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/play-tts.ps1

@@ -22,7 +22,17 @@ param(
     # CLAUDE_PROJECT_DIR value here so per-project config is found even when
     # Bash tool calls do not propagate CLAUDE_PROJECT_DIR to child processes.
     [Parameter(Mandatory = $false)]
-    [string]$ProjectDir = ""
+    [string]$ProjectDir = "",
+
+    # Provider override from the remote sender (set by the watcher from the
+    # JSON payload's "provider" field).  Overrides the local tts-provider.txt
+    # default so the Linux-side config fully controls which engine the Windows
+    # receiver uses — no Windows-side provider config needed.
+    # Per-LLM engine rows in audio-effects.cfg still take final priority for
+    # explicit Windows overrides (e.g. llm:copilot → windows-sapi).
+    # Accepts cross-platform aliases: "piper" = windows-piper, "sapi" = windows-sapi.
+    [Parameter(Mandatory = $false)]
+    [string]$ProviderOverride = ""
 )
 
 # Text-file handoff: the SSH receiver watcher writes long/special-char text to
@@ -99,6 +109,29 @@ switch ($ActiveProvider) {
     }
 }
 
+# Apply remote provider override (from the JSON payload's "provider" field, passed
+# by the SSH-receiver watcher via -ProviderOverride).  This lets the Linux-side
+# audio-effects.cfg row for llm:claude-code specify "piper" and have it honoured
+# on Windows without requiring the Windows tts-provider.txt to be reconfigured.
+# Priority: lower than per-LLM $_LlmEngine (audio-effects.cfg row, set later), higher
+# than the global tts-provider.txt default set above.
+if ($ProviderOverride) {
+    switch ($ProviderOverride) {
+        { $_ -in "windows-piper", "piper" } {
+            $ProviderScript = "$HooksDir\play-tts-piper.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-piper.ps1" }
+        }
+        { $_ -in "windows-sapi", "sapi" } {
+            $ProviderScript = "$HooksDir\play-tts-sapi.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-sapi.ps1" }
+        }
+        "soprano" { $ProviderScript = "$HooksDir\play-tts-soprano.ps1" }
+        default {
+            Write-Host "[WARNING] play-tts.ps1: Unknown ProviderOverride '$ProviderOverride' ignored" -ForegroundColor Yellow
+        }
+    }
+}
+
 # Check if provider script exists
 if (-not (Test-Path $ProviderScript)) {
     Write-Host "[ERROR] Provider script not found: $ProviderScript" -ForegroundColor Red

package/.claude/hooks-windows/tts-watcher.ps1

@@ -0,0 +1,122 @@
+#
+# File: .claude/hooks-windows/tts-watcher.ps1
+#
+# AgentVibes TTS Queue Watcher — runs in the user's interactive session for audio access.
+# The SSH receiver (session 0, no audio) writes JSON request files to the queue; this
+# watcher picks them up and calls play-tts.ps1 in the user's desktop session.
+#
+# Single-instance guard: exit immediately if another watcher instance is already running.
+$mutex = New-Object System.Threading.Mutex($false, 'Global\AgentVibesTtsWatcher')
+if (-not $mutex.WaitOne(0)) { $mutex.Dispose(); exit 0 }
+
+$QueueDir = "$env:USERPROFILE\.agentvibes\tts-queue"
+$LogFile  = "$env:USERPROFILE\.agentvibes\watcher.log"
+$PlayTts  = "$env:USERPROFILE\.claude\hooks-windows\play-tts.ps1"
+if (-not (Test-Path $QueueDir)) { New-Item -ItemType Directory -Path $QueueDir -Force | Out-Null }
+
+function Write-WatcherLog {
+    param([string]$Level, [string]$Msg)
+    $ts = Get-Date -Format 'yyyy-MM-ddTHH:mm:ss'
+    Add-Content -Path $LogFile -Value "$ts [$Level] $Msg" -ErrorAction SilentlyContinue
+}
+
+Write-WatcherLog "INFO" "Watcher started. PlayTts=$PlayTts exists=$(Test-Path $PlayTts)"
+
+try {
+    while ($true) {
+        $files = Get-ChildItem "$QueueDir\req-*.json" -ErrorAction SilentlyContinue | Sort-Object CreationTime
+        foreach ($f in $files) {
+            # Rename to proc-* before processing — crash recovery on restart
+            $procFile = $f.FullName -replace '\\req-', '\proc-'
+            try { Rename-Item $f.FullName $procFile -ErrorAction Stop } catch { continue }
+            try {
+                $req = Get-Content $procFile -Raw | ConvertFrom-Json
+                # Validate voice before passing to command line
+                $safeVoice = if ($req.voice -and $req.voice -match '^[a-zA-Z0-9_\-\. :]+$') { $req.voice } else { "" }
+                $env:CLAUDE_PROJECT_DIR = $env:USERPROFILE
+                $env:AGENTVIBES_NO_PRETEXT = "1"
+                # Use SetEnvironmentVariable to truly unset (assignment to $null leaves empty string)
+                if ($req.music)   { $env:AGENTVIBES_OVERRIDE_MUSIC   = $req.music }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_MUSIC",   $null, "Process") }
+                if ($req.volume)  { $env:AGENTVIBES_OVERRIDE_VOLUME  = $req.volume }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_VOLUME",  $null, "Process") }
+                if ($req.effects) { $env:AGENTVIBES_OVERRIDE_EFFECTS = $req.effects }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_EFFECTS", $null, "Process") }
+
+                if (Test-Path $PlayTts) {
+                    # Play remote arrival prefix sound if configured
+                    $prefixSoundFile = "$env:USERPROFILE\.agentvibes\remote-prefix-sound.txt"
+                    if (Test-Path $prefixSoundFile) {
+                        $prefixSound = (Get-Content $prefixSoundFile -Raw).Trim()
+                        if ($prefixSound -and (Test-Path $prefixSound)) {
+                            $ffplay = Get-Command ffplay -ErrorAction SilentlyContinue
+                            if ($ffplay) {
+                                & $ffplay.Source -autoexit -nodisp -loglevel quiet $prefixSound 2>$null
+                            }
+                        }
+                    }
+
+                    $tempText = Join-Path $env:TEMP "agentvibes-tts-$($req.id).txt"
+                    try {
+                        [System.IO.File]::WriteAllText($tempText, $req.text, [System.Text.UTF8Encoding]::new($false))
+                        $env:AGENTVIBES_TEXT_FILE = $tempText
+
+                        $llmArg = @()
+                        if ($req.llm) {
+                            if ($req.llm -match '^[a-zA-Z0-9][a-zA-Z0-9_-]*$') {
+                                $llmArg = @('-llm', $req.llm)
+                            } else {
+                                Write-WatcherLog "WARN" "Invalid LLM name '$($req.llm)' - using default"
+                            }
+                        }
+
+                        # Provider override: the Linux sender embeds its configured provider
+                        # (from receiver-provider.txt / audio-effects.cfg ENGINE column) in the
+                        # JSON payload so the Windows receiver uses the Linux-side engine choice.
+                        $providerArg = @()
+                        if ($req.provider) {
+                            $safeProvider = $req.provider.Trim()
+                            if ($safeProvider -match '^[a-zA-Z0-9][a-zA-Z0-9_-]*$') {
+                                $providerArg = @('-ProviderOverride', $safeProvider)
+                            } else {
+                                Write-WatcherLog "WARN" "Invalid provider '$safeProvider' in payload - ignored"
+                            }
+                        }
+
+                        Write-WatcherLog "INFO" "play-tts id=$($req.id) voice=$safeVoice llm=$($req.llm) provider=$safeProvider"
+                        $playOutput = & powershell.exe -NoProfile -ExecutionPolicy Bypass -File $PlayTts "__from_file__" $safeVoice @llmArg @providerArg 2>&1
+                        if ($LASTEXITCODE -ne 0) {
+                            Write-WatcherLog "ERROR" "play-tts exit=$LASTEXITCODE id=$($req.id) output=$($playOutput -join ' | ')"
+                        } else {
+                            Write-WatcherLog "INFO" "play-tts ok exit=0 id=$($req.id)"
+                        }
+                    } finally {
+                        [System.Environment]::SetEnvironmentVariable("AGENTVIBES_TEXT_FILE", $null, "Process")
+                        Remove-Item $tempText -Force -ErrorAction SilentlyContinue
+                    }
+                } else {
+                    # Fallback: Windows SAPI (built-in, no installation required)
+                    Write-WatcherLog "WARN" "play-tts.ps1 not found - using SAPI fallback for id=$($req.id)"
+                    Add-Type -AssemblyName System.Speech
+                    $synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+                    $synth.Speak($req.text)
+                    $synth.Dispose()
+                }
+                Remove-Item $procFile -Force -ErrorAction SilentlyContinue
+            } catch {
+                Write-WatcherLog "ERROR" "id=$($req.id) err=$_"
+                Remove-Item $procFile -Force -ErrorAction SilentlyContinue
+            }
+        }
+        # Crash recovery: re-queue any proc-* files left from a previous watcher crash
+        $stale = Get-ChildItem "$QueueDir\proc-*.json" -ErrorAction SilentlyContinue
+        foreach ($s in $stale) {
+            $recovered = $s.FullName -replace '\\proc-', '\req-'
+            try { Rename-Item $s.FullName $recovered -ErrorAction SilentlyContinue } catch {}
+        }
+        Start-Sleep -Milliseconds 200
+    }
+} finally {
+    $mutex.ReleaseMutex()
+    $mutex.Dispose()
+}

package/.claude/piper-voices-dir.txt

@@ -0,0 +1 @@
+/home/administrator/.claude/piper-voices