Skip to content

Quickly sandbox your AI agent.

Python

Release build-tools 0.6 for Linux build API compatibility

Tyler Paynea484a6455afa
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 39a630e..e9ba338 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,11 +15,12 @@ Streaming command input, guest OS accounts, and more reliable mounted-file workf
### Changed
- **quicksand-image-tools / quicksand-alpine / quicksand-ubuntu:** Image freshness checks include the Rust agent source and Cargo manifests, so agent-only changes rebuild cached images.
+- **quicksand-build-tools v0.6.0:** Linux callers of `BinaryBundler.set_platform_wheel_tag()` must pass `bin_dir` and include auditwheel in their build dependencies. The QEMU build hook supplies both.
- **Documentation:** Added a command-scoped `core.filemode=false` workaround for synthetic executable bits on CIFS-mounted Git repositories. The host-index deletion reported in #31 did not reproduce and remains unconfirmed.
### Fixed
- **quicksand-core:** Bundled SMB mounts use guest-local CIFS locks so `flock` and SQLite commits work. Native SMB retains server-side byte-range locking. Guest-local locks do not coordinate with host processes, other VMs, or separate mounts. (#44)
-- **quicksand-build-tools v0.5.10 / quicksand-qemu v0.5.12:** Linux wheel tags reflect the actual glibc requirements of bundled ELF binaries and libraries instead of always claiming manylinux 2.17 compatibility.
+- **quicksand-build-tools v0.6.0 / quicksand-qemu v0.5.12:** Linux wheel tags reflect the actual glibc requirements of bundled ELF binaries and libraries instead of always claiming manylinux 2.17 compatibility.
### Released (dependency updates)
- quicksand-agent v0.4.10, quicksand-cua v0.3.12, quicksand-alpine-desktop v0.9.10, quicksand-ubuntu-desktop v0.9.10, quicksand-base-scaffold v0.3.11, and quicksand-overlay-scaffold v0.3.11. Updated dependency ranges pick up the new core, image tooling, and base images.
diff --git a/docs/under-the-hood/01-installation.md b/docs/under-the-hood/01-installation.md
index df88a91..e049f14 100644
--- a/docs/under-the-hood/01-installation.md
+++ b/docs/under-the-hood/01-installation.md
@@ -80,6 +80,11 @@ Linux manylinux versions are derived from versioned symbols in the bundled ELF
binaries and libraries. They are not fixed at glibc 2.17; pip selects a wheel
compatible with the host's glibc version.
+With quicksand-build-tools 0.6.0, custom Linux build hooks must pass the bundled
+binary directory as `bin_dir` to `BinaryBundler.set_platform_wheel_tag()` and
+include auditwheel in their build dependencies. The QEMU hook supplies both;
+applications using `Sandbox` do not need to change their build configuration.
+
¹ **Windows ARM64 tag override:** The ARM64 runner runs x86_64 Python through transparent emulation, so `sysconfig.get_platform()` returns `win-amd64`. Without intervention, this runner would produce a **second** `win_amd64` wheel containing ARM64 binaries — colliding with the x64 runner's wheel and making the fat wheel merge impossible (no `win_arm64` to merge from). We override the wheel tag in `BinaryBundler.set_platform_wheel_tag()` (`quicksand-build-tools`, used by quicksand-qemu) and `set_platform_wheel_tag()` (`quicksand-image-tools`, used by image packages) by reading the native architecture from the Windows Registry (`HKLM\...\PROCESSOR_ARCHITECTURE`), which always reports `ARM64` regardless of process emulation.
#### Image wheels (ubuntu, alpine, etc.): build runners → retag
diff --git a/packages/dev/quicksand-build-tools/pyproject.toml b/packages/dev/quicksand-build-tools/pyproject.toml
index 0451d1f..b80a558 100644
--- a/packages/dev/quicksand-build-tools/pyproject.toml
+++ b/packages/dev/quicksand-build-tools/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "quicksand-build-tools"
-version = "0.5.10"
+version = "0.6.0"
description = "Shared build utilities for bundling native binaries into quicksand wheels."
requires-python = ">=3.11"
license = "MIT"
diff --git a/packages/quicksand-qemu/pyproject.toml b/packages/quicksand-qemu/pyproject.toml
index 5af2045..cd551cf 100644
--- a/packages/quicksand-qemu/pyproject.toml
+++ b/packages/quicksand-qemu/pyproject.toml
@@ -8,13 +8,7 @@ license = "MIT"
dependencies = []
[build-system]
-requires = [
- "hatchling",
- "quicksand-build-tools>=0.5.3,<0.6.0",
- # auditwheel derives the wheel's manylinux tag from the bundled binaries'
- # glibc requirement on Linux. It pulls in pyelftools for ELF inspection.
- "auditwheel; sys_platform == 'linux'",
-]
+requires = ["hatchling", "quicksand-build-tools>=0.6.0,<0.7.0", "auditwheel; sys_platform == 'linux'"]
build-backend = "hatchling.build"
[tool.hatch.build.targets.wheel]
diff --git a/uv.lock b/uv.lock
index 2575723..5eb615f 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1075,7 +1075,7 @@ requires-dist = [
[[package]]
name = "quicksand-build-tools"
-version = "0.5.10"
+version = "0.6.0"
source = { editable = "packages/dev/quicksand-build-tools" }
[[package]]