@ai-setting/roy-agent-core 1.7.53 → 1.7.56

package/dist/config/index.js

@@ -4,7 +4,7 @@ import {
   ConfigSourceNotFoundError,
   FileSource,
   MemorySource
-} from "../shared/@ai-setting/roy-agent-core-qamktze3.js";
+} from "../shared/@ai-setting/roy-agent-core-qyqnmz8c.js";
 import {
   EnvSource,
   parseJSONC,
@@ -15,12 +15,12 @@ import {
 } from "../shared/@ai-setting/roy-agent-core-adg9ghbt.js";
 import"../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -411,6 +411,13 @@ export declare class AgentComponent extends BaseComponent {
     /**
      * 执行 Agent（核心方法，内部实现）
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479，CV 发现的漏网之鱼）。
+     *
+     * 实测：`agent.component.run` 单 span attributes 达 **70 KB**，
+     * `query` 多模态时（base64 图片）可达 MB 级 ——
+     * 等于把上一级 `env.handle_query` 省下来的体积**又吐回去一层**。
+     */
     private _run;
     /**
      * 中止 Agent
@@ -493,6 +500,10 @@ export declare class AgentComponent extends BaseComponent {
      * 否则降级到当前行为：从 ctx.context.additionInfo 读取（每次 buildMessages 都
      * 重读，可能因 caller 传入不同值而变化 → cache miss）。
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479）。改造前平均 158KB
+     * —— 入参 `ctx` 挂着完整对话历史，返回值是完整 additionInfo 文本。
+     */
     private _buildAdditionInfo;
     private buildMessages;
     /**
@@ -515,6 +526,10 @@ export declare class AgentComponent extends BaseComponent {
      *
      * 流式事件由 LLMComponent 通过 env.pushEnvEvent() 发布
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479）。改造前平均 149KB
+     * —— 入参 ctx 带全量消息，返回值是完整模型输出。
+     */
     private invokeLLM;
     /**
      * Task #2723: 归一化上游 tool-call shape → 内部 `Record<string, unknown>`。
@@ -547,6 +562,11 @@ export declare class AgentComponent extends BaseComponent {
      * 刻意不覆盖「工具执行失败」（`success:false` 且有真实 error，如 bash exit!=0）：
      * 那是正常运行时结果，全标 ERROR 会让 trace 里遍布红色噪音、反而掩盖真问题。
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479）。改造前平均 259KB
+     * —— `ctx` 里挂着完整对话历史 + 工具参数 + 工具返回值。
+     * 现在只留工具名 / toolCallId / 参数键名列表。
+     */
     private executeTool;
     /**
      * 执行 Plugin Hooks (Agent 特有的 Hook 执行机制)
@@ -584,6 +604,12 @@ export declare class AgentComponent extends BaseComponent {
      * amplification that turned short contentions into full SQLITE_BUSY
      * storms (the root cause of the 2026-07-07 incident).
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479，CV 发现的**最大漏网之鱼**）。
+     *
+     * 实测：`allMessages` 是**每一轮 ReAct 迭代的全部消息**（含工具输出），
+     * 单 span attributes 达 **200 KB / 迭代** —— 这是剩余的体积大头。
+     */
     private recordSessionMessages;
     /**
      * 检查消息内容是否为空
@@ -620,6 +646,10 @@ export declare class AgentComponent extends BaseComponent {
      * @param options.filterHistory - 是否过滤 tool 消息（默认 true）
      * @returns 过滤后的会话消息列表
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479）。改造前平均 45KB
+     * —— 返回值是完整会话历史数组（每条 message 的完整 content）。
+     */
     private getConversationHistory;
 }
 /**

package/dist/env/agent/index.js

@@ -2,24 +2,25 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-3tv1q6f2.js";
-import"../../shared/@ai-setting/roy-agent-core-fvs48d38.js";
+} from "../../shared/@ai-setting/roy-agent-core-9nv586rw.js";
+import"../../shared/@ai-setting/roy-agent-core-98aa9r0x.js";
 import"../../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
-import"../../shared/@ai-setting/roy-agent-core-rx16h2m1.js";
+import"../../shared/@ai-setting/roy-agent-core-97eyghsp.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-dv714bqh.js";
-import"../../shared/@ai-setting/roy-agent-core-pk1b3kvf.js";
-import"../../shared/@ai-setting/roy-agent-core-zy3hqfwg.js";
+import"../../shared/@ai-setting/roy-agent-core-wafk25ff.js";
+import"../../shared/@ai-setting/roy-agent-core-ns3pbyz4.js";
+import"../../shared/@ai-setting/roy-agent-core-yv9x4wmg.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-e25xkv53.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-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/commands/index.js

@@ -1,13 +1,13 @@
 import {
   CommandsComponent
-} from "../../shared/@ai-setting/roy-agent-core-zd3ddm4k.js";
+} from "../../shared/@ai-setting/roy-agent-core-qjjf4tjb.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/context/index.js

@@ -1,6 +1,6 @@
 import {
   init_context
-} from "../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
+} from "../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
 import {
   EVENT_ENV_PREFIX,
   createEnvContext,
@@ -24,8 +24,8 @@ import {
   runWithEnvContextAsync,
   serializeEventToEnv,
   setCurrentTaskId
-} from "../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/debug/index.js

@@ -4,18 +4,18 @@ import {
   RegexParser,
   SpanBuilder,
   SpanDbReader
-} from "../../shared/@ai-setting/roy-agent-core-k25gv86p.js";
+} from "../../shared/@ai-setting/roy-agent-core-0b3fdnn3.js";
 import {
   ReplFormatter,
   TraceFormatter,
   TreeFormatter
 } from "../../shared/@ai-setting/roy-agent-core-rvv6ydff.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/environment.d.ts

@@ -82,6 +82,12 @@ export declare class BaseEnvironment extends BaseComponent implements Environmen
      *
      * 委托给 AgentComponent.run() 处理
      */
+    /**
+     * ★ 2026-10-22：**入参只存摘要**（Task #4479）。
+     *
+     * `query` 是 `string | ContentPart[]` —— 多模态时是图片/文件数组，可能很大；
+     * 返回值是完整的 agent 响应文本。把两者都换成摘要（长度/条数/类型）。
+     */
     handle_query(query: string | ContentPart[], context?: AgentContext): Promise<string>;
     /**
      * ★ Workflow 类型 agent 查询处理
@@ -89,6 +95,7 @@ export declare class BaseEnvironment extends BaseComponent implements Environmen
      * 检查 agentDef.type 是否为 "workflow"，是则通过 WorkflowComponent 执行 workflow。
      * 非 workflow 类型返回 null，让 handle_query 走原有 ReAct 路径。
      */
+    /** ★ 2026-10-22：同 `env.handle_query`，只存摘要（Task #4479）。 */
     private handleWorkflowAgentQuery;
     /**
      * 处理动作

package/dist/env/error-reply.d.ts

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Task #4418: React 循环异常中断 → 给飞书发 reply
+ *
+ * ## 问题（用户飞书 p2p 2026-10-21）
+ *
+ * ```
+ * RetryError [AI_RetryError]: Failed after 4 attempts.
+ * Last error: Upstream request failed: Endpoint is unavailable.
+ * statusCode: 429 / isRetryable: true
+ * ```
+ *
+ * 上游 429 不是 roy-agent 的 bug；但**异常中断后飞书侧完全静默**是。
+ * 用户原话：「这个失败导致的 react 中断，也需要找到对应的 triggerEvent
+ * 构建 response 让飞书方知道（送一个 reply 哈）」。
+ *
+ * ## 为什么必须由框架直接发（不能靠 prompt 引导 agent）
+ *
+ * 正常路径的 reply 是 **LLM 自己调 lark-cli**（prompt 由
+ * `buildNotifyHandlePrompt` / event-source-handlers 生成，告诉 agent
+ * 用 `recommendedAction.replyTo` 回消息）。
+ *
+ * 但异常路径的根本问题是：**LLM 调用本身失败了**，React 循环从未拿到
+ * 一个可用的 assistant turn，自然也不可能再调工具发消息。所以框架必须
+ * 自己 spawn `lark-cli`，这是与正常路径的本质区别。
+ *
+ * ## 断点（为什么曾经没 reply）
+ *
+ * 1. `agent-component.ts:2096` 捕获异常 → `result.error` + `result.originalError`
+ * 2. `environment.ts:430` 非 ContextError → `throw new Error(result.error)`
+ *    ⚠️ 类型在这里丢掉，下游只能拿到字符串
+ * 3. `context-handler.service.ts:224` 直接 rethrow
+ * 4. `query-executor.ts:287` 只处理 ContextError，其余 rethrow
+ * 5. `interactive.ts:1301` / `event-handler.ts:620` 的 catch **只 console.error**
+ *    → 静默丢失
+ *
+ * ## 现在的接线（四处，去重保证不重复）
+ *
+ * 1. `QueryExecutor.execute` 的 catch —— 唯一执行入口，覆盖
+ *    interactive / run / run --es 三种模式，带完整 `agentContext.envEvent`
+ * 2. `EventHandler.processQueue` 的 catch —— 兜住「还没走到 QueryExecutor
+ *    就失败」的路径（session 解析 / 事件分发），并作为 TUI 层吞异常时的
+ *    最后一道防线
+ * 3. REPL `executeInternal` 的 catch —— 兜住 agentContext 组装 / plugin
+ *    加载 / REPL 包装层（这些异常会被 REPL 自己吞掉，到不了 EventHandler）
+ * 4. `LarkCliInstance.handleEvent` 的 catch —— event-source 自身的解析 /
+ *    落库 / 分发失败
+ *
+ * 四处都调用本模块，意味着**任何 React 中断都至少有一个出口到飞书**。
+ *
+ * ## 设计原则
+ *
+ * - **规则表驱动（rule base）**：错误分类 + 是否通知 + 用户文案收敛成
+ *   `FAILURE_RULES` 有序表；表尾 `UNKNOWN_RULE` 是 `notify: true` 的
+ *   catch-all —— 结构上保证**任何未分类错误也不会沉默**。只有
+ *   `ask_user`（正常交互）显式 `notify: false`
+ * - **best-effort**：任何异常（spawn 失败 / lark-cli 非 0 / 库挂了）
+ *   都不得向上抛，绝不污染原始错误传播链
+ * - **有硬超时**：兜底 reply 在 5s 内一定 settle（超时 kill 子进程）。
+ *   否则 lark-cli 卡住会把 `QueryExecutor` 的 rethrow 拖死 → 事件队列堵死
+ * - **复用现有机制**：spawn 参数形态与 `LarkCliNotificationChannel` /
+ *   `event-source-handlers.sendLarkMessage` 保持一致（`--profile` 前置、
+ *   messageId → `+messages-reply`、chatId → `+messages-send`）
+ * - **去重**：同一 triggerEvent（messageId）只回一次；chat-only 通道走
+ *   5 分钟窗口，**不会**把整个群永久封锁；发送失败回滚去重标记
+ * - **无 channel 不崩但也不静默**：本地 REPL / `act` 没有飞书上下文 → debug；
+ *   有 triggerEvent 却拿不到 replyChannel = 衔接 bug → warn
+ * - **用户可读**：给用户看中文原因，技术细节单独放 `technical` 字段（截断）
+ */
+/**
+ * 失败分类。
+ *
+ * 顺序即优先级：越具体的越先匹配。
+ */
+export type ReactFailureKind = "ask_user" | "upstream_retry" | "timeout" | "upstream_aborted" | "aborted" | "context_overflow" | "unknown";
+export interface ReactFailureInfo {
+    kind: ReactFailureKind;
+    /** 命中的规则 id（可观测性 / 测试锚点） */
+    ruleId: string;
+    /** 一行标题（中文，给用户看） */
+    title: string;
+    /** 可读原因（中文，不含 stack trace） */
+    reason: string;
+    /** 是否值得用户稍后重试 */
+    retryable: boolean;
+    /**
+     * 是否应该把这条失败反馈到飞书。
+     *
+     * 只有 `ask_user`（正常交互）为 false —— **所有真正的失败/中断都必须通知**，
+     * 这是 #4418 的硬契约：不允许静默。
+     */
+    notify: boolean;
+    /** 技术细节（截断，供定位；不直接展示给用户） */
+    technical?: string;
+}
+/** replyChannel 的最小形态（同时兼容 EnvReplyChannel / event-source ReplyChannel） */
+export interface FailureReplyChannelLike {
+    type?: string;
+    chatId?: string;
+    messageId?: string;
+    profile?: string;
+    appId?: string;
+    userId?: string;
+}
+export interface NotifyReactFailureOptions {
+    /** 触发 React 中断的错误（任意类型，内部会做类型安全处理） */
+    error: unknown;
+    /**
+     * 触发本次执行的 EnvEvent。
+     *
+     * 从中提取 replyChannel（优先 `metadata.replyChannel`，
+     * 兼容 `payload.replyChannel`），这就是用户说的「找到对应的 triggerEvent」。
+     */
+    envEvent?: unknown;
+    /** 显式 replyChannel（优先级最高，便于调用方直接指定） */
+    replyChannel?: FailureReplyChannelLike;
+    /** 原始 query 摘要（会被截断后放进 reply，便于用户对上号） */
+    query?: string;
+    /** 会话 ID（仅用于日志 / 去重兜底） */
+    sessionId?: string;
+    /** 去重 key 覆盖（默认从 messageId/chatId 推导） */
+    dedupKey?: string;
+    /**
+     * 兜底 reply 的硬超时（ms）。
+     *
+     * 生产默认 5s；仅测试注入短值用。超时后 kill 子进程并按失败返回，
+     * 保证 `QueryExecutor` 的 catch 不会被 lark-cli 挂住。
+     */
+    replyTimeoutMs?: number;
+}
+export interface NotifyReactFailureResult {
+    /** 是否成功投递到飞书 */
+    sent: boolean;
+    /** 失败分类（即使没发送也会返回，调用方可记日志） */
+    kind: ReactFailureKind;
+    /** 结构化失败信息 */
+    info: ReactFailureInfo;
+    /** 跳过原因（sent=false 时有值） */
+    skipped?: "no_channel" | "duplicate" | "not_a_failure";
+    /** 投递错误（sent=false 且确实尝试过时有值） */
+    error?: string;
+}
+/** 当前生效的规则 id 列表（供可观测性 / 文档 / 测试锚定顺序）。 */
+export declare function getFailureRuleIds(): string[];
+/**
+ * 把任意错误分类成结构化、用户可读的失败信息。
+ *
+ * ⚠️ 关键：必须能处理**类型已丢失**的场景 —— 真实调用链上
+ * `environment.ts` 会把 RetryError 字符串化成普通 `Error`，所以只能靠
+ * message 文本特征识别，不能依赖 `instanceof RetryError`。
+ */
+export declare function classifyReactFailure(error: unknown): ReactFailureInfo;
+/**
+ * 生成发给用户的 reply 正文（Markdown）。
+ *
+ * 契约：
+ * - 不含裸 stack trace（`    at `）
+ * - 含「怎么办」的可操作建议
+ * - 总长度远小于飞书 4096 单条上限
+ */
+export declare function buildFailureReplyMarkdown(info: ReactFailureInfo, opts?: {
+    query?: string;
+    sessionId?: string;
+}): string;
+/** 测试用：清空去重状态 */
+export declare function __resetFailureReplyDedupForTest(): void;
+/**
+ * React 循环异常中断时，尽最大努力给飞书发一条失败说明。
+ *
+ * **绝不抛异常** —— 所有错误都被吞掉并记日志，保证不污染原始错误传播。
+ *
+ * @example
+ * ```ts
+ * // interactive.ts executeInternal 的 catch 分支
+ * } catch (error) {
+ *   await notifyReactFailure({
+ *     error,
+ *     envEvent: this.currentAgentContext?.envEvent,
+ *     sessionId: agentContext?.eventSessionId,
+ *   });
+ *   // …原有错误处理继续
+ * }
+ * ```
+ */
+export declare function notifyReactFailure(options: NotifyReactFailureOptions): Promise<NotifyReactFailureResult>;

package/dist/env/event-source/event-source-handlers.d.ts

@@ -106,11 +106,9 @@ export declare class LarkCliInstance implements EventSourceInstance {
     /**
      * ★ Task #4230 follow-up：卡片路由端口（lookup/getTask 侧）
      *
-     * 构建一次、多处复用（含 loadPlugins 收尾时补 ensureTaskGroupChat）。
+     * ★ Task #4394：只剩 `getTask`（无触发群时 lineage 上溯兜底用）。
      */
     private cardRoutingPorts?;
-    /** ★ Task #4230 follow-up：群名缓存（判定"触发群是不是别 task 的专属群"） */
-    private chatNameCache;
     /** ★ Task #4230 follow-up：已加载插件实例（收尾 cross-wire 用） */
     private pluginInstances;
     /**
@@ -269,13 +267,6 @@ export declare class LarkCliInstance implements EventSourceInstance {
      * 任意一环缺失（如没配 task component）→ 不注入，行为与之前一致（warn + skip）。
      */
     private wireCardActionPorts;
-    /**
-     * Task #4230 follow-up：把「按需建专属群」能力接到卡片路由端口上
-     *
-     * 顺序问题：两个插件是分别 import + registerPluginHooks 的，NotifyHook 在
-     * PerTaskGroupChatPlugin 之前加载，所以只能在 loadPlugins 收尾时补一次。
-     */
-    private wireCardRoutingGroupProvider;
     /**
      * 获取插件的 hook 点列表
      */
@@ -330,22 +321,17 @@ export declare class LarkCliInstance implements EventSourceInstance {
      */
     private injectTaskGetter;
     /**
-     * ★ Task #4230 follow-up：给支持 setCardRoutingPorts 的 plugin 注入「卡片路由端口」
+     * ★ Task #4230 follow-up / ★ Task #4394 精简：注入「卡片路由端口」
      *
-     * 端口负责三件"需要 IO"的事（让 plugin 保持纯逻辑 + 可单测）：
-     * 1. lookupChatOwnership(chatId)：这个群是不是某个 task 的专属群（多重信号）
-     * 2. getTask(id)：lineage 上溯
-     * 3. ensureTaskGroupChat(task)：按需建专属群（由 PerTaskGroupChatPlugin 提供，
-     *    在 loadPlugins 收尾时 cross-wire）
-     */
-    private injectCardRoutingPorts;
-    /**
-     * 取群名（带进程内缓存）
+     * ★ Task #4394 删除：`lookupChatOwnership` + `lookupChatName` + `chatNameCache`
+     *   —— 卡片不再判定"触发群是不是别 task 的专属群"，因此整套群归属反查
+     *   （session chat↔task 绑定 + `findTasksByContextValue` DB LIKE + lark-cli
+     *   查群名）都不再需要。这同时省掉了每张卡一次 DB 查询 + 一次 lark-cli 调用。
      *
-     * 只在需要判定"触发群是不是别 task 的群"时调用（DB 信号为空才会走到）。
-     * lark-cli 失败 / 未安装 → 返回 undefined（判定退化为"不是专属群"）。
+     * 保留 `getTask(id)`：无触发群时，仍需要沿 lineage 上溯找本 task / 祖先
+     * 已有的专属群兜底（卡片不能丢）。
      */
-    private lookupChatName;
+    private injectCardRoutingPorts;
     /**
      * ★ Task #4023：如果 plugin 支持 setSessionComponent，自动注入 SessionComponent 引用
      *

package/dist/env/event-source/index.js

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-ph5qbqcx.js";
+} from "../../shared/@ai-setting/roy-agent-core-2044fbsd.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -21,33 +21,33 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
-import"../../shared/@ai-setting/roy-agent-core-rnwr39b0.js";
-import"../../shared/@ai-setting/roy-agent-core-hch2geta.js";
+import"../../shared/@ai-setting/roy-agent-core-w7hnjhvx.js";
+import"../../shared/@ai-setting/roy-agent-core-ezsyyjxw.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
-} from "../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
+} from "../../shared/@ai-setting/roy-agent-core-zmeka63k.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-gdsqp6j8.js";
-import"../../shared/@ai-setting/roy-agent-core-brwzs8wf.js";
-import"../../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
-import"../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
-import"../../shared/@ai-setting/roy-agent-core-na73mym1.js";
-import"../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
+import"../../shared/@ai-setting/roy-agent-core-6masakz4.js";
+import"../../shared/@ai-setting/roy-agent-core-xcq04fq0.js";
+import"../../shared/@ai-setting/roy-agent-core-nntphgww.js";
+import"../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
+import"../../shared/@ai-setting/roy-agent-core-202v00x4.js";
+import"../../shared/@ai-setting/roy-agent-core-nra8vfrs.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
-import"../../shared/@ai-setting/roy-agent-core-dv714bqh.js";
+import"../../shared/@ai-setting/roy-agent-core-wafk25ff.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-64f22h1g.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/hook/index.js

@@ -2,7 +2,7 @@ import {
   createHook,
   createPriorityHook,
   init_hook
-} from "../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
+} from "../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
 import {
   AgentHookPoints,
   HookManager,
@@ -13,10 +13,10 @@ import {
   executeLLMHook,
   executeToolHook,
   globalHookManager
-} from "../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";