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

package/dist/env/event-source/wecom-session-card-sender.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Task #5360 —— 企微 **session 卡发送器**（无 task 的 sub-session）
+ *
+ * ## 用户需求
+ *
+ * > 「企微也是这个逻辑哈」（22:32）+「以 sub-session 为基底」（22:37）
+ *
+ * ## 为什么单独一个模块（不复用 lark 的 sessionCardSender）
+ *
+ * 飞书发卡是 `lark-cli im +messages-send --msg-type interactive`（spawn 子进程）；
+ * 企微发卡是 WS `aibot_send_msg`（长连接帧）。两条完全不同的传输通道，
+ * 混在一个 sender 里只会靠 if/else 分支，且会把「渠道 guard」的责任
+ * 推给运行时的字符串比较 —— 那正是 R4 抓出的错渠道风险。
+ *
+ * ⇒ 明确分成两个 sender，各自由**渠道自己的**事件路径调用。
+ *
+ * ## 设计（纯函数 + 端口注入，便于单测）
+ *
+ * | 关注点 | 谁负责 |
+ * |--------|--------|
+ * | 卡片长什么样 | `buildWecomSessionCard`（wecom-card-builder，已测） |
+ * | 发到哪 | 本模块的 `resolveWecomSendTarget`（从 event 取 chatId/chatType/sourceId） |
+ * | 怎么发 | `sendCard` 端口（生产接 `sendWecomTemplateCard`） |
+ *
+ * ## 全链路 best-effort
+ *
+ * 任何一步失败（无 chatId / 无 sourceId / 发送报错）都只 log，**绝不抛** ——
+ * 生命周期事件是 fire-and-forget，抛出去会污染事件消费循环。
+ */
+import type { EnvEvent } from "../types";
+import { type WecomSessionLifecycle } from "./wecom-card-builder";
+import { type WecomSessionCardStore } from "../task/plugins/wecom-session-card-store";
+/** 企微发送目标 */
+export interface WecomSessionCardTarget {
+    /** 事件源 ID（WS 实例反查用） */
+    sourceId: string;
+    /** 单聊 = userid；群聊 = 群 chatid */
+    chatId: string;
+    chatType: "single" | "group";
+}
+/**
+ * 从事件里解析企微发送目标。
+ *
+ * ## 渠道判定（为什么这里要显式判断）
+ *
+ * 本 sender 只处理**企微**事件。若把飞书事件的 chatId（`oc_xxx`）当企微
+ * userid 发，WS 会静默丢弃（或报错）—— 与 R4 抓出的「错渠道发送」同一类问题，
+ * 只是方向相反。所以这里要求 `replyChannel.type === "wecom-cli"`，
+ * 判不出来就返回 `undefined`（调用方丢弃，不猜）。
+ *
+ * ## chatType 判定
+ *
+ * 优先 `params.chatType`（`buildWecomReplyChannel` 写入的权威值）；
+ * 缺省时看 `params.wecomChatId` 是否存在 —— 有原始 group chatid ⇒ group。
+ * 都没有 ⇒ `single`（企微单聊的 chatId 就是 userid，官方语义）。
+ */
+export declare function resolveWecomSessionCardTarget(event: EnvEvent): WecomSessionCardTarget | undefined;
+/** 从事件 payload 里取 session 卡需要的信息 */
+export interface WecomSessionCardPayload {
+    sessionId: string;
+    lifecycle: WecomSessionLifecycle;
+    title?: string;
+    agentType?: string;
+    startedAt?: string;
+}
+/**
+ * 解析 `task.background.session_started` 的 payload。
+ *
+ * 缺 `subSessionId` ⇒ `undefined`（没有主键，无从发卡）。
+ * `lifecycle` 非法/缺失 ⇒ `running`（乐观：宁可显示在跑，也不凭空宣布结束）。
+ */
+export declare function parseWecomSessionCardPayload(event: EnvEvent): WecomSessionCardPayload | undefined;
+/** sender 依赖的最小端口集（全部可选 ⇒ 缺了只降级） */
+export interface WecomSessionCardSenderPorts {
+    /**
+     * ★ Task #5364：session 卡持久层（**B 方案的核心**）。
+     *
+     * 一个 session 生命周期内只发一张卡 ⇒ 后续 lifecycle 必须落在这里，
+     * 刷新时才有数据可渲染。不注入 ⇒ 内部用内存实现兜底（同实例内仍只发
+     * 一次；进程重启会重发一张，属于可接受的降级）。
+     */
+    store?: WecomSessionCardStore;
+    /**
+     * 发卡（生产：`sendWecomTemplateCard`）。
+     *
+     * `card` 是 `buildWecomSessionCard` 的输出，原样传给 WS 帧构造。
+     */
+    sendCard?: (input: {
+        sourceId: string;
+        chatId: string;
+        chatType: "single" | "group";
+        card: Record<string, unknown>;
+        /** ★ sessionId（供实现方记录 sessionId→公开消息定位，便于后续 patch/诊断） */
+        sessionId: string;
+    }) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 日志（测试可注入；缺省 console） */
+    warn?: (msg: string) => void;
+    /** 时间基准（注入便于测试；缺省 Date.now()） */
+    now?: () => number;
+}
+/**
+ * 造一个 `(event) => Promise<void>` 的企微 session 卡 sender。
+ *
+ * **永不抛**：这是 fire-and-forget 生命周期事件的投递路径。
+ *
+ * ## ★ Task #5364 语义变更（用户 2026-11-12 08:34 拍板 B）
+ *
+ * > 「企微改成**只维护一张卡 + 靠按钮触发更新**」
+ *
+ * | 事件 | 旧行为（#5360，被用户否掉） | 新行为（B 方案） |
+ * |------|---------------------------|------------------|
+ * | 首次 lifecycle | 发一张卡 | 发一张卡 + 落库 |
+ * | 后续 lifecycle | **再发一张卡**（刷屏 + 重复 pin） | **不发**，只更新持久层 |
+ * | 用户点「刷新」 | 只刷活性 | 从持久层 + 实时活性重建**整张卡** |
+ *
+ * ## 为什么这是唯一可行的形态（协议硬约束，不是偷懒）
+ *
+ * `aibot_respond_update_msg` 必须在 `template_card_event` 回调的 5 秒窗口内、
+ * 用回调带回的 `req_id` 发（#5203 已真网取证）。生命周期事件不是回调、
+ * 没有 req_id ⇒ **根本发不出 update 帧**。所以「主动 patch」这条路在企微
+ * 上不存在；要「一张卡」只能把更新的机会押在用户点按钮那一刻。
+ *
+ * 反过来：**如果我们仍然每条 lifecycle 都发卡，就不是一张卡** —— 这正是
+ * 用户否掉的形态。所以「后续不发」是本模块最重要的不变量，有测试断言
+ * `sendCard` 调用次数恒为 1。
+ *
+ * ## 发卡失败不落库（重要）
+ *
+ * 否则后续事件会以为「已经有卡了」而永不再发 ⇒ 用户真的一张卡都看不到。
+ * 失败就让它下次事件再试（最多多发一张，也好过零张）。
+ */
+export declare function createWecomSessionCardSender(ports: WecomSessionCardSenderPorts): (event: EnvEvent) => Promise<void>;

package/dist/env/event-source/wecom-session-card-sender.js

@@ -0,0 +1,153 @@
+import {
+  createMemoryWecomSessionCardStore
+} from "../../shared/@ai-setting/roy-agent-core-age3qseb.js";
+import {
+  buildWecomSessionCard
+} from "../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
+import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
+import"../../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";
+
+// src/env/event-source/wecom-session-card-sender.ts
+function resolveWecomSessionCardTarget(event) {
+  const metadata = event?.metadata;
+  const rc = metadata?.replyChannel;
+  if (rc?.type !== "wecom-cli")
+    return;
+  const chatId = typeof rc.chatId === "string" && rc.chatId.trim() ? rc.chatId : undefined;
+  if (!chatId)
+    return;
+  const sourceId = typeof rc.params?.sourceId === "string" && rc.params.sourceId || (typeof metadata?.sourceId === "string" ? metadata.sourceId : undefined);
+  if (!sourceId)
+    return;
+  const chatType = rc.params?.chatType === "group" || rc.params?.chatType === "single" ? rc.params.chatType : rc.params?.wecomChatId ? "group" : "single";
+  return { sourceId, chatId, chatType };
+}
+var LIFECYCLES = new Set([
+  "running",
+  "completed",
+  "timeout",
+  "failed",
+  "stopped"
+]);
+var LIFECYCLE_MILESTONE_PHRASE = {
+  running: "运行中",
+  completed: "已完成",
+  timeout: "已超时",
+  failed: "已失败",
+  stopped: "已停止"
+};
+function parseWecomSessionCardPayload(event) {
+  const p = event?.payload ?? {};
+  const sessionId = typeof p.subSessionId === "string" && p.subSessionId.trim() ? p.subSessionId : undefined;
+  if (!sessionId)
+    return;
+  const lifecycle = typeof p.lifecycle === "string" && LIFECYCLES.has(p.lifecycle) ? p.lifecycle : "running";
+  return {
+    sessionId,
+    lifecycle,
+    ...typeof p.description === "string" && p.description ? { title: p.description } : {},
+    ...typeof p.subagentType === "string" && p.subagentType ? { agentType: p.subagentType } : {},
+    ...typeof p.startedAt === "number" ? { startedAt: new Date(p.startedAt).toISOString() } : {}
+  };
+}
+function parseAssociatedTaskId(event) {
+  const p = event?.payload ?? {};
+  const raw = p.associatedTaskId;
+  const n = typeof raw === "number" ? raw : typeof raw === "string" && /^\d+$/.test(raw.trim()) ? Number(raw) : undefined;
+  return typeof n === "number" && Number.isSafeInteger(n) && n > 0 ? n : undefined;
+}
+function createWecomSessionCardSender(ports) {
+  const warn = ports.warn ?? ((m) => console.warn(m));
+  const store = ports.store ?? createMemoryWecomSessionCardStore();
+  const nowFn = ports.now ?? Date.now;
+  return async (event) => {
+    try {
+      const target = resolveWecomSessionCardTarget(event);
+      if (!target)
+        return;
+      const payload = parseWecomSessionCardPayload(event);
+      if (!payload)
+        return;
+      const existing = store.get(payload.sessionId);
+      const at = nowFn();
+      const milestone = {
+        title: LIFECYCLE_MILESTONE_PHRASE[payload.lifecycle],
+        timestamp: new Date(at).toISOString()
+      };
+      const prevMilestones = (() => {
+        if (!existing?.milestones)
+          return [];
+        try {
+          const arr = JSON.parse(existing.milestones);
+          return Array.isArray(arr) ? arr : [];
+        } catch {
+          return [];
+        }
+      })();
+      const milestones = [...prevMilestones, milestone];
+      const associatedTaskId = parseAssociatedTaskId(event) ?? existing?.associatedTaskId;
+      const terminal = payload.lifecycle !== "running";
+      const persist = (over = {}) => {
+        try {
+          store.upsert({
+            sessionId: payload.sessionId,
+            chatId: target.chatId,
+            chatType: target.chatType,
+            sourceId: target.sourceId,
+            cardTaskId: existing?.cardTaskId ?? "",
+            lifecycle: payload.lifecycle,
+            ...payload.title || existing?.title ? { title: payload.title ?? existing.title } : {},
+            ...payload.agentType || existing?.agentType ? { agentType: payload.agentType ?? existing.agentType } : {},
+            ...payload.startedAt || existing?.startedAt ? { startedAt: payload.startedAt ?? existing.startedAt } : {},
+            ...associatedTaskId !== undefined ? { associatedTaskId } : {},
+            milestones: JSON.stringify(milestones),
+            createdAt: existing?.createdAt ?? at,
+            updatedAt: at,
+            ...terminal ? { closedAt: at } : {},
+            ...over
+          });
+        } catch (err) {
+          warn(`[wecom-session-card] store upsert failed for ${payload.sessionId}: ` + `${err instanceof Error ? err.message : String(err)}`);
+        }
+      };
+      if (!existing) {
+        if (!ports.sendCard)
+          return;
+        const card = buildWecomSessionCard({
+          sessionId: payload.sessionId,
+          lifecycle: payload.lifecycle,
+          ...payload.title ? { title: payload.title } : {},
+          ...payload.agentType ? { agentType: payload.agentType } : {},
+          ...payload.startedAt ? { startedAt: payload.startedAt } : {}
+        });
+        const r = await ports.sendCard({
+          sourceId: target.sourceId,
+          chatId: target.chatId,
+          chatType: target.chatType,
+          card,
+          sessionId: payload.sessionId
+        });
+        if (!r?.ok) {
+          warn(`[wecom-session-card] send failed for ${payload.sessionId}: ` + `${r?.error ?? "unknown"}`);
+          return;
+        }
+        persist({
+          cardTaskId: String(card.task_id ?? payload.sessionId)
+        });
+        return;
+      }
+      persist();
+    } catch (err) {
+      warn(`[wecom-session-card] sender threw: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  };
+}
+export {
+  resolveWecomSessionCardTarget,
+  parseWecomSessionCardPayload,
+  createWecomSessionCardSender
+};

package/dist/env/hook/index.js

@@ -2,7 +2,7 @@ import {
   createHook,
   createPriorityHook,
   init_hook
-} from "../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
+} from "../../shared/@ai-setting/roy-agent-core-smf94h73.js";
 import {
   AgentHookPoints,
   HookManager,
@@ -13,10 +13,10 @@ import {
   executeLLMHook,
   executeToolHook,
   globalHookManager
-} from "../../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-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/index.js

@@ -1,24 +1,25 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-p6ks90tb.js";
+} from "../shared/@ai-setting/roy-agent-core-dvec4nn2.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-qk9hd89p.js";
+} from "../shared/@ai-setting/roy-agent-core-49qcpqwg.js";
 import"../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"../shared/@ai-setting/roy-agent-core-cha0jc7n.js";
+import"../shared/@ai-setting/roy-agent-core-0sbmdz8d.js";
 import"../shared/@ai-setting/roy-agent-core-fttgm52a.js";
-import"../shared/@ai-setting/roy-agent-core-q813vafd.js";
+import"../shared/@ai-setting/roy-agent-core-05z35shp.js";
+import"../shared/@ai-setting/roy-agent-core-zhwcje5a.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-vffccgf6.js";
+import"../shared/@ai-setting/roy-agent-core-9cen1jvg.js";
 import"../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import {
   EventSourceComponent
-} from "../shared/@ai-setting/roy-agent-core-begm7ytz.js";
+} from "../shared/@ai-setting/roy-agent-core-m7d1t3db.js";
 import {
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-xf6z96qy.js";
+} from "../shared/@ai-setting/roy-agent-core-4b38m749.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -27,87 +28,91 @@ import {
   validateEventSourceConfig
 } from "../shared/@ai-setting/roy-agent-core-vx8zc847.js";
 import"../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
-import"../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
+import"../shared/@ai-setting/roy-agent-core-age3qseb.js";
+import"../shared/@ai-setting/roy-agent-core-mf5p38yf.js";
 import"../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../shared/@ai-setting/roy-agent-core-b31v3qpv.js";
-import"../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
-import"../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import"../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
+import"../shared/@ai-setting/roy-agent-core-k3h8t4q1.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-4t3yskp8.js";
+import"../shared/@ai-setting/roy-agent-core-y7fqtzk2.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../shared/@ai-setting/roy-agent-core-tr3ep81v.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-d1n4jbza.js";
-import"../shared/@ai-setting/roy-agent-core-7dd0s3xb.js";
+import"../shared/@ai-setting/roy-agent-core-5dhvfgaw.js";
+import"../shared/@ai-setting/roy-agent-core-0n1wwndq.js";
+import"../shared/@ai-setting/roy-agent-core-418zc9ha.js";
+import"../shared/@ai-setting/roy-agent-core-m66ysky0.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-0dh8npnz.js";
-import"../shared/@ai-setting/roy-agent-core-es203w7p.js";
+} from "../shared/@ai-setting/roy-agent-core-n197medr.js";
+import"../shared/@ai-setting/roy-agent-core-wqs6yypq.js";
 import"../shared/@ai-setting/roy-agent-core-h0x19xgn.js";
 import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
-import"../shared/@ai-setting/roy-agent-core-7bpj859q.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-azyz78ky.js";
+import"../shared/@ai-setting/roy-agent-core-cre2y2ct.js";
+import"../shared/@ai-setting/roy-agent-core-ds6qzmf8.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-rykf7c04.js";
-import"../shared/@ai-setting/roy-agent-core-6rh8k6ba.js";
+import"../shared/@ai-setting/roy-agent-core-e69qxdyy.js";
+import"../shared/@ai-setting/roy-agent-core-9c565frx.js";
+import"../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-g8yr733d.js";
+import"../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
 import"../shared/@ai-setting/roy-agent-core-7exqwax1.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-rm7seqwb.js";
+import"../shared/@ai-setting/roy-agent-core-tjnabyvq.js";
 import"../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+import"../shared/@ai-setting/roy-agent-core-e08bvpaq.js";
 import"../shared/@ai-setting/roy-agent-core-er070zjq.js";
 import"../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import"../shared/@ai-setting/roy-agent-core-jagkferh.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-dkrvmjsh.js";
-import"../shared/@ai-setting/roy-agent-core-ze5cqpf2.js";
+} from "../shared/@ai-setting/roy-agent-core-tpm1dd1g.js";
+import"../shared/@ai-setting/roy-agent-core-mx855td4.js";
 import"../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
-import"../shared/@ai-setting/roy-agent-core-ed233k5z.js";
+import"../shared/@ai-setting/roy-agent-core-v1n0106v.js";
 import {
   XDG_PATHS,
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-h21gngxf.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-7yh5wps0.js";
+import"../shared/@ai-setting/roy-agent-core-y6shd91r.js";
+import"../shared/@ai-setting/roy-agent-core-aa8kv18f.js";
+import"../shared/@ai-setting/roy-agent-core-wxrkcb17.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";
 import"../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import {
   PluginComponent
-} from "../shared/@ai-setting/roy-agent-core-v6vr6za7.js";
+} from "../shared/@ai-setting/roy-agent-core-1vv4fx15.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../shared/@ai-setting/roy-agent-core-m880qz3y.js";
 import {
   McpComponent
-} from "../shared/@ai-setting/roy-agent-core-6j02sbee.js";
+} from "../shared/@ai-setting/roy-agent-core-fhg03v43.js";
 import"../shared/@ai-setting/roy-agent-core-q96qynhb.js";
 import"../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
+} from "../shared/@ai-setting/roy-agent-core-m39v7qpx.js";
 import {
   createHook,
   createPriorityHook
-} from "../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
+} from "../shared/@ai-setting/roy-agent-core-smf94h73.js";
 import {
   HookManager
-} from "../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../shared/@ai-setting/roy-agent-core-qqaak24r.js";
+} from "../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
 import {
   createEnvContext,
   getEnvContext,
@@ -116,8 +121,8 @@ import {
   mergeEnvContext,
   runWithEnvContext,
   runWithEnvContextAsync
-} from "../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
-import"../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../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-fnv3ev18.js";

package/dist/env/llm/index.js

@@ -13,7 +13,7 @@ import {
   createLLMAdapter,
   getLLMProviderOverride,
   setLLMProvider
-} from "../../shared/@ai-setting/roy-agent-core-264qexac.js";
+} from "../../shared/@ai-setting/roy-agent-core-b7h39vrc.js";
 import"../../shared/@ai-setting/roy-agent-core-adg9ghbt.js";
 import {
   PiAiAdapter,
@@ -27,17 +27,18 @@ import {
   isOpencodeEndpoint,
   isOpencodeProvider,
   parseModelString
-} from "../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
+} from "../../shared/@ai-setting/roy-agent-core-aa8kv18f.js";
+import"../../shared/@ai-setting/roy-agent-core-wxrkcb17.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.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/log-trace/index.js

@@ -7,13 +7,13 @@ import {
   injectToEnv,
   injectToEnvFromCarrier,
   injectToEnvWithContext
-} from "../../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
+} from "../../shared/@ai-setting/roy-agent-core-mf5p38yf.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-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 {
   Traced,
   TracedAs,
@@ -32,7 +32,7 @@ import {
   toolExecResultFilter,
   toolInvokeParamFilter,
   wrapFunction
-} from "../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import {
   OTelTracerProvider,
   SpanKind,

package/dist/env/log-trace/trace-filters.d.ts

@@ -44,7 +44,12 @@ export declare function isTraceFullMode(): boolean;
  * 保留的字段都是**排障时最常问的问题**的答案：
  * - 用的是哪个模型 / provider
  * - 这次塞了多少条消息、多大（判断是不是上下文爆炸）
- * - 带了多少个工具
+ * - 带了多少个工具、**具体是哪些工具**（`toolNames`，Task #5341）
+ *
+ * 为什么要有 `toolNames`：只记数量时，「11 个工具」既可能是
+ * 「10 个内置 + wecom_respond」也可能是「11 个内置」，无法从 trace 判断
+ * 渠道专用工具（`channelOnly`）是否真的进了 LLM 请求。名称列表体积很小
+ * （几十个短字符串，远小于 2KB 预算），换来的是可直接肉眼核对的证据。
  */
 export declare function llmInvokeParamFilter(args: any[]): Record<string, any>;
 /**

package/dist/env/mcp/index.js

@@ -10,7 +10,7 @@ import {
   augmentNpmEnvForPackageRunner,
   getMcpPathPriority,
   resolvePackageRunnerCommand
-} from "../../shared/@ai-setting/roy-agent-core-6j02sbee.js";
+} from "../../shared/@ai-setting/roy-agent-core-fhg03v43.js";
 import {
   adaptMcpTool,
   convertInputSchemaToZod,
@@ -18,12 +18,12 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-q96qynhb.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.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 {

package/dist/env/memory/index.js

@@ -3,7 +3,7 @@ import {
   MemoryComponent,
   SOURCE_PRIORITY,
   getSourcePriority
-} from "../../shared/@ai-setting/roy-agent-core-nwbfepba.js";
+} from "../../shared/@ai-setting/roy-agent-core-3e040tc5.js";
 import {
   RecallMemorySchema,
   RecordMemorySchema
@@ -25,12 +25,12 @@ import {
   recallMemory
 } from "../../shared/@ai-setting/roy-agent-core-nm4xbs1d.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/plugin/index.js

@@ -1,19 +1,19 @@
 import {
   EventBusNotificationChannel,
   PluginComponent
-} from "../../shared/@ai-setting/roy-agent-core-v6vr6za7.js";
+} from "../../shared/@ai-setting/roy-agent-core-1vv4fx15.js";
 import {
   BasePlugin
 } from "../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   normalizeLarkAtMentions
 } from "../../shared/@ai-setting/roy-agent-core-m880qz3y.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 {
   createLogger,
   init_logger