import type { EventEnvelope } from "../statelog/wireTypes.js";
/** Read a `.statelog.jsonl` file line by line and yield each event.
 *  Skips blank lines. Throws on the first malformed JSON line — the
 *  CLI wrapper catches and reports the line number. Streaming so
 *  large traces don't load the whole file into memory.
 *
 *  Stdin is intentionally NOT supported: every realistic use case
 *  is "I have a captured trace on disk and want to extract it".
 *  Skipping stdin keeps the contract simple and the `source` field
 *  on the record always a real path. */
export declare function readEvents(file: string): AsyncIterable<EventEnvelope>;
/** Convenience wrapper that materializes the whole stream. Most
 *  use cases need random access (span lookups, ordering), so we
 *  pay the memory cost. Streaming is preserved at the I/O boundary. */
export declare function readAllEvents(file: string): Promise<EventEnvelope[]>;
/** Synchronous variant for small, file-oriented facades such as
 *  StatelogParser. Keeps JSONL validation semantics aligned with
 *  readEvents(): blank lines are skipped, and malformed JSON reports
 *  the source line number. */
export declare function readAllEventsSync(file: string): EventEnvelope[];