Quickly sandbox your AI agent.
Python
chore(release): prepare security patches on hosted x64 runners
Tyler Payne400a5c170d2e
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.mdindex a9d47b2..63368a4 100644--- a/.claude/skills/release/SKILL.md+++ b/.claude/skills/release/SKILL.md@@ -12,20 +12,28 @@ For first-time setup, scaffold the workflow with `uvr workflow init` (see `referIf the project has existing CI checks (tests, linting, etc.) that aren't yet wired into the release workflow, see `references/custom-jobs.md` before your first release.-## 0. Self-hosted runners+## 0. Runners-Before dispatching, ensure all runners are up:+Checks and x64 builds use GitHub-hosted `ubuntu-24.04`. ARM64 image builds use+the local macOS runner with labels `self-hosted, macos, arm64`; GitHub-hosted+ARM64 Macs do not support the nested virtualization these builds require.+The release workflow verifies Docker and KVM access on hosted Ubuntu and reports+available disk space before building.-```bash-uv run quicksand-runners start-```--This starts the local macOS runner and the cloud runners (x64, arm64, win). The command is idempotent β safe to run if runners are already up.+Before dispatching, confirm the local runner is online and has sufficient free+disk space. `quicksand-runners start` manages Azure VMs only; it does not start+the local runner. Do not restore retired Azure VMs for an image-only release.+QEMU releases still have separate Windows x64 and Linux ARM64 runner mappings+that must be checked before dispatching.**Troubleshooting:**-- **"A session for this runner already exists"**: Another runner process is already running. Kill it first: `pkill -f Runner.Listener` then retry.-- **"file already exists" error in Set up job**: Stale `_diag/` files from a previous run. Clean with `rm -rf gha-runners/local/_diag`.-- **NEVER start multiple runner processes.** Each `run.sh` invocation creates a persistent process. Check with `ps aux | grep Runner.Listener` before starting a new one.+- **Deleted registration**: Re-register the local runner using an account with+ repository runner-management permission. GitHub's `workflow` OAuth scope+ alone does not grant that permission.+- **"A session for this runner already exists"**: Inspect the existing process+ and reuse it, or stop its specific PID before starting another listener.+- **NEVER start multiple runner processes.** Check `pgrep -x Runner.Listener`+ before starting the runner from `gha-runners/local`.## 1. Branchdiff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 7443e4c..b7dfb9c 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -22,7 +22,7 @@ jobs:# Validate# --------------------------------------------------------------------------validate:- runs-on: [self-hosted, linux, x64]+ runs-on: ubuntu-24.04steps:- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1- id: setup-uv@@ -51,7 +51,7 @@ jobs:# --------------------------------------------------------------------------check:needs: [validate]- runs-on: [self-hosted, linux, x64]+ runs-on: ubuntu-24.04strategy:fail-fast: truematrix:@@ -87,6 +87,14 @@ jobs:uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1with:fetch-depth: 0+ - name: Check hosted image build prerequisites+ if: contains(matrix.runner, 'ubuntu-24.04')+ run: |+ docker info > /dev/null+ test -c /dev/kvm+ sudo setfacl -m "u:$(id -u):rw" /dev/kvm+ test -r /dev/kvm && test -w /dev/kvm+ df -h "$GITHUB_WORKSPACE"- id: setup-uvuses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0with:@@ -121,7 +129,7 @@ jobs:verify-licenses:needs: [validate, build]if: always() && !failure() && !cancelled() && !contains(fromJSON(inputs.plan).skip, 'verify-licenses')- runs-on: [self-hosted, linux, x64]+ runs-on: ubuntu-24.04steps:- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1- uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0diff --git a/CHANGELOG.md b/CHANGELOG.mdindex af95156..c9e7ac8 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,6 +4,31 @@ All notable changes to the quicksand project will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/).+## [quicksand-core v0.14.1, quick-sandbox v0.13.1, quicksand-image-tools v0.6.2] - 2026-11-02++Security hardening for the eMudhra/emSign intermediate-CA incident.++### Security+- **quicksand-core / quick-sandbox:** Require patched certificate stores and raise dependency minimums so new installations select the hardened image and tooling packages.+- **quicksand-ubuntu v0.10.2 / quicksand-alpine v0.10.2:** Refresh OS CA stores before network bootstrapping and require incident-patched CA packages.+- **quicksand-agent v0.4.12:** Bootstrap patched uv, pip, and certifi with failure-propagating download and installation steps.+- **quicksand-cua v0.3.14:** Replace Playwright's older bundled Node with checksum-verified Node 24.22.1, persist its selection across reboots, reject stale parent tooling, and install managed Chromium certificate distrust.+- **quicksand-ubuntu-desktop v0.9.12 / quicksand-alpine-desktop v0.9.12:** Explicitly distrust the known compromised intermediates in Firefox ESR and Chromium, including Firefox's first launch before online revocation updates arrive. Shared certificate data covers all 16 known original and cross-signed variants of the eight compromised keys.+- **Documentation:** Update vulnerable dependencies and use a patched Node runtime for builds.++### Fixed+- **quicksand-ubuntu-desktop:** Install Firefox ESR from Mozilla's signed APT repository with a pinned signing-key fingerprint. Repository updates now fail on download errors rather than continuing with stale package metadata.+- **quicksand-image-tools / image packages / scaffolds:** Honor forced security rebuilds instead of reusing cached images; forced Docker builds also refresh parent images and bypass cached layers.++### Changed+- **Release pipeline:** Build x64 images and run checks on GitHub-hosted Ubuntu. ARM64 images continue to use the local macOS runner. Release builds use patched tooling and always request fresh images.+- **quicksand-base-scaffold v0.3.13 / quicksand-overlay-scaffold v0.3.13:** Raise build and runtime dependency minimums to the hardened packages.++Existing guests and saved overlays are not patched by upgrading host packages.+Recreate them from the new images; do not rebase old overlays onto changed base+images. Custom workloads that install PHP still need their own vendor-fixed PHP+packages.+## [quicksand-core v0.14.0, quick-sandbox v0.13.0] - 2026-10-14Bidirectional port forwarding. Guests can now reach services on the host, and the forwarding API describes both directions with one type.diff --git a/packages/contrib/quicksand-agent/pyproject.toml b/packages/contrib/quicksand-agent/pyproject.tomlindex ce5704f..b6ee362 100644--- a/packages/contrib/quicksand-agent/pyproject.toml+++ b/packages/contrib/quicksand-agent/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-agent"-version = "0.4.12.dev0"+version = "0.4.12"description = "Overlay image package for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/contrib/quicksand-alpine-desktop/pyproject.toml b/packages/contrib/quicksand-alpine-desktop/pyproject.tomlindex 1dacef0..013bb59 100644--- a/packages/contrib/quicksand-alpine-desktop/pyproject.toml+++ b/packages/contrib/quicksand-alpine-desktop/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-alpine-desktop"-version = "0.9.12.dev0"+version = "0.9.12"description = "Minimal Alpine Linux desktop VM (Xfce4) for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/contrib/quicksand-alpine/pyproject.toml b/packages/contrib/quicksand-alpine/pyproject.tomlindex c71b4f3..7c76913 100644--- a/packages/contrib/quicksand-alpine/pyproject.toml+++ b/packages/contrib/quicksand-alpine/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-alpine"-version = "0.10.2.dev0"+version = "0.10.2"description = "Pre-built Alpine Linux VM image for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/contrib/quicksand-cua/pyproject.toml b/packages/contrib/quicksand-cua/pyproject.tomlindex 2459392..f0c33e8 100644--- a/packages/contrib/quicksand-cua/pyproject.toml+++ b/packages/contrib/quicksand-cua/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-cua"-version = "0.3.14.dev0"+version = "0.3.14"description = "Overlay image package for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/contrib/quicksand-ubuntu-desktop/pyproject.toml b/packages/contrib/quicksand-ubuntu-desktop/pyproject.tomlindex 63511ff..c46bf90 100644--- a/packages/contrib/quicksand-ubuntu-desktop/pyproject.toml+++ b/packages/contrib/quicksand-ubuntu-desktop/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-ubuntu-desktop"-version = "0.9.12.dev0"+version = "0.9.12"description = "Ubuntu 24.04 Desktop VM (Xfce4) for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/contrib/quicksand-ubuntu/pyproject.toml b/packages/contrib/quicksand-ubuntu/pyproject.tomlindex 2bd94d4..be1db5f 100644--- a/packages/contrib/quicksand-ubuntu/pyproject.toml+++ b/packages/contrib/quicksand-ubuntu/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-ubuntu"-version = "0.10.2.dev0"+version = "0.10.2"description = "Pre-built Ubuntu 24.04 VM image for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/dev/quicksand-base-scaffold/pyproject.toml b/packages/dev/quicksand-base-scaffold/pyproject.tomlindex fc36d05..45b3dd1 100644--- a/packages/dev/quicksand-base-scaffold/pyproject.toml+++ b/packages/dev/quicksand-base-scaffold/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-base-scaffold"-version = "0.3.13.dev0"+version = "0.3.13"description = "Template base image package for quicksand"requires-python = ">=3.11"license = "MIT"diff --git a/packages/dev/quicksand-image-tools/pyproject.toml b/packages/dev/quicksand-image-tools/pyproject.tomlindex 591375a..f172d39 100644--- a/packages/dev/quicksand-image-tools/pyproject.toml+++ b/packages/dev/quicksand-image-tools/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-image-tools"-version = "0.6.2.dev0"+version = "0.6.2"description = "Development tools for quicksand - build custom VM images from Dockerfiles"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/dev/quicksand-overlay-scaffold/pyproject.toml b/packages/dev/quicksand-overlay-scaffold/pyproject.tomlindex 31b28f2..3b3edee 100644--- a/packages/dev/quicksand-overlay-scaffold/pyproject.toml+++ b/packages/dev/quicksand-overlay-scaffold/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-overlay-scaffold"-version = "0.3.13.dev0"+version = "0.3.13"description = "Overlay image package for quicksand"readme = "README.md"requires-python = ">=3.11"diff --git a/packages/quicksand-core/pyproject.toml b/packages/quicksand-core/pyproject.tomlindex 04e49b7..8959d8b 100644--- a/packages/quicksand-core/pyproject.toml+++ b/packages/quicksand-core/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quicksand-core"-version = "0.14.1.dev0"+version = "0.14.1"description = "Core sandbox functionality for the quicksand VM harness."readme = "README.md"requires-python = ">=3.11"diff --git a/packages/quicksand/README.md b/packages/quicksand/README.mdindex 6be45f7..9c2f08a 100644--- a/packages/quicksand/README.md+++ b/packages/quicksand/README.md@@ -9,6 +9,16 @@Quicksand is an async Python API to launch, control, and snapshot [QEMU](https://www.qemu.org) virtual machines with a particular focus on sandboxing AI agents. Quicksand provides pre-built Linux VMs for Ubuntu and Alpine distros and supports x86_64 and ARM64 across macOS, Linux, and Windows. Running sandboxes needs no root privileges or Docker; install the QEMU and image extras for a bundled runtime on supported platforms.+## π Recent Releases++- **quick-sandbox v0.13.0 / quicksand-core v0.14.0** (2026-10-14)+ - π **Bidirectional port forwarding:** `Forward(Host(...), Guest(...))` lets guests reach services on the host, such as proxies, databases, and APIs.+- **quick-sandbox v0.12.0 / quicksand-core v0.13.0** (2026-09-14)+ - π₯ **Guest OS users:** `create_user()` and `execute(user=...)` run commands as separate accounts with their own home directories.+ - π₯ **Streaming stdin:** `execute(stdin=...)` streams input to commands while output streams back.++See the [changelog](CHANGELOG.md) for details.+## Installation```bashdiff --git a/packages/quicksand/pyproject.toml b/packages/quicksand/pyproject.tomlindex 45c3c45..849626c 100644--- a/packages/quicksand/pyproject.toml+++ b/packages/quicksand/pyproject.toml@@ -1,6 +1,6 @@[project]name = "quick-sandbox"-version = "0.13.1.dev0"+version = "0.13.1"description = "A VM harness for AI agents that works on macOS, Linux, and Windows."readme = "README.md"requires-python = ">=3.11"diff --git a/pyproject.toml b/pyproject.tomlindex df88dc8..ac9a582 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -23,20 +23,20 @@ skill-version = "0.40.0"workflow-version = "0.40.0"[tool.uvr.runners]-quicksand-agent = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quicksand-cua = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quick-sandbox = [["self-hosted", "linux", "x64"]]-quicksand-alpine = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quicksand-alpine-desktop = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quicksand-base-scaffold = [["self-hosted", "linux", "x64"]]-quicksand-core = [["self-hosted", "linux", "x64"]]-quicksand-image-tools = [["self-hosted", "linux", "x64"]]-quicksand-overlay-scaffold = [["self-hosted", "linux", "x64"]]-quicksand-qemu = [["self-hosted", "x64", "windows"], ["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"], ["self-hosted", "linux", "arm64"], ["windows-11-arm"]]-quicksand-smb = [["self-hosted", "linux", "x64"]]-quicksand-ubuntu = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quicksand-ubuntu-desktop = [["self-hosted", "linux", "x64"], ["self-hosted", "macos", "arm64"]]-quicksand-build-tools = [["self-hosted", "linux", "x64"]]+quicksand-agent = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quicksand-cua = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quick-sandbox = [["ubuntu-24.04"]]+quicksand-alpine = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quicksand-alpine-desktop = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quicksand-base-scaffold = [["ubuntu-24.04"]]+quicksand-core = [["ubuntu-24.04"]]+quicksand-image-tools = [["ubuntu-24.04"]]+quicksand-overlay-scaffold = [["ubuntu-24.04"]]+quicksand-qemu = [["self-hosted", "x64", "windows"], ["ubuntu-24.04"], ["self-hosted", "macos", "arm64"], ["self-hosted", "linux", "arm64"], ["windows-11-arm"]]+quicksand-smb = [["ubuntu-24.04"]]+quicksand-ubuntu = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quicksand-ubuntu-desktop = [["ubuntu-24.04"], ["self-hosted", "macos", "arm64"]]+quicksand-build-tools = [["ubuntu-24.04"]][tool.uvr.publish]index = "pypi"diff --git a/tests/unit/test_dev_build.py b/tests/unit/test_dev_build.pyindex 02470e5..24ce056 100644--- a/tests/unit/test_dev_build.py+++ b/tests/unit/test_dev_build.py@@ -256,6 +256,38 @@ def test_overlay_build_respects_release_rebuild_request(tmp_path, monkeypatch, pbuild.assert_not_awaited()+ ("runner", "retag_expected", "pure_expected"),+ [+ (["ubuntu-24.04"], True, True),+ (["self-hosted", "macos", "arm64"], True, False),+ (["windows-11-arm"], False, False),+ ],+)+def test_release_wheel_hooks_follow_the_build_runner(+ monkeypatch, runner, retag_expected, pure_expected+):+ import json++ import uvr_hooks++ monkeypatch.setenv("UVR_RUNNER", json.dumps(runner))+ with (+ patch.object(uvr_hooks, "_retag_wheels") as retag,+ patch.object(uvr_hooks, "_build_pure_wheels") as pure,+ ):+ uvr_hooks.Hooks().post_build()++ if retag_expected:+ retag.assert_called_once_with(Path("dist"))+ else:+ retag.assert_not_called()+ if pure_expected:+ pure.assert_called_once_with(Path("dist"))+ else:+ pure.assert_not_called()++@pytest.mark.asyncio@pytest.mark.skipif(os.name == "nt", reason="The installer executes inside a Unix guest")async def test_desktop_repository_setup_stops_on_key_download_failure(tmp_path, monkeypatch):diff --git a/uv.lock b/uv.lockindex 4f7e8d8..79fac1a 100644--- a/uv.lock+++ b/uv.lock@@ -948,7 +948,7 @@ wheels = [[[package]]name = "quick-sandbox"-version = "0.13.1.dev0"+version = "0.13.1"source = { editable = "packages/quicksand" }dependencies = [{ name = "packaging" },@@ -1020,7 +1020,7 @@ provides-extras = ["qemu", "ubuntu", "alpine", "alpine-desktop", "ubuntu-desktop[[package]]name = "quicksand-agent"-version = "0.4.12.dev0"+version = "0.4.12"source = { editable = "packages/contrib/quicksand-agent" }dependencies = [{ name = "quicksand-core" },@@ -1035,7 +1035,7 @@ requires-dist = [[[package]]name = "quicksand-alpine"-version = "0.10.2.dev0"+version = "0.10.2"source = { editable = "packages/contrib/quicksand-alpine" }dependencies = [{ name = "quicksand-core" },@@ -1054,7 +1054,7 @@ dev = [{ name = "quicksand-image-tools", editable = "packages/dev/quicksand-imag[[package]]name = "quicksand-alpine-desktop"-version = "0.9.12.dev0"+version = "0.9.12"source = { editable = "packages/contrib/quicksand-alpine-desktop" }dependencies = [{ name = "quicksand-alpine" },@@ -1072,7 +1072,7 @@ dev = [][[package]]name = "quicksand-base-scaffold"-version = "0.3.13.dev0"+version = "0.3.13"source = { editable = "packages/dev/quicksand-base-scaffold" }dependencies = [{ name = "quicksand-core" },@@ -1092,7 +1092,7 @@ source = { editable = "packages/dev/quicksand-build-tools" }[[package]]name = "quicksand-core"-version = "0.14.1.dev0"+version = "0.14.1"source = { editable = "packages/quicksand-core" }dependencies = [{ name = "certifi" },@@ -1113,7 +1113,7 @@ requires-dist = [[[package]]name = "quicksand-cua"-version = "0.3.14.dev0"+version = "0.3.14"source = { editable = "packages/contrib/quicksand-cua" }dependencies = [{ name = "quicksand-agent" },@@ -1147,7 +1147,7 @@ requires-dist = [[[package]]name = "quicksand-image-tools"-version = "0.6.2.dev0"+version = "0.6.2"source = { editable = "packages/dev/quicksand-image-tools" }dependencies = [{ name = "quicksand-core" },@@ -1158,7 +1158,7 @@ requires-dist = [{ name = "quicksand-core", editable = "packages/quicksand-core"[[package]]name = "quicksand-overlay-scaffold"-version = "0.3.13.dev0"+version = "0.3.13"source = { editable = "packages/dev/quicksand-overlay-scaffold" }dependencies = [{ name = "quicksand-core" },@@ -1185,7 +1185,7 @@ source = { editable = "packages/quicksand-smb" }[[package]]name = "quicksand-ubuntu"-version = "0.10.2.dev0"+version = "0.10.2"source = { editable = "packages/contrib/quicksand-ubuntu" }dependencies = [{ name = "quicksand-core" },@@ -1204,7 +1204,7 @@ dev = [{ name = "quicksand-image-tools", editable = "packages/dev/quicksand-imag[[package]]name = "quicksand-ubuntu-desktop"-version = "0.9.12.dev0"+version = "0.9.12"source = { editable = "packages/contrib/quicksand-ubuntu-desktop" }dependencies = [{ name = "quicksand-core" },diff --git a/uvr_hooks.py b/uvr_hooks.pyindex b325e60..5a7a9cb 100644--- a/uvr_hooks.py+++ b/uvr_hooks.py@@ -16,7 +16,7 @@ from uv_release.dependencies.shared.hooks import Hooks as ReleaseHook# x64 images are built natively on Linux; arm64 images are built on# macOS because the Linux arm64 runners lack KVM for overlay builds.RETAG_RUNNERS: list[list[str]] = [- ["self-hosted", "linux", "x64"],+ ["ubuntu-24.04"],["self-hosted", "macos", "arm64"],]@@ -83,7 +83,7 @@ def _retag_wheels(dist: Path) -> None:# Runner used to build pure (py3-none-any) wheels for PyPI.# Only one runner needs to do this since the output is platform-independent.-_PURE_WHEEL_RUNNER: list[str] = ["self-hosted", "linux", "x64"]+_PURE_WHEEL_RUNNER: list[str] = ["ubuntu-24.04"]# PyPI per-file size limit._PYPI_MAX_SIZE = 100 * 1024 * 1024 # 100 MB@@ -187,7 +187,7 @@ _TEST_PACKAGES = {class Hooks(ReleaseHook):- def post_plan(self, workspace, intent, plan: Plan) -> Plan:+ def post_plan(self, root: Path, command: str, plan: Plan) -> Plan:"""Customize the release plan."""changed = {r.name for r in plan.releases}if "test" not in plan.skip and not (changed & _TEST_PACKAGES):