agentvibes 4.2.0 → 4.4.0

package/.claude/hooks-windows/provider-manager.ps1

@@ -13,9 +13,19 @@ param(
     [string]$Provider
 )
 
-$ClaudeDir = "$env:USERPROFILE\.claude"
+# Use project-local .claude if available, like play-tts.ps1 does
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Split-Path -Parent $ScriptDir
+if (Test-Path (Join-Path $ProjectClaudeDir "config")) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
 $ProviderFile = "$ClaudeDir\tts-provider.txt"
-$ValidProviders = @('windows-piper', 'windows-sapi', 'soprano')
+$ValidProviders = @('piper', 'sapi', 'soprano')
+# Backwards compat: normalize old names
+if ($Provider -eq 'windows-piper') { $Provider = 'piper' }
+if ($Provider -eq 'windows-sapi') { $Provider = 'sapi' }
 
 # Ensure claude directory exists
 if (-not (Test-Path $ClaudeDir)) {
@@ -29,7 +39,7 @@ function Get-ActiveProvider {
     }
 
     # Default to SAPI (zero dependencies)
-    return "windows-sapi"
+    return "sapi"
 }
 
 function Get-AvailableProviders {
@@ -37,17 +47,21 @@ function Get-AvailableProviders {
 
     # Always available
     $available += @{
-        name = "windows-sapi"
+        name = "sapi"
         description = "Windows SAPI (Built-in, No Installation)"
         installed = $true
     }
 
-    # Check if Piper is installed
+    # Check if Piper is installed (standard location or PATH)
     $piperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
     $piperInstalled = Test-Path $piperExe
+    if (-not $piperInstalled) {
+        $found = Get-Command piper.exe -ErrorAction SilentlyContinue
+        $piperInstalled = $null -ne $found
+    }
 
     $available += @{
-        name = "windows-piper"
+        name = "piper"
         description = "Windows Piper (High Quality, Requires Installation)"
         installed = $piperInstalled
     }
@@ -93,11 +107,16 @@ function Set-ActiveProvider {
         return $false
     }
 
-    # If trying to set piper, check if installed
-    if ($NewProvider -eq "windows-piper") {
+    # Normalize legacy names
+    if ($NewProvider -eq "windows-piper") { $NewProvider = "piper" }
+    if ($NewProvider -eq "windows-sapi") { $NewProvider = "sapi" }
+
+    # If trying to set piper, check if installed (standard location or PATH)
+    if ($NewProvider -eq "piper") {
         $piperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
-        if (-not (Test-Path $piperExe)) {
-            Write-Host "[WARNING] Piper not installed at: $piperExe" -ForegroundColor Yellow
+        $piperFound = (Test-Path $piperExe) -or ($null -ne (Get-Command piper.exe -ErrorAction SilentlyContinue))
+        if (-not $piperFound) {
+            Write-Host "[WARNING] Piper not installed. Not found at: $piperExe or in PATH" -ForegroundColor Yellow
             Write-Host "Run: .\setup-windows.ps1 to install Piper" -ForegroundColor Yellow
             return $false
         }

package/.claude/hooks-windows/session-start-tts.ps1

@@ -1,124 +1,124 @@
-#
-# File: .claude/hooks-windows/session-start-tts.ps1
-#
-# AgentVibes SessionStart Hook for Windows - Optimized (Issue #80, Phase 1)
-# Token target: ~250 (down from ~500)
-#
-# Prints TTS protocol instructions to stdout so Claude knows to use TTS.
-#
-
-$ErrorActionPreference = "Stop"
-
-# Get script directory
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-# Check if AgentVibes is installed
-if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
-    # AgentVibes not installed, don't inject anything
-    exit 0
-}
-
-# Resolve project .claude dir from script location (avoids CWD-relative path issues)
-$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
-$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
-
-# Check for sentiment (priority) or personality (fallback)
-$Sentiment = ""
-$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
-foreach ($p in $sentimentPaths) {
-    if (Test-Path $p) {
-        $Sentiment = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($Sentiment) { break }
-    }
-}
-
-$Personality = "normal"
-$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
-foreach ($p in $personalityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Personality = $val; break }
-    }
-}
-
-# Determine style
-if ($Sentiment) {
-    $Style = $Sentiment
-} else {
-    $Style = $Personality
-}
-
-# Get verbosity level (Issue #32)
-$Verbosity = "low"
-$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
-foreach ($p in $verbosityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Verbosity = $val; break }
-    }
-}
-
-# Output optimized TTS protocol
-Write-Output @"
-
-# AgentVibes TTS Protocol
-
-**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
-
-1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]"``
-2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]"``
-
-**Example:**
-``````
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status"]
-[work...]
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes"]
-``````
-
-"@
-
-# Add verbosity-specific protocol (Issue #32)
-switch ($Verbosity) {
-    "low" {
-        Write-Output @"
-## Verbosity: LOW
-- Acknowledgment: Action only
-- Completion: Result + errors only
-- Skip: Reasoning, decisions
-
-"@
-    }
-    "medium" {
-        Write-Output @"
-## Verbosity: MEDIUM
-- Acknowledgment: Action + key approach
-- Completion: Result + important decisions
-- Include: Major choices only
-
-"@
-    }
-    "high" {
-        Write-Output @"
-## Verbosity: HIGH
-- Acknowledgment: Action + approach + why
-- Completion: Result + decisions + trade-offs
-- Include: Full reasoning, alternatives
-
-"@
-    }
-}
-
-# Add style info and rules
-Write-Output @"
-## Style: $Style
-
-## Rules
-1. Never skip acknowledgment TTS
-2. Never skip completion TTS
-3. Match verbosity level
-4. Keep under 150 chars
-5. Always include errors
-
-Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
-
-"@
+#
+# File: .claude/hooks-windows/session-start-tts.ps1
+#
+# AgentVibes SessionStart Hook for Windows - Optimized (Issue #80, Phase 1)
+# Token target: ~250 (down from ~500)
+#
+# Prints TTS protocol instructions to stdout so Claude knows to use TTS.
+#
+
+$ErrorActionPreference = "Stop"
+
+# Get script directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Check if AgentVibes is installed
+if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
+    # AgentVibes not installed, don't inject anything
+    exit 0
+}
+
+# Resolve project .claude dir from script location (avoids CWD-relative path issues)
+$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
+$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
+
+# Check for sentiment (priority) or personality (fallback)
+$Sentiment = ""
+$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
+foreach ($p in $sentimentPaths) {
+    if (Test-Path $p) {
+        $Sentiment = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($Sentiment) { break }
+    }
+}
+
+$Personality = "normal"
+$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
+foreach ($p in $personalityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Personality = $val; break }
+    }
+}
+
+# Determine style
+if ($Sentiment) {
+    $Style = $Sentiment
+} else {
+    $Style = $Personality
+}
+
+# Get verbosity level (Issue #32)
+$Verbosity = "low"
+$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
+foreach ($p in $verbosityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Verbosity = $val; break }
+    }
+}
+
+# Output optimized TTS protocol
+Write-Output @"
+
+# AgentVibes TTS Protocol
+
+**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
+
+1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]"``
+2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]"``
+
+**Example:**
+``````
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status"]
+[work...]
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes"]
+``````
+
+"@
+
+# Add verbosity-specific protocol (Issue #32)
+switch ($Verbosity) {
+    "low" {
+        Write-Output @"
+## Verbosity: LOW
+- Acknowledgment: Action only
+- Completion: Result + errors only
+- Skip: Reasoning, decisions
+
+"@
+    }
+    "medium" {
+        Write-Output @"
+## Verbosity: MEDIUM
+- Acknowledgment: Action + key approach
+- Completion: Result + important decisions
+- Include: Major choices only
+
+"@
+    }
+    "high" {
+        Write-Output @"
+## Verbosity: HIGH
+- Acknowledgment: Action + approach + why
+- Completion: Result + decisions + trade-offs
+- Include: Full reasoning, alternatives
+
+"@
+    }
+}
+
+# Add style info and rules
+Write-Output @"
+## Style: $Style
+
+## Rules
+1. Never skip acknowledgment TTS
+2. Never skip completion TTS
+3. Match verbosity level
+4. Keep under 150 chars
+5. Always include errors
+
+Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
+
+"@

package/.claude/hooks-windows/soprano-gradio-synth.py

@@ -1,153 +1,153 @@
-#!/usr/bin/env python3
-#
-# File: .claude/hooks-windows/soprano-gradio-synth.py
-#
-# AgentVibes - Finally, your AI Agents can Talk Back!
-# 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.
-#
-# ---
-#
-# Soprano Gradio WebUI synthesizer helper.
-# Calls the Soprano WebUI's Gradio API and saves the result as a WAV file.
-# Uses only Python stdlib (json, sys, urllib) — no extra dependencies.
-#
-# Usage: python3 soprano-gradio-synth.py "text to speak" output.wav [port]
-#
-"""
-Soprano Gradio WebUI synthesizer helper for AgentVibes.
-
-Calls the Soprano WebUI's Gradio API via the Server-Sent Events (SSE) protocol
-and downloads the generated audio as a WAV file.
-
-Flow:
-  1. Submit generation request -> get event_id
-  2. Poll SSE stream for audio file URL
-  3. Download WAV file to output path
-
-See: https://github.com/ekwek1/soprano
-"""
-import json
-import sys
-import urllib.request
-import urllib.error
-
-
-def synth(text: str, output_path: str, port: int = 7860) -> None:
-    base = f"http://127.0.0.1:{port}"
-
-    # Step 1: Submit generation request
-    # Args: text, temperature, top_p, repetition_penalty, chunk_size, streaming
-    payload = json.dumps({
-        "data": [text, 0.0, 0.95, 1.2, 1, False]
-    }).encode()
-
-    event_id = submit_request(base, payload)
-
-    # Step 2: Poll SSE stream for audio file URL
-    audio_url = poll_for_result(base, event_id)
-
-    # Step 3: Download the audio file (validate localhost to prevent SSRF)
-    download_file(audio_url, output_path, port)
-
-
-def submit_request(base: str, payload: bytes) -> str:
-    """Submit generation request to Gradio API, return event_id."""
-    for api_base in ["/gradio_api/call", "/call"]:
-        url = f"{base}{api_base}/generate_speech"
-        req = urllib.request.Request(
-            url,
-            data=payload,
-            headers={"Content-Type": "application/json"},
-        )
-        try:
-            with urllib.request.urlopen(req, timeout=30) as resp:
-                return json.loads(resp.read())["event_id"]
-        except urllib.error.URLError:
-            continue
-
-    raise RuntimeError("Could not reach Soprano WebUI API")
-
-
-def poll_for_result(base: str, event_id: str) -> str:
-    """Poll SSE endpoint until audio file URL is returned."""
-    for api_base in ["/gradio_api/call", "/call"]:
-        url = f"{base}{api_base}/generate_speech/{event_id}"
-        req = urllib.request.Request(url)
-        try:
-            with urllib.request.urlopen(req, timeout=120) as resp:
-                for raw_line in resp:
-                    line = raw_line.decode("utf-8", errors="replace").strip()
-                    if not line.startswith("data: "):
-                        continue
-                    try:
-                        parsed = json.loads(line[6:])
-                    except json.JSONDecodeError:
-                        continue
-                    # Response format: [{"path": "...", "url": "...", ...}, "status string"]
-                    if isinstance(parsed, list) and len(parsed) >= 1:
-                        audio = parsed[0]
-                        if isinstance(audio, dict) and "url" in audio:
-                            return audio["url"]
-            break
-        except urllib.error.URLError:
-            continue
-
-    raise RuntimeError("No audio URL in Soprano response")
-
-
-def download_file(url: str, output_path: str, port: int = 7860) -> None:
-    """Download audio file from Gradio file server.
-
-    Security: Validates URL points to localhost to prevent SSRF.
-    """
-    # Validate URL is localhost to prevent SSRF via crafted Gradio responses
-    allowed_prefixes = [
-        f"http://127.0.0.1:{port}/",
-        f"http://localhost:{port}/",
-    ]
-    if not any(url.startswith(prefix) for prefix in allowed_prefixes):
-        raise RuntimeError(f"Refused download from non-localhost URL: {url[:80]}")
-
-    req = urllib.request.Request(url)
-    with urllib.request.urlopen(req, timeout=30) as resp:
-        with open(output_path, "wb") as f:
-            while True:
-                chunk = resp.read(8192)
-                if not chunk:
-                    break
-                f.write(chunk)
-
-
-if __name__ == "__main__":
-    if len(sys.argv) < 3:
-        print(f"Usage: {sys.argv[0]} \"text\" output.wav [port]", file=sys.stderr)
-        sys.exit(1)
-
-    text = sys.argv[1]
-    output = sys.argv[2]
-    port = int(sys.argv[3]) if len(sys.argv) > 3 else 7860
-    if not (1 <= port <= 65535):
-        print(f"Error: Invalid port number: {port}", file=sys.stderr)
-        sys.exit(1)
-
-    try:
-        synth(text, output, port)
-    except Exception as e:
-        print(f"Error: {e}", file=sys.stderr)
-        sys.exit(1)
+#!/usr/bin/env python3
+#
+# File: .claude/hooks-windows/soprano-gradio-synth.py
+#
+# AgentVibes - Finally, your AI Agents can Talk Back!
+# 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.
+#
+# ---
+#
+# Soprano Gradio WebUI synthesizer helper.
+# Calls the Soprano WebUI's Gradio API and saves the result as a WAV file.
+# Uses only Python stdlib (json, sys, urllib) — no extra dependencies.
+#
+# Usage: python3 soprano-gradio-synth.py "text to speak" output.wav [port]
+#
+"""
+Soprano Gradio WebUI synthesizer helper for AgentVibes.
+
+Calls the Soprano WebUI's Gradio API via the Server-Sent Events (SSE) protocol
+and downloads the generated audio as a WAV file.
+
+Flow:
+  1. Submit generation request -> get event_id
+  2. Poll SSE stream for audio file URL
+  3. Download WAV file to output path
+
+See: https://github.com/ekwek1/soprano
+"""
+import json
+import sys
+import urllib.request
+import urllib.error
+
+
+def synth(text: str, output_path: str, port: int = 7860) -> None:
+    base = f"http://127.0.0.1:{port}"
+
+    # Step 1: Submit generation request
+    # Args: text, temperature, top_p, repetition_penalty, chunk_size, streaming
+    payload = json.dumps({
+        "data": [text, 0.0, 0.95, 1.2, 1, False]
+    }).encode()
+
+    event_id = submit_request(base, payload)
+
+    # Step 2: Poll SSE stream for audio file URL
+    audio_url = poll_for_result(base, event_id)
+
+    # Step 3: Download the audio file (validate localhost to prevent SSRF)
+    download_file(audio_url, output_path, port)
+
+
+def submit_request(base: str, payload: bytes) -> str:
+    """Submit generation request to Gradio API, return event_id."""
+    for api_base in ["/gradio_api/call", "/call"]:
+        url = f"{base}{api_base}/generate_speech"
+        req = urllib.request.Request(
+            url,
+            data=payload,
+            headers={"Content-Type": "application/json"},
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=30) as resp:
+                return json.loads(resp.read())["event_id"]
+        except urllib.error.URLError:
+            continue
+
+    raise RuntimeError("Could not reach Soprano WebUI API")
+
+
+def poll_for_result(base: str, event_id: str) -> str:
+    """Poll SSE endpoint until audio file URL is returned."""
+    for api_base in ["/gradio_api/call", "/call"]:
+        url = f"{base}{api_base}/generate_speech/{event_id}"
+        req = urllib.request.Request(url)
+        try:
+            with urllib.request.urlopen(req, timeout=120) as resp:
+                for raw_line in resp:
+                    line = raw_line.decode("utf-8", errors="replace").strip()
+                    if not line.startswith("data: "):
+                        continue
+                    try:
+                        parsed = json.loads(line[6:])
+                    except json.JSONDecodeError:
+                        continue
+                    # Response format: [{"path": "...", "url": "...", ...}, "status string"]
+                    if isinstance(parsed, list) and len(parsed) >= 1:
+                        audio = parsed[0]
+                        if isinstance(audio, dict) and "url" in audio:
+                            return audio["url"]
+            break
+        except urllib.error.URLError:
+            continue
+
+    raise RuntimeError("No audio URL in Soprano response")
+
+
+def download_file(url: str, output_path: str, port: int = 7860) -> None:
+    """Download audio file from Gradio file server.
+
+    Security: Validates URL points to localhost to prevent SSRF.
+    """
+    # Validate URL is localhost to prevent SSRF via crafted Gradio responses
+    allowed_prefixes = [
+        f"http://127.0.0.1:{port}/",
+        f"http://localhost:{port}/",
+    ]
+    if not any(url.startswith(prefix) for prefix in allowed_prefixes):
+        raise RuntimeError(f"Refused download from non-localhost URL: {url[:80]}")
+
+    req = urllib.request.Request(url)
+    with urllib.request.urlopen(req, timeout=30) as resp:
+        with open(output_path, "wb") as f:
+            while True:
+                chunk = resp.read(8192)
+                if not chunk:
+                    break
+                f.write(chunk)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print(f"Usage: {sys.argv[0]} \"text\" output.wav [port]", file=sys.stderr)
+        sys.exit(1)
+
+    text = sys.argv[1]
+    output = sys.argv[2]
+    port = int(sys.argv[3]) if len(sys.argv) > 3 else 7860
+    if not (1 <= port <= 65535):
+        print(f"Error: Invalid port number: {port}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        synth(text, output, port)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)