mcp-voice-hooks 1.0.1 → 1.0.6

package/.claude/hooks/pre-tool-hook.sh

@@ -3,8 +3,11 @@
 # Pre-Tool Hook - Checks for pending utterances before allowing tool execution
 # Forces Claude to use dequeue_utterances tool if there are pending utterances
 
+# Get port from environment variable or use default
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+
 # Check has-pending-utterances endpoint
-response=$(curl -s http://localhost:3000/api/has-pending-utterances 2>/dev/null)
+response=$(curl -s http://localhost:${PORT}/api/has-pending-utterances 2>/dev/null)
 
 if [ $? -ne 0 ]; then
     # Server not available, allow tool execution

package/.claude/hooks/stop-hook.sh

@@ -3,8 +3,11 @@
 # Stop Hook - Intelligently decides whether to wait for voice input
 # Checks if there have been any utterances since the last timeout
 
+# Get port from environment variable or use default
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+
 # Check should-wait endpoint
-response=$(curl -s http://localhost:3000/api/should-wait 2>/dev/null)
+response=$(curl -s http://localhost:${PORT}/api/should-wait 2>/dev/null)
 
 if [ $? -ne 0 ]; then
     # Server not available, allow stop

package/CLAUDE.local.md

@@ -0,0 +1,25 @@
+# To publish to npm
+
+```bash
+# 1. Build the project first
+npm run build
+
+# 2. Update roadmap.md with version info and stage it
+git add roadmap.md
+
+# 3. Bump version (patch, minor, or major) - creates a commit and tag
+npm version patch --registry https://registry.npmjs.org/
+
+# Alternative: Bump version without creating a commit/tag
+# npm version patch --no-git-tag-version
+# Then manually commit the changes
+
+# 4. Publish to npm (this creates the .tgz file automatically)
+npm publish --registry https://registry.npmjs.org/
+
+# Note: It can take 1-5 minutes for the package to be available globally
+# Check availability at: https://www.npmjs.com/package/mcp-voice-hooks
+
+# Optional: Create .tgz file without publishing
+npm pack
+```

package/README.md

@@ -23,17 +23,15 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
 
 ## Installation in Your Own Project
 
-1. **Install the hooks** (first time only):
+1. **Add the MCP server**:
 
-   ```bash
-   npx mcp-voice-hooks install-hooks
-   ```
+   Run the following command to automatically add the MCP server to your current project in `~/.claude.json`:
 
-   This will:
-   - Install hook scripts to `~/.mcp-voice-hooks/hooks/`
-   - Configure your project's `.claude/settings.json`
+    ```bash
+    claude mcp add voice-hooks npx mcp-voice-hooks
+    ```
 
-2. **Add the MCP server** to your project's `.mcp.json`:
+   or manually add the following to your project's `.mcp.json`:
 
    ```json
    {
@@ -48,13 +46,59 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
    }
    ```
 
-3. **Start Claude Code**:
+2. **Start Claude Code**:
 
    ```bash
    claude
    ```
 
-4. **Open the voice interface** at <http://localhost:3000> and start speaking! Note: you need to send one text message to Claude to trigger the voice hooks.
+3. **Open the voice interface** at <http://localhost:5111> and start speaking! 
+
+   The hooks are automatically installed when the MCP server starts. You need to send one text message to Claude to trigger the voice hooks.
+
+   **Note**: After the first-time installation, you may need to restart Claude for the hooks to take effect.
+
+   The default port is 5111. To use a different port, add to your project's `.claude/settings.json`:
+
+   ```json
+   {
+     "env": {
+       "MCP_VOICE_HOOKS_PORT": "8080"
+     }
+   }
+   ```
+
+## Manual Hook Installation
+
+The hooks are automatically installed/updated when the MCP server starts. However, if you need to manually install or reconfigure the hooks:
+
+```bash
+npx mcp-voice-hooks install-hooks
+```
+
+This will:
+
+- Clean up any existing `~/.mcp-voice-hooks` directory contents
+- Install/update hook scripts to `~/.mcp-voice-hooks/hooks/`
+- Configure your project's `.claude/settings.json`
+
+## Uninstallation
+
+To completely remove MCP Voice Hooks:
+
+```bash
+# Remove hooks and settings
+npx mcp-voice-hooks uninstall
+
+# Also remove from Claude MCP servers
+claude mcp remove voice-hooks
+```
+
+This will:
+
+- Remove the `~/.mcp-voice-hooks` directory
+- Clean up voice hooks from your project's `.claude/settings.json`
+- Preserve any custom hooks you've added
 
 ## Development Mode
 
@@ -62,7 +106,7 @@ If you're developing mcp-voice-hooks itself:
 
 ```bash
 # 1. Clone the repository
-git clone https://github.com/yourusername/mcp-voice-hooks.git
+git clone https://github.com/johnmatthewtennant/mcp-voice-hooks.git
 cd mcp-voice-hooks
 
 # 2. Install dependencies
@@ -78,7 +122,12 @@ npx mcp-voice-hooks install-hooks
 claude
 ```
 
-NOTE: You need to restart Claude Code each time you make changes.
+**Important**: When developing with `npm link`:
+
+- Claude runs the compiled JavaScript from the `dist` folder, not your TypeScript source
+- After making changes to **TypeScript files** (`src/*.ts`), you must run `npm run build`
+- For changes to **browser files** (`public/*`), just restart Claude Code
+- Then restart Claude Code to use the updated code
 
 ### Hot Reload
 
@@ -103,7 +152,7 @@ and then configure claude to use the mcp proxy like so:
 }
 ```
 
-## WIP voice responses
+## Voice responses (Mac only)
 
 Add the post tool hook to your claude settings:
 
@@ -145,3 +194,23 @@ Add to your Claude Code settings JSON:
 ```
 
 To disable voice responses, set the value to `false` or remove the setting entirely.
+
+### High quality voice responses
+
+These voice responses are spoken by your Mac's system voice.
+
+Configure in `System Settings > Accessibility > Spoken Content > System Voice`
+
+I recommend using a Siri voice, as they are much higher quality.
+
+Click the info icon next to the system voice dropdown. Search for "Siri" to find the highest quality voices. You'll have to trigger a download of the voice.
+
+It may take a while to download.
+
+Once it's downloaded, you can select it in the system voice dropdown.
+
+Test it with the bash command:
+
+```bash
+say "Hi, this is your mac system voice"
+```

package/bin/cli.js

@@ -5,6 +5,7 @@ import path from 'path';
 import os from 'os';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
+import { replaceVoiceHooks, areHooksEqual } from '../dist/hook-merger.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -26,10 +27,16 @@ async function main() {
       
       console.log('\n✅ Installation complete!');
       console.log('📝 To start the server, run: npx mcp-voice-hooks');
+    } else if (command === 'uninstall') {
+      console.log('🗑️  Uninstalling MCP Voice Hooks...');
+      await uninstall();
     } else {
-      // Default behavior: just run the MCP server
+      // Default behavior: ensure hooks are installed/updated, then run the MCP server
       console.log('🎤 MCP Voice Hooks - Starting server...');
-      console.log('💡 Note: If hooks are not installed, run: npx mcp-voice-hooks install-hooks');
+      
+      // Auto-install/update hooks on every startup
+      await ensureHooksInstalled();
+      
       console.log('');
       await runMCPServer();
     }
@@ -46,7 +53,30 @@ async function ensureUserDirectorySetup() {
   
   console.log('📁 Setting up user directory:', userDir);
   
-  // Create directories if they don't exist
+  // Clean up existing directory contents (except README.md if it exists)
+  if (fs.existsSync(userDir)) {
+    console.log('🧹 Cleaning up existing directory...');
+    
+    // Remove hooks directory if it exists
+    if (fs.existsSync(hooksDir)) {
+      fs.rmSync(hooksDir, { recursive: true, force: true });
+      console.log('✅ Cleaned up old hooks');
+    }
+    
+    // Remove any other files
+    const files = fs.readdirSync(userDir);
+    for (const file of files) {
+      const filePath = path.join(userDir, file);
+      const stat = fs.statSync(filePath);
+      if (stat.isDirectory()) {
+        fs.rmSync(filePath, { recursive: true, force: true });
+      } else {
+        fs.unlinkSync(filePath);
+      }
+    }
+  }
+  
+  // Create directories
   if (!fs.existsSync(userDir)) {
     fs.mkdirSync(userDir, { recursive: true });
     console.log('✅ Created user directory');
@@ -74,6 +104,15 @@ async function ensureUserDirectorySetup() {
   } else {
     console.log('⚠️  Package hooks directory not found, skipping hook installation');
   }
+  
+  // Copy README.md from project root to user directory
+  const projectReadmePath = path.join(__dirname, '..', 'README.md');
+  const userReadmePath = path.join(userDir, 'README.md');
+  
+  if (fs.existsSync(projectReadmePath)) {
+    fs.copyFileSync(projectReadmePath, userReadmePath);
+    console.log('✅ Copied README.md');
+  }
 }
 
 // Automatically configure Claude Code settings
@@ -139,14 +178,76 @@ async function configureClaudeCodeSettings() {
     ]
   };
   
-  // Update settings
-  settings.hooks = hookConfig;
+  // Replace voice hooks intelligently
+  const updatedHooks = replaceVoiceHooks(settings.hooks || {}, hookConfig);
+  
+  // Check if hooks actually changed (ignoring order)
+  if (areHooksEqual(settings.hooks || {}, updatedHooks)) {
+    console.log('✅ Claude settings already up to date');
+    return;
+  }
+  
+  // Update settings with new hooks
+  settings.hooks = updatedHooks;
   
   // Write settings back
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
   console.log('✅ Updated project Claude Code settings');
 }
 
+// Silent hook installation check - runs on every startup
+async function ensureHooksInstalled() {
+  const userDir = path.join(os.homedir(), '.mcp-voice-hooks');
+  const hooksDir = path.join(userDir, 'hooks');
+  const packageHooksDir = path.join(__dirname, '..', '.claude', 'hooks');
+  
+  try {
+    // Only create directories if they don't exist
+    if (!fs.existsSync(hooksDir)) {
+      fs.mkdirSync(hooksDir, { recursive: true });
+      console.log('🔧 Installing hooks for first time...');
+    }
+    
+    // Check if hooks need updating
+    let needsUpdate = false;
+    if (fs.existsSync(packageHooksDir)) {
+      const hookFiles = fs.readdirSync(packageHooksDir).filter(file => file.endsWith('.sh'));
+      
+      for (const hookFile of hookFiles) {
+        const sourcePath = path.join(packageHooksDir, hookFile);
+        const destPath = path.join(hooksDir, hookFile);
+        
+        // Check if hook doesn't exist or is different
+        if (!fs.existsSync(destPath)) {
+          needsUpdate = true;
+          break;
+        }
+        
+        const sourceContent = fs.readFileSync(sourcePath, 'utf8');
+        const destContent = fs.readFileSync(destPath, 'utf8');
+        
+        if (sourceContent !== destContent) {
+          needsUpdate = true;
+          break;
+        }
+      }
+    }
+    
+    if (needsUpdate) {
+      console.log('🔄 Updating hooks to latest version...');
+      await ensureUserDirectorySetup();
+      await configureClaudeCodeSettings();
+      console.log('✅ Hooks and settings updated');
+    } else {
+      // Even if hooks are up to date, ensure settings are correct
+      await configureClaudeCodeSettings();
+    }
+  } catch (error) {
+    // Silently continue if hooks can't be updated
+    console.warn('⚠️  Could not auto-update hooks:', error.message);
+  }
+}
+
 // Run the MCP server
 async function runMCPServer() {
   const serverPath = path.join(__dirname, '..', 'dist', 'unified-server.js');
@@ -179,6 +280,56 @@ async function runMCPServer() {
   });
 }
 
+// Uninstall MCP Voice Hooks
+async function uninstall() {
+  const userDir = path.join(os.homedir(), '.mcp-voice-hooks');
+  const claudeSettingsPath = path.join(process.cwd(), '.claude', 'settings.json');
+  
+  // Step 1: Remove ~/.mcp-voice-hooks directory
+  if (fs.existsSync(userDir)) {
+    console.log('📁 Removing user directory:', userDir);
+    fs.rmSync(userDir, { recursive: true, force: true });
+    console.log('✅ Removed ~/.mcp-voice-hooks');
+  } else {
+    console.log('ℹ️  ~/.mcp-voice-hooks directory not found');
+  }
+  
+  // Step 2: Remove voice hooks from Claude settings
+  if (fs.existsSync(claudeSettingsPath)) {
+    try {
+      console.log('⚙️  Removing voice hooks from Claude settings...');
+      
+      const settingsContent = fs.readFileSync(claudeSettingsPath, 'utf8');
+      const settings = JSON.parse(settingsContent);
+      
+      if (settings.hooks) {
+        // Remove voice hooks
+        const cleanedHooks = removeVoiceHooks(settings.hooks);
+        
+        if (Object.keys(cleanedHooks).length === 0) {
+          // If no hooks remain, remove the hooks property entirely
+          delete settings.hooks;
+        } else {
+          settings.hooks = cleanedHooks;
+        }
+        
+        // Write updated settings
+        fs.writeFileSync(claudeSettingsPath, JSON.stringify(settings, null, 2));
+        console.log('✅ Removed voice hooks from Claude settings');
+      } else {
+        console.log('ℹ️  No hooks found in Claude settings');
+      }
+    } catch (error) {
+      console.log('⚠️  Could not update Claude settings:', error.message);
+    }
+  } else {
+    console.log('ℹ️  No Claude settings file found in current project');
+  }
+  
+  console.log('\n✅ Uninstallation complete!');
+  console.log('👋 MCP Voice Hooks has been removed.');
+}
+
 // Run the main function
 main().catch(error => {
   console.error('❌ Unexpected error:', error);

package/dist/hook-merger.d.ts

@@ -0,0 +1,33 @@
+interface Hook {
+    type: string;
+    command: string;
+}
+interface HookConfig {
+    matcher: string;
+    hooks: Hook[];
+}
+interface HookSettings {
+    [hookType: string]: HookConfig[];
+}
+/**
+ * Removes any existing voice hooks that reference our directory
+ * @param hooks - The current hooks configuration
+ * @returns The hooks with voice hooks removed
+ */
+declare function removeVoiceHooks(hooks?: HookSettings): HookSettings;
+/**
+ * Replaces voice hooks - removes any existing ones and adds new ones
+ * @param existingHooks - The current hooks configuration
+ * @param voiceHooks - The voice hooks to add
+ * @returns The updated hooks configuration
+ */
+declare function replaceVoiceHooks(existingHooks: HookSettings | undefined, voiceHooks: HookSettings): HookSettings;
+/**
+ * Checks if two hook settings are semantically equal (ignoring order)
+ * @param hooks1 - First hooks configuration
+ * @param hooks2 - Second hooks configuration
+ * @returns True if they contain the same hooks regardless of order
+ */
+declare function areHooksEqual(hooks1?: HookSettings, hooks2?: HookSettings): boolean;
+
+export { type HookSettings, areHooksEqual, removeVoiceHooks, replaceVoiceHooks };

package/dist/hook-merger.js

@@ -0,0 +1,54 @@
+// src/hook-merger.ts
+function removeVoiceHooks(hooks = {}) {
+  const cleaned = {};
+  const voiceHookPattern = /\.mcp-voice-hooks/;
+  for (const [hookType, hookArray] of Object.entries(hooks)) {
+    cleaned[hookType] = hookArray.filter((hookConfig) => {
+      return !hookConfig.hooks.some((hook) => voiceHookPattern.test(hook.command));
+    });
+    if (cleaned[hookType].length === 0) {
+      delete cleaned[hookType];
+    }
+  }
+  return cleaned;
+}
+function replaceVoiceHooks(existingHooks = {}, voiceHooks) {
+  const cleaned = removeVoiceHooks(existingHooks);
+  const result = JSON.parse(JSON.stringify(cleaned));
+  for (const [hookType, hookArray] of Object.entries(voiceHooks)) {
+    if (!result[hookType]) {
+      result[hookType] = hookArray;
+    } else {
+      result[hookType].push(...hookArray);
+    }
+  }
+  return result;
+}
+function areHooksEqual(hooks1 = {}, hooks2 = {}) {
+  const types1 = Object.keys(hooks1).sort();
+  const types2 = Object.keys(hooks2).sort();
+  if (types1.join(",") !== types2.join(",")) {
+    return false;
+  }
+  for (const hookType of types1) {
+    const configs1 = hooks1[hookType];
+    const configs2 = hooks2[hookType];
+    if (configs1.length !== configs2.length) {
+      return false;
+    }
+    const normalized1 = configs1.map((config) => JSON.stringify(config)).sort();
+    const normalized2 = configs2.map((config) => JSON.stringify(config)).sort();
+    for (let i = 0; i < normalized1.length; i++) {
+      if (normalized1[i] !== normalized2[i]) {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+export {
+  areHooksEqual,
+  removeVoiceHooks,
+  replaceVoiceHooks
+};
+//# sourceMappingURL=hook-merger.js.map

package/dist/hook-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hook-merger.ts"],"sourcesContent":["interface Hook {\n  type: string;\n  command: string;\n}\n\ninterface HookConfig {\n  matcher: string;\n  hooks: Hook[];\n}\n\nexport interface HookSettings {\n  [hookType: string]: HookConfig[];\n}\n\n/**\n * Removes any existing voice hooks that reference our directory\n * @param hooks - The current hooks configuration\n * @returns The hooks with voice hooks removed\n */\nexport function removeVoiceHooks(hooks: HookSettings = {}): HookSettings {\n  const cleaned: HookSettings = {};\n  const voiceHookPattern = /\\.mcp-voice-hooks/;\n  \n  for (const [hookType, hookArray] of Object.entries(hooks)) {\n    cleaned[hookType] = hookArray.filter(hookConfig => {\n      // Keep this hook config only if none of its commands reference our directory\n      return !hookConfig.hooks.some(hook => voiceHookPattern.test(hook.command));\n    });\n    \n    // Remove empty arrays\n    if (cleaned[hookType].length === 0) {\n      delete cleaned[hookType];\n    }\n  }\n  \n  return cleaned;\n}\n\n/**\n * Replaces voice hooks - removes any existing ones and adds new ones\n * @param existingHooks - The current hooks configuration\n * @param voiceHooks - The voice hooks to add\n * @returns The updated hooks configuration\n */\nexport function replaceVoiceHooks(existingHooks: HookSettings = {}, voiceHooks: HookSettings): HookSettings {\n  // First, remove any existing voice hooks\n  const cleaned = removeVoiceHooks(existingHooks);\n  \n  // Then merge in the new voice hooks\n  const result: HookSettings = JSON.parse(JSON.stringify(cleaned)); // Deep clone\n  \n  for (const [hookType, hookArray] of Object.entries(voiceHooks)) {\n    if (!result[hookType]) {\n      result[hookType] = hookArray;\n    } else {\n      result[hookType].push(...hookArray);\n    }\n  }\n  \n  return result;\n}\n\n/**\n * Checks if two hook settings are semantically equal (ignoring order)\n * @param hooks1 - First hooks configuration\n * @param hooks2 - Second hooks configuration\n * @returns True if they contain the same hooks regardless of order\n */\nexport function areHooksEqual(hooks1: HookSettings = {}, hooks2: HookSettings = {}): boolean {\n  const types1 = Object.keys(hooks1).sort();\n  const types2 = Object.keys(hooks2).sort();\n  \n  // Different hook types\n  if (types1.join(',') !== types2.join(',')) {\n    return false;\n  }\n  \n  // Check each hook type\n  for (const hookType of types1) {\n    const configs1 = hooks1[hookType];\n    const configs2 = hooks2[hookType];\n    \n    if (configs1.length !== configs2.length) {\n      return false;\n    }\n    \n    // Create normalized strings for comparison\n    const normalized1 = configs1\n      .map(config => JSON.stringify(config))\n      .sort();\n    const normalized2 = configs2\n      .map(config => JSON.stringify(config))\n      .sort();\n    \n    // Compare sorted arrays\n    for (let i = 0; i < normalized1.length; i++) {\n      if (normalized1[i] !== normalized2[i]) {\n        return false;\n      }\n    }\n  }\n  \n  return true;\n}"],"mappings":";AAmBO,SAAS,iBAAiB,QAAsB,CAAC,GAAiB;AACvE,QAAM,UAAwB,CAAC;AAC/B,QAAM,mBAAmB;AAEzB,aAAW,CAAC,UAAU,SAAS,KAAK,OAAO,QAAQ,KAAK,GAAG;AACzD,YAAQ,QAAQ,IAAI,UAAU,OAAO,gBAAc;AAEjD,aAAO,CAAC,WAAW,MAAM,KAAK,UAAQ,iBAAiB,KAAK,KAAK,OAAO,CAAC;AAAA,IAC3E,CAAC;AAGD,QAAI,QAAQ,QAAQ,EAAE,WAAW,GAAG;AAClC,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,gBAA8B,CAAC,GAAG,YAAwC;AAE1G,QAAM,UAAU,iBAAiB,aAAa;AAG9C,QAAM,SAAuB,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC;AAE/D,aAAW,CAAC,UAAU,SAAS,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC9D,QAAI,CAAC,OAAO,QAAQ,GAAG;AACrB,aAAO,QAAQ,IAAI;AAAA,IACrB,OAAO;AACL,aAAO,QAAQ,EAAE,KAAK,GAAG,SAAS;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,cAAc,SAAuB,CAAC,GAAG,SAAuB,CAAC,GAAY;AAC3F,QAAM,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK;AACxC,QAAM,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK;AAGxC,MAAI,OAAO,KAAK,GAAG,MAAM,OAAO,KAAK,GAAG,GAAG;AACzC,WAAO;AAAA,EACT;AAGA,aAAW,YAAY,QAAQ;AAC7B,UAAM,WAAW,OAAO,QAAQ;AAChC,UAAM,WAAW,OAAO,QAAQ;AAEhC,QAAI,SAAS,WAAW,SAAS,QAAQ;AACvC,aAAO;AAAA,IACT;AAGA,UAAM,cAAc,SACjB,IAAI,YAAU,KAAK,UAAU,MAAM,CAAC,EACpC,KAAK;AACR,UAAM,cAAc,SACjB,IAAI,YAAU,KAAK,UAAU,MAAM,CAAC,EACpC,KAAK;AAGR,aAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;AAC3C,UAAI,YAAY,CAAC,MAAM,YAAY,CAAC,GAAG;AACrC,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/index.js

@@ -45,7 +45,7 @@ var HttpServer = class {
   app;
   utteranceQueue;
   port;
-  constructor(utteranceQueue, port = 3e3) {
+  constructor(utteranceQueue, port = 5111) {
     this.utteranceQueue = utteranceQueue;
     this.port = port;
     this.app = express();
@@ -115,10 +115,11 @@ var HttpServer = class {
 // src/index.ts
 async function main() {
   const utteranceQueue = new InMemoryUtteranceQueue();
-  const httpServer = new HttpServer(utteranceQueue);
+  const port = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;
+  const httpServer = new HttpServer(utteranceQueue, port);
   await httpServer.start();
   console.log("Voice Hooks servers ready!");
-  console.log("- HTTP server: http://localhost:3000");
+  console.log(`- HTTP server: http://localhost:${port}`);
   console.log("- MCP server: Ready for stdio connection");
 }
 main().catch(console.error);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utterance-queue.ts","../src/http-server.ts","../src/index.ts"],"sourcesContent":["import { Utterance, UtteranceQueue } from './types.js';\nimport { randomUUID } from 'crypto';\nimport { debugLog } from './debug.js';\n\nexport class InMemoryUtteranceQueue implements UtteranceQueue {\n  public utterances: Utterance[] = [];\n\n  add(text: string, timestamp?: Date): Utterance {\n    const utterance: Utterance = {\n      id: randomUUID(),\n      text: text.trim(),\n      timestamp: timestamp || new Date(),\n      status: 'pending'\n    };\n    \n    this.utterances.push(utterance);\n    debugLog(`[Queue] queued:\t\"${utterance.text}\"\t[id: ${utterance.id}]`);\n    return utterance;\n  }\n\n  getRecent(limit: number = 10): Utterance[] {\n    return this.utterances\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())\n      .slice(0, limit);\n  }\n\n  markDelivered(id: string): void {\n    const utterance = this.utterances.find(u => u.id === id);\n    if (utterance) {\n      utterance.status = 'delivered';\n      debugLog(`[Queue] delivered:\t\"${utterance.text}\"\t[id: ${id}]`);\n    }\n  }\n\n  clear(): void {\n    const count = this.utterances.length;\n    this.utterances = [];\n    debugLog(`[Queue] Cleared ${count} utterances`);\n  }\n}","import express from 'express';\nimport cors from 'cors';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { InMemoryUtteranceQueue } from './utterance-queue.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport class HttpServer {\n  private app: express.Application;\n  private utteranceQueue: InMemoryUtteranceQueue;\n  private port: number;\n\n  constructor(utteranceQueue: InMemoryUtteranceQueue, port: number = 3000) {\n    this.utteranceQueue = utteranceQueue;\n    this.port = port;\n    this.app = express();\n    this.setupMiddleware();\n    this.setupRoutes();\n  }\n\n  private setupMiddleware() {\n    this.app.use(cors());\n    this.app.use(express.json());\n    this.app.use(express.static(path.join(__dirname, '..', 'public')));\n  }\n\n  private setupRoutes() {\n    // API Routes\n    this.app.post('/api/potential-utterances', (req: express.Request, res: express.Response) => {\n      const { text, timestamp } = req.body;\n      \n      if (!text || !text.trim()) {\n        res.status(400).json({ error: 'Text is required' });\n        return;\n      }\n\n      const parsedTimestamp = timestamp ? new Date(timestamp) : undefined;\n      const utterance = this.utteranceQueue.add(text, parsedTimestamp);\n      res.json({\n        success: true,\n        utterance: {\n          id: utterance.id,\n          text: utterance.text,\n          timestamp: utterance.timestamp,\n          status: utterance.status,\n        },\n      });\n    });\n\n    this.app.get('/api/utterances', (req: express.Request, res: express.Response) => {\n      const limit = parseInt(req.query.limit as string) || 10;\n      const utterances = this.utteranceQueue.getRecent(limit);\n      \n      res.json({\n        utterances: utterances.map(u => ({\n          id: u.id,\n          text: u.text,\n          timestamp: u.timestamp,\n          status: u.status,\n        })),\n      });\n    });\n\n    this.app.get('/api/utterances/status', (req: express.Request, res: express.Response) => {\n      const total = this.utteranceQueue.utterances.length;\n      const pending = this.utteranceQueue.utterances.filter(u => u.status === 'pending').length;\n      const delivered = this.utteranceQueue.utterances.filter(u => u.status === 'delivered').length;\n\n      res.json({\n        total,\n        pending,\n        delivered,\n      });\n    });\n\n    // Serve the browser client\n    this.app.get('/', (req: express.Request, res: express.Response) => {\n      res.sendFile(path.join(__dirname, '..', 'public', 'index.html'));\n    });\n  }\n\n  start(): Promise<void> {\n    return new Promise((resolve) => {\n      this.app.listen(this.port, () => {\n        console.log(`HTTP Server running on http://localhost:${this.port}`);\n        resolve();\n      });\n    });\n  }\n}","import { InMemoryUtteranceQueue } from './utterance-queue.js';\nimport { HttpServer } from './http-server.js';\n\nasync function main() {\n  // Shared utterance queue between HTTP and MCP servers\n  const utteranceQueue = new InMemoryUtteranceQueue();\n  \n  // Start HTTP server for browser client\n  const httpServer = new HttpServer(utteranceQueue);\n  await httpServer.start();\n  \n  // Note: MCP server runs separately via `npm run mcp` command\n  \n  console.log('Voice Hooks servers ready!');\n  console.log('- HTTP server: http://localhost:3000');\n  console.log('- MCP server: Ready for stdio connection');\n}\n\nmain().catch(console.error);"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/utterance-queue.ts","../src/http-server.ts","../src/index.ts"],"sourcesContent":["import { Utterance, UtteranceQueue } from './types.js';\nimport { randomUUID } from 'crypto';\nimport { debugLog } from './debug.js';\n\nexport class InMemoryUtteranceQueue implements UtteranceQueue {\n  public utterances: Utterance[] = [];\n\n  add(text: string, timestamp?: Date): Utterance {\n    const utterance: Utterance = {\n      id: randomUUID(),\n      text: text.trim(),\n      timestamp: timestamp || new Date(),\n      status: 'pending'\n    };\n    \n    this.utterances.push(utterance);\n    debugLog(`[Queue] queued:\t\"${utterance.text}\"\t[id: ${utterance.id}]`);\n    return utterance;\n  }\n\n  getRecent(limit: number = 10): Utterance[] {\n    return this.utterances\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())\n      .slice(0, limit);\n  }\n\n  markDelivered(id: string): void {\n    const utterance = this.utterances.find(u => u.id === id);\n    if (utterance) {\n      utterance.status = 'delivered';\n      debugLog(`[Queue] delivered:\t\"${utterance.text}\"\t[id: ${id}]`);\n    }\n  }\n\n  clear(): void {\n    const count = this.utterances.length;\n    this.utterances = [];\n    debugLog(`[Queue] Cleared ${count} utterances`);\n  }\n}","import express from 'express';\nimport cors from 'cors';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { InMemoryUtteranceQueue } from './utterance-queue.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport class HttpServer {\n  private app: express.Application;\n  private utteranceQueue: InMemoryUtteranceQueue;\n  private port: number;\n\n  constructor(utteranceQueue: InMemoryUtteranceQueue, port: number = 5111) {\n    this.utteranceQueue = utteranceQueue;\n    this.port = port;\n    this.app = express();\n    this.setupMiddleware();\n    this.setupRoutes();\n  }\n\n  private setupMiddleware() {\n    this.app.use(cors());\n    this.app.use(express.json());\n    this.app.use(express.static(path.join(__dirname, '..', 'public')));\n  }\n\n  private setupRoutes() {\n    // API Routes\n    this.app.post('/api/potential-utterances', (req: express.Request, res: express.Response) => {\n      const { text, timestamp } = req.body;\n      \n      if (!text || !text.trim()) {\n        res.status(400).json({ error: 'Text is required' });\n        return;\n      }\n\n      const parsedTimestamp = timestamp ? new Date(timestamp) : undefined;\n      const utterance = this.utteranceQueue.add(text, parsedTimestamp);\n      res.json({\n        success: true,\n        utterance: {\n          id: utterance.id,\n          text: utterance.text,\n          timestamp: utterance.timestamp,\n          status: utterance.status,\n        },\n      });\n    });\n\n    this.app.get('/api/utterances', (req: express.Request, res: express.Response) => {\n      const limit = parseInt(req.query.limit as string) || 10;\n      const utterances = this.utteranceQueue.getRecent(limit);\n      \n      res.json({\n        utterances: utterances.map(u => ({\n          id: u.id,\n          text: u.text,\n          timestamp: u.timestamp,\n          status: u.status,\n        })),\n      });\n    });\n\n    this.app.get('/api/utterances/status', (req: express.Request, res: express.Response) => {\n      const total = this.utteranceQueue.utterances.length;\n      const pending = this.utteranceQueue.utterances.filter(u => u.status === 'pending').length;\n      const delivered = this.utteranceQueue.utterances.filter(u => u.status === 'delivered').length;\n\n      res.json({\n        total,\n        pending,\n        delivered,\n      });\n    });\n\n    // Serve the browser client\n    this.app.get('/', (req: express.Request, res: express.Response) => {\n      res.sendFile(path.join(__dirname, '..', 'public', 'index.html'));\n    });\n  }\n\n  start(): Promise<void> {\n    return new Promise((resolve) => {\n      this.app.listen(this.port, () => {\n        console.log(`HTTP Server running on http://localhost:${this.port}`);\n        resolve();\n      });\n    });\n  }\n}","import { InMemoryUtteranceQueue } from './utterance-queue.js';\nimport { HttpServer } from './http-server.js';\n\nasync function main() {\n  // Shared utterance queue between HTTP and MCP servers\n  const utteranceQueue = new InMemoryUtteranceQueue();\n  \n  // Start HTTP server for browser client\n  const port = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;\n  const httpServer = new HttpServer(utteranceQueue, port);\n  await httpServer.start();\n  \n  // Note: MCP server runs separately via `npm run mcp` command\n  \n  console.log('Voice Hooks servers ready!');\n  console.log(`- HTTP server: http://localhost:${port}`);\n  console.log('- MCP server: Ready for stdio connection');\n}\n\nmain().catch(console.error);"],"mappings":"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","names":[]}

package/dist/unified-server.js

@@ -208,7 +208,7 @@ app.delete("/api/utterances", (req, res) => {
 app.get("/", (req, res) => {
   res.sendFile(path.join(__dirname, "..", "public", "index.html"));
 });
-var HTTP_PORT = 3e3;
+var HTTP_PORT = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;
 app.listen(HTTP_PORT, () => {
   console.log(`[HTTP] Server listening on http://localhost:${HTTP_PORT}`);
   console.log(`[Mode] Running in ${IS_MCP_MANAGED ? "MCP-managed" : "standalone"} mode`);
@@ -267,7 +267,7 @@ if (IS_MCP_MANAGED) {
     try {
       if (name === "dequeue_utterances") {
         const limit = args?.limit ?? 10;
-        const response = await fetch("http://localhost:3000/api/dequeue-utterances", {
+        const response = await fetch(`http://localhost:${HTTP_PORT}/api/dequeue-utterances`, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ limit })
@@ -301,7 +301,7 @@ ${data.utterances.reverse().map((u) => `"${u.text}"	[time: ${new Date(u.timestam
           Math.min(MAX_WAIT_TIMEOUT_SECONDS, requestedSeconds)
         );
         debugLog(`[MCP] Calling wait_for_utterance with ${secondsToWait}s timeout`);
-        const response = await fetch("http://localhost:3000/api/wait-for-utterances", {
+        const response = await fetch(`http://localhost:${HTTP_PORT}/api/wait-for-utterances`, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ seconds_to_wait: secondsToWait })