import type { PlatformInfo } from "./types.ts";
export declare function detectPlatform(): PlatformInfo;
/**
 * Resolve the full path to a command by searching PATH.
 * Uses `which` on Unix/macOS and `where` on Windows.
 *
 * Results are cached in-memory to avoid repeated filesystem lookups.
 * Never throws — returns `null` on any error.
 */
export declare function findCommand(name: string): Promise<string | null>;
export declare function commandExists(name: string): Promise<boolean>;
export declare function preWarmCommandCache(names: string[]): Promise<void>;
export declare function getDefaultSoundPath(platform: PlatformInfo["os"]): string;
/**
 * Resolve the system command used to play audio notifications.
 *
 * - darwin: tries `afplay`
 * - linux: tries `paplay`, falls back to `aplay`
 * - win32: returns `"powershell"` (SoundPlayer via script)
 * - unknown: returns `null`
 */
export declare function resolveSoundPlayer(platform: PlatformInfo["os"]): Promise<string | null>;
/**
 * Resolve the system command used to send desktop toast notifications.
 *
 * - darwin: tries `terminal-notifier`, falls back to `osascript`
 * - linux: tries `notify-send`
 * - win32: returns `"powershell"`
 * - unknown: returns `null`
 */
export declare function resolveToastSender(platform: PlatformInfo["os"]): Promise<string | null>;
//# sourceMappingURL=platform.d.ts.map