import { type Server } from 'node:http';
import { WilliMakoClient } from '../index.js';
export interface WebDashboardOptions {
    /** Custom Willi-Mako client instance (primarily for testing). */
    client?: WilliMakoClient;
    /** Port to bind the HTTP server. Defaults to PORT env var or 4173. */
    port?: number;
    /** Optional callback for structured logging. */
    logger?: (message: string) => void;
    /** Override the base URL used when constructing a client. */
    baseUrl?: string;
    /** Override the bearer token when constructing a new client. */
    token?: string | null;
}
export interface WebDashboardInstance {
    /** The bound port. */
    port: number;
    /** Underlying Node HTTP server. */
    server: Server;
    /** Convenience URL pointing to the dashboard root. */
    url: string;
    /** Gracefully stops the server. */
    stop(): Promise<void>;
}
export declare function startWebDashboard(options?: WebDashboardOptions): Promise<WebDashboardInstance>;