Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
fix(cli): a browser a sandbox refuses says to rerun the command with escalation (#5734)
Miguel Ángelfa9366915620
diff --git a/packages/cli/src/browser/launch.ts b/packages/cli/src/browser/launch.tsindex b31bb0b9dc..9318210313 100644--- a/packages/cli/src/browser/launch.ts+++ b/packages/cli/src/browser/launch.ts@@ -7,6 +7,7 @@ import {import { normalizeErrorMessage } from "../utils/errorMessage.js";import { requestCliExit } from "../utils/commandResult.js";import { processIsAlive } from "../utils/processTree.js";+import { sandboxDeniedRemediation } from "./sandboxDenied.js";export class BrowserCleanupError extends AggregateError {}@@ -94,6 +95,9 @@ export async function launchManagedBrowser(browsers.add(browser);child.once("exit", () => browsers.delete(browser));return browser;+ } catch (error) {+ const remediation = sandboxDeniedRemediation(normalizeErrorMessage(error));+ throw remediation ? new Error(remediation, { cause: error }) : error;} finally {pending.delete(launch);}diff --git a/packages/cli/src/browser/sandboxDenied.test.ts b/packages/cli/src/browser/sandboxDenied.test.tsnew file mode 100644index 0000000000..826bb58926--- /dev/null+++ b/packages/cli/src/browser/sandboxDenied.test.ts@@ -0,0 +1,30 @@+import type { LaunchOptions, PuppeteerNode } from "puppeteer-core";+import { describe, expect, it } from "vitest";+import { launchManagedBrowser } from "./launch.js";++const SEATBELT_LAUNCH_FAILURE = [+ "Failed to launch the browser process: Code: null",+ "",+ "stderr:",+ "[1016/170315.389548:FATAL:base/apple/mach_port_rendezvous_mac.cc:159] Check failed: kr == KERN_SUCCESS. bootstrap_check_in org.chromium.Chromium.MachPortRendezvousServer.26166: Permission denied (1100)",+].join("\n");++const failingPuppeteer = (message: string) =>+ ({ launch: async (_: LaunchOptions) => Promise.reject(new Error(message)) }) as PuppeteerNode;++describe("a browser launch a sandbox refuses", () => {+ it("tells the caller to rerun with escalation instead of showing Chrome's crash", async () => {+ await expect(+ launchManagedBrowser(failingPuppeteer(SEATBELT_LAUNCH_FAILURE), {}),+ ).rejects.toMatchObject({+ message:+ "The browser can't start inside this sandbox: macOS refused Chrome's mach service (bootstrap_check_in: Permission denied).\nRerun this command with escalation, outside the sandbox.",+ cause: { message: SEATBELT_LAUNCH_FAILURE },+ });+ });++ it("leaves any other launch failure as it was", async () => {+ const other = "Failed to launch the browser process: Code: 1";+ await expect(launchManagedBrowser(failingPuppeteer(other), {})).rejects.toThrow(other);+ });+});diff --git a/packages/cli/src/browser/sandboxDenied.ts b/packages/cli/src/browser/sandboxDenied.tsnew file mode 100644index 0000000000..577f147c66--- /dev/null+++ b/packages/cli/src/browser/sandboxDenied.ts@@ -0,0 +1,10 @@+const MACH_SERVICE_DENIED = /bootstrap_check_in\b[^\n]*Permission denied/;++/** A process sandbox (an agent's macOS seatbelt) refused Chrome its mach service, so no browser starts here. */+export function sandboxDeniedRemediation(errorMessage: string): string | undefined {+ if (!MACH_SERVICE_DENIED.test(errorMessage)) return undefined;+ return [+ "The browser can't start inside this sandbox: macOS refused Chrome's mach service (bootstrap_check_in: Permission denied).",+ "Rerun this command with escalation, outside the sandbox.",+ ].join("\n");+}diff --git a/packages/cli/src/commands/render.ts b/packages/cli/src/commands/render.tsindex c3dfd7178e..913109d64f 100644--- a/packages/cli/src/commands/render.ts+++ b/packages/cli/src/commands/render.ts@@ -118,6 +118,7 @@ import {import { chromeLaunchRemediation } from "../browser/linuxDeps.js";import { macosOldChromeCrashRemediation } from "../browser/macosOldChromeCrash.js";import { windowsChromeCrashRemediation } from "../browser/windowsCrash.js";+import { sandboxDeniedRemediation } from "../browser/sandboxDenied.js";import { killOrphanedProcessesForRender } from "../utils/orphanCleanup.js";import { createRenderCancellationScope } from "../utils/renderCancellation.js";import {@@ -1759,6 +1760,11 @@ function handleRenderError(// failure on Linux/WSL is an environment problem, not a composition bug.// Replace the generic "Try --docker" hint with the exact per-distro// remediation and a pointer at `doctor`.+ const sandboxRemediation = sandboxDeniedRemediation(message);+ if (sandboxRemediation) {+ errorBox("Render failed — Chrome could not launch", message, sandboxRemediation);+ failCommand();+ }const remediation = chromeLaunchRemediation(message);if (remediation) {errorBox("Render failed — Chrome could not launch", message, remediation);