team-anya 0.2.0

package/apps/server/dist/gateway/feishu-sender.js

@@ -0,0 +1,508 @@
+import * as Lark from '@larksuiteoapi/node-sdk';
+import { insertMessageLog, getMessageLogBySourceRef } from '@team-anya/db';
+import { messageEvents } from './message-events.js';
+// ── markdownToFeishuCard ──
+/**
+ * 将 markdown 内容转换为飞书交互式卡片格式
+ */
+export function markdownToFeishuCard(content, title) {
+    return {
+        schema: '2.0',
+        config: { wide_screen_mode: true },
+        header: {
+            title: { content: title, tag: 'plain_text' },
+        },
+        body: {
+            elements: [
+                { tag: 'markdown', content },
+            ],
+        },
+    };
+}
+// ── FeishuSender（基于官方 SDK）──
+/**
+ * 飞书消息发送器
+ *
+ * 使用 @larksuiteoapi/node-sdk 的 Client，SDK 内部自动处理 token 获取和缓存。
+ *
+ * 出站场景：
+ * - sendText / sendReply: 日常对话（纯文本，像正常同事说话）
+ * - sendBlockedAlert: 任务阻塞提醒
+ * - sendDailyReport: 日报推送（卡片，内容较长）
+ * - sendTaskDone: 任务完成通知（纯文本）
+ */
+export class FeishuSender {
+    client;
+    db;
+    constructor(config) {
+        this.client = new Lark.Client({
+            appId: config.appId,
+            appSecret: config.appSecret,
+            appType: Lark.AppType.SelfBuild,
+            domain: Lark.Domain.Feishu,
+        });
+        this.db = config.db ?? null;
+    }
+    /**
+     * 写入 outbound message_log 并 emit 事件
+     */
+    logOutbound(params) {
+        if (!this.db)
+            return;
+        try {
+            const chatId = params.receiveIdType === 'chat_id' ? params.receiver : null;
+            const chatType = params.receiveIdType === 'chat_id' ? 'group'
+                : params.receiveIdType === 'open_id' ? 'p2p' : null;
+            // 构建 metadata（话题回复标记等）
+            const meta = {};
+            if (params.replyToMessageId)
+                meta.parent_message_id = params.replyToMessageId;
+            // 优先：使用飞书 API 响应中的 thread_id（权威数据源）
+            if (params.threadId) {
+                meta.thread_id = params.threadId;
+            }
+            // 兜底 1：反查父消息的 thread_id
+            if (!meta.thread_id && params.replyToMessageId && this.db) {
+                const parent = getMessageLogBySourceRef(this.db, params.replyToMessageId);
+                if (parent?.metadata) {
+                    try {
+                        const parentMeta = JSON.parse(parent.metadata);
+                        if (parentMeta.thread_id)
+                            meta.thread_id = parentMeta.thread_id;
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            // 兜底 2：创建新话题时父消息还没有 thread_id，用显式标记
+            if (!meta.thread_id && params.replyInThread) {
+                meta.thread_id = params.replyToMessageId;
+            }
+            const metadataStr = Object.keys(meta).length > 0 ? JSON.stringify(meta) : null;
+            const entry = insertMessageLog(this.db, {
+                direction: 'outbound',
+                source_type: 'feishu',
+                source_ref: params.sourceRef ?? null,
+                sender: 'anya',
+                receiver: params.receiver,
+                chat_id: chatId,
+                chat_type: chatType,
+                content: params.content,
+                message_type: params.message_type,
+                related_task_id: params.related_task_id ?? null,
+                metadata: metadataStr,
+            });
+            messageEvents.emit('message', {
+                id: entry.id,
+                direction: 'outbound',
+                source_type: entry.source_type,
+                sender: entry.sender,
+                receiver: entry.receiver,
+                content: entry.content,
+                message_type: entry.message_type,
+                related_task_id: entry.related_task_id,
+                chat_id: entry.chat_id ?? null,
+                chat_type: entry.chat_type,
+                created_at: entry.created_at,
+            });
+        }
+        catch {
+            // 日志写入失败不应阻断消息发送
+        }
+    }
+    // ── 消息发送 ──
+    /** 从飞书 API 响应中提取 thread_id */
+    static extractThreadId(data) {
+        return data?.thread_id ?? undefined;
+    }
+    async sendCard(params) {
+        const content = JSON.stringify(params.card);
+        let messageId;
+        let threadId;
+        // 回复消息
+        if (params.replyToMessageId) {
+            const response = await this.client.im.message.reply({
+                path: { message_id: params.replyToMessageId },
+                data: {
+                    content,
+                    msg_type: 'interactive',
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书回复失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        else {
+            // 发送新消息
+            const response = await this.client.im.message.create({
+                params: { receive_id_type: params.receiveIdType },
+                data: {
+                    receive_id: params.receiveId,
+                    content,
+                    msg_type: 'interactive',
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书发送失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        this.logOutbound({
+            receiver: params.receiveId,
+            content: params.log?.contentOverride ?? content.slice(0, 500),
+            message_type: params.log?.messageType ?? 'interactive',
+            sourceRef: messageId,
+            receiveIdType: params.receiveIdType,
+            related_task_id: params.log?.relatedTaskId,
+            replyToMessageId: params.replyToMessageId,
+            threadId,
+            replyInThread: params.log?.replyInThread,
+        });
+        return messageId;
+    }
+    // ── 发送纯文本 ──
+    async sendText(params) {
+        const response = await this.client.im.message.create({
+            params: { receive_id_type: params.receiveIdType },
+            data: {
+                receive_id: params.receiveId,
+                content: JSON.stringify({ text: params.text }),
+                msg_type: 'text',
+            },
+        });
+        if (response.code !== 0) {
+            throw new Error(`飞书发送失败: ${response.msg || `code ${response.code}`}`);
+        }
+        const messageId = response.data?.message_id ?? 'unknown';
+        const threadId = FeishuSender.extractThreadId(response.data);
+        this.logOutbound({
+            receiver: params.receiveId,
+            content: params.text,
+            message_type: params.log?.messageType ?? 'message',
+            sourceRef: messageId,
+            receiveIdType: params.receiveIdType,
+            related_task_id: params.log?.relatedTaskId,
+            replyToMessageId: params.log?.replyToMessageId,
+            threadId,
+            replyInThread: params.log?.replyInThread,
+        });
+        return messageId;
+    }
+    // ── 回复消息（纯文本，像正常同事说话）──
+    async sendReply(params) {
+        const response = await this.client.im.message.reply({
+            path: { message_id: params.replyToMessageId },
+            data: {
+                content: JSON.stringify({ text: params.text }),
+                msg_type: 'text',
+                ...(params.replyInThread ? { reply_in_thread: true } : {}),
+            },
+        });
+        if (response.code !== 0) {
+            throw new Error(`飞书回复失败: ${response.msg || `code ${response.code}`}`);
+        }
+        const messageId = response.data?.message_id ?? 'unknown';
+        const threadId = FeishuSender.extractThreadId(response.data);
+        this.logOutbound({
+            receiver: params.chatId ?? params.replyToMessageId,
+            content: params.text,
+            message_type: params.log?.messageType ?? 'message',
+            sourceRef: messageId,
+            receiveIdType: params.chatId ? 'chat_id' : undefined,
+            related_task_id: params.log?.relatedTaskId,
+            replyToMessageId: params.replyToMessageId,
+            threadId,
+            replyInThread: params.replyInThread,
+        });
+        return messageId;
+    }
+    /**
+     * 获取回复消息的 thread_id（创建话题后从响应中提取）
+     */
+    async sendReplyInThread(params) {
+        const response = await this.client.im.message.reply({
+            path: { message_id: params.replyToMessageId },
+            data: {
+                content: JSON.stringify({ text: params.text }),
+                msg_type: 'text',
+                reply_in_thread: true,
+            },
+        });
+        if (response.code !== 0) {
+            throw new Error(`飞书创建话题失败: ${response.msg || `code ${response.code}`}`);
+        }
+        const messageId = response.data?.message_id ?? 'unknown';
+        const threadId = FeishuSender.extractThreadId(response.data) ?? null;
+        this.logOutbound({
+            receiver: params.chatId ?? params.replyToMessageId,
+            content: params.text,
+            message_type: 'message',
+            sourceRef: messageId,
+            receiveIdType: params.chatId ? 'chat_id' : undefined,
+            replyToMessageId: params.replyToMessageId,
+            threadId: threadId ?? undefined,
+            replyInThread: true,
+        });
+        return { messageId, threadId };
+    }
+    // ── 图片上传与发送 ──
+    /**
+     * 上传图片到飞书（获取 image_key）
+     *
+     * 调用 POST /im/v1/images 接口。
+     * 支持格式: png, jpg, jpeg, gif, bmp, webp, ico, tiff, tif
+     */
+    async uploadImage(filePath) {
+        const fs = await import('node:fs');
+        const fileStream = fs.createReadStream(filePath);
+        const response = await this.client.im.image.create({
+            data: {
+                image_type: 'message',
+                image: fileStream,
+            },
+        });
+        const result = response;
+        if (result.code != null && result.code !== 0) {
+            throw new Error(`飞书图片上传失败: ${result.msg || `code ${result.code}`}`);
+        }
+        const imageKey = result.data?.image_key ?? result.image_key;
+        if (!imageKey) {
+            throw new Error('飞书图片上传成功但未返回 image_key');
+        }
+        return imageKey;
+    }
+    /**
+     * 发送图片消息
+     */
+    async sendImage(params) {
+        const content = JSON.stringify({ image_key: params.imageKey });
+        let messageId;
+        let threadId;
+        if (params.replyToMessageId) {
+            const response = await this.client.im.message.reply({
+                path: { message_id: params.replyToMessageId },
+                data: {
+                    content,
+                    msg_type: 'image',
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书图片回复失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        else {
+            const response = await this.client.im.message.create({
+                params: { receive_id_type: params.receiveIdType },
+                data: {
+                    receive_id: params.receiveId,
+                    content,
+                    msg_type: 'image',
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书图片发送失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        this.logOutbound({
+            receiver: params.receiveId,
+            content: `[图片] ${params.imageKey}`,
+            message_type: 'image',
+            sourceRef: messageId,
+            receiveIdType: params.receiveIdType,
+            replyToMessageId: params.replyToMessageId,
+            threadId,
+        });
+        return messageId;
+    }
+    // ── 文件上传与发送 ──
+    /**
+     * 上传文件到飞书（获取 file_key）
+     *
+     * 调用 POST /im/v1/files 接口。
+     */
+    async uploadFile(params) {
+        const fs = await import('node:fs');
+        const path = await import('node:path');
+        const fileStream = fs.createReadStream(params.filePath);
+        const finalName = params.fileName || path.basename(params.filePath);
+        const fileType = params.fileType || 'stream';
+        const response = await this.client.im.file.create({
+            data: {
+                file_type: fileType,
+                file_name: finalName,
+                file: fileStream,
+                ...(params.duration != null ? { duration: params.duration } : {}),
+            },
+        });
+        // im.file.create 返回 { file_key?: string } 或含错误信息
+        const result = response;
+        if (result.code != null && result.code !== 0) {
+            throw new Error(`飞书文件上传失败: ${result.msg || `code ${result.code}`}`);
+        }
+        const fileKey = result.data?.file_key ?? result.file_key;
+        if (!fileKey) {
+            throw new Error('飞书文件上传成功但未返回 file_key');
+        }
+        return fileKey;
+    }
+    /**
+     * 发送文件消息
+     *
+     * @param msgType - 消息类型：'file'（默认）或 'audio'（opus 语音）
+     */
+    async sendFile(params) {
+        const msgType = params.msgType ?? 'file';
+        const content = JSON.stringify({ file_key: params.fileKey });
+        let messageId;
+        let threadId;
+        if (params.replyToMessageId) {
+            const response = await this.client.im.message.reply({
+                path: { message_id: params.replyToMessageId },
+                data: {
+                    content,
+                    msg_type: msgType,
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书${msgType === 'audio' ? '语音' : '文件'}回复失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        else {
+            const response = await this.client.im.message.create({
+                params: { receive_id_type: params.receiveIdType },
+                data: {
+                    receive_id: params.receiveId,
+                    content,
+                    msg_type: msgType,
+                },
+            });
+            if (response.code !== 0) {
+                throw new Error(`飞书${msgType === 'audio' ? '语音' : '文件'}发送失败: ${response.msg || `code ${response.code}`}`);
+            }
+            messageId = response.data?.message_id ?? 'unknown';
+            threadId = FeishuSender.extractThreadId(response.data);
+        }
+        this.logOutbound({
+            receiver: params.receiveId,
+            content: `[${msgType === 'audio' ? '语音' : '文件'}] ${params.fileKey}`,
+            message_type: msgType,
+            sourceRef: messageId,
+            receiveIdType: params.receiveIdType,
+            replyToMessageId: params.replyToMessageId,
+            threadId,
+        });
+        return messageId;
+    }
+    // ── 表情回复（Reaction）──
+    /** "处理中"指示 emoji，收到消息时添加，回复后移除 */
+    static TYPING_EMOJI = 'OneSecond';
+    /** 待清除的 typing reaction，key 为 chatId */
+    pendingTypingReactions = new Map();
+    /**
+     * 给消息添加"处理中"表情，并记录到 pending 映射
+     *
+     * 收到消息后立即调用，大模型回复或出错时通过 clearTypingReaction 移除。
+     */
+    async addTypingReaction(chatId, messageId) {
+        const reactionId = await this.addReaction(messageId, FeishuSender.TYPING_EMOJI);
+        if (reactionId) {
+            this.pendingTypingReactions.set(chatId, { messageId, reactionId });
+        }
+    }
+    /**
+     * 清除指定群聊的"处理中"表情
+     *
+     * 在大模型回复、冷启动回复、或出错回复时调用。
+     */
+    async clearTypingReaction(chatId) {
+        const pending = this.pendingTypingReactions.get(chatId);
+        if (!pending)
+            return;
+        this.pendingTypingReactions.delete(chatId);
+        await this.deleteReaction(pending.messageId, pending.reactionId);
+    }
+    /**
+     * 给消息添加表情回复
+     *
+     * 调用飞书 POST /im/v1/messages/{message_id}/reactions
+     */
+    async addReaction(messageId, emojiType) {
+        try {
+            const response = await this.client.im.messageReaction.create({
+                path: { message_id: messageId },
+                data: {
+                    reaction_type: { emoji_type: emojiType },
+                },
+            });
+            if (response.code !== 0) {
+                console.warn(`[feishu-sender] 添加表情回复失败: ${response.msg || `code ${response.code}`}`);
+                return null;
+            }
+            return response.data?.reaction_id ?? null;
+        }
+        catch (err) {
+            console.warn('[feishu-sender] 添加表情回复异常:', err);
+            return null;
+        }
+    }
+    /**
+     * 删除消息上的表情回复
+     *
+     * 调用飞书 DELETE /im/v1/messages/{message_id}/reactions/{reaction_id}
+     */
+    async deleteReaction(messageId, reactionId) {
+        try {
+            const response = await this.client.im.messageReaction.delete({
+                path: { message_id: messageId, reaction_id: reactionId },
+            });
+            if (response.code !== 0) {
+                console.warn(`[feishu-sender] 删除表情回复失败: ${response.msg || `code ${response.code}`}`);
+            }
+        }
+        catch (err) {
+            console.warn('[feishu-sender] 删除表情回复异常:', err);
+        }
+    }
+    // ── 出站场景 ──
+    async sendBlockedAlert(params) {
+        // 用自然语言，不用制式模板
+        const text = `${params.taskId} 卡住了——${params.reason}`;
+        const results = await Promise.allSettled(params.targetUserIds.map(userId => this.sendText({
+            receiveIdType: 'open_id',
+            receiveId: userId,
+            text,
+            log: { messageType: 'alert', relatedTaskId: params.taskId },
+        })));
+        return results;
+    }
+    async sendDailyReport(params) {
+        // 日报内容较长，保留卡片格式便于阅读
+        const card = markdownToFeishuCard(params.reportContent, `${params.date} 工作小结`);
+        await this.sendCard({
+            receiveIdType: 'chat_id',
+            receiveId: params.chatId,
+            card,
+            log: { messageType: 'report', contentOverride: params.reportContent },
+        });
+    }
+    async sendTaskDone(params) {
+        // 用自然语言，像同事在群里说"搞定了"
+        const prPart = params.prUrl ? `，PR: ${params.prUrl}` : '';
+        const text = `${params.taskId} 搞定了——${params.summary}${prPart}`;
+        await this.sendText({
+            receiveIdType: 'chat_id',
+            receiveId: params.chatId,
+            text,
+            log: { messageType: 'task_done', relatedTaskId: params.taskId },
+        });
+    }
+}
+//# sourceMappingURL=feishu-sender.js.map