@downcity/agent 1.1.287 → 1.1.310

package/bin/session/SessionLoop.js

@@ -0,0 +1,554 @@
+/**
+ * SessionLoop：Session Command Queue 的唯一消费者与 Turn 生命周期所有者。
+ *
+ * 关键点（中文）
+ * - Prompt 会先构造成 Session Command，再由统一 FIFO 决定进入当前或下一 Turn。
+ * - 不把调度逻辑塞进 Executor；Executor 继续只负责单次执行。
+ * - Queue 由 Session 持有；这里不解释配置种类，只执行出队 Command。
+ */
+import { nanoid } from "nanoid";
+import { extract_text_from_parts } from "../executor/messages/UIMessageTransformer.js";
+import { is_agent_session_prompt_input_empty } from "../types/sdk/AgentSessionPrompt.js";
+import { create_session_turn_context } from "../session/runtime/SessionTurnContext.js";
+import { SessionAssistantOutputAdapter } from "../session/execution/SessionAssistantOutputAdapter.js";
+import { SessionCommand } from "../session/SessionCommand.js";
+const TURN_STOPPED_MESSAGE = "Turn stopped";
+const QUEUED_PROMPT_CANCELLED_MESSAGE = "Prompt cancelled because session was stopped";
+/**
+ * Session 输入队列与 Turn 编排器。
+ */
+export class SessionLoop {
+    session_id;
+    workspace_path;
+    executor;
+    compact_history_handler;
+    state;
+    messages;
+    events;
+    logger;
+    interactions;
+    shell_approval_gateway;
+    queue;
+    pending_prompt_count = 0;
+    processing_promise = null;
+    active_turn = null;
+    checkpoint_merged_messages = null;
+    constructor(options) {
+        this.session_id = String(options.session_id || "").trim();
+        this.workspace_path = String(options.workspace_path || "").trim();
+        this.executor = options.executor;
+        this.compact_history_handler = options.compact_history;
+        this.state = options.state;
+        this.messages = options.messages;
+        this.events = options.events;
+        this.logger = options.logger;
+        this.queue = options.queue;
+        this.interactions = options.interactions;
+        this.shell_approval_gateway = options.shell_approval_gateway;
+        if (!this.session_id) {
+            throw new Error("SessionLoop requires a non-empty session_id");
+        }
+        if (!this.workspace_path) {
+            throw new Error("SessionLoop requires a non-empty workspace_path");
+        }
+    }
+    /**
+     * 追加一条新的 prompt。
+     */
+    async prompt(input) {
+        if (is_agent_session_prompt_input_empty(input)) {
+            throw new Error("session.prompt requires a non-empty query");
+        }
+        await this.state.ensure_runnable();
+        const deferred_handle = create_deferred();
+        this.pending_prompt_count += 1;
+        this.queue.enqueue_command(new SessionCommand({
+            execute: async () => {
+                await this.execute_prompt_command(input, deferred_handle);
+            },
+            cancel: () => {
+                this.pending_prompt_count = Math.max(0, this.pending_prompt_count - 1);
+                this.resolve_cancelled_prompt(deferred_handle);
+            },
+        }));
+        this.ensure_processing();
+        return await deferred_handle.promise;
+    }
+    /**
+     * 判断是否存在等待并入下一 Session step 的 prompt。
+     */
+    has_pending_prompt() {
+        return this.pending_prompt_count > 0;
+    }
+    /**
+     * 判断是否存在等待在下一 Session step 检查点执行的 command。
+     */
+    has_pending_command() {
+        return this.queue.has_command();
+    }
+    /** 返回当前正在消费 Session Command 的 Turn 标识。 */
+    get_active_turn_id() {
+        return this.require_active_turn().turn_id;
+    }
+    /** 返回当前 Active Turn 标识；Session 空闲时返回 undefined。 */
+    current_turn_id() {
+        return this.active_turn?.turn_id;
+    }
+    /**
+     * 返回当前 actor prompt 调度器是否仍处于活跃态。
+     *
+     * 说明（中文）
+     * - 只要还有排队 prompt，或处理循环尚未结束，就视为活跃。
+     * - Session 会用它阻止内部 direct execution 与 actor 模式并发混用。
+     */
+    is_active() {
+        return this.processing_promise !== null || this.has_pending_prompt();
+    }
+    /**
+     * 停止当前 turn，并取消尚未被吸收的排队 prompt。
+     */
+    async stop() {
+        const active_turn = this.active_turn;
+        const cancelled_queued_prompts = this.cancel_queued_prompts();
+        active_turn?.turn_context?.lifecycle.abort(new Error(TURN_STOPPED_MESSAGE));
+        await this.interactions.cancel_all("turn_stopped");
+        const stopped = Boolean(active_turn ||
+            cancelled_queued_prompts > 0);
+        return {
+            stopped,
+            ...(active_turn ? { turn_id: active_turn.turn_id } : {}),
+            cancelled_queued_prompts: cancelled_queued_prompts,
+            reason: stopped ? "stopped" : "idle",
+        };
+    }
+    ensure_processing() {
+        if (this.processing_promise)
+            return;
+        this.processing_promise = this.process_loop().finally(() => {
+            this.processing_promise = null;
+            if (this.has_pending_prompt()) {
+                this.ensure_processing();
+            }
+        });
+    }
+    async process_loop() {
+        while (this.has_pending_prompt()) {
+            const turn_id = `turn:${this.session_id}:${Date.now()}:${nanoid(6)}`;
+            const active_turn = create_active_session_turn_state(turn_id);
+            this.active_turn = active_turn;
+            active_turn.turn_context = this.create_turn_context(active_turn);
+            this.events.publish({
+                mutation_id: nanoid(),
+                variant: "turn",
+                type: "start",
+                session_id: this.session_id,
+                turn_id,
+                status: "running",
+                created_at: Date.now(),
+            });
+            while (this.active_turn === active_turn) {
+                const command = this.queue.take_next();
+                if (!command) {
+                    await this.fail_active_turn(active_turn, new Error("Session Queue lost its pending Prompt Command"));
+                    break;
+                }
+                try {
+                    await this.execute_command(command);
+                }
+                catch (error) {
+                    await this.fail_active_turn(active_turn, error);
+                }
+            }
+        }
+    }
+    cancel_queued_prompts() {
+        return this.queue.cancel();
+    }
+    /**
+     * 在下一 Session step 检查点按入队顺序提交配置并持久化 steer。
+     */
+    async drain_queued_inputs(active_turn) {
+        const drained = this.queue.drain();
+        if (drained.length <= 0)
+            return [];
+        const merged = [];
+        this.checkpoint_merged_messages = merged;
+        try {
+            for (let index = 0; index < drained.length; index += 1) {
+                const command = drained[index];
+                try {
+                    await this.execute_command(command);
+                }
+                catch {
+                    // Prompt 持久化失败时恢复尚未处理的对象；Action 自己负责失败观测。
+                    this.queue.restore_front(drained.slice(index));
+                    break;
+                }
+            }
+        }
+        finally {
+            this.checkpoint_merged_messages = null;
+        }
+        return merged;
+    }
+    /** 执行 Command，并尽力持久化其声明的 canonical 完成信息。 */
+    async execute_command(command) {
+        const completion = await command.execute();
+        if (!completion)
+            return;
+        await this.persist_command_completion(completion);
+    }
+    /** 持久化 Command 完成信息；观测失败不能反向改变已经提交的领域状态。 */
+    async persist_command_completion(completion) {
+        const turn_id = this.require_active_turn().turn_id;
+        try {
+            await this.persist_action_event({
+                type: "action",
+                id: completion.id,
+                title: completion.title,
+                ...(completion.description
+                    ? { description: completion.description }
+                    : {}),
+                state: "completed",
+                metadata: {
+                    v: 1,
+                    ts: Date.now(),
+                    session_id: this.session_id,
+                    turn_id,
+                },
+            });
+        }
+        catch (error) {
+            try {
+                await this.logger.log("warn", "[agent] command completion persistence failed", {
+                    session_id: this.session_id,
+                    command_id: completion.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            catch {
+                // 领域状态已经提交，日志失败同样不能反向改变 Command 结果。
+            }
+        }
+    }
+    /** 在当前 Turn 上执行一次显式历史压缩。 */
+    async compact_history(compact_id) {
+        const turn_id = this.require_active_turn().turn_id;
+        const result = await this.compact_history_handler({ turn_id });
+        if (result.compacted &&
+            this.active_turn?.turn_context) {
+            this.require_active_turn().history_reload_requested = true;
+        }
+        if (result.reason === "nothing_to_compact") {
+            try {
+                await this.persist_action_event({
+                    type: "action",
+                    id: compact_id,
+                    title: "Session messages already compact",
+                    description: "The Session has no active messages to compact.",
+                    state: "completed",
+                    metadata: {
+                        v: 1,
+                        ts: Date.now(),
+                        session_id: this.session_id,
+                        turn_id: turn_id,
+                    },
+                });
+            }
+            catch (error) {
+                try {
+                    await this.logger.log("warn", "[agent] compact result persistence failed", {
+                        session_id: this.session_id,
+                        compact_id,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+                catch {
+                    // 领域结果已经确定，Action 与日志失败都不能把成功压缩改写为失败。
+                }
+            }
+        }
+        return result;
+    }
+    /** 执行一个出队 Prompt；首条 Prompt 启动 Turn，后续 Prompt 作为 steer 合并。 */
+    async execute_prompt_command(input, deferred_handle) {
+        const active_turn = this.require_active_turn();
+        if (active_turn.prompt_started) {
+            const message = await this.persist_prompt_message(input, active_turn.turn_id, "steer");
+            this.pending_prompt_count = Math.max(0, this.pending_prompt_count - 1);
+            deferred_handle.resolve(create_turn_handle(active_turn));
+            this.checkpoint_merged_messages?.push(message);
+            return;
+        }
+        active_turn.prompt_started = true;
+        this.pending_prompt_count = Math.max(0, this.pending_prompt_count - 1);
+        deferred_handle.resolve(create_turn_handle(active_turn));
+        try {
+            await this.persist_prompt_message(input, active_turn.turn_id, "prompt");
+            const result = await this.execute_prompt_turn({
+                active_turn,
+                prompt_input: input,
+            });
+            await this.finish_active_turn(active_turn, result);
+        }
+        catch (error) {
+            await this.fail_active_turn(active_turn, error);
+        }
+    }
+    /** 读取当前正在消费 Session Command 的 Active Turn。 */
+    require_active_turn() {
+        if (this.active_turn)
+            return this.active_turn;
+        throw new Error("Session Command requires an active Turn");
+    }
+    /** 用 Executor 结果结束当前 Active Turn。 */
+    async finish_active_turn(active_turn, result) {
+        const stopped = active_turn.turn_context?.lifecycle.abort_signal.aborted === true;
+        const final_result = {
+            turn_id: active_turn.turn_id,
+            text: result.text,
+            success: stopped ? false : result.success,
+            ...(stopped
+                ? { error: TURN_STOPPED_MESSAGE }
+                : result.error ? { error: result.error } : {}),
+        };
+        active_turn.result = final_result;
+        this.events.publish({
+            mutation_id: nanoid(),
+            variant: "turn",
+            type: "finish",
+            session_id: this.session_id,
+            turn_id: active_turn.turn_id,
+            status: stopped ? "stopped" : final_result.success ? "completed" : "failed",
+            created_at: Date.now(),
+            text: final_result.text,
+            ...(final_result.error ? { error: final_result.error } : {}),
+        });
+        await this.dispose_turn_context(active_turn);
+        active_turn.deferred_finished.resolve(final_result);
+        if (this.active_turn === active_turn)
+            this.active_turn = null;
+    }
+    /** 以失败结果结束当前 Active Turn，并尽力持久化 Error Message。 */
+    async fail_active_turn(active_turn, error) {
+        if (active_turn.result)
+            return;
+        const stopped = active_turn.turn_context?.lifecycle.abort_signal.aborted === true;
+        const message = stopped
+            ? TURN_STOPPED_MESSAGE
+            : error instanceof Error ? error.message : String(error);
+        const final_result = {
+            turn_id: active_turn.turn_id,
+            text: "",
+            success: false,
+            error: message,
+        };
+        active_turn.result = final_result;
+        if (message !== TURN_STOPPED_MESSAGE) {
+            try {
+                await this.messages.append_error_message({
+                    scope: "turn",
+                    turn_id: active_turn.turn_id,
+                    code: "turn_execution_failed",
+                    message,
+                    recoverable: true,
+                });
+            }
+            catch {
+                // Error Message 写入失败不能阻止 Turn Handle 收口。
+            }
+        }
+        this.events.publish({
+            mutation_id: nanoid(),
+            variant: "turn",
+            type: "finish",
+            session_id: this.session_id,
+            turn_id: active_turn.turn_id,
+            status: stopped ? "stopped" : "failed",
+            created_at: Date.now(),
+            text: "",
+            error: message,
+        });
+        await this.dispose_turn_context(active_turn);
+        active_turn.deferred_finished.resolve(final_result);
+        if (this.active_turn === active_turn)
+            this.active_turn = null;
+    }
+    /** 为一条尚未执行的 Prompt 创建可观测取消结果。 */
+    resolve_cancelled_prompt(deferred_handle) {
+        const turn_id = `turn:${this.session_id}:cancelled:${Date.now()}:${nanoid(6)}`;
+        const cancelled_turn = create_active_session_turn_state(turn_id);
+        const final_result = {
+            turn_id,
+            text: "",
+            success: false,
+            error: QUEUED_PROMPT_CANCELLED_MESSAGE,
+        };
+        cancelled_turn.result = final_result;
+        cancelled_turn.deferred_finished.resolve(final_result);
+        this.events.publish({
+            mutation_id: nanoid(),
+            variant: "turn",
+            type: "start",
+            session_id: this.session_id,
+            turn_id,
+            status: "running",
+            created_at: Date.now(),
+        });
+        this.events.publish({
+            mutation_id: nanoid(),
+            variant: "turn",
+            type: "finish",
+            session_id: this.session_id,
+            turn_id,
+            status: "failed",
+            created_at: Date.now(),
+            text: "",
+            error: QUEUED_PROMPT_CANCELLED_MESSAGE,
+        });
+        deferred_handle.resolve(create_turn_handle(cancelled_turn));
+    }
+    /** 执行一个 Turn 内的模型与 Tool Step Loop。 */
+    async execute_prompt_turn(input) {
+        const turn_context = input.active_turn.turn_context;
+        const assistant_output = turn_context?.output.assistant;
+        if (!turn_context || !assistant_output) {
+            throw new Error("Active Session Turn requires an initialized context");
+        }
+        const query = input.prompt_input.query;
+        const executor_query = typeof query === "string"
+            ? query
+            : extract_text_from_parts(query);
+        let result;
+        result = await this.executor.execute({
+            query: executor_query,
+            turn_context,
+        });
+        await assistant_output.finish({
+            status: turn_context.lifecycle.abort_signal.aborted
+                ? "stopped"
+                : result.success
+                    ? "completed"
+                    : "failed",
+            ...(result.error ? { error: result.error } : {}),
+        });
+        if (!result.success && !turn_context.lifecycle.abort_signal.aborted && result.error) {
+            await this.messages.append_error_message({
+                scope: "turn",
+                turn_id: input.active_turn.turn_id,
+                code: "turn_execution_failed",
+                message: result.error,
+                recoverable: true,
+            });
+        }
+        await this.state.touch_metadata();
+        const deferred_count = await this.messages.append_deferred_user_messages(result.deferred_persisted_user_messages);
+        if (deferred_count > 0)
+            await this.state.touch_metadata();
+        if (result.compact_required) {
+            await this.compact_history_handler({
+                turn_id: input.active_turn.turn_id,
+            });
+        }
+        return {
+            text: result.text,
+            success: result.success,
+            ...(result.error ? { error: result.error } : {}),
+        };
+    }
+    /** 在 Turn 创建时建立其唯一执行上下文和 Assistant 输出端口。 */
+    create_turn_context(active_turn) {
+        const assistant_output = new SessionAssistantOutputAdapter({
+            turn_id: active_turn.turn_id,
+            messages: this.messages,
+        });
+        return create_session_turn_context({
+            turn_id: active_turn.turn_id,
+            session_id: this.session_id,
+            project_root: this.workspace_path,
+            merge_step_input: async () => {
+                const merged = await this.drain_queued_inputs(active_turn);
+                if (merged.length > 0)
+                    await assistant_output.close_current_message();
+                return merged;
+            },
+            has_pending_step_input: () => this.has_pending_prompt(),
+            consume_history_reload: () => {
+                const requested = active_turn.history_reload_requested;
+                active_turn.history_reload_requested = false;
+                return requested;
+            },
+            assistant_output,
+            shell_approval_gateway: this.shell_approval_gateway,
+            interactions: this.interactions,
+            publish_action: async (event) => {
+                await this.persist_action_event(event);
+            },
+        });
+    }
+    /** 持久化本轮 User 输入，并同步刷新标题与 metadata。 */
+    async persist_prompt_message(prompt, turn_id, input_type) {
+        const message = await this.messages.append_prompt_message({
+            project_root: this.workspace_path,
+            prompt,
+            turn_id,
+            input_type,
+        });
+        await this.state.ensure_title_from_history({ generate: true });
+        await this.state.touch_metadata();
+        return message;
+    }
+    /** 持久化 Executor Action，并同步刷新 Session metadata。 */
+    async persist_action_event(event) {
+        await this.messages.persist_action_record(event);
+        await this.state.touch_metadata();
+    }
+    /** 由 Turn 生命周期所有者尽力释放其唯一 Context。 */
+    async dispose_turn_context(active_turn) {
+        try {
+            await active_turn.turn_context?.lifecycle.dispose();
+        }
+        catch (error) {
+            try {
+                await this.logger.log("warn", "[agent] turn context disposal failed", {
+                    session_id: this.session_id,
+                    turn_id: active_turn.turn_id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            catch {
+                // Context 已进入释放流程，日志失败不能阻止 Turn Handle 收口。
+            }
+        }
+    }
+}
+function create_deferred() {
+    let resolve;
+    const promise = new Promise((inner_resolve) => {
+        resolve = inner_resolve;
+    });
+    return {
+        promise,
+        resolve,
+    };
+}
+function create_active_session_turn_state(turn_id) {
+    return {
+        turn_id,
+        result: null,
+        deferred_finished: create_deferred(),
+        turn_context: null,
+        history_reload_requested: false,
+        prompt_started: false,
+    };
+}
+function create_turn_handle(active_turn) {
+    return {
+        id: active_turn.turn_id,
+        get result() {
+            return active_turn.result;
+        },
+        finished: active_turn.deferred_finished.promise,
+    };
+}
+//# sourceMappingURL=SessionLoop.js.map

package/bin/session/SessionLoop.js.map

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

package/bin/session/SessionMessages.d.ts

@@ -8,10 +8,10 @@
 import type { UIMessage } from "ai";
 import { SessionAssistantMessageWriter } from "../session/messages/SessionAssistantMessageWriter.js";
 import type { JsonObject } from "../types/common/Json.js";
-import type { ListSessionMessagesInput, SessionActionMessage, SessionAssistantMessage, SessionAssistantMessagePart, SessionErrorMessage, SessionMessage, SessionMessagePage, SessionUserMessage, SessionUserMessagePart } from "../types/session/SessionMessage.js";
+import type { ListSessionMessagesInput, SessionActionMessage, SessionAssistantInteractionPart, SessionAssistantMessage, SessionAssistantMessagePart, SessionErrorMessage, SessionMessage, SessionMessagePage, SessionUserMessage, SessionUserMessagePart } from "../types/session/SessionMessage.js";
 import type { SessionContextSnapshot, SessionMessageStorageStats, SessionSegmentSummary } from "../types/session/SessionSegment.js";
 import type { SessionStreamingToolLocation } from "../types/session/SessionTool.js";
-import type { SessionApproval } from "../types/session/SessionApproval.js";
+import type { SessionInteractionRequest, SessionInteractionResponse } from "../types/session/SessionInteraction.js";
 import type { SessionActionRecordV1, SessionRecordV1, SessionUserMessageV1 } from "../executor/types/SessionRecords.js";
 import type { AppendCompletedAssistantMessageInput, AppendExternalSessionAssistantMessageInput, AppendExternalSessionUserMessageInput, AppendSessionErrorMessageInput, AppendSessionPromptMessageInput, AppendSessionUserMessageInput, OpenSessionActionMessageInput, OpenSessionAssistantMessageInput, SessionMessagesOptions } from "../types/session/SessionMessages.js";
 export { SessionAssistantMessageWriter } from "../session/messages/SessionAssistantMessageWriter.js";
@@ -23,6 +23,8 @@ export declare class SessionMessages {
     private readonly messages_by_id;
     /** 按 Assistant Message 隔离的完整写事务链。 */
     private readonly assistant_write_chains;
+    /** Assistant Message 内 Interaction Part 的原子状态写入器。 */
+    private readonly interaction_writer;
     private initialized;
     constructor(options: SessionMessagesOptions);
     /** 恢复已有 Message，并收口进程中断遗留的运行状态。 */
@@ -31,7 +33,7 @@ export declare class SessionMessages {
     get_message(message_id: string): SessionMessage | undefined;
     /** 追加普通 prompt 或 steering User Message。 */
     append_user_message(input: AppendSessionUserMessageInput): Promise<SessionUserMessage>;
-    /** 创建可持续接收 chunk 的 Assistant segment。 */
+    /** 创建可持续接收 chunk 的 Assistant Message。 */
     open_assistant_message(input: OpenSessionAssistantMessageInput): Promise<SessionAssistantMessageWriter>;
     /** 直接写入一条已完成 Assistant Message。 */
     append_completed_assistant_message(input: AppendCompletedAssistantMessageInput): Promise<SessionAssistantMessage>;
@@ -91,25 +93,27 @@ export declare class SessionMessages {
     private create_message;
     /** 读取当前流式 Assistant 中的指定 Tool Part。 */
     find_streaming_tool(tool_call_id: string): SessionStreamingToolLocation | undefined;
-    /** 把完整审批请求写入对应的流式 Tool Part。 */
-    request_tool_approval(approval: SessionApproval): Promise<void>;
-    /** 在 Tool 恢复执行前提交审批决定对应的 Part 状态。 */
-    resolve_tool_approval(input: {
-        /** 当前审批请求标识。 */
-        approval_id: string;
-        /** 当前审批最终决定。 */
-        decision: "approved" | "denied" | "expired";
-        /** 当前审批关联的 Tool Call。 */
-        tool_call_id: string;
-    }): Promise<void>;
+    /** 返回当前 Session 中全部等待用户响应的 canonical Interaction。 */
+    list_pending_interactions(): SessionAssistantInteractionPart[];
+    /** 原子创建 Interaction，并把关联 Tool 转为 waiting-user。 */
+    request_interaction(request: SessionInteractionRequest): Promise<SessionAssistantInteractionPart>;
+    /** 原子保存用户响应，并按 Interaction 结果恢复或终止关联 Tool。 */
+    resolve_interaction(interaction_id: string, response: SessionInteractionResponse): Promise<SessionAssistantInteractionPart>;
+    /** 原子结束未响应 Interaction，并把关联 Tool 标记为失败。 */
+    close_interaction(interaction_id: string, input: {
+        status: "expired";
+    } | {
+        status: "cancelled";
+        reason: "turn_stopped" | "session_disposed" | "runtime_interrupted";
+    }): Promise<SessionAssistantInteractionPart>;
     /**
      * 串行执行同一 Assistant Message 的完整写事务。
      *
      * 失败事务不会阻塞后续写入；链尾仅用于排序，真实错误仍返回给调用方。
      */
     private enqueue_assistant_write;
-    /** 查找当前流式 Assistant 中的 Tool Part，否则抛出明确错误。 */
-    private require_streaming_tool;
+    /** 原子提交包含多个 Part 状态变化的 Assistant 完整快照。 */
+    private commit_assistant_snapshot;
     private build_message_mutation;
     private accept_message;
     private accept_mutation;