agentvibes 5.1.0 → 5.1.2

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.2
 
 ---
 
@@ -43,6 +43,22 @@ Whether you're using Claude Code, GitHub Copilot, OpenAI Codex, Claude Desktop,
 
 ---
 
+## 🔀 v5.1.2 — MCP Per-LLM Routing Hotfix
+
+- **MCP server now reads `AGENTVIBES_LLM` env var** instead of hardcoding `copilot` — Codex / Copilot / Claude Code each get routed to their own per-LLM voice / pretext / music / effects config from `audio-effects.cfg`.
+- **MCP launcher templates set the env var** automatically — `.codex/config.toml`, `.vscode/mcp.json`, and `.mcp.json` all include `AGENTVIBES_LLM` for the right provider.
+- **24 new regression tests** prevent this class of bug from shipping again, including a `npm pack` content guard that fails the test suite if the working tree has uncommitted changes (the v5.1.0 disaster guard).
+
+If you already have AgentVibes installed, re-run the per-provider configure step or add `"env": { "AGENTVIBES_LLM": "<your-llm>" }` manually to your MCP config.
+
+---
+
+## 🩹 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,70 @@
 # AgentVibes Release Notes
 
+## 🔀 v5.1.2 — MCP Per-LLM Routing Hotfix
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **MCP server no longer hardcodes `-llm copilot`** — `mcp-server/server.py` was passing `-llm copilot` for every caller, regardless of whether the actual client was Codex, Copilot, or Claude Code. This meant per-LLM voice/pretext/music routing in `audio-effects.cfg` was effectively broken: all three providers fell through to the same `llm:copilot` lookup (or worse, the global default config). The server now reads `AGENTVIBES_LLM` from the environment and forwards that as the `-llm` value, falling back to no `-llm` flag if unset.
+
+- **MCP launcher templates set `AGENTVIBES_LLM`** — Each provider's MCP config now sets the env var so the server knows which LLM is calling:
+  - Codex: `.codex/config.toml` → `env = { AGENTVIBES_LLM = "codex" }`
+  - Copilot: `.vscode/mcp.json` → `"env": { "AGENTVIBES_LLM": "copilot" }`
+  - Claude Code: `.mcp.json` → `"env": { "AGENTVIBES_LLM": "claude-code" }`
+
+  Both freshly-installed configs and the manual-instruction snippets shown by the installer include the env var.
+
+### Testing & Hardening
+
+- **24 new regression tests** in `test/unit/llm-provider-mcp-routing.test.js` and `test/unit/npm-pack-contents.test.js` enforce the contract end-to-end:
+  - Each MCP launcher template MUST set `AGENTVIBES_LLM` to the correct value
+  - `mcp-server/server.py` MUST read `AGENTVIBES_LLM` from env and MUST NOT hardcode `-llm copilot`
+  - `play-tts.ps1` MUST declare its `$llm` parameter, contain per-LLM lookup logic, export `AGENTVIBES_LLM_KEY`, and be at least 400 lines (catches the v5.1.0 mass-deletion regression)
+  - `play-tts.sh` MUST parse `--llm` and do per-LLM lookup against `audio-effects.cfg`
+  - **Working tree must be clean** before publishing (the v5.1.0 disaster guard — `npm publish` packs the working tree, not the git tag, so any uncommitted local edits get shipped)
+
+- The contract tests are **mutation-tested**: temporarily replacing `play-tts.ps1` with a broken stub fires 4 assertions with clear messages, proving the exact v5.1.0 regression would now block publish.
+
+### How to Update
+
+```
+npm cache clean --force
+npx --yes agentvibes@5.1.2
+```
+
+If you already have AgentVibes installed for one or more providers, re-run the installer's per-provider configure step (or manually add `"env": { "AGENTVIBES_LLM": "<your-llm>" }` to your `.mcp.json` / `.vscode/mcp.json` / `.codex/config.toml`).
+
+---
+
+## 🩹 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/mcp-server/server.py

@@ -194,18 +194,33 @@ class AgentVibesServer:
                 original_language = await self._get_language()
                 await self._run_script(self.LANGUAGE_MANAGER_SCRIPT, ["set", language])
 
-            # Call the TTS script via appropriate shell
+            # Call the TTS script via appropriate shell.
+            #
+            # The LLM key is read from the AGENTVIBES_LLM env var so each
+            # caller (Claude Code, GitHub Copilot, OpenAI Codex) gets routed
+            # to its own per-LLM voice / pretext / music / effects config.
+            # The MCP launcher in each provider's config file should set
+            # this env var (e.g. .codex/config.toml [mcp_servers.agentvibes]
+            # env = { AGENTVIBES_LLM = "codex" }).
+            #
+            # If unset, no -llm flag is passed and play-tts falls back to
+            # the project / global default config — which is the correct
+            # behavior for ad-hoc / unconfigured callers.
+            llm_key = os.environ.get("AGENTVIBES_LLM", "").strip()
             tts_script = "play-tts.ps1" if self.is_windows else "play-tts.sh"
             play_tts = self.hooks_dir / tts_script
             if self.is_windows:
-                args = ["powershell", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", str(play_tts), text, "-llm", "copilot"]
+                args = ["powershell", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", str(play_tts), text]
                 if voice:
                     args.extend(["-VoiceOverride", voice])
+                if llm_key:
+                    args.extend(["-llm", llm_key])
             else:
                 args = ["bash", str(play_tts), text]
                 if voice:
                     args.append(voice)
-                args.extend(["--llm", "copilot"])
+                if llm_key:
+                    args.extend(["--llm", llm_key])
 
             env = self._build_script_env()
             # Set agent name for audio effects lookup (audio-effects.cfg, background music config)

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.1.0",
+  "version": "5.1.2",
   "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": [

package/src/installer.js

@@ -4297,12 +4297,15 @@ function isPathSafe(targetPath, basePath) {
 async function handleMcpConfiguration(targetDir, options) {
   const mcpConfigPath = path.join(targetDir, '.mcp.json');
 
-  // MCP server configuration for AgentVibes
+  // MCP server configuration for AgentVibes.
+  // The AGENTVIBES_LLM env var tells the MCP server which LLM is calling
+  // so per-LLM voice / pretext / music / effects routing works correctly.
   const mcpConfig = {
     mcpServers: {
       agentvibes: {
         command: 'npx',
-        args: ['-y', '--package=agentvibes', 'agentvibes-mcp-server']
+        args: ['-y', '--package=agentvibes', 'agentvibes-mcp-server'],
+        env: { AGENTVIBES_LLM: 'claude-code' }
       }
     }
   };
@@ -4337,7 +4340,8 @@ async function handleMcpConfiguration(targetDir, options) {
     console.log(
       '\n"agentvibes": {\n' +
       '  "command": "npx",\n' +
-      '  "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]\n' +
+      '  "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"],\n' +
+      '  "env": { "AGENTVIBES_LLM": "claude-code" }\n' +
       '}\n'
     );
 
@@ -4442,7 +4446,8 @@ async function handleMcpConfiguration(targetDir, options) {
       '  "mcpServers": {\n' +
       '    "agentvibes": {\n' +
       '      "command": "npx",\n' +
-      '      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]\n' +
+      '      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"],\n' +
+      '      "env": { "AGENTVIBES_LLM": "claude-code" }\n' +
       '    }\n' +
       '  }\n' +
       '}\n'

package/src/services/llm-provider-service.js

@@ -228,6 +228,9 @@ export async function installCopilotMcp(targetDir) {
     type: 'stdio',
     command: 'npx',
     args: ['-y', '--package=agentvibes', 'agentvibes-mcp-server'],
+    // Tells the MCP server which LLM is calling so per-LLM voice / pretext
+    // / music / effects routing in audio-effects.cfg works correctly.
+    env: { AGENTVIBES_LLM: 'copilot' },
   };
 
   try {
@@ -337,6 +340,9 @@ export function buildCodexToml(existingContent = '') {
     '[mcp_servers.agentvibes]',
     'command = "npx"',
     'args = ["-y", "--package=agentvibes", "agentvibes-mcp-server"]',
+    // Tells the MCP server which LLM is calling so per-LLM voice / pretext
+    // / music / effects routing in audio-effects.cfg works correctly.
+    'env = { AGENTVIBES_LLM = "codex" }',
   ].join('\n');
 
   if (!existingContent.trim()) return serverBlock + '\n';