/**
 * Terminal notifications.
 *
 * Two surfaces:
 *
 *   1. `bell()` — emits a single `\x07` BEL byte. Most modern terminals also
 *      generate a desktop notification when configured to.
 *   2. `notify({title, body})` — emits OSC 9 (iTerm2/Terminal.app) and OSC 777
 *      (urxvt/notify protocol). Falls back to writing the title to stderr
 *      when the terminal does not support either.
 *
 * Reference: claude-code ink/useTerminalNotification.ts:1.
 *
 * Notes:
 *   - We do not shell out to `osascript`/`terminal-notifier`. Doing so requires
 *     macOS-specific binaries and a permission grant. OSC 9 reaches every
 *     well-behaved modern terminal (iTerm2, WezTerm, Alacritty, kitty,
 *     Terminal.app), so it's the lowest-overhead path.
 *   - OSC sequences are silently ignored by terminals that don't understand
 *     them, so emitting both is safe.
 */
export interface NotifyOptions {
    title?: string;
    body: string;
    /** Emit a BEL alongside the OSC notification. Default: true. */
    bell?: boolean;
}
/** Single bell. Returns false when stderr isn't a TTY. */
export declare function bell(): boolean;
/**
 * Send a desktop notification. Returns false when stderr isn't a TTY (so the
 * caller can fall back to a log line).
 */
export declare function notify(opts: NotifyOptions): boolean;
//# sourceMappingURL=notifications.d.ts.map