import type { TurnBoundaryEventPacket } from "./packets.js";
/** Monotonic clock immune to system-clock adjustments; ms since an arbitrary origin. */
export declare function monotonicNowMs(): number;
export type ObservabilityLayer = "infrastructure" | "conversation";
export type TurnLocalizationVerdict = ObservabilityLayer | "none";
export interface TurnLocalizationSignals {
    readonly infrastructureBreached: boolean;
    readonly conversationFlagged: boolean;
}
export declare function localizeTurn(signals: TurnLocalizationSignals): TurnLocalizationVerdict;
/** One step of a reconstructed turn timeline, with elapsed ms since the prior boundary. */
export interface TurnTimelineStep {
    readonly boundary: TurnBoundaryEventPacket["boundary"];
    readonly speechId: string;
    readonly monotonicMs: number;
    /** ms since the previous boundary in this reconstruction (0 for the first). */
    readonly sincePrevMs: number;
    readonly cancelled: boolean;
}
/**
 * Incident reconstruction (VE-07.5): given the `obs.turn_boundary` events for one
 * session id, return the ordered turn timeline with inter-boundary deltas so a
 * developer can replay what happened from a single session id.
 */
export declare function reconstructTurnTimeline(events: readonly TurnBoundaryEventPacket[], sessionId: string, speechId?: string): TurnTimelineStep[];
export interface MetricTags {
    readonly [key: string]: string | undefined;
    readonly layer?: ObservabilityLayer;
}
export interface SpanHandle {
    end(tags?: MetricTags): void;
}
/** Export seam — implementations (Prometheus/OTel) live in optional packages, NOT here. */
export interface MetricsExporter {
    observeHistogram(name: string, valueMs: number, tags: MetricTags): void;
    /**
     * A monotonic count (tokens, characters, audio-seconds). Counters, not histograms:
     * usage sums to a bill, latency distributes to a percentile — different instruments.
     * Optional so an existing exporter that predates it still satisfies the interface;
     * producers call it as `exporter.observeCounter?.(...)`.
     */
    observeCounter?(name: string, value: number, tags: MetricTags): void;
    startSpan(name: string, tags: MetricTags): SpanHandle;
}
/** Default no-op exporter (core never depends on a backend). */
export declare const noopMetricsExporter: MetricsExporter;
/** In-memory exporter for tests + incident reconstruction. */
export declare class InMemoryMetricsExporter implements MetricsExporter {
    readonly histograms: Array<{
        name: string;
        valueMs: number;
        tags: MetricTags;
    }>;
    readonly counters: Array<{
        name: string;
        value: number;
        tags: MetricTags;
    }>;
    readonly spans: Array<{
        name: string;
        tags: MetricTags;
        durationMs?: number;
    }>;
    observeHistogram(name: string, valueMs: number, tags: MetricTags): void;
    observeCounter(name: string, value: number, tags: MetricTags): void;
    startSpan(name: string, tags: MetricTags): SpanHandle;
}
//# sourceMappingURL=observability.d.ts.map