import { P as PersistedInspectEvent } from './persisted-inspect-event-q2ViiBW6.cjs';
import './inspect-event-ClM5Z8om.cjs';

interface TraceWriterStats {
    writtenEvents: number;
    droppedEvents: number;
    flushCount: number;
    lastFlushAt?: string;
    lastError?: string;
}
interface TraceWriter {
    write(event: PersistedInspectEvent): Promise<void>;
    flush?(): Promise<void>;
    close?(): Promise<void>;
    getStats?(): TraceWriterStats;
}
interface MemoryTraceWriter extends TraceWriter {
    getEvents(): PersistedInspectEvent[];
    clear(): void;
}
interface FileTraceWriterOptions {
    /**
     * Directory for per-run JSONL traces. Defaults to AgentInspect's default
     * trace directory when neither `dir` nor `filePath` is supplied.
     */
    dir?: string;
    /**
     * Explicit JSONL output path. When supplied, all accepted events are written
     * to this file rather than deriving a per-run file from `event.runId`.
     */
    filePath?: string;
}
type BufferedFileWriterOverflowMode = "drop-oldest" | "drop-newest";
interface BufferedFileWriterOptions extends FileTraceWriterOptions {
    /**
     * Maximum number of events retained before overflow policy applies.
     * Defaults to 1000.
     */
    maxQueueSize?: number;
    /**
     * Flush delay after the first queued event. Defaults to 250ms.
     */
    flushIntervalMs?: number;
    /**
     * Maximum events appended by one filesystem batch. Defaults to 100.
     */
    maxBatchSize?: number;
    /**
     * Overflow policy when `maxQueueSize` is reached. Defaults to `drop-oldest`.
     */
    overflow?: BufferedFileWriterOverflowMode;
}
interface CompositeTraceWriterOptions {
    writers: TraceWriter[];
}
declare function memoryWriter(): MemoryTraceWriter;
declare function nullWriter(): TraceWriter;
declare function fileWriter(options?: FileTraceWriterOptions): TraceWriter;
declare function bufferedFileWriter(options?: BufferedFileWriterOptions): TraceWriter;
declare function compositeWriter(writersOrOptions: TraceWriter[] | CompositeTraceWriterOptions): TraceWriter;

export { type BufferedFileWriterOptions, type BufferedFileWriterOverflowMode, type CompositeTraceWriterOptions, type FileTraceWriterOptions, type MemoryTraceWriter, type TraceWriter, type TraceWriterStats, bufferedFileWriter, compositeWriter, fileWriter, memoryWriter, nullWriter };