Changelog

6.22

6.22.0

Release date: 28.08.2026

This version of @interopio/desktop comes with @interopio/core 6.11.0.

Breaking Changes

  • The Intent Resolver UI now uses the Displays API. If the Intent Resolver UI is enabled (which is the default), the Displays API will be enabled as well, even if you have explicitly disabled it in the configuration object, and the library will log a warning in the console. To disable the Displays API, you must now also disable the Intent Resolver UI.

New Features

  • Added a path property to the download object provided to the onUpdate() handler and returned by the list() method of the Downloads API.
  • Added clearStorageData() and clearAuthCache() methods to the iodesktop object.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.11.0.
  • Fixed the Intent Resolver UI starting position calculations on vertical display setups.
  • Fixed iodesktop.os.getProcesses() throwing on every call. The startTime property of the returned objects is now correctly typed as string | null.

6.21

6.21.0

Release date: 30.06.2026

This version of @interopio/desktop comes with @interopio/core 6.10.6.

New Features

  • Added getLayoutContents() method to the Layouts API for retrieving the contents of Global and Workspace Layouts.
  • Added setAutoSave() and getAutoSave() methods accessible via the iodesktop.downloads object.
  • Added a path option to the DownloadOptions object passed as a second argument to the download() method of an IOConnectWindow instance.
  • The Apps API start() method now throws a typed error exposing the already-running instance when a single-instance app is started again.

Improvements & Bug Fixes

  • Improved handling of Layout contexts to preserve user-supplied context key casing.
  • Improved handling of exceptions thrown by the Apps API event handler callbacks to prevent breaking the event stream.
  • Fixed onInteropReady() firing its callback twice.

6.20

6.20.4

Release date: 08.06.2026

This version of @interopio/desktop comes with @interopio/core 6.10.6.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.10.6.
  • Updated @interopio/insights-base, @interopio/insights-metrics, and @interopio/insights-traces to ^0.1.0.

6.20.3

Release date: 05.06.2026

This version of @interopio/desktop comes with @interopio/core 6.10.5.

Improvements & Bug Fixes

  • Improved getSavePath() and getSavePathList() types to return objects with a path property.
  • Updated @interopio/insights-metrics to ^0.0.189 to fix @opentelemetry/sdk-metrics externalization in the published bundle.

6.20.2

Release date: 21.05.2026

This version of @interopio/desktop comes with @interopio/core 6.10.5.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.10.5.
  • Fixed App Management tracing to safely access properties on window instances.
  • Added instanceId to App Management event tracing metadata.

6.20.1

Release date: 30.04.2026

This version of @interopio/desktop comes with @interopio/core 6.10.4.

Improvements & Bug Fixes

  • Fixed circular Channels re-exports and fixed call sites.

6.20.0

Release date: 29.04.2026

This version of @interopio/desktop comes with @interopio/core 6.10.4.

New Features

  • Added convertBounds() and getByBounds() methods to the Displays API.
  • Added screenBounds, screenWorkArea, electronId, electronBounds, electronWorkArea, and screenScaleFactor properties to the Display object of the Displays API.
  • Exposed ioDesktopInfo global service object. Renamed GDObject (kept as a deprecated alias) to IODesktopObject.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.10.4.
  • The data argument passed to the set(), setFor(), update(), and updateFor() methods of the App Preferences API is now typed as Data (was any).
  • Fixed download() method in the Window Management API to validate URL and options arguments.
  • Fixed the default layout label to not disappear on restore.
  • Aligned isObject handling and validation across io.Connect Desktop, io.Connect Browser, and io.Manager.
  • Removed @interopio/otel direct dependency.

6.19

6.19.0

Release date: 29.04.2026

This version of @interopio/desktop comes with @interopio/core 6.9.1.

New Features

  • Added OpenTelemetry tracing instrumentation across all APIs.
  • Re-exported IOInsights from @interopio/core.

6.18

6.18.0

Release date: 10.03.2026

This version of @interopio/desktop comes with @interopio/core 6.8.1.

New Features

  • The Apps API inMemory.remove() method now accepts an array of app names for batch removal.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.8.0.

6.17

6.17.0

Release date: 09.02.2026

This version of @interopio/desktop comes with @interopio/core 6.7.3.

New Features

  • Added a customConfig property in the Intent handler and Intent definition types.

Improvements & Bug Fixes

  • Changed onShuttingDown() return type to UnsubscribeFunction.
  • Deprecated the timeout option in the RestoreOptions object passed to the restore() method of the Layouts API.
  • Fixed the Channels API to prevent callback replay after handler invocation.
  • Added validations for the addIntentListener() of the Intents API method.
  • Increased the timeout for streams from 30 to 90 seconds.

6.16

6.16.3

Release date: 20.01.2026

This version of @interopio/desktop comes with @interopio/core 6.7.3.

Improvements & Bug Fixes

  • The lastUpdate property in the AppPreferences object of the App Preferences API is now typed as Date.

6.16.2

Release date: 20.01.2026

This version of @interopio/desktop comes with @interopio/core 6.7.3.

Improvements & Bug Fixes

  • Improved App Management types.

6.16.1

Release date: 19.01.2026

This version of @interopio/desktop comes with @interopio/core 6.7.3.

Improvements & Bug Fixes

  • Fixed the library to not initialize the Apps API when the respective platform Interop method is unavailable.
  • Fixed the get() method of the App Preferences API returning an unparsed fetch response.

6.16.0

Release date: 01.12.2025

This version of @interopio/desktop comes with @interopio/core 6.7.3.

New Features

  • Added a new Apps API (io.apps) with app registry, in-memory store, and instance management.
  • Added a new Platform API (io.platform) with restart(), shutdown(), and onShuttingDown() methods.
  • Added a createPopup() method to the Window Management API.
  • Added a getChannels() method to the Window Management API for retrieving currently joined Channels.
  • Added setDockingConfig(), getDockingConfig(), and undock() methods to the Window Management API.
  • Added "multi" and "directionalMulti" Channel Selector types.
  • Added a restoreWorkspacesByReference option to the RestoreOptions object of the Layouts API.

Improvements & Bug Fixes

  • Deprecated the App Management API (io.appManager) in favor of the new Apps API. The App Management API is still available for backward compatibility, but will be removed in a future release.
  • Improved the reconnection logic.

6.15

6.15.0

Release date: 28.10.2025

This version of @interopio/desktop comes with @interopio/core 6.5.3.

New Features

  • Added an excludeList property in the HandlerFilter object of the Intents API with AppHandlerExclusion and InstanceHandlerExclusion criteria types.

Improvements & Bug Fixes

  • Updated @interopio/core to 6.5.3.
  • Fixed Channels creation inconsistency.

6.14

6.14.0

Release date: 16.06.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

New Features

  • Added dragMove() method to the Windows API.
  • Added clearPlacement() method to the Windows API with ClearPlacementSettings options.
  • Added showInTaskbar option to the Windows configure() method.
  • Added saveBounds window option for persisting last known bounds.
  • Added search window setting for enabling in-app search (CTRL + F).
  • Added onDefaultGlobalChanged() event to the Layouts API.
  • The onRenamed() event in the Layouts API now receives the old name as a second argument.
  • Added ignoreContexts option to the Layouts save() method.
  • Added autoHidePanel option to the Notification Panel configuration.

Improvements & Bug Fixes

  • Fixed App Management hanging on initialization with appManager: "full" outside the platform.

6.13

6.13.1

Release date: 29.05.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

Improvements & Bug Fixes

  • Fixed group.onClosing() throwing an unhandledrejection error when the group is closed before the event is subscribed.

6.13.0

Release date: 05.05.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

New Features

  • Added group.reload() method to the Windows API.

6.12

6.12.0

Release date: 08.04.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

New Features

  • Channels API now works outside the platform.
  • Added clearChannelData() method to the Channels API.
  • Added FDC3Context interface to the types.

Improvements & Bug Fixes

  • Changed the leave() method signature to accept an options object or a string.
  • Fixed focus() and active() methods in the Windows API to always resolve.
  • Improved onLayoutModified() event to clarify first-modification-only behavior.

6.11

6.11.0

Release date: 10.03.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

Improvements & Bug Fixes

  • Increased the timeout for Interop methods to 90 seconds.
  • Fixed a race condition in appManager.start().
  • Added validations for various methods.
  • Updated @interopio/core and @interopio/fdc3.

6.10

6.10.2

Release date: 17.02.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

Improvements & Bug Fixes

  • Internal dependency updates.

6.10.1

Release date: 11.02.2025

This version of @interopio/desktop comes with @interopio/core 6.5.2.

Improvements & Bug Fixes

  • Internal dependency updates.

6.10.0

Release date: 08.01.2025

This version of @interopio/desktop comes with @interopio/core 6.4.3.

New Features

  • Added support for multi Channels: getMyChannels(), myChannels(), onChannelsChanged() methods, and mode property.
  • The Channels leave() method now accepts an options object or a string.
  • Added iodesktop.preloadScripts property and iodesktop.regeneratePreloads() method for managing preload script cache.
  • Added iodesktop.getPath() method for retrieving system paths by name.

Improvements & Bug Fixes

  • The Windows navigate() method now accepts a timeout parameter.

6.9

6.9.2

Release date: 08.01.2025

This version of @interopio/desktop comes with @interopio/core 6.5.0.

Improvements & Bug Fixes

  • Internal dependency updates.

6.9.1

Release date: 14.11.2024

This version of @interopio/desktop comes with @interopio/core 6.4.3.

Improvements & Bug Fixes

  • Internal dependency updates.

6.9.0

Release date: 13.11.2024

This version of @interopio/desktop comes with @interopio/core 6.4.2.

New Features

  • Added executeJavaScript() method access through the external API.
  • Added bulk update for Notifications from the Notification Panel.
  • Added onHandlerAdded() and onHandlerRemoved() events to the Intents API.
  • Added import() method to the Notifications API for batch importing notifications.
  • Added clearSavedHandlers() method and clearSavedHandler request property to the Intents API.
  • Added closeNotificationOnClick option to the Notifications configure() method.
  • Added displayId and displayPath properties for nested notification action menus.
  • Added pinned tabs methods and properties.
  • Added the Interception API.
  • Added FDC3 parsing options to the Channels API.

6.8

6.8.4

Release date: 17.10.2024

This version of @interopio/desktop comes with @interopio/core 6.4.2.

Improvements & Bug Fixes

  • Bumped version due to Workspaces API release.

6.8.3

Release date: 03.10.2024

This version of @interopio/desktop comes with @interopio/core 6.4.2.

Improvements & Bug Fixes

  • Added missing FDC3 dependency.

6.8.2

Release date: 27.09.2024

This version of @interopio/desktop comes with @interopio/core 6.4.2.

Improvements & Bug Fixes

  • Updated ChannelContext data type.

6.8.1

Release date: 26.09.2024

This version of @interopio/desktop comes with @interopio/core 6.4.2.

Improvements & Bug Fixes

  • Fixed ignoring peerID when the invocation target has an instance.

6.8.0

Release date: 18.09.2024

This version of @interopio/desktop comes with @interopio/core 6.4.1.

New Features

  • Added onChannelRestrictionsChanged(), isPinned(), pin(), unpin(), executeCode(), clearMany(), setStates(), and snoozeMany() methods.
  • Added setAllowWorkspaceDrop() method and allowWorkspaceDrop property to the IOConnectWindow object.

6.7

6.7.0

Release date: 05.09.2024

This version of @interopio/desktop comes with @interopio/core 6.4.0.

New Features

  • Extended Channels methods with FDC3 options.

6.6

6.6.1

Release date: 04.09.2024

This version of @interopio/desktop comes with @interopio/core 6.3.5.

Improvements & Bug Fixes

  • Internal dependency updates.

6.6.0

Release date: 07.08.2024

This version of @interopio/desktop comes with @interopio/core 6.3.4.

New Features

  • Added reset() and getRestoredLayoutsInfo() methods to the Layouts API.
  • The Layouts resume()/restore() methods now return the restored instances.

6.5

6.5.1

Release date: 15.07.2024

This version of @interopio/desktop comes with @interopio/core 6.3.3.

Improvements & Bug Fixes

  • Unified repo version bump.

6.5.0

Release date: 03.07.2024

This version of @interopio/desktop comes with @interopio/core 6.3.1.

New Features

  • Added setPath() and setPaths() methods to the Contexts API.

Improvements & Bug Fixes

  • Fixed activate()/focus() never resolving in certain cases.
  • Fixed App Management start() to allow overriding the timeout.

6.4

6.4.0

Release date: 15.05.2024

This version of @interopio/desktop comes with @interopio/core 6.2.1.

New Features

  • Added support for Channel restrictions.

Improvements & Bug Fixes

  • Updated types.
  • Updated @interopio/schemas to 9.3.0.

6.3

6.3.1

Release date: 04.04.2024

This version of @interopio/desktop comes with @interopio/core 6.2.1.

New Features

  • Added snooze support to the Notifications API.
  • Added showPopup() method to the Window group object.
  • Added create() and close() group methods to the Windows API.
  • Added instance.startedBy() method to the App Management API.
  • Added restrict(), restrictAll(), and getRestrictions() methods to the Channels API.

Improvements & Bug Fixes

  • Fixed Preferences getAll() typings.
  • Updated @interopio/core to 6.2.1.

6.2

6.2.2

Release date: 28.02.2024

This version of @interopio/desktop comes with @interopio/core 6.1.0.

New Features

  • The Notifications click() method now accepts a third optional options argument.

6.2.1

Release date: 26.02.2024

This version of @interopio/desktop comes with @interopio/core 6.1.0.

Improvements & Bug Fixes

  • Fixed myApplication returning undefined in Web Groups and Workspaces.

6.2.0

Release date: 20.02.2024

This version of @interopio/desktop comes with @interopio/core 6.1.0.

New Features

  • Added ability to change the Notification Panel and toasts position.
  • Added clone() method to the Windows API.
  • Added filterHandlers() method to the Intents API.
  • Added getIntents() method to the Intents API for retrieving Intents by handler.
  • Added iodesktop.downloads object with list(), pauseResume(), removeItem(), and setSavePath() methods for managing downloads programmatically.

Improvements & Bug Fixes

  • Fixed Notifications onDataChanged() typings.
  • Fixed Notifications onClose() typings.
  • Fixed Preferences lastUpdate typings.
  • Removed shortid dependency.
  • Updated @interopio/core to 6.1.0.

6.1

6.1.0

Release date: 13.12.2023

This version of @interopio/desktop comes with @interopio/core 6.0.2.

New Features

  • Added setAsCurrent option to the Layouts save() method.
  • The Intents register() handler now receives the caller as a second argument.
  • Added dock() method and onDockingChanged() event to the Windows API.
  • Added autoArrange() method and onArrangementChanged() event to the Windows API.
  • Added group.onClosing() event for preventing window group closing.
  • Added support for updating the Notification data field and listening for updates.

Improvements & Bug Fixes

  • Fixed isHibernated to return the correct value.
  • Fixed a memory leak in the Windows API.

6.0

6.0.2

Release date: 13.11.2023

This version of @interopio/desktop comes with @interopio/core 6.0.2.

Improvements & Bug Fixes

  • Internal dependency updates and fixes.

6.0.1

Release date: 04.10.2023

This version of @interopio/desktop comes with @interopio/core 6.0.2.

Improvements & Bug Fixes

  • Fixed compatibility with Glue42 3.x.

6.0.0

Release date: 03.10.2023

This version of @interopio/desktop comes with @interopio/core 6.0.2.

New Features

  • Rebranded to interop.io.

Improvements & Bug Fixes

  • Fixed Layouts to check for old methods when calling the new ones.

  • Fixed Notifications click Interop method not working if the raiser is closed.