import type { SpeedSample } from "./model-route-config.js";
export interface HistorySnapshot {
    /** ISO 时间戳 */
    ts: string;
    /** providerId → 当时的 P50/P95/errRate/samples */
    providers: Record<string, SpeedSample>;
}
export declare function getHistoryPath(): string;
export declare function appendSnapshot(snap: HistorySnapshot): void;
export declare function readHistory(opts?: {
    /** 只保留最近 N 小时；默认 24 */
    windowHours?: number;
    /** 仅返回某个 providerId（substring 匹配） */
    providerFilter?: string;
}): HistorySnapshot[];
/**
 * 砍最旧 N 条到 MAX_RETAINED。复用 atomic write（tmp + rename）。
 */
export declare function trimIfNeeded(): void;
/**
 * 把一组数值渲染成 ASCII spark line（用 ▁▂▃▄▅▆▇█ 8 级）。
 */
export declare function sparkLine(values: number[]): string;