Releases
v0.40.0
Compare
Sorry, something went wrong.
No results found
0.40.0 (2026-10-06)
⚠ BREAKING CHANGES
proxy: read HEADROOM_LICENSE and make usage reporting opt-in (#3857 )
drop the crewai extra to remove chromadb from the lockfile (#3870 )
Features
compress: add per-message compression diagnostics (#3058 ) (fef99cc )
compress: live-agent densify mode, lossless and cache-safe (#1402 ) (84f0e84 )
dashboard: add CO₂ Saved card to dashboard and /stats API (#1369 ) (2bc9419 )
dashboard: give savings metrics one canonical home (#3320 ) (6af7efe )
learn: add agy (Antigravity CLI) as an analysis backend (#3939 ) (4ba231a )
live-zone: wire the SourceCode and PlainText dispatch arms (#3227 ) (49f69be )
memory: persist TrafficLearner pending evidence across restarts + expose learner stats (#3104 ) (4257ed4 )
proxy: add x-headroom-keep-last-turns header for per-request context trimming (issue #2858 ) (#3059 ) (246162d )
proxy: route Gemini plugin traffic through native transforms (#2697 ) (0ad996a )
proxy: serve on a Unix domain socket (--uds) (#3151 ) (e7b3baf )
wrap: add headroom wrap bob for IBM Bob CLI (#3801 ) (0b7dab4 )
wrap: extend reduce-at-source quiet defaults to telemetry/nag banners (#2550 ) (3a3a465 )
Bug Fixes
anthropic: preserve failed CCR continuations (#3843 ) (94bb055 )
backends/anyllm: map Anthropic tool_choice none to OpenAI none (#3963 ) (d722a64 )
backends/litellm: align streaming usage tokens with the non-streaming path (#2688 ) (90a68e0 )
backends/litellm: keep the upstream 4xx status on send_message errors (#3944 ) (e0e41cd )
backends/litellm: map Anthropic tool_choice none to OpenAI none (#2689 ) (57a5708 )
backends/litellm: match the caller-key Bearer scheme case-insensitively (RFC 7235) (#3965 ) (848d7a0 )
backends/litellm: report requested model in OpenAI streaming chunks (#2690 ) (8538a83 )
cache: keep prefix lineage across a replaced system tail (#3934 ) (16eaec1 )
ccr: answer headroom_retrieve on the direct chat path instead of forwarding it (#3816 ) (126e144 )
ccr: inject headroom_retrieve before the prefix is warm, not after (#3810 ) (bb8c285 )
ccr: only proactively expand compressions present in the requesting conversation (#3924 ) (9b9a883 )
ccr: unwrap Hermes batched tool_call so headroom_retrieve stays exempt (#3839 ) (2f07668 )
ci: clear dependency audit and gate Docker publishing (#3984 ) (67ce7d0 )
ci: keep hard watchdog out of pytest shards (#3845 ) (2527431 )
ci: tolerate missing Docker cache blobs (#3945 ) (540f4da )
clarify CCR marker content preservation (#3175 ) (005a4e1 )
cli: honor CODEX_HOME and align wrap/init/doctor with the live proxy port (#3855 ) (5bf6612 )
cli: strip unmarked headroom_memory TOML table before injecting (#3490 ) (08dda4c )
codex: explain why wrapped Codex runs without the shared server (#3899 ) (1982b3a )
codex: preserve remote compaction in init config (#3410 ) (6df4a96 )
codex: resolve per-turn project context (#2636 ) (0396ea2 )
codex: strip stale compression framing on the Responses subpath passthrough (#3792 ) (0eba65c )
copilot: defer keychain auth lookup (#2739 ) (81a8a28 )
copilot: read timezone-naive token expiry as UTC, not host local time (#3216 ) (2b2dc1b )
copilot: warn when a VS Code profile cannot see the proxy settings (#3919 ) (7b68fc2 )
deps: patch brace-expansion in wrap E2E lockfile (#3873 ) (5e0435d )
deps: patch urllib3 and Next.js advisories (#3896 ) (573e385 )
doctor: recognize Azure Foundry routing for Claude Code (#1339 ) (d5318ac )
grok: route CLI traffic to api.x.ai on shared proxies (#2693 ) (ef1c528 )
honor configured port in container startup and healthcheck (#2436 ) (1b7977c )
install/apply: add --no-rate-limit flag, persist in proxy_args (#1350 ) (#1365 ) (31d0344 )
install: parse Windows Task Scheduler XML output (#3830 ) (c32a4f4 )
install: replace the launchd wrapper with the proxy listener (#3224 ) (44db755 )
install: use safe model backends for persistent services (#3646 ) (7287589 )
integrations: record metric timestamps in UTC, not naive local time (#3117 ) (76ef2c3 )
kompress: degrade when a native dep is installed but unloadable (#3133 ) (8f3d677 )
kompress: pin ModernBERT tokenizer and encoder revisions (#3808 ) (2de5828 )
learn: drop the echoed prompt from a failed cli's error (#3928 ) (f00d425 )
learn: keep CLAUDE.local.md out of git via .git/info/exclude (#3108 ) (c072251 )
learn: keep transcript-derived content inside the managed block (#3850 ) (c46e74d )
learn: merge git worktree sessions into the repo's project (#3854 ) (3fdf18e )
learn: preserve stable traffic pattern items (#2293 ) (1631cde )
learn: recognize escaped persisted pattern IDs (#3951 ) (2e74f06 )
learn: run the claude-cli analysis with hooks disabled (#3926 ) (2a4d34c )
learn: run the claude-cli analysis with no tools (#3892 ) (db90b93 )
log_compressor: keep and name pytest short-summary failures (#3828 ) (d90b320 )
make Headroom work behind Zscaler and other TLS-inspecting networks (#3831 ) (66258c4 )
mcp: bound version-detection git subprocess (#3038 ) (0712e04 )
mcp: escape control characters when rendering TOML server blocks (#3964 ) (a96154f )
mcp: keep other apps' tables when replacing the Codex/Grok MCP span (#3877 ) (d0fd56e )
mcp: resolve opencode.jsonc for MCP registration (#2496 ) (f824a27 )
memory: align project routing with wrap headers (#3603 ) (b1b005a )
memory: avoid injecting tools into tool-free requests (#3677 ) (46755b5 )
memory: close SQLite connections in memory/fts5/graph adapters (#3153 ) (231a627 )
memory: handle list-shaped system content in inline memory injection (#3794 ) (717527b )
memory: ignore leading cd prefix when pairing Bash error recoveries (#3776 ) (143a38d )
memory: pin LF on memory writers and guard the learn-writer newline contract (#3706 ) (b10dd8d )
oauth2: mint and inject only on requests that go upstream (#3849 ) (f977d52 )
offline: make HEADROOM_OFFLINE a real air-gap via one chokepoint (#3729 ) (119d1a1 )
opencode: hide spawned Windows console windows (#3743 ) (2157400 )
opencode: route only LLM traffic through Headroom (#3884 ) (d75eecd )
output-savings: seed the holdout key on the whole first user message (#3209 ) (117ff72 )
parser: stop counting HTML comments twice in waste signals (#3942 ) (d0e9c4c )
parser: whitespace waste signal always reported zero (#1102 ) (f19bc9a )
plugin: resolve hook CLI through plugin-root launcher (#3053 ) (ef7605f )
plugins/openclaw: return messages the proxy did not change exactly as they came in (#3826 ) (d1ad189 )
prevent HF tokenizer downloads in offline mode (#3783 ) (d503c57 )
pricing: add Claude Sonnet 5.5 / Opus 5.5 / Fable 5.1, correct Sonnet 5 rates (#3841 ) (0d99c56 )
protect file reads in chained shell commands (#2668 ) (ffc3599 )
providers/vertex: Vertex route multi-region locations (#3802 ) (a9c1ac5 )
proxy/anthropic: keep tool_result blocks first when neutralizing headroom_retrieve history (#3874 ) (ccd9fff )
proxy/batch: honor x-headroom-bypass on the batch paths (#2570 ) (9b26a49 )
proxy: add same-origin check to /v1/retrieve/tool_call (#3955 ) (2297b50 )
proxy: bill the whole prompt on the gateway path so savings read true (#3632 ) (befdb52 )
proxy: carry safeguard_results through SSE resynthesis (#3958 ) (f37ef59 )
proxy: classify Pi Codex Responses alias (#2583 ) (a493f55 )
proxy: do not cache error replies delivered as http 200 (#3930 ) (1132a54 )
proxy: drop a tool_reference naming the search tool itself (#3172 ) (b73adaa )
proxy: F3 — per-tenant TOIN learning key (#404 ) (f90a56b )
proxy: forward operator-listed guarded upstreams through a proxy (#3804 ) (4b7e5d2 )
proxy: freeze and replay the forwarded prefix on Gemini paths (#3394 ) (#3865 ) (dd84321 )
proxy: gate the raw request body, not just its Content-Length header (#3338 ) (c946b6b )
proxy: hard watchdog that dumps and exits when a native call seizes the GIL (#3180 ) (79daeb5 )
proxy: inject memory context past a trailing system message (#3948 ) (3948dbe )
proxy: keep cache_control outside content blocks where the Chat Completions client put it (#3895 ) (a6d6c14 )
proxy: keep exception text and the proxy token out of client output (#3851 ) (861e94d )
proxy: keep the newest user message verbatim in cache-mode delta compression (#3923 ) (613ae92 )
proxy: key rate limits by peer unless the caller authenticated (#3860 ) (6fb7cad )
proxy: kill the image worker a timed-out call abandons (#3940 ) (793bb85 )
proxy: label plain OpenAI chat traffic openai, not custom (#3912 ) (7df8bd8 )
proxy: log response_content_length in proxy_inbound_response (#2701 ) (cfa479a )
proxy: preserve Bedrock body-limit error dialect (#3871 ) (ffc6edb )
proxy: preserve Windows service when Rust core is blocked (#2989 ) (eaa16d9 )
proxy: quarantine compression only once half the pool is stuck (#3932 ) (be2b205 )
proxy: read HEADROOM_LICENSE and make usage reporting opt-in (#3857 ) (7460389 )
proxy: reap wrap-spawned proxies once no wrap clients remain (#3202 ) (4227bd2 )
proxy: redact upstream error detail and add opt-in /metrics loopback gate (#2589 ) (a05717f )
proxy: refuse token-less non-loopback binds, gate operator routes (#3852 ) (ee731d7 )
proxy: reset the cc-switch upstream when Claude Official is selected (#3166 ) (fed7281 )
proxy: run extension middleware inside the security gate and body ceiling (#3847 ) (1854fd7 )
proxy: run injected memory tools server-side on streaming turns (#3947 ) (1cf4966 )
proxy: share one compression deadline across a Responses request (#3938 ) (4d27d02 )
proxy: skip pricing lookup for passthrough:* models (#2585 ) (f87848c )
proxy: stop headroom logger from suppressing propagation to stdout/stderr (#3096 ) (f78e66f )
relevance: bound segment size by max_chars (#2518 ) (0ef7b2a )
reporting: price the savings tile instead of fabricating $0.00 (#3821 ) (f519fa8 )
router: fall back to built-ins when an external compressor passes through (#3893 ) (2c4b20f )
router: keep ccr_retrieve exemption through orchestrator wrappers (#3915 ) (6151ed1 )
rust-proxy: forward request paths verbatim and pin the rustls provider (#3853 ) (9d98ea5 )
savings: record tool-schema dollars disjointly beside the folded headline (#3170 ) (c719d4a )
savings: stop scoring unobserved strata against the global mean (#3128 ) (f864525 )
sdk: keep tool names on Vercel tool-result parts through the OpenAI round trip (#3883 ) (b715671 )
sdk: preserve Gemini media parts in message conversion instead of dropping the turn (#3882 ) (038c923 )
sdk: stop JSON-wrapping structured tool_result content in the Anthropic adapter (#3797 ) (2e4a60a )
search: stop a context line's body from becoming its line marker (#3788 ) (f3f2e00 )
security: create memory stores and other state files owner-only (#3848 ) (5119b6e )
security: exempt only GET health probes from the proxy token (#3921 ) (d99779d )
security: partition the response cache by credential and principal (#3862 ) (ee6cfcc )
security: poll usage only with the operator's own credential (#3863 ) (65e63c0 )
security: stop forwarding the proxy token to upstream providers (#3891 ) (0147cf0 )
settings: report live proxy configuration (#3177 ) (58b1454 )
smart-crusher: recurse at adaptive array limit (#3770 ) (7790bde )
storage: page JSONL queries after sorting (#3872 ) (91237ca )
subscription: match the Bearer scheme case-insensitively for the Codex usage poll (RFC 7235) (#3966 ) (fe88461 )
subscription: poll with the refreshed credentials-file OAuth token (#3916 ) (2dc9fc2 )
surface Codex responses traffic in dashboard (#399 ) (ecc4967 )
telemetry: label custom-base chat upstreams from a fixed provider set (#3759 ) (f0ec2bb )
thinking: don't read the model's date suffix as its minor version (#3791 ) (afaaaa8 )
transforms/kompress: preserve line boundaries and tabular output in Kompress (#3119 ) (fe2ed2b )
transforms: judge a Codex exec envelope read by its output (#3878 ) (922924e )
transforms: judge the code_aware Kompress fallback in tokens (#3881 ) (6326965 )
transforms: keep record-bearing JSON out of Kompress (#3673 ) (#3880 ) (8dbbd1d )
wrap: never reuse a non-Headroom listener on the proxy port (#3799 ) (3ffa57e )
wrap: never reuse a proxy with incompatible routing config (#3201 ) (f69e246 )
wrap: preserve pre-set ANTHROPIC_BASE_URL as proxy upstream (#1358 ) (bb1ab6a )
wrap: scope Serena's MCP registration to the wrapped project (#2787 ) (#2992 ) (8cfeb69 )
wrap: set ANTHROPIC_HOST so wrap goose actually proxies Anthropic (#2619 ) (c07fad0 )
wrap: strip -dev from running proxy version in restart check (#3200 ) (bd0296b )
Performance Improvements
add savings audit output (#1211 ) (9a72bc0 )
compression/code: avoid a UTF-8 copy per code block in byte-to-char mapping (#3169 ) (d5e5534 )
image: OCR and SigLIP each image once, not once per turn (#3941 ) (a8561fb )
memory: bound traffic-learner _persisted_ids with the dedup window (#3341 ) (7e73438 )
metrics: cap inbound request-path cardinality to bound memory (#3340 ) (88a1f4e )
proxy: lighter request path: alias the message snapshot, keep the token cache on re-counts, decompress off the event loop (#3909 ) (c873d13 )
tokenizer: memoize OpenAI token counts like the Anthropic counter (#3168 ) (0a2c80d )
Dependencies
bump pyjwt 2.13.0 -> 2.15.1 for CVE-2026-102274 (#3861 ) (37b9c46 )
Bump source-map-js from 1.2.1 to 1.2.2 in /docs (#3986 ) (e06631a )
Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/openclaw (#3988 ) (4be83b3 )
Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/opencode (#3987 ) (478dd9e )
Bump source-map-js from 1.2.1 to 1.2.2 in /sdk/typescript (#3985 ) (62cde35 )
bump the npm-minor-patch group across 2 directories with 11 updates (#3903 ) (afe4f4e )
bump the npm-minor-patch group across 3 directories with 11 updates (#3910 ) (ff1a0d6 )
bump webpki-roots from 0.26.11 to 1.0.8 (#3905 ) (fee53b4 )
drop the crewai extra to remove chromadb from the lockfile (#3870 ) (59b8cef )
Code Refactoring
ccr: read the expansion query through extract_user_query (#2707 ) (dcec845 )
wrap: generate goose/openhands/openclaude from a WrapTarget registry (#3800 ) (de4cf7e )
You can’t perform that action at this time.