agentvibes 4.2.0 → 4.4.0

package/.claude/hooks-windows/download-extra-voices.ps1

@@ -0,0 +1,185 @@
+#
+# File: .claude/hooks-windows/download-extra-voices.ps1
+#
+# AgentVibes - Download Extra Piper Voice Models (Windows)
+# Downloads custom high-quality voices from HuggingFace
+#
+
+param(
+    [switch]$yes
+)
+
+$AUTO_YES = $yes -or ($args -contains "--yes") -or ($args -contains "-y")
+
+# Configuration
+$VoiceDir = "$env:USERPROFILE\.claude\piper-voices"
+$PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
+
+# HuggingFace repository for custom voices
+$HuggingFaceRepo = "agentvibes/piper-custom-voices"
+$HuggingFaceBaseUrl = "https://huggingface.co/$HuggingFaceRepo/resolve/main"
+
+# Extra custom voices to download
+$ExtraVoices = @(
+    @{
+        name = "kristin"
+        description = "Kristin (US English female, Public Domain, 64MB)"
+        sizeMB = 64
+    },
+    @{
+        name = "jenny"
+        description = "Jenny (UK English female with Irish accent, CC BY, 64MB)"
+        sizeMB = 64
+    },
+    @{
+        name = "16Speakers"
+        description = "Tracy/16Speakers (Multi-speaker: 12 US + 4 UK voices, Public Domain, 77MB)"
+        sizeMB = 77
+    }
+)
+
+Write-Host ""
+Write-Host "AgentVibes Extra Voice Downloader" -ForegroundColor Cyan
+Write-Host ("=" * 40) -ForegroundColor Cyan
+Write-Host ""
+Write-Host "This will download high-quality custom Piper voices from HuggingFace."
+Write-Host ""
+
+# 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
+}
+
+# Create voice directory
+if (-not (Test-Path $VoiceDir)) {
+    New-Item -ItemType Directory -Path $VoiceDir -Force | Out-Null
+}
+
+Write-Host "Voice directory: $VoiceDir" -ForegroundColor Gray
+Write-Host ""
+
+# Check status of each voice
+$alreadyDownloaded = @()
+$needDownload = @()
+
+foreach ($voice in $ExtraVoices) {
+    $modelFile = "$VoiceDir\$($voice.name).onnx"
+    $configFile = "$VoiceDir\$($voice.name).onnx.json"
+
+    if ((Test-Path $modelFile) -and (Test-Path $configFile)) {
+        $alreadyDownloaded += $voice
+    } else {
+        $needDownload += $voice
+    }
+}
+
+Write-Host "Status:" -ForegroundColor Cyan
+Write-Host "   Already downloaded: $($alreadyDownloaded.Count) voice(s)"
+Write-Host "   Need to download: $($needDownload.Count) voice(s)"
+Write-Host ""
+
+if ($alreadyDownloaded.Count -gt 0) {
+    Write-Host "Already downloaded (skipped):" -ForegroundColor Green
+    foreach ($voice in $alreadyDownloaded) {
+        Write-Host "   [OK] $($voice.description)" -ForegroundColor Green
+    }
+    Write-Host ""
+}
+
+if ($needDownload.Count -eq 0) {
+    Write-Host "All extra voices already downloaded!" -ForegroundColor Green
+    exit 0
+}
+
+# Calculate total size
+$totalSizeMB = ($needDownload | Measure-Object -Property sizeMB -Sum).Sum
+
+Write-Host "Voices to download:" -ForegroundColor Yellow
+foreach ($voice in $needDownload) {
+    Write-Host "   - $($voice.description)"
+}
+Write-Host ""
+Write-Host "Total download size: ~${totalSizeMB}MB" -ForegroundColor Yellow
+Write-Host ""
+
+# Confirm download
+if (-not $AUTO_YES) {
+    $reply = Read-Host "Download $($needDownload.Count) extra voice(s)? [Y/n]"
+    if ($reply -and $reply -notmatch '^[Yy]') {
+        Write-Host "Download cancelled" -ForegroundColor Red
+        exit 0
+    }
+} else {
+    Write-Host "Auto-downloading $($needDownload.Count) extra voice(s)..." -ForegroundColor Cyan
+    Write-Host ""
+}
+
+# Download each voice
+$downloaded = 0
+$failed = 0
+
+foreach ($voice in $needDownload) {
+    $voiceName = $voice.name
+    Write-Host ""
+    Write-Host "Downloading: $($voice.description)..." -ForegroundColor Cyan
+
+    $modelUrl = "$HuggingFaceBaseUrl/$voiceName.onnx"
+    $jsonUrl = "$HuggingFaceBaseUrl/$voiceName.onnx.json"
+    $modelFile = "$VoiceDir\$voiceName.onnx"
+    $jsonFile = "$VoiceDir\$voiceName.onnx.json"
+
+    $success = $true
+
+    try {
+        Write-Host "   Downloading model file..." -ForegroundColor Yellow
+        Invoke-WebRequest -Uri $modelUrl -OutFile $modelFile -ErrorAction Stop
+
+        Write-Host "   Downloading config file..." -ForegroundColor Yellow
+        Invoke-WebRequest -Uri $jsonUrl -OutFile $jsonFile -ErrorAction Stop
+
+        $modelSize = [math]::Round((Get-Item $modelFile).Length / 1MB, 2)
+        Write-Host "   [OK] Downloaded ($modelSize MB)" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   [ERROR] Failed to download: $_" -ForegroundColor Red
+        $success = $false
+        # Clean up partial downloads
+        Remove-Item -Path $modelFile -ErrorAction SilentlyContinue
+        Remove-Item -Path $jsonFile -ErrorAction SilentlyContinue
+    }
+
+    if ($success) {
+        $downloaded++
+        Write-Host "   Successfully downloaded: $voiceName" -ForegroundColor Green
+    } else {
+        $failed++
+    }
+}
+
+Write-Host ""
+Write-Host ("=" * 40) -ForegroundColor Cyan
+Write-Host "Download Summary:" -ForegroundColor Cyan
+Write-Host "   Successfully downloaded: $downloaded" -ForegroundColor Green
+if ($failed -gt 0) {
+    Write-Host "   Failed: $failed" -ForegroundColor Red
+}
+Write-Host "   Total extra voices available: $($alreadyDownloaded.Count + $downloaded)"
+Write-Host ""
+
+if ($downloaded -gt 0) {
+    Write-Host "Extra voices ready to use!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Try them:"
+    Write-Host "   /agent-vibes:provider switch piper"
+    Write-Host "   /agent-vibes:switch kristin"
+    Write-Host "   /agent-vibes:switch jenny"
+    Write-Host "   /agent-vibes:switch 16Speakers"
+}
+
+if ($downloaded -gt 0 -or $alreadyDownloaded.Count -gt 0) {
+    exit 0
+} else {
+    exit 1
+}

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

@@ -0,0 +1,294 @@
+#
+# File: .claude/hooks-windows/effects-manager.ps1
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0
+
+param(
+    [Parameter(Position=0)]
+    [string]$Command = "help",
+    [Parameter(Position=1)]
+    [string]$Arg1 = "",
+    [Parameter(Position=2)]
+    [string]$Arg2 = "default",
+    [Parameter(Position=3)]
+    [string]$Arg3 = ""
+)
+
+$ErrorActionPreference = "Continue"
+
+# Get script directory and config file path
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ConfigDir = Join-Path (Split-Path -Parent $ScriptDir) "config"
+$ConfigFile = Join-Path $ConfigDir "audio-effects.cfg"
+$ReverbLevelFile = Join-Path $ConfigDir "reverb-level.txt"
+
+# Reverb level mappings (sox format: reverberance HF-damping room-scale)
+$ReverbLevels = @{
+    "off"        = ""
+    "light"      = "reverb 20 50 50"
+    "medium"     = "reverb 40 50 70"
+    "heavy"      = "reverb 70 50 100"
+    "cathedral"  = "reverb 90 30 100"
+}
+
+function Get-AgentEffects {
+    param([string]$AgentName)
+
+    if (-not (Test-Path $ConfigFile)) {
+        Write-Output ""
+        return
+    }
+
+    $lines = Get-Content $ConfigFile
+    $configLine = $null
+
+    foreach ($line in $lines) {
+        if ($line -match "^$([regex]::Escape($AgentName))\|") {
+            $configLine = $line
+            break
+        }
+    }
+
+    if (-not $configLine) {
+        foreach ($line in $lines) {
+            if ($line -match "^default\|") {
+                $configLine = $line
+                break
+            }
+        }
+    }
+
+    if ($configLine) {
+        $parts = $configLine -split '\|'
+        if ($parts.Count -ge 2) {
+            Write-Output $parts[1]
+        } else {
+            Write-Output ""
+        }
+    } else {
+        Write-Output ""
+    }
+}
+
+function Set-Reverb {
+    param(
+        [string]$Level,
+        [string]$AgentName = "default",
+        [string]$ApplyAll = ""
+    )
+
+    if (-not $ReverbLevels.ContainsKey($Level)) {
+        Write-Output "Invalid reverb level: $Level"
+        Write-Output "Valid levels: off, light, medium, heavy, cathedral"
+        exit 1
+    }
+
+    $reverbEffect = $ReverbLevels[$Level]
+
+    # Always update reverb-level.txt for play-tts.ps1 compatibility
+    if ($ApplyAll -eq "--all" -or $AgentName -eq "default") {
+        Set-Content -Path $ReverbLevelFile -Value $Level -NoNewline
+    }
+
+    if (-not (Test-Path $ConfigFile)) {
+        Write-Output "Config file not found: $ConfigFile"
+        exit 1
+    }
+
+    $lines = Get-Content $ConfigFile
+    $newLines = @()
+
+    if ($ApplyAll -eq "--all") {
+        Write-Host "Setting reverb to '$Level' for all agents..."
+
+        foreach ($line in $lines) {
+            if ($line -match "^#" -or $line.Trim() -eq "" -or $line -match "^\|") {
+                $newLines += $line
+                continue
+            }
+
+            $parts = $line -split '\|', 4
+            if ($parts.Count -ge 4) {
+                $agent = $parts[0]
+                $soxEffects = $parts[1]
+                $bgFile = $parts[2]
+                $bgVol = $parts[3]
+
+                # Remove existing reverb from sox effects
+                $newEffects = $soxEffects -replace 'reverb\s+\d+\s+\d+\s+\d+', ''
+                $newEffects = ($newEffects -replace '\s+', ' ').Trim()
+
+                # Add new reverb if not off
+                if ($reverbEffect) {
+                    if ($newEffects) {
+                        $newEffects = "$reverbEffect $newEffects"
+                    } else {
+                        $newEffects = $reverbEffect
+                    }
+                }
+
+                $newLines += "$agent|$newEffects|$bgFile|$bgVol"
+            } else {
+                $newLines += $line
+            }
+        }
+
+        Set-Content -Path $ConfigFile -Value ($newLines -join "`n") -NoNewline
+        Write-Output "Reverb set to '$Level' for all agents"
+    } else {
+        Write-Host "Setting reverb to '$Level' for '$AgentName'..."
+
+        # Check if agent exists in config
+        $agentExists = $false
+        foreach ($line in $lines) {
+            if ($line -match "^$([regex]::Escape($AgentName))\|") {
+                $agentExists = $true
+                break
+            }
+        }
+
+        if (-not $agentExists) {
+            Add-Content -Path $ConfigFile -Value "${AgentName}|${reverbEffect}|agentvibes_soft_flamenco_loop.mp3|0.30"
+            Write-Output "Created new config for '$AgentName' with reverb '$Level'"
+            return
+        }
+
+        foreach ($line in $lines) {
+            if ($line -match "^#" -or $line.Trim() -eq "" -or $line -match "^\|") {
+                $newLines += $line
+                continue
+            }
+
+            $parts = $line -split '\|', 4
+            if ($parts.Count -ge 4 -and $parts[0] -eq $AgentName) {
+                $soxEffects = $parts[1]
+                $bgFile = $parts[2]
+                $bgVol = $parts[3]
+
+                # Remove existing reverb
+                $newEffects = $soxEffects -replace 'reverb\s+\d+\s+\d+\s+\d+', ''
+                $newEffects = ($newEffects -replace '\s+', ' ').Trim()
+
+                if ($reverbEffect) {
+                    if ($newEffects) {
+                        $newEffects = "$reverbEffect $newEffects"
+                    } else {
+                        $newEffects = $reverbEffect
+                    }
+                }
+
+                $newLines += "$($parts[0])|$newEffects|$bgFile|$bgVol"
+            } else {
+                $newLines += $line
+            }
+        }
+
+        Set-Content -Path $ConfigFile -Value ($newLines -join "`n") -NoNewline
+        Write-Output "Reverb set to '$Level' for '$AgentName'"
+    }
+}
+
+function Get-ReverbLevel {
+    param([string]$AgentName = "default")
+
+    $effects = Get-AgentEffects -AgentName $AgentName
+
+    if (-not $effects -or $effects -notmatch 'reverb') {
+        Write-Output "off"
+        return
+    }
+
+    if ($effects -match 'reverb\s+(\d+)\s+(\d+)\s+(\d+)') {
+        $reverbVal = [int]$Matches[1]
+        if ($reverbVal -le 20) {
+            Write-Output "light"
+        } elseif ($reverbVal -le 40) {
+            Write-Output "medium"
+        } elseif ($reverbVal -le 70) {
+            Write-Output "heavy"
+        } else {
+            Write-Output "cathedral"
+        }
+    } else {
+        Write-Output "off"
+    }
+}
+
+function Show-Effects {
+    if (-not (Test-Path $ConfigFile)) {
+        Write-Output "Config file not found: $ConfigFile"
+        exit 1
+    }
+
+    Write-Output "Current Audio Effects Configuration:"
+    Write-Output ""
+
+    $lines = Get-Content $ConfigFile
+    foreach ($line in $lines) {
+        if ($line -match "^#" -or $line.Trim() -eq "" -or $line -match "^\|") {
+            continue
+        }
+
+        $parts = $line -split '\|', 4
+        if ($parts.Count -ge 2) {
+            $agent = $parts[0]
+            $soxEffects = $parts[1]
+
+            $reverbLevel = "off"
+            if ($soxEffects -match 'reverb\s+(\d+)\s+(\d+)\s+(\d+)') {
+                $reverbVal = [int]$Matches[1]
+                if ($reverbVal -le 20) { $reverbLevel = "light" }
+                elseif ($reverbVal -le 40) { $reverbLevel = "medium" }
+                elseif ($reverbVal -le 70) { $reverbLevel = "heavy" }
+                else { $reverbLevel = "cathedral" }
+            }
+
+            Write-Output "   ${agent}: reverb=$reverbLevel"
+            if ($soxEffects) {
+                Write-Output "      Effects: $soxEffects"
+            }
+        }
+    }
+}
+
+# Main command dispatcher
+switch ($Command) {
+    "set-reverb" {
+        if (-not $Arg1) {
+            Write-Output "Usage: effects-manager.ps1 set-reverb <level> [agent-name] [--all]"
+            Write-Output "Levels: off, light, medium, heavy, cathedral"
+            exit 1
+        }
+        Set-Reverb -Level $Arg1 -AgentName $Arg2 -ApplyAll $Arg3
+    }
+    "get-reverb" {
+        $agent = if ($Arg1) { $Arg1 } else { "default" }
+        Get-ReverbLevel -AgentName $agent
+    }
+    "get-effects" {
+        $agent = if ($Arg1) { $Arg1 } else { "default" }
+        Get-AgentEffects -AgentName $agent
+    }
+    "list" {
+        Show-Effects
+    }
+    default {
+        Write-Output "Usage: effects-manager.ps1 {set-reverb|get-reverb|get-effects|list}"
+        Write-Output ""
+        Write-Output "Commands:"
+        Write-Output "  set-reverb <level> [agent] [--all]  Set reverb level"
+        Write-Output "  get-reverb [agent]                  Get current reverb level"
+        Write-Output "  get-effects [agent]                 Get all effects for agent"
+        Write-Output "  list                                List all agent effects"
+        Write-Output ""
+        Write-Output "Reverb Levels: off, light, medium, heavy, cathedral"
+        exit 1
+    }
+}

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

@@ -0,0 +1,193 @@
+#
+# File: .claude/hooks-windows/language-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 = "help",
+    [Parameter(Position=1)]
+    [string]$Arg1 = "",
+    [Parameter(Position=2)]
+    [string]$Arg2 = ""
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ClaudeDir = Split-Path -Parent $ScriptDir
+
+# Determine config directory
+if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
+    $ConfigClaudeDir = Join-Path $env:CLAUDE_PROJECT_DIR ".claude"
+} else {
+    $ConfigClaudeDir = $ClaudeDir
+}
+
+$LanguageFile = Join-Path $ConfigClaudeDir "tts-language.txt"
+if (-not (Test-Path $ConfigClaudeDir)) { New-Item -ItemType Directory -Path $ConfigClaudeDir -Force | Out-Null }
+
+# Language to Piper voice mapping
+$PiperVoices = @{
+    "spanish"    = "es_ES-davefx-medium"
+    "french"     = "fr_FR-siwis-medium"
+    "german"     = "de_DE-thorsten-medium"
+    "italian"    = "it_IT-riccardo-x_low"
+    "portuguese" = "pt_BR-faber-medium"
+    "chinese"    = "zh_CN-huayan-medium"
+    "japanese"   = "ja_JP-hikari-medium"
+    "korean"     = "ko_KR-eunyoung-medium"
+    "russian"    = "ru_RU-dmitri-medium"
+    "polish"     = "pl_PL-darkman-medium"
+    "dutch"      = "nl_NL-rdh-medium"
+    "turkish"    = "tr_TR-dfki-medium"
+    "arabic"     = "ar_JO-kareem-medium"
+    "hindi"      = "hi_IN-amitabh-medium"
+    "swedish"    = "sv_SE-nst-medium"
+    "danish"     = "da_DK-talesyntese-medium"
+    "norwegian"  = "no_NO-talesyntese-medium"
+    "finnish"    = "fi_FI-harri-medium"
+    "czech"      = "cs_CZ-jirka-medium"
+    "romanian"   = "ro_RO-mihai-medium"
+    "ukrainian"  = "uk_UA-lada-x_low"
+    "greek"      = "el_GR-rapunzelina-low"
+    "bulgarian"  = "bg_BG-valentin-medium"
+    "croatian"   = "hr_HR-gorana-medium"
+    "slovak"     = "sk_SK-lili-medium"
+}
+
+$SupportedLanguages = ($PiperVoices.Keys | Sort-Object) -join ", "
+
+function Get-PiperVoiceForLanguage {
+    param([string]$Lang)
+    $lang = $Lang.ToLower()
+    if ($PiperVoices.ContainsKey($lang)) { return $PiperVoices[$lang] }
+    return ""
+}
+
+function Get-ActiveProvider {
+    $provFile = Join-Path $ConfigClaudeDir "tts-provider.txt"
+    if (-not (Test-Path $provFile)) {
+        $provFile = Join-Path $env:USERPROFILE ".claude\tts-provider.txt"
+    }
+    if (Test-Path $provFile) { return (Get-Content $provFile -Raw).Trim() }
+    return "piper"
+}
+
+switch ($Command) {
+    "set" {
+        if (-not $Arg1) {
+            Write-Output "Usage: language-manager.ps1 set <language>"
+            exit 1
+        }
+
+        $lang = $Arg1.ToLower()
+
+        # Handle reset/english
+        if ($lang -in @("reset", "english", "en")) {
+            if (Test-Path $LanguageFile) {
+                Remove-Item $LanguageFile -Force
+                Write-Output "Language reset to English (default)"
+            } else {
+                Write-Output "Already using English (default)"
+            }
+            exit 0
+        }
+
+        # Validate language
+        if (-not $PiperVoices.ContainsKey($lang)) {
+            Write-Output "Language '$lang' not supported"
+            Write-Output ""
+            Write-Output "Supported languages:"
+            Write-Output $SupportedLanguages
+            exit 1
+        }
+
+        # Save language
+        Set-Content -Path $LanguageFile -Value $lang -NoNewline
+
+        $provider = Get-ActiveProvider
+        $recommendedVoice = Get-PiperVoiceForLanguage $lang
+
+        Write-Output "Language set to: $lang"
+        Write-Output "Recommended voice for $provider TTS: $recommendedVoice"
+        Write-Output ""
+        Write-Output "TTS will now speak in $lang."
+        Write-Output "Switch voice with: /agent-vibes:switch `"$recommendedVoice`""
+    }
+
+    "get" {
+        if (Test-Path $LanguageFile) {
+            $lang = (Get-Content $LanguageFile -Raw).Trim()
+            $provider = Get-ActiveProvider
+            $recommendedVoice = Get-PiperVoiceForLanguage $lang
+
+            Write-Output "Current language: $lang"
+            if ($recommendedVoice) {
+                Write-Output "Recommended voice ($provider): $recommendedVoice"
+            }
+        } else {
+            Write-Output "Current language: english (default)"
+            Write-Output "No multilingual voice required"
+        }
+    }
+
+    "code" {
+        if (Test-Path $LanguageFile) {
+            Write-Output (Get-Content $LanguageFile -Raw).Trim()
+        } else {
+            Write-Output "english"
+        }
+    }
+
+    "check-voice" {
+        if (-not $Arg1) {
+            Write-Output "Usage: language-manager.ps1 check-voice <voice-name>"
+            exit 1
+        }
+        $multilingual = @("Antoni", "Rachel", "Domi", "Bella", "Charlotte", "Matilda")
+        if ($Arg1 -in $multilingual) { Write-Output "yes" } else { Write-Output "no" }
+    }
+
+    "best-voice" {
+        $lang = "english"
+        if (Test-Path $LanguageFile) { $lang = (Get-Content $LanguageFile -Raw).Trim() }
+        if ($lang -eq "english") {
+            Write-Output ""
+        } else {
+            Write-Output (Get-PiperVoiceForLanguage $lang)
+        }
+    }
+
+    "voice-for-language" {
+        if (-not $Arg1) {
+            Write-Output "Usage: language-manager.ps1 voice-for-language <language> [provider]"
+            exit 1
+        }
+        Write-Output (Get-PiperVoiceForLanguage $Arg1.ToLower())
+    }
+
+    "list" {
+        Write-Output "Supported languages and recommended voices:"
+        Write-Output ""
+        foreach ($lang in ($PiperVoices.Keys | Sort-Object)) {
+            $voice = $PiperVoices[$lang]
+            Write-Output ("{0,-15} -> {1}" -f $lang, $voice)
+        }
+    }
+
+    default {
+        Write-Output "AgentVibes Language Manager"
+        Write-Output ""
+        Write-Output "Usage:"
+        Write-Output "  language-manager.ps1 set <language>                Set language"
+        Write-Output "  language-manager.ps1 get                          Get current language"
+        Write-Output "  language-manager.ps1 code                         Get language code only"
+        Write-Output "  language-manager.ps1 check-voice <name>           Check if voice is multilingual"
+        Write-Output "  language-manager.ps1 best-voice                   Get best voice for current language"
+        Write-Output "  language-manager.ps1 voice-for-language <lang>    Get voice for language"
+        Write-Output "  language-manager.ps1 list                         List all supported languages"
+        exit 1
+    }
+}