@openclaw-china/dingtalk 2026.3.5 → 2026.3.7

package/dist/index.d.ts

@@ -14,6 +14,7 @@ import { z } from 'zod';
  * - groupAllowFrom: 群聊白名单会话 ID 列表
  * - historyLimit: 历史消息数量限制
  * - textChunkLimit: 文本分块大小限制
+ * - longTaskNoticeDelayMs: 长任务提醒延迟（毫秒，0 表示关闭）
  * - enableAICard: 是否启用 AI Card 流式响应
  * - maxFileSizeMB: 媒体文件大小限制 (MB)
  * - inboundMedia: 入站媒体归档与保留策略
@@ -39,6 +40,8 @@ declare const DingtalkConfigSchema: z.ZodObject<{
     historyLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     /** 文本分块大小限制 (钉钉单条消息最大 4000 字符) */
     textChunkLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** 长任务提醒延迟（毫秒），0 表示关闭 */
+    longTaskNoticeDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     /** 是否启用 AI Card 流式响应 */
     enableAICard: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     /** Gateway auth token（Bearer） */
@@ -65,6 +68,7 @@ declare const DingtalkConfigSchema: z.ZodObject<{
     requireMention: boolean;
     historyLimit: number;
     textChunkLimit: number;
+    longTaskNoticeDelayMs: number;
     enableAICard: boolean;
     maxFileSizeMB: number;
     clientId?: string | undefined;
@@ -88,6 +92,7 @@ declare const DingtalkConfigSchema: z.ZodObject<{
     groupAllowFrom?: string[] | undefined;
     historyLimit?: number | undefined;
     textChunkLimit?: number | undefined;
+    longTaskNoticeDelayMs?: number | undefined;
     enableAICard?: boolean | undefined;
     gatewayToken?: string | undefined;
     gatewayPassword?: string | undefined;
@@ -293,6 +298,10 @@ declare const dingtalkPlugin: {
                     type: string;
                     minimum: number;
                 };
+                longTaskNoticeDelayMs: {
+                    type: string;
+                    minimum: number;
+                };
                 enableAICard: {
                     type: string;
                 };
@@ -751,6 +760,10 @@ declare const plugin: {
                 type: string;
                 minimum: number;
             };
+            longTaskNoticeDelayMs: {
+                type: string;
+                minimum: number;
+            };
         };
     };
     /**

package/dist/index.js

@@ -4236,6 +4236,8 @@ var DingtalkConfigSchema = external_exports.object({
   historyLimit: external_exports.number().int().min(0).optional().default(10),
   /** 文本分块大小限制 (钉钉单条消息最大 4000 字符) */
   textChunkLimit: external_exports.number().int().positive().optional().default(4e3),
+  /** 长任务提醒延迟（毫秒），0 表示关闭 */
+  longTaskNoticeDelayMs: external_exports.number().int().min(0).optional().default(3e4),
   /** 是否启用 AI Card 流式响应 */
   enableAICard: external_exports.boolean().optional().default(true),
   /** Gateway auth token（Bearer） */
@@ -7910,6 +7912,76 @@ async function finishAICard(card, content, log) {
 }
 
 // src/bot-handler.ts
+var LONG_TASK_NOTICE_TEXT = "\u4EFB\u52A1\u5904\u7406\u65F6\u95F4\u8F83\u957F\uFF0C\u8BF7\u7A0D\u7B49\uFF0C\u6211\u8FD8\u5728\u7EE7\u7EED\u5904\u7406\u3002";
+var DEFAULT_LONG_TASK_NOTICE_DELAY_MS = 3e4;
+function startLongTaskNoticeTimer(params) {
+  const { delayMs, logger, sendNotice } = params;
+  let completed = false;
+  let timer = null;
+  const clear = () => {
+    if (!timer) return;
+    clearTimeout(timer);
+    timer = null;
+  };
+  if (delayMs > 0) {
+    timer = setTimeout(() => {
+      if (completed) return;
+      completed = true;
+      timer = null;
+      void sendNotice().catch((err) => {
+        logger.warn(`send long-task notice failed: ${String(err)}`);
+      });
+    }, delayMs);
+    timer.unref?.();
+  } else {
+    completed = true;
+  }
+  return {
+    markReplyDelivered: () => {
+      if (completed) return;
+      completed = true;
+      clear();
+    },
+    dispose: () => {
+      completed = true;
+      clear();
+    }
+  };
+}
+var pendingLongTaskNotices = /* @__PURE__ */ new Map();
+function armLongTaskNoticeForSession(params) {
+  const { sessionKey, delayMs, logger, sendNotice } = params;
+  pendingLongTaskNotices.get(sessionKey)?.dispose();
+  logger.debug?.(`[long-task] armed sessionKey=${sessionKey} delayMs=${delayMs}`);
+  const controller = startLongTaskNoticeTimer({
+    delayMs,
+    logger,
+    sendNotice: async () => {
+      pendingLongTaskNotices.delete(sessionKey);
+      logger.debug?.(`[long-task] firing sessionKey=${sessionKey}`);
+      await sendNotice();
+    }
+  });
+  const wrapped = {
+    markReplyDelivered: () => {
+      const active = pendingLongTaskNotices.get(sessionKey);
+      if (active !== wrapped) return;
+      pendingLongTaskNotices.delete(sessionKey);
+      logger.debug?.(`[long-task] cleared sessionKey=${sessionKey} reason=reply-delivered`);
+      controller.markReplyDelivered();
+    },
+    dispose: () => {
+      const active = pendingLongTaskNotices.get(sessionKey);
+      if (active === wrapped) {
+        pendingLongTaskNotices.delete(sessionKey);
+        logger.debug?.(`[long-task] cleared sessionKey=${sessionKey} reason=disposed`);
+      }
+      controller.dispose();
+    }
+  };
+  pendingLongTaskNotices.set(sessionKey, wrapped);
+  return wrapped;
+}
 function buildGatewayUserContent(inboundCtx, logger) {
   const base = inboundCtx.CommandBody ?? inboundCtx.Body ?? "";
   const { base: baseText, prompt } = splitCronHiddenPrompt(base);
@@ -8653,202 +8725,226 @@ async function handleDingtalkMessage(params) {
         logger.warn("AI Card creation failed, falling back to normal message");
       }
     }
-    const textApi = coreChannel?.text;
-    const textChunkLimitResolved = textApi?.resolveTextChunkLimit?.(
-      {
-        cfg,
-        channel: "dingtalk",
-        defaultLimit: dingtalkCfgResolved.textChunkLimit ?? 4e3
+    const targetId = isGroup ? ctx.conversationId : ctx.senderId;
+    const chatType = isGroup ? "group" : "direct";
+    const routeSessionKeyRaw = route.sessionKey;
+    const routeSessionKey = typeof routeSessionKeyRaw === "string" && routeSessionKeyRaw.trim() ? routeSessionKeyRaw : `dingtalk:${chatType}:${targetId}`;
+    const longTaskNotice = armLongTaskNoticeForSession({
+      sessionKey: routeSessionKey,
+      delayMs: dingtalkCfgResolved.longTaskNoticeDelayMs ?? DEFAULT_LONG_TASK_NOTICE_DELAY_MS,
+      logger,
+      sendNotice: async () => {
+        await sendMessageDingtalk({
+          cfg: dingtalkCfgResolved,
+          to: targetId,
+          text: LONG_TASK_NOTICE_TEXT,
+          chatType
+        });
       }
-    ) ?? (dingtalkCfgResolved.textChunkLimit ?? 4e3);
-    const chunkMode = textApi?.resolveChunkMode?.(cfg, "dingtalk");
-    const tableMode = "bullets";
-    const deliver = async (payload, info) => {
-      logger.debug(
-        `[reply] meta=${JSON.stringify({
-          ...resolvedTargetMeta,
-          kind: info?.kind ?? "unknown",
-          hasText: typeof payload.text === "string",
-          mediaCount: Array.isArray(payload.mediaUrls) ? payload.mediaUrls.length : payload.mediaUrl ? 1 : 0
-        })}`
-      );
-      const targetId = isGroup ? ctx.conversationId : ctx.senderId;
-      const chatType = isGroup ? "group" : "direct";
-      let sent = false;
-      const sendMediaWithFallback = async (mediaUrl) => {
-        try {
-          await sendMediaDingtalk({
-            cfg: dingtalkCfgResolved,
-            to: targetId,
-            mediaUrl,
-            chatType
-          });
-          sent = true;
-        } catch (err) {
-          logger.error(
-            `[reply] sendMediaDingtalk failed (target=${JSON.stringify(resolvedTargetMeta)}): ${String(err)}`
-          );
-          const fallbackText = `\u{1F4CE} ${mediaUrl}`;
-          await sendMessageDingtalk({
-            cfg: dingtalkCfgResolved,
-            to: targetId,
-            text: fallbackText,
-            chatType
-          });
-          sent = true;
+    });
+    try {
+      const textApi = coreChannel?.text;
+      const textChunkLimitResolved = textApi?.resolveTextChunkLimit?.(
+        {
+          cfg,
+          channel: "dingtalk",
+          defaultLimit: dingtalkCfgResolved.textChunkLimit ?? 4e3
         }
+      ) ?? (dingtalkCfgResolved.textChunkLimit ?? 4e3);
+      const chunkMode = textApi?.resolveChunkMode?.(cfg, "dingtalk");
+      const tableMode = "bullets";
+      const deliver = async (payload, info) => {
+        logger.debug(
+          `[reply] meta=${JSON.stringify({
+            ...resolvedTargetMeta,
+            kind: info?.kind ?? "unknown",
+            hasText: typeof payload.text === "string",
+            mediaCount: Array.isArray(payload.mediaUrls) ? payload.mediaUrls.length : payload.mediaUrl ? 1 : 0
+          })}`
+        );
+        let sent = false;
+        const sendMediaWithFallback = async (mediaUrl) => {
+          try {
+            await sendMediaDingtalk({
+              cfg: dingtalkCfgResolved,
+              to: targetId,
+              mediaUrl,
+              chatType
+            });
+            sent = true;
+            longTaskNotice.markReplyDelivered();
+          } catch (err) {
+            logger.error(
+              `[reply] sendMediaDingtalk failed (target=${JSON.stringify(resolvedTargetMeta)}): ${String(err)}`
+            );
+            const fallbackText = `\u{1F4CE} ${mediaUrl}`;
+            await sendMessageDingtalk({
+              cfg: dingtalkCfgResolved,
+              to: targetId,
+              text: fallbackText,
+              chatType
+            });
+            sent = true;
+            longTaskNotice.markReplyDelivered();
+          }
+        };
+        const payloadMediaUrls = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
+        const rawText = payload.text ?? "";
+        const { mediaUrls: mediaFromLines } = extractMediaLinesFromText({
+          text: rawText,
+          logger
+        });
+        const { mediaUrls: localMediaFromText } = extractLocalMediaFromText({
+          text: rawText,
+          logger
+        });
+        const mediaQueue = [];
+        const seenMedia = /* @__PURE__ */ new Set();
+        const addMedia = (value) => {
+          const trimmed = value?.trim();
+          if (!trimmed) return;
+          if (seenMedia.has(trimmed)) return;
+          seenMedia.add(trimmed);
+          mediaQueue.push(trimmed);
+        };
+        for (const url of payloadMediaUrls) addMedia(url);
+        for (const url of mediaFromLines) addMedia(url);
+        for (const url of localMediaFromText) addMedia(url);
+        const converted = textApi?.convertMarkdownTables?.(
+          rawText,
+          tableMode
+        ) ?? rawText;
+        const hasText = converted.trim().length > 0;
+        if (hasText) {
+          const chunks = textApi?.chunkTextWithMode && typeof textChunkLimitResolved === "number" && textChunkLimitResolved > 0 ? textApi.chunkTextWithMode(converted, textChunkLimitResolved, chunkMode) : [converted];
+          for (const chunk of chunks) {
+            await sendMessageDingtalk({
+              cfg: dingtalkCfgResolved,
+              to: targetId,
+              text: chunk,
+              chatType
+            });
+            sent = true;
+            longTaskNotice.markReplyDelivered();
+          }
+        }
+        for (const mediaUrl of mediaQueue) {
+          await sendMediaWithFallback(mediaUrl);
+        }
+        if (!hasText && mediaQueue.length === 0) {
+          return false;
+        }
+        return sent;
       };
-      const payloadMediaUrls = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
-      const rawText = payload.text ?? "";
-      const { mediaUrls: mediaFromLines } = extractMediaLinesFromText({
-        text: rawText,
-        logger
-      });
-      const { mediaUrls: localMediaFromText } = extractLocalMediaFromText({
-        text: rawText,
-        logger
-      });
-      const mediaQueue = [];
-      const seenMedia = /* @__PURE__ */ new Set();
-      const addMedia = (value) => {
-        const trimmed = value?.trim();
-        if (!trimmed) return;
-        if (seenMedia.has(trimmed)) return;
-        seenMedia.add(trimmed);
-        mediaQueue.push(trimmed);
-      };
-      for (const url of payloadMediaUrls) addMedia(url);
-      for (const url of mediaFromLines) addMedia(url);
-      for (const url of localMediaFromText) addMedia(url);
-      const converted = textApi?.convertMarkdownTables?.(
-        rawText,
-        tableMode
-      ) ?? rawText;
-      const hasText = converted.trim().length > 0;
-      if (hasText) {
-        const chunks = textApi?.chunkTextWithMode && typeof textChunkLimitResolved === "number" && textChunkLimitResolved > 0 ? textApi.chunkTextWithMode(converted, textChunkLimitResolved, chunkMode) : [converted];
-        for (const chunk of chunks) {
+      const humanDelay = replyApi?.resolveHumanDelayConfig?.(
+        cfg,
+        route?.agentId
+      );
+      const createDispatcherWithTyping = replyApi?.createReplyDispatcherWithTyping;
+      const createDispatcher = replyApi?.createReplyDispatcher;
+      const dispatchReplyWithDispatcher = replyApi?.dispatchReplyWithDispatcher;
+      if (dispatchReplyWithDispatcher) {
+        logger.debug(
+          `[dispatch] direct=${JSON.stringify({
+            sessionKey: route?.sessionKey,
+            ...resolvedTargetMeta
+          })}`
+        );
+        const deliveryState = { delivered: false, skippedNonSilent: 0 };
+        const result2 = await dispatchReplyWithDispatcher({
+          ctx: finalCtx,
+          cfg,
+          dispatcherOptions: {
+            deliver: async (payload, info) => {
+              const didSend = await deliver(
+                payload,
+                info
+              );
+              if (didSend) {
+                deliveryState.delivered = true;
+              }
+            },
+            humanDelay,
+            onSkip: (_payload, info) => {
+              if (info.reason !== "silent") {
+                deliveryState.skippedNonSilent += 1;
+              }
+            },
+            onError: (err, info) => {
+              logger.error(`${info.kind} reply failed: ${String(err)}`);
+            }
+          }
+        });
+        if (!deliveryState.delivered && deliveryState.skippedNonSilent > 0) {
           await sendMessageDingtalk({
             cfg: dingtalkCfgResolved,
             to: targetId,
-            text: chunk,
+            text: "No response generated. Please try again.",
             chatType
           });
-          sent = true;
+          longTaskNotice.markReplyDelivered();
         }
+        const counts2 = result2?.counts;
+        const queuedFinal2 = result2?.queuedFinal;
+        logger.debug(
+          `dispatch complete (queuedFinal=${typeof queuedFinal2 === "boolean" ? queuedFinal2 : "unknown"}, replies=${counts2?.final ?? 0})`
+        );
+        return;
       }
-      for (const mediaUrl of mediaQueue) {
-        await sendMediaWithFallback(mediaUrl);
-      }
-      if (!hasText && mediaQueue.length === 0) {
-        return false;
+      const dispatcherResult = createDispatcherWithTyping ? createDispatcherWithTyping({
+        deliver: async (payload, info) => {
+          await deliver(payload, info);
+        },
+        humanDelay,
+        onError: (err, info) => {
+          logger.error(`${info.kind} reply failed: ${String(err)}`);
+        }
+      }) : {
+        dispatcher: createDispatcher?.({
+          deliver: async (payload, info) => {
+            await deliver(payload, info);
+          },
+          humanDelay,
+          onError: (err, info) => {
+            logger.error(`${info.kind} reply failed: ${String(err)}`);
+          }
+        }),
+        replyOptions: {},
+        markDispatchIdle: () => void 0
+      };
+      const dispatcher = dispatcherResult?.dispatcher;
+      if (!dispatcher) {
+        logger.debug("dispatcher not available, skipping dispatch");
+        return;
       }
-      return sent;
-    };
-    const humanDelay = replyApi?.resolveHumanDelayConfig?.(
-      cfg,
-      route?.agentId
-    );
-    const createDispatcherWithTyping = replyApi?.createReplyDispatcherWithTyping;
-    const createDispatcher = replyApi?.createReplyDispatcher;
-    const dispatchReplyWithBufferedBlockDispatcher = replyApi?.dispatchReplyWithBufferedBlockDispatcher;
-    if (dispatchReplyWithBufferedBlockDispatcher) {
       logger.debug(
-        `[dispatch] buffered=${JSON.stringify({
+        `[dispatch] legacy=${JSON.stringify({
           sessionKey: route?.sessionKey,
           ...resolvedTargetMeta
         })}`
       );
-      const deliveryState = { delivered: false, skippedNonSilent: 0 };
-      const result2 = await dispatchReplyWithBufferedBlockDispatcher({
+      const dispatchReplyFromConfig = replyApi?.dispatchReplyFromConfig;
+      if (!dispatchReplyFromConfig) {
+        logger.debug("dispatchReplyFromConfig not available");
+        return;
+      }
+      const result = await dispatchReplyFromConfig({
         ctx: finalCtx,
         cfg,
-        dispatcherOptions: {
-          deliver: async (payload, info) => {
-            const didSend = await deliver(
-              payload,
-              info
-            );
-            if (didSend) {
-              deliveryState.delivered = true;
-            }
-          },
-          humanDelay,
-          onSkip: (_payload, info) => {
-            if (info.reason !== "silent") {
-              deliveryState.skippedNonSilent += 1;
-            }
-          },
-          onError: (err, info) => {
-            logger.error(`${info.kind} reply failed: ${String(err)}`);
-          }
-        }
+        dispatcher,
+        replyOptions: dispatcherResult?.replyOptions ?? {}
       });
-      if (!deliveryState.delivered && deliveryState.skippedNonSilent > 0) {
-        await sendMessageDingtalk({
-          cfg: dingtalkCfgResolved,
-          to: isGroup ? ctx.conversationId : ctx.senderId,
-          text: "No response generated. Please try again.",
-          chatType: isGroup ? "group" : "direct"
-        });
-      }
-      const counts2 = result2?.counts;
-      const queuedFinal2 = result2?.queuedFinal;
+      const markDispatchIdle = dispatcherResult?.markDispatchIdle;
+      markDispatchIdle?.();
+      const counts = result?.counts;
+      const queuedFinal = result?.queuedFinal;
       logger.debug(
-        `dispatch complete (queuedFinal=${typeof queuedFinal2 === "boolean" ? queuedFinal2 : "unknown"}, replies=${counts2?.final ?? 0})`
+        `dispatch complete (queuedFinal=${typeof queuedFinal === "boolean" ? queuedFinal : "unknown"}, replies=${counts?.final ?? 0})`
       );
-      return;
-    }
-    const dispatcherResult = createDispatcherWithTyping ? createDispatcherWithTyping({
-      deliver: async (payload, info) => {
-        await deliver(payload, info);
-      },
-      humanDelay,
-      onError: (err, info) => {
-        logger.error(`${info.kind} reply failed: ${String(err)}`);
-      }
-    }) : {
-      dispatcher: createDispatcher?.({
-        deliver: async (payload, info) => {
-          await deliver(payload, info);
-        },
-        humanDelay,
-        onError: (err, info) => {
-          logger.error(`${info.kind} reply failed: ${String(err)}`);
-        }
-      }),
-      replyOptions: {},
-      markDispatchIdle: () => void 0
-    };
-    const dispatcher = dispatcherResult?.dispatcher;
-    if (!dispatcher) {
-      logger.debug("dispatcher not available, skipping dispatch");
-      return;
-    }
-    logger.debug(
-      `[dispatch] standard=${JSON.stringify({
-        sessionKey: route?.sessionKey,
-        ...resolvedTargetMeta
-      })}`
-    );
-    const dispatchReplyFromConfig = replyApi?.dispatchReplyFromConfig;
-    if (!dispatchReplyFromConfig) {
-      logger.debug("dispatchReplyFromConfig not available");
-      return;
+    } catch (err) {
+      longTaskNotice.dispose();
+      throw err;
     }
-    const result = await dispatchReplyFromConfig({
-      ctx: finalCtx,
-      cfg,
-      dispatcher,
-      replyOptions: dispatcherResult?.replyOptions ?? {}
-    });
-    const markDispatchIdle = dispatcherResult?.markDispatchIdle;
-    markDispatchIdle?.();
-    const counts = result?.counts;
-    const queuedFinal = result?.queuedFinal;
-    logger.debug(
-      `dispatch complete (queuedFinal=${typeof queuedFinal === "boolean" ? queuedFinal : "unknown"}, replies=${counts?.final ?? 0})`
-    );
   } catch (err) {
     logger.error(
       `failed to dispatch message (target=${JSON.stringify(inboundTargetMeta)}): ${String(err)}`
@@ -9681,6 +9777,7 @@ var dingtalkPlugin = {
         groupAllowFrom: { type: "array", items: { type: "string" } },
         historyLimit: { type: "integer", minimum: 0 },
         textChunkLimit: { type: "integer", minimum: 1 },
+        longTaskNoticeDelayMs: { type: "integer", minimum: 0 },
         enableAICard: { type: "boolean" },
         gatewayToken: { type: "string" },
         gatewayPassword: { type: "string" },
@@ -9861,7 +9958,8 @@ var plugin = {
       allowFrom: { type: "array", items: { type: "string" } },
       groupAllowFrom: { type: "array", items: { type: "string" } },
       historyLimit: { type: "integer", minimum: 0 },
-      textChunkLimit: { type: "integer", minimum: 1 }
+      textChunkLimit: { type: "integer", minimum: 1 },
+      longTaskNoticeDelayMs: { type: "integer", minimum: 0 }
     }
   },
   /**