Skip to content

fix(docker): pass RUNTIME_HOME=/root for root bake targets - #4445

Merged
JerrettDavis merged 5 commits into
headroomlabs-ai:mainfrom
drakeo338:claude/4443-fix
Nov 4, 2026
Merged

JerrettDavis merged 5 commits into
headroomlabs-ai:mainfrom
drakeo338:claude/4443-fix

Conversation

@drakeo338

@drakeo338 drakeo338 commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Description

Fixes #4443.

The four root bake targets (runtime, runtime-code, runtime-slim, runtime-code-slim) set RUNTIME_USER=root but not RUNTIME_HOME, so the Dockerfile default /home/nonroot was used for VOLUME and WORKDIR while the process runs with HOME=/root. ~/.headroom therefore landed in the container layer instead of the declared volume.

Passing RUNTIME_HOME=/root fixes the two python-slim targets, but the two slim targets build the distroless runtime-slim stage, which declared no ARG RUNTIME_HOME and no VOLUME at all, so the arg was a silent no-op there. That stage now declares ARG RUNTIME_HOME and VOLUME ${RUNTIME_HOME}/.headroom, and since distroless has no shell for RUN mkdir, the state directory is built in a small runtime-slim-state stage and copied in owned by RUNTIME_USER.

Closes #4443

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • Performance improvement
  • Code refactoring (no functional changes)

Changes Made

  • docker-bake.hcl: pass RUNTIME_HOME = "/root" in the four targets that set RUNTIME_USER = "root".
  • Dockerfile: new runtime-slim-state stage (python:${PYTHON_VERSION}-slim) that creates /state/.headroom; the distroless runtime-slim stage now declares ARG RUNTIME_HOME=/home/nonroot, copies that directory to ${RUNTIME_HOME}/ with --chown=${RUNTIME_USER}:${RUNTIME_USER}, and declares VOLUME ${RUNTIME_HOME}/.headroom, matching the python-slim stage.
  • tests/test_release_workflows.py: test_docker_bake_runtime_args_are_declared_by_the_selected_stage walks every bake target, resolves the Dockerfile stage it builds (including inherited parent stages), and checks that each RUNTIME_* arg it passes is declared by that stage, that root targets use /root, and that the stage puts VOLUME ${RUNTIME_HOME}/.headroom under the home it was given.

Testing

  • Unit tests pass (pytest)
  • Linting passes (ruff check .)
  • Type checking passes (mypy headroom)
  • New tests added for new functionality
  • Manual testing performed

Test Output

$ pytest tests/test_release_workflows.py -q            # head 59bd12d
58 passed, 1 warning in 6.41s

$ pytest tests/test_release_workflows.py -q -k runtime_args   # new test on upstream main
E   AssertionError: runtime: root target needs /root
1 failed, 57 deselected, 1 warning in 0.77s

$ pytest tests/test_release_workflows.py -q -k runtime_args   # new test on ae30825 (bake fix only)
E   AssertionError: runtime-slim: stage runtime-slim does not declare {'RUNTIME_HOME'}
1 failed, 57 deselected, 1 warning in 0.40s

$ ruff check tests/test_release_workflows.py
All checks passed!
$ ruff format --check tests/test_release_workflows.py
1 file already formatted

Real Behavior Proof

  • Environment: local Linux, Python 3.14, pytest (no Docker daemon locally); Docker images built and run on a GitHub-hosted ubuntu-latest runner (Docker 28.0.4, buildx v0.38.1, linux/amd64) by a scratch workflow in my fork on top of 59bd12d: run, workflow
  • Exact command / steps: ran the new test against upstream main, against ae30825 (bake args only) and against head 59bd12d (bake args plus the runtime-slim stage change); full tests/test_release_workflows.py on head. On the runner: docker buildx bake -f docker-bake.hcl --print runtime runtime-code runtime-slim runtime-code-slim; docker buildx bake -f docker-bake.hcl --set '*.platform=linux/amd64' --load of the same four targets; docker inspect of Config.User, Config.WorkingDir, Config.Volumes per image; per image, one container writes /root/.headroom/probe on a named volume and a second container on the same volume reads it back, plus docker create without -v to list the image's own mounts
  • Observed result: the test fails on main (root targets have no RUNTIME_HOME), fails on ae30825 (the distroless runtime-slim stage does not declare RUNTIME_HOME, so the slim targets ignore it), passes on 59bd12d; all 58 tests in the file pass. The bake plan resolves runtime/runtime-code to stage runtime and runtime-slim/runtime-code-slim to stage runtime-slim, all with RUNTIME_USER=root RUNTIME_HOME=/root. Inspected: runtime and runtime-code have User="root" WorkingDir="/root" Volumes={"/root/.headroom":{}}; runtime-slim and runtime-code-slim have User="root" WorkingDir="/app" Volumes={"/root/.headroom":{}}. In all four the probe written by the first container is read back by the second, and docker create shows type=volume destination=/root/.headroom
  • Not tested: mypy (no Python package code changed)

Runtime Rollout Safety

  • Rollout-managed feature(s): none
  • Minimum rollout channel: n/a
  • Stable/default behavior changed: yes, the root images keep ~/.headroom on the declared volume, and the distroless slim images now declare that volume
  • Kill switch / disable path: n/a
  • Unsafe override required: no
  • Qualification impact: none
  • Rollback path: revert this PR

Review Readiness

  • I have performed a self-review
  • This PR is ready for human review

Checklist

  • My code follows the project's style guidelines
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • I did not edit CHANGELOG.md — it is generated by release-please from my Conventional Commit PR title (a CI guard enforces this)

Screenshots (if applicable)

N/A

Additional Notes

N/A


Devin Review

The root image variants (runtime, runtime-code, runtime-slim,
runtime-code-slim) set RUNTIME_USER=root but left RUNTIME_HOME at the
Dockerfile default of /home/nonroot, so VOLUME and WORKDIR pointed at
/home/nonroot while the process ran with HOME=/root and ~/.headroom
landed in the container layer instead of the volume.

Fixes headroomlabs-ai#4443
@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

PR governance

This PR follows the template and is marked ready for human review.

@github-actions github-actions Bot added status: needs author action Pull request body or readiness checklist still needs author updates status: ci failing Required or reported CI checks are failing labels Oct 23, 2026

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Devin Review

Comment thread docker-bake.hcl
args = {
HEADROOM_EXTRAS = "proxy,bedrock"
RUNTIME_USER = "root"
RUNTIME_HOME = "/root"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Root slim images still lose state

For root slim builds, RUNTIME_HOME leaves state without a declared volume. The runtime-slim stage never consumes this argument or declares a volume, so container removal discards that state.

Learn more

The runtime-slim bake target selects the distroless stage, not the python-slim stage where RUNTIME_HOME controls WORKDIR and VOLUME. Docker build arguments do not affect a stage unless that stage declares and uses them. Neither root slim variant gains a persistent /root/.headroom volume from this change. The new regression test checks only bake text, so it passes without validating the built image.

Example: Building runtime-slim with RUNTIME_HOME=/root still produces the distroless stage with WORKDIR /app and no VOLUME; a bare container writing /root/.headroom loses its state when removed.

Recommended fix: Declare and use RUNTIME_HOME and a suitable persistent volume in the distroless stage if that variant supports durable state, and verify the built image's volume and workdir rather than only searching bake text.

Devin Review


Was this helpful? React with 👍 or 👎 to provide feedback.

Comment thread tests/test_release_workflows.py Resolved
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@JerrettDavis JerrettDavis left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] Apply the home/volume fix to the actual stages selected by each advertised variant. docker buildx bake -f docker-bake.hcl --print runtime runtime-code runtime-slim runtime-code-slim confirms the two regular variants select Dockerfile stage runtime, while runtime-slim and runtime-code-slim select the separate distroless runtime-slim stage. That distroless stage does not declare or consume ARG RUNTIME_HOME, keeps WORKDIR /app, and declares no VOLUME. Passing RUNTIME_HOME=/root to those two targets therefore has no persistence effect.

The new test passes because it checks only the HCL argument text, not the selected Dockerfile stage's behavior. All 55 release-workflow tests pass locally, despite the two slim variants still lacking the state-volume configuration described by this PR. Please implement the corresponding stage behavior or explicitly narrow the claimed fixed variants and remove misleading unused arguments; cover the stage/argument connection and verify the resulting image configuration/persistence. I independently confirmed the existing inline finding with Docker's resolved bake plan rather than relying on the comment alone.

I did not build the full multi-stage images after identifying this structural blocker, so there is no claimed container-runtime persistence proof. The initial default bake invocation also tried to load unrelated docker-compose.yml and required NEO4J_AUTH; using the explicit -f above isolates this PR's bake file without any service credentials. GitHub reports the head mergeable. No contributor CI action is requested, no contributor logic was modified, and nothing was merged.

@github-actions github-actions Bot added status: needs rebase Pull request branch is behind the base branch on files it also changes status: has conflicts Pull request has merge conflicts with the base branch labels Oct 29, 2026
…lume

The runtime-slim and runtime-code-slim bake targets build the distroless
runtime-slim stage, which declared no ARG RUNTIME_HOME and no VOLUME, so
the RUNTIME_HOME=/root passed by the root slim targets did nothing and
~/.headroom stayed in the container layer.

Declare RUNTIME_HOME in that stage, create ~/.headroom owned by the
runtime user (distroless has no shell, so build it in a helper stage and
COPY it in) and declare it as a VOLUME, matching the python-slim stage.

Replace the HCL-text-only test with one that resolves each bake target to
its Dockerfile stage (following FROM <stage> inheritance) and checks the
stage declares every RUNTIME_* arg the target passes and puts its VOLUME
under RUNTIME_HOME.

Refs headroomlabs-ai#4443
@drakeo338

Copy link
Copy Markdown
Contributor Author

Pushed 59bd12d: merged upstream main to clear the conflict, gave the distroless runtime-slim stage ARG RUNTIME_HOME, an owned ~/.headroom directory and a VOLUME, and replaced the HCL-text test with one checking each bake target against its Dockerfile stage.

@github-actions github-actions Bot added status: ready for review Pull request body is complete and the author marked it ready for human review status: ci failing Required or reported CI checks are failing and removed status: needs rebase Pull request branch is behind the base branch on files it also changes status: has conflicts Pull request has merge conflicts with the base branch status: ci failing Required or reported CI checks are failing status: needs author action Pull request body or readiness checklist still needs author updates status: ready for review Pull request body is complete and the author marked it ready for human review labels Oct 29, 2026
@drakeo338

Copy link
Copy Markdown
Contributor Author

I built and ran the four root targets from 59bd12d on a GitHub-hosted ubuntu-latest runner, using a scratch workflow in my fork (one added file on top of 59bd12d, no code changes): run, workflow file. Docker 28.0.4, buildx v0.38.1, linux/amd64.

Resolved plan (docker buildx bake -f docker-bake.hcl --print runtime runtime-code runtime-slim runtime-code-slim, trimmed):

runtime:           stage=runtime       RUNTIME_USER=root RUNTIME_HOME=/root
runtime-code:      stage=runtime       RUNTIME_USER=root RUNTIME_HOME=/root
runtime-slim:      stage=runtime-slim  RUNTIME_USER=root RUNTIME_HOME=/root
runtime-code-slim: stage=runtime-slim  RUNTIME_USER=root RUNTIME_HOME=/root

After docker buildx bake -f docker-bake.hcl --set '*.platform=linux/amd64' --load ... of all four, docker inspect of each image:

runtime:           User="root" WorkingDir="/root" Volumes={"/root/.headroom":{}}
runtime-code:      User="root" WorkingDir="/root" Volumes={"/root/.headroom":{}}
runtime-slim:      User="root" WorkingDir="/app"  Volumes={"/root/.headroom":{}}
runtime-code-slim: User="root" WorkingDir="/app"  Volumes={"/root/.headroom":{}}

Persistence: one container writes /root/.headroom/probe on a named volume, a second container on the same volume reads it back (python3 as entrypoint, since the distroless images have no shell). docker create with no -v shows the image's own VOLUME:

runtime:           wrote as uid 0 (HOME=/root) -> read back: probe-runtime            | anonymous mount: type=volume destination=/root/.headroom
runtime-code:      wrote as uid 0 (HOME=/root) -> read back: probe-runtime-code       | anonymous mount: type=volume destination=/root/.headroom
runtime-slim:      wrote as uid 0 (HOME=/root) -> read back: probe-runtime-slim       | anonymous mount: type=volume destination=/root/.headroom
runtime-code-slim: wrote as uid 0 (HOME=/root) -> read back: probe-runtime-code-slim  | anonymous mount: type=volume destination=/root/.headroom

In all four images os.path.expanduser('~/.headroom') resolves to /root/.headroom, which exists and is writable. The slim images keep WORKDIR /app (unchanged by this PR); ~/.headroom resolves through HOME=/root there as well, as the probe shows.

@JerrettDavis JerrettDavis left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed 59bd12d, including the prior stage/volume finding and the author's new runtime evidence. The distroless stage now declares and consumes RUNTIME_HOME, copies an owned state directory from a shell-capable stage, and declares the corresponding volume. The updated test checks the stage selected by each bake target. All 58 release-workflow tests and Ruff pass locally; Docker's resolved bake plan maps all four root targets to the intended stage with RUNTIME_HOME=/root. Current main is included and GitHub reports no conflict.

I inspected successful fork qualification run 40957966633 and its image/persistence logs: all four images declare /root/.headroom, and a second container reads back each named-volume probe. The qualification commit differs from this PR head only by the evidence workflow file, verified via GitHub compare. These are inspected hosted results, not a claim that I rebuilt all images locally.

The remaining hosted Python failure is the read-maturation fixture assertion, independently reproduced on current main a2d4fe7. It does not hold this PR's approval. The prior slim-image persistence finding is resolved; no remaining blocking findings.

@github-actions github-actions Bot added status: ready for review Pull request body is complete and the author marked it ready for human review and removed status: ci failing Required or reported CI checks are failing labels Nov 4, 2026
@JerrettDavis
JerrettDavis merged commit 670767e into headroomlabs-ai:main Nov 4, 2026
46 checks passed
@headroom-release headroom-release Bot mentioned this pull request Nov 5, 2026
JerrettDavis added a commit that referenced this pull request Nov 5, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.43.0](v0.42.0...v0.43.0)
(2026-11-05)


### ⚠ BREAKING CHANGES

* **mcp:** port MCP servers to SDK 2.x
([#4603](#4603))

### Features

* **ccr:** answer headroom_retrieve on streaming chat completions
([#4631](#4631))
([31dcaf4](31dcaf4))
* **mcp:** port MCP servers to SDK 2.x
([#4603](#4603))
([ee2252a](ee2252a))
* **plugins:** headroom skill for Claude Code, Codex, Copilot and
skills.sh
([#4533](#4533))
([66e1467](66e1467))
* **savings:** show the proxy's model-routing savings in headroom
savings
([#4304](#4304))
([aaab338](aaab338))


### Bug Fixes

* [BUG] A timeout in one image compression call resets the shared worker
pool and affects concurrent requests
([#4528](#4528))
([e9bcfe7](e9bcfe7))
* [BUG] DirectMem0Adapter.search_memories calls removed mem0 search API
([#4518](#4518))
([d9cee45](d9cee45))
* [BUG] Saved request metrics lose their cache optimization fields
([#4584](#4584))
([b4c9bdf](b4c9bdf))
* [BUG] Volatile SQLite metrics stores lose their schema before the
first save
([#4633](#4633))
([d8ff0fe](d8ff0fe))
* Add info about apply to README.md
([#1592](#1592))
([4d34680](4d34680))
* **backends/litellm:** keep cache_control on text blocks for Bedrock
prompt caching
([#4565](#4565))
([23a5bb1](23a5bb1))
* **backends:** forward the standard service_tier param (litellm +
anyllm)
([#2468](#2468))
([62cc38a](62cc38a))
* **cache:** build semantic entry before evicting so a failed embedding
keeps live entries
([#4581](#4581))
([0d4c450](0d4c450))
* **cache:** count a tool_result with no text as replayable in the
frozen prefix
([#4523](#4523))
([fba09f6](fba09f6))
* **cache:** fail closed on SQLite corruption instead of deleting the
store online
([#4361](#4361))
([9801833](9801833))
* **cache:** invalidate configured registry instances on replacement
([#4363](#4363))
([1bcdca2](1bcdca2))
* **cache:** namespace SemanticCacheLayer by provider, model and
metadata
([#4473](#4473))
([99cdaaf](99cdaaf))
* **cache:** preserve OpenAI tool block metadata on cached replay
([#4334](#4334))
([f1035ac](f1035ac))
* **cache:** scope router results to request compression policy
([#4590](#4590))
([5d40fe7](5d40fe7))
* **ccr:** buffer a stream only for a marker new this turn
([#4607](#4607))
([946a70c](946a70c))
* **ccr:** keep proactive expansion out of the cached prefix
([#4300](#4300))
([b1f340e](b1f340e))
* **cli:** document that code-aware compression is enabled by default
([#4616](#4616))
([affd17c](affd17c))
* **client:** close upstream responses when wrapped streams are closed
([#4482](#4482))
([3d8dcf4](3d8dcf4))
* **client:** honor configured cache optimizer enablement
([#4501](#4501))
([d4c0810](d4c0810))
* **client:** preserve Anthropic create stream flags
([#4500](#4500))
([3910caa](3910caa))
* **codex:** accept multi-line inline tables in Codex config.toml
([#4436](#4436))
([4a851ed](4a851ed))
* **compaction:** reject negative dictionary indices and non-array
legends in expand_compacted
([#4470](#4470))
([3c1fcbd](3c1fcbd))
* **core:** case-insensitive Bearer scheme, clamp SQLite CCR TTLs,
redact the Redis URL in logs
([#4561](#4561))
([9e8cc64](9e8cc64))
* **dedup:** bound line-number digit run and never fold into a longer
pointer
([#4488](#4488))
([21e8867](21e8867))
* **deps:** clear the glob and minimatch npm audit findings
([#4599](#4599))
([2e49e53](2e49e53))
* **diff:** keep combined-diff changes made against a later parent
([#4318](#4318))
([4b788fd](4b788fd))
* **docker:** install the redis extra in every image
([#4514](#4514))
([8d5dde7](8d5dde7))
* **docker:** pass RUNTIME_HOME=/root for root bake targets
([#4445](#4445))
([670767e](670767e))
* **doctor:** detect root openai_base_url Codex routing and
agent-configured proxy ports
([#4490](#4490))
([222f2d1](222f2d1))
* **evals:** reject changed numeric probe values
([#4502](#4502))
([1fe8549](1fe8549))
* **install:** stabilize Windows task lifecycle and eliminate console
window popup
([#4627](#4627))
([6b903cb](6b903cb))
* **install:** tolerate absent Windows tasks in stop_supervisor
([#4465](#4465))
([#4468](#4468))
([50af2ff](50af2ff))
* **kompress:** keep words past the tokenizer's truncation point
([#4328](#4328))
([bb13384](bb13384))
* **kompress:** read the pinned snapshot from Python's one HF cache in
the native proxy
([#4438](#4438))
([eef44f6](eef44f6))
* **langgraph:** replace the compressed ToolMessage in graph state
([#4620](#4620))
([70a8f09](70a8f09))
* **mcp:** confine headroom_read to the workspace (GHSA-8g49-pg6g-xgrf)
([#4525](#4525))
([8ab2e91](8ab2e91))
* **memory:** bound verb-pattern word runs to stop quadratic
backtracking in bridge import
([#4370](#4370))
([#4376](#4376))
([d232d09](d232d09))
* **memory:** fail close unresolved project operations
([#2637](#2637))
([957ab18](957ab18))
* **memory:** keep learned evidence until persistence succeeds
([#4229](#4229))
([662a7f6](662a7f6))
* **memory:** preserve parent scopes when clearing memories
([#4305](#4305))
([a8375a1](a8375a1))
* **mixed-content:** do not carve ISO-timestamped log rows as search
results
([#4463](#4463))
([abbade9](abbade9))
* **offline:** guard the learn and memory-eval LLM calls under
HEADROOM_OFFLINE
([#4344](#4344))
([dd361bb](dd361bb))
* **openclaw/release:** ship responsive npm integrations
([#1458](#1458))
([33f2044](33f2044))
* **openclaw:** record turn advancements as one marker file per key
([#4212](#4212))
([24acbe8](24acbe8))
* **opencode:** only route POST requests to LLM endpoint paths
([#4464](#4464))
([336d462](336d462))
* **opencode:** route Copilot Claude models through the proxy
([#4594](#4594))
([3d9a6f2](3d9a6f2))
* **output-savings:** rewrite a pre-rule ledger once instead of warning
on every /stats poll
([#4196](#4196))
([96e81ac](96e81ac))
* **packaging:** rename the sandbox extra to lean and correct
SECURITY.md claims
([#3727](#3727))
([09b7e8c](09b7e8c))
* **packaging:** use direct CLI module entry point
([#2665](#2665))
([2892214](2892214))
* **pipeline:** store the pipeline input in CCR behind offload markers
([#4576](#4576))
([4d7765c](4d7765c))
* **pricing:** add Claude Haiku 5.5 rates, 1M context and its 100K
long-prompt card
([#4037](#4037))
([703755e](703755e))
* **privacy:** turn off Mem0's PostHog telemetry by default
([#4619](#4619))
([fe69f38](fe69f38))
* **providers:** isolate resolved Anthropic context limits
([#4593](#4593))
([51258ef](51258ef))
* **proxy/memory:** harden _extract_tool_calls against malformed choices
and blocks
([#2483](#2483))
([effa5a5](effa5a5))
* **proxy:** allow loopback-published container hosts to access
/debug/memory
([#4259](#4259))
([e546e71](e546e71))
* **proxy:** answer /api/hello probes behind the token gate, log
rejection context
([#4150](#4150))
([673831a](673831a))
* **proxy:** cap cache_control breakpoints on OpenAI chat path
([#4471](#4471))
([#4491](#4491))
([55602fc](55602fc))
* **proxy:** do not book Gemini countTokens as a request outcome
([#4412](#4412))
([4d2dd62](4d2dd62))
* **proxy:** don't fail startup when libc_ver() can't read the
interpreter
([#4519](#4519))
([28172a9](28172a9))
* **proxy:** forward Copilot accounting headers on streaming path
([#4431](#4431))
([66023a0](66023a0))
* **proxy:** handle ClientDisconnect in anthropic_messages
([#3532](#3532))
([251d149](251d149))
* **proxy:** honor x-headroom-base-url on provider passthrough routes
([#4596](#4596))
([5c8772b](5c8772b))
* **proxy:** install SOCKS support for websocket proxies
([#3357](#3357))
([79181ca](79181ca))
* **proxy:** keep Gemini memory context on entries with non-text parts
([#4506](#4506))
([35a2b76](35a2b76))
* **proxy:** keep health probes and the Codex attestation out of the
proxy log
([#4611](#4611))
([78736a1](78736a1))
* **proxy:** keep read maturation out of the provider-confirmed prefix
([#4522](#4522))
([526e06b](526e06b))
* **proxy:** keep tool deferral on Copilot
Business/Enterprise/Individual hosts
([#4608](#4608))
([be456d4](be456d4))
* **proxy:** log unknown model ids as one bounded token; skip
unparseable PERF lines
([#4374](#4374))
([c014bd6](c014bd6))
* **proxy:** preserve response cache keys across in-place hooks
([#4457](#4457))
([03590cd](03590cd))
* **proxy:** recognise every local spelling of the proxy in the
cc-switch loop guard
([#4405](#4405))
([d9958bf](d9958bf))
* **proxy:** reconcile Chat content-block cache markers after prefix
replay
([#4333](#4333))
([35ca9b8](35ca9b8))
* **proxy:** route /v1/models to the x-headroom-base-url upstream
([#4308](#4308))
([6ef52c2](6ef52c2))
* **proxy:** skip memory-context search in cache mode on OpenAI routes
([#4632](#4632))
([365f6fe](365f6fe))
* **proxy:** skip memory-context search on OpenAI paths in cache mode
([#4634](#4634))
([3654037](3654037))
* **proxy:** skip the memory-context search in cache mode
([#4606](#4606))
([053925b](053925b))
* **proxy:** strip only one leading space from SSE field values
([#4306](#4306))
([9226eaf](9226eaf))
* **proxy:** strip upstream transport framing headers from Gemini
response replays
([#4605](#4605))
([dfcac78](dfcac78))
* **read-lifecycle:** keep Reads fresh after a failed Edit or Write
([#4461](#4461))
([4c3799f](4c3799f))
* **relevance:** cap embedding batch size so ORT's arena stays small
([#4507](#4507))
([a2d4fe7](a2d4fe7))
* **relevance:** hand the embedding arena back after each run on macOS
([#4567](#4567))
([2363f83](2363f83))
* **relevance:** load the Rust default embedder from Python's pinned
snapshot
([#4190](#4190))
([9bb4b13](9bb4b13))
* **router:** keep small shell results verbatim
([#3590](#3590))
([#4426](#4426))
([4ee6164](4ee6164))
* **router:** preserve read protection for quiet sed options
([#4521](#4521))
([312ffec](312ffec))
* **router:** validate lossless provider output on the excluded-tool
path ([#4486](#4486))
([9f068a6](9f068a6))
* **scripts:** resolve hooks dir via git so install-git-hooks works in
linked worktrees
([#4176](#4176))
([0f4275f](0f4275f))
* **sdk:** carry Vercel AI SDK reasoning parts and provider options
through compression
([#4564](#4564))
([a26faae](a26faae))
* **sdk:** send Anthropic messages to /v1/compress natively so thinking
blocks survive
([#4489](#4489))
([cd5e2b9](cd5e2b9))
* **security:** lstat before narrowing sqlite files
([#4527](#4527))
([2cf64ef](2cf64ef))
* **smart-crusher:** preserve unchanged JSON bytes
([#4044](#4044))
([93279f3](93279f3))
* **tabular:** keep empty records and separator-like Markdown body rows
([#4582](#4582))
([5cebb90](5cebb90))
* **tabular:** keep interior blank CSV rows instead of dropping them
([#4563](#4563))
([8c360ca](8c360ca))
* **thinking:** isolate compaction memo by compressor instance
([#4569](#4569))
([5dcb1e4](5dcb1e4))
* **thinking:** leave a thinking block with a null or non-string value
unchanged
([#4562](#4562))
([cc1eb54](cc1eb54))
* **toin:** preserve stores that exceed the byte limit
([#4589](#4589))
([f9cae66](f9cae66))
* **toin:** retain pending changes after filesystem save failures
([#4568](#4568))
([8b15a15](8b15a15))
* **toin:** skip a malformed pattern instead of aborting the store load
([#4484](#4484))
([8b628d9](8b628d9))
* **tokenizers:** coerce structured text values in message token
counters
([#4472](#4472))
([6cc27a4](6cc27a4))
* **tokenizers:** don't cache token-count inputs larger than max_chars
([#4469](#4469))
([aebb729](aebb729))
* **tokenizers:** price Anthropic document blocks by page count, not as
([fc1ba89](fc1ba89))
* **tokenizers:** price Anthropic document blocks by page count, not as
base64 text
([#4441](#4441))
([fc1ba89](fc1ba89))
* **tokenizers:** resolve tiktoken encoding for gateway-prefixed model
ids ([#4637](#4637))
([e9331b6](e9331b6))
* **transforms:** enforce role, mutable, and cache zone guards in batch
compression
([#4480](#4480))
([#4494](#4494))
([40cd7e7](40cd7e7))
* **transforms:** honour Subscription toin_read_only when the router
calls SmartCrusher
([#4493](#4493))
([7c11d46](7c11d46))
* **transforms:** preserve YAML block scalar data during comment elision
([#4498](#4498))
([534cec0](534cec0))
* **transforms:** recognise code fences whose info string is not a bare
word ([#4291](#4291))
([a8df6f9](a8df6f9))
* **transforms:** stop an embedded markdown table from dropping the rest
of a tool result
([#4216](#4216))
([b66c9c7](b66c9c7))
* **transforms:** tolerate malformed assistant tool calls in
ContentRouter.apply
([#4459](#4459))
([cddd2fd](cddd2fd))
* **update-check:** skip releases with no files and do not fall back to
an uninstallable version
([#4560](#4560))
([c1dae5a](c1dae5a))
* use all user text blocks for relevance scoring
([#4628](#4628))
([12dca26](12dca26))
* **wrap:** overwrite drifted selfheal hook command instead of skipping
it ([#2723](#2723))
([2643f34](2643f34))
* **wrap:** route OMP OpenAI providers through Headroom
([#2755](#2755))
([fae1e84](fae1e84))


### Dependencies

* Bump @anthropic-ai/sdk from 0.133.0 to 1.3.0 in /sdk/typescript
([#4554](#4554))
([74277d4](74277d4))
* Bump lru from 0.18.5 to 0.19.0
([#4382](#4382))
([038af59](038af59))
* bump ruff from 0.17.0 to 0.17.2 in the pip-minor-patch group across 1
directory
([#4380](#4380))
([64f43bd](64f43bd))
* bump ruff from 0.17.2 to 0.17.3 in the pip-minor-patch group
([#4652](#4652))
([cb9602a](cb9602a))
* Bump the cargo-minor-patch group across 1 directory with 12 updates
([#4553](#4553))
([b9049d7](b9049d7))
* Bump the npm-minor-patch group across 1 directory with 6 updates
([#4621](#4621))
([5e4827d](5e4827d))
* Bump the npm-minor-patch group across 2 directories with 14 updates
([#4455](#4455))
([f10725e](f10725e))
* Bump the npm-minor-patch group across 3 directories with 9 updates
([#4495](#4495))
([f367728](f367728))
* Bump tsup from 8.5.1 to 9.0.0 in /plugins/openclaw
([#4384](#4384))
([9d87151](9d87151))
* Bump tsup from 8.5.1 to 9.0.0 in /plugins/opencode
([#4385](#4385))
([99e223c](99e223c))
* Bump tsup from 8.5.1 to 9.0.0 in /sdk/typescript
([#4386](#4386))
([e666fd8](e666fd8))
* qualify latest Anthropic SDK 1.4.0 in docs
([#4556](#4556))
([65bcc4c](65bcc4c))
* qualify latest compatible docs and E2E tools
([#4580](#4580))
([e42f74e](e42f74e))
* require Python 3.11; clear Dependabot alerts in the 3.10 lock fork
([#4517](#4517))
([3c6f82b](3c6f82b))
* update tomlkit requirement from &lt;1.0,&gt;=0.15.0 to
&gt;=0.15.2,&lt;1.0
([#4653](#4653))
([00d5a5c](00d5a5c))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

### Maintainer current-main requalification

Exact head `0dea0c5acf5a9b00efff4eb4aa5cb4bf44d5d4fe`, upstream main
`ecbaf86d78cf52d185fbffa306157b9a4cc1b906`.

Re-reviewed generated release metadata against current main
ecbaf86. The bot-generated release
commit had restored Ruff 0.17.2 while current main, uv.lock and
pre-commit use 0.17.3. Both verify-ruff-version and offline lock checks
reproduced this mechanical mismatch; restored only the current-main
development-tool pin. No release version, contributor runtime logic or
dependency lock versions changed.

All 88 focused release workflow/version/MCP descriptor/Gemini tests
pass. verify-versions reports tracked release metadata aligned at
0.43.0. After the pin correction, verify-ruff-version, uv lock --check
--offline and whitespace checks pass. Generated CHANGELOG was reviewed
without manual edits. Earlier Devin version-metadata finding is
addressed. Formal approval awaits exact-head hosted qualification;
maintainers handle CI. Nothing merged or published as a release.


Exact-head hosted checks are being handled by maintainers. No new
finding in the reviewed scope; formal approval awaits exact-head hosted
qualification; nothing merged.


Current release-bot head 2a1ebf7 has
the identical tree to the locally verified Ruff correction (including
preserved manifest line endings). Exact-head hosted qualification is in
progress; no release published or PR merged.

---------

Co-authored-by: headroom-release[bot] <352661243+headroom-release[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <[email protected]>
mosatch added a commit to mosatch/headroom that referenced this pull request Nov 7, 2026
- fix(deps): patch OpenClaw Undici and narrow E2E audit exceptions (headroomlabs-ai#4453)
- feat(ccr): Redis backend, one CCR store for every replica (headroomlabs-ai#4368)
- fix(cache): bound the router's compression cache, keep the rest in SQLite (headroomlabs-ai#4357)
- feat(compress): share /v1/compress sessions across replicas via Redis (headroomlabs-ai#4369)
- fix(proxy): keep in-period costs in the budget ledger when the entry cap is reached (headroomlabs-ai#4448)
- fix(proxy): import Response at runtime in the Bedrock handler (headroomlabs-ai#4397)
- fix(tabular): pass tables with repeated header names through verbatim (headroomlabs-ai#4278)
- fix(smart-crusher): match audit-safe protected_patterns against unescaped text (headroomlabs-ai#4294)
- fix(copilot): detect COPILOT_API_URL in cli-main.js for Copilot CLI >= 1.0.93 (headroomlabs-ai#4450)
- fix(proxy): do not rebuild a failed turn-hook re-drive as HTTP 200 (headroomlabs-ai#4398)
- fix(transforms): keep the fences of a code block passed through for a protected tag (headroomlabs-ai#4292)
- fix(cache): keep indented lines intact in OpenAI whitespace normalization (headroomlabs-ai#4343)
- fix(gemini): keep snake_case inline_data and function parts when compressing (headroomlabs-ai#4290)
- fix(proxy): record outcome when a passthrough stream ends mid-character (headroomlabs-ai#4429)
- fix(image): flatten transparent images onto white before re-encoding as JPEG (headroomlabs-ai#4296)
- fix(proxy): honor bypass header and license gate in Anthropic batch create (headroomlabs-ai#4411)
- fix(install): keep the HuggingFace cache on a writable mount in Docker presets (headroomlabs-ai#4207) (headroomlabs-ai#4209)
- fix(opencode): do not rewrite an OpenCode config that fails to parse (headroomlabs-ai#4424)
- fix(openai): recompress cached Responses units whose CCR entries expired (headroomlabs-ai#4146)
- fix(kompress): never drop words the model did not see (headroomlabs-ai#4175)
- fix(proxy): bound per-model state keyed by the client model string (headroomlabs-ai#4407)
- fix(copilot): preserve native inline OAuth identity (headroomlabs-ai#4144)
- fix(proxy): drop web_search_call history from a Responses request with no web_search tool (headroomlabs-ai#4202)
- fix(security): restrict the Windows runtime log via NTFS ACL, not just warn (headroomlabs-ai#4135)
- fix(sdk): preserve Vercel AI SDK file and image parts through compression (headroomlabs-ai#4048)
- fix(ci): pin checkout in release notification smoke workflow (headroomlabs-ai#4399)
- docs(troubleshooting): explain the frozen ghcr.io/chopratejas/headroom image (headroomlabs-ai#4069)
- fix(proxy): count output tokens from CRLF-framed SSE streams too (headroomlabs-ai#4298)
- fix(telemetry): give empty-item compressions a stable tool signature (headroomlabs-ai#4396)
- fix(proxy): keep tool deferral for GitHub Copilot upstream (headroomlabs-ai#4356)
- fix(savings): key a Responses conversation on its thread, not the shared session (headroomlabs-ai#4440)
- fix(storage): normalize timezone-aware JSONL time filters (headroomlabs-ai#4063)
- fix(gateway): keep input_includes_cache when re-drive usage is merged (headroomlabs-ai#4423)
- fix(proxy): copy cached tool compaction results (hardening) (headroomlabs-ai#4410)
- fix(image): clear last_result before each compress() call (headroomlabs-ai#4341)
- fix(memory): resolve partial IDs beyond the first 1000 records (headroomlabs-ai#4389)
- fix(memory): ignore incidental cwd prose (headroomlabs-ai#4166)
- fix(mcp): accept the JSONC opencode config that wrap and install already accept (headroomlabs-ai#4297)
- fix(proxy): accept HEADROOM_MEMORY_INJECTION_MODE=tool (headroomlabs-ai#4395)
- fix(memory): treat a cwd with no UTF-8 form as unresolved instead of raising (headroomlabs-ai#4167)
- fix(opencode): restore process env keys on transport dispose (headroomlabs-ai#4430)
- docs: drop effort-routing text that headroomlabs-ai#3377 removed (headroomlabs-ai#4449)
- fix(transforms): pass HeadroomConfig.smart_crusher to the default pipeline's router (headroomlabs-ai#4243)
- fix(proxy): skip memory tool injection on streamed OpenAI requests (headroomlabs-ai#4451)
- fix(learn): anchor the managed block on its last start marker, append when no end marker (headroomlabs-ai#4342)
- fix(proxy): keep negative compression savings across restart (headroomlabs-ai#4406)
- fix(ccr): recognize client-owned MCP retrieval aliases (headroomlabs-ai#4165)
- fix(logs): count omitted levels from dropped lines (headroomlabs-ai#4141)
- fix(zcode): skip providers that point at the Headroom proxy itself (headroomlabs-ai#4413)
- fix(memory): bound retrieval queries before embedding (headroomlabs-ai#4244)
- fix(offline): keep litellm's pricing table local under HEADROOM_OFFLINE (headroomlabs-ai#4242)
- feat(proxy): report the same tool savings on gateway /v1/compress as the proxy path (headroomlabs-ai#4467)
- chore: release 0.42.0 (headroomlabs-ai#4228)
- deps: Bump the npm-minor-patch group across 3 directories with 9 updates (headroomlabs-ai#4495)
- deps: Bump the npm-minor-patch group across 2 directories with 14 updates (headroomlabs-ai#4455)
- deps: require Python 3.11; clear Dependabot alerts in the 3.10 lock fork (headroomlabs-ai#4517)
- docs(teams): replace the 3-months-free perk with a talk-to-us pitch (headroomlabs-ai#4524)
- fix(docker): install the redis extra in every image (headroomlabs-ai#4514)
- fix(packaging): rename the sandbox extra to lean and correct SECURITY.md claims (headroomlabs-ai#3727)
- fix(openclaw/release): ship responsive npm integrations (headroomlabs-ai#1458)
- fix(memory): fail close unresolved project operations (headroomlabs-ai#2637)
- fix(proxy): install SOCKS support for websocket proxies (headroomlabs-ai#3357)
- fix(pricing): add Claude Haiku 5.5 rates, 1M context and its 100K long-prompt card (headroomlabs-ai#4037)
- fix(proxy): keep deferred tool loads out of the prefix-tracker lineage key (headroomlabs-ai#4204)
- fix(transforms): stop an embedded markdown table from dropping the rest of a tool result (headroomlabs-ai#4216)
- fix(client): store metrics at HeadroomConfig.store_url (headroomlabs-ai#4270)
- fix(install): write persistent shell env values verbatim (headroomlabs-ai#4289)
- fix: do not report a seeded stored setting as an env override (headroomlabs-ai#4326)
- fix(cache): invalidate configured registry instances on replacement (headroomlabs-ai#4363)
- fix(cache): validate malformed learned TTL values (headroomlabs-ai#4364)
- fix(memory): bound history traversal on cyclic supersession links (headroomlabs-ai#4366)
- fix(memory): skip the edit-distance retry check on long commands (headroomlabs-ai#4371)
- fix(memory): match compound and null SQLite metadata filters (headroomlabs-ai#4373)
- fix(proxy): log unknown model ids as one bounded token; skip unparseable PERF lines (headroomlabs-ai#4374)
- fix(memory): preserve relationships when updating graph entities (headroomlabs-ai#4379)
- chore(sdk-typescript): npm metadata and the proxy requirement up front (headroomlabs-ai#4536)
- fix(proxy): recognise every local spelling of the proxy in the cc-switch loop guard (headroomlabs-ai#4405)
- fix(proxy): do not book Gemini countTokens as a request outcome (headroomlabs-ai#4412)
- fix(router): keep small shell results verbatim (headroomlabs-ai#3590) (headroomlabs-ai#4426)
- fix(codex): accept multi-line inline tables in Codex config.toml (headroomlabs-ai#4436)
- fix(proxy): preserve response cache keys across in-place hooks (headroomlabs-ai#4457)
- fix(transforms): tolerate malformed assistant tool calls in ContentRouter.apply (headroomlabs-ai#4459)
- fix(read-lifecycle): keep Reads fresh after a failed Edit or Write (headroomlabs-ai#4461)
- fix(mixed-content): do not carve ISO-timestamped log rows as search results (headroomlabs-ai#4463)
- fix(install): tolerate absent Windows tasks in stop_supervisor (headroomlabs-ai#4465) (headroomlabs-ai#4468)
- fix(tokenizers): don't cache token-count inputs larger than max_chars (headroomlabs-ai#4469)
- fix(compaction): reject negative dictionary indices and non-array legends in expand_compacted (headroomlabs-ai#4470)
- fix(tokenizers): coerce structured text values in message token counters (headroomlabs-ai#4472)
- docs: clarify Target savings metric is % of new input tokens (headroomlabs-ai#4485)
- fix(toin): skip a malformed pattern instead of aborting the store load (headroomlabs-ai#4484)
- fix(client): close upstream responses when wrapped streams are closed (headroomlabs-ai#4482)
- fix(cache): namespace SemanticCacheLayer by provider, model and metadata (headroomlabs-ai#4473)
- fix(router): validate lossless provider output on the excluded-tool path (headroomlabs-ai#4486)
- fix(dedup): bound line-number digit run and never fold into a longer pointer (headroomlabs-ai#4488)
- fix(sdk): send Anthropic messages to /v1/compress natively so thinking blocks survive (headroomlabs-ai#4489)
- fix(doctor): detect root openai_base_url Codex routing and agent-configured proxy ports (headroomlabs-ai#4490)
- fix(proxy): cap cache_control breakpoints on OpenAI chat path (headroomlabs-ai#4471) (headroomlabs-ai#4491)
- fix(cache): count a tool_result with no text as replayable in the frozen prefix (headroomlabs-ai#4523)
- fix(proxy): keep read maturation out of the provider-confirmed prefix (headroomlabs-ai#4522)
- fix(relevance): cap embedding batch size so ORT's arena stays small (headroomlabs-ai#4507)
- fix(transforms): honour Subscription toin_read_only when the router calls SmartCrusher (headroomlabs-ai#4493)
- fix(transforms): enforce role, mutable, and cache zone guards in batch compression (headroomlabs-ai#4480) (headroomlabs-ai#4494)
- fix(transforms): preserve YAML block scalar data during comment elision (headroomlabs-ai#4498)
- fix(memory): compare SQLite timestamps as UTC instants (headroomlabs-ai#4499)
- fix(client): preserve Anthropic create stream flags (headroomlabs-ai#4500)
- fix(client): honor configured cache optimizer enablement (headroomlabs-ai#4501)
- fix(proxy): don't fail startup when libc_ver() can't read the interpreter (headroomlabs-ai#4519)
- fix(security): lstat before narrowing sqlite files (headroomlabs-ai#4527)
- docs(site): Python-first quickstart and a FastAPI page built on compress() (headroomlabs-ai#4529)
- fix(cache): preserve OpenAI tool block metadata on cached replay (headroomlabs-ai#4334)
- fix(evals): reject changed numeric probe values (headroomlabs-ai#4502)
- fix(tokenizers): price Anthropic document blocks by page count, not as base64 text (headroomlabs-ai#4441)
- fix(deps): clear the glob and minimatch npm audit findings (headroomlabs-ai#4599)
- test(proxy): make compression timeout regression deterministic (headroomlabs-ai#4587)
- deps: bump ruff from 0.17.0 to 0.17.2 in the pip-minor-patch group across 1 directory (headroomlabs-ai#4380)
- ci: Bump actions/setup-python from 6 to 7 (headroomlabs-ai#4558)
- fix(mcp): confine headroom_read to the workspace (GHSA-8g49-pg6g-xgrf) (headroomlabs-ai#4525)
- ci: Bump the actions-minor-patch group with 2 updates (headroomlabs-ai#4557)
- deps: Bump the npm-minor-patch group across 1 directory with 6 updates (headroomlabs-ai#4621)
- chore(deps): bump the uv group across 1 directory with 2 updates (headroomlabs-ai#4537)
- deps: Bump @anthropic-ai/sdk from 0.133.0 to 1.3.0 in /sdk/typescript (headroomlabs-ai#4554)
- fix(proxy): keep tool deferral on Copilot Business/Enterprise/Individual hosts (headroomlabs-ai#4608)
- fix(deps): bump mem0ai, langgraph and langgraph-sdk past open advisories (headroomlabs-ai#4614)
- deps: Bump the cargo-minor-patch group across 1 directory with 12 updates (headroomlabs-ai#4553)
- deps: Bump tsup from 8.5.1 to 9.0.0 in /sdk/typescript (headroomlabs-ai#4386)
- deps: Bump tsup from 8.5.1 to 9.0.0 in /plugins/opencode (headroomlabs-ai#4385)
- deps: Bump lru from 0.18.5 to 0.19.0 (headroomlabs-ai#4382)
- fix(cli): document that code-aware compression is enabled by default (headroomlabs-ai#4616)
- fix(proxy): keep health probes and the Codex attestation out of the proxy log (headroomlabs-ai#4611)
- fix(privacy): turn off ONNX Runtime's Microsoft telemetry by default (headroomlabs-ai#4602)
- test(deps): fail when a composite extra's uv.lock list drops a nested extra's package (headroomlabs-ai#4598)
- deps: qualify latest Anthropic SDK 1.4.0 in docs (headroomlabs-ai#4556)
- fix(router): preserve read protection for quiet sed options (headroomlabs-ai#4521)
- fix(wrap): overwrite drifted selfheal hook command instead of skipping it (headroomlabs-ai#2723)
- fix(langgraph): replace the compressed ToolMessage in graph state (headroomlabs-ai#4620)
- test(wrap): isolate two auth-precedence tests from the caller's ANTHROPIC_* env (headroomlabs-ai#4601)
- fix(privacy): turn off Mem0's PostHog telemetry by default (headroomlabs-ai#4619)
- fix(relevance): hand the embedding arena back after each run on macOS (headroomlabs-ai#4567)
- fix(codec): reject densified blocks with mismatched row counts (headroomlabs-ai#4271)
- fix(proxy): skip the memory-context search in cache mode (headroomlabs-ai#4606)
- fix(pipeline): store the pipeline input in CCR behind offload markers (headroomlabs-ai#4576)
- fix(backends/litellm): keep cache_control on text blocks for Bedrock prompt caching (headroomlabs-ai#4565)
- fix(relevance): load the Rust default embedder from Python's pinned snapshot (headroomlabs-ai#4190)
- fix(smart-crusher): preserve unchanged JSON bytes (headroomlabs-ai#4044)
- fix(scripts): resolve hooks dir via git so install-git-hooks works in linked worktrees (headroomlabs-ai#4176)
- fix(proxy/memory): harden _extract_tool_calls against malformed choices and blocks (headroomlabs-ai#2483)
- fix: Add info about apply to README.md (headroomlabs-ai#1592)
- Fix(proxy) vertex model override propagation (headroomlabs-ai#2367)
- fix(backends): forward the standard service_tier param (litellm + anyllm) (headroomlabs-ai#2468)
- fix(wrap): route OMP OpenAI providers through Headroom (headroomlabs-ai#2755)
- fix(proxy): warm deferred kompress model so /health stops reporting backend=null (headroomlabs-ai#2799)
- ci: run eval smoke test on Rust compressor changes (headroomlabs-ai#2948)
- fix(proxy): handle ClientDisconnect in anthropic_messages (headroomlabs-ai#3532)
- fix(output-savings): rewrite a pre-rule ledger once instead of warning on every /stats poll (headroomlabs-ai#4196)
- fix(openclaw): record turn advancements as one marker file per key (headroomlabs-ai#4212)
- fix(ccr): keep proactive expansion out of the cached prefix (headroomlabs-ai#4300)
- fix(proxy): route /v1/models to the x-headroom-base-url upstream (headroomlabs-ai#4308)
- fix(docker): pass RUNTIME_HOME=/root for root bake targets (headroomlabs-ai#4445)
- docs: fix generate_report example arguments (headroomlabs-ai#4435)
- fix(proxy): forward Copilot accounting headers on streaming path (headroomlabs-ai#4431)
- fix(memory): bound verb-pattern word runs to stop quadratic backtracking in bridge import (headroomlabs-ai#4370) (headroomlabs-ai#4376)
- fix(cache): fail closed on SQLite corruption instead of deleting the store online (headroomlabs-ai#4361)
- fix(proxy): reconcile Chat content-block cache markers after prefix replay (headroomlabs-ai#4333)
- fix(diff): keep combined-diff changes made against a later parent (headroomlabs-ai#4318)
- fix(opencode): only route POST requests to LLM endpoint paths (headroomlabs-ai#4464)
- fix: [BUG] A timeout in one image compression call resets the shared worker pool and affects concurrent requests (headroomlabs-ai#4528)
- docs(readme): lead with two front doors and one measured savings claim (headroomlabs-ai#4530)
- docs(llms): add a by-task section and state the measured savings claim once (headroomlabs-ai#4531)
- docs: add AGENTS.md for agents using Headroom and agents changing the repo (headroomlabs-ai#4532)
- docs(pypi): job-word summary and keywords, and a PyPI-specific README (headroomlabs-ai#4534)
- deps: qualify latest compatible docs and E2E tools (headroomlabs-ai#4580)
- fix(proxy): preserve retrieval outputs across Codex WS deltas (headroomlabs-ai#4574)
- fix(sdk): carry Vercel AI SDK reasoning parts and provider options through compression (headroomlabs-ai#4564)
- feat(savings): show the proxy's model-routing savings in headroom savings (headroomlabs-ai#4304)
- feat(plugins): headroom skill for Claude Code, Codex, Copilot and skills.sh (headroomlabs-ai#4533)
- fix(providers): isolate resolved Anthropic context limits (headroomlabs-ai#4593)
- fix(proxy): honor x-headroom-base-url on provider passthrough routes (headroomlabs-ai#4596)
- fix(packaging): use direct CLI module entry point (headroomlabs-ai#2665)
- test(onnx): fix magika idle-thread test on macOS with ORT 1.31 (headroomlabs-ai#4194)
- fix(memory): dispatch core text search to the async FTS5 adapter (headroomlabs-ai#4365)
- fix: [BUG] DirectMem0Adapter.search_memories calls removed mem0 search API (headroomlabs-ai#4518)
- fix(toin): retain pending changes after filesystem save failures (headroomlabs-ai#4568)
- fix(thinking): isolate compaction memo by compressor instance (headroomlabs-ai#4569)
- fix(cache): build semantic entry before evicting so a failed embedding keeps live entries (headroomlabs-ai#4581)
- fix(tabular): keep empty records and separator-like Markdown body rows (headroomlabs-ai#4582)
- fix(code): preserve syntax in CCR retrieval comments (headroomlabs-ai#4583)
- fix: [BUG] Saved request metrics lose their cache optimization fields (headroomlabs-ai#4584)
- fix(proxy): preserve Cline headroom__headroom_retrieve results from recompression (headroomlabs-ai#4586)
- fix(cache): scope router results to request compression policy (headroomlabs-ai#4590)
- fix(proxy): keep mid-conversation system sections for third-party models (headroomlabs-ai#4591)
- feat(mcp)!: port MCP servers to SDK 2.x (headroomlabs-ai#4603)
- fix(proxy): strip upstream transport framing headers from Gemini response replays (headroomlabs-ai#4605)
- fix(code): keep multi-line class headers' opening brace (headroomlabs-ai#4623)
- fix(code): keep Rust attributes attached to their items (headroomlabs-ai#4624)
- docs: add Kong AI Gateway integration page (headroomlabs-ai#4625)
- fix: use all user text blocks for relevance scoring (headroomlabs-ai#4628)
- fix: [BUG] Volatile SQLite metrics stores lose their schema before the first save (headroomlabs-ai#4633)
- fix(kompress): read the pinned snapshot from Python's one HF cache in the native proxy (headroomlabs-ai#4438)
- test(tokenizer): hold the env lock in the invalid-repo Hub error test (headroomlabs-ai#4151)
- fix(proxy): skip memory-context search in cache mode on OpenAI routes (headroomlabs-ai#4632)
- fix(proxy): skip memory-context search on OpenAI paths in cache mode (headroomlabs-ai#4634)
- feat(ccr): answer headroom_retrieve on streaming chat completions (headroomlabs-ai#4631)
- fix(openclaw): read the retrieve hash from params, not the tool-call id (headroomlabs-ai#4641)
- fix(proxy): bypass compression for large admitted histories (headroomlabs-ai#4142)
- fix(tokenizers): resolve tiktoken encoding for gateway-prefixed model ids (headroomlabs-ai#4637)
- fix(proxy): answer /api/hello probes behind the token gate, log rejection context (headroomlabs-ai#4150)
- fix(memory): keep learned evidence until persistence succeeds (headroomlabs-ai#4229)
- fix(proxy): allow loopback-published container hosts to access /debug/memory (headroomlabs-ai#4259)
- fix(code): keep semicolon-separated statements valid (headroomlabs-ai#4630)
- fix(config): use the longest matching model_context_limits prefix (headroomlabs-ai#4288)
- fix(transforms): recognise code fences whose info string is not a bare word (headroomlabs-ai#4291)
- fix(transforms): stop the dense-line elider cutting Chinese, Japanese and Thai prose (headroomlabs-ai#4295)
- fix(cache): reject nonpositive semantic cache capacities (headroomlabs-ai#4301)
- fix(proxy): strip only one leading space from SSE field values (headroomlabs-ai#4306)
- fix(tokenizers): honor registered model factories (headroomlabs-ai#4437)
- fix(memory): preserve parent scopes when clearing memories (headroomlabs-ai#4305)
- deps: Bump tsup from 8.5.1 to 9.0.0 in /plugins/openclaw (headroomlabs-ai#4384)
- fix(diff): renumber hunk headers after trimming context (headroomlabs-ai#4319)
- fix(kompress): keep words past the tokenizer's truncation point (headroomlabs-ai#4328)
- fix(tabular): keep tables whose columns share a name (headroomlabs-ai#4329)
- fix(proxy): let model discovery honor the custom base URL (headroomlabs-ai#4330)
- fix(offline): guard the learn and memory-eval LLM calls under HEADROOM_OFFLINE (headroomlabs-ai#4344)
- fix(proxy): keep Gemini memory context on entries with non-text parts (headroomlabs-ai#4506)
- docs(security): sync security model with egress pollers, counts and beacon payload (headroomlabs-ai#4539)
- fix(proxy): say a forwarded streaming error came from the provider (headroomlabs-ai#4629)
- fix(install): stabilize Windows task lifecycle and eliminate console window popup (headroomlabs-ai#4627)
- fix(ccr): buffer a stream only for a marker new this turn (headroomlabs-ai#4607)
- fix(toin): preserve stores that exceed the byte limit (headroomlabs-ai#4589)
- fix(opencode): route Copilot Claude models through the proxy (headroomlabs-ai#4594)
- fix(thinking): leave a thinking block with a null or non-string value unchanged (headroomlabs-ai#4562)
- fix(tabular): keep interior blank CSV rows instead of dropping them (headroomlabs-ai#4563)
- fix(update-check): skip releases with no files and do not fall back to an uninstallable version (headroomlabs-ai#4560)
- fix(core): case-insensitive Bearer scheme, clamp SQLite CCR TTLs, redact the Redis URL in logs (headroomlabs-ai#4561)
- fix(kompress): run the CPU and ONNX Runtime loader guards before building a session (headroomlabs-ai#4559)
- fix(router): gate block-form tool output against cached lossy results (headroomlabs-ai#4504)
- ci: bump astral-sh/setup-uv from 10.3.2 to 10.3.3 in the actions-minor-patch group (headroomlabs-ai#4659)
- deps: update tomlkit requirement from <1.0,>=0.15.0 to >=0.15.2,<1.0 (headroomlabs-ai#4653)
- deps: bump ruff from 0.17.2 to 0.17.3 in the pip-minor-patch group (headroomlabs-ai#4652)
- docs(security): describe the per-route outcome of an unsafe base-URL override (headroomlabs-ai#4660)
- chore: release 0.43.0 (headroomlabs-ai#4643)
- fix(router): log the ONNX fallbacks at info instead of warning (headroomlabs-ai#4535)
- fix: keep parent predicates when clearing a narrower memory scope (headroomlabs-ai#4327)
- fix(proxy): preserve Unicode separators in SSE JSON (headroomlabs-ai#4337)
- fix(proxy): bound the model-keyed tokenizer, beacon and litellm caches (headroomlabs-ai#4497)
- fix(router): keep tagged blocks out of the lossy size-gate fallback (headroomlabs-ai#4543)
- fix(ccr): keep the in-memory order queue from evicting re-stored entries (headroomlabs-ai#4545)
- fix(ort): avoid implicit runtime discovery from the workspace (headroomlabs-ai#4570)
- fix(ccr): only refuse a bare marker, not originals that start and end with markers (headroomlabs-ai#4626)
- fix(proxy): use HTTP/1.1 client for ChatGPT streaming and model metadata (headroomlabs-ai#4006)
- test(gemini): serve the memory-tail tests' body through request.stream() (headroomlabs-ai#4645)
- fix(kompress): load ONNX Runtime through the dynamic loader guard before building a session (headroomlabs-ai#4644)
- fix(openclaw): accept 12-character hashes in headroom_retrieve (headroomlabs-ai#4640)
- deps: bump the npm-minor-patch group across 3 directories with 6 updates (headroomlabs-ai#4662)
- fix(release): normalize damaged release PR envelopes before detection (headroomlabs-ai#4664)
- fix(memory): replace the HNSW vector when a memory is re-indexed (headroomlabs-ai#4649)
- fix(memory): read the relation key the memory_save schema advertises (headroomlabs-ai#4647)
- chore: release 0.43.1 (headroomlabs-ai#4661)
- fix(proxy): keep cold-turn reasoning drops sticky so the next warm turn reuses the cached prefix (headroomlabs-ai#4592)
- fix(tabular): split fixed-width rows on column boundaries, not on double spaces (headroomlabs-ai#4541)
- fix(learn): support opencode v2 session schema in learn scanner (headroomlabs-ai#4199)
- fix(proxy): rename leaked_threads metric to timed_out_workers_total (headroomlabs-ai#3908)
- fix(content-router): trust confident HTML detection over mixed-content heuristics (headroomlabs-ai#3627)
- deps: bump the npm-minor-patch group across 1 directory with 2 updates (headroomlabs-ai#4650)
- deps: update tree-sitter requirement from <0.27,>=0.25.2 to >=0.26.0,<0.27 (headroomlabs-ai#4656)
- fix(proxy): add --no-ccr-response-handling flag to bypass response buffering (headroomlabs-ai#3082) (headroomlabs-ai#3100)
- fix(install): make install status agree with doctor when the proxy is reachable (headroomlabs-ai#3072) (headroomlabs-ai#3141)
- fix(cli): resolve active proxy port for read commands (headroomlabs-ai#3522)
- feat(providers): add Hermes agent wrap support (headroomlabs-ai#934)
- deps: update click requirement from >=8.3.3 to >=8.5.0 (headroomlabs-ai#4655)
- deps: update sqlite-vec requirement from >=0.1.6 to >=0.1.9 (headroomlabs-ai#4654)
- deps: bump rusqlite from 0.40.2 to 0.41.1 (headroomlabs-ai#4658)
- deps: bump the cargo-minor-patch group with 3 updates (headroomlabs-ai#4657)
- fix(kompress): prevent loading model when enable_kompress is False (headroomlabs-ai#4667)
- fix(kompress): let the next window decide the words past the token cut (headroomlabs-ai#4669)
- fix(sdk): keep Vercel AI SDK tool-result output kinds through compression (headroomlabs-ai#4670)
- ci: pin every GitHub Action to a commit SHA (headroomlabs-ai#4671)
- fix(memory): keep multimodal user content intact when injecting memories (headroomlabs-ai#4648)
- fix(router): ignore shell operators inside quoted arguments in read detection (headroomlabs-ai#4646)
- fix(packaging)!: keep PyTorch extras out of all (headroomlabs-ai#4067)
- fix(langchain): check optional integration availability (headroomlabs-ai#4042)
- fix(memory): gracefully degrade on context lookup and initialization errors (headroomlabs-ai#3251) (headroomlabs-ai#4049)
- fix(install): decode Windows Task Scheduler XML output before parsing (headroomlabs-ai#3969) (headroomlabs-ai#4064)
- fix(search_compressor): keep kept rows byte-for-byte and in input order (headroomlabs-ai#3982)
- fix(telemetry): keep install ID stateless (headroomlabs-ai#3542)
- fix(providers): count Anthropic tool_result/tool_use content blocks in OpenAI token counter (headroomlabs-ai#2681)
- fix(binaries): fail closed on HEADROOM_BINARIES_ALLOW_UNVERIFIED=0/false (headroomlabs-ai#3218)
- fix(doctor): recognize IPv6 loopback and case-insensitive proxy routing URLs (headroomlabs-ai#3255)
- fix(vertex): explain Vertex failures in-band, correct the model/region matrix (headroomlabs-ai#2640)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status: ready for review Pull request body is complete and the author marked it ready for human review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] Default image: VOLUME and WORKDIR are /home/nonroot but HOME is /root, so ~/.headroom state is written to the container layer

3 participants