Changelog
What changed in each 3.0.0-beta prerelease of the @openmaxai chat packages.
Changelog
The @openmaxai/chat-sdk, @openmaxai/chat, @openmaxai/chat-store and @openmaxai/chat-openmax packages are released together under the same version. Every export is @experimental and may change between prereleases, so pin exact versions (see Installation).
3.0.0-beta.5 (2026-11-08)
Added
- Pop out, drag out and drop back. Conversations can be popped out into a floating window, dragged out of the conversation list, and dropped back into the main area (opt-in, wide layout only). See Floating surfaces.
- Persistent layout through host storage. New
surfaceStorageandanchorStorageoptions oncreateChatHostkeep open windows, preferences and reading positions in storage you provide;width/onWidthChangeon<CwsConversationList>let your app keep the list width. - Avatar strip.
compacton<CwsConversationList>draws the list as a 64 px strip of avatars, and<ChatSplitLayout>gains a matching tier. - Avatars show identity and online status on every surface that shows a member, with one shared shape and size tiers.
- Agent details. Capability tags on Agent rows and in the
@-mention panel (adaptercapabilityTags), the model name next to Agent senders, and billing-suspended Agents shown as suspended (billingSuspended,isBillingSuspended). - Quoting a selected excerpt of a message, and an opt-in grouped
@-mention list. - Theme input variables
--omx-*for setting brand colors from outside the chat. See Theming. - Short-lived addresses and tokens.
resolveDownloadUrlon the adapter'suploads, Markdownartifact://links that resolve at use time, andgetTokenmay return{ token, expiresAt }(OpenMaxToken). See Tokens and expiry. - New inbound signals
connectedandcatchUp,resolveMembersfor naming conversations by member id, andagentGroupPolicyon the adapter. - Accessibility: the
@-mention panel is a proper listbox that screen readers follow, and the composer announces that typing can open suggestions.
Changed
- Behavior change: identity moves onto the avatar. On hosts created by
createChatHost, list rows, member rows,@-mention candidates and the header no longer draw the "Agent" text tag; the host's corner badge sits in a notch on the avatar. - Behavior change:
<CwsConversationList>leaves out conversations that are open in a floating window or the docked column, and the docked column gets the floating window's minimize and close controls. - Quoting a message in a DM no longer inserts an
@for its author. - Deep links by server id land in one request and no longer move a viewport the user has scrolled away from.
resolveDownloadUrlpassed at the top level ofcreateChatHostis now a TypeScript error; put it on the adapter'suploads.
Fixed
@openmaxai/chat-openmax: agetTokenthat never settles, or a realtime ticket exchange or handshake that never answers, no longer stalls requests and realtime for good;reconnectedis sent only after a real reconnect.- Links in plain text keep balanced parentheses and a final
!or?, and no longer swallow text written right after the host. - Mermaid diagrams whose labels look like a CSS function are drawn again.
- Members with an empty name show "Unknown member"; system members get no status dot and show in the UI language.
- Small brand-colored text is readable in dark mode, and Chinese UIs no longer show English role names.
<CwsConversationList>shows "Failed to load · Retry" when the first page fails, and starting a DM from search opens it.
3.0.0-beta.4 (2026-11-02)
Added
- Agent run progress (read-only, transitional).
@openmaxai/chat-openmaxdecodes Agent activity into run blocks in the message thread and a one-line summary in the header. No stop button yet; it will be replaced by the planned Agent runs capability. isFetchingonuseChatSdkConversationList().memberAddedrealtime signal, so an adapter can report that someone joined a conversation.
Changed
- Behavior change: inside
<ChatShadowRoot>, the chat's own dialogs are non-modal too while floating surfaces are present. - Behavior change: a dialog opened inside a floating window locks only that window, not the main area.
- Behavior change: one conversation-list request per trigger (an event no longer fetches the list twice).
useListRowDragOutcan drag rows that are themselves a<button>.
Fixed
- Keyboard focus inside
<ChatShadowRoot>: dialogs, sheets and drawers trap and restore focus, and dropping a dragged row or window onto the main area or dock column works.
3.0.0-beta.3 (2026-10-31)
Added
- Group management in the UI. With the
groupManagementcapability, the conversation list has a "New group" button and the info panel manages members. See Group management. openMaxSharedRealtimein@openmaxai/chat-openmax, which feeds the SDK from a realtime connection your app already owns instead of opening a second one.- Realtime close records: an optional
closedcallback on the realtime sink.
Changed
- Behavior change: the chat components can be rendered on the server: a server render sends no request and does not call
getToken. See Server-side rendering and Next.js. @openmaxai/chat-openmaxaccepts a path starting with/forbaseUrlandwsUrl, and creating a host no longer toucheswindow.- Behavior change: the chat's own dialogs are non-modal while floating surfaces are present.
- Behavior change: a floating window's height now includes its title bar.
- Unrecognized top-level keys passed to
createChatHostare reported.
Fixed
- In the compact drawer, Esc with the group info panel open closes only the panel.
- System notices keep their line breaks; a system member's profile card shows only its name.
Security
- Mermaid diagram SVG is sanitized with DOMPurify before it is inserted.
3.0.0-beta.2 (2026-10-30)
Changed
- Breaking:
@openmaxai/chatand@openmaxai/chat-storeare now exact-version peer dependencies of@openmaxai/chat-sdk(and of@openmaxai/chat-openmax). A version mismatch now shows up at install time: npm fails withERESOLVE, pnpm and yarn warn. Align the versions; do not bypass it with--forceor--legacy-peer-deps. @openmaxai/chatno longer depends onvaul; Radix UI and vaul ship compiled in.
Added
- Floating surfaces keep their state across reloads, and
<ChatFloatingSurfaces>takes mount-level switches. placementonopenConversation("primary"or"detached"), androuteConversationoncreateChatHostto decide where a conversation opens.- One host can be mounted in several
<ChatProvider>s side by side. @openmaxai/chat-openmaximplements allgroupManagementmethods; membership signals for removed members and deleted conversations.- Read-only local data: with
readOnly: truein the local data options ofcreateChatHost, the host's message store opens local data read-only and shows what is already on the device while offline.
Removed
- The Chinese README is no longer in the
@openmaxai/chat-sdkpackage; the package README is English only.
Fixed
CHAT_SDK_VERSION,CHAT_OPENMAX_VERSIONandCHAT_STORE_VERSIONnow equal the installed package version. Their type is nowstringinstead of a string literal.
3.0.0-beta.1 (2026-10-28)
First public prerelease, published under the @openmaxai scope.
@openmaxai/chat: styled React components (conversation list, message thread, composer, cards, group management, profile card, image viewer, floating surfaces) and theChatHostcontract.@openmaxai/chat-sdk:createChatHost, which builds aChatHostfrom an adapter, plus React bindings, message-display and composer plugins, a unifiedChatSdkError, and an in-memory adapter for tests.@openmaxai/chat-store: the local message store with optional IndexedDB persistence.@openmaxai/chat-openmax: an adapter for the OpenMax backend with REST and realtime.- English and Chinese strings, dark mode, and an MIT license.
