import { type Trace } from "../../runDirectory/traces.js"; export type LogsExtractOptions = { log: string; trace?: string; out?: string; overwrite?: boolean; }; export type LogsExtractDependencies = { writeStdout(text: string): void; }; /** * Copy one trace's lines out of a statelog to a file or stdout, as they * appear in the source (minus a torn final line or a byte-identical repeated * line, which `readTraces` drops). A trace slice is itself a valid statelog, * so this is the primitive that turns "a run I noticed in a big log" into "a * run I can attach things to". */ export declare function logsExtract(options: LogsExtractOptions, dependencies?: LogsExtractDependencies): { traceId: string; lines: number; }; /** With no `--trace`, a single-trace log needs no choosing; several do. */ export declare function pickTrace(options: { log: string; trace?: string; }): Trace;