Currently in testing: the GitHub code will be opened once complete.

R · Released

Structurerefresh

The success response to a release request (R).

token is the value the request carried, echoed back verbatim as a correlator — the client uses it to pin down which request this response belongs to (see Reply Matching Rules).

Byte notation: op is an ASCII character, token is binary (u64, big-endian), and key is UTF-8 text (variable-length, shown as N in the structure). The trailing \n is 0A. The fixed header is a binary value that may contain 0x0A, so it must be consumed by byte count first, before scanning for the newline.

Flow

Holder X
Server
Waiter Y
R · release (key · token)
R · released
if a waiter exists
A · acquired (new token)
requestresponse

R (released) goes only to the releaser. If a waiter existed, separately from that, the connection at the front of the queue receives Acquired A — handed off directly with no re-contention. The two responses go out on different connections, so no ordering between them is required.