@downcity/agent 1.1.437 → 1.1.445

package/bin/session/runner/SessionExecutor.js

@@ -0,0 +1,430 @@
+/**
+ * SessionExecutor：核心模型请求与 tool-loop 执行器。
+ *
+ * 关键点（中文）
+ * - 只回答「发请求」与「是否继续」：step 循环、续写恢复、撞顶收尾与最终汇总。
+ * - 每个 Provider Step 的输入通过 `resolve_step_input` 回调取得，因此执行器不依赖
+ *   Composer 或存储，可以被独立构造与验证。
+ * - 不持有历史副本，也不修改 canonical Message。
+ */
+import { log_assistant_message_now } from "../../model/messages/SessionMessageLog.js";
+import { MAX_INCOMPLETE_RESPONSE_RECOVERIES, MAX_TOOL_LOOP_STEPS, TOOL_LOOP_MAX_STEPS_ERROR_CODE, build_incomplete_response_recovery_nudge, build_max_steps_error_text, build_max_steps_finalization_nudge, } from "../../session/runner/ToolLoopLimits.js";
+import { detect_incomplete_response, extract_assistant_text, merge_assistant_parts, summarize_assistant_parts_for_debug, summarize_step_for_debug, to_inline_preview, } from "../../session/runner/AssistantParts.js";
+import { decide_tool_loop, should_continue_after_tail_merge, } from "../../session/runner/ToolLoopDecision.js";
+import { resolve_model_error, } from "../../session/runner/ModelFailure.js";
+import { run_model_step, } from "../../model/ModelStepRunner.js";
+import { execute_model_request } from "../../model/ModelRequestRunner.js";
+import { resolve_usage_ratio, is_context_pressured, } from "../../session/runner/ContextPressure.js";
+import { ContextRetry } from "../../session/runner/ContextRetry.js";
+import { create_session_agent_content_part } from "../../session/messages/SessionAgentContent.js";
+import { generate_id } from "../../utils/Id.js";
+import { TURN_STOPPED_MESSAGE } from "../../session/loop/SessionTurnCompletion.js";
+/** 核心模型请求与 tool-loop 执行器。 */
+export class SessionExecutor {
+    session_id;
+    logger;
+    is_context_limit;
+    context_retry;
+    executing = false;
+    constructor(options) {
+        this.session_id = String(options.session_id || "").trim();
+        this.logger = options.logger;
+        this.is_context_limit = options.is_context_limit;
+        if (!this.session_id) {
+            throw new Error("SessionExecutor requires a non-empty session_id");
+        }
+        this.context_retry = new ContextRetry({
+            session_id: this.session_id,
+            advance_context: async (error) => this.is_context_limit(error)
+                ? await options.advance_context("provider_context_limit")
+                : false,
+            logger: this.logger,
+        });
+    }
+    /** 返回当前 Session 是否正在执行模型请求。 */
+    is_executing() {
+        return this.executing;
+    }
+    /**
+     * 执行一次已装配完成的模型/tool-loop 运行。
+     *
+     * 关键点（中文）
+     * - 同一个 Session 只允许一个活跃执行，避免 step 回调与运行态互相污染。
+     * - Provider 拒绝上下文超限时，先推进派生上下文再重试整轮。
+     */
+    async execute(input) {
+        if (this.executing) {
+            throw new Error("SessionExecutor.execute does not support concurrent execution");
+        }
+        this.executing = true;
+        try {
+            return await this.context_retry.execute_with_retry({
+                execute_turn: async (advance_count) => await this.run_tool_loop({
+                    turn_context: input.turn_context,
+                    resolve_step_input: async () => await input.resolve_step_input(advance_count),
+                }),
+            });
+        }
+        finally {
+            this.executing = false;
+        }
+    }
+    /** 运行模型与 tool-loop 主循环。 */
+    async run_tool_loop(input) {
+        const start_time = Date.now();
+        const session_id = this.session_id;
+        let last_observed_stream_error = undefined;
+        let final_assistant_parts = [];
+        let compact_required = false;
+        try {
+            let step_count = 0;
+            let total_tool_call_count = 0;
+            let total_tool_result_count = 0;
+            const on_step_finish = async (step_result) => {
+                step_count += 1;
+                const summary = summarize_step_for_debug(step_result);
+                total_tool_call_count +=
+                    typeof summary.toolCallCount === "number" ? summary.toolCallCount : 0;
+                total_tool_result_count +=
+                    typeof summary.toolResultCount === "number"
+                        ? summary.toolResultCount
+                        : 0;
+                await this.logger.log("info", "[agent] step.finish", {
+                    session_id: session_id,
+                    step_index: step_count,
+                    ...summary,
+                });
+            };
+            let incomplete_response_recovery_count = 0;
+            while (step_count < MAX_TOOL_LOOP_STEPS) {
+                // 关键点（中文）：steer 与 command 在同一个 Session step 检查点执行。
+                // 当前流与 tool callback 保持原执行视图，下一 step 再统一读取 effective 配置。
+                await input.turn_context.input.checkpoint();
+                const step_input = await input.resolve_step_input();
+                last_observed_stream_error = undefined;
+                const step = await this.execute_provider_step({
+                    turn_context: input.turn_context,
+                    step_input,
+                    on_step_finish,
+                });
+                const step_assistant_parts = step.step_assistant_parts;
+                const step_result = step.step_result;
+                final_assistant_parts = merge_assistant_parts(final_assistant_parts, step_assistant_parts);
+                const usage_ratio = resolve_usage_ratio(step_result.usage, step_input.context_window);
+                if (usage_ratio !== null) {
+                    const pressure_detected = is_context_pressured(usage_ratio);
+                    if (pressure_detected)
+                        compact_required = true;
+                    await this.logger.log("info", "[agent] context.usage", {
+                        session_id: session_id,
+                        step_index: step_count,
+                        usageRatio: usage_ratio,
+                        contextWindow: step_input.context_window,
+                        compactPending: pressure_detected,
+                    });
+                }
+                const incomplete_response = detect_incomplete_response({
+                    step_result,
+                    assistant_parts: step_assistant_parts,
+                });
+                const loop_decision = decide_tool_loop({
+                    hasIncompleteResponse: incomplete_response !== null,
+                    incompleteRecoveryCount: incomplete_response_recovery_count,
+                    maxIncompleteRecoveries: MAX_INCOMPLETE_RESPONSE_RECOVERIES,
+                    toolCallCount: step_result.tool_calls.length,
+                });
+                await this.logger.log("info", "[agent] loop.decision", {
+                    session_id: session_id,
+                    step_index: step_count,
+                    continueForToolCalls: loop_decision.continueForToolCalls,
+                    continueForIncompleteRecovery: loop_decision.continueForIncompleteRecovery,
+                    decisionKind: loop_decision.kind,
+                    incompleteResponseReason: incomplete_response?.reason ?? null,
+                    incompleteResponseRecoveryCount: incomplete_response_recovery_count,
+                    toolCallCount: step_result.tool_calls.length,
+                    toolResultCount: step_result.tool_results.length,
+                    finishReason: step_result.finish_reason,
+                    textPreview: to_inline_preview(step_result.text),
+                });
+                if (loop_decision.continueForIncompleteRecovery &&
+                    incomplete_response) {
+                    incomplete_response_recovery_count += 1;
+                    await this.logger.log("warn", "[agent] incomplete_response.recover", {
+                        session_id: session_id,
+                        step_index: step_count,
+                        recoveryCount: incomplete_response_recovery_count,
+                        reason: incomplete_response.reason,
+                        ...incomplete_response.details,
+                    });
+                    await input.turn_context.input.append_internal([{
+                            type: "text",
+                            text: build_incomplete_response_recovery_nudge(incomplete_response_recovery_count),
+                        }]);
+                    continue;
+                }
+                if (incomplete_response) {
+                    await this.logger.log("error", "[agent] incomplete_response", {
+                        session_id: session_id,
+                        step_index: step_count,
+                        reason: incomplete_response.reason,
+                        recoveryCount: incomplete_response_recovery_count,
+                        ...incomplete_response.details,
+                    });
+                    throw new Error(`Agent received incomplete response (${incomplete_response.reason})`);
+                }
+                if (loop_decision.continueForToolCalls) {
+                    incomplete_response_recovery_count = 0;
+                    continue;
+                }
+                // 关键点（中文）：stop 前做 tail merge，覆盖最后一个 step 后才入队的新 user 消息。
+                const tail_merged_message_count = input.turn_context.input.has_pending()
+                    ? 1
+                    : 0;
+                if (should_continue_after_tail_merge({
+                    mergedUserMessageCount: tail_merged_message_count,
+                })) {
+                    incomplete_response_recovery_count = 0;
+                    await this.logger.log("info", "[agent] loop.tail_merge_continue", {
+                        session_id: session_id,
+                        step_index: step_count,
+                        mergedUserMessageCount: tail_merged_message_count,
+                    });
+                    continue;
+                }
+                break;
+            }
+            // 关键点（中文）：撞顶不再静默成功收口——先强制收尾一次，再决定成功或明确失败。
+            let max_steps_reached = false;
+            let finalization_produced_text = false;
+            if (step_count >= MAX_TOOL_LOOP_STEPS) {
+                max_steps_reached = true;
+                await this.logger.log("warn", "[agent] loop.max_steps_reached", {
+                    session_id: session_id,
+                    stepCount: step_count,
+                    maxSteps: MAX_TOOL_LOOP_STEPS,
+                    totalToolCallCount: total_tool_call_count,
+                    totalToolResultCount: total_tool_result_count,
+                });
+                const finalization = await this.execute_max_steps_finalization({
+                    turn_context: input.turn_context,
+                    resolve_step_input: input.resolve_step_input,
+                    on_step_finish,
+                });
+                final_assistant_parts = merge_assistant_parts(final_assistant_parts, finalization.assistant_parts);
+                finalization_produced_text = finalization.produced_text;
+            }
+            // 撞顶且收尾失败时不伪造兜底正文，改由 Session 层写入 canonical Error Part。
+            const final_parts = final_assistant_parts.length > 0
+                ? final_assistant_parts
+                : max_steps_reached
+                    ? []
+                    : build_fallback_assistant_parts("Execution completed");
+            await this.logger.log("info", "[agent] final.message", {
+                session_id: session_id,
+                ...summarize_assistant_parts_for_debug(final_parts),
+            });
+            await log_assistant_message_now(this.logger, final_parts);
+            if (max_steps_reached && !finalization_produced_text) {
+                await this.logger.log("error", "[agent] loop.max_steps_exhausted", {
+                    session_id: session_id,
+                    stepCount: step_count,
+                    maxSteps: MAX_TOOL_LOOP_STEPS,
+                    totalToolCallCount: total_tool_call_count,
+                    totalToolResultCount: total_tool_result_count,
+                });
+                return this.build_result({
+                    success: false,
+                    text: extract_assistant_text(final_parts),
+                    error: build_max_steps_error_text(MAX_TOOL_LOOP_STEPS),
+                    error_code: TOOL_LOOP_MAX_STEPS_ERROR_CODE,
+                    compact_required,
+                });
+            }
+            const duration = Date.now() - start_time;
+            await this.logger.log("info", "[agent] finish", {
+                session_id: session_id,
+                duration,
+                stepCount: step_count,
+                totalToolCallCount: total_tool_call_count,
+                totalToolResultCount: total_tool_result_count,
+            });
+            return this.build_result({
+                success: true,
+                text: extract_assistant_text(final_parts),
+                compact_required,
+            });
+        }
+        catch (error) {
+            if (input.turn_context.lifecycle.abort_signal.aborted) {
+                const error_text = TURN_STOPPED_MESSAGE;
+                await this.logger.log("info", "[agent] stopped", {
+                    session_id: session_id,
+                });
+                return this.build_result({
+                    success: false,
+                    text: extract_assistant_text(final_assistant_parts),
+                    error: error_text,
+                    compact_required,
+                });
+            }
+            if (this.is_context_limit(error)) {
+                throw error;
+            }
+            const error_text = resolve_model_error({
+                error,
+                streamError: last_observed_stream_error,
+            });
+            await this.logger.log("error", "SessionExecutor execution failed", {
+                error: error_text,
+            });
+            return this.build_result({
+                success: false,
+                text: extract_assistant_text(final_assistant_parts),
+                error: error_text,
+                compact_required,
+            });
+        }
+    }
+    /**
+     * 构造 Turn 执行结果。
+     *
+     * 关键点（中文）：`compact_required` 是「本轮结束后是否需要在 Turn 收口后推进上下文」，
+     * 只在真正需要时为 true，避免上层产生空操作。
+     */
+    build_result(input) {
+        return {
+            success: input.success,
+            text: input.text,
+            ...(input.error ? { error: input.error } : {}),
+            ...(input.error_code ? { error_code: input.error_code } : {}),
+            ...(input.compact_required ? { compact_required: true } : {}),
+        };
+    }
+    /**
+     * 执行一次 Provider Step，并把 canonical 输出写回 Session。
+     *
+     * 关键点（中文）
+     * - 正常 tool-loop 与撞顶收尾共用这一条 Step 路径，落盘顺序完全一致。
+     * - 只负责单个 Step；循环决策、计数器与最终 Parts 合并仍由调用方拥有。
+     */
+    async execute_provider_step(input) {
+        const turn_context = input.turn_context;
+        const result = await execute_model_request({
+            request_kind: "turn",
+            abort_signal: turn_context.lifecycle.abort_signal,
+            should_retry: (error) => !this.is_context_limit(error),
+            on_failure: async (notice, error) => {
+                const is_compact_error = this.is_context_limit(error);
+                turn_context.output.report_model_request_failure({
+                    ...notice,
+                    ...(is_compact_error
+                        ? {
+                            attempt: 1,
+                            max_attempts: 1,
+                            will_retry: false,
+                        }
+                        : {}),
+                });
+                if (notice.will_retry) {
+                    await this.logger.log("warn", "[agent] model_stream.retry", {
+                        session_id: this.session_id,
+                        retry_count: notice.attempt,
+                        error_code: notice.code,
+                        error: notice.message,
+                        provider_request_id: notice.provider_request_id ?? null,
+                    });
+                }
+            },
+            execute_attempt: async () => {
+                await turn_context.output.assistant?.begin_step();
+                try {
+                    return await run_model_step({
+                        model: input.step_input.model,
+                        system: input.step_input.system,
+                        messages: input.step_input.messages,
+                        tools: input.tools_override ?? input.step_input.tools,
+                        abort_signal: turn_context.lifecycle.abort_signal,
+                        ...(turn_context.output.assistant
+                            ? { assistant_output: turn_context.output.assistant }
+                            : {}),
+                    });
+                }
+                catch (error) {
+                    await turn_context.output.assistant?.abort_step();
+                    throw error;
+                }
+            },
+        });
+        let step_assistant_parts = result.assistant_parts;
+        await input.on_step_finish(result.step_result);
+        if (turn_context.output.assistant) {
+            await turn_context.output.assistant.finish_step(step_assistant_parts);
+        }
+        const action_assistant_parts = turn_context.output.take_assistant_parts();
+        if (action_assistant_parts.length > 0) {
+            const persisted_parts = turn_context.output.assistant
+                ? await turn_context.output.assistant.append_result_parts(action_assistant_parts)
+                : action_assistant_parts.map((part, index) => create_session_agent_content_part(part, `${part.type}:${generate_id()}`, index + 1));
+            step_assistant_parts = merge_assistant_parts(step_assistant_parts, persisted_parts);
+        }
+        return {
+            step_result: result.step_result,
+            step_assistant_parts,
+        };
+    }
+    /**
+     * 达到工具循环上限后，要求模型在禁用工具的前提下给出收尾结论。
+     *
+     * 关键点（中文）
+     * - 收尾提示先持久化为 internal canonical User Message，不绕过 Composer 注入运行时输入。
+     * - 收尾 Step 仍走统一模型请求重试与上下文压缩恢复，真实 Provider 错误不会被吞掉。
+     * - 只执行一次；收尾仍无正文时由调用方按明确失败收口。
+     */
+    async execute_max_steps_finalization(input) {
+        await input.turn_context.input.append_internal([{
+                type: "text",
+                text: build_max_steps_finalization_nudge(MAX_TOOL_LOOP_STEPS),
+            }]);
+        await input.turn_context.input.checkpoint();
+        const step = await this.execute_provider_step({
+            turn_context: input.turn_context,
+            step_input: await input.resolve_step_input(),
+            tools_override: {},
+            on_step_finish: input.on_step_finish,
+        });
+        const produced_text = extract_assistant_text(step.step_assistant_parts).length > 0;
+        await this.logger.log(produced_text ? "info" : "warn", "[agent] loop.max_steps_finalized", {
+            session_id: this.session_id,
+            maxSteps: MAX_TOOL_LOOP_STEPS,
+            producedText: produced_text,
+        });
+        return {
+            assistant_parts: step.step_assistant_parts,
+            produced_text,
+        };
+    }
+}
+/** 构造成功执行但缺少最终内容时使用的 canonical Assistant Parts。 */
+function build_fallback_assistant_parts(text) {
+    return [{
+            part_id: "fallback-text:1",
+            sequence: 1,
+            type: "text",
+            text,
+            state: "done",
+        }];
+}
+/**
+ * 识别 Provider 拒绝请求是出于模型上下文超限的默认谓词。
+ *
+ * 关键点（中文）：Provider 错误是否属于上下文超限只在这里识别一次，外层恢复策略
+ * 只接收领域触发原因。
+ */
+export function is_provider_context_limit_error(error) {
+    const message = String(error ?? "").toLowerCase();
+    return message.includes("context_length") ||
+        message.includes("too long") ||
+        message.includes("maximum context") ||
+        message.includes("context window");
+}
+//# sourceMappingURL=SessionExecutor.js.map

package/bin/session/runner/SessionExecutor.js.map

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

package/bin/session/runner/ToolLoopDecision.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ToolLoopDecision：工具循环的“是否继续下一轮”纯决策。
+ *
+ * 关键点（中文）
+ * - 把继续/停止的分支优先级从执行器主流程中拆出。
+ * - 保持纯函数，不依赖模型、持久化或 logger，便于直接测试。
+ */
+/**
+ * 单轮 loop 决策输入。
+ */
+export interface ToolLoopDecisionInput {
+    /** 当前 step 是否检测到了不完整响应。 */
+    hasIncompleteResponse: boolean;
+    /** 当前已经执行过多少次不完整响应恢复。 */
+    incompleteRecoveryCount: number;
+    /** 允许执行的不完整响应恢复上限。 */
+    maxIncompleteRecoveries: number;
+    /** 当前 step 实际产出的工具调用数量。 */
+    toolCallCount: number;
+}
+/**
+ * 单轮 loop 决策结果。
+ */
+export interface ToolLoopDecision {
+    /** 本轮命中的主决策类型。 */
+    kind: "recover_incomplete" | "continue_for_tool_calls" | "stop";
+    /** 是否因为工具调用而继续下一轮。 */
+    continueForToolCalls: boolean;
+    /** 是否因为不完整响应恢复而继续下一轮。 */
+    continueForIncompleteRecovery: boolean;
+}
+/**
+ * stop 分支上的尾部消息续跑判定输入。
+ *
+ * 关键点（中文）
+ * - 用于处理“最后一个 step 结束后，恰好又有新的 user 消息写入”的窗口。
+ * - 这里只关心是否真的合并到了新增 user message，不关心消息内容细节。
+ */
+export interface TailMergeContinuationInput {
+    /** stop 前最后一次 tail merge 实际合并到的 user message 数量。 */
+    mergedUserMessageCount: number;
+}
+/**
+ * 评估当前 step 完成后，tool-loop 是否应继续下一轮。
+ *
+ * 优先级（中文）
+ * 1. 不完整响应恢复
+ * 2. 已发生的工具调用
+ * 3. 停止
+ */
+export declare function decide_tool_loop(input: ToolLoopDecisionInput): ToolLoopDecision;
+/**
+ * 评估 stop 前的尾部合并是否应该继续下一轮。
+ *
+ * 关键点（中文）
+ * - 只要最后一次 tail merge 真正并入了新的 user 消息，就必须续跑。
+ * - 这样可以覆盖“最后一个 step 结束后，新消息才到达”的收尾窗口。
+ */
+export declare function should_continue_after_tail_merge(input: TailMergeContinuationInput): boolean;
+//# sourceMappingURL=ToolLoopDecision.d.ts.map

package/bin/session/runner/ToolLoopDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolLoopDecision.d.ts","sourceRoot":"","sources":["../../../src/session/runner/ToolLoopDecision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EACA,oBAAoB,GACpB,yBAAyB,GACzB,MAAM,CAAC;IACX,sBAAsB;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,6BAA6B,EAAE,OAAO,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,oDAAoD;IACpD,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,gBAAgB,CAyBlB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAET"}

package/bin/{executor/core-engine/CoreEngineLoopDecision.js → session/runner/ToolLoopDecision.js}

@@ -1,8 +1,8 @@
 /**
- * CoreEngineLoopDecision：模型/tool-loop 核心循环的纯决策模块。
+ * ToolLoopDecision：工具循环的“是否继续下一轮”纯决策。
  *
  * 关键点（中文）
- * - 把 “是否继续下一轮” 的分支优先级从 CoreEngine 主流程中拆出。
+ * - 把继续/停止的分支优先级从执行器主流程中拆出。
  * - 保持纯函数，不依赖模型、持久化或 logger，便于直接测试。
  */
 /**
@@ -13,7 +13,7 @@
  * 2. 已发生的工具调用
  * 3. 停止
  */
-export function evaluate_core_engine_loop_decision(input) {
+export function decide_tool_loop(input) {
     if (input.hasIncompleteResponse &&
         input.incompleteRecoveryCount < input.maxIncompleteRecoveries) {
         return {
@@ -42,7 +42,7 @@ export function evaluate_core_engine_loop_decision(input) {
  * - 只要最后一次 tail merge 真正并入了新的 user 消息，就必须续跑。
  * - 这样可以覆盖“最后一个 step 结束后，新消息才到达”的收尾窗口。
  */
-export function should_continue_for_tail_merged_user_messages(input) {
+export function should_continue_after_tail_merge(input) {
     return input.mergedUserMessageCount > 0;
 }
-//# sourceMappingURL=CoreEngineLoopDecision.js.map
+//# sourceMappingURL=ToolLoopDecision.js.map

package/bin/session/runner/ToolLoopDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolLoopDecision.js","sourceRoot":"","sources":["../../../src/session/runner/ToolLoopDecision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2CH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA4B;IAE5B,IACE,KAAK,CAAC,qBAAqB;QAC3B,KAAK,CAAC,uBAAuB,GAAG,KAAK,CAAC,uBAAuB,EAC7D,CAAC;QACD,OAAO;YACL,IAAI,EAAE,oBAAoB;YAC1B,oBAAoB,EAAE,KAAK;YAC3B,6BAA6B,EAAE,IAAI;SACpC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,oBAAoB,EAAE,IAAI;YAC1B,6BAA6B,EAAE,KAAK;SACrC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,oBAAoB,EAAE,KAAK;QAC3B,6BAA6B,EAAE,KAAK;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAiC;IAEjC,OAAO,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/bin/session/runner/ToolLoopLimits.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ToolLoopLimits：工具循环的边界与边界提示。
+ *
+ * 关键点（中文）：这里只描述「循环能跑多久」以及撞到边界时对模型说什么，
+ * 不参与循环决策本身。
+ */
+/**
+ * 单次 Tool Loop 允许的最大 Step 数。
+ *
+ * 关键点（中文）
+ * - Step 计的是模型往返次数，不是工具调用次数；一次 shell 调用就会消耗一个 Step。
+ * - 该上限只用于防止跑飞，正常运行不应触达；旧值 64 很容易被稍长的排查任务撞顶。
+ * - 撞顶不再静默成功：先强制执行一次收尾 Step，收尾仍无正文时才按明确错误结束。
+ */
+export declare const MAX_TOOL_LOOP_STEPS = 1000;
+/** Tool Loop 撞顶且收尾失败时写入 canonical Error Part 的稳定错误码。 */
+export declare const TOOL_LOOP_MAX_STEPS_ERROR_CODE = "tool_loop_max_steps";
+/** 不完整响应自动恢复的最大次数。 */
+export declare const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
+/** 构造不完整响应恢复提示。 */
+export declare function build_incomplete_response_recovery_nudge(recovery_index: number): string;
+/**
+ * 构造工具循环撞顶后的收尾提示。
+ *
+ * 关键点（中文）：这里只描述收尾要求，不解释工具循环机制，避免模型继续尝试调用工具。
+ */
+export declare function build_max_steps_finalization_nudge(step_limit: number): string;
+/** 构造工具循环撞顶收尾失败时的用户可见错误文本。 */
+export declare function build_max_steps_error_text(step_limit: number): string;
+//# sourceMappingURL=ToolLoopLimits.d.ts.map

package/bin/session/runner/ToolLoopLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolLoopLimits.d.ts","sourceRoot":"","sources":["../../../src/session/runner/ToolLoopLimits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,wDAAwD;AACxD,eAAO,MAAM,8BAA8B,wBAAwB,CAAC;AAEpE,sBAAsB;AACtB,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,mBAAmB;AACnB,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,GACrB,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED,8BAA8B;AAC9B,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/bin/session/runner/ToolLoopLimits.js

@@ -0,0 +1,46 @@
+/**
+ * ToolLoopLimits：工具循环的边界与边界提示。
+ *
+ * 关键点（中文）：这里只描述「循环能跑多久」以及撞到边界时对模型说什么，
+ * 不参与循环决策本身。
+ */
+/**
+ * 单次 Tool Loop 允许的最大 Step 数。
+ *
+ * 关键点（中文）
+ * - Step 计的是模型往返次数，不是工具调用次数；一次 shell 调用就会消耗一个 Step。
+ * - 该上限只用于防止跑飞，正常运行不应触达；旧值 64 很容易被稍长的排查任务撞顶。
+ * - 撞顶不再静默成功：先强制执行一次收尾 Step，收尾仍无正文时才按明确错误结束。
+ */
+export const MAX_TOOL_LOOP_STEPS = 1000;
+/** Tool Loop 撞顶且收尾失败时写入 canonical Error Part 的稳定错误码。 */
+export const TOOL_LOOP_MAX_STEPS_ERROR_CODE = "tool_loop_max_steps";
+/** 不完整响应自动恢复的最大次数。 */
+export const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
+/** 构造不完整响应恢复提示。 */
+export function build_incomplete_response_recovery_nudge(recovery_index) {
+    const round = Math.max(1, recovery_index);
+    return [
+        `系统恢复提醒（第 ${round} 次）：上一轮响应在流式阶段异常中断。`,
+        "不要复述已完成内容。",
+        "请从中断处继续；如果需要工具，请重新发起完整工具调用。",
+        "只有在答案完整结束、任务真正完成、或明确受阻时才停止。",
+    ].join("\n");
+}
+/**
+ * 构造工具循环撞顶后的收尾提示。
+ *
+ * 关键点（中文）：这里只描述收尾要求，不解释工具循环机制，避免模型继续尝试调用工具。
+ */
+export function build_max_steps_finalization_nudge(step_limit) {
+    return [
+        `系统收尾提醒：本轮已经连续执行 ${step_limit} 个模型 Step，达到工具循环上限。`,
+        "现在不允许再调用任何工具。",
+        "请基于已经完成的工具结果直接给出结论；若任务尚未完成，请明确说明已完成部分、当前受阻原因和下一步建议。",
+    ].join("\n");
+}
+/** 构造工具循环撞顶收尾失败时的用户可见错误文本。 */
+export function build_max_steps_error_text(step_limit) {
+    return `Agent reached the tool loop limit of ${step_limit} steps without producing a final answer.`;
+}
+//# sourceMappingURL=ToolLoopLimits.js.map

package/bin/session/runner/ToolLoopLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolLoopLimits.js","sourceRoot":"","sources":["../../../src/session/runner/ToolLoopLimits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAC;AAEpE,sBAAsB;AACtB,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAEpD,mBAAmB;AACnB,MAAM,UAAU,wCAAwC,CACtD,cAAsB;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC1C,OAAO;QACL,YAAY,KAAK,qBAAqB;QACtC,YAAY;QACZ,6BAA6B;QAC7B,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,UAAkB;IACnE,OAAO;QACL,mBAAmB,UAAU,qBAAqB;QAClD,eAAe;QACf,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC3D,OAAO,wCAAwC,UAAU,0CAA0C,CAAC;AACtG,CAAC"}

package/bin/session/{browse → storage}/Browse.d.ts

@@ -5,7 +5,7 @@
  * SessionStorage 聚合读取。浏览逻辑不创建 schema，也不尝试迁移旧文件格式。
  */
 import type { AgentListSessionsInput, AgentSessionInfo, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
-import type { SessionHistoryMeta } from "../../executor/types/SessionHistoryMeta.js";
+import type { SessionHistoryMeta } from "../../types/store/SessionHistoryMeta.js";
 import { type FileSystem, type SessionMessage } from "@downcity/type";
 /** Session 详情投影输入。 */
 interface SessionBrowseBaseInput {

package/bin/session/storage/Browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browse.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Browse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAEhB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAQ9E,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AA8BxB,sBAAsB;AACtB,UAAU,sBAAsB;IAC9B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoCD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,CAuBlF;AAED,0CAA0C;AAC1C,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,GAC3B,kBAAkB,GAAG,IAAI,CA+B3B;AAED,wBAAwB;AACxB,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,sBAAsB;IACtB,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,oBAAoB;IACpB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEnC;AAED,wBAAwB;AACxB,wBAAsB,wCAAwC,CAAC,KAAK,EAAE;IACpE,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEnC"}