agentvibes 4.2.0 → 4.4.0

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

@@ -1,362 +1,362 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/language-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 Language Manager - Manages multilingual TTS with 30+ language support
-# @context Enables TTS in multiple languages with provider-specific voice recommendations (Piper native voices)
-# @architecture Dual-map system: PIPER_VOICES for provider-aware voice selection
-# @dependencies provider-manager.sh for active provider detection, .claude/tts-language.txt for state
-# @entrypoints Called by /agent-vibes:language commands, play-tts-*.sh for voice resolution
-# @patterns Provider abstraction, language-to-voice mapping, backward compatibility with legacy LANGUAGE_VOICES
-# @related play-tts-piper.sh, provider-manager.sh, learn-manager.sh
-
-# Determine target .claude directory based on context
-# Priority:
-# 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
-# 2. Script location (for direct slash command usage)
-# 3. Global ~/.claude (fallback)
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]] && [[ -d "${CLAUDE_PROJECT_DIR:-}/.claude" ]]; then
-  # MCP context: Use the project directory where MCP was invoked
-  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
-else
-  # Direct usage context: Use script location
-  CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
-
-  # If script is in global ~/.claude, use that
-  if [[ "$CLAUDE_DIR" == "$HOME/.claude" ]]; then
-    CLAUDE_DIR="$HOME/.claude"
-  elif [[ ! -d "$CLAUDE_DIR" ]]; then
-    # Fallback to global if directory doesn't exist
-    CLAUDE_DIR="$HOME/.claude"
-  fi
-fi
-
-LANGUAGE_FILE="$CLAUDE_DIR/tts-language.txt"
-mkdir -p "$CLAUDE_DIR"
-
-# Source provider manager to detect active provider
-source "$SCRIPT_DIR/provider-manager.sh" 2>/dev/null || true
-
-# =============================================================================
-# BASH 3.2 COMPATIBILITY: Function-based lookups instead of associative arrays
-# macOS ships with Bash 3.2 which doesn't support declare -A (added in Bash 4.0)
-# =============================================================================
-
-
-# Get Piper voice for a language
-_get_piper_voice() {
-    local lang="$1"
-    case "$lang" in
-        spanish) echo "es_ES-davefx-medium" ;;
-        french) echo "fr_FR-siwis-medium" ;;
-        german) echo "de_DE-thorsten-medium" ;;
-        italian) echo "it_IT-riccardo-x_low" ;;
-        portuguese) echo "pt_BR-faber-medium" ;;
-        chinese) echo "zh_CN-huayan-medium" ;;
-        japanese) echo "ja_JP-hikari-medium" ;;
-        korean) echo "ko_KR-eunyoung-medium" ;;
-        russian) echo "ru_RU-dmitri-medium" ;;
-        polish) echo "pl_PL-darkman-medium" ;;
-        dutch) echo "nl_NL-rdh-medium" ;;
-        turkish) echo "tr_TR-dfki-medium" ;;
-        arabic) echo "ar_JO-kareem-medium" ;;
-        hindi) echo "hi_IN-amitabh-medium" ;;
-        swedish) echo "sv_SE-nst-medium" ;;
-        danish) echo "da_DK-talesyntese-medium" ;;
-        norwegian) echo "no_NO-talesyntese-medium" ;;
-        finnish) echo "fi_FI-harri-medium" ;;
-        czech) echo "cs_CZ-jirka-medium" ;;
-        romanian) echo "ro_RO-mihai-medium" ;;
-        ukrainian) echo "uk_UA-lada-x_low" ;;
-        greek) echo "el_GR-rapunzelina-low" ;;
-        bulgarian) echo "bg_BG-valentin-medium" ;;
-        croatian) echo "hr_HR-gorana-medium" ;;
-        slovak) echo "sk_SK-lili-medium" ;;
-        *) echo "" ;;
-    esac
-}
-
-# Get default (Piper) voice for a language - backward compatibility
-_get_language_voice() {
-    _get_piper_voice "$1"
-}
-
-# Check if language is supported
-_is_language_supported() {
-    local lang="$1"
-    local voice
-    voice=$(_get_piper_voice "$lang")
-    [[ -n "$voice" ]]
-}
-
-# Supported languages list
-SUPPORTED_LANGUAGES="spanish, french, german, italian, portuguese, chinese, japanese, korean, polish, dutch, turkish, russian, arabic, hindi, swedish, danish, norwegian, finnish, czech, romanian, ukrainian, greek, bulgarian, croatian, slovak"
-
-# Function to set language
-set_language() {
-    local lang="$1"
-
-    # Convert to lowercase
-    lang=$(echo "$lang" | tr '[:upper:]' '[:lower:]')
-
-    # Handle reset/english
-    if [[ "$lang" == "reset" ]] || [[ "$lang" == "english" ]] || [[ "$lang" == "en" ]]; then
-        if [[ -f "$LANGUAGE_FILE" ]]; then
-            rm "$LANGUAGE_FILE"
-            echo "✓ Language reset to English (default)"
-        else
-            echo "Already using English (default)"
-        fi
-        return 0
-    fi
-
-    # Check if language is supported (Bash 3.2 compatible)
-    if ! _is_language_supported "$lang"; then
-        echo "❌ Language '$lang' not supported"
-        echo ""
-        echo "Supported languages:"
-        echo "$SUPPORTED_LANGUAGES"
-        return 1
-    fi
-
-    # Save language
-    echo "$lang" > "$LANGUAGE_FILE"
-
-    # Detect active provider and get recommended voice
-    local provider=""
-    if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
-        provider=$(cat "$CLAUDE_DIR/tts-provider.txt")
-    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-        provider=$(cat "$HOME/.claude/tts-provider.txt")
-    else
-        provider="piper"
-    fi
-
-    local recommended_voice
-    recommended_voice=$(get_voice_for_language "$lang" "$provider")
-
-    # Fallback to default mapping if provider-aware function returns empty
-    if [[ -z "$recommended_voice" ]]; then
-        recommended_voice=$(_get_language_voice "$lang")
-    fi
-
-    echo "✓ Language set to: $lang"
-    echo "📢 Recommended voice for $provider TTS: $recommended_voice"
-    echo ""
-    echo "TTS will now speak in $lang."
-    echo "Switch voice with: /agent-vibes:switch \"$recommended_voice\""
-}
-
-# Function to get current language
-get_language() {
-    if [[ -f "$LANGUAGE_FILE" ]]; then
-        local lang=$(cat "$LANGUAGE_FILE")
-
-        # Detect active provider
-        local provider=""
-        if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
-            provider=$(cat "$CLAUDE_DIR/tts-provider.txt")
-        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-            provider=$(cat "$HOME/.claude/tts-provider.txt")
-        else
-            provider="piper"
-        fi
-
-        local recommended_voice
-        recommended_voice=$(get_voice_for_language "$lang" "$provider")
-
-        # Fallback to default mapping
-        if [[ -z "$recommended_voice" ]]; then
-            recommended_voice=$(_get_language_voice "$lang")
-        fi
-
-        echo "Current language: $lang"
-        echo "Recommended voice ($provider): $recommended_voice"
-    else
-        echo "Current language: english (default)"
-        echo "No multilingual voice required"
-    fi
-}
-
-# Function to get language for use in other scripts
-get_language_code() {
-    if [[ -f "$LANGUAGE_FILE" ]]; then
-        cat "$LANGUAGE_FILE"
-    else
-        echo "english"
-    fi
-}
-
-# Function to check if current voice supports language
-is_voice_multilingual() {
-    local voice="$1"
-
-    # List of multilingual voices
-    local multilingual_voices=("Antoni" "Rachel" "Domi" "Bella" "Charlotte" "Matilda")
-
-    for mv in "${multilingual_voices[@]}"; do
-        if [[ "$voice" == "$mv" ]]; then
-            return 0
-        fi
-    done
-
-    return 1
-}
-
-# Function to get best voice for current language
-get_best_voice_for_language() {
-    local lang=$(get_language_code)
-
-    if [[ "$lang" == "english" ]]; then
-        # No specific multilingual voice needed for English
-        echo ""
-        return
-    fi
-
-    # Return recommended voice for language
-    _get_language_voice "$lang"
-}
-
-# Function to get voice for a specific language and provider
-# Usage: get_voice_for_language <language> [provider]
-# Provider: "piper" or "macos" (auto-detected if not provided)
-get_voice_for_language() {
-    local language="$1"
-    local provider="${2:-}"
-
-    # Convert to lowercase
-    language=$(echo "$language" | tr '[:upper:]' '[:lower:]')
-
-    # Auto-detect provider if not specified
-    if [[ -z "$provider" ]]; then
-        if command -v get_active_provider &>/dev/null; then
-            provider=$(get_active_provider 2>/dev/null)
-        else
-            # Fallback to checking provider file directly
-            # Try current directory first, then search up the tree
-            local search_dir="$PWD"
-            local found=false
-
-            while [[ "$search_dir" != "/" ]]; do
-                if [[ -f "$search_dir/.claude/tts-provider.txt" ]]; then
-                    provider=$(cat "$search_dir/.claude/tts-provider.txt")
-                    found=true
-                    break
-                fi
-                search_dir=$(dirname "$search_dir")
-            done
-
-            # If not found in project tree, check global
-            if [[ "$found" = false ]]; then
-                if [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-                    provider=$(cat "$HOME/.claude/tts-provider.txt")
-                else
-                    provider="piper"  # Default
-                fi
-            fi
-        fi
-    fi
-
-    # Return appropriate voice based on provider (Bash 3.2 compatible)
-    case "$provider" in
-        piper)
-            _get_piper_voice "$language"
-            ;;
-        macos)
-            # macOS doesn't have per-language voices, use default
-            echo ""
-            ;;
-        *)
-            _get_piper_voice "$language"
-            ;;
-    esac
-}
-
-# Main command handler - only run if script is executed directly, not sourced
-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
-    case "${1:-}" in
-        set)
-            if [[ -z "$2" ]]; then
-                echo "Usage: language-manager.sh set <language>"
-                exit 1
-            fi
-            set_language "$2"
-            ;;
-        get)
-            get_language
-            ;;
-        code)
-            get_language_code
-            ;;
-        check-voice)
-            if [[ -z "$2" ]]; then
-                echo "Usage: language-manager.sh check-voice <voice-name>"
-                exit 1
-            fi
-            if is_voice_multilingual "$2"; then
-                echo "yes"
-            else
-                echo "no"
-            fi
-            ;;
-        best-voice)
-            get_best_voice_for_language
-            ;;
-        voice-for-language)
-            if [[ -z "$2" ]]; then
-                echo "Usage: language-manager.sh voice-for-language <language> [provider]"
-                exit 1
-            fi
-            get_voice_for_language "$2" "$3"
-            ;;
-        list)
-            echo "Supported languages and recommended voices:"
-            echo ""
-            # Bash 3.2 compatible - use explicit list instead of associative array keys
-            # Note: 'local' can't be used outside functions in Bash 3.2
-            for lang in spanish french german italian portuguese chinese japanese korean russian polish dutch turkish arabic hindi swedish danish norwegian finnish czech romanian ukrainian greek bulgarian croatian slovak; do
-                printf "%-15s → %s\n" "$lang" "$(_get_language_voice "$lang")"
-            done | sort
-            ;;
-        *)
-            echo "AgentVibes Language Manager"
-            echo ""
-            echo "Usage:"
-            echo "  language-manager.sh set <language>                    Set language"
-            echo "  language-manager.sh get                               Get current language"
-            echo "  language-manager.sh code                              Get language code only"
-            echo "  language-manager.sh check-voice <name>                Check if voice is multilingual"
-            echo "  language-manager.sh best-voice                        Get best voice for current language"
-            echo "  language-manager.sh voice-for-language <lang> [prov] Get voice for language & provider"
-            echo "  language-manager.sh list                              List all supported languages"
-            exit 1
-            ;;
-    esac
-fi
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/language-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 Language Manager - Manages multilingual TTS with 30+ language support
+# @context Enables TTS in multiple languages with provider-specific voice recommendations (Piper native voices)
+# @architecture Dual-map system: PIPER_VOICES for provider-aware voice selection
+# @dependencies provider-manager.sh for active provider detection, .claude/tts-language.txt for state
+# @entrypoints Called by /agent-vibes:language commands, play-tts-*.sh for voice resolution
+# @patterns Provider abstraction, language-to-voice mapping, backward compatibility with legacy LANGUAGE_VOICES
+# @related play-tts-piper.sh, provider-manager.sh, learn-manager.sh
+
+# Determine target .claude directory based on context
+# Priority:
+# 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
+# 2. Script location (for direct slash command usage)
+# 3. Global ~/.claude (fallback)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]] && [[ -d "${CLAUDE_PROJECT_DIR:-}/.claude" ]]; then
+  # MCP context: Use the project directory where MCP was invoked
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
+else
+  # Direct usage context: Use script location
+  CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
+
+  # If script is in global ~/.claude, use that
+  if [[ "$CLAUDE_DIR" == "$HOME/.claude" ]]; then
+    CLAUDE_DIR="$HOME/.claude"
+  elif [[ ! -d "$CLAUDE_DIR" ]]; then
+    # Fallback to global if directory doesn't exist
+    CLAUDE_DIR="$HOME/.claude"
+  fi
+fi
+
+LANGUAGE_FILE="$CLAUDE_DIR/tts-language.txt"
+mkdir -p "$CLAUDE_DIR"
+
+# Source provider manager to detect active provider
+source "$SCRIPT_DIR/provider-manager.sh" 2>/dev/null || true
+
+# =============================================================================
+# BASH 3.2 COMPATIBILITY: Function-based lookups instead of associative arrays
+# macOS ships with Bash 3.2 which doesn't support declare -A (added in Bash 4.0)
+# =============================================================================
+
+
+# Get Piper voice for a language
+_get_piper_voice() {
+    local lang="$1"
+    case "$lang" in
+        spanish) echo "es_ES-davefx-medium" ;;
+        french) echo "fr_FR-siwis-medium" ;;
+        german) echo "de_DE-thorsten-medium" ;;
+        italian) echo "it_IT-riccardo-x_low" ;;
+        portuguese) echo "pt_BR-faber-medium" ;;
+        chinese) echo "zh_CN-huayan-medium" ;;
+        japanese) echo "ja_JP-hikari-medium" ;;
+        korean) echo "ko_KR-eunyoung-medium" ;;
+        russian) echo "ru_RU-dmitri-medium" ;;
+        polish) echo "pl_PL-darkman-medium" ;;
+        dutch) echo "nl_NL-rdh-medium" ;;
+        turkish) echo "tr_TR-dfki-medium" ;;
+        arabic) echo "ar_JO-kareem-medium" ;;
+        hindi) echo "hi_IN-amitabh-medium" ;;
+        swedish) echo "sv_SE-nst-medium" ;;
+        danish) echo "da_DK-talesyntese-medium" ;;
+        norwegian) echo "no_NO-talesyntese-medium" ;;
+        finnish) echo "fi_FI-harri-medium" ;;
+        czech) echo "cs_CZ-jirka-medium" ;;
+        romanian) echo "ro_RO-mihai-medium" ;;
+        ukrainian) echo "uk_UA-lada-x_low" ;;
+        greek) echo "el_GR-rapunzelina-low" ;;
+        bulgarian) echo "bg_BG-valentin-medium" ;;
+        croatian) echo "hr_HR-gorana-medium" ;;
+        slovak) echo "sk_SK-lili-medium" ;;
+        *) echo "" ;;
+    esac
+}
+
+# Get default (Piper) voice for a language - backward compatibility
+_get_language_voice() {
+    _get_piper_voice "$1"
+}
+
+# Check if language is supported
+_is_language_supported() {
+    local lang="$1"
+    local voice
+    voice=$(_get_piper_voice "$lang")
+    [[ -n "$voice" ]]
+}
+
+# Supported languages list
+SUPPORTED_LANGUAGES="spanish, french, german, italian, portuguese, chinese, japanese, korean, polish, dutch, turkish, russian, arabic, hindi, swedish, danish, norwegian, finnish, czech, romanian, ukrainian, greek, bulgarian, croatian, slovak"
+
+# Function to set language
+set_language() {
+    local lang="$1"
+
+    # Convert to lowercase
+    lang=$(echo "$lang" | tr '[:upper:]' '[:lower:]')
+
+    # Handle reset/english
+    if [[ "$lang" == "reset" ]] || [[ "$lang" == "english" ]] || [[ "$lang" == "en" ]]; then
+        if [[ -f "$LANGUAGE_FILE" ]]; then
+            rm "$LANGUAGE_FILE"
+            echo "✓ Language reset to English (default)"
+        else
+            echo "Already using English (default)"
+        fi
+        return 0
+    fi
+
+    # Check if language is supported (Bash 3.2 compatible)
+    if ! _is_language_supported "$lang"; then
+        echo "❌ Language '$lang' not supported"
+        echo ""
+        echo "Supported languages:"
+        echo "$SUPPORTED_LANGUAGES"
+        return 1
+    fi
+
+    # Save language
+    echo "$lang" > "$LANGUAGE_FILE"
+
+    # Detect active provider and get recommended voice
+    local provider=""
+    if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
+        provider=$(cat "$CLAUDE_DIR/tts-provider.txt")
+    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+        provider=$(cat "$HOME/.claude/tts-provider.txt")
+    else
+        provider="piper"
+    fi
+
+    local recommended_voice
+    recommended_voice=$(get_voice_for_language "$lang" "$provider")
+
+    # Fallback to default mapping if provider-aware function returns empty
+    if [[ -z "$recommended_voice" ]]; then
+        recommended_voice=$(_get_language_voice "$lang")
+    fi
+
+    echo "✓ Language set to: $lang"
+    echo "📢 Recommended voice for $provider TTS: $recommended_voice"
+    echo ""
+    echo "TTS will now speak in $lang."
+    echo "Switch voice with: /agent-vibes:switch \"$recommended_voice\""
+}
+
+# Function to get current language
+get_language() {
+    if [[ -f "$LANGUAGE_FILE" ]]; then
+        local lang=$(cat "$LANGUAGE_FILE")
+
+        # Detect active provider
+        local provider=""
+        if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
+            provider=$(cat "$CLAUDE_DIR/tts-provider.txt")
+        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+            provider=$(cat "$HOME/.claude/tts-provider.txt")
+        else
+            provider="piper"
+        fi
+
+        local recommended_voice
+        recommended_voice=$(get_voice_for_language "$lang" "$provider")
+
+        # Fallback to default mapping
+        if [[ -z "$recommended_voice" ]]; then
+            recommended_voice=$(_get_language_voice "$lang")
+        fi
+
+        echo "Current language: $lang"
+        echo "Recommended voice ($provider): $recommended_voice"
+    else
+        echo "Current language: english (default)"
+        echo "No multilingual voice required"
+    fi
+}
+
+# Function to get language for use in other scripts
+get_language_code() {
+    if [[ -f "$LANGUAGE_FILE" ]]; then
+        cat "$LANGUAGE_FILE"
+    else
+        echo "english"
+    fi
+}
+
+# Function to check if current voice supports language
+is_voice_multilingual() {
+    local voice="$1"
+
+    # List of multilingual voices
+    local multilingual_voices=("Antoni" "Rachel" "Domi" "Bella" "Charlotte" "Matilda")
+
+    for mv in "${multilingual_voices[@]}"; do
+        if [[ "$voice" == "$mv" ]]; then
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+# Function to get best voice for current language
+get_best_voice_for_language() {
+    local lang=$(get_language_code)
+
+    if [[ "$lang" == "english" ]]; then
+        # No specific multilingual voice needed for English
+        echo ""
+        return
+    fi
+
+    # Return recommended voice for language
+    _get_language_voice "$lang"
+}
+
+# Function to get voice for a specific language and provider
+# Usage: get_voice_for_language <language> [provider]
+# Provider: "piper" or "macos" (auto-detected if not provided)
+get_voice_for_language() {
+    local language="$1"
+    local provider="${2:-}"
+
+    # Convert to lowercase
+    language=$(echo "$language" | tr '[:upper:]' '[:lower:]')
+
+    # Auto-detect provider if not specified
+    if [[ -z "$provider" ]]; then
+        if command -v get_active_provider &>/dev/null; then
+            provider=$(get_active_provider 2>/dev/null)
+        else
+            # Fallback to checking provider file directly
+            # Try current directory first, then search up the tree
+            local search_dir="$PWD"
+            local found=false
+
+            while [[ "$search_dir" != "/" ]]; do
+                if [[ -f "$search_dir/.claude/tts-provider.txt" ]]; then
+                    provider=$(cat "$search_dir/.claude/tts-provider.txt")
+                    found=true
+                    break
+                fi
+                search_dir=$(dirname "$search_dir")
+            done
+
+            # If not found in project tree, check global
+            if [[ "$found" = false ]]; then
+                if [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+                    provider=$(cat "$HOME/.claude/tts-provider.txt")
+                else
+                    provider="piper"  # Default
+                fi
+            fi
+        fi
+    fi
+
+    # Return appropriate voice based on provider (Bash 3.2 compatible)
+    case "$provider" in
+        piper)
+            _get_piper_voice "$language"
+            ;;
+        macos)
+            # macOS doesn't have per-language voices, use default
+            echo ""
+            ;;
+        *)
+            _get_piper_voice "$language"
+            ;;
+    esac
+}
+
+# Main command handler - only run if script is executed directly, not sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    case "${1:-}" in
+        set)
+            if [[ -z "$2" ]]; then
+                echo "Usage: language-manager.sh set <language>"
+                exit 1
+            fi
+            set_language "$2"
+            ;;
+        get)
+            get_language
+            ;;
+        code)
+            get_language_code
+            ;;
+        check-voice)
+            if [[ -z "$2" ]]; then
+                echo "Usage: language-manager.sh check-voice <voice-name>"
+                exit 1
+            fi
+            if is_voice_multilingual "$2"; then
+                echo "yes"
+            else
+                echo "no"
+            fi
+            ;;
+        best-voice)
+            get_best_voice_for_language
+            ;;
+        voice-for-language)
+            if [[ -z "$2" ]]; then
+                echo "Usage: language-manager.sh voice-for-language <language> [provider]"
+                exit 1
+            fi
+            get_voice_for_language "$2" "$3"
+            ;;
+        list)
+            echo "Supported languages and recommended voices:"
+            echo ""
+            # Bash 3.2 compatible - use explicit list instead of associative array keys
+            # Note: 'local' can't be used outside functions in Bash 3.2
+            for lang in spanish french german italian portuguese chinese japanese korean russian polish dutch turkish arabic hindi swedish danish norwegian finnish czech romanian ukrainian greek bulgarian croatian slovak; do
+                printf "%-15s → %s\n" "$lang" "$(_get_language_voice "$lang")"
+            done | sort
+            ;;
+        *)
+            echo "AgentVibes Language Manager"
+            echo ""
+            echo "Usage:"
+            echo "  language-manager.sh set <language>                    Set language"
+            echo "  language-manager.sh get                               Get current language"
+            echo "  language-manager.sh code                              Get language code only"
+            echo "  language-manager.sh check-voice <name>                Check if voice is multilingual"
+            echo "  language-manager.sh best-voice                        Get best voice for current language"
+            echo "  language-manager.sh voice-for-language <lang> [prov] Get voice for language & provider"
+            echo "  language-manager.sh list                              List all supported languages"
+            exit 1
+            ;;
+    esac
+fi