pub const KNOWN_CAPABILITIES: &[&str];Expand description
Capability strings the router currently maps routes onto.
Vocabulary, not mechanism — additive by design (see the module header).
fs.read and fs.write are deliberately absent from the operator and
read-only presets, but what that buys differs sharply between the two,
and it is worth being exact rather than claiming a boundary twice:
read-onlyholdssession.readand noexec, so withholdingfs.readis a real containment boundary: such a token genuinely cannot read a file on this machine, and addingfs.readto the preset would have granted an access it did not have.operatorholdsexec. A token that can run commands can already read and write anything the process can reach —Get-Content,cp, a redirect. Withholdingfs.*there contains nothing; it keeps an issued token’s capability surface from changing under it, which is a least-surprise property, not a security one. Do not describe it as confinement.
full-control’s CapabilitySet::wildcard covers both, as it does every
capability — there is no way to keep such a token from the file API once
--fs-root is set, and no reason to try, since exec already dominates it.
The practical consequence: --fs-root is a meaningful jail only for a
token that has fs.* without exec (--capabilities fs.write for a
deploy push, say). Against operator or full-control it is a convenience
boundary — chunked, resumable, checksummed transfer instead of piping bytes
through a command — not a containment one.