@soimy/dingtalk 3.6.11 → 3.7.0

package/openclaw.plugin.json

@@ -251,6 +251,15 @@
             "default": 1000,
             "description": "Throttle interval in milliseconds between AI card streaming updates."
           },
+          "cardTaskProgress": {
+            "type": "boolean",
+            "description": "Live task-progress block on AI cards for long-running tasks. true forces it on, false forces it off; when unset it is on unless cardStreamingMode is explicitly set to off."
+          },
+          "cardTaskProgressRefresh": {
+            "type": "string",
+            "enum": ["heartbeat", "interval"],
+            "description": "How tool-driven progress changes reach the card. heartbeat (effective default) coalesces them into the 30-second refresh; interval pushes on every correlated tool event, throttled by cardStreamInterval."
+          },
           "aicardDegradeMs": {
             "type": "integer",
             "minimum": 60000,
@@ -283,7 +292,14 @@
             "type": "object",
             "description": "Status line visibility toggles for the AI card footer.",
             "additionalProperties": false,
-            "default": { "model": true, "effort": true, "agent": true, "taskTime": false, "tokens": false, "dapiUsage": false },
+            "default": {
+              "model": true,
+              "effort": true,
+              "agent": true,
+              "taskTime": false,
+              "tokens": false,
+              "dapiUsage": false
+            },
             "properties": {
               "model": {
                 "type": "boolean",
@@ -325,6 +341,54 @@
             "type": "boolean",
             "description": "Legacy compatibility field from older host or runtime integrations. It is not used by the current runtime and new configs should omit it."
           },
+          "gatewayCapabilities": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Capability gates and allowlists for docs Gateway RPCs (dingtalk.docs.* / dingtalk-connector.docs.*) and proactive-send Gateway RPCs (dingtalk-connector.sendToUser/sendToGroup/send). All capabilities default to enabled; these RPCs rely on the host Gateway trust model and do not authenticate the caller.",
+            "properties": {
+              "tools": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Capability switches. Omitted switches default to enabled.",
+                "properties": {
+                  "docs": {
+                    "type": "boolean",
+                    "description": "Enable dingtalk.docs.* and dingtalk-connector.docs.* Gateway RPCs. Defaults to true when omitted."
+                  },
+                  "proactiveSend": {
+                    "type": "boolean",
+                    "description": "Enable dingtalk-connector.sendToUser/sendToGroup/send proactive-send RPCs. Defaults to true when omitted."
+                  }
+                }
+              },
+              "docs": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Docs RPC allowlist. When allowedSpaceIds is configured, requests without a spaceId (for example dingtalk.docs.append) are denied as well.",
+                "properties": {
+                  "allowedSpaceIds": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "type": "string", "minLength": 1 },
+                    "description": "When set, docs RPCs only accept these spaceId values."
+                  }
+                }
+              },
+              "send": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Proactive-send target allowlist.",
+                "properties": {
+                  "allowedTargets": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "type": "string", "pattern": "^(user|group):\\S+$" },
+                    "description": "When set, proactive-send RPCs only accept these user:<id> or group:<conversationId> targets."
+                  }
+                }
+              }
+            }
+          },
           "accounts": {
             "type": "object",
             "description": "Named multi-account DingTalk configurations. Each account can override most top-level settings and inherits unspecified values from the top level.",
@@ -557,6 +621,15 @@
                   "default": 1000,
                   "description": "Throttle interval in milliseconds between AI card streaming updates."
                 },
+                "cardTaskProgress": {
+                  "type": "boolean",
+                  "description": "Live task-progress block on AI cards for long-running tasks. true forces it on, false forces it off; when unset it is on unless cardStreamingMode is explicitly set to off."
+                },
+                "cardTaskProgressRefresh": {
+                  "type": "string",
+                  "enum": ["heartbeat", "interval"],
+                  "description": "How tool-driven progress changes reach the card. heartbeat (effective default) coalesces them into the 30-second refresh; interval pushes on every correlated tool event, throttled by cardStreamInterval."
+                },
                 "aicardDegradeMs": {
                   "type": "integer",
                   "minimum": 60000,
@@ -589,7 +662,14 @@
                   "type": "object",
                   "description": "Status line visibility toggles for the AI card footer.",
                   "additionalProperties": false,
-                  "default": { "model": true, "effort": true, "agent": true, "taskTime": false, "tokens": false, "dapiUsage": false },
+                  "default": {
+                    "model": true,
+                    "effort": true,
+                    "agent": true,
+                    "taskTime": false,
+                    "tokens": false,
+                    "dapiUsage": false
+                  },
                   "properties": {
                     "model": {
                       "type": "boolean",
@@ -622,6 +702,54 @@
                       "description": "Show DingTalk API call count in AI card status line footer."
                     }
                   }
+                },
+                "gatewayCapabilities": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "description": "Account-level capability gates for docs and proactive-send Gateway RPCs. Merged with the channel-level gatewayCapabilities by sub-key (tools / docs / send), so a channel-level allowlist is never dropped implicitly.",
+                  "properties": {
+                    "tools": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "description": "Capability switches. Omitted switches default to enabled.",
+                      "properties": {
+                        "docs": {
+                          "type": "boolean",
+                          "description": "Enable dingtalk.docs.* and dingtalk-connector.docs.* Gateway RPCs. Defaults to true when omitted."
+                        },
+                        "proactiveSend": {
+                          "type": "boolean",
+                          "description": "Enable dingtalk-connector.sendToUser/sendToGroup/send proactive-send RPCs. Defaults to true when omitted."
+                        }
+                      }
+                    },
+                    "docs": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "description": "Docs RPC allowlist. When allowedSpaceIds is configured, requests without a spaceId (for example dingtalk.docs.append) are denied as well.",
+                      "properties": {
+                        "allowedSpaceIds": {
+                          "type": "array",
+                          "minItems": 1,
+                          "items": { "type": "string", "minLength": 1 },
+                          "description": "When set, docs RPCs only accept these spaceId values."
+                        }
+                      }
+                    },
+                    "send": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "description": "Proactive-send target allowlist.",
+                      "properties": {
+                        "allowedTargets": {
+                          "type": "array",
+                          "minItems": 1,
+                          "items": { "type": "string", "pattern": "^(user|group):\\S+$" },
+                          "description": "When set, proactive-send RPCs only accept these user:<id> or group:<conversationId> targets."
+                        }
+                      }
+                    }
+                  }
                 }
               }
             }
@@ -778,6 +906,14 @@
           "label": "Card Stream Interval (ms)",
           "help": "Throttle interval in milliseconds between AI card incremental updates."
         },
+        "cardTaskProgress": {
+          "label": "Card Task Progress",
+          "help": "Show a live task-progress block on AI cards for long-running tasks. Leave empty to keep the default (on unless cardStreamingMode is explicitly off)."
+        },
+        "cardTaskProgressRefresh": {
+          "label": "Card Task Progress Refresh",
+          "help": "heartbeat (default) refreshes the progress block every 30 seconds with a predictable update count; interval also pushes every tool-driven stage change, throttled by cardStreamInterval."
+        },
         "aicardDegradeMs": {
           "label": "AI Card Degrade Window (ms)",
           "help": "Cooldown window after AI card trigger errors. Replies fall back to non-card delivery during this period."
@@ -838,6 +974,26 @@
           "label": "Legacy Async Mode",
           "help": "Deprecated compatibility field from older host or runtime integrations. The current runtime ignores it."
         },
+        "gatewayCapabilities": {
+          "label": "Gateway RPC Capability Gates",
+          "help": "Turn docs and proactive-send Gateway RPCs off, or restrict them to specific doc spaces and send targets."
+        },
+        "gatewayCapabilities.tools.docs": {
+          "label": "Docs RPC Enabled",
+          "help": "Allow dingtalk.docs.* and dingtalk-connector.docs.* Gateway RPCs. Defaults to enabled."
+        },
+        "gatewayCapabilities.tools.proactiveSend": {
+          "label": "Proactive Send RPC Enabled",
+          "help": "Allow dingtalk-connector.sendToUser/sendToGroup/send Gateway RPCs. Defaults to enabled."
+        },
+        "gatewayCapabilities.docs.allowedSpaceIds": {
+          "label": "Allowed Doc Space IDs",
+          "help": "When set, docs RPCs only accept these spaceId values; requests without a spaceId, such as dingtalk.docs.append, are denied."
+        },
+        "gatewayCapabilities.send.allowedTargets": {
+          "label": "Allowed Send Targets",
+          "help": "When set, proactive-send RPCs only accept these user:<id> or group:<conversationId> targets."
+        },
         "accounts": {
           "label": "Named Accounts",
           "help": "Create named DingTalk accounts when one plugin instance must serve multiple apps or tenants."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soimy/dingtalk",
-  "version": "3.6.11",
+  "version": "3.7.0",
   "description": "DingTalk (钉钉) channel plugin for OpenClaw",
   "keywords": [
     "bot",
@@ -29,10 +29,6 @@
     "LICENSE"
   ],
   "type": "module",
-  "engines": {
-    "node": ">=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0"
-  },
-  "packageManager": "pnpm@10.33.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -49,14 +45,14 @@
     "build": "pnpm run build:runtime && pnpm run build:types",
     "build:runtime": "node scripts/build-runtime.mjs",
     "build:types": "tsc -p tsconfig.build.json",
-    "format": "oxfmt --write package.json tsconfig.json index.ts src/*.ts",
-    "format:check": "oxfmt --check package.json tsconfig.json index.ts src/*.ts",
-    "lint": "oxlint --type-aware index.ts src",
-    "lint:fix": "oxlint --type-aware --fix index.ts src && pnpm format",
-    "docs:dev": "vitepress dev docs --host 127.0.0.1 --port 8000",
-    "docs:serv": "vitepress dev docs --host 127.0.0.1 --port 8000",
     "docs:build": "vitepress build docs",
+    "docs:dev": "vitepress dev docs --host 127.0.0.1 --port 8000",
     "docs:preview": "vitepress preview docs --host 127.0.0.1 --port 4173",
+    "docs:serv": "vitepress dev docs --host 127.0.0.1 --port 8000",
+    "format": "oxfmt --write package.json tsconfig.json openclaw.plugin.json vitest.config.ts index.ts \"src/**/*.ts\" \"scripts/**/*.mjs\"",
+    "format:check": "oxfmt --check package.json tsconfig.json openclaw.plugin.json vitest.config.ts index.ts \"src/**/*.ts\" \"scripts/**/*.mjs\"",
+    "lint": "oxlint --type-aware index.ts src",
+    "lint:fix": "oxlint --type-aware --fix index.ts src && pnpm format",
     "monitor:stream": "node scripts/dingtalk-stream-monitor.mjs",
     "pack:check": "node scripts/verify-runtime-package.mjs",
     "prepack": "pnpm run build",
@@ -76,7 +72,7 @@
     "@types/node": "^25.2.0",
     "@vitest/coverage-v8": "^3.2.4",
     "esbuild": "^0.27.3",
-    "openclaw": "2026.7.1-2",
+    "openclaw": "2026.8.1",
     "oxfmt": "0.34.0",
     "oxlint": "1.49.0",
     "oxlint-tsgolint": "0.18.1",
@@ -85,19 +81,23 @@
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.1-2"
+    "openclaw": ">=2026.8.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
       "optional": true
     }
   },
+  "engines": {
+    "node": ">=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0"
+  },
+  "packageManager": "pnpm@10.33.0",
   "openclaw": {
     "compat": {
-      "pluginApi": ">=2026.7.1-2"
+      "pluginApi": ">=2026.8.1"
     },
     "build": {
-      "openclawVersion": "2026.7.1-2"
+      "openclawVersion": "2026.8.1"
     },
     "extensions": [
       "./index.ts"
@@ -123,7 +123,7 @@
       ]
     },
     "install": {
-      "minHostVersion": ">=2026.7.1-2",
+      "minHostVersion": ">=2026.8.1",
       "npmSpec": "@soimy/dingtalk",
       "localPath": ".",
       "defaultChoice": "npm"

package/src/{ack-reaction-classifier.ts → ack-reaction/ack-reaction-classifier.ts}

@@ -10,10 +10,70 @@ type EmojiMap = Record<SentenceType, readonly string[]>;
 const CATCHPHRASE = "叽 ";
 
 const KEYWORDS = {
-  praise: ["真棒", "太好了", "厉害", "优秀", "聪明", "好样的", "赞", "牛", "完美", "出色", "真行", "干得漂亮", "天才", "棒极了"],
-  blame: ["怎么又", "搞砸", "太差了", "烦死了", "讨厌", "笨", "蠢", "马虎", "不负责任", "乱来", "糟糕", "废物", "气死我了", "错了"],
-  command: ["必须", "立刻", "马上", "赶紧", "不准", "不要", "别动", "别说", "别做", "快去", "去做", "给我", "听着", "站住", "闭嘴"],
-  request: ["能不能", "可以吗", "好吗", "请", "麻烦", "帮个忙", "帮忙", "劳驾", "能否", "想请你", "能帮我", "借我", "方便吗"],
+  praise: [
+    "真棒",
+    "太好了",
+    "厉害",
+    "优秀",
+    "聪明",
+    "好样的",
+    "赞",
+    "牛",
+    "完美",
+    "出色",
+    "真行",
+    "干得漂亮",
+    "天才",
+    "棒极了",
+  ],
+  blame: [
+    "怎么又",
+    "搞砸",
+    "太差了",
+    "烦死了",
+    "讨厌",
+    "笨",
+    "蠢",
+    "马虎",
+    "不负责任",
+    "乱来",
+    "糟糕",
+    "废物",
+    "气死我了",
+    "错了",
+  ],
+  command: [
+    "必须",
+    "立刻",
+    "马上",
+    "赶紧",
+    "不准",
+    "不要",
+    "别动",
+    "别说",
+    "别做",
+    "快去",
+    "去做",
+    "给我",
+    "听着",
+    "站住",
+    "闭嘴",
+  ],
+  request: [
+    "能不能",
+    "可以吗",
+    "好吗",
+    "请",
+    "麻烦",
+    "帮个忙",
+    "帮忙",
+    "劳驾",
+    "能否",
+    "想请你",
+    "能帮我",
+    "借我",
+    "方便吗",
+  ],
 } as const;
 
 const POLITE_EXCLUSIONS = ["别客气", "别介意", "别见怪", "别担心", "别着急"] as const;
@@ -23,25 +83,34 @@ const EMOJIS: EmojiMap = {
   // Keep only the strings that survived repeated direct API retests against
   // the live endpoint using a real message target. Removed as unstable/bad:
   // `٩(๑>◡<๑)۶`.
-  "夸奖": ["(๑•̀ㅂ•́)و✧", "(ﾉ≧∀≦)ﾉ", "(★▽★)", "(⌒▽⌒)☆", "(*≧ω≦)", "(ง •_•)ง", "ヾ(≧▽≦*)o"],
-  "责怪": ["(╬ Ò﹏Ó)", "(╯°□°）╯", "(▼皿▼#)", "(｡•́︿•̀｡)", "(╥﹏╥)", "ヽ(｀Д´)ﾉ", "(＃＞＜)", "(；′⌒`)"],
+  夸奖: ["(๑•̀ㅂ•́)و✧", "(ﾉ≧∀≦)ﾉ", "(★▽★)", "(⌒▽⌒)☆", "(*≧ω≦)", "(ง •_•)ง", "ヾ(≧▽≦*)o"],
+  责怪: [
+    "(╬ Ò﹏Ó)",
+    "(╯°□°）╯",
+    "(▼皿▼#)",
+    "(｡•́︿•̀｡)",
+    "(╥﹏╥)",
+    "ヽ(｀Д´)ﾉ",
+    "(＃＞＜)",
+    "(；′⌒`)",
+  ],
   // Keep command kaomoji limited to strings that passed local
   // DingTalk emotion/reply verification. Removed as unstable/bad after
   // repeated direct API retests: `┌（┌ *｀д´）┐`, `(•̀へ •́ ╮ )`.
-  "命令": ["(¬_¬)", "(｀ε´)", "(＃｀Д´)", "(●｀∀´●)", "(｀д´)", "(￣ω￣;)"],
+  命令: ["(¬_¬)", "(｀ε´)", "(＃｀Д´)", "(●｀∀´●)", "(｀д´)", "(￣ω￣;)"],
   // Narrative kaomoji must also stay within the subset accepted by
   // DingTalk emotion/reply. Removed as unstable/bad after repeated direct
   // API retests: `(´• ω •`)`.
-  "叙事": ["(。・ω・。)", "(￣▽￣)", "(・・?)", "(。_。)", "(￣ω￣)", "(´▽`)", "(=_=)"],
+  叙事: ["(。・ω・。)", "(￣▽￣)", "(・・?)", "(。_。)", "(￣ω￣)", "(´▽`)", "(=_=)"],
   // Request kaomoji must exclude strings that stayed unstable across
   // repeated direct API retests. Removed as unstable/bad:
   // `(づ｡◕‿‿◕｡)づ`, `(⁄ ⁄•⁄ω⁄•⁄ ⁄)`.
-  "请求": ["(っ´∀｀)っ", "(๑•̀ω•́๑)✧", "(p≧w≦q)", "(♡˙︶˙♡)", "(´;ω;｀)", "(人•ᴗ•✿)"],
-  "未知": ["(•̀_•́)", "(；一_一)", "(???)"],
+  请求: ["(っ´∀｀)っ", "(๑•̀ω•́๑)✧", "(p≧w≦q)", "(♡˙︶˙♡)", "(´;ω;｀)", "(人•ᴗ•✿)"],
+  未知: ["(•̀_•́)", "(；一_一)", "(???)"],
 };
 
 function containsAny(text: string, words: readonly string[]): boolean {
-  return words.some(word => text.includes(word));
+  return words.some((word) => text.includes(word));
 }
 
 export function classifyAckReactionEmoji(sentence: unknown): AckReactionClassifyResult {
@@ -50,7 +119,7 @@ export function classifyAckReactionEmoji(sentence: unknown): AckReactionClassify
   }
 
   const s = sentence.trim();
-  const isPolitePhrase = POLITE_EXCLUSIONS.some(phrase => s.includes(phrase));
+  const isPolitePhrase = POLITE_EXCLUSIONS.some((phrase) => s.includes(phrase));
   const isQuestion = /吗|呢|？|\?/.test(s);
   const startsWithPlease = s.startsWith("请");
   const hasExclamation = /[!！]/.test(s);
@@ -63,7 +132,10 @@ export function classifyAckReactionEmoji(sentence: unknown): AckReactionClassify
     type = "命令";
   } else if (containsAny(s, KEYWORDS.praise)) {
     type = "夸奖";
-  } else if (containsAny(s, KEYWORDS.blame) || (hasExclamation && /烦|讨厌|笨|蠢|差|气死/.test(s))) {
+  } else if (
+    containsAny(s, KEYWORDS.blame) ||
+    (hasExclamation && /烦|讨厌|笨|蠢|差|气死/.test(s))
+  ) {
     type = "责怪";
   } else {
     type = "叙事";

package/src/{ack-reaction-service.ts → ack-reaction/ack-reaction-service.ts}

@@ -1,7 +1,11 @@
-import axios from "./http-client";
-import { getAccessToken } from "./auth";
-import type { DingTalkConfig } from "./types";
-import { formatDingTalkErrorPayloadLog, getErrorMessage, getProxyBypassOption } from "./utils";
+import { getAccessToken } from "../platform/auth";
+import type { DingTalkConfig } from "../platform/types";
+import axios from "../shared/http-client";
+import {
+  formatDingTalkErrorPayloadLog,
+  getErrorMessage,
+  getProxyBypassOption,
+} from "../shared/utils";
 
 // DingTalk currently exposes a dedicated native "thinking" reaction flow rather than
 // a generic arbitrary-emoji reaction API for this plugin path.
@@ -114,7 +118,9 @@ function isRetryableEmotionApiError(err: unknown): boolean {
   const response = asRecord(asRecord(err)?.response);
   const data = asRecord(response?.data);
   const status = Number(response?.status ?? 0);
-  const errorCode = String(data?.code || "").trim().toLowerCase();
+  const errorCode = String(data?.code || "")
+    .trim()
+    .toLowerCase();
   if (!response) {
     return true;
   }
@@ -136,7 +142,7 @@ export async function attachNativeAckReaction(
   for (let index = 0; index < THINKING_REACTION_ATTACH_DELAYS_MS.length; index += 1) {
     const delayMs = THINKING_REACTION_ATTACH_DELAYS_MS[index];
     if (delayMs > 0) {
-      await new Promise(resolve => setTimeout(resolve, delayMs));
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
     }
     const attempt = index + 1;
     const attemptLabel = `${attempt}/${THINKING_REACTION_ATTACH_DELAYS_MS.length}`;
@@ -191,7 +197,7 @@ export async function recallNativeAckReactionWithRetry(
   }
   for (const delayMs of THINKING_REACTION_RECALL_DELAYS_MS) {
     if (delayMs > 0) {
-      await new Promise(resolve => setTimeout(resolve, delayMs));
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
     }
     if (await recallNativeAckReaction(config, request, log)) {
       return;

package/src/ack-reaction/dynamic-ack-reaction-controller.ts

@@ -1,15 +1,17 @@
-import { attachNativeAckReaction, recallNativeAckReactionWithRetry } from "../ack-reaction-service";
-import type { DingTalkConfig } from "../types";
-import { getErrorMessage } from "../utils";
 import {
-  createDynamicAckReactionCorrelator,
+  createAgentEventCorrelator,
   describeEvent,
-  type DynamicAckReactionLogger,
   type RuntimeAgentEvent,
+  type RuntimeEventsLogger,
   type RuntimeEventsSurface,
-} from "./dynamic-ack-reaction-events";
+} from "../platform/runtime-events";
+import type { DingTalkConfig } from "../platform/types";
+import { getErrorMessage } from "../shared/utils";
+import { attachNativeAckReaction, recallNativeAckReactionWithRetry } from "./ack-reaction-service";
 import { resolveToolProgressReaction } from "./dynamic-ack-reaction-progress";
 
+const CORRELATION_CONSUMER = "ack-reaction";
+
 type DynamicAckReactionControllerParams = {
   enabled: boolean;
   initialReaction: string;
@@ -19,7 +21,7 @@ type DynamicAckReactionControllerParams = {
   msgId: string;
   conversationId: string;
   sessionKey: string;
-  log?: DynamicAckReactionLogger;
+  log?: RuntimeEventsLogger;
   runtimeEvents?: RuntimeEventsSurface;
   onReactionDisposed?: () => void;
 };
@@ -42,7 +44,8 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
   let lastDynamicReactionSwitchAt = 0;
   let disposed = false;
   const createdAt = Date.now();
-  const isCorrelatedEvent = createDynamicAckReactionCorrelator({
+  const isCorrelatedEvent = createAgentEventCorrelator({
+    consumer: CORRELATION_CONSUMER,
     sessionKey: params.sessionKey,
     enabled: params.enabled,
     createdAt,
@@ -55,7 +58,7 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
     if (disposed || !normalizedReaction || !params.enabled || !ackReactionAttached) {
       params.log?.debug?.(
         `[DingTalk] Dynamic ack reaction update skipped reaction=${normalizedReaction || "-"} ` +
-        `enabled=${params.enabled} ackReactionAttached=${ackReactionAttached} disposed=${disposed}`,
+          `enabled=${params.enabled} ackReactionAttached=${ackReactionAttached} disposed=${disposed}`,
       );
       return;
     }
@@ -70,12 +73,12 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
       return;
     }
     if (
-      lastDynamicReactionSwitchAt > 0
-      && Date.now() - lastDynamicReactionSwitchAt < DYNAMIC_REACTION_MIN_SWITCH_INTERVAL_MS
+      lastDynamicReactionSwitchAt > 0 &&
+      Date.now() - lastDynamicReactionSwitchAt < DYNAMIC_REACTION_MIN_SWITCH_INTERVAL_MS
     ) {
       params.log?.debug?.(
         `[DingTalk] Dynamic ack reaction update throttled previous=${currentAckReaction} next=${normalizedReaction} ` +
-        `minIntervalMs=${DYNAMIC_REACTION_MIN_SWITCH_INTERVAL_MS}`,
+          `minIntervalMs=${DYNAMIC_REACTION_MIN_SWITCH_INTERVAL_MS}`,
       );
       return;
     }
@@ -150,7 +153,9 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
     dynamicReactionUpdatePromise = dynamicReactionUpdatePromise
       .then(() => updateDynamicAckReaction(nextReaction))
       .catch((err: unknown) => {
-        params.log?.warn?.(`[DingTalk] Dynamic ack reaction update failed: ${getErrorMessage(err)}`);
+        params.log?.warn?.(
+          `[DingTalk] Dynamic ack reaction update failed: ${getErrorMessage(err)}`,
+        );
       });
     return dynamicReactionUpdatePromise;
   };
@@ -160,7 +165,9 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
     if (!params.enabled || disposed) {
       return;
     }
-    params.log?.debug?.(`[DingTalk] Dynamic reaction observed agent event ${describeEvent(agentEvent)}`);
+    params.log?.debug?.(
+      `[DingTalk] Dynamic reaction observed agent event ${describeEvent(agentEvent)}`,
+    );
     if (agentEvent?.stream === "lifecycle" && agentEvent.data?.phase === "start") {
       void isCorrelatedEvent(agentEvent);
       return;
@@ -174,7 +181,8 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
       );
       return;
     }
-    const toolCallId = typeof agentEvent.data?.toolCallId === "string" ? agentEvent.data.toolCallId : "-";
+    const toolCallId =
+      typeof agentEvent.data?.toolCallId === "string" ? agentEvent.data.toolCallId : "-";
     params.log?.debug?.(
       `[DingTalk] Tool event received for dynamic ack reaction: name=${agentEvent.data?.name || "-"} toolCallId=${toolCallId}`,
     );
@@ -183,26 +191,31 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
     );
   };
 
-  const unsubscribeAgentEvents = params.enabled && params.runtimeEvents?.onAgentEvent
-    ? params.runtimeEvents.onAgentEvent((event: unknown) => {
-        void handleAgentEvent(event).catch((err: unknown) => {
-          params.log?.warn?.(`[DingTalk] Dynamic ack reaction event handling failed: ${getErrorMessage(err)}`);
-        });
-      })
-    : () => {};
+  const unsubscribeAgentEvents =
+    params.enabled && params.runtimeEvents?.onAgentEvent
+      ? params.runtimeEvents.onAgentEvent((event: unknown) => {
+          void handleAgentEvent(event).catch((err: unknown) => {
+            params.log?.warn?.(
+              `[DingTalk] Dynamic ack reaction event handling failed: ${getErrorMessage(err)}`,
+            );
+          });
+        })
+      : () => {};
 
   if (params.enabled && !params.runtimeEvents?.onAgentEvent) {
-    params.log?.debug?.("[DingTalk] onAgentEvent not available, dynamic reaction tracking disabled");
+    params.log?.debug?.(
+      "[DingTalk] onAgentEvent not available, dynamic reaction tracking disabled",
+    );
   }
 
   if (params.enabled) {
     progressHeartbeatTimer = setInterval(() => {
       if (
-        disposed
-        || !ackReactionAttached
-        || progressHeartbeatInFlight
-        || dynamicReactionStartedAt === 0
-        || lastDynamicReactionAt === 0
+        disposed ||
+        !ackReactionAttached ||
+        progressHeartbeatInFlight ||
+        dynamicReactionStartedAt === 0 ||
+        lastDynamicReactionAt === 0
       ) {
         return;
       }
@@ -211,7 +224,7 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
       }
       params.log?.debug?.(
         `[DingTalk] Dynamic ack reaction heartbeat triggered currentReaction=${currentAckReaction} ` +
-        `lastDynamicReactionAt=${lastDynamicReactionAt}`,
+          `lastDynamicReactionAt=${lastDynamicReactionAt}`,
       );
       progressHeartbeatInFlight = true;
       void queueDynamicAckReactionUpdate(TOOL_HEARTBEAT_REACTION).finally(() => {
@@ -248,7 +261,7 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
         const elapsedMs = ackReactionAttachedAt > 0 ? Date.now() - ackReactionAttachedAt : 0;
         const remainingVisibleMs = shouldRespectMinVisible ? minVisibleMs - elapsedMs : 0;
         if (remainingVisibleMs > 0) {
-          await new Promise(resolve => setTimeout(resolve, remainingVisibleMs));
+          await new Promise((resolve) => setTimeout(resolve, remainingVisibleMs));
         }
         await recallNativeAckReactionWithRetry(
           params.dingtalkConfig,
@@ -260,7 +273,9 @@ export function createDynamicAckReactionController(params: DynamicAckReactionCon
           params.log,
         );
       } catch (err: unknown) {
-        params.log?.warn?.(`[DingTalk] Dynamic ack reaction dispose recall failed: ${getErrorMessage(err)}`);
+        params.log?.warn?.(
+          `[DingTalk] Dynamic ack reaction dispose recall failed: ${getErrorMessage(err)}`,
+        );
       } finally {
         ackReactionAttached = false;
         params.onReactionDisposed?.();

package/src/ack-reaction/dynamic-ack-reaction-progress.ts

@@ -27,7 +27,10 @@ export function resolveToolProgressReaction(toolName: unknown, args: unknown): s
       if (!command) {
         return "🛠️";
       }
-      if (/\bbrew\s+install\s+/i.test(command) || /\b(?:pnpm|npm|yarn)\s+(?:add|install)\s+/i.test(command)) {
+      if (
+        /\bbrew\s+install\s+/i.test(command) ||
+        /\b(?:pnpm|npm|yarn)\s+(?:add|install)\s+/i.test(command)
+      ) {
         return "📦";
       }
       if (/\bwhich\s+/i.test(command)) {