agentvibes 5.9.0 → 5.10.1

package/.claude/hooks/translator.py

@@ -1,237 +1,237 @@
-#!/usr/bin/env python3
-#
-# File: .claude/hooks/translator.py
-#
-# 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 Text translator for multi-language TTS and learning mode
-# @context Provides automatic translation using Google Translate via deep-translator library
-# @architecture Standalone CLI module callable from bash scripts, with library mode for Python imports
-# @dependencies deep-translator, langdetect (pip install deep-translator langdetect)
-# @entrypoints CLI: python3 translator.py <text> <target_lang>, Library: from translator import translate
-# @patterns Command pattern - supports translate, detect, and batch operations
-# @related play-tts.sh, learn-manager.sh, language-manager.sh
-#
-
-"""
-Text translation utilities for AgentVibes multi-language TTS.
-
-Provides automatic translation of TTS text to the user's preferred language,
-supporting both BMAD communication_language settings and learning mode.
-
-Usage:
-    CLI: python3 translator.py <text> <target_language>
-    Library: from translator import translate, detect_language
-"""
-
-import sys
-import os
-from typing import Optional, Tuple
-
-# Language name to ISO code mapping
-LANG_CODES = {
-    'spanish': 'es', 'español': 'es', 'es': 'es',
-    'french': 'fr', 'français': 'fr', 'fr': 'fr',
-    'german': 'de', 'deutsch': 'de', 'de': 'de',
-    'italian': 'it', 'italiano': 'it', 'it': 'it',
-    'portuguese': 'pt', 'português': 'pt', 'pt': 'pt',
-    'chinese': 'zh-CN', 'mandarin': 'zh-CN', 'zh': 'zh-CN', '中文': 'zh-CN',
-    'japanese': 'ja', '日本語': 'ja', 'ja': 'ja',
-    'korean': 'ko', '한국어': 'ko', 'ko': 'ko',
-    'russian': 'ru', 'русский': 'ru', 'ru': 'ru',
-    'polish': 'pl', 'polski': 'pl', 'pl': 'pl',
-    'dutch': 'nl', 'nederlands': 'nl', 'nl': 'nl',
-    'turkish': 'tr', 'türkçe': 'tr', 'tr': 'tr',
-    'arabic': 'ar', 'العربية': 'ar', 'ar': 'ar',
-    'hindi': 'hi', 'हिन्दी': 'hi', 'hi': 'hi',
-    'swedish': 'sv', 'svenska': 'sv', 'sv': 'sv',
-    'danish': 'da', 'dansk': 'da', 'da': 'da',
-    'norwegian': 'no', 'norsk': 'no', 'no': 'no',
-    'finnish': 'fi', 'suomi': 'fi', 'fi': 'fi',
-    'czech': 'cs', 'čeština': 'cs', 'cs': 'cs',
-    'romanian': 'ro', 'română': 'ro', 'ro': 'ro',
-    'ukrainian': 'uk', 'українська': 'uk', 'uk': 'uk',
-    'greek': 'el', 'ελληνικά': 'el', 'el': 'el',
-    'bulgarian': 'bg', 'български': 'bg', 'bg': 'bg',
-    'croatian': 'hr', 'hrvatski': 'hr', 'hr': 'hr',
-    'slovak': 'sk', 'slovenčina': 'sk', 'sk': 'sk',
-    'english': 'en', 'en': 'en',
-}
-
-
-def get_lang_code(language: str) -> str:
-    """
-    Convert language name to ISO code.
-
-    Args:
-        language: Language name or code (e.g., 'spanish', 'es', 'español')
-
-    Returns:
-        ISO language code (e.g., 'es')
-    """
-    lang_lower = language.lower().strip()
-    return LANG_CODES.get(lang_lower, lang_lower)
-
-
-def detect_language(text: str) -> Optional[str]:
-    """
-    Detect the language of given text.
-
-    Args:
-        text: Text to analyze
-
-    Returns:
-        Language code (e.g., 'es', 'fr', 'en') or None if detection fails
-    """
-    if not text or len(text.strip()) < 3:
-        return None
-
-    try:
-        from langdetect import detect, LangDetectException
-        return detect(text)
-    except ImportError:
-        print("Warning: langdetect not installed. Run: pip install langdetect", file=sys.stderr)
-        return None
-    except Exception:
-        return None
-
-
-def translate(text: str, target_lang: str, source_lang: str = 'en') -> Tuple[str, bool]:
-    """
-    Translate text to target language.
-
-    Args:
-        text: Text to translate
-        target_lang: Target language (name or code)
-        source_lang: Source language (default: 'en')
-
-    Returns:
-        Tuple of (translated_text, success)
-    """
-    if not text or not text.strip():
-        return text, False
-
-    # Convert language names to codes
-    target_code = get_lang_code(target_lang)
-    source_code = get_lang_code(source_lang)
-
-    # Skip if source and target are the same
-    if target_code == source_code:
-        return text, False
-
-    # Skip if target is English and source is also English
-    if target_code == 'en' and source_code == 'en':
-        return text, False
-
-    try:
-        from deep_translator import GoogleTranslator
-
-        translator = GoogleTranslator(source=source_code, target=target_code)
-        translated = translator.translate(text)
-
-        if translated:
-            return translated, True
-        return text, False
-
-    except ImportError:
-        print("Error: deep-translator not installed. Run: pip install deep-translator", file=sys.stderr)
-        return text, False
-    except Exception as e:
-        print(f"Translation error: {e}", file=sys.stderr)
-        return text, False
-
-
-def translate_auto(text: str, target_lang: str) -> Tuple[str, bool, Optional[str]]:
-    """
-    Translate text to target language with auto-detection of source language.
-
-    Args:
-        text: Text to translate
-        target_lang: Target language (name or code)
-
-    Returns:
-        Tuple of (translated_text, success, detected_source_lang)
-    """
-    if not text or not text.strip():
-        return text, False, None
-
-    # Detect source language
-    detected = detect_language(text)
-
-    # Convert target to code
-    target_code = get_lang_code(target_lang)
-
-    # Skip if detected language matches target
-    if detected and detected == target_code:
-        return text, False, detected
-
-    # Translate
-    translated, success = translate(text, target_lang, source_lang=detected or 'en')
-    return translated, success, detected
-
-
-def main():
-    """CLI entry point for translator."""
-    if len(sys.argv) < 3:
-        print("Usage: translator.py <text> <target_language> [source_language]", file=sys.stderr)
-        print("       translator.py detect <text>", file=sys.stderr)
-        print("", file=sys.stderr)
-        print("Examples:", file=sys.stderr)
-        print("  translator.py 'Hello world' spanish", file=sys.stderr)
-        print("  translator.py 'Hello world' es en", file=sys.stderr)
-        print("  translator.py detect 'Hola mundo'", file=sys.stderr)
-        sys.exit(1)
-
-    command = sys.argv[1]
-
-    # Detection mode
-    if command == 'detect':
-        if len(sys.argv) < 3:
-            print("Usage: translator.py detect <text>", file=sys.stderr)
-            sys.exit(1)
-        text = sys.argv[2]
-        detected = detect_language(text)
-        if detected:
-            print(detected)
-        else:
-            print("unknown")
-        sys.exit(0)
-
-    # Translation mode
-    text = sys.argv[1]
-    target_lang = sys.argv[2]
-    source_lang = sys.argv[3] if len(sys.argv) > 3 else 'en'
-
-    translated, success = translate(text, target_lang, source_lang)
-
-    # Output the result (for shell script consumption)
-    print(translated)
-
-    # Exit with appropriate code
-    sys.exit(0 if success else 1)
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+#
+# File: .claude/hooks/translator.py
+#
+# 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 Text translator for multi-language TTS and learning mode
+# @context Provides automatic translation using Google Translate via deep-translator library
+# @architecture Standalone CLI module callable from bash scripts, with library mode for Python imports
+# @dependencies deep-translator, langdetect (pip install deep-translator langdetect)
+# @entrypoints CLI: python3 translator.py <text> <target_lang>, Library: from translator import translate
+# @patterns Command pattern - supports translate, detect, and batch operations
+# @related play-tts.sh, learn-manager.sh, language-manager.sh
+#
+
+"""
+Text translation utilities for AgentVibes multi-language TTS.
+
+Provides automatic translation of TTS text to the user's preferred language,
+supporting both BMAD communication_language settings and learning mode.
+
+Usage:
+    CLI: python3 translator.py <text> <target_language>
+    Library: from translator import translate, detect_language
+"""
+
+import sys
+import os
+from typing import Optional, Tuple
+
+# Language name to ISO code mapping
+LANG_CODES = {
+    'spanish': 'es', 'español': 'es', 'es': 'es',
+    'french': 'fr', 'français': 'fr', 'fr': 'fr',
+    'german': 'de', 'deutsch': 'de', 'de': 'de',
+    'italian': 'it', 'italiano': 'it', 'it': 'it',
+    'portuguese': 'pt', 'português': 'pt', 'pt': 'pt',
+    'chinese': 'zh-CN', 'mandarin': 'zh-CN', 'zh': 'zh-CN', '中文': 'zh-CN',
+    'japanese': 'ja', '日本語': 'ja', 'ja': 'ja',
+    'korean': 'ko', '한국어': 'ko', 'ko': 'ko',
+    'russian': 'ru', 'русский': 'ru', 'ru': 'ru',
+    'polish': 'pl', 'polski': 'pl', 'pl': 'pl',
+    'dutch': 'nl', 'nederlands': 'nl', 'nl': 'nl',
+    'turkish': 'tr', 'türkçe': 'tr', 'tr': 'tr',
+    'arabic': 'ar', 'العربية': 'ar', 'ar': 'ar',
+    'hindi': 'hi', 'हिन्दी': 'hi', 'hi': 'hi',
+    'swedish': 'sv', 'svenska': 'sv', 'sv': 'sv',
+    'danish': 'da', 'dansk': 'da', 'da': 'da',
+    'norwegian': 'no', 'norsk': 'no', 'no': 'no',
+    'finnish': 'fi', 'suomi': 'fi', 'fi': 'fi',
+    'czech': 'cs', 'čeština': 'cs', 'cs': 'cs',
+    'romanian': 'ro', 'română': 'ro', 'ro': 'ro',
+    'ukrainian': 'uk', 'українська': 'uk', 'uk': 'uk',
+    'greek': 'el', 'ελληνικά': 'el', 'el': 'el',
+    'bulgarian': 'bg', 'български': 'bg', 'bg': 'bg',
+    'croatian': 'hr', 'hrvatski': 'hr', 'hr': 'hr',
+    'slovak': 'sk', 'slovenčina': 'sk', 'sk': 'sk',
+    'english': 'en', 'en': 'en',
+}
+
+
+def get_lang_code(language: str) -> str:
+    """
+    Convert language name to ISO code.
+
+    Args:
+        language: Language name or code (e.g., 'spanish', 'es', 'español')
+
+    Returns:
+        ISO language code (e.g., 'es')
+    """
+    lang_lower = language.lower().strip()
+    return LANG_CODES.get(lang_lower, lang_lower)
+
+
+def detect_language(text: str) -> Optional[str]:
+    """
+    Detect the language of given text.
+
+    Args:
+        text: Text to analyze
+
+    Returns:
+        Language code (e.g., 'es', 'fr', 'en') or None if detection fails
+    """
+    if not text or len(text.strip()) < 3:
+        return None
+
+    try:
+        from langdetect import detect, LangDetectException
+        return detect(text)
+    except ImportError:
+        print("Warning: langdetect not installed. Run: pip install langdetect", file=sys.stderr)
+        return None
+    except Exception:
+        return None
+
+
+def translate(text: str, target_lang: str, source_lang: str = 'en') -> Tuple[str, bool]:
+    """
+    Translate text to target language.
+
+    Args:
+        text: Text to translate
+        target_lang: Target language (name or code)
+        source_lang: Source language (default: 'en')
+
+    Returns:
+        Tuple of (translated_text, success)
+    """
+    if not text or not text.strip():
+        return text, False
+
+    # Convert language names to codes
+    target_code = get_lang_code(target_lang)
+    source_code = get_lang_code(source_lang)
+
+    # Skip if source and target are the same
+    if target_code == source_code:
+        return text, False
+
+    # Skip if target is English and source is also English
+    if target_code == 'en' and source_code == 'en':
+        return text, False
+
+    try:
+        from deep_translator import GoogleTranslator
+
+        translator = GoogleTranslator(source=source_code, target=target_code)
+        translated = translator.translate(text)
+
+        if translated:
+            return translated, True
+        return text, False
+
+    except ImportError:
+        print("Error: deep-translator not installed. Run: pip install deep-translator", file=sys.stderr)
+        return text, False
+    except Exception as e:
+        print(f"Translation error: {e}", file=sys.stderr)
+        return text, False
+
+
+def translate_auto(text: str, target_lang: str) -> Tuple[str, bool, Optional[str]]:
+    """
+    Translate text to target language with auto-detection of source language.
+
+    Args:
+        text: Text to translate
+        target_lang: Target language (name or code)
+
+    Returns:
+        Tuple of (translated_text, success, detected_source_lang)
+    """
+    if not text or not text.strip():
+        return text, False, None
+
+    # Detect source language
+    detected = detect_language(text)
+
+    # Convert target to code
+    target_code = get_lang_code(target_lang)
+
+    # Skip if detected language matches target
+    if detected and detected == target_code:
+        return text, False, detected
+
+    # Translate
+    translated, success = translate(text, target_lang, source_lang=detected or 'en')
+    return translated, success, detected
+
+
+def main():
+    """CLI entry point for translator."""
+    if len(sys.argv) < 3:
+        print("Usage: translator.py <text> <target_language> [source_language]", file=sys.stderr)
+        print("       translator.py detect <text>", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("Examples:", file=sys.stderr)
+        print("  translator.py 'Hello world' spanish", file=sys.stderr)
+        print("  translator.py 'Hello world' es en", file=sys.stderr)
+        print("  translator.py detect 'Hola mundo'", file=sys.stderr)
+        sys.exit(1)
+
+    command = sys.argv[1]
+
+    # Detection mode
+    if command == 'detect':
+        if len(sys.argv) < 3:
+            print("Usage: translator.py detect <text>", file=sys.stderr)
+            sys.exit(1)
+        text = sys.argv[2]
+        detected = detect_language(text)
+        if detected:
+            print(detected)
+        else:
+            print("unknown")
+        sys.exit(0)
+
+    # Translation mode
+    text = sys.argv[1]
+    target_lang = sys.argv[2]
+    source_lang = sys.argv[3] if len(sys.argv) > 3 else 'en'
+
+    translated, success = translate(text, target_lang, source_lang)
+
+    # Output the result (for shell script consumption)
+    print(translated)
+
+    # Exit with appropriate code
+    sys.exit(0 if success else 1)
+
+
+if __name__ == '__main__':
+    main()

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

@@ -513,6 +513,12 @@ case "$1" in
       fi
     fi
 
+    # Normalize to canonical path so ls output is consistent across platforms
+    # (Git Bash resolves /tmp→/c/Users/..., macOS has /var→/private/var)
+    if [[ -d "$AUDIO_DIR" ]]; then
+      AUDIO_DIR=$(cd "$AUDIO_DIR" && pwd -P)
+    fi
+
     # Default to replay last audio (N=1)
     N="${2:-1}"
 

package/.claude/hooks-windows/play-tts-windows-piper.ps1

@@ -62,15 +62,20 @@ if (-not $VoiceName) {
 }
 
 # Security: Validate voice name to prevent path traversal
-# Only allow alphanumeric, underscore, hyphen, and period
-if ($VoiceName -notmatch '^[a-zA-Z0-9_\-\.]+$') {
+# Format: <model> or <model>::<speaker> for multi-speaker Piper models
+# Only allow alphanumeric, underscore, hyphen, period, and the :: separator
+if ($VoiceName -notmatch '^[a-zA-Z0-9_\-\.]+(::[a-zA-Z0-9_\-\.]+)?$') {
     Write-Host "[ERROR] Invalid voice name: $VoiceName" -ForegroundColor Red
     exit 1
 }
 
+# Extract model name and optional speaker (multi-speaker format: model::Speaker)
+$VoiceModel  = ($VoiceName -split '::')[0]
+$SpeakerName = if ($VoiceName -match '::(.+)$') { $Matches[1] } else { "" }
+
 # Resolve voice model path and validate it stays within VoicesDir
-$VoiceModelFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceName.onnx")
-$VoiceJsonFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceName.onnx.json")
+$VoiceModelFile = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceModel.onnx")
+$VoiceJsonFile  = [System.IO.Path]::GetFullPath("$VoicesDir\$VoiceModel.onnx.json")
 $ResolvedVoicesDir = [System.IO.Path]::GetFullPath($VoicesDir)
 if (-not $VoiceModelFile.StartsWith($ResolvedVoicesDir)) {
     Write-Host "[ERROR] Voice path outside voices directory" -ForegroundColor Red
@@ -79,15 +84,15 @@ if (-not $VoiceModelFile.StartsWith($ResolvedVoicesDir)) {
 
 # Check if voice model exists, download if missing
 if (-not (Test-Path $VoiceModelFile)) {
-    Write-Host "[DOWNLOAD] Voice model: $VoiceName" -ForegroundColor Yellow
+    Write-Host "[DOWNLOAD] Voice model: $VoiceModel" -ForegroundColor Yellow
 
     # Try to download from Hugging Face
     # Voice name format: {lang}_{region}-{speaker}-{quality}
     # HF path format:    {lang}/{lang}_{region}/{speaker}/{quality}/{voicename}.onnx
     try {
-        # Parse voice name to build correct HF path
+        # Parse model name to build correct HF path (strip ::Speaker suffix first)
         # e.g. en_US-ryan-high -> en/en_US/ryan/high/en_US-ryan-high.onnx
-        if ($VoiceName -match '^([a-z]{2})_([A-Z]{2})-([a-zA-Z0-9_]+)-([a-z]+)$') {
+        if ($VoiceModel -match '^([a-z]{2})_([A-Z]{2})-([a-zA-Z0-9_]+)-([a-z]+)$') {
             $Lang = $Matches[1]
             $LangRegion = "$($Matches[1])_$($Matches[2])"
             $Speaker = $Matches[3]
@@ -97,8 +102,8 @@ if (-not (Test-Path $VoiceModelFile)) {
             # Fallback for non-standard voice names
             $HFBase = "https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/ryan/high"
         }
-        $ModelUrl = "$HFBase/$VoiceName.onnx"
-        $JsonUrl = "$HFBase/$VoiceName.onnx.json"
+        $ModelUrl = "$HFBase/$VoiceModel.onnx"
+        $JsonUrl = "$HFBase/$VoiceModel.onnx.json"
 
         Write-Host "   Downloading model..." -ForegroundColor Cyan
         Invoke-WebRequest -Uri $ModelUrl -OutFile $VoiceModelFile -ErrorAction Stop
@@ -127,11 +132,10 @@ $AudioFile = "$AudioDir\tts-$Timestamp.wav"
 try {
     Write-Host "[SYNTH] Synthesizing with Piper..." -ForegroundColor Cyan
 
-    # Run Piper with text input
-    $Text | & $PiperExe `
-        --model $VoiceModelFile `
-        --output-file $AudioFile `
-        2>$null
+    # Run Piper with text input; pass --speaker for multi-speaker models (model::Speaker format)
+    $piperArgs = @('--model', $VoiceModelFile, '--output-file', $AudioFile)
+    if ($SpeakerName) { $piperArgs += @('--speaker', $SpeakerName) }
+    $Text | & $PiperExe @piperArgs 2>$null
 
     if (-not (Test-Path $AudioFile)) {
         Write-Host "[ERROR] Piper synthesis failed" -ForegroundColor Red
@@ -151,12 +155,14 @@ try {
     if (-not $env:AGENTVIBES_NO_PLAY) {
         # Prefer ffplay: handles 22050 Hz → 48000 Hz resampling cleanly (SoundPlayer uses
         # WinMM's low-quality resampler which produces choppy audio at non-native rates).
-        $ffplayPath = (Get-Command ffplay -ErrorAction SilentlyContinue)?.Source
+        $ffplayCmd = Get-Command ffplay -ErrorAction SilentlyContinue
+        $ffplayPath = if ($ffplayCmd) { $ffplayCmd.Source }
         if (-not $ffplayPath) {
             # SSH/watcher sessions may have a minimal PATH — refresh from registry
             $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" +
                         [System.Environment]::GetEnvironmentVariable("Path","User")
-            $ffplayPath = (Get-Command ffplay -ErrorAction SilentlyContinue)?.Source
+            $ffplayCmd = Get-Command ffplay -ErrorAction SilentlyContinue
+            $ffplayPath = if ($ffplayCmd) { $ffplayCmd.Source }
         }
         if ($ffplayPath) {
             & $ffplayPath -autoexit -nodisp -loglevel quiet $AudioFile 2>$null