import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
/** Candidate greetings spoken at session start and by the `greet` tool. */
export declare const GREETINGS: readonly ['Ready when you are.', 'What are we building today?', 'All systems ready.', 'Let us get to work.', 'Standing by for your next move.'];
/** Picks a uniformly random greeting from {@link GREETINGS}. */
export declare function pickRandomGreeting(): string;
/**
 * Builds the argv for macOS `say`: an optional `-v` voice flag, an optional
 * `-r` rate flag derived from `speedMultiplier` (rate is words-per-minute;
 * 180 is `say`'s default), followed by the text to speak.
 */
export declare function buildSayArgs(text: string, voice: string | undefined, speedMultiplier: number): string[];
/**
 * Notifies `ctx` with `text` and, on macOS, speaks it aloud via `say`. Off
 * macOS, or once `signal` is already aborted, the greeting still reaches the
 * user as a UI notification but no process is spawned.
 */
export declare function speakWithSay(text: string, ctx: ExtensionContext, signal: AbortSignal | undefined): Promise<void>;