Files
hyperframes/skills
jieling-jensonandClaude Opus 4.8 d0ee2e834f feat(embedded-captions): opt-in cloud matte via HeyGen CLI background-removal (EC_MATTE=cloud)
EC_MATTE=cloud routes matting to the HeyGen CLI's background-removal (Bria) instead of the
local hyperframes remove-background (u2net). Written ahead of the API shipping.

- matte-cloud.cjs (new): available() pre-checks the heygen CLI, the background-removal command,
  and a HeyGen credential. toFramesFg() uploads the asset, creates + polls the job, downloads
  the foreground alpha webm, and bursts it to RGBA frames_fg (same contract as the local path).
  The credential probe + nudge mirror hyperframes-media/heygen-tts.mjs.
- matte.cjs: an opt-in branch before the local engine; on any failure (command absent, no key,
  or API error) it logs the reason + get-a-key nudge and falls back to local. Default unchanged.

The heygen background-removal command is codegen'd from experiment-framework PR #40076 (still
open), so available() is false today and EC_MATTE=cloud no-ops to local until it ships. Flag
names are anticipated; confirm with --request-schema when it lands.

Verified node --check, oxfmt, zero CJK, available() reports pending-command, default untouched.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-19 17:22:41 +08:00
..