import { type Lang } from './i18n.js';
declare function browserOpenCommand(url: string, platform?: NodeJS.Platform): {
    command: string;
    args: string[];
} | null;
/** Probe the public /api/health endpoint (no auth). */
declare function probeLocalWebHealth(url: string): Promise<boolean>;
/**
 * After spawnBackground, wait until the child is serving /api/health
 * (or dies). Replaces the old fixed 1.5s sleep that raced cold starts
 * and often printed the token hint before web-bootstrap-token existed.
 */
declare function waitForBackgroundReady(pid: number, opts?: {
    timeoutMs?: number;
    pollMs?: number;
}): Promise<'ready' | 'dead'>;
export declare function cmdStatus(): void;
export declare function cmdWeb(opts?: {
    public?: boolean;
    welcome?: boolean;
    open?: boolean;
    start?: boolean;
    openBrowser?: (url: string) => boolean;
}): Promise<number>;
/**
 * Foreground start is implemented by `program.command('start').action(...)`
 * in cli.ts; this handler delegates to it. For background, we re-spawn
 * ourselves detached.
 */
export declare function cmdStart(bg: boolean, runForegroundStart: () => Promise<void>): Promise<void>;
export declare function cmdStop(): Promise<void>;
export declare function cmdRestart(): Promise<void>;
/** The credential files that mode='creds' and mode='full' both wipe. */
declare function credentialFiles(): string[];
export declare function cmdUninstall(): Promise<void>;
export declare function offerServiceStart(lang: Lang, opts?: {
    welcome?: boolean;
}): Promise<void>;
export declare function printWebAccessHint(lang: Lang, opts?: {
    showUrl?: boolean;
    welcome?: boolean;
}): Promise<void>;
export declare const _internal: {
    browserOpenCommand: typeof browserOpenCommand;
    waitForBackgroundReady: typeof waitForBackgroundReady;
    probeLocalWebHealth: typeof probeLocalWebHealth;
    credentialFiles: typeof credentialFiles;
};
export {};
//# sourceMappingURL=cmd-handlers.d.ts.map