wechat-acp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jun Han
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# WeChat ACP
+
+Bridge WeChat direct messages to any ACP-compatible AI agent.
+
+`wechat-acp` logs in with the WeChat iLink bot API, polls incoming 1:1 messages, forwards them to an ACP agent over stdio, and sends the agent reply back to WeChat.
+
+<img src="./resources/screenshot.jpg" alt="wechat-acp screenshot" width="400" />
+
+## Features
+
+- WeChat QR login with terminal QR rendering
+- One ACP agent session per WeChat user
+- Built-in ACP agent presets for common CLIs
+- Custom raw agent command support
+- Auto-allow permission requests from the agent
+- Direct message only; group chats are ignored
+- Background daemon mode
+
+## Requirements
+
+- Node.js 20+
+- A WeChat environment that can use the iLink bot API
+- An ACP-compatible agent available locally or through `npx`
+
+## Quick Start
+
+Start with a built-in agent preset:
+
+```bash
+npx wechat-acp --agent copilot
+```
+
+Or use a raw custom command:
+
+```bash
+npx wechat-acp --agent "npx my-agent --acp"
+```
+
+On first run, the bridge will:
+
+1. Start WeChat QR login
+2. Render a QR code in the terminal
+3. Save the login token under `~/.wechat-acp`
+4. Begin polling direct messages
+
+## Built-in Agent Presets
+
+List the bundled presets:
+
+```bash
+npx wechat-acp agents
+```
+
+Current presets:
+
+- `copilot`
+- `claude`
+- `gemini`
+- `qwen`
+- `codex`
+- `opencode`
+
+These presets resolve to concrete `command + args` pairs internally, so users do not need to type long `npx ...` commands.
+
+## CLI Usage
+
+```text
+wechat-acp --agent <preset|command> [options]
+wechat-acp agents
+wechat-acp stop
+wechat-acp status
+```
+
+Options:
+
+- `--agent <value>`: built-in preset name or raw agent command
+- `--cwd <dir>`: working directory for the agent process
+- `--login`: force QR re-login and replace the saved token
+- `--daemon`: run in background after startup
+- `--config <file>`: load JSON config file
+- `--idle-timeout <minutes>`: session idle timeout, default `30`
+- `--max-sessions <count>`: maximum concurrent user sessions, default `10`
+- `-h, --help`: show help
+
+Examples:
+
+```bash
+npx wechat-acp --agent copilot
+npx wechat-acp --agent claude --cwd D:\code\project
+npx wechat-acp --agent "npx @github/copilot --acp"
+npx wechat-acp --agent gemini --daemon
+```
+
+## Configuration File
+
+You can provide a JSON config file with `--config`.
+
+Example:
+
+```json
+{
+  "agent": {
+    "preset": "copilot",
+    "cwd": "D:/code/project"
+  },
+  "session": {
+    "idleTimeoutMs": 1800000,
+    "maxConcurrentUsers": 10
+  }
+}
+```
+
+You can also override or add agent presets:
+
+```json
+{
+  "agent": {
+    "preset": "my-agent"
+  },
+  "agents": {
+    "my-agent": {
+      "label": "My Agent",
+      "description": "Internal team agent",
+      "command": "npx",
+      "args": ["my-agent-cli", "--acp"]
+    }
+  }
+}
+```
+
+## Runtime Behavior
+
+- Each WeChat user gets a dedicated ACP session and subprocess.
+- Messages are processed serially per user.
+- Replies are formatted for WeChat before sending.
+- Typing indicators are sent when supported by the WeChat API.
+- Sessions are cleaned up after inactivity.
+
+## Storage
+
+By default, runtime files are stored under:
+
+```text
+~/.wechat-acp
+```
+
+This directory is used for:
+
+- saved login token
+- daemon pid file
+- daemon log file
+- sync state
+
+## Current Limitations
+
+- Direct messages only; group chats are ignored
+- MCP servers are not used
+- Permission requests are auto-approved
+- Agent communication is subprocess-only over stdio
+- Some preset agents may require separate authentication before they can respond successfully
+
+## Development
+
+For local development:
+
+```bash
+npm install
+npm run build
+```
+
+Run the built CLI locally:
+
+```bash
+node dist/bin/wechat-acp.js --help
+```
+
+Watch mode:
+
+```bash
+npm run dev
+```
+
+## License
+
+MIT

package/dist/bin/wechat-acp.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * wechat-acp CLI entry point.
+ *
+ * Usage:
+ *   wechat-acp --agent "claude code"
+ *   wechat-acp --agent "gemini" --cwd /path/to/project
+ *   wechat-acp --agent "npx tsx ./agent.ts" --login
+ *   wechat-acp --agent "claude code" --daemon
+ *   wechat-acp stop
+ *   wechat-acp status
+ */
+export {};
+//# sourceMappingURL=wechat-acp.d.ts.map

package/dist/bin/wechat-acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-acp.d.ts","sourceRoot":"","sources":["../../bin/wechat-acp.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/bin/wechat-acp.js

@@ -0,0 +1,270 @@
+#!/usr/bin/env node
+/**
+ * wechat-acp CLI entry point.
+ *
+ * Usage:
+ *   wechat-acp --agent "claude code"
+ *   wechat-acp --agent "gemini" --cwd /path/to/project
+ *   wechat-acp --agent "npx tsx ./agent.ts" --login
+ *   wechat-acp --agent "claude code" --daemon
+ *   wechat-acp stop
+ *   wechat-acp status
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import qrcodeTerminal from "qrcode-terminal";
+import { WeChatAcpBridge } from "../src/bridge.js";
+import { defaultConfig, listBuiltInAgents, resolveAgentSelection, } from "../src/config.js";
+function usage() {
+    const presets = listBuiltInAgents()
+        .map(({ id }) => id)
+        .join(", ");
+    console.log(`
+wechat-acp — Bridge WeChat to any ACP-compatible AI agent
+
+Usage:
+  wechat-acp --agent <preset|command>  [options]
+  wechat-acp agents                        List built-in agent presets
+  wechat-acp stop                          Stop a running daemon
+  wechat-acp status                        Check daemon status
+
+Options:
+  --agent <value>     Built-in preset name or raw agent command
+                      Presets: ${presets}
+                      Examples: "copilot", "claude", "npx tsx ./agent.ts"
+  --cwd <dir>         Working directory for agent (default: current dir)
+  --login             Force re-login (new QR code)
+  --daemon            Run in background after login
+  --config <file>     Config file path (JSON)
+  --idle-timeout <m>  Session idle timeout in minutes (default: 30)
+  --max-sessions <n>  Max concurrent user sessions (default: 10)
+  -v, --verbose       Verbose logging
+  -h, --help          Show this help
+`);
+}
+function parseArgs(argv) {
+    const result = {
+        forceLogin: false,
+        daemon: false,
+        verbose: false,
+        help: false,
+    };
+    const args = argv.slice(2);
+    let i = 0;
+    // Check for subcommand
+    if (args[0] && !args[0].startsWith("-")) {
+        result.command = args[0];
+        i = 1;
+    }
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case "--agent":
+                result.agent = args[++i];
+                break;
+            case "--cwd":
+                result.cwd = args[++i];
+                break;
+            case "--login":
+                result.forceLogin = true;
+                break;
+            case "--daemon":
+                result.daemon = true;
+                break;
+            case "--config":
+                result.configFile = args[++i];
+                break;
+            case "--idle-timeout":
+                result.idleTimeout = parseInt(args[++i], 10);
+                break;
+            case "--max-sessions":
+                result.maxSessions = parseInt(args[++i], 10);
+                break;
+            case "-v":
+            case "--verbose":
+                result.verbose = true;
+                break;
+            case "-h":
+            case "--help":
+                result.help = true;
+                break;
+            default:
+                if (arg?.startsWith("-")) {
+                    console.error(`Unknown option: ${arg}`);
+                    process.exit(1);
+                }
+        }
+        i++;
+    }
+    return result;
+}
+function loadConfigFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+function handleAgents(config) {
+    console.log("Built-in ACP agent presets:\n");
+    for (const { id, preset } of listBuiltInAgents(config.agents)) {
+        const commandLine = [preset.command, ...preset.args].join(" ");
+        console.log(`${id.padEnd(10)} ${commandLine}`);
+        if (preset.description) {
+            console.log(`           ${preset.description}`);
+        }
+    }
+}
+function handleStop(config) {
+    const pidFile = config.daemon.pidFile;
+    if (!fs.existsSync(pidFile)) {
+        console.log("No daemon running (no PID file found)");
+        return;
+    }
+    const pid = parseInt(fs.readFileSync(pidFile, "utf-8").trim(), 10);
+    try {
+        process.kill(pid, "SIGTERM");
+        fs.unlinkSync(pidFile);
+        console.log(`Stopped daemon (PID ${pid})`);
+    }
+    catch (err) {
+        if (err.code === "ESRCH") {
+            fs.unlinkSync(pidFile);
+            console.log(`Daemon not running (stale PID ${pid}), cleaned up`);
+        }
+        else {
+            console.error(`Failed to stop daemon: ${String(err)}`);
+        }
+    }
+}
+function handleStatus(config) {
+    const pidFile = config.daemon.pidFile;
+    if (!fs.existsSync(pidFile)) {
+        console.log("Not running");
+        return;
+    }
+    const pid = parseInt(fs.readFileSync(pidFile, "utf-8").trim(), 10);
+    try {
+        process.kill(pid, 0); // test if process exists
+        console.log(`Running (PID ${pid})`);
+    }
+    catch {
+        console.log(`Not running (stale PID ${pid})`);
+        fs.unlinkSync(pidFile);
+    }
+}
+function daemonize(config) {
+    const logFile = config.daemon.logFile;
+    const pidFile = config.daemon.pidFile;
+    fs.mkdirSync(path.dirname(logFile), { recursive: true });
+    fs.mkdirSync(path.dirname(pidFile), { recursive: true });
+    const out = fs.openSync(logFile, "a");
+    const err = fs.openSync(logFile, "a");
+    // Re-run ourselves with --no-daemon (internal flag) as a detached process
+    const args = process.argv.slice(1).filter((a) => a !== "--daemon");
+    const child = spawn(process.execPath, args, {
+        detached: true,
+        stdio: ["ignore", out, err],
+        env: { ...process.env, WECHAT_ACP_DAEMON: "1" },
+    });
+    child.unref();
+    fs.writeFileSync(pidFile, String(child.pid), "utf-8");
+    console.log(`Daemon started (PID ${child.pid})`);
+    console.log(`Logs: ${logFile}`);
+    console.log(`PID file: ${pidFile}`);
+    process.exit(0);
+}
+function renderQrInTerminal(url) {
+    qrcodeTerminal.generate(url, { small: true }, (qr) => {
+        console.log(qr);
+    });
+}
+async function main() {
+    const args = parseArgs(process.argv);
+    if (args.help) {
+        usage();
+        process.exit(0);
+    }
+    const config = defaultConfig();
+    // Load config file if specified
+    if (args.configFile) {
+        const fileConfig = loadConfigFile(args.configFile);
+        Object.assign(config.wechat, fileConfig.wechat ?? {});
+        Object.assign(config.agent, fileConfig.agent ?? {});
+        Object.assign(config.agents, fileConfig.agents ?? {});
+        Object.assign(config.session, fileConfig.session ?? {});
+        Object.assign(config.daemon, fileConfig.daemon ?? {});
+        Object.assign(config.storage, fileConfig.storage ?? {});
+    }
+    // Handle subcommands
+    if (args.command === "agents") {
+        handleAgents(config);
+        return;
+    }
+    if (args.command === "stop") {
+        handleStop(config);
+        return;
+    }
+    if (args.command === "status") {
+        handleStatus(config);
+        return;
+    }
+    const agentSelection = args.agent ?? config.agent.preset;
+    // Require preset or raw command
+    if (!agentSelection && !config.agent.command) {
+        console.error("Error: --agent is required\n");
+        usage();
+        process.exit(1);
+    }
+    if (agentSelection) {
+        const resolvedAgent = resolveAgentSelection(agentSelection, config.agents);
+        config.agent.preset = resolvedAgent.id;
+        config.agent.command = resolvedAgent.command;
+        config.agent.args = resolvedAgent.args;
+        if (resolvedAgent.env) {
+            config.agent.env = { ...(config.agent.env ?? {}), ...resolvedAgent.env };
+        }
+    }
+    if (args.cwd)
+        config.agent.cwd = path.resolve(args.cwd);
+    if (args.idleTimeout)
+        config.session.idleTimeoutMs = args.idleTimeout * 60_000;
+    if (args.maxSessions)
+        config.session.maxConcurrentUsers = args.maxSessions;
+    config.daemon.enabled = args.daemon;
+    // Handle daemon mode
+    if (args.daemon && !process.env.WECHAT_ACP_DAEMON) {
+        daemonize(config);
+        return;
+    }
+    // Create and start bridge
+    const bridge = new WeChatAcpBridge(config, (msg) => {
+        const ts = new Date().toISOString().substring(11, 19);
+        console.log(`[${ts}] ${msg}`);
+    });
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        await bridge.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+    try {
+        await bridge.start({
+            forceLogin: args.forceLogin,
+            renderQrUrl: renderQrInTerminal,
+        });
+    }
+    catch (err) {
+        if (err.message === "aborted") {
+            // Normal shutdown
+        }
+        else {
+            console.error(`Fatal: ${String(err)}`);
+            process.exit(1);
+        }
+    }
+}
+main().catch((err) => {
+    console.error(`Fatal: ${String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=wechat-acp.js.map

package/dist/bin/wechat-acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-acp.js","sourceRoot":"","sources":["../../bin/wechat-acp.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "wechat-acp",
+    "version": "0.1.0",
+    "description": "Bridge WeChat to any ACP-compatible AI agent",
+    "type": "module",
+    "files": [
+        "dist/",
+        "README.md",
+        "package.json"
+    ],
+    "bin": {
+        "wechat-acp": "./dist/bin/wechat-acp.js"
+    },
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/src/index.js",
+            "types": "./dist/src/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsc",
+        "prepack": "npm run build",
+        "start": "node dist/bin/wechat-acp.js",
+        "dev": "tsc --watch"
+    },
+    "dependencies": {
+        "@agentclientprotocol/sdk": "^0.16.1",
+        "qrcode-terminal": "^0.12.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "^5.5.0"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/formulahendry/wechat-acp.git"
+    },
+    "homepage": "https://github.com/formulahendry/wechat-acp#readme",
+    "bugs": {
+        "url": "https://github.com/formulahendry/wechat-acp/issues"
+    },
+    "license": "MIT",
+    "keywords": [
+        "wechat",
+        "acp",
+        "agent-client-protocol",
+        "ai-agent",
+        "bridge"
+    ]
+}

package/dist/src/acp/agent-manager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Spawn and manage ACP agent subprocesses.
+ */
+import { type ChildProcess } from "node:child_process";
+import * as acp from "@agentclientprotocol/sdk";
+import type { WeChatAcpClient } from "./client.js";
+export interface AgentProcessInfo {
+    process: ChildProcess;
+    connection: acp.ClientSideConnection;
+    sessionId: string;
+}
+export declare function spawnAgent(params: {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+    client: WeChatAcpClient;
+    log: (msg: string) => void;
+}): Promise<AgentProcessInfo>;
+export declare function killAgent(proc: ChildProcess): void;
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/src/acp/agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.d.ts","sourceRoot":"","sources":["../../../src/acp/agent-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,GAAG,CAAC,oBAAoB,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiE5B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAQlD"}

package/dist/src/acp/agent-manager.js

@@ -0,0 +1,73 @@
+/**
+ * Spawn and manage ACP agent subprocesses.
+ */
+import { spawn } from "node:child_process";
+import { Writable, Readable } from "node:stream";
+import * as acp from "@agentclientprotocol/sdk";
+import packageJson from "../../package.json" with { type: "json" };
+export async function spawnAgent(params) {
+    const { command, args, cwd, env, client, log } = params;
+    // On Windows, shell mode avoids EINVAL/ENOENT for command shims like npx/claude/gemini.
+    const useShell = process.platform === "win32";
+    log(`Spawning agent: ${command} ${args.join(" ")} (cwd: ${cwd}, shell=${useShell})`);
+    const proc = spawn(command, args, {
+        stdio: ["pipe", "pipe", "inherit"],
+        cwd,
+        env: { ...process.env, ...env },
+        shell: useShell,
+    });
+    proc.on("error", (err) => {
+        log(`Agent process error: ${String(err)}`);
+    });
+    proc.on("exit", (code, signal) => {
+        log(`Agent process exited: code=${code} signal=${signal}`);
+    });
+    if (!proc.stdin || !proc.stdout) {
+        proc.kill();
+        throw new Error("Failed to get agent process stdio");
+    }
+    const input = Writable.toWeb(proc.stdin);
+    const output = Readable.toWeb(proc.stdout);
+    const stream = acp.ndJsonStream(input, output);
+    const connection = new acp.ClientSideConnection(() => client, stream);
+    // Initialize
+    log("Initializing ACP connection...");
+    const initResult = await connection.initialize({
+        protocolVersion: acp.PROTOCOL_VERSION,
+        clientInfo: {
+            name: packageJson.name,
+            title: packageJson.name,
+            version: packageJson.version,
+        },
+        clientCapabilities: {
+            fs: {
+                readTextFile: true,
+                writeTextFile: true,
+            },
+        },
+    });
+    log(`ACP initialized (protocol v${initResult.protocolVersion})`);
+    // Create session
+    log("Creating ACP session...");
+    const sessionResult = await connection.newSession({
+        cwd,
+        mcpServers: [],
+    });
+    log(`ACP session created: ${sessionResult.sessionId}`);
+    return {
+        process: proc,
+        connection,
+        sessionId: sessionResult.sessionId,
+    };
+}
+export function killAgent(proc) {
+    if (!proc.killed) {
+        proc.kill("SIGTERM");
+        // Force kill after 5s if still alive
+        setTimeout(() => {
+            if (!proc.killed)
+                proc.kill("SIGKILL");
+        }, 5_000).unref();
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/src/acp/agent-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.js","sourceRoot":"","sources":["../../../src/acp/agent-manager.ts"],"names":[],"mappings":"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"}