Commit Graph
206 Commits
Author SHA1 Message Date
JD Davis 6ffa22cfef Merge branch 'main' into fix/plugin-launcher-isolated-python 2026-11-17 01:49:05 -06:00
123XieCand123XieC d077263012 fix(openclaw): preserve assistant text blocks when tool arguments change (#4829)
## Description

OpenClaw history can contain text on both sides of an assistant tool
call. If the compression response changes the call arguments while
leaving the wire text intact, restoring that message currently moves
both pieces of text ahead of the call and joins them into a single
block.

## Type of Change

- [x] Bug fix

## Changes Made

- Compare the returned assistant text with the text sent for that
message. Keep the original blocks when the text matches, then apply the
changed arguments to the matching tool call.
- Extend the assemble regression to check the order and content of both
text blocks, the signed thinking block, and the updated tool call.

## Testing

- [x] Regression and existing OpenClaw tests pass.
- [x] Manual testing performed.

### Test Output

```text
cd plugins/openclaw
npm test          # 11 files, 162 tests passed
npm run typecheck # passed
npm run build     # passed
git diff --check  # passed
```

The repository commit hooks and Rust formatting check passed. The full
local pre-push suite stopped at Rust dependency resolution after the
registry fetch stalled. I used the hook's documented push override for
this TypeScript-only change. The verification above covers the changed
plugin.

## Real Behavior Proof

- Environment: macOS arm64, Node 22.22.2, built OpenClaw plugin with the
pinned JavaScript SDK, and a Node HTTP server listening on loopback. The
payload was synthetic and did not need a model.
- Exact command / steps: Run `npm run build` in `plugins/openclaw` on
base `9f2cc01` and the patched tree. In Node, import
`HeadroomContextEngine` from the built `dist/index.js`. Start a loopback
server that answers `GET /v1/retrieve/stats` with `{"store":{}}`. For
`POST /v1/compress`, echo the submitted messages and set the first tool
call's argument string to `{"id":7}`. Return `tokens_before: 100`,
`tokens_after: 25`, and `tokens_saved: 75`. Create the engine with that
`proxyUrl`, `autoStart: false`, and `minContextChars: 0`. Await
`ensureProxyUrl()`, then call `assemble()` with one assistant message
whose blocks are signed thinking, text `Checking.`, a `lookup` call with
ID `lookup-1` and arguments `{id: 7, notes: "fixture ".repeat(80)}`, and
text `Awaiting result.`.
- Observed result: the SDK sent one actual compression request in both
runs. Base returned `thinking, text("Checking.Awaiting result."),
toolCall({id:7})`. The patch returned `thinking, text("Checking."),
toolCall({id:7}), text("Awaiting result.")`. The signature and call ID
were preserved, and the engine reported 25 tokens in both runs.
- Not tested: a remote proxy, model calls, or an OpenClaw host process.
The runtime proof exercised the built plugin and SDK over HTTP with a
deterministic compression response.

## Runtime Rollout Safety

- Rollout-managed feature(s): OpenClaw context restoration.
- Minimum rollout channel: existing plugin channel.
- Stable/default behavior changed: text block placement is preserved
when only assistant tool arguments change.
- Kill switch / disable path: existing OpenClaw plugin enablement.
- Unsafe override required: none.
- Qualification impact: OpenClaw plugin suite and loopback verification
above.
- Rollback path: revert the commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] I did **not** edit `CHANGELOG.md` — it is generated by
release-please from my Conventional Commit PR title (a CI guard enforces
this)

## Additional Notes

This is a small correction to the restoration path introduced by #3826.
AI assistance was used to investigate, implement, and verify the change.

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4829"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Co-authored-by: 123XieC <323077714+123XieC@users.noreply.github.com>
2026-11-16 23:05:24 -06:00
JD Davis 550644f57a Merge branch 'main' into fix/plugin-launcher-isolated-python 2026-11-16 20:41:25 -06:00
863b3c7cc7 fix(opencode): percent-encode the project name in x-headroom-project (#4780)
## Description

The OpenCode plugin set `x-headroom-project` to the raw project name in
`plugins/opencode/src/transport.ts` (two sites) and
`plugins/opencode/src/plugin.ts`. A header value must be a ByteString,
so a project name with any character above U+00FF (Thai, Chinese,
Cyrillic, Arabic, `€`, emoji and so on) made `Headers.set` throw a
`TypeError` inside the patched `fetch` and `https.request`, and every
routed request failed.

`headroom/cli/wrap.py` already percent-encodes this header for the same
reason, and the proxy decodes it (`sanitize_project_name` calls
`unquote`). This PR does the same in the plugin through one helper,
`projectHeaderValue`, used at the three sites. Header values that
contain only characters from the URL-unreserved set are sent as before.

Closes #4779

## Type of Change

- [x] 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

- `plugins/opencode/src/transport.ts`: new exported
`projectHeaderValue(project)` (`encodeURIComponent`), used for
`x-headroom-project` in the fetch and Node request paths.
- `plugins/opencode/src/plugin.ts`: the model headers set by
`routeModelsThroughProxy` use `projectHeaderValue(project)`.
- `plugins/opencode/src/transport.test.ts`: two tests with a Thai,
Chinese, Cyrillic and Polish project name, one through `fetch` and one
through Node `https.request` against a loopback server.
- `headroom/providers/opencode/_dist/index.js` and
`hook-shim/handler.js`: regenerated with `npm run build:standalone` (the
CI step compares both with a fresh build; the staged blobs equal the
build output).

## Testing

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

This is a TypeScript-only change, so the Python checks above do not
apply; the plugin equivalents were run (Node v24.22.2, vitest, `npm ci
--ignore-scripts` from the committed lockfile, Ubuntu on WSL2).

### Test Output

Fail before (`transport.ts` from `3c66c91e`, new tests kept):

```text
vitest run src/transport.test.ts -t "non-Latin-1"
 × percent-encodes a non-Latin-1 project name instead of throwing on routed fetch calls
 × percent-encodes a non-Latin-1 project name on routed Node https.request calls
TypeError: Cannot convert argument to a ByteString because the character at index 8 has a value of 3650 which is greater than 255.
TypeError: Cannot convert argument to a ByteString because the character at index 0 has a value of 3650 which is greater than 255.
Tests  2 failed | 47 skipped (49)
```

Pass after (this branch):

```text
vitest run src/transport.test.ts -t "non-Latin-1"
Tests  2 passed | 47 skipped (49)

vitest run (whole plugins/opencode suite)
Test Files  4 passed (4)
Tests  81 passed (81)

npm run typecheck -> exit 0
npm run build:standalone -> success; the committed bundle equals this build
```

## Real Behavior Proof

- Environment: Ubuntu on WSL2, Node v24.22.2, the committed wheel bundle
`headroom/providers/opencode/_dist/index.js` (not vitest), and a
loopback `node:http` server standing in for the proxy.
- Exact command / steps: load the bundle (`origin/main` for "before",
this branch for "after"), call `default.server({ project: { id: "p" },
directory: "/work" }, { proxyUrl: "http://127.0.0.1:<port>", project
})`, then `fetch("https://api.anthropic.com/v1/messages", { method:
"POST", body: "{}" })`, once with `project = "my-project"` and once with
a Thai, Chinese and Cyrillic string.
- Observed result: before, `my-project` was sent as `my-project` and the
Thai/Chinese/Cyrillic name made `fetch` throw `TypeError: Cannot convert
argument to a ByteString ... 3650 ... greater than 255` with 0 requests
recorded. After, `my-project` is still sent as `my-project`, and the
multilingual name reaches the recorder as
`%E0%B9%82...%2F%E4%B8%AD%E6%96%87%2F%D0%9F...` which
`decodeURIComponent` turns back into the original string.
- Not tested: a real Headroom proxy (the recorder only shows what is
sent; the decode step is from reading
`headroom/proxy/project_name_policy.py`), OpenCode 1.x or 2.x hosts, and
anything outside the proxy that reads the header.

## Runtime Rollout Safety

- Rollout-managed feature(s): none; OpenCode plugin transport only.
- Minimum rollout channel: n/a
- Stable/default behavior changed: only for a project name with
characters outside the URL-unreserved set. Those are now percent-encoded
(a path such as `/home/u/app` is sent as `%2Fhome%2Fu%2Fapp`) and the
proxy decodes them; plain names like `my-project` are unchanged.
- Kill switch / disable path: n/a
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert this commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

- The plugin test for `routeModelsThroughProxy` was not extended; the
`plugin.ts` site is the same one-line call to the helper, covered by the
bundle proof above.
- The shell env variable `HEADROOM_PROJECT` is unchanged: it is an
environment value, not a header.

AI assistance: this change, its tests and the runs above were done with
Claude (Sonnet 5.5), operated by me (HetCreep).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4780"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-17 02:37:46 +05:30
ParideboyandJerrettDavis 87c12931fb fix(opencode): stop routing a host's bare /messages or /responses to the proxy (#4781) (#4791)
## Description

A `POST` whose path ends in a wire endpoint but that sits at a host's
origin root (`/messages`, `/responses`, `/chat/completions`) is no
longer routed to the proxy unless that origin is a configured provider
base URL.

Closes #4781.

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)

## Changes Made

- `plugins/opencode/src/transport.ts` — `hasWireRootBefore` no longer
treats "no segment before the endpoint" as a wire root, so a bare
`/messages` at an unknown host goes direct.
- `plugins/opencode/src/transport.test.ts` — the bare-endpoint
assertions from #4758 move into a #4781 case that pins both directions:
direct by default, routed once the base is registered; the #4758 case
keeps the prefixes that still route.
- `plugins/opencode/README.md` — states the actual routing rule, and the
two shapes that still route without a configured base.
- `headroom/providers/opencode/_dist/index.js`,
`headroom/providers/opencode/hook-shim/handler.js` — rebuilt, since the
`opencode-plugin` gate compares bytes against `dist-standalone`.
- `plugins/opencode/scripts/live-proof-4781.mjs` — the live proof below,
committed so it can be rerun.

## Why

#4758 stopped a suffix match from routing non-LLM hosts, but kept bare
endpoints routable "because compatible gateways use those paths". That
left exactly one non-LLM shape still leaking: `POST
https://rest.messagebird.com/messages` with `Authorization: AccessKey
...` went to the proxy, carrying a non-LLM credential (#4781).

Becoming the bare path is not evidence of a provider — it is equally the
shape of a messaging API. A provider mounted at an origin root is still
routed, because its base URL *is* a configured wire root
(`isConfiguredWireRoot` matches every path on that origin when the base
path is empty), which is how OpenCode reports
`provider.<id>.options.baseURL`.

```ts
return (
  last !== undefined &&
  (isVersionSegment(last) || IMMEDIATE_WIRE_ROOTS.has(last) || segments.some((s) => NAMED_WIRE_ROOTS.has(s)))
);
```

Everything else is untouched: version prefixes (`/v1`, `/v1beta`,
`/v4`), immediate `api`, named roots (`backend-api`, `codex`, `openai`,
`anthropic`, `zen`), Gemini colon actions, configured bases,
`excludeHosts`, and the method gate.

## Testing

- [x] New tests added for new functionality
- [x] Manual testing performed

`plugins/opencode` is a TypeScript package, so its gates are npm scripts
rather than `pytest` / `ruff` / `mypy`; `npm audit` and the rest run in
the repo's own CI.

### Test Output

```text
> vitest run
Test Files  4 passed (4)
     Tests  80 passed (80)

> node node_modules/@typescript/native/bin/tsc --noEmit
(clean, no output)

> node scripts/live-proof-4781.mjs
=== decisions (real sockets, real fetch, real built plugin) ===
PASS  MessageBird-shaped  POST /messages             -> left alone
PASS  MessageBird batches  POST /messages/batches    -> left alone
PASS  LLM control         POST /v1/messages          -> REROUTED to proxy
PASS  LLM control         POST /v1/chat/completions  -> REROUTED to proxy

=== what reached the proxy ===
  POST /v1/messages  x-headroom-base-url=http://localtest.me:8899  original-path=null
  POST /v1/chat/completions  x-headroom-base-url=http://localtest.me:8899  original-path=/v1/chat/completions

=== MessageBird-shaped requests that reached the proxy: 0 ===
=== what reached the upstream directly ===
  POST /messages  auth=AccessKey FAKE-TEST-VALUE  (no proxy headers: true)
  POST /messages/batches  auth=AccessKey FAKE-TEST-VALUE  (no proxy headers: true)

ALL CASES PASS
```

Before the fix, same script, source reverted to `HEAD~1` and the bundle
rebuilt:

```text
=== decisions (real sockets, real fetch, real built plugin) ===
FAIL  MessageBird-shaped  POST /messages             -> REROUTED to proxy
PASS  MessageBird batches  POST /messages/batches    -> left alone
PASS  LLM control         POST /v1/messages          -> REROUTED to proxy
PASS  LLM control         POST /v1/chat/completions  -> REROUTED to proxy

=== what reached the proxy ===
  POST /messages  x-headroom-base-url=http://localtest.me:8899  original-path=null
```

Reverting only `src/transport.ts` also fails the unit test (`1 failed |
79 passed`), satisfying "a test that fails before your fix and passes
after".

## Real Behavior Proof

- Environment: Windows 11 (win32), Node v26.10.0, this branch of
`plugins/opencode`, committed wheel bundle
`headroom/providers/opencode/_dist/index.js` loaded via
`plugin.server(...)` as `headroom wrap opencode` does; upstream and
proxy are local HTTP fixtures on real TCP sockets and `globalThis.fetch`
is Node's undici, not a stub.
- Exact command / steps: `cd plugins/opencode && npm ci && npm run
build:standalone && node scripts/live-proof-4781.mjs`, which POSTs a
MessageBird-shaped SMS payload and two LLM control requests to
`http://localtest.me:8899` (resolves to 127.0.0.1 but is not a loopback
spelling, so traffic really leaves the process) and records which server
received each one.
- Observed result: after the patch `POST /messages` and `POST
/messages/batches` reach the upstream directly with no
`x-headroom-base-url` header and the proxy receives zero
MessageBird-shaped requests, while `/v1/messages` and
`/v1/chat/completions` still reach the proxy with the upstream origin
header; with `src/transport.ts` reverted to `HEAD~1` the same run
reroutes `POST /messages` to the proxy, reproducing the reported leak
over a real socket (full output in `Testing` → `Test Output`).
- Not tested: a real MessageBird account and the real
`rest.messagebird.com` host, since the payload and `AccessKey` are fake
and routing is decided before DNS; the proxy's handling of an SMS body,
which never arrives after this change; and a live OpenCode host process,
since the fixture drives the plugin's own `server()` entry rather than
an OpenCode session.

## Runtime Rollout Safety

- Rollout-managed feature(s): none, no feature flag is involved.
- Minimum rollout channel: next released `headroom-opencode` / wheel.
- Stable/default behavior changed: yes, deliberately — a `POST` to
`/messages`, `/responses` or `/chat/completions` at a host's origin root
now goes direct unless that origin is a configured provider base URL;
users whose gateway is configured via `provider.<id>.options.baseURL`
are unaffected.
- Kill switch / disable path: `excludeHosts` /
`HEADROOM_OPENCODE_EXCLUDE_HOSTS` forces a host direct, and configuring
the base URL or listing it in `wireRoots` forces a bare-path provider
through the proxy.
- Unsafe override required: no.
- Qualification impact: none.
- Rollback path: revert the commits; the transport and the committed
bundle revert together.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

Residual, deliberately not solved and now stated in the README:
`/api/v2/messages` and `/v2/responses` still route. No path shape
separates those from a gateway rooted at `/api` or `/v2`; only the host
or the request body could, and reading the body inside a sync `fetch`
wrapper buys a new class of failure for a shape `excludeHosts` already
covers. I did not add a known-host allowlist either: it can only
recognise hosts someone already thought of, and it regresses compatible
gateways silently — the failure mode #4747 was filed about.

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-17 02:36:58 +05:30
Tejas Chopra 3300923387 Merge branch 'main' into fix/plugin-launcher-isolated-python 2026-11-15 01:27:05 +05:30
dependabot[bot]andJerrettDavis 6182b5fe06 deps: bump the npm-minor-patch group across 3 directories with 10 updates (#4813)
Bumps the npm-minor-patch group with 1 update in the /plugins/openclaw
directory:
[headroom-ai](https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript).
Bumps the npm-minor-patch group with 3 updates in the /plugins/opencode
directory:
[headroom-ai](https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript),
[effect](https://github.com/Effect-TS/effect/tree/HEAD/packages/effect)
and
[@opencode/plugin](https://github.com/anomalyco/opencode/tree/HEAD/packages/plugin).
Bumps the npm-minor-patch group with 7 updates in the /sdk/typescript
directory:

| Package | From | To |
| --- | --- | --- |
|
[@ai-sdk/anthropic](https://github.com/vercel/ai/tree/HEAD/packages/anthropic)
| `4.0.94` | `4.0.99` |
|
[@ai-sdk/openai](https://github.com/vercel/ai/tree/HEAD/packages/openai)
| `4.0.106` | `4.0.111` |
|
[@ai-sdk/provider](https://github.com/vercel/ai/tree/HEAD/packages/provider)
| `4.0.35` | `4.0.37` |
|
[@anthropic-ai/sdk](https://github.com/anthropics/anthropic-sdk-typescript)
| `1.3.0` | `1.6.0` |
| [ai](https://github.com/vercel/ai/tree/HEAD/packages/ai) | `7.0.159` |
`7.0.166` |
| [dotenv](https://github.com/motdotla/dotenv) | `18.0.9` | `18.0.10` |
| [openai](https://github.com/openai/openai-node) | `7.47.0` | `7.53.0`
|


Updates `headroom-ai` from 0.42.0 to 0.43.1
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/headroomlabs-ai/headroom/releases">headroom-ai's
releases</a>.</em></p>
<blockquote>
<h2>Release v0.43.1</h2>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1">0.43.1</a>
(2026-11-05)</h2>
<h3>Bug Fixes</h3>
<ul>
<li><strong>ccr:</strong> keep the in-memory order queue from evicting
re-stored entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4545">#4545</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d">c6f5bf9</a>)</li>
<li><strong>memory:</strong> read the relation key the memory_save
schema advertises (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4647">#4647</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92">7592e68</a>)</li>
<li><strong>memory:</strong> replace the HNSW vector when a memory is
re-indexed (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4649">#4649</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf">ee638f9</a>)</li>
<li><strong>openclaw:</strong> accept 12-character hashes in
headroom_retrieve (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4640">#4640</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a">8d3e9e5</a>)</li>
<li><strong>ort:</strong> avoid implicit runtime discovery from the
workspace (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4570">#4570</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55">69fbd23</a>)</li>
<li><strong>proxy:</strong> bound the model-keyed tokenizer, beacon and
litellm caches (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4497">#4497</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0">e51b806</a>)</li>
<li><strong>proxy:</strong> use HTTP/1.1 client for ChatGPT streaming
and model metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4006">#4006</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2">e1becdf</a>)</li>
<li><strong>release:</strong> normalize damaged release PR envelopes
before detection (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4664">#4664</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd">917edc6</a>)</li>
<li><strong>router:</strong> keep tagged blocks out of the lossy
size-gate fallback (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4543">#4543</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d">f333edf</a>)</li>
<li><strong>router:</strong> log the ONNX fallbacks at info instead of
warning (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4535">#4535</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f">db30d82</a>)</li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4662">#4662</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7">8f104f8</a>)</li>
</ul>
<!-- raw HTML omitted -->
<hr />
<p><strong>Want more savings?</strong> Headroom Enterprise saves more
for teams and enterprises. Talk to us at <a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/blob/HEAD/mailto:hello@headroomlabs.ai">hello@headroomlabs.ai</a>
or <a href="https://headroomlabs.ai">headroomlabs.ai</a>.</p>
<h2>Release v0.43.0</h2>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.42.0...v0.43.0">0.43.0</a>
(2026-11-05)</h2>
<h3>⚠ BREAKING CHANGES</h3>
<ul>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)</li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>ccr:</strong> answer headroom_retrieve on streaming chat
completions (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4631">#4631</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/31dcaf41f7fafaebec0838a05ff328da456faef0">31dcaf4</a>)</li>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee2252a3155c87e948c8893b79af5824eb30e64c">ee2252a</a>)</li>
<li><strong>plugins:</strong> headroom skill for Claude Code, Codex,
Copilot and skills.sh (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4533">#4533</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/66e14676827366c2bf8d15e252f8766cb27b1a98">66e1467</a>)</li>
<li><strong>savings:</strong> show the proxy's model-routing savings in
headroom savings (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4304">#4304</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/aaab338b64cb55929de904411db65db126e22ec0">aaab338</a>)</li>
</ul>
<h3>Bug Fixes</h3>
<ul>
<li>[BUG] A timeout in one image compression call resets the shared
worker pool and affects concurrent requests (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4528">#4528</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e9bcfe73fadf69f0b27b7bc338ea7d2380931054">e9bcfe7</a>)</li>
<li>[BUG] DirectMem0Adapter.search_memories calls removed mem0 search
API (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4518">#4518</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d9cee452681c79d6f13919e9e651e88a774c0874">d9cee45</a>)</li>
<li>[BUG] Saved request metrics lose their cache optimization fields (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4584">#4584</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/b4c9bdf100d97fb038beba95de6d4ad6a8786090">b4c9bdf</a>)</li>
<li>[BUG] Volatile SQLite metrics stores lose their schema before the
first save (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4633">#4633</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d8ff0fe9d2cb2477f6662a90f8fcd7e030a52666">d8ff0fe</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/headroomlabs-ai/headroom/blob/main/CHANGELOG.md">headroom-ai's
changelog</a>.</em></p>
<blockquote>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1">0.43.1</a>
(2026-11-05)</h2>
<h3>Bug Fixes</h3>
<ul>
<li><strong>ccr:</strong> keep the in-memory order queue from evicting
re-stored entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4545">#4545</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d">c6f5bf9</a>)</li>
<li><strong>memory:</strong> read the relation key the memory_save
schema advertises (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4647">#4647</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92">7592e68</a>)</li>
<li><strong>memory:</strong> replace the HNSW vector when a memory is
re-indexed (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4649">#4649</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf">ee638f9</a>)</li>
<li><strong>openclaw:</strong> accept 12-character hashes in
headroom_retrieve (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4640">#4640</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a">8d3e9e5</a>)</li>
<li><strong>ort:</strong> avoid implicit runtime discovery from the
workspace (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4570">#4570</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55">69fbd23</a>)</li>
<li><strong>proxy:</strong> bound the model-keyed tokenizer, beacon and
litellm caches (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4497">#4497</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0">e51b806</a>)</li>
<li><strong>proxy:</strong> use HTTP/1.1 client for ChatGPT streaming
and model metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4006">#4006</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2">e1becdf</a>)</li>
<li><strong>release:</strong> normalize damaged release PR envelopes
before detection (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4664">#4664</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd">917edc6</a>)</li>
<li><strong>router:</strong> keep tagged blocks out of the lossy
size-gate fallback (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4543">#4543</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d">f333edf</a>)</li>
<li><strong>router:</strong> log the ONNX fallbacks at info instead of
warning (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4535">#4535</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f">db30d82</a>)</li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4662">#4662</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7">8f104f8</a>)</li>
</ul>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.42.0...v0.43.0">0.43.0</a>
(2026-11-05)</h2>
<h3>⚠ BREAKING CHANGES</h3>
<ul>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)</li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>ccr:</strong> answer headroom_retrieve on streaming chat
completions (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4631">#4631</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/31dcaf41f7fafaebec0838a05ff328da456faef0">31dcaf4</a>)</li>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee2252a3155c87e948c8893b79af5824eb30e64c">ee2252a</a>)</li>
<li><strong>plugins:</strong> headroom skill for Claude Code, Codex,
Copilot and skills.sh (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4533">#4533</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/66e14676827366c2bf8d15e252f8766cb27b1a98">66e1467</a>)</li>
<li><strong>savings:</strong> show the proxy's model-routing savings in
headroom savings (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4304">#4304</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/aaab338b64cb55929de904411db65db126e22ec0">aaab338</a>)</li>
</ul>
<h3>Bug Fixes</h3>
<ul>
<li>[BUG] A timeout in one image compression call resets the shared
worker pool and affects concurrent requests (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4528">#4528</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e9bcfe73fadf69f0b27b7bc338ea7d2380931054">e9bcfe7</a>)</li>
<li>[BUG] DirectMem0Adapter.search_memories calls removed mem0 search
API (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4518">#4518</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d9cee452681c79d6f13919e9e651e88a774c0874">d9cee45</a>)</li>
<li>[BUG] Saved request metrics lose their cache optimization fields (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4584">#4584</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/b4c9bdf100d97fb038beba95de6d4ad6a8786090">b4c9bdf</a>)</li>
<li>[BUG] Volatile SQLite metrics stores lose their schema before the
first save (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4633">#4633</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d8ff0fe9d2cb2477f6662a90f8fcd7e030a52666">d8ff0fe</a>)</li>
<li>Add info about apply to README.md (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/1592">#1592</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/4d34680c34ad379d693820869e77d4a2a6be2cdf">4d34680</a>)</li>
<li><strong>backends/litellm:</strong> keep cache_control on text blocks
for Bedrock prompt caching (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4565">#4565</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/23a5bb1c81dc943398f9271f068a02487207f2e7">23a5bb1</a>)</li>
<li><strong>backends:</strong> forward the standard service_tier param
(litellm + anyllm) (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/2468">#2468</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/62cc38a6b09dbcf723681a0ff56acd02131ad1f1">62cc38a</a>)</li>
<li><strong>cache:</strong> build semantic entry before evicting so a
failed embedding keeps live entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4581">#4581</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/0d4c450d774691568b850f0d22ce17e087405281">0d4c450</a>)</li>
<li><strong>cache:</strong> count a tool_result with no text as
replayable in the frozen prefix (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4523">#4523</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/fba09f674c8a9c91b39a563a70ab7727b44d1dbc">fba09f6</a>)</li>
<li><strong>cache:</strong> fail closed on SQLite corruption instead of
deleting the store online (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4361">#4361</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/98018333f997783487af15efe4d9e631ecd85939">9801833</a>)</li>
<li><strong>cache:</strong> invalidate configured registry instances on
replacement (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4363">#4363</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/1bcdca2d9dd279f49aa4276d523d93c2cfeb5a51">1bcdca2</a>)</li>
<li><strong>cache:</strong> namespace SemanticCacheLayer by provider,
model and metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4473">#4473</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/99cdaaf1c7de2bd81a8e64f198462fd1ceec3a17">99cdaaf</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/2d3ee51846435ef5b320eea4806af14e602b0d8c"><code>2d3ee51</code></a>
chore: release 0.43.1 (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4661">#4661</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7"><code>8f104f8</code></a>
deps: bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4662">#4662</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/81fa4bdda613f6a37f6f430eda9f728e1458f3ce"><code>81fa4bd</code></a>
chore: release 0.43.0 (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4643">#4643</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/a26faaeee34ecfde57608aea4a1ec7ea2b33272f"><code>a26faae</code></a>
fix(sdk): carry Vercel AI SDK reasoning parts and provider options
through co...</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/e666fd8e35dbe7c0433739297873b6a0a51c26cf"><code>e666fd8</code></a>
deps: Bump tsup from 8.5.1 to 9.0.0 in /sdk/typescript (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4386">#4386</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/74277d47ecfbca349ddb99f81094c4dd30539d43"><code>74277d4</code></a>
deps: Bump <code>@​anthropic-ai/sdk</code> from 0.133.0 to 1.3.0 in
/sdk/typescript (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4554">#4554</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/5e4827de12c9fdf33d7d36b1939eee73a18fe6c5"><code>5e4827d</code></a>
deps: Bump the npm-minor-patch group across 1 directory with 6 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4621">#4621</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/cd5e2b9e73eb8bd783ab872bdda71263b941e2d3"><code>cd5e2b9</code></a>
fix(sdk): send Anthropic messages to /v1/compress natively so thinking
blocks...</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/6c3d7475077b2e09e8cff5ba2352bda4064d86d3"><code>6c3d747</code></a>
chore(sdk-typescript): npm metadata and the proxy requirement up front
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4536">#4536</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/f36772805178e3fed1a95313e8211c57a291b953"><code>f367728</code></a>
deps: Bump the npm-minor-patch group across 3 directories with 9 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4495">#4495</a>)</li>
<li>See full diff in <a
href="https://github.com/headroomlabs-ai/headroom/commits/v0.43.1/sdk/typescript">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.42.0 to 0.43.1
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/headroomlabs-ai/headroom/releases">headroom-ai's
releases</a>.</em></p>
<blockquote>
<h2>Release v0.43.1</h2>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1">0.43.1</a>
(2026-11-05)</h2>
<h3>Bug Fixes</h3>
<ul>
<li><strong>ccr:</strong> keep the in-memory order queue from evicting
re-stored entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4545">#4545</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d">c6f5bf9</a>)</li>
<li><strong>memory:</strong> read the relation key the memory_save
schema advertises (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4647">#4647</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92">7592e68</a>)</li>
<li><strong>memory:</strong> replace the HNSW vector when a memory is
re-indexed (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4649">#4649</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf">ee638f9</a>)</li>
<li><strong>openclaw:</strong> accept 12-character hashes in
headroom_retrieve (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4640">#4640</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a">8d3e9e5</a>)</li>
<li><strong>ort:</strong> avoid implicit runtime discovery from the
workspace (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4570">#4570</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55">69fbd23</a>)</li>
<li><strong>proxy:</strong> bound the model-keyed tokenizer, beacon and
litellm caches (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4497">#4497</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0">e51b806</a>)</li>
<li><strong>proxy:</strong> use HTTP/1.1 client for ChatGPT streaming
and model metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4006">#4006</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2">e1becdf</a>)</li>
<li><strong>release:</strong> normalize damaged release PR envelopes
before detection (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4664">#4664</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd">917edc6</a>)</li>
<li><strong>router:</strong> keep tagged blocks out of the lossy
size-gate fallback (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4543">#4543</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d">f333edf</a>)</li>
<li><strong>router:</strong> log the ONNX fallbacks at info instead of
warning (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4535">#4535</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f">db30d82</a>)</li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4662">#4662</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7">8f104f8</a>)</li>
</ul>
<!-- raw HTML omitted -->
<hr />
<p><strong>Want more savings?</strong> Headroom Enterprise saves more
for teams and enterprises. Talk to us at <a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/blob/HEAD/mailto:hello@headroomlabs.ai">hello@headroomlabs.ai</a>
or <a href="https://headroomlabs.ai">headroomlabs.ai</a>.</p>
<h2>Release v0.43.0</h2>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.42.0...v0.43.0">0.43.0</a>
(2026-11-05)</h2>
<h3>⚠ BREAKING CHANGES</h3>
<ul>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)</li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>ccr:</strong> answer headroom_retrieve on streaming chat
completions (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4631">#4631</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/31dcaf41f7fafaebec0838a05ff328da456faef0">31dcaf4</a>)</li>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee2252a3155c87e948c8893b79af5824eb30e64c">ee2252a</a>)</li>
<li><strong>plugins:</strong> headroom skill for Claude Code, Codex,
Copilot and skills.sh (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4533">#4533</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/66e14676827366c2bf8d15e252f8766cb27b1a98">66e1467</a>)</li>
<li><strong>savings:</strong> show the proxy's model-routing savings in
headroom savings (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4304">#4304</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/aaab338b64cb55929de904411db65db126e22ec0">aaab338</a>)</li>
</ul>
<h3>Bug Fixes</h3>
<ul>
<li>[BUG] A timeout in one image compression call resets the shared
worker pool and affects concurrent requests (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4528">#4528</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e9bcfe73fadf69f0b27b7bc338ea7d2380931054">e9bcfe7</a>)</li>
<li>[BUG] DirectMem0Adapter.search_memories calls removed mem0 search
API (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4518">#4518</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d9cee452681c79d6f13919e9e651e88a774c0874">d9cee45</a>)</li>
<li>[BUG] Saved request metrics lose their cache optimization fields (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4584">#4584</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/b4c9bdf100d97fb038beba95de6d4ad6a8786090">b4c9bdf</a>)</li>
<li>[BUG] Volatile SQLite metrics stores lose their schema before the
first save (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4633">#4633</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d8ff0fe9d2cb2477f6662a90f8fcd7e030a52666">d8ff0fe</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/headroomlabs-ai/headroom/blob/main/CHANGELOG.md">headroom-ai's
changelog</a>.</em></p>
<blockquote>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1">0.43.1</a>
(2026-11-05)</h2>
<h3>Bug Fixes</h3>
<ul>
<li><strong>ccr:</strong> keep the in-memory order queue from evicting
re-stored entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4545">#4545</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d">c6f5bf9</a>)</li>
<li><strong>memory:</strong> read the relation key the memory_save
schema advertises (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4647">#4647</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92">7592e68</a>)</li>
<li><strong>memory:</strong> replace the HNSW vector when a memory is
re-indexed (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4649">#4649</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf">ee638f9</a>)</li>
<li><strong>openclaw:</strong> accept 12-character hashes in
headroom_retrieve (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4640">#4640</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a">8d3e9e5</a>)</li>
<li><strong>ort:</strong> avoid implicit runtime discovery from the
workspace (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4570">#4570</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55">69fbd23</a>)</li>
<li><strong>proxy:</strong> bound the model-keyed tokenizer, beacon and
litellm caches (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4497">#4497</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0">e51b806</a>)</li>
<li><strong>proxy:</strong> use HTTP/1.1 client for ChatGPT streaming
and model metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4006">#4006</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2">e1becdf</a>)</li>
<li><strong>release:</strong> normalize damaged release PR envelopes
before detection (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4664">#4664</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd">917edc6</a>)</li>
<li><strong>router:</strong> keep tagged blocks out of the lossy
size-gate fallback (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4543">#4543</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d">f333edf</a>)</li>
<li><strong>router:</strong> log the ONNX fallbacks at info instead of
warning (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4535">#4535</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f">db30d82</a>)</li>
</ul>
<h3>Dependencies</h3>
<ul>
<li>bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4662">#4662</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7">8f104f8</a>)</li>
</ul>
<h2><a
href="https://github.com/headroomlabs-ai/headroom/compare/v0.42.0...v0.43.0">0.43.0</a>
(2026-11-05)</h2>
<h3>⚠ BREAKING CHANGES</h3>
<ul>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)</li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>ccr:</strong> answer headroom_retrieve on streaming chat
completions (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4631">#4631</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/31dcaf41f7fafaebec0838a05ff328da456faef0">31dcaf4</a>)</li>
<li><strong>mcp:</strong> port MCP servers to SDK 2.x (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4603">#4603</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/ee2252a3155c87e948c8893b79af5824eb30e64c">ee2252a</a>)</li>
<li><strong>plugins:</strong> headroom skill for Claude Code, Codex,
Copilot and skills.sh (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4533">#4533</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/66e14676827366c2bf8d15e252f8766cb27b1a98">66e1467</a>)</li>
<li><strong>savings:</strong> show the proxy's model-routing savings in
headroom savings (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4304">#4304</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/aaab338b64cb55929de904411db65db126e22ec0">aaab338</a>)</li>
</ul>
<h3>Bug Fixes</h3>
<ul>
<li>[BUG] A timeout in one image compression call resets the shared
worker pool and affects concurrent requests (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4528">#4528</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/e9bcfe73fadf69f0b27b7bc338ea7d2380931054">e9bcfe7</a>)</li>
<li>[BUG] DirectMem0Adapter.search_memories calls removed mem0 search
API (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4518">#4518</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d9cee452681c79d6f13919e9e651e88a774c0874">d9cee45</a>)</li>
<li>[BUG] Saved request metrics lose their cache optimization fields (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4584">#4584</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/b4c9bdf100d97fb038beba95de6d4ad6a8786090">b4c9bdf</a>)</li>
<li>[BUG] Volatile SQLite metrics stores lose their schema before the
first save (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4633">#4633</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/d8ff0fe9d2cb2477f6662a90f8fcd7e030a52666">d8ff0fe</a>)</li>
<li>Add info about apply to README.md (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/1592">#1592</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/4d34680c34ad379d693820869e77d4a2a6be2cdf">4d34680</a>)</li>
<li><strong>backends/litellm:</strong> keep cache_control on text blocks
for Bedrock prompt caching (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4565">#4565</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/23a5bb1c81dc943398f9271f068a02487207f2e7">23a5bb1</a>)</li>
<li><strong>backends:</strong> forward the standard service_tier param
(litellm + anyllm) (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/2468">#2468</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/62cc38a6b09dbcf723681a0ff56acd02131ad1f1">62cc38a</a>)</li>
<li><strong>cache:</strong> build semantic entry before evicting so a
failed embedding keeps live entries (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4581">#4581</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/0d4c450d774691568b850f0d22ce17e087405281">0d4c450</a>)</li>
<li><strong>cache:</strong> count a tool_result with no text as
replayable in the frozen prefix (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4523">#4523</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/fba09f674c8a9c91b39a563a70ab7727b44d1dbc">fba09f6</a>)</li>
<li><strong>cache:</strong> fail closed on SQLite corruption instead of
deleting the store online (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4361">#4361</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/98018333f997783487af15efe4d9e631ecd85939">9801833</a>)</li>
<li><strong>cache:</strong> invalidate configured registry instances on
replacement (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4363">#4363</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/1bcdca2d9dd279f49aa4276d523d93c2cfeb5a51">1bcdca2</a>)</li>
<li><strong>cache:</strong> namespace SemanticCacheLayer by provider,
model and metadata (<a
href="https://redirect.github.com/headroomlabs-ai/headroom/issues/4473">#4473</a>)
(<a
href="https://github.com/headroomlabs-ai/headroom/commit/99cdaaf1c7de2bd81a8e64f198462fd1ceec3a17">99cdaaf</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/2d3ee51846435ef5b320eea4806af14e602b0d8c"><code>2d3ee51</code></a>
chore: release 0.43.1 (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4661">#4661</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7"><code>8f104f8</code></a>
deps: bump the npm-minor-patch group across 3 directories with 6 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4662">#4662</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/81fa4bdda613f6a37f6f430eda9f728e1458f3ce"><code>81fa4bd</code></a>
chore: release 0.43.0 (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4643">#4643</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/a26faaeee34ecfde57608aea4a1ec7ea2b33272f"><code>a26faae</code></a>
fix(sdk): carry Vercel AI SDK reasoning parts and provider options
through co...</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/e666fd8e35dbe7c0433739297873b6a0a51c26cf"><code>e666fd8</code></a>
deps: Bump tsup from 8.5.1 to 9.0.0 in /sdk/typescript (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4386">#4386</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/74277d47ecfbca349ddb99f81094c4dd30539d43"><code>74277d4</code></a>
deps: Bump <code>@​anthropic-ai/sdk</code> from 0.133.0 to 1.3.0 in
/sdk/typescript (<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4554">#4554</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/5e4827de12c9fdf33d7d36b1939eee73a18fe6c5"><code>5e4827d</code></a>
deps: Bump the npm-minor-patch group across 1 directory with 6 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4621">#4621</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/cd5e2b9e73eb8bd783ab872bdda71263b941e2d3"><code>cd5e2b9</code></a>
fix(sdk): send Anthropic messages to /v1/compress natively so thinking
blocks...</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/6c3d7475077b2e09e8cff5ba2352bda4064d86d3"><code>6c3d747</code></a>
chore(sdk-typescript): npm metadata and the proxy requirement up front
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4536">#4536</a>)</li>
<li><a
href="https://github.com/headroomlabs-ai/headroom/commit/f36772805178e3fed1a95313e8211c57a291b953"><code>f367728</code></a>
deps: Bump the npm-minor-patch group across 3 directories with 9 updates
(<a
href="https://github.com/headroomlabs-ai/headroom/tree/HEAD/sdk/typescript/issues/4495">#4495</a>)</li>
<li>See full diff in <a
href="https://github.com/headroomlabs-ai/headroom/commits/v0.43.1/sdk/typescript">compare
view</a></li>
</ul>
</details>
<br />

Updates `effect` from 4.0.0-beta.103 to 4.1.2
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/Effect-TS/effect/releases">effect's
releases</a>.</em></p>
<blockquote>
<h2>effect@4.1.2</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10217">#10217</a>
<a
href="https://github.com/Effect-TS/effect/commit/52166841177ca39d32cc4c06ac5fcdd660656748"><code>5216684</code></a>
Thanks <a
href="https://github.com/devangpratap"><code>@​devangpratap</code></a>!
- Fix <code>ByteSize</code> decimal unit constructors such as
<code>megabytes(2.01)</code> throwing or returning the wrong byte count,
and reject fractional-byte quantities instead of rounding them.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10261">#10261</a>
<a
href="https://github.com/Effect-TS/effect/commit/b707ad1bce3cbf1613fd97622901d7e81e2a34c7"><code>b707ad1</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix cluster entity defect restart backoff being shared by all entities
of a type and never resetting.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10249">#10249</a>
<a
href="https://github.com/Effect-TS/effect/commit/46f48afc88b4b4df3cc1c470ae01f31cc7f8d77c"><code>46f48af</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Prevent an interrupted cluster request that keeps defecting from
stalling message delivery to other entities.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10218">#10218</a>
<a
href="https://github.com/Effect-TS/effect/commit/92201bcd47f1789590ff884542051e2123fdb529"><code>92201bc</code></a>
Thanks <a href="https://github.com/sbking"><code>@​sbking</code></a>! -
Defer the runner notification for a discarded persisted send made inside
a <code>ClusterSchema.WithTransaction</code> handler until the
transaction commits. The message was invisible to the runner before the
commit, so delivery waited for the next storage poll.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10260">#10260</a>
<a
href="https://github.com/Effect-TS/effect/commit/cf329f3b694ba8659946ee74dbbb6cdb6e5535de"><code>cf329f3</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>ClusterWorkflowEngine</code> turning transient storage
failures while saving durable clocks or deferred completions into
workflow defects; they are now retried.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10262">#10262</a>
<a
href="https://github.com/Effect-TS/effect/commit/1d25d78d9639e2725f4ea8d056a77b3bde9afd78"><code>1d25d78</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>ClusterWorkflowEngine</code> blocking shard reacquisition
indefinitely after a forced shard release interrupted a workflow resume
waiting on its active run.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10226">#10226</a>
<a
href="https://github.com/Effect-TS/effect/commit/d190d973a7fb2ebb71bfaf1a01adbffef1833555"><code>d190d97</code></a>
Thanks <a
href="https://github.com/tim-smart"><code>@​tim-smart</code></a>! - Fix
<code>ClusterWorkflowEngine</code> letting a runner that lost its shard
delete a newer activity result, which could run the activity again and
change the workflow's history.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10241">#10241</a>
<a
href="https://github.com/Effect-TS/effect/commit/d7b3b6bd6be4d96babda9d191538fe25c7124f44"><code>d7b3b6b</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
<code>HttpClient.withCookiesRef</code> not sending cookies when the
request URL is completed after it, for example by the
<code>baseUrl</code> of <code>HttpApiClient</code>. Cookies are now
selected for the final URL of each request, including redirect hops.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10211">#10211</a>
<a
href="https://github.com/Effect-TS/effect/commit/a4787453be8e4f360f0212fb0b25bc4a0e18fc72"><code>a478745</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Keep <code>EventLogServer</code> session auth challenges on their RPC
connection, so a challenge is released when its client disconnects
instead of being retained by the server after an unauthenticated
disconnect.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10221">#10221</a>
<a
href="https://github.com/Effect-TS/effect/commit/69eaa29dfe5c33547ad12068f65d31b2123194c3"><code>69eaa29</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Iterable.filterMapWhile</code> iterators yielding values or
pulling from the source after they have returned <code>done</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10233">#10233</a>
<a
href="https://github.com/Effect-TS/effect/commit/3711ba65343a0932840478aa758a2612be0327a7"><code>3711ba6</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Iterable.unfold</code> iterators calling the generating
function again after they have returned <code>done</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/9972">#9972</a>
<a
href="https://github.com/Effect-TS/effect/commit/715c5e4b4528889be2ce30163b130d422e7ab68f"><code>715c5e4</code></a>
Thanks <a
href="https://github.com/eugene1g"><code>@​eugene1g</code></a>! - Add
<code>Json5.parse</code> and <code>Jsonc.parse</code> to
<code>effect/encoding</code>, returning a <code>Result</code> that fails
with an <code>EncodingError</code> on invalid input.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10257">#10257</a>
<a
href="https://github.com/Effect-TS/effect/commit/b0a1ceebcd053d73dbd4fdf836c4d3471dc18f3c"><code>b0a1cee</code></a>
Thanks <a
href="https://github.com/tim-smart"><code>@​tim-smart</code></a>! - Use
a <code>ClientCapabilities</code> instance for the fallback MCP client
profile in <code>McpServer</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10242">#10242</a>
<a
href="https://github.com/Effect-TS/effect/commit/2a10622e906caccd7a9b4a90d1aaef090e8e00cc"><code>2a10622</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
<code>McpServer</code> running middleware provided outside a combined
middleware inside it.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10243">#10243</a>
<a
href="https://github.com/Effect-TS/effect/commit/6bccdd54e1bc5d7f182972811d6827d1ad10f1aa"><code>6bccdd5</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Encode
declared <code>McpServer</code> tool failures with their JSON codec, so
values such as <code>bigint</code>, <code>Map</code> and
<code>Option</code> no longer cause an internal error or lossy
output</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10244">#10244</a>
<a
href="https://github.com/Effect-TS/effect/commit/60be01136a530ec10d8b67efc812eee94804444c"><code>60be011</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
2026-07-28 MCP listings failing for resources, resource templates and
prompts registered as plain objects.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10235">#10235</a>
<a
href="https://github.com/Effect-TS/effect/commit/e1edcdc8d60bef515a2c5fa97706d4baaf0c0290"><code>e1edcdc</code></a>
Thanks <a
href="https://github.com/schutzelaars"><code>@​schutzelaars</code></a>!
- Stop OTLP log and trace exporters from keeping a timer pending while
idle. A Node program kept alive only by an idle exporter now exits.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10210">#10210</a>
<a
href="https://github.com/Effect-TS/effect/commit/ef81e9dbd1221ab8a9c38ce50f96129054e3b6e2"><code>ef81e9d</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>RateLimiter.layerStoreRedis</code> sharing state between
different keys. A key ending in <code>:refill</code> or
<code>:adaptive</code> no longer reads or writes another key's
token-bucket refill time or adaptive state.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10223">#10223</a>
<a
href="https://github.com/Effect-TS/effect/commit/013fb34f88f3451ede7e7333f205563f07716b13"><code>013fb34</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>RpcServer</code> returning an empty HTTP 500 for requests with
malformed headers; such requests now fail with a defect
<code>Exit</code>, and malformed notifications are dropped.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10251">#10251</a>
<a
href="https://github.com/Effect-TS/effect/commit/113dbc74b259b7e56e618a506dc67e85794c36ed"><code>113dbc7</code></a>
Thanks <a href="https://github.com/wmaurer"><code>@​wmaurer</code></a>!
- Fix <code>Schedule.fixed</code>, <code>Schedule.windowed</code> and
<code>Schedule.cron</code> returning a zero delay when the clock is a
fraction of a nanosecond before the next run.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10230">#10230</a>
<a
href="https://github.com/Effect-TS/effect/commit/519d66eb5972ef3c801fb164dd652f25a71e0511"><code>519d66e</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Add <code>SchemaBinary.int32</code>, <code>uint32</code>,
<code>int64</code> and <code>uint64</code>, opt-in schemas that write
integers as fixed-width little-endian payloads. The 32-bit schemas
decode to <code>number</code> and the 64-bit schemas to
<code>bigint</code>. Out-of-range and non-integer values are rejected
instead of wrapped.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10213">#10213</a>
<a
href="https://github.com/Effect-TS/effect/commit/e7a6ea43fe8ac77f68329b84d26dc2d1e136d745"><code>e7a6ea4</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
SQL transactions now trace <code>BEGIN</code>, <code>COMMIT</code>,
<code>ROLLBACK</code> and savepoint statements as child spans of
<code>sql.transaction</code>, replacing its
<code>effect.sql.transaction.commit</code>, <code>savepoint</code> and
<code>rollback</code> events; with
<code>Statement.SpanPropagationEnabled</code>, the transaction also
parents connection spans and records its connection wait time.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10240">#10240</a>
<a
href="https://github.com/Effect-TS/effect/commit/019f35e0a7ebe050eae01d68cc14ae63158fd8e4"><code>019f35e</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Stream.groupAdjacentBy</code> dropping its last group when
the stream fails. The group is now emitted before the error.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10278">#10278</a>
<a
href="https://github.com/Effect-TS/effect/commit/2a0d16cd1ff63a69baf5d19a13dc2051b500150c"><code>2a0d16c</code></a>
Thanks <a
href="https://github.com/tim-smart"><code>@​tim-smart</code></a>! - Fix
<code>AnthropicStructuredOutput.toCodecAnthropic</code>,
<code>OpenAiStructuredOutput.toCodecOpenAI</code>, and MCP tool schemas
returning or rejecting a root <code>$ref</code> when the schema is an
identified alias of another identified schema.</p>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/Effect-TS/effect/blob/main/packages/effect/CHANGELOG.md">effect's
changelog</a>.</em></p>
<blockquote>
<h2>4.1.2</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10217">#10217</a>
<a
href="https://github.com/Effect-TS/effect/commit/52166841177ca39d32cc4c06ac5fcdd660656748"><code>5216684</code></a>
Thanks <a
href="https://github.com/devangpratap"><code>@​devangpratap</code></a>!
- Fix <code>ByteSize</code> decimal unit constructors such as
<code>megabytes(2.01)</code> throwing or returning the wrong byte count,
and reject fractional-byte quantities instead of rounding them.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10261">#10261</a>
<a
href="https://github.com/Effect-TS/effect/commit/b707ad1bce3cbf1613fd97622901d7e81e2a34c7"><code>b707ad1</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix cluster entity defect restart backoff being shared by all entities
of a type and never resetting.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10249">#10249</a>
<a
href="https://github.com/Effect-TS/effect/commit/46f48afc88b4b4df3cc1c470ae01f31cc7f8d77c"><code>46f48af</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Prevent an interrupted cluster request that keeps defecting from
stalling message delivery to other entities.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10218">#10218</a>
<a
href="https://github.com/Effect-TS/effect/commit/92201bcd47f1789590ff884542051e2123fdb529"><code>92201bc</code></a>
Thanks <a href="https://github.com/sbking"><code>@​sbking</code></a>! -
Defer the runner notification for a discarded persisted send made inside
a <code>ClusterSchema.WithTransaction</code> handler until the
transaction commits. The message was invisible to the runner before the
commit, so delivery waited for the next storage poll.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10260">#10260</a>
<a
href="https://github.com/Effect-TS/effect/commit/cf329f3b694ba8659946ee74dbbb6cdb6e5535de"><code>cf329f3</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>ClusterWorkflowEngine</code> turning transient storage
failures while saving durable clocks or deferred completions into
workflow defects; they are now retried.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10262">#10262</a>
<a
href="https://github.com/Effect-TS/effect/commit/1d25d78d9639e2725f4ea8d056a77b3bde9afd78"><code>1d25d78</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>ClusterWorkflowEngine</code> blocking shard reacquisition
indefinitely after a forced shard release interrupted a workflow resume
waiting on its active run.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10226">#10226</a>
<a
href="https://github.com/Effect-TS/effect/commit/d190d973a7fb2ebb71bfaf1a01adbffef1833555"><code>d190d97</code></a>
Thanks <a
href="https://github.com/tim-smart"><code>@​tim-smart</code></a>! - Fix
<code>ClusterWorkflowEngine</code> letting a runner that lost its shard
delete a newer activity result, which could run the activity again and
change the workflow's history.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10241">#10241</a>
<a
href="https://github.com/Effect-TS/effect/commit/d7b3b6bd6be4d96babda9d191538fe25c7124f44"><code>d7b3b6b</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
<code>HttpClient.withCookiesRef</code> not sending cookies when the
request URL is completed after it, for example by the
<code>baseUrl</code> of <code>HttpApiClient</code>. Cookies are now
selected for the final URL of each request, including redirect hops.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10211">#10211</a>
<a
href="https://github.com/Effect-TS/effect/commit/a4787453be8e4f360f0212fb0b25bc4a0e18fc72"><code>a478745</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Keep <code>EventLogServer</code> session auth challenges on their RPC
connection, so a challenge is released when its client disconnects
instead of being retained by the server after an unauthenticated
disconnect.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10221">#10221</a>
<a
href="https://github.com/Effect-TS/effect/commit/69eaa29dfe5c33547ad12068f65d31b2123194c3"><code>69eaa29</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Iterable.filterMapWhile</code> iterators yielding values or
pulling from the source after they have returned <code>done</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10233">#10233</a>
<a
href="https://github.com/Effect-TS/effect/commit/3711ba65343a0932840478aa758a2612be0327a7"><code>3711ba6</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Iterable.unfold</code> iterators calling the generating
function again after they have returned <code>done</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/9972">#9972</a>
<a
href="https://github.com/Effect-TS/effect/commit/715c5e4b4528889be2ce30163b130d422e7ab68f"><code>715c5e4</code></a>
Thanks <a
href="https://github.com/eugene1g"><code>@​eugene1g</code></a>! - Add
<code>Json5.parse</code> and <code>Jsonc.parse</code> to
<code>effect/encoding</code>, returning a <code>Result</code> that fails
with an <code>EncodingError</code> on invalid input.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10257">#10257</a>
<a
href="https://github.com/Effect-TS/effect/commit/b0a1ceebcd053d73dbd4fdf836c4d3471dc18f3c"><code>b0a1cee</code></a>
Thanks <a
href="https://github.com/tim-smart"><code>@​tim-smart</code></a>! - Use
a <code>ClientCapabilities</code> instance for the fallback MCP client
profile in <code>McpServer</code>.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10242">#10242</a>
<a
href="https://github.com/Effect-TS/effect/commit/2a10622e906caccd7a9b4a90d1aaef090e8e00cc"><code>2a10622</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
<code>McpServer</code> running middleware provided outside a combined
middleware inside it.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10243">#10243</a>
<a
href="https://github.com/Effect-TS/effect/commit/6bccdd54e1bc5d7f182972811d6827d1ad10f1aa"><code>6bccdd5</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Encode
declared <code>McpServer</code> tool failures with their JSON codec, so
values such as <code>bigint</code>, <code>Map</code> and
<code>Option</code> no longer cause an internal error or lossy
output</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10244">#10244</a>
<a
href="https://github.com/Effect-TS/effect/commit/60be01136a530ec10d8b67efc812eee94804444c"><code>60be011</code></a>
Thanks <a
href="https://github.com/Marve10s"><code>@​Marve10s</code></a>! - Fix
2026-07-28 MCP listings failing for resources, resource templates and
prompts registered as plain objects.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10235">#10235</a>
<a
href="https://github.com/Effect-TS/effect/commit/e1edcdc8d60bef515a2c5fa97706d4baaf0c0290"><code>e1edcdc</code></a>
Thanks <a
href="https://github.com/schutzelaars"><code>@​schutzelaars</code></a>!
- Stop OTLP log and trace exporters from keeping a timer pending while
idle. A Node program kept alive only by an idle exporter now exits.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10210">#10210</a>
<a
href="https://github.com/Effect-TS/effect/commit/ef81e9dbd1221ab8a9c38ce50f96129054e3b6e2"><code>ef81e9d</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>RateLimiter.layerStoreRedis</code> sharing state between
different keys. A key ending in <code>:refill</code> or
<code>:adaptive</code> no longer reads or writes another key's
token-bucket refill time or adaptive state.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10223">#10223</a>
<a
href="https://github.com/Effect-TS/effect/commit/013fb34f88f3451ede7e7333f205563f07716b13"><code>013fb34</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Fix <code>RpcServer</code> returning an empty HTTP 500 for requests with
malformed headers; such requests now fail with a defect
<code>Exit</code>, and malformed notifications are dropped.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10251">#10251</a>
<a
href="https://github.com/Effect-TS/effect/commit/113dbc74b259b7e56e618a506dc67e85794c36ed"><code>113dbc7</code></a>
Thanks <a href="https://github.com/wmaurer"><code>@​wmaurer</code></a>!
- Fix <code>Schedule.fixed</code>, <code>Schedule.windowed</code> and
<code>Schedule.cron</code> returning a zero delay when the clock is a
fraction of a nanosecond before the next run.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10230">#10230</a>
<a
href="https://github.com/Effect-TS/effect/commit/519d66eb5972ef3c801fb164dd652f25a71e0511"><code>519d66e</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
Add <code>SchemaBinary.int32</code>, <code>uint32</code>,
<code>int64</code> and <code>uint64</code>, opt-in schemas that write
integers as fixed-width little-endian payloads. The 32-bit schemas
decode to <code>number</code> and the 64-bit schemas to
<code>bigint</code>. Out-of-range and non-integer values are rejected
instead of wrapped.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10213">#10213</a>
<a
href="https://github.com/Effect-TS/effect/commit/e7a6ea43fe8ac77f68329b84d26dc2d1e136d745"><code>e7a6ea4</code></a>
Thanks <a
href="https://github.com/effect-bot"><code>@​effect-bot</code></a>! -
SQL transactions now trace <code>BEGIN</code>, <code>COMMIT</code>,
<code>ROLLBACK</code> and savepoint statements as child spans of
<code>sql.transaction</code>, replacing its
<code>effect.sql.transaction.commit</code>, <code>savepoint</code> and
<code>rollback</code> events; with
<code>Statement.SpanPropagationEnabled</code>, the transaction also
parents connection spans and records its connection wait time.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/Effect-TS/effect/pull/10240">#10240</a>
<a
href="https://github.com/Effect-TS/effect/commit/019f35e0a7ebe050eae01d68cc14ae63158fd8e4"><code>019f35e</code></a>
Thanks <a href="https://github.com/clean99"><code>@​clean99</code></a>!
- Fix <code>Stream.groupAdjacentBy</code> dropping its last group when
the stream fails. The group is now emitted before the error.</p>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/Effect-TS/effect/commit/506eef143bcc1750ce58920aac1e45da7265d103"><code>506eef1</code></a>
Version Packages (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10212">#10212</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/b0a1ceebcd053d73dbd4fdf836c4d3471dc18f3c"><code>b0a1cee</code></a>
Update repository dependencies (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10257">#10257</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/2a4ce2e3638e5543f1355ae671bcb20e00f45ffe"><code>2a4ce2e</code></a>
Make load-sensitive Data, sql-d1 and sqlite-node tests robust under load
(<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10">#10</a>...</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/e5b1bcfa48a9e4d0d78de255f5ff3b0a7e2e9727"><code>e5b1bcf</code></a>
Consolidate redundant Data, Chunk.getUnsafe and Metric.track tests (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10280">#10280</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/4a4491d60c9db1cf43a2346fc49329961512f849"><code>4a4491d</code></a>
Fix flaky DurableDeferred.raceAll unprocessed-result replay test (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10265">#10265</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/7a0da6300449d4806a25cbd1dde86dc1ef3cf300"><code>7a0da63</code></a>
Report the stuck step when an McpServer list change test hangs (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10275">#10275</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/2a0d16cd1ff63a69baf5d19a13dc2051b500150c"><code>2a0d16c</code></a>
Follow chained root references in structured-output schema conversion
(<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10278">#10278</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/e1edcdc8d60bef515a2c5fa97706d4baaf0c0290"><code>e1edcdc</code></a>
Stop idle OTLP log and trace exporters from keeping a timer pending (<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10235">#10235</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/cf329f3b694ba8659946ee74dbbb6cdb6e5535de"><code>cf329f3</code></a>
Retry transient persistence failures for durable clocks and deferreds
(<a
href="https://github.com/Effect-TS/effect/tree/HEAD/packages/effect/issues/10260">#10260</a>)</li>
<li><a
href="https://github.com/Effect-TS/effect/commit/46f48afc88b4b4df3cc1c470ae01f31cc7f8d77c"><code>46f48af</code></a>
Prevent interrupted defecting cluster requests from stalling other
entities (...</li>
<li>Additional commits viewable in <a
href="https://github.com/Effect-TS/effect/commits/effect@4.1.2/packages/effect">compare
view</a></li>
</ul>
</details>
<br />

Updates `@opencode/plugin` from 2.2.5 to 2.2.6
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/anomalyco/opencode/releases">@​opencode/plugin's
releases</a>.</em></p>
<blockquote>
<h2>v2.2.6</h2>
<h3>Highlights</h3>
<ul>
<li><strong>Shared MCP Connections</strong>: Turn on pooling for an MCP
server to share one connection across projects with the same setup, so
you run fewer processes and start faster. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/61185">#61185</a>)</li>
<li><strong>GUI Plugin Themes and New Slots</strong>: GUI plugins can
now add color themes, render or add actions to code blocks, and use
native settings and menu components. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/61485">#61485</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/61533">#61533</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/61527">#61527</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/61509">#61509</a>)</li>
<li><strong>Mobile Composer Dock</strong>: On phones and tablets,
composer actions now sit in a touch dock above the keyboard with larger
buttons. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/61773">#61773</a>)</li>
<li><strong>S...

_Description has been truncated_

## Real Behavior Proof

- Fix pushed: migrated `dependency-compat.test.ts` to `effect/cli`
`Primitive.FileParse` (module path change in Effect 4.x).
- Observed: `bun run typecheck` clean; plugin suite 96/96 pass incl. the
compat test (3/3).
- Assessment of `toml@0.0.5`: not imported by repo code — the compat
test exercises Effect's own TOML parsing, so the dep can be dropped in a
follow-up if confirmed unused.
- Not tested: other plugins' Effect API surface (only the opencode
plugin touches effect/cli).

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-14 13:32:34 -06:00
02dfdd8f89 fix(oauth2): stop following redirects from the token endpoint (#4849)
## Description

`OAuth2ClientCredentials._mint` (headroom-oauth2 extension) used plain
`urllib.request.urlopen`. For the token POST, urllib follows a
301/302/303 as a GET to the `Location` URL. It re-sends the request
headers, including `Authorization: Basic <client_id:client_secret>` when
`auth_style="basic"`, and then uses whatever `access_token` that host
returns as the upstream bearer. The https/loopback check only looks at
the configured `token_url`, not at a redirect target.

The token request now goes through an opener whose redirect handler does
not follow redirects. A 30x becomes an `HTTPError`, which the existing
handler turns into `OAuth2Error("token endpoint returned HTTP 30x")`.
The response body is still drained and never surfaced. 307/308 on a POST
already raised before. Standard library only; no new dependency.

Behaviour change for users: a token endpoint that answers with a
redirect now fails to mint, and the error names the status code. Set
`HEADROOM_OAUTH2_TOKEN_URL` to the final URL instead.

Fix adapted from a proposal by HetCreep.

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)

## Changes Made

- `plugins/headroom-oauth2/src/headroom_oauth2/provider.py`: adds
`_RefuseRedirect` (an `HTTPRedirectHandler` whose `redirect_request`
returns `None`) and `_open()`. `_mint` calls `_open()`. The opener is
built per mint, so proxy env vars are read at call time, as with
`urlopen`.
- `plugins/headroom-oauth2/tests/test_oauth2.py`: parametrised test over
301/302/303/307/308 × basic/post with real local HTTP servers. Each case
checks that minting raises, that the redirect target is never contacted,
and that nothing is cached. The existing drain-failure test now patches
`_open`.

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`). The plugin is outside
`mypy headroom`. Run on the file directly, it reports only the 2
untyped-def errors already on main (`__init__`, `_mint`); the new code
is fully annotated.
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
# plugin tests against origin/main (c21b0813)
$ cd plugins/headroom-oauth2 && PYTHONPATH=src pytest tests
FAILED tests/test_oauth2.py::test_error_body_drain_failure_is_sanitized   (patch target _open does not exist on main)
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[basic-301]
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[basic-302]
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[basic-303]
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[post-301]
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[post-302]
FAILED tests/test_oauth2.py::test_token_endpoint_redirect_is_not_followed[post-303]
======================== 7 failed, 75 passed in 22.78s =========================

# this branch
$ cd plugins/headroom-oauth2 && PYTHONPATH=src pytest tests
============================= 82 passed in 32.65s ==============================
$ ruff check src tests && ruff format --check src tests (0.17.3): All checks passed!
```

## Real Behavior Proof

- Environment: macOS, Python 3.12. Two local `http.server` listeners: a
token endpoint that answers POST with `302 Location:
http://127.0.0.1:<other>/collect`, and a second server that records
requests and returns `{"access_token": "FROM-COLLECTOR"}`.
- Exact command / steps: `OAuth2ClientCredentials(token_url=<first>,
client_id="demo-id", client_secret="demo-secret",
auth_style=...).token()` for `basic` and `post`.
- Observed result:
```text
origin/main:
basic token(): FROM-COLLECTOR | second server saw: [('GET', '/collect', 'Basic ZGVtby1pZDpkZW1vLXNlY3JldA==')]
post  token(): FROM-COLLECTOR | second server saw: [('GET', '/collect', None)]
this branch:
basic token(): raised OAuth2Error: token endpoint returned HTTP 302 | second server saw: []
post  token(): raised OAuth2Error: token endpoint returned HTTP 302 | second server saw: []
```
- Not tested: a real IdP.

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: n/a
- Stable/default behavior changed: see Description
- Kill switch / disable path: none needed
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert this PR

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] 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

No CI workflow runs the headroom-oauth2 plugin tests; they were run
locally as shown. The plugin version and its CHANGELOG are unchanged; a
maintainer may want to bump to 0.2.1 at release.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4849"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-14 10:45:53 +05:30
Tejas ChopraandClaude Opus 5.5 df9eefd4f0 fix(plugins): keep the hook launcher's Python fallback off the project dir
When no headroom executable is found, headroom-hook.sh falls back to
`python -c 'import headroom'` and `python -m headroom.cli`, both of
which put the current directory (the opened project) first on sys.path.
A headroom/ directory in the project was imported instead of the
installed package. Both calls now pass -P (Python 3.11+), so only an
installed headroom is used; older interpreters reject -P and are skipped.

Assay-Kind: bugfix
Assay-Ask: The agent-hooks launcher's Python fallback imported a headroom package from the opened
 project's directory instead of the installed one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 13:29:34 -08:00
9f2cc01786 fix(opencode): keep child process options when the args slot is null or undefined (#4748)
## Description

Part of #4744

The OpenCode transport wraps `spawn`, `fork`, `exec` and `execFile` to
inject an `env`. It guessed the options index with
`Array.isArray(args[1]) ? 2 : 1` and spliced the injected object in
whenever that slot was not an object. For `spawn(cmd, undefined, { cwd
})` and `fork(mod, null, opts)` the injected object landed in Node's
args slot, Node read it as the options, and the caller's `cwd`, `stdio`
and `shell` were lost. For `exec(cmd, undefined, cb)` and
`execFile(file, args, null, cb)` the callback ended up past the last
parameter Node reads and was never called. Both shapes are valid Node
signatures.

This PR finds the options slot after an omitted, undefined or null
`args`, and replaces an undefined or null options slot instead of
inserting beside it. Plain argument shapes are unchanged.

## Type of Change

- [x] 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

- `plugins/opencode/src/transport.ts`: new `optionsIndexAfterArgs` used
by the `spawn`, `execFile` and `fork` wrappers (`exec` has no args slot
and keeps index 1). `injectOptionsEnv` replaces an undefined or null
slot that is inside the argument list instead of inserting next to it.
- `plugins/opencode/src/transport.test.ts`: a `describe` block that
starts real children (a small script that prints its `cwd` and the
injected proxy variable): `spawn`/`fork` with `undefined` and `null`
args and a `cwd`, `exec`/`execFile` with `undefined` and `null` options
and a callback, `execFile(file, null, cb)`, and eight plain shapes that
must keep working. The block restores the real `child_process` functions
before each test, because an earlier test in the file ("skips the shim
preload...") restores `spawn` before it calls
`uninstallHeadroomTransport()`, which puts its mock back; that left
`child_process.spawn` mocked for the rest of the file. I did not change
that test.

## Testing

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [ ] Manual testing performed

This is a TypeScript change in `plugins/opencode`, so the Python checks
above do not apply. The package's own checks were run instead: `vitest
run` and `tsc --noEmit` (`node node_modules/@typescript/native/bin/tsc
--noEmit`, no output). The package has no lint or format script and the
root ruff config covers Python only, so none was run.

### Test Output

Fail before (`transport.ts`, `plugin.ts`, `retrieve.ts` from
`origin/main` `1da8930a`, new tests kept; `npx vitest run` in
`plugins/opencode`, Ubuntu on WSL2, Node v24.22.2):

```text
FAIL spawn(cmd, undefined, { cwd }) keeps cwd and still injects the env     Error: spawn "<node>" "<probe.cjs>" ENOENT
FAIL spawn(cmd, null, { cwd }) keeps cwd and still injects the env          Error: spawn "<node>" "<probe.cjs>" ENOENT
FAIL fork(module, undefined, { cwd }) keeps cwd and still injects the env   Error: child printed ""
FAIL fork(module, null, { cwd }) keeps cwd and still injects the env        Error: child printed ""
FAIL exec(cmd, undefined, callback) still calls the callback                Error: callback was never called
FAIL exec(cmd, null, callback) still calls the callback                     Error: callback was never called
FAIL execFile(file, args, undefined, callback) still calls the callback     Error: callback was never called
FAIL execFile(file, args, null, callback) still calls the callback          Error: callback was never called
FAIL execFile(file, null, callback) and execFile(file, callback) ...        Error: callback was never called
 Test Files  1 failed | 3 passed (4)
      Tests  9 failed | 74 passed (83)
```

Pass after (this branch):

```text
 Test Files  4 passed (4)
      Tests  83 passed (83)
```

## Real Behavior Proof

- Environment: Ubuntu on WSL2 (Windows 11 host), Node v24.22.2, vitest
and TypeScript from `plugins/opencode/package-lock.json` (`npm ci
--ignore-scripts`), real child processes, no network.
- Exact command / steps: `npx vitest run` in `plugins/opencode`. Each
new test installs the transport (shim preload off, as a checkout has no
`dist/`), makes the call in its title with a probe script that prints
`process.cwd()` and `HEADROOM_OPENCODE_TRANSPORT_PROXY_URL`, and checks
the cwd and the env or that the callback fires.
- Observed result: see Test Output; the nine tests fail on `origin/main`
and the 83 tests of the package pass here.
- Not tested: the real OpenCode host; Windows (the `shell: true` and
quoting path of the test commands was only run on Linux); `fork` with an
`execArgv`/IPC channel in use.

## Runtime Rollout Safety

- Rollout-managed feature(s): none changed.
- Minimum rollout channel: n/a (no new feature)
- Stable/default behavior changed: yes, narrowly: calls with an explicit
`undefined`/`null` args or options now keep their own options (and
`exec`/`execFile` callbacks fire) while the env is still injected. Plain
shapes behave as before.
- Kill switch / disable path: none added.
- Unsafe override required: no
- Qualification impact: none expected.
- Rollback path: revert this commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

- Not in this PR (one topic): the wrapped `exec` and `execFile` lose
`util.promisify.custom`, so `promisify(child_process.exec)(cmd)`
resolves to a string instead of `{ stdout, stderr }`. It is described in
the linked issue.

Produced with AI assistance (Claude Code) operated by me (HetCreep); the
tests and proof above were run on my machine against a clone of the
repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4748"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-12 22:47:09 -06:00
ParideboyandJD Davis c05fbdddc8 fix(proxy): let an extension declare its install() fail-closed (#4737) (#4773)
## Description

`plugins/headroom-oauth2/SPEC.md:67` promised that a missing or invalid
config at
startup makes `install()` raise and the proxy **fail closed** ("won't
start
mis-auth'd"), and its `CHANGELOG.md:25` said "Fails closed on
misconfiguration".

`install()` does raise. But the loader that calls it, `install_all()` in
`headroom/proxy/extensions.py`, wrapped every `install(app, config)` in
`except Exception`, logged a warning, and continued. So with `oauth2`
enabled and
a bad config the proxy started **without** `OAuth2Middleware` — and
since that
middleware is what replaces the client's `Authorization` with the minted
bearer,
the proxy relayed the client's own `Authorization` header upstream
unchanged.
The only signals were a log warning and one stderr line.

Skip-and-continue is the right default and stays the default: an
optional plugin
must not brick the proxy, and a licence-gate failure should leave the
feature
absent rather than fatal. It is the wrong rule for an extension that
*is* the
upstream credential. That is a per-extension property, so the extension
declares
it:

```python
def install(app, config): ...
install.fail_closed = True
```

`install_all` re-raises instead of swallowing when the failing `install`
carries
the marker, so `create_app` raises and the process never serves.
Everything
unmarked keeps today's behaviour exactly, including extensions installed
before
the failing one (none after it run). Reading the marker off the loaded
callable
costs the extension one line and core no per-name allowlist; an older
core that
does not know the marker ignores it and behaves as before — the plugin
documents
that.

Closes #4737

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change
- [ ] Documentation update
- [ ] Performance improvement
- [ ] Code refactoring (no functional changes)

## Changes Made

- `headroom/proxy/extensions.py`: new `fail_closed` marker on the
`install`
callable; `install_all` re-raises a marked extension's failure (chained
from
the original exception) instead of logging and skipping. Module
docstring
gains a "Failing closed" section covering when the marker is
appropriate.
- `headroom/proxy/server.py`: the comment at the `install_all` call site
said the
process never fails on an extension install; it now names the exception.
- `plugins/headroom-oauth2/src/headroom_oauth2/__init__.py`: set
`install.fail_closed = True`, with a comment on why skipping would be
worse
  than not starting.
- `plugins/headroom-oauth2`: `SPEC.md` failure-mode row now matches
reality (plus
a paragraph on the marker and old cores), `README.md` gains a
**Startup** note,
  `CHANGELOG.md` 0.2.0 entry, version bumped in `pyproject.toml` +
  `__version__`.
- `docs/content/docs/oauth2-upstream.mdx`: one line under **Notes**.
- `CHANGELOG.md` is **not** touched — release-please owns it.

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .`)
- [x] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```
$ pytest tests/test_proxy_extensions.py -q
6 passed

$ PYTHONPATH=.:plugins/headroom-oauth2/src pytest plugins/headroom-oauth2/tests/test_oauth2.py -q
41 passed in 10.81s

$ ruff check headroom/proxy/extensions.py headroom/proxy/server.py \
    tests/test_proxy_extensions.py plugins/headroom-oauth2/
All checks passed!

$ ruff format --check <same files>
11 files already formatted

$ mypy headroom   # 19 pre-existing errors in unrelated modules (astgrep, mcp_server,
                  # model_metadata) from this Windows/mypy version; none in extensions.py
```

Both new tests fail without the fix, for the right reason:

```
$ git stash push -- headroom/proxy/extensions.py
$ pytest tests/test_proxy_extensions.py plugins/headroom-oauth2/tests/test_oauth2.py -q
FAILED tests/test_proxy_extensions.py::test_install_all_aborts_startup_when_fail_closed_extension_fails
FAILED plugins/headroom-oauth2/tests/test_oauth2.py::test_install_all_aborts_startup_on_bad_config
2 failed, 45 passed
```

## Real Behavior Proof

- Environment: Windows 11, Python 3.13.11, this PR's branch checked out,
`PYTHONPATH` pointing at the checkout and `plugins/headroom-oauth2/src`
(no
package install needed). No proxy request was sent; the extension's own
`OAuth2Middleware` behaviour is already covered by its existing ASGI
tests.
- Exact command / steps: the reporter's own script shape — real
`install_all`,
real `headroom_oauth2.install`, config from `os.environ`, `discover()`
replaced
  by a one-entry list — plus a second script that goes through the real
  `create_app(ProxyConfig(proxy_extensions=["oauth2"]))`.

  ```python
os.environ["HEADROOM_OAUTH2_TOKEN_URL"] = "http://idp.example.com/token"
  os.environ["HEADROOM_OAUTH2_CLIENT_ID"] = "c"
  os.environ["HEADROOM_OAUTH2_CLIENT_SECRET"] = "s"
  ext.discover = lambda: iter([("oauth2", headroom_oauth2.install)])
  create_app(ProxyConfig(optimize=False, cache_enabled=False,
rate_limit_enabled=False, cost_tracking_enabled=False,
                         proxy_extensions=["oauth2"]))
  ```

- Observed result: `create_app` raises, and with a valid config installs
the
  middleware. After the patch:

  ```
ok misconfigured: create_app raised RuntimeError: proxy extension
'oauth2' failed
      to install and is marked fail_closed, so the proxy will no...
ok valid config: app.user_middleware = ['ActivityMiddleware',
'WebSocketAuthMiddleware',
'BaseHTTPMiddleware', 'RequestBodyLimitMiddleware', 'OAuth2Middleware',
'BaseHTTPMiddleware', 'CORSMiddleware',
'WebSocketProjectPrefixMiddleware']
  ```

  With the plugin's own message preserved as `__cause__`:

  ```
install_all raised: RuntimeError: proxy extension 'oauth2' failed to
install and is
marked fail_closed, so the proxy will not start: headroom-oauth2
misconfigured:
token_url must be https (loopback http allowed for tests; set
allow_insecure=True /
  HEADROOM_OAUTH2_ALLOW_INSECURE=1 to override)
__cause__: RuntimeError headroom-oauth2 misconfigured: token_url must be
https (...)
  proxy would NOT start (create_app raises before uvicorn serves)
  ```

  Before the patch (same script, `extensions.py` + plugin stashed):

  ```
[headroom] proxy extensions SKIPPED: oauth2 (install failed - running
without them; see logs)
  FAIL: create_app returned; proxy would start without the middleware
  ```

  which is exactly the issue's reported behaviour.

- Not tested: a real `headroom proxy` process start through uvicorn with
a
live IdP, and the request path at the wire level (the client's
`Authorization`
reaching an upstream). A multi-worker start (`--workers N`) was not
exercised
either; `create_app_from_env` goes through the same `create_app`, so
each
  worker that cannot install the extension should exit.
  `tests/test_proxy_extension_ordering.py` and two
`test_scope_and_proxy_token.py` cases fail on this machine with or
without the
patch (they need the compiled Rust core, which is not built here) —
verified
  pre-existing by stashing the patch.

## Runtime Rollout Safety

- Rollout-managed feature(s): none. No flag, no staged rollout.
- Minimum rollout channel: any; the marker is inert unless an extension
sets it.
- Stable/default behavior changed: **no** for core — an unmarked
extension that
  raises is still skipped with the same warning and stderr line. For
`headroom-oauth2` 0.2.0, yes and deliberately: a bad config now stops
startup.
- Kill switch / disable path: drop `--proxy-extension oauth2` /
`HEADROOM_PROXY_EXTENSIONS`, or fix the config. Both need no code
change.
- Unsafe override required: no. `HEADROOM_OAUTH2_ALLOW_INSECURE=1` still
lets an
  operator opt into a non-loopback `http` token URL explicitly.
- Qualification impact: none beyond `headroom-oauth2` 0.2.0's own notes.
- Rollback path: revert the commit, or pin `headroom-oauth2<0.2.0` (its
marker is
ignored by any core, so downgrading the plugin alone restores old
behaviour).

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] I did **not** edit `CHANGELOG.md`

## Additional Notes

Two decisions a reviewer may want to weigh in on:

1. **Marker vs. core allowlist.** Reading `fail_closed` off the entry
point means
core guarantees nothing about *which* extensions are security-critical,
and a
malicious/broken plugin can also opt into aborting startup. The
alternative was
   a hard-coded list of vetted names in core, which makes every new
security-critical extension a core change. Happy to switch if
maintainers
   prefer that trade.
2. **Not covered here:** a `fail_closed` extension that is *not
discovered at
all* (typo in the name, package not installed) is still only a warning,
and
that has the same fail-open effect. Closing it needs a way to know the
intended
marker for a name that cannot be loaded — the allowlist in (1), or an
env
opt-in — so I left it out of scope and mention it here rather than
inventing a
   mechanism.

Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-11 23:05:55 -06:00
12b5fb7f2a fix(opencode): default options-form https.request calls to https (#4749)
## Description

Part of #4745

`wrapRequest` in the OpenCode transport does not know whether it wraps
`http` or `https`. A request made with an options object and no
`protocol` was read as `http:`, so `https.request({ hostname:
"api.openai.com", path: "/v1/chat/completions", method: "POST" })` was
routed with `x-headroom-base-url: http://api.openai.com`, and with
`port: 443` as `http://api.openai.com:443`. The proxy accepts an `http`
upstream, so the caller's `Authorization` header would be forwarded in
cleartext.

This PR passes the wrapped module's default protocol (`https:` for
`https.request`/`https.get`, `http:` for `http`) into the URL builder. A
`protocol` in the options still wins.

## Type of Change

- [x] 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

- `plugins/opencode/src/transport.ts`: `splitNodeArgs` and
`urlFromRequestOptions` take a `defaultProtocol`; `wrapRequest` passes
`https:` when it wraps `https.request` and `http:` otherwise.
- `plugins/opencode/src/transport.test.ts`: next to the existing
`https.request` routing test, one test sends four options-form POSTs
(`https.request` with and without `port: 443`, `http.request` with and
without `port: 8080`) to a local stand-in for the proxy and checks the
`x-headroom-base-url` it receives.

## Testing

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [ ] Manual testing performed

This is a TypeScript change in `plugins/opencode`, so the Python checks
above do not apply. `vitest run` was run. `tsc --noEmit` was not run on
this branch (it is a few-line change; the same toolchain was run on the
sibling branches). The package has no lint or format script and the root
ruff config covers Python only, so none was run.

### Test Output

Fail before (`transport.ts`, `plugin.ts`, `retrieve.ts` from
`origin/main` `1da8930a`, new test kept; `npx vitest run` in
`plugins/opencode`, Ubuntu on WSL2, Node v24.22.2):

```text
AssertionError: expected [ 'http://api.openai.com', …(3) ] to deeply equal [ 'https://api.openai.com', …(3) ]
  [
-   "https://api.openai.com",
-   "https://api.openai.com",
+   "http://api.openai.com",
+   "http://api.openai.com:443",
    "http://api.openai.com",
    "http://api.openai.com:8080",
  ]
 Test Files  1 failed | 3 passed (4)
      Tests  1 failed | 66 passed (67)
```

Pass after (this branch):

```text
 Test Files  4 passed (4)
      Tests  67 passed (67)
```

## Real Behavior Proof

- Environment: Ubuntu on WSL2 (Windows 11 host), Node v24.22.2, vitest
from `plugins/opencode/package-lock.json` (`npm ci --ignore-scripts`),
no network (a local HTTP server stands in for the proxy).
- Exact command / steps: `npx vitest run` in `plugins/opencode`; the new
test installs the transport with the stand-in's URL and makes the four
options-form POSTs above.
- Observed result: see Test Output; on `origin/main` the two
`https.request` calls arrive as `http://api.openai.com` and
`http://api.openai.com:443`, with this change as
`https://api.openai.com` for both. The `http.request` results are the
same before and after.
- Not tested: the real OpenCode host; a real provider; Windows; what the
Headroom proxy does with the header value.

## Runtime Rollout Safety

- Rollout-managed feature(s): none changed.
- Minimum rollout channel: n/a (no new feature)
- Stable/default behavior changed: yes, narrowly: an options-form
`https.request`/`https.get` call without `protocol` now gets an
`https://` base URL header instead of `http://`. URL-form calls and
`http` are unchanged.
- Kill switch / disable path: none added.
- Unsafe override required: no
- Qualification impact: none expected.
- Rollback path: revert this commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

- A custom `agent` option (for example an `https.Agent` passed to
`http.request`) is not used to infer the protocol; only the wrapped
module decides the default.

Produced with AI assistance (Claude Code) operated by me (HetCreep); the
tests and proof above were run on my machine against a clone of the
repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4749"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-11 09:59:23 -06:00
ParideboyandJD Davis c48778c4ab fix(opencode): stop routing non-LLM hosts and paths to the proxy (#4747) (#4758)
Closes #4747.

## Description

The OpenCode transport shim decides whether to reroute a request from
the URL string alone. That decision had three blind spots: two too
literal, one too narrow.

**Hosts.** `isLoopback` compared the raw hostname against exactly
`"127.0.0.1"` and `"::1"`, so every other spelling of loopback counted
as remote and its request — with the caller's `Authorization` header —
went to the proxy:

| URL host | `URL.hostname` | old check | new check |
| --- | --- | --- | --- |
| `127.0.0.2` | `127.0.0.2` | remote | loopback |
| `127.1.2.3` | `127.1.2.3` | remote | loopback |
| `[::ffff:127.0.0.2]` | `[::ffff:7f00:2]` | remote | loopback |
| `localhost.` | `localhost.` | remote | loopback |
| `api.x.example.` | `api.x.example.` | not excluded | excluded |

The trailing-dot row is the same bug on the `excludeHosts` path:
`example.com.` is the fully qualified spelling of `example.com`, so an
excluded host was routed anyway.

**Paths.** Any path ending in `/messages` or `/responses` was treated as
an LLM endpoint, so Discord's `/api/v10/channels/123/messages` and a
forms API's `/forms/123/responses` were rerouted. That needs a wire root
in front of the endpoint.

**Configured bases.** The first version of that wire-root rule could
only recognise root names it knew (`v1`, `api`, `openai`, …), so a
compatible gateway configured at `https://gateway.invalid/tenant/acme`
lost its routing entirely: OpenCode 1.x sent
`/tenant/acme/chat/completions` through the patched `fetch` straight
upstream, with no compression and no telemetry. The plugin's own
`modelBaseRoutesThroughProxy` still accepted that base, so the transport
disagreed with the plugin. Provider base URLs from OpenCode's
configuration are now authoritative, matched by origin and path prefix
rather than by root name, and the path heuristics stay as the fallback
when no configuration is available.

## Type of Change

- [x] 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
- [ ] Refactoring (no functional changes)
- [ ] Tests only

## Reproduction

On `main`, with the plugin's transport installed:

```js
installHeadroomTransport({ proxyUrl: "http://127.0.0.1:8787/v1", excludeHosts: ["api.x.example"] });
await fetch("http://127.0.0.2:11434/v1/chat/completions", { method: "POST" });   // routed to proxy
await fetch("http://localhost./v1/chat/completions", { method: "POST" });        // routed to proxy
await fetch("https://api.x.example./v1/chat/completions", { method: "POST" });   // routed to proxy
await fetch("https://discord.com/api/v10/channels/123/messages", { method: "POST" }); // routed to proxy
```

A local provider on `127.0.0.2` or `[::ffff:127.0.0.2]`, a `.internal`
host spelled with a trailing dot, and a non-LLM `POST` all ended up at
the Headroom proxy instead of their own server.

For the configured-base half, on the previous head `b695e697` with a
provider base URL of `https://gateway.invalid/tenant/acme`:

```js
await fetch("https://gateway.invalid/tenant/acme/chat/completions", { method: "POST" });
// main: proxy. b695e697: gateway, with no x-headroom-base-url, so no compression.
```

## Changes Made

`plugins/opencode/src/transport.ts`:

- Added `canonicalHostname()` — lowercase, strip IPv6 brackets, strip
trailing dots — and used it in `isLoopback`, `isExcludedHost`, and
`normalizeExcludeHosts`, so all three agree on what a host *is*.
- `isLoopback` now covers all of `127.0.0.0/8` (not just `.0.1`),
`0.0.0.0`, `localhost`, `::1`, and IPv4-mapped IPv6. The mapped form is
tested as a full 32-bit address, because `URL` canonicalizes it to hex
(`127.1.2.3` → `::ffff:7f01:203`) and the last two octets share the low
16-bit group.
- `isLlmEndpointPath` now requires a *wire root* before the endpoint
suffix:
  - the URL is under a **configured provider base** (see below), **or**
- the segment immediately before the suffix is a version (`v1`,
`v1beta`, `v4`) or a base a compatible gateway mounts the wire directly
under (`api`), which keeps prefixed gateways working
(`/api/coding/paas/v4/chat/completions`, `/base/v1/messages`,
`/zen/v1/responses`, and a provider base URL of
`https://gateway.example/api`), **or**
- the path contains a named root (`openai`, `anthropic`, `zen`, `codex`,
`backend-api`) anywhere, which is what Azure OpenAI needs — its
deployment name sits between `/openai/` and the endpoint
(`/openai/deployments/{name}/chat/completions`).
- A bare `/messages` or `/responses` (no preceding segment) still
routes.
- Position matters for the version/`api` branch: `api` counts only when
it abuts the endpoint, so `/api/chat/completions` routes while Discord's
`/api/v10/channels/123/messages` (immediate segment `123`) does not. The
same is true of the version branch — a version segment *anywhere* would
be too weak.
- Gemini's `:generateContent` / `:streamGenerateContent` suffixes are
unchanged and still need no wire root.
- Added `WireRoot` / `normalizeWireRoots` / `isConfiguredWireRoot`: a
configured base is matched by **origin plus path prefix**, and only when
the URL also ends in a wire endpoint. So an OpenAI-compatible provider
at `/tenant/acme` routes its `/tenant/acme/chat/completions`, while
`/tenant/acme/files/1` on the same host passes through, and a different
origin sharing that path prefix does not match at all. Malformed entries
are skipped rather than disabling the set.
- `installHeadroomTransport` takes `wireRoots` and exports the effective
set to child processes as `HEADROOM_OPENCODE_WIRE_ROOTS`, so the
`--import` hook shim routes the same bases; it is removed from the
environment when empty, like `HEADROOM_OPENCODE_EXCLUDE_HOSTS`.
- `setHeadroomWireRoots()` widens a live transport when configured bases
are discovered later, so routing can start before OpenCode answers.
- Regenerated `headroom/providers/opencode/_dist/index.js` and
`headroom/providers/opencode/hook-shim/handler.js` from `npm run
build:standalone` (CI `cmp`s them).

`plugins/opencode/src/plugin.ts`:

- 1.x reads `client.config.get()` and `client.provider.list()` **without
awaiting them**, and applies **each response as it arrives**: the two
reads are independent, so a fulfilled `config.get()` widens routing even
while `provider.list()` is still pending. A round trip to the server
that is loading the plugin cannot be allowed to gate plugin startup, a
server that is not answering yet must not disable routing, and a stalled
`/provider` call must not suppress a base the config already reported. A
failed read costs only its own bases; requests before either answer use
the path heuristics.
- 2.x reads the base URLs its own `ctx.model.transform` already sees, so
no extra round trip is needed.
- `HeadroomOpenCodePluginOptions.wireRoots` lets a user supply a base
the plugin cannot see; normally it is unused.

The residual over-match is `/api/v2/messages`, which still routes;
distinguishing it from a provider needs the host or the body, and
`excludeHosts` already covers any host a user controls. That trade-off
is recorded in the code comment rather than left implicit.

## Testing

- [x] New tests added for new functionality
- [x] Manual testing performed

Six new tests, all tagged `#4747`:

1. non-LLM `POST` paths that merely end in an endpoint
(`discord.com/api/v10/channels/123/messages`, `discord.com/api/v9/...`,
`forms.example.com/forms/123/responses`,
`chat.example.com/rooms/42/chat/completions`) pass through untouched,
with no `x-headroom-base-url` and no session token added.
2. provider-rooted wire paths still route: bare `/messages`,
`/responses`, `/api/chat/completions` (a gateway base URL of `.../api`),
`/api/v2/chat/completions`, `/openai/deployments/x/chat/completions`,
`/zen/v1/responses`, `/backend-api/codex/responses`.
3. every loopback spelling (`127.0.0.1`, `127.0.0.2`, `127.1.2.3`,
`127.255.255.254`, `localhost.`, `[::1]`, `[::ffff:127.0.0.1]`,
`[::ffff:127.1.2.3]`) and a trailing-dot excluded host stay off the
proxy for `fetch`.
4. the same failures stay off the proxy for Node's `http.request`
(`http://` loopbacks) and `https.request` (the excluded and
Discord-shaped `https://` cases). This one spies on both, because real
`https.request` rejects an `http://` URL — asserting one against the
https spy would have proved nothing.
5. a configured base with no version or reserved prefix
(`https://gateway.invalid/tenant/acme`) routes
`/tenant/acme/chat/completions` in **both** the fetch and the Node
request paths, with the right `x-headroom-base-url`;
`/tenant/acme/files/1` on the same host and origin stays unrouted; and
the same path on a different origin stays unrouted. A separate plugin
test asserts that a base URL returned by `client.config.get()` reaches
the transport.
6. a config response applies while `provider.list()` **never settles**:
the configured fetch and Node paths already route, and a non-endpoint
path on the same base still passes through. This is the
partial-availability case from review, and it fails on the previous head
(`expected [] to include 'https://gateway.invalid/tenant/acme'`).

Red/green check for test 5 against the previous head `b695e697`:

```
$ git checkout b695e697 -- plugins/opencode/src/transport.ts
$ npx vitest run src/transport.test.ts
 Test Files  1 failed (1)
      Tests  1 failed | 45 passed (46)

AssertionError: expected 'https://gateway.invalid/tenant/acme/c…' to be an instance of URL
```

The fetch assertion is where it fails first: on `b695e697` the request
passes through untouched, so the recorded first argument is still the
original URL string. Restore the branch sources and all 78 pass.

Earlier red/green, still true: tests 1, 3 and 4 fail before the first
fix; the `/api/chat/completions` assertion fails against the first
commit's rule; test 4 fails against `upstream/main`'s `transport.ts`
(`127.0.0.2` was proxied).

```
$ npm test          → Test Files 4 passed (4) | Tests 78 passed (78)
$ npm run typecheck → clean
$ npm run build     → success
$ npm run build:standalone → success
```

## Real Behavior Proof

- Environment: Windows 11, Node v26.10.0, npm 11. The probe loads the
*built* `dist-standalone/index.js` bundle (before = the committed `HEAD`
bundle, after = this branch), wires the plugin's `server` hook exactly
as OpenCode does, points `proxyUrl` at a real `http.createServer`
listener on `127.0.0.1:19400`, and starts real target servers on
`127.0.0.1:19401`, `127.0.0.2:19401`, `[::1]:19401`, plus the machine's
LAN IPv4 on `:19401`. Every request is a real `fetch` over the stack —
no mocks. Two non-loopback cases use `.invalid` hosts so they cannot
leave the machine; they only need to be *classified*, and the shim drops
the response on the floor. The configured-base rows run on the LAN
address, because loopback is deliberately never routed.
- Exact command / steps: `node proof4747.mjs file:///<abs path to
bundle>` (10-row probe); `node proof4747-shim.mjs <hook-shim/handler.js>
<child>` (child `--import` shim probe); `node proof4747-partial.mjs
file:///<bundle>` (stalled discovery probe)

**Before (committed `HEAD` bundle):**

```
┌──────────────────────────────────────┬──────────┬──────────┬─────────┬──────────────┐
│ label                                │ landed   │ expect   │ verdict │ outcome      │
├──────────────────────────────────────┼──────────┼──────────┼─────────┼──────────────┤
│ loopback 127.0.0.2                   │ target   │ target   │ ok      │ 200 target   │
│ loopback mapped v6                   │ target   │ target   │ ok      │ 200 target   │
│ loopback trailing dot                │ target   │ target   │ ok      │ 200 target   │
│ non-LLM path (Discord shape)         │ target   │ target   │ ok      │ 200 target   │
│ bare loopback endpoint               │ target   │ target   │ ok      │ 200 target   │
│ custom gateway base /api             │ proxy    │ proxy    │ ok      │ 200 proxy    │
│ configured base /tenant/acme         │ target   │ proxy    │ WRONG   │ 200 target   │
│ configured base, non-endpoint path   │ target   │ target   │ ok      │ 200 target   │
│ real provider endpoint               │ proxy    │ proxy    │ ok      │ 200 proxy    │
│ Azure-style endpoint                 │ proxy    │ proxy    │ ok      │ 200 proxy    │
└──────────────────────────────────────┴──────────┴──────────┴─────────┴──────────────┘
proxy saw: ['/v1/chat/completions', '/v1/messages', '/v1/chat/completions']
target saw: ['/v1/chat/completions', '/v1/chat/completions', '/v1/chat/completions',
             '/api/v10/channels/123/messages', '/chat/completions',
             '/tenant/acme/chat/completions', '/tenant/acme/files/1']
```

**After (this branch):**

```
┌──────────────────────────────────────┬──────────┬──────────┬─────────┬──────────────┐
│ label                                │ landed   │ expect   │ verdict │ outcome      │
├──────────────────────────────────────┼──────────┼──────────┼─────────┼──────────────┤
│ loopback 127.0.0.2                   │ target   │ target   │ ok      │ 200 target   │
│ loopback mapped v6                   │ target   │ target   │ ok      │ 200 target   │
│ loopback trailing dot                │ target   │ target   │ ok      │ 200 target   │
│ non-LLM path (Discord shape)         │ target   │ target   │ ok      │ 200 target   │
│ bare loopback endpoint               │ target   │ target   │ ok      │ 200 target   │
│ custom gateway base /api             │ proxy    │ proxy    │ ok      │ 200 proxy    │
│ configured base /tenant/acme         │ proxy    │ proxy    │ ok      │ 200 proxy    │
│ configured base, non-endpoint path   │ target   │ target   │ ok      │ 200 target   │
│ real provider endpoint               │ proxy    │ proxy    │ ok      │ 200 proxy    │
│ Azure-style endpoint                 │ proxy    │ proxy    │ ok      │ 200 proxy    │
└──────────────────────────────────────┴──────────┴──────────┴─────────┴──────────────┘
proxy saw: ['/v1/chat/completions', '/v1/chat/completions', '/v1/messages',
            '/v1/chat/completions']
target saw: ['/v1/chat/completions', '/v1/chat/completions', '/v1/chat/completions',
             '/api/v10/channels/123/messages', '/chat/completions', '/tenant/acme/files/1']
```

All ten rows correct after the patch. The configured base routes; the
unrelated path on that same host still reaches the target; the three
pre-existing provider cases still reach the proxy — so the fix redirects
false positives without disarming the shim.

- Observed result: all ten rows `ok` after the patch; inside the before
bundle the same probe reports `configured base /tenant/acme → target,
WRONG`, and the same two rows for the child `--import` shim (`shim:
WRONG` before, `shim: ok` after), and for the stalled discovery probe
(both wire calls `WRONG` before, all `ok` after). Full tables above.

**Child process (the `--import` hook shim), before and after.** A real
Node child loads the shipped `hook-shim/handler.js` with the env the
plugin exports, then makes two wire calls and one non-endpoint call
against the configured base:

```
before:  /tenant/acme/chat/completions -> target   /tenant/acme/messages -> target
         proxy saw: []                              shim: WRONG
after:   /tenant/acme/chat/completions -> proxy    /tenant/acme/messages -> proxy
         /tenant/acme/files/1 -> target             proxy saw: ['/v1/chat/completions', '/tenant/acme/messages']
                                                    shim: ok
```

**Partial availability (`config.get()` answers, `/provider` stalls),
before and after.** Real built bundle, real listeners, `provider.list()`
returns a promise that never settles:

```
┌──────────────────────────────────────────────────┬────────┬────────┬─────────┐
│ label                                            │ landed │ expect │ verdict │
├──────────────────────────────────────────────────┼────────┼────────┼─────────┤
│ fetch: configured base, provider.list pending    │ target │ proxy  │ WRONG   │   before
│ fetch: non-endpoint path on that base            │ target │ target │ ok      │
│ node http: configured base, provider.list pending│ target │ proxy  │ WRONG   │
└──────────────────────────────────────────────────┴────────┴────────┴─────────┘

after: all three ok — both wire calls reach the proxy, the non-endpoint path does not.
```

- Not tested: no live provider traffic (no API keys were used); a real
`headroom wrap opencode` session against a hosted provider; macOS/Linux.
The loopback and LAN target servers are local stand-ins for a
self-hosted or gateway OpenAI-compatible endpoint (Ollama, LM Studio,
vLLM, a proxy at `/tenant/acme`), which is the shape from the issue. The
config-read path is exercised with a stubbed `client` in the unit test,
not inside a running OpenCode server.

## Runtime Rollout Safety

- Rollout-managed feature(s): none — the OpenCode transport shim is not
behind a rollout flag; it ships as the committed wheel bundle.
- Minimum rollout channel: n/a (no rollout-gated behaviour).
- Stable/default behavior changed: yes, deliberately. Loopback spellings
beyond `127.0.0.1`/`::1` and trailing-dot host spellings now stay off
the proxy; non-LLM paths ending in `/messages` or `/responses` (Discord,
forms shapes) stay off the proxy; configured provider bases route again
(they routed on `main`). Traffic that routed before and still must is
asserted by existing tests (`/base/v1/messages`,
`/api/coding/paas/v4/chat/completions`, `opencode.ai/zen/v1/responses`,
Gemini `:generateContent`).
- Kill switch / disable path: uninstall the transport (`headroom.wrap`
without `opencode`, remove the plugin), or add a provider host to the
`excludeHosts` option / `HEADROOM_OPENCODE_EXCLUDE_HOSTS` env;
`HEADROOM_OPENCODE_TRANSPORT_PROXY_URL` unset also disables the shim.
- Unsafe override required: none. One new optional option (`wireRoots`)
and one new environment variable (`HEADROOM_OPENCODE_WIRE_ROOTS`), both
default to unset; existing calls are unaffected. No wire format or
header changes.
- Qualification impact: route classification only; the proxy wire
protocol is unchanged, so qualification suites that talk to the proxy
are unaffected.
- Rollback path: revert the commit; nothing is persisted and no
migration exists. The committed wheel bundles are byte-identical to `npm
run build:standalone` output (CI `cmp` gate).
- A request that stops routing now reaches its original URL with the
caller's own headers intact — a failure there is a normal provider
error, not a dropped request. Configured-base routing never widens an
arbitrary path: it still requires a wire endpoint, so WebFetch-style
traffic on a provider host is unaffected. The config read is
non-blocking and failure-tolerant; each discovery response applies
independently, and a rejected lookup falls back to the path heuristics
without failing a session. The residual over-match (`/api/v2/messages`)
is inherited from `main` and covered by `excludeHosts`.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review
- [x] Follows `CONTRIBUTING.md` (reproduction + failing-before test +
real behavior proof)
- [x] No `CHANGELOG.md` edit
- [x] Typecheck, tests, both builds run locally
- [x] Behaviour that must be preserved is covered by pre-existing tests

Note for reviewers: #4748 and #4749 are open against the same file
(`transport.ts`) and the same committed bundles. Whichever lands first,
the others will need a rebase and a `build:standalone` refresh; the
conflicts are all in disjoint functions.

Review findings from #4758 addressed in b695e697: `api` is now an
accepted immediate wire root (a provider base URL of
`https://gateway.example/api` routes again, while Discord's
`/api/v10/...` stays out), and the Node test spies on both
`http.request` and `https.request` instead of asserting an `http://` URL
against the https spy, which real Node rejects.

Addressed in 98b5ba2a: configured compatible provider bases are
preserved rather than dropped. Provider base URLs from OpenCode's
configuration are authoritative and matched by origin plus path prefix,
so `/tenant/acme/chat/completions` routes again while Discord and forms
paths stay out; the root-name allowlist remains only as the fallback for
when no configuration is available. Covered in both the fetch and Node
request paths, plus the child-process shim.

Addressed in 3e84b5f2: the two discovery reads no longer gate each
other. Each fulfilled response applies its bases immediately, so a
successful `config.get()` routes the configured wire while
`provider.list()` is still pending; a stalled `/provider` no longer
leaves a known base bypassing Headroom. Startup still never awaits
discovery, and a failed read costs only its own bases.

## Checklist

- [x] My code follows the style of this project
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have added tests that prove my fix is effective
- [x] New and existing unit tests pass locally

---------

Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-10 23:49:30 -06:00
JD DavisandCopilot 19d439f7b0 fix(opencode): override effect to patched 4.0.0-beta.103 (#4762)
## Description

Fixes the failing `npm audit (plugins/opencode)` Security job on main
(effect GHSA-chp3-j5qr-2vfr, affects 4.0.0-beta.0–beta.102). Overrides
`effect` to the first patched beta.

Closes #4761

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)

## Changes Made

- `plugins/opencode/package.json`: add `effect@4.0.0-beta.103`
devDependency and `"effect": "$effect"` override; refresh lockfile
- `src/dependency-compat.test.ts`: cast for widened requirement type in
beta.103 (typecheck only)

## Testing

- [x] Unit tests pass (vitest)
- [ ] Linting passes (`ruff check .`) — N/A, JS-only
- [ ] Type checking passes (`mypy headroom`) — N/A, tsc used instead
- [ ] New tests added for new functionality — N/A
- [x] Manual testing performed

### Test Output

```text
npm audit --package-lock-only --audit-level=low -> found 0 vulnerabilities
npm run typecheck -> clean
npm test -> Tests 71 passed (71)
npm run build -> success
```

## Real Behavior Proof

- Environment: Windows, Node/npm, plugins/opencode on upstream/main
a385ea8e6
- Exact command / steps: `npm install --package-lock-only; npm audit
--package-lock-only --audit-level=low; npm ci; npm run typecheck; npm
test; npm run build`
- Observed result: 0 vulnerabilities; typecheck, 71 tests, build all
pass (previously 2 moderate vulns, exit 1)
- Not tested: runtime against a live OpenCode install; CI run on Linux

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: N/A
- Stable/default behavior changed: no (dev/transitive dependency pin)
- Kill switch / disable path: N/A
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert this PR

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] I did **not** edit `CHANGELOG.md`
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4762"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 21:01:32 -06:00
Parideboy 1372f95524 fix(openclaw): let the circuit breaker open on proxy failures (#4755)
## Description

`assemble()` in the openclaw plugin passed `fallback: true` to the SDK's
`compress()`. In `sdk/typescript/src/client.ts`, that flag makes a
connection error, a timeout or a 5xx retry once and then **resolve** to
`makeFallbackResult(messages)` — `tokensBefore: 0`, `tokensSaved: 0`,
`compressed: false` — instead of throwing.

That result never reached the `catch` that calls `tripCircuit()`. Worse,
`assemble()` treated it as a successful no-op and called
`resetCircuit()`, so the error counter went back to zero on every turn.
Against a proxy that accepts connections but never answers, the circuit
breaker could never open: every `assemble()` paid up to `2 ×
requestTimeoutMs` and then bypassed compression anyway.

Closes #4738

## Type of Change

- [x] 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

- Pass `fallback: false` on the plugin's `compress()` call, so proxy
failures throw into the existing `catch` → `tripCircuit()`. Graceful
degradation is unchanged: that `catch` already returns the original
messages.
- Treat a zero `tokensBefore` on **nonempty** input as a failure too, so
a result that resolved empty cannot keep the breaker closed either.
Empty input is exempt, because the proxy legitimately answers
`tokens_before: 0` for an empty `messages` array — caught in review, see
the `minContextChars: 0` case below.
- `README.md`: the post-cool-down turn does not call `/health`; nothing
in the engine ever did. It re-probes by attempting a real compression.
Fixed, and the threshold row now says which failures count.

## Testing

- [ ] Unit tests pass (`pytest`) — N/A, this is the TypeScript plugin;
ran `vitest` instead
- [ ] Linting passes (`ruff check .`) — N/A, no Python changed
- [ ] Type checking passes (`mypy headroom`) — N/A, no Python changed
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
$ npx vitest run test/engine.test.ts
 Test Files  1 passed (1)
      Tests  41 passed (41)

$ npm run typecheck
> node node_modules/@typescript/native/bin/tsc --noEmit
(clean)

$ npm run build
ESM Build success in 18ms
DTS Build success in 515ms
```

The three new tests each fail on the unpatched tree (verified by
stashing only `src/engine.ts` and re-running):

```text
× passes fallback: false so proxy failures reach the circuit breaker
× opens the circuit on zero-token results, even if the SDK swallows the error
× does not count an empty context as a failure
```

Full suite: 158 passed, 2 failed — both pre-existing and unrelated, in
`test/advancement-key-store.test.ts`, caused by this machine's Node
rejecting `--experimental-transform-types` in the child-process fixture
(`node: bad option: --experimental-transform-types`). They fail
identically on `upstream/main` without this patch.

## Real Behavior Proof

- Environment: Windows 11, Node v26.10.0, `plugins/openclaw` built with
`npm run build`, in-tree `headroom-ai@0.42.0`. Stub proxy is a
`node:http` server that accepts the connection and never responds.
Engine constructed with `requestTimeoutMs: 500`,
`circuitBreakerThreshold: 3`, `circuitBreakerCooldownMs: 60000`,
`minContextChars: 0`, driven through five `assemble()` calls with a
2000-char message.
- Exact command / steps: `npm run build` in `plugins/openclaw`, then
`node proof-circuit.mjs`, which starts the hung proxy on an ephemeral
port, points the engine at it, and makes five sequential `assemble()`
calls. Run once on the unpatched build and once on the patched build.
- Observed result: before the patch the breaker never opened and every
call paid the full timeout. After the patch it opens after the third
failure and calls 4 and 5 skip the proxy entirely (0 ms, 0 requests).
Messages returned are the originals in every case, so model output is
unchanged; only the latency is removed.

Before the patch:

```text
call 1: ms=1004 requestsSeenByProxy=2 totalProxyRequests=2
call 2: ms=1001 requestsSeenByProxy=2 totalProxyRequests=4
call 3: ms=1003 requestsSeenByProxy=2 totalProxyRequests=6
call 4: ms=1001 requestsSeenByProxy=2 totalProxyRequests=8
call 5: ms=1002 requestsSeenByProxy=2 totalProxyRequests=10
circuit-opened=false
```

After the patch:

```text
call 1: ms=1004 requestsSeenByProxy=2 totalProxyRequests=2 messagesAreOriginal=true
call 2: ms=1002 requestsSeenByProxy=2 totalProxyRequests=4 messagesAreOriginal=true
call 3: ms=1002 requestsSeenByProxy=2 totalProxyRequests=6 messagesAreOriginal=true
call 4: ms=0 requestsSeenByProxy=0 totalProxyRequests=6 messagesAreOriginal=true
call 5: ms=0 requestsSeenByProxy=0 totalProxyRequests=6 messagesAreOriginal=true
circuit-opened=true
  warn: [headroom] Circuit breaker opened after 3 errors (last: HeadroomConnectionError: Failed to connect to Headroom at http://127.0.0.1:53545: TimeoutError: The operation was aborted due to timeout); bypassing compression for 60000ms
  warn: [headroom] Circuit open — using uncompressed messages
  warn: [headroom] Circuit open — using uncompressed messages
```

- Not tested: a live OpenClaw host with a real provider (the engine
needs a host to drive, so I drove `assemble()` directly against the
built plugin), and the published `headroom-ai` beyond `0.42.0`.
`fallback` has been in the SDK's `CompressOptions` since the first TS
release, so the flag resolves against the plugin's `^0.40.0` range too.

## Runtime Rollout Safety

- Rollout-managed feature(s): none — this is a plugin-local circuit
breaker inside `headroom-openclaw`, with no rollout flag or channel
gating involved.
- Minimum rollout channel: N/A, no gating is introduced.
- Stable/default behavior changed: yes, deliberately. The circuit
breaker now opens on proxy failures instead of never opening, so an
unhealthy proxy causes compression to be skipped for
`circuitBreakerCooldownMs` (default 60 s) rather than being attempted on
every turn. Messages are returned unchanged either way, so model output
is unaffected; the change removes repeated timeout latency.
- Kill switch / disable path: `enabled: false` disables the plugin
entirely; `circuitBreakerThreshold` can be raised to make the breaker
effectively unreachable; `circuitBreakerCooldownMs` bounds how long each
bypass lasts.
- Unsafe override required: no.
- Qualification impact: none — no provider, transport or config surface
changes, and no new dependency.
- Rollback path: revert the commit. The prior behavior was a single-line
`fallback: true`, and nothing here migrates or persists state, so
reverting restores the old behavior exactly.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

Review caught one defect in my first attempt, now fixed and covered by a
test: with `minContextChars: 0`, `assemble()` forwards empty `messages:
[]` to the proxy, which answers `200` with `tokens_before: 0`. Counting
that as a failure meant a handful of empty-context turns could open the
breaker and then skip compression for a healthy proxy. The zero-token
check is now scoped to nonempty input.

Found with AI assistance (opencode) operated by me.
2026-11-10 12:34:14 -06:00
HetCreepandClaude Sonnet 5.5 318e8e0808 fix(opencode): do not break every request when the proxy URL is empty or invalid (#4750)
## Description

Part of #4746

The OpenCode plugin resolved the proxy URL with `??`, so an empty
`HEADROOM_PROXY_URL` (or `HEADROOM_BASE_URL`, or `proxyUrl` option) won
over the default. The transport then called `new URL(state.proxyUrl)` in
the patched `fetch` and in the http(s) wrapper before it decided whether
a request should be routed, so `new URL("")` or `new
URL("127.0.0.1:8787")` threw on every outbound request in the host
(WebFetch, registries, MCP), although non-LLM traffic is meant to be
left untouched.

This PR treats an empty value as unset, and when the URL still does not
parse, lets the request go to the original function and logs one fixed
warning per value that never contains the value itself (it can carry
credentials); a value with a non-http(s) scheme such as
`user:pass@host:8787` counts as unusable too.

## Type of Change

- [x] 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

- `plugins/opencode/src/plugin.ts`, `plugins/opencode/src/retrieve.ts`:
`??` becomes `||` in the proxy URL resolution chain and in
`getDefaultProxyUrl`.
- `plugins/opencode/src/transport.ts`: new `usableProxyUrl` (parse, or
warn once per value and return nothing). The patched `fetch` and the
http(s) wrapper call the original function when it returns nothing.
`modelBaseRoutesThroughProxy` already catches the parse error and is
unchanged.
- `plugins/opencode/src/plugin.test.ts`: an empty `HEADROOM_PROXY_URL`
falls through to `HEADROOM_BASE_URL`; an empty `proxyUrl` option with
both variables empty gives the default `http://localhost:8787`.
- `plugins/opencode/src/transport.test.ts`: for `""` and
`"127.0.0.1:8787"`, `fetch` (an LLM path and a plain one) is passed
through unchanged, `http.request`/`https.request` do not throw, and
`console.warn` is called once.

## Testing

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [ ] Manual testing performed

This is a TypeScript change in `plugins/opencode`, so the Python checks
above do not apply. The package's own checks were run instead: `vitest
run` and `tsc --noEmit` (`node node_modules/@typescript/native/bin/tsc
--noEmit`, no output). The package has no lint or format script and the
root ruff config covers Python only, so none was run.

### Test Output

Fail before (`transport.ts`, `plugin.ts`, `retrieve.ts` from
`origin/main` `1da8930a`, new tests kept; `npx vitest run` in
`plugins/opencode`, Ubuntu on WSL2, Node v24.22.2):

```text
FAIL plugin.test.ts > treats an empty HEADROOM_PROXY_URL as unset and falls through to HEADROOM_BASE_URL
AssertionError: expected '' to be 'http://127.0.0.1:9999'
FAIL plugin.test.ts > treats an empty proxyUrl option as unset
AssertionError: expected '' to be 'http://localhost:8787'
FAIL transport.test.ts > leaves all traffic alone when the proxy URL is unusable ("")
FAIL transport.test.ts > leaves all traffic alone when the proxy URL is unusable ("127.0.0.1:8787")
TypeError: Invalid URL
 ❯ normalizeProxyUrl src/transport.ts:219:10
 Test Files  2 failed | 2 passed (4)
      Tests  4 failed | 66 passed (70)
```

Pass after (this branch):

```text
 Test Files  4 passed (4)
      Tests  71 passed (71)
```

## Real Behavior Proof

- Environment: Ubuntu on WSL2 (Windows 11 host), Node v24.22.2, vitest
and TypeScript from `plugins/opencode/package-lock.json` (`npm ci
--ignore-scripts`), no network (`fetch` is a recorder).
- Exact command / steps: `npx vitest run` in `plugins/opencode`; the
transport tests install it with `proxyUrl: ""` and `"127.0.0.1:8787"`,
then call `fetch` for `https://api.anthropic.com/v1/messages` (POST) and
`https://registry.npmjs.org/left-pad`, and create an `http.request` and
an `https.request`.
- Observed result: see Test Output; on `origin/main` the install
succeeds and the first request throws `TypeError: Invalid URL`; with
this change both `fetch` calls reach the original function with their
own URL and no routing headers, and one fixed warning is logged (the
value is never logged; a follow-up commit added a test that a
credential-like value does not appear in it: that test fails on the
previous head, 3 failed and 68 passed of 71 with the new tests on the
old source).
- Not tested: the real OpenCode host; Windows; whether the child-process
shim (which receives the same unusable value through its environment) is
affected beyond what the same `usableProxyUrl` guard covers.

## Runtime Rollout Safety

- Rollout-managed feature(s): none changed.
- Minimum rollout channel: n/a (no new feature)
- Stable/default behavior changed: yes, narrowly: an empty proxy URL
setting now means "use the next source / the default" instead of an
empty URL, and an unparsable proxy URL disables routing instead of
throwing on every request. A valid URL behaves as before.
- Kill switch / disable path: none added.
- Unsafe override required: no
- Qualification impact: none expected.
- Rollback path: revert this commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

- Whitespace-only values are not treated as unset by the resolution;
they reach the transport, which now ignores them with the warning.
- The warning goes to `console.warn`; the plugin has no other logger.

Produced with AI assistance (Claude Code) operated by me (HetCreep); the
tests and proof above were run on my machine against a clone of the
repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-10 08:19:38 -06:00
123XieC e6b5777806 fix(openclaw): return structured retrieval tool results (#4707)
## Description

The registered `headroom_retrieve` tool returns a string today. OpenClaw
Code Mode expects an `AgentToolResult` and rejects the string during
transcript capture. Return a text block and structured details for
success, validation errors, HTTP errors, and network failures. Both
invocation signatures now use this result shape. Consumers of the
exported factory can read the text from `content[0].text`.

<!-- Briefly explain the change and why it is needed. -->

Closes #4700.

## Type of Change

- [x] 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

- Preserve the original successful response text and expose the parsed
response as `details`.
- Use OpenClaw’s `details.status: "error"` convention and preserve the
error message, response detail, or expiry hint.

## Testing

<!-- Check what you actually ran, then paste the real command output
below. -->

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [ ] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
cd plugins/openclaw
npm test         # 11 files, 158 tests passed on Node 22.22.2
npm run typecheck
npm run build
git diff --check
```

## Real Behavior Proof

- Environment: macOS arm64, Node 26.12.1, built plugin, loopback HTTP
fixture with synthetic stored content.
- Exact command / steps: run `npm run build` in `plugins/openclaw`.
Import `registerHeadroomPlugin` from `dist/index.js`, configure the
loopback `proxyUrl` with `autoStart: false` and `routeCodexViaProxy:
false`, and capture the factory passed to `registerTool`. Call
`execute(callId, { hash })` with an uppercase 12-hex hash and a 24-hex
hash against successful JSON object and string responses. Then call it
with an invalid hash, a missing key returning HTTP 404, and a valid hash
after stopping the server.
- Observed result: all five paths returned strings on `main` and result
objects after the patch. Request counts were `1, 1, 0, 1, 0` in both
runs. The fix preserved success text and exposed the three failures as
`details.status: "error"`. Seven expectations in the focused regression
file failed on `main`.
- Not tested: full OpenClaw host dispatch or a remote Headroom proxy.
The smoke test used actual plugin registration and HTTP with a small
host API shim.

## Runtime Rollout Safety

- Rollout-managed feature(s): retrieval tool in the OpenClaw plugin.
- Minimum rollout channel: existing plugin channel.
- Stable/default behavior changed: the registered tool returns a
structured result.
- Kill switch / disable path: existing OpenClaw plugin enablement.
- Unsafe override required: none.
- Qualification impact: plugin test suite and loopback verification
above.
- Rollback path: revert the commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] 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
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] 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)

Add screenshots to help explain your changes.

## Additional Notes

AI assistance was used for investigation, implementation, and tests.

<!-- Mention any N/A checklist items, tradeoffs, follow-ups, or
maintainer context. -->

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4707"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->
2026-11-09 21:27:43 -06:00
headroom-release[bot]andgithub-actions[bot] b21479e0fa chore: release 0.44.0 (#4665)
🤖 I have created a release *beep* *boop*
---


##
[0.44.0](https://github.com/headroomlabs-ai/headroom/compare/v0.43.1...v0.44.0)
(2026-11-09)


### ⚠ BREAKING CHANGES

* **packaging:** keep PyTorch extras out of all
([#4067](https://github.com/headroomlabs-ai/headroom/issues/4067))

### Features

* **pipeline:** say whose request an OutcomeSnapshot is
([#4698](https://github.com/headroomlabs-ai/headroom/issues/4698))
([a2bcbd1](https://github.com/headroomlabs-ai/headroom/commit/a2bcbd101b1391debfd218ec8c63cb72d2bc240a))
* **providers:** add Hermes agent wrap support
([#934](https://github.com/headroomlabs-ai/headroom/issues/934))
([7877241](https://github.com/headroomlabs-ai/headroom/commit/7877241d84c93b3ec487e07324245838ddae85cc))
* **proxy/model-router:** add shadow mode
(HEADROOM_MODEL_ROUTER_LOG_ONLY)
([#2395](https://github.com/headroomlabs-ai/headroom/issues/2395))
([861ef95](https://github.com/headroomlabs-ai/headroom/commit/861ef95620c801c2560a2eacc5773a26e131dfd0))
* **proxy:** add lossless /v1/compress mode and detect provider by wire
shape ([#4617](https://github.com/headroomlabs-ai/headroom/issues/4617))
([33f067a](https://github.com/headroomlabs-ai/headroom/commit/33f067a243b2e648730c01ae6b9f20cba879f351))
* **proxy:** expose per-request cost_usd in /stats recent_requests
([#1079](https://github.com/headroomlabs-ai/headroom/issues/1079))
([#1565](https://github.com/headroomlabs-ai/headroom/issues/1565))
([84cedbf](https://github.com/headroomlabs-ai/headroom/commit/84cedbf2b4197f09ace9944c50655786dac35b03))
* **proxy:** expose shared Redis store availability in /health and
/metrics
([#4578](https://github.com/headroomlabs-ai/headroom/issues/4578))
([602ca65](https://github.com/headroomlabs-ai/headroom/commit/602ca65126e12d73ef44d4b1b01bbe1fa3b37080))
* **proxy:** give turn hooks one conversation id per client conversation
([#4496](https://github.com/headroomlabs-ai/headroom/issues/4496))
([94a99ed](https://github.com/headroomlabs-ai/headroom/commit/94a99ed20f6fe110e03d2613e9feec42d9547150))
* **proxy:** report DeepSeek as its own provider in dashboard
([#2565](https://github.com/headroomlabs-ai/headroom/issues/2565))
([9ad16a7](https://github.com/headroomlabs-ai/headroom/commit/9ad16a77f8b9a7817331aa5e9a9ee04d1e1fc05e))
* **proxy:** show per-request /stats metadata to token-authenticated
callers
([#4168](https://github.com/headroomlabs-ai/headroom/issues/4168))
([9b2dec5](https://github.com/headroomlabs-ai/headroom/commit/9b2dec56f9882a25fb511dc5f480b047845141f9))
* **proxy:** unified multi-upstream routing for Anthropic Cloud and
local oMLX
([#4597](https://github.com/headroomlabs-ai/headroom/issues/4597))
([f896161](https://github.com/headroomlabs-ai/headroom/commit/f896161340893dd8e96502d4c309980bed52d3d1))
* **savings:** carry cumulative actual output_tokens in history
checkpoints
([#2921](https://github.com/headroomlabs-ai/headroom/issues/2921))
([8388ff5](https://github.com/headroomlabs-ai/headroom/commit/8388ff5efd7caf3a827e66bf69449c4a64df05af))
* **wrap:** add `headroom wrap droid` for Factory Droid
([#4143](https://github.com/headroomlabs-ai/headroom/issues/4143))
([bb8d18a](https://github.com/headroomlabs-ai/headroom/commit/bb8d18a56abb07ca7e811235c86ea6b626eb1f8b))
* **wrap:** make the Serena code-memory MCP opt-in
([#4509](https://github.com/headroomlabs-ai/headroom/issues/4509))
([2649835](https://github.com/headroomlabs-ai/headroom/commit/2649835a51e6d459ac47e8dcb8591e5bf027715b))


### Bug Fixes

* **asgi:** stop buffering when the client disconnects
(GHSA-mc2f-vg4v-2fh4)
([#4701](https://github.com/headroomlabs-ai/headroom/issues/4701))
([c6d7081](https://github.com/headroomlabs-ai/headroom/commit/c6d708144ce27abeb08c4c57374b373eebe1951e))
* **beacon:** enforce the allowlist below the top-level keys
([#4691](https://github.com/headroomlabs-ai/headroom/issues/4691))
([456288d](https://github.com/headroomlabs-ai/headroom/commit/456288da0765985ca31eed58dbdaef44ff9aa43a))
* **binaries:** fail closed on
HEADROOM_BINARIES_ALLOW_UNVERIFIED=0/false
([#3218](https://github.com/headroomlabs-ai/headroom/issues/3218))
([da6d973](https://github.com/headroomlabs-ai/headroom/commit/da6d9736cd82074988c7d0a2360b49d9d8b6c0a0))
* **cache:** record TTL observations with relative filenames
([#4711](https://github.com/headroomlabs-ai/headroom/issues/4711))
([51d9dc5](https://github.com/headroomlabs-ai/headroom/commit/51d9dc59b3dc6b8c386cc2293e78d1334aac0893))
* **cache:** round learned TTL upper bounds up to whole seconds
([#4710](https://github.com/headroomlabs-ai/headroom/issues/4710))
([13347e3](https://github.com/headroomlabs-ai/headroom/commit/13347e339c4cc88dfa0cfa1deceeb0dae56ee2fc))
* **cache:** save prefix-tracker state when the exit signal arrives
([#4715](https://github.com/headroomlabs-ai/headroom/issues/4715))
([3ba4223](https://github.com/headroomlabs-ai/headroom/commit/3ba422361e3bce92afd6bb30e3cd817ec3b9cb46))
* **ccr:** lowercase the hash in the streaming feedback recorders
([#2313](https://github.com/headroomlabs-ai/headroom/issues/2313))
([3912c04](https://github.com/headroomlabs-ai/headroom/commit/3912c0405321c498f854fd0c152ae01abf63bf48))
* **ci:** keep the npm publish token out of install and build steps
([#4690](https://github.com/headroomlabs-ai/headroom/issues/4690))
([8f6366c](https://github.com/headroomlabs-ai/headroom/commit/8f6366cf66d035fc8e9f390be424bc9bdf6c62e4))
* **cli:** resolve active proxy port for read commands
([#3522](https://github.com/headroomlabs-ai/headroom/issues/3522))
([02c4e92](https://github.com/headroomlabs-ai/headroom/commit/02c4e922f748cfac5db59303918bb13906031650))
* **content-router:** trust confident HTML detection over mixed-content
heuristics
([#3627](https://github.com/headroomlabs-ai/headroom/issues/3627))
([f50db67](https://github.com/headroomlabs-ai/headroom/commit/f50db67006e2fe3f43b295542b759d90bb73e5a1))
* **dashboard:** lifetime metrics and refresh
([#2374](https://github.com/headroomlabs-ai/headroom/issues/2374))
([eb9932a](https://github.com/headroomlabs-ai/headroom/commit/eb9932a671c92b19c58949a63ec833869fc1a8e7))
* **doctor:** recognize IPv6 loopback and case-insensitive proxy routing
URLs ([#3255](https://github.com/headroomlabs-ai/headroom/issues/3255))
([2b0315b](https://github.com/headroomlabs-ai/headroom/commit/2b0315b2d4b0d54947050bbdad2de9e89df06378))
* **install:** decode Windows Task Scheduler XML output before parsing
([#3969](https://github.com/headroomlabs-ai/headroom/issues/3969))
([#4064](https://github.com/headroomlabs-ai/headroom/issues/4064))
([b78e07d](https://github.com/headroomlabs-ai/headroom/commit/b78e07da7fadeaafdbba16312140d44f812bc181))
* **install:** make install status agree with doctor when the proxy is
reachable
([#3072](https://github.com/headroomlabs-ai/headroom/issues/3072))
([#3141](https://github.com/headroomlabs-ai/headroom/issues/3141))
([05431b2](https://github.com/headroomlabs-ai/headroom/commit/05431b264f4fc105a302cceed60b5327abc35e10))
* **langchain:** check optional integration availability
([#4042](https://github.com/headroomlabs-ai/headroom/issues/4042))
([cde584d](https://github.com/headroomlabs-ai/headroom/commit/cde584d7fe6930b8ecf612b705e984b2c6a41527))
* **learn:** harden analyzer JSON parsing against malformed LLM output
([#2471](https://github.com/headroomlabs-ai/headroom/issues/2471))
([12864fc](https://github.com/headroomlabs-ai/headroom/commit/12864fc8f01a1ca6c58440eccef0dabdd3e595b8))
* **learn:** support opencode v2 session schema in learn scanner
([#4199](https://github.com/headroomlabs-ai/headroom/issues/4199))
([c05466a](https://github.com/headroomlabs-ai/headroom/commit/c05466a469c848c69a62a5c283c09dcd35d8e9c8))
* **lossless:** fold only pure path listings, never markup
([#4716](https://github.com/headroomlabs-ai/headroom/issues/4716))
([0ccd559](https://github.com/headroomlabs-ai/headroom/commit/0ccd559db052ea2ec8baef122ac769a146a75518))
* **memory:** gracefully degrade on context lookup and initialization
errors
([#3251](https://github.com/headroomlabs-ai/headroom/issues/3251))
([#4049](https://github.com/headroomlabs-ai/headroom/issues/4049))
([00d4f44](https://github.com/headroomlabs-ai/headroom/commit/00d4f441d3f1d48c463fea57e6c574c2f3671302))
* **metrics:** cap savings_by_source rows and fold the rest into other
([#4257](https://github.com/headroomlabs-ai/headroom/issues/4257))
([2038fb2](https://github.com/headroomlabs-ai/headroom/commit/2038fb2a3667d9cba3ff9cb1c4957add06ef5acb))
* **packaging:** keep PyTorch extras out of all
([#4067](https://github.com/headroomlabs-ai/headroom/issues/4067))
([a890521](https://github.com/headroomlabs-ai/headroom/commit/a8905214d949cdc42b1d76fbc83146f51e0c4f19))
* **proxy:** add --no-ccr-response-handling flag to bypass response
buffering
([#3082](https://github.com/headroomlabs-ai/headroom/issues/3082))
([#3100](https://github.com/headroomlabs-ai/headroom/issues/3100))
([ce14271](https://github.com/headroomlabs-ai/headroom/commit/ce14271ba8ca66b653fbbb555d50ca20e7a36d3f))
* **proxy:** bound the Bedrock Prometheus model label
([#4694](https://github.com/headroomlabs-ai/headroom/issues/4694))
([d70a8b7](https://github.com/headroomlabs-ai/headroom/commit/d70a8b76a5bc12b4eae6655e40e60abe19b145d0))
* **proxy:** drop headers named by Connection when forwarding responses
([#4674](https://github.com/headroomlabs-ai/headroom/issues/4674))
([3871b36](https://github.com/headroomlabs-ai/headroom/commit/3871b3664a03c9dc489be13f245462f2a9fc0b67))
* **proxy:** keep cold-turn reasoning drops sticky so the next warm turn
reuses the cached prefix
([#4592](https://github.com/headroomlabs-ai/headroom/issues/4592))
([3544cf5](https://github.com/headroomlabs-ai/headroom/commit/3544cf5b88a0d0e704f3d3c5eb8a89f7c52d8c13))
* **proxy:** keep the Bedrock credentials provider when startup
resolution fails
([#4705](https://github.com/headroomlabs-ai/headroom/issues/4705))
([5438f00](https://github.com/headroomlabs-ai/headroom/commit/5438f0035d2fd0261b50aac0520b30021dc56fe0))
* **proxy:** refresh Bedrock AWS credentials before they expire
([#4696](https://github.com/headroomlabs-ai/headroom/issues/4696))
([adc6724](https://github.com/headroomlabs-ai/headroom/commit/adc67249660b4464e8489e21287d9b95d044b095))
* **proxy:** rename leaked_threads metric to timed_out_workers_total
([#3908](https://github.com/headroomlabs-ai/headroom/issues/3908))
([bd164a2](https://github.com/headroomlabs-ai/headroom/commit/bd164a2c3ba3a2eeb470a0b9503a696dd02b0e9c))
* **proxy:** track response.-prefixed item and content-part events in
Responses SSE state
([#4695](https://github.com/headroomlabs-ai/headroom/issues/4695))
([8f4122f](https://github.com/headroomlabs-ai/headroom/commit/8f4122f4e5ae351703c775e042d2ad705cebc143))
* **router:** compress tool_result blocks in mutable window with
trailing messages
([#4717](https://github.com/headroomlabs-ai/headroom/issues/4717))
([0511bcd](https://github.com/headroomlabs-ai/headroom/commit/0511bcd33186f57d76e508bbec388bb4256cfc68))
* **router:** ignore shell operators inside quoted arguments in read
detection
([#4646](https://github.com/headroomlabs-ai/headroom/issues/4646))
([8cdce17](https://github.com/headroomlabs-ai/headroom/commit/8cdce172ea5b70f9ed5300f089c11f4ca23b8c66))
* **scripts:** skip ci-precheck in the pre-push hook when a push only
deletes refs
([#4702](https://github.com/headroomlabs-ai/headroom/issues/4702))
([cbcf8d8](https://github.com/headroomlabs-ai/headroom/commit/cbcf8d8d9b3c43a93276b46db569fab185ed949d))
* **sdk:** keep Vercel AI SDK tool-result output kinds through
compression
([#4670](https://github.com/headroomlabs-ai/headroom/issues/4670))
([ce42754](https://github.com/headroomlabs-ai/headroom/commit/ce4275491299231bc9d2907833f72f72ea22b8a9))
* **search_compressor:** keep kept rows byte-for-byte and in input order
([#3982](https://github.com/headroomlabs-ai/headroom/issues/3982))
([a538740](https://github.com/headroomlabs-ai/headroom/commit/a538740ee40a80642bb1092d179171828260696c))
* **smart-crusher:** keep mixed-array dict rows and exact drop count
with factor_out_constants
([#4692](https://github.com/headroomlabs-ai/headroom/issues/4692))
([ced2685](https://github.com/headroomlabs-ai/headroom/commit/ced26852c6d103991e05c5eec1f13103e5ce2755))
* **smart-crusher:** keep the row the question names
([#4713](https://github.com/headroomlabs-ai/headroom/issues/4713))
([e6e2ebb](https://github.com/headroomlabs-ai/headroom/commit/e6e2ebb6782119e46400a66cef33bb8eb9295484))
* **storage:** return the latest snapshot from JSONLStorage.get
([#4675](https://github.com/headroomlabs-ai/headroom/issues/4675))
([b25c45b](https://github.com/headroomlabs-ai/headroom/commit/b25c45b08f1cc5ed8fe49671e356711b89800ac1))
* **tabular:** split fixed-width rows on column boundaries, not on
double spaces
([#4541](https://github.com/headroomlabs-ai/headroom/issues/4541))
([b80245e](https://github.com/headroomlabs-ai/headroom/commit/b80245ea73e452f2c14de7a5cd8520f7e7d92c61))
* **tag-protector:** do not treat a slash in an unquoted attribute as
self-closing
([#4681](https://github.com/headroomlabs-ai/headroom/issues/4681))
([d5644cb](https://github.com/headroomlabs-ai/headroom/commit/d5644cbacab79607fe8864d007810aa06c5c68ea))
* **tag-protector:** keep the enclosing tag open after a nested close in
marker mode
([#4682](https://github.com/headroomlabs-ai/headroom/issues/4682))
([385d487](https://github.com/headroomlabs-ai/headroom/commit/385d487f41abd029fb4e2f8346c0cc30dc546bc4))
* **telemetry:** keep install ID stateless
([#3542](https://github.com/headroomlabs-ai/headroom/issues/3542))
([27bba79](https://github.com/headroomlabs-ai/headroom/commit/27bba79ff2d1800e390ed20820adff971e99ce08))
* **tokenizers:** resolve chatgpt-4o-* aliases to o200k_base
([#4672](https://github.com/headroomlabs-ai/headroom/issues/4672))
([9648d2d](https://github.com/headroomlabs-ai/headroom/commit/9648d2d867c99eb7e91f81754c5e2877be56feac))
* **tokenizers:** unwrap BatchEncoding in
HuggingFaceTokenizer.count_messages
([#2447](https://github.com/headroomlabs-ai/headroom/issues/2447))
([9eed58f](https://github.com/headroomlabs-ai/headroom/commit/9eed58f84cacc30116c6b6b29cb99eade57e0edf))
* **vertex:** explain Vertex failures in-band, correct the model/region
matrix
([#2640](https://github.com/headroomlabs-ai/headroom/issues/2640))
([0ddaa56](https://github.com/headroomlabs-ai/headroom/commit/0ddaa56c21cdc01c4774391fdcc69e987ecc4e5c))
* **wrap:** route Claude Code's Bedrock mode through Headroom
([#4316](https://github.com/headroomlabs-ai/headroom/issues/4316))
([aa2093b](https://github.com/headroomlabs-ai/headroom/commit/aa2093b4a08ca1f1bb9c8fb92fe0fc85d9ffe936))


### Dependencies

* bump rusqlite from 0.40.2 to 0.41.1
([#4658](https://github.com/headroomlabs-ai/headroom/issues/4658))
([74b7ac2](https://github.com/headroomlabs-ai/headroom/commit/74b7ac23861944f1411d30c5394043ec0505b334))
* bump the cargo-minor-patch group with 3 updates
([#4657](https://github.com/headroomlabs-ai/headroom/issues/4657))
([c01cf07](https://github.com/headroomlabs-ai/headroom/commit/c01cf07d943d816cfd9d97e6838ed4e38f1ff9a4))
* bump the npm-minor-patch group across 1 directory with 2 updates
([#4650](https://github.com/headroomlabs-ai/headroom/issues/4650))
([def4ef1](https://github.com/headroomlabs-ai/headroom/commit/def4ef10099514d09188326852138a8b20c26237))
* update click requirement from &gt;=8.3.3 to &gt;=8.5.0
([#4655](https://github.com/headroomlabs-ai/headroom/issues/4655))
([ea59ac3](https://github.com/headroomlabs-ai/headroom/commit/ea59ac3eef3a3dc02076e9fe4bb30d572ca9c1a9))
* update sqlite-vec requirement from &gt;=0.1.6 to &gt;=0.1.9
([#4654](https://github.com/headroomlabs-ai/headroom/issues/4654))
([de1a1e0](https://github.com/headroomlabs-ai/headroom/commit/de1a1e0f478d1eb9257dd8dd0d4ac87c9e6fc639))
* update tree-sitter requirement from &lt;0.27,&gt;=0.25.2 to
&gt;=0.26.0,&lt;0.27
([#4656](https://github.com/headroomlabs-ai/headroom/issues/4656))
([910588e](https://github.com/headroomlabs-ai/headroom/commit/910588e6b15ab54c4099d03703e5fa20c8abb757))

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

---------

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>
2026-11-09 19:58:06 -06:00
7877241d84 feat(providers): add Hermes agent wrap support (#934)
## Description

Adds first-class Hermes Agent support to `headroom wrap` while
preserving the current provider architecture. The wrapper prepares both
OpenAI- and Anthropic-compatible environment variables, supports
argument forwarding and `--prepare-only`, and reports a clear
installation error when the Hermes binary is unavailable.

This update also changes the missing-binary test to assert the complete
CLI output, resolving CodeQL's URL-substring sanitization false positive
without weakening coverage.

## Changes Made

- integrate Hermes launch-environment construction into the existing
provider module
- route OpenAI and Anthropic endpoints through Headroom
- support Hermes argument forwarding and prepare-only setup
- cover missing-binary, launch, and compression/passthrough behavior
- use an exact expected error message in the CLI test for CodeQL
compatibility

**Provider contract:** `headroom wrap hermes` requires `--provider
anthropic` or `--provider openai`. Any other selection, or no flag,
exits with code 1 before the proxy or Hermes starts.

## Testing

- [x] Unit tests pass
- [x] Linting and formatting pass
- [x] New tests added

### Test Output

```text
20 focused Hermes tests passed
ruff check: passed
ruff format --check: passed
git diff --check: passed
```

- `uv run --extra dev pytest tests/test_providers/test_hermes.py
tests/test_cli/test_wrap_hermes.py
tests/test_hermes_passthrough_compression.py -q` (20 passed)
- `uv run --extra dev ruff check tests/test_cli/test_wrap_hermes.py`
- `uv run --extra dev ruff format --check
tests/test_cli/test_wrap_hermes.py`
- `git diff --check`

## UI evidence

Not applicable. This PR changes CLI/provider behavior and tests; it does
not alter a graphical UI.

## Checklist

- [x] Tests added or updated
- [x] Focused tests pass locally
- [x] Formatting and lint checks pass
- [x] No UI screenshots required
- [x] No changelog entry required for this focused provider integration


## Type of Change

- [ ] Bug fix
- [x] New feature
- [ ] Breaking change
- [ ] Documentation update
- [ ] Performance improvement
- [ ] Code refactoring

## Real Behavior Proof

- Environment: current Hermes provider/wrapper test environment.
- Exact command / steps: ran the Hermes provider, CLI wrapper, and
passthrough/compression suites plus Ruff, formatting, and diff checks.
- Observed result: 20 focused tests pass; OpenAI and Anthropic endpoints
route through Headroom, arguments and prepare-only work, and missing
binaries produce the exact expected error.
- Not tested: a live Hermes Agent session against production providers.

## Runtime Rollout Safety

- Rollout-managed feature(s): None. This adds a new opt-in `headroom
wrap hermes` command.
- Minimum rollout channel: N/A
- Stable/default behavior changed: No. Other wrap commands and proxy
behavior do not change.
- Kill switch / disable path: Do not run `headroom wrap hermes`. Hermes
can also be started without the wrapper.
- Unsafe override required: No
- Qualification impact: None
- Rollback path: Revert this PR.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/934"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->



### Maintainer current-main requalification

Exact head `ef4c2c11cd6359aaf4239f9cc394c28c23985c15`, upstream main
`2d3ee51846435ef5b320eea4806af14e602b0d8c`.

Clean mechanical synchronization with upstream main
2d3ee51846435ef5b320eea4806af14e602b0d8c; contributor routing policy
unchanged. Current author replies and Devin findings reviewed. The
previous default-routing blocker is addressed: the wrapper rejects
absent/unsupported provider flags before calling _launch_tool, and
permits explicitly selected anthropic/openai providers. The
launch-boundary regressions exercise both rejected/default and supported
paths. Explicit empty environments remain isolated, and the shared port
callback is retained.

Hermes/provider/port-alignment tests pass; changed-file Ruff lint/format
and main-relative whitespace checks pass. Existing native extension
supports Python startup, not a fresh native build. The author's
Hermes0.22.2 WSL rejected/default and explicit-provider startup evidence
is considered; this round does not claim live authenticated provider
traffic. Project attribution, retrieval-plugin setup and a possible
registry consolidation remain separate follow-ups rather than claims
that the wrapper installs the plugin or supports other providers.

No remaining finding in the previously requested provider-guard scope.
Formal approval awaits exact-head hosted qualification, handled by
maintainers. Author readiness state preserved; nothing merged.


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.

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: JD Davis <jd@jds-macbook-air.tail2a279.ts.net>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-05 21:11:37 -06:00
headroom-release[bot]andgithub-actions[bot] 2d3ee51846 chore: release 0.43.1 (#4661)
🤖 I have created a release *beep* *boop*
---


##
[0.43.1](https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1)
(2026-11-05)


### Bug Fixes

* **ccr:** keep the in-memory order queue from evicting re-stored
entries
([#4545](https://github.com/headroomlabs-ai/headroom/issues/4545))
([c6f5bf9](https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d))
* **memory:** read the relation key the memory_save schema advertises
([#4647](https://github.com/headroomlabs-ai/headroom/issues/4647))
([7592e68](https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92))
* **memory:** replace the HNSW vector when a memory is re-indexed
([#4649](https://github.com/headroomlabs-ai/headroom/issues/4649))
([ee638f9](https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf))
* **openclaw:** accept 12-character hashes in headroom_retrieve
([#4640](https://github.com/headroomlabs-ai/headroom/issues/4640))
([8d3e9e5](https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a))
* **ort:** avoid implicit runtime discovery from the workspace
([#4570](https://github.com/headroomlabs-ai/headroom/issues/4570))
([69fbd23](https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55))
* **proxy:** bound the model-keyed tokenizer, beacon and litellm caches
([#4497](https://github.com/headroomlabs-ai/headroom/issues/4497))
([e51b806](https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0))
* **proxy:** use HTTP/1.1 client for ChatGPT streaming and model
metadata
([#4006](https://github.com/headroomlabs-ai/headroom/issues/4006))
([e1becdf](https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2))
* **release:** normalize damaged release PR envelopes before detection
([#4664](https://github.com/headroomlabs-ai/headroom/issues/4664))
([917edc6](https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd))
* **router:** keep tagged blocks out of the lossy size-gate fallback
([#4543](https://github.com/headroomlabs-ai/headroom/issues/4543))
([f333edf](https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d))
* **router:** log the ONNX fallbacks at info instead of warning
([#4535](https://github.com/headroomlabs-ai/headroom/issues/4535))
([db30d82](https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f))


### Dependencies

* bump the npm-minor-patch group across 3 directories with 6 updates
([#4662](https://github.com/headroomlabs-ai/headroom/issues/4662))
([8f104f8](https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7))

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

---------

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>
2026-11-05 13:33:39 -06:00
dependabot[bot]andJerrettDavis 8f104f8e29 deps: bump the npm-minor-patch group across 3 directories with 6 updates (#4662)
Bumps the npm-minor-patch group with 3 updates in the /plugins/openclaw
directory: headroom-ai,
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
and
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest).
Bumps the npm-minor-patch group with 5 updates in the /plugins/opencode
directory:

| Package | From | To |
| --- | --- | --- |
| headroom-ai | `0.41.0` | `0.42.0` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.5` | `26.6.6` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.5` | `5.1.0` |
| @opencode-ai/plugin | `1.19.4` | `1.19.5` |
| headroom-ai | `0.41.0` | `0.42.0` |
|
[@opencode/plugin](https://github.com/anomalyco/opencode/tree/HEAD/packages/plugin)
| `2.1.4` | `2.2.5` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.5` | `26.6.6` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.5` | `5.1.0` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.5` | `26.6.6` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.5` | `5.1.0` |

Bumps the npm-minor-patch group with 2 updates in the /sdk/typescript
directory:
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
and [openai](https://github.com/openai/openai-node).

Updates `headroom-ai` from 0.41.0 to 0.42.0

Updates `@types/node` from 26.6.5 to 26.6.6
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.5 to 5.1.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.1.0</h2>
<h3>   🚀 Features</h3>
<ul>
<li>Add <code>--last-failed</code> to run only failed tests  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11558">vitest-dev/vitest#11558</a>
<a href="https://github.com/vitest-dev/vitest/commit/82f634220"><!-- raw
HTML omitted -->(82f63)<!-- raw HTML omitted --></a></li>
<li>Support <code>Temporal.Instant</code> and
<code>Temporal.ZonedDateTime</code> in <code>vi.setSystemTime()</code>
 -  by <a
href="https://github.com/Prajwal2246"><code>@​Prajwal2246</code></a>,
<strong>Prajwal2246</strong>, <strong>Claude Opus 5.5 (1M
context)</strong>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11321">vitest-dev/vitest#11321</a>
<a href="https://github.com/vitest-dev/vitest/commit/f150f5108"><!-- raw
HTML omitted -->(f150f)<!-- raw HTML omitted --></a></li>
<li>Introduce <code>--since-last-run</code> flag  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11516">vitest-dev/vitest#11516</a>
<a href="https://github.com/vitest-dev/vitest/commit/08bd93b7e"><!-- raw
HTML omitted -->(08bd9)<!-- raw HTML omitted --></a></li>
<li>Expose per-retry/repeat attempt result  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Codex (GPT-6)</strong> and <strong>Claude Opus 5.5 (1M
context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11232">vitest-dev/vitest#11232</a>
<a href="https://github.com/vitest-dev/vitest/commit/21be412ed"><!-- raw
HTML omitted -->(21be4)<!-- raw HTML omitted --></a></li>
<li>Support fake timers for <code>node:timers</code> and
<code>node:timers/promise</code>  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>OpenCode</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10899">vitest-dev/vitest#10899</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe973cae"><!-- raw
HTML omitted -->(fbe97)<!-- raw HTML omitted --></a></li>
<li>Allow coverage providers to store data in fs module cache  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11747">vitest-dev/vitest#11747</a>
<a href="https://github.com/vitest-dev/vitest/commit/54a2bdb81"><!-- raw
HTML omitted -->(54a2b)<!-- raw HTML omitted --></a></li>
<li>Interactively review failed snapshots  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> and <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11325">vitest-dev/vitest#11325</a>
<a href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a"><!-- raw
HTML omitted -->(54e5b)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Mock modules through an import map  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11534">vitest-dev/vitest#11534</a>
<a href="https://github.com/vitest-dev/vitest/commit/707f8adf4"><!-- raw
HTML omitted -->(707f8)<!-- raw HTML omitted --></a></li>
<li>Drop experimental label from trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11518">vitest-dev/vitest#11518</a>
<a href="https://github.com/vitest-dev/vitest/commit/44c3c2fcf"><!-- raw
HTML omitted -->(44c3c)<!-- raw HTML omitted --></a></li>
<li>Introduce experimental <code>pointer</code> API  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10780">vitest-dev/vitest#10780</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dc09f0ea"><!-- raw
HTML omitted -->(5dc09)<!-- raw HTML omitted --></a></li>
<li>Capture aria snapshot in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11492">vitest-dev/vitest#11492</a>
<a href="https://github.com/vitest-dev/vitest/commit/0cc39fb90"><!-- raw
HTML omitted -->(0cc39)<!-- raw HTML omitted --></a></li>
<li>Show trace steps timeline on terminal on test failure  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11594">vitest-dev/vitest#11594</a>
<a href="https://github.com/vitest-dev/vitest/commit/973dc84be"><!-- raw
HTML omitted -->(973dc)<!-- raw HTML omitted --></a></li>
<li>Add failure-only trace view mode  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11612">vitest-dev/vitest#11612</a>
<a href="https://github.com/vitest-dev/vitest/commit/d5d7d2f06"><!-- raw
HTML omitted -->(d5d7d)<!-- raw HTML omitted --></a></li>
<li>Enable failure-only trace view by default  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11766">vitest-dev/vitest#11766</a>
<a href="https://github.com/vitest-dev/vitest/commit/f37b6b707"><!-- raw
HTML omitted -->(f37b6)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>coverage</strong>:
<ul>
<li>V8 to support <code>ignoreNode</code> option  -  by <a
href="https://github.com/erickserra"><code>@​erickserra</code></a> and
<a href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11688">vitest-dev/vitest#11688</a>
<a href="https://github.com/vitest-dev/vitest/commit/e02db0869"><!-- raw
HTML omitted -->(e02db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>experimental</strong>:
<ul>
<li>Add trace timeline for node  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11753">vitest-dev/vitest#11753</a>
<a href="https://github.com/vitest-dev/vitest/commit/4e9855151"><!-- raw
HTML omitted -->(4e985)<!-- raw HTML omitted --></a></li>
<li>Add message option to vi.waitFor and vi.waitUntil  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11754">vitest-dev/vitest#11754</a>
<a href="https://github.com/vitest-dev/vitest/commit/fd145d8d6"><!-- raw
HTML omitted -->(fd145)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Rerun setup files after <code>--changed</code> filtering  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11621">vitest-dev/vitest#11621</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a39cfc54"><!-- raw
HTML omitted -->(3a39c)<!-- raw HTML omitted --></a></li>
<li>Return the mock to concurrent imports  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11623">vitest-dev/vitest#11623</a>
<a href="https://github.com/vitest-dev/vitest/commit/1453ba690"><!-- raw
HTML omitted -->(1453b)<!-- raw HTML omitted --></a></li>
<li>Don&amp;<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39">#39</a>;t
fail on console log pending at teardown  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11619">vitest-dev/vitest#11619</a>
<a href="https://github.com/vitest-dev/vitest/commit/a60b8e132"><!-- raw
HTML omitted -->(a60b8)<!-- raw HTML omitted --></a></li>
<li>Reference chai types in every d.ts chunk  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11618">vitest-dev/vitest#11618</a>
<a href="https://github.com/vitest-dev/vitest/commit/fb150158b"><!-- raw
HTML omitted -->(fb150)<!-- raw HTML omitted --></a></li>
<li>Detect mock factory cycles that form later  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11642">vitest-dev/vitest#11642</a>
<a href="https://github.com/vitest-dev/vitest/commit/e95541584"><!-- raw
HTML omitted -->(e9554)<!-- raw HTML omitted --></a></li>
<li>Skip fs module cache for typed import.meta.glob  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11666">vitest-dev/vitest#11666</a>
<a href="https://github.com/vitest-dev/vitest/commit/79501f3a1"><!-- raw
HTML omitted -->(79501)<!-- raw HTML omitted --></a></li>
<li>Run tests that import a deleted file  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11669">vitest-dev/vitest#11669</a>
<a href="https://github.com/vitest-dev/vitest/commit/80aa13dd6"><!-- raw
HTML omitted -->(80aa1)<!-- raw HTML omitted --></a></li>
<li>Keep syntax highlighting in code frames  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11705">vitest-dev/vitest#11705</a>
<a href="https://github.com/vitest-dev/vitest/commit/d39f51548"><!-- raw
HTML omitted -->(d39f5)<!-- raw HTML omitted --></a></li>
<li>Respect CLI filters when prewarming browsers  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> and
<strong>Benjamin Tang</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11706">vitest-dev/vitest#11706</a>
<a href="https://github.com/vitest-dev/vitest/commit/109474892"><!-- raw
HTML omitted -->(10947)<!-- raw HTML omitted --></a></li>
<li>Read cached source as utf-8  -  by <a
href="https://github.com/juan-fernandez"><code>@​juan-fernandez</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11682">vitest-dev/vitest#11682</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11709">vitest-dev/vitest#11709</a>
<a href="https://github.com/vitest-dev/vitest/commit/867a5e41c"><!-- raw
HTML omitted -->(867a5)<!-- raw HTML omitted --></a></li>
<li>Inherit <code>watch</code> from the root config in projects  -  by
<a href="https://github.com/nstepien"><code>@​nstepien</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11724">vitest-dev/vitest#11724</a>
<a href="https://github.com/vitest-dev/vitest/commit/77c122c6b"><!-- raw
HTML omitted -->(77c12)<!-- raw HTML omitted --></a></li>
<li>Prefix expect.poll message to all errors  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11756">vitest-dev/vitest#11756</a>
<a href="https://github.com/vitest-dev/vitest/commit/cab5877db"><!-- raw
HTML omitted -->(cab58)<!-- raw HTML omitted --></a></li>
<li>Support api.port 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11641">vitest-dev/vitest#11641</a>
<a href="https://github.com/vitest-dev/vitest/commit/3667cf8a3"><!-- raw
HTML omitted -->(3667c)<!-- raw HTML omitted --></a></li>
<li>Show attempts in test error logs of retried tests  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11696">vitest-dev/vitest#11696</a>
<a href="https://github.com/vitest-dev/vitest/commit/77a94328a"><!-- raw
HTML omitted -->(77a94)<!-- raw HTML omitted --></a></li>
<li>Preserve rootDir in project paths  -  by <a
href="https://github.com/btea"><code>@​btea</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11816">vitest-dev/vitest#11816</a>
<a href="https://github.com/vitest-dev/vitest/commit/bf96dad6a"><!-- raw
HTML omitted -->(bf96d)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Change default port to 23315  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11640">vitest-dev/vitest#11640</a>
<a href="https://github.com/vitest-dev/vitest/commit/a2ec4166d"><!-- raw
HTML omitted -->(a2ec4)<!-- raw HTML omitted --></a></li>
<li>Advance fake timers in actions and expect.element  -  by <a
href="https://github.com/julienw"><code>@​julienw</code></a>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11242">vitest-dev/vitest#11242</a>
<a href="https://github.com/vitest-dev/vitest/commit/6819008ce"><!-- raw
HTML omitted -->(68190)<!-- raw HTML omitted --></a></li>
<li>Drop trace view warning without html reporter  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11665">vitest-dev/vitest#11665</a>
<a href="https://github.com/vitest-dev/vitest/commit/e64075ef5"><!-- raw
HTML omitted -->(e6407)<!-- raw HTML omitted --></a></li>
<li>Detect shared chunks via the optimizer  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11661">vitest-dev/vitest#11661</a>
<a href="https://github.com/vitest-dev/vitest/commit/e2e9c64b0"><!-- raw
HTML omitted -->(e2e9c)<!-- raw HTML omitted --></a></li>
<li>Clear screenshot stability timeout  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11659">vitest-dev/vitest#11659</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe37c083"><!-- raw
HTML omitted -->(fbe37)<!-- raw HTML omitted --></a></li>
<li>Measure prepare duration with one clock  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11667">vitest-dev/vitest#11667</a>
<a href="https://github.com/vitest-dev/vitest/commit/a3ed42a14"><!-- raw
HTML omitted -->(a3ed4)<!-- raw HTML omitted --></a></li>
<li>Keep failure screenshot per attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11694">vitest-dev/vitest#11694</a>
<a href="https://github.com/vitest-dev/vitest/commit/a5022655d"><!-- raw
HTML omitted -->(a5022)<!-- raw HTML omitted --></a></li>
<li>Print trace timeline of each attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11695">vitest-dev/vitest#11695</a>
<a href="https://github.com/vitest-dev/vitest/commit/272296e5d"><!-- raw
HTML omitted -->(27229)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a3844954d8753fc0d5bed76a96ffd3a21716c22"><code>7a38449</code></a>
chore: release v5.1.0 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11838">#11838</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a5ec316f8e8bf133154a5d5cf43fd5437319e455"><code>a5ec316</code></a>
fix(vm): keep assignable accessor globals writable in node environment
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11834">#11834</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e46c6c1847462d62f9ff5ea4c351fe510a4edf2e"><code>e46c6c1</code></a>
refactor: share trace types and utils (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11825">#11825</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9e23ce57cc112205126b7d37d68126860126b953"><code>9e23ce5</code></a>
refactor(snapshot): unify review update with <code>SnapshotState</code>
update (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11790">#11790</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a0e33cc8b063b4bd8ccd95235532d072d83f75ad"><code>a0e33cc</code></a>
chore: eliminate lint error (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11822">#11822</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fd145d8d60fd877a2eb9622b6771edc08ef26372"><code>fd145d8</code></a>
feat(experimental): add message option to vi.waitFor and vi.waitUntil
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11754">#11754</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/4e985515109b4fd9fcdc2e81d2b1c5f264799cf7"><code>4e98551</code></a>
feat(experimental): add trace timeline for node (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11753">#11753</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/bf96dad6ab66fe01a1a2c008754f999399309c85"><code>bf96dad</code></a>
fix: preserve rootDir in project paths (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11816">#11816</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a0d7f007ec69b604fec3446b0e88f2c6"><code>54e5b8a</code></a>
feat: interactively review failed snapshots (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11325">#11325</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/42770759fcca4ff82ab4df49e4ee241f4f680e99"><code>4277075</code></a>
fix(expect): keep soft .resolves/.rejects error location (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11792">#11792</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.1.0/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.41.0 to 0.42.0

Updates `@types/node` from 26.6.5 to 26.6.6
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.5 to 5.1.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.1.0</h2>
<h3>   🚀 Features</h3>
<ul>
<li>Add <code>--last-failed</code> to run only failed tests  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11558">vitest-dev/vitest#11558</a>
<a href="https://github.com/vitest-dev/vitest/commit/82f634220"><!-- raw
HTML omitted -->(82f63)<!-- raw HTML omitted --></a></li>
<li>Support <code>Temporal.Instant</code> and
<code>Temporal.ZonedDateTime</code> in <code>vi.setSystemTime()</code>
 -  by <a
href="https://github.com/Prajwal2246"><code>@​Prajwal2246</code></a>,
<strong>Prajwal2246</strong>, <strong>Claude Opus 5.5 (1M
context)</strong>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11321">vitest-dev/vitest#11321</a>
<a href="https://github.com/vitest-dev/vitest/commit/f150f5108"><!-- raw
HTML omitted -->(f150f)<!-- raw HTML omitted --></a></li>
<li>Introduce <code>--since-last-run</code> flag  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11516">vitest-dev/vitest#11516</a>
<a href="https://github.com/vitest-dev/vitest/commit/08bd93b7e"><!-- raw
HTML omitted -->(08bd9)<!-- raw HTML omitted --></a></li>
<li>Expose per-retry/repeat attempt result  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Codex (GPT-6)</strong> and <strong>Claude Opus 5.5 (1M
context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11232">vitest-dev/vitest#11232</a>
<a href="https://github.com/vitest-dev/vitest/commit/21be412ed"><!-- raw
HTML omitted -->(21be4)<!-- raw HTML omitted --></a></li>
<li>Support fake timers for <code>node:timers</code> and
<code>node:timers/promise</code>  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>OpenCode</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10899">vitest-dev/vitest#10899</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe973cae"><!-- raw
HTML omitted -->(fbe97)<!-- raw HTML omitted --></a></li>
<li>Allow coverage providers to store data in fs module cache  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11747">vitest-dev/vitest#11747</a>
<a href="https://github.com/vitest-dev/vitest/commit/54a2bdb81"><!-- raw
HTML omitted -->(54a2b)<!-- raw HTML omitted --></a></li>
<li>Interactively review failed snapshots  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> and <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11325">vitest-dev/vitest#11325</a>
<a href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a"><!-- raw
HTML omitted -->(54e5b)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Mock modules through an import map  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11534">vitest-dev/vitest#11534</a>
<a href="https://github.com/vitest-dev/vitest/commit/707f8adf4"><!-- raw
HTML omitted -->(707f8)<!-- raw HTML omitted --></a></li>
<li>Drop experimental label from trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11518">vitest-dev/vitest#11518</a>
<a href="https://github.com/vitest-dev/vitest/commit/44c3c2fcf"><!-- raw
HTML omitted -->(44c3c)<!-- raw HTML omitted --></a></li>
<li>Introduce experimental <code>pointer</code> API  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10780">vitest-dev/vitest#10780</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dc09f0ea"><!-- raw
HTML omitted -->(5dc09)<!-- raw HTML omitted --></a></li>
<li>Capture aria snapshot in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11492">vitest-dev/vitest#11492</a>
<a href="https://github.com/vitest-dev/vitest/commit/0cc39fb90"><!-- raw
HTML omitted -->(0cc39)<!-- raw HTML omitted --></a></li>
<li>Show trace steps timeline on terminal on test failure  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11594">vitest-dev/vitest#11594</a>
<a href="https://github.com/vitest-dev/vitest/commit/973dc84be"><!-- raw
HTML omitted -->(973dc)<!-- raw HTML omitted --></a></li>
<li>Add failure-only trace view mode  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11612">vitest-dev/vitest#11612</a>
<a href="https://github.com/vitest-dev/vitest/commit/d5d7d2f06"><!-- raw
HTML omitted -->(d5d7d)<!-- raw HTML omitted --></a></li>
<li>Enable failure-only trace view by default  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11766">vitest-dev/vitest#11766</a>
<a href="https://github.com/vitest-dev/vitest/commit/f37b6b707"><!-- raw
HTML omitted -->(f37b6)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>coverage</strong>:
<ul>
<li>V8 to support <code>ignoreNode</code> option  -  by <a
href="https://github.com/erickserra"><code>@​erickserra</code></a> and
<a href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11688">vitest-dev/vitest#11688</a>
<a href="https://github.com/vitest-dev/vitest/commit/e02db0869"><!-- raw
HTML omitted -->(e02db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>experimental</strong>:
<ul>
<li>Add trace timeline for node  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11753">vitest-dev/vitest#11753</a>
<a href="https://github.com/vitest-dev/vitest/commit/4e9855151"><!-- raw
HTML omitted -->(4e985)<!-- raw HTML omitted --></a></li>
<li>Add message option to vi.waitFor and vi.waitUntil  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11754">vitest-dev/vitest#11754</a>
<a href="https://github.com/vitest-dev/vitest/commit/fd145d8d6"><!-- raw
HTML omitted -->(fd145)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Rerun setup files after <code>--changed</code> filtering  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11621">vitest-dev/vitest#11621</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a39cfc54"><!-- raw
HTML omitted -->(3a39c)<!-- raw HTML omitted --></a></li>
<li>Return the mock to concurrent imports  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11623">vitest-dev/vitest#11623</a>
<a href="https://github.com/vitest-dev/vitest/commit/1453ba690"><!-- raw
HTML omitted -->(1453b)<!-- raw HTML omitted --></a></li>
<li>Don&amp;<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39">#39</a>;t
fail on console log pending at teardown  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11619">vitest-dev/vitest#11619</a>
<a href="https://github.com/vitest-dev/vitest/commit/a60b8e132"><!-- raw
HTML omitted -->(a60b8)<!-- raw HTML omitted --></a></li>
<li>Reference chai types in every d.ts chunk  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11618">vitest-dev/vitest#11618</a>
<a href="https://github.com/vitest-dev/vitest/commit/fb150158b"><!-- raw
HTML omitted -->(fb150)<!-- raw HTML omitted --></a></li>
<li>Detect mock factory cycles that form later  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11642">vitest-dev/vitest#11642</a>
<a href="https://github.com/vitest-dev/vitest/commit/e95541584"><!-- raw
HTML omitted -->(e9554)<!-- raw HTML omitted --></a></li>
<li>Skip fs module cache for typed import.meta.glob  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11666">vitest-dev/vitest#11666</a>
<a href="https://github.com/vitest-dev/vitest/commit/79501f3a1"><!-- raw
HTML omitted -->(79501)<!-- raw HTML omitted --></a></li>
<li>Run tests that import a deleted file  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11669">vitest-dev/vitest#11669</a>
<a href="https://github.com/vitest-dev/vitest/commit/80aa13dd6"><!-- raw
HTML omitted -->(80aa1)<!-- raw HTML omitted --></a></li>
<li>Keep syntax highlighting in code frames  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11705">vitest-dev/vitest#11705</a>
<a href="https://github.com/vitest-dev/vitest/commit/d39f51548"><!-- raw
HTML omitted -->(d39f5)<!-- raw HTML omitted --></a></li>
<li>Respect CLI filters when prewarming browsers  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> and
<strong>Benjamin Tang</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11706">vitest-dev/vitest#11706</a>
<a href="https://github.com/vitest-dev/vitest/commit/109474892"><!-- raw
HTML omitted -->(10947)<!-- raw HTML omitted --></a></li>
<li>Read cached source as utf-8  -  by <a
href="https://github.com/juan-fernandez"><code>@​juan-fernandez</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11682">vitest-dev/vitest#11682</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11709">vitest-dev/vitest#11709</a>
<a href="https://github.com/vitest-dev/vitest/commit/867a5e41c"><!-- raw
HTML omitted -->(867a5)<!-- raw HTML omitted --></a></li>
<li>Inherit <code>watch</code> from the root config in projects  -  by
<a href="https://github.com/nstepien"><code>@​nstepien</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11724">vitest-dev/vitest#11724</a>
<a href="https://github.com/vitest-dev/vitest/commit/77c122c6b"><!-- raw
HTML omitted -->(77c12)<!-- raw HTML omitted --></a></li>
<li>Prefix expect.poll message to all errors  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11756">vitest-dev/vitest#11756</a>
<a href="https://github.com/vitest-dev/vitest/commit/cab5877db"><!-- raw
HTML omitted -->(cab58)<!-- raw HTML omitted --></a></li>
<li>Support api.port 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11641">vitest-dev/vitest#11641</a>
<a href="https://github.com/vitest-dev/vitest/commit/3667cf8a3"><!-- raw
HTML omitted -->(3667c)<!-- raw HTML omitted --></a></li>
<li>Show attempts in test error logs of retried tests  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11696">vitest-dev/vitest#11696</a>
<a href="https://github.com/vitest-dev/vitest/commit/77a94328a"><!-- raw
HTML omitted -->(77a94)<!-- raw HTML omitted --></a></li>
<li>Preserve rootDir in project paths  -  by <a
href="https://github.com/btea"><code>@​btea</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11816">vitest-dev/vitest#11816</a>
<a href="https://github.com/vitest-dev/vitest/commit/bf96dad6a"><!-- raw
HTML omitted -->(bf96d)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Change default port to 23315  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11640">vitest-dev/vitest#11640</a>
<a href="https://github.com/vitest-dev/vitest/commit/a2ec4166d"><!-- raw
HTML omitted -->(a2ec4)<!-- raw HTML omitted --></a></li>
<li>Advance fake timers in actions and expect.element  -  by <a
href="https://github.com/julienw"><code>@​julienw</code></a>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11242">vitest-dev/vitest#11242</a>
<a href="https://github.com/vitest-dev/vitest/commit/6819008ce"><!-- raw
HTML omitted -->(68190)<!-- raw HTML omitted --></a></li>
<li>Drop trace view warning without html reporter  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11665">vitest-dev/vitest#11665</a>
<a href="https://github.com/vitest-dev/vitest/commit/e64075ef5"><!-- raw
HTML omitted -->(e6407)<!-- raw HTML omitted --></a></li>
<li>Detect shared chunks via the optimizer  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11661">vitest-dev/vitest#11661</a>
<a href="https://github.com/vitest-dev/vitest/commit/e2e9c64b0"><!-- raw
HTML omitted -->(e2e9c)<!-- raw HTML omitted --></a></li>
<li>Clear screenshot stability timeout  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11659">vitest-dev/vitest#11659</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe37c083"><!-- raw
HTML omitted -->(fbe37)<!-- raw HTML omitted --></a></li>
<li>Measure prepare duration with one clock  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11667">vitest-dev/vitest#11667</a>
<a href="https://github.com/vitest-dev/vitest/commit/a3ed42a14"><!-- raw
HTML omitted -->(a3ed4)<!-- raw HTML omitted --></a></li>
<li>Keep failure screenshot per attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11694">vitest-dev/vitest#11694</a>
<a href="https://github.com/vitest-dev/vitest/commit/a5022655d"><!-- raw
HTML omitted -->(a5022)<!-- raw HTML omitted --></a></li>
<li>Print trace timeline of each attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11695">vitest-dev/vitest#11695</a>
<a href="https://github.com/vitest-dev/vitest/commit/272296e5d"><!-- raw
HTML omitted -->(27229)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a3844954d8753fc0d5bed76a96ffd3a21716c22"><code>7a38449</code></a>
chore: release v5.1.0 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11838">#11838</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a5ec316f8e8bf133154a5d5cf43fd5437319e455"><code>a5ec316</code></a>
fix(vm): keep assignable accessor globals writable in node environment
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11834">#11834</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e46c6c1847462d62f9ff5ea4c351fe510a4edf2e"><code>e46c6c1</code></a>
refactor: share trace types and utils (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11825">#11825</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9e23ce57cc112205126b7d37d68126860126b953"><code>9e23ce5</code></a>
refactor(snapshot): unify review update with <code>SnapshotState</code>
update (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11790">#11790</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a0e33cc8b063b4bd8ccd95235532d072d83f75ad"><code>a0e33cc</code></a>
chore: eliminate lint error (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11822">#11822</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fd145d8d60fd877a2eb9622b6771edc08ef26372"><code>fd145d8</code></a>
feat(experimental): add message option to vi.waitFor and vi.waitUntil
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11754">#11754</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/4e985515109b4fd9fcdc2e81d2b1c5f264799cf7"><code>4e98551</code></a>
feat(experimental): add trace timeline for node (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11753">#11753</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/bf96dad6ab66fe01a1a2c008754f999399309c85"><code>bf96dad</code></a>
fix: preserve rootDir in project paths (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11816">#11816</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a0d7f007ec69b604fec3446b0e88f2c6"><code>54e5b8a</code></a>
feat: interactively review failed snapshots (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11325">#11325</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/42770759fcca4ff82ab4df49e4ee241f4f680e99"><code>4277075</code></a>
fix(expect): keep soft .resolves/.rejects error location (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11792">#11792</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.1.0/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `@types/node` from 26.6.5 to 26.6.6
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.5 to 5.1.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.1.0</h2>
<h3>   🚀 Features</h3>
<ul>
<li>Add <code>--last-failed</code> to run only failed tests  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11558">vitest-dev/vitest#11558</a>
<a href="https://github.com/vitest-dev/vitest/commit/82f634220"><!-- raw
HTML omitted -->(82f63)<!-- raw HTML omitted --></a></li>
<li>Support <code>Temporal.Instant</code> and
<code>Temporal.ZonedDateTime</code> in <code>vi.setSystemTime()</code>
 -  by <a
href="https://github.com/Prajwal2246"><code>@​Prajwal2246</code></a>,
<strong>Prajwal2246</strong>, <strong>Claude Opus 5.5 (1M
context)</strong>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11321">vitest-dev/vitest#11321</a>
<a href="https://github.com/vitest-dev/vitest/commit/f150f5108"><!-- raw
HTML omitted -->(f150f)<!-- raw HTML omitted --></a></li>
<li>Introduce <code>--since-last-run</code> flag  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11516">vitest-dev/vitest#11516</a>
<a href="https://github.com/vitest-dev/vitest/commit/08bd93b7e"><!-- raw
HTML omitted -->(08bd9)<!-- raw HTML omitted --></a></li>
<li>Expose per-retry/repeat attempt result  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Codex (GPT-6)</strong> and <strong>Claude Opus 5.5 (1M
context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11232">vitest-dev/vitest#11232</a>
<a href="https://github.com/vitest-dev/vitest/commit/21be412ed"><!-- raw
HTML omitted -->(21be4)<!-- raw HTML omitted --></a></li>
<li>Support fake timers for <code>node:timers</code> and
<code>node:timers/promise</code>  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>OpenCode</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10899">vitest-dev/vitest#10899</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe973cae"><!-- raw
HTML omitted -->(fbe97)<!-- raw HTML omitted --></a></li>
<li>Allow coverage providers to store data in fs module cache  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11747">vitest-dev/vitest#11747</a>
<a href="https://github.com/vitest-dev/vitest/commit/54a2bdb81"><!-- raw
HTML omitted -->(54a2b)<!-- raw HTML omitted --></a></li>
<li>Interactively review failed snapshots  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> and <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11325">vitest-dev/vitest#11325</a>
<a href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a"><!-- raw
HTML omitted -->(54e5b)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Mock modules through an import map  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11534">vitest-dev/vitest#11534</a>
<a href="https://github.com/vitest-dev/vitest/commit/707f8adf4"><!-- raw
HTML omitted -->(707f8)<!-- raw HTML omitted --></a></li>
<li>Drop experimental label from trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11518">vitest-dev/vitest#11518</a>
<a href="https://github.com/vitest-dev/vitest/commit/44c3c2fcf"><!-- raw
HTML omitted -->(44c3c)<!-- raw HTML omitted --></a></li>
<li>Introduce experimental <code>pointer</code> API  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10780">vitest-dev/vitest#10780</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dc09f0ea"><!-- raw
HTML omitted -->(5dc09)<!-- raw HTML omitted --></a></li>
<li>Capture aria snapshot in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11492">vitest-dev/vitest#11492</a>
<a href="https://github.com/vitest-dev/vitest/commit/0cc39fb90"><!-- raw
HTML omitted -->(0cc39)<!-- raw HTML omitted --></a></li>
<li>Show trace steps timeline on terminal on test failure  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11594">vitest-dev/vitest#11594</a>
<a href="https://github.com/vitest-dev/vitest/commit/973dc84be"><!-- raw
HTML omitted -->(973dc)<!-- raw HTML omitted --></a></li>
<li>Add failure-only trace view mode  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11612">vitest-dev/vitest#11612</a>
<a href="https://github.com/vitest-dev/vitest/commit/d5d7d2f06"><!-- raw
HTML omitted -->(d5d7d)<!-- raw HTML omitted --></a></li>
<li>Enable failure-only trace view by default  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11766">vitest-dev/vitest#11766</a>
<a href="https://github.com/vitest-dev/vitest/commit/f37b6b707"><!-- raw
HTML omitted -->(f37b6)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>coverage</strong>:
<ul>
<li>V8 to support <code>ignoreNode</code> option  -  by <a
href="https://github.com/erickserra"><code>@​erickserra</code></a> and
<a href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11688">vitest-dev/vitest#11688</a>
<a href="https://github.com/vitest-dev/vitest/commit/e02db0869"><!-- raw
HTML omitted -->(e02db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>experimental</strong>:
<ul>
<li>Add trace timeline for node  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11753">vitest-dev/vitest#11753</a>
<a href="https://github.com/vitest-dev/vitest/commit/4e9855151"><!-- raw
HTML omitted -->(4e985)<!-- raw HTML omitted --></a></li>
<li>Add message option to vi.waitFor and vi.waitUntil  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11754">vitest-dev/vitest#11754</a>
<a href="https://github.com/vitest-dev/vitest/commit/fd145d8d6"><!-- raw
HTML omitted -->(fd145)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Rerun setup files after <code>--changed</code> filtering  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11621">vitest-dev/vitest#11621</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a39cfc54"><!-- raw
HTML omitted -->(3a39c)<!-- raw HTML omitted --></a></li>
<li>Return the mock to concurrent imports  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11623">vitest-dev/vitest#11623</a>
<a href="https://github.com/vitest-dev/vitest/commit/1453ba690"><!-- raw
HTML omitted -->(1453b)<!-- raw HTML omitted --></a></li>
<li>Don&amp;<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39">#39</a>;t
fail on console log pending at teardown  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11619">vitest-dev/vitest#11619</a>
<a href="https://github.com/vitest-dev/vitest/commit/a60b8e132"><!-- raw
HTML omitted -->(a60b8)<!-- raw HTML omitted --></a></li>
<li>Reference chai types in every d.ts chunk  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11618">vitest-dev/vitest#11618</a>
<a href="https://github.com/vitest-dev/vitest/commit/fb150158b"><!-- raw
HTML omitted -->(fb150)<!-- raw HTML omitted --></a></li>
<li>Detect mock factory cycles that form later  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11642">vitest-dev/vitest#11642</a>
<a href="https://github.com/vitest-dev/vitest/commit/e95541584"><!-- raw
HTML omitted -->(e9554)<!-- raw HTML omitted --></a></li>
<li>Skip fs module cache for typed import.meta.glob  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11666">vitest-dev/vitest#11666</a>
<a href="https://github.com/vitest-dev/vitest/commit/79501f3a1"><!-- raw
HTML omitted -->(79501)<!-- raw HTML omitted --></a></li>
<li>Run tests that import a deleted file  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11669">vitest-dev/vitest#11669</a>
<a href="https://github.com/vitest-dev/vitest/commit/80aa13dd6"><!-- raw
HTML omitted -->(80aa1)<!-- raw HTML omitted --></a></li>
<li>Keep syntax highlighting in code frames  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11705">vitest-dev/vitest#11705</a>
<a href="https://github.com/vitest-dev/vitest/commit/d39f51548"><!-- raw
HTML omitted -->(d39f5)<!-- raw HTML omitted --></a></li>
<li>Respect CLI filters when prewarming browsers  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> and
<strong>Benjamin Tang</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11706">vitest-dev/vitest#11706</a>
<a href="https://github.com/vitest-dev/vitest/commit/109474892"><!-- raw
HTML omitted -->(10947)<!-- raw HTML omitted --></a></li>
<li>Read cached source as utf-8  -  by <a
href="https://github.com/juan-fernandez"><code>@​juan-fernandez</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11682">vitest-dev/vitest#11682</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11709">vitest-dev/vitest#11709</a>
<a href="https://github.com/vitest-dev/vitest/commit/867a5e41c"><!-- raw
HTML omitted -->(867a5)<!-- raw HTML omitted --></a></li>
<li>Inherit <code>watch</code> from the root config in projects  -  by
<a href="https://github.com/nstepien"><code>@​nstepien</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11724">vitest-dev/vitest#11724</a>
<a href="https://github.com/vitest-dev/vitest/commit/77c122c6b"><!-- raw
HTML omitted -->(77c12)<!-- raw HTML omitted --></a></li>
<li>Prefix expect.poll message to all errors  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11756">vitest-dev/vitest#11756</a>
<a href="https://github.com/vitest-dev/vitest/commit/cab5877db"><!-- raw
HTML omitted -->(cab58)<!-- raw HTML omitted --></a></li>
<li>Support api.port 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11641">vitest-dev/vitest#11641</a>
<a href="https://github.com/vitest-dev/vitest/commit/3667cf8a3"><!-- raw
HTML omitted -->(3667c)<!-- raw HTML omitted --></a></li>
<li>Show attempts in test error logs of retried tests  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11696">vitest-dev/vitest#11696</a>
<a href="https://github.com/vitest-dev/vitest/commit/77a94328a"><!-- raw
HTML omitted -->(77a94)<!-- raw HTML omitted --></a></li>
<li>Preserve rootDir in project paths  -  by <a
href="https://github.com/btea"><code>@​btea</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11816">vitest-dev/vitest#11816</a>
<a href="https://github.com/vitest-dev/vitest/commit/bf96dad6a"><!-- raw
HTML omitted -->(bf96d)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Change default port to 23315  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11640">vitest-dev/vitest#11640</a>
<a href="https://github.com/vitest-dev/vitest/commit/a2ec4166d"><!-- raw
HTML omitted -->(a2ec4)<!-- raw HTML omitted --></a></li>
<li>Advance fake timers in actions and expect.element  -  by <a
href="https://github.com/julienw"><code>@​julienw</code></a>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11242">vitest-dev/vitest#11242</a>
<a href="https://github.com/vitest-dev/vitest/commit/6819008ce"><!-- raw
HTML omitted -->(68190)<!-- raw HTML omitted --></a></li>
<li>Drop trace view warning without html reporter  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11665">vitest-dev/vitest#11665</a>
<a href="https://github.com/vitest-dev/vitest/commit/e64075ef5"><!-- raw
HTML omitted -->(e6407)<!-- raw HTML omitted --></a></li>
<li>Detect shared chunks via the optimizer  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11661">vitest-dev/vitest#11661</a>
<a href="https://github.com/vitest-dev/vitest/commit/e2e9c64b0"><!-- raw
HTML omitted -->(e2e9c)<!-- raw HTML omitted --></a></li>
<li>Clear screenshot stability timeout  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11659">vitest-dev/vitest#11659</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe37c083"><!-- raw
HTML omitted -->(fbe37)<!-- raw HTML omitted --></a></li>
<li>Measure prepare duration with one clock  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11667">vitest-dev/vitest#11667</a>
<a href="https://github.com/vitest-dev/vitest/commit/a3ed42a14"><!-- raw
HTML omitted -->(a3ed4)<!-- raw HTML omitted --></a></li>
<li>Keep failure screenshot per attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11694">vitest-dev/vitest#11694</a>
<a href="https://github.com/vitest-dev/vitest/commit/a5022655d"><!-- raw
HTML omitted -->(a5022)<!-- raw HTML omitted --></a></li>
<li>Print trace timeline of each attempt  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11695">vitest-dev/vitest#11695</a>
<a href="https://github.com/vitest-dev/vitest/commit/272296e5d"><!-- raw
HTML omitted -->(27229)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a3844954d8753fc0d5bed76a96ffd3a21716c22"><code>7a38449</code></a>
chore: release v5.1.0 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11838">#11838</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a5ec316f8e8bf133154a5d5cf43fd5437319e455"><code>a5ec316</code></a>
fix(vm): keep assignable accessor globals writable in node environment
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11834">#11834</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e46c6c1847462d62f9ff5ea4c351fe510a4edf2e"><code>e46c6c1</code></a>
refactor: share trace types and utils (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11825">#11825</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9e23ce57cc112205126b7d37d68126860126b953"><code>9e23ce5</code></a>
refactor(snapshot): unify review update with <code>SnapshotState</code>
update (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11790">#11790</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/a0e33cc8b063b4bd8ccd95235532d072d83f75ad"><code>a0e33cc</code></a>
chore: eliminate lint error (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11822">#11822</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fd145d8d60fd877a2eb9622b6771edc08ef26372"><code>fd145d8</code></a>
feat(experimental): add message option to vi.waitFor and vi.waitUntil
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11754">#11754</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/4e985515109b4fd9fcdc2e81d2b1c5f264799cf7"><code>4e98551</code></a>
feat(experimental): add trace timeline for node (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11753">#11753</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/bf96dad6ab66fe01a1a2c008754f999399309c85"><code>bf96dad</code></a>
fix: preserve rootDir in project paths (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11816">#11816</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a0d7f007ec69b604fec3446b0e88f2c6"><code>54e5b8a</code></a>
feat: interactively review failed snapshots (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11325">#11325</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/42770759fcca4ff82ab4df49e4ee241f4f680e99"><code>4277075</code></a>
fix(expect): keep soft .resolves/.rejects error location (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11792">#11792</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.1.0/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.41.0 to 0.42.0

Updates `@types/node` from 26.6.5 to 26.6.6
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.5 to 5.1.0
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.1.0</h2>
<h3>   🚀 Features</h3>
<ul>
<li>Add <code>--last-failed</code> to run only failed tests  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11558">vitest-dev/vitest#11558</a>
<a href="https://github.com/vitest-dev/vitest/commit/82f634220"><!-- raw
HTML omitted -->(82f63)<!-- raw HTML omitted --></a></li>
<li>Support <code>Temporal.Instant</code> and
<code>Temporal.ZonedDateTime</code> in <code>vi.setSystemTime()</code>
 -  by <a
href="https://github.com/Prajwal2246"><code>@​Prajwal2246</code></a>,
<strong>Prajwal2246</strong>, <strong>Claude Opus 5.5 (1M
context)</strong>, <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11321">vitest-dev/vitest#11321</a>
<a href="https://github.com/vitest-dev/vitest/commit/f150f5108"><!-- raw
HTML omitted -->(f150f)<!-- raw HTML omitted --></a></li>
<li>Introduce <code>--since-last-run</code> flag  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11516">vitest-dev/vitest#11516</a>
<a href="https://github.com/vitest-dev/vitest/commit/08bd93b7e"><!-- raw
HTML omitted -->(08bd9)<!-- raw HTML omitted --></a></li>
<li>Expose per-retry/repeat attempt result  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Codex (GPT-6)</strong> and <strong>Claude Opus 5.5 (1M
context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11232">vitest-dev/vitest#11232</a>
<a href="https://github.com/vitest-dev/vitest/commit/21be412ed"><!-- raw
HTML omitted -->(21be4)<!-- raw HTML omitted --></a></li>
<li>Support fake timers for <code>node:timers</code> and
<code>node:timers/promise</code>  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>OpenCode</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10899">vitest-dev/vitest#10899</a>
<a href="https://github.com/vitest-dev/vitest/commit/fbe973cae"><!-- raw
HTML omitted -->(fbe97)<!-- raw HTML omitted --></a></li>
<li>Allow coverage providers to store data in fs module cache  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11747">vitest-dev/vitest#11747</a>
<a href="https://github.com/vitest-dev/vitest/commit/54a2bdb81"><!-- raw
HTML omitted -->(54a2b)<!-- raw HTML omitted --></a></li>
<li>Interactively review failed snapshots  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> and <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11325">vitest-dev/vitest#11325</a>
<a href="https://github.com/vitest-dev/vitest/commit/54e5b8a8a"><!-- raw
HTML omitted -->(54e5b)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Mock modules through an import map  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11534">vitest-dev/vitest#11534</a>
<a href="https://github.com/vitest-dev/vitest/commit/707f8adf4"><!-- raw
HTML omitted -->(707f8)<!-- raw HTML omitted --></a></li>
<li>Drop experimental label from trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11518">vitest-dev/vitest#11518</a>
<a href="https://github.com/vitest-dev/vitest/commit/44c3c2fcf"><!-- raw
HTML omitted -->(44c3c)<!-- raw HTML omitted --></a></li>
<li>Introduce experimental <code>pointer</code> API  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/10780">vitest-dev/vitest#10780</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dc09f0ea"><!-- raw
HTML omitted -->(5dc09)<!-- raw HTML omitted --></a></li>
<li>Capture aria snapshot in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11492">vitest-dev/vitest#11492</a>
<a href="https://github.com/vitest-dev/vitest/commit/0cc39fb90"><!-- raw
HTML omitted -->(0cc39)<!-- raw HTML omitted --></a></li>
<li>Show trace steps timeline on terminal on test failure  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a> and
<strong>Claude Opus 5.5 (1M context)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11594">vites...

_Description has been truncated_

### Maintainer current-main requalification

Exact head `23848c2414aef92de4e6ab05f736271bb6385fd9`, upstream main
`8d3e9e5ca7cd645eb73084b848edbea5fc796e1a`.

Clean mechanical sync with upstream
main8d3e9e5ca7cd645eb73084b848edbea5fc796e1a. Reviewed manifests, full
lock deltas, existing author/Devin discussion and install surface. No
contributor runtime code changed. The runtime headroom-ai dependency
advances0.41to0.42 in the plugins; maintained by this repository's team,
it keeps the existing compression/retrieval client and existing proxy
network surface. The OpenCode plugin/protocol dependency refreshes
remain on their declared major ranges and were tested against the
integration adapter. OpenAI7.47 is a dev/test dependency used by SDK
compatibility coverage. DefinitelyTyped Node definitions and Vitest5.1
are dev/test refreshes; associated rolldown platform-native bindings
already existed in the build graph. No new hasInstallScript declarations
appear in the lock delta. This is a tested compatible maintenance
update, not a claimed security fix or newly required feature.

Real behavior proof: Windows,Node22.22.0/npm10.9.4; npm ci
--ignore-scripts followed by test,typecheck,build in
sdk/typescript,plugins/openclaw,plugins/opencode.
SDK435pass33skip;OpenClaw153pass2skip;OpenCode66pass.
All3typechecks/builds pass. Installation fetched registry artifacts;
lifecycle scripts were disabled during install, then package builds
executed explicitly. Whitespace checks pass. This verifies local
package/adapter/build compatibility, not live OpenClaw/OpenCode host
sessions or provider calls. Exact-head hosted/security checks remain
maintainer-owned and must qualify before formal approval. Nothing
merged.


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.

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-05 12:24:21 -06:00
APandJerrettDavis 8d3e9e5ca7 fix(openclaw): accept 12-character hashes in headroom_retrieve (#4640)
<!-- maintainer-current-main -->
## Maintainer latest-main checkpoint
Published `930d7f115250cb8d0344f0be8e4fa3fc9f40faa3` incorporates
current upstream main `e4a60ed72f6ef5b28569f8bfbe2163cfda32c948` after a
clean merge. 153 plugin tests pass, 2 Windows skips; typecheck/build
pass. Eight actual TCP/store retrieval cases again recover exact
originals through direct/OpenClaw calls and lowercase/uppercase
12/24-character keys. Contributor correctness logic was not rewritten.
Earlier qualification captures below retain their original
commit/platform scope. Hosted CI must finish on this exact head before
approval; nothing merged.
<!-- /maintainer-current-main -->

## Description

The OpenClaw `headroom_retrieve` tool rejected 12-character hashes with
"Invalid hash format. Expected 24 hex characters." before the request
could reach `GET /v1/retrieve/{hash}`. The SmartCrusher row-drop path
keys its CCR markers with a 12-char SHA-256 hex prefix, mirrored into
the compression store through `explicit_hash`, so 12-char keys are valid
retrieval keys. Every other marker consumer in the repo already accepts
both lengths; this validator was the odd one out.

Closes #4639

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)

## Changes Made

- `plugins/openclaw/src/tools/headroom-retrieve.ts`: validator now
accepts 12- or 24-character hex hashes
(`/^(?:[a-f0-9]{12}|[a-f0-9]{24})$/i`); error message and both the tool
and parameter descriptions updated to say 12 or 24.
- `plugins/openclaw/test/headroom-retrieve.test.ts`: new regression
tests — 12-char accepted (reaches fetch), uppercase 12-char accepted,
24-char still accepted, non-hex / 13-char / empty rejected without a
fetch call, and both descriptions mention both lengths.

## Testing

- [x] New tests added for new functionality
- [x] Manual testing performed

The template's pytest/ruff/mypy items are N/A here: this change is
TypeScript-only, in the OpenClaw plugin. What actually ran (fresh clone
at upstream main 31dcaf41, Node v22.23.1, plugin dir `plugins/openclaw`,
`npm ci`):

### Test Output

```text
$ npx vitest run
 Test Files  10 passed (10)
      Tests  150 passed (150)

$ npm run typecheck
(no output — clean)
```

Before the fix, the issue's repro form showed a 12-char hash refused
locally (`{"error":"Invalid hash format. Expected 24 hex characters."}`,
fetch not called) while a 24-char hash reached the stub backend. After
the fix, both lengths reach the stub backend. The new test file fails
6/7 on the unpatched validator and passes 7/7 after; the one test that
passes on both sides is the "24-char still accepted" guard, which exists
to prove the fix did not regress the length that already worked. Full
suite went from 9 files / 143 tests to 10 files / 150 tests.

## Real Behavior Proof

- Environment: fresh clone of headroomlabs-ai/headroom at main 31dcaf41,
Node v22.23.1, npm 11.20.0, vitest, plugin dir `plugins/openclaw`.
- Exact command / steps: `npm ci`, then `npx vitest run` (full plugin
suite) and `npm run typecheck`; plus the issue's repro form (stubbed
fetch, call `headroom_retrieve` with a 12-char hash, observe whether a
request goes out) run before and after the patch.
- Observed result: 12-char hash now produces `GET
/v1/retrieve/{12-char-hash}` against the stub and returns the stored
content; suite 150/150 green, typecheck clean.
- Not tested: no live Headroom proxy (fetch stubbed throughout, so no
real round trip against a running Headroom); no Python or Rust suites
(change is TypeScript-only); no `npm run build`; no in-OpenClaw agent
session; other plugins were not checked for a copy of the same
validator.

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: N/A
- Stable/default behavior changed: yes, intentionally — 12-character
hashes are now accepted instead of rejected; 24-character behavior is
unchanged, and all other lengths and non-hex input are still rejected.
- Kill switch / disable path: none needed; revert the commit to restore
the old behavior.
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert this commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] 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 — no UI change.

## Additional Notes

One honest caveat on the tests: the "24-char still accepted" test passes
before and after by design (it guards against regression, so it cannot
fail on the unpatched code). The file as a whole fails before the fix
and passes after, which is what the repo's bug-fix rule asks for. The
three rejection tests fail pre-fix only on the changed error string;
their accept/reject verdicts are unchanged.
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4640"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

## Maintainer follow-up qualification
Published `9bcb14fc447abdc844b77c399691e6bbc9e208f2` includes latest
main `ddbbb07746a274da5c9bd7380a42ba2a46e7515d`, including #4641's
OpenClaw execute adapter and the tsup update. The merge is clean;
contributor normalization logic is unchanged. The previous uppercase
finding is fixed by lowercasing accepted keys before the GET request,
with URL assertions for both lengths.

Windows, Node 22.22.0, Python 3.12.13: `npm ci --no-audit --no-fund`,
`npm test`, `npm run typecheck`, `npm run build` all pass. Full plugin
suite: **153 passed, 2 skipped**, 11 test files; package and
declarations build successfully.

Actual runtime proof: start an offline/beacon-opt-out localhost TCP
Uvicorn `create_app(ProxyConfig(stateless=True, optimize=False,
cache_enabled=False, rate_limit_enabled=False, log_requests=False))`;
store a Unicode original with `get_compression_store().store(original,
"short")` and again with `explicit_hash="a1b2c3d4e5f6"`; import
`createHeadroomRetrieveTool` from the built `dist/index.js`. For each
12/24-character lowercase and uppercase key, call both
`tool.execute({hash})` and `tool.execute("call_fixture", {hash})`,
JSON-parse the response, and assert `original_content` equals the exact
original and returned `hash` equals lowercase input. **All eight real
GET round-trips succeed**. The prior uppercase 404 no longer reproduces.
Both Devin findings are addressed by the code/test follow-up and this
live proof.

Not tested: an installed OpenClaw agent session, model/provider calls,
native rebuild, non-Windows runtime. Existing development native
extension was used only for proxy startup. Hosted checks must complete
on the final published head; nothing merged.

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-05 10:55:26 -06:00
81fa4bdda6 chore: release 0.43.0 (#4643)
🤖 I have created a release *beep* *boop*
---


##
[0.43.0](https://github.com/headroomlabs-ai/headroom/compare/v0.42.0...v0.43.0)
(2026-11-05)


### ⚠ BREAKING CHANGES

* **mcp:** port MCP servers to SDK 2.x
([#4603](https://github.com/headroomlabs-ai/headroom/issues/4603))

### Features

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


### Bug Fixes

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


### Dependencies

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

---
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
ecbaf86d78. 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 2a1ebf746b 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 <mxjerrett@gmail.com>
2026-11-05 10:35:15 -06:00
Chen YufeiyangandJD Davis 3d9a6f2cf7 fix(opencode): route Copilot Claude models through the proxy (#4594)
## Description

Closes #4248. The OpenCode 2.x plugin routes models through Headroom by
rewriting model `baseURL`s in `ctx.model.transform`, but it recognized
only the OpenAI wires (`openai-compatible`, `*/chat`, `*/responses`).
Copilot's Claude models use `@opencode/ai/providers/anthropic` (Messages
wire), so they were skipped and their requests never reached the proxy,
while Copilot GPT models kept working.

`modelWireSuffix` now also maps `anthropic`, `anthropic-compatible` and
model-level `*/messages` packages to `/messages`, reusing the existing
rewrite. The config-level `headroom wrap opencode` path cannot cover
Copilot because OpenCode creates that provider dynamically.

## Type of Change

- [x] 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

<details>
<summary>changes details</summary>

- `plugins/opencode/src/plugin.ts`: rename `openAiWireSuffix` to
`modelWireSuffix`, map the Anthropic Messages wires to `/messages`.
- `plugins/opencode/README.md`: document that Anthropic Messages models
are rewritten too.
- `plugins/opencode/src/plugin.test.ts`: three new cases plus a narrowed
negative case.
- `headroom/providers/opencode/_dist/index.js`: rebuilt so the wheel
bundle stays byte-identical (CI `cmp` gate).
</details>

## Testing

<details>
<summary>testing details</summary>

- [x] Unit tests pass (`npm test -- --maxWorkers=2`: 66 passed at
current head)
- [x] Type checking passes (`npm run typecheck`)
- [x] Linting: repo lint is Python-only; plugin gates are typecheck,
build, test, bundle `cmp`, all run
- [x] New tests added
- [x] Manual testing performed — actual OpenCode CLI plus real proxy and
controlled upstream; live Copilot not tested

### Test Output

<!-- Paste relevant command output or artifact links here -->

<details><summary>commands and output</summary>

```text
npm test -- --maxWorkers=2 -> 4 files, 66 passed at 95ef917320 | npm run typecheck -> exit 0 | cmp dist-standalone/index.js headroom/providers/opencode/_dist/index.js -> BUNDLE_MATCH
```

The earlier red/green check recorded three new rewrite cases failing
before the fix (`3 failed | 61 passed`). Fresh current-head validation
is 66/66 plugin tests plus a successful no-emit typecheck;
full-repository Python pytest/Ruff were not run for this transport-only
verification.

</details>
</details>

## Real Behavior Proof

- Environment: Current head `95ef9173`, macOS arm64, official OpenCode
2.2.5, Python 3.12.8, Node 26.13.0; real plugin, Anthropic adapter and
Headroom proxy; local SSE upstream; Python-only transport mode.
- Exact command / steps: Build both plugin bundles, then run the runtime
harness with the official CLI in four scenarios. Exact commands, macOS
fixture adaptation, and the committed Linux reproduction are in the
details below.
- Observed result: All four actual CLI scenarios passed; auth retained,
internal headers stripped, streamed text and `step_finish` returned.
Current-head plugin tests 66/66, typecheck and byte-for-byte wheel
bundle comparison pass.
- Not tested: Live Copilot account/discovery or endpoint compatibility,
live z.ai, Rust/compression/cache, TLS, retries, latency, production
rollout, and other OpenCode versions. Full limits are below.

| Actual OpenCode scenario | Plugin | Proxy POSTs | Upstream POSTs |
Observed upstream path |
| --- | --- | --- | --- | --- |
| Baseline | disabled | 0 | 2 | `/messages` |
| Copilot-shaped root URL | enabled | 2 | 2 | `/v1/messages` |
| `/v1` gateway | enabled | 2 | 2 | `/v1/messages` |
| Prefixed gateway | enabled | 0 | 2 | `/api/coding/paas/v4/messages` |

<details>
<summary>Current-head transport evidence and platform-specific harness
setup</summary>

- Environment: Fresh run on 2026-11-04 at 22:10 UTC, PR head
`95ef9173200eb3b0f047e8fe661e1d9924d41c82`; macOS 27.3 arm64, Python
3.12.8, Node 26.13.0, npm 11.20.0, official installed **OpenCode 2.2.5**
CLI, source Headroom 0.42.1-dev, headroom-opencode 0.42.0. OpenCode
loaded the built standalone plugin itself and used its real
`@opencode/ai/providers/anthropic` adapter. Only the upstream API was a
strict-path local SSE fixture. The proxy explicitly ran in **Python-only
degraded mode**, with `HEADROOM_REQUIRE_RUST_CORE=false`, `--no-optimize
--no-cache`; Rust/compression is outside this proof.
- Exact command / steps: Install proxy dependencies with `uv sync
--frozen --extra proxy --no-default-groups --no-install-project --python
<CPython-3.12.8>`. In `plugins/opencode`, run `npm ci --ignore-scripts
--no-audit --no-fund --fetch-timeout=45000`, `npm run build`, and `npm
run build:standalone`. Run `.venv/bin/python
.cache/runtime-proof-macos.py --opencode
/Applications/OpenCode.app/Contents/Resources/opencode-cli --output
.cache/runtime-proof-macos`. This local copy of the checked-in [runtime
harness](https://github.com/headroomlabs-ai/headroom/blob/95ef9173200eb3b0f047e8fe661e1d9924d41c82/plugins/opencode/scripts/runtime-proof.py)
adapts its Linux loopback fixture to macOS as detailed below. For each
scenario the harness starts a real Headroom proxy and upstream, then
executes `opencode-cli run --standalone --print-logs --log-level debug
--format json 'Reply with HEADROOM_RUNTIME_OK.'` with isolated config,
synthetic auth, model-catalog fetching/updates disabled and a 60-second
timeout. It never invokes `headroomSetup` manually or replaces the model
request with `fetch`.
- Observed result: **All four actual CLI scenarios passed in 40.05
seconds.** Both title and user-turn requests traversed the expected
route, preserved the exact synthetic bearer/API-key values, and sent no
internal `x-headroom-*` headers upstream. Every user turn produced the
text event `HEADROOM_RUNTIME_OK` and a completed `step_finish` after
individual SSE events were flushed by the fixture. The rebuilt
standalone bundle matched the checked-in wheel bundle byte-for-byte,
SHA-256
`78fae6e51ef5d1c534a3299216ba3b467131c17594de34f0fe8bb7b5be4b7533`. No
tracked files or lockfiles changed during this run; all eight
proxy/upstream listening ports were closed afterward and no owned
CLI/proxy process remained.
- Not tested: Live GitHub Copilot discovery, subscription auth/token
refresh, Copilot-specific headers, actual model inference, or whether
the live Copilot origin accepts `/v1/messages`. This is a configured
Copilot-shaped provider, **not** native Copilot discovery. The prefix
control uses the real Anthropic adapter, not a live z.ai account or its
specific adapter. Rust core, optimization/compression/cache,
HTTPS/HTTP2, latency/backpressure, retry/rate-limit behavior, production
rollout, and OpenCode versions other than 2.2.5 were not exercised.

The proxied root-URL run recorded the actual OpenCode user agent and
original path at Headroom:

```text
proxy inbound: POST /v1/messages
user-agent: opencode/latest/2.2.5/cli
x-headroom-original-path: /messages
proxy outbound: POST http://[::ffff:7f00:1]:<fixture-port>/v1/messages
upstream: model=claude-sonnet-4-6, stream=true
upstream: authorization and x-api-key exactly matched synthetic fixtures
upstream: anthropic-version=2023-06-01; no x-headroom-* headers
client: text=HEADROOM_RUNTIME_OK; step_finish present
```

The root origin deliberately distinguishes direct `/messages` from
proxied `/v1/messages`. The fixture rejects an unexpected endpoint
rather than answering every path. These observations establish the
plugin/proxy transport boundary; they do **not** establish live Copilot
endpoint compatibility. The `/v1` origin remains `/v1/messages`, and the
prefixed origin remains `/api/coding/paas/v4/messages` with zero model
POSTs reaching Headroom.

The committed harness originally binds `127.0.0.2`, unavailable on this
macOS host (`Errno 49`). The ignored local copy uses an IPv4-mapped
loopback address with an IPv6 HTTP server and WHATWG-normalized fixture
URLs. It also fixes its checkout-relative path after copying, explicitly
allowlists only that fixture origin, sets supported offline/update
flags, creates its isolated proxy cache, accepts an existing isolated
home directory, and bounds each CLI run to 60 seconds. It does not
change production code or the expected endpoint/auth/SSE assertions. No
network interfaces or account settings were changed. All server
processes are scoped to the harness and terminated/waited in cleanup.

For the original independently recorded Linux run, reproducible
commands, and committed machine-readable results, see
[RUNTIME_PROOF.md](https://github.com/headroomlabs-ai/headroom/blob/95ef9173200eb3b0f047e8fe661e1d9924d41c82/plugins/opencode/RUNTIME_PROOF.md)
and
[runtime-proof-result.json](https://github.com/headroomlabs-ai/headroom/blob/95ef9173200eb3b0f047e8fe661e1d9924d41c82/plugins/opencode/scripts/runtime-proof-result.json).
Those artifacts explicitly identify their earlier source revision and
environment; the current-head macOS build hash above is from this fresh
run. Both proofs execute an actual OpenCode 2.x process. The earlier
PR-body experiment that manually supplied a minimal plugin context and
Node `fetch` has been superseded here.

</details>

## Runtime Rollout Safety

- Rollout-managed feature(s): none.
- Minimum rollout channel: n/a.
- Stable/default behavior changed: only previously skipped Anthropic
Messages models are rewritten; the negative test pins the rest.
- Kill switch / disable path: disable the plugin.
- Unsafe override required: no.
- Qualification impact: none expected.
- Rollback path: revert the commit; no state changes.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] I did **not** edit `CHANGELOG.md`

## Screenshots (if applicable)

N/A — no UI change.

## Additional Notes

The rebuilt `_dist` bundle is part of the diff because CI enforces byte
equality with `dist-standalone`. Actual OpenCode transport is now
verified with a controlled upstream. Live provider/account behavior and
the additional limits listed above remain unverified.

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4594"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-04 23:09:28 -06:00
dependabot[bot]andJerrettDavis 9d87151610 deps: Bump tsup from 8.5.1 to 9.0.0 in /plugins/openclaw (#4384)
Use tsup 9's supported esbuild 0.28 build combination for the OpenClaw
plugin. Headroom's existing security override selected ^0.28.1 outside
tsup 8.5.1's ^0.27.0 range. Tsup 9 declares ^0.28.2; retain the upgrade
and raise the override floor to ^0.28.2 so the locked compiler satisfies
it. Preserve unrelated native-platform metadata and document the
source-build Node requirement.

## Dependency assessment

- **Why version:** keep the existing builder while making the patched
esbuild choice an upstream-supported combination. This is compatibility
work for the existing security build inputs, not cosmetic currency, a
new 0.28.1 advisory claim, or evidence that the old plugin failed.
[Official v9
changes](https://github.com/egoist/tsup/releases/tag/v9.0.0) cover
esbuild/chokidar and debug/obug transitions.
- **Maintenance/security:** upstream release/manifest and resolved
packages were reviewed. Fresh plugin audit reports zero vulnerabilities;
this is not a guarantee about all upstream security history. Plugin
runtime logic is unchanged.
- **Build/host boundary:** source builds require `^22.18.0 || ^24.11.0
|| >=26.0.0` for tsup 9. The README separates that range from the
OpenClaw host runtime. Node 24.22.2 was used for acceptance and actual
OpenClaw 2026.10.6 loading; other host/runtime combinations are not
claimed tested.
- **Native/install/network:** esbuild's native binary selection/install
lifecycle and Rollup's optional platform packages remain development
inputs, including the new GNU Linux-x64 LZMA package. It is a real
Rollup optional dependency. Windows x64 installation/build is qualified;
Linux/macOS/other bindings are not. No new install-script flag is
introduced. The packed plugin uses built dist code and its existing
headroom-ai runtime dependency; bundler tooling remains
development-only. Registry downloads/lifecycle code run during
installation. Host inspection is credential-free and starts no
gateway/provider action.

The original UTF-8 package description is preserved; the final manifest
difference from the bot head is the esbuild override floor. Main's
security/SDK updates are included.

## Real behavior proof

Windows x64 / Node 24.22.2, isolated checkout. From `plugins/openclaw`,
using npm under that Node:

```bash
npm ci --ignore-scripts=false --no-audit --no-fund
npm test
npm run typecheck
npm run build
npm audit --json
```

Fresh installation succeeds, **129 tests across 8 files pass**,
typecheck and ESM/declaration build pass, audit reports zero
vulnerabilities. Importing the built module and invoking registration
constructs its context engine and registers retrieval/gateway-start
hooks with no proxy autostart or provider configured.

**Actual host loading:** official `openclaw@2026.10.6` (`fe06181`) on
Node 24.22.2 ran `openclaw plugins list --json` with task-isolated
OPENCLAW_STATE_DIR and OPENCLAW_CONFIG_PATH. The config is:

```json
{"plugins":{"allow":["headroom"],"load":{"paths":["G:/git/headroom-dep4384/plugins/openclaw"]},"slots":{"contextEngine":"headroom"},"entries":{"headroom":{"enabled":true,"config":{"autoStart":false,"gatewayProviderIds":[],"routeCodexViaProxy":false}}}}}
```

The CLI exited 0 and reported headroom with status loaded, source
`plugins/openclaw/dist/index.js`, and tool `headroom_retrieve`; no
plugin load error was reported. Its runtime dependency was installed.
The isolated first run used a derived registry (an informational
missing-persisted-registry note), not user plugin state. No gateway was
started, proxy spawned, provider invoked or message sent. This validates
actual host loading, not merely a mock registration API.

Whitespace checks pass. The UTF-8 metadata preservation does not change
the built module; after the later clean main merge, plugin files are
otherwise identical to the qualified component.

Untested: inference, real compression proxy requests, gateway/provider
routing, other host versions/platforms, non-Windows native installation,
registry-tarball plugin installation, or production publishing.
Current-head hosted CI remains required.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-04 22:49:39 -06:00
Vivek SinghandJerrettDavis 362e1fc65b fix(openclaw): read the retrieve hash from params, not the tool-call id (#4641)
Fixes #4638

## Description

### Problem

`headroom_retrieve` is registered through `api.registerTool` as a
concrete OpenClaw tool. OpenClaw calls such a tool as
`execute(toolCallId, params, signal?, onUpdate?)`
(`ErasedAgentToolExecute` in `src/agents/tools/common.ts`), but the tool
read its first argument as `{ hash }`. At runtime `hash` was therefore
the tool-call id string, the 24-hex check failed, and every real call
returned `Invalid hash format` without sending a request. The same input
passed as the only argument reached the proxy, which is why the
reproducer in the issue isolates it cleanly.

## Change

`execute` now takes the OpenClaw shape: when the first argument is a
string (the tool-call id) the input comes from the second argument; when
it is an object, as in a direct `execute({ hash })` call, it is used as
before. A missing or non-string hash takes the existing format-error
path, so a bad call still fails closed without a request.

The hash format check and the return shape are unchanged. #4640 widens
the accepted hash lengths in the same function; the two changes touch
different lines of it.

## Tests

`plugins/openclaw/test/headroom-retrieve-execute-args.test.ts`, with
`fetch` stubbed:
- `execute("call_fixture", { hash })` sends `GET /v1/retrieve/<hash>`
and does not return the format error;
- `execute({ hash })` still sends the request;
- `execute("call_fixture", { hash: "not-a-hash" })` and
`execute("call_fixture")` return the format error without a request.

I could not run `vitest` here; the tests follow `proxy-manager.test.ts`
in the same folder (`vi.stubGlobal("fetch", ...)`).

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4641"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

## Type of Change
- [x] Bug fix

## Changes Made
- Select tool input from OpenClaw's second execute argument while
preserving direct object calls and the existing hash policy.
- Maintainer follow-up: assert the exact retrieved content in both
successful argument-shape tests. Contributor runtime logic is unchanged.

## Testing
- [x] Unit tests pass (full OpenClaw Vitest suite; Python tests are N/A
for this TypeScript change)

Maintainer qualification on Windows, Node 22.22.0, Python 3.12.13: `npm
ci --no-audit --no-fund`, `npm test`, `npm run typecheck`, and `npm run
build` in `plugins/openclaw`. Full plugin suite: 145 passed, 2 Windows
skips. Typecheck and package/declaration build passed. Test result
assertions were strengthened after the initial run; the complete suite
and typecheck were rerun successfully.

### Test Output

```text
$ npm test
Test Files 10 passed (10)
Tests 145 passed | 2 skipped (147)
$ npm run typecheck
(exit 0)
$ npm run build
ESM Build success
DTS Build success
```

## Real Behavior Proof
- Environment: Windows; built plugin; actual loopback TCP Uvicorn
Headroom proxy from this PR, actual in-memory CompressionStore; offline
and beacon opt-out enabled. Existing development native extension used
for startup; no fresh native build claimed.
- Exact command / steps: build the package; start
`create_app(ProxyConfig(stateless=True, optimize=False,
cache_enabled=False, rate_limit_enabled=False, log_requests=False))` on
a free localhost port; `get_compression_store().store(original, "short",
original_tokens=15, compressed_tokens=1)`; import
`createHeadroomRetrieveTool` from `dist/index.js`; call `await
tool.execute("call_fixture", {hash})` and `await tool.execute({hash})`;
JSON-parse and compare `original_content` to the stored Unicode
original. Compare the same two-argument call with the unchanged execute
implementation on #4640.
- Observed result: both supported calls on this PR recovered the exact
original, including Unicode, through real GET `/v1/retrieve/{hash}`. The
prior implementation returned `Invalid hash format` for the OpenClaw
call shape. Invalid hash input remained rejected before retrieval. The
current upstream OpenClaw `ErasedAgentToolExecute` declaration
independently confirms `(toolCallId, params, signal?, onUpdate?)`.
- Not tested: an installed OpenClaw agent session, model/provider calls,
abort/update behavior, cross-platform runtime, fresh native build. The
separate 12-character validator issue is scoped to #4640 and not fixed
by this PR.

## Runtime Rollout Safety
- Rollout-managed feature(s): none; existing retrieval tool.
- Minimum rollout channel: unchanged.
- Stable/default behavior changed: valid OpenClaw tool calls can reach
retrieval; direct calls remain supported.
- Kill switch / disable path: existing plugin disable path.
- Unsafe override required: no.
- Qualification impact: focused argument-shape coverage, full plugin
validation, real local proxy retrieval.
- Rollback path: revert the change; no schema migration.

## Review Readiness
Maintainer qualification and review of the test-only follow-up (not an
inferred author attestation):
- [x] I have performed a self-review
- [x] This PR is ready for human review
Hosted CI on the published final head must finish independently. No
merge has been performed.

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-04 22:36:54 -06:00
66e1467682 feat(plugins): headroom skill for Claude Code, Codex, Copilot and skills.sh (#4533)
## Description

In the unbranded sandbox run the agent never searched and wrote a
300-line trimmer by hand; nothing in its environment said Headroom
exists. An Agent Skill is the one artifact that fires on the job words
(cut input tokens, trim tool outputs, fit a context window) with zero
fetches. Four unofficial "headroom" skills already exist on skills.sh;
there is no official one.

Depends on #4529 for the `/docs/fastapi` link in the skill body.

## Type of Change

- [x] New feature (non-breaking change that adds functionality)

## Changes Made

- `skills/headroom/SKILL.md`: job-language description; body is the
no-key `compress()` path, the zero-network check, `model_limit` /
`protect_recent`, the TypeScript proxy caveat, the coding-agent path,
and a short do-not list (no savings claims, no `CompressionMiddleware`
for apps that call a provider, no `[all]` unless asked).
- `plugins/headroom-skill/`: the same SKILL.md under `skills/`,
`.claude-plugin/plugin.json` and `.github/plugin/plugin.json`
(identical), README with install lines for Claude Code, Copilot CLI and
`npx skills add`.
- Both marketplace manifests: `headroom-skill` entry, inserted after the
hooks plugin so `plugins[0]` stays as the existing tests expect.
- `scripts/version-sync.py` and `scripts/verify-versions.py`: the two
new manifests, so the next release PR passes the version gate.
`scripts/tests/test_version_sync.py` fixture and assertion extended;
`tests/test_release_workflows.py` gate list extended.
- `tests/test_plugin_manifests.py`: the two SKILL.md copies must be
byte-identical (the repo has no symlinks, for Windows checkouts),
frontmatter has `name: headroom`; the skill plugin's two manifests match
each other and the marketplace entry.

## Testing

- [x] Unit tests pass: `tests/test_plugin_manifests.py
scripts/tests/test_version_sync.py tests/test_release_workflows.py -k
"manifest or version or skill or sync"`: 30 passed
- [x] `ruff check` / `ruff format --check` on the touched Python
- [x] `python scripts/verify-versions.py`: "All versions aligned at
0.42.0"
- [x] Manual testing performed

### Test Output

```text
pytest tests/test_plugin_manifests.py scripts/tests/test_version_sync.py tests/test_release_workflows.py -k "manifest or version or skill or sync": 30 passed
python scripts/verify-versions.py: All versions aligned at 0.42.0
claude plugin validate .: ✔ Validation passed
```

## Real Behavior Proof

- Environment: macOS arm64, Claude Code CLI.
- Exact command / steps: `claude plugin validate .` at the repo root of
this branch.
- Observed result: `✔ Validation passed`. The only warning is
pre-existing and about `plugins/headroom-agent-hooks/README.md` lacking
a marketplace install line.
- Not tested: installing the plugin from the marketplace into a fresh
Claude Code or Copilot CLI session and triggering the skill on a real
task; skills.sh indexing (happens on their side once this is on `main`).

## Runtime Rollout Safety

- Rollout-managed feature(s): none; documentation and metadata only, no
runtime code path changes
- Minimum rollout channel: n/a
- Stable/default behavior changed: no
- Kill switch / disable path: n/a (revert the PR)
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert the commit

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-03 23:43:21 -06:00
336d462253 fix(opencode): only route POST requests to LLM endpoint paths (#4464)
## Description

The opencode transport routes any request whose path ends in `/messages`
or `/responses` to the Headroom proxy, so a `GET
https://chat.example.com/api/v2/messages` or `GET
.../forms/123/responses` is sent to the proxy (the latter also rewritten
to `/v1/responses`). Every endpoint `isLlmEndpointPath` matches
(`/chat/completions`, `/responses`, `/messages`, `:generateContent`,
`:streamGenerateContent`) is a POST, so this adds a method check: only
POST requests are routed. A missing method counts as GET, matching
`fetch` and `node:http` defaults.

This is a narrow partial fix, not one of the four options in the issue:
it keeps the bare-suffix rule so prefixed gateways still work, and needs
no config. It does **not** cover a non-LLM *POST* to a `/messages` or
`/responses` path; that remainder still needs one of the issue's options
(or `excludeHosts`). Happy to change direction if you prefer a different
approach.

Refs #4417

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)

## Changes Made

- `plugins/opencode/src/transport.ts`: `shouldRoute` takes the request
method; fetch reads it from `init.method` or the `Request`, Node
`http(s).request` from `options.method`. Non-POST requests pass through
untouched.
- `plugins/opencode/src/transport.test.ts`: two tests (fetch and
`https.request`) for GET/DELETE/no-method requests to `/messages` and
`/responses` suffix paths, plus a lowercase `post` that must still
route.

## Testing

- [ ] Unit tests pass (`pytest`) — N/A, no Python changed, not run
- [ ] Linting passes (`ruff check .`) — N/A, not run
- [ ] Type checking passes (`mypy headroom`) — N/A, not run
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
# plugins/opencode, before the fix (new tests only)
Tests  2 failed | 36 passed (38)    # src/transport.test.ts
# after the fix
$ npx vitest run
 Test Files  3 passed (3)
      Tests  60 passed (60)
$ npm run typecheck   # tsc --noEmit, no errors
$ npm run build       # ok
```

## Real Behavior Proof

- Environment: Linux, Node v20.19.2, plugin built with `npm run build`
from origin/main 3fef15d3 and from this branch.
- Exact command / steps: a small script installs
`installHeadroomTransport` from `dist/index.js` against a local fake
proxy, then calls `fetch` for `GET
http://chat.example.invalid/api/v2/messages`, `GET
http://forms.example.invalid/forms/123/responses`, `POST
http://api.example.invalid/v1/messages`.
- Observed result:
```text
### BEFORE (origin/main build)
proxy saw: ["GET /api/v2/messages","GET /v1/responses","POST /v1/messages"]
### AFTER (patched build)
GET http://chat.example.invalid/api/v2/messages -> not proxied, direct fetch failed: UND_ERR_CONNECT_TIMEOUT
GET http://forms.example.invalid/forms/123/responses -> not proxied, direct fetch failed: UND_ERR_CONNECT_TIMEOUT
POST http://api.example.invalid/v1/messages -> 200 proxy
proxy saw: ["POST /v1/messages"]
```
(The direct failures are expected: `.invalid` hosts do not resolve; the
point is the proxy no longer receives them.)
- Not tested: a real opencode session against a real provider;
macOS/Windows; non-LLM POSTs to suffix paths (still routed, see
Description).

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: N/A
- Stable/default behavior changed: yes, non-POST requests to LLM-suffix
paths are no longer proxied. LLM calls are POST, so they are unaffected.
- Kill switch / disable path: none needed; revert the commit.
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation — N/A
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] I did **not** edit `CHANGELOG.md`

## Additional Notes

Drafted with AI assistance; the tests above were run locally.

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4464"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: liziye627-design <232619260+liziye627-design@users.noreply.github.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-03 23:18:28 -06:00
24acbe8f32 fix(openclaw): record turn advancements as one marker file per key (#4212)
## Description

OpenClaw 2026.9.9 started calling the context engine's `commitTurn`
after every accepted turn. While a commit is pending, it runs every
later turn of that session on its legacy context path, which means no
Headroom compression. The plugin's turn-commit store (from #3442) has
three ways to leave a commit pending, and this PR removes all three.
Each committed key becomes one small marker file, created with exclusive
creation (`O_CREAT | O_EXCL`). There's no lock and no shared file to
rewrite, and only the key is stored.

**What we saw.** We run the plugin on Kubernetes with a read-only root
filesystem. After upgrading OpenClaw to 2026.9.9, every turn logged:

```
[context-engine] durable turn advancement remains queued: <key>: ENOENT: no such file or directory, mkdir '/home/openclaw/.headroom'
```

On the session's next turn, OpenClaw retries the pending commit before
assembling context. When the retry fails, it degrades that turn to the
legacy engine (`degradeBeforeStart("pending durable turn advancement
could not be completed before the next turn")` in OpenClaw's
`context-engine-turn-attempt`). A failed commit only increments
`attempt_count`, so the row stays pending and every later turn of the
session degrades too.

**The three problems in `advancement-key-store.ts`:**

1. **Read-only home.** The default
`~/.headroom/openclaw/commit-log.json` can't be created on a read-only
root. Node reports the failed `mkdir` as `ENOENT`, which reads like a
bug rather than a setting. `commitLogPath` exists on the engine but not
in the manifest's `configSchema` (`additionalProperties: false`), so
`HEADROOM_WORKSPACE_DIR` is the only way to move it.
2. **Unbounded growth.** Every accepted turn's `messages` (OpenClaw caps
a turn at 8 MiB) are kept forever in one JSON file. Each commit
re-reads, parses, copies and rewrites the whole file on the gateway's
event loop, so the file and each commit's latency grow with every turn
ever committed. Nothing reads the messages back (`get` is test-only),
and OpenClaw's transcript already holds them.
3. **A lock nothing reclaims.** By design, the lock is never
force-broken. A gateway killed mid-commit (an OOM kill, a node drain)
leaves `commit-log.json.lock` behind, and every later commit waits 60 s
and then fails until someone deletes it. With the retry above, every
turn then starts 60 s late before degrading.

## Type of Change

- [x] 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)
- [x] Documentation update
- [x] Performance improvement
- [ ] Code refactoring (no functional changes)

## Changes Made

- **One marker per committed key**, at
`commit-log.d/<sha256[0:2]>/<sha256(key)>` next to the old log path,
created with `open(path, "wx")`. The first creator in any process gets
`"committed"`; every later caller gets `EEXIST`, i.e. `"duplicate"`.
Only that exclusive create can mean `"duplicate"`, and only when what
exists at the path is a marker file. An `EEXIST` from creating the shard
directory (a file where the directory belongs), or anything but a file
at the marker's path, is a storage error. The marker holds
`{advancementKey, committedAt}`: 99 bytes for OpenClaw's UUID keys.
- **Only the key is recorded.** For this engine, the advancement *is*
the key: `assemble()` works from the messages OpenClaw passes in, and
the plugin keeps no turn state. The contract asks for "one atomic,
idempotent write keyed by `advancementKey`" (OpenClaw
`docs/concepts/context-engine.md`), and creating the marker is that
write.
- **Keys are still never evicted**, for the reason #3442 gives.
- **Migration.** Before every commit and lookup, a store checks for a
`commit-log.json` from an earlier version. With no log there, that check
is one failed `open()`. If a log is there and it's a version the store
hasn't migrated, the store moves its keys into markers and records which
version that was (size, mtime, inode) in
`commit-log.d/migrated-legacy-log.json`. That record only saves work, so
a store that can't write it carries on and reads the log again later.
The log's version and its contents come from one open handle. The log
itself is never moved or changed, so an older version still running
against the same workspace keeps its own record, and nothing has to
write to the log's directory (which may be read-only, with a writable
marker volume mounted beneath it). An unchanged log is skipped by its
metadata alone, even if it can no longer be read. A changed one is
migrated again, so a key an older version commits at any moment, even
while a store is migrating the log, is never accepted as new. Only keys
the store hasn't seen get markers, so a rewrite costs only the keys it
adds. Both the object and the older array format are read. Several
processes can migrate at once safely, since creating an existing marker
is a no-op. A corrupt log still fails loudly rather than being read as
empty, and the store recovers once it's fixed.
- **An actionable error.** When the marker directory can't be created,
the message says what to do: `Cannot record turn advancements under
<dir>: <error>. Point HEADROOM_WORKSPACE_DIR (or the plugin's
commitLogPath) at a writable directory.` A lookup in a store whose path
a file blocks fails the same way on every platform, although Windows
reports such a path as `ENOENT`, which is also what a missing marker
gives.
- **`commitLogPath` is settable.** It's declared in
`openclaw.plugin.json`, with a UI hint and a README row.
- **Tests.** The store suite is rewritten for the new design. It keeps
the existing guarantees: committed, then duplicate; survives a restart;
never evicts across 600 keys; exactly one winner in-process and across
two OS processes; a failed write is retried, not remembered. New tests
cover:
  - a commit stores one small marker holding only the key;
- committing more keys never rewrites an earlier marker (same inode and
mtime);
  - a leftover `.lock` from a crashed process doesn't block a commit;
- a file where the marker directory or a shard directory belongs, and a
directory where a marker belongs: each is an error, never `"duplicate"`,
and the same key commits once the path is cleared;
- a file blocking the store's directory or its marker directory,
reported the way Windows reports it (`ENOENT`, not `ENOTDIR`): a lookup
is a storage error, not an absent key;
  - both legacy formats, including two stores migrating concurrently;
- a legacy log in a read-only directory: commits go through; a restart
doesn't read the unchanged log again; a migrated log that can no longer
be read doesn't block commits; and once the directory is writable, a key
an older version commits the old way (temp file + rename) is migrated
before a running store's next commit;
- a key an older version commits while a store is migrating the log: the
store's next lookup finds it, and its next commit, like a new store's,
is `"duplicate"`;
- an older version rewriting the log: only the key it added gets a
marker;
- a migration record that can't be written: commits go through, in that
store and in one started later;
  - a corrupt legacy log.

In `engine.test.ts`, a commit carrying 1 MB of tool output stores under
1 KB. The lock-holder fixture is removed, since there is no lock.

## Testing

- [ ] Unit tests pass (`pytest`) (n/a, TypeScript plugin only)
- [ ] Linting passes (`ruff check .`) (n/a)
- [ ] Type checking passes (`mypy headroom`) (n/a; `npm run typecheck`
passes)
- [x] New tests added for new functionality
- [x] Manual testing performed (see Real Behavior Proof)

### Test Output

```text
$ cd plugins/openclaw && npm run typecheck        # exit 0
$ npx vitest run                                  # Node v24.21.0, macOS
 Test Files  9 passed (9)
      Tests  139 passed (139)
$ npx vitest run                                  # Node v22.22.0, GitHub Actions windows-latest
 Test Files  9 passed (9)
      Tests  137 passed | 2 skipped (139)
```

## Real Behavior Proof

- Environment: macOS, Node v24.21.0, for the benchmark below: "old" is
`advancement-key-store.ts` from `main`, "new" is this PR, and the same
script drives both. In production: OpenClaw 2026.9.9 on Kubernetes with
a read-only root filesystem and `HEADROOM_WORKSPACE_DIR` on a writable
volume, running the plugin at v0.40.0 from a fork tag, with
`advancement-key-store.ts` identical to a9e9ea6e.
- Exact command / steps: one script drives both stores through the first
three cases, and the last compares production logs:
- commit 300 accepted turns, each carrying 100 KB of tool output, and
time commits #1, #100 and #300;
- commit once with a `commit-log.json.lock` left behind, as a killed
process would leave it;
- commit with the workspace's parent directory not writable (mode 0555);
- in production, compare one gateway's OpenClaw logs over a 12-hour
night on v0.40.0's store with its first 3 hours on this store.
- Observed result: the new store stays small and fast and ignores a
leftover lock. In production, no commit failed and no turn fell back to
legacy.

  | | Old store | New store |
  |---|---|---|
  | Store on disk after 300 turns | 30.0 MB | 0.02 MB |
| Commit #1 / #100 / #300 | 3.3 / 14.3 / 40.4 ms | 2.6 / 0.1 / 0.2 ms |
| Leftover lock file from a crashed process | fails after 60.0 s |
committed immediately |
| Workspace not writable | `EACCES: permission denied, mkdir
'…/.headroom'` | same error, plus which setting fixes it |

In production, v0.40.0's store failed all 53 commits overnight with the
`remains queued` line above, and all 8 later turns of a session fell
back to legacy. On this store, the same gateway made 38 commits in its
first 3 hours, none failed, and no turn fell back. The 5 later turns we
could trace to their session all ran on headroom. The 38 markers take
296 KiB on disk, shard directories included.
- Not tested: the two permission-bit tests (a read-only directory, an
unwritable migration record) on Windows or as root, where they are
skipped, since permission bits don't restrict either. Our production
build predates the last three commits, which change only how a legacy
log is migrated and how a blocked path is reported, and that deployment
never had a legacy log.

## Runtime Rollout Safety

- Rollout-managed feature(s): none.
- Minimum rollout channel: n/a.
- Stable/default behavior changed: the commit store's on-disk format (an
existing log is migrated on first use). The default location is
unchanged.
- Kill switch / disable path: none needed. Pointing `commitLogPath` or
`HEADROOM_WORKSPACE_DIR` elsewhere starts a fresh store.
- Unsafe override required: no.
- Qualification impact: none.
- Rollback path: revert. The old log stays where it was, so an older
version still finds every key it wrote. Keys committed after the upgrade
live only in markers, so an older version could re-accept a turn that
was mid-retry during the downgrade.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes (on Node
24; see Additional Notes)
- [x] I did **not** edit `CHANGELOG.md`

## Additional Notes

- A version older than this one, running at the same moment against the
same workspace, keeps writing the old file, and this store migrates
whatever it adds. The older version doesn't read markers, though, so it
could still accept a key only this version committed. That's the same
mixed-version caveat any format change has.
- Unrelated to this change: the cross-process tests run `node
--experimental-transform-types`, which Node 26 no longer accepts (`bad
option`). They pass on Node 24, which CI uses.

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4212"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-11-03 22:46:13 -06:00
dependabot[bot]andJerrettDavis 99e223c0e2 deps: Bump tsup from 8.5.1 to 9.0.0 in /plugins/opencode (#4385)
Build the OpenCode plugin with the patched esbuild line inside tsup's
supported range. Headroom's existing esbuild 0.28 security override is
outside tsup 8.5.1's ^0.27.0 declaration. Tsup 9 declares ^0.28.2, so
retain the major upgrade and raise the override floor from ^0.28.1 to
^0.28.2. The original tsup 9 lock still selected 0.28.1; this follow-up
corrects that mismatch and documents the source-build requirements.

## Dependency assessment

- **Version reason:** use an upstream-supported build combination for
the existing dependency-security mitigation, rather than forcing the
selected esbuild release outside the old bundler's range. This does not
claim a new advisory in 0.28.1 or that the old built plugin was
demonstrated broken. Tsup remains the existing builder;
[v9](https://github.com/egoist/tsup/releases/tag/v9.0.0) also changes
debug/obug, watchers and related toolchain packages.
- **Maintenance/security:** reviewed the published release/manifest and
resolved graph. Fresh audit reports zero vulnerabilities; this does not
imply every upstream project has a spotless history. Platform-selector
metadata outside the esbuild refresh is preserved instead of accepting
unrelated npm-version normalization.
- **Node/build boundary:** tsup requires `^22.18.0 || ^24.11.0 ||
>=26.0.0`; the current graph's ini 7 also requires `^22.22.2 || ^24.15.0
|| >=26.0.0`. The README documents both and the verified Node 24.22.2
choice. Published plugin/host runtime declarations are unchanged. An
earlier Node 22.22.0 pass emitted the existing ini warning; acceptance
uses the supported Node 24 install.
- **Native/install/network:** existing esbuild/Rollup platform code and
lifecycle scripts remain build inputs. Rollup's optional GNU Linux-x64
LZMA and Android-x64 bindings are present; the LZMA entry is a real
optional dependency, not an orphan. Windows x64 installation/build was
tested; these non-Windows paths were not. No new install-script flag is
introduced. Existing plugin runtime dependencies are unchanged; tsup
remains a development dependency. npm and host support-dependency
installation use the registry. No plugin is published and no
inference/provider message is requested.

The branch is synchronized with main's merged security and SDK updates.

## Real behavior proof

Windows x64 / Node 24.22.2 / npm 10.9.4, fresh isolated checkout. From
`plugins/opencode`, under that Node:

```bash
npm ci --ignore-scripts=false --no-audit --no-fund
npm test
npm run typecheck
npm run build
npm run build:standalone
npm audit --json
node ../../scripts/verify_opencode_bundle.mjs .
```

The install has no engine warning; **61 tests pass**, typecheck and both
builds succeed, audit reports zero vulnerabilities. The committed
portable proof imports actual `dist/index.js` and
`dist-standalone/index.js`, invokes the built server entry and performs
real chat/retrieve HTTP requests against an ephemeral loopback fixture.
It asserts original upstream/path, project/session headers, response and
retrieval content; output reports PASS. The plugin routes the synthetic
OpenAI URL to the fixture. Hooks/sockets/processes are disposed. This is
built-artifact wire behavior, not a claim that the fixture is the Python
service.

**Actual host loading:** installed official `opencode-ai@1.19.4`,
matching the installed 1.x plugin SDK, into a task-only prefix/cache.
Its native Windows `opencode.cmd debug config --print-logs` ran from an
isolated task workspace with the built main entry
`file:///G:/git/headroom-dep4385/plugins/opencode/dist/index.js`
configured directly. No wrapper was used for this check. It exited 0
with successful bootstrap/configuration/disposal and no loader error. A
separate instrumentation probe preserved the exported object shape and
delegated its actual `server` function; it recorded `id=headroom`,
retrieval-tool registration and the shell-environment hook. It did not
adapt the object into a legacy function.

The host's XDG config/data/state/cache point at task-only directories.
Enabled providers are empty; auto-update, remote model fetching and
default plugins are disabled. Credential environment names are removed
in the child shell only; user home/config/auth files are not repurposed.
The CLI installed support dependencies in the isolated config, so
registry traffic occurred. No inference command or provider action was
requested.

Node syntax and whitespace checks pass. Independent technical review
found no code or dependency-policy blocker in the corrected build
range/source-runtime boundaries.

Untested: actual OpenCode 2.x, registry-tarball plugin installation, the
Python compression proxy in this smoke, streaming, live providers,
hook-shim spawning, non-Windows native installation, or production
publishing. Current-head hosted CI must pass before approval.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-03 08:45:19 -06:00
Kenneth WongandKenneth Wong 2e49e5304b fix(deps): clear the glob and minimatch npm audit findings (#4599)
## Description

Since 2026-10-30, `npm audit (e2e/wrap/tools)` and `npm audit
(plugins/opencode)` fail on every PR. Main has not run since, so it will
fail the same way on its next push. Two advisories were published that
day:

- glob
[GHSA-3g3m-2fjr-6pw4](https://github.com/advisories/GHSA-3g3m-2fjr-6pw4)
(moderate): an aborted async walk keeps reading directories after it
rejects. Affects 9.0.0 to 14.0.1; fixed only in 14.0.2.
- minimatch
[GHSA-g3hv-75wg-m249](https://github.com/advisories/GHSA-g3hv-75wg-m249)
(moderate): `**/../` patterns expand the pattern parts exponentially,
then compare every pair, at `optimizationLevel >= 2`. Affects < 11.0.1;
fixed only in 11.0.1.

Neither fix is backported to an older major, and upstream has not moved:
openclaw 2026.10.9 still pins minimatch 10.2.6, and `@opencode/util`
2.2.5 still pins glob 13.0.5 and minimatch 10.2.5.

The undici and ip-address findings in the same logs come from npm
12.2.1's bundled copies. They were already listed in
`e2e/wrap/tools/npm-audit-exceptions.json` and did not fail the job (CI
printed `NOT EXCEPTED` only for glob and minimatch). npm 12.2.1 is still
the latest release, so they stay excepted until the existing 2026-11-15
expiry.

## Type of Change

- [x] 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

- `e2e/wrap/tools/package.json`: override OpenClaw's `minimatch` to
11.0.3, next to its existing `undici` override.
- `e2e/wrap/tools/npm-audit-exceptions.json`: add npm 12.2.1's bundled
`glob` 13.0.6 and `minimatch` 10.2.5 at their exact paths, under the
existing 2026-11-15 expiry. Bundled copies ignore overrides, the same
reason the bundled undici and ip-address are listed.
- `e2e/wrap/tools/dependency-regression.test.cjs`: new test. It counts
minimatch's pairwise `partsMatch` comparisons for a 4096-part `**/../`
pattern in the copy OpenClaw resolves. That's 8,386,560 on 10.2.6 and 0
on 11.0.3. It counts calls instead of timing, so it can't flake on a
slow runner. It fails loudly if minimatch renames `partsMatch`.
- `e2e/wrap/tools/README.md`: list the new check.
- `plugins/opencode/package.json`: override `glob` to 14.0.3 and
`minimatch` to 11.0.3. Every copy is a dev dependency
(`@opencode/plugin`, npm's `@npmcli/*` tooling, `rimraf` under
`gaxios`). glob 14 is required: minimatch 11 changes `Minimatch.set`
entries from `RegExp`s to `Matcher` objects, which globs before 14 rely
on.
- Both `package-lock.json` files are regenerated with npm 11.16.0 (`npm
install --package-lock-only`):
- e2e: only `minimatch` 10.2.6 → 11.0.3, plus its new dependency
`@isaacs/nonrecursive-glob-match`.
- opencode: `glob` 13.0.5 → 14.0.3, `minimatch` 10.2.5 → 11.0.3 and
`path-scurry` 2.0.2 → 3.0.0. rimraf's nested glob 10 and its old CLI
helper packages drop out.

## Testing

- [x] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
# CI's audit step, run locally (the Python exception check copied from .github/workflows/security.yml)
$ cd plugins/opencode && npm audit --package-lock-only --audit-level=low
found 0 vulnerabilities
$ cd e2e/wrap/tools && npm audit --package-lock-only --json > audit.json && python3 ci_audit_check.py audit.json
Only excepted bundled advisories remain (8), until 2026-11-15.

# e2e/wrap/tools: npm ci of main's lock (minimatch 10.2.6), then the new test file
not ok 2 - minimatch bounds the **/.. expansion instead of comparing every pair (GHSA-g3hv-75wg-m249)
  error: '8386560 pairwise part comparisons'
# pass 2
# fail 1
# npm ci of this branch's lock (minimatch 11.0.3)
ok 1 - Ajv rejects a percent-encoded scheme instead of aliasing an HTTPS schema
ok 2 - minimatch bounds the **/.. expansion instead of comparing every pair (GHSA-g3hv-75wg-m249)
ok 3 - unsupported charset with invalid gzip leaves the Express process healthy
# pass 3
# fail 0

# plugins/opencode after npm ci of this branch's lock
$ npm test
 Test Files  4 passed (4)
      Tests  61 passed (61)
$ npm run typecheck        # exit 0
$ npm run build            # ESM + DTS build success
$ npm run build:standalone # ESM build success, dist-standalone/index.js 759.23 KB
```

## Real Behavior Proof

- Environment: macOS 27 (arm64), Node 24.22.2; npm 11.16.0 for the
lockfiles; a fresh `npm ci --ignore-scripts` of each lock in a scratch
directory.
- Exact command / steps: (1) the audit commands above. (2) `openclaw
--version`, `openclaw config file` and `openclaw health` from the new
e2e install, in a temporary HOME. (3) Dynamically import each OpenClaw
dist module that imports minimatch (`policy-*`,
`systemd-service-files-*`, `workspace-bootstrap-policy-*`). (4) grep
both OpenCode builds for glob/minimatch code.
- Observed result: both audits pass. `openclaw --version` prints
`OpenClaw 2026.10.6 (fe06181)`, `config file` prints the config path,
and `health` reports the expected missing-credentials message. All three
modules load on minimatch 11.0.3. Neither `dist/index.js` nor
`dist-standalone/` (the copy shipped in the wheel) contains glob or
minimatch code, so the OpenCode change does not change shipped code.
- Not tested: the Docker wrap E2E locally; this PR's `docker-native-e2e`
and Wrap E2E jobs run it, since their path filters include `e2e/**`.

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: n/a, dependency pins for the E2E harness and
the OpenCode plugin's dev tooling
- Stable/default behavior changed: no shipped code changes. The E2E
image's OpenClaw now loads minimatch 11.0.3. One OpenClaw path relies on
minimatch 10 internals: `expandSystemdEnvironmentFilePattern` (systemd
`EnvironmentFile=` patterns with wildcards) checks `part instanceof
RegExp`. On 11 those parts are `Matcher` objects, so wildcard entries
would match no files. It runs only for an installed systemd unit; the
harness runs `openclaw gateway --bind loopback` in the foreground, so it
never reaches that path.
- Kill switch / disable path: none needed
- Unsafe override required: no
- Qualification impact: none expected for the wheel or SDK; the E2E
harness picks up the new lock on its next image build
- Rollback path: revert this commit

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] 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

**Dependency justification** (CONTRIBUTING, "Dependencies & supply
chain"):

| Package | Why this version | Maintainer, activity | Install surface |
|---|---|---|---|
| `glob` 13.0.5 → 14.0.3 (opencode, dev only) | Security patch:
GHSA-3g3m-2fjr-6pw4 is fixed only in 14.0.2. 14.0.3 is the latest and
needs the minimatch 11 below. | isaacs (sole npm maintainer) since 2011,
[isaacs/node-glob](https://github.com/isaacs/node-glob). 14 releases in
the last 12 months; 14.0.3 published 2026-10-28. Earlier advisory:
GHSA-5j98-mcp5-4vw2 (high, 2025-11, CLI `--shell`, fixed in 12). | Deps:
minipass, minimatch, path-scurry. No native code. No install-time script
(`prepare` runs only for git or local installs). No network use. |
| `minimatch` → 11.0.3 (opencode dev; e2e via openclaw) | Security
patch: GHSA-g3hv-75wg-m249 is fixed only in 11.0.1. 11.0.3 is the
latest. | isaacs since 2011,
[isaacs/minimatch](https://github.com/isaacs/minimatch). 35 releases in
the last 12 months, many of them ReDoS hardening. Earlier advisories:
three highs in 2026-02 and older ReDoS fixes (2022, 2018), all fixed.
11.0 replaces per-portion `RegExp`s with a non-recursive matcher, the
structural fix for that class. | Deps: brace-expansion and the new
package below. No native code, install-time script or network use. |
| `path-scurry` 2.0.2 → 3.0.0 (opencode, dev only) | Required by glob
14. | isaacs,
[isaacs/path-scurry](https://github.com/isaacs/path-scurry). 3 releases
in the last 12 months; no advisories. | Deps: minipass, lru-cache. No
native code, install-time script or network use. |
| `@isaacs/nonrecursive-glob-match` 1.0.3 (new, both lockfiles) |
Required by minimatch 11; it is the new matcher that replaces the
`RegExp` path. | isaacs, source at
[isaacs/nonrecursive-glob-match](https://github.com/isaacs/nonrecursive-glob-match)
(repo created 2026-03-06; the npm manifest omits its `repository`
field). **New:** first npm release 2026-10-26, 5 versions so far, no
advisories yet. | No dependencies. No native code, install-time script
or network use. 380 KB unpacked. |

None of the four tarballs has npm provenance attestations; each carries
registry signatures, and the lockfiles pin their integrity hashes. The
new matcher package is the one with no track record. It is accepted here
only because it is now a hard dependency of the only fixed minimatch
release, from the same maintainer as minimatch and glob.

- "Unit tests pass" covers the e2e `npm test` and OpenCode's vitest
suite; no Python changed, so ruff and mypy are left unchecked.
- Deadline: `npm-audit-exceptions.json` still expires on **2026-11-15**.
I kept the existing date rather than extend it. After that day, `npm
audit (e2e/wrap/tools)` fails on every PR by design until someone acts.
Before then:
- If npm has shipped a release bundling glob ≥ 14.0.2, minimatch ≥
11.0.1, undici ≥ 6.29.1 and ip-address ≥ 10.7.4, bump the `npm` override
and delete the exceptions.
  - If not, move `expires` with a one-line reason.
- Revisit the openclaw and OpenCode overrides once openclaw and
`@opencode/util` move to the fixed majors themselves.

https://claude.ai/code/session_01S4VPhWACY6qi2jBcN3M2sr

Co-authored-by: Kenneth Wong <17061293+KennethWKZ@users.noreply.github.com>
2026-11-03 08:12:57 +05:30
ShiYuan XiongandJerrettDavis 4ee616453f fix(router): keep small shell results verbatim (#3590) (#4426)
## Description

Fixes #3590. Small shell tool results (default: shorter than 2000
characters) now bypass lossy compression. Byte-lossless folds such as
search grouping may still apply. File reads and searches were already
protected; shell output is deliberately compressible, but a short `ls
-la`, `git status`, or JSON dump is not worth the accuracy loss
described in #3590.

The real proxy-level before/after evidence is in Real Behavior Proof. A
live Claude Code session is still untested.

## Type of Change

- [x] 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

- Added `HEADROOM_SHELL_RESULT_MIN_CHARS` (default `2000`) and
`_is_small_shell_result()`, applied to OpenAI `role:"tool"`, legacy
`role:"function"`, top-level text-block tool messages, and Anthropic
`tool_result` string/list-form paths after the lossless search fold and
before lossy compression.
- Normalized `ContentRouterConfig.bash_tool_names` once and extended it
with the shell aliases already in `headroom.learn._shared` (`shell`,
`local_shell`, `run_shell_command`, `execute_command`, `exec_command`,
`terminal`, `run_command`, `run_terminal_command`).
- Measure a top-level text-block shell result using the combined text
length, so a large result cannot bypass compression merely by splitting
into small blocks.
- Added boundary coverage for both tool/function block shapes, positive
threshold overrides and custom case-insensitive shell names; documented
the combined-length contract in `docs/content/docs/proxy.mdx`.
- Updated the existing proxy-level Bash regression to assert both sides
of the 2000-character floor, fixing the hosted shard-4 failure. Added
kill-switch, malformed/empty-value and diagnostic coverage.
- Carried dependency security remediation requested in review: certifi
and the OpenTelemetry family, three patched Rust crates, and patched npm
locks for docs, SDK, OpenCode and E2E tooling. These use existing
packages, explicit security floors and targeted dependency overrides;
libc platform constraints remain intact.

## Testing

- [x] Hosted CI passes on the current head, including all four Python
test shards
- [x] Changed Python tests passed Ruff in the preceding regression
revision; no Python runtime source changed in this dependency follow-up
- [ ] Full local Python type check passes (Windows/test-double baseline
limitations)
- [x] Regression and dependency-interface coverage added
- [x] Real proxy proof and isolated CLI smoke evidence recorded

### Test Output

Latest follow-up: Windows, Python 3.11 / Node 22.20.0 for the OpenCode
suite, and portable official Node 24.22.1 for E2E CLI qualification. The
portable Node archive's SHA-256 matched nodejs.org's published checksum.

```text
Python shell-floor/web-tool/router/alias/tracing + OpenClaw wrapper/bridge selection:
119 passed, 2 warnings in 10.37s

uv lock --check
Resolved 262 packages

uv tree --locked --python-version 3.10 --package filelock
filelock v4.1.0
uv tree --locked --python-version 3.12 --package filelock
filelock v4.2.4

FileLock 4.2.4 process smoke:
contention times out, release permits next process

cd plugins/opencode
npm test
Test Files  4 passed (4)
Tests       60 passed (60)
npm run typecheck
> node node_modules/@typescript/native/bin/tsc --noEmit
npm run build
DTS Build success
npm audit --package-lock-only --audit-level=low --registry=https://registry.npmjs.org
found 0 vulnerabilities

After merging current upstream main (including #4453):

cd e2e/wrap/tools
node node_modules/openclaw/openclaw.mjs --version
OpenClaw 2026.10.6
npm audit --package-lock-only --audit-level=low --registry=https://registry.npmjs.org
2 vulnerabilities (1 moderate, 1 high)
# limited to npm's bundled copies:
# GHSA-rxp7-6hxx-x8q5 — node_modules/npm/node_modules/ip-address 10.7.2
# GHSA-4qv8-2p9j-2685 and GHSA-xjj6-f33q-929c — node_modules/npm/node_modules/undici 6.29.0
# exact scoped exceptions expire 2026-11-15; no OpenClaw path is excepted

production-lock pip-audit:
No known vulnerabilities found
```

- The Python native extension remains the existing 0.41.0 Windows
wheel's `_core.pyd`; all Python source under test comes from this PR
checkout. No native rebuild or Torch/model inference qualification is
claimed.
- The 3 new OpenCode compatibility tests exercise the actual upstream
`tool.schema` interface and Effect `Primitive.fileParse` TOML
success/error channels, mocking only filesystem I/O. They accompany the
explicit Zod/TOML overrides.
- E2E CLI checks used isolated `OPENCLAW_STATE_DIR` /
`OPENCLAW_CONFIG_PATH`, with no model request or modification of the
user's normal OpenClaw configuration. E2E dependencies were installed
with lifecycle scripts disabled. The full Docker/model E2E suite was not
run locally.
- Earlier unchanged docs/SDK lock remediation passed: SDK **351 passed,
33 skipped** plus typecheck/build; docs typecheck/build with 185 static
pages; both npm audits were zero. The previous head also passed the
hosted Rust security audit.
- Full local Python suite was not rerun. The earlier remote-timeout
float-boundary failure remains outside this change.

## Real Behavior Proof

- Environment: Windows 10 x64, Python 3.11.0, Headroom source `main` at
`e995eb9` (0.41.1-dev), native `_core` from the 0.41.0 wheel because no
Rust toolchain is available locally. `HEADROOM_DISABLE_KOMPRESS=1` keeps
the strategy deterministic; the guard sits before strategy selection, so
the same path applies when Kompress is enabled.
- Exact command / steps: local harness (not committed) `python
proof-3590/run_proof.py` starts the source-tree proxy in `--mode token`
with `HEADROOM_MIN_TOKENS=0` and a local OpenAI-compatible upstream, and
sends a chat request containing a Bash `ps aux` tool result (1719 chars)
followed by later turns. The upstream records the transformed request
body.
- Observed result: `HEADROOM_SHELL_RESULT_MIN_CHARS=0` produced
`compressed=1`, `router:tabular:0.85`, 802 -> 697 tokens (saved 105),
and upstream received a 1455-char schema representation. Default `2000`
produced `shell_small_result: 1`, `compressed=0`, 802 -> 802 tokens, and
upstream received the original 1719-char output byte-for-byte.
- Review follow-up proof: `python proof-3590/run_block_review.py` ran
the real proxy against the same local upstream without replacing its
compressor. A 1719-character shell result split into two text blocks
stayed unchanged; a 3438-character result split into two 1719-character
blocks remained compressible. The previous PR revision incorrectly
protected both large-result fragments. This harness is local, not part
of the PR.
- Not tested: a live `headroom wrap claude` session; the ML Kompress
path; Linux/macOS; the full suite (one pre-existing baseline failure).

## Runtime Rollout Safety

- Rollout-managed feature(s): none; ContentRouter default path.
- Minimum rollout channel: default proxy.
- Stable/default behavior changed: yes. Shell results between
`min_chars_for_block_compression` (500) and
`HEADROOM_SHELL_RESULT_MIN_CHARS` (2000) now stay verbatim instead of
taking lossy compression. At ~1500 chars (~375 tokens), this keeps
roughly 325 extra tokens per result for the life of the context.
- Kill switch / disable path: `HEADROOM_SHELL_RESULT_MIN_CHARS=0`.
- Unsafe override required: no.
- Qualification impact: compression ratio may decrease for small shell
outputs; no API or correctness changes.
- Rollback path: revert this commit or set
`HEADROOM_SHELL_RESULT_MIN_CHARS=0`.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] 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
- [x] 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 — no UI changes.

## Additional Notes

This follows the [dependency-remediation
review](https://github.com/headroomlabs-ai/headroom/pull/4426#pullrequestreview-5636487191).
It does not disable audits, ignore advisories, reduce audit severity, or
use `npm audit fix --force`.

- **Python:** certifi/OpenTelemetry/Rust fixes from the prior revision
remain. This follow-up raises setuptools to **84.1.0** for the Windows
wheel namespace traversal advisory and uses FileLock **4.2.4** on Python
≥3.11. The universal lock remains resolvable with the published Python
≥3.10 contract. **Python 3.10 now selects FileLock 4.1.0, but it remains
below the 4.2.1 security floor** because fixed releases require ≥3.11;
this is not presented as all-interpreter remediation.
- **OpenCode:** pin security overrides **Zod 4.6.7** and **TOML 5.0.1**
without downgrading the plugin or replacing its pinned Effect version.
TOML crosses a major version (4.3.0 → 5.0.1); its Node ≥20 floor and
consumed `parse(content)` API are unchanged. The added tests validate
the exercised schema and Effect parsing contracts, not every possible
TOML consumer. This override needs normal maintainer dependency review.
- **E2E:** the original remediation moved OpenClaw to 2026.10.5; the
upstream sync now brings **OpenClaw 2026.10.6** with **Undici 8.12.3**
and a Node floor of **≥24.22.1 <25 or ≥26.12.1**. The only remaining raw
npm findings are npm's published bundled copies, handled by the exact,
expiring E2E-only exception policy described below.
- Dependency packages and runtime floors were checked against the
upstream registry metadata. Locks use public registries and retain
existing libc platform constraints.

### Security qualification after upstream sync

Merge commit `e09d37c9274c812f26e994d01a623542a4a7ec31` brings this
branch to upstream `main` through `a616232`, including
[#4453](https://github.com/headroomlabs-ai/headroom/pull/4453). That
upstream change establishes the repository's current security policy for
the dependency cases that previously blocked this PR:

- **Production Python lock:** Python ≥3.11 resolves Pillow 13.0.0 and
FileLock 4.2.4. The current lock passes `uv lock --check`; an equivalent
export of the production `all` set passes `pip-audit 2.10.1 --no-deps
--disable-pip` with **no known vulnerabilities**.
- **Published-package resolution:** FastEmbed still caps Pillow below 13
when ordinary pip resolves package metadata. Upstream now disables image
decoding on Pillow below 13 and separately audits the pip-resolved set,
accepting only Pillow findings covered by that tested decoder guard.
This is a bounded runtime mitigation, not a claim that the older Pillow
release has no advisories.
- **E2E npm lock:** OpenClaw 2026.10.6 uses fixed Undici 8.12.3. Raw npm
audit now reports only npm 12.2.1's bundled Undici 6.29.0 and ip-address
10.7.2 copies. Because npm does not allow overrides to replace its
published bundled contents and no newer release is available, upstream
accepts only the three exact advisory/path/version pairs in
`e2e/wrap/tools/npm-audit-exceptions.json`, only for the non-shipping
E2E harness, and only until **2026-11-15**. The workflow fails on any
extra finding, version/path mismatch, stale exception or expiry.
- **Python 3.10:** the lock now selects FileLock 4.1.0, but it remains
below the 4.2.1 security floor because fixed releases require Python
≥3.11. This supported-interpreter limitation is documented by the
upstream policy and is not represented as universal remediation.

The earlier OpenCode standalone-wheel mismatch remains fixed by
`dee73be75cf81bb67a73573861f1b3ed4067a2bf`: typecheck, build, all 60
plugin tests and the standalone build passed locally, both generated
artifacts matched their Python-shipped paths byte-for-byte, and the
shipped bundle imported with the expected `headroom` id and both
`server`/`setup` entry points.

### Current merge status

- Current head `ab93d7917a6660c704069bb87b6c02f9c744cebc` is mergeable;
all router/documentation inline review threads are resolved.
- JerrettDavis approved this head on 2026-10-24, superseding the earlier
security-related change requests.
- All 12 pull-request workflows on this head completed successfully,
including
[CI](https://github.com/headroomlabs-ai/headroom/actions/runs/40122163824)
(all four Python test shards),
[Security](https://github.com/headroomlabs-ai/headroom/actions/runs/40122163777),
wheel builds/import smoke tests, OpenCode, docs, and Docker E2E checks.
The workflows are no longer awaiting approval.
- The PR remains open, awaiting maintainer merge.
- A live Claude Code/model session, the ML Kompress path, a native
rebuild and the full Docker/model E2E suite remain unverified locally;
the hosted results above are separate from the recorded local
qualification.

Implemented and verified with AI assistance.

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-28 23:31:00 -05:00
liuyongcheng0000andJerrett Davis 33f204406c fix(openclaw/release): ship responsive npm integrations (#1458)
## Description

Fixes #977 and #2353.

The v0.35.0 release built all three JavaScript packages successfully,
but npm rejected every publish with ENEEDAUTH. Because each publish step
used continue-on-error, the publish-npm job still concluded success. npm
therefore remains on headroom-ai 0.22.4 and headroom-openclaw 0.1.0,
while headroom-opencode is absent.

The checked-in OpenClaw source had already corrected the old
strict-schema mismatch and added a circuit breaker, but its assemble
hook still called compression for every tiny conversation and allowed a
30-second default wait. This PR completes both the runtime correction
and the delivery path instead of merely exposing one failure.

## Changes

### OpenClaw runtime

- Skip proxy compression below an 800-character context floor (roughly
200 tokens), avoiding synchronous HTTP work on short conversations that
cannot produce meaningful savings.
- Measure actual content, including tool-call arguments, so a single
large tool result remains eligible.
- Allow operators to disable the floor with minContextChars=0.
- Lower the interactive request ceiling from 30 seconds to 2 seconds.
- Pass that timeout into the SDK, whose AbortSignal cancels the HTTP
request, instead of racing a promise while the fetch continues in the
background.
- Preserve circuit-breaker fail-open behavior and document/schema the
new defaults.

### npm release integrity

- Authenticate with npm before publishing any package, so a missing or
invalid NPM_TOKEN fails before a partial release begins.
- Make SDK, OpenClaw, and OpenCode npm publish failures fatal when npm
publishing is enabled.
- Preserve NPM_SKIP=true as the explicit opt-out.
- Make retries safe after partial publication by skipping only the exact
package version already present, then continuing to missing packages.
- Remove the false-success notice path.

## Existing #977 corrections verified

- The current OpenClaw schema declares startupTimeoutMs,
routeCodexViaProxy, gatewayProviderIds, request timeout, and
circuit-breaker fields written/used by the installer and runtime.
- wrap defaults to the real published package name, headroom-openclaw.
- unwrap removes managed values while preserving unrelated user
configuration.
- The coding savings profile uses protect_recent=0 paired with
type-based recent-read protection, avoiding the old blanket
short-session protection without weakening tool-result fidelity.

## Testing

- 80 OpenClaw plugin tests pass.
- TypeScript typecheck and production build pass.
- 123 OpenClaw wrap/provider, savings-profile, compress endpoint, and
MCP contract tests pass.
- 47 release-workflow and MCP contract tests pass.
- The npm release asset builder installed/imported and verified the
actual 0.35.1 SDK and OpenClaw tarballs.
- Workflow YAML parses; Ruff, format, and git diff checks pass.

## Required repository action

A maintainer must replace or restore the npm publishing credential in
NPM_TOKEN, then rerun the v0.35.0 release workflow (or publish the next
version). This PR makes that failure visible and safely rerunnable;
repository code cannot provision the external npm credential.

Co-authored with @liuyongcheng0000, whose original PR identified the
masked npm failures.
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/1458"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Jerrett Davis <mxjerrett@gmail.com>
2026-10-28 17:40:52 -05:00
dependabot[bot] f367728051 deps: Bump the npm-minor-patch group across 3 directories with 9 updates (#4495)
Bumps the npm-minor-patch group with 2 updates in the /plugins/openclaw
directory: headroom-ai and
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest).
Bumps the npm-minor-patch group with 3 updates in the /plugins/opencode
directory: headroom-ai,
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
and [@opencode/plugin](https://github.com/anomalyco/opencode).
Bumps the npm-minor-patch group with 7 updates in the /sdk/typescript
directory:

| Package | From | To |
| --- | --- | --- |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.3` | `5.0.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.3` | `5.0.5` |
|
[@ai-sdk/anthropic](https://github.com/vercel/ai/tree/HEAD/packages/anthropic)
| `4.0.78` | `4.0.87` |
|
[@ai-sdk/openai](https://github.com/vercel/ai/tree/HEAD/packages/openai)
| `4.0.91` | `4.0.101` |
|
[@ai-sdk/provider](https://github.com/vercel/ai/tree/HEAD/packages/provider)
| `4.0.26` | `4.0.33` |
| [ai](https://github.com/vercel/ai/tree/HEAD/packages/ai) | `7.0.137` |
`7.0.152` |
| [dotenv](https://github.com/motdotla/dotenv) | `18.0.7` | `18.0.9` |
| [openai](https://github.com/openai/openai-node) | `7.32.0` | `7.43.0`
|
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.3` | `5.0.5` |


Updates `headroom-ai` from 0.40.0 to 0.41.0

Updates `vitest` from 5.0.3 to 5.0.5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.5</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Keep vite default <code>fs.deny</code> with api token file  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11578">vitest-dev/vitest#11578</a>
<a href="https://github.com/vitest-dev/vitest/commit/28dc1edfb"><!-- raw
HTML omitted -->(28dc1)<!-- raw HTML omitted --></a></li>
<li>Handle quoted file names in <code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11583">vitest-dev/vitest#11583</a>
<a href="https://github.com/vitest-dev/vitest/commit/14921e962"><!-- raw
HTML omitted -->(14921)<!-- raw HTML omitted --></a></li>
<li>Add <code>data</code> to the <code>import.meta.hot</code> stub  - 
by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11590">vitest-dev/vitest#11590</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a8289ac3"><!-- raw
HTML omitted -->(3a828)<!-- raw HTML omitted --></a></li>
<li>Set <code>skip</code> in <code>skipIf</code>, ignore
<code>undefined</code> options  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11591">vitest-dev/vitest#11591</a>
<a href="https://github.com/vitest-dev/vitest/commit/d523a15f2"><!-- raw
HTML omitted -->(d523a)<!-- raw HTML omitted --></a></li>
<li>Skip builtin loading in async leak detector  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11598">vitest-dev/vitest#11598</a>
<a href="https://github.com/vitest-dev/vitest/commit/fe86a64c6"><!-- raw
HTML omitted -->(fe86a)<!-- raw HTML omitted --></a></li>
<li>Keep the import frame in native loader errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11599">vitest-dev/vitest#11599</a>
<a href="https://github.com/vitest-dev/vitest/commit/9697b3894"><!-- raw
HTML omitted -->(9697b)<!-- raw HTML omitted --></a></li>
<li>Run hook cleanups when a later hook fails  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11605">vitest-dev/vitest#11605</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c5a44720"><!-- raw
HTML omitted -->(6c5a4)<!-- raw HTML omitted --></a></li>
<li>Release mocks of finished test files  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11607">vitest-dev/vitest#11607</a>
<a href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0"><!-- raw
HTML omitted -->(e9c3d)<!-- raw HTML omitted --></a></li>
<li>Abort all running tests on cancel  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11606">vitest-dev/vitest#11606</a>
<a href="https://github.com/vitest-dev/vitest/commit/6621a72d6"><!-- raw
HTML omitted -->(6621a)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Ignore synthetic pagehide events  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11582">vitest-dev/vitest#11582</a>
<a href="https://github.com/vitest-dev/vitest/commit/ca0813584"><!-- raw
HTML omitted -->(ca081)<!-- raw HTML omitted --></a></li>
<li>Run plugin buildStart on server creation  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11593">vitest-dev/vitest#11593</a>
<a href="https://github.com/vitest-dev/vitest/commit/ea611e44c"><!-- raw
HTML omitted -->(ea611)<!-- raw HTML omitted --></a></li>
<li>Drop late connections of closed sessions  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11600">vitest-dev/vitest#11600</a>
<a href="https://github.com/vitest-dev/vitest/commit/f161e6df2"><!-- raw
HTML omitted -->(f161e)<!-- raw HTML omitted --></a></li>
<li>Wait 30s for the browser to close  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11601">vitest-dev/vitest#11601</a>
<a href="https://github.com/vitest-dev/vitest/commit/6498b666a"><!-- raw
HTML omitted -->(6498b)<!-- raw HTML omitted --></a></li>
<li>Run global setup once with instances  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11596">vitest-dev/vitest#11596</a>
<a href="https://github.com/vitest-dev/vitest/commit/8dd67c262"><!-- raw
HTML omitted -->(8dd67)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>reporter</strong>:
<ul>
<li>End reason
<code>&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);failed&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);</code>
on worker crash  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11568">vitest-dev/vitest#11568</a>
<a href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff"><!-- raw
HTML omitted -->(6ae8e)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.4...v5.0.5">View
changes on GitHub</a></h5>
<h2>v5.0.4</h2>
<h3>   🚀 Features</h3>
<ul>
<li><strong>experimental</strong>:
<ul>
<li>Tag cache directories with CACHEDIR.TAG  -  by <a
href="https://github.com/lifeiscontent"><code>@​lifeiscontent</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11461">vitest-dev/vitest#11461</a>
<a href="https://github.com/vitest-dev/vitest/commit/a8ea3c8fd"><!-- raw
HTML omitted -->(a8ea3)<!-- raw HTML omitted --></a></li>
<li>Support <code>test.ui.theme</code> option  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11499">vitest-dev/vitest#11499</a>
<a href="https://github.com/vitest-dev/vitest/commit/1da66405d"><!-- raw
HTML omitted -->(1da66)<!-- raw HTML omitted --></a></li>
<li>Highlight selector multiple matches in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11489">vitest-dev/vitest#11489</a>
<a href="https://github.com/vitest-dev/vitest/commit/5abba1e1b"><!-- raw
HTML omitted -->(5abba)<!-- raw HTML omitted --></a></li>
<li>Print how many tests were affected and a total when running
<code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11424">vitest-dev/vitest#11424</a>
<a href="https://github.com/vitest-dev/vitest/commit/a23368585"><!-- raw
HTML omitted -->(a2336)<!-- raw HTML omitted --></a></li>
<li>Add an option to cache dependencies instead of statically parsing
them  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11515">vitest-dev/vitest#11515</a>
<a href="https://github.com/vitest-dev/vitest/commit/c06012ac8"><!-- raw
HTML omitted -->(c0601)<!-- raw HTML omitted --></a></li>
<li>Add fit and zoom controls to trace viewer  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11490">vitest-dev/vitest#11490</a>
<a href="https://github.com/vitest-dev/vitest/commit/f5dd99ed0"><!-- raw
HTML omitted -->(f5dd9)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Fail the run on git and location filter errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11430">vitest-dev/vitest#11430</a>
<a href="https://github.com/vitest-dev/vitest/commit/30d0304d2"><!-- raw
HTML omitted -->(30d03)<!-- raw HTML omitted --></a></li>
<li>Enable fsModuleCache by default  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11435">vitest-dev/vitest#11435</a>
<a href="https://github.com/vitest-dev/vitest/commit/ad208cc29"><!-- raw
HTML omitted -->(ad208)<!-- raw HTML omitted --></a></li>
<li>Track project files and mocks with --changed  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11432">vitest-dev/vitest#11432</a>
<a href="https://github.com/vitest-dev/vitest/commit/b0f2b3bb9"><!-- raw
HTML omitted -->(b0f2b)<!-- raw HTML omitted --></a></li>
<li>Refactor caching, fix <code>:</code> in project and change the shape
of <code>results</code> cache  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11453">vitest-dev/vitest#11453</a>
<a href="https://github.com/vitest-dev/vitest/commit/9673c49a4"><!-- raw
HTML omitted -->(9673c)<!-- raw HTML omitted --></a></li>
<li>Keep full <code>$</code> string values when
<code>taskTitleValueFormatTruncate</code> is 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11485">vitest-dev/vitest#11485</a>
<a href="https://github.com/vitest-dev/vitest/commit/4f7e1799b"><!-- raw
HTML omitted -->(4f7e1)<!-- raw HTML omitted --></a></li>
<li>Resolve node builtins in client environments  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11417">vitest-dev/vitest#11417</a>
<a href="https://github.com/vitest-dev/vitest/commit/56b319ac6"><!-- raw
HTML omitted -->(56b31)<!-- raw HTML omitted --></a></li>
<li>Fix module graph builtin externals after <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11421">#11421</a>
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11491">vitest-dev/vitest#11491</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11421">vitest-dev/vitest#11421</a>
<a href="https://github.com/vitest-dev/vitest/commit/008e184cb"><!-- raw
HTML omitted -->(008e1)<!-- raw HTML omitted --></a></li>
<li>Wrap module mocks during in-source testing  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11505">vitest-dev/vitest#11505</a>
<a href="https://github.com/vitest-dev/vitest/commit/36d19cb00"><!-- raw
HTML omitted -->(36d19)<!-- raw HTML omitted --></a></li>
<li>Handle line endings in snapshot  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11522">vitest-dev/vitest#11522</a>
<a href="https://github.com/vitest-dev/vitest/commit/4c468aa40"><!-- raw
HTML omitted -->(4c468)<!-- raw HTML omitted --></a></li>
<li>Respect root in projects  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11521">vitest-dev/vitest#11521</a>
<a href="https://github.com/vitest-dev/vitest/commit/26642f793"><!-- raw
HTML omitted -->(26642)<!-- raw HTML omitted --></a></li>
<li>Resolve mocks in directories with spaces  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11539">vitest-dev/vitest#11539</a>
<a href="https://github.com/vitest-dev/vitest/commit/caaef9416"><!-- raw
HTML omitted -->(caaef)<!-- raw HTML omitted --></a></li>
<li><strong>api</strong>:
<ul>
<li>Publish the api token atomically  -  by <a
href="https://github.com/umairnawaz333"><code>@​umairnawaz333</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11323">vitest-dev/vitest#11323</a>
<a href="https://github.com/vitest-dev/vitest/commit/6f990fef1"><!-- raw
HTML omitted -->(6f990)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>browser</strong>:</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a825db43e2beca0b219d2eadaec334cb81af0c7"><code>7a825db</code></a>
chore: release v5.0.5 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11609">#11609</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6621a72d6ed371e43f80ff327f5063693bd6b1ad"><code>6621a72</code></a>
fix: abort all running tests on cancel (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11606">#11606</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0c8d6867de06a3df43ea28a05eeec444"><code>e9c3d72</code></a>
fix: release mocks of finished test files (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11607">#11607</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/8dd67c2625943d824e257b87ae57a14094e90eed"><code>8dd67c2</code></a>
fix(browser): run global setup once with instances (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11596">#11596</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6c5a447203a29a0708fbc5de4fb91ea501bdc395"><code>6c5a447</code></a>
fix: run hook cleanups when a later hook fails (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11605">#11605</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9697b3894f456b85db91f3824ebe833449305c04"><code>9697b38</code></a>
fix: keep the import frame in native loader errors (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11599">#11599</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6498b666a3ae8961f6f2a8abdc89015b6fd0b3aa"><code>6498b66</code></a>
fix(browser): wait 30s for the browser to close (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11601">#11601</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f161e6df2b3c0bc84982d374094379139e380791"><code>f161e6d</code></a>
fix(browser): drop late connections of closed sessions (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11600">#11600</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fe86a64c6c6aa75481bffe5880b5c4e35ea67927"><code>fe86a64</code></a>
fix: skip builtin loading in async leak detector (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11598">#11598</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff0734cf476e30186a83aebe6771aa330"><code>6ae8e89</code></a>
fix(reporter): end reason <code>'failed'</code> on worker crash (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11568">#11568</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.5/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.40.0 to 0.41.0

Updates `vitest` from 5.0.3 to 5.0.5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.5</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Keep vite default <code>fs.deny</code> with api token file  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11578">vitest-dev/vitest#11578</a>
<a href="https://github.com/vitest-dev/vitest/commit/28dc1edfb"><!-- raw
HTML omitted -->(28dc1)<!-- raw HTML omitted --></a></li>
<li>Handle quoted file names in <code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11583">vitest-dev/vitest#11583</a>
<a href="https://github.com/vitest-dev/vitest/commit/14921e962"><!-- raw
HTML omitted -->(14921)<!-- raw HTML omitted --></a></li>
<li>Add <code>data</code> to the <code>import.meta.hot</code> stub  - 
by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11590">vitest-dev/vitest#11590</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a8289ac3"><!-- raw
HTML omitted -->(3a828)<!-- raw HTML omitted --></a></li>
<li>Set <code>skip</code> in <code>skipIf</code>, ignore
<code>undefined</code> options  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11591">vitest-dev/vitest#11591</a>
<a href="https://github.com/vitest-dev/vitest/commit/d523a15f2"><!-- raw
HTML omitted -->(d523a)<!-- raw HTML omitted --></a></li>
<li>Skip builtin loading in async leak detector  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11598">vitest-dev/vitest#11598</a>
<a href="https://github.com/vitest-dev/vitest/commit/fe86a64c6"><!-- raw
HTML omitted -->(fe86a)<!-- raw HTML omitted --></a></li>
<li>Keep the import frame in native loader errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11599">vitest-dev/vitest#11599</a>
<a href="https://github.com/vitest-dev/vitest/commit/9697b3894"><!-- raw
HTML omitted -->(9697b)<!-- raw HTML omitted --></a></li>
<li>Run hook cleanups when a later hook fails  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11605">vitest-dev/vitest#11605</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c5a44720"><!-- raw
HTML omitted -->(6c5a4)<!-- raw HTML omitted --></a></li>
<li>Release mocks of finished test files  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11607">vitest-dev/vitest#11607</a>
<a href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0"><!-- raw
HTML omitted -->(e9c3d)<!-- raw HTML omitted --></a></li>
<li>Abort all running tests on cancel  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11606">vitest-dev/vitest#11606</a>
<a href="https://github.com/vitest-dev/vitest/commit/6621a72d6"><!-- raw
HTML omitted -->(6621a)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Ignore synthetic pagehide events  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11582">vitest-dev/vitest#11582</a>
<a href="https://github.com/vitest-dev/vitest/commit/ca0813584"><!-- raw
HTML omitted -->(ca081)<!-- raw HTML omitted --></a></li>
<li>Run plugin buildStart on server creation  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11593">vitest-dev/vitest#11593</a>
<a href="https://github.com/vitest-dev/vitest/commit/ea611e44c"><!-- raw
HTML omitted -->(ea611)<!-- raw HTML omitted --></a></li>
<li>Drop late connections of closed sessions  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11600">vitest-dev/vitest#11600</a>
<a href="https://github.com/vitest-dev/vitest/commit/f161e6df2"><!-- raw
HTML omitted -->(f161e)<!-- raw HTML omitted --></a></li>
<li>Wait 30s for the browser to close  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11601">vitest-dev/vitest#11601</a>
<a href="https://github.com/vitest-dev/vitest/commit/6498b666a"><!-- raw
HTML omitted -->(6498b)<!-- raw HTML omitted --></a></li>
<li>Run global setup once with instances  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11596">vitest-dev/vitest#11596</a>
<a href="https://github.com/vitest-dev/vitest/commit/8dd67c262"><!-- raw
HTML omitted -->(8dd67)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>reporter</strong>:
<ul>
<li>End reason
<code>&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);failed&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);</code>
on worker crash  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11568">vitest-dev/vitest#11568</a>
<a href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff"><!-- raw
HTML omitted -->(6ae8e)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.4...v5.0.5">View
changes on GitHub</a></h5>
<h2>v5.0.4</h2>
<h3>   🚀 Features</h3>
<ul>
<li><strong>experimental</strong>:
<ul>
<li>Tag cache directories with CACHEDIR.TAG  -  by <a
href="https://github.com/lifeiscontent"><code>@​lifeiscontent</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11461">vitest-dev/vitest#11461</a>
<a href="https://github.com/vitest-dev/vitest/commit/a8ea3c8fd"><!-- raw
HTML omitted -->(a8ea3)<!-- raw HTML omitted --></a></li>
<li>Support <code>test.ui.theme</code> option  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11499">vitest-dev/vitest#11499</a>
<a href="https://github.com/vitest-dev/vitest/commit/1da66405d"><!-- raw
HTML omitted -->(1da66)<!-- raw HTML omitted --></a></li>
<li>Highlight selector multiple matches in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11489">vitest-dev/vitest#11489</a>
<a href="https://github.com/vitest-dev/vitest/commit/5abba1e1b"><!-- raw
HTML omitted -->(5abba)<!-- raw HTML omitted --></a></li>
<li>Print how many tests were affected and a total when running
<code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11424">vitest-dev/vitest#11424</a>
<a href="https://github.com/vitest-dev/vitest/commit/a23368585"><!-- raw
HTML omitted -->(a2336)<!-- raw HTML omitted --></a></li>
<li>Add an option to cache dependencies instead of statically parsing
them  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11515">vitest-dev/vitest#11515</a>
<a href="https://github.com/vitest-dev/vitest/commit/c06012ac8"><!-- raw
HTML omitted -->(c0601)<!-- raw HTML omitted --></a></li>
<li>Add fit and zoom controls to trace viewer  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11490">vitest-dev/vitest#11490</a>
<a href="https://github.com/vitest-dev/vitest/commit/f5dd99ed0"><!-- raw
HTML omitted -->(f5dd9)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Fail the run on git and location filter errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11430">vitest-dev/vitest#11430</a>
<a href="https://github.com/vitest-dev/vitest/commit/30d0304d2"><!-- raw
HTML omitted -->(30d03)<!-- raw HTML omitted --></a></li>
<li>Enable fsModuleCache by default  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11435">vitest-dev/vitest#11435</a>
<a href="https://github.com/vitest-dev/vitest/commit/ad208cc29"><!-- raw
HTML omitted -->(ad208)<!-- raw HTML omitted --></a></li>
<li>Track project files and mocks with --changed  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11432">vitest-dev/vitest#11432</a>
<a href="https://github.com/vitest-dev/vitest/commit/b0f2b3bb9"><!-- raw
HTML omitted -->(b0f2b)<!-- raw HTML omitted --></a></li>
<li>Refactor caching, fix <code>:</code> in project and change the shape
of <code>results</code> cache  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11453">vitest-dev/vitest#11453</a>
<a href="https://github.com/vitest-dev/vitest/commit/9673c49a4"><!-- raw
HTML omitted -->(9673c)<!-- raw HTML omitted --></a></li>
<li>Keep full <code>$</code> string values when
<code>taskTitleValueFormatTruncate</code> is 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11485">vitest-dev/vitest#11485</a>
<a href="https://github.com/vitest-dev/vitest/commit/4f7e1799b"><!-- raw
HTML omitted -->(4f7e1)<!-- raw HTML omitted --></a></li>
<li>Resolve node builtins in client environments  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11417">vitest-dev/vitest#11417</a>
<a href="https://github.com/vitest-dev/vitest/commit/56b319ac6"><!-- raw
HTML omitted -->(56b31)<!-- raw HTML omitted --></a></li>
<li>Fix module graph builtin externals after <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11421">#11421</a>
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11491">vitest-dev/vitest#11491</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11421">vitest-dev/vitest#11421</a>
<a href="https://github.com/vitest-dev/vitest/commit/008e184cb"><!-- raw
HTML omitted -->(008e1)<!-- raw HTML omitted --></a></li>
<li>Wrap module mocks during in-source testing  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11505">vitest-dev/vitest#11505</a>
<a href="https://github.com/vitest-dev/vitest/commit/36d19cb00"><!-- raw
HTML omitted -->(36d19)<!-- raw HTML omitted --></a></li>
<li>Handle line endings in snapshot  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11522">vitest-dev/vitest#11522</a>
<a href="https://github.com/vitest-dev/vitest/commit/4c468aa40"><!-- raw
HTML omitted -->(4c468)<!-- raw HTML omitted --></a></li>
<li>Respect root in projects  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11521">vitest-dev/vitest#11521</a>
<a href="https://github.com/vitest-dev/vitest/commit/26642f793"><!-- raw
HTML omitted -->(26642)<!-- raw HTML omitted --></a></li>
<li>Resolve mocks in directories with spaces  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11539">vitest-dev/vitest#11539</a>
<a href="https://github.com/vitest-dev/vitest/commit/caaef9416"><!-- raw
HTML omitted -->(caaef)<!-- raw HTML omitted --></a></li>
<li><strong>api</strong>:
<ul>
<li>Publish the api token atomically  -  by <a
href="https://github.com/umairnawaz333"><code>@​umairnawaz333</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11323">vitest-dev/vitest#11323</a>
<a href="https://github.com/vitest-dev/vitest/commit/6f990fef1"><!-- raw
HTML omitted -->(6f990)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>browser</strong>:</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a825db43e2beca0b219d2eadaec334cb81af0c7"><code>7a825db</code></a>
chore: release v5.0.5 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11609">#11609</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6621a72d6ed371e43f80ff327f5063693bd6b1ad"><code>6621a72</code></a>
fix: abort all running tests on cancel (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11606">#11606</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0c8d6867de06a3df43ea28a05eeec444"><code>e9c3d72</code></a>
fix: release mocks of finished test files (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11607">#11607</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/8dd67c2625943d824e257b87ae57a14094e90eed"><code>8dd67c2</code></a>
fix(browser): run global setup once with instances (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11596">#11596</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6c5a447203a29a0708fbc5de4fb91ea501bdc395"><code>6c5a447</code></a>
fix: run hook cleanups when a later hook fails (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11605">#11605</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9697b3894f456b85db91f3824ebe833449305c04"><code>9697b38</code></a>
fix: keep the import frame in native loader errors (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11599">#11599</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6498b666a3ae8961f6f2a8abdc89015b6fd0b3aa"><code>6498b66</code></a>
fix(browser): wait 30s for the browser to close (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11601">#11601</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f161e6df2b3c0bc84982d374094379139e380791"><code>f161e6d</code></a>
fix(browser): drop late connections of closed sessions (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11600">#11600</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fe86a64c6c6aa75481bffe5880b5c4e35ea67927"><code>fe86a64</code></a>
fix: skip builtin loading in async leak detector (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11598">#11598</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff0734cf476e30186a83aebe6771aa330"><code>6ae8e89</code></a>
fix(reporter): end reason <code>'failed'</code> on worker crash (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11568">#11568</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.5/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.3 to 5.0.5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.5</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Keep vite default <code>fs.deny</code> with api token file  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11578">vitest-dev/vitest#11578</a>
<a href="https://github.com/vitest-dev/vitest/commit/28dc1edfb"><!-- raw
HTML omitted -->(28dc1)<!-- raw HTML omitted --></a></li>
<li>Handle quoted file names in <code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11583">vitest-dev/vitest#11583</a>
<a href="https://github.com/vitest-dev/vitest/commit/14921e962"><!-- raw
HTML omitted -->(14921)<!-- raw HTML omitted --></a></li>
<li>Add <code>data</code> to the <code>import.meta.hot</code> stub  - 
by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11590">vitest-dev/vitest#11590</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a8289ac3"><!-- raw
HTML omitted -->(3a828)<!-- raw HTML omitted --></a></li>
<li>Set <code>skip</code> in <code>skipIf</code>, ignore
<code>undefined</code> options  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11591">vitest-dev/vitest#11591</a>
<a href="https://github.com/vitest-dev/vitest/commit/d523a15f2"><!-- raw
HTML omitted -->(d523a)<!-- raw HTML omitted --></a></li>
<li>Skip builtin loading in async leak detector  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11598">vitest-dev/vitest#11598</a>
<a href="https://github.com/vitest-dev/vitest/commit/fe86a64c6"><!-- raw
HTML omitted -->(fe86a)<!-- raw HTML omitted --></a></li>
<li>Keep the import frame in native loader errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11599">vitest-dev/vitest#11599</a>
<a href="https://github.com/vitest-dev/vitest/commit/9697b3894"><!-- raw
HTML omitted -->(9697b)<!-- raw HTML omitted --></a></li>
<li>Run hook cleanups when a later hook fails  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11605">vitest-dev/vitest#11605</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c5a44720"><!-- raw
HTML omitted -->(6c5a4)<!-- raw HTML omitted --></a></li>
<li>Release mocks of finished test files  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11607">vitest-dev/vitest#11607</a>
<a href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0"><!-- raw
HTML omitted -->(e9c3d)<!-- raw HTML omitted --></a></li>
<li>Abort all running tests on cancel  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11606">vitest-dev/vitest#11606</a>
<a href="https://github.com/vitest-dev/vitest/commit/6621a72d6"><!-- raw
HTML omitted -->(6621a)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Ignore synthetic pagehide events  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11582">vitest-dev/vitest#11582</a>
<a href="https://github.com/vitest-dev/vitest/commit/ca0813584"><!-- raw
HTML omitted -->(ca081)<!-- raw HTML omitted --></a></li>
<li>Run plugin buildStart on server creation  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11593">vitest-dev/vitest#11593</a>
<a href="https://github.com/vitest-dev/vitest/commit/ea611e44c"><!-- raw
HTML omitted -->(ea611)<!-- raw HTML omitted --></a></li>
<li>Drop late connections of closed sessions  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11600">vitest-dev/vitest#11600</a>
<a href="https://github.com/vitest-dev/vitest/commit/f161e6df2"><!-- raw
HTML omitted -->(f161e)<!-- raw HTML omitted --></a></li>
<li>Wait 30s for the browser to close  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11601">vitest-dev/vitest#11601</a>
<a href="https://github.com/vitest-dev/vitest/commit/6498b666a"><!-- raw
HTML omitted -->(6498b)<!-- raw HTML omitted --></a></li>
<li>Run global setup once with instances  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11596">vitest-dev/vitest#11596</a>
<a href="https://github.com/vitest-dev/vitest/commit/8dd67c262"><!-- raw
HTML omitted -->(8dd67)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>reporter</strong>:
<ul>
<li>End reason
<code>&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);failed&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);</code>
on worker crash  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11568">vitest-dev/vitest#11568</a>
<a href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff"><!-- raw
HTML omitted -->(6ae8e)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.4...v5.0.5">View
changes on GitHub</a></h5>
<h2>v5.0.4</h2>
<h3>   🚀 Features</h3>
<ul>
<li><strong>experimental</strong>:
<ul>
<li>Tag cache directories with CACHEDIR.TAG  -  by <a
href="https://github.com/lifeiscontent"><code>@​lifeiscontent</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11461">vitest-dev/vitest#11461</a>
<a href="https://github.com/vitest-dev/vitest/commit/a8ea3c8fd"><!-- raw
HTML omitted -->(a8ea3)<!-- raw HTML omitted --></a></li>
<li>Support <code>test.ui.theme</code> option  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11499">vitest-dev/vitest#11499</a>
<a href="https://github.com/vitest-dev/vitest/commit/1da66405d"><!-- raw
HTML omitted -->(1da66)<!-- raw HTML omitted --></a></li>
<li>Highlight selector multiple matches in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11489">vitest-dev/vitest#11489</a>
<a href="https://github.com/vitest-dev/vitest/commit/5abba1e1b"><!-- raw
HTML omitted -->(5abba)<!-- raw HTML omitted --></a></li>
<li>Print how many tests were affected and a total when running
<code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11424">vitest-dev/vitest#11424</a>
<a href="https://github.com/vitest-dev/vitest/commit/a23368585"><!-- raw
HTML omitted -->(a2336)<!-- raw HTML omitted --></a></li>
<li>Add an option to cache dependencies instead of statically parsing
them  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11515">vitest-dev/vitest#11515</a>
<a href="https://github.com/vitest-dev/vitest/commit/c06012ac8"><!-- raw
HTML omitted -->(c0601)<!-- raw HTML omitted --></a></li>
<li>Add fit and zoom controls to trace viewer  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11490">vitest-dev/vitest#11490</a>
<a href="https://github.com/vitest-dev/vitest/commit/f5dd99ed0"><!-- raw
HTML omitted -->(f5dd9)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Fail the run on git and location filter errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11430">vitest-dev/vitest#11430</a>
<a href="https://github.com/vitest-dev/vitest/commit/30d0304d2"><!-- raw
HTML omitted -->(30d03)<!-- raw HTML omitted --></a></li>
<li>Enable fsModuleCache by default  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11435">vitest-dev/vitest#11435</a>
<a href="https://github.com/vitest-dev/vitest/commit/ad208cc29"><!-- raw
HTML omitted -->(ad208)<!-- raw HTML omitted --></a></li>
<li>Track project files and mocks with --changed  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11432">vitest-dev/vitest#11432</a>
<a href="https://github.com/vitest-dev/vitest/commit/b0f2b3bb9"><!-- raw
HTML omitted -->(b0f2b)<!-- raw HTML omitted --></a></li>
<li>Refactor caching, fix <code>:</code> in project and change the shape
of <code>results</code> cache  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11453">vitest-dev/vitest#11453</a>
<a href="https://github.com/vitest-dev/vitest/commit/9673c49a4"><!-- raw
HTML omitted -->(9673c)<!-- raw HTML omitted --></a></li>
<li>Keep full <code>$</code> string values when
<code>taskTitleValueFormatTruncate</code> is 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11485">vitest-dev/vitest#11485</a>
<a href="https://github.com/vitest-dev/vitest/commit/4f7e1799b"><!-- raw
HTML omitted -->(4f7e1)<!-- raw HTML omitted --></a></li>
<li>Resolve node builtins in client environments  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11417">vitest-dev/vitest#11417</a>
<a href="https://github.com/vitest-dev/vitest/commit/56b319ac6"><!-- raw
HTML omitted -->(56b31)<!-- raw HTML omitted --></a></li>
<li>Fix module graph builtin externals after <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11421">#11421</a>
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11491">vitest-dev/vitest#11491</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11421">vitest-dev/vitest#11421</a>
<a href="https://github.com/vitest-dev/vitest/commit/008e184cb"><!-- raw
HTML omitted -->(008e1)<!-- raw HTML omitted --></a></li>
<li>Wrap module mocks during in-source testing  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11505">vitest-dev/vitest#11505</a>
<a href="https://github.com/vitest-dev/vitest/commit/36d19cb00"><!-- raw
HTML omitted -->(36d19)<!-- raw HTML omitted --></a></li>
<li>Handle line endings in snapshot  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11522">vitest-dev/vitest#11522</a>
<a href="https://github.com/vitest-dev/vitest/commit/4c468aa40"><!-- raw
HTML omitted -->(4c468)<!-- raw HTML omitted --></a></li>
<li>Respect root in projects  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11521">vitest-dev/vitest#11521</a>
<a href="https://github.com/vitest-dev/vitest/commit/26642f793"><!-- raw
HTML omitted -->(26642)<!-- raw HTML omitted --></a></li>
<li>Resolve mocks in directories with spaces  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11539">vitest-dev/vitest#11539</a>
<a href="https://github.com/vitest-dev/vitest/commit/caaef9416"><!-- raw
HTML omitted -->(caaef)<!-- raw HTML omitted --></a></li>
<li><strong>api</strong>:
<ul>
<li>Publish the api token atomically  -  by <a
href="https://github.com/umairnawaz333"><code>@​umairnawaz333</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11323">vitest-dev/vitest#11323</a>
<a href="https://github.com/vitest-dev/vitest/commit/6f990fef1"><!-- raw
HTML omitted -->(6f990)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>browser</strong>:</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a825db43e2beca0b219d2eadaec334cb81af0c7"><code>7a825db</code></a>
chore: release v5.0.5 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11609">#11609</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6621a72d6ed371e43f80ff327f5063693bd6b1ad"><code>6621a72</code></a>
fix: abort all running tests on cancel (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11606">#11606</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0c8d6867de06a3df43ea28a05eeec444"><code>e9c3d72</code></a>
fix: release mocks of finished test files (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11607">#11607</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/8dd67c2625943d824e257b87ae57a14094e90eed"><code>8dd67c2</code></a>
fix(browser): run global setup once with instances (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11596">#11596</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6c5a447203a29a0708fbc5de4fb91ea501bdc395"><code>6c5a447</code></a>
fix: run hook cleanups when a later hook fails (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11605">#11605</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9697b3894f456b85db91f3824ebe833449305c04"><code>9697b38</code></a>
fix: keep the import frame in native loader errors (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11599">#11599</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6498b666a3ae8961f6f2a8abdc89015b6fd0b3aa"><code>6498b66</code></a>
fix(browser): wait 30s for the browser to close (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11601">#11601</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f161e6df2b3c0bc84982d374094379139e380791"><code>f161e6d</code></a>
fix(browser): drop late connections of closed sessions (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11600">#11600</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/fe86a64c6c6aa75481bffe5880b5c4e35ea67927"><code>fe86a64</code></a>
fix: skip builtin loading in async leak detector (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11598">#11598</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff0734cf476e30186a83aebe6771aa330"><code>6ae8e89</code></a>
fix(reporter): end reason <code>'failed'</code> on worker crash (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11568">#11568</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.5/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.40.0 to 0.41.0

Updates `vitest` from 5.0.3 to 5.0.5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.5</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Keep vite default <code>fs.deny</code> with api token file  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11578">vitest-dev/vitest#11578</a>
<a href="https://github.com/vitest-dev/vitest/commit/28dc1edfb"><!-- raw
HTML omitted -->(28dc1)<!-- raw HTML omitted --></a></li>
<li>Handle quoted file names in <code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11583">vitest-dev/vitest#11583</a>
<a href="https://github.com/vitest-dev/vitest/commit/14921e962"><!-- raw
HTML omitted -->(14921)<!-- raw HTML omitted --></a></li>
<li>Add <code>data</code> to the <code>import.meta.hot</code> stub  - 
by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11590">vitest-dev/vitest#11590</a>
<a href="https://github.com/vitest-dev/vitest/commit/3a8289ac3"><!-- raw
HTML omitted -->(3a828)<!-- raw HTML omitted --></a></li>
<li>Set <code>skip</code> in <code>skipIf</code>, ignore
<code>undefined</code> options  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11591">vitest-dev/vitest#11591</a>
<a href="https://github.com/vitest-dev/vitest/commit/d523a15f2"><!-- raw
HTML omitted -->(d523a)<!-- raw HTML omitted --></a></li>
<li>Skip builtin loading in async leak detector  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11598">vitest-dev/vitest#11598</a>
<a href="https://github.com/vitest-dev/vitest/commit/fe86a64c6"><!-- raw
HTML omitted -->(fe86a)<!-- raw HTML omitted --></a></li>
<li>Keep the import frame in native loader errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11599">vitest-dev/vitest#11599</a>
<a href="https://github.com/vitest-dev/vitest/commit/9697b3894"><!-- raw
HTML omitted -->(9697b)<!-- raw HTML omitted --></a></li>
<li>Run hook cleanups when a later hook fails  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11605">vitest-dev/vitest#11605</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c5a44720"><!-- raw
HTML omitted -->(6c5a4)<!-- raw HTML omitted --></a></li>
<li>Release mocks of finished test files  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11607">vitest-dev/vitest#11607</a>
<a href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0"><!-- raw
HTML omitted -->(e9c3d)<!-- raw HTML omitted --></a></li>
<li>Abort all running tests on cancel  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11606">vitest-dev/vitest#11606</a>
<a href="https://github.com/vitest-dev/vitest/commit/6621a72d6"><!-- raw
HTML omitted -->(6621a)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Ignore synthetic pagehide events  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11582">vitest-dev/vitest#11582</a>
<a href="https://github.com/vitest-dev/vitest/commit/ca0813584"><!-- raw
HTML omitted -->(ca081)<!-- raw HTML omitted --></a></li>
<li>Run plugin buildStart on server creation  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11593">vitest-dev/vitest#11593</a>
<a href="https://github.com/vitest-dev/vitest/commit/ea611e44c"><!-- raw
HTML omitted -->(ea611)<!-- raw HTML omitted --></a></li>
<li>Drop late connections of closed sessions  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11600">vitest-dev/vitest#11600</a>
<a href="https://github.com/vitest-dev/vitest/commit/f161e6df2"><!-- raw
HTML omitted -->(f161e)<!-- raw HTML omitted --></a></li>
<li>Wait 30s for the browser to close  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11601">vitest-dev/vitest#11601</a>
<a href="https://github.com/vitest-dev/vitest/commit/6498b666a"><!-- raw
HTML omitted -->(6498b)<!-- raw HTML omitted --></a></li>
<li>Run global setup once with instances  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11596">vitest-dev/vitest#11596</a>
<a href="https://github.com/vitest-dev/vitest/commit/8dd67c262"><!-- raw
HTML omitted -->(8dd67)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>reporter</strong>:
<ul>
<li>End reason
<code>&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);failed&amp;[#39](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/39);</code>
on worker crash  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11568">vitest-dev/vitest#11568</a>
<a href="https://github.com/vitest-dev/vitest/commit/6ae8e89ff"><!-- raw
HTML omitted -->(6ae8e)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.4...v5.0.5">View
changes on GitHub</a></h5>
<h2>v5.0.4</h2>
<h3>   🚀 Features</h3>
<ul>
<li><strong>experimental</strong>:
<ul>
<li>Tag cache directories with CACHEDIR.TAG  -  by <a
href="https://github.com/lifeiscontent"><code>@​lifeiscontent</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11461">vitest-dev/vitest#11461</a>
<a href="https://github.com/vitest-dev/vitest/commit/a8ea3c8fd"><!-- raw
HTML omitted -->(a8ea3)<!-- raw HTML omitted --></a></li>
<li>Support <code>test.ui.theme</code> option  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11499">vitest-dev/vitest#11499</a>
<a href="https://github.com/vitest-dev/vitest/commit/1da66405d"><!-- raw
HTML omitted -->(1da66)<!-- raw HTML omitted --></a></li>
<li>Highlight selector multiple matches in trace view  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11489">vitest-dev/vitest#11489</a>
<a href="https://github.com/vitest-dev/vitest/commit/5abba1e1b"><!-- raw
HTML omitted -->(5abba)<!-- raw HTML omitted --></a></li>
<li>Print how many tests were affected and a total when running
<code>--changed</code>  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11424">vitest-dev/vitest#11424</a>
<a href="https://github.com/vitest-dev/vitest/commit/a23368585"><!-- raw
HTML omitted -->(a2336)<!-- raw HTML omitted --></a></li>
<li>Add an option to cache dependencies instead of statically parsing
them  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11515">vitest-dev/vitest#11515</a>
<a href="https://github.com/vitest-dev/vitest/commit/c06012ac8"><!-- raw
HTML omitted -->(c0601)<!-- raw HTML omitted --></a></li>
<li>Add fit and zoom controls to trace viewer  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11490">vitest-dev/vitest#11490</a>
<a href="https://github.com/vitest-dev/vitest/commit/f5dd99ed0"><!-- raw
HTML omitted -->(f5dd9)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Fail the run on git and location filter errors  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11430">vitest-dev/vitest#11430</a>
<a href="https://github.com/vitest-dev/vitest/commit/30d0304d2"><!-- raw
HTML omitted -->(30d03)<!-- raw HTML omitted --></a></li>
<li>Enable fsModuleCache by default  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11435">vitest-dev/vitest#11435</a>
<a href="https://github.com/vitest-dev/vitest/commit/ad208cc29"><!-- raw
HTML omitted -->(ad208)<!-- raw HTML omitted --></a></li>
<li>Track project files and mocks with --changed  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11432">vitest-dev/vitest#11432</a>
<a href="https://github.com/vitest-dev/vitest/commit/b0f2b3bb9"><!-- raw
HTML omitted -->(b0f2b)<!-- raw HTML omitted --></a></li>
<li>Refactor caching, fix <code>:</code> in project and change the shape
of <code>results</code> cache  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11453">vitest-dev/vitest#11453</a>
<a href="https://github.com/vitest-dev/vitest/commit/9673c49a4"><!-- raw
HTML omitted -->(9673c)<!-- raw HTML omitted --></a></li>
<li>Keep full <code>$</code> string values when
<code>taskTitleValueFormatTruncate</code> is 0  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11485">vitest-dev/vitest#11485</a>
<a href="https://github.com/vitest-dev/vitest/commit/4f7e1799b"><!-- raw
HTML omitted -->(4f7e1)<!-- raw HTML omitted --></a></li>
<li>Resolve node builtins in client environments  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11417">vitest-dev/vitest#11417</a>
<a href="https://github.com/vitest-dev/vitest/commit/56b319ac6"><!-- raw
HTML omitted -->(56b31)<!-- raw HTML omitted --></a></li>
<li>Fix module graph builtin externals after <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11421">#11421</a>
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude Opus 5.5</strong> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11491">vitest-dev/vitest#11491</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11421">vitest-dev/vitest#11421</a>
<a href="https://github.com/vitest-dev/vitest/commit/008e184cb"><!-- raw
HTML omitted -->(008e1)<!-- raw HTML omitted --></a></li>
<li>Wrap module mocks during in-source testing  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11505">vitest-dev/vitest#11505</a>
<a href="https://github.com/vitest-dev/vitest/commit/36d19cb00"><!-- raw
HTML omitted -->(36d19)<!-- raw HTML omitted --></a></li>
<li>Handle line endings in snapshot  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11522">vitest-dev/vitest#11522</a>
<a href="https://github.com/vitest-dev/vitest/commit/4c468aa40"><!-- raw
HTML omitted -->(4c468)<!-- raw HTML omitted --></a></li>
<li>Respect root in projects  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11521">vitest-dev/vitest#11521</a>
<a href="https://github.com/vitest-dev/vitest/commit/26642f793"><!-- raw
HTML omitted -->(26642)<!-- raw HTML omitted --></a></li>
<li>Resolve mocks in directories with spaces  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11539">vitest-dev/vitest#11539</a>
<a href="https://github.com/vitest-dev/vitest/commit/caaef9416"><!-- raw
HTML omitted -->(caaef)<!-- raw HTML omitted --></a></li>
<li><strong>api</strong>:
<ul>
<li>Publish the api token atomically  -  by <a
href="https://github.com/umairnawaz333"><code>@​umairnawaz333</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11323">vitest-dev/vitest#11323</a>
<a href="https://github.com/vitest-dev/vitest/commit/6f990fef1"><!-- raw
HTML omitted -->(6f990)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>browser</strong>:</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7a825db43e2beca0b219d2eadaec334cb81af0c7"><code>7a825db</code></a>
chore: release v5.0.5 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11609">#11609</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6621a72d6ed371e43f80ff327f5063693bd6b1ad"><code>6621a72</code></a>
fix: abort all running tests on cancel (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11606">#11606</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/e9c3d72f0c8d6867de06a3df43ea28a05eeec444"><code>e9c3d72</code></a>
fix: release mocks of finished test files (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11607">#11607</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/8dd67c2625943d824e257b87ae57a14094e90eed"><code>8dd67c2</code></a>
fix(browser): run global setup once with instances (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11596">#11596</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/6c5a447203a29a0708fbc5de4fb91ea501bdc395"><code>6c5a447</code></a>
fix: run hook cleanups when a later hook fails (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11605">#11605</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/9697b3894f456b85db91f3824ebe833449305c04"><code>9697b38</code></a>
fix: keep the import frame in native loader errors (<a
href="https://git...

_Description has been truncated_

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-27 17:28:32 -07:00
JD Davisandgithub-actions[bot] 17d38e5699 chore: release 0.42.0 (#4228)
🤖 I have created a release *beep* *boop*
---


##
[0.42.0](https://github.com/headroomlabs-ai/headroom/compare/v0.41.0...v0.42.0)
(2026-10-26)


### Features

* **pipeline:** put per-request saved tokens on OutcomeSnapshot
([#4231](https://github.com/headroomlabs-ai/headroom/issues/4231))
([8cedf7b](https://github.com/headroomlabs-ai/headroom/commit/8cedf7be4decfb3a0da42e4e955b6a3301a66dc9))
* **proxy:** let turn hooks rewrite OpenAI Responses requests on HTTP
and WebSocket
([#4232](https://github.com/headroomlabs-ai/headroom/issues/4232))
([fbf7bc3](https://github.com/headroomlabs-ai/headroom/commit/fbf7bc3278c11975299b9bd0a2ecf200dfd25a05))
* **proxy:** report the same tool savings on gateway /v1/compress as the
proxy path
([#4467](https://github.com/headroomlabs-ai/headroom/issues/4467))
([a904210](https://github.com/headroomlabs-ai/headroom/commit/a90421083a781990b877d34fdaba0bc1b6cf6c4d))
* **savings:** add the per-request counterfactual savings record
([#4236](https://github.com/headroomlabs-ai/headroom/issues/4236))
([2912b7b](https://github.com/headroomlabs-ai/headroom/commit/2912b7b620d7abd39828db73e4f326b9a041d309))


### Bug Fixes

* **batch:** preserve live contexts during capacity cleanup
([#4210](https://github.com/headroomlabs-ai/headroom/issues/4210))
([2cbdd22](https://github.com/headroomlabs-ai/headroom/commit/2cbdd22a65789676d9ebbd9e2b6a908e7f8fad95))
* **batch:** preserve native Gemini continuation tools
([#4211](https://github.com/headroomlabs-ai/headroom/issues/4211))
([8757458](https://github.com/headroomlabs-ai/headroom/commit/875745889ff065208d3a32aa583881468ae7c41d))
* **cache:** bound the router's compression cache, keep the rest in
SQLite
([#4357](https://github.com/headroomlabs-ai/headroom/issues/4357))
([b196424](https://github.com/headroomlabs-ai/headroom/commit/b196424e35df0afc0c8576aea1950ed16b00e027))
* **cache:** keep indented lines intact in OpenAI whitespace
normalization
([#4343](https://github.com/headroomlabs-ai/headroom/issues/4343))
([2480100](https://github.com/headroomlabs-ai/headroom/commit/248010091578e1f05ebcf65c8146bb57f9fb4e00))
* **cache:** keep prefix-tracker state across a graceful proxy restart
([#4299](https://github.com/headroomlabs-ai/headroom/issues/4299))
([62b3bed](https://github.com/headroomlabs-ai/headroom/commit/62b3bedaba988de87e38b1a58c11d28baaba7dbf))
* **ccr:** recognize client-owned MCP retrieval aliases
([#4165](https://github.com/headroomlabs-ai/headroom/issues/4165))
([89545fb](https://github.com/headroomlabs-ai/headroom/commit/89545fbdf3873f75461f71a03c89b1f9c64d650d))
* **ccr:** stream the buffered CCR upstream request so idle-killing
networks cannot cut it
([#4206](https://github.com/headroomlabs-ai/headroom/issues/4206))
([ca6ba34](https://github.com/headroomlabs-ai/headroom/commit/ca6ba3486c09badecb1bfe99ddabf562c9f01c77))
* **ci:** pin checkout in release notification smoke workflow
([#4399](https://github.com/headroomlabs-ai/headroom/issues/4399))
([70273db](https://github.com/headroomlabs-ai/headroom/commit/70273db0af392e8f971d42e21484656676255d0b))
* **copilot:** detect COPILOT_API_URL in cli-main.js for Copilot CLI
&gt;= 1.0.93
([#4450](https://github.com/headroomlabs-ai/headroom/issues/4450))
([043fe09](https://github.com/headroomlabs-ai/headroom/commit/043fe09d8c620201045619bcbcd88e26e2c6e71f))
* **copilot:** preserve native inline OAuth identity
([#4144](https://github.com/headroomlabs-ai/headroom/issues/4144))
([ad62166](https://github.com/headroomlabs-ai/headroom/commit/ad62166ba3056e5b98fc5bfee19f0c9b6c316e8d))
* **deps:** bump rustls to 0.23.46 for RUSTSEC-2026-0346..0349
([#4222](https://github.com/headroomlabs-ai/headroom/issues/4222))
([132dbc7](https://github.com/headroomlabs-ai/headroom/commit/132dbc76995cdbecc25b4f647dbf919351cd5f7f))
* **deps:** patch OpenClaw Undici and narrow E2E audit exceptions
([#4453](https://github.com/headroomlabs-ai/headroom/issues/4453))
([1be699f](https://github.com/headroomlabs-ai/headroom/commit/1be699f68ee884c5c319cee9841ca304e448873c))
* **deps:** require hf-xet&gt;=1.6.0 so a Hub download can't crash
Python at exit
([#4192](https://github.com/headroomlabs-ai/headroom/issues/4192))
([9e5dac7](https://github.com/headroomlabs-ai/headroom/commit/9e5dac7c74979abd8d1b9ad9615443b76e42b530))
* **deps:** require mcp&gt;=1.30.0 for CVE-2026-59951
([#4239](https://github.com/headroomlabs-ai/headroom/issues/4239))
([2f7a83a](https://github.com/headroomlabs-ai/headroom/commit/2f7a83a91d3ca33a79b5c41b8095f6454b5bfb43))
* **gateway:** keep input_includes_cache when re-drive usage is merged
([#4423](https://github.com/headroomlabs-ai/headroom/issues/4423))
([3f94144](https://github.com/headroomlabs-ai/headroom/commit/3f941446bfbeb0b66cf6eb4a1ddf254e17d0c2a4))
* **gemini:** keep snake_case inline_data and function parts when
compressing
([#4290](https://github.com/headroomlabs-ai/headroom/issues/4290))
([4bf1bf5](https://github.com/headroomlabs-ai/headroom/commit/4bf1bf55d175ad047c32cc3049aeff51126424c8))
* **image:** clear last_result before each compress() call
([#4341](https://github.com/headroomlabs-ai/headroom/issues/4341))
([19c91a8](https://github.com/headroomlabs-ai/headroom/commit/19c91a870fac09f824001197e72c8929698ea0b8))
* **image:** flatten transparent images onto white before re-encoding as
JPEG ([#4296](https://github.com/headroomlabs-ai/headroom/issues/4296))
([9f5cfcf](https://github.com/headroomlabs-ai/headroom/commit/9f5cfcfd2bb90097f79144ff3821fc7db9fe36d5))
* **install:** keep the HuggingFace cache on a writable mount in Docker
presets
([#4207](https://github.com/headroomlabs-ai/headroom/issues/4207))
([#4209](https://github.com/headroomlabs-ai/headroom/issues/4209))
([7b6cb77](https://github.com/headroomlabs-ai/headroom/commit/7b6cb7790552ac10f0135013337ea4a09a9e951e))
* **kompress:** skip the local model download when a remote endpoint is
set ([#4234](https://github.com/headroomlabs-ai/headroom/issues/4234))
([ff36931](https://github.com/headroomlabs-ai/headroom/commit/ff3693165344410eaf2882209648e504f9d3eaf0))
* **kompress:** time each model-load stage and stop false not-ready
warnings during warm-up
([#4195](https://github.com/headroomlabs-ai/headroom/issues/4195))
([89b229c](https://github.com/headroomlabs-ai/headroom/commit/89b229ce5feaeb8710f4e226a47697426231ca55))
* **learn:** anchor the managed block on its last start marker, append
when no end marker
([#4342](https://github.com/headroomlabs-ai/headroom/issues/4342))
([45dacc1](https://github.com/headroomlabs-ai/headroom/commit/45dacc1f94a4343c76a6e257143d22d67dc713f0))
* **learn:** keep the digest's loop section inside its budget
([#4269](https://github.com/headroomlabs-ai/headroom/issues/4269))
([506ba16](https://github.com/headroomlabs-ai/headroom/commit/506ba16c4a7f231b177d28066bcda389133a5e91))
* **logs:** count omitted levels from dropped lines
([#4141](https://github.com/headroomlabs-ai/headroom/issues/4141))
([023dd1b](https://github.com/headroomlabs-ai/headroom/commit/023dd1bc5402dcebf52a5ed3cf6a2a2878a524d9))
* **mcp:** accept the JSONC opencode config that wrap and install
already accept
([#4297](https://github.com/headroomlabs-ai/headroom/issues/4297))
([9202948](https://github.com/headroomlabs-ai/headroom/commit/9202948c1e57a4ab8daa7c00c400605844c19f4f))
* **memory:** bound retrieval queries before embedding
([#4244](https://github.com/headroomlabs-ai/headroom/issues/4244))
([8c07cf4](https://github.com/headroomlabs-ai/headroom/commit/8c07cf4a0fff1b67da1b542dc746b0b4a0e952e6))
* **memory:** ignore incidental cwd prose
([#4166](https://github.com/headroomlabs-ai/headroom/issues/4166))
([3765439](https://github.com/headroomlabs-ai/headroom/commit/37654390b60ccb7658bb96a2f177b8666c7b7273))
* **memory:** log storage and SQLite failures that currently make
retrieval miss silently
([#4111](https://github.com/headroomlabs-ai/headroom/issues/4111))
([4e6e955](https://github.com/headroomlabs-ai/headroom/commit/4e6e955cad0bff318e30bd4f24e934a23f57e9c6))
* **memory:** resolve partial IDs beyond the first 1000 records
([#4389](https://github.com/headroomlabs-ai/headroom/issues/4389))
([c4ea31b](https://github.com/headroomlabs-ai/headroom/commit/c4ea31b156478adde015833074ad7278230b4512))
* **memory:** treat a cwd with no UTF-8 form as unresolved instead of
raising
([#4167](https://github.com/headroomlabs-ai/headroom/issues/4167))
([760c05e](https://github.com/headroomlabs-ai/headroom/commit/760c05e1b0ff8c34443f5d6eba0c4ff36f171eb2))
* **openai:** read Responses cache_write_tokens instead of inferring
writes
([#4237](https://github.com/headroomlabs-ai/headroom/issues/4237))
([4630602](https://github.com/headroomlabs-ai/headroom/commit/46306024e74b3a44aca17fb70c1416f96b2a0b53))
* **openai:** recompress cached Responses units whose CCR entries
expired
([#4146](https://github.com/headroomlabs-ai/headroom/issues/4146))
([8f7b419](https://github.com/headroomlabs-ai/headroom/commit/8f7b41998076727d08e5db4ee57c8bd579988c30))
* **opencode:** do not rewrite an OpenCode config that fails to parse
([#4424](https://github.com/headroomlabs-ai/headroom/issues/4424))
([0fe0a59](https://github.com/headroomlabs-ai/headroom/commit/0fe0a597c1929bcb4a7372e6689fd62410bad9d2))
* **opencode:** restore process env keys on transport dispose
([#4430](https://github.com/headroomlabs-ai/headroom/issues/4430))
([d17bac8](https://github.com/headroomlabs-ai/headroom/commit/d17bac8d64dd74ade81638ac7170715851c9704b))
* **pricing:** suppress litellm's Provider List banner that corrupts
perf JSON
([#4197](https://github.com/headroomlabs-ai/headroom/issues/4197))
([e01ad35](https://github.com/headroomlabs-ai/headroom/commit/e01ad350dc71d44f1a4e07df5ea4e45fa39a4773))
* **proxy:** accept HEADROOM_MEMORY_INJECTION_MODE=tool
([#4395](https://github.com/headroomlabs-ai/headroom/issues/4395))
([f89c928](https://github.com/headroomlabs-ai/headroom/commit/f89c9282a8216b8e168c29d85c6f13c5ce7d6301))
* **proxy:** bound per-model state keyed by the client model string
([#4407](https://github.com/headroomlabs-ai/headroom/issues/4407))
([33e5f67](https://github.com/headroomlabs-ai/headroom/commit/33e5f67464286961f37d09298d31c5022d275a32))
* **proxy:** copy cached tool compaction results (hardening)
([#4410](https://github.com/headroomlabs-ai/headroom/issues/4410))
([a256231](https://github.com/headroomlabs-ai/headroom/commit/a25623109d5075276af057e79c3ed3e309906563))
* **proxy:** count output tokens from CRLF-framed SSE streams too
([#4298](https://github.com/headroomlabs-ai/headroom/issues/4298))
([755293d](https://github.com/headroomlabs-ai/headroom/commit/755293dd68d495b6fcec15fd47d324c3ce5eeefa))
* **proxy:** do not rebuild a failed turn-hook re-drive as HTTP 200
([#4398](https://github.com/headroomlabs-ai/headroom/issues/4398))
([f59c8ff](https://github.com/headroomlabs-ai/headroom/commit/f59c8ffcd80f19564cf041d1fa4eb6247f2e1d01))
* **proxy:** drop web_search_call history from a Responses request with
no web_search tool
([#4202](https://github.com/headroomlabs-ai/headroom/issues/4202))
([2a70d12](https://github.com/headroomlabs-ai/headroom/commit/2a70d128195575cbc52129a5287a9a3ccc097744))
* **proxy:** honor bypass header and license gate in Anthropic batch
create
([#4411](https://github.com/headroomlabs-ai/headroom/issues/4411))
([4fd9cdd](https://github.com/headroomlabs-ai/headroom/commit/4fd9cddfd2e9cbbe38ab0b9d3acc6bc6f934a6e2))
* **proxy:** import Response at runtime in the Bedrock handler
([#4397](https://github.com/headroomlabs-ai/headroom/issues/4397))
([51e4ae3](https://github.com/headroomlabs-ai/headroom/commit/51e4ae36a5751fc494c0b583d37e62213e5a08a9))
* **proxy:** judge NAT64 upstream addresses by their embedded IPv4
([#4179](https://github.com/headroomlabs-ai/headroom/issues/4179))
([486afaa](https://github.com/headroomlabs-ai/headroom/commit/486afaac7426fa1d6735fe2ce6ae37630d9d11ae))
* **proxy:** keep in-period costs in the budget ledger when the entry
cap is reached
([#4448](https://github.com/headroomlabs-ai/headroom/issues/4448))
([41c15b3](https://github.com/headroomlabs-ai/headroom/commit/41c15b311cd5ab34d5108569eef4249a60973f96))
* **proxy:** keep negative compression savings across restart
([#4406](https://github.com/headroomlabs-ai/headroom/issues/4406))
([bebe24c](https://github.com/headroomlabs-ai/headroom/commit/bebe24c5ff0e815ac87937d9ecb1633a5091ab64))
* **proxy:** keep tool deferral for GitHub Copilot upstream
([#4356](https://github.com/headroomlabs-ai/headroom/issues/4356))
([217b658](https://github.com/headroomlabs-ai/headroom/commit/217b658845389e32a02760d75886de20d60e2ba3))
* **proxy:** let HEADROOM_LOG_LEVEL=debug turn on Headroom's own debug
logs ([#4137](https://github.com/headroomlabs-ai/headroom/issues/4137))
([00093ce](https://github.com/headroomlabs-ai/headroom/commit/00093ceddcf42c3936a96ea5f280af2d0e1b2e47))
* **proxy:** make handler failures debuggable from the logs
([#4127](https://github.com/headroomlabs-ai/headroom/issues/4127))
([7dc20b6](https://github.com/headroomlabs-ai/headroom/commit/7dc20b6fe027cf262c5e2d0415f0dbb2032ac73b))
* **proxy:** net tools a turn hook adds against the saving it books
([#4057](https://github.com/headroomlabs-ai/headroom/issues/4057))
([85520c2](https://github.com/headroomlabs-ai/headroom/commit/85520c2941ed6b2c4cd4bfd9f747b24227a256aa))
* **proxy:** record a stream the client closes after its terminal event
as completed
([#4286](https://github.com/headroomlabs-ai/headroom/issues/4286))
([762a337](https://github.com/headroomlabs-ai/headroom/commit/762a337bbeba268ae1e172c7a7de1e374231e32c))
* **proxy:** record outcome when a passthrough stream ends mid-character
([#4429](https://github.com/headroomlabs-ai/headroom/issues/4429))
([75cfbba](https://github.com/headroomlabs-ai/headroom/commit/75cfbba91d9bb2ff55df3949eddd4452dd9fb661))
* **proxy:** report disabled Kompress at startup
([#4217](https://github.com/headroomlabs-ai/headroom/issues/4217))
([430ea4f](https://github.com/headroomlabs-ai/headroom/commit/430ea4f4ebaeb0b217e237084963b64775bef24a))
* **proxy:** report read maturation as inert in cache mode
([#4198](https://github.com/headroomlabs-ai/headroom/issues/4198))
([ba82453](https://github.com/headroomlabs-ai/headroom/commit/ba824539d6f80c3e056f299789c1cf079a4693fe))
* **proxy:** show turn-hook savings in /stats extension_savings, incl.
Codex WS
([#4233](https://github.com/headroomlabs-ai/headroom/issues/4233))
([1d112cd](https://github.com/headroomlabs-ai/headroom/commit/1d112cd36c9aee765ec3b550773de0c93c6d79be))
* **proxy:** snapshot the original messages when a turn hook can edit
them ([#4241](https://github.com/headroomlabs-ai/headroom/issues/4241))
([df11f27](https://github.com/headroomlabs-ai/headroom/commit/df11f2749862a0090db11f7fca3e7dc42a75b612))
* **relevance:** load the default embedder from one pinned snapshot
([#4152](https://github.com/headroomlabs-ai/headroom/issues/4152))
([f380692](https://github.com/headroomlabs-ai/headroom/commit/f380692b463637e90de84f1b5cc29c7ae9f7b969))
* **savings:** key a Responses conversation on its thread, not the
shared session
([#4440](https://github.com/headroomlabs-ai/headroom/issues/4440))
([11f743d](https://github.com/headroomlabs-ai/headroom/commit/11f743dd90e9f60cf01805a23514bd06440dd2d2))
* **sdk:** preserve Vercel AI SDK file and image parts through
compression
([#4048](https://github.com/headroomlabs-ai/headroom/issues/4048))
([1668a6c](https://github.com/headroomlabs-ai/headroom/commit/1668a6c0dd73cd8a1b9d7fc5eae297149e8f7d93))
* **security:** restrict the Windows runtime log via NTFS ACL, not just
warn ([#4135](https://github.com/headroomlabs-ai/headroom/issues/4135))
([125a703](https://github.com/headroomlabs-ai/headroom/commit/125a703a65c574e9db809f95eefdc70407e0250e))
* **smart-crusher:** match audit-safe protected_patterns against
unescaped text
([#4294](https://github.com/headroomlabs-ai/headroom/issues/4294))
([e11afdb](https://github.com/headroomlabs-ai/headroom/commit/e11afdbdf8a729e50553681143d0f925b71fcd83))
* **storage:** normalize timezone-aware JSONL time filters
([#4063](https://github.com/headroomlabs-ai/headroom/issues/4063))
([bf34ccf](https://github.com/headroomlabs-ai/headroom/commit/bf34ccf58861a687e814abf1a158885987add9ae))
* **tabular:** pass tables with repeated header names through verbatim
([#4278](https://github.com/headroomlabs-ai/headroom/issues/4278))
([ed3195b](https://github.com/headroomlabs-ai/headroom/commit/ed3195beef1dcfbb0219c2da9b59984167c81c01))
* **telemetry:** give empty-item compressions a stable tool signature
([#4396](https://github.com/headroomlabs-ai/headroom/issues/4396))
([a79def4](https://github.com/headroomlabs-ai/headroom/commit/a79def4dd1b7217a75ce6c4eebd0b06ea3a70c1d))
* **telemetry:** let HEADROOM_TELEMETRY=off stop the anonymous beacon
([#4235](https://github.com/headroomlabs-ai/headroom/issues/4235))
([1a40b3c](https://github.com/headroomlabs-ai/headroom/commit/1a40b3ce67ad9e155ba768e8d05cec4c872c7f99))
* **transforms:** keep the fences of a code block passed through for a
protected tag
([#4292](https://github.com/headroomlabs-ai/headroom/issues/4292))
([02958c6](https://github.com/headroomlabs-ai/headroom/commit/02958c6ffe41a1d3466c21558670875df87384ae))
* **transforms:** log the compression failures that silently become "no
savings"
([#4092](https://github.com/headroomlabs-ai/headroom/issues/4092))
([580cc83](https://github.com/headroomlabs-ai/headroom/commit/580cc83a9a412123040978447a2c9b77c08670b0))
* **zcode:** skip providers that point at the Headroom proxy itself
([#4413](https://github.com/headroomlabs-ai/headroom/issues/4413))
([9ac1b52](https://github.com/headroomlabs-ai/headroom/commit/9ac1b52c2762bbc40d3e459e5f87cd4bbfbde8aa))


### Dependencies

* Bump base64 from 0.22.1 to 0.23.1
([#4029](https://github.com/headroomlabs-ai/headroom/issues/4029))
([8d468d4](https://github.com/headroomlabs-ai/headroom/commit/8d468d455c2e3c195cc2975bbc13e63d6b85ef59))
* Bump ruff from 0.16.8 to 0.17.0 in the pip-minor-patch group across 1
directory
([#4026](https://github.com/headroomlabs-ai/headroom/issues/4026))
([de3f639](https://github.com/headroomlabs-ai/headroom/commit/de3f639803f1f172f65c05c165bfab92c0bec9e8))
* Bump the cargo-minor-patch group across 1 directory with 12 updates
([#4186](https://github.com/headroomlabs-ai/headroom/issues/4186))
([683c9a6](https://github.com/headroomlabs-ai/headroom/commit/683c9a6120c309e84e4848378dbe3891d064f82e))
* Bump the npm-minor-patch group across 2 directories with 16 updates
([#4218](https://github.com/headroomlabs-ai/headroom/issues/4218))
([07c8bbf](https://github.com/headroomlabs-ai/headroom/commit/07c8bbf1edcc143a7fe97b9e29214355cc371a19))
* Bump the npm-minor-patch group across 3 directories with 12 updates
([#4219](https://github.com/headroomlabs-ai/headroom/issues/4219))
([1f71cb3](https://github.com/headroomlabs-ai/headroom/commit/1f71cb3d64e1586c97331a3482aae84558741102))
* Update huggingface-hub requirement from &lt;2.0,&gt;=1.5.0 to
&gt;=1.5.0,&lt;3.0
([#4027](https://github.com/headroomlabs-ai/headroom/issues/4027))
([fcf3db8](https://github.com/headroomlabs-ai/headroom/commit/fcf3db8e70d15aef0d80a561cf5d0e45e918a338))


### Code Refactoring

* **integrations:** share the local/cloud compress backend of asgi and
litellm_callback
([#4124](https://github.com/headroomlabs-ai/headroom/issues/4124))
([58caafb](https://github.com/headroomlabs-ai/headroom/commit/58caafb59b40c00b35ceee6237ef2289df71f25d))
* **transforms:** share one CCR persist helper for the Rust-backed
compressors
([#4094](https://github.com/headroomlabs-ai/headroom/issues/4094))
([ea947ca](https://github.com/headroomlabs-ai/headroom/commit/ea947ca421ee6d6b8f15a9ed522c3a3bea5a3225))

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

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-26 18:03:36 -05:00
d17bac8d64 fix(opencode): restore process env keys on transport dispose (#4430)
## Description

`installHeadroomTransport` sets `NODE_OPTIONS` (hook-shim `--import`),
`HEADROOM_OPENCODE_TRANSPORT_PROXY_URL` and
`HEADROOM_OPENCODE_EXCLUDE_HOSTS` in `process.env`, but its dispose only
restored `fetch`/`http`/`https`/`http2`/`child_process`. After dispose,
the parent and every child it spawned kept the shim preload and proxy
URL. The transport now snapshots those three keys on the first install
and restores them when the last install is disposed.

Fixes #4428

## Type of Change

- [x] 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

- `plugins/opencode/src/transport.ts`: `TransportState.originalEnv`
snapshot taken at first install (before `installProcessEnv`);
`restoreProcessEnv` runs in `uninstallHeadroomTransport` when `refs`
reaches 0. A nested dispose (refs still above 0) leaves the env alone.
- `plugins/opencode/src/transport.test.ts`: new test for the restore,
including the nested-dispose case and a pre-existing
`NODE_OPTIONS`/exclude-hosts value. Two existing tests (`prefers the
excludeHosts option over ...`, `clears a pre-existing ... when
excludeHosts is explicitly empty`) restored the env before disposing in
`finally`; they now dispose first, otherwise the new restore put the
earlier value back after their own cleanup and three later session-token
tests failed.
- `headroom/providers/opencode/_dist/index.js`,
`headroom/providers/opencode/hook-shim/handler.js`: rebuilt with `npm
run build:standalone` (the CI `cmp` check requires the committed bundles
to match the source).

## Testing

- [x] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

(The unit tests are `vitest` in `plugins/opencode`; `npm run typecheck`
also passes. No Python file changed, so ruff and mypy were not run.)

### Test Output

```text
# plugins/opencode, new test with the transport.ts change reverted
FAIL src/transport.test.ts > Headroom OpenCode transport > restores the process env keys it set once the last install is disposed
AssertionError: expected '--trace-warnings --import=file:///var…' to be '--trace-warnings'
Tests  1 failed | 57 passed (58)

# with the fix
Test Files  3 passed (3)
     Tests  58 passed (58)

$ npm run typecheck   # tsc --noEmit, no output
```

## Real Behavior Proof

- Environment: Ubuntu on WSL2, Node v24.22.1, upstream/main e995eb9f
plus this commit. The committed bundle
(`headroom/providers/opencode/_dist/index.js`) imported in Node, a local
stub HTTP server on 127.0.0.1:18930 as the proxy.
- Exact command / steps: `NODE_OPTIONS` set to `--trace-warnings`; `node
proof18.mjs <_dist/index.js>` imports the bundle, calls
`default.server(...)` with `proxyUrl=http://127.0.0.1:18930`, spawns a
child Node process that prints its env, sends one `fetch` to
`https://api.anthropic.com/v1/messages` (the stub log shows it arrived),
calls `hooks.dispose()`, then spawns a child again.
- Observed result: before (upstream/main bundle), after dispose the
child still has `NODE_OPTIONS` with `--import=.../hook-shim/handler.js`,
the proxy URL and `EXCLUDE=example.invalid`. After (this commit), the
child and the parent have `NODE_OPTIONS=--trace-warnings` and the other
two unset. Full output below.
- Not tested: a real OpenCode 1.x or 2.x host; Windows or macOS; a host
that changes one of the three variables itself between install and
dispose (the restore would overwrite that value with the pre-install
one).

Before (upstream/main `_dist`):

```text
while installed  child env: {"NODE_OPTIONS":"--trace-warnings --import=file://<before>/headroom/providers/opencode/hook-shim/handler.js","PROXY":"http://127.0.0.1:18930","EXCLUDE":"example.invalid"}
stub saw: ["POST /v1/messages x-headroom-base-url=https://api.anthropic.com"]
fetch restored: true
after dispose    child env: {"NODE_OPTIONS":"--trace-warnings --import=file://<before>/headroom/providers/opencode/hook-shim/handler.js","PROXY":"http://127.0.0.1:18930","EXCLUDE":"example.invalid"}
parent env after dispose: {"NODE_OPTIONS":"--trace-warnings --import=file://<before>/headroom/providers/opencode/hook-shim/handler.js","PROXY":"http://127.0.0.1:18930","EXCLUDE":"example.invalid"}
```

After (this commit):

```text
while installed  child env: {"NODE_OPTIONS":"--trace-warnings --import=file://<after>/headroom/providers/opencode/hook-shim/handler.js","PROXY":"http://127.0.0.1:18930","EXCLUDE":"example.invalid"}
stub saw: ["POST /v1/messages x-headroom-base-url=https://api.anthropic.com"]
fetch restored: true
after dispose    child env: {"NODE_OPTIONS":"--trace-warnings","PROXY":null,"EXCLUDE":null}
parent env after dispose: {"NODE_OPTIONS":"--trace-warnings","PROXY":null,"EXCLUDE":null}
```

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: n/a
- Stable/default behavior changed: yes, narrowly: after the OpenCode
plugin is disposed, `process.env` no longer carries the shim `--import`
and proxy variables, so children started afterwards are no longer routed
through the proxy
- Kill switch / disable path: none needed; the variables are only
touched while the transport is installed
- Unsafe override required: no
- Qualification impact: none expected
- Rollback path: revert this commit

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [x] 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 items: documentation (no doc describes the leaked variables),
ruff/mypy (no Python changed). Design choice to review: the snapshot is
taken once, at the first install, and restored only when the last nested
install is disposed, matching how the other patches are restored.

Produced with AI assistance (Claude Code) operated by me (HetCreep); the
reproduction was run on my machine on a clone of the repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/4430"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-24 08:44:52 -07:00
1be699f68e fix(deps): patch OpenClaw Undici and narrow E2E audit exceptions (#4453)
## Description

Includes the approved #4358 as its prerequisite. This PR targets main so
the complete integration workflows qualify the combined repair; its diff
will shrink to this follow-up once #4358 lands. Replace OpenClaw's
affected Undici copy instead of excepting it, and reduce the E2E audit
exceptions from seven advisory/path pairs to three.

OpenClaw 2026.10.2 lists Undici in `bundleDependencies`. Version
2026.10.6 removes it from that bundle, allowing a targeted, same-major
override to install fixed Undici 8.12.3. npm 12.2.1 still bundles its
own affected copies; this PR retains only those existing, expiring
exceptions.

## Type of Change

- [x] Bug fix

## Changes Made

- Pin the existing E2E OpenClaw CLI to 2026.10.6 and override only its
Undici dependency to 8.12.3.
- Regenerate the E2E lockfile; keep Codex and the npm override
unchanged.
- Remove every OpenClaw exception and the now-stale advisory, preserving
the parent's exact bundled-version checks and 2026-11-15 expiry.
- Update the Dockerfile comment to the actual Node requirement: 24.22.1
in the Node 24 line. Its NodeSource installation already selects that
line.

## Dependency and install-surface assessment

This updates an existing upstream-maintained CLI for a security fix,
rather than adding a replacement package. The fixed Undici remains in
the same major line. The graph is used only by the Docker wrap E2E
harness and is not shipped in Headroom's wheel or SDK. Normal
installation runs OpenClaw's existing lifecycle scripts and fetches
packages from the registry; those scripts were inspected, then exercised
inside a fresh Linux container without host credentials. No application
compression or routing logic changes.

## Testing

- [x] Manual testing performed
- [x] Dependency installation and runtime resolution verified

### Test Output

```text
OpenClaw runtime resolves Undici 8.12.3
OpenClaw 2026.10.6 (fe06181)
Installed audit: only npm bundled copies remain
{ info: 0, low: 0, moderate: 1, high: 1, critical: 0, total: 2 }
parent: 9 audit-guard cases passed
child: 9 audit-guard cases passed
git diff --check: passed
```

The guard accepts the current scoped findings and rejects a new
advisory, wrong path, expired exception, stale exception, audit error,
changed version, non-bundled copy, and missing inherited-advisory entry.
A raw audit remains nonzero for npm's bundled dependencies; this PR does
not claim those packages are patched.

## Real Behavior Proof

- Environment: fresh Linux amd64 Docker container,
`node:24.22.1-bookworm-slim`, Node 24.22.1 / npm 11.19.1, normal `npm
ci` with lifecycle scripts enabled.
- Exact command / steps: copy the two committed package files into a
fresh container volume; run `npm ci --no-audit --no-fund`; resolve
`undici/package.json` using
`createRequire('/work/node_modules/openclaw/package.json')` and assert
version 8.12.3; run `node node_modules/openclaw/openclaw.mjs --version`
and `--help`; run `npm audit --json` and assert that every remaining
affected node is under `node_modules/npm/`.
- Observed result: installation, exact runtime-resolution assertion,
version, and help all succeeded. Both installed-tree and lockfile audits
leave only npm's bundled Undici 6.29.0 and ip-address 10.7.2. The parent
workflow's guard passes with the narrowed exceptions and rejects all
eight negative cases.
- Not tested: a billed provider request or live production deployment.
Hosted Docker agent/integration scenarios have now passed. Hosted
qualification on head 63c3abc5b3 is
complete: all reported checks are terminal with no failures or pending
checks, including the full Security, build, test, and Docker integration
workflows.

## Runtime Rollout Safety

- Rollout-managed feature(s): none; E2E dependency data only.
- Minimum rollout channel: existing E2E test environment.
- Stable/default behavior changed: this follow-up patches only the
harness CLI. The included parent retains its explicitly documented
affected-Pillow decoder guard.
- Kill switch / disable path: revert this dependency commit.
- Unsafe override required: none; the override selects a compatible
fixed Undici 8.x patch. The parent's existing, bounded npm exceptions
remain explicit.
- Qualification impact: package installation, CLI startup, runtime
dependency resolution, and audit guarding were verified in isolation.
- Rollback path: revert the four-file change.

## Review Readiness

- [x] I performed self-review
- [x] This PR is ready for human merge review; the complete hosted check
set passed

## Checklist

- [x] I did not edit CHANGELOG.md.
- [x] The exception scope is reduced, not expanded.
- [x] No contributor correctness logic was modified.

Python lint/type checks and new production unit tests are not applicable
to these dependency/data changes. Independent human approval is
required; this is an author-side qualification record.

---------

Co-authored-by: Tejas Chopra <chopratejas@gmail.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Tejas Chopra <tejas@headroomlabs.ai>
2026-10-23 23:11:35 -07:00
dependabot[bot]andJD Davis 1f71cb3d64 deps: Bump the npm-minor-patch group across 3 directories with 12 updates (#4219)
## Description

Qualify the grouped npm updates in the OpenClaw/OpenCode plugins and
TypeScript SDK, with a patched MCP shipping dependency floor.

## Type of Change

- [x] Bug fix / dependency security and qualification

## Changes Made

Synced with upstream `main`
(`486afaac7426fa1d6735fe2ce6ae37630d9d11ae`). No contributor
implementation logic changed. Tested head:
`8c33aca5a9818dc348e3c1970ea8d3f6ae827818`. Includes the reviewed
dependency-floor fix from #4239 because the vulnerable version was still
permitted by shipping extras.

## Dependency assessment

Retains the upstream grouped dependency updates and existing MCP
JavaScript SDK security override. Packages retain their existing
install/runtime surfaces; no plugin or SDK source logic changes. The
Python MCP prerequisite excludes CVE-2026-59951 while keeping SDK v1.
Dependencies remain under their existing upstream maintainers; committed
lockfiles provide exact integrity-pinned trees. See the retained
Dependabot release notes below for individual package changes.

## Testing

npm ci --ignore-scripts, npm test and npm audit all passed in
plugins/openclaw, plugins/opencode and sdk/typescript; all audits report
zero vulnerabilities. TypeScript SDK npm run build passed. Branch
dependency contract: 1 passed; uv lock --check passed.

### Test Output

```text
npm ci --ignore-scripts, npm test and npm audit all passed in plugins/openclaw, plugins/opencode and sdk/typescript; all audits report zero vulnerabilities. TypeScript SDK npm run build passed. Branch dependency contract: 1 passed; uv lock --check passed.
```

## Real Behavior Proof

- Environment: Windows, PowerShell; installed Python/uv, Node/npm/Bun
and Rust tooling as applicable. No live provider/model used.
- Exact commands / steps:

```text
npm ci --ignore-scripts; npm test; npm audit (each changed package directory)
npm run build (sdk/typescript)
uv lock --check
python -m pytest -q tests/test_mcp_dependency_contract.py
git diff --check
```

- Observed result: npm ci --ignore-scripts, npm test and npm audit all
passed in plugins/openclaw, plugins/opencode and sdk/typescript; all
audits report zero vulnerabilities. TypeScript SDK npm run build passed.
Branch dependency contract: 1 passed; uv lock --check passed.
- Not tested: live model/provider traffic and full Docker E2E locally;
hosted cross-platform checks are running on the pushed head. Read hosted
results before merging. Focused checks are not a claim of complete
platform qualification.

## Runtime Rollout Safety

- Rollout-managed features: none added or enabled.
- Minimum rollout channel: unchanged.
- Stable/default behavior changed: dependency versions/ranges and
associated install metadata only; no feature rollout defaults changed.
- Kill switch / disable path: existing optional extras and plugin opt-in
paths remain available.
- Unsafe override required: no runtime qualification bypass. Security
dependency override is documented above where applicable.
- Qualification impact: hosted checks and the focused evidence above
must pass; no existing gate is removed.
- Rollback path: revert this dependency change and restore its prior
lockfiles together; retain the patched MCP minimum or another reviewed
security remediation.

## Review Readiness

- [x] Maintainer self-review and focused verification performed.
- [x] All hosted checks passed on the reviewed head. Ready for final
human merge review.

## Checklist

- [x] No contributor implementation logic rewritten.
- [x] Committed lockfiles checked against the changed manifests.
- [x] No manual CHANGELOG.md changes.
- [x] Known limitations recorded above.

## Original Dependabot update

Bumps the npm-minor-patch group with 3 updates in the /plugins/openclaw
directory: headroom-ai,
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
and
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest).
Bumps the npm-minor-patch group with 5 updates in the /plugins/opencode
directory:

| Package | From | To |
| --- | --- | --- |
| headroom-ai | `0.39.1` | `0.40.0` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |
| @opencode-ai/plugin | `1.18.33` | `1.19.0` |
| headroom-ai | `0.39.1` | `0.40.0` |
| [@opencode/plugin](https://github.com/anomalyco/opencode) | `2.0.24` |
`2.0.27` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |

Bumps the npm-minor-patch group with 9 updates in the /sdk/typescript
directory:

| Package | From | To |
| --- | --- | --- |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |
|
[@ai-sdk/anthropic](https://github.com/vercel/ai/tree/HEAD/packages/anthropic)
| `4.0.66` | `4.0.78` |
|
[@ai-sdk/openai](https://github.com/vercel/ai/tree/HEAD/packages/openai)
| `4.0.79` | `4.0.91` |
|
[@ai-sdk/provider](https://github.com/vercel/ai/tree/HEAD/packages/provider)
| `4.0.19` | `4.0.26` |
|
[@anthropic-ai/sdk](https://github.com/anthropics/anthropic-sdk-typescript)
| `0.129.0` | `0.133.0` |
|
[@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node)
| `26.6.3` | `26.6.5` |
| [ai](https://github.com/vercel/ai/tree/HEAD/packages/ai) | `7.0.119` |
`7.0.137` |
| [dotenv](https://github.com/motdotla/dotenv) | `18.0.4` | `18.0.7` |
| [openai](https://github.com/openai/openai-node) | `7.23.0` | `7.32.0`
|
|
[vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest)
| `5.0.2` | `5.0.3` |


Updates `headroom-ai` from 0.39.1 to 0.40.0

Updates `@types/node` from 26.6.3 to 26.6.5
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.2 to 5.0.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.3</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Isolate <code>result.status</code> between <code>repeats</code> runs
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11218">vitest-dev/vitest#11218</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dbebe9e3"><!-- raw
HTML omitted -->(5dbeb)<!-- raw HTML omitted --></a></li>
<li>Don't print an interceptor warning in browser mode  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11377">vitest-dev/vitest#11377</a>
<a href="https://github.com/vitest-dev/vitest/commit/15cc006aa"><!-- raw
HTML omitted -->(15cc0)<!-- raw HTML omitted --></a></li>
<li>Don't retry when <code>test.fails</code> expectedly failed  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11219">vitest-dev/vitest#11219</a>
<a href="https://github.com/vitest-dev/vitest/commit/b24585f08"><!-- raw
HTML omitted -->(b2458)<!-- raw HTML omitted --></a></li>
<li>Scope cache key generators to projects  -  by <a
href="https://github.com/ecoyoung"><code>@​ecoyoung</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11281">vitest-dev/vitest#11281</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11301">vitest-dev/vitest#11301</a>
<a href="https://github.com/vitest-dev/vitest/commit/92ba7fc1d"><!-- raw
HTML omitted -->(92ba7)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Delay server <code>listen</code> until tests start running  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11366">vitest-dev/vitest#11366</a>
<a href="https://github.com/vitest-dev/vitest/commit/7d8ed3e9b"><!-- raw
HTML omitted -->(7d8ed)<!-- raw HTML omitted --></a></li>
<li>Check mock path boundaries  -  by <a
href="https://github.com/saryn17"><code>@​saryn17</code></a>,
<strong>Ryosei Sato</strong> and <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11361">vitest-dev/vitest#11361</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11362">vitest-dev/vitest#11362</a>
<a href="https://github.com/vitest-dev/vitest/commit/1c3888bce"><!-- raw
HTML omitted -->(1c388)<!-- raw HTML omitted --></a></li>
<li>Keep config of browser-consumed environments  -  by <a
href="https://github.com/kasperpeulen"><code>@​kasperpeulen</code></a>
and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11378">vitest-dev/vitest#11378</a>
<a href="https://github.com/vitest-dev/vitest/commit/aafc0996f"><!-- raw
HTML omitted -->(aafc0)<!-- raw HTML omitted --></a></li>
<li>Ignore page crash while cancelling  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11386">vitest-dev/vitest#11386</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c36748fa"><!-- raw
HTML omitted -->(7c367)<!-- raw HTML omitted --></a></li>
<li><code>toMatchScreenshot</code> uses wrong reference on retried tests
 -  by <a href="https://github.com/macarie"><code>@​macarie</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11393">vitest-dev/vitest#11393</a>
<a href="https://github.com/vitest-dev/vitest/commit/c22aba992"><!-- raw
HTML omitted -->(c22ab)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>cache</strong>:
<ul>
<li>Revalidate imports of cached modules  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11381">vitest-dev/vitest#11381</a>
<a href="https://github.com/vitest-dev/vitest/commit/38f98855f"><!-- raw
HTML omitted -->(38f98)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>deps</strong>:
<ul>
<li>Pin <code>why-is-node-running</code> to <code>3.2.1</code> to avoid
users running into <code>ERR_PNPM_TRUST_DOWNGRADE</code>  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11403">vitest-dev/vitest#11403</a>
<a href="https://github.com/vitest-dev/vitest/commit/f6c9a4977"><!-- raw
HTML omitted -->(f6c9a)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>expect</strong>:
<ul>
<li>Pass current equality testers to <code>expect.extend</code>
asymmetric matchers  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11401">vitest-dev/vitest#11401</a>
<a href="https://github.com/vitest-dev/vitest/commit/3e794a96b"><!-- raw
HTML omitted -->(3e794)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>jsdom</strong>:
<ul>
<li>Support Blob on jsdom 30.1  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11379">vitest-dev/vitest#11379</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c49b7197"><!-- raw
HTML omitted -->(6c49b)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>pool</strong>:
<ul>
<li>Preserve unique pool ids when <code>groupOrder</code> is set  -  by
<a href="https://github.com/mtorp"><code>@​mtorp</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11392">vitest-dev/vitest#11392</a>
<a href="https://github.com/vitest-dev/vitest/commit/50312ebb4"><!-- raw
HTML omitted -->(50312)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>ui</strong>:
<ul>
<li>Split-pane handle overlapping iframe  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11221">vitest-dev/vitest#11221</a>
<a href="https://github.com/vitest-dev/vitest/commit/f91db0dfd"><!-- raw
HTML omitted -->(f91db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vitest</strong>:
<ul>
<li>Remove root temp dir on close  -  by <a
href="https://github.com/abhinav-phi"><code>@​abhinav-phi</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11248">vitest-dev/vitest#11248</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c7119cf7"><!-- raw
HTML omitted -->(7c711)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vm</strong>:
<ul>
<li>Do not optimize deps from index.html  -  by <a
href="https://github.com/ezefernandezyf"><code>@​ezefernandezyf</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11329">vitest-dev/vitest#11329</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11360">vitest-dev/vitest#11360</a>
<a href="https://github.com/vitest-dev/vitest/commit/caf2887de"><!-- raw
HTML omitted -->(caf28)<!-- raw HTML omitted --></a></li>
<li>Don't reuse scripts across vite environments  -  by <a
href="https://github.com/MO2k4"><code>@​MO2k4</code></a>, <strong>Martin
Oehlert</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11395">vitest-dev/vitest#11395</a>
<a href="https://github.com/vitest-dev/vitest/commit/346d3896b"><!-- raw
HTML omitted -->(346d3)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.2...v5.0.3">View
changes on GitHub</a></h5>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/33cadea62e8763c455c7fca38d9ab1dda87c5f75"><code>33cadea</code></a>
chore: release v5.0.3 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11409">#11409</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/346d3896b65c3c907174447a035807342799f346"><code>346d389</code></a>
fix(vm): don't reuse scripts across vite environments (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11395">#11395</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f6c9a4977ad3363f796a737834572e54c6ad5c18"><code>f6c9a49</code></a>
fix(deps): pin <code>why-is-node-running</code> to <code>3.2.1</code> to
avoid users running into `...</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/062c75d8b63519211d951d8293ea81b5a9e3c124"><code>062c75d</code></a>
chore: fix standalone docs build, update exports maps (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11394">#11394</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/caf2887dee8987a60118d53933f6e9cabd6b3e2a"><code>caf2887</code></a>
fix(vm): do not optimize deps from index.html (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11329">#11329</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11360">#11360</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/50312ebb4eca6a98f6d0b2b61d5d9d38cbbabcef"><code>50312eb</code></a>
fix(pool): preserve unique pool ids when <code>groupOrder</code> is set
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11392">#11392</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7c36748fad1eae9687312f2f7ceadce6ec88b5df"><code>7c36748</code></a>
fix(browser): ignore page crash while cancelling (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11386">#11386</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/92ba7fc1df16a4fa5bbee3f198c582fbd56689d8"><code>92ba7fc</code></a>
fix: scope cache key generators to projects (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11281">#11281</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11301">#11301</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/38f98855fa9cd7fd376afb84094eba0fda256a74"><code>38f9885</code></a>
fix(cache): revalidate imports of cached modules (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11381">#11381</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/b24585f08f2ea267746a2d6ca0e43edcbb29726f"><code>b24585f</code></a>
fix: don't retry when <code>test.fails</code> expectedly failed (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11219">#11219</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.3/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.39.1 to 0.40.0

Updates `@types/node` from 26.6.3 to 26.6.5
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.2 to 5.0.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.3</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Isolate <code>result.status</code> between <code>repeats</code> runs
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11218">vitest-dev/vitest#11218</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dbebe9e3"><!-- raw
HTML omitted -->(5dbeb)<!-- raw HTML omitted --></a></li>
<li>Don't print an interceptor warning in browser mode  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11377">vitest-dev/vitest#11377</a>
<a href="https://github.com/vitest-dev/vitest/commit/15cc006aa"><!-- raw
HTML omitted -->(15cc0)<!-- raw HTML omitted --></a></li>
<li>Don't retry when <code>test.fails</code> expectedly failed  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11219">vitest-dev/vitest#11219</a>
<a href="https://github.com/vitest-dev/vitest/commit/b24585f08"><!-- raw
HTML omitted -->(b2458)<!-- raw HTML omitted --></a></li>
<li>Scope cache key generators to projects  -  by <a
href="https://github.com/ecoyoung"><code>@​ecoyoung</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11281">vitest-dev/vitest#11281</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11301">vitest-dev/vitest#11301</a>
<a href="https://github.com/vitest-dev/vitest/commit/92ba7fc1d"><!-- raw
HTML omitted -->(92ba7)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Delay server <code>listen</code> until tests start running  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11366">vitest-dev/vitest#11366</a>
<a href="https://github.com/vitest-dev/vitest/commit/7d8ed3e9b"><!-- raw
HTML omitted -->(7d8ed)<!-- raw HTML omitted --></a></li>
<li>Check mock path boundaries  -  by <a
href="https://github.com/saryn17"><code>@​saryn17</code></a>,
<strong>Ryosei Sato</strong> and <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11361">vitest-dev/vitest#11361</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11362">vitest-dev/vitest#11362</a>
<a href="https://github.com/vitest-dev/vitest/commit/1c3888bce"><!-- raw
HTML omitted -->(1c388)<!-- raw HTML omitted --></a></li>
<li>Keep config of browser-consumed environments  -  by <a
href="https://github.com/kasperpeulen"><code>@​kasperpeulen</code></a>
and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11378">vitest-dev/vitest#11378</a>
<a href="https://github.com/vitest-dev/vitest/commit/aafc0996f"><!-- raw
HTML omitted -->(aafc0)<!-- raw HTML omitted --></a></li>
<li>Ignore page crash while cancelling  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11386">vitest-dev/vitest#11386</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c36748fa"><!-- raw
HTML omitted -->(7c367)<!-- raw HTML omitted --></a></li>
<li><code>toMatchScreenshot</code> uses wrong reference on retried tests
 -  by <a href="https://github.com/macarie"><code>@​macarie</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11393">vitest-dev/vitest#11393</a>
<a href="https://github.com/vitest-dev/vitest/commit/c22aba992"><!-- raw
HTML omitted -->(c22ab)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>cache</strong>:
<ul>
<li>Revalidate imports of cached modules  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11381">vitest-dev/vitest#11381</a>
<a href="https://github.com/vitest-dev/vitest/commit/38f98855f"><!-- raw
HTML omitted -->(38f98)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>deps</strong>:
<ul>
<li>Pin <code>why-is-node-running</code> to <code>3.2.1</code> to avoid
users running into <code>ERR_PNPM_TRUST_DOWNGRADE</code>  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11403">vitest-dev/vitest#11403</a>
<a href="https://github.com/vitest-dev/vitest/commit/f6c9a4977"><!-- raw
HTML omitted -->(f6c9a)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>expect</strong>:
<ul>
<li>Pass current equality testers to <code>expect.extend</code>
asymmetric matchers  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11401">vitest-dev/vitest#11401</a>
<a href="https://github.com/vitest-dev/vitest/commit/3e794a96b"><!-- raw
HTML omitted -->(3e794)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>jsdom</strong>:
<ul>
<li>Support Blob on jsdom 30.1  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11379">vitest-dev/vitest#11379</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c49b7197"><!-- raw
HTML omitted -->(6c49b)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>pool</strong>:
<ul>
<li>Preserve unique pool ids when <code>groupOrder</code> is set  -  by
<a href="https://github.com/mtorp"><code>@​mtorp</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11392">vitest-dev/vitest#11392</a>
<a href="https://github.com/vitest-dev/vitest/commit/50312ebb4"><!-- raw
HTML omitted -->(50312)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>ui</strong>:
<ul>
<li>Split-pane handle overlapping iframe  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11221">vitest-dev/vitest#11221</a>
<a href="https://github.com/vitest-dev/vitest/commit/f91db0dfd"><!-- raw
HTML omitted -->(f91db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vitest</strong>:
<ul>
<li>Remove root temp dir on close  -  by <a
href="https://github.com/abhinav-phi"><code>@​abhinav-phi</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11248">vitest-dev/vitest#11248</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c7119cf7"><!-- raw
HTML omitted -->(7c711)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vm</strong>:
<ul>
<li>Do not optimize deps from index.html  -  by <a
href="https://github.com/ezefernandezyf"><code>@​ezefernandezyf</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11329">vitest-dev/vitest#11329</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11360">vitest-dev/vitest#11360</a>
<a href="https://github.com/vitest-dev/vitest/commit/caf2887de"><!-- raw
HTML omitted -->(caf28)<!-- raw HTML omitted --></a></li>
<li>Don't reuse scripts across vite environments  -  by <a
href="https://github.com/MO2k4"><code>@​MO2k4</code></a>, <strong>Martin
Oehlert</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11395">vitest-dev/vitest#11395</a>
<a href="https://github.com/vitest-dev/vitest/commit/346d3896b"><!-- raw
HTML omitted -->(346d3)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.2...v5.0.3">View
changes on GitHub</a></h5>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/33cadea62e8763c455c7fca38d9ab1dda87c5f75"><code>33cadea</code></a>
chore: release v5.0.3 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11409">#11409</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/346d3896b65c3c907174447a035807342799f346"><code>346d389</code></a>
fix(vm): don't reuse scripts across vite environments (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11395">#11395</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f6c9a4977ad3363f796a737834572e54c6ad5c18"><code>f6c9a49</code></a>
fix(deps): pin <code>why-is-node-running</code> to <code>3.2.1</code> to
avoid users running into `...</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/062c75d8b63519211d951d8293ea81b5a9e3c124"><code>062c75d</code></a>
chore: fix standalone docs build, update exports maps (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11394">#11394</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/caf2887dee8987a60118d53933f6e9cabd6b3e2a"><code>caf2887</code></a>
fix(vm): do not optimize deps from index.html (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11329">#11329</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11360">#11360</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/50312ebb4eca6a98f6d0b2b61d5d9d38cbbabcef"><code>50312eb</code></a>
fix(pool): preserve unique pool ids when <code>groupOrder</code> is set
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11392">#11392</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7c36748fad1eae9687312f2f7ceadce6ec88b5df"><code>7c36748</code></a>
fix(browser): ignore page crash while cancelling (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11386">#11386</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/92ba7fc1df16a4fa5bbee3f198c582fbd56689d8"><code>92ba7fc</code></a>
fix: scope cache key generators to projects (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11281">#11281</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11301">#11301</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/38f98855fa9cd7fd376afb84094eba0fda256a74"><code>38f9885</code></a>
fix(cache): revalidate imports of cached modules (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11381">#11381</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/b24585f08f2ea267746a2d6ca0e43edcbb29726f"><code>b24585f</code></a>
fix: don't retry when <code>test.fails</code> expectedly failed (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11219">#11219</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.3/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `@types/node` from 26.6.3 to 26.6.5
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.2 to 5.0.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.3</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Isolate <code>result.status</code> between <code>repeats</code> runs
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11218">vitest-dev/vitest#11218</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dbebe9e3"><!-- raw
HTML omitted -->(5dbeb)<!-- raw HTML omitted --></a></li>
<li>Don't print an interceptor warning in browser mode  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11377">vitest-dev/vitest#11377</a>
<a href="https://github.com/vitest-dev/vitest/commit/15cc006aa"><!-- raw
HTML omitted -->(15cc0)<!-- raw HTML omitted --></a></li>
<li>Don't retry when <code>test.fails</code> expectedly failed  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11219">vitest-dev/vitest#11219</a>
<a href="https://github.com/vitest-dev/vitest/commit/b24585f08"><!-- raw
HTML omitted -->(b2458)<!-- raw HTML omitted --></a></li>
<li>Scope cache key generators to projects  -  by <a
href="https://github.com/ecoyoung"><code>@​ecoyoung</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11281">vitest-dev/vitest#11281</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11301">vitest-dev/vitest#11301</a>
<a href="https://github.com/vitest-dev/vitest/commit/92ba7fc1d"><!-- raw
HTML omitted -->(92ba7)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Delay server <code>listen</code> until tests start running  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11366">vitest-dev/vitest#11366</a>
<a href="https://github.com/vitest-dev/vitest/commit/7d8ed3e9b"><!-- raw
HTML omitted -->(7d8ed)<!-- raw HTML omitted --></a></li>
<li>Check mock path boundaries  -  by <a
href="https://github.com/saryn17"><code>@​saryn17</code></a>,
<strong>Ryosei Sato</strong> and <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11361">vitest-dev/vitest#11361</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11362">vitest-dev/vitest#11362</a>
<a href="https://github.com/vitest-dev/vitest/commit/1c3888bce"><!-- raw
HTML omitted -->(1c388)<!-- raw HTML omitted --></a></li>
<li>Keep config of browser-consumed environments  -  by <a
href="https://github.com/kasperpeulen"><code>@​kasperpeulen</code></a>
and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11378">vitest-dev/vitest#11378</a>
<a href="https://github.com/vitest-dev/vitest/commit/aafc0996f"><!-- raw
HTML omitted -->(aafc0)<!-- raw HTML omitted --></a></li>
<li>Ignore page crash while cancelling  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11386">vitest-dev/vitest#11386</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c36748fa"><!-- raw
HTML omitted -->(7c367)<!-- raw HTML omitted --></a></li>
<li><code>toMatchScreenshot</code> uses wrong reference on retried tests
 -  by <a href="https://github.com/macarie"><code>@​macarie</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11393">vitest-dev/vitest#11393</a>
<a href="https://github.com/vitest-dev/vitest/commit/c22aba992"><!-- raw
HTML omitted -->(c22ab)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>cache</strong>:
<ul>
<li>Revalidate imports of cached modules  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11381">vitest-dev/vitest#11381</a>
<a href="https://github.com/vitest-dev/vitest/commit/38f98855f"><!-- raw
HTML omitted -->(38f98)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>deps</strong>:
<ul>
<li>Pin <code>why-is-node-running</code> to <code>3.2.1</code> to avoid
users running into <code>ERR_PNPM_TRUST_DOWNGRADE</code>  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11403">vitest-dev/vitest#11403</a>
<a href="https://github.com/vitest-dev/vitest/commit/f6c9a4977"><!-- raw
HTML omitted -->(f6c9a)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>expect</strong>:
<ul>
<li>Pass current equality testers to <code>expect.extend</code>
asymmetric matchers  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11401">vitest-dev/vitest#11401</a>
<a href="https://github.com/vitest-dev/vitest/commit/3e794a96b"><!-- raw
HTML omitted -->(3e794)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>jsdom</strong>:
<ul>
<li>Support Blob on jsdom 30.1  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11379">vitest-dev/vitest#11379</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c49b7197"><!-- raw
HTML omitted -->(6c49b)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>pool</strong>:
<ul>
<li>Preserve unique pool ids when <code>groupOrder</code> is set  -  by
<a href="https://github.com/mtorp"><code>@​mtorp</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11392">vitest-dev/vitest#11392</a>
<a href="https://github.com/vitest-dev/vitest/commit/50312ebb4"><!-- raw
HTML omitted -->(50312)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>ui</strong>:
<ul>
<li>Split-pane handle overlapping iframe  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11221">vitest-dev/vitest#11221</a>
<a href="https://github.com/vitest-dev/vitest/commit/f91db0dfd"><!-- raw
HTML omitted -->(f91db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vitest</strong>:
<ul>
<li>Remove root temp dir on close  -  by <a
href="https://github.com/abhinav-phi"><code>@​abhinav-phi</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11248">vitest-dev/vitest#11248</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c7119cf7"><!-- raw
HTML omitted -->(7c711)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vm</strong>:
<ul>
<li>Do not optimize deps from index.html  -  by <a
href="https://github.com/ezefernandezyf"><code>@​ezefernandezyf</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11329">vitest-dev/vitest#11329</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11360">vitest-dev/vitest#11360</a>
<a href="https://github.com/vitest-dev/vitest/commit/caf2887de"><!-- raw
HTML omitted -->(caf28)<!-- raw HTML omitted --></a></li>
<li>Don't reuse scripts across vite environments  -  by <a
href="https://github.com/MO2k4"><code>@​MO2k4</code></a>, <strong>Martin
Oehlert</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11395">vitest-dev/vitest#11395</a>
<a href="https://github.com/vitest-dev/vitest/commit/346d3896b"><!-- raw
HTML omitted -->(346d3)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.2...v5.0.3">View
changes on GitHub</a></h5>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/33cadea62e8763c455c7fca38d9ab1dda87c5f75"><code>33cadea</code></a>
chore: release v5.0.3 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11409">#11409</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/346d3896b65c3c907174447a035807342799f346"><code>346d389</code></a>
fix(vm): don't reuse scripts across vite environments (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11395">#11395</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f6c9a4977ad3363f796a737834572e54c6ad5c18"><code>f6c9a49</code></a>
fix(deps): pin <code>why-is-node-running</code> to <code>3.2.1</code> to
avoid users running into `...</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/062c75d8b63519211d951d8293ea81b5a9e3c124"><code>062c75d</code></a>
chore: fix standalone docs build, update exports maps (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11394">#11394</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/caf2887dee8987a60118d53933f6e9cabd6b3e2a"><code>caf2887</code></a>
fix(vm): do not optimize deps from index.html (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11329">#11329</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11360">#11360</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/50312ebb4eca6a98f6d0b2b61d5d9d38cbbabcef"><code>50312eb</code></a>
fix(pool): preserve unique pool ids when <code>groupOrder</code> is set
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11392">#11392</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7c36748fad1eae9687312f2f7ceadce6ec88b5df"><code>7c36748</code></a>
fix(browser): ignore page crash while cancelling (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11386">#11386</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/92ba7fc1df16a4fa5bbee3f198c582fbd56689d8"><code>92ba7fc</code></a>
fix: scope cache key generators to projects (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11281">#11281</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11301">#11301</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/38f98855fa9cd7fd376afb84094eba0fda256a74"><code>38f9885</code></a>
fix(cache): revalidate imports of cached modules (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11381">#11381</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/b24585f08f2ea267746a2d6ca0e43edcbb29726f"><code>b24585f</code></a>
fix: don't retry when <code>test.fails</code> expectedly failed (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11219">#11219</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.3/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `headroom-ai` from 0.39.1 to 0.40.0

Updates `@types/node` from 26.6.3 to 26.6.5
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.2 to 5.0.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.3</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Isolate <code>result.status</code> between <code>repeats</code> runs
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11218">vitest-dev/vitest#11218</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dbebe9e3"><!-- raw
HTML omitted -->(5dbeb)<!-- raw HTML omitted --></a></li>
<li>Don't print an interceptor warning in browser mode  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11377">vitest-dev/vitest#11377</a>
<a href="https://github.com/vitest-dev/vitest/commit/15cc006aa"><!-- raw
HTML omitted -->(15cc0)<!-- raw HTML omitted --></a></li>
<li>Don't retry when <code>test.fails</code> expectedly failed  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11219">vitest-dev/vitest#11219</a>
<a href="https://github.com/vitest-dev/vitest/commit/b24585f08"><!-- raw
HTML omitted -->(b2458)<!-- raw HTML omitted --></a></li>
<li>Scope cache key generators to projects  -  by <a
href="https://github.com/ecoyoung"><code>@​ecoyoung</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11281">vitest-dev/vitest#11281</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11301">vitest-dev/vitest#11301</a>
<a href="https://github.com/vitest-dev/vitest/commit/92ba7fc1d"><!-- raw
HTML omitted -->(92ba7)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Delay server <code>listen</code> until tests start running  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11366">vitest-dev/vitest#11366</a>
<a href="https://github.com/vitest-dev/vitest/commit/7d8ed3e9b"><!-- raw
HTML omitted -->(7d8ed)<!-- raw HTML omitted --></a></li>
<li>Check mock path boundaries  -  by <a
href="https://github.com/saryn17"><code>@​saryn17</code></a>,
<strong>Ryosei Sato</strong> and <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11361">vitest-dev/vitest#11361</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11362">vitest-dev/vitest#11362</a>
<a href="https://github.com/vitest-dev/vitest/commit/1c3888bce"><!-- raw
HTML omitted -->(1c388)<!-- raw HTML omitted --></a></li>
<li>Keep config of browser-consumed environments  -  by <a
href="https://github.com/kasperpeulen"><code>@​kasperpeulen</code></a>
and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11378">vitest-dev/vitest#11378</a>
<a href="https://github.com/vitest-dev/vitest/commit/aafc0996f"><!-- raw
HTML omitted -->(aafc0)<!-- raw HTML omitted --></a></li>
<li>Ignore page crash while cancelling  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11386">vitest-dev/vitest#11386</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c36748fa"><!-- raw
HTML omitted -->(7c367)<!-- raw HTML omitted --></a></li>
<li><code>toMatchScreenshot</code> uses wrong reference on retried tests
 -  by <a href="https://github.com/macarie"><code>@​macarie</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11393">vitest-dev/vitest#11393</a>
<a href="https://github.com/vitest-dev/vitest/commit/c22aba992"><!-- raw
HTML omitted -->(c22ab)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>cache</strong>:
<ul>
<li>Revalidate imports of cached modules  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11381">vitest-dev/vitest#11381</a>
<a href="https://github.com/vitest-dev/vitest/commit/38f98855f"><!-- raw
HTML omitted -->(38f98)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>deps</strong>:
<ul>
<li>Pin <code>why-is-node-running</code> to <code>3.2.1</code> to avoid
users running into <code>ERR_PNPM_TRUST_DOWNGRADE</code>  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11403">vitest-dev/vitest#11403</a>
<a href="https://github.com/vitest-dev/vitest/commit/f6c9a4977"><!-- raw
HTML omitted -->(f6c9a)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>expect</strong>:
<ul>
<li>Pass current equality testers to <code>expect.extend</code>
asymmetric matchers  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11401">vitest-dev/vitest#11401</a>
<a href="https://github.com/vitest-dev/vitest/commit/3e794a96b"><!-- raw
HTML omitted -->(3e794)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>jsdom</strong>:
<ul>
<li>Support Blob on jsdom 30.1  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11379">vitest-dev/vitest#11379</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c49b7197"><!-- raw
HTML omitted -->(6c49b)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>pool</strong>:
<ul>
<li>Preserve unique pool ids when <code>groupOrder</code> is set  -  by
<a href="https://github.com/mtorp"><code>@​mtorp</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11392">vitest-dev/vitest#11392</a>
<a href="https://github.com/vitest-dev/vitest/commit/50312ebb4"><!-- raw
HTML omitted -->(50312)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>ui</strong>:
<ul>
<li>Split-pane handle overlapping iframe  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11221">vitest-dev/vitest#11221</a>
<a href="https://github.com/vitest-dev/vitest/commit/f91db0dfd"><!-- raw
HTML omitted -->(f91db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vitest</strong>:
<ul>
<li>Remove root temp dir on close  -  by <a
href="https://github.com/abhinav-phi"><code>@​abhinav-phi</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11248">vitest-dev/vitest#11248</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c7119cf7"><!-- raw
HTML omitted -->(7c711)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vm</strong>:
<ul>
<li>Do not optimize deps from index.html  -  by <a
href="https://github.com/ezefernandezyf"><code>@​ezefernandezyf</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11329">vitest-dev/vitest#11329</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11360">vitest-dev/vitest#11360</a>
<a href="https://github.com/vitest-dev/vitest/commit/caf2887de"><!-- raw
HTML omitted -->(caf28)<!-- raw HTML omitted --></a></li>
<li>Don't reuse scripts across vite environments  -  by <a
href="https://github.com/MO2k4"><code>@​MO2k4</code></a>, <strong>Martin
Oehlert</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11395">vitest-dev/vitest#11395</a>
<a href="https://github.com/vitest-dev/vitest/commit/346d3896b"><!-- raw
HTML omitted -->(346d3)<!-- raw HTML omitted --></a></li>
</ul>
</li>
</ul>
<h5>    <a
href="https://github.com/vitest-dev/vitest/compare/v5.0.2...v5.0.3">View
changes on GitHub</a></h5>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/vitest-dev/vitest/commit/33cadea62e8763c455c7fca38d9ab1dda87c5f75"><code>33cadea</code></a>
chore: release v5.0.3 (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11409">#11409</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/346d3896b65c3c907174447a035807342799f346"><code>346d389</code></a>
fix(vm): don't reuse scripts across vite environments (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11395">#11395</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/f6c9a4977ad3363f796a737834572e54c6ad5c18"><code>f6c9a49</code></a>
fix(deps): pin <code>why-is-node-running</code> to <code>3.2.1</code> to
avoid users running into `...</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/062c75d8b63519211d951d8293ea81b5a9e3c124"><code>062c75d</code></a>
chore: fix standalone docs build, update exports maps (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11394">#11394</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/caf2887dee8987a60118d53933f6e9cabd6b3e2a"><code>caf2887</code></a>
fix(vm): do not optimize deps from index.html (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11329">#11329</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11360">#11360</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/50312ebb4eca6a98f6d0b2b61d5d9d38cbbabcef"><code>50312eb</code></a>
fix(pool): preserve unique pool ids when <code>groupOrder</code> is set
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11392">#11392</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/7c36748fad1eae9687312f2f7ceadce6ec88b5df"><code>7c36748</code></a>
fix(browser): ignore page crash while cancelling (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11386">#11386</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/92ba7fc1df16a4fa5bbee3f198c582fbd56689d8"><code>92ba7fc</code></a>
fix: scope cache key generators to projects (fix <a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11281">#11281</a>)
(<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11301">#11301</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/38f98855fa9cd7fd376afb84094eba0fda256a74"><code>38f9885</code></a>
fix(cache): revalidate imports of cached modules (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11381">#11381</a>)</li>
<li><a
href="https://github.com/vitest-dev/vitest/commit/b24585f08f2ea267746a2d6ca0e43edcbb29726f"><code>b24585f</code></a>
fix: don't retry when <code>test.fails</code> expectedly failed (<a
href="https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest/issues/11219">#11219</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/vitest-dev/vitest/commits/v5.0.3/packages/vitest">compare
view</a></li>
</ul>
</details>
<br />

Updates `@opencode-ai/plugin` from 1.18.33 to 1.19.0

Updates `headroom-ai` from 0.39.1 to 0.40.0

Updates `@opencode/plugin` from 2.0.24 to 2.0.27
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/anomalyco/opencode/blob/dev/CHANGELOG.md">@​opencode/plugin's
changelog</a>.</em></p>
<blockquote>
<h2>v2.0.27 — 2026-10-12</h2>
<h3>Highlights</h3>
<ul>
<li><strong>Built-In Worktree Tools</strong>: Ask OpenCode to use
<code>worktree_create</code>, <code>worktree_list</code>, and
<code>worktree_remove</code> in Code Mode. You can create isolated
worktrees, move sessions into them, and remove them with normal edit
approval. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53981">#53981</a>)</li>
<li><strong>Safer Remote Pairing</strong>: The first <code>opencode pair
--remote</code> now warns that it will expose your server and asks for
confirmation. For non-interactive use, pass <code>opencode pair --remote
--yes</code>. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54561">#54561</a>)</li>
<li><strong>Installable Web App</strong>: Use Chrome or Edge’s
<strong>Install</strong> button to install the OpenCode web app,
including when it runs behind an authenticating proxy. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53905">#53905</a>)</li>
<li><strong>Clear Session Failures</strong>: Desktop and TUI timelines
now show execution errors that happen before or between model steps
instead of ending without an explanation. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53826">#53826</a>)</li>
<li><strong>Automatic Project Cleanup</strong>: Projects whose
directories no longer exist are automatically hidden from the project
list. Opening the directory again restores the project. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54354">#54354</a>)</li>
</ul>
<h3>Core</h3>
<h4>Improvements</h4>
<ul>
<li>Added the built-in Code Mode tools
<code>opencode.worktree_create</code>,
<code>opencode.worktree_list</code>, and
<code>opencode.worktree_remove</code>. Removing a worktree requires edit
approval, and <code>force: true</code> can discard modified or untracked
files. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53981">#53981</a>)</li>
<li>Added confirmation before <code>opencode pair --remote</code> first
enables internet access, plus <code>--yes</code>/<code>-y</code> for
scripts and other non-interactive use. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54561">#54561</a>)</li>
<li>Automatically archived projects when all known directories
disappear. Reopening a project restores it, while surviving clones and
linked worktrees keep it active. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54354">#54354</a>)</li>
<li>Raised the ChatGPT OAuth input limit for <code>gpt-6.1-sol</code>
and <code>gpt-6.1-sol-fast</code> to 500,000 tokens. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54668">#54668</a>)</li>
<li>Added Vertex AI routes for Interactions and Mistral models. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54175">#54175</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/54058">#54058</a>)</li>
</ul>
<h4>Bug fixes</h4>
<ul>
<li>Fixed updater detection for symlinked home directories and
package-manager installations, increased probe timeouts, and now report
unavailable updates clearly when the installation method cannot be
detected. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54609">#54609</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/54622">#54622</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/54672">#54672</a>)</li>
<li>Fixed GitHub Copilot routing for Gemini, Anthropic, and Responses
models when live model metadata is unavailable, and accepted interleaved
Claude reasoning values. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54208">#54208</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/54210">#54210</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/54201">#54201</a>)</li>
<li>Fixed Google Vertex Application Default Credentials when
<code>CLOUDSDK_CONFIG</code> points to a custom gcloud configuration
directory. Thanks <a
href="https://github.com/H-Max"><code>@​H-Max</code></a>. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54164">#54164</a>)</li>
<li>Prevented ChatGPT token-sharing sessions from sending unsupported
mid-session reasoning-effort updates. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54085">#54085</a>)</li>
<li>Blocked <code>file://</code> access through Code Mode’s
<code>fetch</code>, which now returns a clear filesystem-access error.
Thanks <a
href="https://github.com/ferdinandyb"><code>@​ferdinandyb</code></a>.
(<a
href="https://redirect.github.com/anomalyco/opencode/pull/54510">#54510</a>)</li>
<li>Fixed remote workspace file operations so driver-provided filesystem
overrides are used correctly.</li>
<li>Preserved subagent notifications when location services are evicted,
and propagated well-known configuration updates across locations with
bounded HTTP timeouts. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54072">#54072</a>,
<a
href="https://redirect.github.com/anomalyco/opencode/pull/53821">#53821</a>)</li>
</ul>
<h3>TUI</h3>
<h4>Bug fixes</h4>
<ul>
<li>Displayed session execution failures that occur before or between
model steps directly in the timeline. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53826">#53826</a>)</li>
<li>Preserved a saved session’s unavailable model selection instead of
silently replacing it with a fallback. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53822">#53822</a>)</li>
<li>Added syntax highlighting for C++ module interface files such as
<code>.cppm</code>, <code>.ixx</code>, and <code>.cxxm</code>. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53853">#53853</a>)</li>
<li>Summarized integrations with multiple credentials as a connection
count, preventing long labels from crowding the integration name. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54054">#54054</a>)</li>
</ul>
<h3>Desktop</h3>
<h4>Improvements</h4>
<ul>
<li>Made the web app installable from Chrome and Edge, including
deployments behind cookie-based authenticating proxies. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53905">#53905</a>)</li>
<li>Updated the session column layout and text wrapping for clearer long
content. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54020">#54020</a>)</li>
</ul>
<h4>Bug fixes</h4>
<ul>
<li>Displayed session execution failures that occur before or between
model steps directly in the timeline. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/53826">#53826</a>)</li>
<li>Fixed command-palette selection so newly arriving higher-ranked
results become active until you explicitly choose a result. (<a
href="https://redirect.github.com/anomalyco/opencode/pull/54275">#54275</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/anomalyco/opencode/commit/1f4d07a4a519185955ae8ab2ea3607805509e386"><code>1f4d07a</code></a>
release: v2.0.27</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/4d9678a79d6367ad1257c258049075e7a2d0c6c8"><code>4d9678a</code></a>
fix(release): exclude V1 history from the release review range (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54674">#54674</a>)</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/4d3d8fd769523b4e2f6b523e3df9fa965130fb4c"><code>4d3d8fd</code></a>
docs: trim agent instructions (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54678">#54678</a>)</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/e5a557efeee02c94486d391afc48f24a49ebc9a5"><code>e5a557e</code></a>
fix(cli): return unavailable in updater.check when install method is
unknown ...</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/35ef229454d3664624ca798f53341858fc0dc33d"><code>35ef229</code></a>
feat(core): raise ChatGPT OAuth context for gpt-6.1-sol to 500k (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54668">#54668</a>)</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/707de5832656e89cc0f04436aa1cd5f4f91c5763"><code>707de58</code></a>
fix(cli): prioritize path-matched package manager and extend probe
timeout (#...</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/ca19780de1b5ece1b84e0482e0f41c3a39228288"><code>ca19780</code></a>
fix(stats): bound public page caching</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/47e5e71599c1adf43119a125003c31c7b376675c"><code>47e5e71</code></a>
fix(cli): resolve symlinked home path when detecting curl installs (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54609">#54609</a>)</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/1c63fe9afeff4ead2623e9bbb2e2bc40e6205c0b"><code>1c63fe9</code></a>
docs: use update service latest redirect URLs for downloads (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54598">#54598</a>)</li>
<li><a
href="https://github.com/anomalyco/opencode/commit/727fd603bef6472aa4d2a82479d0c09478b057de"><code>727fd60</code></a>
feat(update): redirect artifact filenames to latest release URLs (<a
href="https://redirect.github.com/anomalyco/opencode/issues/54597">#54597</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/anomalyco/opencode/compare/v2.0.24...v2.0.27">compare
view</a></li>
</ul>
</details>
<br />

Updates `@types/node` from 26.6.3 to 26.6.5
<details>
<summary>Commits</summary>
<ul>
<li>See full diff in <a
href="https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node">compare
view</a></li>
</ul>
</details>
<br />

Updates `vitest` from 5.0.2 to 5.0.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/vitest-dev/vitest/releases">vitest's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.3</h2>
<h3>   🐞 Bug Fixes</h3>
<ul>
<li>Isolate <code>result.status</code> between <code>repeats</code> runs
 -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11218">vitest-dev/vitest#11218</a>
<a href="https://github.com/vitest-dev/vitest/commit/5dbebe9e3"><!-- raw
HTML omitted -->(5dbeb)<!-- raw HTML omitted --></a></li>
<li>Don't print an interceptor warning in browser mode  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11377">vitest-dev/vitest#11377</a>
<a href="https://github.com/vitest-dev/vitest/commit/15cc006aa"><!-- raw
HTML omitted -->(15cc0)<!-- raw HTML omitted --></a></li>
<li>Don't retry when <code>test.fails</code> expectedly failed  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Codex (GPT-6)</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11219">vitest-dev/vitest#11219</a>
<a href="https://github.com/vitest-dev/vitest/commit/b24585f08"><!-- raw
HTML omitted -->(b2458)<!-- raw HTML omitted --></a></li>
<li>Scope cache key generators to projects  -  by <a
href="https://github.com/ecoyoung"><code>@​ecoyoung</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11281">vitest-dev/vitest#11281</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11301">vitest-dev/vitest#11301</a>
<a href="https://github.com/vitest-dev/vitest/commit/92ba7fc1d"><!-- raw
HTML omitted -->(92ba7)<!-- raw HTML omitted --></a></li>
<li><strong>browser</strong>:
<ul>
<li>Delay server <code>listen</code> until tests start running  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11366">vitest-dev/vitest#11366</a>
<a href="https://github.com/vitest-dev/vitest/commit/7d8ed3e9b"><!-- raw
HTML omitted -->(7d8ed)<!-- raw HTML omitted --></a></li>
<li>Check mock path boundaries  -  by <a
href="https://github.com/saryn17"><code>@​saryn17</code></a>,
<strong>Ryosei Sato</strong> and <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11361">vitest-dev/vitest#11361</a>
and <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11362">vitest-dev/vitest#11362</a>
<a href="https://github.com/vitest-dev/vitest/commit/1c3888bce"><!-- raw
HTML omitted -->(1c388)<!-- raw HTML omitted --></a></li>
<li>Keep config of browser-consumed environments  -  by <a
href="https://github.com/kasperpeulen"><code>@​kasperpeulen</code></a>
and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11378">vitest-dev/vitest#11378</a>
<a href="https://github.com/vitest-dev/vitest/commit/aafc0996f"><!-- raw
HTML omitted -->(aafc0)<!-- raw HTML omitted --></a></li>
<li>Ignore page crash while cancelling  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11386">vitest-dev/vitest#11386</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c36748fa"><!-- raw
HTML omitted -->(7c367)<!-- raw HTML omitted --></a></li>
<li><code>toMatchScreenshot</code> uses wrong reference on retried tests
 -  by <a href="https://github.com/macarie"><code>@​macarie</code></a>
in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11393">vitest-dev/vitest#11393</a>
<a href="https://github.com/vitest-dev/vitest/commit/c22aba992"><!-- raw
HTML omitted -->(c22ab)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>cache</strong>:
<ul>
<li>Revalidate imports of cached modules  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11381">vitest-dev/vitest#11381</a>
<a href="https://github.com/vitest-dev/vitest/commit/38f98855f"><!-- raw
HTML omitted -->(38f98)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>deps</strong>:
<ul>
<li>Pin <code>why-is-node-running</code> to <code>3.2.1</code> to avoid
users running into <code>ERR_PNPM_TRUST_DOWNGRADE</code>  -  by <a
href="https://github.com/AriPerkkio"><code>@​AriPerkkio</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11403">vitest-dev/vitest#11403</a>
<a href="https://github.com/vitest-dev/vitest/commit/f6c9a4977"><!-- raw
HTML omitted -->(f6c9a)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>expect</strong>:
<ul>
<li>Pass current equality testers to <code>expect.extend</code>
asymmetric matchers  -  by <a
href="https://github.com/hi-ogawa"><code>@​hi-ogawa</code></a>,
<strong>Hiroshi Ogawa</strong> and <strong>Claude</strong> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11401">vitest-dev/vitest#11401</a>
<a href="https://github.com/vitest-dev/vitest/commit/3e794a96b"><!-- raw
HTML omitted -->(3e794)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>jsdom</strong>:
<ul>
<li>Support Blob on jsdom 30.1  -  by <a
href="https://github.com/sheremet-va"><code>@​sheremet-va</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11379">vitest-dev/vitest#11379</a>
<a href="https://github.com/vitest-dev/vitest/commit/6c49b7197"><!-- raw
HTML omitted -->(6c49b)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>pool</strong>:
<ul>
<li>Preserve unique pool ids when <code>groupOrder</code> is set  -  by
<a href="https://github.com/mtorp"><code>@​mtorp</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11392">vitest-dev/vitest#11392</a>
<a href="https://github.com/vitest-dev/vitest/commit/50312ebb4"><!-- raw
HTML omitted -->(50312)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>ui</strong>:
<ul>
<li>Split-pane handle overlapping iframe  -  by <a
href="https://github.com/macarie"><code>@​macarie</code></a> in <a
href="https://redirect.github.com/vitest-dev/vitest/issues/11221">vitest-dev/vitest#11221</a>
<a href="https://github.com/vitest-dev/vitest/commit/f91db0dfd"><!-- raw
HTML omitted -->(f91db)<!-- raw HTML omitted --></a></li>
</ul>
</li>
<li><strong>vitest</strong>:
<ul>
<li>Remove root temp dir on close  -  by <a
href="https://github.com/abhinav-phi"><code>@​abhinav-phi</code></a> in
<a
href="https://redirect.github.com/vitest-dev/vitest/issues/11248">vitest-dev/vitest#11248</a>
<a href="https://github.com/vitest-dev/vitest/commit/7c7119cf7"><!-- raw
HTML omitted -->(7c711)<!-- raw HTML omitted --></a></li>
</ul>
</li>...

_Description has been truncated_

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-10-15 21:46:59 -05:00
JD Davisandgithub-actions[bot] 76133cff59 chore: release 0.41.0 (#4002)
🤖 I have created a release *beep* *boop*
---


##
[0.41.0](https://github.com/headroomlabs-ai/headroom/compare/v0.40.0...v0.41.0)
(2026-10-13)


### Features

* **antigravity:** add native Google Antigravity IDE integration
([#3817](https://github.com/headroomlabs-ai/headroom/issues/3817))
([cd4367b](https://github.com/headroomlabs-ai/headroom/commit/cd4367b040bf80b7358f100da54994f6d5fbfcfe))
* **opencode:** support the OpenCode 2.x plugin API
([#3999](https://github.com/headroomlabs-ai/headroom/issues/3999))
([1d4b357](https://github.com/headroomlabs-ai/headroom/commit/1d4b357ca745549382e1ed9a3a6d39b5df52d3d5))
* **plugins:** add headroom-snip Claude Code mod that animates
compression
([#3980](https://github.com/headroomlabs-ai/headroom/issues/3980))
([17abee2](https://github.com/headroomlabs-ai/headroom/commit/17abee2721c1946bc8903d623bec91ff6e531c17))
* **proxy:** native spend/savings stats + dashboard for the Rust proxy
([#2321](https://github.com/headroomlabs-ai/headroom/issues/2321))
([70b21c1](https://github.com/headroomlabs-ai/headroom/commit/70b21c12c41cd128c7b8700c33b29b687de567a4))
* **router:** add max_output_tokens condition to ModelRoute
([#3898](https://github.com/headroomlabs-ai/headroom/issues/3898))
([01185e3](https://github.com/headroomlabs-ai/headroom/commit/01185e32d393c02ae63b104429f6dbfc6cdd1da0))
* **savings:** per-agent attribution in history checkpoints and rollups
([#2627](https://github.com/headroomlabs-ai/headroom/issues/2627))
([489de46](https://github.com/headroomlabs-ai/headroom/commit/489de468258584c69c90c798397d81e0b35ace67))
* show the Headroom for Teams offer in the dashboard, docs, llms.txt and
release notes
([#3991](https://github.com/headroomlabs-ai/headroom/issues/3991))
([1ad92f0](https://github.com/headroomlabs-ai/headroom/commit/1ad92f0cbc3dea27676e253588100f64a2af6994))


### Bug Fixes

* **anthropic:** route /api/hello connectivity probes to Anthropic
([#3336](https://github.com/headroomlabs-ai/headroom/issues/3336))
([#4059](https://github.com/headroomlabs-ai/headroom/issues/4059))
([931e5b9](https://github.com/headroomlabs-ai/headroom/commit/931e5b9666f4022feb38abadfbdb77c96c69e95a))
* **beacon:** stop Cloudflare logging senders' IP addresses
([#4018](https://github.com/headroomlabs-ai/headroom/issues/4018))
([db983ba](https://github.com/headroomlabs-ai/headroom/commit/db983bacc616fec3d622e8a039b47135b1ad4166))
* **cache:** keep cache mode when Claude Code re-serializes its last
reply ([#4003](https://github.com/headroomlabs-ai/headroom/issues/4003))
([aeb09f8](https://github.com/headroomlabs-ai/headroom/commit/aeb09f8d1884318d27b05b440b44c603e1c0d727))
* **cache:** retain prefix trackers for the provider cache lifetime
([#4023](https://github.com/headroomlabs-ai/headroom/issues/4023))
([9553d42](https://github.com/headroomlabs-ai/headroom/commit/9553d4292f949224105bfee8c29f4979a2c3092a))
* **cache:** stop Claude Code forks from cold-starting the
conversation's lineage
([#4043](https://github.com/headroomlabs-ai/headroom/issues/4043))
([1cf4d05](https://github.com/headroomlabs-ai/headroom/commit/1cf4d053d2bae276280dd3b71ebcf00cfd4d9cfc))
* **ccr:** serve headroom_retrieve when the model calls it alongside
client tools
([#4034](https://github.com/headroomlabs-ai/headroom/issues/4034))
([01d9194](https://github.com/headroomlabs-ai/headroom/commit/01d9194854233ef6ed04005cf0a5b8c32bf65d6d))
* **cli:** name the broken Codex config, write init configs atomically,
keep the identity check
([#4129](https://github.com/headroomlabs-ai/headroom/issues/4129))
([976aa71](https://github.com/headroomlabs-ai/headroom/commit/976aa714ef3e19174dc0cb586cee7b20d064e4ef))
* **cli:** pass configured SSL context to stdlib urlopen calls
([#4011](https://github.com/headroomlabs-ai/headroom/issues/4011))
([22d0905](https://github.com/headroomlabs-ai/headroom/commit/22d0905a73d1498e1a3658427687416373c1d4a1))
* **cli:** say why the proxy failed to start
([#4120](https://github.com/headroomlabs-ai/headroom/issues/4120))
([f3d240b](https://github.com/headroomlabs-ai/headroom/commit/f3d240bcae5f12d87925b5fa46d36eecff19ba2d))
* **codex:** make unwrap codex remove headroom init routing
([#3920](https://github.com/headroomlabs-ai/headroom/issues/3920))
([3260795](https://github.com/headroomlabs-ai/headroom/commit/326079517b40d2bbec6d2c7a453b22be9b8b6755))
* **codex:** preserve auth.json API keys through Headroom
([#3355](https://github.com/headroomlabs-ai/headroom/issues/3355))
([a6523b1](https://github.com/headroomlabs-ai/headroom/commit/a6523b19678af49ed1039fe946ae0cfee2181509))
* **copilot:** honour GitHub's advertised Business/Enterprise host by
default
([#4155](https://github.com/headroomlabs-ai/headroom/issues/4155))
([1dc7a18](https://github.com/headroomlabs-ai/headroom/commit/1dc7a183f55db35188aefa95f9cd4aed18377862))
* **copilot:** send VS Code next-edit requests to the completions host
([#4188](https://github.com/headroomlabs-ai/headroom/issues/4188))
([22a1296](https://github.com/headroomlabs-ai/headroom/commit/22a1296cfabc855f9bc6e36a1bcb0f9e788f75a5))
* **dashboard:** keep savings profile visible in light mode
([#2544](https://github.com/headroomlabs-ai/headroom/issues/2544))
([4e4f49d](https://github.com/headroomlabs-ai/headroom/commit/4e4f49d058846c44ae6061edd5a53776c03a0507))
* **dashboard:** show the effective value in settings enum selects
([#4032](https://github.com/headroomlabs-ai/headroom/issues/4032))
([20ce054](https://github.com/headroomlabs-ai/headroom/commit/20ce054f8d34af50106daa0c8aa518231e17004b))
* **deps:** bump quinn-proto to 0.11.19 for RUSTSEC-2026-0338..0342
([#4178](https://github.com/headroomlabs-ai/headroom/issues/4178))
([49751ec](https://github.com/headroomlabs-ai/headroom/commit/49751ec4c797c9ff8ae7e3cdfed6c8372c7fbfcd))
* **deps:** clear the two high npm advisories failing the Security
workflow
([#4004](https://github.com/headroomlabs-ai/headroom/issues/4004))
([5a516b5](https://github.com/headroomlabs-ai/headroom/commit/5a516b54afd50156521638645a9063992e395a7b))
* **deps:** recommend headroom-ai for optional extras
([#4046](https://github.com/headroomlabs-ai/headroom/issues/4046))
([f1bc260](https://github.com/headroomlabs-ai/headroom/commit/f1bc260948c159549d6937e9c4d2cf969256f2bb))
* **deps:** support Intel macOS ONNX Runtime resolution
([#3823](https://github.com/headroomlabs-ai/headroom/issues/3823))
([51ec6e8](https://github.com/headroomlabs-ai/headroom/commit/51ec6e8ffef8d3c76b0dc7b283c8c5eabcd6acc2))
* **docker:** adds mount for the litellm config dir
([#2454](https://github.com/headroomlabs-ai/headroom/issues/2454))
([64a661d](https://github.com/headroomlabs-ai/headroom/commit/64a661d5b4898d97061bfcaa10caad477b319b37))
* **gateway:** report why /v1/compress/response rejected a body
([#4081](https://github.com/headroomlabs-ai/headroom/issues/4081))
([5cac7ab](https://github.com/headroomlabs-ai/headroom/commit/5cac7ab693c2f1e3d8dbbe4756f0e7f6fa0687d6))
* **grok:** attribute api.x.ai chat outcomes as provider xai, recognize
grok-shell UA
([#2626](https://github.com/headroomlabs-ai/headroom/issues/2626))
([b1fb162](https://github.com/headroomlabs-ai/headroom/commit/b1fb162b622327102832f15b2ca14a4613da9fcd))
* **install/windows:** back persistent-service with an always-on task
([#1866](https://github.com/headroomlabs-ai/headroom/issues/1866))
([#2460](https://github.com/headroomlabs-ai/headroom/issues/2460))
([5682883](https://github.com/headroomlabs-ai/headroom/commit/5682883bb03472caeb510d6ff84070d5558d0f62))
* **install:** distinguish protocol targets in status
([#4040](https://github.com/headroomlabs-ai/headroom/issues/4040))
([79f2c27](https://github.com/headroomlabs-ai/headroom/commit/79f2c2781a1e6d5a13c75ae233e01c6d8d910ef1))
* **install:** keep an explicitly empty dashboard allowlist on Windows
PowerShell 5.1
([#4012](https://github.com/headroomlabs-ai/headroom/issues/4012))
([c195a12](https://github.com/headroomlabs-ai/headroom/commit/c195a1220f8d3525879c87486bd63d96e870e648))
* **install:** preserve OpenCode edits during reactivation
([#4022](https://github.com/headroomlabs-ai/headroom/issues/4022))
([40955b0](https://github.com/headroomlabs-ai/headroom/commit/40955b0eef2e509aad1a200db9cfa0762ca457ce))
* **learn:** decode sanitized pattern-id markers and keep visible-text
dedup keys
([#3956](https://github.com/headroomlabs-ai/headroom/issues/3956))
([ec1ba70](https://github.com/headroomlabs-ai/headroom/commit/ec1ba70c974fb0729870bfd444cdc1152a1b4301))
* **learn:** make live traffic learning use the shared error classifier
([#4110](https://github.com/headroomlabs-ai/headroom/issues/4110))
([e6eaa41](https://github.com/headroomlabs-ai/headroom/commit/e6eaa411791750884a7eb2594d0b86f9e4100f81))
* **learn:** pin the learned verbosity level on a cache-mode proxy
([#4033](https://github.com/headroomlabs-ai/headroom/issues/4033))
([71663b4](https://github.com/headroomlabs-ai/headroom/commit/71663b44e26fc2e0ad7d52c0b264aa7500926900))
* **logging:** add payload-safe helpers for exceptions, URLs, ids and
repeat warnings
([#4138](https://github.com/headroomlabs-ai/headroom/issues/4138))
([bebe559](https://github.com/headroomlabs-ai/headroom/commit/bebe5593ea4abaf326215c7236586b38e7b325a5))
* **onnx:** stop magika's ORT intra-op pool from spinning idle cores
([#4189](https://github.com/headroomlabs-ai/headroom/issues/4189))
([2016dc6](https://github.com/headroomlabs-ai/headroom/commit/2016dc6d6064926790b9c843fbf1798d2e660524))
* **openclaw:** preserve tool-call thought signatures
([#4038](https://github.com/headroomlabs-ai/headroom/issues/4038))
([37f3f9e](https://github.com/headroomlabs-ai/headroom/commit/37f3f9efe16f6b1ff94e03dbae85a27e387097a2))
* **plugins/openclaw:** keep compression system-prompt notice
cache-stable
([#3811](https://github.com/headroomlabs-ai/headroom/issues/3811))
([f885187](https://github.com/headroomlabs-ai/headroom/commit/f8851878a4feb0b64df8a5b22a89ebb198199bdf))
* **pricing:** reconcile cache billing with model-specific LiteLLM rates
([#3033](https://github.com/headroomlabs-ai/headroom/issues/3033))
([463c1a4](https://github.com/headroomlabs-ai/headroom/commit/463c1a43e30fc33cb256a3f455daf28043e53b05))
* **providers:** drop the shadowed POST /v1/messages route spec
([#4075](https://github.com/headroomlabs-ai/headroom/issues/4075))
([69a16cb](https://github.com/headroomlabs-ai/headroom/commit/69a16cb59c0fe4b8233caf5824e34e5772f48d81))
* **proxy/bedrock:** record the real upstream status on InvokeModel
outcomes
([#4025](https://github.com/headroomlabs-ai/headroom/issues/4025))
([159daa2](https://github.com/headroomlabs-ai/headroom/commit/159daa25a0886fb5c5808e37d62fe8cf4971290a))
* **proxy/streaming:** tolerate malformed upstream SSE events
([#2558](https://github.com/headroomlabs-ai/headroom/issues/2558))
([d091fbd](https://github.com/headroomlabs-ai/headroom/commit/d091fbd9f2ccc522de87350c0bc7a85f0de230eb))
* **proxy:** astgrep disk verify truncation
([#3192](https://github.com/headroomlabs-ai/headroom/issues/3192))
([1fb4cba](https://github.com/headroomlabs-ai/headroom/commit/1fb4cbaea0dcc62aa092bac3af04991d994207d0))
* **proxy:** break the compact-every-turn loop near the real context
window
([#2942](https://github.com/headroomlabs-ai/headroom/issues/2942))
([76cceeb](https://github.com/headroomlabs-ai/headroom/commit/76cceeb48728a4f179626e43f1ec23d1f7cebd79))
* **proxy:** classify failed streams as failed requests
([#3747](https://github.com/headroomlabs-ai/headroom/issues/3747))
([42d4f58](https://github.com/headroomlabs-ai/headroom/commit/42d4f58b434bdca8f81cabf5f00d6e8e02a7fb2c))
* **proxy:** don't retry a 429/529 that cannot succeed within the
backoff cap
([#3992](https://github.com/headroomlabs-ai/headroom/issues/3992))
([a961a6f](https://github.com/headroomlabs-ai/headroom/commit/a961a6fea083a9a739df40d1371e1e7ec108516d))
* **proxy:** don't send a memory continuation with unanswered client
tool calls
([#4009](https://github.com/headroomlabs-ai/headroom/issues/4009))
([#4013](https://github.com/headroomlabs-ai/headroom/issues/4013))
([87e05b6](https://github.com/headroomlabs-ai/headroom/commit/87e05b68b8aa578f1439abfc8006b38cd09db14d))
* **proxy:** forward x-litellm-key-* headers on streaming path
([#2532](https://github.com/headroomlabs-ai/headroom/issues/2532))
([33ade5b](https://github.com/headroomlabs-ai/headroom/commit/33ade5b0e1019adf34d9fd888cc105d4bc23935e))
* **proxy:** ignore defer_loading when measuring a turn hook's tool
delta ([#4056](https://github.com/headroomlabs-ai/headroom/issues/4056))
([f8212a3](https://github.com/headroomlabs-ai/headroom/commit/f8212a39dcc5b03a75e98b60a8ecdef81a0f48ed))
* **proxy:** keep Claude Haiku 5.5 mid-conversation system messages in
place ([#4153](https://github.com/headroomlabs-ai/headroom/issues/4153))
([a9eb2a7](https://github.com/headroomlabs-ai/headroom/commit/a9eb2a7b6fe6b75042646284109846da46939649))
* **proxy:** keep leading Anthropic system payloads valid
([#3671](https://github.com/headroomlabs-ai/headroom/issues/3671))
([d9e29bb](https://github.com/headroomlabs-ai/headroom/commit/d9e29bb2600a746dea80caa7721f0fb98109589c))
* **proxy:** log the savings and metrics failures that currently vanish
([#4084](https://github.com/headroomlabs-ai/headroom/issues/4084))
([2800932](https://github.com/headroomlabs-ai/headroom/commit/2800932e1827400cf41be1cff6154f78f691ccce))
* **proxy:** read stream cache usage from message_delta; keep Fireworks
sessions on one replica
([#4174](https://github.com/headroomlabs-ai/headroom/issues/4174))
([30b22df](https://github.com/headroomlabs-ai/headroom/commit/30b22df7fda6163c576c8f720982bf1ca48762c3))
* **proxy:** record the provider's billed input count on streamed turns
([#4052](https://github.com/headroomlabs-ai/headroom/issues/4052))
([a9815bb](https://github.com/headroomlabs-ai/headroom/commit/a9815bbb5fa2d2347ceeeac0f01cc9f041e2ded2))
* **proxy:** say why proxy.log is missing and why a knob or extension
was ignored
([#4088](https://github.com/headroomlabs-ai/headroom/issues/4088))
([72302a3](https://github.com/headroomlabs-ai/headroom/commit/72302a3998104a400765fa7e21177ed59f429f38))
* **release:** synchronize editable uv lock version
([#4054](https://github.com/headroomlabs-ai/headroom/issues/4054))
([3f99066](https://github.com/headroomlabs-ai/headroom/commit/3f990663cca5b9dd2ed0ca26343b0619bbab0aa7))
* **router:** bound ML compression per request, not just per block
([#3721](https://github.com/headroomlabs-ai/headroom/issues/3721))
([f37980f](https://github.com/headroomlabs-ai/headroom/commit/f37980f7f7612e7ae58b4f3b5b98f185e216fd91))
* **router:** preserve nested JSON records through compression
([#3680](https://github.com/headroomlabs-ai/headroom/issues/3680))
([fd06703](https://github.com/headroomlabs-ai/headroom/commit/fd067033da185f1abf48ea58e63c6d71d4d11ec1))
* **savings,ccr:** log the ledger and MCP failures that are swallowed
silently
([#4105](https://github.com/headroomlabs-ai/headroom/issues/4105))
([97680e7](https://github.com/headroomlabs-ai/headroom/commit/97680e7782423308b8e35c5560fea5b1d9434e1b))
* **savings:** don't let a thin holdout arm decide the headline number
([#3127](https://github.com/headroomlabs-ai/headroom/issues/3127))
([2a12e03](https://github.com/headroomlabs-ai/headroom/commit/2a12e035a3239bdfbb4fe75e1246923c144aabef))
* **security:** resolve 23 open CodeQL alerts
([#4045](https://github.com/headroomlabs-ai/headroom/issues/4045))
([a88e2d5](https://github.com/headroomlabs-ai/headroom/commit/a88e2d51452f7a2fa1882639585d482e1f05d92f))
* **security:** resolve high-severity CodeQL alerts
([#4005](https://github.com/headroomlabs-ai/headroom/issues/4005))
([dea9092](https://github.com/headroomlabs-ai/headroom/commit/dea9092e19385f286b7f67a64f4d85de2708d756))
* **smart-crusher:** preserve wrapped retrieval results in apply
([#4149](https://github.com/headroomlabs-ai/headroom/issues/4149))
([9762a14](https://github.com/headroomlabs-ai/headroom/commit/9762a14a40bde4d3f58a027c086b6ac75fbd5ed2))
* **subscription:** log a failed OTEL window update instead of passing
silently
([#4131](https://github.com/headroomlabs-ai/headroom/issues/4131))
([7d9dd55](https://github.com/headroomlabs-ai/headroom/commit/7d9dd55e7c4bbd2a95b054de7e5722c4cf20ce50))
* **toin:** make diagnostic pattern identifiers addressable
([#4021](https://github.com/headroomlabs-ai/headroom/issues/4021))
([def6d41](https://github.com/headroomlabs-ai/headroom/commit/def6d41185d3091d4ef42ae379829087deeaf38f))
* **transforms:** log failed transforms with tracebacks
([#3981](https://github.com/headroomlabs-ai/headroom/issues/3981))
([a654558](https://github.com/headroomlabs-ai/headroom/commit/a65455804ce6c16670af6fe253bd9f8f6105bfe3))
* **wrap:** carry the shared proxy's extensions over to a dedicated
Copilot proxy
([#4154](https://github.com/headroomlabs-ai/headroom/issues/4154))
([feea130](https://github.com/headroomlabs-ai/headroom/commit/feea130f81953030bda222ffe88abb61fbb60ee8))
* **wrap:** let `wrap opencode` target a third-party OpenAI-compatible
upstream
([#3125](https://github.com/headroomlabs-ai/headroom/issues/3125))
([0d7d61d](https://github.com/headroomlabs-ai/headroom/commit/0d7d61d5ccaee25d399ae3209e8ce067e8673b30))
* **wrap:** reject saved bob gateway URLs the proxy would not route
([#3975](https://github.com/headroomlabs-ai/headroom/issues/3975))
([944eafc](https://github.com/headroomlabs-ai/headroom/commit/944eafc6d4bcebbe6624cff95681f5af8b257868))
* **wrap:** trim the wrap claude startup banner
([#3900](https://github.com/headroomlabs-ai/headroom/issues/3900))
([aba75cb](https://github.com/headroomlabs-ai/headroom/commit/aba75cbf6d2fe1e4c728e4af258907d9c28028d0))
* **wrap:** warn when reused proxy ignores compression settings
([#4019](https://github.com/headroomlabs-ai/headroom/issues/4019))
([278bbc8](https://github.com/headroomlabs-ai/headroom/commit/278bbc8771938eec18e89df942e1594b6ddf41d4))


### Performance Improvements

* **proxy:** avoid eager dependency imports
([#3546](https://github.com/headroomlabs-ai/headroom/issues/3546))
([59bd482](https://github.com/headroomlabs-ai/headroom/commit/59bd482fa1661293d86834e73fe90f0ee21130c5))


### Code Refactoring

* **backends:** reuse the LiteLLM tool converters in the any-llm backend
([#4076](https://github.com/headroomlabs-ai/headroom/issues/4076))
([03538f2](https://github.com/headroomlabs-ai/headroom/commit/03538f2f2f55cafc0cec4ddf1b22e3189e2a0a24))
* **cli:** one missing-binary error for every wrap command
([#4122](https://github.com/headroomlabs-ai/headroom/issues/4122))
([2c2357a](https://github.com/headroomlabs-ai/headroom/commit/2c2357ad342de69d4576f0e38efc58646f054913))
* **cli:** remove test-only and dead helpers from wrap, proxy and mcp
([#4118](https://github.com/headroomlabs-ai/headroom/issues/4118))
([73f59a3](https://github.com/headroomlabs-ai/headroom/commit/73f59a32ccda8fe9de385031ccd032d1007be650))
* **compression:** deprecate the test-only UniversalCompressor package
([#4095](https://github.com/headroomlabs-ai/headroom/issues/4095))
([fc8ff5a](https://github.com/headroomlabs-ai/headroom/commit/fc8ff5a7619271ffe306ffad50f2ee936d5d2158))
* **core:** remove unreferenced helpers, attributes and a shadowed
module
([#4091](https://github.com/headroomlabs-ai/headroom/issues/4091))
([08fce18](https://github.com/headroomlabs-ai/headroom/commit/08fce1831067005f048cb81f0033abc17a89e9fd))
* **graph:** drop the bespoke codebase-memory-mcp downloader nothing
calls ([#4102](https://github.com/headroomlabs-ai/headroom/issues/4102))
([30d23fb](https://github.com/headroomlabs-ai/headroom/commit/30d23fb799674a5d9a3c531baf09a307d62c2bf2))
* **mcp_registry:** share spec helpers and fold GrokRegistrar onto the
Codex TOML registrar
([#4121](https://github.com/headroomlabs-ai/headroom/issues/4121))
([6e14ee0](https://github.com/headroomlabs-ai/headroom/commit/6e14ee0bc2dde72378b841f708f73cdf79df6e2d))
* **memory,learn,cache:** remove unreferenced classes, methods and
constants
([#4112](https://github.com/headroomlabs-ai/headroom/issues/4112))
([abbf36f](https://github.com/headroomlabs-ai/headroom/commit/abbf36f052fca643a3cd5f7cadd21b5a7d4bf406))
* **memory:** deprecate the never-wired agent memory writers
([#4101](https://github.com/headroomlabs-ai/headroom/issues/4101))
([2e497cb](https://github.com/headroomlabs-ai/headroom/commit/2e497cbec3c26c1d2c83adcc94794164cbab3268))
* **memory:** deprecate the orphaned Mem0SystemAdapter
([#4114](https://github.com/headroomlabs-ai/headroom/issues/4114))
([7387b8c](https://github.com/headroomlabs-ai/headroom/commit/7387b8cc11ecdf4775faa6042e7cc15d114b4942))
* **memory:** drop the unused extraction prompts and tool schemas
([#4100](https://github.com/headroomlabs-ai/headroom/issues/4100))
([6d23895](https://github.com/headroomlabs-ai/headroom/commit/6d23895dc003e865c3c5d4690853551406e7cdc8))
* **memory:** remove the unused memory budget manager
([#4099](https://github.com/headroomlabs-ai/headroom/issues/4099))
([e7ac6ca](https://github.com/headroomlabs-ai/headroom/commit/e7ac6ca6f81834549a66fc0832b1ddb2470da245))
* **proxy:** delete the unused memory_tool_adapter module
([#4071](https://github.com/headroomlabs-ai/headroom/issues/4071))
([7e5d97f](https://github.com/headroomlabs-ai/headroom/commit/7e5d97fe29073af0751cc0abc7bdf6a6d3bd74a2))
* **proxy:** drop the test-only memory ranker and file-backed native
memory ops
([#4072](https://github.com/headroomlabs-ai/headroom/issues/4072))
([fc5ac70](https://github.com/headroomlabs-ai/headroom/commit/fc5ac70b4a1eac8f49d86ad386c76c67bab40372))
* **proxy:** parse HEADROOM_OUTPUT_HOLDOUT in one place
([#4082](https://github.com/headroomlabs-ai/headroom/issues/4082))
([1a4e419](https://github.com/headroomlabs-ai/headroom/commit/1a4e4194a0b26e4f09026c18ac6b8935c6a99c0c))
* **proxy:** remove dead aliases and wrappers from helpers,
body_forwarding, forwarded_headers
([#4080](https://github.com/headroomlabs-ai/headroom/issues/4080))
([63cc9af](https://github.com/headroomlabs-ai/headroom/commit/63cc9afa9d282aeae127e6af20d9a9efa2eebd7e))
* **proxy:** remove dead wiring and unused re-exports from server.py
([#4073](https://github.com/headroomlabs-ai/headroom/issues/4073))
([58387c1](https://github.com/headroomlabs-ai/headroom/commit/58387c1174e6f7f526c3677b72986079da554a8a))
* **proxy:** remove test-only and dead helpers from the handlers
([#4117](https://github.com/headroomlabs-ai/headroom/issues/4117))
([31d378b](https://github.com/headroomlabs-ai/headroom/commit/31d378b0e5337bf8c572ca272e8649762457dc5f))
* **proxy:** remove the unreachable debug branches from the Responses
payload compressor
([#4116](https://github.com/headroomlabs-ai/headroom/issues/4116))
([132cd58](https://github.com/headroomlabs-ai/headroom/commit/132cd583daeb968dd4121f0163677f5b1605f29c))
* **proxy:** remove the unreachable debug branches from the Responses
unit router
([#4115](https://github.com/headroomlabs-ai/headroom/issues/4115))
([25cc2d5](https://github.com/headroomlabs-ai/headroom/commit/25cc2d586316fee5cb67b7a25ef2927198a0ae6b))
* **proxy:** remove unreferenced and test-only helpers
([#4074](https://github.com/headroomlabs-ai/headroom/issues/4074))
([e5cbec5](https://github.com/headroomlabs-ai/headroom/commit/e5cbec5f1a860eb51e4e49507b8eb26742abba22))
* remove test-only compatibility helpers in rollout and agent_savings
([#4089](https://github.com/headroomlabs-ai/headroom/issues/4089))
([310c108](https://github.com/headroomlabs-ai/headroom/commit/310c108c24caef1839a538a28878b6709f8987f9))
* remove write-only and test-only code in subscription and install
([#4123](https://github.com/headroomlabs-ai/headroom/issues/4123))
([c191bee](https://github.com/headroomlabs-ai/headroom/commit/c191beef59cc9bde622cf7db251ac94eb2a20c70))
* **transforms:** deprecate the unused Python AnchorSelector port
([#4104](https://github.com/headroomlabs-ai/headroom/issues/4104))
([9b1971d](https://github.com/headroomlabs-ai/headroom/commit/9b1971dd82c941d683902014b203de4bf617cc61))
* **transforms:** deprecate unused compress_with_stats, extract_batch
and align_for_cache
([#4098](https://github.com/headroomlabs-ai/headroom/issues/4098))
([e4a1ec1](https://github.com/headroomlabs-ai/headroom/commit/e4a1ec19be787a312624fdca52e2184b9a4127b9))
* **transforms:** drop the Python mirror of the Rust log selector
([#4096](https://github.com/headroomlabs-ai/headroom/issues/4096))
([a20c76c](https://github.com/headroomlabs-ai/headroom/commit/a20c76c26b15557a1bf176c4ef84f46121550297))
* **transforms:** drop the Python mirror of the Rust search selector
([#4103](https://github.com/headroomlabs-ai/headroom/issues/4103))
([47f8710](https://github.com/headroomlabs-ai/headroom/commit/47f8710817ddc6612127662714b5fcecf83dc644))
* **transforms:** remove the unused summarize_dropped_items
([#4093](https://github.com/headroomlabs-ai/headroom/issues/4093))
([eaa7308](https://github.com/headroomlabs-ai/headroom/commit/eaa7308a52620ad803b13c7f66300d7196f63212))
* **transforms:** remove unused convenience wrappers and helpers
([#4097](https://github.com/headroomlabs-ai/headroom/issues/4097))
([5c72d82](https://github.com/headroomlabs-ai/headroom/commit/5c72d824f4d1ab0d46a960f8f61a14d000482591))

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

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-14 17:45:55 -05:00
17abee2721 feat(plugins): add headroom-snip Claude Code mod that animates compression (#3980)
## Description

Adds `headroom-snip`, a Claude Code plugin that shows what Headroom does
to each request while you work. Headroom's savings are mostly invisible
from inside Claude Code; this puts them right above the prompt.

- **Band above the prompt:** for each new request through the proxy, a
scissors animation cuts a bar the size of the original prompt down to
what was sent (`21k → 4.1k tok −81%`). It names the compressors that did
the cutting (JSON crush, code AST, Kompress text, log squash, cache
align, …) and the running total since the session started. When a
request goes through unchanged it says why (for example `kept: user
message, recent code`).
- **`/headroom`:** opens a pane with the per-request log since the
session started: bar, what was cut and what was kept, compression
latency, biggest snip, all-time total. `/headroom hide` and `/headroom
show` toggle the band.
- **Status line** running total, and toasts at savings milestones.
- If the proxy isn't reachable, the band says so and suggests `headroom
wrap claude`.

It reads the proxy's existing loopback `GET /stats?cached=1`
(`recent_requests`), polling once a second only while a turn runs and
for a few seconds after. Requests stamped before the session started are
not counted. Under `headroom wrap claude` (which sends
`X-Headroom-Project`), only requests the proxy tagged with this
session's project count, and the totals are labelled as that project's
traffic since the session started (the tag is the launch directory's
basename, so other sessions in the same project are included); otherwise
they are labelled proxy-wide. There is no per-session request identity
at the proxy, so nothing is labelled as a per-session total. No proxy
changes; nothing leaves the machine. Proxy URL: `HEADROOM_PROXY_URL`,
else `ANTHROPIC_BASE_URL`, else `http://127.0.0.1:8787`. Each candidate
must be a loopback URL (http or https on exactly `localhost`,
`127.0.0.1` or `[::1]`, no userinfo); anything else is skipped, so the
plugin never polls a remote host.

## Spec

**API surface:** a Claude Code plugin (`headroom-snip` in
`.claude-plugin/marketplace.json`). The `/headroom` command, with `hide`
and `show`. Reads the `HEADROOM_PROXY_URL`, `ANTHROPIC_BASE_URL` and
`ANTHROPIC_CUSTOM_HEADERS` environment variables. No proxy, CLI or
library changes.

**Changes to existing behavior:** none. The `headroom` plugin and the
Copilot marketplace are untouched.

**User stories:**
- *Golden path.* Given Claude Code launched with `headroom wrap claude`
and the plugin installed, when a turn sends a request the proxy
compresses, then within about a second the band animates that request's
original → sent tokens and names the compressors, and `/headroom` lists
it newest first.
- *Edge case: proxy not running.* Given the plugin is installed but
nothing answers at the proxy URL, when a turn runs, then the band says
Headroom isn't in the loop and suggests `headroom wrap claude`, and
nothing else changes.
- *Edge case: shared proxy.* Given two clients on one proxy, when the
other client sends a request, then a wrapped session leaves it out
(different project tag), and an unwrapped session counts it but labels
its totals "proxy".
- *Edge case: two sessions in one project.* Given two wrapped Claude
Code sessions launched from directories with the same name, when either
sends a request, then both sessions count it, and the band says
"project" and the pane and toasts name the project, never "session".

**Failure modes:** proxy down or slow (the band shows the not-running
message, and requests are recovered when it comes up); a malformed
`/stats` body (ignored); a non-loopback proxy URL (skipped, falls back
to the default); a request without a timestamp (counted only if it
appears after the first successful poll).

**Recovery / resilience:** no state outside Claude Code; running totals
live in plugin state and survive a plugin reload. Disable with `claude
plugin disable headroom-snip@headroom-marketplace`.

**Security considerations:** see Additional Notes.

## Type of Change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which 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

- `plugins/headroom-snip/`: the plugin (`hooks/register.tsx` for hooks
and drawing, `hooks/snip.ts` for parsing, the loopback URL policy,
transform labels and animation frames), its state types, tests and
README.
- `.claude-plugin/marketplace.json`: lists `headroom-snip`, installable
with `claude plugin install headroom-snip@headroom-marketplace`. It is
**not** added to `.github/plugin/marketplace.json`, because Copilot CLI
can't load Claude Code function hooks.
- `tests/test_plugin_manifests.py`: the two marketplaces must still
match apart from Claude-Code-only plugins. A new test checks each such
plugin's manifest name, version and `hooks/hooks.json`.
- `scripts/version-sync.py`, `scripts/verify-versions.py`: the new
`plugin.json` version is synced and verified with the rest (0.39.1).
- `scripts/tests/test_version_sync.py`: fixture and assertion for the
new manifest.

## Testing

- [x] Unit tests pass (`pytest`): the manifest and version-sync tests
touched here
- [x] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`): N/A, no changes under
`headroom/`
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
$ pytest -q tests/test_plugin_manifests.py scripts/tests/test_version_sync.py
16 passed, 1 warning in 0.60s

$ ruff check tests/test_plugin_manifests.py scripts/
All checks passed!
$ ruff format --check tests/test_plugin_manifests.py scripts/
27 files already formatted

$ python scripts/verify-versions.py
All versions aligned at 0.39.1

$ claude plugin validate plugins/headroom-snip
✔ Validation passed

$ claude plugin test plugins/headroom-snip
(pass) proxy url follows the wrapped base url only when it is local
(pass) valid loopback urls keep their origin
(pass) hosts that only look local are never polled
(pass) userinfo, other schemes and junk are refused even on loopback
(pass) a remote override falls back to the local base url, not the remote host
(pass) transforms read as plain words
(pass) the finished bar keeps the sent share and dusts the rest
(pass) rows come back oldest first, with their project tags
(pass) the session project is read from the wrapped custom headers
(pass) a request is this session's by its stamp and project
(pass) every milestone a step crosses is announced, lowest first
(pass) a request made during a turn is snipped in the band
(pass) two new requests in one poll show the newest in the band and newest first in the pane
(pass) a proxy that comes up after the session started still counts the session's requests
(pass) with a project header, other clients on the proxy are left out
(pass) two sessions in one project share a count, and every label says project, not session
(pass) one big snip announces each milestone it crosses
(pass) polling picks up a request that lands just after the turn, then stops
 18 pass
 0 fail
```

The plugin tests are a bun-style suite run by `claude plugin test`. They
fake the proxy's `/stats` response (newest first, as the proxy sends it)
and check what the band and the `/headroom` pane draw: original → sent
figures, percentages, compressor labels, totals and their project/proxy
label (including two sessions sharing one project tag), newest-first
ordering when one poll brings several requests, a proxy that comes up
mid-session, filtering by project tag, a toast for each milestone
crossed, polling that continues briefly after a turn and then stops, the
hide button and the no-proxy message. Each of the four review fixes was
checked by restoring the old behaviour: its tests fail. The plugin also
type-checks clean under `tsc` against Claude Code's plugin API types
(strict, `noUncheckedIndexedAccess`).

## Real Behavior Proof

- Environment: macOS, iTerm2, Claude Code 2.1.289, local Headroom proxy
- Exact command / steps: `headroom wrap claude --plugin-dir
plugins/headroom-snip`, then ran prompts that read large tool output
(`ls -la /usr/lib`, `cat package-lock.json`), then ran `/headroom`
- Observed result: the band animated the snip for each compressed
request with original → sent tokens and compressor labels; `/headroom`
listed the requests since the session started
- Not tested: Claude desktop app and VS Code surfaces against a live
proxy (covered only by the `desktop` surface in the plugin tests);
terminals other than iTerm2

## Runtime Rollout Safety

- Rollout-managed feature(s): none. This is an opt-in Claude Code
plugin; nothing in the proxy or `headroom` package changes.
- Minimum rollout channel: N/A. It reaches only users who run `claude
plugin install headroom-snip@headroom-marketplace`.
- Stable/default behavior changed: no. Existing installs, the `headroom`
plugin and the Copilot marketplace are unchanged.
- Kill switch / disable path: `claude plugin disable
headroom-snip@headroom-marketplace` (or `uninstall`); `/headroom hide`
hides the band.
- Unsafe override required: no.
- Qualification impact: none on proxy compression or latency. The plugin
makes one cached loopback `GET /stats?cached=1` per second while a turn
runs.
- Rollback path: revert this PR, which removes the plugin and its
marketplace entry; installed copies can be uninstalled as above.

## Review Readiness

- [x] I performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
- [ ] I have updated the CHANGELOG.md if applicable: N/A, release-please
generates it from the PR title

## Additional Notes

- **Security considerations:** read-only. The plugin only sends `GET`
requests to the proxy's existing loopback `/stats` endpoint, which
already returns per-request metadata only to loopback callers. Proxy
URLs are parsed and must name exactly `localhost`, `127.0.0.1` or
`[::1]` over http(s) with no userinfo; look-alike hosts
(`localhost.example.com`, `127.0.0.1.example.com`,
`localhost@example.com`) and remote overrides are refused, with
regression tests. It sends no data elsewhere and changes nothing in the
proxy.
- Follow-up idea, not in this PR: a pixel-art mascot, and showing when
Claude retrieves stashed originals (CCR, `/v1/retrieve/stats`) as
visible proof that nothing cut is lost.

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-08 14:22:21 -05:00
1fb4cbaea0 fix(proxy): astgrep disk verify truncation (#3192)
## Description

`_detect_truncation()` currently relies on client-specific truncation
banners in `tool_result` text. This works for clients that emit a
recognizable line-count banner, but not for clients such as Cursor
(byte-based, direction-reversed truncation) and OpenCode (placeholder +
external file pointer).

Because `headroom proxy` runs alongside the client it wraps, it can
optionally verify the returned content against the actual file on disk.
If the `tool_result` is a strict prefix of the file, we can identify
truncation without depending on client-specific output formatting.

This adds disk verification as an opt-in fallback: the existing
banner-based detection always runs first, and disk verification is only
attempted when no banner is found. All disk-verification failures or
ambiguous cases return `UNKNOWN` rather than guessing.

Following review, the verifier is also constrained to a trusted,
confined workspace root rather than trusting caller-supplied input
directly — see the last four bullets under Changes Made.

**Current scope:** the session-token workspace binding this fallback
requires is wired for `headroom wrap claude` and plugin-loaded `headroom
wrap opencode` only. Cursor remains unsupported/not tested — it has no
header-injection surface today to transmit an authoritative session
token, so disk verification stays `UNKNOWN` for it; extending Cursor
support needs a separate, safe transport design.

Related to #2430
Closes #2421

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)
- [x] 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
- Added optional disk-based Read truncation verification behind
`HEADROOM_VERIFY_TRUNCATION_ON_DISK`.
- Disk verification compares the visible `tool_result` against the file
on disk and distinguishes `COMPLETE`, `TRUNCATED`, and `UNKNOWN`.
- Disk verification only runs when the existing `_detect_truncation()`
banner check finds no truncation marker, avoiding unnecessary file I/O
when the client already provides a signal.
- Added a `current_cwd` contextvar populated from `x-headroom-cwd` so
relative Read paths can be resolved against the client's working
directory.
- Registered `HEADROOM_VERIFY_TRUNCATION_ON_DISK` as a hot-reloadable
runtime setting.
- Gated verification on a new `is_current_request_trusted` contextvar,
set from `is_loopback_host(request.client.host)` — a server-observed
fact, not the caller-supplied header — so `x-headroom-cwd` is never
sufficient authority on its own.
- Confined all path resolution strictly under the canonicalized `cwd`
(`.resolve()` + `relative_to()`), rejecting `..` traversal,
absolute-path escapes, and post-resolution symlink escapes.
- Required the resolved target to be a regular file and under a byte cap
(new `HEADROOM_VERIFY_TRUNCATION_MAX_BYTES` knob, default 5MB), both
checked via `fstat` on the open fd before any read.
- Opened with `O_NONBLOCK` so a non-regular/special file can't park the
read indefinitely; disk I/O already runs off the event loop via the
existing compression thread pool.
- Added unit and integration tests covering successful verification,
missing/unreadable paths, relative paths, content races, feature gating,
banner precedence, and the adversarial cases below.

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .`)
- [x] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
$ pytest tests/test_tool_result_interceptors.py -v
51 passed in 2.21s
(includes TestVerifyReadAgainstDisk::* [14 cases, incl. absolute-path escape, `..`
traversal, symlink escape, sibling-prefix boundary, non-regular file, oversized
file, and untrusted-request-touches-no-disk], plus the end-to-end disk-verification
and banner-precedence cases)

$ pytest tests/test_proxy_loopback_gating.py -k trusted
16 passed
(includes test_record_headroom_stack_binds_trusted_true_for_loopback_client and
..._false_for_non_loopback_client — proves a spoofed x-headroom-cwd from a
non-loopback peer does not bind trust)

$ ruff check headroom/proxy/interceptors/astgrep.py headroom/proxy/project_context.py \
    headroom/proxy/server.py headroom/proxy/runtime_env.py \
    tests/test_tool_result_interceptors.py tests/test_proxy_loopback_gating.py
All checks passed!

$ mypy headroom/proxy/interceptors/astgrep.py headroom/proxy/project_context.py \
    headroom/proxy/server.py headroom/proxy/runtime_env.py
Success: no issues found in 4 source files
```

## Real Behavior Proof

- Environment: Mac OS local dev machine, no live proxy/network involved.
Exercised the real interceptor pipeline (`apply_to_messages`) directly
against an actual file on disk, using the same fixture and cwd-binding
path a live proxy request would use.
- Exact command / steps: wrote a 9-function Python fixture to a temp
file, built a client-truncated `tool_result` (first 8 functions, cut
mid-file, **no truncation banner text anywhere**), bound
`x-headroom-cwd` to the temp directory via `set_current_cwd()`, then
called `apply_to_messages()` once with
`HEADROOM_VERIFY_TRUNCATION_ON_DISK` unset and once with it set to `1`.
- Observed result: With disk verification disabled, the existing
ast-grep interceptor produced its normal header without indicating that
the input was truncated. With HEADROOM_VERIFY_TRUNCATION_ON_DISK=1, disk
verification detected that the 50-line tool_result was a strict prefix
of the 59-line file and produced:
 ```text
=== HEADROOM_VERIFY_TRUNCATION_ON_DISK unset (default) ===
[headroom: outlined by ast-grep — 8 definition(s); bodies elided.
Re-read the file with a line range to see a specific body.]

=== HEADROOM_VERIFY_TRUNCATION_ON_DISK=1, x-headroom-cwd bound to the
real directory ===
[headroom: outlined by ast-grep — 8 definition(s) in the visible
portion; input was truncated upstream (showing through line 50 of 59
total). Bodies elided. Re-read remaining lines to see more.]
```

**Trust-gate behavior:** same fixture and disk layout, `HEADROOM_VERIFY_TRUNCATION_ON_DISK=1`, but the request context's trust flag left at its default (`False`, simulating a non-loopback caller) instead of being marked trusted.

```text
=== trusted context (loopback) ===
[headroom: outlined by ast-grep — 8 definition(s) in the visible
portion; input was truncated upstream ...]

=== untrusted context (non-loopback) — same file, same cwd header, same
tool_result ===
[headroom: outlined by ast-grep — 8 definition(s); bodies elided.
Re-read the file with a line range to see a specific body.]
(no disk read attempted — verified via a call-recording wrapper around
os.open asserting zero invocations)
```
Also verified at the HTTP-middleware level with `TestClient(..., client=("100.90.0.5", 12345))`: a request carrying a spoofed `x-headroom-cwd` header from a non-loopback client IP does not bind trust, regardless of header content.

- Not tested: a live `headroom proxy` session with a real coding-agent client; the WebSocket/Codex responses-WS path.

## Runtime Rollout Safety

- Rollout-managed feature(s): None. The feature is gated by `HEADROOM_VERIFY_TRUNCATION_ON_DISK`
- Minimum rollout channel: N/A. `--intercept-tool-results` must already be enabled for the ast-grep interceptor to run.
- Stable/default behavior changed: no
- Kill switch / disable path: Unset `HEADROOM_VERIFY_TRUNCATION_ON_DISK`; the setting is hot-reloadable and does not require a restart.
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert the commit, or unset the env var on a running proxy (takes effect immediately, no restart).

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

this branch is based on `fix/astgrep-truncation-marker` #2430 not main


<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/3192" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4" alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-08 10:52:09 -05:00
Mansurshakh Japarov 37f3f9efe1 fix(openclaw): preserve tool-call thought signatures (#4038)
## Description

Preserve provider metadata while canonicalizing assistant tool calls.
The existing normalization rebuilt a `toolCall` from four fields and
dropped `thoughtSignature`, including on unchanged assistant turns
restored after compressing a different tool result.

Closes #4036. The original dynamic-notice behavior in #3809 is already
addressed on main and is not claimed as a new fix here.

## Type of Change

- [x] Bug fix (non-breaking)
- [x] Documentation update

## Changes Made

- Retain the original tool-call block properties before applying the
existing canonical type/id/name/arguments normalization.
- Keep existing missing-metadata defaults and legacy `tool_use`
normalization; no new options, routes, or dependencies.
- Add a failing-before regression for a signed canonical tool call and
document metadata retention in the existing plugin README.

## Testing

- Plugin: `npm test` — **8 files, 121 tests passed**.
- Plugin: `npm run typecheck` and `npm run build` — passed.
- Regression before the production change: **1 failed, 4 passed**, with
`thoughtSignature` observed as `undefined`.
- Required pre-push `make ci-precheck` — **passed**: complete Rust
workspace formatting, strict Clippy, workspace tests; native extension
build/import verification; Python qualification suite **177 passed, 4
skipped**; Conventional Commit lint.
- Complete Ruff formatting check — **1768 files already formatted**.
- Whole-tree Ruff lint reported five unchanged executable OAuth2 Python
files lacking shebangs; no unrelated chmod or suppression was applied.
- Whole-tree `mypy headroom` checked 566 files and reported one
unchanged `truthy-function` error in
`headroom/integrations/langchain/chat_model.py:394`; no Python
implementation was changed by this PR.
- Complete Python suite — **15,630 passed, 612 skipped, 7 failed**. The
failures are outside the changed plugin: two CLI-import shape errors,
one WebSocket lifecycle timeout, and four Kompress readiness
expectations. These broad failures are not suppressed or claimed green.
- Published GitHub checks — **19 passed, 19 skipped**, with no failed or
pending check at the recorded readiness check.

## Real Behavior Proof

Environment: Linux x86_64, Bun 1.3.13, Node 22.23.1, Python 3.13.14,
repository-pinned Rust 1.95.0; base
`3c418f6f0b190ad1060413c0eadd77f20ab3cf46`.

Actual converter/restorer command: `bun -e` importing
`agentToOpenAIIndexed` and `restoreAgentMessages` from
`plugins/openclaw/src/convert.ts`. The input contains a user turn, a
Google-provider assistant turn with a signed canonical tool call, and a
separate tool result. Only the tool-result text is compressed in the
returned wire messages.

Before: the identical Google-provider fixture run against untouched main
fails its unchanged-assistant deep equality assertion because the tool
call loses `thoughtSignature`.

After:

```text
unchanged_user_byte_exact: true
unchanged_assistant_byte_exact: true
thinking_signature_preserved: true
compressed_tool_text: short tool result
tool_metadata_preserved: true
```

The unchanged-assistant equality includes the tool-call signature and
arguments. This is an actual converter round trip, not a mocked provider
or a forwarding-only test.

Not tested: full OpenClaw gateway installation, paid provider calls,
provider cache-hit rates/billing, macOS, Windows.

## Runtime Rollout Safety

No rollout-managed feature/channel or unsafe override is added. Default
plugin normalization now retains opaque provider tool-call metadata;
canonical defaults remain intact. Disable the OpenClaw plugin to avoid
its context assembly, or revert this three-file commit as rollback.
Existing Rust/Python qualification remains passing as recorded above.

## Review Readiness

- [x] Existing conversion consumers, normalization defaults, and scope
reviewed
- [x] This PR is ready for human review; all broad-check outcomes are
recorded, including unrelated Python limitations

## Checklist

- [x] Corresponding documentation updated
- [x] Regression proves the fix is effective
- [x] No new warnings observed in the changed plugin
- [x] No `CHANGELOG.md` edit (release-please owns it)

## Additional Notes

Fresh duplicate check covered all 195 open PRs. #4034 preserves
signatures in Python CCR handling and does not modify this OpenClaw
normalizer. AI-assisted: omp / GPT-6.1 Sol.
2026-10-08 10:19:33 -05:00
1d4b357ca7 feat(opencode): support the OpenCode 2.x plugin API (#3999)
## Description

Takeover of #3719 by @laurence-diack-pk, who has been unavailable since
Sep 23 and whose branch was left conflicted with `main`. The original
commit is preserved and @laurence-diack-pk remains its author; this
branch adds follow-up commits addressing @JerrettDavis's review and the
findings from live OpenCode 2.x testing.

It makes the OpenCode plugin and `headroom wrap opencode` work on both
OpenCode 1.x and 2.x. On 2.x the 1.x function plugin was silently
dropped (the loader requires a `{ id, setup }` default export loaded
from a directory), and Effect's `FetchHttpClient` keeps its own `fetch`
reference from before plugins load — so `wrap opencode` loaded no plugin
and routed nothing.

Closes #3669. Supersedes #3719.

## Type of Change

- [x] Bug fix (non-breaking change that fixes an issue)
- [x] New feature (non-breaking change that adds functionality)

## Changes Made

Carried from #3719:
- One plugin for both versions: default export `{ id: "headroom",
server, setup }`; 1.x calls `server`, 2.x calls `setup`.
- 2.x `setup`: registers `headroom_retrieve` via `ctx.tool.transform`
(`codemode: false`), sets `HEADROOM_*` shell env through the
`create.before` hook, and returns a cleanup that releases the refcounted
transport so hot reloads do not stack interceptors.
- 2.x model routing: `ctx.model.transform` points remote OpenAI-wire
models at the proxy with `x-headroom-base-url` /
`x-headroom-original-path` headers, since 2.x keeps its own `fetch`
reference and the transport patch alone misses model traffic.
- Wheel ships the bundle as `_dist/index.js`;
`headroom_opencode_plugin_path()` returns the directory; `wrap opencode`
adds `--standalone` on 2.x so the private server sees
`OPENCODE_CONFIG_CONTENT`.

Follow-up commits (review from #3719 + live testing):
- Rebased on current `main` (0.40.0). Fixed the routing-contract
conflict: replaced `routesThroughProxy` (TS2554 against `shouldRoute`'s
3-arg signature) with `modelBaseRoutesThroughProxy`, a deliberate
model-base eligibility check that keeps the shared protocol / loopback /
proxy-origin / excluded-host contract but drops the endpoint-suffix
requirement, since 2.x hands us model base URLs (e.g. `/v1`), not
inference endpoints.
- `setup` now resolves the effective `excludeHosts` once (option over
`HEADROOM_OPENCODE_EXCLUDE_HOSTS`) and applies it to both the transport
install and the model rewrite, with new tests for both paths.
- Fixed `test_build_launch_env_with_project` to decode
`OPENCODE_CONFIG_CONTENT` instead of substring-matching the raw path,
which JSON backslash escaping makes impossible on Windows.
- `opencode_major_version` now reads the `v2` channel marker in dev
builds (`opencode v0.0.0-v2-<stamp>`), which previously parsed as major
0, so `wrap` skips `--standalone` and the private server never loads
Headroom's config.
- Rebuilt `_dist/index.js` and `hook-shim/handler.js`; drift check
clean.

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .` — run on the changed paths)
- [x] Type checking passes (`mypy headroom` — run on the changed paths)
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
# plugins/opencode
$ npm ci && npm run typecheck && npm run build:standalone && npm test
tsc: clean (no TS2554)
vitest: Test Files 3 passed (3) | Tests 45 passed (45)
$ cmp dist-standalone/index.js ../../headroom/providers/opencode/_dist/index.js          # identical
$ cmp dist-standalone/hook-shim/handler.js ../../headroom/providers/opencode/hook-shim/handler.js  # identical

# focused Python suites (same set as #3719, plus the 2.x dev-build version case)
$ pytest tests/test_providers_opencode_plugin_path.py tests/test_providers_opencode_config.py \
    tests/test_providers_opencode_install.py tests/test_cli/test_wrap_opencode.py \
    tests/test_mcp_registry_opencode.py tests/test_learn/test_opencode_scanner.py -q
193 passed in 1.10s

$ ruff check / ruff format --check on changed paths: clean
$ mypy headroom/providers/opencode headroom/cli/wrap.py: Success: no issues found
```

## Real Behavior Proof

- Environment: macOS arm64, Node v26.10.0, Python 3.13, headroom from
this branch (0.41.0-dev). Tested against two real OpenCode 2.x clients,
each in throwaway XDG dirs with its own proxy port:
  - `opencode 2.0.19` (official 2.x binary);
- OpenCode 2.x head built from `anomalyco/opencode@v2`
(`0.0.0-v2-202610061051`, Bun 1.4.2, `bun run script/build.ts --single`
in `packages/cli`).
- Exact command / steps: throwaway XDG dirs and a dedicated proxy port;
fake key first (routing proof), then the real key (end-to-end proof):
  ```bash
  # fake key first (routing proof), then the real key (end-to-end proof)
OPENCODE_API_KEY=<key> headroom wrap opencode --port 8799 --no-serena --
\
run -m opencode-go/deepseek-v4.1-flash "reply with the single word ok"
  # exclusion check
HEADROOM_OPENCODE_EXCLUDE_HOSTS=opencode.ai OPENCODE_API_KEY=<key>
headroom wrap opencode ...
  ```
(`opencode-go` declares `OPENCODE_API_KEY` as its env credential in the
catalog, so no interactive login is needed.)
- Observed result: routed 401 with the fake key and 200 with the real
key through the proxy, `--standalone` added automatically, exclusion
honored — details:
- **Fake key** — proxy log: `proxy_inbound_request POST
/v1/chat/completions` with `user-agent: opencode/latest/2.0.19/cli` (and
`opencode/v2/0.0.0-v2-202610061051/cli` for the head), headers
`x-headroom-base-url: https://opencode.ai` and
`x-headroom-original-path: /zen/go/v1/chat/completions`; forwarded
upstream, `401` from the fake key — routed through Headroom.
- **Real key** — the model answered `ok`; proxy `status=200` with
upstream `https://opencode.ai/inference/go/openai/v1/chat/completions`.
- `wrap` added `--standalone` automatically on 2.0.19, and again on the
v2 head after the dev-build version fix (explicit `--standalone` also
works, per the kill-switch path).
- **Exclusion** — with `HEADROOM_OPENCODE_EXCLUDE_HOSTS=opencode.ai` the
model still answered while the proxy saw **zero** new chat requests: the
2.x model transform honors the exclusion list.
- Not tested: Windows; OpenAI "responses"-wire against a live 2.x
server; Anthropic-wire custom providers on 2.x; loading the plugin by
npm name (`headroom-opencode`), which needs a published release;
OpenCode 1.x older than 1.2.20.

## Runtime Rollout Safety

- Rollout-managed feature(s): none
- Minimum rollout channel: n/a
- Stable/default behavior changed: on OpenCode 2.x, `wrap opencode`
launches with `--standalone` (a private server per session); on 1.x
behaviour is unchanged apart from the plugin path now being a directory.
- Kill switch / disable path: pass `--server <url>` or `--standalone`
explicitly; `HEADROOM_OPENCODE_PLUGIN_PATH` still overrides the plugin
location.
- Unsafe override required: no
- Qualification impact: none
- Rollback path: revert this PR; the wheel bundle and plugin path revert
with it.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

@laurence-diack-pk — thank you for the original implementation; the
commit is preserved verbatim at the base of this branch. @JerrettDavis —
this addresses the routing-contract conflict you described in #3719 (the
missing `excludeHosts` argument and the model-base vs endpoint
mismatch), the Windows assertion, and a dev-build version-detection gap
found while validating on macOS. Live 2.x validation is done on both
2.0.19 and today's `v2` head; details above.

---------

Co-authored-by: laurence <laurence.diack@peekrobotics.co.nz>
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-07 20:52:53 -05:00
Tejas ChopraandClaude Opus 5.5 dea9092e19 fix(security): resolve high-severity CodeQL alerts (#4005)
## Description

Resolves the high-severity CodeQL alerts in product code. Three are real
leaks (an API key in the proxy log, a credential in an oauth2 warning,
XSS in the HTML report); the rest are hardening.

Closes #

## Type of Change

- [x] 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

- **#63, Gemini API key written to the proxy log.** Google forwarders
build `...?key=<api key>` URLs (`batch.py:442` and others) and
`log_outbound_request` logged the full URL at INFO. The log line now
drops the query string, fragment and userinfo, keeping scheme, host
(IPv6 literals stay bracketed) and path. A URL with an invalid port logs
`<unparseable>` rather than raising.
- **#104, credential in an oauth2 warning.** A static header written as
`Authorization: Bearer x=y` splits on the first `=`, so `Authorization:
Bearer x` lands in the key, is rejected as malformed, and was echoed by
the warning. The warning no longer prints the key.
- **#131, XSS in the HTML report.** `model` and other request fields are
client supplied. Jinja2 autoescape is now on; no report field relies on
raw HTML.
- **#127:** `SNOWFLAKE_HOST` must end with `.snowflakecomputing.com`
instead of merely containing it.
- **#19, #128, #129, #130:** the `/\/+$/` trailing-slash regex in the TS
SDK and opencode plugin backtracks quadratically on long runs of `/`.
Replaced with a loop. The committed wheel bundle
(`headroom/providers/opencode/_dist/entry.opencode.js`) is rebuilt to
match.

Not changed (false positives, to dismiss): **#105** (URL already reduced
to `scheme://host` by `_redact_url`) and **#109** (`token_fingerprint`
is a short SHA-256 fingerprint of a high-entropy token for comparison,
not password storage).

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

New tests: outbound log keeps no `key=` value or userinfo, keeps IPv6
brackets, and handles relative paths and invalid ports; the report
escapes `<script>`; the Snowflake host must end with the domain; both TS
trailing-slash helpers are tested on normal inputs and on a 100k-slash
input (the old regex took ~5.2 s on it; the test bound is 1 s).

### Test Output

```text
$ HEADROOM_REQUIRE_RUST_CORE=false pytest -q tests/test_proxy_byte_faithful_forwarding.py tests/test_reporting.py tests/test_provider_cortex_code.py
105 passed in 4.65s

$ HEADROOM_REQUIRE_RUST_CORE=false pytest -q plugins/headroom-oauth2/tests
70 passed

$ ruff check headroom/proxy/helpers.py tests/test_proxy_byte_faithful_forwarding.py && ruff format --check ...
All checks passed!
2 files already formatted

$ (cd plugins/opencode && npm run typecheck && npx vitest run)
Test Files  3 passed (3)
     Tests  38 passed (38)

$ (cd sdk/typescript && npx vitest run)
Test Files  19 passed | 5 skipped (24)
     Tests  351 passed | 33 skipped (384)

$ (cd plugins/opencode && npm run build:standalone) && cmp dist-standalone/entry.opencode.js ../../headroom/providers/opencode/_dist/entry.opencode.js
(no output: bundle matches source)
```

The two oauth2 tests that start the full proxy need the Rust core, which
was not built in the local worktree, so they ran with
`HEADROOM_REQUIRE_RUST_CORE=false`.

## Real Behavior Proof

- Environment: macOS 26 (Darwin 25.6), Python 3.12 venv, this branch at
`bb634a3b`, `HEADROOM_REQUIRE_RUST_CORE=false`. A local fake Gemini
upstream (Python `http.server`) listening on IPv6 `[::1]:9911`.
- Exact command / steps:
1. `python fake_gemini.py` (accepts POST, logs the request path, returns
`{"batch":{"name":"batches/fake"}}`)
  2. `headroom proxy --port 8799 --gemini-api-url 'http://[::1]:9911'`
3. `curl -X POST
'http://127.0.0.1:8799/v1beta/models/gemini-2.5-pro:batchGenerateContent'
-H 'x-goog-api-key: AIzaFAKE-RUNTIME-PROOF-123' -H 'content-type:
application/json' -d
'{"batch":{"displayName":"proof","inputConfig":{"requests":{"requests":[]}}}}'`
  4. `grep outbound_request proxy.log; grep -c AIzaFAKE proxy.log`
- Observed result: the client got `HTTP 200`. The upstream still
received the key
(`/v1beta/models/gemini-2.5-pro:batchGenerateContent?key=AIzaFAKE-RUNTIME-PROOF-123`),
so forwarding is unchanged. The proxy log line was
`event=outbound_request forwarder=google_batch_passthrough method=POST
path=http://[::1]:9911/v1beta/models/gemini-2.5-pro:batchGenerateContent
body_bytes=76 ...`, and the key appeared in the proxy log **0** times.
- Not tested: real Google, Snowflake or oauth2 provider endpoints; the
HTML report was exercised only through unit tests; the opencode plugin
was not loaded into a live opencode session; Windows.

## Runtime Rollout Safety

- Rollout-managed feature(s): None. No rollout-managed feature or flag
is touched.
- Minimum rollout channel: Stable. These are security fixes with no
opt-in behaviour.
- Stable/default behavior changed: Only diagnostics and validation: the
`outbound_request` log line no longer includes the query string,
fragment or userinfo; the oauth2 malformed-header warning no longer
prints the key; HTML report fields are escaped; a `SNOWFLAKE_HOST` that
merely contains `.snowflakecomputing.com` is now rejected. Request
forwarding is byte-for-byte unchanged.
- Kill switch / disable path: None needed; nothing new is enabled.
Reverting the PR restores the previous behaviour.
- Unsafe override required: No.
- Qualification impact: None. No compression, routing or
token-accounting path changes.
- Rollback path: Revert this PR.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

## Additional Notes

Possible overlap: #3999 also replaces the opencode trailing-slash regex.
Whichever lands second will need a small rebase.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 23:11:40 -05:00
f8851878a4 fix(plugins/openclaw): keep compression system-prompt notice cache-stable (#3811)
## Description

`HeadroomContextEngine.assemble()` in the OpenClaw plugin returns a
`systemPromptAddition` string that OpenClaw prepends to the system
prompt every turn. It interpolated the per-turn `tokensSaved` count, so
the system prompt — the start of the provider's cached prefix — changed
on every compressing turn, defeating prompt caching. Reported cost: a
turn saving 267 tokens caused a ~93K-token cache miss on Bedrock/Claude
Opus 5.5, roughly 4,000x the tokens the compression saved.

Refs #3809

## Type of Change

- [x] 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

- `plugins/openclaw/src/engine.ts`: replaced the interpolated
`${result.tokensSaved}` notice with a fixed constant
(`HEADROOM_COMPRESSION_NOTICE`), so any turn that includes it is
byte-identical to any other. Added a `hasAnnouncedCompression` instance
flag so the notice, once shown (tokensSaved > 100), stays present and
unchanged on later turns even when a given turn has nothing new to
compress
- `plugins/openclaw/src/engine.ts`: added `announceCompression`
(boolean, default `true`) to `HeadroomEngineConfig` to disable the
notice entirely.
- `plugins/openclaw/openclaw.plugin.json`: added `announceCompression`
to `configSchema.properties` (required — schema has
`additionalProperties: false`) and a matching `uiHints` entry.
- `plugins/openclaw/README.md`: documented the new option in the
configuration table.
- `plugins/openclaw/test/engine.test.ts`: 5 new tests, static notice
with no interpolated count, byte-identical notices across differing
`tokensSaved`, notice staying present on a turn with nothing to compress
(the flap-prevention regression case), `announceCompression: false`
opt-out, and the existing below-threshold no-op case.

## Testing

- [x] Unit tests pass (`pytest`)
- [x] Linting passes (`ruff check .`)
- [x] Type checking passes (`mypy headroom`)
- [x] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
$ npx vitest run test/engine.test.ts
 RUN  v4.1.10 /Users/sarah_ling/Documents/GitHub/headroom/plugins/openclaw

 Test Files  1 passed (1)
      Tests  27 passed (27)
   Start at  18:17:43
   Duration  527ms

$ npx vitest run
 Test Files  1 failed | 6 passed (7)
      Tests  3 failed | 104 passed (107)

# The 3 failures are in test/advancement-key-store.test.ts, unrelated to this change
```

## Real Behavior Proof

- Environment: local vitest run against `plugins/openclaw` (mocked
`compress()`/proxy — no live OpenClaw host or real Bedrock/Anthropic
request).
- Exact command / steps: added a temporary test that mocks a 6-turn
session mirroring the reported scenario (tokensSaved: 0, 267, 0, 9000,
0, 50) and recorded `assemble()`'s `systemPromptAddition` per turn.
- Observed result: notice absent on turn 1, appears static and identical
on turns 2–6 (including turns 3/5 with nothing to compress, and turn 6's
below-threshold 50-token save) — 1 total transition across 6 turns,
versus the old behavior's distinct string on every compressing turn.
- Not tested: no live OpenClaw + real provider run to directly observe
the Bedrock cache-read/cache-write fields improve, as the original
issue's report did. The fix is verified at the unit level (the exact
value the plugin hands to OpenClaw), not against a real provider cache.

## Runtime Rollout Safety

- Rollout-managed feature(s): None
- Minimum rollout channel: N/A
- Stable/default behavior changed: yes, the notice text changes (no
longer reports a live token count) and stays present for the rest of the
session instead of tracking that turn's compression state. Default
(`announceCompression` unset) still shows the notice, matching prior
default-on behavior.
- Kill switch / disable path: set `announceCompression: false` in the
plugin config to fully disable the notice.
- Unsafe override required: None
- Qualification impact: None
- Rollback path: Revert this PR

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

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

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/3811"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
Co-authored-by: JD Davis <mxjerrett@gmail.com>
2026-10-06 08:37:07 -05:00
JD Davisandgithub-actions[bot] 855390d611 chore: release 0.40.0 (#3833)
🤖 I have created a release *beep* *boop*
---


##
[0.40.0](https://github.com/headroomlabs-ai/headroom/compare/v0.39.1...v0.40.0)
(2026-10-06)


### ⚠ BREAKING CHANGES

* **proxy:** read HEADROOM_LICENSE and make usage reporting opt-in
([#3857](https://github.com/headroomlabs-ai/headroom/issues/3857))
* drop the crewai extra to remove chromadb from the lockfile
([#3870](https://github.com/headroomlabs-ai/headroom/issues/3870))

### Features

* **compress:** add per-message compression diagnostics
([#3058](https://github.com/headroomlabs-ai/headroom/issues/3058))
([fef99cc](https://github.com/headroomlabs-ai/headroom/commit/fef99cc5b444bb16ac33fe8ec70108f7c0271de1))
* **compress:** live-agent densify mode, lossless and cache-safe
([#1402](https://github.com/headroomlabs-ai/headroom/issues/1402))
([84f0e84](https://github.com/headroomlabs-ai/headroom/commit/84f0e84dccd3736b4a0c6c817bc83da307a5fbb8))
* **dashboard:** add CO₂ Saved card to dashboard and /stats API
([#1369](https://github.com/headroomlabs-ai/headroom/issues/1369))
([2bc9419](https://github.com/headroomlabs-ai/headroom/commit/2bc94194671548c5def53809f736340285e20e76))
* **dashboard:** give savings metrics one canonical home
([#3320](https://github.com/headroomlabs-ai/headroom/issues/3320))
([6af7efe](https://github.com/headroomlabs-ai/headroom/commit/6af7efe0d1fa9786d1fd5e5dc9884b7750c0f569))
* **learn:** add agy (Antigravity CLI) as an analysis backend
([#3939](https://github.com/headroomlabs-ai/headroom/issues/3939))
([4ba231a](https://github.com/headroomlabs-ai/headroom/commit/4ba231ab3d51c409804af24ea03692aed33deb2e))
* **live-zone:** wire the SourceCode and PlainText dispatch arms
([#3227](https://github.com/headroomlabs-ai/headroom/issues/3227))
([49f69be](https://github.com/headroomlabs-ai/headroom/commit/49f69be2836e90cbd210e39d82b36d514404cc76))
* **memory:** persist TrafficLearner pending evidence across restarts +
expose learner stats
([#3104](https://github.com/headroomlabs-ai/headroom/issues/3104))
([4257ed4](https://github.com/headroomlabs-ai/headroom/commit/4257ed4df377a93cd2e0d526ef61d2a32cbc54cf))
* **proxy:** add x-headroom-keep-last-turns header for per-request
context trimming (issue
[#2858](https://github.com/headroomlabs-ai/headroom/issues/2858))
([#3059](https://github.com/headroomlabs-ai/headroom/issues/3059))
([246162d](https://github.com/headroomlabs-ai/headroom/commit/246162d70bbc68cc1b7d44a015ddaf320cd23a3d))
* **proxy:** route Gemini plugin traffic through native transforms
([#2697](https://github.com/headroomlabs-ai/headroom/issues/2697))
([0ad996a](https://github.com/headroomlabs-ai/headroom/commit/0ad996a82eef65183271243fa71bb0f5653be369))
* **proxy:** serve on a Unix domain socket (--uds)
([#3151](https://github.com/headroomlabs-ai/headroom/issues/3151))
([e7b3baf](https://github.com/headroomlabs-ai/headroom/commit/e7b3baf236b832e1d4d086c4425b8d32560d0d7c))
* **wrap:** add headroom wrap bob for IBM Bob CLI
([#3801](https://github.com/headroomlabs-ai/headroom/issues/3801))
([0b7dab4](https://github.com/headroomlabs-ai/headroom/commit/0b7dab47c62a8372c7bf7031d744658d71745679))
* **wrap:** extend reduce-at-source quiet defaults to telemetry/nag
banners
([#2550](https://github.com/headroomlabs-ai/headroom/issues/2550))
([3a3a465](https://github.com/headroomlabs-ai/headroom/commit/3a3a465bb129ad74f6e04f7c50e0fe7489383ba2))


### Bug Fixes

* **anthropic:** preserve failed CCR continuations
([#3843](https://github.com/headroomlabs-ai/headroom/issues/3843))
([94bb055](https://github.com/headroomlabs-ai/headroom/commit/94bb055810dc1258bd248cd0a9d0e7c51df64844))
* **backends/anyllm:** map Anthropic tool_choice none to OpenAI none
([#3963](https://github.com/headroomlabs-ai/headroom/issues/3963))
([d722a64](https://github.com/headroomlabs-ai/headroom/commit/d722a6414c3896ef092a0d8764c64d9681e07410))
* **backends/litellm:** align streaming usage tokens with the
non-streaming path
([#2688](https://github.com/headroomlabs-ai/headroom/issues/2688))
([90a68e0](https://github.com/headroomlabs-ai/headroom/commit/90a68e02910126373f3d3769158925e3a55ce411))
* **backends/litellm:** keep the upstream 4xx status on send_message
errors
([#3944](https://github.com/headroomlabs-ai/headroom/issues/3944))
([e0e41cd](https://github.com/headroomlabs-ai/headroom/commit/e0e41cd2f57a80612ddbf1568e4ad245046a0131))
* **backends/litellm:** map Anthropic tool_choice none to OpenAI none
([#2689](https://github.com/headroomlabs-ai/headroom/issues/2689))
([57a5708](https://github.com/headroomlabs-ai/headroom/commit/57a57088de8920091ecaaac0e3cadf3932698154))
* **backends/litellm:** match the caller-key Bearer scheme
case-insensitively (RFC 7235)
([#3965](https://github.com/headroomlabs-ai/headroom/issues/3965))
([848d7a0](https://github.com/headroomlabs-ai/headroom/commit/848d7a04b489600d3c0de0ba4f7c47cdb8ed5cc2))
* **backends/litellm:** report requested model in OpenAI streaming
chunks
([#2690](https://github.com/headroomlabs-ai/headroom/issues/2690))
([8538a83](https://github.com/headroomlabs-ai/headroom/commit/8538a831531bb277a6083ed2a010312a849c3050))
* **cache:** keep prefix lineage across a replaced system tail
([#3934](https://github.com/headroomlabs-ai/headroom/issues/3934))
([16eaec1](https://github.com/headroomlabs-ai/headroom/commit/16eaec1e95cd39135ef06f6664b309c71b03e3ad))
* **ccr:** answer headroom_retrieve on the direct chat path instead of
forwarding it
([#3816](https://github.com/headroomlabs-ai/headroom/issues/3816))
([126e144](https://github.com/headroomlabs-ai/headroom/commit/126e144876d2bd01246b5066dd5d3379b7a0e2da))
* **ccr:** inject headroom_retrieve before the prefix is warm, not after
([#3810](https://github.com/headroomlabs-ai/headroom/issues/3810))
([bb8c285](https://github.com/headroomlabs-ai/headroom/commit/bb8c285714b19dadf4f96305ba5a74877a0dd103))
* **ccr:** only proactively expand compressions present in the
requesting conversation
([#3924](https://github.com/headroomlabs-ai/headroom/issues/3924))
([9b9a883](https://github.com/headroomlabs-ai/headroom/commit/9b9a883e96ec28e361a3d95e34ec29ecd2ef8abb))
* **ccr:** unwrap Hermes batched tool_call so headroom_retrieve stays
exempt
([#3839](https://github.com/headroomlabs-ai/headroom/issues/3839))
([2f07668](https://github.com/headroomlabs-ai/headroom/commit/2f076687b069f09c69a1ce3e6f3eaaa521b838f7))
* **ci:** clear dependency audit and gate Docker publishing
([#3984](https://github.com/headroomlabs-ai/headroom/issues/3984))
([67ce7d0](https://github.com/headroomlabs-ai/headroom/commit/67ce7d0f3119883a873a53c1fb1e569c80d36d71))
* **ci:** keep hard watchdog out of pytest shards
([#3845](https://github.com/headroomlabs-ai/headroom/issues/3845))
([2527431](https://github.com/headroomlabs-ai/headroom/commit/25274310ca396aaf5761d78d07106de3dfde2951))
* **ci:** tolerate missing Docker cache blobs
([#3945](https://github.com/headroomlabs-ai/headroom/issues/3945))
([540f4da](https://github.com/headroomlabs-ai/headroom/commit/540f4da19995ce9ec60240f991a8091466ee7e51))
* clarify CCR marker content preservation
([#3175](https://github.com/headroomlabs-ai/headroom/issues/3175))
([005a4e1](https://github.com/headroomlabs-ai/headroom/commit/005a4e146f94e2388e8e0e7eaabe5a831676b26b))
* **cli:** honor CODEX_HOME and align wrap/init/doctor with the live
proxy port
([#3855](https://github.com/headroomlabs-ai/headroom/issues/3855))
([5bf6612](https://github.com/headroomlabs-ai/headroom/commit/5bf661232667fe2573caafcd9b48f86c6388b5bd))
* **cli:** strip unmarked headroom_memory TOML table before injecting
([#3490](https://github.com/headroomlabs-ai/headroom/issues/3490))
([08dda4c](https://github.com/headroomlabs-ai/headroom/commit/08dda4cb0b5fe69bff8aa1deeabfb2111738087c))
* **codex:** explain why wrapped Codex runs without the shared server
([#3899](https://github.com/headroomlabs-ai/headroom/issues/3899))
([1982b3a](https://github.com/headroomlabs-ai/headroom/commit/1982b3a773093ff8262887e69ffb12e342ce4ffc))
* **codex:** preserve remote compaction in init config
([#3410](https://github.com/headroomlabs-ai/headroom/issues/3410))
([6df4a96](https://github.com/headroomlabs-ai/headroom/commit/6df4a963ae4cfefa2269b751874e142b02feb726))
* **codex:** resolve per-turn project context
([#2636](https://github.com/headroomlabs-ai/headroom/issues/2636))
([0396ea2](https://github.com/headroomlabs-ai/headroom/commit/0396ea2fc22d72d95d1f3bfa63bfbdd0abd74a80))
* **codex:** strip stale compression framing on the Responses subpath
passthrough
([#3792](https://github.com/headroomlabs-ai/headroom/issues/3792))
([0eba65c](https://github.com/headroomlabs-ai/headroom/commit/0eba65ca4a8f04b55d568fc35829eca053a7cfac))
* **copilot:** defer keychain auth lookup
([#2739](https://github.com/headroomlabs-ai/headroom/issues/2739))
([81a8a28](https://github.com/headroomlabs-ai/headroom/commit/81a8a28da38f1837c6b8dd6217a35a5ebb98bc87))
* **copilot:** read timezone-naive token expiry as UTC, not host local
time ([#3216](https://github.com/headroomlabs-ai/headroom/issues/3216))
([2b2dc1b](https://github.com/headroomlabs-ai/headroom/commit/2b2dc1b2c93c596ad5129dff914978c5679ef126))
* **copilot:** warn when a VS Code profile cannot see the proxy settings
([#3919](https://github.com/headroomlabs-ai/headroom/issues/3919))
([7b68fc2](https://github.com/headroomlabs-ai/headroom/commit/7b68fc263a925f97116e1e648cd3fa22a0f04f1b))
* **deps:** patch brace-expansion in wrap E2E lockfile
([#3873](https://github.com/headroomlabs-ai/headroom/issues/3873))
([5e0435d](https://github.com/headroomlabs-ai/headroom/commit/5e0435d2156229c04951da9fafeafdf74d2abf84))
* **deps:** patch urllib3 and Next.js advisories
([#3896](https://github.com/headroomlabs-ai/headroom/issues/3896))
([573e385](https://github.com/headroomlabs-ai/headroom/commit/573e385f120cfd4f5e4d54c791025f2253abf08a))
* **doctor:** recognize Azure Foundry routing for Claude Code
([#1339](https://github.com/headroomlabs-ai/headroom/issues/1339))
([d5318ac](https://github.com/headroomlabs-ai/headroom/commit/d5318ac235595b9740fccb0910ec7139c42d51a0))
* **grok:** route CLI traffic to api.x.ai on shared proxies
([#2693](https://github.com/headroomlabs-ai/headroom/issues/2693))
([ef1c528](https://github.com/headroomlabs-ai/headroom/commit/ef1c528e92a2b037a170f94ec8adf917322ba630))
* honor configured port in container startup and healthcheck
([#2436](https://github.com/headroomlabs-ai/headroom/issues/2436))
([1b7977c](https://github.com/headroomlabs-ai/headroom/commit/1b7977cecd95e53cccf45f04248097a8e4137b3f))
* **install/apply:** add --no-rate-limit flag, persist in proxy_args
([#1350](https://github.com/headroomlabs-ai/headroom/issues/1350))
([#1365](https://github.com/headroomlabs-ai/headroom/issues/1365))
([31d0344](https://github.com/headroomlabs-ai/headroom/commit/31d03449910fbacbefdde8c04ea2c10299f9bba6))
* **install:** parse Windows Task Scheduler XML output
([#3830](https://github.com/headroomlabs-ai/headroom/issues/3830))
([c32a4f4](https://github.com/headroomlabs-ai/headroom/commit/c32a4f4131934dee48d793156fb8a536a4b2617e))
* **install:** replace the launchd wrapper with the proxy listener
([#3224](https://github.com/headroomlabs-ai/headroom/issues/3224))
([44db755](https://github.com/headroomlabs-ai/headroom/commit/44db755ee6d85d0eb74f1fc79ef737741f87debc))
* **install:** use safe model backends for persistent services
([#3646](https://github.com/headroomlabs-ai/headroom/issues/3646))
([7287589](https://github.com/headroomlabs-ai/headroom/commit/7287589d23b76911b036d97f58c3cc043a9693c8))
* **integrations:** record metric timestamps in UTC, not naive local
time ([#3117](https://github.com/headroomlabs-ai/headroom/issues/3117))
([76ef2c3](https://github.com/headroomlabs-ai/headroom/commit/76ef2c3bc9cc302f4b638fab83467ab53cb192c1))
* **kompress:** degrade when a native dep is installed but unloadable
([#3133](https://github.com/headroomlabs-ai/headroom/issues/3133))
([8f3d677](https://github.com/headroomlabs-ai/headroom/commit/8f3d677354f50df9181cbb3fa002003be4e3c237))
* **kompress:** pin ModernBERT tokenizer and encoder revisions
([#3808](https://github.com/headroomlabs-ai/headroom/issues/3808))
([2de5828](https://github.com/headroomlabs-ai/headroom/commit/2de582875b7dd1ef8754df8a2905ab4d72dab581))
* **learn:** drop the echoed prompt from a failed cli's error
([#3928](https://github.com/headroomlabs-ai/headroom/issues/3928))
([f00d425](https://github.com/headroomlabs-ai/headroom/commit/f00d42561402752e56666ff35962ad8da6f7966c))
* **learn:** keep CLAUDE.local.md out of git via .git/info/exclude
([#3108](https://github.com/headroomlabs-ai/headroom/issues/3108))
([c072251](https://github.com/headroomlabs-ai/headroom/commit/c072251c10a1334265974ed33f655487518d41d0))
* **learn:** keep transcript-derived content inside the managed block
([#3850](https://github.com/headroomlabs-ai/headroom/issues/3850))
([c46e74d](https://github.com/headroomlabs-ai/headroom/commit/c46e74d06b5ffa9643f420f28d2da6686fb7e487))
* **learn:** merge git worktree sessions into the repo's project
([#3854](https://github.com/headroomlabs-ai/headroom/issues/3854))
([3fdf18e](https://github.com/headroomlabs-ai/headroom/commit/3fdf18ededa162e5f46f5a996a164a6ca9de283f))
* **learn:** preserve stable traffic pattern items
([#2293](https://github.com/headroomlabs-ai/headroom/issues/2293))
([1631cde](https://github.com/headroomlabs-ai/headroom/commit/1631cde6865cbc03a60ade5e9baaa28837add4e4))
* **learn:** recognize escaped persisted pattern IDs
([#3951](https://github.com/headroomlabs-ai/headroom/issues/3951))
([2e74f06](https://github.com/headroomlabs-ai/headroom/commit/2e74f06ecec73d365e06de6832b13f7e9fe386b7))
* **learn:** run the claude-cli analysis with hooks disabled
([#3926](https://github.com/headroomlabs-ai/headroom/issues/3926))
([2a4d34c](https://github.com/headroomlabs-ai/headroom/commit/2a4d34c47676080336577bb4b227864258cb2c78))
* **learn:** run the claude-cli analysis with no tools
([#3892](https://github.com/headroomlabs-ai/headroom/issues/3892))
([db90b93](https://github.com/headroomlabs-ai/headroom/commit/db90b93da9f8decb9cac7fa007674de7974a1cdb))
* **log_compressor:** keep and name pytest short-summary failures
([#3828](https://github.com/headroomlabs-ai/headroom/issues/3828))
([d90b320](https://github.com/headroomlabs-ai/headroom/commit/d90b32008dc47f25737d9cef8da942fd8dc1af76))
* make Headroom work behind Zscaler and other TLS-inspecting networks
([#3831](https://github.com/headroomlabs-ai/headroom/issues/3831))
([66258c4](https://github.com/headroomlabs-ai/headroom/commit/66258c40a4589bb2fef934dec6fb69c527ae8b44))
* **mcp:** bound version-detection git subprocess
([#3038](https://github.com/headroomlabs-ai/headroom/issues/3038))
([0712e04](https://github.com/headroomlabs-ai/headroom/commit/0712e048b034e7f15ce10c0fc4e99795cab082ff))
* **mcp:** escape control characters when rendering TOML server blocks
([#3964](https://github.com/headroomlabs-ai/headroom/issues/3964))
([a96154f](https://github.com/headroomlabs-ai/headroom/commit/a96154f03b65179f23496a1ff9682cfc476eaff5))
* **mcp:** keep other apps' tables when replacing the Codex/Grok MCP
span ([#3877](https://github.com/headroomlabs-ai/headroom/issues/3877))
([d0fd56e](https://github.com/headroomlabs-ai/headroom/commit/d0fd56e4910c997a3121aa27ab578b998b260f5a))
* **mcp:** resolve opencode.jsonc for MCP registration
([#2496](https://github.com/headroomlabs-ai/headroom/issues/2496))
([f824a27](https://github.com/headroomlabs-ai/headroom/commit/f824a270f132516443deeef2555076bf4cd40a34))
* **memory:** align project routing with wrap headers
([#3603](https://github.com/headroomlabs-ai/headroom/issues/3603))
([b1b005a](https://github.com/headroomlabs-ai/headroom/commit/b1b005a9a867d75cbc6b459b1f5276c272e7ac50))
* **memory:** avoid injecting tools into tool-free requests
([#3677](https://github.com/headroomlabs-ai/headroom/issues/3677))
([46755b5](https://github.com/headroomlabs-ai/headroom/commit/46755b5f72804c32dc7d6ded5595342a2cac6157))
* **memory:** close SQLite connections in memory/fts5/graph adapters
([#3153](https://github.com/headroomlabs-ai/headroom/issues/3153))
([231a627](https://github.com/headroomlabs-ai/headroom/commit/231a6277024938d28e0ebeda29378dea3822b527))
* **memory:** handle list-shaped system content in inline memory
injection
([#3794](https://github.com/headroomlabs-ai/headroom/issues/3794))
([717527b](https://github.com/headroomlabs-ai/headroom/commit/717527bc8681665326c064ed47e3f5a0284b01a5))
* **memory:** ignore leading cd prefix when pairing Bash error
recoveries
([#3776](https://github.com/headroomlabs-ai/headroom/issues/3776))
([143a38d](https://github.com/headroomlabs-ai/headroom/commit/143a38d56f5bddb96dd486948c3318bd8dc93372))
* **memory:** pin LF on memory writers and guard the learn-writer
newline contract
([#3706](https://github.com/headroomlabs-ai/headroom/issues/3706))
([b10dd8d](https://github.com/headroomlabs-ai/headroom/commit/b10dd8db6e71903e550edd1707ce044f3520f0b4))
* **oauth2:** mint and inject only on requests that go upstream
([#3849](https://github.com/headroomlabs-ai/headroom/issues/3849))
([f977d52](https://github.com/headroomlabs-ai/headroom/commit/f977d525e4cf4ac1cad64dd59cfc6d3e54cd8e36))
* **offline:** make HEADROOM_OFFLINE a real air-gap via one chokepoint
([#3729](https://github.com/headroomlabs-ai/headroom/issues/3729))
([119d1a1](https://github.com/headroomlabs-ai/headroom/commit/119d1a19393697f22140da654f0b6a10c3866d79))
* **opencode:** hide spawned Windows console windows
([#3743](https://github.com/headroomlabs-ai/headroom/issues/3743))
([2157400](https://github.com/headroomlabs-ai/headroom/commit/2157400b005b858fb4ab96dadde022bb22d3d244))
* **opencode:** route only LLM traffic through Headroom
([#3884](https://github.com/headroomlabs-ai/headroom/issues/3884))
([d75eecd](https://github.com/headroomlabs-ai/headroom/commit/d75eecd814d391f51c6b98b1594c0ea180e9103a))
* **output-savings:** seed the holdout key on the whole first user
message
([#3209](https://github.com/headroomlabs-ai/headroom/issues/3209))
([117ff72](https://github.com/headroomlabs-ai/headroom/commit/117ff72ec9aa6385c4e6afb23f06a4a6edb59f8e))
* **parser:** stop counting HTML comments twice in waste signals
([#3942](https://github.com/headroomlabs-ai/headroom/issues/3942))
([d0e9c4c](https://github.com/headroomlabs-ai/headroom/commit/d0e9c4ca4810f36c8bd71cfc567be9e72c8c06d1))
* **parser:** whitespace waste signal always reported zero
([#1102](https://github.com/headroomlabs-ai/headroom/issues/1102))
([f19bc9a](https://github.com/headroomlabs-ai/headroom/commit/f19bc9a9c344e846ef61de09652c55f8db835aa1))
* **plugin:** resolve hook CLI through plugin-root launcher
([#3053](https://github.com/headroomlabs-ai/headroom/issues/3053))
([ef7605f](https://github.com/headroomlabs-ai/headroom/commit/ef7605fdbb82a5c1a75c9192432bc719aa92927d))
* **plugins/openclaw:** return messages the proxy did not change exactly
as they came in
([#3826](https://github.com/headroomlabs-ai/headroom/issues/3826))
([d1ad189](https://github.com/headroomlabs-ai/headroom/commit/d1ad189819d0dd87137267a17233ab2703eb803c))
* prevent HF tokenizer downloads in offline mode
([#3783](https://github.com/headroomlabs-ai/headroom/issues/3783))
([d503c57](https://github.com/headroomlabs-ai/headroom/commit/d503c575eabd6dfed3f390754d391a337340d7d7))
* **pricing:** add Claude Sonnet 5.5 / Opus 5.5 / Fable 5.1, correct
Sonnet 5 rates
([#3841](https://github.com/headroomlabs-ai/headroom/issues/3841))
([0d99c56](https://github.com/headroomlabs-ai/headroom/commit/0d99c56dc519c4684079a0e1107399068342104d))
* protect file reads in chained shell commands
([#2668](https://github.com/headroomlabs-ai/headroom/issues/2668))
([ffc3599](https://github.com/headroomlabs-ai/headroom/commit/ffc359976b09f64388ac9cb8685904c5a5f59708))
* **providers/vertex:** Vertex route multi-region locations
([#3802](https://github.com/headroomlabs-ai/headroom/issues/3802))
([a9c1ac5](https://github.com/headroomlabs-ai/headroom/commit/a9c1ac5368798382b0d7e081e910a6df2a728bb0))
* **proxy/anthropic:** keep tool_result blocks first when neutralizing
headroom_retrieve history
([#3874](https://github.com/headroomlabs-ai/headroom/issues/3874))
([ccd9fff](https://github.com/headroomlabs-ai/headroom/commit/ccd9fffce93cd93d694d78c601ec50eeff0bd256))
* **proxy/batch:** honor x-headroom-bypass on the batch paths
([#2570](https://github.com/headroomlabs-ai/headroom/issues/2570))
([9b26a49](https://github.com/headroomlabs-ai/headroom/commit/9b26a49c14eacd8e14385bf8d28c67b2425b3c5c))
* **proxy:** add same-origin check to /v1/retrieve/tool_call
([#3955](https://github.com/headroomlabs-ai/headroom/issues/3955))
([2297b50](https://github.com/headroomlabs-ai/headroom/commit/2297b5059f27c0018b15f7857a5b3a7026a68bdd))
* **proxy:** bill the whole prompt on the gateway path so savings read
true ([#3632](https://github.com/headroomlabs-ai/headroom/issues/3632))
([befdb52](https://github.com/headroomlabs-ai/headroom/commit/befdb52fd565ff990e4ff1463f0550ba7df588b5))
* **proxy:** carry safeguard_results through SSE resynthesis
([#3958](https://github.com/headroomlabs-ai/headroom/issues/3958))
([f37ef59](https://github.com/headroomlabs-ai/headroom/commit/f37ef591894c6b89bc25ea628b64b40bdd1037fb))
* **proxy:** classify Pi Codex Responses alias
([#2583](https://github.com/headroomlabs-ai/headroom/issues/2583))
([a493f55](https://github.com/headroomlabs-ai/headroom/commit/a493f559a1a85a5462fc3bf3f363d64c3c9444ce))
* **proxy:** do not cache error replies delivered as http 200
([#3930](https://github.com/headroomlabs-ai/headroom/issues/3930))
([1132a54](https://github.com/headroomlabs-ai/headroom/commit/1132a54b21482332f6ffeeebe8c9935a69709afa))
* **proxy:** drop a tool_reference naming the search tool itself
([#3172](https://github.com/headroomlabs-ai/headroom/issues/3172))
([b73adaa](https://github.com/headroomlabs-ai/headroom/commit/b73adaa0ce36a2e65a98f5590c46ea555751b445))
* **proxy:** F3 — per-tenant TOIN learning key
([#404](https://github.com/headroomlabs-ai/headroom/issues/404))
([f90a56b](https://github.com/headroomlabs-ai/headroom/commit/f90a56b0388f3dcb6455425a3405b40b67da6858))
* **proxy:** forward operator-listed guarded upstreams through a proxy
([#3804](https://github.com/headroomlabs-ai/headroom/issues/3804))
([4b7e5d2](https://github.com/headroomlabs-ai/headroom/commit/4b7e5d246e54b856af22cd1a90b47d93b26226cb))
* **proxy:** freeze and replay the forwarded prefix on Gemini paths
([#3394](https://github.com/headroomlabs-ai/headroom/issues/3394))
([#3865](https://github.com/headroomlabs-ai/headroom/issues/3865))
([dd84321](https://github.com/headroomlabs-ai/headroom/commit/dd84321daa0c3c9dca9264098bb396a75d9e52cd))
* **proxy:** gate the raw request body, not just its Content-Length
header
([#3338](https://github.com/headroomlabs-ai/headroom/issues/3338))
([c946b6b](https://github.com/headroomlabs-ai/headroom/commit/c946b6b0b0ae048c576940d1a57071b84cb05fb6))
* **proxy:** hard watchdog that dumps and exits when a native call
seizes the GIL
([#3180](https://github.com/headroomlabs-ai/headroom/issues/3180))
([79daeb5](https://github.com/headroomlabs-ai/headroom/commit/79daeb590f46c8f74483e975647c202d09f01fbb))
* **proxy:** inject memory context past a trailing system message
([#3948](https://github.com/headroomlabs-ai/headroom/issues/3948))
([3948dbe](https://github.com/headroomlabs-ai/headroom/commit/3948dbe409eba48c065a3ecb2af9fa2f51921787))
* **proxy:** keep cache_control outside content blocks where the Chat
Completions client put it
([#3895](https://github.com/headroomlabs-ai/headroom/issues/3895))
([a6d6c14](https://github.com/headroomlabs-ai/headroom/commit/a6d6c14cf781a7725e4e8366e8cd86b1e4e44ba9))
* **proxy:** keep exception text and the proxy token out of client
output
([#3851](https://github.com/headroomlabs-ai/headroom/issues/3851))
([861e94d](https://github.com/headroomlabs-ai/headroom/commit/861e94d8c173bcca1ec4ae4f84a3e7ef477c4a19))
* **proxy:** keep the newest user message verbatim in cache-mode delta
compression
([#3923](https://github.com/headroomlabs-ai/headroom/issues/3923))
([613ae92](https://github.com/headroomlabs-ai/headroom/commit/613ae9215058c1d5cabc67186f3b47089b22eddb))
* **proxy:** key rate limits by peer unless the caller authenticated
([#3860](https://github.com/headroomlabs-ai/headroom/issues/3860))
([6fb7cad](https://github.com/headroomlabs-ai/headroom/commit/6fb7cadfe4c54c2be6b90e9fdea36e91da7b2945))
* **proxy:** kill the image worker a timed-out call abandons
([#3940](https://github.com/headroomlabs-ai/headroom/issues/3940))
([793bb85](https://github.com/headroomlabs-ai/headroom/commit/793bb85659d9aa907115ec16ea3356c5459f6299))
* **proxy:** label plain OpenAI chat traffic openai, not custom
([#3912](https://github.com/headroomlabs-ai/headroom/issues/3912))
([7df8bd8](https://github.com/headroomlabs-ai/headroom/commit/7df8bd87b54725174e1ea88e2dcd428b66cb608f))
* **proxy:** log response_content_length in proxy_inbound_response
([#2701](https://github.com/headroomlabs-ai/headroom/issues/2701))
([cfa479a](https://github.com/headroomlabs-ai/headroom/commit/cfa479af8e551d5d2710debf80adb86fd72b16e5))
* **proxy:** preserve Bedrock body-limit error dialect
([#3871](https://github.com/headroomlabs-ai/headroom/issues/3871))
([ffc6edb](https://github.com/headroomlabs-ai/headroom/commit/ffc6edb4ba7a775d2f6440769b626132a66aa7d3))
* **proxy:** preserve Windows service when Rust core is blocked
([#2989](https://github.com/headroomlabs-ai/headroom/issues/2989))
([eaa16d9](https://github.com/headroomlabs-ai/headroom/commit/eaa16d9f6343f9d5364863c7522734f6b86b1844))
* **proxy:** quarantine compression only once half the pool is stuck
([#3932](https://github.com/headroomlabs-ai/headroom/issues/3932))
([be2b205](https://github.com/headroomlabs-ai/headroom/commit/be2b205c51430236404177bb7d80930a2d299d5a))
* **proxy:** read HEADROOM_LICENSE and make usage reporting opt-in
([#3857](https://github.com/headroomlabs-ai/headroom/issues/3857))
([7460389](https://github.com/headroomlabs-ai/headroom/commit/746038991cf2b4dbb31dd2227d607db7bc273da7))
* **proxy:** reap wrap-spawned proxies once no wrap clients remain
([#3202](https://github.com/headroomlabs-ai/headroom/issues/3202))
([4227bd2](https://github.com/headroomlabs-ai/headroom/commit/4227bd2419e72a922149d5dfaf416808d8e08139))
* **proxy:** redact upstream error detail and add opt-in /metrics
loopback gate
([#2589](https://github.com/headroomlabs-ai/headroom/issues/2589))
([a05717f](https://github.com/headroomlabs-ai/headroom/commit/a05717f6ec2b0514ccaa42b9bd1b3c95d3465730))
* **proxy:** refuse token-less non-loopback binds, gate operator routes
([#3852](https://github.com/headroomlabs-ai/headroom/issues/3852))
([ee731d7](https://github.com/headroomlabs-ai/headroom/commit/ee731d7ea84503ad844eb2759fcb5bbf04a1ae0e))
* **proxy:** reset the cc-switch upstream when Claude Official is
selected
([#3166](https://github.com/headroomlabs-ai/headroom/issues/3166))
([fed7281](https://github.com/headroomlabs-ai/headroom/commit/fed7281120af5b476d3911ca1ebf4dc66d5ca1ea))
* **proxy:** run extension middleware inside the security gate and body
ceiling
([#3847](https://github.com/headroomlabs-ai/headroom/issues/3847))
([1854fd7](https://github.com/headroomlabs-ai/headroom/commit/1854fd7fd3f52bb4cc0b17803de0a04a850eb8f7))
* **proxy:** run injected memory tools server-side on streaming turns
([#3947](https://github.com/headroomlabs-ai/headroom/issues/3947))
([1cf4966](https://github.com/headroomlabs-ai/headroom/commit/1cf496612e781ef8d67ff87ee4f78037492f0bc7))
* **proxy:** share one compression deadline across a Responses request
([#3938](https://github.com/headroomlabs-ai/headroom/issues/3938))
([4d27d02](https://github.com/headroomlabs-ai/headroom/commit/4d27d024b09fe04f6e32b158063538f084d7febb))
* **proxy:** skip pricing lookup for passthrough:* models
([#2585](https://github.com/headroomlabs-ai/headroom/issues/2585))
([f87848c](https://github.com/headroomlabs-ai/headroom/commit/f87848cf78db43dcd4b7e9b6aca3859245348456))
* **proxy:** stop headroom logger from suppressing propagation to
stdout/stderr
([#3096](https://github.com/headroomlabs-ai/headroom/issues/3096))
([f78e66f](https://github.com/headroomlabs-ai/headroom/commit/f78e66f7cc5e00d5db04c493f702ef4ebe7035b0))
* **relevance:** bound segment size by max_chars
([#2518](https://github.com/headroomlabs-ai/headroom/issues/2518))
([0ef7b2a](https://github.com/headroomlabs-ai/headroom/commit/0ef7b2a7fdd7daf4dbb8628c616c28a233ce7910))
* **reporting:** price the savings tile instead of fabricating $0.00
([#3821](https://github.com/headroomlabs-ai/headroom/issues/3821))
([f519fa8](https://github.com/headroomlabs-ai/headroom/commit/f519fa8b97aa9ccef369f5973f1d476af2a65edf))
* **router:** fall back to built-ins when an external compressor passes
through
([#3893](https://github.com/headroomlabs-ai/headroom/issues/3893))
([2c4b20f](https://github.com/headroomlabs-ai/headroom/commit/2c4b20fcba6da0366c1c637a2a3cc61e843012a7))
* **router:** keep ccr_retrieve exemption through orchestrator wrappers
([#3915](https://github.com/headroomlabs-ai/headroom/issues/3915))
([6151ed1](https://github.com/headroomlabs-ai/headroom/commit/6151ed1f52f3d0dd24eb28e0fa666226150a0055))
* **rust-proxy:** forward request paths verbatim and pin the rustls
provider
([#3853](https://github.com/headroomlabs-ai/headroom/issues/3853))
([9d98ea5](https://github.com/headroomlabs-ai/headroom/commit/9d98ea59082ca6b00be2508f00b85ef90c94f744))
* **savings:** record tool-schema dollars disjointly beside the folded
headline
([#3170](https://github.com/headroomlabs-ai/headroom/issues/3170))
([c719d4a](https://github.com/headroomlabs-ai/headroom/commit/c719d4af55ebca177c81c98f74531bfaca831366))
* **savings:** stop scoring unobserved strata against the global mean
([#3128](https://github.com/headroomlabs-ai/headroom/issues/3128))
([f864525](https://github.com/headroomlabs-ai/headroom/commit/f8645257c074b7e5babd949e705d7ca4e8366ae4))
* **sdk:** keep tool names on Vercel tool-result parts through the
OpenAI round trip
([#3883](https://github.com/headroomlabs-ai/headroom/issues/3883))
([b715671](https://github.com/headroomlabs-ai/headroom/commit/b7156714acf1f06cd37f642044455e23e2f89d47))
* **sdk:** preserve Gemini media parts in message conversion instead of
dropping the turn
([#3882](https://github.com/headroomlabs-ai/headroom/issues/3882))
([038c923](https://github.com/headroomlabs-ai/headroom/commit/038c923b4bcd01305f18d993e301b837d668c343))
* **sdk:** stop JSON-wrapping structured tool_result content in the
Anthropic adapter
([#3797](https://github.com/headroomlabs-ai/headroom/issues/3797))
([2e4a60a](https://github.com/headroomlabs-ai/headroom/commit/2e4a60ae3730fc7ea8f5afebbc29961d5fd0af11))
* **search:** stop a context line's body from becoming its line marker
([#3788](https://github.com/headroomlabs-ai/headroom/issues/3788))
([f3f2e00](https://github.com/headroomlabs-ai/headroom/commit/f3f2e0077ae67d492bfc5922e9a49427036e32e0))
* **security:** create memory stores and other state files owner-only
([#3848](https://github.com/headroomlabs-ai/headroom/issues/3848))
([5119b6e](https://github.com/headroomlabs-ai/headroom/commit/5119b6eb545e35b617e2d08b183e968d0104d548))
* **security:** exempt only GET health probes from the proxy token
([#3921](https://github.com/headroomlabs-ai/headroom/issues/3921))
([d99779d](https://github.com/headroomlabs-ai/headroom/commit/d99779dae69d44c934d2115ffd8ee1f1a6cbb898))
* **security:** partition the response cache by credential and principal
([#3862](https://github.com/headroomlabs-ai/headroom/issues/3862))
([ee6cfcc](https://github.com/headroomlabs-ai/headroom/commit/ee6cfcccf6a8944225344c2a468f509783934239))
* **security:** poll usage only with the operator's own credential
([#3863](https://github.com/headroomlabs-ai/headroom/issues/3863))
([65e63c0](https://github.com/headroomlabs-ai/headroom/commit/65e63c08835410149bec4acba8e3737366eb0586))
* **security:** stop forwarding the proxy token to upstream providers
([#3891](https://github.com/headroomlabs-ai/headroom/issues/3891))
([0147cf0](https://github.com/headroomlabs-ai/headroom/commit/0147cf02207fd76be8a14932bcc65a9709bfdb59))
* **settings:** report live proxy configuration
([#3177](https://github.com/headroomlabs-ai/headroom/issues/3177))
([58b1454](https://github.com/headroomlabs-ai/headroom/commit/58b1454282f2b2dee49616c6637fa135ccb885b7))
* **smart-crusher:** recurse at adaptive array limit
([#3770](https://github.com/headroomlabs-ai/headroom/issues/3770))
([7790bde](https://github.com/headroomlabs-ai/headroom/commit/7790bdeebda290b9fdbf899df1cbf9a05e0bc5e9))
* **storage:** page JSONL queries after sorting
([#3872](https://github.com/headroomlabs-ai/headroom/issues/3872))
([91237ca](https://github.com/headroomlabs-ai/headroom/commit/91237cae70771e8e19cbc06ca65d328ac6cb0878))
* **subscription:** match the Bearer scheme case-insensitively for the
Codex usage poll (RFC 7235)
([#3966](https://github.com/headroomlabs-ai/headroom/issues/3966))
([fe88461](https://github.com/headroomlabs-ai/headroom/commit/fe884612c07d2e8a4454615ccc5b6d4feed1d7dd))
* **subscription:** poll with the refreshed credentials-file OAuth token
([#3916](https://github.com/headroomlabs-ai/headroom/issues/3916))
([2dc9fc2](https://github.com/headroomlabs-ai/headroom/commit/2dc9fc22f09ec85d8e73c916e7c1f6f565d271ec))
* surface Codex responses traffic in dashboard
([#399](https://github.com/headroomlabs-ai/headroom/issues/399))
([ecc4967](https://github.com/headroomlabs-ai/headroom/commit/ecc496709b7f2c2657de25d1e3f8de3f226b32e5))
* **telemetry:** label custom-base chat upstreams from a fixed provider
set ([#3759](https://github.com/headroomlabs-ai/headroom/issues/3759))
([f0ec2bb](https://github.com/headroomlabs-ai/headroom/commit/f0ec2bb37697b1addccb416bd626e7bf3c5ea835))
* **thinking:** don't read the model's date suffix as its minor version
([#3791](https://github.com/headroomlabs-ai/headroom/issues/3791))
([afaaaa8](https://github.com/headroomlabs-ai/headroom/commit/afaaaa88049357bac7ec186ea33678f406d02609))
* **transforms/kompress:** preserve line boundaries and tabular output
in Kompress
([#3119](https://github.com/headroomlabs-ai/headroom/issues/3119))
([fe2ed2b](https://github.com/headroomlabs-ai/headroom/commit/fe2ed2b545e4b3c97d21872232d5446cb54aedc2))
* **transforms:** judge a Codex exec envelope read by its output
([#3878](https://github.com/headroomlabs-ai/headroom/issues/3878))
([922924e](https://github.com/headroomlabs-ai/headroom/commit/922924ef44ebd7501ff00923cc0c2007f06cfade))
* **transforms:** judge the code_aware Kompress fallback in tokens
([#3881](https://github.com/headroomlabs-ai/headroom/issues/3881))
([6326965](https://github.com/headroomlabs-ai/headroom/commit/63269650462c1a565c259cfe3fc3bd67ac942f5a))
* **transforms:** keep record-bearing JSON out of Kompress
([#3673](https://github.com/headroomlabs-ai/headroom/issues/3673))
([#3880](https://github.com/headroomlabs-ai/headroom/issues/3880))
([8dbbd1d](https://github.com/headroomlabs-ai/headroom/commit/8dbbd1d8967f719acfaa21e2c1668e9f3193dbe8))
* **wrap:** never reuse a non-Headroom listener on the proxy port
([#3799](https://github.com/headroomlabs-ai/headroom/issues/3799))
([3ffa57e](https://github.com/headroomlabs-ai/headroom/commit/3ffa57ec25a6f05dff073c0ad0b14c90ce264fd8))
* **wrap:** never reuse a proxy with incompatible routing config
([#3201](https://github.com/headroomlabs-ai/headroom/issues/3201))
([f69e246](https://github.com/headroomlabs-ai/headroom/commit/f69e2463a0c29cea7943af5efe4b2a2170a1e863))
* **wrap:** preserve pre-set ANTHROPIC_BASE_URL as proxy upstream
([#1358](https://github.com/headroomlabs-ai/headroom/issues/1358))
([bb1ab6a](https://github.com/headroomlabs-ai/headroom/commit/bb1ab6afd35a5c22b6c11b549aba4075fb7791ec))
* **wrap:** scope Serena's MCP registration to the wrapped project
([#2787](https://github.com/headroomlabs-ai/headroom/issues/2787))
([#2992](https://github.com/headroomlabs-ai/headroom/issues/2992))
([8cfeb69](https://github.com/headroomlabs-ai/headroom/commit/8cfeb692ca0cad9598160020a144c5c671cd2fc3))
* **wrap:** set ANTHROPIC_HOST so `wrap goose` actually proxies
Anthropic
([#2619](https://github.com/headroomlabs-ai/headroom/issues/2619))
([c07fad0](https://github.com/headroomlabs-ai/headroom/commit/c07fad0f37d44b7f6886e6ce774d424463636242))
* **wrap:** strip -dev from running proxy version in restart check
([#3200](https://github.com/headroomlabs-ai/headroom/issues/3200))
([bd0296b](https://github.com/headroomlabs-ai/headroom/commit/bd0296b5e7b62b620df7b37b41ce573d57958e71))


### Performance Improvements

* add savings audit output
([#1211](https://github.com/headroomlabs-ai/headroom/issues/1211))
([9a72bc0](https://github.com/headroomlabs-ai/headroom/commit/9a72bc024263e2470626fae7f20430db682e0042))
* **compression/code:** avoid a UTF-8 copy per code block in
byte-to-char mapping
([#3169](https://github.com/headroomlabs-ai/headroom/issues/3169))
([d5e5534](https://github.com/headroomlabs-ai/headroom/commit/d5e5534b4763b14d7710908153e0d6a89423eea9))
* **image:** OCR and SigLIP each image once, not once per turn
([#3941](https://github.com/headroomlabs-ai/headroom/issues/3941))
([a8561fb](https://github.com/headroomlabs-ai/headroom/commit/a8561fb4be1bdc17bf8bf86ac97c17651e2820b7))
* **memory:** bound traffic-learner _persisted_ids with the dedup window
([#3341](https://github.com/headroomlabs-ai/headroom/issues/3341))
([7e73438](https://github.com/headroomlabs-ai/headroom/commit/7e73438dc5f923c90ad0c1f2f07cb6de221c9f08))
* **metrics:** cap inbound request-path cardinality to bound memory
([#3340](https://github.com/headroomlabs-ai/headroom/issues/3340))
([88a1f4e](https://github.com/headroomlabs-ai/headroom/commit/88a1f4e52ba220b5ddb34d94ac0a201391c16027))
* **proxy:** lighter request path: alias the message snapshot, keep the
token cache on re-counts, decompress off the event loop
([#3909](https://github.com/headroomlabs-ai/headroom/issues/3909))
([c873d13](https://github.com/headroomlabs-ai/headroom/commit/c873d13fe07d09be71d5dcbfd640a78ec5b3f0d7))
* **tokenizer:** memoize OpenAI token counts like the Anthropic counter
([#3168](https://github.com/headroomlabs-ai/headroom/issues/3168))
([0a2c80d](https://github.com/headroomlabs-ai/headroom/commit/0a2c80d5207642a5e58ba9eb65e19cd004018642))


### Dependencies

* bump pyjwt 2.13.0 -&gt; 2.15.1 for CVE-2026-102274
([#3861](https://github.com/headroomlabs-ai/headroom/issues/3861))
([37b9c46](https://github.com/headroomlabs-ai/headroom/commit/37b9c46069f11a2b2a477ae4ef25dd33bf359684))
* Bump source-map-js from 1.2.1 to 1.2.2 in /docs
([#3986](https://github.com/headroomlabs-ai/headroom/issues/3986))
([e06631a](https://github.com/headroomlabs-ai/headroom/commit/e06631a7a78d18432c90cfb44b30e461424cfd30))
* Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/openclaw
([#3988](https://github.com/headroomlabs-ai/headroom/issues/3988))
([4be83b3](https://github.com/headroomlabs-ai/headroom/commit/4be83b35e683df077b11af4c4b37b301c4a65547))
* Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/opencode
([#3987](https://github.com/headroomlabs-ai/headroom/issues/3987))
([478dd9e](https://github.com/headroomlabs-ai/headroom/commit/478dd9e0a34cd592fdc0e313019297bc23b17db3))
* Bump source-map-js from 1.2.1 to 1.2.2 in /sdk/typescript
([#3985](https://github.com/headroomlabs-ai/headroom/issues/3985))
([62cde35](https://github.com/headroomlabs-ai/headroom/commit/62cde35b939d7405735b72d1e50aa7c1407e5892))
* bump the npm-minor-patch group across 2 directories with 11 updates
([#3903](https://github.com/headroomlabs-ai/headroom/issues/3903))
([afe4f4e](https://github.com/headroomlabs-ai/headroom/commit/afe4f4eca58977ae9382dfb2899a8097b46c0909))
* bump the npm-minor-patch group across 3 directories with 11 updates
([#3910](https://github.com/headroomlabs-ai/headroom/issues/3910))
([ff1a0d6](https://github.com/headroomlabs-ai/headroom/commit/ff1a0d69f4a83f7c5583a7af2d2961025587801e))
* bump webpki-roots from 0.26.11 to 1.0.8
([#3905](https://github.com/headroomlabs-ai/headroom/issues/3905))
([fee53b4](https://github.com/headroomlabs-ai/headroom/commit/fee53b4daa3a0ac2b2378a692278f24f0062d584))
* drop the crewai extra to remove chromadb from the lockfile
([#3870](https://github.com/headroomlabs-ai/headroom/issues/3870))
([59b8cef](https://github.com/headroomlabs-ai/headroom/commit/59b8cefc24e48539974787e0677298f335b2720e))


### Code Refactoring

* **ccr:** read the expansion query through extract_user_query
([#2707](https://github.com/headroomlabs-ai/headroom/issues/2707))
([dcec845](https://github.com/headroomlabs-ai/headroom/commit/dcec845851d8202ce3361022a14b3716fdeb59c0))
* **wrap:** generate goose/openhands/openclaude from a WrapTarget
registry
([#3800](https://github.com/headroomlabs-ai/headroom/issues/3800))
([de4cf7e](https://github.com/headroomlabs-ai/headroom/commit/de4cf7e7a1ece51ce6c60d25bc34f46897e972c9))

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

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-05 22:06:30 -05:00
dependabot[bot]andJerrettDavis 4be83b35e6 deps: Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/openclaw (#3988)
Bumps [source-map-js](https://github.com/7rulnik/source-map-js) from
1.2.1 to 1.2.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/7rulnik/source-map-js/releases">source-map-js's
releases</a>.</em></p>
<blockquote>
<h2>v1.2.2</h2>
<ul>
<li>
<p>Fix crash when executing in browser with CSP script-src that don't
permit unsafe-eval (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/29">#29</a>)
<a href="https://github.com/xfournet"><code>@​xfournet</code></a></p>
</li>
<li>
<p>Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/79">#79</a>)</p>
<p>Reported by <a
href="https://github.com/waydeshi"><code>@​waydeshi</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/issues/76">#76</a>.
A fix was also proposed by <a
href="https://github.com/aniebiet"><code>@​aniebiet</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/pull/78">#78</a>.</p>
</li>
</ul>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/7rulnik/source-map-js/blob/main/CHANGELOG.md">source-map-js's
changelog</a>.</em></p>
<blockquote>
<h2>1.2.2</h2>
<ul>
<li>
<p>Fix crash when executing in browser with CSP script-src that don't
permit unsafe-eval (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/29">#29</a>)
<a href="https://github.com/xfournet"><code>@​xfournet</code></a></p>
</li>
<li>
<p>Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/79">#79</a>)</p>
<p>Reported by <a
href="https://github.com/waydeshi"><code>@​waydeshi</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/issues/76">#76</a>.
A fix was also proposed by <a
href="https://github.com/aniebiet"><code>@​aniebiet</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/pull/78">#78</a>.</p>
</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/0a1d334fd1e55a47df97fcd60a7915d46df3b08a"><code>0a1d334</code></a>
1.2.2</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/4c6fa26d77419bd8e48ec92844866cce7d9ae739"><code>4c6fa26</code></a>
Update changelog</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/cf7658058ceeaa8619d5ae0ec90be6905209d016"><code>cf76580</code></a>
Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/issues/79">#79</a>)</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/7899a86615c630f4fc220273ff9fe2e8e49a56df"><code>7899a86</code></a>
Fix crash when executing browser with CSP script-src that don't permit
unsafe...</li>
<li>See full diff in <a
href="https://github.com/7rulnik/source-map-js/compare/v1.2.1...v1.2.2">compare
view</a></li>
</ul>
</details>
<br />


## Verification and dependency justification

The SDK and OpenClaw lockfiles both need source-map-js 1.2.2: the
repository audits both directories on each PR. The original hosted audit
failed on the unchanged directory with GHSA-68fv-2mgg-jv7q (high
severity). Updating the second lockfile lets this PR pass independently
of its sibling Dependabot PR. Both PRs now have identical lockfiles for
these directories.

### Real behavior proof

Setup: Windows, Node v22.22.0, npm 10.9.4; no provider, model,
credentials, or external service is needed for these tests. In each of
`sdk/typescript` and `plugins/openclaw`, ran `npm audit
--audit-level=high`, `npm ci --ignore-scripts`, `npm test`, and `npm run
build`: both audits reported zero vulnerabilities, and both test and
build commands exited successfully. Rechecked both audits after trimming
unrelated lockfile churn; both remained clean. `git diff --check`
passes. Hosted CI is rerunning on the updated heads.

Not tested locally: the full Python suite, Docker/native publication, or
live OpenClaw/remote-provider behavior. Installation used
`--ignore-scripts`. Existing package tests and builds exercise the
updated dependency graph; no new test mirrors the transitive lock entry.
Actual source-map exploit reproduction was not run; the before-fix
hosted vulnerability report and after-fix registry audits verify the
advisory version remediation.

### Supply chain

source-map-js is an existing transitive dependency, so no new library or
direct dependency is added. Version 1.2.2 is selected for the security
fix in GHSA-68fv-2mgg-jv7q, not a cosmetic update. npm identifies
maintainer `7rulnik` and upstream
https://github.com/7rulnik/source-map-js, an active, non-archived
source-map fork (observed upstream push 2026-09-30). This is a
small-maintainer project; human review of the advisory fix and artifacts
remains appropriate. The release metadata declares no runtime
dependencies, supports Node >=0.10.0, and distributes JavaScript without
native-extension installation. Its declared scripts are
development/test/build scripts, with no package install lifecycle hook.
Runtime source-map processing requires no network service. Installation
fetches npm registry artifacts; the lock records the new version,
integrity hash, and resolved artifact. Other package versions remain
unchanged.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-05 20:34:28 -05:00
dependabot[bot] 478dd9e0a3 deps: Bump source-map-js from 1.2.1 to 1.2.2 in /plugins/opencode (#3987)
Bumps [source-map-js](https://github.com/7rulnik/source-map-js) from
1.2.1 to 1.2.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/7rulnik/source-map-js/releases">source-map-js's
releases</a>.</em></p>
<blockquote>
<h2>v1.2.2</h2>
<ul>
<li>
<p>Fix crash when executing in browser with CSP script-src that don't
permit unsafe-eval (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/29">#29</a>)
<a href="https://github.com/xfournet"><code>@​xfournet</code></a></p>
</li>
<li>
<p>Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/79">#79</a>)</p>
<p>Reported by <a
href="https://github.com/waydeshi"><code>@​waydeshi</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/issues/76">#76</a>.
A fix was also proposed by <a
href="https://github.com/aniebiet"><code>@​aniebiet</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/pull/78">#78</a>.</p>
</li>
</ul>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/7rulnik/source-map-js/blob/main/CHANGELOG.md">source-map-js's
changelog</a>.</em></p>
<blockquote>
<h2>1.2.2</h2>
<ul>
<li>
<p>Fix crash when executing in browser with CSP script-src that don't
permit unsafe-eval (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/29">#29</a>)
<a href="https://github.com/xfournet"><code>@​xfournet</code></a></p>
</li>
<li>
<p>Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/pull/79">#79</a>)</p>
<p>Reported by <a
href="https://github.com/waydeshi"><code>@​waydeshi</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/issues/76">#76</a>.
A fix was also proposed by <a
href="https://github.com/aniebiet"><code>@​aniebiet</code></a> in <a
href="https://redirect.github.com/7rulnik/source-map-js/pull/78">#78</a>.</p>
</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/0a1d334fd1e55a47df97fcd60a7915d46df3b08a"><code>0a1d334</code></a>
1.2.2</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/4c6fa26d77419bd8e48ec92844866cce7d9ae739"><code>4c6fa26</code></a>
Update changelog</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/cf7658058ceeaa8619d5ae0ec90be6905209d016"><code>cf76580</code></a>
Fix denial of service from malicious indexed source maps
(CVE-2026-93749) (<a
href="https://redirect.github.com/7rulnik/source-map-js/issues/79">#79</a>)</li>
<li><a
href="https://github.com/7rulnik/source-map-js/commit/7899a86615c630f4fc220273ff9fe2e8e49a56df"><code>7899a86</code></a>
Fix crash when executing browser with CSP script-src that don't permit
unsafe...</li>
<li>See full diff in <a
href="https://github.com/7rulnik/source-map-js/compare/v1.2.1...v1.2.2">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=source-map-js&package-manager=npm_and_yarn&previous-version=1.2.1&new-version=1.2.2)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/headroomlabs-ai/headroom/network/alerts).

</details>
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/3987"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-05 20:17:55 -05:00
Rod BoevandJerrettDavis ef7605fdbb fix(plugin): resolve hook CLI through plugin-root launcher (#3053)
## Description

The `headroom` plugin invokes `headroom init hook ensure` through
non-login `/bin/sh`, but both `SessionStart` and `PreToolUse` entries
use a bare executable name. Agent hosts whose PATH omits the default
uv/pipx user bin exit 127 on every matching event. Tool calls continue
because the hook is non-blocking, while Headroom compression remains
inactive and the failure banner repeats.

Both hooks now invoke one launcher bundled under `${CLAUDE_PLUGIN_ROOT}`
through `sh`. The launcher honors `HEADROOM_BIN`, preserves
PATH-resolved installations, covers standard uv and pipx prefixes,
records the Homebrew candidates for macOS, and falls back to an
importable Python module. On the launcher-routed path, an absent
Headroom CLI emits one actionable diagnostic and exits 0. Hosts that do
not expose a readable plugin root retain the existing bare-command tail,
preserving the shared GitHub Copilot CLI manifest behavior.

Reported by [@donnydongchen](https://github.com/donnydongchen), whose
exact non-login `env -i` reproduction, Apple Silicon path detail, and
plugin-root suggestion shaped the fix.

Closes #3039

## Type of Change

- [x] 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

- Route both plugin hook entries through a shared
`${CLAUDE_PLUGIN_ROOT}`-anchored `sh` launcher while preserving
matchers, arguments, and 60-second timeouts.
- Require a non-empty plugin root before probing the launcher, so unset
or empty roots always reach the existing bare-command tail.
- Resolve `HEADROOM_BIN`, PATH, standard uv/pipx/Homebrew locations, and
an importable `python -m headroom.cli` fallback in a deterministic
order.
- Preserve the current bare command for hosts without a readable plugin
root, including the shared Copilot CLI manifest path.
- On the launcher-routed path, replace the absent-CLI status-127 banner
with one actionable diagnostic and a non-blocking exit.
- Add real-shell regression coverage for the reported environment,
resolution precedence, supported prefixes, Python fallback, and negative
boundaries.

## Testing

- [x] Unit tests pass (`uv run --extra dev python -m pytest
tests/test_plugin_manifests.py tests/test_plugin_hook_launcher.py
tests/test_cli/test_init_cli.py -q`, `98 passed`)
- [x] Reproduction override passes (`HEADROOM_REPRO_ARTIFACT` can select
the issue fixture, `uv run --extra dev python -m pytest
tests/test_plugin_hook_launcher.py::test_manifest_command_recovers_reported_non_login_environment
-q`, `1 passed`)
- [x] Linting passes (Ruff check and format validation on the changed
Python test files)
- [ ] Type checking passes (`uv run mypy headroom`)
- [x] New tests added for new functionality when applicable
- [ ] Manual testing performed

### Test Output

```text
98 passed
All checks passed!
2 files already formatted
```

## Real Behavior Proof

- Environment: POSIX `sh` with the reporter's sanitized non-login PATH
and a recording Headroom executable only at `$HOME/.local/bin/headroom`
- Exact command / steps: `uv run --extra dev python -m pytest
tests/test_plugin_hook_launcher.py::test_manifest_command_recovers_reported_non_login_environment
-q`; the test preserves the reported PATH and error evidence, executes
both manifest commands with a recorder at `$HOME/.local/bin/headroom`,
and asserts both `home-local init hook ensure` receipts.
- Observed result: `1 passed in 0.41s`; both hooks recovered under the
reported non-login PATH and emitted no command-not-found banner.
- Not tested: live Claude Code plugin-hook execution on a macOS tmux
host

## Runtime Rollout Safety

- Rollout-managed feature(s): none.
- Minimum rollout channel: N/A.
- Stable/default behavior changed: plugin hooks resolve Headroom through
the bundled launcher when the plugin root is readable; invalid launcher
roots retain the existing bare-command fallback.
- Kill switch / disable path: none; the existing bare-command fallback
remains available when the plugin root is absent or unreadable.
- Unsafe override required: none.
- Qualification impact: none.
- Rollback path: revert the implementation commit.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes

## Screenshots (if applicable)

Not applicable; this PR changes plugin hook startup behavior without a
rendered UI.

## Additional Notes

The launcher does not source shell profiles, install packages, access
the network, change deployment/profile selection, or modify plugin
versions.

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/3053"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-10-05 08:35:35 -05:00
Tejas ChopraandClaude Fable 5.1 f977d525e4 fix(oauth2): mint and inject only on requests that go upstream (#3849)
## Why

`OAuth2Middleware` rewrote `Authorization` on every HTTP request
(findings 03-F4 and 03-F5). Routes the proxy answers itself (`/health`,
`/stats*`, `/metrics`, `/v1/compress*`, extension `/ext/*` routes and
the rest of the management surface) never go upstream. Yet each one
minted a token when the cache was cold, and an unreachable IdP turned
health probes and management calls into 502. Separately, the startup log
printed the full token URL, which can carry a query string or embedded
credentials, and the mint log printed the scope list.

## What changes

- The bearer is minted and injected only for requests that go upstream.
`LOCAL_ROUTE_PATHS` and `LOCAL_ROUTE_PREFIXES` list what the proxy
serves itself; a `/p/<project>/` prefix is stripped first with the
core's `split_project_path`. Everything else, including the provider
passthrough catch-all, is treated as upstream, so a new provider route
needs no change here. Only a new local route does.
- Startup log: `scheme://host` of the token URL instead of the full URL.
Mint log: the scope count instead of the list.
- Version 0.1.1 in both `pyproject.toml` and `__version__`. Plugin
`CHANGELOG.md` and README updated.

Inbound authentication is not this plugin's job. From headroom-ai 0.40,
extension middleware runs inside the `HEADROOM_PROXY_TOKEN` gate
(#3847), so an unauthenticated request never reaches it, and a client
may authenticate with `Authorization: Bearer <proxy token>` before this
plugin replaces that header with the upstream bearer.

## Behaviour change / upgrade notes

- Requires headroom-ai >= 0.40. The README says so.
- Requests to local routes no longer carry a minted bearer. Nothing used
it, but a log line or metric keyed on `Authorization` for those paths
will change.

## Tests

`plugins/headroom-oauth2/tests/test_scope_and_proxy_token.py`:
- Every local route, including a project-prefixed one, passes through
with `Authorization` untouched and no mint.
- Upstream routes, including a project-prefixed route, the passthrough
catch-all and `/`, get the minted bearer.
- The install log line carries only `scheme://host`.
- End to end through `create_app` from a non-loopback client with an
unreachable IdP: `/health` is 200; `/stats` with the proxy-token bearer
is 200; `/stats` with no credential is 401; an upstream route with the
proxy-token bearer gets 502 `upstream_auth_error` from oauth2, not 401
from the gate.
- End to end with a local IdP: the proxy-token bearer passes the gate
and is replaced by the minted bearer, `x-headroom-proxy-token` is not
added, and one mint happens. A request with no credential is refused
with 401 and costs no mint.

This plugin has no CI job yet (only `plugins/headroom-agent-hooks` is
path-filtered in), so these tests were run locally.

## Merge order

Part of a set. Suggested order: #3852 → #3891 → #3849 → #3860 → #3862 →
#3863. This PR is independent of the others; the plugin only needs a
core >= 0.40.

## Follow-ups

- Add a path-filtered CI job for `plugins/headroom-oauth2`.

Revised 2026-10-01 after self-review: removed the plugin's own
proxy-token handling (now done by the core gate) and the
`HEADROOM_OAUTH2_LOCAL_PATHS` setting.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-02 11:02:12 -05:00