@ai-setting/roy-agent-core 1.7.58 → 1.7.59

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

@@ -5,7 +5,7 @@
  * 支持通过 handleRule.plugins 加载外部 Plugin
  */
 import { ChildProcess } from "child_process";
-import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventSourceStatus, EventSourceEventHandler, EventMetadata, ReplyChannel, RecommendedAction } from "./types";
+import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventSourceStatus, EventSourceEventHandler, EventMetadata, ReplyChannel, RecommendedAction, RuleNoticeInfo } from "./types";
 import { timerHandler } from "./timer-handler";
 import { bountyIMHandler } from "./bounty-im-handler";
 import { bountyCliHandler } from "./bounty-cli-handler";
@@ -469,6 +469,16 @@ export declare class LarkCliInstance implements EventSourceInstance {
      */
     private sendLarkMessage;
 }
+/**
+ * 渲染「系统回执」小节 —— 告诉主 agent：群里**已经**看到了什么。
+ *
+ * 三种状态必须分开，否则 agent 会二选一地犯两种错：
+ *   - 已送达却把「已超时」再讲一遍 → 重复刷屏
+ *   - 未送达却以为发了 → 用户永远不知道任务结束了（正是 #4561 的现场）
+ *
+ * @param headline 事件标题句（未送达时要求 agent 自己讲清这个事实）
+ */
+export declare function renderRuleNoticeSection(ruleNotice: RuleNoticeInfo | undefined, headline: string): string;
 /**
  * LarkCli Handler
  */

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

@@ -3,7 +3,7 @@
  *
  * 导出所有 EventSource 相关的类型、类和函数
  */
-export type { EventSourceStatus, EventSourceType, EventSourceConfig, EventMetadata, RecommendedAction, ReplyChannel, EventSourceEventPayload, EventSourceEvent, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceInstance, EventSourceHandler, EventSourceInitHook, EventSourceComponentInterface, EventSourceAgentHandlerConfig, } from "./types";
+export type { EventSourceStatus, EventSourceType, EventSourceConfig, EventMetadata, RecommendedAction, ReplyChannel, EventSourceEventPayload, EventSourceEvent, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceInstance, EventSourceHandler, EventSourceInitHook, EventSourceComponentInterface, EventSourceAgentHandlerConfig, NotifyChannelInfo, RuleNoticeInfo, } from "./types";
 export { EventSourceInitHooks } from "./types";
 export { BUILT_IN_EVENT_SOURCE_TYPES, BUILT_IN_EVENT_SOURCE_TYPE_LIST } from "./types";
 export { isBuiltInEventSourceType, isValidEventSourceType, getDefaultConfigForType, validateEventSourceConfig, } from "./types";

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

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-fy4mcj6x.js";
+} from "../../shared/@ai-setting/roy-agent-core-6q5m1qk5.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,

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

@@ -580,6 +580,55 @@ export interface ReplyContext {
     /** lark-cli profile（用于 im +messages-reply --profile） */
     profile?: string;
 }
+/**
+ * 触发渠道信息（渠道无关的最小集合）。
+ *
+ * 由 CLI EventHandler 从 trigger event + handler.extractReplyContext 解析后
+ * 传给 buildNotifyHandlePrompt，让 prompt 能按**真实渠道**渲染：
+ *   - 渠道类型（lark-cli / bounty-im / timer / ...）
+ *   - 群 ID / 群聊还是私聊
+ *   - 触发消息 ID、发送者、profile
+ *
+ * ★ 为什么不让每个 handler 自己从 triggerEvent 里抠字段：
+ *   bounty-im 用 from/to 邮箱、lark 用 chatId/messageId，字段名完全不同；
+ *   统一在这里归一化，handler 只负责渲染「怎么发」。
+ */
+export interface NotifyChannelInfo {
+    /** EventSource 类型（lark-cli / bounty-im / timer / ...） */
+    esType: string;
+    /** 回复目标会话 ID（飞书为 oc_xxx） */
+    chatId?: string;
+    /** 群聊 / 私聊 / 未知（飞书 trigger event metadata.chatType） */
+    chatType?: "group" | "p2p" | "unknown";
+    /** 触发消息 ID（飞书为 om_xxx）；reply 这条可保持话题线索 */
+    messageId?: string;
+    /** 触发者 ID（飞书为 ou_xxx） */
+    senderId?: string;
+    /** 多 appId 场景的 lark-cli profile */
+    profile?: string;
+    /** 回复方式：reply=回复触发消息 / send=新消息 / none=无可用通道 */
+    replyKind?: "reply" | "send" | "none";
+}
+/**
+ * 规则化回执（rule-based direct notice）的投递结果。
+ *
+ * 终态事件（completed / timeout）在进 lane 之前，会先用 telemetry 同一套
+ * 发送器直发一条**保底**消息到触发群；这里把「发没发出去」如实带给主 agent，
+ * 避免 prompt 谎称「已发送」而 agent 又重复/遗漏关键信息。
+ */
+export interface RuleNoticeInfo {
+    /** 是否尝试过直发（false = 该事件类型不在规则回执白名单） */
+    attempted: boolean;
+    /** 是否确实送到群里 */
+    delivered: boolean;
+    chatId?: string;
+    /** 实际发出的文案（送达时带，便于 prompt 里告知「回执已经说了什么」） */
+    text?: string;
+    /** 送达时刻（epoch ms） */
+    sentAt?: number;
+    /** 失败原因（未送达时带） */
+    error?: string;
+}
 /**
  * buildNotifyHandlePrompt 输入
  */
@@ -591,6 +640,12 @@ export interface BuildNotifyHandlePromptInput {
         description?: string;
         result?: string;
         error?: string;
+        /**
+         * 子 session ID —— 超时 / 失败后如需**续跑**，主 agent 可直接
+         * `delegate_task(existingSubSessionId=<此值>, ...)` 让子代理继承历史继续推进，
+         * 不必从零重来。
+         */
+        subSessionId?: string;
     };
     /** 触发整个 delegate_task 的原始 event（从 EventStore 反查） */
     triggerEvent: PersistedEvent;
@@ -605,6 +660,19 @@ export interface BuildNotifyHandlePromptInput {
      * 让主 agent 拿到的回复命令带上正确的 `--profile`。
      */
     profile?: string;
+    /**
+     * 触发渠道信息（渠道无关，由调用方归一化后传入）。
+     *
+     * 缺省时 handler 自行从 triggerEvent 反查（向后兼容）。
+     */
+    channel?: NotifyChannelInfo;
+    /**
+     * 规则化回执的投递结果。
+     *
+     * 缺省 = 本事件不直发回执（如 failed / stopped / ask_user），
+     * prompt 需要引导 agent 把结果完整讲清楚。
+     */
+    ruleNotice?: RuleNoticeInfo;
 }
 /**
  * buildNotifyHandlePrompt 输出

package/dist/env/index.d.ts

@@ -16,7 +16,7 @@ export type { Task, TaskOperation, TaskStatus, TaskPriority, ActionType, CreateT
 export { McpComponent, } from "./mcp";
 export type { McpComponentConfig, McpComponentOptions, McpPath, McpServerConfig, McpServerStatus, DiscoveredMcpServer, } from "./mcp";
 export { EventSourceComponent, larkCliHandler, builtInHandlers, } from "./event-source/event-source-component";
-export type { EventSourceConfig, EventSourceStatus, EventSourceType, EventSourceEvent, EventSourceEventPayload, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceComponentInterface, EventSourceHandler, EventSourceInstance, EventSourceAgentHandlerConfig, BUILT_IN_EVENT_SOURCE_TYPES, } from "./event-source/types";
+export type { EventSourceConfig, EventSourceStatus, EventSourceType, EventSourceEvent, EventSourceEventPayload, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceComponentInterface, EventSourceHandler, EventSourceInstance, EventSourceAgentHandlerConfig, NotifyChannelInfo, RuleNoticeInfo, BUILT_IN_EVENT_SOURCE_TYPES, } from "./event-source/types";
 export { EventSourceInitHooks, isValidEventSourceType, isBuiltInEventSourceType, getDefaultConfigForType, validateEventSourceConfig, } from "./event-source/types";
 export { WorkflowComponent, } from "./workflow/workflow-component";
 export type { WorkflowComponentConfig, } from "./workflow/workflow-component";

package/dist/env/index.js

@@ -15,7 +15,7 @@ import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-fy4mcj6x.js";
+} from "../shared/@ai-setting/roy-agent-core-6q5m1qk5.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,

package/dist/index.js

@@ -83,7 +83,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-fy4mcj6x.js";
+} from "./shared/@ai-setting/roy-agent-core-6q5m1qk5.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,

package/dist/shared/@ai-setting/{roy-agent-core-fy4mcj6x.js → roy-agent-core-6q5m1qk5.js}

@@ -2621,6 +2621,24 @@ function describeNotifyEvent(type, taskId, desc) {
       return { headline: `Sub-agent 更新了 Task #${taskId}「${desc}」。`, actionable };
   }
 }
+function renderRuleNoticeSection(ruleNotice, headline) {
+  if (!ruleNotice || !ruleNotice.attempted) {
+    return `（本事件不直发规则回执）
+` + `→ 你的回复要把结果讲**完整**（用户只能从你这条消息知道结论）。`;
+  }
+  if (ruleNotice.delivered) {
+    const when = ruleNotice.sentAt ? new Date(ruleNotice.sentAt).toLocaleTimeString("zh-CN", {
+      hour12: false,
+      hour: "2-digit",
+      minute: "2-digit"
+    }) : "";
+    const sent = ruleNotice.text ? `：「${ruleNotice.text.replace(/\s*\n+\s*/g, " ")}」` : "";
+    return `✅ 系统已于 ${when || "刚才"} 把下面这条发到群里${sent}
+` + `→ 你的回复**只发增量**：不要再重复「任务已结束」这类回执原文，` + `直接讲结论/交付 + 下一步选项。`;
+  }
+  return `❌ **回执未送达**（原因：${ruleNotice.error ?? "unknown"}）
+` + `→ 用户目前**还不知道**「${headline}」这件事，必须由你在回复里讲清楚，` + `并且不要假装系统已经通知过。`;
+}
 var larkCliHandler = {
   type: "lark-cli",
   validateConfig(config) {
@@ -2683,47 +2701,67 @@ var larkCliHandler = {
       senderOpenId: input.triggerEvent.metadata?.senderId ?? input.triggerEvent.senderId,
       profile: input.profile
     };
-    const profileFlag = ctx.profile ? `--profile ${ctx.profile} ` : "";
+    const esType = input.channel?.esType ?? ctx.esType ?? "lark-cli";
+    const chatId = input.channel?.chatId || ctx.chatId;
+    const messageId = input.channel?.messageId || ctx.messageId;
+    const senderId = input.channel?.senderId || ctx.senderOpenId;
+    const chatType = input.channel?.chatType ?? "unknown";
+    const profile = input.channel?.profile ?? ctx.profile;
+    const profileFlag = profile ? `--profile ${profile} ` : "";
     const desc = input.notifyEvent.description ?? "(未命名任务)";
     const result = input.subAgentResult.summary ?? input.notifyEvent.result ?? "";
     const notifyType = input.notifyEvent.type;
     const taskId = input.notifyEvent.taskId ?? "?";
     const { headline, actionable } = describeNotifyEvent(notifyType, taskId, desc);
+    const chatTypeLabel = chatType === "group" ? "群聊" : chatType === "p2p" ? "私聊" : "会话类型未知";
+    const canReply = Boolean(chatId);
+    const receiptSection = renderRuleNoticeSection(input.ruleNotice, headline);
+    const replyCommand = messageId ? `lark-cli ${profileFlag}im +messages-reply --message-id ${messageId} --chat-id ${chatId} --as bot --markdown '<你的回复>'` : `lark-cli ${profileFlag}im +messages-send --chat-id ${chatId} --as bot --markdown '<你的回复>'`;
+    const scopeWord = chatType === "group" ? "群聊" : chatType === "p2p" ? "私聊" : "会话";
     const promptText = actionable ? `
 ## Notify Event: ${notifyType}
 
 ${headline}
 
-### Trigger event（原始飞书消息，来自 EventStore 反查）
-- ES: lark-cli
-- **chatId: ${ctx.chatId}**  ← 关键！必须回复到这里
-- **messageId: ${ctx.messageId}**  ← 必须 reply 这条
-- sender: ${ctx.senderOpenId}
-${ctx.profile ? `- profile: ${ctx.profile}  ← 调用 lark-cli 必须带 --profile
+### 触发渠道（EventSource）
+- ES: ${esType}（飞书，${chatTypeLabel}）
+- **chatId: ${chatId || "(缺失)"}**  ← 关键！必须发到这里
+- **messageId: ${messageId || "(缺失)"}**  ← ${messageId ? "reply 这条，保持话题线索" : "无触发消息，用 +messages-send"}
+- sender: ${senderId || "(未知)"}
+${input.notifyEvent.subSessionId ? `- 子 session: ${input.notifyEvent.subSessionId}  ← 如需续跑：delegate_task(existingSubSessionId=<此值>, prompt=<新要求>)
+` : ""}${profile ? `- profile: ${profile}  ← 调用 lark-cli 必须带 --profile
 ` : ""}
+### 系统回执（rule-based 直发）
+${receiptSection}
+
 ### Sub-agent 输出
 ${result}
 
-### \uD83D\uDC49 你应该这样做
-用 lark-cli 调 im +messages-reply：
-  lark-cli ${profileFlag}im +messages-reply --message-id ${ctx.messageId} --chat-id ${ctx.chatId} --as bot --msg-type text --content '<你的回复>'
+### \uD83D\uDC49 你要做什么
+1. 用 2~5 行总结：这次完成了什么 / 卡在哪（依据上面的输出与子 session）
+2. 给出 1~3 个下一步选项（继续推进 / 拆小 / 放弃），并**问用户选哪个**
+3. 用 lark-cli 把回复发到上面的${scopeWord}（见下）
+
+### 发送方式（渠道 = lark-cli）
+${canReply ? `  ${replyCommand}` : `⚠️ 没有可用的 chatId —— 无法投递到触发会话。请在会话内汇报，并说明「未投递」的原因。`}
 
 ⚠️ 不要 fallback 到 lastReplyChannel 或 metadata.replyChannel — 那个 chatId
 可能跟用户原始消息的 chatId 不一致（参见 #4035/#4038/#4039 bug）。
+⚠️ 必须 --as bot（否则会被自己的 lark-cli consumer 当用户消息回灌）；不要用 user 身份。
 ` : `
 ## Notify Event: ${notifyType}
 
 ${headline}
 
-### Trigger event
-- ES: lark-cli
-- chatId: ${ctx.chatId}
-- messageId: ${ctx.messageId}
+### 触发渠道（EventSource）
+- ES: ${esType}（${chatTypeLabel}）
+- chatId: ${chatId || "(缺失)"}
+- messageId: ${messageId || "(缺失)"}
 
 （这是中间态通知：仅作状态同步，**不要**回复用户，也不要调用 lark-cli 发消息。
 等收到 task.background.completed / failed / timeout / stopped 终态通知后再回复。）
 `;
-    const systemHint = actionable ? `回复必须用 lark-cli im +messages-reply（${profileFlag.trim() ? `带 ${profileFlag.trim()}；` : ""}` + `chatId=${ctx.chatId} / messageId=${ctx.messageId} 来自 trigger event，不要 fallback。` : `这是 ${notifyType} 中间态通知，不要回复用户；仅等待终态通知。`;
+    const systemHint = actionable ? `回复必须用 lark-cli im +messages-reply（${profileFlag.trim() ? `带 ${profileFlag.trim()}；` : ""}` + `chatId=${chatId} / messageId=${messageId} 来自 trigger event（esType=${esType}），不要 fallback。` + (input.ruleNotice?.delivered ? "系统回执已送达，只发增量。" : "") : `这是 ${notifyType} 中间态通知，不要回复用户；仅等待终态通知。`;
     return { promptText, systemHint };
   },
   setRunner(runner) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.58",
+  "version": "1.7.59",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",