xithead 1.2.2 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (659) hide show
  1. package/.actrc +14 -0
  2. package/.actrc.local.example +15 -0
  3. package/.changelog.md +2 -0
  4. package/.claude/agents/academic-anthropologist.md +125 -0
  5. package/.claude/agents/academic-geographer.md +127 -0
  6. package/.claude/agents/academic-historian.md +123 -0
  7. package/.claude/agents/academic-narratologist.md +118 -0
  8. package/.claude/agents/academic-psychologist.md +118 -0
  9. package/.claude/agents/academic-statistician.md +144 -0
  10. package/.claude/agents/accounts-payable-agent.md +205 -0
  11. package/.claude/agents/agentic-identity-trust.md +394 -0
  12. package/.claude/agents/agents-orchestrator.md +367 -0
  13. package/.claude/agents/automation-governance-architect.md +216 -0
  14. package/.claude/agents/blender-addon-engineer.md +243 -0
  15. package/.claude/agents/business-strategist.md +488 -0
  16. package/.claude/agents/change-management-consultant.md +497 -0
  17. package/.claude/agents/chief-financial-officer.md +388 -0
  18. package/.claude/agents/corporate-training-designer.md +192 -0
  19. package/.claude/agents/customer-service.md +398 -0
  20. package/.claude/agents/customer-success-manager.md +460 -0
  21. package/.claude/agents/data-consolidation-agent.md +60 -0
  22. package/.claude/agents/data-privacy-officer.md +412 -0
  23. package/.claude/agents/design-brand-guardian.md +322 -0
  24. package/.claude/agents/design-image-prompt-engineer.md +236 -0
  25. package/.claude/agents/design-inclusive-visuals-specialist.md +73 -0
  26. package/.claude/agents/design-persona-walkthrough.md +272 -0
  27. package/.claude/agents/design-ui-designer.md +386 -0
  28. package/.claude/agents/design-ui-finish-gate-reviewer.md +217 -0
  29. package/.claude/agents/design-ux-architect.md +482 -0
  30. package/.claude/agents/design-ux-researcher.md +329 -0
  31. package/.claude/agents/design-visual-storyteller.md +149 -0
  32. package/.claude/agents/design-whimsy-injector.md +460 -0
  33. package/.claude/agents/economy-designer.md +156 -0
  34. package/.claude/agents/engineering-ai-data-remediation-engineer.md +211 -0
  35. package/.claude/agents/engineering-ai-engineer.md +146 -0
  36. package/.claude/agents/engineering-api-platform-engineer.md +181 -0
  37. package/.claude/agents/engineering-ats-validator-architect.md +383 -0
  38. package/.claude/agents/engineering-autonomous-optimization-architect.md +121 -0
  39. package/.claude/agents/engineering-backend-architect.md +255 -0
  40. package/.claude/agents/engineering-china-network-engineer.md +252 -0
  41. package/.claude/agents/engineering-cms-developer.md +536 -0
  42. package/.claude/agents/engineering-code-reviewer.md +76 -0
  43. package/.claude/agents/engineering-codebase-onboarding-engineer.md +173 -0
  44. package/.claude/agents/engineering-data-engineer.md +349 -0
  45. package/.claude/agents/engineering-data-visualization-engineer.md +151 -0
  46. package/.claude/agents/engineering-database-optimizer.md +188 -0
  47. package/.claude/agents/engineering-database-reliability-engineer.md +201 -0
  48. package/.claude/agents/engineering-desktop-app-engineer.md +209 -0
  49. package/.claude/agents/engineering-developer-tooling-engineer.md +153 -0
  50. package/.claude/agents/engineering-devops-automator.md +385 -0
  51. package/.claude/agents/engineering-drupal-performance.md +347 -0
  52. package/.claude/agents/engineering-drupal-shopping-cart.md +360 -0
  53. package/.claude/agents/engineering-electrical-engineer.md +575 -0
  54. package/.claude/agents/engineering-email-intelligence-engineer.md +390 -0
  55. package/.claude/agents/engineering-embedded-firmware-engineer.md +196 -0
  56. package/.claude/agents/engineering-feishu-integration-developer.md +606 -0
  57. package/.claude/agents/engineering-filament-optimization-specialist.md +283 -0
  58. package/.claude/agents/engineering-finops-engineer.md +164 -0
  59. package/.claude/agents/engineering-frontend-developer.md +257 -0
  60. package/.claude/agents/engineering-gaussdb-expert.md +334 -0
  61. package/.claude/agents/engineering-git-workflow-master.md +98 -0
  62. package/.claude/agents/engineering-i18n-engineer.md +214 -0
  63. package/.claude/agents/engineering-identity-access-engineer.md +217 -0
  64. package/.claude/agents/engineering-incident-response-commander.md +444 -0
  65. package/.claude/agents/engineering-iot-fleet-engineer.md +148 -0
  66. package/.claude/agents/engineering-it-service-manager.md +561 -0
  67. package/.claude/agents/engineering-knowledge-graph-engineer.md +372 -0
  68. package/.claude/agents/engineering-llm-post-training-engineer.md +166 -0
  69. package/.claude/agents/engineering-minimal-change-engineer.md +207 -0
  70. package/.claude/agents/engineering-mobile-app-builder.md +493 -0
  71. package/.claude/agents/engineering-mobile-release-engineer.md +164 -0
  72. package/.claude/agents/engineering-multi-agent-systems-architect.md +600 -0
  73. package/.claude/agents/engineering-network-engineer.md +245 -0
  74. package/.claude/agents/engineering-orgscript-engineer.md +113 -0
  75. package/.claude/agents/engineering-payments-billing-engineer.md +228 -0
  76. package/.claude/agents/engineering-pdf-engine-architect.md +696 -0
  77. package/.claude/agents/engineering-platform-engineer.md +270 -0
  78. package/.claude/agents/engineering-privacy-engineer.md +152 -0
  79. package/.claude/agents/engineering-prompt-engineer.md +209 -0
  80. package/.claude/agents/engineering-rag-pipeline-engineer.md +450 -0
  81. package/.claude/agents/engineering-rapid-prototyper.md +466 -0
  82. package/.claude/agents/engineering-realtime-collaboration-engineer.md +200 -0
  83. package/.claude/agents/engineering-rust-refactoring-specialist.md +313 -0
  84. package/.claude/agents/engineering-search-relevance-engineer.md +237 -0
  85. package/.claude/agents/engineering-section-508-specialist.md +339 -0
  86. package/.claude/agents/engineering-senior-developer.md +176 -0
  87. package/.claude/agents/engineering-servicenow-developer-mentor.md +180 -0
  88. package/.claude/agents/engineering-software-architect.md +112 -0
  89. package/.claude/agents/engineering-solidity-smart-contract-engineer.md +522 -0
  90. package/.claude/agents/engineering-sre.md +90 -0
  91. package/.claude/agents/engineering-technical-writer.md +393 -0
  92. package/.claude/agents/engineering-universal-document-compiler.md +370 -0
  93. package/.claude/agents/engineering-uswds-developer.md +340 -0
  94. package/.claude/agents/engineering-video-streaming-engineer.md +151 -0
  95. package/.claude/agents/engineering-voice-ai-integration-engineer.md +584 -0
  96. package/.claude/agents/engineering-webassembly-engineer.md +153 -0
  97. package/.claude/agents/engineering-wechat-mini-program-developer.md +356 -0
  98. package/.claude/agents/engineering-wordpress-performance.md +346 -0
  99. package/.claude/agents/engineering-wordpress-shopping-cart.md +346 -0
  100. package/.claude/agents/esg-sustainability-officer.md +396 -0
  101. package/.claude/agents/finance-bookkeeper-controller.md +260 -0
  102. package/.claude/agents/finance-financial-analyst.md +234 -0
  103. package/.claude/agents/finance-fpa-analyst.md +263 -0
  104. package/.claude/agents/finance-investment-researcher.md +272 -0
  105. package/.claude/agents/finance-tax-strategist.md +239 -0
  106. package/.claude/agents/game-audio-engineer.md +264 -0
  107. package/.claude/agents/game-designer.md +167 -0
  108. package/.claude/agents/gis-3d-scene-developer.md +111 -0
  109. package/.claude/agents/gis-analyst.md +91 -0
  110. package/.claude/agents/gis-bim-specialist.md +108 -0
  111. package/.claude/agents/gis-cartography-designer.md +150 -0
  112. package/.claude/agents/gis-drone-reality-mapping.md +120 -0
  113. package/.claude/agents/gis-geoai-ml-engineer.md +105 -0
  114. package/.claude/agents/gis-geoprocessing-specialist.md +97 -0
  115. package/.claude/agents/gis-qa-engineer.md +133 -0
  116. package/.claude/agents/gis-solution-engineer.md +101 -0
  117. package/.claude/agents/gis-spatial-data-engineer.md +97 -0
  118. package/.claude/agents/gis-spatial-data-scientist.md +111 -0
  119. package/.claude/agents/gis-technical-consultant.md +86 -0
  120. package/.claude/agents/gis-web-gis-developer.md +108 -0
  121. package/.claude/agents/godot-gameplay-scripter.md +338 -0
  122. package/.claude/agents/godot-multiplayer-engineer.md +301 -0
  123. package/.claude/agents/godot-shader-developer.md +267 -0
  124. package/.claude/agents/government-digital-presales-consultant.md +363 -0
  125. package/.claude/agents/grant-writer.md +511 -0
  126. package/.claude/agents/healthcare-aging-parent-care-companion.md +414 -0
  127. package/.claude/agents/healthcare-clinical-evidence-agent.md +231 -0
  128. package/.claude/agents/healthcare-customer-service.md +389 -0
  129. package/.claude/agents/healthcare-innovation-strategist.md +433 -0
  130. package/.claude/agents/healthcare-marketing-compliance.md +395 -0
  131. package/.claude/agents/healthcare-sovereign-health-systems-agent.md +312 -0
  132. package/.claude/agents/hospitality-guest-services.md +603 -0
  133. package/.claude/agents/hr-onboarding.md +451 -0
  134. package/.claude/agents/identity-graph-operator.md +303 -0
  135. package/.claude/agents/language-translator.md +264 -0
  136. package/.claude/agents/legal-billing-time-tracking.md +569 -0
  137. package/.claude/agents/legal-client-intake.md +492 -0
  138. package/.claude/agents/legal-document-review.md +454 -0
  139. package/.claude/agents/level-designer.md +208 -0
  140. package/.claude/agents/loan-officer-assistant.md +555 -0
  141. package/.claude/agents/lsp-index-engineer.md +320 -0
  142. package/.claude/agents/ma-integration-manager.md +427 -0
  143. package/.claude/agents/macos-spatial-metal-engineer.md +337 -0
  144. package/.claude/agents/marketing-aeo-foundations.md +264 -0
  145. package/.claude/agents/marketing-agentic-search-optimizer.md +279 -0
  146. package/.claude/agents/marketing-ai-citation-strategist.md +172 -0
  147. package/.claude/agents/marketing-app-store-optimizer.md +321 -0
  148. package/.claude/agents/marketing-baidu-seo-specialist.md +226 -0
  149. package/.claude/agents/marketing-bilibili-content-strategist.md +199 -0
  150. package/.claude/agents/marketing-book-co-author.md +110 -0
  151. package/.claude/agents/marketing-carousel-growth-engine.md +204 -0
  152. package/.claude/agents/marketing-china-ecommerce-operator.md +283 -0
  153. package/.claude/agents/marketing-china-market-localization-strategist.md +283 -0
  154. package/.claude/agents/marketing-content-creator.md +54 -0
  155. package/.claude/agents/marketing-cross-border-ecommerce.md +259 -0
  156. package/.claude/agents/marketing-developer-community-builder.md +285 -0
  157. package/.claude/agents/marketing-douyin-strategist.md +149 -0
  158. package/.claude/agents/marketing-email-strategist.md +249 -0
  159. package/.claude/agents/marketing-global-podcast-strategist.md +206 -0
  160. package/.claude/agents/marketing-growth-hacker.md +54 -0
  161. package/.claude/agents/marketing-instagram-curator.md +113 -0
  162. package/.claude/agents/marketing-kuaishou-strategist.md +223 -0
  163. package/.claude/agents/marketing-linkedin-content-creator.md +214 -0
  164. package/.claude/agents/marketing-livestream-commerce-coach.md +305 -0
  165. package/.claude/agents/marketing-multi-platform-publisher.md +217 -0
  166. package/.claude/agents/marketing-podcast-strategist.md +277 -0
  167. package/.claude/agents/marketing-pr-communications-manager.md +473 -0
  168. package/.claude/agents/marketing-private-domain-operator.md +308 -0
  169. package/.claude/agents/marketing-reddit-community-builder.md +123 -0
  170. package/.claude/agents/marketing-seo-specialist.md +370 -0
  171. package/.claude/agents/marketing-short-video-editing-coach.md +412 -0
  172. package/.claude/agents/marketing-social-media-strategist.md +125 -0
  173. package/.claude/agents/marketing-tiktok-strategist.md +125 -0
  174. package/.claude/agents/marketing-twitter-engager.md +126 -0
  175. package/.claude/agents/marketing-video-optimization-specialist.md +119 -0
  176. package/.claude/agents/marketing-wechat-official-account.md +145 -0
  177. package/.claude/agents/marketing-weibo-strategist.md +240 -0
  178. package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +161 -0
  179. package/.claude/agents/marketing-xiaohongshu-specialist.md +138 -0
  180. package/.claude/agents/marketing-zhihu-strategist.md +162 -0
  181. package/.claude/agents/medical-billing-coding-specialist.md +491 -0
  182. package/.claude/agents/narrative-designer.md +243 -0
  183. package/.claude/agents/operations-manager.md +399 -0
  184. package/.claude/agents/organizational-psychologist.md +391 -0
  185. package/.claude/agents/paid-media-auditor.md +71 -0
  186. package/.claude/agents/paid-media-creative-strategist.md +71 -0
  187. package/.claude/agents/paid-media-paid-social-strategist.md +71 -0
  188. package/.claude/agents/paid-media-ppc-strategist.md +71 -0
  189. package/.claude/agents/paid-media-programmatic-buyer.md +71 -0
  190. package/.claude/agents/paid-media-search-query-analyst.md +71 -0
  191. package/.claude/agents/paid-media-tracking-specialist.md +71 -0
  192. package/.claude/agents/personal-growth-mentor.md +159 -0
  193. package/.claude/agents/product-behavioral-nudge-engine.md +83 -0
  194. package/.claude/agents/product-dx-engineer.md +332 -0
  195. package/.claude/agents/product-feedback-synthesizer.md +119 -0
  196. package/.claude/agents/product-manager.md +469 -0
  197. package/.claude/agents/product-sprint-prioritizer.md +154 -0
  198. package/.claude/agents/product-trend-researcher.md +159 -0
  199. package/.claude/agents/project-management-experiment-tracker.md +198 -0
  200. package/.claude/agents/project-management-jira-workflow-steward.md +233 -0
  201. package/.claude/agents/project-management-meeting-notes-specialist.md +95 -0
  202. package/.claude/agents/project-management-project-shepherd.md +194 -0
  203. package/.claude/agents/project-management-studio-operations.md +200 -0
  204. package/.claude/agents/project-management-studio-producer.md +203 -0
  205. package/.claude/agents/project-manager-senior.md +135 -0
  206. package/.claude/agents/real-estate-buyer-seller.md +596 -0
  207. package/.claude/agents/recruitment-specialist.md +515 -0
  208. package/.claude/agents/report-distribution-agent.md +65 -0
  209. package/.claude/agents/research-synthesist.md +136 -0
  210. package/.claude/agents/resume-tailor.md +230 -0
  211. package/.claude/agents/retail-customer-returns.md +566 -0
  212. package/.claude/agents/roblox-avatar-creator.md +297 -0
  213. package/.claude/agents/roblox-experience-designer.md +306 -0
  214. package/.claude/agents/roblox-systems-scripter.md +332 -0
  215. package/.claude/agents/sales-account-strategist.md +227 -0
  216. package/.claude/agents/sales-coach.md +271 -0
  217. package/.claude/agents/sales-data-extraction-agent.md +67 -0
  218. package/.claude/agents/sales-deal-strategist.md +180 -0
  219. package/.claude/agents/sales-discovery-coach.md +225 -0
  220. package/.claude/agents/sales-engineer.md +182 -0
  221. package/.claude/agents/sales-offer-lead-gen-strategist.md +257 -0
  222. package/.claude/agents/sales-outbound-strategist.md +201 -0
  223. package/.claude/agents/sales-outreach.md +425 -0
  224. package/.claude/agents/sales-pipeline-analyst.md +267 -0
  225. package/.claude/agents/sales-proposal-strategist.md +217 -0
  226. package/.claude/agents/security-ai-generated-code-auditor.md +207 -0
  227. package/.claude/agents/security-appsec-engineer.md +536 -0
  228. package/.claude/agents/security-architect.md +307 -0
  229. package/.claude/agents/security-blockchain-security-auditor.md +482 -0
  230. package/.claude/agents/security-cloud-security-architect.md +576 -0
  231. package/.claude/agents/security-compliance-auditor.md +158 -0
  232. package/.claude/agents/security-incident-responder.md +450 -0
  233. package/.claude/agents/security-penetration-tester.md +399 -0
  234. package/.claude/agents/security-secrets-credential-engineer.md +189 -0
  235. package/.claude/agents/security-senior-secops.md +760 -0
  236. package/.claude/agents/security-threat-detection-engineer.md +553 -0
  237. package/.claude/agents/security-threat-intelligence-analyst.md +661 -0
  238. package/.claude/agents/specialized-chief-of-staff.md +279 -0
  239. package/.claude/agents/specialized-civil-engineer.md +356 -0
  240. package/.claude/agents/specialized-codebase-archaeologist.md +341 -0
  241. package/.claude/agents/specialized-cultural-intelligence-strategist.md +88 -0
  242. package/.claude/agents/specialized-developer-advocate.md +317 -0
  243. package/.claude/agents/specialized-document-generator.md +55 -0
  244. package/.claude/agents/specialized-fedramp-rmf-compliance.md +378 -0
  245. package/.claude/agents/specialized-focus-music-architect.md +175 -0
  246. package/.claude/agents/specialized-french-consulting-market.md +194 -0
  247. package/.claude/agents/specialized-korean-business-navigator.md +216 -0
  248. package/.claude/agents/specialized-master-plan-architect.md +157 -0
  249. package/.claude/agents/specialized-mcp-builder.md +260 -0
  250. package/.claude/agents/specialized-model-qa.md +528 -0
  251. package/.claude/agents/specialized-pricing-analyst.md +243 -0
  252. package/.claude/agents/specialized-salesforce-architect.md +182 -0
  253. package/.claude/agents/specialized-strategy-duel-agent.md +130 -0
  254. package/.claude/agents/specialized-workflow-architect.md +597 -0
  255. package/.claude/agents/study-abroad-advisor.md +282 -0
  256. package/.claude/agents/supply-chain-strategist.md +591 -0
  257. package/.claude/agents/support-analytics-reporter.md +387 -0
  258. package/.claude/agents/support-executive-summary-generator.md +212 -0
  259. package/.claude/agents/support-finance-tracker.md +480 -0
  260. package/.claude/agents/support-infrastructure-maintainer.md +628 -0
  261. package/.claude/agents/support-legal-compliance-checker.md +591 -0
  262. package/.claude/agents/support-support-responder.md +607 -0
  263. package/.claude/agents/technical-artist.md +233 -0
  264. package/.claude/agents/terminal-integration-specialist.md +70 -0
  265. package/.claude/agents/testing-accessibility-auditor.md +327 -0
  266. package/.claude/agents/testing-api-tester.md +334 -0
  267. package/.claude/agents/testing-evidence-collector.md +210 -0
  268. package/.claude/agents/testing-performance-benchmarker.md +283 -0
  269. package/.claude/agents/testing-reality-checker.md +249 -0
  270. package/.claude/agents/testing-test-automation-engineer.md +196 -0
  271. package/.claude/agents/testing-test-results-analyzer.md +330 -0
  272. package/.claude/agents/testing-tool-evaluator.md +416 -0
  273. package/.claude/agents/testing-workflow-optimizer.md +463 -0
  274. package/.claude/agents/unity-architect.md +271 -0
  275. package/.claude/agents/unity-editor-tool-developer.md +310 -0
  276. package/.claude/agents/unity-multiplayer-engineer.md +323 -0
  277. package/.claude/agents/unity-shader-graph-artist.md +269 -0
  278. package/.claude/agents/unreal-multiplayer-architect.md +364 -0
  279. package/.claude/agents/unreal-systems-engineer.md +322 -0
  280. package/.claude/agents/unreal-technical-artist.md +256 -0
  281. package/.claude/agents/unreal-world-builder.md +273 -0
  282. package/.claude/agents/visionos-spatial-engineer.md +54 -0
  283. package/.claude/agents/xr-cockpit-interaction-specialist.md +32 -0
  284. package/.claude/agents/xr-immersive-developer.md +32 -0
  285. package/.claude/agents/xr-interface-architect.md +32 -0
  286. package/.claude/agents/zk-steward.md +211 -0
  287. package/.claude-plugin/marketplace.json +30 -0
  288. package/.commitlintrc.json +26 -0
  289. package/.devcontainer/Dockerfile +24 -0
  290. package/.devcontainer/devcontainer.json +70 -0
  291. package/.devcontainer/docker-compose.memory.yml +42 -0
  292. package/.devcontainer/memory-stack/devcontainer.json +84 -0
  293. package/.devcontainer/post-create.sh +83 -0
  294. package/.dockerignore +23 -0
  295. package/.env.act.example +15 -0
  296. package/.env.example +171 -0
  297. package/.eslintrc.json +16 -0
  298. package/.git-blame-ignore-revs +10 -0
  299. package/.gitattributes +2 -0
  300. package/.gitguardian.yaml +50 -0
  301. package/.githooks/pre-commit +6 -0
  302. package/.pre-commit-config.yaml +30 -0
  303. package/.release-please-config-xithead.json +22 -0
  304. package/.release-please-config.json +44 -0
  305. package/.release-please-manifest-xithead.json +3 -0
  306. package/.release-please-manifest.json +3 -0
  307. package/CODE_OF_CONDUCT.md +133 -0
  308. package/CONTRIBUTING.md +133 -0
  309. package/Cargo.lock +5557 -0
  310. package/Cargo.toml +121 -0
  311. package/Dockerfile +38 -0
  312. package/Dockerfile.proxy +48 -0
  313. package/ENTERPRISE.md +5 -0
  314. package/FEATURES_ADVANCED.md +311 -0
  315. package/Headroom-2.gif +0 -0
  316. package/HeadroomDemo-Fast.gif +0 -0
  317. package/MANIFEST.in +4 -0
  318. package/MODERNIZATION_GUIDE.md +358 -0
  319. package/Makefile +140 -0
  320. package/NOTICE +43 -0
  321. package/NPM_TOKEN_SETUP.md +81 -0
  322. package/PR.md +170 -0
  323. package/PUBLISH.md +77 -0
  324. package/README.md +58 -137
  325. package/README_FRONTEND.md +196 -0
  326. package/REALIGNMENT/00-overview.md +53 -0
  327. package/REALIGNMENT/01-bug-list.md +421 -0
  328. package/REALIGNMENT/02-architecture.md +322 -0
  329. package/REALIGNMENT/03-phase-A-lockdown.md +420 -0
  330. package/REALIGNMENT/04-phase-B-live-zone.md +470 -0
  331. package/REALIGNMENT/05-phase-C-rust-proxy.md +329 -0
  332. package/REALIGNMENT/06-phase-D-bedrock-vertex.md +222 -0
  333. package/REALIGNMENT/07-phase-E-cache-stabilization.md +338 -0
  334. package/REALIGNMENT/08-phase-F-auth-mode.md +254 -0
  335. package/REALIGNMENT/09-phase-G-rtk-observability.md +194 -0
  336. package/REALIGNMENT/10-phase-H-python-retirement.md +214 -0
  337. package/REALIGNMENT/11-phase-I-test-infra.md +385 -0
  338. package/REALIGNMENT/12-decisions-needed.md +196 -0
  339. package/REALIGNMENT/INDEX.md +82 -0
  340. package/REFACTORING_CAMPAIGN.md +277 -0
  341. package/RESTRUCTURE_PLAN.md +100 -0
  342. package/RUST_DEV.md +361 -0
  343. package/SECURITY.md +65 -0
  344. package/SETUP_AUTO_PUBLISH.md +164 -0
  345. package/TESTING-copilot-subscription.md +153 -0
  346. package/app/api/config/route.ts +22 -0
  347. package/app/api/export/route.ts +83 -0
  348. package/app/api/models/route.ts +12 -0
  349. package/app/api/stats/route.ts +46 -0
  350. package/app/dashboard/page.tsx +445 -0
  351. package/app/globals.css +35 -0
  352. package/app/installation/page.tsx +293 -0
  353. package/app/layout.tsx +35 -0
  354. package/app/master-design-system.css +2076 -0
  355. package/app/master-design-system.source.css +8 -0
  356. package/app/page.tsx +187 -0
  357. package/app/rechtliches/agb/page.tsx +165 -0
  358. package/app/rechtliches/datenschutz/page.tsx +128 -0
  359. package/app/rechtliches/impressum/page.tsx +122 -0
  360. package/app/rechtliches/widerruf/page.tsx +185 -0
  361. package/bin/xithead.js +264 -0
  362. package/codecov.yml +34 -0
  363. package/components/layout/AppShell.tsx +25 -0
  364. package/components/layout/Footer.tsx +120 -0
  365. package/components/layout/Header.tsx +145 -0
  366. package/components/marketing/LegalHighlights.tsx +45 -0
  367. package/components/marketing/LegalPageShell.tsx +49 -0
  368. package/components/marketing/LegalPanel.tsx +41 -0
  369. package/components/marketing/index.ts +3 -0
  370. package/crates/headroom-core/Cargo.toml +165 -0
  371. package/crates/headroom-core/benches/auth_mode.rs +74 -0
  372. package/crates/headroom-core/benches/ccr_store.rs +224 -0
  373. package/crates/headroom-core/benches/tokenizer.rs +52 -0
  374. package/crates/headroom-core/config/pipeline.toml +151 -0
  375. package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +9 -0
  376. package/crates/headroom-core/src/auth_mode.rs +250 -0
  377. package/crates/headroom-core/src/cache_control.rs +414 -0
  378. package/crates/headroom-core/src/ccr/backends/in_memory.rs +317 -0
  379. package/crates/headroom-core/src/ccr/backends/mod.rs +152 -0
  380. package/crates/headroom-core/src/ccr/backends/redis.rs +146 -0
  381. package/crates/headroom-core/src/ccr/backends/sqlite.rs +205 -0
  382. package/crates/headroom-core/src/ccr/mod.rs +119 -0
  383. package/crates/headroom-core/src/compression_policy.rs +505 -0
  384. package/crates/headroom-core/src/lib.rs +33 -0
  385. package/crates/headroom-core/src/relevance/base.rs +139 -0
  386. package/crates/headroom-core/src/relevance/bm25.rs +385 -0
  387. package/crates/headroom-core/src/relevance/embedding.rs +354 -0
  388. package/crates/headroom-core/src/relevance/hybrid.rs +364 -0
  389. package/crates/headroom-core/src/relevance/mod.rs +64 -0
  390. package/crates/headroom-core/src/signals/keyword_detector.rs +433 -0
  391. package/crates/headroom-core/src/signals/line_importance.rs +84 -0
  392. package/crates/headroom-core/src/signals/mod.rs +61 -0
  393. package/crates/headroom-core/src/signals/tiered.rs +141 -0
  394. package/crates/headroom-core/src/tokenizer/estimator.rs +152 -0
  395. package/crates/headroom-core/src/tokenizer/hf_impl.rs +314 -0
  396. package/crates/headroom-core/src/tokenizer/mod.rs +56 -0
  397. package/crates/headroom-core/src/tokenizer/registry.rs +342 -0
  398. package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +265 -0
  399. package/crates/headroom-core/src/transforms/adaptive_sizer.rs +610 -0
  400. package/crates/headroom-core/src/transforms/anchor_selector.rs +1189 -0
  401. package/crates/headroom-core/src/transforms/content_detector.rs +769 -0
  402. package/crates/headroom-core/src/transforms/detection.rs +222 -0
  403. package/crates/headroom-core/src/transforms/diff_compressor.rs +1685 -0
  404. package/crates/headroom-core/src/transforms/live_zone.rs +2967 -0
  405. package/crates/headroom-core/src/transforms/log_compressor.rs +1295 -0
  406. package/crates/headroom-core/src/transforms/magika_detector.rs +395 -0
  407. package/crates/headroom-core/src/transforms/mod.rs +64 -0
  408. package/crates/headroom-core/src/transforms/pipeline/config.rs +331 -0
  409. package/crates/headroom-core/src/transforms/pipeline/mod.rs +103 -0
  410. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +524 -0
  411. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +279 -0
  412. package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +400 -0
  413. package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +284 -0
  414. package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +34 -0
  415. package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +331 -0
  416. package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +848 -0
  417. package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +175 -0
  418. package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +545 -0
  419. package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +12 -0
  420. package/crates/headroom-core/src/transforms/pipeline/traits.rs +338 -0
  421. package/crates/headroom-core/src/transforms/recommendations.rs +329 -0
  422. package/crates/headroom-core/src/transforms/safety.rs +215 -0
  423. package/crates/headroom-core/src/transforms/search_compressor.rs +902 -0
  424. package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +1262 -0
  425. package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +407 -0
  426. package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +263 -0
  427. package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +214 -0
  428. package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +283 -0
  429. package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +733 -0
  430. package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +961 -0
  431. package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +252 -0
  432. package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +127 -0
  433. package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +397 -0
  434. package/crates/headroom-core/src/transforms/smart_crusher/config.rs +173 -0
  435. package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +159 -0
  436. package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +1665 -0
  437. package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +865 -0
  438. package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +77 -0
  439. package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +393 -0
  440. package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +72 -0
  441. package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +81 -0
  442. package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +66 -0
  443. package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +459 -0
  444. package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +507 -0
  445. package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +904 -0
  446. package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +510 -0
  447. package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +287 -0
  448. package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +203 -0
  449. package/crates/headroom-core/src/transforms/smart_crusher/types.rs +263 -0
  450. package/crates/headroom-core/src/transforms/tag_protector.rs +1272 -0
  451. package/crates/headroom-core/src/transforms/unidiff_detector.rs +232 -0
  452. package/crates/headroom-parity/Cargo.toml +26 -0
  453. package/crates/headroom-parity/examples/diff_fixture.rs +66 -0
  454. package/crates/headroom-parity/src/bin/parity_run.rs +78 -0
  455. package/crates/headroom-parity/src/lib.rs +613 -0
  456. package/crates/headroom-proxy/Cargo.toml +119 -0
  457. package/crates/headroom-proxy/data/model_prices_and_context_window.json +39767 -0
  458. package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +192 -0
  459. package/crates/headroom-proxy/src/bedrock/envelope.rs +239 -0
  460. package/crates/headroom-proxy/src/bedrock/eventstream.rs +769 -0
  461. package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +459 -0
  462. package/crates/headroom-proxy/src/bedrock/invoke.rs +735 -0
  463. package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +1098 -0
  464. package/crates/headroom-proxy/src/bedrock/mod.rs +66 -0
  465. package/crates/headroom-proxy/src/bedrock/sigv4.rs +324 -0
  466. package/crates/headroom-proxy/src/bedrock/vendor.rs +82 -0
  467. package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +698 -0
  468. package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +683 -0
  469. package/crates/headroom-proxy/src/cache_stabilization/mod.rs +61 -0
  470. package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +600 -0
  471. package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +514 -0
  472. package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +720 -0
  473. package/crates/headroom-proxy/src/compression/anthropic.rs +92 -0
  474. package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +1311 -0
  475. package/crates/headroom-proxy/src/compression/live_zone_openai.rs +660 -0
  476. package/crates/headroom-proxy/src/compression/live_zone_responses.rs +678 -0
  477. package/crates/headroom-proxy/src/compression/mod.rs +127 -0
  478. package/crates/headroom-proxy/src/compression/model_limits.rs +211 -0
  479. package/crates/headroom-proxy/src/config.rs +646 -0
  480. package/crates/headroom-proxy/src/error.rs +69 -0
  481. package/crates/headroom-proxy/src/handlers/chat_completions.rs +100 -0
  482. package/crates/headroom-proxy/src/handlers/conversations.rs +241 -0
  483. package/crates/headroom-proxy/src/handlers/mod.rs +13 -0
  484. package/crates/headroom-proxy/src/handlers/responses.rs +256 -0
  485. package/crates/headroom-proxy/src/headers.rs +288 -0
  486. package/crates/headroom-proxy/src/health.rs +41 -0
  487. package/crates/headroom-proxy/src/lib.rs +21 -0
  488. package/crates/headroom-proxy/src/main.rs +141 -0
  489. package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +340 -0
  490. package/crates/headroom-proxy/src/observability/compression_ratio.rs +158 -0
  491. package/crates/headroom-proxy/src/observability/metric_names.rs +174 -0
  492. package/crates/headroom-proxy/src/observability/mod.rs +68 -0
  493. package/crates/headroom-proxy/src/observability/prometheus.rs +394 -0
  494. package/crates/headroom-proxy/src/observability/proxy_metrics.rs +368 -0
  495. package/crates/headroom-proxy/src/proxy.rs +1619 -0
  496. package/crates/headroom-proxy/src/responses_items.rs +565 -0
  497. package/crates/headroom-proxy/src/sse/anthropic.rs +415 -0
  498. package/crates/headroom-proxy/src/sse/framing.rs +366 -0
  499. package/crates/headroom-proxy/src/sse/mod.rs +40 -0
  500. package/crates/headroom-proxy/src/sse/openai_chat.rs +231 -0
  501. package/crates/headroom-proxy/src/sse/openai_responses.rs +458 -0
  502. package/crates/headroom-proxy/src/vertex/adc.rs +315 -0
  503. package/crates/headroom-proxy/src/vertex/envelope.rs +167 -0
  504. package/crates/headroom-proxy/src/vertex/mod.rs +277 -0
  505. package/crates/headroom-proxy/src/vertex/raw_predict.rs +490 -0
  506. package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +49 -0
  507. package/crates/headroom-proxy/src/websocket.rs +246 -0
  508. package/crates/headroom-py/Cargo.toml +37 -0
  509. package/crates/headroom-py/build.rs +77 -0
  510. package/crates/headroom-py/glibc_compat.c +170 -0
  511. package/crates/headroom-py/src/lib.rs +1655 -0
  512. package/deny.toml +32 -0
  513. package/design-system/base.css +127 -0
  514. package/design-system/components.css +1943 -0
  515. package/design-system/fonts.css +17 -0
  516. package/design-system/tailwind-preset.js +95 -0
  517. package/design-system/tokens.css +48 -0
  518. package/design-system/utilities.css +53 -0
  519. package/docker/differential-network-capture/Dockerfile.runner +14 -0
  520. package/docker/differential-network-capture/docker-compose.yml +142 -0
  521. package/docker/differential-network-capture/run-claude-lane.sh +24 -0
  522. package/docker/docker-compose.native.yml +44 -0
  523. package/docker-bake.hcl +88 -0
  524. package/docker-compose.yml +80 -0
  525. package/e2e/_lib/make_shim.ps1 +24 -0
  526. package/e2e/_lib/make_shim.sh +28 -0
  527. package/e2e/docker-native-install.sh +120 -0
  528. package/e2e/init/Dockerfile +79 -0
  529. package/e2e/wrap/Dockerfile +115 -0
  530. package/examples/07-context-compression.ipynb +279 -0
  531. package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +65 -0
  532. package/examples/deployment/macos-launchagent/install.sh +227 -0
  533. package/examples/deployment/macos-launchagent/shell-integration.sh +74 -0
  534. package/examples/deployment/macos-launchagent/uninstall.sh +145 -0
  535. package/headroom-savings.png +0 -0
  536. package/headroom_learn.gif +0 -0
  537. package/lib/config/index.ts +12 -0
  538. package/lib/hooks/index.ts +4 -0
  539. package/lib/hooks/use-mounted.ts +13 -0
  540. package/lib/hooks/use-session.ts +34 -0
  541. package/lib/hooks/use-settings.ts +49 -0
  542. package/lib/utils/index.ts +1 -0
  543. package/lib/utils/settings.ts +162 -0
  544. package/lib/utils/utils.ts +6 -0
  545. package/llms.txt +67 -0
  546. package/middleware.ts +26 -0
  547. package/mkdocs.yml +136 -0
  548. package/next-env.d.ts +7 -0
  549. package/next.config.ts +12 -0
  550. package/npm/bin/xithead.js +2 -2
  551. package/npm/bin/xtream-head.js +366 -0
  552. package/npm/index.js +18 -91
  553. package/npm/package.json +55 -0
  554. package/package.json +47 -42
  555. package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +17 -0
  556. package/plugins/headroom-agent-hooks/hooks/hooks.json +29 -0
  557. package/plugins/headroom-oauth2/LICENSE +3 -0
  558. package/plugins/headroom-oauth2/SPEC.md +115 -0
  559. package/plugins/headroom-oauth2/pyproject.toml +48 -0
  560. package/plugins/hermes/headroom_retrieve/plugin.yaml +6 -0
  561. package/plugins/openclaw/hook-shim/HOOK.md +21 -0
  562. package/plugins/openclaw/hook-shim/handler.js +3 -0
  563. package/plugins/openclaw/openclaw.plugin.json +98 -0
  564. package/plugins/openclaw/package-lock.json +2692 -0
  565. package/plugins/openclaw/package.json +54 -0
  566. package/plugins/openclaw/prepare-dist.mjs +56 -0
  567. package/plugins/openclaw/src/convert.ts +418 -0
  568. package/plugins/openclaw/src/engine.ts +284 -0
  569. package/plugins/openclaw/src/gateway-config.ts +143 -0
  570. package/plugins/openclaw/src/index.ts +11 -0
  571. package/plugins/openclaw/src/plugin/index.ts +98 -0
  572. package/plugins/openclaw/src/proxy-manager.ts +477 -0
  573. package/plugins/openclaw/src/tools/headroom-retrieve.ts +76 -0
  574. package/plugins/openclaw/test/convert.test.ts +96 -0
  575. package/plugins/openclaw/test/engine-normalization.test.ts +21 -0
  576. package/plugins/openclaw/test/engine.test.ts +101 -0
  577. package/plugins/openclaw/test/gateway-config.test.ts +278 -0
  578. package/plugins/openclaw/test/plugin-runtime-routing.test.ts +141 -0
  579. package/plugins/openclaw/test/proxy-manager.test.ts +343 -0
  580. package/plugins/openclaw/tsup.config.ts +9 -0
  581. package/postcss.config.mjs +7 -0
  582. package/pyproject.toml +438 -0
  583. package/rust-toolchain.toml +16 -0
  584. package/sdk/typescript/examples/basic-compress.ts +64 -0
  585. package/sdk/typescript/examples/ccr-retrieve.ts +80 -0
  586. package/sdk/typescript/examples/hooks-custom-compression.ts +117 -0
  587. package/sdk/typescript/examples/middleware-composition.ts +59 -0
  588. package/sdk/typescript/examples/multi-provider.ts +53 -0
  589. package/sdk/typescript/examples/openai-anthropic-adapters.ts +73 -0
  590. package/sdk/typescript/examples/shared-context-multi-agent.ts +74 -0
  591. package/sdk/typescript/examples/simulation-dry-run.ts +80 -0
  592. package/sdk/typescript/examples/streaming-chat.ts +71 -0
  593. package/sdk/typescript/examples/structured-output.ts +99 -0
  594. package/sdk/typescript/examples/tool-calling-agent.ts +86 -0
  595. package/sdk/typescript/examples/with-headroom-vercel.ts +57 -0
  596. package/sdk/typescript/package-lock.json +3437 -0
  597. package/sdk/typescript/package.json +108 -0
  598. package/sdk/typescript/src/adapters/anthropic.ts +218 -0
  599. package/sdk/typescript/src/adapters/gemini.ts +83 -0
  600. package/sdk/typescript/src/adapters/openai.ts +77 -0
  601. package/sdk/typescript/src/adapters/vercel-ai.ts +131 -0
  602. package/sdk/typescript/src/client.ts +632 -0
  603. package/sdk/typescript/src/compress.ts +87 -0
  604. package/sdk/typescript/src/errors.ts +114 -0
  605. package/sdk/typescript/src/hooks.ts +113 -0
  606. package/sdk/typescript/src/index.ts +140 -0
  607. package/sdk/typescript/src/paths.ts +272 -0
  608. package/sdk/typescript/src/shared-context.ts +188 -0
  609. package/sdk/typescript/src/simulate.ts +52 -0
  610. package/sdk/typescript/src/types/config.ts +183 -0
  611. package/sdk/typescript/src/types/models.ts +314 -0
  612. package/sdk/typescript/src/types.ts +139 -0
  613. package/sdk/typescript/src/utils/case.ts +34 -0
  614. package/sdk/typescript/src/utils/format.ts +480 -0
  615. package/sdk/typescript/src/utils/stream.ts +50 -0
  616. package/sdk/typescript/test/adapters/anthropic.test.ts +217 -0
  617. package/sdk/typescript/test/adapters/gemini.test.ts +131 -0
  618. package/sdk/typescript/test/adapters/openai.test.ts +174 -0
  619. package/sdk/typescript/test/adapters/vercel-ai.test.ts +306 -0
  620. package/sdk/typescript/test/client-expanded.test.ts +333 -0
  621. package/sdk/typescript/test/client.test.ts +266 -0
  622. package/sdk/typescript/test/compress.test.ts +118 -0
  623. package/sdk/typescript/test/config.test.ts +275 -0
  624. package/sdk/typescript/test/errors.test.ts +169 -0
  625. package/sdk/typescript/test/format-integration.test.ts +252 -0
  626. package/sdk/typescript/test/hooks.test.ts +265 -0
  627. package/sdk/typescript/test/integration.test.ts +249 -0
  628. package/sdk/typescript/test/mdx-examples.test.ts +253 -0
  629. package/sdk/typescript/test/models.test.ts +318 -0
  630. package/sdk/typescript/test/parity.test.ts +337 -0
  631. package/sdk/typescript/test/paths.test.ts +447 -0
  632. package/sdk/typescript/test/shared-context.test.ts +245 -0
  633. package/sdk/typescript/test/simulate.test.ts +84 -0
  634. package/sdk/typescript/test/types.test.ts +244 -0
  635. package/sdk/typescript/test/utils/case.test.ts +129 -0
  636. package/sdk/typescript/test/utils/detect-format.test.ts +133 -0
  637. package/sdk/typescript/test/utils/format.test.ts +434 -0
  638. package/sdk/typescript/test/vercel-ai-e2e.test.ts +179 -0
  639. package/sdk/typescript/tsup.config.ts +17 -0
  640. package/tailwind.master.config.cjs +47 -0
  641. package/types/api.ts +12 -0
  642. package/types/config.ts +9 -0
  643. package/types/index.ts +2 -0
  644. package/uv.lock +6951 -0
  645. package/xithead.egg-info/PKG-INFO +22 -0
  646. package/xithead.egg-info/SOURCES.txt +16 -0
  647. package/xithead.egg-info/dependency_links.txt +1 -0
  648. package/xithead.egg-info/entry_points.txt +2 -0
  649. package/xithead.egg-info/requires.txt +10 -0
  650. package/xithead.egg-info/top_level.txt +2 -0
  651. package/xithead.ps1 +136 -0
  652. package/xithead.sh +129 -0
  653. package/xithead_dist/pyproject.toml +39 -0
  654. package/xithead_dist/xithead.egg-info/PKG-INFO +22 -0
  655. package/xithead_dist/xithead.egg-info/SOURCES.txt +16 -0
  656. package/xithead_dist/xithead.egg-info/dependency_links.txt +1 -0
  657. package/xithead_dist/xithead.egg-info/entry_points.txt +3 -0
  658. package/xithead_dist/xithead.egg-info/requires.txt +10 -0
  659. package/xithead_dist/xithead.egg-info/top_level.txt +2 -0
@@ -0,0 +1,224 @@
1
+ //! CCR store throughput benchmark — single-threaded and multi-threaded.
2
+ //!
3
+ //! Pins the win from PR9: replacing the single-`Mutex<HashMap>` design
4
+ //! with a `DashMap`-backed sharded store. The single-threaded numbers
5
+ //! should be roughly comparable (DashMap has a small per-op shard-hash
6
+ //! overhead vs a raw Mutex), but the multi-threaded numbers should
7
+ //! diverge sharply — distinct keys hit distinct shards and never
8
+ //! contend.
9
+ //!
10
+ //! Run with:
11
+ //! cargo bench -p headroom-core --bench ccr_store
12
+ //!
13
+ //! The critical numbers to watch are the `mt/N=8` rows: with the
14
+ //! Mutex design, all 8 threads serialize on one lock, so throughput
15
+ //! is ~1× the single-threaded figure. With DashMap, throughput should
16
+ //! scale near-linearly with cores.
17
+
18
+ use std::collections::{HashMap, VecDeque};
19
+ use std::sync::{Arc, Mutex};
20
+ use std::thread;
21
+ use std::time::{Duration, Instant};
22
+
23
+ use criterion::{black_box, criterion_group, criterion_main, Criterion, Throughput};
24
+ use headroom_core::ccr::{CcrStore, InMemoryCcrStore};
25
+
26
+ // ─── Baseline: the old single-Mutex<HashMap> design ────────────────
27
+ //
28
+ // Inlined here so the bench is self-contained and shows the
29
+ // before/after gap directly. Same trait, same semantics; the only
30
+ // difference is "all ops serialize on one Mutex" vs "DashMap-sharded".
31
+
32
+ struct LegacyMutexStore {
33
+ inner: Mutex<LegacyInner>,
34
+ ttl: Duration,
35
+ capacity: usize,
36
+ }
37
+
38
+ struct LegacyInner {
39
+ map: HashMap<String, LegacyEntry>,
40
+ order: VecDeque<String>,
41
+ }
42
+
43
+ struct LegacyEntry {
44
+ payload: String,
45
+ inserted: Instant,
46
+ }
47
+
48
+ impl LegacyMutexStore {
49
+ fn new(capacity: usize, ttl: Duration) -> Self {
50
+ Self {
51
+ inner: Mutex::new(LegacyInner {
52
+ map: HashMap::new(),
53
+ order: VecDeque::new(),
54
+ }),
55
+ ttl,
56
+ capacity,
57
+ }
58
+ }
59
+ }
60
+
61
+ impl CcrStore for LegacyMutexStore {
62
+ fn put(&self, hash: &str, payload: &str) {
63
+ let mut g = self.inner.lock().unwrap();
64
+ if g.map.contains_key(hash) {
65
+ g.map.insert(
66
+ hash.to_string(),
67
+ LegacyEntry {
68
+ payload: payload.to_string(),
69
+ inserted: Instant::now(),
70
+ },
71
+ );
72
+ return;
73
+ }
74
+ while g.map.len() >= self.capacity {
75
+ let Some(oldest) = g.order.pop_front() else {
76
+ break;
77
+ };
78
+ g.map.remove(&oldest);
79
+ }
80
+ g.map.insert(
81
+ hash.to_string(),
82
+ LegacyEntry {
83
+ payload: payload.to_string(),
84
+ inserted: Instant::now(),
85
+ },
86
+ );
87
+ g.order.push_back(hash.to_string());
88
+ }
89
+
90
+ fn get(&self, hash: &str) -> Option<String> {
91
+ let mut g = self.inner.lock().unwrap();
92
+ let expired = match g.map.get(hash) {
93
+ Some(e) => e.inserted.elapsed() > self.ttl,
94
+ None => return None,
95
+ };
96
+ if expired {
97
+ g.map.remove(hash);
98
+ return None;
99
+ }
100
+ g.map.get(hash).map(|e| e.payload.clone())
101
+ }
102
+
103
+ fn len(&self) -> usize {
104
+ self.inner.lock().unwrap().map.len()
105
+ }
106
+ }
107
+
108
+ fn bench_put_single_threaded(c: &mut Criterion) {
109
+ let store = InMemoryCcrStore::new();
110
+ let payload = "x".repeat(512); // typical CCR payload size
111
+
112
+ let mut group = c.benchmark_group("ccr_store/put_st");
113
+ group.throughput(Throughput::Elements(1));
114
+ group.bench_function("new_keys", |b| {
115
+ let mut i = 0u64;
116
+ b.iter(|| {
117
+ let key = format!("k{i:012x}");
118
+ store.put(black_box(&key), black_box(&payload));
119
+ i += 1;
120
+ });
121
+ });
122
+ group.bench_function("same_key_overwrite", |b| {
123
+ b.iter(|| {
124
+ store.put(black_box("hot_key"), black_box(&payload));
125
+ });
126
+ });
127
+ group.finish();
128
+ }
129
+
130
+ fn bench_get_single_threaded(c: &mut Criterion) {
131
+ let store = InMemoryCcrStore::new();
132
+ let payload = "y".repeat(512);
133
+ for i in 0..1000u32 {
134
+ let key = format!("k{i:08x}");
135
+ store.put(&key, &payload);
136
+ }
137
+
138
+ let mut group = c.benchmark_group("ccr_store/get_st");
139
+ group.throughput(Throughput::Elements(1));
140
+ group.bench_function("hit", |b| {
141
+ let mut i = 0u32;
142
+ b.iter(|| {
143
+ let key = format!("k{:08x}", i % 1000);
144
+ let _ = black_box(store.get(black_box(&key)));
145
+ i = i.wrapping_add(1);
146
+ });
147
+ });
148
+ group.bench_function("miss", |b| {
149
+ let mut i = 0u32;
150
+ b.iter(|| {
151
+ let key = format!("absent_{i}");
152
+ let _ = black_box(store.get(black_box(&key)));
153
+ i = i.wrapping_add(1);
154
+ });
155
+ });
156
+ group.finish();
157
+ }
158
+
159
+ fn run_mt_workload(store: Arc<dyn CcrStore>, threads: usize, n: u64) -> Duration {
160
+ const ITERS_PER_THREAD: usize = 200;
161
+ let payload = Arc::new("z".repeat(256));
162
+ for i in 0..256u32 {
163
+ store.put(&format!("warm_{i:08x}"), &payload);
164
+ }
165
+ let start = Instant::now();
166
+ for _ in 0..n {
167
+ thread::scope(|scope| {
168
+ for tid in 0..threads {
169
+ let s = store.clone();
170
+ let p = payload.clone();
171
+ scope.spawn(move || {
172
+ for i in 0..ITERS_PER_THREAD {
173
+ if i & 1 == 0 {
174
+ let k = format!("t{tid}_k{i:08x}");
175
+ s.put(&k, &p);
176
+ } else {
177
+ let k = format!("warm_{:08x}", i % 256);
178
+ let _ = s.get(&k);
179
+ }
180
+ }
181
+ });
182
+ }
183
+ });
184
+ }
185
+ start.elapsed()
186
+ }
187
+
188
+ /// Multi-threaded mixed put/get — direct A/B between the legacy
189
+ /// `Mutex<HashMap>` design and the new DashMap-backed store. The
190
+ /// legacy version serializes every op on one lock; the new version
191
+ /// shards across keys so distinct hashes never contend.
192
+ fn bench_mixed_multi_threaded(c: &mut Criterion) {
193
+ let mut group = c.benchmark_group("ccr_store/mt_mixed");
194
+ group.throughput(Throughput::Elements(1));
195
+
196
+ for &threads in &[1usize, 2, 4, 8] {
197
+ // DashMap-backed (current design).
198
+ let label = format!("dashmap/threads={threads}");
199
+ group.bench_function(&label, |b| {
200
+ b.iter_custom(|n| {
201
+ let store: Arc<dyn CcrStore> = Arc::new(InMemoryCcrStore::new());
202
+ run_mt_workload(store, threads, n)
203
+ });
204
+ });
205
+ // Legacy Mutex<HashMap> (the design PR9 replaces).
206
+ let label = format!("legacy_mutex/threads={threads}");
207
+ group.bench_function(&label, |b| {
208
+ b.iter_custom(|n| {
209
+ let store: Arc<dyn CcrStore> =
210
+ Arc::new(LegacyMutexStore::new(1000, Duration::from_secs(300)));
211
+ run_mt_workload(store, threads, n)
212
+ });
213
+ });
214
+ }
215
+ group.finish();
216
+ }
217
+
218
+ criterion_group!(
219
+ benches,
220
+ bench_put_single_threaded,
221
+ bench_get_single_threaded,
222
+ bench_mixed_multi_threaded,
223
+ );
224
+ criterion_main!(benches);
@@ -0,0 +1,52 @@
1
+ //! Throughput benchmark for `headroom_core::tokenizer`.
2
+ //!
3
+ //! Measures the tiktoken-rs–backed counter on a small / medium / large input.
4
+ //! Used as a baseline; future stages can compare against this to catch
5
+ //! regressions when we change tokenizer backends or add caching layers.
6
+
7
+ use criterion::{black_box, criterion_group, criterion_main, BatchSize, Criterion, Throughput};
8
+ use headroom_core::tokenizer::{TiktokenCounter, Tokenizer};
9
+
10
+ fn bench_count_text(c: &mut Criterion) {
11
+ let counter = TiktokenCounter::for_model("gpt-4o-mini").expect("init");
12
+
13
+ // Small: a typical short prompt.
14
+ let small = "Reply with exactly: PONG";
15
+ // Medium: a typical chat turn (~1KB).
16
+ let medium = "the quick brown fox jumps over the lazy dog\n".repeat(25);
17
+ // Large: a long context (~64KB) — stresses BPE inner loops.
18
+ let large = "the quick brown fox jumps over the lazy dog\n".repeat(1500);
19
+
20
+ let mut group = c.benchmark_group("tokenizer/count_text");
21
+ group.throughput(Throughput::Bytes(small.len() as u64));
22
+ group.bench_function("small", |b| {
23
+ b.iter_batched(
24
+ || small,
25
+ |s| black_box(counter.count_text(s)),
26
+ BatchSize::SmallInput,
27
+ )
28
+ });
29
+
30
+ group.throughput(Throughput::Bytes(medium.len() as u64));
31
+ group.bench_function("medium", |b| {
32
+ b.iter_batched(
33
+ || medium.as_str(),
34
+ |s| black_box(counter.count_text(s)),
35
+ BatchSize::SmallInput,
36
+ )
37
+ });
38
+
39
+ group.throughput(Throughput::Bytes(large.len() as u64));
40
+ group.bench_function("large", |b| {
41
+ b.iter_batched(
42
+ || large.as_str(),
43
+ |s| black_box(counter.count_text(s)),
44
+ BatchSize::SmallInput,
45
+ )
46
+ });
47
+
48
+ group.finish();
49
+ }
50
+
51
+ criterion_group!(benches, bench_count_text);
52
+ criterion_main!(benches);
@@ -0,0 +1,151 @@
1
+ # Compression pipeline default configuration.
2
+ #
3
+ # This file is embedded into the headroom-core binary via `include_str!`
4
+ # at build time, so a stock binary needs no external file. Production
5
+ # deployments override these defaults by loading their own TOML at
6
+ # startup via `PipelineConfig::from_str` or `from_file`.
7
+ #
8
+ # All thresholds chosen CONSERVATIVELY. The pipeline is on the hot
9
+ # path of every Claude Code / Codex / agent tool-call response — bias
10
+ # toward "don't fire CCR unless we're sure" to avoid forcing
11
+ # unnecessary retrieval round trips. A retrieval round trip costs
12
+ # tokens (the marker text), latency (the tool call), and risk (the
13
+ # LLM might not retrieve when it should).
14
+
15
+ [pipeline]
16
+ # Below this fraction of input bytes (after reformat), we consider
17
+ # the reformat phase to have "succeeded" and skip offloads UNLESS the
18
+ # bloat estimator demands them. 0.5 = "if reformat shrunk us to half
19
+ # the original, that's enough for now."
20
+ reformat_target_ratio = 0.5
21
+
22
+ # Bloat threshold above which we ALWAYS run the offload, regardless
23
+ # of reformat success. 0.5 = "if a domain-specific estimator says
24
+ # half this content is bloat, CCR offload is worth the retrieval
25
+ # cost." Conservative — most real-world tool outputs sit below 0.5.
26
+ bloat_threshold = 0.5
27
+
28
+ # After reformat, if (output_len / input_len) > this, we run offload
29
+ # transforms even if their bloat estimate is below `bloat_threshold`.
30
+ # Captures the "reformat barely helped, content might still be
31
+ # salvageable via offload" case. 0.85 = "if reformat saved less than
32
+ # 15% of bytes, try offload as a fallback."
33
+ offload_fallback_ratio = 0.85
34
+
35
+ # ─── Per-domain bloat estimator config ──────────────────────────────
36
+ #
37
+ # Each domain has its own structural-only signal for "this content
38
+ # would benefit from CCR offload." The estimators MUST be cheap (no
39
+ # full compression pass) so they run in parallel with the reformat
40
+ # phase via rayon::join.
41
+
42
+ [bloat.log]
43
+ # Inputs shorter than this in lines never trigger offload; the
44
+ # overhead of CCR retrieval would outweigh any savings. Matches
45
+ # LogCompressorConfig::min_lines_for_ccr.
46
+ min_lines = 50
47
+ # How many lines to sample when scoring importance density on long
48
+ # logs. Sampling beats full-scan because per-line keyword detection
49
+ # costs aho-corasick + word-boundary checks per call. 100 samples
50
+ # on a 10k-line log gives <1% error vs full scan.
51
+ sample_size = 100
52
+ # Lines with priority strictly above this are "high-priority" — the
53
+ # rest count as dilution. Calibrated against the signals trait's
54
+ # priority scale (errors return ~0.9, warnings ~0.7, info ~0.0).
55
+ high_priority_threshold = 0.4
56
+ # Weighted combination of two signals, summing to ≤ 1.0. The repetition
57
+ # weight catches "log full of identical INFO heartbeats"; the priority
58
+ # dilution weight catches "log full of unique-but-irrelevant lines
59
+ # burying a few errors." Production tuning may shift these.
60
+ uniqueness_weight = 0.5
61
+ priority_dilution_weight = 0.5
62
+
63
+ [bloat.diff]
64
+ # Inputs shorter than this in lines never trigger offload.
65
+ min_lines = 50
66
+ # Below this context-to-change ratio, we consider the diff dense and
67
+ # don't offload. Above, the diff is mostly context — high bloat.
68
+ # 0.6 = "60% of relevant lines are context" is the threshold.
69
+ normal_context_ratio = 0.6
70
+
71
+ [bloat.search]
72
+ # Inputs with fewer matches never trigger offload.
73
+ min_matches = 10
74
+ # Average matches per file at which we hit "fully clustered"
75
+ # bloat = 1.0. 10 matches/file means the result set is mostly
76
+ # repeated hits in the same files — ideal CCR candidate.
77
+ cluster_threshold = 10.0
78
+
79
+ # ─── Reformat configs ───────────────────────────────────────────────
80
+ #
81
+ # Reformats pack input denser without losing information. Configs here
82
+ # tune the structural-only knobs each reformat exposes.
83
+
84
+ [reformat.log_template]
85
+ # Don't bother template-mining inputs shorter than this. The cost of
86
+ # the bucket walk + table emission isn't worth it on small logs.
87
+ min_lines = 20
88
+ # Minimum consecutive lines that share a template before we collapse
89
+ # them into a "[Template: ...] (Nx)" block + variant table. Smaller
90
+ # values catch more — but 3 is the floor below which the dedup overhead
91
+ # (template header + brackets) exceeds the savings.
92
+ min_run = 3
93
+ # Two lines are "same template" if at least this fraction of their
94
+ # tokens match positionally (after token-count match). 0.4 = Drain's
95
+ # published default — matches `<TS> INFO worker-<N> processing job <N>`
96
+ # style families (where 3 of 6 tokens are constants) while rejecting
97
+ # genuinely different shapes. Pairs with `min_constant_tokens` so a
98
+ # template with too few anchor tokens won't be promoted regardless of
99
+ # how high the similarity score happens to land.
100
+ similarity_threshold = 0.4
101
+ # Floor on the number of constant tokens a template must have. A
102
+ # "template" of all-`<*>` tokens carries no readable signal — emit
103
+ # verbatim instead. 2 = "must share at least 2 anchor tokens."
104
+ min_constant_tokens = 2
105
+
106
+ # ─── JSON-array offload config (SmartCrusher wrapper) ─────────────
107
+ #
108
+ # JsonOffload wraps SmartCrusher: a JSON array of dicts (rows) with
109
+ # repeated schema is highly bloaty — most fields repeat their keys per
110
+ # row. SmartCrusher dedups, drops near-duplicate rows, and emits a CCR
111
+ # marker for retrieval. The bloat estimator below cheaply spots the
112
+ # "array-of-dicts shape with N+ rows" signal without parsing JSON.
113
+
114
+ [offload.json]
115
+ # Don't fire below this many detected row separators (`},{` boundaries
116
+ # scaled across the input). 5 = "less than 5 rows isn't worth it."
117
+ min_array_rows = 5
118
+ # At this row count, the bloat score saturates to 1.0. Tabular inputs
119
+ # with this many rows are reliably bloat-heavy candidates for CCR.
120
+ saturation_rows = 50
121
+
122
+ # ─── Diff-noise offload config ─────────────────────────────────────
123
+ #
124
+ # Drop hunks for files that match these glob-like suffixes (literal
125
+ # filename-suffix match, no globbing). Lockfiles dominate diff size in
126
+ # JS/Python/Ruby/Go projects but carry near-zero semantic value for
127
+ # LLM consumption — the version bump in the manifest already captures
128
+ # what the LLM needs to know.
129
+
130
+ [offload.diff_noise]
131
+ # Inputs shorter than this never trigger noise offload.
132
+ min_lines = 30
133
+ # Lockfile filename suffixes (case-sensitive). Match is "path ENDS
134
+ # WITH this suffix and the next char is `/` or start-of-path." Add
135
+ # project-specific lock files here without code changes.
136
+ lockfile_suffixes = [
137
+ "Cargo.lock",
138
+ "package-lock.json",
139
+ "yarn.lock",
140
+ "pnpm-lock.yaml",
141
+ "poetry.lock",
142
+ "Pipfile.lock",
143
+ "Gemfile.lock",
144
+ "go.sum",
145
+ "composer.lock",
146
+ ]
147
+ # Drop hunks where every change is whitespace-only (added/removed
148
+ # blank lines, trailing whitespace, indentation-only changes). These
149
+ # show up in formatter / linter commits and carry no signal the LLM
150
+ # needs to reason about.
151
+ drop_whitespace_only_hunks = true
@@ -0,0 +1,9 @@
1
+ # Seeds for failure cases proptest has generated in the past. It is
2
+ # automatically read and these particular cases re-run before any
3
+ # novel cases are generated.
4
+ #
5
+ # It is recommended to check this file in to source control so that
6
+ # everyone who runs the test benefits from these saved cases.
7
+ cc 8fbea33614d948018222b12893746cadfc057a807a80f3e8b63af540614d1eb0 # shrinks to content = "<a>"
8
+ cc e499bfe23a63b8a21d0d8105141c83e83a7f3a1484c19bcf5be0732c7c1bd9c3 # shrinks to content = "</"
9
+ cc 70ba971eb9c85e814763d0af359de0a4a967e8947caf837d4efe751a37292659 # shrinks to content = "</", compressed = ""
@@ -0,0 +1,250 @@
1
+ //! Auth-mode classifier — Phase F PR-F1.
2
+ //!
3
+ //! A single pure function turns the inbound request `HeaderMap` into one
4
+ //! of three classes that drive every downstream compression / cache /
5
+ //! header policy decision:
6
+ //!
7
+ //! - [`AuthMode::Payg`]: caller pays per token (Anthropic API key,
8
+ //! OpenAI `sk-...`, Gemini `x-goog-api-key`, x-api-key). Aggressive
9
+ //! compression saves them money — turn it all on.
10
+ //! - [`AuthMode::OAuth`]: caller is on a fixed-cost subscription / IAM
11
+ //! plan (Claude Pro OAuth, Codex Enterprise, Cursor Pro, Bedrock
12
+ //! IAM-signed downstream, Vertex ADC). Per-token cost is opaque to
13
+ //! them; cache-safety is paramount because OAuth scopes pin to
14
+ //! `(account, model, session)` and beta-header drift voids them.
15
+ //! - [`AuthMode::Subscription`]: caller is a UX-bound CLI / IDE
16
+ //! (Claude Code, ChatGPT Plus, Cursor, Copilot, Antigravity).
17
+ //! Provider rate-limits by request count; programmatic-fingerprint
18
+ //! detection means we MUST look like the upstream agent (preserve
19
+ //! `User-Agent`, never inject `X-Headroom-*`, never strip
20
+ //! `accept-encoding`).
21
+ //!
22
+ //! See `~/.claude/projects/.../memory/project_auth_mode_compression_nuances.md`
23
+ //! for the user-decision rationale (2026-05-01).
24
+ //!
25
+ //! The classifier is **pure** (no I/O, no allocation beyond a single
26
+ //! lowercase copy of the User-Agent), runs in <10us per call, and
27
+ //! NEVER panics on malformed headers — non-UTF-8 values fall through to
28
+ //! the safe default [`AuthMode::Payg`] with a `tracing::warn!` event so
29
+ //! operators can spot bad clients in the log stream without taking the
30
+ //! proxy down.
31
+
32
+ use http::HeaderMap;
33
+
34
+ /// Three auth-mode classes Headroom routes compression policy through.
35
+ ///
36
+ /// `Copy` because the value is passed through dozens of compression
37
+ /// decisions per request; cloning a 1-byte enum is cheaper than holding
38
+ /// a reference across `await` points. `Hash + Eq` so it can key the
39
+ /// per-tenant TOIN aggregation map (Phase F PR-F3).
40
+ #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
41
+ pub enum AuthMode {
42
+ /// Pay-as-you-go API key. Aggressive live-zone compression OK.
43
+ Payg,
44
+ /// OAuth bearer / Bedrock IAM / Vertex ADC. Passthrough-prefer:
45
+ /// no auto-`cache_control`, no auto-`prompt_cache_key`, no lossy
46
+ /// compressors. Lossless-only path.
47
+ OAuth,
48
+ /// Subscription-bound CLI / IDE. Stealth: same as OAuth +
49
+ /// preserve `accept-encoding`, never strip; never inject
50
+ /// `X-Headroom-*`; never mutate `User-Agent`.
51
+ Subscription,
52
+ }
53
+
54
+ impl AuthMode {
55
+ /// Lower-snake-case label suitable for structured-log fields and
56
+ /// metric labels. Stable wire format — Python parity tests check
57
+ /// this exact string.
58
+ pub fn as_str(self) -> &'static str {
59
+ match self {
60
+ AuthMode::Payg => "payg",
61
+ AuthMode::OAuth => "oauth",
62
+ AuthMode::Subscription => "subscription",
63
+ }
64
+ }
65
+ }
66
+
67
+ /// User-Agent prefixes that identify a UX-bound CLI / IDE.
68
+ ///
69
+ /// Lives at module scope (not inside `classify`) so:
70
+ /// 1. The compiler can constant-fold the slice into the rodata segment.
71
+ /// 2. A future PR can swap this for a configurable list (Phase F
72
+ /// follow-up) without touching the function body.
73
+ /// 3. Adding a new client = one-line edit here, no logic change.
74
+ ///
75
+ /// Match is `str::contains` against a lowercased copy of the UA — so
76
+ /// the prefix can appear anywhere in the value (Anthropic CLIs prefix
77
+ /// their own UA with the parent agent's UA in some cases).
78
+ const SUBSCRIPTION_UA_PREFIXES: &[&str] = &[
79
+ "claude-cli/",
80
+ "claude-code/",
81
+ "codex-cli/",
82
+ "cursor/",
83
+ "claude-vscode/",
84
+ "github-copilot/",
85
+ "anthropic-cli/",
86
+ "antigravity/",
87
+ ];
88
+
89
+ /// Classify the auth mode of an inbound request from its headers.
90
+ ///
91
+ /// Decision order (most-specific signal wins):
92
+ ///
93
+ /// 1. **Subscription UA prefix** → [`AuthMode::Subscription`].
94
+ /// The CLI's own auth-mode wins over the bearer token shape it
95
+ /// happens to be carrying — a Claude Code session uses a
96
+ /// `sk-ant-oat-*` token but is a subscription client, not OAuth.
97
+ /// 2. **`Authorization: Bearer sk-ant-oat-*`** → [`AuthMode::OAuth`]
98
+ /// (Claude Pro / Max OAuth). Checked before the broader `sk-` PAYG
99
+ /// rule because `sk-ant-oat-` shares the `sk-` prefix.
100
+ /// 3. **`Authorization: Bearer sk-ant-api*` or `Bearer sk-*`** →
101
+ /// [`AuthMode::Payg`] (Anthropic / OpenAI API key).
102
+ /// 4. **`Authorization: Bearer <jwt>`** (3 dot-separated segments) →
103
+ /// [`AuthMode::OAuth`] (Codex / Cursor / Copilot OAuth).
104
+ /// 5. **`Authorization` present but not `Bearer ...`** →
105
+ /// [`AuthMode::OAuth`] (AWS SigV4 `AWS4-HMAC-SHA256 ...` →
106
+ /// Bedrock; any other non-Bearer scheme is presumed
107
+ /// passthrough-prefer too).
108
+ /// 6. **`x-api-key` present** → [`AuthMode::Payg`] (Anthropic API key
109
+ /// style).
110
+ /// 7. **`x-goog-api-key` present** → [`AuthMode::Payg`] (Gemini key).
111
+ /// 8. **Default** → [`AuthMode::Payg`] (safest default; aggressive
112
+ /// compression on a misclassified request just costs us a re-run,
113
+ /// not a revoked subscription).
114
+ ///
115
+ /// # Performance
116
+ ///
117
+ /// One owned `String` allocation for the lowercase UA copy. All other
118
+ /// matches are zero-allocation `str::starts_with` / `str::contains` /
119
+ /// `str::split('.').count()`. Bench at
120
+ /// `crates/headroom-core/benches/auth_mode.rs` asserts <10us / call.
121
+ pub fn classify(headers: &HeaderMap) -> AuthMode {
122
+ // ── User-Agent ───────────────────────────────────────────────
123
+ // Subscription clients identify by UA prefix; this is the most
124
+ // specific signal because the same OAuth token shape appears in
125
+ // both Claude Pro (web) and Claude Code (CLI), and only the UA
126
+ // tells them apart. Read once, lowercase once.
127
+ let ua_owned = match headers.get("user-agent") {
128
+ Some(value) => match value.to_str() {
129
+ Ok(s) => s.to_ascii_lowercase(),
130
+ Err(_) => {
131
+ tracing::warn!(
132
+ event = "auth_mode_classify_unparseable_user_agent",
133
+ "non-UTF-8 user-agent header; falling through to bearer-token classification"
134
+ );
135
+ String::new()
136
+ }
137
+ },
138
+ None => String::new(),
139
+ };
140
+ if SUBSCRIPTION_UA_PREFIXES
141
+ .iter()
142
+ .any(|prefix| ua_owned.contains(prefix))
143
+ {
144
+ return AuthMode::Subscription;
145
+ }
146
+
147
+ // ── Authorization header ─────────────────────────────────────
148
+ // We must NOT log the value. `to_str` returns an `&str` with the
149
+ // same lifetime as the `HeaderMap`, so no copy here.
150
+ let auth = match headers.get("authorization") {
151
+ Some(value) => match value.to_str() {
152
+ Ok(s) => s,
153
+ Err(_) => {
154
+ tracing::warn!(
155
+ event = "auth_mode_classify_unparseable_authorization",
156
+ "non-UTF-8 authorization header; falling back to default Payg"
157
+ );
158
+ ""
159
+ }
160
+ },
161
+ None => "",
162
+ };
163
+
164
+ if let Some(token) = auth.strip_prefix("Bearer ") {
165
+ // Order matters: the OAuth shape `sk-ant-oat-*` shares a
166
+ // prefix with `sk-ant-api*` only at `sk-ant-`, so we check
167
+ // the OAuth shape FIRST. Then the broad PAYG shapes.
168
+ if token.starts_with("sk-ant-oat-") {
169
+ return AuthMode::OAuth;
170
+ }
171
+ if token.starts_with("sk-ant-api") || token.starts_with("sk-") {
172
+ return AuthMode::Payg;
173
+ }
174
+ // JWT: classic three-segment `header.payload.signature`.
175
+ // We don't validate the JWT — just count dot-separated
176
+ // segments. This catches Codex / Cursor / Copilot OAuth.
177
+ if token.split('.').count() >= 3 {
178
+ return AuthMode::OAuth;
179
+ }
180
+ // Unknown bearer shape — fall through to header-based
181
+ // detection below; ultimately defaults to Payg.
182
+ } else if !auth.is_empty() {
183
+ // Authorization is present but NOT `Bearer ...` — most
184
+ // commonly AWS SigV4 (`AWS4-HMAC-SHA256 ...`) on a Bedrock
185
+ // request, or a `Basic ...` from a custom proxy chain. We
186
+ // treat all such non-Bearer schemes as passthrough-prefer.
187
+ // The IAM / signed flow is opaque to us; we never strip or
188
+ // mutate the value — just classify the policy.
189
+ return AuthMode::OAuth;
190
+ }
191
+
192
+ // ── Vendor-specific API-key headers ──────────────────────────
193
+ // Anthropic API-key style. Direct PAYG; same compression policy
194
+ // as a `Bearer sk-ant-api...`.
195
+ if headers.contains_key("x-api-key") {
196
+ return AuthMode::Payg;
197
+ }
198
+ // Gemini API key. Same PAYG semantics.
199
+ if headers.contains_key("x-goog-api-key") {
200
+ return AuthMode::Payg;
201
+ }
202
+
203
+ // ── Default ──────────────────────────────────────────────────
204
+ // Anything else: assume PAYG. Misclassifying a non-PAYG client
205
+ // as PAYG only over-compresses; under-compressing a PAYG client
206
+ // would leave money on the table, which is worse for the
207
+ // OSS-default user.
208
+ AuthMode::Payg
209
+ }
210
+
211
+ #[cfg(test)]
212
+ mod inline_tests {
213
+ //! Smoke tests inlined alongside the function so `cargo test -p
214
+ //! headroom-core --lib` exercises the helper without pulling in
215
+ //! the integration-test binary. The exhaustive test matrix lives
216
+ //! in `crates/headroom-core/tests/auth_mode.rs`.
217
+
218
+ use super::*;
219
+ use http::HeaderValue;
220
+
221
+ #[test]
222
+ fn enum_as_str_is_stable() {
223
+ // Python parity tests assert these exact strings.
224
+ assert_eq!(AuthMode::Payg.as_str(), "payg");
225
+ assert_eq!(AuthMode::OAuth.as_str(), "oauth");
226
+ assert_eq!(AuthMode::Subscription.as_str(), "subscription");
227
+ }
228
+
229
+ #[test]
230
+ fn empty_headers_default_to_payg() {
231
+ // No Authorization, no x-api-key, no x-goog-api-key, no UA →
232
+ // safest default is PAYG. The bedrock OAuth branch fires only
233
+ // when there's a positive non-Bearer Authorization signal.
234
+ let headers = HeaderMap::new();
235
+ assert_eq!(classify(&headers), AuthMode::Payg);
236
+ }
237
+
238
+ #[test]
239
+ fn unparseable_auth_falls_back_to_default() {
240
+ // Non-UTF-8 Authorization header — the warn! fires but we
241
+ // do NOT panic. With no other distinguishing headers, we
242
+ // fall through to the default → Payg.
243
+ let mut headers = HeaderMap::new();
244
+ headers.insert(
245
+ "authorization",
246
+ HeaderValue::from_bytes(b"\xFFnope").unwrap(),
247
+ );
248
+ assert_eq!(classify(&headers), AuthMode::Payg);
249
+ }
250
+ }