@sleep2agi/agent-network 2.0.0-preview.1 → 2.0.0-preview.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +156 -77
  2. package/dist/bin/cli.js +1 -1
  3. package/dist/src/client.js +1 -1
  4. package/dist/src/node-server.js +1 -1
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -1,113 +1,192 @@
1
- # @sleep2agi/agent-network
1
+ # @sleep2agi/agent-network (anet)
2
2
 
3
- AI Agent 通信网络 — CLI + SDK + Channel，一个包搞定。
3
+ AI Agent 通信网络 — 一行命令创建 Agent，多 Agent 协作通信。
4
+
5
+ ## 架构
6
+
7
+ ```
8
+ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
9
+ │ Agent Node │ │ Agent Node │ │ Agent Node │
10
+ │ (codex) │ │ (minimax) │ │ (claude) │
11
+ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
12
+ │ SSE │ SSE │ MCP
13
+ └──────────┬───────┴──────────────────┘
14
+ ┌─────┴─────┐
15
+ │ CommHub │ ← MCP Server + REST API
16
+ │ Server │ 任务调度 + 消息路由
17
+ └───────────┘
18
+ ```
19
+
20
+ **三个包，三个角色：**
21
+
22
+ | 包 | 角色 | 安装位置 |
23
+ |---|------|---------|
24
+ | `@sleep2agi/commhub-server` | 通信中枢 (Server) | 服务器，只需 1 台 |
25
+ | `@sleep2agi/agent-network` | CLI 管理工具 (anet) | 每台开发机 |
26
+ | `@sleep2agi/agent-node` | Agent 运行时 | 每台开发机 |
27
+
28
+ ## 5 分钟快速上手
29
+
30
+ ### Step 1: 部署 CommHub Server（服务器端）
31
+
32
+ 在你的服务器上（需要 Bun）：
4
33
 
5
34
  ```bash
6
- npm install -g @sleep2agi/agent-network
7
- anet setup
35
+ # 安装 Bun (如果没有)
36
+ curl -fsSL https://bun.sh/install | bash
37
+
38
+ # 启动 CommHub Server
39
+ bunx @sleep2agi/commhub-server
40
+ # 默认端口 9200, 访问 http://YOUR_IP:9200/health 验证
8
41
  ```
9
42
 
10
- ## 快速开始
43
+ Server 启动后会显示：
44
+ - MCP 端点: `http://0.0.0.0:9200/mcp`
45
+ - REST API: `http://0.0.0.0:9200/api`
46
+ - 健康检查: `http://0.0.0.0:9200/health`
47
+
48
+ ### Step 2: 安装 + 一键设置（开发机）
11
49
 
12
50
  ```bash
13
- # 1. 安装 + 交互式选装依赖
14
- npm install -g @sleep2agi/agent-network
15
- anet setup
51
+ npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
16
52
 
17
- # 2. 配置 CommHub
18
- anet init --hub http://YOUR_IP:9200
53
+ # 一键引导（推荐）
54
+ anet quickstart
19
55
 
20
- # 3. 创建 node（交互式）
21
- anet create
56
+ # 或手动配置
57
+ anet init --hub http://YOUR_SERVER_IP:9200
58
+ anet register # 创建账号
59
+ anet login # 登录
22
60
 
23
- # 4. 启动
24
- anet start 指挥室
61
+ # 检查一切正常
62
+ anet doctor
25
63
  ```
26
64
 
27
- ## 版本
65
+ ### Step 3: 创建并启动 Agent
28
66
 
29
67
  ```bash
30
- anet -v
68
+ # 交互式创建（会问你选哪个 Runtime / Model）
69
+ anet create my-agent
70
+
71
+ # 或直接指定
72
+ anet create my-agent --runtime codex-sdk --model gpt-5.4
73
+
74
+ # 启动
75
+ anet start my-agent
31
76
  ```
77
+
78
+ ### Step 4: 发送任务
79
+
80
+ 在另一个终端或另一台机器上：
81
+
82
+ ```bash
83
+ # 查看网络状态
84
+ anet status
85
+
86
+ # 查看任务列表
87
+ anet tasks
32
88
  ```
33
- anet v1.3.1
34
- agent-node v1.1.0 (global)
35
- └ @anthropic-ai/claude-agent-sdk v0.2.98
36
- └ @openai/codex-sdk v0.118.0
37
- commhub-server not installed
38
- claude CLI v2.1.98
39
- codex CLI v0.118.0
89
+
90
+ 通过 MCP 工具发送任务（Claude Code / Codex 会自动发现）：
40
91
  ```
92
+ commhub_send_task(alias="my-agent", task="帮我写个 hello world")
93
+ ```
94
+
95
+ ## Runtime 选择
96
+
97
+ | Runtime | 底层 | 需要 | 适用场景 |
98
+ |---------|------|------|---------|
99
+ | `codex-sdk` | GPT-5.4 via Codex | `codex auth login` | 代码任务 |
100
+ | `claude-agent-sdk` | Claude Code | Claude Pro + `claude auth login` | 通用任务 |
101
+ | `http-api` | 任何 OpenAI/Anthropic 兼容 API | API Key | MiniMax, DeepSeek 等 |
41
102
 
42
- ## Runtime
103
+ ```bash
104
+ # Codex (GPT-5.4)
105
+ anet create dev --runtime codex-sdk
43
106
 
44
- | 名称 | 底层 | 说明 |
45
- |------|------|------|
46
- | `claude-code-cli` | Claude Code CLI | 需要 Pro 订阅 + claude auth login |
47
- | `codex-sdk` | Codex SDK + CLI | 需要 codex auth login |
48
- | `claude-agent-sdk` | Claude Agent SDK | 支持 MiniMax / 书生 / Claude |
107
+ # MiniMax (通过 Anthropic 兼容 API)
108
+ ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
109
+ ANTHROPIC_API_KEY=sk-cp-xxx \
110
+ agent-node --alias dev --runtime http-api --model claude-3-5-haiku-20241022
111
+ ```
49
112
 
50
- ## CLI 命令
113
+ ## CLI 命令 (26 个)
51
114
 
52
115
  ```bash
53
- # 全局
54
- anet init # 配 hub URL + token
55
- anet setup # 交互式安装依赖
56
- anet upgrade # 一键升级所有包
57
- anet server start # 启动 CommHub Server
58
- anet -v # 版本诊断
59
-
60
- # 项目
61
- anet create <node-name> # 创建 node（交互式）
62
- anet start <node-name> # 启动（自动 resume）
63
- anet start <node-name> --new-session # 强制新建
64
- anet resume <node-name> --session <id> # 导入已有 session
65
- anet channel add telegram <node-name> # 加 Telegram channel
66
- anet channel ls [node-name] # 查看 channel
67
- anet ls # 查看所有 node
68
- anet session ls # 查看 session
116
+ # 账号
117
+ anet quickstart # 一键引导设置
118
+ anet register # 创建账号
119
+ anet login # 登录
120
+ anet logout # 退出
121
+ anet whoami # 当前用户信息
122
+
123
+ # 网络
124
+ anet network create <name> # 创建网络
125
+ anet network ls # 我的网络列表
126
+ anet network use <name> # 切换网络
127
+
128
+ # 节点
129
+ anet create <name> # 创建 node（交互式）
130
+ anet start <name> # 启动
131
+ anet stop <name> # 停止
132
+ anet delete <name> --force # 删除
133
+ anet rename <ref> <new> # 重命名
134
+ anet ls # 节点列表 + 网络状态
135
+ anet status # 网络总览
136
+ anet tasks [status] # 任务列表
137
+ anet logs <name> # 查看日志
138
+ anet doctor # 系统诊断
139
+
140
+ # Channel
141
+ anet channel add telegram <name> --bot-token <tok> --allow <uid>
142
+
143
+ # 设置
144
+ anet init # 配置 hub URL
145
+ anet setup # 安装依赖
146
+ anet server start # 启动 CommHub
147
+ anet upgrade # 检查更新
148
+ anet -v # 版本信息
69
149
  ```
70
150
 
71
- ## 配置
151
+ ## 配置文件
72
152
 
73
153
  ```
74
- ~/.anet/config.json # 全局 hub + token
75
- {workpath}/.anet/nodes/<name>/
76
- ├── config.json # node 配置
77
- └── channels/telegram/ # Telegram channel
78
- ├── .env # bot token
79
- ├── access.json # 白名单
80
- └── inbox/ # 图片/文件
154
+ ~/.anet/config.json # 全局: hub URL + token
155
+ {project}/.anet/nodes/<name>/
156
+ ├── config.json # 节点: runtime, model, node_id
157
+ └── channels/telegram/
158
+ ├── .env # bot token (chmod 600)
159
+ └── access.json # 白名单
81
160
  ```
82
161
 
83
- ## SDK
162
+ 配置优先级: CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值
84
163
 
85
- ```typescript
86
- import { CommHub } from '@sleep2agi/agent-network';
164
+ ## REST API
87
165
 
88
- const hub = new CommHub({ url: 'http://YOUR_IP:9200', alias: '我的Agent' });
89
- hub.on('task', async (msg) => {
90
- await hub.send(msg.from_session, '完成！');
91
- });
92
- ```
166
+ | 端点 | 说明 |
167
+ |------|------|
168
+ | `GET /health` | 健康检查 (无需 auth) |
169
+ | `GET /api/status` | 所有 session |
170
+ | `GET /api/tasks?status=&from_name=&to_name=&limit=` | 任务列表 |
171
+ | `GET /api/nodes?node_id=&alias=` | 节点信息 |
172
+ | `GET /api/task_events?task_id=` | 任务审计日志 |
173
+ | `GET /api/messages?limit=&since=` | 消息列表 |
174
+ | `POST /mcp` | MCP Streamable HTTP |
175
+
176
+ 设置 `COMMHUB_AUTH_TOKEN` 环境变量启用 Bearer token 鉴权。
93
177
 
94
178
  ## npm 包
95
179
 
96
- | 包 | 版本 | 说明 |
97
- |---|------|------|
98
- | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | v1.3.1 | anet CLI + CommHub SDK |
99
- | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | v1.1.0 | Agent 运行时 |
100
- | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | v0.4.3 | CommHub Server |
101
-
102
- ## 文档
103
-
104
- - [CLI 重构方案](docs/cli-refactor-proposal.md)
105
- - [依赖管理方案](docs/dependency-management.md)
106
- - [测试计划](docs/test-plan.md)
107
- - [踩坑经验](docs/pitfalls.md)
108
- - [架构设计](docs/architecture.md)
109
- - [CommHub Review](docs/commhub-review.md)
110
- - [重启策略](docs/restart-strategy.md)
180
+ | 包 | 最新 Preview | 说明 |
181
+ |---|-------------|------|
182
+ | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.6 | anet CLI + SDK |
183
+ | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.3 | Agent 运行时 |
184
+ | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.6 | CommHub Server |
185
+
186
+ ```bash
187
+ # 安装 preview 版
188
+ npm i -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview
189
+ ```
111
190
 
112
191
  ## License
113
192