Merge pull request #2569 from heygen-com/via/macos12-dyld-crash-hint

fix(cli): surface HYPERFRAMES_BROWSER_PATH hint on macOS <13 chrome-headless-shell dyld crash
This commit is contained in:
Vance Ingalls
2026-07-17 00:40:14 -07:00
committed by GitHub
3 changed files with 182 additions and 0 deletions
+9
View File
@@ -80,6 +80,7 @@ import { formatRenderOutputTimestamp } from "@hyperframes/core";
import { runEnvironmentChecks } from "../browser/preflight.js";
import { detectH264EncoderMode } from "../browser/ffmpeg.js";
import { chromeLaunchRemediation } from "../browser/linuxDeps.js";
import { macosOldChromeCrashRemediation } from "../browser/macosOldChromeCrash.js";
import { killOrphanedProcesses } from "../utils/orphanCleanup.js";
import {
markRenderSucceeded,
@@ -2106,6 +2107,14 @@ function handleRenderError(
errorBox("Render failed — Chrome could not launch", message, remediation);
process.exit(1);
}
// macOS <13 dyld Symbol-not-found on the pinned chrome-headless-shell
// build. Different remediation shape (older shell + env-var override)
// than the Linux shared-lib install, so it lives in its own detector.
const macosRemediation = macosOldChromeCrashRemediation(message);
if (macosRemediation) {
errorBox("Render failed — Chrome could not launch", message, macosRemediation);
process.exit(1);
}
errorBox("Render failed", message, hint);
process.exit(1);
}