agentvibes 2.0.17-beta.2 → 2.0.17-beta.21

package/mcp-server/server.py

@@ -35,11 +35,12 @@ class AgentVibesServer:
         agentvibes_root = script_dir.parent  # AgentVibes/
         claude_dir = agentvibes_root / ".claude"
 
-        # Use project-local .claude if it exists
+        # ALWAYS use package .claude for hooks (even in NPX cache)
+        # The package ALWAYS has .claude/ with all the hooks
         if claude_dir.exists() and claude_dir.is_dir():
             return claude_dir
 
-        # Fallback to global ~/.claude
+        # Fallback to global ~/.claude (should never happen in properly installed package)
         return Path.home() / ".claude"
 
     async def text_to_speech(
@@ -88,20 +89,15 @@ class AgentVibesServer:
             env = os.environ.copy()
 
             # Determine where to save settings based on context:
-            # 1. If cwd has .claude/ → Use cwd (real project)
-            # 2. If cwd == AgentVibes dir → Use global ~/.claude/ (Warp)
-            # 3. Otherwise → Use AgentVibes/.claude/ (development)
+            # 1. If cwd has .claude/ → Use cwd (real Claude Code project)
+            # 2. Otherwise → Use global ~/.claude/ (Claude Desktop, Warp, etc.)
+            # Note: Hooks are ALWAYS from package .claude/ (self.claude_dir)
             cwd = Path.cwd()
             if (cwd / ".claude").is_dir() and cwd != self.agentvibes_root:
-                # Real project with .claude directory
+                # Real Claude Code project with .claude directory
                 env["CLAUDE_PROJECT_DIR"] = str(cwd)
-            elif cwd == self.agentvibes_root:
-                # Running from AgentVibes itself (Warp) - use global
-                # Don't set CLAUDE_PROJECT_DIR, let scripts fall back to ~/.claude
-                pass
-            else:
-                # Development context - use AgentVibes directory
-                env["CLAUDE_PROJECT_DIR"] = str(self.agentvibes_root)
+            # else: Don't set CLAUDE_PROJECT_DIR, let scripts fall back to ~/.claude
+            # This handles: Claude Desktop (NPX), Warp, and any non-project context
             # Add common locations for piper to PATH
             home_dir = Path.home()
             local_bin = str(home_dir / ".local" / "bin")
@@ -285,6 +281,43 @@ class AgentVibesServer:
             return result
         return f"❌ Failed to replay audio: {result}"
 
+    async def set_provider(self, provider: str) -> str:
+        """
+        Switch TTS provider between ElevenLabs and Piper.
+
+        Args:
+            provider: Provider name ("elevenlabs" or "piper")
+
+        Returns:
+            Success or error message
+        """
+        provider = provider.lower()
+        if provider not in ["elevenlabs", "piper"]:
+            return f"❌ Invalid provider: {provider}. Choose 'elevenlabs' or 'piper'"
+
+        result = await self._run_script("provider-manager.sh", ["switch", provider])
+        if result and "✓" in result:
+            return result
+        return f"❌ Failed to switch provider: {result}"
+
+    async def set_learn_mode(self, enabled: bool) -> str:
+        """
+        Enable or disable language learning mode.
+
+        When enabled, TTS speaks in both your main language and target language.
+
+        Args:
+            enabled: True to enable, False to disable
+
+        Returns:
+            Success or error message
+        """
+        action = "enable" if enabled else "disable"
+        result = await self._run_script("learn-manager.sh", [action])
+        if result and "✓" in result:
+            return result
+        return f"❌ Failed to set learn mode: {result}"
+
     # Helper methods
     async def _run_script(self, script_name: str, args: list[str]) -> str:
         """Run a bash script and return output"""
@@ -299,20 +332,15 @@ class AgentVibesServer:
         env = os.environ.copy()
 
         # Determine where to save settings based on context:
-        # 1. If cwd has .claude/ → Use cwd (real project)
-        # 2. If cwd == AgentVibes dir → Use global ~/.claude/ (Warp)
-        # 3. Otherwise → Use AgentVibes/.claude/ (development)
+        # 1. If cwd has .claude/ → Use cwd (real Claude Code project)
+        # 2. Otherwise → Use global ~/.claude/ (Claude Desktop, Warp, etc.)
+        # Note: Hooks are ALWAYS from package .claude/ (self.claude_dir)
         cwd = Path.cwd()
         if (cwd / ".claude").is_dir() and cwd != self.agentvibes_root:
-            # Real project with .claude directory
+            # Real Claude Code project with .claude directory
             env["CLAUDE_PROJECT_DIR"] = str(cwd)
-        elif cwd == self.agentvibes_root:
-            # Running from AgentVibes itself (Warp) - use global
-            # Don't set CLAUDE_PROJECT_DIR, let scripts fall back to ~/.claude
-            pass
-        else:
-            # Development context - use AgentVibes directory
-            env["CLAUDE_PROJECT_DIR"] = str(self.agentvibes_root)
+        # else: Don't set CLAUDE_PROJECT_DIR, let scripts fall back to ~/.claude
+        # This handles: Claude Desktop (NPX), Warp, and any non-project context
         # Add common locations for piper to PATH
         home_dir = Path.home()
         local_bin = str(home_dir / ".local" / "bin")
@@ -374,7 +402,8 @@ class AgentVibesServer:
             elif provider == "piper":
                 return "Piper TTS (Free, Offline)"
             return provider
-        return "ElevenLabs (Premium AI)"
+        # Default to Piper (free, offline) instead of ElevenLabs
+        return "Piper TTS (Free, Offline)"
 
 
 # Create the MCP server
@@ -499,6 +528,35 @@ Examples:
                 },
             },
         ),
+        Tool(
+            name="set_provider",
+            description="Switch between ElevenLabs (premium) and Piper (free, offline) TTS providers",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "provider": {
+                        "type": "string",
+                        "description": "Provider name: 'elevenlabs' or 'piper'",
+                        "enum": ["elevenlabs", "piper"]
+                    }
+                },
+                "required": ["provider"],
+            },
+        ),
+        Tool(
+            name="set_learn_mode",
+            description="Enable or disable language learning mode. When ON, TTS speaks in both your main language and target language for bilingual learning.",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "enabled": {
+                        "type": "boolean",
+                        "description": "True to enable learning mode, False to disable"
+                    }
+                },
+                "required": ["enabled"],
+            },
+        ),
     ]
 
 
@@ -528,6 +586,10 @@ async def call_tool(name: str, arguments: dict) -> list[TextContent]:
         elif name == "replay_audio":
             n = arguments.get("n", 1)
             result = await agent_vibes.replay_audio(n)
+        elif name == "set_provider":
+            result = await agent_vibes.set_provider(arguments["provider"])
+        elif name == "set_learn_mode":
+            result = await agent_vibes.set_learn_mode(arguments["enabled"])
         else:
             result = f"Unknown tool: {name}"
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.0.17-beta.2",
+  "version": "2.0.17-beta.21",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [
@@ -28,7 +28,7 @@
   "bin": {
     "agentvibes": "./bin/agent-vibes",
     "agent-vibes": "./bin/agent-vibes",
-    "agentvibes-mcp-server": "./bin/mcp-server"
+    "agentvibes-mcp-server": "./bin/mcp-server.js"
   },
   "scripts": {
     "install-local": "node src/installer.js install",

package/scripts/AUTO-MONITOR-SETUP.md

@@ -0,0 +1,233 @@
+# Automatic Audio Tunnel Monitoring Setup
+
+This guide shows you how to set up automatic monitoring for your audio tunnel so it fixes itself when issues occur.
+
+## Quick Setup
+
+### 1. Create Your Configuration
+
+```bash
+cd scripts/
+cp audio-tunnel.config.example audio-tunnel.config
+nano audio-tunnel.config  # Edit with your settings
+```
+
+**Configure these values:**
+- `REMOTE_HOST`: Your SSH host name (from `~/.ssh/config`)
+- `TUNNEL_PORT`: The port number (default: 14713)
+- `PULSE_SOCKET`: Path to PulseAudio socket (usually `/mnt/wslg/PulseServer`)
+- `CHECK_INTERVAL`: How often to check in minutes (default: 5)
+
+### 2. Install Automatic Monitoring
+
+```bash
+./setup-auto-monitor.sh
+```
+
+This will:
+- ✅ Validate your configuration
+- ✅ Install a cron job that runs every 5 minutes (or your chosen interval)
+- ✅ Log all actions to `/tmp/audio-tunnel-autofix.log`
+
+## What It Does
+
+The monitoring system automatically:
+
+1. **Checks socat bridge** - Verifies it's running on WSL
+2. **Checks SSH tunnel** - Verifies connection to remote server
+3. **Auto-fixes issues** - Runs `fix-audio-tunnel.sh` if problems detected
+4. **Logs everything** - Records all checks and fixes
+
+## Viewing Logs
+
+Watch live monitoring:
+```bash
+tail -f /tmp/audio-tunnel-autofix.log
+```
+
+Recent activity:
+```bash
+tail -20 /tmp/audio-tunnel-autofix.log
+```
+
+## Testing
+
+Test the health check manually:
+```bash
+./health-check-tunnel.sh
+```
+
+This runs the same check that cron will run automatically.
+
+## Disabling
+
+To stop automatic monitoring:
+```bash
+crontab -e
+# Remove the line containing: health-check-tunnel.sh
+```
+
+Or just comment it out with `#` if you want to easily re-enable later.
+
+## Changing Check Interval
+
+Edit your config file:
+```bash
+nano audio-tunnel.config
+# Change CHECK_INTERVAL="5" to whatever you want
+```
+
+Then run setup again:
+```bash
+./setup-auto-monitor.sh
+```
+
+## Log Format
+
+Logs look like this:
+```
+[2025-10-16 10:00:00] OK: Audio tunnel is healthy
+[2025-10-16 10:05:00] ALERT: socat bridge not running on port 14713
+[2025-10-16 10:05:00] Running automatic fix...
+[2025-10-16 10:05:05] SUCCESS: Audio tunnel restored automatically
+[2025-10-16 10:10:00] OK: Audio tunnel is healthy
+```
+
+## Troubleshooting
+
+### "Configuration file not found"
+```bash
+cp audio-tunnel.config.example audio-tunnel.config
+nano audio-tunnel.config
+```
+
+### "REMOTE_HOST not configured"
+Edit `audio-tunnel.config` and set your actual remote host name.
+
+### "Automatic fix failed"
+Check the logs:
+```bash
+tail -50 /tmp/audio-tunnel-autofix.log
+```
+
+Try running the fix manually:
+```bash
+./fix-audio-tunnel.sh
+```
+
+### Cron not running
+Verify cron service is running:
+```bash
+# Check if cron is active
+service cron status
+
+# Or on systemd systems
+systemctl status cron
+```
+
+List your cron jobs:
+```bash
+crontab -l
+```
+
+## Manual Cron Setup
+
+If `setup-auto-monitor.sh` doesn't work, add manually:
+
+```bash
+crontab -e
+```
+
+Add this line (adjust path to your actual script location):
+```
+*/5 * * * * /full/path/to/scripts/health-check-tunnel.sh >/dev/null 2>&1
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                 Cron (every 5 minutes)                  │
+└────────────────────┬────────────────────────────────────┘
+                     │
+                     ▼
+┌─────────────────────────────────────────────────────────┐
+│            health-check-tunnel.sh                       │
+│  • Reads audio-tunnel.config                           │
+│  • Checks socat bridge                                 │
+│  • Checks SSH tunnel                                   │
+└────────────────────┬────────────────────────────────────┘
+                     │
+         ┌───────────┴───────────┐
+         │                       │
+    Issues Found?           All Good?
+         │                       │
+         ▼                       ▼
+┌──────────────────┐    ┌──────────────────┐
+│ fix-audio-       │    │ Log: OK          │
+│ tunnel.sh        │    └──────────────────┘
+│ • Kill stale     │
+│   processes      │
+│ • Restart socat  │
+│ • Create tunnel  │
+│ • Verify fix     │
+└────┬─────────────┘
+     │
+     ▼
+┌──────────────────┐
+│ Log: SUCCESS or  │
+│      ERROR       │
+└──────────────────┘
+```
+
+## Why This Approach?
+
+**Benefits:**
+- ✅ **Automatic recovery** - Fixes issues without manual intervention
+- ✅ **Logged diagnostics** - Track when issues occur and how they're fixed
+- ✅ **Configurable** - Adjust check frequency as needed
+- ✅ **Non-intrusive** - Only acts when there's a problem
+- ✅ **Portable** - Config file makes it work on any system
+
+**Alternative approaches considered:**
+- ❌ Systemd service - More complex, requires root
+- ❌ Background daemon - Uses resources continuously
+- ❌ Git hooks - Only runs during git operations
+- ✅ Cron job - Simple, reliable, widely available
+
+## Security Considerations
+
+The health check script:
+- ✅ Doesn't store passwords or keys
+- ✅ Uses existing SSH config and keys
+- ✅ Only reads config file (not world-writable)
+- ✅ Logs to local temp directory
+- ✅ Runs with user permissions (no sudo needed for checks)
+
+The fix script requires sudo only for:
+- Killing processes on remote server (via `sudo fuser -k`)
+- This uses your existing SSH sudo access
+
+## Integration with AgentVibes
+
+Once monitoring is active, AgentVibes TTS will have maximum uptime:
+- Audio tunnel issues are detected within 5 minutes
+- Automatic fix runs immediately
+- Your TTS narration continues with minimal interruption
+
+## Next Steps
+
+After setup:
+1. Monitor logs for the first hour to ensure it's working
+2. Adjust `CHECK_INTERVAL` if needed
+3. Test by manually breaking the tunnel and watching it recover
+
+**To test recovery:**
+```bash
+# Break the tunnel
+pkill socat
+
+# Wait up to 5 minutes
+# Check logs to see automatic recovery
+tail -f /tmp/audio-tunnel-autofix.log
+```