agentvibes 4.2.0 → 4.4.0

package/.claude/hooks/piper-multispeaker-registry.sh

@@ -1,171 +1,171 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/piper-multispeaker-registry.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 Multi-Speaker Voice Registry - Maps speaker names to ONNX models and speaker IDs
-# @context Enables individual speaker selection from multi-speaker Piper models (e.g., 16Speakers)
-# @architecture Static registry mapping speaker names to model files and numeric speaker IDs
-# @dependencies piper-voice-manager.sh (voice storage), play-tts-piper.sh (TTS with speaker ID)
-# @entrypoints Sourced by voice-manager.sh for multi-speaker voice switching
-# @patterns Registry pattern, speaker ID mapping, model-to-speaker association
-# @related voice-manager.sh, play-tts-piper.sh, 16Speakers.onnx.json (speaker_id_map)
-#
-
-# Bash 3.2 compatible lowercase function (macOS ships with bash 3.2)
-# ${var,,} syntax requires bash 4.0+
-_to_lower() {
-  echo "$1" | tr '[:upper:]' '[:lower:]'
-}
-
-# Registry of multi-speaker models and their speaker names
-# Format: "SpeakerName:model_file:speaker_id:description"
-#
-# 16Speakers Model (12 US + 4 UK voices):
-# Source: LibriVox Public Domain recordings
-# Model: 16Speakers.onnx (77MB)
-#
-MULTISPEAKER_VOICES=(
-  # US English Speakers (0-11)
-  "Cori_Samuel:16Speakers:0:US English Female"
-  "Kara_Shallenberg:16Speakers:1:US English Female"
-  "Kristin_Hughes:16Speakers:2:US English Female"
-  "Maria_Kasper:16Speakers:3:US English Female"
-  "Mike_Pelton:16Speakers:4:US English Male"
-  "Mark_Nelson:16Speakers:5:US English Male"
-  "Michael_Scherer:16Speakers:6:US English Male"
-  "James_K_White:16Speakers:7:US English Male"
-  "Rose_Ibex:16Speakers:8:US English Female"
-  "progressingamerica:16Speakers:9:US English Male"
-  "Steve_C:16Speakers:10:US English Male"
-  "Owlivia:16Speakers:11:US English Female"
-
-  # UK English Speakers (12-15)
-  "Paul_Hampton:16Speakers:12:UK English Male"
-  "Jennifer_Dorr:16Speakers:13:UK English Female"
-  "Emily_Cripps:16Speakers:14:UK English Female"
-  "Martin_Clifton:16Speakers:15:UK English Male"
-)
-
-# @function get_multispeaker_info
-# @intent Get model and speaker ID for a speaker name
-# @why Enables users to select individual speakers from multi-speaker models by name
-# @param $1 {string} speaker_name - Speaker name (e.g., "Cori_Samuel", "Rose_Ibex")
-# @returns Echoes "model:speaker_id" (e.g., "16Speakers:0") to stdout
-# @exitcode 0=speaker found, 1=speaker not found
-# @sideeffects None (read-only lookup)
-# @edgecases Case-insensitive matching
-# @calledby voice-manager.sh switch command
-# @calls None (pure bash array iteration)
-get_multispeaker_info() {
-  local speaker_name="$1"
-  for entry in "${MULTISPEAKER_VOICES[@]}"; do
-    name="${entry%%:*}"
-    rest="${entry#*:}"
-    model="${rest%%:*}"
-    rest="${rest#*:}"
-    speaker_id="${rest%%:*}"
-
-    if [[ "$(_to_lower "$name")" == "$(_to_lower "$speaker_name")" ]]; then
-      echo "$model:$speaker_id"
-      return 0
-    fi
-  done
-  return 1
-}
-
-# @function list_multispeaker_voices
-# @intent Display all available multi-speaker voices with descriptions
-# @why Help users discover individual speakers within multi-speaker models
-# @param None
-# @returns None
-# @exitcode Always 0
-# @sideeffects Writes formatted list to stdout
-# @edgecases None
-# @calledby voice-manager.sh list command, /agent-vibes:list
-# @calls None (pure bash array iteration)
-list_multispeaker_voices() {
-  echo "🎭 Multi-Speaker Voices (16Speakers Model):"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-  local current_model=""
-  for entry in "${MULTISPEAKER_VOICES[@]}"; do
-    name="${entry%%:*}"
-    rest="${entry#*:}"
-    model="${rest%%:*}"
-    rest="${rest#*:}"
-    speaker_id="${rest%%:*}"
-    description="${rest#*:}"
-
-    # Print section header when model changes
-    if [[ "$model" != "$current_model" ]]; then
-      if [[ -n "$current_model" ]]; then
-        echo ""
-      fi
-      echo "  Model: $model.onnx"
-      current_model="$model"
-    fi
-
-    echo "    • $name (ID: $speaker_id) - $description"
-  done
-
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-  echo "Usage: /agent-vibes:switch Cori_Samuel"
-  echo "       /agent-vibes:switch Rose_Ibex"
-}
-
-# @function get_multispeaker_description
-# @intent Get description for a speaker name
-# @why Provide user-friendly info about speaker characteristics
-# @param $1 {string} speaker_name - Speaker name
-# @returns Echoes description (e.g., "US English Female") to stdout
-# @exitcode 0=speaker found, 1=speaker not found
-# @sideeffects None (read-only lookup)
-# @edgecases Case-insensitive matching
-# @calledby voice-manager.sh switch command (for confirmation message)
-# @calls None (pure bash array iteration)
-get_multispeaker_description() {
-  local speaker_name="$1"
-  for entry in "${MULTISPEAKER_VOICES[@]}"; do
-    name="${entry%%:*}"
-    rest="${entry#*:}"
-    rest="${rest#*:}"
-    rest="${rest#*:}"
-    description="${rest}"
-
-    if [[ "$(_to_lower "$name")" == "$(_to_lower "$speaker_name")" ]]; then
-      echo "$description"
-      return 0
-    fi
-  done
-  return 1
-}
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/piper-multispeaker-registry.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 Multi-Speaker Voice Registry - Maps speaker names to ONNX models and speaker IDs
+# @context Enables individual speaker selection from multi-speaker Piper models (e.g., 16Speakers)
+# @architecture Static registry mapping speaker names to model files and numeric speaker IDs
+# @dependencies piper-voice-manager.sh (voice storage), play-tts-piper.sh (TTS with speaker ID)
+# @entrypoints Sourced by voice-manager.sh for multi-speaker voice switching
+# @patterns Registry pattern, speaker ID mapping, model-to-speaker association
+# @related voice-manager.sh, play-tts-piper.sh, 16Speakers.onnx.json (speaker_id_map)
+#
+
+# Bash 3.2 compatible lowercase function (macOS ships with bash 3.2)
+# ${var,,} syntax requires bash 4.0+
+_to_lower() {
+  echo "$1" | tr '[:upper:]' '[:lower:]'
+}
+
+# Registry of multi-speaker models and their speaker names
+# Format: "SpeakerName:model_file:speaker_id:description"
+#
+# 16Speakers Model (12 US + 4 UK voices):
+# Source: LibriVox Public Domain recordings
+# Model: 16Speakers.onnx (77MB)
+#
+MULTISPEAKER_VOICES=(
+  # US English Speakers (0-11)
+  "Cori_Samuel:16Speakers:0:US English Female"
+  "Kara_Shallenberg:16Speakers:1:US English Female"
+  "Kristin_Hughes:16Speakers:2:US English Female"
+  "Maria_Kasper:16Speakers:3:US English Female"
+  "Mike_Pelton:16Speakers:4:US English Male"
+  "Mark_Nelson:16Speakers:5:US English Male"
+  "Michael_Scherer:16Speakers:6:US English Male"
+  "James_K_White:16Speakers:7:US English Male"
+  "Rose_Ibex:16Speakers:8:US English Female"
+  "progressingamerica:16Speakers:9:US English Male"
+  "Steve_C:16Speakers:10:US English Male"
+  "Owlivia:16Speakers:11:US English Female"
+
+  # UK English Speakers (12-15)
+  "Paul_Hampton:16Speakers:12:UK English Male"
+  "Jennifer_Dorr:16Speakers:13:UK English Female"
+  "Emily_Cripps:16Speakers:14:UK English Female"
+  "Martin_Clifton:16Speakers:15:UK English Male"
+)
+
+# @function get_multispeaker_info
+# @intent Get model and speaker ID for a speaker name
+# @why Enables users to select individual speakers from multi-speaker models by name
+# @param $1 {string} speaker_name - Speaker name (e.g., "Cori_Samuel", "Rose_Ibex")
+# @returns Echoes "model:speaker_id" (e.g., "16Speakers:0") to stdout
+# @exitcode 0=speaker found, 1=speaker not found
+# @sideeffects None (read-only lookup)
+# @edgecases Case-insensitive matching
+# @calledby voice-manager.sh switch command
+# @calls None (pure bash array iteration)
+get_multispeaker_info() {
+  local speaker_name="$1"
+  for entry in "${MULTISPEAKER_VOICES[@]}"; do
+    name="${entry%%:*}"
+    rest="${entry#*:}"
+    model="${rest%%:*}"
+    rest="${rest#*:}"
+    speaker_id="${rest%%:*}"
+
+    if [[ "$(_to_lower "$name")" == "$(_to_lower "$speaker_name")" ]]; then
+      echo "$model:$speaker_id"
+      return 0
+    fi
+  done
+  return 1
+}
+
+# @function list_multispeaker_voices
+# @intent Display all available multi-speaker voices with descriptions
+# @why Help users discover individual speakers within multi-speaker models
+# @param None
+# @returns None
+# @exitcode Always 0
+# @sideeffects Writes formatted list to stdout
+# @edgecases None
+# @calledby voice-manager.sh list command, /agent-vibes:list
+# @calls None (pure bash array iteration)
+list_multispeaker_voices() {
+  echo "🎭 Multi-Speaker Voices (16Speakers Model):"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+  local current_model=""
+  for entry in "${MULTISPEAKER_VOICES[@]}"; do
+    name="${entry%%:*}"
+    rest="${entry#*:}"
+    model="${rest%%:*}"
+    rest="${rest#*:}"
+    speaker_id="${rest%%:*}"
+    description="${rest#*:}"
+
+    # Print section header when model changes
+    if [[ "$model" != "$current_model" ]]; then
+      if [[ -n "$current_model" ]]; then
+        echo ""
+      fi
+      echo "  Model: $model.onnx"
+      current_model="$model"
+    fi
+
+    echo "    • $name (ID: $speaker_id) - $description"
+  done
+
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Usage: /agent-vibes:switch Cori_Samuel"
+  echo "       /agent-vibes:switch Rose_Ibex"
+}
+
+# @function get_multispeaker_description
+# @intent Get description for a speaker name
+# @why Provide user-friendly info about speaker characteristics
+# @param $1 {string} speaker_name - Speaker name
+# @returns Echoes description (e.g., "US English Female") to stdout
+# @exitcode 0=speaker found, 1=speaker not found
+# @sideeffects None (read-only lookup)
+# @edgecases Case-insensitive matching
+# @calledby voice-manager.sh switch command (for confirmation message)
+# @calls None (pure bash array iteration)
+get_multispeaker_description() {
+  local speaker_name="$1"
+  for entry in "${MULTISPEAKER_VOICES[@]}"; do
+    name="${entry%%:*}"
+    rest="${entry#*:}"
+    rest="${rest#*:}"
+    rest="${rest#*:}"
+    description="${rest}"
+
+    if [[ "$(_to_lower "$name")" == "$(_to_lower "$speaker_name")" ]]; then
+      echo "$description"
+      return 0
+    fi
+  done
+  return 1
+}

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

@@ -84,8 +84,10 @@ get_voice_storage_dir() {
       done
 
       # Check global config
-      if [[ -z "$config_file" ]] && [[ -f "$HOME/.claude/piper-voices-dir.txt" ]]; then
-        config_file="$HOME/.claude/piper-voices-dir.txt"
+      # Prefer $USERPROFILE on Windows where $HOME may be a MINGW-internal path
+      local _home="${USERPROFILE:-$HOME}"
+      if [[ -z "$config_file" ]] && [[ -f "$_home/.claude/piper-voices-dir.txt" ]]; then
+        config_file="$_home/.claude/piper-voices-dir.txt"
       fi
     fi
 
@@ -94,9 +96,22 @@ get_voice_storage_dir() {
     fi
   fi
 
+  # Validate the path is reachable — on Windows/MINGW, stale config files may
+  # contain bogus paths like /home/user that map to C:/Program Files/Git/home/
+  if [[ -n "$voice_dir" ]]; then
+    local parent_dir
+    parent_dir=$(dirname "$voice_dir")
+    if ! mkdir -p "$parent_dir" 2>/dev/null; then
+      voice_dir=""
+    fi
+  fi
+
   # Fallback to default global storage
+  # On Windows (MINGW/Git Bash), $HOME may resolve to a bogus Git-internal path;
+  # prefer $USERPROFILE which always points to the real Windows home directory.
   if [[ -z "$voice_dir" ]]; then
-    voice_dir="$HOME/.claude/piper-voices"
+    local home_dir="${USERPROFILE:-$HOME}"
+    voice_dir="$home_dir/.claude/piper-voices"
   fi
 
   mkdir -p "$voice_dir"
@@ -198,6 +213,12 @@ download_voice() {
   local voice_name="$1"
   local lang_code="${2:-}"
 
+  # Security: validate voice name to prevent path traversal
+  if [[ ! "$voice_name" =~ ^[a-zA-Z0-9_.-]+$ ]]; then
+    echo "❌ Invalid voice name: $voice_name" >&2
+    return 1
+  fi
+
   local voice_dir
   voice_dir=$(get_voice_storage_dir)
 

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

@@ -1,90 +1,90 @@
-#!/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 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