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

package/README.md

@@ -52,6 +52,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
+  "showSessionTitle": true,
   "showIcon": true,
   "notificationSystem": "osascript",
   "command": {
@@ -68,11 +69,11 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
     "question": { "sound": true, "notification": true }
   },
   "messages": {
-    "permission": "Session needs permission",
-    "complete": "Session has finished",
-    "subagent_complete": "Subagent task completed",
-    "error": "Session encountered an error",
-    "question": "Session has a question"
+    "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}"
   },
   "sounds": {
     "permission": null,
@@ -80,13 +81,6 @@ 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
   }
 }
 ```
@@ -101,6 +95,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
+  "showSessionTitle": true,
   "showIcon": true,
   "notificationSystem": "osascript"
 }
@@ -110,6 +105,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
 - `notification` - Turn notifications on/off (default: true)
 - `timeout` - How long notifications show in seconds, Linux only (default: 5)
 - `showProjectName` - Show folder name in notification title (default: true)
+- `showSessionTitle` - Include the session title in notification messages via `{sessionTitle}` placeholder (default: true)
 - `showIcon` - Show OpenCode icon, Windows/Linux only (default: true)
 - `notificationSystem` - macOS only: `"osascript"` or `"node-notifier"` (default: "osascript")
 
@@ -146,15 +142,24 @@ Customize the notification text:
 ```json
 {
   "messages": {
-    "permission": "Session needs permission",
-    "complete": "Session has finished",
-    "subagent_complete": "Subagent task completed",
-    "error": "Session encountered an error",
-    "question": "Session has a question"
+    "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}"
   }
 }
 ```
 
+Messages support placeholder tokens that get replaced with actual values:
+
+- `{sessionTitle}` - The title/summary of the current session (e.g. "Fix login bug")
+- `{projectName}` - The project folder name
+
+When `showSessionTitle` is `false`, `{sessionTitle}` is replaced with an empty string. Any trailing separators (`: `, ` - `, ` | `) are automatically cleaned up when a placeholder resolves to empty.
+
+To disable session titles in messages without changing `showSessionTitle`, just remove the `{sessionTitle}` placeholder from your custom messages.
+
 ### Sounds
 
 Use your own sound files:
@@ -176,29 +181,9 @@ 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}` and `{message}` as placeholders:
+Run your own script when something happens. Use `{event}`, `{message}`, and `{sessionTitle}` as placeholders:
 
 ```json
 {
@@ -213,7 +198,7 @@ Run your own script when something happens. Use `{event}` and `{message}` as pla
 
 - `enabled` - Turn command on/off
 - `path` - Path to your script/executable
-- `args` - Arguments to pass, can use `{event}` and `{message}` tokens
+- `args` - Arguments to pass, can use `{event}`, `{message}`, and `{sessionTitle}` tokens
 - `minDuration` - Skip if response was quick, avoids spam (seconds)
 
 #### Example: Log events to a file

package/dist/index.js

@@ -3743,6 +3743,7 @@ var DEFAULT_CONFIG = {
   notification: true,
   timeout: 5,
   showProjectName: true,
+  showSessionTitle: true,
   showIcon: true,
   notificationSystem: "osascript",
   command: {
@@ -3758,11 +3759,11 @@ var DEFAULT_CONFIG = {
     question: { ...DEFAULT_EVENT_CONFIG }
   },
   messages: {
-    permission: "Session needs permission",
-    complete: "Session has finished",
-    subagent_complete: "Subagent task completed",
-    error: "Session encountered an error",
-    question: "Session has a question"
+    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}"
   },
   sounds: {
     permission: null,
@@ -3770,13 +3771,6 @@ var DEFAULT_CONFIG = {
     subagent_complete: null,
     error: null,
     question: null
-  },
-  volumes: {
-    permission: 1,
-    complete: 1,
-    subagent_complete: 1,
-    error: 1,
-    question: 1
   }
 };
 function getConfigPath() {
@@ -3797,18 +3791,6 @@ 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)) {
@@ -3831,6 +3813,7 @@ function loadConfig() {
       notification: globalNotification,
       timeout: typeof userConfig.timeout === "number" && userConfig.timeout > 0 ? userConfig.timeout : DEFAULT_CONFIG.timeout,
       showProjectName: userConfig.showProjectName ?? DEFAULT_CONFIG.showProjectName,
+      showSessionTitle: userConfig.showSessionTitle ?? DEFAULT_CONFIG.showSessionTitle,
       showIcon: userConfig.showIcon ?? DEFAULT_CONFIG.showIcon,
       notificationSystem: userConfig.notificationSystem === "node-notifier" ? "node-notifier" : "osascript",
       command: {
@@ -3859,13 +3842,6 @@ function loadConfig() {
         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
-      },
-      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)
       }
     };
   } catch {
@@ -3884,9 +3860,6 @@ 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;
@@ -3901,6 +3874,16 @@ function getIconPath(config) {
   } catch {}
   return;
 }
+function interpolateMessage(message, context) {
+  let result = message;
+  const sessionTitle = context.sessionTitle || "";
+  result = result.replaceAll("{sessionTitle}", sessionTitle);
+  const projectName = context.projectName || "";
+  result = result.replaceAll("{projectName}", projectName);
+  result = result.replace(/\s*[:\-|]\s*$/, "").trim();
+  result = result.replace(/\s{2,}/g, " ");
+  return result;
+}
 
 // src/notify.ts
 var import_node_notifier = __toESM(require_node_notifier(), 1);
@@ -3968,8 +3951,6 @@ 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`;
@@ -4012,32 +3993,12 @@ async function runCommand(command, args) {
     });
   });
 }
-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);
+async function playOnLinux(soundPath) {
   const players = [
-    { command: "paplay", args: [`--volume=${pulseVolume}`, soundPath] },
+    { command: "paplay", args: [soundPath] },
     { command: "aplay", args: [soundPath] },
-    { command: "mpv", args: ["--no-video", "--no-terminal", `--volume=${percentVolume}`, soundPath] },
-    { command: "ffplay", args: ["-nodisp", "-autoexit", "-loglevel", "quiet", "-volume", `${percentVolume}`, soundPath] }
+    { command: "mpv", args: ["--no-video", "--no-terminal", soundPath] },
+    { command: "ffplay", args: ["-nodisp", "-autoexit", "-loglevel", "quiet", soundPath] }
   ];
   for (const player of players) {
     try {
@@ -4048,21 +4009,20 @@ async function playOnLinux(soundPath, volume) {
     }
   }
 }
-async function playOnMac(soundPath, volume) {
-  await runCommand("afplay", ["-v", `${volume}`, soundPath]);
+async function playOnMac(soundPath) {
+  await runCommand("afplay", [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, volume) {
+async function playSound(event, customPath) {
   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;
   }
@@ -4070,10 +4030,10 @@ async function playSound(event, customPath, volume) {
   try {
     switch (os2) {
       case "darwin":
-        await playOnMac(soundPath, normalizedVolume);
+        await playOnMac(soundPath);
         break;
       case "linux":
-        await playOnLinux(soundPath, normalizedVolume);
+        await playOnLinux(soundPath);
         break;
       case "win32":
         await playOnWindows(soundPath);
@@ -4086,15 +4046,18 @@ async function playSound(event, customPath, volume) {
 
 // src/command.ts
 import { spawn as spawn2 } from "child_process";
-function substituteTokens(value, event, message) {
-  return value.replaceAll("{event}", event).replaceAll("{message}", message);
+function substituteTokens(value, event, message, sessionTitle, projectName) {
+  let result = value.replaceAll("{event}", event).replaceAll("{message}", message);
+  result = result.replaceAll("{sessionTitle}", sessionTitle || "");
+  result = result.replaceAll("{projectName}", projectName || "");
+  return result;
 }
-function runCommand2(config, event, message) {
+function runCommand2(config, event, message, sessionTitle, projectName) {
   if (!config.command.enabled || !config.command.path) {
     return;
   }
-  const args = (config.command.args ?? []).map((arg) => substituteTokens(arg, event, message));
-  const command = substituteTokens(config.command.path, event, message);
+  const args = (config.command.args ?? []).map((arg) => substituteTokens(arg, event, message, sessionTitle, projectName));
+  const command = substituteTokens(config.command.path, event, message, sessionTitle, projectName);
   const proc = spawn2(command, args, {
     stdio: "ignore",
     detached: true
@@ -4110,9 +4073,13 @@ function getNotificationTitle(config, projectName) {
   }
   return "OpenCode";
 }
-async function handleEvent(config, eventType, projectName, elapsedSeconds) {
+async function handleEvent(config, eventType, projectName, elapsedSeconds, sessionTitle) {
   const promises = [];
-  const message = getMessage(config, eventType);
+  const rawMessage = getMessage(config, eventType);
+  const message = interpolateMessage(rawMessage, {
+    sessionTitle: config.showSessionTitle ? sessionTitle : null,
+    projectName
+  });
   if (isEventNotificationEnabled(config, eventType)) {
     const title = getNotificationTitle(config, projectName);
     const iconPath = getIconPath(config);
@@ -4120,13 +4087,12 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds) {
   }
   if (isEventSoundEnabled(config, eventType)) {
     const customSoundPath = getSoundPath(config, eventType);
-    const soundVolume = getSoundVolume(config, eventType);
-    promises.push(playSound(eventType, customSoundPath, soundVolume));
+    promises.push(playSound(eventType, customSoundPath));
   }
   const minDuration = config.command?.minDuration;
   const shouldSkipCommand = typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0 && typeof elapsedSeconds === "number" && Number.isFinite(elapsedSeconds) && elapsedSeconds < minDuration;
   if (!shouldSkipCommand) {
-    runCommand2(config, eventType, message);
+    runCommand2(config, eventType, message, sessionTitle, projectName);
   }
   await Promise.allSettled(promises);
 }
@@ -4156,26 +4122,33 @@ async function getElapsedSinceLastPrompt(client, sessionID) {
   } catch {}
   return null;
 }
-async function isChildSession(client, sessionID) {
+async function getSessionInfo(client, sessionID) {
   try {
     const response = await client.session.get({ path: { id: sessionID } });
-    const parentID = response.data?.parentID;
-    return !!parentID;
+    return {
+      isChild: !!response.data?.parentID,
+      title: response.data?.title ?? null
+    };
   } catch {
-    return false;
+    return { isChild: false, title: null };
   }
 }
-async function handleEventWithElapsedTime(client, config, eventType, projectName, event) {
-  const minDuration = config.command?.minDuration;
-  const shouldLookupElapsed = !!config.command?.enabled && typeof config.command?.path === "string" && config.command.path.length > 0 && typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0;
+async function handleEventWithElapsedTime(client, config, eventType, projectName, event, preloadedSessionTitle) {
+  const sessionID = getSessionIDFromEvent(event);
   let elapsedSeconds = null;
-  if (shouldLookupElapsed) {
-    const sessionID = getSessionIDFromEvent(event);
-    if (sessionID) {
+  let sessionTitle = preloadedSessionTitle ?? null;
+  if (sessionID) {
+    const minDuration = config.command?.minDuration;
+    const shouldLookupElapsed = !!config.command?.enabled && typeof config.command?.path === "string" && config.command.path.length > 0 && typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0;
+    if (shouldLookupElapsed) {
       elapsedSeconds = await getElapsedSinceLastPrompt(client, sessionID);
     }
+    if (!sessionTitle && config.showSessionTitle) {
+      const info = await getSessionInfo(client, sessionID);
+      sessionTitle = info.title;
+    }
   }
-  await handleEvent(config, eventType, projectName, elapsedSeconds);
+  await handleEvent(config, eventType, projectName, elapsedSeconds, sessionTitle);
 }
 var NotifierPlugin = async ({ client, directory }) => {
   const config = loadConfig();
@@ -4191,18 +4164,24 @@ var NotifierPlugin = async ({ client, directory }) => {
       if (event.type === "session.idle") {
         const sessionID = getSessionIDFromEvent(event);
         if (sessionID) {
-          const isChild = await isChildSession(client, sessionID);
-          if (!isChild) {
-            await handleEventWithElapsedTime(client, config, "complete", projectName, event);
+          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);
+            await handleEventWithElapsedTime(client, config, "subagent_complete", projectName, event, sessionInfo.title);
           }
         } else {
           await handleEventWithElapsedTime(client, config, "complete", projectName, event);
         }
       }
       if (event.type === "session.error") {
-        await handleEventWithElapsedTime(client, config, "error", projectName, event);
+        const sessionID = getSessionIDFromEvent(event);
+        let sessionTitle = null;
+        if (sessionID && config.showSessionTitle) {
+          const info = await getSessionInfo(client, sessionID);
+          sessionTitle = info.title;
+        }
+        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.20-beta.0",
+  "version": "0.1.21-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",