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

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.58",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -11785,6 +11785,262 @@ 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 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;
+}
+var DEFAULT_SEND_TIMEOUT_MS = 5000;
+var MAX_IDEMPOTENCY_KEY_LEN = 50;
+function deriveTelemetryIdempotencyKey(eventId, chatId) {
+  const anchor = pickString(eventId) ?? `ts-${Date.now()}-${Math.random()}`;
+  return deriveIdempotencyKey(["telemetry", 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 +12093,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 +12116,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,9 +12167,45 @@ class EventHandler {
     if (this.isStopped) {
       return;
     }
+    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 formatted = await this.formatEvent(event);
     this.enqueue(formatted);
   }
+  async sendTelemetryNotice(event) {
+    try {
+      const metadata = event.metadata;
+      let target = targetFromEventMetadata(metadata);
+      if (!target) {
+        const triggerEventId = typeof metadata?.triggerEventId === "string" ? metadata.triggerEventId : undefined;
+        target = await targetFromTriggerEvent(this.eventStore, triggerEventId);
+      }
+      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) {
     if (NOTIFY_V2_TERMINAL_TYPES.has(event.type) && event.metadata?.triggerEventId && this.eventStore && this.getHandlerForEsType) {
       try {
@@ -12387,6 +12693,14 @@ __legacyDecorateClassTS([
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "handleEvent", 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),

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.58",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -11784,6 +11784,262 @@ 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 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;
+}
+var DEFAULT_SEND_TIMEOUT_MS = 5000;
+var MAX_IDEMPOTENCY_KEY_LEN = 50;
+function deriveTelemetryIdempotencyKey(eventId, chatId) {
+  const anchor = pickString(eventId) ?? `ts-${Date.now()}-${Math.random()}`;
+  return deriveIdempotencyKey(["telemetry", 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 +12092,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 +12115,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,9 +12166,45 @@ class EventHandler {
     if (this.isStopped) {
       return;
     }
+    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 formatted = await this.formatEvent(event);
     this.enqueue(formatted);
   }
+  async sendTelemetryNotice(event) {
+    try {
+      const metadata = event.metadata;
+      let target = targetFromEventMetadata(metadata);
+      if (!target) {
+        const triggerEventId = typeof metadata?.triggerEventId === "string" ? metadata.triggerEventId : undefined;
+        target = await targetFromTriggerEvent(this.eventStore, triggerEventId);
+      }
+      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) {
     if (NOTIFY_V2_TERMINAL_TYPES.has(event.type) && event.metadata?.triggerEventId && this.eventStore && this.getHandlerForEsType) {
       try {
@@ -12386,6 +12692,14 @@ __legacyDecorateClassTS([
   ]),
   __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], EventHandler.prototype, "handleEvent", 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),

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: 109897856 bytes
+sha256: 0343f071cd373c6540cd1f19d6a561e9cacce93efac9be7b3f424490521d7044

package/package.json

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