@downcity/agent 1.1.237 → 1.1.258

package/bin/session/runtime/SessionPromptRuntime.d.ts

@@ -1,112 +0,0 @@
-/**
- * SessionPromptRuntime：Session actor 模式下的最小 prompt 调度器。
- *
- * 关键点（中文）
- * - `prompt()` 是唯一输入入口，内部决定并入当前 turn 还是排到下一 turn。
- * - 不把调度逻辑塞进 Executor；Executor 继续只负责单次执行。
- * - 这里不暴露历史或消息模型，只编排 prompt 队列与 turn 生命周期。
- */
-import type { SessionUserMessageV1 } from "../../executor/types/SessionRecords.js";
-import type { SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
-import type { SessionMutation } from "../../types/session/SessionMutation.js";
-import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
-import type { SessionQueueCommand } from "../../types/session/SessionQueueCommand.js";
-import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
-/**
- * SessionPromptRuntime 构造参数。
- */
-export interface SessionPromptRuntimeOptions {
-    /**
-     * 当前 session 标识。
-     */
-    sessionId: string;
-    /**
-     * 广播 session 事件。
-     */
-    publish: (mutation: SessionMutation) => void;
-    /**
-     * 构造并持久化一条 user 消息。
-     */
-    createAndPersistUserMessage: (input: AgentSessionPromptInput, turn_id: string, input_type: "prompt" | "steer") => Promise<SessionUserMessageV1>;
-    /** 持久化一条用户可见的 turn 错误 Message。 */
-    appendErrorMessage: (input: {
-        /** 错误所属 turn。 */
-        turn_id: string;
-        /** 用户可见错误文本。 */
-        message: string;
-    }) => Promise<void>;
-    /**
-     * 执行单轮 turn。
-     */
-    executeTurn: (input: {
-        turnId: string;
-        promptInput: AgentSessionPromptInput;
-        onStepMerge: () => Promise<SessionUserMessageV1[]>;
-        abortSignal: AbortSignal;
-    }) => Promise<{
-        text: string;
-        success: boolean;
-        assistantMessage?: SessionMessageRecordV1 | null;
-        error?: string;
-    }>;
-    /**
-     * 请求底层执行器停止当前 run。
-     */
-    stopTurn: () => boolean;
-}
-/**
- * SessionPromptRuntime：最小 prompt 队列调度器。
- */
-export declare class SessionPromptRuntime {
-    private readonly sessionId;
-    private readonly publish;
-    private readonly createAndPersistUserMessage;
-    private readonly appendErrorMessage;
-    private readonly executeTurn;
-    private readonly stopTurn;
-    private readonly queue;
-    private processingPromise;
-    private activeTurn;
-    constructor(options: SessionPromptRuntimeOptions);
-    /**
-     * 追加一条新的 prompt。
-     */
-    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
-    /**
-     * 把一次已成功创建的 command 加入统一输入队列。
-     */
-    enqueue_command(command: SessionQueueCommand): void;
-    /**
-     * 判断是否存在等待并入下一 Session step 的 prompt。
-     */
-    has_pending_prompt(): boolean;
-    /**
-     * 判断是否存在等待在下一 Session step 检查点执行的 command。
-     */
-    has_pending_command(): boolean;
-    /**
-     * 返回当前 actor prompt 调度器是否仍处于活跃态。
-     *
-     * 说明（中文）
-     * - 只要还有排队 prompt，或处理循环尚未结束，就视为活跃。
-     * - Session 会用它阻止内部 direct execution 与 actor 模式并发混用。
-     */
-    isActive(): boolean;
-    /**
-     * 停止当前 turn，并取消尚未被吸收的排队 prompt。
-     */
-    stop(): AgentSessionStopResult;
-    private ensureProcessing;
-    private processLoop;
-    private cancelQueuedPrompts;
-    /**
-     * 在下一 Session step 检查点按入队顺序提交配置并持久化 steer。
-     */
-    private drain_queued_inputs;
-    /**
-     * 执行一组已经从统一队列截取的 command。
-     */
-    private execute_commands;
-}
-//# sourceMappingURL=SessionPromptRuntime.d.ts.map

package/bin/session/runtime/SessionPromptRuntime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionPromptRuntime.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionPromptRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAkEzC;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,2BAA2B,EAAE,CAC3B,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,QAAQ,GAAG,OAAO,KAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEnC,kCAAkC;IAClC,kBAAkB,EAAE,CAAC,KAAK,EAAE;QAC1B,iBAAiB;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,uBAAuB,CAAC;QACrC,WAAW,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACnD,WAAW,EAAE,WAAW,CAAC;KAC1B,KAAK,OAAO,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;QACjD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA6D;IACzG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoD;IACvF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6C;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,UAAU,CAAgC;gBAEtC,OAAO,EAAE,2BAA2B;IAYhD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAWvE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,IAAI,IAAI,sBAAsB;IAyB9B,OAAO,CAAC,gBAAgB;YAUV,WAAW;IA4GzB,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;YACW,mBAAmB;IAsCjC;;OAEG;YACW,gBAAgB;CAe/B"}

package/bin/session/runtime/SessionPromptRuntime.js

@@ -1,357 +0,0 @@
-/**
- * SessionPromptRuntime：Session actor 模式下的最小 prompt 调度器。
- *
- * 关键点（中文）
- * - `prompt()` 是唯一输入入口，内部决定并入当前 turn 还是排到下一 turn。
- * - 不把调度逻辑塞进 Executor；Executor 继续只负责单次执行。
- * - 这里不暴露历史或消息模型，只编排 prompt 队列与 turn 生命周期。
- */
-import { nanoid } from "nanoid";
-const TURN_STOPPED_MESSAGE = "Turn stopped";
-const QUEUED_PROMPT_CANCELLED_MESSAGE = "Prompt cancelled because session was stopped";
-/**
- * SessionPromptRuntime：最小 prompt 队列调度器。
- */
-export class SessionPromptRuntime {
-    sessionId;
-    publish;
-    createAndPersistUserMessage;
-    appendErrorMessage;
-    executeTurn;
-    stopTurn;
-    queue = [];
-    processingPromise = null;
-    activeTurn = null;
-    constructor(options) {
-        this.sessionId = String(options.sessionId || "").trim();
-        this.publish = options.publish;
-        this.createAndPersistUserMessage = options.createAndPersistUserMessage;
-        this.appendErrorMessage = options.appendErrorMessage;
-        this.executeTurn = options.executeTurn;
-        this.stopTurn = options.stopTurn;
-        if (!this.sessionId) {
-            throw new Error("SessionPromptRuntime requires a non-empty sessionId");
-        }
-    }
-    /**
-     * 追加一条新的 prompt。
-     */
-    prompt(input) {
-        const deferredHandle = createDeferred();
-        this.queue.push({
-            type: "prompt",
-            input,
-            deferredHandle,
-        });
-        this.ensureProcessing();
-        return deferredHandle.promise;
-    }
-    /**
-     * 把一次已成功创建的 command 加入统一输入队列。
-     */
-    enqueue_command(command) {
-        this.queue.push(command);
-    }
-    /**
-     * 判断是否存在等待并入下一 Session step 的 prompt。
-     */
-    has_pending_prompt() {
-        return this.queue.some((item) => item.type === "prompt");
-    }
-    /**
-     * 判断是否存在等待在下一 Session step 检查点执行的 command。
-     */
-    has_pending_command() {
-        return this.queue.some((item) => item.type === "command");
-    }
-    /**
-     * 返回当前 actor prompt 调度器是否仍处于活跃态。
-     *
-     * 说明（中文）
-     * - 只要还有排队 prompt，或处理循环尚未结束，就视为活跃。
-     * - Session 会用它阻止内部 direct execution 与 actor 模式并发混用。
-     */
-    isActive() {
-        return this.processingPromise !== null || this.has_pending_prompt();
-    }
-    /**
-     * 停止当前 turn，并取消尚未被吸收的排队 prompt。
-     */
-    stop() {
-        const active_turn = this.activeTurn;
-        const cancelled_queued_prompts = this.cancelQueuedPrompts();
-        let executor_stop_requested = false;
-        if (active_turn) {
-            if (!active_turn.abortController.signal.aborted) {
-                active_turn.abortController.abort(new Error(TURN_STOPPED_MESSAGE));
-            }
-            executor_stop_requested = this.stopTurn();
-        }
-        const stopped = Boolean(active_turn ||
-            executor_stop_requested ||
-            cancelled_queued_prompts > 0);
-        return {
-            stopped,
-            ...(active_turn ? { turnId: active_turn.turnId } : {}),
-            cancelledQueuedPrompts: cancelled_queued_prompts,
-            reason: stopped ? "stopped" : "idle",
-        };
-    }
-    ensureProcessing() {
-        if (this.processingPromise)
-            return;
-        this.processingPromise = this.processLoop().finally(() => {
-            this.processingPromise = null;
-            if (this.has_pending_prompt()) {
-                this.ensureProcessing();
-            }
-        });
-    }
-    async processLoop() {
-        while (this.has_pending_prompt()) {
-            const prompt_index = this.queue.findIndex((item) => item.type === "prompt");
-            if (prompt_index < 0)
-                break;
-            const queued_before_prompt = this.queue.splice(0, prompt_index);
-            const current = this.queue.shift();
-            if (!current || current.type !== "prompt")
-                break;
-            const turnId = `turn:${this.sessionId}:${Date.now()}:${nanoid(6)}`;
-            const activeTurn = createActiveTurnState(turnId);
-            this.activeTurn = activeTurn;
-            this.publish({
-                mutation_id: nanoid(),
-                variant: "turn",
-                type: "start",
-                session_id: this.sessionId,
-                turn_id: turnId,
-                status: "running",
-                created_at: Date.now(),
-            });
-            current.deferredHandle.resolve(createTurnHandle(activeTurn));
-            try {
-                await this.execute_commands(queued_before_prompt.filter((item) => item.type === "command"), activeTurn);
-                await this.createAndPersistUserMessage(current.input, turnId, "prompt");
-                const result = await this.executeTurn({
-                    turnId,
-                    promptInput: current.input,
-                    onStepMerge: async () => {
-                        return await this.drain_queued_inputs(activeTurn);
-                    },
-                    abortSignal: activeTurn.abortController.signal,
-                });
-                const stopped = activeTurn.abortController.signal.aborted;
-                const finalResult = {
-                    turnId,
-                    text: result.text,
-                    success: stopped ? false : result.success,
-                    ...(result.assistantMessage
-                        ? { assistantMessage: result.assistantMessage }
-                        : {}),
-                    ...(stopped
-                        ? { error: TURN_STOPPED_MESSAGE }
-                        : result.error ? { error: result.error } : {}),
-                };
-                activeTurn.result = finalResult;
-                this.publish({
-                    mutation_id: nanoid(),
-                    variant: "turn",
-                    type: "finish",
-                    session_id: this.sessionId,
-                    turn_id: turnId,
-                    status: stopped ? "stopped" : finalResult.success ? "completed" : "failed",
-                    created_at: Date.now(),
-                    text: finalResult.text,
-                    ...(finalResult.error ? { error: finalResult.error } : {}),
-                });
-                activeTurn.deferredFinished.resolve(finalResult);
-            }
-            catch (error) {
-                const message = activeTurn.abortController.signal.aborted
-                    ? TURN_STOPPED_MESSAGE
-                    : error instanceof Error ? error.message : String(error);
-                const finalResult = {
-                    turnId,
-                    text: "",
-                    success: false,
-                    assistantMessage: buildPromptRuntimeErrorAssistantMessage({
-                        sessionId: this.sessionId,
-                        message,
-                    }),
-                    error: message,
-                };
-                activeTurn.result = finalResult;
-                if (message !== TURN_STOPPED_MESSAGE) {
-                    try {
-                        await this.appendErrorMessage({
-                            turn_id: turnId,
-                            message,
-                        });
-                    }
-                    catch {
-                        // Error Message 写入失败不能阻止 turn handle 收口。
-                    }
-                }
-                this.publish({
-                    mutation_id: nanoid(),
-                    variant: "turn",
-                    type: "finish",
-                    session_id: this.sessionId,
-                    turn_id: turnId,
-                    status: activeTurn.abortController.signal.aborted ? "stopped" : "failed",
-                    created_at: Date.now(),
-                    text: "",
-                    error: message,
-                });
-                activeTurn.deferredFinished.resolve(finalResult);
-            }
-            finally {
-                if (this.activeTurn === activeTurn) {
-                    this.activeTurn = null;
-                }
-            }
-        }
-    }
-    cancelQueuedPrompts() {
-        const cancelled = this.queue.filter((item) => item.type === "prompt");
-        if (cancelled.length <= 0)
-            return 0;
-        const retained = this.queue.filter((item) => item.type === "command");
-        this.queue.splice(0, this.queue.length, ...retained);
-        for (const item of cancelled) {
-            const turnId = `turn:${this.sessionId}:cancelled:${Date.now()}:${nanoid(6)}`;
-            const cancelledTurn = createActiveTurnState(turnId);
-            const finalResult = {
-                turnId,
-                text: "",
-                success: false,
-                assistantMessage: buildPromptRuntimeErrorAssistantMessage({
-                    sessionId: this.sessionId,
-                    message: QUEUED_PROMPT_CANCELLED_MESSAGE,
-                }),
-                error: QUEUED_PROMPT_CANCELLED_MESSAGE,
-            };
-            cancelledTurn.result = finalResult;
-            cancelledTurn.deferredFinished.resolve(finalResult);
-            this.publish({
-                mutation_id: nanoid(),
-                variant: "turn",
-                type: "start",
-                session_id: this.sessionId,
-                turn_id: turnId,
-                status: "running",
-                created_at: Date.now(),
-            });
-            this.publish({
-                mutation_id: nanoid(),
-                variant: "turn",
-                type: "finish",
-                session_id: this.sessionId,
-                turn_id: turnId,
-                status: "failed",
-                created_at: Date.now(),
-                text: "",
-                error: QUEUED_PROMPT_CANCELLED_MESSAGE,
-            });
-            item.deferredHandle.resolve(createTurnHandle(cancelledTurn));
-        }
-        return cancelled.length;
-    }
-    /**
-     * 在下一 Session step 检查点按入队顺序提交配置并持久化 steer。
-     */
-    async drain_queued_inputs(activeTurn) {
-        if (this.queue.length <= 0)
-            return [];
-        const drained = this.queue.splice(0, this.queue.length);
-        const merged = [];
-        for (let index = 0; index < drained.length; index += 1) {
-            const item = drained[index];
-            if (item.type === "command") {
-                try {
-                    await item.execute({
-                        turn_id: activeTurn.turnId,
-                    });
-                }
-                catch {
-                    // command 自己负责失败观测；单条失败不能吞掉后续 steer 或 command。
-                }
-                continue;
-            }
-            try {
-                const message = await this.createAndPersistUserMessage(item.input, activeTurn.turnId, "steer");
-                item.deferredHandle.resolve(createTurnHandle(activeTurn));
-                merged.push(message);
-            }
-            catch {
-                // 关键点（中文）：若某条消息持久化失败，把未处理部分重新放回队列头部，避免静默丢失。
-                const remaining = drained.slice(index);
-                this.queue.unshift(...remaining);
-                break;
-            }
-        }
-        return merged;
-    }
-    /**
-     * 执行一组已经从统一队列截取的 command。
-     */
-    async execute_commands(commands, active_turn) {
-        if (commands.length <= 0)
-            return;
-        for (const command of commands) {
-            try {
-                await command.execute({
-                    turn_id: active_turn.turnId,
-                });
-            }
-            catch {
-                // command 自己负责失败观测；单条失败不能阻断当前 prompt。
-            }
-        }
-    }
-}
-function buildPromptRuntimeErrorAssistantMessage(input) {
-    return {
-        id: `a:${input.sessionId}:${Date.now()}:${nanoid(6)}`,
-        role: "assistant",
-        metadata: {
-            v: 1,
-            ts: Date.now(),
-            sessionId: input.sessionId,
-            source: "egress",
-            kind: "normal",
-            extra: {
-                note: "session_prompt_runtime_error",
-            },
-        },
-        parts: [{ type: "text", text: input.message }],
-    };
-}
-function createDeferred() {
-    let resolve;
-    const promise = new Promise((innerResolve) => {
-        resolve = innerResolve;
-    });
-    return {
-        promise,
-        resolve,
-    };
-}
-function createActiveTurnState(turnId) {
-    return {
-        turnId,
-        result: null,
-        deferredFinished: createDeferred(),
-        abortController: new AbortController(),
-    };
-}
-function createTurnHandle(activeTurn) {
-    return {
-        id: activeTurn.turnId,
-        get result() {
-            return activeTurn.result;
-        },
-        finished: activeTurn.deferredFinished.promise,
-    };
-}
-//# sourceMappingURL=SessionPromptRuntime.js.map

package/bin/session/runtime/SessionPromptRuntime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionPromptRuntime.js","sourceRoot":"","sources":["../../../src/session/runtime/SessionPromptRuntime.ts"],"names":[],"mappings":"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"}

package/bin/session/services/SessionStateService.d.ts

@@ -1,187 +0,0 @@
-/**
- * SessionStateService：本地 Session 状态与持久化服务。
- *
- * 关键点（中文）
- * - 统一管理本地 Session 的初始化、配置、标题、metadata 与消息持久化。
- * - 该服务只关心状态事实源与持久化副作用，不负责 turn 编排。
- * - `Session` facade 与 turn/view service 都通过它访问可变 session 运行态。
- */
-import type { Executor } from "../../executor/Executor.js";
-import type { SessionHistoryStore } from "../../executor/store/history/SessionHistoryStore.js";
-import type { AgentSessionConfigSnapshot, AgentSessionSetInput } from "../../types/agent/SessionTypes.js";
-import type { SessionMutation } from "../../types/session/SessionMutation.js";
-import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
-import type { SessionActionRecordInputV1, SessionActionRecordV1, SessionRecordV1, SessionMessageRecordV1, SessionUserMessageV1 } from "../../executor/types/SessionRecords.js";
-import type { SessionLocalState } from "../../types/session/SessionLocalState.js";
-import type { SessionQueueCommand } from "../../types/session/SessionQueueCommand.js";
-import type { Logger } from "../../utils/logger/Logger.js";
-import type { AgentModel } from "../../model/CityModelAdapter.js";
-import { SessionRecorder } from "../../session/recorder/SessionRecorder.js";
-type SessionStateServiceOptions = {
-    /**
-     * 当前 agent 稳定标识。
-     */
-    agent_id: string;
-    /**
-     * 当前项目根目录。
-     */
-    project_root: string;
-    /**
-     * 当前 session 标识。
-     */
-    session_id: string;
-    /**
-     * 当前 session 历史事实源。
-     */
-    history_store: SessionHistoryStore;
-    /** 当前 Session Message Recorder。 */
-    recorder: SessionRecorder;
-    /**
-     * 当前 session 执行器。
-     */
-    executor: Executor;
-    /**
-     * 当前 session 可变运行态。
-     */
-    state: SessionLocalState;
-    /**
-     * 当前 session 运行日志器。
-     */
-    logger: Logger;
-    /**
-     * 在执行前补齐宿主级配置。
-     */
-    ensure_configured_hook?: () => Promise<void>;
-    /** 按稳定 ID 解析当前 Session 的运行时模型。 */
-    resolve_model?: (model_id: string) => Promise<AgentModel>;
-    /**
-     * 发布 session 事件。
-     */
-    publish_event: (mutation: SessionMutation) => void;
-};
-type SessionSetOptions = {
-    /**
-     * 是否写入并发布 model-switching action。
-     *
-     * 说明（中文）
-     * - 公开 `session.set()` 应保持默认开启。
-     * - fork 内部复制模型配置时关闭，避免污染 forked session 历史。
-     */
-    emit_action?: boolean;
-};
-type EmitActionInput = SessionActionRecordInputV1 | SessionActionRecordV1;
-/**
- * Session 配置成功写入后的队列提交结果。
- */
-export interface SessionConfiguredCommandResult {
-    /**
-     * 等待在下一 Session step 检查点执行的 command。
-     *
-     * 说明（中文）
-     * - 输入未产生实际配置变化时为空。
-     * - fork 等内部初始化路径可以选择立即提交而不返回 command。
-     */
-    command?: SessionQueueCommand;
-}
-/**
- * 本地 Session 状态与持久化服务。
- */
-export declare class SessionStateService {
-    private readonly agent_id;
-    private readonly project_root;
-    private readonly session_id;
-    private readonly history_store;
-    private readonly recorder;
-    private readonly executor;
-    private readonly state;
-    private readonly logger;
-    private readonly ensure_configured_hook?;
-    private readonly resolve_model?;
-    private readonly publish_event;
-    constructor(options: SessionStateServiceOptions);
-    /**
-     * 读取当前 session 配置快照。
-     */
-    get_config(): AgentSessionConfigSnapshot;
-    /**
-     * 读取当前 session 创建时间。
-     */
-    get_created_at(): number;
-    /**
-     * 读取当前 session 参考时区。
-     */
-    get_timezone(): string;
-    /**
-     * 初始化当前 session metadata 与内存快照。
-     */
-    initialize(): Promise<void>;
-    /**
-     * 在执行前确保当前 session 已完成初始化与宿主装配。
-     */
-    ensure_ready_for_execution(): Promise<void>;
-    /**
-     * 在 prompt 执行前确保当前 session 已可运行。
-     */
-    ensure_runnable(): Promise<void>;
-    /**
-     * 写入当前 session 配置。
-     */
-    set(input: AgentSessionSetInput, options?: SessionSetOptions): Promise<SessionConfiguredCommandResult>;
-    /** 恢复 metadata 中持久化的模型覆盖。 */
-    private restore_persisted_model;
-    /** 使用宿主 resolver 解析稳定模型 ID。 */
-    private resolve_model_by_id;
-    /**
-     * 追加一条 user 消息并刷新标题与 metadata。
-     */
-    append_user_message(params: {
-        message?: SessionRecordV1 | null;
-        text?: string;
-    }): Promise<void>;
-    /**
-     * 追加一条 assistant 消息并刷新 metadata。
-     */
-    append_assistant_message(params: {
-        message?: SessionRecordV1 | null;
-        fallbackText?: string;
-    }): Promise<void>;
-    /**
-     * 仅刷新当前 session metadata。
-     */
-    touch_metadata(): Promise<void>;
-    /**
-     * 确保当前 session 已持久化 title。
-     */
-    ensure_title_from_history(input?: {
-        /**
-         * 是否允许调用模型生成标题。
-         */
-        generate?: boolean;
-    }): Promise<void>;
-    /**
-     * 持久化最终 assistant 结果。
-     */
-    persist_assistant_result(assistant_message?: SessionMessageRecordV1 | null): Promise<void>;
-    /**
-     * 持久化一条 action record。
-     */
-    persist_action_event(event: SessionActionRecordV1): Promise<void>;
-    /**
-     * 写入并发布一条 action。
-     */
-    emit_action_event(input: EmitActionInput): Promise<void>;
-    /**
-     * 尽力写入配置生效 action，不让 timeline 故障改变 effective state。
-     */
-    emit_config_action_event(input: EmitActionInput): Promise<boolean>;
-    /**
-     * 构造并持久化一条 prompt user 消息。
-     */
-    create_and_persist_user_prompt_message(input: AgentSessionPromptInput, turn_id: string, input_type?: "prompt" | "steer"): Promise<SessionUserMessageV1>;
-    /**
-     * 持久化本轮执行期间延迟写入的 user 消息。
-     */
-    persist_deferred_user_messages(deferred_messages?: SessionUserMessageV1[]): Promise<void>;
-}
-export {};
-//# sourceMappingURL=SessionStateService.d.ts.map