Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

3.4 KB
Raw Blame

Wrap E2E CLI dependencies

The Docker harness installs Codex and OpenClaw here using npm 12.2.1 and npm ci. Keep the manifest and lockfile together: pinning only the CLI versions still lets transitive dependency ranges change on every image build. That broke main during an AWS SDK publication on 2026-09-09 (ETARGET and tarball 404).

The image installs into /opt/wrap-tools and exposes node_modules/.bin on PATH. npm ci does not support global installs, so diagnostics must also use npm list --prefix /opt/wrap-tools.

After editing a CLI version in package.json, regenerate the lockfile using Node 24.22.1+ within the Node 24 line and npm 12.2.1 on Linux (the pinned OpenClaw version no longer supports Node 22):

cd e2e/wrap/tools
npm install --package-lock-only --no-fund --no-audit
npm ci --no-fund --no-audit
npm test
cd ../../..
docker build -f e2e/wrap/Dockerfile -t headroom-wrap-e2e .
docker run --rm headroom-wrap-e2e

npm test runs the Ajv URI, minimatch pattern-expansion and Express body-parser regression checks against the installed locked dependencies. The Dockerfile runs the same command from /opt/wrap-tools after npm ci, so failures stop the image build in both the existing Wrap E2E workflow and CI's Docker-native wrap E2E job. Their path filters include e2e/**, covering dependency and regression-test updates.

To intentionally refresh transitive versions without changing the pinned CLI versions, use npm update --package-lock-only --no-fund --no-audit in this directory instead of npm install --package-lock-only, then run the same installation and Docker checks above.

Review the lockfile diff and justify dependency changes in the PR. A lockfile fixes resolution and checks package integrity; it cannot make the npm registry available during an outage. Do not delete the lockfile or add fallback installs to make a build pass.

These are existing test tools, not new product dependencies. Codex is maintained by OpenAI; OpenClaw and its transitive dependencies retain their upstream maintainers. Their install surface includes registry downloads, native optional packages and lifecycle scripts, as before. OpenClaw 2026.10.10 and its fixed Undici override follow the upstream #4453 security repair.

The raw audit still reports npm 12.2.1's bundled ip-address and Undici copies. npm-audit-exceptions.json records the upstream-approved E2E-only risk acceptance, restricted to exact advisory/path/version combinations and expiring on 2026-11-15. Security CI rejects other findings and expired or stale entries; these exceptions are not a claim that the contained packages are patched.

The root allowScripts policy approves only the exact locked install-script identities reviewed for this harness: @google/[email protected] (no-op preinstall), [email protected] (native binary validation/fallback acquisition), [email protected] (dependency version-scheme warning), and [email protected] (package-manager/runtime validation and bundled-plugin/native prebuild maintenance). These scripts execute package code and may spawn helpers; esbuild may acquire its platform binary. No wildcard or blanket approval is used. The local .npmrc enables strict review: a new install-script identity fails installation until its script and version are reviewed. npm12 otherwise blocks unreviewed scripts while merely warning, which is insufficient proof that the normal lifecycle ran. Bundled npm dependency copies do not run separate scripts.