agentvibes 5.6.0 → 5.6.2

package/.agentvibes/config.json

@@ -1,40 +1,5 @@
 {
-  "defaultVoice": "libritts-speaker-925",
-  "ttsProvider": "piper",
-  "provider": "soprano",
-  "backgroundMusic": {
-    "enabled": false,
-    "track": "agent_vibes_japanese_city_pop_v1_loop.mp3",
-    "volume": 20
-  },
-  "music": {
-    "enabled": true,
-    "track": "agentvibes_nature_sounds_rain.mp3"
-  },
-  "musicFavorites": [
-    "agentvibes_blues_smooth_guitar.mp3",
-    "agentvibes_lofi_beats_coding.mp3",
-    "agentvibes_nature_sounds_rain.mp3",
-    "agent_vibes_ganawa_ambient_v2_loop.mp3"
-  ],
-  "effects": {
-    "reverb": true,
-    "reverbAmount": 0.6,
-    "pitch": 2,
-    "reverbPreset": "medium"
-  },
-  "verbosity": "high",
-  "personality": "grandpa",
-  "voice": "en_US-ljspeech-high",
-  "pretext": "Agent Vibes Here",
-  "setupCompleted": true,
-  "ttsEngine": "piper",
-  "thumbsUp": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ],
-  "favorites": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ]
+  "audio_destination": "remote",
+  "audio_ssh_alias": "laptop-win",
+  "setupCompleted": true
 }

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

@@ -55,7 +55,7 @@ default|reverb 20 50 50|agentvibes_soft_flamenco_loop.mp3|0.30
 # Format: llm:<name>|REVERB_PRESET|BACKGROUND_FILE|BACKGROUND_VOLUME|VOICE|PRETEXT|ENGINE|||
 |||
 # Claude Code (claude-code CLI via CLAUDECODE=1 env or AGENTVIBES_LLM=claude-code)|||
-llm:claude-code|||0.15||Agent Vibes Here|piper
+llm:claude-code|off||||Agent Vibes Here|piper
 |||
 # GitHub Copilot Chat (VS Code MCP or AGENTVIBES_LLM=copilot)|||
 llm:copilot|off||||Agent Vibes Here|piper

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

@@ -1 +1 @@
-true
+true

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

@@ -16,12 +16,12 @@ 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
 agent_vibes_arabic_v2_loop.mp3:.00000000000000000006132724
-agent_vibes_chillwave_v2_loop.mp3:14.628390
-agent_vibes_bachata_v1_loop.mp3:.00000000000000000005344000
-agent_vibes_goa_trance_v2_loop.mp3:.00000000000000000002499918
-agentvibes_soft_flamenco_loop.mp3:9.432018
+agent_vibes_cumbia_v1_loop.mp3:.00000000000000000010256000
+agentvibes_soft_flamenco_loop.mp3:7.389660
+agent_vibes_bachata_v1_loop.mp3:5.125714
+agent_vibes_chillwave_v2_loop.mp3:.00000000000000000003308191
+Midnight Charleston Stomp.mp3:.00000000000000000010960000
+agent_vibes_japanese_city_pop_v1_loop.mp3:11.702675

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

@@ -1 +1 @@
-20260428
+20260502

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

@@ -2,8 +2,11 @@
 #
 # File: .claude/hooks/play-tts-ssh-remote.sh
 #
-# AgentVibes - SSH-Remote TTS Provider
-# Sends text to remote device via SSH for local AgentVibes playback
+# AgentVibes - SSH-Remote TTS Provider (v2 — JSON payload)
+# Sends text + effects config to remote device via SSH for local playback
+#
+# The sender reads local audio-effects.cfg and bundles everything into a
+# single base64-encoded JSON payload. The receiver is a thin executor.
 #
 # Copyright (c) 2025 Paul Preibisch
 # Licensed under the Apache License, Version 2.0
@@ -17,74 +20,148 @@ 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
+# Get script directory and project root
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 
+# Derive project name from directory
+PROJECT_NAME=$(basename "$PROJECT_ROOT")
+
+# ---------------------------------------------------------------------------
 # 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
+  echo "SSH-Remote host not configured" >&2
+  echo "Set host: echo 'my-host' > .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)
+# SECURITY: Validate SSH_HOST format
 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
+  echo "Invalid SSH host format: $SSH_HOST" >&2
   exit 1
 fi
 
-# SECURITY: Validate VOICE to prevent injection (alphanumeric, hyphens, underscores only)
+# SECURITY: Validate VOICE
 if [[ ! "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]]; then
-  echo "❌ Invalid voice format: $VOICE" >&2
+  echo "Invalid voice format: $VOICE" >&2
   exit 1
 fi
 
-# SECURITY: Validate AGENT_NAME to prevent injection (alphanumeric, hyphens, underscores, spaces only)
+# SECURITY: Validate AGENT_NAME
 if [[ ! "$AGENT_NAME" =~ ^[a-zA-Z0-9_\ -]+$ ]]; then
-  echo "❌ Invalid agent name format: $AGENT_NAME" >&2
+  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
-
-# Determine which receiver script exists and send encoded text, voice, and agent name
-# SECURITY: Base64-encoded values are safe to pass as arguments (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' '$ENCODED_AGENT'" &
-  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' '$ENCODED_AGENT'" &
-  SSH_PID=$!
+# ---------------------------------------------------------------------------
+# Read audio effects config for this agent
+# ---------------------------------------------------------------------------
+
+SOX_EFFECTS=""
+BG_FILE=""
+BG_VOLUME="0.10"
+
+EFFECTS_CFG="$PROJECT_ROOT/.claude/config/audio-effects.cfg"
+if [[ -f "$EFFECTS_CFG" ]]; then
+  CONFIG_LINE=$(grep "^${AGENT_NAME}|" "$EFFECTS_CFG" 2>/dev/null || \
+                grep "^default|" "$EFFECTS_CFG" 2>/dev/null || true)
+  if [[ -n "$CONFIG_LINE" ]]; then
+    IFS='|' read -r _ SOX_EFFECTS BG_FILE BG_VOLUME <<< "$CONFIG_LINE"
+  fi
+fi
+
+# Read pretext if configured
+PRETEXT=""
+PRETEXT_FILE="$PROJECT_ROOT/.agentvibes/config/pretext.txt"
+if [[ -f "$PRETEXT_FILE" ]]; then
+  PRETEXT=$(cat "$PRETEXT_FILE" 2>/dev/null || true)
+fi
+
+# Read speed if configured
+SPEED=""
+SPEED_FILE="$PROJECT_ROOT/.agentvibes/config/speed.txt"
+if [[ -f "$SPEED_FILE" ]]; then
+  SPEED=$(cat "$SPEED_FILE" 2>/dev/null || true)
+fi
+
+# Read the TTS provider the RECEIVER should use to generate audio.
+# This is separate from the sender's own provider (which is "ssh-remote").
+# Check receiver-provider.txt first, then fall back to "piper".
+PROVIDER=""
+RECEIVER_PROVIDER_FILE="$PROJECT_ROOT/.agentvibes/config/receiver-provider.txt"
+if [[ -f "$RECEIVER_PROVIDER_FILE" ]]; then
+  PROVIDER=$(cat "$RECEIVER_PROVIDER_FILE" 2>/dev/null || true)
+fi
+# Also check home-level config
+if [[ -z "$PROVIDER" ]]; then
+  RECEIVER_PROVIDER_FILE="$HOME/.agentvibes/config/receiver-provider.txt"
+  if [[ -f "$RECEIVER_PROVIDER_FILE" ]]; then
+    PROVIDER=$(cat "$RECEIVER_PROVIDER_FILE" 2>/dev/null || true)
+  fi
+fi
+# Validate — only known TTS providers (not transport providers like ssh-remote)
+case "${PROVIDER:-}" in
+  piper|soprano|macos|windows-sapi) ;;
+  *) PROVIDER="piper" ;;
+esac
+
+# ---------------------------------------------------------------------------
+# Build JSON payload
+# ---------------------------------------------------------------------------
+
+# SECURITY: Use jq if available for safe JSON construction, else manual escaping
+build_json_payload() {
+  if command -v jq &>/dev/null; then
+    jq -n \
+      --arg text "$TEXT" \
+      --arg voice "$VOICE" \
+      --arg effects "$SOX_EFFECTS" \
+      --arg music "$BG_FILE" \
+      --arg volume "$BG_VOLUME" \
+      --arg project "$PROJECT_NAME" \
+      --arg pretext "$PRETEXT" \
+      --arg speed "$SPEED" \
+      --arg provider "$PROVIDER" \
+      '{text: $text, voice: $voice, effects: $effects, music: $music, volume: $volume, project: $project, pretext: $pretext, speed: $speed, provider: $provider}'
+  else
+    # Manual JSON — escape double quotes and backslashes in text
+    local escaped_text
+    escaped_text=$(printf '%s' "$TEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g')
+    local escaped_pretext
+    escaped_pretext=$(printf '%s' "$PRETEXT" | sed 's/\\/\\\\/g; s/"/\\"/g')
+    printf '{"text":"%s","voice":"%s","effects":"%s","music":"%s","volume":"%s","project":"%s","pretext":"%s","speed":"%s","provider":"%s"}' \
+      "$escaped_text" "$VOICE" "$SOX_EFFECTS" "$BG_FILE" "$BG_VOLUME" "$PROJECT_NAME" "$escaped_pretext" "$SPEED" "$PROVIDER"
+  fi
+}
+
+JSON_PAYLOAD=$(build_json_payload)
+
+# SECURITY: Base64-encode entire payload — safe for SSH transport
+# base64 -w 0 is Linux (GNU coreutils), -b 0 is macOS (BSD)
+if base64 --help 2>&1 | grep -q '\-w'; then
+  ENCODED_PAYLOAD=$(printf '%s' "$JSON_PAYLOAD" | base64 -w 0)
 else
-  echo "⚠️  Receiver script not found on $SSH_HOST" >&2
-  echo "💡 Install: agentvibes install --ssh-receiver" >&2
-  exit 1
+  ENCODED_PAYLOAD=$(printf '%s' "$JSON_PAYLOAD" | base64 -b 0 2>/dev/null || printf '%s' "$JSON_PAYLOAD" | base64 | tr -d '\n')
 fi
 
-# Log the background PID for debugging (non-blocking)
-echo "✓ Sent to $SSH_HOST (PID: $SSH_PID, playing remotely)" >&2
+# ---------------------------------------------------------------------------
+# Send to receiver via SSH (fire and forget — backgrounded)
+# ---------------------------------------------------------------------------
+
+echo "Sending to $SSH_HOST..." >&2
+
+# ForceCommand receiver: SSH_ORIGINAL_COMMAND passes the payload directly
+ssh "$SSH_HOST" "$ENCODED_PAYLOAD" &
+SSH_PID=$!
+
+echo "Sent to $SSH_HOST (PID: $SSH_PID)" >&2
 exit 0

package/.claude/hooks/play-tts-windows-receiver.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+#
+# play-tts-windows-receiver.sh
+# Sends TTS to Windows AgentVibes receiver via SSH.
+# The Windows receiver expects bare base64-encoded text as the SSH command.
+#
+set -euo pipefail
+
+TEXT="${1:-}"
+VOICE="${2:-}"
+
+[[ -z "$TEXT" ]] && { echo 'No text' >&2; exit 1; }
+
+# Get host
+HOST=$(cat "$HOME/.claude/windows-receiver-host.txt" 2>/dev/null || echo '')
+[[ -z "$HOST" ]] && { echo '❌ No host: set ~/.claude/windows-receiver-host.txt' >&2; exit 1; }
+
+# Validate host
+[[ "$HOST" =~ ^[a-zA-Z0-9][a-zA-Z0-9._-]*$ ]] || { echo '❌ Invalid host' >&2; exit 1; }
+
+# Strip markdown/emojis
+TEXT=$(printf '%s' "$TEXT" | perl -CSD -pe '
+  s/[\x{1F300}-\x{1F9FF}]//g;
+  s/[\x{2600}-\x{27BF}]//g;
+  s/\*+//g; s/#+\s*//g; s/`//g;
+' 2>/dev/null || printf '%s' "$TEXT")
+
+ENCODED=$(printf '%s' "$TEXT" | base64 -w 0)
+
+echo "🖥️ Sending to Windows receiver ($HOST)…" >&2
+RESULT=$(ssh "$HOST" "$ENCODED" 2>&1) && echo "✓ $RESULT" >&2 || echo "⚠️ $RESULT" >&2 &

package/.claude/hooks/stop.sh

@@ -32,32 +32,7 @@ fi
 # Only run stop hook in LITE mode
 # (Full mode uses tool calls for TTS, not stop hooks)
 if [[ "$CURRENT_MODE" == "lite" ]]; then
-  # Claude Code sends JSON on stdin: {"transcript_path": "..."}
-  HOOK_INPUT=$(cat)
-  TRANSCRIPT_PATH=$(echo "$HOOK_INPUT" | jq -r '.transcript_path // empty' 2>/dev/null || true)
-
-  [[ -z "$TRANSCRIPT_PATH" ]] && exit 0
-  [[ ! -f "$TRANSCRIPT_PATH" ]] && exit 0
-
-  # Extract Audio Summary ONLY from the most recent assistant response.
-  # Key insight: we must NOT search earlier responses — if the latest response
-  # has no Audio Summary: marker, we stay silent (no stale replay).
-  SUMMARY=$(jq --slurp -r '
-    [.[] | try select(.message.role == "assistant")] | last // null
-    | if . == null then "" else
-        [.message.content[]? | select(.type == "text") | .text] | join("\n")
-      end
-    | if test("[Aa]udio [Ss]ummary:") then . else "" end
-  ' "$TRANSCRIPT_PATH" 2>/dev/null \
-    | sed -n 's/.*[Aa]udio [Ss]ummary:[[:space:]]*\(.*\)/\1/p' \
-    | head -1 \
-    | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-  [[ -z "$SUMMARY" ]] && exit 0
-
-  # Speak via AgentVibes play-tts.sh
-  if [[ -f "$PROJECT_ROOT/.claude/hooks/play-tts.sh" ]]; then
-    AGENTVIBES_MIN_TOKENS=3 AGENTVIBES_SHORT_TOKENS=50 \
-      bash "$PROJECT_ROOT/.claude/hooks/play-tts.sh" "$SUMMARY" >/dev/null 2>&1 &
+  if [[ -f "$AGENTVIBES_HOOKS/stop-lite.sh" ]]; then
+    bash "$AGENTVIBES_HOOKS/stop-lite.sh" "$@"
   fi
 fi

package/.claude/hooks-windows/play-tts-windows-sapi.ps1

@@ -1,108 +1,108 @@
-#
-# File: .claude/hooks-windows/play-tts-windows-sapi.ps1
-#
-# AgentVibes - Windows SAPI TTS Provider (Zero Dependencies)
-# Uses built-in Windows System.Speech API
-#
-
-param(
-    [Parameter(Mandatory = $true)]
-    [string]$Text,
-
-    [Parameter(Mandatory = $false)]
-    [string]$VoiceOverride
-)
-
-# Configuration paths
-$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
-
-if (Test-Path $ProjectClaudeDir) {
-    $ClaudeDir = $ProjectClaudeDir
-} else {
-    $ClaudeDir = "$env:USERPROFILE\.claude"
-}
-
-$AudioDir = "$ClaudeDir\audio"
-$VoiceFile = "$ClaudeDir\tts-voice-sapi.txt"
-
-# Ensure directories exist
-if (-not (Test-Path $AudioDir)) {
-    New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
-}
-
-# Load System.Speech assembly
-try {
-    Add-Type -AssemblyName System.Speech
-}
-catch {
-    Write-Host "[ERROR] System.Speech assembly not available" -ForegroundColor Red
-    exit 1
-}
-
-# Determine voice to use
-$VoiceName = ""
-
-if ($VoiceOverride) {
-    $VoiceName = $VoiceOverride
-}
-elseif (Test-Path $VoiceFile) {
-    $VoiceName = (Get-Content $VoiceFile -Raw).Trim()
-}
-
-# Initialize speech synthesizer
-$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
-
-# Set voice if specified
-if ($VoiceName) {
-    try {
-        $synth.SelectVoice($VoiceName)
-    }
-    catch {
-        Write-Host "[WARNING] Voice '$VoiceName' not found, using default" -ForegroundColor Yellow
-    }
-}
-
-# Sanitize text for speech - strip shell metacharacters, PS special chars, and SSML tags
-$Text = $Text -replace '\\', ' '
-$Text = $Text -replace '[{}<>|`~^$;"''()]', ''
-$Text = $Text -replace '&[a-zA-Z]+;', ''
-$Text = $Text -replace '\s+', ' '
-$Text = $Text.Trim()
-
-# Get actual voice name (after selection or default)
-$ActualVoice = $synth.Voice.Name
-
-# Create audio file path
-$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
-$AudioFile = "$AudioDir\tts-$Timestamp.wav"
-
-# Save to WAV file with proper resource cleanup
-$player = $null
-try {
-    $synth.SetOutputToWaveFile($AudioFile)
-    $synth.Speak($Text)
-
-    # Display results
-    Write-Host "[OK] Saved to: $AudioFile" -ForegroundColor Green
-    Write-Host "[VOICE] Voice used: $ActualVoice (Windows SAPI)" -ForegroundColor Green
-
-    # Play the audio using built-in Windows audio player (skip if AGENTVIBES_NO_PLAY is set)
-    if (-not $env:AGENTVIBES_NO_PLAY) {
-        try {
-            $player = New-Object System.Media.SoundPlayer $AudioFile
-            $player.PlaySync()
-        }
-        catch {
-            Write-Host "[WARNING] Could not play audio (SoundPlayer unavailable)" -ForegroundColor Yellow
-        }
-    }
-}
-catch {
-    Write-Host "[ERROR] Error synthesizing speech: $_" -ForegroundColor Red
-    exit 1
-}
-finally {
-    if ($synth) { $synth.Dispose() }
-    if ($player) { $player.Dispose() }
-}
+#
+# File: .claude/hooks-windows/play-tts-windows-sapi.ps1
+#
+# AgentVibes - Windows SAPI TTS Provider (Zero Dependencies)
+# Uses built-in Windows System.Speech API
+#
+
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$Text,
+
+    [Parameter(Mandatory = $false)]
+    [string]$VoiceOverride
+)
+
+# Configuration paths
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+
+if (Test-Path $ProjectClaudeDir) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
+
+$AudioDir = "$ClaudeDir\audio"
+$VoiceFile = "$ClaudeDir\tts-voice-sapi.txt"
+
+# Ensure directories exist
+if (-not (Test-Path $AudioDir)) {
+    New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
+}
+
+# Load System.Speech assembly
+try {
+    Add-Type -AssemblyName System.Speech
+}
+catch {
+    Write-Host "[ERROR] System.Speech assembly not available" -ForegroundColor Red
+    exit 1
+}
+
+# Determine voice to use
+$VoiceName = ""
+
+if ($VoiceOverride) {
+    $VoiceName = $VoiceOverride
+}
+elseif (Test-Path $VoiceFile) {
+    $VoiceName = (Get-Content $VoiceFile -Raw).Trim()
+}
+
+# Initialize speech synthesizer
+$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+
+# Set voice if specified
+if ($VoiceName) {
+    try {
+        $synth.SelectVoice($VoiceName)
+    }
+    catch {
+        Write-Host "[WARNING] Voice '$VoiceName' not found, using default" -ForegroundColor Yellow
+    }
+}
+
+# Sanitize text for speech - strip shell metacharacters, PS special chars, and SSML tags
+$Text = $Text -replace '\\', ' '
+$Text = $Text -replace '[{}<>|`~^$;"''()]', ''
+$Text = $Text -replace '&[a-zA-Z]+;', ''
+$Text = $Text -replace '\s+', ' '
+$Text = $Text.Trim()
+
+# Get actual voice name (after selection or default)
+$ActualVoice = $synth.Voice.Name
+
+# Create audio file path
+$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
+$AudioFile = "$AudioDir\tts-$Timestamp.wav"
+
+# Save to WAV file with proper resource cleanup
+$player = $null
+try {
+    $synth.SetOutputToWaveFile($AudioFile)
+    $synth.Speak($Text)
+
+    # Display results
+    Write-Host "[OK] Saved to: $AudioFile" -ForegroundColor Green
+    Write-Host "[VOICE] Voice used: $ActualVoice (Windows SAPI)" -ForegroundColor Green
+
+    # Play the audio using built-in Windows audio player (skip if AGENTVIBES_NO_PLAY is set)
+    if (-not $env:AGENTVIBES_NO_PLAY) {
+        try {
+            $player = New-Object System.Media.SoundPlayer $AudioFile
+            $player.PlaySync()
+        }
+        catch {
+            Write-Host "[WARNING] Could not play audio (SoundPlayer unavailable)" -ForegroundColor Yellow
+        }
+    }
+}
+catch {
+    Write-Host "[ERROR] Error synthesizing speech: $_" -ForegroundColor Red
+    exit 1
+}
+finally {
+    if ($synth) { $synth.Dispose() }
+    if ($player) { $player.Dispose() }
+}