Skip to content

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.md
index 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 `refer
If 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. Branch
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 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.04
steps:
- 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.04
strategy:
fail-fast: true
matrix:
@@ -87,6 +87,14 @@ jobs:
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
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-uv
uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
with:
@@ -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.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-14
Bidirectional 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.toml
index 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.md
index 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
```bash
diff --git a/packages/quicksand/pyproject.toml b/packages/quicksand/pyproject.toml
index 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.toml
index 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.py
index 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, p
build.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.lock
index 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.py
index 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):