v0.13.0

---

doc_kind: release-notes
topics: [opensource, release, messaging, runtime, desktop]
created: 2026-09-01
release: v0.13.0

Clowder AI v0.13.0

v0.13.0 is a stability release for agent messaging, provider/session recovery,
the Hub experience, and desktop updates. It contains 63 public-main commits since
v0.12.0, including an audited release-candidate gate update.

Highlights

• Faster, stricter agent messaging: the F288 plugin messaging domain and Host
  fast lane now have an 18-case joint acceptance contract. Stop/Steer ownership,
  proactive final output, same-thread fan-out, and scheduler wake handling are more
  reliable.
• Provider and session recovery: Codex no longer recursively shrinks a configured
  context window on resume; OpenCode model aliases, output limits, and silent
  completions are recovered correctly; Kimi >= 0.30 resume compatibility and Claude
  partial-output lifecycle are fixed.
• A calmer Hub: Recent threads are no longer truncated to eight entries, unread
  cursor repair no longer revives stale badges, streaming keeps the viewport anchored,
  and Context Window / Session State settings are simpler. Uninitialized projects now
  show neutral onboarding instead of a false runtime error.
• Safer persistence and desktop operation: Redis message append is atomic and
  idempotent, Windows startup fails closed when Redis is unavailable, Windows process
  groups are terminated correctly, and desktop update recovery now provides clearer
  diagnostics and retry paths.

What's Changed

Messaging, plugins, and coordination

• Completed the F288 messaging contract migration, Host fast lane, and joint acceptance
  suite.
• Preserved a distinct final response after proactive post_message calls.
• Restored explicit Stop ownership and Steer delivery, and unblocked queue heads after
  same-thread A2A fan-out.
• Made scheduler wake rows valid approval origins only for producers that declare an
  authenticated binding.

Providers, sessions, and runtime

• Made the configured member model authoritative for invocations.
• Decoupled session policy from runtime capability, unified context-capacity projection,
  and added safe manual session sealing.
• Repaired Codex protocol-health degradation and recursive context-window shrink.
• Repaired OpenCode account-alias routing, mandatory output limits, and silent or
  post-tool no-output completion recovery.
• Repaired Kimi resume behavior for kimi-code >= 0.30, Claude partial text, cold-rebuild
  bootstrap, CLI incompatibility diagnostics, and manual-cancel slot liveness.

Hub and settings

• Removed the eight-thread Recent truncation and improved sidebar spacing.
• Repaired stale unread cursors and direction-aware bottom-follow during streaming.
• Added curated System Settings with explicit inline-edit permissions and deprecation
  labels for dead configuration.
• Simplified Context Window and Session State / Chain settings.
• Added neutral onboarding for uninitialized project directories and restored member
  creation when no accounts exist.
• Added the public Clowder AI project website and slimmer root documentation.

Reliability, Windows, and desktop

• Made Redis message append atomic and idempotent.
• Windows launchers no longer silently fall back to volatile memory storage when Redis
  is unavailable.
• Added Windows process-group termination and LAN-safe cancel IDs.
• Preserved configured IM connector autostart through runtime synchronization.
• Hardened desktop update recovery and packaged every update-runtime dependency into the
  desktop bundle.
• Sharded the public test suite with exact provenance and replaced the expired release
  exclusions with an audited 16 re-admit / 25 retain decision.

Compatibility and Upgrade Notes

• No manual data migration is required. Existing threads, messages, tasks, memories,
  and configuration remain in place. Node (>=24) and pnpm (>=8) requirements are
  unchanged.
• Windows Redis startup is intentionally fail-closed. If Redis is unavailable, fix
  Redis or explicitly choose the volatile pnpm start --memory mode. Startup no longer
  selects memory mode silently.
• Prompt limits follow member/session capacity. Legacy process-wide prompt controls
  such as MAX_PROMPT_TOKENS and MAX_CONTEXT_MSG_CHARS no longer control invocation
  routing. Use the member's Context Window and Session State settings.
• Internal session hooks use invocation-bound callback credentials. Integrations that
  called the internal hook routes with CAT_CAFE_HOOK_TOKEN must migrate to the current
  invocation ID + callback token contract.
• Connector autostart is explicit outside official launchers. Official runtime
  entrypoints inject the required opt-in. Custom API launch commands that expect IM
  connectors to autostart must set CONNECTOR_GATEWAY_AUTOSTART=1 explicitly.
• Deprecated IMAP review-watcher variables remain visible as deprecated inventory but are
  not an active notification path; PR review feedback uses GitHub API polling.

Downloads

Platform	File	Notes
Windows installer	ClowderAI-Setup-0.13.0.exe	In-place upgrade; persistent data is preserved
Windows portable	ClowderAI-0.13.0.zip	Extract and run start.bat
macOS Apple Silicon	ClowderAI-0.13.0-arm64.dmg	Drag Clowder AI to Applications
macOS Intel	ClowderAI-0.13.0-x64.dmg	Drag Clowder AI to Applications

The desktop app can discover this release automatically. Manual downloads remain
available from the GitHub release page.

Community

Thank you to the contributors whose changes landed in this release, including
@mindfn, @ldn9596, @solcao-git, @malt77, @TERRYYYC, @masterkunm,
@QwQ02009, @whutzefengxie-ops, and @funkdog.

Full changelog: v0.12.0...v0.13.0

---

Clowder AI v0.13.0

v0.13.0 是一次以稳定性为主的发布，集中改善 Agent 消息协作、Provider / Session
恢复、Hub 使用体验和桌面更新。它包含 v0.12.0 之后 public main 上的 63 个提交，
其中包括一笔经过审计的候选版本门禁更新。

重点更新

• 更快、更严格的 Agent 消息链路： F288 插件消息域和 Host fast lane 现由 18 个
  联合验收场景约束。Stop / Steer 球权、主动 post_message 后的最终输出、同 thread
  fan-out 和 scheduler wake 都更加可靠。
• Provider 与 Session 恢复： Codex resume 不再递归缩小已配置的 Context Window；
  OpenCode 的模型别名、输出上限和静默完成得到修复；Kimi >= 0.30 resume 兼容、Claude
  partial output 生命周期也已补齐。
• 更安静的 Hub： 最近 thread 不再只显示 8 条；旧未读游标不会反复复活 badge；
  流式输出时视口能稳定吸底；Context Window / Session State 设置更清晰。未初始化项目
  会显示中性引导，不再误报运行环境损坏。
• 更安全的持久化与桌面运行： Redis 消息追加改为原子且幂等；Windows 在 Redis
  不可用时会 fail closed；Windows 子进程组可被正确回收；桌面更新增加了更清楚的诊断
  和重试路径。

完整变化

消息、插件与协作

• 完成 F288 消息契约迁移、Host fast lane 与联合验收套件。
• 主动 post_message 后仍会保存不同内容的最终回复。
• 恢复明确的 Stop 球权和 Steer 投递，并修复同 thread A2A fan-out 后队首阻塞。
• scheduler wake 只有在 producer 声明了认证绑定时，才可作为 approval origin。

Provider、Session 与 Runtime

• 调用时以成员配置的模型为权威来源。
• 将 session policy 与 runtime capability 解耦，统一 context capacity 投影，并加入安全的
  手动 session seal。
• 修复 Codex 协议健康降级和 resume 时 Context Window 递归缩小。
• 修复 OpenCode 账号模型别名、必需的 output limit，以及静默 / tool 后无输出恢复。
• 修复 Kimi >=0.30 resume、Claude partial text、cold-rebuild bootstrap、CLI 参数不兼容
  诊断和手动取消后的 slot 存活。

Hub 与设置

• 移除最近 thread 的 8 条截断并调整侧栏排版。
• 修复旧未读游标和流式输出时的方向感知吸底。
• 新增精选 System Settings、明确的 inline-edit 权限和死配置的 deprecated 标记。
• 简化 Context Window 与 Session State / Chain 设置层级。
• 未初始化目录改为中性引导；没有账号时也可正常创建成员。
• 新增 Clowder AI 项目网站，并精简根目录文档。

可靠性、Windows 与桌面端

• Redis 消息追加改为原子且幂等。
• Windows launcher 不再在 Redis 失败时偷偷切换到会丢数据的 memory store。
• 增加 Windows 进程组回收和 LAN 环境可用的 cancel ID。
• runtime 同步后仍保留预配置 IM connector 的自动启动语义。
• 加固桌面更新恢复，并把所有 update runtime 依赖打进 desktop bundle。
• public test 改为携带精确 provenance 的分片执行；候选版本对过期 exclusion 做了
  “16 项重新纳入 / 25 项继续保留”的审计。

兼容性与升级说明

• 无需手工迁移数据。 现有 thread、message、task、memory 与配置会继续保留；Node
  (>=24) 和 pnpm (>=8) 要求不变。
• Windows 的 Redis 启动现在会 fail closed。 Redis 不可用时，请修复 Redis；只有在
  明确接受易失存储时才主动使用 pnpm start --memory。系统不再静默替你选择 memory。
• Prompt 上限改由成员 / Session capacity 决定。 MAX_PROMPT_TOKENS、
  MAX_CONTEXT_MSG_CHARS 等旧的进程级开关不再控制 invocation 路由；请使用成员的
  Context Window 和 Session State 设置。
• 内部 session hook 改用 invocation-bound callback 凭据。 如果外部集成直接拿
  CAT_CAFE_HOOK_TOKEN 调内部 hook，需要迁移到 invocation ID + callback token 契约。
• 非官方启动方式下，connector autostart 必须显式开启。 官方 runtime 入口会注入
  opt-in；自行直接启动 API、且希望 IM connector 自动启动时，请显式设置
  CONNECTOR_GATEWAY_AUTOSTART=1。
• 旧 IMAP review watcher 环境变量仍作为 deprecated inventory 显示，但已经不是有效通知
  通道；PR review 反馈走 GitHub API polling。

下载

平台	文件	说明
Windows 安装版	ClowderAI-Setup-0.13.0.exe	原地升级，持久数据保留
Windows 便携版	ClowderAI-0.13.0.zip	解压后运行 start.bat
macOS Apple Silicon	ClowderAI-0.13.0-arm64.dmg	拖入 Applications
macOS Intel	ClowderAI-0.13.0-x64.dmg	拖入 Applications

桌面端可以自动发现本版本，也可以从 GitHub release 页面手动下载。

社区贡献

感谢本版本所有贡献者，包括 @mindfn、@ldn9596、@solcao-git、@malt77、
@TERRYYYC、@masterkunm、@QwQ02009、@whutzefengxie-ops 和 @funkdog。

完整变更：v0.12.0...v0.13.0