@larksuite/openclaw-lark 2026.3.9

package/src/messaging/inbound/user-name-cache.js

@@ -0,0 +1,242 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Account-scoped LRU cache for Feishu user display names.
+ *
+ * Provides:
+ * - `UserNameCache` — per-account LRU Map with TTL
+ * - `getUserNameCache(accountId)` — singleton registry
+ * - `batchResolveUserNames()` — batch API via `contact/v3/users/batch`
+ * - `resolveUserName()` — single-user fallback via `contact.user.get`
+ * - `clearUserNameCache()` — teardown hook (called from LarkClient.clearCache)
+ */
+import { LarkClient } from '../../core/lark-client';
+import { extractPermissionError } from './permission';
+// ---------------------------------------------------------------------------
+// UserNameCache
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_SIZE = 500;
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 minutes
+export class UserNameCache {
+    map = new Map();
+    maxSize;
+    ttlMs;
+    constructor(maxSize = DEFAULT_MAX_SIZE, ttlMs = DEFAULT_TTL_MS) {
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    /** Check whether the cache holds a (possibly empty) entry for this openId. */
+    has(openId) {
+        const entry = this.map.get(openId);
+        if (!entry)
+            return false;
+        if (entry.expireAt <= Date.now()) {
+            this.map.delete(openId);
+            return false;
+        }
+        return true;
+    }
+    /** Get a cached name (refreshes LRU position). Returns `undefined` on miss or expiry. */
+    get(openId) {
+        const entry = this.map.get(openId);
+        if (!entry)
+            return undefined;
+        if (entry.expireAt <= Date.now()) {
+            this.map.delete(openId);
+            return undefined;
+        }
+        // LRU refresh: delete + re-insert to move to end
+        this.map.delete(openId);
+        this.map.set(openId, entry);
+        return entry.name;
+    }
+    /** Write a single entry (evicts oldest if over capacity). */
+    set(openId, name) {
+        this.map.delete(openId); // ensure fresh insertion order
+        this.map.set(openId, { name, expireAt: Date.now() + this.ttlMs });
+        this.evict();
+    }
+    /** Write multiple entries at once. */
+    setMany(entries) {
+        for (const [openId, name] of entries) {
+            this.map.delete(openId);
+            this.map.set(openId, { name, expireAt: Date.now() + this.ttlMs });
+        }
+        this.evict();
+    }
+    /** Return openIds that are NOT present (or expired) in the cache. */
+    filterMissing(openIds) {
+        return openIds.filter((id) => !this.has(id));
+    }
+    /** Bulk read — returns a Map of openId→name for all hits (including empty-string names). */
+    getMany(openIds) {
+        const result = new Map();
+        for (const id of openIds) {
+            if (this.has(id)) {
+                result.set(id, this.get(id) ?? '');
+            }
+        }
+        return result;
+    }
+    /** Clear all entries. */
+    clear() {
+        this.map.clear();
+    }
+    evict() {
+        while (this.map.size > this.maxSize) {
+            // Map iterator yields in insertion order — first key is the oldest
+            const oldest = this.map.keys().next().value;
+            if (oldest !== undefined)
+                this.map.delete(oldest);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Account-scoped singleton registry
+// ---------------------------------------------------------------------------
+const registry = new Map();
+/** Get (or create) the UserNameCache for a given account. */
+export function getUserNameCache(accountId) {
+    let c = registry.get(accountId);
+    if (!c) {
+        c = new UserNameCache();
+        registry.set(accountId, c);
+    }
+    return c;
+}
+/**
+ * Clear user-name caches.
+ * - With `accountId`: clear that single cache.
+ * - Without: clear all caches.
+ */
+export function clearUserNameCache(accountId) {
+    if (accountId !== undefined) {
+        registry.get(accountId)?.clear();
+        registry.delete(accountId);
+    }
+    else {
+        for (const c of registry.values())
+            c.clear();
+        registry.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Batch resolve via contact/v3/users/batch
+// ---------------------------------------------------------------------------
+/** Max user_ids per API call (Feishu limit). */
+const BATCH_SIZE = 50;
+/**
+ * Batch-resolve user display names.
+ *
+ * 1. Check cache → collect misses
+ * 2. Deduplicate
+ * 3. Call `GET /open-apis/contact/v3/users/batch` in chunks of 50
+ * 4. Write results back to cache
+ * 5. Return full Map<openId, name> (cache hits + API results)
+ *
+ * Best-effort: API errors are logged but never thrown.
+ */
+export async function batchResolveUserNames(params) {
+    const { account, openIds, log } = params;
+    if (!account.configured || openIds.length === 0) {
+        return new Map();
+    }
+    const cache = getUserNameCache(account.accountId);
+    const result = cache.getMany(openIds);
+    // Deduplicate missing IDs
+    const missing = [...new Set(cache.filterMissing(openIds))];
+    if (missing.length === 0)
+        return result;
+    const client = LarkClient.fromAccount(account).sdk;
+    // Split into chunks of BATCH_SIZE and call SDK method
+    for (let i = 0; i < missing.length; i += BATCH_SIZE) {
+        const chunk = missing.slice(i, i + BATCH_SIZE);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const res = await client.contact.user.batch({
+                params: {
+                    user_ids: chunk,
+                    user_id_type: 'open_id',
+                },
+            });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const items = res?.data?.items ?? [];
+            const resolved = new Set();
+            for (const item of items) {
+                const openId = item.open_id;
+                if (!openId)
+                    continue;
+                const name = item.name || item.display_name || item.nickname || item.en_name || '';
+                cache.set(openId, name);
+                result.set(openId, name);
+                resolved.add(openId);
+            }
+            // Cache empty names for IDs the API didn't return (no permission, etc.)
+            for (const id of chunk) {
+                if (!resolved.has(id)) {
+                    cache.set(id, '');
+                    result.set(id, '');
+                }
+            }
+        }
+        catch (err) {
+            log(`batchResolveUserNames: failed: ${String(err)}`);
+        }
+    }
+    return result;
+}
+/**
+ * Create a `batchResolveNames` callback for use in `ConvertContext`.
+ *
+ * The returned function calls `batchResolveUserNames` with the given
+ * account and log function, populating the TAT user-name cache.
+ */
+export function createBatchResolveNames(account, log) {
+    return async (openIds) => {
+        await batchResolveUserNames({ account, openIds, log });
+    };
+}
+/**
+ * Resolve a single user's display name.
+ *
+ * Checks the account-scoped cache first, then falls back to the
+ * `contact.user.get` API (same as the old `resolveFeishuSenderName`).
+ */
+export async function resolveUserName(params) {
+    const { account, openId, log } = params;
+    if (!account.configured || !openId)
+        return {};
+    const cache = getUserNameCache(account.accountId);
+    if (cache.has(openId))
+        return { name: cache.get(openId) ?? '' };
+    try {
+        const client = LarkClient.fromAccount(account).sdk;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const res = await client.contact.user.get({
+            path: { user_id: openId },
+            params: { user_id_type: 'open_id' },
+        });
+        const name = res?.data?.user?.name ||
+            res?.data?.user?.display_name ||
+            res?.data?.user?.nickname ||
+            res?.data?.user?.en_name ||
+            '';
+        // Cache even empty names to avoid repeated API calls for users
+        // whose names we cannot resolve (e.g. due to permissions).
+        cache.set(openId, name);
+        return { name: name || undefined };
+    }
+    catch (err) {
+        const permErr = extractPermissionError(err);
+        if (permErr) {
+            log(`feishu: permission error resolving user name: code=${permErr.code}`);
+            // Cache empty name so we don't retry a known-failing openId
+            cache.set(openId, '');
+            return { permissionError: permErr };
+        }
+        log(`feishu: failed to resolve user name for ${openId}: ${String(err)}`);
+        return {};
+    }
+}
+//# sourceMappingURL=user-name-cache.js.map

package/src/messaging/inbound/user-name-cache.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * ChannelMessageActionAdapter for the Feishu/Lark channel plugin.
+ *
+ * Implements the standard message-action interface so the framework's
+ * built-in `message` tool can route send, react, delete and other
+ * actions to Feishu.
+ *
+ * The `send` action is the unified entry-point for text, card, media,
+ * reply and attachment delivery — matching the Telegram/Discord pattern
+ * where a single action handles all outbound message types.
+ */
+import type { ChannelMessageActionAdapter } from 'openclaw/plugin-sdk';
+export declare const feishuMessageActions: ChannelMessageActionAdapter;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/messaging/outbound/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAI5B,MAAM,qBAAqB,CAAC;AA2I7B,eAAO,MAAM,oBAAoB,EAAE,2BA2ClC,CAAC"}

package/src/messaging/outbound/actions.js

@@ -0,0 +1,310 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * ChannelMessageActionAdapter for the Feishu/Lark channel plugin.
+ *
+ * Implements the standard message-action interface so the framework's
+ * built-in `message` tool can route send, react, delete and other
+ * actions to Feishu.
+ *
+ * The `send` action is the unified entry-point for text, card, media,
+ * reply and attachment delivery — matching the Telegram/Discord pattern
+ * where a single action handles all outbound message types.
+ */
+import { extractToolSend, jsonResult, readStringParam, readReactionParams } from 'openclaw/plugin-sdk';
+import { addReactionFeishu, removeReactionFeishu, listReactionsFeishu } from './reactions';
+import { sendTextLark, sendCardLark } from './deliver';
+import { uploadAndSendMediaLark } from './media';
+import { LarkClient } from '../../core/lark-client';
+import { getEnabledLarkAccounts } from '../../core/accounts';
+import { larkLogger } from '../../core/lark-logger';
+const log = larkLogger('outbound/actions');
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Assert that a Lark SDK response has code === 0 (or no code field). */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function assertLarkOk(res, context) {
+    const code = res?.code;
+    if (code !== undefined && code !== 0) {
+        const msg = res?.msg ?? 'unknown error';
+        throw new Error(`[feishu-actions] ${context}: code=${code}, msg=${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Supported actions
+// ---------------------------------------------------------------------------
+const SUPPORTED_ACTIONS = new Set([
+    'send',
+    'react',
+    'reactions',
+    'delete',
+    'unsend',
+    // "member-info",
+]);
+// ---------------------------------------------------------------------------
+// Send param extraction
+// ---------------------------------------------------------------------------
+/** Try to resolve a card param to a plain object. Accepts objects directly or JSON strings. */
+function parseCardParam(raw) {
+    if (raw == null)
+        return undefined;
+    // Already a non-array object — use directly.
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    // String — attempt JSON.parse.
+    if (typeof raw === 'string') {
+        const trimmed = raw.trim();
+        if (!trimmed.startsWith('{') || !trimmed.endsWith('}')) {
+            log.warn('params.card is a string but not a JSON object, ignoring');
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                log.info('params.card was a JSON string, parsed successfully');
+                return parsed;
+            }
+            log.warn('params.card JSON parsed but is not a plain object, ignoring');
+            return undefined;
+        }
+        catch {
+            log.warn('params.card is a string but failed to JSON.parse, ignoring');
+            return undefined;
+        }
+    }
+    // Other types (number, boolean, etc.) — ignore with warning.
+    log.warn(`params.card has unexpected type "${typeof raw}", ignoring`);
+    return undefined;
+}
+/**
+ * Extract and normalise all send-related parameters from the raw action params.
+ * When `toolContext` is provided, thread context is inherited so that replies
+ * are routed to the correct thread.
+ */
+function readFeishuSendParams(params, toolContext) {
+    const to = readStringParam(params, 'to') ?? '';
+    const text = readStringParam(params, 'message', { allowEmpty: true }) ??
+        readStringParam(params, 'text', { allowEmpty: true }) ??
+        '';
+    const mediaUrl = readStringParam(params, 'media') ??
+        readStringParam(params, 'path') ??
+        readStringParam(params, 'filePath') ??
+        readStringParam(params, 'url');
+    const fileName = readStringParam(params, 'fileName') ?? readStringParam(params, 'name');
+    // Thread routing: when targeting the current chat (or unspecified),
+    // inherit thread context from SDK toolContext.
+    const sameChat = !to || to === toolContext?.currentChannelId;
+    const replyInThread = sameChat && Boolean(toolContext?.currentThreadTs);
+    const replyToMessageId = readStringParam(params, 'replyTo') ??
+        (replyInThread && toolContext?.currentMessageId ? String(toolContext.currentMessageId) : undefined);
+    const card = parseCardParam(params.card);
+    return {
+        to,
+        text,
+        mediaUrl: mediaUrl ?? undefined,
+        fileName: fileName ?? undefined,
+        replyToMessageId: replyToMessageId ?? undefined,
+        replyInThread,
+        card,
+    };
+}
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export const feishuMessageActions = {
+    listActions: ({ cfg }) => {
+        const accounts = getEnabledLarkAccounts(cfg);
+        if (accounts.length === 0)
+            return [];
+        return Array.from(SUPPORTED_ACTIONS);
+    },
+    supportsAction: ({ action }) => SUPPORTED_ACTIONS.has(action),
+    supportsButtons: ({ cfg }) => getEnabledLarkAccounts(cfg).length > 0,
+    supportsCards: ({ cfg }) => getEnabledLarkAccounts(cfg).length > 0,
+    extractToolSend: ({ args }) => extractToolSend(args, 'sendMessage'),
+    handleAction: async (ctx) => {
+        const { action, params, cfg, accountId, toolContext } = ctx;
+        const aid = accountId ?? undefined;
+        log.info(`handleAction: action=${action}, accountId=${aid ?? 'default'}`);
+        try {
+            switch (action) {
+                case 'send':
+                    return await deliverMessage(cfg, readFeishuSendParams(params, toolContext), aid, ctx.mediaLocalRoots);
+                case 'react':
+                    return await handleReact(cfg, params, aid);
+                case 'reactions':
+                    return await handleReactions(cfg, params, aid);
+                case 'delete':
+                case 'unsend':
+                    return await handleDelete(cfg, params, aid);
+                default:
+                    throw new Error(`Action "${action}" is not supported for Feishu. ` +
+                        `Supported actions: ${Array.from(SUPPORTED_ACTIONS).join(', ')}.`);
+            }
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log.error(`handleAction failed: action=${action}, error=${errMsg}`);
+            throw err;
+        }
+    },
+};
+// ---------------------------------------------------------------------------
+// Unified message delivery
+// ---------------------------------------------------------------------------
+/**
+ * Unified message delivery — handles text, card, and media payloads with
+ * optional reply-to and thread routing.
+ *
+ * Supports `fileName` for named file uploads via `uploadAndSendMediaLark`.
+ * On media upload failure, falls back to sending the URL as a text link.
+ */
+async function deliverMessage(cfg, sp, accountId, mediaLocalRoots) {
+    const { to, text, mediaUrl, fileName, replyToMessageId, replyInThread, card } = sp;
+    const payloadType = card ? 'card' : mediaUrl ? 'media' : 'text';
+    const target = to || replyToMessageId || 'unknown';
+    log.info(`deliverMessage: type=${payloadType}, target=${target}, ` +
+        `isReply=${Boolean(replyToMessageId)}, replyInThread=${replyInThread}, ` +
+        `textLen=${text.trim().length}, hasMedia=${Boolean(mediaUrl)}, ` +
+        `fileName=${fileName ?? '(none)'}`);
+    if (!text.trim() && !card && !mediaUrl) {
+        log.warn('deliverMessage: no payload, rejecting');
+        throw new Error('send requires at least one of: message, card, or media.');
+    }
+    const sendCtx = { cfg, to, replyToMessageId, replyInThread, accountId };
+    // Send text first if both text and card/media are present.
+    if (text.trim() && (card || mediaUrl)) {
+        log.info(`deliverMessage: sending preceding text ` + `(${text.length} chars) before ${payloadType}`);
+        await sendTextLark({ ...sendCtx, text });
+    }
+    // Card path.
+    if (card) {
+        const result = await sendCardLark({ ...sendCtx, card });
+        log.info(`deliverMessage: card sent, messageId=${result.messageId}`);
+        return jsonResult({ ok: true, messageId: result.messageId, chatId: result.chatId });
+    }
+    // Media path — uses uploadAndSendMediaLark directly to support fileName.
+    if (mediaUrl) {
+        return await deliverMedia(cfg, sp, accountId, mediaLocalRoots);
+    }
+    // Text-only path.
+    const result = await sendTextLark({ ...sendCtx, text });
+    log.info(`deliverMessage: text sent, messageId=${result.messageId}`);
+    return jsonResult({ ok: true, messageId: result.messageId, chatId: result.chatId });
+}
+/**
+ * Upload and send a media file with text-link fallback on failure.
+ */
+async function deliverMedia(cfg, sp, accountId, mediaLocalRoots) {
+    const { to, mediaUrl, fileName, replyToMessageId, replyInThread } = sp;
+    log.info(`deliverMedia: url=${mediaUrl}, fileName=${fileName ?? '(auto)'}`);
+    try {
+        const result = await uploadAndSendMediaLark({
+            cfg,
+            to,
+            mediaUrl,
+            fileName,
+            replyToMessageId,
+            replyInThread,
+            accountId,
+            mediaLocalRoots,
+        });
+        log.info(`deliverMedia: sent, messageId=${result.messageId}`);
+        return jsonResult({ ok: true, messageId: result.messageId, chatId: result.chatId });
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        log.error(`deliverMedia: upload failed for "${mediaUrl}": ${errMsg}`);
+        // Fallback: send the URL with error reason as a quote above.
+        log.info('deliverMedia: falling back to text link');
+        const fallback = await sendTextLark({
+            cfg,
+            to,
+            text: `> ${mediaUrl}`,
+            replyToMessageId,
+            replyInThread,
+            accountId,
+        });
+        return jsonResult({
+            ok: true,
+            messageId: fallback.messageId,
+            chatId: fallback.chatId,
+            warning: `Media upload failed (${errMsg}). A text link was sent instead.`,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Reaction handlers
+// ---------------------------------------------------------------------------
+async function handleReact(cfg, params, accountId) {
+    const messageId = readStringParam(params, 'messageId', { required: true });
+    const { emoji, remove, isEmpty } = readReactionParams(params, {
+        removeErrorMessage: 'Emoji is required to remove a Feishu reaction.',
+    });
+    if (remove || isEmpty) {
+        log.info(`react: removing emoji=${emoji || 'all'} from messageId=${messageId}`);
+        const reactions = await listReactionsFeishu({
+            cfg,
+            messageId,
+            emojiType: emoji || undefined,
+            accountId,
+        });
+        const botReactions = reactions.filter((r) => r.operatorType === 'app');
+        for (const r of botReactions) {
+            await removeReactionFeishu({
+                cfg,
+                messageId,
+                reactionId: r.reactionId,
+                accountId,
+            });
+        }
+        log.info(`react: removed ${botReactions.length} bot reaction(s)`);
+        return jsonResult({ ok: true, removed: botReactions.length });
+    }
+    log.info(`react: adding emoji=${emoji} to messageId=${messageId}`);
+    const { reactionId } = await addReactionFeishu({
+        cfg,
+        messageId,
+        emojiType: emoji,
+        accountId,
+    });
+    log.info(`react: added reactionId=${reactionId}`);
+    return jsonResult({ ok: true, reactionId });
+}
+async function handleReactions(cfg, params, accountId) {
+    const messageId = readStringParam(params, 'messageId', { required: true });
+    const emojiType = readStringParam(params, 'emoji');
+    const reactions = await listReactionsFeishu({
+        cfg,
+        messageId,
+        emojiType: emojiType || undefined,
+        accountId,
+    });
+    return jsonResult({
+        ok: true,
+        reactions: reactions.map((r) => ({
+            reactionId: r.reactionId,
+            emoji: r.emojiType,
+            operatorType: r.operatorType,
+            operatorId: r.operatorId,
+        })),
+    });
+}
+// ---------------------------------------------------------------------------
+// Delete
+// ---------------------------------------------------------------------------
+async function handleDelete(cfg, params, accountId) {
+    const messageId = readStringParam(params, 'messageId', { required: true });
+    log.info(`delete: messageId=${messageId}`);
+    const client = LarkClient.fromCfg(cfg, accountId).sdk;
+    const res = await client.im.message.delete({
+        path: { message_id: messageId },
+    });
+    assertLarkOk(res, `delete message ${messageId}`);
+    log.info(`delete: done, messageId=${messageId}`);
+    return jsonResult({ ok: true, messageId, deleted: true });
+}
+//# sourceMappingURL=actions.js.map

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

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

package/src/messaging/outbound/chat-manage.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Chat management for the Feishu/Lark channel plugin.
+ *
+ * Provides functions to update chat settings (name, avatar), manage
+ * members (add, remove, list) using the IM Chat API.
+ */
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+export interface FeishuChatMember {
+    /** Member ID (open_id by default). */
+    memberId: string;
+    /** Display name of the member. */
+    name: string;
+    /** ID type: "open_id", "union_id", or "user_id". */
+    memberIdType: string;
+}
+/**
+ * Update chat settings such as name or avatar.
+ */
+export declare function updateChatFeishu(params: {
+    cfg: OpenClawConfig;
+    chatId: string;
+    name?: string;
+    avatar?: string;
+    accountId?: string;
+}): Promise<void>;
+/**
+ * Add members to a chat by their open_id list.
+ */
+export declare function addChatMembersFeishu(params: {
+    cfg: OpenClawConfig;
+    chatId: string;
+    memberIds: string[];
+    accountId?: string;
+}): Promise<void>;
+/**
+ * Remove members from a chat by their open_id list.
+ */
+export declare function removeChatMembersFeishu(params: {
+    cfg: OpenClawConfig;
+    chatId: string;
+    memberIds: string[];
+    accountId?: string;
+}): Promise<void>;
+/**
+ * List members of a chat.
+ *
+ * Returns a single page (up to 100 members) to avoid unnecessary data
+ * overhead for large groups.  Use the returned `pageToken` to fetch
+ * subsequent pages when needed.
+ */
+export declare function listChatMembersFeishu(params: {
+    cfg: OpenClawConfig;
+    chatId: string;
+    accountId?: string;
+    /** Optional page token for pagination. */
+    pageToken?: string;
+}): Promise<{
+    members: FeishuChatMember[];
+    pageToken?: string;
+    hasMore: boolean;
+}>;
+//# sourceMappingURL=chat-manage.d.ts.map