feat(media-use): fast heygen CLI onboarding — actionable diagnostics, --doctor, free-usage framing#2065
Open
miguel-heygen wants to merge 1 commit into
Open
Conversation
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
5fa2c12 to
928539e
Compare
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Collaborator
Author
|
Warning This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
This stack of pull requests is managed by Graphite. Learn more about stacking. |
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
928539e to
8465bb5
Compare
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
8465bb5 to
45ee90e
Compare
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
45ee90e to
105bc16
Compare
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
105bc16 to
bc5086e
Compare
… --doctor, free-usage framing media-use resolves bgm/sfx/image/icon (catalog), voice (TTS), and avatar video through the heygen CLI — the free-usage path. Agents hit a dead end when it's missing/unauthed. This guides them to install it fast, at the point of need. - Centralized actionable diagnostics (lib/heygen-cli.mjs): every heygen-backed resolve, on failure, prints the exact fix on stderr — not-installed (curl install one-liner), not-authenticated (heygen auth login), outdated (heygen update). Routed through heygen-search + voice-provider. stdout stays clean JSON. - resolve --doctor preflight (human + --json): checks heygen present/version/ auth, ffmpeg, ffprobe, node, a fix per gap. Exit 0 unless ffmpeg missing. - SKILL reframe: install-first callout; heygen as the free-usage gateway for bgm/image/voice/avatar-video; removed the false "degrades gracefully" claim. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01H5k87mPZ4d6yiFwcWSb8Vv
miguel-heygen
force-pushed
the
feat/media-use-heygen-onboarding
branch
from
bc5086e to
2c9425c
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
media-use resolves bgm / sfx / image / icon / logo (catalog), voice (TTS), and avatar video through the
heygenCLI — the free-usage path. CLI-feedback shows agents repeatedly hit a dead end whenheygenis missing/unauthed: they get a vague error, install it by trial, and there's no preflight. This makes the dependency self-service — it guides agents to install it fast, at the moment of need.Changes
lib/heygen-cli.mjs) — every heygen-backed resolve, on failure, prints the exact fix on stderr (stdout stays clean JSON):curl -fsSL https://static.heygen.ai/cli/install.sh | bashthenheygen auth loginheygen auth login --key <key>heygen update(need ≥ v0.1.6)Routed through
heygen-search(catalog) andvoice-provider(TTS) so all heygen-backed types are consistent.resolve --doctorpreflight (human +--json) — checks heygen present / version / auth, ffmpeg, ffprobe, node, with a fix command per gap. Exit 0 unless ffmpeg (the only strictly-required dep) is missing; a missing/unauthed heygen is reported, not fatal. The SKILL tells agents to run it first.Verification
logo);oxlint+oxfmt --checkclean.resolve --doctor(human + json) → all six checks green on a provisioned machine.bgmresolve → stdout valid JSON (ok:false), stderr carries the exact actionable install line.--doctorwith heygen hidden → reports it ✗ with the install fix, exits 0 (ffmpeg present).Notes
🤖 Generated with Claude Code