export interface WebServerOptions {
    port: number;
    host?: string;
    token?: string;
    /** --dev: mount a Vite dev server (middleware mode, HMR) for asset serving
     *  instead of the static dist/web-client/ bundle. The bridge + SSE + WS relay
     *  are identical in both modes. */
    dev?: boolean;
}
export interface RunningWebServer {
    url: string;
    port: number;
    clientDir: string;
    close: () => Promise<void>;
}
/** Build + start the unified web server. Binds the requested host/port and
 *  resolves once the server is listening. Async because --dev awaits a Vite
 *  middleware server before listening. */
export declare function startWebServer(opts: WebServerOptions): Promise<RunningWebServer>;