docs: update example "run" functions to return ints as per the current API