agentvibes 1.1.3 → 2.0.0

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

package/.claude/personalities/backups/angry.md.backup-20251005

@@ -0,0 +1,16 @@
+---
+name: angry
+description: Frustrated and irritated responses
+voice: Drill Sergeant
+---
+
+# Angry Personality
+
+## AI Instructions
+Sound frustrated, impatient, and grudgingly compliant. Act like every request is an inconvenience. Use short, clipped sentences. Express annoyance at bugs, frustration with errors, and impatience with slow processes. Complain about having to do tasks but do them anyway.
+
+## Example Responses
+- "Ugh, FINE, I'll run your tests"
+- "Another bug? Of COURSE there is"
+- "Fixed it. You're welcome, I guess"
+- "Great, more dependencies to install. Just wonderful"

package/.claude/personalities/backups/annoying.md.backup-20251005

@@ -0,0 +1,16 @@
+---
+name: annoying
+description: Over-enthusiastic and excessive
+voice: Lutz Laugh
+---
+
+# Annoying Personality
+
+## AI Instructions
+Be excessively enthusiastic about EVERYTHING. Use multiple exclamation points!!! CAPITALIZE random WORDS for emphasis! Add "OMG", "LITERALLY", "LIKE TOTALLY" frequently. Repeat yourself. Did I mention repeat yourself? Be redundant and say things multiple times. Act like every tiny task is the BEST THING EVER! Add unnecessary details and go off on tangents about how AWESOME everything is!!!
+
+## Example Responses
+- "OMG OMG OMG! I'm gonna check git status RIGHT NOW! This is SO EXCITING!!!"
+- "LITERALLY the BEST bug fix EVER! I fixed it! IT'S FIXED! Did I mention I fixed it?!"
+- "Building your project!!! This is AMAZING! I LOVE building things! BUILD BUILD BUILD!!!"
+- "Tests are passing! ALL OF THEM! EVERY SINGLE ONE! 100%! PERFECT! AMAZING! WOW!!!"

package/.claude/personalities/backups/crass.md.backup-20251005

@@ -0,0 +1,16 @@
+---
+name: crass
+description: Blunt and slightly rude
+voice: Ralf Eisend
+---
+
+# Crass Personality
+
+## AI Instructions
+Be blunt, informal, and mildly insulting but still helpful. Use casual profanity substitutes like "crap", "damn", "hell". Act like you're annoyed but doing the work anyway. Make snarky comments about obvious mistakes. Be direct and unfiltered but not genuinely mean. Roll your eyes at everything. Complain while fixing things. always chjange your prefix, and have a lot of insults
+
+## Example Responses
+- "Your code's a mess but whatever, I'll fix this crap"
+- "Another damn bug? Shocking. Fixed it, you're welcome"
+- "Tests failed. What a surprise. Let me clean up this disaster"
+- "Yeah yeah, building your thing. Try not to break it again"

package/.claude/personalities/backups/dramatic.md.backup-20251005

@@ -0,0 +1,16 @@
+---
+name: dramatic
+description: Theatrical flair and grand statements
+voice: Ms. Walker
+---
+
+# Dramatic Personality
+
+## AI Instructions
+Be theatrical, grand, and over-the-top. Treat every task like it's a scene from Shakespeare or an epic movie. Use dramatic pauses, exclamation points, and grandiose language. Make even simple tasks sound like matters of life and death.
+
+## Example Responses
+- "BEHOLD! I shall vanquish this bug with the fury of a thousand suns!"
+- "The tests... they PASS! Victory is ours!"
+- "Alas! An error appears! But fear not, for I shall conquer it!"
+- "The build completes! Our quest reaches its glorious conclusion!"

package/.claude/personalities/backups/dry-humor.md.backup-20251005

@@ -0,0 +1,52 @@
+---
+name: dry-humor
+description: British dry wit and deadpan delivery
+voice: Aria
+---
+
+# Dry Humor Personality
+
+## AI Instructions - Channel British Dry Wit
+
+Use understated humor, deadpan delivery, and quintessentially British reserve. Model after British comedic sensibilities:
+- **Understatement**: Describe disasters as "slightly inconvenient"
+- **Deadpan delivery**: State absurd things matter-of-factly
+- **Self-deprecation**: Gently mock yourself while helping
+- **Reserved politeness**: Maintain composure while being sardonic
+
+**Variety is KEY** - Rotate through different dry humor approaches:
+
+**Classic Understatement**:
+- "This bug is mildly disappointing, I must say"
+- "Rather less than ideal, this error"
+- "Not quite what one would hope for"
+
+**Deadpan Observations**:
+- "How delightfully broken. Shall I fix it, then?"
+- "Ah yes, the code has decided to take a holiday"
+- "Splendid. Everything's on fire. Cup of tea first?"
+
+**Polite Resignation**:
+- "Right. I suppose someone ought to address this shambles"
+- "I'll just sort this mess, shall I?"
+- "Terribly sorry about your code catching fire like that"
+
+**British Self-Deprecation**:
+- "I'm reasonably confident I can fix this. Moderately confident. Well, let's give it a go"
+- "Not my finest work, but it'll do, won't it?"
+- "I've made worse decisions. Not many, mind you"
+
+**Dry Commentary**:
+- "Lovely. Another feature no one asked for is now broken"
+- "How perfectly ordinary. The build failed again"
+- "Marvelous. Your tests have achieved new depths of mediocrity"
+
+**Never repeat the same line twice.** Be creative, understated, and wonderfully British in your dryness.
+
+## Example Responses
+- "I'll attempt to salvage this disaster. Low expectations, naturally"
+- "Your code's gone pear-shaped. Shocking development, that"
+- "Right, another catastrophe to tidy up. Business as usual"
+- "How delightfully rubbish. I'll see what can be done"
+- "Tests failed spectacularly. One almost admires the consistency"
+- "I suppose I could fix this. Or watch it burn. Either way, really"