ai-notify 0.1.0 → 0.1.1

package/package.json

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

@@ -9,9 +9,10 @@ import { deriveLabel, cliInvocation, isEphemeralInstall } from './util.mjs';
 import { curatedVoices, resolveVoice, previewVoice } from './voices.mjs';
 import * as menubar from './menubar.mjs';
 import { translate } from './translate.mjs';
+import { diagnose as highlightDiagnose, clearHighlight } from './highlight.mjs';
 import { isMuted, setMuted, toggleMuted, readConfig, writeConfig, paths, DEFAULT_CONFIG } from './state.mjs';
 
-const VERSION = '0.1.0';
+const VERSION = '0.1.1';
 
 const args = process.argv.slice(2);
 const cmd = args[0];
@@ -43,6 +44,37 @@ const readStdinJson = () => {
   }
 };
 
+// Pull the agent's last assistant text from a Claude Code transcript (JSONL),
+// trimmed to a short summary suitable for a notification / read-out.
+const lastAssistantText = (transcriptPath) => {
+  try {
+    const lines = readFileSync(transcriptPath, 'utf8').split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const line = lines[i].trim();
+      if (!line) continue;
+      let obj;
+      try {
+        obj = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (obj.type !== 'assistant') continue;
+      const content = obj.message?.content;
+      if (!Array.isArray(content)) continue;
+      const text = content
+        .filter((c) => c?.type === 'text' && c.text)
+        .map((c) => c.text)
+        .join(' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+      if (text) return text.length > 140 ? `${text.slice(0, 140)}…` : text;
+    }
+  } catch {
+    /* unreadable transcript — fall back to the template */
+  }
+  return '';
+};
+
 const cmds = {
   init() {
     const dryRun = !!opt('dry-run');
@@ -244,6 +276,24 @@ const cmds = {
     if (!config.translateTo) log('Enable:  ai-notify translate on ja');
   },
 
+  // Diagnose / test the waiting-window highlight. Run it INSIDE the terminal
+  // tab you want to test (not piped) so it has a controlling tty.
+  highlight() {
+    const sub = positionals[0] || 'test';
+    if (sub === 'clear') {
+      clearHighlight();
+      return log('cleared.');
+    }
+    const color = positionals[1] || readConfig().highlightColor || 'yellow';
+    const info = highlightDiagnose(color);
+    log(JSON.stringify(info, null, 2));
+    log('\nThis tab should now be highlighted. Reset it with: ai-notify highlight clear');
+    if (info.appleTerminal && String(info.appleTerminal).startsWith('ERROR')) {
+      log('\n→ AppleScript was blocked. Grant permission in:');
+      log('  System Settings → Privacy & Security → Automation → (your terminal) → Terminal');
+    }
+  },
+
   hook() {
     const source = opt('source', 'default');
     let event = opt('event', 'done');
@@ -263,6 +313,12 @@ const cmds = {
       const data = readStdinJson();
       cwd = data.cwd || '';
       message = data.message || '';
+      // The Stop hook has no message, so "done" would only say "finished".
+      // Pull the agent's last reply from the transcript so the notification
+      // says WHAT was done.
+      if (!message && event === 'done' && data.transcript_path) {
+        message = lastAssistantText(data.transcript_path);
+      }
     }
 
     const label = deriveLabel(cwd);

package/src/highlight.mjs

@@ -0,0 +1,261 @@
+// Visually highlight the terminal window/pane that is waiting for input, so it
+// stands out among many open terminals. Best-effort and terminal-specific:
+//
+//   - tmux              -> color the pane background (select-pane -P)
+//   - Apple Terminal    -> set the tab's background color via AppleScript,
+//                          matched by tty, restoring the original on done
+//   - others (iTerm2,…) -> OSC 11 default-background + a tab-title marker
+//
+// Everything is wrapped so a failure never affects the notification. The tab
+// title marker is the most portable signal and is always emitted.
+
+import { execFileSync } from 'node:child_process';
+import { writeFileSync, readFileSync, existsSync, rmSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { stateDir } from './state.mjs';
+
+const isMac = process.platform === 'darwin';
+const BEL = '\x07';
+
+// Controlling terminal of this process (works even when stdio is piped).
+const ttyName = () => {
+  try {
+    const t = execFileSync('ps', ['-o', 'tty=', '-p', String(process.pid)], { encoding: 'utf8' }).trim();
+    if (!t || t === '??' || t === '?') return null;
+    return t.startsWith('/dev/') ? t : `/dev/${t}`;
+  } catch {
+    return null;
+  }
+};
+
+const writeTty = (seq) => {
+  const tty = ttyName() || '/dev/tty';
+  try {
+    writeFileSync(tty, seq);
+  } catch {
+    /* no controlling terminal — ignore */
+  }
+};
+
+// Default-background (OSC 11) + icon/tab title (OSC 1/2). Reset uses OSC 111.
+const oscSet = (hex, title) => `\x1b]11;${hex}${BEL}\x1b]1;${title}${BEL}\x1b]2;${title}${BEL}`;
+const oscReset = `\x1b]111${BEL}\x1b]1;${BEL}\x1b]2;${BEL}`;
+
+// SGR fallback that works even where OSC is ignored (e.g. JetBrains JediTerm):
+// print a bold black-on-yellow bar straight into the pane, plus a BEL so the
+// IDE flags the tab as having activity. Standard ANSI — renders everywhere.
+const sgrBg = { yellow: 103, orange: '48;5;208', red: 101, green: 102 };
+const sgrBar = (label, color) => {
+  const bg = sgrBg[color] || sgrBg.yellow;
+  return `\r\n\x1b[1;30;${bg}m  ⏳ ${label || 'input'}  \x1b[0m${BEL}\r\n`;
+};
+
+const colorHex = (c) => {
+  const map = { yellow: '#FFD400', orange: '#FF9500', red: '#FF3B30', green: '#34C759' };
+  if (!c) return map.yellow;
+  return map[c] || (c.startsWith('#') ? c : map.yellow);
+};
+
+// --- tmux ---
+const tmuxPane = () => (process.env.TMUX && process.env.TMUX_PANE ? process.env.TMUX_PANE : null);
+const tmuxSet = (c) => {
+  const pane = tmuxPane();
+  if (!pane) return;
+  const color = c === 'yellow' || !c ? 'colour220' : c;
+  try {
+    execFileSync('tmux', ['select-pane', '-t', pane, '-P', `bg=${color}`]);
+  } catch {
+    /* ignore */
+  }
+};
+const tmuxReset = () => {
+  const pane = tmuxPane();
+  if (!pane) return;
+  try {
+    execFileSync('tmux', ['select-pane', '-t', pane, '-P', 'bg=default']);
+  } catch {
+    /* ignore */
+  }
+};
+
+// --- Apple Terminal (set the tab bg by tty; store original to restore) ---
+// Some setups don't export TERM_PROGRAM, so detect Apple Terminal robustly:
+// explicit signals first, then — when the terminal is unknown — attempt anyway.
+// The AppleScript matches by tty, so it's a harmless no-op if this isn't really
+// a Terminal.app tab. Known non-Terminal programs (iTerm.app, vscode, …) opt out
+// to avoid needless automation prompts.
+const isAppleTerminal = () => {
+  if (!isMac) return false;
+  const tp = process.env.TERM_PROGRAM;
+  const bundle = process.env.__CFBundleIdentifier || '';
+  if (tp === 'Apple_Terminal' || bundle === 'com.apple.Terminal') return true;
+  if (tp || bundle) return false; // a known other terminal/IDE (iTerm, WebStorm…)
+  return true; // truly unknown -> attempt; the tty match guards it
+};
+
+// JetBrains IDE terminals (WebStorm, IntelliJ, …) — JediTerm/Gen2.
+const isJetBrains = () =>
+  process.env.TERMINAL_EMULATOR === 'JetBrains-JediTerm' ||
+  /jetbrains/i.test(process.env.__CFBundleIdentifier || '');
+const savePath = (tty) => join(stateDir(), `hl-${tty.replace(/[^\w]+/g, '_')}`);
+
+const appleSet = (rgb16) => {
+  const tty = ttyName();
+  if (!tty) return;
+  const script = `tell application "Terminal"
+  repeat with w in windows
+    repeat with t in tabs of w
+      try
+        if (tty of t) is "${tty}" then
+          set c to background color of t
+          set background color of t to {${rgb16}}
+          return ((item 1 of c) & "," & (item 2 of c) & "," & (item 3 of c)) as string
+        end if
+      end try
+    end repeat
+  end repeat
+  return ""
+end tell`;
+  try {
+    const orig = execFileSync('osascript', ['-e', script], { encoding: 'utf8', timeout: 3000 }).trim();
+    if (orig) {
+      mkdirSync(stateDir(), { recursive: true });
+      writeFileSync(savePath(tty), orig);
+    }
+  } catch {
+    /* automation permission not granted / ignore */
+  }
+};
+
+const appleReset = () => {
+  const tty = ttyName();
+  if (!tty) return;
+  const p = savePath(tty);
+  // Only restore if WE highlighted this tab (a saved original exists). Without
+  // this guard a normal 'done' with no prior 'waiting' would blacken the tab.
+  if (!existsSync(p)) return;
+  let rgb16 = '0, 0, 0';
+  try {
+    rgb16 = readFileSync(p, 'utf8').trim() || rgb16;
+  } catch {
+    /* ignore */
+  }
+  const script = `tell application "Terminal"
+  repeat with w in windows
+    repeat with t in tabs of w
+      try
+        if (tty of t) is "${tty}" then set background color of t to {${rgb16}}
+      end try
+    end repeat
+  end repeat
+end tell`;
+  try {
+    execFileSync('osascript', ['-e', script], { timeout: 3000, stdio: 'ignore' });
+  } catch {
+    /* ignore */
+  }
+  try {
+    if (existsSync(p)) rmSync(p);
+  } catch {
+    /* ignore */
+  }
+};
+
+// 16-bit RGB for AppleScript yellow-ish; reuse hex→approx for custom.
+const rgb16From = (c) => {
+  if (c === 'orange') return '65535, 38000, 0';
+  if (c === 'red') return '65535, 15000, 12000';
+  if (c === 'green') return '13000, 51000, 22000';
+  return '65535, 54000, 0'; // yellow
+};
+
+// A per-tty marker so `clear` only touches the terminal when WE highlighted it
+// (a 'done' with no prior 'waiting' must leave the window untouched).
+const markPath = (tty) => join(stateDir(), `hl-on-${tty.replace(/[^\w]+/g, '_')}`);
+
+export const highlightWaiting = (label, color = 'yellow') => {
+  writeTty(oscSet(colorHex(color), `⏳ ${label || 'input'}`));
+  if (isJetBrains()) writeTty(sgrBar(label, color)); // OSC ignored here; SGR works
+  if (isAppleTerminal()) appleSet(rgb16From(color));
+  tmuxSet(color);
+  const tty = ttyName();
+  if (tty) {
+    try {
+      mkdirSync(stateDir(), { recursive: true });
+      writeFileSync(markPath(tty), '');
+    } catch {
+      /* ignore */
+    }
+  }
+};
+
+// Foreground diagnostic: run the highlight and surface what happened (tty,
+// terminal, AppleScript error/permission) instead of swallowing it.
+export const diagnose = (color = 'yellow') => {
+  const info = {
+    platform: process.platform,
+    TERM_PROGRAM: process.env.TERM_PROGRAM || null,
+    __CFBundleIdentifier: process.env.__CFBundleIdentifier || null,
+    isAppleTerminal: isAppleTerminal(),
+    TMUX: process.env.TMUX ? process.env.TMUX_PANE || true : false,
+    tty: ttyName(),
+  };
+  try {
+    writeTty(oscSet(colorHex(color), '⏳ test'));
+    info.osc = `wrote to ${ttyName() || '/dev/tty'}`;
+  } catch (e) {
+    info.osc = `error: ${e.message}`;
+  }
+  info.jetBrains = isJetBrains();
+  if (isJetBrains()) {
+    writeTty(sgrBar('test', color)); // should print a yellow bar right here
+    info.sgrBar = 'printed (look for the yellow bar above)';
+  }
+  if (isAppleTerminal()) {
+    const tty = ttyName();
+    if (!tty) {
+      info.appleTerminal = 'no controlling tty';
+    } else {
+      const script = `tell application "Terminal"
+  repeat with w in windows
+    repeat with t in tabs of w
+      try
+        if (tty of t) is "${tty}" then
+          set c to background color of t
+          set background color of t to {${rgb16From(color)}}
+          return "matched tty, original=" & (c as string)
+        end if
+      end try
+    end repeat
+  end repeat
+  return "no tab matched tty ${tty}"
+end tell`;
+      try {
+        info.appleTerminal = execFileSync('osascript', ['-e', script], {
+          encoding: 'utf8',
+          timeout: 5000,
+        }).trim();
+      } catch (e) {
+        info.appleTerminal = `ERROR: ${(e.stderr || e.message || '').toString().trim()}`;
+      }
+    }
+  } else {
+    info.appleTerminal = 'skipped (detected a non-Terminal program)';
+  }
+  return info;
+};
+
+export const clearHighlight = () => {
+  const tty = ttyName();
+  if (tty && !existsSync(markPath(tty))) return; // we never highlighted this one
+  writeTty(oscReset);
+  if (isAppleTerminal()) appleReset();
+  tmuxReset();
+  if (tty) {
+    try {
+      if (existsSync(markPath(tty))) rmSync(markPath(tty));
+    } catch {
+      /* ignore */
+    }
+  }
+};

package/src/notify.mjs

@@ -8,6 +8,7 @@ import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { isMuted, readConfig } from './state.mjs';
 import { translate } from './translate.mjs';
+import { highlightWaiting, clearHighlight } from './highlight.mjs';
 
 const platform = process.platform; // 'darwin' | 'linux' | 'win32'
 
@@ -70,16 +71,24 @@ const speak = (text, voice) => {
   }
 };
 
-const banner = (title, subtitle, message) => {
+const banner = (title, subtitle, message, { activate, urgent } = {}) => {
   if (platform === 'darwin') {
     if (which('terminal-notifier')) {
-      run('terminal-notifier', ['-title', title, '-subtitle', subtitle, '-message', message]);
+      const args = ['-title', title, '-subtitle', subtitle, '-message', message];
+      if (activate) args.push('-activate', activate); // click the notification -> focus the app
+      run('terminal-notifier', args);
     } else {
       const esc = (s) => String(s).replace(/"/g, '\\"');
-      run('osascript', ['-e', `display notification "${esc(message)}" with title "${esc(title)}" subtitle "${esc(subtitle)}"`]);
+      run('osascript', [
+        '-e',
+        `display notification "${esc(message)}" with title "${esc(title)}" subtitle "${esc(subtitle)}"`,
+      ]);
     }
   } else if (platform === 'linux') {
-    if (which('notify-send')) run('notify-send', [`${title}: ${subtitle}`, message]);
+    if (which('notify-send')) {
+      const args = urgent ? ['-u', 'critical'] : [];
+      run('notify-send', [...args, `${title}: ${subtitle}`, message]);
+    }
   }
   // win32: skipped (no dependency-free toast); sound/voice still fire.
 };
@@ -101,19 +110,19 @@ export const emit = ({ provider = 'default', event = 'done', label = '', message
   //                               (falling back to the template on failure).
   //   default                  -> speak the raw message as-is.
   // The desktop banner always shows the full original message visually.
-  let speakText;
+  // coreBody = WHAT happened, in the user's language, without the label.
+  let coreBody;
   if (config.speakAgentMessage === false) {
-    speakText = fromTemplate || fallback;
+    coreBody = fromTemplate || fallback;
   } else if (message) {
-    if (config.translateTo) {
-      const translated = translate(message, config.translateTo);
-      speakText = translated || fromTemplate || fallback;
-    } else {
-      speakText = message;
-    }
+    const translated = config.translateTo ? translate(message, config.translateTo) : message;
+    coreBody = translated || fromTemplate || fallback;
   } else {
-    speakText = fromTemplate || fallback;
+    coreBody = fromTemplate || fallback;
   }
+  // Prefix the window label for the spoken read-out so you can tell which of
+  // many terminals is asking (set a short per-window name with $AI_NOTIFY_LABEL).
+  const speakText = config.speakLabel !== false && label ? `${label}、${coreBody}` : coreBody;
 
   // Voice precedence (most specific first):
   //   $AI_NOTIFY_VOICE  — set per terminal window/pane to give each its own voice
@@ -127,7 +136,28 @@ export const emit = ({ provider = 'default', event = 'done', label = '', message
   }
 
   if (!muted || config.bannerWhenMuted) {
-    const title = 'AI Notify';
-    banner(title, label || provider, message || speakText);
+    const waiting = event === 'waiting';
+    banner(
+      waiting ? `⏳ ${label || 'input'}` : `✓ ${label || 'done'}`,
+      waiting ? 'waiting for input' : '',
+      coreBody,
+      {
+        // Click the notification to bring the waiting app (e.g. the IDE) forward.
+        activate: config.notifyActivate !== false ? process.env.__CFBundleIdentifier : undefined,
+        urgent: waiting,
+      }
+    );
+  }
+
+  // Visual highlight of *this* terminal window so a waiting pane stands out
+  // among many. Always best-effort, and applied even when muted (you still want
+  // to see which window needs you during a meeting).
+  if (config.highlightWaiting) {
+    try {
+      if (event === 'waiting') highlightWaiting(label, config.highlightColor);
+      else if (event === 'done') clearHighlight();
+    } catch {
+      /* visual is best-effort */
+    }
   }
 };

package/src/state.mjs

@@ -55,6 +55,15 @@ export const DEFAULT_CONFIG = {
   bannerWhenMuted: true,
   // Spoken read-out of which terminal finished (helps tell tabs apart).
   speak: true,
+  // Prefix the window label to the spoken message so you can tell which of many
+  // terminals is asking (set a short per-window name with $AI_NOTIFY_LABEL).
+  speakLabel: true,
+  // Visually highlight the waiting terminal window/pane (best-effort, by tty).
+  // Off by default; the color is yellow / orange / red / green / #RRGGBB.
+  highlightWaiting: false,
+  highlightColor: 'yellow',
+  // Make the desktop notification click bring the terminal/IDE forward.
+  notifyActivate: true,
   // Whether to speak the agent's own text (Codex's reply, a Claude prompt).
   // That text is in the agent's language — set this false to keep every spoken
   // read-out in your own language via doneMessage / waitingMessage instead.
@@ -70,12 +79,12 @@ export const DEFAULT_CONFIG = {
   // 'Kyoko'). Empty = OS default voice. Switch it with `ai-notify voice`. A
   // per-provider `voice` below, if set, overrides this for that agent.
   voice: '',
-  // Spoken read-out templates for agent events. `{label}` is the working-dir
-  // name. Override per language (e.g. Japanese) in config.json. An agent that
-  // supplies its own message (Codex's last reply, a Claude prompt) wins over
-  // these.
-  doneMessage: '{label} finished',
-  waitingMessage: '{label} is waiting for input',
+  // Spoken read-out templates for agent events. The window label is added
+  // separately (speakLabel), so leave {label} out here to avoid doubling it.
+  // Override per language (e.g. Japanese) in config.json. An agent that supplies
+  // its own message (Codex's last reply, a Claude prompt) wins over these.
+  doneMessage: 'finished',
+  waitingMessage: 'is waiting for input',
   providers: {
     claude: { sound: { waiting: 'Glass', done: 'Hero' }, voice: '' },
     codex: { sound: { done: 'Submarine' }, voice: '' },