opencode-smart-voice-notify 1.0.10 → 1.0.13

package/README.md

@@ -32,6 +32,7 @@ The plugin automatically tries multiple TTS engines in order, falling back if on
 - Automatic cancellation when user responds
 - Per-notification type delays (permission requests are more urgent)
 - **Smart Quota Handling**: Automatically falls back to free Edge TTS if ElevenLabs quota is exceeded
+- **Permission Batching**: Multiple simultaneous permission requests are batched into a single notification (e.g., "5 permission requests require your attention")
 
 ### System Integration
 - **Native Edge TTS**: No external dependencies (Python/pip) required
@@ -40,18 +41,20 @@ The plugin automatically tries multiple TTS engines in order, falling back if on
 - TUI toast notifications
 - Cross-platform support (Windows, macOS, Linux)
 
-## Installation
-
-### Option 1: From npm (Recommended)
-
-Add to your OpenCode config file (`~/.config/opencode/opencode.json`):
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-smart-voice-notify@latest"]
-}
-```
+## Installation
+
+### Option 1: From npm/Bun (Recommended)
+
+Add to your OpenCode config file (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-smart-voice-notify@latest"]
+}
+```
+
+> **Note**: OpenCode will automatically install the plugin using your system's package manager (npm or bun).
 
 ### Option 2: From GitHub
 
@@ -80,10 +83,11 @@ Add to your OpenCode config file (`~/.config/opencode/opencode.json`):
 
 ### Automatic Setup
 
-When you first run OpenCode with this plugin installed, it will **automatically create**:
-
-1. **`~/.config/opencode/smart-voice-notify.jsonc`** - A comprehensive configuration file with all available options fully documented.
-2. **`~/.config/opencode/assets/*.mp3`** - Bundled notification sound files.
+When you first run OpenCode with this plugin installed, it will **automatically create**:
+
+1. **`~/.config/opencode/smart-voice-notify.jsonc`** - A comprehensive configuration file with all available options fully documented.
+2. **`~/.config/opencode/assets/*.mp3`** - Bundled notification sound files.
+3. **`~/.config/opencode/logs/`** - Debug log folder (created when debug logging is enabled).
 
 The auto-generated configuration includes all advanced settings, message arrays, and engine options, so you don't have to refer back to the documentation for available settings.
 
@@ -115,10 +119,16 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
     "idleReminderDelaySeconds": 30,        // For task completion notifications
     "permissionReminderDelaySeconds": 20,  // For permission requests (more urgent)
     
-    // Follow-up reminders if user STILL doesn't respond after first TTS
-    "enableFollowUpReminders": true,
-    "maxFollowUpReminders": 3,              // Max number of follow-up TTS reminders
-    "reminderBackoffMultiplier": 1.5,       // Each follow-up waits longer (30s, 45s, 67s...)
+    // Follow-up reminders if user STILL doesn't respond after first TTS
+    "enableFollowUpReminders": true,
+    "maxFollowUpReminders": 3,              // Max number of follow-up TTS reminders
+    "reminderBackoffMultiplier": 1.5,       // Each follow-up waits longer (30s, 45s, 67s...)
+    
+    // ============================================================
+    // PERMISSION BATCHING (Multiple permissions at once)
+    // ============================================================
+    // When multiple permissions arrive simultaneously, batch them into one notification
+    "permissionBatchWindowMs": 800,         // Batch window in milliseconds
 
     // ============================================================
     // TTS ENGINE SELECTION
@@ -165,13 +175,18 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
         "Good news! Everything is done and ready for you.",
         "Finished! Let me know if you need anything else."
     ],
-    "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."
-    ],
+    "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."
+    ],
 
     // ============================================================
     // TTS REMINDER MESSAGES (Used after delay if no response)
@@ -183,13 +198,18 @@ If you prefer to create the config manually, add a `smart-voice-notify.jsonc` fi
         "Still waiting for you! The work is done and ready for review.",
         "Knock knock! Your completed task is patiently waiting for you."
     ],
-    "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."
-    ],
+    "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."
+    ],
     
     // ============================================================
     // SOUND FILES (relative to OpenCode config directory)
@@ -229,33 +249,44 @@ See `example.config.jsonc` for more details.
 - **macOS**: Built-in (`afplay`)
 - **Linux**: `paplay` or `aplay`
 
-## Events Handled
-
-| Event | Action |
-|-------|--------|
-| `session.idle` | Agent finished working - notify user |
-| `permission.updated` | Permission request - alert user |
-| `permission.replied` | User responded - cancel pending reminders |
-| `message.updated` | New user message - cancel pending reminders |
-| `session.created` | New session - reset state |
-
-## Development
-
-To develop on this plugin locally:
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/MasuRii/opencode-smart-voice-notify.git
-   cd opencode-smart-voice-notify
-   bun install  # or npm install
-   ```
+## Events Handled
+
+| Event | Action |
+|-------|--------|
+| `session.idle` | Agent finished working - notify user |
+| `permission.asked` | Permission request (SDK v1.1.1+) - alert user |
+| `permission.updated` | Permission request (SDK v1.0.x) - alert user |
+| `permission.replied` | User responded - cancel pending reminders |
+| `message.updated` | New user message - cancel pending reminders |
+| `session.created` | New session - reset state |
+
+> **Note**: The plugin supports both OpenCode SDK v1.0.x and v1.1.x for backward compatibility.
 
-2. Link to your OpenCode config:
-   ```json
-   {
-     "plugin": ["file:///absolute/path/to/opencode-smart-voice-notify"]
-   }
-   ```
+## Development
+
+To develop on this plugin locally:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/MasuRii/opencode-smart-voice-notify.git
+   cd opencode-smart-voice-notify
+   ```
+
+2. Install dependencies:
+   ```bash
+   # Using Bun (recommended)
+   bun install
+
+   # Or using npm
+   npm install
+   ```
+
+3. Link to your OpenCode config:
+   ```json
+   {
+     "plugin": ["file:///absolute/path/to/opencode-smart-voice-notify"]
+   }
+   ```
 
 ## Updating
 

package/example.config.jsonc

@@ -44,6 +44,16 @@
     "maxFollowUpReminders": 3,              // Max number of follow-up TTS reminders
     "reminderBackoffMultiplier": 1.5,       // Each follow-up waits longer (30s, 45s, 67s...)
 
+    // ============================================================
+    // PERMISSION BATCHING (Multiple permissions at once)
+    // ============================================================
+    // When multiple permissions arrive simultaneously (e.g., 5 at once),
+    // batch them into a single notification instead of playing 5 overlapping sounds.
+    // The notification will say "X permission requests require your attention".
+    
+    // Batch window (ms) - how long to wait for more permissions before notifying
+    "permissionBatchWindowMs": 800,
+
     // ============================================================
     // TTS ENGINE SELECTION
     // ============================================================
@@ -141,6 +151,16 @@
         "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)
+    // Used when several permissions arrive simultaneously
+    "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 - used after delay if no response)
@@ -165,6 +185,15 @@
         "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."
+    ],
+    
     // ============================================================
     // SOUND FILES (For immediate notifications)
     // These are played first before TTS reminder kicks in
@@ -198,7 +227,8 @@
     // Consider monitor asleep after this many seconds of inactivity (Windows only)
     "idleThresholdSeconds": 60,
     
-    // Enable debug logging to ~/.config/opencode/smart-voice-notify-debug.log
+    // Enable debug logging to ~/.config/opencode/logs/smart-voice-notify-debug.log
+    // The logs folder is created automatically when debug logging is enabled
     // Useful for troubleshooting notification issues
     "debugLog": false
 }

package/index.js

@@ -27,7 +27,17 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
 
   const platform = os.platform();
   const configDir = process.env.OPENCODE_CONFIG_DIR || path.join(os.homedir(), '.config', 'opencode');
-  const logFile = path.join(configDir, 'smart-voice-notify-debug.log');
+  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
+    }
+  }
 
   // Track pending TTS reminders (can be cancelled if user responds)
   const pendingReminders = new Map();
@@ -47,6 +57,20 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
   // before async notification code runs. Set on permission.updated, cleared on permission.replied.
   let activePermissionId = null;
 
+  // ========================================
+  // PERMISSION BATCHING STATE
+  // Batches multiple simultaneous permission requests into a single notification
+  // ========================================
+  
+  // Array of permission IDs waiting to be notified (collected during batch window)
+  let pendingPermissionBatch = [];
+  
+  // Timeout ID for the batch window (debounce timer)
+  let permissionBatchTimeout = null;
+  
+  // Batch window duration in milliseconds (how long to wait for more permissions)
+  const PERMISSION_BATCH_WINDOW_MS = config.permissionBatchWindowMs || 800;
+
   /**
    * Write debug message to log file
    */
@@ -137,8 +161,8 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
    * Schedule a TTS reminder if user doesn't respond within configured delay.
    * The reminder uses a personalized TTS message.
    * @param {string} type - 'idle' or 'permission'
-   * @param {string} message - The TTS message to speak
-   * @param {object} options - Additional options
+   * @param {string} message - The TTS message to speak (used directly, supports count-aware messages)
+   * @param {object} options - Additional options (fallbackSound, permissionCount)
    */
   const scheduleTTSReminder = (type, message, options = {}) => {
     // Check if TTS reminders are enabled
@@ -156,7 +180,10 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
     // Cancel any existing reminder of this type
     cancelPendingReminder(type);
 
-    debugLog(`scheduleTTSReminder: scheduling ${type} TTS in ${delaySeconds}s`);
+    // Store permission count for generating count-aware messages in reminders
+    const permissionCount = options.permissionCount || 1;
+
+    debugLog(`scheduleTTSReminder: scheduling ${type} TTS in ${delaySeconds}s (count=${permissionCount})`);
 
     const timeoutId = setTimeout(async () => {
       try {
@@ -174,14 +201,17 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
           return;
         }
 
-        debugLog(`scheduleTTSReminder: firing ${type} TTS reminder`);
-        
-        // Get the appropriate reminder messages (more personalized/urgent)
-        const reminderMessages = type === 'permission' 
-          ? config.permissionReminderTTSMessages
-          : config.idleReminderTTSMessages;
+        debugLog(`scheduleTTSReminder: firing ${type} TTS reminder (count=${reminder?.permissionCount || 1})`);
         
-        const reminderMessage = getRandomMessage(reminderMessages);
+        // Get the appropriate reminder message
+        // For permissions with count > 1, use the count-aware message generator
+        const storedCount = reminder?.permissionCount || 1;
+        let reminderMessage;
+        if (type === 'permission') {
+          reminderMessage = getPermissionMessage(storedCount, true);
+        } else {
+          reminderMessage = getRandomMessage(config.idleReminderTTSMessages);
+        }
 
         // Check for ElevenLabs API key configuration issues
         // If user hasn't responded (reminder firing) and config is missing, warn about fallback
@@ -226,7 +256,15 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
                 return;
               }
               
-              const followUpMessage = getRandomMessage(reminderMessages);
+              // Use count-aware message for follow-ups too
+              const followUpStoredCount = followUpReminder?.permissionCount || 1;
+              let followUpMessage;
+              if (type === 'permission') {
+                followUpMessage = getPermissionMessage(followUpStoredCount, true);
+              } else {
+                followUpMessage = getRandomMessage(config.idleReminderTTSMessages);
+              }
+              
               await tts.wakeMonitor();
               await tts.forceVolume();
               await tts.speak(followUpMessage, {
@@ -240,7 +278,8 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
             pendingReminders.set(type, {
               timeoutId: followUpTimeoutId,
               scheduledAt: Date.now(),
-              followUpCount
+              followUpCount,
+              permissionCount: storedCount  // Preserve the count for follow-ups
             });
           }
         }
@@ -250,11 +289,12 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
       }
     }, delayMs);
 
-    // Store the pending reminder
+    // Store the pending reminder with permission count
     pendingReminders.set(type, {
       timeoutId,
       scheduledAt: Date.now(),
-      followUpCount: 0
+      followUpCount: 0,
+      permissionCount  // Store count for later use
     });
   };
 
@@ -268,7 +308,8 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
       soundFile,
       soundLoops = 1,
       ttsMessage,
-      fallbackSound
+      fallbackSound,
+      permissionCount = 1  // Support permission count for batched notifications
     } = options;
 
     // Step 1: Play the immediate sound notification
@@ -290,7 +331,7 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
 
     // Step 2: Schedule TTS reminder if user doesn't respond
     if (config.enableTTSReminder && ttsMessage) {
-      scheduleTTSReminder(type, ttsMessage, { fallbackSound });
+      scheduleTTSReminder(type, ttsMessage, { fallbackSound, permissionCount });
     }
     
     // Step 3: If TTS-first mode is enabled, also speak immediately
@@ -306,6 +347,108 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
     }
   };
 
+  /**
+   * Get a count-aware TTS message for permission requests
+   * @param {number} count - Number of permission requests
+   * @param {boolean} isReminder - Whether this is a reminder message
+   * @returns {string} The formatted message
+   */
+  const getPermissionMessage = (count, isReminder = false) => {
+    const messages = isReminder 
+      ? config.permissionReminderTTSMessages 
+      : config.permissionTTSMessages;
+    
+    if (count === 1) {
+      // Single permission - use regular message
+      return getRandomMessage(messages);
+    } else {
+      // Multiple permissions - use count-aware messages if available, or format dynamically
+      const countMessages = isReminder
+        ? config.permissionReminderTTSMessagesMultiple
+        : config.permissionTTSMessagesMultiple;
+      
+      if (countMessages && countMessages.length > 0) {
+        // Use configured multi-permission messages (replace {count} placeholder)
+        const template = getRandomMessage(countMessages);
+        return template.replace('{count}', count.toString());
+      } else {
+        // Fallback: generate a dynamic message
+        return `Attention! There are ${count} permission requests waiting for your approval.`;
+      }
+    }
+  };
+
+  /**
+   * Process the batched permission requests as a single notification
+   * Called after the batch window expires
+   */
+  const processPermissionBatch = async () => {
+    // Capture and clear the batch
+    const batch = [...pendingPermissionBatch];
+    const batchCount = batch.length;
+    pendingPermissionBatch = [];
+    permissionBatchTimeout = null;
+    
+    if (batchCount === 0) {
+      debugLog('processPermissionBatch: empty batch, skipping');
+      return;
+    }
+
+    debugLog(`processPermissionBatch: processing ${batchCount} permission(s)`);
+    
+    // Set activePermissionId to the first one (for race condition checks)
+    // We track all IDs in the batch for proper cleanup
+    activePermissionId = batch[0];
+    
+    // Show toast with count
+    const toastMessage = batchCount === 1
+      ? "⚠️ Permission request requires your attention"
+      : `⚠️ ${batchCount} permission requests require your attention`;
+    await showToast(toastMessage, "warning", 8000);
+
+    // CHECK: Did user already respond while we were showing toast?
+    if (pendingPermissionBatch.length > 0) {
+      // New permissions arrived during toast - they'll be handled in next batch
+      debugLog('processPermissionBatch: new permissions arrived during toast');
+    }
+    
+    // Check if any permission was already replied to
+    if (activePermissionId === null) {
+      debugLog('processPermissionBatch: aborted - user already responded');
+      return;
+    }
+
+    // Get count-aware TTS message
+    const ttsMessage = getPermissionMessage(batchCount, false);
+    const reminderMessage = getPermissionMessage(batchCount, true);
+
+    // Smart notification: sound first, TTS reminder later
+    await smartNotify('permission', {
+      soundFile: config.permissionSound,
+      soundLoops: batchCount === 1 ? 2 : Math.min(3, batchCount), // More loops for more permissions
+      ttsMessage: reminderMessage,
+      fallbackSound: config.permissionSound,
+      // Pass count for potential use in notification
+      permissionCount: batchCount
+    });
+    
+    // Speak immediately if in TTS-first or both mode (with count-aware message)
+    if (config.notificationMode === 'tts-first' || config.notificationMode === 'both') {
+      await tts.wakeMonitor();
+      await tts.forceVolume();
+      await tts.speak(ttsMessage, {
+        enableTTS: true,
+        fallbackSound: config.permissionSound
+      });
+    }
+    
+    // Final check: if user responded during notification, cancel scheduled reminder
+    if (activePermissionId === null) {
+      debugLog('processPermissionBatch: user responded during notification - cancelling reminder');
+      cancelPendingReminder('permission');
+    }
+  };
+
   return {
     event: async ({ event }) => {
       try {
@@ -313,9 +456,13 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
         // USER ACTIVITY DETECTION
         // Cancels pending TTS reminders when user responds
         // ========================================
-        // NOTE: OpenCode event types (as of SDK v1.0.203):
+        // NOTE: OpenCode event types (supporting SDK v1.0.x and v1.1.x):
         //   - message.updated: fires when a message is added/updated (use properties.info.role to check user vs assistant)
+        //   - permission.updated (SDK v1.0.x): fires when a permission request is created
+        //   - permission.asked (SDK v1.1.1+): fires when a permission request is created (replaces permission.updated)
         //   - permission.replied: fires when user responds to a permission request
+        //     - SDK v1.0.x: uses permissionID, response
+        //     - SDK v1.1.1+: uses requestID, reply
         //   - session.created: fires when a new session starts
         //
         // CRITICAL: message.updated fires for EVERY modification to a message (not just creation).
@@ -361,20 +508,37 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
         
         if (event.type === "permission.replied") {
           // User responded to a permission request (granted or denied)
-          // Structure: event.properties.{ sessionID, permissionID, response }
+          // Structure varies by SDK version:
+          //   - Old SDK: event.properties.{ sessionID, permissionID, response }
+          //   - New SDK (v1.1.1+): event.properties.{ sessionID, requestID, reply }
           // CRITICAL: Clear activePermissionId FIRST to prevent race condition
-          // where permission.updated handler is still running async operations
-          const repliedPermissionId = event.properties?.permissionID;
+          // where permission.updated/asked handler is still running async operations
+          const repliedPermissionId = event.properties?.permissionID || event.properties?.requestID;
+          const response = event.properties?.response || event.properties?.reply;
+          
+          // Remove this permission from the pending batch (if still waiting)
+          if (repliedPermissionId && pendingPermissionBatch.includes(repliedPermissionId)) {
+            pendingPermissionBatch = pendingPermissionBatch.filter(id => id !== repliedPermissionId);
+            debugLog(`Permission replied: removed ${repliedPermissionId} from pending batch (${pendingPermissionBatch.length} remaining)`);
+          }
+          
+          // If batch is now empty and we have a pending batch timeout, we can cancel it
+          // (user responded to all permissions before batch window expired)
+          if (pendingPermissionBatch.length === 0 && permissionBatchTimeout) {
+            clearTimeout(permissionBatchTimeout);
+            permissionBatchTimeout = null;
+            debugLog('Permission replied: cancelled batch timeout (all permissions handled)');
+          }
           
           // Match if IDs are equal, or if we have an active permission with unknown ID (undefined)
-          // (This happens if permission.updated received an event without permissionID)
+          // (This happens if permission.updated/asked received an event without permissionID)
           if (activePermissionId === repliedPermissionId || activePermissionId === undefined) {
             activePermissionId = null;
             debugLog(`Permission replied: cleared activePermissionId ${repliedPermissionId || '(unknown)'}`);
           }
           lastUserActivityTime = Date.now();
           cancelPendingReminder('permission'); // Cancel permission-specific reminder
-          debugLog(`Permission replied: ${event.type} (response=${event.properties?.response}) - cancelled permission reminder`);
+          debugLog(`Permission replied: ${event.type} (response=${response}) - cancelled permission reminder`);
         }
         
         if (event.type === "session.created") {
@@ -384,6 +548,14 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
           activePermissionId = null;
           seenUserMessageIds.clear();
           cancelAllPendingReminders();
+          
+          // Reset permission batch state
+          pendingPermissionBatch = [];
+          if (permissionBatchTimeout) {
+            clearTimeout(permissionBatchTimeout);
+            permissionBatchTimeout = null;
+          }
+          
           debugLog(`Session created: ${event.type} - reset all tracking state`);
         }
 
@@ -418,42 +590,48 @@ export default async function SmartVoiceNotifyPlugin({ project, client, $, direc
         }
 
         // ========================================
-        // NOTIFICATION 2: Permission Request
+        // NOTIFICATION 2: Permission Request (BATCHED)
         // ========================================
-        if (event.type === "permission.updated") {
-          // CRITICAL: Capture permissionID IMMEDIATELY (before any async work)
-          // This prevents race condition where user responds before we finish notifying
-          // NOTE: In permission.updated, the property is 'id', but in permission.replied it is 'permissionID'
+        // NOTE: OpenCode SDK v1.1.1+ changed permission events:
+        //   - Old: "permission.updated" with properties.id
+        //   - New: "permission.asked" with properties.id
+        // We support both for backward compatibility.
+        //
+        // BATCHING: When multiple permissions arrive simultaneously (e.g., 5 at once),
+        // we batch them into a single notification instead of playing 5 overlapping sounds.
+        if (event.type === "permission.updated" || event.type === "permission.asked") {
+          // Capture permissionID
           const permissionId = event.properties?.id;
           
           if (!permissionId) {
-             debugLog('permission.updated: permission ID missing. properties keys: ' + Object.keys(event.properties || {}).join(', '));
+             debugLog(`${event.type}: permission ID missing. properties keys: ` + Object.keys(event.properties || {}).join(', '));
           }
 
-          activePermissionId = permissionId;
-          
-          debugLog(`permission.updated: notifying (permissionId=${permissionId})`);
-          await showToast("⚠️ Permission request requires your attention", "warning", 8000);
-
-          // CHECK: Did user already respond while we were showing toast?
-          if (activePermissionId !== permissionId) {
-            debugLog(`permission.updated: aborted - user already responded (activePermissionId cleared)`);
-            return;
+          // Add to the pending batch (avoid duplicates)
+          if (permissionId && !pendingPermissionBatch.includes(permissionId)) {
+            pendingPermissionBatch.push(permissionId);
+            debugLog(`${event.type}: added ${permissionId} to batch (now ${pendingPermissionBatch.length} pending)`);
+          } else if (!permissionId) {
+            // If no ID, still count it (use a placeholder)
+            pendingPermissionBatch.push(`unknown-${Date.now()}`);
+            debugLog(`${event.type}: added unknown permission to batch (now ${pendingPermissionBatch.length} pending)`);
           }
-
-          // Smart notification: sound first, TTS reminder later
-          await smartNotify('permission', {
-            soundFile: config.permissionSound,
-            soundLoops: 2,
-            ttsMessage: getRandomMessage(config.permissionTTSMessages),
-            fallbackSound: config.permissionSound
-          });
           
-          // Final check after smartNotify: if user responded during sound playback, cancel the scheduled reminder
-          if (activePermissionId !== permissionId) {
-            debugLog(`permission.updated: user responded during notification - cancelling any scheduled reminder`);
-            cancelPendingReminder('permission');
+          // Reset the batch window timer (debounce)
+          // This gives more permissions a chance to arrive before we notify
+          if (permissionBatchTimeout) {
+            clearTimeout(permissionBatchTimeout);
           }
+          
+          permissionBatchTimeout = setTimeout(async () => {
+            try {
+              await processPermissionBatch();
+            } catch (e) {
+              debugLog(`processPermissionBatch error: ${e.message}`);
+            }
+          }, PERMISSION_BATCH_WINDOW_MS);
+          
+          debugLog(`${event.type}: batch window reset (will process in ${PERMISSION_BATCH_WINDOW_MS}ms if no more arrive)`);
         }
       } catch (e) {
         debugLog(`event handler error: ${e.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-smart-voice-notify",
-  "version": "1.0.10",
+  "version": "1.0.13",
   "description": "Smart voice notification plugin for OpenCode with multiple TTS engines (ElevenLabs, Edge TTS, Windows SAPI) and intelligent reminder system",
   "main": "index.js",
   "type": "module",
@@ -35,13 +35,14 @@
   },
   "homepage": "https://github.com/MasuRii/opencode-smart-voice-notify#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@elevenlabs/elevenlabs-js": "^2.28.0",
+    "@elevenlabs/elevenlabs-js": "^2.29.0",
     "msedge-tts": "^2.0.3"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": "^1.0.0"
+    "@opencode-ai/plugin": "^1.1.4"
   }
 }

package/util/config.js

@@ -189,6 +189,16 @@ const generateDefaultConfig = (overrides = {}, version = '1.0.0') => {
         "Excuse me! I need your authorization before I can continue.",
         "Permission required! Please review and approve when ready."
     ], 4)},
+    
+    // Messages for MULTIPLE permission requests (use {count} placeholder)
+    // Used when several permissions arrive simultaneously
+    "permissionTTSMessagesMultiple": ${formatJSON(overrides.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."
+    ], 4)},
 
     // ============================================================
     // TTS REMINDER MESSAGES (More urgent - used after delay if no response)
@@ -213,6 +223,24 @@ const generateDefaultConfig = (overrides = {}, version = '1.0.0') => {
         "Still waiting for authorization! The task is on hold until you respond."
     ], 4)},
     
+    // Reminder messages for MULTIPLE permissions (use {count} placeholder)
+    "permissionReminderTTSMessagesMultiple": ${formatJSON(overrides.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."
+    ], 4)},
+    
+    // ============================================================
+    // PERMISSION BATCHING (Multiple permissions at once)
+    // ============================================================
+    // When multiple permissions arrive simultaneously, batch them into one notification
+    // This prevents overlapping sounds when 5+ permissions come at once
+    
+    // Batch window (ms) - how long to wait for more permissions before notifying
+    "permissionBatchWindowMs": ${overrides.permissionBatchWindowMs !== undefined ? overrides.permissionBatchWindowMs : 800},
+    
     // ============================================================
     // SOUND FILES (For immediate notifications)
     // These are played first before TTS reminder kicks in
@@ -246,7 +274,8 @@ const generateDefaultConfig = (overrides = {}, version = '1.0.0') => {
     // Consider monitor asleep after this many seconds of inactivity (Windows only)
     "idleThresholdSeconds": ${overrides.idleThresholdSeconds !== undefined ? overrides.idleThresholdSeconds : 60},
     
-    // Enable debug logging to ~/.config/opencode/smart-voice-notify-debug.log
+    // Enable debug logging to ~/.config/opencode/logs/smart-voice-notify-debug.log
+    // The logs folder is created automatically when debug logging is enabled
     // Useful for troubleshooting notification issues
     "debugLog": ${overrides.debugLog !== undefined ? overrides.debugLog : false}
 }`;

package/util/tts.js

@@ -71,6 +71,14 @@ export const getTTSConfig = () => {
       '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)
@@ -91,6 +99,17 @@ export const getTTSConfig = () => {
       '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,
     
     // ============================================================
     // SOUND FILES (Used for immediate notifications)
@@ -120,7 +139,17 @@ let elevenLabsQuotaExceeded = false;
  */
 export const createTTS = ({ $, client }) => {
   const config = getTTSConfig();
-  const logFile = path.join(configDir, 'smart-voice-notify-debug.log');
+  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) => {