Skip to content
113 changes: 98 additions & 15 deletions packages/agent-browser/build.ncl
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
let { standaloneTest, subsetOf, Attrs, BuildSpec, Local, OutputBin, OutputData, Source, Test, .. } = import "minimal.ncl" in
let { Attrs, BuildSpec, Local, OutputBin, OutputData, Source, Test, .. } = import "minimal.ncl" in
let base = import "../base/build.ncl" in
let toolchain = import "../toolchain/build.ncl" in
let make = import "../make/build.ncl" in
let pkgconf = import "../pkgconf/build.ncl" in
let rust = import "../rust/build.ncl" in
let node-lts = import "../node-lts/build.ncl" in
let pnpm = import "../pnpm/build.ncl" in
let ca-certificates = import "../ca-certificates/build.ncl" in

let bash = import "../bash/build.ncl" in
let glibc = import "../glibc/build.ncl" in
Expand Down Expand Up @@ -37,14 +38,14 @@ let glibc = import "../glibc/build.ncl" in
# upstream changes (the pkgmgr-rs#1028 trigger), if the smaller closure matters.
let chromium-bin = import "../chromium-bin/build.ncl" in

let version = "0.15.1" in
let version = "0.41.1" in
{
name = "agent-browser",
build_deps = [
{ file = "build.sh" } | Local,
{
url = "gs://minimal-staging-archives/vercel-labs/agent-browser/v%{version}.tar.gz",
sha256 = "c30724a5fba1beb217ca5ce5ce9eee43b596dc72efe9ac29adb9af717795b6c9",
sha256 = "b3d9d60b8a38f05e0f9b4d84d9e0b6995c21df2eb963eefb703008682a69f3bb",
extract = true,
strip_prefix = "agent-browser-%{version}",
} | Source,
Expand All @@ -56,23 +57,53 @@ let version = "0.15.1" in
node-lts,
pnpm,
],
# node-lts and pnpm build only the dashboard the binary embeds. The CLI is a
# native Rust binary: 0.20.0 removed the Node.js daemon (upstream #754), and
# the npm package's bin/agent-browser.js is just a launcher that picks the
# per-platform binary. So node is no longer a runtime dep and no
# node_modules ships.
runtime_deps = [
bash,
subsetOf node-lts ["node"],
bash, # the /usr/bin/agent-browser wrapper
glibc,
chromium-bin,
# The wrapper sets AGENT_BROWSER_USE_SYSTEM_CA=1: the CLI's own HTTPS
# (`read`, `doctor`, plugins…) reads /etc/ssl/certs instead of its
# compiled-in webpki-roots (pkgs AGENTS.md "Trust store").
ca-certificates,
],

cmd = "./build.sh",

outputs = {
# Wrapper: sets AGENT_BROWSER_EXECUTABLE_PATH / AGENT_BROWSER_USE_SYSTEM_CA
# defaults, then execs the binary below (see build.sh).
bin = { glob = "usr/bin/agent-browser" } | OutputBin,
# The binary (with the dashboard, axe-core and the CDP protocol compiled
# in) and the skills/ + skill-data/ trees it serves via `agent-browser
# skills` and the MCP `skills_*` tools. It finds them relative to its own
# canonical path, so they must stay beside bin/.
libexec = { glob = "usr/libexec/agent-browser/**", allow_executable = true } | OutputData,
licenses = { glob = "usr/share/licenses/agent-browser/**" } | OutputData,
},
attrs =
{
upstream_version = version,
license_spdx = "Apache-2.0",
# The binary compiles in more than agent-browser's own Apache-2.0 code
# (checked for 0.41.1; dual-licensed parts counted at MIT/Apache-2.0):
# MPL-2.0 axe-core 4.12.1 (cli/src/native/a11y/axe.min.js, include_str!),
# and the option-ext crate (via dirs)
# MIT, ISC axe-core's bundled third-party code (LICENSE-axe-core-THIRD-PARTY.txt);
# React DevTools installHook.js (cli/src/native/react)
# BSD-3-Clause Chrome DevTools Protocol JSON (cli/cdp-protocol, codegen in build.rs);
# subtle, exr, ravif crates
# OFL-1.1 Geist, which next/font self-hosts into the embedded dashboard
# dashboard JS next, react, radix-ui, ai, streamdown, d3, ... (MIT, ISC, Apache-2.0,
# BSD-3-Clause)
# Rust crates (cli/Cargo.lock) mostly MIT OR Apache-2.0, plus ISC (ring,
# rustls-webpki, untrusted), Unicode-3.0 (icu_*, zerovec, ...),
# BSD-2-Clause (rav1e), Zlib (zlib-rs, foldhash) and
# CDLA-Permissive-2.0 (webpki-roots' root list)
license_spdx = "Apache-2.0 AND MPL-2.0 AND MIT AND ISC AND BSD-2-Clause AND BSD-3-Clause AND Unicode-3.0 AND Zlib AND CDLA-Permissive-2.0 AND OFL-1.1",
source_provenance = {
category = 'GithubRepo,
owner = "vercel-labs",
Expand All @@ -82,30 +113,82 @@ let version = "0.15.1" in
} | Attrs,

tests = {
smoketest = standaloneTest "/bin/agent-browser --version",
version_check =
{
class = 'Standalone,
test_deps = [base],
cmds = [
["/bin/bash", "-c", "/bin/agent-browser --version | grep -qx 'agent-browser %{version}'"],
],
} | Test,
# The skills lookup is relative to the binary's canonical path
# (skills.rs find_package_root): a layout change breaks it silently, so
# list them and require the bundled `core` skill.
skills =
{
class = 'Standalone,
test_deps = [base],
cmds = [
["/bin/bash", "-c", "/bin/agent-browser skills list | grep -qw core"],
["/bin/bash", "-c", "/bin/agent-browser skills get core | grep -q agent-browser"],
],
} | Test,
# No Node runtime or node_modules ships any more; the embedded code's
# licence texts do.
layout =
{
class = 'Standalone,
test_deps = [base],
cmds = [
["/bin/bash", "-c", "test ! -e /usr/libexec/agent-browser/node_modules && test ! -e /usr/bin/node"],
["/bin/bash", "-c", "grep -q 'Mozilla Public License' /usr/share/licenses/agent-browser/LICENSE-axe-core.txt"],
["/bin/bash", "-c", "test -s /usr/share/licenses/agent-browser/LICENSE-axe-core-THIRD-PARTY.txt"],
],
} | Test,
# The real dashboard export is embedded, not cli/build.rs's placeholder.
dashboard_embedded =
{
class = 'Standalone,
test_deps = [base],
cmds = [
["/bin/bash", "-c", "grep -qa 'Observability dashboard for agent-browser' /usr/libexec/agent-browser/bin/agent-browser"],
["/bin/bash", "-c", "! grep -qa 'Dashboard not built' /usr/libexec/agent-browser/bin/agent-browser"],
],
} | Test,
open_check =
{
class = 'Standalone,
test_deps = [base],
cmds = [
# End-to-end: drive `agent-browser open` against a data: URL
# and assert the page title appears in stdout. This exercises
# the full path — Rust CLI launches the TS daemon, daemon
# spawns chromium via /bin/chromium, navigates, returns
# title.
["/bin/bash", "-c", "/bin/agent-browser open 'data:text/html,<title>agent-browser-open-ok</title>' | grep -q agent-browser-open-ok"],
# End-to-end: the CLI starts its native daemon, which launches
# chromium-bin's /usr/bin/chromium headless (the wrapper's
# AGENT_BROWSER_EXECUTABLE_PATH), navigates to a data: URL, and
# prints the page title.
# TEST-ONLY --no-sandbox: the build-bot's test sandbox has no
# unprivileged user namespaces, so Chromium aborts with "No usable
# sandbox!" (pkgs#1269 build-bot run, both arches). chromium-bin's own
# launch test does the same. The shipped wrapper keeps Chromium's
# sandbox; AGENT_BROWSER_ARGS (comma-separated launch args, cli
# flags.rs) is set only inside these test shells.
["/bin/bash", "-c", "export AGENT_BROWSER_ARGS=--no-sandbox,--disable-dev-shm-usage; /bin/agent-browser open 'data:text/html,<title>agent-browser-open-ok</title>' | grep -q agent-browser-open-ok"],
# A follow-up command reaches the same daemon and page. One shell:
# the daemon does not outlive a test command.
["/bin/bash", "-c", "set -o pipefail; export AGENT_BROWSER_ARGS=--no-sandbox,--disable-dev-shm-usage; /bin/agent-browser open 'data:text/html,<title>agent-browser-reuse-ok</title>' >/dev/null && /bin/agent-browser get title | grep -q agent-browser-reuse-ok; rc=$?; /bin/agent-browser close >/dev/null; exit $rc"],
],
} | Test,
# CVE-2026-111943: the daemon must launch chromium-bin's full browser,
# which reads the CADistrustedCertificates policy. headless-shell cannot
# (see the comment at the chromium-bin import).
# (see the comment at the chromium-bin import). And the CLI's own HTTPS
# must use the system store, not its compiled-in webpki-roots.
distrust_policy_wired =
{
class = 'Standalone,
test_deps = [base],
cmds = [
["/bin/bash", "-c", "grep -qF -- '--executable-path /usr/bin/chromium \"' /usr/bin/agent-browser"],
["/bin/bash", "-c", "grep -qF 'AGENT_BROWSER_EXECUTABLE_PATH:-/usr/bin/chromium}' /usr/bin/agent-browser"],
["/bin/bash", "-c", "grep -qF 'AGENT_BROWSER_USE_SYSTEM_CA:-1}' /usr/bin/agent-browser"],
["/bin/bash", "-c", "grep -q CADistrustedCertificates /etc/chromium/policies/managed/ca-distrusted-certificates.json"],
["/bin/bash", "-c", "test -s /etc/ssl/certs/ca-certificates.crt"],
],
} | Test,
},
Expand Down
147 changes: 90 additions & 57 deletions packages/agent-browser/build.sh
Original file line number Diff line number Diff line change
@@ -1,74 +1,107 @@
#!/bin/sh
set -e
set -eu

# pnpm 11 migration: strictDepBuilds now defaults to true, so unreviewed
# dependency build scripts (esbuild/geckodriver/…) are a hard error
# (ERR_PNPM_IGNORED_BUILDS) rather than a warning — but this build deliberately
# skips them (`--ignore-scripts`; the daemon ships a prebuilt binary), so demote
# it back to a warning. Also disable the pre-script deps check, which otherwise
# reinstalls before `pnpm build` and re-runs the husky postinstall (which needs
# a `.git` the source tarball doesn't have).
# agent-browser >= 0.20 is a native Rust CLI (upstream #754). The npm package's
# bin/agent-browser.js is only a launcher that picks the per-platform binary
# (and scripts/postinstall.js downloads one), so we build the binary from
# source and ship it on its own: no node, no node_modules at runtime.
#
# Build order mirrors upstream's `pnpm run build:source`:
# 1. the dashboard (Next.js static export, packages/dashboard/out), which
# cli/src/native/stream/http.rs embeds with rust-embed at compile time;
# without it cli/build.rs embeds a "Dashboard not built" placeholder;
# 2. the Rust CLI.

# pnpm 11+: strictDepBuilds defaults to true. We install with --ignore-scripts
# (no dependency build script is needed for a static export), so keep the
# skipped builds a warning. Also skip the pre-script deps check, which would
# reinstall and re-run lifecycle scripts before `pnpm build`.
export PNPM_CONFIG_STRICT_DEP_BUILDS=false
export PNPM_CONFIG_VERIFY_DEPS_BEFORE_RUN=false

# pnpm 12 places its default store on the project's own volume when it cannot
# hardlink into its home store, and in the sandbox /build is a separate mount,
# so the store lands in node_modules/.pnpm-store — which the `cp -R node_modules`
# below would ship. Pin it outside the build tree, where pnpm 11 put it.
# Keep pnpm's store out of the source tree (pnpm 12 otherwise puts it in
# node_modules/.pnpm-store when /build is a separate mount).
export PNPM_CONFIG_STORE_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/pnpm/store"
# package.json pins "packageManager": "pnpm@11.1.3". Build with our pnpm
# (engines: pnpm >= 11) instead of letting it download that one at build time
# (pmOnFail is pnpm 11+'s setting; manage-package-manager-versions pnpm 10's).
export PNPM_CONFIG_PM_ON_FAIL=ignore
export PNPM_CONFIG_MANAGE_PACKAGE_MANAGER_VERSIONS=false
# No Next.js telemetry from the build.
export NEXT_TELEMETRY_DISABLED=1

# --- 1. dashboard -----------------------------------------------------------
# Only the dashboard's dependencies (the workspace also holds docs and the
# @agent-browser/{eve,sandbox} packages, none of which ship). Lockfile-pinned.
pnpm install --frozen-lockfile --ignore-scripts --filter dashboard

# Next.js bakes a random (nanoid) buildId into out/_next/static/<buildId>/ and
# every page's RSC payload; pin it so the embedded dashboard, and with it the
# binary, is reproducible (same fix as packages/next's bundle-analyzer).
sed -i 's/output: "export",/output: "export", generateBuildId: async () => "agent-browser-reproducible",/' \
packages/dashboard/next.config.ts
grep -q 'agent-browser-reproducible' packages/dashboard/next.config.ts \
|| { echo "ERROR: dashboard generateBuildId repro patch did not apply (next.config.ts changed upstream)" >&2; exit 1; }

# next/font/google (layout.tsx's Geist) downloads the font at build time and
# self-hosts it in out/_next/static/media; the build has network via rust's
# `needs`.
(cd packages/dashboard && pnpm build)
test -f packages/dashboard/out/index.html
if grep -q 'Dashboard not built' packages/dashboard/out/index.html; then
echo "ERROR: dashboard export is the placeholder" >&2
exit 1
fi

# --- 2. Rust CLI ------------------------------------------------------------
export CC=gcc
export LD=gcc
export RUSTFLAGS="-C linker=gcc --remap-path-prefix=$(pwd)=/builddir --remap-path-prefix=$HOME/.cargo=/cargo -C codegen-units=1"
export CONST_RANDOM_SEED=0 # pin ahash/const-random compile-time seed

# Install JS deps (skip postinstall which downloads pre-built binary).
# Use the hoisted node-linker so node_modules is a flat, self-contained
# tree — pnpm's default symlinked layout into .pnpm/ doesn't survive
# being copied into $OUTPUT_DIR and causes runtime ERR_MODULE_NOT_FOUND
# on transitive deps (e.g. jszip).
pnpm install --ignore-scripts --config.node-linker=hoisted
cargo build --release --locked --manifest-path cli/Cargo.toml

# Build TypeScript daemon
pnpm build
# --- install ----------------------------------------------------------------
# Layout matches the npm package, which the binary's lookups assume:
# skills.rs find_package_root(): <exe dir>/../skill-data/core/SKILL.md
# stream/chat.rs find_skills_dir(): walks up from the exe to skills/agent-browser/SKILL.md
# Both canonicalize current_exe(), so the real binary must live inside the tree.
LIBEXEC=$OUTPUT_DIR/usr/libexec/agent-browser
install -d "$LIBEXEC/bin" "$OUTPUT_DIR/usr/bin" "$OUTPUT_DIR/usr/share/licenses/agent-browser"
install -m 0755 cli/target/release/agent-browser "$LIBEXEC/bin/agent-browser"
cp -R skills skill-data "$LIBEXEC/"
test -f "$LIBEXEC/skill-data/core/SKILL.md"
test -f "$LIBEXEC/skills/agent-browser/SKILL.md"

# Build Rust CLI
cargo build --release --manifest-path cli/Cargo.toml
# Licences of what the binary embeds: axe-core (MPL-2.0, include_str! of
# axe.min.js) with its third-party notices, as upstream's package.json ships
# them; React DevTools' installHook.js (MIT, its notice is in the file).
install -m 0644 LICENSE "$OUTPUT_DIR/usr/share/licenses/agent-browser/LICENSE"
install -m 0644 cli/src/native/a11y/LICENSE-axe-core.txt \
cli/src/native/a11y/LICENSE-axe-core-THIRD-PARTY.txt \
"$OUTPUT_DIR/usr/share/licenses/agent-browser/"

# Determine platform
case $(uname -m) in
x86_64) PLATFORM="linux-x64" ;;
aarch64) PLATFORM="linux-arm64" ;;
esac

mkdir -p bin
cp cli/target/release/agent-browser bin/agent-browser-${PLATFORM}

# Chromium is provided by the chromium-bin pkg as a runtime dep. We pass its
# binary to the daemon via --executable-path; no need to ship our own copy or
# run `npx playwright install`. It must be chromium-bin's `chromium`, not
# chromium-headless-shell: only the full browser reads the
# CADistrustedCertificates policy (CVE-2026-111943; see build.ncl).
# The wrapper sets two defaults; a caller's own env var wins, and so does a
# command-line flag.
#
# Upstream's own default is to fetch Chrome for Testing's `chrome` bundle,
# which we may not redistribute (inbox#284). Passing an explicit
# --executable-path is what stops `agent-browser install` ever reaching for
# it, so this flag is load-bearing for licensing, not just convenience.

install -d $OUTPUT_DIR/usr/bin
install -d $OUTPUT_DIR/usr/libexec/agent-browser

# pnpm bakes wall-clock timestamps into its node_modules state files
# (.modules.yaml `prunedAt`, .pnpm-workspace-state-v1.json `lastValidatedTimestamp`)
# — non-deterministic and not needed at runtime. Drop them before packaging.
rm -f node_modules/.modules.yaml node_modules/.pnpm-workspace-state-v1.json
test ! -e node_modules/.pnpm-store \
|| { echo "agent-browser: the pnpm store is inside node_modules and would ship" >&2; exit 1; }
cp -R dist bin node_modules package.json $OUTPUT_DIR/usr/libexec/agent-browser/

cat > $OUTPUT_DIR/usr/bin/agent-browser << EOF
# AGENT_BROWSER_EXECUTABLE_PATH -> chromium-bin's full browser, NOT
# chromium-headless-shell: only the full browser reads the
# CADistrustedCertificates policy (CVE-2026-111943; see build.ncl). The env
# var (rather than the old prepended --executable-path) also reaches the
# paths that never parse the flag: the daemon's own auto-launch
# (native/actions.rs), `mcp` mode, and `doctor`. Upstream's fallback is to
# look for google-chrome/chromium on PATH or a Chrome for Testing download
# from `agent-browser install`, which we may not redistribute (inbox#284).
#
# AGENT_BROWSER_USE_SYSTEM_CA=1 -> the CLI's own HTTPS (`read`, which fetches
# arbitrary URLs without a browser, plus `doctor`, `install`, `upgrade`,
# `chat`, plugins) verifies against /etc/ssl/certs (ca-certificates) instead
# of the webpki-roots bundle compiled into the binary (pkgs AGENTS.md "Do not
# embed a trust store"; the locked webpki-roots 1.0.5 predates the
# CVE-2026-111943 emSign distrust, RUSTSEC-2026-0381).
cat > "$OUTPUT_DIR/usr/bin/agent-browser" << 'EOF'
#!/bin/bash
exec /usr/libexec/agent-browser/bin/agent-browser-${PLATFORM} \\
--executable-path /usr/bin/chromium "\$@"
export AGENT_BROWSER_EXECUTABLE_PATH="${AGENT_BROWSER_EXECUTABLE_PATH:-/usr/bin/chromium}"
export AGENT_BROWSER_USE_SYSTEM_CA="${AGENT_BROWSER_USE_SYSTEM_CA:-1}"
exec /usr/libexec/agent-browser/bin/agent-browser "$@"
EOF
chmod +x $OUTPUT_DIR/usr/bin/agent-browser
chmod 0755 "$OUTPUT_DIR/usr/bin/agent-browser"
Loading