xithead 1.2.2 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (659) hide show
  1. package/.actrc +14 -0
  2. package/.actrc.local.example +15 -0
  3. package/.changelog.md +2 -0
  4. package/.claude/agents/academic-anthropologist.md +125 -0
  5. package/.claude/agents/academic-geographer.md +127 -0
  6. package/.claude/agents/academic-historian.md +123 -0
  7. package/.claude/agents/academic-narratologist.md +118 -0
  8. package/.claude/agents/academic-psychologist.md +118 -0
  9. package/.claude/agents/academic-statistician.md +144 -0
  10. package/.claude/agents/accounts-payable-agent.md +205 -0
  11. package/.claude/agents/agentic-identity-trust.md +394 -0
  12. package/.claude/agents/agents-orchestrator.md +367 -0
  13. package/.claude/agents/automation-governance-architect.md +216 -0
  14. package/.claude/agents/blender-addon-engineer.md +243 -0
  15. package/.claude/agents/business-strategist.md +488 -0
  16. package/.claude/agents/change-management-consultant.md +497 -0
  17. package/.claude/agents/chief-financial-officer.md +388 -0
  18. package/.claude/agents/corporate-training-designer.md +192 -0
  19. package/.claude/agents/customer-service.md +398 -0
  20. package/.claude/agents/customer-success-manager.md +460 -0
  21. package/.claude/agents/data-consolidation-agent.md +60 -0
  22. package/.claude/agents/data-privacy-officer.md +412 -0
  23. package/.claude/agents/design-brand-guardian.md +322 -0
  24. package/.claude/agents/design-image-prompt-engineer.md +236 -0
  25. package/.claude/agents/design-inclusive-visuals-specialist.md +73 -0
  26. package/.claude/agents/design-persona-walkthrough.md +272 -0
  27. package/.claude/agents/design-ui-designer.md +386 -0
  28. package/.claude/agents/design-ui-finish-gate-reviewer.md +217 -0
  29. package/.claude/agents/design-ux-architect.md +482 -0
  30. package/.claude/agents/design-ux-researcher.md +329 -0
  31. package/.claude/agents/design-visual-storyteller.md +149 -0
  32. package/.claude/agents/design-whimsy-injector.md +460 -0
  33. package/.claude/agents/economy-designer.md +156 -0
  34. package/.claude/agents/engineering-ai-data-remediation-engineer.md +211 -0
  35. package/.claude/agents/engineering-ai-engineer.md +146 -0
  36. package/.claude/agents/engineering-api-platform-engineer.md +181 -0
  37. package/.claude/agents/engineering-ats-validator-architect.md +383 -0
  38. package/.claude/agents/engineering-autonomous-optimization-architect.md +121 -0
  39. package/.claude/agents/engineering-backend-architect.md +255 -0
  40. package/.claude/agents/engineering-china-network-engineer.md +252 -0
  41. package/.claude/agents/engineering-cms-developer.md +536 -0
  42. package/.claude/agents/engineering-code-reviewer.md +76 -0
  43. package/.claude/agents/engineering-codebase-onboarding-engineer.md +173 -0
  44. package/.claude/agents/engineering-data-engineer.md +349 -0
  45. package/.claude/agents/engineering-data-visualization-engineer.md +151 -0
  46. package/.claude/agents/engineering-database-optimizer.md +188 -0
  47. package/.claude/agents/engineering-database-reliability-engineer.md +201 -0
  48. package/.claude/agents/engineering-desktop-app-engineer.md +209 -0
  49. package/.claude/agents/engineering-developer-tooling-engineer.md +153 -0
  50. package/.claude/agents/engineering-devops-automator.md +385 -0
  51. package/.claude/agents/engineering-drupal-performance.md +347 -0
  52. package/.claude/agents/engineering-drupal-shopping-cart.md +360 -0
  53. package/.claude/agents/engineering-electrical-engineer.md +575 -0
  54. package/.claude/agents/engineering-email-intelligence-engineer.md +390 -0
  55. package/.claude/agents/engineering-embedded-firmware-engineer.md +196 -0
  56. package/.claude/agents/engineering-feishu-integration-developer.md +606 -0
  57. package/.claude/agents/engineering-filament-optimization-specialist.md +283 -0
  58. package/.claude/agents/engineering-finops-engineer.md +164 -0
  59. package/.claude/agents/engineering-frontend-developer.md +257 -0
  60. package/.claude/agents/engineering-gaussdb-expert.md +334 -0
  61. package/.claude/agents/engineering-git-workflow-master.md +98 -0
  62. package/.claude/agents/engineering-i18n-engineer.md +214 -0
  63. package/.claude/agents/engineering-identity-access-engineer.md +217 -0
  64. package/.claude/agents/engineering-incident-response-commander.md +444 -0
  65. package/.claude/agents/engineering-iot-fleet-engineer.md +148 -0
  66. package/.claude/agents/engineering-it-service-manager.md +561 -0
  67. package/.claude/agents/engineering-knowledge-graph-engineer.md +372 -0
  68. package/.claude/agents/engineering-llm-post-training-engineer.md +166 -0
  69. package/.claude/agents/engineering-minimal-change-engineer.md +207 -0
  70. package/.claude/agents/engineering-mobile-app-builder.md +493 -0
  71. package/.claude/agents/engineering-mobile-release-engineer.md +164 -0
  72. package/.claude/agents/engineering-multi-agent-systems-architect.md +600 -0
  73. package/.claude/agents/engineering-network-engineer.md +245 -0
  74. package/.claude/agents/engineering-orgscript-engineer.md +113 -0
  75. package/.claude/agents/engineering-payments-billing-engineer.md +228 -0
  76. package/.claude/agents/engineering-pdf-engine-architect.md +696 -0
  77. package/.claude/agents/engineering-platform-engineer.md +270 -0
  78. package/.claude/agents/engineering-privacy-engineer.md +152 -0
  79. package/.claude/agents/engineering-prompt-engineer.md +209 -0
  80. package/.claude/agents/engineering-rag-pipeline-engineer.md +450 -0
  81. package/.claude/agents/engineering-rapid-prototyper.md +466 -0
  82. package/.claude/agents/engineering-realtime-collaboration-engineer.md +200 -0
  83. package/.claude/agents/engineering-rust-refactoring-specialist.md +313 -0
  84. package/.claude/agents/engineering-search-relevance-engineer.md +237 -0
  85. package/.claude/agents/engineering-section-508-specialist.md +339 -0
  86. package/.claude/agents/engineering-senior-developer.md +176 -0
  87. package/.claude/agents/engineering-servicenow-developer-mentor.md +180 -0
  88. package/.claude/agents/engineering-software-architect.md +112 -0
  89. package/.claude/agents/engineering-solidity-smart-contract-engineer.md +522 -0
  90. package/.claude/agents/engineering-sre.md +90 -0
  91. package/.claude/agents/engineering-technical-writer.md +393 -0
  92. package/.claude/agents/engineering-universal-document-compiler.md +370 -0
  93. package/.claude/agents/engineering-uswds-developer.md +340 -0
  94. package/.claude/agents/engineering-video-streaming-engineer.md +151 -0
  95. package/.claude/agents/engineering-voice-ai-integration-engineer.md +584 -0
  96. package/.claude/agents/engineering-webassembly-engineer.md +153 -0
  97. package/.claude/agents/engineering-wechat-mini-program-developer.md +356 -0
  98. package/.claude/agents/engineering-wordpress-performance.md +346 -0
  99. package/.claude/agents/engineering-wordpress-shopping-cart.md +346 -0
  100. package/.claude/agents/esg-sustainability-officer.md +396 -0
  101. package/.claude/agents/finance-bookkeeper-controller.md +260 -0
  102. package/.claude/agents/finance-financial-analyst.md +234 -0
  103. package/.claude/agents/finance-fpa-analyst.md +263 -0
  104. package/.claude/agents/finance-investment-researcher.md +272 -0
  105. package/.claude/agents/finance-tax-strategist.md +239 -0
  106. package/.claude/agents/game-audio-engineer.md +264 -0
  107. package/.claude/agents/game-designer.md +167 -0
  108. package/.claude/agents/gis-3d-scene-developer.md +111 -0
  109. package/.claude/agents/gis-analyst.md +91 -0
  110. package/.claude/agents/gis-bim-specialist.md +108 -0
  111. package/.claude/agents/gis-cartography-designer.md +150 -0
  112. package/.claude/agents/gis-drone-reality-mapping.md +120 -0
  113. package/.claude/agents/gis-geoai-ml-engineer.md +105 -0
  114. package/.claude/agents/gis-geoprocessing-specialist.md +97 -0
  115. package/.claude/agents/gis-qa-engineer.md +133 -0
  116. package/.claude/agents/gis-solution-engineer.md +101 -0
  117. package/.claude/agents/gis-spatial-data-engineer.md +97 -0
  118. package/.claude/agents/gis-spatial-data-scientist.md +111 -0
  119. package/.claude/agents/gis-technical-consultant.md +86 -0
  120. package/.claude/agents/gis-web-gis-developer.md +108 -0
  121. package/.claude/agents/godot-gameplay-scripter.md +338 -0
  122. package/.claude/agents/godot-multiplayer-engineer.md +301 -0
  123. package/.claude/agents/godot-shader-developer.md +267 -0
  124. package/.claude/agents/government-digital-presales-consultant.md +363 -0
  125. package/.claude/agents/grant-writer.md +511 -0
  126. package/.claude/agents/healthcare-aging-parent-care-companion.md +414 -0
  127. package/.claude/agents/healthcare-clinical-evidence-agent.md +231 -0
  128. package/.claude/agents/healthcare-customer-service.md +389 -0
  129. package/.claude/agents/healthcare-innovation-strategist.md +433 -0
  130. package/.claude/agents/healthcare-marketing-compliance.md +395 -0
  131. package/.claude/agents/healthcare-sovereign-health-systems-agent.md +312 -0
  132. package/.claude/agents/hospitality-guest-services.md +603 -0
  133. package/.claude/agents/hr-onboarding.md +451 -0
  134. package/.claude/agents/identity-graph-operator.md +303 -0
  135. package/.claude/agents/language-translator.md +264 -0
  136. package/.claude/agents/legal-billing-time-tracking.md +569 -0
  137. package/.claude/agents/legal-client-intake.md +492 -0
  138. package/.claude/agents/legal-document-review.md +454 -0
  139. package/.claude/agents/level-designer.md +208 -0
  140. package/.claude/agents/loan-officer-assistant.md +555 -0
  141. package/.claude/agents/lsp-index-engineer.md +320 -0
  142. package/.claude/agents/ma-integration-manager.md +427 -0
  143. package/.claude/agents/macos-spatial-metal-engineer.md +337 -0
  144. package/.claude/agents/marketing-aeo-foundations.md +264 -0
  145. package/.claude/agents/marketing-agentic-search-optimizer.md +279 -0
  146. package/.claude/agents/marketing-ai-citation-strategist.md +172 -0
  147. package/.claude/agents/marketing-app-store-optimizer.md +321 -0
  148. package/.claude/agents/marketing-baidu-seo-specialist.md +226 -0
  149. package/.claude/agents/marketing-bilibili-content-strategist.md +199 -0
  150. package/.claude/agents/marketing-book-co-author.md +110 -0
  151. package/.claude/agents/marketing-carousel-growth-engine.md +204 -0
  152. package/.claude/agents/marketing-china-ecommerce-operator.md +283 -0
  153. package/.claude/agents/marketing-china-market-localization-strategist.md +283 -0
  154. package/.claude/agents/marketing-content-creator.md +54 -0
  155. package/.claude/agents/marketing-cross-border-ecommerce.md +259 -0
  156. package/.claude/agents/marketing-developer-community-builder.md +285 -0
  157. package/.claude/agents/marketing-douyin-strategist.md +149 -0
  158. package/.claude/agents/marketing-email-strategist.md +249 -0
  159. package/.claude/agents/marketing-global-podcast-strategist.md +206 -0
  160. package/.claude/agents/marketing-growth-hacker.md +54 -0
  161. package/.claude/agents/marketing-instagram-curator.md +113 -0
  162. package/.claude/agents/marketing-kuaishou-strategist.md +223 -0
  163. package/.claude/agents/marketing-linkedin-content-creator.md +214 -0
  164. package/.claude/agents/marketing-livestream-commerce-coach.md +305 -0
  165. package/.claude/agents/marketing-multi-platform-publisher.md +217 -0
  166. package/.claude/agents/marketing-podcast-strategist.md +277 -0
  167. package/.claude/agents/marketing-pr-communications-manager.md +473 -0
  168. package/.claude/agents/marketing-private-domain-operator.md +308 -0
  169. package/.claude/agents/marketing-reddit-community-builder.md +123 -0
  170. package/.claude/agents/marketing-seo-specialist.md +370 -0
  171. package/.claude/agents/marketing-short-video-editing-coach.md +412 -0
  172. package/.claude/agents/marketing-social-media-strategist.md +125 -0
  173. package/.claude/agents/marketing-tiktok-strategist.md +125 -0
  174. package/.claude/agents/marketing-twitter-engager.md +126 -0
  175. package/.claude/agents/marketing-video-optimization-specialist.md +119 -0
  176. package/.claude/agents/marketing-wechat-official-account.md +145 -0
  177. package/.claude/agents/marketing-weibo-strategist.md +240 -0
  178. package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +161 -0
  179. package/.claude/agents/marketing-xiaohongshu-specialist.md +138 -0
  180. package/.claude/agents/marketing-zhihu-strategist.md +162 -0
  181. package/.claude/agents/medical-billing-coding-specialist.md +491 -0
  182. package/.claude/agents/narrative-designer.md +243 -0
  183. package/.claude/agents/operations-manager.md +399 -0
  184. package/.claude/agents/organizational-psychologist.md +391 -0
  185. package/.claude/agents/paid-media-auditor.md +71 -0
  186. package/.claude/agents/paid-media-creative-strategist.md +71 -0
  187. package/.claude/agents/paid-media-paid-social-strategist.md +71 -0
  188. package/.claude/agents/paid-media-ppc-strategist.md +71 -0
  189. package/.claude/agents/paid-media-programmatic-buyer.md +71 -0
  190. package/.claude/agents/paid-media-search-query-analyst.md +71 -0
  191. package/.claude/agents/paid-media-tracking-specialist.md +71 -0
  192. package/.claude/agents/personal-growth-mentor.md +159 -0
  193. package/.claude/agents/product-behavioral-nudge-engine.md +83 -0
  194. package/.claude/agents/product-dx-engineer.md +332 -0
  195. package/.claude/agents/product-feedback-synthesizer.md +119 -0
  196. package/.claude/agents/product-manager.md +469 -0
  197. package/.claude/agents/product-sprint-prioritizer.md +154 -0
  198. package/.claude/agents/product-trend-researcher.md +159 -0
  199. package/.claude/agents/project-management-experiment-tracker.md +198 -0
  200. package/.claude/agents/project-management-jira-workflow-steward.md +233 -0
  201. package/.claude/agents/project-management-meeting-notes-specialist.md +95 -0
  202. package/.claude/agents/project-management-project-shepherd.md +194 -0
  203. package/.claude/agents/project-management-studio-operations.md +200 -0
  204. package/.claude/agents/project-management-studio-producer.md +203 -0
  205. package/.claude/agents/project-manager-senior.md +135 -0
  206. package/.claude/agents/real-estate-buyer-seller.md +596 -0
  207. package/.claude/agents/recruitment-specialist.md +515 -0
  208. package/.claude/agents/report-distribution-agent.md +65 -0
  209. package/.claude/agents/research-synthesist.md +136 -0
  210. package/.claude/agents/resume-tailor.md +230 -0
  211. package/.claude/agents/retail-customer-returns.md +566 -0
  212. package/.claude/agents/roblox-avatar-creator.md +297 -0
  213. package/.claude/agents/roblox-experience-designer.md +306 -0
  214. package/.claude/agents/roblox-systems-scripter.md +332 -0
  215. package/.claude/agents/sales-account-strategist.md +227 -0
  216. package/.claude/agents/sales-coach.md +271 -0
  217. package/.claude/agents/sales-data-extraction-agent.md +67 -0
  218. package/.claude/agents/sales-deal-strategist.md +180 -0
  219. package/.claude/agents/sales-discovery-coach.md +225 -0
  220. package/.claude/agents/sales-engineer.md +182 -0
  221. package/.claude/agents/sales-offer-lead-gen-strategist.md +257 -0
  222. package/.claude/agents/sales-outbound-strategist.md +201 -0
  223. package/.claude/agents/sales-outreach.md +425 -0
  224. package/.claude/agents/sales-pipeline-analyst.md +267 -0
  225. package/.claude/agents/sales-proposal-strategist.md +217 -0
  226. package/.claude/agents/security-ai-generated-code-auditor.md +207 -0
  227. package/.claude/agents/security-appsec-engineer.md +536 -0
  228. package/.claude/agents/security-architect.md +307 -0
  229. package/.claude/agents/security-blockchain-security-auditor.md +482 -0
  230. package/.claude/agents/security-cloud-security-architect.md +576 -0
  231. package/.claude/agents/security-compliance-auditor.md +158 -0
  232. package/.claude/agents/security-incident-responder.md +450 -0
  233. package/.claude/agents/security-penetration-tester.md +399 -0
  234. package/.claude/agents/security-secrets-credential-engineer.md +189 -0
  235. package/.claude/agents/security-senior-secops.md +760 -0
  236. package/.claude/agents/security-threat-detection-engineer.md +553 -0
  237. package/.claude/agents/security-threat-intelligence-analyst.md +661 -0
  238. package/.claude/agents/specialized-chief-of-staff.md +279 -0
  239. package/.claude/agents/specialized-civil-engineer.md +356 -0
  240. package/.claude/agents/specialized-codebase-archaeologist.md +341 -0
  241. package/.claude/agents/specialized-cultural-intelligence-strategist.md +88 -0
  242. package/.claude/agents/specialized-developer-advocate.md +317 -0
  243. package/.claude/agents/specialized-document-generator.md +55 -0
  244. package/.claude/agents/specialized-fedramp-rmf-compliance.md +378 -0
  245. package/.claude/agents/specialized-focus-music-architect.md +175 -0
  246. package/.claude/agents/specialized-french-consulting-market.md +194 -0
  247. package/.claude/agents/specialized-korean-business-navigator.md +216 -0
  248. package/.claude/agents/specialized-master-plan-architect.md +157 -0
  249. package/.claude/agents/specialized-mcp-builder.md +260 -0
  250. package/.claude/agents/specialized-model-qa.md +528 -0
  251. package/.claude/agents/specialized-pricing-analyst.md +243 -0
  252. package/.claude/agents/specialized-salesforce-architect.md +182 -0
  253. package/.claude/agents/specialized-strategy-duel-agent.md +130 -0
  254. package/.claude/agents/specialized-workflow-architect.md +597 -0
  255. package/.claude/agents/study-abroad-advisor.md +282 -0
  256. package/.claude/agents/supply-chain-strategist.md +591 -0
  257. package/.claude/agents/support-analytics-reporter.md +387 -0
  258. package/.claude/agents/support-executive-summary-generator.md +212 -0
  259. package/.claude/agents/support-finance-tracker.md +480 -0
  260. package/.claude/agents/support-infrastructure-maintainer.md +628 -0
  261. package/.claude/agents/support-legal-compliance-checker.md +591 -0
  262. package/.claude/agents/support-support-responder.md +607 -0
  263. package/.claude/agents/technical-artist.md +233 -0
  264. package/.claude/agents/terminal-integration-specialist.md +70 -0
  265. package/.claude/agents/testing-accessibility-auditor.md +327 -0
  266. package/.claude/agents/testing-api-tester.md +334 -0
  267. package/.claude/agents/testing-evidence-collector.md +210 -0
  268. package/.claude/agents/testing-performance-benchmarker.md +283 -0
  269. package/.claude/agents/testing-reality-checker.md +249 -0
  270. package/.claude/agents/testing-test-automation-engineer.md +196 -0
  271. package/.claude/agents/testing-test-results-analyzer.md +330 -0
  272. package/.claude/agents/testing-tool-evaluator.md +416 -0
  273. package/.claude/agents/testing-workflow-optimizer.md +463 -0
  274. package/.claude/agents/unity-architect.md +271 -0
  275. package/.claude/agents/unity-editor-tool-developer.md +310 -0
  276. package/.claude/agents/unity-multiplayer-engineer.md +323 -0
  277. package/.claude/agents/unity-shader-graph-artist.md +269 -0
  278. package/.claude/agents/unreal-multiplayer-architect.md +364 -0
  279. package/.claude/agents/unreal-systems-engineer.md +322 -0
  280. package/.claude/agents/unreal-technical-artist.md +256 -0
  281. package/.claude/agents/unreal-world-builder.md +273 -0
  282. package/.claude/agents/visionos-spatial-engineer.md +54 -0
  283. package/.claude/agents/xr-cockpit-interaction-specialist.md +32 -0
  284. package/.claude/agents/xr-immersive-developer.md +32 -0
  285. package/.claude/agents/xr-interface-architect.md +32 -0
  286. package/.claude/agents/zk-steward.md +211 -0
  287. package/.claude-plugin/marketplace.json +30 -0
  288. package/.commitlintrc.json +26 -0
  289. package/.devcontainer/Dockerfile +24 -0
  290. package/.devcontainer/devcontainer.json +70 -0
  291. package/.devcontainer/docker-compose.memory.yml +42 -0
  292. package/.devcontainer/memory-stack/devcontainer.json +84 -0
  293. package/.devcontainer/post-create.sh +83 -0
  294. package/.dockerignore +23 -0
  295. package/.env.act.example +15 -0
  296. package/.env.example +171 -0
  297. package/.eslintrc.json +16 -0
  298. package/.git-blame-ignore-revs +10 -0
  299. package/.gitattributes +2 -0
  300. package/.gitguardian.yaml +50 -0
  301. package/.githooks/pre-commit +6 -0
  302. package/.pre-commit-config.yaml +30 -0
  303. package/.release-please-config-xithead.json +22 -0
  304. package/.release-please-config.json +44 -0
  305. package/.release-please-manifest-xithead.json +3 -0
  306. package/.release-please-manifest.json +3 -0
  307. package/CODE_OF_CONDUCT.md +133 -0
  308. package/CONTRIBUTING.md +133 -0
  309. package/Cargo.lock +5557 -0
  310. package/Cargo.toml +121 -0
  311. package/Dockerfile +38 -0
  312. package/Dockerfile.proxy +48 -0
  313. package/ENTERPRISE.md +5 -0
  314. package/FEATURES_ADVANCED.md +311 -0
  315. package/Headroom-2.gif +0 -0
  316. package/HeadroomDemo-Fast.gif +0 -0
  317. package/MANIFEST.in +4 -0
  318. package/MODERNIZATION_GUIDE.md +358 -0
  319. package/Makefile +140 -0
  320. package/NOTICE +43 -0
  321. package/NPM_TOKEN_SETUP.md +81 -0
  322. package/PR.md +170 -0
  323. package/PUBLISH.md +77 -0
  324. package/README.md +58 -137
  325. package/README_FRONTEND.md +196 -0
  326. package/REALIGNMENT/00-overview.md +53 -0
  327. package/REALIGNMENT/01-bug-list.md +421 -0
  328. package/REALIGNMENT/02-architecture.md +322 -0
  329. package/REALIGNMENT/03-phase-A-lockdown.md +420 -0
  330. package/REALIGNMENT/04-phase-B-live-zone.md +470 -0
  331. package/REALIGNMENT/05-phase-C-rust-proxy.md +329 -0
  332. package/REALIGNMENT/06-phase-D-bedrock-vertex.md +222 -0
  333. package/REALIGNMENT/07-phase-E-cache-stabilization.md +338 -0
  334. package/REALIGNMENT/08-phase-F-auth-mode.md +254 -0
  335. package/REALIGNMENT/09-phase-G-rtk-observability.md +194 -0
  336. package/REALIGNMENT/10-phase-H-python-retirement.md +214 -0
  337. package/REALIGNMENT/11-phase-I-test-infra.md +385 -0
  338. package/REALIGNMENT/12-decisions-needed.md +196 -0
  339. package/REALIGNMENT/INDEX.md +82 -0
  340. package/REFACTORING_CAMPAIGN.md +277 -0
  341. package/RESTRUCTURE_PLAN.md +100 -0
  342. package/RUST_DEV.md +361 -0
  343. package/SECURITY.md +65 -0
  344. package/SETUP_AUTO_PUBLISH.md +164 -0
  345. package/TESTING-copilot-subscription.md +153 -0
  346. package/app/api/config/route.ts +22 -0
  347. package/app/api/export/route.ts +83 -0
  348. package/app/api/models/route.ts +12 -0
  349. package/app/api/stats/route.ts +46 -0
  350. package/app/dashboard/page.tsx +445 -0
  351. package/app/globals.css +35 -0
  352. package/app/installation/page.tsx +293 -0
  353. package/app/layout.tsx +35 -0
  354. package/app/master-design-system.css +2076 -0
  355. package/app/master-design-system.source.css +8 -0
  356. package/app/page.tsx +187 -0
  357. package/app/rechtliches/agb/page.tsx +165 -0
  358. package/app/rechtliches/datenschutz/page.tsx +128 -0
  359. package/app/rechtliches/impressum/page.tsx +122 -0
  360. package/app/rechtliches/widerruf/page.tsx +185 -0
  361. package/bin/xithead.js +264 -0
  362. package/codecov.yml +34 -0
  363. package/components/layout/AppShell.tsx +25 -0
  364. package/components/layout/Footer.tsx +120 -0
  365. package/components/layout/Header.tsx +145 -0
  366. package/components/marketing/LegalHighlights.tsx +45 -0
  367. package/components/marketing/LegalPageShell.tsx +49 -0
  368. package/components/marketing/LegalPanel.tsx +41 -0
  369. package/components/marketing/index.ts +3 -0
  370. package/crates/headroom-core/Cargo.toml +165 -0
  371. package/crates/headroom-core/benches/auth_mode.rs +74 -0
  372. package/crates/headroom-core/benches/ccr_store.rs +224 -0
  373. package/crates/headroom-core/benches/tokenizer.rs +52 -0
  374. package/crates/headroom-core/config/pipeline.toml +151 -0
  375. package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +9 -0
  376. package/crates/headroom-core/src/auth_mode.rs +250 -0
  377. package/crates/headroom-core/src/cache_control.rs +414 -0
  378. package/crates/headroom-core/src/ccr/backends/in_memory.rs +317 -0
  379. package/crates/headroom-core/src/ccr/backends/mod.rs +152 -0
  380. package/crates/headroom-core/src/ccr/backends/redis.rs +146 -0
  381. package/crates/headroom-core/src/ccr/backends/sqlite.rs +205 -0
  382. package/crates/headroom-core/src/ccr/mod.rs +119 -0
  383. package/crates/headroom-core/src/compression_policy.rs +505 -0
  384. package/crates/headroom-core/src/lib.rs +33 -0
  385. package/crates/headroom-core/src/relevance/base.rs +139 -0
  386. package/crates/headroom-core/src/relevance/bm25.rs +385 -0
  387. package/crates/headroom-core/src/relevance/embedding.rs +354 -0
  388. package/crates/headroom-core/src/relevance/hybrid.rs +364 -0
  389. package/crates/headroom-core/src/relevance/mod.rs +64 -0
  390. package/crates/headroom-core/src/signals/keyword_detector.rs +433 -0
  391. package/crates/headroom-core/src/signals/line_importance.rs +84 -0
  392. package/crates/headroom-core/src/signals/mod.rs +61 -0
  393. package/crates/headroom-core/src/signals/tiered.rs +141 -0
  394. package/crates/headroom-core/src/tokenizer/estimator.rs +152 -0
  395. package/crates/headroom-core/src/tokenizer/hf_impl.rs +314 -0
  396. package/crates/headroom-core/src/tokenizer/mod.rs +56 -0
  397. package/crates/headroom-core/src/tokenizer/registry.rs +342 -0
  398. package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +265 -0
  399. package/crates/headroom-core/src/transforms/adaptive_sizer.rs +610 -0
  400. package/crates/headroom-core/src/transforms/anchor_selector.rs +1189 -0
  401. package/crates/headroom-core/src/transforms/content_detector.rs +769 -0
  402. package/crates/headroom-core/src/transforms/detection.rs +222 -0
  403. package/crates/headroom-core/src/transforms/diff_compressor.rs +1685 -0
  404. package/crates/headroom-core/src/transforms/live_zone.rs +2967 -0
  405. package/crates/headroom-core/src/transforms/log_compressor.rs +1295 -0
  406. package/crates/headroom-core/src/transforms/magika_detector.rs +395 -0
  407. package/crates/headroom-core/src/transforms/mod.rs +64 -0
  408. package/crates/headroom-core/src/transforms/pipeline/config.rs +331 -0
  409. package/crates/headroom-core/src/transforms/pipeline/mod.rs +103 -0
  410. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +524 -0
  411. package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +279 -0
  412. package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +400 -0
  413. package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +284 -0
  414. package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +34 -0
  415. package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +331 -0
  416. package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +848 -0
  417. package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +175 -0
  418. package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +545 -0
  419. package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +12 -0
  420. package/crates/headroom-core/src/transforms/pipeline/traits.rs +338 -0
  421. package/crates/headroom-core/src/transforms/recommendations.rs +329 -0
  422. package/crates/headroom-core/src/transforms/safety.rs +215 -0
  423. package/crates/headroom-core/src/transforms/search_compressor.rs +902 -0
  424. package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +1262 -0
  425. package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +407 -0
  426. package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +263 -0
  427. package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +214 -0
  428. package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +283 -0
  429. package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +733 -0
  430. package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +961 -0
  431. package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +252 -0
  432. package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +127 -0
  433. package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +397 -0
  434. package/crates/headroom-core/src/transforms/smart_crusher/config.rs +173 -0
  435. package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +159 -0
  436. package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +1665 -0
  437. package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +865 -0
  438. package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +77 -0
  439. package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +393 -0
  440. package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +72 -0
  441. package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +81 -0
  442. package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +66 -0
  443. package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +459 -0
  444. package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +507 -0
  445. package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +904 -0
  446. package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +510 -0
  447. package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +287 -0
  448. package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +203 -0
  449. package/crates/headroom-core/src/transforms/smart_crusher/types.rs +263 -0
  450. package/crates/headroom-core/src/transforms/tag_protector.rs +1272 -0
  451. package/crates/headroom-core/src/transforms/unidiff_detector.rs +232 -0
  452. package/crates/headroom-parity/Cargo.toml +26 -0
  453. package/crates/headroom-parity/examples/diff_fixture.rs +66 -0
  454. package/crates/headroom-parity/src/bin/parity_run.rs +78 -0
  455. package/crates/headroom-parity/src/lib.rs +613 -0
  456. package/crates/headroom-proxy/Cargo.toml +119 -0
  457. package/crates/headroom-proxy/data/model_prices_and_context_window.json +39767 -0
  458. package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +192 -0
  459. package/crates/headroom-proxy/src/bedrock/envelope.rs +239 -0
  460. package/crates/headroom-proxy/src/bedrock/eventstream.rs +769 -0
  461. package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +459 -0
  462. package/crates/headroom-proxy/src/bedrock/invoke.rs +735 -0
  463. package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +1098 -0
  464. package/crates/headroom-proxy/src/bedrock/mod.rs +66 -0
  465. package/crates/headroom-proxy/src/bedrock/sigv4.rs +324 -0
  466. package/crates/headroom-proxy/src/bedrock/vendor.rs +82 -0
  467. package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +698 -0
  468. package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +683 -0
  469. package/crates/headroom-proxy/src/cache_stabilization/mod.rs +61 -0
  470. package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +600 -0
  471. package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +514 -0
  472. package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +720 -0
  473. package/crates/headroom-proxy/src/compression/anthropic.rs +92 -0
  474. package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +1311 -0
  475. package/crates/headroom-proxy/src/compression/live_zone_openai.rs +660 -0
  476. package/crates/headroom-proxy/src/compression/live_zone_responses.rs +678 -0
  477. package/crates/headroom-proxy/src/compression/mod.rs +127 -0
  478. package/crates/headroom-proxy/src/compression/model_limits.rs +211 -0
  479. package/crates/headroom-proxy/src/config.rs +646 -0
  480. package/crates/headroom-proxy/src/error.rs +69 -0
  481. package/crates/headroom-proxy/src/handlers/chat_completions.rs +100 -0
  482. package/crates/headroom-proxy/src/handlers/conversations.rs +241 -0
  483. package/crates/headroom-proxy/src/handlers/mod.rs +13 -0
  484. package/crates/headroom-proxy/src/handlers/responses.rs +256 -0
  485. package/crates/headroom-proxy/src/headers.rs +288 -0
  486. package/crates/headroom-proxy/src/health.rs +41 -0
  487. package/crates/headroom-proxy/src/lib.rs +21 -0
  488. package/crates/headroom-proxy/src/main.rs +141 -0
  489. package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +340 -0
  490. package/crates/headroom-proxy/src/observability/compression_ratio.rs +158 -0
  491. package/crates/headroom-proxy/src/observability/metric_names.rs +174 -0
  492. package/crates/headroom-proxy/src/observability/mod.rs +68 -0
  493. package/crates/headroom-proxy/src/observability/prometheus.rs +394 -0
  494. package/crates/headroom-proxy/src/observability/proxy_metrics.rs +368 -0
  495. package/crates/headroom-proxy/src/proxy.rs +1619 -0
  496. package/crates/headroom-proxy/src/responses_items.rs +565 -0
  497. package/crates/headroom-proxy/src/sse/anthropic.rs +415 -0
  498. package/crates/headroom-proxy/src/sse/framing.rs +366 -0
  499. package/crates/headroom-proxy/src/sse/mod.rs +40 -0
  500. package/crates/headroom-proxy/src/sse/openai_chat.rs +231 -0
  501. package/crates/headroom-proxy/src/sse/openai_responses.rs +458 -0
  502. package/crates/headroom-proxy/src/vertex/adc.rs +315 -0
  503. package/crates/headroom-proxy/src/vertex/envelope.rs +167 -0
  504. package/crates/headroom-proxy/src/vertex/mod.rs +277 -0
  505. package/crates/headroom-proxy/src/vertex/raw_predict.rs +490 -0
  506. package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +49 -0
  507. package/crates/headroom-proxy/src/websocket.rs +246 -0
  508. package/crates/headroom-py/Cargo.toml +37 -0
  509. package/crates/headroom-py/build.rs +77 -0
  510. package/crates/headroom-py/glibc_compat.c +170 -0
  511. package/crates/headroom-py/src/lib.rs +1655 -0
  512. package/deny.toml +32 -0
  513. package/design-system/base.css +127 -0
  514. package/design-system/components.css +1943 -0
  515. package/design-system/fonts.css +17 -0
  516. package/design-system/tailwind-preset.js +95 -0
  517. package/design-system/tokens.css +48 -0
  518. package/design-system/utilities.css +53 -0
  519. package/docker/differential-network-capture/Dockerfile.runner +14 -0
  520. package/docker/differential-network-capture/docker-compose.yml +142 -0
  521. package/docker/differential-network-capture/run-claude-lane.sh +24 -0
  522. package/docker/docker-compose.native.yml +44 -0
  523. package/docker-bake.hcl +88 -0
  524. package/docker-compose.yml +80 -0
  525. package/e2e/_lib/make_shim.ps1 +24 -0
  526. package/e2e/_lib/make_shim.sh +28 -0
  527. package/e2e/docker-native-install.sh +120 -0
  528. package/e2e/init/Dockerfile +79 -0
  529. package/e2e/wrap/Dockerfile +115 -0
  530. package/examples/07-context-compression.ipynb +279 -0
  531. package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +65 -0
  532. package/examples/deployment/macos-launchagent/install.sh +227 -0
  533. package/examples/deployment/macos-launchagent/shell-integration.sh +74 -0
  534. package/examples/deployment/macos-launchagent/uninstall.sh +145 -0
  535. package/headroom-savings.png +0 -0
  536. package/headroom_learn.gif +0 -0
  537. package/lib/config/index.ts +12 -0
  538. package/lib/hooks/index.ts +4 -0
  539. package/lib/hooks/use-mounted.ts +13 -0
  540. package/lib/hooks/use-session.ts +34 -0
  541. package/lib/hooks/use-settings.ts +49 -0
  542. package/lib/utils/index.ts +1 -0
  543. package/lib/utils/settings.ts +162 -0
  544. package/lib/utils/utils.ts +6 -0
  545. package/llms.txt +67 -0
  546. package/middleware.ts +26 -0
  547. package/mkdocs.yml +136 -0
  548. package/next-env.d.ts +7 -0
  549. package/next.config.ts +12 -0
  550. package/npm/bin/xithead.js +2 -2
  551. package/npm/bin/xtream-head.js +366 -0
  552. package/npm/index.js +18 -91
  553. package/npm/package.json +55 -0
  554. package/package.json +47 -42
  555. package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +17 -0
  556. package/plugins/headroom-agent-hooks/hooks/hooks.json +29 -0
  557. package/plugins/headroom-oauth2/LICENSE +3 -0
  558. package/plugins/headroom-oauth2/SPEC.md +115 -0
  559. package/plugins/headroom-oauth2/pyproject.toml +48 -0
  560. package/plugins/hermes/headroom_retrieve/plugin.yaml +6 -0
  561. package/plugins/openclaw/hook-shim/HOOK.md +21 -0
  562. package/plugins/openclaw/hook-shim/handler.js +3 -0
  563. package/plugins/openclaw/openclaw.plugin.json +98 -0
  564. package/plugins/openclaw/package-lock.json +2692 -0
  565. package/plugins/openclaw/package.json +54 -0
  566. package/plugins/openclaw/prepare-dist.mjs +56 -0
  567. package/plugins/openclaw/src/convert.ts +418 -0
  568. package/plugins/openclaw/src/engine.ts +284 -0
  569. package/plugins/openclaw/src/gateway-config.ts +143 -0
  570. package/plugins/openclaw/src/index.ts +11 -0
  571. package/plugins/openclaw/src/plugin/index.ts +98 -0
  572. package/plugins/openclaw/src/proxy-manager.ts +477 -0
  573. package/plugins/openclaw/src/tools/headroom-retrieve.ts +76 -0
  574. package/plugins/openclaw/test/convert.test.ts +96 -0
  575. package/plugins/openclaw/test/engine-normalization.test.ts +21 -0
  576. package/plugins/openclaw/test/engine.test.ts +101 -0
  577. package/plugins/openclaw/test/gateway-config.test.ts +278 -0
  578. package/plugins/openclaw/test/plugin-runtime-routing.test.ts +141 -0
  579. package/plugins/openclaw/test/proxy-manager.test.ts +343 -0
  580. package/plugins/openclaw/tsup.config.ts +9 -0
  581. package/postcss.config.mjs +7 -0
  582. package/pyproject.toml +438 -0
  583. package/rust-toolchain.toml +16 -0
  584. package/sdk/typescript/examples/basic-compress.ts +64 -0
  585. package/sdk/typescript/examples/ccr-retrieve.ts +80 -0
  586. package/sdk/typescript/examples/hooks-custom-compression.ts +117 -0
  587. package/sdk/typescript/examples/middleware-composition.ts +59 -0
  588. package/sdk/typescript/examples/multi-provider.ts +53 -0
  589. package/sdk/typescript/examples/openai-anthropic-adapters.ts +73 -0
  590. package/sdk/typescript/examples/shared-context-multi-agent.ts +74 -0
  591. package/sdk/typescript/examples/simulation-dry-run.ts +80 -0
  592. package/sdk/typescript/examples/streaming-chat.ts +71 -0
  593. package/sdk/typescript/examples/structured-output.ts +99 -0
  594. package/sdk/typescript/examples/tool-calling-agent.ts +86 -0
  595. package/sdk/typescript/examples/with-headroom-vercel.ts +57 -0
  596. package/sdk/typescript/package-lock.json +3437 -0
  597. package/sdk/typescript/package.json +108 -0
  598. package/sdk/typescript/src/adapters/anthropic.ts +218 -0
  599. package/sdk/typescript/src/adapters/gemini.ts +83 -0
  600. package/sdk/typescript/src/adapters/openai.ts +77 -0
  601. package/sdk/typescript/src/adapters/vercel-ai.ts +131 -0
  602. package/sdk/typescript/src/client.ts +632 -0
  603. package/sdk/typescript/src/compress.ts +87 -0
  604. package/sdk/typescript/src/errors.ts +114 -0
  605. package/sdk/typescript/src/hooks.ts +113 -0
  606. package/sdk/typescript/src/index.ts +140 -0
  607. package/sdk/typescript/src/paths.ts +272 -0
  608. package/sdk/typescript/src/shared-context.ts +188 -0
  609. package/sdk/typescript/src/simulate.ts +52 -0
  610. package/sdk/typescript/src/types/config.ts +183 -0
  611. package/sdk/typescript/src/types/models.ts +314 -0
  612. package/sdk/typescript/src/types.ts +139 -0
  613. package/sdk/typescript/src/utils/case.ts +34 -0
  614. package/sdk/typescript/src/utils/format.ts +480 -0
  615. package/sdk/typescript/src/utils/stream.ts +50 -0
  616. package/sdk/typescript/test/adapters/anthropic.test.ts +217 -0
  617. package/sdk/typescript/test/adapters/gemini.test.ts +131 -0
  618. package/sdk/typescript/test/adapters/openai.test.ts +174 -0
  619. package/sdk/typescript/test/adapters/vercel-ai.test.ts +306 -0
  620. package/sdk/typescript/test/client-expanded.test.ts +333 -0
  621. package/sdk/typescript/test/client.test.ts +266 -0
  622. package/sdk/typescript/test/compress.test.ts +118 -0
  623. package/sdk/typescript/test/config.test.ts +275 -0
  624. package/sdk/typescript/test/errors.test.ts +169 -0
  625. package/sdk/typescript/test/format-integration.test.ts +252 -0
  626. package/sdk/typescript/test/hooks.test.ts +265 -0
  627. package/sdk/typescript/test/integration.test.ts +249 -0
  628. package/sdk/typescript/test/mdx-examples.test.ts +253 -0
  629. package/sdk/typescript/test/models.test.ts +318 -0
  630. package/sdk/typescript/test/parity.test.ts +337 -0
  631. package/sdk/typescript/test/paths.test.ts +447 -0
  632. package/sdk/typescript/test/shared-context.test.ts +245 -0
  633. package/sdk/typescript/test/simulate.test.ts +84 -0
  634. package/sdk/typescript/test/types.test.ts +244 -0
  635. package/sdk/typescript/test/utils/case.test.ts +129 -0
  636. package/sdk/typescript/test/utils/detect-format.test.ts +133 -0
  637. package/sdk/typescript/test/utils/format.test.ts +434 -0
  638. package/sdk/typescript/test/vercel-ai-e2e.test.ts +179 -0
  639. package/sdk/typescript/tsup.config.ts +17 -0
  640. package/tailwind.master.config.cjs +47 -0
  641. package/types/api.ts +12 -0
  642. package/types/config.ts +9 -0
  643. package/types/index.ts +2 -0
  644. package/uv.lock +6951 -0
  645. package/xithead.egg-info/PKG-INFO +22 -0
  646. package/xithead.egg-info/SOURCES.txt +16 -0
  647. package/xithead.egg-info/dependency_links.txt +1 -0
  648. package/xithead.egg-info/entry_points.txt +2 -0
  649. package/xithead.egg-info/requires.txt +10 -0
  650. package/xithead.egg-info/top_level.txt +2 -0
  651. package/xithead.ps1 +136 -0
  652. package/xithead.sh +129 -0
  653. package/xithead_dist/pyproject.toml +39 -0
  654. package/xithead_dist/xithead.egg-info/PKG-INFO +22 -0
  655. package/xithead_dist/xithead.egg-info/SOURCES.txt +16 -0
  656. package/xithead_dist/xithead.egg-info/dependency_links.txt +1 -0
  657. package/xithead_dist/xithead.egg-info/entry_points.txt +3 -0
  658. package/xithead_dist/xithead.egg-info/requires.txt +10 -0
  659. package/xithead_dist/xithead.egg-info/top_level.txt +2 -0
@@ -0,0 +1,117 @@
1
+ /**
2
+ * Example 07: Custom Compression Hooks
3
+ *
4
+ * Use CompressionHooks to customize what gets compressed and observe results.
5
+ * Hooks run client-side before/after the proxy compression.
6
+ *
7
+ * Run: npx tsx examples/07-hooks-custom-compression.ts
8
+ */
9
+ import { compress, CompressionHooks } from "xtream-head";
10
+ import type { CompressContext, CompressEvent } from "xtream-head";
11
+ import { openai } from "@ai-sdk/openai";
12
+ import { generateText } from "ai";
13
+
14
+ // Track compression stats across multiple calls
15
+ const stats = {
16
+ calls: 0,
17
+ totalSaved: 0,
18
+ transforms: new Map<string, number>(),
19
+ };
20
+
21
+ class ObservabilityHooks extends CompressionHooks {
22
+ /**
23
+ * Add context before compression — inject hints for the compressor.
24
+ */
25
+ preCompress(messages: any[], ctx: CompressContext) {
26
+ console.log(`[hook] Pre-compress: ${messages.length} messages, model=${ctx.model}`);
27
+ console.log(`[hook] User query: "${ctx.userQuery.slice(0, 60)}..."`);
28
+ console.log(`[hook] Tool calls in context: ${ctx.toolCalls.join(", ") || "none"}`);
29
+ return messages;
30
+ }
31
+
32
+ /**
33
+ * Set per-message compression biases.
34
+ * Higher bias = preserve more. Lower bias = compress more aggressively.
35
+ */
36
+ computeBiases(messages: any[], _ctx: CompressContext) {
37
+ const biases: Record<number, number> = {};
38
+ for (let i = 0; i < messages.length; i++) {
39
+ // Always preserve system messages fully
40
+ if (messages[i].role === "system") {
41
+ biases[i] = 2.0;
42
+ }
43
+ // Preserve the last user message (the actual question)
44
+ if (i === messages.length - 1 && messages[i].role === "user") {
45
+ biases[i] = 1.5;
46
+ }
47
+ }
48
+ return biases;
49
+ }
50
+
51
+ /**
52
+ * Observe compression results — log and track stats.
53
+ */
54
+ postCompress(event: CompressEvent) {
55
+ stats.calls++;
56
+ stats.totalSaved += event.tokensSaved;
57
+ for (const t of event.transformsApplied) {
58
+ stats.transforms.set(t, (stats.transforms.get(t) ?? 0) + 1);
59
+ }
60
+
61
+ console.log(`[hook] Post-compress: ${event.tokensBefore} → ${event.tokensAfter} (saved ${event.tokensSaved})`);
62
+ console.log(`[hook] Ratio: ${(event.compressionRatio * 100).toFixed(1)}%`);
63
+ console.log(`[hook] Transforms: ${event.transformsApplied.join(", ")}`);
64
+ if (event.ccrHashes.length > 0) {
65
+ console.log(`[hook] CCR hashes (retrievable): ${event.ccrHashes.join(", ")}`);
66
+ }
67
+ }
68
+ }
69
+
70
+ // Large structured data
71
+ const inventory = Array.from({ length: 75 }, (_, i) => ({
72
+ sku: `SKU-${String(i + 1).padStart(4, "0")}`,
73
+ name: `Product ${i + 1}`,
74
+ category: ["Electronics", "Clothing", "Home", "Sports", "Books"][i % 5],
75
+ price: +(Math.random() * 200 + 10).toFixed(2),
76
+ stock: Math.floor(Math.random() * 500),
77
+ warehouse: ["NYC", "LAX", "ORD", "DFW"][i % 4],
78
+ reorder_point: Math.floor(Math.random() * 50 + 10),
79
+ last_sold: new Date(Date.now() - Math.random() * 7 * 86400000).toISOString(),
80
+ }));
81
+
82
+ async function main() {
83
+ const hooks = new ObservabilityHooks();
84
+
85
+ console.log("=== Call 1: Inventory analysis ===\n");
86
+ const result1 = await compress(
87
+ [
88
+ { role: "system", content: "You are an inventory management assistant." },
89
+ { role: "user", content: "Show me inventory" },
90
+ {
91
+ role: "assistant",
92
+ content: null,
93
+ tool_calls: [{ id: "c1", type: "function", function: { name: "get_inventory", arguments: "{}" } }],
94
+ },
95
+ { role: "tool", content: JSON.stringify(inventory), tool_call_id: "c1" },
96
+ { role: "user", content: "Which items are below reorder point and need restocking?" },
97
+ ],
98
+ { model: "gpt-4o", hooks },
99
+ );
100
+
101
+ // Use compressed messages
102
+ const { text } = await generateText({
103
+ model: openai("gpt-4o"),
104
+ messages: result1.messages,
105
+ });
106
+ console.log("\nAnswer:", text.slice(0, 200), "...\n");
107
+
108
+ console.log("=== Cumulative Stats ===");
109
+ console.log(`Total calls: ${stats.calls}`);
110
+ console.log(`Total tokens saved: ${stats.totalSaved}`);
111
+ console.log("Transform frequency:");
112
+ for (const [name, count] of stats.transforms) {
113
+ console.log(` ${name}: ${count}x`);
114
+ }
115
+ }
116
+
117
+ main().catch(console.error);
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Example 10: Middleware Composition
3
+ *
4
+ * Combine headroomMiddleware with other Vercel AI SDK middlewares.
5
+ * Headroom compresses first, then other middlewares process the result.
6
+ *
7
+ * Run: npx tsx examples/10-middleware-composition.ts
8
+ */
9
+ import { headroomMiddleware } from "xtream-head/vercel-ai";
10
+ import { openai } from "@ai-sdk/openai";
11
+ import { generateText, wrapLanguageModel, extractReasoningMiddleware } from "ai";
12
+
13
+ // Large context that benefits from compression
14
+ const codebaseAnalysis = Array.from({ length: 40 }, (_, i) => ({
15
+ file: `src/modules/${["auth", "billing", "users", "api", "workers"][i % 5]}/handler${Math.floor(i / 5)}.ts`,
16
+ lines: Math.floor(Math.random() * 500 + 100),
17
+ complexity: Math.floor(Math.random() * 30 + 1),
18
+ dependencies: Array.from({ length: Math.floor(Math.random() * 8) }, (_, j) => `dep-${j}`),
19
+ last_modified: new Date(Date.now() - Math.random() * 180 * 86400000).toISOString(),
20
+ test_coverage: +(Math.random() * 100).toFixed(1),
21
+ issues: Array.from({ length: Math.floor(Math.random() * 3) }, () =>
22
+ ["unused import", "any type", "missing null check", "no error handling", "hardcoded value"][Math.floor(Math.random() * 5)]
23
+ ),
24
+ }));
25
+
26
+ async function main() {
27
+ // Stack multiple middlewares: compression + reasoning extraction
28
+ const model = wrapLanguageModel({
29
+ model: openai("gpt-4o"),
30
+ middleware: [
31
+ headroomMiddleware(), // compress large context
32
+ extractReasoningMiddleware({ tagName: "think" }), // extract chain-of-thought
33
+ ],
34
+ });
35
+
36
+ const { text, reasoning } = await generateText({
37
+ model,
38
+ messages: [
39
+ {
40
+ role: "system",
41
+ content: `You are a code quality analyst. When analyzing, wrap your reasoning in <think> tags before giving your final answer.`,
42
+ },
43
+ {
44
+ role: "user",
45
+ content: `Analyze this codebase for quality issues:\n\n${JSON.stringify(codebaseAnalysis)}\n\nWhat are the top 3 areas that need immediate attention?`,
46
+ },
47
+ ],
48
+ });
49
+
50
+ if (reasoning) {
51
+ console.log("=== Internal Reasoning ===");
52
+ console.log(reasoning.slice(0, 300), "...\n");
53
+ }
54
+
55
+ console.log("=== Analysis ===");
56
+ console.log(text);
57
+ }
58
+
59
+ main().catch(console.error);
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Example 05: Multi-Provider Compression
3
+ *
4
+ * Use the same withHeadroom wrapper across different providers.
5
+ * Headroom compresses identically regardless of which LLM you use.
6
+ *
7
+ * Run: npx tsx examples/05-multi-provider.ts
8
+ */
9
+ import { withHeadroom } from "xtream-head/vercel-ai";
10
+ import { openai } from "@ai-sdk/openai";
11
+ import { generateText } from "ai";
12
+
13
+ // Large JSON dataset — same data, different models
14
+ const salesData = Array.from({ length: 60 }, (_, i) => ({
15
+ quarter: `Q${(i % 4) + 1} ${2023 + Math.floor(i / 4)}`,
16
+ region: ["North America", "Europe", "Asia Pacific", "Latin America"][i % 4],
17
+ product: ["Enterprise", "Pro", "Starter"][i % 3],
18
+ revenue: Math.round(Math.random() * 1000000),
19
+ customers: Math.floor(Math.random() * 500),
20
+ churn_rate: +(Math.random() * 0.15).toFixed(3),
21
+ nps_score: Math.floor(Math.random() * 40 + 60),
22
+ support_tickets: Math.floor(Math.random() * 200),
23
+ avg_response_time_hrs: +(Math.random() * 24).toFixed(1),
24
+ }));
25
+
26
+ const messages = [
27
+ {
28
+ role: "system" as const,
29
+ content: "You are a business analyst. Analyze the data and provide key insights. Be concise — bullet points preferred.",
30
+ },
31
+ {
32
+ role: "user" as const,
33
+ content: `Here is our sales data:\n${JSON.stringify(salesData)}\n\nWhat are the 3 most important trends?`,
34
+ },
35
+ ];
36
+
37
+ async function main() {
38
+ // GPT-4o with compression
39
+ console.log("=== OpenAI GPT-4o ===");
40
+ const gpt = withHeadroom(openai("gpt-4o"));
41
+ const gptResult = await generateText({ model: gpt, messages });
42
+ console.log(gptResult.text);
43
+ console.log(`Tokens: ${gptResult.usage.promptTokens} prompt, ${gptResult.usage.completionTokens} completion\n`);
44
+
45
+ // GPT-4o-mini with compression (cheaper, faster)
46
+ console.log("=== OpenAI GPT-4o-mini ===");
47
+ const mini = withHeadroom(openai("gpt-4o-mini"));
48
+ const miniResult = await generateText({ model: mini, messages });
49
+ console.log(miniResult.text);
50
+ console.log(`Tokens: ${miniResult.usage.promptTokens} prompt, ${miniResult.usage.completionTokens} completion\n`);
51
+ }
52
+
53
+ main().catch(console.error);
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Example 11: OpenAI & Anthropic SDK Adapters
3
+ *
4
+ * Wrap native SDK clients directly — no Vercel AI SDK needed.
5
+ * Messages are compressed transparently before each API call.
6
+ *
7
+ * Run: npx tsx examples/11-openai-anthropic-adapters.ts
8
+ */
9
+ import { withHeadroom as withHeadroomOpenAI } from "xtream-head/openai";
10
+ import { withHeadroom as withHeadroomAnthropic } from "xtream-head/anthropic";
11
+ import OpenAI from "openai";
12
+ import Anthropic from "@anthropic-ai/sdk";
13
+
14
+ // Same large context for both providers
15
+ const githubIssues = Array.from({ length: 40 }, (_, i) => ({
16
+ number: 1000 + i,
17
+ title: `Issue #${1000 + i}: ${["Fix memory leak in worker pool", "Add retry logic for API calls", "Refactor auth middleware", "Update deprecated dependencies", "Add rate limiting"][i % 5]}`,
18
+ state: i % 8 === 0 ? "closed" : "open",
19
+ labels: [["bug", "P1"], ["enhancement"], ["tech-debt", "P2"], ["security"], ["performance"]][i % 5],
20
+ author: `dev${i % 7}`,
21
+ comments: Math.floor(Math.random() * 15),
22
+ body: `Detailed description of issue ${1000 + i}. This includes reproduction steps, expected behavior, actual behavior, environment details, and relevant log snippets. The issue was first reported on ${new Date(Date.now() - Math.random() * 90 * 86400000).toISOString().split("T")[0]}.`,
23
+ created_at: new Date(Date.now() - Math.random() * 90 * 86400000).toISOString(),
24
+ }));
25
+
26
+ const messages = [
27
+ {
28
+ role: "user" as const,
29
+ content: `Here are our open GitHub issues:\n\n${JSON.stringify(githubIssues)}\n\nPrioritize the top 5 issues we should tackle this sprint and explain why.`,
30
+ },
31
+ ];
32
+
33
+ async function main() {
34
+ // === OpenAI with compression ===
35
+ if (process.env.OPENAI_API_KEY) {
36
+ console.log("=== OpenAI (compressed) ===");
37
+ const openai = withHeadroomOpenAI(new OpenAI());
38
+
39
+ const response = await openai.chat.completions.create({
40
+ model: "gpt-4o",
41
+ messages: [
42
+ { role: "system", content: "You are a technical project manager. Prioritize issues for the sprint." },
43
+ ...messages,
44
+ ],
45
+ });
46
+
47
+ console.log(response.choices[0].message.content?.slice(0, 400), "...\n");
48
+ }
49
+
50
+ // === Anthropic with compression ===
51
+ if (process.env.ANTHROPIC_API_KEY) {
52
+ console.log("=== Anthropic (compressed) ===");
53
+ const anthropic = withHeadroomAnthropic(new Anthropic());
54
+
55
+ const response = await anthropic.messages.create({
56
+ model: "claude-sonnet-4-5-20250929",
57
+ max_tokens: 1024,
58
+ messages,
59
+ });
60
+
61
+ const text = response.content
62
+ .filter((b: any) => b.type === "text")
63
+ .map((b: any) => b.text)
64
+ .join("");
65
+ console.log(text.slice(0, 400), "...\n");
66
+ }
67
+
68
+ if (!process.env.OPENAI_API_KEY && !process.env.ANTHROPIC_API_KEY) {
69
+ console.log("Set OPENAI_API_KEY or ANTHROPIC_API_KEY to run this example.");
70
+ }
71
+ }
72
+
73
+ main().catch(console.error);
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Example 08: SharedContext — Multi-Agent Compressed Handoff
3
+ *
4
+ * Agent A researches a topic and stores compressed results.
5
+ * Agent B reads the compressed context and acts on it.
6
+ * Saves 70-90% of tokens on inter-agent communication.
7
+ *
8
+ * Run: npx tsx examples/08-shared-context-multi-agent.ts
9
+ */
10
+ import { SharedContext } from "xtream-head";
11
+ import { withHeadroom } from "xtream-head/vercel-ai";
12
+ import { openai } from "@ai-sdk/openai";
13
+ import { generateText } from "ai";
14
+
15
+ // Simulate a research agent's output — large structured data
16
+ const researchOutput = {
17
+ topic: "Kubernetes autoscaling strategies",
18
+ sources: Array.from({ length: 30 }, (_, i) => ({
19
+ title: `Source ${i + 1}: ${["HPA deep dive", "VPA configuration", "Cluster autoscaler", "KEDA event-driven", "Custom metrics"][i % 5]}`,
20
+ content: `Detailed technical content about ${["horizontal pod autoscaling", "vertical pod autoscaling", "node autoscaling", "event-driven scaling", "custom metrics scaling"][i % 5]}. This section covers implementation details, best practices, common pitfalls, and real-world examples from production deployments at scale.`,
21
+ relevance: +(Math.random() * 0.5 + 0.5).toFixed(2),
22
+ citations: Math.floor(Math.random() * 100),
23
+ })),
24
+ summary: "Kubernetes offers multiple autoscaling strategies at different levels: HPA for pod replicas, VPA for resource requests, Cluster Autoscaler for nodes, and KEDA for event-driven workloads.",
25
+ };
26
+
27
+ async function main() {
28
+ const ctx = new SharedContext({ model: "gpt-4o", maxEntries: 50 });
29
+ const model = withHeadroom(openai("gpt-4o"));
30
+
31
+ // === Agent A: Research Agent ===
32
+ console.log("=== Agent A: Research ===");
33
+
34
+ const entry = await ctx.put("k8s-scaling-research", JSON.stringify(researchOutput), {
35
+ agent: "researcher",
36
+ });
37
+
38
+ console.log(`Stored: ${entry.originalTokens} tokens → ${entry.compressedTokens} tokens`);
39
+ console.log(`Savings: ${entry.savingsPercent.toFixed(0)}%`);
40
+ console.log(`Transforms: ${entry.transforms.join(", ")}`);
41
+
42
+ // === Agent B: Writer Agent ===
43
+ console.log("\n=== Agent B: Writer ===");
44
+
45
+ // Read compressed context (80% smaller)
46
+ const compressed = ctx.get("k8s-scaling-research");
47
+ console.log(`Reading compressed context (${compressed?.length ?? 0} chars)`);
48
+
49
+ const { text } = await generateText({
50
+ model,
51
+ messages: [
52
+ {
53
+ role: "system",
54
+ content: "You are a technical writer. Create a concise blog post outline from research data.",
55
+ },
56
+ {
57
+ role: "user",
58
+ content: `Based on this research, create a blog post outline:\n\n${compressed}`,
59
+ },
60
+ ],
61
+ });
62
+
63
+ console.log("\nBlog outline:", text);
64
+
65
+ // === Stats ===
66
+ console.log("\n=== SharedContext Stats ===");
67
+ const stats = ctx.stats();
68
+ console.log(`Entries: ${stats.entries}`);
69
+ console.log(`Original tokens: ${stats.totalOriginalTokens}`);
70
+ console.log(`Compressed tokens: ${stats.totalCompressedTokens}`);
71
+ console.log(`Total saved: ${stats.totalTokensSaved} (${stats.savingsPercent.toFixed(0)}%)`);
72
+ }
73
+
74
+ main().catch(console.error);
@@ -0,0 +1,80 @@
1
+ /**
2
+ * Example 06: Simulation (Dry Run)
3
+ *
4
+ * See exactly what compression would do without calling the LLM.
5
+ * Useful for debugging, cost estimation, and understanding compression behavior.
6
+ *
7
+ * Run: npx tsx examples/06-simulation-dry-run.ts
8
+ */
9
+ import { simulate } from "xtream-head";
10
+
11
+ // Different types of content to analyze
12
+ const logEntries = Array.from({ length: 100 }, (_, i) => ({
13
+ timestamp: new Date(Date.now() - i * 30000).toISOString(),
14
+ level: i === 67 ? "FATAL" : i % 15 === 0 ? "ERROR" : "INFO",
15
+ service: "payment-gateway",
16
+ message: i === 67
17
+ ? "Connection pool exhausted: max_connections=100, active=100, waiting=47"
18
+ : `Processing transaction txn_${Math.random().toString(36).slice(2, 10)}`,
19
+ trace_id: `trace-${i}`,
20
+ duration_ms: Math.floor(Math.random() * 500),
21
+ }));
22
+
23
+ const messages = [
24
+ {
25
+ role: "system" as const,
26
+ content: "You are an SRE assistant analyzing production logs.",
27
+ },
28
+ {
29
+ role: "user" as const,
30
+ content: "Check the payment gateway logs for issues",
31
+ },
32
+ {
33
+ role: "assistant" as const,
34
+ content: null,
35
+ tool_calls: [
36
+ { id: "call_1", type: "function" as const, function: { name: "get_logs", arguments: '{"service":"payment-gateway","limit":100}' } },
37
+ ],
38
+ },
39
+ {
40
+ role: "tool" as const,
41
+ content: JSON.stringify(logEntries),
42
+ tool_call_id: "call_1",
43
+ },
44
+ {
45
+ role: "user" as const,
46
+ content: "What's wrong? Is there a critical issue?",
47
+ },
48
+ ];
49
+
50
+ async function main() {
51
+ console.log("Running compression simulation (no LLM call)...\n");
52
+
53
+ const sim = await simulate(messages, { model: "gpt-4o" });
54
+
55
+ console.log("=== Simulation Results ===");
56
+ console.log(`Tokens before: ${sim.tokensBefore}`);
57
+ console.log(`Tokens after: ${sim.tokensAfter}`);
58
+ console.log(`Tokens saved: ${sim.tokensSaved}`);
59
+ console.log(`Estimated savings: ${sim.estimatedSavings}`);
60
+ console.log(`\nTransforms applied: ${sim.transforms?.join(", ") || "none"}`);
61
+
62
+ if (sim.wasteSignals && Object.keys(sim.wasteSignals).length > 0) {
63
+ console.log("\nWaste signals detected:");
64
+ for (const [signal, tokens] of Object.entries(sim.wasteSignals)) {
65
+ if (tokens > 0) console.log(` ${signal}: ${tokens} tokens`);
66
+ }
67
+ }
68
+
69
+ if (sim.blockBreakdown && Object.keys(sim.blockBreakdown).length > 0) {
70
+ console.log("\nBlock breakdown:");
71
+ for (const [kind, count] of Object.entries(sim.blockBreakdown)) {
72
+ console.log(` ${kind}: ${count}`);
73
+ }
74
+ }
75
+
76
+ console.log(`\nCache alignment score: ${sim.cacheAlignmentScore}`);
77
+ console.log(`Stable prefix hash: ${sim.stablePrefixHash || "none"}`);
78
+ }
79
+
80
+ main().catch(console.error);
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Example 03: Streaming Chat with Compression
3
+ *
4
+ * Use withHeadroom with streamText for real-time streaming responses.
5
+ * Compression happens before the stream starts — the LLM sees fewer tokens.
6
+ *
7
+ * Run: npx tsx examples/03-streaming-chat.ts
8
+ */
9
+ import { withHeadroom } from "xtream-head/vercel-ai";
10
+ import { openai } from "@ai-sdk/openai";
11
+ import { streamText } from "ai";
12
+
13
+ // Simulate a long conversation with code review context
14
+ const codeReviewMessages = [
15
+ {
16
+ role: "system" as const,
17
+ content: "You are a senior code reviewer. Be thorough but concise.",
18
+ },
19
+ {
20
+ role: "user" as const,
21
+ content: "Review this pull request diff",
22
+ },
23
+ {
24
+ role: "assistant" as const,
25
+ content: null,
26
+ toolInvocations: [] as any[],
27
+ },
28
+ {
29
+ role: "tool" as const,
30
+ content: [
31
+ {
32
+ type: "tool-result" as const,
33
+ toolCallId: "call_diff",
34
+ toolName: "get_pr_diff",
35
+ result: generateLargeDiff(),
36
+ },
37
+ ],
38
+ },
39
+ {
40
+ role: "user" as const,
41
+ content: "What are the most critical issues in this diff?",
42
+ },
43
+ ];
44
+
45
+ function generateLargeDiff(): string {
46
+ const files = Array.from({ length: 15 }, (_, i) => {
47
+ const lines = Array.from({ length: 20 }, (_, j) => {
48
+ const prefix = j % 5 === 0 ? "+" : j % 7 === 0 ? "-" : " ";
49
+ return `${prefix} ${j % 5 === 0 ? "// TODO: refactor this" : `const value${j} = process(input${j});`}`;
50
+ });
51
+ return `--- a/src/module${i}/handler.ts\n+++ b/src/module${i}/handler.ts\n@@ -1,20 +1,20 @@\n${lines.join("\n")}`;
52
+ });
53
+ return files.join("\n\n");
54
+ }
55
+
56
+ async function main() {
57
+ const model = withHeadroom(openai("gpt-4o"));
58
+
59
+ const result = streamText({
60
+ model,
61
+ messages: codeReviewMessages,
62
+ });
63
+
64
+ process.stdout.write("Review: ");
65
+ for await (const chunk of result.textStream) {
66
+ process.stdout.write(chunk);
67
+ }
68
+ console.log("\n\nDone.");
69
+ }
70
+
71
+ main().catch(console.error);
@@ -0,0 +1,99 @@
1
+ /**
2
+ * Example 09: Structured Output with Compression
3
+ *
4
+ * Compress large context, then extract structured data with generateObject.
5
+ * Compression preserves the signal needed for accurate extraction.
6
+ *
7
+ * Run: npx tsx examples/09-structured-output.ts
8
+ */
9
+ import { withHeadroom } from "xtream-head/vercel-ai";
10
+ import { openai } from "@ai-sdk/openai";
11
+ import { generateText, Output } from "ai";
12
+ import { z } from "zod";
13
+
14
+ // Simulate a large incident report with lots of noise
15
+ const incidentLogs = Array.from({ length: 150 }, (_, i) => {
16
+ if (i === 73) {
17
+ return {
18
+ timestamp: "2025-06-15T14:32:17Z",
19
+ level: "FATAL",
20
+ service: "payment-service",
21
+ message: "Circuit breaker OPEN: downstream timeout after 30s. Affected: POST /api/v2/charges. Error: ETIMEDOUT 10.0.3.42:5432",
22
+ trace_id: "trace-incident-001",
23
+ };
24
+ }
25
+ if (i === 89) {
26
+ return {
27
+ timestamp: "2025-06-15T14:33:01Z",
28
+ level: "ERROR",
29
+ service: "payment-service",
30
+ message: "Retry exhausted for transaction txn_abc123. Customer: cust_xyz. Amount: $249.99. Gateway: stripe. Error: upstream_timeout",
31
+ trace_id: "trace-incident-001",
32
+ };
33
+ }
34
+ return {
35
+ timestamp: new Date(Date.now() - (150 - i) * 10000).toISOString(),
36
+ level: "INFO",
37
+ service: ["payment-service", "auth-service", "api-gateway", "notification-service"][i % 4],
38
+ message: `Routine: processed request ${i}, latency=${Math.floor(Math.random() * 100)}ms`,
39
+ trace_id: `trace-${Math.random().toString(36).slice(2, 8)}`,
40
+ };
41
+ });
42
+
43
+ // Schema for structured incident extraction
44
+ const IncidentReport = z.object({
45
+ severity: z.enum(["critical", "high", "medium", "low"]),
46
+ title: z.string().describe("Short incident title"),
47
+ rootCause: z.string().describe("Root cause analysis"),
48
+ affectedServices: z.array(z.string()),
49
+ affectedEndpoints: z.array(z.string()),
50
+ timeline: z.array(
51
+ z.object({
52
+ time: z.string(),
53
+ event: z.string(),
54
+ }),
55
+ ),
56
+ impact: z.string().describe("Customer/business impact"),
57
+ suggestedFix: z.string(),
58
+ });
59
+
60
+ async function main() {
61
+ const model = withHeadroom(openai("gpt-4o"));
62
+
63
+ console.log(`Input: ${incidentLogs.length} log entries (${JSON.stringify(incidentLogs).length} chars)`);
64
+
65
+ const { output: report } = await generateText({
66
+ model,
67
+ output: Output.object({ schema: IncidentReport }),
68
+ messages: [
69
+ {
70
+ role: "system",
71
+ content: "You are an SRE incident commander. Analyze logs and produce structured incident reports.",
72
+ },
73
+ {
74
+ role: "user",
75
+ content: `Analyze these production logs and create an incident report:\n\n${JSON.stringify(incidentLogs)}`,
76
+ },
77
+ ],
78
+ });
79
+
80
+ if (!report) {
81
+ console.error("No structured output generated.");
82
+ return;
83
+ }
84
+
85
+ console.log("\n=== Incident Report ===");
86
+ console.log(`Severity: ${report.severity}`);
87
+ console.log(`Title: ${report.title}`);
88
+ console.log(`Root cause: ${report.rootCause}`);
89
+ console.log(`Affected services: ${report.affectedServices.join(", ")}`);
90
+ console.log(`Affected endpoints: ${report.affectedEndpoints.join(", ")}`);
91
+ console.log(`Impact: ${report.impact}`);
92
+ console.log(`\nTimeline:`);
93
+ for (const event of report.timeline) {
94
+ console.log(` ${event.time} — ${event.event}`);
95
+ }
96
+ console.log(`\nSuggested fix: ${report.suggestedFix}`);
97
+ }
98
+
99
+ main().catch(console.error);