sequence-base 0.3.2__tar.gz → 0.3.4__tar.gz

{sequence_base-0.3.2 → sequence_base-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.3.2
+Version: 0.3.4
 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.11
 Requires-Dist: pydantic>=2.0

{sequence_base-0.3.2 → sequence_base-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sequence-base"
-version = "0.3.2"
+version = "0.3.4"
 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.11"
 dependencies = ["pydantic>=2.0"]

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/__init__.py

@@ -14,7 +14,16 @@ catalogue values stay in container / gateway / spec.py.
 # contract — the full shared wire contract (obs/action + registry + deployments + connect + eval +
 # accounts + error bodies). One definition per shape; see sequence_base/contract for the grouping.
 from sequence_base.contract import (  # noqa: F401  (re-export surface)
+    Camera,
+    Embodiment,
+    ObservationContract,
     MAX_CODE_BUNDLE_BYTES,
+    UploadTarget,
+    VolumeFile,
+    VolumeInfo,
+    VolumeUploadRequest,
+    VolumeUploadResponse,
+    parse_vol,
     ActionChunk,
     ActionContract,
     ActionSpace,
@@ -108,7 +117,8 @@ __all__ = [
     "ImageFrame", "Proprioception", "Observation", "ActionSpace", "ActionStep", "ActionChunk",
     # contract 1 — flags + policy registry
     "SeqFlags", "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "ImageStep", "ImageSpec",
-    "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "PolicySpec", "PolicyRegistration",
+    "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
+    "PolicySpec", "PolicyRegistration",
     # contract 2 — deployments
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "DeploymentRequest",
@@ -122,6 +132,8 @@ __all__ = [
     "AdapterKind", "AdapterTransform",
     # contract 6 — accounts / secret / billing
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
+    # contract 7 — volumes (uploaded checkpoints and datasets)
+    "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse", "VolumeInfo", "parse_vol",
     # error bodies + version
     "ErrorCode", "ErrorBody", "WarmingError", "CONTRACT_VERSION",
     # obs
@@ -132,4 +144,4 @@ __all__ = [
     "auth", "WorkerLogEvent",
 ]
 
-__version__ = "0.3.2"
+__version__ = "0.3.4"

sequence_base-0.3.4/sequence_base/constants/version.py

@@ -0,0 +1,11 @@
+"""Wire protocol version. Bump on a breaking change to contract / codec / telemetry shapes."""
+
+PROTOCOL_VERSION = "1"
+
+# The single version stamped into every exported JSON Schema (as `x-contract-version`), so a consumer
+# across deployments / repos can tell which version of a shape it is validating against. MUST change
+# whenever any shared wire shape changes (a field added / removed / retyped) — that is what makes
+# contract evolution mechanically detectable instead of eyeballed. Bump on any shape change.
+CONTRACT_VERSION = "0.4.3"  # 0.4.2 -> 0.4.3: I/O contract — ObservationContract/Camera/Embodiment on PolicySpec + DeploymentPolicy, Observation.state, ConnectRequest.embodiment, ConnectResponse.action/observation/embodiment
+# previous: 0.4.2  # 0.4.1 -> 0.4.2: 契约7 volumes (uploads: VolumeFile/VolumeUploadRequest/UploadTarget/VolumeUploadResponse/VolumeInfo), weights accept vol://<name>[@v<n>]; DeploymentRequest name is a slug and weights need an origin
+# previous: 0.4.1  # 0.4.0 -> 0.4.1: 契约2 deploy body completed during S3/G4 — DeploymentPolicy.secrets (name-only passthrough), DeploymentRequest.volumes: list[VolumeAttach{uri,mount,create_if_missing}], concurrency default materialized; telemetry events add load_start stage + emitted_at/rid/dedup_key (O4)

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/contract/__init__.py

@@ -15,6 +15,9 @@ from sequence_base.contract.act import (
 # contract 1 — lifecycle flags + policy registry
 from sequence_base.contract.flags import SeqFlags
 from sequence_base.contract.policy import (
+    Camera,
+    Embodiment,
+    ObservationContract,
     ActionContract,
     Concurrency,
     ImageSpec,
@@ -83,6 +86,19 @@ from sequence_base.contract.accounts import (
     UsageReport,
 )
 
+# contract 7 — volumes (uploaded checkpoints and datasets)
+from sequence_base.contract.volumes import (
+    MAX_FILES,
+    MAX_UPLOAD_BYTES,
+    UploadTarget,
+    VolumeFile,
+    VolumeInfo,
+    VolumeUploadRequest,
+    VolumeUploadResponse,
+    check_volume_name,
+    parse_vol,
+)
+
 # shared error bodies
 from sequence_base.contract.errors import ErrorBody, ErrorCode, WarmingError
 
@@ -92,7 +108,7 @@ __all__ = [
     # contract 1
     "SeqFlags",
     "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "ImageStep", "ImageSpec",
-    "VolumeMount", "VolumeRef", "Concurrency", "ActionContract",
+    "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
     "PolicySpec", "PolicyRegistration",
     # contract 2
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
@@ -107,6 +123,9 @@ __all__ = [
     "AdapterKind", "AdapterTransform",
     # contract 6
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
+    # contract 7
+    "MAX_FILES", "MAX_UPLOAD_BYTES", "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse",
+    "VolumeInfo", "check_volume_name", "parse_vol",
     # errors
     "ErrorCode", "ErrorBody", "WarmingError",
 ]

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/contract/act.py

@@ -50,6 +50,9 @@ class Observation(BaseModel):
     images: list[ImageFrame] = Field(..., min_length=1, max_length=256)
     proprioception: Proprioception
     instruction: str
+    # Named state vectors that are not joints — an end-effector axis-angle, an object pose — so they need not
+    # be smuggled into joint_positions. Absent when the policy declares none. {io-contract.md "Observation.state"}
+    state: dict[str, list[float]] | None = None
 
 
 class ActionSpace(str, Enum):

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/contract/connect.py

@@ -15,6 +15,7 @@ from pydantic import BaseModel, ConfigDict, Field
 
 # The 503 cold/warming body is defined once in contract.errors and reused here — no second shape.
 from sequence_base.contract.errors import WarmingError
+from sequence_base.contract.io import ActionContract, ObservationContract
 
 __all__ = ["Lease", "ConnectRequest", "ConnectResponse", "WarmingError"]
 
@@ -35,6 +36,7 @@ class ConnectRequest(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     model: str = Field(..., description="Deployment name to connect to")
+    embodiment: str | None = Field(default=None, description="Which declared embodiment this session drives")
 
 
 class ConnectResponse(BaseModel):
@@ -51,3 +53,7 @@ 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")
+    # The contracts this session is held to, so the client can check and assemble before the first act.
+    action: ActionContract | None = None
+    observation: ObservationContract | None = None
+    embodiment: str | None = None

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/contract/deployments.py

@@ -21,6 +21,8 @@ from typing import Literal
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
 from sequence_base.contract.accounts import SecretRef
+from sequence_base.contract.volumes import VOL_SCHEME, parse_vol
+from sequence_base.contract.io import Embodiment, ObservationContract
 from sequence_base.contract.policy import (
     ActionContract,
     Concurrency,
@@ -103,6 +105,15 @@ class DeploymentPolicy(BaseModel):
     streaming: bool = False
     frames_per_chunk: int | None = None
     secrets: list[SecretRef] = Field(default_factory=list)
+    # The observation contract the worker checks every /act against (None: undeclared), and per-robot
+    # contracts for a multi-embodiment policy — the worker picks one by the session's embodiment.
+    observation: ObservationContract | None = None
+    embodiments: dict[str, Embodiment] | None = None
+    # Did the author declare `action=` (or embodiments)? `action` is required on the wire, so an SDK that had
+    # nothing declared sends a placeholder; only a declared contract is enforced on the worker and handed to the
+    # robot. None (an older SDK) is treated as undeclared, so an older policy is never refused for the
+    # placeholder it never chose. {io-contract.md "旧 SDK 写的 POLICY 照样能 BUILD"}
+    action_declared: bool | None = None
 
 
 MAX_CODE_BUNDLE_BYTES = 8 * 1024 * 1024
@@ -182,11 +193,15 @@ class DeploymentRequest(BaseModel):
 
     @model_validator(mode="after")
     def _weights_have_an_origin(self) -> "DeploymentRequest":
-        """The checkpoint the build provisions: a gs:// prefix or an hf:// repo, never empty. PolicySpec already
-        enforces this for SDK-authored deploys; this holds it for a body POSTed by anything else."""
+        """The checkpoint the build provisions: a gs:// prefix, an hf:// repo or an uploaded vol:// volume, never
+        empty. PolicySpec already enforces this for SDK-authored deploys; this holds it for any POSTed body."""
         uri = self.weights.uri.strip()
+        if uri.startswith(VOL_SCHEME):
+            parse_vol(uri)
+            return self
         if not any(uri.startswith(s) and len(uri) > len(s) for s in _WEIGHTS_SCHEMES):
-            raise ValueError("weights.uri must be a gs://bucket/prefix or an hf://org/model checkpoint")
+            raise ValueError("weights.uri must be a gs://bucket/prefix, an hf://org/model repo or a "
+                             "vol://<name> volume")
         return self
 
 

sequence_base-0.3.4/sequence_base/contract/io.py

@@ -0,0 +1,83 @@
+"""
+The I/O contract — what a policy reads and what it returns, declared once and checked everywhere.
+
+In one sentence: the author declares `action=` (and `observation=`, or per-robot `embodiments=`) on `@seq.policy`
+→ it rides the deploy body into the worker's manifest → the worker refuses an /act whose observation does not
+match before inference, and a chunk that does not match before it leaves → connect hands the same contracts to
+the robot, which checks and assembles against them. {gs-plans/customization/io-contract.md}
+
+Kept in its own module (not policy.py) because both the policy declaration and the connect response use it, and
+policy → accounts → connect would otherwise import back into policy.
+"""
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+from sequence_base.contract.act import ActionSpace
+
+
+class ActionContract(BaseModel):
+    """The fixed obs→ActionChunk contract a policy promises. Every field required; `action_space` reuses
+    contract 4's enum (not a free string). Each ActionChunk echoes exactly these invariants back."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    robot: str
+    action_space: ActionSpace
+    action_dim: int
+    control_frequency_hz: float
+
+
+# The proprioception fields an observation contract may require, with the wire field each one names.
+PROPRIO_FIELDS = ("joint_positions", "joint_velocities", "end_effector_pose", "gripper")
+
+
+class Camera(BaseModel):
+    """One camera view a policy reads: the size it expects. Informational at the worker (the policy resizes);
+    the client resizes and letterboxes to it before sending, so the bytes on the wire are what is used."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    width: int = Field(..., gt=0, le=8192)
+    height: int = Field(..., gt=0, le=8192)
+
+
+class ObservationContract(BaseModel):
+    """What a policy reads, declared once: the worker checks every /act against it before inference, the
+    client assembles to it. An observation that does not match is refused with what is missing — it is never
+    inferred on. {gs-plans/customization/io-contract.md "二、观测契约"}"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    cameras: dict[str, Camera] = Field(default_factory=dict, description="view name → expected size")
+    history: int = Field(default=1, ge=1, le=64, description="frames per view the policy reads")
+    proprio: dict[str, int] = Field(default_factory=dict,
+                                    description="proprioception field → its length, e.g. joint_positions: 7")
+    state: dict[str, int] = Field(default_factory=dict,
+                                  description="named extra state vector → its length (Observation.state)")
+    instruction: bool = Field(default=True, description="whether a non-empty instruction is required")
+
+    @field_validator("proprio")
+    @classmethod
+    def _known_proprio(cls, v: dict[str, int]) -> dict[str, int]:
+        bad = sorted(set(v) - set(PROPRIO_FIELDS))
+        if bad:
+            raise ValueError(f"proprio keys must be among {PROPRIO_FIELDS}; got {bad} — put other vectors in state=")
+        if any(n < 1 for n in v.values()):
+            raise ValueError("each proprio length must be at least 1")
+        return v
+
+
+class Embodiment(BaseModel):
+    """One robot body a multi-embodiment policy serves: its action contract, its observation contract, and
+    free-form metadata the policy reads (e.g. which normalisation statistics). Chosen per session at connect."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    action: ActionContract
+    observation: ObservationContract | None = None
+    meta: dict[str, Any] = Field(default_factory=dict)
+
+

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/contract/policy.py

@@ -8,10 +8,19 @@ Every shape here forbids unknown fields and pins exact field types — no `Optio
 """
 from __future__ import annotations
 
+from typing import Any
+
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
 from sequence_base.contract.accounts import SecretRef
-from sequence_base.contract.act import ActionSpace
+from sequence_base.contract.act import ActionSpace  # noqa: F401 — re-exported for older imports
+from sequence_base.contract.io import (  # noqa: F401 — the I/O contract lives in io.py, re-exported here
+    PROPRIO_FIELDS,
+    ActionContract,
+    Camera,
+    Embodiment,
+    ObservationContract,
+)
 from sequence_base.contract.flags import SeqFlags
 
 __all__ = [
@@ -112,18 +121,6 @@ class Concurrency(BaseModel):
     target_inputs: int
 
 
-class ActionContract(BaseModel):
-    """The fixed obs→ActionChunk contract a policy promises. Every field required; `action_space` reuses
-    contract 4's enum (not a free string). Each ActionChunk echoes exactly these invariants back."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    robot: str
-    action_space: ActionSpace
-    action_dim: int
-    control_frequency_hz: float
-
-
 class PolicySpec(BaseModel):
     """What `@seq.policy(...)` accrues — a policy's complete infra declaration, losslessly. `action` is
     required (no default): a policy without an obs→ActionChunk contract is not deployable."""
@@ -133,7 +130,7 @@ class PolicySpec(BaseModel):
     name: str
     gpu: str | list[str] = Field(..., description="A GPU type, or a list = cross-provider fallback")
     image: ImageSpec
-    weights: str = Field(..., description="Weights URI; scheme restricted to gs:// or hf://")
+    weights: str = Field(..., description="Weights URI: gs://, hf:// or vol:// (an uploaded volume)")
     volumes: dict[str, VolumeRef] = Field(default_factory=dict)
     secrets: list[SecretRef] = Field(default_factory=list)
     min_containers: int = 0
@@ -144,12 +141,20 @@ class PolicySpec(BaseModel):
     streaming: bool = False
     frames_per_chunk: int | None = None
     action: ActionContract
+    # What the policy reads (None: undeclared — an older SDK); per-robot contracts when one model drives several.
+    observation: ObservationContract | None = None
+    embodiments: dict[str, Embodiment] | None = None
 
     @field_validator("weights")
     @classmethod
     def _weights_scheme(cls, v: str) -> str:
+        # vol:// is a volume the owner uploaded (contract 7); the gateway resolves it per owner at deploy.
+        if v.startswith("vol://"):
+            from sequence_base.contract.volumes import parse_vol
+            parse_vol(v)
+            return v
         if not (v.startswith("gs://") or v.startswith("hf://")):
-            raise ValueError("weights must be a gs:// or hf:// URI")
+            raise ValueError("weights must be a gs://, hf:// or vol:// URI")
         return v
 
 

sequence_base-0.3.4/sequence_base/contract/volumes.py

@@ -0,0 +1,141 @@
+"""
+contract 7 — volumes: a user's named, versioned files on the platform (an uploaded checkpoint, a dataset).
+
+In one sentence: `seq volume put <name> <dir>` lists the local files with their sizes and md5s → POST
+/v1/volumes/{name}/uploads answers one signed, resumable upload target per file → the client sends each file
+straight to its target → POST /v1/volumes/{name}/uploads/{upload_id}/commit checks every object's size and md5
+and makes that version ready (and billed) → a deploy names it `weights="vol://<name>"` (or `@v<n>` to pin).
+
+WHY direct-to-storage targets rather than streaming through the API: a checkpoint is gigabytes, and the API
+host caps a request body at 32 MiB and would carry every byte twice. WHY the md5 list up front: the commit can
+then prove the platform holds exactly the bytes the client had — a truncated or corrupted upload is refused
+instead of becoming the weights a robot runs on.
+{gs-plans/customization/volumes.md "上传流程" + "为什么不直接上传进 MODAL VOLUME"}
+"""
+from __future__ import annotations
+
+import base64
+import binascii
+import re
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
+
+VOL_SCHEME = "vol://"
+# A volume name addresses it everywhere (CLI, `vol://`, console) — the same slug rule as a deployment name.
+_NAME = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,63}")
+_VERSION = re.compile(r"v([1-9][0-9]{0,8})")
+# Bounds on one upload: enough for any single policy checkpoint or a modest dataset, small enough that a
+# runaway client cannot ask for millions of signed targets or reserve unbounded storage in one call.
+MAX_FILES = 10_000
+MAX_UPLOAD_BYTES = 500 * 1024 ** 3
+
+
+def parse_vol(uri: str) -> tuple[str, int | None]:
+    """`vol://<name>[@v<n>]` → (name, n or None). Raises ValueError naming the problem."""
+    if not uri.startswith(VOL_SCHEME):
+        raise ValueError(f"{uri!r} is not a vol:// reference")
+    name, _, ver = uri[len(VOL_SCHEME):].strip().rstrip("/").partition("@")
+    if not _NAME.fullmatch(name):
+        raise ValueError(f"{uri!r}: a volume name is 1-64 letters, digits, '.', '_' or '-', starting with a "
+                         "letter or digit")
+    if not ver:
+        return name, None
+    m = _VERSION.fullmatch(ver)
+    if not m:
+        raise ValueError(f"{uri!r}: pin a version as vol://{name}@v<n>, e.g. @v2")
+    return name, int(m.group(1))
+
+
+def check_volume_name(name: str) -> str:
+    """The slug rule for a volume name, raised as ValueError — for path parameters and model fields alike."""
+    if not _NAME.fullmatch(name or ""):
+        raise ValueError("a volume name is 1-64 letters, digits, '.', '_' or '-', starting with a letter or digit")
+    return name
+
+
+class VolumeFile(BaseModel):
+    """One file of an upload: its path inside the volume, its size, and the base64 md5 of its bytes (the form
+    the storage layer reports back, so the commit compares like with like)."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    path: str = Field(..., min_length=1, max_length=1024)
+    size: int = Field(..., ge=0)
+    md5: str
+
+    @field_validator("path")
+    @classmethod
+    def _relative_and_clean(cls, v: str) -> str:
+        # A path is a key under the volume's own prefix: relative, forward slashes, no empty / . / .. segment —
+        # so no upload can name an object outside its version's prefix.
+        parts = v.split("/")
+        if v.startswith("/") or "\\" in v or any(p in ("", ".", "..") for p in parts):
+            raise ValueError(f"file path {v!r} must be relative, use '/', and have no empty, '.' or '..' part")
+        return v
+
+    @field_validator("md5")
+    @classmethod
+    def _md5_is_16_bytes(cls, v: str) -> str:
+        try:
+            raw = base64.b64decode(v, validate=True)
+        except (binascii.Error, ValueError):
+            raise ValueError("md5 must be the base64 of the 16-byte digest") from None
+        if len(raw) != 16:
+            raise ValueError("md5 must be the base64 of the 16-byte digest")
+        return v
+
+
+class VolumeUploadRequest(BaseModel):
+    """POST /v1/volumes/{name}/uploads — the files of one new version."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    kind: Literal["checkpoint", "dataset"] = "checkpoint"
+    files: list[VolumeFile] = Field(..., min_length=1, max_length=MAX_FILES)
+
+    @model_validator(mode="after")
+    def _unique_and_bounded(self) -> "VolumeUploadRequest":
+        paths = [f.path for f in self.files]
+        if len(set(paths)) != len(paths):
+            raise ValueError("each file path may appear only once")
+        if sum(f.size for f in self.files) > MAX_UPLOAD_BYTES:
+            raise ValueError(f"one upload may hold at most {MAX_UPLOAD_BYTES // 1024 ** 3} GB")
+        return self
+
+
+class UploadTarget(BaseModel):
+    """Where one file goes: POST `url` with `headers` to open a resumable session, then send the bytes to the
+    session address that answer returns. Valid only for this file's object and only until the upload expires."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    path: str
+    url: str
+    headers: dict[str, str] = Field(default_factory=dict)
+
+
+class VolumeUploadResponse(BaseModel):
+    """201 — one target per file; the version becomes ready only at commit."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    upload_id: str
+    name: str
+    version: int = Field(..., ge=1)
+    targets: list[UploadTarget]
+    expires_at: str
+
+
+class VolumeInfo(BaseModel):
+    """One volume as its owner sees it — never where it is stored."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    name: str
+    kind: str
+    state: Literal["uploading", "active", "deleted"]
+    version: int | None = None
+    size_bytes: int = 0
+    created_at: str | None = None
+    updated_at: str | None = None

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schema_export.py

@@ -56,6 +56,13 @@ from sequence_base.contract.deployments import (
     VolumeAttach,
 )
 from sequence_base.contract.errors import ErrorBody, WarmingError
+from sequence_base.contract.volumes import (
+    UploadTarget,
+    VolumeFile,
+    VolumeInfo,
+    VolumeUploadRequest,
+    VolumeUploadResponse,
+)
 from sequence_base.contract.eval import (
     AdapterTransform,
     ClampInfo,
@@ -72,6 +79,9 @@ from sequence_base.contract.eval import (
 )
 from sequence_base.contract.flags import seqflags_json_schema
 from sequence_base.contract.policy import (
+    Camera,
+    Embodiment,
+    ObservationContract,
     ActionContract,
     Concurrency,
     ImageSpec,
@@ -106,6 +116,9 @@ WIRE_MODELS: dict[str, type[BaseModel]] = {
     "VolumeRef": VolumeRef,
     "Concurrency": Concurrency,
     "ActionContract": ActionContract,
+    "Camera": Camera,
+    "ObservationContract": ObservationContract,
+    "Embodiment": Embodiment,
     "PolicySpec": PolicySpec,
     "PolicyRegistration": PolicyRegistration,
     # contract 2 — deployments
@@ -149,6 +162,12 @@ WIRE_MODELS: dict[str, type[BaseModel]] = {
     "SecretInfo": SecretInfo,
     "BootstrapResponse": BootstrapResponse,
     "UsageReport": UsageReport,
+    # contract 7 — volumes
+    "VolumeFile": VolumeFile,
+    "VolumeUploadRequest": VolumeUploadRequest,
+    "UploadTarget": UploadTarget,
+    "VolumeUploadResponse": VolumeUploadResponse,
+    "VolumeInfo": VolumeInfo,
     # shared error bodies
     "ErrorBody": ErrorBody,
     "WarmingError": WarmingError,

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/ActionChunk.json

@@ -98,5 +98,5 @@
   ],
   "title": "ActionChunk",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/ActionContract.json

@@ -39,5 +39,5 @@
   ],
   "title": "ActionContract",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/ActionStep.json

@@ -19,5 +19,5 @@
   ],
   "title": "ActionStep",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/AdapterTransform.json

@@ -38,5 +38,5 @@
   ],
   "title": "AdapterTransform",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/Autoscaler.json

@@ -39,5 +39,5 @@
   },
   "title": "Autoscaler",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/BenchmarkRegisterRequest.json

@@ -393,5 +393,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/BenchmarkSpec.json

@@ -207,7 +207,7 @@
       ],
       "title": "SeqFlags",
       "type": "integer",
-      "x-contract-version": "0.4.1",
+      "x-contract-version": "0.4.3",
       "x-flag-names": {
         "CHECK": 65536,
         "INFER": 16,
@@ -397,5 +397,5 @@
   ],
   "title": "BenchmarkSpec",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/BenchmarkStatusResponse.json

@@ -40,5 +40,5 @@
   ],
   "title": "BenchmarkStatusResponse",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/BootstrapResponse.json

@@ -72,5 +72,5 @@
   ],
   "title": "BootstrapResponse",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }

sequence_base-0.3.4/sequence_base/schemas/Camera.json

@@ -0,0 +1,25 @@
+{
+  "additionalProperties": false,
+  "description": "One camera view a policy reads: the size it expects. Informational at the worker (the policy resizes);\nthe client resizes and letterboxes to it before sending, so the bytes on the wire are what is used.",
+  "properties": {
+    "height": {
+      "exclusiveMinimum": 0,
+      "maximum": 8192,
+      "title": "Height",
+      "type": "integer"
+    },
+    "width": {
+      "exclusiveMinimum": 0,
+      "maximum": 8192,
+      "title": "Width",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "width",
+    "height"
+  ],
+  "title": "Camera",
+  "type": "object",
+  "x-contract-version": "0.4.3"
+}

{sequence_base-0.3.2 → sequence_base-0.3.4}/sequence_base/schemas/ClampInfo.json

@@ -23,5 +23,5 @@
   ],
   "title": "ClampInfo",
   "type": "object",
-  "x-contract-version": "0.4.1"
+  "x-contract-version": "0.4.3"
 }