mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-06 17:46:03 +00:00

Files

T

Miguel Ángel 2e34a2d5a0 fix(media-use): fall back to bundled SFX (#2257 )

* fix(media-use): fall back to bundled SFX

* chore(skills): refresh media-use manifest

* docs(media-use): design CLI fallback advisory

* docs(media-use): plan CLI fallback advisory

* fix(media-use): surface HeyGen CLI fallback guidance

* fix(media-use): derive bundled SFX extension

2026-07-12 22:17:52 -04:00

1.9 KiB

Raw Blame History

Media-use SFX CLI advisory design

Goal

When SFX resolution succeeds through the bundled fallback because the HeyGen CLI is missing or outdated, tell the agent how to restore the broader HeyGen catalog path. Keep bundled fallback successful and never install software automatically.

Behavior

Reuse the existing HeyGen CLI error classification produced by the failed catalog provider call.
Retain only the latest actionable not_found or outdated remediation for the current resolver process.
When bundled.sfx wins after that failure, include a structured advisory in JSON output and print the same concise hint in human output.
Use the existing canonical commands:
- Missing: curl -fsSL https://static.heygen.ai/cli/install.sh | bash && heygen auth login --oauth
- Outdated: heygen update
Do not emit this advisory for authentication, quota, network, or legitimate empty-catalog results; --local-only; or an explicitly forced bundled provider.
Do not execute the install or update command.

Components

heygen-cli.mjs records and exposes one process-local actionable remediation alongside the existing logging and telemetry behavior.
resolve.mjs consumes that remediation only when the winning provider is bundled.sfx, then attaches it to the result.
The result formatter exposes the advisory consistently to JSON and human consumers.

Tests

Missing CLI followed by bundled fallback returns the install advisory.
Outdated CLI followed by bundled fallback returns the update advisory.
A healthy CLI with a legitimate catalog miss returns bundled SFX without an install/update advisory.
--local-only and explicit bundled-provider resolution do not suggest installation.
Existing fallback, registry, skill, format, and manifest checks remain green.

Safety

This is recommendation-only. It does not cross the software-install consent boundary, run a shell, or turn a successful local fallback into an error.

1.9 KiB Raw Blame History