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

Files

T

James RussoandMiao Yang 696cbdbbd0 chore(skills): package Codex plugin upload (#2668 )

* chore(skills): package Codex plugin upload

* chore(skills): harden Codex plugin content

* fix(skills): satisfy plugin quality gates

* fix(skills): address plugin packaging review

* fix(plugin): simplify asset validation

* fix(skills): correct embedded-captions catalog count to 35 after nightcity removal

The nightcity theme removal left SKILL.md claiming 36 identities in
four places, including the frontmatter description the router reads.
The catalog now has 35 entries (10 classic + 25 themed).

---------

Co-authored-by: Miao Yang <miao.yang@heygen.com>

2026-07-22 00:41:40 +08: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 remediation:
- Missing: install the HeyGen CLI, then run 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