agentvibes 5.1.0 → 5.1.1

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

@@ -10,21 +10,25 @@ param(
     [string]$Text,
 
     [Parameter(Mandatory = $false, Position = 1)]
-    [string]$VoiceOverride
+    [string]$VoiceOverride,
+
+    [Parameter(Mandatory = $false)]
+    [string]$llm = ""
 )
 
 # Configuration paths
 # Priority: CLAUDE_PROJECT_DIR env var → script's parent project → user profile
+# Local project settings ALWAYS override global (~/.claude)
 $ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
 
 if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
     $ClaudeDir = "$env:CLAUDE_PROJECT_DIR\.claude"
 } else {
     $PackageClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
-    if (Test-Path "$env:USERPROFILE\.claude\tts-provider.txt") {
-        $ClaudeDir = "$env:USERPROFILE\.claude"
-    } elseif (Test-Path $PackageClaudeDir) {
+    if (Test-Path $PackageClaudeDir) {
         $ClaudeDir = $PackageClaudeDir
+    } elseif (Test-Path "$env:USERPROFILE\.claude\tts-provider.txt") {
+        $ClaudeDir = "$env:USERPROFILE\.claude"
     } else {
         $ClaudeDir = "$env:USERPROFILE\.claude"
     }
@@ -42,9 +46,88 @@ if (Test-Path $MuteFile) {
     }
 }
 
+# Per-LLM config lookup: if --llm is passed, look up llm:<name> in audio-effects.cfg
+# Format: llm:<name>|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME|VOICE|PRETEXT
+$LlmVoice = ""
+$LlmPretext = ""
+$LlmReverb = ""
+$LlmEngine = ""
+$ProjectRoot = Split-Path -Parent $ClaudeDir
+$ConfigDir = "$ClaudeDir\config"
+
+if ($llm) {
+    $llmKey = "llm:$llm"
+    # Check project-local audio-effects.cfg first, then global
+    $cfgPaths = @(
+        "$ConfigDir\audio-effects.cfg",
+        "$env:USERPROFILE\.claude\config\audio-effects.cfg"
+    )
+    foreach ($cfgPath in $cfgPaths) {
+        if (-not $LlmVoice -and -not $LlmPretext -and (Test-Path $cfgPath)) {
+            foreach ($line in (Get-Content $cfgPath)) {
+                if ($line -match "^$([regex]::Escape($llmKey))\|") {
+                    $parts = $line -split '\|'
+                    # parts: [0]=key [1]=reverb_preset [2]=bg_file [3]=bg_vol [4]=voice [5]=pretext
+                    if ($parts.Length -ge 2 -and $parts[1].Trim()) {
+                        $LlmReverb = $parts[1].Trim()
+                    }
+                    if ($parts.Length -ge 5 -and $parts[4].Trim()) {
+                        $LlmVoice = $parts[4].Trim()
+                    }
+                    if ($parts.Length -ge 6 -and $parts[5].Trim()) {
+                        $LlmPretext = $parts[5].Trim()
+                    }
+                    if ($parts.Length -ge 7 -and $parts[6].Trim()) {
+                        $LlmEngine = $parts[6].Trim()
+                    }
+                    break
+                }
+            }
+        }
+    }
+    # Apply LLM voice override (only if no explicit VoiceOverride was passed)
+    if ($LlmVoice -and -not $VoiceOverride) {
+        $VoiceOverride = $LlmVoice
+    }
+    # Export LLM key for child scripts (process-local, not system-wide)
+    $env:AGENTVIBES_LLM_KEY = "llm:$llm"
+}
+
+# Prepend pretext if configured
+# Priority: LLM-specific pretext → project .agentvibes/config.json → project .claude/config/tts-pretext.txt
+#           → global ~/.agentvibes/config.json → global ~/.claude/config/tts-pretext.txt
+$Pretext = $LlmPretext
+if (-not $Pretext) {
+    $PretextSources = @(
+        (Join-Path $ProjectRoot ".agentvibes\config.json"),
+        "$ClaudeDir\config\tts-pretext.txt",
+        "$env:USERPROFILE\.agentvibes\config.json",
+        "$env:USERPROFILE\.claude\config\tts-pretext.txt"
+    )
+    foreach ($src in $PretextSources) {
+        if (-not $Pretext -and (Test-Path $src)) {
+            if ($src -match '\.json$') {
+                try {
+                    $avCfg = Get-Content $src -Raw | ConvertFrom-Json
+                    if ($avCfg.pretext) { $Pretext = $avCfg.pretext.Trim() }
+                } catch { }
+            } else {
+                $val = (Get-Content $src -Raw).Trim()
+                if ($val) { $Pretext = $val }
+            }
+        }
+    }
+}
+if ($Pretext) {
+    $Text = "$Pretext, $Text"
+}
+
 # Determine active provider
+# LLM-specific engine overrides global provider
 $ActiveProvider = "sapi"
-if (Test-Path $ProviderFile) {
+if ($LlmEngine) {
+    $ActiveProvider = $LlmEngine
+} elseif (Test-Path $ProviderFile) {
     $ActiveProvider = (Get-Content $ProviderFile -Raw).Trim()
 }
 
@@ -101,12 +184,17 @@ if (Test-Path $AgentVibesConfig) {
 }
 
 # Check if reverb is enabled (allowlist validation)
+# LLM-specific reverb overrides global setting
 $ReverbLevel = "off"
-$ReverbFile = "$ConfigDir\reverb-level.txt"
-if (Test-Path $ReverbFile) {
-    $reverbVal = (Get-Content $ReverbFile -Raw).Trim()
-    if ($reverbVal -in @("off", "light", "medium", "heavy", "cathedral")) {
-        $ReverbLevel = $reverbVal
+if ($LlmReverb -and $LlmReverb -in @("off", "light", "medium", "heavy", "cathedral")) {
+    $ReverbLevel = $LlmReverb
+} else {
+    $ReverbFile = "$ConfigDir\reverb-level.txt"
+    if (Test-Path $ReverbFile) {
+        $reverbVal = (Get-Content $ReverbFile -Raw).Trim()
+        if ($reverbVal -in @("off", "light", "medium", "heavy", "cathedral")) {
+            $ReverbLevel = $reverbVal
+        }
     }
 }
 $HasReverb = $ReverbLevel -ne "off"
@@ -133,10 +221,6 @@ $PreSynthWav = $env:AGENTVIBES_PRESYNTHESIZED_WAV
 $UsePreSynth = $PreSynthWav -and (Test-Path $PreSynthWav) -and
     (Get-Item $PreSynthWav -ErrorAction SilentlyContinue).Length -gt 0
 
-# Tracks the path of the WAV the provider just synthesized.
-# Used to defend against playing stale cached audio when synthesis silently fails.
-$SynthesizedWavPath = $null
-
 # If background music or reverb enabled and ffmpeg available, tell provider to skip playback
 if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
     $env:AGENTVIBES_NO_PLAY = "1"
@@ -171,25 +255,17 @@ if ($UsePreSynth) {
                 $providerOutput = & $ProviderScript $Text 6>&1 2>&1
             }
             # Re-emit preserving colors from InformationRecords (Write-Host output)
-            # Also extract the synthesized WAV path from the provider's OK line.
             foreach ($item in $providerOutput) {
-                $lineText = $null
                 if ($item -is [System.Management.Automation.InformationRecord]) {
                     $msg = $item.MessageData
                     if ($msg -is [System.Management.Automation.HostInformationMessage]) {
                         Write-Host $msg.Message -ForegroundColor $msg.ForegroundColor -NoNewline:$msg.NoNewLine
                         if (-not $msg.NoNewLine) { Write-Host }
-                        $lineText = $msg.Message
                     } else {
                         Write-Host "$item"
-                        $lineText = "$item"
                     }
                 } else {
                     Write-Host "$item"
-                    $lineText = "$item"
-                }
-                if ($lineText -and $lineText -match '\[OK\]\s+Saved to:\s+(.+\.wav)') {
-                    $SynthesizedWavPath = $Matches[1].Trim()
                 }
             }
         } else {
@@ -211,23 +287,13 @@ if ($UsePreSynth) {
 if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
     Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
 
-    # Find the WAV to post-process. Never fall back to "most recent on disk"
-    # because that plays a random stale cache file when synthesis silently fails.
+    # Find the WAV to post-process: use pre-synthesized file if available, else most recent
     $AudioDir = "$ClaudeDir\audio"
-    $RecentWav = $null
-    if ($UsePreSynth) {
-        $RecentWav = Get-Item $PreSynthWav -ErrorAction SilentlyContinue
-    }
-    elseif ($SynthesizedWavPath -and (Test-Path $SynthesizedWavPath)) {
-        $cand = Get-Item $SynthesizedWavPath -ErrorAction SilentlyContinue
-        if ($cand -and $cand.Length -gt 0) {
-            $RecentWav = $cand
-        }
-    }
-    if (-not $RecentWav) {
-        Write-Host "[ERROR] No fresh synthesized WAV - refusing stale cache" -ForegroundColor Red
-        Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
-        exit 1
+    $RecentWav = if ($UsePreSynth) {
+        Get-Item $PreSynthWav -ErrorAction SilentlyContinue
+    } else {
+        Get-ChildItem -Path $AudioDir -Filter "tts-*.wav" -ErrorAction SilentlyContinue |
+            Sort-Object LastWriteTime -Descending | Select-Object -First 1
     }
 
     if ($RecentWav -and $RecentWav.Length -gt 0) {
@@ -263,6 +329,7 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
             if (Test-Path $AudioEffectsCfg) {
                 # Try agent-specific config first, then fall back to default
                 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
+                # Lookup order: agent name → llm:<name> → default
                 $agentName = $env:AGENTVIBES_AGENT_NAME
                 $configLine = $null
 
@@ -275,6 +342,16 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                         }
                     }
                 }
+                # Try LLM-specific config (--llm parameter)
+                if (-not $configLine -and $llm) {
+                    $llmBgKey = "llm:$llm"
+                    foreach ($line in $cfgLines) {
+                        if ($line -match "^$([regex]::Escape($llmBgKey))\|") {
+                            $configLine = $line
+                            break
+                        }
+                    }
+                }
                 # Fall back to default
                 if (-not $configLine) {
                     foreach ($line in $cfgLines) {

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.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.1.1
 
 ---
 
@@ -43,6 +43,12 @@ Whether you're using Claude Code, GitHub Copilot, OpenAI Codex, Claude Desktop,
 
 ---
 
+## 🩹 v5.1.1 — Windows TTS Hook Hotfix
+
+- **`play-tts.ps1 -llm` parameter restored** — npm-published v5.1.0 shipped a regressed copy without `-llm` support, breaking the Setup tab Preview button and the agentvibes MCP `text_to_speech` tool on Windows. Fixed in v5.1.1. If you hit the error, clear your npx cache: `npm cache clean --force` then reinstall.
+
+---
+
 ## 🎙️ NEW IN v5.1.0 — Voice Picker Overhaul + Auto-Save Agent Modal
 
 - **Auto-save in agent modal** — Voice/personality/music/reverb/pretext changes save automatically as you edit them. Brief "✓ Saved!" toast confirms each change.

package/RELEASE_NOTES.md

@@ -1,5 +1,33 @@
 # AgentVibes Release Notes
 
+## 🩹 v5.1.1 — Windows TTS Hook Hotfix
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Windows `play-tts.ps1` `-llm` parameter restored** — A regression caused the npm-published v5.1.0 package to ship a `play-tts.ps1` that lacked the `-llm` parameter and the per-LLM config lookup. Per-LLM TTS routing on Windows failed with `A parameter cannot be found that matches parameter name 'llm'`. This affected:
+  - **Setup tab Preview button** for any provider configured with per-LLM voice/effects
+  - **agentvibes MCP `text_to_speech` tool** when called from Codex / Copilot / Claude Code
+  - Any code path that invokes `play-tts.ps1 ... -llm <provider>`
+
+  The git tag `v5.1.0` had the correct file all along — only the npm tarball was affected, because `npm publish` packs the working tree (which contained an uncommitted local regression) instead of the git tag.
+
+### How to Update
+
+If you installed v5.1.0 from npm and hit the `-llm` error, clear your npx cache and reinstall:
+
+```
+npm cache clean --force
+npx --yes agentvibes@5.1.1
+```
+
+### Note for Maintainers
+
+To prevent this kind of working-tree-vs-tag drift in future releases, the release workflow should run `npm publish` from a freshly checked-out clone of the tag, not from the development working directory.
+
+---
+
 ## 🎙️ v5.1.0 — Voice Picker Overhaul + Auto-Save Agent Modal
 
 **Release Date:** April 2026

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.1.0",
+  "version": "5.1.1",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [