agentvibes 2.0.20 → 2.0.22

package/agentvibes.org/.claude/hooks/play-tts-piper.sh

@@ -1,281 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview Piper TTS Provider Implementation
-# @context Free, offline neural TTS for WSL/Linux
-# @architecture Implements provider contract for Piper binary
-# @dependencies piper (pipx), piper-voice-manager.sh, mpv/aplay
-# @entrypoints Called by play-tts.sh router
-# @patterns Provider contract: text/voice → audio file path
-# @related play-tts.sh, piper-voice-manager.sh, GitHub Issue #25
-#
-
-# Fix locale warnings
-export LC_ALL=C
-
-TEXT="$1"
-VOICE_OVERRIDE="$2"  # Optional: voice model name
-
-# Source voice manager and language manager
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/piper-voice-manager.sh"
-source "$SCRIPT_DIR/language-manager.sh"
-
-# Default voice for Piper
-DEFAULT_VOICE="en_US-lessac-medium"
-
-# @function determine_voice_model
-# @intent Resolve voice name to Piper model name with language support
-# @why Support voice override, language-specific voices, and default fallback
-# @param Uses global: $VOICE_OVERRIDE
-# @returns Sets $VOICE_MODEL global variable
-# @sideeffects None
-VOICE_MODEL=""
-
-# Get current language setting
-CURRENT_LANGUAGE=$(get_language_code)
-
-if [[ -n "$VOICE_OVERRIDE" ]]; then
-  # Use override if provided
-  VOICE_MODEL="$VOICE_OVERRIDE"
-  echo "🎤 Using voice: $VOICE_OVERRIDE (session-specific)"
-else
-  # Try to get voice from voice file (project-local first, then global)
-  VOICE_FILE=""
-  if [[ -f "$SCRIPT_DIR/../tts-voice.txt" ]]; then
-    VOICE_FILE="$SCRIPT_DIR/../tts-voice.txt"
-  elif [[ -f "$HOME/.claude/tts-voice.txt" ]]; then
-    VOICE_FILE="$HOME/.claude/tts-voice.txt"
-  fi
-
-  if [[ -n "$VOICE_FILE" ]]; then
-    FILE_VOICE=$(cat "$VOICE_FILE" 2>/dev/null)
-    # Check if it's a Piper model name (contains underscore and dash)
-    if [[ "$FILE_VOICE" == *"_"*"-"* ]]; then
-      VOICE_MODEL="$FILE_VOICE"
-    fi
-  fi
-
-  # If no Piper voice from file, try language-specific voice
-  if [[ -z "$VOICE_MODEL" ]]; then
-    LANG_VOICE=$(get_voice_for_language "$CURRENT_LANGUAGE" "piper" 2>/dev/null)
-
-    if [[ -n "$LANG_VOICE" ]]; then
-      VOICE_MODEL="$LANG_VOICE"
-      echo "🌍 Using $CURRENT_LANGUAGE voice: $LANG_VOICE (Piper)"
-    else
-      # Use default voice
-      VOICE_MODEL="$DEFAULT_VOICE"
-    fi
-  fi
-fi
-
-# @function validate_inputs
-# @intent Check required parameters
-# @why Fail fast with clear errors if inputs missing
-# @exitcode 1=missing text, 2=missing piper binary
-if [[ -z "$TEXT" ]]; then
-  echo "Usage: $0 \"text to speak\" [voice_model_name]"
-  exit 1
-fi
-
-# Check if Piper is installed
-if ! command -v piper &> /dev/null; then
-  echo "❌ Error: Piper TTS not installed"
-  echo "Install with: pipx install piper-tts"
-  echo "Or run: .claude/hooks/piper-installer.sh"
-  exit 2
-fi
-
-# @function ensure_voice_downloaded
-# @intent Download voice model if not cached
-# @why Provide seamless experience with automatic downloads
-# @param Uses global: $VOICE_MODEL
-# @sideeffects Downloads voice model files
-# @edgecases Prompts user for consent before downloading
-if ! verify_voice "$VOICE_MODEL"; then
-  echo "📥 Voice model not found: $VOICE_MODEL"
-  echo "   File size: ~25MB"
-  echo "   Preview: https://huggingface.co/rhasspy/piper-voices"
-  echo ""
-  read -p "   Download this voice model? [y/N]: " -n 1 -r
-  echo
-
-  if [[ $REPLY =~ ^[Yy]$ ]]; then
-    if ! download_voice "$VOICE_MODEL"; then
-      echo "❌ Failed to download voice model"
-      echo "Fix: Download manually or choose different voice"
-      exit 3
-    fi
-  else
-    echo "❌ Voice download cancelled"
-    exit 3
-  fi
-fi
-
-# Get voice model path
-VOICE_PATH=$(get_voice_path "$VOICE_MODEL")
-if [[ $? -ne 0 ]]; then
-  echo "❌ Voice model path not found: $VOICE_MODEL"
-  exit 3
-fi
-
-# @function determine_audio_directory
-# @intent Find appropriate directory for audio file storage
-# @why Supports project-local and global storage
-# @returns Sets $AUDIO_DIR global variable
-if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
-  AUDIO_DIR="$CLAUDE_PROJECT_DIR/.claude/audio"
-else
-  # Fallback: try to find .claude directory in current path
-  CURRENT_DIR="$PWD"
-  while [[ "$CURRENT_DIR" != "/" ]]; do
-    if [[ -d "$CURRENT_DIR/.claude" ]]; then
-      AUDIO_DIR="$CURRENT_DIR/.claude/audio"
-      break
-    fi
-    CURRENT_DIR=$(dirname "$CURRENT_DIR")
-  done
-  # Final fallback to global if no project .claude found
-  if [[ -z "$AUDIO_DIR" ]]; then
-    AUDIO_DIR="$HOME/.claude/audio"
-  fi
-fi
-
-mkdir -p "$AUDIO_DIR"
-TEMP_FILE="$AUDIO_DIR/tts-$(date +%s).wav"
-
-# @function get_speech_rate
-# @intent Determine speech rate for Piper synthesis
-# @why Convert user-facing speed (0.5=slower, 2.0=faster) to Piper length-scale (inverted)
-# @returns Piper length-scale value (inverted from user scale)
-# @note Piper uses length-scale where higher=slower, opposite of user expectation
-get_speech_rate() {
-  local target_config=""
-  local main_config=""
-
-  # Check for target-specific config first (new and legacy paths)
-  if [[ -f "$SCRIPT_DIR/../config/tts-target-speech-rate.txt" ]]; then
-    target_config="$SCRIPT_DIR/../config/tts-target-speech-rate.txt"
-  elif [[ -f "$HOME/.claude/config/tts-target-speech-rate.txt" ]]; then
-    target_config="$HOME/.claude/config/tts-target-speech-rate.txt"
-  elif [[ -f "$SCRIPT_DIR/../config/piper-target-speech-rate.txt" ]]; then
-    target_config="$SCRIPT_DIR/../config/piper-target-speech-rate.txt"
-  elif [[ -f "$HOME/.claude/config/piper-target-speech-rate.txt" ]]; then
-    target_config="$HOME/.claude/config/piper-target-speech-rate.txt"
-  fi
-
-  # Check for main config (new and legacy paths)
-  if [[ -f "$SCRIPT_DIR/../config/tts-speech-rate.txt" ]]; then
-    main_config="$SCRIPT_DIR/../config/tts-speech-rate.txt"
-  elif [[ -f "$HOME/.claude/config/tts-speech-rate.txt" ]]; then
-    main_config="$HOME/.claude/config/tts-speech-rate.txt"
-  elif [[ -f "$SCRIPT_DIR/../config/piper-speech-rate.txt" ]]; then
-    main_config="$SCRIPT_DIR/../config/piper-speech-rate.txt"
-  elif [[ -f "$HOME/.claude/config/piper-speech-rate.txt" ]]; then
-    main_config="$HOME/.claude/config/piper-speech-rate.txt"
-  fi
-
-  # If this is a non-English voice and target config exists, use it
-  if [[ "$CURRENT_LANGUAGE" != "english" ]] && [[ -n "$target_config" ]]; then
-    local user_speed=$(cat "$target_config" 2>/dev/null)
-    # Convert user speed to Piper length-scale (invert)
-    # User: 0.5=slower, 1.0=normal, 2.0=faster
-    # Piper: 2.0=slower, 1.0=normal, 0.5=faster
-    # Formula: piper_length_scale = 1.0 / user_speed
-    echo "scale=2; 1.0 / $user_speed" | bc -l 2>/dev/null || echo "1.0"
-    return
-  fi
-
-  # Otherwise use main config if available
-  if [[ -n "$main_config" ]]; then
-    local user_speed=$(grep -v '^#' "$main_config" 2>/dev/null | grep -v '^$' | tail -1)
-    echo "scale=2; 1.0 / $user_speed" | bc -l 2>/dev/null || echo "1.0"
-    return
-  fi
-
-  # Default: 1.0 (normal) for English, 2.0 (slower) for learning
-  if [[ "$CURRENT_LANGUAGE" != "english" ]]; then
-    echo "2.0"
-  else
-    echo "1.0"
-  fi
-}
-
-SPEECH_RATE=$(get_speech_rate)
-
-# @function synthesize_with_piper
-# @intent Generate speech using Piper TTS
-# @why Provides free, offline TTS alternative
-# @param Uses globals: $TEXT, $VOICE_PATH, $SPEECH_RATE
-# @returns Creates WAV file at $TEMP_FILE
-# @exitcode 0=success, 4=synthesis error
-# @sideeffects Creates audio file
-# @edgecases Handles piper errors, invalid models
-echo "$TEXT" | piper --model "$VOICE_PATH" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
-
-if [[ ! -f "$TEMP_FILE" ]] || [[ ! -s "$TEMP_FILE" ]]; then
-  echo "❌ Failed to synthesize speech with Piper"
-  echo "Voice model: $VOICE_MODEL"
-  echo "Check that voice model is valid"
-  exit 4
-fi
-
-# @function add_silence_padding
-# @intent Add silence to prevent WSL audio static
-# @why WSL audio subsystem cuts off first ~200ms
-# @param Uses global: $TEMP_FILE
-# @returns Updates $TEMP_FILE to padded version
-# @sideeffects Modifies audio file
-# AI NOTE: Use ffmpeg if available, otherwise skip padding (degraded experience)
-if command -v ffmpeg &> /dev/null; then
-  PADDED_FILE="$AUDIO_DIR/tts-padded-$(date +%s).wav"
-  # Add 200ms of silence at the beginning
-  ffmpeg -f lavfi -i anullsrc=r=44100:cl=stereo:d=0.2 -i "$TEMP_FILE" \
-    -filter_complex "[0:a][1:a]concat=n=2:v=0:a=1[out]" \
-    -map "[out]" -y "$PADDED_FILE" 2>/dev/null
-
-  if [[ -f "$PADDED_FILE" ]]; then
-    rm -f "$TEMP_FILE"
-    TEMP_FILE="$PADDED_FILE"
-  fi
-fi
-
-# @function play_audio
-# @intent Play generated audio using available player with sequential playback
-# @why Support multiple audio players and prevent overlapping audio in learning mode
-# @param Uses global: $TEMP_FILE, $CURRENT_LANGUAGE
-# @sideeffects Plays audio with lock mechanism for sequential playback
-LOCK_FILE="/tmp/agentvibes-audio.lock"
-
-# Wait for previous audio to finish (max 30 seconds)
-for i in {1..60}; do
-  if [ ! -f "$LOCK_FILE" ]; then
-    break
-  fi
-  sleep 0.5
-done
-
-# Track last target language audio for replay command
-if [[ "$CURRENT_LANGUAGE" != "english" ]]; then
-  TARGET_AUDIO_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/last-target-audio.txt"
-  echo "$TEMP_FILE" > "$TARGET_AUDIO_FILE"
-fi
-
-# Create lock and play audio
-touch "$LOCK_FILE"
-
-# Get audio duration for proper lock timing
-DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$TEMP_FILE" 2>/dev/null)
-DURATION=${DURATION%.*}  # Round to integer
-DURATION=${DURATION:-1}   # Default to 1 second if detection fails
-
-# Play audio in background
-(mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
-PLAYER_PID=$!
-
-# Wait for audio to finish, then release lock
-(sleep $DURATION; rm -f "$LOCK_FILE") &
-disown
-
-echo "🎵 Saved to: $TEMP_FILE"
-echo "🎤 Voice used: $VOICE_MODEL (Piper TTS)"

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

@@ -1,69 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview TTS Provider Router with Language Learning Support
-# @context Routes TTS requests to active provider (ElevenLabs or Piper)
-# @architecture Provider abstraction layer - single entry point for all TTS
-# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh
-# @entrypoints Called by hooks, slash commands, and personality-manager.sh
-# @patterns Provider pattern - delegates to provider-specific implementations
-# @related provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh
-#
-
-# Fix locale warnings
-export LC_ALL=C
-
-TEXT="$1"
-VOICE_OVERRIDE="$2"  # Optional: voice name or ID
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Source provider manager to get active provider
-source "$SCRIPT_DIR/provider-manager.sh"
-
-# Get active provider
-ACTIVE_PROVIDER=$(get_active_provider)
-
-# Show GitHub star reminder (once per day)
-"$SCRIPT_DIR/github-star-reminder.sh" 2>/dev/null || true
-
-# @function detect_voice_provider
-# @intent Auto-detect provider from voice name (for mixed-provider support)
-# @why Allow ElevenLabs for main language + Piper for target language
-# @param $1 voice name/ID
-# @returns Provider name (elevenlabs or piper)
-detect_voice_provider() {
-  local voice="$1"
-  # Piper voice names contain underscore and dash (e.g., es_ES-davefx-medium)
-  if [[ "$voice" == *"_"*"-"* ]]; then
-    echo "piper"
-  else
-    echo "$ACTIVE_PROVIDER"
-  fi
-}
-
-# Override provider if voice indicates different provider (mixed-provider mode)
-if [[ -n "$VOICE_OVERRIDE" ]]; then
-  DETECTED_PROVIDER=$(detect_voice_provider "$VOICE_OVERRIDE")
-  if [[ "$DETECTED_PROVIDER" != "$ACTIVE_PROVIDER" ]]; then
-    ACTIVE_PROVIDER="$DETECTED_PROVIDER"
-  fi
-fi
-
-# Normal single-language mode - route to appropriate provider implementation
-# Note: For learning mode, the output style will call this script TWICE:
-# 1. First call with main language text and current voice
-# 2. Second call with translated text and target voice
-case "$ACTIVE_PROVIDER" in
-  elevenlabs)
-    exec "$SCRIPT_DIR/play-tts-elevenlabs.sh" "$TEXT" "$VOICE_OVERRIDE"
-    ;;
-  piper)
-    exec "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE"
-    ;;
-  *)
-    echo "❌ Unknown provider: $ACTIVE_PROVIDER"
-    echo "   Run: /agent-vibes:provider list"
-    exit 1
-    ;;
-esac