ai-notify 0.4.9 → 0.5.0

package/README.ja.md

@@ -112,6 +112,20 @@ 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 専用（メニューバーアプリの導入が必要）。
+
 ## 🎙️ VOICEVOX キャラクターボイス
 
 通知を [VOICEVOX](https://voicevox.hiroshiba.jp/) のキャラ声（例：ずんだもん）で読み上げられます（無料・ローカル・オフライン）。

package/README.md

@@ -113,6 +113,20 @@ 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).
+
 ## 🎙️ 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,37 @@ 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
+    }
+
+    // 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)] {
+        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")
+        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)
+                    ?? short
+                return (tty, name.isEmpty ? short : name)
+            }
+    }
+
     // 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 +135,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 +150,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 +209,114 @@ 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() {
+        let panes = State.popupEnabled ? State.waitingPanes() : []
+        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 +554,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.0",
   "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,12 @@ import {
   readPaneSetting,
   updatePaneSetting,
   firstRunNudge,
+  isPopupEnabled,
+  setPopupEnabled,
+  getPopupImage,
+  setPopupImage,
 } 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 +594,31 @@ 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>|image clear|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}`);
+    }
+    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');
+  },
+
   // 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 +831,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 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/state.mjs

@@ -206,6 +206,31 @@ export const setPaneWaiting = (tty, waiting) => {
   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 });
+};
 
 // Record this pane as active (keyed by tty). Keeps the 16 most-recent.
 export const recordPane = (tty, label) => {