import { type RunTraceEventV1, type RunTraceKindV1, type RunTracePayloadMapV1 } from "./run-trace.js";
export interface RunTraceSink {
    append(event: RunTraceEventV1): Promise<void>;
}
export type RunTraceRedactor = (event: RunTraceEventV1) => RunTraceEventV1 | Promise<RunTraceEventV1>;
export type RunTraceFailureMode = "best_effort" | "required";
export interface RunTraceRecorderOptions {
    runId: string;
    sessionId?: string;
    sink: RunTraceSink;
    redactor?: RunTraceRedactor;
    failureMode?: RunTraceFailureMode;
    maxPending?: number;
    now?: () => number;
    createEventId?: () => string;
}
export interface RunTraceRecordContext {
    turnId?: string;
    parentEventId?: string;
}
export interface RunTraceRecorderFailure {
    sequence: number;
    message: string;
}
export declare class RunTraceRecorder {
    #private;
    constructor(options: RunTraceRecorderOptions);
    get failures(): readonly RunTraceRecorderFailure[];
    record<K extends RunTraceKindV1>(kind: K, payload: RunTracePayloadMapV1[K], context?: RunTraceRecordContext): Promise<RunTraceEventV1 | undefined>;
    flush(): Promise<void>;
}
export declare class InMemoryRunTraceSink implements RunTraceSink {
    #private;
    append(event: RunTraceEventV1): Promise<void>;
    snapshot(): RunTraceEventV1[];
}