@unlinearity/cli-wechat-bridge 1.1.6 → 1.2.0

package/dist/wechat/wechat-transport.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import crypto from "node:crypto";
 import { createCipheriv, createDecipheriv } from "node:crypto";
 import fs from "node:fs";
@@ -332,6 +338,15 @@ async function apiFetch(params) {
     const url = new URL(params.endpoint, base).toString();
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), params.timeoutMs);
+    const abortFromCaller = () => controller.abort(params.signal?.reason);
+    if (params.signal) {
+        if (params.signal.aborted) {
+            abortFromCaller();
+        }
+        else {
+            params.signal.addEventListener("abort", abortFromCaller, { once: true });
+        }
+    }
     try {
         const res = await fetch(url, {
             method: "POST",
@@ -353,6 +368,9 @@ async function apiFetch(params) {
         clearTimeout(timer);
         throw err;
     }
+    finally {
+        params.signal?.removeEventListener("abort", abortFromCaller);
+    }
 }
 function encryptAesEcb(plaintext, key) {
     const cipher = createCipheriv("aes-128-ecb", key, null);
@@ -806,12 +824,15 @@ function buildInboundAttachmentFilePath(params) {
     const uniquePrefix = `${timestamp.replace(/[:.]/g, "-")}-${crypto.randomBytes(4).toString("hex")}`;
     return path.join(directory, `${uniquePrefix}-${safeFileName}`);
 }
+const WECHAT_TYPING_TIMEOUT_MS = 8_000;
 export class WeChatTransport {
     logger;
     recentMessageKeys = new Set();
     recentMessageOrder = [];
     contextTokenCache;
     syncBuffer = "";
+    stopped = false;
+    activePollControllers = new Set();
     constructor(logger) {
         this.logger = logger;
         migrateLegacyChannelFiles((message) => this.logger.log(message));
@@ -855,73 +876,96 @@ export class WeChatTransport {
             ? "Reset sync state and cleared cached context tokens."
             : "Reset sync state.";
     }
+    stop() {
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        for (const controller of this.activePollControllers) {
+            controller.abort();
+        }
+        this.activePollControllers.clear();
+    }
     async pollMessages(options = {}) {
+        if (this.stopped) {
+            return { messages: [], ignoredBacklogCount: 0 };
+        }
         const timeoutMs = options.timeoutMs ?? DEFAULT_LONG_POLL_TIMEOUT_MS;
         const account = this.requireAccount();
-        let response = await this.getUpdates(account, timeoutMs);
-        if (isWechatSyncSessionTimeout(response) && this.syncBuffer) {
-            this.logger.log("WeChat sync session timed out. Clearing local sync cursor and retrying once.");
-            this.clearSyncBuffer();
-            response = await this.getUpdates(account, timeoutMs);
-        }
-        if (isWechatSyncSessionTimeout(response)) {
-            throw new Error('WeChat session timed out. Run "wechat-setup" to log in again.');
-        }
-        const isError = (response.ret !== undefined && response.ret !== 0) ||
-            (response.errcode !== undefined && response.errcode !== 0);
-        if (isError) {
-            throw new Error(`getUpdates failed: ret=${response.ret} errcode=${response.errcode} errmsg=${response.errmsg ?? ""}`);
-        }
-        if (response.get_updates_buf) {
-            this.syncBuffer = response.get_updates_buf;
-            this.saveSyncBuffer(this.syncBuffer);
-        }
-        const messages = [];
-        let ignoredBacklogCount = 0;
-        for (const rawMessage of response.msgs ?? []) {
-            if (rawMessage.message_type !== MSG_TYPE_USER) {
-                continue;
+        const controller = new AbortController();
+        this.activePollControllers.add(controller);
+        try {
+            let response = await this.getUpdates(account, timeoutMs, controller.signal);
+            if (isWechatSyncSessionTimeout(response) && this.syncBuffer && !this.stopped) {
+                this.logger.log("WeChat sync session timed out. Clearing local sync cursor and retrying once.");
+                this.clearSyncBuffer();
+                response = await this.getUpdates(account, timeoutMs, controller.signal);
             }
-            const extracted = extractInboundMessageContent(rawMessage);
-            if (!extracted.text && extracted.attachments.length === 0) {
-                continue;
+            if (this.stopped) {
+                return { messages: [], ignoredBacklogCount: 0 };
             }
-            const senderId = rawMessage.from_user_id ?? "unknown";
-            if (rawMessage.context_token) {
-                this.cacheContextToken(senderId, rawMessage.context_token);
+            if (isWechatSyncSessionTimeout(response)) {
+                throw new Error('WeChat session timed out. Run "wechat-setup" to log in again.');
             }
-            // Filter pre-start backlog BEFORE claiming/remembering the message so a
-            // skipped message is not permanently locked away from other processes.
-            // A missing create_time_ms is treated as fresh rather than dropped.
-            const createdAtMs = rawMessage.create_time_ms ?? 0;
-            if (typeof options.minCreatedAtMs === "number" &&
-                Number.isFinite(createdAtMs) &&
-                createdAtMs > 0 &&
-                createdAtMs < options.minCreatedAtMs) {
-                ignoredBacklogCount += 1;
-                continue;
+            const isError = (response.ret !== undefined && response.ret !== 0) ||
+                (response.errcode !== undefined && response.errcode !== 0);
+            if (isError) {
+                throw new Error(`getUpdates failed: ret=${response.ret} errcode=${response.errcode} errmsg=${response.errmsg ?? ""}`);
             }
-            const messageKey = buildMessageKey(rawMessage);
-            if (!this.rememberMessage(messageKey)) {
-                continue;
+            if (response.get_updates_buf) {
+                this.syncBuffer = response.get_updates_buf;
+                this.saveSyncBuffer(this.syncBuffer);
             }
-            if (!tryClaimInboundMessage(buildScopedMessageClaimKey(account.accountId, messageKey))) {
-                continue;
+            const messages = [];
+            let ignoredBacklogCount = 0;
+            for (const rawMessage of response.msgs ?? []) {
+                if (rawMessage.message_type !== MSG_TYPE_USER) {
+                    continue;
+                }
+                const extracted = extractInboundMessageContent(rawMessage);
+                if (!extracted.text && extracted.attachments.length === 0) {
+                    continue;
+                }
+                const senderId = rawMessage.from_user_id ?? "unknown";
+                if (rawMessage.context_token) {
+                    this.cacheContextToken(senderId, rawMessage.context_token);
+                }
+                // Filter pre-start backlog BEFORE claiming/remembering the message so a
+                // skipped message is not permanently locked away from other processes.
+                // A missing create_time_ms is treated as fresh rather than dropped.
+                const createdAtMs = rawMessage.create_time_ms ?? 0;
+                if (typeof options.minCreatedAtMs === "number" &&
+                    Number.isFinite(createdAtMs) &&
+                    createdAtMs > 0 &&
+                    createdAtMs < options.minCreatedAtMs) {
+                    ignoredBacklogCount += 1;
+                    continue;
+                }
+                const messageKey = buildMessageKey(rawMessage);
+                if (!this.rememberMessage(messageKey)) {
+                    continue;
+                }
+                if (!tryClaimInboundMessage(buildScopedMessageClaimKey(account.accountId, messageKey))) {
+                    continue;
+                }
+                const { attachments, failureLines } = await this.downloadInboundAttachments(extracted.attachments, rawMessage);
+                const text = appendInboundAttachmentFailureText(extracted.text, failureLines);
+                messages.push({
+                    senderId,
+                    sender: normalizeSender(senderId),
+                    sessionId: rawMessage.session_id ?? "",
+                    text,
+                    attachments,
+                    contextToken: rawMessage.context_token,
+                    createdAt: formatTimestamp(rawMessage.create_time_ms),
+                    createdAtMs,
+                });
             }
-            const { attachments, failureLines } = await this.downloadInboundAttachments(extracted.attachments, rawMessage);
-            const text = appendInboundAttachmentFailureText(extracted.text, failureLines);
-            messages.push({
-                senderId,
-                sender: normalizeSender(senderId),
-                sessionId: rawMessage.session_id ?? "",
-                text,
-                attachments,
-                contextToken: rawMessage.context_token,
-                createdAt: formatTimestamp(rawMessage.create_time_ms),
-                createdAtMs,
-            });
+            return { messages, ignoredBacklogCount };
+        }
+        finally {
+            this.activePollControllers.delete(controller);
         }
-        return { messages, ignoredBacklogCount };
     }
     async downloadInboundAttachments(descriptors, rawMessage) {
         const attachments = [];
@@ -963,6 +1007,72 @@ export class WeChatTransport {
         }
         return { attachments, failureLines };
     }
+    /** Typing status values for {@link sendTyping}. 1 = typing, 2 = cancel. */
+    static TYPING_STATUS = { TYPING: 1, CANCEL: 2 };
+    /**
+     * Fetch the per-user typing ticket from ilink/bot/getconfig.
+     * Returns "" when the endpoint fails or reports no ticket.
+     */
+    async fetchTypingTicket(recipientId) {
+        const account = this.requireAccount();
+        const resolvedRecipientId = recipientId?.trim() ||
+            [...this.contextTokenCache.keys()].at(-1);
+        if (!resolvedRecipientId) {
+            return "";
+        }
+        try {
+            const raw = await apiFetch({
+                baseUrl: account.baseUrl,
+                endpoint: "ilink/bot/getconfig",
+                body: JSON.stringify({
+                    ilink_user_id: resolvedRecipientId,
+                    ...(this.contextTokenCache.has(resolvedRecipientId)
+                        ? { context_token: this.contextTokenCache.get(resolvedRecipientId) }
+                        : {}),
+                }),
+                token: account.token,
+                timeoutMs: WECHAT_TYPING_TIMEOUT_MS,
+            });
+            const resp = JSON.parse(raw);
+            return resp.ret === 0 ? (resp.typing_ticket ?? "") : "";
+        }
+        catch {
+            return "";
+        }
+    }
+    /**
+     * Send or cancel a "typing…" indicator. Failures are logged only; the
+     * indicator is best-effort and never blocks message flow.
+     */
+    async sendTyping(recipientId, typingTicket, status) {
+        if (!typingTicket) {
+            return false;
+        }
+        const account = this.requireAccount();
+        try {
+            const raw = await apiFetch({
+                baseUrl: account.baseUrl,
+                endpoint: "ilink/bot/sendtyping",
+                body: JSON.stringify({
+                    ilink_user_id: recipientId,
+                    typing_ticket: typingTicket,
+                    status,
+                }),
+                token: account.token,
+                timeoutMs: WECHAT_TYPING_TIMEOUT_MS,
+            });
+            const resp = JSON.parse(raw);
+            if (resp.ret !== undefined && resp.ret !== 0) {
+                this.logger.logError(`sendTyping ret=${resp.ret} errmsg=${resp.errmsg ?? "(none)"}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            this.logger.logError(`sendTyping failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
     async sendText(senderId, text) {
         const trimmed = text.trim();
         if (!trimmed) {
@@ -1166,7 +1276,7 @@ export class WeChatTransport {
         }
         return stat;
     }
-    async getUpdates(account, timeoutMs) {
+    async getUpdates(account, timeoutMs, signal) {
         try {
             const raw = await apiFetch({
                 baseUrl: account.baseUrl,
@@ -1177,6 +1287,7 @@ export class WeChatTransport {
                 }),
                 token: account.token,
                 timeoutMs,
+                signal,
             });
             return JSON.parse(raw);
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unlinearity/cli-wechat-bridge",
-  "version": "1.1.6",
-  "description": "CLI WeChat Bridge for Codex, Claude Code, OpenCode, and Pi over WeChat",
+  "version": "1.2.0",
+  "description": "CLI bridge for Codex, Claude Code, OpenCode, and Pi over WeChat and WeCom",
   "type": "module",
   "files": [
     "bin/",
@@ -12,6 +12,7 @@
   ],
   "keywords": [
     "wechat",
+    "wecom",
     "cli",
     "bridge",
     "codex",
@@ -40,11 +41,20 @@
     "wechat-pi": "bin/wechat-pi.mjs",
     "wechat-daemon": "bin/wechat-daemon.mjs",
     "wechat-setup": "bin/wechat-setup.mjs",
-    "wechat-check-update": "bin/wechat-check-update.mjs"
+    "wechat-check-update": "bin/wechat-check-update.mjs",
+    "wecom-codex": "bin/wecom-codex.mjs",
+    "wecom-claude": "bin/wecom-claude.mjs",
+    "wecom-opencode": "bin/wecom-opencode.mjs",
+    "wecom-pi": "bin/wecom-pi.mjs",
+    "wecom-daemon": "bin/wecom-daemon.mjs",
+    "wecom-setup": "bin/wecom-setup.mjs",
+    "wecom-check-update": "bin/wecom-check-update.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@opencode-ai/sdk": "^1.18.0",
+    "@wecom/aibot-node-sdk": "1.0.7",
+    "@xterm/headless": "^6.0.0",
     "node-pty": "^1.1.0",
     "qrcode-terminal": "^0.12.0"
   },

package/scripts/ensure-node-pty-permissions.mjs

@@ -1,73 +1,73 @@
-#!/usr/bin/env node
-
-// Ensure the bundled node-pty `spawn-helper` is executable.
-//
-// node-pty ships its prebuilt `spawn-helper` binaries with mode 0644 (no exec
-// bit) in the published tarball. On macOS/Linux that makes `posix_spawnp`
-// fail when node-pty tries to fork a PTY, so the bridge silently drops to the
-// non-PTY fallback. The Claude adapter relies on PTY interactive mode, so the
-// fallback surfaces to users as:
-//
-//   Error: Input must be provided ... when using --print
-//
-// Restoring the exec bit after install fixes PTY spawning. This runs on
-// postinstall and is idempotent; it never fails the install.
-
-import fs from "node:fs";
-import path from "node:path";
-import { createRequire } from "node:module";
-
-if (process.platform === "win32") {
-  process.exit(0);
-}
-
-const require = createRequire(import.meta.url);
-
-let nodePtyDir;
-try {
-  nodePtyDir = path.dirname(require.resolve("node-pty/package.json"));
-} catch {
-  // node-pty is optional in unsupported environments; nothing to fix.
-  process.exit(0);
-}
-
-const candidates = [
-  "prebuilds/darwin-arm64/spawn-helper",
-  "prebuilds/darwin-x64/spawn-helper",
-  "prebuilds/linux-x64/spawn-helper",
-  "prebuilds/linux-arm64/spawn-helper",
-  "build/Release/spawn-helper",
-];
-
-let fixed = 0;
-for (const relative of candidates) {
-  const helperPath = path.join(nodePtyDir, relative);
-  let stats;
-  try {
-    stats = fs.statSync(helperPath);
-  } catch {
-    continue;
-  }
-  if (!stats.isFile()) {
-    continue;
-  }
-  if ((stats.mode & 0o111) !== 0) {
-    continue;
-  }
-  try {
-    fs.chmodSync(helperPath, stats.mode | 0o755);
-    fixed += 1;
-  } catch (error) {
-    console.warn(
-      `[cli-wechat-bridge] Could not make node-pty spawn-helper executable: ${helperPath}\n` +
-        `  ${error instanceof Error ? error.message : String(error)}\n` +
-        "  PTY mode may be unavailable; run --doctor for details.",
-    );
-  }
-}
-
-if (fixed > 0) {
-  console.log(
-    `[cli-wechat-bridge] Restored executable bit on ${fixed} node-pty spawn-helper binary(ies).`,
-  );
-}
+#!/usr/bin/env node
+
+// Ensure the bundled node-pty `spawn-helper` is executable.
+//
+// node-pty ships its prebuilt `spawn-helper` binaries with mode 0644 (no exec
+// bit) in the published tarball. On macOS/Linux that makes `posix_spawnp`
+// fail when node-pty tries to fork a PTY, so the bridge silently drops to the
+// non-PTY fallback. The Claude adapter relies on PTY interactive mode, so the
+// fallback surfaces to users as:
+//
+//   Error: Input must be provided ... when using --print
+//
+// Restoring the exec bit after install fixes PTY spawning. This runs on
+// postinstall and is idempotent; it never fails the install.
+
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+
+if (process.platform === "win32") {
+  process.exit(0);
+}
+
+const require = createRequire(import.meta.url);
+
+let nodePtyDir;
+try {
+  nodePtyDir = path.dirname(require.resolve("node-pty/package.json"));
+} catch {
+  // node-pty is optional in unsupported environments; nothing to fix.
+  process.exit(0);
+}
+
+const candidates = [
+  "prebuilds/darwin-arm64/spawn-helper",
+  "prebuilds/darwin-x64/spawn-helper",
+  "prebuilds/linux-x64/spawn-helper",
+  "prebuilds/linux-arm64/spawn-helper",
+  "build/Release/spawn-helper",
+];
+
+let fixed = 0;
+for (const relative of candidates) {
+  const helperPath = path.join(nodePtyDir, relative);
+  let stats;
+  try {
+    stats = fs.statSync(helperPath);
+  } catch {
+    continue;
+  }
+  if (!stats.isFile()) {
+    continue;
+  }
+  if ((stats.mode & 0o111) !== 0) {
+    continue;
+  }
+  try {
+    fs.chmodSync(helperPath, stats.mode | 0o755);
+    fixed += 1;
+  } catch (error) {
+    console.warn(
+      `[cli-wechat-bridge] Could not make node-pty spawn-helper executable: ${helperPath}\n` +
+        `  ${error instanceof Error ? error.message : String(error)}\n` +
+        "  PTY mode may be unavailable; run --doctor for details.",
+    );
+  }
+}
+
+if (fixed > 0) {
+  console.log(
+    `[cli-wechat-bridge] Restored executable bit on ${fixed} node-pty spawn-helper binary(ies).`,
+  );
+}