Stored run and verification models

Types returned by run persistence and verification, together with the limits and error used by the public run lifecycle.

Stable public API. The 1.x compatibility policy defines the supported surface; import from the public facade shown below.

from vamos.run_artifacts import StoredRun, LoadLimits, VerificationReport

Save, load, and replay · Run artifacts guide

StoredRun dataclass

Immutable data-only handle with lazy, side-effect-free artifact access.

environment cached property

Load and cache the immutable captured environment document.

result cached property

Load and cache the canonical result bundle without executing code.

RunManifest dataclass

Bases: Mapping[str, Any]

Immutable validated envelope for one v1 execution attempt.

artifact(role)

Return the singleton descriptor for role when present.

LoadLimits dataclass

Finite defensive limits used by trusted v1 readers.

Callers may pass a different instance explicitly when they trust a larger artifact. Normal loading never increases these limits automatically.

IncompleteRunMetadataError

Bases: RunArtifactError

A result cannot be saved without complete execution metadata.

CompatibilityReport dataclass

Material compatibility of a stored run with the current runtime.

VerificationReport dataclass

Independent verification dimensions for one canonical run.

ReplayReport dataclass

Outcome and evidence for a newly stored replay attempt.