@xwang152/claw-lark 0.1.12 → 0.1.13

package/dist/src/monitor.js

@@ -0,0 +1,212 @@
+/**
+ * Lark Message Monitor
+ *
+ * Listens for incoming messages via WebSocket or webhook
+ * and routes them to the OpenClaw message handler.
+ */
+import { createLarkWSClient, createEventDispatcher, createLarkClient } from "./client.js";
+import { getLarkRuntime } from "./runtime.js";
+import { startWebhookServer } from "./webhook.js";
+// Active connections for cleanup
+let activeWsClient = null;
+let activeWebhookServer = null;
+/**
+ * Extract plain text from Lark message content.
+ * Handles different message types (text, post/rich-text).
+ */
+export function extractText(content, messageType) {
+    try {
+        const parsed = JSON.parse(content);
+        if (messageType === "text") {
+            // Preserve mentions in text as @Name or <at id="xxx">@Name</at>
+            return parsed.text ?? "";
+        }
+        if (messageType === "post") {
+            // Rich text - flatten and extract text elements, including mentions
+            if (Array.isArray(parsed.content)) {
+                return parsed.content
+                    .flat()
+                    .map((item) => {
+                    if (item.tag === "text")
+                        return item.text;
+                    if (item.tag === "at")
+                        return item.user_name || `@${item.user_id}`;
+                    if (item.tag === "a")
+                        return `${item.text} (${item.href})`;
+                    return "";
+                })
+                    .join("");
+            }
+            return parsed.title ?? "";
+        }
+        // Unsupported message type - return placeholder
+        return `[${messageType} message]`;
+    }
+    catch {
+        // If JSON parsing fails, return raw content
+        return content;
+    }
+}
+/**
+ * Parse Lark message event into normalized format.
+ * Returns null for empty or invalid messages.
+ */
+export function parseMessage(event) {
+    const { message, sender } = event;
+    const text = extractText(message.content, message.message_type);
+    const media = [];
+    try {
+        const parsed = JSON.parse(message.content);
+        if (message.message_type === "image") {
+            media.push({
+                type: "image",
+                id: parsed.image_key,
+            });
+        }
+        else if (message.message_type === "file") {
+            media.push({
+                type: "file",
+                id: parsed.file_key,
+                fileName: parsed.file_name,
+            });
+        }
+    }
+    catch (error) {
+        // Ignore parsing errors for media
+    }
+    // If no text and no media, skip
+    if (!text.trim() && media.length === 0) {
+        return null;
+    }
+    return {
+        messageId: message.message_id,
+        chatId: message.chat_id,
+        chatType: message.chat_type,
+        senderId: sender.sender_id.open_id,
+        senderType: sender.sender_type,
+        text: text || `[${message.message_type}]`,
+        threadId: message.root_id,
+        mentions: (message.mentions ?? []).map((m) => ({
+            id: m.id.open_id,
+            name: m.name,
+        })),
+        timestamp: parseInt(message.create_time, 10),
+        media: media.length > 0 ? media : undefined,
+    };
+}
+/**
+ * Route incoming message to OpenClaw handler.
+ */
+export async function routeMessage(event, account) {
+    const api = getLarkRuntime();
+    const parsed = parseMessage(event);
+    if (!parsed) {
+        api.logger.debug("[feishu] Skipping empty or unparseable message");
+        return;
+    }
+    api.logger.info(`[feishu] Received message from ${parsed.senderId} in ${parsed.chatType} ${parsed.chatId}`);
+    // Add "typing" indicator (reaction)
+    const client = createLarkClient(account);
+    try {
+        await client.im.messageReaction.create({
+            path: { message_id: parsed.messageId },
+            data: {
+                reaction_type: {
+                    emoji_type: "TYPING", // Custom type or a common emoji like "COMMUNICATING"
+                },
+            },
+        });
+    }
+    catch (e) {
+        // Ignore reaction errors
+    }
+    await api.inbound.handleMessage({
+        channel: "feishu",
+        accountId: account.accountId,
+        messageId: parsed.messageId,
+        chatId: parsed.chatId,
+        chatType: parsed.chatType === "p2p" ? "direct" : "group",
+        senderId: parsed.senderId,
+        text: parsed.text,
+        threadId: parsed.threadId,
+        timestamp: parsed.timestamp,
+        mentions: parsed.mentions,
+        media: parsed.media,
+        raw: event,
+    });
+}
+/**
+ * Start WebSocket connection and listen for messages.
+ */
+async function startWebSocket(account, abortSignal) {
+    const api = getLarkRuntime();
+    api.logger.info(`[feishu] Starting WebSocket connection for account: ${account.accountId}`);
+    const wsClient = createLarkWSClient(account);
+    activeWsClient = wsClient;
+    const dispatcher = createEventDispatcher(account.encryptKey, account.verificationToken).register({
+        "im.message.receive_v1": async (data) => {
+            try {
+                await routeMessage(data, account);
+            }
+            catch (error) {
+                api.logger.error(`[feishu] Error handling message: ${error}`);
+            }
+        },
+    });
+    try {
+        await wsClient.start({ eventDispatcher: dispatcher });
+        api.logger.info("[feishu] WebSocket connection established");
+    }
+    catch (error) {
+        api.logger.error(`[feishu] WebSocket start failed: ${error}`);
+        throw error;
+    }
+    // Handle abort signal for graceful shutdown
+    if (abortSignal) {
+        abortSignal.addEventListener("abort", () => {
+            api.logger.info("[feishu] Stopping WebSocket (abort signal received)");
+            stopMonitor();
+        }, { once: true });
+    }
+}
+/**
+ * Start monitoring for Lark messages.
+ *
+ * Supports both WebSocket and webhook modes:
+ * - WebSocket: Long connection (enterprise accounts)
+ * - Webhook: HTTP callback (individual accounts, requires ngrok)
+ */
+export async function monitorLarkProvider(options) {
+    const { account, abortSignal } = options;
+    const api = getLarkRuntime();
+    if (account.connectionMode === "websocket") {
+        await startWebSocket(account, abortSignal);
+        return;
+    }
+    // Webhook mode - start HTTP server
+    api.logger.info("[feishu] Starting webhook server for individual account");
+    const webhookServer = await startWebhookServer({ account, abortSignal });
+    activeWebhookServer = webhookServer;
+    // Handle abort signal for graceful shutdown
+    if (abortSignal) {
+        abortSignal.addEventListener("abort", () => {
+            api.logger.info("[feishu] Stopping webhook server (abort signal received)");
+            webhookServer.stop();
+            activeWebhookServer = null;
+        }, { once: true });
+    }
+}
+/**
+ * Stop the active monitor connection.
+ */
+export function stopMonitor() {
+    if (activeWsClient) {
+        activeWsClient.close({ force: true });
+        activeWsClient = null;
+    }
+    if (activeWebhookServer) {
+        activeWebhookServer.stop();
+        activeWebhookServer = null;
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/src/monitor.js.map

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

package/dist/src/runtime.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lark Plugin Runtime
+ *
+ * Manages the plugin API context provided by OpenClaw.
+ * The API is set once during plugin registration and
+ * provides access to logging, inbound message handling, etc.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+/**
+ * Initialize the Lark plugin with the API context.
+ * Called once during plugin registration.
+ */
+export declare function setLarkRuntime(api: OpenClawPluginApi): void;
+/**
+ * Get the current plugin API.
+ * Throws if called before plugin registration.
+ */
+export declare function getLarkRuntime(): OpenClawPluginApi;
+/**
+ * Check if runtime has been initialized.
+ * Useful for conditional logic without throwing.
+ */
+export declare function hasLarkRuntime(): boolean;

package/dist/src/runtime.js

@@ -0,0 +1,33 @@
+/**
+ * Lark Plugin Runtime
+ *
+ * Manages the plugin API context provided by OpenClaw.
+ * The API is set once during plugin registration and
+ * provides access to logging, inbound message handling, etc.
+ */
+let pluginApi = null;
+/**
+ * Initialize the Lark plugin with the API context.
+ * Called once during plugin registration.
+ */
+export function setLarkRuntime(api) {
+    pluginApi = api;
+}
+/**
+ * Get the current plugin API.
+ * Throws if called before plugin registration.
+ */
+export function getLarkRuntime() {
+    if (!pluginApi) {
+        throw new Error("Lark runtime not initialized. Ensure the plugin is properly registered.");
+    }
+    return pluginApi;
+}
+/**
+ * Check if runtime has been initialized.
+ * Useful for conditional logic without throwing.
+ */
+export function hasLarkRuntime() {
+    return pluginApi !== null;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,IAAI,SAAS,GAA6B,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,SAAS,GAAG,GAAG,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,KAAK,IAAI,CAAC;AAC5B,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Lark/Feishu Plugin Type Definitions
+ *
+ * Core types for Lark/Feishu integration with OpenClaw.
+ * Designed for clarity and minimal redundancy.
+ */
+export type LarkDomain = "lark" | "feishu";
+export type LarkConnectionMode = "websocket" | "webhook";
+export type DmPolicy = "open" | "pairing" | "allowlist";
+export type GroupPolicy = "open" | "allowlist" | "disabled";
+export type RenderMode = "auto" | "raw" | "card";
+/**
+ * Raw account configuration from channels.lark.accounts.<id>
+ * All fields are optional - defaults applied during resolution.
+ */
+export interface LarkAccountConfig {
+    enabled?: boolean;
+    appId?: string;
+    appSecret?: string;
+    encryptKey?: string;
+    verificationToken?: string;
+    domain?: LarkDomain;
+    connectionMode?: LarkConnectionMode;
+    webhookPort?: number;
+    dmPolicy?: DmPolicy;
+    dmAllowlist?: string[];
+    groupPolicy?: GroupPolicy;
+    requireMention?: boolean;
+    groupAllowlist?: string[];
+    mediaMaxMb?: number;
+    renderMode?: RenderMode;
+    historyLimit?: number;
+}
+/**
+ * Fully resolved account with all defaults applied.
+ * Used throughout the plugin after initial resolution.
+ */
+export interface ResolvedLarkAccount {
+    accountId: string;
+    enabled: boolean;
+    configured: boolean;
+    appId: string;
+    appSecret: string;
+    encryptKey?: string;
+    verificationToken?: string;
+    domain: LarkDomain;
+    connectionMode: LarkConnectionMode;
+    webhookPort: number;
+    dmPolicy: DmPolicy;
+    dmAllowlist: string[];
+    groupPolicy: GroupPolicy;
+    requireMention: boolean;
+    groupAllowlist: string[];
+    mediaMaxMb: number;
+    renderMode: RenderMode;
+    historyLimit: number;
+}
+/**
+ * Top-level Feishu channel configuration in channels.lark
+ */
+export interface LarkChannelConfig {
+    enabled?: boolean;
+    accounts?: Record<string, LarkAccountConfig>;
+}
+/**
+ * Lark message event payload from im.message.receive_v1
+ * Matches the official Lark SDK event structure.
+ */
+export interface LarkMessageEvent {
+    sender: {
+        sender_id: {
+            open_id: string;
+            user_id?: string;
+            union_id?: string;
+        };
+        sender_type: string;
+        tenant_key: string;
+    };
+    message: {
+        message_id: string;
+        root_id?: string;
+        parent_id?: string;
+        create_time: string;
+        update_time?: string;
+        chat_id: string;
+        chat_type: "p2p" | "group";
+        message_type: string;
+        content: string;
+        mentions?: LarkMention[];
+    };
+}
+/**
+ * Mention data within a Lark message
+ */
+export interface LarkMention {
+    key: string;
+    id: {
+        open_id: string;
+        user_id?: string;
+        union_id?: string;
+    };
+    name: string;
+    tenant_key: string;
+}
+/**
+ * Normalized message format for OpenClaw routing.
+ */
+export interface ParsedMessage {
+    messageId: string;
+    chatId: string;
+    chatType: "p2p" | "group";
+    senderId: string;
+    senderType: string;
+    text: string;
+    threadId?: string;
+    mentions: Array<{
+        id: string;
+        name: string;
+    }>;
+    timestamp: number;
+    media?: Array<{
+        type: "image" | "file";
+        id: string;
+        fileName?: string;
+        mimeType?: string;
+        size?: number;
+    }>;
+}
+/**
+ * Result of a message send operation.
+ */
+export interface SendResult {
+    ok: boolean;
+    messageId?: string;
+    error?: string;
+}

package/dist/src/types.js

@@ -0,0 +1,8 @@
+/**
+ * Lark/Feishu Plugin Type Definitions
+ *
+ * Core types for Lark/Feishu integration with OpenClaw.
+ * Designed for clarity and minimal redundancy.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/webhook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Lark/Feishu Webhook Server
+ *
+ * Standalone HTTP server for receiving Lark/Feishu webhook callbacks.
+ * Used for individual accounts that don't support WebSocket.
+ * Includes automatic crash recovery.
+ */
+import * as http from "node:http";
+import type { ResolvedLarkAccount } from "./types.js";
+interface WebhookServer {
+    server: http.Server | null;
+    port: number;
+    stop: () => void;
+}
+/**
+ * Start the webhook server.
+ */
+export declare function startWebhookServer(args: {
+    account: ResolvedLarkAccount;
+    abortSignal?: AbortSignal;
+}): Promise<WebhookServer>;
+export {};

package/dist/src/webhook.js

@@ -0,0 +1,131 @@
+/**
+ * Lark/Feishu Webhook Server
+ *
+ * Standalone HTTP server for receiving Lark/Feishu webhook callbacks.
+ * Used for individual accounts that don't support WebSocket.
+ * Includes automatic crash recovery.
+ */
+import * as http from "node:http";
+import * as crypto from "node:crypto";
+import { getLarkRuntime } from "./runtime.js";
+import { routeMessage } from "./monitor.js";
+const RESTART_DELAY_MS = 3000;
+const MAX_RESTART_ATTEMPTS = 5;
+/**
+ * Decrypt AES-256-CBC encrypted event data from Lark.
+ */
+function decryptEvent(encrypted, encryptKey) {
+    const key = crypto.createHash("sha256").update(encryptKey).digest();
+    const encryptedBuffer = Buffer.from(encrypted, "base64");
+    const iv = encryptedBuffer.subarray(0, 16);
+    const ciphertext = encryptedBuffer.subarray(16);
+    const decipher = crypto.createDecipheriv("aes-256-cbc", key, iv);
+    let decrypted = decipher.update(ciphertext, undefined, "utf8");
+    decrypted += decipher.final("utf8");
+    return decrypted;
+}
+/**
+ * Parse request body as JSON.
+ */
+async function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+            try {
+                const body = Buffer.concat(chunks).toString("utf8");
+                if (!body)
+                    return resolve({});
+                resolve(JSON.parse(body));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        req.on("error", reject);
+    });
+}
+/**
+ * Start the webhook server.
+ */
+export async function startWebhookServer(args) {
+    const { account, abortSignal } = args;
+    const api = getLarkRuntime();
+    const port = account.webhookPort;
+    let restartAttempts = 0;
+    const server = http.createServer(async (req, res) => {
+        if (req.method !== "POST") {
+            res.statusCode = 405;
+            res.end("Method Not Allowed");
+            return;
+        }
+        try {
+            let body = await parseBody(req);
+            // Handle encrypted events
+            if (body.encrypt && account.encryptKey) {
+                const decrypted = decryptEvent(body.encrypt, account.encryptKey);
+                body = JSON.parse(decrypted);
+            }
+            // Handle URL challenge
+            if (body.type === "url_verification") {
+                res.setHeader("Content-Type", "application/json");
+                res.end(JSON.stringify({ challenge: body.challenge }));
+                return;
+            }
+            // Verify token
+            if (account.verificationToken && body.header?.token !== account.verificationToken) {
+                api.logger.warn("[feishu] Webhook token mismatch");
+                res.statusCode = 401;
+                res.end("Unauthorized");
+                return;
+            }
+            // Process event
+            const eventType = body.header?.event_type;
+            if (eventType === "im.message.receive_v1") {
+                await routeMessage(body.event, account);
+            }
+            res.statusCode = 200;
+            res.end("OK");
+        }
+        catch (error) {
+            api.logger.error(`[feishu] Webhook error: ${error}`);
+            res.statusCode = 500;
+            res.end("Internal Server Error");
+        }
+    });
+    const stop = () => {
+        if (server.listening) {
+            server.close();
+            api.logger.info(`[feishu] Webhook server stopped on port ${port}`);
+        }
+    };
+    abortSignal?.addEventListener("abort", stop);
+    const start = () => {
+        server.listen(port, () => {
+            api.logger.info(`[feishu] Webhook server listening on port ${port}`);
+            restartAttempts = 0;
+        });
+    };
+    server.on("error", (err) => {
+        api.logger.error(`[feishu] Webhook server error: ${err}`);
+        if (err.code === "EADDRINUSE") {
+            api.logger.error(`[feishu] Port ${port} is already in use`);
+            return;
+        }
+        if (restartAttempts < MAX_RESTART_ATTEMPTS) {
+            restartAttempts++;
+            api.logger.info(`[feishu] Restarting webhook server in ${RESTART_DELAY_MS}ms...`);
+            setTimeout(start, RESTART_DELAY_MS);
+        }
+        else {
+            api.logger.error("[feishu] Max webhook server restart attempts reached");
+        }
+    });
+    start();
+    return {
+        server,
+        port,
+        stop,
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/src/webhook.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xwang152/claw-lark",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "type": "module",
   "description": "Lark/Feishu channel plugin for OpenClaw with WebSocket and Webhook support",
   "license": "MIT",
@@ -25,8 +25,16 @@
       "./dist/index.js"
     ]
   },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md",
+    "README_zh.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint src/**/*.ts index.ts --no-warn-ignored",
     "format": "prettier --write src/**/*.ts index.ts",

package/.eslintrc.json

@@ -1,18 +0,0 @@
-{
-  "parser": "@typescript-eslint/parser",
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:prettier/recommended"
-  ],
-  "plugins": ["@typescript-eslint", "prettier"],
-  "rules": {
-    "prettier/prettier": "error",
-    "@typescript-eslint/no-explicit-any": "warn",
-    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
-  },
-  "env": {
-    "node": true,
-    "es2022": true
-  }
-}

package/.github/workflows/npm-publish.yml

@@ -1,39 +0,0 @@
-name: Node.js Package Publish
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Check if version exists on npm
-        id: check_version
-        run: |
-          VERSION=$(node -p "require('./package.json').version")
-          NAME=$(node -p "require('./package.json').name")
-          if npm view "$NAME@$VERSION" version >/dev/null 2>&1; then
-            echo "Version $VERSION already exists on npm. Skipping publish."
-            echo "exists=true" >> $GITHUB_OUTPUT
-          else
-            echo "Version $VERSION is new. Proceeding to publish."
-            echo "exists=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Publish to npm
-        if: steps.check_version.outputs.exists == 'false'
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}