import { type Trace, type TraceMatch } from "./traces.js";
/** Find one trace in a statelog by full id or unique prefix. */
export declare function findTrace(statelogPath: string, idOrPrefix: string): TraceMatch;
export type WriteTraceFileArgs = {
    trace: Trace;
    outPath: string;
    /** The statelog the trace came from; the output may never be that file. */
    sourcePath: string;
    /** Replace an existing output file. Off by default: an existing file is
     *  refused, so a mistyped path cannot destroy something. */
    overwrite?: boolean;
};
/**
 * Write one trace as a statelog of its own: its lines exactly as they appear
 * in the source, so everything downstream reads the slice unchanged. The two
 * things `readTraces` already drops (a torn final line, and a line that is a
 * byte-identical repeat of an earlier one in the same trace) are not written.
 *
 * Creation is exclusive by default. Overwriting the source is refused even
 * with `overwrite`, since that would replace a whole log with one trace.
 */
export declare function writeTraceFile(args: WriteTraceFileArgs): void;