/**
 * Session 显式压缩操作生命周期。
 *
 * 该模块只负责把队列 Command 的异步执行映射为公开 Compact Handle；压缩计划、
 * canonical 历史提交与事件发布仍由 Session 领域拥有。
 */
import type { AgentSessionCompactHandle, AgentSessionCompactResult } from "../../types/sdk/AgentSessionCompact.js";
import type { SessionCompactHistory } from "../../types/session/SessionExecution.js";
/** 创建显式压缩操作所需的领域回调。 */
export interface CreateSessionCompactOperationOptions {
    /** 当前显式压缩请求的稳定标识。 */
    compact_id: string;
    /** 在 Session Queue 检查点执行统一历史压缩。 */
    run: () => ReturnType<SessionCompactHistory>;
    /** 发布最终 Compact Mutation；观测失败不能改变结果。 */
    publish_finish: (result: AgentSessionCompactResult) => void;
    /** 尽力记录未被压缩领域入口吸收的异常。 */
    log_error: (error_message: string) => Promise<void>;
}
/** 显式压缩操作暴露给 Session Queue 的内部能力。 */
export interface SessionCompactOperation {
    /** 立即返回给 SDK 调用方的等待句柄。 */
    handle: AgentSessionCompactHandle;
    /** 由排队的 Session Command 调用并负责最终兑现句柄。 */
    execute: () => Promise<void>;
}
/** 创建一个与单次 Session Compact Command 绑定的操作生命周期。 */
export declare function create_session_compact_operation(options: CreateSessionCompactOperationOptions): SessionCompactOperation;
//# sourceMappingURL=SessionCompactOperation.d.ts.map