@larksuite/openclaw-lark 2026.3.9

package/src/messaging/outbound/reactions.js

@@ -0,0 +1,379 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Reaction management for the Feishu/Lark channel plugin.
+ *
+ * Provides functions to add, remove, and list emoji reactions on Feishu
+ * messages using the IM Message Reaction API.
+ */
+import { LarkClient } from '../../core/lark-client';
+// ---------------------------------------------------------------------------
+// Feishu emoji constants
+// ---------------------------------------------------------------------------
+/**
+ * Well-known Feishu emoji type strings.
+ *
+ * This is a convenience map so consumers do not need to memorise the
+ * exact string identifiers. It is intentionally non-exhaustive --
+ * Feishu supports many more emoji types. Any valid emoji type string
+ * can be passed directly to the API functions.
+ */
+export const FeishuEmoji = {
+    THUMBSUP: 'THUMBSUP',
+    THUMBSDOWN: 'THUMBSDOWN',
+    HEART: 'HEART',
+    SMILE: 'SMILE',
+    JOYFUL: 'JOYFUL',
+    FROWN: 'FROWN',
+    BLUSH: 'BLUSH',
+    OK: 'OK',
+    CLAP: 'CLAP',
+    FIREWORKS: 'FIREWORKS',
+    PARTY: 'PARTY',
+    MUSCLE: 'MUSCLE',
+    FIRE: 'FIRE',
+    EYES: 'EYES',
+    THINKING: 'THINKING',
+    PRAISE: 'PRAISE',
+    PRAY: 'PRAY',
+    ROCKET: 'ROCKET',
+    DONE: 'DONE',
+    SKULL: 'SKULL',
+    HUNDREDPOINTS: 'HUNDREDPOINTS',
+    FACEPALM: 'FACEPALM',
+    CHECK: 'CHECK',
+    CROSSMARK: 'CrossMark',
+    COOL: 'COOL',
+    TYPING: 'Typing',
+    SPEECHLESS: 'SPEECHLESS',
+};
+// ---------------------------------------------------------------------------
+// Valid Feishu emoji types (complete set)
+// ---------------------------------------------------------------------------
+/**
+ * Complete set of valid Feishu emoji type strings for reactions.
+ *
+ * Sourced from the official Feishu emoji documentation.
+ * Unlike `FeishuEmoji` (a convenience subset), this set is exhaustive
+ * and can be used for validation and error reporting.
+ *
+ * @see https://go.feishu.cn/s/670vFWbA804
+ */
+export const VALID_FEISHU_EMOJI_TYPES = new Set([
+    // Gestures / actions
+    'OK',
+    'THUMBSUP',
+    'THANKS',
+    'MUSCLE',
+    'FINGERHEART',
+    'APPLAUSE',
+    'FISTBUMP',
+    'JIAYI',
+    'DONE',
+    // Faces / expressions
+    'SMILE',
+    'BLUSH',
+    'LAUGH',
+    'SMIRK',
+    'LOL',
+    'FACEPALM',
+    'LOVE',
+    'WINK',
+    'PROUD',
+    'WITTY',
+    'SMART',
+    'SCOWL',
+    'THINKING',
+    'SOB',
+    'CRY',
+    'ERROR',
+    'NOSEPICK',
+    'HAUGHTY',
+    'SLAP',
+    'SPITBLOOD',
+    'TOASTED',
+    'GLANCE',
+    'DULL',
+    'INNOCENTSMILE',
+    'JOYFUL',
+    'WOW',
+    'TRICK',
+    'YEAH',
+    'ENOUGH',
+    'TEARS',
+    'EMBARRASSED',
+    'KISS',
+    'SMOOCH',
+    'DROOL',
+    'OBSESSED',
+    'MONEY',
+    'TEASE',
+    'SHOWOFF',
+    'COMFORT',
+    'CLAP',
+    'PRAISE',
+    'STRIVE',
+    'XBLUSH',
+    'SILENT',
+    'WAVE',
+    'WHAT',
+    'FROWN',
+    'SHY',
+    'DIZZY',
+    'LOOKDOWN',
+    'CHUCKLE',
+    'WAIL',
+    'CRAZY',
+    'WHIMPER',
+    'HUG',
+    'BLUBBER',
+    'WRONGED',
+    'HUSKY',
+    'SHHH',
+    'SMUG',
+    'ANGRY',
+    'HAMMER',
+    'SHOCKED',
+    'TERROR',
+    'PETRIFIED',
+    'SKULL',
+    'SWEAT',
+    'SPEECHLESS',
+    'SLEEP',
+    'DROWSY',
+    'YAWN',
+    'SICK',
+    'PUKE',
+    'BETRAYED',
+    'HEADSET',
+    'EatingFood',
+    'MeMeMe',
+    'Sigh',
+    'Typing',
+    'SLIGHT',
+    'TONGUE',
+    'EYESCLOSED',
+    'RoarForYou',
+    'CALF',
+    'BEAR',
+    'BULL',
+    'RAINBOWPUKE',
+    // Objects / food / drinks
+    'Lemon',
+    'ROSE',
+    'HEART',
+    'PARTY',
+    'LIPS',
+    'BEER',
+    'CAKE',
+    'GIFT',
+    'CUCUMBER',
+    'Drumstick',
+    'Pepper',
+    'CANDIEDHAWS',
+    'BubbleTea',
+    'Coffee',
+    // Symbols / marks
+    'Get',
+    'LGTM',
+    'OnIt',
+    'OneSecond',
+    'VRHeadset',
+    'YouAreTheBest',
+    'SALUTE',
+    'SHAKE',
+    'HIGHFIVE',
+    'UPPERLEFT',
+    'ThumbsDown',
+    'Yes',
+    'No',
+    'OKR',
+    'CheckMark',
+    'CrossMark',
+    'MinusOne',
+    'Hundred',
+    'AWESOMEN',
+    'Pin',
+    'Alarm',
+    'Loudspeaker',
+    'Trophy',
+    'Fire',
+    'BOMB',
+    'Music',
+    // Holidays / seasons
+    'XmasTree',
+    'Snowman',
+    'XmasHat',
+    'FIREWORKS',
+    '2022',
+    'REDPACKET',
+    'FORTUNE',
+    'LUCK',
+    'FIRECRACKER',
+    'StickyRiceBalls',
+    // Miscellaneous
+    'HEARTBROKEN',
+    'POOP',
+    'StatusFlashOfInspiration',
+    '18X',
+    'CLEAVER',
+    'Soccer',
+    'Basketball',
+    // Status
+    'GeneralDoNotDisturb',
+    'Status_PrivateMessage',
+    'GeneralInMeetingBusy',
+    'StatusReading',
+    'StatusInFlight',
+    'GeneralBusinessTrip',
+    'GeneralWorkFromHome',
+    'StatusEnjoyLife',
+    'GeneralTravellingCar',
+    'StatusBus',
+    'GeneralSun',
+    'GeneralMoonRest',
+    // Holiday extras
+    'MoonRabbit',
+    'Mooncake',
+    'JubilantRabbit',
+    'TV',
+    'Movie',
+    'Pumpkin',
+    // Newer additions
+    'BeamingFace',
+    'Delighted',
+    'ColdSweat',
+    'FullMoonFace',
+    'Partying',
+    'GoGoGo',
+    'ThanksFace',
+    'SaluteFace',
+    'Shrug',
+    'ClownFace',
+    'HappyDragon',
+]);
+// ---------------------------------------------------------------------------
+// addReactionFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Add an emoji reaction to a Feishu message.
+ *
+ * @param params.cfg       - Plugin configuration with Feishu credentials.
+ * @param params.messageId - The message to react to.
+ * @param params.emojiType - The emoji type string (e.g. "THUMBSUP").
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ * @returns An object containing the platform-assigned reaction ID.
+ */
+export async function addReactionFeishu(params) {
+    const { cfg, messageId, emojiType, accountId } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    let response;
+    try {
+        response = await client.im.messageReaction.create({
+            path: {
+                message_id: messageId,
+            },
+            data: {
+                reaction_type: {
+                    emoji_type: emojiType,
+                },
+            },
+        });
+    }
+    catch (err) {
+        const e = err;
+        const errCode = e.code ?? e.response?.data?.code;
+        if (errCode === 231001) {
+            const validTypes = Array.from(VALID_FEISHU_EMOJI_TYPES).join(', ');
+            throw new Error(`Emoji type "${emojiType}" is not a valid Feishu reaction. Valid types: ${validTypes}`);
+        }
+        throw err;
+    }
+    const reactionId = response?.data?.reaction_id;
+    if (!reactionId) {
+        throw new Error(`[feishu-reactions] Failed to add reaction "${emojiType}" to message ${messageId}: no reaction_id returned`);
+    }
+    return { reactionId };
+}
+// ---------------------------------------------------------------------------
+// removeReactionFeishu
+// ---------------------------------------------------------------------------
+/**
+ * Remove a specific reaction from a Feishu message by its reaction ID.
+ *
+ * Unlike the outbound module's `removeReaction` (which looks up the
+ * reaction by emoji type), this function takes the exact reaction ID
+ * for direct deletion.
+ *
+ * @param params.cfg        - Plugin configuration with Feishu credentials.
+ * @param params.messageId  - The message the reaction belongs to.
+ * @param params.reactionId - The platform-assigned reaction ID to delete.
+ * @param params.accountId  - Optional account identifier for multi-account setups.
+ */
+export async function removeReactionFeishu(params) {
+    const { cfg, messageId, reactionId, accountId } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    await client.im.messageReaction.delete({
+        path: {
+            message_id: messageId,
+            reaction_id: reactionId,
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// listReactionsFeishu
+// ---------------------------------------------------------------------------
+/**
+ * List reactions on a Feishu message, optionally filtered by emoji type.
+ *
+ * Paginates through all results and returns a flat array of
+ * {@link FeishuReaction} objects.
+ *
+ * @param params.cfg       - Plugin configuration with Feishu credentials.
+ * @param params.messageId - The message whose reactions to list.
+ * @param params.emojiType - Optional emoji type filter (e.g. "THUMBSUP").
+ *                           When omitted, all reaction types are returned.
+ * @param params.accountId - Optional account identifier for multi-account setups.
+ * @returns An array of reactions matching the criteria.
+ */
+export async function listReactionsFeishu(params) {
+    const { cfg, messageId, emojiType, accountId } = params;
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    const reactions = [];
+    let pageToken;
+    let hasMore = true;
+    while (hasMore) {
+        const requestParams = {
+            page_size: 50,
+        };
+        if (emojiType) {
+            requestParams.reaction_type = emojiType;
+        }
+        if (pageToken) {
+            requestParams.page_token = pageToken;
+        }
+        const response = await client.im.messageReaction.list({
+            path: {
+                message_id: messageId,
+            },
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            params: requestParams,
+        });
+        const items = response?.data?.items;
+        if (items && items.length > 0) {
+            for (const item of items) {
+                reactions.push({
+                    reactionId: item.reaction_id ?? '',
+                    emojiType: item.reaction_type?.emoji_type ?? '',
+                    operatorType: item.operator?.operator_type === 'app' ? 'app' : 'user',
+                    operatorId: item.operator?.operator_id ?? '',
+                });
+            }
+        }
+        pageToken = response?.data?.page_token ?? undefined;
+        hasMore = response?.data?.has_more === true && !!pageToken;
+    }
+    return reactions;
+}
+//# sourceMappingURL=reactions.js.map

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

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

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

@@ -0,0 +1,136 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Message sending for the Feishu/Lark channel plugin.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+import type { FeishuSendResult } from '../types';
+import type { MentionInfo } from '../types';
+/**
+ * Parameters for sending a text / post message.
+ */
+export interface SendFeishuMessageParams {
+    cfg: ClawdbotConfig;
+    /** Target identifier (chat_id, open_id, or user_id). */
+    to: string;
+    /** Message text content (supports Feishu markdown subset). */
+    text: string;
+    /** When set, the message is sent as a threaded reply. */
+    replyToMessageId?: string;
+    /** Optional mention targets to prepend to the message. */
+    mentions?: MentionInfo[];
+    /** Optional account identifier for multi-account setups. */
+    accountId?: string;
+    /** When true, the reply appears in the thread instead of main chat. */
+    replyInThread?: boolean;
+}
+/**
+ * Parameters for sending an interactive card message.
+ */
+export interface SendFeishuCardParams {
+    cfg: ClawdbotConfig;
+    /** Target identifier (chat_id, open_id, or user_id). */
+    to: string;
+    /** The full interactive card JSON payload. */
+    card: Record<string, unknown>;
+    /** When set, the card is sent as a threaded reply. */
+    replyToMessageId?: string;
+    /** Optional account identifier for multi-account setups. */
+    accountId?: string;
+    /** When true, the reply appears in the thread instead of main chat. */
+    replyInThread?: boolean;
+}
+/**
+ * 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 declare function sendMessageFeishu(params: SendFeishuMessageParams): Promise<FeishuSendResult>;
+/**
+ * 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 declare function sendCardFeishu(params: SendFeishuCardParams): Promise<FeishuSendResult>;
+/**
+ * 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 declare function updateCardFeishu(params: {
+    cfg: ClawdbotConfig;
+    messageId: string;
+    card: Record<string, unknown>;
+    accountId?: string;
+}): Promise<void>;
+/**
+ * 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 declare function buildMarkdownCard(text: string): Record<string, unknown>;
+/**
+ * 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 declare function sendMarkdownCardFeishu(params: {
+    cfg: ClawdbotConfig;
+    to: string;
+    text: string;
+    replyToMessageId?: string;
+    mentions?: MentionInfo[];
+    accountId?: string;
+    replyInThread?: boolean;
+}): Promise<FeishuSendResult>;
+/**
+ * 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 declare function editMessageFeishu(params: {
+    cfg: ClawdbotConfig;
+    messageId: string;
+    text: string;
+    accountId?: string;
+}): Promise<void>;
+//# sourceMappingURL=send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/messaging/outbound/send.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAQ5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,cAAc,CAAC;IACpB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,cAAc,CAAC;IACpB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkFlG;AAMD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuD5F;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBvE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,GAAG,EAAE,cAAc,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB"}