/** LocalGroupSessionDataStore：GroupSession 的 metadata 与消息 JSONL 存储。 */
import type { FileSystem } from "@downcity/workspace";
import type { GroupMessage } from "../../types/group/Group.js";
import type { GroupDispatchSessionDataStore } from "../../types/group/GroupDispatchSession.js";
import type { GroupSessionDataStore, GroupSessionHistoryMeta } from "../../types/group/GroupSessionStore.js";
/** 单个 GroupSession 的本地文件存储。 */
export declare class LocalGroupSessionDataStore implements GroupSessionDataStore {
    readonly session_id: string;
    readonly dispatch_session: GroupDispatchSessionDataStore;
    private readonly files;
    private readonly group_id;
    private readonly session_root_path;
    private readonly metadata_file_path;
    private readonly messages_file_path;
    private readonly transaction_lock_path;
    constructor(options: {
        /** 当前 Group StorageScope 文件能力。 */
        files: FileSystem;
        /** 当前 Group StorageScope 根路径。 */
        storage_root_path: string;
        /** 当前 GroupSession 标识。 */
        session_id: string;
        /** 所属 Group 标识。 */
        group_id: string;
    });
    /** 初始化当前 GroupSession 目录与 metadata。 */
    initialize(): Promise<void>;
    /** 读取完整共享消息历史。 */
    list_messages(): Promise<GroupMessage[]>;
    /** 追加一条消息并更新 metadata。 */
    append_message(message: GroupMessage): Promise<void>;
    /** 读取当前 metadata。 */
    read_metadata(): Promise<GroupSessionHistoryMeta>;
    /** 在调用方已经持有事务锁时读取 metadata。 */
    private read_metadata_unlocked;
    /** 原子写入当前 metadata。 */
    write_metadata(metadata: GroupSessionHistoryMeta): Promise<void>;
    /** 在调用方已经持有事务锁时写入 metadata。 */
    private write_metadata_unlocked;
    /** 在文件锁内合并 metadata，避免消息追加和成员映射互相覆盖。 */
    update_metadata(patch: Partial<GroupSessionHistoryMeta>): Promise<GroupSessionHistoryMeta>;
    /** 校验消息日志并由真实消息重建可恢复的摘要字段。 */
    private repair_metadata_unlocked;
    /** 读取 JSONL；仅允许自动修复文件尾部不完整的一行。 */
    private read_messages;
    private create_initial_metadata;
}
//# sourceMappingURL=LocalGroupSessionDataStore.d.ts.map