/**
 * Desktop notifications from a background run (autopilot-live-progress/AC-21, AC-22).
 *
 * The run is a detached process whose stdout is its log file, so a terminal
 * notification sequence (OSC 9/777) would land in the log; the platform's own
 * notifier is the one that reaches a person.
 *
 * Fire and forget: nothing in a pass waits on a notice, retries one, or reports
 * one that failed — a notifier is a convenience, never a gate.
 *
 * @module
 */
import { spawn } from 'node:child_process';
export interface Notice {
    title: string;
    message: string;
}
/**
 * Control characters become spaces: a NUL makes `spawn` throw, and a newline or
 * escape has no business in a one-line notice. Then cut to `max`.
 */
export declare function clean(text: string, max: number): string;
/**
 * The argv that shows `notice` on `platform`, or null where there is no notifier.
 *
 * The AppleScript is a constant: title and message reach it as `argv` items, so a
 * quote in an error line can never become script. `notify-send` gets `--` so a
 * message starting with `-` is not read as an option.
 */
export declare function notifyArgv(platform: NodeJS.Platform, notice: Notice): string[] | null;
/** The notifier a background run hands its passes. */
export declare function desktopNotifier(platform?: NodeJS.Platform, spawnFn?: typeof spawn): (notice: Notice) => void;
//# sourceMappingURL=notify.d.ts.map