@ganglion/xacpx 0.9.1 → 0.9.3

package/README.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
@@ -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.`,
@@ -1615,7 +1618,6 @@ var init_cli_update = __esm(() => {
     updateFailed: (name, error) => `${name} update failed: ${error}`,
     targetNotFound: (name) => `Update target not found: ${name}`,
     targetVersionUnknown: (name) => `${name}: cannot check latest version; skipped.`,
-    targetNotPinned: (name) => `${name} has no recorded version; use \`xacpx plugin update ${name}\` or specify a version explicitly.`,
     multiTargetNonInteractive: "Installed plugins detected; in non-interactive mode use `xacpx update --all` or `xacpx update <name>`.",
     selectionPrompt: "Select items to update (numbers, comma-separated; a=all; Enter to cancel): ",
     selectionInvalid: (part) => `Invalid selection: ${part}`,
@@ -1646,6 +1648,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 +1950,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 +2497,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}」不存在，请先创建。`,
@@ -2681,7 +2688,6 @@ var init_cli_update2 = __esm(() => {
     updateFailed: (name, error) => `${name} 更新失败：${error}`,
     targetNotFound: (name) => `没有找到更新项：${name}`,
     targetVersionUnknown: (name) => `${name} 无法检查最新版本，已跳过。`,
-    targetNotPinned: (name) => `${name} 未记录当前版本；请先使用 \`xacpx plugin update ${name}\` 或显式选择版本。`,
     multiTargetNonInteractive: "检测到已安装插件；非交互模式请使用 `xacpx update --all` 或 `xacpx update <name>`。",
     selectionPrompt: "请选择要更新的项目（数字，逗号分隔，a=全部，回车取消）：",
     selectionInvalid: (part) => `无效选择：${part}`,
@@ -2712,6 +2718,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 状态，已自动启用。`,
@@ -3030,10 +3038,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: [
@@ -3060,7 +3068,7 @@ function buildQueueOwnerPayload(input) {
 
 class AcpxQueueOwnerLauncher {
   acpxCommand;
-  weacpxCommand;
+  xacpxCommand;
   spawnOwner;
   terminateOwner;
   baseEnv;
@@ -3069,7 +3077,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;
@@ -3097,8 +3105,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 } : {}
       })]
@@ -3153,13 +3161,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) };
 }
@@ -3205,7 +3213,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();
@@ -3641,8 +3649,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];
@@ -3652,6 +3661,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",
@@ -3919,7 +3932,8 @@ var BRIDGE_METHODS = new Set([
   "prompt",
   "setMode",
   "cancel",
-  "removeSession"
+  "removeSession",
+  "getAgentSessionId"
 ]);
 var SESSION_SCOPED_METHODS = new Set([
   "hasSession",
@@ -3929,7 +3943,8 @@ var SESSION_SCOPED_METHODS = new Set([
   "prompt",
   "setMode",
   "cancel",
-  "removeSession"
+  "removeSession",
+  "getAgentSessionId"
 ]);
 
 class BridgeServer {
@@ -4105,6 +4120,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}`);
     }