import { type RoostEvent } from "../../lib/events.js";
import { type Overlay, type OverlayHost } from "../overlay-host.js";
import type { RoostPort } from "../roost-port.js";
/** What the overlay asks of the daemon. */
export interface LogPort {
    events: Pick<RoostPort["events"], "list">;
}
/** What the overlay needs of the view. */
export type LogHost = Pick<OverlayHost<LogPort>, "port" | "theme" | "say" | "close" | "requestRender" | "termRows">;
export interface LogOpts {
    /** Keep only the events it accepts (a session's, the concierge's). */
    only?: (e: RoostEvent) => boolean;
    title?: string;
}
/**
 * `undefined` when the feed cannot be read or has nothing to show (the host has been told).
 * `r` reads it again (a failed reload keeps what is shown).
 */
export declare function createLogOverlay(host: LogHost, opts?: LogOpts): Promise<Overlay | undefined>;