sequence-base 0.3.28__tar.gz → 0.3.29__tar.gz

{sequence_base-0.3.28 → sequence_base-0.3.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.3.28
+Version: 0.3.29
 Summary: Shared foundation for the Sequences platform — wire contract, correlation, error taxonomy, constants. Used by the robot SDK, gateway, and container harness.
 Requires-Python: >=3.10
 Requires-Dist: pydantic>=2.0

{sequence_base-0.3.28 → sequence_base-0.3.29}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sequence-base"
-version = "0.3.28"
+version = "0.3.29"
 description = "Shared foundation for the Sequences platform — wire contract, correlation, error taxonomy, constants. Used by the robot SDK, gateway, and container harness."
 requires-python = ">=3.10"
 dependencies = ["pydantic>=2.0"]

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/__init__.py

@@ -11,6 +11,8 @@ defined once so they cannot drift. Import from here; never redefine.
 Only shared-by-≥2-and-drifts-if-duplicated things live here. Model-specific, provider-specific, and
 catalogue values stay in container / gateway / spec.py.
 """
+
+
 from sequence_base.contract import (
     ActRequest,
     ActResponse,
@@ -96,11 +98,14 @@ from sequence_base.contract import (
     code_for_status,
 )
 
+
 from sequence_base.constants.version import CONTRACT_VERSION
 
+
 from sequence_base.obs.log import Timer, enabled, log
 from sequence_base.obs.rid import HEADER, clean, new_rid
 
+
 from sequence_base.errors.transport import (
     TransportOverloaded,
     TransportRejected,
@@ -108,35 +113,53 @@ from sequence_base.errors.transport import (
     TransportWarming,
 )
 
+
 from sequence_base import auth
 
 
 
+
+
+
 __all__ = [
+
     "ImageFrame", "Proprioception", "Observation", "ActionSpace", "ActionStep", "ActionChunk",
     "ActRequest", "ActResponse",
+
     "SeqFlags", "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
     "ImageStep", "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
     "PolicySpec", "PolicyRegistration",
+
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
+
     "Lease", "ConnectRequest", "ConnectResponse",
+
     "Variant", "Conditions", "RenderSpec", "Step", "BenchmarkSpec", "BenchmarkConditionSpec", "BenchmarkRegisterRequest", "BenchmarkStatusResponse",
     "EvalRequest", "ClampInfo", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
     "EvalStatus", "SuiteAgg", "TaskAgg", "MetricAgg", "LossyTransform", "EvalReport",
     "AdapterKind", "AdapterTransform",
+
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
+
     "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse", "VolumeInfo", "parse_vol",
+
     "TEMPLATE_SCHEME", "parse_template",
+
     "ErrorCode", "ErrorBody", "WarmingError", "ERRORS", "ErrorSpec", "code_for_status", "CONTRACT_VERSION",
+
     "HEADER", "new_rid", "clean", "log", "Timer", "enabled",
+
     "TransportUnavailable", "TransportWarming", "TransportRejected", "TransportOverloaded",
+
     "auth",
 ]
 
 try:
+
+
     from importlib.metadata import PackageNotFoundError, version as _version
 
     __version__ = _version("sequence-base")

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/codec/image.py

@@ -16,8 +16,19 @@ import io
 from typing import Any
 
 
+
+
+
+
+
+
 DEFAULT_JPEG_QUALITY = 95
 
+
+
+
+
+
 MAX_UPLOAD_EDGE = 640
 
 
@@ -48,6 +59,8 @@ def encode(frame: Any, *, quality: int = DEFAULT_JPEG_QUALITY) -> str:
         img = img.convert("RGB")
     if max(img.size) > MAX_UPLOAD_EDGE:
         scale = MAX_UPLOAD_EDGE / max(img.size)
+
+
         img = img.resize((max(1, round(img.width * scale)),
                           max(1, round(img.height * scale))), Image.LANCZOS)
 
@@ -72,6 +85,7 @@ def decode(data: str) -> "Any":
     return np.asarray(Image.open(io.BytesIO(raw)).convert("RGB"), dtype=np.uint8)
 
 
+
 _DEPTH_UNITS = {"m": 1000.0, "mm": 1.0}
 
 
@@ -79,7 +93,8 @@ def encode_depth(depth: Any, *, unit: str = "m") -> str:
     """A depth map -> the base64 16-bit PNG a depth frame (ImageFrame kind="depth") carries: millimetres as uint16, 0
     where there is no reading (NaN, inf, <= 0), clipped at 65.535 m. `unit` is what the array holds: "m" (float metres,
     the default) or "mm". Lossless, unlike the JPEG colour frames take — a depth error is a geometry error.
-    """
+    
+"""
     import numpy as np
     from PIL import Image
 

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/constants/version.py

@@ -1,3 +1,29 @@
 """The shared wire contract's version."""
 
+
+
+
+
 CONTRACT_VERSION = "0.4.25"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/__init__.py

@@ -1,7 +1,8 @@
 """
 The shared wire contract — one definition per shape, imported (never redeclared) by the SDK, gateway,
-and container harness. Grouped by the contract number in docs/platform/contracts.md.
+and container harness. Grouped by contract number.
 """
+
 from sequence_base.contract.act import (
     ActionChunk,
     ActionSpace,
@@ -11,8 +12,10 @@ from sequence_base.contract.act import (
     Proprioception,
 )
 
+
 from sequence_base.contract.wire import ActRequest, ActResponse
 
+
 from sequence_base.contract.flags import SeqFlags
 from sequence_base.contract.policy import (
     Camera,
@@ -34,6 +37,7 @@ from sequence_base.contract.policy import (
     VolumeRef,
 )
 
+
 from sequence_base.contract.deployments import (
     MAX_CODE_BUNDLE_BYTES,
     Autoscaler,
@@ -49,8 +53,10 @@ from sequence_base.contract.deployments import (
     VolumeAttach,
 )
 
+
 from sequence_base.contract.connect import ConnectRequest, ConnectResponse, Lease
 
+
 from sequence_base.contract.benchmarks import (
     BenchmarkConditionSpec,
     BenchmarkRegisterRequest,
@@ -78,6 +84,7 @@ from sequence_base.contract.eval import (
     TaskAgg,
 )
 
+
 from sequence_base.contract.accounts import (
     BootstrapResponse,
     SecretCreateRequest,
@@ -86,8 +93,10 @@ from sequence_base.contract.accounts import (
     UsageReport,
 )
 
+
 from sequence_base.contract.templates import TEMPLATE_SCHEME, parse_template
 
+
 from sequence_base.contract.volumes import (
     MAX_FILES,
     MAX_UPLOAD_BYTES,
@@ -100,27 +109,37 @@ from sequence_base.contract.volumes import (
     parse_vol,
 )
 
+
 from sequence_base.contract.errors import ERRORS, ErrorBody, ErrorCode, ErrorSpec, WarmingError, code_for_status
 
 __all__ = [
+
     "ImageFrame", "Proprioception", "Observation", "ActionSpace", "ActionStep", "ActionChunk",
     "ActRequest", "ActResponse",
+
     "SeqFlags",
     "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal", "ImageStep",
     "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
     "PolicySpec", "PolicyRegistration",
+
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
+
     "Lease", "ConnectRequest", "ConnectResponse",
+
     "Variant", "Conditions", "RenderSpec", "Step", "BenchmarkSpec", "BenchmarkConditionSpec", "BenchmarkRegisterRequest", "BenchmarkStatusResponse",
     "EvalRequest", "ClampInfo", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
     "EvalStatus", "SuiteAgg", "TaskAgg", "MetricAgg", "LossyTransform", "EvalReport",
     "AdapterKind", "AdapterTransform",
+
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
+
     "MAX_FILES", "MAX_UPLOAD_BYTES", "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse",
     "VolumeInfo", "check_volume_name", "parse_vol",
+
     "TEMPLATE_SCHEME", "parse_template",
+
     "ErrorCode", "ErrorBody", "WarmingError", "ERRORS", "ErrorSpec", "code_for_status",
 ]

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/accounts.py

@@ -1,5 +1,5 @@
 """
-Contract 6 — accounts / secret / billing wire types (full picture in docs/platform/accounts.md).
+Contract 6 — accounts / secret / billing wire types.
 
 Secret-leak rule, mechanically checkable (goal 15). Two kinds of secret:
   (a) platform-minted — `direct_secret`, TLS private key. May appear in the DOWN direction only:
@@ -40,6 +40,8 @@ class SecretCreateRequest(BaseModel):
     """POST /v1/secrets — one name = one group of env values (e.g. planner = {PLANNER_API_KEY}).
     `env` carries plaintext values; this is the WRITE-direction allow-list field (goal 15)."""
 
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     name: str
@@ -49,6 +51,10 @@ class SecretCreateRequest(BaseModel):
 class SecretInfo(BaseModel):
     """GET /v1/secrets element — metadata only, NO values. Exposes `env_keys`, not `env`."""
 
+
+
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     name: str
@@ -61,12 +67,15 @@ class BootstrapResponse(BaseModel):
     """What a worker receives when it starts — everything it needs to serve direct TLS `/act`. `direct_secret` + `tls_key` are DOWN-direction platform secrets; `env` is the
     WRITE-direction injection of the policy's declared user secrets into its subprocess (goal 15)."""
 
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     direct_secret: str = Field(..., description="Platform-minted bearer the worker's guard checks")
     tls_key: str = Field(..., description="Self-signed TLS private key (down-direction platform secret)")
     tls_cert: str = Field(..., description="Self-signed TLS certificate (public)")
     env: dict[str, str] = Field(..., description="Policy's user secrets, expanded ENV_KEY → value")
+
     weights_uri: str | None = None
     lease: Lease
 

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/benchmarks.py

@@ -60,6 +60,10 @@ class RenderSpec(BaseModel):
 
     camera: str = Field(..., description="Which camera to pull frames from, e.g. 'wrist' / 'agentview'")
     fps: int = 30
+
+
+
+
     flip: Literal["vertical", "horizontal", "both"] | None = Field(
         None, description="'vertical': rows reversed (upside down); 'horizontal': mirrored; 'both': turned 180°; "
                           "None: as drawn")
@@ -99,16 +103,20 @@ class BenchmarkSpec(BaseModel):
     handler_ref: str
     bindings: dict[SeqFlags, str] = Field(..., description="SETUP / RESET / CHECK / SCORE (+ OBSERVE / STEP) → method name")
     gpu: str | list[str] | None = None
+
     envs: int | None = Field(default=None, ge=1, le=65536)
     assets: list[VolumeRef] = Field(default_factory=list)
     render: RenderSpec | None = None
     cpu: int | None = None
     memory_gb: int | None = None
     secrets: list[SecretRef] = Field(default_factory=list)
+
     engine: str | None = Field(default=None, pattern=KIND_NAME)
 
     @model_validator(mode="after")
     def _bindings_only_benchmark_hooks(self) -> "BenchmarkSpec":
+
+
         bad = set(self.bindings) - set(BENCHMARK_BINDABLE)
         if bad:
             names = ", ".join(sorted(f.name or str(f.value) for f in bad))
@@ -152,19 +160,43 @@ class BenchmarkRegisterRequest(BaseModel):
     render: RenderSpec | None = None
     cpu: int | None = None
     memory_gb: int | None = None
+
+
     code: CodeBundle | None = None
+
+
     suite_of: dict[str, str] = Field(default_factory=dict)
+
+
     action_contract: ActionContract | None = None
+
+
     secrets: list[SecretRef] = Field(default_factory=list)
+
+
     score: bool = False
+
+
     condition_list: list[BenchmarkConditionSpec] | None = Field(default=None, max_length=5000)
+
     timeout_s: float | None = Field(default=None, gt=0)
+
     default_adapter_ref: str | None = None
+
+
     gpu: str | None = Field(default=None, max_length=32)
+
     envs: int | None = Field(default=None, ge=1, le=65536)
+
+
+
     params: dict[str, InferParam] | None = Field(default=None, max_length=32)
+
     batched: bool = False
+
     image_context: CodeBundle | None = None
+
+
     engine: str | None = Field(default=None, pattern=KIND_NAME)
 
     @model_validator(mode="after")

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/connect.py

@@ -13,6 +13,7 @@ from datetime import datetime
 
 from pydantic import BaseModel, ConfigDict, Field
 
+
 from sequence_base.contract.errors import WarmingError
 from sequence_base.contract.io import ActionContract, ObservationContract
 
@@ -52,7 +53,9 @@ class ConnectResponse(BaseModel):
     lease: Lease
     warming: bool = Field(default=False, description="True → worker still warming; see warming_eta_s")
     warming_eta_s: int | None = Field(default=None, description="Seconds until warm, when warming")
+
     action: ActionContract | None = None
     observation: ObservationContract | None = None
     embodiment: str | None = None
+
     io: str | None = None

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/deployments.py

@@ -53,10 +53,15 @@ class Resources(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     gpu: list[str]
+
+
+
     cpu: float | None = Field(default=None, ge=0.125, le=64)
     cpu_limit: float | None = Field(default=None, ge=0.125, le=128)
     memory_gb: float | None = Field(default=None, ge=0.125, le=1024)
     memory_limit_gb: float | None = Field(default=None, ge=0.125, le=1024)
+
+
     region: str | None = Field(default=None, max_length=32)
 
     @model_validator(mode="after")
@@ -73,10 +78,16 @@ class Autoscaler(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     min_containers: int = 0
+
+
     max_containers: int | None = None
+
+
     max_gpus: int | None = Field(default=None, ge=1, le=256)
     buffer_containers: int | None = None
     scaledown_window: int = 600
+
+
     on_full: Literal["queue", "reject"] = "queue"
     queue_timeout_s: int = Field(default=120, ge=5, le=3600)
 
@@ -160,9 +171,9 @@ class DeploymentPolicy(BaseModel):
     to nothing and its inputs / outputs pass through the worker untouched.
 
     `secrets` carries the policy's declared secret BUNDLES BY NAME ONLY (list[SecretRef]) — the gateway
-    validates each name exists and belongs to the deployer at submit time (accounts ⑦ / S3 goal 14), and the
+    validates each name exists and belongs to the deployer at submit time, and the
     worker bootstrap fetches the matching env group by name. A secret VALUE never travels here: SecretRef is
-    name-only, so this field cannot carry one (S3 goal 15). Defaults to `[]` so a policy with no secrets is
+    name-only, so this field cannot carry one. Defaults to `[]` so a policy with no secrets is
     unaffected."""
 
     model_config = ConfigDict(extra="forbid")
@@ -172,12 +183,28 @@ class DeploymentPolicy(BaseModel):
     streaming: bool = False
     frames_per_chunk: int | None = None
     secrets: list[SecretRef] = Field(default_factory=list)
+
+
     observation: ObservationContract | None = None
     embodiments: dict[str, Embodiment] | None = None
+
+
+
+
     action_declared: bool | None = None
+
+
     io: str | None = Field(default=None, max_length=4000)
+
+
     family: str | None = Field(default=None, pattern=KIND_NAME)
+
+
     params: dict[str, InferParam] | None = Field(default=None, max_length=32)
+
+
+
+
     models: list[str] | None = Field(default=None, max_length=16)
 
     @model_validator(mode="after")
@@ -185,6 +212,7 @@ class DeploymentPolicy(BaseModel):
         for name in self.params or {}:
             if not name.isidentifier() or name.startswith("_"):
                 raise ValueError(f"inference parameter {name!r} is not a public Python identifier")
+
         for model in self.models or []:
             if not model or model != model.strip() or "/" not in model:
                 raise ValueError(f"policy model {model!r} is not a catalogue id (accounts/sequences/models/<name>)")
@@ -240,15 +268,26 @@ class DeploymentRequest(BaseModel):
 
     name: str
     image: ImageSpec
+
     weights: VolumeMount | None = None
     resources: Resources
     policy: DeploymentPolicy
+
+
     code: CodeBundle | None = None
+
+
     image_context: CodeBundle | None = None
+
+
     volumes: list[VolumeAttach] = Field(default_factory=list)
     autoscaler: Autoscaler = Field(default_factory=Autoscaler)
+
     concurrency: Concurrency = Field(default_factory=Concurrency)
     timeouts: Timeouts | None = None
+
+
+
     weights_name: str | None = None
     extra_weights: dict[str, VolumeMount] | None = None
 
@@ -290,7 +329,9 @@ class DeploymentRequest(BaseModel):
         return self
 
 
+
 _NAME = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,63}")
+
 _WEIGHTS_SCHEMES = ("gs://", "hf://", "s3://", "https://")
 
 
@@ -320,4 +361,5 @@ class DeploymentStatusResponse(BaseModel):
     status: DeploymentState
     model: str
     error: str | None = Field(default=None, description="Build-failure reason; set only when FAILED")
+
     reason: Literal["gpu_out_of_memory", "host_out_of_memory", "crashed"] | None = None

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/errors.py

@@ -7,6 +7,7 @@ the `seq` CLI exit code. The gateway and the worker harness import it; the SDK,
 this package on a robot, carries a generated copy that a test compares against `ErrorCodes.json`.
 That is what makes the same situation surface the same way at every entry point.
 
+
 Distinct from `sequence_base.errors.transport`, which is the internal exception taxonomy the gateway
 and harness raise before a response is built.
 """
@@ -48,6 +49,8 @@ class ErrorSpec(NamedTuple):
     exit_code: int
 
 
+
+
 ERRORS: dict[ErrorCode, ErrorSpec] = {
     ErrorCode.INVALID_REQUEST: ErrorSpec(400, False, "InvalidRequest", 2),
     ErrorCode.PAYLOAD_TOO_LARGE: ErrorSpec(413, False, "InvalidRequest", 2),
@@ -68,6 +71,7 @@ ERRORS: dict[ErrorCode, ErrorSpec] = {
     ErrorCode.DEPENDENCY_MISSING: ErrorSpec(424, False, "InternalError", 1),
 }
 
+
 _CODE_FOR_STATUS: dict[int, ErrorCode] = {
     400: ErrorCode.INVALID_REQUEST, 401: ErrorCode.UNAUTHENTICATED, 402: ErrorCode.INSUFFICIENT_CREDIT,
     403: ErrorCode.FORBIDDEN, 404: ErrorCode.NOT_FOUND, 405: ErrorCode.INVALID_REQUEST,
@@ -103,8 +107,13 @@ class ErrorBody(BaseModel):
     @model_validator(mode="before")
     @classmethod
     def _retryable_from_table(cls, data: Any) -> Any:
+
+
         if not isinstance(data, dict):
             return data
+
+
+
         if "message" in data and "detail" not in data:
             data = {k: v for k, v in data.items() if k != "message"} | {"detail": data["message"]}
         if "eta_s" in data:

{sequence_base-0.3.28 → sequence_base-0.3.29}/sequence_base/contract/eval.py

@@ -49,6 +49,10 @@ class EvalRequest(BaseModel):
     benchmark: str
     suite: str | None = None
     trials: int | None = None
+
+
+
+
     policy_instances: int = Field(default=1, ge=1, le=64)
     policy_gpu: str | None = Field(default=None, max_length=32)
     benchmark_instances: int = Field(default=1, ge=1, le=64)
@@ -56,14 +60,25 @@ class EvalRequest(BaseModel):
     envs: int | None = Field(default=None, ge=1, le=100000)
     vlm_max_concurrency: int | None = None
     adapter: str | None = None
+
+
     compare: str | list[str] | None = Field(default=None, description="Other model ids to compare against")
     sweep: dict[str, list[int | float | bool | str]] | None = Field(default=None, max_length=8)
     dry_run: bool = False
+
     tasks: list[str] | None = Field(default=None, max_length=1000)
+
     max_usd: float | None = Field(default=None, gt=0)
+
     rerun_of: str | None = None
+
+
+
     params: dict[str, int | float | bool | str] | None = Field(default=None, max_length=32)
+
     variants: dict[str, list[str]] | None = Field(default=None, max_length=32)
+
+
     record: Literal["per-task", "all", "none"] | None = None
 
 
@@ -83,8 +98,13 @@ class Estimate(BaseModel):
     wall_clock_s: float
     cost_usd: float
     vlm_calls: int
+
     breakdown: dict[str, float] | None = None
+
     default_timing: bool | None = None
+
+
+
     held_usd: float | None = None
 
 
@@ -97,7 +117,9 @@ class EvalResponse(BaseModel):
     gpus_granted: int
     estimate: Estimate
     clamped_by: ClampInfo | None = None
+
     queue: EvalQueue | None = None
+
     arms: int | None = None
 
 
@@ -156,6 +178,8 @@ class EvalDryRunResponse(BaseModel):
 
     estimate: Estimate
     cards: EvalCards | None = None
+
+
     layout: dict | None = None
     notes: list[str] = Field(default_factory=list)
 
@@ -165,7 +189,7 @@ class RolloutResult(BaseModel):
     never returns a success flag. `metrics` is the episode's closed-out user metrics (passthrough; the
     platform does not know the field names). `video_uri` points at the mp4 the platform tool produced.
 
-    Scope: W0.1 delivers this wire shape only; the runtime that settles per-step `check.done` per-env and
+    Scope: this is the wire shape only; the runtime that settles per-step `check.done` per-env and
     assembles it lives in the container / gateway, not in this pure-types unit."""
 
     model_config = ConfigDict(extra="forbid")
@@ -243,8 +267,11 @@ class ArmReport(BaseModel):
 
     arm: int
     model: str
+
+
     params: dict[str, int | float | bool | str] = Field(default_factory=dict)
     metrics: dict[str, MetricAgg] = Field(default_factory=dict)
+
     intervals: dict[str, list[float]] = Field(default_factory=dict)
     episodes: int = 0
     failed: int = 0
@@ -327,10 +354,14 @@ class EvalReport(BaseModel):
     errors: list[str] = Field(
         default_factory=list, description="Why episodes or the run failed, so an incomplete report says why"
     )
+
+
     arms: list[ArmReport] | None = None
     paired: list[PairedDiff] | None = None
     timing: EvalTiming | None = None
     stop_reason: str | None = None
+
+
     arm_params: list[ArmParams] | None = None