This has to define a very minimal set of information to offer the user when using this option, and should be detached from the implementation.
This could be versioned to be able to evolve and allow people to verify the version they expect.
This could be just a wrapper in front of the API, that already has to implement/define all the above aspects. (see T334590: [buildservice] Create a buildservice API and move any logic from the client to it)