Sync upstream - v26/v30 (2026-02-13)

[Sayan-]

Upstream Sync

Date: 2026-02-13

Summary

This PR merges the latest changes from the public kernel-images repository.

Upstream Changes Merged

• c8a53d5 feat: auto-toggle Chromium app mode for small viewports (feat: auto-toggle Chromium app mode for small viewports #153)

Files Changed

• images/chromium-headful/Dockerfile - Auto-merged
• images/chromium-headful/xorg.conf - New/updated
• server/.gitignore - New entry
• server/cmd/api/api/chromium.go - Auto-merged
• server/cmd/api/api/display.go - New file
• server/cmd/chromium-launcher/main.go - Auto-merged
• server/cmd/chromium-launcher/main_test.go - Updated
• server/go.mod - Auto-merged
• server/go.sum - Auto-merged
• server/lib/chromiumflags/chromiumflags.go - New file
• server/lib/chromiumflags/chromiumflags_test.go - New file

Merge Conflicts

No conflicts - merge was clean.

Image Versions

• chromium-headless: v26
• chromium-headful: v30

kernel-browser

Already up to date at v144.0.7559.96-r6.

[mesa-dot-dev]

Mesa Description

This PR overhauls the CI workflows for the Chromium images to improve reliability and add multi-platform support.

Key changes include:

• Multi-Architecture Builds: The chromium-headful-image and chromium-headless-image workflows now build and test for both amd64 and arm64 architectures using a matrix strategy.
• Improved CI Reliability: A new step has been added to the workflows to wait for all supervisor services within the container to be healthy before proceeding with tests, making the CI process more robust.
• Flexible Run Scripts: The run-docker.sh scripts for both images now support a DETACH environment variable, allowing containers to be run in the background, which is essential for the updated CI jobs.

---

Note

Refactors CI to build and run headful/headless Chromium images on amd64/arm64 with concurrency and service readiness checks, builds images inline in server tests, and adds DETACH support to run scripts.

• CI Workflows:
  • Chromium Images (.github/workflows/chromium-head{ful,less}-image.yaml):
    • Trigger on push/pull_request; add workflow concurrency.
    • Add matrix builds for amd64 and arm64 runners.
    • Build images via images/*/build-docker.sh, run containers, and wait for supervisor services (with SERVICE_EXCEPTIONS).
    • Set env vars (UKC_TOKEN, UKC_METRO, NAME, DETACH, etc.); enable WebRTC for headful.
    • Remove Docker Hub login and buildx push steps.
  • Server Tests (.github/workflows/server-test.yaml):
    • Add workflow concurrency and test timeout.
    • Inline-build headless/headful images before running make test.
    • Use explicit test image env vars (E2E_CHROMIUM_*_IMAGE).
• Scripts:
  • images/chromium-head{ful,less}/run-docker.sh: add DETACH-controlled run mode and minor run arg tweaks; keep cleanup and optional entrypoint handling.

^{Written by Cursor Bugbot for commit 5185d51. This will update automatically on new commits. Configure here.}

^{Description generated by Mesa. Update settings}

[mesa-dot-dev]

Performed full review of b51da91...da55596

Analysis

1. Container name hardcoding in trap cleanup creates brittle coupling rather than using the defined NAME environment variable, making future naming changes difficult.

2. Using docker run with --rm flag in detached mode auto-removes failed containers, making CI failure debugging nearly impossible since logs are lost.

3. Complex shell-based health checking logic (using awk, grep, sed, tr) is difficult to maintain and error-prone compared to more robust alternatives like a Python script or supervisorctl's XML-RPC API.

4. While container startup is tested, there's no functional testing to verify Chromium can actually launch and render pages, making this merely a smoke test.

5. The PR represents a significant architectural shift from build-and-push to build-and-test locally, but lacks documentation explaining this strategic change and its implications.

Tip

Help

Slash Commands:

• /review - Request a full code review
• /review latest - Review only changes since the last review
• /describe - Generate PR description. This will update the PR body or issue comment depending on your configuration
• /help - Get help with Mesa commands and configuration options

^{4 files reviewed | 0 comments | Edit Agent Settings • Read Docs}

[cursor]

Bug: Bug

Inconsistent container cleanup behavior: interactive mode (line 88) is missing the --rm flag while detached mode (line 86) has it. This causes containers to persist after exit when run interactively but be auto-removed when run detached. The chromium-headless script consistently uses --rm in both modes (lines 31 and 33), which is the correct pattern. This inconsistency will lead to container accumulation when running in interactive mode.