UnregisteredFile

One file under a run's .artifacts/<RunId>/ folder that is not yet a result (D19).

path is what [crate::run_folder::RegisterFileRequest] echoes back; size_bytes and modified_at_ms are what the surface draws beside it.

Type object

Field	Type	Description
pathrequired	RelativePath	A file's place inside a run's `.artifacts/<RunId>/` folder: `/`-separated, never absolute, never carrying a parent-directory step. Content, like a filename, so its `Debug` redacts. It is a statement of where to look, never an authority to look there: the register path rule (`staging::stage`) still resolves it, walks it for links and proves containment. Refusing the obvious faults here as well means a listing this type could not have produced can never be echoed back as a registration.
size_bytesrequired	integer (uint64, >= 0)
modified_at_ms	integer (int64) or null	The file's modification time, when the filesystem reported one.

Example

{
  "path": "string",
  "size_bytes": 0,
  "modified_at_ms": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.