/** 检查点数据 */
export interface CheckpointData {
    /** 上次 L2 聚合时的 L1 条目总数 */
    lastL1Count: number;
    /** 上次 L3 生成时的 L2 条目总数 */
    lastL2Count: number;
    /** 最后执行时间（ISO 字符串） */
    lastRunAt: string;
    /** 累计执行次数 */
    runCount: number;
}
/**
 * 记忆管道检查点
 *
 * 用于管道调度器判断是否需要触发 L2/L3：
 * - 当 L1 增量（当前 - lastL1Count）达到阈值时触发 L2
 * - 当 L2 增量（当前 - lastL2Count）达到阈值时触发 L3
 */
export declare class MemoryCheckpoint {
    private filePath;
    private data;
    /**
     * @param filePath 检查点文件路径，默认为 {cwd}/data/memories/checkpoint.json
     */
    constructor(filePath?: string);
    /** 获取当前检查点数据 */
    get(): CheckpointData;
    /**
     * 判断是否应触发 L2 聚合
     * @param currentL1Count 当前 L1 条目总数
     * @param threshold L2 触发阈值
     */
    shouldTriggerL2(currentL1Count: number, threshold: number): boolean;
    /**
     * 判断是否应触发 L3 画像更新
     * @param currentL2Count 当前 L2 条目总数
     * @param threshold L3 触发阈值
     */
    shouldTriggerL3(currentL2Count: number, threshold: number): boolean;
    /**
     * 更新检查点（L2 聚合完成后调用）
     */
    updateL2(currentL1Count: number): void;
    /**
     * 更新检查点（L3 画像完成后调用）
     */
    updateL3(currentL2Count: number): void;
    /**
     * 重置检查点（用于手动触发全量重建）
     */
    reset(): void;
    private load;
    private persist;
}
/**
 * 获取全局检查点实例
 * @param filePath 可选，首次调用时指定自定义路径
 */
export declare function getMemoryCheckpoint(filePath?: string): MemoryCheckpoint;
/** 重置全局实例（用于测试或路径变更场景） */
export declare function resetMemoryCheckpoint(): void;
//# sourceMappingURL=checkpoint.d.ts.map