亮点
- 多用户访问与邀请流 — Agorid can now run as a shared, authenticated control plane. Real human identities, company memberships, invite creation/landing, onboarding, profile settings, and company-scoped access controls are first-class while keeping the local-first single-operator path intact. (#3784)
- 结构化任务线程交互 — Agents can now post structured proposals into the thread: suggested tasks, multi-question forms, and request-for-confirmation cards. The board renders them as interactive cards with accept/reject/answer flows, idempotency keys, and resumable agent continuations. Plan approvals and yes/no decisions are now explicit, auditable, and replayable without leaving the issue. (#4244, #4381)
- 运行存活续跑与运行时生命周期恢复 — Heartbeat runs now record liveness state, next-action hints, and continuation attempts so long or interrupted work can resume with full context. A new active-run watchdog plus runtime lifecycle recovery surfaces silent runs, covered-blocker chains, and stalled in-review leaves with operator-visible recovery decisions. (#4083, #4419, #4209)
- 子 issue 作为工作流清单 — Ordered sub-issues now render as a dependency-aware progress checklist with current-step affordances, blocker context, and de-emphasized done items, replacing the flat table presentation. (#4523, #4588)
- Issue 子树暂停、取消与恢复 — Board operators can now hold, cancel, or restore a whole issue subtree from the issue detail. Holds are durable, dependency-aware, and keep descendant execution and wake behavior coherent. (#4332)
- 一等 issue 引用 — Mentions of
PAP-123-style ticket ids in issue text, comments, and documents now persist as durable reference relationships. The board surfaces backlinks, queryable cross-issue context, and an idempotent backfill for existing content. (#4214)
测试功能
- BETA Environment 与可插拔 sandbox provider — Heartbeat runs now execute against a first-class
Environmentrecord with lease lifecycle tracking. Local, SSH-backed remote, and sandboxed execution targets are all supported, and providers are pluggable via a generic plugin contract. The new@paperclipai/plugin-e2bpackage ships as the reference third-party sandbox provider. (#4297, #4358, #4415, #4449, #4452)
改进
- 可配置 liveness 自动恢复 — New instance settings let operators keep liveness findings advisory or enable bounded auto-recovery with explicit minimum interval and lookback windows. (#4587)
- Heartbeat 调度感知 blocker — The scheduler now respects
blockedByIssueIdsgraphs and avoids waking dependents until their blockers resolve. (#4157) - 图变更时取消陈旧排队与计划工作 — Queued heartbeats are gated at claim time and cancelled when the issue assignee, status, or review participant moves on. Scheduled retries are cancelled on ownership changes or explicit issue cancellation. (#4445, #4534, #4234)
- Plugin orchestration host API — Plugins can now request namespaced databases, register orchestration hosts, and expose richer APIs to the control plane. (#4114)
paperclip-devskill — A new opt-inpaperclip-devskill ships with Agorid covering server lifecycle, worktrees, builds, database ops, and diagnostics. Includes open-source hygiene and “push feature branches to a user fork” guidance. (#3854, #4541, #4572)- 子 issue 内联 — The create-agent skill is split into focused per-role instruction files, with an improved agent instructions pane layout. (#4124, #4422)
- 用户资料页与访问清理 — First user profile surface for activity and cost attribution, with safer member removal, archived-member cleanup, and tighter permission protection. (#4088)
- Backup endpoint and dev runtime hardening — Manual backup HTTP endpoint, improved backup streaming, less noisy dev output, safer instance isolation, and quieter static UI logging. (#4087)
- 工作区与 runtime UI 打磨 — Better workspace navigation, runtime state surfaces, dashboard run activity charts, mobile org chart navigation, and respect for manual workspace runtime controls. (#4089, #4090, #4125, #4126, #4127)
- 授权加固(GHSA-68qg-g8mg-6pr7) — Long document display, issue composer affordances, board workflow polish, and refined markdown issue-reference rendering. (#4224, #4382, #4420, #4447)
- 公司技能详情加载更快 — Skill detail pages now hydrate noticeably faster. (#4380)
- Codex 瞬时恢复与模型刷新 — Better handling of transient Codex errors and refreshed model list. (#4383)
- Heartbeat runtime cleanup and scheduling controls — Tighter teardown of heartbeat runtimes, better scheduling controls, and improved agent runtime recovery/governance. (#4086, #4223, #4233)
- 全面 UI Storybook 覆盖 — Expanded Storybook stories across the UI for design review and visual regression. (#4132)
- Sandbox 动态 adapter UI parser — Adapter UI transcript parsers now run inside a sandboxed evaluator for safer plugin loading. (#4225)
- 规范化转义多行文本 — Issue and approval text with escaped multiline content is normalized on storage so paragraph breaks survive. (#4444)
- 按 board 访问门控陈旧 run watchdog 决策 — Auto-recovery decisions only apply where the actor has board access, avoiding cross-company noise. (#4446)
- Claude 本地适配器:Opus 4.7 — Added Claude Opus 4.7 to the model dropdown. (#3828, @GodsBoy)
- 公开路线图与贡献政策 — Added a public roadmap and updated the feature-PR contribution policy. (#3835)
- README 架构体系 — New README documentation walking through the major systems in the codebase. (#4250)
- AWS ECS Fargate 部署手册 — End-to-end deployment guide for running Agorid on ECS Fargate. (#3897, @neerazz)
- agorid skill 中的结构化 agent 提及 — Skill comments now use structured
[@Name](agent://id)mentions instead of raw@Namestrings. (#4103, @aronprins) - 一等安全智能体角色 — Added a dedicated
securityagent role to the taxonomy with route coverage and regression tests so security responsibilities can be modeled explicitly in the org chart. (#4532, #4586, #4589)
修复
- 消失的任务评论 — Fixed comments occasionally disappearing from the issue thread. (#4557)
- Markdown 中外链 issue URL 重写 — Fixed external issue URLs being incorrectly rewritten in rendered markdown. (#4558)
- publicBaseUrl 端口处理 — Tightened
publicBaseUrlport rewriting and trust allowed hostname port variants on the detected listen port so reverse-proxied auth flows resolve correctly. (#4553, #4554) - CEO
$AGENT_HOMEpaths — Fixed$AGENT_HOMEreferences in CEO onboarding instructions and centralized workspace env propagation. (#4551) - 外部适配器热安装 —
resolveExternalAdapterRegistrationnow applies on hot-install and the adapter registry honors module-providedsessionManagementfor external adapters. (#4324, #4296, @superbiche) pi-localskill bin PATH — The Pi local adapter now prepends installed skillbin/directories to the child process PATH. (#4331, @SgtPooki)- Hermes 适配器回归修复 — Honor Hermes local command override, stop advertising unsupported instructions bundles, inject the agent JWT for proper identity attribution, and add
hermes_localto the sessioned local adapters allow-list. (#3503, @NoronhaH; #3908, @LeonSGP43; #3608, @rvanduiven; #3561, @akhater) - 生产 Docker 镜像 — Added
sshclient andjqto the production image; fixedghinstallation in the Docker build. (#3826, @rbarinov; #3844) - 陈旧执行运行锁 — Fixed stale issue execution run locks lingering after failed runs. (#4258)
- 陈旧排队评论目标 — Cleared stale queued comment targets when the underlying thread state changes. (#4234)
- 独立包 release 打包 — Fixed release packaging for standalone publishable packages so plugin packages publish cleanly. (#4494)
- Terminal-result adapter 进程组 — Cleaned up terminal-result adapter child process groups so orphaned processes are reaped. (#4129)
- CI flaky — Stabilized serialized server route tests, isolated CLI company import e2e state, fixed flaky heartbeat recovery teardown, and stabilized local maintenance assets. (#4423, #4448, #4559, #4560)
安全
- API 路由鉴权加固 — Tightened actor, company, and active-checkout boundary enforcement across the REST surface for company, agent, plugin, adapter, cost, invite, and issue mutation routes. Adds regression coverage for the audited routes. (#4122)
升级指南
Fourteen new database migrations (0057–0070) will run automatically on startup. They add:
- Deduped join requests (
0057) - Heartbeat run liveness, continuation tracking, and last-useful-action metadata (
0058) - Plugin database namespaces (
0059) - Issue reference mentions (
0060) - Heartbeat scheduled retry tracking (
0061) - Routine run dispatch fingerprint and origin-fingerprint uniqueness for routine-execution issues (
0062) - Issue thread interactions and idempotency index (
0063,0064) - Environments and environment leases (
0065) - Issue tree holds for subtree pause/cancel/restore (
0066) - Agents’ default environment foreign key (
0067) - Per-company unique local-driver environment index (
0068) - Liveness recovery dedupe indexes (
0069) - Active-run output watchdog metadata (
0070)
迁移均为增量——不修改或删除既有数据。
If you previously ran sandbox execution against the in-tree provider, install @paperclipai/plugin-e2b (or your own provider plugin) to keep using sandboxed runtimes after upgrading. The generic provider plugin contract is documented alongside the new environments subsystem.
贡献者
感谢每一位为本版本贡献的人!
@akhater, @aronprins, @cryppadotta, @devinfoley, @GodsBoy, @LeonSGP43, @neerazz, @NoronhaH, @rbarinov, @rvanduiven, @SgtPooki, @superbiche