evolcore 0.0.2 → 0.0.3

package/dist/channels/feishu.js

@@ -6,6 +6,7 @@ import { logger } from '../utils/logger.js';
 import { formatItemsAsText } from '../core/message/items-formatter.js';
 import { initWelcomeManager, sendWelcomeIfNeeded } from '../utils/welcome.js';
 import { chatDirPath, decodeDirSegment } from '../core/session/session-fs-store.js';
+import { sentReceipt, suppressedReceipt } from '../core/message/send-receipt.js';
 export class FeishuChannel {
     config;
     agentAid;
@@ -125,7 +126,7 @@ export class FeishuChannel {
                     try {
                         // 首次交互欢迎消息（使用共享帮助函数）
                         if (peerId) {
-                            await sendWelcomeIfNeeded(this.welcomeManager, peerId, msg.chat_id, (id, text) => this.sendMessage(id, text), 'Feishu');
+                            await sendWelcomeIfNeeded(this.welcomeManager, peerId, msg.chat_id, async (id, text) => { await this.sendMessage(id, text); }, 'Feishu');
                         }
                         // 提取话题信息
                         const threadId = msg.thread_id || undefined;
@@ -471,11 +472,11 @@ export class FeishuChannel {
     }
     async sendMessage(chatId, content, options) {
         if (!this.client)
-            return;
+            throw new Error('Feishu client is not connected');
         content = exposeLocalMarkdownLinkTargetsForFeishu(content);
         if (!content || content.trim() === '') {
             logger.warn('[Feishu] Attempted to send empty message, skipping');
-            return;
+            return [];
         }
         // 飞书消息内容限制约 30KB（text）/ 150KB（post），安全阈值 28000 字符
         // 超长消息自动拆分，按段落边界分割
@@ -483,12 +484,13 @@ export class FeishuChannel {
         if (content.length > MAX_CONTENT_LENGTH) {
             logger.info(`[Feishu] Message too long (${content.length} chars), splitting into parts`);
             const parts = splitLongMessage(content, MAX_CONTENT_LENGTH);
+            const messageIds = [];
             for (let i = 0; i < parts.length; i++) {
                 // 首条消息保留 reply 选项，后续消息不再 reply
                 const partOptions = i === 0 ? options : { ...options, replyToMessageId: undefined };
-                await this.sendMessage(chatId, parts[i], partOptions);
+                messageIds.push(...await this.sendMessage(chatId, parts[i], partOptions));
             }
-            return;
+            return messageIds;
         }
         logger.debug(`[Feishu] sendMessage called, chatId: ${chatId}, content length: ${content.length}`);
         try {
@@ -511,6 +513,7 @@ export class FeishuChannel {
             else {
                 msgContent = JSON.stringify({ text: content });
             }
+            let messageId;
             if (options?.replyToMessageId) {
                 const replyData = { msg_type: msgType, content: msgContent };
                 if (options.replyInThread) {
@@ -520,6 +523,7 @@ export class FeishuChannel {
                     path: { message_id: options.replyToMessageId },
                     data: replyData
                 });
+                messageId = replyRes?.data?.message_id;
                 if (options.replyInThread && options.onThreadCreated) {
                     const newThreadId = replyRes?.data?.thread_id;
                     if (newThreadId)
@@ -527,12 +531,16 @@ export class FeishuChannel {
                 }
             }
             else {
-                await this.client.im.message.create({
+                const createRes = await this.client.im.message.create({
                     params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: { receive_id: chatId, msg_type: msgType, content: msgContent }
                 });
+                messageId = createRes?.data?.message_id;
             }
+            if (!messageId)
+                throw new Error('Feishu send succeeded without message_id');
             logger.debug(`[Feishu] Sent message as ${useMarkdown ? 'post (Markdown)' : 'text'}`);
+            return [messageId];
         }
         catch (error) {
             // 230011: 消息已被撤回，降级为普通消息重试
@@ -560,7 +568,7 @@ export class FeishuChannel {
     }
     async sendFile(chatId, filePath, options) {
         if (!this.client)
-            return;
+            throw new Error('Feishu client is not connected');
         try {
             // 检测是否为图片，是则走 sendImage（内联预览）而非文件卡片
             // 读取足够字节供 file-type 解析（ZIP-based 格式如 PPTX 需要更多字节）
@@ -585,24 +593,25 @@ export class FeishuChannel {
                 }
             });
             if (!uploadResponse || !uploadResponse.file_key) {
-                logger.error('[Feishu] File upload failed: no file_key returned');
-                return;
+                throw new Error('Feishu file upload failed: no file_key returned');
             }
             const fileKey = uploadResponse.file_key;
             const msgContent = JSON.stringify({ file_key: fileKey });
             logger.info('[Feishu] File uploaded, file_key:', fileKey);
+            let messageId;
             if (options?.replyToMessageId) {
                 const replyData = { msg_type: 'file', content: msgContent };
                 if (options.replyInThread) {
                     replyData.reply_in_thread = true;
                 }
-                await this.client.im.message.reply({
+                const replyRes = await this.client.im.message.reply({
                     path: { message_id: options.replyToMessageId },
                     data: replyData
                 });
+                messageId = replyRes?.data?.message_id;
             }
             else {
-                await this.client.im.message.create({
+                const createRes = await this.client.im.message.create({
                     params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: {
                         receive_id: chatId,
@@ -610,8 +619,12 @@ export class FeishuChannel {
                         content: msgContent
                     }
                 });
+                messageId = createRes?.data?.message_id;
             }
+            if (!messageId)
+                throw new Error('Feishu file send succeeded without message_id');
             logger.info('[Feishu] File message sent successfully');
+            return [messageId];
         }
         catch (error) {
             // 230011/99992354: reply target invalid, retry without reply
@@ -626,7 +639,7 @@ export class FeishuChannel {
     }
     async sendImage(chatId, png, options) {
         if (!this.client)
-            return;
+            throw new Error('Feishu client is not connected');
         try {
             const uploadResponse = await this.client.im.image.create({
                 data: {
@@ -636,27 +649,32 @@ export class FeishuChannel {
             });
             const imageKey = uploadResponse?.image_key;
             if (!imageKey) {
-                logger.error('[Feishu] Image upload failed: no image_key returned');
-                return;
+                throw new Error('Feishu image upload failed: no image_key returned');
             }
             logger.debug('[Feishu] Image uploaded, image_key:', imageKey);
             const msgContent = JSON.stringify({ image_key: imageKey });
+            let messageId;
             if (options?.replyToMessageId) {
                 const replyData = { msg_type: 'image', content: msgContent };
                 if (options.replyInThread)
                     replyData.reply_in_thread = true;
-                await this.client.im.message.reply({
+                const replyRes = await this.client.im.message.reply({
                     path: { message_id: options.replyToMessageId },
                     data: replyData
                 });
+                messageId = replyRes?.data?.message_id;
             }
             else {
-                await this.client.im.message.create({
+                const createRes = await this.client.im.message.create({
                     params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: { receive_id: chatId, msg_type: 'image', content: msgContent }
                 });
+                messageId = createRes?.data?.message_id;
             }
+            if (!messageId)
+                throw new Error('Feishu image send succeeded without message_id');
             logger.debug('[Feishu] Image message sent successfully');
+            return [messageId];
         }
         catch (error) {
             // 99992354: reply target invalid — image cannot easily retry, just log
@@ -1273,6 +1291,10 @@ export class FeishuChannel {
     }
     // messageId → Pin reaction create promise（等待 reaction_id 落地，供 promoteAck 删除）
     pinReactions = new Map();
+    // messageId → StatusInFlight reaction create promise（终态时替换）
+    inFlightReactions = new Map();
+    // taskId → 触发该任务的全部原始入站 messageId（批量合并时可有多条）
+    taskAckMessages = new Map();
     /** 收到消息时添加 Pin 表情（表示"已收到，排队中"） */
     addPinReaction(messageId) {
         if (!this.client)
@@ -1284,22 +1306,67 @@ export class FeishuChannel {
             .catch(() => undefined);
         this.pinReactions.set(messageId, p);
     }
-    /** Runner 开始执行时：添加 CheckMark，然后异步移除 Pin（视觉无闪烁） */
-    async promoteAckReaction(messageId) {
+    /** Runner 开始执行时：添加 StatusInFlight，然后移除 Pin（视觉无闪烁） */
+    async promoteAckReaction(messageId, taskId, sourceMessageIds) {
+        const messageIds = [...new Set([...(sourceMessageIds ?? []), messageId].filter(Boolean))];
+        if (taskId)
+            this.taskAckMessages.set(taskId, messageIds);
         if (!this.client)
             return;
-        // 先加 CheckMark，再删 Pin——用户看到的是 Pin→Pin+CheckMark→CheckMark，无空窗
-        this.client.im.messageReaction.create({
-            path: { message_id: messageId },
-            data: { reaction_type: { emoji_type: 'CheckMark' } },
-        }).catch(() => { });
-        const pending = this.pinReactions.get(messageId);
-        this.pinReactions.delete(messageId);
-        const reactionId = await pending;
-        if (reactionId) {
-            this.client.im.messageReaction.delete({
-                path: { message_id: messageId, reaction_id: reactionId },
-            }).catch(() => { });
+        const promotions = messageIds.map(id => {
+            // 先加 StatusInFlight，再删 Pin——用户看到的是 Pin→Pin+InFlight→InFlight。
+            const inFlightPending = this.client.im.messageReaction.create({
+                path: { message_id: id },
+                data: { reaction_type: { emoji_type: 'StatusInFlight' } },
+            }).then((res) => res?.data?.reaction_id)
+                .catch(() => undefined);
+            this.inFlightReactions.set(id, inFlightPending);
+            const pending = this.pinReactions.get(id);
+            this.pinReactions.delete(id);
+            return { id, pending };
+        });
+        // Every in-flight reaction is registered before this first await, so a
+        // fast terminal event cannot race ahead and strand a merged-batch status.
+        for (const { id, pending } of promotions) {
+            const reactionId = await pending;
+            if (reactionId) {
+                await this.client.im.messageReaction.delete({
+                    path: { message_id: id, reaction_id: reactionId },
+                }).catch(() => { });
+            }
+        }
+    }
+    /** 任务终态：用 CheckMark/CrossMark 替换 StatusInFlight。 */
+    async finalizeAckReaction(taskId, terminalEmoji) {
+        const messageIds = this.taskAckMessages.get(taskId);
+        if (!messageIds)
+            return;
+        if (!this.client) {
+            this.taskAckMessages.delete(taskId);
+            return;
+        }
+        this.taskAckMessages.delete(taskId);
+        for (const messageId of messageIds) {
+            const inFlightPending = this.inFlightReactions.get(messageId);
+            // 先加终态表情，再删处理中表情，避免视觉空窗。
+            const addTerminal = () => this.client.im.messageReaction.create({
+                path: { message_id: messageId },
+                data: { reaction_type: { emoji_type: terminalEmoji } },
+            }).then((res) => !!res?.data?.reaction_id).catch(() => false);
+            let terminalAdded = await addTerminal();
+            if (!terminalAdded)
+                terminalAdded = await addTerminal();
+            if (!terminalAdded) {
+                logger.warn(`[Feishu] Failed to add terminal reaction for ${messageId}; preserving processing reaction`);
+                continue;
+            }
+            this.inFlightReactions.delete(messageId);
+            const inFlightReactionId = await inFlightPending;
+            if (inFlightReactionId) {
+                await this.client.im.messageReaction.delete({
+                    path: { message_id: messageId, reaction_id: inFlightReactionId },
+                }).catch(() => { });
+            }
         }
     }
 }
@@ -1707,46 +1774,53 @@ export class FeishuChannelPlugin {
                             sendCtx.title = '✅ 最终回复:';
                         if (replyCtx?.metadata?.onThreadCreated)
                             sendCtx.onThreadCreated = replyCtx.metadata.onThreadCreated;
-                        await channel.sendMessage(channelId, payload.text, sendCtx);
-                        return;
+                        const ids = await channel.sendMessage(channelId, payload.text, sendCtx);
+                        return ids.length > 0
+                            ? sentReceipt(envelope, ids, replyCtx?.threadId)
+                            : suppressedReceipt(envelope, 'empty_message');
                     }
-                    case 'result.file':
-                        await channel.sendFile(channelId, payload.filePath, replyCtx);
-                        return;
-                    case 'result.image':
-                        await channel.sendImage(channelId, payload.data, replyCtx);
-                        return;
+                    case 'result.file': return sentReceipt(envelope, await channel.sendFile(channelId, payload.filePath, replyCtx), replyCtx?.threadId);
+                    case 'result.image': return sentReceipt(envelope, await channel.sendImage(channelId, payload.data, replyCtx), replyCtx?.threadId);
                     case 'activity.batch': {
                         const filtered = payload.items.filter((i) => !(i.kind === 'tool_result' && i.ok));
                         const text = formatItemsAsText(filtered);
                         if (text)
-                            await channel.sendMessage(channelId, text, replyCtx);
-                        return;
+                            return sentReceipt(envelope, await channel.sendMessage(channelId, text, replyCtx), replyCtx?.threadId);
+                        return suppressedReceipt(envelope, 'empty_activity');
                     }
                     case 'status.started':
+                    case 'status.queued':
+                    case 'status.progress':
+                        return suppressedReceipt(envelope, 'reaction_lifecycle');
                     case 'status.completed':
+                        await channel.finalizeAckReaction(envelope.taskId, 'CheckMark');
+                        return suppressedReceipt(envelope, 'reaction_lifecycle');
                     case 'status.interrupted':
                     case 'status.timeout':
-                    case 'status.progress': return;
+                        await channel.finalizeAckReaction(envelope.taskId, 'CrossMark');
+                        return suppressedReceipt(envelope, 'reaction_lifecycle');
                     case 'status.requires_action':
-                        await channel.sendMessage(channelId, '等待 owner 审批', replyCtx);
-                        return;
+                        return sentReceipt(envelope, await channel.sendMessage(channelId, '等待 owner 审批', replyCtx), replyCtx?.threadId);
                     case 'status.error':
-                        if (payload.metadata?.message)
-                            await channel.sendMessage(channelId, payload.metadata.message, replyCtx);
-                        return;
+                        await channel.finalizeAckReaction(envelope.taskId, 'CrossMark');
+                        if (payload.metadata?.message) {
+                            return sentReceipt(envelope, await channel.sendMessage(channelId, payload.metadata.message, replyCtx), replyCtx?.threadId);
+                        }
+                        return suppressedReceipt(envelope, 'reaction_lifecycle');
                     case 'interaction': {
                         const sent = await channel.sendInteraction(channelId, payload.interaction, replyCtx);
                         if (!sent)
                             throw new Error('sendInteraction returned false');
-                        return;
+                        return sentReceipt(envelope, [sent], replyCtx?.threadId);
                     }
-                    case 'custom': return;
-                    default: logger.warn(`[Feishu] Unhandled payload kind: ${payload.kind}`);
+                    case 'custom': return suppressedReceipt(envelope, 'unsupported_custom_payload');
+                    default:
+                        logger.warn(`[Feishu] Unhandled payload kind: ${payload.kind}`);
+                        return suppressedReceipt(envelope, 'unhandled_payload');
                 }
             },
             acknowledge: (messageId) => { channel.addPinReaction(messageId); return Promise.resolve(); },
-            promoteAck: (messageId) => channel.promoteAckReaction(messageId),
+            promoteAck: (messageId, context) => (channel.promoteAckReaction(messageId, context?.taskId, context?.messageIds)),
             onInteraction: (callback) => channel.onInteraction(callback),
             onInteractionInvalidated: (callback) => channel.onInteractionInvalidated(callback),
             invalidateInteraction: (interactionId, reason) => channel.invalidateInteraction(interactionId, reason),
@@ -1779,10 +1853,12 @@ export class FeishuChannelPlugin {
                         replyContext: threadId ? { threadId, replyToMessageId: rootId ?? threadId, replyInThread: true } : undefined,
                         source,
                     });
-                }), (channelId, text, replyContext) => channel.sendMessage(channelId, text, {
-                    replyToMessageId: replyContext?.replyToMessageId,
-                    replyInThread: replyContext?.replyInThread,
-                }), adapter, channelType);
+                }), async (channelId, text, replyContext) => {
+                    await channel.sendMessage(channelId, text, {
+                        replyToMessageId: replyContext?.replyToMessageId,
+                        replyInThread: replyContext?.replyInThread,
+                    });
+                }, adapter, channelType);
             },
         };
     }

package/dist/channels/wecom-card.js

@@ -0,0 +1,101 @@
+function truncate(value, max) {
+    if (!value)
+        return undefined;
+    const chars = [...value.trim()];
+    return chars.length <= max ? value.trim() : `${chars.slice(0, Math.max(1, max - 1)).join('')}...`;
+}
+function buttonStyle(style) {
+    if (style === 'primary')
+        return 2;
+    if (style === 'danger')
+        return 3;
+    return 1;
+}
+export function buildWecomInteractionCard(interaction, taskId) {
+    const bodyParts = [];
+    if (interaction.kind.body)
+        bodyParts.push(interaction.kind.body);
+    if (interaction.kind.kind === 'action' && interaction.kind.checkers?.length) {
+        bodyParts.push(interaction.kind.checkers.map((item, index) => `${index + 1}. ${item.label}`).join('\n'));
+    }
+    return {
+        card_type: 'button_interaction',
+        task_id: taskId,
+        main_title: {
+            title: truncate(interaction.kind.title, 26),
+            desc: truncate(bodyParts.join('\n\n'), 120),
+        },
+        button_list: interaction.kind.buttons
+            .map((button, index) => ({ button, index }))
+            .filter(({ button }) => !('disabled' in button) || !button.disabled)
+            .slice(0, 6)
+            .map(({ button, index }) => ({
+            text: truncate(button.label, 10) || `选项 ${index + 1}`,
+            style: buttonStyle(button.style),
+            key: interaction.kind.kind === 'command-card' ? `cmd_${index}` : `act_${index}`,
+        })),
+    };
+}
+export function parseWecomCardResponse(record, event, operatorId) {
+    const eventKey = String(event.event_key ?? '').trim();
+    const match = /^(cmd|act)_(\d+)$/.exec(eventKey);
+    if (!match)
+        return null;
+    const index = Number(match[2]);
+    if (record.interaction.kind.kind === 'command-card') {
+        const button = record.interaction.kind.buttons[index];
+        if (!button || button.disabled)
+            return null;
+        return { command: button.command };
+    }
+    const button = record.interaction.kind.buttons[index];
+    if (!button)
+        return null;
+    const values = {};
+    const selectedItems = event.selected_items?.selected_item;
+    if (Array.isArray(selectedItems)) {
+        for (const selected of selectedItems) {
+            const questionKey = String(selected?.question_key ?? '').trim();
+            const optionIds = selected?.option_ids?.option_id;
+            if (questionKey && Array.isArray(optionIds))
+                values[questionKey] = optionIds.filter(Boolean);
+        }
+    }
+    return {
+        response: {
+            type: 'interaction.response',
+            id: record.interaction.id,
+            action: button.key,
+            values: Object.keys(values).length > 0 ? values : undefined,
+            operatorId,
+        },
+    };
+}
+export function buildWecomTerminalCard(record, status, detail) {
+    const statusText = status === 'resolved'
+        ? `已处理${detail ? `：${detail}` : ''}`
+        : status === 'rejected'
+            ? '仅卡片发起者可操作'
+            : status === 'unavailable'
+                ? '处理服务暂不可用，请重新发起'
+                : `卡片已失效${detail ? `：${detail}` : ''}`;
+    return {
+        card_type: 'text_notice',
+        task_id: record.taskId,
+        main_title: {
+            title: truncate(record.interaction.kind.title, 26),
+            desc: truncate(statusText, 120),
+        },
+        sub_title_text: truncate(record.interaction.kind.body, 120),
+    };
+}
+export function buildWecomUnknownCard(taskId) {
+    return {
+        card_type: 'text_notice',
+        task_id: taskId,
+        main_title: {
+            title: '卡片已失效',
+            desc: '本地状态不存在，请重新发起操作',
+        },
+    };
+}

package/dist/channels/wecom-onboarding.js

@@ -0,0 +1,82 @@
+import os from 'node:os';
+const WECOM_QR_GENERATE_URL = 'https://work.weixin.qq.com/ai/qc/generate';
+const WECOM_QR_QUERY_URL = 'https://work.weixin.qq.com/ai/qc/query_result';
+const WECOM_QR_PAGE_URL = 'https://work.weixin.qq.com/ai/qc/gen';
+function platformCode() {
+    if (os.platform() === 'darwin')
+        return 1;
+    if (os.platform() === 'win32')
+        return 2;
+    if (os.platform() === 'linux')
+        return 3;
+    return 0;
+}
+async function fetchJson(url, fetchImpl, signal) {
+    const timeoutSignal = AbortSignal.timeout(15_000);
+    const response = await fetchImpl(url, {
+        headers: { Accept: 'application/json' },
+        signal: signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal,
+    });
+    if (!response.ok)
+        throw new Error(`企微扫码服务请求失败: HTTP ${response.status}`);
+    return response.json();
+}
+export async function createWecomQrSession(fetchImpl = fetch) {
+    const url = new URL(WECOM_QR_GENERATE_URL);
+    url.searchParams.set('source', 'wecom-cli');
+    url.searchParams.set('plat', String(platformCode()));
+    const payload = await fetchJson(url, fetchImpl);
+    const scode = String(payload?.data?.scode ?? '').trim();
+    const authUrl = String(payload?.data?.auth_url ?? '').trim();
+    if (!scode || !authUrl)
+        throw new Error('企微扫码服务未返回 scode 或授权地址');
+    const browserUrl = new URL(WECOM_QR_PAGE_URL);
+    browserUrl.searchParams.set('source', 'wecom-cli');
+    browserUrl.searchParams.set('scode', scode);
+    return { scode, authUrl, browserUrl: browserUrl.toString() };
+}
+export async function pollWecomQrCredentials(scode, opts) {
+    const fetchImpl = opts?.fetchImpl ?? fetch;
+    const timeoutMs = opts?.timeoutMs ?? 5 * 60 * 1000;
+    const intervalMs = opts?.intervalMs ?? 3_000;
+    const deadline = Date.now() + timeoutMs;
+    const url = new URL(WECOM_QR_QUERY_URL);
+    url.searchParams.set('scode', scode);
+    let previousStatus = '';
+    while (Date.now() < deadline) {
+        if (opts?.signal?.aborted)
+            throw new Error('企微扫码已取消');
+        const payload = await fetchJson(url, fetchImpl, opts?.signal);
+        const status = String(payload?.data?.status ?? 'waiting');
+        if (status !== previousStatus) {
+            opts?.onStatus?.(status);
+            previousStatus = status;
+        }
+        if (status === 'success') {
+            const botId = String(payload?.data?.bot_info?.botid ?? '').trim();
+            const secret = String(payload?.data?.bot_info?.secret ?? '').trim();
+            if (!botId || !secret)
+                throw new Error('扫码成功，但企微未返回 Bot ID 或 Secret');
+            return { botId, secret };
+        }
+        if (status === 'expired' || status === 'cancelled' || status === 'rejected') {
+            throw new Error(`企微扫码未完成: ${status}`);
+        }
+        await new Promise((resolve, reject) => {
+            const finish = () => {
+                opts?.signal?.removeEventListener('abort', onAbort);
+                resolve();
+            };
+            const timer = setTimeout(finish, intervalMs);
+            const onAbort = () => {
+                clearTimeout(timer);
+                opts?.signal?.removeEventListener('abort', onAbort);
+                reject(new Error('企微扫码已取消'));
+            };
+            opts?.signal?.addEventListener('abort', onAbort, { once: true });
+            if (opts?.signal?.aborted)
+                onAbort();
+        });
+    }
+    throw new Error('企微扫码超时，请重新生成二维码');
+}