Skip to main content

​
Path mapping

Managed-agents compatibility requests map like this:
LayerExample path
Backend public/api/managed-agents/anthropic/v1/sessions/{session_id}/events
horizons-private upstream/anthropic/v1/sessions/{session_id}/events
Anthropic public style/v1/sessions/{session_id}/events

​
Contract artifacts (backend)

The Anthropic compatibility contract is pinned in backend:
  • OpenAPI pin: backend/contracts/horizons_private_anthropic_openapi.json
  • Phase 1 allowlist: backend/contracts/horizons_private_anthropic_phase1_allowlist.json

​
Contract check and report

Canonical backend command: 
uv run scripts/ci/check_horizons_private_proxy_contract.py \
  --report-path artifacts/horizons_private_proxy_contract_report.json
This should produce:
  • pinned operations
  • allowlisted operations
  • router operations
  • unproxied operations report (visibility)

​
Pin bump workflow

Canonical backend command: 
./scripts/ci/bump_horizons_private_anthropic_openapi_pin.sh
Then run the contract check above and review the report diff.