@mohak34/opencode-notifier 0.1.21-beta.0 → 0.1.22-beta.0

package/README.md

@@ -52,7 +52,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
-  "showSessionTitle": true,
+  "showSessionTitle": false,
   "showIcon": true,
   "notificationSystem": "osascript",
   "command": {
@@ -81,6 +81,13 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
     "subagent_complete": null,
     "error": null,
     "question": null
+  },
+  "volumes": {
+    "permission": 1,
+    "complete": 1,
+    "subagent_complete": 1,
+    "error": 1,
+    "question": 1
   }
 }
 ```
@@ -95,7 +102,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
-  "showSessionTitle": true,
+  "showSessionTitle": false,
   "showIcon": true,
   "notificationSystem": "osascript"
 }
@@ -181,6 +188,26 @@ Platform notes:
 - Windows: Only .wav files work
 - If file doesn't exist, falls back to bundled sound
 
+### Volumes
+
+Set per-event volume from `0` to `1`:
+
+```json
+{
+  "volumes": {
+    "permission": 0.6,
+    "complete": 0.3,
+    "subagent_complete": 0.15,
+    "error": 1,
+    "question": 0.7
+  }
+}
+```
+
+- `0` = mute, `1` = full volume
+- Values outside `0..1` are clamped automatically
+- On Windows, playback still works but custom volume may not be honored by the default player
+
 ### Custom commands
 
 Run your own script when something happens. Use `{event}`, `{message}`, and `{sessionTitle}` as placeholders:

package/dist/index.js

@@ -3743,7 +3743,7 @@ var DEFAULT_CONFIG = {
   notification: true,
   timeout: 5,
   showProjectName: true,
-  showSessionTitle: true,
+  showSessionTitle: false,
   showIcon: true,
   notificationSystem: "osascript",
   command: {
@@ -3756,21 +3756,32 @@ var DEFAULT_CONFIG = {
     complete: { ...DEFAULT_EVENT_CONFIG },
     subagent_complete: { sound: false, notification: false },
     error: { ...DEFAULT_EVENT_CONFIG },
-    question: { ...DEFAULT_EVENT_CONFIG }
+    question: { ...DEFAULT_EVENT_CONFIG },
+    interrupted: { ...DEFAULT_EVENT_CONFIG }
   },
   messages: {
     permission: "Session needs permission: {sessionTitle}",
     complete: "Session has finished: {sessionTitle}",
     subagent_complete: "Subagent task completed: {sessionTitle}",
     error: "Session encountered an error: {sessionTitle}",
-    question: "Session has a question: {sessionTitle}"
+    question: "Session has a question: {sessionTitle}",
+    interrupted: "Session was interrupted: {sessionTitle}"
   },
   sounds: {
     permission: null,
     complete: null,
     subagent_complete: null,
     error: null,
-    question: null
+    question: null,
+    interrupted: null
+  },
+  volumes: {
+    permission: 1,
+    complete: 1,
+    subagent_complete: 1,
+    error: 1,
+    question: 1,
+    interrupted: 1
   }
 };
 function getConfigPath() {
@@ -3791,6 +3802,18 @@ function parseEventConfig(userEvent, defaultConfig) {
     notification: userEvent.notification ?? defaultConfig.notification
   };
 }
+function parseVolume(value, defaultVolume) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return defaultVolume;
+  }
+  if (value < 0) {
+    return 0;
+  }
+  if (value > 1) {
+    return 1;
+  }
+  return value;
+}
 function loadConfig() {
   const configPath = getConfigPath();
   if (!existsSync(configPath)) {
@@ -3827,21 +3850,32 @@ function loadConfig() {
         complete: parseEventConfig(userConfig.events?.complete ?? userConfig.complete, defaultWithGlobal),
         subagent_complete: parseEventConfig(userConfig.events?.subagent_complete ?? userConfig.subagent_complete, { sound: false, notification: false }),
         error: parseEventConfig(userConfig.events?.error ?? userConfig.error, defaultWithGlobal),
-        question: parseEventConfig(userConfig.events?.question ?? userConfig.question, defaultWithGlobal)
+        question: parseEventConfig(userConfig.events?.question ?? userConfig.question, defaultWithGlobal),
+        interrupted: parseEventConfig(userConfig.events?.interrupted ?? userConfig.interrupted, defaultWithGlobal)
       },
       messages: {
         permission: userConfig.messages?.permission ?? DEFAULT_CONFIG.messages.permission,
         complete: userConfig.messages?.complete ?? DEFAULT_CONFIG.messages.complete,
         subagent_complete: userConfig.messages?.subagent_complete ?? DEFAULT_CONFIG.messages.subagent_complete,
         error: userConfig.messages?.error ?? DEFAULT_CONFIG.messages.error,
-        question: userConfig.messages?.question ?? DEFAULT_CONFIG.messages.question
+        question: userConfig.messages?.question ?? DEFAULT_CONFIG.messages.question,
+        interrupted: userConfig.messages?.interrupted ?? DEFAULT_CONFIG.messages.interrupted
       },
       sounds: {
         permission: userConfig.sounds?.permission ?? DEFAULT_CONFIG.sounds.permission,
         complete: userConfig.sounds?.complete ?? DEFAULT_CONFIG.sounds.complete,
         subagent_complete: userConfig.sounds?.subagent_complete ?? DEFAULT_CONFIG.sounds.subagent_complete,
         error: userConfig.sounds?.error ?? DEFAULT_CONFIG.sounds.error,
-        question: userConfig.sounds?.question ?? DEFAULT_CONFIG.sounds.question
+        question: userConfig.sounds?.question ?? DEFAULT_CONFIG.sounds.question,
+        interrupted: userConfig.sounds?.interrupted ?? DEFAULT_CONFIG.sounds.interrupted
+      },
+      volumes: {
+        permission: parseVolume(userConfig.volumes?.permission, DEFAULT_CONFIG.volumes.permission),
+        complete: parseVolume(userConfig.volumes?.complete, DEFAULT_CONFIG.volumes.complete),
+        subagent_complete: parseVolume(userConfig.volumes?.subagent_complete, DEFAULT_CONFIG.volumes.subagent_complete),
+        error: parseVolume(userConfig.volumes?.error, DEFAULT_CONFIG.volumes.error),
+        question: parseVolume(userConfig.volumes?.question, DEFAULT_CONFIG.volumes.question),
+        interrupted: parseVolume(userConfig.volumes?.interrupted, DEFAULT_CONFIG.volumes.interrupted)
       }
     };
   } catch {
@@ -3860,6 +3894,9 @@ function getMessage(config, event) {
 function getSoundPath(config, event) {
   return config.sounds[event];
 }
+function getSoundVolume(config, event) {
+  return config.volumes[event];
+}
 function getIconPath(config) {
   if (!config.showIcon) {
     return;
@@ -3951,6 +3988,8 @@ import { existsSync as existsSync2 } from "fs";
 import { spawn } from "child_process";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
 var DEBOUNCE_MS2 = 1000;
+var FULL_VOLUME_PERCENT = 100;
+var FULL_VOLUME_PULSE = 65536;
 var lastSoundTime = {};
 function getBundledSoundPath(event) {
   const soundFilename = `${event}.wav`;
@@ -3993,12 +4032,32 @@ async function runCommand(command, args) {
     });
   });
 }
-async function playOnLinux(soundPath) {
+function normalizeVolume(volume) {
+  if (!Number.isFinite(volume)) {
+    return 1;
+  }
+  if (volume < 0) {
+    return 0;
+  }
+  if (volume > 1) {
+    return 1;
+  }
+  return volume;
+}
+function toPercentVolume(volume) {
+  return Math.round(volume * FULL_VOLUME_PERCENT);
+}
+function toPulseVolume(volume) {
+  return Math.round(volume * FULL_VOLUME_PULSE);
+}
+async function playOnLinux(soundPath, volume) {
+  const percentVolume = toPercentVolume(volume);
+  const pulseVolume = toPulseVolume(volume);
   const players = [
-    { command: "paplay", args: [soundPath] },
+    { command: "paplay", args: [`--volume=${pulseVolume}`, soundPath] },
     { command: "aplay", args: [soundPath] },
-    { command: "mpv", args: ["--no-video", "--no-terminal", soundPath] },
-    { command: "ffplay", args: ["-nodisp", "-autoexit", "-loglevel", "quiet", soundPath] }
+    { command: "mpv", args: ["--no-video", "--no-terminal", `--volume=${percentVolume}`, soundPath] },
+    { command: "ffplay", args: ["-nodisp", "-autoexit", "-loglevel", "quiet", "-volume", `${percentVolume}`, soundPath] }
   ];
   for (const player of players) {
     try {
@@ -4009,20 +4068,21 @@ async function playOnLinux(soundPath) {
     }
   }
 }
-async function playOnMac(soundPath) {
-  await runCommand("afplay", [soundPath]);
+async function playOnMac(soundPath, volume) {
+  await runCommand("afplay", ["-v", `${volume}`, soundPath]);
 }
 async function playOnWindows(soundPath) {
   const script = `& { (New-Object Media.SoundPlayer $args[0]).PlaySync() }`;
   await runCommand("powershell", ["-c", script, soundPath]);
 }
-async function playSound(event, customPath) {
+async function playSound(event, customPath, volume) {
   const now = Date.now();
   if (lastSoundTime[event] && now - lastSoundTime[event] < DEBOUNCE_MS2) {
     return;
   }
   lastSoundTime[event] = now;
   const soundPath = getSoundFilePath(event, customPath);
+  const normalizedVolume = normalizeVolume(volume);
   if (!soundPath) {
     return;
   }
@@ -4030,10 +4090,10 @@ async function playSound(event, customPath) {
   try {
     switch (os2) {
       case "darwin":
-        await playOnMac(soundPath);
+        await playOnMac(soundPath, normalizedVolume);
         break;
       case "linux":
-        await playOnLinux(soundPath);
+        await playOnLinux(soundPath, normalizedVolume);
         break;
       case "win32":
         await playOnWindows(soundPath);
@@ -4067,6 +4127,15 @@ function runCommand2(config, event, message, sessionTitle, projectName) {
 }
 
 // src/index.ts
+var recentErrors = new Map;
+setInterval(() => {
+  const cutoff = Date.now() - 5 * 60 * 1000;
+  for (const [sessionID, timestamp] of recentErrors) {
+    if (timestamp < cutoff) {
+      recentErrors.delete(sessionID);
+    }
+  }
+}, 5 * 60 * 1000);
 function getNotificationTitle(config, projectName) {
   if (config.showProjectName && projectName) {
     return `OpenCode (${projectName})`;
@@ -4087,7 +4156,8 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds, sessi
   }
   if (isEventSoundEnabled(config, eventType)) {
     const customSoundPath = getSoundPath(config, eventType);
-    promises.push(playSound(eventType, customSoundPath));
+    const soundVolume = getSoundVolume(config, eventType);
+    promises.push(playSound(eventType, customSoundPath, soundVolume));
   }
   const minDuration = config.command?.minDuration;
   const shouldSkipCommand = typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0 && typeof elapsedSeconds === "number" && Number.isFinite(elapsedSeconds) && elapsedSeconds < minDuration;
@@ -4103,7 +4173,7 @@ function getSessionIDFromEvent(event) {
   }
   return null;
 }
-async function getElapsedSinceLastPrompt(client, sessionID) {
+async function getElapsedSinceLastPrompt(client, sessionID, nowMs = Date.now()) {
   try {
     const response = await client.session.messages({ path: { id: sessionID } });
     const messages = response.data ?? [];
@@ -4117,7 +4187,7 @@ async function getElapsedSinceLastPrompt(client, sessionID) {
       }
     }
     if (lastUserMessageTime !== null) {
-      return (Date.now() - lastUserMessageTime) / 1000;
+      return (nowMs - lastUserMessageTime) / 1000;
     }
   } catch {}
   return null;
@@ -4164,11 +4234,18 @@ var NotifierPlugin = async ({ client, directory }) => {
       if (event.type === "session.idle") {
         const sessionID = getSessionIDFromEvent(event);
         if (sessionID) {
-          const sessionInfo = await getSessionInfo(client, sessionID);
-          if (!sessionInfo.isChild) {
-            await handleEventWithElapsedTime(client, config, "complete", projectName, event, sessionInfo.title);
+          const errorTime = recentErrors.get(sessionID);
+          if (errorTime && Date.now() - errorTime < 500) {
+            recentErrors.delete(sessionID);
+            const sessionInfo = await getSessionInfo(client, sessionID);
+            await handleEventWithElapsedTime(client, config, "interrupted", projectName, event, sessionInfo.title);
           } else {
-            await handleEventWithElapsedTime(client, config, "subagent_complete", projectName, event, sessionInfo.title);
+            const sessionInfo = await getSessionInfo(client, sessionID);
+            if (!sessionInfo.isChild) {
+              await handleEventWithElapsedTime(client, config, "complete", projectName, event, sessionInfo.title);
+            } else {
+              await handleEventWithElapsedTime(client, config, "subagent_complete", projectName, event, sessionInfo.title);
+            }
           }
         } else {
           await handleEventWithElapsedTime(client, config, "complete", projectName, event);
@@ -4176,12 +4253,22 @@ var NotifierPlugin = async ({ client, directory }) => {
       }
       if (event.type === "session.error") {
         const sessionID = getSessionIDFromEvent(event);
-        let sessionTitle = null;
-        if (sessionID && config.showSessionTitle) {
-          const info = await getSessionInfo(client, sessionID);
-          sessionTitle = info.title;
+        if (sessionID) {
+          recentErrors.set(sessionID, Date.now());
+          let sessionTitle = null;
+          if (config.showSessionTitle) {
+            const info = await getSessionInfo(client, sessionID);
+            sessionTitle = info.title;
+          }
+          setTimeout(() => {
+            if (recentErrors.has(sessionID)) {
+              recentErrors.delete(sessionID);
+              handleEventWithElapsedTime(client, config, "error", projectName, event, sessionTitle);
+            }
+          }, 100);
+        } else {
+          await handleEventWithElapsedTime(client, config, "error", projectName, event);
         }
-        await handleEventWithElapsedTime(client, config, "error", projectName, event, sessionTitle);
       }
     },
     "permission.ask": async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohak34/opencode-notifier",
-  "version": "0.1.21-beta.0",
+  "version": "0.1.22-beta.0",
   "description": "OpenCode plugin that sends system notifications and plays sounds when permission is needed, generation completes, or errors occur",
   "author": "mohak34",
   "license": "MIT",