socket: simpler interface to refresh/delete state of other clients
Readme, docs typo fixes