@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/channel/event-handlers.js

@@ -0,0 +1,175 @@
+import { handleFeishuMessage } from "../messaging/inbound/handler";
+import { handleFeishuReaction, resolveReactionContext } from "../messaging/inbound/reaction-handler";
+import { isMessageExpired } from "../messaging/inbound/dedup";
+import { withTicket } from "../core/lark-ticket";
+import { larkLogger } from "../core/lark-logger";
+import { handleCardAction } from "../tools/auto-auth";
+import { enqueueFeishuChatTask, buildQueueKey, hasActiveTask, getActiveDispatcher } from "./chat-queue";
+import { extractRawTextFromEvent, isLikelyAbortText } from "./abort-detect";
+const elog = larkLogger("channel/event-handlers");
+function isEventOwnershipValid(ctx, data) {
+  const expectedAppId = ctx.lark.account.appId;
+  if (!expectedAppId) return true;
+  const eventAppId = data.app_id;
+  if (eventAppId == null) return true;
+  if (eventAppId !== expectedAppId) {
+    elog.warn("event app_id mismatch, discarding", {
+      accountId: ctx.accountId,
+      expected: expectedAppId,
+      received: String(eventAppId)
+    });
+    return false;
+  }
+  return true;
+}
+async function handleMessageEvent(ctx, data) {
+  if (!isEventOwnershipValid(ctx, data)) return;
+  const { accountId, log, error } = ctx;
+  try {
+    const event = data;
+    const msgId = event.message?.message_id ?? "unknown";
+    const chatId = event.message?.chat_id ?? "";
+    const threadId = event.message?.thread_id || void 0;
+    if (!ctx.messageDedup.tryRecord(msgId, accountId)) {
+      log(`feishu[${accountId}]: duplicate message ${msgId}, skipping`);
+      return;
+    }
+    if (isMessageExpired(event.message?.create_time)) {
+      log(`feishu[${accountId}]: message ${msgId} expired, discarding`);
+      return;
+    }
+    const abortText = extractRawTextFromEvent(event);
+    if (abortText && isLikelyAbortText(abortText)) {
+      const queueKey = buildQueueKey(accountId, chatId, threadId);
+      if (hasActiveTask(queueKey)) {
+        const active = getActiveDispatcher(queueKey);
+        if (active) {
+          log(`feishu[${accountId}]: abort fast-path triggered for chat ${chatId} (text="${abortText}")`);
+          active.abortController?.abort();
+          active.abortCard().catch((err) => {
+            error(`feishu[${accountId}]: abort fast-path abortCard failed: ${String(err)}`);
+          });
+        }
+      }
+    }
+    const { status } = enqueueFeishuChatTask({
+      accountId,
+      chatId,
+      threadId,
+      task: async () => {
+        try {
+          await withTicket(
+            {
+              messageId: msgId,
+              chatId,
+              accountId,
+              startTime: Date.now(),
+              senderOpenId: event.sender?.sender_id?.open_id || "",
+              chatType: event.message?.chat_type || void 0,
+              threadId
+            },
+            () => handleFeishuMessage({
+              cfg: ctx.cfg,
+              event,
+              botOpenId: ctx.lark.botOpenId,
+              runtime: ctx.runtime,
+              chatHistories: ctx.chatHistories,
+              accountId
+            })
+          );
+        } catch (err) {
+          error(`feishu[${accountId}]: error handling message: ${String(err)}`);
+        }
+      }
+    });
+    log(`feishu[${accountId}]: message ${msgId} in chat ${chatId}${threadId ? ` thread ${threadId}` : ""} \u2014 ${status}`);
+  } catch (err) {
+    error(`feishu[${accountId}]: error handling message: ${String(err)}`);
+  }
+}
+async function handleReactionEvent(ctx, data) {
+  if (!isEventOwnershipValid(ctx, data)) return;
+  const { accountId, log, error } = ctx;
+  try {
+    const event = data;
+    const msgId = event.message_id ?? "unknown";
+    log(`feishu[${accountId}]: reaction event on message ${msgId}`);
+    const emojiType = event.reaction_type?.emoji_type ?? "";
+    const operatorOpenId = event.user_id?.open_id ?? "";
+    const dedupKey = `${msgId}:reaction:${emojiType}:${operatorOpenId}`;
+    if (!ctx.messageDedup.tryRecord(dedupKey, accountId)) {
+      log(`feishu[${accountId}]: duplicate reaction ${dedupKey}, skipping`);
+      return;
+    }
+    if (isMessageExpired(event.action_time)) {
+      log(`feishu[${accountId}]: reaction on ${msgId} expired, discarding`);
+      return;
+    }
+    const preResolved = await resolveReactionContext({
+      cfg: ctx.cfg,
+      event,
+      botOpenId: ctx.lark.botOpenId,
+      runtime: ctx.runtime,
+      accountId
+    });
+    if (!preResolved) return;
+    const { status } = enqueueFeishuChatTask({
+      accountId,
+      chatId: preResolved.chatId,
+      threadId: preResolved.threadId,
+      task: async () => {
+        try {
+          await withTicket(
+            {
+              messageId: msgId,
+              chatId: preResolved.chatId,
+              accountId,
+              startTime: Date.now(),
+              senderOpenId: operatorOpenId,
+              chatType: preResolved.chatType,
+              threadId: preResolved.threadId
+            },
+            () => handleFeishuReaction({
+              cfg: ctx.cfg,
+              event,
+              botOpenId: ctx.lark.botOpenId,
+              runtime: ctx.runtime,
+              chatHistories: ctx.chatHistories,
+              accountId,
+              preResolved
+            })
+          );
+        } catch (err) {
+          error(`feishu[${accountId}]: error handling reaction: ${String(err)}`);
+        }
+      }
+    });
+    log(`feishu[${accountId}]: reaction on ${msgId} (chatId=${preResolved.chatId}) \u2014 ${status}`);
+  } catch (err) {
+    error(`feishu[${accountId}]: error handling reaction event: ${String(err)}`);
+  }
+}
+async function handleBotMembershipEvent(ctx, data, action) {
+  if (!isEventOwnershipValid(ctx, data)) return;
+  const { accountId, log, error } = ctx;
+  try {
+    const event = data;
+    log(`feishu[${accountId}]: bot ${action} ${action === "removed" ? "from" : "to"} chat ${event.chat_id}`);
+  } catch (err) {
+    error(`feishu[${accountId}]: error handling bot ${action} event: ${String(err)}`);
+  }
+}
+async function handleCardActionEvent(ctx, data) {
+  try {
+    return await handleCardAction(data, ctx.cfg, ctx.accountId);
+  } catch (err) {
+    elog.warn(`card.action.trigger handler error: ${err}`);
+  }
+}
+export {
+  handleBotMembershipEvent,
+  handleCardActionEvent,
+  handleMessageEvent,
+  handleReactionEvent
+};
+//# sourceMappingURL=event-handlers.js.map

package/dist/src/channel/event-handlers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/channel/event-handlers.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Event handlers for the Feishu WebSocket monitor.\n *\n * Extracted from monitor.ts to improve testability and reduce\n * function size. Each handler receives a MonitorContext with all\n * dependencies needed to process the event.\n */\n\nimport type { FeishuMessageEvent, FeishuBotAddedEvent, FeishuReactionCreatedEvent } from '../messaging/types';\nimport { handleFeishuMessage } from '../messaging/inbound/handler';\nimport { handleFeishuReaction, resolveReactionContext } from '../messaging/inbound/reaction-handler';\nimport { isMessageExpired } from '../messaging/inbound/dedup';\nimport { withTicket } from '../core/lark-ticket';\nimport { larkLogger } from '../core/lark-logger';\nimport { handleCardAction } from '../tools/auto-auth';\nimport { enqueueFeishuChatTask, buildQueueKey, hasActiveTask, getActiveDispatcher } from './chat-queue';\nimport { extractRawTextFromEvent, isLikelyAbortText } from './abort-detect';\nimport type { MonitorContext } from './types';\n\nconst elog = larkLogger('channel/event-handlers');\n\n// ---------------------------------------------------------------------------\n// Event ownership validation\n// ---------------------------------------------------------------------------\n\n/**\n * Verify that the event's app_id matches the current account.\n *\n * Lark SDK EventDispatcher flattens the v2 envelope header (which\n * contains `app_id`) into the handler `data` object, so `app_id` is\n * available directly on `data`.\n *\n * Returns `false` (discard event) when the app_id does not match.\n */\nfunction isEventOwnershipValid(ctx: MonitorContext, data: unknown): boolean {\n  const expectedAppId = ctx.lark.account.appId;\n  if (!expectedAppId) return true; // appId not configured \u2014 skip check\n\n  const eventAppId = (data as Record<string, unknown>).app_id;\n  if (eventAppId == null) return true; // SDK did not provide app_id \u2014 defensive skip\n\n  if (eventAppId !== expectedAppId) {\n    elog.warn('event app_id mismatch, discarding', {\n      accountId: ctx.accountId,\n      expected: expectedAppId,\n      received: String(eventAppId),\n    });\n    return false;\n  }\n  return true;\n}\n\n// ---------------------------------------------------------------------------\n// Message handler\n// ---------------------------------------------------------------------------\n\nexport async function handleMessageEvent(ctx: MonitorContext, data: unknown): Promise<void> {\n  if (!isEventOwnershipValid(ctx, data)) return;\n  const { accountId, log, error } = ctx;\n  try {\n    const event = data as FeishuMessageEvent;\n    const msgId = event.message?.message_id ?? 'unknown';\n    const chatId = event.message?.chat_id ?? '';\n    const threadId = event.message?.thread_id || undefined;\n\n    // Dedup \u2014 skip duplicate messages (e.g. from WebSocket reconnects).\n    if (!ctx.messageDedup.tryRecord(msgId, accountId)) {\n      log(`feishu[${accountId}]: duplicate message ${msgId}, skipping`);\n      return;\n    }\n\n    // Expiry \u2014 discard stale messages from reconnect replay.\n    if (isMessageExpired(event.message?.create_time)) {\n      log(`feishu[${accountId}]: message ${msgId} expired, discarding`);\n      return;\n    }\n\n    // ---- Abort fast-path ----\n    // If the message looks like an abort trigger and there is an active\n    // reply dispatcher for this chat, fire abortCard() immediately\n    // (before the message enters the serial queue) so the streaming\n    // card is terminated without waiting for the current task.\n    const abortText = extractRawTextFromEvent(event);\n    if (abortText && isLikelyAbortText(abortText)) {\n      const queueKey = buildQueueKey(accountId, chatId, threadId);\n      if (hasActiveTask(queueKey)) {\n        const active = getActiveDispatcher(queueKey);\n        if (active) {\n          log(`feishu[${accountId}]: abort fast-path triggered for chat ${chatId} (text=\"${abortText}\")`);\n          active.abortController?.abort();\n          active.abortCard().catch((err) => {\n            error(`feishu[${accountId}]: abort fast-path abortCard failed: ${String(err)}`);\n          });\n        }\n      }\n    }\n\n    const { status } = enqueueFeishuChatTask({\n      accountId,\n      chatId,\n      threadId,\n      task: async () => {\n        try {\n          await withTicket(\n            {\n              messageId: msgId,\n              chatId,\n              accountId,\n              startTime: Date.now(),\n              senderOpenId: event.sender?.sender_id?.open_id || '',\n              chatType: (event.message?.chat_type as 'p2p' | 'group') || undefined,\n              threadId,\n            },\n            () =>\n              handleFeishuMessage({\n                cfg: ctx.cfg,\n                event,\n                botOpenId: ctx.lark.botOpenId,\n                runtime: ctx.runtime,\n                chatHistories: ctx.chatHistories,\n                accountId,\n              }),\n          );\n        } catch (err) {\n          error(`feishu[${accountId}]: error handling message: ${String(err)}`);\n        }\n      },\n    });\n    log(`feishu[${accountId}]: message ${msgId} in chat ${chatId}${threadId ? ` thread ${threadId}` : ''} \u2014 ${status}`);\n  } catch (err) {\n    error(`feishu[${accountId}]: error handling message: ${String(err)}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Reaction handler\n// ---------------------------------------------------------------------------\n\nexport async function handleReactionEvent(ctx: MonitorContext, data: unknown): Promise<void> {\n  if (!isEventOwnershipValid(ctx, data)) return;\n  const { accountId, log, error } = ctx;\n  try {\n    const event = data as FeishuReactionCreatedEvent;\n    const msgId = event.message_id ?? 'unknown';\n\n    log(`feishu[${accountId}]: reaction event on message ${msgId}`);\n\n    // ---- Dedup: deterministic key based on message + emoji + operator ----\n    const emojiType = event.reaction_type?.emoji_type ?? '';\n    const operatorOpenId = event.user_id?.open_id ?? '';\n    const dedupKey = `${msgId}:reaction:${emojiType}:${operatorOpenId}`;\n    if (!ctx.messageDedup.tryRecord(dedupKey, accountId)) {\n      log(`feishu[${accountId}]: duplicate reaction ${dedupKey}, skipping`);\n      return;\n    }\n\n    // ---- Expiry: discard stale reaction events ----\n    if (isMessageExpired(event.action_time)) {\n      log(`feishu[${accountId}]: reaction on ${msgId} expired, discarding`);\n      return;\n    }\n\n    // ---- Pre-resolve real chatId before enqueuing ----\n    // The API call (3s timeout) runs outside the queue so it doesn't\n    // block the serial chain, and is read-only so ordering is irrelevant.\n    const preResolved = await resolveReactionContext({\n      cfg: ctx.cfg,\n      event,\n      botOpenId: ctx.lark.botOpenId,\n      runtime: ctx.runtime,\n      accountId,\n    });\n    if (!preResolved) return;\n\n    // ---- Enqueue with the real chatId (matches normal message queue key) ----\n    const { status } = enqueueFeishuChatTask({\n      accountId,\n      chatId: preResolved.chatId,\n      threadId: preResolved.threadId,\n      task: async () => {\n        try {\n          await withTicket(\n            {\n              messageId: msgId,\n              chatId: preResolved.chatId,\n              accountId,\n              startTime: Date.now(),\n              senderOpenId: operatorOpenId,\n              chatType: preResolved.chatType,\n              threadId: preResolved.threadId,\n            },\n            () =>\n              handleFeishuReaction({\n                cfg: ctx.cfg,\n                event,\n                botOpenId: ctx.lark.botOpenId,\n                runtime: ctx.runtime,\n                chatHistories: ctx.chatHistories,\n                accountId,\n                preResolved,\n              }),\n          );\n        } catch (err) {\n          error(`feishu[${accountId}]: error handling reaction: ${String(err)}`);\n        }\n      },\n    });\n    log(`feishu[${accountId}]: reaction on ${msgId} (chatId=${preResolved.chatId}) \u2014 ${status}`);\n  } catch (err) {\n    error(`feishu[${accountId}]: error handling reaction event: ${String(err)}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Bot membership handler\n// ---------------------------------------------------------------------------\n\nexport async function handleBotMembershipEvent(\n  ctx: MonitorContext,\n  data: unknown,\n  action: 'added' | 'removed',\n): Promise<void> {\n  if (!isEventOwnershipValid(ctx, data)) return;\n  const { accountId, log, error } = ctx;\n  try {\n    const event = data as FeishuBotAddedEvent;\n    log(`feishu[${accountId}]: bot ${action} ${action === 'removed' ? 'from' : 'to'} chat ${event.chat_id}`);\n  } catch (err) {\n    error(`feishu[${accountId}]: error handling bot ${action} event: ${String(err)}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Card action handler\n// ---------------------------------------------------------------------------\n\nexport async function handleCardActionEvent(ctx: MonitorContext, data: unknown): Promise<unknown> {\n  try {\n    return await handleCardAction(data, ctx.cfg, ctx.accountId);\n  } catch (err) {\n    elog.warn(`card.action.trigger handler error: ${err}`);\n  }\n}\n"],
+  "mappings": "AAYA,SAAS,2BAA2B;AACpC,SAAS,sBAAsB,8BAA8B;AAC7D,SAAS,wBAAwB;AACjC,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AACjC,SAAS,uBAAuB,eAAe,eAAe,2BAA2B;AACzF,SAAS,yBAAyB,yBAAyB;AAG3D,MAAM,OAAO,WAAW,wBAAwB;AAehD,SAAS,sBAAsB,KAAqB,MAAwB;AAC1E,QAAM,gBAAgB,IAAI,KAAK,QAAQ;AACvC,MAAI,CAAC,cAAe,QAAO;AAE3B,QAAM,aAAc,KAAiC;AACrD,MAAI,cAAc,KAAM,QAAO;AAE/B,MAAI,eAAe,eAAe;AAChC,SAAK,KAAK,qCAAqC;AAAA,MAC7C,WAAW,IAAI;AAAA,MACf,UAAU;AAAA,MACV,UAAU,OAAO,UAAU;AAAA,IAC7B,CAAC;AACD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAMA,eAAsB,mBAAmB,KAAqB,MAA8B;AAC1F,MAAI,CAAC,sBAAsB,KAAK,IAAI,EAAG;AACvC,QAAM,EAAE,WAAW,KAAK,MAAM,IAAI;AAClC,MAAI;AACF,UAAM,QAAQ;AACd,UAAM,QAAQ,MAAM,SAAS,cAAc;AAC3C,UAAM,SAAS,MAAM,SAAS,WAAW;AACzC,UAAM,WAAW,MAAM,SAAS,aAAa;AAG7C,QAAI,CAAC,IAAI,aAAa,UAAU,OAAO,SAAS,GAAG;AACjD,UAAI,UAAU,SAAS,wBAAwB,KAAK,YAAY;AAChE;AAAA,IACF;AAGA,QAAI,iBAAiB,MAAM,SAAS,WAAW,GAAG;AAChD,UAAI,UAAU,SAAS,cAAc,KAAK,sBAAsB;AAChE;AAAA,IACF;AAOA,UAAM,YAAY,wBAAwB,KAAK;AAC/C,QAAI,aAAa,kBAAkB,SAAS,GAAG;AAC7C,YAAM,WAAW,cAAc,WAAW,QAAQ,QAAQ;AAC1D,UAAI,cAAc,QAAQ,GAAG;AAC3B,cAAM,SAAS,oBAAoB,QAAQ;AAC3C,YAAI,QAAQ;AACV,cAAI,UAAU,SAAS,yCAAyC,MAAM,WAAW,SAAS,IAAI;AAC9F,iBAAO,iBAAiB,MAAM;AAC9B,iBAAO,UAAU,EAAE,MAAM,CAAC,QAAQ;AAChC,kBAAM,UAAU,SAAS,wCAAwC,OAAO,GAAG,CAAC,EAAE;AAAA,UAChF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,UAAM,EAAE,OAAO,IAAI,sBAAsB;AAAA,MACvC;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,YAAY;AAChB,YAAI;AACF,gBAAM;AAAA,YACJ;AAAA,cACE,WAAW;AAAA,cACX;AAAA,cACA;AAAA,cACA,WAAW,KAAK,IAAI;AAAA,cACpB,cAAc,MAAM,QAAQ,WAAW,WAAW;AAAA,cAClD,UAAW,MAAM,SAAS,aAAiC;AAAA,cAC3D;AAAA,YACF;AAAA,YACA,MACE,oBAAoB;AAAA,cAClB,KAAK,IAAI;AAAA,cACT;AAAA,cACA,WAAW,IAAI,KAAK;AAAA,cACpB,SAAS,IAAI;AAAA,cACb,eAAe,IAAI;AAAA,cACnB;AAAA,YACF,CAAC;AAAA,UACL;AAAA,QACF,SAAS,KAAK;AACZ,gBAAM,UAAU,SAAS,8BAA8B,OAAO,GAAG,CAAC,EAAE;AAAA,QACtE;AAAA,MACF;AAAA,IACF,CAAC;AACD,QAAI,UAAU,SAAS,cAAc,KAAK,YAAY,MAAM,GAAG,WAAW,WAAW,QAAQ,KAAK,EAAE,WAAM,MAAM,EAAE;AAAA,EACpH,SAAS,KAAK;AACZ,UAAM,UAAU,SAAS,8BAA8B,OAAO,GAAG,CAAC,EAAE;AAAA,EACtE;AACF;AAMA,eAAsB,oBAAoB,KAAqB,MAA8B;AAC3F,MAAI,CAAC,sBAAsB,KAAK,IAAI,EAAG;AACvC,QAAM,EAAE,WAAW,KAAK,MAAM,IAAI;AAClC,MAAI;AACF,UAAM,QAAQ;AACd,UAAM,QAAQ,MAAM,cAAc;AAElC,QAAI,UAAU,SAAS,gCAAgC,KAAK,EAAE;AAG9D,UAAM,YAAY,MAAM,eAAe,cAAc;AACrD,UAAM,iBAAiB,MAAM,SAAS,WAAW;AACjD,UAAM,WAAW,GAAG,KAAK,aAAa,SAAS,IAAI,cAAc;AACjE,QAAI,CAAC,IAAI,aAAa,UAAU,UAAU,SAAS,GAAG;AACpD,UAAI,UAAU,SAAS,yBAAyB,QAAQ,YAAY;AACpE;AAAA,IACF;AAGA,QAAI,iBAAiB,MAAM,WAAW,GAAG;AACvC,UAAI,UAAU,SAAS,kBAAkB,KAAK,sBAAsB;AACpE;AAAA,IACF;AAKA,UAAM,cAAc,MAAM,uBAAuB;AAAA,MAC/C,KAAK,IAAI;AAAA,MACT;AAAA,MACA,WAAW,IAAI,KAAK;AAAA,MACpB,SAAS,IAAI;AAAA,MACb;AAAA,IACF,CAAC;AACD,QAAI,CAAC,YAAa;AAGlB,UAAM,EAAE,OAAO,IAAI,sBAAsB;AAAA,MACvC;AAAA,MACA,QAAQ,YAAY;AAAA,MACpB,UAAU,YAAY;AAAA,MACtB,MAAM,YAAY;AAChB,YAAI;AACF,gBAAM;AAAA,YACJ;AAAA,cACE,WAAW;AAAA,cACX,QAAQ,YAAY;AAAA,cACpB;AAAA,cACA,WAAW,KAAK,IAAI;AAAA,cACpB,cAAc;AAAA,cACd,UAAU,YAAY;AAAA,cACtB,UAAU,YAAY;AAAA,YACxB;AAAA,YACA,MACE,qBAAqB;AAAA,cACnB,KAAK,IAAI;AAAA,cACT;AAAA,cACA,WAAW,IAAI,KAAK;AAAA,cACpB,SAAS,IAAI;AAAA,cACb,eAAe,IAAI;AAAA,cACnB;AAAA,cACA;AAAA,YACF,CAAC;AAAA,UACL;AAAA,QACF,SAAS,KAAK;AACZ,gBAAM,UAAU,SAAS,+BAA+B,OAAO,GAAG,CAAC,EAAE;AAAA,QACvE;AAAA,MACF;AAAA,IACF,CAAC;AACD,QAAI,UAAU,SAAS,kBAAkB,KAAK,YAAY,YAAY,MAAM,YAAO,MAAM,EAAE;AAAA,EAC7F,SAAS,KAAK;AACZ,UAAM,UAAU,SAAS,qCAAqC,OAAO,GAAG,CAAC,EAAE;AAAA,EAC7E;AACF;AAMA,eAAsB,yBACpB,KACA,MACA,QACe;AACf,MAAI,CAAC,sBAAsB,KAAK,IAAI,EAAG;AACvC,QAAM,EAAE,WAAW,KAAK,MAAM,IAAI;AAClC,MAAI;AACF,UAAM,QAAQ;AACd,QAAI,UAAU,SAAS,UAAU,MAAM,IAAI,WAAW,YAAY,SAAS,IAAI,SAAS,MAAM,OAAO,EAAE;AAAA,EACzG,SAAS,KAAK;AACZ,UAAM,UAAU,SAAS,yBAAyB,MAAM,WAAW,OAAO,GAAG,CAAC,EAAE;AAAA,EAClF;AACF;AAMA,eAAsB,sBAAsB,KAAqB,MAAiC;AAChG,MAAI;AACF,WAAO,MAAM,iBAAiB,MAAM,IAAI,KAAK,IAAI,SAAS;AAAA,EAC5D,SAAS,KAAK;AACZ,SAAK,KAAK,sCAAsC,GAAG,EAAE;AAAA,EACvD;AACF;",
+  "names": []
+}

package/dist/src/channel/monitor.js

@@ -0,0 +1,108 @@
+import { getLarkAccount, getEnabledLarkAccounts } from "../core/accounts";
+import { LarkClient } from "../core/lark-client";
+import { MessageDedup } from "../messaging/inbound/dedup";
+import { larkLogger } from "../core/lark-logger";
+import { drainShutdownHooks } from "../core/shutdown-hooks";
+import {
+  handleMessageEvent,
+  handleReactionEvent,
+  handleBotMembershipEvent,
+  handleCardActionEvent
+} from "./event-handlers";
+const mlog = larkLogger("channel/monitor");
+async function monitorSingleAccount(params) {
+  const { account, runtime, abortSignal } = params;
+  const { accountId } = account;
+  const log = runtime?.log ?? ((...args) => mlog.info(args.map(String).join(" ")));
+  const error = runtime?.error ?? ((...args) => mlog.error(args.map(String).join(" ")));
+  const connectionMode = account.config.connectionMode ?? "websocket";
+  if (connectionMode !== "websocket") {
+    log(`feishu[${accountId}]: webhook mode not implemented in monitor`);
+    return;
+  }
+  const dedupCfg = account.config.dedup;
+  const messageDedup = new MessageDedup({
+    ttlMs: dedupCfg?.ttlMs,
+    maxEntries: dedupCfg?.maxEntries
+  });
+  log(
+    `feishu[${accountId}]: message dedup enabled (ttl=${messageDedup["ttlMs"]}ms, max=${messageDedup["maxEntries"]})`
+  );
+  log(`feishu[${accountId}]: starting WebSocket connection...`);
+  const lark = LarkClient.fromAccount(account);
+  lark.messageDedup = messageDedup;
+  const chatHistories = /* @__PURE__ */ new Map();
+  const ctx = {
+    get cfg() {
+      return LarkClient.runtime.config.loadConfig();
+    },
+    lark,
+    accountId,
+    chatHistories,
+    messageDedup,
+    runtime,
+    log,
+    error
+  };
+  await lark.startWS({
+    handlers: {
+      "im.message.receive_v1": (data) => handleMessageEvent(ctx, data),
+      "im.message.message_read_v1": async () => {
+      },
+      "im.message.reaction.created_v1": (data) => handleReactionEvent(ctx, data),
+      "im.chat.member.bot.added_v1": (data) => handleBotMembershipEvent(ctx, data, "added"),
+      "im.chat.member.bot.deleted_v1": (data) => handleBotMembershipEvent(ctx, data, "removed"),
+      // 飞书 SDK EventDispatcher.register 不支持带返回值的处理器，此处 as any 是 SDK 类型限制的变通
+      "card.action.trigger": ((data) => (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        handleCardActionEvent(ctx, data)
+      ))
+    },
+    abortSignal
+  });
+  log(`feishu[${accountId}]: bot open_id resolved: ${lark.botOpenId ?? "unknown"}`);
+  log(`feishu[${accountId}]: WebSocket client started`);
+  mlog.info(`websocket started for account ${accountId}`);
+}
+async function monitorFeishuProvider(opts = {}) {
+  const cfg = opts.config;
+  if (!cfg) {
+    throw new Error("Config is required for Feishu monitor");
+  }
+  LarkClient.setGlobalConfig(cfg);
+  const log = opts.runtime?.log ?? ((...args) => mlog.info(args.map(String).join(" ")));
+  if (opts.accountId) {
+    const account = getLarkAccount(cfg, opts.accountId);
+    if (!account.enabled || !account.configured) {
+      throw new Error(`Feishu account "${opts.accountId}" not configured or disabled`);
+    }
+    await monitorSingleAccount({
+      cfg,
+      account,
+      runtime: opts.runtime,
+      abortSignal: opts.abortSignal
+    });
+    await drainShutdownHooks({ log });
+    return;
+  }
+  const accounts = getEnabledLarkAccounts(cfg);
+  if (accounts.length === 0) {
+    throw new Error("No enabled Feishu accounts configured");
+  }
+  log(`feishu: starting ${accounts.length} account(s): ${accounts.map((a) => a.accountId).join(", ")}`);
+  await Promise.all(
+    accounts.map(
+      (account) => monitorSingleAccount({
+        cfg,
+        account,
+        runtime: opts.runtime,
+        abortSignal: opts.abortSignal
+      })
+    )
+  );
+  await drainShutdownHooks({ log });
+}
+export {
+  monitorFeishuProvider
+};
+//# sourceMappingURL=monitor.js.map

package/dist/src/channel/monitor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/channel/monitor.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * WebSocket monitoring for the Lark/Feishu channel plugin.\n *\n * Manages per-account WSClient connections and routes inbound Feishu\n * events (messages, bot membership changes, read receipts) to the\n * appropriate handlers.\n */\n\nimport type { ClawdbotConfig, RuntimeEnv, HistoryEntry } from 'openclaw/plugin-sdk';\nimport { getLarkAccount, getEnabledLarkAccounts } from '../core/accounts';\nimport { LarkClient } from '../core/lark-client';\nimport { MessageDedup } from '../messaging/inbound/dedup';\nimport { larkLogger } from '../core/lark-logger';\nimport { drainShutdownHooks } from '../core/shutdown-hooks';\nimport type { MonitorFeishuOpts, MonitorContext } from './types';\nimport {\n  handleMessageEvent,\n  handleReactionEvent,\n  handleBotMembershipEvent,\n  handleCardActionEvent,\n} from './event-handlers';\n\nconst mlog = larkLogger('channel/monitor');\n\n// Re-export type for backward compatibility\nexport type { MonitorFeishuOpts } from './types';\n\n// ---------------------------------------------------------------------------\n// Single-account monitor\n// ---------------------------------------------------------------------------\n\n/**\n * Start monitoring a single Feishu account.\n *\n * Creates a LarkClient, probes bot identity, registers event handlers,\n * and starts a WebSocket connection. Returns a Promise that resolves\n * when the abort signal fires (or immediately if already aborted).\n */\nasync function monitorSingleAccount(params: {\n  cfg: ClawdbotConfig;\n  account: ReturnType<typeof getLarkAccount>;\n  runtime?: RuntimeEnv;\n  abortSignal?: AbortSignal;\n}): Promise<void> {\n  const { account, runtime, abortSignal } = params;\n  const { accountId } = account;\n  const log = runtime?.log ?? ((...args: unknown[]) => mlog.info(args.map(String).join(' ')));\n  const error = runtime?.error ?? ((...args: unknown[]) => mlog.error(args.map(String).join(' ')));\n\n  // Only websocket mode is supported in the monitor path.\n  const connectionMode = account.config.connectionMode ?? 'websocket';\n  if (connectionMode !== 'websocket') {\n    log(`feishu[${accountId}]: webhook mode not implemented in monitor`);\n    return;\n  }\n\n  // Message dedup \u2014 filters duplicate deliveries from WebSocket reconnects.\n  const dedupCfg = account.config.dedup;\n  const messageDedup = new MessageDedup({\n    ttlMs: dedupCfg?.ttlMs,\n    maxEntries: dedupCfg?.maxEntries,\n  });\n  log(\n    `feishu[${accountId}]: message dedup enabled (ttl=${messageDedup['ttlMs']}ms, max=${messageDedup['maxEntries']})`,\n  );\n\n  log(`feishu[${accountId}]: starting WebSocket connection...`);\n\n  // Create LarkClient instance \u2014 manages SDK client, WS, and bot identity.\n  const lark = LarkClient.fromAccount(account);\n\n  // Attach dedup instance so it is disposed together with the client.\n  lark.messageDedup = messageDedup;\n\n  /** Per-chat history maps (used for group-chat context window). */\n  const chatHistories = new Map<string, HistoryEntry[]>();\n\n  const ctx: MonitorContext = {\n    get cfg() {\n      return LarkClient.runtime.config.loadConfig();\n    },\n    lark,\n    accountId,\n    chatHistories,\n    messageDedup,\n    runtime,\n    log,\n    error,\n  };\n\n  await lark.startWS({\n    handlers: {\n      'im.message.receive_v1': (data) => handleMessageEvent(ctx, data),\n      'im.message.message_read_v1': async () => {},\n      'im.message.reaction.created_v1': (data) => handleReactionEvent(ctx, data),\n      'im.chat.member.bot.added_v1': (data) => handleBotMembershipEvent(ctx, data, 'added'),\n      'im.chat.member.bot.deleted_v1': (data) => handleBotMembershipEvent(ctx, data, 'removed'),\n      // \u98DE\u4E66 SDK EventDispatcher.register \u4E0D\u652F\u6301\u5E26\u8FD4\u56DE\u503C\u7684\u5904\u7406\u5668\uFF0C\u6B64\u5904 as any \u662F SDK \u7C7B\u578B\u9650\u5236\u7684\u53D8\u901A\n      'card.action.trigger': ((data: unknown) =>\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        handleCardActionEvent(ctx, data)) as any,\n    },\n    abortSignal,\n  });\n\n  // startWS resolves when abortSignal fires \u2014 probe result is logged inside startWS.\n  log(`feishu[${accountId}]: bot open_id resolved: ${lark.botOpenId ?? 'unknown'}`);\n  log(`feishu[${accountId}]: WebSocket client started`);\n  mlog.info(`websocket started for account ${accountId}`);\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Start monitoring for all enabled Feishu accounts (or a single\n * account when `opts.accountId` is specified).\n */\nexport async function monitorFeishuProvider(opts: MonitorFeishuOpts = {}): Promise<void> {\n  const cfg = opts.config;\n  if (!cfg) {\n    throw new Error('Config is required for Feishu monitor');\n  }\n\n  // Store the original global config so plugin commands (doctor, diagnose)\n  // can access cross-account information even when running inside an\n  // account-scoped config context.\n  LarkClient.setGlobalConfig(cfg);\n\n  const log = opts.runtime?.log ?? ((...args: unknown[]) => mlog.info(args.map(String).join(' ')));\n\n  // Single-account mode.\n  if (opts.accountId) {\n    const account = getLarkAccount(cfg, opts.accountId);\n    if (!account.enabled || !account.configured) {\n      throw new Error(`Feishu account \"${opts.accountId}\" not configured or disabled`);\n    }\n    await monitorSingleAccount({\n      cfg,\n      account,\n      runtime: opts.runtime,\n      abortSignal: opts.abortSignal,\n    });\n    await drainShutdownHooks({ log });\n    return;\n  }\n\n  // Multi-account mode: start all enabled accounts in parallel.\n  const accounts = getEnabledLarkAccounts(cfg);\n  if (accounts.length === 0) {\n    throw new Error('No enabled Feishu accounts configured');\n  }\n\n  log(`feishu: starting ${accounts.length} account(s): ${accounts.map((a) => a.accountId).join(', ')}`);\n\n  await Promise.all(\n    accounts.map((account) =>\n      monitorSingleAccount({\n        cfg,\n        account,\n        runtime: opts.runtime,\n        abortSignal: opts.abortSignal,\n      }),\n    ),\n  );\n  await drainShutdownHooks({ log });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/channel/onboarding-config.js

@@ -0,0 +1,76 @@
+import { addWildcardAllowFrom } from "openclaw/plugin-sdk";
+function setFeishuDmPolicy(cfg, dmPolicy) {
+  const allowFrom = dmPolicy === "open" ? addWildcardAllowFrom(cfg.channels?.feishu?.allowFrom)?.map((entry) => String(entry)) : void 0;
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      feishu: {
+        ...cfg.channels?.feishu,
+        dmPolicy,
+        ...allowFrom ? { allowFrom } : {}
+      }
+    }
+  };
+}
+function setFeishuAllowFrom(cfg, allowFrom) {
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      feishu: {
+        ...cfg.channels?.feishu,
+        allowFrom
+      }
+    }
+  };
+}
+function setFeishuGroupPolicy(cfg, groupPolicy) {
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      feishu: {
+        ...cfg.channels?.feishu,
+        enabled: true,
+        groupPolicy
+      }
+    }
+  };
+}
+function setFeishuGroupAllowFrom(cfg, groupAllowFrom) {
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      feishu: {
+        ...cfg.channels?.feishu,
+        groupAllowFrom
+      }
+    }
+  };
+}
+function setFeishuGroups(cfg, groups) {
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      feishu: {
+        ...cfg.channels?.feishu,
+        groups
+      }
+    }
+  };
+}
+function parseAllowFromInput(raw) {
+  return raw.split(/[\n,;]+/g).map((entry) => entry.trim()).filter(Boolean);
+}
+export {
+  parseAllowFromInput,
+  setFeishuAllowFrom,
+  setFeishuDmPolicy,
+  setFeishuGroupAllowFrom,
+  setFeishuGroupPolicy,
+  setFeishuGroups
+};
+//# sourceMappingURL=onboarding-config.js.map

package/dist/src/channel/onboarding-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/channel/onboarding-config.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Onboarding configuration mutation helpers.\n *\n * Pure functions that apply Feishu channel configuration changes\n * to a ClawdbotConfig. Extracted from onboarding.ts for reuse\n * in CLI commands and other configuration flows.\n */\n\nimport type { ClawdbotConfig, DmPolicy } from 'openclaw/plugin-sdk';\nimport { addWildcardAllowFrom } from 'openclaw/plugin-sdk';\n\n// ---------------------------------------------------------------------------\n// Config mutation helpers\n// ---------------------------------------------------------------------------\n\nexport function setFeishuDmPolicy(cfg: ClawdbotConfig, dmPolicy: DmPolicy): ClawdbotConfig {\n  const allowFrom =\n    dmPolicy === 'open'\n      ? addWildcardAllowFrom(cfg.channels?.feishu?.allowFrom)?.map((entry) => String(entry))\n      : undefined;\n\n  return {\n    ...cfg,\n    channels: {\n      ...cfg.channels,\n      feishu: {\n        ...cfg.channels?.feishu,\n        dmPolicy,\n        ...(allowFrom ? { allowFrom } : {}),\n      },\n    },\n  };\n}\n\nexport function setFeishuAllowFrom(cfg: ClawdbotConfig, allowFrom: string[]): ClawdbotConfig {\n  return {\n    ...cfg,\n    channels: {\n      ...cfg.channels,\n      feishu: {\n        ...cfg.channels?.feishu,\n        allowFrom,\n      },\n    },\n  };\n}\n\nexport function setFeishuGroupPolicy(\n  cfg: ClawdbotConfig,\n  groupPolicy: 'open' | 'allowlist' | 'disabled',\n): ClawdbotConfig {\n  return {\n    ...cfg,\n    channels: {\n      ...cfg.channels,\n      feishu: {\n        ...cfg.channels?.feishu,\n        enabled: true,\n        groupPolicy,\n      },\n    },\n  };\n}\n\nexport function setFeishuGroupAllowFrom(cfg: ClawdbotConfig, groupAllowFrom: string[]): ClawdbotConfig {\n  return {\n    ...cfg,\n    channels: {\n      ...cfg.channels,\n      feishu: {\n        ...cfg.channels?.feishu,\n        groupAllowFrom,\n      },\n    },\n  };\n}\n\nexport function setFeishuGroups(cfg: ClawdbotConfig, groups: Record<string, object>): ClawdbotConfig {\n  return {\n    ...cfg,\n    channels: {\n      ...cfg.channels,\n      feishu: {\n        ...cfg.channels?.feishu,\n        groups,\n      },\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Input helpers\n// ---------------------------------------------------------------------------\n\nexport function parseAllowFromInput(raw: string): string[] {\n  return raw\n    .split(/[\\n,;]+/g)\n    .map((entry) => entry.trim())\n    .filter(Boolean);\n}\n"],
+  "mappings": "AAYA,SAAS,4BAA4B;AAM9B,SAAS,kBAAkB,KAAqB,UAAoC;AACzF,QAAM,YACJ,aAAa,SACT,qBAAqB,IAAI,UAAU,QAAQ,SAAS,GAAG,IAAI,CAAC,UAAU,OAAO,KAAK,CAAC,IACnF;AAEN,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,MACR,GAAG,IAAI;AAAA,MACP,QAAQ;AAAA,QACN,GAAG,IAAI,UAAU;AAAA,QACjB;AAAA,QACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,mBAAmB,KAAqB,WAAqC;AAC3F,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,MACR,GAAG,IAAI;AAAA,MACP,QAAQ;AAAA,QACN,GAAG,IAAI,UAAU;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,qBACd,KACA,aACgB;AAChB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,MACR,GAAG,IAAI;AAAA,MACP,QAAQ;AAAA,QACN,GAAG,IAAI,UAAU;AAAA,QACjB,SAAS;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,wBAAwB,KAAqB,gBAA0C;AACrG,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,MACR,GAAG,IAAI;AAAA,MACP,QAAQ;AAAA,QACN,GAAG,IAAI,UAAU;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,gBAAgB,KAAqB,QAAgD;AACnG,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,MACR,GAAG,IAAI;AAAA,MACP,QAAQ;AAAA,QACN,GAAG,IAAI,UAAU;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,oBAAoB,KAAuB;AACzD,SAAO,IACJ,MAAM,UAAU,EAChB,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;AACnB;",
+  "names": []
+}

package/dist/src/channel/onboarding-migrate.js

@@ -0,0 +1,55 @@
+import { setFeishuGroups, setFeishuGroupAllowFrom } from "./onboarding-config";
+async function migrateLegacyGroupAllowFrom(params) {
+  let next = params.cfg;
+  const { prompter } = params;
+  const existingGroupAllowFrom = next.channels?.feishu?.groupAllowFrom ?? [];
+  const legacyChatIds = existingGroupAllowFrom.filter((e) => String(e).startsWith("oc_"));
+  const senderAllowFrom = existingGroupAllowFrom.filter((e) => !String(e).startsWith("oc_"));
+  if (legacyChatIds.length === 0) {
+    return next;
+  }
+  await prompter.note(
+    [
+      `\u26A0\uFE0F  Detected legacy config: groupAllowFrom contains chat_ids (${legacyChatIds.join(", ")})`,
+      "",
+      "Old semantic: groupAllowFrom controlled which groups could use the bot.",
+      "New semantic: groupAllowFrom is for SENDER filtering (open_ids like ou_xxx).",
+      "",
+      "Recommended migration:",
+      `  1. Move chat_ids (oc_xxx) \u2192 channels.feishu.groups`,
+      `  2. Keep sender IDs (ou_xxx) in groupAllowFrom`
+    ].join("\n"),
+    "Legacy config detected"
+  );
+  const migrate = await prompter.confirm({
+    message: `Migrate ${legacyChatIds.length} chat_id(s) to groups config?`,
+    initialValue: true
+  });
+  if (migrate) {
+    const existingGroups = next.channels?.feishu?.groups ?? {};
+    const migratedGroups = {
+      ...existingGroups
+    };
+    for (const chatId of legacyChatIds) {
+      if (!migratedGroups[String(chatId)]) {
+        migratedGroups[String(chatId)] = {
+          enabled: true,
+          groupPolicy: "open"
+        };
+      }
+    }
+    next = setFeishuGroups(next, migratedGroups);
+    next = setFeishuGroupAllowFrom(next, senderAllowFrom);
+    await prompter.note(
+      `\u2705 Migrated: ${legacyChatIds.length} chat_id(s) moved to groups, ${senderAllowFrom.length} sender(s) kept in groupAllowFrom`,
+      "Migration complete"
+    );
+  } else {
+    await prompter.note("Skipped migration. Please update config manually to avoid issues.", "Migration skipped");
+  }
+  return next;
+}
+export {
+  migrateLegacyGroupAllowFrom
+};
+//# sourceMappingURL=onboarding-migrate.js.map

package/dist/src/channel/onboarding-migrate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/channel/onboarding-migrate.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Legacy groupAllowFrom migration for Feishu onboarding.\n *\n * Handles the migration of chat_id entries (oc_xxx) from\n * groupAllowFrom to the groups config, preserving the original\n * semantic of \"allow this group for any sender\".\n */\n\nimport type { ClawdbotConfig, WizardPrompter } from 'openclaw/plugin-sdk';\nimport type { FeishuConfig, FeishuGroupConfig } from '../core/types';\nimport { setFeishuGroups, setFeishuGroupAllowFrom } from './onboarding-config';\n\n/**\n * Detect and migrate legacy chat_id entries in groupAllowFrom.\n *\n * Old semantic: groupAllowFrom contained chat_ids (oc_xxx) to control\n * which groups could use the bot.\n * New semantic: groupAllowFrom is for sender filtering (open_ids like ou_xxx).\n *\n * This function prompts the user and, if confirmed, moves chat_ids\n * to the groups config and keeps only sender IDs in groupAllowFrom.\n */\nexport async function migrateLegacyGroupAllowFrom(params: {\n  cfg: ClawdbotConfig;\n  prompter: WizardPrompter;\n}): Promise<ClawdbotConfig> {\n  let next = params.cfg;\n  const { prompter } = params;\n\n  const existingGroupAllowFrom = (next.channels?.feishu as FeishuConfig | undefined)?.groupAllowFrom ?? [];\n  const legacyChatIds = existingGroupAllowFrom.filter((e) => String(e).startsWith('oc_'));\n  const senderAllowFrom = existingGroupAllowFrom.filter((e) => !String(e).startsWith('oc_'));\n\n  if (legacyChatIds.length === 0) {\n    return next;\n  }\n\n  await prompter.note(\n    [\n      `\u26A0\uFE0F  Detected legacy config: groupAllowFrom contains chat_ids (${legacyChatIds.join(', ')})`,\n      '',\n      'Old semantic: groupAllowFrom controlled which groups could use the bot.',\n      'New semantic: groupAllowFrom is for SENDER filtering (open_ids like ou_xxx).',\n      '',\n      'Recommended migration:',\n      `  1. Move chat_ids (oc_xxx) \u2192 channels.feishu.groups`,\n      `  2. Keep sender IDs (ou_xxx) in groupAllowFrom`,\n    ].join('\\n'),\n    'Legacy config detected',\n  );\n\n  const migrate = await prompter.confirm({\n    message: `Migrate ${legacyChatIds.length} chat_id(s) to groups config?`,\n    initialValue: true,\n  });\n\n  if (migrate) {\n    const existingGroups = (next.channels?.feishu as FeishuConfig | undefined)?.groups ?? {};\n    const migratedGroups: Record<string, FeishuGroupConfig> = {\n      ...existingGroups,\n    };\n    for (const chatId of legacyChatIds) {\n      if (!migratedGroups[String(chatId)]) {\n        migratedGroups[String(chatId)] = {\n          enabled: true,\n          groupPolicy: 'open',\n        } as FeishuGroupConfig;\n      }\n    }\n    next = setFeishuGroups(next, migratedGroups as Record<string, object>);\n\n    next = setFeishuGroupAllowFrom(next, senderAllowFrom);\n\n    await prompter.note(\n      `\u2705 Migrated: ${legacyChatIds.length} chat_id(s) moved to groups, ` +\n        `${senderAllowFrom.length} sender(s) kept in groupAllowFrom`,\n      'Migration complete',\n    );\n  } else {\n    await prompter.note('Skipped migration. Please update config manually to avoid issues.', 'Migration skipped');\n  }\n\n  return next;\n}\n"],
+  "mappings": "AAaA,SAAS,iBAAiB,+BAA+B;AAYzD,eAAsB,4BAA4B,QAGtB;AAC1B,MAAI,OAAO,OAAO;AAClB,QAAM,EAAE,SAAS,IAAI;AAErB,QAAM,yBAA0B,KAAK,UAAU,QAAqC,kBAAkB,CAAC;AACvG,QAAM,gBAAgB,uBAAuB,OAAO,CAAC,MAAM,OAAO,CAAC,EAAE,WAAW,KAAK,CAAC;AACtF,QAAM,kBAAkB,uBAAuB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,CAAC;AAEzF,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AAAA,IACb;AAAA,MACE,2EAAiE,cAAc,KAAK,IAAI,CAAC;AAAA,MACzF;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,IACX;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,SAAS,QAAQ;AAAA,IACrC,SAAS,WAAW,cAAc,MAAM;AAAA,IACxC,cAAc;AAAA,EAChB,CAAC;AAED,MAAI,SAAS;AACX,UAAM,iBAAkB,KAAK,UAAU,QAAqC,UAAU,CAAC;AACvF,UAAM,iBAAoD;AAAA,MACxD,GAAG;AAAA,IACL;AACA,eAAW,UAAU,eAAe;AAClC,UAAI,CAAC,eAAe,OAAO,MAAM,CAAC,GAAG;AACnC,uBAAe,OAAO,MAAM,CAAC,IAAI;AAAA,UAC/B,SAAS;AAAA,UACT,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AACA,WAAO,gBAAgB,MAAM,cAAwC;AAErE,WAAO,wBAAwB,MAAM,eAAe;AAEpD,UAAM,SAAS;AAAA,MACb,oBAAe,cAAc,MAAM,gCAC9B,gBAAgB,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,EACF,OAAO;AACL,UAAM,SAAS,KAAK,qEAAqE,mBAAmB;AAAA,EAC9G;AAEA,SAAO;AACT;",
+  "names": []
+}