agents-bridge 0.1.0 → 0.1.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-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.
+MIT License
+
+Copyright (c) 2026
+
+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

@@ -1,77 +1,76 @@
-# agents-bridge
+# agents-bridge
 
-本地 Agent 网关，部署在客户本地机器上，通过长轮询连接云端 botlink 平台，驱动本地的 Claude Code / Codex 等 AI Agent。
+鏈湴 Agent 缃戝叧锛岄儴缃插湪瀹㈡埛鏈湴鏈哄櫒涓婏紝閫氳繃闀胯疆璇㈣繛鎺ヤ簯绔?botlink 骞冲彴锛岄┍鍔ㄦ湰鍦扮殑 Claude Code / Codex 绛?AI Agent銆?
 
-## 架构概览
+## 鏋舵瀯姒傝
 
 ```
-botlink 云端                             客户本地
-┌──────────────────────┐        ┌──────────────────────────┐
-│  botlink-web         │        │  agents-bridge           │
-│  client-gateway      │        │                          │
-│  bot-gateway ◄───────┼── HTTP │  botlink channel         │
-│  message-svc         │  长轮询│    ↕                     │
-│  routing-svc         │        │  Agent Runtime           │
-└──────────────────────┘        │    ├─ Claude Code (CLI)  │
-                                │    ├─ Codex (CLI)        │
-                                │    └─ Pi Agent (API)     │
-                                └──────────────────────────┘
+botlink 浜戠                             瀹㈡埛鏈湴
+鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?       鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
+鈹? botlink-web         鈹?       鈹? agents-bridge           鈹?
+鈹? client-gateway      鈹?       鈹?                         鈹?
+鈹? bot-gateway 鈼勨攢鈹€鈹€鈹€鈹€鈹€鈹€鈹尖攢鈹€ HTTP 鈹? botlink channel         鈹?
+鈹? message-svc         鈹? 闀胯疆璇⑩攤    鈫?                    鈹?
+鈹? routing-svc         鈹?       鈹? Agent Runtime           鈹?
+鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?       鈹?   鈹溾攢 Claude Code (CLI)  鈹?
+                                鈹?   鈹溾攢 Codex (CLI)        鈹?
+                                鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
 ```
 
-agents-bridge 始终作为客户端主动外连云端，客户无需暴露任何端口。
+agents-bridge 濮嬬粓浣滀负瀹㈡埛绔富鍔ㄥ杩炰簯绔紝瀹㈡埛鏃犻渶鏆撮湶浠讳綍绔彛銆?
 
-## 快速开始
+## 蹇€熷紑濮?
 
-### 方式 A：npm 全局安装（推荐）
+### 鏂瑰紡 A锛歯pm 鍏ㄥ眬瀹夎锛堟帹鑽愶級
 
-```bash
-npm install -g agents-bridge@latest
+```bash
+npm install -g agents-bridge@latest
 
-# 交互式引导：输入 gateway URL、bot token、选择模型，自动生成配置
+# 浜や簰寮忓紩瀵硷細杈撳叆 gateway URL銆乥ot token銆侀€夋嫨妯″瀷锛岃嚜鍔ㄧ敓鎴愰厤缃?
 agents-bridge onboard
 
-# 启动
+# 鍚姩
 agents-bridge start
 ```
 
-### 方式 B：Docker
+### 鏂瑰紡 B锛欴ocker
 
-```bash
-docker run -d --name agents-bridge \
-  -v /home/user/project:/workspace \
-  -v agents-bridge-data:/root/.agent-bridge \
-  -e AGENT_BRIDGE_GATEWAY_URL=https://your-botlink.com \
-  -e AGENT_BRIDGE_BOT_TOKEN=bot_xxx \
-  -e ANTHROPIC_API_KEY=sk-ant-xxx \
-  agents-bridge:latest
-```
+```bash
+docker run -d --name agents-bridge \
+  -v /home/user/project:/workspace \
+  -v agents-bridge-data:/root/.agent-bridge \
+| `AGENT_BRIDGE_GATEWAY_URL` | `channels.botlink.gateway_url` 或 `channels.botlink.accounts.default.gateway_url` | botlink 网关地址 |
+| `AGENT_BRIDGE_BOT_TOKEN` | `channels.botlink.bot_token` 或 `channels.botlink.accounts.default.bot_token` | Bot Token |
+  -e ANTHROPIC_API_KEY=sk-ant-xxx \
+  agents-bridge:latest
+```
 
-或使用 docker-compose：
+鎴栦娇鐢?docker-compose锛?
 
 ```bash
 cp .env.example .env
-# 编辑 .env 填入实际值
+# 缂栬緫 .env 濉叆瀹為檯鍊?
 docker compose up -d
 ```
 
-### 方式 C：源码运行（开发者）
+### 鏂瑰紡 C锛氭簮鐮佽繍琛岋紙寮€鍙戣€咃級
 
-```bash
-git clone <repo-url>
-cd <repo-dir>
-pnpm install
-pnpm build
-cp config.example.json config.json   # 编辑配置
-node dist/entry.js start
+```bash
+git clone <repo-url>
+cd <repo-dir>
+pnpm install
+pnpm build
+cp config.example.json config.json   # 缂栬緫閰嶇疆
+node dist/entry.js start
 ```
 
-开发模式（自动重载）：
+寮€鍙戞ā寮忥紙鑷姩閲嶈浇锛夛細
 
 ```bash
 pnpm dev
 ```
 
-## CLI 命令
+## CLI 鍛戒护
 
 ```bash
 agents-bridge start                # 启动 gateway（前台）
@@ -80,26 +79,26 @@ agents-bridge start -c <path>      # 指定配置文件启动
 agents-bridge stop                 # 停止守护进程
 agents-bridge status               # 查看运行状态
 agents-bridge onboard              # 交互式初始化引导
-agents-bridge doctor               # 诊断环境（Node.js、CLI 工具、API Key）
-agents-bridge logs                 # 查看日志
+agents-bridge doctor               # 诊断环境、会话持久化、日志与 CLI 路径
+agents-bridge logs                 # 查看当天最新日志
 agents-bridge config               # 查看当前配置（脱敏显示）
 agents-bridge help                 # 帮助
 ```
 
-## 配置
-
-### 配置文件
+## 閰嶇疆
 
-主配置文件为 JSON 格式，搜索顺序：
+### 閰嶇疆鏂囦欢
 
-1. CLI 参数：`agents-bridge start -c /path/to/config.json`
-2. 环境变量：`AGENT_BRIDGE_CONFIG=/path/to/config.json`
-3. 用户目录：`~/.agent-bridge/config.json`
-4. 当前目录：`./config.json`
+涓婚厤缃枃浠朵负 JSON 鏍煎紡锛屾悳绱㈤『搴忥細
 
-完整示例见 [config.example.json](config.example.json)。
+1. CLI 鍙傛暟锛歚agents-bridge start -c /path/to/config.json`
+2. 鐜鍙橀噺锛歚AGENT_BRIDGE_CONFIG=/path/to/config.json`
+3. 鐢ㄦ埛鐩綍锛歚~/.agent-bridge/config.json`
+4. 褰撳墠鐩綍锛歚./config.json`
 
-### 核心配置项
+瀹屾暣绀轰緥瑙?[config.example.json](config.example.json)锛堝崟 agent锛夊拰 [config.multi-agent.example.json](config.multi-agent.example.json)锛堝 agent锛夈€傞厤缃瓧娈佃缁嗚鏄庤 [閰嶇疆鏂囨。](../agent-bridge-docs/docs/guides/configuration.md)銆?
+褰撳墠杩愯鏃朵粎鏀寔 CLI 妯″紡妯″瀷锛屽 `claude-cli/...`銆乣codex-cli/...`銆俙anthropic/...`銆乣openai/...` 杩欑被 API 鐩磋繛妯″瀷寮曠敤鏆傛湭瀹炵幇鎵ц閾捐矾銆?
+### 鏍稿績閰嶇疆椤癸紙鍗?agent锛?
 
 ```json
 {
@@ -115,8 +114,7 @@ agents-bridge help                 # 帮助
   "agents": {
     "defaults": {
       "model": {
-        "primary": "claude-cli/opus-4.6",
-        "fallbacks": ["anthropic/claude-sonnet-4-6"]
+        "primary": "claude-cli/opus-4.6"
       },
       "cliBackends": {
         "claude-cli": {
@@ -150,88 +148,118 @@ agents-bridge help                 # 帮助
 }
 ```
 
-### 环境变量覆盖
+### 澶?Agent 閰嶇疆
+
+鍦?`agents` 涓嬪姞 `list` 瀹氫箟澶氫釜鍛藉悕 agent锛岀敤椤跺眰 `bindings` 鎸変細璇?鐢ㄦ埛璺敱锛?
+
+```json
+{
+  "agents": {
+    "defaults": { "model": { "primary": "claude-cli/opus-4.6" } },
+    "list": [
+      { "id": "coder", "default": true, "workspace": "/home/user/app" },
+      { "id": "ops", "model": "codex-cli/o3", "workspace": "/opt/infra" }
+    ]
+  },
+  "bindings": [
+    { "agentId": "ops", "match": { "peer": { "id": "-300" } } },
+    { "agentId": "coder", "match": { "channel": "*" } }
+  ]
+}
+```
+
+姣忎釜 agent 缁ф壙 `defaults` 骞跺彲瑕嗙洊 model銆亀orkspace銆乪nv銆乧liBackends 绛夈€傝瑙?[閰嶇疆鏂囨。](../agent-bridge-docs/docs/guides/configuration.md)銆?
 
-环境变量可覆盖配置文件中的对应值：
+### 鐜鍙橀噺瑕嗙洊
 
-| 环境变量 | 覆盖 | 说明 |
+鐜鍙橀噺鍙鐩栭厤缃枃浠朵腑鐨勫搴斿€硷細
+
+| 鐜鍙橀噺 | 瑕嗙洊 | 璇存槑 |
 |---|---|---|
-| `AGENT_BRIDGE_CONFIG` | — | 配置文件路径 |
-| `AGENT_BRIDGE_GATEWAY_URL` | `channels.botlink.gateway_url` | botlink 网关地址 |
-| `AGENT_BRIDGE_BOT_TOKEN` | `channels.botlink.bot_token` | Bot Token |
-| `AGENT_BRIDGE_LOG_LEVEL` | `logging.level` | 日志级别 |
-| `AGENT_BRIDGE_TEMP_DIR` | `files.temp_dir` | 临时文件目录 |
+| `AGENT_BRIDGE_CONFIG` | 鈥?| 閰嶇疆鏂囦欢璺緞 |
+| `AGENT_BRIDGE_GATEWAY_URL` | `channels.botlink.gateway_url` 或 `channels.botlink.accounts.default.gateway_url` | botlink 网关地址 |
+| `AGENT_BRIDGE_BOT_TOKEN` | `channels.botlink.bot_token` 或 `channels.botlink.accounts.default.bot_token` | Bot Token |
+| `AGENT_BRIDGE_LOG_LEVEL` | `logging.level` | 鏃ュ織绾у埆 |
+| `AGENT_BRIDGE_TEMP_DIR` | `files.temp_dir` | 涓存椂鏂囦欢鐩綍 |
 
-## 数据目录
+## 鏁版嵁鐩綍
 
 ```
 ~/.agent-bridge/
-├── config.json                # 主配置（onboard 生成）
-├── agent-bridge.pid           # PID 文件（daemon 模式）
-├── data/
-│   ├── sessions/              # Agent 会话持久化
-│   │   └── cli-sessions.json  # botlink session -> CLI session id 映射
-│   ├── files/                 # 文件中转临时目录
-│   └── logs/                  # 日志文件
-└── skills/                    # 自定义技能
+鈹溾攢鈹€ config.json                # 涓婚厤缃紙onboard 鐢熸垚锛?
+鈹溾攢鈹€ agent-bridge.pid           # PID 鏂囦欢锛坉aemon 妯″紡锛?
+鈹溾攢鈹€ agents/                    # per-agent 鐘舵€侊紙澶?agent 妯″紡锛?
+鈹?  鈹溾攢鈹€ coder/
+鈹?  鈹?  鈹斺攢鈹€ cli-sessions.json  # coder 鐨?session 鏄犲皠
+鈹?  鈹溾攢鈹€ reviewer/
+鈹?  鈹?  鈹斺攢鈹€ cli-sessions.json
+鈹?  鈹斺攢鈹€ default/               # 闅愬紡 agent锛堟湭閰?list 鏃讹級
+鈹?      鈹斺攢鈹€ cli-sessions.json
+鈹溾攢鈹€ data/
+鈹?  鈹溾攢鈹€ sessions/              # 鏃х増 session 瀛樺偍锛堝崌绾у悗鑷姩杩佺Щ锛?
+鈹?  鈹溾攢鈹€ files/                 # 鏂囦欢涓浆涓存椂鐩綍
+鈹?  鈹斺攢鈹€ logs/                  # 鏃ュ織鏂囦欢
+鈹斺攢鈹€ skills/                    # 鑷畾涔夋妧鑳?
 ```
 
-## 项目结构
-
-```
-agents-bridge/
-├── bin/
-│   └── agent-bridge.mjs       # CLI 入口（npm 全局安装）
-├── src/
-│   ├── entry.ts               # 主入口，子命令路由
-│   ├── cli/                   # CLI 命令实现
-│   │   ├── run-main.ts        #   参数解析
-│   │   ├── cmd-start.ts       #   start 命令
-│   │   ├── cmd-stop.ts        #   stop 命令
-│   │   ├── cmd-status.ts      #   status 命令
-│   │   ├── cmd-onboard.ts     #   onboard 交互引导
-│   │   ├── cmd-doctor.ts      #   doctor 环境诊断
-│   │   ├── cmd-logs.ts        #   logs 查看
-│   │   └── cmd-config.ts      #   config 查看
-│   ├── config/                # 配置加载与校验
-│   │   ├── config.ts          #   主加载器
-│   │   ├── zod-schema.ts      #   Zod schema
-│   │   ├── paths.ts           #   数据目录路径常量
-│   │   ├── env-vars.ts        #   环境变量读取
-│   │   ├── merge-config.ts    #   配置合并
-│   │   └── agent-dirs.ts      #   目录初始化
-│   ├── channels/              # Channel 插件框架
-│   │   ├── registry.ts        #   插件注册表
-│   │   ├── session.ts         #   会话管理
-│   │   └── ...
-│   ├── agents/                # Agent 运行时
-│   │   ├── cli-backends.ts    #   CLI backend provider id / 默认配置装配
-│   │   ├── cli-session-store.ts # CLI session 映射持久化
-│   │   ├── cli-runner.ts      #   Claude/Codex CLI 执行器
-│   │   └── ...
-│   ├── types/                 # 类型定义
-│   └── logger.ts              # Pino 日志
-├── extensions/                # Channel 插件（botlink）
-├── skills/                    # 技能定义
-├── config.example.json        # 配置示例
-├── .env.example               # 环境变量示例
-├── Dockerfile
-├── docker-compose.yml
-├── package.json
-└── tsconfig.json
+## 椤圭洰缁撴瀯
+
+```
+agents-bridge/
+鈹溾攢鈹€ bin/
+鈹?  鈹斺攢鈹€ agent-bridge.mjs       # CLI 鍏ュ彛锛坣pm 鍏ㄥ眬瀹夎锛?
+鈹溾攢鈹€ src/
+鈹?  鈹溾攢鈹€ entry.ts               # 涓诲叆鍙ｏ紝瀛愬懡浠よ矾鐢?
+鈹?  鈹溾攢鈹€ cli/                   # CLI 鍛戒护瀹炵幇
+鈹?  鈹?  鈹溾攢鈹€ run-main.ts        #   鍙傛暟瑙ｆ瀽
+鈹?  鈹?  鈹溾攢鈹€ cmd-start.ts       #   start 鍛戒护
+鈹?  鈹?  鈹溾攢鈹€ cmd-stop.ts        #   stop 鍛戒护
+鈹?  鈹?  鈹溾攢鈹€ cmd-status.ts      #   status 鍛戒护
+鈹?  鈹?  鈹溾攢鈹€ cmd-onboard.ts     #   onboard 浜や簰寮曞
+鈹?  鈹?  鈹溾攢鈹€ cmd-doctor.ts      #   doctor 鐜璇婃柇
+鈹?  鈹?  鈹溾攢鈹€ cmd-logs.ts        #   logs 鏌ョ湅
+鈹?  鈹?  鈹斺攢鈹€ cmd-config.ts      #   config 鏌ョ湅
+鈹?  鈹溾攢鈹€ config/                # 閰嶇疆鍔犺浇涓庢牎楠?
+鈹?  鈹?  鈹溾攢鈹€ config.ts          #   涓诲姞杞藉櫒
+鈹?  鈹?  鈹溾攢鈹€ zod-schema.ts      #   Zod schema
+鈹?  鈹?  鈹溾攢鈹€ paths.ts           #   鏁版嵁鐩綍璺緞甯搁噺
+鈹?  鈹?  鈹溾攢鈹€ env-vars.ts        #   鐜鍙橀噺璇诲彇
+鈹?  鈹?  鈹溾攢鈹€ merge-config.ts    #   閰嶇疆鍚堝苟
+鈹?  鈹?  鈹斺攢鈹€ agent-dirs.ts      #   鐩綍鍒濆鍖?
+鈹?  鈹溾攢鈹€ channels/              # Channel 鎻掍欢妗嗘灦
+鈹?  鈹?  鈹溾攢鈹€ registry.ts        #   鎻掍欢娉ㄥ唽琛?
+鈹?  鈹?  鈹溾攢鈹€ session.ts         #   浼氳瘽绠＄悊
+鈹?  鈹?  鈹斺攢鈹€ ...
+鈹?  鈹溾攢鈹€ agents/                # Agent 杩愯鏃?
+鈹?  鈹?  鈹溾攢鈹€ agent-resolver.ts  #   澶?agent 閰嶇疆瑙ｆ瀽锛坉efaults + list 鍚堝苟锛?
+鈹?  鈹?  鈹溾攢鈹€ agent-router.ts    #   娑堟伅璺敱锛坆indings 鍖归厤锛?
+鈹?  鈹?  鈹溾攢鈹€ cli-backends.ts    #   CLI backend provider id / 榛樿閰嶇疆瑁呴厤
+鈹?  鈹?  鈹溾攢鈹€ cli-session-store.ts # CLI session 鏄犲皠鎸佷箙鍖栵紙per-agent锛?
+鈹?  鈹?  鈹溾攢鈹€ cli-runner.ts      #   Claude/Codex CLI 鎵ц鍣?
+鈹?  鈹?  鈹斺攢鈹€ ...
+鈹?  鈹溾攢鈹€ types/                 # 绫诲瀷瀹氫箟
+鈹?  鈹斺攢鈹€ logger.ts              # Pino 鏃ュ織
+鈹溾攢鈹€ extensions/                # Channel 鎻掍欢锛坆otlink锛?
+鈹溾攢鈹€ skills/                    # 鎶€鑳藉畾涔?
+鈹溾攢鈹€ config.example.json        # 閰嶇疆绀轰緥
+鈹溾攢鈹€ .env.example               # 鐜鍙橀噺绀轰緥
+鈹溾攢鈹€ Dockerfile
+鈹溾攢鈹€ docker-compose.yml
+鈹溾攢鈹€ package.json
+鈹斺攢鈹€ tsconfig.json
 ```
 
-## 三种 Agent 模式
+## 褰撳墠鏀寔鐨?Agent 妯″紡
 
-| 模式 | 模型引用示例 | 说明 |
+| 妯″紡 | 妯″瀷寮曠敤绀轰緥 | 璇存槑 |
 |---|---|---|
 | Claude Code | `claude-cli/opus-4.6` | 通过 CLI backend 启动本地 `claude` 命令 |
-| Codex | `codex-cli/gpt-5.3-codex` | 通过 CLI backend 启动本地 `codex` 命令 |
+| Codex | `codex-cli/gpt-5.4` | 通过 CLI backend 启动本地 `codex` 命令 |
 | Pi Agent | `anthropic/claude-sonnet-4-6` | 通过 LLM API 直连，内置工具执行 |
 
-在 `config.json` 的 `agents.defaults.model.primary` 中选择。
+鍦?`config.json` 鐨?`agents.defaults.model.primary` 涓€夋嫨銆?
 
-## CLI Backend 约定
+## CLI Backend 绾﹀畾
 
 - 内置 provider id 固定为 `claude-cli`、`codex-cli`。
 - `agents.defaults.cliBackends` 会覆盖内置默认值，不需要重复写全量字段。
@@ -239,21 +267,24 @@ agents-bridge/
 - CLI backend session id 会持久化到 `~/.agent-bridge/data/sessions/cli-sessions.json` 的 `cliSessionIds[providerId]`。
 - `serialize: true` 的语义是“同一 botlink session 串行、跨 session 可并发”。
 - Claude CLI 走 JSON 输出；Codex CLI 首次运行走 JSONL，resume 走 text。
+- agents-bridge 会把运行日志同时写到 stdout 和 `~/.agent-bridge/data/logs/agent-bridge-YYYY-MM-DD.log`。
+- `agents-bridge doctor` 会检查 Codex 会话是否缺失 `thread_id` 持久化，便于定位“每次都 fresh”的问题。
 
-## 技术栈
+## 鎶€鏈爤
 
 - TypeScript + Node.js (>= 22.0.0)
 - pnpm (>= 9.0.0)
-- Pino（日志）
-- Zod（配置校验）
-- JSON（配置格式）
+- Pino锛堟棩蹇楋級
+- Zod锛堥厤缃牎楠岋級
+- JSON锛堥厤缃牸寮忥級
 
-## 开发
+## 寮€鍙?
 
 ```bash
-pnpm install          # 安装依赖
-pnpm build            # 编译
-pnpm dev              # 开发模式（自动重载）
-pnpm typecheck        # 类型检查
+pnpm install          # 瀹夎渚濊禆
+pnpm build            # 缂栬瘧
+pnpm dev              # 寮€鍙戞ā寮忥紙鑷姩閲嶈浇锛?
+pnpm typecheck        # 绫诲瀷妫€鏌?
 ```
 
+

package/bin/agent-bridge.mjs

@@ -1,12 +1,12 @@
-#!/usr/bin/env node
-
-// agents-bridge CLI entry point
-// Used by: npm install -g agents-bridge / npx agents-bridge
-
-import { fileURLToPath } from 'node:url'
-import { dirname, resolve } from 'node:path'
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-
-// Import the compiled entry point
+#!/usr/bin/env node
+
+// agents-bridge CLI entry point
+// Used by: npm install -g agents-bridge / npx agents-bridge
+
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+// Import the compiled entry point
 await import(resolve(__dirname, '..', 'dist', 'entry.js'))

package/config.example.json

@@ -1,8 +1,8 @@
-{
+{
   "channels": {
     "botlink": {
-      "gateway_url": "https://test.51yzt.cn",
-      "bot_token": "bot_WEMU0m9NVxwOQIMVaNYskiSDTK-_1hA7dcCrQCzoxcU",
+      "gateway_url": "https://your-botlink.com",
+      "bot_token": "bot_xxx",
       "poll_timeout": 30,
       "retry_interval": 5,
       "max_retry_interval": 60
@@ -11,10 +11,7 @@
   "agents": {
     "defaults": {
       "model": {
-        "primary": "claude-cli/opus-4.6",
-        "fallbacks": [
-          "anthropic/claude-sonnet-4-6"
-        ]
+        "primary": "claude-cli/opus-4.6"
       },
       "cliBackends": {
         "claude-cli": {
@@ -45,67 +42,37 @@
           "systemPromptArg": "--append-system-prompt",
           "systemPromptMode": "append",
           "systemPromptWhen": "first",
-          "clearEnv": [
-            "ANTHROPIC_API_KEY",
-            "ANTHROPIC_API_KEY_OLD"
-          ],
           "sessionMode": "always",
-          "serialize": true,
-          "reliability": {
-            "watchdog": {
-              "fresh": {
-                "noOutputTimeoutRatio": 0.8,
-                "minMs": 180000,
-                "maxMs": 600000
-              },
-              "resume": {
-                "noOutputTimeoutRatio": 0.3,
-                "minMs": 60000,
-                "maxMs": 180000
-              }
-            }
-          }
+          "serialize": true
         },
         "codex-cli": {
           "command": "codex",
-          "args": [
-            "exec", "--json", "--color", "never",
-            "--sandbox", "read-only", "--skip-git-repo-check"
-          ],
-          "resumeArgs": [
-            "exec", "resume", "{sessionId}", "--color", "never",
-            "--sandbox", "read-only", "--skip-git-repo-check"
-          ],
-          "output": "jsonl",
-          "resumeOutput": "text",
-          "modelArg": "--model",
+          "runtimeMode": "app-server",
+          "appServer": {
+            "listen": "stdio://",
+            "sessionSource": "agent-bridge",
+            "startupTimeoutMs": 15000,
+            "requestTimeoutMs": 30000,
+            "serviceName": "agent-bridge",
+            "experimentalApi": false,
+            "approvalPolicy": "never",
+            "sandbox": "read-only",
+            "persistExtendedHistory": false,
+            "experimentalRawEvents": false
+          },
           "sessionIdFields": [
             "thread_id"
           ],
-          "imageArg": "--image",
-          "imageMode": "repeat",
           "sessionMode": "existing",
-          "serialize": true,
-          "reliability": {
-            "watchdog": {
-              "fresh": {
-                "noOutputTimeoutRatio": 0.8,
-                "minMs": 180000,
-                "maxMs": 600000
-              },
-              "resume": {
-                "noOutputTimeoutRatio": 0.3,
-                "minMs": 60000,
-                "maxMs": 180000
-              }
-            }
-          }
+          "serialize": true
         }
       }
     }
   },
   "skills": {
-    "dirs": ["./skills"]
+    "dirs": [
+      "./skills"
+    ]
   },
   "files": {
     "temp_dir": "/tmp/agent-bridge/files",

package/config.multi-agent.example.json

@@ -0,0 +1,67 @@
+{
+  "channels": {
+    "botlink": {
+      "accounts": {
+        "codex-bot": {
+          "gateway_url": "https://your-botlink.com",
+          "bot_token": "bot_codex_xxx",
+          "poll_timeout": 30,
+          "retry_interval": 5,
+          "max_retry_interval": 60
+        },
+        "claude-bot": {
+          "gateway_url": "https://your-botlink.com",
+          "bot_token": "bot_claude_xxx",
+          "poll_timeout": 30,
+          "retry_interval": 5,
+          "max_retry_interval": 60
+        }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": {
+        "primary": "claude-cli/opus-4.6"
+      }
+    },
+    "list": [
+      {
+        "id": "codex-assistant",
+        "default": true,
+        "name": "Codex 助理",
+        "model": "codex-cli/gpt-5.4",
+        "workspace": "/workspace/app",
+        "cliSessionId": "thread_xxxxxxxxxxxxxxxx"
+      },
+      {
+        "id": "claudecode-assistant",
+        "name": "Claude Code 助理",
+        "model": "claude-cli/opus-4.6",
+        "workspace": "/workspace/app",
+        "cliSessionId": "01970df8-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+      }
+    ]
+  },
+  "bindings": [
+    {
+      "agentId": "codex-assistant",
+      "comment": "codex bot",
+      "match": {
+        "channel": "botlink",
+        "accountId": "codex-bot"
+      }
+    },
+    {
+      "agentId": "claudecode-assistant",
+      "comment": "claude bot",
+      "match": {
+        "channel": "botlink",
+        "accountId": "claude-bot"
+      }
+    }
+  ],
+  "logging": {
+    "level": "info"
+  }
+}

package/dist/agents/agent-resolver.d.ts

@@ -0,0 +1,12 @@
+import type { AppConfig } from '../config/zod-schema.js';
+import type { Logger, ResolvedAgent } from '../types/index.js';
+export interface ResolveAgentsResult {
+    agents: Map<string, ResolvedAgent>;
+    defaultAgentId: string;
+}
+/**
+ * Resolve agent configurations: merge defaults + list → Map<agentId, ResolvedAgent>.
+ * Called once at startup, result cached for routing.
+ */
+export declare function resolveAgentConfigs(config: AppConfig, logger: Logger): ResolveAgentsResult;
+//# sourceMappingURL=agent-resolver.d.ts.map

package/dist/agents/agent-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolver.d.ts","sourceRoot":"","sources":["../../src/agents/agent-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAoB,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAKhF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAyC1F"}