@sleep2agi/agent-node 0.1.0 → 0.1.1

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 (2) hide show
  1. package/README.md +94 -47
  2. package/package.json +15 -4
package/README.md CHANGED
@@ -1,61 +1,105 @@
1
1
  # @sleep2agi/agent-node
2
2
 
3
- One-command AI Agent node for CommHub networks.
3
+ 一行命令启动 AI Agent，加入 CommHub 通信网络。
4
+
5
+ 支持 Claude、MiniMax、或任何 Anthropic API 兼容模型。基于 Claude Agent SDK。
4
6
 
5
7
  ```bash
6
- npx @sleep2agi/agent-node --alias "我的Agent" --model MiniMax-M2.7 --hub http://YOUR_HUB:9200
8
+ npx @sleep2agi/agent-node --alias "我的Agent" --hub http://YOUR_HUB:9200
7
9
  ```
8
10
 
9
- ## Features
11
+ ## 它做什么？
12
+
13
+ 启动后自动：
14
+ 1. **注册** — 向 CommHub 报到（report_status）
15
+ 2. **监听** — SSE 长连接实时接收任务
16
+ 3. **处理** — 用 AI 模型处理任务（Claude Agent SDK query()）
17
+ 4. **回报** — 把结果发回给任务发送者
18
+ 5. **循环** — 等下一个任务
19
+ 6. **心跳** — 每 3 分钟上报存活状态
10
20
 
11
- - SSE real-time messaging with auto-reconnect
12
- - Heartbeat keepalive (3 min interval)
13
- - Session resume for context continuity
14
- - Works with Claude, MiniMax, or any Anthropic-compatible API
15
- - Config file support (`.agent-node.json`)
16
- - Graceful shutdown (SIGINT/SIGTERM)
21
+ ```
22
+ CommHub Server (:9200)
23
+ │
24
+ │ SSE /events/:alias
25
+ ▼
26
+ agent-node
27
+ ├─ 收到 new_task 事件
28
+ ├─ get_inbox → 拿任务内容
29
+ ├─ ack_inbox → 确认收到
30
+ ├─ query() → AI 处理（支持工具调用）
31
+ ├─ send_task → 回报结果
32
+ └─ 等待下一个任务...
33
+ ```
17
34
 
18
- ## Quick Start
35
+ ## 快速开始
19
36
 
20
- ### With MiniMax
37
+ ### 用 MiniMax（低成本）
21
38
 
22
39
  ```bash
23
- ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
24
- ANTHROPIC_AUTH_TOKEN=your-token \
25
- npx @sleep2agi/agent-node --alias "MiniMax马" --model MiniMax-M2.7
40
+ ANTHROPIC_BASE_URL=https://api.minimax.chat/anthropic \
41
+ ANTHROPIC_AUTH_TOKEN=your-minimax-token \
42
+ npx @sleep2agi/agent-node --alias "MiniMax马" --model MiniMax-M2.7 --hub http://YOUR_HUB:9200
26
43
  ```
27
44
 
28
- ### With Claude
45
+ 原理：Claude Agent SDK 底层走 Anthropic API，设 `ANTHROPIC_BASE_URL` 重定向到 MiniMax 的 Anthropic 兼容端点。零代码修改。
46
+
47
+ ### 用 Claude
29
48
 
30
49
  ```bash
31
50
  ANTHROPIC_API_KEY=your-key \
32
- npx @sleep2agi/agent-node --alias "Claude马" --model claude-sonnet-4-6
51
+ npx @sleep2agi/agent-node --alias "Claude马" --model claude-sonnet-4-6 --hub http://YOUR_HUB:9200
33
52
  ```
34
53
 
35
- ### With Config File
54
+ ### 带工具
36
55
 
37
- Create `.agent-node.json`:
56
+ ```bash
57
+ npx @sleep2agi/agent-node --alias "开发马" --model MiniMax-M2.7 --tools "Read,Bash,Grep"
58
+ ```
59
+
60
+ ### 用配置文件
61
+
62
+ 创建 `.agent-node.json`：
38
63
 
39
64
  ```json
40
65
  {
41
66
  "alias": "我的Agent",
42
67
  "hub": "http://YOUR_HUB:9200",
43
68
  "model": "MiniMax-M2.7",
44
- "tools": [],
69
+ "tools": ["Read", "Grep", "Bash"],
45
70
  "maxTurns": 5,
46
- "systemPrompt": "你是一个有用的助手"
71
+ "systemPrompt": "你是一个有用的 AI 助手，收到任务后认真执行并汇报结果。"
47
72
  }
48
73
  ```
49
74
 
50
- Then:
51
-
52
75
  ```bash
53
- ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
76
+ ANTHROPIC_BASE_URL=https://api.minimax.chat/anthropic \
54
77
  ANTHROPIC_AUTH_TOKEN=your-token \
55
78
  npx @sleep2agi/agent-node
56
79
  ```
57
80
 
58
- ## Programmatic Usage
81
+ ## CLI 参数
82
+
83
+ | 参数 | 环境变量 | 默认值 | 说明 |
84
+ |------|---------|--------|------|
85
+ | `--alias` | `ALIAS` | 必填 | Agent 名称 |
86
+ | `--hub` | `COMMHUB_URL` | `http://127.0.0.1:9200` | CommHub Server URL |
87
+ | `--model` | `MODEL` | `claude-sonnet-4-6` | AI 模型 |
88
+ | `--tools` | — | 无（纯对话） | 工具列表，逗号分隔 |
89
+ | `--max-turns` | — | `5` | 每个任务最大轮次 |
90
+ | `--prompt` | — | — | 自定义 system prompt |
91
+ | `--token` | `COMMHUB_TOKEN` | — | CommHub auth token |
92
+ | `--config` | — | `.agent-node.json` | 配置文件路径 |
93
+
94
+ ### 模型环境变量
95
+
96
+ | 模型 | 需要设置 |
97
+ |------|---------|
98
+ | Claude | `ANTHROPIC_API_KEY=your-key` |
99
+ | MiniMax | `ANTHROPIC_BASE_URL=https://api.minimax.chat/anthropic` + `ANTHROPIC_AUTH_TOKEN=your-token` |
100
+ | 其他 Anthropic 兼容 | `ANTHROPIC_BASE_URL=<endpoint>` + `ANTHROPIC_AUTH_TOKEN=<key>` |
101
+
102
+ ## 编程使用
59
103
 
60
104
  ```typescript
61
105
  import { AgentNode } from "@sleep2agi/agent-node";
@@ -68,8 +112,8 @@ const agent = new AgentNode({
68
112
  maxTurns: 5,
69
113
  onTask: async (msg) => {
70
114
  console.log("收到任务:", msg.content);
71
- // Return string to override AI processing
72
- // Return void to use default AI processing
115
+ // 返回 string → 跳过 AI 处理，直接用这个作为结果
116
+ // 返回 void → 走默认 AI 处理
73
117
  },
74
118
  onResult: async (msg, result) => {
75
119
  console.log("完成:", result);
@@ -79,30 +123,33 @@ const agent = new AgentNode({
79
123
  await agent.start();
80
124
  ```
81
125
 
82
- ## CLI Options
83
-
84
- | Option | Env Var | Description |
85
- |--------|---------|-------------|
86
- | `--alias` | `ALIAS` | Agent name (required) |
87
- | `--hub` | `COMMHUB_URL` | CommHub URL (default: `http://127.0.0.1:9200`) |
88
- | `--model` | `MODEL` | AI model (default: `claude-sonnet-4-6`) |
89
- | `--tools` | - | Comma-separated tool list |
90
- | `--max-turns` | - | Max turns per task (default: 5) |
91
- | `--prompt` | - | Custom system prompt |
92
- | `--token` | `COMMHUB_TOKEN` | Auth token |
93
- | `--config` | - | Config file path (default: `.agent-node.json`) |
126
+ ## 与 anet CLI 配合
94
127
 
95
- ## Architecture
128
+ ```bash
129
+ # 用 anet 管理配置和启动
130
+ npm install -g @sleep2agi/agent-network
96
131
 
132
+ anet init --hub http://YOUR_HUB:9200
133
+ anet init project
134
+ anet init profile minimax-agent --alias "MiniMax马"
135
+ anet start minimax-agent # spawn agent-node
97
136
  ```
98
- CommHub Server (SSE)
99
- ↕
100
- agent-node (this package)
101
- ├─ SSE listener → receive tasks
102
- ├─ CommHub MCP client → register/ack/reply
103
- └─ Claude Agent SDK → AI processing
104
- └─ Anthropic API / MiniMax / compatible
105
- ```
137
+
138
+ ## 已验证
139
+
140
+ - ✅ MiniMax M2.7 — 单轮/多轮/Extended Thinking/Session Resume/SSE streaming
141
+ - ✅ Claude Sonnet 4.6 — 完整功能
142
+ - ✅ CommHub 通信 — 注册/SSE/收任务/回报/心跳
143
+ - ⬜ MiniMax tool_use — 待验证
144
+ - ⬜ Codex runtime — 计划中
145
+
146
+ ## 相关包
147
+
148
+ | 包 | 说明 |
149
+ |---|------|
150
+ | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | CLI (anet) + CommHub SDK |
151
+ | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | Agent 运行时（本包） |
152
+ | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | CommHub Server |
106
153
 
107
154
  ## License
108
155
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sleep2agi/agent-node",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "One-command AI Agent node for CommHub networks. Powered by Claude Agent SDK.",
5
5
  "bin": {
6
6
  "agent-node": "./dist/cli.js"
@@ -22,7 +22,15 @@
22
22
  "build": "bun build src/cli.ts src/index.ts --outdir dist --target node --format esm --minify && tsc --emitDeclarationOnly --declaration --outDir dist",
23
23
  "prepublishOnly": "npm run build"
24
24
  },
25
- "keywords": ["agent", "ai", "commhub", "claude", "sdk", "minimax", "swarm"],
25
+ "keywords": [
26
+ "agent",
27
+ "ai",
28
+ "commhub",
29
+ "claude",
30
+ "sdk",
31
+ "minimax",
32
+ "swarm"
33
+ ],
26
34
  "author": "sleep2agi",
27
35
  "license": "MIT",
28
36
  "repository": {
@@ -30,9 +38,12 @@
30
38
  "url": "https://github.com/sleep2agi/agent-comm-hub",
31
39
  "directory": "agent-node"
32
40
  },
33
- "engines": { "node": ">=18.0.0" },
41
+ "engines": {
42
+ "node": ">=18.0.0"
43
+ },
34
44
  "dependencies": {
35
- "@anthropic-ai/claude-agent-sdk": "^0.2.96"
45
+ "@anthropic-ai/claude-agent-sdk": "^0.2.96",
46
+ "@sleep2agi/agent-network": "^0.0.22"
36
47
  },
37
48
  "devDependencies": {
38
49
  "@types/node": "^22.0.0",