@kodelyth/feishu 2026.5.42 → 2026.6.1

package/src/policy.ts

@@ -1,318 +0,0 @@
-import { normalizeAccountId, resolveMergedAccountConfig } from "klaw/plugin-sdk/account-resolution";
-import {
-  createChannelIngressResolver,
-  defineStableChannelIngressIdentity,
-  type ChannelIngressIdentitySubjectInput,
-  type ResolveChannelMessageIngressParams,
-} from "klaw/plugin-sdk/channel-ingress-runtime";
-import type { KlawConfig } from "klaw/plugin-sdk/core";
-import { normalizeOptionalLowercaseString } from "klaw/plugin-sdk/string-coerce-runtime";
-import type { ChannelGroupContext } from "../runtime-api.js";
-import { detectIdType } from "./targets.js";
-import type { FeishuConfig } from "./types.js";
-
-type FeishuDmPolicy = "open" | "pairing" | "allowlist" | "disabled";
-type FeishuGroupPolicy = "open" | "allowlist" | "disabled" | "allowall";
-type NormalizedFeishuGroupPolicy = Exclude<FeishuGroupPolicy, "allowall">;
-
-const FEISHU_PROVIDER_PREFIX_RE = /^(feishu|lark):/i;
-const FEISHU_TYPED_PREFIX_RE = /^(chat|group|channel|user|dm|open_id):/i;
-const FEISHU_ID_KIND = "plugin:feishu-id" as const;
-const feishuIngressIdentity = defineStableChannelIngressIdentity({
-  key: "feishu-id",
-  kind: FEISHU_ID_KIND,
-  normalize: normalizeFeishuAllowEntry,
-  sensitivity: "pii",
-  aliases: [
-    {
-      key: "feishu-alt-id",
-      kind: FEISHU_ID_KIND,
-      normalizeEntry: () => null,
-      normalizeSubject: normalizeFeishuAllowEntry,
-      sensitivity: "pii",
-    },
-  ],
-  isWildcardEntry: (entry) => normalizeFeishuAllowEntry(entry) === "*",
-  resolveEntryId: ({ entryIndex }) => `feishu-entry-${entryIndex + 1}`,
-});
-
-export function normalizeFeishuAllowEntry(raw: string): string {
-  const trimmed = raw.trim();
-  if (!trimmed) {
-    return "";
-  }
-  if (trimmed === "*") {
-    return "*";
-  }
-
-  let withoutProviderPrefix = trimmed;
-  while (FEISHU_PROVIDER_PREFIX_RE.test(withoutProviderPrefix)) {
-    withoutProviderPrefix = withoutProviderPrefix.replace(FEISHU_PROVIDER_PREFIX_RE, "").trim();
-  }
-  if (withoutProviderPrefix === "*") {
-    return "*";
-  }
-  const lowered = normalizeOptionalLowercaseString(withoutProviderPrefix) ?? "";
-  if (!lowered) {
-    return "";
-  }
-  const prefixed = lowered.match(FEISHU_TYPED_PREFIX_RE);
-  if (prefixed?.[1]) {
-    const kind = ["chat", "group", "channel"].includes(prefixed[1]) ? "chat" : "user";
-    const value = withoutProviderPrefix.slice(prefixed[0].length).trim();
-    return value === "*" ? "*" : value ? `${kind}:${value}` : "";
-  }
-
-  const detectedType = detectIdType(withoutProviderPrefix);
-  if (detectedType === "chat_id") {
-    return `chat:${withoutProviderPrefix}`;
-  }
-  if (detectedType === "open_id" || detectedType === "user_id") {
-    return `user:${withoutProviderPrefix}`;
-  }
-
-  return "";
-}
-
-function normalizeFeishuDmPolicy(policy: string | null | undefined): FeishuDmPolicy {
-  return policy === "open" ||
-    policy === "pairing" ||
-    policy === "allowlist" ||
-    policy === "disabled"
-    ? policy
-    : "pairing";
-}
-
-function normalizeFeishuGroupPolicy(policy: FeishuGroupPolicy): NormalizedFeishuGroupPolicy {
-  return policy === "allowall" ? "open" : policy;
-}
-
-function createFeishuIngressSubject(params: {
-  primaryId?: string | null;
-  alternateIds?: Array<string | null | undefined>;
-}): ChannelIngressIdentitySubjectInput {
-  const ids = [params.primaryId, ...(params.alternateIds ?? [])]
-    .map((value) => value?.trim())
-    .filter((value): value is string => Boolean(value));
-  return {
-    stableId: ids[0],
-    aliases: {
-      "feishu-alt-id": ids[1],
-    },
-  };
-}
-
-function createFeishuIngressResolver(params: {
-  cfg?: KlawConfig;
-  accountId?: string | null;
-  readAllowFromStore?: ResolveChannelMessageIngressParams["readStoreAllowFrom"];
-}) {
-  return createChannelIngressResolver({
-    channelId: "feishu",
-    accountId: normalizeAccountId(params.accountId) ?? "default",
-    identity: feishuIngressIdentity,
-    cfg: params.cfg,
-    ...(params.readAllowFromStore ? { readStoreAllowFrom: params.readAllowFromStore } : {}),
-  });
-}
-
-export async function resolveFeishuDmIngressAccess(params: {
-  cfg: KlawConfig;
-  accountId?: string | null;
-  dmPolicy?: string | null;
-  allowFrom?: Array<string | number> | null;
-  readAllowFromStore?: () => Promise<Array<string | number>>;
-  senderOpenId: string;
-  senderUserId?: string | null;
-  conversationId: string;
-  mayPair: boolean;
-  command?: { hasControlCommand: boolean };
-}) {
-  return await createFeishuIngressResolver({
-    cfg: params.cfg,
-    accountId: params.accountId,
-    readAllowFromStore: params.readAllowFromStore,
-  }).message({
-    subject: createFeishuIngressSubject({
-      primaryId: params.senderOpenId,
-      alternateIds: [params.senderUserId],
-    }),
-    conversation: {
-      kind: "direct",
-      id: params.conversationId,
-    },
-    event: {
-      mayPair: params.mayPair,
-    },
-    dmPolicy: normalizeFeishuDmPolicy(params.dmPolicy),
-    groupPolicy: "disabled",
-    allowFrom: params.allowFrom ?? [],
-    ...(params.command ? { command: params.command } : {}),
-  });
-}
-
-export async function resolveFeishuGroupConversationIngressAccess(params: {
-  cfg: KlawConfig;
-  accountId?: string | null;
-  chatId: string;
-  groupPolicy: FeishuGroupPolicy;
-  groupAllowFrom?: Array<string | number> | null;
-  groupExplicitlyConfigured?: boolean;
-}) {
-  const groupPolicy = normalizeFeishuGroupPolicy(params.groupPolicy);
-  const groupAllowFrom =
-    groupPolicy === "allowlist" && params.groupExplicitlyConfigured
-      ? [...(params.groupAllowFrom ?? []), params.chatId]
-      : (params.groupAllowFrom ?? []);
-  return await createFeishuIngressResolver({
-    cfg: params.cfg,
-    accountId: params.accountId,
-  }).message({
-    subject: createFeishuIngressSubject({
-      primaryId: params.chatId,
-    }),
-    conversation: {
-      kind: "group",
-      id: params.chatId,
-    },
-    dmPolicy: "disabled",
-    groupPolicy,
-    groupAllowFrom,
-  });
-}
-
-export async function resolveFeishuGroupSenderActivationIngressAccess(params: {
-  cfg: KlawConfig;
-  accountId?: string | null;
-  chatId: string;
-  allowFrom?: Array<string | number> | null;
-  senderOpenId: string;
-  senderUserId?: string | null;
-  requireMention: boolean;
-  mentionedBot: boolean;
-  command?: { hasControlCommand: boolean };
-}) {
-  const groupAllowFrom = params.allowFrom ?? [];
-  return await createFeishuIngressResolver({
-    cfg: params.cfg,
-    accountId: params.accountId,
-  }).message({
-    subject: createFeishuIngressSubject({
-      primaryId: params.senderOpenId,
-      alternateIds: [params.senderUserId],
-    }),
-    conversation: {
-      kind: "group",
-      id: params.chatId,
-    },
-    dmPolicy: "disabled",
-    groupPolicy: groupAllowFrom.length > 0 ? "allowlist" : "open",
-    groupAllowFrom,
-    mentionFacts: {
-      canDetectMention: true,
-      wasMentioned: params.mentionedBot,
-    },
-    policy: {
-      activation: {
-        requireMention: params.requireMention,
-        allowTextCommands: false,
-      },
-    },
-    ...(params.command ? { command: params.command } : {}),
-  });
-}
-
-export function resolveFeishuGroupConfig(params: { cfg?: FeishuConfig; groupId?: string | null }) {
-  const groups = params.cfg?.groups ?? {};
-  const wildcard = groups["*"];
-  const groupId = params.groupId?.trim();
-  if (!groupId) {
-    return undefined;
-  }
-
-  const direct = groups[groupId];
-  if (direct) {
-    return direct;
-  }
-
-  const lowered = normalizeOptionalLowercaseString(groupId) ?? "";
-  const matchKey = Object.keys(groups).find(
-    (key) => normalizeOptionalLowercaseString(key) === lowered,
-  );
-  if (matchKey) {
-    return groups[matchKey];
-  }
-  return wildcard;
-}
-
-export function hasExplicitFeishuGroupConfig(params: {
-  cfg?: FeishuConfig;
-  groupId?: string | null;
-}): boolean {
-  const groups = params.cfg?.groups ?? {};
-  const groupId = params.groupId?.trim();
-  if (!groupId) {
-    return false;
-  }
-  if (Object.prototype.hasOwnProperty.call(groups, groupId) && groupId !== "*") {
-    return true;
-  }
-
-  const lowered = normalizeOptionalLowercaseString(groupId) ?? "";
-  return Object.keys(groups).some(
-    (key) => key !== "*" && normalizeOptionalLowercaseString(key) === lowered,
-  );
-}
-
-export function resolveFeishuGroupToolPolicy(params: ChannelGroupContext) {
-  const cfg = params.cfg.channels?.feishu;
-  if (!cfg) {
-    return undefined;
-  }
-
-  const groupConfig = resolveFeishuGroupConfig({
-    cfg,
-    groupId: params.groupId,
-  });
-
-  return groupConfig?.tools;
-}
-
-export function resolveFeishuReplyPolicy(params: {
-  isDirectMessage: boolean;
-  cfg: KlawConfig;
-  accountId?: string | null;
-  groupId?: string | null;
-  /**
-   * Effective group policy resolved for this chat. When "open", requireMention
-   * defaults to false so that non-text messages (e.g. images) that cannot carry
-   * @-mentions are still delivered to the agent.
-   */
-  groupPolicy?: "open" | "allowlist" | "disabled" | "allowall";
-}): { requireMention: boolean } {
-  if (params.isDirectMessage) {
-    return { requireMention: false };
-  }
-
-  const feishuCfg = params.cfg.channels?.feishu;
-  const resolvedCfg = resolveMergedAccountConfig<FeishuConfig>({
-    channelConfig: feishuCfg,
-    accounts: feishuCfg?.accounts as Record<string, Partial<FeishuConfig>> | undefined,
-    accountId: normalizeAccountId(params.accountId),
-    normalizeAccountId,
-    omitKeys: ["defaultAccount"],
-  });
-  const groupRequireMention = resolveFeishuGroupConfig({
-    cfg: resolvedCfg,
-    groupId: params.groupId,
-  })?.requireMention;
-
-  return {
-    requireMention:
-      typeof groupRequireMention === "boolean"
-        ? groupRequireMention
-        : typeof resolvedCfg.requireMention === "boolean"
-          ? resolvedCfg.requireMention
-          : params.groupPolicy !== "open",
-  };
-}

package/src/post.test.ts

@@ -1,105 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { parsePostContent } from "./post.js";
-
-describe("parsePostContent", () => {
-  it("renders title and styled text as markdown", () => {
-    const content = JSON.stringify({
-      title: "Daily *Plan*",
-      content: [
-        [
-          { tag: "text", text: "Bold", style: { bold: true } },
-          { tag: "text", text: " " },
-          { tag: "text", text: "Italic", style: { italic: true } },
-          { tag: "text", text: " " },
-          { tag: "text", text: "Underline", style: { underline: true } },
-          { tag: "text", text: " " },
-          { tag: "text", text: "Strike", style: { strikethrough: true } },
-          { tag: "text", text: " " },
-          { tag: "text", text: "Code", style: { code: true, bold: true } },
-        ],
-      ],
-    });
-
-    const result = parsePostContent(content);
-
-    expect(result.textContent).toBe(
-      "Daily \\*Plan\\*\n\n**Bold** *Italic* <u>Underline</u> ~~Strike~~ `Code`",
-    );
-    expect(result.imageKeys).toStrictEqual([]);
-    expect(result.mentionedOpenIds).toStrictEqual([]);
-  });
-
-  it("renders links and mentions", () => {
-    const content = JSON.stringify({
-      title: "",
-      content: [
-        [
-          { tag: "a", text: "Docs [v2]", href: "https://example.com/guide(a)" },
-          { tag: "text", text: " " },
-          { tag: "at", user_name: "alice_bob" },
-          { tag: "text", text: " " },
-          { tag: "at", open_id: "ou_123" },
-          { tag: "text", text: " " },
-          { tag: "a", href: "https://example.com/no-text" },
-        ],
-      ],
-    });
-
-    const result = parsePostContent(content);
-
-    expect(result.textContent).toBe(
-      "[Docs \\[v2\\]](https://example.com/guide(a)) @alice\\_bob @ou\\_123 [https://example.com/no\\-text](https://example.com/no-text)",
-    );
-    expect(result.mentionedOpenIds).toEqual(["ou_123"]);
-  });
-
-  it("inserts image placeholders and collects image keys", () => {
-    const content = JSON.stringify({
-      title: "",
-      content: [
-        [
-          { tag: "text", text: "Before " },
-          { tag: "img", image_key: "img_1" },
-          { tag: "text", text: " after" },
-        ],
-        [{ tag: "img", image_key: "img_2" }],
-      ],
-    });
-
-    const result = parsePostContent(content);
-
-    expect(result.textContent).toBe("Before ![image] after\n![image]");
-    expect(result.imageKeys).toEqual(["img_1", "img_2"]);
-    expect(result.mentionedOpenIds).toStrictEqual([]);
-  });
-
-  it("supports locale wrappers", () => {
-    const wrappedByPost = JSON.stringify({
-      post: {
-        zh_cn: {
-          title: "标题",
-          content: [[{ tag: "text", text: "内容A" }]],
-        },
-      },
-    });
-    const wrappedByLocale = JSON.stringify({
-      zh_cn: {
-        title: "标题",
-        content: [[{ tag: "text", text: "内容B" }]],
-      },
-    });
-
-    expect(parsePostContent(wrappedByPost)).toEqual({
-      textContent: "标题\n\n内容A",
-      imageKeys: [],
-      mediaKeys: [],
-      mentionedOpenIds: [],
-    });
-    expect(parsePostContent(wrappedByLocale)).toEqual({
-      textContent: "标题\n\n内容B",
-      imageKeys: [],
-      mediaKeys: [],
-      mentionedOpenIds: [],
-    });
-  });
-});

package/src/post.ts

@@ -1,275 +0,0 @@
-import { normalizeLowercaseStringOrEmpty } from "klaw/plugin-sdk/string-coerce-runtime";
-import { isRecord } from "./comment-shared.js";
-import { normalizeFeishuExternalKey } from "./external-keys.js";
-
-const FALLBACK_POST_TEXT = "[Rich text message]";
-const MARKDOWN_SPECIAL_CHARS = /([\\`*_{}[\]()#+\-!|>~])/g;
-
-type PostParseResult = {
-  textContent: string;
-  imageKeys: string[];
-  mediaKeys: Array<{ fileKey: string; fileName?: string }>;
-  mentionedOpenIds: string[];
-};
-
-type PostPayload = {
-  title: string;
-  content: unknown[];
-};
-
-function toStringOrEmpty(value: unknown): string {
-  return typeof value === "string" ? value : "";
-}
-
-function escapeMarkdownText(text: string): string {
-  return text.replace(MARKDOWN_SPECIAL_CHARS, "\\$1");
-}
-
-function toBoolean(value: unknown): boolean {
-  return value === true || value === 1 || value === "true";
-}
-
-function isStyleEnabled(style: Record<string, unknown> | undefined, key: string): boolean {
-  if (!style) {
-    return false;
-  }
-  return toBoolean(style[key]);
-}
-
-function wrapInlineCode(text: string): string {
-  const maxRun = Math.max(0, ...(text.match(/`+/g) ?? []).map((run) => run.length));
-  const fence = "`".repeat(maxRun + 1);
-  const needsPadding = text.startsWith("`") || text.endsWith("`");
-  const body = needsPadding ? ` ${text} ` : text;
-  return `${fence}${body}${fence}`;
-}
-
-function sanitizeFenceLanguage(language: string): string {
-  return language.trim().replace(/[^A-Za-z0-9_+#.-]/g, "");
-}
-
-function renderTextElement(element: Record<string, unknown>): string {
-  const text = toStringOrEmpty(element.text);
-  const style = isRecord(element.style) ? element.style : undefined;
-
-  if (isStyleEnabled(style, "code")) {
-    return wrapInlineCode(text);
-  }
-
-  let rendered = escapeMarkdownText(text);
-  if (!rendered) {
-    return "";
-  }
-
-  if (isStyleEnabled(style, "bold")) {
-    rendered = `**${rendered}**`;
-  }
-  if (isStyleEnabled(style, "italic")) {
-    rendered = `*${rendered}*`;
-  }
-  if (isStyleEnabled(style, "underline")) {
-    rendered = `<u>${rendered}</u>`;
-  }
-  if (
-    isStyleEnabled(style, "strikethrough") ||
-    isStyleEnabled(style, "line_through") ||
-    isStyleEnabled(style, "lineThrough")
-  ) {
-    rendered = `~~${rendered}~~`;
-  }
-  return rendered;
-}
-
-function renderLinkElement(element: Record<string, unknown>): string {
-  const href = toStringOrEmpty(element.href).trim();
-  const rawText = toStringOrEmpty(element.text);
-  const text = rawText || href;
-  if (!text) {
-    return "";
-  }
-  if (!href) {
-    return escapeMarkdownText(text);
-  }
-  return `[${escapeMarkdownText(text)}](${href})`;
-}
-
-function renderMentionElement(element: Record<string, unknown>): string {
-  const mention =
-    toStringOrEmpty(element.user_name) ||
-    toStringOrEmpty(element.user_id) ||
-    toStringOrEmpty(element.open_id);
-  if (!mention) {
-    return "";
-  }
-  return `@${escapeMarkdownText(mention)}`;
-}
-
-function renderEmotionElement(element: Record<string, unknown>): string {
-  const text =
-    toStringOrEmpty(element.emoji) ||
-    toStringOrEmpty(element.text) ||
-    toStringOrEmpty(element.emoji_type);
-  return escapeMarkdownText(text);
-}
-
-function renderCodeBlockElement(element: Record<string, unknown>): string {
-  const language = sanitizeFenceLanguage(
-    toStringOrEmpty(element.language) || toStringOrEmpty(element.lang),
-  );
-  const code = (toStringOrEmpty(element.text) || toStringOrEmpty(element.content)).replace(
-    /\r\n/g,
-    "\n",
-  );
-  const trailingNewline = code.endsWith("\n") ? "" : "\n";
-  return `\`\`\`${language}\n${code}${trailingNewline}\`\`\``;
-}
-
-function renderElement(
-  element: unknown,
-  imageKeys: string[],
-  mediaKeys: Array<{ fileKey: string; fileName?: string }>,
-  mentionedOpenIds: string[],
-): string {
-  if (!isRecord(element)) {
-    return escapeMarkdownText(toStringOrEmpty(element));
-  }
-
-  const tag = normalizeLowercaseStringOrEmpty(toStringOrEmpty(element.tag));
-  switch (tag) {
-    case "text":
-      return renderTextElement(element);
-    case "a":
-      return renderLinkElement(element);
-    case "at":
-      {
-        const mentioned = toStringOrEmpty(element.open_id) || toStringOrEmpty(element.user_id);
-        const normalizedMention = normalizeFeishuExternalKey(mentioned);
-        if (normalizedMention) {
-          mentionedOpenIds.push(normalizedMention);
-        }
-      }
-      return renderMentionElement(element);
-    case "img": {
-      const imageKey = normalizeFeishuExternalKey(toStringOrEmpty(element.image_key));
-      if (imageKey) {
-        imageKeys.push(imageKey);
-      }
-      return "![image]";
-    }
-    case "media": {
-      const fileKey = normalizeFeishuExternalKey(toStringOrEmpty(element.file_key));
-      if (fileKey) {
-        const fileName = toStringOrEmpty(element.file_name) || undefined;
-        mediaKeys.push({ fileKey, fileName });
-      }
-      return "[media]";
-    }
-    case "emotion":
-      return renderEmotionElement(element);
-    case "md":
-    case "lark_md":
-      return toStringOrEmpty(element.text) || toStringOrEmpty(element.content);
-    case "br":
-      return "\n";
-    case "hr":
-      return "\n\n---\n\n";
-    case "code": {
-      const code = toStringOrEmpty(element.text) || toStringOrEmpty(element.content);
-      return code ? wrapInlineCode(code) : "";
-    }
-    case "code_block":
-    case "pre":
-      return renderCodeBlockElement(element);
-    default:
-      return escapeMarkdownText(toStringOrEmpty(element.text));
-  }
-}
-
-function toPostPayload(candidate: unknown): PostPayload | null {
-  if (!isRecord(candidate) || !Array.isArray(candidate.content)) {
-    return null;
-  }
-  return {
-    title: toStringOrEmpty(candidate.title),
-    content: candidate.content,
-  };
-}
-
-function resolveLocalePayload(candidate: unknown): PostPayload | null {
-  const direct = toPostPayload(candidate);
-  if (direct) {
-    return direct;
-  }
-  if (!isRecord(candidate)) {
-    return null;
-  }
-  for (const value of Object.values(candidate)) {
-    const localePayload = toPostPayload(value);
-    if (localePayload) {
-      return localePayload;
-    }
-  }
-  return null;
-}
-
-function resolvePostPayload(parsed: unknown): PostPayload | null {
-  const direct = toPostPayload(parsed);
-  if (direct) {
-    return direct;
-  }
-
-  if (!isRecord(parsed)) {
-    return null;
-  }
-
-  const wrappedPost = resolveLocalePayload(parsed.post);
-  if (wrappedPost) {
-    return wrappedPost;
-  }
-
-  return resolveLocalePayload(parsed);
-}
-
-export function parsePostContent(content: string): PostParseResult {
-  try {
-    const parsed = JSON.parse(content);
-    const payload = resolvePostPayload(parsed);
-    if (!payload) {
-      return {
-        textContent: FALLBACK_POST_TEXT,
-        imageKeys: [],
-        mediaKeys: [],
-        mentionedOpenIds: [],
-      };
-    }
-
-    const imageKeys: string[] = [];
-    const mediaKeys: Array<{ fileKey: string; fileName?: string }> = [];
-    const mentionedOpenIds: string[] = [];
-    const paragraphs: string[] = [];
-
-    for (const paragraph of payload.content) {
-      if (!Array.isArray(paragraph)) {
-        continue;
-      }
-      let renderedParagraph = "";
-      for (const element of paragraph) {
-        renderedParagraph += renderElement(element, imageKeys, mediaKeys, mentionedOpenIds);
-      }
-      paragraphs.push(renderedParagraph);
-    }
-
-    const title = escapeMarkdownText(payload.title.trim());
-    const body = paragraphs.join("\n").trim();
-    const textContent = [title, body].filter(Boolean).join("\n\n").trim();
-
-    return {
-      textContent: textContent || FALLBACK_POST_TEXT,
-      imageKeys,
-      mediaKeys,
-      mentionedOpenIds,
-    };
-  } catch {
-    return { textContent: FALLBACK_POST_TEXT, imageKeys: [], mediaKeys: [], mentionedOpenIds: [] };
-  }
-}