import { type NarrationLine } from "../report/narration.js";
export type { NarrationLine };
import type { ResolvedConfig } from "../types.js";
/** What the page is sent: lines to append, or a clear plus the tail. */
export interface NarrationFrame {
    /** True when the page should throw away what it has: a new run, or a trim. */
    reset: boolean;
    lines: NarrationLine[];
}
/** Forget where we were: a different project's narration is a different file. */
export declare function forgetNarration(): void;
/**
 * What has been said since the last time this was asked, or null for nothing.
 *
 * Null rather than an empty frame so the caller can skip the send entirely: a
 * board sitting idle should cost no traffic, and the watcher fires on every
 * file a capture writes.
 */
export declare function newNarration(resolved: ResolvedConfig): NarrationFrame | null;