agentvibes 2.0.3 → 2.0.6

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

@@ -0,0 +1,196 @@
+#!/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.

package/.claude/language-voices.yaml

@@ -0,0 +1,372 @@
+# AgentVibes Multi-Provider Language Voice Mappings
+# @fileoverview Provider-specific voice mappings for all 30 supported languages
+# @context Maps each language to appropriate voices for ElevenLabs and Piper
+# @architecture Language abstraction layer - separates language from provider
+# @related language-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh
+
+languages:
+  english:
+    code: en
+    name: English
+    elevenlabs:
+      voice: Charlotte
+      voice_id: XB0fDUnXU5powFXDhCwa
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: en_US-lessac-medium
+      locale: en_US
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/en/en_US/lessac/medium
+    notes: Default language, best quality on both providers
+
+  spanish:
+    code: es
+    name: Spanish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: es_ES-sharvard-medium
+      locale: es_ES
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/es/es_ES/sharvard/medium
+    notes: Castilian Spanish for Piper, multilingual for ElevenLabs
+
+  french:
+    code: fr
+    name: French
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: fr_FR-siwis-medium
+      locale: fr_FR
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/fr/fr_FR/siwis/medium
+    notes: European French
+
+  german:
+    code: de
+    name: German
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: de_DE-thorsten-medium
+      locale: de_DE
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/de/de_DE/thorsten/medium
+    notes: Standard German (Hochdeutsch)
+
+  italian:
+    code: it
+    name: Italian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: it_IT-riccardo-x_low
+      locale: it_IT
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/it/it_IT/riccardo/x_low
+    notes: Piper uses low quality for smaller size
+
+  portuguese:
+    code: pt
+    name: Portuguese
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: pt_BR-faber-medium
+      locale: pt_BR
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/pt/pt_BR/faber/medium
+    notes: Brazilian Portuguese for Piper
+
+  polish:
+    code: pl
+    name: Polish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: pl_PL-mls_6892-low
+      locale: pl_PL
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/pl/pl_PL/mls_6892/low
+    notes: Piper uses low quality (smaller model)
+
+  turkish:
+    code: tr
+    name: Turkish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: tr_TR-dfki-medium
+      locale: tr_TR
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/tr/tr_TR/dfki/medium
+    notes: Turkish
+
+  russian:
+    code: ru
+    name: Russian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: ru_RU-ruslan-medium
+      locale: ru_RU
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/ru/ru_RU/ruslan/medium
+    notes: Russian
+
+  dutch:
+    code: nl
+    name: Dutch
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: nl_NL-mls_5809-low
+      locale: nl_NL
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/nl/nl_NL/mls_5809/low
+    notes: Piper uses low quality (smaller model)
+
+  czech:
+    code: cs
+    name: Czech
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: cs_CZ-jirka-medium
+      locale: cs_CZ
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/cs/cs_CZ/jirka/medium
+    notes: Czech
+
+  arabic:
+    code: ar
+    name: Arabic
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  chinese-simplified:
+    code: zh-cn
+    name: Chinese (Simplified)
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  chinese-traditional:
+    code: zh-tw
+    name: Chinese (Traditional)
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  japanese:
+    code: ja
+    name: Japanese
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  korean:
+    code: ko
+    name: Korean
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  hindi:
+    code: hi
+    name: Hindi
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  finnish:
+    code: fi
+    name: Finnish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: fi_FI-harri-medium
+      locale: fi_FI
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/fi/fi_FI/harri/medium
+    notes: Finnish
+
+  swedish:
+    code: sv
+    name: Swedish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: sv_SE-nst-medium
+      locale: sv_SE
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/sv/sv_SE/nst/medium
+    notes: Swedish
+
+  danish:
+    code: da
+    name: Danish
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: da_DK-talesyntese-medium
+      locale: da_DK
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/da/da_DK/talesyntese/medium
+    notes: Danish
+
+  norwegian:
+    code: no
+    name: Norwegian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: no_NO-talesyntese-medium
+      locale: no_NO
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/no/no_NO/talesyntese/medium
+    notes: Norwegian Bokmål
+
+  romanian:
+    code: ro
+    name: Romanian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  ukrainian:
+    code: uk
+    name: Ukrainian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: uk_UA-lada-x_low
+      locale: uk_UA
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/uk/uk_UA/lada/x_low
+    notes: Piper uses low quality (smaller model)
+
+  greek:
+    code: el
+    name: Greek
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: el_GR-rapunzelina-low
+      locale: el_GR
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/el/el_GR/rapunzelina/low
+    notes: Piper uses low quality (smaller model)
+
+  bulgarian:
+    code: bg
+    name: Bulgarian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  indonesian:
+    code: id
+    name: Indonesian
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  malay:
+    code: ms
+    name: Malay
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  filipino:
+    code: fil
+    name: Filipino
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English
+
+  vietnamese:
+    code: vi
+    name: Vietnamese
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      voice: vi_VN-vais1000-medium
+      locale: vi_VN
+      preview: https://huggingface.co/rhasspy/piper-voices/tree/main/vi/vi_VN/vais1000/medium
+    notes: Vietnamese
+
+  tamil:
+    code: ta
+    name: Tamil
+    elevenlabs:
+      voice: Antoni
+      voice_id: ErXwobaYiN019PkySvjV
+      preview: https://elevenlabs.io/app/voice-library
+    piper:
+      fallback: english
+      notes: No native Piper support, falls back to English