headroom/e2e/wrap/Dockerfile
Rudimar Ronsoni b4571cc346
feat: headroom wrap opencode / unwrap opencode CLI (#1105)
## Summary

This PR implements transparent `headroom wrap opencode` support without
asking users to edit OpenCode provider URLs, choose an extra CLI flag,
or maintain a static provider list.

The wrapper now lives at the runtime transport boundary: OpenCode keeps
its user/provider config, while Headroom intercepts outbound provider
traffic in-process and routes it through the local Headroom proxy.

## What changed

### Transparent OpenCode wrapping

- `headroom wrap opencode` injects the `headroom-opencode` plugin
through `OPENCODE_CONFIG_CONTENT`.
- Existing OpenCode provider URLs are preserved. We do not rewrite user
config URLs to point at Headroom.
- Existing `OPENAI_BASE_URL` and `ANTHROPIC_BASE_URL` env vars are
preserved.
- Local OpenCode traffic, localhost traffic, and Headroom proxy traffic
bypass the shim to avoid loops.

### Runtime transport interception

- Added an OpenCode plugin transport shim that wraps:
  - `globalThis.fetch`
  - `http.request` / `http.get`
  - `https.request` / `https.get`
- External provider calls are routed to the local Headroom proxy.
- The original upstream origin is passed through `x-headroom-base-url`,
so the proxy can forward to the real provider without changing OpenCode
config.
- External `http2.connect` is blocked loudly instead of allowing direct
provider traffic to leak outside Headroom.

### Live provider additions

Provider coverage is no longer based on a static config scan. Because
routing happens at outbound request time, providers added mid-session
are routed through Headroom automatically as long as they use the
covered Node transport paths.

### Subagent and child-process coverage

- The parent OpenCode plugin sets a packaged Node preload shim through
`NODE_OPTIONS=--import=.../hook-shim/handler.js`.
- The transport shim patches `child_process.spawn`, `exec`, `execFile`,
and `fork` so child Node processes receive the Headroom preload even
when OpenCode passes a custom `env`.
- The child-process shim fails closed if it loads without
`HEADROOM_OPENCODE_TRANSPORT_PROXY_URL`.
- This closes the subagent leak path where a child Node process could
otherwise start without Headroom transport interception.

## Why this goes beyond PR #1089

PR #1089 improves OpenCode provider registration, but it still focuses
on provider config shape. This PR moves the enforcement boundary to
runtime transport interception.

This PR goes further because:

- No provider URL rewriting is required.
- New providers added mid-session are covered automatically.
- Subagents and child Node processes inherit the Headroom transport
shim.
- Direct external HTTP/2 paths fail loudly instead of leaking.
- The wrap remains transparent to the user's OpenCode provider config.
- The wrapper is fail-closed for unsupported child-process preload
state.

## Additional robustness fixes

While validating the change in Docker, the full Python suite exposed
unrelated Linux/container robustness issues. These are fixed in this PR
so the suite is green:

- Binary cache handling now treats cache paths under a non-writable
existing parent as unavailable, including when tests run as root in
Docker.
- `release_version.py` honors `MANUAL_VER` before git calls so direct
script execution works outside a `.git` checkout.
- Test logger isolation now resets relevant Headroom child loggers so
proxy logging setup cannot poison later `caplog` tests.
- The scanner missing-path test now uses a guaranteed missing `tmp_path`
child instead of relying on `/nonexistent/path`.

## Validation

All implementation validation was run inside Docker.

- Full Python suite from a fresh Docker copy: `6605 passed, 523
skipped`.
- Ruff on changed Python/OpenCode paths: passed.
- OpenCode plugin typecheck: passed.
- OpenCode plugin tests: `9 passed`.
- OpenCode plugin build: passed.
- Hook shim preload smoke test: passed.

## Notes

This PR intentionally does not add a CLI option. `headroom wrap
opencode` means full wrap. Either Headroom wraps OpenCode transparently,
or the path fails loudly instead of silently leaking provider traffic.

---------

Co-authored-by: Rudimar Ronsoni <6081613+rudironsoni@users.noreply.github.com>
2026-06-22 11:07:12 -05:00

124 lines
6.3 KiB
Docker

# ─── Stage 1: build the headroom-ai wheel in manylinux ─────────────────────
# Building from source inside `node:22-bookworm` produced a `_core.so` that
# referenced `__isoc23_strtoll` (a glibc 2.38+ symbol). The runtime in the
# same image couldn't resolve it at import time because something in the
# build chain — gcc version, libc6-dev backport, or cc-rs compiling
# transitive C deps against newer headers — emitted C23-era symbols that
# the runtime libc.so.6 doesn't have. Building inside the manylinux_2_28
# container (AlmaLinux 8, glibc 2.28 baseline) guarantees the wheel works
# on any glibc 2.28+ runtime, including bookworm.
FROM quay.io/pypa/manylinux_2_28_x86_64 AS builder
# No OpenSSL system deps required. As of the rustls-everywhere refactor,
# all HTTP+TLS in our Rust crates goes through `rustls`. fastembed's
# `hf-hub-rustls-tls` + `ort-download-binaries-rustls-tls` features
# replace the default native-tls path; `cargo tree -p headroom-py -i
# openssl-sys` returns "not found", confirming this Dockerfile no
# longer needs `openssl-devel`, `pkgconfig`, or any perl modules
# (Time::Piece, IPC::Cmd) for the openssl-src vendored Configure
# script. The historical `yum install openssl-devel pkgconfig
# perl-IPC-Cmd` line is intentionally absent.
# Install rust toolchain into the manylinux container. Match the
# rust-toolchain.toml at repo root (1.95.0 + rustfmt + clippy) so cargo
# doesn't try to mutate the toolchain on first invocation.
ENV CARGO_HOME=/usr/local/cargo \
RUSTUP_HOME=/usr/local/rustup \
PATH=/usr/local/cargo/bin:/opt/python/cp311-cp311/bin:${PATH}
RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
| sh -s -- -y --no-modify-path --profile minimal -c rustfmt -c clippy --default-toolchain 1.95.0
WORKDIR /build
COPY pyproject.toml uv.lock README.md ./
COPY Cargo.toml Cargo.lock rust-toolchain.toml ./
COPY crates/ crates/
COPY headroom/ headroom/
# Build the wheel with maturin. PYO3_USE_ABI3_FORWARD_COMPATIBILITY allows
# building against Python 3.14+ until we bump pyo3 past 0.22.
ENV PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1
# Build for Python 3.11 — aider-chat==0.86.2 requires Python <3.12, and
# trixie's default python3.13 is too new for aider. The manylinux image
# has python interpreters for every version at /opt/python/cpXY-cpXY/.
# Stage 2 uses `python:3.11-slim` (now trixie-based, glibc 2.41).
RUN /opt/python/cp311-cp311/bin/pip install 'maturin>=1.5,<2.0' && \
/opt/python/cp311-cp311/bin/maturin build --release --out /dist --interpreter python3.11
# ─── Stage 2: python+node runtime ───────────────────────────────────────────
# Base on `python:3.11-slim` (now trixie, glibc 2.41) instead of
# `node:22-bookworm` (glibc 2.36): the wheel's `_core.so` references
# three glibc 2.38+ C23 wrappers (`__isoc23_strtol{,l,ul}`) that one of
# our transitive C/C++ deps emits during cc-rs compilation even when
# built inside manylinux_2_28 (probably libstdc++'s `<cstdlib>` resolving
# `std::strtoll` to the C23 variant when the toolchain has newer
# headers). Bookworm's libc.so.6 doesn't export these wrappers, so
# `import headroom._core` fails at runtime. Trixie's glibc 2.41 does.
#
# We need Python 3.11 here (aider-chat==0.86.2 requires Python <3.12).
# Trixie's default `python3` is 3.13 — too new for aider. python:3.11-slim
# gives us Python 3.11 + trixie glibc + apt access for installing Node.
FROM python:3.11-slim
ENV DEBIAN_FRONTEND=noninteractive \
AIDER_CHAT_VERSION=0.86.2 \
CODEX_VERSION=0.118.0 \
OPENCLAW_VERSION=2026.4.7 \
OPENCODE_VERSION=1.17.8 \
PATH="/opt/headroom-venv/bin:/opt/aider-venv/bin:${PATH}" \
PIP_DISABLE_PIP_VERSION_CHECK=1 \
PIP_NO_CACHE_DIR=1 \
PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1
# Install Node.js 22 from NodeSource (matches what node:22-trixie gives,
# but layered onto python:3.11-slim so we get py3.11 + node22 + glibc 2.41
# in one image). Also install git for any package that clones at install.
RUN apt-get update && \
apt-get install -y --no-install-recommends \
ca-certificates \
curl \
git \
gnupg && \
curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
apt-get install -y --no-install-recommends nodejs && \
rm -rf /var/lib/apt/lists/*
WORKDIR /workspace
# Bring in the prebuilt manylinux wheel from stage 1.
COPY --from=builder /dist/*.whl /tmp/wheels/
# `sdk/typescript` and `plugins/openclaw` are wired into the wrap-e2e
# harness (e2e/wrap/run.py invokes `npx openclaw`). DO NOT copy
# `headroom/` or `pyproject.toml` from the workspace — they would shadow
# the installed wheel's `headroom/` package via cwd and Python would
# import the source-only `headroom/` (which has no `_core.so`),
# triggering the same `ModuleNotFoundError` the wheel install fixes.
COPY sdk/typescript ./sdk/typescript
COPY plugins/openclaw ./plugins/openclaw
# Install the prebuilt manylinux wheel with [proxy] extras. Pip resolves
# extras from the wheel's metadata and pulls deps from public PyPI. The
# wheel's `_core.so` was compiled against glibc 2.28, so it loads cleanly
# against bookworm's glibc 2.36 at runtime.
RUN python -m venv /opt/headroom-venv && \
/opt/headroom-venv/bin/python -m pip install --upgrade pip && \
/opt/headroom-venv/bin/python -m pip install "$(ls /tmp/wheels/headroom_ai-*.whl)[proxy]" && \
/opt/headroom-venv/bin/python -c "from headroom._core import DiffCompressor; print('headroom._core OK')" && \
python -m venv /opt/aider-venv && \
/opt/aider-venv/bin/python -m pip install --upgrade pip && \
/opt/aider-venv/bin/python -m pip install "aider-chat==${AIDER_CHAT_VERSION}" && \
npm install -g --no-fund --no-audit "@openai/codex@${CODEX_VERSION}" "openclaw@${OPENCLAW_VERSION}" && \
curl -fsSL https://opencode.ai/install | VERSION="${OPENCODE_VERSION}" bash
# The opencode installer adds its bin dir to .bashrc. Non-login shells
# (including CMD, docker run, and e2e shims spawned by subprocess) won't
# source .bashrc, so add the dir to PATH explicitly. The e2e shim shadows
# opencode anyway, but this guarantees `which opencode` works for
# diagnostics.
ENV PATH="/root/.opencode/bin:${PATH}"
COPY e2e/wrap ./e2e/wrap
CMD ["python", "e2e/wrap/run.py"]