Repository navigation
Runtime-v2.11.0
·
10 commits
to main
since this release
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
- 会话存储迁移:
~/.agents/sessions/<id>/transcript.json(v3)→<configDir>/.zerone/sessions/sessions.json(v4 FileSessionStore)。旧会话不迁移;resume 旧 session id 现在抛SessionNotFoundError(v3 是静默新建)。客户端须将未知sessionId视为全新 run。 - 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 行
- 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-storeworkaround 行为钉用例)
📦 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