Repository navigation
v0.56.0
This release hardens deterministic provider-failure containment and core queue invariants: non-402 auth and contract failures now persist first-class cooldowns that end unbounded single-candidate defer loops, declared auth-refreshable dispatches are exempted from cooldown fencing so correctable retries go through, and cooldown replans keep their real failure cause instead of a re-selection error. WorkItem source-revision synchronization now covers every queue commit channel behind a same-transaction equality assertion, late WaitFor re-enqueues of terminal replies gain a bounded recovery obligation, timer wait admission becomes revision-atomic, and the snapshot preflight lane gains a FIFO wait queue instead of saturated 503s. Polled HTTP database reads move off tokio workers, ending the whole-process freezes found by the 2026-10-29 stall RCA. Gemini models gain native image input and ViewImage observation with image-part budget accounting, the web GUI hydrates agent detail from conversations while retiring its events API dependency, turn documents advertise only resolvable tool refs, and iOS accepts bare host addresses with an escape hatch during restore. Talent-ops, ASO, and search-visibility steward templates arrive, the video production template gains a pinned motion-prompt skill, and documentation adds a responsive navigation layout plus bilingual agent-ecosystem researcher guides.
Supported binary assets for this release are Linux amd64, macOS amd64, macOS arm64, and Android. The macOS app DMG is a universal binary supporting both x86_64 and arm64. The Linux amd64 binary supports Ubuntu 22.04 or newer (glibc 2.35 or newer). The signed Android APK requires Android 8.0 (API 26) or newer; the AAB is for store submission, not direct installation.
Summary
Provider failure containment and model routing
- Non-402 deterministic provider failure loops are bounded (#3805, follow-up to v0.55.0's 402 isolation): 401/403 auth and persistent 400 contract failures are classified as first-class failure causes with persisted Credential and Contract cooldowns, so a dead single candidate can no longer be re-selected in every recovery epoch and defer without bound.
- Correctable dispatch retries are admitted (#3807): a declared auth-refreshable dispatch settles mid-turn 401s without consuming the provider scope or writing a cooldown, so OAuth header-refresh re-sends go through in the new epoch while static credentials stay fenced.
- Cooldown replans preserve the real failure cause (#3799), so scope-cooling waits are no longer replaced by candidate re-selection errors that abort turns early and lose the actual reason.
- Model routing upkeep: supported compat routes gain coverage auditing (#3801, #3788), endpoint-specific catalog routes retire (#3794), retired Qianfan routes are removed (#3813), and Go-native discovery metadata is isolated from the reviewed catalog (#3829).
Vision and media
- Gemini models gain native image input and ViewImage observation (#3798): inlineData parts keep text and image order, native observations gain JSON Schema lowering, image parts count against image budgets instead of text tokens, and fallback routes without image support reject required images before dispatch; general markdown image budgeting continues in #3632.
- Web GUI image-model settings only offer media-selectable routes (#3804).
Queue, wait, and lifecycle invariants
- WorkItem source revisions stay invariant across queue commit channels (#3823, fixing #3816): wait-transition and completion writers synchronize the durable revision and execution-protocol registration in the same transaction, and a final equality assertion turns residual drift into a same-transaction rejection, closing back-to-back admission rejections and persistent settlement loops.
- Late WaitFor re-enqueues of terminal replies gain a bounded recovery obligation (#3830, for #3827): a dropped reply with complete canonical rejection evidence and a valid exact consuming wait gets a runtime-owned recovery wake without reviving the original delivery; the first-drop substate remains under investigation.
- Timer wait admission is revision-atomic (#3812, fixing #3791): TimerTick and exact-wait writers, claims, and admission snapshots stay consistent in one transaction, and terminal messages no longer strand timer pending placeholders.
- Snapshot preflight gains a FIFO wait queue (#3802, fixing #3800): the single capability-preflight worker queues up to 16 waiters with direct permit handoff to the oldest caller, keeping warm-cache /agents/snapshot polling healthy, with a new http.projection.preflight_admission_wait attribution stage.
Performance and storage
- Polled HTTP database reads move off tokio workers (#3806): /events page and SSE-open reads no longer block all workers in synchronous SQLite reads, ending the 8-22 second process-freeze mode found by the 2026-10-29 stall RCA, and slow-read observability covers the gap that RCA lacked.
Web GUI
- Agent detail hydrates from conversations instead of events (#3809), the dormant event stream transport is removed (#3810), and the event ledger and raw events dependencies retire (#3811), removing the Web GUI's dependency on the events API (#3808).
Tools and iOS clients
- Turn documents advertise only resolvable tool refs (#3817, fixing #3785): :cmd, batch-item, and :output selectors are generated from hydrated execution records instead of being issued for tools that never supported them.
- iOS connection input accepts bare host addresses (normalized to https) and the restore screen offers a change-address escape hatch when a saved profile is unreachable (#3820).
- The iOS UI test gate is stabilized with bounded retries and scaled waits (#3825).
Agent templates and skills
- New long-lived steward templates arrive for talent operations (#3796), app store optimization (#3803), and search visibility (#3815), and the video production template gains a pinned-version motion-prompt skill (#3832).
Documentation
- Documentation gains a responsive navigation layout (#3818) and section indexes in the documentation shell (commit 639fc132), bilingual agent-ecosystem researcher guides land (commits 24638585, 3b25b2ae, 972f82c0, and b3ee8eed), and the v0.55.0 release documentation is folded in (#3790, #3792).
Pull requests
- #3832 feat: 为视频制作模板加入固定版本 motion-prompt 技能
- #3830 fix: 修复 late WaitFor 对终态 reply 的同 ID 重入队
- #3829 fix: 更新模型目录并隔离 Go 原生发现元数据
- #3825 test: stabilize the iOS UI gate with bounded retries and scaled waits
- #3823 fix: enforce WorkItem source revision invariant across queue commit channels (#3816)
- #3820 fix: accept bare host addresses and keep address entry reachable during restore
- #3818 docs: add responsive documentation navigation layout
- #3817 fix: advertise resolvable turn tool refs
- #3815 feat: add search visibility steward agent template
- #3813 chore: 更新模型目录并移除千帆退役路由
- #3812 fix: 原子同步 timer wait 准入 revision 并收尾终态 pending
- #3811 refactor(web): retire event ledger and raw events dependencies
- #3810 refactor(web): remove dormant event stream transport
- #3809 fix(web): hydrate agent detail from conversation instead of events
- #3807 fix: allow correctable provider dispatch retries
- #3806 fix: keep polled HTTP db reads off tokio workers
- #3805 fix: bound non-402 deterministic provider failure loops (auth/contract cooldowns)
- #3804 fix(web-gui): filter image model settings to media-selectable routes
- #3803 feat: add aso-steward agent template
- #3802 fix: bound snapshot preflight admission with a FIFO wait queue (#3800)
- #3801 fix: 补齐 models.dev 支持路由的覆盖审计
- #3799 fix: preserve cooldown replan failure causes
- #3798 feat: native Gemini image input and ViewImage observation
- #3796 feat: add talent-ops-steward agent template
- #3794 fix: retire endpoint-specific catalog routes
- #3792 docs: update documentation for v0.55.0 release
- #3790 chore: prepare v0.55.0 release
Direct commits
- 4260385c docs: 明确 Agent 自动选题与认领规则
- 639fc132 docs: include section indexes in the documentation shell
- 24638585 docs: add English guide for building agent ecosystem researcher
- b3ee8eed docs: refine ecosystem researcher guide per review feedback
- 972f82c0 docs: enrich ecosystem researcher guide with Web GUI, autonomous principles, and mobile interactions
- 3b25b2ae docs: add Chinese scenario guide for building agent ecosystem researcher
Issues
- #3827 bug(runtime): 不可重试 failed delivery 再次入队触发终态不变量,internal_followup 未送达 — late exact-wait recovery is restored by #3830; the original first-drop substate remains under investigation
- #3816 enhancement(runtime): 同 WorkItem 背靠背 task_result 续接的准入 revision 过期被守卫拒绝,产生可避免的 failure brief — fixed by #3823
- #3808 refactor(web-gui): 消除 Web GUI 对 events 接口的依赖 — fixed by #3809, #3810, #3811
- #3800 bug: capability preflight 单槽不排队(MAX_WORKERS=1)使缓存热态的 /agents/snapshot 轮询稳定返回 503 projection_preflight_saturated — fixed by #3802
- #3797 bug(runtime): scope 冷却等待被候选重选错误顶替,turn 提前 abort 且丢失真实原因 — fixed by #3799
- #3795 feat(provider): 补齐 Gemini 原生图片输入与 ViewImage 视觉观察 — fixed by #3798
- #3791 bug(runtime): TimerTick 准入后首发因 WorkItemRevisionMismatch 被拒,后续 exact wait 恢复及 timer 去重滞留 — fixed by #3812
- #3788 models.dev 审计:受支持兼容路由未进入 coverage 枚举,原生 DeepSeek 路由缺同源比较 — fixed by #3794, #3801
- #3785 fix(memory): turn 文档为非命令工具签发不可解析的 :cmd 引用 — fixed by #3817
Install
Android:
Download holon-android-v0.56.0.apk on your device and allow installation from the download source. Future official APKs use the same signing identity and upgrade in place. Existing debug-signed installations require a one-time reinstall; uninstalling removes their local sessions, drafts, and outbox.
Homebrew:
brew tap holon-run/tap
brew install holonDirect binary:
curl -L "https://github.com/holon-run/holon/releases/download/v0.56.0/holon-linux-amd64.tar.gz" | tar -xz
chmod +x holon
./holon --helpReplace holon-linux-amd64.tar.gz with holon-darwin-amd64.tar.gz or holon-darwin-arm64.tar.gz on macOS.
Docker:
docker pull ghcr.io/holon-run/holon:0.56.0