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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.4.24
+Version: 0.4.25
 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.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sequence-base"
-version = "0.4.24"
+version = "0.4.25"
 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.25}/sequence_base/__init__.py

@@ -76,6 +76,7 @@ from sequence_base.contract import (
     Lease,
     MetricAgg,
     Observation,
+    PolicyConstructor,
     PolicyRegistration,
     PolicySpec,
     Proprioception,
@@ -132,7 +133,7 @@ __all__ = [
     "SeqFlags", "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
     "FROZEN_PATH", "TemplateFiles", "ImageStepTemplateFiles", "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.25}/sequence_base/constants/version.py

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

sequence_base-0.4.25/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.25}/sequence_base/contract/__init__.py

@@ -34,6 +34,7 @@ from sequence_base.contract.policy import (
     FROZEN_PATH,
     TemplateFiles,
     ImageStepTemplateFiles,
+    PolicyConstructor,
     PolicyRegistration,
     PolicySpec,
     VolumeMount,
@@ -121,7 +122,7 @@ __all__ = [
     "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
     "TemplateFiles", "ImageStepTemplateFiles", "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.25}/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.25}/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.25}/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
 
@@ -357,10 +357,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 +395,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.25}/sequence_base/schemas/ActRequest.json

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -809,6 +809,18 @@
       "default": null,
       "title": "Envs"
     },
+    "freeze": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Freeze"
+    },
     "gpu": {
       "anyOf": [
         {
@@ -974,5 +986,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/BenchmarkSpec.json

@@ -379,7 +379,7 @@
       ],
       "title": "SeqFlags",
       "type": "integer",
-      "x-contract-version": "0.5.21",
+      "x-contract-version": "0.5.22",
       "x-flag-names": {
         "CHECK": 65536,
         "INFER": 16,
@@ -628,5 +628,5 @@
   ],
   "title": "BenchmarkSpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/BenchmarkStatusResponse.json

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

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/BootstrapResponse.json

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

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Camera.json

@@ -72,5 +72,5 @@
   ],
   "title": "Camera",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/CodeBundle.json

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

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Concurrency.json

@@ -96,5 +96,5 @@
   },
   "title": "Concurrency",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Conditions.json

@@ -55,5 +55,5 @@
   ],
   "title": "Conditions",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ConnectRequest.json

@@ -25,5 +25,5 @@
   ],
   "title": "ConnectRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ConnectResponse.json

@@ -310,5 +310,5 @@
   ],
   "title": "ConnectResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/DeploymentAccepted.json

@@ -18,5 +18,5 @@
   ],
   "title": "DeploymentAccepted",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/DeploymentPolicy.json

@@ -531,5 +531,5 @@
   ],
   "title": "DeploymentPolicy",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/DeploymentRequest.json

@@ -1128,6 +1128,18 @@
       "default": null,
       "title": "Extra Weights"
     },
+    "freeze": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Freeze"
+    },
     "image": {
       "$ref": "#/$defs/ImageSpec"
     },
@@ -1195,5 +1207,5 @@
   ],
   "title": "DeploymentRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/DeploymentStatusResponse.json

@@ -58,5 +58,5 @@
   ],
   "title": "DeploymentStatusResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Embodiment.json

@@ -235,5 +235,5 @@
   ],
   "title": "Embodiment",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ErrorBody.json

@@ -94,5 +94,5 @@
   ],
   "title": "ErrorBody",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ErrorCodes.json

@@ -22,7 +22,7 @@
   ],
   "title": "ErrorCode",
   "type": "string",
-  "x-contract-version": "0.5.21",
+  "x-contract-version": "0.5.22",
   "x-errors": {
     "budget_exhausted": {
       "exit_code": 6,

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Estimate.json

@@ -60,5 +60,5 @@
   ],
   "title": "Estimate",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/EvalDryRunResponse.json

@@ -240,5 +240,5 @@
   ],
   "title": "EvalDryRunResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/EvalReport.json

@@ -432,5 +432,5 @@
   ],
   "title": "EvalReport",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/EvalRequest.json

@@ -318,5 +318,5 @@
   },
   "title": "EvalRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/EvalResponse.json

@@ -153,5 +153,5 @@
   ],
   "title": "EvalResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageFrame.json

@@ -49,5 +49,5 @@
   ],
   "title": "ImageFrame",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageSpec.json

@@ -257,5 +257,5 @@
   },
   "title": "ImageSpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepAddLocal.json

@@ -38,5 +38,5 @@
   ],
   "title": "ImageStepAddLocal",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepApt.json

@@ -14,5 +14,5 @@
   ],
   "title": "ImageStepApt",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepEnv.json

@@ -14,5 +14,5 @@
   ],
   "title": "ImageStepEnv",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepRun.json

@@ -46,5 +46,5 @@
   ],
   "title": "ImageStepRun",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepTemplateFiles.json

@@ -37,5 +37,5 @@
   ],
   "title": "ImageStepTemplateFiles",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ImageStepUvPip.json

@@ -14,5 +14,5 @@
   ],
   "title": "ImageStepUvPip",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/InferParam.json

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

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Lease.json

@@ -24,5 +24,5 @@
   ],
   "title": "Lease",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/MetricAgg.json

@@ -51,5 +51,5 @@
   ],
   "title": "MetricAgg",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Observation.json

@@ -169,5 +169,5 @@
   ],
   "title": "Observation",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ObservationContract.json

@@ -120,5 +120,5 @@
   },
   "title": "ObservationContract",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/PolicyRegistration.json

@@ -553,6 +553,40 @@
       "title": "ObservationContract",
       "type": "object"
     },
+    "PolicyConstructor": {
+      "additionalProperties": false,
+      "description": "How the worker builds a policy class that names its own methods (`@seq.policy(infer=\"get_action\", ...)`): its\nown constructor, or the factory it names (`make`, e.g. LeRobot's `from_pretrained`), called with `args` and\n`kwargs` where `@seq.load` would run - the replica's cold start, the weights on disk. The values are the user's own,\nas JSON carries them, but for two forms the worker fills in first (sequence_base.construct.expand): a config file's\ncontents, `{\"$config\": <its path from the class's file>, \"$set\": {<keys laid over it>}}`, YAML or JSON, and in any\nstring `\"{weights}\"` (the weights directory) or `\"{weights.<part>}\"` (a named part's).",
+      "properties": {
+        "args": {
+          "description": "positional arguments, in order",
+          "items": {},
+          "title": "Args",
+          "type": "array"
+        },
+        "kwargs": {
+          "additionalProperties": true,
+          "description": "keyword arguments",
+          "title": "Kwargs",
+          "type": "object"
+        },
+        "make": {
+          "anyOf": [
+            {
+              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "a classmethod or staticmethod that returns the instance; None: the class",
+          "title": "Make"
+        }
+      },
+      "title": "PolicyConstructor",
+      "type": "object"
+    },
     "PolicySpec": {
       "additionalProperties": false,
       "description": "What `@seq.policy(...)` accrues — a policy's complete infra declaration, losslessly. `action` /\n`observation` / `embodiments` are optional (contract 0.4.14): a policy that declares none defines its I/O in its own\ncode, and the platform passes it through.",
@@ -822,7 +856,7 @@
       ],
       "title": "SeqFlags",
       "type": "integer",
-      "x-contract-version": "0.5.21",
+      "x-contract-version": "0.5.22",
       "x-flag-names": {
         "CHECK": 65536,
         "INFER": 16,
@@ -865,7 +899,7 @@
     }
   },
   "additionalProperties": false,
-  "description": "What the harness loader introspects: the spec, the SeqFlags→method-name bindings, and the\n`handler_ref` it importlib-loads the policy class from. From one of these the loader recovers which\nmethod is which lifecycle entrypoint (load / infer / on_episode / plan …).",
+  "description": "What the harness loader introspects: the spec, the SeqFlags→method-name bindings, and the\n`handler_ref` it importlib-loads the policy class from. From one of these the loader recovers which\nmethod is which lifecycle entrypoint (load / infer / on_episode / plan …).\n\nA class that names its own methods (`constructor` set) is built by its constructor or factory, so it binds no LOAD,\nand its bindings name its own methods: INFER (what answers an act), and as declared OBSERVE (each observation an\nact carries, before INFER is called with none), RESET (an episode's first act) and ON_EPISODE (its end).",
   "properties": {
     "bindings": {
       "additionalProperties": {
@@ -892,6 +926,17 @@
       "title": "Bindings",
       "type": "object"
     },
+    "constructor": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/PolicyConstructor"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
     "handler_ref": {
       "description": "\"module.path:ClassName\" for importlib load",
       "title": "Handler Ref",
@@ -922,5 +967,5 @@
   ],
   "title": "PolicyRegistration",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/PolicySpec.json

@@ -827,5 +827,5 @@
   ],
   "title": "PolicySpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Proprioception.json

@@ -68,5 +68,5 @@
   },
   "title": "Proprioception",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/RenderSpec.json

@@ -36,5 +36,5 @@
   ],
   "title": "RenderSpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/ReplaySpec.json

@@ -52,5 +52,5 @@
   },
   "title": "ReplaySpec",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Resources.json

@@ -86,5 +86,5 @@
   ],
   "title": "Resources",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/RolloutResult.json

@@ -55,5 +55,5 @@
   ],
   "title": "RolloutResult",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/SecretCreateRequest.json

@@ -21,5 +21,5 @@
   ],
   "title": "SecretCreateRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/SecretInfo.json

@@ -40,5 +40,5 @@
   ],
   "title": "SecretInfo",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/SecretRef.json

@@ -12,5 +12,5 @@
   ],
   "title": "SecretRef",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/SeqFlags.json

@@ -17,7 +17,7 @@
   ],
   "title": "SeqFlags",
   "type": "integer",
-  "x-contract-version": "0.5.21",
+  "x-contract-version": "0.5.22",
   "x-flag-names": {
     "CHECK": 65536,
     "INFER": 16,

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Step.json

@@ -82,5 +82,5 @@
   ],
   "title": "Step",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/TaskAgg.json

@@ -22,5 +22,5 @@
   ],
   "title": "TaskAgg",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/TemplateFiles.json

@@ -22,5 +22,5 @@
   ],
   "title": "TemplateFiles",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Timeouts.json

@@ -20,5 +20,5 @@
   ],
   "title": "Timeouts",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/UploadTarget.json

@@ -24,5 +24,5 @@
   ],
   "title": "UploadTarget",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/Variant.json

@@ -20,5 +20,5 @@
   ],
   "title": "Variant",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeFile.json

@@ -25,5 +25,5 @@
   ],
   "title": "VolumeFile",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeInfo.json

@@ -68,5 +68,5 @@
   ],
   "title": "VolumeInfo",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeMount.json

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

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeRef.json

@@ -24,5 +24,5 @@
   ],
   "title": "VolumeRef",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeUploadRequest.json

@@ -56,5 +56,5 @@
   ],
   "title": "VolumeUploadRequest",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/VolumeUploadResponse.json

@@ -65,5 +65,5 @@
   ],
   "title": "VolumeUploadResponse",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }

{sequence_base-0.4.24 → sequence_base-0.4.25}/sequence_base/schemas/WarmingError.json

@@ -86,5 +86,5 @@
   ],
   "title": "WarmingError",
   "type": "object",
-  "x-contract-version": "0.5.21"
+  "x-contract-version": "0.5.22"
 }