opencode-smart-voice-notify 1.3.1 → 1.3.2

package/util/tts.js

@@ -1,342 +1,342 @@
-import path from 'path';
-import os from 'os';
-import fs from 'fs';
-import { loadConfig } from './config.js';
-import { createLinuxPlatform } from './linux.js';
-
-const platform = os.platform();
-// Remove module-level configDir constant that caches process.env prematurely
-// const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), '.config', 'opencode');
-
-/**
- * Gets the current OpenCode config directory
- * @returns {string}
- */
-const getConfigDir = () => process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), '.config', 'opencode');
-
-
-/**
- * Loads the TTS configuration (shared with the notification plugin)
- * @returns {object}
- */
-export const getTTSConfig = () => {
-  return loadConfig('smart-voice-notify', {
-    ttsEngine: 'elevenlabs',
-    enableTTS: true,
-    elevenLabsApiKey: '',
-    elevenLabsVoiceId: 'cgSgspJ2msm6clMCkdW9',
-    elevenLabsModel: 'eleven_turbo_v2_5',
-    elevenLabsStability: 0.5,
-    elevenLabsSimilarity: 0.75,
-    elevenLabsStyle: 0.5,
-    edgeVoice: 'en-US-JennyNeural',
-    edgePitch: '+0Hz',
-    edgeRate: '+10%',
-    sapiVoice: 'Microsoft Zira Desktop',
-    sapiRate: -1,
-    sapiPitch: 'medium',
-    sapiVolume: 'loud',
-    
-    // OpenAI-compatible TTS settings
-    openaiTtsEndpoint: '',
-    openaiTtsApiKey: '',
-    openaiTtsModel: 'tts-1',
-    openaiTtsVoice: 'alloy',
-    openaiTtsFormat: 'mp3',
-    openaiTtsSpeed: 1.0,
-    
-    // ============================================================
-    // NOTIFICATION MODE & TTS REMINDER SETTINGS
-    // ============================================================
-    // 'sound-first' - Play sound immediately, TTS reminder after delay (default)
-    // 'tts-first'   - Speak TTS immediately, no sound
-    // 'both'        - Play sound AND speak TTS immediately
-    // 'sound-only'  - Only play sound, no TTS at all
-    notificationMode: 'sound-first',
-    
-    // Enable TTS reminder if user doesn't respond after sound notification
-    enableTTSReminder: true,
-    
-    // Delay in seconds before TTS reminder (if user hasn't responded)
-    // Can be set globally or per-notification type
-    ttsReminderDelaySeconds: 30,
-    idleReminderDelaySeconds: 30,
-    permissionReminderDelaySeconds: 20,
-    
-    // Follow-up reminders (if user still doesn't respond after first TTS)
-    enableFollowUpReminders: true,
-    maxFollowUpReminders: 3,
-    reminderBackoffMultiplier: 1.5,  // Each follow-up waits longer (30s, 45s, 67.5s)
-    
-    // ============================================================
-    // TTS MESSAGE VARIETY (Initial notifications - randomly selected)
-    // ============================================================
-    // Messages when agent finishes work
-    idleTTSMessages: [
-      'All done! Your task has been completed successfully.',
-      'Hey there! I finished working on your request.',
-      'Task complete! Ready for your review whenever you are.',
-      'Good news! Everything is done and ready for you.',
-      'Finished! Let me know if you need anything else.'
-    ],
-    // Messages for permission requests
-    permissionTTSMessages: [
-      'Attention please! I need your permission to continue.',
-      'Hey! Quick approval needed to proceed with the task.',
-      'Heads up! There is a permission request waiting for you.',
-      'Excuse me! I need your authorization before I can continue.',
-      'Permission required! Please review and approve when ready.'
-    ],
-    // Messages for MULTIPLE permission requests (use {count} placeholder)
-    permissionTTSMessagesMultiple: [
-      'Attention please! There are {count} permission requests waiting for your approval.',
-      'Hey! {count} permissions need your approval to continue.',
-      'Heads up! You have {count} pending permission requests.',
-      'Excuse me! I need your authorization for {count} different actions.',
-      '{count} permissions required! Please review and approve when ready.'
-    ],
-    
-    // ============================================================
-    // TTS REMINDER MESSAGES (More urgent/personalized - used after delay)
-    // ============================================================
-    // Reminder messages when agent finished but user hasn't responded
-    idleReminderTTSMessages: [
-      'Hey, are you still there? Your task has been waiting for review.',
-      'Just a gentle reminder - I finished your request a while ago!',
-      'Hello? I completed your task. Please take a look when you can.',
-      'Still waiting for you! The work is done and ready for review.',
-      'Knock knock! Your completed task is patiently waiting for you.'
-    ],
-    // Reminder messages when permission still needed
-    permissionReminderTTSMessages: [
-      'Hey! I still need your permission to continue. Please respond!',
-      'Reminder: There is a pending permission request. I cannot proceed without you.',
-      'Hello? I am waiting for your approval. This is getting urgent!',
-      'Please check your screen! I really need your permission to move forward.',
-      'Still waiting for authorization! The task is on hold until you respond.'
-    ],
-    // Reminder messages for MULTIPLE permissions (use {count} placeholder)
-    permissionReminderTTSMessagesMultiple: [
-      'Hey! I still need your approval for {count} permissions. Please respond!',
-      'Reminder: There are {count} pending permission requests. I cannot proceed without you.',
-      'Hello? I am waiting for your approval on {count} items. This is getting urgent!',
-      'Please check your screen! {count} permissions are waiting for your response.',
-      'Still waiting for authorization on {count} requests! The task is on hold.'
-    ],
-    
-    // Permission batch window (ms) - how long to wait for more permissions before notifying
-    permissionBatchWindowMs: 800,
-    
-    // ============================================================
-    // QUESTION TOOL MESSAGES (SDK v1.1.7+ - Agent asking user questions)
-    // ============================================================
-    // Messages when agent asks user a question
-    questionTTSMessages: [
-      'Hey! I have a question for you. Please check your screen.',
-      'Attention! I need your input to continue.',
-      'Quick question! Please take a look when you have a moment.',
-      'I need some clarification. Could you please respond?',
-      'Question time! Your input is needed to proceed.'
-    ],
-    // Messages for MULTIPLE questions (use {count} placeholder)
-    questionTTSMessagesMultiple: [
-      'Hey! I have {count} questions for you. Please check your screen.',
-      'Attention! I need your input on {count} items to continue.',
-      '{count} questions need your attention. Please take a look!',
-      'I need some clarifications. There are {count} questions waiting for you.',
-      'Question time! {count} questions need your response to proceed.'
-    ],
-    // Reminder messages for questions
-    questionReminderTTSMessages: [
-      'Hey! I am still waiting for your answer. Please check the questions!',
-      'Reminder: There is a question waiting for your response.',
-      'Hello? I need your input to continue. Please respond when you can.',
-      'Still waiting for your answer! The task is on hold.',
-      'Your input is needed! Please check the pending question.'
-    ],
-    // Reminder messages for MULTIPLE questions (use {count} placeholder)
-    questionReminderTTSMessagesMultiple: [
-      'Hey! I am still waiting for answers to {count} questions. Please respond!',
-      'Reminder: There are {count} questions waiting for your response.',
-      'Hello? I need your input on {count} items. Please respond when you can.',
-      'Still waiting for your answers on {count} questions! The task is on hold.',
-      'Your input is needed! {count} questions are pending your response.'
-    ],
-    // Question reminder delay (seconds) - slightly less urgent than permissions
-    questionReminderDelaySeconds: 25,
-    // Question batch window (ms) - how long to wait for more questions before notifying
-    questionBatchWindowMs: 800,
-    
-    // ============================================================
-    // SOUND FILES (Used for immediate notifications)
-    // ============================================================
-    idleSound: 'assets/Soft-high-tech-notification-sound-effect.mp3',
-    permissionSound: 'assets/Machine-alert-beep-sound-effect.mp3',
-    questionSound: 'assets/Machine-alert-beep-sound-effect.mp3',
-    
-    // ============================================================
-    // GENERAL SETTINGS
-    // ============================================================
-    wakeMonitor: true,
-    forceVolume: true,
-    enableSound: true,
-    enableToast: true,
-    volumeThreshold: 50,
-    idleThresholdSeconds: 30,
-    debugLog: false
-  });
-};
-
-let elevenLabsQuotaExceeded = false;
-
-/**
- * Creates a TTS utility instance
- * @param {object} params - { $, client }
- * @returns {object} TTS API
- */
-export const createTTS = ({ $, client }) => {
-  const config = getTTSConfig();
-  const configDir = getConfigDir();
-  const logsDir = path.join(configDir, 'logs');
-
-  const logFile = path.join(logsDir, 'smart-voice-notify-debug.log');
-  
-  // Ensure logs directory exists if debug logging is enabled
-  if (config.debugLog && !fs.existsSync(logsDir)) {
-    try {
-      fs.mkdirSync(logsDir, { recursive: true });
-    } catch (e) {
-      // Silently fail - logging is optional
-    }
-  }
-
-  // Debug logging function (defined early so it can be passed to Linux platform)
-  const debugLog = (message) => {
-    if (!config.debugLog) return;
-    try {
-      const timestamp = new Date().toISOString();
-      fs.appendFileSync(logFile, `[${timestamp}] ${message}\n`);
-    } catch (e) {}
-  };
-
-  // Initialize Linux platform utilities (only used on Linux)
-  const linux = platform === 'linux' ? createLinuxPlatform({ $, debugLog }) : null;
-
-  const showToast = async (message, variant = 'info') => {
-    if (!config.enableToast) return;
-    try {
-      if (typeof client?.tui?.showToast === 'function') {
-        await client.tui.showToast({
-          body: {
-            message: message,
-            variant: variant,
-            duration: 6000
-          }
-        });
-      }
-    } catch (e) {}
-  };
-
-  /**
-   * Play an audio file using system media player
-   */
-  const playAudioFile = async (filePath, loops = 1) => {
-    if (!$) {
-      debugLog('playAudioFile: shell runner ($) not available');
-      return;
-    }
-    try {
-      if (platform === 'win32') {
-        const cmd = `
-          Add-Type -AssemblyName presentationCore
-          $player = New-Object System.Windows.Media.MediaPlayer
-          $player.Volume = 1.0
-          for ($i = 0; $i -lt ${loops}; $i++) {
-            $player.Open([Uri]::new('${filePath.replace(/\\/g, '\\\\')}'))
-            $player.Play()
-            Start-Sleep -Milliseconds 500
-            while ($player.Position -lt $player.NaturalDuration.TimeSpan -and $player.HasAudio) {
-              Start-Sleep -Milliseconds 100
-            }
-          }
-          $player.Close()
-        `;
-        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
-      } else if (platform === 'darwin') {
-        for (let i = 0; i < loops; i++) {
-          await $`afplay ${filePath}`.quiet();
-        }
-      } else if (platform === 'linux' && linux) {
-        // Use the Linux platform module for audio playback
-        await linux.playAudioFile(filePath, loops);
-      } else {
-        // Generic fallback for other Unix-like systems
-        for (let i = 0; i < loops; i++) {
-          try {
-            await $`paplay ${filePath}`.quiet();
-          } catch {
-            await $`aplay ${filePath}`.quiet();
-          }
-        }
-      }
-    } catch (e) {
-      debugLog(`playAudioFile error: ${e.message}`);
-    }
-  };
-
-  /**
-   * ElevenLabs Engine (Online, High Quality, Anime-like voices)
-   */
-  const speakWithElevenLabs = async (text) => {
-    if (elevenLabsQuotaExceeded) return false;
-
-    if (!config.elevenLabsApiKey) {
-      debugLog('speakWithElevenLabs: No API key configured');
-      return false;
-    }
-
-    try {
-      const { ElevenLabsClient } = await import('@elevenlabs/elevenlabs-js');
-      const elClient = new ElevenLabsClient({ apiKey: config.elevenLabsApiKey });
-      
-      const audio = await elClient.textToSpeech.convert(config.elevenLabsVoiceId || 'cgSgspJ2msm6clMCkdW9', {
-        text: text,
-        model_id: config.elevenLabsModel || 'eleven_turbo_v2_5',
-        voice_settings: {
-          stability: config.elevenLabsStability ?? 0.5,
-          similarity_boost: config.elevenLabsSimilarity ?? 0.75,
-          style: config.elevenLabsStyle ?? 0.5,
-          use_speaker_boost: true
-        }
-      });
-      
-      const tempFile = path.join(os.tmpdir(), `opencode-tts-${Date.now()}.mp3`);
-      const chunks = [];
-      for await (const chunk of audio) { chunks.push(chunk); }
-      fs.writeFileSync(tempFile, Buffer.concat(chunks));
-      
-      await playAudioFile(tempFile);
-      try { fs.unlinkSync(tempFile); } catch (e) {}
-      return true;
-    } catch (e) {
-      debugLog(`speakWithElevenLabs error: ${e?.message || String(e) || 'Unknown error'}`);
-      
-      // Handle quota exceeded (401 specifically, or specific error message)
-      const isQuotaError = 
-        e.statusCode === 401 || 
-        e.message?.includes('401') || 
-        e.message?.toLowerCase().includes('quota_exceeded') || 
-        e.message?.toLowerCase().includes('quota exceeded');
-
-      if (isQuotaError) {
-        elevenLabsQuotaExceeded = true;
-        await showToast("⚠️ ElevenLabs quota exceeded! Switching to Edge TTS for this session.", "error");
-      }
-      
-      return false;
-    }
-  };
-
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+import { loadConfig } from './config.js';
+import { createLinuxPlatform } from './linux.js';
+
+const platform = os.platform();
+// Remove module-level configDir constant that caches process.env prematurely
+// const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), '.config', 'opencode');
+
+/**
+ * Gets the current OpenCode config directory
+ * @returns {string}
+ */
+const getConfigDir = () => process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), '.config', 'opencode');
+
+
+/**
+ * Loads the TTS configuration (shared with the notification plugin)
+ * @returns {object}
+ */
+export const getTTSConfig = () => {
+  return loadConfig('smart-voice-notify', {
+    ttsEngine: 'elevenlabs',
+    enableTTS: true,
+    elevenLabsApiKey: '',
+    elevenLabsVoiceId: 'cgSgspJ2msm6clMCkdW9',
+    elevenLabsModel: 'eleven_turbo_v2_5',
+    elevenLabsStability: 0.5,
+    elevenLabsSimilarity: 0.75,
+    elevenLabsStyle: 0.5,
+    edgeVoice: 'en-US-JennyNeural',
+    edgePitch: '+0Hz',
+    edgeRate: '+10%',
+    sapiVoice: 'Microsoft Zira Desktop',
+    sapiRate: -1,
+    sapiPitch: 'medium',
+    sapiVolume: 'loud',
+    
+    // OpenAI-compatible TTS settings
+    openaiTtsEndpoint: '',
+    openaiTtsApiKey: '',
+    openaiTtsModel: 'tts-1',
+    openaiTtsVoice: 'alloy',
+    openaiTtsFormat: 'mp3',
+    openaiTtsSpeed: 1.0,
+    
+    // ============================================================
+    // NOTIFICATION MODE & TTS REMINDER SETTINGS
+    // ============================================================
+    // 'sound-first' - Play sound immediately, TTS reminder after delay (default)
+    // 'tts-first'   - Speak TTS immediately, no sound
+    // 'both'        - Play sound AND speak TTS immediately
+    // 'sound-only'  - Only play sound, no TTS at all
+    notificationMode: 'sound-first',
+    
+    // Enable TTS reminder if user doesn't respond after sound notification
+    enableTTSReminder: true,
+    
+    // Delay in seconds before TTS reminder (if user hasn't responded)
+    // Can be set globally or per-notification type
+    ttsReminderDelaySeconds: 30,
+    idleReminderDelaySeconds: 30,
+    permissionReminderDelaySeconds: 20,
+    
+    // Follow-up reminders (if user still doesn't respond after first TTS)
+    enableFollowUpReminders: true,
+    maxFollowUpReminders: 3,
+    reminderBackoffMultiplier: 1.5,  // Each follow-up waits longer (30s, 45s, 67.5s)
+    
+    // ============================================================
+    // TTS MESSAGE VARIETY (Initial notifications - randomly selected)
+    // ============================================================
+    // Messages when agent finishes work
+    idleTTSMessages: [
+      'All done! Your task has been completed successfully.',
+      'Hey there! I finished working on your request.',
+      'Task complete! Ready for your review whenever you are.',
+      'Good news! Everything is done and ready for you.',
+      'Finished! Let me know if you need anything else.'
+    ],
+    // Messages for permission requests
+    permissionTTSMessages: [
+      'Attention please! I need your permission to continue.',
+      'Hey! Quick approval needed to proceed with the task.',
+      'Heads up! There is a permission request waiting for you.',
+      'Excuse me! I need your authorization before I can continue.',
+      'Permission required! Please review and approve when ready.'
+    ],
+    // Messages for MULTIPLE permission requests (use {count} placeholder)
+    permissionTTSMessagesMultiple: [
+      'Attention please! There are {count} permission requests waiting for your approval.',
+      'Hey! {count} permissions need your approval to continue.',
+      'Heads up! You have {count} pending permission requests.',
+      'Excuse me! I need your authorization for {count} different actions.',
+      '{count} permissions required! Please review and approve when ready.'
+    ],
+    
+    // ============================================================
+    // TTS REMINDER MESSAGES (More urgent/personalized - used after delay)
+    // ============================================================
+    // Reminder messages when agent finished but user hasn't responded
+    idleReminderTTSMessages: [
+      'Hey, are you still there? Your task has been waiting for review.',
+      'Just a gentle reminder - I finished your request a while ago!',
+      'Hello? I completed your task. Please take a look when you can.',
+      'Still waiting for you! The work is done and ready for review.',
+      'Knock knock! Your completed task is patiently waiting for you.'
+    ],
+    // Reminder messages when permission still needed
+    permissionReminderTTSMessages: [
+      'Hey! I still need your permission to continue. Please respond!',
+      'Reminder: There is a pending permission request. I cannot proceed without you.',
+      'Hello? I am waiting for your approval. This is getting urgent!',
+      'Please check your screen! I really need your permission to move forward.',
+      'Still waiting for authorization! The task is on hold until you respond.'
+    ],
+    // Reminder messages for MULTIPLE permissions (use {count} placeholder)
+    permissionReminderTTSMessagesMultiple: [
+      'Hey! I still need your approval for {count} permissions. Please respond!',
+      'Reminder: There are {count} pending permission requests. I cannot proceed without you.',
+      'Hello? I am waiting for your approval on {count} items. This is getting urgent!',
+      'Please check your screen! {count} permissions are waiting for your response.',
+      'Still waiting for authorization on {count} requests! The task is on hold.'
+    ],
+    
+    // Permission batch window (ms) - how long to wait for more permissions before notifying
+    permissionBatchWindowMs: 800,
+    
+    // ============================================================
+    // QUESTION TOOL MESSAGES (SDK v1.1.7+ - Agent asking user questions)
+    // ============================================================
+    // Messages when agent asks user a question
+    questionTTSMessages: [
+      'Hey! I have a question for you. Please check your screen.',
+      'Attention! I need your input to continue.',
+      'Quick question! Please take a look when you have a moment.',
+      'I need some clarification. Could you please respond?',
+      'Question time! Your input is needed to proceed.'
+    ],
+    // Messages for MULTIPLE questions (use {count} placeholder)
+    questionTTSMessagesMultiple: [
+      'Hey! I have {count} questions for you. Please check your screen.',
+      'Attention! I need your input on {count} items to continue.',
+      '{count} questions need your attention. Please take a look!',
+      'I need some clarifications. There are {count} questions waiting for you.',
+      'Question time! {count} questions need your response to proceed.'
+    ],
+    // Reminder messages for questions
+    questionReminderTTSMessages: [
+      'Hey! I am still waiting for your answer. Please check the questions!',
+      'Reminder: There is a question waiting for your response.',
+      'Hello? I need your input to continue. Please respond when you can.',
+      'Still waiting for your answer! The task is on hold.',
+      'Your input is needed! Please check the pending question.'
+    ],
+    // Reminder messages for MULTIPLE questions (use {count} placeholder)
+    questionReminderTTSMessagesMultiple: [
+      'Hey! I am still waiting for answers to {count} questions. Please respond!',
+      'Reminder: There are {count} questions waiting for your response.',
+      'Hello? I need your input on {count} items. Please respond when you can.',
+      'Still waiting for your answers on {count} questions! The task is on hold.',
+      'Your input is needed! {count} questions are pending your response.'
+    ],
+    // Question reminder delay (seconds) - slightly less urgent than permissions
+    questionReminderDelaySeconds: 25,
+    // Question batch window (ms) - how long to wait for more questions before notifying
+    questionBatchWindowMs: 800,
+    
+    // ============================================================
+    // SOUND FILES (Used for immediate notifications)
+    // ============================================================
+    idleSound: 'assets/Soft-high-tech-notification-sound-effect.mp3',
+    permissionSound: 'assets/Machine-alert-beep-sound-effect.mp3',
+    questionSound: 'assets/Machine-alert-beep-sound-effect.mp3',
+    
+    // ============================================================
+    // GENERAL SETTINGS
+    // ============================================================
+    wakeMonitor: true,
+    forceVolume: true,
+    enableSound: true,
+    enableToast: true,
+    volumeThreshold: 50,
+    idleThresholdSeconds: 30,
+    debugLog: false
+  });
+};
+
+let elevenLabsQuotaExceeded = false;
+
+/**
+ * Creates a TTS utility instance
+ * @param {object} params - { $, client }
+ * @returns {object} TTS API
+ */
+export const createTTS = ({ $, client }) => {
+  const config = getTTSConfig();
+  const configDir = getConfigDir();
+  const logsDir = path.join(configDir, 'logs');
+
+  const logFile = path.join(logsDir, 'smart-voice-notify-debug.log');
+  
+  // Ensure logs directory exists if debug logging is enabled
+  if (config.debugLog && !fs.existsSync(logsDir)) {
+    try {
+      fs.mkdirSync(logsDir, { recursive: true });
+    } catch (e) {
+      // Silently fail - logging is optional
+    }
+  }
+
+  // Debug logging function (defined early so it can be passed to Linux platform)
+  const debugLog = (message) => {
+    if (!config.debugLog) return;
+    try {
+      const timestamp = new Date().toISOString();
+      fs.appendFileSync(logFile, `[${timestamp}] ${message}\n`);
+    } catch (e) {}
+  };
+
+  // Initialize Linux platform utilities (only used on Linux)
+  const linux = platform === 'linux' ? createLinuxPlatform({ $, debugLog }) : null;
+
+  const showToast = async (message, variant = 'info') => {
+    if (!config.enableToast) return;
+    try {
+      if (typeof client?.tui?.showToast === 'function') {
+        await client.tui.showToast({
+          body: {
+            message: message,
+            variant: variant,
+            duration: 6000
+          }
+        });
+      }
+    } catch (e) {}
+  };
+
+  /**
+   * Play an audio file using system media player
+   */
+  const playAudioFile = async (filePath, loops = 1) => {
+    if (!$) {
+      debugLog('playAudioFile: shell runner ($) not available');
+      return;
+    }
+    try {
+      if (platform === 'win32') {
+        const cmd = `
+          Add-Type -AssemblyName presentationCore
+          $player = New-Object System.Windows.Media.MediaPlayer
+          $player.Volume = 1.0
+          for ($i = 0; $i -lt ${loops}; $i++) {
+            $player.Open([Uri]::new('${filePath.replace(/\\/g, '\\\\')}'))
+            $player.Play()
+            Start-Sleep -Milliseconds 500
+            while ($player.Position -lt $player.NaturalDuration.TimeSpan -and $player.HasAudio) {
+              Start-Sleep -Milliseconds 100
+            }
+          }
+          $player.Close()
+        `;
+        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
+      } else if (platform === 'darwin') {
+        for (let i = 0; i < loops; i++) {
+          await $`afplay ${filePath}`.quiet();
+        }
+      } else if (platform === 'linux' && linux) {
+        // Use the Linux platform module for audio playback
+        await linux.playAudioFile(filePath, loops);
+      } else {
+        // Generic fallback for other Unix-like systems
+        for (let i = 0; i < loops; i++) {
+          try {
+            await $`paplay ${filePath}`.quiet();
+          } catch {
+            await $`aplay ${filePath}`.quiet();
+          }
+        }
+      }
+    } catch (e) {
+      debugLog(`playAudioFile error: ${e.message}`);
+    }
+  };
+
+  /**
+   * ElevenLabs Engine (Online, High Quality, Anime-like voices)
+   */
+  const speakWithElevenLabs = async (text) => {
+    if (elevenLabsQuotaExceeded) return false;
+
+    if (!config.elevenLabsApiKey) {
+      debugLog('speakWithElevenLabs: No API key configured');
+      return false;
+    }
+
+    try {
+      const { ElevenLabsClient } = await import('@elevenlabs/elevenlabs-js');
+      const elClient = new ElevenLabsClient({ apiKey: config.elevenLabsApiKey });
+      
+      const audio = await elClient.textToSpeech.convert(config.elevenLabsVoiceId || 'cgSgspJ2msm6clMCkdW9', {
+        text: text,
+        model_id: config.elevenLabsModel || 'eleven_turbo_v2_5',
+        voice_settings: {
+          stability: config.elevenLabsStability ?? 0.5,
+          similarity_boost: config.elevenLabsSimilarity ?? 0.75,
+          style: config.elevenLabsStyle ?? 0.5,
+          use_speaker_boost: true
+        }
+      });
+      
+      const tempFile = path.join(os.tmpdir(), `opencode-tts-${Date.now()}.mp3`);
+      const chunks = [];
+      for await (const chunk of audio) { chunks.push(chunk); }
+      fs.writeFileSync(tempFile, Buffer.concat(chunks));
+      
+      await playAudioFile(tempFile);
+      try { fs.unlinkSync(tempFile); } catch (e) {}
+      return true;
+    } catch (e) {
+      debugLog(`speakWithElevenLabs error: ${e?.message || String(e) || 'Unknown error'}`);
+      
+      // Handle quota exceeded (401 specifically, or specific error message)
+      const isQuotaError = 
+        e.statusCode === 401 || 
+        e.message?.includes('401') || 
+        e.message?.toLowerCase().includes('quota_exceeded') || 
+        e.message?.toLowerCase().includes('quota exceeded');
+
+      if (isQuotaError) {
+        elevenLabsQuotaExceeded = true;
+        await showToast("⚠️ ElevenLabs quota exceeded! Switching to Edge TTS for this session.", "error");
+      }
+      
+      return false;
+    }
+  };
+
   /**
    * Edge TTS Engine via Python CLI (Free, Neural voices)
    * Uses Python edge-tts package via command line as it's more reliable than Node.js WebSocket libraries.
@@ -388,273 +388,273 @@ export const createTTS = ({ $, client }) => {
       return false;
     }
   };
-
-  /**
-   * Windows SAPI Engine (Offline, Built-in)
-   */
-  const speakWithSAPI = async (text) => {
-    if (platform !== 'win32') {
-      debugLog('speakWithSAPI: skipped (not Windows)');
-      return false;
-    }
-    if (!$) {
-      debugLog('speakWithSAPI: skipped (shell helper $ not available)');
-      return false;
-    }
-    const scriptPath = path.join(os.tmpdir(), `opencode-sapi-${Date.now()}.ps1`);
-    try {
-      const escapedText = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
-      const voice = config.sapiVoice || 'Microsoft Zira Desktop';
-      const rate = Math.max(-10, Math.min(10, config.sapiRate || -1));
-      const pitch = config.sapiPitch || 'medium';
-      const volume = config.sapiVolume || 'loud';
-      const ratePercent = rate >= 0 ? `+${rate * 10}%` : `${rate * 5}%`;
-      
-      const ssml = `<?xml version="1.0" encoding="UTF-8"?>
-<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-  <voice name="${voice.replace(/"/g, '&quot;')}">
-    <prosody rate="${ratePercent}" pitch="${pitch}" volume="${volume}">
-      ${escapedText}
-    </prosody>
-  </voice>
-</speak>`;
-      
-      const scriptContent = `
-Add-Type -AssemblyName System.Speech
-$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
-try {
-    $synth.Rate = ${rate}
-    try { $synth.SelectVoice("${voice.replace(/"/g, '""')}") } catch { }
-    $ssml = @"
-${ssml}
-"@
-    $synth.SpeakSsml($ssml)
-} catch {
-    [Console]::Error.WriteLine($_.Exception.Message)
-    exit 1
-} finally {
-    if ($synth) { $synth.Dispose() }
-}
-`;
-      fs.writeFileSync(scriptPath, scriptContent, 'utf-8');
-      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -File ${scriptPath}`.nothrow().quiet();
-      
-      if (result.exitCode !== 0) {
-        debugLog(`speakWithSAPI failed with code ${result.exitCode}: ${result.stderr}`);
-        return false;
-      }
-      return true;
-    } catch (e) {
-      debugLog(`speakWithSAPI error: ${e?.message || String(e) || 'Unknown error'}`);
-      return false;
-    } finally {
-      try { if (fs.existsSync(scriptPath)) fs.unlinkSync(scriptPath); } catch (e) {}
-    }
-  };
-
-  /**
-   * macOS Say Engine
-   */
-  const speakWithSay = async (text) => {
-    if (platform !== 'darwin' || !$) return false;
-    try {
-      await $`say ${text}`.quiet();
-      return true;
-    } catch (e) {
-      debugLog(`speakWithSay error: ${e?.message || String(e) || 'Unknown error'}`);
-      return false;
-    }
-  };
-
-  /**
-   * OpenAI-Compatible TTS Engine (Kokoro, OpenAI, LocalAI, etc.)
-   * Calls /v1/audio/speech endpoint with configurable base URL
-   */
-  const speakWithOpenAI = async (text) => {
-    if (!config.openaiTtsEndpoint) {
-      debugLog('speakWithOpenAI: No endpoint configured');
-      return false;
-    }
-
-    try {
-      const endpoint = config.openaiTtsEndpoint.replace(/\/$/, '');
-      const url = `${endpoint}/v1/audio/speech`;
-      
-      const headers = {
-        'Content-Type': 'application/json',
-      };
-      
-      // Add auth header if API key is provided
-      if (config.openaiTtsApiKey) {
-        headers['Authorization'] = `Bearer ${config.openaiTtsApiKey}`;
-      }
-
-      const body = {
-        model: config.openaiTtsModel || 'tts-1',
-        input: text,
-        voice: config.openaiTtsVoice || 'alloy',
-        response_format: config.openaiTtsFormat || 'mp3',
-        speed: config.openaiTtsSpeed ?? 1.0,
-      };
-
-      debugLog(`speakWithOpenAI: Calling ${url} with voice=${body.voice}, model=${body.model}`);
-
-      const response = await fetch(url, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(body),
-      });
-
-      if (!response.ok) {
-        const errorText = await response.text();
-        debugLog(`speakWithOpenAI: API error ${response.status}: ${errorText}`);
-        return false;
-      }
-
-      const audioBuffer = await response.arrayBuffer();
-      const tempFile = path.join(os.tmpdir(), `opencode-tts-openai-${Date.now()}.mp3`);
-      fs.writeFileSync(tempFile, Buffer.from(audioBuffer));
-
-      await playAudioFile(tempFile);
-      try { fs.unlinkSync(tempFile); } catch (e) {}
-      return true;
-    } catch (e) {
-      debugLog(`speakWithOpenAI error: ${e?.message || String(e) || 'Unknown error'}`);
-      return false;
-    }
-  };
-
-  /**
-   * Get the current system idle time in seconds.
-   */
-  const getSystemIdleSeconds = async () => {
-    if (platform === 'linux') {
-      // On Linux, we can't reliably detect idle time across all DEs
-      // Return a high value to always attempt wake (it's a no-op if already awake)
-      return 999;
-    }
-    if (platform !== 'win32' || !$) return 999;
-    try {
-      const cmd = `
-        Add-Type -TypeDefinition @'
-using System;
-using System.Runtime.InteropServices;
-public static class IdleCheck {
-    [StructLayout(LayoutKind.Sequential)]
-    public struct LASTINPUTINFO {
-        public uint cbSize;
-        public uint dwTime;
-    }
-    [DllImport("user32.dll")]
-    public static extern bool GetLastInputInfo(ref LASTINPUTINFO plii);
-    public static uint GetIdleSeconds() {
-        LASTINPUTINFO lii = new LASTINPUTINFO();
-        lii.cbSize = (uint)Marshal.SizeOf(lii);
-        if (GetLastInputInfo(ref lii)) {
-            return (uint)((Environment.TickCount - lii.dwTime) / 1000);
-        }
-        return 0;
-    }
-}
-'@
-[IdleCheck]::GetIdleSeconds()
-      `;
-      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
-      return parseInt(result.stdout?.toString().trim() || '0', 10);
-    } catch (e) {
-      return 999; // Assume idle on error
-    }
-  };
-
-  /**
-   * Get the current system volume level (0-100).
-   */
-  const getCurrentVolume = async () => {
-    // Use Linux platform module
-    if (platform === 'linux' && linux) {
-      return await linux.getCurrentVolume();
-    }
-    if (platform !== 'win32' || !$) return -1;
-    try {
-      const cmd = `
-        $signature = @'
-[DllImport("winmm.dll")]
-public static extern int waveOutGetVolume(IntPtr hwo, out uint dwVolume);
-'@
-        Add-Type -MemberDefinition $signature -Name Win32VolCheck -Namespace Win32 -PassThru | Out-Null
-        $vol = 0
-        $result = [Win32.Win32VolCheck]::waveOutGetVolume([IntPtr]::Zero, [ref]$vol)
-        if ($result -eq 0) {
-            $leftVol = $vol -band 0xFFFF
-            [Math]::Round(($leftVol / 65535) * 100)
-        } else { -1 }
-      `;
-      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
-      return parseInt(result.stdout?.toString().trim() || '-1', 10);
-    } catch (e) {
-      return -1;
-    }
-  };
-
-  /**
-   * Wake Monitor Utility
-   */
-  const wakeMonitor = async (force = false) => {
-    if (!config.wakeMonitor || !$) return;
-    try {
-      const idleSeconds = await getSystemIdleSeconds();
-      const threshold = config.idleThresholdSeconds || 30;
-
-      if (!force && idleSeconds < threshold) {
-        debugLog(`wakeMonitor: skipped (idle ${idleSeconds}s < ${threshold}s)`);
-        return;
-      }
-
-      debugLog(`wakeMonitor: attempting to wake monitor (idle: ${idleSeconds}s, force: ${force})`);
-      
-      if (platform === 'win32') {
-        const cmd = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('{F15}')`;
-        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
-        debugLog('wakeMonitor: Windows wake command executed');
-      } else if (platform === 'darwin') {
-        await $`caffeinate -u -t 1`.quiet();
-        debugLog('wakeMonitor: macOS wake command executed');
-      } else if (platform === 'linux' && linux) {
-        // Use the Linux platform module for wake monitor
-        await linux.wakeMonitor();
-        debugLog('wakeMonitor: Linux wake command executed');
-      }
-    } catch (e) {
-      debugLog(`wakeMonitor error: ${e.message}`);
-    }
-  };
-
-  /**
-   * Force Volume Utility
-   */
-  const forceVolume = async (force = false) => {
-    if (!config.forceVolume || !$) return;
-    try {
-      if (!force) {
-        const currentVolume = await getCurrentVolume();
-        const volumeThreshold = config.volumeThreshold || 50;
-        if (currentVolume >= 0 && currentVolume >= volumeThreshold) return;
-      }
-
-      if (platform === 'win32') {
-        const cmd = `$wsh = New-Object -ComObject WScript.Shell; 1..50 | ForEach-Object { $wsh.SendKeys([char]175) }`;
-        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
-      } else if (platform === 'darwin') {
-        await $`osascript -e "set volume output volume 100"`.quiet();
-      } else if (platform === 'linux' && linux) {
-        // Use the Linux platform module for force volume
-        await linux.forceVolume();
-      }
-    } catch (e) {
-      debugLog(`forceVolume error: ${e.message}`);
-    }
-  };
-
+
+  /**
+   * Windows SAPI Engine (Offline, Built-in)
+   */
+  const speakWithSAPI = async (text) => {
+    if (platform !== 'win32') {
+      debugLog('speakWithSAPI: skipped (not Windows)');
+      return false;
+    }
+    if (!$) {
+      debugLog('speakWithSAPI: skipped (shell helper $ not available)');
+      return false;
+    }
+    const scriptPath = path.join(os.tmpdir(), `opencode-sapi-${Date.now()}.ps1`);
+    try {
+      const escapedText = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+      const voice = config.sapiVoice || 'Microsoft Zira Desktop';
+      const rate = Math.max(-10, Math.min(10, config.sapiRate || -1));
+      const pitch = config.sapiPitch || 'medium';
+      const volume = config.sapiVolume || 'loud';
+      const ratePercent = rate >= 0 ? `+${rate * 10}%` : `${rate * 5}%`;
+      
+      const ssml = `<?xml version="1.0" encoding="UTF-8"?>
+<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-US">
+  <voice name="${voice.replace(/"/g, '&quot;')}">
+    <prosody rate="${ratePercent}" pitch="${pitch}" volume="${volume}">
+      ${escapedText}
+    </prosody>
+  </voice>
+</speak>`;
+      
+      const scriptContent = `
+Add-Type -AssemblyName System.Speech
+$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+try {
+    $synth.Rate = ${rate}
+    try { $synth.SelectVoice("${voice.replace(/"/g, '""')}") } catch { }
+    $ssml = @"
+${ssml}
+"@
+    $synth.SpeakSsml($ssml)
+} catch {
+    [Console]::Error.WriteLine($_.Exception.Message)
+    exit 1
+} finally {
+    if ($synth) { $synth.Dispose() }
+}
+`;
+      fs.writeFileSync(scriptPath, scriptContent, 'utf-8');
+      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -File ${scriptPath}`.nothrow().quiet();
+      
+      if (result.exitCode !== 0) {
+        debugLog(`speakWithSAPI failed with code ${result.exitCode}: ${result.stderr}`);
+        return false;
+      }
+      return true;
+    } catch (e) {
+      debugLog(`speakWithSAPI error: ${e?.message || String(e) || 'Unknown error'}`);
+      return false;
+    } finally {
+      try { if (fs.existsSync(scriptPath)) fs.unlinkSync(scriptPath); } catch (e) {}
+    }
+  };
+
+  /**
+   * macOS Say Engine
+   */
+  const speakWithSay = async (text) => {
+    if (platform !== 'darwin' || !$) return false;
+    try {
+      await $`say ${text}`.quiet();
+      return true;
+    } catch (e) {
+      debugLog(`speakWithSay error: ${e?.message || String(e) || 'Unknown error'}`);
+      return false;
+    }
+  };
+
+  /**
+   * OpenAI-Compatible TTS Engine (Kokoro, OpenAI, LocalAI, etc.)
+   * Calls /v1/audio/speech endpoint with configurable base URL
+   */
+  const speakWithOpenAI = async (text) => {
+    if (!config.openaiTtsEndpoint) {
+      debugLog('speakWithOpenAI: No endpoint configured');
+      return false;
+    }
+
+    try {
+      const endpoint = config.openaiTtsEndpoint.replace(/\/$/, '');
+      const url = `${endpoint}/v1/audio/speech`;
+      
+      const headers = {
+        'Content-Type': 'application/json',
+      };
+      
+      // Add auth header if API key is provided
+      if (config.openaiTtsApiKey) {
+        headers['Authorization'] = `Bearer ${config.openaiTtsApiKey}`;
+      }
+
+      const body = {
+        model: config.openaiTtsModel || 'tts-1',
+        input: text,
+        voice: config.openaiTtsVoice || 'alloy',
+        response_format: config.openaiTtsFormat || 'mp3',
+        speed: config.openaiTtsSpeed ?? 1.0,
+      };
+
+      debugLog(`speakWithOpenAI: Calling ${url} with voice=${body.voice}, model=${body.model}`);
+
+      const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        debugLog(`speakWithOpenAI: API error ${response.status}: ${errorText}`);
+        return false;
+      }
+
+      const audioBuffer = await response.arrayBuffer();
+      const tempFile = path.join(os.tmpdir(), `opencode-tts-openai-${Date.now()}.mp3`);
+      fs.writeFileSync(tempFile, Buffer.from(audioBuffer));
+
+      await playAudioFile(tempFile);
+      try { fs.unlinkSync(tempFile); } catch (e) {}
+      return true;
+    } catch (e) {
+      debugLog(`speakWithOpenAI error: ${e?.message || String(e) || 'Unknown error'}`);
+      return false;
+    }
+  };
+
+  /**
+   * Get the current system idle time in seconds.
+   */
+  const getSystemIdleSeconds = async () => {
+    if (platform === 'linux') {
+      // On Linux, we can't reliably detect idle time across all DEs
+      // Return a high value to always attempt wake (it's a no-op if already awake)
+      return 999;
+    }
+    if (platform !== 'win32' || !$) return 999;
+    try {
+      const cmd = `
+        Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+public static class IdleCheck {
+    [StructLayout(LayoutKind.Sequential)]
+    public struct LASTINPUTINFO {
+        public uint cbSize;
+        public uint dwTime;
+    }
+    [DllImport("user32.dll")]
+    public static extern bool GetLastInputInfo(ref LASTINPUTINFO plii);
+    public static uint GetIdleSeconds() {
+        LASTINPUTINFO lii = new LASTINPUTINFO();
+        lii.cbSize = (uint)Marshal.SizeOf(lii);
+        if (GetLastInputInfo(ref lii)) {
+            return (uint)((Environment.TickCount - lii.dwTime) / 1000);
+        }
+        return 0;
+    }
+}
+'@
+[IdleCheck]::GetIdleSeconds()
+      `;
+      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
+      return parseInt(result.stdout?.toString().trim() || '0', 10);
+    } catch (e) {
+      return 999; // Assume idle on error
+    }
+  };
+
+  /**
+   * Get the current system volume level (0-100).
+   */
+  const getCurrentVolume = async () => {
+    // Use Linux platform module
+    if (platform === 'linux' && linux) {
+      return await linux.getCurrentVolume();
+    }
+    if (platform !== 'win32' || !$) return -1;
+    try {
+      const cmd = `
+        $signature = @'
+[DllImport("winmm.dll")]
+public static extern int waveOutGetVolume(IntPtr hwo, out uint dwVolume);
+'@
+        Add-Type -MemberDefinition $signature -Name Win32VolCheck -Namespace Win32 -PassThru | Out-Null
+        $vol = 0
+        $result = [Win32.Win32VolCheck]::waveOutGetVolume([IntPtr]::Zero, [ref]$vol)
+        if ($result -eq 0) {
+            $leftVol = $vol -band 0xFFFF
+            [Math]::Round(($leftVol / 65535) * 100)
+        } else { -1 }
+      `;
+      const result = await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
+      return parseInt(result.stdout?.toString().trim() || '-1', 10);
+    } catch (e) {
+      return -1;
+    }
+  };
+
+  /**
+   * Wake Monitor Utility
+   */
+  const wakeMonitor = async (force = false) => {
+    if (!config.wakeMonitor || !$) return;
+    try {
+      const idleSeconds = await getSystemIdleSeconds();
+      const threshold = config.idleThresholdSeconds || 30;
+
+      if (!force && idleSeconds < threshold) {
+        debugLog(`wakeMonitor: skipped (idle ${idleSeconds}s < ${threshold}s)`);
+        return;
+      }
+
+      debugLog(`wakeMonitor: attempting to wake monitor (idle: ${idleSeconds}s, force: ${force})`);
+      
+      if (platform === 'win32') {
+        const cmd = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('{F15}')`;
+        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
+        debugLog('wakeMonitor: Windows wake command executed');
+      } else if (platform === 'darwin') {
+        await $`caffeinate -u -t 1`.quiet();
+        debugLog('wakeMonitor: macOS wake command executed');
+      } else if (platform === 'linux' && linux) {
+        // Use the Linux platform module for wake monitor
+        await linux.wakeMonitor();
+        debugLog('wakeMonitor: Linux wake command executed');
+      }
+    } catch (e) {
+      debugLog(`wakeMonitor error: ${e.message}`);
+    }
+  };
+
+  /**
+   * Force Volume Utility
+   */
+  const forceVolume = async (force = false) => {
+    if (!config.forceVolume || !$) return;
+    try {
+      if (!force) {
+        const currentVolume = await getCurrentVolume();
+        const volumeThreshold = config.volumeThreshold || 50;
+        if (currentVolume >= 0 && currentVolume >= volumeThreshold) return;
+      }
+
+      if (platform === 'win32') {
+        const cmd = `$wsh = New-Object -ComObject WScript.Shell; 1..50 | ForEach-Object { $wsh.SendKeys([char]175) }`;
+        await $`powershell.exe -NoProfile -ExecutionPolicy Bypass -Command ${cmd}`.quiet();
+      } else if (platform === 'darwin') {
+        await $`osascript -e "set volume output volume 100"`.quiet();
+      } else if (platform === 'linux' && linux) {
+        // Use the Linux platform module for force volume
+        await linux.forceVolume();
+      }
+    } catch (e) {
+      debugLog(`forceVolume error: ${e.message}`);
+    }
+  };
+
   /**
    * Main Speak function with fallback chain
    * Cascade: Primary Engine -> Edge TTS -> Windows SAPI -> macOS Say -> Sound File
@@ -704,17 +704,17 @@ public static extern int waveOutGetVolume(IntPtr hwo, out uint dwVolume);
     }
     return false;
   };
-
-  return {
-    speak,
-    announce: async (message, options = {}) => {
-      await wakeMonitor();
-      await forceVolume();
-      return speak(message, options);
-    },
-    wakeMonitor,
-    forceVolume,
-    playAudioFile,
-    config
-  };
-};
+
+  return {
+    speak,
+    announce: async (message, options = {}) => {
+      await wakeMonitor();
+      await forceVolume();
+      return speak(message, options);
+    },
+    wakeMonitor,
+    forceVolume,
+    playAudioFile,
+    config
+  };
+};