import type { CliExecutionContext } from "./cli.js";
export interface StartWebRuntimeOptions {
    openBrowser: boolean;
    port?: number;
}
export interface StartHudOptions {
    port?: number;
}
export interface DesktopRuntimeStatus {
    statePath: string;
    web: DesktopProcessStatus;
    hud: DesktopProcessStatus;
}
export interface DesktopProcessStatus {
    target: "web" | "hud";
    status: "running" | "not-running" | "not-managed" | "stale";
    pid?: number;
    detail: string;
}
export interface StopDesktopRuntimeOptions {
    hud: boolean;
    web: boolean;
}
export interface StopDesktopRuntimeResult {
    target: "web" | "hud";
    status: "stopped" | "not-running" | "not-managed" | "stale" | "failed";
    pid?: number;
    detail: string;
}
export type DesktopRuntimeResult = {
    status: "running" | "started";
    dashboardUrl: string;
    port: number;
    pid?: number;
    notes: readonly string[];
} | DesktopRuntimeUnavailableResult;
export type DesktopShellResult = {
    status: "opened" | "started";
    executablePath: string;
    pid?: number;
    notes: readonly string[];
} | DesktopRuntimeUnavailableResult;
export interface DesktopRuntimeUnavailableResult {
    status: "unavailable";
    reason: string;
    guidance: readonly string[];
}
export interface CliDesktopRuntimeAdapter {
    startWebRuntime(options: StartWebRuntimeOptions): Promise<DesktopRuntimeResult>;
    startHud(options: StartHudOptions): Promise<DesktopShellResult>;
    status(): Promise<DesktopRuntimeStatus>;
    stop(options: StopDesktopRuntimeOptions): Promise<readonly StopDesktopRuntimeResult[]>;
}
export declare function desktopBackgroundSpawnOptions(platform?: NodeJS.Platform): {
    detached: boolean;
    stdio: "ignore";
    windowsHide: true;
};
export declare function createFallbackDesktopRuntimeAdapter(context: CliExecutionContext): CliDesktopRuntimeAdapter;
//# sourceMappingURL=desktop-runtime.d.ts.map