@mohak34/opencode-notifier 0.1.20 → 0.1.21

package/README.md

@@ -52,6 +52,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
+  "showSessionTitle": false,
   "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,
@@ -101,6 +102,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "notification": true,
   "timeout": 5,
   "showProjectName": true,
+  "showSessionTitle": false,
   "showIcon": true,
   "notificationSystem": "osascript"
 }
@@ -110,6 +112,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 +149,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:
@@ -198,7 +210,7 @@ Set per-event volume from `0` to `1`:
 
 ### 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 +225,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: false,
   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,
@@ -3831,6 +3832,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: {
@@ -3901,6 +3903,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);
@@ -4086,15 +4098,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 +4125,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);
@@ -4126,7 +4145,7 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds) {
   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 +4175,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 +4217,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",
+  "version": "0.1.21",
   "description": "OpenCode plugin that sends system notifications and plays sounds when permission is needed, generation completes, or errors occur",
   "author": "mohak34",
   "license": "MIT",