agentvibes 2.0.17 → 2.0.18

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"