v0.10.0 Release Notes — Direct Runtime + Observability Foundations
v0.10.0 → v0.10.8 全 chain LIVE（2026-05-16/05-17）：4 包通过 npm
latesttag ship ——@sleep2agi/agent-network@2.2.6（v0.10.7 codex-sdk batch yolo parity + v0.10.6 anet upgrade Option B detached + batch wizard silent-exit 修 + v0.10.5 batch wizard 双修 + v0.10.4 anet upgrade UX + v0.10.3 codex preset + v0.10.1 PINNED hotfix）/@sleep2agi/agent-node@2.4.2（v0.10.3 codex-sdk gpt-5.5 + yolo flags / v0.10.2 Hero A host disk telemetry）/@sleep2agi/commhub-server@0.8.2（v0.10.0 守护节点 endpoints + #142 schema align）/@sleep2agi/agent-network-dashboard@0.5.3（v0.10.8 Servers 面板 UI 文案修 + R502 TopoGraph density tier polish + v0.10.4 orphan-band cluster + v0.10.2 Hero D 拓扑前缀标签 + disk render + 100+ 轮 polish R317-R438）。完整变更见 changelog。
✅ v0.10.8 stable 全 4 包 ship 完（含 v0.10.0 Phase 1+2 + v0.10.1 PINNED hotfix + v0.10.2 Hero A+D + v0.10.3 codex preset + v0.10.4 dashboard orphan-band + v0.10.5 batch wizard 双修 + v0.10.6 anet upgrade Option B + v0.10.7 codex-sdk batch yolo parity + v0.10.8 Dashboard Servers UI 文案修 + R502 density tier polish）
本页作为 v0.10.0 release 速览页保留。安装 / 升级：
npm install -g @sleep2agi/agent-network@latest # 安装
anet upgrade # 升级 + 重启项目（拉 dashboard 0.5.0 + 其余 3 包）🎯 主题
v0.7 → v0.9.2 累积 11 release、5 P0 chain（#135-#139）暴露 runtime 架构债。v0.10.0 主题是 治本 —— runtime 架构债（codex-sdk wrapper bypass）+ observability 基础（守护节点 scaffold + per-agent token 统计）。为 v0.11.0 多厂商 AI Agent 社会 24/7 直播打地基。
Stable 版本（Phase 1 + Phase 2 全 ship）
| 包 | latest |
|---|---|
@sleep2agi/agent-network | 2.2.4 ✅（v0.10.5 batch wizard 双修 + v0.10.4 anet upgrade UX + v0.10.3 codex preset + v0.10.1 PINNED hotfix） |
@sleep2agi/agent-node | 2.4.2 ✅（v0.10.3 codex-sdk gpt-5.5 + yolo / v0.10.2 Hero A disk） |
@sleep2agi/commhub-server | 0.8.2 ✅ |
@sleep2agi/agent-network-dashboard | 0.5.3 ✅（v0.10.8 Servers 面板 UI 文案修 + R502 density tier polish + v0.10.4 orphan-band + v0.10.2 Hero D + disk render + 100+ polish） |
3 Hero P0
Hero 1 — 服务器健康监测（#99 Phase 1）
per-server daemon scaffold，监测层 only。新增 endpoint：
GET /api/server/:host/health— CPU / mem / disk / process 健康指标- 历史表
agent_telemetry（commhub-server schema migration 首次 boot 自动创建，retention 策略 preview.N 内回退确认）
Dashboard 集成：ServersDrawer (#119) 加 "服务器健康" tab。控制层（kill / restart / redeploy）留 v0.11.0。
Hero 2 — Agent list per server（#99 endpoint family）
GET /api/server/:host/agents— agent list per server + 历史 telemetry
跟 Hero 1 同 endpoint family，同期 ship。给 dashboard 渲染每台机器上的活跃 agent 列表 + per-agent 健康指标。
Hero 3 — Dashboard 网络节点前端展示升级（0.5.0 8/8 surface ✅）
dashboard 0.5.0 完整 ship 8 个 surface：
| § | surface | 注 |
|---|---|---|
| §3.A | prefix-group fix | Vincent #1 catch |
| §3.B | sweep retire | 旧 sweep 路径并入 grid |
| §3.C | recent-panel hide | — |
| §3.D | grid default view | 默认网格视图 |
| §3.E | hover detail card | — |
| §3.F | server-health ring tint | 接 #99 endpoint |
| §3.G | fullscreen mode | — |
| §3.I | canvas brand mark | — |
§3.H 砍（per RFC Q2 review）。
随包附 19+ 轮 typography + 圆角级联 polish（R317-R337+，4 typography family + corner radius cascade 系统化重整）。
配套 P0 — Per-agent process telemetry（#142）
preview.1 已 ship T2.1
agent-node 每次 commhub_report_status 心跳带上自身进程 telemetry。endpoint shape 跟 Hero 1/2 直接 wire 通。
agent-node 上报字段（per commhub_report_status payload process_telemetry 子对象）：
| 字段 | 取值 | 来源 |
|---|---|---|
rss | bytes | process.memoryUsage().rss |
cpu_pct | % over interval | process.cpuUsage() delta / wall delta |
uptime_seconds | s | process.uptime() |
in_flight_count | int | 计数器，wrap send_task / turn/start，完成 decrement |
零 sysmon 依赖、零特权、零平台特定代码 —— 心跳间隔 sample 后追加到现有 report_status payload。
4 阶段 ship 路线
| Phase | 内容 | Ship 状态 |
|---|---|---|
| T2.1 | agent-node/src/telemetry.ts：心跳间隔采样 → 附加到 report_status payload | ✅ preview.1（@sleep2agi/agent-node@2.3.11-preview.1） |
| T2.2 | commhub-server schema：accept process_telemetry 字段，对齐 T2.1 实际上报 shape | ✅ preview.5（@sleep2agi/commhub-server@0.8.1-preview.5，commit 209cac7） |
| T2.3 | dashboard sidebar / hover card：渲染 telemetry，real-time SSE 更新 | 🟡 preview.N pending |
| T2.4 | Docker + pexpect 链式 smoke：host + agent 双层 telemetry 都干净上报、dashboard 双层渲染 | 🟡 pending T2.3 |
跟 #119 host fields 是 sibling 关系（host 层 step 1 已 ship，agent 层 step 2 现在推进）。
新 runtime 路径：codex-direct-stdio
preview.1 已 ship
@sleep2agi/agent-node@2.3.11-preview.1 — codex app-server stdio direct Phase 1.1-1.4 + AskForApproval enum kebab-case wire convention 修
之前 codex runtime 走 @openai/codex-sdk npm wrapper，wrapper 的 --mcp-config HTTP transport bug 是 #102 hang root cause family。v0.10.0 改成 spawn('codex', ['app-server']) + 最小 stdio JSON-RPC client，bypass wrapper 整个绕过这 family bug，同时拿到完整 67-method v2 protocol surface（thread / turn / item / realtime / 等），不再受 codex-sdk breaking change 牵制。
命名
| 字段 | 值 |
|---|---|
| Runtime ID | codex-direct-stdio |
anet node create --runtime value | codex-direct-stdio |
| Legacy fallback | ANET_CODEX_LEGACY_SDK=1 env var 回到旧 wrapper（safe rollback for preview chain） |
4 Phase ship 路线（per #141）
| Phase | 内容 | Ship 状态 |
|---|---|---|
| 1.1 | vendor codex schema/typescript/v2/ ~50 .ts 文件到 agent-node/src/types/codex/（auto-generated, 零手写） | ✅ preview.0/1 |
| 1.2 | minimal stdio JSON-RPC client ~80 LOC：request/response id 关联 + notification dispatcher (EventEmitter) + -32600 error envelope | ✅ preview.0/1 |
| 1.3 | 改写 agent-node/src/runtime/codex.ts 走直 spawn；map anet task → codex thread/start + turn/start，stream item/agentMessage/delta → anet task update | ✅ preview.0/1 |
| 1.4 | 5+ case Docker + pexpect 真 TTY 链式 smoke：initialize / thread / turn-with-prompt / CollabAgentToolCall ↔ anet send_task / graceful shutdown | ✅ preview.0/1 |
| 1.5 | 历史 #102 hang 场景回归 verify，comment + close #102 / #103 | 🟡 preview.N pending |
用户切换
preview chain 期间，现有 codex node 不自动 migrate。新建节点显式选 codex-direct-stdio：
anet node create --runtime codex-direct-stdio --vendor anthropic ...stable promote 后 codex-direct-stdio 替换成默认 codex runtime，旧 codex-sdk 路径进入 deprecation warning。v0.11.0 计划移除 wrapper 路径。
切回 wrapper（preview 期 safe rollback）
ANET_CODEX_LEGACY_SDK=1 anet node start <codex-node>只针对 preview 阶段；遇 bug 优先按 Issue tracker 上报，不靠 fallback 长期跑生产。
Release 节奏（per methodology §2.0）
| Stage | 状态 |
|---|---|
| 1. Issue 规划 | ✅ #140 |
| 2. preview chain | ✅ agent-node preview.0/1 + commhub-server preview.4/5 含 #141 Phase 1.1-1.4 + #99 endpoints + #142 T2.1/T2.2 |
| 3. clean version promote latest | ✅ 4 包全 ship（agent-network 2.2.0 / agent-node 2.4.0 / commhub-server 0.8.2 / dashboard 0.5.0） |
| 4. GitHub Release v0.10.0 EN + ZH | ✅ shipped v0.10.0（EN + ZH 双段） |
| 5. anet.sh stable docs swap（强制） | ✅ Phase 1 + Phase 2 全 done（CHANGELOG / README / version switcher / 本页 / dashboard 0.5.0 段） |
| 6. post-promote verify + retro | ✅ 4 包 curl verify done（Phase 1 + Phase 2 deploy 6+6 GREEN） |
相关 issue
- #140 — v0.10.0 release tracker
- #141 — codex app-server stdio direct (P0, Track 1)
- #99 — 守护节点 Phase 1 scaffold (P0, Track 2)
- #142 — per-agent process telemetry (P0, Track 2 sibling, T2.1 ✅ preview.1)
- #114 — Agent Token 使用量统计 (P1)
- #119 — ServersDrawer (#99 整合 ref)
- #102 / #103 — 顺带关掉
反馈渠道
preview 阶段 bug / 行为反常：GitHub Discussions。安全相关：Security Advisories。