@sleep2agi/agent-network 2.3.0-preview.4 → 2.3.0-preview.41

package/README.md

@@ -5,363 +5,74 @@
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/sleep2agi/agent-network/blob/main/LICENSE)
 [![Docs](https://img.shields.io/badge/docs-anet.sh-009e7e.svg)](https://anet.sh)
 
-Run a local network of AI agents from one CLI.
-
-`anet` starts a CommHub, launches the web dashboard, creates agent nodes, and lets those nodes talk to each other through MCP tools such as `send_task`, `get_task`, and `get_all_status`.
-
-## What It Is
-
-Agent Network is a local-first multi-agent runtime:
-
-- **CommHub**: MCP + REST + SSE hub for task routing, auth, networks, and status.
-- **Agent nodes**: long-running AI workers backed by Claude Code, Claude Agent SDK, Codex SDK, or Grok Build ACP.
-- **Dashboard**: browser UI for topology, chat, tasks, node health, and server telemetry.
-- **CLI**: `anet`, the single entry point for setup, auth, node lifecycle, and demos.
-
-The default path runs entirely on your machine. LAN sharing is opt-in.
-
-## Requirements
-
-- Node.js **>= 22.13.0**
-- npm **>= 10**
-- Bun **>= 1.2.0** (`anet hub start` lazy-runs the Bun-based CommHub server)
-- macOS or Linux
-
-Install Bun if needed:
-
-```bash
-curl -fsSL https://bun.sh/install | bash
-```
+`anet` connects local AI agents through one self-hosted Hub. It starts CommHub and the Dashboard, creates node identities, and manages node lifecycle, networks, tokens, tasks, and channels.
 
 ## Install
 
-Stable:
+Requires Node.js ≥ 22.13 and Bun ≥ 1.2.
 
 ```bash
-npm install -g @sleep2agi/agent-network
-anet -v
+npm install -g bun @sleep2agi/agent-network @sleep2agi/agent-node
 ```
 
-Preview channel:
+Stable releases use npm's `latest` tag. Features that are still being validated use `preview`:
 
 ```bash
-npm install -g @sleep2agi/agent-network@preview
-anet -v
+anet upgrade --channel preview
 ```
 
-Current npm dist-tags verified on 2026-05-28 (v0.10.11 stable):
-
-| Package | latest | preview |
-|---|---:|---:|
-| `@sleep2agi/agent-network` | `2.2.10` | `2.2.10-preview.3` |
-| `@sleep2agi/commhub-server` | `0.8.4` | `0.8.4-preview.1` |
-| `@sleep2agi/agent-network-dashboard` | `0.5.6` | `0.5.7-preview.2` |
-| `@sleep2agi/agent-node` | `2.4.7` | `2.4.8-preview.0` |
-
-## 5-Minute Quick Start
+Do not copy fixed package or preview numbers from old issues. Check the [versioning guide](https://anet.sh/guide/versioning) and npm dist-tags for the current release.
 
-Open three terminals.
+## Quick start
 
-### 1. Start CommHub
+Open three terminals:
 
 ```bash
+# Terminal 1 — Hub
 anet hub start
-```
-
-Default local URL:
-
-```text
-http://127.0.0.1:9200
-```
-
-By default the hub binds to localhost. Use `--host 0.0.0.0` only when you intentionally want LAN clients to connect.
-
-### 2. Start Dashboard
 
-```bash
+# Terminal 2 — Dashboard
 anet hub dashboard
-```
-
-Open:
-
-```text
-http://localhost:3000
-```
-
-### 3. Log In, Create A Node, Start It
 
-```bash
-anet login --username admin --password anethub
+# Terminal 3 — login, create, start
+anet login --hub http://127.0.0.1:9200 --username admin
 anet node create my-bot
 anet node start my-bot
 ```
 
-`anet node create` walks you through:
+The node is ready after its log reports `SSE connected`. Open `http://localhost:3000` and send it a task from Dashboard.
 
-1. Runtime: `claude-code-cli`, `claude-agent-sdk`, `codex-sdk`, or `grok-build-acp`.
-2. Provider preset: Anthropic, MiniMax, InternLM, Xiaomi MiMo, or `custom` (any Anthropic-compatible endpoint — used for DeepSeek / GLM / Kimi / OpenRouter etc.; codex-sdk for OpenAI Codex; grok-build-acp for xAI Grok).
-3. API key and model settings.
+## Runtime selection
 
-When the node starts successfully, look for:
+`anet node create` shows only runtimes available in the installed release channel. Installation, authentication, permissions, and current availability are maintained in the [runtime guide](https://anet.sh/guide/runtimes).
 
-```text
-SSE connected
-```
+- Claude Code, Claude Agent SDK, Codex SDK, and Grok Build ACP are the published task-runtime paths.
+- Codex TUI co-presence is preview-only and must be started and recovered with `--copresence`; see the [co-presence guide](https://anet.sh/guide/codex-copresence).
+- OpenCode support is preview-only. Its automatic `npx` fallback is intentionally disabled, so install the documented CLI explicitly.
+- Neither npm `latest` nor `preview` includes a shared Grok TUI. Use `grok-build-acp` for published Grok nodes and follow the [Grok TUI status page](https://anet.sh/guide/grok-copresence).
 
-Then use the Dashboard chat panel to send `my-bot` a message.
+Development branches may contain source-only runtime experiments. They are not supported installation paths until they appear in an npm dist-tag and the runtime guide.
 
-## Multi-Agent Collaboration
+## What it provides
 
-Create a second node:
+- **CommHub** — MCP, REST, SSE task delivery, authentication, networks, and audit state.
+- **Agent Node** — long-running workers backed by the selected runtime.
+- **Dashboard** — topology, chat, tasks, messages, and node health.
+- **CLI** — setup, login, node/project lifecycle, channels, tokens, and diagnostics.
 
-```bash
-anet node create reviewer
-anet node start reviewer
-```
-
-Ask `my-bot`:
-
-```text
-Ask reviewer to review this plan and summarize the risks.
-```
+Runtimes with CommHub tool integration can discover peers and delegate work with tools such as `get_all_status`, `send_task`, and `get_task`. Replies and ordinary messages do not recursively invoke another model; see the [task lifecycle](https://anet.sh/concepts/task-lifecycle).
 
-The first agent can discover peers with `get_all_status`, delegate work with `send_task`, poll with `get_task`, and integrate the reply. The dashboard Tasks and Messages views show the chain.
+## Security
 
-## LAN Hub
-
-On the hub machine:
-
-```bash
-anet hub start --host 0.0.0.0
-```
-
-On another machine:
-
-```bash
-npm install -g @sleep2agi/agent-network
-anet init --hub http://<HUB-LAN-IP>:9200
-anet login --username admin --password anethub
-anet node create remote-bot
-anet node start remote-bot
-```
-
-Do not expose the hub directly to the public internet without a reverse proxy, HTTPS, firewall rules, and reviewed auth settings.
-
-## Runtimes
-
-| Runtime | Use When | Notes |
-|---|---|---|
-| `claude-code-cli` | You want Claude Code CLI sessions and channel support | Uses Claude Code process; supports stable `COMMHUB_RESUME_ID` in recent previews |
-| `claude-agent-sdk` | You want Anthropic-compatible API providers | Good default for provider presets |
-| `codex-sdk` | You want Codex-backed nodes | Useful as a backup runtime when Claude quota is constrained |
-| `grok-build-acp` | You want Grok Build through `grok agent stdio` | Requires Grok Build CLI auth; stable for receive/reply, session persistence, and explicit `send_task` delegation |
-
-### Grok Build ACP
-
-`grok-build-acp` uses the local Grok Build CLI via Agent Client Protocol (ACP). Install and authenticate Grok first:
-
-```bash
-curl -fsSL https://x.ai/cli/install.sh | bash
-grok
-```
-
-Create and start a node:
-
-```bash
-anet node create grok-demo --runtime grok-build-acp
-anet node start grok-demo
-```
-
-Look for:
-
-```text
-runtime: grok-build-acp
-SSE connected
-```
-
-Stable support:
-
-- Receive CommHub tasks through SSE.
-- Run one Grok Build ACP turn per task.
-- Persist `grokSession` into `.anet/nodes/<name>/config.json`.
-- Resume the saved Grok session on the next task.
-- Reply to the original sender through CommHub.
-- Explicit delegation such as `给 A站助手 发任务: ...` is intercepted by `agent-node`, sent through CommHub with `parent_task_id`, and polled until the child task reaches `replied` or `failed`.
-
-Current boundary:
-
-- Grok native MCP tool injection is not the stable path yet.
-- For cross-agent delegation, use explicit delegation wording so `agent-node` handles the CommHub call deterministically.
-- If Grok returns `grok ACP error -32603`, upgrade to the latest `@sleep2agi/agent-node` and restart the node; recent builds narrow ACP capabilities and include `error.data` diagnostics.
-
-Details: `docs/grok-build-runtime.md`.
-
-## Provider Presets
-
-`anet node create` writes the correct provider environment into `.anet/nodes/<name>/config.json`.
-
-| Provider | Status | Notes |
-|---|---|---|
-| Anthropic | verified path | Native Anthropic Messages API |
-| MiniMax | verified path | Anthropic-compatible endpoint |
-| DeepSeek | verified path | Anthropic-compatible endpoint |
-| GLM / Zhipu | verified path | Anthropic-compatible endpoint |
-| Kimi / Moonshot | verified path | Anthropic-compatible endpoint |
-| OpenRouter | available | Anthropic-compatible routing |
-| Custom | available | Provide base URL, model, and token |
-
-## Common Commands
-
-```bash
-# Hub and dashboard
-anet hub start
-anet hub dashboard
-
-# Auth
-anet register
-anet login --username <user> --password <password>
-anet logout
-anet whoami
-anet passwd
-
-# Nodes
-anet node create <name>
-anet node start <name>
-anet node start --all
-anet node stop <name>
-anet node resume <name>
-anet node rename <old> <new> --force
-anet node delete <name>
-anet node ls
-anet info <name>
-anet logs <name>
-
-# Network status and repair
-anet status
-anet tasks [status]
-anet doctor
-anet doctor --fix
-
-# Project and session helpers
-anet init --hub <url>
-anet init project
-anet project up
-anet project restart
-anet project down
-anet session ls
-
-# Channels and upgrades
-anet channel add telegram <name> --bot-token <tok> --allow <uid>
-anet channel add feishu   <name> --app-id <id> --app-secret <secret> --allow <open-id>   # see docs/feishu-quickstart.md
-anet channel ls
-anet upgrade
-anet upgrade --channel preview --dry-run
-
-# Batch / demos
-anet create --batch
-anet batch list
-anet batch stop <prefix>
-anet demo sci-team
-```
-
-## Configuration Files
-
-```text
-~/.anet/config.json
-  Global CLI profile: hub URL, user token, default network.
-
-~/.anet/server/admin-utok.json
-  Local bootstrap admin token for the hub.
-
-{project}/.anet/nodes/<name>/config.json
-  Per-node runtime, model, provider env, node token, channels, and session IDs.
-```
-
-Example node config:
-
-```json
-{
-  "node_id": "n_a1b2c3d4",
-  "node_name": "my-bot",
-  "alias": "my-bot",
-  "hub": "http://127.0.0.1:9200",
-  "network_id": "default",
-  "token": "ntok_...",
-  "runtime": "claude-agent-sdk",
-  "model": "your-model",
-  "channels": ["server:commhub"],
-  "tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
-  "env": {
-    "ANTHROPIC_BASE_URL": "https://example.com/anthropic",
-    "ANTHROPIC_AUTH_TOKEN": "sk-..."
-  },
-  "flags": {
-    "dangerouslySkipPermissions": true,
-    "teammateMode": "in-process",
-    "maxTurns": 50
-  }
-}
-```
-
-Do not commit `.anet/` or provider API keys.
-
-## Security Notes
-
-- The hub binds to `127.0.0.1` by default.
-- LAN mode is explicit: `anet hub start --host 0.0.0.0`.
-- Node tokens are network-scoped `ntok_` tokens; user tokens are `utok_`.
-- Keep API keys in local node config or env refs; never paste real keys into issues or docs.
-- Treat tmux / terminal streaming features as local-admin tools.
-
-## What Is Stable vs Experimental
-
-Stable day-to-day path:
-
-- `anet hub start` / `anet hub stop` / `anet hub status` (v0.10.11+: SIGTERM → 3s grace → SIGKILL stop; status shows PID + port + `/health` version — no more manual `lsof+kill`)
-- `anet hub dashboard`
-- `anet login`
-- `anet node create/start/stop/delete/rename`
-- `anet node start --all`
-- `anet project up/restart/down`
-- Dashboard chat, task list, topology, and status views
-
-Actively evolving:
-
-- IM platform integration (Feishu / Slack / WhatsApp / WeCom)
-- Telegram channel binding
-- Advanced dashboard topology edges
-- Batch orchestration and science-team demos
-- Codex runtime expansion
-- Grok Build ACP runtime
-- Cross-version rename hot-reload
+The default Hub is local-only. Before exposing it beyond localhost, change the initial password and follow the [production deployment guide](https://anet.sh/deploy/production). Do not copy `.anet` node configs between machines: they contain network-bound identity and token material.
 
 ## Documentation
 
-- Docs site: https://anet.sh
-- Getting started: https://anet.sh/guide/getting-started
-- Preview guide: https://anet.sh/guide/preview/getting-started
-- Issues: https://github.com/sleep2agi/agent-network/issues
-
-## Repository Layout
-
-This package lives in the `agent-network/` subdirectory of the monorepo:
-
-```text
-agent-network/
-  bin/cli.ts           anet CLI
-  src/client.ts        SDK client
-  src/node-server.ts   CommHub MCP server bridge used by claude-code-cli
-  src/im/              IM integration contracts and future adapters
-```
-
-Related packages live next to it:
-
-```text
-server/                @sleep2agi/commhub-server
-agent-node/            @sleep2agi/agent-node
-docs-site/             anet.sh documentation site
-```
-
-## License
+- [Getting started](https://anet.sh/guide/getting-started)
+- [CLI reference](https://anet.sh/guide/cli)
+- [Runtime guide](https://anet.sh/guide/runtimes)
+- [Tokens and permissions](https://anet.sh/concepts/tokens)
+- [Troubleshooting](https://anet.sh/troubleshooting)
+- [GitHub repository](https://github.com/sleep2agi/agent-network)
 
-Apache-2.0
+Apache-2.0.

package/dist/bin/anet.cjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/* eslint-disable */
+// anet 的 bin 入口垫片 —— 唯一职责:在【解析真正的 ESM 入口之前】把 Node 版本讲清楚。
+//
+// 🔴 为什么必须是 CJS,而且必须是手写不进构建:
+//
+//   dist/bin/cli.js 是 ESM(package.json 里 type: module),而且经 javascript-obfuscator
+//   处理过。老 Node 读到它的第一行 `import{createRequire}from'node:module'` 就抛
+//
+//       SyntaxError: Unexpected token {
+//
+//   ——**在任何一行代码执行之前**。cli.ts 里那个 checkNodeVersion()（required "22.13.0"）
+//   写在同一个文件里,所以它永远轮不到跑。**一个写在 ESM 里的版本检查,救不了一个
+//   连 ESM 都解析不了的 Node。**
+//
+//   用户实际看到的是一屏混淆后的代码 + SyntaxError,完全指不到真因。
+//   （2026-08-18 现场:Node 10/12 世代的栈,`internal/bootstrap/node.js`、
+//    `Function.Module.runMain`、`loader.js:723`。）
+//
+//   package.json 的 engines.node>=22.13.0 也不拦:npm 默认 engine-strict=false,
+//   那只是安装时的一句警告。
+//
+// 🔴 本文件的写法约束(违反其中任何一条,垫片自己就会在同一个地方炸):
+//   - 只用 ES5 语法:var / function / 字符串拼接。不用 const/let、箭头函数、
+//     模板串、可选链(?.)、空值合并(??)。
+//   - **不能出现字面量的 `import(...)`** —— 动态 import 是 Node 12.17+ 才能【解析】的
+//     语法,老 Node 在解析阶段就会失败。所以用 new Function 把它推迟到调用时再解析,
+//     而调用只发生在版本检查通过之后。
+//   - 不进 bun build,不进 obfuscator。构建里只 cp 过去。
+
+// 🔴 两个阈值，回答两个不同的问题。把它们合成一个，就是我 2026-08-18 犯的错:
+//
+//   PARSE_FLOOR = 16.0.0   「这个 Node 能不能**加载**入口?」
+//       低于它，dist/bin/cli.js 的第一行 `import{createRequire}from'node:module'`
+//       连解析都过不去(ESM 语句需要 Node>=12;`node:` 前缀需要 >=14.18/16)。
+//       这时**必须硬退**，因为再往下没有任何一行自己的代码能跑。
+//
+//   SUPPORTED = 22.13.0    「这个 Node 是不是受支持的版本?」
+//       这是 package.json engines 声明的下限，而产品对它的既有立场是
+//       **警告并继续** —— cli.ts 的 checkNodeVersion() 只在 `anet upgrade` 里
+//       打一行 "Continuing anyway"。
+//
+// 🔴 第一版我用 SUPPORTED 做硬退，直接把 e2e 打红了:CI 镜像跑的是 Node 20
+//    (tests/Dockerfile 里 setup_20.x)，5 个 suite 当场全灭。
+//    **垫片不该比产品自己的立场更严** —— 它的职责是把「解析不了」这件事讲清楚，
+//    不是顺手收紧支持策略。那是另一个决定，要单独做。
+var PARSE_FLOOR = '16.0.0';
+var SUPPORTED = '22.13.0';
+
+function parts(v) {
+  var a = String(v).split('.');
+  return [parseInt(a[0], 10) || 0, parseInt(a[1], 10) || 0, parseInt(a[2], 10) || 0];
+}
+
+function gte(a, b) {
+  return a[0] > b[0]
+    || (a[0] === b[0] && a[1] > b[1])
+    || (a[0] === b[0] && a[1] === b[1] && a[2] >= b[2]);
+}
+
+var cur = parts(process.versions.node);
+
+if (!gte(cur, parts(PARSE_FLOOR))) {
+  console.error('');
+  console.error('  \u274c anet 无法在 Node ' + process.versions.node + ' 上启动。');
+  console.error('');
+  console.error('     它的入口是 ESM，而这个版本的 Node 连解析都做不到 —— 没有垫片的话，');
+  console.error('     你看到的会是一屏代码加一句 SyntaxError，而真因是版本。');
+  console.error('');
+  console.error('     升级 Node（任选其一）:');
+  console.error('       nvm install 22 && nvm use 22');
+  console.error('       curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs');
+  console.error('');
+  console.error('     然后: node -v && anet -v');
+  console.error('');
+  process.exit(1);
+}
+
+if (!gte(cur, parts(SUPPORTED))) {
+  // 警告不退出 —— 与 cli.ts 的既有立场一致。走 stderr，不污染任何解析 stdout 的调用方。
+  console.error('[anet] \u26a0 Node ' + process.versions.node + ' 低于受支持的 >=' + SUPPORTED
+    + '；能跑，但不保证。升级: nvm install ' + SUPPORTED.split('.')[0]);
+}
+
+var path = require('path');
+var url = require('url');
+var entry = path.join(__dirname, 'cli.js');
+
+// 🔴 把 argv[1] 指回真入口。cli.ts 有多处用 process.argv[1] 推自身位置
+// （:792 resolve(argv[1])、:1094-1095 join(argv[1],'..','..')、:4445）。
+// 不改的话 argv[1] 会变成本垫片的路径 —— 同目录，多数推导仍成立，
+// 但"多数成立"不是"成立"，直接指回去让行为逐字不变。
+process.argv[1] = entry;
+
+// 见上:不能写字面量 import()。
+var dynamicImport = new Function('u', 'return import(u);');
+dynamicImport(url.pathToFileURL(entry).href).catch(function (e) {
+  console.error('[anet] 无法加载 ' + entry);
+  console.error(e && e.stack ? e.stack : e);
+  process.exit(1);
+});

package/dist/bin/cli.d.ts

@@ -11,3 +11,4 @@
  */
 import { normalizeRuntime, type RuntimeName } from "../src/normalize-runtime";
 export { normalizeRuntime, type RuntimeName };
+export declare const OPENCODE_PINNED_VERSION = "1.18.1";