Repository navigation
Releases
Runtime-v2.13.1
Runtime 2.13.1
依赖补丁版本:@zerone-agent/agent-sdk ^4.2.1 → ^4.2.2(PR #100)。
🔧 Changes
- thinking=disabled × effort 组合的 Bailian 400 修复(agent-sdk#170 / PR #171):OpenAI 兼容端点(Alibaba Bailian 等)要求
enable_thinking: false时reasoning_effort必须为'none',此前 SDK 同时发送两者被拒——agents.yaml 同时配置thinking: { type: disabled }与effort的用户每轮对话 400,本版端到端修复(reasoning_effort现映射为官方「关闭思考」值'none')。enabled/ 未设 / effort-only 行为不变(上游回归钉住);Anthropic 路径不受影响 - 零 runtime 代码变更(纯依赖 bump,无公共 API / 行为面变化)
📦 Package
- npm:
@zerone-agent/agent-runtime@2.13.1(latest 已核验——registry 权威元数据 + npm view 双口径) - Docker:
zeroneagent/agent-runtime:v2.13.1+:latest(Docker Hub + 华为 SWR 双 registry,digest 一致)
📊 Verification
- PR #100 / #101 CI 双绿;tag
runtime-v2.13.1触发 publish.yml:publish + docker-push 双 success - 门禁:tsc exit 0 / build exit 0 / vitest 715 passed 0 failed
- npm latest=2.13.1 ✅;docker 双 registry digest 一致(
sha256:c7268edf…)✅
Full Changelog: runtime-v2.13.0...runtime-v2.13.1
Runtime-v2.13.0
✨ Features
- #96 MCP 会话级身份透传至 hub MCP 端点(session-level identity passthrough)
🐛 Fixes / Deps
- #98 bump
@zerone-agent/agent-sdk→ ^4.2.1:携带 agent-sdk#167 修复——「关闭思考」全链路生效:- agents.yaml
thinking: {type: disabled}不再被 SDK 三层静默丢弃 - Anthropic 兼容端点 →
thinking:{type:'disabled'};OpenAI 兼容端点 → 顶层enable_thinking:false双发 - 双端真实实测通过(qwen3.8-flash 四组对照:disabled 组响应 0 个 thinking/reasoning 块、答案仍正确、无 400——见 #97 实测记录评论)
- agents.yaml
📦 Package
- npm:
@zerone-agent/agent-runtime@2.13.0(latest 已核验) - Docker:
zeroneagent/agent-runtime:v2.13.0+:latest(Docker Hub + SWR 双 registry,publish 双 job success)
⚠️ 部署注意
- 测试环境「关闭思考」生效路径(#97 checklist 2 完成):hub 测试环境(v2.24.0-rc + deployer v3.2.0)替换
AGENT_DEPLOYER_RUNTIME_IMAGE为:v2.13.0+ 重部署 Agent 即生效,hub/deployer 零改动 - #96 身份透传与 #98 SDK bump 均为向后兼容;无配置迁移
📊 Verification
- 发版门禁:origin/main detached worktree 全量复刻(npm ci / tsc / vitest 715+48 / build)✅
- release PR #99 CI 双绿;publish.yml 双 job success;npm latest=2.13.0 ✅
Full Changelog: runtime-v2.12.0...runtime-v2.13.0
Runtime-v2.12.0
Runtime 2.12.0
新增 import-legacy-sessions CLI 命令(PR #93,Closes issue #88)——SDK v4 存储迁移(2.11.0)后遗留的 v3 会话档案,现在可以显式、幂等地一次性导入新 store。
✨ Features
zerone-agent import-legacy-sessions --from <dir> [--config <dir>] [--json]:- opt-in 一次性迁移:不做启动时自动迁移——受影响面为持久 HOME 的裸机部署(Docker 容器内 v3 档案随容器重建已丢);
--from显式给定源目录,规避 HOME 漂移(不猜测当前/历史 HOME) - 三态编排(SDK
importLegacySession,issue #131 P3):imported / already-exists-unknown / not-imported——目标已有 transcript 的会话自动跳过,幂等可重跑 - 失败语义:not-imported 项(档案缺失/畸形 JSON/metadata.id 不匹配/todos 阻断)零提交——修复档案后重跑即恢复;命令体 try/catch 收敛失败面,不污染入口错误
- 退出码契约(脚本化迁移可依赖,docs 已载):
0= 全部 imported/已存在;1= 存在 not-imported 或命令失败;2=--from缺失或非已存在目录 - 源预检 + 杂项过滤:
--from不存在/非目录 → USAGE(不与真实空目录混淆);.DS_Store等非目录条目不进报告、不翻转退出码 - v3 metadata 保真:
cwd/model等 v4 原生写入恒空的字段,经导入路径保留 - 编排细节:per-session
importLegacySession循环 +readdir withFileTypes(runtime 侧编排而非 SDKimportLegacyArchive——后者对 readdir 失败静默返回全零报告,无法区分「源不可读」与「无事可导」) - 文档:
docs/configuration.md「Session storage → v3 → v4 migration」补用法、幂等/失败语义与退出码契约
- opt-in 一次性迁移:不做启动时自动迁移——受影响面为持久 HOME 的裸机部署(Docker 容器内 v3 档案随容器重建已丢);
🔧 Changes
- 无公共 API 破坏:
runCli接受新子命令(纯增量);会话 REST/存储行为不变
📦 Package
- npm:
@zerone-agent/agent-runtime@2.12.0(latest 已核验) - Docker:
zeroneagent/agent-runtime:v2.12.0+:latest(Docker Hub + 华为 SWR 双 registry,digest 一致)
📊 Verification
- PR #93 两轮评审全过(首评 1 阻塞 + 2 重要 + 11 建议 → 全部闭环核验,二轮无遗留)
- 门禁:tsc exit 0 / build exit 0 / vitest 677 passed 0 failed(legacy-import 15 项钉用例)
- PR #93 / #94 CI 双绿;publish.yml publish + docker-push 双 success
- npm registry 权威元数据 latest=2.12.0 ✅;docker 双 registry digest 一致(
sha256:3c55d4ea…)✅
Full Changelog: runtime-v2.11.1...runtime-v2.12.0
Runtime-v2.11.1
Runtime 2.11.1
移除 agent-sdk#158 的 Runtime 侧 workaround(PR #91,Closes #87):上游修复 agent-sdk#161「fix(agent): register the session before the engine loop」 已随 @zerone-agent/agent-sdk 4.1.2 发布,fresh-session 上 mid-query Task/MultiTask spawn 的 register 协议时序缺陷由 SDK 自身保证,Runtime 回归普通 WriteCoordinator。
⚠️ 依赖升级携带的子代理行为 delta(SDK 4.1.0 → 4.1.2)
^4.1.0 语义上本就允许 4.1.2,锁 pin 使其随本版生效。所有 spawn 子代理的行为对下游可见地变化:
- spawn 子池移除
AskUserQuestion(SDK #154)与TodoWrite(SDK #159)——子代理不再能向用户提问、不再有共享 todo 平面 - 附带 no-questions 系统提示(SDK #155):子代理遇歧义时自行假设,并在最终报告中说明本应询问的内容
依赖子代理提问/todos 能力的下游需评估(root Agent 自身的 AskUserQuestion/TodoWrite 不受影响,仅 spawn 子池)。
🔧 Changes
- #91 依赖
@zerone-agent/agent-sdk^4.1.0→^4.1.2;删除OwnershipRootPreRegisteringCoordinator(session-store.ts回归普通WriteCoordinator,createSessionInfrastructure形状不变,registry 注入面零改动) - #91 测试重钉:
sdk-subagent-spawn-integration.test.ts(真实 Task spawn 走普通 coordinator 端到端,注入被丢必红)承担 runtime 侧守护;session-store.test.ts删除(包装类没了,store 协议由 SDK conformance 覆盖);getter 装配(hub-push/router/index惰性 manager)确认未受影响 - 无 runtime 公共 API 变化——patch 版本号
📦 Package
- npm:
@zerone-agent/agent-runtime@2.11.1(latest 已核验) - Docker:
zeroneagent/agent-runtime:v2.11.1+:latest(Docker Hub + 华为 SWR 双 registry,digest 一致)
📊 Verification
- PR #91 两轮评审全过(首评 2 重要 + 4 建议 → 全部闭环核验);移除前做过基线对照(wrapper 在位 + 4.1.2 双注册幂等)
- 门禁:tsc exit 0 / build exit 0 / vitest 662 passed 0 failed
- PR #91 / #92 CI 双绿;publish.yml publish + docker-push 双 success
- npm latest=2.11.1 官方 registry 核验 ✅;docker 双 registry digest 一致(
sha256:dec53aae…)✅
Full Changelog: runtime-v2.11.0...runtime-v2.11.1
Runtime-v2.11.0
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
Runtime-v2.10.0
Runtime 2.10.0
补建说明:本 tag(
7f183b2)当时已完成 npm + Docker 发布,但 GitHub Release 未创建(发布列表停留在 Runtime-v2.9.0)。现补齐,内容按 tag 实际范围(runtime-v2.9.0...runtime-v2.10.0)整理。当前latest已由 Runtime-v2.11.0 接任。
✨ Features
- #81 支持 appendSystemPrompt(配置级 + 按次注入):
- agents.yaml 根级新增
appendSystemPrompt(可选,min 1):root 与挂载子代理均生效(随 SDK 子代理定义的appendPrompt下发) - Run 请求体新增
appendSystemPrompt(可选):仅本次 run 生效、不持久化、不被 Task/MultiTask 子代理继承;cron 触发的 run 携带配置级值 - 合成规则:
[配置级, 请求级].filter(Boolean).join("\n\n")注入 SDKappendPrompt(双浅拷贝隔离并发 run 与 cronresolveOptions()共享的 stored opts) - 最终系统提示词顺序(SDK 语义,runtime 不重组):base prompt(systemPrompt/systemPromptFile + datasets)→ env 块(env/skills/subagents/deferred tools/AGENTS.md)→ append(配置级 + 请求级)
- 校验:非 string → 400;
""/null→ 视为缺省。实现为追加式,与systemPrompt/systemPromptFile不互斥
- agents.yaml 根级新增
- #82 示例与文档:新增
examples/append-system-prompt/,examples 索引补齐(7/7)
🔧 Changes
- #84 publish workflow 幂等重发守卫:版本已在 registry 时跳过 npm publish(重跑安全)
📦 Package
- npm:
@zerone-agent/agent-runtime@2.10.0(已发布核验;当前 latest 为 2.11.0) - Docker:
zeroneagent/agent-runtime:v2.10.0+:latest(Docker Hub + 华为 SWR 双 registry;latest 现由 2.11.0 接任)
📊 Verification
- publish workflow(tag
runtime-v2.10.0)publish + docker-push 双 success ✅ - npm registry 2.10.0 可见 ✅;PR #81/#82/#84 CI 绿 ✅
Full Changelog: runtime-v2.9.0...runtime-v2.10.0
Runtime-v2.9.0
✨ Features
- #77 支持**推理强度(reasoning effort)**配置(Closes 需求:runtime 侧 A 档):
- agents.yaml 根级新增
effort字段:预置low/medium/high/xhigh/max,自定义值原样透传给 provider(Anthropicoutput_config.effort、OpenAIreasoning_effort) - root 级生效,与
thinking同位:挂载子代理复用 root 进程配置(SDK 子代理 AgentDefinition 无此二字段),child 级值可解析但被忽略 - SDK→provider 链路本就完整,本版本补齐 runtime schema +
buildCreateOpts透传;+6 测试(含此前零覆盖的 thinking 透传回归网) - README / README.zh-CN 配置字段表补
thinking+effort两行(两字段此前均未文档化)
- agents.yaml 根级新增
- #78 仓库工程配置:issue tracker / triage labels / domain docs(消费者无感)
📦 Package
- npm:
@zerone-agent/agent-runtime@2.9.0(latest 已核验) - Docker:
zeroneagent/agent-runtime:v2.9.0+:latest(Docker Hub + SWR 双 registry,base 为 node:22-bookworm-slim 同 2.8.x)
⚠️ 说明
- 端到端生效范围:本版 runtime 支持 agents.yaml 直配立即生效。hub 配置 UI / deployer 透传链路尚未打通(agent-hub#226、agent-deployer#22 已登记跟踪)
- 发布过程记录:首跑 publish 因 npm
NPM_TOKEN过期被拒(404 系 npm 对无写权限的伪装响应),更新 token 后 rerun 双 job 成功;registry 无半发布状态
📊 Verification
- 发版门禁:origin/main detached worktree 全量复刻(npm ci / tsc / vitest / build)✅
- 全量 634 passed + 48 skipped ✅;PR #77/#79 CI 双绿;#77 两轮 review 闭环(零阻塞)✅
- rerun 后 publish + docker-push 双 success;npm latest=2.9.0 ✅
Full Changelog: runtime-v2.8.2...runtime-v2.9.0
Runtime-v2.8.2
🛡️ 生产事故修复
- #74 fix(mcp):MCP 连接失败改为逐 server 降级(Closes #73):
- 修复:单个远程 MCP 连不上(key 失效 / 对端宕机 / 网络抖动)以前把整条 Agent 标
unavailable、chat 全 503——现在 Agent 保持ready,仅该 server 的工具剔除 - detail 透出:
McpServerSummary新增error?(脱敏原因)+ 原connectionStatus: "error";真·坏配置(prompt/skills/customTools)仍unavailable(gate 不变) - subagent 级联语义:降级 child 照常挂载,只有真坏 child 才牵连 parent
- 失败连接仍缓存;重连/自愈留后续版本
- 修复:单个远程 MCP 连不上(key 失效 / 对端宕机 / 网络抖动)以前把整条 Agent 标
- 无 API/配置变更;镜像随版本重建(base 与 2.8.1 相同,node:22-bookworm-slim)
⚠️ 部署注意
- 本版为生产修复:推荐更新。现有 agent 容器需重建(recreate)拉取
:2.8.2镜像生效 - 更新后验证点:详情接口应显示死 MCP
connectionStatus:"error"+ error 原因,Agent 状态ready,chat 正常
📊 Verification
- 全量 628 passed + 48 skipped ✅;CI lint/test 全绿;review 零 finding ✅
- publish.yml 双 job success;npm latest = 2.8.2 ✅
Full Changelog: runtime-v2.8.1...runtime-v2.8.2
Runtime-v2.8.1
🐳 镜像优化
- #71 Docker 镜像 base 迁移:
ubuntu:26.04→node:22-bookworm-slim(Closes #4,R1 P2 修复闭环):- 体积 829MB → 565MB(-32%):删除 apt nodejs/libnode 层(官方镜像自带 Node 22 + npm 10),bun 装后清
~/.npm缓存 - apt 国内源适配 Debian 12(deb822
debian.sources),sed + grep 断言 +apt-get update构建门禁(切源失效即构建失败) - 构建期保持官方源(GHA runner 在美国),国内镜像仅运行时生效(PR #70 策略延续)
- 实测:容器内 runtimes / sharp(glibc)/
/health全部通过;mirroredapt-get update成功
- 体积 829MB → 565MB(-32%):删除 apt nodejs/libnode 层(官方镜像自带 Node 22 + npm 10),bun 装后清
⚠️ 部署注意
- 镜像 base 已变更:现有 agent 容器必须重建(recreate,非 restart)拉取
:2.8.1镜像才生效 - 容器内 Python 3.14 → 3.11(Debian 12 bookworm 系统版本):依赖 Python ≥3.12 特性的 agent 脚本需重新评估
- npm 包本体零代码变化(
@zerone-agent/agent-runtime@2.8.1为同一代码,仅镜像产物更新)
📊 Verification
- 构建+验证 run 全绿:
apt-get update(mirrored)✅、容器内URIs正确 ✅、565MB ✅、smoke×3 ✅;CI lint/test ✅ - publish.yml 双 job success;npm latest = 2.8.1 ✅
Full Changelog: runtime-v2.8.0...runtime-v2.8.1
Runtime-v2.8.0
✨ Features
- #68 采纳 SDK v3.3
DiagnosticsSink跨 Runtime(Closes #63,四轮 review 零 finding):- 新增
src/diagnostics.ts:实例级、可注入的 diagnostics ownership boundary——createRuntimecomposition root 解析同一个 sink 实例(identity 贯穿,无进程全局可变状态、不 monkey-patch console) - 三边界注入:root Agent(
AgentOptions.logger,SDK 贯穿 provider/hooks/MCP/skills 并由 Task/MultiTask 继承到 subagent)→ Registry MCP 物化(connectMCPServer第 4 参)→ Cron(createDefaultCronService({ diagnostics }),尊重 SDK 对onDiagnostic的优先级) CreateRuntimeOptions.diagnostics?注入点(测试/嵌入方如 agent-deployer 可用);index.ts公共导出面只保留DiagnosticsSink类型cause保持原始对象仅供宿主受控消费,永不打印/序列化;安全摘要走 SDK 脱敏fields- 15 个行为级测试(真实 SDK 无 mock):cron torn-tail replay、event-sink failure 带 cause 分离、MCP retry 诊断、subagent 实启继承 construction sink、query logger 引擎通道接管不重绑、console 实际输出等级门控
- 新增
📦 Package
- npm:
@zerone-agent/agent-runtime@2.8.0(latest) - Docker:
zeroneagent/agent-runtime:2.8.0/:latest(Docker Hub + SWR)
📊 Verification
tsc --noEmit+ 626 passed / 48 平台条件跳过(674 total)✅npm run build✅;CI lint/test 全绿;四轮 review 零 finding ✅- publish.yml 双 job success;npm latest = 2.8.0 ✅
Full Changelog: runtime-v2.7.1...runtime-v2.8.0