xithead 1.4.0 → 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 (661) 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 +108 -72
  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 +366 -366
  551. package/npm/bin/xtream-head.js +366 -0
  552. package/npm/index.d.ts +57 -57
  553. package/npm/index.js +139 -139
  554. package/npm/package.json +55 -54
  555. package/npm/postinstall.js +43 -43
  556. package/package.json +58 -36
  557. package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +17 -0
  558. package/plugins/headroom-agent-hooks/hooks/hooks.json +29 -0
  559. package/plugins/headroom-oauth2/LICENSE +3 -0
  560. package/plugins/headroom-oauth2/SPEC.md +115 -0
  561. package/plugins/headroom-oauth2/pyproject.toml +48 -0
  562. package/plugins/hermes/headroom_retrieve/plugin.yaml +6 -0
  563. package/plugins/openclaw/hook-shim/HOOK.md +21 -0
  564. package/plugins/openclaw/hook-shim/handler.js +3 -0
  565. package/plugins/openclaw/openclaw.plugin.json +98 -0
  566. package/plugins/openclaw/package-lock.json +2692 -0
  567. package/plugins/openclaw/package.json +54 -0
  568. package/plugins/openclaw/prepare-dist.mjs +56 -0
  569. package/plugins/openclaw/src/convert.ts +418 -0
  570. package/plugins/openclaw/src/engine.ts +284 -0
  571. package/plugins/openclaw/src/gateway-config.ts +143 -0
  572. package/plugins/openclaw/src/index.ts +11 -0
  573. package/plugins/openclaw/src/plugin/index.ts +98 -0
  574. package/plugins/openclaw/src/proxy-manager.ts +477 -0
  575. package/plugins/openclaw/src/tools/headroom-retrieve.ts +76 -0
  576. package/plugins/openclaw/test/convert.test.ts +96 -0
  577. package/plugins/openclaw/test/engine-normalization.test.ts +21 -0
  578. package/plugins/openclaw/test/engine.test.ts +101 -0
  579. package/plugins/openclaw/test/gateway-config.test.ts +278 -0
  580. package/plugins/openclaw/test/plugin-runtime-routing.test.ts +141 -0
  581. package/plugins/openclaw/test/proxy-manager.test.ts +343 -0
  582. package/plugins/openclaw/tsup.config.ts +9 -0
  583. package/postcss.config.mjs +7 -0
  584. package/pyproject.toml +438 -0
  585. package/rust-toolchain.toml +16 -0
  586. package/sdk/typescript/examples/basic-compress.ts +64 -0
  587. package/sdk/typescript/examples/ccr-retrieve.ts +80 -0
  588. package/sdk/typescript/examples/hooks-custom-compression.ts +117 -0
  589. package/sdk/typescript/examples/middleware-composition.ts +59 -0
  590. package/sdk/typescript/examples/multi-provider.ts +53 -0
  591. package/sdk/typescript/examples/openai-anthropic-adapters.ts +73 -0
  592. package/sdk/typescript/examples/shared-context-multi-agent.ts +74 -0
  593. package/sdk/typescript/examples/simulation-dry-run.ts +80 -0
  594. package/sdk/typescript/examples/streaming-chat.ts +71 -0
  595. package/sdk/typescript/examples/structured-output.ts +99 -0
  596. package/sdk/typescript/examples/tool-calling-agent.ts +86 -0
  597. package/sdk/typescript/examples/with-headroom-vercel.ts +57 -0
  598. package/sdk/typescript/package-lock.json +3437 -0
  599. package/sdk/typescript/package.json +108 -0
  600. package/sdk/typescript/src/adapters/anthropic.ts +218 -0
  601. package/sdk/typescript/src/adapters/gemini.ts +83 -0
  602. package/sdk/typescript/src/adapters/openai.ts +77 -0
  603. package/sdk/typescript/src/adapters/vercel-ai.ts +131 -0
  604. package/sdk/typescript/src/client.ts +632 -0
  605. package/sdk/typescript/src/compress.ts +87 -0
  606. package/sdk/typescript/src/errors.ts +114 -0
  607. package/sdk/typescript/src/hooks.ts +113 -0
  608. package/sdk/typescript/src/index.ts +140 -0
  609. package/sdk/typescript/src/paths.ts +272 -0
  610. package/sdk/typescript/src/shared-context.ts +188 -0
  611. package/sdk/typescript/src/simulate.ts +52 -0
  612. package/sdk/typescript/src/types/config.ts +183 -0
  613. package/sdk/typescript/src/types/models.ts +314 -0
  614. package/sdk/typescript/src/types.ts +139 -0
  615. package/sdk/typescript/src/utils/case.ts +34 -0
  616. package/sdk/typescript/src/utils/format.ts +480 -0
  617. package/sdk/typescript/src/utils/stream.ts +50 -0
  618. package/sdk/typescript/test/adapters/anthropic.test.ts +217 -0
  619. package/sdk/typescript/test/adapters/gemini.test.ts +131 -0
  620. package/sdk/typescript/test/adapters/openai.test.ts +174 -0
  621. package/sdk/typescript/test/adapters/vercel-ai.test.ts +306 -0
  622. package/sdk/typescript/test/client-expanded.test.ts +333 -0
  623. package/sdk/typescript/test/client.test.ts +266 -0
  624. package/sdk/typescript/test/compress.test.ts +118 -0
  625. package/sdk/typescript/test/config.test.ts +275 -0
  626. package/sdk/typescript/test/errors.test.ts +169 -0
  627. package/sdk/typescript/test/format-integration.test.ts +252 -0
  628. package/sdk/typescript/test/hooks.test.ts +265 -0
  629. package/sdk/typescript/test/integration.test.ts +249 -0
  630. package/sdk/typescript/test/mdx-examples.test.ts +253 -0
  631. package/sdk/typescript/test/models.test.ts +318 -0
  632. package/sdk/typescript/test/parity.test.ts +337 -0
  633. package/sdk/typescript/test/paths.test.ts +447 -0
  634. package/sdk/typescript/test/shared-context.test.ts +245 -0
  635. package/sdk/typescript/test/simulate.test.ts +84 -0
  636. package/sdk/typescript/test/types.test.ts +244 -0
  637. package/sdk/typescript/test/utils/case.test.ts +129 -0
  638. package/sdk/typescript/test/utils/detect-format.test.ts +133 -0
  639. package/sdk/typescript/test/utils/format.test.ts +434 -0
  640. package/sdk/typescript/test/vercel-ai-e2e.test.ts +179 -0
  641. package/sdk/typescript/tsup.config.ts +17 -0
  642. package/tailwind.master.config.cjs +47 -0
  643. package/types/api.ts +12 -0
  644. package/types/config.ts +9 -0
  645. package/types/index.ts +2 -0
  646. package/uv.lock +6951 -0
  647. package/xithead.egg-info/PKG-INFO +22 -0
  648. package/xithead.egg-info/SOURCES.txt +16 -0
  649. package/xithead.egg-info/dependency_links.txt +1 -0
  650. package/xithead.egg-info/entry_points.txt +2 -0
  651. package/xithead.egg-info/requires.txt +10 -0
  652. package/xithead.egg-info/top_level.txt +2 -0
  653. package/xithead.ps1 +136 -0
  654. package/xithead.sh +129 -0
  655. package/xithead_dist/pyproject.toml +39 -0
  656. package/xithead_dist/xithead.egg-info/PKG-INFO +22 -0
  657. package/xithead_dist/xithead.egg-info/SOURCES.txt +16 -0
  658. package/xithead_dist/xithead.egg-info/dependency_links.txt +1 -0
  659. package/xithead_dist/xithead.egg-info/entry_points.txt +3 -0
  660. package/xithead_dist/xithead.egg-info/requires.txt +10 -0
  661. package/xithead_dist/xithead.egg-info/top_level.txt +2 -0
@@ -0,0 +1,735 @@
1
+ //! POST `/model/{model_id}/invoke` handler — Phase D PR-D1.
2
+ //!
3
+ //! # Pipeline
4
+ //!
5
+ //! 1. Extract `{model_id}` from the path. The Bedrock convention is
6
+ //! `anthropic.claude-3-haiku-20240307-v1:0` — dot-separated
7
+ //! `<vendor>.<model>-<date>-<rev>`.
8
+ //! 2. If the vendor is `anthropic`, parse the body as a Bedrock
9
+ //! envelope (`{"anthropic_version": "...", ...rest}`) and run the
10
+ //! live-zone Anthropic compression dispatcher over the body bytes.
11
+ //! The dispatcher is the SAME one `/v1/messages` uses; Bedrock's
12
+ //! body shape is just Anthropic-without-the-`model`-field.
13
+ //! 3. Re-emit the (possibly compressed) body with `anthropic_version`
14
+ //! preserved as the first key.
15
+ //! 4. Build the upstream URL (`https://bedrock-runtime.{region}.amazonaws.com/model/{model}/invoke`
16
+ //! or operator override).
17
+ //! 5. Sign the (post-compression) body bytes with AWS SigV4. Sign
18
+ //! over `host`, `x-amz-date`, `x-amz-content-sha256` plus any
19
+ //! extra headers (`content-type`, `accept`).
20
+ //! 6. Forward to Bedrock; stream the response back to the client.
21
+ //!
22
+ //! # Failure modes
23
+ //!
24
+ //! - **Missing credentials**: log
25
+ //! `event=bedrock_credentials_missing` at WARN, return `500` with
26
+ //! a JSON error body. NEVER forwards an unsigned request.
27
+ //! - **Envelope parse failure**: log `event=bedrock_envelope_parse_error`,
28
+ //! pass the bytes through unchanged. Bedrock will reject anyway,
29
+ //! but the failure is the customer's, not ours — we just route.
30
+ //! This matches the Anthropic compression path's
31
+ //! `Outcome::Passthrough` behaviour.
32
+ //! - **Non-anthropic model**: skip compression, but still sign +
33
+ //! forward. Other vendors (Amazon Titan, Cohere, AI21, Meta) have
34
+ //! different body shapes that the proxy doesn't yet understand;
35
+ //! we pass them through opaquely.
36
+ //! - **SigV4 signing failure**: log
37
+ //! `event=bedrock_sigv4_failed`, return `500`. NEVER forwards
38
+ //! unsigned.
39
+
40
+ use std::net::SocketAddr;
41
+ use std::time::{Instant, SystemTime};
42
+
43
+ use axum::body::Body;
44
+ use axum::extract::{ConnectInfo, Extension, Path, State};
45
+ use axum::http::{HeaderMap, Method, StatusCode, Uri};
46
+ use axum::response::{IntoResponse, Response};
47
+ use bytes::Bytes;
48
+ use futures_util::StreamExt as _;
49
+ use http::HeaderName;
50
+ use url::Url;
51
+
52
+ use crate::bedrock::envelope::BedrockEnvelope;
53
+ use crate::bedrock::sigv4::{sign_request, SigningInputs};
54
+ use crate::compression::{
55
+ compress_anthropic_request, Outcome as AnthropicOutcome, PassthroughReason,
56
+ };
57
+ use crate::headers::filter_response_headers;
58
+ use crate::observability::{observe_bedrock_invoke_latency, record_bedrock_invoke};
59
+ use crate::proxy::AppState;
60
+ // Phase F PR-F1 + PR-D3: the bedrock auth-mode layer
61
+ // (`classify_and_attach_auth_mode`) populates `request.extensions()`
62
+ // with `AuthMode` BEFORE this handler runs. We extract it via
63
+ // `Extension<AuthMode>` so the middleware-supplied value is the
64
+ // single source of truth — handler does NOT re-classify; that
65
+ // would risk drift from the middleware's resolution + WARN log.
66
+ use headroom_core::auth_mode::AuthMode;
67
+
68
+ use crate::bedrock::vendor::is_anthropic_model_id;
69
+
70
+ /// RAII guard that observes the `bedrock_invoke_latency_seconds`
71
+ /// histogram on drop. Created at handler entry; observed when the
72
+ /// guard goes out of scope no matter how the handler exits. Owning
73
+ /// `String` rather than `&str` for the labels avoids capture-order
74
+ /// dramas with the borrow checker on early-return paths.
75
+ struct LatencyGuard {
76
+ model: String,
77
+ region: String,
78
+ start: Instant,
79
+ }
80
+
81
+ impl LatencyGuard {
82
+ fn start(model: &str, region: &str) -> Self {
83
+ Self {
84
+ model: model.to_string(),
85
+ region: region.to_string(),
86
+ start: Instant::now(),
87
+ }
88
+ }
89
+ }
90
+
91
+ impl Drop for LatencyGuard {
92
+ fn drop(&mut self) {
93
+ let elapsed = self.start.elapsed().as_secs_f64();
94
+ observe_bedrock_invoke_latency(&self.model, &self.region, elapsed);
95
+ }
96
+ }
97
+
98
+ /// AWS Bedrock Runtime DNS template. The `{}` placeholder is the
99
+ /// region. Only used when `Config::bedrock_endpoint` is `None`.
100
+ const BEDROCK_RUNTIME_HOST_TEMPLATE: &str = "bedrock-runtime.{region}.amazonaws.com";
101
+
102
+ /// Bedrock non-streaming action path segments. `invoke` is the legacy
103
+ /// InvokeModel surface; `converse` is the unified Converse surface.
104
+ /// Both mount the same handler (see `proxy.rs`), so the action is
105
+ /// resolved from the inbound path — otherwise `/converse` requests
106
+ /// would be forwarded to the upstream `/invoke` endpoint.
107
+ const INVOKE_ACTION: &str = "invoke";
108
+ const CONVERSE_ACTION: &str = "converse";
109
+
110
+ /// Resolve the Bedrock action from the inbound request path. Mirrors
111
+ /// `invoke_streaming::extract_streaming_action` for the non-streaming
112
+ /// surfaces (`/invoke`, `/converse`).
113
+ fn extract_invoke_action(path: &str) -> Option<&'static str> {
114
+ if path.ends_with(&format!("/{INVOKE_ACTION}")) {
115
+ Some(INVOKE_ACTION)
116
+ } else if path.ends_with(&format!("/{CONVERSE_ACTION}")) {
117
+ Some(CONVERSE_ACTION)
118
+ } else {
119
+ None
120
+ }
121
+ }
122
+
123
+ /// Axum POST handler for `/model/{model_id}/invoke`.
124
+ ///
125
+ /// Buffers the body so the live-zone compressor + SigV4 signer can
126
+ /// inspect it. Both are required to be applied to the SAME byte slice
127
+ /// — the signer hashes whatever the forwarder will actually send.
128
+ #[allow(clippy::too_many_arguments)] // axum extractors demand one argument per role
129
+ pub async fn handle_invoke(
130
+ State(state): State<AppState>,
131
+ ConnectInfo(client_addr): ConnectInfo<SocketAddr>,
132
+ Extension(auth_mode): Extension<AuthMode>,
133
+ Path(model_id): Path<String>,
134
+ method: Method,
135
+ uri: Uri,
136
+ headers: HeaderMap,
137
+ body: Bytes,
138
+ ) -> Response {
139
+ let _ = client_addr; // accepted for ConnectInfo extractor; not used directly today
140
+ let request_id = headers
141
+ .get("x-request-id")
142
+ .and_then(|v| v.to_str().ok())
143
+ .map(|s| s.to_string())
144
+ .unwrap_or_else(|| uuid::Uuid::new_v4().to_string());
145
+
146
+ // PR-D3: latency stopwatch starts at handler entry (after
147
+ // routing + middleware). The histogram observes wall-clock
148
+ // time, so it captures upstream RTT + sign + compress as a
149
+ // single number — operators can split contributions via the
150
+ // `bedrock_*` structured-log timing fields if a slow path
151
+ // shows up. Wrapped in a `LatencyGuard` so EVERY return path
152
+ // (success, sign-failure, upstream-error, response-build error)
153
+ // observes the histogram. RAII keeps the call site to one
154
+ // line and rules out future regressions where someone adds a
155
+ // new error path and forgets to instrument.
156
+ let region = state.config.bedrock_region.clone();
157
+ let _latency_guard = LatencyGuard::start(&model_id, &region);
158
+
159
+ // PR-D3: count every invoke at handler entry (one per request,
160
+ // before any error path can early-return). Pairs with the
161
+ // structured log emitted below so operators can join the
162
+ // counter with the trace by `request_id`.
163
+ record_bedrock_invoke(&model_id, &region, auth_mode);
164
+
165
+ tracing::info!(
166
+ event = "bedrock_invoke_received",
167
+ request_id = %request_id,
168
+ method = %method,
169
+ model_id = %model_id,
170
+ region = %region,
171
+ auth_mode = auth_mode.as_str(),
172
+ body_bytes = body.len(),
173
+ "bedrock invoke route received request"
174
+ );
175
+
176
+ let is_anthropic = is_anthropic_model_id(&model_id);
177
+ let outbound_body: Bytes = if is_anthropic {
178
+ run_anthropic_compression(&body, &state, auth_mode, &request_id)
179
+ } else {
180
+ tracing::info!(
181
+ event = "bedrock_compression_skipped",
182
+ request_id = %request_id,
183
+ model_id = %model_id,
184
+ reason = "non_anthropic_vendor",
185
+ "bedrock invoke: skipping live-zone compression for non-anthropic vendor"
186
+ );
187
+ body.clone()
188
+ };
189
+
190
+ // Resolve the Bedrock action from the inbound path so `/converse`
191
+ // forwards to the upstream Converse endpoint instead of `/invoke`.
192
+ // Both paths mount this handler (see `proxy.rs`); the streaming
193
+ // sibling resolves its action the same way.
194
+ let action = match extract_invoke_action(uri.path()) {
195
+ Some(a) => a,
196
+ None => {
197
+ tracing::error!(
198
+ event = "bedrock_invoke_action_invalid",
199
+ request_id = %request_id,
200
+ path = %uri.path(),
201
+ "bedrock invoke: unrecognized action path"
202
+ );
203
+ return error_response(
204
+ StatusCode::BAD_REQUEST,
205
+ "bedrock_invoke_action_invalid",
206
+ "Unsupported Bedrock action path",
207
+ );
208
+ }
209
+ };
210
+
211
+ // Build the upstream URL based on configured endpoint or
212
+ // region-derived default.
213
+ let upstream_url = match build_bedrock_upstream(&state, &model_id, &uri, action) {
214
+ Ok(u) => u,
215
+ Err(msg) => {
216
+ tracing::error!(
217
+ event = "bedrock_endpoint_invalid",
218
+ request_id = %request_id,
219
+ error = %msg,
220
+ "bedrock invoke: failed to construct upstream URL"
221
+ );
222
+ return error_response(
223
+ StatusCode::INTERNAL_SERVER_ERROR,
224
+ "bedrock_endpoint_invalid",
225
+ &msg,
226
+ );
227
+ }
228
+ };
229
+
230
+ // Resolve credentials. No silent fallback: missing creds → 5xx.
231
+ let creds = match state.bedrock_credentials.as_ref() {
232
+ Some(c) => c.clone(),
233
+ None => {
234
+ tracing::warn!(
235
+ event = "bedrock_credentials_missing",
236
+ request_id = %request_id,
237
+ model_id = %model_id,
238
+ "bedrock invoke: refusing to forward without AWS credentials"
239
+ );
240
+ return error_response(
241
+ StatusCode::INTERNAL_SERVER_ERROR,
242
+ "bedrock_credentials_missing",
243
+ "AWS credentials not configured; refusing to forward unsigned",
244
+ );
245
+ }
246
+ };
247
+
248
+ // Build the headers we sign + forward. Start from the inbound
249
+ // headers, drop the ones the upstream client manages, then sign.
250
+ let extra_signed: Vec<(String, String)> = collect_signed_headers(&headers, &upstream_url);
251
+ let extra_signed_refs: Vec<(&str, &str)> = extra_signed
252
+ .iter()
253
+ .map(|(k, v)| (k.as_str(), v.as_str()))
254
+ .collect();
255
+
256
+ let sign_inputs = SigningInputs {
257
+ method: method.as_str(),
258
+ url: &upstream_url,
259
+ region: &state.config.bedrock_region,
260
+ credentials: creds.as_ref(),
261
+ body: &outbound_body,
262
+ extra_signed_headers: &extra_signed_refs,
263
+ time: SystemTime::now(),
264
+ };
265
+ let signed = match sign_request(&sign_inputs) {
266
+ Ok(s) => s,
267
+ Err(e) => {
268
+ tracing::error!(
269
+ event = "bedrock_sigv4_failed",
270
+ request_id = %request_id,
271
+ model_id = %model_id,
272
+ error = %e,
273
+ "bedrock invoke: SigV4 signing failed; refusing to forward"
274
+ );
275
+ return error_response(
276
+ StatusCode::INTERNAL_SERVER_ERROR,
277
+ "bedrock_sigv4_failed",
278
+ &e.to_string(),
279
+ );
280
+ }
281
+ };
282
+
283
+ // Compose the outgoing header map. Start with the headers we'll
284
+ // forward (filter out hop-by-hop / Host / Content-Length;
285
+ // reqwest sets those itself), then layer the SigV4 outputs on
286
+ // top — they replace any pre-existing copies of the same name.
287
+ let mut outbound_headers = HeaderMap::new();
288
+ for (name, value) in extra_signed.iter() {
289
+ if let (Ok(n), Ok(v)) = (
290
+ HeaderName::from_bytes(name.as_bytes()),
291
+ http::HeaderValue::from_str(value),
292
+ ) {
293
+ outbound_headers.insert(n, v);
294
+ }
295
+ }
296
+ for (name, value) in signed.entries.iter() {
297
+ if let (Ok(n), Ok(v)) = (
298
+ HeaderName::from_bytes(name.as_bytes()),
299
+ http::HeaderValue::from_str(value),
300
+ ) {
301
+ outbound_headers.insert(n, v);
302
+ }
303
+ }
304
+
305
+ // Forward. We surface upstream errors as 502; the byte path
306
+ // streams the response back to the client.
307
+ let reqwest_method = match reqwest::Method::from_bytes(method.as_str().as_bytes()) {
308
+ Ok(m) => m,
309
+ Err(e) => {
310
+ tracing::error!(
311
+ event = "bedrock_invalid_method",
312
+ request_id = %request_id,
313
+ error = %e,
314
+ "bedrock invoke: invalid HTTP method"
315
+ );
316
+ return error_response(
317
+ StatusCode::BAD_REQUEST,
318
+ "bedrock_invalid_method",
319
+ &e.to_string(),
320
+ );
321
+ }
322
+ };
323
+
324
+ let upstream_resp = state
325
+ .client
326
+ .request(reqwest_method, upstream_url.clone())
327
+ .headers(outbound_headers)
328
+ .body(outbound_body.clone())
329
+ .send()
330
+ .await;
331
+
332
+ let upstream_resp = match upstream_resp {
333
+ Ok(r) => r,
334
+ Err(e) => {
335
+ tracing::warn!(
336
+ event = "bedrock_upstream_error",
337
+ request_id = %request_id,
338
+ error = %e,
339
+ "bedrock invoke: upstream request failed"
340
+ );
341
+ let status = if e.is_timeout() {
342
+ StatusCode::GATEWAY_TIMEOUT
343
+ } else {
344
+ StatusCode::BAD_GATEWAY
345
+ };
346
+ return error_response(status, "bedrock_upstream_error", &e.to_string());
347
+ }
348
+ };
349
+
350
+ let status =
351
+ StatusCode::from_u16(upstream_resp.status().as_u16()).unwrap_or(StatusCode::BAD_GATEWAY);
352
+ let resp_headers = filter_response_headers(upstream_resp.headers());
353
+
354
+ tracing::info!(
355
+ event = "bedrock_invoke_forwarded",
356
+ request_id = %request_id,
357
+ model_id = %model_id,
358
+ upstream_status = status.as_u16(),
359
+ upstream_url = %upstream_url,
360
+ "bedrock invoke: response forwarded"
361
+ );
362
+
363
+ // Stream the response body back without buffering.
364
+ let stream = upstream_resp
365
+ .bytes_stream()
366
+ .map(|r| r.map_err(std::io::Error::other));
367
+ let body_out = Body::from_stream(stream);
368
+
369
+ let mut builder = Response::builder().status(status);
370
+ if let Some(h) = builder.headers_mut() {
371
+ h.extend(resp_headers);
372
+ if let Ok(v) = http::HeaderValue::from_str(&request_id) {
373
+ h.insert(HeaderName::from_static("x-request-id"), v);
374
+ }
375
+ }
376
+ builder.body(body_out).unwrap_or_else(|e| {
377
+ tracing::error!(
378
+ event = "bedrock_response_build_failed",
379
+ request_id = %request_id,
380
+ error = %e,
381
+ "bedrock invoke: failed to build response"
382
+ );
383
+ Response::builder()
384
+ .status(StatusCode::INTERNAL_SERVER_ERROR)
385
+ .body(Body::from("internal handler error"))
386
+ .expect("static response")
387
+ })
388
+ }
389
+
390
+ /// Run the live-zone Anthropic compressor over a Bedrock-shape body.
391
+ ///
392
+ /// The compressor only inspects `messages` — it doesn't care that the
393
+ /// Bedrock body has `anthropic_version` instead of `model`. The
394
+ /// `Outcome::Compressed` body bytes still preserve key order via
395
+ /// `serde_json`'s `preserve_order` feature, so the caller's
396
+ /// re-emission step (`ensure_anthropic_version_first`) almost always
397
+ /// no-ops. We still call it as a defence-in-depth assertion that
398
+ /// the byte order is correct before signing.
399
+ fn run_anthropic_compression(
400
+ body: &Bytes,
401
+ state: &AppState,
402
+ _auth_mode: AuthMode,
403
+ request_id: &str,
404
+ ) -> Bytes {
405
+ // Detect envelope shape. A parseable InvokeModel envelope takes the
406
+ // re-emit path below (anthropic_version pinned first); a non-envelope
407
+ // body (e.g. a Converse-shaped payload) still runs through the
408
+ // compressor but skips envelope re-emit. The body is NOT guaranteed
409
+ // unchanged on parse failure — we log which path we took.
410
+ let parsed_envelope = BedrockEnvelope::parse(body).is_ok();
411
+ if parsed_envelope {
412
+ tracing::info!(
413
+ event = "bedrock_envelope_parsed",
414
+ request_id = %request_id,
415
+ body_bytes = body.len(),
416
+ "bedrock invoke: envelope validated; dispatching to live-zone compressor"
417
+ );
418
+ } else {
419
+ tracing::info!(
420
+ event = "bedrock_envelope_parse_skipped",
421
+ request_id = %request_id,
422
+ "bedrock invoke: envelope parse skipped; attempting generic anthropic compression"
423
+ );
424
+ }
425
+
426
+ // PR-E3: Bedrock uses IAM-signed AWS SigV4 downstream. Inbound
427
+ // requests to the proxy may or may not carry their own auth, but
428
+ // Bedrock itself is a subscription/IAM channel — never PAYG —
429
+ // so we hard-code `RequestAuthMode::OAuth` to skip E3
430
+ // cache_control auto-placement. This keeps the Bedrock byte
431
+ // contract stable; live-zone compression continues to run.
432
+ let outcome = compress_anthropic_request(
433
+ body,
434
+ state.config.compression_mode,
435
+ state.config.cache_control_auto_frozen,
436
+ headroom_core::auth_mode::AuthMode::OAuth,
437
+ request_id,
438
+ );
439
+ match outcome {
440
+ AnthropicOutcome::NoCompression => body.clone(),
441
+ AnthropicOutcome::Passthrough { reason } => {
442
+ tracing::info!(
443
+ event = "bedrock_compression_passthrough",
444
+ request_id = %request_id,
445
+ reason = ?reason,
446
+ "bedrock invoke: live-zone dispatcher fell through to passthrough"
447
+ );
448
+ // The compressor's passthrough variants all leave bytes
449
+ // unchanged. Forward the original.
450
+ let _ = (PassthroughReason::ModeOff, PassthroughReason::NoMessages); // pin types
451
+ body.clone()
452
+ }
453
+ AnthropicOutcome::Compressed { body: new_body, .. } => {
454
+ if parsed_envelope {
455
+ // Defence-in-depth: re-emit so anthropic_version is the
456
+ // first key. With preserve_order this is a no-op on the
457
+ // happy path.
458
+ match BedrockEnvelope::ensure_anthropic_version_first(&new_body) {
459
+ Ok(b) => b,
460
+ Err(e) => {
461
+ tracing::error!(
462
+ event = "bedrock_envelope_reemit_failed",
463
+ request_id = %request_id,
464
+ error = %e,
465
+ "bedrock invoke: failed to re-emit envelope; falling back to original body"
466
+ );
467
+ body.clone()
468
+ }
469
+ }
470
+ } else {
471
+ new_body
472
+ }
473
+ }
474
+ }
475
+ }
476
+
477
+ /// Build the upstream URL for the Bedrock route. Honours the
478
+ /// operator-supplied `bedrock_endpoint` first, falling back to the
479
+ /// region-derived default. The path/query portion is taken from the
480
+ /// original URI verbatim — Bedrock's path schema (`/model/{id}/{action}`)
481
+ /// is identical to the proxy's external path.
482
+ fn build_bedrock_upstream(
483
+ state: &AppState,
484
+ model_id: &str,
485
+ uri: &Uri,
486
+ action: &str,
487
+ ) -> Result<Url, String> {
488
+ let base = match state.config.bedrock_endpoint.as_ref() {
489
+ Some(u) => u.clone(),
490
+ None => {
491
+ let host =
492
+ BEDROCK_RUNTIME_HOST_TEMPLATE.replace("{region}", &state.config.bedrock_region);
493
+ Url::parse(&format!("https://{host}/"))
494
+ .map_err(|e| format!("bedrock derived base URL parse error: {e}"))?
495
+ }
496
+ };
497
+ // Compose the path. We trust the captured `model_id` (Axum
498
+ // already URL-decoded it) and append `/{action}`.
499
+ let path = format!(
500
+ "/model/{model_id}/{action}",
501
+ model_id = model_id,
502
+ action = action,
503
+ );
504
+ let mut joined = base;
505
+ joined.set_path(&path);
506
+ if let Some(q) = uri.query() {
507
+ joined.set_query(Some(q));
508
+ }
509
+ Ok(joined)
510
+ }
511
+
512
+ /// Build the list of headers to sign + forward. Drops hop-by-hop,
513
+ /// `host`, `content-length` (reqwest manages those), `authorization`
514
+ /// (we replace it with the SigV4 output). Lower-cases names for
515
+ /// canonical-request consistency.
516
+ fn collect_signed_headers(headers: &HeaderMap, upstream_url: &Url) -> Vec<(String, String)> {
517
+ let mut out: Vec<(String, String)> = Vec::with_capacity(headers.len() + 1);
518
+ for (name, value) in headers.iter() {
519
+ let n = name.as_str().to_ascii_lowercase();
520
+ if matches!(
521
+ n.as_str(),
522
+ "host"
523
+ | "content-length"
524
+ | "connection"
525
+ | "keep-alive"
526
+ | "proxy-authenticate"
527
+ | "proxy-authorization"
528
+ | "te"
529
+ | "trailers"
530
+ | "transfer-encoding"
531
+ | "upgrade"
532
+ | "authorization"
533
+ | "x-amz-date"
534
+ | "x-amz-content-sha256"
535
+ ) {
536
+ // Drop client-managed + signer-managed headers.
537
+ continue;
538
+ }
539
+ if n.starts_with("x-headroom-") {
540
+ // Internal headers are stripped from upstream traffic
541
+ // (PR-A5). The Bedrock route inherits the same default.
542
+ continue;
543
+ }
544
+ if let Ok(v) = value.to_str() {
545
+ out.push((n, v.to_string()));
546
+ }
547
+ }
548
+ // Signer requires `host` in the canonical request. Add it
549
+ // explicitly from the upstream URL — the inbound `host` header
550
+ // (the proxy's listening hostname) is wrong for the canonical
551
+ // request.
552
+ if let Some(host) = upstream_url.host_str() {
553
+ let host_value = match upstream_url.port() {
554
+ Some(p) => format!("{host}:{p}"),
555
+ None => host.to_string(),
556
+ };
557
+ out.push(("host".to_string(), host_value));
558
+ }
559
+ out
560
+ }
561
+
562
+ fn error_response(status: StatusCode, event: &str, msg: &str) -> Response {
563
+ let body = serde_json::json!({
564
+ "error": {
565
+ "type": event,
566
+ "message": msg,
567
+ }
568
+ })
569
+ .to_string();
570
+ let _ = event;
571
+ let mut resp = Response::builder()
572
+ .status(status)
573
+ .body(Body::from(body))
574
+ .expect("static error response");
575
+ resp.headers_mut().insert(
576
+ http::header::CONTENT_TYPE,
577
+ http::HeaderValue::from_static("application/json"),
578
+ );
579
+ resp.into_response()
580
+ }
581
+
582
+ #[cfg(test)]
583
+ mod tests {
584
+ use super::*;
585
+
586
+ // Vendor/model-id classification is tested in `bedrock::vendor`.
587
+
588
+ #[test]
589
+ fn extract_invoke_action_supports_both_bedrock_paths() {
590
+ assert_eq!(
591
+ extract_invoke_action("/model/anthropic.claude-3-haiku-20240307-v1:0/invoke"),
592
+ Some(INVOKE_ACTION)
593
+ );
594
+ assert_eq!(
595
+ extract_invoke_action("/model/anthropic.claude-3-haiku-20240307-v1:0/converse"),
596
+ Some(CONVERSE_ACTION)
597
+ );
598
+ // Streaming actions are handled by `invoke_streaming`, not here.
599
+ assert_eq!(
600
+ extract_invoke_action(
601
+ "/model/anthropic.claude-3-haiku-20240307-v1:0/invoke-with-response-stream"
602
+ ),
603
+ None
604
+ );
605
+ assert_eq!(extract_invoke_action("/model/foo/unknown"), None);
606
+ }
607
+
608
+ #[test]
609
+ fn build_upstream_routes_converse_to_converse_endpoint() {
610
+ use crate::config::Config;
611
+ let mut config = Config::for_test(Url::parse("http://up:8080").unwrap());
612
+ config.bedrock_region = "us-west-2".to_string();
613
+ let state = AppState {
614
+ config: std::sync::Arc::new(config),
615
+ client: reqwest::Client::new(),
616
+ bedrock_credentials: None,
617
+ drift_state: crate::cache_stabilization::drift_detector::DriftState::new(8),
618
+ vertex_token_source: std::sync::Arc::new(crate::vertex::StaticTokenSource::new(
619
+ "test".to_string(),
620
+ )),
621
+ };
622
+ let uri: Uri = "/model/anthropic.claude-3-haiku-20240307-v1:0/converse"
623
+ .parse()
624
+ .unwrap();
625
+ let action = extract_invoke_action(uri.path()).unwrap();
626
+ let url = build_bedrock_upstream(
627
+ &state,
628
+ "anthropic.claude-3-haiku-20240307-v1:0",
629
+ &uri,
630
+ action,
631
+ )
632
+ .unwrap();
633
+ assert_eq!(
634
+ url.as_str(),
635
+ "https://bedrock-runtime.us-west-2.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/converse"
636
+ );
637
+ }
638
+
639
+ #[test]
640
+ fn build_upstream_uses_region_default() {
641
+ use crate::config::Config;
642
+ let mut config = Config::for_test(Url::parse("http://up:8080").unwrap());
643
+ config.bedrock_region = "us-west-2".to_string();
644
+ let state = AppState {
645
+ config: std::sync::Arc::new(config),
646
+ client: reqwest::Client::new(),
647
+ bedrock_credentials: None,
648
+ // PR-E6: small capacity is fine — the Bedrock URL builder
649
+ // unit test never observes drift, but `AppState` requires
650
+ // the field to be populated.
651
+ drift_state: crate::cache_stabilization::drift_detector::DriftState::new(8),
652
+ // PR-D4: unit tests for the Bedrock URL builder don't
653
+ // touch the Vertex route, but `AppState` is one struct
654
+ // — supply a dummy token source so the test compiles.
655
+ vertex_token_source: std::sync::Arc::new(crate::vertex::StaticTokenSource::new(
656
+ "test".to_string(),
657
+ )),
658
+ };
659
+ let uri: Uri = "/model/anthropic.claude-3-haiku-20240307-v1:0/invoke"
660
+ .parse()
661
+ .unwrap();
662
+ let url = build_bedrock_upstream(
663
+ &state,
664
+ "anthropic.claude-3-haiku-20240307-v1:0",
665
+ &uri,
666
+ "invoke",
667
+ )
668
+ .unwrap();
669
+ assert_eq!(
670
+ url.as_str(),
671
+ "https://bedrock-runtime.us-west-2.amazonaws.com/model/anthropic.claude-3-haiku-20240307-v1:0/invoke"
672
+ );
673
+ }
674
+
675
+ #[test]
676
+ fn build_upstream_honors_explicit_endpoint() {
677
+ use crate::config::Config;
678
+ let mut config = Config::for_test(Url::parse("http://up:8080").unwrap());
679
+ config.bedrock_endpoint = Some(Url::parse("http://127.0.0.1:9999").unwrap());
680
+ let state = AppState {
681
+ config: std::sync::Arc::new(config),
682
+ client: reqwest::Client::new(),
683
+ bedrock_credentials: None,
684
+ // PR-E6: see above — drift detector is unused by this
685
+ // test; we just satisfy the struct shape.
686
+ drift_state: crate::cache_stabilization::drift_detector::DriftState::new(8),
687
+ // PR-D4: unit tests for the Bedrock URL builder don't
688
+ // touch the Vertex route, but `AppState` is one struct
689
+ // — supply a dummy token source so the test compiles.
690
+ vertex_token_source: std::sync::Arc::new(crate::vertex::StaticTokenSource::new(
691
+ "test".to_string(),
692
+ )),
693
+ };
694
+ let uri: Uri = "/model/anthropic.claude-3-haiku-20240307-v1:0/invoke"
695
+ .parse()
696
+ .unwrap();
697
+ let url = build_bedrock_upstream(
698
+ &state,
699
+ "anthropic.claude-3-haiku-20240307-v1:0",
700
+ &uri,
701
+ "invoke",
702
+ )
703
+ .unwrap();
704
+ assert_eq!(
705
+ url.as_str(),
706
+ "http://127.0.0.1:9999/model/anthropic.claude-3-haiku-20240307-v1:0/invoke"
707
+ );
708
+ }
709
+
710
+ #[test]
711
+ fn collect_signed_headers_strips_client_managed() {
712
+ let mut headers = HeaderMap::new();
713
+ headers.insert("content-type", "application/json".parse().unwrap());
714
+ headers.insert("host", "proxy.example".parse().unwrap());
715
+ headers.insert("authorization", "Bearer x".parse().unwrap());
716
+ headers.insert("x-headroom-mode", "live".parse().unwrap());
717
+ headers.insert("accept", "application/json".parse().unwrap());
718
+ let upstream =
719
+ Url::parse("https://bedrock-runtime.us-east-1.amazonaws.com/model/x/invoke").unwrap();
720
+ let out = collect_signed_headers(&headers, &upstream);
721
+ let names: Vec<&str> = out.iter().map(|(k, _)| k.as_str()).collect();
722
+ assert!(names.contains(&"content-type"));
723
+ assert!(names.contains(&"accept"));
724
+ assert!(names.contains(&"host"));
725
+ assert!(!names.contains(&"authorization"));
726
+ assert!(!names.contains(&"x-headroom-mode"));
727
+ // host must be the upstream host, not the proxy host.
728
+ let host = out
729
+ .iter()
730
+ .find(|(k, _)| k == "host")
731
+ .map(|(_, v)| v.as_str())
732
+ .unwrap();
733
+ assert_eq!(host, "bedrock-runtime.us-east-1.amazonaws.com");
734
+ }
735
+ }