cli-wechat-bridge 1.1.7 → 1.2.0

package/dist/i18n/index.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 { messages as zhMessages } from "./messages-zh.js";
 import { messages as enMessages } from "./messages-en.js";
 const catalogs = {

package/dist/i18n/messages-en.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.
 export const messages = {
     // === Bridge welcome & control ===
     "bridge.welcome": "WeChat Bridge ready ({adapter}).\nCWD: {cwd}",
@@ -11,7 +17,7 @@ export const messages = {
     "bridge.fatalError": "Bridge error: {message}",
     "bridge.backlogIgnored": "Ignored {count} backlog message(s) sent before the bridge started (they will not be processed).\nIf you actually sent them after the bridge started, your system clock is likely skewed by more than {graceSeconds}s — sync the clock and restart the bridge.",
     // === Daemon welcome & control ===
-    "daemon.welcome": "WeChat Daemon ready.\nCWD: {cwd}\nActive: {adapter}\n\nCommands: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status\n{bindings}\n\nManage: /bind [emoji] cmd, /unbind [emoji], /bindings",
+    "daemon.welcome": "WeChat Daemon ready.\nCWD: {cwd}\nActive: {adapter}\n\nCommands: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status, /model, /plan, /all <prompt>\n{bindings}\n\nManage: /bind [emoji] cmd, /unbind [emoji], /bindings",
     "daemon.noActiveAdapter": "No active terminal is selected. Send /codex, /claude, /opencode, or /pi to start one.",
     "daemon.switchResult.new": "Started a new visible CLI.",
     "daemon.switchResult.reused": "Reused the existing visible CLI.",

package/dist/i18n/messages-zh.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.
 export const messages = {
     // === 桥接欢迎 & 控制 ===
     "bridge.welcome": "微信桥接就绪 ({adapter})。\n工作目录: {cwd}",
@@ -11,7 +17,7 @@ export const messages = {
     "bridge.fatalError": "桥接错误: {message}",
     "bridge.backlogIgnored": "已忽略 {count} 条桥接启动前的积压消息（不会自动处理）。\n如果你是在桥接启动后才发送的消息却看到此提示，说明本机系统时钟可能不准（偏差超过 {graceSeconds} 秒），请校准时间后重启桥接。",
     // === Daemon 欢迎 & 控制 ===
-    "daemon.welcome": "微信 Daemon 就绪。\n工作目录: {cwd}\n当前: {adapter}\n\n命令: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status\n{bindings}\n\n管理: /bind [表情] 命令, /unbind [表情], /bindings",
+    "daemon.welcome": "微信 Daemon 就绪。\n工作目录: {cwd}\n当前: {adapter}\n\n命令: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status, /model, /plan, /all <prompt>\n{bindings}\n\n管理: /bind [表情] 命令, /unbind [表情], /bindings",
     "daemon.noActiveAdapter": "未选择活跃终端。发送 /codex、/claude、/opencode 或 /pi 启动一个。",
     "daemon.switchResult.new": "已启动新的可见 CLI。",
     "daemon.switchResult.reused": "已复用现有的可见 CLI。",

package/dist/runtime/create-runtime-host.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 { createBridgeAdapter } from "../bridge/bridge-adapters.js";
 import { CodexPtyAdapter } from "../bridge/bridge-adapters.codex.js";
 import { LegacyAdapterRuntime } from "./legacy-adapter-runtime.js";

package/dist/runtime/legacy-adapter-runtime.js

@@ -25,6 +25,21 @@ export class LegacyAdapterRuntime {
         }
         await this.adapter.createSession();
     }
+    async listModels() {
+        if (!this.adapter.listModels)
+            throw new Error("Model listing is not supported by this companion.");
+        return this.adapter.listModels();
+    }
+    async selectModel(modelId) {
+        if (!this.adapter.selectModel)
+            throw new Error("Model selection is not supported by this companion.");
+        return this.adapter.selectModel(modelId);
+    }
+    async setPlanMode(enabled) {
+        if (!this.adapter.setPlanMode)
+            throw new Error("Plan mode is not supported by this companion.");
+        return this.adapter.setPlanMode(enabled);
+    }
     async interrupt() {
         return await this.adapter.interrupt();
     }

package/dist/runtime/runtime-types.js

@@ -3,3 +3,6 @@ export const CODEX_REMOTE_AUTH_TOKEN_ENV = "WECHAT_BRIDGE_CODEX_REMOTE_AUTH_TOKE
 export function hasLocalClientEndpointProvider(runtime) {
     return typeof runtime.getLocalClientEndpoint === "function";
 }
+export function hasVisibleClientSessionPreparer(runtime) {
+    return typeof runtime.prepareVisibleClientSession === "function";
+}

package/dist/utils/atomic-file.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 fs from "node:fs";
 import { ensureChannelDataDir } from "../wechat/channel-config.js";
 /**

package/dist/utils/doctor.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 { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import net from "node:net";

package/dist/utils/version-checker.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 fs from "node:fs";
 import path from "node:path";
 import { CHANNEL_DATA_DIR, ensureChannelDataDir } from "../wechat/channel-config.js";
@@ -179,16 +185,16 @@ export async function checkForUpdate(forceCheck = false) {
  */
 export function formatUpdateMessage(versionInfo) {
     const { current, latest } = versionInfo;
-    return `
-[Update Available] Version ${latest} is available (current: ${current})
-
-Update instructions:
-   cd CLI-WeChat-Bridge
-   git pull
-   bun install
-   npm install -g .
-
-For more information:
-   https://github.com/UNLINEARITY/CLI-WeChat-Bridge/releases
+    return `
+[Update Available] Version ${latest} is available (current: ${current})
+
+Update instructions:
+   cd CLI-WeChat-Bridge
+   git pull
+   bun install
+   npm install -g .
+
+For more information:
+   https://github.com/UNLINEARITY/CLI-WeChat-Bridge/releases
 `;
 }

package/dist/wechat/channel-config.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 fs from "node:fs";
 import os from "node:os";

package/dist/wechat/setup.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env bun
+// 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.
 /**
  * CLI WeChat Bridge setup.
  *

package/dist/wechat/wechat-channel.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env bun
+// 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.
 /**
  * WeChat MCP server.
  *

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);
         }