@ai-setting/roy-agent-core 1.7.65 → 1.7.67

package/dist/env/task/plugins/index.js

@@ -13,12 +13,13 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-f6c0nadn.js";
+} from "../../../shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../../shared/@ai-setting/roy-agent-core-9bs6xrav.js";
+import"../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
+import"../../../shared/@ai-setting/roy-agent-core-ma35jyd9.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
 import {
   DEFAULT_APP_LINK_BASE,
   LarkCardPatchNotifier,

package/dist/env/task/plugins/laya-completion-plugin.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Task #4760 — task completion hook 的 Laya decision 判定
+ *
+ * 与 create 侧（`laya-decision-plugin.ts`，#4620）的关系：
+ *   - create 侧挂在 `task:before.create`，判「新建 vs 复用」
+ *   - 本插件挂在 `task:after.complete`（AFTER_COMPLETE），判
+ *     「目标 vs 交付物 match / 目标是否达成 / 交付物是否产出」
+ *
+ * 形态：**只提示，不拦截**（与 create 侧契约一致）。
+ *   AFTER_COMPLETE 触发时任务**已经**是 completed —— hint 只能
+ *   ① 追加写进 `task.context.completion_hint`（走 updateTask）
+ *   ② 落一条 operation 记录
+ *   绝不能阻断已完成状态、绝不能抛错。
+ *
+ * ── fail-open 六场景（对齐 create 侧 #4620） ─────────────────────
+ *   1. 未配置 provider（auth.json 缺失 / 无 laya-goal-decision）→ 不调模型
+ *   2. auth 损坏 / port 抛错（网络、超时）→ 静默
+ *   3. 响应畸形（无 answers / 无 answer）→ 静默
+ *   4. 置信度 < 0.92 → 不写 hint
+ *   5. operation chain 空 → 不调模型
+ *   6. choice 无法识别 → 静默
+ *
+ * ── provider 分离（Task #4804） ────────────────────────────────
+ *   completion hook 读 `providers["laya-goal-decision"]`
+ *   （model=task-completion / v13e ckpt，判「目标 vs 交付物」）；
+ *   create hook 继续读 `providers["laya-decision"]`
+ *   （model=task-decision / v3-tags，判「新建 vs 复用」）。
+ *   goal 专用 provider 缺失时保守回退 laya-decision（fail-open 不变）。
+ *
+ * ── 泄漏断言 ─────────────────────────────────────────────────────
+ *   deny-list 含 decision/hint/target/answer 等键名 →
+ *   question key 必须命名 `completion_check`、criteria 用
+ *   `PASS_COMPLETED/FAIL_INCOMPLETE`（已验证不命中）；
+ *   state 用中文文本形态（【】段）则天然无对象键。
+ *
+ * ── 时序关键（勘查结论） ─────────────────────────────────────────
+ *   AFTER_COMPLETE 触发时 `completed` operation 尚未写入
+ *   （completeTask 在 hook 之后才 createOperation）。
+ *   因此 operation chain 里看到的是「完成前的历史记录」——
+ *   这正是判定所需的证据链，无需等 completed 记录。
+ */
+import type { DecisionPort } from "./decision-port";
+import type { TaskCompleteResultContext } from "../hooks/contexts";
+import type { Task, TaskOperation } from "../types";
+/** 完成判定的置信度门禁（对齐 create 侧 LAYA_REUSE_THRESHOLD = 0.92） */
+export declare const LAYA_COMPLETION_THRESHOLD = 0.92;
+/**
+ * 构造完成核验 hint。
+ *
+ * 核实义务 + 二选一：(a) 确认未完成 → 重开继续推进；
+ * (b) 确认已完成 → 落 operation 说明理由。不允许无视。
+ */
+export declare function buildCompletionHint(task: Task, confidence: number): string;
+/**
+ * 渲染 laya 训练格式的中文文本 state。
+ *
+ * ⚠️ 用【】段而非 JSON 对象 —— laya 模型在中文文本形态上训练；
+ *   且文本形态天然没有对象键，不会命中泄漏断言的 deny-list。
+ *
+ * Task #4804 — goals 为编号子项且交付物声明可比对时，插入
+ * 【逐条对照】段（见 renderCriteriaChecklist 注释）。
+ */
+export declare function renderCompletionState(task: Task, ops: TaskOperation[]): string;
+/** 渲染 completion_check 二选一 question（key 不命中泄漏 deny-list） */
+export declare function buildCompletionQuestion(): Record<string, unknown>;
+export interface LayaCompletionPluginOptions {
+    /** auth.json 路径（默认 ~/.roy-agent/auth.json） */
+    authPath?: string;
+    /** 硬超时（默认 2000ms） */
+    timeoutMs?: number;
+    /** 连续超时多少次后自我禁用（默认 3） */
+    maxStrikes?: number;
+    /** 注入 port（测试用；给了就不读 auth.json） */
+    decisionPort?: DecisionPort;
+    /** 完成判定的置信度门禁（默认 0.92） */
+    completionThreshold?: number;
+}
+export declare class LayaCompletionPlugin {
+    readonly name = "laya-completion";
+    readonly version = "1.0.0";
+    readonly description = "Task #4760 \u2014 task:after.complete \u5B8C\u6210\u5224\u5B9A\uFF08\u76EE\u6807/\u4EA4\u4ED8\u7269 match\uFF0C\u53EA\u63D0\u793A\u4E0D\u62E6\u622A\uFF09";
+    private readonly options;
+    private port;
+    private portResolved;
+    constructor(options?: LayaCompletionPluginOptions);
+    /** 当前是否已自我禁用（熔断）—— 供观测 */
+    isDisabled(): boolean;
+    /** 懒加载 + 缓存 port（读 auth.json 只做一次） */
+    private resolvePort;
+    /**
+     * hook 入口 —— **永不抛**。
+     *
+     * @param ctx   TaskCompleteResultContext（或框架 HookContext，载荷在 .data）
+     * @param taskComponent TaskComponent（只读用：listOperations / getTask；
+     *                      写 hint 用 updateTask + createOperation）
+     */
+    execute(ctx: TaskCompleteResultContext | {
+        data: TaskCompleteResultContext;
+    }, taskComponent: any): Promise<void>;
+    private run;
+    /** hint 回写：追加 context.completion_hint + 落 operation 记录（都不阻断） */
+    private writeHint;
+}
+/**
+ * Task #4760 — 把 LayaCompletionPlugin 包成可注册到 task hook 的形态。
+ *
+ * 注册方式仿 `registerLayaDecisionTaskHook`（environment.ts:87）：
+ *   - unregister + register 幂等（globalHookManager.register 是 push）
+ *   - fail-open：注册失败绝不影响 agent 启动
+ *   - hook-manager `safeExecute` 自带异常隔离（hook 抛错只记日志）
+ */
+export declare function createLayaCompletionPlugin(options?: LayaCompletionPluginOptions): {
+    /** Hook 唯一名称（用于幂等去重 / unregister） */
+    name: string;
+    /** 执行优先级 */
+    priority: number;
+    /** hook 执行体 —— 永不抛 */
+    execute: (ctx: unknown) => Promise<void>;
+    /** 内层插件实例（供观测 / 测试） */
+    plugin: LayaCompletionPlugin;
+};
+/**
+ * 把 LayaCompletionPlugin 注册到 `task:after.complete`（AFTER_COMPLETE）。
+ *
+ * ⚠️ 幂等：先 unregister 再 register，保证全局恰好 1 份。
+ * ⚠️ fail-open：注册失败返回 false，不影响调用方。
+ *
+ * @param taskComponent TaskComponent（由 this.getComponent("task") 取得）
+ * @param options LayaCompletionPluginOptions（生产不传 → 读 auth.json；
+ *                测试可注入 decisionPort）
+ * @returns 是否成功注册
+ */
+export declare function registerLayaCompletionTaskHook(taskComponent: any | undefined | null, options?: LayaCompletionPluginOptions): boolean;

package/dist/env/task/plugins/laya-port.d.ts

@@ -131,6 +131,17 @@ export interface LayaAuthConfig {
     apiKey: string;
     model: string;
 }
+/**
+ * Task #4804 — provider 名常量（provider 分离）：
+ *   - create hook（task:before.create，判新建 vs 复用）→ laya-decision
+ *   - completion hook（task:after.complete，判目标 vs 交付物）→ laya-goal-decision
+ *     （缺失时保守回退 laya-decision —— fail-open 语义不变）
+ */
+export declare const LAYA_DECISION_PROVIDER = "laya-decision";
+export declare const LAYA_GOAL_DECISION_PROVIDER = "laya-goal-decision";
+/** hook 用途 → provider 名（Task #4804 provider 分离的唯一映射点） */
+export type LayaHookPurpose = "create" | "goal";
+export declare function providerNameForPurpose(purpose: LayaHookPurpose): string;
 /**
  * 从 `~/.roy-agent/auth.json` 的 `providers["laya-decision"]` 读取端点配置。
  *
@@ -139,5 +150,17 @@ export interface LayaAuthConfig {
  *                                  → providers["laya-decision"].model（可选）
  *
  * ⚠️ 读不到就返回 null —— 调用方必须 fail-open（不提示、不报错）。
+ *
+ * Task #4804 — 向后兼容：默认仍读 laya-decision（create hook 语义）。
+ *   completion hook 侧请用 `loadLayaAuthForPurpose(path, "goal")`。
  */
 export declare function loadLayaAuth(authPath?: string): Promise<LayaAuthConfig | null>;
+/**
+ * Task #4804 — 按用途读 provider：
+ *   - "create" → providers["laya-decision"]
+ *   - "goal"   → providers["laya-goal-decision"]，缺失时保守回退
+ *                providers["laya-decision"]（共享共享配置，fail-open 不变）
+ *
+ * ⚠️ 读不到就返回 null —— 调用方必须 fail-open（不提示、不报错）。
+ */
+export declare function loadLayaAuthForPurpose(authPath?: string, purpose?: LayaHookPurpose): Promise<LayaAuthConfig | null>;

package/dist/env/task/storage/index.js

@@ -1,9 +1,9 @@
-import"../../../shared/@ai-setting/roy-agent-core-gxzxq1sf.js";
+import"../../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-9bs6xrav.js";
+} from "../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";

package/dist/env/task/storage/migrations/003_add_process_description.d.ts

@@ -5,7 +5,7 @@
  * Description: Add process_description column to task_operation table.
  *              用于记录达成节点状态所采用的策略 + 工具步骤的过程概要，
  *              区别于 action_description（状态/结果描述）。
- *              字符范围 100-150（应用层 schema 校验，本字段不做 DB 长度约束）。
+ *              字符范围 100-500（Task #4764 放宽；应用层 schema 校验，本字段不做 DB 长度约束）。
  * Date: 2026-07-20
  */
 /**

package/dist/env/task/storage/migrations/log-migration.d.ts

@@ -12,8 +12,54 @@
  * Measured: the plugin's MCP server emitted **24 of 26 stdout lines** that
  * were not JSON — 5 migration banners plus core's `[INFO]` trace lines.
  *
- * So migration output goes to **stderr**, always. It is diagnostics, not
- * protocol.
+ * ## Task #4721 — 为什么不写 stderr（而是走 logger）
+ *
+ * #4619 把 stdout 换成 stderr，问题在 **TUI 场景**（`roy-agent interactive`）
+ * 暴露了：stderr **同样**是终端输出，而 opentui 只拦截 stdout
+ * （`@opentui/core` 的 `interceptStdoutWrite`），stderr 完全不捕获 ⇒ 迁移
+ * 日志直接落到终端当前光标位置。
+ *
+ * `roy-agent interactive` 是 split-footer 模式 ⇒ 当前光标在**动态区**里 ⇒
+ * 日志与 TUI 重绘**逐字符交错** ⇒ 用户看到底部乱流（截图实证）：
+ *
+ * ```
+ * └ig-ati-n 003─ -tarting mig-ati─
+ * ⋮ Generating response…e_type already exists, skipping rename of action_type
+ * ```
+ *
+ * ⇒ **正确做法：走 logger**（core 的统一日志通路）：
+ *   - 永远写日志文件（app.log）⇒ 诊断信息不丢
+ *   - console 输出受 `isQuietMode()` / `isStdoutStrictMode()` 控制
+ *     —— TUI 场景 quiet 模式开启 ⇒ 不写终端；MCP 场景 stdout 严格模式
+ *     ⇒ 走 stderr（诊断通道，符合 MCP 惯例）
+ *   - **stdout 永远纯净**（MCP JSON-RPC 协议不被破坏）
+ */
+/**
+ * Print one migration diagnostic.
+ *
+ * ⚠️ **不要**改回 `process.stderr.write` / `console.log`：
+ *   - `console.log` 会破坏 MCP stdio 的 JSON-RPC 协议（#4619）
+ *   - `process.stderr.write` 会撞 TUI 的动态区（#4721 底部乱流）
+ *
+ * 走 logger：写文件 + 受 quiet/stdout-strict 模式控制的 console 输出。
+ *
+ * ## Task #4721（交叉验证 MAJOR-3）：为什么用 `warn` 而不是 `info`
+ *
+ * core 的 `Logger.log()` 在**非 quiet**模式下会把日志打到 console：
+ *
+ * ```ts
+ * if (!isQuietMode()) {
+ *   if (stdoutStrictMode) { console.error(formatted); }   // ← stderr
+ *   else { consoleMethod(formatted); }                     // ← **stdout**（info/warn）
+ * }
+ * ```
+ *
+ * ⚠️ `setStdoutStrictMode(true)` 在**生产路径从未被调用**（只��测试里调）⇒
+ *   MCP 场景下 `stdoutStrictMode` 恒为 false ⇒ **`info` 级日志会打到 stdout**
+ *   ⇒ **破坏 MCP 的 JSON-RPC 协议**（#4619 的问题被重新引入）。
+ *
+ * ⇒ 用 `warn` 级：非 strict 模式下走 `console.warn`（Bun 的 `console.warn`
+ *   写 **stderr**，不会污染 stdout）⇒ stdout 永远纯净 ✔
+ *   而 strict 模式下走 `console.error`（stderr）⇒ 同样是诊断通道 ✔
  */
-/** Print one migration diagnostic to stderr (never stdout). */
 export declare function logMigration(message: string): void;

package/dist/env/task/task-component.d.ts

@@ -41,6 +41,21 @@ export interface TaskComponentOptions {
     envPrefix?: string;
     /** 直接传入的配置对象（可选，优先级最高） */
     config?: Partial<TaskConfig>;
+    /**
+     * Task #4794 — 组件 stop() 时 BackgroundTaskManager.dispose() 的收尾行为。
+     *
+     * CLI `act` 一次性命令收尾时传 true（主 run 已结束，后台子 agent
+     * 是有意留下继续跑的）；REPL / ESC cascade 等用户主动退出场景
+     * 保持默认 false（abort 全部，语义不变）。
+     */
+    skipAbortRunningTasksOnDispose?: boolean;
+    /**
+     * Task #4794 — 与 skipAbortRunningTasksOnDispose 配套：
+     * stop() 时等待运行中的后台任务完成后再返回。
+     * 子 agent 是同进程异步 run，进程 exit 会直接杀死它们，
+     * 所以 act 收尾必须等待。默认 false。
+     */
+    waitForRunningTasksOnDispose?: boolean;
 }
 export declare class TaskComponent extends BaseComponent {
     name: string;
@@ -49,6 +64,17 @@ export declare class TaskComponent extends BaseComponent {
     private config?;
     private toolComponent?;
     private backgroundTaskManager?;
+    /**
+     * Task #4794 — stop() 时是否跳过 abort 仍在运行的后台任务
+     * （act 一次性命令收尾 = true；用户主动退出 = false 默认）。
+     */
+    private skipAbortRunningTasksOnDispose;
+    /**
+     * Task #4794 — stop() 时是否等待运行中任务完成
+     * （act 收尾配套：跳过 abort 后必须等子 agent 跑完，
+     * 否则 process.exit 仍会杀死同进程子 agent）。
+     */
+    private waitForRunningTasksOnDispose;
     private configComponent?;
     private tagService;
     private plugins;
@@ -235,6 +261,23 @@ export declare class TaskComponent extends BaseComponent {
      * @returns 更新后的 Task 或 undefined
      */
     completeTask(id: number, sessionId: string, deliverableStoragePath?: string): Promise<Task | undefined>;
+    /**
+     * 直接更新任务 context（不触发 BEFORE/AFTER_UPDATE hook、不发事件）
+     *
+     * ★ Task #4776 review MINOR-1：AFTER_COMPLETE hook 内的嵌套
+     *   updateTask({context}) 会二次 fire AFTER_UPDATE，把订阅者
+     *   （LarkCliTaskNotifyHook 等）无谓拉起 —— 终态任务被再次走
+     *   cardStatusOf 终态路径。hint 回写这类「内部簿记」不应有通知副作用，
+     *   因此提供本方法绕过 hook 链，直接走 store 层。
+     *
+     * 语义与 updateTask({context}) 完全一致：整份覆盖 context 字段。
+     * 调用方负责自己 merge 既有字段（不要拿快照整份覆盖别人写的内容）。
+     *
+     * @param id 任务 ID
+     * @param context 新的 context JSON 字符串（整份覆盖）
+     * @returns 更新后的 Task，任务不存在时返回 undefined
+     */
+    updateTaskContext(id: number, context: string): Promise<Task | undefined>;
     /**
      * Create operation record
      */

package/dist/env/task/tools/completion-copy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Task #4834 — F3: task_complete 验收文案同源锚点
+ *
+ * 背景（reports/goals-criteria-rules-e2e-rebase.md §遗留 F3）：
+ *   prompts-index.ts 的 COMPLETE 生命周期步骤与工具描述
+ *   （TASK_COMPLETE_DESCRIPTION）**不同源** —— 文案漂移会
+ *   稀释工具描述的遵循度。
+ *
+ * 方案：三个关键短语定义于此，complete-tool 与
+ * prompts-index（default prompt）都引用同一常量，
+ * 文案一致性由 completion-copy-consistency.test.ts 守住。
+ *
+ * ⚠️ 本模块必须保持**零依赖**（不 import 任何其他模块），
+ *   以便 prompts-index（超大模板串）与 tools 层都能安全引用。
+ */
+/** 逐条验收短语（工具描述 / default prompt 共用） */
+export declare const TASK_COMPLETE_ITEM_BY_ITEM = "\u6309\u5B50\u9879\u9010\u6761\u9A8C\u6536";
+/** hint 锚点 token（completion hook 写入 task context 的标记） */
+export declare const TASK_COMPLETION_HINT_ANCHOR = "TASK_COMPLETION_HINT";
+/** 核实义务短语（收到 hint 后必须核实，二选一） */
+export declare const TASK_COMPLETE_VERIFY_DUTY = "\u6838\u5B9E\u4E49\u52A1";
+/** F3 同源文案集合（聚合导出，便于测试解构） */
+export declare const TASK_COMPLETE_ACCEPTANCE: {
+    readonly itemByItem: "按子项逐条验收";
+    readonly hintAnchor: "TASK_COMPLETION_HINT";
+    readonly verifyDuty: "核实义务";
+};

package/dist/env/task/tools/index.js

@@ -9,8 +9,9 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-t0ktaevq.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h5vmff8w.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
 import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";

package/dist/env/task/tools/operation/create-tool.d.ts

@@ -3,7 +3,7 @@
  *
  * 双维度：
  * - milestone_* 三字段描述达成的状态/里程碑
- * - process_description 描述达成过程（100-150 字符硬约束）
+ * - process_description 描述达成过程（100-500 字符硬约束，Task #4764 放宽）
  *
  * 兼容：action_* 自动映射到 milestone_* 并通过返回 _deprecated_warning 提示。
  */

package/dist/env/task/tools/operation/index.js

@@ -4,7 +4,7 @@ import {
   getOperationTool,
   listOperationsTool,
   updateOperationTool
-} from "../../../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
+} from "../../../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import"../../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   updateOperationTool,

package/dist/env/task/tools/operation/operation-types.d.ts

@@ -3,7 +3,7 @@
  *
  * 设计目标：
  * - **状态/里程碑维度**（"达到什么"）：milestone_type / milestone_title / milestone_description
- * - **过程维度**（"如何达到"）：process_description（100-150 字符硬约束，保留 task #2203 约定）
+ * - **过程维度**（"如何达到"）：process_description（100-500 字符硬约束，Task #4764 放宽）
  *
  * 兼容：
  * - action_type / action_title / action_description 通过 z.preprocess 自动映射到 milestone_*
@@ -22,17 +22,19 @@ export { ActionTypeEnum };
  * - milestone_description：达成状态/结果的描述（保留原义，可长可短）
  * - process_description：采取了什么策略 + 工具步骤达成的过程概要
  *
- * 硬约束：100-150 字符。
+ * 硬约束：100-500 字符（Task #4764 放宽，原 100-150）。
  * - 太短（<100）= 没价值，不算过程概要
- * - 太长（>150）= 退化为日志细节，违背 milestone 摘要设计
- * - 完整细节应通过 sessionId 回查 session 历史
+ * - 太长（>500）= 退化为日志细节，违背 milestone 摘要设计
+ * - 放宽理由（Task #4764）：150 字符装不下「里程碑 + 达成操作」的完整过程，
+ *   agent 需要在执行中「边做边记」（记录刚做的操作 + 为什么），500 字符
+ *   足够表达且仍不是日志；完整细节仍应通过 sessionId 回查 session 历史。
  *
  * 失败模式：
  * - < 100：拒绝（提供有意义的 process_description 才是该字段的本职）
- * - > 150：拒绝（防止字段膨胀，保持 milestone 摘要克制）
+ * - > 500：拒绝（防止字段膨胀，保持 milestone 摘要克制）
  */
 export declare const PROCESS_DESCRIPTION_MIN_LENGTH = 100;
-export declare const PROCESS_DESCRIPTION_MAX_LENGTH = 150;
+export declare const PROCESS_DESCRIPTION_MAX_LENGTH = 500;
 /**
  * Milestone description (状态/结果描述) — 长度上限保留宽松（与历史 action_description 一致）。
  */
@@ -45,7 +47,7 @@ export declare const MILESTONE_TITLE_MAX_LENGTH = 200;
 /**
  * process_description 字段校验
  * - 可选（向后兼容）
- * - 长度严格 100-150 字符
+ * - 长度严格 100-500 字符（Task #4764 放宽）
  */
 export declare const ProcessDescriptionSchema: z.ZodString;
 /**
@@ -65,7 +67,7 @@ export declare const MilestoneDescriptionSchema: z.ZodOptional<z.ZodString>;
  *
  * 双维度规范：
  * - milestone_* 字段描述达成的状态/结果
- * - process_description 描述达成过程（100-150 字符）
+ * - process_description 描述达成过程（100-500 字符）
  * - action_* 字段作为兼容窗口期别名
  */
 export declare const CreateOperationToolSchema: z.ZodEffects<z.ZodObject<{

package/dist/env/task/types.d.ts

@@ -60,7 +60,7 @@ export interface Task {
  *    - `milestoneDescription`: 达成状态/结果描述
  *
  * 2. **过程维度**（"如何达到"）：
- *    - `processDescription`: 过程概要（采取的策略 + 工具步骤概要，100-150 字符）
+ *    - `processDescription`: 过程概要（采取的策略 + 工具步骤概要，100-500 字符）
  *
  * ⚠️ **不要把 action 当状态**，也不要让 process 与 milestone_description 重复。
  *
@@ -85,7 +85,7 @@ export interface TaskOperation {
      * 过程概要：采取了什么策略 + 工具步骤达成的概要描述。
      *
      * 设计哲学：操作记录只承担节点阶段 milestone 摘要。
-     * 字符范围硬约束 100-150，应用层 schema 校验。
+     * 字符范围硬约束 100-500（Task #4764 放宽），应用层 schema 校验。
      * 完整过程通过 sessionId 回查 session。
      */
     processDescription: string;
@@ -213,7 +213,7 @@ export interface CreateOperationOptions {
     /** 里程碑描述/状态/结果（主命名，替代旧 actionDescription） */
     milestoneDescription?: string;
     /**
-     * 过程概要（采取的策略 + 工具步骤），可选；如提供，应用层会校验 100-150 字符。
+     * 过程概要（采取的策略 + 工具步骤），可选；如提供，应用层会校验 100-500 字符。
      * 字符范围外会由 tool schema 拒绝（不在 DB 层强约束）。
      */
     processDescription?: string;

package/dist/env/tool/built-in/index.js

@@ -8,7 +8,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-jz8dsypm.js";
+} from "../../../shared/@ai-setting/roy-agent-core-kpg25s2q.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -18,7 +18,7 @@ import {
 import {
   createQueryBackgroundProcessTool,
   queryBackgroundProcessTool
-} from "../../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
+} from "../../../shared/@ai-setting/roy-agent-core-58804s3j.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";

package/dist/env/tool/built-in/query-background-process-tool.d.ts

@@ -56,6 +56,16 @@ export interface QueryBackgroundProcessOutput {
     lastUpdatedAt: number;
     /** 任务描述（not_found 时为 undefined） */
     description?: string;
+    /**
+     * ★ Task #4720：sub-session 当前已落盘的消息条数。
+     * 仅在任务仍 alive 且能读到 sub-session 时提供；用于判断「真的在产出」。
+     */
+    messageCount?: number;
+    /**
+     * ★ Task #4720：sub-session 的最后更新时间戳（毫秒）。
+     * 每轮 ReAct 迭代都会推进（配合增量落盘），是比 20 分钟心跳更细的活跃度信号。
+     */
+    subSessionUpdatedAt?: number;
     /** 已完成 / 失败 / 停止时的结果 */
     result?: string;
     /** 失败时的错误信息 */

package/dist/env/tool/index.js

@@ -10,14 +10,14 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-jz8dsypm.js";
+} from "../../shared/@ai-setting/roy-agent-core-kpg25s2q.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
   setUnderstandImageLLMProvider,
   understandImageTool
 } from "../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
-import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
+import"../../shared/@ai-setting/roy-agent-core-58804s3j.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import {
   ToolComponent,
@@ -25,7 +25,7 @@ import {
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-es467wsz.js";
+} from "../../shared/@ai-setting/roy-agent-core-dt104qa1.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";

package/dist/env/tool/types.d.ts

@@ -69,6 +69,12 @@ export interface ToolContext {
      * 主模型调用失败（404 / 429 / 配额 / 5xx / 超时 / 重试耗尽）时自动切换。
      */
     fallbackModel?: string;
+    /**
+     * Task #4724 — 兜底模型**有序列表**（`providerId/modelId`），顺序 = 优先级。
+     *
+     * 主模型失败时按顺序逐个尝试，全部失败才报错。
+     */
+    fallbackModels?: string[];
     /** 额外元数据 */
     metadata?: Record<string, unknown>;
     /** 沙箱配置 */