agentvibes 5.1.4 → 5.2.1

package/.claude/hooks/play-tts-agentvibes-receiver-for-voiceless-connections.sh

@@ -1,90 +1,97 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/play-tts-agentvibes-receiver-for-voiceless-connections.sh
-#
-# AgentVibes - AgentVibes Receiver Provider (for voiceless connections)
-# Sends text to a remote device via SSH for local AgentVibes playback.
-# Use this when the AI agent runs on a server/headless machine that has no
-# audio output — the remote device (laptop, phone, etc.) plays the audio.
-#
-# Copyright (c) 2025 Paul Preibisch
-# Licensed under the Apache License, Version 2.0
-#
-
-set -euo pipefail
-
-TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
-AGENT_NAME="${3:-default}"
-
-# Validate required input
-if [[ -z "$TEXT" ]]; then
-  echo "❌ No text provided" >&2
-  echo "Usage: $0 <text> [voice] [agent_name]" >&2
-  exit 1
-fi
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# Get SSH host from config
-SSH_HOST=$(cat "$PROJECT_ROOT/.claude/agentvibes-receiver-host.txt" 2>/dev/null || \
-           cat "$HOME/.claude/agentvibes-receiver-host.txt" 2>/dev/null || echo "")
-
-if [[ -z "$SSH_HOST" ]]; then
-  echo "❌ AgentVibes Receiver host not configured" >&2
-  echo "💡 Set host: echo 'your-device' > ~/.claude/agentvibes-receiver-host.txt" >&2
-  exit 1
-fi
-
-# SECURITY: Validate SSH_HOST to prevent option injection
-# Must be a valid hostname, IP address, or SSH config alias (alphanumeric, dots, hyphens, underscores)
-if [[ ! "$SSH_HOST" =~ ^[a-zA-Z0-9][a-zA-Z0-9._-]*$ ]]; then
-  echo "❌ Invalid SSH host format: $SSH_HOST" >&2
-  echo "💡 Host must be alphanumeric (may contain dots, hyphens, underscores)" >&2
-  exit 1
-fi
-
-# SECURITY: Reject hosts starting with hyphen (SSH option injection)
-if [[ "$SSH_HOST" == -* ]]; then
-  echo "❌ Invalid SSH host: cannot start with hyphen" >&2
-  exit 1
-fi
-
-# SECURITY: Validate VOICE to prevent injection (alphanumeric, hyphens, underscores only)
-if [[ ! "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]]; then
-  echo "❌ Invalid voice format: $VOICE" >&2
-  exit 1
-fi
-
-# SECURITY: Validate AGENT_NAME to prevent injection (alphanumeric, hyphens, underscores, spaces only)
-if [[ ! "$AGENT_NAME" =~ ^[a-zA-Z0-9_\ -]+$ ]]; then
-  echo "❌ Invalid agent name format: $AGENT_NAME" >&2
-  exit 1
-fi
-
-# SECURITY: Encode text and agent name as base64 to prevent command injection
-# The receiver will decode these safely
-ENCODED_TEXT=$(printf '%s' "$TEXT" | base64 -w 0)
-ENCODED_AGENT=$(printf '%s' "$AGENT_NAME" | base64 -w 0)
-
-# Send text to remote for local AgentVibes playback
-echo "📱 Sending to $SSH_HOST for local playback..." >&2
-
-# Try receiver scripts in order — single SSH call, no separate probe
-# SECURITY: Base64-encoded values are safe to pass as arguments (no shell metacharacters)
-ssh "$SSH_HOST" "
-  if [ -f ~/.agentvibes/play-remote.sh ]; then
-    bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
-  elif [ -f ~/.termux/agentvibes-play.sh ]; then
-    bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
-  else
-    echo 'Error: Receiver script not found' >&2
-    exit 1
-  fi
-" &
-SSH_PID=$!
-
-echo "Sent to $SSH_HOST (PID: $SSH_PID)" >&2
-exit 0
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/play-tts-agentvibes-receiver-for-voiceless-connections.sh
+#
+# AgentVibes - AgentVibes Receiver Provider (for voiceless connections)
+# Sends text to a remote device via SSH for local AgentVibes playback.
+# Use this when the AI agent runs on a server/headless machine that has no
+# audio output — the remote device (laptop, phone, etc.) plays the audio.
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+AGENT_NAME="${3:-default}"
+
+# Validate required input
+if [[ -z "$TEXT" ]]; then
+  echo "❌ No text provided" >&2
+  echo "Usage: $0 <text> [voice] [agent_name]" >&2
+  exit 1
+fi
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Get SSH host from config
+SSH_HOST=$(cat "$PROJECT_ROOT/.claude/agentvibes-receiver-host.txt" 2>/dev/null || \
+           cat "$HOME/.claude/agentvibes-receiver-host.txt" 2>/dev/null || echo "")
+
+if [[ -z "$SSH_HOST" ]]; then
+  echo "❌ AgentVibes Receiver host not configured" >&2
+  echo "💡 Set host: echo 'your-device' > ~/.claude/agentvibes-receiver-host.txt" >&2
+  exit 1
+fi
+
+# SECURITY: Validate SSH_HOST to prevent option injection
+# Must be a valid hostname, IP address, or SSH config alias (alphanumeric, dots, hyphens, underscores)
+if [[ ! "$SSH_HOST" =~ ^[a-zA-Z0-9][a-zA-Z0-9._-]*$ ]]; then
+  echo "❌ Invalid SSH host format: $SSH_HOST" >&2
+  echo "💡 Host must be alphanumeric (may contain dots, hyphens, underscores)" >&2
+  exit 1
+fi
+
+# SECURITY: Reject hosts starting with hyphen (SSH option injection)
+if [[ "$SSH_HOST" == -* ]]; then
+  echo "❌ Invalid SSH host: cannot start with hyphen" >&2
+  exit 1
+fi
+
+# SECURITY: Validate VOICE (allow :: for multi-speaker, . for locale, space for names)
+_voice_re='^[a-zA-Z0-9_.:  -]+$'
+if [[ ! "$VOICE" =~ $_voice_re ]]; then
+  echo "❌ Invalid voice format: $VOICE" >&2
+  exit 1
+fi
+
+# SECURITY: Validate AGENT_NAME to prevent injection (alphanumeric, hyphens, underscores, spaces only)
+if [[ ! "$AGENT_NAME" =~ ^[a-zA-Z0-9_\ -]+$ ]]; then
+  echo "❌ Invalid agent name format: $AGENT_NAME" >&2
+  exit 1
+fi
+
+# SECURITY: Encode text and agent name as base64 to prevent command injection
+# The receiver will decode these safely
+# Probe for GNU base64 (-w 0), fall back to BSD (-b 0), then tr
+if printf '' | base64 -w 0 >/dev/null 2>&1; then
+  ENCODED_TEXT=$(printf '%s' "$TEXT" | base64 -w 0)
+  ENCODED_AGENT=$(printf '%s' "$AGENT_NAME" | base64 -w 0)
+else
+  ENCODED_TEXT=$(printf '%s' "$TEXT" | base64 -b 0 2>/dev/null || printf '%s' "$TEXT" | base64 | tr -d '\n')
+  ENCODED_AGENT=$(printf '%s' "$AGENT_NAME" | base64 -b 0 2>/dev/null || printf '%s' "$AGENT_NAME" | base64 | tr -d '\n')
+fi
+
+# Send text to remote for local AgentVibes playback
+echo "📱 Sending to $SSH_HOST for local playback..." >&2
+
+# Try receiver scripts in order — single SSH call, no separate probe
+# SECURITY: Base64-encoded values are safe to pass as arguments (no shell metacharacters)
+ssh "$SSH_HOST" "
+  if [ -f ~/.agentvibes/play-remote.sh ]; then
+    bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
+  elif [ -f ~/.termux/agentvibes-play.sh ]; then
+    bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
+  else
+    echo 'Error: Receiver script not found' >&2
+    exit 1
+  fi
+" &
+SSH_PID=$!
+
+echo "Sent to $SSH_HOST (PID: $SSH_PID)" >&2
+exit 0

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

@@ -1,105 +1,105 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/play-tts-enhanced.sh
-#
-# AgentVibes - Enhanced TTS with Background Music and Effects
-# Generates TTS, applies effects, mixes background, plays ONCE (no echo)
-#
-# Usage: play-tts-enhanced.sh "text to speak" [agent_name] [voice_override]
-#
-# Environment:
-#   AGENTVIBES_PARTY_MODE=true  - Use room ambiance background (_party_mode config)
-#
-
-set -euo pipefail
-export LC_ALL=C
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-TEXT="${1:-}"
-AGENT_NAME="${2:-default}"
-VOICE_OVERRIDE="${3:-}"
-
-if [[ -z "$TEXT" ]]; then
-    echo "Usage: $0 \"text to speak\" [agent_name] [voice_override]" >&2
-    exit 1
-fi
-
-# Determine which config to use
-CONFIG_KEY="$AGENT_NAME"
-if [[ "${AGENTVIBES_PARTY_MODE:-false}" == "true" ]]; then
-    CONFIG_KEY="_party_mode"
-fi
-
-# ---------------------------------------------------------------------------
-# Per-agent profile overrides (from bmad-voice-map.json via bmad-speak.sh)
-# If AGENTVIBES_AGENT_PROFILE is set and the file exists, apply reverb/personality/music
-# overrides by temporarily setting effects-manager config for this agent
-AGENT_PROFILE="${AGENTVIBES_AGENT_PROFILE:-}"
-
-if [[ -n "$AGENT_PROFILE" ]] && [[ -f "$AGENT_PROFILE" ]]; then
-    # Read profile fields using node (reliable JSON parsing)
-    # SECURITY: Pass values via env vars to prevent shell injection
-    _PROFILE_REVERB=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(p.reverbPreset||'')}catch{}" 2>/dev/null || true)
-    _PROFILE_MUSIC_TRACK=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(p.backgroundMusic?.track||'')}catch{}" 2>/dev/null || true)
-    _PROFILE_MUSIC_VOL=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(String(p.backgroundMusic?.volume||''))}catch{}" 2>/dev/null || true)
-
-    # Apply per-agent reverb via effects-manager (scoped to this agent's config key)
-    if [[ -n "$_PROFILE_REVERB" ]] && [[ -f "$SCRIPT_DIR/effects-manager.sh" ]]; then
-        bash "$SCRIPT_DIR/effects-manager.sh" set-reverb "$_PROFILE_REVERB" "$CONFIG_KEY" 2>/dev/null || true
-    fi
-
-    # Override background music track/volume for this invocation via env vars
-    if [[ -n "$_PROFILE_MUSIC_TRACK" ]]; then
-        export AGENTVIBES_BG_TRACK="$_PROFILE_MUSIC_TRACK"
-    fi
-    if [[ -n "$_PROFILE_MUSIC_VOL" ]]; then
-        export AGENTVIBES_BG_VOLUME="$_PROFILE_MUSIC_VOL"
-    fi
-fi
-
-# Step 1: Generate TTS WITHOUT playback
-export AGENTVIBES_NO_PLAYBACK=true
-export AGENTVIBES_WAV_OUTPATH="${XDG_RUNTIME_DIR:-/tmp}/agentvibes-last-wav-$$.txt"
-
-# Cleanup temp outpath file on exit
-trap 'rm -f "$AGENTVIBES_WAV_OUTPATH"' EXIT
-"$SCRIPT_DIR/play-tts.sh" "$TEXT" "$VOICE_OVERRIDE"
-
-# Read the generated file path (written by play-tts-piper.sh via AGENTVIBES_WAV_OUTPATH)
-GENERATED_FILE=""
-if [[ -f "$AGENTVIBES_WAV_OUTPATH" ]]; then
-    GENERATED_FILE=$(cat "$AGENTVIBES_WAV_OUTPATH")
-    rm -f "$AGENTVIBES_WAV_OUTPATH"
-fi
-unset AGENTVIBES_WAV_OUTPATH
-
-if [[ -z "$GENERATED_FILE" ]] || [[ ! -f "$GENERATED_FILE" ]]; then
-    echo "Error: Could not find generated audio file" >&2
-    exit 1
-fi
-
-# Step 2: Process with effects and background
-PROCESSED_FILE="${GENERATED_FILE%.wav}-enhanced.wav"
-
-if [[ -f "$SCRIPT_DIR/audio-processor.sh" ]]; then
-    "$SCRIPT_DIR/audio-processor.sh" "$GENERATED_FILE" "$CONFIG_KEY" "$PROCESSED_FILE" 2>/dev/null || {
-        # Fallback to original if processing fails
-        PROCESSED_FILE="$GENERATED_FILE"
-    }
-else
-    PROCESSED_FILE="$GENERATED_FILE"
-fi
-
-# Step 3: Play the processed audio ONCE
-if [[ -f "$PROCESSED_FILE" ]]; then
-    if [[ "$(uname -s)" == "Darwin" ]]; then
-        afplay "$PROCESSED_FILE" >/dev/null 2>&1 &
-    else
-        (mpv "$PROCESSED_FILE" || aplay "$PROCESSED_FILE" || paplay "$PROCESSED_FILE") >/dev/null 2>&1 &
-    fi
-    echo "🎵 Enhanced audio: $PROCESSED_FILE"
-else
-    echo "Error: Processed file not found" >&2
-    exit 1
-fi
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/play-tts-enhanced.sh
+#
+# AgentVibes - Enhanced TTS with Background Music and Effects
+# Generates TTS, applies effects, mixes background, plays ONCE (no echo)
+#
+# Usage: play-tts-enhanced.sh "text to speak" [agent_name] [voice_override]
+#
+# Environment:
+#   AGENTVIBES_PARTY_MODE=true  - Use room ambiance background (_party_mode config)
+#
+
+set -euo pipefail
+export LC_ALL=C
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+TEXT="${1:-}"
+AGENT_NAME="${2:-default}"
+VOICE_OVERRIDE="${3:-}"
+
+if [[ -z "$TEXT" ]]; then
+    echo "Usage: $0 \"text to speak\" [agent_name] [voice_override]" >&2
+    exit 1
+fi
+
+# Determine which config to use
+CONFIG_KEY="$AGENT_NAME"
+if [[ "${AGENTVIBES_PARTY_MODE:-false}" == "true" ]]; then
+    CONFIG_KEY="_party_mode"
+fi
+
+# ---------------------------------------------------------------------------
+# Per-agent profile overrides (from bmad-voice-map.json via bmad-speak.sh)
+# If AGENTVIBES_AGENT_PROFILE is set and the file exists, apply reverb/personality/music
+# overrides by temporarily setting effects-manager config for this agent
+AGENT_PROFILE="${AGENTVIBES_AGENT_PROFILE:-}"
+
+if [[ -n "$AGENT_PROFILE" ]] && [[ -f "$AGENT_PROFILE" ]]; then
+    # Read profile fields using node (reliable JSON parsing)
+    # SECURITY: Pass values via env vars to prevent shell injection
+    _PROFILE_REVERB=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(p.reverbPreset||'')}catch{}" 2>/dev/null || true)
+    _PROFILE_MUSIC_TRACK=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(p.backgroundMusic?.track||'')}catch{}" 2>/dev/null || true)
+    _PROFILE_MUSIC_VOL=$(_APFILE="$AGENT_PROFILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._APFILE,'utf8'));process.stdout.write(String(p.backgroundMusic?.volume||''))}catch{}" 2>/dev/null || true)
+
+    # Apply per-agent reverb via effects-manager (scoped to this agent's config key)
+    if [[ -n "$_PROFILE_REVERB" ]] && [[ -f "$SCRIPT_DIR/effects-manager.sh" ]]; then
+        bash "$SCRIPT_DIR/effects-manager.sh" set-reverb "$_PROFILE_REVERB" "$CONFIG_KEY" 2>/dev/null || true
+    fi
+
+    # Override background music track/volume for this invocation via env vars
+    if [[ -n "$_PROFILE_MUSIC_TRACK" ]]; then
+        export AGENTVIBES_BG_TRACK="$_PROFILE_MUSIC_TRACK"
+    fi
+    if [[ -n "$_PROFILE_MUSIC_VOL" ]]; then
+        export AGENTVIBES_BG_VOLUME="$_PROFILE_MUSIC_VOL"
+    fi
+fi
+
+# Step 1: Generate TTS WITHOUT playback
+export AGENTVIBES_NO_PLAYBACK=true
+export AGENTVIBES_WAV_OUTPATH="${XDG_RUNTIME_DIR:-/tmp}/agentvibes-last-wav-$$.txt"
+
+# Cleanup temp outpath file on exit
+trap 'rm -f "$AGENTVIBES_WAV_OUTPATH"' EXIT
+bash "$SCRIPT_DIR/play-tts.sh" "$TEXT" "$VOICE_OVERRIDE"
+
+# Read the generated file path (written by play-tts-piper.sh via AGENTVIBES_WAV_OUTPATH)
+GENERATED_FILE=""
+if [[ -f "$AGENTVIBES_WAV_OUTPATH" ]]; then
+    GENERATED_FILE=$(cat "$AGENTVIBES_WAV_OUTPATH")
+    rm -f "$AGENTVIBES_WAV_OUTPATH"
+fi
+unset AGENTVIBES_WAV_OUTPATH
+
+if [[ -z "$GENERATED_FILE" ]] || [[ ! -f "$GENERATED_FILE" ]]; then
+    echo "Error: Could not find generated audio file" >&2
+    exit 1
+fi
+
+# Step 2: Process with effects and background
+PROCESSED_FILE="${GENERATED_FILE%.wav}-enhanced.wav"
+
+if [[ -f "$SCRIPT_DIR/audio-processor.sh" ]]; then
+    "$SCRIPT_DIR/audio-processor.sh" "$GENERATED_FILE" "$CONFIG_KEY" "$PROCESSED_FILE" 2>/dev/null || {
+        # Fallback to original if processing fails
+        PROCESSED_FILE="$GENERATED_FILE"
+    }
+else
+    PROCESSED_FILE="$GENERATED_FILE"
+fi
+
+# Step 3: Play the processed audio ONCE
+if [[ -f "$PROCESSED_FILE" ]]; then
+    if [[ "$(uname -s)" == "Darwin" ]]; then
+        afplay "$PROCESSED_FILE" >/dev/null 2>&1 &
+    else
+        (mpv "$PROCESSED_FILE" || aplay "$PROCESSED_FILE" || paplay "$PROCESSED_FILE") >/dev/null 2>&1 &
+    fi
+    echo "🎵 Enhanced audio: $PROCESSED_FILE"
+else
+    echo "Error: Processed file not found" >&2
+    exit 1
+fi

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

@@ -232,18 +232,29 @@ if [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]] && ! verify_voice "$VOICE_MO
   echo "   File size: ~25MB"
   echo "   Preview: https://huggingface.co/rhasspy/piper-voices"
   echo ""
-  read -p "   Download this voice model? [y/N]: " -n 1 -r
-  echo
 
-  if [[ $REPLY =~ ^[Yy]$ ]]; then
+  # Auto-download when non-interactive (e.g. called from a hook)
+  if [[ ! -t 0 ]]; then
+    echo "   Auto-downloading (non-interactive mode)..."
     if ! download_voice "$VOICE_MODEL"; then
       echo "❌ Failed to download voice model"
       echo "Fix: Download manually or choose different voice"
       exit 3
     fi
   else
-    echo "❌ Voice download cancelled"
-    exit 3
+    read -p "   Download this voice model? [y/N]: " -n 1 -r
+    echo
+
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+      if ! download_voice "$VOICE_MODEL"; then
+        echo "❌ Failed to download voice model"
+        echo "Fix: Download manually or choose different voice"
+        exit 3
+      fi
+    else
+      echo "❌ Voice download cancelled"
+      exit 3
+    fi
   fi
 fi