@sleep2agi/agent-network 2.2.8-preview.0 → 2.2.8

package/README.md

@@ -93,7 +93,7 @@ anet node start my-bot
 
 `anet node create` walks you through:
 
-1. Runtime: `claude-code-cli`, `claude-agent-sdk`, or `codex-sdk`.
+1. Runtime: `claude-code-cli`, `claude-agent-sdk`, `codex-sdk`, or preview `grok-build-acp`.
 2. Provider preset: Anthropic, MiniMax, DeepSeek, GLM, Kimi, OpenRouter, or custom Anthropic-compatible endpoint.
 3. API key and model settings.
 
@@ -149,6 +149,47 @@ Do not expose the hub directly to the public internet without a reverse proxy, H
 | `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` | Engineering preview; requires Grok Build CLI auth, stable for receive/reply and explicit `send_task` delegation |
+
+### Grok Build Engineering Preview
+
+`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 preview 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 preview 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 preview and restart the node; recent builds narrow ACP capabilities and include `error.data` diagnostics.
+
+Details: `docs/grok-build-runtime.md`.
 
 ## Provider Presets
 
@@ -285,6 +326,7 @@ Actively evolving:
 - Advanced dashboard topology edges
 - Batch orchestration and science-team demos
 - Codex runtime expansion
+- Grok Build ACP runtime
 - Cross-version rename hot-reload
 
 ## Documentation