Include full broker messaging spec in /doc

This adds information about the broker API, with the messaging protocol and the endpoints used by clients and proxies.

This is a prerequisite for our work to implement a Snowflake proxy on Android.