Skip to main content
Versions follow the npm package. Breaking changes are tagged; migrate before upgrading. The same version is published to WK Artifactory and promoted to the WK CDN.
​
20 August 2026
  • Add support for nested external document attachments in setDocumentSuggestion().
  • Improve SDK external document suggestions by checking availability in the background when the suggestion chip appears and attaching after the user clicks it.
  • Keep the SDK loader visible until the authenticated chat is ready, and show the SDK error page instead of a blank iframe when startup fails.
  • Fix downloading a generated Word document, which saved an HTML error page instead of the .docx file.
  • Hide the “Open in sidebar” button and the file chip preview for generated Word documents until the SDK has a document viewer.
  • Return users to the requested page in the main Libra app after an SDK link leads them through login or signup.
  • Preserve selected research sources when continuing from the SDK to Libra.
​
4 August 2026
  • Fix monKEY Belgium citation navigation to emit the canonical monkey_be research source id instead of the legacy wolters_kluwer_monkey_be slug.
  • Fix nested attachment/search submenus overflowing the SDK iframe viewport.
  • Use a chat-bubble icon for the New Chat button instead of a plain plus.
  • Add legal notice footer.
​
14 July 2026
  • Add Libra.openChatById() so product pages can reopen a cited Libra chat after extracting the libraChatId query parameter.
  • Add support for Kleos product.
  • Show an error message when the WK account is already linked/connected to another user.
  • Add account_in_use to the exported LibraAuthErrorReason union; the libra:sdk:auth-error event now emits this reason when the WK account is already linked/connected to another user.
  • Improve UI to match the Libra design system.
  • Show “monKEY (BE)”, instead of “wolters_kluwer_monkey_be”, in insights.
​
3 July 2026
  • Fix inline event handler CSP violations in the SDK header’s close button.
​
Breaking changes
29 June 2026
  • BREAKING: Rename research source slugs to product-oriented names (e.g. wolters_kluwer_nl → inview_legal_nl, wolters_kluwer_de → wko_de). The old slugs are no longer accepted — integrators must migrate to the new names.
  • BREAKING: Remove the ExternalDocumentSource type. ExternalDocument now uses ResearchSourceId for its source field.
  • BREAKING: Drop research sources not exposed by the SDK (e.g. legal/web search, Swiss, EU, and US sources) from ResearchSourceId, which is now limited to the supported products’ sources.
  • BREAKING: Replace onExternalDocumentCitationClick callback with onCitationClick. The event now carries data with source, url, and content (present for “To source”, absent for “View source”). Hosts can call event.preventDefault() to prevent the SDK from opening the URL in a new tab.
  • Add a Libra-branded SDK headbar when onClose is provided; omitting onClose leaves the SDK header out. The close button calls onClose, and the host remains responsible for hiding the SDK wrapper and calling Libra.detach().
  • Show a notice when a context-awareness document is unavailable in the FAB index.
  • Add support for signing out in proxy mode. It removes the user’s identity link on the backend (the next CTE re-auth requires re-linking) and emits unauthenticated / signout.
​
17 June 2026
  • Re-add support for UMD and CJS.
​
Breaking changes
15 June 2026
  • BREAKING: Drop support for UMD and CJS.
  • BREAKING: Add required productId param to Libra.init(). Identifies the legal-research product (e.g. one_it) and is sent on every backend request as the X-Libra-SDK-Product-ID header.
  • BREAKING: In proxy mode, the sign out button is hidden and Libra.signOut() throws.
  • BREAKING: Hide the close button when the host registers no onClose handler.
  • Add a splash screen during the initial load.
  • Redirect to Libra workspace when assistant’s info icon is clicked from above the message input.
  • Show an error page if the BFF proxy returned a 5xx error during startup.
​
Breaking changes
4 June 2026
  • BREAKING: Non-English locales are no longer bundled into libra.js. The main bundle now ships only en-US. The required locales must be either registered explicitly in Libra.init({ locales: [...] }), or added via a CDN locale script tag.
  • BREAKING: Libra.init({ locale }) and Libra.setLocale(locale) now throw synchronously for unregistered locales, instead of silently falling back to en-US.
  • Add proxy option to Libra.init() for routing API requests through a BFF proxy server. When set, the SDK’s localStorage token flow is disabled and auth is handled server-side. Static headers can be injected on every proxied request via proxy.headers.
  • Unify citations modal UI with other modals.
  • Fix translation keys containing an escaped quote (e.g. I've verified my email) being dropped from locale bundles.
  • Reduce main bundle size from 5.4mb to 3.2mb.
​
29 May 2026
  • Add CDN support via https://cdn.wolterskluwer.io/wk/libra-sdk/<VERSION>/libra.js
​
27 May 2026
  • Fix citations popovers not flipping above the message input.
​
22 May 2026
  • Add onExternalDocumentCitationClick callback to Libra.init(). Fires when the user navigates to a cited external document via “To source” in the citation tooltip (type: 'chunk') or “View source” in the citation list (type: 'document'). The event carries url, source, and type, allowing the host app to handle navigation in-place instead of opening a new tab.
  • Add tooltip to the document suggestion chip.
  • Redesign the auth page.
  • Fix external attachment integrations (Kleos, SharePoint, RA-Micro) not working.
  • Keep research sources selected on “New Chat” button click.
  • Hide “To source” / “View source” buttons for uploaded-document citations, since the SDK has no PDF viewer.
  • Support the disable_document_uploads feature flag. When set, attachment options are hidden from the chat input.
  • Support the sdk_only_access feature flag. The “Continue in Libra” button is hidden, and other redirects (e.g. from assistants/workflows) are blocked by a toast. The toast behavior might get replaced in the future by a more fine-grained gating mechanism that either hides or disables the buttons.
​
13 May 2026
  • Add support for German Public Sector sources (de_pubsec_jobcenter, de_pubsec_sozial, de_pubsec_auslr, de_pubsec_star).
​
13 May 2026
  • Fix “Share via email” failing silently in Chromium browsers due to mailto: navigation being blocked from the SDK’s iframe context.
  • Add X-Libra-SDK-Version request header so the backend can track SDK version usage/errors.
​
12 May 2026
  • Add Assistants and Workflows.
  • Redesign message input for SDK mode with compact controls, bottom-aligned dropdowns, and an inline prompt improve/undo button next to the textarea.
  • Fix onboarding view width not being full width on large screens.
  • Fix multiple issues with external document citations in SDK chats.
  • Fix export modal layout on narrow screens.
  • Improve performance of streamed messages by reducing re-renders and memory usage.
​
6 May 2026
  • Fix new chat after loading from history no longer reopens the previous chat.
​
5 May 2026
  • Fix Word export icon.
  • Improve citations icons.
​
Breaking changes
5 May 2026
  • BREAKING: Remove containerId config field from Libra.init(). Call Libra.attach(elementOrId) directly after init() to mount the widget.
  • BREAKING: Rename 'interactive_login' source to 'signin' in LibraAuthState and LibraAuthError.
  • Add sign up and onboarding flows.
  • Add 'signup' source to LibraAuthState and LibraAuthError so hosts can distinguish signup outcomes from signin outcomes.
  • Add mountTarget config field to Libra.init() so the host can choose the wrapper’s parent element (defaults to document.body). Lets the host scope the SDK’s z-index: 999999 to a subtree they own instead of having it dominate the page’s root stacking context.
  • Add zIndex config field to Libra.init() to override the wrapper’s z-index (defaults to 999999). Pairs with mountTarget so hosts can lower the SDK below their existing small z-index values (e.g. 5) instead of bumping host overlays past 999999.
  • Add Libra.setLocale() to change the widget’s UI language at runtime.
  • Adhere to the configured locale when opening the login popup.
  • Preserve research sources selection when the chat is restored from history or after a host page reload.
  • Handle blocked states (e.g. unverified email, expired trial / canceled subscription, pending team membership, and inactive subscription) UI instead of showing a blank iframe.
  • Fix “Connect your account”, “More about {source}”, and Otto Schmidt license-management actions silently doing nothing inside the SDK. They now open the relevant page or settings modal on the main app in a new browser tab.
  • Fix newly created chats not being restored after a host page reload. Previously, only chats reopened from history would resume.
​
24 April 2026
  • Add onAuthStateChange and onAuthError callbacks to Libra.init() so host can listen to auth changes/errors.
  • Add support for the following locales: de-CH, fr-CH, it-CH.
  • Restore last active chat session after page reloads and page navigation in MPAs (multi-page applications).
  • Reduce bundle size from 5.1 to 3.9mb.
  • Reduce startup latency by 10-15%.
  • Use icon instead of text (“Add {title} to chat” -> ”+ {title}”) for document suggestion chips.
  • Hide “New Chat” button’s label on small screens.
  • Fix citations list not showing when clicking on “Cited Sources” pill at the bottom of a message.
  • Fix “scroll to bottom” overlap with the research sources dropdown.
  • Fix “scroll to bottom” overlap with the document suggestion chip.
​
Breaking changes
21 April 2026
  • BREAKING: Remove documentSource config field from Libra.init().
  • BREAKING: Update setDocumentSuggestion() to accept source as a parameter.
  • Introduce new UI for the chat interface.
  • Reduce bundle size from 11.8mb to 5.1mb.
  • Fix multiple icons issues that were not loading properly in insights, citations, etc.
  • Fix the welcome message truncated text.
​
16 April 2026
  • Add documentSource config field on Libra.init() to identify the research source that owns documents suggested via setDocumentSuggestion().
  • Add Libra.setDocumentSuggestion() to set a document suggestion from the host page. The document is shown as an “Add to chat” chip in the chat UI, and when the user clicks it, the document is attached to the message so Libra can retrieve its content.
  • Add Libra.clearDocumentSuggestion() to clear the current document suggestion.
  • Add attach(elementOrId) / detach() API to separate session lifecycle from DOM mounting. The iframe now lives on document.body and is positioned over the target element via position: fixed + rAF sync, so the full chat session (conversation, scroll position, streaming responses) survives across different containers and SPA route changes. containerId is now optional — if omitted, call attach() manually.
​
13 April 2026
  • Remove third-party type dependencies (svelte, i18next) from the built .d.ts files. Consumers no longer need skipLibCheck or Svelte/i18next in their dependencies.
  • Deliver config to the iframe via postMessage instead of an inline <script> tag. The iframe HTML is now fully static, so CSP hashes remain stable across config changes.
  • Move the input textarea to the bottom of the chat container.
​
1 April 2026
  • Namespace localStorage keys under libra: to avoid key collisions with the host page.
​
1 April 2026
  • Prevent session cookies from being sent with API requests.
  • Remove trailing slash from baseUrl to avoid double slashes in the URL.
​
30 March 2026
  • Initial release.