agentvibes 3.4.2 → 3.5.0-alpha.1

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

@@ -49,4 +49,4 @@ BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30
 _party_mode|compand 0.3,1 6:-70,-60,-20|agent_vibes_dark_chill_step_loop.mp3|0.40
 |||
 # Default (no agent specified) - clean with Bachata background|||
-default|reverb 20 50 50|agentvibes_soft_flamenco_loop.mp3|0.30
+default|reverb 40 50 70|agentvibes_soft_flamenco_loop.mp3|0.30

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

@@ -146,9 +146,6 @@ speak_text() {
     piper)
       "$SCRIPT_DIR/play-tts-piper.sh" "$text" "$voice"
       ;;
-    soprano)
-      "$SCRIPT_DIR/play-tts-soprano.sh" "$text" "$voice"
-      ;;
     macos)
       "$SCRIPT_DIR/play-tts-macos.sh" "$text" "$voice"
       ;;
@@ -268,9 +265,6 @@ case "$ACTIVE_PROVIDER" in
   piper)
     exec "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
-  soprano)
-    exec "$SCRIPT_DIR/play-tts-soprano.sh" "$TEXT" "$VOICE_OVERRIDE"
-    ;;
   macos)
     exec "$SCRIPT_DIR/play-tts-macos.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;

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

@@ -190,13 +190,6 @@ migrate_voice_to_provider() {
   # Default voices by provider
   local piper_default="en_US-lessac-medium"
   local macos_default="Samantha"
-  local soprano_default="soprano-default"  # Single voice — no selection needed
-
-  # Soprano has a single voice, so migration is straightforward
-  if [[ "$target_provider" == "soprano" ]]; then
-    echo "$soprano_default"
-    return 0
-  fi
 
   # If no current voice, return default for target provider
   if [[ -z "$current_voice" ]]; then
@@ -208,16 +201,6 @@ migrate_voice_to_provider() {
     return 0
   fi
 
-  # If migrating FROM Soprano, return default for target provider
-  if [[ "$current_voice" == "soprano-default" ]]; then
-    case "$target_provider" in
-      piper) echo "$piper_default" ;;
-      macos) echo "$macos_default" ;;
-      *) echo "$piper_default" ;;
-    esac
-    return 0
-  fi
-
   # Convert to lowercase for case-insensitive comparison (portable)
   local current_voice_lower
   current_voice_lower=$(echo "$current_voice" | tr '[:upper:]' '[:lower:]')

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

@@ -0,0 +1,112 @@
+#
+# File: .claude/hooks-windows/audio-cache-utils.ps1
+#
+# AgentVibes Audio Cache Utilities for Windows
+#
+
+param(
+    [Parameter(Position = 0)]
+    [ValidateSet('cleanup', 'stats', 'clear')]
+    [string]$Command
+)
+
+$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-windows-piper.ps1

@@ -0,0 +1,142 @@
+#
+# File: .claude/hooks-windows/play-tts-windows-piper.ps1
+#
+# AgentVibes - Windows Piper TTS Provider
+# High-quality neural TTS using Piper.exe
+#
+
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$Text,
+
+    [Parameter(Mandatory = $false)]
+    [string]$VoiceOverride
+)
+
+# Configuration paths
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+
+if (Test-Path $ProjectClaudeDir) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
+
+$AudioDir = "$ClaudeDir\audio"
+$VoicesDir = "$ClaudeDir\piper-voices"
+$VoiceFile = "$ClaudeDir\tts-voice-piper.txt"
+$PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
+
+# Ensure directories exist
+foreach ($dir in @($AudioDir, $VoicesDir)) {
+    if (-not (Test-Path $dir)) {
+        New-Item -ItemType Directory -Path $dir -Force | Out-Null
+    }
+}
+
+# Check if Piper is installed
+if (-not (Test-Path $PiperExe)) {
+    Write-Host "[ERROR] Piper not found at: $PiperExe" -ForegroundColor Red
+    Write-Host "Run: .\setup-windows.ps1 to install Piper" -ForegroundColor Yellow
+    exit 1
+}
+
+# Determine voice to use
+$VoiceName = ""
+
+if ($VoiceOverride) {
+    $VoiceName = $VoiceOverride
+}
+elseif (Test-Path $VoiceFile) {
+    $VoiceName = (Get-Content $VoiceFile -Raw).Trim()
+}
+
+# Default voice if not specified
+if (-not $VoiceName) {
+    $VoiceName = "en_US-ryan-high"
+}
+
+# Resolve voice model path
+$VoiceModelFile = "$VoicesDir\$VoiceName.onnx"
+$VoiceJsonFile = "$VoicesDir\$VoiceName.onnx.json"
+
+# Check if voice model exists, download if missing
+if (-not (Test-Path $VoiceModelFile)) {
+    Write-Host "[DOWNLOAD] Voice model: $VoiceName" -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
+        # 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-z]+)$') {
+            $Lang = $Matches[1]
+            $LangRegion = "$($Matches[1])_$($Matches[2])"
+            $Speaker = $Matches[3]
+            $Quality = $Matches[4]
+            $HFBase = "https://huggingface.co/rhasspy/piper-voices/resolve/main/$Lang/$LangRegion/$Speaker/$Quality"
+        } else {
+            # 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"
+
+        Write-Host "   Downloading model..." -ForegroundColor Cyan
+        Invoke-WebRequest -Uri $ModelUrl -OutFile $VoiceModelFile -ErrorAction Stop
+        Write-Host "   Downloading config..." -ForegroundColor Cyan
+        Invoke-WebRequest -Uri $JsonUrl -OutFile $VoiceJsonFile -ErrorAction Stop
+        Write-Host "[OK] Voice model downloaded" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "[ERROR] Failed to download voice model: $_" -ForegroundColor Red
+        Write-Host "Make sure you have internet connection" -ForegroundColor Yellow
+        exit 1
+    }
+}
+
+# Sanitize text for speech - strip characters that TTS engines read literally
+$Text = $Text -replace '\\', ' '
+$Text = $Text -replace '[{}<>|`~^]', ''
+$Text = $Text -replace '\s+', ' '
+$Text = $Text.Trim()
+
+# Create audio file path
+$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
+$AudioFile = "$AudioDir\tts-$Timestamp.wav"
+
+# Synthesize with Piper
+try {
+    Write-Host "[SYNTH] Synthesizing with Piper..." -ForegroundColor Cyan
+
+    # Run Piper with text input
+    $Text | & $PiperExe `
+        --model $VoiceModelFile `
+        --output-file $AudioFile `
+        2>$null
+
+    if (-not (Test-Path $AudioFile)) {
+        Write-Host "[ERROR] Piper synthesis failed" -ForegroundColor Red
+        exit 1
+    }
+
+    # Display results
+    Write-Host "[OK] Saved to: $AudioFile" -ForegroundColor Green
+    Write-Host "[VOICE] Voice used: $VoiceName (Piper)" -ForegroundColor Green
+
+    # Play the audio using built-in Windows audio player
+    try {
+        $player = New-Object System.Media.SoundPlayer $AudioFile
+        $player.PlaySync()
+    }
+    catch {
+        Write-Host "[WARNING] Could not play audio (SoundPlayer unavailable)" -ForegroundColor Yellow
+        Write-Host "Audio saved to: $AudioFile" -ForegroundColor Gray
+    }
+}
+catch {
+    Write-Host "[ERROR] Error running Piper: $_" -ForegroundColor Red
+    exit 1
+}

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

@@ -0,0 +1,101 @@
+#
+# File: .claude/hooks-windows/play-tts-windows-sapi.ps1
+#
+# AgentVibes - Windows SAPI TTS Provider (Zero Dependencies)
+# Uses built-in Windows System.Speech API
+#
+
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$Text,
+
+    [Parameter(Mandatory = $false)]
+    [string]$VoiceOverride
+)
+
+# Configuration paths
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+
+if (Test-Path $ProjectClaudeDir) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
+
+$AudioDir = "$ClaudeDir\audio"
+$VoiceFile = "$ClaudeDir\tts-voice-sapi.txt"
+
+# Ensure directories exist
+if (-not (Test-Path $AudioDir)) {
+    New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
+}
+
+# Load System.Speech assembly
+try {
+    Add-Type -AssemblyName System.Speech
+}
+catch {
+    Write-Host "[ERROR] System.Speech assembly not available" -ForegroundColor Red
+    exit 1
+}
+
+# Determine voice to use
+$VoiceName = ""
+
+if ($VoiceOverride) {
+    $VoiceName = $VoiceOverride
+}
+elseif (Test-Path $VoiceFile) {
+    $VoiceName = (Get-Content $VoiceFile -Raw).Trim()
+}
+
+# Initialize speech synthesizer
+$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+
+# Set voice if specified
+if ($VoiceName) {
+    try {
+        $synth.SelectVoice($VoiceName)
+    }
+    catch {
+        Write-Host "[WARNING] Voice '$VoiceName' not found, using default" -ForegroundColor Yellow
+    }
+}
+
+# Sanitize text for speech - strip characters that TTS engines read literally
+$Text = $Text -replace '\\', ' '
+$Text = $Text -replace '[{}<>|`~^]', ''
+$Text = $Text -replace '\s+', ' '
+$Text = $Text.Trim()
+
+# Get actual voice name (after selection or default)
+$ActualVoice = $synth.Voice.Name
+
+# Create audio file path
+$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
+$AudioFile = "$AudioDir\tts-$Timestamp.wav"
+
+# Save to WAV file
+try {
+    $synth.SetOutputToWaveFile($AudioFile)
+    $synth.Speak($Text)
+    $synth.Dispose()
+
+    # Display results
+    Write-Host "[OK] Saved to: $AudioFile" -ForegroundColor Green
+    Write-Host "[VOICE] Voice used: $ActualVoice (Windows SAPI)" -ForegroundColor Green
+
+    # Play the audio using built-in Windows audio player
+    try {
+        $player = New-Object System.Media.SoundPlayer $AudioFile
+        $player.PlaySync()
+    }
+    catch {
+        Write-Host "[WARNING] Could not play audio (SoundPlayer unavailable)" -ForegroundColor Yellow
+    }
+}
+catch {
+    Write-Host "[ERROR] Error synthesizing speech: $_" -ForegroundColor Red
+    exit 1
+}

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

@@ -0,0 +1,81 @@
+#
+# File: .claude/hooks-windows/play-tts.ps1
+#
+# AgentVibes - Windows TTS Router
+# Delegates to active provider (windows-sapi or windows-piper)
+#
+
+param(
+    [Parameter(Mandatory = $true, Position = 0)]
+    [string]$Text,
+
+    [Parameter(Mandatory = $false, Position = 1)]
+    [string]$VoiceOverride
+)
+
+# Configuration paths
+# First check if we're running from a project directory with .claude
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+
+# Use project .claude if running from there, otherwise use user profile
+if (Test-Path $ProjectClaudeDir) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
+
+$HooksDir = "$ClaudeDir\hooks-windows"
+$ProviderFile = "$ClaudeDir\tts-provider.txt"
+$MuteFile = "$ClaudeDir\tts-muted.txt"
+
+# Check if TTS is muted
+if (Test-Path $MuteFile) {
+    $muteStatus = Get-Content $MuteFile -Raw
+    if ($muteStatus.Trim() -eq "true") {
+        exit 0
+    }
+}
+
+# Determine active provider
+$ActiveProvider = "windows-sapi"
+if (Test-Path $ProviderFile) {
+    $ActiveProvider = (Get-Content $ProviderFile -Raw).Trim()
+}
+
+# Validate and get provider script
+$ProviderScript = ""
+
+switch ($ActiveProvider) {
+    "windows-sapi" {
+        $ProviderScript = "$HooksDir\play-tts-windows-sapi.ps1"
+    }
+    "windows-piper" {
+        $ProviderScript = "$HooksDir\play-tts-windows-piper.ps1"
+    }
+    default {
+        Write-Host "[ERROR] Unknown provider: $ActiveProvider" -ForegroundColor Red
+        Write-Host "Use: .\provider-manager.ps1 list" -ForegroundColor Yellow
+        exit 1
+    }
+}
+
+# Check if provider script exists
+if (-not (Test-Path $ProviderScript)) {
+    Write-Host "[ERROR] Provider script not found: $ProviderScript" -ForegroundColor Red
+    exit 1
+}
+
+# Call the provider script
+try {
+    if ($VoiceOverride) {
+        & $ProviderScript $Text $VoiceOverride
+    }
+    else {
+        & $ProviderScript $Text
+    }
+}
+catch {
+    Write-Host "[ERROR] TTS Error: $_" -ForegroundColor Red
+    exit 1
+}