/**
 * OPC Agent Traces — Structured logging for agent actions.
 *
 * Collects traces that can be fed to DeepBrain's learn() API.
 * Inspired by OpenTelemetry spans.
 */
export interface Span {
    traceId: string;
    spanId: string;
    name: string;
    startTime: Date;
    endTime?: Date;
    attributes: Record<string, string | number | boolean>;
    events: SpanEvent[];
    status: 'ok' | 'error' | 'unset';
}
export interface SpanEvent {
    name: string;
    timestamp: Date;
    attributes?: Record<string, string | number | boolean>;
}
export interface TraceExporter {
    export(spans: Span[]): Promise<void>;
}
/** In-memory buffer that holds spans until flushed */
export declare class TraceCollector {
    private spans;
    private exporters;
    private maxBufferSize;
    constructor(maxBufferSize?: number);
    addExporter(exporter: TraceExporter): void;
    startSpan(name: string, attributes?: Record<string, string | number | boolean>): Span;
    endSpan(span: Span, status?: 'ok' | 'error'): void;
    addEvent(span: Span, name: string, attributes?: Record<string, string | number | boolean>): void;
    flush(): Promise<number>;
    getBufferedSpans(): readonly Span[];
    get bufferedCount(): number;
}
/** Console exporter for development */
export declare class ConsoleExporter implements TraceExporter {
    export(spans: Span[]): Promise<void>;
}
/** DeepBrain exporter — sends traces to DeepBrain learn() */
export declare class DeepBrainExporter implements TraceExporter {
    private learnEndpoint;
    constructor(deepbrainUrl?: string);
    export(spans: Span[]): Promise<void>;
}
//# sourceMappingURL=index.d.ts.map