/**
 * CoreEngine 模型消息运行态。
 *
 * 关键点（中文）
 * - CoreEngine 只维护本 Turn 后续模型 Step 需要的标准 ModelMessage。
 * - canonical SessionMessage 的持久化由 SessionMessages 独立拥有。
 */
import type { ModelMessage } from "@downcity/type";
import type { SessionUserMessage } from "../../types/session/SessionMessage.js";
/**
 * CoreEngine 单轮执行期间的消息基线。
 */
export declare class CoreEngineMessageState {
    /**
     * 当前模型侧消息基线。
     */
    private current_model_messages;
    /**
     * 当前项目根目录，用于解析历史中的相对路径 file part。
     */
    private readonly project_root?;
    private constructor();
    /**
     * 基于初始模型消息创建运行态。
     */
    static create(params: {
        /**
         * 初始标准模型消息。
         */
        messages: ModelMessage[];
        /**
         * 当前项目根目录。
         */
        project_root?: string;
    }): Promise<CoreEngineMessageState>;
    /**
     * 读取当前模型消息。
     */
    get model_messages(): ModelMessage[];
    /**
     * 把 Step 间新增的 canonical User Message 并入模型基线。
     */
    append_merged_user_messages(messages: SessionUserMessage[]): Promise<ModelMessage[]>;
    /**
     * 追加内部生成的 user nudge 消息。
     */
    append_user_message(message: SessionUserMessage): Promise<void>;
    /**
     * 追加 SDK 返回的模型 response messages。
     */
    append_model_messages(messages: ModelMessage[]): void;
    /**
     * 原子替换当前模型侧消息基线。
     *
     * 关键点（中文）：compact 只替换 Provider 后续可见的 ModelMessage，
     * Session 语义消息与持久化历史仍保持完整，等待 turn 收口后再单独归档。
     */
    replace_model_messages(messages: ModelMessage[]): void;
    /** 使用 Composer 重新生成的模型历史原子替换当前基线。 */
    replace_model_history(messages: ModelMessage[]): void;
    private append_session_messages;
}
//# sourceMappingURL=CoreEngineMessageState.d.ts.map