@tencent-weixin/openclaw-weixin 2.4.1 → 2.4.3

package/dist/src/media/voice-outbound.js

@@ -0,0 +1,177 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { logger } from "../util/logger.js";
+const OGG_CAPTURE = Buffer.from("OggS");
+const OPUS_HEAD_MAGIC = Buffer.from("OpusHead");
+const GP_UNKNOWN = 0xffffffffffffffffn;
+/** Weixin `VoiceItem.encode_type`: 6=silk (README: inbound SILK). */
+export const VOICE_ENCODE_SILK = 6;
+/** Ogg container (used for Opus-in-Ogg outbound). */
+export const VOICE_ENCODE_OGG_SPEEX = 8;
+/**
+ * Extensions always treated as outbound voice (upload + VOICE item).
+ * `.ogg` is handled separately: only when the file is Ogg Opus (see {@link isWeixinVoiceOutboundPath}).
+ */
+const VOICE_EXTENSIONS = new Set([".opus", ".silk", ".slk"]);
+function readUint32LE(buf, o) {
+    return buf.readUInt32LE(o);
+}
+/**
+ * Parse one Ogg page starting at `start`. Returns next byte offset after this page, or null if invalid.
+ */
+function skipOggPage(buf, start) {
+    if (start + 27 > buf.length)
+        return null;
+    if (!buf.subarray(start, start + 4).equals(OGG_CAPTURE))
+        return null;
+    const nsegs = buf[start + 26];
+    if (start + 27 + nsegs > buf.length)
+        return null;
+    let bodySize = 0;
+    for (let i = 0; i < nsegs; i++) {
+        bodySize += buf[start + 27 + i];
+    }
+    const end = start + 27 + nsegs + bodySize;
+    if (end > buf.length)
+        return null;
+    return end;
+}
+/**
+ * First Ogg page whose first packet payload starts with OpusHead defines the Opus logical stream serial.
+ */
+function findOpusStreamSerial(buf) {
+    let off = 0;
+    while (off < buf.length) {
+        const idx = buf.indexOf(OGG_CAPTURE, off);
+        if (idx < 0)
+            return null;
+        const end = skipOggPage(buf, idx);
+        if (end === null) {
+            off = idx + 1;
+            continue;
+        }
+        const nsegs = buf[idx + 26];
+        const bodyStart = idx + 27 + nsegs;
+        const firstSegLen = nsegs > 0 ? buf[idx + 27] : 0;
+        if (firstSegLen >= OPUS_HEAD_MAGIC.length &&
+            bodyStart + firstSegLen <= buf.length) {
+            const payload = buf.subarray(bodyStart, bodyStart + firstSegLen);
+            if (payload.subarray(0, OPUS_HEAD_MAGIC.length).equals(OPUS_HEAD_MAGIC)) {
+                return readUint32LE(buf, idx + 14);
+            }
+        }
+        off = end;
+    }
+    return null;
+}
+function maxGranuleForSerial(buf, targetSerial) {
+    let off = 0;
+    let maxGp = 0n;
+    while (off < buf.length) {
+        const idx = buf.indexOf(OGG_CAPTURE, off);
+        if (idx < 0)
+            break;
+        const end = skipOggPage(buf, idx);
+        if (end === null) {
+            off = idx + 1;
+            continue;
+        }
+        const serial = readUint32LE(buf, idx + 14);
+        if (serial === targetSerial) {
+            const gp = buf.readBigUInt64LE(idx + 6);
+            if (gp !== GP_UNKNOWN && gp > maxGp)
+                maxGp = gp;
+        }
+        off = end;
+    }
+    return maxGp;
+}
+/**
+ * Opus granule position counts 48 kHz PCM samples (RFC 7845). Duration in ms = gp * 1000 / 48000.
+ */
+export function playtimeMsFromOpusGranule(maxGp) {
+    if (maxGp <= 0n)
+        return 0;
+    const ms = (maxGp * 1000n) / 48000n;
+    return Number(ms);
+}
+export function parseOggOpusPlaytimeMs(buf) {
+    const serial = findOpusStreamSerial(buf);
+    if (serial === null)
+        return null;
+    const maxGp = maxGranuleForSerial(buf, serial);
+    if (maxGp <= 0n)
+        return null;
+    const ms = playtimeMsFromOpusGranule(maxGp);
+    return ms > 0 ? ms : null;
+}
+export function bufferLooksLikeOggOpus(buf) {
+    return findOpusStreamSerial(buf) !== null;
+}
+async function silkPlaytimeMsWithOptionalWasm(buf) {
+    try {
+        const { decode } = await import("silk-wasm");
+        const result = await decode(buf, 24_000);
+        const d = result.duration;
+        if (typeof d !== "number" || !Number.isFinite(d) || d <= 0)
+            return null;
+        return Math.round(d);
+    }
+    catch (err) {
+        logger.debug(`voice-outbound: silk-wasm decode unavailable or failed err=${String(err)}`);
+        return null;
+    }
+}
+export async function isWeixinVoiceOutboundPath(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (VOICE_EXTENSIONS.has(ext))
+        return true;
+    if (ext !== ".ogg")
+        return false;
+    const head = Buffer.allocUnsafe(65536);
+    const fh = await fs.open(filePath, "r");
+    try {
+        const { bytesRead } = await fh.read(head, 0, head.length, 0);
+        if (bytesRead <= 0)
+            return false;
+        return bufferLooksLikeOggOpus(head.subarray(0, bytesRead));
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * Compute voice playtime (ms) and encoding hints for Weixin VOICE item.
+ * Returns null if duration cannot be determined (caller should send as file).
+ */
+export async function resolveWeixinOutboundVoiceMeta(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const buf = await fs.readFile(filePath);
+    if (ext === ".opus" || ext === ".ogg") {
+        const ms = parseOggOpusPlaytimeMs(buf);
+        if (ms == null || ms <= 0) {
+            logger.warn(`voice-outbound: cannot resolve playtime for ${ext} file — parseOggOpusPlaytimeMs returned ${ms} (not a valid Ogg Opus stream?) filePath=${filePath} size=${buf.length}`);
+            return null;
+        }
+        return {
+            playtimeMs: ms,
+            encode_type: VOICE_ENCODE_OGG_SPEEX,
+            sample_rate: 48_000,
+        };
+    }
+    if (ext === ".silk" || ext === ".slk") {
+        const ms = await silkPlaytimeMsWithOptionalWasm(buf);
+        if (ms == null || ms <= 0) {
+            logger.warn(`voice-outbound: cannot resolve playtime for ${ext} file — silk-wasm decode returned ${ms} (wasm missing, or invalid SILK bitstream?) filePath=${filePath} size=${buf.length}`);
+            return null;
+        }
+        return {
+            playtimeMs: ms,
+            encode_type: VOICE_ENCODE_SILK,
+            sample_rate: 24_000,
+        };
+    }
+    logger.warn(`voice-outbound: unsupported voice extension '${ext}' for filePath=${filePath}`);
+    return null;
+}
+//# sourceMappingURL=voice-outbound.js.map

package/dist/src/media/voice-outbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-outbound.js","sourceRoot":"","sources":["../../../src/media/voice-outbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,mBAAsB,CAAC;AAE1C,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D,SAAS,YAAY,CAAC,GAAW,EAAE,CAAS;IAC1C,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW,EAAE,KAAa;IAC7C,IAAI,KAAK,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC9B,IAAI,KAAK,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,QAAQ,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,GAAG,EAAE,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,IACE,WAAW,IAAI,eAAe,CAAC,MAAM;YACrC,SAAS,GAAG,WAAW,IAAI,GAAG,CAAC,MAAM,EACrC,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;gBACxE,OAAO,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,GAAG,GAAG,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW,EAAE,YAAoB;IAC5D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,GAAG,GAAG,CAAC;YAAE,MAAM;QACnB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,GAAG,KAAK;gBAAE,KAAK,GAAG,EAAE,CAAC;QAClD,CAAC;QACD,GAAG,GAAG,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC;IACpC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,EAAE,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,GAAW;IACvD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,8DAA8D,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAAgB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAEjC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7D,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,QAAgB;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CACT,+CAA+C,GAAG,2CAA2C,EAAE,4CAA4C,QAAQ,SAAS,GAAG,CAAC,MAAM,EAAE,CACzK,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,sBAAsB;YACnC,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,8BAA8B,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CACT,+CAA+C,GAAG,qCAAqC,EAAE,wDAAwD,QAAQ,SAAS,GAAG,CAAC,MAAM,EAAE,CAC/K,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CACT,gDAAgD,GAAG,kBAAkB,QAAQ,EAAE,CAChF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/messaging/abort-fence.js

@@ -0,0 +1,70 @@
+/**
+ * Abort fence (generation barrier) for Weixin message dispatch.
+ *
+ * When the user sends an "abort" intent (e.g. "stop", "中止", "/abort") we
+ * cannot truly cancel the in-flight LLM/tool pipeline because the underlying
+ * SDK does not currently propagate an AbortSignal end-to-end. Instead, we
+ * adopt the same trick used by the Telegram channel
+ * (extensions/telegram/src/bot-message-dispatch.ts in the openclaw main repo):
+ *
+ * - Each dispatch picks up a fence `generation` at entry.
+ * - An abort message bumps the generation (`supersede=true`) and starts its
+ *   own dispatch with the new generation.
+ * - All outbound side-effects (sendMessage, typing start/stop, debug timing,
+ *   etc.) check `isDispatchSuperseded(...)` first; if the generation no longer
+ *   matches, they become no-ops.
+ *
+ * Effect: the old long-running task keeps running in the background but its
+ * output is silently dropped, so the user perceives it as cancelled and the
+ * new turn begins immediately.
+ *
+ * The fence is keyed per chat (typically `accountId:userId` for Weixin DMs),
+ * so different users do not share state.
+ */
+const fenceByKey = new Map();
+/**
+ * Begin a new dispatch and return its generation. When `supersede` is true
+ * (i.e. this dispatch is itself an abort request), bump the generation first
+ * so all already-running dispatches on this key become superseded.
+ */
+export function beginAbortFence(params) {
+    const existing = fenceByKey.get(params.key);
+    const state = existing ?? { generation: 0, activeDispatches: 0 };
+    if (params.supersede) {
+        state.generation += 1;
+    }
+    state.activeDispatches += 1;
+    fenceByKey.set(params.key, state);
+    return state.generation;
+}
+/**
+ * Returns true when the dispatch with `generation` has been superseded by a
+ * later abort on `key`. Cheap to call; check before any user-visible side
+ * effect.
+ */
+export function isDispatchSuperseded(params) {
+    return (fenceByKey.get(params.key)?.generation ?? 0) !== params.generation;
+}
+/**
+ * Mark a dispatch finished. When the lane goes idle we drop the entry to
+ * avoid unbounded growth across many distinct users.
+ */
+export function endAbortFence(key) {
+    const state = fenceByKey.get(key);
+    if (!state) {
+        return;
+    }
+    state.activeDispatches -= 1;
+    if (state.activeDispatches <= 0) {
+        fenceByKey.delete(key);
+    }
+}
+/** Number of tracked fence keys. Exposed for diagnostics and tests. */
+export function getAbortFenceSizeForTests() {
+    return fenceByKey.size;
+}
+/** Clear all fence state. Tests only. */
+export function resetAbortFenceForTests() {
+    fenceByKey.clear();
+}
+//# sourceMappingURL=abort-fence.js.map

package/dist/src/messaging/abort-fence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-fence.js","sourceRoot":"","sources":["../../../src/messaging/abort-fence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAA2C;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAoB,QAAQ,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IAClF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC5B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,UAAU,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA2C;IAC9E,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IACD,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC;QAChC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,yBAAyB;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,uBAAuB;IACrC,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

package/dist/src/messaging/buttons.js

@@ -0,0 +1,117 @@
+/**
+ * Shared button normalisation helpers used by both the channel action handler
+ * (channel.ts) and the inbound message dispatch path (process-message.ts).
+ */
+import { logger } from "../util/logger.js";
+import { findFenceSpanAt, parseFenceSpans } from "../util/markdown-fences.js";
+/**
+ * Normalize a single button-like object to {text, callback_data, style?}.
+ * Handles field name variants: label→text, value/callbackData→callback_data.
+ */
+export function normalizeButtonObject(b) {
+    const text = String(b.text ?? b.label ?? "");
+    const callbackData = String(b.callback_data ?? b.callbackData ?? b.value ?? b.action ?? b.data ?? "");
+    if (!text && !callbackData)
+        return null;
+    const style = typeof b.style === "string" && b.style ? b.style : undefined;
+    return style
+        ? { text, callback_data: callbackData, style }
+        : { text, callback_data: callbackData };
+}
+/**
+ * Normalize any button-like value to the canonical [[{text, callback_data}]] format.
+ * Handles all known AI malformations:
+ *   - [[{text, callback_data}]]  → already correct
+ *   - [{text, callback_data}]    → flat array, wrap into single row
+ *   - {text, callback_data}      → single button object
+ *   - {buttons: [...]}           → unwrap .buttons
+ *   - [{type:"button", label, value}] → normalize fields
+ */
+export function normalizeButtonsParam(raw) {
+    if (raw == null)
+        return undefined;
+    if (Array.isArray(raw)) {
+        if (raw.length === 0)
+            return undefined;
+        if (Array.isArray(raw[0])) {
+            return raw;
+        }
+        const flatButtons = raw.filter((b) => b != null && typeof b === "object" && !Array.isArray(b));
+        if (flatButtons.length === 0)
+            return undefined;
+        const row = flatButtons.map(normalizeButtonObject).filter(Boolean);
+        return row.length > 0 ? [row] : undefined;
+    }
+    if (typeof raw === "object") {
+        const obj = raw;
+        if (Array.isArray(obj.buttons)) {
+            return normalizeButtonsParam(obj.buttons);
+        }
+        const btn = normalizeButtonObject(obj);
+        return btn ? [[btn]] : undefined;
+    }
+    return undefined;
+}
+/**
+ * Parse and strip the inline WEIXIN_BUTTONS marker from outbound text.
+ *
+ * Agents writing plain-text responses (deliver / cron / streaming) can embed
+ * buttons by appending a line of the form:
+ *
+ *   WEIXIN_BUTTONS:[{"label":"Yes","value":"yes"},{"label":"No","value":"no"}]
+ *
+ * Returns:
+ *   - `cleanText`: the original text with the marker line removed and any
+ *     resulting extra blank lines collapsed.
+ *   - `buttons`:   the normalised button array (canonical [[{text,callback_data}]]
+ *     form) ready to pass to sendMessageWeixin / sendFinalMessageWithStreamId,
+ *     or undefined when no valid marker is found.
+ */
+const INLINE_BUTTONS_RE = /^WEIXIN_BUTTONS:(\[[\s\S]*?\])\s*$/gm;
+export function parseInlineButtons(text) {
+    // Mirror openclaw core's MEDIA: handling: a marker that lives inside a
+    // fenced code block is treated as literal documentation, not a directive.
+    const fenceSpans = parseFenceSpans(text);
+    const re = new RegExp(INLINE_BUTTONS_RE.source, INLINE_BUTTONS_RE.flags);
+    let match;
+    while ((match = re.exec(text)) !== null) {
+        if (findFenceSpanAt(fenceSpans, match.index))
+            continue;
+        try {
+            const parsed = JSON.parse(match[1]);
+            const buttons = normalizeButtonsParam(parsed);
+            const cleanText = text
+                .replace(match[0], "")
+                .replace(/\n{3,}/g, "\n\n")
+                .trim();
+            logger.debug(`parseInlineButtons: extracted ${buttons?.length ?? 0} button rows from inline marker`);
+            return { cleanText, buttons };
+        }
+        catch {
+            logger.warn(`parseInlineButtons: JSON parse failed, keeping marker as-is`);
+            return { cleanText: text, buttons: undefined };
+        }
+    }
+    return { cleanText: text, buttons: undefined };
+}
+/**
+ * Unified outbound helper: strip any inline WEIXIN_BUTTONS marker from `text`
+ * and merge the resulting buttons with any explicitly-provided buttons.
+ *
+ * Explicit buttons always win over marker-parsed buttons — an agent that calls
+ * the `message` tool with a structured `buttons` param is making a more
+ * deliberate choice than one that embeds a marker in free-text.
+ *
+ * Every outbound entry point (sendText / sendMedia / sendPayload / handleAction
+ * / streaming deliver) should route text through this helper so the marker is
+ * never leaked to the wire regardless of which code path delivered it.
+ */
+export function resolveOutboundButtons(text, explicitButtons) {
+    const explicitNormalised = explicitButtons != null ? normalizeButtonsParam(explicitButtons) : undefined;
+    const { cleanText, buttons: inlineButtons } = parseInlineButtons(text);
+    return {
+        text: cleanText,
+        buttons: explicitNormalised ?? inlineButtons,
+    };
+}
+//# sourceMappingURL=buttons.js.map

package/dist/src/messaging/buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttons.js","sourceRoot":"","sources":["../../../src/messaging/buttons.ts"],"names":[],"mappings":"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"}

package/dist/src/messaging/lane-key.js

@@ -0,0 +1,66 @@
+import { isAbortRequestText } from "openclaw/plugin-sdk/reply-runtime";
+import { MessageItemType } from "../api/types.js";
+/**
+ * Lane key for Weixin message scheduling.
+ *
+ * Mirrors the Telegram channel's `getTelegramSequentialKey` (see
+ * extensions/telegram/src/sequential-key.ts in the openclaw main repo).
+ *
+ * Design:
+ * - Different users get different lane keys -> processed concurrently.
+ * - Same user, regular messages -> share `wx:<account>:<user>` lane,
+ *   processed strictly in arrival order so AI replies, typing state and
+ *   inbound session writes do not interleave.
+ * - Abort requests (e.g. "stop", "中止") are routed to a separate
+ *   `wx:<account>:<user>:control` lane so they can run immediately even when
+ *   the main lane is occupied by a long-running tool turn. The actual
+ *   "stopping" is implemented via the abort-fence mechanism (see
+ *   `abort-fence.ts`).
+ */
+function extractFirstTextBody(itemList) {
+    if (!itemList?.length)
+        return "";
+    for (const item of itemList) {
+        if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
+            return String(item.text_item.text);
+        }
+    }
+    return "";
+}
+/** Extract text body suitable for abort detection from an inbound message. */
+export function extractTextBodyForLane(msg) {
+    return extractFirstTextBody(msg.item_list);
+}
+/** Returns true when the message text is an abort intent (stop / 中止 / ...). */
+export function isWeixinAbortMessage(msg) {
+    const text = extractTextBodyForLane(msg);
+    if (!text)
+        return false;
+    return isAbortRequestText(text);
+}
+/**
+ * Compute the lane key used by the per-key scheduler. Abort requests get the
+ * `:control` suffix to bypass the main lane.
+ *
+ * Note: the fallback `unknown` user happens for malformed payloads. Keep them
+ * on a shared lane so they cannot fan out and exhaust resources.
+ */
+export function getWeixinLaneKey(ctx) {
+    const userId = ctx.msg.from_user_id?.trim() || "unknown";
+    const baseKey = `wx:${ctx.accountId}:${userId}`;
+    if (isWeixinAbortMessage(ctx.msg)) {
+        return `${baseKey}:control`;
+    }
+    return baseKey;
+}
+/**
+ * Per-user fence key shared by all dispatches that should be aborted as a
+ * group when the user sends an abort. This is intentionally the *base* key
+ * (without `:control`) so that an abort dispatched on the control lane bumps
+ * the same generation that the long-running main-lane dispatch is checking.
+ */
+export function getWeixinFenceKey(ctx) {
+    const userId = ctx.msg.from_user_id?.trim() || "unknown";
+    return `wx:${ctx.accountId}:${userId}`;
+}
+//# sourceMappingURL=lane-key.js.map

package/dist/src/messaging/lane-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-key.js","sourceRoot":"","sources":["../../../src/messaging/lane-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;;;;;;;;;;;;;GAgBG;AAEH,SAAS,oBAAoB,CAAC,QAAwB;IACpD,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;YACvE,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,GAAkB;IACvD,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,GAAkB;IACrD,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAyB;IACxD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;IAChD,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,UAAU,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAyB;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACzD,OAAO,MAAM,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/dist/src/messaging/merged-record.js

@@ -0,0 +1,149 @@
+import { MessageItemType } from "../api/types.js";
+import { downloadMediaFromItem } from "../media/media-download.js";
+import { logger } from "../util/logger.js";
+const MAX_DEPTH = 5;
+function formatTimestamp(ms) {
+    if (!ms)
+        return "";
+    const d = new Date(ms);
+    const pad = (n) => String(n).padStart(2, "0");
+    const date = `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+    const time = `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+    const tz = new Intl.DateTimeFormat("en", { timeZoneName: "short" })
+        .formatToParts(d)
+        .find((p) => p.type === "timeZoneName")?.value ?? "";
+    return `${date} ${time}${tz ? ` ${tz}` : ""}`;
+}
+function formatSubItemContent(item) {
+    switch (item.type) {
+        case MessageItemType.TEXT:
+            return item.text_item?.text ?? "";
+        case MessageItemType.VOICE:
+            if (item.voice_item?.text)
+                return item.voice_item.text;
+            return undefined;
+        case MessageItemType.UNSUPPORTED:
+            return item.unsupported_item?.text || "[不支持的消息类型]";
+        default:
+            return undefined;
+    }
+}
+async function formatMediaContent(item, deps) {
+    const downloaded = await downloadMediaFromItem(item, {
+        cdnBaseUrl: deps.cdnBaseUrl,
+        saveMedia: deps.saveMedia,
+        log: deps.log,
+        errLog: deps.errLog,
+        label: "merged-record",
+    });
+    const filePath = downloaded.decryptedPicPath ??
+        downloaded.decryptedVideoPath ??
+        downloaded.decryptedFilePath ??
+        downloaded.decryptedVoicePath;
+    let text;
+    let mediaType;
+    switch (item.type) {
+        case MessageItemType.IMAGE:
+            text = filePath ? `![图片](${filePath})` : "[图片]";
+            mediaType = "image/*";
+            break;
+        case MessageItemType.VIDEO:
+            text = filePath ? `[视频](${filePath})` : "[视频]";
+            mediaType = "video/mp4";
+            break;
+        case MessageItemType.FILE: {
+            const name = item.file_item?.file_name;
+            if (name && filePath)
+                text = `[${name}](${filePath})`;
+            else if (name)
+                text = `[文件: ${name}]`;
+            else if (filePath)
+                text = `[文件](${filePath})`;
+            else
+                text = "[文件]";
+            mediaType = downloaded.fileMediaType ?? "application/octet-stream";
+            break;
+        }
+        case MessageItemType.VOICE:
+            text = filePath ? `[语音](${filePath})` : "[语音]";
+            mediaType = downloaded.voiceMediaType ?? "audio/wav";
+            break;
+        default:
+            text = "[不支持的消息]";
+            break;
+    }
+    return { text, mediaPath: filePath, mediaType: filePath ? mediaType : undefined };
+}
+/**
+ * Format a MergedRecordItem into a readable text body with nested structure.
+ *
+ * Each nesting level is represented by `│ ` prefixes. Media sub-items are
+ * downloaded via CDN; the body contains text placeholders (e.g. `[图片]`)
+ * while actual file paths are returned in `mediaPaths` / `mediaTypes`
+ * for populating `ctx.MediaPaths` / `ctx.MediaTypes`.
+ */
+export async function formatMergedRecordBody(record, deps, depth = 0) {
+    const title = record.title ?? "聊天记录";
+    const lines = [`[合并转发: ${title}]`];
+    const mediaPaths = [];
+    const mediaTypes = [];
+    if (depth >= MAX_DEPTH) {
+        lines.push("│ [嵌套层级过深，省略]");
+        return { body: lines.join("\n"), mediaPaths, mediaTypes };
+    }
+    for (const sub of record.sub_item_list ?? []) {
+        const nick = sub.from_nick_name ?? "未知";
+        const item = sub.item;
+        if (!item)
+            continue;
+        const ts = formatTimestamp(item.create_time_ms);
+        const header = ts ? `${nick} (${ts}):` : `${nick}:`;
+        if (item.type === MessageItemType.MERGED_RECORD && item.merged_record) {
+            lines.push(`│ ${header}`);
+            const nested = await formatMergedRecordBody(item.merged_record, deps, depth + 1);
+            for (const nestedLine of nested.body.split("\n")) {
+                lines.push(`│ ${nestedLine}`);
+            }
+            mediaPaths.push(...nested.mediaPaths);
+            mediaTypes.push(...nested.mediaTypes);
+        }
+        else {
+            const syncContent = formatSubItemContent(item);
+            if (syncContent !== undefined) {
+                lines.push(`│ ${header}`);
+                for (const contentLine of syncContent.split("\n")) {
+                    lines.push(`│ ${contentLine}`);
+                }
+            }
+            else if (item.type === MessageItemType.IMAGE ||
+                item.type === MessageItemType.VIDEO ||
+                item.type === MessageItemType.FILE ||
+                item.type === MessageItemType.VOICE) {
+                try {
+                    const media = await formatMediaContent(item, deps);
+                    lines.push(`│ ${header}`);
+                    lines.push(`│ ${media.text}`);
+                    if (media.mediaPath && media.mediaType) {
+                        mediaPaths.push(media.mediaPath);
+                        mediaTypes.push(media.mediaType);
+                    }
+                }
+                catch (err) {
+                    logger.error(`merged-record: media format failed: ${String(err)}`);
+                    lines.push(`│ ${header}`);
+                    lines.push("│ [媒体加载失败]");
+                }
+            }
+            else {
+                lines.push(`│ ${header}`);
+                lines.push("│ [不支持的消息]");
+            }
+        }
+        lines.push("│");
+    }
+    if (lines.length > 1 && lines[lines.length - 1] === "│") {
+        lines.pop();
+    }
+    return { body: lines.join("\n"), mediaPaths, mediaTypes };
+}
+//# sourceMappingURL=merged-record.js.map

package/dist/src/messaging/merged-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-record.js","sourceRoot":"","sources":["../../../src/messaging/merged-record.ts"],"names":[],"mappings":"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"}