@ai-setting/roy-agent-core 1.7.72 → 1.7.76

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

@@ -87,7 +87,7 @@ export type GetTaskToolParams = z.infer<typeof GetTaskToolSchema>;
  * task_list tool parameters
  */
 export declare const ListTasksToolSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -99,12 +99,12 @@ export declare const ListTasksToolSchema: z.ZodObject<{
     offset: number;
     include_archived: boolean;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     depth?: number | undefined;
 }, {
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
@@ -119,7 +119,7 @@ export declare const SearchTasksToolSchema: z.ZodObject<{
     keywords: z.ZodArray<z.ZodString, "many">;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     exclude_task_id: z.ZodOptional<z.ZodNumber>;
@@ -131,14 +131,14 @@ export declare const SearchTasksToolSchema: z.ZodObject<{
     include_archived: boolean;
     keywords: string[];
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     depth?: number | undefined;
     exclude_task_id?: number | undefined;
 }, {
     keywords: string[];
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
@@ -155,7 +155,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 } & {
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     progress: z.ZodOptional<z.ZodNumber>;
@@ -169,7 +169,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -184,7 +184,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -199,7 +199,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -228,26 +228,80 @@ export type DeleteTaskToolParams = z.infer<typeof DeleteTaskToolSchema>;
  * task_complete tool parameters
  *
  * Task #2778: 新增 deliverable_storage_path 参数。
- * 调用方在完成任务时，应提供实际交付物的寻址地址，便于后续追溯。
+ * Task #5073 设计调整① — task_complete 精简为**纯验收动作**：
  *
- * 支持任意形式的寻址：本地文件路径 / 飞书 doc URL / git 分支名 / GitHub PR/commit URL。
- * 该参数会持久化到 task.context.deliverable_storage_path。
+ *   deliverable_storage_path 入参已删除（用户 2026-11-06 明令）。
+ *   交付物在 pre_complete 阶段（task_pre_complete）提交落库
+ *   （task.context.deliverable_storage_path + operation Deliverable 行），
+ *   task_complete 只做状态修改验收：逐条核对 goals 子项后
+ *   把 to_validate → completed（TASK_COMPLETION_TERMINAL）。
+ *
+ *   ⚠️ 交付物通道 = task_pre_complete，验收通道 = task_complete ——
+ *     两者职责分离后，交付物参数不该再出现在 complete 的 schema 里。
+ *
+ *   兼容性：unknown-key 被 zod 静默剥离（withLegacyTaskId 的 object
+ *   不含 additionalProperties:false）→ 老调用方传了 deliverable 也
+ *   不报错，只是不再被读取。CLI / TaskStoreBackend（MCP 通道）的
+ *   completeTask(deliverable) 底层签名保留（#5060 修复链不破坏）。
  */
 export declare const CompleteTaskToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+}, {
+    task_id: number;
+}>, {
+    task_id: number;
+}, unknown>;
+export type CompleteTaskToolParams = z.infer<typeof CompleteTaskToolSchema>;
+/**
+ * task_pre_complete tool parameters (Task #5073 — 两阶段验收)
+ *
+ * sub-agent 交付时调用：把任务置为 to_validate（待验证），
+ * 交付物参数与 task_complete 完全同构（deliverable_storage_path），
+ * 让执行方「提交待验证」的调用体验与验收方「落终态」一致。
+ */
+export declare const PreCompleteTaskToolSchema: z.ZodEffects<z.ZodObject<{
+    task_id: z.ZodNumber;
 } & {
     deliverable_storage_path: z.ZodOptional<z.ZodString>;
+    current_status: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }>, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }, unknown>;
-export type CompleteTaskToolParams = z.infer<typeof CompleteTaskToolSchema>;
+export type PreCompleteTaskToolParams = z.infer<typeof PreCompleteTaskToolSchema>;
+/**
+ * task_cancel tool parameters (Task #5007)
+ *
+ * 取消 Task 本身（status = "cancelled"）。
+ * ⚠️ 与 `stop_task` 正交：stop_task 停**后台进程**（bg process id），
+ *    task_cancel 停**任务记录**（task id）。需要连用时先 stop_task 再 task_cancel。
+ */
+export declare const CancelTaskToolSchema: z.ZodEffects<z.ZodObject<{
+    task_id: z.ZodNumber;
+} & {
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    reason?: string | undefined;
+}, {
+    task_id: number;
+    reason?: string | undefined;
+}>, {
+    task_id: number;
+    reason?: string | undefined;
+}, unknown>;
+export type CancelTaskToolParams = z.infer<typeof CancelTaskToolSchema>;
 /**
  * task_batch_archive tool parameters
  */
@@ -282,7 +336,7 @@ export type BatchDeleteToolParams = z.infer<typeof BatchDeleteToolSchema>;
 export declare const TreeTasksToolSchema: z.ZodObject<{
     depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     parent_task_id: z.ZodOptional<z.ZodNumber>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -290,12 +344,12 @@ export declare const TreeTasksToolSchema: z.ZodObject<{
     depth: number;
     include_archived: boolean;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     parent_task_id?: number | undefined;
 }, {
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     parent_task_id?: number | undefined;
     depth?: number | undefined;

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

@@ -4,8 +4,20 @@
 import { z } from "zod";
 /**
  * Task status enum
+ *
+ * ★ Task #5073 — 新增 `to_validate`（待验证）。
+ *
+ * 两阶段验收（#5007 的机制化落地）：
+ *   sub-agent 干完 → task_pre_complete → status=to_validate（待验证）
+ *   default agent  → task_complete    → status=completed（正式完成）
+ *
+ * ⚠️ 其余 6 个旧状态（todo/active/completed/paused/cancelled/archived）
+ *   **全部保留** —— 存量库有 paused/cancelled/archived 记录，
+ *   不做状态迁移、不删任何旧值（用户 2026-11-06 明令修正）。
+ *   to_validate 是唯一的**新增**状态，是「非终态」（可被 task_complete
+ *   落成 completed，也可被 reopen 回 active）。
  */
-export declare const TaskStatusEnum: z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>;
+export declare const TaskStatusEnum: z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>;
 export type TaskStatus = z.infer<typeof TaskStatusEnum>;
 /**
  * Task priority enum

package/dist/env/tool/built-in/compact-session-tool.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview compact_session — Default Agent sub-session 压缩工具
+ *
+ * Task #4982 — 用户需求：
+ *   「给 Default agent 添加一个压缩 session 的工具，遇到 sub-agent
+ *   返回上下文超了的问题，可以用这个工具来压缩 sub-session，
+ *   继续复用 session」
+ *
+ * 背景（真实踩坑）：
+ *   Default agent 通过 delegate_task 委托子代理，sub-session 积累大量
+ *   上下文。当 sub-agent 返回 Context threshold exceeded（如
+ *   125575/120000 = 104.6%）时，default agent 只能用
+ *   delegate_task(sub_session_id=...) 续跑 —— 但被污染/过长的
+ *   sub-session 续跑会再次超限。本工具让 default agent 先压缩
+ *   sub-session（生成 checkpoint、归档旧消息），再继续复用。
+ *
+ * 可见性：
+ *   - metadata.allowedAgentTypes: ["default"] — 只对 default 接待员可见
+ *   - 其他 agent（roy / strict-task-agent / explore 等）看不到
+ *
+ * 安全设计（四层）：
+ *   1. deps 未注入 → success=false, error="not initialized"
+ *   2. 压缩当前会话 → success=false（default agent 自毁上下文防线）
+ *   3. session 不存在 / 非自己的 sub-session → status='not_found'
+ *      （不暴露存在性，与 query_background_process 同一哲学）
+ *   4. 后台任务 running/pending → success=false（sub-session 每轮
+ *      ReAct 增量落盘（Task #4720 Fix A），与归档竞态会撕裂任务状态）
+ *
+ * 复用闭环：
+ *   compact_session 压缩后，用
+ *   delegate_task(subagentType=..., sub_session_id=<同 id>, prompt=...) 续跑。
+ *
+ * 注入方式（2026-11-05，与 query_background_process 同模式）：
+ *   - createCompactSessionTool(manager, sessionComponent) 工厂闭包注入
+ *   - TaskComponent.start() 注册 manager-bound 实例；stop() 注销为 null 版本
+ *   - getAllBuiltInTools() 中的默认版本为 null-deps（执行即 not initialized）
+ *
+ * 输出（JSON 字符串）：
+ * {
+ *   status: 'compacted' | 'not_found',
+ *   sessionId: string,
+ *   checkpointId?: string,
+ *   checkpointTitle?: string,
+ *   contentLength?: number,
+ *   originalMessages?: number,   // 压缩前可压缩消息数
+ *   deletedMessages?: number,    // 归档条数
+ *   remainingMessages?: number,  // 归档后剩余活跃消息数
+ *   hintUsed?: boolean,          // phase1 hint 是否注入
+ * }
+ *
+ * 失败行为：
+ *   - manager / sessionComponent 未注入 → success=false
+ *   - zod 参数校验失败 → throw（ToolComponent 捕获）
+ *   - previewCompact / compact 抛错 → success=false, error=原始 message
+ *   - generateCompactHint 抛错 → 容错（hint 为空串，不阻塞压缩）
+ */
+import type { Tool } from "../types";
+import type { BackgroundTaskManager, BackgroundTask } from "../../task/delegate/delegate-tool";
+import type { SessionComponent } from "../../session/session-component";
+/**
+ * 成功压缩的输出
+ */
+export interface CompactSessionOutput {
+    status: "compacted" | "not_found";
+    sessionId: string;
+    checkpointId?: string;
+    checkpointTitle?: string;
+    contentLength?: number;
+    originalMessages?: number;
+    deletedMessages?: number;
+    remainingMessages?: number;
+    hintUsed?: boolean;
+}
+/**
+ * not_found 输出（不暴露存在性）
+ */
+export declare function compactSessionNotFoundOutput(sessionId: string): CompactSessionOutput;
+/**
+ * 在 manager 的任务表里查找 sub-session 归属的任务。
+ *
+ * - 优先按 subSessionId 反查（工具入参就是 sub-session id）
+ * - 再回退 getTask（兼容直接传 bgProcessId 的误用场景）
+ *
+ * 返回 undefined 表示没有任何任务关联该 session。
+ */
+export declare function findTaskBySubSessionId(manager: Pick<BackgroundTaskManager, "getTask" | "listTasks">, sessionId: string): BackgroundTask | undefined;
+/**
+ * ownership 校验：
+ * 该 session 是否是「当前会话自己 delegate 出去的 sub-session」。
+ *
+ * 规则：task 存在 且 task.parentSessionId === ctx.session_id。
+ * （delegate_tool 创建 sub-session 时把 parentSessionId 写成
+ *  ctx.session_id —— 见 createTask。）
+ */
+export declare function isOwnSubSession(task: BackgroundTask | undefined, currentSessionId: string | undefined): boolean;
+/**
+ * 该 session 是否属于一个仍在运行中的后台任务。
+ * running/pending 的 sub-session 正在被 sub-agent 每轮增量落盘，
+ * 此时归档旧消息会产生竞态（归档读到的窗口与 sub-agent 正在写的窗口冲突）。
+ */
+export declare function isTaskActive(task: BackgroundTask | undefined): boolean;
+/**
+ * 工厂函数 — 创建 deps-bound 工具实例。
+ *
+ * @param backgroundTaskManager BackgroundTaskManager 实例（查任务归属 / 判运行中）；
+ *                             传 null 表示未注入
+ * @param sessionComponent SessionComponent 实例（执行压缩）；传 null 表示未注入
+ */
+export declare function createCompactSessionTool(backgroundTaskManager?: BackgroundTaskManager | null, sessionComponent?: SessionComponent | null): Tool;
+/**
+ * compact_session 工具的"无 deps"实例。
+ *
+ * 历史：与 queryBackgroundProcessTool 同模式 ——
+ * - 实际注入的 deps 通过 createCompactSessionTool(manager, sessionComponent)
+ *   工厂绑定；TaskComponent.start() 会用它重新注册真正的实例到
+ *   ToolComponent，覆盖此 no-deps 版本。
+ * - 此 named export 保留用于 getAllBuiltInTools() 注册与向后兼容；
+ *   它绑定 null deps → 执行时返回 "not initialized" 错误。
+ */
+export declare const compactSessionTool: Tool;

package/dist/env/tool/built-in/index.d.ts

@@ -8,6 +8,7 @@ import { editFileTool } from "./edit-file";
 import { grepTool } from "./grep";
 import { understandImageTool } from "./understand-image";
 import { createQueryBackgroundProcessTool } from "./query-background-process-tool";
+import { createCompactSessionTool, compactSessionTool } from "./compact-session-tool";
 export { bashTool };
 export { echoTool };
 export { globTool };
@@ -18,6 +19,7 @@ export { grepTool };
 export { understandImageTool };
 import { queryBackgroundProcessTool } from "./query-background-process-tool";
 export { queryBackgroundProcessTool, createQueryBackgroundProcessTool };
+export { compactSessionTool, createCompactSessionTool };
 export { setUnderstandImageLLMProvider, getUnderstandImageLLMProvider, resetUnderstandImageLLMProvider, type UnderstandImageLLMProvider, } from "./understand-image";
 /**
  * 获取所有内置工具

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

@@ -8,7 +8,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-kpg25s2q.js";
+} from "../../../shared/@ai-setting/roy-agent-core-8ez6mccb.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -16,9 +16,11 @@ import {
   understandImageTool
 } from "../../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
 import {
+  compactSessionTool,
+  createCompactSessionTool,
   createQueryBackgroundProcessTool,
   queryBackgroundProcessTool
-} from "../../../shared/@ai-setting/roy-agent-core-58804s3j.js";
+} from "../../../shared/@ai-setting/roy-agent-core-2akfd64z.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";
@@ -40,5 +42,7 @@ export {
   editFileTool,
   echoTool,
   createQueryBackgroundProcessTool,
+  createCompactSessionTool,
+  compactSessionTool,
   bashTool
 };

package/dist/env/tool/index.js

@@ -10,14 +10,14 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-kpg25s2q.js";
+} from "../../shared/@ai-setting/roy-agent-core-8ez6mccb.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
   setUnderstandImageLLMProvider,
   understandImageTool
 } from "../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
-import"../../shared/@ai-setting/roy-agent-core-58804s3j.js";
+import"../../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import {
   ToolComponent,
@@ -25,10 +25,10 @@ import {
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-dt104qa1.js";
+} from "../../shared/@ai-setting/roy-agent-core-v85n42ve.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";
+import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
 import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";

package/dist/env/workflow/engine/index.js

@@ -5,20 +5,20 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-vah6g5yx.js";
+} from "../../../shared/@ai-setting/roy-agent-core-6rh8k6ba.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
-import"../../../shared/@ai-setting/roy-agent-core-attpry6g.js";
+import"../../../shared/@ai-setting/roy-agent-core-dqxec05w.js";
 import"../../../shared/@ai-setting/roy-agent-core-efkjyh69.js";
 import"../../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../../shared/@ai-setting/roy-agent-core-dvtg4sn0.js";
 import"../../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
-import"../../../shared/@ai-setting/roy-agent-core-sjr1kmfz.js";
+import"../../../shared/@ai-setting/roy-agent-core-acj8ag08.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import {
   DAGManager
-} from "../../../shared/@ai-setting/roy-agent-core-mds8tqd0.js";
-import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
-import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
+} from "../../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+import"../../../shared/@ai-setting/roy-agent-core-er070zjq.js";
+import"../../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
 import"../../../shared/@ai-setting/roy-agent-core-qqaak24r.js";

package/dist/env/workflow/index.js

@@ -1,6 +1,6 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-gr48c89p.js";
+} from "../../shared/@ai-setting/roy-agent-core-v87njmq7.js";
 import"../../shared/@ai-setting/roy-agent-core-es203w7p.js";
 import {
   Edge,
@@ -14,23 +14,24 @@ import {
   DecoratorNode,
   init_decorator_node
 } from "../../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
-import"../../shared/@ai-setting/roy-agent-core-hfyfavp3.js";
-import"../../shared/@ai-setting/roy-agent-core-pakhchy7.js";
-import"../../shared/@ai-setting/roy-agent-core-sm0sf6sb.js";
+import"../../shared/@ai-setting/roy-agent-core-mww0mnd9.js";
+import"../../shared/@ai-setting/roy-agent-core-ddyk1rc0.js";
+import"../../shared/@ai-setting/roy-agent-core-0qyrk5k0.js";
 import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"../../shared/@ai-setting/roy-agent-core-12n08pg5.js";
-import"../../shared/@ai-setting/roy-agent-core-vah6g5yx.js";
+import"../../shared/@ai-setting/roy-agent-core-6cy43nss.js";
+import"../../shared/@ai-setting/roy-agent-core-6rh8k6ba.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
-import"../../shared/@ai-setting/roy-agent-core-attpry6g.js";
+import"../../shared/@ai-setting/roy-agent-core-dqxec05w.js";
 import"../../shared/@ai-setting/roy-agent-core-efkjyh69.js";
 import"../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../shared/@ai-setting/roy-agent-core-dvtg4sn0.js";
 import"../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
 import"../../shared/@ai-setting/roy-agent-core-7exqwax1.js";
-import"../../shared/@ai-setting/roy-agent-core-yr1mryb8.js";
-import"../../shared/@ai-setting/roy-agent-core-sjr1kmfz.js";
+import"../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
+import"../../shared/@ai-setting/roy-agent-core-acj8ag08.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../../shared/@ai-setting/roy-agent-core-mds8tqd0.js";
+import"../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
 import {
   BaseEventSchema,
   ControlPauseEventSchema,
@@ -82,10 +83,10 @@ import {
   parseWorkflowFileSync,
   pathNotFound,
   unresolvedVariable
-} from "../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
+} from "../../shared/@ai-setting/roy-agent-core-er070zjq.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../shared/@ai-setting/roy-agent-core-kmbct9yg.js";
-import"../../shared/@ai-setting/roy-agent-core-40rv283c.js";
+import"../../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
+import"../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
@@ -93,7 +94,8 @@ import {
   AskUserError,
   createNodeInterruptEvent,
   createWorkflowAskUserEvent
-} from "../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
+} from "../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
+import"../../shared/@ai-setting/roy-agent-core-m880qz3y.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
 import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";

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

@@ -1,8 +1,8 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-1w9y7mxj.js";
-import"../../../shared/@ai-setting/roy-agent-core-46rv4d7d.js";
+} from "../../../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
+import"../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
 import"../../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
 import"../../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";

package/dist/env/workflow/tools/ask-user-tool.d.ts

@@ -3,6 +3,56 @@
  *
  * When an AgentNode calls this tool, it throws AskUserError to interrupt
  * the workflow, allowing the workflow to pause and wait for user response.
+ *
+ * ★ Task #4983 — 无 TTY 场景的 **IM 直连投递**。
+ *
+ * ## 为什么需要这一段（生产日志铁证）
+ *
+ * traceId `01a1a68652ee79c9c6508579b504e662`（2026-11-04 20:55:38 → 20:56:09，
+ * 飞书 p2p `oc_9406ee012e5b7ae65a7a83314b2f8fbc`）：
+ *
+ *   20:55:38.788  [BackgroundTaskManager] Event published: task.background.ask_user
+ *                  （triggerEventId + replyChannel 都齐 ✅ —— #3147 的 notify 链路完好）
+ *   20:55:38.790  cli.query-executor.execute enter: "[通知] ❓ 后台子代理「…」请求用户输入 …"
+ *   20:56:09.513  [agent:component] Iteration 1 error
+ *                  {runId:"unknown", nodeId:"unknown", type:"ask-user", name:"AskUserError"}
+ *   20:56:09.517  cli.query-executor.execute error: __ASK_USER_ERROR__:{…}
+ *   ⇒ 此后该 traceId **0 次** lark messages-send / messages-reply
+ *
+ * 根因链：
+ *   1. 本工具只「抛 AskUserError」当作中断信号；
+ *   2. 交互层（REPL + readline）在守护进程（无 TTY）里是死的；
+ *   3. headless 下没人接这个异常 ⇒ 直接冒泡终止整次查询；
+ *   4. `query-executor.ts` 的 `isAskUserError → return` + `error-reply.ts` 的
+ *      `ask_user` 规则 `notify:false` ⇒ **双重静默**，连失败兜底都不发。
+ *
+ * ⇒ **问题正文从未离开进程，用户零感知**（用户原话：「sub agent 的 ask_user 被淹没了」）。
+ *
+ * ## 本次修复（路线 A：工具自己投递）
+ *
+ * 在抛 AskUserError **之前**，若当前上下文存在可用的 IM 投递目标，
+ * 就**自己把问题（含选项）投递过去**，让用户真正看到并能答复。
+ *
+ * 契约：
+ *   - C1 无投递目标 → 行为不变（抛 AskUserError，交给 TTY 交互层）
+ *   - C2 有投递目标 → 先投递，再抛 AskUserError（中断信号保留，agent 本轮终止）
+ *   - C3 投递失败 → **绝不抛**（不能让投递故障掩盖原始中断语义），只记 warn
+ *   - C4 投递内容含问题正文 + 选项（用户要能选）
+ *   - C5 投递目标从 EnvContext 取（replyChannel → envEvent.metadata.replyChannel）
+ *
+ * ⚠️ **为什么不在 CLI 层兜底**：CLI 层的兜底（query-executor / error-reply）都只能
+ * 看到「一次失败的查询」，拿不到「用户到底要回答什么」的结构化信息，而且要靠
+ * 规则表区分「TTY 场景该静默 / headless 场景该发」—— 极易再次静默。
+ * 在**工具层**投递是唯一能保证「问题一定离开进程」的位置。
+ *
+ * ⚠️ **TTY 场景不会重复发（精确条件）**：仅当「有可用投递目标
+ * （EnvContext.replyChannel 等）**且** TTY 交互层也会打印」时，
+ * 用户会同时看到 IM 那条和本地回显那条 ⇒ **两条，这不是 bug**：
+ * 投递到 IM 渠道的那条才是「离开进程」的那条；TTY 那条是给本地
+ * 用户看的回显。本地 TTY 通常**没有** replyChannel（不投）；
+ * 有 replyChannel 且需要静音时，可通过
+ * `context.metadata.askUserDelivery === "off"` 关闭（workflow 路径
+ * 已默认关闭，agent-component-adapter.ts）。
  */
 import { z } from 'zod';
 import type { ToolInfo } from '../../tool/types';
@@ -31,5 +81,43 @@ export type AskUserInput = z.infer<typeof AskUserInputSchema>;
  * catch and convert to a workflow pause event.
  */
 export type AskUserTool = ToolInfo<typeof AskUserInputSchema>;
+/**
+ * Task #4983 — 从 EnvContext 解析可用的 IM 投递目标。
+ *
+ * 优先级（与 buildRunEnvContext 的 replyChannel 优先级一致）：
+ *   1. `envContext.replyChannel`（当前层已构建好的渠道，**带 sendMarkdown/reply 实现**）
+ *   2. `envContext.envEvent.metadata.replyChannel`（只有裸字段，没有发送实现）
+ *
+ * 只有 1 能真正发送（它带 `sendMarkdown` / `reply` 函数）。
+ * 2 只提供 chatId/messageId 快照 —— 在 core 层没有 lark-cli 发送器可用，
+ * 因此**不作为投递目标**（避免在这里 spawn lark-cli 造成职责外 IO）。
+ */
+interface DeliveryTarget {
+    chatId?: string;
+    messageId?: string;
+    profile?: string;
+    /** 真正能发消息的通道（EnvContext.replyChannel） */
+    channel?: {
+        sendMarkdown?: (text: string) => Promise<void>;
+        sendText?: (text: string) => Promise<void>;
+        reply?: (content: unknown) => Promise<void>;
+    };
+}
+/**
+ * Task #4983 — 渲染投递到用户渠道的正文。
+ *
+ * 硬要求：
+ *   - 必须含**问题正文**（用户要看的就是问题）
+ *   - 必须含**全部选项**（用户要能选）
+ *   - 必须含**答复指引**（用户不知道回哪儿答）
+ *   - 绝不渲染 `undefined` / `NaN`
+ */
+export declare function buildAskUserDeliveryText(args: {
+    query: string;
+    options?: string[];
+    requiredConfirm?: boolean;
+}): string;
+export declare function deliverAskUserToChannel(target: DeliveryTarget, text: string): Promise<boolean>;
 export declare const askUserTool: AskUserTool;
 export declare const askUserToolInstance: AskUserTool;
+export {};