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.
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.