agentvibes 2.5.0 → 2.7.0

package/.claude/hooks/stop.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/user-prompt-output.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 Auto-detects emoji markers and BMAD party mode in Claude's output and triggers TTS
+# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and BMAD party mode agent dialogues
+# @architecture Stdin reader, regex matcher, async TTS trigger, agent voice switching
+# @dependencies play-tts.sh, tts-verbosity.txt, bmad-voice-manager.sh, .bmad/_cfg/agent-manifest.csv
+# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
+# @patterns Text stream processing, background job execution, marker-based triggers, party mode detection
+# @related session-start-tts.sh, verbosity-manager.sh, bmad-voice-manager.sh, Issue #32, Issue #33
+# @aiNotes This hook enables natural emoji-based TTS + BMAD party mode voice switching
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract transcript path from JSON
+TRANSCRIPT_PATH=$(echo "$INPUT" | grep -o '"transcript_path":"[^"]*"' | cut -d'"' -f4)
+
+# If no transcript path, exit (shouldn't happen but be safe)
+[[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]] && exit 0
+
+# Get the last assistant message from transcript
+# The transcript is JSONL format - each line is a JSON object
+# Extract all text content blocks from the last message and join them
+LAST_RESPONSE=$(tail -1 "$TRANSCRIPT_PATH" | jq -r '.message.content[] | select(.type == "text") | .text' 2>/dev/null)
+
+# Get verbosity level
+VERBOSITY=$(cat "$PROJECT_ROOT/.claude/tts-verbosity.txt" 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+
+# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
+[[ ! -f "$PLAY_TTS" ]] && exit 0
+
+#
+# @function extract_and_speak
+# @context Extracts text after emoji markers and triggers TTS asynchronously
+# @architecture Uses grep to find markers, extracts text, launches TTS in background
+# @dependencies play-tts.sh
+# @entrypoints Called based on verbosity level
+# @aiNotes Background execution (&) prevents blocking Claude's output
+#
+extract_and_speak() {
+  local pattern="$1"
+
+  # Extract lines matching the pattern
+  # Pattern format: "emoji text" or "emoji [text]"
+  while IFS= read -r line; do
+    # Try to extract text after emoji
+    # Handles formats: "💭 text", "💭 [text]", "💭text"
+    if echo "$line" | grep -qE "$pattern"; then
+      # Extract everything after the emoji (and optional space/bracket)
+      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
+
+      # Skip if text is empty or too short
+      [[ -z "$text" || ${#text} -lt 3 ]] && continue
+
+      # Speak it in background (don't block)
+      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
+    fi
+  done <<< "$LAST_RESPONSE"
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if BMAD party mode voice integration is enabled
+# @architecture Auto-enable for BMAD users, opt-out via disable flag
+# @dependencies .bmad/_cfg/agent-manifest.csv, .claude/plugins/bmad-voices-enabled.flag
+# @returns 0=enabled, 1=disabled
+# @aiNotes Auto-enabled when BMAD detected, respects opt-out flag for user control
+#
+is_party_mode_enabled() {
+  # Explicit opt-out takes precedence
+  [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-party-mode-disabled.flag" ]] && return 1
+
+  # Auto-enable if BMAD detected + voice plugin enabled
+  if [[ -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]] && \
+     [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-voices-enabled.flag" ]]; then
+    return 0
+  fi
+
+  return 1
+}
+
+#
+# @function map_display_name_to_agent_id
+# @context Map BMAD agent display name to agent ID for voice lookup
+# @architecture Parses agent-manifest.csv, matches displayName column to name column
+# @dependencies .bmad/_cfg/agent-manifest.csv
+# @param $1 Display name (e.g., "Winston", "John", "Amelia")
+# @returns Agent ID (e.g., "architect", "pm", "dev") or empty string if not found
+# @aiNotes Case-insensitive matching, handles quoted CSV values
+#
+map_display_name_to_agent_id() {
+  local display_name="$1"
+
+  # Check for BMAD v6 manifest
+  if [[ ! -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]]; then
+    return 1
+  fi
+
+  # CSV format: name,displayName,title,icon,role,...
+  # Extract 'name' (column 1) where displayName (column 2) matches
+  # Case-insensitive grep, remove quotes, get first match
+  local agent_id=$(grep -i ",\"*${display_name}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
+                   head -1 | \
+                   cut -d',' -f1 | \
+                   tr -d '"')
+
+  echo "$agent_id"
+}
+
+#
+# @function detect_and_speak_party_mode_dialogue
+# @context Detect BMAD party mode agent responses and speak with agent-specific voices
+# @architecture Pattern matches [Agent Name]: format, maps to agent voice, triggers TTS
+# @dependencies map_display_name_to_agent_id, bmad-voice-manager.sh, play-tts.sh
+# @aiNotes Runs in background to avoid blocking, graceful fallback for unmapped agents
+#
+detect_and_speak_party_mode_dialogue() {
+  # Pattern: [Agent Name]: dialogue
+  # Must start at beginning of line, agent name can include spaces/hyphens
+  while IFS= read -r line; do
+    if echo "$line" | grep -qE '^\[([A-Za-z\s-]+)\]:'; then
+      # Extract agent display name and dialogue
+      local agent_name=$(echo "$line" | sed -E 's/^\[([A-Za-z\s-]+)\]:.*/\1/')
+      local dialogue=$(echo "$line" | sed -E 's/^\[[^]]+\]:[[:space:]]*//')
+
+      # Skip if dialogue is empty or too short
+      [[ -z "$dialogue" || ${#dialogue} -lt 3 ]] && continue
+
+      # Map display name to agent ID
+      local agent_id=$(map_display_name_to_agent_id "$agent_name")
+
+      # Get agent's voice from bmad-voice-manager.sh
+      local agent_voice=""
+      if [[ -n "$agent_id" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+        agent_voice=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$agent_id" 2>/dev/null)
+      fi
+
+      # Speak with agent's voice (or default if not mapped)
+      # Run in foreground to ensure audio completes
+      if [[ -n "$agent_voice" ]]; then
+        bash "$PLAY_TTS" "$dialogue" "$agent_voice" &
+      else
+        # Fallback to default voice if agent not in voice mapping
+        bash "$PLAY_TTS" "$dialogue" &
+      fi
+    fi
+  done
+}
+
+# Process based on verbosity level
+case "$VERBOSITY" in
+  high)
+    # HIGH: Speak ALL markers (💭 🤔 ✓)
+    # Don't speak ✅ here - that's handled by manual TTS completion call
+    extract_and_speak "💭|🤔|✓"
+    ;;
+
+  medium)
+    # MEDIUM: Speak decisions and findings (🤔 ✓)
+    extract_and_speak "🤔|✓"
+    ;;
+
+  low)
+    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
+    # Don't process any markers
+    ;;
+esac
+
+# BMAD Party Mode Integration (Issue #33)
+# Auto-enabled for BMAD users, opt-out available
+if is_party_mode_enabled; then
+  # Detect party mode activation announcement
+  if echo "$LAST_RESPONSE" | grep -q "🎉 PARTY MODE ACTIVATED! 🎉"; then
+    bash "$PLAY_TTS" "Party Mode Activated! All agents are here for a group discussion!" &
+  fi
+
+  # Detect agent dialogues
+  echo "$LAST_RESPONSE" | detect_and_speak_party_mode_dialogue
+fi
+
+# Exit successfully
+exit 0

package/.claude/hooks/tts-queue-worker.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/tts-queue-worker.sh
+#
+# TTS Queue Worker - Background process that plays queued TTS sequentially
+# Automatically exits when queue is empty for 5 seconds
+
+set -euo pipefail
+
+QUEUE_DIR="/tmp/agentvibes-tts-queue"
+WORKER_PID_FILE="$QUEUE_DIR/worker.pid"
+IDLE_TIMEOUT=5  # Exit after 5 seconds of no new requests
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Trap to clean up on exit
+trap "rm -f $WORKER_PID_FILE" EXIT
+
+# Process queue items
+process_queue() {
+  local idle_count=0
+
+  while true; do
+    # Find oldest queue item
+    local queue_item=$(ls -1 "$QUEUE_DIR"/*.queue 2>/dev/null | sort | head -1)
+
+    if [[ -z "$queue_item" ]]; then
+      # Queue is empty, increment idle counter
+      idle_count=$((idle_count + 1))
+
+      if [[ $idle_count -ge $IDLE_TIMEOUT ]]; then
+        # No new items for timeout period, exit worker
+        exit 0
+      fi
+
+      # Wait 1 second and check again
+      sleep 1
+      continue
+    fi
+
+    # Reset idle counter - we have work
+    idle_count=0
+
+    # Load TTS request
+    source "$queue_item"
+
+    # Decode base64 values
+    TEXT=$(echo -n "$TEXT_B64" | base64 -d)
+    VOICE=$(echo -n "$VOICE_B64" | base64 -d)
+
+    # Play TTS (this blocks until audio finishes due to lock mechanism)
+    if [[ -n "${VOICE:-}" ]]; then
+      bash "$SCRIPT_DIR/play-tts.sh" "$TEXT" "$VOICE" 2>/dev/null || true
+    else
+      bash "$SCRIPT_DIR/play-tts.sh" "$TEXT" 2>/dev/null || true
+    fi
+
+    # Add 2-second pause between speakers for natural conversation flow
+    sleep 2
+
+    # Remove processed item
+    rm -f "$queue_item"
+  done
+}
+
+# Start processing
+process_queue

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

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/tts-queue.sh
+#
+# TTS Queue Manager for Party Mode
+# Queues TTS requests and plays them sequentially in the background
+# This allows Claude to continue generating responses while audio plays in order
+
+set -euo pipefail
+
+QUEUE_DIR="/tmp/agentvibes-tts-queue"
+QUEUE_LOCK="$QUEUE_DIR/queue.lock"
+WORKER_PID_FILE="$QUEUE_DIR/worker.pid"
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Initialize queue directory
+mkdir -p "$QUEUE_DIR"
+
+# @function add_to_queue
+# @intent Add a TTS request to the queue for sequential playback
+# @param $1 dialogue text
+# @param $2 voice name (optional)
+add_to_queue() {
+  local text="$1"
+  local voice="${2:-}"
+
+  # Create unique queue item with timestamp
+  local timestamp=$(date +%s%N)
+  local queue_file="$QUEUE_DIR/$timestamp.queue"
+
+  # Write request to queue file (base64 encoded to handle all special chars)
+  cat > "$queue_file" <<EOF
+TEXT_B64=$(echo -n "$text" | base64 -w0)
+VOICE_B64=$(echo -n "$voice" | base64 -w0)
+EOF
+
+  # Start queue worker if not already running
+  start_worker_if_needed
+}
+
+# @function start_worker_if_needed
+# @intent Start the queue worker process if it's not already running
+start_worker_if_needed() {
+  # Check if worker is already running
+  if [[ -f "$WORKER_PID_FILE" ]]; then
+    local pid=$(cat "$WORKER_PID_FILE")
+    if kill -0 "$pid" 2>/dev/null; then
+      # Worker is running
+      return 0
+    fi
+  fi
+
+  # Start worker in background
+  "$SCRIPT_DIR/tts-queue-worker.sh" &
+  echo $! > "$WORKER_PID_FILE"
+}
+
+# @function clear_queue
+# @intent Clear all pending TTS requests (emergency stop)
+clear_queue() {
+  rm -f "$QUEUE_DIR"/*.queue
+  echo "✅ Queue cleared"
+}
+
+# @function show_queue
+# @intent Display current queue status
+show_queue() {
+  local count=$(ls -1 "$QUEUE_DIR"/*.queue 2>/dev/null | wc -l)
+  echo "📊 Queue status: $count items pending"
+
+  if [[ -f "$WORKER_PID_FILE" ]]; then
+    local pid=$(cat "$WORKER_PID_FILE")
+    if kill -0 "$pid" 2>/dev/null; then
+      echo "✅ Worker process running (PID: $pid)"
+    else
+      echo "❌ Worker process not running"
+    fi
+  else
+    echo "❌ Worker process not running"
+  fi
+}
+
+# Main command dispatcher
+case "${1:-help}" in
+  add)
+    add_to_queue "${2:-}" "${3:-}"
+    ;;
+  clear)
+    clear_queue
+    ;;
+  status)
+    show_queue
+    ;;
+  *)
+    echo "Usage: tts-queue.sh {add|clear|status}"
+    echo ""
+    echo "Commands:"
+    echo "  add <text> [voice]  Add TTS request to queue"
+    echo "  clear               Clear all pending requests"
+    echo "  status              Show queue status"
+    exit 1
+    ;;
+esac

package/.claude/verbosity.txt

@@ -0,0 +1 @@
+high

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.5.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.7.0
 
 ---
 
@@ -94,16 +94,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.5.0 - Verbosity Control System](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.5.0)** 🎉
+**[v2.7.0 - Party Mode Voice Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.7.0)** 🎉
 
-This minor release introduces intelligent verbosity control - giving you precise control over how much Claude speaks while working.
+AgentVibes v2.7.0 transforms BMAD party mode into a professional multi-agent voice conversation system! This release introduces a sophisticated TTS queue architecture enabling sequential voice playback without blocking Claude Code, natural 2-second pauses between speakers, and customizable agent introductions.
 
 **Key highlights:**
-- 🎙️ **Verbosity Control** - Three levels: LOW (minimal), MEDIUM (balanced), HIGH (full transparency)
-- 💭 **Emoji Markers** - Uses 💭 🤔 ✓ for automatic TTS detection
-- ⚙️ **Slash Command** - `/agent-vibes:verbosity [low|medium|high]`
-- 🔌 **MCP Integration** - Control via natural language
-- 🎯 **Smart Detection** - No manual Bash calls needed
+- 🎭 **TTS Queue System** - Sequential non-blocking voice playback for party mode
+- ⏸️ **Natural Speaker Pauses** - 2-second delay between agents for conversation flow
+- 🎤 **Speaker Introductions** - Configurable intro text (e.g., "John, Product Manager here")
+- 📁 **Config Reorganization** - Moved from `.claude/plugins/` to official `.claude/config/`
+- 🐛 **Text Escaping Fixes** - No more "backslash exclamation" in speech
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)