Merge pull request #221 from drnic/agent_readme

[bosh_agent] readme intro & API documentation
[bosh_agent] readme clarification on nats vs https

bosh_agent does not currently support both nats & https API modes