sequence-base 0.3.6__tar.gz → 0.3.7__tar.gz

{sequence_base-0.3.6 → sequence_base-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.3.6
+Version: 0.3.7
 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.6 → sequence_base-0.3.7}/pyproject.toml

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

@@ -44,6 +44,7 @@ from sequence_base.contract import (  # noqa: F401  (re-export surface)
     ConnectResponse,
     DeploymentAccepted,
     DeploymentPolicy,
+    InferParam,
     DeploymentRequest,
     DeploymentState,
     DeploymentStatusResponse,
@@ -122,7 +123,7 @@ __all__ = [
     "PolicySpec", "PolicyRegistration",
     # contract 2 — deployments
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
-    "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "DeploymentRequest",
+    "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
     # contract 3 — connect / lease
     "Lease", "ConnectRequest", "ConnectResponse",

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/constants/version.py

@@ -6,7 +6,8 @@ PROTOCOL_VERSION = "1"
 # 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.5"  # 0.4.4 -> 0.4.5: BenchmarkRegisterRequest.condition_list / timeout_s / default_adapter_ref (+ BenchmarkConditionSpec); EvalRequest.tasks / max_usd / rerun_of
+CONTRACT_VERSION = "0.4.6"  # 0.4.5 -> 0.4.6: InferParam + DeploymentPolicy.params; EvalRequest.params / variants / record; BenchmarkRegisterRequest.gpu
+# previous: 0.4.5  # 0.4.4 -> 0.4.5: BenchmarkRegisterRequest.condition_list / timeout_s / default_adapter_ref (+ BenchmarkConditionSpec); EvalRequest.tasks / max_usd / rerun_of
 # previous: 0.4.4  # 0.4.3 -> 0.4.4: BenchmarkRegisterRequest.secrets (by name) + score (has @seq.score)
 # previous: 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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/contract/__init__.py

@@ -39,6 +39,7 @@ from sequence_base.contract.deployments import (
     CodeBundle,
     DeploymentAccepted,
     DeploymentPolicy,
+    InferParam,
     DeploymentRequest,
     DeploymentState,
     DeploymentStatusResponse,
@@ -113,7 +114,7 @@ __all__ = [
     "PolicySpec", "PolicyRegistration",
     # contract 2
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
-    "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "DeploymentRequest",
+    "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
     # contract 3
     "Lease", "ConnectRequest", "ConnectResponse",

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/contract/benchmarks.py

@@ -166,6 +166,8 @@ class BenchmarkRegisterRequest(BaseModel):
     timeout_s: float | None = Field(default=None, gt=0)
     # The adapter (module:Class in the benchmark's own code) an eval uses when it names none.
     default_adapter_ref: str | None = None
+    # A GPU for each sim sandbox (a renderer or a GPU physics engine): a card name the platform offers. None: CPU.
+    gpu: str | None = Field(default=None, max_length=32)
 
 
 class BenchmarkStatusResponse(BaseModel):

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/contract/deployments.py

@@ -88,6 +88,17 @@ class VolumeAttach(BaseModel):
     create_if_missing: bool
 
 
+class InferParam(BaseModel):
+    """One inference parameter the policy's `@seq.infer` declares — `def infer(self, obs, *, num_steps: int = 10)`
+    — with its type and default. An /act or an eval may set it; the worker passes only declared names, cast to
+    this type, and refuses any other. {gs-plans/customization/policy.md "四、推理行为"}"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    type: Literal["int", "float", "bool", "str"]
+    default: int | float | bool | str | None = None
+
+
 class DeploymentPolicy(BaseModel):
     """The policy block of the deployments body. `handler_ref` and `action` are required; `action` is the
     fixed obs→ActionChunk contract, not a bare dict.
@@ -114,6 +125,16 @@ class DeploymentPolicy(BaseModel):
     # 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
+    # The inference parameters @seq.infer takes beyond the observation (name -> type, default). None: an older
+    # SDK that did not look; {}: the policy declares none.
+    params: dict[str, InferParam] | None = Field(default=None, max_length=32)
+
+    @model_validator(mode="after")
+    def _param_names(self) -> "DeploymentPolicy":
+        for name in self.params or {}:
+            if not name.isidentifier() or name.startswith("_"):
+                raise ValueError(f"inference parameter {name!r} is not a public Python identifier")
+        return self
 
 
 MAX_CODE_BUNDLE_BYTES = 8 * 1024 * 1024

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/contract/eval.py

@@ -10,6 +10,7 @@ not a bare dict or free text.
 from __future__ import annotations
 
 from enum import Enum
+from typing import Literal
 
 from pydantic import BaseModel, ConfigDict, Field, model_validator
 
@@ -53,6 +54,13 @@ class EvalRequest(BaseModel):
     max_usd: float | None = Field(default=None, gt=0)
     # Run again only the episodes of that earlier eval that errored; the report covers both runs.
     rerun_of: str | None = None
+    # Inference parameters the model's @seq.infer declares, set for every /act of this eval.
+    params: dict[str, int | float | bool | str] | None = Field(default=None, max_length=32)
+    # Only the conditions whose variant takes one of these values on each named axis.
+    variants: dict[str, list[str]] | None = Field(default=None, max_length=32)
+    # Which episodes are recorded when the benchmark declares render=: the first seed of each task (default),
+    # every episode, or none.
+    record: Literal["per-task", "all", "none"] | None = None
 
 
 class ClampInfo(BaseModel):

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schema_export.py

@@ -50,6 +50,7 @@ from sequence_base.contract.deployments import (
     CodeBundle,
     DeploymentAccepted,
     DeploymentPolicy,
+    InferParam,
     DeploymentRequest,
     DeploymentStatusResponse,
     Resources,
@@ -129,6 +130,7 @@ WIRE_MODELS: dict[str, type[BaseModel]] = {
     "VolumeAttach": VolumeAttach,
     "CodeBundle": CodeBundle,
     "DeploymentPolicy": DeploymentPolicy,
+    "InferParam": InferParam,
     "DeploymentRequest": DeploymentRequest,
     "DeploymentAccepted": DeploymentAccepted,
     "DeploymentStatusResponse": DeploymentStatusResponse,

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ActionChunk.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ActionContract.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ActionStep.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/AdapterTransform.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Autoscaler.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/BenchmarkConditionSpec.json

@@ -62,5 +62,5 @@
   ],
   "title": "BenchmarkConditionSpec",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/BenchmarkRegisterRequest.json

@@ -446,6 +446,19 @@
       "default": null,
       "title": "Default Adapter Ref"
     },
+    "gpu": {
+      "anyOf": [
+        {
+          "maxLength": 32,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Gpu"
+    },
     "handler_ref": {
       "title": "Handler Ref",
       "type": "string"
@@ -526,5 +539,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/BenchmarkSpec.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/BenchmarkStatusResponse.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/BootstrapResponse.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Camera.json

@@ -21,5 +21,5 @@
   ],
   "title": "Camera",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ClampInfo.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/CodeBundle.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Concurrency.json

@@ -17,5 +17,5 @@
   ],
   "title": "Concurrency",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Conditions.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ConnectRequest.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ConnectResponse.json

@@ -221,5 +221,5 @@
   ],
   "title": "ConnectResponse",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/DeploymentAccepted.json

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

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/DeploymentPolicy.json

@@ -94,6 +94,48 @@
       "title": "Embodiment",
       "type": "object"
     },
+    "InferParam": {
+      "additionalProperties": false,
+      "description": "One inference parameter the policy's `@seq.infer` declares — `def infer(self, obs, *, num_steps: int = 10)`\n— with its type and default. An /act or an eval may set it; the worker passes only declared names, cast to\nthis type, and refuses any other. {gs-plans/customization/policy.md \"四、推理行为\"}",
+      "properties": {
+        "default": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Default"
+        },
+        "type": {
+          "enum": [
+            "int",
+            "float",
+            "bool",
+            "str"
+          ],
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "title": "InferParam",
+      "type": "object"
+    },
     "ObservationContract": {
       "additionalProperties": false,
       "description": "What a policy reads, declared once: the worker checks every /act against it before inference, the\nclient assembles to it. An observation that does not match is refused with what is missing — it is never\ninferred on. {gs-plans/customization/io-contract.md \"二、观测契约\"}",
@@ -216,6 +258,22 @@
       ],
       "default": null
     },
+    "params": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "$ref": "#/$defs/InferParam"
+          },
+          "maxProperties": 32,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Params"
+    },
     "secrets": {
       "items": {
         "$ref": "#/$defs/SecretRef"
@@ -235,5 +293,5 @@
   ],
   "title": "DeploymentPolicy",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/DeploymentRequest.json

@@ -213,6 +213,22 @@
           ],
           "default": null
         },
+        "params": {
+          "anyOf": [
+            {
+              "additionalProperties": {
+                "$ref": "#/$defs/InferParam"
+              },
+              "maxProperties": 32,
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Params"
+        },
         "secrets": {
           "items": {
             "$ref": "#/$defs/SecretRef"
@@ -383,6 +399,48 @@
       "title": "ImageStepUvPip",
       "type": "object"
     },
+    "InferParam": {
+      "additionalProperties": false,
+      "description": "One inference parameter the policy's `@seq.infer` declares — `def infer(self, obs, *, num_steps: int = 10)`\n— with its type and default. An /act or an eval may set it; the worker passes only declared names, cast to\nthis type, and refuses any other. {gs-plans/customization/policy.md \"四、推理行为\"}",
+      "properties": {
+        "default": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Default"
+        },
+        "type": {
+          "enum": [
+            "int",
+            "float",
+            "bool",
+            "str"
+          ],
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "title": "InferParam",
+      "type": "object"
+    },
     "ObservationContract": {
       "additionalProperties": false,
       "description": "What a policy reads, declared once: the worker checks every /act against it before inference, the\nclient assembles to it. An observation that does not match is refused with what is missing — it is never\ninferred on. {gs-plans/customization/io-contract.md \"二、观测契约\"}",
@@ -601,5 +659,5 @@
   ],
   "title": "DeploymentRequest",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/DeploymentStatusResponse.json

@@ -41,5 +41,5 @@
   ],
   "title": "DeploymentStatusResponse",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Embodiment.json

@@ -139,5 +139,5 @@
   ],
   "title": "Embodiment",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ErrorBody.json

@@ -28,5 +28,5 @@
   ],
   "title": "ErrorBody",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/Estimate.json

@@ -21,5 +21,5 @@
   ],
   "title": "Estimate",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/EvalDryRunResponse.json

@@ -37,5 +37,5 @@
   ],
   "title": "EvalDryRunResponse",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/EvalReport.json

@@ -183,5 +183,5 @@
   ],
   "title": "EvalReport",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/EvalRequest.json

@@ -77,6 +77,52 @@
       "title": "Model",
       "type": "string"
     },
+    "params": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "maxProperties": 32,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Params"
+    },
+    "record": {
+      "anyOf": [
+        {
+          "enum": [
+            "per-task",
+            "all",
+            "none"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Record"
+    },
     "rerun_of": {
       "anyOf": [
         {
@@ -129,6 +175,25 @@
       "default": null,
       "title": "Trials"
     },
+    "variants": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "maxProperties": 32,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Variants"
+    },
     "vlm_max_concurrency": {
       "anyOf": [
         {
@@ -148,5 +213,5 @@
   ],
   "title": "EvalRequest",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/EvalResponse.json

@@ -84,5 +84,5 @@
   ],
   "title": "EvalResponse",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ImageFrame.json

@@ -32,5 +32,5 @@
   ],
   "title": "ImageFrame",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ImageSpec.json

@@ -119,5 +119,5 @@
   },
   "title": "ImageSpec",
   "type": "object",
-  "x-contract-version": "0.4.5"
+  "x-contract-version": "0.4.6"
 }

{sequence_base-0.3.6 → sequence_base-0.3.7}/sequence_base/schemas/ImageStepApt.json

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