OpenMax
Free Trial

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 surfaceStorage and anchorStorage options on createChatHost keep open windows, preferences and reading positions in storage you provide; width / onWidthChange on <CwsConversationList> let your app keep the list width.
  • Avatar strip. compact on <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 (adapter capabilityTags), 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. resolveDownloadUrl on the adapter's uploads, Markdown artifact:// links that resolve at use time, and getToken may return { token, expiresAt } (OpenMaxToken). See Tokens and expiry.
  • New inbound signals connected and catchUp, resolveMembers for naming conversations by member id, and agentGroupPolicy on 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.
  • resolveDownloadUrl passed at the top level of createChatHost is now a TypeScript error; put it on the adapter's uploads.

Fixed

  • @openmaxai/chat-openmax: a getToken that never settles, or a realtime ticket exchange or handshake that never answers, no longer stalls requests and realtime for good; reconnected is 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-openmax decodes 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.
  • isFetching on useChatSdkConversationList().
  • memberAdded realtime 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).
  • useListRowDragOut can 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 groupManagement capability, the conversation list has a "New group" button and the info panel manages members. See Group management.
  • openMaxSharedRealtime in @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 closed callback 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-openmax accepts a path starting with / for baseUrl and wsUrl, and creating a host no longer touches window.
  • 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 createChatHost are 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/chat and @openmaxai/chat-store are 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 with ERESOLVE, pnpm and yarn warn. Align the versions; do not bypass it with --force or --legacy-peer-deps.
  • @openmaxai/chat no longer depends on vaul; Radix UI and vaul ship compiled in.

Added

  • Floating surfaces keep their state across reloads, and <ChatFloatingSurfaces> takes mount-level switches.
  • placement on openConversation ("primary" or "detached"), and routeConversation on createChatHost to decide where a conversation opens.
  • One host can be mounted in several <ChatProvider>s side by side.
  • @openmaxai/chat-openmax implements all groupManagement methods; membership signals for removed members and deleted conversations.
  • Read-only local data: with readOnly: true in the local data options of createChatHost, 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-sdk package; the package README is English only.

Fixed

  • CHAT_SDK_VERSION, CHAT_OPENMAX_VERSION and CHAT_STORE_VERSION now equal the installed package version. Their type is now string instead 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 the ChatHost contract.
  • @openmaxai/chat-sdk: createChatHost, which builds a ChatHost from an adapter, plus React bindings, message-display and composer plugins, a unified ChatSdkError, 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.