mcp-voice-hooks 1.0.2 → 1.0.8

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

@@ -0,0 +1,3 @@
+#!/bin/bash
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-speak || echo '{"decision": "approve"}'

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

@@ -1,30 +1,3 @@
 #!/bin/bash
-
-# Pre-Tool Hook - Checks for pending utterances before allowing tool execution
-# Forces Claude to use dequeue_utterances tool if there are pending utterances
-
-# Check has-pending-utterances endpoint
-response=$(curl -s http://localhost:3000/api/has-pending-utterances 2>/dev/null)
-
-if [ $? -ne 0 ]; then
-    # Server not available, allow tool execution
-    echo '{"decision": "approve"}'
-    exit 0
-fi
-
-# Extract pending status
-hasPending=$(echo "$response" | jq -r '.hasPending')
-pendingCount=$(echo "$response" | jq -r '.pendingCount')
-
-if [ "$hasPending" = "true" ]; then
-    # There are pending utterances, block tool execution
-    cat <<EOF
-{
-  "decision": "block",
-  "reason": "There are $pendingCount pending voice utterances. Please use dequeue_utterances to process them first."
-}
-EOF
-else
-    # No pending utterances, allow tool execution
-    echo '{"decision": "approve"}'
-fi
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-tool || echo '{"decision": "approve"}'

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

@@ -0,0 +1,3 @@
+#!/bin/bash
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-wait || echo '{"decision": "approve"}'

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

@@ -1,29 +1,3 @@
 #!/bin/bash
-
-# Stop Hook - Intelligently decides whether to wait for voice input
-# Checks if there have been any utterances since the last timeout
-
-# Check should-wait endpoint
-response=$(curl -s http://localhost:3000/api/should-wait 2>/dev/null)
-
-if [ $? -ne 0 ]; then
-    # Server not available, allow stop
-    echo '{"decision": "approve"}'
-    exit 0
-fi
-
-# Extract shouldWait boolean
-shouldWait=$(echo "$response" | jq -r '.shouldWait')
-
-if [ "$shouldWait" = "true" ]; then
-    # There have been utterances since last timeout, block and ask to wait
-    cat <<EOF
-{
-  "decision": "block",
-  "reason": "Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input"
-}
-EOF
-else
-    # No utterances since last timeout, allow stop
-    echo '{"decision": "approve", "reason": "No utterances since last timeout"}'
-fi
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/stop || echo '{"decision": "approve"}'

package/README.md

@@ -23,17 +23,7 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
 
 ## Installation in Your Own Project
 
-1. **Install the hooks** (first time only):
-
-   ```bash
-   npx mcp-voice-hooks install-hooks
-   ```
-
-   This will:
-   - Install hook scripts to `~/.mcp-voice-hooks/hooks/`
-   - Configure your project's `.claude/settings.json`
-
-2. **Add the MCP server**:
+1. **Add the MCP server**:
 
    Run the following command to automatically add the MCP server to your current project in `~/.claude.json`:
 
@@ -56,13 +46,17 @@ 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:5111> 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`:
 
@@ -74,13 +68,45 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
    }
    ```
 
+## 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
 
 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
@@ -99,8 +125,9 @@ claude
 **Important**: When developing with `npm link`:
 
 - Claude runs the compiled JavaScript from the `dist` folder, not your TypeScript source
-- After making changes to the TypeScript code, you must run `npm run build`
-- Then restart Claude Code to use the updated compiled code
+- 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
 

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
@@ -124,29 +163,68 @@ async function configureClaudeCodeSettings() {
             "command": "sh ~/.mcp-voice-hooks/hooks/pre-tool-hook.sh"
           }
         ]
-      }
-    ],
-    "PostToolUse": [
+      },
+      {
+        "matcher": "^mcp__voice-hooks__speak$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh ~/.mcp-voice-hooks/hooks/pre-speak-hook.sh"
+          }
+        ]
+      },
       {
-        "matcher": "^mcp__voice-hooks__",
+        "matcher": "^mcp__voice-hooks__wait_for_utterance$",
         "hooks": [
           {
             "type": "command",
-            "command": "sh ~/.mcp-voice-hooks/hooks/post-tool-voice-hook.sh"
+            "command": "sh ~/.mcp-voice-hooks/hooks/pre-wait-hook.sh"
           }
         ]
       }
     ]
   };
   
-  // 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');
+  
+  try {
+    console.log('🔄 Updating hooks to latest version...');
+    
+    // Always remove and recreate the hooks directory to ensure clean state
+    if (fs.existsSync(hooksDir)) {
+      fs.rmSync(hooksDir, { recursive: true, force: true });
+    }
+    
+    // Recreate with latest hooks
+    await ensureUserDirectorySetup();
+    await configureClaudeCodeSettings();
+    console.log('✅ Hooks and settings updated');
+  } 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 +257,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/unified-server.js

@@ -63,6 +63,8 @@ var UtteranceQueue = class {
 var IS_MCP_MANAGED = process.argv.includes("--mcp-managed");
 var queue = new UtteranceQueue();
 var lastTimeoutTimestamp = null;
+var lastToolUseTimestamp = null;
+var lastSpeakTimestamp = null;
 var app = express();
 app.use(cors());
 app.use(express.json());
@@ -196,6 +198,122 @@ app.get("/api/has-pending-utterances", (req, res) => {
     pendingCount
   });
 });
+app.post("/api/validate-action", (req, res) => {
+  const { action } = req.body;
+  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === "true";
+  if (!action || !["tool-use", "stop"].includes(action)) {
+    res.status(400).json({ error: 'Invalid action. Must be "tool-use" or "stop"' });
+    return;
+  }
+  const pendingUtterances = queue.utterances.filter((u) => u.status === "pending");
+  if (pendingUtterances.length > 0) {
+    res.json({
+      allowed: false,
+      requiredAction: "dequeue_utterances",
+      reason: `${pendingUtterances.length} pending utterance(s) must be dequeued first. Please use dequeue_utterances to process them.`
+    });
+    return;
+  }
+  if (voiceResponsesEnabled) {
+    const deliveredUtterances = queue.utterances.filter((u) => u.status === "delivered");
+    if (deliveredUtterances.length > 0) {
+      res.json({
+        allowed: false,
+        requiredAction: "speak",
+        reason: `${deliveredUtterances.length} delivered utterance(s) require voice response. Please use the speak tool to respond before proceeding.`
+      });
+      return;
+    }
+  }
+  if (action === "stop") {
+    const shouldWait = !lastTimeoutTimestamp || queue.utterances.some((u) => u.timestamp > lastTimeoutTimestamp);
+    if (shouldWait) {
+      res.json({
+        allowed: false,
+        requiredAction: "wait_for_utterance",
+        reason: "Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input"
+      });
+      return;
+    }
+  }
+  res.json({
+    allowed: true
+  });
+});
+function handleHookRequest(attemptedAction) {
+  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === "true";
+  const pendingUtterances = queue.utterances.filter((u) => u.status === "pending");
+  if (pendingUtterances.length > 0) {
+    return {
+      decision: "block",
+      reason: `${pendingUtterances.length} pending utterance(s) must be dequeued first. Please use dequeue_utterances to process them.`
+    };
+  }
+  if (voiceResponsesEnabled) {
+    const deliveredUtterances = queue.utterances.filter((u) => u.status === "delivered");
+    if (deliveredUtterances.length > 0) {
+      if (attemptedAction === "speak") {
+        return { decision: "approve" };
+      }
+      return {
+        decision: "block",
+        reason: `${deliveredUtterances.length} delivered utterance(s) require voice response. Please use the speak tool to respond before proceeding.`
+      };
+    }
+  }
+  if (attemptedAction === "tool") {
+    lastToolUseTimestamp = /* @__PURE__ */ new Date();
+    return { decision: "approve" };
+  }
+  if (attemptedAction === "wait") {
+    if (voiceResponsesEnabled && lastToolUseTimestamp && (!lastSpeakTimestamp || lastSpeakTimestamp < lastToolUseTimestamp)) {
+      return {
+        decision: "block",
+        reason: "Assistant must speak after using tools. Please use the speak tool to respond before waiting for utterances."
+      };
+    }
+    return { decision: "approve" };
+  }
+  if (attemptedAction === "speak") {
+    return { decision: "approve" };
+  }
+  if (attemptedAction === "stop") {
+    if (voiceResponsesEnabled && lastToolUseTimestamp && (!lastSpeakTimestamp || lastSpeakTimestamp < lastToolUseTimestamp)) {
+      return {
+        decision: "block",
+        reason: "Assistant must speak after using tools. Please use the speak tool to respond before proceeding."
+      };
+    }
+    const shouldWait = !lastTimeoutTimestamp || queue.utterances.some((u) => u.timestamp > lastTimeoutTimestamp);
+    if (shouldWait) {
+      return {
+        decision: "block",
+        reason: "Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input"
+      };
+    }
+    return {
+      decision: "approve",
+      reason: "No utterances since last timeout"
+    };
+  }
+  return { decision: "approve" };
+}
+app.post("/api/hooks/pre-tool", (_req, res) => {
+  const result = handleHookRequest("tool");
+  res.json(result);
+});
+app.post("/api/hooks/stop", (_req, res) => {
+  const result = handleHookRequest("stop");
+  res.json(result);
+});
+app.post("/api/hooks/pre-speak", (_req, res) => {
+  const result = handleHookRequest("speak");
+  res.json(result);
+});
+app.post("/api/hooks/pre-wait", (_req, res) => {
+  const result = handleHookRequest("wait");
+  res.json(result);
+});
 app.delete("/api/utterances", (req, res) => {
   const clearedCount = queue.utterances.length;
   queue.clear();
@@ -205,7 +323,35 @@ app.delete("/api/utterances", (req, res) => {
     clearedCount
   });
 });
-app.get("/", (req, res) => {
+app.post("/api/speak", async (req, res) => {
+  const { text } = req.body;
+  if (!text || !text.trim()) {
+    res.status(400).json({ error: "Text is required" });
+    return;
+  }
+  try {
+    await execAsync(`say -r 350 "${text.replace(/"/g, '\\"')}"`);
+    debugLog(`[Speak] Spoke text: "${text}"`);
+    const deliveredUtterances = queue.utterances.filter((u) => u.status === "delivered");
+    deliveredUtterances.forEach((u) => {
+      u.status = "responded";
+      debugLog(`[Queue] marked as responded: "${u.text}"	[id: ${u.id}]`);
+    });
+    lastSpeakTimestamp = /* @__PURE__ */ new Date();
+    res.json({
+      success: true,
+      message: "Text spoken successfully",
+      respondedCount: deliveredUtterances.length
+    });
+  } catch (error) {
+    debugLog(`[Speak] Failed to speak text: ${error}`);
+    res.status(500).json({
+      error: "Failed to speak text",
+      details: error instanceof Error ? error.message : String(error)
+    });
+  }
+});
+app.get("/", (_req, res) => {
   res.sendFile(path.join(__dirname, "..", "public", "index.html"));
 });
 var HTTP_PORT = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;
@@ -213,6 +359,10 @@ 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`);
 });
+function getVoiceResponseReminder() {
+  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === "true";
+  return voiceResponsesEnabled ? "\n\nThe user has enabled voice responses, so use the 'speak' tool to respond to the user's voice input before proceeding." : "";
+}
 if (IS_MCP_MANAGED) {
   console.log("[MCP] Initializing MCP server...");
   const mcpServer = new Server(
@@ -258,6 +408,20 @@ if (IS_MCP_MANAGED) {
               }
             }
           }
+        },
+        {
+          name: "speak",
+          description: "Speak text using text-to-speech and mark delivered utterances as responded",
+          inputSchema: {
+            type: "object",
+            properties: {
+              text: {
+                type: "string",
+                description: "The text to speak"
+              }
+            },
+            required: ["text"]
+          }
         }
       ]
     };
@@ -289,7 +453,7 @@ if (IS_MCP_MANAGED) {
               type: "text",
               text: `Dequeued ${data.utterances.length} utterance(s):
 
-${data.utterances.reverse().map((u) => `"${u.text}"	[time: ${new Date(u.timestamp).toISOString()}]`).join("\n")}`
+${data.utterances.reverse().map((u) => `"${u.text}"	[time: ${new Date(u.timestamp).toISOString()}]`).join("\n")}${getVoiceResponseReminder()}`
             }
           ]
         };
@@ -315,7 +479,7 @@ ${data.utterances.reverse().map((u) => `"${u.text}"	[time: ${new Date(u.timestam
                 type: "text",
                 text: `Found ${data.count} utterance(s):
 
-${utteranceTexts}`
+${utteranceTexts}${getVoiceResponseReminder()}`
               }
             ]
           };
@@ -330,6 +494,47 @@ ${utteranceTexts}`
           };
         }
       }
+      if (name === "speak") {
+        const text = args?.text;
+        if (!text || !text.trim()) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Error: Text is required for speak tool"
+              }
+            ],
+            isError: true
+          };
+        }
+        const response = await fetch(`http://localhost:${HTTP_PORT}/api/speak`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ text })
+        });
+        const data = await response.json();
+        if (response.ok) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Spoke: "${text}"
+${data.respondedCount > 0 ? `Marked ${data.respondedCount} utterance(s) as responded.` : "No delivered utterances to mark as responded."}`
+              }
+            ]
+          };
+        } else {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error speaking text: ${data.error || "Unknown error"}`
+              }
+            ],
+            isError: true
+          };
+        }
+      }
       throw new Error(`Unknown tool: ${name}`);
     } catch (error) {
       return {

package/dist/unified-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/unified-server.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport express from 'express';\nimport type { Request, Response } from 'express';\nimport cors from 'cors';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { randomUUID } from 'crypto';\nimport { exec } from 'child_process';\nimport { promisify } from 'util';\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { debugLog } from './debug.ts';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Constants\nconst DEFAULT_WAIT_TIMEOUT_SECONDS = 30;\nconst MIN_WAIT_TIMEOUT_SECONDS = 30;\nconst MAX_WAIT_TIMEOUT_SECONDS = 60;\n\n// Promisified exec for async/await\nconst execAsync = promisify(exec);\n\n// Function to play a sound notification\nasync function playNotificationSound() {\n  try {\n    // Use macOS system sound\n    await execAsync('afplay /System/Library/Sounds/Funk.aiff');\n    debugLog('[Sound] Played notification sound');\n  } catch (error) {\n    debugLog(`[Sound] Failed to play sound: ${error}`);\n    // Don't throw - sound is not critical\n  }\n}\n\n// Shared utterance queue\ninterface Utterance {\n  id: string;\n  text: string;\n  timestamp: Date;\n  status: 'pending' | 'delivered';\n}\n\nclass UtteranceQueue {\n  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: \"${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: \"${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}\n\n// Determine if we're running in MCP-managed mode\nconst IS_MCP_MANAGED = process.argv.includes('--mcp-managed');\n\n// Global state\nconst queue = new UtteranceQueue();\nlet lastTimeoutTimestamp: Date | null = null;\n\n// HTTP Server Setup (always created)\nconst app = express();\napp.use(cors());\napp.use(express.json());\napp.use(express.static(path.join(__dirname, '..', 'public')));\n\n// API Routes\napp.post('/api/potential-utterances', (req: Request, res: 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 = queue.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\napp.get('/api/utterances', (req: Request, res: Response) => {\n  const limit = parseInt(req.query.limit as string) || 10;\n  const utterances = queue.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\napp.get('/api/utterances/status', (req: Request, res: Response) => {\n  const total = queue.utterances.length;\n  const pending = queue.utterances.filter(u => u.status === 'pending').length;\n  const delivered = queue.utterances.filter(u => u.status === 'delivered').length;\n\n  res.json({\n    total,\n    pending,\n    delivered,\n  });\n});\n\n// MCP server integration\napp.post('/api/dequeue-utterances', (req: Request, res: Response) => {\n  const { limit = 10 } = req.body;\n  const pendingUtterances = queue.utterances\n    .filter(u => u.status === 'pending')\n    .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())\n    .slice(0, limit);\n\n  // Mark as delivered\n  pendingUtterances.forEach(u => {\n    queue.markDelivered(u.id);\n  });\n\n  res.json({\n    success: true,\n    utterances: pendingUtterances.map(u => ({\n      text: u.text,\n      timestamp: u.timestamp,\n    })),\n  });\n});\n\n// Wait for utterance endpoint\napp.post('/api/wait-for-utterances', async (req: Request, res: Response) => {\n  const { seconds_to_wait = DEFAULT_WAIT_TIMEOUT_SECONDS } = req.body;\n  const secondsToWait = Math.max(\n    MIN_WAIT_TIMEOUT_SECONDS,\n    Math.min(MAX_WAIT_TIMEOUT_SECONDS, seconds_to_wait)\n  );\n  const maxWaitMs = secondsToWait * 1000;\n  const startTime = Date.now();\n\n  debugLog(`[Server] Starting wait_for_utterance (${secondsToWait}s)`);\n\n  // Check if we should return immediately\n  if (lastTimeoutTimestamp) {\n    const hasNewUtterances = queue.utterances.some(\n      u => u.timestamp > lastTimeoutTimestamp!\n    );\n    if (!hasNewUtterances) {\n      debugLog('[Server] No new utterances since last timeout, returning immediately');\n      res.json({\n        success: true,\n        utterances: [],\n        message: `No utterances found after waiting ${secondsToWait} seconds.`,\n        waitTime: 0,\n      });\n      return;\n    }\n  }\n\n  let firstTime = true;\n\n  // Poll for utterances\n  while (Date.now() - startTime < maxWaitMs) {\n    const pendingUtterances = queue.utterances.filter(\n      u => u.status === 'pending' &&\n        (!lastTimeoutTimestamp || u.timestamp > lastTimeoutTimestamp)\n    );\n\n    if (pendingUtterances.length > 0) {\n      // Found utterances - clear lastTimeoutTimestamp\n      lastTimeoutTimestamp = null;\n\n      // Sort by timestamp (oldest first)\n      const sortedUtterances = pendingUtterances\n        .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());\n\n      // Mark utterances as delivered\n      sortedUtterances.forEach(u => {\n        queue.markDelivered(u.id);\n      });\n\n      res.json({\n        success: true,\n        utterances: sortedUtterances.map(u => ({\n          id: u.id,\n          text: u.text,\n          timestamp: u.timestamp,\n          status: 'delivered', // They are now delivered\n        })),\n        count: pendingUtterances.length,\n        waitTime: Date.now() - startTime,\n      });\n      return;\n    }\n\n    if (firstTime) {\n      firstTime = false;\n      // Play notification sound since we're about to start waiting\n      await playNotificationSound();\n    }\n\n    // Wait 100ms before checking again\n    await new Promise(resolve => setTimeout(resolve, 100));\n  }\n\n  // Timeout reached - no utterances found\n  lastTimeoutTimestamp = new Date();\n\n  res.json({\n    success: true,\n    utterances: [],\n    message: `No utterances found after waiting ${secondsToWait} seconds.`,\n    waitTime: maxWaitMs,\n  });\n});\n\n// API for the stop hook to check if it should wait\napp.get('/api/should-wait', (req: Request, res: Response) => {\n  const shouldWait = !lastTimeoutTimestamp ||\n    queue.utterances.some(u => u.timestamp > lastTimeoutTimestamp!);\n\n  res.json({ shouldWait });\n});\n\n// API for pre-tool hook to check for pending utterances\napp.get('/api/has-pending-utterances', (req: Request, res: Response) => {\n  const pendingCount = queue.utterances.filter(u => u.status === 'pending').length;\n  const hasPending = pendingCount > 0;\n\n  res.json({\n    hasPending,\n    pendingCount\n  });\n});\n\n// API to clear all utterances\napp.delete('/api/utterances', (req: Request, res: Response) => {\n  const clearedCount = queue.utterances.length;\n  queue.clear();\n\n  res.json({\n    success: true,\n    message: `Cleared ${clearedCount} utterances`,\n    clearedCount\n  });\n});\n\napp.get('/', (req: Request, res: Response) => {\n  res.sendFile(path.join(__dirname, '..', 'public', 'index.html'));\n});\n\n// Start HTTP server\nconst HTTP_PORT = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;\napp.listen(HTTP_PORT, () => {\n  console.log(`[HTTP] Server listening on http://localhost:${HTTP_PORT}`);\n  console.log(`[Mode] Running in ${IS_MCP_MANAGED ? 'MCP-managed' : 'standalone'} mode`);\n});\n\n// MCP Server Setup (only if MCP-managed)\nif (IS_MCP_MANAGED) {\n  console.log('[MCP] Initializing MCP server...');\n\n  const mcpServer = new Server(\n    {\n      name: 'voice-hooks',\n      version: '1.0.0',\n    },\n    {\n      capabilities: {\n        tools: {},\n      },\n    }\n  );\n\n  // Tool handlers\n  mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {\n    return {\n      tools: [\n        {\n          name: 'dequeue_utterances',\n          description: 'Dequeue pending utterances and mark them as delivered',\n          inputSchema: {\n            type: 'object',\n            properties: {\n              limit: {\n                type: 'number',\n                description: 'Maximum number of utterances to dequeue (default: 10)',\n                default: 10,\n              },\n            },\n          },\n        },\n        {\n          name: 'wait_for_utterance',\n          description: 'Wait for an utterance to be available or until timeout. Returns immediately if no utterances since last timeout.',\n          inputSchema: {\n            type: 'object',\n            properties: {\n              seconds_to_wait: {\n                type: 'number',\n                description: `Maximum seconds to wait for an utterance (default: ${DEFAULT_WAIT_TIMEOUT_SECONDS}, min: ${MIN_WAIT_TIMEOUT_SECONDS}, max: ${MAX_WAIT_TIMEOUT_SECONDS})`,\n                default: DEFAULT_WAIT_TIMEOUT_SECONDS,\n                minimum: MIN_WAIT_TIMEOUT_SECONDS,\n                maximum: MAX_WAIT_TIMEOUT_SECONDS,\n              },\n            },\n          },\n        },\n      ],\n    };\n  });\n\n  mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n\n    try {\n      if (name === 'dequeue_utterances') {\n        const limit = (args?.limit as number) ?? 10;\n        const response = await fetch(`http://localhost:${HTTP_PORT}/api/dequeue-utterances`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ limit }),\n        });\n\n        const data = await response.json() as any;\n\n        if (data.utterances.length === 0) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: 'No recent utterances found.',\n              },\n            ],\n          };\n        }\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Dequeued ${data.utterances.length} utterance(s):\\n\\n${data.utterances.reverse().map((u: any) => `\"${u.text}\"\\t[time: ${new Date(u.timestamp).toISOString()}]`).join('\\n')\n                }`,\n            },\n          ],\n        };\n      }\n\n      if (name === 'wait_for_utterance') {\n        const requestedSeconds = (args?.seconds_to_wait as number) ?? DEFAULT_WAIT_TIMEOUT_SECONDS;\n        const secondsToWait = Math.max(\n          MIN_WAIT_TIMEOUT_SECONDS,\n          Math.min(MAX_WAIT_TIMEOUT_SECONDS, requestedSeconds)\n        );\n        debugLog(`[MCP] Calling wait_for_utterance with ${secondsToWait}s timeout`);\n\n        const response = await fetch(`http://localhost:${HTTP_PORT}/api/wait-for-utterances`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ seconds_to_wait: secondsToWait }),\n        });\n\n        const data = await response.json() as any;\n\n        if (data.utterances && data.utterances.length > 0) {\n          const utteranceTexts = data.utterances\n            .map((u: any) => `[${u.timestamp}] \"${u.text}\"`)\n            .join('\\n');\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Found ${data.count} utterance(s):\\n\\n${utteranceTexts}`,\n              },\n            ],\n          };\n        } else {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: data.message || `No utterances found after waiting ${secondsToWait} seconds.`,\n              },\n            ],\n          };\n        }\n      }\n\n      throw new Error(`Unknown tool: ${name}`);\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Error: ${error instanceof Error ? error.message : String(error)}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  });\n\n  // Connect via stdio\n  const transport = new StdioServerTransport();\n  mcpServer.connect(transport);\n  console.log('[MCP] Server connected via stdio');\n} else {\n  console.log('[MCP] Skipping MCP server initialization (not in MCP-managed mode)');\n}"],"mappings":";;;;;;AAEA,OAAO,aAAa;AAEpB,OAAO,UAAU;AACjB,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AAEvB,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,KAAK,QAAQ,UAAU;AAGzC,IAAM,+BAA+B;AACrC,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAGjC,IAAM,YAAY,UAAU,IAAI;AAGhC,eAAe,wBAAwB;AACrC,MAAI;AAEF,UAAM,UAAU,yCAAyC;AACzD,aAAS,mCAAmC;AAAA,EAC9C,SAAS,OAAO;AACd,aAAS,iCAAiC,KAAK,EAAE;AAAA,EAEnD;AACF;AAUA,IAAM,iBAAN,MAAqB;AAAA,EACnB,aAA0B,CAAC;AAAA,EAE3B,IAAI,MAAc,WAA6B;AAC7C,UAAM,YAAuB;AAAA,MAC3B,IAAI,WAAW;AAAA,MACf,MAAM,KAAK,KAAK;AAAA,MAChB,WAAW,aAAa,oBAAI,KAAK;AAAA,MACjC,QAAQ;AAAA,IACV;AAEA,SAAK,WAAW,KAAK,SAAS;AAC9B,aAAS,oBAAoB,UAAU,IAAI,UAAU,UAAU,EAAE,GAAG;AACpE,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,QAAgB,IAAiB;AACzC,WAAO,KAAK,WACT,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC,EAC5D,MAAM,GAAG,KAAK;AAAA,EACnB;AAAA,EAEA,cAAc,IAAkB;AAC9B,UAAM,YAAY,KAAK,WAAW,KAAK,OAAK,EAAE,OAAO,EAAE;AACvD,QAAI,WAAW;AACb,gBAAU,SAAS;AACnB,eAAS,uBAAuB,UAAU,IAAI,UAAU,EAAE,GAAG;AAAA,IAC/D;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,UAAM,QAAQ,KAAK,WAAW;AAC9B,SAAK,aAAa,CAAC;AACnB,aAAS,mBAAmB,KAAK,aAAa;AAAA,EAChD;AACF;AAGA,IAAM,iBAAiB,QAAQ,KAAK,SAAS,eAAe;AAG5D,IAAM,QAAQ,IAAI,eAAe;AACjC,IAAI,uBAAoC;AAGxC,IAAM,MAAM,QAAQ;AACpB,IAAI,IAAI,KAAK,CAAC;AACd,IAAI,IAAI,QAAQ,KAAK,CAAC;AACtB,IAAI,IAAI,QAAQ,OAAO,KAAK,KAAK,WAAW,MAAM,QAAQ,CAAC,CAAC;AAG5D,IAAI,KAAK,6BAA6B,CAAC,KAAc,QAAkB;AACrE,QAAM,EAAE,MAAM,UAAU,IAAI,IAAI;AAEhC,MAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,GAAG;AACzB,QAAI,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,mBAAmB,CAAC;AAClD;AAAA,EACF;AAEA,QAAM,kBAAkB,YAAY,IAAI,KAAK,SAAS,IAAI;AAC1D,QAAM,YAAY,MAAM,IAAI,MAAM,eAAe;AACjD,MAAI,KAAK;AAAA,IACP,SAAS;AAAA,IACT,WAAW;AAAA,MACT,IAAI,UAAU;AAAA,MACd,MAAM,UAAU;AAAA,MAChB,WAAW,UAAU;AAAA,MACrB,QAAQ,UAAU;AAAA,IACpB;AAAA,EACF,CAAC;AACH,CAAC;AAED,IAAI,IAAI,mBAAmB,CAAC,KAAc,QAAkB;AAC1D,QAAM,QAAQ,SAAS,IAAI,MAAM,KAAe,KAAK;AACrD,QAAM,aAAa,MAAM,UAAU,KAAK;AAExC,MAAI,KAAK;AAAA,IACP,YAAY,WAAW,IAAI,QAAM;AAAA,MAC/B,IAAI,EAAE;AAAA,MACN,MAAM,EAAE;AAAA,MACR,WAAW,EAAE;AAAA,MACb,QAAQ,EAAE;AAAA,IACZ,EAAE;AAAA,EACJ,CAAC;AACH,CAAC;AAED,IAAI,IAAI,0BAA0B,CAAC,KAAc,QAAkB;AACjE,QAAM,QAAQ,MAAM,WAAW;AAC/B,QAAM,UAAU,MAAM,WAAW,OAAO,OAAK,EAAE,WAAW,SAAS,EAAE;AACrE,QAAM,YAAY,MAAM,WAAW,OAAO,OAAK,EAAE,WAAW,WAAW,EAAE;AAEzE,MAAI,KAAK;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH,CAAC;AAGD,IAAI,KAAK,2BAA2B,CAAC,KAAc,QAAkB;AACnE,QAAM,EAAE,QAAQ,GAAG,IAAI,IAAI;AAC3B,QAAM,oBAAoB,MAAM,WAC7B,OAAO,OAAK,EAAE,WAAW,SAAS,EAClC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC,EAC5D,MAAM,GAAG,KAAK;AAGjB,oBAAkB,QAAQ,OAAK;AAC7B,UAAM,cAAc,EAAE,EAAE;AAAA,EAC1B,CAAC;AAED,MAAI,KAAK;AAAA,IACP,SAAS;AAAA,IACT,YAAY,kBAAkB,IAAI,QAAM;AAAA,MACtC,MAAM,EAAE;AAAA,MACR,WAAW,EAAE;AAAA,IACf,EAAE;AAAA,EACJ,CAAC;AACH,CAAC;AAGD,IAAI,KAAK,4BAA4B,OAAO,KAAc,QAAkB;AAC1E,QAAM,EAAE,kBAAkB,6BAA6B,IAAI,IAAI;AAC/D,QAAM,gBAAgB,KAAK;AAAA,IACzB;AAAA,IACA,KAAK,IAAI,0BAA0B,eAAe;AAAA,EACpD;AACA,QAAM,YAAY,gBAAgB;AAClC,QAAM,YAAY,KAAK,IAAI;AAE3B,WAAS,yCAAyC,aAAa,IAAI;AAGnE,MAAI,sBAAsB;AACxB,UAAM,mBAAmB,MAAM,WAAW;AAAA,MACxC,OAAK,EAAE,YAAY;AAAA,IACrB;AACA,QAAI,CAAC,kBAAkB;AACrB,eAAS,sEAAsE;AAC/E,UAAI,KAAK;AAAA,QACP,SAAS;AAAA,QACT,YAAY,CAAC;AAAA,QACb,SAAS,qCAAqC,aAAa;AAAA,QAC3D,UAAU;AAAA,MACZ,CAAC;AACD;AAAA,IACF;AAAA,EACF;AAEA,MAAI,YAAY;AAGhB,SAAO,KAAK,IAAI,IAAI,YAAY,WAAW;AACzC,UAAM,oBAAoB,MAAM,WAAW;AAAA,MACzC,OAAK,EAAE,WAAW,cACf,CAAC,wBAAwB,EAAE,YAAY;AAAA,IAC5C;AAEA,QAAI,kBAAkB,SAAS,GAAG;AAEhC,6BAAuB;AAGvB,YAAM,mBAAmB,kBACtB,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC;AAG/D,uBAAiB,QAAQ,OAAK;AAC5B,cAAM,cAAc,EAAE,EAAE;AAAA,MAC1B,CAAC;AAED,UAAI,KAAK;AAAA,QACP,SAAS;AAAA,QACT,YAAY,iBAAiB,IAAI,QAAM;AAAA,UACrC,IAAI,EAAE;AAAA,UACN,MAAM,EAAE;AAAA,UACR,WAAW,EAAE;AAAA,UACb,QAAQ;AAAA;AAAA,QACV,EAAE;AAAA,QACF,OAAO,kBAAkB;AAAA,QACzB,UAAU,KAAK,IAAI,IAAI;AAAA,MACzB,CAAC;AACD;AAAA,IACF;AAEA,QAAI,WAAW;AACb,kBAAY;AAEZ,YAAM,sBAAsB;AAAA,IAC9B;AAGA,UAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,GAAG,CAAC;AAAA,EACvD;AAGA,yBAAuB,oBAAI,KAAK;AAEhC,MAAI,KAAK;AAAA,IACP,SAAS;AAAA,IACT,YAAY,CAAC;AAAA,IACb,SAAS,qCAAqC,aAAa;AAAA,IAC3D,UAAU;AAAA,EACZ,CAAC;AACH,CAAC;AAGD,IAAI,IAAI,oBAAoB,CAAC,KAAc,QAAkB;AAC3D,QAAM,aAAa,CAAC,wBAClB,MAAM,WAAW,KAAK,OAAK,EAAE,YAAY,oBAAqB;AAEhE,MAAI,KAAK,EAAE,WAAW,CAAC;AACzB,CAAC;AAGD,IAAI,IAAI,+BAA+B,CAAC,KAAc,QAAkB;AACtE,QAAM,eAAe,MAAM,WAAW,OAAO,OAAK,EAAE,WAAW,SAAS,EAAE;AAC1E,QAAM,aAAa,eAAe;AAElC,MAAI,KAAK;AAAA,IACP;AAAA,IACA;AAAA,EACF,CAAC;AACH,CAAC;AAGD,IAAI,OAAO,mBAAmB,CAAC,KAAc,QAAkB;AAC7D,QAAM,eAAe,MAAM,WAAW;AACtC,QAAM,MAAM;AAEZ,MAAI,KAAK;AAAA,IACP,SAAS;AAAA,IACT,SAAS,WAAW,YAAY;AAAA,IAChC;AAAA,EACF,CAAC;AACH,CAAC;AAED,IAAI,IAAI,KAAK,CAAC,KAAc,QAAkB;AAC5C,MAAI,SAAS,KAAK,KAAK,WAAW,MAAM,UAAU,YAAY,CAAC;AACjE,CAAC;AAGD,IAAM,YAAY,QAAQ,IAAI,uBAAuB,SAAS,QAAQ,IAAI,oBAAoB,IAAI;AAClG,IAAI,OAAO,WAAW,MAAM;AAC1B,UAAQ,IAAI,+CAA+C,SAAS,EAAE;AACtE,UAAQ,IAAI,qBAAqB,iBAAiB,gBAAgB,YAAY,OAAO;AACvF,CAAC;AAGD,IAAI,gBAAgB;AAClB,UAAQ,IAAI,kCAAkC;AAE9C,QAAM,YAAY,IAAI;AAAA,IACpB;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,cAAc;AAAA,QACZ,OAAO,CAAC;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAGA,YAAU,kBAAkB,wBAAwB,YAAY;AAC9D,WAAO;AAAA,MACL,OAAO;AAAA,QACL;AAAA,UACE,MAAM;AAAA,UACN,aAAa;AAAA,UACb,aAAa;AAAA,YACX,MAAM;AAAA,YACN,YAAY;AAAA,cACV,OAAO;AAAA,gBACL,MAAM;AAAA,gBACN,aAAa;AAAA,gBACb,SAAS;AAAA,cACX;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,QACA;AAAA,UACE,MAAM;AAAA,UACN,aAAa;AAAA,UACb,aAAa;AAAA,YACX,MAAM;AAAA,YACN,YAAY;AAAA,cACV,iBAAiB;AAAA,gBACf,MAAM;AAAA,gBACN,aAAa,sDAAsD,4BAA4B,UAAU,wBAAwB,UAAU,wBAAwB;AAAA,gBACnK,SAAS;AAAA,gBACT,SAAS;AAAA,gBACT,SAAS;AAAA,cACX;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAED,YAAU,kBAAkB,uBAAuB,OAAO,YAAY;AACpE,UAAM,EAAE,MAAM,WAAW,KAAK,IAAI,QAAQ;AAE1C,QAAI;AACF,UAAI,SAAS,sBAAsB;AACjC,cAAM,QAAS,MAAM,SAAoB;AACzC,cAAM,WAAW,MAAM,MAAM,oBAAoB,SAAS,2BAA2B;AAAA,UACnF,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,EAAE,MAAM,CAAC;AAAA,QAChC,CAAC;AAED,cAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,YAAI,KAAK,WAAW,WAAW,GAAG;AAChC,iBAAO;AAAA,YACL,SAAS;AAAA,cACP;AAAA,gBACE,MAAM;AAAA,gBACN,MAAM;AAAA,cACR;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAEA,eAAO;AAAA,UACL,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,MAAM,YAAY,KAAK,WAAW,MAAM;AAAA;AAAA,EAAqB,KAAK,WAAW,QAAQ,EAAE,IAAI,CAAC,MAAW,IAAI,EAAE,IAAI,YAAa,IAAI,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,EAAE,KAAK,IAAI,CAC7K;AAAA,YACJ;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,UAAI,SAAS,sBAAsB;AACjC,cAAM,mBAAoB,MAAM,mBAA8B;AAC9D,cAAM,gBAAgB,KAAK;AAAA,UACzB;AAAA,UACA,KAAK,IAAI,0BAA0B,gBAAgB;AAAA,QACrD;AACA,iBAAS,yCAAyC,aAAa,WAAW;AAE1E,cAAM,WAAW,MAAM,MAAM,oBAAoB,SAAS,4BAA4B;AAAA,UACpF,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,EAAE,iBAAiB,cAAc,CAAC;AAAA,QACzD,CAAC;AAED,cAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,YAAI,KAAK,cAAc,KAAK,WAAW,SAAS,GAAG;AACjD,gBAAM,iBAAiB,KAAK,WACzB,IAAI,CAAC,MAAW,IAAI,EAAE,SAAS,MAAM,EAAE,IAAI,GAAG,EAC9C,KAAK,IAAI;AAEZ,iBAAO;AAAA,YACL,SAAS;AAAA,cACP;AAAA,gBACE,MAAM;AAAA,gBACN,MAAM,SAAS,KAAK,KAAK;AAAA;AAAA,EAAqB,cAAc;AAAA,cAC9D;AAAA,YACF;AAAA,UACF;AAAA,QACF,OAAO;AACL,iBAAO;AAAA,YACL,SAAS;AAAA,cACP;AAAA,gBACE,MAAM;AAAA,gBACN,MAAM,KAAK,WAAW,qCAAqC,aAAa;AAAA,cAC1E;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,YAAM,IAAI,MAAM,iBAAiB,IAAI,EAAE;AAAA,IACzC,SAAS,OAAO;AACd,aAAO;AAAA,QACL,SAAS;AAAA,UACP;AAAA,YACE,MAAM;AAAA,YACN,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UACxE;AAAA,QACF;AAAA,QACA,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC;AAGD,QAAM,YAAY,IAAI,qBAAqB;AAC3C,YAAU,QAAQ,SAAS;AAC3B,UAAQ,IAAI,kCAAkC;AAChD,OAAO;AACL,UAAQ,IAAI,oEAAoE;AAClF;","names":[]}
+{"version":3,"sources":["../src/unified-server.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport express from 'express';\nimport type { Request, Response } from 'express';\nimport cors from 'cors';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { randomUUID } from 'crypto';\nimport { exec } from 'child_process';\nimport { promisify } from 'util';\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { debugLog } from './debug.ts';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Constants\nconst DEFAULT_WAIT_TIMEOUT_SECONDS = 30;\nconst MIN_WAIT_TIMEOUT_SECONDS = 30;\nconst MAX_WAIT_TIMEOUT_SECONDS = 60;\n\n// Promisified exec for async/await\nconst execAsync = promisify(exec);\n\n// Function to play a sound notification\nasync function playNotificationSound() {\n  try {\n    // Use macOS system sound\n    await execAsync('afplay /System/Library/Sounds/Funk.aiff');\n    debugLog('[Sound] Played notification sound');\n  } catch (error) {\n    debugLog(`[Sound] Failed to play sound: ${error}`);\n    // Don't throw - sound is not critical\n  }\n}\n\n// Shared utterance queue\ninterface Utterance {\n  id: string;\n  text: string;\n  timestamp: Date;\n  status: 'pending' | 'delivered' | 'responded';\n}\n\nclass UtteranceQueue {\n  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: \"${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: \"${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}\n\n// Determine if we're running in MCP-managed mode\nconst IS_MCP_MANAGED = process.argv.includes('--mcp-managed');\n\n// Global state\nconst queue = new UtteranceQueue();\nlet lastTimeoutTimestamp: Date | null = null;\nlet lastToolUseTimestamp: Date | null = null;\nlet lastSpeakTimestamp: Date | null = null;\n\n// HTTP Server Setup (always created)\nconst app = express();\napp.use(cors());\napp.use(express.json());\napp.use(express.static(path.join(__dirname, '..', 'public')));\n\n// API Routes\napp.post('/api/potential-utterances', (req: Request, res: 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 = queue.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\napp.get('/api/utterances', (req: Request, res: Response) => {\n  const limit = parseInt(req.query.limit as string) || 10;\n  const utterances = queue.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\napp.get('/api/utterances/status', (req: Request, res: Response) => {\n  const total = queue.utterances.length;\n  const pending = queue.utterances.filter(u => u.status === 'pending').length;\n  const delivered = queue.utterances.filter(u => u.status === 'delivered').length;\n\n  res.json({\n    total,\n    pending,\n    delivered,\n  });\n});\n\n// MCP server integration\napp.post('/api/dequeue-utterances', (req: Request, res: Response) => {\n  const { limit = 10 } = req.body;\n  const pendingUtterances = queue.utterances\n    .filter(u => u.status === 'pending')\n    .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())\n    .slice(0, limit);\n\n  // Mark as delivered\n  pendingUtterances.forEach(u => {\n    queue.markDelivered(u.id);\n  });\n\n  res.json({\n    success: true,\n    utterances: pendingUtterances.map(u => ({\n      text: u.text,\n      timestamp: u.timestamp,\n    })),\n  });\n});\n\n// Wait for utterance endpoint\napp.post('/api/wait-for-utterances', async (req: Request, res: Response) => {\n  const { seconds_to_wait = DEFAULT_WAIT_TIMEOUT_SECONDS } = req.body;\n  const secondsToWait = Math.max(\n    MIN_WAIT_TIMEOUT_SECONDS,\n    Math.min(MAX_WAIT_TIMEOUT_SECONDS, seconds_to_wait)\n  );\n  const maxWaitMs = secondsToWait * 1000;\n  const startTime = Date.now();\n\n  debugLog(`[Server] Starting wait_for_utterance (${secondsToWait}s)`);\n\n  // Check if we should return immediately\n  if (lastTimeoutTimestamp) {\n    const hasNewUtterances = queue.utterances.some(\n      u => u.timestamp > lastTimeoutTimestamp!\n    );\n    if (!hasNewUtterances) {\n      debugLog('[Server] No new utterances since last timeout, returning immediately');\n      res.json({\n        success: true,\n        utterances: [],\n        message: `No utterances found after waiting ${secondsToWait} seconds.`,\n        waitTime: 0,\n      });\n      return;\n    }\n  }\n\n  let firstTime = true;\n\n  // Poll for utterances\n  while (Date.now() - startTime < maxWaitMs) {\n    const pendingUtterances = queue.utterances.filter(\n      u => u.status === 'pending' &&\n        (!lastTimeoutTimestamp || u.timestamp > lastTimeoutTimestamp)\n    );\n\n    if (pendingUtterances.length > 0) {\n      // Found utterances - clear lastTimeoutTimestamp\n      lastTimeoutTimestamp = null;\n\n      // Sort by timestamp (oldest first)\n      const sortedUtterances = pendingUtterances\n        .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());\n\n      // Mark utterances as delivered\n      sortedUtterances.forEach(u => {\n        queue.markDelivered(u.id);\n      });\n\n      res.json({\n        success: true,\n        utterances: sortedUtterances.map(u => ({\n          id: u.id,\n          text: u.text,\n          timestamp: u.timestamp,\n          status: 'delivered', // They are now delivered\n        })),\n        count: pendingUtterances.length,\n        waitTime: Date.now() - startTime,\n      });\n      return;\n    }\n\n    if (firstTime) {\n      firstTime = false;\n      // Play notification sound since we're about to start waiting\n      await playNotificationSound();\n    }\n\n    // Wait 100ms before checking again\n    await new Promise(resolve => setTimeout(resolve, 100));\n  }\n\n  // Timeout reached - no utterances found\n  lastTimeoutTimestamp = new Date();\n\n  res.json({\n    success: true,\n    utterances: [],\n    message: `No utterances found after waiting ${secondsToWait} seconds.`,\n    waitTime: maxWaitMs,\n  });\n});\n\n// API for the stop hook to check if it should wait\napp.get('/api/should-wait', (req: Request, res: Response) => {\n  const shouldWait = !lastTimeoutTimestamp ||\n    queue.utterances.some(u => u.timestamp > lastTimeoutTimestamp!);\n\n  res.json({ shouldWait });\n});\n\n// API for pre-tool hook to check for pending utterances\napp.get('/api/has-pending-utterances', (req: Request, res: Response) => {\n  const pendingCount = queue.utterances.filter(u => u.status === 'pending').length;\n  const hasPending = pendingCount > 0;\n\n  res.json({\n    hasPending,\n    pendingCount\n  });\n});\n\n// Unified action validation endpoint\napp.post('/api/validate-action', (req: Request, res: Response) => {\n  const { action } = req.body;\n  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === 'true';\n\n  if (!action || !['tool-use', 'stop'].includes(action)) {\n    res.status(400).json({ error: 'Invalid action. Must be \"tool-use\" or \"stop\"' });\n    return;\n  }\n\n  // Check for pending utterances (both actions)\n  const pendingUtterances = queue.utterances.filter(u => u.status === 'pending');\n  if (pendingUtterances.length > 0) {\n    res.json({\n      allowed: false,\n      requiredAction: 'dequeue_utterances',\n      reason: `${pendingUtterances.length} pending utterance(s) must be dequeued first. Please use dequeue_utterances to process them.`\n    });\n    return;\n  }\n\n  // Check for delivered but unresponded utterances (when voice enabled)\n  if (voiceResponsesEnabled) {\n    const deliveredUtterances = queue.utterances.filter(u => u.status === 'delivered');\n    if (deliveredUtterances.length > 0) {\n      res.json({\n        allowed: false,\n        requiredAction: 'speak',\n        reason: `${deliveredUtterances.length} delivered utterance(s) require voice response. Please use the speak tool to respond before proceeding.`\n      });\n      return;\n    }\n  }\n\n  // For stop action, check if we should wait\n  if (action === 'stop') {\n    const shouldWait = !lastTimeoutTimestamp ||\n      queue.utterances.some(u => u.timestamp > lastTimeoutTimestamp!);\n\n    if (shouldWait) {\n      res.json({\n        allowed: false,\n        requiredAction: 'wait_for_utterance',\n        reason: 'Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input'\n      });\n      return;\n    }\n  }\n\n  // All checks passed - action is allowed\n  res.json({\n    allowed: true\n  });\n});\n\n// Unified hook handler\nfunction handleHookRequest(attemptedAction: 'tool' | 'speak' | 'wait' | 'stop'): { decision: 'approve' | 'block', reason?: string } {\n  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === 'true';\n  \n  // 1. Check for pending utterances\n  const pendingUtterances = queue.utterances.filter(u => u.status === 'pending');\n  if (pendingUtterances.length > 0) {\n    // Allow dequeue to proceed (dequeue doesn't go through hooks)\n    return {\n      decision: 'block',\n      reason: `${pendingUtterances.length} pending utterance(s) must be dequeued first. Please use dequeue_utterances to process them.`\n    };\n  }\n  \n  // 2. Check for delivered utterances (when voice enabled)\n  if (voiceResponsesEnabled) {\n    const deliveredUtterances = queue.utterances.filter(u => u.status === 'delivered');\n    if (deliveredUtterances.length > 0) {\n      // Only allow speak to proceed\n      if (attemptedAction === 'speak') {\n        return { decision: 'approve' };\n      }\n      return {\n        decision: 'block',\n        reason: `${deliveredUtterances.length} delivered utterance(s) require voice response. Please use the speak tool to respond before proceeding.`\n      };\n    }\n  }\n  \n  // 3. Handle tool action\n  if (attemptedAction === 'tool') {\n    lastToolUseTimestamp = new Date();\n    return { decision: 'approve' };\n  }\n  \n  // 4. Handle wait for utterance\n  if (attemptedAction === 'wait') {\n    if (voiceResponsesEnabled && lastToolUseTimestamp && \n        (!lastSpeakTimestamp || lastSpeakTimestamp < lastToolUseTimestamp)) {\n      return {\n        decision: 'block',\n        reason: 'Assistant must speak after using tools. Please use the speak tool to respond before waiting for utterances.'\n      };\n    }\n    return { decision: 'approve' };\n  }\n  \n  // 5. Handle speak\n  if (attemptedAction === 'speak') {\n    return { decision: 'approve' };\n  }\n  \n  // 6. Handle stop\n  if (attemptedAction === 'stop') {\n    // Check if must speak after tool use\n    if (voiceResponsesEnabled && lastToolUseTimestamp && \n        (!lastSpeakTimestamp || lastSpeakTimestamp < lastToolUseTimestamp)) {\n      return {\n        decision: 'block',\n        reason: 'Assistant must speak after using tools. Please use the speak tool to respond before proceeding.'\n      };\n    }\n    \n    // Check if should wait for utterances\n    const shouldWait = !lastTimeoutTimestamp ||\n      queue.utterances.some(u => u.timestamp > lastTimeoutTimestamp!);\n    \n    if (shouldWait) {\n      return {\n        decision: 'block',\n        reason: 'Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input'\n      };\n    }\n    \n    return {\n      decision: 'approve',\n      reason: 'No utterances since last timeout'\n    };\n  }\n  \n  // Default to approve (shouldn't reach here)\n  return { decision: 'approve' };\n}\n\n// Dedicated hook endpoints that return in Claude's expected format\napp.post('/api/hooks/pre-tool', (_req: Request, res: Response) => {\n  const result = handleHookRequest('tool');\n  res.json(result);\n});\n\napp.post('/api/hooks/stop', (_req: Request, res: Response) => {\n  const result = handleHookRequest('stop');\n  res.json(result);\n});\n\n// Pre-speak hook endpoint\napp.post('/api/hooks/pre-speak', (_req: Request, res: Response) => {\n  const result = handleHookRequest('speak');\n  res.json(result);\n});\n\n// Pre-wait hook endpoint\napp.post('/api/hooks/pre-wait', (_req: Request, res: Response) => {\n  const result = handleHookRequest('wait');\n  res.json(result);\n});\n\n// API to clear all utterances\napp.delete('/api/utterances', (req: Request, res: Response) => {\n  const clearedCount = queue.utterances.length;\n  queue.clear();\n\n  res.json({\n    success: true,\n    message: `Cleared ${clearedCount} utterances`,\n    clearedCount\n  });\n});\n\n// API for text-to-speech\napp.post('/api/speak', async (req: Request, res: Response) => {\n  const { text } = req.body;\n\n  if (!text || !text.trim()) {\n    res.status(400).json({ error: 'Text is required' });\n    return;\n  }\n\n  try {\n    // Execute text-to-speech using macOS say command\n    await execAsync(`say -r 350 \"${text.replace(/\"/g, '\\\\\"')}\"`);\n    debugLog(`[Speak] Spoke text: \"${text}\"`);\n\n    // Mark all delivered utterances as responded\n    const deliveredUtterances = queue.utterances.filter(u => u.status === 'delivered');\n    deliveredUtterances.forEach(u => {\n      u.status = 'responded';\n      debugLog(`[Queue] marked as responded: \"${u.text}\"\t[id: ${u.id}]`);\n    });\n\n    // Track that speak was called\n    lastSpeakTimestamp = new Date();\n\n    res.json({\n      success: true,\n      message: 'Text spoken successfully',\n      respondedCount: deliveredUtterances.length\n    });\n  } catch (error) {\n    debugLog(`[Speak] Failed to speak text: ${error}`);\n    res.status(500).json({\n      error: 'Failed to speak text',\n      details: error instanceof Error ? error.message : String(error)\n    });\n  }\n});\n\napp.get('/', (_req: Request, res: Response) => {\n  res.sendFile(path.join(__dirname, '..', 'public', 'index.html'));\n});\n\n// Start HTTP server\nconst HTTP_PORT = process.env.MCP_VOICE_HOOKS_PORT ? parseInt(process.env.MCP_VOICE_HOOKS_PORT) : 5111;\napp.listen(HTTP_PORT, () => {\n  console.log(`[HTTP] Server listening on http://localhost:${HTTP_PORT}`);\n  console.log(`[Mode] Running in ${IS_MCP_MANAGED ? 'MCP-managed' : 'standalone'} mode`);\n});\n\n// Helper function to get voice response reminder\nfunction getVoiceResponseReminder(): string {\n  const voiceResponsesEnabled = process.env.VOICE_RESPONSES_ENABLED === 'true';\n  return voiceResponsesEnabled\n    ? '\\n\\nThe user has enabled voice responses, so use the \\'speak\\' tool to respond to the user\\'s voice input before proceeding.'\n    : '';\n}\n\n// MCP Server Setup (only if MCP-managed)\nif (IS_MCP_MANAGED) {\n  console.log('[MCP] Initializing MCP server...');\n\n  const mcpServer = new Server(\n    {\n      name: 'voice-hooks',\n      version: '1.0.0',\n    },\n    {\n      capabilities: {\n        tools: {},\n      },\n    }\n  );\n\n  // Tool handlers\n  mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {\n    return {\n      tools: [\n        {\n          name: 'dequeue_utterances',\n          description: 'Dequeue pending utterances and mark them as delivered',\n          inputSchema: {\n            type: 'object',\n            properties: {\n              limit: {\n                type: 'number',\n                description: 'Maximum number of utterances to dequeue (default: 10)',\n                default: 10,\n              },\n            },\n          },\n        },\n        {\n          name: 'wait_for_utterance',\n          description: 'Wait for an utterance to be available or until timeout. Returns immediately if no utterances since last timeout.',\n          inputSchema: {\n            type: 'object',\n            properties: {\n              seconds_to_wait: {\n                type: 'number',\n                description: `Maximum seconds to wait for an utterance (default: ${DEFAULT_WAIT_TIMEOUT_SECONDS}, min: ${MIN_WAIT_TIMEOUT_SECONDS}, max: ${MAX_WAIT_TIMEOUT_SECONDS})`,\n                default: DEFAULT_WAIT_TIMEOUT_SECONDS,\n                minimum: MIN_WAIT_TIMEOUT_SECONDS,\n                maximum: MAX_WAIT_TIMEOUT_SECONDS,\n              },\n            },\n          },\n        },\n        {\n          name: 'speak',\n          description: 'Speak text using text-to-speech and mark delivered utterances as responded',\n          inputSchema: {\n            type: 'object',\n            properties: {\n              text: {\n                type: 'string',\n                description: 'The text to speak',\n              },\n            },\n            required: ['text'],\n          },\n        },\n      ],\n    };\n  });\n\n  mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n\n    try {\n      if (name === 'dequeue_utterances') {\n        const limit = (args?.limit as number) ?? 10;\n        const response = await fetch(`http://localhost:${HTTP_PORT}/api/dequeue-utterances`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ limit }),\n        });\n\n        const data = await response.json() as any;\n\n        if (data.utterances.length === 0) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: 'No recent utterances found.',\n              },\n            ],\n          };\n        }\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Dequeued ${data.utterances.length} utterance(s):\\n\\n${data.utterances.reverse().map((u: any) => `\"${u.text}\"\\t[time: ${new Date(u.timestamp).toISOString()}]`).join('\\n')\n                }${getVoiceResponseReminder()}`,\n            },\n          ],\n        };\n      }\n\n      if (name === 'wait_for_utterance') {\n        const requestedSeconds = (args?.seconds_to_wait as number) ?? DEFAULT_WAIT_TIMEOUT_SECONDS;\n        const secondsToWait = Math.max(\n          MIN_WAIT_TIMEOUT_SECONDS,\n          Math.min(MAX_WAIT_TIMEOUT_SECONDS, requestedSeconds)\n        );\n        debugLog(`[MCP] Calling wait_for_utterance with ${secondsToWait}s timeout`);\n\n        const response = await fetch(`http://localhost:${HTTP_PORT}/api/wait-for-utterances`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ seconds_to_wait: secondsToWait }),\n        });\n\n        const data = await response.json() as any;\n\n        if (data.utterances && data.utterances.length > 0) {\n          const utteranceTexts = data.utterances\n            .map((u: any) => `[${u.timestamp}] \"${u.text}\"`)\n            .join('\\n');\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Found ${data.count} utterance(s):\\n\\n${utteranceTexts}${getVoiceResponseReminder()}`,\n              },\n            ],\n          };\n        } else {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: data.message || `No utterances found after waiting ${secondsToWait} seconds.`,\n              },\n            ],\n          };\n        }\n      }\n\n      if (name === 'speak') {\n        const text = args?.text as string;\n\n        if (!text || !text.trim()) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: 'Error: Text is required for speak tool',\n              },\n            ],\n            isError: true,\n          };\n        }\n\n        const response = await fetch(`http://localhost:${HTTP_PORT}/api/speak`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ text }),\n        });\n\n        const data = await response.json() as any;\n\n        if (response.ok) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Spoke: \"${text}\"\\n${data.respondedCount > 0 ? `Marked ${data.respondedCount} utterance(s) as responded.` : 'No delivered utterances to mark as responded.'}`,\n              },\n            ],\n          };\n        } else {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Error speaking text: ${data.error || 'Unknown error'}`,\n              },\n            ],\n            isError: true,\n          };\n        }\n      }\n\n      throw new Error(`Unknown tool: ${name}`);\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Error: ${error instanceof Error ? error.message : String(error)}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  });\n\n  // Connect via stdio\n  const transport = new StdioServerTransport();\n  mcpServer.connect(transport);\n  console.log('[MCP] Server connected via stdio');\n} else {\n  console.log('[MCP] Skipping MCP server initialization (not in MCP-managed mode)');\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-voice-hooks",
-  "version": "1.0.2",
+  "version": "1.0.8",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -40,9 +40,9 @@
     "url": "git+https://github.com/johnmatthewtennant/mcp-voice-hooks.git"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/mcp-voice-hooks/issues"
+    "url": "https://github.com/johnmatthewtennant/mcp-voice-hooks/issues"
   },
-  "homepage": "https://github.com/yourusername/mcp-voice-hooks#readme",
+  "homepage": "https://github.com/johnmatthewtennant/mcp-voice-hooks#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.13.3",
     "cors": "^2.8.5",
@@ -53,10 +53,12 @@
     "@types/express": "^5.0.3",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.0.10",
+    "@types/supertest": "^6.0.3",
     "husky": "^9.1.7",
     "jest": "^29.7.0",
     "knip": "^5.61.3",
     "nodemon": "^3.1.10",
+    "supertest": "^7.1.1",
     "ts-jest": "^29.4.0",
     "ts-node": "^10.9.2",
     "ts-prune": "^0.10.3",

package/public/app.js

@@ -276,9 +276,6 @@ class VoiceHooksClient {
     }
     
     async clearAllUtterances() {
-        if (!confirm('Are you sure you want to clear all utterances?')) {
-            return;
-        }
         
         this.clearAllBtn.disabled = true;
         this.clearAllBtn.textContent = 'Clearing...';

package/.claude/hooks/post-tool-voice-hook.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-
-# Check if voice responses are enabled (defaults to false)
-VOICE_RESPONSES_ENABLED="${VOICE_RESPONSES_ENABLED:-false}"
-
-if [ "$VOICE_RESPONSES_ENABLED" == "true" ]; then
-    echo "Use the 'say' command to respond to the user's voice input before proceeding." >&2
-    echo "Example: bash -c 'say -r 300 \"I understand your request. I'll start working on...\"'" >&2
-    exit 2
-fi