agentvibes 5.3.0 → 5.4.0

package/.claude/github-star-reminder.txt

@@ -1 +1 @@
-20260403
+20260422

package/.claude/hooks/README-TTS-QUEUE.md

@@ -1,135 +1,135 @@
-# TTS Queue System for Party Mode
-
-## Overview
-
-The TTS Queue System enables BMAD party mode agents to speak sequentially without blocking Claude Code's response generation. This provides the best of both worlds:
-
-- ✅ **Non-blocking**: Claude Code continues generating agent responses immediately
-- ✅ **Sequential playback**: Agents speak one at a time in order, with correct voices
-- ✅ **No audio overlap**: The queue ensures voices don't talk over each other
-
-## How It Works
-
-### Architecture
-
-```
-bmad-speak.sh → tts-queue.sh → Queue Directory → tts-queue-worker.sh → play-tts.sh → Audio
-     ↓               ↓                                       ↓
-  Returns        Returns                              Processes queue
-immediately    immediately                            sequentially
-```
-
-### Components
-
-1. **`tts-queue.sh`** - Queue manager (adds requests, shows status, clears queue)
-2. **`tts-queue-worker.sh`** - Background worker process (plays audio sequentially)
-3. **`bmad-speak.sh`** - Updated to use queue system with `&` for non-blocking
-4. **Queue directory**: `/tmp/agentvibes-tts-queue/` - Stores pending TTS requests
-
-### Flow
-
-1. Party mode agent generates response
-2. `bmad-speak.sh` adds TTS request to queue and returns immediately (`&`)
-3. Queue worker automatically starts if needed
-4. Worker processes queue items sequentially (oldest first)
-5. Each audio file plays to completion before next one starts
-6. Worker auto-exits after 5 seconds of idle time
-
-## Usage
-
-### Normal Usage (Automatic)
-
-Party mode automatically uses the queue system. No manual intervention needed.
-
-### Manual Queue Management
-
-```bash
-# Check queue status
-bash .claude/hooks/tts-queue.sh status
-
-# Clear all pending TTS (emergency stop)
-bash .claude/hooks/tts-queue.sh clear
-
-# Manually add to queue
-bash .claude/hooks/tts-queue.sh add "Hello world" "en_US-ryan-high"
-```
-
-## Performance Benefits
-
-### Before (Sequential Blocking):
-```
-Agent 1 text output → [WAIT 3s for audio] → Agent 2 text → [WAIT 3s] → Agent 3 text
-Total time: ~9+ seconds
-```
-
-### After (Queue System):
-```
-Agent 1 text → Agent 2 text → Agent 3 text (all immediate)
-                         ↓
-            [Audio plays sequentially in background]
-Total text output time: <1 second
-Total audio time: ~9 seconds (plays while Claude continues working)
-```
-
-## Technical Details
-
-### Queue File Format
-
-Each queue item is a timestamped file containing escaped bash variables:
-
-```bash
-TEXT='First\ message\ from\ John'
-VOICE='en_US-ryan-high'
-```
-
-### Worker Lifecycle
-
-- **Start**: Automatically launched when first item added to empty queue
-- **Processing**: Continues while queue has items
-- **Idle timeout**: Exits after 5 seconds with no new items
-- **Auto-restart**: Next queue addition spawns new worker
-
-### Thread Safety
-
-- Queue items use nanosecond timestamps for uniqueness
-- Worker processes oldest items first (sorted by filename)
-- Audio lock mechanism in `play-tts.sh` prevents actual audio overlap
-- Worker PID tracked in `/tmp/agentvibes-tts-queue/worker.pid`
-
-## Troubleshooting
-
-### Queue stuck or voices not playing
-
-```bash
-# Check status
-bash .claude/hooks/tts-queue.sh status
-
-# Clear queue and restart
-bash .claude/hooks/tts-queue.sh clear
-```
-
-### Worker not starting
-
-Check for errors in the worker script:
-```bash
-bash .claude/hooks/tts-queue-worker.sh
-```
-
-### Audio still overlapping
-
-Verify the lock file mechanism is working:
-```bash
-ls -la /tmp/agentvibes-audio.lock
-```
-
-## Files Modified
-
-- `.claude/hooks/bmad-speak.sh` - Now uses queue system with `&` for non-blocking
-- `.claude/hooks/tts-queue.sh` - New queue manager (added)
-- `.claude/hooks/tts-queue-worker.sh` - New background worker (added)
-
-## Compatibility
-
-- Works with both Piper and Piper TTS TTS providers
-- Compatible with all existing BMAD voice mappings
-- No changes needed to party mode workflow instructions
+# TTS Queue System for Party Mode
+
+## Overview
+
+The TTS Queue System enables BMAD party mode agents to speak sequentially without blocking Claude Code's response generation. This provides the best of both worlds:
+
+- ✅ **Non-blocking**: Claude Code continues generating agent responses immediately
+- ✅ **Sequential playback**: Agents speak one at a time in order, with correct voices
+- ✅ **No audio overlap**: The queue ensures voices don't talk over each other
+
+## How It Works
+
+### Architecture
+
+```
+bmad-speak.sh → tts-queue.sh → Queue Directory → tts-queue-worker.sh → play-tts.sh → Audio
+     ↓               ↓                                       ↓
+  Returns        Returns                              Processes queue
+immediately    immediately                            sequentially
+```
+
+### Components
+
+1. **`tts-queue.sh`** - Queue manager (adds requests, shows status, clears queue)
+2. **`tts-queue-worker.sh`** - Background worker process (plays audio sequentially)
+3. **`bmad-speak.sh`** - Updated to use queue system with `&` for non-blocking
+4. **Queue directory**: `/tmp/agentvibes-tts-queue/` - Stores pending TTS requests
+
+### Flow
+
+1. Party mode agent generates response
+2. `bmad-speak.sh` adds TTS request to queue and returns immediately (`&`)
+3. Queue worker automatically starts if needed
+4. Worker processes queue items sequentially (oldest first)
+5. Each audio file plays to completion before next one starts
+6. Worker auto-exits after 5 seconds of idle time
+
+## Usage
+
+### Normal Usage (Automatic)
+
+Party mode automatically uses the queue system. No manual intervention needed.
+
+### Manual Queue Management
+
+```bash
+# Check queue status
+bash .claude/hooks/tts-queue.sh status
+
+# Clear all pending TTS (emergency stop)
+bash .claude/hooks/tts-queue.sh clear
+
+# Manually add to queue
+bash .claude/hooks/tts-queue.sh add "Hello world" "en_US-ryan-high"
+```
+
+## Performance Benefits
+
+### Before (Sequential Blocking):
+```
+Agent 1 text output → [WAIT 3s for audio] → Agent 2 text → [WAIT 3s] → Agent 3 text
+Total time: ~9+ seconds
+```
+
+### After (Queue System):
+```
+Agent 1 text → Agent 2 text → Agent 3 text (all immediate)
+                         ↓
+            [Audio plays sequentially in background]
+Total text output time: <1 second
+Total audio time: ~9 seconds (plays while Claude continues working)
+```
+
+## Technical Details
+
+### Queue File Format
+
+Each queue item is a timestamped file containing escaped bash variables:
+
+```bash
+TEXT='First\ message\ from\ John'
+VOICE='en_US-ryan-high'
+```
+
+### Worker Lifecycle
+
+- **Start**: Automatically launched when first item added to empty queue
+- **Processing**: Continues while queue has items
+- **Idle timeout**: Exits after 5 seconds with no new items
+- **Auto-restart**: Next queue addition spawns new worker
+
+### Thread Safety
+
+- Queue items use nanosecond timestamps for uniqueness
+- Worker processes oldest items first (sorted by filename)
+- Audio lock mechanism in `play-tts.sh` prevents actual audio overlap
+- Worker PID tracked in `/tmp/agentvibes-tts-queue/worker.pid`
+
+## Troubleshooting
+
+### Queue stuck or voices not playing
+
+```bash
+# Check status
+bash .claude/hooks/tts-queue.sh status
+
+# Clear queue and restart
+bash .claude/hooks/tts-queue.sh clear
+```
+
+### Worker not starting
+
+Check for errors in the worker script:
+```bash
+bash .claude/hooks/tts-queue-worker.sh
+```
+
+### Audio still overlapping
+
+Verify the lock file mechanism is working:
+```bash
+ls -la /tmp/agentvibes-audio.lock
+```
+
+## Files Modified
+
+- `.claude/hooks/bmad-speak.sh` - Now uses queue system with `&` for non-blocking
+- `.claude/hooks/tts-queue.sh` - New queue manager (added)
+- `.claude/hooks/tts-queue-worker.sh` - New background worker (added)
+
+## Compatibility
+
+- Works with both Piper and Piper TTS TTS providers
+- Compatible with all existing BMAD voice mappings
+- No changes needed to party mode workflow instructions

package/.claude/hooks/audio-processor.sh

@@ -144,6 +144,42 @@ POSITION_FILE="$SCRIPT_DIR/../config/background-music-position.txt"
 # Lock file for position file — prevents race conditions in party mode with concurrent agents
 POSITION_LOCK="/tmp/agentvibes-bgpos-$(id -u).lock"
 
+# @function get_custom_music_path
+# @intent Story 4.7: Check for custom music uploaded by user
+# @returns Path to custom music file if exists, empty string otherwise
+# @context Custom music stored at .claude/audio/custom-music/tracks/
+get_custom_music_path() {
+    local custom_music_dir="$SCRIPT_DIR/../audio/custom-music/tracks"
+
+    # Check if custom music directory exists
+    if [[ ! -d "$custom_music_dir" ]]; then
+        echo ""
+        return
+    fi
+
+    # Look for any audio file in custom music directory
+    # Files uploaded through Stories 4.1-4.6 are stored here
+    # SECURITY: Use -maxdepth 1 to prevent directory traversal
+    # DETERMINISTIC: Sort by modification time (newest first) for consistent behavior
+    local custom_file
+    custom_file=$(find "$custom_music_dir" -maxdepth 1 -type f \( -name "*.mp3" -o -name "*.wav" -o -name "*.ogg" -o -name "*.m4a" \) -printf '%T@ %p\n' 2>/dev/null | sort -rn | head -1 | cut -d' ' -f2-)
+
+    if [[ -n "$custom_file" ]] && [[ -f "$custom_file" ]]; then
+        # SECURITY: Verify file ownership matches current user
+        local file_uid
+        file_uid=$(stat -c '%u' "$custom_file" 2>/dev/null || stat -f '%u' "$custom_file" 2>/dev/null)
+        local current_uid
+        current_uid=$(id -u)
+
+        if [[ "$file_uid" == "$current_uid" ]]; then
+            echo "$custom_file"
+            return
+        fi
+    fi
+
+    echo ""
+}
+
 # @function get_background_position
 # @intent Get saved position for a background track (caller must hold POSITION_LOCK)
 # @param $1 Background file path
@@ -368,10 +404,7 @@ main() {
     chmod 700 "$TEMP_DIR"
 
     # SECURITY: Verify ownership of temp directory
-    # SECURITY: Handle stat failure explicitly (#134)
-    local _dir_uid
-    _dir_uid=$(stat -c '%u' "$TEMP_DIR" 2>/dev/null || stat -f '%u' "$TEMP_DIR" 2>/dev/null)
-    if [[ -z "$_dir_uid" ]] || [[ "$_dir_uid" != "$(id -u)" ]]; then
+    if [[ "$(stat -c '%u' "$TEMP_DIR" 2>/dev/null || stat -f '%u' "$TEMP_DIR" 2>/dev/null)" != "$(id -u)" ]]; then
         echo "Error: Temp directory not owned by current user: $TEMP_DIR" >&2
         exit 1
     fi
@@ -379,14 +412,12 @@ main() {
     # SECURITY: Use mktemp for unpredictable filenames
     local temp_effects
     local temp_final
-    _tmp=$(mktemp "$TEMP_DIR/effects-XXXXXX"); temp_effects="${_tmp}.wav"; mv "$_tmp" "$temp_effects"
-    _tmp=$(mktemp "$TEMP_DIR/final-XXXXXX"); temp_final="${_tmp}.wav"; mv "$_tmp" "$temp_final"
+    temp_effects=$(mktemp "$TEMP_DIR/effects-XXXXXX.wav")
+    temp_final=$(mktemp "$TEMP_DIR/final-XXXXXX.wav")
 
-    # Clean up on exit - use a cleanup function to avoid trap injection
-    _cleanup_effects="$temp_effects"
-    _cleanup_final="$temp_final"
-    cleanup() { rm -f "$_cleanup_effects" "$_cleanup_final"; }
-    trap cleanup EXIT
+    # Clean up on exit - use double quotes to capture paths at definition time
+    # (local variables won't exist at trap execution time outside function scope)
+    trap "rm -f '$temp_effects' '$temp_final'" EXIT
 
     # Step 1: Apply sox effects
     if [[ -n "$sox_effects" ]]; then
@@ -397,8 +428,17 @@ main() {
     fi
 
     # Step 2: Mix background if configured AND enabled
+    # Story 4.7: Check for custom music first, then fallback to default
     local background_path=""
-    if [[ -n "$background_file" ]]; then
+    local custom_music_path
+    custom_music_path=$(get_custom_music_path)
+
+    if [[ -n "$custom_music_path" ]]; then
+        # Story 4.7: Custom music uploaded by user takes priority
+        background_path="$custom_music_path"
+        echo "  → Using custom background music" >&2
+    elif [[ -n "$background_file" ]]; then
+        # Fall back to default background music from audio-effects.cfg
         background_path="$BACKGROUNDS_DIR/$background_file"
     fi
 
@@ -414,8 +454,14 @@ main() {
     fi
 
     local used_background=""
-    if [[ "$_bg_allowed" == "true" ]] && [[ -n "$background_path" ]] && [[ -f "$background_path" ]] && [[ "${bg_volume:-0}" != "0" ]] && [[ "${bg_volume:-0}" != "0.0" ]]; then
-        echo "  → Mixing background: $background_file at ${bg_volume} volume" >&2
+    if is_background_music_enabled && [[ -n "$background_path" ]] && [[ -f "$background_path" ]] && [[ "${bg_volume:-0}" != "0" ]] && [[ "${bg_volume:-0}" != "0.0" ]]; then
+        local bg_display_name
+        if [[ "$background_path" == "$custom_music_path" ]]; then
+            bg_display_name="custom music"
+        else
+            bg_display_name="$background_file"
+        fi
+        echo "  → Mixing background: $bg_display_name at ${bg_volume} volume" >&2
         mix_background "$temp_effects" "$background_path" "$bg_volume" "$temp_final"
         used_background="$background_path"  # Return full path instead of just filename
     else

package/.claude/hooks/bmad-party-manager.sh

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-party-manager.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 BMAD Party Mode Voice Integration Manager
+# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
+# @architecture Opt-out flag management, auto-detection, status reporting
+# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
+# @entrypoints /agent-vibes:bmad-party slash command
+# @patterns Auto-enable with opt-out, graceful degradation, feature detection
+# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
+
+# Fix locale warnings
+export LC_ALL=C
+
+PLUGIN_DIR=".claude/plugins"
+DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
+BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+#
+# @function is_bmad_installed
+# @context Check if BMAD v6 is installed
+# @returns 0=installed, 1=not installed
+#
+is_bmad_installed() {
+  [[ -f "$BMAD_MANIFEST" ]]
+}
+
+#
+# @function is_bmad_voices_enabled
+# @context Check if BMAD voice plugin is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_bmad_voices_enabled() {
+  [[ -f "$BMAD_VOICES_FLAG" ]]
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if party mode voice integration is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_party_mode_enabled() {
+  # Disabled if opt-out flag exists
+  [[ -f "$DISABLE_FLAG" ]] && return 1
+
+  # Enabled if BMAD + voice plugin active
+  is_bmad_installed && is_bmad_voices_enabled
+}
+
+#
+# @function show_status
+# @context Display current party mode voice integration status
+#
+show_status() {
+  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Check BMAD installation
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ BMAD not installed${NC}"
+    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
+    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
+
+  # Check voice plugin
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
+
+  # Check party mode status
+  if is_party_mode_enabled; then
+    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
+    echo ""
+    echo -e "${CYAN}How it works:${NC}"
+    echo "  When you run /bmad:core:workflows:party-mode,"
+    echo "  each agent speaks with their unique voice:"
+    echo ""
+    echo "  🏗️  Winston (Architect) → Michael"
+    echo "  📋 John (PM) → Jessica Anne Bogart"
+    echo "  💻 Amelia (Dev) → Matthew Schmitz"
+    echo "  📊 Mary (Analyst) → kristin"
+    echo "  ... and more!"
+    echo ""
+    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
+    echo ""
+    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function enable_party_mode
+# @context Enable party mode voice integration (remove opt-out flag)
+#
+enable_party_mode() {
+  # Verify prerequisites
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
+    echo -e "${GRAY}   Install BMAD v6 first${NC}"
+    return 1
+  fi
+
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
+    return 1
+  fi
+
+  # Remove opt-out flag if it exists
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    rm -f "$DISABLE_FLAG"
+    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
+    echo ""
+    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
+    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
+  else
+    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
+    echo ""
+    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function disable_party_mode
+# @context Disable party mode voice integration (create opt-out flag)
+#
+disable_party_mode() {
+  mkdir -p "$PLUGIN_DIR"
+
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
+    return 0
+  fi
+
+  # Create opt-out flag
+  touch "$DISABLE_FLAG"
+
+  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
+  echo ""
+  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
+  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
+  echo ""
+}
+
+# Main command dispatcher
+case "${1:-status}" in
+  enable)
+    enable_party_mode
+    ;;
+  disable)
+    disable_party_mode
+    ;;
+  status)
+    show_status
+    ;;
+  *)
+    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
+    echo ""
+    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Enable party mode voice integration"
+    echo "  disable    Disable party mode voice integration (opt-out)"
+    echo "  status     Show current status and configuration"
+    echo ""
+    echo "Party Mode Voice Integration:"
+    echo "  • Auto-enabled when BMAD v6 detected"
+    echo "  • Each agent speaks with unique voice during party mode"
+    echo "  • Opt-out available via disable command"
+    ;;
+esac

package/.claude/hooks/bmad-speak.sh

@@ -169,19 +169,12 @@ map_to_agent_id() {
 
 AGENT_ID=$(map_to_agent_id "$AGENT_NAME_OR_ID")
 
-# Read per-agent profile from bmad-voice-map.json (takes priority)
-PROFILE_VOICE=""
-PROFILE_PRETEXT=""
-PROFILE_REVERB=""
-PROFILE_PERSONALITY=""
-PROFILE_MUSIC_TRACK=""
-PROFILE_MUSIC_VOLUME=""
-PROFILE_MUSIC_ENABLED=""
-
-if [[ -n "$AGENT_ID" ]] && [[ -f "$VOICE_MAP_FILE" ]]; then
-  # Single Node.js call for all fields — avoids ~900ms of per-call startup overhead
-  _ALL_FIELDS=$(read_agent_profile_all "$AGENT_ID")
-  IFS='|' read -r PROFILE_VOICE PROFILE_PRETEXT PROFILE_REVERB PROFILE_PERSONALITY PROFILE_MUSIC_TRACK PROFILE_MUSIC_VOLUME PROFILE_MUSIC_ENABLED <<< "$_ALL_FIELDS"
+# Get agent's voice and intro text
+AGENT_VOICE=""
+AGENT_INTRO=""
+if [[ -n "$AGENT_ID" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+  AGENT_VOICE=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null)
+  AGENT_INTRO=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null)
 fi
 
 # Read global background music volume as fallback (stored as 0.0-1.0, convert to 0-100 integer)