export interface AdaptiveParamsConfig {
    /** 成功率高于该值（0-1）视为优秀，可降低参数（默认 0.8） */
    highRate: number;
    /** 成功率低于该值（0-1）视为偏弱，需提高参数（默认 0.5） */
    lowRate: number;
    /** 判定所需最小样本数：样本不足时不调整、用默认值（默认 5） */
    minSamples: number;
    /** 滞后窗口：同一方向需连续采样 N 次才生效一次（默认 5） */
    hysteresisSamples: number;
    /** retries 下限（默认 1） */
    minRetries: number;
    /** retries 上限（默认 5） */
    maxRetries: number;
    /** timeout 下限 ms（默认 60_000 = 60s） */
    minTimeoutMs: number;
    /** timeout 上限 ms（默认 300_000 = 300s） */
    maxTimeoutMs: number;
    /** 自适应起点 retries（默认 3） */
    defaultRetries: number;
    /** 自适应起点 timeout ms（默认 180_000 = 180s） */
    defaultTimeoutMs: number;
    /** timeout 每档步长 ms（默认 30_000 = 30s） */
    timeoutStepMs: number;
    /** 滑动窗口大小：每个键保留最近 N 条样本（默认 20） */
    windowSize: number;
}
export declare const DEFAULT_ADAPTIVE_CONFIG: AdaptiveParamsConfig;
/** 当前生效的自适应参数 */
export interface AdaptiveParams {
    retries: number;
    timeoutMs: number;
}
/** 调整方向：-1 降参 / 0 不变 / +1 升参 */
export type AdjustmentDirection = -1 | 0 | 1;
/** 读取当前配置（返回副本，避免外部篡改） */
export declare function getAdaptiveParamsConfig(): AdaptiveParamsConfig;
/** 部分更新配置（未提供的字段保持原值） */
export declare function configureAdaptiveParams(partial: Partial<AdaptiveParamsConfig>): void;
/** 清空全部采样历史（测试与运行时重置用） */
export declare function resetAdaptiveParams(): void;
/**
 * 根据成功率与样本数判定调整方向（纯函数）：
 * - 样本不足 minSamples → 0（未知，不调整，用默认值）
 * - 成功率 > highRate → -1（降参）
 * - 成功率 < lowRate → +1（升参）
 * - 中间区间（含恰等于阈值）→ 0（不调整，避免边界抖动）
 */
export declare function evaluateAdjustment(successRate: number, sampleCount: number, cfg?: AdaptiveParamsConfig): AdjustmentDirection;
/** 参数限幅（纯函数）：retries ∈ [minRetries, maxRetries]，timeout ∈ [minTimeoutMs, maxTimeoutMs] */
export declare function clampAdaptiveParams(params: AdaptiveParams, cfg?: AdaptiveParamsConfig): AdaptiveParams;
/** 按方向调整一档参数（纯函数）：-1 降、+1 升、0 不变，调整后限幅 */
export declare function adjustAdaptiveParams(current: AdaptiveParams, direction: AdjustmentDirection, cfg?: AdaptiveParamsConfig): AdaptiveParams;
/**
 * 记录一次采样结果并推进滞后状态机：
 * - key 形如 "strategy\u0000agent"（与 tracker computeStats 的键一致）
 * - 样本不足 minSamples 时仅积累样本、不推进滞后状态（参数保持默认）
 * - 样本足够后按滑动窗口成功率判定方向；方向与上次相同则 streak+1，否则重置为 1
 * - streak 达到 hysteresisSamples 时生效一次调整，随后清零重新累计
 */
export declare function recordAdaptiveSample(key: string, success: boolean, cfg?: AdaptiveParamsConfig): void;
/** 查询当前生效的自适应参数（无历史时返回默认值） */
export declare function getAdaptiveParams(key: string, cfg?: AdaptiveParamsConfig): AdaptiveParams;
//# sourceMappingURL=adaptive-params.d.ts.map