Skip to content

agent-browser: run against chromium-headless-shell-bin, not chromium-bin - #735

Merged
bryan-minimal merged 1 commit into
mainfrom
agent-browser-headless
Sep 22, 2026
Merged

bryan-minimal merged 1 commit into
mainfrom
agent-browser-headless

Conversation

@bryan-minimal

Copy link
Copy Markdown
Member

chromium-bin has no future on arm64, and it's a sourcing dead end rather than a stale pin:

  • its arm64 leg came from Playwright's CDN, and Playwright stopped building linux-arm64. r1243 was the last one ever (re-verified following redirects: r1243 → 200, r1245/1250/1260/1270 → 400)
  • Google publishes no open-source Chromium binary for linux-arm64 at all — the chromium-browser-snapshots bucket that chromium-bin's amd64 leg uses is x64 only (Linux_ARM64 → 404), which is why arm64 needed a third-party build in the first place
  • Chrome for Testing does build arm64, but the chrome bundle is branded Google Chrome and ships libwidevinecdm.so — inbox#284 ruled that non-redistributable, and our cache redistributes

chrome-headless-shell is the one artifact clearing all three: CfT builds it for arm64, and pkgs#718 proved it redistributable — zero WidevineCdm entries on either arch, plus a LICENSE.headless_shell carrying the Chromium BSD-3-Clause grant.

What this gives up — stated plainly

chrome-headless-shell is the separate, reduced headless binary, not the full browser running headless. These agent-browser features stop working:

feature why
--extensions no extension support in headless-shell
--headed this binary has no headed mode
WebGPU screenshots upstream documents these as requiring headed

agent-browser already defaults to headless (--headed is opt-in), and it's driven by agents rather than humans — nothing runs it expecting a visible UI, and no consumer uses extensions. That's the call being made here, not an assumption that the two binaries are equivalent.

A licensing detail worth knowing

Upstream's own default is to fetch CfT's chrome bundle via agent-browser install — precisely the artifact we may not redistribute. The explicit --executable-path is what stops it ever reaching for that, so that flag is load-bearing for licensing, not just convenience.

The way back

If extensions or WebGPU are ever needed: Debian ships chromium for both arches at 153.0.8010.52-1, Widevine-free and DFSG-free — verified 0 WidevineCdm entries, Files-Excluded: *.dll *.exe *.apk *.class, and licences all BSD/Apache/MIT/MPL/LGPL with zero non-free entries. The cost is its 47-library runtime closure (libpulse, libopenh264, libdav1d, libFLAC, libopus, libminizip, libXNVCtrl…), which Debian links dynamically where Google's build bundles them.

Verification

Built and checked in the Linux sandbox: build finished, all 15 checkers pass including missing runtime_deps — which matters here, because swapping the browser replaces the entire transitive system-lib closure.

chromium-bin now has no consumers in the tree. Left in place deliberately — retiring it is a separate decision, and its amd64 leg is still a healthy open-source source.

🤖 Generated with Claude Code

chromium-bin has no future on arm64, and that is a sourcing dead end rather
than a stale pin:

  * its arm64 leg came from Playwright's CDN, and Playwright STOPPED building
    linux-arm64. r1243 was the last one ever (re-verified 2026-09-18 following
    redirects: r1243 -> 200, r1245/1250/1260/1270 -> 400).
  * Google publishes NO open-source Chromium binary for linux-arm64 at all.
    The chromium-browser-snapshots bucket that chromium-bin's amd64 leg uses
    is x64 ONLY (Linux_ARM64 -> 404), which is why an arm64 build had to come
    from a third party in the first place.
  * Chrome for Testing does build arm64, but the `chrome` bundle is branded
    Google Chrome and ships libwidevinecdm.so. inbox#284 ruled that
    non-redistributable and our cache redistributes.

chrome-headless-shell is the one artifact that clears all three: CfT builds
it for arm64, and pkgs#718 PROVED it redistributable — zero WidevineCdm
entries on either arch, and a LICENSE.headless_shell carrying the Chromium
BSD-3-Clause grant with none of the proprietary language.

WHAT THIS GIVES UP, stated plainly because it is a real reduction.
chrome-headless-shell is the separate, reduced headless binary — NOT the full
browser running headless — so these agent-browser features stop working:

    --extensions        no extension support in headless-shell
    --headed            this binary has no headed mode
    WebGPU screenshots  upstream documents these as requiring headed

agent-browser already defaults to headless (`--headed` is opt-in), and it is
driven by agents rather than humans: nothing runs it expecting a visible UI,
and no consumer uses extensions. That is the call being made here, not an
assumption that the binaries are equivalent.

Also worth recording: upstream's own default is to fetch CfT's `chrome`
bundle via `agent-browser install` — precisely the artifact we may not
redistribute. The explicit --executable-path is what keeps it from ever
reaching for that, so the flag is load-bearing for licensing, not just
convenience.

The way back, if extensions or WebGPU are ever needed: Debian ships chromium
for BOTH arches at 153.0.8010.52-1, Widevine-free and DFSG-free (verified:
0 WidevineCdm entries, `Files-Excluded: *.dll *.exe *.apk *.class`, licences
all BSD/Apache/MIT/MPL/LGPL with zero non-free entries). The cost is its
47-library runtime closure — libpulse, libopenh264, libdav1d, libFLAC,
libopus, libminizip, libXNVCtrl and friends, which Debian links dynamically
where Google's build bundles them.

Built and checked in the Linux sandbox: build finished, all 15 checkers pass
including missing-runtime_deps — which matters here, because swapping the
browser replaces the entire transitive system-lib closure.

chromium-bin now has no consumers in the tree. Left in place deliberately:
retiring it is a separate decision, and its amd64 leg is still a healthy
open-source source.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@bryan-minimal
bryan-minimal requested a review from a team as a code owner September 21, 2026 18:09
@coderabbitai

coderabbitai Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

  • Run on-demand review

This review includes 2 billable files and costs up to $0.50.

  • Ask an admin to make reviews automatic

Open in CodeRabbit

Reviews can continue after your included limit without a manual trigger. An admin must approve usage-based billing.

Or wait 23 minutes for your next included review.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available. Your 65 included PR review attempts over the past 7 days set your current allowance at 1 review per hour.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Repository: gominimal/pkgs/.coderabbit.yaml

Review profile: CHILL

Plan: Essentials

Run ID: 97f227b8-7232-4741-badf-ea9df92a33b4

📥 Commits

Reviewing files that changed from the base of the PR and between 2794816 and 8debdf6.

📒 Files selected for processing (2)
  • packages/agent-browser/build.ncl
  • packages/agent-browser/build.sh

Comment @coderabbitai help to get the list of available commands.

@bryan-minimal
bryan-minimal added this pull request to the merge queue Sep 22, 2026
Merged via the queue into main with commit d7d925b Sep 22, 2026
11 checks passed
@bryan-minimal
bryan-minimal deleted the agent-browser-headless branch September 22, 2026 20:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants