import type { ClearOutcome, HistoryDeps, HistoryEntry } from "./type.js";
/** 通知历史：jsonl 追加写，读时滚动截断与按天过滤。 */
declare class HistoryStore {
    /** 是否已装配；单例实例重复装配是编程错误，当场暴露。 */
    private installed;
    /** 落盘路径：DSH home 由环境决定、进程内不变，故随实例一次性定下。 */
    private readonly file;
    /** 装配入参（失败出口）。 */
    private deps;
    /** 写队列串行化：并发「读-改-写」会互相覆盖丢记录。 */
    private queue;
    /** 装配：单次生效。 */
    install(deps: HistoryDeps): void;
    /** 卸载：放开装配入参。在飞的写入不等待——它们各有自己的失败出口。 */
    release(): void;
    /**
     * 追加一条记录：入队即返回（不阻塞通知主流程），失败仅经日志出口告警。
     *
     * 经 `enqueue` 而不是直接 `this.queue = this.queue.then(...)`：直接赋值时排在本条之后的那次
     * 写会挂在一个可能被拒绝的 promise 上，一次失败就让此后每一条历史静默不写。与 clear 共用
     * 入队口，这条护栏就不必在两条写上各记得一次。
     */
    append(entry: HistoryEntry): void;
    /** 最近记录（尾部最多 `HISTORY_LIMIT` 条；保留期 > 0 时先按天过滤）。 */
    read(): Promise<HistoryEntry[]>;
    /**
     * 清空全部记录。**进写队列**（#1016 残留 1）。
     *
     * 为什么不进队列是一条真数据竞态，不只是顺序问题：清空在队列外时，一次在飞的 append 会
     * 「读旧行 → 追加新行 → 写回」，而清空恰好插在它读与写之间——清空把文件截空之后，那一次
     * append 用它读到的旧行把**整段旧记录原样写回**。用户看到「已清空 N 条」，刷新后记录全在。
     * 落进同一条队列后次序唯一：先到的 append 落完盘再清空，后到的 append 落在清空之后。
     *
     * 返回两态而不是条数：落盘失败必须让调用方**看得见**（返回裸条数时端点只能答 200，界面提示
     * 「已清空 N 条」而文件纹丝未动）。**本方法不抛错**——抛错经路由的失败出口转成 500，error
     * 字段是 Node 错误原文（带 errno 与绝对路径），与 issue #1016「errno/路径不外送」直接冲突。
     */
    clear(): Promise<ClearOutcome>;
    /**
     * 把一次写挂到队列尾。写法照抄 config 域的同名方法。
     *
     * 前两条是**同一道护栏的两个冗余机制**，各自都足以挡住「前一次抛错 ⇒ 此后每一条历史都静默不写」：
     * 1. `.then(task, task)`——两个分支都给同一个 task，前一次无论成败后一次都照常执行。
     * 2. `result.then(NOOP, NOOP)` 中和之后**赋回队列的才是它**，于是队列上永远不挂 rejected promise。
     *    append 的 task 自己 try/catch 住了；clear 的 task 若在兜底之外抛出（判据推翻了「绝不抛」的
     *    前提），接住那次抛出的是第 1 条——第 2 条在**当前这个双分支写法下并不是**「抛出后后续写被
     *    跳过」的原因，那个症状要退回单分支 `.then(task)` 才成立。
     *
     * **正因冗余，改掉任何一条单独看都判不出来**：实测单独去掉第 2 条全绿、单独退回单分支 `.then(task)`
     * 也全绿，**两条一起去掉**才红，且只红 `test/unit/stores/history.test.ts` 里「清空的 task 抛错后，
     * 紧随其后的 append 仍然落盘」那一条。这既是它们必须一起保留的理由（少一条时行为不变，但缓冲
     * 归零），也是那条判据只能断**性质**、断不了某一条写法的原因。
     *
     * 3. task 内**绝不再入队**：enqueue 同步把队列设成 `result.then(...)`，task 里再入队就是等自己
     *    刚挂上去的 tail，而那个 tail 排在自己后面，自己不返回它就不 resolve（死锁）。config 域为
     *    此把 apply 与 commit 之间的经队列路径在结构上写死，这里靠同一条纪律。
     */
    private enqueue;
    /** 现有行：读不到文件即空列表（首次写入从零开始，与读语义一致）。 */
    private currentLines;
}
/** 本域唯一的存储实例：类不外放，外面 `new` 不出第二份写队列。 */
export declare const historyStore: HistoryStore;
export {};