Release Notes

📦 Release v2.2.1

This release was automatically published from PR #15302.

Changes

See PR description: https://github.com/lobehub/lobehub/pull/15302

Commit Message

🚀 LobeHub Release (20260528)

Release Date: May 28, 2026
Since v2.2.0: 220 merged PRs · 15 contributors

This cycle brings heterogeneous "platform agents" you can dispatch to local or remote devices, a rebuilt onboarding flow, document-centric chat, and a unified model-runtime error model — with new DeepSeek V4 and Gemini 3.5 Flash support along the way.

✨ Highlights

More Hetero Agents (OpenClaw / Hermes) — Create heterogeneous agents and dispatch them to local or remote devices through the device gateway, with an execution-target switcher in the composer and persistent CLI sessions. (#15065, #15179, #15022)
iMessage on Desktop — New iMessage setup and bridge on desktop, plus bot attachments across every platform. (#15228, #15227, #15029)
Skills in the Composer — Drag skill chips into chat, trigger installed skills from the slash menu mid-line, and surface project-level skills in the homogeneous agent runtime. (#15095, #15061, #15110)
New Models — DeepSeek V4 Flash/Pro and Gemini 3.5 Flash across providers, with thinking params for structured output and chat cost estimates. (#15031, #15001, #15051, #14876)
Agent Runtime Observability — OpenTelemetry GenAI semantic conventions plus per-call generation tracing. (#15123, #15124)

🤖 Agents & Heterogeneous Runtime

Platform agent creation — OpenClaw/Hermes creation UI, device guard, and remote dispatch backend. (#15065)
Execution-target switcher — Pick local vs remote execution directly in the composer; device-selection UX with actionable guidance. (#15179, #15111)
CLI hetero dispatch — OpenClaw/Hermes dispatch with persistent sessions and a notify protocol. (#15022)
Gateway snapshot as source of truth — Consume the gateway uiMessages snapshot at step boundaries to keep chat state consistent. (#15153, #15152)
Client sub-agent as a normal tool call — Simplifies the sub-agent execution path. (#15281)
Hermes agent chain — Implements the Hermes agent chain logic. (#15189)
Device registry — TRPC endpoints to register, list, update, and remove devices. (#15299)
Desktop device routing — Route gateway agent runs through lh hetero exec; restore userId in gateway dispatch and gate local-system by execution target. (#15132, #15232)
Agent signals — Anchor agent-signal receipts to messages and isolate memory-agent messages into a child thread. (#14969, #14921)

🚀 Onboarding

Simplified first screen — Defer topic creation to first send. (#15090)
Market Agent Picker — Added as a classic onboarding step, with template prefetch. (#14980, #15041)
Welcome guidance — Show agent welcome guidance on first run. (#15098)
Mobile — Adapt agent onboarding UI and restore Classic-step padding on mobile. (#15019, #15032)
Discovery — Streamline discovery to a single profession question. (#14987)
Analytics — Track onboarding step events and create-agent modal source. (#15133, #15028)

📄 Documents, Pages & Knowledge

Thread chat in preview — Embed thread chat in the document preview portal. (#15216)
Non-markdown rendering — Render non-markdown docs as a read-only highlight. (#15272)
Multi-select — Multi-select delete in the document tree. (#15125)
Page-agent streaming — Preview initPage streaming arguments. (#15039)
Per-agent topics — Per-agent topic management page. (#15207)
Server-side category — Derive document category server-side and drop frontend predicates. (#15076)

🧩 Skills & Tools

Drag skill chips — Drag skills into chat input and register agent-document skills. (#15095)
Slash menu — Installed skills appear in the slash menu with a mid-line trigger. (#15061)
Project skills — Recognize project-level skills in the homogeneous agent runtime and surface them regardless of active device. (#15110, #15177)
VFS archiving — Archive oversized tool results to VFS instead of truncating. (#15074)
@localFile mentions — Drag folders into chat input as @localFile mentions on desktop. (#15071)

🧠 Model Runtime & Providers

Error spec registry — Unify error codes into a spec + pattern registry, split ProviderBizError into finer codes, classify Cloud-only codes via a tier digit, and add DatabasePersistError. (#15262, #15286, #15278, #15279)
New models — DeepSeek V4 Flash/Pro (opencode-go) and Gemini 3.5 Flash; DeepSeek V4 Pro on SiliconCloud. (#15031, #15001, #15017, #15267)
Structured output — Thinking params for structured output, Bedrock structured generation, and DeepSeek generateObject tool choice. (#15051, #15174, #15054)
Cost — Chat cost estimate support; preserve usage cost in custom streams. (#14876, #15218)

💬 Chat & User Experience

Follow-up chips — Extend follow-up chip suggestions to general chat with scene-specific model config. (#15101, #14797)
Input drafts — Persist unsent input drafts across tab switches and prevent repeated draft restore. (#14992, #15024)
Command menu — Order topic/message search by recency and promote inline type filters. (#15094, #14986)
Zoom HUD — Show a zoom-level HUD on Cmd +/− and Cmd 0. (#15294)
Copy — Unescape markdown escapes when copying user messages. (#15253)

🖥️ Desktop

App Nap fix — Prevent App Nap from dropping the gateway WebSocket during display sleep. (#14994)
File preview — Preview .cjs/.mjs/no-extension files instead of binary fallback and expand ~ when opening local files. (#15168, #15284)
Cross-platform settings — Open settings via main-window navigation on Windows/Linux and restore the route after an update restart. (#15036, #14922)
Token refresh — Prevent frequent logout from token-refresh retries. (#14928)

📊 Observability

OTel GenAI — Instrument Agent Runtime with OpenTelemetry GenAI semantic conventions. (#15123)
Generation tracing — Per-call llm_generation_tracing with a pre-allocated tracingId and recordFeedback router. (#15124, #15146)
Error classification — Persist ERROR_CODE_SPECS classification on operation errors. (#15273)

🗃️ Database Migrations

Batch migrations — Topic usage stats, push tokens, tasks.editor_data, and document shares. (#15280)
Tracing & eval tables — Add llm_generation_tracing and agent eval experiment tables. (#15126)

Self-hosted operators should run the database migration (pnpm db:migrate, or restart with auto-migrate enabled) after upgrading. The changes are additive and backwards-compatible.

🔒 Security & Reliability

Security: Remove the getPlaintextCred tool to prevent plaintext credential exposure. (#14998)
Security: Prompt account selection for Google OAuth and add prompt=consent to the OIDC authorization URL to fix missing refresh tokens. (#15234, #15010)
Reliability: Preserve streamed content across a mid-stream cancel. (#15173)
Reliability: Bound the Redis command timeout and configure the Anthropic client timeout. (#15091, #15042)
Reliability: Prevent infinite recursion in the assistant chain. (#15288)

👥 Contributors

Huge thanks to 15 contributors who shipped 220 merged PRs this cycle.

@AnotiaWang · @sxjeru · @algojogacor · @hardy-one · @arvinxx · @Innei · @tjx666 · @LiJian · @AmAzing129 · @Rdmclin2 · @Neko · @cy948 · @CanisMinor · @sudongyuer · @rivertwilight

Plus @lobehubbot and renovate[bot] for maintenance.

Full Changelog: v2.2.0...release/weekly-20260528