@larksuite/openclaw-lark 2026.3.9

package/src/messaging/outbound/send.js

@@ -0,0 +1,289 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Message sending for the Feishu/Lark channel plugin.
+ */
+import { LarkClient } from '../../core/lark-client';
+import { normalizeFeishuTarget, normalizeMessageId, resolveReceiveIdType } from '../../core/targets';
+import { runWithMessageUnavailableGuard } from '../../core/message-unavailable';
+import { optimizeMarkdownStyle } from '../../card/markdown-style';
+import { buildMentionedMessage, buildMentionedCardContent } from '../inbound/mention';
+// ---------------------------------------------------------------------------
+// sendMessageFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Send a text message (rendered as a Feishu "post" with markdown support)
+ * to a chat or user.
+ *
+ * The message text is wrapped in Feishu's post format using the `md` tag
+ * for rich rendering. If `replyToMessageId` is provided, the message is
+ * sent as a threaded reply; otherwise it is sent as a new message using
+ * the appropriate `receive_id_type`.
+ *
+ * Markdown tables in the text are automatically converted to the format
+ * supported by Feishu via the runtime's table converter when available.
+ *
+ * @param params - See {@link SendFeishuMessageParams}.
+ * @returns The send result containing the new message ID.
+ */
+export async function sendMessageFeishu(params) {
+    const { cfg, to, text, replyToMessageId, mentions, accountId, replyInThread } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    // Apply mention prefix if targets are provided.
+    let messageText = text;
+    if (mentions && mentions.length > 0) {
+        messageText = buildMentionedMessage(mentions, messageText);
+    }
+    // Convert markdown tables to Feishu-compatible format if the runtime
+    // provides a converter.
+    try {
+        const runtime = LarkClient.runtime;
+        if (runtime?.channel?.text?.convertMarkdownTables) {
+            messageText = runtime.channel.text.convertMarkdownTables(messageText, 'bullets');
+        }
+    }
+    catch {
+        // Runtime not available -- use the text as-is.
+    }
+    // Apply Markdown style optimization.
+    messageText = optimizeMarkdownStyle(messageText, 1);
+    // Build the post-format content envelope.
+    const contentPayload = JSON.stringify({
+        zh_cn: {
+            content: [[{ tag: 'md', text: messageText }]],
+        },
+    });
+    if (replyToMessageId) {
+        // Send as a threaded reply.
+        // 规范化 message_id，处理合成 ID（如 "om_xxx:auth-complete"）
+        const normalizedId = normalizeMessageId(replyToMessageId);
+        const response = await runWithMessageUnavailableGuard({
+            messageId: normalizedId,
+            operation: 'im.message.reply(post)',
+            fn: () => client.im.message.reply({
+                path: {
+                    message_id: normalizedId,
+                },
+                data: {
+                    content: contentPayload,
+                    msg_type: 'post',
+                    reply_in_thread: replyInThread,
+                },
+            }),
+        });
+        return {
+            messageId: response?.data?.message_id ?? '',
+            chatId: response?.data?.chat_id ?? '',
+        };
+    }
+    // Send as a new message.
+    const target = normalizeFeishuTarget(to);
+    if (!target) {
+        throw new Error(`[feishu-send] Invalid target: "${to}"`);
+    }
+    const receiveIdType = resolveReceiveIdType(target);
+    const response = await client.im.message.create({
+        params: {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            receive_id_type: receiveIdType,
+        },
+        data: {
+            receive_id: target,
+            msg_type: 'post',
+            content: contentPayload,
+        },
+    });
+    return {
+        messageId: response?.data?.message_id ?? '',
+        chatId: response?.data?.chat_id ?? '',
+    };
+}
+// ---------------------------------------------------------------------------
+// sendCardFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Send an interactive card message to a chat or user.
+ *
+ * @param params - See {@link SendFeishuCardParams}.
+ * @returns The send result containing the new message ID.
+ */
+export async function sendCardFeishu(params) {
+    const { cfg, to, card, replyToMessageId, accountId, replyInThread } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    const contentPayload = JSON.stringify(card);
+    if (replyToMessageId) {
+        // 规范化 message_id，处理合成 ID（如 "om_xxx:auth-complete"）
+        const normalizedId = normalizeMessageId(replyToMessageId);
+        const response = await runWithMessageUnavailableGuard({
+            messageId: normalizedId,
+            operation: 'im.message.reply(interactive)',
+            fn: () => client.im.message.reply({
+                path: {
+                    message_id: normalizedId,
+                },
+                data: {
+                    content: contentPayload,
+                    msg_type: 'interactive',
+                    reply_in_thread: replyInThread,
+                },
+            }),
+        });
+        return {
+            messageId: response?.data?.message_id ?? '',
+            chatId: response?.data?.chat_id ?? '',
+        };
+    }
+    const target = normalizeFeishuTarget(to);
+    if (!target) {
+        throw new Error(`[feishu-send] Invalid target: "${to}"`);
+    }
+    const receiveIdType = resolveReceiveIdType(target);
+    const response = await client.im.message.create({
+        params: {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            receive_id_type: receiveIdType,
+        },
+        data: {
+            receive_id: target,
+            msg_type: 'interactive',
+            content: contentPayload,
+        },
+    });
+    return {
+        messageId: response?.data?.message_id ?? '',
+        chatId: response?.data?.chat_id ?? '',
+    };
+}
+// ---------------------------------------------------------------------------
+// updateCardFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Update (PATCH) the content of an existing interactive card message.
+ *
+ * Only messages originally sent by the bot can be updated. The card
+ * must have been created with `"update_multi": true` in its config if
+ * all recipients should see the update.
+ *
+ * @param params.cfg       - Plugin configuration.
+ * @param params.messageId - The card message ID to update.
+ * @param params.card      - The new card content.
+ * @param params.accountId - Optional account identifier.
+ */
+export async function updateCardFeishu(params) {
+    const { cfg, messageId, card, accountId } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    await runWithMessageUnavailableGuard({
+        messageId,
+        operation: 'im.message.patch(interactive)',
+        fn: () => client.im.message.patch({
+            path: {
+                message_id: messageId,
+            },
+            data: {
+                content: JSON.stringify(card),
+            },
+        }),
+    });
+}
+// ---------------------------------------------------------------------------
+// buildMarkdownCard
+// ---------------------------------------------------------------------------
+/**
+ * Build a simple Feishu Interactive Message Card containing a single
+ * markdown element.
+ *
+ * This is a convenience wrapper for the most common card layout: a
+ * wide-screen card with one markdown block.
+ *
+ * @param text - The markdown text to render in the card.
+ * @returns A card JSON object ready to be sent via {@link sendCardFeishu}.
+ */
+export function buildMarkdownCard(text) {
+    const optimizedText = optimizeMarkdownStyle(text);
+    return {
+        schema: '2.0',
+        config: {
+            wide_screen_mode: true,
+        },
+        body: {
+            elements: [
+                {
+                    tag: 'markdown',
+                    content: optimizedText,
+                },
+            ],
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// sendMarkdownCardFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Build a markdown card and send it in one step.
+ *
+ * If mention targets are provided, they are prepended to the markdown
+ * content using the card mention syntax.
+ *
+ * @param params.cfg              - Plugin configuration.
+ * @param params.to               - Target identifier.
+ * @param params.text             - Markdown content for the card.
+ * @param params.replyToMessageId - Optional message ID for threaded reply.
+ * @param params.mentions         - Optional mention targets.
+ * @param params.accountId        - Optional account identifier.
+ * @returns The send result containing the new message ID.
+ */
+export async function sendMarkdownCardFeishu(params) {
+    const { cfg, to, text, replyToMessageId, mentions, accountId, replyInThread } = params;
+    let cardText = text;
+    if (mentions && mentions.length > 0) {
+        cardText = buildMentionedCardContent(mentions, cardText);
+    }
+    const card = buildMarkdownCard(cardText);
+    return sendCardFeishu({
+        cfg,
+        to,
+        card,
+        replyToMessageId,
+        replyInThread,
+        accountId,
+    });
+}
+// ---------------------------------------------------------------------------
+// editMessageFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Edit the content of an existing message.
+ *
+ * Updates the message body via the IM message update API. Only
+ * messages sent by the bot can be edited.
+ *
+ * @param params.cfg       - Plugin configuration.
+ * @param params.messageId - The message ID to edit.
+ * @param params.text      - The new message text.
+ * @param params.accountId - Optional account identifier.
+ */
+export async function editMessageFeishu(params) {
+    const { cfg, messageId, text, accountId } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    const optimizedText = optimizeMarkdownStyle(text);
+    const contentPayload = JSON.stringify({
+        zh_cn: {
+            content: [[{ tag: 'md', text: optimizedText }]],
+        },
+    });
+    await runWithMessageUnavailableGuard({
+        messageId,
+        operation: 'im.message.update(post)',
+        fn: () => client.im.message.update({
+            path: {
+                message_id: messageId,
+            },
+            data: {
+                content: contentPayload,
+                msg_type: 'post',
+            },
+        }),
+    });
+}
+//# sourceMappingURL=send.js.map

package/src/messaging/outbound/send.js.map

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

package/src/messaging/outbound/typing.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Typing indicator management for the Feishu/Lark channel plugin.
+ *
+ * Feishu does not expose a first-class "typing indicator" API the way
+ * some other messaging platforms do. Instead, this module simulates a
+ * typing state by adding a recognisable emoji reaction (the "Typing"
+ * emoji) to the user's message while the bot is processing, and
+ * removing it once the response is ready.
+ *
+ * This provides a lightweight visual cue that the bot has acknowledged
+ * the message and is working on a reply.
+ */
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+/**
+ * Tracks the state of an active typing indicator so it can be
+ * removed later.
+ */
+export interface TypingIndicatorState {
+    /** The message ID that the reaction was added to. */
+    messageId: string;
+    /** The reaction ID returned by the API, or null if the add failed. */
+    reactionId: string | null;
+}
+/**
+ * Add a typing indicator to a message by creating an emoji reaction.
+ *
+ * The reaction is added silently -- any errors (network issues, missing
+ * permissions, rate limits) are caught and logged rather than propagated
+ * to the caller. This ensures that a failure to show the typing cue
+ * never blocks the actual message processing.
+ *
+ * @param params.cfg       - Plugin configuration with Feishu credentials.
+ * @param params.messageId - The message ID to add the typing reaction to.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ * @returns A state object that should be passed to {@link removeTypingIndicator}.
+ */
+export declare function addTypingIndicator(params: {
+    cfg: OpenClawConfig;
+    messageId: string;
+    accountId?: string;
+}): Promise<TypingIndicatorState>;
+/**
+ * Remove a previously added typing indicator reaction from a message.
+ *
+ * If the indicator was never successfully added (reactionId is null),
+ * this function is a no-op. Errors are silently caught so removal
+ * failures do not disrupt downstream logic.
+ *
+ * @param params.cfg   - Plugin configuration with Feishu credentials.
+ * @param params.state - The typing indicator state returned by {@link addTypingIndicator}.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ */
+export declare function removeTypingIndicator(params: {
+    cfg: OpenClawConfig;
+    state: TypingIndicatorState;
+    accountId?: string;
+}): Promise<void>;
+//# sourceMappingURL=typing.d.ts.map

package/src/messaging/outbound/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../../../src/messaging/outbound/typing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAY1D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6ChC;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB"}

package/src/messaging/outbound/typing.js

@@ -0,0 +1,136 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Typing indicator management for the Feishu/Lark channel plugin.
+ *
+ * Feishu does not expose a first-class "typing indicator" API the way
+ * some other messaging platforms do. Instead, this module simulates a
+ * typing state by adding a recognisable emoji reaction (the "Typing"
+ * emoji) to the user's message while the bot is processing, and
+ * removing it once the response is ready.
+ *
+ * This provides a lightweight visual cue that the bot has acknowledged
+ * the message and is working on a reply.
+ */
+import { LarkClient } from '../../core/lark-client';
+import { normalizeMessageId } from '../../core/targets';
+import { isMessageUnavailableError, runWithMessageUnavailableGuard } from '../../core/message-unavailable';
+import { larkLogger } from '../../core/lark-logger';
+const log = larkLogger('outbound/typing');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * The emoji type used to represent the typing indicator.
+ *
+ * "Typing" is a built-in Feishu emoji that shows a pencil / keyboard
+ * animation, making it a natural choice for a typing cue.
+ */
+const TYPING_EMOJI_TYPE = 'Typing';
+// ---------------------------------------------------------------------------
+// addTypingIndicator
+// ---------------------------------------------------------------------------
+/**
+ * Add a typing indicator to a message by creating an emoji reaction.
+ *
+ * The reaction is added silently -- any errors (network issues, missing
+ * permissions, rate limits) are caught and logged rather than propagated
+ * to the caller. This ensures that a failure to show the typing cue
+ * never blocks the actual message processing.
+ *
+ * @param params.cfg       - Plugin configuration with Feishu credentials.
+ * @param params.messageId - The message ID to add the typing reaction to.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ * @returns A state object that should be passed to {@link removeTypingIndicator}.
+ */
+export async function addTypingIndicator(params) {
+    const { cfg, messageId, accountId } = params;
+    // 规范化 message_id，处理合成 ID（如 "om_xxx:auth-complete"）
+    const normalizedId = normalizeMessageId(messageId);
+    const state = {
+        messageId: normalizedId, // 保存规范化后的 ID
+        reactionId: null,
+    };
+    try {
+        const client = LarkClient.fromCfg(cfg, accountId).sdk;
+        const response = await runWithMessageUnavailableGuard({
+            messageId: normalizedId,
+            operation: 'im.messageReaction.create(typing)',
+            fn: () => client.im.messageReaction.create({
+                path: {
+                    message_id: normalizedId,
+                },
+                data: {
+                    reaction_type: {
+                        emoji_type: TYPING_EMOJI_TYPE,
+                    },
+                },
+            }),
+        });
+        state.reactionId = response?.data?.reaction_id ?? null;
+    }
+    catch (error) {
+        if (isMessageUnavailableError(error)) {
+            log.debug(`Skip add typing indicator for unavailable message`, { messageId: normalizedId });
+            return state;
+        }
+        // Silently swallow the error. The typing indicator is a best-effort
+        // visual cue and must not interfere with message processing.
+        log.debug(`Failed to add typing indicator`, {
+            messageId,
+            error: error instanceof Error ? error.message : error,
+        });
+    }
+    return state;
+}
+// ---------------------------------------------------------------------------
+// removeTypingIndicator
+// ---------------------------------------------------------------------------
+/**
+ * Remove a previously added typing indicator reaction from a message.
+ *
+ * If the indicator was never successfully added (reactionId is null),
+ * this function is a no-op. Errors are silently caught so removal
+ * failures do not disrupt downstream logic.
+ *
+ * @param params.cfg   - Plugin configuration with Feishu credentials.
+ * @param params.state - The typing indicator state returned by {@link addTypingIndicator}.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ */
+export async function removeTypingIndicator(params) {
+    const { cfg, state, accountId } = params;
+    const reactionId = state.reactionId;
+    if (!reactionId) {
+        // Nothing to remove -- the indicator was never added or the add
+        // call did not return a reaction ID.
+        return;
+    }
+    try {
+        const client = LarkClient.fromCfg(cfg, accountId).sdk;
+        await runWithMessageUnavailableGuard({
+            messageId: state.messageId,
+            operation: 'im.messageReaction.delete(typing)',
+            fn: () => client.im.messageReaction.delete({
+                path: {
+                    message_id: state.messageId,
+                    reaction_id: reactionId,
+                },
+            }),
+        });
+    }
+    catch (error) {
+        if (isMessageUnavailableError(error)) {
+            log.debug(`Skip remove typing indicator for unavailable message`, { messageId: state.messageId });
+            return;
+        }
+        // Silently swallow the error. A leftover reaction is acceptable;
+        // it will not confuse the user and will disappear if the message
+        // is deleted or the reaction is manually removed.
+        log.debug(`Failed to remove typing indicator`, {
+            messageId: state.messageId,
+            error: error instanceof Error ? error.message : error,
+        });
+    }
+}
+//# sourceMappingURL=typing.js.map

package/src/messaging/outbound/typing.js.map

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

package/src/messaging/shared/message-lookup.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Message fetching for the Feishu/Lark channel plugin.
+ *
+ * Shared between inbound (reaction handler, enrich) and outbound modules.
+ * Extracted from `outbound/fetch.ts` to eliminate inbound→outbound
+ * dependency inversion.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+/**
+ * Normalised information about a Feishu message, returned by
+ * {@link getMessageFeishu}.
+ */
+export interface FeishuMessageInfo {
+    /** Unique Feishu message ID. */
+    messageId: string;
+    /** Chat ID where the message lives. */
+    chatId: string;
+    /** Chat type ("p2p" or "group"), when available in the API response. */
+    chatType?: string;
+    /** Open ID of the sender (if available). */
+    senderId?: string;
+    /** Display name of the sender (resolved from user-name cache). */
+    senderName?: string;
+    /** Feishu sender type: "user" for human users, "app" for bots/apps. */
+    senderType?: string;
+    /** The parsed text / content of the message. */
+    content: string;
+    /** Feishu content type indicator (text, post, image, interactive, ...). */
+    contentType: string;
+    /** Unix-millisecond timestamp of when the message was created. */
+    createTime?: number;
+    /** Thread ID if the message belongs to a thread (omt_xxx format). */
+    threadId?: string;
+}
+/**
+ * Retrieve a single message by its ID from the Feishu IM API.
+ *
+ * Returns a normalised {@link FeishuMessageInfo} object, or `null` if the
+ * message cannot be found or the API returns an error.
+ *
+ * @param params.cfg       - Plugin configuration with Feishu credentials.
+ * @param params.messageId - The message ID to fetch.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ */
+export declare function getMessageFeishu(params: {
+    cfg: ClawdbotConfig;
+    messageId: string;
+    accountId?: string;
+    /** When true, merge_forward content is recursively expanded via API. */
+    expandForward?: boolean;
+}): Promise<FeishuMessageInfo | null>;
+//# sourceMappingURL=message-lookup.d.ts.map

package/src/messaging/shared/message-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-lookup.d.ts","sourceRoot":"","sources":["../../../../src/messaging/shared/message-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAa1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmDpC"}