@openclaw-china/qqbot 2026.3.16 → 2026.3.18

package/dist/index.d.ts

@@ -4,6 +4,8 @@ declare const QQBotC2CMarkdownDeliveryModeSchema: z.ZodDefault<z.ZodOptional<z.Z
 type QQBotC2CMarkdownDeliveryMode = z.input<typeof QQBotC2CMarkdownDeliveryModeSchema>;
 declare const QQBotC2CMarkdownChunkStrategySchema: z.ZodDefault<z.ZodOptional<z.ZodEnum<["markdown-block", "length"]>>>;
 type QQBotC2CMarkdownChunkStrategy = z.input<typeof QQBotC2CMarkdownChunkStrategySchema>;
+declare const QQBotTypingHeartbeatModeSchema: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "idle", "always"]>>>;
+type QQBotTypingHeartbeatMode = z.input<typeof QQBotTypingHeartbeatModeSchema>;
 declare const QQBotAccountSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodBoolean>;
@@ -29,6 +31,9 @@ declare const QQBotAccountSchema: z.ZodObject<{
     markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
     c2cMarkdownChunkStrategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["markdown-block", "length"]>>>;
+    typingHeartbeatMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "idle", "always"]>>>;
+    typingHeartbeatIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    typingInputSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
     groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
     requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -55,6 +60,9 @@ declare const QQBotAccountSchema: z.ZodObject<{
     markdownSupport: boolean;
     c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
     c2cMarkdownChunkStrategy: "markdown-block" | "length";
+    typingHeartbeatMode: "none" | "idle" | "always";
+    typingHeartbeatIntervalMs: number;
+    typingInputSeconds: number;
     dmPolicy: "open" | "pairing" | "allowlist";
     groupPolicy: "open" | "allowlist" | "disabled";
     requireMention: boolean;
@@ -97,6 +105,9 @@ declare const QQBotAccountSchema: z.ZodObject<{
     markdownSupport?: boolean | undefined;
     c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
     c2cMarkdownChunkStrategy?: "markdown-block" | "length" | undefined;
+    typingHeartbeatMode?: "none" | "idle" | "always" | undefined;
+    typingHeartbeatIntervalMs?: number | undefined;
+    typingInputSeconds?: number | undefined;
     dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
     groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
     requireMention?: boolean | undefined;
@@ -139,6 +150,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
     markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
     c2cMarkdownChunkStrategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["markdown-block", "length"]>>>;
+    typingHeartbeatMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "idle", "always"]>>>;
+    typingHeartbeatIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    typingInputSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
     groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
     requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -188,6 +202,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
         markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
         c2cMarkdownChunkStrategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["markdown-block", "length"]>>>;
+        typingHeartbeatMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "idle", "always"]>>>;
+        typingHeartbeatIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        typingInputSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
         groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
         requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -214,6 +231,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
         markdownSupport: boolean;
         c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
         c2cMarkdownChunkStrategy: "markdown-block" | "length";
+        typingHeartbeatMode: "none" | "idle" | "always";
+        typingHeartbeatIntervalMs: number;
+        typingInputSeconds: number;
         dmPolicy: "open" | "pairing" | "allowlist";
         groupPolicy: "open" | "allowlist" | "disabled";
         requireMention: boolean;
@@ -256,6 +276,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
         markdownSupport?: boolean | undefined;
         c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
         c2cMarkdownChunkStrategy?: "markdown-block" | "length" | undefined;
+        typingHeartbeatMode?: "none" | "idle" | "always" | undefined;
+        typingHeartbeatIntervalMs?: number | undefined;
+        typingInputSeconds?: number | undefined;
         dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
         groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
         requireMention?: boolean | undefined;
@@ -277,6 +300,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
     markdownSupport: boolean;
     c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
     c2cMarkdownChunkStrategy: "markdown-block" | "length";
+    typingHeartbeatMode: "none" | "idle" | "always";
+    typingHeartbeatIntervalMs: number;
+    typingInputSeconds: number;
     dmPolicy: "open" | "pairing" | "allowlist";
     groupPolicy: "open" | "allowlist" | "disabled";
     requireMention: boolean;
@@ -309,6 +335,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
         markdownSupport: boolean;
         c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
         c2cMarkdownChunkStrategy: "markdown-block" | "length";
+        typingHeartbeatMode: "none" | "idle" | "always";
+        typingHeartbeatIntervalMs: number;
+        typingInputSeconds: number;
         dmPolicy: "open" | "pairing" | "allowlist";
         groupPolicy: "open" | "allowlist" | "disabled";
         requireMention: boolean;
@@ -352,6 +381,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
     markdownSupport?: boolean | undefined;
     c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
     c2cMarkdownChunkStrategy?: "markdown-block" | "length" | undefined;
+    typingHeartbeatMode?: "none" | "idle" | "always" | undefined;
+    typingHeartbeatIntervalMs?: number | undefined;
+    typingInputSeconds?: number | undefined;
     dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
     groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
     requireMention?: boolean | undefined;
@@ -384,6 +416,9 @@ declare const QQBotConfigSchema: z.ZodObject<{
         markdownSupport?: boolean | undefined;
         c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
         c2cMarkdownChunkStrategy?: "markdown-block" | "length" | undefined;
+        typingHeartbeatMode?: "none" | "idle" | "always" | undefined;
+        typingHeartbeatIntervalMs?: number | undefined;
+        typingInputSeconds?: number | undefined;
         dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
         groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
         requireMention?: boolean | undefined;
@@ -419,6 +454,7 @@ interface ResolvedQQBotAccount {
     markdownSupport?: boolean;
     c2cMarkdownDeliveryMode?: QQBotC2CMarkdownDeliveryMode;
     c2cMarkdownChunkStrategy?: QQBotC2CMarkdownChunkStrategy;
+    typingHeartbeatMode?: QQBotTypingHeartbeatMode;
 }
 interface QQBotSendResult {
     channel: "qqbot";

package/dist/index.js

@@ -4228,6 +4228,10 @@ var displayAliasesSchema = external_exports.record(
 ).optional();
 var QQBotC2CMarkdownDeliveryModeSchema = external_exports.enum(["passive", "proactive-table-only", "proactive-all"]).optional().default("proactive-table-only");
 var QQBotC2CMarkdownChunkStrategySchema = external_exports.enum(["markdown-block", "length"]).optional().default("markdown-block");
+var QQBotTypingHeartbeatModeSchema = external_exports.enum(["none", "idle", "always"]).optional().default("idle");
+var DEFAULT_QQBOT_TYPING_HEARTBEAT_MODE = "idle";
+var DEFAULT_QQBOT_TYPING_HEARTBEAT_INTERVAL_MS = 5e3;
+var DEFAULT_QQBOT_TYPING_INPUT_SECONDS = 60;
 var QQBotAccountSchema = external_exports.object({
   name: external_exports.string().optional(),
   enabled: external_exports.boolean().optional(),
@@ -4243,6 +4247,13 @@ var QQBotAccountSchema = external_exports.object({
   markdownSupport: external_exports.boolean().optional().default(true),
   c2cMarkdownDeliveryMode: QQBotC2CMarkdownDeliveryModeSchema,
   c2cMarkdownChunkStrategy: QQBotC2CMarkdownChunkStrategySchema,
+  typingHeartbeatMode: QQBotTypingHeartbeatModeSchema,
+  typingHeartbeatIntervalMs: external_exports.number().int().positive().optional().default(
+    DEFAULT_QQBOT_TYPING_HEARTBEAT_INTERVAL_MS
+  ),
+  typingInputSeconds: external_exports.number().int().positive().optional().default(
+    DEFAULT_QQBOT_TYPING_INPUT_SECONDS
+  ),
   dmPolicy: external_exports.enum(["open", "pairing", "allowlist"]).optional().default("open"),
   groupPolicy: external_exports.enum(["open", "allowlist", "disabled"]).optional().default("open"),
   requireMention: external_exports.boolean().optional().default(true),
@@ -4292,6 +4303,15 @@ function resolveInboundMediaKeepDays(config) {
 function resolveQQBotAutoSendLocalPathMedia(config) {
   return config?.autoSendLocalPathMedia ?? true;
 }
+function resolveQQBotTypingHeartbeatMode(config) {
+  return config?.typingHeartbeatMode ?? DEFAULT_QQBOT_TYPING_HEARTBEAT_MODE;
+}
+function resolveQQBotTypingHeartbeatIntervalMs(config) {
+  return config?.typingHeartbeatIntervalMs ?? DEFAULT_QQBOT_TYPING_HEARTBEAT_INTERVAL_MS;
+}
+function resolveQQBotTypingInputSeconds(config) {
+  return config?.typingInputSeconds ?? DEFAULT_QQBOT_TYPING_INPUT_SECONDS;
+}
 function resolveInboundMediaTempDir() {
   return DEFAULT_INBOUND_MEDIA_TEMP_DIR;
 }
@@ -9623,6 +9643,37 @@ function startLongTaskNoticeTimer(params) {
     }
   };
 }
+function startQQBotTypingHeartbeat(params) {
+  const { intervalMs, renew, shouldRenew } = params;
+  let stopped = false;
+  let timer = null;
+  let renewalInFlight = false;
+  const clear = () => {
+    if (!timer) return;
+    clearInterval(timer);
+    timer = null;
+  };
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    clear();
+  };
+  if (intervalMs > 0) {
+    timer = setInterval(() => {
+      if (stopped || renewalInFlight) return;
+      if (shouldRenew && !shouldRenew()) return;
+      renewalInFlight = true;
+      void renew().catch(() => void 0).finally(() => {
+        renewalInFlight = false;
+      });
+    }, intervalMs);
+    timer.unref?.();
+  }
+  return {
+    stop,
+    dispose: stop
+  };
+}
 function isHttpUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
@@ -11029,6 +11080,9 @@ async function dispatchToAgent(params) {
   };
   const target = resolveChatTarget(inbound);
   const outboundAccountId = route.accountId ?? accountId;
+  const typingHeartbeatMode = resolveQQBotTypingHeartbeatMode(qqCfg);
+  const typingHeartbeatIntervalMs = resolveQQBotTypingHeartbeatIntervalMs(qqCfg);
+  const typingInputSeconds = resolveQQBotTypingInputSeconds(qqCfg);
   let typingRefIdx;
   if (inbound.c2cOpenid && !isFastAbortCommand && !shouldSuppressVisibleReplies()) {
     const typing = await qqbotOutbound.sendTyping({
@@ -11036,7 +11090,7 @@ async function dispatchToAgent(params) {
       to: `user:${inbound.c2cOpenid}`,
       replyToId: inbound.messageId,
       replyEventId: inbound.eventId,
-      inputSecond: 60,
+      inputSecond: typingInputSeconds,
       accountId: outboundAccountId
     });
     if (typing.error) {
@@ -11052,10 +11106,15 @@ async function dispatchToAgent(params) {
   }
   let replyDelivered = false;
   let groupMessageInterfaceBlocked = false;
+  let lastVisibleOutboundAt = Date.now();
+  let typingHeartbeat = null;
   const markReplyDelivered = () => {
     replyDelivered = true;
     longTaskNotice.markReplyDelivered();
   };
+  const markVisibleOutboundStarted = () => {
+    lastVisibleOutboundAt = Date.now();
+  };
   const markGroupMessageInterfaceBlocked = (error) => {
     if (!isQQBotGroupMessageInterfaceBlocked(error)) return;
     if (!groupMessageInterfaceBlocked) {
@@ -11063,11 +11122,40 @@ async function dispatchToAgent(params) {
     }
     groupMessageInterfaceBlocked = true;
   };
+  if (inbound.c2cOpenid && typingHeartbeatMode !== "none" && !isFastAbortCommand && !shouldSuppressVisibleReplies()) {
+    typingHeartbeat = startQQBotTypingHeartbeat({
+      intervalMs: typingHeartbeatIntervalMs,
+      shouldRenew: () => {
+        if (shouldSuppressVisibleReplies()) {
+          return false;
+        }
+        if (typingHeartbeatMode === "always") {
+          return true;
+        }
+        return Date.now() - lastVisibleOutboundAt >= typingHeartbeatIntervalMs;
+      },
+      renew: async () => {
+        try {
+          const typing = await qqbotOutbound.sendTyping({
+            cfg: { channels: { qqbot: qqCfg } },
+            to: `user:${inbound.c2cOpenid}`,
+            replyToId: inbound.messageId,
+            replyEventId: inbound.eventId,
+            inputSecond: typingInputSeconds,
+            accountId: outboundAccountId
+          });
+          void typing;
+        } catch {
+        }
+      }
+    });
+  }
   const longTaskNotice = startLongTaskNoticeTimer({
     delayMs: qqCfg.longTaskNoticeDelayMs ?? DEFAULT_LONG_TASK_NOTICE_DELAY_MS,
     logger,
     sendNotice: async () => {
       if (groupMessageInterfaceBlocked || isFastAbortCommand || shouldSuppressVisibleReplies()) return;
+      markVisibleOutboundStarted();
       const result = await qqbotOutbound.sendText({
         cfg: { channels: { qqbot: qqCfg } },
         to: target.to,
@@ -11080,7 +11168,7 @@ async function dispatchToAgent(params) {
         logger.warn(`send long-task notice failed: ${result.error}`);
         markGroupMessageInterfaceBlocked(result.error);
       } else {
-        replyDelivered = true;
+        markReplyDelivered();
       }
     }
   });
@@ -11104,6 +11192,7 @@ async function dispatchToAgent(params) {
       if (shouldSuppressVisibleReplies()) {
         return;
       }
+      markVisibleOutboundStarted();
       const fallback = await qqbotOutbound.sendText({
         cfg: { channels: { qqbot: qqCfg } },
         to: target.to,
@@ -11116,7 +11205,7 @@ async function dispatchToAgent(params) {
         logger.error(`sendText ASR fallback failed: ${fallback.error}`);
         markGroupMessageInterfaceBlocked(fallback.error);
       } else {
-        replyDelivered = true;
+        markReplyDelivered();
       }
       return;
     }
@@ -11322,6 +11411,9 @@ async function dispatchToAgent(params) {
         `delivery=${deliveryLabel} to=${target.to} chunks=${textChunks.length} media=${mediaQueue.length} replyToId=${textReplyRefs.replyToId ? "yes" : "no"} replyEventId=${textReplyRefs.replyEventId ? "yes" : "no"} phase=${params2.phase} tableMode=${String(resolvedTableMode)} chunkMode=${String(chunkMode ?? "default")} chunkStrategy=${c2cMarkdownChunkStrategy}`
       );
       if (!shouldSuppressVisibleReplies()) {
+        if (mediaQueue.length > 0) {
+          markVisibleOutboundStarted();
+        }
         await sendQQBotMediaWithFallback({
           qqCfg,
           to: target.to,
@@ -11350,6 +11442,7 @@ async function dispatchToAgent(params) {
         logger.info(
           `delivery=${deliveryLabel} segment=1/1 chunk=${chunkIndex + 1}/${textChunks.length} phase=${params2.phase} preview=${formatQQBotOutboundPreview(chunk)}`
         );
+        markVisibleOutboundStarted();
         const result = await qqbotOutbound.sendText({
           cfg: { channels: { qqbot: qqCfg } },
           to: target.to,
@@ -11464,6 +11557,7 @@ async function dispatchToAgent(params) {
           if (shouldSuppressVisibleReplies()) {
             return;
           }
+          markVisibleOutboundStarted();
           const result = await qqbotOutbound.sendText({
             cfg: { channels: { qqbot: qqCfg } },
             to: target.to,
@@ -11483,6 +11577,9 @@ async function dispatchToAgent(params) {
       if (shouldSuppressVisibleReplies()) {
         return;
       }
+      if (mediaQueue.length > 0) {
+        markVisibleOutboundStarted();
+      }
       await sendQQBotMediaWithFallback({
         qqCfg,
         to: target.to,
@@ -11587,6 +11684,7 @@ async function dispatchToAgent(params) {
     });
     if (noReplyFallback && !groupMessageInterfaceBlocked && !isFastAbortCommand && !shouldSuppressVisibleReplies()) {
       logger.info("no visible reply generated for group mention; sending fallback text");
+      markVisibleOutboundStarted();
       const fallbackResult = await qqbotOutbound.sendText({
         cfg: { channels: { qqbot: qqCfg } },
         to: target.to,
@@ -11603,6 +11701,7 @@ async function dispatchToAgent(params) {
       }
     }
   } finally {
+    typingHeartbeat?.dispose();
     longTaskNotice.dispose();
     try {
       await pruneInboundMediaDir({