Capabilities and evidence¶
A capability is bounded authority over one resource and action. pVisor reasons
about capabilities by dimension because no single safe or sandboxed label
can describe an Agent environment accurately.
| Dimension | Example request | Evidence to inspect |
|---|---|---|
| Filesystem read | read selected project and toolchain paths | visible roots and installed read controls |
| Filesystem write | write only to a staged workspace | write boundary and promotion decisions |
| Network | reach declared destinations | interception path and bypass resistance |
| Process | start bounded descendants | namespace/profile and inherited handles |
| Credentials | use one short-lived identity | delivery, expiry, and observed use |
| Tools and models | invoke declared endpoints | policy decision and routed calls |
Requested authority and installed enforcement are different facts. Admission must reject a required capability dimension when the selected provider cannot satisfy it. Optional controls may degrade only when the Run record reports that degradation explicitly.
Evidence answers four progressively stronger questions:
- Declared — what policy was requested?
- Mediated — which actions passed through a control point?
- Enforced — which bypass paths were blocked for the stated threat model?
- Attested — is that enforcement bound to this exact Run and provider?
The Run Bundle is the place to inspect the answer for a concrete execution. For the end-to-end trust chain across execution, orchestration, and history, read Security and evidence. For platform mechanisms, read pVisor isolation design.