@ganglion/xacpx 0.9.0 → 0.9.2

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm](https://img.shields.io/npm/v/@ganglion/xacpx?style=flat-square)](https://www.npmjs.com/package/@ganglion/xacpx)
 [![Node.js Version](https://img.shields.io/node/v/@ganglion/xacpx?style=flat-square)](https://nodejs.org)
-[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat-square&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS42MDE1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/gadzan/weacpx)
+[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat-square&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS42MDE1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/gadzan/xacpx)
 [![License](https://img.shields.io/npm/l/@ganglion/xacpx?style=flat-square)](./LICENSE)
 
 English · **[中文](./docs/zh/README_zh.md)**
@@ -13,6 +13,8 @@ English · **[中文](./docs/zh/README_zh.md)**
 
 `xacpx` is a tool that lets you control ACP agents such as Codex / Claude Code / Gemini / OpenCode directly from WeChat, Feishu, or Yuanbao. It connects chat messages to your agent CLI sessions through `acpx`, so you can, right from your phone:
 
+[![xacpx.png](https://s41.ax1x.com/2026/06/05/pmZXIv6.png)](https://imgchr.com/i/pmZXIv6)
+
 - Create and switch between sessions
 - Have the agent keep working in a specific project directory
 - View streaming replies, final results, and tool-call summaries
@@ -281,7 +283,7 @@ Notes:
 - In a non-interactive environment, updating the core or plugins needs explicit confirmation: use `xacpx update --all`, or name the target with `xacpx update <name>`.
 - `update` covers the core package and channel plugins; to manage a single plugin's version directly, see `xacpx plugin update <name>` ([docs/plugin-development.md](./docs/plugin-development.md)).
 - After updating, run `xacpx restart` so a running daemon loads the new version.
-- Cross-package rename migration: once the project's renamed successor package is published, running `weacpx update` will offer to migrate you across to it automatically (you confirm the switch). Until then this is dormant and `update` behaves as a normal self-update.
+- Cross-package rename migration: this project was renamed `weacpx` → `xacpx`. If you still have the legacy `weacpx` package installed, running `weacpx update` will offer to migrate you across to `xacpx` automatically (you confirm the switch). Already on `xacpx`? Just use `xacpx update` as a normal self-update.
 
 ## Common chat commands
 
@@ -427,7 +429,7 @@ Notes:
 
 If you want to first understand when to delegate and when to dispatch multiple subtasks in parallel, see:
 
-- [docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
+- [docs/xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md)
 
 
 ### MCP integration: external coordinator
@@ -579,7 +581,7 @@ If what you're about to do is one of the following, you can continue from here:
 
 - Want the full chat-command reference: [docs/commands.md](./docs/commands.md)
 - Want to schedule a one-time future message with scheduled tasks (`/later`): [docs/later-command.md](./docs/later-command.md)
-- Want to understand when to delegate and when to open a group: [docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
+- Want to understand when to delegate and when to open a group: [docs/xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md)
 
 ### Troubleshooting and verification
 

package/dist/bridge/bridge-main.js

@@ -880,10 +880,11 @@ var init_session = __esm(() => {
     replyModeHeader: "Current reply mode:",
     replyModeSessionLabel: (alias) => `- Session: ${alias}`,
     replyModeGlobalDefault: (value) => `- Global default: ${value}`,
+    replyModeChannelDefault: (value) => `- Channel default: ${value}`,
     replyModeSessionOverride: (value) => `- Session override: ${value}`,
     replyModeEffective: (value) => `- Effective: ${value}`,
     replyModeSet: (replyMode) => `Current session reply mode set to: ${replyMode}`,
-    replyModeReset: (globalDefault) => `Session reply mode reset. Falling back to global default: ${globalDefault}`,
+    replyModeReset: (effective) => `Session reply mode reset. Now effective: ${effective}`,
     statusHeader: "Current session:",
     statusNameLabel: (alias) => `- Name: ${alias}`,
     statusAgentLabel: (agent) => `- Agent: ${agent}`,
@@ -1426,6 +1427,8 @@ var init_config = __esm(() => {
     mustBePositiveNumber: (path2) => `${path2} must be a positive number.`,
     channelTypeDisabled: "channel.type is a legacy single-channel field; /config set writes are disabled. Use `xacpx channel ...` to manage channels[], then restart xacpx.",
     channelReplyModeInvalid: "channel.replyMode only supports: stream, final, verbose",
+    channelRuntimeNotFound: (id) => `Channel "${id}" does not exist; add it first with \`xacpx channel add ${id}\`.`,
+    channelRuntimeReplyModeInvalid: (id) => `channels.${id}.replyMode only supports: stream, final, verbose`,
     wechatReplyModeInvalid: "wechat.replyMode only supports: stream, final, verbose",
     wechatReplyModeMapped: (value) => `${value} (mapped to channel.replyMode)`,
     agentNotFound: (name) => `Agent "${name}" does not exist. Create it first.`,
@@ -1646,6 +1649,8 @@ var init_channel_cli = __esm(() => {
     channelRemoved: (id) => `Channel ${id} removed`,
     cannotDisableLastEnabled: "Cannot disable the last enabled channel.",
     channelEnabledToggled: (id, enabled) => `Channel ${id} ${enabled ? "enabled" : "disabled"}`,
+    channelReplyModeSet: (id, mode) => `Channel ${id} default reply mode set to: ${mode}`,
+    channelReplyModeInvalid: (mode) => `reply mode must be stream / final / verbose, got: ${mode}`,
     channelAccountAlreadyExists: (type, accountId) => `Account ${accountId} already exists on channel ${type}; run xacpx channel rm ${type} --account ${accountId} first`,
     channelAccountAdded: (type, accountId) => `Channel ${type} account ${accountId} added`,
     channelReEnabled: (type) => `Channel ${type} was disabled; it has been automatically re-enabled.`,
@@ -1946,10 +1951,11 @@ var init_session2 = __esm(() => {
     replyModeHeader: "当前 reply mode：",
     replyModeSessionLabel: (alias) => `- 会话：${alias}`,
     replyModeGlobalDefault: (value) => `- 全局默认：${value}`,
+    replyModeChannelDefault: (value) => `- 频道默认：${value}`,
     replyModeSessionOverride: (value) => `- 当前会话覆盖：${value}`,
     replyModeEffective: (value) => `- 当前生效：${value}`,
     replyModeSet: (replyMode) => `已设置当前会话 reply mode：${replyMode}`,
-    replyModeReset: (globalDefault) => `已重置当前会话 reply mode，当前回退到全局默认：${globalDefault}`,
+    replyModeReset: (effective) => `已重置当前会话 reply mode，当前生效：${effective}`,
     statusHeader: "当前会话：",
     statusNameLabel: (alias) => `- 名称：${alias}`,
     statusAgentLabel: (agent2) => `- Agent：${agent2}`,
@@ -2492,6 +2498,8 @@ var init_config2 = __esm(() => {
     mustBePositiveNumber: (path2) => `${path2} 必须是正数。`,
     channelTypeDisabled: "channel.type 是旧单频道字段，/config set 已禁用写入；请使用 `xacpx channel ...` 管理 channels[]，然后重启 xacpx。",
     channelReplyModeInvalid: "channel.replyMode 只支持：stream、final、verbose",
+    channelRuntimeNotFound: (id) => `频道「${id}」不存在；请先用 \`xacpx channel add ${id}\` 添加。`,
+    channelRuntimeReplyModeInvalid: (id) => `channels.${id}.replyMode 只支持：stream、final、verbose`,
     wechatReplyModeInvalid: "wechat.replyMode 只支持：stream、final、verbose",
     wechatReplyModeMapped: (value) => `${value}（已映射到 channel.replyMode）`,
     agentNotFound: (name) => `Agent「${name}」不存在，请先创建。`,
@@ -2712,6 +2720,8 @@ var init_channel_cli2 = __esm(() => {
     channelRemoved: (id) => `频道 ${id} 已删除`,
     cannotDisableLastEnabled: "不能禁用最后一个启用的频道。",
     channelEnabledToggled: (id, enabled) => `频道 ${id} 已${enabled ? "启用" : "禁用"}`,
+    channelReplyModeSet: (id, mode) => `频道 ${id} 的默认 reply mode 已设置为：${mode}`,
+    channelReplyModeInvalid: (mode) => `reply mode 只支持 stream / final / verbose，收到：${mode}`,
     channelAccountAlreadyExists: (type, accountId) => `频道 ${type} 的账号 ${accountId} 已存在；先 xacpx channel rm ${type} --account ${accountId}`,
     channelAccountAdded: (type, accountId) => `频道 ${type} 账号 ${accountId} 已添加`,
     channelReEnabled: (type) => `频道 ${type} 此前是 disabled 状态，已自动启用。`,
@@ -2976,12 +2986,22 @@ var init_zh = __esm(() => {
 function isLocale(value) {
   return typeof value === "string" && VALID.includes(value);
 }
+function detectSystemLocale() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale || "";
+  } catch {
+    return "";
+  }
+}
 function resolveLocale(input = {}) {
   const { configLanguage, env = process.env } = input;
   if (isLocale(configLanguage))
     return configLanguage;
   const raw = env.LC_ALL || env.LC_MESSAGES || env.LANG || "";
-  return /^zh/i.test(raw) ? "zh" : "en";
+  if (raw)
+    return /^zh/i.test(raw) ? "zh" : "en";
+  const systemLocale = input.systemLocale ?? detectSystemLocale();
+  return /^zh/i.test(systemLocale) ? "zh" : "en";
 }
 var VALID;
 var init_resolve_locale = __esm(() => {
@@ -3020,10 +3040,10 @@ import { spawn as spawn3 } from "node:child_process";
 import { readFile, unlink } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
-function buildWeacpxMcpServerSpec(input) {
-  const { command, args } = splitCommandLine(input.weacpxCommand);
+function buildXacpxMcpServerSpec(input) {
+  const { command, args } = splitCommandLine(input.xacpxCommand);
   return {
-    name: "weacpx",
+    name: "xacpx",
     type: "stdio",
     command,
     args: [
@@ -3050,7 +3070,7 @@ function buildQueueOwnerPayload(input) {
 
 class AcpxQueueOwnerLauncher {
   acpxCommand;
-  weacpxCommand;
+  xacpxCommand;
   spawnOwner;
   terminateOwner;
   baseEnv;
@@ -3059,7 +3079,7 @@ class AcpxQueueOwnerLauncher {
   launchLocks = new Map;
   constructor(options) {
     this.acpxCommand = options.acpxCommand;
-    this.weacpxCommand = options.weacpxCommand ?? resolveDefaultWeacpxCommand(options.baseEnv ?? process.env);
+    this.xacpxCommand = options.xacpxCommand ?? resolveDefaultXacpxCommand(options.baseEnv ?? process.env);
     this.spawnOwner = options.spawnOwner ?? defaultQueueOwnerSpawner;
     this.terminateOwner = options.terminateOwner ?? createDefaultQueueOwnerTerminator(options.acpxCommand);
     this.baseEnv = options.baseEnv ?? process.env;
@@ -3087,8 +3107,8 @@ class AcpxQueueOwnerLauncher {
       nonInteractivePermissions: input.nonInteractivePermissions,
       ttlMs: this.ttlMs,
       maxQueueDepth: this.maxQueueDepth,
-      mcpServers: [buildWeacpxMcpServerSpec({
-        weacpxCommand: this.weacpxCommand,
+      mcpServers: [buildXacpxMcpServerSpec({
+        xacpxCommand: this.xacpxCommand,
         coordinatorSession: input.coordinatorSession,
         ...input.sourceHandle ? { sourceHandle: input.sourceHandle } : {}
       })]
@@ -3143,13 +3163,13 @@ function splitCommandLine(value) {
     current += "\\";
   }
   if (quote) {
-    throw new Error("weacpx MCP command has an unterminated quote");
+    throw new Error("xacpx MCP command has an unterminated quote");
   }
   if (current.length > 0) {
     parts.push(current);
   }
   if (parts.length === 0) {
-    throw new Error("weacpx MCP command must not be empty");
+    throw new Error("xacpx MCP command must not be empty");
   }
   return { command: parts[0], args: parts.slice(1) };
 }
@@ -3195,7 +3215,7 @@ function queueLockFilePath(sessionId) {
 function shortHash(value, length) {
   return createHash("sha256").update(value).digest("hex").slice(0, length);
 }
-function resolveDefaultWeacpxCommand(env) {
+function resolveDefaultXacpxCommand(env) {
   const cliCommand = coreEnv("CLI_COMMAND", env);
   if (cliCommand?.trim()) {
     return cliCommand.trim();
@@ -3631,8 +3651,9 @@ class BridgeRuntime {
       } else if (typeof parsed.id === "string") {
         acpxRecordId = parsed.id;
       }
+      const agentSessionId = typeof parsed.agentSessionId === "string" ? parsed.agentSessionId : undefined;
       if (acpxRecordId) {
-        return { acpxRecordId };
+        return { acpxRecordId, agentSessionId };
       }
     } catch {
       const firstLine = result.stdout.trim().split(/\r?\n/, 1)[0];
@@ -3642,6 +3663,10 @@ class BridgeRuntime {
     }
     throw new Error("failed to resolve acpx session record id");
   }
+  async getAgentSessionId(input) {
+    const record = await this.readSessionRecord(input);
+    return { agentSessionId: record.agentSessionId };
+  }
   async setMode(input) {
     const spawnSpec = resolveSpawnCommand(this.command, this.buildSessionArgs(input, [
       "set-mode",
@@ -3909,7 +3934,8 @@ var BRIDGE_METHODS = new Set([
   "prompt",
   "setMode",
   "cancel",
-  "removeSession"
+  "removeSession",
+  "getAgentSessionId"
 ]);
 var SESSION_SCOPED_METHODS = new Set([
   "hasSession",
@@ -3919,7 +3945,8 @@ var SESSION_SCOPED_METHODS = new Set([
   "prompt",
   "setMode",
   "cancel",
-  "removeSession"
+  "removeSession",
+  "getAgentSessionId"
 ]);
 
 class BridgeServer {
@@ -4095,6 +4122,13 @@ class BridgeServer {
           cwd: requireString(params, "cwd"),
           name: requireString(params, "name")
         });
+      case "getAgentSessionId":
+        return await this.runtime.getAgentSessionId({
+          agent: requireString(params, "agent"),
+          agentCommand: asOptionalString(params.agentCommand),
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name")
+        });
       default:
         throw new Error(`unsupported bridge method: ${method}`);
     }