In the new proposed interface you have removed $startingPoint and changed $context to a Node. Is that on purpose? We’re currently trying to figure out a way to improve the context handling in another thread, which would likely influence this part as well.
Aside from that I like the general direction.
However not sure if it makes sense to add the include parameter when the return data is an array of nodes. Where would you put the “include” parts?
Also we should define how the page parameter should behave, since it’s agnostic. Personally prefer using offset and limit instead of page numbers.
This is not really a question?