sequence-base 0.4.24__tar.gz → 0.4.26__tar.gz

{sequence_base-0.4.24 → sequence_base-0.4.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.4.24
+Version: 0.4.26
 Summary: Shared foundation for the Sequences platform — wire contract, correlation, error taxonomy, constants. Used by the robot SDK, gateway, and container harness.
 Project-URL: Changelog, https://generalsequences.com/docs/changelog/
 Requires-Python: >=3.10
@@ -12,3 +12,4 @@ Provides-Extra: test
 Requires-Dist: hypothesis>=6; extra == 'test'
 Requires-Dist: jsonschema>=4; extra == 'test'
 Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pyyaml; extra == 'test'

{sequence_base-0.4.24 → sequence_base-0.4.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sequence-base"
-version = "0.4.24"
+version = "0.4.26"
 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"]
@@ -10,7 +10,7 @@ Changelog = "https://generalsequences.com/docs/changelog/"
 
 [project.optional-dependencies]
 codec = ["pillow>=10", "numpy>=1.26"]
-test = ["pytest", "jsonschema>=4", "hypothesis>=6"]
+test = ["pytest", "jsonschema>=4", "hypothesis>=6", "pyyaml"]
 
 [build-system]
 requires = ["hatchling"]

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/__init__.py

@@ -21,6 +21,8 @@ from sequence_base.contract import (
     FROZEN_PATH,
     TemplateFiles,
     ImageStepTemplateFiles,
+    Project,
+    ImageStepProject,
     Camera,
     Embodiment,
     ObservationContract,
@@ -76,6 +78,7 @@ from sequence_base.contract import (
     Lease,
     MetricAgg,
     Observation,
+    PolicyConstructor,
     PolicyRegistration,
     PolicySpec,
     Proprioception,
@@ -130,9 +133,9 @@ __all__ = [
     "ActRequest", "ActResponse",
 
     "SeqFlags", "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
-    "FROZEN_PATH", "TemplateFiles", "ImageStepTemplateFiles", "ImageStep", "ImageSpec",
+    "FROZEN_PATH", "TemplateFiles", "ImageStepTemplateFiles", "Project", "ImageStepProject", "ImageStep", "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
-    "PolicySpec", "PolicyRegistration",
+    "PolicySpec", "PolicyRegistration", "PolicyConstructor",
 
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "DeploymentPolicy", "InferParam", "DeploymentRequest",

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/constants/version.py

@@ -4,7 +4,8 @@
 
 
 
-CONTRACT_VERSION = "0.5.21"
+CONTRACT_VERSION = "0.5.23"
+
 
 
 

sequence_base-0.4.26/sequence_base/construct.py

@@ -0,0 +1,103 @@
+"""
+How a policy class that names its own methods is built (PolicyRegistration.constructor): its constructor - or the
+factory it names - called with the arguments its decorator was given, once two forms in them are filled in.
+
+In one sentence: a value {"$config": path, "$set": {...}} becomes the YAML or JSON file at `path` - from the folder of
+the class's file - read where the policy runs, with `$set`'s keys laid over its top level → in every string,
+"{weights}" becomes the weights directory and "{weights.<part>}" a named part's → `cls.<make>(*args, **kwargs)`, or
+`cls(*args, **kwargs)` without a factory.
+
+WHY a config file is read where the policy runs: it is part of the project (XPolicyLab's deploy.yml beside its
+model.py) and goes up with it, so one copy - the one the policy runs with - is read, and "{weights}" in it means the
+worker's directory.
+
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+from typing import Any
+
+__all__ = ["CONFIG_KEY", "SET_KEY", "ConstructError", "build", "config", "expand", "is_config", "read_config"]
+
+CONFIG_KEY, SET_KEY = "$config", "$set"
+_WEIGHTS = re.compile(r"\{weights(?:\.([A-Za-z_][A-Za-z0-9_-]*))?\}")
+
+
+class ConstructError(ValueError):
+    """Arguments that cannot be filled in: a config file missing, unreadable or of another kind, or a weights
+    placeholder with no weights - or no such part - to fill it."""
+
+
+def config(path: str, **overrides: Any) -> dict:
+    """A config file's contents with `overrides` laid over its top level, as the worker reads it (`seq.config`)."""
+    if not isinstance(path, str) or not path:
+        raise ConstructError("a config file is a path, from the folder of the class's file")
+    if os.path.isabs(path):
+        raise ConstructError(f"{path}: give a config file's path from the folder of the class's file - the policy runs "
+                             "it where the upload puts it")
+    return {CONFIG_KEY: path, SET_KEY: dict(overrides)}
+
+
+def is_config(value: Any) -> bool:
+    return isinstance(value, dict) and set(value) == {CONFIG_KEY, SET_KEY} and isinstance(value[CONFIG_KEY], str)
+
+
+def read_config(path: str) -> Any:
+    """The YAML (.yml, .yaml) or JSON (.json) file at `path`."""
+    kind = os.path.splitext(path)[1].lower()
+    if kind not in (".json", ".yml", ".yaml"):
+        raise ConstructError(f"{path}: a config file is .json, .yml or .yaml")
+    if not os.path.isfile(path):
+        raise ConstructError(f"{path}: no such config file")
+    with open(path, encoding="utf-8") as f:
+        if kind == ".json":
+            return json.load(f)
+        try:
+            import yaml
+        except ImportError:
+            raise ConstructError(f"{path}: reading YAML needs pyyaml") from None
+        return yaml.safe_load(f)
+
+
+def expand(value: Any, *, base_dir: str, weights: Any) -> Any:
+    """`value` with its config files read (from `base_dir`) and its weights placeholders filled from `weights` - the
+    weights directory, or {part: directory} for named parts, or None for a policy without weights."""
+    if is_config(value):
+        loaded = read_config(os.path.join(base_dir, value[CONFIG_KEY]))
+        if value[SET_KEY] and not isinstance(loaded, dict):
+            raise ConstructError(f"{value[CONFIG_KEY]} holds a {type(loaded).__name__}, which has no keys to set")
+        merged = {**loaded, **value[SET_KEY]} if isinstance(loaded, dict) else loaded
+        return expand(merged, base_dir=base_dir, weights=weights)
+    if isinstance(value, dict):
+        return {k: expand(v, base_dir=base_dir, weights=weights) for k, v in value.items()}
+    if isinstance(value, (list, tuple)):
+        return [expand(v, base_dir=base_dir, weights=weights) for v in value]
+    if isinstance(value, str):
+        return _WEIGHTS.sub(lambda m: _weights_of(m.group(1), weights), value)
+    return value
+
+
+def _weights_of(part: str | None, weights: Any) -> str:
+    if weights is None:
+        raise ConstructError("{weights} names the weights directory, and this policy declares no weights=")
+    if isinstance(weights, dict):
+        if part is None:
+            raise ConstructError(f"its weights come in named parts ({', '.join(sorted(weights))}): name one, "
+                                 f"{{weights.<part>}}")
+        if part not in weights:
+            raise ConstructError(f"{{weights.{part}}}: its weights have no part {part!r} "
+                                 f"({', '.join(sorted(weights))})")
+        return str(weights[part])
+    if part is not None:
+        raise ConstructError(f"{{weights.{part}}} names a part, and its weights come whole: {{weights}}")
+    return str(weights)
+
+
+def build(cls: type, constructor: Any, *, base_dir: str, weights: Any) -> Any:
+    """The instance `constructor` (a PolicyConstructor) makes of `cls`: `cls.<make>(*args, **kwargs)` or `cls(...)`."""
+    args = expand(list(constructor.args), base_dir=base_dir, weights=weights)
+    kwargs = expand(dict(constructor.kwargs), base_dir=base_dir, weights=weights)
+    make = getattr(cls, constructor.make) if constructor.make else cls
+    return make(*args, **kwargs)

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/contract/__init__.py

@@ -34,6 +34,9 @@ from sequence_base.contract.policy import (
     FROZEN_PATH,
     TemplateFiles,
     ImageStepTemplateFiles,
+    ImageStepProject,
+    Project,
+    PolicyConstructor,
     PolicyRegistration,
     PolicySpec,
     VolumeMount,
@@ -119,9 +122,9 @@ __all__ = [
 
     "SeqFlags",
     "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
-    "TemplateFiles", "ImageStepTemplateFiles", "FROZEN_PATH", "ImageStep", "ImageSpec",
+    "TemplateFiles", "ImageStepTemplateFiles", "Project", "ImageStepProject", "FROZEN_PATH", "ImageStep", "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
-    "PolicySpec", "PolicyRegistration",
+    "PolicySpec", "PolicyRegistration", "PolicyConstructor",
 
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "DeploymentPolicy", "InferParam", "DeploymentRequest",

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/contract/benchmarks.py

@@ -210,6 +210,12 @@ class BenchmarkRegisterRequest(BaseModel):
     action_contract: ActionContract | None = None
 
 
+
+
+
+    freeze: bool | None = None
+
+
     secrets: list[SecretRef] = Field(default_factory=list)
 
 

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/contract/deployments.py

@@ -296,6 +296,12 @@ class DeploymentRequest(BaseModel):
     weights_name: str | None = None
     extra_weights: dict[str, VolumeMount] | None = None
 
+
+
+
+
+    freeze: bool | None = None
+
     @field_validator("name")
     @classmethod
     def _name_is_a_slug(cls, v: str) -> str:

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/contract/policy.py

@@ -10,7 +10,7 @@ from __future__ import annotations
 
 import re
 
-from typing import Literal
+from typing import Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
@@ -35,6 +35,8 @@ __all__ = [
     "FROZEN_PATH",
     "TemplateFiles",
     "ImageStepTemplateFiles",
+    "Project",
+    "ImageStepProject",
     "ImageStep",
     "ImageSpec",
     "VolumeMount",
@@ -126,7 +128,101 @@ class ImageStepTemplateFiles(BaseModel):
     template_files: TemplateFiles
 
 
-ImageStep = ImageStepUvPip | ImageStepApt | ImageStepEnv | ImageStepRun | ImageStepAddLocal | ImageStepTemplateFiles
+def _inside_bundle(what: str, v: str) -> str:
+    """A path inside the deploy's code bundle: relative, '/'-separated, never above it."""
+    if v.startswith("/") or "\\" in v or ".." in v.split("/"):
+        raise ValueError(f"project {what} {v!r} must be a relative path inside the code bundle, without '..'")
+    return v
+
+
+
+_DIST_NAME = r"^[A-Za-z0-9]([A-Za-z0-9._-]{0,126}[A-Za-z0-9])?$"
+_DIST_VERSION = r"^[A-Za-z0-9.+!_-]{1,64}$"
+
+
+class Project(BaseModel):
+    """A project's own dependency files, which the image installs from (`seq.Image.from_project`, or a policy that
+    declares no image and whose project has them): each read from the deploy's code bundle. The platform turns them into
+    the install when the image builds - for Linux and the worker's card, whatever machine the author wrote them on: the
+    lock's exact versions, else the declared ones held to the versions the author's machine has (`pins`), the local
+    packages the code imports with their own, less `exclude`, then `extra`.
+    """
+
+    model_config = ConfigDict(extra="forbid")
+
+    root: str = Field("", max_length=512, description="The project's folder inside the code bundle ('' its root)")
+    lock: str | None = Field(None, min_length=1, max_length=512,
+                             description="Its lock file, relative to root: uv.lock, poetry.lock, pdm.lock, Pipfile.lock "
+                                         "or a requirements file whose every line pins a version")
+    declared: list[str] = Field(default_factory=list, max_length=8,
+                                description="Its declared dependency files, relative to root: pyproject.toml, "
+                                            "requirements*.txt, setup.cfg, setup.py")
+    packages: list[str] = Field(default_factory=list, max_length=64,
+                                description="Folders inside the code bundle, each a package of its own (a pyproject.toml "
+                                            "or setup.py) the code imports, installed with its dependencies")
+    pins: dict[str, str] = Field(default_factory=dict, max_length=4096,
+                                 description="The version of each package the author's machine has, which an install "
+                                             "from declared ranges keeps")
+    exclude: list[str] = Field(default_factory=list, max_length=256, description="Packages left out, by name")
+    extra: list[str] = Field(default_factory=list, max_length=64,
+                             description="Requirements added after the project's own: 'name==version', or "
+                                         "'name @ https://…' for a wheel")
+
+    @field_validator("root")
+    @classmethod
+    def _root_inside(cls, v: str) -> str:
+        return _inside_bundle("root", v) if v else v
+
+    @field_validator("lock")
+    @classmethod
+    def _lock_inside(cls, v: str | None) -> str | None:
+        return _inside_bundle("lock", v) if v is not None else v
+
+    @field_validator("declared", "packages")
+    @classmethod
+    def _paths_inside(cls, v: list[str]) -> list[str]:
+        for p in v:
+            if not p or len(p) > 512:
+                raise ValueError("a project file or package path is 1 to 512 characters")
+            _inside_bundle("path", p)
+        return v
+
+    @field_validator("pins")
+    @classmethod
+    def _pins_well_formed(cls, v: dict[str, str]) -> dict[str, str]:
+        import re
+
+        for name, version in v.items():
+            if not re.match(_DIST_NAME, name) or not re.match(_DIST_VERSION, version or ""):
+                raise ValueError(f"project pin {name!r}=={version!r} is not a package name and a version")
+        return v
+
+    @field_validator("exclude")
+    @classmethod
+    def _names(cls, v: list[str]) -> list[str]:
+        import re
+
+        bad = [n for n in v if not re.match(_DIST_NAME, n)]
+        if bad:
+            raise ValueError(f"project exclude takes package names: {bad[:3]}")
+        return v
+
+    @field_validator("extra")
+    @classmethod
+    def _requirements(cls, v: list[str]) -> list[str]:
+        for r in v:
+            if not r.strip() or len(r) > 1024 or "\n" in r:
+                raise ValueError("a project extra is one requirement of 1 to 1024 characters, on one line")
+        return v
+
+
+class ImageStepProject(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    project: Project
+
+
+ImageStep = (ImageStepUvPip | ImageStepApt | ImageStepEnv | ImageStepRun | ImageStepAddLocal | ImageStepTemplateFiles
+             | ImageStepProject)
 
 
 class ImageSpec(BaseModel):
@@ -357,10 +453,31 @@ def check_weights_parts(weights_name: str | None, extra: dict) -> None:
         raise ValueError(f"at most {MAX_WEIGHTS_PARTS} weights parts")
 
 
+class PolicyConstructor(BaseModel):
+    """How the worker builds a policy class that names its own methods (`@seq.policy(infer="get_action", ...)`): its
+    own constructor, or the factory it names (`make`, e.g. LeRobot's `from_pretrained`), called with `args` and
+    `kwargs` where `@seq.load` would run - the replica's cold start, the weights on disk. The values are the user's own,
+    as JSON carries them, but for two forms the worker fills in first (sequence_base.construct.expand): a config file's
+    contents, `{"$config": <its path from the class's file>, "$set": {<keys laid over it>}}`, YAML or JSON, and in any
+    string `"{weights}"` (the weights directory) or `"{weights.<part>}"` (a named part's).
+"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    make: str | None = Field(default=None, pattern=r"^[A-Za-z_][A-Za-z0-9_]*$",
+                             description="a classmethod or staticmethod that returns the instance; None: the class")
+    args: list[Any] = Field(default_factory=list, description="positional arguments, in order")
+    kwargs: dict[str, Any] = Field(default_factory=dict, description="keyword arguments")
+
+
 class PolicyRegistration(BaseModel):
     """What the harness loader introspects: the spec, the SeqFlags→method-name bindings, and the
     `handler_ref` it importlib-loads the policy class from. From one of these the loader recovers which
-    method is which lifecycle entrypoint (load / infer / on_episode / plan …)."""
+    method is which lifecycle entrypoint (load / infer / on_episode / plan …).
+
+    A class that names its own methods (`constructor` set) is built by its constructor or factory, so it binds no LOAD,
+    and its bindings name its own methods: INFER (what answers an act), and as declared OBSERVE (each observation an
+    act carries, before INFER is called with none), RESET (an episode's first act) and ON_EPISODE (its end)."""
 
     model_config = ConfigDict(extra="forbid")
 
@@ -374,3 +491,16 @@ class PolicyRegistration(BaseModel):
     plan_every_s: float | None = Field(
         default=None, gt=0, description="Seconds between @seq.plan calls; set iff a PLAN binding exists"
     )
+
+    constructor: PolicyConstructor | None = None
+
+    @model_validator(mode="after")
+    def _built_by_its_constructor(self) -> "PolicyRegistration":
+        if self.constructor is not None:
+            if SeqFlags.LOAD in self.bindings:
+                raise ValueError("a policy built by its constructor (constructor) has no @seq.load: its constructor is "
+                                 "its load")
+            if SeqFlags.INFER not in self.bindings:
+                raise ValueError("a policy built by its constructor (constructor) names the method that answers an act "
+                                 "(an INFER binding)")
+        return self

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schema_export.py

@@ -90,6 +90,8 @@ from sequence_base.contract.policy import (
     ImageStepAddLocal,
     ImageStepRun,
     ImageStepTemplateFiles,
+    ImageStepProject,
+    Project,
     TemplateFiles,
     ImageStepUvPip,
     PolicyRegistration,
@@ -121,6 +123,8 @@ WIRE_MODELS: dict[str, type[BaseModel]] = {
     "ImageStepAddLocal": ImageStepAddLocal,
     "TemplateFiles": TemplateFiles,
     "ImageStepTemplateFiles": ImageStepTemplateFiles,
+    "Project": Project,
+    "ImageStepProject": ImageStepProject,
     "ImageSpec": ImageSpec,
     "VolumeMount": VolumeMount,
     "VolumeRef": VolumeRef,

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/ActRequest.json

@@ -79,5 +79,5 @@
   ],
   "title": "ActRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/ActResponse.json

@@ -89,5 +89,5 @@
   ],
   "title": "ActResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/ActionChunk.json

@@ -99,5 +99,5 @@
   ],
   "title": "ActionChunk",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/ActionContract.json

@@ -84,5 +84,5 @@
   ],
   "title": "ActionContract",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/ActionStep.json

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

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/AdapterPair.json

@@ -17,5 +17,5 @@
   ],
   "title": "AdapterPair",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/AddLocal.json

@@ -23,5 +23,5 @@
   ],
   "title": "AddLocal",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/Autoscaler.json

@@ -57,5 +57,5 @@
   },
   "title": "Autoscaler",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/BenchmarkConditionSpec.json

@@ -50,5 +50,5 @@
   ],
   "title": "BenchmarkConditionSpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }

{sequence_base-0.4.24 → sequence_base-0.4.26}/sequence_base/schemas/BenchmarkRegisterRequest.json

@@ -296,6 +296,9 @@
               },
               {
                 "$ref": "#/$defs/ImageStepTemplateFiles"
+              },
+              {
+                "$ref": "#/$defs/ImageStepProject"
               }
             ]
           },
@@ -353,6 +356,19 @@
       "title": "ImageStepEnv",
       "type": "object"
     },
+    "ImageStepProject": {
+      "additionalProperties": false,
+      "properties": {
+        "project": {
+          "$ref": "#/$defs/Project"
+        }
+      },
+      "required": [
+        "project"
+      ],
+      "title": "ImageStepProject",
+      "type": "object"
+    },
     "ImageStepRun": {
       "additionalProperties": false,
       "properties": {
@@ -517,6 +533,81 @@
       "title": "InferParam",
       "type": "object"
     },
+    "Project": {
+      "additionalProperties": false,
+      "description": "A project's own dependency files, which the image installs from (`seq.Image.from_project`, or a policy that\ndeclares no image and whose project has them): each read from the deploy's code bundle. The platform turns them into\nthe install when the image builds - for Linux and the worker's card, whatever machine the author wrote them on: the\nlock's exact versions, else the declared ones held to the versions the author's machine has (`pins`), the local\npackages the code imports with their own, less `exclude`, then `extra`.",
+      "properties": {
+        "declared": {
+          "description": "Its declared dependency files, relative to root: pyproject.toml, requirements*.txt, setup.cfg, setup.py",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 8,
+          "title": "Declared",
+          "type": "array"
+        },
+        "exclude": {
+          "description": "Packages left out, by name",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 256,
+          "title": "Exclude",
+          "type": "array"
+        },
+        "extra": {
+          "description": "Requirements added after the project's own: 'name==version', or 'name @ https://…' for a wheel",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 64,
+          "title": "Extra",
+          "type": "array"
+        },
+        "lock": {
+          "anyOf": [
+            {
+              "maxLength": 512,
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Its lock file, relative to root: uv.lock, poetry.lock, pdm.lock, Pipfile.lock or a requirements file whose every line pins a version",
+          "title": "Lock"
+        },
+        "packages": {
+          "description": "Folders inside the code bundle, each a package of its own (a pyproject.toml or setup.py) the code imports, installed with its dependencies",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 64,
+          "title": "Packages",
+          "type": "array"
+        },
+        "pins": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The version of each package the author's machine has, which an install from declared ranges keeps",
+          "maxProperties": 4096,
+          "title": "Pins",
+          "type": "object"
+        },
+        "root": {
+          "default": "",
+          "description": "The project's folder inside the code bundle ('' its root)",
+          "maxLength": 512,
+          "title": "Root",
+          "type": "string"
+        }
+      },
+      "title": "Project",
+      "type": "object"
+    },
     "RenderSpec": {
       "additionalProperties": false,
       "description": "a.k.a. `seq.Record` — declares the mp4 the platform records (money-shot is a platform tool, not user\nglue). `camera` picks which camera stream to pull frames from; `fps` is the output frame rate. Used two\nways: as `BenchmarkSpec.render` (record the whole eval) and as `Step.record` (a per-frame hint).",
@@ -809,6 +900,18 @@
       "default": null,
       "title": "Envs"
     },
+    "freeze": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Freeze"
+    },
     "gpu": {
       "anyOf": [
         {
@@ -974,5 +1077,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.23"
 }