agentvibes 3.5.0 → 3.5.2

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

@@ -0,0 +1,176 @@
+#
+# File: .claude/hooks-windows/voice-manager-windows.ps1
+#
+# AgentVibes - Windows Voice Management
+#
+
+param(
+    [Parameter(Position = 0)]
+    [ValidateSet('list', 'switch', 'get')]
+    [string]$Command = 'list',
+
+    [Parameter(Position = 1)]
+    [string]$VoiceName
+)
+
+$ClaudeDir = "$env:USERPROFILE\.claude"
+$ProviderFile = "$ClaudeDir\tts-provider.txt"
+$VoiceSapiFile = "$ClaudeDir\tts-voice-sapi.txt"
+$VoicePiperFile = "$ClaudeDir\tts-voice-piper.txt"
+
+# Get active provider
+$ActiveProvider = "windows-sapi"
+if (Test-Path $ProviderFile) {
+    $ActiveProvider = (Get-Content $ProviderFile -Raw).Trim()
+}
+
+# Get SAPI voices
+function Get-SAPIVoices {
+    Add-Type -AssemblyName System.Speech
+
+    $synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+    $voices = @()
+
+    foreach ($voice in $synth.GetInstalledVoices()) {
+        $voices += $voice.VoiceInfo.Name
+    }
+
+    return $voices
+}
+
+# Get Piper voices
+function Get-PiperVoices {
+    $VoicesDir = "$ClaudeDir\piper-voices"
+
+    if (-not (Test-Path $VoicesDir)) {
+        return @()
+    }
+
+    $voices = @()
+    $onnxFiles = Get-ChildItem -Path $VoicesDir -Filter "*.onnx" -ErrorAction SilentlyContinue
+
+    foreach ($file in $onnxFiles) {
+        $name = $file.BaseName
+        $voices += $name
+    }
+
+    return $voices
+}
+
+# List available voices
+function List-Voices {
+    Write-Host ""
+    Write-Host "[VOICES] Available Voices by Provider" -ForegroundColor Cyan
+    Write-Host ""
+
+    # SAPI voices
+    Write-Host "[SAPI] Windows SAPI (Built-in):" -ForegroundColor Green
+    $sapiVoices = Get-SAPIVoices
+
+    if ($sapiVoices.Count -eq 0) {
+        Write-Host "   (No voices installed)" -ForegroundColor Gray
+    }
+    else {
+        $sapiVoices | ForEach-Object {
+            $marker = if ($_ -eq (Get-CurrentVoice $VoiceSapiFile)) { "*" } else { " " }
+            Write-Host "   [$marker] $_" -ForegroundColor White
+        }
+    }
+
+    Write-Host ""
+
+    # Piper voices
+    Write-Host "[PIPER] Piper (High Quality):" -ForegroundColor Green
+    $piperVoices = Get-PiperVoices
+
+    if ($piperVoices.Count -eq 0) {
+        Write-Host "   (No voices downloaded - run setup-windows.ps1)" -ForegroundColor Gray
+    }
+    else {
+        $piperVoices | ForEach-Object {
+            $marker = if ($_ -eq (Get-CurrentVoice $VoicePiperFile)) { "*" } else { " " }
+            Write-Host "   [$marker] $_" -ForegroundColor White
+        }
+    }
+
+    Write-Host ""
+    Write-Host "[ACTIVE] Active Provider: $ActiveProvider" -ForegroundColor Cyan
+    Write-Host ""
+}
+
+# Get current voice for provider
+function Get-CurrentVoice {
+    param([string]$VoiceFile)
+
+    if (Test-Path $VoiceFile) {
+        return (Get-Content $VoiceFile -Raw).Trim()
+    }
+
+    return $null
+}
+
+# Switch voice
+function Switch-Voice {
+    param([string]$NewVoice)
+
+    # Determine which provider's voice file to update
+    $VoiceFile = ""
+    $ValidVoices = @()
+
+    if ($ActiveProvider -eq "windows-sapi") {
+        $VoiceFile = $VoiceSapiFile
+        $ValidVoices = Get-SAPIVoices
+    }
+    elseif ($ActiveProvider -eq "windows-piper") {
+        $VoiceFile = $VoicePiperFile
+        $ValidVoices = Get-PiperVoices
+    }
+    elseif ($ActiveProvider -eq "soprano") {
+        Write-Host "[INFO] Soprano uses a single fixed voice (Soprano-1.1-80M)" -ForegroundColor Cyan
+        return $true
+    }
+
+    if ($ValidVoices -notcontains $NewVoice) {
+        Write-Host "[ERROR] Voice not found: $NewVoice" -ForegroundColor Red
+        Write-Host "Available voices for ${ActiveProvider}:" -ForegroundColor Yellow
+        $ValidVoices | ForEach-Object { Write-Host "   - $_" }
+        return $false
+    }
+
+    Set-Content -Path $VoiceFile -Value $NewVoice
+    Write-Host "[OK] Voice set to: $NewVoice" -ForegroundColor Green
+    return $true
+}
+
+# Show current voice
+function Show-CurrentVoice {
+    $VoiceFile = if ($ActiveProvider -eq "windows-sapi") { $VoiceSapiFile } else { $VoicePiperFile }
+    $CurrentVoice = Get-CurrentVoice $VoiceFile
+
+    if ($CurrentVoice) {
+        Write-Host "[VOICE] Current voice: $CurrentVoice ($ActiveProvider)" -ForegroundColor Cyan
+    }
+    else {
+        Write-Host "[VOICE] Using default voice ($ActiveProvider)" -ForegroundColor Cyan
+    }
+}
+
+# Main command routing
+switch ($Command) {
+    'list' {
+        List-Voices
+    }
+
+    'switch' {
+        if (-not $VoiceName) {
+            Write-Host "[ERROR] Voice name required" -ForegroundColor Red
+            List-Voices
+            exit 1
+        }
+        Switch-Voice $VoiceName | Out-Null
+    }
+
+    'get' {
+        Show-CurrentVoice
+    }
+}

package/README.md

@@ -4,14 +4,14 @@
 >
 > 🌐 **[agentvibes.org](https://agentvibes.org)**
 >
-> Professional text-to-speech for **Claude Code**, **Claude Desktop**, **Warp Terminal**, and **OpenClaw** - **Piper TTS (Free!)** or **macOS Say (Built-in!)**
+> Professional text-to-speech for **Claude Code**, **Claude Desktop**, **Warp Terminal**, and **OpenClaw** - **Soprano** (Neural), **Piper TTS** (Free!), **macOS Say** (Built-in!), or **Windows SAPI** (Zero Setup!)
 
 [![npm version](https://img.shields.io/npm/v/agentvibes)](https://www.npmjs.com/package/agentvibes)
 [![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
 [![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**: v3.4.1
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v3.5.2
 
 ---
 
@@ -40,19 +40,21 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ### 🎯 Key Features
 
-**⚡ NEW IN v3.4.0:**
+**🪟 NEW IN v3.5.2 — Native Windows Support:**
+- 🖥️ **Windows Native TTS** - Three providers: Soprano (neural), Piper (offline), Windows SAPI (zero setup). No WSL required!
+- 🎵 **Background Music** - 16 genre tracks (Bachata, Flamenco, Bossa Nova, City Pop, and more) mixed under voice
+- 🎛️ **Reverb & Audio Effects** - 5 reverb levels via ffmpeg (Light, Medium, Heavy, Cathedral)
+- 🔊 **Verbosity Control** - Choose how much Claude speaks: High, Medium, or Low
+- 🎨 **Beautiful Installer** - PowerShell installer with figlet banner, or use `npx agentvibes install`
+
+**⚡ v3.4.0 Highlights:**
 - 🎤 **Soprano TTS Provider** - Ultra-fast neural TTS with 20x CPU, 2000x GPU acceleration (thanks [@nathanchase](https://github.com/nathanchase)!)
 - 🛡️ **Security Hardening** - 9.5/10 score with comprehensive validation and timeouts
 - 🌐 **Environment Intelligence** - PulseAudio tunnel auto-detection for SSH scenarios
-- 🎯 **Smart Recommendations** - GPU/RAM-based provider suggestions in installer
-
-**✨ NEW IN v3.3.0:**
-- 📱 **AgentVibes Receiver** - Stream TTS from voiceless servers to your phone, laptop, or local machine via encrypted SSH tunnel
-- 🌐 **Voiceless Server Support** - Generate TTS on cloud servers (AWS, GCP, Azure) and play on any device with speakers
 
 **⚡ Core Features:**
 - ⚡ **One-Command Install** - Get started in 30 seconds (`npx agentvibes install`)
-- 🎭 **Multi-Provider Support** - Choose Piper TTS (50+ free voices, offline) or macOS Say (100+ built-in)
+- 🎭 **Multi-Provider Support** - Soprano (neural), Piper TTS (50+ free voices), macOS Say (100+ built-in), or Windows SAPI
 - 🎙️ **27+ Professional AI Voices** - Character voices, accents, and unique personalities
 - 🎙️ **Verbosity Control** - Choose how much Claude speaks (LOW, MEDIUM, HIGH)
 - 🎙️ **AgentVibes MCP** - Natural language control ("Switch to Aria voice") for Claude Code, Desktop & Warp
@@ -95,7 +97,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 - [📱 Android/Termux](#-quick-setup-android--termux-claude-code-on-your-phone) - Run Claude Code on your phone
 - [📋 Prerequisites](#-prerequisites) - What you actually need (Node.js + optional tools)
 - [✨ What is AgentVibes?](#-what-is-agentvibes) - Overview & key features
-- [📰 Latest Release](#-latest-release) - v3.4.0 - Soprano TTS & Security Hardening
+- [📰 Latest Release](#-latest-release) - v3.5.2 - Native Windows Support with Soprano, Piper & SAPI
 - [🪟 Windows Setup Guide for Claude Desktop](mcp-server/WINDOWS_SETUP.md) - Complete Windows installation with WSL & Python
 
 ### AgentVibes MCP (Natural Language Control)
@@ -139,25 +141,26 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v3.4.0 - Soprano TTS, Security Hardening & Environment Intelligence](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.4.1)** ⚡🛡️
+**[v3.5.2 - Native Windows Support: Soprano, Piper & SAPI Providers](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.5.2)** 🪟🎤
+
+AgentVibes v3.5.2 delivers native Windows support with a polished PowerShell installer offering three TTS providers (Soprano neural, Piper offline, Windows SAPI), background music selection from 16 genre tracks, reverb effects via ffmpeg aecho filter, and verbosity control. The release includes 8 Windows hook scripts, MCP server platform detection for automatic .sh-to-.ps1 resolution, and 46 new unit tests. Security hardening adds path traversal prevention with regex allowlisting and path containment checks, reverb config allowlist validation, and strict mode compliance across all scripts. Cross-platform test fixes ensure the full 93-test suite passes on both Windows and Unix.
 
-AgentVibes v3.4.0 introduces Soprano TTS - an 80M parameter neural provider offering 20x CPU and 2000x GPU acceleration with sub-1GB memory footprint - plus comprehensive security hardening (timeouts, bounds checking, NaN validation) achieving a 9.5/10 security score, and intelligent environment detection that recognizes PulseAudio tunnels as working audio for remote scenarios. The enhanced installer provides GPU-based provider recommendations and context-aware messaging. Special thanks to [@nathanchase](https://github.com/nathanchase) for contributing the Soprano TTS Provider integration!
+Install via `npx agentvibes install` or the standalone PowerShell installer (`.\setup-windows.ps1`). No WSL required!
 
 **Key Highlights:**
-- ⚡ **Soprano TTS Provider** - Ultra-fast neural TTS with 20x CPU, 2000x GPU acceleration (thanks @nathanchase!)
-- 🛡️ **Security Hardening** - 9.5/10 score with timeouts on system commands and comprehensive validation
-- 🌐 **Environment Intelligence** - PulseAudio tunnel auto-detection for SSH + tunnel scenarios
-- 🎯 **Smart Recommendations** - GPU/RAM-based provider suggestions (Soprano for CUDA, macOS Say for Apple)
-- 📱 **Provider-Aware Voice Pages** - Soprano shows model specs, auto-selects single voice
-- 🧪 **260/260 Tests Passing** - Complete suite coverage with all edge cases fixed
-- 🎨 **Better UX** - Context-aware messaging ("PulseAudio Tunnel Detected!" vs "speakers")
+- 🖥️ **Native Windows TTS** - Three providers: Soprano, Piper, and Windows SAPI. No WSL needed!
+- 🎵 **Background Music** - 16 genre tracks (Bachata, Flamenco, Bossa Nova, City Pop, and more)
+- 🎛️ **Reverb & Effects** - 5 reverb levels via ffmpeg aecho filter
+- 🔊 **Verbosity Control** - High (full reasoning), Medium (key updates), Low (essential only)
+- 🎨 **Beautiful Installer** - Figlet banner, directory explanations, provider detection
+- 🧪 **93/93 Tests Passing** - 46 Windows + 47 cross-platform
+- 🛡️ **Security Hardened** - Path traversal prevention, input sanitization, resource disposal
 
 **Perfect For:**
-- GPU users wanting ultra-fast TTS (2000x real-time with CUDA)
-- Low-RAM systems (<1GB memory footprint with Soprano)
-- SSH sessions with PulseAudio tunnels (auto-detected)
-- Production deployments requiring security hardening
-- Any environment needing intelligent provider selection
+- Windows developers wanting native TTS without WSL
+- Teams needing zero-setup voice (Windows SAPI works out of the box)
+- Users wanting background music and reverb effects
+- Anyone installing via `npx agentvibes install` on Windows
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`
 

package/RELEASE_NOTES.md

@@ -1,8 +1,8 @@
 # AgentVibes Release Notes
 
-## 📦 v3.5.0 - Native Windows Support: Soprano, Piper & SAPI Providers
+## 📦 v3.5.2 - Native Windows Support: Soprano, Piper & SAPI Providers
 
-**Release Date:** February 11, 2026
+**Release Date:** February 12, 2026
 
 ### 🎯 Why v3.5.0?
 
@@ -146,7 +146,7 @@ None - all changes are backward compatible. Existing Unix/macOS installations ar
 
 ---
 
-**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v3.4.1...v3.5.0
+**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v3.4.1...v3.5.2
 
 ---
 

package/WINDOWS-SETUP.md

@@ -0,0 +1,208 @@
+# AgentVibes Windows Native Setup
+
+This folder contains AgentVibes configured for **native Windows** (not WSL) with three TTS providers available.
+
+## Quick Start
+
+### 1. Open in VS Code (Native Windows)
+
+- **File > Open Folder** > Select this folder (`agentvibes-in-windows`)
+- Make sure you're opening in **native Windows VS Code** (not WSL remote)
+
+### 2. Open PowerShell Terminal
+
+- **Terminal > New Terminal**
+- Change shell to **PowerShell** (if needed)
+
+### 3. Run Setup
+
+```powershell
+.\setup-windows.ps1
+```
+
+This script will:
+- Check PowerShell version (5.1+)
+- Create `.claude` directories
+- Let you choose TTS provider (Piper or SAPI)
+- Install Piper if you choose it
+- Download a default voice model
+- Test TTS
+- Configure for first use
+
+### 4. Install Dependencies
+
+```powershell
+npm install
+```
+
+### 5. Start Using AgentVibes
+
+Open a Claude Code session in this project. The SessionStart hook will automatically inject TTS protocol instructions, causing Claude to speak all responses.
+
+## TTS Providers
+
+### Option 1: Soprano (Best Quality)
+- **Quality**: Ultra-high (80M parameter neural model)
+- **Voices**: Single high-quality voice (Soprano-1.1-80M)
+- **Download**: `pip install soprano-tts`
+- **Setup**: Start WebUI with `soprano-webui` or API with `uvicorn soprano.server:app`
+- **Speed**: GPU-accelerated, very fast
+- **Features**: Gradio WebUI mode, OpenAI-compatible API mode, CLI fallback
+
+To set up Soprano:
+```powershell
+# Install Soprano
+pip install soprano-tts
+
+# Start WebUI (recommended - stays running in background)
+soprano-webui
+
+# Set provider
+.\.claude\hooks-windows\provider-manager.ps1 set soprano
+
+# Test
+.\.claude\hooks-windows\play-tts-soprano.ps1 "Hello from Soprano"
+```
+
+### Option 2: Windows Piper (Recommended for Offline)
+- **Quality**: High (neural voices)
+- **Voices**: 50+ available
+- **Download**: ~100MB
+- **Setup**: Automatic (run `setup-windows.ps1`)
+- **Speed**: Offline synthesis
+- **Features**: All AgentVibes features supported
+
+### Option 3: Windows SAPI (Built-in, Zero Setup)
+- **Quality**: Basic
+- **Voices**: ~10 built-in (David, Zira, Mark)
+- **Download**: 0 MB (no installation needed)
+- **Setup**: Select during `setup-windows.ps1`
+- **Speed**: Fast
+- **Features**: Core TTS only
+
+## Claude Code Integration
+
+AgentVibes hooks into Claude Code via `.claude/settings.json`. The SessionStart hook runs automatically when Claude starts a session:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [{
+      "hooks": [{
+        "type": "command",
+        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$CLAUDE_PROJECT_DIR\\.claude\\hooks-windows\\session-start-tts.ps1\""
+      }]
+    }]
+  }
+}
+```
+
+This injects TTS protocol instructions so Claude speaks every response using the configured provider.
+
+## Manual Commands
+
+Test TTS manually:
+
+```powershell
+# Test current provider
+.\.claude\hooks-windows\play-tts.ps1 "Hello from Windows"
+
+# Test specific providers
+.\.claude\hooks-windows\play-tts-windows-sapi.ps1 "Hello SAPI"
+.\.claude\hooks-windows\play-tts-windows-piper.ps1 "Hello Piper"
+.\.claude\hooks-windows\play-tts-soprano.ps1 "Hello Soprano"
+
+# List available voices
+.\.claude\hooks-windows\voice-manager-windows.ps1 list
+
+# Switch voice (for Piper/SAPI)
+.\.claude\hooks-windows\voice-manager-windows.ps1 switch "en_US-lessac-high"
+
+# List providers
+.\.claude\hooks-windows\provider-manager.ps1 list
+
+# Switch provider
+.\.claude\hooks-windows\provider-manager.ps1 set soprano
+.\.claude\hooks-windows\provider-manager.ps1 set windows-piper
+.\.claude\hooks-windows\provider-manager.ps1 set windows-sapi
+```
+
+## Troubleshooting
+
+### PowerShell Execution Policy Error
+
+If you get an "execution policy" error, run:
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+Then try again.
+
+### No Audio Playing
+
+1. Check Windows volume isn't muted
+2. Try switching to SAPI provider (zero-setup): `.\.claude\hooks-windows\provider-manager.ps1 set windows-sapi`
+3. Test SAPI directly: `.\.claude\hooks-windows\play-tts-windows-sapi.ps1 "test"`
+
+### Soprano Not Detected
+
+1. Ensure soprano-webui is running: `soprano-webui`
+2. Check port 7860 is accessible: `Test-NetConnection -ComputerName 127.0.0.1 -Port 7860`
+3. Set custom port if needed: `$env:SOPRANO_PORT = "8080"` before running TTS
+
+### Piper Installation Failed
+
+1. Check internet connection
+2. Run setup again: `.\setup-windows.ps1`
+3. Or manually download from: https://github.com/rhasspy/piper/releases
+
+### Can't Find Voice
+
+For Piper, voices are stored in: `%USERPROFILE%\.claude\piper-voices\`
+
+You can download additional voices with `.\download-piper-voices.ps1`.
+
+## Architecture
+
+```
+agentvibes-in-windows/
+├── .claude/
+│   ├── hooks-windows/               # PowerShell TTS scripts
+│   │   ├── play-tts.ps1             # Main router (dispatches to active provider)
+│   │   ├── play-tts-soprano.ps1     # Soprano provider
+│   │   ├── play-tts-windows-piper.ps1  # Piper provider
+│   │   ├── play-tts-windows-sapi.ps1   # SAPI provider
+│   │   ├── soprano-gradio-synth.py  # Python helper for Soprano Gradio API
+│   │   ├── provider-manager.ps1     # Provider switching
+│   │   ├── voice-manager-windows.ps1   # Voice management
+│   │   ├── session-start-tts.ps1    # SessionStart hook (injects TTS protocol)
+│   │   └── audio-cache-utils.ps1    # Audio cache cleanup
+│   ├── settings.json                # Claude Code hooks config
+│   ├── audio/                       # Audio cache (auto-created)
+│   ├── piper-voices/                # Piper voice models (auto-created)
+│   └── tts-provider.txt             # Active provider config
+├── setup-windows.ps1                # Installation script
+├── download-piper-voices.ps1        # Download additional Piper voices
+└── WINDOWS-SETUP.md                 # This file
+```
+
+## What's Different from WSL
+
+| Feature | WSL Version | Windows Native |
+|---------|-------------|----------------|
+| **TTS Scripts** | Bash shell scripts (.sh) | PowerShell scripts (.ps1) |
+| **Audio** | PulseAudio/paplay | System.Media.SoundPlayer |
+| **Providers** | Piper, macOS, Termux, Soprano | Piper, SAPI, Soprano |
+| **Setup** | WSL + PulseAudio config | Native Windows only |
+| **Hook Dir** | `.claude/hooks/` | `.claude/hooks-windows/` |
+
+## Support
+
+- **Documentation**: https://agentvibes.org
+- **Issues**: https://github.com/paulpreibisch/AgentVibes/issues
+
+---
+
+**Version**: 2.0 (Windows Native + Soprano)
+**Last Updated**: 2026-02-11

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "3.5.0",
+  "version": "3.5.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": [
@@ -50,6 +50,7 @@
     ".claude/commands/agent-vibes-bmad-voices.md",
     ".claude/commands/agent-vibes-rdp.md",
     ".claude/hooks/",
+    ".claude/hooks-windows/",
     ".claude/personalities/",
     ".claude/output-styles/",
     ".claude/audio/tracks/",
@@ -63,6 +64,8 @@
     ".claude/github-star-reminder.txt",
     ".clawdbot/",
     ".mcp.json",
+    "setup-windows.ps1",
+    "WINDOWS-SETUP.md",
     "README.md",
     "RELEASE_NOTES.md",
     "LICENSE",