move to new client APIs spec
add default 3s timeout
configurable timeout, api version
add upgrade notes