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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.4.25
+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

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

@@ -1,6 +1,6 @@
 [project]
 name = "sequence-base"
-version = "0.4.25"
+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"]

{sequence_base-0.4.25 → 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,
@@ -131,7 +133,7 @@ __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", "PolicyConstructor",
 

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

@@ -4,7 +4,7 @@
 
 
 
-CONTRACT_VERSION = "0.5.22"
+CONTRACT_VERSION = "0.5.23"
 
 
 

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

@@ -34,6 +34,8 @@ from sequence_base.contract.policy import (
     FROZEN_PATH,
     TemplateFiles,
     ImageStepTemplateFiles,
+    ImageStepProject,
+    Project,
     PolicyConstructor,
     PolicyRegistration,
     PolicySpec,
@@ -120,7 +122,7 @@ __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", "PolicyConstructor",
 

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

@@ -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):

{sequence_base-0.4.25 → 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.25 → sequence_base-0.4.26}/sequence_base/schemas/ActRequest.json

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{sequence_base-0.4.25 → 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).",
@@ -986,5 +1077,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.5.22"
+  "x-contract-version": "0.5.23"
 }

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

@@ -132,6 +132,9 @@
               },
               {
                 "$ref": "#/$defs/ImageStepTemplateFiles"
+              },
+              {
+                "$ref": "#/$defs/ImageStepProject"
               }
             ]
           },
@@ -189,6 +192,19 @@
       "title": "ImageStepEnv",
       "type": "object"
     },
+    "ImageStepProject": {
+      "additionalProperties": false,
+      "properties": {
+        "project": {
+          "$ref": "#/$defs/Project"
+        }
+      },
+      "required": [
+        "project"
+      ],
+      "title": "ImageStepProject",
+      "type": "object"
+    },
     "ImageStepRun": {
       "additionalProperties": false,
       "properties": {
@@ -251,6 +267,81 @@
       "title": "ImageStepUvPip",
       "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).",
@@ -379,7 +470,7 @@
       ],
       "title": "SeqFlags",
       "type": "integer",
-      "x-contract-version": "0.5.22",
+      "x-contract-version": "0.5.23",
       "x-flag-names": {
         "CHECK": 65536,
         "INFER": 16,
@@ -628,5 +719,5 @@
   ],
   "title": "BenchmarkSpec",
   "type": "object",
-  "x-contract-version": "0.5.22"
+  "x-contract-version": "0.5.23"
 }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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