agentvibes 2.0.8 → 2.0.9

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

@@ -1,279 +0,0 @@
-#!/bin/bash
-# Personality manager for AgentVibes - adds character to TTS messages
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PERSONALITIES_DIR="$SCRIPT_DIR/../personalities"
-
-# Project-local file first, global fallback
-# Use logical path (not physical) to handle symlinked .claude directories
-# Script is at .claude/hooks/personality-manager.sh, so .claude is ..
-CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
-
-# Check if we have a project-local .claude directory
-if [[ -d "$CLAUDE_DIR" ]] && [[ "$CLAUDE_DIR" != "$HOME/.claude" ]]; then
-  PERSONALITY_FILE="$CLAUDE_DIR/tts-personality.txt"
-else
-  PERSONALITY_FILE="$HOME/.claude/tts-personality.txt"
-fi
-
-# Function to get personality data from markdown file
-get_personality_data() {
-  local personality="$1"
-  local field="$2"
-  local file="$PERSONALITIES_DIR/${personality}.md"
-
-  if [[ ! -f "$file" ]]; then
-    return 1
-  fi
-
-  case "$field" in
-    prefix)
-      sed -n '/^## Prefix/,/^##/p' "$file" | sed '1d;$d' | tr -d '\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
-      ;;
-    suffix)
-      sed -n '/^## Suffix/,/^##/p' "$file" | sed '1d;$d' | tr -d '\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
-      ;;
-    description)
-      grep "^description:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
-      ;;
-    voice)
-      grep "^voice:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
-      ;;
-    instructions)
-      sed -n '/^## AI Instructions/,/^##/p' "$file" | sed '1d;$d'
-      ;;
-  esac
-}
-
-# Function to list all available personalities
-list_personalities() {
-  local personalities=()
-
-  # Find all .md files in personalities directory
-  if [[ -d "$PERSONALITIES_DIR" ]]; then
-    for file in "$PERSONALITIES_DIR"/*.md; do
-      if [[ -f "$file" ]]; then
-        basename "$file" .md
-      fi
-    done
-  fi
-}
-
-case "$1" in
-  list)
-    echo "🎭 Available Personalities:"
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-    # Get current personality
-    CURRENT="normal"
-    if [ -f "$PERSONALITY_FILE" ]; then
-      CURRENT=$(cat "$PERSONALITY_FILE")
-    fi
-
-    # List personalities from markdown files
-    echo "Built-in personalities:"
-    for personality in $(list_personalities | sort); do
-      desc=$(get_personality_data "$personality" "description")
-      if [[ "$personality" == "$CURRENT" ]]; then
-        echo "  ✓ $personality - $desc (current)"
-      else
-        echo "  - $personality - $desc"
-      fi
-    done
-
-    # Add random option
-    if [[ "$CURRENT" == "random" ]]; then
-      echo "  ✓ random - Picks randomly each time (current)"
-    else
-      echo "  - random - Picks randomly each time"
-    fi
-
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
-    echo "Usage: /agent-vibes:personality <name>"
-    echo "       /agent-vibes:personality add <name>"
-    echo "       /agent-vibes:personality edit <name>"
-    ;;
-
-  set|switch)
-    PERSONALITY="$2"
-
-    if [[ -z "$PERSONALITY" ]]; then
-      echo "❌ Please specify a personality name"
-      echo "Usage: $0 set <personality>"
-      exit 1
-    fi
-
-    # Check if personality file exists (unless it's random)
-    if [[ "$PERSONALITY" != "random" ]]; then
-      if [[ ! -f "$PERSONALITIES_DIR/${PERSONALITY}.md" ]]; then
-        echo "❌ Personality not found: $PERSONALITY"
-        echo ""
-        echo "Available personalities:"
-        for p in $(list_personalities | sort); do
-          echo "  • $p"
-        done
-        exit 1
-      fi
-    fi
-
-    # Save the personality
-    echo "$PERSONALITY" > "$PERSONALITY_FILE"
-    echo "🎭 Personality set to: $PERSONALITY"
-
-    # Check if personality has an assigned voice
-    ASSIGNED_VOICE=$(get_personality_data "$PERSONALITY" "voice")
-    if [[ -n "$ASSIGNED_VOICE" ]]; then
-      # Switch to the assigned voice (silently - personality will do the talking)
-      VOICE_MANAGER="$SCRIPT_DIR/voice-manager.sh"
-      if [[ -x "$VOICE_MANAGER" ]]; then
-        echo "🎤 Switching to assigned voice: $ASSIGNED_VOICE"
-        "$VOICE_MANAGER" switch "$ASSIGNED_VOICE" --silent >/dev/null 2>&1
-      fi
-    fi
-
-    # Make a personality-appropriate remark with TTS
-    if [[ "$PERSONALITY" != "random" ]]; then
-      echo ""
-
-      # Get TTS script path
-      TTS_SCRIPT="$SCRIPT_DIR/play-tts.sh"
-
-      # Try to get acknowledgment from personality file
-      PERSONALITY_FILE_PATH="$PERSONALITIES_DIR/${PERSONALITY}.md"
-      REMARK=""
-
-      if [[ -f "$PERSONALITY_FILE_PATH" ]]; then
-        # Extract example responses from personality file (lines starting with "- ")
-        mapfile -t EXAMPLES < <(grep '^- "' "$PERSONALITY_FILE_PATH" | sed 's/^- "//; s/"$//')
-
-        if [[ ${#EXAMPLES[@]} -gt 0 ]]; then
-          # Pick a random example
-          REMARK="${EXAMPLES[$RANDOM % ${#EXAMPLES[@]}]}"
-        fi
-      fi
-
-      # Fallback if no examples found
-      if [[ -z "$REMARK" ]]; then
-        REMARK="Personality set to ${PERSONALITY}!"
-      fi
-
-      echo "💬 $REMARK"
-      "$TTS_SCRIPT" "$REMARK"
-
-      echo ""
-      echo "Note: AI will generate unique ${PERSONALITY} responses - no fixed templates!"
-    fi
-    ;;
-
-  get)
-    if [ -f "$PERSONALITY_FILE" ]; then
-      CURRENT=$(cat "$PERSONALITY_FILE")
-      echo "Current personality: $CURRENT"
-
-      if [[ "$CURRENT" != "random" ]]; then
-        desc=$(get_personality_data "$CURRENT" "description")
-        [[ -n "$desc" ]] && echo "Description: $desc"
-      fi
-    else
-      echo "Current personality: normal (default)"
-    fi
-    ;;
-
-  add)
-    NAME="$2"
-    if [[ -z "$NAME" ]]; then
-      echo "❌ Please specify a personality name"
-      echo "Usage: $0 add <name>"
-      exit 1
-    fi
-
-    FILE="$PERSONALITIES_DIR/${NAME}.md"
-    if [[ -f "$FILE" ]]; then
-      echo "❌ Personality '$NAME' already exists"
-      echo "Use 'edit' to modify it"
-      exit 1
-    fi
-
-    # Create new personality file
-    cat > "$FILE" << 'EOF'
----
-name: NAME
-description: Custom personality
----
-
-# NAME Personality
-
-## Prefix
-
-
-## Suffix
-
-
-## AI Instructions
-Describe how the AI should generate messages for this personality.
-
-## Example Responses
-- "Example response 1"
-- "Example response 2"
-EOF
-
-    # Replace NAME with actual name
-    sed -i "s/NAME/$NAME/g" "$FILE"
-
-    echo "✅ Created new personality: $NAME"
-    echo "📝 Edit the file: $FILE"
-    echo ""
-    echo "You can now customize:"
-    echo "  • Prefix: Text before messages"
-    echo "  • Suffix: Text after messages"
-    echo "  • AI Instructions: How AI should speak"
-    echo "  • Example Responses: Sample messages"
-    ;;
-
-  edit)
-    NAME="$2"
-    if [[ -z "$NAME" ]]; then
-      echo "❌ Please specify a personality name"
-      echo "Usage: $0 edit <name>"
-      exit 1
-    fi
-
-    FILE="$PERSONALITIES_DIR/${NAME}.md"
-    if [[ ! -f "$FILE" ]]; then
-      echo "❌ Personality '$NAME' not found"
-      echo "Use 'add' to create it first"
-      exit 1
-    fi
-
-    echo "📝 Edit this file to customize the personality:"
-    echo "$FILE"
-    ;;
-
-  reset)
-    echo "normal" > "$PERSONALITY_FILE"
-    echo "🎭 Personality reset to: normal"
-    ;;
-
-  *)
-    # If a single argument is provided and it's not a command, treat it as "set <personality>"
-    if [[ -n "$1" ]] && [[ -f "$PERSONALITIES_DIR/${1}.md" || "$1" == "random" ]]; then
-      # Call set with the personality name
-      exec "$0" set "$1"
-    else
-      echo "AgentVibes Personality Manager"
-      echo ""
-      echo "Commands:"
-      echo "  list                              - List all personalities"
-      echo "  set/switch <name>                 - Set personality"
-      echo "  add <name>                        - Create new personality"
-      echo "  edit <name>                       - Show path to edit personality"
-      echo "  get                               - Show current personality"
-      echo "  reset                             - Reset to normal"
-      echo ""
-      echo "Examples:"
-      echo "  /agent-vibes:personality flirty"
-      echo "  /agent-vibes:personality add cowboy"
-    fi
-    ;;
-esac

package/agentvibes.org/.claude/hooks/piper-download-voices.sh

@@ -1,133 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview Piper Voice Model Downloader
-# @context Downloads Piper TTS voice models from HuggingFace
-# @purpose Batch download popular voices after installation
-# @dependencies piper-voice-manager.sh, piper binary
-# @usage ./piper-download-voices.sh [--yes|-y]
-#   --yes|-y: Skip confirmation prompt (auto-download)
-#
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/piper-voice-manager.sh"
-
-# Parse command line arguments
-AUTO_YES=false
-if [[ "$1" == "--yes" ]] || [[ "$1" == "-y" ]]; then
-  AUTO_YES=true
-fi
-
-# Common voice models to download
-COMMON_VOICES=(
-  "en_US-lessac-medium"      # Default, clear male
-  "en_US-amy-medium"         # Warm female
-  "en_US-joe-medium"         # Professional male
-  "en_US-ryan-high"          # Expressive male
-  "en_US-libritts-high"      # Premium quality
-)
-
-echo "🎙️  Piper Voice Model Downloader"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "This will download the most commonly used Piper voice models."
-echo "Each voice is approximately 25MB."
-echo ""
-
-# 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"
-  exit 1
-fi
-
-# Get storage directory
-VOICE_DIR=$(get_voice_storage_dir)
-
-echo "📂 Storage location: $VOICE_DIR"
-echo ""
-
-# Count already downloaded
-ALREADY_DOWNLOADED=0
-ALREADY_DOWNLOADED_LIST=()
-NEED_DOWNLOAD=()
-
-for voice in "${COMMON_VOICES[@]}"; do
-  if verify_voice "$voice" 2>/dev/null; then
-    ((ALREADY_DOWNLOADED++))
-    ALREADY_DOWNLOADED_LIST+=("$voice")
-  else
-    NEED_DOWNLOAD+=("$voice")
-  fi
-done
-
-echo "📊 Status:"
-echo "   Already downloaded: $ALREADY_DOWNLOADED voice(s)"
-echo "   Need to download: ${#NEED_DOWNLOAD[@]} voice(s)"
-echo ""
-
-# Show already downloaded voices
-if [[ $ALREADY_DOWNLOADED -gt 0 ]]; then
-  echo "✅ Already downloaded (skipped):"
-  for voice in "${ALREADY_DOWNLOADED_LIST[@]}"; do
-    echo "   ✓ $voice"
-  done
-  echo ""
-fi
-
-if [[ ${#NEED_DOWNLOAD[@]} -eq 0 ]]; then
-  echo "🎉 All common voices ready to use!"
-  exit 0
-fi
-
-echo "Voices to download:"
-for voice in "${NEED_DOWNLOAD[@]}"; do
-  echo "  • $voice (~25MB)"
-done
-echo ""
-
-# Ask for confirmation (skip if --yes flag provided)
-if [[ "$AUTO_YES" == "false" ]]; then
-  read -p "Download ${#NEED_DOWNLOAD[@]} voice model(s)? [Y/n]: " -n 1 -r
-  echo
-
-  if [[ ! $REPLY =~ ^[Yy]$ ]] && [[ -n $REPLY ]]; then
-    echo "❌ Download cancelled"
-    exit 0
-  fi
-else
-  echo "Auto-downloading ${#NEED_DOWNLOAD[@]} voice model(s)..."
-  echo ""
-fi
-
-# Download each voice
-DOWNLOADED=0
-FAILED=0
-
-for voice in "${NEED_DOWNLOAD[@]}"; do
-  echo ""
-  echo "📥 Downloading: $voice..."
-
-  if download_voice "$voice"; then
-    ((DOWNLOADED++))
-    echo "✅ Downloaded: $voice"
-  else
-    ((FAILED++))
-    echo "❌ Failed: $voice"
-  fi
-done
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📊 Download Summary:"
-echo "   ✅ Successfully downloaded: $DOWNLOADED"
-echo "   ❌ Failed: $FAILED"
-echo "   📦 Total voices available: $((ALREADY_DOWNLOADED + DOWNLOADED))"
-echo ""
-
-if [[ $DOWNLOADED -gt 0 ]]; then
-  echo "✨ Ready to use Piper TTS with downloaded voices!"
-  echo ""
-  echo "Try it:"
-  echo "  /agent-vibes:provider switch piper"
-  echo "  /agent-vibes:preview"
-fi

package/agentvibes.org/.claude/hooks/piper-voice-manager.sh

@@ -1,227 +0,0 @@
-#!/bin/bash
-#
-# @fileoverview Piper Voice Model Management
-# @context Manages downloading, caching, and validating Piper ONNX voice models
-# @architecture Voice model lifecycle management for Piper provider
-# @dependencies curl, piper binary
-# @entrypoints Sourced by play-tts-piper.sh and provider management commands
-# @patterns HuggingFace model repository integration, file-based caching
-# @related play-tts-piper.sh, provider-manager.sh, GitHub Issue #25
-#
-
-# Base URL for Piper voice models on HuggingFace
-PIPER_VOICES_BASE_URL="https://huggingface.co/rhasspy/piper-voices/resolve/main"
-
-# @function get_voice_storage_dir
-# @intent Determine directory for storing Piper voice models
-# @why Voice models are large (~25MB each) and should be shared globally across all projects
-# @returns Echoes path to voice storage directory (~/.claude/piper-voices)
-# @sideeffects Creates directory if it doesn't exist
-# @architecture Supports custom path via PIPER_VOICES_DIR env var, defaults to global storage
-get_voice_storage_dir() {
-  local voice_dir
-
-  # Check for custom path in environment or config file
-  if [[ -n "$PIPER_VOICES_DIR" ]]; then
-    voice_dir="$PIPER_VOICES_DIR"
-  else
-    # Check for config file (project-local first, then global)
-    local config_file
-    if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/piper-voices-dir.txt" ]]; then
-      config_file="$CLAUDE_PROJECT_DIR/.claude/piper-voices-dir.txt"
-    else
-      # Search up directory tree for .claude/
-      local current_dir="$PWD"
-      while [[ "$current_dir" != "/" ]]; do
-        if [[ -f "$current_dir/.claude/piper-voices-dir.txt" ]]; then
-          config_file="$current_dir/.claude/piper-voices-dir.txt"
-          break
-        fi
-        current_dir=$(dirname "$current_dir")
-      done
-
-      # Check global config
-      if [[ -z "$config_file" ]] && [[ -f "$HOME/.claude/piper-voices-dir.txt" ]]; then
-        config_file="$HOME/.claude/piper-voices-dir.txt"
-      fi
-    fi
-
-    if [[ -n "$config_file" ]]; then
-      voice_dir=$(cat "$config_file" | tr -d '[:space:]')
-    fi
-  fi
-
-  # Fallback to default global storage
-  if [[ -z "$voice_dir" ]]; then
-    voice_dir="$HOME/.claude/piper-voices"
-  fi
-
-  mkdir -p "$voice_dir"
-  echo "$voice_dir"
-}
-
-# @function verify_voice
-# @intent Check if voice model files exist locally
-# @why Avoid redundant downloads, detect missing models
-# @param $1 {string} voice_name - Voice model name (e.g., en_US-lessac-medium)
-# @returns None
-# @exitcode 0=voice exists, 1=voice missing
-# @sideeffects None
-verify_voice() {
-  local voice_name="$1"
-  local voice_dir
-  voice_dir=$(get_voice_storage_dir)
-
-  local onnx_file="$voice_dir/${voice_name}.onnx"
-  local json_file="$voice_dir/${voice_name}.onnx.json"
-
-  [[ -f "$onnx_file" ]] && [[ -f "$json_file" ]]
-}
-
-# @function get_voice_path
-# @intent Get absolute path to voice model ONNX file
-# @why Piper binary requires full path to model file
-# @param $1 {string} voice_name - Voice model name
-# @returns Echoes path to .onnx file
-# @exitcode 0=success, 1=voice not found
-# @sideeffects None
-get_voice_path() {
-  local voice_name="$1"
-  local voice_dir
-  voice_dir=$(get_voice_storage_dir)
-
-  local onnx_file="$voice_dir/${voice_name}.onnx"
-
-  if [[ ! -f "$onnx_file" ]]; then
-    echo "❌ Voice model not found: $voice_name" >&2
-    return 1
-  fi
-
-  echo "$onnx_file"
-}
-
-# @function parse_voice_components
-# @intent Extract language, locale, speaker, quality from voice name
-# @why HuggingFace uses directory structure: lang/locale/speaker/quality
-# @param $1 {string} voice_name - Voice name (e.g., en_US-lessac-medium)
-# @returns Sets global variables: LANG, LOCALE, SPEAKER, QUALITY
-# @sideeffects Sets global variables
-# AI NOTE: Voice name format is: lang_LOCALE-speaker-quality
-parse_voice_components() {
-  local voice_name="$1"
-
-  # Extract components from voice name
-  # Format: en_US-lessac-medium
-  #         lang_LOCALE-speaker-quality
-
-  local lang_locale="${voice_name%%-*}"  # en_US
-  local speaker_quality="${voice_name#*-}"  # lessac-medium
-
-  LANG="${lang_locale%%_*}"  # en
-  LOCALE="${lang_locale#*_}"  # US
-  SPEAKER="${speaker_quality%%-*}"  # lessac
-  QUALITY="${speaker_quality#*-}"  # medium
-}
-
-# @function download_voice
-# @intent Download Piper voice model from HuggingFace
-# @why Provide free offline TTS voices
-# @param $1 {string} voice_name - Voice model name
-# @param $2 {string} lang_code - Language code (optional, inferred from voice_name)
-# @returns None
-# @exitcode 0=success, 1=download failed
-# @sideeffects Downloads .onnx and .onnx.json files
-# @edgecases Handles network failures, validates file integrity
-download_voice() {
-  local voice_name="$1"
-  local lang_code="${2:-}"
-
-  local voice_dir
-  voice_dir=$(get_voice_storage_dir)
-
-  # Check if already downloaded
-  if verify_voice "$voice_name"; then
-    echo "✅ Voice already downloaded: $voice_name"
-    return 0
-  fi
-
-  # Parse voice components
-  parse_voice_components "$voice_name"
-
-  # Construct download URLs
-  # Path format: {language}/{language}_{locale}/{speaker}/{quality}/{speaker}-{quality}.onnx
-  local model_path="${LANG}/${LANG}_${LOCALE}/${SPEAKER}/${QUALITY}/${voice_name}"
-  local onnx_url="${PIPER_VOICES_BASE_URL}/${model_path}.onnx"
-  local json_url="${PIPER_VOICES_BASE_URL}/${model_path}.onnx.json"
-
-  echo "📥 Downloading Piper voice: $voice_name"
-  echo "   Source: HuggingFace (rhasspy/piper-voices)"
-  echo "   Size: ~25MB"
-  echo ""
-
-  # Download ONNX model
-  echo "   Downloading model file..."
-  if ! curl -L --progress-bar -o "$voice_dir/${voice_name}.onnx" "$onnx_url"; then
-    echo "❌ Failed to download voice model"
-    rm -f "$voice_dir/${voice_name}.onnx"
-    return 1
-  fi
-
-  # Download JSON config
-  echo "   Downloading config file..."
-  if ! curl -L -s -o "$voice_dir/${voice_name}.onnx.json" "$json_url"; then
-    echo "❌ Failed to download voice config"
-    rm -f "$voice_dir/${voice_name}.onnx" "$voice_dir/${voice_name}.onnx.json"
-    return 1
-  fi
-
-  # Verify file integrity (basic check - file size > 0)
-  if [[ ! -s "$voice_dir/${voice_name}.onnx" ]]; then
-    echo "❌ Downloaded file is empty or corrupt"
-    rm -f "$voice_dir/${voice_name}.onnx" "$voice_dir/${voice_name}.onnx.json"
-    return 1
-  fi
-
-  echo "✅ Voice downloaded successfully: $voice_name"
-  echo "   Location: $voice_dir/${voice_name}.onnx"
-}
-
-# @function list_downloaded_voices
-# @intent Show all locally cached voice models
-# @why Help users see what voices they have available
-# @returns Echoes voice names (one per line)
-# @exitcode 0=success
-# @sideeffects None
-list_downloaded_voices() {
-  local voice_dir
-  voice_dir=$(get_voice_storage_dir)
-
-  echo "📦 Downloaded Piper Voices:"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-  local count=0
-  shopt -s nullglob
-  for onnx_file in "$voice_dir"/*.onnx; do
-    if [[ -f "$onnx_file" ]]; then
-      local voice_name
-      voice_name=$(basename "$onnx_file" .onnx)
-      local file_size
-      file_size=$(du -h "$onnx_file" | cut -f1)
-      echo "  • $voice_name ($file_size)"
-      ((count++))
-    fi
-  done
-  shopt -u nullglob
-
-  if [[ $count -eq 0 ]]; then
-    echo "  (No voices downloaded yet)"
-  fi
-
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "Total: $count voices"
-}
-
-# AI NOTE: This file manages the lifecycle of Piper voice models
-# Voice models are ONNX files (~20-30MB each) downloaded from HuggingFace
-# Files are cached locally to avoid repeated downloads
-# Project-local storage preferred over global for isolation