@tencent-weixin/openclaw-weixin 2.3.1 → 2.4.2

package/dist/src/messaging/debug-mode.js

@@ -0,0 +1,63 @@
+/**
+ * Per-bot debug mode toggle, persisted to disk so it survives gateway restarts.
+ *
+ * State file: `<stateDir>/openclaw-weixin/debug-mode.json`
+ * Format:     `{ "accounts": { "<accountId>": true, ... } }`
+ *
+ * When enabled, processOneMessage appends a timing summary after each
+ * AI reply is delivered to the user.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveStateDir } from "../storage/state-dir.js";
+import { logger } from "../util/logger.js";
+function resolveDebugModePath() {
+    return path.join(resolveStateDir(), "openclaw-weixin", "debug-mode.json");
+}
+function loadState() {
+    try {
+        const raw = fs.readFileSync(resolveDebugModePath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed.accounts === "object")
+            return parsed;
+    }
+    catch {
+        // missing or corrupt — start fresh
+    }
+    return { accounts: {} };
+}
+function saveState(state) {
+    const filePath = resolveDebugModePath();
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
+}
+/** Toggle debug mode for a bot account. Returns the new state. */
+export function toggleDebugMode(accountId) {
+    const state = loadState();
+    const next = !state.accounts[accountId];
+    state.accounts[accountId] = next;
+    try {
+        saveState(state);
+    }
+    catch (err) {
+        logger.error(`debug-mode: failed to persist state: ${String(err)}`);
+    }
+    return next;
+}
+/** Check whether debug mode is active for a bot account. */
+export function isDebugMode(accountId) {
+    return loadState().accounts[accountId] === true;
+}
+/**
+ * Reset internal state — only for tests.
+ * @internal
+ */
+export function _resetForTest() {
+    try {
+        fs.unlinkSync(resolveDebugModePath());
+    }
+    catch {
+        // ignore if not present
+    }
+}
+//# sourceMappingURL=debug-mode.js.map

package/dist/src/messaging/debug-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-mode.js","sourceRoot":"","sources":["../../../src/messaging/debug-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAM3C,SAAS,oBAAoB;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QACjD,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wCAAwC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,SAAS,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/messaging/error-notice.js

@@ -0,0 +1,24 @@
+import { logger } from "../util/logger.js";
+import { sendMessageWeixin } from "./send.js";
+/**
+ * Send a plain-text error notice back to the user.
+ * Fire-and-forget: errors are logged but never thrown, so callers stay unaffected.
+ * No-op when contextToken is absent (we have no conversation reference to reply into).
+ */
+export async function sendWeixinErrorNotice(params) {
+    if (!params.contextToken) {
+        logger.warn(`sendWeixinErrorNotice: no contextToken for to=${params.to}, sending without context`);
+    }
+    try {
+        await sendMessageWeixin({ to: params.to, text: params.message, opts: {
+                baseUrl: params.baseUrl,
+                token: params.token,
+                contextToken: params.contextToken,
+            } });
+        logger.debug(`sendWeixinErrorNotice: sent to=${params.to}`);
+    }
+    catch (err) {
+        params.errLog(`[weixin] sendWeixinErrorNotice failed to=${params.to}: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=error-notice.js.map

package/dist/src/messaging/error-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-notice.js","sourceRoot":"","sources":["../../../src/messaging/error-notice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAO3C;IACC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,iDAAiD,MAAM,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACrG,CAAC;IACD,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;gBACnE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,EAAC,CAAC,CAAC;QACJ,MAAM,CAAC,KAAK,CAAC,kCAAkC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,MAAM,CAAC,4CAA4C,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

package/dist/src/messaging/inbound.js

@@ -0,0 +1,201 @@
+import fs from "node:fs";
+import path from "node:path";
+import { logger } from "../util/logger.js";
+import { generateId } from "../util/random.js";
+import { MessageItemType } from "../api/types.js";
+import { resolveStateDir } from "../storage/state-dir.js";
+// ---------------------------------------------------------------------------
+// Context token store (in-process cache + disk persistence)
+// ---------------------------------------------------------------------------
+/**
+ * contextToken is issued per-message by the Weixin getupdates API and must
+ * be echoed verbatim in every outbound send. The in-memory map is the primary
+ * lookup; a disk-backed file per account ensures tokens survive gateway restarts.
+ */
+const contextTokenStore = new Map();
+function contextTokenKey(accountId, userId) {
+    return `${accountId}:${userId}`;
+}
+// ---------------------------------------------------------------------------
+// Disk persistence helpers
+// ---------------------------------------------------------------------------
+function resolveContextTokenFilePath(accountId) {
+    return path.join(resolveStateDir(), "openclaw-weixin", "accounts", `${accountId}.context-tokens.json`);
+}
+/** Persist all context tokens for a given account to disk. */
+function persistContextTokens(accountId) {
+    const prefix = `${accountId}:`;
+    const tokens = {};
+    for (const [k, v] of contextTokenStore) {
+        if (k.startsWith(prefix)) {
+            tokens[k.slice(prefix.length)] = v;
+        }
+    }
+    const filePath = resolveContextTokenFilePath(accountId);
+    try {
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(tokens, null, 0), "utf-8");
+    }
+    catch (err) {
+        logger.warn(`persistContextTokens: failed to write ${filePath}: ${String(err)}`);
+    }
+}
+/**
+ * Restore persisted context tokens for an account into the in-memory map.
+ * Called once during gateway startAccount to survive restarts.
+ */
+export function restoreContextTokens(accountId) {
+    const filePath = resolveContextTokenFilePath(accountId);
+    try {
+        if (!fs.existsSync(filePath))
+            return;
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const tokens = JSON.parse(raw);
+        let count = 0;
+        for (const [userId, token] of Object.entries(tokens)) {
+            if (typeof token === "string" && token) {
+                contextTokenStore.set(contextTokenKey(accountId, userId), token);
+                count++;
+            }
+        }
+        logger.info(`restoreContextTokens: restored ${count} tokens for account=${accountId}`);
+    }
+    catch (err) {
+        logger.warn(`restoreContextTokens: failed to read ${filePath}: ${String(err)}`);
+    }
+}
+/** Remove all context tokens for a given account (memory + disk). */
+export function clearContextTokensForAccount(accountId) {
+    const prefix = `${accountId}:`;
+    for (const k of [...contextTokenStore.keys()]) {
+        if (k.startsWith(prefix)) {
+            contextTokenStore.delete(k);
+        }
+    }
+    const filePath = resolveContextTokenFilePath(accountId);
+    try {
+        if (fs.existsSync(filePath))
+            fs.unlinkSync(filePath);
+    }
+    catch (err) {
+        logger.warn(`clearContextTokensForAccount: failed to remove ${filePath}: ${String(err)}`);
+    }
+    logger.info(`clearContextTokensForAccount: cleared tokens for account=${accountId}`);
+}
+/** Store a context token for a given account+user pair (memory + disk). */
+export function setContextToken(accountId, userId, token) {
+    const k = contextTokenKey(accountId, userId);
+    logger.debug(`setContextToken: key=${k}`);
+    contextTokenStore.set(k, token);
+    persistContextTokens(accountId);
+}
+/** Retrieve the cached context token for a given account+user pair. */
+export function getContextToken(accountId, userId) {
+    const k = contextTokenKey(accountId, userId);
+    const val = contextTokenStore.get(k);
+    logger.debug(`getContextToken: key=${k} found=${val !== undefined} storeSize=${contextTokenStore.size}`);
+    return val;
+}
+/**
+ * Find all accountIds that have an active contextToken for the given userId.
+ * Used to infer the sending bot account from the recipient address when
+ * accountId is not explicitly provided (e.g. cron delivery).
+ *
+ * Returns all matching accountIds (not just the first) so the caller can
+ * detect ambiguity when multiple accounts have sessions with the same user.
+ */
+export function findAccountIdsByContextToken(accountIds, userId) {
+    return accountIds.filter((id) => contextTokenStore.has(contextTokenKey(id, userId)));
+}
+// ---------------------------------------------------------------------------
+// Message ID generation
+// ---------------------------------------------------------------------------
+function generateMessageSid() {
+    return generateId("openclaw-weixin");
+}
+/** Returns true if the message item is a media type (image, video, file, or voice). */
+export function isMediaItem(item) {
+    return (item.type === MessageItemType.IMAGE ||
+        item.type === MessageItemType.VIDEO ||
+        item.type === MessageItemType.FILE ||
+        item.type === MessageItemType.VOICE);
+}
+function bodyFromItemList(itemList) {
+    if (!itemList?.length)
+        return "";
+    for (const item of itemList) {
+        if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
+            const text = String(item.text_item.text);
+            const ref = item.ref_msg;
+            if (!ref)
+                return text;
+            // Quoted media is passed as MediaPath; only include the current text as body.
+            if (ref.message_item && isMediaItem(ref.message_item))
+                return text;
+            // Build quoted context from both title and message_item content.
+            const parts = [];
+            if (ref.title)
+                parts.push(ref.title);
+            if (ref.message_item) {
+                const refBody = bodyFromItemList([ref.message_item]);
+                if (refBody)
+                    parts.push(refBody);
+            }
+            if (!parts.length)
+                return text;
+            return `[引用: ${parts.join(" | ")}]\n${text}`;
+        }
+        // 语音转文字：如果语音消息有 text 字段，直接使用文字内容
+        if (item.type === MessageItemType.VOICE && item.voice_item?.text) {
+            return item.voice_item.text;
+        }
+    }
+    return "";
+}
+/**
+ * Convert a WeixinMessage from getUpdates to the inbound MsgContext for the core pipeline.
+ * Media: only pass MediaPath (local file, after CDN download + decrypt).
+ * We never pass MediaUrl — the upstream CDN URL is encrypted/auth-only.
+ * Priority when multiple media types present: image > video > file > voice.
+ */
+export function weixinMessageToMsgContext(msg, accountId, opts) {
+    const from_user_id = msg.from_user_id ?? "";
+    const ctx = {
+        Body: bodyFromItemList(msg.item_list),
+        From: from_user_id,
+        To: from_user_id,
+        AccountId: accountId,
+        OriginatingChannel: "openclaw-weixin",
+        OriginatingTo: from_user_id,
+        MessageSid: generateMessageSid(),
+        Timestamp: msg.create_time_ms,
+        Provider: "openclaw-weixin",
+        ChatType: "direct",
+    };
+    if (msg.context_token) {
+        ctx.context_token = msg.context_token;
+    }
+    if (opts?.decryptedPicPath) {
+        ctx.MediaPath = opts.decryptedPicPath;
+        ctx.MediaType = "image/*";
+    }
+    else if (opts?.decryptedVideoPath) {
+        ctx.MediaPath = opts.decryptedVideoPath;
+        ctx.MediaType = "video/mp4";
+    }
+    else if (opts?.decryptedFilePath) {
+        ctx.MediaPath = opts.decryptedFilePath;
+        ctx.MediaType = opts.fileMediaType ?? "application/octet-stream";
+    }
+    else if (opts?.decryptedVoicePath) {
+        ctx.MediaPath = opts.decryptedVoicePath;
+        ctx.MediaType = opts.voiceMediaType ?? "audio/wav";
+    }
+    return ctx;
+}
+/** Extract the context_token from an inbound WeixinMsgContext. */
+export function getContextTokenFromMsgContext(ctx) {
+    return ctx.context_token;
+}
+//# sourceMappingURL=inbound.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.js","sourceRoot":"","sources":["../../../src/messaging/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEpD,SAAS,eAAe,CAAC,SAAiB,EAAE,MAAc;IACxD,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,2BAA2B,CAAC,SAAiB;IACpD,OAAO,IAAI,CAAC,IAAI,CACd,eAAe,EAAE,EACjB,iBAAiB,EACjB,UAAU,EACV,GAAG,SAAS,sBAAsB,CACnC,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC;IAC/B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,yCAAyC,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO;QACrC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;QACzD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;gBACvC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;gBACjE,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,kCAAkC,KAAK,uBAAuB,SAAS,EAAE,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,wCAAwC,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kDAAkD,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,4DAA4D,SAAS,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc,EAAE,KAAa;IAC9E,MAAM,CAAC,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC1C,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc;IAC/D,MAAM,CAAC,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,CACV,wBAAwB,CAAC,UAAU,GAAG,KAAK,SAAS,cAAc,iBAAiB,CAAC,IAAI,EAAE,CAC3F,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAoB,EACpB,MAAc;IAEd,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,SAAS,kBAAkB;IACzB,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AA0BD,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,KAAK;QACnC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,KAAK;QACnC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI;QAClC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,KAAK,CACpC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAwB;IAChD,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,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,8EAA8E;YAC9E,IAAI,GAAG,CAAC,YAAY,IAAI,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnE,iEAAiE;YACjE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;gBACrD,IAAI,OAAO;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,QAAQ,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,iCAAiC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAiBD;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAkB,EAClB,SAAiB,EACjB,IAA6B;IAE7B,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAqB;QAC5B,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QACrC,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,YAAY;QAChB,SAAS,EAAE,SAAS;QACpB,kBAAkB,EAAE,iBAAiB;QACrC,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,kBAAkB,EAAE;QAChC,SAAS,EAAE,GAAG,CAAC,cAAc;QAC7B,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE,QAAQ;KACnB,CAAC;IACF,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IACxC,CAAC;IAED,IAAI,IAAI,EAAE,gBAAgB,EAAE,CAAC;QAC3B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACtC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;SAAM,IAAI,IAAI,EAAE,kBAAkB,EAAE,CAAC;QACpC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACxC,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC;IAC9B,CAAC;SAAM,IAAI,IAAI,EAAE,iBAAiB,EAAE,CAAC;QACnC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACvC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,IAAI,0BAA0B,CAAC;IACnE,CAAC;SAAM,IAAI,IAAI,EAAE,kBAAkB,EAAE,CAAC;QACpC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACxC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;IACrD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,6BAA6B,CAAC,GAAqB;IACjE,OAAO,GAAG,CAAC,aAAa,CAAC;AAC3B,CAAC"}

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"}