agentvibes 2.0.17 → 2.0.20

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

@@ -1,12 +1,38 @@
 #!/bin/bash
 #
-# @fileoverview Piper TTS Provider Implementation
-# @context Free, offline neural TTS for WSL/Linux
-# @architecture Implements provider contract for Piper binary
-# @dependencies piper (pipx), piper-voice-manager.sh, mpv/aplay
-# @entrypoints Called by play-tts.sh router
-# @patterns Provider contract: text/voice → audio file path
-# @related play-tts.sh, piper-voice-manager.sh, GitHub Issue #25
+# File: .claude/hooks/play-tts-piper.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied. Use at your own risk. See the Apache License for details.
+#
+# ---
+#
+# @fileoverview Piper TTS Provider Implementation - Free, offline neural TTS
+# @context Provides local, privacy-first TTS alternative to cloud services for WSL/Linux
+# @architecture Implements provider interface contract for Piper binary integration
+# @dependencies piper (pipx), piper-voice-manager.sh, mpv/aplay, ffmpeg (optional padding)
+# @entrypoints Called by play-tts.sh router when provider=piper
+# @patterns Provider contract: text/voice → audio file path, voice auto-download, language-aware synthesis
+# @related play-tts.sh, piper-voice-manager.sh, language-manager.sh, GitHub Issue #25
 #
 
 # Fix locale warnings
@@ -49,8 +75,8 @@ else
 
   if [[ -n "$VOICE_FILE" ]]; then
     FILE_VOICE=$(cat "$VOICE_FILE" 2>/dev/null)
-    # Check if it's a Piper model name (contains underscore and dash)
-    if [[ "$FILE_VOICE" == *"_"*"-"* ]]; then
+    # Check if it's a Piper model name (contains underscore and dash, or speaker ID with #)
+    if [[ "$FILE_VOICE" == *"_"*"-"* ]] || [[ "$FILE_VOICE" == *"#"* ]]; then
       VOICE_MODEL="$FILE_VOICE"
     fi
   fi
@@ -92,7 +118,21 @@ fi
 # @param Uses global: $VOICE_MODEL
 # @sideeffects Downloads voice model files
 # @edgecases Prompts user for consent before downloading
-if ! verify_voice "$VOICE_MODEL"; then
+
+# Strip speaker ID for verification/download (speaker ID is after #)
+VOICE_MODEL_BASE="$VOICE_MODEL"
+if [[ "$VOICE_MODEL" == *"#"* ]]; then
+  VOICE_MODEL_BASE="${VOICE_MODEL%%#*}"
+fi
+
+# Check if custom voice exists (bypass verification for custom voices)
+CUSTOM_VOICE_PATH="$HOME/.local/share/piper/voices/$VOICE_MODEL_BASE.onnx"
+IS_CUSTOM_VOICE=false
+if [[ -f "$CUSTOM_VOICE_PATH" ]]; then
+  IS_CUSTOM_VOICE=true
+fi
+
+if [[ "$IS_CUSTOM_VOICE" == "false" ]] && ! verify_voice "$VOICE_MODEL_BASE"; then
   echo "📥 Voice model not found: $VOICE_MODEL"
   echo "   File size: ~25MB"
   echo "   Preview: https://huggingface.co/rhasspy/piper-voices"
@@ -101,7 +141,7 @@ if ! verify_voice "$VOICE_MODEL"; then
   echo
 
   if [[ $REPLY =~ ^[Yy]$ ]]; then
-    if ! download_voice "$VOICE_MODEL"; then
+    if ! download_voice "$VOICE_MODEL_BASE"; then
       echo "❌ Failed to download voice model"
       echo "Fix: Download manually or choose different voice"
       exit 3
@@ -112,11 +152,19 @@ if ! verify_voice "$VOICE_MODEL"; then
   fi
 fi
 
-# Get voice model path
-VOICE_PATH=$(get_voice_path "$VOICE_MODEL")
+# Get voice model path (use base model without speaker ID)
+# Suppress stderr from get_voice_path since we have custom voice fallback
+VOICE_PATH=$(get_voice_path "$VOICE_MODEL_BASE" 2>/dev/null)
 if [[ $? -ne 0 ]]; then
-  echo "❌ Voice model path not found: $VOICE_MODEL"
-  exit 3
+  # Try custom voice in piper voices directory
+  CUSTOM_PATH="$HOME/.local/share/piper/voices/$VOICE_MODEL_BASE.onnx"
+  if [[ -f "$CUSTOM_PATH" ]]; then
+    VOICE_PATH="$CUSTOM_PATH"
+    echo "🎤 Using custom voice: $VOICE_MODEL_BASE"
+  else
+    echo "❌ Voice model path not found: $VOICE_MODEL"
+    exit 3
+  fi
 fi
 
 # @function determine_audio_directory
@@ -206,12 +254,25 @@ 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, $SPEECH_RATE
+# @param Uses globals: $TEXT, $VOICE_PATH, $SPEECH_RATE, $VOICE_MODEL
 # @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" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
+# @edgecases Handles piper errors, invalid models, speaker IDs
+
+# Check if voice model includes speaker ID (format: modelname#speakerID)
+SPEAKER_ID=""
+if [[ "$VOICE_MODEL" == *"#"* ]]; then
+  SPEAKER_ID="${VOICE_MODEL##*#}"
+  VOICE_MODEL="${VOICE_MODEL%%#*}"
+fi
+
+# Build piper command with optional speaker parameter
+if [[ -n "$SPEAKER_ID" ]]; then
+  echo "$TEXT" | piper --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
+else
+  echo "$TEXT" | piper --model "$VOICE_PATH" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
+fi
 
 if [[ ! -f "$TEMP_FILE" ]] || [[ ! -s "$TEMP_FILE" ]]; then
   echo "❌ Failed to synthesize speech with Piper"

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

@@ -1,11 +1,42 @@
 #!/bin/bash
 #
+# File: .claude/hooks/play-tts.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
 # @fileoverview TTS Provider Router with Language Learning Support
 # @context Routes TTS requests to active provider (ElevenLabs or Piper)
 # @architecture Provider abstraction layer - single entry point for all TTS
-# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh
-# @entrypoints Called by hooks, slash commands, and personality-manager.sh
-# @patterns Provider pattern - delegates to provider-specific implementations
+# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, github-star-reminder.sh
+# @entrypoints Called by hooks, slash commands, personality-manager.sh, and all TTS features
+# @patterns Provider pattern - delegates to provider-specific implementations, auto-detects provider from voice name
 # @related provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh
 #
 

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

@@ -1,8 +1,43 @@
 #!/bin/bash
 #
+# File: .claude/hooks/provider-commands.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
 # @fileoverview Provider management slash commands
 # @context User-facing commands for switching and managing TTS providers
-# @architecture Part of /agent-vibes:* command system
+# @architecture Part of /agent-vibes:* command system with language compatibility checking
+# @dependencies provider-manager.sh, language-manager.sh, voice-manager.sh, piper-voice-manager.sh
+# @entrypoints Called by /agent-vibes:provider slash commands (list, switch, info, test, get, preview)
+# @patterns Interactive confirmations, platform detection, language compatibility validation
+# @related provider-manager.sh, play-tts.sh, voice-manager.sh, piper-voice-manager.sh
 #
 
 # Get script directory

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

@@ -1,12 +1,43 @@
 #!/bin/bash
 #
+# File: .claude/hooks/provider-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
 # @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
+# @related play-tts.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, provider-commands.sh
 #
 
 # @function get_provider_config_path

package/.claude/hooks/replay-target-audio.sh

@@ -1,11 +1,42 @@
 #!/bin/bash
 #
+# File: .claude/hooks/replay-target-audio.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
 # @fileoverview Replay Last Target Language Audio
 # @context Replays the most recent target language TTS for language learning
-# @architecture Simple audio replay with lock mechanism
-# @dependencies ffprobe, paplay/aplay/mpg123
+# @architecture Simple audio replay with lock mechanism for sequential playback
+# @dependencies ffprobe, paplay/aplay/mpg123/mpv, .claude/last-target-audio.txt
 # @entrypoints Called by /agent-vibes:replay-target slash command
-# @patterns Sequential audio playback with lock file
+# @patterns Sequential audio playback with lock file, duration-based lock release
 # @related play-tts-piper.sh, play-tts-elevenlabs.sh, learn-manager.sh
 #
 

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

@@ -1,5 +1,43 @@
 #!/bin/bash
-# Sentiment manager for AgentVibes - applies personality to current voice
+#
+# File: .claude/hooks/sentiment-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview Sentiment Manager - Applies personality styles to current voice without changing the voice itself
+# @context Allows adding emotional/tonal layers (flirty, sarcastic, etc.) to any voice while preserving voice identity
+# @architecture Reuses personality markdown files, stores sentiment separately from personality
+# @dependencies .claude/personalities/*.md files, play-tts.sh for acknowledgment
+# @entrypoints Called by /agent-vibes:sentiment slash command
+# @patterns Personality/sentiment separation, state file management, random example selection
+# @related personality-manager.sh, .claude/personalities/*.md, .claude/tts-sentiment.txt
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PERSONALITIES_DIR="$SCRIPT_DIR/../personalities"

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

@@ -1,9 +1,43 @@
 #!/bin/bash
 #
+# File: .claude/hooks/speed-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
 # @fileoverview Speech Speed Manager for Multi-Provider TTS
 # @context Manage speech rate for main and target language voices
-# @architecture Simple config file manager supporting both Piper and ElevenLabs
-# @providers Piper (length-scale), ElevenLabs (speed API parameter)
+# @architecture Simple config file manager supporting both Piper (length-scale) and ElevenLabs (speed API parameter)
+# @dependencies .claude/config/tts-speech-rate.txt, .claude/config/tts-target-speech-rate.txt
+# @entrypoints Called by /agent-vibes:set-speed slash command
+# @patterns Provider-agnostic speed config, legacy file migration, random tongue twisters for testing
+# @related play-tts.sh, play-tts-piper.sh, play-tts-elevenlabs.sh, learn-manager.sh
 #
 
 # Get script directory

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

@@ -1,6 +1,38 @@
 #!/bin/bash
-# Voice Manager - Handle voice switching and listing
-# Usage: voice-manager.sh [list|switch|get] [voice_name]
+#
+# File: .claude/hooks/voice-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied. Use at your own risk. See the Apache License for details.
+#
+# ---
+#
+# @fileoverview Voice Manager - Unified voice management for both ElevenLabs and Piper providers
+# @context Central interface for listing, switching, previewing, and replaying TTS voices across providers
+# @architecture Provider-aware operations with dynamic voice listing based on active provider
+# @dependencies voices-config.sh (ElevenLabs mappings), piper-voice-manager.sh (Piper voices), provider-manager.sh
+# @entrypoints Called by /agent-vibes:switch, /agent-vibes:list, /agent-vibes:whoami, /agent-vibes:replay commands
+# @patterns Provider abstraction, numbered selection UI, silent mode for programmatic switching
+# @related voices-config.sh, piper-voice-manager.sh, .claude/tts-voice.txt, .claude/audio/ (replay)
 
 # Get script directory (physical path for sourcing files)
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
@@ -55,17 +87,64 @@ case "$1" in
         source "$SCRIPT_DIR/piper-voice-manager.sh"
         VOICE_DIR=$(get_voice_storage_dir)
         VOICE_COUNT=0
+
+        # Extract base voice name and speaker ID from current voice if it has # format
+        CURRENT_BASE_VOICE="$CURRENT_VOICE"
+        CURRENT_SPEAKER_ID=""
+        if [[ "$CURRENT_VOICE" == *"#"* ]]; then
+          CURRENT_BASE_VOICE="${CURRENT_VOICE%%#*}"
+          CURRENT_SPEAKER_ID="${CURRENT_VOICE##*#}"
+        fi
+
         for onnx_file in "$VOICE_DIR"/*.onnx; do
           if [[ -f "$onnx_file" ]]; then
             voice=$(basename "$onnx_file" .onnx)
-            if [ "$voice" = "$CURRENT_VOICE" ]; then
-              echo "  ▶ $voice (current)"
+            json_file="${onnx_file}.json"
+
+            # Check if this is a multi-speaker voice
+            if [[ -f "$json_file" ]] && command -v jq &> /dev/null; then
+              NUM_SPEAKERS=$(jq -r '.num_speakers // 1' "$json_file" 2>/dev/null)
+
+              if [[ "$NUM_SPEAKERS" -gt 1 ]]; then
+                # Multi-speaker voice - list all speakers
+                echo ""
+                echo "  📢 $voice (Multi-speaker: $NUM_SPEAKERS voices)"
+
+                # Read speaker names from JSON
+                jq -r '.speaker_id_map | to_entries[] | "    \(.value)️. \(.key) → \(.value|tostring)#\(.value)"' "$json_file" 2>/dev/null | while read -r speaker_line; do
+                  # Extract speaker ID from the line
+                  speaker_id=$(echo "$speaker_line" | sed -E 's/.*→ ([0-9]+)#[0-9]+$/\1/')
+
+                  # Check if this speaker is current
+                  if [[ "$voice" == "$CURRENT_BASE_VOICE" ]] && [[ "$speaker_id" == "$CURRENT_SPEAKER_ID" ]]; then
+                    # Remove the → ID#ID suffix and add current marker
+                    speaker_display=$(echo "$speaker_line" | sed -E 's/ → [0-9]+#[0-9]+$//')
+                    echo "  ▶ $speaker_display (current)"
+                  else
+                    # Remove the → ID#ID suffix
+                    speaker_display=$(echo "$speaker_line" | sed -E 's/ → [0-9]+#[0-9]+$//')
+                    echo "  $speaker_display"
+                  fi
+                done
+              else
+                # Single-speaker voice
+                if [ "$voice" = "$CURRENT_VOICE" ] || [ "$voice" = "$CURRENT_BASE_VOICE" ]; then
+                  echo "  ▶ $voice (current)"
+                else
+                  echo "    $voice"
+                fi
+              fi
             else
-              echo "    $voice"
+              # No JSON file or jq not available - show as single voice
+              if [ "$voice" = "$CURRENT_VOICE" ] || [ "$voice" = "$CURRENT_BASE_VOICE" ]; then
+                echo "  ▶ $voice (current)"
+              else
+                echo "    $voice"
+              fi
             fi
             ((VOICE_COUNT++))
           fi
-        done | sort
+        done
 
         if [[ $VOICE_COUNT -eq 0 ]]; then
           echo "  (No Piper voices downloaded yet)"

package/.claude/hooks/voices-config.sh

@@ -1,6 +1,43 @@
 #!/bin/bash
-# Single source of truth for ElevenLabs voice IDs
-# This file is sourced by both voice-manager.sh and play-tts.sh
+#
+# File: .claude/hooks/voices-config.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview ElevenLabs Voice Configuration - Single source of truth for voice ID mappings
+# @context Maps human-readable voice names to ElevenLabs API voice IDs for consistency
+# @architecture Associative array (bash hash map) sourced by multiple scripts
+# @dependencies None (pure data structure)
+# @entrypoints Sourced by voice-manager.sh, play-tts-elevenlabs.sh, and personality managers
+# @patterns Centralized configuration, DRY principle for voice mappings
+# @related voice-manager.sh, play-tts-elevenlabs.sh, personality/*.md files
 
 declare -A VOICES=(
   ["Amy"]="bhJUNIXWQQ94l8eI2VUf"