Skip to content

Releases

Runtime-v2.13.1

Choose a tag to compare

@zerone-agent zerone-agent released this 17 Nov 07:03
8c3d91d

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

Choose a tag to compare

@zerone-agent zerone-agent released this 16 Nov 02:27
ff4001a

✨ 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 实测记录评论)

📦 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

Choose a tag to compare

@zerone-agent zerone-agent released this 03 Nov 11:30
e7adb04

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 侧编排而非 SDK importLegacyArchive——后者对 readdir 失败静默返回全零报告,无法区分「源不可读」与「无事可导」)
    • 文档:docs/configuration.md「Session storage → v3 → v4 migration」补用法、幂等/失败语义与退出码契约

🔧 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

Choose a tag to compare

@zerone-agent zerone-agent released this 03 Nov 09:17
63797f7

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

Choose a tag to compare

@zerone-agent zerone-agent released this 02 Nov 05:41
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

Runtime-v2.10.0

Choose a tag to compare

@zerone-agent zerone-agent released this 02 Nov 05:55
7f183b2

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") 注入 SDK appendPrompt(双浅拷贝隔离并发 run 与 cron resolveOptions() 共享的 stored opts)
    • 最终系统提示词顺序(SDK 语义,runtime 不重组):base prompt(systemPrompt/systemPromptFile + datasets)→ env 块(env/skills/subagents/deferred tools/AGENTS.md)→ append(配置级 + 请求级)
    • 校验:非 string → 400;"" / null → 视为缺省。实现为追加式,与 systemPrompt/systemPromptFile 不互斥
  • #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

Choose a tag to compare

@zerone-agent zerone-agent released this 21 Oct 15:10
c301ac2

✨ Features

  • #77 支持**推理强度(reasoning effort)**配置(Closes 需求:runtime 侧 A 档):
    • agents.yaml 根级新增 effort 字段:预置 low / medium / high / xhigh / max,自定义值原样透传给 provider(Anthropic output_config.effort、OpenAI reasoning_effort)
    • root 级生效,与 thinking 同位:挂载子代理复用 root 进程配置(SDK 子代理 AgentDefinition 无此二字段),child 级值可解析但被忽略
    • SDK→provider 链路本就完整,本版本补齐 runtime schema + buildCreateOpts 透传;+6 测试(含此前零覆盖的 thinking 透传回归网)
    • README / README.zh-CN 配置字段表补 thinking + effort 两行(两字段此前均未文档化)
  • #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

Choose a tag to compare

@zerone-agent zerone-agent released this 08 Sep 04:43
51cf183

🛡️ 生产事故修复

  • #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
    • 失败连接仍缓存;重连/自愈留后续版本
  • 无 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

Choose a tag to compare

@zerone-agent zerone-agent released this 07 Sep 09:39
0c62ef7

🐳 镜像优化

  • #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 全部通过;mirrored apt-get update 成功

⚠️ 部署注意

  • 镜像 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

Choose a tag to compare

@zerone-agent zerone-agent released this 04 Sep 09:18
85f8788

✨ Features

  • #68 采纳 SDK v3.3 DiagnosticsSink 跨 Runtime(Closes #63,四轮 review 零 finding):
    • 新增 src/diagnostics.ts:实例级、可注入的 diagnostics ownership boundary——createRuntime composition 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