sequence-base 0.3.8__tar.gz → 0.3.10__tar.gz

{sequence_base-0.3.8 → sequence_base-0.3.10}/PKG-INFO

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

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

@@ -6,7 +6,9 @@ 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.7"  # 0.4.6 -> 0.4.7: ActionContract.bounds / max_delta / on_violation (action limits)
+CONTRACT_VERSION = "0.4.9"  # 0.4.8 -> 0.4.9: weights may be s3:// or https://
+# previous: 0.4.8  # 0.4.7 -> 0.4.8: ImageSpec.python, ImageStepRun.secrets, Resources.region, DeploymentRequest/BenchmarkRegisterRequest.image_context
+# previous: 0.4.7  # 0.4.6 -> 0.4.7: ActionContract.bounds / max_delta / on_violation (action limits)
 # previous: 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)

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/contract/benchmarks.py

@@ -168,6 +168,8 @@ class BenchmarkRegisterRequest(BaseModel):
     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)
+    # The Dockerfile's build context, as for a deployment.
+    image_context: CodeBundle | None = None
 
 
 class BenchmarkStatusResponse(BaseModel):

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/contract/deployments.py

@@ -53,6 +53,9 @@ class Resources(BaseModel):
     gpu: list[str]
     cpu: int
     memory_gb: int
+    # Where the workers run (near the robots): one of the regions the platform offers. None: the platform picks.
+    # {gs-plans/customization/policy.md "区域"}
+    region: str | None = Field(default=None, max_length=32)
 
 
 class Autoscaler(BaseModel):
@@ -190,6 +193,9 @@ class DeploymentRequest(BaseModel):
     # The handler's source. None only when `handler_ref` is importable from the image itself (a package the
     # ImageSpec installs); otherwise the worker has nothing to import and the build fails.
     code: CodeBundle | None = None
+    # The Dockerfile's build context (the directory its COPY / ADD read), shipped like the code. Only with
+    # image.dockerfile. {gs-plans/customization/policy.md "DOCKERFILE 的 BUILD CONTEXT"}
+    image_context: CodeBundle | None = None
     # Non-weights volumes the policy declares (goal 7). List, not dict, so a mount is never duplicated as
     # both key and value; the gateway only stores the dump, no consumer needs dict lookup.
     volumes: list[VolumeAttach] = Field(default_factory=list)
@@ -214,22 +220,23 @@ class DeploymentRequest(BaseModel):
 
     @model_validator(mode="after")
     def _weights_have_an_origin(self) -> "DeploymentRequest":
-        """The checkpoint the build provisions: a gs:// prefix, an hf:// repo or an uploaded vol:// volume, never
+        """The checkpoint the build provisions: a gs:// or s3:// prefix, an https:// file, an hf:// repo or an uploaded
+        vol:// volume, never
         empty. PolicySpec already enforces this for SDK-authored deploys; this holds it for any POSTed body."""
         uri = self.weights.uri.strip()
         if uri.startswith(VOL_SCHEME):
             parse_vol(uri)
             return self
         if not any(uri.startswith(s) and len(uri) > len(s) for s in _WEIGHTS_SCHEMES):
-            raise ValueError("weights.uri must be a gs://bucket/prefix, an hf://org/model repo or a "
-                             "vol://<name> volume")
+            raise ValueError("weights.uri must be a gs://bucket/prefix, an s3://bucket/prefix, an https:// URL, an "
+                             "hf://org/model repo or a vol://<name> volume")
         return self
 
 
 # A deployment name: what `connect(model=...)` and the console address. {DeploymentRequest._name_is_a_slug}
 _NAME = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,63}")
 # The origins the build knows how to provision weights from.
-_WEIGHTS_SCHEMES = ("gs://", "hf://")
+_WEIGHTS_SCHEMES = ("gs://", "hf://", "s3://", "https://")
 
 
 class DeploymentAccepted(BaseModel):

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/contract/policy.py

@@ -62,6 +62,9 @@ class ImageStepEnv(BaseModel):
 class ImageStepRun(BaseModel):
     model_config = ConfigDict(extra="forbid")
     run_commands: list[str]
+    # Credentials only these commands see while the image builds (a private git or package index), by name; they
+    # are not left in any image layer. {gs-plans/customization/policy.md "私有依赖 … BUILD SECRETS"}
+    secrets: list[SecretRef] | None = None
 
 
 ImageStep = ImageStepUvPip | ImageStepApt | ImageStepEnv | ImageStepRun
@@ -79,6 +82,9 @@ class ImageSpec(BaseModel):
     base: str | None = None
     dockerfile: str | None = None
     steps: list[ImageStep] = Field(default_factory=list)
+    # The Python the image runs: "3.11" … "3.13" (the worker runs on 3.11 or later), or "image" to use the one the
+    # base image already has. None: the platform's default (3.11). {gs-plans/customization/policy.md "PYTHON 版本"}
+    python: str | None = Field(default=None, pattern=r"^(3\.(11|12|13)|image)$")
 
     @model_validator(mode="after")
     def _base_xor_dockerfile(self) -> "ImageSpec":
@@ -153,8 +159,10 @@ class PolicySpec(BaseModel):
             from sequence_base.contract.volumes import parse_vol
             parse_vol(v)
             return v
-        if not (v.startswith("gs://") or v.startswith("hf://")):
-            raise ValueError("weights must be a gs://, hf:// or vol:// URI")
+        # s3:// (the author's own bucket, or any S3-compatible store) and https:// (one file or archive at a URL):
+        # {gs-plans/customization/README.md P2 "S3:// / HTTPS:// 权重"}
+        if not v.startswith(("gs://", "hf://", "s3://", "https://")):
+            raise ValueError("weights must be a gs://, s3://, https://, hf:// or vol:// URI")
         return v
 
 

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ActionChunk.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ActionContract.json

@@ -99,5 +99,5 @@
   ],
   "title": "ActionContract",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ActionStep.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/AdapterTransform.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Autoscaler.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/BenchmarkConditionSpec.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/BenchmarkRegisterRequest.json

@@ -252,6 +252,19 @@
           "default": null,
           "title": "Dockerfile"
         },
+        "python": {
+          "anyOf": [
+            {
+              "pattern": "^(3\\.(11|12|13)|image)$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Python"
+        },
         "steps": {
           "items": {
             "anyOf": [
@@ -319,6 +332,21 @@
           },
           "title": "Run Commands",
           "type": "array"
+        },
+        "secrets": {
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/$defs/SecretRef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Secrets"
         }
       },
       "required": [
@@ -526,6 +554,17 @@
     "image": {
       "$ref": "#/$defs/ImageSpec"
     },
+    "image_context": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/CodeBundle"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
     "max_steps": {
       "title": "Max Steps",
       "type": "integer"
@@ -599,5 +638,5 @@
   ],
   "title": "BenchmarkRegisterRequest",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/BenchmarkSpec.json

@@ -61,6 +61,19 @@
           "default": null,
           "title": "Dockerfile"
         },
+        "python": {
+          "anyOf": [
+            {
+              "pattern": "^(3\\.(11|12|13)|image)$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Python"
+        },
         "steps": {
           "items": {
             "anyOf": [
@@ -128,6 +141,21 @@
           },
           "title": "Run Commands",
           "type": "array"
+        },
+        "secrets": {
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/$defs/SecretRef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Secrets"
         }
       },
       "required": [
@@ -207,7 +235,7 @@
       ],
       "title": "SeqFlags",
       "type": "integer",
-      "x-contract-version": "0.4.7",
+      "x-contract-version": "0.4.9",
       "x-flag-names": {
         "CHECK": 65536,
         "INFER": 16,
@@ -397,5 +425,5 @@
   ],
   "title": "BenchmarkSpec",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/BenchmarkStatusResponse.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/BootstrapResponse.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Camera.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ClampInfo.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/CodeBundle.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Concurrency.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Conditions.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ConnectRequest.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ConnectResponse.json

@@ -281,5 +281,5 @@
   ],
   "title": "ConnectResponse",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/DeploymentAccepted.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/DeploymentPolicy.json

@@ -353,5 +353,5 @@
   ],
   "title": "DeploymentPolicy",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/DeploymentRequest.json

@@ -367,6 +367,19 @@
           "default": null,
           "title": "Dockerfile"
         },
+        "python": {
+          "anyOf": [
+            {
+              "pattern": "^(3\\.(11|12|13)|image)$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Python"
+        },
         "steps": {
           "items": {
             "anyOf": [
@@ -434,6 +447,21 @@
           },
           "title": "Run Commands",
           "type": "array"
+        },
+        "secrets": {
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/$defs/SecretRef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Secrets"
         }
       },
       "required": [
@@ -565,6 +593,19 @@
         "memory_gb": {
           "title": "Memory Gb",
           "type": "integer"
+        },
+        "region": {
+          "anyOf": [
+            {
+              "maxLength": 32,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Region"
         }
       },
       "required": [
@@ -678,6 +719,17 @@
     "image": {
       "$ref": "#/$defs/ImageSpec"
     },
+    "image_context": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/CodeBundle"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
     "name": {
       "title": "Name",
       "type": "string"
@@ -719,5 +771,5 @@
   ],
   "title": "DeploymentRequest",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/DeploymentStatusResponse.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Embodiment.json

@@ -199,5 +199,5 @@
   ],
   "title": "Embodiment",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ErrorBody.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/Estimate.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/EvalDryRunResponse.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/EvalReport.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/EvalRequest.json

@@ -213,5 +213,5 @@
   ],
   "title": "EvalRequest",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/EvalResponse.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ImageFrame.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ImageSpec.json

@@ -43,6 +43,21 @@
           },
           "title": "Run Commands",
           "type": "array"
+        },
+        "secrets": {
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/$defs/SecretRef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Secrets"
         }
       },
       "required": [
@@ -67,6 +82,21 @@
       ],
       "title": "ImageStepUvPip",
       "type": "object"
+    },
+    "SecretRef": {
+      "additionalProperties": false,
+      "description": "A by-name reference to a secret (PolicySpec.secrets / BenchmarkSpec.secrets). Name only — the\nvalue lives in Secret Manager and is injected at worker bootstrap. Never carries a value.",
+      "properties": {
+        "name": {
+          "title": "Name",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "title": "SecretRef",
+      "type": "object"
     }
   },
   "additionalProperties": false,
@@ -96,6 +126,19 @@
       "default": null,
       "title": "Dockerfile"
     },
+    "python": {
+      "anyOf": [
+        {
+          "pattern": "^(3\\.(11|12|13)|image)$",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Python"
+    },
     "steps": {
       "items": {
         "anyOf": [
@@ -119,5 +162,5 @@
   },
   "title": "ImageSpec",
   "type": "object",
-  "x-contract-version": "0.4.7"
+  "x-contract-version": "0.4.9"
 }

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ImageStepApt.json

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

{sequence_base-0.3.8 → sequence_base-0.3.10}/sequence_base/schemas/ImageStepEnv.json

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