agentvibes 4.2.0 → 4.4.0

package/.claude/hooks/clawdbot-receiver-SECURE.sh

@@ -1,129 +1,129 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/clawdbot-receiver.sh (SECURITY-HARDENED VERSION)
-#
-# AgentVibes Clawdbot Receiver - SSH-Remote TTS with Agent Support and Intro Messages
-# Receives base64-encoded text, voice, agent name, and optional intro from remote Clawdbot instances
-# Calls AgentVibes play-tts-enhanced.sh to apply agent-specific audio effects
-#
-# SECURITY ENHANCEMENTS:
-# - Voice name whitelist validation
-# - Agent name format validation (alphanumeric only)
-# - Length limits on decoded content
-# - Safe HOME directory handling
-#
-# Usage (called via SSH from remote):
-#   clawdbot-receiver.sh <base64_text> <voice> <base64_agent_name> [base64_intro]
-#
-# Copyright (c) 2025 Paul Preibisch
-# Licensed under the Apache License, Version 2.0
-#
-
-set -euo pipefail
-
-ENCODED_TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
-ENCODED_AGENT="${3:-}"
-ENCODED_INTRO="${4:-}"
-
-# Validate inputs
-if [[ -z "$ENCODED_TEXT" ]]; then
-  echo "Error: No encoded text provided" >&2
-  echo "Usage: $0 <base64_text> <voice> <base64_agent_name> [base64_intro]" >&2
-  exit 1
-fi
-
-# SECURITY: Validate base64 format (reject shell metacharacters)
-[[ "$ENCODED_TEXT" =~ ^[A-Za-z0-9+/=]+$ ]] || { echo "Error: invalid base64 text" >&2; exit 1; }
-
-# SECURITY: Validate VOICE parameter format (alphanumeric, hyphens, underscores only)
-if [[ ! "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]]; then
-  echo "Error: Invalid voice name format: $VOICE" >&2
-  exit 1
-fi
-
-# SECURITY: Decode base64 safely
-# This prevents command injection from malicious text
-DECODED_TEXT=$(echo -n "$ENCODED_TEXT" | base64 -d 2>/dev/null) || {
-  echo "❌ Failed to decode text (invalid base64)" >&2
-  exit 1
-}
-
-# SECURITY: Enforce length limit on decoded text (10KB max)
-if [[ ${#DECODED_TEXT} -gt 10000 ]]; then
-  echo "❌ Decoded text too long (${#DECODED_TEXT} chars, max 10000)" >&2
-  exit 1
-fi
-
-DECODED_AGENT="default"
-if [[ -n "$ENCODED_AGENT" ]]; then
-  # SECURITY: Validate base64 format before decoding
-  [[ "$ENCODED_AGENT" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_AGENT=""
-  if [[ -n "$ENCODED_AGENT" ]]; then
-    DECODED_AGENT=$(echo -n "$ENCODED_AGENT" | base64 -d 2>/dev/null) || DECODED_AGENT="default"
-  fi
-
-  # SECURITY: Validate agent name format (alphanumeric, dash, underscore only)
-  [[ "$DECODED_AGENT" =~ ^[a-zA-Z0-9_-]+$ ]] || DECODED_AGENT="default"
-
-  # SECURITY: Enforce length limit on agent name
-  [[ ${#DECODED_AGENT} -le 50 ]] || DECODED_AGENT="default"
-fi
-
-# Decode and prepend intro if provided
-DECODED_INTRO=""
-if [[ -n "$ENCODED_INTRO" ]]; then
-  # SECURITY: Validate base64 format before decoding
-  [[ "$ENCODED_INTRO" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_INTRO=""
-  if [[ -n "$ENCODED_INTRO" ]]; then
-    DECODED_INTRO=$(echo -n "$ENCODED_INTRO" | base64 -d 2>/dev/null) || DECODED_INTRO=""
-  fi
-
-  # SECURITY: Enforce length limit on intro message
-  [[ ${#DECODED_INTRO} -le 200 ]] || DECODED_INTRO="${DECODED_INTRO:0:200}"
-fi
-
-# Prepend intro to text if configured
-if [[ -n "$DECODED_INTRO" ]]; then
-  DECODED_TEXT="${DECODED_INTRO} ${DECODED_TEXT}"
-fi
-
-# Find AgentVibes installation
-# SECURITY: Validate HOME is set and use absolute paths
-if [[ -z "${HOME:-}" ]]; then
-  echo "❌ HOME environment variable not set" >&2
-  exit 1
-fi
-
-# Priority: 1. ~/agentvibes, 2. ~/AgentVibes-dev, 3. current directory
-AGENTVIBES_ROOT=""
-if [[ -f "$HOME/agentvibes/.claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$HOME/agentvibes"
-elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$HOME/AgentVibes-dev"
-elif [[ -f ".claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$(pwd)"
-else
-  echo "❌ AgentVibes not found" >&2
-  echo "💡 Install AgentVibes at ~/agentvibes/ or ~/AgentVibes-dev/" >&2
-  exit 1
-fi
-
-# SECURITY: Validate AgentVibes root is a directory
-if [[ ! -d "$AGENTVIBES_ROOT" ]]; then
-  echo "❌ AgentVibes root is not a directory: $AGENTVIBES_ROOT" >&2
-  exit 1
-fi
-
-echo "🎤 Voice: $VOICE | Agent: $DECODED_AGENT | Vol: 30% | Effects: default" >&2
-
-# Call AgentVibes play-tts-enhanced.sh with agent name for audio-effects.cfg lookup
-# SECURITY: Use absolute path and proper quoting
-cd "$AGENTVIBES_ROOT" && \
-  bash .claude/hooks/play-tts-enhanced.sh "$DECODED_TEXT" "$DECODED_AGENT" "$VOICE" 2>&1 || {
-  # Fallback to standard play-tts if enhanced fails
-  echo "⚠️  Enhanced TTS failed, using standard TTS" >&2
-  bash .claude/hooks/play-tts.sh "$DECODED_TEXT" "$VOICE" 2>&1
-}
-
-exit 0
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/clawdbot-receiver.sh (SECURITY-HARDENED VERSION)
+#
+# AgentVibes Clawdbot Receiver - SSH-Remote TTS with Agent Support and Intro Messages
+# Receives base64-encoded text, voice, agent name, and optional intro from remote Clawdbot instances
+# Calls AgentVibes play-tts-enhanced.sh to apply agent-specific audio effects
+#
+# SECURITY ENHANCEMENTS:
+# - Voice name whitelist validation
+# - Agent name format validation (alphanumeric only)
+# - Length limits on decoded content
+# - Safe HOME directory handling
+#
+# Usage (called via SSH from remote):
+#   clawdbot-receiver.sh <base64_text> <voice> <base64_agent_name> [base64_intro]
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+ENCODED_TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+ENCODED_AGENT="${3:-}"
+ENCODED_INTRO="${4:-}"
+
+# Validate inputs
+if [[ -z "$ENCODED_TEXT" ]]; then
+  echo "Error: No encoded text provided" >&2
+  echo "Usage: $0 <base64_text> <voice> <base64_agent_name> [base64_intro]" >&2
+  exit 1
+fi
+
+# SECURITY: Validate base64 format (reject shell metacharacters)
+[[ "$ENCODED_TEXT" =~ ^[A-Za-z0-9+/=]+$ ]] || { echo "Error: invalid base64 text" >&2; exit 1; }
+
+# SECURITY: Validate VOICE parameter format (alphanumeric, hyphens, underscores only)
+if [[ ! "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+  echo "Error: Invalid voice name format: $VOICE" >&2
+  exit 1
+fi
+
+# SECURITY: Decode base64 safely
+# This prevents command injection from malicious text
+DECODED_TEXT=$(echo -n "$ENCODED_TEXT" | base64 -d 2>/dev/null) || {
+  echo "❌ Failed to decode text (invalid base64)" >&2
+  exit 1
+}
+
+# SECURITY: Enforce length limit on decoded text (10KB max)
+if [[ ${#DECODED_TEXT} -gt 10000 ]]; then
+  echo "❌ Decoded text too long (${#DECODED_TEXT} chars, max 10000)" >&2
+  exit 1
+fi
+
+DECODED_AGENT="default"
+if [[ -n "$ENCODED_AGENT" ]]; then
+  # SECURITY: Validate base64 format before decoding
+  [[ "$ENCODED_AGENT" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_AGENT=""
+  if [[ -n "$ENCODED_AGENT" ]]; then
+    DECODED_AGENT=$(echo -n "$ENCODED_AGENT" | base64 -d 2>/dev/null) || DECODED_AGENT="default"
+  fi
+
+  # SECURITY: Validate agent name format (alphanumeric, dash, underscore only)
+  [[ "$DECODED_AGENT" =~ ^[a-zA-Z0-9_-]+$ ]] || DECODED_AGENT="default"
+
+  # SECURITY: Enforce length limit on agent name
+  [[ ${#DECODED_AGENT} -le 50 ]] || DECODED_AGENT="default"
+fi
+
+# Decode and prepend intro if provided
+DECODED_INTRO=""
+if [[ -n "$ENCODED_INTRO" ]]; then
+  # SECURITY: Validate base64 format before decoding
+  [[ "$ENCODED_INTRO" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_INTRO=""
+  if [[ -n "$ENCODED_INTRO" ]]; then
+    DECODED_INTRO=$(echo -n "$ENCODED_INTRO" | base64 -d 2>/dev/null) || DECODED_INTRO=""
+  fi
+
+  # SECURITY: Enforce length limit on intro message
+  [[ ${#DECODED_INTRO} -le 200 ]] || DECODED_INTRO="${DECODED_INTRO:0:200}"
+fi
+
+# Prepend intro to text if configured
+if [[ -n "$DECODED_INTRO" ]]; then
+  DECODED_TEXT="${DECODED_INTRO} ${DECODED_TEXT}"
+fi
+
+# Find AgentVibes installation
+# SECURITY: Validate HOME is set and use absolute paths
+if [[ -z "${HOME:-}" ]]; then
+  echo "❌ HOME environment variable not set" >&2
+  exit 1
+fi
+
+# Priority: 1. ~/agentvibes, 2. ~/AgentVibes-dev, 3. current directory
+AGENTVIBES_ROOT=""
+if [[ -f "$HOME/agentvibes/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/agentvibes"
+elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/AgentVibes-dev"
+elif [[ -f ".claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$(pwd)"
+else
+  echo "❌ AgentVibes not found" >&2
+  echo "💡 Install AgentVibes at ~/agentvibes/ or ~/AgentVibes-dev/" >&2
+  exit 1
+fi
+
+# SECURITY: Validate AgentVibes root is a directory
+if [[ ! -d "$AGENTVIBES_ROOT" ]]; then
+  echo "❌ AgentVibes root is not a directory: $AGENTVIBES_ROOT" >&2
+  exit 1
+fi
+
+echo "🎤 Voice: $VOICE | Agent: $DECODED_AGENT | Vol: 30% | Effects: default" >&2
+
+# Call AgentVibes play-tts-enhanced.sh with agent name for audio-effects.cfg lookup
+# SECURITY: Use absolute path and proper quoting
+cd "$AGENTVIBES_ROOT" && \
+  bash .claude/hooks/play-tts-enhanced.sh "$DECODED_TEXT" "$DECODED_AGENT" "$VOICE" 2>&1 || {
+  # Fallback to standard play-tts if enhanced fails
+  echo "⚠️  Enhanced TTS failed, using standard TTS" >&2
+  bash .claude/hooks/play-tts.sh "$DECODED_TEXT" "$VOICE" 2>&1
+}
+
+exit 0

package/.claude/hooks/clawdbot-receiver.sh

@@ -1,107 +1,107 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/clawdbot-receiver.sh
-#
-# AgentVibes Clawdbot Receiver - SSH-Remote TTS with Agent Support and Intro Messages
-# Receives base64-encoded text, voice, agent name, and optional intro from remote Clawdbot instances
-#
-# Usage (called via SSH from remote):
-#   clawdbot-receiver.sh <base64_text> <voice> <base64_agent_name> [base64_intro]
-#
-# Parameters:
-#   base64_text       - The main TTS text (base64 encoded)
-#   voice             - Piper voice name (e.g., en_US-amy-medium)
-#   base64_agent_name - Agent name for audio effects lookup (base64 encoded)
-#   base64_intro      - Optional intro message to prepend (base64 encoded)
-#                       e.g., "Orion ClawdBot here." or "Samuel, your assistant."
-#
-# The intro is prepended to the text: "${INTRO} ${TEXT}"
-#
-# Copyright (c) 2025 Paul Preibisch
-# Licensed under the Apache License, Version 2.0
-#
-
-set -euo pipefail
-
-ENCODED_TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
-ENCODED_AGENT="${3:-}"
-ENCODED_INTRO="${4:-}"
-
-# Validate inputs
-if [[ -z "$ENCODED_TEXT" ]]; then
-  echo "Error: No encoded text provided" >&2
-  echo "Usage: $0 <base64_text> <voice> <base64_agent_name> [base64_intro]" >&2
-  exit 1
-fi
-
-# SECURITY: Validate base64 format (reject shell metacharacters)
-[[ "$ENCODED_TEXT" =~ ^[A-Za-z0-9+/=]+$ ]] || { echo "Error: invalid base64 text" >&2; exit 1; }
-
-# SECURITY: Validate voice name format (alphanumeric, hyphens, underscores only)
-[[ "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]] || { echo "Error: invalid voice format" >&2; exit 1; }
-
-# SECURITY: Decode base64 safely
-DECODED_TEXT=$(echo -n "$ENCODED_TEXT" | base64 -d 2>/dev/null) || {
-  echo "Error: Failed to decode text (invalid base64)" >&2
-  exit 1
-}
-
-# SECURITY: Enforce length limit on decoded text (10KB max)
-if [[ ${#DECODED_TEXT} -gt 10000 ]]; then
-  echo "Error: Decoded text too long (${#DECODED_TEXT} chars, max 10000)" >&2
-  exit 1
-fi
-
-DECODED_AGENT="default"
-if [[ -n "$ENCODED_AGENT" ]]; then
-  [[ "$ENCODED_AGENT" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_AGENT=""
-  if [[ -n "$ENCODED_AGENT" ]]; then
-    DECODED_AGENT=$(echo -n "$ENCODED_AGENT" | base64 -d 2>/dev/null) || DECODED_AGENT="default"
-  fi
-  # Validate agent name format (alphanumeric, dash, underscore only)
-  [[ "$DECODED_AGENT" =~ ^[a-zA-Z0-9_-]+$ ]] || DECODED_AGENT="default"
-  # Enforce length limit
-  [[ ${#DECODED_AGENT} -le 50 ]] || DECODED_AGENT="default"
-fi
-
-# Decode and prepend intro if provided
-DECODED_INTRO=""
-if [[ -n "$ENCODED_INTRO" ]]; then
-  [[ "$ENCODED_INTRO" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_INTRO=""
-  if [[ -n "$ENCODED_INTRO" ]]; then
-    DECODED_INTRO=$(echo -n "$ENCODED_INTRO" | base64 -d 2>/dev/null) || DECODED_INTRO=""
-  fi
-  # Enforce length limit on intro (200 chars max)
-  [[ ${#DECODED_INTRO} -le 200 ]] || DECODED_INTRO="${DECODED_INTRO:0:200}"
-fi
-
-# Prepend intro to text if configured
-if [[ -n "$DECODED_INTRO" ]]; then
-  DECODED_TEXT="${DECODED_INTRO} ${DECODED_TEXT}"
-fi
-
-# Find AgentVibes installation
-AGENTVIBES_ROOT=""
-if [[ -f "$HOME/agentvibes/.claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$HOME/agentvibes"
-elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$HOME/AgentVibes-dev"
-elif [[ -f ".claude/hooks/play-tts-enhanced.sh" ]]; then
-  AGENTVIBES_ROOT="$(pwd)"
-else
-  echo "❌ AgentVibes not found" >&2
-  echo "💡 Install AgentVibes at ~/agentvibes/ or ~/AgentVibes-dev/" >&2
-  exit 1
-fi
-
-echo "🎤 Voice: $VOICE | Agent: $DECODED_AGENT" >&2
-
-# Play TTS directly (lock removed temporarily for testing)
-cd "$AGENTVIBES_ROOT"
-bash .claude/hooks/play-tts-enhanced.sh "$DECODED_TEXT" "$DECODED_AGENT" "$VOICE" 2>&1 || {
-  echo "⚠️  Enhanced TTS failed, using standard TTS" >&2
-  bash .claude/hooks/play-tts.sh "$DECODED_TEXT" "$VOICE" 2>&1
-}
-
-exit 0
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/clawdbot-receiver.sh
+#
+# AgentVibes Clawdbot Receiver - SSH-Remote TTS with Agent Support and Intro Messages
+# Receives base64-encoded text, voice, agent name, and optional intro from remote Clawdbot instances
+#
+# Usage (called via SSH from remote):
+#   clawdbot-receiver.sh <base64_text> <voice> <base64_agent_name> [base64_intro]
+#
+# Parameters:
+#   base64_text       - The main TTS text (base64 encoded)
+#   voice             - Piper voice name (e.g., en_US-amy-medium)
+#   base64_agent_name - Agent name for audio effects lookup (base64 encoded)
+#   base64_intro      - Optional intro message to prepend (base64 encoded)
+#                       e.g., "Orion ClawdBot here." or "Samuel, your assistant."
+#
+# The intro is prepended to the text: "${INTRO} ${TEXT}"
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+ENCODED_TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+ENCODED_AGENT="${3:-}"
+ENCODED_INTRO="${4:-}"
+
+# Validate inputs
+if [[ -z "$ENCODED_TEXT" ]]; then
+  echo "Error: No encoded text provided" >&2
+  echo "Usage: $0 <base64_text> <voice> <base64_agent_name> [base64_intro]" >&2
+  exit 1
+fi
+
+# SECURITY: Validate base64 format (reject shell metacharacters)
+[[ "$ENCODED_TEXT" =~ ^[A-Za-z0-9+/=]+$ ]] || { echo "Error: invalid base64 text" >&2; exit 1; }
+
+# SECURITY: Validate voice name format (alphanumeric, hyphens, underscores only)
+[[ "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]] || { echo "Error: invalid voice format" >&2; exit 1; }
+
+# SECURITY: Decode base64 safely
+DECODED_TEXT=$(echo -n "$ENCODED_TEXT" | base64 -d 2>/dev/null) || {
+  echo "Error: Failed to decode text (invalid base64)" >&2
+  exit 1
+}
+
+# SECURITY: Enforce length limit on decoded text (10KB max)
+if [[ ${#DECODED_TEXT} -gt 10000 ]]; then
+  echo "Error: Decoded text too long (${#DECODED_TEXT} chars, max 10000)" >&2
+  exit 1
+fi
+
+DECODED_AGENT="default"
+if [[ -n "$ENCODED_AGENT" ]]; then
+  [[ "$ENCODED_AGENT" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_AGENT=""
+  if [[ -n "$ENCODED_AGENT" ]]; then
+    DECODED_AGENT=$(echo -n "$ENCODED_AGENT" | base64 -d 2>/dev/null) || DECODED_AGENT="default"
+  fi
+  # Validate agent name format (alphanumeric, dash, underscore only)
+  [[ "$DECODED_AGENT" =~ ^[a-zA-Z0-9_-]+$ ]] || DECODED_AGENT="default"
+  # Enforce length limit
+  [[ ${#DECODED_AGENT} -le 50 ]] || DECODED_AGENT="default"
+fi
+
+# Decode and prepend intro if provided
+DECODED_INTRO=""
+if [[ -n "$ENCODED_INTRO" ]]; then
+  [[ "$ENCODED_INTRO" =~ ^[A-Za-z0-9+/=]+$ ]] || ENCODED_INTRO=""
+  if [[ -n "$ENCODED_INTRO" ]]; then
+    DECODED_INTRO=$(echo -n "$ENCODED_INTRO" | base64 -d 2>/dev/null) || DECODED_INTRO=""
+  fi
+  # Enforce length limit on intro (200 chars max)
+  [[ ${#DECODED_INTRO} -le 200 ]] || DECODED_INTRO="${DECODED_INTRO:0:200}"
+fi
+
+# Prepend intro to text if configured
+if [[ -n "$DECODED_INTRO" ]]; then
+  DECODED_TEXT="${DECODED_INTRO} ${DECODED_TEXT}"
+fi
+
+# Find AgentVibes installation
+AGENTVIBES_ROOT=""
+if [[ -f "$HOME/agentvibes/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/agentvibes"
+elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/AgentVibes-dev"
+elif [[ -f ".claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$(pwd)"
+else
+  echo "❌ AgentVibes not found" >&2
+  echo "💡 Install AgentVibes at ~/agentvibes/ or ~/AgentVibes-dev/" >&2
+  exit 1
+fi
+
+echo "🎤 Voice: $VOICE | Agent: $DECODED_AGENT" >&2
+
+# Play TTS directly (lock removed temporarily for testing)
+cd "$AGENTVIBES_ROOT"
+bash .claude/hooks/play-tts-enhanced.sh "$DECODED_TEXT" "$DECODED_AGENT" "$VOICE" 2>&1 || {
+  echo "⚠️  Enhanced TTS failed, using standard TTS" >&2
+  bash .claude/hooks/play-tts.sh "$DECODED_TEXT" "$VOICE" 2>&1
+}
+
+exit 0

package/.claude/hooks/clean-audio-cache.sh

@@ -1,22 +1,22 @@
-#!/usr/bin/env bash
-# Non-Interactive TTS Audio Cache Cleanup
-# Used by /agent-vibes:clean skill and MCP clean_audio_cache tool
-
-set -euo pipefail
-
-# Source audio cache utilities
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/audio-cache-utils.sh"
-
-# Colors
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-echo -e "${BLUE}🧹 AgentVibes Cache Cleanup (Non-Interactive)${NC}"
-echo ""
-
-# Get audio directory and perform cleanup
-AUDIO_DIR=$(get_audio_dir)
-clean_all_tts_files "$AUDIO_DIR"
-
-echo ""
+#!/usr/bin/env bash
+# Non-Interactive TTS Audio Cache Cleanup
+# Used by /agent-vibes:clean skill and MCP clean_audio_cache tool
+
+set -euo pipefail
+
+# Source audio cache utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/audio-cache-utils.sh"
+
+# Colors
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🧹 AgentVibes Cache Cleanup (Non-Interactive)${NC}"
+echo ""
+
+# Get audio directory and perform cleanup
+AUDIO_DIR=$(get_audio_dir)
+clean_all_tts_files "$AUDIO_DIR"
+
+echo ""