weacpx 0.1.6 → 0.2.0

package/README.md

@@ -1,14 +1,35 @@
-# weacpx 
+# Weacpx
 
-使用微信 ClawBot 随时随地通过 `acpx` 控制 Claude Code、Codex 等 Agents。
+连接微信与 acpx 协议，让 Claude Code / Codex 成为你口袋里的 24/7 伙伴。
+
+[![npm](https://img.shields.io/npm/v/weacpx?style=flat-square)](https://www.npmjs.com/package/weacpx)
+[![Node.js Version](https://img.shields.io/node/v/weacpx?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%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/gadzan/weacpx)
+[![License](https://img.shields.io/npm/l/weacpx?style=flat-square)](./LICENSE)
+
+![weacpx logo](assets/weacpx.jpg)
+
+## Why Weacpx？
+
+在 Agent-First 的开发模式下，编码任务必须依托顶级 Agents，🙅‍♀️不要通过 openclaw 去开发，现在有一个更好的方案。Weacpx 通过微信提供一个轻量化的远程入口，随时随地通过手机驱动你的顶级 Agents。
+
+Weacpx 的核心价值主张很简单：
+
+**随时随地访问** — 只要你有微信，就能控制你的 Agent。无需 VPN、Web 界面或复杂的云服务配置。
+
+**统一的会话管理** — 通过 acpx 协议，weacpx 让你在微信里管理多个 Agent 会话（Codex、Claude Code 等），就像在本地终端一样。创建、切换、查询状态，全部通过简单的斜杠命令完成，这是其它简单基于 ACP 实现的远控 agent 所不具备的。
+
+**轻量守护进程** — weacpx 作为后台守护进程运行，资源占用极低。不用启动一个臃肿 openclaw，不用担心在工作机器上使用会占用资源。启动、停止、查看状态都通过简单的 CLI 命令完成。
+
+**权限可控** — 可以即时通过微信修改 agent 的权限，无论是 YOLO 还是只读。
 
 ## 安装前准备
 
 开始前，至少需要：
 
 - Node.js 22+ 或 Bun
-- 一个可用的微信登录环境
 - Claude Code 或 Codex
+- 装了微信的手机
 
 > `weacpx` 基于 `weixin-agent-sdk` 与 `acpx` 实现。
 > 正常情况下，不需要再额外全局安装 `acpx`。
@@ -252,12 +273,6 @@ bun run dev
 - `~/.weacpx/runtime/stdout.log`
 - `~/.weacpx/runtime/stderr.log`
 
-常用环境变量：
-
-- `WEACPX_CONFIG`
-- `WEACPX_STATE`
-- `WEACPX_WEIXIN_SDK`
-
 ### Transport 权限配置
 
 `config.json` 中的 `transport` 支持以下权限字段：
@@ -304,36 +319,6 @@ bun run dev
 
 ## 注意事项
 
-### `dry-run`
-
-`dry-run` 会复用同一套 router、session service、transport，只是把微信消息换成终端输入，适合本地排查。
-
-示例：
-
-```bash
-bun run dry-run --chat-key wx:test -- \
-  "/agent add codex" \
-  "/ws new backend -d /absolute/path/to/backend" \
-  "/ss new demo -a codex --ws backend" \
-  "/status"
-```
-
-### 如果 `/ss new` 失败
-
-当前最常见的问题仍然是底层 `acpx` named session 的运行时恢复，不一定是 `weacpx` 本身的逻辑问题。
-
-可以先在本地创建一个 named session，再在微信里 attach：
-
-```bash
-./node_modules/.bin/acpx --verbose --cwd /absolute/workspace/path codex sessions new --name existing-demo
-```
-
-然后在微信里：
-
-```text
-/ss attach demo -a codex --ws backend --name existing-demo
-```
-
 ### Adapter mode 参考
 
 `acpx set-mode` / 计划中的 `/mode <id>` 本质上都是给底层 ACP session 发送 `session/set_mode`。
@@ -354,6 +339,22 @@ bun run dry-run --chat-key wx:test -- \
 - 对其他 adapter，不要在 `weacpx` 里写死候选值；最好把 `/mode <id>` 设计成透传，由 adapter 自己决定是否接受。
 - 如果某个 adapter 后续补充了官方 mode 文档，再把它们补进这里。
 
+### 如果 `/ss new` 失败
+
+当前最常见的问题仍然是底层 `acpx` named session 的运行时恢复，不一定是 `weacpx` 本身的逻辑问题。
+
+可以先在本地创建一个 named session，再在微信里 attach：
+
+```bash
+./node_modules/.bin/acpx --verbose --cwd /absolute/workspace/path codex sessions new --name existing-demo
+```
+
+然后在微信里：
+
+```text
+/ss attach demo -a codex --ws backend --name existing-demo
+```
+
 ## 更多文档
 
 - 配置参考：[docs/config-reference.md](./docs/config-reference.md)

package/config.example.json

@@ -3,7 +3,7 @@
     "type": "acpx-bridge",
     "sessionInitTimeoutMs": 120000,
     "permissionMode": "approve-all",
-    "nonInteractivePermissions": "fail"
+    "nonInteractivePermissions": "deny"
   },
   "logging": {
     "level": "info",
@@ -11,6 +11,9 @@
     "maxFiles": 5,
     "retentionDays": 7
   },
+  "wechat": {
+    "replyMode": "stream"
+  },
   "agents": {
     "codex": {
       "driver": "codex"

package/dist/bridge/bridge-main.js

@@ -46,6 +46,16 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/transport/acpx-bridge/acpx-bridge-protocol.ts
+function encodeBridgeRequest(request) {
+  return `${JSON.stringify(request)}
+`;
+}
+function encodeBridgePromptSegmentEvent(event) {
+  return `${JSON.stringify(event)}
+`;
+}
+
 // src/transport/prompt-output.ts
 function getPromptText(result) {
   const stdoutOutput = extractPromptOutput(result.stdout);
@@ -193,21 +203,102 @@ var init_spawn_command = __esm(() => {
   SCRIPT_FILE_PATTERN = /\.(c|m)?js$/i;
 });
 
+// src/transport/streaming-prompt.ts
+function createStreamingPromptState() {
+  return {
+    buffer: "",
+    segments: [],
+    hasAgentMessage: false,
+    pendingLine: "",
+    finalize() {
+      if (this.pendingLine.trim().length > 0) {
+        parseStreamingChunks(this, this.pendingLine);
+      }
+      const remaining = this.buffer.trim();
+      this.buffer = "";
+      this.pendingLine = "";
+      return remaining;
+    }
+  };
+}
+function parseStreamingDataChunk(state, chunk) {
+  state.pendingLine += chunk;
+  let boundary;
+  while ((boundary = state.pendingLine.indexOf(`
+`)) !== -1) {
+    const line = state.pendingLine.slice(0, boundary);
+    state.pendingLine = state.pendingLine.slice(boundary + 1);
+    parseStreamingChunks(state, line);
+  }
+}
+function parseStreamingChunks(state, line) {
+  const trimmed = line.trim();
+  if (trimmed.length === 0)
+    return;
+  let event;
+  try {
+    event = JSON.parse(trimmed);
+  } catch {
+    return;
+  }
+  const isMessageChunk = event.method === "session/update" && event.params?.update?.sessionUpdate === "agent_message_chunk" && event.params.update.content?.type === "text" && typeof event.params.update.content.text === "string";
+  if (!isMessageChunk)
+    return;
+  state.hasAgentMessage = true;
+  const chunk = event.params.update.content.text ?? "";
+  if (chunk.length === 0)
+    return;
+  state.buffer += chunk;
+  let boundary;
+  while ((boundary = state.buffer.indexOf(`
+
+`)) !== -1) {
+    const segment = state.buffer.slice(0, boundary).trim();
+    state.buffer = state.buffer.slice(boundary + 2);
+    if (segment.length > 0) {
+      state.segments.push(segment);
+    }
+  }
+}
+
 // src/bridge/bridge-main.ts
 import { createInterface } from "node:readline";
 
+// src/bridge/bridge-env.ts
+function normalizeBridgePermissionMode(value) {
+  return value === "approve-reads" || value === "deny-all" || value === "approve-all" ? value : "approve-all";
+}
+function normalizeBridgeNonInteractivePermissions(value) {
+  return value === "deny" || value === "fail" ? value : "deny";
+}
+
 // src/bridge/bridge-server.ts
 init_prompt_output();
 
+class BridgeInvalidRequestError extends Error {
+}
+var BRIDGE_METHODS = new Set([
+  "ping",
+  "shutdown",
+  "updatePermissionPolicy",
+  "hasSession",
+  "ensureSession",
+  "prompt",
+  "setMode",
+  "cancel"
+]);
+
 class BridgeServer {
   runtime;
   constructor(runtime) {
     this.runtime = runtime;
   }
-  async handleLine(line) {
-    const request = JSON.parse(line);
+  async handleLine(line, writeLine) {
+    let requestId = extractRequestId(line);
     try {
-      const result = await this.dispatch(request.method, request.params);
+      const request = parseBridgeRequest(line);
+      requestId = request.id;
+      const result = await this.dispatch(request.id, request.method, request.params, writeLine);
       return `${JSON.stringify({
         id: request.id,
         ok: true,
@@ -217,10 +308,10 @@ class BridgeServer {
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       return `${JSON.stringify({
-        id: request.id,
+        id: requestId,
         ok: false,
         error: {
-          code: "BRIDGE_INTERNAL_ERROR",
+          code: error instanceof BridgeInvalidRequestError ? "BRIDGE_INVALID_REQUEST" : "BRIDGE_INTERNAL_ERROR",
           message,
           ...error instanceof PromptCommandError ? {
             details: {
@@ -234,54 +325,132 @@ class BridgeServer {
 `;
     }
   }
-  async dispatch(method, params) {
+  async dispatch(requestId, method, params, writeLine) {
     switch (method) {
       case "ping":
         return {};
       case "shutdown":
         return await this.runtime.shutdown();
+      case "updatePermissionPolicy":
+        return await this.runtime.updatePermissionPolicy({
+          permissionMode: requirePermissionMode(params, "permissionMode"),
+          nonInteractivePermissions: requireNonInteractivePermissions(params, "nonInteractivePermissions")
+        });
       case "hasSession":
         return await this.runtime.hasSession({
-          agent: String(params.agent),
+          agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
-          cwd: String(params.cwd),
-          name: String(params.name)
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name")
         });
       case "ensureSession":
         return await this.runtime.ensureSession({
-          agent: String(params.agent),
+          agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
-          cwd: String(params.cwd),
-          name: String(params.name)
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name")
         });
       case "prompt":
         return await this.runtime.prompt({
-          agent: String(params.agent),
+          agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
-          cwd: String(params.cwd),
-          name: String(params.name),
-          text: String(params.text)
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name"),
+          text: requireString(params, "text")
+        }, (event) => {
+          if (event.type === "prompt.segment") {
+            writeLine?.(encodeBridgePromptSegmentEvent({
+              id: requestId,
+              event: "prompt.segment",
+              text: event.text
+            }));
+          }
         });
       case "setMode":
         return await this.runtime.setMode({
-          agent: String(params.agent),
+          agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
-          cwd: String(params.cwd),
-          name: String(params.name),
-          modeId: String(params.modeId)
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name"),
+          modeId: requireString(params, "modeId")
         });
       case "cancel":
         return await this.runtime.cancel({
-          agent: String(params.agent),
+          agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
-          cwd: String(params.cwd),
-          name: String(params.name)
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name")
         });
       default:
         throw new Error(`unsupported bridge method: ${method}`);
     }
   }
 }
+function extractRequestId(line) {
+  try {
+    const raw = JSON.parse(line);
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+      return "unknown";
+    }
+    const id = raw.id;
+    return typeof id === "string" && id.length > 0 ? id : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function parseBridgeRequest(line) {
+  let raw;
+  try {
+    raw = JSON.parse(line);
+  } catch {
+    throw new BridgeInvalidRequestError("request must be valid JSON");
+  }
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new BridgeInvalidRequestError("request must be a JSON object");
+  }
+  const request = raw;
+  const id = request.id;
+  const method = request.method;
+  const params = request.params;
+  if (typeof id !== "string" || id.length === 0) {
+    throw new BridgeInvalidRequestError("id must be a non-empty string");
+  }
+  if (typeof method !== "string" || method.length === 0) {
+    throw new BridgeInvalidRequestError("method must be a non-empty string");
+  }
+  if (!BRIDGE_METHODS.has(method)) {
+    throw new BridgeInvalidRequestError(`unsupported bridge method: ${method}`);
+  }
+  if (!params || typeof params !== "object" || Array.isArray(params)) {
+    throw new BridgeInvalidRequestError("params must be an object");
+  }
+  return {
+    id,
+    method,
+    params
+  };
+}
+function requireString(params, key) {
+  const value = params[key];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new BridgeInvalidRequestError(`${key} must be a non-empty string`);
+  }
+  return value;
+}
+function requirePermissionMode(params, key) {
+  const value = params[key];
+  if (value === "approve-all" || value === "approve-reads" || value === "deny-all") {
+    return value;
+  }
+  throw new BridgeInvalidRequestError(`${key} must be approve-all, approve-reads, or deny-all`);
+}
+function requireNonInteractivePermissions(params, key) {
+  const value = params[key];
+  if (value === "deny" || value === "fail") {
+    return value;
+  }
+  throw new BridgeInvalidRequestError(`${key} must be deny or fail`);
+}
 function asOptionalString(value) {
   if (typeof value !== "string" || value.length === 0) {
     return;
@@ -300,11 +469,18 @@ class BridgeRuntime {
   run;
   runSessionCreate;
   options;
-  constructor(command = "acpx", run = defaultRunner, runSessionCreate = shellSessionCreateRunner, options = {}) {
+  runPromptCommand;
+  constructor(command = "acpx", run = defaultRunner, runSessionCreate = shellSessionCreateRunner, options = {}, runPromptCommand = defaultPromptRunner) {
     this.command = command;
     this.run = run;
     this.runSessionCreate = runSessionCreate;
     this.options = options;
+    this.runPromptCommand = runPromptCommand;
+  }
+  async updatePermissionPolicy(policy) {
+    this.options.permissionMode = policy.permissionMode;
+    this.options.nonInteractivePermissions = policy.nonInteractivePermissions;
+    return {};
   }
   async hasSession(input) {
     const spawnSpec = resolveSpawnCommand(this.command, this.buildSessionArgs(input, [
@@ -338,14 +514,14 @@ class BridgeRuntime {
     }
     return {};
   }
-  async prompt(input) {
+  async prompt(input, onEvent) {
     const spawnSpec = resolveSpawnCommand(this.command, this.buildPromptArgs(input, [
       "prompt",
       "-s",
       input.name,
       input.text
     ]));
-    const result = await this.run(spawnSpec.command, spawnSpec.args);
+    const result = onEvent ? await this.runPromptCommand(spawnSpec.command, spawnSpec.args, onEvent) : await this.run(spawnSpec.command, spawnSpec.args);
     return { text: getPromptText(result) };
   }
   async setMode(input) {
@@ -408,7 +584,7 @@ class BridgeRuntime {
   }
   buildPermissionArgs() {
     const permissionMode = this.options.permissionMode ?? "approve-all";
-    const nonInteractivePermissions = this.options.nonInteractivePermissions ?? "fail";
+    const nonInteractivePermissions = this.options.nonInteractivePermissions ?? "deny";
     const modeFlag = permissionMode === "approve-reads" ? "--approve-reads" : permissionMode === "deny-all" ? "--deny-all" : "--approve-all";
     return [modeFlag, "--non-interactive-permissions", nonInteractivePermissions];
   }
@@ -430,6 +606,62 @@ async function defaultRunner(command, args) {
     });
   });
 }
+async function runStreamingPrompt(command, args, onEvent, options = {}) {
+  const spawnPrompt = options.spawnPrompt ?? ((spawnCommand, spawnArgs) => spawn(spawnCommand, spawnArgs, { stdio: ["ignore", "pipe", "pipe"] }));
+  const setIntervalFn = options.setIntervalFn ?? ((fn, delay) => setInterval(fn, delay));
+  const clearIntervalFn = options.clearIntervalFn ?? ((timer) => clearInterval(timer));
+  const maxSegmentWaitMs = options.maxSegmentWaitMs ?? 30000;
+  const flushCheckIntervalMs = options.flushCheckIntervalMs ?? 5000;
+  const now = options.now ?? (() => Date.now());
+  return await new Promise((resolve, reject) => {
+    const child = spawnPrompt(command, args);
+    let stdout = "";
+    let stderr = "";
+    const state = createStreamingPromptState();
+    let lastReplyAt = now();
+    const flushBuffer = () => {
+      const remaining = state.buffer.trim();
+      if (remaining.length > 0) {
+        state.buffer = "";
+        onEvent?.({ type: "prompt.segment", text: remaining });
+        lastReplyAt = now();
+      }
+    };
+    const timer = setIntervalFn(() => {
+      if (state.buffer.trim().length > 0 && now() - lastReplyAt >= maxSegmentWaitMs) {
+        flushBuffer();
+      }
+    }, flushCheckIntervalMs);
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+      const text = String(chunk);
+      stdout += text;
+      parseStreamingDataChunk(state, text);
+      for (const segment of state.segments.splice(0)) {
+        onEvent?.({ type: "prompt.segment", text: segment });
+        lastReplyAt = now();
+      }
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += String(chunk);
+    });
+    child.on("error", (error) => {
+      clearIntervalFn(timer);
+      reject(error);
+    });
+    child.on("close", (code) => {
+      clearIntervalFn(timer);
+      const remaining = state.finalize();
+      if (remaining.length > 0) {
+        onEvent?.({ type: "prompt.segment", text: remaining });
+      }
+      resolve({ code: code ?? 1, stdout, stderr });
+    });
+  });
+}
+async function defaultPromptRunner(command, args, onEvent) {
+  return await runStreamingPrompt(command, args, onEvent);
+}
 async function shellSessionCreateRunner(command, args, cwd) {
   const helperPath = fileURLToPath(new URL("../../scripts/acpx-session-new-helper.sh", import.meta.url));
   return await new Promise((resolve, reject) => {
@@ -453,14 +685,16 @@ async function shellSessionCreateRunner(command, args, cwd) {
 
 // src/bridge/bridge-main.ts
 var server = new BridgeServer(new BridgeRuntime(process.env.WEACPX_BRIDGE_ACPX_COMMAND ?? "acpx", undefined, undefined, {
-  permissionMode: process.env.WEACPX_BRIDGE_PERMISSION_MODE === "approve-reads" || process.env.WEACPX_BRIDGE_PERMISSION_MODE === "deny-all" ? process.env.WEACPX_BRIDGE_PERMISSION_MODE : "approve-all",
-  nonInteractivePermissions: process.env.WEACPX_BRIDGE_NON_INTERACTIVE_PERMISSIONS === "deny" ? "deny" : "fail"
+  permissionMode: normalizeBridgePermissionMode(process.env.WEACPX_BRIDGE_PERMISSION_MODE),
+  nonInteractivePermissions: normalizeBridgeNonInteractivePermissions(process.env.WEACPX_BRIDGE_NON_INTERACTIVE_PERMISSIONS)
 }));
 var input = createInterface({
   input: process.stdin,
   crlfDelay: Infinity
 });
 for await (const line of input) {
-  const response = await server.handleLine(line);
+  const response = await server.handleLine(line, (chunk) => {
+    process.stdout.write(chunk);
+  });
   process.stdout.write(response);
 }