@downcity/plugins 1.0.4

package/bin/chat/channels/feishu/FeishuPlatformClient.js

@@ -0,0 +1,316 @@
+/**
+ * FeishuPlatformClient：飞书平台连接与消息能力封装。
+ *
+ * 关键点（中文）
+ * - 负责 SDK client / WS client、token 缓存、启动停止与 runtime 状态。
+ * - 查询类能力与发送类能力已经拆到旁路模块，当前文件只保留平台宿主职责。
+ * - `FeishuBot` 只调用这里暴露的平台能力，不再直接持有底层 Feishu 连接细节。
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+import { downloadFeishuIncomingAttachments, resolveFeishuChatTitle, resolveFeishuReplyContext, resolveFeishuSenderName, } from "./FeishuPlatformLookup.js";
+import { sendFeishuAttachment, sendFeishuPlatformMessage, } from "./FeishuPlatformMessaging.js";
+const FEISHU_INBOUND_ACK_REACTION_TYPE = "OK";
+/**
+ * 飞书平台 client。
+ */
+export class FeishuPlatformClient {
+    context;
+    rootPath;
+    logger;
+    appId;
+    appSecret;
+    domain;
+    onMessage;
+    client = null;
+    wsClient = null;
+    isRunning = false;
+    messageCleanupInterval = null;
+    appAccessToken = "";
+    appAccessTokenExpiresAtMs = 0;
+    chatTitleByChatId = new Map();
+    senderNameBySenderKey = new Map();
+    lookupWarnings = new Set();
+    constructor(options) {
+        this.context = options.context;
+        this.rootPath = options.context.rootPath;
+        this.logger = options.context.logger;
+        this.appId = options.config.appId;
+        this.appSecret = options.config.appSecret;
+        this.domain = options.config.domain;
+        this.onMessage = options.onMessage;
+    }
+    /**
+     * 获取 runtime 快照。
+     */
+    getExecutorStatus() {
+        const running = this.isRunning;
+        const hasClients = Boolean(this.client && this.wsClient);
+        const linkState = running && hasClients ? "connected" : running ? "unknown" : "disconnected";
+        return {
+            running,
+            linkState,
+            statusText: linkState === "connected"
+                ? "ws_online"
+                : linkState === "unknown"
+                    ? "starting"
+                    : "stopped",
+            detail: {
+                hasClient: Boolean(this.client),
+                hasWsClient: Boolean(this.wsClient),
+                cachedChatTitleCount: this.chatTitleByChatId.size,
+                cachedSenderNameCount: this.senderNameBySenderKey.size,
+            },
+        };
+    }
+    /**
+     * 连通性测试。
+     */
+    async testConnection() {
+        const startedAt = Date.now();
+        if (!this.appId || !this.appSecret) {
+            return {
+                channel: "feishu",
+                success: false,
+                testedAtMs: startedAt,
+                message: "App credentials are missing",
+            };
+        }
+        const domain = this.domain || "https://open.feishu.cn";
+        const endpoint = `${domain.replace(/\/+$/, "")}/open-apis/auth/v3/app_access_token/internal`;
+        try {
+            const response = await fetch(endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    app_id: this.appId,
+                    app_secret: this.appSecret,
+                }),
+            });
+            const raw = await response.text();
+            const now = Date.now();
+            let code;
+            let msg;
+            try {
+                const parsed = JSON.parse(raw);
+                code = typeof parsed.code === "number" ? parsed.code : undefined;
+                msg = typeof parsed.msg === "string" ? parsed.msg : undefined;
+            }
+            catch {
+                // ignore parse error
+            }
+            if (response.ok && (code === 0 || code === undefined)) {
+                return {
+                    channel: "feishu",
+                    success: true,
+                    testedAtMs: now,
+                    latencyMs: now - startedAt,
+                    message: "Connected to Feishu Open API",
+                    detail: {
+                        httpStatus: response.status,
+                        code: code ?? null,
+                    },
+                };
+            }
+            return {
+                channel: "feishu",
+                success: false,
+                testedAtMs: now,
+                latencyMs: now - startedAt,
+                message: `Feishu API check failed: HTTP ${response.status}${msg ? ` ${msg}` : ""}`,
+                detail: {
+                    httpStatus: response.status,
+                    code: code ?? null,
+                },
+            };
+        }
+        catch (error) {
+            const now = Date.now();
+            return {
+                channel: "feishu",
+                success: false,
+                testedAtMs: now,
+                latencyMs: now - startedAt,
+                message: `Feishu API check failed: ${String(error)}`,
+            };
+        }
+    }
+    /**
+     * 启动平台连接。
+     */
+    async start(processedMessages) {
+        if (this.isRunning) {
+            this.logger.warn("Feishu Bot is already running, skipping duplicate startup");
+            return;
+        }
+        this.isRunning = true;
+        const baseConfig = {
+            appId: this.appId,
+            appSecret: this.appSecret,
+            domain: this.domain || "https://open.feishu.cn",
+        };
+        this.client = new Lark.Client(baseConfig);
+        this.wsClient = new Lark.WSClient(baseConfig);
+        const eventDispatcher = new Lark.EventDispatcher({}).register({
+            "im.message.receive_v1": async (data) => {
+                await this.onMessage(data);
+            },
+        });
+        this.wsClient.start({ eventDispatcher });
+        this.logger.info("Feishu Bot started, using long connection mode");
+        this.messageCleanupInterval = setInterval(() => {
+            if (processedMessages.size > 1000) {
+                processedMessages.clear();
+                this.logger.debug("Cleared message deduplication cache");
+            }
+        }, 5 * 60 * 1000);
+    }
+    /**
+     * 停止平台连接。
+     */
+    async stop() {
+        this.isRunning = false;
+        if (this.messageCleanupInterval) {
+            clearInterval(this.messageCleanupInterval);
+            this.messageCleanupInterval = null;
+        }
+        if (this.wsClient) {
+            this.logger.info("Feishu Bot stopped");
+        }
+    }
+    /**
+     * 给入站消息补一个轻量 ack reaction。
+     */
+    async sendInboundAckReaction(params) {
+        const messageId = String(params.messageId || "").trim();
+        if (!messageId || !this.client?.im?.v1?.messageReaction?.create)
+            return;
+        try {
+            await this.client.im.v1.messageReaction.create({
+                path: { message_id: messageId },
+                data: {
+                    reaction_type: {
+                        emoji_type: FEISHU_INBOUND_ACK_REACTION_TYPE,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            this.logger.warn("飞书入站 ack reaction 失败，继续处理消息", {
+                messageId,
+                reactionType: FEISHU_INBOUND_ACK_REACTION_TYPE,
+                error: String(error),
+            });
+        }
+    }
+    /**
+     * 解析发送者姓名。
+     */
+    async resolveSenderName(params) {
+        return resolveFeishuSenderName(this.getLookupDeps(), params);
+    }
+    /**
+     * 解析群聊/会话标题。
+     */
+    async resolveChatTitle(chatId) {
+        return resolveFeishuChatTitle(this.getLookupDeps(), chatId);
+    }
+    /**
+     * 查询 reply 的父消息上下文。
+     */
+    async resolveReplyContext(params) {
+        return resolveFeishuReplyContext(this.getLookupDeps(), params);
+    }
+    /**
+     * 下载入站附件。
+     */
+    async downloadIncomingAttachments(params) {
+        return downloadFeishuIncomingAttachments(this.getLookupDeps(), params);
+    }
+    /**
+     * 发送附件。
+     */
+    async sendAttachment(chatId, chatType, messageId, attachment) {
+        return sendFeishuAttachment(this.getMessagingDeps(), chatId, chatType, messageId, attachment);
+    }
+    /**
+     * 发送平台消息。
+     */
+    async sendPlatformMessage(chatId, chatType, messageId, msgType, content) {
+        return sendFeishuPlatformMessage(this.getMessagingDeps(), chatId, chatType, messageId, msgType, content);
+    }
+    /**
+     * 获取 tenant_access_token。
+     */
+    async getAppAccessToken() {
+        const now = Date.now();
+        if (this.appAccessToken && this.appAccessTokenExpiresAtMs > now + 10_000) {
+            return this.appAccessToken;
+        }
+        const domain = this.getNormalizedDomain();
+        try {
+            const response = await fetch(`${domain}/open-apis/auth/v3/tenant_access_token/internal`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    app_id: this.appId,
+                    app_secret: this.appSecret,
+                }),
+            });
+            const payload = (await response.json().catch(() => null));
+            const token = typeof payload?.tenant_access_token === "string"
+                ? payload.tenant_access_token.trim()
+                : "";
+            if (!response.ok || payload?.code !== 0 || !token) {
+                this.logger.debug("Feishu tenant_access_token 获取失败", {
+                    httpStatus: response.status,
+                    code: payload?.code,
+                    msg: payload?.msg,
+                });
+                return undefined;
+            }
+            const expireSeconds = typeof payload?.expire === "number" && Number.isFinite(payload.expire)
+                ? payload.expire
+                : 7200;
+            this.appAccessToken = token;
+            this.appAccessTokenExpiresAtMs = Date.now() + Math.max(60, expireSeconds) * 1000;
+            return token;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 为 lookup helper 构造依赖集合。
+     */
+    getLookupDeps() {
+        return {
+            rootPath: this.rootPath,
+            logger: this.logger,
+            client: this.client,
+            getAppAccessToken: () => this.getAppAccessToken(),
+            getNormalizedDomain: () => this.getNormalizedDomain(),
+            senderNameBySenderKey: this.senderNameBySenderKey,
+            chatTitleByChatId: this.chatTitleByChatId,
+            lookupWarnings: this.lookupWarnings,
+        };
+    }
+    /**
+     * 为 messaging helper 构造依赖集合。
+     */
+    getMessagingDeps() {
+        return {
+            rootPath: this.rootPath,
+            logger: this.logger,
+            client: this.client,
+            getAppAccessToken: () => this.getAppAccessToken(),
+            getNormalizedDomain: () => this.getNormalizedDomain(),
+        };
+    }
+    /**
+     * 归一化 domain。
+     */
+    getNormalizedDomain() {
+        return (this.domain || "https://open.feishu.cn").replace(/\/+$/, "");
+    }
+}
+//# sourceMappingURL=FeishuPlatformClient.js.map

package/bin/chat/channels/feishu/FeishuPlatformClient.js.map

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

package/bin/chat/channels/feishu/FeishuPlatformLookup.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Feishu 平台查询与入站附件辅助函数。
+ *
+ * 关键点（中文）
+ * - 发送者姓名、群标题、reply 上下文、附件下载都属于“读取型平台能力”。
+ * - `FeishuPlatformClient` 只保留运行时状态与 token 管理，这里负责具体 OpenAPI 查询细节。
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { FeishuDownloadedAttachment } from "../../../chat/channels/feishu/types/FeishuChannel.js";
+import type { FeishuIncomingAttachmentDescriptor } from "../../../chat/types/FeishuInboundAttachment.js";
+import type { InboundReplyContext } from "../../../chat/types/ReplyContext.js";
+/**
+ * Feishu 查询类依赖。
+ */
+export interface FeishuLookupDeps {
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 日志器。
+     */
+    logger: {
+        /**
+         * 记录 warn 日志。
+         */
+        warn(message: string, data?: JsonObject): void;
+        /**
+         * 记录 debug 日志。
+         */
+        debug(message: string, data?: JsonObject): void;
+    };
+    /**
+     * Feishu SDK client。
+     */
+    client: Lark.Client | null;
+    /**
+     * 获取 tenant_access_token 的回调。
+     */
+    getAppAccessToken: () => Promise<string | undefined>;
+    /**
+     * 归一化 domain 的回调。
+     */
+    getNormalizedDomain: () => string;
+    /**
+     * 发送者姓名缓存。
+     */
+    senderNameBySenderKey: Map<string, string>;
+    /**
+     * 群标题缓存。
+     */
+    chatTitleByChatId: Map<string, string>;
+    /**
+     * once warning 去重集合。
+     */
+    lookupWarnings: Set<string>;
+}
+/**
+ * 解析发送者姓名。
+ */
+export declare function resolveFeishuSenderName(deps: FeishuLookupDeps, params: {
+    /**
+     * 发送者 ID。
+     */
+    senderId?: string;
+    /**
+     * ID 类型。
+     */
+    idType?: "open_id" | "user_id" | "union_id";
+    /**
+     * 可选 chatId，用于成员列表兜底查询。
+     */
+    chatId?: string;
+}): Promise<string | undefined>;
+/**
+ * 解析群聊/会话标题。
+ */
+export declare function resolveFeishuChatTitle(deps: FeishuLookupDeps, chatId: string): Promise<string | undefined>;
+/**
+ * 查询 reply 的父消息上下文。
+ */
+export declare function resolveFeishuReplyContext(deps: FeishuLookupDeps, params: {
+    /**
+     * 父消息 ID。
+     */
+    parentMessageId?: string;
+}): Promise<InboundReplyContext | undefined>;
+/**
+ * 下载入站附件。
+ */
+export declare function downloadFeishuIncomingAttachments(deps: FeishuLookupDeps, params: {
+    /**
+     * 当前消息 ID。
+     */
+    messageId: string;
+    /**
+     * 待下载附件列表。
+     */
+    attachments: FeishuIncomingAttachmentDescriptor[];
+}): Promise<FeishuDownloadedAttachment[]>;
+//# sourceMappingURL=FeishuPlatformLookup.d.ts.map

package/bin/chat/channels/feishu/FeishuPlatformLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPlatformLookup.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/FeishuPlatformLookup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC/C;;WAEG;QACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KACjD,CAAC;IACF;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC;;OAEG;IACH,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;OAEG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAwHD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4G7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiE7B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAiE1C;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,kCAAkC,EAAE,CAAC;CACnD,GACA,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA0CvC"}