agentvibes 5.1.3 → 5.2.0

package/.claude/hooks/piper-download-voices.sh

@@ -1,225 +1,233 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/piper-download-voices.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview Piper Voice Model Downloader - Batch downloads popular Piper TTS voices from HuggingFace
-# @context Post-installation utility to download commonly used voices (~25MB each)
-# @architecture Wrapper around piper-voice-manager.sh download functions with progress tracking
-# @dependencies piper-voice-manager.sh (download logic), piper binary (for validation)
-# @entrypoints Called by piper-installer.sh or manually via ./piper-download-voices.sh [--yes|-y]
-# @patterns Batch operations, skip-existing logic, auto-yes flag for non-interactive use
-# @related piper-voice-manager.sh, piper-installer.sh
-#
-
-# REQUIRED: Bash strict mode for security and reliability (CLAUDE.md)
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/piper-voice-manager.sh"
-
-# Parse command line arguments
-AUTO_YES=false
-if [[ "$1" == "--yes" ]] || [[ "$1" == "-y" ]]; then
-  AUTO_YES=true
-fi
-
-# Common voice models to download
-COMMON_VOICES=(
-  "en_US-ryan-high"          # Default, expressive male (30MB) - BMAD: John (pm)
-  "en_US-amy-medium"         # Warm female (13MB) - BMAD: Mary (analyst)
-  "en_US-hfc_female-medium"  # Professional female (13MB) - BMAD: Amelia (dev)
-  "en_US-lessac-medium"      # Clear female (13MB) - BMAD: Murat (tea) - NOTE: Female voice
-  "en_US-danny-low"          # Calm male (13MB) - BMAD: Winston (architect)
-  "en_US-bryce-medium"       # Professional male (13MB) - BMAD: Bob (sm)
-  "en_US-kathleen-low"       # Clear female (13MB) - BMAD: Paige (tech-writer)
-  "en_US-kusal-medium"       # Male voice (13MB) - BMAD: Saif (frame-expert)
-  "en_US-kristin-medium"     # Female voice (13MB) - BMAD: Sally (ux-designer)
-  "en_US-libritts_r-medium"  # Premium male (57MB) - BMAD: BMad Master (NOTE: Changed from -high to -medium, -high doesn't exist)
-  "en_US-libritts-high"      # Premium quality (57MB)
-)
-
-echo "🎙️  Piper Voice Model Downloader"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "This will download the most commonly used Piper voice models."
-echo "Each voice is approximately 25MB."
-echo ""
-
-# Check if piper is installed
-if ! command -v piper &> /dev/null; then
-  echo "❌ Error: Piper TTS not installed" >&2
-  echo "Install with: pipx install piper-tts" >&2
-  exit 1
-fi
-
-# Get storage directory
-VOICE_DIR=$(get_voice_storage_dir)
-
-echo "📂 Storage location: \"$VOICE_DIR\""
-echo ""
-
-# Count already downloaded
-ALREADY_DOWNLOADED=0
-ALREADY_DOWNLOADED_LIST=()
-NEED_DOWNLOAD=()
-
-for voice in "${COMMON_VOICES[@]}"; do
-  if verify_voice "$voice" 2>/dev/null; then
-    ((ALREADY_DOWNLOADED++))
-    ALREADY_DOWNLOADED_LIST+=("$voice")
-  else
-    NEED_DOWNLOAD+=("$voice")
-  fi
-done
-
-echo "📊 Status:"
-echo "   Already downloaded: \"$ALREADY_DOWNLOADED\" voice(s)"
-echo "   Need to download: \"${#NEED_DOWNLOAD[@]}\" voice(s)"
-echo ""
-
-# Show already downloaded voices
-if [[ $ALREADY_DOWNLOADED -gt 0 ]]; then
-  echo "✅ Already downloaded (skipped):"
-  for voice in "${ALREADY_DOWNLOADED_LIST[@]}"; do
-    echo "   ✓ $voice"
-  done
-  echo ""
-fi
-
-if [[ ${#NEED_DOWNLOAD[@]} -eq 0 ]]; then
-  echo "🎉 All common voices ready to use!"
-  exit 0
-fi
-
-echo "Voices to download:"
-for voice in "${NEED_DOWNLOAD[@]}"; do
-  echo "  • $voice (~25MB)"
-done
-echo ""
-
-# Ask for confirmation (skip if --yes flag provided)
-if [[ "$AUTO_YES" == "false" ]]; then
-  read -p "Download ${#NEED_DOWNLOAD[@]} voice model(s)? [Y/n]: " -n 1 -r
-  echo
-
-  # Validate input is Y, y, N, n, or empty (default to Y)
-  if [[ ! $REPLY =~ ^[YyNn]?$ ]]; then
-    echo "❌ Invalid input. Please enter Y or N." >&2
-    exit 1
-  fi
-
-  if [[ $REPLY =~ ^[Nn]$ ]]; then
-    echo "❌ Download cancelled" >&2
-    exit 0
-  fi
-else
-  echo "Auto-downloading ${#NEED_DOWNLOAD[@]} voice model(s)..."
-  echo ""
-fi
-
-# Download each voice
-DOWNLOADED=0
-FAILED=0
-
-for voice in "${NEED_DOWNLOAD[@]}"; do
-  echo ""
-  echo "📥 Downloading: $voice..."
-
-  if download_voice "$voice"; then
-    ((DOWNLOADED++))
-    voice_path="$VOICE_DIR/${voice}.onnx"
-    file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
-    echo "   ✓ Downloaded: $voice"
-    echo "   📁 Path: $voice_path"
-    echo "   📦 Size: $file_size"
-  else
-    ((FAILED++))
-    echo "   ✗ Failed: $voice"
-  fi
-done
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📊 Download Summary:"
-echo ""
-echo "Installed voices:"
-for voice in "${ALREADY_DOWNLOADED_LIST[@]}"; do
-  voice_path="$VOICE_DIR/${voice}.onnx"
-  file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
-  echo "   ✓ $voice ($file_size)"
-  echo "     $voice_path"
-done
-
-if [[ $DOWNLOADED -gt 0 ]]; then
-  echo ""
-  echo "Just downloaded:"
-  for voice in "${NEED_DOWNLOAD[@]}"; do
-    voice_path="$VOICE_DIR/${voice}.onnx"
-    if [[ -f "$voice_path" ]]; then
-      file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
-      echo "   ✓ $voice ($file_size)"
-      echo "     $voice_path"
-    fi
-  done
-fi
-
-if [[ $FAILED -gt 0 ]]; then
-  echo ""
-  echo "Failed downloads:"
-  for voice in "${NEED_DOWNLOAD[@]}"; do
-    voice_path="$VOICE_DIR/${voice}.onnx"
-    if [[ ! -f "$voice_path" ]]; then
-      echo "   ✗ $voice"
-    fi
-  done
-fi
-
-echo ""
-echo "Total: $((ALREADY_DOWNLOADED + DOWNLOADED)) voices available"
-echo ""
-
-if [[ $DOWNLOADED -gt 0 ]]; then
-  echo "✨ Ready to use Piper TTS with downloaded voices!"
-  echo ""
-  echo "Try it:"
-  echo "  /agent-vibes:provider switch piper"
-  echo "  /agent-vibes:preview"
-fi
-
-# Exit with error code if any downloads failed (Unix convention)
-if [[ $FAILED -gt 0 ]]; then
-  echo "" >&2
-  echo "⚠️  Warning: $FAILED download(s) failed. Some voices may not be available." >&2
-  exit 1
-fi
-
-exit 0
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/piper-download-voices.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview Piper Voice Model Downloader - Batch downloads popular Piper TTS voices from HuggingFace
+# @context Post-installation utility to download commonly used voices (~25MB each)
+# @architecture Wrapper around piper-voice-manager.sh download functions with progress tracking
+# @dependencies piper-voice-manager.sh (download logic), piper binary (for validation)
+# @entrypoints Called by piper-installer.sh or manually via ./piper-download-voices.sh [--yes|-y]
+# @patterns Batch operations, skip-existing logic, auto-yes flag for non-interactive use
+# @related piper-voice-manager.sh, piper-installer.sh
+#
+
+# REQUIRED: Bash strict mode for security and reliability (CLAUDE.md)
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/piper-voice-manager.sh"
+
+# Parse command line arguments
+AUTO_YES=false
+if [[ "$1" == "--yes" ]] || [[ "$1" == "-y" ]]; then
+  AUTO_YES=true
+fi
+
+# Common voice models to download
+COMMON_VOICES=(
+  "en_US-ryan-high"          # Default, expressive male (30MB) - BMAD: John (pm)
+  "en_US-amy-medium"         # Warm female (13MB) - BMAD: Mary (analyst)
+  "en_US-hfc_female-medium"  # Professional female (13MB) - BMAD: Amelia (dev)
+  "en_US-lessac-medium"      # Clear female (13MB) - BMAD: Murat (tea) - NOTE: Female voice
+  "en_US-danny-low"          # Calm male (13MB) - BMAD: Winston (architect)
+  "en_US-bryce-medium"       # Professional male (13MB) - BMAD: Bob (sm)
+  "en_US-kathleen-low"       # Clear female (13MB) - BMAD: Paige (tech-writer)
+  "en_US-kusal-medium"       # Male voice (13MB) - BMAD: Saif (frame-expert)
+  "en_US-kristin-medium"     # Female voice (13MB) - BMAD: Sally (ux-designer)
+  "en_US-libritts_r-medium"  # Premium male (57MB) - BMAD: BMad Master (NOTE: Changed from -high to -medium, -high doesn't exist)
+  "en_US-libritts-high"      # Premium quality (57MB)
+)
+
+echo "🎙️  Piper Voice Model Downloader"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "This will download the most commonly used Piper voice models."
+echo "Each voice is approximately 25MB."
+echo ""
+
+# Check if piper is installed
+if ! command -v piper &> /dev/null; then
+  echo "❌ Error: Piper TTS not installed" >&2
+  echo "Install with: pipx install piper-tts" >&2
+  exit 1
+fi
+
+# Get storage directory
+VOICE_DIR=$(get_voice_storage_dir)
+
+echo "📂 Storage location: \"$VOICE_DIR\""
+echo ""
+
+# Count already downloaded
+ALREADY_DOWNLOADED=0
+ALREADY_DOWNLOADED_LIST=()
+NEED_DOWNLOAD=()
+
+for voice in "${COMMON_VOICES[@]}"; do
+  if verify_voice "$voice" 2>/dev/null; then
+    ((ALREADY_DOWNLOADED++))
+    ALREADY_DOWNLOADED_LIST+=("$voice")
+  else
+    NEED_DOWNLOAD+=("$voice")
+  fi
+done
+
+echo "📊 Status:"
+echo "   Already downloaded: \"$ALREADY_DOWNLOADED\" voice(s)"
+echo "   Need to download: \"${#NEED_DOWNLOAD[@]}\" voice(s)"
+echo ""
+
+# Show already downloaded voices
+if [[ $ALREADY_DOWNLOADED -gt 0 ]]; then
+  echo "✅ Already downloaded (skipped):"
+  for voice in "${ALREADY_DOWNLOADED_LIST[@]}"; do
+    echo "   ✓ $voice"
+  done
+  echo ""
+fi
+
+if [[ ${#NEED_DOWNLOAD[@]} -eq 0 ]]; then
+  echo "🎉 All common voices ready to use!"
+  exit 0
+fi
+
+echo "Voices to download:"
+for voice in "${NEED_DOWNLOAD[@]}"; do
+  echo "  • $voice (~25MB)"
+done
+echo ""
+
+# Ask for confirmation (skip if --yes flag provided)
+if [[ "$AUTO_YES" == "false" ]]; then
+  read -p "Download ${#NEED_DOWNLOAD[@]} voice model(s)? [Y/n]: " -n 1 -r
+  echo
+
+  # Validate input is Y, y, N, n, or empty (default to Y)
+  if [[ ! $REPLY =~ ^[YyNn]?$ ]]; then
+    echo "❌ Invalid input. Please enter Y or N." >&2
+    exit 1
+  fi
+
+  if [[ $REPLY =~ ^[Nn]$ ]]; then
+    echo "❌ Download cancelled" >&2
+    exit 0
+  fi
+else
+  echo "Auto-downloading ${#NEED_DOWNLOAD[@]} voice model(s)..."
+  echo ""
+fi
+
+# Download each voice
+DOWNLOADED=0
+FAILED=0
+
+for voice in "${NEED_DOWNLOAD[@]}"; do
+  echo ""
+  echo "📥 Downloading: $voice..."
+
+  if download_voice "$voice"; then
+    ((DOWNLOADED++))
+    voice_path="$VOICE_DIR/${voice}.onnx"
+    file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
+    echo "   ✓ Downloaded: $voice"
+    echo "   📁 Path: $voice_path"
+    echo "   📦 Size: $file_size"
+  else
+    ((FAILED++))
+    echo "   ✗ Failed: $voice"
+  fi
+done
+
+# Patch LibriTTS speaker names for any libritts models (existing or just downloaded)
+VOICE_DIR=$(get_voice_storage_dir)
+for voice in "${COMMON_VOICES[@]}"; do
+  if [[ "$voice" == *libritts* ]] && [[ -f "$VOICE_DIR/${voice}.onnx.json" ]]; then
+    patch_libritts_speaker_names "$VOICE_DIR" "$voice"
+  fi
+done
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📊 Download Summary:"
+echo ""
+echo "Installed voices:"
+for voice in "${ALREADY_DOWNLOADED_LIST[@]}"; do
+  voice_path="$VOICE_DIR/${voice}.onnx"
+  file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
+  echo "   ✓ $voice ($file_size)"
+  echo "     $voice_path"
+done
+
+if [[ $DOWNLOADED -gt 0 ]]; then
+  echo ""
+  echo "Just downloaded:"
+  for voice in "${NEED_DOWNLOAD[@]}"; do
+    voice_path="$VOICE_DIR/${voice}.onnx"
+    if [[ -f "$voice_path" ]]; then
+      file_size=$(du -h "$voice_path" 2>/dev/null | cut -f1)
+      echo "   ✓ $voice ($file_size)"
+      echo "     $voice_path"
+    fi
+  done
+fi
+
+if [[ $FAILED -gt 0 ]]; then
+  echo ""
+  echo "Failed downloads:"
+  for voice in "${NEED_DOWNLOAD[@]}"; do
+    voice_path="$VOICE_DIR/${voice}.onnx"
+    if [[ ! -f "$voice_path" ]]; then
+      echo "   ✗ $voice"
+    fi
+  done
+fi
+
+echo ""
+echo "Total: $((ALREADY_DOWNLOADED + DOWNLOADED)) voices available"
+echo ""
+
+if [[ $DOWNLOADED -gt 0 ]]; then
+  echo "✨ Ready to use Piper TTS with downloaded voices!"
+  echo ""
+  echo "Try it:"
+  echo "  /agent-vibes:provider switch piper"
+  echo "  /agent-vibes:preview"
+fi
+
+# Exit with error code if any downloads failed (Unix convention)
+if [[ $FAILED -gt 0 ]]; then
+  echo "" >&2
+  echo "⚠️  Warning: $FAILED download(s) failed. Some voices may not be available." >&2
+  exit 1
+fi
+
+exit 0

package/.claude/hooks/piper-installer.sh

@@ -67,7 +67,7 @@ if [[ -d "/data/data/com.termux" ]]; then
   echo ""
   SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
   if [[ -f "$SCRIPT_DIR/termux-installer.sh" ]]; then
-    exec "$SCRIPT_DIR/termux-installer.sh" "$@"
+    exec bash "$SCRIPT_DIR/termux-installer.sh" "$@"
   else
     echo "❌ Error: termux-installer.sh not found"
     echo "   Please download it from the AgentVibes repository"

package/.claude/hooks/piper-voice-manager.sh

@@ -265,10 +265,135 @@ download_voice() {
     return 1
   fi
 
+  # Patch LibriTTS speaker names if this is a libritts model
+  if [[ "$voice_name" == *libritts* ]]; then
+    patch_libritts_speaker_names "$voice_dir" "$voice_name"
+  fi
+
   echo "✅ Voice downloaded successfully: $voice_name"
   echo "   Location: $voice_dir/${voice_name}.onnx"
 }
 
+# @function patch_libritts_speaker_names
+# @intent Replace raw corpus IDs (p3922, p8699) with friendly names (Anna, Bella) in LibriTTS .onnx.json
+# @why Users see cryptic "p100Bell" names instead of friendly names without this patch
+# @param $1 {string} voice_dir - Directory containing the .onnx.json file
+# @param $2 {string} voice_name - Voice model name (e.g., en_US-libritts-high)
+# @returns None
+# @exitcode Always 0 (non-fatal)
+# @sideeffects Rewrites speaker_id_map in .onnx.json with friendly names from voice-assignments.json
+# @calledby download_voice (for libritts models), piper-download-voices.sh (post-download)
+# @calls python3/node (for JSON manipulation)
+patch_libritts_speaker_names() {
+  local voice_dir="$1"
+  local voice_name="$2"
+  local json_file="$voice_dir/${voice_name}.onnx.json"
+
+  if [[ ! -f "$json_file" ]]; then
+    return 0
+  fi
+
+  # Find voice-assignments.json relative to this script (SCRIPT_DIR/../.. = project root)
+  local script_dir
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  local project_root
+  project_root="$(cd "$script_dir/../.." 2>/dev/null && pwd)"
+  local catalog="$project_root/voice-assignments.json"
+
+  # Also check npm global install location
+  if [[ ! -f "$catalog" ]]; then
+    # Try npm root
+    local npm_root
+    npm_root="$(npm root -g 2>/dev/null)/agentvibes" || true
+    if [[ -f "$npm_root/voice-assignments.json" ]]; then
+      catalog="$npm_root/voice-assignments.json"
+    fi
+  fi
+
+  if [[ ! -f "$catalog" ]]; then
+    return 0
+  fi
+
+  # Check if already patched (first key doesn't start with 'p' + digits)
+  if command -v python3 &>/dev/null; then
+    python3 -c "
+import json, sys
+
+json_path = sys.argv[1]
+catalog_path = sys.argv[2]
+
+with open(json_path, 'r') as f:
+    data = json.load(f)
+
+sid_map = data.get('speaker_id_map', {})
+if not sid_map or data.get('num_speakers', 0) <= 1:
+    sys.exit(0)
+
+# Check if already patched
+import re
+first_key = next(iter(sid_map))
+if not re.match(r'^p\d+$', first_key):
+    sys.exit(0)
+
+# Load catalog
+with open(catalog_path, 'r') as f:
+    catalog = json.load(f)
+
+speakers = catalog.get('libritts_speakers', {})
+
+# Build reverse map: index -> p-name
+index_to_p = {v: k for k, v in sid_map.items()}
+
+# Rebuild with friendly names
+new_map = {}
+for idx, pname in index_to_p.items():
+    friendly = speakers.get(str(idx), {}).get('voice_name')
+    new_map[friendly if friendly else pname] = idx
+
+data['speaker_id_map'] = new_map
+
+with open(json_path, 'w') as f:
+    json.dump(data, f, indent=2)
+
+print('   Patched LibriTTS speaker names to friendly names')
+" "$json_file" "$catalog" 2>/dev/null || true
+  elif command -v node &>/dev/null; then
+    node -e "
+const fs = require('fs');
+const path = require('path');
+
+const jsonPath = process.argv[1];
+const catalogPath = process.argv[2];
+
+const data = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+const sidMap = data.speaker_id_map || {};
+if (!Object.keys(sidMap).length || (data.num_speakers || 0) <= 1) process.exit(0);
+
+// Check if already patched
+const firstKey = Object.keys(sidMap)[0];
+if (!/^p\d+$/.test(firstKey)) process.exit(0);
+
+const catalog = JSON.parse(fs.readFileSync(catalogPath, 'utf8'));
+const speakers = catalog.libritts_speakers || {};
+
+// Build reverse map
+const indexToP = {};
+for (const [pname, idx] of Object.entries(sidMap)) indexToP[idx] = pname;
+
+// Rebuild with friendly names
+const newMap = {};
+for (const [idx, pname] of Object.entries(indexToP)) {
+  const friendly = speakers[String(idx)]?.voice_name;
+  newMap[friendly || pname] = parseInt(idx, 10);
+}
+
+data.speaker_id_map = newMap;
+fs.writeFileSync(jsonPath, JSON.stringify(data, null, 2), 'utf8');
+console.log('   Patched LibriTTS speaker names to friendly names');
+" "$json_file" "$catalog" 2>/dev/null || true
+  fi
+}
+
 # @function list_downloaded_voices
 # @intent Display all locally cached voice models with file sizes
 # @why Help users see what voices they have available and storage usage