v0.8.152

heygen-com/hyperframesv0.8.152Oct 13, 2026by github-actions[bot]

Upgrading?

AI Summary

This release organizes project artifacts by revision, improves project history tracking, and introduces CLI flags for exclusive agent turn management. It also fixes keyframe timing reporting and cleans up old revision evidence.

Key Highlights

  • Artifacts are now saved in `.hyperframes/artifacts/` folders tied to specific revisions, replacing the old `snapshots/` directory.
  • Project history now tracks video state, edit targets, and cleanup actions for better debugging.
  • New CLI flags (`--exclusive`, `--who`, `--if-open`) allow agents to control turn access in shared projects.
  • Keyframes now accurately report unresolved GSAP timing instead of guessing rest poses.

Breaking Changes

  • Default snapshots moved from `snapshots/` to `.hyperframes/artifacts/snapshots/<id>/`. Scripts reading the old path will find nothing.

New Features

  • CLI: Save check, snapshot, and render artifacts per revision.
  • Studio: Record video state, edit targets, and artifact cleanup in project history.
  • CLI: Guard history turns with --exclusive, --who, and --if-open.

Full Release Notes

# HyperFrames v0.8.152

Released on 2026-10-13.

Check and snapshot save each run in its own folder tied to the revision it came from, and renders clean up evidence from old revisions. Project history keeps `.hyperframes/video-state.json` current after every edit and records which element each edit targeted. Agents sharing a project can refuse to start while another agent's turn is open (`--exclusive`), end only their own turn (`--who`), and end safely when no turn is open (`--if-open`).

## Compatibility notes

- Default snapshots moved from `snapshots/` to `.hyperframes/artifacts/snapshots/<id>/`. Check reports are written to `.hyperframes/artifacts/checks/<id>.json`. A render also writes `.hyperframes/render-outputs.json`. Anything still reading `snapshots/` will find nothing. [#5522](https://github.com/heygen-com/hyperframes/pull/5522)

## Features

- **CLI:** Save check, snapshot and render artifacts per revision ([23d1fe5b4](https://github.com/heygen-com/hyperframes/commit/23d1fe5b42724a5a9c0458475176d6bddfa235b1), [#5522](https://github.com/heygen-com/hyperframes/pull/5522)).
- **Studio:** Record video state, edit targets and artifact cleanup in project history ([893b4f675](https://github.com/heygen-com/hyperframes/commit/893b4f6757f4d6e8c6a1deb9d2c4743119694b46), [#5524](https://github.com/heygen-com/hyperframes/pull/5524)).
- **CLI:** Guard history turns with --exclusive, --who and --if-open ([7c73b3cae](https://github.com/heygen-com/hyperframes/commit/7c73b3caeebc2fd8db2f161f25d4f476ac2f78e2), [#5518](https://github.com/heygen-com/hyperframes/pull/5518)).

## Fixes

- **Keyframes:** Report unresolved GSAP timing instead of guessing rest poses ([8e4de38be](https://github.com/heygen-com/hyperframes/commit/8e4de38be1bdf098a7469a98ed654a932351f327), [#5526](https://github.com/heygen-com/hyperframes/pull/5526)). `keyframes --json` can return null for `start`, `end`, `duration`, and `time` when that timing cannot be resolved.
- **CLI:** Turn off onnxruntime telemetry for Kokoro synthesis ([f25cfbd6b](https://github.com/heygen-com/hyperframes/commit/f25cfbd6bd11d7bb8bd53ea686767c46f8eb146c), [#5425](https://github.com/heygen-com/hyperframes/pull/5425)).

## Catalog

- **Catalog:** Match preview length to authored compositions ([fb4189ca7](https://github.com/heygen-com/hyperframes/commit/fb4189ca7257411307358b39b6746d42b97f95fd), [#5533](https://github.com/heygen-com/hyperframes/pull/5533)).

## Internal

- **Inspector:** Publish @hyperframes/inspector to npm ([f31b3c982](https://github.com/heygen-com/hyperframes/commit/f31b3c982be997897ba989c9975c9b44fe491fda), [#5530](https://github.com/heygen-com/hyperframes/pull/5530)).

## Full changelog

https://github.com/heygen-com/hyperframes/compare/v0.8.151...v0.8.152

Related Repositories