@kodelyth/feishu 2026.5.42 → 2026.6.2

package/src/mention-target.types.ts

@@ -1,5 +0,0 @@
-export type MentionTarget = {
-  openId: string;
-  name: string;
-  key: string; // Placeholder in original message, e.g. @_user_1
-};

package/src/mention.ts

@@ -1,114 +0,0 @@
-import type { FeishuMessageEvent } from "./event-types.js";
-import type { MentionTarget } from "./mention-target.types.js";
-import { isFeishuGroupChatType } from "./types.js";
-
-type FeishuMentionLike = {
-  key?: string;
-  id?: {
-    open_id?: string;
-    user_id?: string;
-    union_id?: string;
-  };
-  name?: string;
-};
-
-export function isFeishuBroadcastMention(mention: FeishuMentionLike): boolean {
-  const normalizedKey = mention.key?.trim().toLowerCase();
-  if (normalizedKey === "@all" || normalizedKey === "@_all") {
-    return true;
-  }
-
-  const mentionIds = [mention.id?.open_id, mention.id?.user_id, mention.id?.union_id];
-  return mentionIds.some((id) => id?.trim().toLowerCase() === "all");
-}
-
-/**
- * Extract mention targets from message event (excluding the bot itself)
- */
-export function extractMentionTargets(
-  event: FeishuMessageEvent,
-  botOpenId?: string,
-): MentionTarget[] {
-  const mentions = event.message.mentions ?? [];
-
-  return mentions
-    .filter((m) => {
-      if (isFeishuBroadcastMention(m)) {
-        return false;
-      }
-      // Exclude the bot itself
-      if (botOpenId && m.id.open_id === botOpenId) {
-        return false;
-      }
-      // Must have open_id
-      return !!m.id.open_id;
-    })
-    .map((m) => ({
-      openId: m.id.open_id!,
-      name: m.name,
-      key: m.key,
-    }));
-}
-
-/**
- * Check if message is a mention forward request
- * Rules:
- * - Group: message mentions bot + at least one other user
- * - DM: message mentions any user (no need to mention bot)
- */
-export function isMentionForwardRequest(event: FeishuMessageEvent, botOpenId?: string): boolean {
-  const mentions = event.message.mentions ?? [];
-  if (mentions.length === 0) {
-    return false;
-  }
-
-  const isDirectMessage = !isFeishuGroupChatType(event.message.chat_type);
-  const userMentions = mentions.filter((m) => !isFeishuBroadcastMention(m));
-  const hasOtherMention = userMentions.some((m) => m.id.open_id !== botOpenId);
-
-  if (isDirectMessage) {
-    // DM: trigger if any non-bot user is mentioned
-    return hasOtherMention;
-  }
-  // Group: need to mention both bot and other users
-  const hasBotMention = userMentions.some((m) => m.id.open_id === botOpenId);
-  return hasBotMention && hasOtherMention;
-}
-
-/**
- * Format @mention for text message
- */
-function formatMentionForText(target: MentionTarget): string {
-  return `<at user_id="${target.openId}">${target.name}</at>`;
-}
-
-/**
- * Format @mention for card message (lark_md)
- */
-function formatMentionForCard(target: MentionTarget): string {
-  return `<at id=${target.openId}></at>`;
-}
-
-/**
- * Build complete message with @mentions (text format)
- */
-export function buildMentionedMessage(targets: MentionTarget[], message: string): string {
-  if (targets.length === 0) {
-    return message;
-  }
-
-  const mentionParts = targets.map((t) => formatMentionForText(t));
-  return `${mentionParts.join(" ")} ${message}`;
-}
-
-/**
- * Build card content with @mentions (Markdown format)
- */
-export function buildMentionedCardContent(targets: MentionTarget[], message: string): string {
-  if (targets.length === 0) {
-    return message;
-  }
-
-  const mentionParts = targets.map((t) => formatMentionForCard(t));
-  return `${mentionParts.join(" ")} ${message}`;
-}

package/src/message-action-contract.ts

@@ -1,13 +0,0 @@
-import type { ChannelMessageActionName } from "klaw/plugin-sdk/channel-contract";
-
-type MessageActionTargetAliasSpec = {
-  aliases: string[];
-};
-
-export const messageActionTargetAliases = {
-  read: { aliases: ["messageId"] },
-  pin: { aliases: ["messageId"] },
-  unpin: { aliases: ["messageId"] },
-  "list-pins": { aliases: ["chatId"] },
-  "channel-info": { aliases: ["chatId"] },
-} satisfies Partial<Record<ChannelMessageActionName, MessageActionTargetAliasSpec>>;

package/src/monitor-state-runtime-api.ts

@@ -1,7 +0,0 @@
-export type { RuntimeEnv } from "klaw/plugin-sdk/runtime";
-export {
-  createFixedWindowRateLimiter,
-  createWebhookAnomalyTracker,
-  WEBHOOK_ANOMALY_COUNTER_DEFAULTS,
-  WEBHOOK_RATE_LIMIT_DEFAULTS,
-} from "klaw/plugin-sdk/webhook-ingress";

package/src/monitor-transport-runtime-api.ts

@@ -1,10 +0,0 @@
-export type { RuntimeEnv } from "../runtime-api.js";
-export { safeEqualSecret } from "klaw/plugin-sdk/security-runtime";
-export {
-  applyBasicWebhookRequestGuards,
-  resolveRequestClientIp,
-} from "klaw/plugin-sdk/webhook-ingress";
-export {
-  installRequestBodyLimitGuard,
-  readWebhookBodyOrReject,
-} from "klaw/plugin-sdk/webhook-request-guards";

package/src/monitor.account.ts

@@ -1,492 +0,0 @@
-import * as crypto from "node:crypto";
-import type * as Lark from "@larksuiteoapi/node-sdk";
-import type { ClawdbotConfig, RuntimeEnv, HistoryEntry } from "../runtime-api.js";
-import { raceWithTimeoutAndAbort } from "./async.js";
-import {
-  handleFeishuMessage,
-  parseFeishuMessageEvent,
-  type FeishuMessageEvent,
-  type FeishuBotAddedEvent,
-} from "./bot.js";
-import { handleFeishuCardAction, type FeishuCardActionEvent } from "./card-action.js";
-import { createEventDispatcher } from "./client.js";
-import { isRecord, readString } from "./comment-shared.js";
-import {
-  hasProcessedFeishuMessage,
-  recordProcessedFeishuMessage,
-  warmupDedupFromDisk,
-} from "./dedup.js";
-import { applyBotIdentityState, startBotIdentityRecovery } from "./monitor.bot-identity.js";
-import { createFeishuBotMenuHandler } from "./monitor.bot-menu-handler.js";
-import { createFeishuDriveCommentNoticeHandler } from "./monitor.comment-notice-handler.js";
-import { createFeishuMessageReceiveHandler } from "./monitor.message-handler.js";
-import { fetchBotIdentityForMonitor } from "./monitor.startup.js";
-import { botNames, botOpenIds } from "./monitor.state.js";
-import { FeishuRetryableSyntheticEventError } from "./monitor.synthetic-error.js";
-import { monitorWebhook, monitorWebSocket } from "./monitor.transport.js";
-import { getFeishuRuntime } from "./runtime.js";
-import { getMessageFeishu } from "./send.js";
-import { getFeishuSequentialKey } from "./sequential-key.js";
-import { createFeishuThreadBindingManager } from "./thread-bindings.js";
-import type { FeishuChatType, ResolvedFeishuAccount } from "./types.js";
-
-const FEISHU_REACTION_VERIFY_TIMEOUT_MS = 1_500;
-
-export { FeishuRetryableSyntheticEventError };
-
-export type FeishuReactionCreatedEvent = {
-  message_id: string;
-  chat_id?: string;
-  chat_type?: string;
-  reaction_type?: { emoji_type?: string };
-  operator_type?: string;
-  user_id?: { open_id?: string; user_id?: string };
-  action_time?: string;
-};
-
-export type FeishuReactionDeletedEvent = FeishuReactionCreatedEvent & {
-  reaction_id?: string;
-};
-
-type ResolveReactionSyntheticEventParams = {
-  cfg: ClawdbotConfig;
-  accountId: string;
-  event: FeishuReactionCreatedEvent;
-  botOpenId?: string;
-  fetchMessage?: typeof getMessageFeishu;
-  verificationTimeoutMs?: number;
-  logger?: (message: string) => void;
-  uuid?: () => string;
-  action?: "created" | "deleted";
-};
-
-export async function resolveReactionSyntheticEvent(
-  params: ResolveReactionSyntheticEventParams,
-): Promise<FeishuMessageEvent | null> {
-  const {
-    cfg,
-    accountId,
-    event,
-    botOpenId,
-    fetchMessage = getMessageFeishu,
-    verificationTimeoutMs = FEISHU_REACTION_VERIFY_TIMEOUT_MS,
-    logger,
-    uuid = () => crypto.randomUUID(),
-    action = "created",
-  } = params;
-
-  const emoji = event.reaction_type?.emoji_type;
-  const messageId = event.message_id;
-  const senderId = event.user_id?.open_id;
-  const senderUserId = event.user_id?.user_id;
-  if (!emoji || !messageId || !senderId) {
-    return null;
-  }
-
-  const { resolveFeishuAccount } = await import("./accounts.js");
-  const account = resolveFeishuAccount({ cfg, accountId });
-  const reactionNotifications = account.config.reactionNotifications ?? "own";
-  if (reactionNotifications === "off") {
-    return null;
-  }
-
-  if (event.operator_type === "app" || senderId === botOpenId) {
-    return null;
-  }
-
-  if (emoji === "Typing") {
-    return null;
-  }
-
-  if (reactionNotifications === "own" && !botOpenId) {
-    logger?.(
-      `feishu[${accountId}]: bot open_id unavailable, skipping reaction ${emoji} on ${messageId}`,
-    );
-    return null;
-  }
-
-  const reactedMsg = await raceWithTimeoutAndAbort(fetchMessage({ cfg, messageId, accountId }), {
-    timeoutMs: verificationTimeoutMs,
-  })
-    .then((result) => (result.status === "resolved" ? result.value : null))
-    .catch(() => null);
-  const isBotMessage = reactedMsg?.senderType === "app" || reactedMsg?.senderOpenId === botOpenId;
-  if (!reactedMsg || (reactionNotifications === "own" && !isBotMessage)) {
-    logger?.(
-      `feishu[${accountId}]: ignoring reaction on non-bot/unverified message ${messageId} ` +
-        `(sender: ${reactedMsg?.senderOpenId ?? "unknown"})`,
-    );
-    return null;
-  }
-
-  const fallbackChatType = reactedMsg.chatType;
-  const normalizedEventChatType = normalizeFeishuChatType(event.chat_type);
-  const resolvedChatType = normalizedEventChatType ?? fallbackChatType;
-  if (!resolvedChatType) {
-    logger?.(
-      `feishu[${accountId}]: skipping reaction ${emoji} on ${messageId} without chat type context`,
-    );
-    return null;
-  }
-
-  const syntheticChatIdRaw = event.chat_id ?? reactedMsg.chatId;
-  const syntheticChatId = syntheticChatIdRaw?.trim() ? syntheticChatIdRaw : `p2p:${senderId}`;
-  const syntheticChatType: FeishuChatType = resolvedChatType;
-  return {
-    sender: {
-      sender_id: {
-        open_id: senderId,
-        ...(senderUserId ? { user_id: senderUserId } : {}),
-      },
-      sender_type: "user",
-    },
-    message: {
-      message_id: `${messageId}:reaction:${emoji}:${uuid()}`,
-      chat_id: syntheticChatId,
-      chat_type: syntheticChatType,
-      message_type: "text",
-      content: JSON.stringify({
-        text:
-          action === "deleted"
-            ? `[removed reaction ${emoji} from message ${messageId}]`
-            : `[reacted with ${emoji} to message ${messageId}]`,
-      }),
-    },
-  };
-}
-
-function normalizeFeishuChatType(value: unknown): FeishuChatType | undefined {
-  return value === "group" || value === "topic_group" || value === "private" || value === "p2p"
-    ? value
-    : undefined;
-}
-
-type RegisterEventHandlersContext = {
-  cfg: ClawdbotConfig;
-  accountId: string;
-  runtime?: RuntimeEnv;
-  chatHistories: Map<string, HistoryEntry[]>;
-  fireAndForget?: boolean;
-};
-
-function parseFeishuBotAddedEventPayload(value: unknown): FeishuBotAddedEvent | null {
-  if (!isRecord(value) || !readString(value.chat_id) || !isRecord(value.operator_id)) {
-    return null;
-  }
-  return value as FeishuBotAddedEvent;
-}
-
-function parseFeishuBotRemovedChatId(value: unknown): string | null {
-  if (!isRecord(value)) {
-    return null;
-  }
-  return readString(value.chat_id) ?? null;
-}
-
-function firstString(...values: unknown[]): string | undefined {
-  for (const value of values) {
-    const stringValue = readString(value);
-    const trimmed = stringValue?.trim();
-    if (trimmed) {
-      return trimmed;
-    }
-  }
-  return undefined;
-}
-
-function readFeishuIdentityField(
-  value: unknown,
-  field: "open_id" | "user_id" | "union_id",
-): string | undefined {
-  if (!isRecord(value)) {
-    return undefined;
-  }
-  return firstString(value[field]);
-}
-
-function parseFeishuCardActionEventPayload(value: unknown): FeishuCardActionEvent | null {
-  if (!isRecord(value)) {
-    return null;
-  }
-  const operator = isRecord(value.operator) ? value.operator : {};
-  const action = value.action;
-  const context = isRecord(value.context) ? value.context : {};
-  if (!isRecord(action)) {
-    return null;
-  }
-  const operatorUserId = operator.user_id;
-  const token = readString(value.token);
-  const openId = firstString(
-    operator.open_id,
-    readFeishuIdentityField(operatorUserId, "open_id"),
-    value.open_id,
-    context.open_id,
-  );
-  const userId = firstString(
-    operator.user_id,
-    readFeishuIdentityField(operatorUserId, "user_id"),
-    value.user_id,
-    context.user_id,
-  );
-  const unionId = firstString(
-    operator.union_id,
-    readFeishuIdentityField(operatorUserId, "union_id"),
-  );
-  const tag = readString(action.tag);
-  const actionValue = action.value;
-  const openMessageId = firstString(value.open_message_id, context.open_message_id);
-  const contextOpenId = firstString(context.open_id, openId);
-  const contextUserId = firstString(context.user_id, userId);
-  const chatId = firstString(context.chat_id, context.open_chat_id);
-  if (!token || !openId || !tag || !isRecord(actionValue)) {
-    return null;
-  }
-  return {
-    operator: {
-      open_id: openId,
-      ...(userId ? { user_id: userId } : {}),
-      ...(unionId ? { union_id: unionId } : {}),
-    },
-    token,
-    action: {
-      value: actionValue,
-      tag,
-    },
-    ...(openMessageId ? { open_message_id: openMessageId } : {}),
-    context: {
-      ...(openMessageId ? { open_message_id: openMessageId } : {}),
-      ...(contextOpenId ? { open_id: contextOpenId } : {}),
-      ...(contextUserId ? { user_id: contextUserId } : {}),
-      ...(chatId ? { chat_id: chatId } : {}),
-    },
-  };
-}
-
-function registerEventHandlers(
-  eventDispatcher: Lark.EventDispatcher,
-  context: RegisterEventHandlersContext,
-): void {
-  const { cfg, accountId, runtime, chatHistories, fireAndForget } = context;
-  const log = runtime?.log ?? console.log;
-  const error = runtime?.error ?? console.error;
-  const runFeishuHandler = async (params: { task: () => Promise<void>; errorMessage: string }) => {
-    if (fireAndForget) {
-      void params.task().catch((err) => {
-        error(`${params.errorMessage}: ${String(err)}`);
-      });
-      return;
-    }
-    try {
-      await params.task();
-    } catch (err) {
-      error(`${params.errorMessage}: ${String(err)}`);
-    }
-  };
-
-  eventDispatcher.register({
-    "im.message.receive_v1": createFeishuMessageReceiveHandler({
-      cfg,
-      core: getFeishuRuntime(),
-      accountId,
-      runtime,
-      chatHistories,
-      fireAndForget,
-      handleMessage: handleFeishuMessage,
-      resolveDebounceText: ({ event, botOpenId, botName }) =>
-        parseFeishuMessageEvent(event, botOpenId, botName).content,
-      hasProcessedMessage: hasProcessedFeishuMessage,
-      recordProcessedMessage: recordProcessedFeishuMessage,
-      getBotOpenId: (id) => botOpenIds.get(id),
-      getBotName: (id) => botNames.get(id),
-      resolveSequentialKey: getFeishuSequentialKey,
-    }),
-    "im.message.message_read_v1": async () => {
-      // Ignore read receipts
-    },
-    "im.chat.member.bot.added_v1": async (data) => {
-      try {
-        const event = parseFeishuBotAddedEventPayload(data);
-        if (!event) {
-          return;
-        }
-        log(`feishu[${accountId}]: bot added to chat ${event.chat_id}`);
-      } catch (err) {
-        error(`feishu[${accountId}]: error handling bot added event: ${String(err)}`);
-      }
-    },
-    "im.chat.member.bot.deleted_v1": async (data) => {
-      try {
-        const chatId = parseFeishuBotRemovedChatId(data);
-        if (!chatId) {
-          return;
-        }
-        log(`feishu[${accountId}]: bot removed from chat ${chatId}`);
-      } catch (err) {
-        error(`feishu[${accountId}]: error handling bot removed event: ${String(err)}`);
-      }
-    },
-    "drive.notice.comment_add_v1": createFeishuDriveCommentNoticeHandler({
-      cfg,
-      accountId,
-      runtime,
-      fireAndForget,
-    }),
-    "im.message.reaction.created_v1": async (data) => {
-      await runFeishuHandler({
-        errorMessage: `feishu[${accountId}]: error handling reaction event`,
-        task: async () => {
-          const event = data as FeishuReactionCreatedEvent;
-          const myBotId = botOpenIds.get(accountId);
-          const syntheticEvent = await resolveReactionSyntheticEvent({
-            cfg,
-            accountId,
-            event,
-            botOpenId: myBotId,
-            logger: log,
-          });
-          if (!syntheticEvent) {
-            return;
-          }
-          const promise = handleFeishuMessage({
-            cfg,
-            event: syntheticEvent,
-            botOpenId: myBotId,
-            botName: botNames.get(accountId),
-            runtime,
-            chatHistories,
-            accountId,
-          });
-          await promise;
-        },
-      });
-    },
-    "im.message.reaction.deleted_v1": async (data) => {
-      await runFeishuHandler({
-        errorMessage: `feishu[${accountId}]: error handling reaction removal event`,
-        task: async () => {
-          const event = data as FeishuReactionDeletedEvent;
-          const myBotId = botOpenIds.get(accountId);
-          const syntheticEvent = await resolveReactionSyntheticEvent({
-            cfg,
-            accountId,
-            event,
-            botOpenId: myBotId,
-            logger: log,
-            action: "deleted",
-          });
-          if (!syntheticEvent) {
-            return;
-          }
-          const promise = handleFeishuMessage({
-            cfg,
-            event: syntheticEvent,
-            botOpenId: myBotId,
-            botName: botNames.get(accountId),
-            runtime,
-            chatHistories,
-            accountId,
-          });
-          await promise;
-        },
-      });
-    },
-    "application.bot.menu_v6": createFeishuBotMenuHandler({
-      cfg,
-      accountId,
-      runtime,
-      chatHistories,
-      fireAndForget,
-    }),
-    "card.action.trigger": async (data: unknown) => {
-      try {
-        const event = parseFeishuCardActionEventPayload(data);
-        if (!event) {
-          error(`feishu[${accountId}]: ignoring malformed card action payload`);
-          return;
-        }
-        const promise = handleFeishuCardAction({
-          cfg,
-          event,
-          botOpenId: botOpenIds.get(accountId),
-          runtime,
-          accountId,
-        });
-        if (fireAndForget) {
-          promise.catch((err) => {
-            error(`feishu[${accountId}]: error handling card action: ${String(err)}`);
-          });
-        } else {
-          await promise;
-        }
-      } catch (err) {
-        error(`feishu[${accountId}]: error handling card action: ${String(err)}`);
-      }
-    },
-  });
-}
-
-export type BotOpenIdSource =
-  | { kind: "prefetched"; botOpenId?: string; botName?: string }
-  | { kind: "fetch" };
-
-export type MonitorSingleAccountParams = {
-  cfg: ClawdbotConfig;
-  account: ResolvedFeishuAccount;
-  runtime?: RuntimeEnv;
-  abortSignal?: AbortSignal;
-  botOpenIdSource?: BotOpenIdSource;
-  fireAndForget?: boolean;
-};
-
-export async function monitorSingleAccount(params: MonitorSingleAccountParams): Promise<void> {
-  const { cfg, account, runtime, abortSignal } = params;
-  const { accountId } = account;
-  const log = runtime?.log ?? console.log;
-
-  const botOpenIdSource = params.botOpenIdSource ?? { kind: "fetch" };
-  const botIdentity =
-    botOpenIdSource.kind === "prefetched"
-      ? { botOpenId: botOpenIdSource.botOpenId, botName: botOpenIdSource.botName }
-      : await fetchBotIdentityForMonitor(account, { runtime, abortSignal });
-  const { botOpenId } = applyBotIdentityState(accountId, botIdentity);
-  log(`feishu[${accountId}]: bot open_id resolved: ${botOpenId ?? "unknown"}`);
-
-  if (!botOpenId && !abortSignal?.aborted) {
-    startBotIdentityRecovery({ account, accountId, runtime, abortSignal });
-  }
-
-  const connectionMode = account.config.connectionMode ?? "websocket";
-  if (connectionMode === "webhook" && !account.verificationToken?.trim()) {
-    throw new Error(`Feishu account "${accountId}" webhook mode requires verificationToken`);
-  }
-  if (connectionMode === "webhook" && !account.encryptKey?.trim()) {
-    throw new Error(`Feishu account "${accountId}" webhook mode requires encryptKey`);
-  }
-
-  const warmupCount = await warmupDedupFromDisk(accountId, log);
-  if (warmupCount > 0) {
-    log(`feishu[${accountId}]: dedup warmup loaded ${warmupCount} entries from disk`);
-  }
-
-  let threadBindingManager: ReturnType<typeof createFeishuThreadBindingManager> | null = null;
-  try {
-    const eventDispatcher = createEventDispatcher(account);
-    const chatHistories = new Map<string, HistoryEntry[]>();
-    threadBindingManager = createFeishuThreadBindingManager({ accountId, cfg });
-
-    registerEventHandlers(eventDispatcher, {
-      cfg,
-      accountId,
-      runtime,
-      chatHistories,
-      fireAndForget: params.fireAndForget ?? true,
-    });
-
-    if (connectionMode === "webhook") {
-      return await monitorWebhook({ account, accountId, runtime, abortSignal, eventDispatcher });
-    }
-    return await monitorWebSocket({ account, accountId, runtime, abortSignal, eventDispatcher });
-  } finally {
-    threadBindingManager?.stop();
-  }
-}