@wecom/wecom-openclaw-plugin 2026.3.25-beta.0 → 2026.3.25

package/dist/index.esm.js

@@ -420,8 +420,6 @@ const IMAGE_DOWNLOAD_TIMEOUT_MS = 30000;
 const FILE_DOWNLOAD_TIMEOUT_MS = 60000;
 /** 消息发送超时时间（毫秒） */
 const REPLY_SEND_TIMEOUT_MS = 15000;
-/** 消息处理总超时时间（毫秒） */
-const MESSAGE_PROCESS_TIMEOUT_MS = 5 * 60 * 1000;
 /** WebSocket 心跳间隔（毫秒） */
 const WS_HEARTBEAT_INTERVAL_MS = 30000;
 /** WebSocket 连接断开时的最大重连次数 */
@@ -614,6 +612,23 @@ class TimeoutError extends Error {
  * 负责通过 WSClient 发送回复消息，包含超时保护
  */
 // ============================================================================
+// 流式过期错误（errcode 846608）
+// ============================================================================
+/** 流式回复超时错误码（>6分钟未更新，服务端拒绝继续流式更新） */
+const STREAM_EXPIRED_ERRCODE = 846608;
+/**
+ * 流式回复过期错误
+ * 当服务端返回 errcode=846608 时抛出，表示流式消息已超过6分钟无法更新，
+ * 调用方需降级为主动发送（sendMessage）方式回复。
+ */
+class StreamExpiredError extends Error {
+    constructor(message) {
+        super(message ?? `Stream message update expired (errcode=${STREAM_EXPIRED_ERRCODE})`);
+        this.errcode = STREAM_EXPIRED_ERRCODE;
+        this.name = "StreamExpiredError";
+    }
+}
+// ============================================================================
 // 消息发送
 // ============================================================================
 /**
@@ -633,7 +648,18 @@ async function sendWeComReply(params) {
         throw new Error("WSClient not connected");
     }
     // 使用 SDK 的 replyStream 方法发送消息，带超时保护
-    await withTimeout(wsClient.replyStream(frame, streamId, text, finish), REPLY_SEND_TIMEOUT_MS, `Reply send timed out (streamId=${streamId})`);
+    try {
+        await withTimeout(wsClient.replyStream(frame, streamId, text, finish), REPLY_SEND_TIMEOUT_MS, `Reply send timed out (streamId=${streamId})`);
+    }
+    catch (err) {
+        // 服务端返回 846608：流式消息超过6分钟无法更新，需降级为主动发送
+        const errMsg = err?.errmsg || err?.message || String(err);
+        if (err?.errcode === STREAM_EXPIRED_ERRCODE ||
+            errMsg.includes(String(STREAM_EXPIRED_ERRCODE))) {
+            throw new StreamExpiredError(errMsg);
+        }
+        throw err;
+    }
     runtime.log?.(`[plugin -> server] streamId=${streamId}, finish=${finish}`);
     return streamId;
 }
@@ -1628,7 +1654,7 @@ function buildMessageContext(frame, account, config, text, mediaList, quoteConte
  * 发送"思考中"消息
  */
 async function sendThinkingReply(params) {
-    const { wsClient, frame, streamId, runtime } = params;
+    const { wsClient, frame, streamId, runtime, state } = params;
     try {
         await sendWeComReply({
             wsClient,
@@ -1640,7 +1666,13 @@ async function sendThinkingReply(params) {
         });
     }
     catch (err) {
-        runtime.error?.(`[wecom] Failed to send thinking message: ${String(err)}`);
+        if (err instanceof StreamExpiredError && state) {
+            state.streamExpired = true;
+            runtime.log?.(`[wecom] Stream expired during thinking reply, will fallback to proactive send`);
+        }
+        else {
+            runtime.error?.(`[wecom] Failed to send thinking message: ${String(err)}`);
+        }
     }
 }
 /**
@@ -1654,7 +1686,7 @@ async function sendMediaBatch(ctx, mediaUrls) {
     const body = frame.body;
     const chatId = body.chatid || body.from.userid;
     const mediaLocalRoots = await getExtendedMediaLocalRoots(account.config);
-    runtime.log?.(`[wecom][debug] mediaLocalRoots=${JSON.stringify(mediaLocalRoots)}, mediaUrls=${JSON.stringify(mediaUrls)}, hasText=${!!state.hasText}`);
+    runtime.log?.(`[wecom][debug] mediaLocalRoots=${JSON.stringify(mediaLocalRoots)}, mediaUrls=${JSON.stringify(mediaUrls)}`);
     for (const mediaUrl of mediaUrls) {
         const result = await uploadAndSendMedia({
             wsClient,
@@ -1695,9 +1727,15 @@ async function sendMediaBatch(ctx, mediaUrls) {
  *    （agent 可能已通过内置 message 工具直接发送了文件，
  *    该路径走 outbound.sendMedia 完全绕过 deliver 回调，
  *    所以 state 中无记录，但文件已实际送达）
+ *
+ * 降级策略：
+ * - 当 streamExpired=true（errcode 846608）时，流式通道已不可用（>6分钟），
+ *   改用 wsClient.sendMessage 主动发送完整文本。
  */
 async function finishThinkingStream(ctx) {
     const { wsClient, frame, state, runtime } = ctx;
+    const body = frame.body;
+    const chatId = body.chatid || body.from.userid;
     let finishText = state.accumulatedText;
     if (state.hasMedia) {
         if (state.hasMediaFailed && state.mediaErrorSummary) {
@@ -1712,7 +1750,28 @@ async function finishThinkingStream(ctx) {
     //   finishText = "✅ 处理完成。";
     // }
     if (finishText) {
-        await sendWeComReply({ wsClient, frame, text: finishText, runtime, finish: true, streamId: state.streamId });
+        // 尝试流式发送；若已知过期或发送时发现过期，统一降级为主动发送
+        let expired = state.streamExpired;
+        if (!expired) {
+            try {
+                await sendWeComReply({ wsClient, frame, text: finishText, runtime, finish: true, streamId: state.streamId });
+            }
+            catch (err) {
+                if (err instanceof StreamExpiredError) {
+                    expired = true;
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        if (expired) {
+            runtime.log?.(`[wecom] Stream expired, sending final text via sendMessage (proactive)`);
+            await wsClient.sendMessage(chatId, {
+                msgtype: "markdown",
+                markdown: { content: finishText },
+            });
+        }
     }
 }
 /**
@@ -1735,11 +1794,25 @@ async function routeAndDispatchMessage(params) {
         await core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
             ctx: ctxPayload,
             cfg: config,
+            // replyResolver: async (ctx, opts) => {
+            //   const startTime = Date.now();
+            //   const TEN_MINUTES = 7 * 60 * 1000;
+            //
+            //   console.log('开始输出内容');
+            //
+            //   while (Date.now() - startTime < TEN_MINUTES) {
+            //     // 每隔一段时间发送一个 block reply
+            //     await opts?.onBlockReply?.({ text: `输出内容 ${new Date().toISOString()}` });
+            //     await new Promise(resolve => setTimeout(resolve, 30 * 1000)); // 每5秒输出一次
+            //   }
+            //
+            //   return { text: "10分钟输出完成" }; // 最终回复
+            // },
             dispatcherOptions: {
                 onReplyStart: async () => {
                     if (!isShowThink && state.streamId && !state.accumulatedText) {
                         try {
-                            await sendThinkingReply({ wsClient, frame, streamId: state.streamId, runtime });
+                            await sendThinkingReply({ wsClient, frame, streamId: state.streamId, runtime, state });
                         }
                         catch (e) {
                             runtime.error?.(`[wecom] sendThinkingReply threw err: ${String(e)}`);
@@ -1772,9 +1845,20 @@ async function routeAndDispatchMessage(params) {
                             runtime.error?.(`[wecom] sendMediaBatch threw: ${errMsg}`);
                         }
                     }
-                    // 中间帧：有可见文本时流式更新
-                    if (info.kind !== "final" && state.hasText && state.accumulatedText) {
-                        await sendWeComReply({ wsClient, frame, text: state.accumulatedText, runtime, finish: false, streamId: state.streamId });
+                    // 中间帧：有可见文本时流式更新（流式过期后跳过，等 deliver 完成后主动发送）
+                    if (info.kind !== "final" && state.accumulatedText && !state.streamExpired) {
+                        try {
+                            await sendWeComReply({ wsClient, frame, text: state.accumulatedText, runtime, finish: false, streamId: state.streamId });
+                        }
+                        catch (err) {
+                            if (err instanceof StreamExpiredError) {
+                                state.streamExpired = true;
+                                runtime.log?.(`[wecom] Stream expired during intermediate reply, will fallback to proactive send`);
+                            }
+                            else {
+                                throw err;
+                            }
+                        }
                     }
                 },
                 onError: (err, info) => {
@@ -1899,7 +1983,7 @@ async function processWeComMessage(params) {
     const ctxPayload = buildMessageContext(frame, account, config, text, mediaList, quoteContent);
     // runtime.log?.(`[plugin -> openclaw] body=${text}, mediaPaths=${JSON.stringify(mediaList.map(m => m.path))}${quoteContent ? `, quote=${quoteContent}` : ''}`);
     try {
-        await withTimeout(routeAndDispatchMessage({
+        await routeAndDispatchMessage({
             ctxPayload,
             config,
             account,
@@ -1908,10 +1992,10 @@ async function processWeComMessage(params) {
             state,
             runtime,
             onCleanup: cleanupState,
-        }), MESSAGE_PROCESS_TIMEOUT_MS, `Message processing timed out (msgId=${messageId})`);
+        });
     }
     catch (err) {
-        runtime.error?.(`[wecom][plugin] Message processing failed or timed out: ${String(err)}`);
+        runtime.error?.(`[wecom][plugin] Message processing failed: ${String(err)}`);
         cleanupState();
     }
 }