agentvibes 3.5.8 → 3.5.9

package/.claude/hooks/play-tts.sh

@@ -77,7 +77,7 @@ elif [[ -f "$GLOBAL_MUTE_FILE" ]]; then
   exit 0
 fi
 
-TEXT="$1"
+TEXT="${1:-}"
 VOICE_OVERRIDE="${2:-}"  # Optional: voice name or ID
 
 # Security: Validate inputs

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**: v3.5.8
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v3.5.9
 
 ---
 
@@ -97,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.5.8 Security & UX + v3.5.5 Native Windows Support
+- [📰 Latest Release](#-latest-release) - v3.5.9 Security & UX + v3.5.5 Native Windows Support
 - [🪟 Windows Setup Guide for Claude Desktop](mcp-server/WINDOWS_SETUP.md) - Complete Windows installation with WSL & Python
 
 ### AgentVibes MCP (Natural Language Control)
@@ -134,6 +134,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 - [🗑️ Uninstalling](#️-uninstalling) - Remove AgentVibes cleanly
 - [❓ FAQ](#-frequently-asked-questions-faq) - **NEW!** Common questions answered (git-lfs, MCP tokens, installation)
 - [🍎 macOS Testing](docs/macos-testing.md) - Automated testing on macOS with GitHub Actions
+- [🤗 Hugging Face Voice Models](docs/hugging-face-models.md) - Technical details on AI voice models
 - [🙏 Credits](#-credits) - Acknowledgments
 - [🤝 Contributing](#-contributing) - Show support
 
@@ -141,11 +142,11 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v3.5.8 - Security & Provider Validation](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.5.8)** 🛡️
+**[v3.5.9 - Security & Provider Validation](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.5.9)** 🛡️
 
 Critical security update: Fixed command injection vulnerabilities, HOME directory injection prevention, and path traversal protection. Soprano TTS installed via pipx now correctly detected. Enhanced provider detection messaging and debug logging.
 
-**Foundation Release:** [v3.5.5 - Native Windows Support](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.5.5) brings Windows support (Soprano, Piper, SAPI), background music (16 genre tracks), reverb/audio effects, and verbosity control. [See release notes](RELEASE_NOTES.md) for complete v3.5.5-3.5.8 history.
+**Foundation Release:** [v3.5.5 - Native Windows Support](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.5.9) brings Windows support (Soprano, Piper, SAPI), background music (16 genre tracks), reverb/audio effects, and verbosity control. [See release notes](RELEASE_NOTES.md) for complete v3.5.5-3.5.9 history.
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`
 
@@ -1467,6 +1468,9 @@ Both do the exact same thing - MCP is more convenient, slash commands are more t
 
 **Powered by:**
 - [Piper TTS](https://github.com/rhasspy/piper) - Free neural voices
+- [Soprano TTS](https://github.com/suno-ai/bark) - Ultra-fast neural TTS
+- **Windows SAPI** - Native Windows text-to-speech
+- **macOS Say** - Native macOS text-to-speech
 - [Claude Code](https://claude.com/claude-code) - AI coding assistant
 - Licensed under Apache 2.0
 

package/package.json

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

@@ -862,93 +862,103 @@ async function collectConfiguration(options = {}) {
         value: '__back__'
       });
 
-      const { provider } = await inquirer.prompt([{
-        type: 'list',
-        name: 'provider',
-        message: chalk.yellow('Select TTS provider:'),
-        choices: providerChoices,
-        default: config.provider || (isNativeWindows() ? 'windows-piper' : (isMacOS ? 'macos' : 'piper'))
-      }]);
-
-      // Check if user wants to go back
-      if (provider === '__back__') {
-        return null;
-      }
-
-      // Validate provider installation before accepting selection
-      console.log(chalk.gray(`\n   Checking for ${getProviderDisplayName(provider)}...`));
-      const validation = await validateProvider(provider);
-
-      if (!validation.installed) {
-        const displayName = getProviderDisplayName(provider);
-        console.log(chalk.yellow(`\n⚠️  ${validation.message}`));
-
-        const { action } = await inquirer.prompt([{
+      // Provider selection loop - allows user to try different providers without going back
+      let providerSelected = false;
+      while (!providerSelected) {
+        const { provider } = await inquirer.prompt([{
           type: 'list',
-          name: 'action',
-          message: 'What would you like to do?',
-          choices: [
-            { name: chalk.green('Install now (recommended)'), value: 'install' },
-            { name: 'Choose a different provider', value: 'back' },
-            { name: 'I\'ll install it myself later', value: 'skip' }
-          ]
+          name: 'provider',
+          message: chalk.yellow('Select TTS provider:'),
+          choices: providerChoices,
+          default: config.provider || (isNativeWindows() ? 'windows-piper' : (isMacOS ? 'macos' : 'piper'))
         }]);
 
-        if (action === 'install') {
-          console.log(chalk.cyan(`\n📦 Installing ${displayName}...\n`));
-
-          // Use smart installation with fallbacks
-          const installResult = await attemptProviderInstallation(provider);
-
-          if (installResult.success && installResult.verified) {
-            // Installation succeeded AND verified
-            console.log(chalk.green(`\n✓ ${displayName} installed and verified!\n`));
-            console.log(chalk.gray(`   Method: ${installResult.command}`));
-            console.log(chalk.green(`   Status: Ready to use\n`));
-          } else if (installResult.success) {
-            // Installation command ran but verification failed
-            console.log(chalk.yellow(`\n⚠️  Installation command completed, but verification failed\n`));
-            console.log(chalk.gray(`   The installation may have been blocked by system protection (PEP 668).\n`));
-            console.log(chalk.cyan(`   Try one of these solutions:\n`));
-            console.log(chalk.gray(`   1. Use pipx (avoids system protection):\n      pipx install soprano-tts\n`));
-            console.log(chalk.gray(`   2. Create a virtual environment:\n      python3 -m venv ~/my-env\n      ~/my-env/bin/pip install soprano-tts\n`));
-
-            // Pause before returning to provider selection
-            await inquirer.prompt([{
-              type: 'confirm',
-              name: 'continue',
-              message: 'Press Enter to go back to provider selection',
-              default: true
-            }]);
-
-            return null; // Go back to provider selection
-          } else {
-            console.log(chalk.red(`\n❌ ${installResult.message}\n`));
+        // Check if user wants to go back to previous page
+        if (provider === '__back__') {
+          return null;
+        }
 
-            // Pause before returning to provider selection
-            await inquirer.prompt([{
-              type: 'confirm',
-              name: 'continue',
-              message: 'Press Enter to go back to provider selection',
-              default: true
-            }]);
+        // Validate provider installation before accepting selection
+        console.log(chalk.gray(`\n   Checking for ${getProviderDisplayName(provider)}...`));
+        const validation = await validateProvider(provider);
+
+        if (!validation.installed) {
+          const displayName = getProviderDisplayName(provider);
+          console.log(chalk.yellow(`\n⚠️  ${validation.message}`));
+
+          const { action } = await inquirer.prompt([{
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: [
+              { name: chalk.green('Install now (recommended)'), value: 'install' },
+              { name: 'Choose a different provider', value: 'back' },
+              { name: 'I\'ll install it myself later', value: 'skip' }
+            ]
+          }]);
 
-            return null; // Go back to provider selection
+          if (action === 'install') {
+            console.log(chalk.cyan(`\n📦 Installing ${displayName}...\n`));
+
+            // Use smart installation with fallbacks
+            const installResult = await attemptProviderInstallation(provider);
+
+            if (installResult.success && installResult.verified) {
+              // Installation succeeded AND verified
+              console.log(chalk.green(`\n✓ ${displayName} installed and verified!\n`));
+              console.log(chalk.gray(`   Method: ${installResult.command}`));
+              console.log(chalk.green(`   Status: Ready to use\n`));
+              config.provider = provider;
+              providerSelected = true; // Exit provider selection loop
+            } else if (installResult.success) {
+              // Installation command ran but verification failed
+              console.log(chalk.yellow(`\n⚠️  Installation command completed, but verification failed\n`));
+              console.log(chalk.gray(`   The installation may have been blocked by system protection (PEP 668).\n`));
+              console.log(chalk.cyan(`   Try one of these solutions:\n`));
+              console.log(chalk.gray(`   1. Use pipx (avoids system protection):\n      pipx install soprano-tts\n`));
+              console.log(chalk.gray(`   2. Create a virtual environment:\n      python3 -m venv ~/my-env\n      ~/my-env/bin/pip install soprano-tts\n`));
+
+              // Pause before returning to provider selection
+              await inquirer.prompt([{
+                type: 'confirm',
+                name: 'continue',
+                message: 'Press Enter to try a different provider',
+                default: true
+              }]);
+
+              // Loop back to provider selection
+              continue;
+            } else {
+              console.log(chalk.red(`\n❌ ${installResult.message}\n`));
+
+              // Pause before returning to provider selection
+              await inquirer.prompt([{
+                type: 'confirm',
+                name: 'continue',
+                message: 'Press Enter to try a different provider',
+                default: true
+              }]);
+
+              // Loop back to provider selection
+              continue;
+            }
+          } else if (action === 'back') {
+            // Loop back to provider selection to choose a different one
+            continue;
+          } else if (action === 'skip') {
+            console.log(chalk.yellow(`\n⚠️  No problem! You can set it up anytime with:\n   ${getProviderInstallCommand(provider)}\n`));
+            config.provider = provider;
+            providerSelected = true; // Exit provider selection loop
           }
-        } else if (action === 'back') {
-          // Go back to provider selection
-          return null;
-        } else if (action === 'skip') {
-          console.log(chalk.yellow(`\n⚠️  No problem! You can set it up anytime with:\n   ${getProviderInstallCommand(provider)}\n`));
+        } else {
+          // Provider detected and ready to use
+          const displayName = getProviderDisplayName(provider);
+          console.log(chalk.green(`\n✓ ${displayName} Detected and selected!\n`));
+          config.provider = provider;
+          providerSelected = true; // Exit provider selection loop
         }
-      } else {
-        // Provider detected and ready to use
-        const displayName = getProviderDisplayName(provider);
-        console.log(chalk.green(`\n✓ ${displayName} Detected and selected!\n`));
       }
 
-      config.provider = provider;
-
       // Handle special receiver mode for Termux
       if (config.provider === 'piper-receiver') {
         config.provider = 'piper';