@erzhtor/opencode-tmux-notify 0.1.0 → 0.1.1

package/README.md

@@ -23,12 +23,17 @@ Or add to `opencode.json`:
 ```ts
 type Options {
   working?: string | { spinner: string; spinMs?: number }
-  done?:    string | { icon: string; clearMs?: number }
+  waiting?: string | { icon: string }
+  error?:   string | { icon: string; clearMs?: number | "never" }
+  done?:    string | { icon: string; clearMs?: number | "never" }
 }
 ```
 
-- **`working`** — string for static icon, or `{ spinner, spinMs }` for animation. Default: braille spinner at 80ms.
-- **`done`** — string for icon, or `{ icon, clearMs }` to control the auto-clear. Default: `✔`, 5000ms.
+- **`working`** — string for static icon, or `{ spinner, spinMs }` for animation. Default: heavy braille spinner at 80ms.
+- **`waiting`** — icon when agent is blocked waiting for your input (e.g. asking a question). Default: `⚠`. Always persists until the agent resumes.
+- **`error`** — icon when agent encounters an error. Default: `✘`, persists by default.
+- **`done`** — icon when agent finishes. Default: `✔` with 5000ms auto-clear.
+- **`clearMs: "never"`** — keep the icon until the next state (for `error` and `done` only). Omitting `clearMs` defaults to `"never"` for `error`, and `5000` for `done`.
 
 ### Examples
 
@@ -38,29 +43,51 @@ Use defaults:
 { "plugin": ["@erzhtor/opencode-tmux-notify"] }
 ```
 
-Static icon:
+Static icons + persist done forever:
 
 ```jsonc
 ["@erzhtor/opencode-tmux-notify", { "working": "⏳", "done": "✅" }]
 ```
 
-Custom spinner + timing:
+Custom spinner + flash error:
 
 ```jsonc
 ["@erzhtor/opencode-tmux-notify", {
   "working": { "spinner": "◐◓◑◒", "spinMs": 120 },
-  "done":    { "icon": "✓", "clearMs": 10000 }
+  "done":    { "icon": "✓", "clearMs": 10000 },
+  "error":   { "icon": "⚠", "clearMs": 5000 }
+}]
+```
+
+Disable waiting/error:
+
+```jsonc
+["@erzhtor/opencode-tmux-notify", {
+  "waiting": null,
+  "error": null
 }]
 ```
 
 ### Spinner presets
 
-braille *(default)* — dots walking around:
+braille — dots walking around:
 
 ```jsonc
 ["@erzhtor/opencode-tmux-notify", { "working": { "spinner": "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏" } }]
 ```
 
+heavy braille *(default)* — denser 8-dot pattern:
+
+```jsonc
+["@erzhtor/opencode-tmux-notify", { "working": { "spinner": "⣷⣯⣟⡿⢿⣻⣽⣾" } }]
+```
+
+arcs — crescent rotations:
+
+```jsonc
+["@erzhtor/opencode-tmux-notify", { "working": { "spinner": "◜◠◝◞◡◟" } }]
+```
+
 half-circles — rotating circle fills:
 
 ```jsonc
@@ -113,12 +140,15 @@ classic ascii — universal:
 
 | State   | Icon | Trigger                          |
 | ------- | ---- | -------------------------------- |
-| Working | ⠋    | Agent starts generating a response  |
-| Done    | ✔   | Session becomes idle             |
-| Clean   | —    | 5 seconds after done, or on exit |
+| Working | ⣷    | Agent starts generating a response |
+| Waiting | ⚠    | Agent needs your input (question, permission) |
+| Error   | ✘    | Agent encounters an error |
+| Done    | ✔    | Session becomes idle |
+| Clean   | —    | After `clearMs` timeout, or on exit |
 
 - **Multi-instance safe**: Uses `$TMUX_PANE` with `-t` targeting — each OpenCode instance only modifies its own window
 - **No-op outside tmux**: Silently returns if `$TMUX_PANE` is not set
 - **No shell injection**: Uses `execFileSync` (no shell interpolation)
 - **Exit cleanup**: Strips the icon when OpenCode exits
 - **Debounced**: Only sets the working icon once per agent turn
+- **State priority**: `waiting` > `error` > `done` — a blocked agent isn't truly idle

package/package.json

@@ -1,11 +1,20 @@
 {
   "name": "@erzhtor/opencode-tmux-notify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenCode plugin that shows agent activity status in tmux window names",
   "type": "module",
   "main": "tmux-notify.ts",
-  "files": ["tmux-notify.ts"],
-  "keywords": ["opencode", "opencode-plugin", "tmux", "notify", "notification", "status"],
+  "files": [
+    "tmux-notify.ts"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tmux",
+    "notify",
+    "notification",
+    "status"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",

package/tmux-notify.ts

@@ -1,7 +1,9 @@
 import { execFileSync } from "child_process";
 
 // Spinner presets for the `working.spinner` option:
-//   braille (default):       "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+//   braille:                  "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+//   heavy braille (default):   "⣷⣯⣟⡿⢿⣻⣽⣾"
+//   arcs:                     "◜◠◝◞◡◟"
 //   half-circles:             "◐◓◑◒"
 //   quadrant squares:         "◰◳◲◱"
 //   quadrant circles:         "◴◷◶◵"
@@ -10,11 +12,13 @@ import { execFileSync } from "child_process";
 //   block pulse:              "▁▂▃▄▅▆▇█▇▆▅▄▃▂"
 //   arrows:                   "←↖↑↗→↘↓↙"
 //   classic ascii:            "|/-\\"
-const DEFAULT_SPINNER = "\u280b\u2819\u2839\u2838\u283c\u2834\u2826\u2827\u2807\u280f"; // ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏
+const DEFAULT_SPINNER = "\u28f7\u28ef\u28df\u28bf\u28bf\u28fb\u28fd\u28fe"; // ⣷⣯⣟⡿⢿⣻⣽⣾
 
 type Options = {
   working?: string | { spinner: string; spinMs?: number };
-  done?: string | { icon: string; clearMs?: number };
+  waiting?: string | { icon: string };
+  error?:   string | { icon: string; clearMs?: number | "never" };
+  done?:    string | { icon: string; clearMs?: number | "never" };
 };
 
 type Resolved = {
@@ -22,38 +26,59 @@ type Resolved = {
   spinnerMs: number;
   useSpinner: boolean;
   iconWorking: string;
+  iconWaiting: string;
+  iconError: string;
+  errorClearMs: number | "never";
   iconDone: string;
-  clearMs: number;
+  doneClearMs: number | "never";
 };
 
-export const TmuxNotifyPlugin = async (
-  _input: any,
-  options?: Options,
-) => {
+type State = "clean" | "working" | "waiting" | "error" | "done";
+
+export const TmuxNotifyPlugin = async (_input: any, options?: Options) => {
   if (!process.env.TMUX_PANE) return {};
 
   const w = options?.working;
   const useSpinner = w == null || typeof w === "object";
 
   const cfg: Resolved = {
-    spinner: useSpinner ? (typeof w === "object" ? w.spinner : DEFAULT_SPINNER) : DEFAULT_SPINNER,
+    spinner:
+      useSpinner
+        ? typeof w === "object" && w.spinner ? w.spinner : DEFAULT_SPINNER
+        : DEFAULT_SPINNER,
     spinnerMs: typeof w === "object" ? (w.spinMs ?? 80) : 80,
     useSpinner,
     iconWorking: typeof w === "string" ? w : "",
+
+    iconWaiting:
+      options?.waiting == null ? "\u26A0"
+      : typeof options.waiting === "string" ? options.waiting
+      : options.waiting.icon,
+
+    iconError:
+      options?.error == null ? "\u2718"
+      : typeof options.error === "string" ? options.error
+      : options.error.icon,
+    errorClearMs:
+      options?.error == null ? "never"
+      : typeof options.error === "string" ? "never"
+      : options.error.clearMs ?? "never",
+
     iconDone:
-      options?.done == null ? "\u2714" // ✔
+      options?.done == null ? "\u2714"
       : typeof options.done === "object" ? options.done.icon
       : options.done,
-    clearMs:
+    doneClearMs:
       options?.done == null ? 5000
-      : typeof options.done === "object" ? (options.done.clearMs ?? 5000)
-      : 5000,
+      : typeof options.done === "object" ? (options.done.clearMs ?? "never")
+      : "never",
   };
 
   const pane = process.env.TMUX_PANE;
-  let working = false;
-  let clearTimer: any = null;
-  let spinnerId: any = null;
+
+  let state: State = "clean";
+  let clearTimer: ReturnType<typeof setTimeout> | null = null;
+  let spinnerId: ReturnType<typeof setInterval> | null = null;
   let spinnerIdx = 0;
   let baseName: string | null = null;
 
@@ -89,19 +114,20 @@ export const TmuxNotifyPlugin = async (
     }
   };
 
-  process.on("exit", () => {
+  const clearClearTimer = () => {
+    if (clearTimer) {
+      clearTimeout(clearTimer);
+      clearTimer = null;
+    }
+  };
+
+  const transition = (next: State) => {
     stopSpinner();
-    set();
-  });
+    clearClearTimer();
+    state = next;
 
-  return {
-    event: async ({ event }: { event: any }) => {
-      if (event.type === "message.part.updated" && !working) {
-        working = true;
-        if (clearTimer) {
-          clearTimeout(clearTimer);
-          clearTimer = null;
-        }
+    switch (next) {
+      case "working":
         if (cfg.useSpinner) {
           spinnerIdx = 0;
           spinnerId = setInterval(() => {
@@ -112,12 +138,50 @@ export const TmuxNotifyPlugin = async (
         } else {
           set(cfg.iconWorking);
         }
-      }
-      if (event.type === "session.idle") {
-        working = false;
-        stopSpinner();
+        break;
+      case "waiting":
+        set(cfg.iconWaiting);
+        break;
+      case "error":
+        set(cfg.iconError);
+        if (typeof cfg.errorClearMs === "number") {
+          clearTimer = setTimeout(() => transition("clean"), cfg.errorClearMs);
+        }
+        break;
+      case "done":
         set(cfg.iconDone);
-        clearTimer = setTimeout(() => set(), cfg.clearMs);
+        if (typeof cfg.doneClearMs === "number") {
+          clearTimer = setTimeout(() => transition("clean"), cfg.doneClearMs);
+        }
+        break;
+      case "clean":
+        set();
+        break;
+    }
+  };
+
+  process.on("exit", () => {
+    stopSpinner();
+    set();
+  });
+
+  return {
+    event: async ({ event }: { event: any }) => {
+      if (event.type === "session.status") {
+        const status = event.properties?.status?.type;
+        if (status === "busy" && state !== "working") {
+          transition("working");
+        } else if (
+          status === "idle" &&
+          state !== "waiting" &&
+          state !== "error"
+        ) {
+          transition("done");
+        }
+      } else if (event.type === "question.asked") {
+        transition("waiting");
+      } else if (event.type === "session.error") {
+        transition("error");
       }
     },
   };