@tencent-weixin/openclaw-weixin 2.1.7 → 2.1.9

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 This project follows the [Keep a Changelog](https://keepachangelog.com/) format.
 
+## [2.1.9] - 2026-04-20
+
+### Added
+
+- **Outbound hook support:** Add `message_sending` (pre-send interception/modification) and `message_sent` (post-send notification) hook integration for all outbound paths — `sendText`, `sendMedia`, and the inbound-reply `deliver` in `process-message`. Hook logic is extracted into a shared `src/messaging/outbound-hooks.ts` module.
+
+### Changed
+
+- **Cleanup:** Remove unused `mediaUrl` parameter from `sendWeixinOutbound` signature.
+
+## [2.1.8] - 2026-04-07
+
+### Changed
+
+- **Markdown filter:** `StreamingMarkdownFilter` now preserves more Markdown constructs in outbound text.
+
 ## [2.1.7] - 2026-04-07
 
 ### Fixed

package/CHANGELOG.zh_CN.md

@@ -4,6 +4,22 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/) 格式。
 
+## [2.1.9] - 2026-04-20
+
+### 新增
+
+- **外发 hook 支持：** 为所有外发路径（`sendText`、`sendMedia`、`process-message` 中的入站回复 `deliver`）接入 `message_sending`（发送前拦截/修改）和 `message_sent`（发送后通知）hook。hook 逻辑抽取至共享模块 `src/messaging/outbound-hooks.ts`。
+
+### 变更
+
+- **清理：** 移除 `sendWeixinOutbound` 签名中未使用的 `mediaUrl` 参数。
+
+## [2.1.8] - 2026-04-07
+
+### 变更
+
+- **Markdown 过滤器：** `StreamingMarkdownFilter` 放开了更多 Markdown 格式的保留。
+
 ## [2.1.7] - 2026-04-07
 
 ### 修复

package/LICENSE

@@ -1,21 +1,27 @@
-MIT License
+Tencent is pleased to support the open source community by making openclaw-weixin available. 
 
-Copyright (c) 2026 Tencent Inc.
+Copyright (C) 2026 Tencent.  All rights reserved. 
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+openclaw-weixin is licensed under the MIT.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Terms of the MIT:
+--------------------------------------------------------------------
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "openclaw-weixin",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "channels": [
     "openclaw-weixin"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-weixin/openclaw-weixin",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "OpenClaw Weixin channel",
   "license": "MIT",
   "author": "Tencent",

package/src/channel.ts

@@ -27,6 +27,7 @@ import type { WeixinQrStartResult, WeixinQrWaitResult } from "./auth/login-qr.js
 // Lazy-imported inside startAccount to avoid pulling in the monitor -> process-message ->
 // command-auth chain during plugin registration, which can re-enter plugin/provider registry
 // resolution before the account actually starts.
+import { applyWeixinMessageSendingHook, emitWeixinMessageSent } from "./messaging/outbound-hooks.js";
 import { sendWeixinMediaFile } from "./messaging/send-media.js";
 import { sendMessageWeixin, StreamingMarkdownFilter } from "./messaging/send.js";
 import { downloadRemoteImageToTemp } from "./cdn/upload.js";
@@ -109,7 +110,6 @@ async function sendWeixinOutbound(params: {
   text: string;
   accountId?: string | null;
   contextToken?: string;
-  mediaUrl?: string;
 }): Promise<{ channel: string; messageId: string }> {
   const account = resolveWeixinAccount(params.cfg, params.accountId);
   const aLog = logger.withAccount(account.accountId);
@@ -123,13 +123,31 @@ async function sendWeixinOutbound(params: {
   }
   const f = new StreamingMarkdownFilter();
   const rawText = params.text ?? "";
-  const filteredText = f.feed(rawText) + f.flush();
-  const result = await sendMessageWeixin({ to: params.to, text: filteredText, opts: {
-    baseUrl: account.baseUrl,
-    token: account.token,
-    contextToken: params.contextToken,
-  }});
-  return { channel: "openclaw-weixin", messageId: result.messageId };
+  let filteredText = f.feed(rawText) + f.flush();
+
+  const sendingResult = await applyWeixinMessageSendingHook({
+    to: params.to,
+    text: filteredText,
+    accountId: account.accountId,
+  });
+  if (sendingResult.cancelled) {
+    aLog.info(`sendWeixinOutbound: cancelled by message_sending hook to=${params.to}`);
+    return { channel: "openclaw-weixin", messageId: "" };
+  }
+  filteredText = sendingResult.text;
+
+  try {
+    const result = await sendMessageWeixin({ to: params.to, text: filteredText, opts: {
+      baseUrl: account.baseUrl,
+      token: account.token,
+      contextToken: params.contextToken,
+    }});
+    emitWeixinMessageSent({ to: params.to, content: filteredText, success: true, accountId: account.accountId });
+    return { channel: "openclaw-weixin", messageId: result.messageId };
+  } catch (err) {
+    emitWeixinMessageSent({ to: params.to, content: filteredText, success: false, error: String(err), accountId: account.accountId });
+    throw err;
+  }
 }
 
 export const weixinPlugin: ChannelPlugin<ResolvedWeixinAccount> = {
@@ -215,6 +233,19 @@ export const weixinPlugin: ChannelPlugin<ResolvedWeixinAccount> = {
       }
 
       const mediaUrl = ctx.mediaUrl;
+      let text = ctx.text ?? "";
+
+      const sendingResult = await applyWeixinMessageSendingHook({
+        to: ctx.to,
+        text,
+        accountId: account.accountId,
+        mediaUrl,
+      });
+      if (sendingResult.cancelled) {
+        aLog.info(`sendMedia: cancelled by message_sending hook to=${ctx.to}`);
+        return { channel: "openclaw-weixin", messageId: "" };
+      }
+      text = sendingResult.text;
 
       if (mediaUrl && (isLocalFilePath(mediaUrl) || isRemoteUrl(mediaUrl))) {
         let filePath: string;
@@ -227,24 +258,35 @@ export const weixinPlugin: ChannelPlugin<ResolvedWeixinAccount> = {
           aLog.debug(`sendMedia: remote image downloaded to ${filePath}`);
         }
         const contextToken = getContextToken(account.accountId, ctx.to);
-        const result = await sendWeixinMediaFile({
-          filePath,
-          to: ctx.to,
-          text: ctx.text ?? "",
-          opts: { baseUrl: account.baseUrl, token: account.token, contextToken },
-          cdnBaseUrl: account.cdnBaseUrl,
-        });
-        return { channel: "openclaw-weixin", messageId: result.messageId };
+        try {
+          const result = await sendWeixinMediaFile({
+            filePath,
+            to: ctx.to,
+            text,
+            opts: { baseUrl: account.baseUrl, token: account.token, contextToken },
+            cdnBaseUrl: account.cdnBaseUrl,
+          });
+          emitWeixinMessageSent({ to: ctx.to, content: text, success: true, accountId: account.accountId });
+          return { channel: "openclaw-weixin", messageId: result.messageId };
+        } catch (err) {
+          emitWeixinMessageSent({ to: ctx.to, content: text, success: false, error: String(err), accountId: account.accountId });
+          throw err;
+        }
       }
 
-      const result = await sendWeixinOutbound({
-        cfg: ctx.cfg,
-        to: ctx.to,
-        text: ctx.text ?? "",
-        accountId,
-        contextToken: getContextToken(account.accountId, ctx.to),
-      });
-      return result;
+      const contextToken = getContextToken(account.accountId, ctx.to);
+      try {
+        const result = await sendMessageWeixin({ to: ctx.to, text, opts: {
+          baseUrl: account.baseUrl,
+          token: account.token,
+          contextToken,
+        }});
+        emitWeixinMessageSent({ to: ctx.to, content: text, success: true, accountId: account.accountId });
+        return { channel: "openclaw-weixin", messageId: result.messageId };
+      } catch (err) {
+        emitWeixinMessageSent({ to: ctx.to, content: text, success: false, error: String(err), accountId: account.accountId });
+        throw err;
+      }
     },
   },
   status: {

package/src/messaging/markdown-filter.ts

@@ -6,9 +6,22 @@
  * holding back the minimum characters needed for pattern disambiguation
  * (e.g. a trailing `*` that might become `***`).
  *
+ * Constructs passed through (not filtered):
+ * - Code fences (```)
+ * - Inline code (`)
+ * - Tables (|...|)
+ * - Horizontal rules (---, ***, ___)
+ * - Bold (**)
+ * - Italic/bold-italic wrapping non-CJK content
+ *
+ * Constructs filtered (markers stripped, content kept):
+ * - Italic/bold-italic wrapping CJK content
+ * - Headings H5/H6 (#####, ######)
+ * - Images (![alt](url)) — removed entirely
+ *
  * States:
  * - **sol** (start-of-line): checks for line-start patterns (```, >, #####, indent)
- * - **body**: scans for inline patterns (`, ![, ~~, ***) and outputs safe chars
+ * - **body**: scans for inline patterns (![, ~~, ***) and outputs safe chars
  * - **fence**: inside a fenced code block, passes through until closing ```
  * - **inline**: accumulating content inside an inline marker pair
  */
@@ -16,7 +29,7 @@ export class StreamingMarkdownFilter {
   private buf = "";
   private fence = false;
   private sol = true;
-  private inl: { type: "code" | "image" | "strike" | "bold3" | "italic" | "ubold3" | "uitalic" | "table"; acc: string } | null = null;
+  private inl: { type: "image" | "bold3" | "italic" | "ubold3" | "uitalic"; acc: string } | null = null;
 
   feed(delta: string): string {
     this.buf += delta;
@@ -45,26 +58,32 @@ export class StreamingMarkdownFilter {
     }
 
     if (eof && this.inl) {
-      if (this.inl.type === "table") {
-        out += StreamingMarkdownFilter.extractTableRow(this.inl.acc);
-      } else {
-        const markers: Record<string, string> = { code: "`", image: "![", strike: "~~", bold3: "***", italic: "*", ubold3: "___", uitalic: "_" };
-        out += (markers[this.inl.type] ?? "") + this.inl.acc;
-      }
+      const markers: Record<string, string> = { image: "![", bold3: "***", italic: "*", ubold3: "___", uitalic: "_" };
+      out += (markers[this.inl.type] ?? "") + this.inl.acc;
       this.inl = null;
     }
     return out;
   }
 
-  /** Inside a code fence: pass content through, watch for closing ``` at SOL. */
+  /** Inside a code fence: pass content and markers through verbatim. */
   private pumpFence(eof: boolean): string {
     if (this.sol) {
       if (this.buf.length < 3 && !eof) return "";
       if (this.buf.startsWith("```")) {
-        this.fence = false;
         const nl = this.buf.indexOf("\n", 3);
-        this.buf = nl !== -1 ? this.buf.slice(nl + 1) : "";
-        this.sol = true;
+        if (nl !== -1) {
+          this.fence = false;
+          const line = this.buf.slice(0, nl + 1);
+          this.buf = this.buf.slice(nl + 1);
+          this.sol = true;
+          return line;
+        }
+        if (eof) {
+          this.fence = false;
+          const line = this.buf;
+          this.buf = "";
+          return line;
+        }
         return "";
       }
       this.sol = false;
@@ -93,10 +112,18 @@ export class StreamingMarkdownFilter {
     if (b[0] === "`") {
       if (b.length < 3 && !eof) return "";
       if (b.startsWith("```")) {
-        this.fence = true;
         const nl = b.indexOf("\n", 3);
-        this.buf = nl !== -1 ? b.slice(nl + 1) : "";
-        this.sol = true;
+        if (nl !== -1) {
+          this.fence = true;
+          const line = b.slice(0, nl + 1);
+          this.buf = b.slice(nl + 1);
+          this.sol = true;
+          return line;
+        }
+        if (eof) {
+          this.buf = "";
+          return b;
+        }
         return "";
       }
       this.sol = false;
@@ -104,8 +131,6 @@ export class StreamingMarkdownFilter {
     }
 
     if (b[0] === ">") {
-      if (b.length < 2 && !eof) return "";
-      this.buf = b.length >= 2 && b[1] === " " ? b.slice(2) : b.slice(1);
       this.sol = false;
       return "";
     }
@@ -123,13 +148,6 @@ export class StreamingMarkdownFilter {
       return "";
     }
 
-    if (b[0] === "|") {
-      this.buf = b.slice(1);
-      this.inl = { type: "table", acc: "" };
-      this.sol = false;
-      return "";
-    }
-
     if (b[0] === " " || b[0] === "\t") {
       if (b.search(/[^ \t]/) === -1 && !eof) return "";
       this.sol = false;
@@ -145,9 +163,13 @@ export class StreamingMarkdownFilter {
         let count = 0;
         for (let k = 0; k < j; k++) if (b[k] === ch) count++;
         if (count >= 3) {
-          this.buf = j < b.length ? b.slice(j + 1) : "";
-          this.sol = true;
-          return "";
+          if (j < b.length) {
+            this.buf = b.slice(j + 1);
+            this.sol = true;
+            return b.slice(0, j + 1);
+          }
+          this.buf = "";
+          return b;
         }
       }
       this.sol = false;
@@ -170,23 +192,15 @@ export class StreamingMarkdownFilter {
         this.sol = true;
         return out;
       }
-      if (c === "`") {
-        out += this.buf.slice(0, i);
-        this.buf = this.buf.slice(i + 1);
-        this.inl = { type: "code", acc: "" };
-        return out;
-      }
       if (c === "!" && i + 1 < this.buf.length && this.buf[i + 1] === "[") {
         out += this.buf.slice(0, i);
         this.buf = this.buf.slice(i + 2);
         this.inl = { type: "image", acc: "" };
         return out;
       }
-      if (c === "~" && i + 1 < this.buf.length && this.buf[i + 1] === "~") {
-        out += this.buf.slice(0, i);
-        this.buf = this.buf.slice(i + 2);
-        this.inl = { type: "strike", acc: "" };
-        return out;
+      if (c === "~") {
+        i++;
+        continue;
       }
       if (c === "*") {
         if (i + 2 < this.buf.length && this.buf[i + 1] === "*" && this.buf[i + 2] === "*") {
@@ -237,7 +251,6 @@ export class StreamingMarkdownFilter {
       else if (this.buf.endsWith("__")) hold = 2;
       else if (this.buf.endsWith("*")) hold = 1;
       else if (this.buf.endsWith("_")) hold = 1;
-      else if (this.buf.endsWith("~")) hold = 1;
       else if (this.buf.endsWith("!")) hold = 1;
     }
     out += this.buf.slice(0, this.buf.length - hold);
@@ -252,41 +265,14 @@ export class StreamingMarkdownFilter {
     this.buf = "";
 
     switch (this.inl.type) {
-      case "code": {
-        const idx = this.inl.acc.indexOf("`");
-        if (idx !== -1) {
-          const content = this.inl.acc.slice(0, idx);
-          this.buf = this.inl.acc.slice(idx + 1);
-          this.inl = null;
-          return content;
-        }
-        const nl = this.inl.acc.indexOf("\n");
-        if (nl !== -1) {
-          const r = "`" + this.inl.acc.slice(0, nl + 1);
-          this.buf = this.inl.acc.slice(nl + 1);
-          this.inl = null;
-          this.sol = true;
-          return r;
-        }
-        return "";
-      }
-      case "strike": {
-        const idx = this.inl.acc.indexOf("~~");
-        if (idx !== -1) {
-          const content = this.inl.acc.slice(0, idx);
-          this.buf = this.inl.acc.slice(idx + 2);
-          this.inl = null;
-          return content;
-        }
-        return "";
-      }
       case "bold3": {
         const idx = this.inl.acc.indexOf("***");
         if (idx !== -1) {
           const content = this.inl.acc.slice(0, idx);
           this.buf = this.inl.acc.slice(idx + 3);
           this.inl = null;
-          return content;
+          if (StreamingMarkdownFilter.containsCJK(content)) return content;
+          return `***${content}***`;
         }
         return "";
       }
@@ -296,7 +282,8 @@ export class StreamingMarkdownFilter {
           const content = this.inl.acc.slice(0, idx);
           this.buf = this.inl.acc.slice(idx + 3);
           this.inl = null;
-          return content;
+          if (StreamingMarkdownFilter.containsCJK(content)) return content;
+          return `___${content}___`;
         }
         return "";
       }
@@ -317,7 +304,8 @@ export class StreamingMarkdownFilter {
             const content = this.inl.acc.slice(0, j);
             this.buf = this.inl.acc.slice(j + 1);
             this.inl = null;
-            return content;
+            if (StreamingMarkdownFilter.containsCJK(content)) return content;
+            return `*${content}*`;
           }
         }
         return "";
@@ -339,7 +327,8 @@ export class StreamingMarkdownFilter {
             const content = this.inl.acc.slice(0, j);
             this.buf = this.inl.acc.slice(j + 1);
             this.inl = null;
-            return content;
+            if (StreamingMarkdownFilter.containsCJK(content)) return content;
+            return `_${content}_`;
           }
         }
         return "";
@@ -362,30 +351,11 @@ export class StreamingMarkdownFilter {
         }
         return "";
       }
-      case "table": {
-        const nl = this.inl.acc.indexOf("\n");
-        if (nl !== -1) {
-          const line = this.inl.acc.slice(0, nl);
-          this.buf = this.inl.acc.slice(nl + 1);
-          this.inl = null;
-          this.sol = true;
-          const row = StreamingMarkdownFilter.extractTableRow(line);
-          return row ? row + "\n" : "";
-        }
-        return "";
-      }
     }
     return "";
   }
 
-  /** Extract cell contents from a table row, or return "" for separator rows. */
-  private static extractTableRow(line: string): string {
-    if (/^[\s|:\-]+$/.test(line) && line.includes("-")) return "";
-    const parts = line.split("|").map(c => c.trim());
-    const cells = parts.slice(
-      parts[0] === "" ? 1 : 0,
-      parts[parts.length - 1] === "" ? parts.length - 1 : parts.length,
-    );
-    return cells.join("\t");
+  private static containsCJK(text: string): boolean {
+    return /[\u2E80-\u9FFF\uAC00-\uD7AF\uF900-\uFAFF]/.test(text);
   }
 }

package/src/messaging/outbound-hooks.ts

@@ -0,0 +1,84 @@
+import {
+  fireAndForgetHook,
+  buildCanonicalSentMessageHookContext,
+  toPluginMessageContext,
+  toPluginMessageSentEvent,
+} from "openclaw/plugin-sdk/hook-runtime";
+import { getGlobalHookRunner } from "openclaw/plugin-sdk/plugin-runtime";
+
+import { logger } from "../util/logger.js";
+
+const CHANNEL_ID = "openclaw-weixin";
+
+/**
+ * Run message_sending hook before sending.
+ * Returns the (possibly modified) text content plus a cancelled flag.
+ * Hook errors are caught and logged — sending proceeds regardless.
+ */
+export async function applyWeixinMessageSendingHook(params: {
+  to: string;
+  text: string;
+  accountId?: string;
+  mediaUrl?: string;
+}): Promise<{ cancelled: boolean; text: string }> {
+  const hookRunner = getGlobalHookRunner();
+  if (!hookRunner?.hasHooks("message_sending")) {
+    return { cancelled: false, text: params.text };
+  }
+  try {
+    const hookResult = await hookRunner.runMessageSending(
+      {
+        to: params.to,
+        content: params.text,
+        metadata: {
+          channel: CHANNEL_ID,
+          accountId: params.accountId,
+          ...(params.mediaUrl ? { mediaUrls: [params.mediaUrl] } : {}),
+        },
+      },
+      { channelId: CHANNEL_ID, accountId: params.accountId },
+    );
+    if (hookResult?.cancel) {
+      return { cancelled: true, text: params.text };
+    }
+    return {
+      cancelled: false,
+      text: hookResult?.content ?? params.text,
+    };
+  } catch (err) {
+    logger.warn(`message_sending hook error, proceeding with send: ${String(err)}`);
+    return { cancelled: false, text: params.text };
+  }
+}
+
+/**
+ * Fire message_sent hook (fire-and-forget) after a send attempt.
+ */
+export function emitWeixinMessageSent(params: {
+  to: string;
+  content: string;
+  success: boolean;
+  error?: string;
+  accountId?: string;
+}): void {
+  const hookRunner = getGlobalHookRunner();
+  if (!hookRunner?.hasHooks("message_sent")) return;
+  const canonical = buildCanonicalSentMessageHookContext({
+    to: params.to,
+    content: params.content,
+    success: params.success,
+    error: params.error,
+    channelId: CHANNEL_ID,
+    accountId: params.accountId,
+    conversationId: params.to,
+  });
+  fireAndForgetHook(
+    Promise.resolve(
+      hookRunner!.runMessageSent(
+        toPluginMessageSentEvent(canonical),
+        toPluginMessageContext(canonical),
+      ),
+    ),
+    "weixin: message_sent plugin hook failed",
+  );
+}

package/src/messaging/process-message.ts

@@ -20,6 +20,7 @@ import { redactBody, redactToken } from "../util/redact.js";
 
 import { isDebugMode } from "./debug-mode.js";
 import { sendWeixinErrorNotice } from "./error-notice.js";
+import { applyWeixinMessageSendingHook, emitWeixinMessageSent } from "./outbound-hooks.js";
 import {
   setContextToken,
   weixinMessageToMsgContext,
@@ -311,7 +312,7 @@ export async function processOneMessage(
       typingCallbacks,
       deliver: async (payload) => {
         const rawText = payload.text ?? "";
-        const text = (() => {
+        let text = (() => {
           const f = new StreamingMarkdownFilter();
           return f.feed(rawText) + f.flush();
         })();
@@ -330,11 +331,22 @@ export async function processOneMessage(
           });
         }
 
+        const sendingResult = await applyWeixinMessageSendingHook({
+          to: ctx.To,
+          text,
+          accountId: deps.accountId,
+          mediaUrl,
+        });
+        if (sendingResult.cancelled) {
+          logger.info(`outbound: cancelled by message_sending hook to=${ctx.To}`);
+          return;
+        }
+        text = sendingResult.text;
+
         try {
           if (mediaUrl) {
             let filePath: string;
             if (!mediaUrl.includes("://") || mediaUrl.startsWith("file://")) {
-              // Local path: absolute, relative, or file:// URL
               if (mediaUrl.startsWith("file://")) {
                 filePath = new URL(mediaUrl).pathname;
               } else if (!path.isAbsolute(mediaUrl)) {
@@ -357,6 +369,7 @@ export async function processOneMessage(
                 token: deps.token,
                 contextToken,
               }});
+              emitWeixinMessageSent({ to: ctx.To, content: text, success: true, accountId: deps.accountId });
               logger.info(`outbound: text sent to=${ctx.To}`);
               return;
             }
@@ -367,6 +380,7 @@ export async function processOneMessage(
               opts: { baseUrl: deps.baseUrl, token: deps.token, contextToken },
               cdnBaseUrl: deps.cdnBaseUrl,
             });
+            emitWeixinMessageSent({ to: ctx.To, content: text, success: true, accountId: deps.accountId });
             logger.info(`outbound: media sent OK to=${ctx.To}`);
           } else {
             logger.debug(`outbound: sending text message to=${ctx.To}`);
@@ -375,9 +389,11 @@ export async function processOneMessage(
               token: deps.token,
               contextToken,
             }});
+            emitWeixinMessageSent({ to: ctx.To, content: text, success: true, accountId: deps.accountId });
             logger.info(`outbound: text sent OK to=${ctx.To}`);
           }
         } catch (err) {
+          emitWeixinMessageSent({ to: ctx.To, content: text, success: false, error: String(err), accountId: deps.accountId });
           logger.error(
             `outbound: FAILED to=${ctx.To} mediaUrl=${mediaUrl ?? "none"} err=${String(err)} stack=${(err as Error).stack ?? ""}`,
           );