agentvibes 5.2.0 → 5.3.0

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

@@ -14,13 +14,63 @@
 
 set -euo pipefail
 
-TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
-AGENT_NAME="${3:-default}"
+# ---------------------------------------------------------------------------
+# Argument parsing — supports both positional (backward compat) and flags.
+#
+# Positional (legacy):
+#   play-tts-ssh-remote.sh "text" [voice] [agent_name]
+#
+# Flag-based (full per-call control):
+#   play-tts-ssh-remote.sh --text "hello" --voice "en_US-ryan-high" \
+#                          --pretext "Winston here" --music "track.mp3" \
+#                          --volume 0.25 --effects "reverb 40 60 80" \
+#                          --speed 1.1 --provider piper --agent "winston"
+#
+# Flags override config-file values.  Any flag omitted → falls back to config.
+# --pretext "" (empty string) explicitly suppresses pretext (no fallback).
+# ---------------------------------------------------------------------------
+
+TEXT=""
+VOICE=""
+AGENT_NAME=""
+PRETEXT_OVERRIDE=""
+PRETEXT_SET=0           # whether --pretext was explicitly provided
+MUSIC_OVERRIDE=""
+VOLUME_OVERRIDE=""
+EFFECTS_OVERRIDE=""
+SPEED_OVERRIDE=""
+PROVIDER_OVERRIDE=""
+
+# Detect flag-based vs positional usage: if first arg starts with --, use flags.
+if [[ "${1:-}" == --* ]]; then
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --text)     TEXT="${2:-}"; shift 2 ;;
+      --voice)    VOICE="${2:-}"; shift 2 ;;
+      --agent)    AGENT_NAME="${2:-}"; shift 2 ;;
+      --pretext)  PRETEXT_OVERRIDE="${2:-}"; PRETEXT_SET=1; shift 2 ;;
+      --music)    MUSIC_OVERRIDE="${2:-}"; shift 2 ;;
+      --volume)   VOLUME_OVERRIDE="${2:-}"; shift 2 ;;
+      --effects)  EFFECTS_OVERRIDE="${2:-}"; shift 2 ;;
+      --speed)    SPEED_OVERRIDE="${2:-}"; shift 2 ;;
+      --provider) PROVIDER_OVERRIDE="${2:-}"; shift 2 ;;
+      *)          echo "Unknown flag: $1" >&2; exit 1 ;;
+    esac
+  done
+else
+  TEXT="${1:-}"
+  VOICE="${2:-}"
+  AGENT_NAME="${3:-}"
+fi
+
+# Defaults for still-empty values
+VOICE="${VOICE:-en_US-lessac-medium}"
+AGENT_NAME="${AGENT_NAME:-default}"
 
 # Validate required input
 if [[ -z "$TEXT" ]]; then
-  echo "Usage: $0 <text> [voice] [agent_name]" >&2
+  echo "Usage (positional): $0 <text> [voice] [agent_name]" >&2
+  echo "Usage (flags):      $0 --text <text> [--voice X --pretext Y --music Z --volume N --effects E --speed S --provider P --agent A]" >&2
   exit 1
 fi
 
@@ -115,6 +165,49 @@ case "${PROVIDER:-}" in
   *) PROVIDER="piper" ;;
 esac
 
+# ---------------------------------------------------------------------------
+# Apply CLI flag overrides (flags win over config files)
+# ---------------------------------------------------------------------------
+# Validate effects (prevent injection — only alphanumeric, spaces, dots, hyphens)
+if [[ -n "$EFFECTS_OVERRIDE" ]]; then
+  if [[ "$EFFECTS_OVERRIDE" =~ ^[a-zA-Z0-9\ ._-]+$ ]]; then
+    SOX_EFFECTS="$EFFECTS_OVERRIDE"
+  else
+    echo "Invalid effects format: $EFFECTS_OVERRIDE (alphanumeric/space/.-_ only)" >&2
+    exit 1
+  fi
+fi
+[[ -n "$MUSIC_OVERRIDE"    ]] && BG_FILE="$MUSIC_OVERRIDE"
+[[ -n "$VOLUME_OVERRIDE"   ]] && BG_VOLUME="$VOLUME_OVERRIDE"
+[[ -n "$SPEED_OVERRIDE"    ]] && SPEED="$SPEED_OVERRIDE"
+[[ -n "$PROVIDER_OVERRIDE" ]] && PROVIDER="$PROVIDER_OVERRIDE"
+# Pretext: explicit --pretext wins even when empty string (suppresses pretext)
+if [[ "$PRETEXT_SET" == "1" ]]; then
+  PRETEXT="$PRETEXT_OVERRIDE"
+fi
+
+# Re-validate provider after override (in case user passed bad value)
+case "${PROVIDER:-}" in
+  piper|soprano|macos|windows-sapi) ;;
+  *) PROVIDER="piper" ;;
+esac
+# Validate music filename (prevent path injection through JSON → receiver)
+# Allows spaces in track names like "Late Night Hip Hop Groove.mp3"
+if [[ -n "$BG_FILE" && ! "$BG_FILE" =~ ^[a-zA-Z0-9_\.\ -]+$ ]]; then
+  echo "Invalid music filename format: $BG_FILE (alphanumeric/space/.-_ only)" >&2
+  exit 1
+fi
+# Validate volume
+if [[ -n "$BG_VOLUME" && ! "$BG_VOLUME" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
+  echo "Invalid volume: $BG_VOLUME (numeric only)" >&2
+  exit 1
+fi
+# Validate speed
+if [[ -n "$SPEED" && ! "$SPEED" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
+  echo "Invalid speed: $SPEED (numeric only)" >&2
+  exit 1
+fi
+
 # ---------------------------------------------------------------------------
 # Build JSON payload
 # ---------------------------------------------------------------------------
@@ -134,13 +227,14 @@ build_json_payload() {
       --arg provider "$PROVIDER" \
       '{text: $text, voice: $voice, effects: $effects, music: $music, volume: $volume, project: $project, pretext: $pretext, speed: $speed, provider: $provider}'
   else
-    # Manual JSON — escape double quotes and backslashes in text
-    local escaped_text
-    escaped_text=$(printf '%s' "$TEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g')
-    local escaped_pretext
-    escaped_pretext=$(printf '%s' "$PRETEXT" | sed 's/\\/\\\\/g; s/"/\\"/g')
+    # Manual JSON — escape all interpolated fields (backslash, double-quote, newline, tab)
+    _esc() { printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g' | tr '\n' ' '; }
+    local e_text e_voice e_effects e_music e_vol e_proj e_pre e_spd e_prov
+    e_text=$(_esc "$TEXT"); e_voice=$(_esc "$VOICE"); e_effects=$(_esc "$SOX_EFFECTS")
+    e_music=$(_esc "$BG_FILE"); e_vol=$(_esc "$BG_VOLUME"); e_proj=$(_esc "$PROJECT_NAME")
+    e_pre=$(_esc "$PRETEXT"); e_spd=$(_esc "$SPEED"); e_prov=$(_esc "$PROVIDER")
     printf '{"text":"%s","voice":"%s","effects":"%s","music":"%s","volume":"%s","project":"%s","pretext":"%s","speed":"%s","provider":"%s"}' \
-      "$escaped_text" "$VOICE" "$SOX_EFFECTS" "$BG_FILE" "$BG_VOLUME" "$PROJECT_NAME" "$escaped_pretext" "$SPEED" "$PROVIDER"
+      "$e_text" "$e_voice" "$e_effects" "$e_music" "$e_vol" "$e_proj" "$e_pre" "$e_spd" "$e_prov"
   fi
 }
 

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

@@ -1,169 +1,169 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/play-tts-termux-ssh.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 Termux SSH TTS Provider - Android TTS via SSH tunnel
-# @context Enables TTS output on Android devices when connected via SSH from Termux
-# @architecture SSH-based remote TTS invocation using termux-tts-speak on Android
-# @dependencies ssh, termux-tts-speak (on Android), termux-api (on Android)
-# @entrypoints Called by play-tts.sh router when provider=termux-ssh
-# @patterns Remote TTS invocation, SSH host alias configuration, graceful fallback
-# @related play-tts.sh, provider-manager.sh
-# @setup Requires user to configure SSH host alias in ~/.ssh/config
-#
-# SETUP INSTRUCTIONS:
-# ===================
-# 1. On Android device (Termux):
-#    - Install: pkg install termux-api openssh
-#    - Install Termux:API app from F-Droid
-#    - Start SSH server: sshd
-#    - Get SSH port: echo $PREFIX/var/run/sshd.pid
-#
-# 2. On server/desktop:
-#    - Add to ~/.ssh/config:
-#      Host android
-#          HostName <your-android-ip>
-#          User <your-termux-username>
-#          Port 8022
-#          IdentityFile ~/.ssh/id_rsa
-#
-# 3. Configure AgentVibes:
-#    - echo "android" > ~/.claude/termux-ssh-host.txt
-#    OR
-#    - export TERMUX_SSH_HOST="android"
-#
-# 4. Set provider:
-#    - echo "termux-ssh" > ~/.claude/tts-provider.txt
-#
-
-# Fix locale warnings
-export LC_ALL=C
-
-TEXT="$1"
-VOICE_OVERRIDE="$2"  # Not used for termux-ssh, but kept for interface compatibility
-
-# Script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# @function get_ssh_host
-# @intent Determine SSH host alias for Android device
-# @why Allows users to configure their own SSH connection without hardcoded values
-# @returns Echoes SSH host alias or empty string if not configured
-# @sideeffects None
-get_ssh_host() {
-  local ssh_host=""
-
-  # Priority order:
-  # 1. Environment variable TERMUX_SSH_HOST
-  # 2. Project-specific config file (CLAUDE_PROJECT_DIR)
-  # 3. Script location config file
-  # 4. Global config file (~/.claude/termux-ssh-host.txt)
-
-  if [[ -n "$TERMUX_SSH_HOST" ]]; then
-    ssh_host="$TERMUX_SSH_HOST"
-  elif [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/termux-ssh-host.txt" ]]; then
-    ssh_host=$(cat "$CLAUDE_PROJECT_DIR/.claude/termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
-  elif [[ -f "$SCRIPT_DIR/../termux-ssh-host.txt" ]]; then
-    ssh_host=$(cat "$SCRIPT_DIR/../termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
-  elif [[ -f "$HOME/.claude/termux-ssh-host.txt" ]]; then
-    ssh_host=$(cat "$HOME/.claude/termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
-  fi
-
-  echo "$ssh_host"
-}
-
-# @function check_termux_connection
-# @intent Verify SSH connection to Android device is available
-# @why Prevent hanging on SSH timeout if device is unreachable
-# @param $1 SSH host alias
-# @returns 0 if connection successful, 1 otherwise
-# @sideeffects None (uses ConnectTimeout=2)
-check_termux_connection() {
-  local host="$1"
-
-  # Quick connection test (2 second timeout)
-  if ssh -o ConnectTimeout=2 -o BatchMode=yes "$host" "echo ok" >/dev/null 2>&1; then
-    return 0
-  else
-    return 1
-  fi
-}
-
-# Main execution
-SSH_HOST=$(get_ssh_host)
-
-if [[ -z "$SSH_HOST" ]]; then
-  echo "❌ Termux SSH provider not configured" >&2
-  echo "   Set SSH host alias in one of:" >&2
-  echo "   - Environment: export TERMUX_SSH_HOST='android'" >&2
-  echo "   - Global: echo 'android' > ~/.claude/termux-ssh-host.txt" >&2
-  echo "   - Project: echo 'android' > .claude/termux-ssh-host.txt" >&2
-  echo "" >&2
-  echo "   See provider documentation for SSH setup instructions" >&2
-  exit 1
-fi
-
-if [[ -z "$TEXT" ]]; then
-  echo "❌ No text provided for TTS" >&2
-  exit 1
-fi
-
-# Check if SSH connection is available (with timeout)
-if ! check_termux_connection "$SSH_HOST"; then
-  echo "⚠️  Cannot connect to SSH host '$SSH_HOST'" >&2
-  echo "   Make sure:" >&2
-  echo "   - Android device is reachable" >&2
-  echo "   - SSH server is running: sshd" >&2
-  echo "   - SSH config is correct in ~/.ssh/config" >&2
-  exit 1
-fi
-
-# Escape single quotes in text for safe shell transmission
-# Replace ' with '\'' (end quote, escaped quote, start quote)
-SAFE_TEXT="${TEXT//\'/\'\\\'\'}"
-
-# Send TTS command to Android device via SSH
-# Use termux-tts-speak for native Android TTS
-# Run in background to avoid blocking
-ssh -o ConnectTimeout=5 "$SSH_HOST" "termux-tts-speak '$SAFE_TEXT'" &
-
-# Get the background process PID
-SSH_PID=$!
-
-# Optional: Wait a moment to detect immediate failures
-sleep 0.2
-
-# Check if the SSH process is still running (indicates successful start)
-if kill -0 "$SSH_PID" 2>/dev/null; then
-  echo "✓ TTS sent to Android device via SSH" >&2
-else
-  echo "⚠️  SSH command may have failed" >&2
-fi
-
-# Note: We don't return an audio file path since audio plays on the Android device
-# This is by design - the provider outputs audio remotely, not locally
-echo ""
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/play-tts-termux-ssh.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 Termux SSH TTS Provider - Android TTS via SSH tunnel
+# @context Enables TTS output on Android devices when connected via SSH from Termux
+# @architecture SSH-based remote TTS invocation using termux-tts-speak on Android
+# @dependencies ssh, termux-tts-speak (on Android), termux-api (on Android)
+# @entrypoints Called by play-tts.sh router when provider=termux-ssh
+# @patterns Remote TTS invocation, SSH host alias configuration, graceful fallback
+# @related play-tts.sh, provider-manager.sh
+# @setup Requires user to configure SSH host alias in ~/.ssh/config
+#
+# SETUP INSTRUCTIONS:
+# ===================
+# 1. On Android device (Termux):
+#    - Install: pkg install termux-api openssh
+#    - Install Termux:API app from F-Droid
+#    - Start SSH server: sshd
+#    - Get SSH port: echo $PREFIX/var/run/sshd.pid
+#
+# 2. On server/desktop:
+#    - Add to ~/.ssh/config:
+#      Host android
+#          HostName <your-android-ip>
+#          User <your-termux-username>
+#          Port 8022
+#          IdentityFile ~/.ssh/id_rsa
+#
+# 3. Configure AgentVibes:
+#    - echo "android" > ~/.claude/termux-ssh-host.txt
+#    OR
+#    - export TERMUX_SSH_HOST="android"
+#
+# 4. Set provider:
+#    - echo "termux-ssh" > ~/.claude/tts-provider.txt
+#
+
+# Fix locale warnings
+export LC_ALL=C
+
+TEXT="$1"
+VOICE_OVERRIDE="$2"  # Not used for termux-ssh, but kept for interface compatibility
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# @function get_ssh_host
+# @intent Determine SSH host alias for Android device
+# @why Allows users to configure their own SSH connection without hardcoded values
+# @returns Echoes SSH host alias or empty string if not configured
+# @sideeffects None
+get_ssh_host() {
+  local ssh_host=""
+
+  # Priority order:
+  # 1. Environment variable TERMUX_SSH_HOST
+  # 2. Project-specific config file (CLAUDE_PROJECT_DIR)
+  # 3. Script location config file
+  # 4. Global config file (~/.claude/termux-ssh-host.txt)
+
+  if [[ -n "$TERMUX_SSH_HOST" ]]; then
+    ssh_host="$TERMUX_SSH_HOST"
+  elif [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/termux-ssh-host.txt" ]]; then
+    ssh_host=$(cat "$CLAUDE_PROJECT_DIR/.claude/termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
+  elif [[ -f "$SCRIPT_DIR/../termux-ssh-host.txt" ]]; then
+    ssh_host=$(cat "$SCRIPT_DIR/../termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
+  elif [[ -f "$HOME/.claude/termux-ssh-host.txt" ]]; then
+    ssh_host=$(cat "$HOME/.claude/termux-ssh-host.txt" 2>/dev/null | tr -d '\n\r')
+  fi
+
+  echo "$ssh_host"
+}
+
+# @function check_termux_connection
+# @intent Verify SSH connection to Android device is available
+# @why Prevent hanging on SSH timeout if device is unreachable
+# @param $1 SSH host alias
+# @returns 0 if connection successful, 1 otherwise
+# @sideeffects None (uses ConnectTimeout=2)
+check_termux_connection() {
+  local host="$1"
+
+  # Quick connection test (2 second timeout)
+  if ssh -o ConnectTimeout=2 -o BatchMode=yes "$host" "echo ok" >/dev/null 2>&1; then
+    return 0
+  else
+    return 1
+  fi
+}
+
+# Main execution
+SSH_HOST=$(get_ssh_host)
+
+if [[ -z "$SSH_HOST" ]]; then
+  echo "❌ Termux SSH provider not configured" >&2
+  echo "   Set SSH host alias in one of:" >&2
+  echo "   - Environment: export TERMUX_SSH_HOST='android'" >&2
+  echo "   - Global: echo 'android' > ~/.claude/termux-ssh-host.txt" >&2
+  echo "   - Project: echo 'android' > .claude/termux-ssh-host.txt" >&2
+  echo "" >&2
+  echo "   See provider documentation for SSH setup instructions" >&2
+  exit 1
+fi
+
+if [[ -z "$TEXT" ]]; then
+  echo "❌ No text provided for TTS" >&2
+  exit 1
+fi
+
+# Check if SSH connection is available (with timeout)
+if ! check_termux_connection "$SSH_HOST"; then
+  echo "⚠️  Cannot connect to SSH host '$SSH_HOST'" >&2
+  echo "   Make sure:" >&2
+  echo "   - Android device is reachable" >&2
+  echo "   - SSH server is running: sshd" >&2
+  echo "   - SSH config is correct in ~/.ssh/config" >&2
+  exit 1
+fi
+
+# Escape single quotes in text for safe shell transmission
+# Replace ' with '\'' (end quote, escaped quote, start quote)
+SAFE_TEXT="${TEXT//\'/\'\\\'\'}"
+
+# Send TTS command to Android device via SSH
+# Use termux-tts-speak for native Android TTS
+# Run in background to avoid blocking
+ssh -o ConnectTimeout=5 "$SSH_HOST" "termux-tts-speak '$SAFE_TEXT'" &
+
+# Get the background process PID
+SSH_PID=$!
+
+# Optional: Wait a moment to detect immediate failures
+sleep 0.2
+
+# Check if the SSH process is still running (indicates successful start)
+if kill -0 "$SSH_PID" 2>/dev/null; then
+  echo "✓ TTS sent to Android device via SSH" >&2
+else
+  echo "⚠️  SSH command may have failed" >&2
+fi
+
+# Note: We don't return an audio file path since audio plays on the Android device
+# This is by design - the provider outputs audio remotely, not locally
+echo ""

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

@@ -89,7 +89,7 @@ while [[ $# -gt 0 ]]; do
     --llm)
       LLM_PROVIDER="${2:-}"
       # Security: Validate LLM provider name (alphanumeric, hyphens, underscores only)
-      if [[ -n "$LLM_PROVIDER" ]] && [[ ! "$LLM_PROVIDER" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+      if [[ -n "$LLM_PROVIDER" ]] && [[ ! "$LLM_PROVIDER" =~ ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ ]]; then
         echo "Error: Invalid LLM provider name" >&2
         exit 1
       fi
@@ -200,12 +200,23 @@ fi
 # Source provider manager to get active provider
 source "$SCRIPT_DIR/provider-manager.sh"
 
-# Get active provider (LLM-specific engine overrides global)
-if [[ -n "$_LLM_ENGINE" ]]; then
-  ACTIVE_PROVIDER="$_LLM_ENGINE"
-else
-  ACTIVE_PROVIDER=$(get_active_provider)
-fi
+# Get active provider.
+# Per-LLM engine (from audio-effects.cfg `llm:<key>` row column 7) overrides
+# the global tts-provider.txt — UNLESS the global is a transport provider
+# (ssh-remote, agentvibes-receiver, termux-ssh).  Transport providers
+# forward TTS to a remote receiver which picks its OWN engine; overriding
+# them with a local engine like piper would synthesize on the wrong host.
+ACTIVE_PROVIDER=$(get_active_provider)
+case "$ACTIVE_PROVIDER" in
+  ssh-remote|agentvibes-receiver|termux-ssh)
+    # Transport — keep it.  The receiver's audio-effects.cfg picks the engine.
+    ;;
+  *)
+    if [[ -n "$_LLM_ENGINE" ]]; then
+      ACTIVE_PROVIDER="$_LLM_ENGINE"
+    fi
+    ;;
+esac
 
 # Show GitHub star reminder (once per day)
 bash "$SCRIPT_DIR/github-star-reminder.sh" 2>/dev/null || true
@@ -226,11 +237,20 @@ detect_voice_provider() {
 }
 
 # Override provider if voice indicates different provider (mixed-provider mode)
+# But never override transport providers (ssh-remote, agentvibes-receiver, termux-ssh)
+# — those are transport layers, not synth engines. The receiver picks its own engine.
 if [[ -n "$VOICE_OVERRIDE" ]]; then
-  DETECTED_PROVIDER=$(detect_voice_provider "$VOICE_OVERRIDE")
-  if [[ "$DETECTED_PROVIDER" != "$ACTIVE_PROVIDER" ]]; then
-    ACTIVE_PROVIDER="$DETECTED_PROVIDER"
-  fi
+  case "$ACTIVE_PROVIDER" in
+    ssh-remote|agentvibes-receiver|termux-ssh)
+      # Transport provider — don't override, voice info is forwarded to receiver
+      ;;
+    *)
+      DETECTED_PROVIDER=$(detect_voice_provider "$VOICE_OVERRIDE")
+      if [[ "$DETECTED_PROVIDER" != "$ACTIVE_PROVIDER" ]]; then
+        ACTIVE_PROVIDER="$DETECTED_PROVIDER"
+      fi
+      ;;
+  esac
 fi
 
 # @function speak_text

package/.claude/hooks/prepare-release.sh

@@ -1,54 +1,54 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/prepare-release.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 Release preparation helper script with AI-generated notes
-# @context Placeholder script intended to be replaced by Claude AI for generating release notes
-# @architecture Simple informational script - actual logic delegated to Claude AI
-# @dependencies None (informational only)
-# @entrypoints Called manually or via CLI for release preparation
-# @patterns Fail-fast messaging, user guidance
-# @related RELEASE_NOTES.md, package.json version bumping
-
-BUMP_TYPE="${1:-patch}"
-
-echo "🤖 Preparing release with AI-generated summary..."
-echo ""
-echo "This command tells Claude AI to:"
-echo "1. Analyze changes since last release"
-echo "2. Generate intelligent summary"
-echo "3. Create RELEASE_NOTES.md"
-echo "4. Bump version to $BUMP_TYPE"
-echo "5. Commit everything"
-echo ""
-echo "⚠️  This is handled by Claude AI, not this script"
-echo "Please ask Claude to prepare the release instead"
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/prepare-release.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 Release preparation helper script with AI-generated notes
+# @context Placeholder script intended to be replaced by Claude AI for generating release notes
+# @architecture Simple informational script - actual logic delegated to Claude AI
+# @dependencies None (informational only)
+# @entrypoints Called manually or via CLI for release preparation
+# @patterns Fail-fast messaging, user guidance
+# @related RELEASE_NOTES.md, package.json version bumping
+
+BUMP_TYPE="${1:-patch}"
+
+echo "🤖 Preparing release with AI-generated summary..."
+echo ""
+echo "This command tells Claude AI to:"
+echo "1. Analyze changes since last release"
+echo "2. Generate intelligent summary"
+echo "3. Create RELEASE_NOTES.md"
+echo "4. Bump version to $BUMP_TYPE"
+echo "5. Commit everything"
+echo ""
+echo "⚠️  This is handled by Claude AI, not this script"
+echo "Please ask Claude to prepare the release instead"