ai-notify 0.4.9 → 0.5.1

package/README.ja.md

@@ -112,6 +112,30 @@ ai-notify menubar install   # ネイティブのメニューバーアプリ・
 
 > 切替は実行中でも効きます：次にエージェントが発火した時にフラグを読むので、トグルした瞬間に全稼働エージェントへ反映されます。
 
+## 🪧 「応答待ち」ポップアップ
+
+エージェントが止まってあなたの入力を待っている状態は、ターミナルが多いと見落としがち。とくに IDE（WebStorm・VS Code）のターミナルは画像やリッチ通知を出せません。**常に最前面のキャラポップアップ**をオンにすると、応答待ちのペイン名を表示し、応答した瞬間に消えます：
+
+![ai-notify 応答待ちポップアップ](https://raw.githubusercontent.com/unoryota/ai-notify/main/assets/popup.png)
+
+```sh
+ai-notify popup on                      # 有効化（メニューバーの「応答待ちポップアップ」でも切替）
+ai-notify popup image ~/zundamon.png    # 好きなキャラ画像（PNG/JPG）。既定は顔文字
+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

@@ -113,6 +113,30 @@ No third-party app needed. Prefer something else? There are drop-in recipes for
 
 > Toggling works mid-run: the flag is read the next time an agent fires, so flipping it instantly affects every running agent.
 
+## 🪧 "Waiting for input" popup
+
+A stopped agent waiting on you is easy to miss across many terminals — especially in IDE terminals (WebStorm, VS Code) that can't show images or rich notifications. Turn on an **always-on-top character popup** that names the waiting pane and vanishes the moment you respond:
+
+![ai-notify waiting popup](https://raw.githubusercontent.com/unoryota/ai-notify/main/assets/popup.png)
+
+```sh
+ai-notify popup on                      # enable (also a menu bar toggle: 応答待ちポップアップ)
+ai-notify popup image ~/zundamon.png    # your own character (PNG/JPG); default is a kaomoji
+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

@@ -75,6 +75,57 @@ enum State {
         try? String(format: "%.2f", v).write(toFile: file("volume"), atomically: true, encoding: .utf8)
     }
 
+    // The "waiting" character popup: a flag file toggles it, an optional file
+    // holds a custom character image path. Same plain-file pattern as the others.
+    static var popupEnabled: Bool { FileManager.default.fileExists(atPath: file("popup")) }
+    static var popupImage: String? {
+        guard let s = try? String(contentsOfFile: file("popup-image"), encoding: .utf8) else { return nil }
+        let t = s.trimmingCharacters(in: .whitespacesAndNewlines)
+        return t.isEmpty ? nil : t
+    }
+
+    // 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] } ?? [:]
+        }
+        let waiting = obj("waiting.json")
+        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
+            .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 (item.tty, name.isEmpty ? short : name, item.tm.0, item.tm.1)
+            }
+    }
+
     // Tsundere baseline level 0.0 (デレ) – 1.0 (ツン). Same file the CLI reads.
     static func setTsundereLevel(_ v: Double) {
         try? FileManager.default.createDirectory(atPath: dir(), withIntermediateDirectories: true)
@@ -104,6 +155,13 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
     private var statusItem: NSStatusItem!
     private var timer: Timer?
 
+    // The "waiting for input" character popup.
+    private var waitingWindow: NSWindow?
+    private var waitingImageView: NSImageView?
+    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
+
     func applicationDidFinishLaunching(_ notification: Notification) {
         statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
         if let b = statusItem.button {
@@ -112,7 +170,10 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             b.sendAction(on: [.leftMouseUp, .rightMouseUp])
         }
         render()
-        timer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in self?.render() }
+        timer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in
+            self?.render()
+            self?.updateWaitingPopup()
+        }
 
         var shotPath = ProcessInfo.processInfo.environment["AI_NOTIFY_SHOT"]
         let args = CommandLine.arguments
@@ -168,6 +229,127 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         if e.type == .rightMouseUp { toggle() } else { showMenu() }
     }
 
+    // --- "Waiting for input" character popup ------------------------------
+    // Driven off the 1s timer: when popup is enabled and a pane is waiting, show
+    // 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() {
+        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()
+            return
+        }
+        let names = panes.map { $0.name }
+        let sig = names.joined(separator: "\u{1}")
+        if sig == waitingDismissedSig { return } // user dismissed exactly this set
+        if sig != waitingSig { waitingSig = sig; refreshWaitingPopup(names: names) }
+        waitingWindow?.orderFront(nil)
+    }
+
+    private func refreshWaitingPopup(names: [String]) {
+        if waitingWindow == nil { buildWaitingWindow() }
+        guard let win = waitingWindow else { return }
+        let line = names.count == 1
+            ? "\(names[0]) は応答待ち！"
+            : "\(names.count)件 応答待ち：\(names.joined(separator: "、"))"
+        waitingLabel?.stringValue = line
+
+        // Custom character image, or a friendly default kaomoji.
+        if let p = State.popupImage, let img = NSImage(contentsOfFile: p) {
+            waitingImageView?.image = img
+            waitingImageView?.isHidden = false
+        } else {
+            waitingImageView?.isHidden = true
+        }
+
+        if let scr = NSScreen.main {
+            let m: CGFloat = 24
+            let f = win.frame
+            win.setFrameOrigin(NSPoint(x: scr.visibleFrame.maxX - f.width - m,
+                                       y: scr.visibleFrame.minY + m))
+        }
+    }
+
+    private func hideWaitingPopup() {
+        guard let w = waitingWindow else { return }
+        w.orderOut(nil)
+        waitingSig = ""
+    }
+
+    @objc private func waitingClicked() {
+        waitingDismissedSig = waitingSig // don't reshow this exact set
+        hideWaitingPopup()
+    }
+
+    private func buildWaitingWindow() {
+        let w = NSWindow(contentRect: NSRect(x: 0, y: 0, width: 300, height: 96),
+                         styleMask: [.borderless], backing: .buffered, defer: false)
+        w.isOpaque = false
+        w.backgroundColor = .clear
+        w.level = .floating
+        w.hasShadow = true
+        w.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .stationary]
+        w.ignoresMouseEvents = false
+
+        let card = NSView(frame: NSRect(x: 0, y: 0, width: 300, height: 96))
+        card.wantsLayer = true
+        card.layer?.cornerRadius = 16
+        card.layer?.backgroundColor = NSColor(calibratedWhite: 0.10, alpha: 0.95).cgColor
+        card.layer?.borderWidth = 2
+        card.layer?.borderColor = NSColor.systemYellow.withAlphaComponent(0.9).cgColor
+
+        let iv = NSImageView(frame: NSRect(x: 12, y: 12, width: 72, height: 72))
+        iv.imageScaling = .scaleProportionallyUpOrDown
+        iv.isHidden = true
+        card.addSubview(iv)
+        waitingImageView = iv
+
+        // A friendly default "character" — a kaomoji — sits behind the image slot
+        // so there's always a face even without a custom image.
+        let face = NSTextField(labelWithString: "(｡･ω･｡)ﾉ")
+        face.frame = NSRect(x: 8, y: 30, width: 80, height: 36)
+        face.alignment = .center
+        face.font = .systemFont(ofSize: 17, weight: .semibold)
+        face.textColor = .systemYellow
+        card.addSubview(face, positioned: .below, relativeTo: iv)
+
+        let badge = NSTextField(labelWithString: "🟡 応答待ち")
+        badge.frame = NSRect(x: 96, y: 56, width: 196, height: 22)
+        badge.font = .systemFont(ofSize: 13, weight: .bold)
+        badge.textColor = .systemYellow
+        badge.backgroundColor = .clear
+        badge.isBordered = false
+        card.addSubview(badge)
+
+        let label = NSTextField(wrappingLabelWithString: "")
+        label.frame = NSRect(x: 96, y: 12, width: 196, height: 44)
+        label.font = .systemFont(ofSize: 15, weight: .semibold)
+        label.textColor = .white
+        label.maximumNumberOfLines = 2
+        label.backgroundColor = .clear
+        label.isBordered = false
+        card.addSubview(label)
+        waitingLabel = label
+
+        card.addGestureRecognizer(NSClickGestureRecognizer(target: self, action: #selector(waitingClicked)))
+        w.contentView = card
+        waitingWindow = w
+    }
+
     private func toggle() { State.setMuted(!State.isMuted); render() }
     @objc private func quit() { NSApp.terminate(nil) }
 
@@ -405,6 +587,15 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             }
         }
 
+        menu.addItem(.separator())
+        // Waiting-for-input character popup: on/off (set the character image with
+        // `ai-notify popup image <path>`).
+        let popupItem = NSMenuItem(title: "応答待ちポップアップ", action: #selector(runItem(_:)), keyEquivalent: "")
+        popupItem.target = self
+        popupItem.representedObject = ["popup", "toggle"]
+        popupItem.state = State.popupEnabled ? .on : .off
+        menu.addItem(popupItem)
+
         menu.addItem(.separator())
         let quitItem = NSMenuItem(title: "ai-notify を終了", action: #selector(quit), keyEquivalent: "q")
         quitItem.target = self

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-notify",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "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

@@ -33,7 +33,16 @@ import {
   readPaneSetting,
   updatePaneSetting,
   firstRunNudge,
+  isPopupEnabled,
+  setPopupEnabled,
+  getPopupImage,
+  setPopupImage,
+  getPopupDelay,
+  setPopupDelay,
+  getPopupIgnore,
+  setPopupIgnore,
 } from './state.mjs';
+import { resolve as resolvePath } from 'node:path';
 
 // Single source of truth: read the version from package.json so `--version`
 // (and the Homebrew formula test that checks it) always matches the release.
@@ -589,6 +598,50 @@ const cmds = {
     log(`✓ ${bits.join('  ·  ')}`);
   },
 
+  // 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>|delay <sec>|ignore <kw,kw>|status]
+  popup() {
+    const sub = positionals[0] || 'status';
+    if (sub === 'on' || sub === 'off' || sub === 'toggle') {
+      const on = sub === 'toggle' ? !isPopupEnabled() : sub === 'on';
+      setPopupEnabled(on);
+      return log(on ? '🪧 waiting popup ON' : 'waiting popup OFF');
+    }
+    if (sub === 'image') {
+      const p = positionals[1];
+      if (!p || p === 'clear' || p === 'default') {
+        setPopupImage('');
+        return log('popup image cleared (using the default character).');
+      }
+      const abs = resolvePath(p);
+      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(`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
   // sliders drive). With no args, prints the current values as JSON.
   //   voice-prosody [speed|pitch|intonation <value> | reset]
@@ -801,6 +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 <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,14 +198,73 @@ 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);
 };
 export const anyWaiting = () => Object.keys(readJson(waitingPath(), {})).length > 0;
+export const readWaiting = () => readJson(waitingPath(), {});
+
+// "Waiting" popup (the menu bar app shows a character that says a pane is waiting
+// for input). Toggle + optional custom character image, kept as small files the
+// Swift app reads directly — same pattern as the mute flag.
+const popupFlagPath = () => join(stateDir(), 'popup');
+const popupImagePath = () => join(stateDir(), 'popup-image');
+export const isPopupEnabled = () => existsSync(popupFlagPath());
+export const setPopupEnabled = (on) => {
+  ensureDir(stateDir());
+  if (on) writeFileSync(popupFlagPath(), '');
+  else rmSync(popupFlagPath(), { force: true });
+};
+export const getPopupImage = () => {
+  try {
+    return readFileSync(popupImagePath(), 'utf8').trim();
+  } catch {
+    return '';
+  }
+};
+export const setPopupImage = (p) => {
+  ensureDir(stateDir());
+  if (p) writeFileSync(popupImagePath(), 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) => {