list_artifacts

list_artifacts#

list_artifacts(prefix: Optional[str] = None, root: str | PathLike | Path = None, include_internal: bool = False, strict: bool = False) list[ArtifactRef]#

List Artifact refs using the Local Registry’s digest-addressed Manifest cache.

Missing Manifest rows are backfilled from the CAS before records are returned. If prefix is given, it is matched against the full image reference string. Internal implementation refs, including Experiment checkpoints, are hidden by default; pass include_internal=True for registry diagnostics.

By default, an invalid cached record is repaired from the CAS when possible. OMMX emits RuntimeWarning for repaired or skipped refs and returns the remaining records. Pass strict=True to fail on the first invalid ref.