agentvibes 2.0.17-beta.3 → 2.0.17-beta.5

package/.claude/commands/agent-vibes/commands.json

@@ -48,6 +48,30 @@
     {
       "name": "get",
       "description": "Get personality details"
+    },
+    {
+      "name": "language",
+      "description": "Set main/native language"
+    },
+    {
+      "name": "learn",
+      "description": "Enable/disable language learning mode"
+    },
+    {
+      "name": "target",
+      "description": "Set target language to learn"
+    },
+    {
+      "name": "target-voice",
+      "description": "Set voice for target language"
+    },
+    {
+      "name": "set-speed",
+      "description": "Set speech speed for Piper TTS voices"
+    },
+    {
+      "name": "provider",
+      "description": "Manage TTS providers (ElevenLabs, Piper)"
     }
   ]
 }

package/.claude/commands/agent-vibes/set-speed.md

@@ -0,0 +1,41 @@
+---
+description: Set TTS speech speed for Piper voices
+argument-hint: [target] <speed>
+---
+
+# Set Speech Speed
+
+Control the speech rate for Piper TTS voices (ElevenLabs doesn't support speed control).
+
+## Usage
+
+```bash
+/agent-vibes:set-speed 2x              # Set main voice to 2x slower
+/agent-vibes:set-speed target 2x       # Set target language to 2x slower
+/agent-vibes:set-speed 0.5x            # Set main voice to 2x faster
+/agent-vibes:set-speed target 3x       # Set target language to 3x slower
+/agent-vibes:set-speed normal          # Reset to normal speed (1.0)
+/agent-vibes:set-speed target normal   # Reset target to normal speed
+```
+
+## Speed Values
+
+- `0.5x` or `-2x` = 2x faster (half duration)
+- `1x` or `normal` = Normal speed
+- `2x` or `+2x` = 2x slower (double duration, great for learning)
+- `3x` or `+3x` = 3x slower (triple duration, very slow)
+
+## Examples
+
+```bash
+# Make Spanish 2x slower for learning
+/agent-vibes:set-speed target 2x
+
+# Make main voice faster
+/agent-vibes:set-speed 0.5x
+
+# Reset target language to normal speed
+/agent-vibes:set-speed target normal
+```
+
+!bash .claude/hooks/speed-manager.sh $ARGUMENTS

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

@@ -144,15 +144,60 @@ 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 Allow slower speech for language learning (default 2.0 for non-English)
+# @returns Speech rate value (default 1.0 for English, 2.0 for others)
+get_speech_rate() {
+  local target_config=""
+  local main_config=""
+
+  # Check for target-specific config first (used for learning mode target language)
+  if [[ -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
+  if [[ -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
+    cat "$target_config" 2>/dev/null
+    return
+  fi
+
+  # Otherwise use main config if available
+  if [[ -n "$main_config" ]]; then
+    # Read only the last non-comment line (the actual number)
+    grep -v '^#' "$main_config" 2>/dev/null | grep -v '^$' | tail -1
+    return
+  fi
+
+  # Default: 2x slower for non-English (better for language 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
+# @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" --output_file "$TEMP_FILE" 2>/dev/null
+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"

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

@@ -27,6 +27,29 @@ 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

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

@@ -209,6 +209,47 @@ provider_switch() {
   # Perform switch
   set_active_provider "$new_provider"
 
+  # Update target voice if language learning mode is active
+  local target_lang_file=""
+  local target_voice_file=""
+
+  # Check project-local first, then global
+  if [[ -d "$SCRIPT_DIR/../.." ]]; then
+    local project_dir="$SCRIPT_DIR/../.."
+    if [[ -f "$project_dir/.claude/tts-target-language.txt" ]]; then
+      target_lang_file="$project_dir/.claude/tts-target-language.txt"
+      target_voice_file="$project_dir/.claude/tts-target-voice.txt"
+    fi
+  fi
+
+  # Fallback to global
+  if [[ -z "$target_lang_file" ]]; then
+    if [[ -f "$HOME/.claude/tts-target-language.txt" ]]; then
+      target_lang_file="$HOME/.claude/tts-target-language.txt"
+      target_voice_file="$HOME/.claude/tts-target-voice.txt"
+    fi
+  fi
+
+  # If target language is set, update voice for new provider
+  if [[ -n "$target_lang_file" ]] && [[ -f "$target_lang_file" ]]; then
+    local target_lang
+    target_lang=$(cat "$target_lang_file")
+
+    if [[ -n "$target_lang" ]]; then
+      # Get the recommended voice for this language with new provider
+      local new_target_voice
+      new_target_voice=$(get_voice_for_language "$target_lang" "$new_provider")
+
+      if [[ -n "$new_target_voice" ]]; then
+        echo "$new_target_voice" > "$target_voice_file"
+        echo ""
+        echo "🔄 Updated target language voice:"
+        echo "   Language: $target_lang"
+        echo "   Voice: $new_target_voice (for $new_provider)"
+      fi
+    fi
+  fi
+
   # Test new provider
   echo ""
   echo "🔊 Testing provider..."

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

@@ -0,0 +1,226 @@
+#!/bin/bash
+#
+# @fileoverview Speech Speed Manager for Piper TTS
+# @context Manage speech rate for main and target language voices
+# @architecture Simple config file manager for Piper length-scale parameter
+#
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Determine config directory (project-local first, then global)
+if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  CONFIG_DIR="$CLAUDE_PROJECT_DIR/.claude/config"
+else
+  # Try to find .claude in current path
+  CURRENT_DIR="$PWD"
+  while [[ "$CURRENT_DIR" != "/" ]]; do
+    if [[ -d "$CURRENT_DIR/.claude" ]]; then
+      CONFIG_DIR="$CURRENT_DIR/.claude/config"
+      break
+    fi
+    CURRENT_DIR=$(dirname "$CURRENT_DIR")
+  done
+  # Fallback to global
+  if [[ -z "$CONFIG_DIR" ]]; then
+    CONFIG_DIR="$HOME/.claude/config"
+  fi
+fi
+
+mkdir -p "$CONFIG_DIR"
+
+MAIN_SPEED_FILE="$CONFIG_DIR/piper-speech-rate.txt"
+TARGET_SPEED_FILE="$CONFIG_DIR/piper-target-speech-rate.txt"
+
+# @function parse_speed_value
+# @intent Convert user-friendly speed notation to Piper length-scale value
+# @param $1 Speed string (e.g., "2x", "+2x", "-2x", "0.5x", "normal")
+# @returns Numeric length-scale value
+parse_speed_value() {
+  local input="$1"
+
+  # Handle special cases
+  case "$input" in
+    normal|1x|1.0)
+      echo "1.0"
+      return
+      ;;
+    fast|-2x|0.5x)
+      echo "0.5"
+      return
+      ;;
+    slow|+2x|2x|2.0)
+      echo "2.0"
+      return
+      ;;
+    slower|+3x|3x|3.0)
+      echo "3.0"
+      return
+      ;;
+  esac
+
+  # Strip leading '+' if present
+  input="${input#+}"
+
+  # Strip trailing 'x' if present
+  input="${input%x}"
+
+  # Validate it's a number
+  if [[ "$input" =~ ^[0-9]+\.?[0-9]*$ ]]; then
+    echo "$input"
+  else
+    echo "ERROR"
+  fi
+}
+
+# @function set_speed
+# @intent Set speech speed for main or target voice
+# @param $1 Target ("target" or empty for main)
+# @param $2 Speed value
+set_speed() {
+  local is_target=false
+  local speed_input=""
+
+  # Parse arguments
+  if [[ "$1" == "target" ]]; then
+    is_target=true
+    speed_input="$2"
+  else
+    speed_input="$1"
+  fi
+
+  if [[ -z "$speed_input" ]]; then
+    echo "❌ Error: Speed value required"
+    echo "Usage: /agent-vibes:set-speed [target] <speed>"
+    echo "Examples: 2x, 0.5x, normal, +3x"
+    return 1
+  fi
+
+  # Parse speed value
+  local speed_value
+  speed_value=$(parse_speed_value "$speed_input")
+
+  if [[ "$speed_value" == "ERROR" ]]; then
+    echo "❌ Invalid speed value: $speed_input"
+    echo "Valid values: normal, 0.5x, 1x, 2x, 3x, +2x, -2x"
+    return 1
+  fi
+
+  # Determine which file to write to
+  local config_file
+  local voice_type
+  if [[ "$is_target" == true ]]; then
+    config_file="$TARGET_SPEED_FILE"
+    voice_type="target language"
+  else
+    config_file="$MAIN_SPEED_FILE"
+    voice_type="main voice"
+  fi
+
+  # Write speed value
+  echo "$speed_value" > "$config_file"
+
+  # Show confirmation
+  echo "✓ Speech speed set for $voice_type"
+  echo ""
+  echo "Speed: ${speed_value}x"
+
+  case "$speed_value" in
+    0.5)
+      echo "Effect: 2x faster (half duration)"
+      ;;
+    1.0)
+      echo "Effect: Normal speed"
+      ;;
+    2.0)
+      echo "Effect: 2x slower (great for language learning)"
+      ;;
+    3.0)
+      echo "Effect: 3x slower (very slow, detailed learning)"
+      ;;
+    *)
+      if (( $(echo "$speed_value > 1.0" | bc -l) )); then
+        echo "Effect: Slower speech"
+      else
+        echo "Effect: Faster speech"
+      fi
+      ;;
+  esac
+
+  echo ""
+  echo "Note: Speed control only works with Piper TTS voices"
+
+  # Test the new speed
+  if command -v bc &> /dev/null; then
+    local test_msg
+    if [[ "$is_target" == true ]]; then
+      test_msg="Velocidad de voz ajustada para aprender mejor"
+    else
+      test_msg="Speech speed adjusted successfully"
+    fi
+
+    echo ""
+    echo "🔊 Testing new speed..."
+    "$SCRIPT_DIR/play-tts.sh" "$test_msg" &
+  fi
+}
+
+# @function get_speed
+# @intent Display current speech speed settings
+get_speed() {
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "   Current Speech Speed Settings"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Main voice speed
+  if [[ -f "$MAIN_SPEED_FILE" ]]; then
+    local main_speed=$(grep -v '^#' "$MAIN_SPEED_FILE" 2>/dev/null | grep -v '^$' | tail -1)
+    echo "Main voice: ${main_speed}x"
+  else
+    echo "Main voice: 1.0x (default, normal speed)"
+  fi
+
+  # Target voice speed
+  if [[ -f "$TARGET_SPEED_FILE" ]]; then
+    local target_speed=$(cat "$TARGET_SPEED_FILE" 2>/dev/null)
+    echo "Target language: ${target_speed}x"
+  else
+    echo "Target language: 2.0x (default, 2x slower for learning)"
+  fi
+
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# Main command handler
+case "${1:-}" in
+  target)
+    set_speed "target" "$2"
+    ;;
+  get|status)
+    get_speed
+    ;;
+  normal|fast|slow|slower|*x|*.*|+*|-*)
+    set_speed "$1"
+    ;;
+  *)
+    echo "Speech Speed Manager"
+    echo ""
+    echo "Usage:"
+    echo "  /agent-vibes:set-speed <speed>         Set main voice speed"
+    echo "  /agent-vibes:set-speed target <speed>  Set target language speed"
+    echo "  /agent-vibes:set-speed get              Show current speeds"
+    echo ""
+    echo "Speed values:"
+    echo "  0.5x or -2x  = 2x faster"
+    echo "  1x or normal = Normal speed"
+    echo "  2x or +2x    = 2x slower (great for learning)"
+    echo "  3x or +3x    = 3x slower"
+    echo ""
+    echo "Examples:"
+    echo "  /agent-vibes:set-speed target 2x"
+    echo "  /agent-vibes:set-speed 0.5x"
+    echo "  /agent-vibes:set-speed normal"
+    ;;
+esac

package/.claude/output-styles/agent-vibes.md

@@ -96,11 +96,44 @@ For 'random' personality: Pick a different personality each time from available
 
 Make each response unique, creative, and naturally incorporate the personality's style!
 
+## Language Learning Mode
+
+**Check if learning mode is enabled:**
+```bash
+LEARN_ENABLED=$(cat .claude/tts-learn-enabled.txt 2>/dev/null || cat ~/.claude/tts-learn-enabled.txt 2>/dev/null || echo "false")
+```
+
+**If learning mode is ENABLED ("true"):**
+1. Get target language and voice:
+   ```bash
+   TARGET_LANG=$(cat .claude/tts-target-language.txt 2>/dev/null || cat ~/.claude/tts-target-language.txt 2>/dev/null)
+   TARGET_VOICE=$(cat .claude/tts-target-voice.txt 2>/dev/null || cat ~/.claude/tts-target-voice.txt 2>/dev/null)
+   ```
+
+2. **Make TWO TTS calls** for each acknowledgment/completion:
+   - **First**: Play in main language (English) with current voice
+   - **Second**: Translate to target language and play with target voice
+
+3. **Translation**: Use AI to translate the English message to the target language naturally
+
+**Example with learning mode enabled (Spanish):**
+```
+User: "hello"
+# Acknowledgment in English
+.claude/hooks/play-tts.sh "Hey there! Great to hear from you!"
+# Acknowledgment in Spanish
+.claude/hooks/play-tts.sh "¡Hola! ¡Qué bueno saber de ti!" "Antoni"
+```
+
+**If learning mode is DISABLED:**
+- Make normal single TTS call as usual
+
 ## Voice Selection
 
 - If user specifies a voice (e.g., "use Aria voice"), pass it as second parameter
 - Otherwise, omit second parameter to use default voice from `.claude/tts-voice.txt`
 - Use same voice for both acknowledgment and completion
+- For learning mode, use target voice for second TTS call
 
 ## Example Usage
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.0.17-beta.3",
+  "version": "2.0.17-beta.5",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [