@larksuite/openclaw-lark 2026.3.9

package/src/messaging/inbound/media-resolver.js

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Media resolution and payload building for inbound Feishu messages.
+ *
+ * Downloads media files based on ResourceDescriptors extracted during
+ * the content converter phase, and builds the payload object spread
+ * into the agent envelope.
+ */
+import { LarkClient } from '../../core/lark-client';
+import { downloadMessageResourceFeishu } from '../outbound/media';
+// ---------------------------------------------------------------------------
+// Resource-descriptor-based download
+// ---------------------------------------------------------------------------
+/**
+ * Download media files based on pre-extracted ResourceDescriptors from
+ * the converter phase.
+ */
+export async function downloadResources(params) {
+    const { cfg, messageId, resources, maxBytes, log, accountId } = params;
+    if (resources.length === 0)
+        return [];
+    const out = [];
+    const core = LarkClient.runtime;
+    for (const res of resources) {
+        try {
+            const resourceType = res.type === 'image' ? 'image' : 'file';
+            const result = await downloadMessageResourceFeishu({
+                cfg,
+                messageId,
+                fileKey: res.fileKey,
+                type: resourceType,
+                accountId,
+            });
+            let contentType = result.contentType;
+            if (!contentType) {
+                contentType = await core.media.detectMime({ buffer: result.buffer });
+            }
+            const fileName = result.fileName || res.fileName;
+            const saved = await core.channel.media.saveMediaBuffer(result.buffer, contentType, 'inbound', maxBytes, fileName);
+            const placeholder = inferPlaceholderFromType(res.type);
+            out.push({
+                path: saved.path,
+                contentType: saved.contentType,
+                placeholder,
+                fileKey: res.fileKey,
+                resourceType: res.type,
+            });
+            log?.(`feishu: downloaded ${res.type} resource ${res.fileKey}, saved to ${saved.path}`);
+        }
+        catch (err) {
+            log?.(`feishu: failed to download ${res.type} resource ${res.fileKey}: ${String(err)}`);
+        }
+    }
+    return out;
+}
+function inferPlaceholderFromType(type) {
+    switch (type) {
+        case 'image':
+            return '<media:image>';
+        case 'file':
+            return '<media:document>';
+        case 'audio':
+            return '<media:audio>';
+        case 'video':
+            return '<media:video>';
+        case 'sticker':
+            return '<media:sticker>';
+    }
+}
+// ---------------------------------------------------------------------------
+// Media payload builder
+// ---------------------------------------------------------------------------
+export function buildFeishuMediaPayload(mediaList) {
+    const first = mediaList[0];
+    const mediaPaths = mediaList.map((m) => m.path);
+    const mediaTypes = mediaList.map((m) => m.contentType).filter(Boolean);
+    return {
+        MediaPath: first?.path,
+        MediaType: first?.contentType,
+        MediaUrl: first?.path,
+        MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
+        MediaUrls: mediaPaths.length > 0 ? mediaPaths : undefined,
+        MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
+    };
+}
+//# sourceMappingURL=media-resolver.js.map

package/src/messaging/inbound/media-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-resolver.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/media-resolver.ts"],"names":[],"mappings":"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"}

package/src/messaging/inbound/mention.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * @mention utilities for the Feishu/Lark channel plugin.
+ *
+ * All logic is based on `MentionInfo[]` from `MessageContext.mentions`.
+ * Provides:
+ * - Derive helpers: `mentionedBot()`, `nonBotMentions()`
+ * - Format helpers for outbound text and card messages.
+ */
+import type { MentionInfo, MessageContext } from '../types';
+export type { MentionInfo } from '../types';
+/** Whether the bot was @-mentioned. */
+export declare function mentionedBot(ctx: MessageContext): boolean;
+/** All non-bot mentions. */
+export declare function nonBotMentions(ctx: MessageContext): MentionInfo[];
+/**
+ * Remove all @mention placeholder keys from the message text.
+ */
+export declare function extractMessageBody(text: string, allMentionKeys: string[]): string;
+/**
+ * Format a mention for a Feishu text / post message.
+ * @returns e.g. `<at user_id="ou_xxx">Alice</at>`
+ */
+export declare function formatMentionForText(target: MentionInfo): string;
+/** Format an @everyone mention for text / post. */
+export declare function formatMentionAllForText(): string;
+/**
+ * Format a mention for a Feishu Interactive Card.
+ * @returns e.g. `<at id=ou_xxx></at>`
+ */
+export declare function formatMentionForCard(target: MentionInfo): string;
+/** Format an @everyone mention for card. */
+export declare function formatMentionAllForCard(): string;
+/** Prepend @mention tags (text format) to a message body. */
+export declare function buildMentionedMessage(targets: MentionInfo[], message: string): string;
+/** Prepend @mention tags (card format) to card markdown content. */
+export declare function buildMentionedCardContent(targets: MentionInfo[], message: string): string;
+//# sourceMappingURL=mention.d.ts.map

package/src/messaging/inbound/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/mention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG5D,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAEzD;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,WAAW,EAAE,CAEjE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAMjF;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED,4CAA4C;AAC5C,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAMD,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzF"}

package/src/messaging/inbound/mention.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * @mention utilities for the Feishu/Lark channel plugin.
+ *
+ * All logic is based on `MentionInfo[]` from `MessageContext.mentions`.
+ * Provides:
+ * - Derive helpers: `mentionedBot()`, `nonBotMentions()`
+ * - Format helpers for outbound text and card messages.
+ */
+import { escapeRegExp } from '../converters/utils';
+// ---------------------------------------------------------------------------
+// Derive helpers (work on MentionInfo[])
+// ---------------------------------------------------------------------------
+/** Whether the bot was @-mentioned. */
+export function mentionedBot(ctx) {
+    return ctx.mentions.some((m) => m.isBot);
+}
+/** All non-bot mentions. */
+export function nonBotMentions(ctx) {
+    return ctx.mentions.filter((m) => !m.isBot);
+}
+// ---------------------------------------------------------------------------
+// extractMessageBody
+// ---------------------------------------------------------------------------
+/**
+ * Remove all @mention placeholder keys from the message text.
+ */
+export function extractMessageBody(text, allMentionKeys) {
+    let result = text;
+    for (const key of allMentionKeys) {
+        result = result.replace(new RegExp(escapeRegExp(key) + '\\s*', 'g'), '');
+    }
+    return result.trim();
+}
+// ---------------------------------------------------------------------------
+// Format helpers -- text messages
+// ---------------------------------------------------------------------------
+/**
+ * Format a mention for a Feishu text / post message.
+ * @returns e.g. `<at user_id="ou_xxx">Alice</at>`
+ */
+export function formatMentionForText(target) {
+    return `<at user_id="${target.openId}">${target.name}</at>`;
+}
+/** Format an @everyone mention for text / post. */
+export function formatMentionAllForText() {
+    return `<at user_id="all">Everyone</at>`;
+}
+// ---------------------------------------------------------------------------
+// Format helpers -- interactive card messages
+// ---------------------------------------------------------------------------
+/**
+ * Format a mention for a Feishu Interactive Card.
+ * @returns e.g. `<at id=ou_xxx></at>`
+ */
+export function formatMentionForCard(target) {
+    return `<at id=${target.openId}></at>`;
+}
+/** Format an @everyone mention for card. */
+export function formatMentionAllForCard() {
+    return `<at id=all></at>`;
+}
+// ---------------------------------------------------------------------------
+// Build helpers (prepend mentions to message body)
+// ---------------------------------------------------------------------------
+/** Prepend @mention tags (text format) to a message body. */
+export function buildMentionedMessage(targets, message) {
+    if (targets.length === 0)
+        return message;
+    const mentionTags = targets.map(formatMentionForText).join(' ');
+    return `${mentionTags}\n${message}`;
+}
+/** Prepend @mention tags (card format) to card markdown content. */
+export function buildMentionedCardContent(targets, message) {
+    if (targets.length === 0)
+        return message;
+    const mentionTags = targets.map(formatMentionForCard).join(' ');
+    return `${mentionTags}\n${message}`;
+}
+//# sourceMappingURL=mention.js.map

package/src/messaging/inbound/mention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/mention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC9C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,cAAc,CAAC,GAAmB;IAChD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,cAAwB;IACvE,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,gBAAgB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC;AAC9D,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,uBAAuB;IACrC,OAAO,iCAAiC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,UAAU,MAAM,CAAC,MAAM,QAAQ,CAAC;AACzC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,uBAAuB;IACrC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,UAAU,qBAAqB,CAAC,OAAsB,EAAE,OAAe;IAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,GAAG,WAAW,KAAK,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CAAC,OAAsB,EAAE,OAAe;IAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,GAAG,WAAW,KAAK,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/src/messaging/inbound/parse-io.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * I/O adapters for inbound message parsing.
+ *
+ * Contains API-calling functions that are used during the parse phase
+ * but separated from the pure parsing logic in parse.ts.
+ */
+import type { LarkClient as LarkClientType } from '../../core/lark-client';
+import type { LarkAccount } from '../../core/types';
+/** Shape of a single message item returned by the im/v1/messages API. */
+export interface ApiMessageItem {
+    message_id?: string;
+    msg_type?: string;
+    body?: {
+        content?: string;
+    };
+    sender?: {
+        id?: string;
+        sender_type?: string;
+    };
+    [key: string]: unknown;
+}
+/**
+ * 对 interactive 消息，通过 TAT 调用 API 获取完整 v2 卡片内容。
+ * 事件推送的 content 可能不包含 json_card，API 调用可返回完整的 raw_card_content。
+ * 失败时返回 undefined，调用方 fallback 到原始 content。
+ *
+ * Note: `larkClient.sdk` 的类型定义不暴露 raw `request` 方法，
+ * 因此这里使用 `as any` 断言调用。
+ */
+export declare function fetchCardContent(messageId: string, larkClient: LarkClientType): Promise<string | undefined>;
+/**
+ * Create a `fetchSubMessages` callback for use in `ConvertContext`.
+ *
+ * The returned function calls the im/v1/messages API to fetch
+ * sub-messages of a merge_forward message.
+ *
+ * Note: `larkClient.sdk` 的类型定义不暴露 raw `request` 方法，
+ * 因此这里使用 `as any` 断言调用。
+ */
+export declare function createFetchSubMessages(larkClient: LarkClientType): (msgId: string) => Promise<ApiMessageItem[]>;
+/**
+ * Create a `batchResolveNames` callback for use in `ConvertContext`.
+ *
+ * Wraps `createBatchResolveNames` from user-name-cache.ts, providing
+ * the account and log function.
+ */
+export declare function createParseResolveNames(account: LarkAccount): (openIds: string[]) => Promise<void>;
+//# sourceMappingURL=parse-io.d.ts.map

package/src/messaging/inbound/parse-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-io.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/parse-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAUpD,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBjH;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAc/G;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAElG"}

package/src/messaging/inbound/parse-io.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * I/O adapters for inbound message parsing.
+ *
+ * Contains API-calling functions that are used during the parse phase
+ * but separated from the pure parsing logic in parse.ts.
+ */
+import { larkLogger } from '../../core/lark-logger';
+import { createBatchResolveNames } from './user-name-cache';
+const log = larkLogger('inbound/parse-io');
+// ---------------------------------------------------------------------------
+// Card content fetcher
+// ---------------------------------------------------------------------------
+/**
+ * 对 interactive 消息，通过 TAT 调用 API 获取完整 v2 卡片内容。
+ * 事件推送的 content 可能不包含 json_card，API 调用可返回完整的 raw_card_content。
+ * 失败时返回 undefined，调用方 fallback 到原始 content。
+ *
+ * Note: `larkClient.sdk` 的类型定义不暴露 raw `request` 方法，
+ * 因此这里使用 `as any` 断言调用。
+ */
+export async function fetchCardContent(messageId, larkClient) {
+    try {
+        // SDK 类型不暴露 raw request 方法，需要 as any
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const response = await larkClient.sdk.request({
+            method: 'GET',
+            url: `/open-apis/im/v1/messages/${messageId}`,
+            params: {
+                user_id_type: 'open_id',
+                card_msg_content_type: 'raw_card_content',
+            },
+        });
+        return response?.data?.items?.[0]?.body?.content ?? undefined;
+    }
+    catch (err) {
+        log.warn(`fetchCardContent failed for ${messageId}: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Sub-message fetcher (for merge_forward)
+// ---------------------------------------------------------------------------
+/**
+ * Create a `fetchSubMessages` callback for use in `ConvertContext`.
+ *
+ * The returned function calls the im/v1/messages API to fetch
+ * sub-messages of a merge_forward message.
+ *
+ * Note: `larkClient.sdk` 的类型定义不暴露 raw `request` 方法，
+ * 因此这里使用 `as any` 断言调用。
+ */
+export function createFetchSubMessages(larkClient) {
+    return async (msgId) => {
+        // SDK 类型不暴露 raw request 方法，需要 as any
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const response = await larkClient.sdk.request({
+            method: 'GET',
+            url: `/open-apis/im/v1/messages/${msgId}`,
+            params: { user_id_type: 'open_id', card_msg_content_type: 'raw_card_content' },
+        });
+        if (response?.code !== 0) {
+            throw new Error(`API error: code=${response?.code} msg=${response?.msg}`);
+        }
+        return response?.data?.items ?? [];
+    };
+}
+// ---------------------------------------------------------------------------
+// Batch resolve names callback factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a `batchResolveNames` callback for use in `ConvertContext`.
+ *
+ * Wraps `createBatchResolveNames` from user-name-cache.ts, providing
+ * the account and log function.
+ */
+export function createParseResolveNames(account) {
+    return createBatchResolveNames(account, (...args) => log.info(args.map(String).join(' ')));
+}
+//# sourceMappingURL=parse-io.js.map

package/src/messaging/inbound/parse-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-io.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/parse-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAe3C,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,UAA0B;IAClF,IAAI,CAAC;QACH,qCAAqC;QACrC,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAO,UAAU,CAAC,GAAW,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,6BAA6B,SAAS,EAAE;YAC7C,MAAM,EAAE;gBACN,YAAY,EAAE,SAAS;gBACvB,qBAAqB,EAAE,kBAAkB;aAC1C;SACF,CAAC,CAAC;QACH,OAAO,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,IAAI,SAAS,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,+BAA+B,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1G,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA0B;IAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,qCAAqC;QACrC,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAO,UAAU,CAAC,GAAW,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,6BAA6B,KAAK,EAAE;YACzC,MAAM,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,kBAAkB,EAAE;SAC/E,CAAC,CAAC;QACH,IAAI,QAAQ,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,IAAI,QAAQ,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAoB;IAC1D,OAAO,uBAAuB,CAAC,OAAO,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC"}

package/src/messaging/inbound/parse.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Event parsing for inbound Feishu messages.
+ *
+ * Converts a raw FeishuMessageEvent into a normalised MessageContext.
+ * All mention information is captured in `mentions: MentionInfo[]`;
+ * downstream logic derives `mentionedBot` and non-bot targets from it.
+ *
+ * When `expandCtx` is provided, `cfg` and `accountId` are passed into
+ * the converter context so that async converters (e.g. merge_forward)
+ * can make API calls during parsing.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+import type { FeishuMessageEvent, MessageContext } from '../types';
+/**
+ * Parse a raw Feishu message event into a normalised MessageContext.
+ *
+ * @param expandCtx  When provided, cfg/accountId are used to create
+ *                   callbacks for async converters (e.g. merge_forward)
+ *                   to fetch sub-messages and resolve sender names.
+ */
+export declare function parseMessageEvent(event: FeishuMessageEvent, botOpenId?: string, expandCtx?: {
+    /** account 级别的 ClawdbotConfig（channels.feishu 已替换为 per-account 合并后的配置） */
+    cfg: ClawdbotConfig;
+    accountId?: string;
+}): Promise<MessageContext>;
+//# sourceMappingURL=parse.d.ts.map

package/src/messaging/inbound/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAe,MAAM,UAAU,CAAC;AAchF;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,kBAAkB,EACzB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE;IACV,0EAA0E;IAC1E,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,cAAc,CAAC,CAoFzB"}

package/src/messaging/inbound/parse.js

@@ -0,0 +1,107 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Event parsing for inbound Feishu messages.
+ *
+ * Converts a raw FeishuMessageEvent into a normalised MessageContext.
+ * All mention information is captured in `mentions: MentionInfo[]`;
+ * downstream logic derives `mentionedBot` and non-bot targets from it.
+ *
+ * When `expandCtx` is provided, `cfg` and `accountId` are passed into
+ * the converter context so that async converters (e.g. merge_forward)
+ * can make API calls during parsing.
+ */
+import { convertMessageContent } from '../converters/content-converter';
+import { getUserNameCache } from './user-name-cache';
+import { getLarkAccount } from '../../core/accounts';
+import { LarkClient } from '../../core/lark-client';
+import { larkLogger } from '../../core/lark-logger';
+import { fetchCardContent, createFetchSubMessages, createParseResolveNames } from './parse-io';
+const log = larkLogger('inbound/parse');
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a raw Feishu message event into a normalised MessageContext.
+ *
+ * @param expandCtx  When provided, cfg/accountId are used to create
+ *                   callbacks for async converters (e.g. merge_forward)
+ *                   to fetch sub-messages and resolve sender names.
+ */
+export async function parseMessageEvent(event, botOpenId, expandCtx) {
+    // 1. Build MentionInfo list from event mentions
+    const mentionMap = new Map();
+    const mentionList = [];
+    for (const m of event.message.mentions ?? []) {
+        const openId = m.id?.open_id ?? '';
+        if (!openId)
+            continue;
+        const info = {
+            key: m.key,
+            openId,
+            name: m.name,
+            isBot: Boolean(botOpenId && openId === botOpenId),
+        };
+        mentionMap.set(m.key, info);
+        mentionList.push(info);
+    }
+    // Build reverse map for O(1) openId lookup
+    const mentionsByOpenId = new Map();
+    for (const info of mentionList) {
+        mentionsByOpenId.set(info.openId, info);
+    }
+    // 2. Convert content via registered converter
+    const acctId = expandCtx?.accountId;
+    // Create larkClient once when expandCtx is available (used for merge_forward & card fetch)
+    const larkClient = expandCtx ? LarkClient.fromCfg(expandCtx.cfg, acctId) : undefined;
+    // Build merge_forward callbacks when expandCtx is provided
+    let fetchSubMessages;
+    let batchResolveNames;
+    if (expandCtx) {
+        const account = getLarkAccount(expandCtx.cfg, acctId);
+        fetchSubMessages = createFetchSubMessages(larkClient);
+        batchResolveNames = createParseResolveNames(account);
+    }
+    // For interactive messages, fetch full v2 card content via API
+    let effectiveContent = event.message.content;
+    if (event.message.message_type === 'interactive' && expandCtx) {
+        const fullContent = await fetchCardContent(event.message.message_id, larkClient);
+        if (fullContent) {
+            effectiveContent = fullContent;
+            log.info('replaced interactive content with full v2 card data');
+        }
+    }
+    const convertCtx = {
+        mentions: mentionMap,
+        mentionsByOpenId,
+        messageId: event.message.message_id,
+        botOpenId,
+        cfg: expandCtx?.cfg,
+        accountId: acctId,
+        resolveUserName: acctId ? (openId) => getUserNameCache(acctId).get(openId) : undefined,
+        fetchSubMessages,
+        batchResolveNames,
+        stripBotMentions: true,
+    };
+    const { content, resources } = await convertMessageContent(effectiveContent, event.message.message_type, convertCtx);
+    const createTimeStr = event.message.create_time;
+    const createTime = createTimeStr ? parseInt(createTimeStr, 10) : undefined;
+    return {
+        chatId: event.message.chat_id,
+        messageId: event.message.message_id,
+        senderId: event.sender.sender_id.open_id || '',
+        chatType: event.message.chat_type,
+        rootId: event.message.root_id || undefined,
+        parentId: event.message.parent_id || undefined,
+        threadId: event.message.thread_id || undefined,
+        content,
+        contentType: event.message.message_type,
+        resources,
+        mentions: mentionList,
+        createTime: Number.isNaN(createTime) ? undefined : createTime,
+        rawMessage: effectiveContent !== event.message.content ? { ...event.message, content: effectiveContent } : event.message,
+        rawSender: event.sender,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/src/messaging/inbound/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/parse.ts"],"names":[],"mappings":"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"}

package/src/messaging/inbound/permission.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Permission error extraction and cooldown tracking for Feishu API calls.
+ *
+ * Extracted from bot.ts: PermissionError type, extractPermissionError,
+ * PERMISSION_ERROR_COOLDOWN_MS, permissionErrorNotifiedAt.
+ */
+export interface PermissionError {
+    code: number;
+    message: string;
+    grantUrl?: string;
+}
+export declare function extractPermissionError(err: unknown): PermissionError | null;
+export declare const PERMISSION_ERROR_COOLDOWN_MS: number;
+export declare const permissionErrorNotifiedAt: Map<string, number>;
+//# sourceMappingURL=permission.d.ts.map

package/src/messaging/inbound/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CA8B3E;AAMD,eAAO,MAAM,4BAA4B,QAAgB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,qBAA4B,CAAC"}

package/src/messaging/inbound/permission.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Permission error extraction and cooldown tracking for Feishu API calls.
+ *
+ * Extracted from bot.ts: PermissionError type, extractPermissionError,
+ * PERMISSION_ERROR_COOLDOWN_MS, permissionErrorNotifiedAt.
+ */
+import { extractPermissionGrantUrl } from '../../core/permission-url';
+import { LARK_ERROR } from '../../core/auth-errors';
+// ---------------------------------------------------------------------------
+// Permission error extraction
+// ---------------------------------------------------------------------------
+export function extractPermissionError(err) {
+    if (!err || typeof err !== 'object') {
+        return null;
+    }
+    const axiosErr = err;
+    const data = axiosErr.response?.data;
+    if (!data || typeof data !== 'object') {
+        return null;
+    }
+    const feishuErr = data;
+    // Feishu permission error code
+    if (feishuErr.code !== LARK_ERROR.APP_SCOPE_MISSING) {
+        return null;
+    }
+    const msg = feishuErr.msg ?? '';
+    const grantUrl = extractPermissionGrantUrl(msg);
+    if (!grantUrl) {
+        return null;
+    }
+    return { code: feishuErr.code, message: msg, grantUrl };
+}
+// ---------------------------------------------------------------------------
+// Cooldown tracking
+// ---------------------------------------------------------------------------
+export const PERMISSION_ERROR_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
+export const permissionErrorNotifiedAt = new Map();
+//# sourceMappingURL=permission.js.map

package/src/messaging/inbound/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAYpD,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,GAAwC,CAAC;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAIjB,CAAC;IAEF,+BAA+B;IAC/B,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,iBAAiB,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAkB,CAAC"}