export type MetricLabelValue = string | number | boolean;
export type MetricLabels = Record<string, MetricLabelValue>;
/** 延迟直方图默认桶（毫秒）：覆盖 10ms ~ 120s */
export declare const DEFAULT_DURATION_BUCKETS_MS: number[];
/** 首 token 延迟（TTFT）直方图默认桶（毫秒） */
export declare const DEFAULT_TTFT_BUCKETS_MS: number[];
/**
 * 进程内指标注册表。
 * 用法：
 *   const m = new MetricsRegistry();
 *   m.incCounter('agent_trace_total', { status: 'ok' }, 'Total traces');
 *   m.observeHistogram('agent_trace_duration_ms', {}, 'Trace duration', 1234);
 *   process.stdout.write(m.render());
 */
export declare class MetricsRegistry {
    /** 注册表创建时间（作为 OTLP metrics 的 startTimeUnixNano 基准） */
    private readonly startTimeMs;
    private counters;
    private histograms;
    /** 累加计数器（默认 +1） */
    incCounter(name: string, labels: MetricLabels, help: string, value?: number): void;
    /** 覆盖式设置计数器（用于进程级标量指标，如内存 / uptime） */
    setCounter(name: string, labels: MetricLabels, help: string, value: number): void;
    /** 记录一次观测值到直方图（按预定义桶累计 _bucket / _count / _sum） */
    observeHistogram(name: string, labels: MetricLabels, help: string, value: number, buckets?: number[]): void;
    /** 渲染为 Prometheus 文本导出格式（text/plain; version=0.0.4） */
    render(): string;
    /** 清空所有指标（测试 / 重置用） */
    reset(): void;
    /** 将标签转为 OTLP keyValue 数组（数字→doubleValue，布尔→boolValue，其余→stringValue） */
    private toOtlpAttributes;
    /**
     * 序列化为 OTLP/HTTP JSON 格式（metrics 信号，行业对标 G1-b 推模式）。
     * 可直接 POST 至 OTel Collector 的 `${endpoint}/v1/metrics`。
     * counters → OTLP Sum（isMonotonic），histograms → OTLP Histogram。
     */
    toOtlpJson(resourceAttributes?: MetricLabels): string;
    get size(): number;
}
//# sourceMappingURL=metrics.d.ts.map