@xopcai/xopc 0.0.15 → 0.0.17

package/dist/extensions/feishu/src/transport/socket-mode/monitor.js

@@ -0,0 +1,326 @@
+import { createLogger } from "../../../../../src/utils/logger/index.js";
+import { init_logger } from "../../../../../src/utils/logger.js";
+import { generateSessionKey } from "../../../../../src/chat-commands/session-key.js";
+import { createFeishuClient } from "../client/client.js";
+import { createFeishuDedupe } from "../reliability/dedupe.js";
+import { stripFeishuMentions } from "../text/mentions.js";
+import { computeBackoffMs } from "./retry.js";
+import { getFeishuBindingByMessageId, recordFeishuMessageBinding } from "../../state/message-bindings.js";
+//#region extensions/feishu/src/transport/socket-mode/monitor.ts
+init_logger();
+const log = createLogger("FeishuSocketMode");
+function createFeishuSocketModeMonitor(deps) {
+	const { account, config: _config, bus, abortSignal, security } = deps;
+	const dedupe = createFeishuDedupe();
+	let lastEventAt = 0;
+	async function handleReactionEvent(kind, event, api) {
+		const msgId = event?.event?.message_id ?? event?.message_id ?? "";
+		const emojiType = event?.event?.reaction_type?.emoji_type ?? event?.reaction_type?.emoji_type ?? "";
+		const operatorType = event?.event?.operator_type ?? event?.operator_type ?? "";
+		const userOpenId = event?.event?.user_id?.open_id ?? event?.user_id?.open_id ?? event?.event?.open_id ?? event?.open_id ?? "";
+		if (!msgId || !emojiType) return;
+		if (operatorType === "app") return;
+		const notifMode = account.reactionNotifications ?? "own";
+		if (notifMode === "off") return;
+		const binding = getFeishuBindingByMessageId(msgId);
+		if (!binding) return;
+		const reacted = await fetchFeishuMessageForReaction(api, msgId, 1500);
+		if (!reacted && notifMode === "own") return;
+		const isBotMessage = reacted?.sender_type === "app" || reacted?.senderType === "app";
+		if (notifMode === "own" && !isBotMessage) return;
+		const senderId = userOpenId || binding.senderId;
+		const preview = reacted ? extractFeishuMessagePreview(reacted) : "";
+		await bus.publishInbound({
+			channel: "feishu",
+			sender_id: senderId,
+			chat_id: binding.chatId,
+			content: kind === "deleted" ? `撤回了一个表情（${emojiType}）${preview ? `，对应消息：「${preview}」` : ""}` : `对一条消息添加了表情（${emojiType}）${preview ? `：「${preview}」` : ""}`,
+			metadata: {
+				sessionKey: binding.sessionKey,
+				accountId: binding.accountId,
+				isGroup: binding.isGroup,
+				threadId: binding.threadId,
+				feishuEventType: `im.message.reaction.${kind}_v1`,
+				reactedMessageId: msgId,
+				emojiType,
+				raw: event,
+				reactedMessage: reacted ?? null
+			}
+		});
+	}
+	async function handleCardAction(event) {
+		const ctx = event?.event?.context ?? event?.context ?? {};
+		const operator = event?.event?.operator ?? event?.operator ?? {};
+		const action = event?.event?.action ?? event?.action ?? {};
+		const chatId = (ctx?.chat_id ?? "").trim();
+		const senderId = (operator?.open_id ?? "").trim();
+		const openMessageId = (ctx?.open_message_id ?? "").trim();
+		const binding = openMessageId ? getFeishuBindingByMessageId(openMessageId) : null;
+		const isGroup = chatId.startsWith("oc_");
+		const sessionKey = binding?.sessionKey ?? generateSessionKey({
+			source: "feishu",
+			chatId: chatId || senderId,
+			senderId: senderId || "unknown",
+			isGroup: Boolean(chatId) && isGroup,
+			accountId: account.accountId
+		});
+		const extracted = extractCardActionCommand(action);
+		const content = extracted?.trim() || `[card action: ${String(action?.tag ?? "unknown")}]`;
+		await bus.publishInbound({
+			channel: "feishu",
+			sender_id: senderId || "unknown",
+			chat_id: chatId || senderId || "unknown",
+			content,
+			metadata: {
+				sessionKey,
+				accountId: account.accountId,
+				isGroup: Boolean(chatId) && isGroup,
+				feishuEventType: "card.action.trigger",
+				cardActionText: extracted ?? null,
+				cardAction: action,
+				cardContext: ctx,
+				raw: event
+			}
+		});
+	}
+	async function handleMessageRecalled(event) {
+		const e = event?.event ?? event ?? {};
+		const recalledMessageId = (e?.message_id ?? "").trim();
+		const chatId = (e?.chat_id ?? "").trim();
+		if (!recalledMessageId) return;
+		const binding = getFeishuBindingByMessageId(recalledMessageId);
+		if (!binding && !chatId) return;
+		const isGroup = (binding?.isGroup ?? chatId.startsWith("oc_")) === true;
+		const sessionKey = binding?.sessionKey ?? generateSessionKey({
+			source: "feishu",
+			chatId: chatId || "unknown",
+			senderId: binding?.senderId ?? "unknown",
+			isGroup,
+			accountId: account.accountId
+		});
+		await bus.publishInbound({
+			channel: "feishu",
+			sender_id: binding?.senderId ?? "system",
+			chat_id: chatId || binding?.chatId || "unknown",
+			content: `撤回了一条消息（${recalledMessageId}）`,
+			metadata: {
+				sessionKey,
+				accountId: account.accountId,
+				isGroup,
+				threadId: binding?.threadId,
+				feishuEventType: "im.message.recalled_v1",
+				recalledMessageId,
+				recallTime: e?.recall_time,
+				recallType: e?.recall_type,
+				raw: event
+			}
+		});
+	}
+	async function handleMessageReceive(event) {
+		lastEventAt = Date.now();
+		const msg = event?.event?.message ?? event?.message ?? event?.data?.message;
+		const sender = event?.event?.sender ?? event?.sender ?? event?.data?.sender;
+		const chatId = msg?.chat_id ?? msg?.chatId ?? "";
+		const messageId = msg?.message_id ?? msg?.messageId ?? "";
+		const chatType = msg?.chat_type ?? msg?.chatType ?? "";
+		const senderId = sender?.sender_id?.open_id ?? sender?.sender_id?.user_id ?? sender?.open_id ?? sender?.user_id ?? "";
+		const senderName = sender?.sender_id?.name ?? sender?.sender_name ?? void 0;
+		if (!chatId || !messageId || !senderId) {
+			log.warn({ accountId: account.accountId }, "Feishu inbound missing ids; dropping");
+			return;
+		}
+		if (!dedupe.claim(messageId)) return;
+		const isGroup = chatType === "group" || chatType === "chat";
+		const text = msg?.content && typeof msg.content === "string" ? safeJsonText(msg.content) : safeJsonText(msg?.body?.content);
+		const normalizedText = stripFeishuMentions(text ?? "").trim();
+		if (!normalizedText) return;
+		const threadId = msg?.thread_id ?? msg?.threadId ?? void 0;
+		const sessionKey = generateSessionKey({
+			source: "feishu",
+			chatId,
+			senderId,
+			isGroup,
+			threadId: typeof threadId === "string" && threadId.trim() ? threadId : void 0,
+			accountId: account.accountId
+		});
+		recordFeishuMessageBinding({
+			messageId,
+			sessionKey,
+			accountId: account.accountId,
+			chatId,
+			senderId,
+			isGroup,
+			threadId: typeof threadId === "string" && threadId.trim() ? threadId : void 0
+		});
+		const securityCtx = {
+			accountId: account.accountId,
+			chatId,
+			senderId,
+			senderName,
+			isGroup,
+			threadId
+		};
+		const access = security.checkAccess(securityCtx);
+		if (access && !access.allowed) {
+			log.warn({
+				accountId: account.accountId,
+				chatId,
+				senderId,
+				reason: access.reason
+			}, "Feishu: message dropped by channel security");
+			return;
+		}
+		if (isGroup && account.requireMention) {
+			const rawText = text ?? "";
+			if (!rawText.includes("<at ") && !rawText.includes("@")) return;
+		}
+		await bus.publishInbound({
+			channel: "feishu",
+			sender_id: senderId,
+			chat_id: chatId,
+			content: normalizedText,
+			metadata: {
+				sessionKey,
+				accountId: account.accountId,
+				messageId,
+				threadId,
+				isGroup,
+				raw: event
+			}
+		});
+	}
+	async function run() {
+		let attempt = 0;
+		const heartbeatTimer = setInterval(() => {
+			if (abortSignal.aborted) return;
+			if (lastEventAt === 0) return;
+			const silentForMs = Date.now() - lastEventAt;
+			if (silentForMs > 5 * 6e4) log.warn({
+				accountId: account.accountId,
+				silentForMs
+			}, "Feishu socket mode: no events recently");
+		}, 6e4);
+		try {
+			while (!abortSignal.aborted) {
+				attempt++;
+				const { wsClient, dispatcher, api } = createFeishuClient(account);
+				dispatcher.register({
+					"im.message.receive_v1": async (data) => {
+						await handleMessageReceive(data);
+					},
+					"im.message.reaction.created_v1": async (data) => {
+						await handleReactionEvent("created", data, api);
+					},
+					"im.message.reaction.deleted_v1": async (data) => {
+						await handleReactionEvent("deleted", data, api);
+					},
+					"im.message.recalled_v1": async (data) => {
+						await handleMessageRecalled(data);
+					},
+					"card.action.trigger": async (data) => {
+						await handleCardAction(data);
+					}
+				});
+				try {
+					wsClient.start({ eventDispatcher: dispatcher });
+				} catch (err) {
+					const delayMs = computeBackoffMs(attempt);
+					log.error({
+						err,
+						accountId: account.accountId,
+						delayMs
+					}, "Feishu socket mode start failed; retrying");
+					await sleep(delayMs, abortSignal);
+					continue;
+				}
+				const exited = await new Promise((resolve) => {
+					const onAbort = () => resolve({ ok: true });
+					if (abortSignal.aborted) return resolve({ ok: true });
+					abortSignal.addEventListener("abort", onAbort, { once: true });
+					wsClient?.on?.("error", (err) => resolve({
+						ok: false,
+						err
+					}));
+					wsClient?.on?.("close", () => resolve({
+						ok: false,
+						err: /* @__PURE__ */ new Error("ws closed")
+					}));
+				});
+				try {
+					wsClient.stop();
+				} catch {}
+				if (abortSignal.aborted) return;
+				const delayMs = computeBackoffMs(attempt);
+				log.warn({
+					accountId: account.accountId,
+					delayMs,
+					err: exited.err ? String(exited.err) : void 0
+				}, "Feishu socket mode disconnected; restarting");
+				await sleep(delayMs, abortSignal);
+			}
+		} finally {
+			clearInterval(heartbeatTimer);
+		}
+	}
+	return { run };
+}
+async function fetchFeishuMessageForReaction(api, messageId, timeoutMs) {
+	const t = messageId.trim();
+	if (!t) return null;
+	try {
+		const result = await Promise.race([api.im.message.get({ path: { message_id: t } }), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("timeout")), timeoutMs))]);
+		return result?.data ?? result;
+	} catch {
+		return null;
+	}
+}
+function extractFeishuMessagePreview(msg) {
+	const raw = msg?.body?.content ?? msg?.content ?? msg?.message?.content;
+	if (typeof raw !== "string" || !raw.trim()) return "";
+	try {
+		const parsed = JSON.parse(raw);
+		const t = typeof parsed?.text === "string" ? parsed.text : typeof parsed?.content === "string" ? parsed.content : "";
+		return summarizeText(String(t || ""), 80);
+	} catch {
+		return summarizeText(raw, 80);
+	}
+}
+function summarizeText(text, max) {
+	const s = text.replace(/\s+/g, " ").trim();
+	if (s.length <= max) return s;
+	return s.slice(0, max - 1) + "…";
+}
+function safeJsonText(raw) {
+	if (typeof raw !== "string" || !raw.trim()) return void 0;
+	try {
+		const parsed = JSON.parse(raw);
+		const t = typeof parsed?.text === "string" ? parsed.text : typeof parsed?.content === "string" ? parsed.content : typeof parsed?.title === "string" ? parsed.title : void 0;
+		return typeof t === "string" ? t : raw;
+	} catch {
+		return raw;
+	}
+}
+function extractCardActionCommand(action) {
+	const value = action?.value;
+	if (!value || typeof value !== "object") return null;
+	const v = value;
+	const command = typeof v.command === "string" ? v.command.trim() : "";
+	if (command) return command;
+	const text = typeof v.text === "string" ? v.text.trim() : "";
+	if (text) return text;
+	return null;
+}
+function sleep(ms, signal) {
+	return new Promise((resolve) => {
+		if (signal.aborted) return resolve();
+		const t = setTimeout(resolve, ms);
+		signal.addEventListener("abort", () => {
+			clearTimeout(t);
+			resolve();
+		}, { once: true });
+	});
+}
+//#endregion
+export { createFeishuSocketModeMonitor };
+
+//# sourceMappingURL=monitor.js.map

package/dist/extensions/feishu/src/transport/socket-mode/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","names":[],"sources":["../../../../../../extensions/feishu/src/transport/socket-mode/monitor.ts"],"sourcesContent":["import type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport type { ChannelSecurityContext } from '@xopcai/xopc/channels/plugin-types.js';\nimport { generateSessionKey } from '@xopcai/xopc/chat-commands/session-key.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport type { ResolvedFeishuAccount } from '../../state/accounts.js';\nimport { createFeishuClient } from '../client/client.js';\nimport { createFeishuDedupe } from '../reliability/dedupe.js';\nimport { stripFeishuMentions } from '../text/mentions.js';\nimport { computeBackoffMs } from './retry.js';\nimport { getFeishuBindingByMessageId, recordFeishuMessageBinding } from '../../state/message-bindings.js';\n\nconst log = createLogger('FeishuSocketMode');\n\nexport interface FeishuSocketModeMonitorDeps {\n  account: ResolvedFeishuAccount;\n  config: Config;\n  bus: MessageBus;\n  abortSignal: AbortSignal;\n  security: {\n    checkAccess: (ctx: ChannelSecurityContext) => { allowed: boolean; reason?: string } | undefined;\n  };\n}\n\nexport function createFeishuSocketModeMonitor(deps: FeishuSocketModeMonitorDeps) {\n  const { account, config: _config, bus, abortSignal, security } = deps;\n  const dedupe = createFeishuDedupe();\n  let lastEventAt = 0;\n\n  async function handleReactionEvent(kind: 'created' | 'deleted', event: any, api: any): Promise<void> {\n    const msgId = event?.event?.message_id ?? event?.message_id ?? '';\n    const emojiType = event?.event?.reaction_type?.emoji_type ?? event?.reaction_type?.emoji_type ?? '';\n    const operatorType = event?.event?.operator_type ?? event?.operator_type ?? '';\n    const userOpenId =\n      event?.event?.user_id?.open_id ?? event?.user_id?.open_id ?? event?.event?.open_id ?? event?.open_id ?? '';\n    if (!msgId || !emojiType) return;\n    if (operatorType === 'app') return;\n\n    const notifMode = account.reactionNotifications ?? 'own';\n    if (notifMode === 'off') {\n      return;\n    }\n\n    const binding = getFeishuBindingByMessageId(msgId);\n    if (!binding) return;\n\n    const reacted = await fetchFeishuMessageForReaction(api, msgId, 1500);\n    if (!reacted && notifMode === 'own') {\n      // In own-mode, we must be sure this is a bot message.\n      return;\n    }\n\n    const isBotMessage = reacted?.sender_type === 'app' || reacted?.senderType === 'app';\n    if (notifMode === 'own' && !isBotMessage) {\n      return;\n    }\n\n    const senderId = userOpenId || binding.senderId;\n    const preview = reacted ? extractFeishuMessagePreview(reacted) : '';\n\n    await bus.publishInbound({\n      channel: 'feishu',\n      sender_id: senderId,\n      chat_id: binding.chatId,\n      content:\n        kind === 'deleted'\n          ? `撤回了一个表情（${emojiType}）${preview ? `，对应消息：「${preview}」` : ''}`\n          : `对一条消息添加了表情（${emojiType}）${preview ? `：「${preview}」` : ''}`,\n      metadata: {\n        sessionKey: binding.sessionKey,\n        accountId: binding.accountId,\n        isGroup: binding.isGroup,\n        threadId: binding.threadId,\n        feishuEventType: `im.message.reaction.${kind}_v1`,\n        reactedMessageId: msgId,\n        emojiType,\n        raw: event,\n        reactedMessage: reacted ?? null,\n      },\n    });\n  }\n\n  async function handleCardAction(event: any): Promise<void> {\n    const ctx = event?.event?.context ?? event?.context ?? {};\n    const operator = event?.event?.operator ?? event?.operator ?? {};\n    const action = event?.event?.action ?? event?.action ?? {};\n    const chatId = (ctx?.chat_id ?? '').trim();\n    const senderId = (operator?.open_id ?? '').trim();\n    const openMessageId = (ctx?.open_message_id ?? '').trim();\n    const binding = openMessageId ? getFeishuBindingByMessageId(openMessageId) : null;\n\n    const isGroup = chatId.startsWith('oc_');\n    const sessionKey =\n      binding?.sessionKey ??\n      generateSessionKey({\n        source: 'feishu',\n        chatId: chatId || senderId,\n        senderId: senderId || 'unknown',\n        isGroup: Boolean(chatId) && isGroup,\n        accountId: account.accountId,\n      });\n\n    const extracted = extractCardActionCommand(action);\n    const content =\n      extracted?.trim() ||\n      `[card action: ${String(action?.tag ?? 'unknown')}]`;\n\n    await bus.publishInbound({\n      channel: 'feishu',\n      sender_id: senderId || 'unknown',\n      chat_id: chatId || senderId || 'unknown',\n      content,\n      metadata: {\n        sessionKey,\n        accountId: account.accountId,\n        isGroup: Boolean(chatId) && isGroup,\n        feishuEventType: 'card.action.trigger',\n        cardActionText: extracted ?? null,\n        cardAction: action,\n        cardContext: ctx,\n        raw: event,\n      },\n    });\n  }\n\n  async function handleMessageRecalled(event: any): Promise<void> {\n    const e = event?.event ?? event ?? {};\n    const recalledMessageId = (e?.message_id ?? '').trim();\n    const chatId = (e?.chat_id ?? '').trim();\n    if (!recalledMessageId) return;\n\n    const binding = getFeishuBindingByMessageId(recalledMessageId);\n    if (!binding && !chatId) return;\n\n    const isGroup = (binding?.isGroup ?? chatId.startsWith('oc_')) === true;\n    const sessionKey =\n      binding?.sessionKey ??\n      generateSessionKey({\n        source: 'feishu',\n        chatId: chatId || 'unknown',\n        senderId: binding?.senderId ?? 'unknown',\n        isGroup,\n        accountId: account.accountId,\n      });\n\n    await bus.publishInbound({\n      channel: 'feishu',\n      sender_id: binding?.senderId ?? 'system',\n      chat_id: chatId || binding?.chatId || 'unknown',\n      content: `撤回了一条消息（${recalledMessageId}）`,\n      metadata: {\n        sessionKey,\n        accountId: account.accountId,\n        isGroup,\n        threadId: binding?.threadId,\n        feishuEventType: 'im.message.recalled_v1',\n        recalledMessageId,\n        recallTime: e?.recall_time,\n        recallType: e?.recall_type,\n        raw: event,\n      },\n    });\n  }\n\n  async function handleMessageReceive(event: any): Promise<void> {\n    lastEventAt = Date.now();\n    const msg = event?.event?.message ?? event?.message ?? event?.data?.message;\n    const sender = event?.event?.sender ?? event?.sender ?? event?.data?.sender;\n    const chatId = msg?.chat_id ?? msg?.chatId ?? '';\n    const messageId = msg?.message_id ?? msg?.messageId ?? '';\n    const chatType = msg?.chat_type ?? msg?.chatType ?? '';\n\n    const senderId =\n      sender?.sender_id?.open_id ??\n      sender?.sender_id?.user_id ??\n      sender?.open_id ??\n      sender?.user_id ??\n      '';\n    const senderName = sender?.sender_id?.name ?? sender?.sender_name ?? undefined;\n\n    if (!chatId || !messageId || !senderId) {\n      log.warn({ accountId: account.accountId }, 'Feishu inbound missing ids; dropping');\n      return;\n    }\n\n    if (!dedupe.claim(messageId)) {\n      return;\n    }\n\n    const isGroup = chatType === 'group' || chatType === 'chat';\n    const text =\n      msg?.content && typeof msg.content === 'string'\n        ? safeJsonText(msg.content)\n        : safeJsonText(msg?.body?.content);\n\n    const normalizedText = stripFeishuMentions(text ?? '').trim();\n    if (!normalizedText) {\n      return;\n    }\n\n    const threadId = msg?.thread_id ?? msg?.threadId ?? undefined;\n\n    const sessionKey = generateSessionKey({\n      source: 'feishu',\n      chatId,\n      senderId,\n      isGroup,\n      threadId: typeof threadId === 'string' && threadId.trim() ? threadId : undefined,\n      accountId: account.accountId,\n    });\n\n    recordFeishuMessageBinding({\n      messageId,\n      sessionKey,\n      accountId: account.accountId,\n      chatId,\n      senderId,\n      isGroup,\n      threadId: typeof threadId === 'string' && threadId.trim() ? threadId : undefined,\n    });\n\n    const securityCtx: ChannelSecurityContext = {\n      accountId: account.accountId,\n      chatId,\n      senderId,\n      senderName,\n      isGroup,\n      threadId,\n    };\n\n    const access = security.checkAccess(securityCtx);\n    if (access && !access.allowed) {\n      log.warn(\n        { accountId: account.accountId, chatId, senderId, reason: access.reason },\n        'Feishu: message dropped by channel security',\n      );\n      return;\n    }\n\n    if (isGroup && account.requireMention) {\n      const rawText = text ?? '';\n      // Minimal mention gate: require at-tag markup. Later we tighten to bot-identity mention.\n      if (!rawText.includes('<at ') && !rawText.includes('@')) {\n        return;\n      }\n    }\n\n    await bus.publishInbound({\n      channel: 'feishu',\n      sender_id: senderId,\n      chat_id: chatId,\n      content: normalizedText,\n      metadata: {\n        sessionKey,\n        accountId: account.accountId,\n        messageId,\n        threadId,\n        isGroup,\n        raw: event,\n      },\n    });\n  }\n\n  async function run(): Promise<void> {\n    let attempt = 0;\n\n    const heartbeatTimer = setInterval(() => {\n      if (abortSignal.aborted) return;\n      if (lastEventAt === 0) return;\n      const silentForMs = Date.now() - lastEventAt;\n      if (silentForMs > 5 * 60_000) {\n        log.warn({ accountId: account.accountId, silentForMs }, 'Feishu socket mode: no events recently');\n      }\n    }, 60_000);\n\n    try {\n      while (!abortSignal.aborted) {\n        attempt++;\n        const client = createFeishuClient(account);\n        const { wsClient, dispatcher, api } = client;\n\n        dispatcher.register({\n          'im.message.receive_v1': async (data: any) => {\n            await handleMessageReceive(data);\n          },\n          'im.message.reaction.created_v1': async (data: any) => {\n            await handleReactionEvent('created', data, api);\n          },\n          'im.message.reaction.deleted_v1': async (data: any) => {\n            await handleReactionEvent('deleted', data, api);\n          },\n          'im.message.recalled_v1': async (data: any) => {\n            await handleMessageRecalled(data);\n          },\n          'card.action.trigger': async (data: any) => {\n            await handleCardAction(data);\n          },\n        });\n\n        try {\n          wsClient.start({ eventDispatcher: dispatcher });\n        } catch (err) {\n          const delayMs = computeBackoffMs(attempt);\n          log.error({ err, accountId: account.accountId, delayMs }, 'Feishu socket mode start failed; retrying');\n          await sleep(delayMs, abortSignal);\n          continue;\n        }\n\n        // Wait until abort or wsClient errors out.\n        const exited = await new Promise<{ ok: boolean; err?: unknown }>((resolve) => {\n          const onAbort = () => resolve({ ok: true });\n          if (abortSignal.aborted) return resolve({ ok: true });\n          abortSignal.addEventListener('abort', onAbort, { once: true });\n          (wsClient as any)?.on?.('error', (err: unknown) => resolve({ ok: false, err }));\n          (wsClient as any)?.on?.('close', () => resolve({ ok: false, err: new Error('ws closed') }));\n        });\n\n        try {\n          wsClient.stop();\n        } catch {\n          // ignore\n        }\n\n        if (abortSignal.aborted) {\n          return;\n        }\n\n        const delayMs = computeBackoffMs(attempt);\n        log.warn(\n          { accountId: account.accountId, delayMs, err: exited.err ? String(exited.err) : undefined },\n          'Feishu socket mode disconnected; restarting',\n        );\n        await sleep(delayMs, abortSignal);\n      }\n    } finally {\n      clearInterval(heartbeatTimer);\n    }\n  }\n\n  return { run };\n}\n\nasync function fetchFeishuMessageForReaction(api: any, messageId: string, timeoutMs: number): Promise<any | null> {\n  const t = messageId.trim();\n  if (!t) return null;\n  try {\n    const result = await Promise.race([\n      (api as any).im.message.get({ path: { message_id: t } }),\n      new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs)),\n    ]);\n    return (result as any)?.data ?? result;\n  } catch {\n    return null;\n  }\n}\n\nfunction extractFeishuMessagePreview(msg: any): string {\n  const raw = msg?.body?.content ?? msg?.content ?? msg?.message?.content;\n  if (typeof raw !== 'string' || !raw.trim()) return '';\n  try {\n    const parsed = JSON.parse(raw);\n    const t =\n      typeof parsed?.text === 'string'\n        ? parsed.text\n        : typeof parsed?.content === 'string'\n          ? parsed.content\n          : '';\n    return summarizeText(String(t || ''), 80);\n  } catch {\n    return summarizeText(raw, 80);\n  }\n}\n\nfunction summarizeText(text: string, max: number): string {\n  const s = text.replace(/\\s+/g, ' ').trim();\n  if (s.length <= max) return s;\n  return s.slice(0, max - 1) + '…';\n}\n\nfunction safeJsonText(raw: unknown): string | undefined {\n  if (typeof raw !== 'string' || !raw.trim()) return undefined;\n  try {\n    const parsed = JSON.parse(raw);\n    const t =\n      typeof parsed?.text === 'string'\n        ? parsed.text\n        : typeof parsed?.content === 'string'\n          ? parsed.content\n          : typeof parsed?.title === 'string'\n            ? parsed.title\n            : undefined;\n    return typeof t === 'string' ? t : raw;\n  } catch {\n    return raw;\n  }\n}\n\nfunction extractCardActionCommand(action: any): string | null {\n  const value = action?.value;\n  if (!value || typeof value !== 'object') {\n    return null;\n  }\n  const v = value as Record<string, unknown>;\n  const command = typeof v.command === 'string' ? v.command.trim() : '';\n  if (command) return command;\n  const text = typeof v.text === 'string' ? v.text.trim() : '';\n  if (text) return text;\n  return null;\n}\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise((resolve) => {\n    if (signal.aborted) return resolve();\n    const t = setTimeout(resolve, ms);\n    signal.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(t);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\n"],"mappings":"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"}

package/dist/extensions/feishu/src/transport/socket-mode/retry.d.ts

@@ -0,0 +1 @@
+export declare function computeBackoffMs(attempt: number): number;

package/dist/extensions/feishu/src/transport/socket-mode/retry.js

@@ -0,0 +1,10 @@
+//#region extensions/feishu/src/transport/socket-mode/retry.ts
+function computeBackoffMs(attempt) {
+	const base = 500 * 2 ** (Math.max(1, Math.min(attempt, 10)) - 1);
+	const jitter = Math.floor(Math.random() * 250);
+	return Math.min(3e4, base + jitter);
+}
+//#endregion
+export { computeBackoffMs };
+
+//# sourceMappingURL=retry.js.map

package/dist/extensions/feishu/src/transport/socket-mode/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","names":[],"sources":["../../../../../../extensions/feishu/src/transport/socket-mode/retry.ts"],"sourcesContent":["export function computeBackoffMs(attempt: number): number {\n  const a = Math.max(1, Math.min(attempt, 10));\n  const base = 500 * 2 ** (a - 1); // 0.5s, 1s, 2s, ...\n  const jitter = Math.floor(Math.random() * 250);\n  return Math.min(30_000, base + jitter);\n}\n\n"],"mappings":";AAAA,SAAgB,iBAAiB,SAAyB;CAExD,MAAM,OAAO,MAAM,MADT,KAAK,IAAI,GAAG,KAAK,IAAI,SAAS,GAAG,CACjB,GAAG;CAC7B,MAAM,SAAS,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI;AAC9C,QAAO,KAAK,IAAI,KAAQ,OAAO,OAAO"}

package/dist/extensions/feishu/src/transport/text/mentions.d.ts

@@ -0,0 +1 @@
+export declare function stripFeishuMentions(text: string): string;

package/dist/extensions/feishu/src/transport/text/mentions.js

@@ -0,0 +1,9 @@
+//#region extensions/feishu/src/transport/text/mentions.ts
+const FEISHU_AT_RE = /<at\s+user_id="[^"]*">([^<]*)<\/at>/g;
+function stripFeishuMentions(text) {
+	return String(text ?? "").replaceAll(FEISHU_AT_RE, "$1");
+}
+//#endregion
+export { stripFeishuMentions };
+
+//# sourceMappingURL=mentions.js.map

package/dist/extensions/feishu/src/transport/text/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","names":[],"sources":["../../../../../../extensions/feishu/src/transport/text/mentions.ts"],"sourcesContent":["const FEISHU_AT_RE = /<at\\s+user_id=\"[^\"]*\">([^<]*)<\\/at>/g;\n\nexport function stripFeishuMentions(text: string): string {\n  const raw = String(text ?? '');\n  return raw.replaceAll(FEISHU_AT_RE, '$1');\n}\n\n"],"mappings":";AAAA,MAAM,eAAe;AAErB,SAAgB,oBAAoB,MAAsB;AAExD,QADY,OAAO,QAAQ,GACjB,CAAC,WAAW,cAAc,KAAK"}

package/dist/extensions/feishu/src/transport/webhook/monitor.d.ts

@@ -0,0 +1,19 @@
+import type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';
+import type { Config } from '@xopcai/xopc/config/schema.js';
+import type { ChannelSecurityContext } from '@xopcai/xopc/channels/plugin-types.js';
+import type { ResolvedFeishuAccount } from '../../state/accounts.js';
+export interface FeishuWebhookMonitorDeps {
+    account: ResolvedFeishuAccount;
+    config: Config;
+    bus: MessageBus;
+    abortSignal: AbortSignal;
+    security: {
+        checkAccess: (ctx: ChannelSecurityContext) => {
+            allowed: boolean;
+            reason?: string;
+        } | undefined;
+    };
+}
+export declare function createFeishuWebhookMonitor(deps: FeishuWebhookMonitorDeps): {
+    run: () => Promise<void>;
+};