done-ping

1import type { EngineInterface, Register } from 'claude-code'
2
3/** Turns shorter than this finish while you are still watching: no ping. */
4const MIN_TURN_MS = 30_000
5
6/**
7 * One macOS system sound per kind of ping, so you can tell them apart without
8 * looking. Any name in /System/Library/Sounds works: Basso Blow Bottle Frog
9 * Funk Glass Hero Morse Ping Pop Purr Sosumi Submarine Tink.
10 */
11export const SOUNDS = {
12  done: 'Glass',
13  failed: 'Basso',
14  needsYou: 'Submarine',
15} as const
16
17/** afplay volume: 1 is full, 0.05 a whisper. */
18export const VOLUME = 0.05
19
20const basename = (path: string) => path.replace(/\/+$/, '').split('/').pop() || path
21
22export function formatDuration(ms: number): string {
23  const s = Math.round(ms / 1000)
24  return s < 60 ? `${s}s` : `${Math.floor(s / 60)}m${String(s % 60).padStart(2, '0')}s`
25}
26
27export function snippet(text: string, max = 60): string {
28  const one = text.replace(/\s+/g, ' ').trim()
29  return one.length > max ? `${one.slice(0, max - 1)}…` : one
30}
31
32let repoName = ''
33let lastPrompt = ''
34
35async function repo($: EngineInterface): Promise<string> {
36  if (repoName) return repoName
37  const top = await $.process.run(['git', 'rev-parse', '--show-toplevel'], { timeoutMs: 5000 })
38  repoName = basename(top.exitCode === 0 ? top.stdout.trim() : await $.session.cwd())
39  return repoName
40}
41
42async function ping($: EngineInterface, title: string, body: string, sound: string) {
43  // afplay plays even when Focus mode mutes notification sounds.
44  void $.process.run(['afplay', '-v', String(VOLUME), `/System/Library/Sounds/${sound}.aiff`], { timeoutMs: 10_000 }).catch(() => undefined)
45  // argv keeps quotes in the prompt text from breaking the AppleScript.
46  await $.process
47    .run(
48      [
49        'osascript',
50        '-e', 'on run argv',
51        '-e', 'display notification (item 2 of argv) with title (item 1 of argv)',
52        '-e', 'end run',
53        title,
54        body,
55      ],
56      { timeoutMs: 5000 },
57    )
58    .catch(() => undefined)
59}
60
61export const register: Register = on => {
62  on('prompt.submit', ($, e, next) => {
63    lastPrompt = e.text
64    return next(e)
65  })
66
67  on('turn.complete', async ($, e, next) => {
68    const done = await next(e)
69    if (e.agentId !== undefined || e.isAborted || e.durationMs < MIN_TURN_MS) return done
70
71    const name = await repo($)
72    const ok = e.reason === 'answer'
73    void ping(
74      $,
75      `${ok ? '✅' : '❌'} ${name} · ${formatDuration(e.durationMs)}`,
76      snippet(lastPrompt) || (ok ? 'Done' : 'Ended with an error'),
77      ok ? SOUNDS.done : SOUNDS.failed,
78    )
79    return done
80  })
81
82  // Claude is blocked on you: a permission dialog or a question.
83  on('classic.Notification', async ($, e, next) => {
84    const ran = await next(e)
85    if (e.notification_type === 'permission_prompt' || e.notification_type === 'elicitation_dialog') {
86      const name = await repo($)
87      void ping($, `✋ ${name} needs you`, snippet(e.message), SOUNDS.needsYou)
88    }
89    return ran
90  })
91}
92