@sleep2agi/agent-network 2.0.0-preview.6 → 2.0.0-preview.7

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 +139 -76
  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,176 @@
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: 安装 CLI 工具（开发机）
49
+
50
+ 在每台要跑 Agent 的机器上：
11
51
 
12
52
  ```bash
13
- # 1. 安装 + 交互式选装依赖
14
- npm install -g @sleep2agi/agent-network
15
- anet setup
53
+ npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
16
54
 
17
- # 2. 配置 CommHub
18
- anet init --hub http://YOUR_IP:9200
55
+ # 配置 CommHub 地址
56
+ anet init --hub http://YOUR_SERVER_IP:9200
19
57
 
20
- # 3. 创建 node（交互式）
21
- anet create
58
+ # 检查一切正常
59
+ anet doctor
60
+ ```
61
+
62
+ ### Step 3: 创建并启动 Agent
22
63
 
23
- # 4. 启动
24
- anet start 指挥室
64
+ ```bash
65
+ # 交互式创建（会问你选哪个 Runtime / Model）
66
+ anet create my-agent
67
+
68
+ # 或直接指定
69
+ anet create my-agent --runtime codex-sdk --model gpt-5.4
70
+
71
+ # 启动
72
+ anet start my-agent
25
73
  ```
26
74
 
27
- ## 版本
75
+ ### Step 4: 发送任务
76
+
77
+ 在另一个终端或另一台机器上：
28
78
 
29
79
  ```bash
30
- anet -v
80
+ # 查看网络状态
81
+ anet status
82
+
83
+ # 查看任务列表
84
+ anet tasks
31
85
  ```
86
+
87
+ 通过 MCP 工具发送任务（Claude Code / Codex 会自动发现）：
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
+ commhub_send_task(alias="my-agent", task="帮我写个 hello world")
40
90
  ```
41
91
 
42
- ## Runtime
92
+ ## Runtime 选择
93
+
94
+ | Runtime | 底层 | 需要 | 适用场景 |
95
+ |---------|------|------|---------|
96
+ | `codex-sdk` | GPT-5.4 via Codex | `codex auth login` | 代码任务 |
97
+ | `claude-agent-sdk` | Claude Code | Claude Pro + `claude auth login` | 通用任务 |
98
+ | `http-api` | 任何 OpenAI/Anthropic 兼容 API | API Key | MiniMax, DeepSeek 等 |
99
+
100
+ ```bash
101
+ # Codex (GPT-5.4)
102
+ anet create dev --runtime codex-sdk
43
103
 
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 |
104
+ # MiniMax (通过 Anthropic 兼容 API)
105
+ ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
106
+ ANTHROPIC_API_KEY=sk-cp-xxx \
107
+ agent-node --alias dev --runtime http-api --model claude-3-5-haiku-20241022
108
+ ```
49
109
 
50
110
  ## CLI 命令
51
111
 
52
112
  ```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
113
+ # 节点管理
114
+ anet create <name> # 创建 node（交互式）
115
+ anet start <name> # 启动
116
+ anet stop <name> # 停止
117
+ anet delete <name> --force # 删除
118
+ anet rename <ref> <new> # 重命名
119
+ anet ls # 节点列表 + 网络状态
120
+ anet status # 网络总览
121
+ anet tasks [status] # 任务列表
122
+ anet doctor # 系统诊断
123
+
124
+ # Channel
125
+ anet channel add telegram <name> --bot-token <tok> --allow <uid>
126
+
127
+ # 设置
128
+ anet init # 配置 hub URL
129
+ anet setup # 安装依赖
130
+ anet server start # 启动 CommHub
131
+ anet upgrade # 检查更新
132
+ anet -v # 版本信息
69
133
  ```
70
134
 
71
- ## 配置
135
+ ## 配置文件
72
136
 
73
137
  ```
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/ # 图片/文件
138
+ ~/.anet/config.json # 全局: hub URL + token
139
+ {project}/.anet/nodes/<name>/
140
+ ├── config.json # 节点: runtime, model, node_id
141
+ └── channels/telegram/
142
+ ├── .env # bot token (chmod 600)
143
+ └── access.json # 白名单
81
144
  ```
82
145
 
83
- ## SDK
146
+ 配置优先级: CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值
84
147
 
85
- ```typescript
86
- import { CommHub } from '@sleep2agi/agent-network';
148
+ ## REST API
87
149
 
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
- ```
150
+ | 端点 | 说明 |
151
+ |------|------|
152
+ | `GET /health` | 健康检查 (无需 auth) |
153
+ | `GET /api/status` | 所有 session |
154
+ | `GET /api/tasks?status=&from_name=&to_name=&limit=` | 任务列表 |
155
+ | `GET /api/nodes?node_id=&alias=` | 节点信息 |
156
+ | `GET /api/task_events?task_id=` | 任务审计日志 |
157
+ | `GET /api/messages?limit=&since=` | 消息列表 |
158
+ | `POST /mcp` | MCP Streamable HTTP |
159
+
160
+ 设置 `COMMHUB_AUTH_TOKEN` 环境变量启用 Bearer token 鉴权。
93
161
 
94
162
  ## npm 包
95
163
 
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)
164
+ | 包 | 最新 Preview | 说明 |
165
+ |---|-------------|------|
166
+ | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.6 | anet CLI + SDK |
167
+ | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.3 | Agent 运行时 |
168
+ | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.6 | CommHub Server |
169
+
170
+ ```bash
171
+ # 安装 preview 版
172
+ npm i -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview
173
+ ```
111
174
 
112
175
  ## License
113
176