agentvibes 3.5.9 → 4.0.0

package/bin/agentvibes.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * AgentVibes TUI Console — Command Entry Point
+ * Story 6.5: Command Routing & Entry Points
+ *
+ * Routes CLI subcommands to the correct TUI console tab:
+ *   npx agentvibes            → smart detection (Settings if installed, Install if not)
+ *   npx agentvibes install    → Install tab
+ *   npx agentvibes config     → Settings tab
+ *   npx agentvibes configure  → Settings tab
+ *   npx agentvibes <unknown>  → help text + exit(1)
+ */
+
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import { ConfigService } from '../src/services/config-service.js';
+import { launchConsole } from '../src/console/app.js';
+
+/**
+ * Resolve CLI args to a TUI start tab or an error.
+ * Exported as named export for unit testing without child-process spawning.
+ *
+ * @param {string[]} args - CLI arguments (process.argv.slice(2))
+ * @param {{ isInstalled: () => boolean }} configService
+ * @returns {{ startTab: string } | { help: string } | { error: string }}
+ */
+export function resolveStartTab(args, configService) {
+  const cmd = args[0];
+
+  if (cmd === 'install') {
+    return { startTab: 'install' };
+  }
+
+  if (cmd === 'config' || cmd === 'configure') {
+    return { startTab: 'settings' };
+  }
+
+  if (cmd === '--help' || cmd === '-h') {
+    return {
+      help: [
+        'AgentVibes — TTS for AI assistants with personality',
+        '',
+        'Usage:',
+        '  npx agentvibes             # Open console (auto-detects install state)',
+        '  npx agentvibes install     # Open Install tab',
+        '  npx agentvibes config      # Open Settings tab',
+        '  npx agentvibes --help      # Show this help',
+        '',
+        'Visit https://agentvibes.org for documentation.',
+      ].join('\n'),
+    };
+  }
+
+  if (!cmd) {
+    // Smart detection: show Install tab if not installed, Settings if installed
+    return { startTab: configService.isInstalled() ? 'settings' : 'install' };
+  }
+
+  // Unknown command → help + error
+  return {
+    error: [
+      `Unknown command: '${cmd}'`,
+      '',
+      'Usage:',
+      '  npx agentvibes             # Open console (auto-detects install state)',
+      '  npx agentvibes install     # Open Install tab',
+      '  npx agentvibes config      # Open Settings tab',
+      '',
+      "Run 'npx agentvibes' to get started.",
+    ].join('\n'),
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Main: run only when executed directly (not imported by tests)
+// ---------------------------------------------------------------------------
+
+// Resolve symlinks before comparing so the guard works when run via npm link / npx
+const _thisFile = fileURLToPath(import.meta.url);
+const _argv1    = (() => { try { return fs.realpathSync(process.argv[1]); } catch { return process.argv[1]; } })();
+
+if (_argv1 === _thisFile) {
+  const configService = new ConfigService();
+  const result = resolveStartTab(process.argv.slice(2), configService);
+
+  if (result.help) {
+    process.stdout.write(result.help + '\n');
+    process.exit(0);
+  }
+
+  if (result.error) {
+    process.stderr.write(result.error + '\n');
+    process.exit(1);
+  }
+
+  launchConsole({ startTab: result.startTab }).catch(err => {
+    process.stderr.write(`Failed to launch AgentVibes console: ${err.message}\n`);
+    process.exit(1);
+  });
+}

package/mcp-server/server.py

@@ -41,6 +41,7 @@ use or other dealings in the software.
 """
 
 import asyncio
+import json
 import os
 import platform
 import subprocess
@@ -101,6 +102,62 @@ class AgentVibesServer:
         # Fallback to global ~/.claude (should never happen in properly installed package)
         return Path.home() / self.CLAUDE_DIR_NAME
 
+    def _resolve_friendly_name(self, voice_name: str) -> str:
+        """
+        Resolve friendly name to Piper voice ID using voice-metadata.json.
+
+        Args:
+            voice_name: Friendly name (e.g., "ryan") or Piper ID
+
+        Returns:
+            Resolved Piper voice ID, or original voice_name if not found
+        """
+        import re
+
+        metadata_path = self.agentvibes_root / ".agentvibes" / "config" / "voice-metadata.json"
+
+        # SECURITY: Verify file exists and is not a symlink
+        if not metadata_path.exists() or metadata_path.is_symlink():
+            return voice_name
+
+        # SECURITY: Verify file ownership matches current user (Unix only)
+        try:
+            if hasattr(os, 'getuid'):
+                stat_info = metadata_path.stat()
+                if stat_info.st_uid != os.getuid():
+                    return voice_name
+        except (OSError, AttributeError):
+            pass
+
+        try:
+            with open(metadata_path, 'r') as f:
+                metadata = json.load(f)
+
+            voices = metadata.get('voices', {})
+            voice_lower = voice_name.lower()
+
+            resolved_id = None
+
+            # Check if it's a friendly name key
+            if voice_lower in voices:
+                resolved_id = voices[voice_lower].get('id')
+
+            # Check if it matches a displayName
+            if not resolved_id:
+                for friendly_name, voice_data in voices.items():
+                    if voice_data.get('displayName', '').lower() == voice_lower:
+                        resolved_id = voice_data.get('id')
+                        break
+
+            # SECURITY: Validate resolved ID matches safe pattern
+            if resolved_id and re.match(r'^[a-zA-Z0-9_-]+$', resolved_id):
+                return resolved_id
+
+        except (json.JSONDecodeError, KeyError, IOError, TypeError):
+            pass
+
+        return voice_name
+
     async def text_to_speech(
         self,
         text: str,
@@ -249,18 +306,25 @@ class AgentVibesServer:
 
     async def set_voice(self, voice_name: str) -> str:
         """
-        Switch to a different voice.
+        Switch to a different voice (supports friendly names like "ryan" or "katherine").
 
         Args:
-            voice_name: Name of the voice to switch to
+            voice_name: Friendly name (e.g., "ryan") or Piper voice ID
 
         Returns:
             Success or error message
         """
+        # Resolve friendly name to Piper ID
+        original_name = voice_name
+        resolved_name = self._resolve_friendly_name(voice_name)
+
         result = await self._run_script(
-            self.VOICE_MANAGER_SCRIPT, ["switch", voice_name, "--silent"]
+            self.VOICE_MANAGER_SCRIPT, ["switch", resolved_name, "--silent"]
         )
+
         if result and "✅" in result:
+            if original_name.lower() != resolved_name.lower():
+                return f"✅ Voice switched to: {original_name} ({resolved_name})"
             return f"✅ Voice switched to: {voice_name}"
         return f"❌ Failed to switch voice: {result}"
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "3.5.9",
+  "version": "4.0.0",
   "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": [
@@ -27,9 +27,10 @@
   "type": "module",
   "main": "src/installer.js",
   "bin": {
-    "agentvibes": "bin/agent-vibes",
+    "agentvibes": "bin/agentvibes.js",
     "agent-vibes": "bin/agent-vibes",
     "agentvibes-mcp-server": "bin/mcp-server.js",
+    "agentvibes-voice-browser": "bin/agentvibes-voice-browser.js",
     "test-bmad-pr": "bin/test-bmad-pr"
   },
   "files": [
@@ -62,6 +63,9 @@
     ".claude/piper-voices-dir.txt",
     ".claude/verbosity.txt",
     ".claude/github-star-reminder.txt",
+    ".claude/audio/voice-samples/",
+    "voice-assignments.json",
+    ".agentvibes/",
     ".clawdbot/",
     ".mcp.json",
     "setup-windows.ps1",
@@ -75,6 +79,7 @@
     "install-local": "node src/installer.js install",
     "postinstall": "node mcp-server/install-deps.js",
     "install-mcp-deps": "node mcp-server/install-deps.js",
+    "voice-browser": "node bin/agentvibes-voice-browser.js",
     "test": "npm run test:syntax && AGENTVIBES_TEST_MODE=true bats test/unit/*.bats && npm run test:coverage",
     "test:syntax": "node -c src/installer.js && node -c mcp-server/install-deps.js",
     "test:bats": "AGENTVIBES_TEST_MODE=true bats test/unit/*.bats",
@@ -83,6 +88,9 @@
     "test:verbose": "AGENTVIBES_TEST_MODE=true bats -t test/unit/*.bats"
   },
   "dependencies": {
+    "@inquirer/search": "^3.1.3",
+    "agentvibes": "^3.5.9",
+    "blessed": "^0.1.81",
     "boxen": "^7.0.0",
     "chalk": "^5.0.0",
     "commander": "^10.0.0",
@@ -98,6 +106,7 @@
     "access": "public"
   },
   "devDependencies": {
+    "bats": "^1.13.0",
     "c8": "^10.1.3"
   }
 }