@ai-setting/roy-agent-core 1.7.85 → 1.7.89

package/dist/env/task/plugins/wecom-task-notify-plugin.d.ts

@@ -79,6 +79,17 @@ export interface WecomTaskNotifyConfig {
     maxTimelineEntries?: number;
     /** 通知类型过滤（空数组 = 全开） */
     notifyTypes?: WecomNotifyType[];
+    /**
+     * ★ Task #5360（补充需求）：ES 配置的 `statusNotifications` 透传。
+     *
+     * - `false` / 缺省（默认）：只发卡片（#5255 单卡语义）
+     * - `true`：发卡成功后**额外**再发一条 markdown 状态文本
+     *
+     * 为什么由工厂注入而不是插件自己读 `event-sources.json`：
+     * 插件不持有 ES 配置句柄，且同一进程可能有多个 wecom 源 ——
+     * 由 `es-plugins` 工厂把**该源自己的**配置值传进来，语义最准确。
+     */
+    statusNotifications?: boolean;
     /**
      * 出站 sender（测试注入；不传用 sendWecomReply）
      */
@@ -150,6 +161,13 @@ export declare class WecomTaskNotifyHook implements Hook {
     private readonly sender;
     /** 持久化 store（taskId → chatId/status/timeline） */
     private readonly cardStateStore;
+    /**
+     * ★ Task #5360（补充需求）：状态通知文本开关（严格 `=== true`）。
+     *
+     * 构造时快照一次（配置热更新靠重建插件实例，与 `enabled` / `priority` 一致），
+     * 避免每次 deliver 都读 config 对象。
+     */
+    private readonly esStatusNotifications;
     /** 操作记录节流状态：key `op:${taskId}` → 上次发送时间戳 */
     private lastNotifyTimestamps;
     constructor(config?: WecomTaskNotifyConfig);
@@ -185,6 +203,28 @@ export declare class WecomTaskNotifyHook implements Hook {
      * @returns 是否成功（失败时调用方决定是否落库）
      */
     private deliver;
+    /**
+     * ★ Task #5360（补充需求）：读 ES 配置的 `statusNotifications`。
+     *
+     * ## 为什么读实时配置而不是快照
+     *
+     * lark 侧走 `EventHandler`（事件驱动，用 delegate 时刻的快照）；
+     * 企微插件是**直接挂在 hook 上**（`task:after.create/update/complete`），
+     * 拿不到"任务诞生时的快照"，所以只能读事件源当前配置。
+     *
+     * 语义差异可接受：企微侧开关变化对**下一次**任务状态变化生效（毫秒级），
+     * 而 lark 侧对已派生任务保持口径一致。两边各自的取舍都有文档说明。
+     *
+     * 严格 `=== true`（手改 JSON 的 "true"/1/null 一律当 false）。
+     */
+    private statusNotificationsEnabled;
+    /**
+     * ★ Task #5360（补充需求）：`statusNotifications: true` 时额外发的 markdown 状态文本。
+     *
+     * 内容 = 现有 `buildWecomTaskCard` 的 markdown 形态（#5193 的文本可读性），
+     * 与卡片正文同源，避免两套文案漂移。
+     */
+    private sendStatusMarkdown;
     /**
      * ★ Task #5203：经 WS 直发 template_card。
      *

package/dist/env/task/storage/index.d.ts

@@ -3,3 +3,4 @@
  */
 export { SQLiteTaskStore, type TaskStore } from "./sqlite-task-store";
 export { getDefaultTaskDbPath, getDefaultDataDir } from "./sqlite-task-store";
+export { RemoteTaskStore, createRemoteTaskStore, RemoteTaskStoreError, RemoteAuthError, RemoteBatchBusyError, RemoteIdempotencyConflictError, RemoteProtocolError, REMOTE_PROTOCOL_MAJOR, REMOTE_TASK_STORE_METHODS, type RemoteTaskStoreOptions, type RemoteLogger, type RemoteTaskStoreStats, } from "./remote-task-store";

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

@@ -1,15 +1,35 @@
-import"../../../shared/@ai-setting/roy-agent-core-q813vafd.js";
+import"../../../shared/@ai-setting/roy-agent-core-05z35shp.js";
+import {
+  REMOTE_PROTOCOL_MAJOR,
+  REMOTE_TASK_STORE_METHODS,
+  RemoteAuthError,
+  RemoteBatchBusyError,
+  RemoteIdempotencyConflictError,
+  RemoteProtocolError,
+  RemoteTaskStore,
+  RemoteTaskStoreError,
+  createRemoteTaskStore
+} from "../../../shared/@ai-setting/roy-agent-core-zhwcje5a.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
-import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../../../shared/@ai-setting/roy-agent-core-m66ysky0.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   getDefaultTaskDbPath,
   getDefaultDataDir,
-  SQLiteTaskStore
+  createRemoteTaskStore,
+  SQLiteTaskStore,
+  RemoteTaskStoreError,
+  RemoteTaskStore,
+  RemoteProtocolError,
+  RemoteIdempotencyConflictError,
+  RemoteBatchBusyError,
+  RemoteAuthError,
+  REMOTE_TASK_STORE_METHODS,
+  REMOTE_PROTOCOL_MAJOR
 };

package/dist/env/task/storage/migrations/006_add_task_owner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Task Migration 006: Add owner column
+ *
+ * Migration ID: 006_add_task_owner
+ * Description: 给 task 表加 `owner` 列（负责人，可空）。
+ *              Task #5440 —— roy-agent 接入 task-service 时，service 后端
+ *              （Task #5443）已扩展 owner 字段，core 侧必须同源，
+ *              否则 remote 模式的 owner 写不进去、读不回来。
+ *
+ * 语义：
+ * - `owner TEXT`（NULL 表示未指派）—— 刻意**不**加 NOT NULL DEFAULT ''，
+ *   因为「未指派」与「指派给空字符串」在业务上是两件事，null 更准确。
+ * - 加索引 `idx_task_owner`（按负责人筛任务是主要用法）。
+ *
+ * 幂等：重复执行安全（列已存在则跳过）。
+ *
+ * Date: 2026-11-13
+ */
+/**
+ * Run migration 006 on the given database file.
+ *
+ * @param dbPath SQLite database file path
+ */
+export declare function runMigration(dbPath: string): void;

package/dist/env/task/storage/remote-task-store.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @fileoverview RemoteTaskStore — 把 `TaskStore` 做成一个 HTTP 客户端
+ *
+ * Task #5440（方案 v3 §4.2 / M2）。roy-agent 的 task 存储除了本地 SQLite，
+ * 还可以指向常驻的 **task-service**（`/home/dzk/work/codework/personal/roy_world/roy-task-service`）。
+ *
+ * ## 契约
+ *
+ * - 服务端 `POST /store/<method>`：`TaskStore` 方法 **1:1 映射**，body 为
+ *   `{ "args": [...] }`（多参方法按位置透传），响应体就是方法的返回值。
+ * - 鉴权：`Authorization: Bearer <token>`。
+ * - 幂等：**写方法**带 `Idempotency-Key`。同一逻辑调用重试时**复用同一个 key**
+ *   （服务端重放缓存，避免重试造成重复写入）；不同调用必须用不同 key。
+ * - 握手：首次调用前 `GET /version` 校验 `protocol.major`，不匹配即明确报错
+ *   （不静默降级 —— 方案 §1.3 非目标：**无本地 fallback**）。
+ *
+ * ## 故障语义（方案 §5.3）
+ *
+ * | 情况 | 处理 |
+ * |---|---|
+ * | 401 | `RemoteAuthError`，**不重试**（token 错，重试无用） |
+ * | 409 IDEMPOTENCY_CONFLICT | `RemoteIdempotencyConflictError`，**不重试** |
+ * | 400 VALIDATION | 明确报错（payload 错） |
+ * | 404 METHOD_NOT_FOUND | `RemoteProtocolError`（服务端版本过旧） |
+ * | 503 BUSY | sqlite 单连接 batch 事务占用 → 有界重试，超限 `RemoteBatchBusyError` |
+ * | 5xx / 超时 / 网络错 | 有界重试（写方法靠幂等 key 保证重放安全） |
+ *
+ * 所有错误信息都带 endpoint 与排障指引，绝不悄悄退回本地库。
+ */
+import type { TaskStore } from "./sqlite-task-store";
+import type { ListTagsOptions, SearchTagsOptions } from "../tag-service";
+import type { CreateOperationOptions, CreateTaskOptions, ListOperationsOptions, ListTasksOptions, SearchTasksOptions, Task, TaskListResult, TaskOperation, TaskTag, UpdateTaskOptions } from "../types";
+/** 远端 task-service 的基础错误（带 endpoint，便于排障）。 */
+export declare class RemoteTaskStoreError extends Error {
+    readonly endpoint: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, endpoint: string, cause?: unknown | undefined);
+}
+/** Bearer token 缺失/失效（401）。**不重试**。 */
+export declare class RemoteAuthError extends RemoteTaskStoreError {
+}
+/** 幂等 key 被不同 payload 复用（409 IDEMPOTENCY_CONFLICT）。**不重试**。 */
+export declare class RemoteIdempotencyConflictError extends RemoteTaskStoreError {
+}
+/**
+ * sqlite 后端的 batch 事务独占单连接，期间普通请求被拒（503 BUSY）。
+ *
+ * 重试后仍失败才抛这个 —— 调用方可以据此选择「稍后再试」还是报错。
+ */
+export declare class RemoteBatchBusyError extends RemoteTaskStoreError {
+}
+/** 协议不兼容（major 版本不一致 / 服务端不认识该方法）。**不重试**。 */
+export declare class RemoteProtocolError extends RemoteTaskStoreError {
+}
+/**
+ * 服务端 `TASK_STORE_METHODS` 白名单的**本地副本**。
+ *
+ * 用途：握手时对齐协议面（服务端白名单变化 = 协议变化），以及让
+ * `RemoteTaskStore` 的方法集有单一可断言的来源（测试可对照）。
+ * ⚠️ 与 roy-task-service `packages/backend/src/types.ts` 的
+ * `TASK_STORE_METHODS` 必须保持一致。
+ */
+export declare const REMOTE_TASK_STORE_METHODS: readonly ["createTask", "getTask", "updateTask", "deleteTask", "listTasks", "getTaskIdBySessionId", "getTaskIdsBySessionId", "createOperation", "getOperation", "updateOperation", "deleteOperation", "listOperations", "listOperationsFresh", "invalidateOperationsCache", "createTag", "getTag", "getTagByName", "listTags", "searchTags", "deleteTag", "addTagsToTask", "removeTagsFromTask", "getTagsForTask", "getTaskIdsByTags", "updateTaskTags", "searchTasksByKeywords", "findSimilarTasksByKeywords", "getTaskTree", "getChildTasks", "findSimilarTasks", "searchTasks", "findTasksByContextValue"];
+/** 本 client 支持的协议 major（与服务端 `PROTOCOL_VERSION.major` 对齐）。 */
+export declare const REMOTE_PROTOCOL_MAJOR = 1;
+/**
+ * 裁掉参数数组**尾部**的 `null` / `undefined`。
+ *
+ * 为什么只裁尾部：位置参数中间的空位有语义（`updateTask(7, null)` 的 null 是
+ * 「要改的那个值」），只有尾部才是「调用方没传」的表达。裁掉后服务端才会
+ * 用它自己的默认参数。
+ *
+ * ⚠️ 不能按 falsy 裁：`limit: 0` / `offset: 0` / `""` 都是调用方的显式意图。
+ */
+export declare function trimTrailingNullish(args: unknown[]): unknown[];
+/** 只用到 warning/debug 两档（避免把整个 logger 类型泄漏到公开 API）。 */
+export interface RemoteLogger {
+    warn?(message: string): void;
+    debug?(message: string): void;
+}
+export interface RemoteTaskStoreOptions {
+    /** service 地址，如 `http://127.0.0.1:7820`（末尾斜杠可有可无）。 */
+    endpoint: string;
+    /** Bearer token；service 未配置 token 时留空。 */
+    authToken?: string;
+    /** 单请求超时（毫秒），默认 5000。 */
+    timeoutMs?: number;
+    /** 可重试失败的最大**重试**次数（不含首次），默认 3。 */
+    maxRetries?: number;
+    /** 重试退避基数（毫秒），第 n 次重试等 `base * 2^n`，默认 200。 */
+    retryBaseDelayMs?: number;
+    /** 注入 fetch（测试/自定义传输）。 */
+    fetchImpl?: typeof fetch;
+    /** 注入 logger（默认用 core logger）。 */
+    log?: RemoteLogger;
+}
+export interface RemoteTaskStoreStats {
+    /** /version 握手次数（正常为 1；重连后可增加）。 */
+    handshakes: number;
+    /** 累计请求数（含重试）。 */
+    requests: number;
+    /** 累计重试次数。 */
+    retries: number;
+}
+export declare class RemoteTaskStore implements TaskStore {
+    private readonly endpoint;
+    private readonly authToken?;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly retryBaseDelayMs;
+    private readonly fetchImpl;
+    private readonly log;
+    private readonly stats;
+    private handshake?;
+    private closed;
+    constructor(options: RemoteTaskStoreOptions);
+    /** 诊断用统计（联调/健康检查）。 */
+    getStats(): Readonly<RemoteTaskStoreStats>;
+    private ensureOpen;
+    /** `/version` 握手（只做一次；失败则下次调用重试）。 */
+    private ensureHandshake;
+    private doHandshake;
+    private fetchWithTimeout;
+    /** 分类：该错误值得重试吗？ */
+    private isRetryableStatus;
+    /**
+     * 一次逻辑调用 = 一次 `POST /store/<method>`，内含**有界重试**。
+     *
+     * @param method TaskStore 方法名
+     * @param args   按位置透传的实参
+     */
+    private call;
+    createTask(options: CreateTaskOptions): Promise<Task>;
+    getTask(id: number): Promise<Task | undefined>;
+    updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+    deleteTask(id: number): Promise<boolean>;
+    listTasks(options?: ListTasksOptions): Promise<TaskListResult>;
+    getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
+    createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+    getOperation(id: number): Promise<TaskOperation | undefined>;
+    updateOperation(id: number, updates: Parameters<TaskStore["updateOperation"]>[1]): Promise<TaskOperation | undefined>;
+    deleteOperation(id: number): Promise<boolean>;
+    listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /** optional — 绕过缓存直读（跨进程写入可见）。 */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * optional — 失效 operations 缓存。
+     *
+     * 接口签名是**同步 void**，而远端失效必然是一次网络调用：这里
+     * fire-and-forget（不阻塞调用方，失败仅 WARN）。服务端缓存只在 service
+     * 进程内，失效语义"尽力而为"即可 —— 真正需要新鲜数据时用
+     * `listOperationsFresh`。
+     */
+    invalidateOperationsCache(taskId: number): void;
+    createTag(name: string): Promise<TaskTag>;
+    getTag(id: number): Promise<TaskTag | undefined>;
+    getTagByName(name: string): Promise<TaskTag | undefined>;
+    listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+    searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+    deleteTag(id: number): Promise<boolean>;
+    addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+    removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+    getTagsForTask(taskId: number): Promise<TaskTag[]>;
+    getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+    updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+    searchTasksByKeywords(keywords: string[], options?: SearchTasksOptions): Promise<TaskListResult>;
+    findSimilarTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    getTaskTree(taskId: number, depth?: number): Promise<Task[]>;
+    getChildTasks(taskId: number, options?: ListTasksOptions): Promise<TaskListResult>;
+    findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+    searchTasks(query: string, limit?: number): Promise<Task[]>;
+    findTasksByContextValue(value: string, limit?: number): Promise<Task[]>;
+    /**
+     * 关闭 client（幂等）。
+     *
+     * 与本地 store 不同：**没有连接需要释放**，只是把实例标记为已关闭，
+     * 后续调用立即报错（避免组件被 dispose 后仍有请求飞出去）。
+     */
+    close(): void;
+}
+/** 便捷工厂（与 `createSQLiteTaskPort` 对称）。 */
+export declare function createRemoteTaskStore(options: RemoteTaskStoreOptions): RemoteTaskStore;

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

@@ -115,6 +115,13 @@ export declare class TaskComponent extends BaseComponent {
      * 根据配置初始化 store
      */
     private initStore;
+    /**
+     * 按配置**构造**（不安装）一个 store。
+     *
+     * 单独抽出来是为了让 `initStore` 能「先构造后安装」——构造失败时旧 store
+     * 保持原样（CV MAJOR-2）。
+     */
+    private buildStore;
     /**
      * 将配置对象展平为点号路径
      */

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

@@ -11,12 +11,12 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
-import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+} from "../../../shared/@ai-setting/roy-agent-core-9cen1jvg.js";
+import"../../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../../shared/@ai-setting/roy-agent-core-4rtg69cn.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-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -29,6 +29,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     project_path: z.ZodDefault<z.ZodString>;
     parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
     context: z.ZodDefault<z.ZodString>;
+    owner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
 }, "strip", z.ZodTypeAny, {
     type: "normal" | "cycle" | "longterm";
     title: string;
@@ -40,6 +41,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     goals_and_expected_deliverables?: string | undefined;
     due_date?: string | undefined;
     parent_task_id?: number | null | undefined;
+    owner?: string | null | undefined;
 }, {
     title: string;
     type?: "normal" | "cycle" | "longterm" | undefined;
@@ -51,6 +53,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
 }>;
 export type CreateTaskToolParams = z.infer<typeof CreateTaskToolSchema>;
 /**
@@ -166,6 +169,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path: z.ZodOptional<z.ZodString>;
     context: z.ZodOptional<z.ZodString>;
     parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+    owner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
@@ -180,6 +184,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }, {
     task_id: number;
@@ -195,6 +200,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }>, {
     task_id: number;
@@ -210,6 +216,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }, unknown>;
 export type UpdateTaskToolParams = z.infer<typeof UpdateTaskToolSchema>;

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

@@ -59,6 +59,16 @@ export interface Task {
     project_path: string;
     /** JSON string with time-space positioning info (worktree, branch, etc.) */
     context: string;
+    /**
+     * 负责人（Task #5440）。
+     *
+     * 语义：这个任务的**人**（open_id / 用户名 / 邮箱，字符串，core 不解释格式）。
+     * - 可空：`null` 表示未指派（新建任务的默认值）
+     * - 多人协作场景下用来区分「谁在负责推进」，与 `sessionId`（谁在操作）
+     *   和 `project_path`（在哪个项目）正交
+     * - 与 task-service 后端的 `owner` 列同源，remote 模式下原样落库
+     */
+    owner?: string | null;
 }
 /**
  * TaskOperation entity — 双维度操作记录（Task #2211 重构后版本）
@@ -171,6 +181,8 @@ export interface CreateTaskOptions {
      * Must be a valid JSON string.
      */
     context: string;
+    /** 负责人（可选，不传即 null；参见 Task.owner）。 */
+    owner?: string | null;
 }
 export interface UpdateTaskOptions {
     title?: string;
@@ -187,6 +199,11 @@ export interface UpdateTaskOptions {
     project_path?: string;
     /** 任务上下文信息，用于存储额外上下文 */
     context?: string;
+    /**
+     * 负责人（可选）。传 `null` 或 `""` 表示清空；传字符串表示改为该负责人；
+     * **字段省略**表示不改（与 status/progress 等字段语义一致）。
+     */
+    owner?: string | null;
     /** 父任务 ID，null = 设为根任务（无父任务） */
     parent_task_id?: number | null;
 }

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

@@ -8,7 +8,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-tk98f92b.js";
+} from "../../../shared/@ai-setting/roy-agent-core-k3gcvybs.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -24,10 +24,12 @@ import {
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import {
   wecomRespondTool
-} from "../../../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
+import"../../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
+import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.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-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/tool/index.js

@@ -10,7 +10,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-tk98f92b.js";
+} from "../../shared/@ai-setting/roy-agent-core-k3gcvybs.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -19,24 +19,28 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
 import"../../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
-import"../../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
+import"../../shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
+import"../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
+import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import {
   ToolComponent,
   ToolRegistry,
-  ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-ze5cqpf2.js";
+} from "../../shared/@ai-setting/roy-agent-core-mx855td4.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
+import {
+  ToolValidator
+} from "../../shared/@ai-setting/roy-agent-core-wxrkcb17.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.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";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -163,6 +163,31 @@ export interface ToolMetadata {
      *   3. ToolComponent.listTools({ allowedAgent }) 一次过滤；agent-component 再做 allowedTools/deniedTools 二次过滤
      */
     allowedAgentTypes?: string[];
+    /**
+     * ★ Task #5333 — 渠道专用工具标记（channel-only tool）。
+     *
+     * `true` = 该工具**只对特定事件源渠道**有意义，默认对所有 agent 不可见；
+     * 只有当前会话的 `AgentContext.extendTools` 显式列出该工具名时才可见。
+     *
+     * 典型用例：`wecom_respond`（企微出站唯一通道）——
+     * 在飞书会话 / 交互式 CLI 里调用必然失败（无企微 chatId，无 wecom 注册表实例），
+     * 但它原先在 `getAllBuiltInTools()` 全局注册且无可见性声明 →
+     * 所有 agent（含 default 接待员）都被注入了它，LLM 会误调。
+     *
+     * 与 `allowedAgentTypes` 的区别：
+     * - `allowedAgentTypes` 按 **agent 身份** 过滤（谁可见）
+     * - `channelOnly` 按 **会话渠道上下文** 过滤（哪个事件源驱动的这一轮可见）
+     *
+     * 两者正交，都满足才可见。实际判定顺序见 `filterToolsByAgent`：
+     * **先 channelOnly**（渠道上下文），**再 allowedAgentTypes**（agent 身份）。
+     *
+     * ⚠️ 可见性只在 `AgentComponent.getAvailableTools` 一处收敛
+     * （`filterToolsByAgent`）。`ToolRegistry.listTools()` 是**存储目录**
+     * （`roy-agent tools list` / 调试用），不做 channelOnly 过滤 ——
+     * 否则"无 filter 全量返回、有 filter 却隐藏"会造成同一工具在不同
+     * 查询路径下存在性不一致。
+     */
+    channelOnly?: boolean;
     /**
      * Whether this tool explicitly opts out of string output truncation.
      *

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

@@ -1,4 +1,12 @@
 import type { Tool, ValidationResult } from "./types";
+/** 接线 ConfigComponent（由 ToolComponent.init 调用，支持热更新） */
+export declare function setToolReasonConfigComponent(component: {
+    get(key: string): unknown;
+} | null): void;
+/** 测试 / 无 ConfigComponent 场景的模块级开关 */
+export declare function setToolReasonRequired(required: boolean): void;
+/** 当前是否要求 reason（逃生开关读取，实时） */
+export declare function isToolReasonRequired(): boolean;
 /**
  * 工具参数验证器
  */

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

@@ -5,25 +5,25 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-6rh8k6ba.js";
+} from "../../../shared/@ai-setting/roy-agent-core-6gj1hc5z.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.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-bjtc9d35.js";
+import"../../../shared/@ai-setting/roy-agent-core-9710zwwz.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-acj8ag08.js";
+import"../../../shared/@ai-setting/roy-agent-core-g8yr733d.js";
+import"../../../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
+import"../../../shared/@ai-setting/roy-agent-core-tjnabyvq.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import {
   DAGManager
-} from "../../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+} from "../../../shared/@ai-setting/roy-agent-core-e08bvpaq.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";
-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-smf94h73.js";
+import"../../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -1,17 +1,17 @@
 import {
   init_hooks
-} from "../../../shared/@ai-setting/roy-agent-core-dvtg4sn0.js";
+} from "../../../shared/@ai-setting/roy-agent-core-g8yr733d.js";
 import {
   WorkflowHookPoints,
   emitWorkflowNodeHook,
   emitWorkflowRunHook,
   getRegisteredWorkflowHookPoints
-} from "../../../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";
-import"../../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
-import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
-import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
+import"../../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";