Skip to content

Runtime-v2.11.0

Choose a tag to compare

@zerone-agent zerone-agent released this 02 Nov 05:41
· 10 commits to main since this release
ee3aa82

Runtime 2.11.0

@zerone-agent/agent-sdk 3.3.1 → 4.1.0 升级与 SessionStore v4 迁移(PR #86,三轮评审全过)。核心修复:物化技能根 Agent 调用报 Available skills: none(agent-hub#227 的 Runtime 侧根因,agent-sdk#151)——技能清单可见但执行注册表为空,20 次合成调用全败。升级后技能清单与执行一致,并以真实 SDK 链路回归测试钉死。

💥 Breaking Changes

  1. 会话存储迁移:~/.agents/sessions/<id>/transcript.json(v3)→ <configDir>/.zerone/sessions/sessions.json(v4 FileSessionStore)。旧会话不迁移;resume 旧 session id 现在抛 SessionNotFoundError(v3 是静默新建)。客户端须将未知 sessionId 视为全新 run。
  2. Session 端点行为语义(响应键形状不变):
    • GET /v1/sessions 只列用户(自根)会话;subagent spawn 行与引擎伪会话行持久化但对列表与 by-id 读取/删除均隐藏(404)
    • GET /v1/sessions/:id:metadata.cwd / metadata.model 恒为空(v4 store 不回填,v3 会写);messages 为折叠后模型上下文(压缩后不含压缩前消息),hub 聊天推送同视图
    • DELETE /v1/sessions/:id:未知 id 从 ok: true(v3 force-rm 实现)改为 404;删除主会话级联清除其 subagent 行
  3. Task/MultiTask spawn 依赖 store+coordinator(SDK 4.x 语义):runtime 已在 create()/resolveOptions() 恒注入,服务消费者无感;库消费者直连 createAgent + subAgents 时需自行注入 store,否则 spawn 报 Task requires store + coordinator context。

🔧 Changes

  • #86 依赖升级 + v4 迁移:registry 持有 FileSessionStore + WriteCoordinator + SessionManagerV2(锚定 runtime data root <configDir>/.zerone/sessions,与 cron 同根——一个卷挂载覆盖两者)
  • #86 OwnershipRootPreRegisteringCoordinator(agent-sdk#158 workaround):修复 fresh session 上 mid-query Task/MultiTask spawn 必败的 register 协议时序缺陷(行为单测 + 生产链路集成测试双层钉住;SDK 修复后移除,跟踪于 #87)
  • #86 AgentRegistry.getSessionManager() 新增(公共 API,纯增量);库导出面无破坏(buildSessionPayload/createSessionRouter/HubChatPusher 均非根导出)
  • #86 会话存储/端点文档:README 双语会话描述改写;docs/configuration.md 新增「Session storage」节(落点、卷挂载、单写约束、迁移注意、字段语义)
  • #85 publish workflow dispatch docker tag 规范化(CI chore)
  • 测试:665 passed / 0 failed(新增 sdk-skills-execution-integration / sdk-subagent-spawn-integration 两个真实链路集成测试 + session-store workaround 行为钉用例)

📦 Package

  • npm:@zerone-agent/agent-runtime@2.11.0(latest 已核验)
  • Docker:zeroneagent/agent-runtime:v2.11.0 + :latest(Docker Hub + 华为 SWR 双 registry)

📊 Verification

  • PR #86 三轮评审:首评 5 重要 + 9 建议 → 二轮全落实核验 → 三轮 nit 清零;无遗留阻塞
  • PR #86 / #89 CI 双绿(lint + test);tag runtime-v2.11.0 触发 publish.yml:publish + docker-push 双 success
  • 门禁:tsc exit 0 / build exit 0 / vitest 665 passed
  • npm latest=2.11.0 已核验(官方 registry)

📝 Migration

  • Docker 部署:卷挂载须覆盖 <configDir>/.zerone(sessions 与 cron 数据同根;不挂载则会话 transcript 与 cron 任务随容器重建丢失)
  • 升级前存量会话:不迁移。hub / 客户端持有的旧 session id resume 会失败——按「未知 id = 新 run」处理(importLegacySession 一次性迁移评估已开跟踪 issue #88)
  • hub:DELETE 未知 id 按 404 处理;session 列表/详情字段语义变化见上(hub#227 端到端验证待发版后执行)
  • 库消费者:AgentRegistry 新增 getSessionManager();session router / hub-push 内部装配改惰性 getter,createApp 对外签名不变

Full Changelog: runtime-v2.10.0...runtime-v2.11.0