# What changed in @module-federation/runtime

> 20 changes in @module-federation/runtime 2 from its official release notes, upgrade guides and advisories: 2 breaking, 14 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@module-federation/runtime/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @module-federation/runtime 2

### Breaking changes

- Legacy share-scope metadata is ignored during shared registration and resolution. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- Shared and eager loading evidence is gated to stable runtime 2.5.0+ for Chrome-extension compatibility. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)

### New APIs and options

- The existing render and destroy hooks now receive semantic context. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- A route synchronization hook is added. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- The shared-version satisfy helper is now re-exported for use by developers. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- These hooks now receive explicit load context, enabling context-aware shared registration and resolution. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- A build-specific export provides build summaries and build error reports. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- A separate observability plugin entry uses an independent name and fixed browser scope for Chrome-extension compatibility. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- Error stack capture is configurable, with explicit opt-ins for raw stacks in console output. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- getInstance now supports finder callbacks, clarifying how developers can find runtime instances. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- A local collector mode supports AI-assisted browser debugging. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- A Node-specific export provides file reports. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- An opt-in observability plugin adds runtime and build reports, lifecycle and phase events, loading outcomes, and normalized error details for debugging. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- Matched remotes can receive an explicitly injected temporary React callback when they finish loading. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- Lifecycle hooks are available for remotes and shared modules. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)
- Opt-in console traces are available for loadRemote and loadShare operations. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)

### Behavior and default changes

- These diagnostics are kept in the observability plugin. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- Dedicated runtime error codes identify invalid manifests, missing exposes, and remote container init failures. (2.5.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#250)

### Fixes and other changes

- Timing, sanitization, and correlation remain in the observability plugin. (2.9.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#290)
- Instance creation now includes id and options. (2.4.0) — [release notes](https://github.com/module-federation/core/blob/a34a045c8c9d71685c6bc00ed5da8eb096eef51a/packages/runtime/CHANGELOG.md#240)