opencode-plugin-apprise 1.2.0 → 1.2.2

package/README.md

@@ -5,9 +5,8 @@ OpenCode plugin for multi-service notifications via Apprise.
 ## Features
 
 - Multi-service support for 128+ notification services via Apprise.
-- Automatic notifications when sessions go idle.
+- Automatic notifications when foreground sessions go idle, with a 30-second grace period (background tasks are excluded).
 - Delayed notifications for Question tool prompts (30-second grace period).
-- Alerts when sessions transition to idle after activity.
 - Notifications for permission requests with dual-mechanism reliability.
 
 ## Prerequisites
@@ -65,7 +64,7 @@ For complete configuration options, see: https://github.com/caronc/apprise#confi
 
 | Setting | Value |
 |---------|:------|
-| Maximum message length | 1,500 characters |
+| Idle notification delay | 30 seconds |
 | Deduplication TTL | 5 minutes (max 100 entries) |
 | Question notification delay | 30 seconds |
 | Apprise CLI timeout | 30 seconds |
@@ -74,7 +73,7 @@ For complete configuration options, see: https://github.com/caronc/apprise#confi
 
 ### Idle
 
-Fires immediately when OpenCode emits a `session.idle` event. Includes the last user request, agent response, and todo status.
+Fires 30 seconds after a foreground session goes idle. If the session becomes active again within 30 seconds, the notification is cancelled. Only root sessions (no parent) are notified — background agent sessions are automatically excluded. Includes the last user request, agent response, and todo status.
 
 **Severity**: info
 
@@ -100,17 +99,6 @@ Options:
   3. cancel
 ```
 
-### Background
-
-Fires when a session's status transitions to `idle` after being active. This indicates the agent has finished working and the session is waiting.
-
-**Severity**: success
-
-```
-✅ Background Task Complete
-Task: Session ses_abc123
-```
-
 ### Permission
 
 Fires when a tool requires explicit user permission. Uses two mechanisms for reliability: the primary `permission.ask` hook and a fallback `permission.updated` event listener. Permissions are deduplicated by ID to prevent double notifications.
@@ -136,10 +124,6 @@ For a complete list, see: https://github.com/caronc/apprise#supported-notificati
 
 ## How It Works
 
-### Message Truncation
-
-Messages exceeding 1,500 characters are truncated. For messages with more than 10 lines, the first 5 and last 5 lines are preserved with a `...(truncated)` marker. Otherwise, a simple character truncation is applied.
-
 ### Deduplication
 
 Identical notifications are suppressed for 5 minutes. Duplicates are identified by a hash of the notification type, title, user request, and question text. The cache holds a maximum of 100 entries with LRU eviction.
@@ -150,7 +134,6 @@ Identical notifications are suppressed for 5 minutes. Duplicates are identified
 |-------|:-------------|
 | Idle | info |
 | Question | warning |
-| Background | success |
 | Permission | warning |
 
 ## Troubleshooting
@@ -159,7 +142,6 @@ Identical notifications are suppressed for 5 minutes. Duplicates are identified
 - **No notifications received**: Check your Apprise config file (`~/.apprise`, `~/.apprise.yml`, or `~/.config/apprise/apprise.yml`) and test with `apprise -t test -b test`.
 - **Notifications not reaching a specific service**: Set `OPENCODE_NOTIFY_TAG` to match the tag assigned to that service in your Apprise config.
 - **Too many notifications**: Deduplication suppresses identical notifications for 5 minutes.
-- **Notifications cut off**: Messages are truncated at 1,500 characters.
 - **Apprise command hangs**: The CLI timeout is 30 seconds. If Apprise doesn't respond in time, the notification fails silently.
 
 ## Contributing

package/dist/formatter.d.ts

@@ -1,8 +1,6 @@
 import type { FormattedNotification, NotificationPayload } from "./types.js";
-export declare const DEFAULT_TRUNCATE_LENGTH = 1500;
-export declare function truncateText(text: string, maxLength: number): string;
 export declare function formatTodoStatus(todos: Array<{
     status: string;
     content: string;
 }>): string;
-export declare function formatNotification(payload: NotificationPayload, truncateLength?: number): FormattedNotification;
+export declare function formatNotification(payload: NotificationPayload): FormattedNotification;

package/dist/hooks/idle.d.ts

@@ -1,4 +1,4 @@
 import type { Hooks, PluginInput } from "@opencode-ai/plugin";
 import type { DedupChecker } from "../dedup.js";
 import type { PluginConfig } from "../types.js";
-export declare function createIdleHook(ctx: PluginInput, config: PluginConfig, dedup: DedupChecker, interactiveSessions: Set<string>): NonNullable<Hooks["event"]>;
+export declare function createIdleHook(ctx: PluginInput, config: PluginConfig, dedup: DedupChecker, delayMs?: number): NonNullable<Hooks["event"]>;

package/dist/opencode-plugin-apprise.js

@@ -56,32 +56,6 @@ var TYPE_MAP = {
   question: "warning",
   permission: "warning"
 };
-var DEFAULT_TRUNCATE_LENGTH = 1500;
-var TRUNCATE_LINE_THRESHOLD = 10;
-var TRUNCATE_HEAD_LINES = 5;
-var TRUNCATE_TAIL_LINES = 5;
-var TRUNCATE_MARKER = `
-...(truncated)`;
-function truncateText(text, maxLength) {
-  if (text.length <= maxLength)
-    return text;
-  const lines = text.split(`
-`);
-  if (lines.length <= TRUNCATE_LINE_THRESHOLD) {
-    const keepLength = maxLength - TRUNCATE_MARKER.length;
-    return text.slice(0, keepLength) + TRUNCATE_MARKER;
-  }
-  const head = lines.slice(0, TRUNCATE_HEAD_LINES).join(`
-`);
-  const tail = lines.slice(-TRUNCATE_TAIL_LINES).join(`
-`);
-  const result = head + TRUNCATE_MARKER + `
-` + tail;
-  if (result.length > maxLength) {
-    return text.slice(0, maxLength - TRUNCATE_MARKER.length) + TRUNCATE_MARKER;
-  }
-  return result;
-}
 function formatTodoStatus(todos) {
   const done = todos.filter((todo) => todo.status === "completed").length;
   const inProgress = todos.filter((todo) => todo.status === "in_progress").length;
@@ -95,7 +69,7 @@ function formatTodoStatus(todos) {
     parts.push(`⚪ ${pending} pending`);
   return parts.length > 0 ? parts.join(" | ") : "No todos";
 }
-function formatNotification(payload, truncateLength = DEFAULT_TRUNCATE_LENGTH) {
+function formatNotification(payload) {
   const { type, title, context } = payload;
   const notificationType = TYPE_MAP[type] ?? "info";
   let body;
@@ -143,7 +117,6 @@ ${context.options.map((option, index) => `  ${index + 1}. ${option}`).join(`
     default:
       body = "";
   }
-  body = truncateText(body, truncateLength);
   return { title, body, notificationType };
 }
 
@@ -222,7 +195,7 @@ async function sendHookNotification(hookName, config, dedup, payload) {
   if (dedup.isDuplicate(payload))
     return;
   try {
-    const formatted = formatNotification(payload, DEFAULT_TRUNCATE_LENGTH);
+    const formatted = formatNotification(payload);
     await sendNotification(config, formatted);
   } catch (err) {
     console.warn(`[opencode-plugin-apprise] ${hookName} hook error:`, err);
@@ -230,66 +203,81 @@ async function sendHookNotification(hookName, config, dedup, payload) {
 }
 
 // src/hooks/idle.ts
-function extractText(message) {
-  if (!message || typeof message !== "object") {
-    return;
-  }
-  const parts = Array.isArray(message) ? message.map((p) => typeof p === "string" ? p : p.text || "") : [];
-  return parts.join(`
+function extractText(parts) {
+  const texts = parts.filter((p) => p.type === "text" && p.text).map((p) => p.text);
+  return texts.join(`
 `).trim() || undefined;
 }
-function createIdleHook(ctx, config, dedup, interactiveSessions) {
+function createIdleHook(ctx, config, dedup, delayMs = 30000) {
+  const pendingTimers = new Map;
   return async ({ event }) => {
     if (event.type !== "session.status")
       return;
     const props = event.properties;
-    if (props.status.type !== "idle")
+    const sessionID = props.sessionID;
+    if (!sessionID)
       return;
-    if (!props.sessionID)
-      return;
-    if (!interactiveSessions.has(props.sessionID))
-      return;
-    let userRequest = undefined;
-    let agentResponse = undefined;
-    let todoStatus = undefined;
-    try {
-      const messagesResponse = await ctx.client.session.messages({
-        path: { id: props.sessionID }
-      });
-      const messages = messagesResponse.data ?? [];
-      for (let i = messages.length - 1;i >= 0; i--) {
-        const msg = messages[i];
-        if (msg?.role === "user") {
-          userRequest = extractText(msg.content);
-          break;
-        }
+    if (props.status.type !== "idle") {
+      const timer2 = pendingTimers.get(sessionID);
+      if (timer2) {
+        clearTimeout(timer2);
+        pendingTimers.delete(sessionID);
       }
-      if (userRequest) {
+      return;
+    }
+    const existing = pendingTimers.get(sessionID);
+    if (existing) {
+      clearTimeout(existing);
+    }
+    const timer = setTimeout(async () => {
+      pendingTimers.delete(sessionID);
+      let userRequest = undefined;
+      let agentResponse = undefined;
+      let todoStatus = undefined;
+      try {
+        const sessionResponse = await ctx.client.session.get({ path: { id: sessionID } });
+        const sessionInfo = sessionResponse.data;
+        if (sessionInfo.parentID)
+          return;
+        const messagesResponse = await ctx.client.session.messages({
+          path: { id: sessionID }
+        });
+        const messages = messagesResponse.data ?? [];
         for (let i = messages.length - 1;i >= 0; i--) {
           const msg = messages[i];
-          if (msg?.role === "assistant") {
-            agentResponse = extractText(msg.content);
+          if (msg?.info?.role === "user") {
+            userRequest = extractText(msg.parts);
             break;
           }
         }
-      }
-      try {
-        const todosResponse = await ctx.client.session.todo({
-          path: { id: props.sessionID }
-        });
-        if (todosResponse.data) {
-          todoStatus = formatTodoStatus(todosResponse.data);
+        if (userRequest) {
+          for (let i = messages.length - 1;i >= 0; i--) {
+            const msg = messages[i];
+            if (msg?.info?.role === "assistant") {
+              agentResponse = extractText(msg.parts);
+              break;
+            }
+          }
         }
-      } catch {}
-    } catch (err) {
-      console.warn("[opencode-plugin-apprise] failed to fetch session data:", err);
-    }
-    const payload = createPayload("idle", "\uD83D\uDCE2 OpenCode Attention Required", {
-      userRequest,
-      agentResponse,
-      todoStatus
-    });
-    await sendHookNotification("idle", config, dedup, payload);
+        try {
+          const todosResponse = await ctx.client.session.todo({
+            path: { id: sessionID }
+          });
+          if (todosResponse.data) {
+            todoStatus = formatTodoStatus(todosResponse.data);
+          }
+        } catch {}
+        const payload = createPayload("idle", "\uD83D\uDCE2 OpenCode Attention Required", {
+          userRequest,
+          agentResponse,
+          todoStatus
+        });
+        await sendHookNotification("idle", config, dedup, payload);
+      } catch (err) {
+        console.warn("[opencode-plugin-apprise] failed to fetch session data:", err);
+      }
+    }, delayMs);
+    pendingTimers.set(sessionID, timer);
   };
 }
 
@@ -381,8 +369,7 @@ var plugin = async (input) => {
     return {};
   }
   const dedup = createDedupChecker();
-  const interactiveSessions = new Set;
-  const idleHook = createIdleHook(input, config, dedup, interactiveSessions);
+  const idleHook = createIdleHook(input, config, dedup);
   const questionHook = createQuestionHook(config, dedup);
   const permissionHooks = createPermissionHooks(config, dedup);
   const combinedEventHook = async ({ event }) => {
@@ -390,13 +377,9 @@ var plugin = async (input) => {
     await permissionHooks.eventFallback({ event });
     await idleHook({ event });
   };
-  const chatMessageHook = async (input2) => {
-    interactiveSessions.add(input2.sessionID);
-  };
   return {
     event: combinedEventHook,
-    "permission.ask": permissionHooks.permissionAsk,
-    "chat.message": chatMessageHook
+    "permission.ask": permissionHooks.permissionAsk
   };
 };
 var src_default = plugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-plugin-apprise",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "OpenCode plugin that sends rich notifications via Apprise CLI when the agent needs your attention",
   "type": "module",
   "main": "dist/opencode-plugin-apprise.js",