agentvibes 3.1.0 → 3.3.0-alpha.1

package/.claude/config/audio-effects.cfg

@@ -1,52 +1,52 @@
-# AgentVibes Audio Effects Configuration
+# AgentVibes Audio Effects Configuration|||
 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
-#
-# SOX_EFFECTS: sox effect chain (leave empty for none)
-#   - reverb <reverberance> <HF-damping> <room-scale>
-#   - pitch <cents> (100 cents = 1 semitone)
-#   - equalizer <freq> <width>q <gain-dB>
-#   - gain <dB>
-#   - compand <attack,decay> <soft-knee-dB:in-dB,out-dB>
-#
-# BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)
-# BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)
-#
+#|||
+# SOX_EFFECTS: sox effect chain (leave empty for none)|||
+#   - reverb <reverberance> <HF-damping> <room-scale>|||
+#   - pitch <cents> (100 cents = 1 semitone)|||
+#   - equalizer <freq> <width>q <gain-dB>|||
+#   - gain <dB>|||
+#   - compand <attack,decay> <soft-knee-dB:in-dB,out-dB>|||
+#|||
+# BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)|||
+# BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)|||
+#|||
 # Example: John|reverb 30 50 80|my-track.mp3|0.25
-
-# BMAD Agents - each with unique audio personality
-
-# PM John - upbeat, driving energy
+|||
+# BMAD Agents - each with unique audio personality|||
+|||
+# PM John - upbeat, driving energy|||
 John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.30
-
-# Architect Winston - deep, authoritative
+|||
+# Architect Winston - deep, authoritative|||
 Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Developer Amelia - clean, precise
+|||
+# Developer Amelia - clean, precise|||
 Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Business Analyst Mary - warm, analytical
+|||
+# Business Analyst Mary - warm, analytical|||
 Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Scrum Master Bob - refined, organized
+|||
+# Scrum Master Bob - refined, organized|||
 Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Test Architect Murat - crisp, analytical
+|||
+# Test Architect Murat - crisp, analytical|||
 Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# UX Designer Sally - warm, empathetic
+|||
+# UX Designer Sally - warm, empathetic|||
 Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Tech Writer Paige - clear, patient
+|||
+# Tech Writer Paige - clear, patient|||
 Paige|compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.20
-
-# Frame Expert Saif - structured, detail-oriented
+|||
+# Frame Expert Saif - structured, detail-oriented|||
 Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# BMad Master - wise orchestrator
+|||
+# BMad Master - wise orchestrator|||
 BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30
-
-# Party mode room ambiance - used when multiple agents are talking
+|||
+# Party mode room ambiance - used when multiple agents are talking|||
 _party_mode|compand 0.3,1 6:-70,-60,-20|agent_vibes_dark_chill_step_loop.mp3|0.40
-
-# Default (no agent specified) - clean with Bachata background
-default||agent_vibes_bachata_v1_loop.mp3|0.30
+|||
+# Default (no agent specified) - clean with Bachata background|||
+default|reverb 20 50 50|agent_vibes_ganawa_ambient_v2_loop.mp3|0.30

package/.claude/config/audio-effects.cfg.sample

@@ -11,7 +11,7 @@
 # BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)
 # BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)
 #
-# Example: John|reverb 30 50 80|my-track.mp3|0.25
+# Example: John|reverb 30 50 80|my-track.mp3|0.10
 
 # BMAD Agents - each with unique audio personality
 
@@ -19,28 +19,28 @@
 John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.30
 
 # Architect Winston - deep, authoritative
-Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.25
+Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Developer Amelia - clean, precise
-Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Business Analyst Mary - warm, analytical
-Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.25
+Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Scrum Master Bob - refined, organized
-Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Test Architect Murat - crisp, analytical
-Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # UX Designer Sally - warm, empathetic
-Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
+Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Tech Writer Paige - clear, patient
 Paige|compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.20
 
 # Frame Expert Saif - structured, detail-oriented
-Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
+Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # BMad Master - wise orchestrator
 BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30

package/.claude/config/background-music-enabled.txt

@@ -0,0 +1 @@
+true

package/.claude/config/background-music-position.txt

@@ -1,26 +1,10 @@
-agent-vibes-dark-chill-step.mp3:49.006169
-Agent Vibes Japanese City Pop v1.mp3:29.392744
-Agent Vibes ChillWave v2.mp3:22.154467
-Agent Vibes Bossa Nova v2.mp3:23.733424
-Agent Vibes Tabla Dream Pop v1.mp3:19.101043
-Agent Vibes Hawaiian slack key guitar v2.mp3:36.381950
-AgentVibes Soft Flamenco.mp3:23.160000
-Agent Vibes Arabic v2.mp3:21.922268
-Agent Vibes Goa Trance v2.mp3:55.953741
-Agent Vibes Ganawa Ambient v2.mp3:39.680205
-Agent Vibes Celtic Harp v1.mp3:42.190476
-Agent Vibes Harpsichord v2.mp3:21.739410
-Agent Vibes Japanese City Pop v1-loop.mp3:13.917551
-Agent Vibes Hawaiian slack key guitar v2-loop.mp3:12.977143
-Agent Vibes Ganawa Ambient v2-loop.mp3:.00000000000000000002815996
-Agent Vibes Tabla Dream Pop v1-loop.mp3:.00000000000000000009067943
-Agent Vibes ChillWave v2-loop.mp3:.00000000000000000007080511
-Agent Vibes Harpsichord v2-loop.mp3:.00000000000000000013140818
-agent_vibes_japanese_city_pop_v1_loop.mp3:6.054512
-agent_vibes_bossa_nova_v2_loop.mp3:5.369524
-agent_vibes_salsa_v2_loop.mp3:9.972790
-agent_vibes_cumbia_v1_loop.mp3:5.717823
-agentvibes_soft_flamenco_loop.mp3:4.998005
-agent_vibes_arabic_v2_loop.mp3:.00000000000000000006132724
-agent_vibes_chillwave_v2_loop.mp3:14.628390
-agent_vibes_bachata_v1_loop.mp3:.00000000000000000005344000
+agent_vibes_bachata_v1_loop.mp3:5.079274
+agentvibes_soft_flamenco_loop.mp3:5.090884
+agent_vibes_bossa_nova_v2_loop.mp3:10.019683
+agent_vibes_celtic_harp_v1_loop.mp3:9.868753
+agent_vibes_chillwave_v2_loop.mp3:9.694603
+agent_vibes_cumbia_v1_loop.mp3:9.613333
+agent_vibes_dark_chill_step_loop.mp3:9.415964
+agent_vibes_goa_trance_v2_loop.mp3:9.926803
+agent_vibes_harpsichord_v2_loop.mp3:10.031293
+agent_vibes_ganawa_ambient_v2_loop.mp3:5.741043

package/.claude/config/background-music-volume.txt

@@ -1 +1 @@
-0.30
+0.10

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

@@ -1 +1 @@
-20260122
+20260130

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

@@ -305,23 +305,40 @@ main() {
     # Parse config (format: NAME|EFFECTS|BACKGROUND|VOLUME)
     IFS='|' read -r _ sox_effects background_file bg_volume <<< "$config"
 
-    # Temporary files (using explicit paths to avoid unbound variable issues)
-    # Use Termux-compatible temp directory if on Termux, otherwise standard /tmp
+    # SECURITY: Use secure temp directory per CLAUDE.md guidelines
+    # Prefer XDG_RUNTIME_DIR (user-owned, restricted permissions)
+    # Fall back to user-specific directory in /tmp
     local TEMP_DIR
     if [[ -d "/data/data/com.termux" ]]; then
-        # On Termux
-        TEMP_DIR="${TMPDIR:-${PREFIX}/tmp}"
+        # On Termux - use Termux temp
+        TEMP_DIR="${TMPDIR:-${PREFIX:-/data/data/com.termux/files/usr}/tmp}/agentvibes-audio-$$"
+    elif [[ -n "${XDG_RUNTIME_DIR:-}" ]] && [[ -d "$XDG_RUNTIME_DIR" ]]; then
+        # Preferred: XDG_RUNTIME_DIR (user-owned, 700 permissions)
+        TEMP_DIR="$XDG_RUNTIME_DIR/agentvibes-audio"
     else
-        # Standard Linux/macOS
-        TEMP_DIR="${TMPDIR:-/tmp}"
+        # Fallback: user-specific directory in /tmp
+        TEMP_DIR="/tmp/agentvibes-audio-${USER:-$(id -un)}"
     fi
+
+    # Create temp directory with restrictive permissions
+    mkdir -p "$TEMP_DIR"
+    chmod 700 "$TEMP_DIR"
+
+    # SECURITY: Verify ownership of temp directory
+    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
+
+    # SECURITY: Use mktemp for unpredictable filenames
     local temp_effects
     local temp_final
-    temp_effects="$TEMP_DIR/agentvibes-effects-$$.wav"
-    temp_final="$TEMP_DIR/agentvibes-final-$$.wav"
+    temp_effects=$(mktemp "$TEMP_DIR/effects-XXXXXX.wav")
+    temp_final=$(mktemp "$TEMP_DIR/final-XXXXXX.wav")
 
-    # Clean up on exit using explicit paths
-    trap 'rm -f "'"$TEMP_DIR"'/agentvibes-effects-'"$$"'.wav" "'"$TEMP_DIR"'/agentvibes-final-'"$$"'.wav"' 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

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

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/play-tts-ssh-remote.sh
+#
+# AgentVibes - SSH-Remote TTS Provider
+# Sends text to remote device via SSH for local AgentVibes playback
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+
+# Validate required input
+if [[ -z "$TEXT" ]]; then
+  echo "❌ No text provided" >&2
+  echo "Usage: $0 <text> [voice]" >&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/ssh-remote-host.txt" 2>/dev/null || \
+           cat "$HOME/.claude/ssh-remote-host.txt" 2>/dev/null || echo "")
+
+if [[ -z "$SSH_HOST" ]]; then
+  echo "❌ SSH-Remote host not configured" >&2
+  echo "💡 Set host: echo 'android' > ~/.claude/ssh-remote-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: Encode text as base64 to prevent command injection
+# The receiver will decode this safely
+ENCODED_TEXT=$(printf '%s' "$TEXT" | base64 -w 0)
+
+# Send text to remote for local AgentVibes playback
+echo "📱 Sending to $SSH_HOST for local playback..." >&2
+
+# Determine which receiver script exists and send encoded text
+# SECURITY: Base64-encoded text is safe to pass as argument (no shell metacharacters)
+# The receiver auto-detects and decodes base64 input
+if ssh "$SSH_HOST" "test -f ~/.termux/agentvibes-play.sh" 2>/dev/null; then
+  ssh "$SSH_HOST" "bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE'" &
+  SSH_PID=$!
+elif ssh "$SSH_HOST" "test -f ~/.agentvibes/play-remote.sh" 2>/dev/null; then
+  ssh "$SSH_HOST" "bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE'" &
+  SSH_PID=$!
+else
+  echo "⚠️  Receiver script not found on $SSH_HOST" >&2
+  echo "💡 Install: agentvibes install --ssh-receiver" >&2
+  exit 1
+fi
+
+# Log the background PID for debugging (non-blocking)
+echo "✓ Sent to $SSH_HOST (PID: $SSH_PID, playing remotely)" >&2
+exit 0

package/.claude/piper-voices-dir.txt

@@ -1 +1 @@
-/home/fire/.claude/piper-voices
+/home/administrator/.claude/piper-voices

package/.clawdbot/README.md

@@ -0,0 +1,105 @@
+# Clawdbot Integration
+
+AgentVibes TTS integration for Clawdbot - the AI assistant framework.
+
+## What is Clawdbot?
+
+Clawdbot is a powerful AI assistant framework that connects Claude AI to messaging platforms (WhatsApp, Telegram, Discord, etc.) and provides extensible skills.
+
+**Website**: https://clawd.bot
+**GitHub**: https://github.com/clawdbot/clawdbot
+
+## AgentVibes + Clawdbot
+
+This integration provides Clawdbot with professional TTS capabilities using AgentVibes:
+
+- **Free & Offline**: No API costs, works without internet
+- **50+ Voices**: Professional AI voices in 30+ languages
+- **Remote SSH Support**: Audio tunnels from server to local machine
+- **Zero Setup**: Automatic when AgentVibes is installed
+
+## Installation
+
+```bash
+npx agentvibes install
+```
+
+That's it! AgentVibes is ready to use.
+
+## Usage from Clawdbot
+
+Once installed, use AgentVibes for TTS:
+
+```bash
+npx agentvibes speak "Hello from Clawdbot"
+```
+
+## Features
+
+- **Automatic Detection**: Clawdbot automatically uses AgentVibes when available
+- **Voice Selection**: 50+ voices across 30+ languages
+- **SSH Tunneling**: Audio plays on local machine from remote servers
+- **Zero Config**: Works out of the box once AgentVibes is installed
+
+## Remote SSH Audio
+
+When running Clawdbot on a remote server, set up PulseAudio tunneling so audio plays on your local machine:
+
+**Quick Setup:**
+
+1. **Remote server** (`~/.bashrc`):
+```bash
+export PULSE_SERVER=tcp:localhost:14713
+```
+
+2. **Local machine** (`~/.ssh/config`):
+```
+Host your-server
+    RemoteForward 14713 localhost:14713
+```
+
+3. **Connect and test**:
+```bash
+ssh your-server
+agentvibes speak "Testing remote audio"
+```
+
+**Full guide**: https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md
+
+## Documentation
+
+- **Skill Documentation**: [skill/SKILL.md](skill/SKILL.md)
+- **AgentVibes Docs**: https://agentvibes.org
+- **Clawdbot Docs**: https://docs.clawd.bot
+
+## Architecture
+
+```
+Clawdbot Request
+    ↓
+AgentVibes Skill (this)
+    ↓
+AgentVibes CLI (agentvibes speak)
+    ↓
+Piper TTS Engine
+    ↓
+PulseAudio → SSH Tunnel → Local Speakers
+```
+
+## Development
+
+The skill is automatically packaged with AgentVibes npm releases. To update:
+
+1. Edit `skill/SKILL.md`
+2. Test with Clawdbot
+3. Commit to AgentVibes repo
+4. Publish new AgentVibes version
+
+## Support
+
+- **AgentVibes Issues**: https://github.com/paulpreibisch/AgentVibes/issues
+- **Clawdbot Issues**: https://github.com/clawdbot/clawdbot/issues
+
+## License
+
+Apache 2.0 - Same as AgentVibes