This question has been answered by BobRay. See the first response.
$new = $modx->resource->duplicate();
I'm going to test that now.
$duplicateChildren = isset($options['duplicateChildren']) ? $options['duplicateChildren'] : true;
$options['newName'] $options['parent'] $options['overrides'] // let's you set other field values, I think.
get yourself a copy of PhpStorm and ... search the whole project ...