@downcity/agent 1.1.25 → 1.1.35

package/bin/plugin/builtins/chat/channels/feishu/FeishuMessageHandler.js

@@ -0,0 +1,247 @@
+/**
+ * Feishu 入站消息处理器。
+ *
+ * 关键点（中文）
+ * - 负责单条飞书消息的去重、解析、授权、附件保存与执行入队。
+ * - 不持有 `FeishuBot` 实例；所有副作用通过显式依赖注入。
+ * - 解析失败/执行失败通过渠道门面提供的发送函数回写错误消息。
+ */
+import path from "path";
+import { buildReplyContextExtra, buildReplyContextInstruction, } from "../../../../../plugin/builtins/chat/runtime/ReplyContextFormatter.js";
+import { augmentChatInboundInput, buildChatInboundText, } from "../../../../../plugin/builtins/chat/runtime/InboundAugment.js";
+import { renderChatMessageFileTag } from "../../../../../plugin/builtins/chat/runtime/ChatMessageMarkup.js";
+import { parseFeishuInboundMessage } from "./InboundAttachment.js";
+import { extractFeishuSenderIdentity, isFeishuGroupChat, stripFeishuAtMentions, } from "./FeishuInbound.js";
+/**
+ * 处理 Feishu 入站消息。
+ */
+export async function handleFeishuMessage(options, data) {
+    try {
+        if (!data?.message)
+            return;
+        const { message: { chat_id, content, message_type, chat_type, message_id, parent_id, }, } = data;
+        const threadId = options.buildChatKey(chat_id);
+        const senderIdentity = extractFeishuSenderIdentity(data);
+        const actorId = senderIdentity.senderId;
+        const normalizedMessageId = String(message_id || "").trim();
+        if (!normalizedMessageId)
+            return;
+        if (!actorId) {
+            options.logger.warn("飞书消息缺少发送者 userId/open_id，已忽略", {
+                chatId: chat_id,
+                chatType: chat_type,
+                messageId: normalizedMessageId,
+            });
+            return;
+        }
+        if (options.processedMessages.has(normalizedMessageId)) {
+            options.logger.debug(`Message already processed, skipping: ${normalizedMessageId}`);
+            return;
+        }
+        const persisted = await options.loadDedupeSet(threadId);
+        if (persisted.has(normalizedMessageId)) {
+            options.logger.debug(`Message already processed (persisted), skipping: ${normalizedMessageId}`);
+            return;
+        }
+        if (options.processingMessages.has(normalizedMessageId)) {
+            options.logger.debug(`Message is already being processed, skipping duplicate delivery: ${normalizedMessageId}`);
+            return;
+        }
+        options.processingMessages.add(normalizedMessageId);
+        let handled = false;
+        try {
+            let parsedInput;
+            try {
+                parsedInput = await parseIncomingMessage({
+                    options,
+                    chatId: chat_id,
+                    chatType: chat_type,
+                    messageId: message_id,
+                    messageType: message_type,
+                    content,
+                    parentMessageId: parent_id,
+                });
+            }
+            catch (error) {
+                await options.sendErrorMessage({
+                    chatId: chat_id,
+                    chatType: chat_type,
+                    messageId: message_id,
+                    errorText: `Failed to parse message: ${String(error)}`,
+                });
+                handled = true;
+                return;
+            }
+            if (parsedInput.alreadyHandled) {
+                handled = true;
+                return;
+            }
+            const handledByAuth = await handleAuthorizedMessage({
+                options,
+                data,
+                threadId,
+                senderIdentity,
+                actorId,
+                chatId: chat_id,
+                chatType: chat_type,
+                messageId: message_id,
+                ...parsedInput,
+            });
+            handled = handledByAuth;
+        }
+        finally {
+            options.processingMessages.delete(normalizedMessageId);
+            if (handled) {
+                options.processedMessages.add(normalizedMessageId);
+                persisted.add(normalizedMessageId);
+                await options.persistDedupeSet(threadId, persisted);
+            }
+        }
+    }
+    catch (error) {
+        options.logger.error("Failed to process Feishu message", {
+            error: String(error),
+        });
+    }
+}
+/**
+ * 解析入站消息文本、附件和 reply 上下文。
+ */
+async function parseIncomingMessage(params) {
+    const parsed = parseFeishuInboundMessage({
+        messageType: params.messageType,
+        content: params.content,
+    });
+    if (parsed.unsupportedType) {
+        await params.options.sendErrorMessage({
+            chatId: params.chatId,
+            chatType: params.chatType,
+            messageId: params.messageId,
+            errorText: `Unsupported Feishu message type: ${parsed.unsupportedType}`,
+        });
+        return {
+            userMessage: "",
+            incomingAttachments: [],
+            alreadyHandled: true,
+        };
+    }
+    return {
+        userMessage: parsed.text,
+        incomingAttachments: await params.options.downloadIncomingAttachments({
+            messageId: params.messageId,
+            attachments: parsed.attachments,
+        }),
+        replyContext: await params.options.resolveReplyContext({
+            parentMessageId: params.parentMessageId,
+        }),
+    };
+}
+/**
+ * 授权后处理消息内容。
+ */
+async function handleAuthorizedMessage(params) {
+    const { options, threadId, senderIdentity, actorId, chatId, chatType, messageId, incomingAttachments, replyContext, } = params;
+    let userMessage = params.userMessage;
+    options.logger.info(`Received Feishu message: ${userMessage || "[attachment]"}`);
+    const actorName = (await options.resolveSenderName({
+        ...senderIdentity,
+        chatId,
+    })) || undefined;
+    const resolvedChatTitle = await options.resolveChatTitle(chatId);
+    const chatTitle = resolvedChatTitle || (chatType === "p2p" ? actorName : undefined);
+    await options.observeIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actorId,
+        username: actorName,
+    });
+    const authResult = await options.evaluateIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actorId,
+        username: actorName,
+    });
+    if (authResult.decision !== "allow") {
+        if (chatType === "p2p") {
+            await options.sendAuthorizationText({
+                chatId,
+                chatType,
+                text: options.buildUnauthorizedBlockedText({
+                    chatId,
+                    chatType,
+                    userId: actorId,
+                }),
+            });
+        }
+        return true;
+    }
+    options.rememberChat(threadId, {
+        chatId,
+        chatType,
+        ...(chatTitle ? { chatTitle } : {}),
+    });
+    await options.sendInboundAckReaction({ messageId });
+    await options.runInChat(threadId, async () => {
+        if (userMessage.startsWith("/") && incomingAttachments.length === 0) {
+            await options.handleCommand({
+                chatId,
+                chatType,
+                messageId,
+                command: userMessage,
+            });
+            return;
+        }
+        const attachmentLines = incomingAttachments.map((attachment) => {
+            const rel = path.relative(options.rootPath, attachment.path);
+            return renderChatMessageFileTag({
+                type: attachment.type,
+                path: rel,
+                ...(attachment.desc ? { caption: attachment.desc } : {}),
+            });
+        });
+        if (isFeishuGroupChat(chatType)) {
+            userMessage = stripFeishuAtMentions(userMessage);
+        }
+        const instructions = buildReplyContextInstruction({
+            text: buildChatInboundText(await augmentChatInboundInput({
+                context: options.context,
+                input: {
+                    channel: "feishu",
+                    chatId,
+                    chatType,
+                    chatKey: threadId,
+                    messageId,
+                    rootPath: options.rootPath,
+                    attachmentText: attachmentLines.length > 0 ? attachmentLines.join("\n") : undefined,
+                    bodyText: userMessage ? userMessage.trim() : undefined,
+                    attachments: incomingAttachments.map((attachment) => ({
+                        channel: "feishu",
+                        kind: attachment.type,
+                        path: attachment.path,
+                        desc: attachment.desc,
+                    })),
+                },
+            })) ||
+                (attachmentLines.length > 0
+                    ? `${attachmentLines.join("\n")}\n\n请查看以上附件。`
+                    : ""),
+            replyContext,
+        });
+        if (!instructions)
+            return;
+        await options.executeAndReply({
+            chatId,
+            chatType,
+            messageId,
+            instructions,
+            actorId,
+            actorName,
+            chatTitle,
+            extra: buildReplyContextExtra(replyContext),
+        });
+    });
+    return true;
+}
+//# sourceMappingURL=FeishuMessageHandler.js.map

package/bin/plugin/builtins/chat/channels/feishu/FeishuMessageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuMessageHandler.js","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/FeishuMessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,yDAAyD,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAgJ5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoC,EACpC,IAAwB;IAExB,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,OAAO;YAAE,OAAO;QAC3B,MAAM,EACJ,OAAO,EAAE,EACP,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,GACV,GACF,GAAG,IAAI,CAAC;QAET,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,cAAc,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;QACxC,MAAM,mBAAmB,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAClD,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,mBAAmB;aAC/B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,mBAAmB,EAAE,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oDAAoD,mBAAmB,EAAE,CAC1E,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE,mBAAmB,EAAE,CAC1F,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAEpD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,WAKH,CAAC;YACF,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,oBAAoB,CAAC;oBACvC,OAAO;oBACP,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,SAAS;oBACnB,SAAS,EAAE,UAAU;oBACrB,WAAW,EAAE,YAAY;oBACzB,OAAO;oBACP,eAAe,EAAE,SAAS;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC,gBAAgB,CAAC;oBAC7B,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,SAAS;oBACnB,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,4BAA4B,MAAM,CAAC,KAAK,CAAC,EAAE;iBACvD,CAAC,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YACD,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,uBAAuB,CAAC;gBAClD,OAAO;gBACP,IAAI;gBACJ,QAAQ;gBACR,cAAc;gBACd,OAAO;gBACP,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,UAAU;gBACrB,GAAG,WAAW;aACf,CAAC,CAAC;YACH,OAAO,GAAG,aAAa,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACnD,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACnC,MAAM,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;YACvD,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,MAQnC;IAMC,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,oCAAoC,MAAM,CAAC,eAAe,EAAE;SACxE,CAAC,CAAC;QACH,OAAO;YACL,WAAW,EAAE,EAAE;YACf,mBAAmB,EAAE,EAAE;YACvB,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,IAAI;QACxB,mBAAmB,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC;YACpE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACF,YAAY,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACrD,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CAAC,MAYtC;IACC,MAAM,EACJ,OAAO,EACP,QAAQ,EACR,cAAc,EACd,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,YAAY,GACb,GAAG,MAAM,CAAC;IACX,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAErC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,WAAW,IAAI,cAAc,EAAE,CAAC,CAAC;IACjF,MAAM,SAAS,GACb,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC;QAC/B,GAAG,cAAc;QACjB,MAAM;KACP,CAAC,CAAC,IAAI,SAAS,CAAC;IACnB,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,iBAAiB,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEpF,MAAM,OAAO,CAAC,4BAA4B,CAAC;QACzC,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC;QAC7D,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACpC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvB,MAAM,OAAO,CAAC,qBAAqB,CAAC;gBAClC,MAAM;gBACN,QAAQ;gBACR,IAAI,EAAE,OAAO,CAAC,4BAA4B,CAAC;oBACzC,MAAM;oBACN,QAAQ;oBACR,MAAM,EAAE,OAAO;iBAChB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC7B,MAAM;QACN,QAAQ;QACR,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAEpD,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC3C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,OAAO,CAAC,aAAa,CAAC;gBAC1B,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,wBAAwB,CAAC;gBAC9B,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,GAAG;gBACT,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,WAAW,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,YAAY,GAAG,4BAA4B,CAAC;YAChD,IAAI,EACF,oBAAoB,CAClB,MAAM,uBAAuB,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE;oBACL,OAAO,EAAE,QAAQ;oBACjB,MAAM;oBACN,QAAQ;oBACR,OAAO,EAAE,QAAQ;oBACjB,SAAS;oBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,cAAc,EACZ,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;oBACrE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;oBACtD,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;wBACpD,OAAO,EAAE,QAAiB;wBAC1B,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB,CAAC,CAAC;iBACJ;aACF,CAAC,CACH;gBACD,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;oBACzB,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc;oBAC7C,CAAC,CAAC,EAAE,CAAC;YACT,YAAY;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY;YAAE,OAAO;QAE1B,MAAM,OAAO,CAAC,eAAe,CAAC;YAC5B,MAAM;YACN,QAAQ;YACR,SAAS;YACT,YAAY;YACZ,OAAO;YACP,SAAS;YACT,SAAS;YACT,KAAK,EAAE,sBAAsB,CAAC,YAAY,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformClient.d.ts

@@ -0,0 +1,130 @@
+/**
+ * FeishuPlatformClient：飞书平台连接与消息能力封装。
+ *
+ * 关键点（中文）
+ * - 负责 SDK client / WS client、token 缓存、启动停止与 runtime 状态。
+ * - 查询类能力与发送类能力已经拆到旁路模块，当前文件只保留平台宿主职责。
+ * - `FeishuBot` 只调用这里暴露的平台能力，不再直接持有底层 Feishu 连接细节。
+ */
+import type { AgentContext } from "../../../../../core/AgentContextTypes.js";
+import type { FeishuConfig, FeishuDownloadedAttachment, FeishuMessageEvent, FeishuMessagePayloadType } from "../../../../../plugin/builtins/chat/channels/feishu/types/FeishuChannel.js";
+import type { ChatChannelTestResult } from "../../../../../plugin/builtins/chat/types/ChannelStatus.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../../../plugin/builtins/chat/types/FeishuAttachment.js";
+import type { FeishuIncomingAttachmentDescriptor } from "../../../../../plugin/builtins/chat/types/FeishuInboundAttachment.js";
+import type { InboundReplyContext } from "../../../../../plugin/builtins/chat/types/ReplyContext.js";
+/**
+ * Feishu 平台 client 构造参数。
+ */
+export interface FeishuPlatformClientOptions {
+    /**
+     * 当前执行上下文。
+     */
+    context: AgentContext;
+    /**
+     * 飞书渠道配置。
+     */
+    config: Pick<FeishuConfig, "appId" | "appSecret" | "domain">;
+    /**
+     * 入站消息回调。
+     */
+    onMessage: (data: FeishuMessageEvent) => Promise<void>;
+}
+/**
+ * 飞书平台 client。
+ */
+export declare class FeishuPlatformClient {
+    private readonly context;
+    private readonly rootPath;
+    private readonly logger;
+    private readonly appId;
+    private readonly appSecret;
+    private readonly domain?;
+    private readonly onMessage;
+    private client;
+    private wsClient;
+    private isRunning;
+    private messageCleanupInterval;
+    private appAccessToken;
+    private appAccessTokenExpiresAtMs;
+    private readonly chatTitleByChatId;
+    private readonly senderNameBySenderKey;
+    private readonly lookupWarnings;
+    constructor(options: FeishuPlatformClientOptions);
+    /**
+     * 获取 runtime 快照。
+     */
+    getExecutorStatus(): {
+        running: boolean;
+        linkState: "connected" | "disconnected" | "unknown";
+        statusText: string;
+        detail: Record<string, string | number | boolean | null>;
+    };
+    /**
+     * 连通性测试。
+     */
+    testConnection(): Promise<ChatChannelTestResult>;
+    /**
+     * 启动平台连接。
+     */
+    start(processedMessages: Set<string>): Promise<void>;
+    /**
+     * 停止平台连接。
+     */
+    stop(): Promise<void>;
+    /**
+     * 给入站消息补一个轻量 ack reaction。
+     */
+    sendInboundAckReaction(params: {
+        messageId?: string;
+    }): Promise<void>;
+    /**
+     * 解析发送者姓名。
+     */
+    resolveSenderName(params: {
+        senderId?: string;
+        idType?: "open_id" | "user_id" | "union_id";
+        chatId?: string;
+    }): Promise<string | undefined>;
+    /**
+     * 解析群聊/会话标题。
+     */
+    resolveChatTitle(chatId: string): Promise<string | undefined>;
+    /**
+     * 查询 reply 的父消息上下文。
+     */
+    resolveReplyContext(params: {
+        parentMessageId?: string;
+    }): Promise<InboundReplyContext | undefined>;
+    /**
+     * 下载入站附件。
+     */
+    downloadIncomingAttachments(params: {
+        messageId: string;
+        attachments: FeishuIncomingAttachmentDescriptor[];
+    }): Promise<FeishuDownloadedAttachment[]>;
+    /**
+     * 发送附件。
+     */
+    sendAttachment(chatId: string, chatType: string, messageId: string | undefined, attachment: ParsedFeishuAttachmentCommand): Promise<void>;
+    /**
+     * 发送平台消息。
+     */
+    sendPlatformMessage(chatId: string, chatType: string, messageId: string | undefined, msgType: FeishuMessagePayloadType, content: Record<string, unknown> | string): Promise<void>;
+    /**
+     * 获取 tenant_access_token。
+     */
+    private getAppAccessToken;
+    /**
+     * 为 lookup helper 构造依赖集合。
+     */
+    private getLookupDeps;
+    /**
+     * 为 messaging helper 构造依赖集合。
+     */
+    private getMessagingDeps;
+    /**
+     * 归一化 domain。
+     */
+    private getNormalizedDomain;
+}
+//# sourceMappingURL=FeishuPlatformClient.d.ts.map

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformClient.d.ts.map

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

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

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

package/bin/plugin/builtins/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 "../../../../../types/common/Json.js";
+import type { FeishuDownloadedAttachment } from "../../../../../plugin/builtins/chat/channels/feishu/types/FeishuChannel.js";
+import type { FeishuIncomingAttachmentDescriptor } from "../../../../../plugin/builtins/chat/types/FeishuInboundAttachment.js";
+import type { InboundReplyContext } from "../../../../../plugin/builtins/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/plugin/builtins/chat/channels/feishu/FeishuPlatformLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPlatformLookup.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/FeishuPlatformLookup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yDAAyD,CAAC;AAClH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAIxF;;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"}

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformLookup.js.map

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

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformMessaging.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Feishu 平台发送与附件上传辅助函数。
+ *
+ * 关键点（中文）
+ * - 发送消息、上传图片/文件、解析本地附件路径属于“写入型平台能力”。
+ * - `FeishuPlatformClient` 只保留统一入口和状态，不再直接承载全部细节。
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+import type { FeishuMessagePayloadType } from "../../../../../plugin/builtins/chat/channels/feishu/types/FeishuChannel.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../../../plugin/builtins/chat/types/FeishuAttachment.js";
+/**
+ * Feishu 发送类依赖。
+ */
+export interface FeishuMessagingDeps {
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 日志器。
+     */
+    logger: {
+        /**
+         * 记录 error 日志。
+         */
+        error(message: string, data?: Record<string, unknown>): void;
+    };
+    /**
+     * Feishu SDK client。
+     */
+    client: Lark.Client | null;
+    /**
+     * 获取 tenant_access_token 的回调。
+     */
+    getAppAccessToken: () => Promise<string | undefined>;
+    /**
+     * 归一化 domain 的回调。
+     */
+    getNormalizedDomain: () => string;
+}
+/**
+ * 发送平台消息。
+ */
+export declare function sendFeishuPlatformMessage(deps: FeishuMessagingDeps, chatId: string, chatType: string, messageId: string | undefined, msgType: FeishuMessagePayloadType, content: Record<string, unknown> | string): Promise<void>;
+/**
+ * 发送附件，并在需要时补发 caption 文本。
+ */
+export declare function sendFeishuAttachment(deps: FeishuMessagingDeps, chatId: string, chatType: string, messageId: string | undefined, attachment: ParsedFeishuAttachmentCommand): Promise<void>;
+//# sourceMappingURL=FeishuPlatformMessaging.d.ts.map

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformMessaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPlatformMessaging.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/FeishuPlatformMessaging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC9D,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;CACnC;AA4FD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GACxC,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/bin/plugin/builtins/chat/channels/feishu/FeishuPlatformMessaging.js.map

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

package/bin/plugin/builtins/chat/channels/feishu/InboundAttachment.d.ts

@@ -0,0 +1,31 @@
+import type { FeishuIncomingAttachmentDescriptor } from "../../../../../plugin/builtins/chat/types/FeishuInboundAttachment.js";
+/**
+ * 解析飞书入站消息。
+ *
+ * 说明（中文）
+ * - 文本消息返回正文。
+ * - `post` 消息会降级成“纯文本 + 附件占位”。
+ * - 附件消息返回归一化附件描述；正文通常为空。
+ * - 不支持的 `message_type` 会返回 `unsupportedType`，由上层决定是否提示用户。
+ */
+export declare function parseFeishuInboundMessage(params: {
+    messageType: string;
+    content: string;
+}): {
+    text: string;
+    attachments: FeishuIncomingAttachmentDescriptor[];
+    unsupportedType?: string;
+};
+/**
+ * 生成飞书入站附件的本地缓存文件名。
+ *
+ * 关键点（中文）
+ * - 优先使用服务端返回的 `Content-Disposition` 文件名。
+ * - 若无文件名，则回退到附件原始文件名，再根据 MIME 或类型补扩展名。
+ */
+export declare function buildFeishuInboundCacheFileName(params: {
+    attachment: FeishuIncomingAttachmentDescriptor;
+    messageId: string;
+    headers?: Record<string, unknown>;
+}): string;
+//# sourceMappingURL=InboundAttachment.d.ts.map

package/bin/plugin/builtins/chat/channels/feishu/InboundAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAttachment.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/InboundAttachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,kCAAkC,EACnC,MAAM,yDAAyD,CAAC;AAsLjE;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CA2BA;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,UAAU,EAAE,kCAAkC,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,MAAM,CAiBT"}