Stat artifacts
stat_artifactsVerify a collection of sandboxed artifacts by retrieving per-file size, SHA256 hash, and aggregate byte total. Ideal for batch export readback.
Instructions
Stat a SET of sandboxed artifacts: per-file size + sha256 plus an aggregate byte total.
When to use: to verify a whole produced collection (an icon set, a dist/ tree) and read its
TOTAL byte budget in one call — the readback half of a batch export, without a du -cb. For a
single file use stat_artifact.
Key params: paths is a non-empty list; each entry is resolved EXACTLY as stat_artifact
resolves its path (workspace-relative or absolute, sandbox + symlink validated, size-capped).
The first entry that escapes the sandbox or exceeds the size limit fails the whole call with a
stable message — nothing partial is returned.
Return shape: ArtifactStatSet — {artifacts: [{path, bytes, sha256}], total_bytes, count}
where total_bytes is the sum of the per-file sizes and every path is workspace-relative
(never a host path).
Example: stat_artifacts(["dist/16.png", "dist/32.png", "dist/64.png"])
Risk class: low (read-only stat; nothing is mutated, no Operation Record / snapshot).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| artifacts | Yes | ||
| total_bytes | Yes |