Vega SDK v0.22.1 - v0.22.3 Patch Release Notes

Vega Open Beta Announcements
1

Hello Vega developers,

Version 0.22.1 restored two key capabilities that were missing or reverted from the initial v0.22 release: the Amazon Devices Builder Tools MCP server for AI-assisted performance diagnostics, and the KeplerCrypto cryptography library. The patch also resolved several developer environment issues, including a broken ESLint plugin installation, USB connectivity instability during active development, and app crashes triggered by Bluetooth game controller pairing.

Version 0.22.2 centered on a new W3C Media v2 module that delivered broad media playback improvements — including restored caption positioning, TrackEvent API alignment with the W3C spec, MPEG-2 video support, and a new pitch adjustment function for HLS playback. This release also resolved the carousel component error introduced as a known issue in v0.22.1, patched a security vulnerability in the media packages, and expanded the MCP server with formal spec definitions and telemetry integration.

Version 0.22.3 was a targeted security-only patch, removing a known vulnerability from the KeplerMediaDescriptor package by eliminating a problematic transitive dependency. No code changes are required to receive the fix — updating the npm package is sufficient.

Full release notes available here on the developer portal, and listed below:

Vega SDK version 0.22.3

Vega SDK version 0.22.3 is a targeted security patch for KeplerMediaDescriptorTM that also includes VDA connection mode toggling.

This release requires OS 1.1 (1001010444459) on your Vega Fire TV Stick, which is compatible with the Vega SDK v0.22.3. You can check your device software version by navigating to My Fire TV > About.

Resolved issues

Security remediation completed across media stack

This release removes the react-native-tscodegen-types dependency from Ke.plerMediaDescriptor, eliminating the logkitty@0.6.1 security vulnerability.

To receive this fix, update your npm package for KeplerMediaDescriptorTM to version 1.1.15. No code changes are required.

Package updates

Version 0.22.3 includes the following npm packages updates:

  • KeplerMediaDescriptorTM — Security vulnerability remediation (npm version bump included in 1.1.15)

Improvements

VDA connection mode toggle now available.

You can now switch between USB and network mode and configure the VDA listening port directly from the device. This improvement eliminates the need for a factory reset when locked out in TCP/IP mode.

Vega SDK version 0.22.2

This release includes the new W3C Media v2 module (IW3cmedia_2), bringing substantial media playback improvements.

This release requires OS 1.1 (1001010444459) on your Vega Fire TV Stick, which is compatible with the Vega SDK v0.22.2. You can check your device software version by navigating to My Fire TV > About.

Improvements

W3C Media v2 brings comprehensive playback improvements

A new W3C Media API module (IW3cmedia_2) is now available for apps running on OS build 4459 or later. The @amzn/react-native-w3cmedia v2.2.11 package includes the following updates:

  • Playback performance no longer degrades from redundant onCaptionViewCreated callback invocations.

  • Caption positioning through vertical and horizontal anchor points restored.

  • The TrackEvent APIs (TextTrack, VideoTrack, and AudioTrack) now match the W3C specification, improving interoperability with apps that rely on standard behavior.

  • Adds MPEG-2 video playback in Codec to address a gap that caused playback failures.

  • A new pitchMultiplier function enables real-time audio pitch adjustment during HTTP Live Streaming (HLS) video playback. Use this function for karaoke features or speed-adjusted playback without pitch distortion.

Apps using @amzn/react-native-w3cmedia v2.2.11 or later must run on OS build 4459 or later.

MCP server capabilities expanded

The Amazon Devices Builder Tools MCP server (formerly @amazon-devices/vega-devtools-mcp, now @amazon-devices/amazon-devices-buildertools-mcp) has been updated with additional capabilities. Formal Vega Developer Tools specification definitions have been added to the knowledge base documentation, improving the accuracy and relevance of AI-assisted diagnostics. CLI specification discovery has been enhanced, and metrics and KIA telemetry integration have been added to provide better team context for AI-assisted diagnostics.

No OS update is required and introduces no breaking changes. Update your npm package to receive the improvements.

Resolved issues

Carousel component compatibility restored

Apps using @amazon-devices/vega-carousel v0.1.3 or v0.1.4 displayed Unimplemented Error messages on all carousel cards due to the com.amazon.keplerscript.carousel.so native library linking against a library blocked by LNS enforcement. The latest package for the carousel component, @amazon-devices/vega-carousel v0.1.5, fixes the LNS compliance issue.

Update the npm package to receive the fix. If you can’t update to the latest package, an interim workaround is available. You can use an LNS allowlist entry as a temporary measure, though this bypasses LNS enforcement rather than fixing the root cause. Migrate to v0.1.5 as soon as possible to ensure long-term compatibility.

Security vulnerability eliminated from media packages

The logkitty@0.6.1 security vulnerability has been removed from @amzn/react-native-w3cmedia.

The fix removes the react-native-tscodegen-types dependency from @amzn/react-native-w3cmedia, eliminating the entire vulnerable dependency chain. Update to the latest version of the package to receive the fix. No code changes are required.

Package updates

Version 0.22.2 includes the following npm packages updates:

  • @amazon-devices/amazon-devices-buildertools-mcp → 0.1.24 — MCP server enhancements

  • @amazon-devices/vega-carousel → 0.1.5 or later (0.1.8 on release-3.0 branch) — LNS compliance fix

  • @amzn/react-native-w3cmedia → 2.2.21 — W3C Media v2 and security fix (note: still @amzn/ scope, not yet rescoped to @amazon-devices/)

  • @amzn/keplermediadescriptor → 1.1.15 — Media descriptor update (note: still @amzn/ scope)

Vega SDK version 0.22.1

KeplerCryptoTM version 2.1.2, restored in v0.22.1, provides enhanced cryptographic capabilities.

This release requires OS 1.1 (1001010444457) on your Vega Fire TV Stick, which is compatible with the Vega SDK v0.22.1. You can check your device software version by navigating to My Fire TV > About.

Improvements

AI-assisted development tooling introduced

The Amazon Devices Builder Tools MCP server was not included in the initial v0.22 release and has been added in this patch. This tool provides AI-assisted performance diagnostics, helping you identify and resolve performance issues more quickly. The server includes capabilities for analyzing Time-to-First Frame and Time-to-Fully Drawn metrics, a curated prompt library for Vega-specific debugging scenarios, and context-aware CLI specification discovery.

You can install the MCP server with npm:npm install @amazon-devices/amazon-devices-buildertools-mcp. No OS update is required to use the MCP server.

Cryptography library restored with OS compatibility

KeplerCryptoTM version 2.1.2 has been restored to the SDK after being reverted from the initial v0.22 release.

The restoration introduces no breaking changes and requires no code modifications in apps already using earlier versions of KeplerCryptoTM. However, apps must run on OS build 4457 or later to use this version of the library.

Resolved issues

Development environment stability improved

This release resolves the ESLint plugin installation failure that blocked developers from setting up code quality tooling for new projects. The issue was caused by a webpack configuration problem that included a reference to a package that had been removed from npm before v0.21. The stale dependency reference has been removed, and you can now install @amazon-devices/eslint-plugin-kepler without encountering 404 errors.

This release improves USB device connectivity during active development. Previously, physical devices connected with USB became unresponsive, particularly when using Charles proxy, running repeated application deployments, or working in Metro debug mode.

Some apps crashed when users attempted to pair Bluetooth game controllers. The AccClient library linked against libstdc++.so.6, which is blocked by LNS enforcement. The library now uses LNS-compliant sysroot dependencies, resolving the crash.

Known issues

Apps using @amazon-devices/vega-carousel v0.1.3 or v0.1.4 display Unimplemented Error messages on all carousel cards due to the com.amazon.keplerscript.carousel.so native library linking against a library blocked by LNS enforcement. As an interim workaround, you can use an LNS allowlist entry, though this bypasses LNS enforcement rather than fixing the root cause.

Package updates

The following npm packages were updated Version 0.22.1 includes the following npm packages updates:

  • @amazon-devices/eslint-plugin-kepler → 0.1.13 — ESLint plugin installation fix

  • @amazon-devices/amazon-devices-buildertools-mcp — New MCP server package (initial release)