@downcity/plugins 1.0.4

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

@@ -0,0 +1,247 @@
+/**
+ * Feishu 入站消息处理器。
+ *
+ * 关键点（中文）
+ * - 负责单条飞书消息的去重、解析、授权、附件保存与执行入队。
+ * - 不持有 `FeishuBot` 实例；所有副作用通过显式依赖注入。
+ * - 解析失败/执行失败通过渠道门面提供的发送函数回写错误消息。
+ */
+import path from "path";
+import { buildReplyContextExtra, buildReplyContextInstruction, } from "../../../chat/runtime/ReplyContextFormatter.js";
+import { augmentChatInboundInput, buildChatInboundText, } from "../../../chat/runtime/InboundAugment.js";
+import { renderChatMessageFileTag } from "@downcity/agent/internal/executor/messages/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/chat/channels/feishu/FeishuMessageHandler.js.map

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

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

@@ -0,0 +1,130 @@
+/**
+ * FeishuPlatformClient：飞书平台连接与消息能力封装。
+ *
+ * 关键点（中文）
+ * - 负责 SDK client / WS client、token 缓存、启动停止与 runtime 状态。
+ * - 查询类能力与发送类能力已经拆到旁路模块，当前文件只保留平台宿主职责。
+ * - `FeishuBot` 只调用这里暴露的平台能力，不再直接持有底层 Feishu 连接细节。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { FeishuConfig, FeishuDownloadedAttachment, FeishuMessageEvent, FeishuMessagePayloadType } from "../../../chat/channels/feishu/types/FeishuChannel.js";
+import type { ChatChannelTestResult } from "../../../chat/types/ChannelStatus.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../chat/types/FeishuAttachment.js";
+import type { FeishuIncomingAttachmentDescriptor } from "../../../chat/types/FeishuInboundAttachment.js";
+import type { InboundReplyContext } from "../../../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/chat/channels/feishu/FeishuPlatformClient.d.ts.map

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