json graph reader api / impl

formalizing reader api