Skip to content

Write HTML. Render video. Built for agents.

chore: release v0.8.159 (#5621)

Miguel Ángelf35b05fba0e8
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index a747fa7d3a..cb6b785a61 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "hyperframes",
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
- "version": "0.8.158",
+ "version": "0.8.159",
"author": {
"name": "HeyGen",
"email": "[email protected]",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 4533bbdc44..ae78ccc434 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "hyperframes",
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
- "version": "0.8.158",
+ "version": "0.8.159",
"author": {
"name": "HeyGen",
"email": "[email protected]",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 546f826ccf..6776791e14 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
"name": "hyperframes",
"displayName": "HyperFrames by HeyGen",
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
- "version": "0.8.158",
+ "version": "0.8.159",
"author": {
"name": "HeyGen",
"email": "[email protected]"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 1c522bd077..2895cd3200 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,33 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
{/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
+<Update
+ label="HyperFrames v0.8.159"
+ description="Released - 2026-10-14"
+ tags={["Release", "CLI"]}
+>
+`check` and `snapshot` now work in sandboxes that refuse to listen on localhost. `snapshot --keep` lets you redo one still without losing the others.
+
+## Features
+
+- **CLI:** `snapshot --keep` redoes one still and leaves the others ([c0636d017f6](https://github.com/heygen-com/hyperframes/commit/c0636d017f68073522ab8eeb6cc24a2d3993b656), [#5605](https://github.com/heygen-com/hyperframes/pull/5605)). It adds to the output folder instead of clearing it and names each still for its time, such as `at-1.5s.png`.
+
+## Fixes
+
+- **Core:** A render's first frame shows each scene's starting state ([8c00ebad80c](https://github.com/heygen-com/hyperframes/commit/8c00ebad80c634f607e3a5283f8a0aa73e35f1dd), [#5614](https://github.com/heygen-com/hyperframes/pull/5614)).
+- **Core:** A hidden scene's contents stay hidden when a child is set visible ([24a9b781715](https://github.com/heygen-com/hyperframes/commit/24a9b781715d0c59f06e4540831529d99c63ae75), [#5619](https://github.com/heygen-com/hyperframes/pull/5619)). Before, a nested scene's card could paint before its host started. The `static-volume-future-set` regression baseline changes for this reason.
+- **CLI:** `check` and `snapshot` run where a sandbox refuses to listen on localhost ([71595dd8201](https://github.com/heygen-com/hyperframes/commit/71595dd82012314f353d1237f50da0fad7639817), [#5618](https://github.com/heygen-com/hyperframes/pull/5618)).
+- **CLI:** The GPU check uses the same pipe as the render, so a sandboxed `check` no longer waits 120 s ([6c89decb0dd](https://github.com/heygen-com/hyperframes/commit/6c89decb0ddbac7c30a7dca6d947f945ebd58c0e), [#5622](https://github.com/heygen-com/hyperframes/pull/5622)).
+- **CLI:** A long video conversion in `init` never stalls on ffmpeg's own log ([b14a4564716](https://github.com/heygen-com/hyperframes/commit/b14a45647166e60e2e51dc018ccb1bb7331003a2), [#5616](https://github.com/heygen-com/hyperframes/pull/5616)).
+
+## Internal
+
+- **Core:** The `var()` font fallback test uses an offline fetch stub instead of Google Fonts ([8f0bcadcd32](https://github.com/heygen-com/hyperframes/commit/8f0bcadcd32893d3ad5231f33b210c410096281f), [#5623](https://github.com/heygen-com/hyperframes/pull/5623)).
+- A stalled history fetch in change detection is retried instead of failing the run ([cd87cf11106](https://github.com/heygen-com/hyperframes/commit/cd87cf11106985c6222723f5b391723882691d6c), [#5615](https://github.com/heygen-com/hyperframes/pull/5615)).
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.158...v0.8.159).
+</Update>
+
<Update
label="HyperFrames v0.8.158"
description="Released - 2026-10-14"
diff --git a/gemini-extension.json b/gemini-extension.json
index 822d558ce3..c46e2db5d2 100644
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,5 +1,5 @@
{
"name": "hyperframes",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames."
}
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index 85dc6f4849..aed07bc847 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/aws-lambda",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
"repository": {
"type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 9a45db0bac..4fb8644498 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/cli",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "HyperFrames CLI — create, preview, and render HTML video compositions",
"license": "Apache-2.0",
"repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 9638b1fc8b..007d1156cd 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/core",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "",
"repository": {
"type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index dc6b14d62a..9e7a833d06 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/engine",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
"repository": {
"type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index d9b961cdd1..1147f14ccd 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/gcp-cloud-run",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
"repository": {
"type": "git",
diff --git a/packages/inspector/package.json b/packages/inspector/package.json
index 33897ae758..2df7b1246f 100644
--- a/packages/inspector/package.json
+++ b/packages/inspector/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/inspector",
- "version": "0.8.158",
+ "version": "0.8.159",
"repository": {
"type": "git",
"url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 724b809355..b13d60e134 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/lint",
- "version": "0.8.158",
+ "version": "0.8.159",
"repository": {
"type": "git",
"url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index ab9449efee..904bf8466c 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/parsers",
- "version": "0.8.158",
+ "version": "0.8.159",
"repository": {
"type": "git",
"url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 723429a886..f19f2fb550 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/player",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "Embeddable web component for HyperFrames compositions",
"repository": {
"type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index 6b9c620a7a..9675a8a554 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/producer",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
"repository": {
"type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index eb1526b738..bfc6964cf0 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/sdk",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "Headless, framework-neutral HyperFrames composition editing engine",
"repository": {
"type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 641c78fce4..f4aedd4b57 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/shader-transitions",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "WebGL shader transitions for HyperFrames compositions",
"repository": {
"type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index 420cfbb565..3069fe882e 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/studio-server",
- "version": "0.8.158",
+ "version": "0.8.159",
"repository": {
"type": "git",
"url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index c04f3bf791..c62827b239 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/studio",
- "version": "0.8.158",
+ "version": "0.8.159",
"description": "",
"repository": {
"type": "git",
diff --git a/plugin.json b/plugin.json
index 91e66c0960..3c443cd984 100644
--- a/plugin.json
+++ b/plugin.json
@@ -2,7 +2,7 @@
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "hyperframes",
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
- "version": "0.8.158",
+ "version": "0.8.159",
"author": {
"name": "HeyGen",
"email": "[email protected]",
diff --git a/releases/v0.8.159.md b/releases/v0.8.159.md
new file mode 100644
index 0000000000..a220ebf4a0
--- /dev/null
+++ b/releases/v0.8.159.md
@@ -0,0 +1,26 @@
+# HyperFrames v0.8.159
+
+Released on 2026-10-14.
+
+`check` and `snapshot` now work in sandboxes that refuse to listen on localhost. `snapshot --keep` lets you redo one still without losing the others.
+
+## Features
+
+- **CLI:** `snapshot --keep` redoes one still and leaves the others ([c0636d017f6](https://github.com/heygen-com/hyperframes/commit/c0636d017f68073522ab8eeb6cc24a2d3993b656), [#5605](https://github.com/heygen-com/hyperframes/pull/5605)). It adds to the output folder instead of clearing it and names each still for its time, such as `at-1.5s.png`.
+
+## Fixes
+
+- **Core:** A render's first frame shows each scene's starting state ([8c00ebad80c](https://github.com/heygen-com/hyperframes/commit/8c00ebad80c634f607e3a5283f8a0aa73e35f1dd), [#5614](https://github.com/heygen-com/hyperframes/pull/5614)).
+- **Core:** A hidden scene's contents stay hidden when a child is set visible ([24a9b781715](https://github.com/heygen-com/hyperframes/commit/24a9b781715d0c59f06e4540831529d99c63ae75), [#5619](https://github.com/heygen-com/hyperframes/pull/5619)). Before, a nested scene's card could paint before its host started. The `static-volume-future-set` regression baseline changes for this reason.
+- **CLI:** `check` and `snapshot` run where a sandbox refuses to listen on localhost ([71595dd8201](https://github.com/heygen-com/hyperframes/commit/71595dd82012314f353d1237f50da0fad7639817), [#5618](https://github.com/heygen-com/hyperframes/pull/5618)).
+- **CLI:** The GPU check uses the same pipe as the render, so a sandboxed `check` no longer waits 120 s ([6c89decb0dd](https://github.com/heygen-com/hyperframes/commit/6c89decb0ddbac7c30a7dca6d947f945ebd58c0e), [#5622](https://github.com/heygen-com/hyperframes/pull/5622)).
+- **CLI:** A long video conversion in `init` never stalls on ffmpeg's own log ([b14a4564716](https://github.com/heygen-com/hyperframes/commit/b14a45647166e60e2e51dc018ccb1bb7331003a2), [#5616](https://github.com/heygen-com/hyperframes/pull/5616)).
+
+## Internal
+
+- **Core:** The `var()` font fallback test uses an offline fetch stub instead of Google Fonts ([8f0bcadcd32](https://github.com/heygen-com/hyperframes/commit/8f0bcadcd32893d3ad5231f33b210c410096281f), [#5623](https://github.com/heygen-com/hyperframes/pull/5623)).
+- A stalled history fetch in change detection is retried instead of failing the run ([cd87cf11106](https://github.com/heygen-com/hyperframes/commit/cd87cf11106985c6222723f5b391723882691d6c), [#5615](https://github.com/heygen-com/hyperframes/pull/5615)).
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.8.158...v0.8.159