agentvibes 3.5.1 → 3.5.3

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.5.0
+**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)
+- ⚡ **One-Command Install** - Get started in 30 seconds (`npx agentvibes install` or `.\setup-windows.ps1` without Node.js)
+- 🎭 **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.5.0)** ⚡🛡️
+**[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?
 
@@ -133,6 +133,9 @@ None - all changes are backward compatible. Existing Unix/macOS installations ar
 
 ## 🙏 Acknowledgments
 
+### Project Lead
+- **[@paulpreibisch](https://github.com/paulpreibisch)** (Paul Preibisch) — Creator and maintainer of AgentVibes
+
 ### Community Contributors
 - **[@nathanchase](https://github.com/nathanchase)** — For contributing the Soprano TTS provider in v3.4.0, whose ultra-fast neural engine is now one of the three Windows-native providers
 - **[@alexeyv](https://github.com/alexeyv)** — For suggesting native Windows support and recommending Windows SAPI as a zero-dependency provider
@@ -146,7 +149,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/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "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/setup-windows.ps1

@@ -123,6 +123,26 @@ Write-BoxLine "   https://agentvibes.org" "DarkCyan"
 Write-BoxBottom
 Write-Host ""
 
+# ── What's New ──────────────────────────────────────────────
+
+Write-Host "  WHAT'S NEW in v$Version" -ForegroundColor Green
+Write-Host ""
+Write-Host "    Native Windows support with three TTS providers (Soprano neural," -ForegroundColor Cyan
+Write-Host "    Piper offline, Windows SAPI), background music from 16 genre tracks," -ForegroundColor Cyan
+Write-Host "    reverb effects via ffmpeg, and verbosity control." -ForegroundColor Cyan
+Write-Host ""
+Write-Host "    Thanks to @nathanchase (Soprano), @alexeyv (Windows SAPI)," -ForegroundColor Yellow
+Write-Host "    @bmadcode (BMAD Method)!" -ForegroundColor Yellow
+Write-Host ""
+Write-Host "    KEY HIGHLIGHTS:" -ForegroundColor Green
+Write-Host "      [*] Native Windows TTS - Soprano, Piper, SAPI. No WSL needed!" -ForegroundColor Gray
+Write-Host "      [*] Background Music - 16 genre tracks (Bachata, Flamenco, etc.)" -ForegroundColor Gray
+Write-Host "      [*] Reverb & Effects - 5 reverb levels via ffmpeg aecho filter" -ForegroundColor Gray
+Write-Host "      [*] Verbosity Control - High, Medium, or Low transparency" -ForegroundColor Gray
+Write-Host "      [*] Beautiful Installer - Figlet banner, provider detection" -ForegroundColor Gray
+Write-Host "      [*] 93/93 Tests Passing - 46 Windows + 47 cross-platform" -ForegroundColor Gray
+Write-Host ""
+
 # ── Node.js Detection ──────────────────────────────────────
 
 try {

package/src/installer.js

@@ -1602,19 +1602,20 @@ function showWelcome() {
  * Shown during install and update commands
  */
 function getReleaseInfoBoxen() {
-  return chalk.cyan.bold('📦 AgentVibes v3.4.0 - Soprano TTS & Security Hardening\n\n') +
+  return chalk.cyan.bold('📦 AgentVibes v3.5.2 - Native Windows Support: Soprano, Piper & SAPI\n\n') +
     chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
-    chalk.cyan('AgentVibes v3.4.0 introduces Soprano TTS - an 80M parameter neural provider with 20x CPU\n') +
-    chalk.cyan('and 2000x GPU acceleration - plus comprehensive security hardening (timeouts, bounds checking,\n') +
-    chalk.cyan('NaN validation) and intelligent environment detection that recognizes PulseAudio tunnels as\n') +
-    chalk.cyan('working audio for remote scenarios. Enhanced installer provides GPU-based recommendations.\n\n') +
-    chalk.yellow('🙏 Special thanks to community member @nathanchase for contributing Soprano TTS!\n\n') +
+    chalk.cyan('AgentVibes v3.5.2 brings native Windows support with three TTS providers (Soprano neural,\n') +
+    chalk.cyan('Piper offline, Windows SAPI), background music selection from 16 genre tracks, reverb effects\n') +
+    chalk.cyan('via ffmpeg, and verbosity control. Includes 8 Windows hook scripts, beautiful PowerShell\n') +
+    chalk.cyan('installer with figlet banner, and 46 new Windows-specific unit tests.\n\n') +
+    chalk.yellow('🙏 Thanks to @nathanchase (Soprano), @alexeyv (Windows SAPI), @bmadcode (BMAD Method)!\n\n') +
     chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
-    chalk.gray('   ⚡ Soprano TTS Provider - Ultra-fast neural TTS with GPU acceleration (thanks @nathanchase!)\n') +
-    chalk.gray('   🛡️ Security Hardening - 9.5/10 score with timeouts and comprehensive validation\n') +
-    chalk.gray('   🌐 Environment Intelligence - PulseAudio tunnel auto-detection for SSH scenarios\n') +
-    chalk.gray('   🎯 Smart Recommendations - GPU/RAM-based provider suggestions\n') +
-    chalk.gray('   🧪 260/260 Tests Passing - Complete test coverage with fixed edge cases\n\n') +
+    chalk.gray('   🖥️ Native Windows TTS - Soprano, Piper, and Windows SAPI providers. No WSL needed!\n') +
+    chalk.gray('   🎵 Background Music - 16 genre tracks (Bachata, Flamenco, Bossa Nova, City Pop, and more)\n') +
+    chalk.gray('   🎛️ Reverb & Effects - 5 reverb levels via ffmpeg aecho filter\n') +
+    chalk.gray('   🔊 Verbosity Control - High, Medium, or Low transparency levels\n') +
+    chalk.gray('   🎨 Beautiful Installer - Figlet banner, directory explanations, provider detection\n') +
+    chalk.gray('   🧪 93/93 Tests Passing - 46 Windows + 47 cross-platform\n\n') +
     chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
     chalk.gray('🌐 Website: https://agentvibes.org\n') +
     chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +