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
package/Cargo.toml ADDED
@@ -0,0 +1,121 @@
1
+ [workspace]
2
+ resolver = "2"
3
+ members = [
4
+ "crates/headroom-core",
5
+ "crates/headroom-proxy",
6
+ "crates/headroom-py",
7
+ "crates/headroom-parity",
8
+ ]
9
+ # headroom-py is a Python extension module — it must be built via maturin, not
10
+ # plain cargo (the "extension-module" feature tells pyo3 not to link libpython,
11
+ # which is required for `import` to work). `cargo build --workspace` without
12
+ # explicit members skips it; `cargo test --workspace` still runs its tests
13
+ # because pyo3 can dynamically link here for the cdylib used by tests.
14
+ default-members = [
15
+ "crates/headroom-core",
16
+ "crates/headroom-proxy",
17
+ "crates/headroom-parity",
18
+ ]
19
+
20
+ [workspace.package]
21
+ edition = "2021"
22
+ rust-version = "1.80"
23
+ license = "Apache-2.0"
24
+ repository = "https://github.com/Xtream-ITSolutions/xithead"
25
+ authors = ["Headroom Maintainers"]
26
+
27
+ [workspace.dependencies]
28
+ serde = { version = "1", features = ["derive"] }
29
+ # `preserve_order` makes `serde_json::Value::Object` use IndexMap so JSON
30
+ # parse order is preserved through Value→string→Value round-trips. The
31
+ # smart_crusher port relies on this to match Python's `str(dict)` output,
32
+ # which preserves insertion order; otherwise BTreeMap's sorted-key default
33
+ # would diverge from Python on every multi-key object.
34
+ #
35
+ # `arbitrary_precision` keeps the literal numeric token from the source
36
+ # JSON intact: `Value::Number` becomes a wrapper around the original
37
+ # digit string, so `1.0` does NOT collapse to `1`, and `12345678901234567`
38
+ # does NOT lose precision through f64. Required by Realignment invariant
39
+ # I1 (byte-faithful passthrough on unmutated bytes; see REALIGNMENT/02-
40
+ # architecture.md §2.2) and PR-A4 (see REALIGNMENT/03-phase-A-lockdown.md).
41
+ #
42
+ # `raw_value` exposes `serde_json::value::RawValue`, the unparsed JSON
43
+ # fragment type. Phase B PR-B2 uses this to forward unmodified
44
+ # `messages[*]` entries as exact byte copies — the parser captures the
45
+ # original byte slice, so byte-for-byte round-trips work even with
46
+ # whitespace, key order, or escape preferences the producer chose.
47
+ # Enabled here in Phase A so PR-B2 can land as a pure consumer change.
48
+ serde_json = { version = "1", features = ["preserve_order", "arbitrary_precision", "raw_value"] }
49
+ bytes = "1"
50
+ thiserror = "1"
51
+ tracing = "0.1"
52
+ anyhow = "1"
53
+ clap = { version = "4", features = ["derive"] }
54
+ tokio = { version = "1", features = ["macros", "rt-multi-thread", "signal"] }
55
+ axum = "0.7"
56
+ tower = "0.5"
57
+ reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
58
+ pyo3 = { version = "0.24", features = ["abi3-py310"] }
59
+ # Phase D PR-D1: AWS SigV4 signing for native Bedrock InvokeModel route.
60
+ # `aws-sigv4` provides the canonical-request + signing-key implementation;
61
+ # `aws-config` resolves credentials from the standard provider chain
62
+ # (env vars, profiles, IMDS, ECS task role, etc); `aws-credential-types`
63
+ # exposes `Credentials` so the signer accepts whatever the chain returned.
64
+ aws-sigv4 = { version = "1", default-features = false, features = ["sign-http", "http1"] }
65
+ aws-config = { version = "1", default-features = false, features = ["behavior-version-latest", "rustls", "rt-tokio", "sso"] }
66
+ aws-credential-types = { version = "1", default-features = false }
67
+ # `Identity` lives in aws-smithy-runtime-api; the SigV4 builder
68
+ # accepts `&Identity`. Pinning the version explicitly avoids a
69
+ # silent semver bump from the transitive dep tree.
70
+ aws-smithy-runtime-api = { version = "1", default-features = false, features = ["client"] }
71
+ # PR-D4: Vertex publisher path uses GCP Application Default Credentials
72
+ # (ADC) → bearer token for the `Authorization: Bearer <token>` header.
73
+ # `gcp_auth` resolves the chain (gcloud user creds, GCE/GKE metadata
74
+ # server, service-account JSON, workload-identity federation) without
75
+ # us baking provider-specific knowledge in. The token source is wrapped
76
+ # in a `TokenSource` trait so tests inject a static-token mock.
77
+ gcp_auth = "0.12"
78
+
79
+
80
+ # ── Release profile — wheel size optimization ───────────────────────
81
+ #
82
+ # PyPI imposes a 10 GB cumulative storage limit per project. We hit it
83
+ # at version 0.21.36 (191 versions × ~213 MB/release = 10.00 GB
84
+ # exactly). Recent wheels were ~16-18 MB each, of which ~6.4 MB was
85
+ # pure debug metadata (`.strtab` + `.symtab` ELF sections; uncovered
86
+ # by post-mortem inspection of an actual production wheel).
87
+ #
88
+ # This profile shrinks each Linux wheel from ~18 MB → ~10-11 MB by:
89
+ # * Stripping symbol/string tables (~6.4 MB direct savings)
90
+ # * Link-time optimization across crate boundaries (~5-10% .text
91
+ # savings via dead-code elim across the workspace)
92
+ # * Single codegen unit (better inlining + dead-code elim, at the
93
+ # cost of slightly slower release builds)
94
+ #
95
+ # We deliberately do NOT set ``panic = "abort"``. The proxy is a
96
+ # long-lived async process — a single misbehaving request triggering
97
+ # panic-abort would terminate the whole proxy and disconnect every
98
+ # concurrent client. Accept the smaller savings; keep unwind behaviour.
99
+ #
100
+ # Estimated impact: 213 MB/release → ~130 MB/release. Buys ~30+ more
101
+ # release slots within the 10 GB ceiling at the current release
102
+ # cadence. Per-PyPI-version savings AND faster downloads for end
103
+ # users. Tradeoff: release builds take ~30-50% longer due to
104
+ # `codegen-units = 1` + LTO; acceptable for the size win.
105
+ [profile.release]
106
+ strip = "symbols"
107
+ lto = "thin"
108
+ codegen-units = 1
109
+
110
+ # Fast-to-compile profile for CI test wheels. The shipped wheel uses
111
+ # `release` (lto + codegen-units=1) for runtime/size; CI only needs a working
112
+ # extension, so trade runtime perf for ~parallel, lto-free compilation. Used
113
+ # via `maturin build --profile ci`. Does NOT affect `--release` builds.
114
+ [profile.ci]
115
+ inherits = "release"
116
+ lto = false
117
+ codegen-units = 256
118
+ opt-level = 1
119
+ strip = "none"
120
+ debug = false
121
+ incremental = false
package/Dockerfile ADDED
@@ -0,0 +1,38 @@
1
+ FROM node:22-alpine AS deps
2
+ WORKDIR /app
3
+ COPY package.json package-lock.json ./
4
+ RUN npm install
5
+
6
+ FROM node:22-alpine AS builder
7
+ WORKDIR /app
8
+ COPY package.json package-lock.json ./
9
+ COPY --from=deps /app/node_modules ./node_modules
10
+ COPY app/ ./app/
11
+ COPY components/ ./components/
12
+ COPY lib/ ./lib/
13
+ COPY types/ ./types/
14
+ COPY middleware.ts tsconfig.json next.config.ts tailwind.config.js tailwind.master.config.cjs postcss.config.mjs ./
15
+ COPY scripts/ ./scripts/
16
+ COPY public/ ./public/
17
+ # The Next.js app imports the shared design system through the repository-level
18
+ # sibling path (../design-system from app/master-design-system.source.css).
19
+ # Keep that layout in the container so Tailwind and PostCSS resolve correctly.
20
+ COPY design-system/ ./design-system/
21
+ RUN npm run build
22
+
23
+ FROM node:22-alpine AS runner
24
+ WORKDIR /app
25
+ ENV NODE_ENV=production
26
+
27
+ RUN addgroup --system --gid 1001 nodejs && \
28
+ adduser --system --uid 1001 nextjs
29
+
30
+ COPY --from=builder /app/.next/standalone ./
31
+ COPY --from=builder /app/.next/static ./.next/static
32
+ COPY --from=builder /app/public* ./public/
33
+
34
+ USER nextjs
35
+ EXPOSE 3000
36
+ ENV PORT=3000 HOSTNAME="0.0.0.0"
37
+
38
+ CMD ["node", "server.js"]
@@ -0,0 +1,48 @@
1
+ # Multi-stage Dockerfile for xithead proxy server
2
+ FROM python:3.11-slim as builder
3
+
4
+ WORKDIR /app
5
+
6
+ # Install build dependencies
7
+ RUN apt-get update && apt-get install -y --no-install-recommends \
8
+ build-essential gcc g++ git curl \
9
+ && rm -rf /var/lib/apt/lists/*
10
+
11
+ # Copy dependency files
12
+ COPY pyproject.toml uv.lock ./
13
+
14
+ # Install uv and dependencies
15
+ RUN pip install --no-cache-dir uv && \
16
+ uv pip install --system -e ".[proxy]"
17
+
18
+ # Runtime stage
19
+ FROM python:3.11-slim
20
+
21
+ WORKDIR /app
22
+
23
+ # Install runtime dependencies only
24
+ RUN apt-get update && apt-get install -y --no-install-recommends \
25
+ ca-certificates curl \
26
+ && rm -rf /var/lib/apt/lists/*
27
+
28
+ # Copy installed packages from builder
29
+ COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
30
+ COPY --from=builder /usr/local/bin /usr/local/bin
31
+
32
+ # Copy application code
33
+ COPY headroom/ ./headroom/
34
+ COPY xithead/ ./xithead/
35
+
36
+ # Create non-root user
37
+ RUN useradd -m -u 1000 headroom && chown -R headroom:headroom /app
38
+ USER headroom
39
+
40
+ # Expose proxy port
41
+ EXPOSE 8787
42
+
43
+ # Health check
44
+ HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
45
+ CMD curl -f http://localhost:8787/health || exit 1
46
+
47
+ # Run proxy
48
+ CMD ["headroom", "proxy"]
package/ENTERPRISE.md ADDED
@@ -0,0 +1,5 @@
1
+ # Enterprise
2
+
3
+ ## Enterprise Support
4
+
5
+ Interested in using Headroom at scale? We're happy to discuss your deployment requirements! Email us at: **hello@headroomlabs.ai**
@@ -0,0 +1,311 @@
1
+ # Advanced Features Guide
2
+
3
+ Xithead ist jetzt noch leistungsfähiger mit erweiterten Caching-, Kompression- und Learning-Systemen.
4
+
5
+ ## 🚀 Neue Features
6
+
7
+ ### 1. **Model Selection & Management**
8
+
9
+ Interaktive Model-Auswahl mit detaillierten Informationen:
10
+
11
+ ```bash
12
+ # Zeige alle verfügbaren Modelle
13
+ headroom models list
14
+
15
+ # Zeige Modelle mit Preisen
16
+ headroom models list --pricing
17
+
18
+ # Zeige Modelle mit Context-Limits
19
+ headroom models list --context
20
+
21
+ # Interaktive Auswahl
22
+ headroom models select
23
+
24
+ # Direktes Modell setzen und speichern
25
+ headroom models select claude-3-sonnet --remember
26
+
27
+ # Zeige aktuelles Modell
28
+ headroom models current
29
+
30
+ # Verwalte Favoriten
31
+ headroom models favorites
32
+ ```
33
+
34
+ **Features:**
35
+ - ✅ Alle 100+ Modelle aufgelistet (OpenAI, Anthropic, Google, Mistral, Cohere)
36
+ - ✅ Live-Preise und Context-Window-Info
37
+ - ✅ Favorite-Modelle speichern
38
+ - ✅ Automatische Empfehlungen basierend auf Kosten/Performance
39
+
40
+ ### 2. **Adaptive Caching Strategy**
41
+
42
+ Das System lernt automatisch optimal TTL und Kompressions-Strategie:
43
+
44
+ ```python
45
+ from headroom.cache.adaptive_strategy import AdaptiveStrategy
46
+
47
+ strategy = AdaptiveStrategy()
48
+
49
+ # Record eine Cache-Event für Lernloop
50
+ strategy.record_cache_event(
51
+ message_type="code",
52
+ ttl_seconds=3600,
53
+ cache_busts=2,
54
+ compression_effective=True,
55
+ tokens_saved=500,
56
+ model="claude-3-sonnet"
57
+ )
58
+
59
+ # Get optimale TTL für Message-Type
60
+ optimal_ttl = strategy.get_optimal_ttl("code") # z.B. 1800 (statt 3600)
61
+
62
+ # Get Einsparungsschätzung
63
+ savings = strategy.estimate_savings("code", hours=24)
64
+ # {"tokens_saved": 15000, "estimated_cost_saved": 0.0045, "events": 42}
65
+
66
+ # Get Statistiken
67
+ stats = strategy.get_stats()
68
+ ```
69
+
70
+ **Features:**
71
+ - ✅ Auto-Tuning von TTL basierend auf Cache-Busts
72
+ - ✅ Per-Nachrichtentyp optimiert (code, text, json, mixed)
73
+ - ✅ 7-Tage Rolling-Window Analyse
74
+ - ✅ Cache-Bust-Reduktion durch ML-Learning
75
+
76
+ ### 3. **Advanced Compression Engine**
77
+
78
+ Mehrere Kompression-Techniken mit automatischer Auswahl:
79
+
80
+ ```python
81
+ from headroom.compression.advanced import AdvancedCompressor, SmartTrimmer
82
+
83
+ compressor = AdvancedCompressor()
84
+
85
+ # Auto-Technik-Auswahl basierend auf Content-Type
86
+ result = compressor.compress(content)
87
+ # Techniken: whitespace_aggressive, number_reduction,
88
+ # repeated_structure, path_abbreviation,
89
+ # semantic_summarize, comment_removal, xml_collapse
90
+
91
+ # Spezifische Techniken
92
+ result = compressor.compress(
93
+ content,
94
+ techniques=["xml_collapse", "whitespace_aggressive"]
95
+ )
96
+
97
+ # Intelligentes Context-Trimming
98
+ trimmer = SmartTrimmer()
99
+ trimmed = trimmer.trim_to_context_limit(
100
+ messages,
101
+ token_limit=100000,
102
+ preserve_first=2,
103
+ preserve_last=3
104
+ )
105
+
106
+ # Relevanz-basiertes Trimming
107
+ relevant = trimmer.prioritize_by_relevance(
108
+ messages,
109
+ query="how to install",
110
+ top_n=5
111
+ )
112
+ ```
113
+
114
+ **Kompression-Techniken:**
115
+ 1. **Whitespace Aggressive**: Entfernt überflüssige Leerzeichen und Zeilenumbrüche
116
+ 2. **Number Reduction**: Komprimiert große Zahlen (1000 → 1k)
117
+ 3. **Repeated Structure**: Detektiert und dedupliziert Patterns
118
+ 4. **Path Abbreviation**: Kürzt lange Pfade (/home/user/ → ~/)
119
+ 5. **Comment Removal**: Entfernt Kommentare (reversibel tracken)
120
+ 6. **XML Collapse**: Entfernt Whitespace in XML/HTML
121
+ 7. **Semantic Summarize**: Entfernt redundante Sätze
122
+
123
+ ### 4. **Automatic Updates**
124
+
125
+ Automatische Background-Updates (optional):
126
+
127
+ ```bash
128
+ # Manuelles Update
129
+ headroom update
130
+
131
+ # Nur checken, nicht updaten
132
+ headroom update --check
133
+
134
+ # Automatisches Updaten (mit Prompt)
135
+ headroom update --yes
136
+
137
+ # Pre-releases erlauben
138
+ headroom update --pre
139
+ ```
140
+
141
+ **Features:**
142
+ - ✅ Background daemon (optional)
143
+ - ✅ Rate-limited (1x pro Tag)
144
+ - ✅ Opt-out via HEADROOM_AUTO_UPDATE_DISABLE
145
+ - ✅ Auto-Snooze (24h) nach Nutzer-Dismissal
146
+ - ✅ Changelog-Anzeige beim Update
147
+
148
+ Umgebungsvariablen:
149
+ ```bash
150
+ HEADROOM_AUTO_UPDATE_DISABLE=1 # Auto-Updates deaktivieren
151
+ HEADROOM_UPDATE_CHECK=off # Update-Checks deaktivieren
152
+ ```
153
+
154
+ ### 5. **Cost Forecasting & Analytics**
155
+
156
+ Detaillierte Cost-Analyse und Anomalie-Erkennung:
157
+
158
+ ```bash
159
+ # Zeige Cost-Forecasts für heute, Woche, Monat
160
+ headroom analytics forecast
161
+ headroom analytics forecast --budget 500
162
+
163
+ # Zeige Cost-Anomalien
164
+ headroom analytics anomalies
165
+
166
+ # Einsparungsschätzung
167
+ headroom analytics savings
168
+ headroom analytics savings --compression 0.6
169
+ ```
170
+
171
+ **Forecast-Features:**
172
+ - ✅ Tägliche Projektion mit Confidence-Metrik
173
+ - ✅ Wöchliche Trend-Analyse (↑ Anstieg, ↓ Abstieg, → Stabil)
174
+ - ✅ Monatliche Budget-Überwachung
175
+ - ✅ Anomalie-Erkennung (2σ statistische Ausreißer)
176
+ - ✅ Einsparungs-Prognose basierend auf Kompression
177
+
178
+ ```python
179
+ from headroom.analytics.cost_forecasting import CostForecaster
180
+
181
+ forecaster = CostForecaster()
182
+
183
+ # Record einen Request
184
+ forecaster.record_request(
185
+ input_tokens=1000,
186
+ output_tokens=500,
187
+ cost=0.015
188
+ )
189
+
190
+ # Forecasts
191
+ daily = forecaster.forecast_daily()
192
+ weekly = forecaster.forecast_weekly()
193
+ monthly = forecaster.forecast_monthly()
194
+
195
+ # Anomalien
196
+ anomalies = forecaster.detect_anomalies()
197
+
198
+ # Budget-Status
199
+ budget_status = forecaster.get_budget_status(monthly_budget=100.0)
200
+ ```
201
+
202
+ ### 6. **Auto-Updater Service**
203
+
204
+ Daemon-basierte Auto-Updates:
205
+
206
+ ```python
207
+ from headroom.auto_updater import get_auto_updater
208
+
209
+ updater = get_auto_updater()
210
+
211
+ # Start background checks (daemon thread)
212
+ updater.start_background_check()
213
+
214
+ # Check manuell
215
+ if updater.check_for_updates():
216
+ updater.download_update()
217
+
218
+ # Status
219
+ status = updater.get_status()
220
+ # {"current": "1.0.0", "latest": "1.1.0", "available": True, ...}
221
+
222
+ # Snooze für 24h
223
+ updater.snooze_update(hours=24)
224
+
225
+ # Benachrichtigung
226
+ notice = updater.format_update_notice()
227
+ ```
228
+
229
+ ## 📊 Performance Improvements
230
+
231
+ Mit den neuen Features sparen Sie:
232
+
233
+ | Technik | Token-Reduktion | Häufigkeit |
234
+ |---------|-----------------|-----------|
235
+ | Adaptive TTL | 15-25% | Kontinuierlich |
236
+ | Aggressive Kompression | 20-40% | Per-Nachricht |
237
+ | Cache-Hit-Optimierung | 50-90% | Cache-Reads |
238
+ | Relevanz-Trimming | 10-30% | Context-Overflow |
239
+ | **Gesamt** | **50-88%** | **Kombiniert** |
240
+
241
+ ## 🔧 Integration
242
+
243
+ ### In Python-Code:
244
+
245
+ ```python
246
+ from headroom.cache.adaptive_strategy import AdaptiveStrategy
247
+ from headroom.compression.advanced import AdvancedCompressor
248
+ from headroom.analytics.cost_forecasting import CostForecaster
249
+ from headroom.auto_updater import get_auto_updater
250
+
251
+ # Setup
252
+ strategy = AdaptiveStrategy()
253
+ compressor = AdvancedCompressor()
254
+ forecaster = CostForecaster()
255
+ updater = get_auto_updater()
256
+
257
+ # Nutze diese in deinem Proxy/Client
258
+ optimal_ttl = strategy.get_optimal_ttl("code")
259
+ compressed = compressor.compress(content)
260
+ forecaster.record_request(in_tokens, out_tokens, cost)
261
+ updater.start_background_check()
262
+ ```
263
+
264
+ ### Im Proxy:
265
+
266
+ ```python
267
+ # headroom/proxy.py
268
+ from headroom.cache.adaptive_strategy import AdaptiveStrategy
269
+ from headroom.compression.advanced import AdvancedCompressor
270
+
271
+ strategy = AdaptiveStrategy()
272
+ compressor = AdvancedCompressor()
273
+
274
+ # In der Request-Pipeline:
275
+ optimal_ttl = strategy.get_optimal_ttl(message_type)
276
+ compressed = compressor.compress(content)
277
+
278
+ # Bei Response:
279
+ strategy.record_cache_event(message_type, ttl, busts, effective, saved, model)
280
+ ```
281
+
282
+ ## 💾 Daten-Speicherung
283
+
284
+ Alle Daten werden lokal gespeichert:
285
+
286
+ ```
287
+ ~/.headroom/
288
+ ├── model_config.json # Modell-Vorlieben
289
+ ├── adaptive_strategies.json # Gelernte Strategien
290
+ ├── strategy_config.json # TTL/Kompression-Config
291
+ ├── cost_history.json # Tägliche Cost-Records
292
+ ├── auto_update_state.json # Update-Status
293
+ └── update_check.json # Update-Check-Cache
294
+ ```
295
+
296
+ Keine Daten verlassen den lokalen Computer! 🔒
297
+
298
+ ## 🎯 Best Practices
299
+
300
+ 1. **Modelle**: Nutze `headroom models select` um kosten-optimale Modelle zu wählen
301
+ 2. **Caching**: Lass das Adaptive-System für 24h laufen für beste Resultate
302
+ 3. **Kompression**: Aggressive Einstellungen für große Code/JSON Inhalte
303
+ 4. **Monitoring**: Nutze `headroom analytics forecast` wöchentlich zur Budget-Kontrolle
304
+ 5. **Updates**: Enable Auto-Updates für Security-Patches (HEADROOM_AUTO_UPDATE_DISABLE=0)
305
+
306
+ ## 📖 Weitere Ressourcen
307
+
308
+ - `headroom --help` - Alle Befehle
309
+ - `headroom models --help` - Modell-Management
310
+ - `headroom analytics --help` - Analytics-Befehle
311
+ - `headroom update --help` - Update-Optionen
package/Headroom-2.gif ADDED
Binary file
Binary file
package/MANIFEST.in ADDED
@@ -0,0 +1,4 @@
1
+ recursive-include xithead/dashboard *.html *.css *.js
2
+ include xithead/py.typed
3
+ include README.md
4
+ include LICENSE