delete

Delete a file or directory from the sandbox via a server-side rm.

Runs test -e || test -L first: a path that does not exist (and is not a broken symlink) returns a not-found error, matching the contract of FilesystemBackend and StateBackend. Because a shell test has no error channel, a non-zero probe conflates "absent" with "unstattable" (e.g. an unsearchable parent directory); an unknown exit code is not treated as absent and falls through to the delete.

Uses rm -rf, so directories are removed recursively along with their contents. A recursive delete may remove some entries before failing partway; a non-zero rm exit (e.g. a permission error) is reported as a failure.