@downcity/agent 1.1.437 → 1.1.445

package/bin/session/messages/SessionMutationFactory.js

@@ -0,0 +1,38 @@
+/**
+ * canonical Part 到 `part` Mutation 的唯一构造入口。
+ *
+ * Part 的 `type` 与载荷必须同源，`SessionPartMutation` 又是按 Part 类型展开的联合，
+ * 所以这里按 `type` 显式分派，让编译器验证配对关系，而不是用断言关闭检查。
+ * Message 与 delta Mutation 只有单一调用点，留在各自生产方内联构造。
+ */
+/** 构造 `part` 创建或完整快照 Mutation。 */
+export function create_session_part_mutation(input) {
+    const base = {
+        mutation_id: input.mutation_id,
+        variant: "part",
+        message_id: input.message_id,
+        ...(input.turn_id ? { turn_id: input.turn_id } : {}),
+        revision: input.revision,
+        session_id: input.session_id,
+        created_at: input.created_at,
+        part_id: input.part.part_id,
+    };
+    const part = input.part;
+    switch (part.type) {
+        case "text":
+            return { ...base, type: "text", part };
+        case "reasoning":
+            return { ...base, type: "reasoning", part };
+        case "tool":
+            return { ...base, type: "tool", part };
+        case "file":
+            return { ...base, type: "file", part };
+        case "data":
+            return { ...base, type: "data", part };
+        case "action":
+            return { ...base, type: "action", part };
+        case "error":
+            return { ...base, type: "error", part };
+    }
+}
+//# sourceMappingURL=SessionMutationFactory.js.map

package/bin/session/messages/SessionMutationFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMutationFactory.js","sourceRoot":"","sources":["../../../src/session/messages/SessionMutationFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,kCAAkC;AAClC,MAAM,UAAU,4BAA4B,CAAC,KAe5C;IACC,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,MAAe;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;KAC5B,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,WAAW;YACd,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC9C,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/bin/session/messages/SessionUserMessage.d.ts

@@ -1,14 +1,12 @@
 /**
  * Session User Message 与公开输入 Part 的 canonical 转换规则。
  *
- * 本模块只进行确定性数据归一化，不持有 Message、Store 或 Session 状态。
+ * 本模块只做内容归一化：把调用方提供的内容转成确定、可持久化的形状，
+ * 不分配 `part_id` 与 `sequence`——identity 属于拥有该消息的一方。
  */
-import type { SessionAgentContent, SessionUserContent } from "@downcity/type";
-import type { SessionUserMessagePart } from "@downcity/type";
-/** 把 Downcity Session User parts 归一为 canonical User parts。 */
-export declare function normalize_session_user_parts(parts: SessionUserContent[] | null | undefined): SessionUserMessagePart[];
-/** 校验直接写入的 canonical User Parts，并保留已有 Part identity。 */
-export declare function normalize_canonical_session_user_parts(parts: readonly SessionUserMessagePart[]): SessionUserMessagePart[];
+import type { SessionAgentContent, SessionUserContent, SessionUserPartContent } from "@downcity/type";
+/** 把 Downcity Session User 输入归一为尚未分配身份的内容 Part。 */
+export declare function normalize_session_user_parts(parts: SessionUserContent[] | null | undefined): SessionUserPartContent[];
 /** 判断 Assistant 结果中是否包含可持久化内容。 */
 export declare function has_assistant_result_content(parts: readonly SessionAgentContent[]): boolean;
 //# sourceMappingURL=SessionUserMessage.d.ts.map

package/bin/session/messages/SessionUserMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionUserMessage.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionUserMessage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAO7D,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC7C,sBAAsB,EAAE,CAuC1B;AAED,wDAAwD;AACxD,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,SAAS,sBAAsB,EAAE,GACvC,sBAAsB,EAAE,CAU1B;AAED,kCAAkC;AAClC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,OAAO,CAQT"}
+{"version":3,"file":"SessionUserMessage.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAOxB,mDAAmD;AACnD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC7C,sBAAsB,EAAE,CA4B1B;AAED,kCAAkC;AAClC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,OAAO,CAQT"}

package/bin/session/messages/SessionUserMessage.js

@@ -1,27 +1,21 @@
 /**
  * Session User Message 与公开输入 Part 的 canonical 转换规则。
  *
- * 本模块只进行确定性数据归一化，不持有 Message、Store 或 Session 状态。
+ * 本模块只做内容归一化：把调用方提供的内容转成确定、可持久化的形状，
+ * 不分配 `part_id` 与 `sequence`——identity 属于拥有该消息的一方。
  */
 import { to_session_json_value } from "../../session/messages/SessionJsonValue.js";
 import { normalize_session_context_content, normalize_session_context_tag, } from "../../session/messages/SessionUserContext.js";
-/** 把 Downcity Session User parts 归一为 canonical User parts。 */
+/** 把 Downcity Session User 输入归一为尚未分配身份的内容 Part。 */
 export function normalize_session_user_parts(parts) {
     if (!Array.isArray(parts))
         return [];
-    return parts.flatMap((part, index) => {
+    return parts.flatMap((part) => {
         if (part.type === "text") {
-            return [{
-                    part_id: `user-text:${index + 1}`,
-                    sequence: index + 1,
-                    type: "text",
-                    text: part.text,
-                }];
+            return [{ type: "text", text: part.text }];
         }
         if (part.type === "context") {
             return [{
-                    part_id: `user-context:${index + 1}`,
-                    sequence: index + 1,
                     type: "context",
                     tag: normalize_session_context_tag(part.tag),
                     context: normalize_session_context_content(part.context),
@@ -29,8 +23,6 @@ export function normalize_session_user_parts(parts) {
         }
         if (part.type === "file") {
             return [{
-                    part_id: `user-file:${index + 1}`,
-                    sequence: index + 1,
                     type: "file",
                     url: part.url,
                     media_type: part.media_type,
@@ -38,8 +30,6 @@ export function normalize_session_user_parts(parts) {
                 }];
         }
         return [{
-                part_id: `user-data:${index + 1}`,
-                sequence: index + 1,
                 type: "data",
                 data_type: part.data_type,
                 data: to_session_json_value(part.data),
@@ -47,19 +37,6 @@ export function normalize_session_user_parts(parts) {
             }];
     });
 }
-/** 校验直接写入的 canonical User Parts，并保留已有 Part identity。 */
-export function normalize_canonical_session_user_parts(parts) {
-    return parts.map((part, index) => {
-        const canonical = { ...structuredClone(part), sequence: index + 1 };
-        if (canonical.type !== "context")
-            return canonical;
-        return {
-            ...canonical,
-            tag: normalize_session_context_tag(canonical.tag),
-            context: normalize_session_context_content(canonical.context),
-        };
-    });
-}
 /** 判断 Assistant 结果中是否包含可持久化内容。 */
 export function has_assistant_result_content(parts) {
     return parts.some((part) => {

package/bin/session/messages/SessionUserMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionUserMessage.js","sourceRoot":"","sources":["../../../src/session/messages/SessionUserMessage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionUserMessage.js","sourceRoot":"","sources":["../../../src/session/messages/SessionUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EACL,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,0CAA0C,CAAC;AAElD,mDAAmD;AACnD,MAAM,UAAU,4BAA4B,CAC1C,KAA8C;IAE9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,OAAO,CAAyB,CAAC,IAAI,EAAE,EAAE;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC;oBACN,IAAI,EAAE,SAAS;oBACf,GAAG,EAAE,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC5C,OAAO,EAAE,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC;iBACzD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,4BAA4B,CAC1C,KAAqC;IAErC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/{executor/core-engine/CoreEngineSignals.d.ts → session/runner/AssistantParts.d.ts}

@@ -1,14 +1,11 @@
 /**
- * CoreEngine Tool Loop 的纯信号与诊断模块。
+ * AssistantParts：Assistant 产出的读取与诊断工具。
  *
- * 所有消息判断都直接读取 canonical `SessionAgentMessagePart`，不依赖 UI 投影。
+ * 关键点（中文）：所有判断都直接读取 canonical `SessionAgentMessagePart`，
+ * 不依赖 UI 投影，也不修改任何 Part。
  */
 import type { JsonObject } from "@downcity/type";
 import type { SessionAgentMessagePart } from "@downcity/type";
-/** 单次 Tool Loop 允许的最大 Step 数。 */
-export declare const MAX_TOOL_LOOP_STEPS = 64;
-/** 不完整响应自动恢复的最大次数。 */
-export declare const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
 /** 生成日志友好的单行预览文本。 */
 export declare function to_inline_preview(value: unknown): string;
 /** 汇总单个 Step 的关键信号。 */
@@ -19,8 +16,6 @@ export declare function summarize_assistant_parts_for_debug(parts: readonly Sess
 export declare function merge_assistant_parts(base: readonly SessionAgentMessagePart[], incoming: readonly SessionAgentMessagePart[]): SessionAgentMessagePart[];
 /** 从 canonical Assistant Parts 提取用户可见文本。 */
 export declare function extract_assistant_text(parts: readonly SessionAgentMessagePart[]): string;
-/** 构造不完整响应恢复提示。 */
-export declare function build_incomplete_response_recovery_nudge(recovery_index: number): string;
 /** 检测模型报告未知完成原因或存在未完成 Tool Part 的情况。 */
 export declare function detect_incomplete_response(input: {
     /** 当前 Step 结果。 */
@@ -31,4 +26,4 @@ export declare function detect_incomplete_response(input: {
     reason: string;
     details: JsonObject;
 } | null;
-//# sourceMappingURL=CoreEngineSignals.d.ts.map
+//# sourceMappingURL=AssistantParts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantParts.d.ts","sourceRoot":"","sources":["../../../src/session/runner/AssistantParts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAK9D,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMxD;AAED,uBAAuB;AACvB,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,CA8BzE;AAED,sCAAsC;AACtC,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,UAAU,CAcZ;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,uBAAuB,EAAE,EACxC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,uBAAuB,EAAE,CAK3B;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,MAAM,CAaR;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACrD,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAgCjD"}

package/bin/{executor/core-engine/CoreEngineSignals.js → session/runner/AssistantParts.js}

@@ -1,12 +1,9 @@
 /**
- * CoreEngine Tool Loop 的纯信号与诊断模块。
+ * AssistantParts：Assistant 产出的读取与诊断工具。
  *
- * 所有消息判断都直接读取 canonical `SessionAgentMessagePart`，不依赖 UI 投影。
+ * 关键点（中文）：所有判断都直接读取 canonical `SessionAgentMessagePart`，
+ * 不依赖 UI 投影，也不修改任何 Part。
  */
-/** 单次 Tool Loop 允许的最大 Step 数。 */
-export const MAX_TOOL_LOOP_STEPS = 64;
-/** 不完整响应自动恢复的最大次数。 */
-export const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
 /** 调试日志中的文本预览最大长度。 */
 const DEBUG_TEXT_PREVIEW_MAX_CHARS = 180;
 /** 生成日志友好的单行预览文本。 */
@@ -83,16 +80,6 @@ export function extract_assistant_text(parts) {
         .join("\n")
         .trim();
 }
-/** 构造不完整响应恢复提示。 */
-export function build_incomplete_response_recovery_nudge(recovery_index) {
-    const round = Math.max(1, recovery_index);
-    return [
-        `系统恢复提醒（第 ${round} 次）：上一轮响应在流式阶段异常中断。`,
-        "不要复述已完成内容。",
-        "请从中断处继续；如果需要工具，请重新发起完整工具调用。",
-        "只有在答案完整结束、任务真正完成、或明确受阻时才停止。",
-    ].join("\n");
-}
 /** 检测模型报告未知完成原因或存在未完成 Tool Part 的情况。 */
 export function detect_incomplete_response(input) {
     const record = to_json_object(input.step_result) ?? {};
@@ -139,4 +126,4 @@ function pick_tool_names(value) {
         .filter((name) => typeof name === "string")
         .slice(0, 8);
 }
-//# sourceMappingURL=CoreEngineSignals.js.map
+//# sourceMappingURL=AssistantParts.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * ContextPressure：上下文压力阈值判断。
+ *
+ * 本模块只判断真实 Provider usage 是否接近上下文窗口上限；具体选择、摘要和持久化
+ * 全部归属于 SessionComposer 的上下文推进实现。
+ */
+/** usage 达到模型上下文窗口 95% 时安排下一 step 压缩。 */
+export declare const CONTEXT_PRESSURE_RATIO = 0.95;
+/** 读取 Provider usage 中的实际总 token。 */
+export declare function resolve_usage_tokens(usage: unknown): number | null;
+/** 计算真实 usage 占当前模型上下文窗口的比例。 */
+export declare function resolve_usage_ratio(usage: unknown, context_window: number | undefined): number | null;
+/** 判断一次真实 usage 是否已接近上下文窗口上限。 */
+export declare function is_context_pressured(usage_ratio: number | null): boolean;
+//# sourceMappingURL=ContextPressure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextPressure.d.ts","sourceRoot":"","sources":["../../../src/session/runner/ContextPressure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,qCAAqC;AACrC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASlE;AAED,gCAAgC;AAChC,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,MAAM,GAAG,IAAI,CAIf;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAGT"}

package/bin/{executor/core-engine/CoreEngineContextCompaction.js → session/runner/ContextPressure.js}

@@ -1,13 +1,13 @@
 /**
- * CoreEngine Downcity 模型上下文压缩模块。
+ * ContextPressure：上下文压力阈值判断。
  *
- * 本模块只判断真实 Provider usage 是否达到恢复阈值；具体选择、摘要和持久化全部
- * 归属于 SessionComposer 的 Context Policy。
+ * 本模块只判断真实 Provider usage 是否接近上下文窗口上限；具体选择、摘要和持久化
+ * 全部归属于 SessionComposer 的上下文推进实现。
  */
 /** usage 达到模型上下文窗口 95% 时安排下一 step 压缩。 */
-export const MODEL_CONTEXT_COMPACTION_TRIGGER_RATIO = 0.95;
+export const CONTEXT_PRESSURE_RATIO = 0.95;
 /** 读取 Provider usage 中的实际总 token。 */
-export function resolve_model_usage_tokens(usage) {
+export function resolve_usage_tokens(usage) {
     if (!usage || typeof usage !== "object")
         return null;
     const record = usage;
@@ -21,20 +21,20 @@ export function resolve_model_usage_tokens(usage) {
     return (input_tokens ?? 0) + (output_tokens ?? 0);
 }
 /** 计算真实 usage 占当前模型上下文窗口的比例。 */
-export function resolve_model_usage_ratio(usage, context_window) {
+export function resolve_usage_ratio(usage, context_window) {
     if (!Number.isSafeInteger(context_window) || Number(context_window) <= 0)
         return null;
-    const used_tokens = resolve_model_usage_tokens(usage);
+    const used_tokens = resolve_usage_tokens(usage);
     return used_tokens === null ? null : used_tokens / Number(context_window);
 }
-/** 判断一次真实 usage 是否要求下一 step 继续压缩。 */
-export function should_compact_after_usage(usage_ratio) {
+/** 判断一次真实 usage 是否已接近上下文窗口上限。 */
+export function is_context_pressured(usage_ratio) {
     if (usage_ratio === null || !Number.isFinite(usage_ratio))
         return false;
-    return usage_ratio >= MODEL_CONTEXT_COMPACTION_TRIGGER_RATIO;
+    return usage_ratio >= CONTEXT_PRESSURE_RATIO;
 }
 /** 读取非负数字。 */
 function read_non_negative_number(value) {
     return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
 }
-//# sourceMappingURL=CoreEngineContextCompaction.js.map
+//# sourceMappingURL=ContextPressure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextPressure.js","sourceRoot":"","sources":["../../../src/session/runner/ContextPressure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,qCAAqC;AACrC,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;IACzF,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC/C,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;IACzF,MAAM,aAAa,GAAG,wBAAwB,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5F,IAAI,YAAY,KAAK,IAAI,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjE,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,cAAkC;IAElC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAC5E,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,oBAAoB,CAClC,WAA0B;IAE1B,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,OAAO,WAAW,IAAI,sBAAsB,CAAC;AAC/C,CAAC;AAED,cAAc;AACd,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * ContextRetry：推进上下文后重试整轮 Turn 的策略。
+ *
+ * 关键点（中文）
+ * - 统一封装「推进上下文后重试」和「普通失败兜底」逻辑。
+ * - 执行器提供单次 Turn 行为，本模块只决定是否恢复并重试。
+ * - 不改变外部行为，只把异常分流规则集中到一个地方。
+ */
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { SessionTurnExecutionResult } from "../../types/session/SessionExecution.js";
+interface ContextRetryOptions {
+    /** 当前 Session 稳定标识。 */
+    session_id: string;
+    /** 请求 Composer 尝试推进上下文派生状态。 */
+    advance_context: (error: unknown) => Promise<boolean>;
+    /**
+     * 当前 session 统一日志器。
+     */
+    logger: Logger;
+}
+interface ContextRetryInput {
+    /** 按当前上下文推进次数执行完整 Turn。 */
+    execute_turn: (advance_count: number) => Promise<SessionTurnExecutionResult>;
+}
+/**
+ * 执行恢复与重试策略服务。
+ */
+export declare class ContextRetry {
+    private readonly advance_context;
+    private readonly logger;
+    constructor(options: ContextRetryOptions);
+    /**
+     * 执行一次带恢复策略的 Session Turn。
+     */
+    execute_with_retry(input: ContextRetryInput): Promise<SessionTurnExecutionResult>;
+    private build_failure_result;
+}
+export {};
+//# sourceMappingURL=ContextRetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextRetry.d.ts","sourceRoot":"","sources":["../../../src/session/runner/ContextRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAOtF,UAAU,mBAAmB;IAC3B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,2BAA2B;IAC3B,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC9E;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,mBAAmB;IASxC;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,0BAA0B,CAAC;IAmCtC,OAAO,CAAC,oBAAoB;CAa7B"}

package/bin/{executor/services/ExecutorRecoveryPolicy.js → session/runner/ContextRetry.js}

@@ -1,51 +1,51 @@
 /**
- * ExecutorRecoveryPolicy：执行恢复与重试策略。
+ * ContextRetry：推进上下文后重试整轮 Turn 的策略。
  *
  * 关键点（中文）
- * - 统一封装“压缩后重试”和“普通失败兜底”逻辑。
- * - Executor 提供单次 Turn 行为，本模块只决定是否恢复并重试。
+ * - 统一封装「推进上下文后重试」和「普通失败兜底」逻辑。
+ * - 执行器提供单次 Turn 行为，本模块只决定是否恢复并重试。
  * - 不改变外部行为，只把异常分流规则集中到一个地方。
  */
 /**
- * 可压缩错误的最大重试次数。
+ * 上下文推进后的最大重试次数。
  */
-const MAX_COMPACTION_RETRY_ATTEMPTS = 3;
+const MAX_CONTEXT_ADVANCE_ATTEMPTS = 3;
 /**
  * 执行恢复与重试策略服务。
  */
-export class ExecutorRecoveryPolicy {
-    recover_context;
+export class ContextRetry {
+    advance_context;
     logger;
     constructor(options) {
         const session_id = String(options.session_id || "").trim();
-        this.recover_context = options.recover_context;
+        this.advance_context = options.advance_context;
         this.logger = options.logger;
         if (!session_id) {
-            throw new Error("ExecutorRecoveryPolicy requires a non-empty session_id");
+            throw new Error("ContextRetry requires a non-empty session_id");
         }
     }
     /**
      * 执行一次带恢复策略的 Session Turn。
      */
     async execute_with_retry(input) {
-        let retry_count = 0;
+        let advance_count = 0;
         while (true) {
             try {
-                return await input.execute_turn(retry_count);
+                return await input.execute_turn(advance_count);
             }
             catch (error) {
-                if (retry_count < MAX_COMPACTION_RETRY_ATTEMPTS) {
-                    const recovered = await this.recover_context(error);
-                    if (recovered) {
-                        await this.logger.log("info", "[agent] compacting", {
-                            retryCount: retry_count,
+                if (advance_count < MAX_CONTEXT_ADVANCE_ATTEMPTS) {
+                    const advanced = await this.advance_context(error);
+                    if (advanced) {
+                        await this.logger.log("info", "[agent] context.advance", {
+                            advanceCount: advance_count,
                             error: String(error),
                         });
-                        retry_count += 1;
+                        advance_count += 1;
                         continue;
                     }
                 }
-                if (retry_count > 0) {
+                if (advance_count > 0) {
                     return this.build_failure_result({
                         error_text: "Context length exceeded and retries failed. Please resend your question.",
                     });
@@ -68,4 +68,4 @@ export class ExecutorRecoveryPolicy {
         };
     }
 }
-//# sourceMappingURL=ExecutorRecoveryPolicy.js.map
+//# sourceMappingURL=ContextRetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextRetry.js","sourceRoot":"","sources":["../../../src/session/runner/ContextRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAoBvC;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,eAAe,CAAyC;IACxD,MAAM,CAAS;IAEhC,YAAY,OAA4B;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,KAAwB;QAExB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,OAAO,MAAM,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,aAAa,GAAG,4BAA4B,EAAE,CAAC;oBACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;oBACnD,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;4BACvD,YAAY,EAAE,aAAa;4BAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;yBACrB,CAAC,CAAC;wBACH,aAAa,IAAI,CAAC,CAAC;wBACnB,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC,oBAAoB,CAAC;wBAC/B,UAAU,EACR,0EAA0E;qBAC7E,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,2BAA2B,EAAE;oBAC1D,KAAK,EAAE,UAAU;iBAClB,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC,oBAAoB,CAAC;oBAC/B,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,KAM5B;QACC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,KAAK,CAAC,UAAU;SACxB,CAAC;IACJ,CAAC;CACF"}

package/bin/{executor/core-engine/CoreEngineError.d.ts → session/runner/ModelFailure.d.ts}

@@ -1,9 +1,9 @@
 /**
- * CoreEngine 执行错误归一化工具。
+ * ModelFailure：模型调用错误归一化。
  *
  * 关键点（中文）
  * - 模型流的最终错误可能只是兜底包装，底层 Provider 错误应优先保留。
- * - Executor 内部 CoreEngine 流程只需要消费这里输出的日志字段与最终错误文本。
+ * - 执行器只需要消费这里输出的日志字段与最终错误文本。
  */
 import type { JsonObject } from "@downcity/type";
 /**
@@ -13,7 +13,7 @@ export declare function summarize_stream_error(error: unknown): JsonObject;
 /**
  * 提取实际应返回给上层的错误文本。
  */
-export declare function resolve_effective_core_engine_error(params: {
+export declare function resolve_model_error(params: {
     /**
      * 外层捕获到的执行错误。
      */
@@ -23,4 +23,4 @@ export declare function resolve_effective_core_engine_error(params: {
      */
     streamError?: unknown;
 }): string;
-//# sourceMappingURL=CoreEngineError.d.ts.map
+//# sourceMappingURL=ModelFailure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModelFailure.d.ts","sourceRoot":"","sources":["../../../src/session/runner/ModelFailure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,MAAM,CAOT"}

package/bin/{executor/core-engine/CoreEngineError.js → session/runner/ModelFailure.js}

@@ -1,9 +1,9 @@
 /**
- * CoreEngine 执行错误归一化工具。
+ * ModelFailure：模型调用错误归一化。
  *
  * 关键点（中文）
  * - 模型流的最终错误可能只是兜底包装，底层 Provider 错误应优先保留。
- * - Executor 内部 CoreEngine 流程只需要消费这里输出的日志字段与最终错误文本。
+ * - 执行器只需要消费这里输出的日志字段与最终错误文本。
  */
 /**
  * 归一化 stream 错误日志字段。
@@ -23,7 +23,7 @@ export function summarize_stream_error(error) {
 /**
  * 提取实际应返回给上层的错误文本。
  */
-export function resolve_effective_core_engine_error(params) {
+export function resolve_model_error(params) {
     const outerError = read_error_message(params.error);
     const innerError = read_error_message(params.streamError);
     if (/AI_NoOutputGeneratedError|No output generated/i.test(outerError) && innerError) {
@@ -37,4 +37,4 @@ function read_error_message(error) {
         return error.message.trim();
     return String(error ?? "").trim();
 }
-//# sourceMappingURL=CoreEngineError.js.map
+//# sourceMappingURL=ModelFailure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModelFailure.js","sourceRoot":"","sources":["../../../src/session/runner/ModelFailure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,MAAM,GACV,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzD,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;QACpB,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1D,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACnE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MASnC;IACC,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,gDAAgD,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,EAAE,CAAC;QACpF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,IAAI,UAAU,IAAI,yBAAyB,CAAC;AAC/D,CAAC;AAED,4CAA4C;AAC5C,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACxD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,108 @@
+/**
+ * SessionExecutor：核心模型请求与 tool-loop 执行器。
+ *
+ * 关键点（中文）
+ * - 只回答「发请求」与「是否继续」：step 循环、续写恢复、撞顶收尾与最终汇总。
+ * - 每个 Provider Step 的输入通过 `resolve_step_input` 回调取得，因此执行器不依赖
+ *   Composer 或存储，可以被独立构造与验证。
+ * - 不持有历史副本，也不修改 canonical Message。
+ */
+import type { SessionContextAdvanceTrigger } from "../../types/session/SessionComposer.js";
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { SessionTurnContext } from "../../types/turn/SessionTurnContext.js";
+import type { SessionStepExecutionInput, SessionTurnExecutionResult } from "../../types/session/SessionExecution.js";
+/** 已经停止的 Turn 不再产出模型请求。 */
+export interface SessionExecutorOptions {
+    /** 当前 Session 稳定标识。 */
+    session_id: string;
+    /**
+     * 当前 session 统一日志器。
+     */
+    logger: Logger;
+    /** 判断模型调用错误是否属于 Provider 上下文超限。 */
+    is_context_limit: (error: unknown) => boolean;
+    /**
+     * Provider 上下文超限时推进派生上下文。
+     *
+     * 关键点（中文）：返回 true 表示已有效推进，可以重试整轮。
+     */
+    advance_context: (trigger: SessionContextAdvanceTrigger) => Promise<boolean>;
+}
+/**
+ * 一次 Turn 执行输入。
+ */
+export interface SessionExecutorInput {
+    /**
+     * 当前显式运行上下文。
+     */
+    turn_context: SessionTurnContext;
+    /**
+     * 在统一输入队列提交后按当前推进次数解析本 Step 输入。
+     */
+    resolve_step_input: (advance_count: number) => Promise<SessionStepExecutionInput>;
+}
+/**
+ * SessionLoop 依赖的执行器端口。
+ *
+ * 关键点（中文）：`SessionLoop` 只要求「能执行一轮并报告是否正在执行」；默认实现是
+ * `SessionExecutor`，测试或自定义运行时可注入等价实现。
+ */
+export interface SessionExecutorPort {
+    /** 执行一轮已经由调用方创建上下文的 Turn。 */
+    execute(input: SessionExecutorInput): Promise<SessionTurnExecutionResult>;
+    /** 返回当前是否正在执行。 */
+    is_executing(): boolean;
+}
+/** 核心模型请求与 tool-loop 执行器。 */
+export declare class SessionExecutor implements SessionExecutorPort {
+    private readonly session_id;
+    private readonly logger;
+    private readonly is_context_limit;
+    private readonly context_retry;
+    private executing;
+    constructor(options: SessionExecutorOptions);
+    /** 返回当前 Session 是否正在执行模型请求。 */
+    is_executing(): boolean;
+    /**
+     * 执行一次已装配完成的模型/tool-loop 运行。
+     *
+     * 关键点（中文）
+     * - 同一个 Session 只允许一个活跃执行，避免 step 回调与运行态互相污染。
+     * - Provider 拒绝上下文超限时，先推进派生上下文再重试整轮。
+     */
+    execute(input: SessionExecutorInput): Promise<SessionTurnExecutionResult>;
+    /** 运行模型与 tool-loop 主循环。 */
+    private run_tool_loop;
+    /**
+     * 构造 Turn 执行结果。
+     *
+     * 关键点（中文）：`compact_required` 是「本轮结束后是否需要在 Turn 收口后推进上下文」，
+     * 只在真正需要时为 true，避免上层产生空操作。
+     */
+    private build_result;
+    /**
+     * 执行一次 Provider Step，并把 canonical 输出写回 Session。
+     *
+     * 关键点（中文）
+     * - 正常 tool-loop 与撞顶收尾共用这一条 Step 路径，落盘顺序完全一致。
+     * - 只负责单个 Step；循环决策、计数器与最终 Parts 合并仍由调用方拥有。
+     */
+    private execute_provider_step;
+    /**
+     * 达到工具循环上限后，要求模型在禁用工具的前提下给出收尾结论。
+     *
+     * 关键点（中文）
+     * - 收尾提示先持久化为 internal canonical User Message，不绕过 Composer 注入运行时输入。
+     * - 收尾 Step 仍走统一模型请求重试与上下文压缩恢复，真实 Provider 错误不会被吞掉。
+     * - 只执行一次；收尾仍无正文时由调用方按明确失败收口。
+     */
+    private execute_max_steps_finalization;
+}
+/**
+ * 识别 Provider 拒绝请求是出于模型上下文超限的默认谓词。
+ *
+ * 关键点（中文）：Provider 错误是否属于上下文超限只在这里识别一次，外层恢复策略
+ * 只接收领域触发原因。
+ */
+export declare function is_provider_context_limit_error(error: unknown): boolean;
+//# sourceMappingURL=SessionExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionExecutor.d.ts","sourceRoot":"","sources":["../../../src/session/runner/SessionExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAO7C,2BAA2B;AAC3B,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAE9C;;;;OAIG;IACH,eAAe,EAAE,CACf,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,YAAY,EAAE,kBAAkB,CAAC;IAEjC;;OAEG;IACH,kBAAkB,EAAE,CAClB,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC1E,kBAAkB;IAClB,YAAY,IAAI,OAAO,CAAC;CACzB;AAED,6BAA6B;AAC7B,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6C;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,sBAAsB;IAiB3C,+BAA+B;IAC/B,YAAY,IAAI,OAAO;IAIvB;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAmB/E,2BAA2B;YACb,aAAa;IAoQ3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;;;OAMG;YACW,qBAAqB;IA2FnC;;;;;;;OAOG;YACW,8BAA8B;CAwC7C;AAeD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMvE"}