agentvibes 5.6.1 → 5.6.2

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

@@ -1 +1 @@
-20260501
+20260502

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

@@ -97,6 +97,16 @@ if (Test-Path $BgEnabledFile) {
     $BgEnabled = (Get-Content $BgEnabledFile -Raw).Trim() -eq "true"
 }
 
+# Per-message overrides from SSH/remote payload (set by the queue watcher).
+# These allow remote senders (Hermes, SSH remote provider) to override music,
+# volume, and effects for a single message without mutating persistent config.
+$OverrideMusic   = if ($env:AGENTVIBES_OVERRIDE_MUSIC)   { $env:AGENTVIBES_OVERRIDE_MUSIC.Trim() }   else { "" }
+$OverrideVolume  = if ($env:AGENTVIBES_OVERRIDE_VOLUME)  { $env:AGENTVIBES_OVERRIDE_VOLUME.Trim() }  else { "" }
+$OverrideEffects = if ($env:AGENTVIBES_OVERRIDE_EFFECTS) { $env:AGENTVIBES_OVERRIDE_EFFECTS.Trim() } else { "" }
+
+# If a music override is set, force background music on for this message
+if ($OverrideMusic -ne "") { $BgEnabled = $true }
+
 # Check if reverb is enabled (allowlist validation)
 $ReverbLevel = "off"
 $ReverbFile = "$ConfigDir\reverb-level.txt"
@@ -106,6 +116,12 @@ if (Test-Path $ReverbFile) {
         $ReverbLevel = $reverbVal
     }
 }
+# Per-message reverb override: AGENTVIBES_OVERRIDE_EFFECTS accepts a preset name
+# ("off", "light", "medium", "heavy", "cathedral") — Sox effect strings are Linux-only
+# and are silently ignored on Windows.
+if ($OverrideEffects -ne "" -and $OverrideEffects -in @("off", "light", "medium", "heavy", "cathedral")) {
+    $ReverbLevel = $OverrideEffects
+}
 $HasReverb = $ReverbLevel -ne "off"
 
 # Check ffmpeg availability for background music mixing or reverb
@@ -380,6 +396,21 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                     $DefaultTrack = $configTrack
                 }
             }
+            # Per-message music override from remote payload (e.g. Hermes, SSH remote)
+            # Accepts full filename (e.g. "agent_vibes_bachata_v1_loop.mp3") or a
+            # keyword (e.g. "bachata") — keyword triggers a glob search in TracksDir.
+            if ($OverrideMusic -ne "") {
+                if ($OverrideMusic -match '^[a-zA-Z0-9_\-\.]+$') {
+                    if ($OverrideMusic -match '\.mp3$') {
+                        # Full filename — use directly
+                        $DefaultTrack = $OverrideMusic
+                    } else {
+                        # Keyword — find first matching track file
+                        $matched = Get-ChildItem -Path $TracksDir -Filter "*$OverrideMusic*" -File -ErrorAction SilentlyContinue | Select-Object -First 1
+                        if ($matched) { $DefaultTrack = $matched.Name }
+                    }
+                }
+            }
             $BgTrackPath = Join-Path $TracksDir $DefaultTrack
             # Path containment: verify resolved path stays within tracks directory
             $ResolvedBgTrack = [System.IO.Path]::GetFullPath($BgTrackPath)
@@ -388,13 +419,16 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                 $BgTrackPath = Join-Path $TracksDir "agent_vibes_bachata_v1_loop.mp3"
             }
 
-            # Get volume (default 0.25)
+            # Get volume (default 0.25) — per-message override takes precedence
             $BgVolume = "0.25"
             $VolumeFile = "$ConfigDir\background-music-volume.txt"
             if (Test-Path $VolumeFile) {
                 $vol = (Get-Content $VolumeFile -Raw).Trim()
                 if ($vol -match '^\d+\.?\d*$') { $BgVolume = $vol }
             }
+            if ($OverrideVolume -ne "" -and $OverrideVolume -match '^\d+\.?\d*$') {
+                $BgVolume = $OverrideVolume
+            }
 
             if (Test-Path $BgTrackPath) {
                 $MixedFile = $RecentWav.FullName -replace '\.wav$', '-mixed.wav'

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**: v5.6.1
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.6.2
 
 ---
 
@@ -40,7 +40,11 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.6.1 — Hermes Agent Integration
+## 🌟 NEW IN v5.6.2 — Per-Message Audio Control
+
+Remote senders (Hermes, SSH remote provider) can now control **voice, music, reverb, and volume per message** — no persistent config changes needed. Pass any field in the JSON payload and the Windows receiver applies it for that message only.
+
+## v5.6.1 — Hermes Agent Integration
 
 AgentVibes now speaks for **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** — the self-hosted, self-improving AI assistant. Two production-ready skills ship in `docs/hermes/skills/`:
 

package/RELEASE_NOTES.md

@@ -1,5 +1,31 @@
 # AgentVibes Release Notes
 
+## 🎛️ v5.6.2 — Per-Message Audio Control for Remote Providers
+
+**Released:** 2026-05-02
+
+### 🎉 Per-Message Override: Voice, Music, Reverb, Volume
+
+Remote senders (Hermes, SSH remote provider) can now control every audio parameter **per message** without touching the receiver's persistent config:
+
+- **Music** — pass `"music": "bachata"` (keyword) or full filename to switch background track for that message
+- **Volume** — pass `"volume": "0.35"` to adjust music volume for that message  
+- **Reverb** — pass `"effects": "medium"` (`off`/`light`/`medium`/`heavy`/`cathedral`) to set reverb per message
+- **Voice** — already worked; now documented with full field reference
+- **Pretext** — pass `"pretext": ""` to suppress the intro prefix for a single message
+
+Previously these fields were parsed by the receiver and queued but **never applied** — `play-tts.ps1` didn't read the `AGENTVIBES_OVERRIDE_*` env vars the watcher set. Fixed.
+
+### 📚 Hermes Skill: Full Payload Field Reference
+
+`agentvibes-target` SKILL.md now documents all 9 JSON payload fields with examples so Hermes (or any AI agent) can say "switch to chillwave", "add reverb", "use a female voice", "remove the intro prefix" — and it just works.
+
+### 🐛 Hermes Hook: handler.py + HOOK.yaml now ship in the package
+
+`docs/hermes/skills/tts/hermes-agentvibes-hook/` was missing `handler.py` and `HOOK.yaml` — only `SKILL.md` was included. Both files now ship. `handler.py` also reads `AGENTVIBES_MUSIC` from the environment so the default background music is configurable without editing the file.
+
+---
+
 ## 🤖 v5.6.1 — Hermes Agent Integration & Windows PS5.1 Fixes
 
 **Released:** 2026-05-01

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.6.1",
+  "version": "5.6.2",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [