ai-notify 0.5.0 → 0.5.2

package/README.ja.md

@@ -126,6 +126,16 @@ ai-notify popup off
 
 全アプリ・全スペースの上に浮かび、`<ペイン名> は応答待ち！` を表示。複数同時もまとめて表示します。クリックで消えます。macOS 専用（メニューバーアプリの導入が必要）。
 
+**出す条件を設定できます。** すべての「待ち」で割り込まれたくない人向け。サブエージェントの一瞬の待ちは黙ってほしいが、本当の「入力待ち」は気づきたい——を出し分けられます：
+
+```sh
+ai-notify popup delay 15                 # 15秒以上待っている時だけ出す（一瞬の待ちは無視）
+ai-notify popup ignore subagent,task     # 待ち理由テキストにこの語を含む時は出さない
+ai-notify popup ignore clear             # フィルタ解除
+```
+
+フィルタは Claude Code の通知理由（例「waiting for your input」やサブエージェント系メッセージ）に対して効くので、入力/許可待ちは残しつつ、それ以外を黙らせられます。
+
 ## 🎙️ VOICEVOX キャラクターボイス
 
 通知を [VOICEVOX](https://voicevox.hiroshiba.jp/) のキャラ声（例：ずんだもん）で読み上げられます（無料・ローカル・オフライン）。

package/README.md

@@ -127,6 +127,16 @@ ai-notify popup off
 
 It floats over every app and Space, shows `<pane name> は応答待ち！`, and lists multiple waiting panes at once. Click it to dismiss. macOS-only (needs the menu bar app installed).
 
+**Control when it pops up.** Not every wait deserves your attention — a quick sub-agent turnaround isn't worth interrupting you, but a real "needs your input" is. Two knobs:
+
+```sh
+ai-notify popup delay 15                 # only pop up after waiting ≥ 15s (skip transient waits)
+ai-notify popup ignore subagent,task     # skip waits whose reason text matches these words
+ai-notify popup ignore clear             # remove the filter
+```
+
+The filter matches Claude Code's notification reason (e.g. "waiting for your input" vs a sub-agent message), so you can keep input/permission prompts and silence the rest.
+
 ## 🎙️ VOICEVOX character voices
 
 Optionally speak your notifications in [VOICEVOX](https://voicevox.hiroshiba.jp/) character voices (e.g. ずんだもん) — free, local, offline.

package/menubar/AiNotifyMenuBar.swift

@@ -84,9 +84,23 @@ enum State {
         return t.isEmpty ? nil : t
     }
 
-    // Panes currently waiting for input, each with a display name (most-recent
-    // first). Name = the pane's spoken name, else its recorded label, else tty.
-    static func waitingPanes() -> [(tty: String, name: String)] {
+    // Numbers/strings for the popup threshold + reason filtering.
+    static var popupDelayMs: Double {
+        guard let s = try? String(contentsOfFile: file("popup-delay"), encoding: .utf8),
+              let v = Double(s.trimmingCharacters(in: .whitespacesAndNewlines)) else { return 0 }
+        return max(0, v) * 1000
+    }
+    static var popupIgnoreWords: [String] {
+        guard let s = try? String(contentsOfFile: file("popup-ignore"), encoding: .utf8) else { return [] }
+        return s.lowercased().split(whereSeparator: { $0 == "," || $0 == "\n" })
+            .map { $0.trimmingCharacters(in: .whitespaces) }.filter { !$0.isEmpty }
+    }
+
+    // Panes currently waiting for input (most-recent first), each with a display
+    // name, the wait-start time, and the reason message. Name = spoken name,
+    // else recorded label, else tty. Handles both the old (number) and new
+    // ({ts,msg}) waiting.json value shapes.
+    static func waitingPanes() -> [(tty: String, name: String, ts: Double, msg: String)] {
         func obj(_ name: String) -> [String: Any] {
             (try? Data(contentsOf: URL(fileURLWithPath: file(name))))
                 .flatMap { try? JSONSerialization.jsonObject(with: $0) as? [String: Any] } ?? [:]
@@ -95,14 +109,20 @@ enum State {
         if waiting.isEmpty { return [] }
         let voices = obj("pane-voices.json")
         let panes = obj("panes.json")
+        func tsmsg(_ v: Any) -> (Double, String) {
+            if let n = v as? NSNumber { return (n.doubleValue, "") }
+            if let d = v as? [String: Any] { return (((d["ts"] as? NSNumber)?.doubleValue) ?? 0, (d["msg"] as? String) ?? "") }
+            return (0, "")
+        }
         return waiting
-            .sorted { (((($0.value as? NSNumber)?.doubleValue) ?? 0) > ((($1.value as? NSNumber)?.doubleValue) ?? 0)) }
-            .map { (tty, _) in
-                let short = tty.replacingOccurrences(of: "/dev/", with: "")
-                let name = ((voices[tty] as? [String: Any])?["speakName"] as? String)
-                    ?? ((panes[tty] as? [String: Any])?["label"] as? String)
+            .map { (tty: $0.key, tm: tsmsg($0.value)) }
+            .sorted { $0.tm.0 > $1.tm.0 }
+            .map { item in
+                let short = item.tty.replacingOccurrences(of: "/dev/", with: "")
+                let name = ((voices[item.tty] as? [String: Any])?["speakName"] as? String)
+                    ?? ((panes[item.tty] as? [String: Any])?["label"] as? String)
                     ?? short
-                return (tty, name.isEmpty ? short : name)
+                return (item.tty, name.isEmpty ? short : name, item.tm.0, item.tm.1)
             }
     }
 
@@ -138,6 +158,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
     // The "waiting for input" character popup.
     private var waitingWindow: NSWindow?
     private var waitingImageView: NSImageView?
+    private var waitingFace: NSTextField?
     private var waitingLabel: NSTextField?
     private var waitingSig = ""        // current panes signature, to avoid needless redraws
     private var waitingDismissedSig = "" // a signature the user clicked away; don't reshow it
@@ -214,7 +235,20 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
     // an always-on-top window with a character + "<name> は応答待ち！". It hides
     // itself the moment nothing is waiting (or the user clicks it away).
     private func updateWaitingPopup() {
-        let panes = State.popupEnabled ? State.waitingPanes() : []
+        var panes: [(tty: String, name: String, ts: Double, msg: String)] = []
+        if State.popupEnabled {
+            let now = Date().timeIntervalSince1970 * 1000
+            let delayMs = State.popupDelayMs
+            let ignore = State.popupIgnoreWords
+            panes = State.waitingPanes().filter { p in
+                if now - p.ts < delayMs { return false } // hasn't waited long enough yet
+                if !ignore.isEmpty {
+                    let m = p.msg.lowercased()
+                    if ignore.contains(where: { m.contains($0) }) { return false } // a skipped reason
+                }
+                return true
+            }
+        }
         if panes.isEmpty {
             waitingDismissedSig = "" // reset; the next wait shows again
             hideWaitingPopup()
@@ -239,8 +273,10 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         if let p = State.popupImage, let img = NSImage(contentsOfFile: p) {
             waitingImageView?.image = img
             waitingImageView?.isHidden = false
+            waitingFace?.isHidden = true // the image stands in for the default face
         } else {
             waitingImageView?.isHidden = true
+            waitingFace?.isHidden = false
         }
 
         if let scr = NSScreen.main {
@@ -293,6 +329,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         face.font = .systemFont(ofSize: 17, weight: .semibold)
         face.textColor = .systemYellow
         card.addSubview(face, positioned: .below, relativeTo: iv)
+        waitingFace = face
 
         let badge = NSTextField(labelWithString: "🟡 応答待ち")
         badge.frame = NSRect(x: 96, y: 56, width: 196, height: 22)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-notify",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Desktop, sound, and spoken notifications for terminal AI coding agents (Claude Code, Codex, Gemini, ...) — with one mute switch that covers all of them, across every terminal.",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -37,6 +37,10 @@ import {
   setPopupEnabled,
   getPopupImage,
   setPopupImage,
+  getPopupDelay,
+  setPopupDelay,
+  getPopupIgnore,
+  setPopupIgnore,
 } from './state.mjs';
 import { resolve as resolvePath } from 'node:path';
 
@@ -596,7 +600,7 @@ const cmds = {
 
   // The "waiting" character popup (menu bar app): an always-on-top window that
   // shows a character saying which pane is waiting for input. macOS-only effect.
-  //   popup [on|off|toggle|image <path>|image clear|status]
+  //   popup [on|off|toggle|image <path>|delay <sec>|ignore <kw,kw>|status]
   popup() {
     const sub = positionals[0] || 'status';
     if (sub === 'on' || sub === 'off' || sub === 'toggle') {
@@ -614,9 +618,28 @@ const cmds = {
       setPopupImage(abs);
       return log(`popup image → ${abs}`);
     }
+    // Threshold: only pop up after a pane has been waiting this many seconds.
+    if (sub === 'delay') {
+      const v = parseFloat(positionals[1]);
+      if (!Number.isFinite(v)) return log(`popup delay: ${getPopupDelay()}s`);
+      setPopupDelay(Math.max(0, v));
+      return log(v > 0 ? `popup delay → ${Math.max(0, v)}s (waits shorter than this are ignored)` : 'popup delay → 0s (immediate)');
+    }
+    // Suppress the popup when the waiting reason contains any of these keywords.
+    if (sub === 'ignore') {
+      const kw = positionals.slice(1).join(' ').trim();
+      if (!kw || kw === 'clear') {
+        setPopupIgnore('');
+        return log('popup ignore cleared (no message filtering).');
+      }
+      setPopupIgnore(kw);
+      return log(`popup ignore → ${kw}`);
+    }
     log(`waiting popup: ${isPopupEnabled() ? '🪧 ON' : 'OFF'}`);
     log(`character image: ${getPopupImage() || '(default)'}`);
-    log('\nEnable:  ai-notify popup on      Your character:  ai-notify popup image /path/to/zunda.png');
+    log(`delay:          ${getPopupDelay()}s${getPopupDelay() > 0 ? ' (ignore shorter waits)' : ' (immediate)'}`);
+    log(`ignore words:   ${getPopupIgnore() || '(none)'}`);
+    log('\nEnable: ai-notify popup on   |   Threshold: ai-notify popup delay 15   |   Skip reasons: ai-notify popup ignore subagent,task');
   },
 
   // Get/set the VOICEVOX base prosody (the normal-tone scales the menu bar
@@ -831,7 +854,7 @@ Usage:
   ai-notify tsundere [on|off|level <0-1>|test|status]   tsundere persona (ツン⇄デレ by urgency)
   ai-notify voice-prosody [speed|pitch|intonation <v>|reset]  VOICEVOX read-out tuning
   ai-notify menubar [install|uninstall|status]       native menu bar bell (macOS)
-  ai-notify popup [on|off|image <path>]              "waiting for input" character popup (macOS)
+  ai-notify popup [on|off|image <p>|delay <s>|ignore <kw>]  "waiting for input" popup + when it shows (macOS)
   ai-notify translate [on <lang>|off|test]           speak agent text in your language
   ai-notify doctor                                    check deps & wiring
   ai-notify config [init]                             print (or write) config

package/src/notify.mjs

@@ -181,7 +181,9 @@ export const emit = ({ provider = 'default', event = 'done', label = '', message
   // pane's assigned name. Also remember the pane so the menu bar can list it.
   const tty = controllingTty();
   recordPane(tty, label);
-  setPaneWaiting(tty, event === 'waiting'); // waiting -> yellow menu bar status; done clears it
+  // waiting -> yellow menu bar status (+ the popup); done clears it. Pass the
+  // reason text so the popup can filter by it (e.g. ignore sub-agent waits).
+  setPaneWaiting(tty, event === 'waiting', event === 'waiting' ? message || fromTemplate : '');
   const pane = readPaneSetting(tty);
 
   // Name this pane in the read-out, most-reliable identity first:

package/src/state.mjs

@@ -198,10 +198,12 @@ const waitingPath = () => join(stateDir(), 'waiting.json');
 
 // Track which panes are waiting for input, so the menu bar icon can show a
 // status color (yellow) when any agent needs you.
-export const setPaneWaiting = (tty, waiting) => {
+export const setPaneWaiting = (tty, waiting, message = '') => {
   if (!tty) return;
   const all = readJson(waitingPath(), {});
-  if (waiting) all[tty] = Date.now();
+  // Store the reason text alongside the start time so the popup can filter by
+  // wait duration and by message (e.g. ignore sub-agent waits, keep input waits).
+  if (waiting) all[tty] = { ts: Date.now(), msg: String(message || '') };
   else delete all[tty];
   writeJson(waitingPath(), all);
 };
@@ -232,6 +234,38 @@ export const setPopupImage = (p) => {
   else rmSync(popupImagePath(), { force: true });
 };
 
+// Popup notify threshold: only show the popup once a pane has been waiting this
+// many seconds (0 = immediately) — so transient / sub-agent waits don't nag.
+const popupDelayPath = () => join(stateDir(), 'popup-delay');
+export const getPopupDelay = () => {
+  try {
+    return Math.max(0, parseFloat(readFileSync(popupDelayPath(), 'utf8')) || 0);
+  } catch {
+    return 0;
+  }
+};
+export const setPopupDelay = (sec) => {
+  ensureDir(stateDir());
+  if (sec > 0) writeFileSync(popupDelayPath(), String(sec));
+  else rmSync(popupDelayPath(), { force: true });
+};
+
+// Comma-separated keywords: if a waiting reason message contains any of them,
+// the popup is suppressed for that pane (e.g. "subagent,sub-agent,task").
+const popupIgnorePath = () => join(stateDir(), 'popup-ignore');
+export const getPopupIgnore = () => {
+  try {
+    return readFileSync(popupIgnorePath(), 'utf8').trim();
+  } catch {
+    return '';
+  }
+};
+export const setPopupIgnore = (s) => {
+  ensureDir(stateDir());
+  if (s) writeFileSync(popupIgnorePath(), s);
+  else rmSync(popupIgnorePath(), { force: true });
+};
+
 // Record this pane as active (keyed by tty). Keeps the 16 most-recent.
 export const recordPane = (tty, label) => {
   if (!tty) return;