xithead 1.5.0 → 1.5.2
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.
- package/bin/xithead.js +486 -226
- package/{npm/index.js → index.js} +2 -2
- package/package.json +46 -46
- package/.actrc +0 -14
- package/.actrc.local.example +0 -15
- package/.changelog.md +0 -2
- package/.claude/agents/academic-anthropologist.md +0 -125
- package/.claude/agents/academic-geographer.md +0 -127
- package/.claude/agents/academic-historian.md +0 -123
- package/.claude/agents/academic-narratologist.md +0 -118
- package/.claude/agents/academic-psychologist.md +0 -118
- package/.claude/agents/academic-statistician.md +0 -144
- package/.claude/agents/accounts-payable-agent.md +0 -205
- package/.claude/agents/agentic-identity-trust.md +0 -394
- package/.claude/agents/agents-orchestrator.md +0 -367
- package/.claude/agents/automation-governance-architect.md +0 -216
- package/.claude/agents/blender-addon-engineer.md +0 -243
- package/.claude/agents/business-strategist.md +0 -488
- package/.claude/agents/change-management-consultant.md +0 -497
- package/.claude/agents/chief-financial-officer.md +0 -388
- package/.claude/agents/corporate-training-designer.md +0 -192
- package/.claude/agents/customer-service.md +0 -398
- package/.claude/agents/customer-success-manager.md +0 -460
- package/.claude/agents/data-consolidation-agent.md +0 -60
- package/.claude/agents/data-privacy-officer.md +0 -412
- package/.claude/agents/design-brand-guardian.md +0 -322
- package/.claude/agents/design-image-prompt-engineer.md +0 -236
- package/.claude/agents/design-inclusive-visuals-specialist.md +0 -73
- package/.claude/agents/design-persona-walkthrough.md +0 -272
- package/.claude/agents/design-ui-designer.md +0 -386
- package/.claude/agents/design-ui-finish-gate-reviewer.md +0 -217
- package/.claude/agents/design-ux-architect.md +0 -482
- package/.claude/agents/design-ux-researcher.md +0 -329
- package/.claude/agents/design-visual-storyteller.md +0 -149
- package/.claude/agents/design-whimsy-injector.md +0 -460
- package/.claude/agents/economy-designer.md +0 -156
- package/.claude/agents/engineering-ai-data-remediation-engineer.md +0 -211
- package/.claude/agents/engineering-ai-engineer.md +0 -146
- package/.claude/agents/engineering-api-platform-engineer.md +0 -181
- package/.claude/agents/engineering-ats-validator-architect.md +0 -383
- package/.claude/agents/engineering-autonomous-optimization-architect.md +0 -121
- package/.claude/agents/engineering-backend-architect.md +0 -255
- package/.claude/agents/engineering-china-network-engineer.md +0 -252
- package/.claude/agents/engineering-cms-developer.md +0 -536
- package/.claude/agents/engineering-code-reviewer.md +0 -76
- package/.claude/agents/engineering-codebase-onboarding-engineer.md +0 -173
- package/.claude/agents/engineering-data-engineer.md +0 -349
- package/.claude/agents/engineering-data-visualization-engineer.md +0 -151
- package/.claude/agents/engineering-database-optimizer.md +0 -188
- package/.claude/agents/engineering-database-reliability-engineer.md +0 -201
- package/.claude/agents/engineering-desktop-app-engineer.md +0 -209
- package/.claude/agents/engineering-developer-tooling-engineer.md +0 -153
- package/.claude/agents/engineering-devops-automator.md +0 -385
- package/.claude/agents/engineering-drupal-performance.md +0 -347
- package/.claude/agents/engineering-drupal-shopping-cart.md +0 -360
- package/.claude/agents/engineering-electrical-engineer.md +0 -575
- package/.claude/agents/engineering-email-intelligence-engineer.md +0 -390
- package/.claude/agents/engineering-embedded-firmware-engineer.md +0 -196
- package/.claude/agents/engineering-feishu-integration-developer.md +0 -606
- package/.claude/agents/engineering-filament-optimization-specialist.md +0 -283
- package/.claude/agents/engineering-finops-engineer.md +0 -164
- package/.claude/agents/engineering-frontend-developer.md +0 -257
- package/.claude/agents/engineering-gaussdb-expert.md +0 -334
- package/.claude/agents/engineering-git-workflow-master.md +0 -98
- package/.claude/agents/engineering-i18n-engineer.md +0 -214
- package/.claude/agents/engineering-identity-access-engineer.md +0 -217
- package/.claude/agents/engineering-incident-response-commander.md +0 -444
- package/.claude/agents/engineering-iot-fleet-engineer.md +0 -148
- package/.claude/agents/engineering-it-service-manager.md +0 -561
- package/.claude/agents/engineering-knowledge-graph-engineer.md +0 -372
- package/.claude/agents/engineering-llm-post-training-engineer.md +0 -166
- package/.claude/agents/engineering-minimal-change-engineer.md +0 -207
- package/.claude/agents/engineering-mobile-app-builder.md +0 -493
- package/.claude/agents/engineering-mobile-release-engineer.md +0 -164
- package/.claude/agents/engineering-multi-agent-systems-architect.md +0 -600
- package/.claude/agents/engineering-network-engineer.md +0 -245
- package/.claude/agents/engineering-orgscript-engineer.md +0 -113
- package/.claude/agents/engineering-payments-billing-engineer.md +0 -228
- package/.claude/agents/engineering-pdf-engine-architect.md +0 -696
- package/.claude/agents/engineering-platform-engineer.md +0 -270
- package/.claude/agents/engineering-privacy-engineer.md +0 -152
- package/.claude/agents/engineering-prompt-engineer.md +0 -209
- package/.claude/agents/engineering-rag-pipeline-engineer.md +0 -450
- package/.claude/agents/engineering-rapid-prototyper.md +0 -466
- package/.claude/agents/engineering-realtime-collaboration-engineer.md +0 -200
- package/.claude/agents/engineering-rust-refactoring-specialist.md +0 -313
- package/.claude/agents/engineering-search-relevance-engineer.md +0 -237
- package/.claude/agents/engineering-section-508-specialist.md +0 -339
- package/.claude/agents/engineering-senior-developer.md +0 -176
- package/.claude/agents/engineering-servicenow-developer-mentor.md +0 -180
- package/.claude/agents/engineering-software-architect.md +0 -112
- package/.claude/agents/engineering-solidity-smart-contract-engineer.md +0 -522
- package/.claude/agents/engineering-sre.md +0 -90
- package/.claude/agents/engineering-technical-writer.md +0 -393
- package/.claude/agents/engineering-universal-document-compiler.md +0 -370
- package/.claude/agents/engineering-uswds-developer.md +0 -340
- package/.claude/agents/engineering-video-streaming-engineer.md +0 -151
- package/.claude/agents/engineering-voice-ai-integration-engineer.md +0 -584
- package/.claude/agents/engineering-webassembly-engineer.md +0 -153
- package/.claude/agents/engineering-wechat-mini-program-developer.md +0 -356
- package/.claude/agents/engineering-wordpress-performance.md +0 -346
- package/.claude/agents/engineering-wordpress-shopping-cart.md +0 -346
- package/.claude/agents/esg-sustainability-officer.md +0 -396
- package/.claude/agents/finance-bookkeeper-controller.md +0 -260
- package/.claude/agents/finance-financial-analyst.md +0 -234
- package/.claude/agents/finance-fpa-analyst.md +0 -263
- package/.claude/agents/finance-investment-researcher.md +0 -272
- package/.claude/agents/finance-tax-strategist.md +0 -239
- package/.claude/agents/game-audio-engineer.md +0 -264
- package/.claude/agents/game-designer.md +0 -167
- package/.claude/agents/gis-3d-scene-developer.md +0 -111
- package/.claude/agents/gis-analyst.md +0 -91
- package/.claude/agents/gis-bim-specialist.md +0 -108
- package/.claude/agents/gis-cartography-designer.md +0 -150
- package/.claude/agents/gis-drone-reality-mapping.md +0 -120
- package/.claude/agents/gis-geoai-ml-engineer.md +0 -105
- package/.claude/agents/gis-geoprocessing-specialist.md +0 -97
- package/.claude/agents/gis-qa-engineer.md +0 -133
- package/.claude/agents/gis-solution-engineer.md +0 -101
- package/.claude/agents/gis-spatial-data-engineer.md +0 -97
- package/.claude/agents/gis-spatial-data-scientist.md +0 -111
- package/.claude/agents/gis-technical-consultant.md +0 -86
- package/.claude/agents/gis-web-gis-developer.md +0 -108
- package/.claude/agents/godot-gameplay-scripter.md +0 -338
- package/.claude/agents/godot-multiplayer-engineer.md +0 -301
- package/.claude/agents/godot-shader-developer.md +0 -267
- package/.claude/agents/government-digital-presales-consultant.md +0 -363
- package/.claude/agents/grant-writer.md +0 -511
- package/.claude/agents/healthcare-aging-parent-care-companion.md +0 -414
- package/.claude/agents/healthcare-clinical-evidence-agent.md +0 -231
- package/.claude/agents/healthcare-customer-service.md +0 -389
- package/.claude/agents/healthcare-innovation-strategist.md +0 -433
- package/.claude/agents/healthcare-marketing-compliance.md +0 -395
- package/.claude/agents/healthcare-sovereign-health-systems-agent.md +0 -312
- package/.claude/agents/hospitality-guest-services.md +0 -603
- package/.claude/agents/hr-onboarding.md +0 -451
- package/.claude/agents/identity-graph-operator.md +0 -303
- package/.claude/agents/language-translator.md +0 -264
- package/.claude/agents/legal-billing-time-tracking.md +0 -569
- package/.claude/agents/legal-client-intake.md +0 -492
- package/.claude/agents/legal-document-review.md +0 -454
- package/.claude/agents/level-designer.md +0 -208
- package/.claude/agents/loan-officer-assistant.md +0 -555
- package/.claude/agents/lsp-index-engineer.md +0 -320
- package/.claude/agents/ma-integration-manager.md +0 -427
- package/.claude/agents/macos-spatial-metal-engineer.md +0 -337
- package/.claude/agents/marketing-aeo-foundations.md +0 -264
- package/.claude/agents/marketing-agentic-search-optimizer.md +0 -279
- package/.claude/agents/marketing-ai-citation-strategist.md +0 -172
- package/.claude/agents/marketing-app-store-optimizer.md +0 -321
- package/.claude/agents/marketing-baidu-seo-specialist.md +0 -226
- package/.claude/agents/marketing-bilibili-content-strategist.md +0 -199
- package/.claude/agents/marketing-book-co-author.md +0 -110
- package/.claude/agents/marketing-carousel-growth-engine.md +0 -204
- package/.claude/agents/marketing-china-ecommerce-operator.md +0 -283
- package/.claude/agents/marketing-china-market-localization-strategist.md +0 -283
- package/.claude/agents/marketing-content-creator.md +0 -54
- package/.claude/agents/marketing-cross-border-ecommerce.md +0 -259
- package/.claude/agents/marketing-developer-community-builder.md +0 -285
- package/.claude/agents/marketing-douyin-strategist.md +0 -149
- package/.claude/agents/marketing-email-strategist.md +0 -249
- package/.claude/agents/marketing-global-podcast-strategist.md +0 -206
- package/.claude/agents/marketing-growth-hacker.md +0 -54
- package/.claude/agents/marketing-instagram-curator.md +0 -113
- package/.claude/agents/marketing-kuaishou-strategist.md +0 -223
- package/.claude/agents/marketing-linkedin-content-creator.md +0 -214
- package/.claude/agents/marketing-livestream-commerce-coach.md +0 -305
- package/.claude/agents/marketing-multi-platform-publisher.md +0 -217
- package/.claude/agents/marketing-podcast-strategist.md +0 -277
- package/.claude/agents/marketing-pr-communications-manager.md +0 -473
- package/.claude/agents/marketing-private-domain-operator.md +0 -308
- package/.claude/agents/marketing-reddit-community-builder.md +0 -123
- package/.claude/agents/marketing-seo-specialist.md +0 -370
- package/.claude/agents/marketing-short-video-editing-coach.md +0 -412
- package/.claude/agents/marketing-social-media-strategist.md +0 -125
- package/.claude/agents/marketing-tiktok-strategist.md +0 -125
- package/.claude/agents/marketing-twitter-engager.md +0 -126
- package/.claude/agents/marketing-video-optimization-specialist.md +0 -119
- package/.claude/agents/marketing-wechat-official-account.md +0 -145
- package/.claude/agents/marketing-weibo-strategist.md +0 -240
- package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +0 -161
- package/.claude/agents/marketing-xiaohongshu-specialist.md +0 -138
- package/.claude/agents/marketing-zhihu-strategist.md +0 -162
- package/.claude/agents/medical-billing-coding-specialist.md +0 -491
- package/.claude/agents/narrative-designer.md +0 -243
- package/.claude/agents/operations-manager.md +0 -399
- package/.claude/agents/organizational-psychologist.md +0 -391
- package/.claude/agents/paid-media-auditor.md +0 -71
- package/.claude/agents/paid-media-creative-strategist.md +0 -71
- package/.claude/agents/paid-media-paid-social-strategist.md +0 -71
- package/.claude/agents/paid-media-ppc-strategist.md +0 -71
- package/.claude/agents/paid-media-programmatic-buyer.md +0 -71
- package/.claude/agents/paid-media-search-query-analyst.md +0 -71
- package/.claude/agents/paid-media-tracking-specialist.md +0 -71
- package/.claude/agents/personal-growth-mentor.md +0 -159
- package/.claude/agents/product-behavioral-nudge-engine.md +0 -83
- package/.claude/agents/product-dx-engineer.md +0 -332
- package/.claude/agents/product-feedback-synthesizer.md +0 -119
- package/.claude/agents/product-manager.md +0 -469
- package/.claude/agents/product-sprint-prioritizer.md +0 -154
- package/.claude/agents/product-trend-researcher.md +0 -159
- package/.claude/agents/project-management-experiment-tracker.md +0 -198
- package/.claude/agents/project-management-jira-workflow-steward.md +0 -233
- package/.claude/agents/project-management-meeting-notes-specialist.md +0 -95
- package/.claude/agents/project-management-project-shepherd.md +0 -194
- package/.claude/agents/project-management-studio-operations.md +0 -200
- package/.claude/agents/project-management-studio-producer.md +0 -203
- package/.claude/agents/project-manager-senior.md +0 -135
- package/.claude/agents/real-estate-buyer-seller.md +0 -596
- package/.claude/agents/recruitment-specialist.md +0 -515
- package/.claude/agents/report-distribution-agent.md +0 -65
- package/.claude/agents/research-synthesist.md +0 -136
- package/.claude/agents/resume-tailor.md +0 -230
- package/.claude/agents/retail-customer-returns.md +0 -566
- package/.claude/agents/roblox-avatar-creator.md +0 -297
- package/.claude/agents/roblox-experience-designer.md +0 -306
- package/.claude/agents/roblox-systems-scripter.md +0 -332
- package/.claude/agents/sales-account-strategist.md +0 -227
- package/.claude/agents/sales-coach.md +0 -271
- package/.claude/agents/sales-data-extraction-agent.md +0 -67
- package/.claude/agents/sales-deal-strategist.md +0 -180
- package/.claude/agents/sales-discovery-coach.md +0 -225
- package/.claude/agents/sales-engineer.md +0 -182
- package/.claude/agents/sales-offer-lead-gen-strategist.md +0 -257
- package/.claude/agents/sales-outbound-strategist.md +0 -201
- package/.claude/agents/sales-outreach.md +0 -425
- package/.claude/agents/sales-pipeline-analyst.md +0 -267
- package/.claude/agents/sales-proposal-strategist.md +0 -217
- package/.claude/agents/security-ai-generated-code-auditor.md +0 -207
- package/.claude/agents/security-appsec-engineer.md +0 -536
- package/.claude/agents/security-architect.md +0 -307
- package/.claude/agents/security-blockchain-security-auditor.md +0 -482
- package/.claude/agents/security-cloud-security-architect.md +0 -576
- package/.claude/agents/security-compliance-auditor.md +0 -158
- package/.claude/agents/security-incident-responder.md +0 -450
- package/.claude/agents/security-penetration-tester.md +0 -399
- package/.claude/agents/security-secrets-credential-engineer.md +0 -189
- package/.claude/agents/security-senior-secops.md +0 -760
- package/.claude/agents/security-threat-detection-engineer.md +0 -553
- package/.claude/agents/security-threat-intelligence-analyst.md +0 -661
- package/.claude/agents/specialized-chief-of-staff.md +0 -279
- package/.claude/agents/specialized-civil-engineer.md +0 -356
- package/.claude/agents/specialized-codebase-archaeologist.md +0 -341
- package/.claude/agents/specialized-cultural-intelligence-strategist.md +0 -88
- package/.claude/agents/specialized-developer-advocate.md +0 -317
- package/.claude/agents/specialized-document-generator.md +0 -55
- package/.claude/agents/specialized-fedramp-rmf-compliance.md +0 -378
- package/.claude/agents/specialized-focus-music-architect.md +0 -175
- package/.claude/agents/specialized-french-consulting-market.md +0 -194
- package/.claude/agents/specialized-korean-business-navigator.md +0 -216
- package/.claude/agents/specialized-master-plan-architect.md +0 -157
- package/.claude/agents/specialized-mcp-builder.md +0 -260
- package/.claude/agents/specialized-model-qa.md +0 -528
- package/.claude/agents/specialized-pricing-analyst.md +0 -243
- package/.claude/agents/specialized-salesforce-architect.md +0 -182
- package/.claude/agents/specialized-strategy-duel-agent.md +0 -130
- package/.claude/agents/specialized-workflow-architect.md +0 -597
- package/.claude/agents/study-abroad-advisor.md +0 -282
- package/.claude/agents/supply-chain-strategist.md +0 -591
- package/.claude/agents/support-analytics-reporter.md +0 -387
- package/.claude/agents/support-executive-summary-generator.md +0 -212
- package/.claude/agents/support-finance-tracker.md +0 -480
- package/.claude/agents/support-infrastructure-maintainer.md +0 -628
- package/.claude/agents/support-legal-compliance-checker.md +0 -591
- package/.claude/agents/support-support-responder.md +0 -607
- package/.claude/agents/technical-artist.md +0 -233
- package/.claude/agents/terminal-integration-specialist.md +0 -70
- package/.claude/agents/testing-accessibility-auditor.md +0 -327
- package/.claude/agents/testing-api-tester.md +0 -334
- package/.claude/agents/testing-evidence-collector.md +0 -210
- package/.claude/agents/testing-performance-benchmarker.md +0 -283
- package/.claude/agents/testing-reality-checker.md +0 -249
- package/.claude/agents/testing-test-automation-engineer.md +0 -196
- package/.claude/agents/testing-test-results-analyzer.md +0 -330
- package/.claude/agents/testing-tool-evaluator.md +0 -416
- package/.claude/agents/testing-workflow-optimizer.md +0 -463
- package/.claude/agents/unity-architect.md +0 -271
- package/.claude/agents/unity-editor-tool-developer.md +0 -310
- package/.claude/agents/unity-multiplayer-engineer.md +0 -323
- package/.claude/agents/unity-shader-graph-artist.md +0 -269
- package/.claude/agents/unreal-multiplayer-architect.md +0 -364
- package/.claude/agents/unreal-systems-engineer.md +0 -322
- package/.claude/agents/unreal-technical-artist.md +0 -256
- package/.claude/agents/unreal-world-builder.md +0 -273
- package/.claude/agents/visionos-spatial-engineer.md +0 -54
- package/.claude/agents/xr-cockpit-interaction-specialist.md +0 -32
- package/.claude/agents/xr-immersive-developer.md +0 -32
- package/.claude/agents/xr-interface-architect.md +0 -32
- package/.claude/agents/zk-steward.md +0 -211
- package/.claude-plugin/marketplace.json +0 -30
- package/.commitlintrc.json +0 -26
- package/.devcontainer/Dockerfile +0 -24
- package/.devcontainer/devcontainer.json +0 -70
- package/.devcontainer/docker-compose.memory.yml +0 -42
- package/.devcontainer/memory-stack/devcontainer.json +0 -84
- package/.devcontainer/post-create.sh +0 -83
- package/.dockerignore +0 -23
- package/.env.act.example +0 -15
- package/.env.example +0 -171
- package/.eslintrc.json +0 -16
- package/.git-blame-ignore-revs +0 -10
- package/.gitattributes +0 -2
- package/.gitguardian.yaml +0 -50
- package/.githooks/pre-commit +0 -6
- package/.pre-commit-config.yaml +0 -30
- package/.release-please-config-xithead.json +0 -22
- package/.release-please-config.json +0 -44
- package/.release-please-manifest-xithead.json +0 -3
- package/.release-please-manifest.json +0 -3
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -133
- package/Cargo.lock +0 -5557
- package/Cargo.toml +0 -121
- package/Dockerfile +0 -38
- package/Dockerfile.proxy +0 -48
- package/ENTERPRISE.md +0 -5
- package/FEATURES_ADVANCED.md +0 -311
- package/Headroom-2.gif +0 -0
- package/HeadroomDemo-Fast.gif +0 -0
- package/LICENSE +0 -190
- package/MANIFEST.in +0 -4
- package/MODERNIZATION_GUIDE.md +0 -358
- package/Makefile +0 -140
- package/NOTICE +0 -43
- package/NPM_TOKEN_SETUP.md +0 -81
- package/PR.md +0 -170
- package/PUBLISH.md +0 -77
- package/README.md +0 -108
- package/README_FRONTEND.md +0 -196
- package/REALIGNMENT/00-overview.md +0 -53
- package/REALIGNMENT/01-bug-list.md +0 -421
- package/REALIGNMENT/02-architecture.md +0 -322
- package/REALIGNMENT/03-phase-A-lockdown.md +0 -420
- package/REALIGNMENT/04-phase-B-live-zone.md +0 -470
- package/REALIGNMENT/05-phase-C-rust-proxy.md +0 -329
- package/REALIGNMENT/06-phase-D-bedrock-vertex.md +0 -222
- package/REALIGNMENT/07-phase-E-cache-stabilization.md +0 -338
- package/REALIGNMENT/08-phase-F-auth-mode.md +0 -254
- package/REALIGNMENT/09-phase-G-rtk-observability.md +0 -194
- package/REALIGNMENT/10-phase-H-python-retirement.md +0 -214
- package/REALIGNMENT/11-phase-I-test-infra.md +0 -385
- package/REALIGNMENT/12-decisions-needed.md +0 -196
- package/REALIGNMENT/INDEX.md +0 -82
- package/REFACTORING_CAMPAIGN.md +0 -277
- package/RESTRUCTURE_PLAN.md +0 -100
- package/RUST_DEV.md +0 -361
- package/SECURITY.md +0 -65
- package/SETUP_AUTO_PUBLISH.md +0 -164
- package/TESTING-copilot-subscription.md +0 -153
- package/app/api/config/route.ts +0 -22
- package/app/api/export/route.ts +0 -83
- package/app/api/models/route.ts +0 -12
- package/app/api/stats/route.ts +0 -46
- package/app/dashboard/page.tsx +0 -445
- package/app/globals.css +0 -35
- package/app/installation/page.tsx +0 -293
- package/app/layout.tsx +0 -35
- package/app/master-design-system.css +0 -2076
- package/app/master-design-system.source.css +0 -8
- package/app/page.tsx +0 -187
- package/app/rechtliches/agb/page.tsx +0 -165
- package/app/rechtliches/datenschutz/page.tsx +0 -128
- package/app/rechtliches/impressum/page.tsx +0 -122
- package/app/rechtliches/widerruf/page.tsx +0 -185
- package/codecov.yml +0 -34
- package/components/layout/AppShell.tsx +0 -25
- package/components/layout/Footer.tsx +0 -120
- package/components/layout/Header.tsx +0 -145
- package/components/marketing/LegalHighlights.tsx +0 -45
- package/components/marketing/LegalPageShell.tsx +0 -49
- package/components/marketing/LegalPanel.tsx +0 -41
- package/components/marketing/index.ts +0 -3
- package/crates/headroom-core/Cargo.toml +0 -165
- package/crates/headroom-core/benches/auth_mode.rs +0 -74
- package/crates/headroom-core/benches/ccr_store.rs +0 -224
- package/crates/headroom-core/benches/tokenizer.rs +0 -52
- package/crates/headroom-core/config/pipeline.toml +0 -151
- package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +0 -9
- package/crates/headroom-core/src/auth_mode.rs +0 -250
- package/crates/headroom-core/src/cache_control.rs +0 -414
- package/crates/headroom-core/src/ccr/backends/in_memory.rs +0 -317
- package/crates/headroom-core/src/ccr/backends/mod.rs +0 -152
- package/crates/headroom-core/src/ccr/backends/redis.rs +0 -146
- package/crates/headroom-core/src/ccr/backends/sqlite.rs +0 -205
- package/crates/headroom-core/src/ccr/mod.rs +0 -119
- package/crates/headroom-core/src/compression_policy.rs +0 -505
- package/crates/headroom-core/src/lib.rs +0 -33
- package/crates/headroom-core/src/relevance/base.rs +0 -139
- package/crates/headroom-core/src/relevance/bm25.rs +0 -385
- package/crates/headroom-core/src/relevance/embedding.rs +0 -354
- package/crates/headroom-core/src/relevance/hybrid.rs +0 -364
- package/crates/headroom-core/src/relevance/mod.rs +0 -64
- package/crates/headroom-core/src/signals/keyword_detector.rs +0 -433
- package/crates/headroom-core/src/signals/line_importance.rs +0 -84
- package/crates/headroom-core/src/signals/mod.rs +0 -61
- package/crates/headroom-core/src/signals/tiered.rs +0 -141
- package/crates/headroom-core/src/tokenizer/estimator.rs +0 -152
- package/crates/headroom-core/src/tokenizer/hf_impl.rs +0 -314
- package/crates/headroom-core/src/tokenizer/mod.rs +0 -56
- package/crates/headroom-core/src/tokenizer/registry.rs +0 -342
- package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +0 -265
- package/crates/headroom-core/src/transforms/adaptive_sizer.rs +0 -610
- package/crates/headroom-core/src/transforms/anchor_selector.rs +0 -1189
- package/crates/headroom-core/src/transforms/content_detector.rs +0 -769
- package/crates/headroom-core/src/transforms/detection.rs +0 -222
- package/crates/headroom-core/src/transforms/diff_compressor.rs +0 -1685
- package/crates/headroom-core/src/transforms/live_zone.rs +0 -2967
- package/crates/headroom-core/src/transforms/log_compressor.rs +0 -1295
- package/crates/headroom-core/src/transforms/magika_detector.rs +0 -395
- package/crates/headroom-core/src/transforms/mod.rs +0 -64
- package/crates/headroom-core/src/transforms/pipeline/config.rs +0 -331
- package/crates/headroom-core/src/transforms/pipeline/mod.rs +0 -103
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +0 -524
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +0 -279
- package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +0 -400
- package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +0 -284
- package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +0 -34
- package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +0 -331
- package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +0 -848
- package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +0 -175
- package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +0 -545
- package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +0 -12
- package/crates/headroom-core/src/transforms/pipeline/traits.rs +0 -338
- package/crates/headroom-core/src/transforms/recommendations.rs +0 -329
- package/crates/headroom-core/src/transforms/safety.rs +0 -215
- package/crates/headroom-core/src/transforms/search_compressor.rs +0 -902
- package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +0 -1262
- package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +0 -407
- package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +0 -263
- package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +0 -214
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +0 -283
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +0 -733
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +0 -961
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +0 -252
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +0 -127
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +0 -397
- package/crates/headroom-core/src/transforms/smart_crusher/config.rs +0 -173
- package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +0 -159
- package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +0 -1665
- package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +0 -865
- package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +0 -77
- package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +0 -393
- package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +0 -72
- package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +0 -81
- package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +0 -66
- package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +0 -459
- package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +0 -507
- package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +0 -904
- package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +0 -510
- package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +0 -287
- package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +0 -203
- package/crates/headroom-core/src/transforms/smart_crusher/types.rs +0 -263
- package/crates/headroom-core/src/transforms/tag_protector.rs +0 -1272
- package/crates/headroom-core/src/transforms/unidiff_detector.rs +0 -232
- package/crates/headroom-parity/Cargo.toml +0 -26
- package/crates/headroom-parity/examples/diff_fixture.rs +0 -66
- package/crates/headroom-parity/src/bin/parity_run.rs +0 -78
- package/crates/headroom-parity/src/lib.rs +0 -613
- package/crates/headroom-proxy/Cargo.toml +0 -119
- package/crates/headroom-proxy/data/model_prices_and_context_window.json +0 -39767
- package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +0 -192
- package/crates/headroom-proxy/src/bedrock/envelope.rs +0 -239
- package/crates/headroom-proxy/src/bedrock/eventstream.rs +0 -769
- package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +0 -459
- package/crates/headroom-proxy/src/bedrock/invoke.rs +0 -735
- package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +0 -1098
- package/crates/headroom-proxy/src/bedrock/mod.rs +0 -66
- package/crates/headroom-proxy/src/bedrock/sigv4.rs +0 -324
- package/crates/headroom-proxy/src/bedrock/vendor.rs +0 -82
- package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +0 -698
- package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +0 -683
- package/crates/headroom-proxy/src/cache_stabilization/mod.rs +0 -61
- package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +0 -600
- package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +0 -514
- package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +0 -720
- package/crates/headroom-proxy/src/compression/anthropic.rs +0 -92
- package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +0 -1311
- package/crates/headroom-proxy/src/compression/live_zone_openai.rs +0 -660
- package/crates/headroom-proxy/src/compression/live_zone_responses.rs +0 -678
- package/crates/headroom-proxy/src/compression/mod.rs +0 -127
- package/crates/headroom-proxy/src/compression/model_limits.rs +0 -211
- package/crates/headroom-proxy/src/config.rs +0 -646
- package/crates/headroom-proxy/src/error.rs +0 -69
- package/crates/headroom-proxy/src/handlers/chat_completions.rs +0 -100
- package/crates/headroom-proxy/src/handlers/conversations.rs +0 -241
- package/crates/headroom-proxy/src/handlers/mod.rs +0 -13
- package/crates/headroom-proxy/src/handlers/responses.rs +0 -256
- package/crates/headroom-proxy/src/headers.rs +0 -288
- package/crates/headroom-proxy/src/health.rs +0 -41
- package/crates/headroom-proxy/src/lib.rs +0 -21
- package/crates/headroom-proxy/src/main.rs +0 -141
- package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +0 -340
- package/crates/headroom-proxy/src/observability/compression_ratio.rs +0 -158
- package/crates/headroom-proxy/src/observability/metric_names.rs +0 -174
- package/crates/headroom-proxy/src/observability/mod.rs +0 -68
- package/crates/headroom-proxy/src/observability/prometheus.rs +0 -394
- package/crates/headroom-proxy/src/observability/proxy_metrics.rs +0 -368
- package/crates/headroom-proxy/src/proxy.rs +0 -1619
- package/crates/headroom-proxy/src/responses_items.rs +0 -565
- package/crates/headroom-proxy/src/sse/anthropic.rs +0 -415
- package/crates/headroom-proxy/src/sse/framing.rs +0 -366
- package/crates/headroom-proxy/src/sse/mod.rs +0 -40
- package/crates/headroom-proxy/src/sse/openai_chat.rs +0 -231
- package/crates/headroom-proxy/src/sse/openai_responses.rs +0 -458
- package/crates/headroom-proxy/src/vertex/adc.rs +0 -315
- package/crates/headroom-proxy/src/vertex/envelope.rs +0 -167
- package/crates/headroom-proxy/src/vertex/mod.rs +0 -277
- package/crates/headroom-proxy/src/vertex/raw_predict.rs +0 -490
- package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +0 -49
- package/crates/headroom-proxy/src/websocket.rs +0 -246
- package/crates/headroom-py/Cargo.toml +0 -37
- package/crates/headroom-py/build.rs +0 -77
- package/crates/headroom-py/glibc_compat.c +0 -170
- package/crates/headroom-py/src/lib.rs +0 -1655
- package/deny.toml +0 -32
- package/design-system/base.css +0 -127
- package/design-system/components.css +0 -1943
- package/design-system/fonts.css +0 -17
- package/design-system/tailwind-preset.js +0 -95
- package/design-system/tokens.css +0 -48
- package/design-system/utilities.css +0 -53
- package/docker/differential-network-capture/Dockerfile.runner +0 -14
- package/docker/differential-network-capture/docker-compose.yml +0 -142
- package/docker/differential-network-capture/run-claude-lane.sh +0 -24
- package/docker/docker-compose.native.yml +0 -44
- package/docker-bake.hcl +0 -88
- package/docker-compose.yml +0 -80
- package/e2e/_lib/make_shim.ps1 +0 -24
- package/e2e/_lib/make_shim.sh +0 -28
- package/e2e/docker-native-install.sh +0 -120
- package/e2e/init/Dockerfile +0 -79
- package/e2e/wrap/Dockerfile +0 -115
- package/examples/07-context-compression.ipynb +0 -279
- package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +0 -65
- package/examples/deployment/macos-launchagent/install.sh +0 -227
- package/examples/deployment/macos-launchagent/shell-integration.sh +0 -74
- package/examples/deployment/macos-launchagent/uninstall.sh +0 -145
- package/headroom-savings.png +0 -0
- package/headroom_learn.gif +0 -0
- package/lib/config/index.ts +0 -12
- package/lib/hooks/index.ts +0 -4
- package/lib/hooks/use-mounted.ts +0 -13
- package/lib/hooks/use-session.ts +0 -34
- package/lib/hooks/use-settings.ts +0 -49
- package/lib/utils/index.ts +0 -1
- package/lib/utils/settings.ts +0 -162
- package/lib/utils/utils.ts +0 -6
- package/llms.txt +0 -67
- package/middleware.ts +0 -26
- package/mkdocs.yml +0 -136
- package/next-env.d.ts +0 -7
- package/next.config.ts +0 -12
- package/npm/bin/xithead.js +0 -366
- package/npm/bin/xtream-head.js +0 -366
- package/npm/package.json +0 -55
- package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +0 -17
- package/plugins/headroom-agent-hooks/hooks/hooks.json +0 -29
- package/plugins/headroom-oauth2/LICENSE +0 -3
- package/plugins/headroom-oauth2/SPEC.md +0 -115
- package/plugins/headroom-oauth2/pyproject.toml +0 -48
- package/plugins/hermes/headroom_retrieve/plugin.yaml +0 -6
- package/plugins/openclaw/hook-shim/HOOK.md +0 -21
- package/plugins/openclaw/hook-shim/handler.js +0 -3
- package/plugins/openclaw/openclaw.plugin.json +0 -98
- package/plugins/openclaw/package-lock.json +0 -2692
- package/plugins/openclaw/package.json +0 -54
- package/plugins/openclaw/prepare-dist.mjs +0 -56
- package/plugins/openclaw/src/convert.ts +0 -418
- package/plugins/openclaw/src/engine.ts +0 -284
- package/plugins/openclaw/src/gateway-config.ts +0 -143
- package/plugins/openclaw/src/index.ts +0 -11
- package/plugins/openclaw/src/plugin/index.ts +0 -98
- package/plugins/openclaw/src/proxy-manager.ts +0 -477
- package/plugins/openclaw/src/tools/headroom-retrieve.ts +0 -76
- package/plugins/openclaw/test/convert.test.ts +0 -96
- package/plugins/openclaw/test/engine-normalization.test.ts +0 -21
- package/plugins/openclaw/test/engine.test.ts +0 -101
- package/plugins/openclaw/test/gateway-config.test.ts +0 -278
- package/plugins/openclaw/test/plugin-runtime-routing.test.ts +0 -141
- package/plugins/openclaw/test/proxy-manager.test.ts +0 -343
- package/plugins/openclaw/tsup.config.ts +0 -9
- package/postcss.config.mjs +0 -7
- package/pyproject.toml +0 -438
- package/rust-toolchain.toml +0 -16
- package/sdk/typescript/examples/basic-compress.ts +0 -64
- package/sdk/typescript/examples/ccr-retrieve.ts +0 -80
- package/sdk/typescript/examples/hooks-custom-compression.ts +0 -117
- package/sdk/typescript/examples/middleware-composition.ts +0 -59
- package/sdk/typescript/examples/multi-provider.ts +0 -53
- package/sdk/typescript/examples/openai-anthropic-adapters.ts +0 -73
- package/sdk/typescript/examples/shared-context-multi-agent.ts +0 -74
- package/sdk/typescript/examples/simulation-dry-run.ts +0 -80
- package/sdk/typescript/examples/streaming-chat.ts +0 -71
- package/sdk/typescript/examples/structured-output.ts +0 -99
- package/sdk/typescript/examples/tool-calling-agent.ts +0 -86
- package/sdk/typescript/examples/with-headroom-vercel.ts +0 -57
- package/sdk/typescript/package-lock.json +0 -3437
- package/sdk/typescript/package.json +0 -108
- package/sdk/typescript/src/adapters/anthropic.ts +0 -218
- package/sdk/typescript/src/adapters/gemini.ts +0 -83
- package/sdk/typescript/src/adapters/openai.ts +0 -77
- package/sdk/typescript/src/adapters/vercel-ai.ts +0 -131
- package/sdk/typescript/src/client.ts +0 -632
- package/sdk/typescript/src/compress.ts +0 -87
- package/sdk/typescript/src/errors.ts +0 -114
- package/sdk/typescript/src/hooks.ts +0 -113
- package/sdk/typescript/src/index.ts +0 -140
- package/sdk/typescript/src/paths.ts +0 -272
- package/sdk/typescript/src/shared-context.ts +0 -188
- package/sdk/typescript/src/simulate.ts +0 -52
- package/sdk/typescript/src/types/config.ts +0 -183
- package/sdk/typescript/src/types/models.ts +0 -314
- package/sdk/typescript/src/types.ts +0 -139
- package/sdk/typescript/src/utils/case.ts +0 -34
- package/sdk/typescript/src/utils/format.ts +0 -480
- package/sdk/typescript/src/utils/stream.ts +0 -50
- package/sdk/typescript/test/adapters/anthropic.test.ts +0 -217
- package/sdk/typescript/test/adapters/gemini.test.ts +0 -131
- package/sdk/typescript/test/adapters/openai.test.ts +0 -174
- package/sdk/typescript/test/adapters/vercel-ai.test.ts +0 -306
- package/sdk/typescript/test/client-expanded.test.ts +0 -333
- package/sdk/typescript/test/client.test.ts +0 -266
- package/sdk/typescript/test/compress.test.ts +0 -118
- package/sdk/typescript/test/config.test.ts +0 -275
- package/sdk/typescript/test/errors.test.ts +0 -169
- package/sdk/typescript/test/format-integration.test.ts +0 -252
- package/sdk/typescript/test/hooks.test.ts +0 -265
- package/sdk/typescript/test/integration.test.ts +0 -249
- package/sdk/typescript/test/mdx-examples.test.ts +0 -253
- package/sdk/typescript/test/models.test.ts +0 -318
- package/sdk/typescript/test/parity.test.ts +0 -337
- package/sdk/typescript/test/paths.test.ts +0 -447
- package/sdk/typescript/test/shared-context.test.ts +0 -245
- package/sdk/typescript/test/simulate.test.ts +0 -84
- package/sdk/typescript/test/types.test.ts +0 -244
- package/sdk/typescript/test/utils/case.test.ts +0 -129
- package/sdk/typescript/test/utils/detect-format.test.ts +0 -133
- package/sdk/typescript/test/utils/format.test.ts +0 -434
- package/sdk/typescript/test/vercel-ai-e2e.test.ts +0 -179
- package/sdk/typescript/tsup.config.ts +0 -17
- package/tailwind.master.config.cjs +0 -47
- package/types/api.ts +0 -12
- package/types/config.ts +0 -9
- package/types/index.ts +0 -2
- package/uv.lock +0 -6951
- package/xithead.egg-info/PKG-INFO +0 -22
- package/xithead.egg-info/SOURCES.txt +0 -16
- package/xithead.egg-info/dependency_links.txt +0 -1
- package/xithead.egg-info/entry_points.txt +0 -2
- package/xithead.egg-info/requires.txt +0 -10
- package/xithead.egg-info/top_level.txt +0 -2
- package/xithead.ps1 +0 -136
- package/xithead.sh +0 -129
- package/xithead_dist/pyproject.toml +0 -39
- package/xithead_dist/xithead.egg-info/PKG-INFO +0 -22
- package/xithead_dist/xithead.egg-info/SOURCES.txt +0 -16
- package/xithead_dist/xithead.egg-info/dependency_links.txt +0 -1
- package/xithead_dist/xithead.egg-info/entry_points.txt +0 -3
- package/xithead_dist/xithead.egg-info/requires.txt +0 -10
- package/xithead_dist/xithead.egg-info/top_level.txt +0 -2
- /package/{npm/index.d.ts → index.d.ts} +0 -0
- /package/{npm/postinstall.js → postinstall.js} +0 -0
package/npm/bin/xtream-head.js
DELETED
|
@@ -1,366 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* xithead CLI — Claude Context Optimizer
|
|
4
|
-
* by Xtream-ITSolutions UG | discord.gg/xtream-itsolutions
|
|
5
|
-
*/
|
|
6
|
-
'use strict';
|
|
7
|
-
|
|
8
|
-
const { spawnSync, spawn, execSync } = require('child_process');
|
|
9
|
-
const http = require('http');
|
|
10
|
-
const https = require('https');
|
|
11
|
-
const path = require('path');
|
|
12
|
-
const fs = require('fs');
|
|
13
|
-
|
|
14
|
-
const PKG_PATH = path.join(__dirname, '../../package.json');
|
|
15
|
-
const PKG_VERSION = (() => {
|
|
16
|
-
try { return require(PKG_PATH).version; } catch { return '1.2.0'; }
|
|
17
|
-
})();
|
|
18
|
-
|
|
19
|
-
const args = process.argv.slice(2);
|
|
20
|
-
const PROXY_PORT = 8787;
|
|
21
|
-
const PROXY_URL = `http://localhost:${PROXY_PORT}`;
|
|
22
|
-
|
|
23
|
-
// ── Update logic ──────────────────────────────────────────────────────────────
|
|
24
|
-
|
|
25
|
-
const UPDATE_CACHE = path.join(
|
|
26
|
-
process.env.APPDATA || process.env.HOME || require('os').homedir(),
|
|
27
|
-
'.xithead', 'last_update_check'
|
|
28
|
-
);
|
|
29
|
-
|
|
30
|
-
function shouldCheckUpdate() {
|
|
31
|
-
try {
|
|
32
|
-
const ts = parseInt(fs.readFileSync(UPDATE_CACHE, 'utf8').trim(), 10);
|
|
33
|
-
return Date.now() - ts > 6 * 60 * 60 * 1000; // once per 6h
|
|
34
|
-
} catch { return true; }
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
function markUpdateChecked() {
|
|
38
|
-
try {
|
|
39
|
-
fs.mkdirSync(path.dirname(UPDATE_CACHE), { recursive: true });
|
|
40
|
-
fs.writeFileSync(UPDATE_CACHE, String(Date.now()));
|
|
41
|
-
} catch {}
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
function fetchLatestNpmVersion() {
|
|
45
|
-
return new Promise(resolve => {
|
|
46
|
-
const req = https.get('https://registry.npmjs.org/xithead/latest', { timeout: 5000 }, res => {
|
|
47
|
-
let body = '';
|
|
48
|
-
res.on('data', d => body += d);
|
|
49
|
-
res.on('end', () => {
|
|
50
|
-
try { resolve(JSON.parse(body).version || null); } catch { resolve(null); }
|
|
51
|
-
});
|
|
52
|
-
});
|
|
53
|
-
req.on('error', () => resolve(null));
|
|
54
|
-
req.on('timeout', () => { req.destroy(); resolve(null); });
|
|
55
|
-
});
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
function versionGt(a, b) {
|
|
59
|
-
const pa = a.split('.').map(Number);
|
|
60
|
-
const pb = b.split('.').map(Number);
|
|
61
|
-
for (let i = 0; i < 3; i++) {
|
|
62
|
-
if ((pa[i]||0) > (pb[i]||0)) return true;
|
|
63
|
-
if ((pa[i]||0) < (pb[i]||0)) return false;
|
|
64
|
-
}
|
|
65
|
-
return false;
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
async function autoUpdate(py) {
|
|
69
|
-
if (!shouldCheckUpdate()) return;
|
|
70
|
-
markUpdateChecked();
|
|
71
|
-
|
|
72
|
-
const latest = await fetchLatestNpmVersion();
|
|
73
|
-
if (!latest || !versionGt(latest, PKG_VERSION)) {
|
|
74
|
-
// npm is up to date — still ensure Python pkg is current (silent)
|
|
75
|
-
if (py) {
|
|
76
|
-
spawn(py, ['-m', 'pip', 'install', '-q', '--upgrade', 'xithead[proxy]'], {
|
|
77
|
-
detached: true, stdio: 'ignore',
|
|
78
|
-
}).unref();
|
|
79
|
-
}
|
|
80
|
-
return;
|
|
81
|
-
}
|
|
82
|
-
|
|
83
|
-
// New npm version available — update in background
|
|
84
|
-
process.stdout.write(
|
|
85
|
-
`\x1b[33m [xithead] Update v${PKG_VERSION} → v${latest} wird installiert...\x1b[0m\n`
|
|
86
|
-
);
|
|
87
|
-
|
|
88
|
-
const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
|
|
89
|
-
const up = spawn(
|
|
90
|
-
npmCmd,
|
|
91
|
-
['install', '-g', '--allow-scripts=xtream-head', `xtream-head@${latest}`],
|
|
92
|
-
{ detached: true, stdio: 'ignore' }
|
|
93
|
-
);
|
|
94
|
-
up.unref();
|
|
95
|
-
|
|
96
|
-
// Also update Python package
|
|
97
|
-
if (py) {
|
|
98
|
-
spawn(py, ['-m', 'pip', 'install', '-q', '--upgrade', 'xithead[proxy]'], {
|
|
99
|
-
detached: true, stdio: 'ignore',
|
|
100
|
-
}).unref();
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
process.stdout.write(
|
|
104
|
-
`\x1b[32m [xithead] Update läuft im Hintergrund — beim nächsten Start aktiv.\x1b[0m\n`
|
|
105
|
-
);
|
|
106
|
-
}
|
|
107
|
-
|
|
108
|
-
// ── Helpers ───────────────────────────────────────────────────────────────────
|
|
109
|
-
|
|
110
|
-
function findPython() {
|
|
111
|
-
for (const cmd of ['python', 'python3', 'py']) {
|
|
112
|
-
const r = spawnSync(cmd, ['--version'], { stdio: 'pipe' });
|
|
113
|
-
if (r.status === 0) return cmd;
|
|
114
|
-
}
|
|
115
|
-
return null;
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
function proxyAlive() {
|
|
119
|
-
return new Promise(resolve => {
|
|
120
|
-
const tryEndpoint = (p, cb) => {
|
|
121
|
-
const req = http.get(`${PROXY_URL}${p}`, { timeout: 3000 }, res => {
|
|
122
|
-
cb(res.statusCode === 200);
|
|
123
|
-
});
|
|
124
|
-
req.on('error', () => cb(false));
|
|
125
|
-
req.on('timeout', () => { req.destroy(); cb(false); });
|
|
126
|
-
};
|
|
127
|
-
tryEndpoint('/health', ok => {
|
|
128
|
-
if (ok) return resolve(true);
|
|
129
|
-
tryEndpoint('/api/stats', resolve);
|
|
130
|
-
});
|
|
131
|
-
});
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
function startProxy(py) {
|
|
135
|
-
const child = spawn(py, ['-m', 'xithead.cli.main', 'proxy', '--port', String(PROXY_PORT)], {
|
|
136
|
-
detached: true,
|
|
137
|
-
stdio: 'ignore',
|
|
138
|
-
windowsHide: true,
|
|
139
|
-
});
|
|
140
|
-
child.unref();
|
|
141
|
-
}
|
|
142
|
-
|
|
143
|
-
function waitForProxy(timeoutMs = 20000) {
|
|
144
|
-
return new Promise(async resolve => {
|
|
145
|
-
const deadline = Date.now() + timeoutMs;
|
|
146
|
-
while (Date.now() < deadline) {
|
|
147
|
-
if (await proxyAlive()) return resolve(true);
|
|
148
|
-
await new Promise(r => setTimeout(r, 400));
|
|
149
|
-
}
|
|
150
|
-
resolve(false);
|
|
151
|
-
});
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
function hasPythonXithead(py) {
|
|
155
|
-
const r = spawnSync(py, ['-c', 'import xithead'], { stdio: 'pipe' });
|
|
156
|
-
return r.status === 0;
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
function hasProxyDeps(py) {
|
|
160
|
-
const r = spawnSync(py, ['-c', 'import fastapi, uvicorn, httpx'], { stdio: 'pipe' });
|
|
161
|
-
return r.status === 0;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
function installProxyDeps(py) {
|
|
165
|
-
process.stdout.write('\x1b[33m [xithead] Installiere Proxy-Abhängigkeiten...\x1b[0m\n');
|
|
166
|
-
const r = spawnSync(py, ['-m', 'pip', 'install', '-q', 'xithead[proxy]'], { stdio: 'inherit' });
|
|
167
|
-
return r.status === 0;
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
// ── Commands ──────────────────────────────────────────────────────────────────
|
|
171
|
-
|
|
172
|
-
function showBanner(proxyOk) {
|
|
173
|
-
const R = '\x1b[0m', B = '\x1b[1m';
|
|
174
|
-
const cyan = '\x1b[96m', cyanD = '\x1b[36m';
|
|
175
|
-
const green = '\x1b[92m', greenD = '\x1b[32m';
|
|
176
|
-
const yellow = '\x1b[93m';
|
|
177
|
-
const gray = '\x1b[90m';
|
|
178
|
-
const magenta = '\x1b[95m';
|
|
179
|
-
const white = '\x1b[97m';
|
|
180
|
-
|
|
181
|
-
const proxyLine = proxyOk
|
|
182
|
-
? `${green} ┃ ${greenD}Proxy ${green}${B}aktiv ✓${R}${green} http://localhost:${PROXY_PORT} ┃${R}`
|
|
183
|
-
: `${yellow} ┃ ${yellow}Proxy direkte Anthropic API (kein Proxy) ┃${R}`;
|
|
184
|
-
|
|
185
|
-
console.log('');
|
|
186
|
-
console.log(`${cyanD} ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓${R}`);
|
|
187
|
-
console.log(`${cyanD} ┃${R} ${B}${white}⚡ xithead${R} ${cyan}v${PKG_VERSION}${R} ${gray}by Xtream-ITSolutions UG${R} ${cyanD}┃${R}`);
|
|
188
|
-
console.log(`${cyanD} ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫${R}`);
|
|
189
|
-
console.log(`${cyanD} ┃${R} ${gray}Modus ${R}${magenta}${B}Ultra-Aggressiv (50–95% Einsparung)${R} ${cyanD}┃${R}`);
|
|
190
|
-
console.log(proxyLine);
|
|
191
|
-
console.log(`${cyanD} ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫${R}`);
|
|
192
|
-
if (proxyOk) {
|
|
193
|
-
console.log(`${cyanD} ┃${R} ${gray}Dashboard ${cyan}http://localhost:${PROXY_PORT}/dashboard${R} ${cyanD}┃${R}`);
|
|
194
|
-
}
|
|
195
|
-
console.log(`${cyanD} ┃${R} ${gray}Discord ${R}\x1b[34mdiscord.gg/xtream-itsolutions${R} ${cyanD}┃${R}`);
|
|
196
|
-
console.log(`${cyanD} ┃${R} ${gray}Web ${R}\x1b[34mxtream-itsolutions.com${R} ${cyanD}┃${R}`);
|
|
197
|
-
console.log(`${cyanD} ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛${R}`);
|
|
198
|
-
console.log('');
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
function showHelp() {
|
|
202
|
-
const c = { cyan: '\x1b[36m', green: '\x1b[32m', gray: '\x1b[90m', reset: '\x1b[0m' };
|
|
203
|
-
console.log('');
|
|
204
|
-
console.log(`${c.cyan} xithead — Claude Context Optimizer${c.reset}`);
|
|
205
|
-
console.log(`${c.gray} by Xtream-ITSolutions UG${c.reset}`);
|
|
206
|
-
console.log('');
|
|
207
|
-
console.log(`${c.green} xithead${c.reset} Claude starten (Proxy auto, 50-95% Einsparung)`);
|
|
208
|
-
console.log(`${c.green} xithead proxy${c.reset} Proxy + Dashboard starten`);
|
|
209
|
-
console.log(`${c.green} xithead stats${c.reset} Token-Einsparungen anzeigen`);
|
|
210
|
-
console.log(`${c.green} xithead update${c.reset} Manuelles Update (npm + Python)`);
|
|
211
|
-
console.log(`${c.green} xithead help${c.reset} Diese Hilfe`);
|
|
212
|
-
console.log('');
|
|
213
|
-
console.log(`${c.gray} Dashboard: http://localhost:${PROXY_PORT}/dashboard${c.reset}`);
|
|
214
|
-
console.log(`${c.gray} Discord: discord.gg/xtream-itsolutions${c.reset}`);
|
|
215
|
-
console.log('');
|
|
216
|
-
}
|
|
217
|
-
|
|
218
|
-
async function showStats() {
|
|
219
|
-
return new Promise(resolve => {
|
|
220
|
-
const req = http.get(`${PROXY_URL}/api/stats`, { timeout: 3000 }, res => {
|
|
221
|
-
let body = '';
|
|
222
|
-
res.on('data', d => body += d);
|
|
223
|
-
res.on('end', () => {
|
|
224
|
-
try {
|
|
225
|
-
const s = JSON.parse(body);
|
|
226
|
-
const c = { cyan: '\x1b[36m', green: '\x1b[32m', gray: '\x1b[90m', reset: '\x1b[0m' };
|
|
227
|
-
console.log('');
|
|
228
|
-
console.log(`${c.cyan} ┌─────────────────────────────────────┐${c.reset}`);
|
|
229
|
-
console.log(`${c.cyan} │ xithead Statistiken │${c.reset}`);
|
|
230
|
-
console.log(`${c.cyan} ├─────────────────────────────────────┤${c.reset}`);
|
|
231
|
-
console.log(`${c.reset} │ Requests: ${String(s.session.requests).padEnd(19)}│${c.reset}`);
|
|
232
|
-
console.log(`${c.green} │ Tokens gespart: ${String(s.session.tokens_saved).padEnd(19)}│${c.reset}`);
|
|
233
|
-
console.log(`${c.green} │ Kosten gespart: $${String((s.session.cost_saved_usd||0).toFixed(4)).padEnd(18)}│${c.reset}`);
|
|
234
|
-
console.log(`${c.cyan} │ Cache-Hit-Rate: ${String(((s.session.cache_hit_rate||0)*100).toFixed(1)+'%').padEnd(19)}│${c.reset}`);
|
|
235
|
-
console.log(`${c.gray} │ Modell: ${String(s.model||'').padEnd(19)}│${c.reset}`);
|
|
236
|
-
console.log(`${c.cyan} └─────────────────────────────────────┘${c.reset}`);
|
|
237
|
-
} catch { console.log(' [xithead] Konnte Stats nicht parsen.'); }
|
|
238
|
-
resolve();
|
|
239
|
-
});
|
|
240
|
-
});
|
|
241
|
-
req.on('error', () => {
|
|
242
|
-
console.log('\x1b[33m [xithead] Proxy nicht erreichbar — starte mit: xithead\x1b[0m');
|
|
243
|
-
resolve();
|
|
244
|
-
});
|
|
245
|
-
req.on('timeout', () => { req.destroy(); resolve(); });
|
|
246
|
-
});
|
|
247
|
-
}
|
|
248
|
-
|
|
249
|
-
async function runManualUpdate(py) {
|
|
250
|
-
const c = { cyan: '\x1b[36m', green: '\x1b[32m', yellow: '\x1b[33m', reset: '\x1b[0m' };
|
|
251
|
-
console.log('');
|
|
252
|
-
console.log(`${c.cyan} [xithead] Prüfe auf Updates...${c.reset}`);
|
|
253
|
-
|
|
254
|
-
const latest = await fetchLatestNpmVersion();
|
|
255
|
-
if (latest && versionGt(latest, PKG_VERSION)) {
|
|
256
|
-
console.log(`${c.yellow} npm: v${PKG_VERSION} → v${latest}${c.reset}`);
|
|
257
|
-
const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
|
|
258
|
-
spawnSync(npmCmd, ['install', '-g', '--allow-scripts=xtream-head', `xtream-head@${latest}`], { stdio: 'inherit' });
|
|
259
|
-
console.log(`${c.green} npm xithead auf v${latest} aktualisiert ✓${c.reset}`);
|
|
260
|
-
} else {
|
|
261
|
-
console.log(`${c.green} npm xithead v${PKG_VERSION} — bereits aktuell ✓${c.reset}`);
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
if (py) {
|
|
265
|
-
console.log(`${c.cyan} Python xithead[proxy] wird aktualisiert...${c.reset}`);
|
|
266
|
-
spawnSync(py, ['-m', 'pip', 'install', '-q', '--upgrade', 'xithead[proxy]'], { stdio: 'inherit' });
|
|
267
|
-
console.log(`${c.green} Python-Paket aktualisiert ✓${c.reset}`);
|
|
268
|
-
}
|
|
269
|
-
|
|
270
|
-
markUpdateChecked();
|
|
271
|
-
console.log('');
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
// ── Main ──────────────────────────────────────────────────────────────────────
|
|
275
|
-
|
|
276
|
-
async function main() {
|
|
277
|
-
const cmd = args[0];
|
|
278
|
-
|
|
279
|
-
if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
|
|
280
|
-
showHelp();
|
|
281
|
-
return;
|
|
282
|
-
}
|
|
283
|
-
|
|
284
|
-
if (cmd === 'stats') {
|
|
285
|
-
await showStats();
|
|
286
|
-
return;
|
|
287
|
-
}
|
|
288
|
-
|
|
289
|
-
const py = findPython();
|
|
290
|
-
|
|
291
|
-
if (cmd === 'update') {
|
|
292
|
-
await runManualUpdate(py);
|
|
293
|
-
return;
|
|
294
|
-
}
|
|
295
|
-
|
|
296
|
-
if (cmd === 'proxy') {
|
|
297
|
-
if (!py || !hasPythonXithead(py)) {
|
|
298
|
-
console.error('\x1b[31m [xithead] Python-Paket nicht installiert.\x1b[0m');
|
|
299
|
-
console.error(' Installieren: pip install "xithead[proxy]"');
|
|
300
|
-
process.exit(1);
|
|
301
|
-
}
|
|
302
|
-
console.log(`\x1b[36m [xithead] Proxy auf Port ${PROXY_PORT} | Ctrl+C zum Stoppen\x1b[0m`);
|
|
303
|
-
console.log(`\x1b[32m [xithead] Dashboard: ${PROXY_URL}/dashboard\x1b[0m`);
|
|
304
|
-
const child = spawnSync(py, ['-m', 'xithead.cli.main', 'proxy', '--port', String(PROXY_PORT), '--verbose'], { stdio: 'inherit' });
|
|
305
|
-
process.exit(child.status || 0);
|
|
306
|
-
return;
|
|
307
|
-
}
|
|
308
|
-
|
|
309
|
-
// Default: launch Claude with proxy
|
|
310
|
-
// Kick off background auto-update check (non-blocking)
|
|
311
|
-
const updatePromise = autoUpdate(py);
|
|
312
|
-
|
|
313
|
-
let proxyOk = await proxyAlive();
|
|
314
|
-
|
|
315
|
-
if (!proxyOk && py && hasPythonXithead(py)) {
|
|
316
|
-
if (!hasProxyDeps(py)) {
|
|
317
|
-
const ok = installProxyDeps(py);
|
|
318
|
-
if (!ok) {
|
|
319
|
-
console.log('\x1b[31m [xithead] Proxy-Abhängigkeiten konnten nicht installiert werden.\x1b[0m');
|
|
320
|
-
console.log(' Manuell: pip install "xithead[proxy]"');
|
|
321
|
-
}
|
|
322
|
-
}
|
|
323
|
-
process.stdout.write('\x1b[33m [xithead] Proxy startet...\x1b[0m');
|
|
324
|
-
startProxy(py);
|
|
325
|
-
proxyOk = await waitForProxy(20000);
|
|
326
|
-
if (!proxyOk) {
|
|
327
|
-
proxyOk = await proxyAlive();
|
|
328
|
-
}
|
|
329
|
-
process.stdout.write(proxyOk ? ' \x1b[32mbereit!\x1b[0m\n' : ' \x1b[33mTimeout — direkte API\x1b[0m\n');
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
showBanner(proxyOk);
|
|
333
|
-
|
|
334
|
-
// Wait for update check to finish (it's fast, already running)
|
|
335
|
-
await updatePromise;
|
|
336
|
-
|
|
337
|
-
const env = {
|
|
338
|
-
...process.env,
|
|
339
|
-
CLAUDE_CODE_MAX_OUTPUT_TOKENS: '16000',
|
|
340
|
-
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
|
|
341
|
-
XTREAM_HEAD_ENABLE_CACHE_CONTROL: '1',
|
|
342
|
-
XTREAM_HEAD_ENABLE_DEDUP: '1',
|
|
343
|
-
XTREAM_HEAD_ENABLE_CONTEXT_TRIM: '1',
|
|
344
|
-
HEADROOM_STRENGTH: 'aggressive',
|
|
345
|
-
HEADROOM_COMPRESSION_RATIO_TARGET: '0.3',
|
|
346
|
-
};
|
|
347
|
-
// Claude Code haengt /v1/... selbst an — Basis-URL daher OHNE /v1 (wie upstream headroom)
|
|
348
|
-
if (proxyOk) {
|
|
349
|
-
env.ANTHROPIC_BASE_URL = PROXY_URL;
|
|
350
|
-
} else {
|
|
351
|
-
delete env.ANTHROPIC_BASE_URL; // direkte Anthropic-API, Claude nutzt seinen Default
|
|
352
|
-
}
|
|
353
|
-
|
|
354
|
-
const claudeResult = spawnSync(process.platform === 'win32' ? 'where' : 'which', ['claude'], { stdio: 'pipe' });
|
|
355
|
-
if (claudeResult.status !== 0) {
|
|
356
|
-
console.error('\x1b[31m [xithead] Claude Code nicht gefunden. Installieren:\x1b[0m');
|
|
357
|
-
console.error(' npm install -g @anthropic-ai/claude-code');
|
|
358
|
-
process.exit(1);
|
|
359
|
-
}
|
|
360
|
-
|
|
361
|
-
const claudeArgs = args.length > 0 ? args : [];
|
|
362
|
-
const claudeProc = spawnSync('claude', claudeArgs, { stdio: 'inherit', env });
|
|
363
|
-
process.exit(claudeProc.status || 0);
|
|
364
|
-
}
|
|
365
|
-
|
|
366
|
-
main().catch(e => { console.error(e); process.exit(1); });
|
package/npm/package.json
DELETED
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "xtream-head",
|
|
3
|
-
"version": "1.4.0",
|
|
4
|
-
"description": "Lokaler Claude Code Proxy — Prompt Cache maximieren, Token-Kosten bis zu 88% reduzieren. By Xtream-ITSolutions UG.",
|
|
5
|
-
"keywords": [
|
|
6
|
-
"claude",
|
|
7
|
-
"anthropic",
|
|
8
|
-
"llm",
|
|
9
|
-
"token",
|
|
10
|
-
"optimization",
|
|
11
|
-
"caching",
|
|
12
|
-
"proxy",
|
|
13
|
-
"context",
|
|
14
|
-
"ai",
|
|
15
|
-
"cost-reduction",
|
|
16
|
-
"claude-code"
|
|
17
|
-
],
|
|
18
|
-
"author": "Xtream-ITSolutions UG <hello@xtream-itsolutions.com>",
|
|
19
|
-
"license": "Apache-2.0",
|
|
20
|
-
"homepage": "https://xtream-head.com",
|
|
21
|
-
"repository": {
|
|
22
|
-
"type": "git",
|
|
23
|
-
"url": "git+https://github.com/xtream-itsolutions/xithead.git"
|
|
24
|
-
},
|
|
25
|
-
"bugs": {
|
|
26
|
-
"url": "https://github.com/xtream-itsolutions/xithead/issues"
|
|
27
|
-
},
|
|
28
|
-
"bin": {
|
|
29
|
-
"xtream-head": "./bin/xtream-head.js",
|
|
30
|
-
"xithead": "./bin/xithead.js"
|
|
31
|
-
},
|
|
32
|
-
"files": [
|
|
33
|
-
"index.js",
|
|
34
|
-
"index.d.ts",
|
|
35
|
-
"bin/",
|
|
36
|
-
"config/",
|
|
37
|
-
"utils/"
|
|
38
|
-
],
|
|
39
|
-
"type": "module",
|
|
40
|
-
"engines": {
|
|
41
|
-
"node": ">=18.0.0"
|
|
42
|
-
},
|
|
43
|
-
"dependencies": {
|
|
44
|
-
"chalk": "^5.3.0",
|
|
45
|
-
"dotenv": "^16.4.5",
|
|
46
|
-
"yargs": "^17.7.2"
|
|
47
|
-
},
|
|
48
|
-
"devDependencies": {
|
|
49
|
-
"@types/node": "^22.0.0"
|
|
50
|
-
},
|
|
51
|
-
"publishConfig": {
|
|
52
|
-
"access": "public",
|
|
53
|
-
"registry": "https://registry.npmjs.org/"
|
|
54
|
-
}
|
|
55
|
-
}
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "headroom",
|
|
3
|
-
"version": "0.22.3",
|
|
4
|
-
"description": "Headroom startup hooks for Claude Code and GitHub Copilot CLI.",
|
|
5
|
-
"author": {
|
|
6
|
-
"name": "Headroom Contributors",
|
|
7
|
-
"url": "https://github.com/Xtream-ITSolutions/xithead"
|
|
8
|
-
},
|
|
9
|
-
"homepage": "https://github.com/Xtream-ITSolutions/xithead",
|
|
10
|
-
"repository": "https://github.com/Xtream-ITSolutions/xithead",
|
|
11
|
-
"keywords": [
|
|
12
|
-
"headroom",
|
|
13
|
-
"hooks",
|
|
14
|
-
"claude-code",
|
|
15
|
-
"copilot-cli"
|
|
16
|
-
]
|
|
17
|
-
}
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"description": "Headroom plugin hooks — ensure the local Headroom runtime is available for initialized agents.",
|
|
3
|
-
"hooks": {
|
|
4
|
-
"SessionStart": [
|
|
5
|
-
{
|
|
6
|
-
"matcher": "startup|resume",
|
|
7
|
-
"hooks": [
|
|
8
|
-
{
|
|
9
|
-
"type": "command",
|
|
10
|
-
"command": "headroom init hook ensure",
|
|
11
|
-
"timeout": 15
|
|
12
|
-
}
|
|
13
|
-
]
|
|
14
|
-
}
|
|
15
|
-
],
|
|
16
|
-
"PreToolUse": [
|
|
17
|
-
{
|
|
18
|
-
"matcher": "Bash|PowerShell",
|
|
19
|
-
"hooks": [
|
|
20
|
-
{
|
|
21
|
-
"type": "command",
|
|
22
|
-
"command": "headroom init hook ensure",
|
|
23
|
-
"timeout": 15
|
|
24
|
-
}
|
|
25
|
-
]
|
|
26
|
-
}
|
|
27
|
-
]
|
|
28
|
-
}
|
|
29
|
-
}
|
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# Spec — `headroom-oauth2` (generic OAuth2 client-credentials upstream auth)
|
|
2
|
-
|
|
3
|
-
Feature request: [chopratejas/headroom#778](https://github.com/Xtream-ITSolutions/xithead/issues/778).
|
|
4
|
-
Status: implementation ready; awaiting maintainer 👍 before merge.
|
|
5
|
-
|
|
6
|
-
## Summary
|
|
7
|
-
|
|
8
|
-
A vendor-neutral proxy extension (registers on Headroom's `headroom.proxy_extension` seam) that
|
|
9
|
-
mints an OAuth2 **client-credentials** (RFC 6749 §4.4) bearer from a configured token endpoint and
|
|
10
|
-
injects it as the upstream `Authorization` on every proxied request. Lets Headroom front any
|
|
11
|
-
gateway that requires a minted machine token (not a static API key) — with **zero core changes**
|
|
12
|
-
and **no vendor specifics** (the gateway is entirely config/env).
|
|
13
|
-
|
|
14
|
-
It complements `#510` (env-var auth), which assumes a long-lived static key; this covers the
|
|
15
|
-
"mint-then-refresh a short-lived token" case.
|
|
16
|
-
|
|
17
|
-
## API surface (config / CLI / env)
|
|
18
|
-
|
|
19
|
-
Opt-in only, via Headroom's existing flags — **no new CLI flags**:
|
|
20
|
-
|
|
21
|
-
xtream-head proxy --backend litellm-openai --proxy-extension oauth2
|
|
22
|
-
# or HEADROOM_PROXY_EXTENSIONS=oauth2
|
|
23
|
-
|
|
24
|
-
All configuration is env (12-factor; nothing baked in):
|
|
25
|
-
|
|
26
|
-
| Env var | Required | Meaning |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| `HEADROOM_OAUTH2_TOKEN_URL` | yes (else no-op) | OAuth2 token endpoint; must be `https` (loopback `http` allowed for tests) |
|
|
29
|
-
| `HEADROOM_OAUTH2_CLIENT_ID` / `_CLIENT_SECRET` | yes | client credentials |
|
|
30
|
-
| `HEADROOM_OAUTH2_SCOPES` | no | space/comma-separated scopes |
|
|
31
|
-
| `HEADROOM_OAUTH2_AUDIENCE` | no | `audience` form param |
|
|
32
|
-
| `HEADROOM_OAUTH2_RESOURCE` | no | RFC 8707 target `resource` form param |
|
|
33
|
-
| `HEADROOM_OAUTH2_GRANT_TYPE` | no | default `client_credentials` |
|
|
34
|
-
| `HEADROOM_OAUTH2_AUTH_STYLE` | no | `post` (form creds) or `basic` (HTTP Basic) |
|
|
35
|
-
| `HEADROOM_OAUTH2_HEADERS` | no | static upstream headers, `K=V,K2=V2` (control chars rejected) |
|
|
36
|
-
| `HEADROOM_OAUTH2_TIMEOUT` / `_SKEW` | no | token request timeout / pre-expiry refresh skew (s) |
|
|
37
|
-
| `HEADROOM_OAUTH2_ALLOW_INSECURE` | no | `1` to allow a non-loopback `http` token_url (discouraged) |
|
|
38
|
-
|
|
39
|
-
Public Python API: `OAuth2ClientCredentials`, `OAuth2Middleware`, `OAuth2Error`, `install`,
|
|
40
|
-
`provider_from_env`, `parse_headers`.
|
|
41
|
-
|
|
42
|
-
## Changes to existing behavior / defaults / compatibility
|
|
43
|
-
|
|
44
|
-
- **None unless explicitly enabled.** The entry point is dormant until `--proxy-extension oauth2`
|
|
45
|
-
is passed, and even then a **no-op** unless `HEADROOM_OAUTH2_TOKEN_URL` is set.
|
|
46
|
-
- When active, it **overwrites the request `Authorization` header** with the minted bearer before
|
|
47
|
-
the backend runs. The client's own `Authorization`/`x-api-key` is intentionally replaced (the
|
|
48
|
-
proxy authenticates to the gateway on the client's behalf). *Compatibility note:* because the
|
|
49
|
-
request then carries a bearer, Headroom classifies it as OAuth-mode auth — same as supplying a
|
|
50
|
-
bearer yourself; no new classification path.
|
|
51
|
-
- No change to defaults, the request/response body, model routing, or compression.
|
|
52
|
-
|
|
53
|
-
## User stories (Given / When / Then)
|
|
54
|
-
|
|
55
|
-
- **Golden path** — *Given* a proxy started with `--proxy-extension oauth2` and valid
|
|
56
|
-
`TOKEN_URL`/`CLIENT_ID`/`CLIENT_SECRET`, *When* a client sends `/v1/messages`, *Then* the
|
|
57
|
-
extension mints (or reuses a cached) bearer and the upstream receives `Authorization: Bearer
|
|
58
|
-
<minted>` plus any static headers; the client never sees the secret.
|
|
59
|
-
- **Edge: token endpoint down** — *Given* an unreachable/erroring `TOKEN_URL`, *When* a request
|
|
60
|
-
arrives, *Then* the proxy returns `502 upstream_auth_error` (no upstream call, no secret/body
|
|
61
|
-
leak) and stays up; the next request retries.
|
|
62
|
-
- **Edge: wrong backend** — *Given* `--backend bedrock` (env-auth), *When* the extension installs,
|
|
63
|
-
*Then* it logs a loud warning that the injected bearer will have no effect and to use an
|
|
64
|
-
OpenAI-compatible/passthrough backend.
|
|
65
|
-
|
|
66
|
-
## Failure modes & recovery
|
|
67
|
-
|
|
68
|
-
| Failure | Behavior |
|
|
69
|
-
|---|---|
|
|
70
|
-
| Missing/invalid config at startup | `install()` raises -> proxy **fails closed** (won't start mis-auth'd) |
|
|
71
|
-
| Token endpoint unreachable / non-2xx / non-JSON / no `access_token` | `OAuth2Error` -> `502`, per-request, proxy stays up, retried next request |
|
|
72
|
-
| `expires_in` = 0/negative/absent | clamped to a positive TTL (never stale, never per-request mint) |
|
|
73
|
-
| Concurrent first requests | single-flight lock -> exactly one mint per refresh |
|
|
74
|
-
| Malformed `HEADROOM_OAUTH2_HEADERS` (CR/LF) | offending pair dropped with a warning (no header injection) |
|
|
75
|
-
|
|
76
|
-
## Resilience (Docker / native / wrappers / providers / multi-process)
|
|
77
|
-
|
|
78
|
-
- **Native & Docker:** identical; pure env-driven, std-lib only. Token minted via `urllib` against
|
|
79
|
-
the **system cert store**, so a corporate-injected CA is trusted with no bundled roots (works in
|
|
80
|
-
SSL-inspection networks).
|
|
81
|
-
- **Wrappers (`xtream-head wrap`, agent hooks):** the extension lives at the proxy layer, so anything
|
|
82
|
-
routed through the proxy inherits it transparently.
|
|
83
|
-
- **Providers:** effective for OpenAI-compatible / passthrough litellm backends (those that forward
|
|
84
|
-
the request bearer upstream). `bedrock`/`vertex`/`sagemaker` authenticate from env and ignore the
|
|
85
|
-
bearer -> the extension warns and is a no-op there.
|
|
86
|
-
- **Multi-process (multiple workers):** the token cache is per-process; each worker mints/refreshes
|
|
87
|
-
independently. Acceptable for client-credentials (idempotent, low rate); no shared state, no
|
|
88
|
-
cross-process lock needed. Documented so operators can size token-endpoint rate limits.
|
|
89
|
-
|
|
90
|
-
## Security & privacy
|
|
91
|
-
|
|
92
|
-
- Secrets are env-only; **never logged** and **never returned** to the client.
|
|
93
|
-
- The IdP error body is **drained, not surfaced** (may echo sensitive context).
|
|
94
|
-
- `token_url` is **https-enforced** (loopback exception for tests; explicit opt-out env).
|
|
95
|
-
- The minted bearer is sent only to the configured upstream; the client's inbound credential is
|
|
96
|
-
replaced, not forwarded onward.
|
|
97
|
-
|
|
98
|
-
## Observability / logging / telemetry
|
|
99
|
-
|
|
100
|
-
- `INFO` on install (token_url + auth style, no secrets) and on each mint (`ttl`, scopes).
|
|
101
|
-
- `WARNING` on mint failure, env-auth-backend no-op, and dropped malformed static headers.
|
|
102
|
-
- No metrics/telemetry emitted; piggybacks on Headroom's existing request logging. (A future
|
|
103
|
-
counter for mint/refresh/failure could be added if maintainers want it.)
|
|
104
|
-
|
|
105
|
-
## Rollback / migration
|
|
106
|
-
|
|
107
|
-
- **No migration** — additive and opt-in; existing deployments are unaffected.
|
|
108
|
-
- **Instant rollback:** drop `--proxy-extension oauth2` (or unset `HEADROOM_PROXY_EXTENSIONS`), or
|
|
109
|
-
uninstall the package. No state to clean up, no config format changes.
|
|
110
|
-
|
|
111
|
-
## Dependencies
|
|
112
|
-
|
|
113
|
-
- **Runtime:** standard library only (no new core dependency). `litellm` is touched **only** if
|
|
114
|
-
`HEADROOM_OAUTH2_HEADERS` is set, and it is already a Headroom backend dependency — declared here
|
|
115
|
-
as the optional `[litellm]` extra, not a hard requirement.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
[build-system]
|
|
2
|
-
requires = ["setuptools>=61"]
|
|
3
|
-
build-backend = "setuptools.build_meta"
|
|
4
|
-
|
|
5
|
-
[project]
|
|
6
|
-
name = "headroom-oauth2"
|
|
7
|
-
version = "0.1.0"
|
|
8
|
-
description = "Generic OAuth2 client-credentials upstream-auth extension for the Xtream Head proxy"
|
|
9
|
-
readme = "README.md"
|
|
10
|
-
requires-python = ">=3.10"
|
|
11
|
-
license = { text = "Apache-2.0" }
|
|
12
|
-
authors = [{ name = "Khalid Shaikh", email = "43288811+mkhalid-s@users.noreply.github.com" }]
|
|
13
|
-
keywords = ["headroom", "oauth2", "client-credentials", "proxy", "llm-gateway"]
|
|
14
|
-
dependencies = []
|
|
15
|
-
classifiers = [
|
|
16
|
-
"Development Status :: 4 - Beta",
|
|
17
|
-
"Intended Audience :: Developers",
|
|
18
|
-
"License :: OSI Approved :: Apache Software License",
|
|
19
|
-
"Programming Language :: Python :: 3",
|
|
20
|
-
"Programming Language :: Python :: 3.10",
|
|
21
|
-
"Programming Language :: Python :: 3.11",
|
|
22
|
-
"Programming Language :: Python :: 3.12",
|
|
23
|
-
"Topic :: Internet :: Proxy Servers",
|
|
24
|
-
"Topic :: Security",
|
|
25
|
-
]
|
|
26
|
-
|
|
27
|
-
[project.optional-dependencies]
|
|
28
|
-
# Only needed if you set HEADROOM_OAUTH2_HEADERS (static upstream headers via litellm.headers).
|
|
29
|
-
# The token-minting + injection path is standard-library only and needs none of this.
|
|
30
|
-
litellm = ["litellm>=1.40"]
|
|
31
|
-
dev = ["pytest>=7", "ruff"]
|
|
32
|
-
test = ["pytest>=7"]
|
|
33
|
-
|
|
34
|
-
[project.urls]
|
|
35
|
-
Homepage = "https://github.com/Xtream-ITSolutions/xithead"
|
|
36
|
-
Repository = "https://github.com/Xtream-ITSolutions/xithead"
|
|
37
|
-
Issues = "https://github.com/Xtream-ITSolutions/xithead/issues"
|
|
38
|
-
|
|
39
|
-
# Registers with Xtream Head's opt-in proxy-extension seam (headroom/proxy/extensions.py).
|
|
40
|
-
# Enable at runtime with `--proxy-extension oauth2` or HEADROOM_PROXY_EXTENSIONS=oauth2.
|
|
41
|
-
[project.entry-points."headroom.proxy_extension"]
|
|
42
|
-
oauth2 = "headroom_oauth2:install"
|
|
43
|
-
|
|
44
|
-
[tool.setuptools.packages.find]
|
|
45
|
-
where = ["src"]
|
|
46
|
-
|
|
47
|
-
[tool.ruff]
|
|
48
|
-
line-length = 100
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: headroom-link-shim
|
|
3
|
-
description: "No-op hook shim so local plugin source paths are also valid OpenClaw hook-pack paths."
|
|
4
|
-
metadata:
|
|
5
|
-
{
|
|
6
|
-
"openclaw":
|
|
7
|
-
{
|
|
8
|
-
"emoji": "🪝",
|
|
9
|
-
"events": ["command"],
|
|
10
|
-
},
|
|
11
|
-
}
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
# Headroom Link Shim
|
|
15
|
-
|
|
16
|
-
This hook intentionally does nothing.
|
|
17
|
-
|
|
18
|
-
OpenClaw currently falls back to validating local plugin paths as hook packs when a
|
|
19
|
-
plugin install cannot proceed, such as when the plugin is already installed.
|
|
20
|
-
Including this no-op hook keeps `--link` installs from reporting a misleading
|
|
21
|
-
`package.json missing openclaw.hooks` error for valid Headroom plugin paths.
|