agentvibes 2.0.12 → 2.0.13

package/agentvibes.org/.claude/hooks/provider-commands.sh

@@ -1,374 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview Provider management slash commands
-# @context User-facing commands for switching and managing TTS providers
-# @architecture Part of /agent-vibes:* command system
-#
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/provider-manager.sh"
-source "$SCRIPT_DIR/language-manager.sh"
-
-COMMAND="${1:-help}"
-
-# @function provider_list
-# @intent Display all available providers with status
-provider_list() {
-  local current_provider
-  current_provider=$(get_active_provider)
-
-  echo "┌────────────────────────────────────────────────────────────┐"
-  echo "│ Available TTS Providers                                    │"
-  echo "├────────────────────────────────────────────────────────────┤"
-
-  # ElevenLabs
-  if [[ "$current_provider" == "elevenlabs" ]]; then
-    echo "│ ✓ ElevenLabs    Premium quality    ⭐⭐⭐⭐⭐    [ACTIVE]    │"
-  else
-    echo "│   ElevenLabs    Premium quality    ⭐⭐⭐⭐⭐               │"
-  fi
-  echo "│   Cost: Free tier + \$5-22/mo                               │"
-  echo "│   Platform: All (Windows, macOS, Linux, WSL)               │"
-  echo "│   Offline: No                                              │"
-  echo "│                                                            │"
-
-  # Piper
-  if [[ "$current_provider" == "piper" ]]; then
-    echo "│ ✓ Piper TTS     Free, offline      ⭐⭐⭐⭐       [ACTIVE]    │"
-  else
-    echo "│   Piper TTS     Free, offline      ⭐⭐⭐⭐                  │"
-  fi
-  echo "│   Cost: Free forever                                       │"
-  echo "│   Platform: WSL, Linux only                                │"
-  echo "│   Offline: Yes                                             │"
-  echo "└────────────────────────────────────────────────────────────┘"
-  echo ""
-  echo "Learn more: agentvibes.org/providers"
-}
-
-# @function provider_switch
-# @intent Switch to a different TTS provider
-provider_switch() {
-  local new_provider="$1"
-
-  if [[ -z "$new_provider" ]]; then
-    echo "❌ Error: Provider name required"
-    echo "Usage: /agent-vibes:provider switch <provider>"
-    echo "Available: elevenlabs, piper"
-    return 1
-  fi
-
-  # Validate provider
-  if ! validate_provider "$new_provider"; then
-    echo "❌ Invalid provider: $new_provider"
-    echo ""
-    echo "Available providers:"
-    list_providers
-    return 1
-  fi
-
-  local current_provider
-  current_provider=$(get_active_provider)
-
-  if [[ "$current_provider" == "$new_provider" ]]; then
-    echo "✓ Already using $new_provider"
-    return 0
-  fi
-
-  # Platform check for Piper
-  if [[ "$new_provider" == "piper" ]]; then
-    if ! grep -qi microsoft /proc/version 2>/dev/null && [[ "$(uname -s)" != "Linux" ]]; then
-      echo "❌ Piper is only supported on WSL and Linux"
-      echo "Your platform: $(uname -s)"
-      echo "See: agentvibes.org/platform-support"
-      return 1
-    fi
-
-    # Check if Piper is installed
-    if ! command -v piper &> /dev/null; then
-      echo "❌ Piper TTS is not installed"
-      echo ""
-      echo "Install with: pipx install piper-tts"
-      echo "Or run: .claude/hooks/piper-installer.sh"
-      echo ""
-      echo "Visit: agentvibes.org/install-piper"
-      return 1
-    fi
-  fi
-
-  # Check language compatibility
-  local current_language
-  current_language=$(get_current_language)
-
-  if [[ "$current_language" != "english" ]]; then
-    if ! is_language_supported "$current_language" "$new_provider" 2>/dev/null; then
-      echo "⚠️  Language Compatibility Warning"
-      echo ""
-      echo "Current language: $current_language"
-      echo "Target provider:  $new_provider"
-      echo ""
-      echo "❌ Language '$current_language' is not natively supported by $new_provider"
-      echo "   Will fall back to English when using $new_provider"
-      echo ""
-      echo "Options:"
-      echo "  1. Continue anyway (will use English)"
-      echo "  2. Switch language to English"
-      echo "  3. Cancel provider switch"
-      echo ""
-      read -p "Choose option [1-3]: " -n 1 -r
-      echo
-
-      case $REPLY in
-        1)
-          echo "⏩ Continuing with fallback to English..."
-          ;;
-        2)
-          echo "🔄 Switching language to English..."
-          "$SCRIPT_DIR/language-manager.sh" set english
-          ;;
-        3)
-          echo "❌ Provider switch cancelled"
-          return 1
-          ;;
-        *)
-          echo "❌ Invalid option, cancelling"
-          return 1
-          ;;
-      esac
-    fi
-  fi
-
-  # Confirm switch
-  echo ""
-  echo "⚠️  Switch to $(echo $new_provider | tr '[:lower:]' '[:upper:]')?"
-  echo ""
-  echo "Current: $current_provider"
-  echo "New:     $new_provider"
-  if [[ "$current_language" != "english" ]]; then
-    echo "Language: $current_language"
-  fi
-  echo ""
-  read -p "Continue? [y/N]: " -n 1 -r
-  echo
-
-  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-    echo "❌ Switch cancelled"
-    return 1
-  fi
-
-  # Perform switch
-  set_active_provider "$new_provider"
-
-  # Test new provider
-  echo ""
-  echo "🔊 Testing provider..."
-  "$SCRIPT_DIR/play-tts.sh" "Provider switched to $new_provider successfully" 2>/dev/null
-
-  echo ""
-  echo "✓ Provider switch complete!"
-  echo "Visit agentvibes.org for tips and tricks"
-}
-
-# @function provider_info
-# @intent Show detailed information about a provider
-provider_info() {
-  local provider_name="$1"
-
-  if [[ -z "$provider_name" ]]; then
-    echo "❌ Error: Provider name required"
-    echo "Usage: /agent-vibes:provider info <provider>"
-    return 1
-  fi
-
-  case "$provider_name" in
-    elevenlabs)
-      echo "┌────────────────────────────────────────────────────────────┐"
-      echo "│ ElevenLabs - Premium TTS Provider                          │"
-      echo "├────────────────────────────────────────────────────────────┤"
-      echo "│ Quality:     ⭐⭐⭐⭐⭐  (Highest available)                   │"
-      echo "│ Cost:        Free tier + \$5-22/mo                          │"
-      echo "│ Platform:    All (Windows, macOS, Linux, WSL)              │"
-      echo "│ Offline:     No (requires internet)                        │"
-      echo "│                                                            │"
-      echo "│ Trade-offs:                                                │"
-      echo "│ + Highest voice quality and naturalness                   │"
-      echo "│ + 50+ premium voices available                            │"
-      echo "│ + Multilingual support (30+ languages)                    │"
-      echo "│ - Requires API key and internet                           │"
-      echo "│ - Costs money after free tier                             │"
-      echo "│                                                            │"
-      echo "│ Best for: Premium quality, multilingual needs             │"
-      echo "└────────────────────────────────────────────────────────────┘"
-      echo ""
-      echo "Full comparison: agentvibes.org/providers"
-      ;;
-
-    piper)
-      echo "┌────────────────────────────────────────────────────────────┐"
-      echo "│ Piper TTS - Free Offline Provider                          │"
-      echo "├────────────────────────────────────────────────────────────┤"
-      echo "│ Quality:     ⭐⭐⭐⭐  (Very good)                            │"
-      echo "│ Cost:        Free forever                                  │"
-      echo "│ Platform:    WSL, Linux only                               │"
-      echo "│ Offline:     Yes (fully local)                             │"
-      echo "│                                                            │"
-      echo "│ Trade-offs:                                                │"
-      echo "│ + Completely free, no API costs                           │"
-      echo "│ + Works offline, no internet needed                       │"
-      echo "│ + Fast synthesis (local processing)                       │"
-      echo "│ - WSL/Linux only (no macOS/Windows)                       │"
-      echo "│ - Slightly lower quality than ElevenLabs                  │"
-      echo "│                                                            │"
-      echo "│ Best for: Budget-conscious, offline use, privacy          │"
-      echo "└────────────────────────────────────────────────────────────┘"
-      echo ""
-      echo "Full comparison: agentvibes.org/providers"
-      ;;
-
-    *)
-      echo "❌ Unknown provider: $provider_name"
-      echo "Available: elevenlabs, piper"
-      ;;
-  esac
-}
-
-# @function provider_test
-# @intent Test current provider with sample audio
-provider_test() {
-  local current_provider
-  current_provider=$(get_active_provider)
-
-  echo "🔊 Testing provider: $current_provider"
-  echo ""
-
-  "$SCRIPT_DIR/play-tts.sh" "Provider test successful. Audio is working correctly with $current_provider."
-
-  echo ""
-  echo "✓ Test complete"
-}
-
-# @function provider_get
-# @intent Show currently active provider
-provider_get() {
-  local current_provider
-  current_provider=$(get_active_provider)
-
-  echo "🎤 Current Provider: $current_provider"
-  echo ""
-
-  # Show brief info
-  case "$current_provider" in
-    elevenlabs)
-      echo "Quality: ⭐⭐⭐⭐⭐"
-      echo "Cost: Free tier + \$5-22/mo"
-      echo "Offline: No"
-      ;;
-    piper)
-      echo "Quality: ⭐⭐⭐⭐"
-      echo "Cost: Free forever"
-      echo "Offline: Yes"
-      ;;
-  esac
-
-  echo ""
-  echo "Use /agent-vibes:provider info $current_provider for details"
-}
-
-# @function provider_preview
-# @intent Preview voices for the currently active provider
-# @architecture Delegates to provider-specific voice managers
-provider_preview() {
-  local current_provider
-  current_provider=$(get_active_provider)
-
-  echo "🎤 Voice Preview ($current_provider)"
-  echo ""
-
-  case "$current_provider" in
-    elevenlabs)
-      # Use the ElevenLabs voice manager
-      "$SCRIPT_DIR/voice-manager.sh" preview "$@"
-      ;;
-    piper)
-      # Use the Piper voice manager's list functionality
-      # For Piper, we'll list and play sample from available voices
-      source "$SCRIPT_DIR/piper-voice-manager.sh"
-
-      # Play intro announcement
-      echo "🎤 Piper Preview of 3 people"
-      echo ""
-
-      # Play first 3 Piper voices as samples
-      local sample_voices=(
-        "en_US-lessac-medium:Lessac"
-        "en_US-amy-medium:Amy"
-        "en_US-joe-medium:Joe"
-      )
-
-      for voice_entry in "${sample_voices[@]}"; do
-        local voice_name="${voice_entry%%:*}"
-        local display_name="${voice_entry##*:}"
-
-        echo "🔊 ${display_name}..."
-        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" "$voice_name"
-
-        # Wait for the voice to finish playing before starting next one
-        sleep 3
-      done
-
-      echo ""
-      echo "✓ Preview complete"
-      echo "💡 Use /agent-vibes:list to see all available Piper voices"
-      ;;
-    *)
-      echo "❌ Unknown provider: $current_provider"
-      ;;
-  esac
-}
-
-# @function provider_help
-# @intent Show help for provider commands
-provider_help() {
-  echo "Provider Management Commands"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-  echo "Usage:"
-  echo "  /agent-vibes:provider list              # Show all providers"
-  echo "  /agent-vibes:provider switch <name>     # Switch provider"
-  echo "  /agent-vibes:provider info <name>       # Provider details"
-  echo "  /agent-vibes:provider test              # Test current provider"
-  echo "  /agent-vibes:provider get               # Show active provider"
-  echo ""
-  echo "Examples:"
-  echo "  /agent-vibes:provider switch piper"
-  echo "  /agent-vibes:provider info elevenlabs"
-  echo ""
-  echo "Learn more: agentvibes.org/docs/providers"
-}
-
-# Route to appropriate function
-case "$COMMAND" in
-  list)
-    provider_list
-    ;;
-  switch)
-    provider_switch "$2"
-    ;;
-  info)
-    provider_info "$2"
-    ;;
-  test)
-    provider_test
-    ;;
-  get)
-    provider_get
-    ;;
-  preview)
-    shift  # Remove 'preview' from args
-    provider_preview "$@"
-    ;;
-  help|*)
-    provider_help
-    ;;
-esac

package/agentvibes.org/.claude/hooks/provider-manager.sh

@@ -1,196 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview TTS Provider Management Functions
-# @context Core provider abstraction layer for multi-provider TTS system
-# @architecture Provides functions to get/set/list/validate TTS providers
-# @dependencies None - pure bash implementation
-# @entrypoints Sourced by play-tts.sh and provider management commands
-# @patterns File-based state management with project-local and global fallback
-# @related play-tts.sh, play-tts-elevenlabs.sh, GitHub Issue #25
-#
-
-# @function get_provider_config_path
-# @intent Determine path to tts-provider.txt file
-# @why Supports both project-local (.claude/) and global (~/.claude/) storage
-# @returns Echoes path to provider config file
-# @exitcode 0=always succeeds
-# @sideeffects None
-# @edgecases Creates parent directory if missing
-get_provider_config_path() {
-  local provider_file
-
-  # Check project-local first
-  if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
-    provider_file="$CLAUDE_PROJECT_DIR/.claude/tts-provider.txt"
-  else
-    # Search up directory tree for .claude/
-    local current_dir="$PWD"
-    while [[ "$current_dir" != "/" ]]; do
-      if [[ -d "$current_dir/.claude" ]]; then
-        provider_file="$current_dir/.claude/tts-provider.txt"
-        break
-      fi
-      current_dir=$(dirname "$current_dir")
-    done
-
-    # Fallback to global if no project .claude found
-    if [[ -z "$provider_file" ]]; then
-      provider_file="$HOME/.claude/tts-provider.txt"
-    fi
-  fi
-
-  echo "$provider_file"
-}
-
-# @function get_active_provider
-# @intent Read currently active TTS provider from config file
-# @why Central function for determining which provider to use
-# @returns Echoes provider name (e.g., "elevenlabs", "piper")
-# @exitcode 0=success
-# @sideeffects None
-# @edgecases Returns "elevenlabs" if file missing or empty (default)
-get_active_provider() {
-  local provider_file
-  provider_file=$(get_provider_config_path)
-
-  # Read provider from file, default to elevenlabs if not found
-  if [[ -f "$provider_file" ]]; then
-    local provider
-    provider=$(cat "$provider_file" | tr -d '[:space:]')
-    if [[ -n "$provider" ]]; then
-      echo "$provider"
-      return 0
-    fi
-  fi
-
-  # Default to elevenlabs
-  echo "elevenlabs"
-}
-
-# @function set_active_provider
-# @intent Write active provider to config file
-# @why Allows runtime provider switching without restart
-# @param $1 {string} provider - Provider name (e.g., "elevenlabs", "piper")
-# @returns None (outputs success/error message)
-# @exitcode 0=success, 1=invalid provider
-# @sideeffects Writes to tts-provider.txt file
-# @edgecases Creates file and parent directory if missing
-set_active_provider() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    echo "❌ Error: Provider name required"
-    echo "Usage: set_active_provider <provider_name>"
-    return 1
-  fi
-
-  # Validate provider exists
-  if ! validate_provider "$provider"; then
-    echo "❌ Error: Provider '$provider' not found"
-    echo "Available providers:"
-    list_providers
-    return 1
-  fi
-
-  local provider_file
-  provider_file=$(get_provider_config_path)
-
-  # Create directory if it doesn't exist
-  mkdir -p "$(dirname "$provider_file")"
-
-  # Write provider to file
-  echo "$provider" > "$provider_file"
-
-  echo "✓ Active provider set to: $provider"
-}
-
-# @function list_providers
-# @intent List all available TTS providers
-# @why Discover which providers are installed
-# @returns Echoes provider names (one per line)
-# @exitcode 0=success
-# @sideeffects None
-# @edgecases Returns empty if no play-tts-*.sh files found
-list_providers() {
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-  # Find all play-tts-*.sh files
-  local providers=()
-  shopt -s nullglob  # Handle case where no files match
-  for file in "$script_dir"/play-tts-*.sh; do
-    if [[ -f "$file" ]] && [[ "$file" != *"play-tts.sh" ]]; then
-      # Extract provider name from filename (play-tts-elevenlabs.sh -> elevenlabs)
-      local basename
-      basename=$(basename "$file")
-      local provider
-      provider="${basename#play-tts-}"
-      provider="${provider%.sh}"
-      providers+=("$provider")
-    fi
-  done
-  shopt -u nullglob
-
-  # Output providers
-  if [[ ${#providers[@]} -eq 0 ]]; then
-    echo "⚠️ No providers found"
-    return 0
-  fi
-
-  for provider in "${providers[@]}"; do
-    echo "$provider"
-  done
-}
-
-# @function validate_provider
-# @intent Check if provider implementation exists
-# @why Prevent errors from switching to non-existent provider
-# @param $1 {string} provider - Provider name to validate
-# @returns None
-# @exitcode 0=provider exists, 1=provider not found
-# @sideeffects None
-# @edgecases Checks for corresponding play-tts-*.sh file
-validate_provider() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    return 1
-  fi
-
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local provider_script="$script_dir/play-tts-${provider}.sh"
-
-  [[ -f "$provider_script" ]]
-}
-
-# @function get_provider_script_path
-# @intent Get absolute path to provider implementation script
-# @why Used by router to execute provider-specific logic
-# @param $1 {string} provider - Provider name
-# @returns Echoes absolute path to play-tts-*.sh file
-# @exitcode 0=success, 1=provider not found
-# @sideeffects None
-get_provider_script_path() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    echo "❌ Error: Provider name required" >&2
-    return 1
-  fi
-
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local provider_script="$script_dir/play-tts-${provider}.sh"
-
-  if [[ ! -f "$provider_script" ]]; then
-    echo "❌ Error: Provider '$provider' not found at $provider_script" >&2
-    return 1
-  fi
-
-  echo "$provider_script"
-}
-
-# AI NOTE: This file provides the core abstraction layer for multi-provider TTS.
-# All provider state is managed through simple text files for simplicity and reliability.
-# Project-local configuration takes precedence over global to support per-project providers.