@ai-setting/roy-agent-cli 1.7.57 → 1.7.59

package/dist/bin/roy-agent.js

@@ -9639,7 +9639,7 @@ class CliQuietModeService {
 // package.json
 var package_default = {
   name: "@ai-setting/roy-agent-cli",
-  version: "1.7.57",
+  version: "1.7.59",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -11785,6 +11785,321 @@ import {
 } from "@ai-setting/roy-agent-core/env";
 import { TracedAs as TracedAs5 } from "@ai-setting/roy-agent-core";
 import { notifyReactFailure as notifyReactFailure2 } from "@ai-setting/roy-agent-core/env/error-reply";
+
+// src/commands/shared/telemetry-notice.ts
+import { spawn } from "node:child_process";
+import { normalizeLarkAtMentions } from "@ai-setting/roy-agent-core/env/lark-mention-utils";
+import { deriveIdempotencyKey } from "@ai-setting/roy-agent-core/env/event-source/idempotency-key";
+var TELEMETRY_EVENT_TYPES = new Set([
+  "task.background.started",
+  "task.background.progress"
+]);
+function isTelemetryEvent(type) {
+  if (!type)
+    return false;
+  return TELEMETRY_EVENT_TYPES.has(type);
+}
+var RULE_NOTICE_EVENT_TYPES = new Set([
+  "task.background.completed",
+  "task.background.timeout"
+]);
+function isRuleNoticeEvent(type) {
+  if (!type)
+    return false;
+  return RULE_NOTICE_EVENT_TYPES.has(type);
+}
+var MAX_TITLE_CHARS = 40;
+function pad2(n) {
+  return n < 10 ? `0${n}` : String(n);
+}
+function formatElapsed(ms) {
+  if (!Number.isFinite(ms) || ms <= 0)
+    return "0m";
+  const totalMin = Math.floor(ms / 60000);
+  if (totalMin < 60)
+    return `${totalMin}m`;
+  const totalHour = Math.floor(totalMin / 60);
+  const min = totalMin % 60;
+  if (totalHour < 24) {
+    return min === 0 ? `${totalHour}h` : `${totalHour}h${min}m`;
+  }
+  const day = Math.floor(totalHour / 24);
+  const hour = totalHour % 24;
+  return hour === 0 ? `${day}d` : `${day}d${hour}h`;
+}
+function formatClock(ts) {
+  const d = new Date(ts);
+  return `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+}
+function formatTimeoutLabel(ms) {
+  if (!Number.isFinite(ms) || ms <= 0)
+    return "0m";
+  return formatElapsed(ms);
+}
+function truncateTitle(raw) {
+  const s = raw.trim();
+  if (s.length <= MAX_TITLE_CHARS)
+    return s;
+  return `${s.slice(0, MAX_TITLE_CHARS)}…`;
+}
+function pickString(v) {
+  return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function pickNumber(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}
+function buildTelemetryNoticeText(type, payload, now = Date.now()) {
+  const p = payload ?? {};
+  const taskId = pickNumber(p.associatedTaskId);
+  const bgId = pickString(p.backgroundTaskId);
+  const desc = truncateTitle(pickString(p.description) ?? "后台任务");
+  let label;
+  if (taskId !== undefined)
+    label = `Task #${taskId}`;
+  else if (bgId)
+    label = bgId;
+  else
+    label = "后台任务";
+  const head = type === "task.background.started" ? `\uD83D\uDD14 ${label}「${desc}」已启动` : `\uD83D\uDD04 ${label}「${desc}」后台运行中`;
+  const parts = [];
+  const startedAt = pickNumber(p.startedAt);
+  const timeoutMs = pickNumber(p.timeoutMs);
+  if (type !== "task.background.started" && startedAt !== undefined) {
+    parts.push(`已跑 ${formatElapsed(now - startedAt)}`);
+  }
+  if (startedAt !== undefined && timeoutMs !== undefined) {
+    parts.push(`预计 ${formatClock(startedAt + timeoutMs)} 超时（timeout ${formatTimeoutLabel(timeoutMs)}）`);
+  }
+  let text = head;
+  if (parts.length > 0)
+    text += `
+${parts.join("，")}`;
+  const progressMessage = pickString(p.progressMessage);
+  if (progressMessage)
+    text += `
+${progressMessage}`;
+  return text;
+}
+function parseTimeoutMsFromError(error) {
+  if (!error)
+    return;
+  const m = error.match(/timeout after\s+(\d+)\s*ms/i);
+  if (!m)
+    return;
+  const n = Number(m[1]);
+  return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function buildTerminalNoticeText(type, payload) {
+  const p = payload ?? {};
+  const taskId = pickNumber(p.associatedTaskId);
+  const bgId = pickString(p.backgroundTaskId);
+  const desc = truncateTitle(pickString(p.description) ?? "后台任务");
+  let label;
+  if (taskId !== undefined)
+    label = `Task #${taskId}`;
+  else if (bgId)
+    label = bgId;
+  else
+    label = "后台任务";
+  const elapsedMs = pickNumber(p.executionTimeMs);
+  const elapsed = elapsedMs !== undefined ? formatElapsed(elapsedMs) : undefined;
+  if (type === "task.background.timeout") {
+    const timeoutMs = pickNumber(p.timeoutMs) ?? parseTimeoutMsFromError(p.error);
+    const parts = [];
+    if (elapsed)
+      parts.push(`跑了 ${elapsed}`);
+    if (timeoutMs !== undefined)
+      parts.push(`timeout ${formatTimeoutLabel(timeoutMs)}`);
+    const head = `⏱️ ${label}「${desc}」已超时`;
+    return parts.length > 0 ? `${head}（${parts.join("，")}）
+助手随后补充结论与下一步选项。` : `${head}
+助手随后补充结论与下一步选项。`;
+  }
+  if (type === "task.background.completed") {
+    const head = `✅ ${label}「${desc}」已完成`;
+    return elapsed ? `${head}（耗时 ${elapsed}）
+助手随后补充交付摘要。` : `${head}
+助手随后补充交付摘要。`;
+  }
+  const bgStatus = type.replace("task.background.", "");
+  return `ℹ️ ${label}「${desc}」${bgStatus}${elapsed ? `（耗时 ${elapsed}）` : ""}`;
+}
+var DEFAULT_SEND_TIMEOUT_MS = 5000;
+var MAX_IDEMPOTENCY_KEY_LEN = 50;
+function deriveTelemetryIdempotencyKey(eventId, chatId) {
+  return deriveNoticeIdempotencyKey("telemetry", eventId, chatId);
+}
+function deriveRuleNoticeIdempotencyKey(eventId, chatId) {
+  return deriveNoticeIdempotencyKey("rule", eventId, chatId);
+}
+function deriveNoticeIdempotencyKey(namespace, eventId, chatId) {
+  const anchor = pickString(eventId) ?? `ts-${Date.now()}-${Math.random()}`;
+  return deriveIdempotencyKey([namespace, anchor, chatId]);
+}
+function buildLarkSendArgs(input) {
+  const { chatId, text, profile, idempotencyKey } = input;
+  const args = [
+    "im",
+    "+messages-send",
+    "--chat-id",
+    chatId,
+    "--markdown",
+    normalizeLarkAtMentions(text),
+    "--as",
+    "bot"
+  ];
+  if (idempotencyKey) {
+    args.push("--idempotency-key", idempotencyKey.slice(0, MAX_IDEMPOTENCY_KEY_LEN));
+  }
+  if (profile)
+    args.unshift("--profile", profile);
+  return args;
+}
+function sendLarkChatMarkdown(options) {
+  const { chatId, text, profile, idempotencyKey } = options;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+  if (!chatId) {
+    return Promise.reject(new Error("sendLarkChatMarkdown: empty chatId"));
+  }
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let timer;
+    const finish = (err) => {
+      if (settled)
+        return;
+      settled = true;
+      if (timer)
+        clearTimeout(timer);
+      if (err)
+        reject(err);
+      else
+        resolve();
+    };
+    const args = buildLarkSendArgs({ chatId, text, profile, idempotencyKey });
+    let proc;
+    try {
+      proc = spawn("lark-cli", args, {
+        shell: false,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+    } catch (err) {
+      finish(err instanceof Error ? err : new Error(String(err)));
+      return;
+    }
+    let stderr = "";
+    proc.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    timer = setTimeout(() => {
+      try {
+        proc.kill("SIGKILL");
+      } catch {}
+      finish(new Error(`lark-cli timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    timer.unref?.();
+    proc.on("close", (code) => {
+      if (code === 0)
+        finish();
+      else
+        finish(new Error(`lark-cli exited with code ${code}: ${stderr}`));
+    });
+    proc.on("error", (err) => finish(err));
+  });
+}
+function targetFromEventMetadata(metadata) {
+  if (!metadata)
+    return;
+  const replyChannel = metadata.replyChannel;
+  const chatId = pickString(replyChannel?.chatId) ?? pickString(metadata.chatId);
+  if (!chatId)
+    return;
+  const profile = pickString(replyChannel?.profile) ?? pickString(metadata.profile);
+  return profile ? { chatId, profile } : { chatId };
+}
+async function targetFromTriggerEvent(eventStore, triggerEventId) {
+  if (!eventStore || !triggerEventId)
+    return;
+  let persisted;
+  try {
+    persisted = await eventStore.getEventById(triggerEventId);
+  } catch {
+    return;
+  }
+  if (!persisted || typeof persisted !== "object")
+    return;
+  const metadata = persisted.metadata;
+  if (!metadata || typeof metadata !== "object")
+    return;
+  return targetFromEventMetadata(metadata);
+}
+
+// src/commands/shared/self-echo-filter.ts
+var BOT_SENDER_TYPES = new Set(["bot", "app"]);
+function pickString2(v) {
+  return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function extractSenderIdentity(event) {
+  if (!event)
+    return {};
+  const metadata = event.metadata;
+  const payload = event.payload;
+  const payloadMeta = payload?.metadata;
+  const rawEvent = payload?.rawEvent;
+  const innerEvent = rawEvent?.event;
+  const innerSender = innerEvent?.sender;
+  const topSender = rawEvent?.sender;
+  const senderType = pickString2(metadata?.senderType) ?? pickString2(payloadMeta?.senderType) ?? pickString2(rawEvent?.sender_type) ?? pickString2(innerSender?.sender_type) ?? pickString2(topSender?.sender_type) ?? pickString2(payload?.senderType);
+  const nestedSenderId = innerSender?.sender_id ?? topSender?.sender_id;
+  const senderId = pickString2(metadata?.senderId) ?? pickString2(payloadMeta?.senderId) ?? pickString2(payload?.senderId) ?? pickString2(rawEvent?.sender_id) ?? (typeof nestedSenderId === "string" ? pickString2(nestedSenderId) : pickString2(nestedSenderId?.open_id) ?? pickString2(nestedSenderId?.user_id) ?? pickString2(nestedSenderId?.union_id));
+  return {
+    ...senderType ? { senderType } : {},
+    ...senderId ? { senderId } : {}
+  };
+}
+function isSelfEchoEvent(event, options = {}) {
+  const { senderType, senderId } = extractSenderIdentity(event);
+  if (options.enabled === false) {
+    return {
+      skip: false,
+      reason: "disabled",
+      ...senderType ? { senderType } : {},
+      ...senderId ? { senderId } : {}
+    };
+  }
+  if (senderType && BOT_SENDER_TYPES.has(senderType.toLowerCase())) {
+    return {
+      skip: true,
+      reason: "bot-sender",
+      ...senderType ? { senderType } : {},
+      ...senderId ? { senderId } : {}
+    };
+  }
+  if (senderId && options.selfBotIds && options.selfBotIds.length > 0) {
+    if (options.selfBotIds.includes(senderId)) {
+      return {
+        skip: true,
+        reason: "self-bot-id",
+        ...senderType ? { senderType } : {},
+        senderId
+      };
+    }
+  }
+  return {
+    skip: false,
+    ...senderType ? { senderType } : {},
+    ...senderId ? { senderId } : {}
+  };
+}
+var SELF_ECHO_FILTER_ENABLED_ENV = "ROY_AGENT_SELF_ECHO_FILTER";
+function readSelfEchoFilterEnabled(env = process.env) {
+  const raw = env[SELF_ECHO_FILTER_ENABLED_ENV];
+  if (raw === undefined)
+    return true;
+  const v = raw.trim().toLowerCase();
+  return !(v === "0" || v === "false" || v === "off" || v === "no");
+}
+
+// src/commands/shared/event-handler.ts
 function parseLarkPerTaskChatId(contextJson) {
   if (!contextJson)
     return;
@@ -11837,6 +12152,15 @@ class EventHandler {
   resolvedSessionByTrigger = new Map;
   eventStore = null;
   getHandlerForEsType = null;
+  telemetrySender = (notice) => sendLarkChatMarkdown(notice);
+  selfEchoFilter = {
+    enabled: true,
+    selfBotIds: []
+  };
+  selfEchoDroppedCount = 0;
+  getSelfEchoDroppedCount() {
+    return this.selfEchoDroppedCount;
+  }
   constructor(options) {
     this.env = options.env;
     this.eventTypes = options.eventTypes;
@@ -11851,6 +12175,11 @@ class EventHandler {
     this.sessionComponent = options.sessionComponent ?? null;
     this.eventStore = options.eventStore ?? null;
     this.getHandlerForEsType = options.getHandlerForEsType ?? null;
+    this.telemetrySender = options.telemetrySender ?? ((notice) => sendLarkChatMarkdown(notice));
+    this.selfEchoFilter = {
+      enabled: options.selfEchoFilter?.enabled ?? readSelfEchoFilterEnabled(),
+      selfBotIds: options.selfEchoFilter?.selfBotIds ?? []
+    };
   }
   start() {
     this.isStopped = false;
@@ -11897,13 +12226,82 @@ class EventHandler {
     if (this.isStopped) {
       return;
     }
-    const formatted = await this.formatEvent(event);
+    if (this.selfEchoFilter.enabled) {
+      const verdict = isSelfEchoEvent(event, {
+        selfBotIds: this.selfEchoFilter.selfBotIds
+      });
+      if (verdict.skip) {
+        this.selfEchoDroppedCount += 1;
+        console.error(`[EventHandler] self-echo event dropped (reason=${verdict.reason}` + `, senderType=${verdict.senderType ?? "-"}` + `, senderId=${verdict.senderId ?? "-"}` + `, type=${event.type})`);
+        return;
+      }
+    }
+    if (isTelemetryEvent(event.type)) {
+      this.sendTelemetryNotice(event);
+      return;
+    }
+    const ruleNotice = isRuleNoticeEvent(event.type) ? await this.sendRuleNotice(event) : undefined;
+    const formatted = await this.formatEvent(event, { ruleNotice });
     this.enqueue(formatted);
   }
-  async formatEvent(event) {
+  async resolveNoticeTarget(event) {
+    const metadata = event.metadata;
+    const target = targetFromEventMetadata(metadata);
+    if (target)
+      return target;
+    const triggerEventId = typeof metadata?.triggerEventId === "string" ? metadata.triggerEventId : undefined;
+    return targetFromTriggerEvent(this.eventStore, triggerEventId);
+  }
+  async sendRuleNotice(event) {
+    try {
+      const target = await this.resolveNoticeTarget(event);
+      if (!target) {
+        return { attempted: true, delivered: false, error: "no-target" };
+      }
+      const text = buildTerminalNoticeText(event.type, event.payload);
+      await this.telemetrySender({
+        chatId: target.chatId,
+        ...target.profile ? { profile: target.profile } : {},
+        text,
+        idempotencyKey: deriveRuleNoticeIdempotencyKey(event.id, target.chatId)
+      });
+      return {
+        attempted: true,
+        delivered: true,
+        chatId: target.chatId,
+        text,
+        sentAt: Date.now()
+      };
+    } catch (err) {
+      console.error(`[EventHandler] rule notice failed (swallowed) type=${event.type}`, err);
+      return {
+        attempted: true,
+        delivered: false,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async sendTelemetryNotice(event) {
+    try {
+      const target = await this.resolveNoticeTarget(event);
+      if (!target) {
+        return;
+      }
+      const text = buildTelemetryNoticeText(event.type, event.payload);
+      await this.telemetrySender({
+        chatId: target.chatId,
+        ...target.profile ? { profile: target.profile } : {},
+        text,
+        idempotencyKey: deriveTelemetryIdempotencyKey(event.id, target.chatId)
+      });
+    } catch (err) {
+      console.error(`[EventHandler] telemetry notice failed (swallowed) type=${event.type}`, err);
+    }
+  }
+  async formatEvent(event, opts = {}) {
     if (NOTIFY_V2_TERMINAL_TYPES.has(event.type) && event.metadata?.triggerEventId && this.eventStore && this.getHandlerForEsType) {
       try {
-        const v2Formatted = await this.formatEventViaESPluginV2(event);
+        const v2Formatted = await this.formatEventViaESPluginV2(event, opts.ruleNotice);
         if (v2Formatted) {
           return v2Formatted;
         }
@@ -11913,7 +12311,26 @@ class EventHandler {
     }
     return this.formatter.formatWithEvent(event);
   }
-  async formatEventViaESPluginV2(event) {
+  buildNotifyChannelInfo(triggerEvent, handler, profile) {
+    const meta = triggerEvent.metadata ?? {};
+    const ctx = handler.extractReplyContext?.(triggerEvent, profile);
+    const chatId = ctx?.chatId || meta.chatId || undefined;
+    const messageId = ctx?.messageId || meta.messageId || undefined;
+    const senderId = ctx?.senderOpenId || meta.senderId || undefined;
+    const resolvedProfile = ctx?.profile ?? profile ?? meta.profile;
+    const rawChatType = meta.chatType;
+    const chatType = rawChatType === "group" || rawChatType === "p2p" ? rawChatType : "unknown";
+    return {
+      esType: triggerEvent.esType ?? handler.type,
+      ...chatId ? { chatId } : {},
+      chatType,
+      ...messageId ? { messageId } : {},
+      ...senderId ? { senderId } : {},
+      ...resolvedProfile ? { profile: resolvedProfile } : {},
+      replyKind: chatId ? messageId ? "reply" : "send" : "none"
+    };
+  }
+  async formatEventViaESPluginV2(event, ruleNotice) {
     const triggerEventId = event.metadata.triggerEventId;
     const triggerEvent = await this.eventStore.getEventById(triggerEventId);
     if (!triggerEvent) {
@@ -11928,17 +12345,21 @@ class EventHandler {
       summary: typeof payload?.result === "string" ? payload.result : typeof payload?.error === "string" ? payload.error : "(无结果)"
     };
     const profile = triggerEvent.metadata?.profile ?? undefined;
+    const channel = this.buildNotifyChannelInfo(triggerEvent, handler, profile);
     const prompt = handler.buildNotifyHandlePrompt({
       notifyEvent: {
         type: event.type,
         taskId: typeof payload?.associatedTaskId === "number" ? payload.associatedTaskId : undefined,
         description: typeof payload?.description === "string" ? payload.description : undefined,
         result: typeof payload?.result === "string" ? payload.result : undefined,
-        error: typeof payload?.error === "string" ? payload.error : undefined
+        error: typeof payload?.error === "string" ? payload.error : undefined,
+        subSessionId: typeof payload?.subSessionId === "string" ? payload.subSessionId : undefined
       },
       triggerEvent,
       subAgentResult,
-      profile
+      profile,
+      channel,
+      ...ruleNotice ? { ruleNotice } : {}
     });
     if (handler.postProcessNotifyEvent) {
       const notifyEventForHook = {
@@ -12388,18 +12809,36 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "handleEvent", null);
 __legacyDecorateClassTS([
-  TracedAs5("cli.event-handler.formatEvent", { recordParams: true, recordResult: false }),
+  TracedAs5("event_handler.rule_notice", { recordParams: true, recordResult: false }),
   __legacyMetadataTS("design:type", Function),
   __legacyMetadataTS("design:paramtypes", [
     typeof EnvEvent === "undefined" ? Object : EnvEvent
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], EventHandler.prototype, "sendRuleNotice", null);
+__legacyDecorateClassTS([
+  TracedAs5("event_handler.telemetry_notice", { recordParams: true, recordResult: false }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof EnvEvent === "undefined" ? Object : EnvEvent
+  ]),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], EventHandler.prototype, "sendTelemetryNotice", null);
+__legacyDecorateClassTS([
+  TracedAs5("cli.event-handler.formatEvent", { recordParams: true, recordResult: false }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof EnvEvent === "undefined" ? Object : EnvEvent,
+    Object
+  ]),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "formatEvent", null);
 __legacyDecorateClassTS([
   TracedAs5("event_handler.process_notify", { recordParams: true, recordResult: false }),
   __legacyMetadataTS("design:type", Function),
   __legacyMetadataTS("design:paramtypes", [
-    typeof EnvEvent === "undefined" ? Object : EnvEvent
+    typeof EnvEvent === "undefined" ? Object : EnvEvent,
+    typeof RuleNoticeInfo === "undefined" ? Object : RuleNoticeInfo
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "formatEventViaESPluginV2", null);

package/dist/index.js

@@ -9638,7 +9638,7 @@ class CliQuietModeService {
 // package.json
 var package_default = {
   name: "@ai-setting/roy-agent-cli",
-  version: "1.7.57",
+  version: "1.7.59",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -11784,6 +11784,321 @@ import {
 } from "@ai-setting/roy-agent-core/env";
 import { TracedAs as TracedAs5 } from "@ai-setting/roy-agent-core";
 import { notifyReactFailure as notifyReactFailure2 } from "@ai-setting/roy-agent-core/env/error-reply";
+
+// src/commands/shared/telemetry-notice.ts
+import { spawn } from "node:child_process";
+import { normalizeLarkAtMentions } from "@ai-setting/roy-agent-core/env/lark-mention-utils";
+import { deriveIdempotencyKey } from "@ai-setting/roy-agent-core/env/event-source/idempotency-key";
+var TELEMETRY_EVENT_TYPES = new Set([
+  "task.background.started",
+  "task.background.progress"
+]);
+function isTelemetryEvent(type) {
+  if (!type)
+    return false;
+  return TELEMETRY_EVENT_TYPES.has(type);
+}
+var RULE_NOTICE_EVENT_TYPES = new Set([
+  "task.background.completed",
+  "task.background.timeout"
+]);
+function isRuleNoticeEvent(type) {
+  if (!type)
+    return false;
+  return RULE_NOTICE_EVENT_TYPES.has(type);
+}
+var MAX_TITLE_CHARS = 40;
+function pad2(n) {
+  return n < 10 ? `0${n}` : String(n);
+}
+function formatElapsed(ms) {
+  if (!Number.isFinite(ms) || ms <= 0)
+    return "0m";
+  const totalMin = Math.floor(ms / 60000);
+  if (totalMin < 60)
+    return `${totalMin}m`;
+  const totalHour = Math.floor(totalMin / 60);
+  const min = totalMin % 60;
+  if (totalHour < 24) {
+    return min === 0 ? `${totalHour}h` : `${totalHour}h${min}m`;
+  }
+  const day = Math.floor(totalHour / 24);
+  const hour = totalHour % 24;
+  return hour === 0 ? `${day}d` : `${day}d${hour}h`;
+}
+function formatClock(ts) {
+  const d = new Date(ts);
+  return `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+}
+function formatTimeoutLabel(ms) {
+  if (!Number.isFinite(ms) || ms <= 0)
+    return "0m";
+  return formatElapsed(ms);
+}
+function truncateTitle(raw) {
+  const s = raw.trim();
+  if (s.length <= MAX_TITLE_CHARS)
+    return s;
+  return `${s.slice(0, MAX_TITLE_CHARS)}…`;
+}
+function pickString(v) {
+  return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function pickNumber(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}
+function buildTelemetryNoticeText(type, payload, now = Date.now()) {
+  const p = payload ?? {};
+  const taskId = pickNumber(p.associatedTaskId);
+  const bgId = pickString(p.backgroundTaskId);
+  const desc = truncateTitle(pickString(p.description) ?? "后台任务");
+  let label;
+  if (taskId !== undefined)
+    label = `Task #${taskId}`;
+  else if (bgId)
+    label = bgId;
+  else
+    label = "后台任务";
+  const head = type === "task.background.started" ? `\uD83D\uDD14 ${label}「${desc}」已启动` : `\uD83D\uDD04 ${label}「${desc}」后台运行中`;
+  const parts = [];
+  const startedAt = pickNumber(p.startedAt);
+  const timeoutMs = pickNumber(p.timeoutMs);
+  if (type !== "task.background.started" && startedAt !== undefined) {
+    parts.push(`已跑 ${formatElapsed(now - startedAt)}`);
+  }
+  if (startedAt !== undefined && timeoutMs !== undefined) {
+    parts.push(`预计 ${formatClock(startedAt + timeoutMs)} 超时（timeout ${formatTimeoutLabel(timeoutMs)}）`);
+  }
+  let text = head;
+  if (parts.length > 0)
+    text += `
+${parts.join("，")}`;
+  const progressMessage = pickString(p.progressMessage);
+  if (progressMessage)
+    text += `
+${progressMessage}`;
+  return text;
+}
+function parseTimeoutMsFromError(error) {
+  if (!error)
+    return;
+  const m = error.match(/timeout after\s+(\d+)\s*ms/i);
+  if (!m)
+    return;
+  const n = Number(m[1]);
+  return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function buildTerminalNoticeText(type, payload) {
+  const p = payload ?? {};
+  const taskId = pickNumber(p.associatedTaskId);
+  const bgId = pickString(p.backgroundTaskId);
+  const desc = truncateTitle(pickString(p.description) ?? "后台任务");
+  let label;
+  if (taskId !== undefined)
+    label = `Task #${taskId}`;
+  else if (bgId)
+    label = bgId;
+  else
+    label = "后台任务";
+  const elapsedMs = pickNumber(p.executionTimeMs);
+  const elapsed = elapsedMs !== undefined ? formatElapsed(elapsedMs) : undefined;
+  if (type === "task.background.timeout") {
+    const timeoutMs = pickNumber(p.timeoutMs) ?? parseTimeoutMsFromError(p.error);
+    const parts = [];
+    if (elapsed)
+      parts.push(`跑了 ${elapsed}`);
+    if (timeoutMs !== undefined)
+      parts.push(`timeout ${formatTimeoutLabel(timeoutMs)}`);
+    const head = `⏱️ ${label}「${desc}」已超时`;
+    return parts.length > 0 ? `${head}（${parts.join("，")}）
+助手随后补充结论与下一步选项。` : `${head}
+助手随后补充结论与下一步选项。`;
+  }
+  if (type === "task.background.completed") {
+    const head = `✅ ${label}「${desc}」已完成`;
+    return elapsed ? `${head}（耗时 ${elapsed}）
+助手随后补充交付摘要。` : `${head}
+助手随后补充交付摘要。`;
+  }
+  const bgStatus = type.replace("task.background.", "");
+  return `ℹ️ ${label}「${desc}」${bgStatus}${elapsed ? `（耗时 ${elapsed}）` : ""}`;
+}
+var DEFAULT_SEND_TIMEOUT_MS = 5000;
+var MAX_IDEMPOTENCY_KEY_LEN = 50;
+function deriveTelemetryIdempotencyKey(eventId, chatId) {
+  return deriveNoticeIdempotencyKey("telemetry", eventId, chatId);
+}
+function deriveRuleNoticeIdempotencyKey(eventId, chatId) {
+  return deriveNoticeIdempotencyKey("rule", eventId, chatId);
+}
+function deriveNoticeIdempotencyKey(namespace, eventId, chatId) {
+  const anchor = pickString(eventId) ?? `ts-${Date.now()}-${Math.random()}`;
+  return deriveIdempotencyKey([namespace, anchor, chatId]);
+}
+function buildLarkSendArgs(input) {
+  const { chatId, text, profile, idempotencyKey } = input;
+  const args = [
+    "im",
+    "+messages-send",
+    "--chat-id",
+    chatId,
+    "--markdown",
+    normalizeLarkAtMentions(text),
+    "--as",
+    "bot"
+  ];
+  if (idempotencyKey) {
+    args.push("--idempotency-key", idempotencyKey.slice(0, MAX_IDEMPOTENCY_KEY_LEN));
+  }
+  if (profile)
+    args.unshift("--profile", profile);
+  return args;
+}
+function sendLarkChatMarkdown(options) {
+  const { chatId, text, profile, idempotencyKey } = options;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+  if (!chatId) {
+    return Promise.reject(new Error("sendLarkChatMarkdown: empty chatId"));
+  }
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let timer;
+    const finish = (err) => {
+      if (settled)
+        return;
+      settled = true;
+      if (timer)
+        clearTimeout(timer);
+      if (err)
+        reject(err);
+      else
+        resolve();
+    };
+    const args = buildLarkSendArgs({ chatId, text, profile, idempotencyKey });
+    let proc;
+    try {
+      proc = spawn("lark-cli", args, {
+        shell: false,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+    } catch (err) {
+      finish(err instanceof Error ? err : new Error(String(err)));
+      return;
+    }
+    let stderr = "";
+    proc.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    timer = setTimeout(() => {
+      try {
+        proc.kill("SIGKILL");
+      } catch {}
+      finish(new Error(`lark-cli timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    timer.unref?.();
+    proc.on("close", (code) => {
+      if (code === 0)
+        finish();
+      else
+        finish(new Error(`lark-cli exited with code ${code}: ${stderr}`));
+    });
+    proc.on("error", (err) => finish(err));
+  });
+}
+function targetFromEventMetadata(metadata) {
+  if (!metadata)
+    return;
+  const replyChannel = metadata.replyChannel;
+  const chatId = pickString(replyChannel?.chatId) ?? pickString(metadata.chatId);
+  if (!chatId)
+    return;
+  const profile = pickString(replyChannel?.profile) ?? pickString(metadata.profile);
+  return profile ? { chatId, profile } : { chatId };
+}
+async function targetFromTriggerEvent(eventStore, triggerEventId) {
+  if (!eventStore || !triggerEventId)
+    return;
+  let persisted;
+  try {
+    persisted = await eventStore.getEventById(triggerEventId);
+  } catch {
+    return;
+  }
+  if (!persisted || typeof persisted !== "object")
+    return;
+  const metadata = persisted.metadata;
+  if (!metadata || typeof metadata !== "object")
+    return;
+  return targetFromEventMetadata(metadata);
+}
+
+// src/commands/shared/self-echo-filter.ts
+var BOT_SENDER_TYPES = new Set(["bot", "app"]);
+function pickString2(v) {
+  return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function extractSenderIdentity(event) {
+  if (!event)
+    return {};
+  const metadata = event.metadata;
+  const payload = event.payload;
+  const payloadMeta = payload?.metadata;
+  const rawEvent = payload?.rawEvent;
+  const innerEvent = rawEvent?.event;
+  const innerSender = innerEvent?.sender;
+  const topSender = rawEvent?.sender;
+  const senderType = pickString2(metadata?.senderType) ?? pickString2(payloadMeta?.senderType) ?? pickString2(rawEvent?.sender_type) ?? pickString2(innerSender?.sender_type) ?? pickString2(topSender?.sender_type) ?? pickString2(payload?.senderType);
+  const nestedSenderId = innerSender?.sender_id ?? topSender?.sender_id;
+  const senderId = pickString2(metadata?.senderId) ?? pickString2(payloadMeta?.senderId) ?? pickString2(payload?.senderId) ?? pickString2(rawEvent?.sender_id) ?? (typeof nestedSenderId === "string" ? pickString2(nestedSenderId) : pickString2(nestedSenderId?.open_id) ?? pickString2(nestedSenderId?.user_id) ?? pickString2(nestedSenderId?.union_id));
+  return {
+    ...senderType ? { senderType } : {},
+    ...senderId ? { senderId } : {}
+  };
+}
+function isSelfEchoEvent(event, options = {}) {
+  const { senderType, senderId } = extractSenderIdentity(event);
+  if (options.enabled === false) {
+    return {
+      skip: false,
+      reason: "disabled",
+      ...senderType ? { senderType } : {},
+      ...senderId ? { senderId } : {}
+    };
+  }
+  if (senderType && BOT_SENDER_TYPES.has(senderType.toLowerCase())) {
+    return {
+      skip: true,
+      reason: "bot-sender",
+      ...senderType ? { senderType } : {},
+      ...senderId ? { senderId } : {}
+    };
+  }
+  if (senderId && options.selfBotIds && options.selfBotIds.length > 0) {
+    if (options.selfBotIds.includes(senderId)) {
+      return {
+        skip: true,
+        reason: "self-bot-id",
+        ...senderType ? { senderType } : {},
+        senderId
+      };
+    }
+  }
+  return {
+    skip: false,
+    ...senderType ? { senderType } : {},
+    ...senderId ? { senderId } : {}
+  };
+}
+var SELF_ECHO_FILTER_ENABLED_ENV = "ROY_AGENT_SELF_ECHO_FILTER";
+function readSelfEchoFilterEnabled(env = process.env) {
+  const raw = env[SELF_ECHO_FILTER_ENABLED_ENV];
+  if (raw === undefined)
+    return true;
+  const v = raw.trim().toLowerCase();
+  return !(v === "0" || v === "false" || v === "off" || v === "no");
+}
+
+// src/commands/shared/event-handler.ts
 function parseLarkPerTaskChatId(contextJson) {
   if (!contextJson)
     return;
@@ -11836,6 +12151,15 @@ class EventHandler {
   resolvedSessionByTrigger = new Map;
   eventStore = null;
   getHandlerForEsType = null;
+  telemetrySender = (notice) => sendLarkChatMarkdown(notice);
+  selfEchoFilter = {
+    enabled: true,
+    selfBotIds: []
+  };
+  selfEchoDroppedCount = 0;
+  getSelfEchoDroppedCount() {
+    return this.selfEchoDroppedCount;
+  }
   constructor(options) {
     this.env = options.env;
     this.eventTypes = options.eventTypes;
@@ -11850,6 +12174,11 @@ class EventHandler {
     this.sessionComponent = options.sessionComponent ?? null;
     this.eventStore = options.eventStore ?? null;
     this.getHandlerForEsType = options.getHandlerForEsType ?? null;
+    this.telemetrySender = options.telemetrySender ?? ((notice) => sendLarkChatMarkdown(notice));
+    this.selfEchoFilter = {
+      enabled: options.selfEchoFilter?.enabled ?? readSelfEchoFilterEnabled(),
+      selfBotIds: options.selfEchoFilter?.selfBotIds ?? []
+    };
   }
   start() {
     this.isStopped = false;
@@ -11896,13 +12225,82 @@ class EventHandler {
     if (this.isStopped) {
       return;
     }
-    const formatted = await this.formatEvent(event);
+    if (this.selfEchoFilter.enabled) {
+      const verdict = isSelfEchoEvent(event, {
+        selfBotIds: this.selfEchoFilter.selfBotIds
+      });
+      if (verdict.skip) {
+        this.selfEchoDroppedCount += 1;
+        console.error(`[EventHandler] self-echo event dropped (reason=${verdict.reason}` + `, senderType=${verdict.senderType ?? "-"}` + `, senderId=${verdict.senderId ?? "-"}` + `, type=${event.type})`);
+        return;
+      }
+    }
+    if (isTelemetryEvent(event.type)) {
+      this.sendTelemetryNotice(event);
+      return;
+    }
+    const ruleNotice = isRuleNoticeEvent(event.type) ? await this.sendRuleNotice(event) : undefined;
+    const formatted = await this.formatEvent(event, { ruleNotice });
     this.enqueue(formatted);
   }
-  async formatEvent(event) {
+  async resolveNoticeTarget(event) {
+    const metadata = event.metadata;
+    const target = targetFromEventMetadata(metadata);
+    if (target)
+      return target;
+    const triggerEventId = typeof metadata?.triggerEventId === "string" ? metadata.triggerEventId : undefined;
+    return targetFromTriggerEvent(this.eventStore, triggerEventId);
+  }
+  async sendRuleNotice(event) {
+    try {
+      const target = await this.resolveNoticeTarget(event);
+      if (!target) {
+        return { attempted: true, delivered: false, error: "no-target" };
+      }
+      const text = buildTerminalNoticeText(event.type, event.payload);
+      await this.telemetrySender({
+        chatId: target.chatId,
+        ...target.profile ? { profile: target.profile } : {},
+        text,
+        idempotencyKey: deriveRuleNoticeIdempotencyKey(event.id, target.chatId)
+      });
+      return {
+        attempted: true,
+        delivered: true,
+        chatId: target.chatId,
+        text,
+        sentAt: Date.now()
+      };
+    } catch (err) {
+      console.error(`[EventHandler] rule notice failed (swallowed) type=${event.type}`, err);
+      return {
+        attempted: true,
+        delivered: false,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async sendTelemetryNotice(event) {
+    try {
+      const target = await this.resolveNoticeTarget(event);
+      if (!target) {
+        return;
+      }
+      const text = buildTelemetryNoticeText(event.type, event.payload);
+      await this.telemetrySender({
+        chatId: target.chatId,
+        ...target.profile ? { profile: target.profile } : {},
+        text,
+        idempotencyKey: deriveTelemetryIdempotencyKey(event.id, target.chatId)
+      });
+    } catch (err) {
+      console.error(`[EventHandler] telemetry notice failed (swallowed) type=${event.type}`, err);
+    }
+  }
+  async formatEvent(event, opts = {}) {
     if (NOTIFY_V2_TERMINAL_TYPES.has(event.type) && event.metadata?.triggerEventId && this.eventStore && this.getHandlerForEsType) {
       try {
-        const v2Formatted = await this.formatEventViaESPluginV2(event);
+        const v2Formatted = await this.formatEventViaESPluginV2(event, opts.ruleNotice);
         if (v2Formatted) {
           return v2Formatted;
         }
@@ -11912,7 +12310,26 @@ class EventHandler {
     }
     return this.formatter.formatWithEvent(event);
   }
-  async formatEventViaESPluginV2(event) {
+  buildNotifyChannelInfo(triggerEvent, handler, profile) {
+    const meta = triggerEvent.metadata ?? {};
+    const ctx = handler.extractReplyContext?.(triggerEvent, profile);
+    const chatId = ctx?.chatId || meta.chatId || undefined;
+    const messageId = ctx?.messageId || meta.messageId || undefined;
+    const senderId = ctx?.senderOpenId || meta.senderId || undefined;
+    const resolvedProfile = ctx?.profile ?? profile ?? meta.profile;
+    const rawChatType = meta.chatType;
+    const chatType = rawChatType === "group" || rawChatType === "p2p" ? rawChatType : "unknown";
+    return {
+      esType: triggerEvent.esType ?? handler.type,
+      ...chatId ? { chatId } : {},
+      chatType,
+      ...messageId ? { messageId } : {},
+      ...senderId ? { senderId } : {},
+      ...resolvedProfile ? { profile: resolvedProfile } : {},
+      replyKind: chatId ? messageId ? "reply" : "send" : "none"
+    };
+  }
+  async formatEventViaESPluginV2(event, ruleNotice) {
     const triggerEventId = event.metadata.triggerEventId;
     const triggerEvent = await this.eventStore.getEventById(triggerEventId);
     if (!triggerEvent) {
@@ -11927,17 +12344,21 @@ class EventHandler {
       summary: typeof payload?.result === "string" ? payload.result : typeof payload?.error === "string" ? payload.error : "(无结果)"
     };
     const profile = triggerEvent.metadata?.profile ?? undefined;
+    const channel = this.buildNotifyChannelInfo(triggerEvent, handler, profile);
     const prompt = handler.buildNotifyHandlePrompt({
       notifyEvent: {
         type: event.type,
         taskId: typeof payload?.associatedTaskId === "number" ? payload.associatedTaskId : undefined,
         description: typeof payload?.description === "string" ? payload.description : undefined,
         result: typeof payload?.result === "string" ? payload.result : undefined,
-        error: typeof payload?.error === "string" ? payload.error : undefined
+        error: typeof payload?.error === "string" ? payload.error : undefined,
+        subSessionId: typeof payload?.subSessionId === "string" ? payload.subSessionId : undefined
       },
       triggerEvent,
       subAgentResult,
-      profile
+      profile,
+      channel,
+      ...ruleNotice ? { ruleNotice } : {}
     });
     if (handler.postProcessNotifyEvent) {
       const notifyEventForHook = {
@@ -12387,18 +12808,36 @@ __legacyDecorateClassTS([
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "handleEvent", null);
 __legacyDecorateClassTS([
-  TracedAs5("cli.event-handler.formatEvent", { recordParams: true, recordResult: false }),
+  TracedAs5("event_handler.rule_notice", { recordParams: true, recordResult: false }),
   __legacyMetadataTS("design:type", Function),
   __legacyMetadataTS("design:paramtypes", [
     typeof EnvEvent === "undefined" ? Object : EnvEvent
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], EventHandler.prototype, "sendRuleNotice", null);
+__legacyDecorateClassTS([
+  TracedAs5("event_handler.telemetry_notice", { recordParams: true, recordResult: false }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof EnvEvent === "undefined" ? Object : EnvEvent
+  ]),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], EventHandler.prototype, "sendTelemetryNotice", null);
+__legacyDecorateClassTS([
+  TracedAs5("cli.event-handler.formatEvent", { recordParams: true, recordResult: false }),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof EnvEvent === "undefined" ? Object : EnvEvent,
+    Object
+  ]),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "formatEvent", null);
 __legacyDecorateClassTS([
   TracedAs5("event_handler.process_notify", { recordParams: true, recordResult: false }),
   __legacyMetadataTS("design:type", Function),
   __legacyMetadataTS("design:paramtypes", [
-    typeof EnvEvent === "undefined" ? Object : EnvEvent
+    typeof EnvEvent === "undefined" ? Object : EnvEvent,
+    typeof RuleNoticeInfo === "undefined" ? Object : RuleNoticeInfo
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "formatEventViaESPluginV2", null);

package/dist/roy-agent-linux-x64/bin/roy-agent

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/roy-agent-linux-x64/bin/roy-agent
-size: 109885568 bytes
-sha256: 3a69d105f14b338232ff69fa3b1210da25fb37594d63457ccbf30f7fe3d973a5
+size: 109906048 bytes
+sha256: a97336c59bd5ce3cada998cc8b03fec204414ec9ecc0995b494c0a3f6613d1b2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-cli",
-  "version": "1.7.57",
+  "version": "1.7.59",
   "type": "module",
   "description": "CLI for roy-agent - Non-interactive command execution",
   "main": "./dist/index.js",