@xwang152/claw-lark 0.1.11 → 0.1.13

package/dist/src/channel.js

@@ -0,0 +1,362 @@
+/**
+ * Lark Channel Plugin
+ *
+ * Implements the ChannelPlugin interface for Lark/Feishu integration.
+ * Provides account configuration, message sending, and gateway management.
+ */
+import { createLarkClient } from "./client.js";
+import { getLarkRuntime } from "./runtime.js";
+import { monitorLarkProvider } from "./monitor.js";
+// Default values for account configuration
+const DEFAULTS = {
+    domain: "feishu",
+    connectionMode: "websocket",
+    webhookPort: 3000,
+    dmPolicy: "pairing",
+    groupPolicy: "open",
+    requireMention: true,
+    mediaMaxMb: 30,
+    renderMode: "auto",
+    historyLimit: 10,
+};
+/**
+ * Extract Feishu channel config from OpenClaw config
+ */
+function getChannelConfig(cfg) {
+    return cfg.channels?.feishu ?? {};
+}
+/**
+ * Get account config from channel config, with empty object fallback
+ */
+function getAccountConfig(channelConfig, accountId) {
+    return channelConfig.accounts?.[accountId] ?? {};
+}
+/**
+ * Check if default account has env var credentials configured
+ */
+function hasEnvCredentials() {
+    return Boolean(process.env.LARK_APP_ID && process.env.LARK_APP_SECRET);
+}
+/**
+ * Resolve account configuration with defaults and env fallbacks.
+ * For "default" account, environment variables take precedence.
+ */
+function resolveAccount(cfg, accountId) {
+    const channelConfig = getChannelConfig(cfg);
+    const accountConfig = getAccountConfig(channelConfig, accountId);
+    // Resolve credentials - env vars as fallback for default account
+    const isDefault = accountId === "default";
+    const appId = accountConfig.appId ?? (isDefault ? process.env.LARK_APP_ID : undefined);
+    const appSecret = accountConfig.appSecret ?? (isDefault ? process.env.LARK_APP_SECRET : undefined);
+    const encryptKey = accountConfig.encryptKey ?? (isDefault ? process.env.LARK_ENCRYPT_KEY : undefined);
+    const verificationToken = accountConfig.verificationToken ?? (isDefault ? process.env.LARK_VERIFICATION_TOKEN : undefined);
+    const configured = Boolean(appId?.trim() && appSecret?.trim());
+    return {
+        accountId,
+        enabled: accountConfig.enabled ?? true,
+        configured,
+        appId: appId ?? "",
+        appSecret: appSecret ?? "",
+        encryptKey,
+        verificationToken,
+        domain: accountConfig.domain ?? DEFAULTS.domain,
+        connectionMode: accountConfig.connectionMode ?? DEFAULTS.connectionMode,
+        webhookPort: accountConfig.webhookPort ?? DEFAULTS.webhookPort,
+        dmPolicy: accountConfig.dmPolicy ?? DEFAULTS.dmPolicy,
+        dmAllowlist: accountConfig.dmAllowlist ?? [],
+        groupPolicy: accountConfig.groupPolicy ?? DEFAULTS.groupPolicy,
+        requireMention: accountConfig.requireMention ?? DEFAULTS.requireMention,
+        groupAllowlist: accountConfig.groupAllowlist ?? [],
+        mediaMaxMb: accountConfig.mediaMaxMb ?? DEFAULTS.mediaMaxMb,
+        renderMode: accountConfig.renderMode ?? DEFAULTS.renderMode,
+        historyLimit: accountConfig.historyLimit ?? DEFAULTS.historyLimit,
+    };
+}
+/**
+ * Determine receive_id_type from recipient ID format.
+ * IDs starting with "oc_" are chat IDs, otherwise open IDs.
+ */
+function inferReceiveIdType(recipientId) {
+    return recipientId.startsWith("oc_") ? "chat_id" : "open_id";
+}
+/**
+ * Send a message via Lark API, supporting text and interactive cards.
+ */
+async function sendTextMessage(account, recipientId, text, threadId) {
+    try {
+        const client = createLarkClient(account);
+        const renderMode = account.renderMode;
+        // Determine if we should use a card
+        const useCard = renderMode === "card" ||
+            (renderMode === "auto" && (text.includes("```") || text.includes("| --- |") || text.includes("\n- ")));
+        let msgType;
+        let content;
+        if (useCard) {
+            msgType = "interactive";
+            // Simple Markdown card
+            content = JSON.stringify({
+                header: {
+                    title: {
+                        tag: "plain_text",
+                        content: "OpenClaw",
+                    },
+                    template: "blue",
+                },
+                elements: [
+                    {
+                        tag: "div",
+                        text: {
+                            tag: "lark_md",
+                            content: text,
+                        },
+                    },
+                ],
+            });
+        }
+        else {
+            msgType = "text";
+            // Transform <at id="xxx">@Name</at> to Lark's plain text mention format: <at user_id="xxx">@Name</at>
+            const transformedText = text.replace(/<at id="([^"]+)">(@[^<]+)<\/at>/g, '<at user_id="$1">$2</at>');
+            content = JSON.stringify({ text: transformedText });
+        }
+        const response = await client.im.message.create({
+            params: {
+                receive_id_type: inferReceiveIdType(recipientId),
+            },
+            data: {
+                receive_id: recipientId,
+                msg_type: msgType,
+                content,
+                ...(threadId && { root_id: threadId }),
+            },
+        });
+        if (response.code === 0 && response.data) {
+            return { ok: true, messageId: response.data.message_id };
+        }
+        return { ok: false, error: response.msg ?? "Unknown error" };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+/**
+ * List available chat groups
+ */
+async function listGroups(account) {
+    try {
+        const client = createLarkClient(account);
+        const response = await client.im.chat.list({
+            params: { page_size: 100 },
+        });
+        if (response.code === 0 && response.data?.items) {
+            return response.data.items.map((chat) => ({
+                id: chat.chat_id ?? "",
+                name: chat.name ?? "Unknown",
+            }));
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Lark/Feishu channel plugin implementation
+ */
+export const larkPlugin = {
+    id: "feishu",
+    meta: {
+        label: "Feishu",
+        selectionLabel: "Feishu / Lark",
+        docsPath: "/channels/feishu",
+        blurb: "Chat with your OpenClaw bot on Feishu or Lark",
+        order: 75,
+    },
+    capabilities: {
+        chatTypes: ["direct", "group"],
+        reactions: false,
+        threads: true,
+        media: true,
+        nativeCommands: false,
+        streamingBlocked: false,
+    },
+    config: {
+        listAccountIds(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            const accountIds = Object.keys(channelConfig.accounts ?? {});
+            // Include default account if env vars are configured
+            if (!accountIds.includes("default") && hasEnvCredentials()) {
+                accountIds.push("default");
+            }
+            return accountIds;
+        },
+        resolveAccount(cfg, accountId) {
+            return resolveAccount(cfg, accountId ?? "default");
+        },
+        isConfigured(account) {
+            return account.configured;
+        },
+        setAccountEnabled(cfg, accountId, enabled) {
+            const channelConfig = getChannelConfig(cfg);
+            return {
+                ...cfg,
+                channels: {
+                    ...cfg.channels,
+                    lark: {
+                        ...channelConfig,
+                        accounts: {
+                            ...channelConfig.accounts,
+                            [accountId]: {
+                                ...channelConfig.accounts?.[accountId],
+                                enabled,
+                            },
+                        },
+                    },
+                },
+            };
+        },
+    },
+    outbound: {
+        deliveryMode: "direct",
+        textChunkLimit: 4000,
+        chunkerMode: "markdown",
+        async sendText(args) {
+            const { account, recipientId, text, threadId } = args;
+            return sendTextMessage(account, recipientId, text, threadId);
+        },
+        async sendMedia(args) {
+            const { account, recipientId, mediaId, mediaType, fileName, threadId } = args;
+            try {
+                const client = createLarkClient(account);
+                const response = await client.im.message.create({
+                    params: {
+                        receive_id_type: inferReceiveIdType(recipientId),
+                    },
+                    data: {
+                        receive_id: recipientId,
+                        msg_type: mediaType === "image" ? "image" : "file",
+                        content: JSON.stringify(mediaType === "image" ? { image_key: mediaId } : { file_key: mediaId, file_name: fileName }),
+                        ...(threadId && { root_id: threadId }),
+                    },
+                });
+                if (response.code === 0 && response.data) {
+                    return { ok: true, messageId: response.data.message_id };
+                }
+                return { ok: false, error: response.msg ?? "Unknown error" };
+            }
+            catch (error) {
+                return {
+                    ok: false,
+                    error: error instanceof Error ? error.message : "Unknown error",
+                };
+            }
+        },
+        async downloadMedia(args) {
+            const { account, mediaId, messageId } = args;
+            try {
+                const client = createLarkClient(account);
+                // For Lark, we usually need the message ID to get the file
+                if (!messageId)
+                    return null;
+                const response = await client.im.messageResource.get({
+                    path: {
+                        message_id: messageId,
+                        file_key: mediaId,
+                    },
+                    params: {
+                        type: args.mediaType,
+                    },
+                });
+                if (response instanceof Buffer) {
+                    return response;
+                }
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+    },
+    gateway: {
+        async startAccount(args) {
+            const { account, abortSignal } = args;
+            const api = getLarkRuntime();
+            if (!account.configured) {
+                api.logger.warn(`[feishu] Account ${account.accountId} not configured`);
+                return;
+            }
+            if (!account.enabled) {
+                api.logger.debug(`[feishu] Account ${account.accountId} disabled`);
+                return;
+            }
+            api.logger.info(`[feishu] Starting provider: account=${account.accountId}, mode=${account.connectionMode}, domain=${account.domain}`);
+            await monitorLarkProvider({ account, abortSignal });
+        },
+    },
+    directory: {
+        async listPeers(account) {
+            try {
+                const client = createLarkClient(account);
+                const response = await client.contact.user.list({
+                    params: { page_size: 50 },
+                });
+                if (response.code === 0 && response.data?.items) {
+                    return response.data.items.map((user) => ({
+                        id: user.open_id,
+                        name: user.name,
+                    }));
+                }
+                return [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async listGroups(account) {
+            return listGroups(account);
+        },
+        async resolveSelf() {
+            return null;
+        },
+    },
+    dmPolicy: {
+        mode(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            return channelConfig.accounts?.default?.dmPolicy ?? DEFAULTS.dmPolicy;
+        },
+        allowlist(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            return channelConfig.accounts?.default?.dmAllowlist ?? [];
+        },
+    },
+    groupPolicy: {
+        mode(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            return channelConfig.accounts?.default?.groupPolicy ?? DEFAULTS.groupPolicy;
+        },
+        mentionGated(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            return channelConfig.accounts?.default?.requireMention ?? DEFAULTS.requireMention;
+        },
+        allowlist(cfg) {
+            const channelConfig = getChannelConfig(cfg);
+            return channelConfig.accounts?.default?.groupAllowlist ?? [];
+        },
+    },
+    setup: {
+        validate(account) {
+            const errors = [];
+            if (!account.appId?.trim()) {
+                errors.push("App ID is required. Set via channels.lark.accounts.<id>.appId or LARK_APP_ID env var.");
+            }
+            if (!account.appSecret?.trim()) {
+                errors.push("App Secret is required. Set via channels.lark.accounts.<id>.appSecret or LARK_APP_SECRET env var.");
+            }
+            return errors;
+        },
+    },
+};
+//# sourceMappingURL=channel.js.map

package/dist/src/channel.js.map

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

package/dist/src/client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Lark SDK Client Factory
+ *
+ * Creates and caches Lark API clients. Supports both REST API
+ * and WebSocket clients for different use cases.
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+import type { ResolvedLarkAccount } from "./types.js";
+/**
+ * Create or retrieve a cached Lark REST API client.
+ *
+ * Clients are cached by appId + appSecret + domain to allow
+ * efficient reuse across multiple calls with the same account.
+ */
+export declare function createLarkClient(account: ResolvedLarkAccount): Lark.Client;
+/**
+ * Create a Lark WebSocket client for long-lived connections.
+ *
+ * WebSocket clients are NOT cached because they manage their own
+ * connection lifecycle and should be created fresh for each session.
+ */
+export declare function createLarkWSClient(account: ResolvedLarkAccount): Lark.WSClient;
+/**
+ * Create an event dispatcher for handling Lark webhook/websocket events.
+ */
+export declare function createEventDispatcher(encryptKey?: string, verificationToken?: string): Lark.EventDispatcher;
+/**
+ * Clear all cached clients.
+ * Useful for testing or when credentials change.
+ */
+export declare function clearClientCache(): void;

package/dist/src/client.js

@@ -0,0 +1,84 @@
+/**
+ * Lark SDK Client Factory
+ *
+ * Creates and caches Lark API clients. Supports both REST API
+ * and WebSocket clients for different use cases.
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+// REST client cache - keyed by appId:appSecret:domain
+const clientCache = new Map();
+/**
+ * Convert domain string to Lark SDK enum
+ */
+function toLarkDomain(domain) {
+    return domain === "feishu" ? Lark.Domain.Feishu : Lark.Domain.Lark;
+}
+/**
+ * Generate cache key for an account
+ */
+function cacheKey(account) {
+    return `${account.appId}:${account.appSecret}:${account.domain}`;
+}
+/**
+ * Validate account has required credentials
+ */
+function validateCredentials(account) {
+    if (!account.appId || !account.appSecret) {
+        throw new Error("Lark appId and appSecret are required");
+    }
+}
+/**
+ * Create or retrieve a cached Lark REST API client.
+ *
+ * Clients are cached by appId + appSecret + domain to allow
+ * efficient reuse across multiple calls with the same account.
+ */
+export function createLarkClient(account) {
+    validateCredentials(account);
+    const key = cacheKey(account);
+    const cached = clientCache.get(key);
+    if (cached) {
+        return cached;
+    }
+    const client = new Lark.Client({
+        appId: account.appId,
+        appSecret: account.appSecret,
+        appType: Lark.AppType.SelfBuild,
+        domain: toLarkDomain(account.domain),
+    });
+    clientCache.set(key, client);
+    return client;
+}
+/**
+ * Create a Lark WebSocket client for long-lived connections.
+ *
+ * WebSocket clients are NOT cached because they manage their own
+ * connection lifecycle and should be created fresh for each session.
+ */
+export function createLarkWSClient(account) {
+    validateCredentials(account);
+    return new Lark.WSClient({
+        appId: account.appId,
+        appSecret: account.appSecret,
+        domain: toLarkDomain(account.domain),
+        loggerLevel: Lark.LoggerLevel.info,
+        autoReconnect: true,
+    });
+}
+/**
+ * Create an event dispatcher for handling Lark webhook/websocket events.
+ */
+export function createEventDispatcher(encryptKey, verificationToken) {
+    return new Lark.EventDispatcher({
+        encryptKey,
+        verificationToken,
+    });
+}
+/**
+ * Clear all cached clients.
+ * Useful for testing or when credentials change.
+ */
+export function clearClientCache() {
+    clientCache.clear();
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAOhD,sDAAsD;AACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE3D;;GAEG;AACH,SAAS,YAAY,CAAC,MAAkB;IACtC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,OAA4B;IAC5C,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAA4B;IACvD,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA4B;IAC3D,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;QAC/B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;KACrC,CAAC,CAAC;IAEH,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;QACpC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;QAClC,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAmB,EACnB,iBAA0B;IAE1B,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9B,UAAU;QACV,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/src/monitor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lark Message Monitor
+ *
+ * Listens for incoming messages via WebSocket or webhook
+ * and routes them to the OpenClaw message handler.
+ */
+import type { ResolvedLarkAccount, LarkMessageEvent, ParsedMessage } from "./types.js";
+/**
+ * Extract plain text from Lark message content.
+ * Handles different message types (text, post/rich-text).
+ */
+export declare function extractText(content: string, messageType: string): string;
+/**
+ * Parse Lark message event into normalized format.
+ * Returns null for empty or invalid messages.
+ */
+export declare function parseMessage(event: LarkMessageEvent): ParsedMessage | null;
+/**
+ * Route incoming message to OpenClaw handler.
+ */
+export declare function routeMessage(event: LarkMessageEvent, account: ResolvedLarkAccount): Promise<void>;
+/**
+ * Start monitoring for Lark messages.
+ *
+ * Supports both WebSocket and webhook modes:
+ * - WebSocket: Long connection (enterprise accounts)
+ * - Webhook: HTTP callback (individual accounts, requires ngrok)
+ */
+export declare function monitorLarkProvider(options: {
+    account: ResolvedLarkAccount;
+    abortSignal?: AbortSignal;
+}): Promise<void>;
+/**
+ * Stop the active monitor connection.
+ */
+export declare function stopMonitor(): void;