@keyou007/agent-bot 0.1.0

package/README.md

@@ -0,0 +1,187 @@
+# Agent Bot
+
+Use local Codex and ACP agents directly from Feishu.
+
+English | [简体中文](README.zh.md)
+
+Agent Bot runs on your computer and connects a Feishu bot to your local Codex environment. Send a message to start working; the bot updates a progress card while the agent runs and sends the final answer as Markdown.
+
+## What You Can Do
+
+- Use your existing local Codex login from Feishu
+- Create, continue, switch, fork, and stop tasks
+- Work with text, images, groups, and threads
+- Queue follow-up Prompts or add instructions while a task is running
+- Resume work after Agent Bot restarts
+- Use a local Console UI without Feishu
+
+## Quick Start
+
+### Requirements
+
+- Node.js 22 or later
+- Codex CLI installed and available as `codex`
+- A completed local Codex login
+
+Check the login:
+
+```powershell
+codex login status
+```
+
+### Install
+
+```powershell
+npm install --global @keyou007/agent-bot
+```
+
+This installs the `agent-bot` command globally. See the [technical reference](docs/technical-reference.md#development-and-source-installation) to install from source.
+
+### Initialize
+
+```powershell
+agent-bot init
+```
+
+Follow the displayed link or scan the QR code to create and authorize the Feishu bot. Initialization prepares `~/.agent-bot`, saves the bot credentials, and checks the required permissions.
+
+Missing optional permissions do not block initialization. Agent Bot reports which features may be unavailable.
+
+| Option                 | Purpose                             |
+| ---------------------- | ----------------------------------- |
+| `--skip-feishu`        | Initialize for Console-only use     |
+| `--reconfigure-feishu` | Replace existing Feishu credentials |
+| `--json`               | Print a machine-readable result     |
+| `--config <path>`      | Use a specific configuration file   |
+
+You can rerun `agent-bot init` later to check or complete the bot configuration.
+
+### Start
+
+```powershell
+agent-bot server start
+agent-bot server status
+```
+
+Open Feishu, find the bot, and send a message. Agent Bot automatically creates a task for a chat that does not have one yet.
+
+Stop the service with:
+
+```powershell
+agent-bot server stop
+```
+
+### Update Or Uninstall
+
+Stop the running service before replacing or removing the global package:
+
+```powershell
+agent-bot server stop
+npm install --global @keyou007/agent-bot@latest
+agent-bot server start
+```
+
+To uninstall:
+
+```powershell
+agent-bot server stop
+npm uninstall --global @keyou007/agent-bot
+```
+
+Uninstalling the npm package does not delete your data under `~/.agent-bot`.
+
+## Daily Commands
+
+### Service
+
+```powershell
+agent-bot server status
+agent-bot server start
+agent-bot server stop
+agent-bot server restart
+```
+
+`server restart` waits for current work to finish by default. Use `--immediate` only when interruption is acceptable.
+
+### Console
+
+```powershell
+agent-bot console
+```
+
+The Console UI works without Feishu credentials. It will not share task state with a running server unless `--force` is supplied.
+
+### Tasks
+
+```powershell
+agent-bot task list
+agent-bot task status <task>
+agent-bot task prompt <task> "<prompt>"
+agent-bot task title <task> "<title>"
+agent-bot task stop <task>
+```
+
+`<task>` can be a number from `task list`, a task ID, or an unambiguous task-ID prefix. Run `agent-bot --help` for all CLI options.
+
+## Feishu Commands
+
+Plain text continues the current task. Messages beginning with `/` are commands.
+
+| Command                                  | Purpose                                     |
+| ---------------------------------------- | ------------------------------------------- |
+| `/new [title] [--dir <path> \| --nodir]` | Create a task                               |
+| `/sessions [keyword]`                    | Browse available Codex tasks                |
+| `/switch [task]`                         | Switch tasks or return to the previous task |
+| `/fork [task]`                           | Create and open a task branch               |
+| `/status [task]`                         | View task progress and results              |
+| `/title <title>`                         | Rename the current task                     |
+| `/stop`                                  | Stop the current execution                  |
+| `/queue <prompt>`                        | Queue a separate follow-up Prompt           |
+| `/nosteer <prompt>`                      | Same as `/queue`                            |
+| `/goal [objective]`                      | View or manage a persistent Goal            |
+| `/model [name]`                          | View or change the model                    |
+| `/thinking [level]`                      | View or change reasoning effort             |
+| `/permissions auto\|confirm`             | Change tool approval behavior               |
+| `/newgroup [title]`                      | Create a private group for a new task       |
+| `/forkgroup [title]`                     | Fork the current position into a private group |
+| `/agent [name]`                          | View or change the default agent            |
+| `/use <agent> [cwd]`                     | Select an agent and create a task           |
+| `! <command>`                            | Run a local command in the task directory   |
+| `/restart`                               | Gracefully restart Agent Bot                |
+| `/help`                                  | Show in-chat help                           |
+
+Private chats, group timelines, and threads keep separate current tasks. You can send an image by itself or together with text. While a task is running, plain text adds instructions to the current work; use `/queue` (or `/nosteer`) to always create a later turn.
+
+Inside a thread, `/forkgroup` forks from the thread's original turn until the thread task completes its own turn. After that, it forks from the thread task's latest completed turn. A currently running turn is never used as a fork point.
+
+`/newgroup` immediately creates a new task in the new group. It inherits the current task's project directory, model, reasoning effort, and permission mode without affecting the source task. If there is no current task, Agent Bot uses the selected agent and its runtime defaults. An explicit title becomes both the group suffix and the task title.
+
+When `/newgroup` omits the title, the task title is `新任务` and the default group name is `[agent] [project dir] 新任务 (mm-dd)`. When `/forkgroup` omits the title, its task and group name use the same persistent `source title（分支 N）` sequence as `/fork`, without a date suffix. Feishu group names created by `/newgroup` and `/forkgroup` are capped at 60 displayed characters. When a generated name is too long, Agent Bot truncates only the title portion in the group name; the task title itself stays unchanged.
+
+## Configuration And Data
+
+Agent Bot keeps user-owned files outside the repository:
+
+| Path                       | Purpose                     |
+| -------------------------- | --------------------------- |
+| `~/.agent-bot/config.yaml` | Agent Bot configuration     |
+| `~/.agent-bot/.env`        | Feishu credentials          |
+| `~/.agent-bot/data/`       | Task data and cached inputs |
+| `~/.agent-bot/logs/`       | Runtime logs                |
+
+Set `AGENT_BOT_HOME` to use another user-data directory. See [config.example.yaml](config.example.yaml) for configuration examples.
+
+## Troubleshooting
+
+- **The bot does not respond:** run `agent-bot server status` and check `~/.agent-bot/logs/agent-bot.log`.
+- **Feishu permissions are incomplete:** rerun `agent-bot init` and follow the displayed authorization steps.
+- **Codex cannot start:** run `codex login status` as the same operating-system user that runs Agent Bot.
+- **You only need local testing:** run `agent-bot init --skip-feishu`, then `agent-bot console`.
+- **A safe restart keeps waiting:** inspect active tasks with `agent-bot task list --status running`.
+
+## More Documentation
+
+- [Technical Reference](docs/technical-reference.md): configuration, permissions, routing, persistence, recovery, and runtime behavior
+- [Example Configuration](config.example.yaml)
+- [Changelog](CHANGELOG.md)
+- [Agent Development Guide](https://github.com/keyou/agent-bot/blob/master/AGENTS.md)

package/README.zh.md

@@ -0,0 +1,187 @@
+# Agent Bot
+
+通过飞书使用本机上的 Codex 和 ACP Agent。
+
+[English](README.md) | 简体中文
+
+Agent Bot 运行在你的电脑上，把飞书机器人连接到本机 Codex 环境。发送消息即可开始工作；执行过程中机器人会更新进度卡，完成后发送 Markdown 最终回答。
+
+## 可以做什么
+
+- 在飞书中使用本机已有的 Codex 登录
+- 创建、继续、切换、分支和停止任务
+- 使用文字、图片、群聊和话题协作
+- 排队后续 Prompt，或在任务运行中追加指令
+- Agent Bot 重启后继续已有工作
+- 不使用飞书时通过本地 Console UI 运行
+
+## 快速开始
+
+### 使用前提
+
+- Node.js 22 或更高版本
+- 已安装 Codex CLI，并可直接执行 `codex`
+- 已完成本机 Codex 登录
+
+确认登录状态：
+
+```powershell
+codex login status
+```
+
+### 安装
+
+```powershell
+npm install --global @keyou007/agent-bot
+```
+
+该命令会全局安装 `agent-bot`。从源码安装的方法见[技术参考](docs/technical-reference.zh.md#开发与源码安装)。
+
+### 初始化
+
+```powershell
+agent-bot init
+```
+
+打开命令显示的链接或扫描二维码，完成飞书机器人创建和授权。初始化会准备 `~/.agent-bot`、保存机器人凭据并检查所需权限。
+
+非核心权限缺失不会阻塞初始化，Agent Bot 会提示可能无法使用的功能。
+
+| 参数                   | 作用                      |
+| ---------------------- | ------------------------- |
+| `--skip-feishu`        | 仅初始化 Console 使用环境 |
+| `--reconfigure-feishu` | 替换已有飞书凭据          |
+| `--json`               | 输出便于程序读取的结果    |
+| `--config <路径>`      | 使用指定配置文件          |
+
+之后可以重新运行 `agent-bot init` 检查或补齐机器人配置。
+
+### 启动
+
+```powershell
+agent-bot server start
+agent-bot server status
+```
+
+打开飞书，找到机器人并发送消息。当前会话没有任务时，Agent Bot 会自动创建。
+
+停止服务：
+
+```powershell
+agent-bot server stop
+```
+
+### 更新或卸载
+
+替换或移除全局包前，先停止正在运行的服务：
+
+```powershell
+agent-bot server stop
+npm install --global @keyou007/agent-bot@latest
+agent-bot server start
+```
+
+卸载：
+
+```powershell
+agent-bot server stop
+npm uninstall --global @keyou007/agent-bot
+```
+
+卸载 npm 包不会删除 `~/.agent-bot` 中的用户数据。
+
+## 日常命令
+
+### 服务管理
+
+```powershell
+agent-bot server status
+agent-bot server start
+agent-bot server stop
+agent-bot server restart
+```
+
+`server restart` 默认等待当前工作完成后再重启。只有可接受中断时才使用 `--immediate`。
+
+### Console
+
+```powershell
+agent-bot console
+```
+
+Console UI 不需要飞书凭据。除非传入 `--force`，否则不会与正在运行的 Server 共享任务状态。
+
+### 任务管理
+
+```powershell
+agent-bot task list
+agent-bot task status <任务>
+agent-bot task prompt <任务> "<prompt>"
+agent-bot task title <任务> "<标题>"
+agent-bot task stop <任务>
+```
+
+`<任务>` 可以是 `task list` 中的序号、任务 ID 或唯一的任务 ID 前缀。运行 `agent-bot --help` 可查看完整 CLI 参数。
+
+## 飞书命令
+
+普通文本会继续当前任务，以 `/` 开头的消息会作为命令处理。
+
+| 命令                                    | 作用                       |
+| --------------------------------------- | -------------------------- |
+| `/new [标题] [--dir <路径> \| --nodir]` | 创建任务                   |
+| `/sessions [关键词]`                    | 浏览可用的 Codex 任务      |
+| `/switch [任务]`                        | 切换任务，或返回上一个任务 |
+| `/fork [任务]`                          | 创建并打开任务分支         |
+| `/status [任务]`                        | 查看任务进度和结果         |
+| `/title <标题>`                         | 修改当前任务标题           |
+| `/stop`                                 | 停止当前执行               |
+| `/queue <prompt>`                       | 排队一个独立的后续 Prompt  |
+| `/nosteer <prompt>`                     | 与 `/queue` 相同           |
+| `/goal [目标]`                          | 查看或管理持久 Goal        |
+| `/model [名称]`                         | 查看或切换模型             |
+| `/thinking [级别]`                      | 查看或切换思考强度         |
+| `/permissions auto\|confirm`            | 修改工具授权方式           |
+| `/newgroup [标题]`                      | 为新任务创建私有群         |
+| `/forkgroup [标题]`                     | 将当前位置分支到私有群     |
+| `/agent [名称]`                         | 查看或切换默认 Agent       |
+| `/use <agent> [cwd]`                    | 选择 Agent 并创建任务      |
+| `! <命令>`                              | 在任务目录执行本地命令     |
+| `/restart`                              | 优雅重启 Agent Bot         |
+| `/help`                                 | 显示聊天内帮助             |
+
+私聊、群正文和话题分别维护当前任务。可以单独发送图片，也可以同时发送文字和图片。任务运行中发送普通文字会追加指令；需要确保形成后续 turn 时使用 `/queue`（或 `/nosteer`）。
+
+在话题中使用 `/forkgroup` 时，如果话题任务还没有完成过自己的 turn，则从话题原始 turn fork；完成过后则从话题任务最近完成的 turn fork。正在执行的 turn 不会作为 fork 点。
+
+`/newgroup` 会立即在新群中创建并绑定一个新任务。新任务继承当前任务的项目目录、模型、思考强度和权限模式，不影响来源任务；来源聊天没有当前任务时，则使用选定 Agent 及其运行时默认设置。显式标题会同时作为群名后缀和任务标题。
+
+`/newgroup` 省略标题时，任务标题为 `新任务`，默认群名为 `[agent] [project dir] 新任务 (mm-dd)`。`/forkgroup` 省略标题时，任务标题和群名都与 `/fork` 一样使用持久递增的 `源标题（分支 N）`，不追加日期。`/newgroup` 和 `/forkgroup` 创建的飞书群名最多显示 60 个字符。生成后的群名过长时，Agent Bot 只截断群名中的标题部分，任务标题本身保持不变。
+
+## 配置与数据
+
+Agent Bot 将用户相关文件保存在仓库之外：
+
+| 路径                       | 用途               |
+| -------------------------- | ------------------ |
+| `~/.agent-bot/config.yaml` | Agent Bot 配置     |
+| `~/.agent-bot/.env`        | 飞书凭据           |
+| `~/.agent-bot/data/`       | 任务数据和输入缓存 |
+| `~/.agent-bot/logs/`       | 运行日志           |
+
+可通过 `AGENT_BOT_HOME` 修改用户数据目录。配置示例见 [config.example.yaml](config.example.yaml)。
+
+## 常见问题
+
+- **机器人没有响应：** 运行 `agent-bot server status`，并查看 `~/.agent-bot/logs/agent-bot.log`
+- **飞书权限不完整：** 重新运行 `agent-bot init`，完成显示的授权步骤
+- **Codex 无法启动：** 使用运行 Agent Bot 的同一操作系统用户执行 `codex login status`
+- **只需要本地测试：** 运行 `agent-bot init --skip-feishu`，然后执行 `agent-bot console`
+- **安全重启一直等待：** 使用 `agent-bot task list --status running` 检查活动任务
+
+## 更多文档
+
+- [技术参考](docs/technical-reference.zh.md)：配置、权限、路由、持久化、恢复和运行机制
+- [配置示例](config.example.yaml)
+- [更新日志](CHANGELOG.md)
+- [Agent 开发指南](https://github.com/keyou/agent-bot/blob/master/AGENTS.md)

package/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+Security fixes are released for the latest published version of Agent Bot.
+
+## Reporting A Vulnerability
+
+Do not open a public issue for a suspected vulnerability.
+
+Report it through [GitHub private vulnerability reporting](https://github.com/keyou/agent-bot/security/advisories/new). Include the affected version, reproduction steps, impact, and any suggested mitigation.
+
+The project will acknowledge the report, investigate it, and coordinate disclosure and a fixed release when appropriate.

package/config.example.yaml

@@ -0,0 +1,56 @@
+feishu:
+  transport: "auto"
+  appId: "${FEISHU_APP_ID}"
+  appSecret: "${FEISHU_APP_SECRET}"
+  useConsoleWhenMissingCredentials: true
+
+console:
+  enabled: true
+
+agents:
+  codex:
+    kind: "codex"
+    title: "Codex"
+    command: "codex"
+    args:
+      - "app-server"
+      - "--enable"
+      - "goals"
+      - "--listen"
+      - "stdio://"
+    env: {}
+
+  coco:
+    title: "Coco"
+    command: "coco"
+    args:
+      - "acp"
+      - "serve"
+    env: {}
+
+  coco-yolo:
+    title: "Coco YOLO"
+    command: "coco"
+    args:
+      - "acp"
+      - "serve"
+      - "--yolo"
+    env: {}
+
+  example:
+    title: "Example ACP Agent"
+    command: "node"
+    args:
+      - "./examples/example-acp-agent.js"
+    env: {}
+
+defaults:
+  agent: "codex"
+  cwd: "."
+
+storage:
+  sqlitePath: "./data/agent-bot.sqlite"
+
+logging:
+  level: "info"
+  path: "./logs/agent-bot.log"

package/dist/acp/AcpJsonRpcConnection.js

@@ -0,0 +1,155 @@
+import { EventEmitter } from "node:events";
+import readline from "node:readline";
+import { isJsonRpcNotification, isJsonRpcRequest, isJsonRpcResponse, } from "./acpTypes.js";
+export class AcpJsonRpcConnection extends EventEmitter {
+    process;
+    logger;
+    nextId = 1;
+    pending = new Map();
+    handlers = new Map();
+    closed = false;
+    constructor(process, logger) {
+        super();
+        this.process = process;
+        this.logger = logger;
+        this.bindOutput();
+    }
+    on(eventName, listener) {
+        return super.on(eventName, listener);
+    }
+    registerHandler(method, handler) {
+        this.handlers.set(method, handler);
+    }
+    async request(method, params, timeoutMs = 0) {
+        if (this.closed) {
+            throw new Error(`Cannot send ACP request after connection closed: ${method}`);
+        }
+        const id = this.nextId++;
+        const responsePromise = new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject, method });
+        });
+        this.write({
+            jsonrpc: "2.0",
+            id,
+            method,
+            params,
+        });
+        if (timeoutMs <= 0) {
+            return (await responsePromise);
+        }
+        return (await Promise.race([
+            responsePromise,
+            new Promise((_resolve, reject) => {
+                setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new Error(`ACP request timed out: ${method}`));
+                }, timeoutMs);
+            }),
+        ]));
+    }
+    notify(method, params) {
+        if (this.closed) {
+            return;
+        }
+        this.write({
+            jsonrpc: "2.0",
+            method,
+            params,
+        });
+    }
+    close() {
+        this.closed = true;
+        for (const pending of this.pending.values()) {
+            pending.reject(new Error("ACP connection closed."));
+        }
+        this.pending.clear();
+        this.emit("close");
+    }
+    bindOutput() {
+        const reader = readline.createInterface({
+            input: this.process.stdout,
+            crlfDelay: Infinity,
+        });
+        reader.on("line", (line) => {
+            if (!line.trim()) {
+                return;
+            }
+            this.handleLine(line);
+        });
+        this.process.once("close", () => this.close());
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch (error) {
+            this.logger.warn({ line, error }, "Ignoring non-JSON ACP stdout line.");
+            return;
+        }
+        if (isJsonRpcResponse(message)) {
+            this.handleResponse(message);
+            return;
+        }
+        if (isJsonRpcRequest(message)) {
+            void this.handleRequest(message.id, message.method, message.params);
+            return;
+        }
+        if (isJsonRpcNotification(message)) {
+            this.emit("notification", message.method, message.params);
+            return;
+        }
+        this.logger.warn({ message }, "Ignoring unknown ACP message shape.");
+    }
+    handleResponse(message) {
+        const pending = this.pending.get(message.id);
+        if (!pending) {
+            this.logger.warn({ message }, "Received ACP response for unknown request.");
+            return;
+        }
+        this.pending.delete(message.id);
+        if ("error" in message) {
+            pending.reject(new Error(`${pending.method} failed: ${message.error.message}`));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    async handleRequest(id, method, params) {
+        this.emit("request", method, params);
+        const handler = this.handlers.get(method);
+        if (!handler) {
+            this.write({
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: -32601,
+                    message: `Client method is not implemented by Agent Bot: ${method}`,
+                },
+            });
+            return;
+        }
+        try {
+            const result = await handler(params);
+            this.write({
+                jsonrpc: "2.0",
+                id,
+                result,
+            });
+        }
+        catch (error) {
+            this.write({
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: -32000,
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    write(message) {
+        const serialized = JSON.stringify(message);
+        this.process.stdin.write(`${serialized}\n`, "utf8");
+    }
+}
+//# sourceMappingURL=AcpJsonRpcConnection.js.map

package/dist/acp/AcpJsonRpcConnection.js.map

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

package/dist/acp/AcpProcessManager.js

@@ -0,0 +1,65 @@
+import readline from "node:readline";
+import { AcpJsonRpcConnection } from "./AcpJsonRpcConnection.js";
+import { agentBotEnvironment } from "../runtime/agentEnvironment.js";
+import { spawnStdioCommand } from "../utils/spawnCommand.js";
+export class AcpProcessManager {
+    logger;
+    processes = new Map();
+    constructor(logger) {
+        this.logger = logger;
+    }
+    start(processKey, agentName, agent) {
+        if (this.processes.has(processKey)) {
+            throw new Error(`ACP process already exists: ${processKey}`);
+        }
+        const child = spawnStdioCommand(agent.command, agent.args, agentBotEnvironment(process.env, agent.env));
+        const childLogger = this.logger.child({ processKey, agentName });
+        const connection = new AcpJsonRpcConnection(child, childLogger);
+        const managed = {
+            processKey,
+            child,
+            connection,
+            stop: () => this.stop(processKey),
+        };
+        this.processes.set(processKey, managed);
+        this.bindLifecycle(managed, childLogger);
+        childLogger.info({ command: agent.command, args: agent.args }, "Started ACP agent process.");
+        return managed;
+    }
+    get(processKey) {
+        return this.processes.get(processKey);
+    }
+    stop(processKey) {
+        const managed = this.processes.get(processKey);
+        if (!managed) {
+            return;
+        }
+        this.processes.delete(processKey);
+        managed.connection.close();
+        if (!managed.child.killed) {
+            managed.child.kill();
+        }
+    }
+    stopAll() {
+        for (const processKey of this.processes.keys()) {
+            this.stop(processKey);
+        }
+    }
+    bindLifecycle(managed, logger) {
+        const stderr = readline.createInterface({
+            input: managed.child.stderr,
+            crlfDelay: Infinity,
+        });
+        stderr.on("line", (line) => {
+            logger.debug({ stderr: line }, "ACP agent stderr.");
+        });
+        managed.child.once("error", (error) => {
+            logger.error({ error }, "ACP agent process error.");
+        });
+        managed.child.once("exit", (code, signal) => {
+            this.processes.delete(managed.processKey);
+            logger.info({ code, signal }, "ACP agent process exited.");
+        });
+    }
+}
+//# sourceMappingURL=AcpProcessManager.js.map

package/dist/acp/AcpProcessManager.js.map

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