Video Effects SDK 3.14.0 for Web

This release fixes preload_auth: false, makes the SDK more resilient to licensing outages, and adds an LLM integration guide.

Fixed#

• preload_auth: false no longer blocks effects. Before this fix, turning the flag off skipped the licensing handshake but still created the inference session. That failed with Model data pointer is null, so effects never started. Now, with the flag off, the SDK downloads the model and starts the worker during loading/preload(), then runs the handshake and creates the session the first time an effect needs its model. No licensing request is sent until then. Expect that first use to take a little longer.
• Provider switching authenticates the target runtime. switchProvider now authenticates the runtime it switches to, which may differ from the one used by the current session.
• Licensing failures no longer move inference to the main thread. A failed licensing request used to look like a crashed worker. The SDK would retry from the main thread and stop using the worker until sessions were released, so a short licensing outage could leave inference on the main thread. Licensing failures are now reported as a typed SdkError with their original code and message. Real worker failures still fall back as before.
• Correct error code for licensing failures during the WebGPU → WASM fallback. When WebGPU ran on the main thread and WASM in the worker, a licensing failure during the fallback was reported as MODEL_INITIALIZATION_ISSUE (1022). That code points at sdk_url/CORS instead of licensing. These failures are now reported as SESSION_INITIALIZATION_ISSUE (1021). Real session creation failures still report 1022 with their details.
• Clearer error when the licensing response has no key. This case is now reported as a missing key instead of a generic failure.

Added#

• llms.txt. An integration guide for LLM coding assistants. It covers the public API, configuration options, error codes, and common setups.

Upgrading#

No configuration changes are needed when upgrading from 3.13.1.

If you use preload_auth: false, effects now start as expected. The licensing handshake and session creation happen when an effect first needs its model, not at load time:

sdk.config({
  preload_auth: false
});