headroom/docs
Tejas Chopra a6ebeb6db8 fix(proxy): enable tool search by default and repair poisoned transcripts
Anthropic validates every tool_reference in the message history against
the CURRENT request's tools array. Claude Code replays one transcript
across requests carrying very different tools arrays -- the main loop
sends hundreds of tools, the Stop hook evaluator and other side-requests
send a handful -- so once server-side tool search puts a
server_tool_use / tool_search_tool_result pair in history, every later
small-tools request 400s with "Tool reference 'X' not found in
available tools".

Add strip_unsupported_tool_search_blocks(): drop tool-search result
blocks whose references this request's tools array cannot resolve, plus
their paired server_tool_use. Other server tools (web search, code
execution) are left alone. Copy-on-write, so the main loop gets the
original list back by identity and its prefix cache is untouched.

The repair runs unconditionally after injection, so transcripts poisoned
before the upgrade self-heal. With it in place, HEADROOM_TOOL_SEARCH now
defaults to on -- matching what the default 'coding' savings profile
already seeded at proxy startup.

Closes #2805
2026-08-05 13:19:42 -07:00
..
app docs: improve discoverability for AI agents and search crawlers 2026-05-13 17:36:06 -07:00
components docs: sync Vercel docs with current code and add in-depth proxy config (#2475) 2026-07-21 16:26:56 -07:00
content/docs fix(proxy): enable tool search by default and repair poisoned transcripts 2026-08-05 13:19:42 -07:00
lib docs: sync Vercel docs with current code and add in-depth proxy config (#2475) 2026-07-21 16:26:56 -07:00
overrides fix: repair release and docs pipelines 2026-04-16 12:53:51 -05:00
screenshots Merge pull request #147 from JerrettDavis/feat/anthropic-usage-insights 2026-04-12 10:54:22 -07:00
.gitignore new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
bun.lock fix(deps): remediate dependency CVEs and publish SBOM (#1509) 2026-06-27 15:28:12 -07:00
claude-code-bedrock-headroom.md fix(bedrock): route ARNs via converse, named AWS profiles, and au. re… (#1456) 2026-07-02 22:51:05 -05:00
next.config.mjs new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
observability.md fix: remove rtk and lean-ctx CLI context tools (#2677) 2026-07-30 22:59:41 -07:00
package-lock.json deps: bump next from 16.2.10 to 16.3.0 in /docs (#2750) 2026-08-04 21:50:56 -05:00
package.json deps: bump next from 16.2.10 to 16.3.0 in /docs (#2750) 2026-08-04 21:50:56 -05:00
platform-feature-matrix.json fix: harden persistent install startup (#1851) 2026-07-10 00:40:34 -04:00
platform-stabilization.md fix: harden persistent install startup (#1851) 2026-07-10 00:40:34 -04:00
postcss.config.mjs new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
proxy.ts new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
README.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
source.config.ts docs(ci): add CI/CD flow diagrams (#1062) 2026-06-16 23:05:15 -07:00
tsconfig.json new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
vercel.json fix: add Vercel deploy config and workflow for docs site (#1739) 2026-07-14 13:25:18 -04:00

docs

This is a Next.js application generated with Create Fumadocs.

Run development server:

npm run dev
# or
pnpm dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

Explore

In the project, you can see:

  • lib/source.ts: Code for content source adapter, loader() provides the interface to access your content.
  • lib/layout.shared.tsx: Shared options for layouts, optional but preferred to keep.
Route Description
app/(home) The route group for your landing page and other pages.
app/docs The documentation layout and pages.
app/api/search/route.ts The Route Handler for search.

Fumadocs MDX

A source.config.ts config file has been included, you can customise different options like frontmatter schema.

Read the Introduction for further details.

Learn More

To learn more about Next.js and Fumadocs, take a look at the following resources: