sequence-base 0.3.27__tar.gz → 0.3.29__tar.gz

{sequence_base-0.3.27 → sequence_base-0.3.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.3.27
+Version: 0.3.29
 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.10
 Requires-Dist: pydantic>=2.0

sequence_base-0.3.29/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "sequence-base"
+version = "0.3.29"
+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"]
+
+[project.optional-dependencies]
+codec = ["pillow>=10", "numpy>=1.26"]
+test = ["pytest", "jsonschema>=4"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sequence_base"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/sequence_base", "/README.md", "/pyproject.toml"]

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/__init__.py

@@ -11,9 +11,9 @@ defined once so they cannot drift. Import from here; never redefine.
 Only shared-by-≥2-and-drifts-if-duplicated things live here. Model-specific, provider-specific, and
 catalogue values stay in container / gateway / spec.py.
 """
-# contract — the full shared wire contract (obs/action + registry + deployments + connect + eval +
-# accounts + error bodies). One definition per shape; see sequence_base/contract for the grouping.
-from sequence_base.contract import (  # noqa: F401  (re-export surface)
+
+
+from sequence_base.contract import (
     ActRequest,
     ActResponse,
     AddLocal,
@@ -98,14 +98,14 @@ from sequence_base.contract import (  # noqa: F401  (re-export surface)
     code_for_status,
 )
 
-# the single schema-level version stamp (embedded in every exported JSON Schema)
+
 from sequence_base.constants.version import CONTRACT_VERSION
 
-# obs — correlation id + structured logging (all three sides)
+
 from sequence_base.obs.log import Timer, enabled, log
 from sequence_base.obs.rid import HEADER, clean, new_rid
 
-# errors — shared transport status taxonomy (gateway + container)
+
 from sequence_base.errors.transport import (
     TransportOverloaded,
     TransportRejected,
@@ -113,55 +113,55 @@ from sequence_base.errors.transport import (
     TransportWarming,
 )
 
-# auth — Bearer secret helpers (gateway direct-connect / internal; container guard; worker emit)
+
 from sequence_base import auth
 
 
-# NOTE: codec (image encode/decode) is intentionally NOT re-exported here — it needs PIL + numpy
-# (the [codec] extra), and the gateway installs the light core. Import it explicitly where needed:
-#     from sequence_base.codec import encode, decode, ResizeSpec
+
+
+
 
 __all__ = [
-    # contract 4 — /act data plane
+
     "ImageFrame", "Proprioception", "Observation", "ActionSpace", "ActionStep", "ActionChunk",
     "ActRequest", "ActResponse",
-    # contract 1 — flags + policy registry
+
     "SeqFlags", "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
     "ImageStep", "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
     "PolicySpec", "PolicyRegistration",
-    # contract 2 — deployments
+
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
-    # contract 3 — connect / lease
+
     "Lease", "ConnectRequest", "ConnectResponse",
-    # contract 5 — benchmark + eval
+
     "Variant", "Conditions", "RenderSpec", "Step", "BenchmarkSpec", "BenchmarkConditionSpec", "BenchmarkRegisterRequest", "BenchmarkStatusResponse",
     "EvalRequest", "ClampInfo", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
     "EvalStatus", "SuiteAgg", "TaskAgg", "MetricAgg", "LossyTransform", "EvalReport",
     "AdapterKind", "AdapterTransform",
-    # contract 6 — accounts / secret / billing
+
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
-    # contract 7 — volumes (uploaded checkpoints and datasets)
+
     "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse", "VolumeInfo", "parse_vol",
-    # official template weights
+
     "TEMPLATE_SCHEME", "parse_template",
-    # error bodies + version
+
     "ErrorCode", "ErrorBody", "WarmingError", "ERRORS", "ErrorSpec", "code_for_status", "CONTRACT_VERSION",
-    # obs
+
     "HEADER", "new_rid", "clean", "log", "Timer", "enabled",
-    # errors (exception taxonomy)
+
     "TransportUnavailable", "TransportWarming", "TransportRejected", "TransportOverloaded",
-    # auth + telemetry
+
     "auth",
 ]
 
 try:
-    # The installed distribution's own number, so this can never drift from pyproject.toml again (it said 0.3.6
-    # while the package was 0.3.12). A source tree that was never installed reports "dev".
+
+
     from importlib.metadata import PackageNotFoundError, version as _version
 
     __version__ = _version("sequence-base")
-except PackageNotFoundError:  # pragma: no cover - running from an uninstalled checkout
+except PackageNotFoundError:
     __version__ = "dev"

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/codec/image.py

@@ -16,19 +16,19 @@ import io
 from typing import Any
 
 
-# Quality 95, and the number is measured rather than chosen for looking safe. On a real DROID frame
-# with the sampling noise pinned, the encoding moves the resulting action by: q95 0.51% of action
-# amplitude, q90 0.20%, q85 1.86%, q75 2.86% — 85 and below is where the error jumps by an order of
-# magnitude, that is the line. 95 rather than the empirically-best 90 because the effect is not
-# monotonic in quality on a single frame, and tuning to one frame is fitting noise.
-# {sequences-models models/pi05_droid/handler.py "Q95 MAX|DELTA| 0.0048 0.51% ... Q85 1.86%"}
+
+
+
+
+
+
 DEFAULT_JPEG_QUALITY = 95
 
-# The longest edge `encode` uploads. Every policy resizes a frame to its own input size anyway, so pixels above
-# that only cost transport — and past a point they do not cost, they fail: a body over ~2 MB was dropped by a
-# worker queue with no error and no job id, surfacing as a hang. 640 is above every input size in use (pi0.5's
-# 224), so it discards nothing a policy reads. [MEASURED 2026-09-12: capping the long edge at 640 took a
-# three-view observation from 1.98 MB to 0.12 MB]
+
+
+
+
+
 MAX_UPLOAD_EDGE = 640
 
 
@@ -48,7 +48,7 @@ def encode(frame: Any, *, quality: int = DEFAULT_JPEG_QUALITY) -> str:
 
     try:
         from PIL import Image
-    except ImportError as e:  # pragma: no cover - depends on the install
+    except ImportError as e:
         raise ImportError(
             "encoding an array or PIL image needs Pillow: pip install 'sequence-base[codec]'. "
             "Pass an already-encoded base64 str or bytes to avoid it."
@@ -59,8 +59,8 @@ def encode(frame: Any, *, quality: int = DEFAULT_JPEG_QUALITY) -> str:
         img = img.convert("RGB")
     if max(img.size) > MAX_UPLOAD_EDGE:
         scale = MAX_UPLOAD_EDGE / max(img.size)
-        # round() not int(): int() truncates a 640.9 on one axis and 359.9 on the other, drifting the
-        # aspect ratio by up to half a percent for no reason.
+
+
         img = img.resize((max(1, round(img.width * scale)),
                           max(1, round(img.height * scale))), Image.LANCZOS)
 
@@ -85,7 +85,7 @@ def decode(data: str) -> "Any":
     return np.asarray(Image.open(io.BytesIO(raw)).convert("RGB"), dtype=np.uint8)
 
 
-# ── depth frames ─────────────────────────────────────────────────────────────────────────────────────────────────────
+
 _DEPTH_UNITS = {"m": 1000.0, "mm": 1.0}
 
 
@@ -93,8 +93,8 @@ def encode_depth(depth: Any, *, unit: str = "m") -> str:
     """A depth map -> the base64 16-bit PNG a depth frame (ImageFrame kind="depth") carries: millimetres as uint16, 0
     where there is no reading (NaN, inf, <= 0), clipped at 65.535 m. `unit` is what the array holds: "m" (float metres,
     the default) or "mm". Lossless, unlike the JPEG colour frames take — a depth error is a geometry error.
-    {gs-plans/customization/io-contract.md "深度图"} [CONFIDENCE: CONFIRMED 90% — uint16 millimetres is the layout
-    depth cameras and ROS depth images use]"""
+    
+"""
     import numpy as np
     from PIL import Image
 

sequence_base-0.3.29/sequence_base/constants/env.py

@@ -0,0 +1,7 @@
+"""SEQ_* environment variable NAMES — a single source. Values live in ~/.config/sequences/, never here."""
+
+DIRECT_SECRET = "SEQ_DIRECT_SECRET"
+INTERNAL_SECRET = "SEQ_INTERNAL_SECRET"
+GATEWAY_URL = "SEQ_GATEWAY_URL"
+VOLUME_ROOT = "SEQ_VOLUME_ROOT"
+MANIFEST = "SEQ_MANIFEST"

sequence_base-0.3.29/sequence_base/constants/headers.py

@@ -0,0 +1,4 @@
+"""HTTP header names — one source, so sdk / gateway / container never spell them differently."""
+
+REQUEST_ID = "X-Seq-Request-Id"
+AUTH_SCHEME = "Bearer"

sequence_base-0.3.29/sequence_base/constants/version.py

@@ -0,0 +1,29 @@
+"""The shared wire contract's version."""
+
+
+
+
+
+CONTRACT_VERSION = "0.4.25"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/contract/__init__.py

@@ -1,8 +1,8 @@
 """
 The shared wire contract — one definition per shape, imported (never redeclared) by the SDK, gateway,
-and container harness. Grouped by the contract number in docs/platform/contracts.md.
+and container harness. Grouped by contract number.
 """
-# contract 4 — /act data plane (obs/action DATA types)
+
 from sequence_base.contract.act import (
     ActionChunk,
     ActionSpace,
@@ -12,10 +12,10 @@ from sequence_base.contract.act import (
     Proprioception,
 )
 
-# contract 4, version 2 — the opaque /act envelope (inputs in, outputs out)
+
 from sequence_base.contract.wire import ActRequest, ActResponse
 
-# contract 1 — lifecycle flags + policy registry
+
 from sequence_base.contract.flags import SeqFlags
 from sequence_base.contract.policy import (
     Camera,
@@ -37,7 +37,7 @@ from sequence_base.contract.policy import (
     VolumeRef,
 )
 
-# contract 2 — deployments
+
 from sequence_base.contract.deployments import (
     MAX_CODE_BUNDLE_BYTES,
     Autoscaler,
@@ -53,10 +53,10 @@ from sequence_base.contract.deployments import (
     VolumeAttach,
 )
 
-# contract 3 — connect / lease
+
 from sequence_base.contract.connect import ConnectRequest, ConnectResponse, Lease
 
-# contract 5 — benchmark registration + eval run / report / adapter
+
 from sequence_base.contract.benchmarks import (
     BenchmarkConditionSpec,
     BenchmarkRegisterRequest,
@@ -84,7 +84,7 @@ from sequence_base.contract.eval import (
     TaskAgg,
 )
 
-# contract 6 — accounts / secret / billing
+
 from sequence_base.contract.accounts import (
     BootstrapResponse,
     SecretCreateRequest,
@@ -93,10 +93,10 @@ from sequence_base.contract.accounts import (
     UsageReport,
 )
 
-# official template weights — template://<name>[@v<n>]
+
 from sequence_base.contract.templates import TEMPLATE_SCHEME, parse_template
 
-# contract 7 — volumes (uploaded checkpoints and datasets)
+
 from sequence_base.contract.volumes import (
     MAX_FILES,
     MAX_UPLOAD_BYTES,
@@ -109,37 +109,37 @@ from sequence_base.contract.volumes import (
     parse_vol,
 )
 
-# shared error bodies
+
 from sequence_base.contract.errors import ERRORS, ErrorBody, ErrorCode, ErrorSpec, WarmingError, code_for_status
 
 __all__ = [
-    # contract 4
+
     "ImageFrame", "Proprioception", "Observation", "ActionSpace", "ActionStep", "ActionChunk",
     "ActRequest", "ActResponse",
-    # contract 1
+
     "SeqFlags",
     "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal", "ImageStep",
     "ImageSpec",
     "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract", "Embodiment",
     "PolicySpec", "PolicyRegistration",
-    # contract 2
+
     "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
     "Resources", "Autoscaler", "Timeouts", "VolumeAttach", "DeploymentPolicy", "InferParam", "DeploymentRequest",
     "DeploymentAccepted", "DeploymentState", "DeploymentStatusResponse",
-    # contract 3
+
     "Lease", "ConnectRequest", "ConnectResponse",
-    # contract 5
+
     "Variant", "Conditions", "RenderSpec", "Step", "BenchmarkSpec", "BenchmarkConditionSpec", "BenchmarkRegisterRequest", "BenchmarkStatusResponse",
     "EvalRequest", "ClampInfo", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
     "EvalStatus", "SuiteAgg", "TaskAgg", "MetricAgg", "LossyTransform", "EvalReport",
     "AdapterKind", "AdapterTransform",
-    # contract 6
+
     "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse", "UsageReport",
-    # contract 7
+
     "MAX_FILES", "MAX_UPLOAD_BYTES", "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse",
     "VolumeInfo", "check_volume_name", "parse_vol",
-    # official template weights
+
     "TEMPLATE_SCHEME", "parse_template",
-    # errors
+
     "ErrorCode", "ErrorBody", "WarmingError", "ERRORS", "ErrorSpec", "code_for_status",
 ]

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/contract/accounts.py

@@ -1,5 +1,5 @@
 """
-契约 6 — accounts / secret / billing wire types (full picture in docs/platform/accounts.md).
+Contract 6 — accounts / secret / billing wire types.
 
 Secret-leak rule, mechanically checkable (goal 15). Two kinds of secret:
   (a) platform-minted — `direct_secret`, TLS private key. May appear in the DOWN direction only:
@@ -40,8 +40,8 @@ class SecretCreateRequest(BaseModel):
     """POST /v1/secrets — one name = one group of env values (e.g. planner = {PLANNER_API_KEY}).
     `env` carries plaintext values; this is the WRITE-direction allow-list field (goal 15)."""
 
-    # F6: write-direction plaintext carrier — hide_input_in_errors so a malformed body's ValidationError
-    # str() never echoes the raw secret value (symmetric with SecretInfo). RUNTIME config, no schema change.
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     name: str
@@ -51,10 +51,10 @@ class SecretCreateRequest(BaseModel):
 class SecretInfo(BaseModel):
     """GET /v1/secrets element — metadata only, NO values. Exposes `env_keys`, not `env`."""
 
-    # hide_input_in_errors: if a malformed wire response carries a value-bearing extra field, extra="forbid"
-    # raises ValidationError; without this, its str() would echo the raw input (the secret value). Defense in
-    # depth so no caller that forgets to guard model_validate can leak it. RUNTIME config, not a wire shape —
-    # does NOT change the serialized schema, so CONTRACT_VERSION is unaffected.
+
+
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     name: str
@@ -67,15 +67,15 @@ class BootstrapResponse(BaseModel):
     """What a worker receives when it starts — everything it needs to serve direct TLS `/act`. `direct_secret` + `tls_key` are DOWN-direction platform secrets; `env` is the
     WRITE-direction injection of the policy's declared user secrets into its subprocess (goal 15)."""
 
-    # F6: carries down-direction platform secrets + write-direction user env — hide_input_in_errors so a
-    # malformed body's ValidationError never echoes plaintext (symmetric with SecretInfo). RUNTIME config.
+
+
     model_config = ConfigDict(extra="forbid", hide_input_in_errors=True)
 
     direct_secret: str = Field(..., description="Platform-minted bearer the worker's guard checks")
     tls_key: str = Field(..., description="Self-signed TLS private key (down-direction platform secret)")
     tls_cert: str = Field(..., description="Self-signed TLS certificate (public)")
     env: dict[str, str] = Field(..., description="Policy's user secrets, expanded ENV_KEY → value")
-    # None: a policy without a checkpoint — nothing was copied or mounted. {gs-plans/storage T13}
+
     weights_uri: str | None = None
     lease: Lease
 

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/contract/act.py

@@ -5,7 +5,7 @@ They are no longer the platform's wire: since contract 0.4.14 the worker passes
 (`sequence_base.contract.wire`). This module keeps `from sequence_base.contract.act import Observation` resolving to the
 same classes for the gateway, harness and SDK code that still uses the preset.
 """
-from sequence_base.presets.robot_arm import (  # noqa: F401 — re-exports
+from sequence_base.presets.robot_arm import (
     ActionChunk,
     ActionSpace,
     ActionStep,

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/contract/benchmarks.py

@@ -1,5 +1,5 @@
 """
-契约 5 (registration half) — benchmark is a second authorizable artifact, its registration symmetric to
+Contract 5 (registration half) — benchmark is a second authorizable artifact, its registration symmetric to
 a policy's. `BenchmarkSpec` carries the same infra declaration a PolicySpec does, plus a structured
 `Conditions` (the eval matrix), versioned `assets` volumes, an optional `render` (mp4) declaration, and
 SeqFlags→method bindings covering SETUP / RESET / CHECK / SCORE. The eval *run* wire types (RolloutResult,
@@ -60,10 +60,10 @@ class RenderSpec(BaseModel):
 
     camera: str = Field(..., description="Which camera to pull frames from, e.g. 'wrist' / 'agentview'")
     fps: int = 30
-    # How the platform turns each frame before encoding it. Whether a camera's picture is upside down is a property of
-    # the renderer (OpenGL's glReadPixels returns the bottom row first: LIBERO / robosuite), so its author says it once
-    # here instead of everyone who runs an eval passing it. {gs-plans inbox "LIBERO 风格的相机录出来是倒的"}
-    # None (as drawn) is left off the wire, so a recording that is not turned registers on any platform version.
+
+
+
+
     flip: Literal["vertical", "horizontal", "both"] | None = Field(
         None, description="'vertical': rows reversed (upside down); 'horizontal': mirrored; 'both': turned 180°; "
                           "None: as drawn")
@@ -103,20 +103,20 @@ class BenchmarkSpec(BaseModel):
     handler_ref: str
     bindings: dict[SeqFlags, str] = Field(..., description="SETUP / RESET / CHECK / SCORE (+ OBSERVE / STEP) → method name")
     gpu: str | list[str] | None = None
-    # How many environments one benchmark instance runs at once when an eval does not say (the author's default).
+
     envs: int | None = Field(default=None, ge=1, le=65536)
     assets: list[VolumeRef] = Field(default_factory=list)
     render: RenderSpec | None = None
     cpu: int | None = None
     memory_gb: int | None = None
     secrets: list[SecretRef] = Field(default_factory=list)
-    # The physics engine its simulation runs on (mujoco, sapien, isaac, genesis, pybullet): its icon in the console.
+
     engine: str | None = Field(default=None, pattern=KIND_NAME)
 
     @model_validator(mode="after")
     def _bindings_only_benchmark_hooks(self) -> "BenchmarkSpec":
-        # eval-raw: only SETUP / RESET / CHECK / SCORE are bindable. ROLLOUT is deprecated (never bound) and
-        # a policy-lifecycle flag has no place here — either is a malformed registration, caught at build.
+
+
         bad = set(self.bindings) - set(BENCHMARK_BINDABLE)
         if bad:
             names = ", ".join(sorted(f.name or str(f.value) for f in bad))
@@ -132,7 +132,7 @@ class BenchmarkSpec(BaseModel):
 
 class BenchmarkConditionSpec(BaseModel):
     """One episode setting exactly as the author declared it — a sparse list or a cross product, with its own step
-    cap, wall-clock limit and suite. {gs-plans/customization/benchmark.md "6. 其它在 SDK 里收下、在生产里丢掉的声明"}"""
+    cap, wall-clock limit and suite."""
 
     model_config = ConfigDict(extra="forbid")
 
@@ -160,43 +160,43 @@ class BenchmarkRegisterRequest(BaseModel):
     render: RenderSpec | None = None
     cpu: int | None = None
     memory_gb: int | None = None
-    # The benchmark's own source (reset/check hooks, its adapters), shipped like a policy's — the eval worker
-    # imports handler_ref and any adapter ref from it. None only when the image installs the module itself.
+
+
     code: CodeBundle | None = None
-    # Which suite each task belongs to (task -> suite), so reports aggregate per suite without the platform
-    # guessing from task names. A task not listed here has no suite.
+
+
     suite_of: dict[str, str] = Field(default_factory=dict)
-    # The action contract the benchmark's sim consumes; eval compares it with the policy's and requires an
-    # adapter when they differ.
+
+
     action_contract: ActionContract | None = None
-    # Credentials the sim's own code needs (a dataset token), by name only — injected into the build check and
-    # every eval shard, never into the policy. {gs-plans/customization/benchmark.md "A.1 SECRETS"}
+
+
     secrets: list[SecretRef] = Field(default_factory=list)
-    # Whether the benchmark defines @seq.score — the platform then calls it per group (overall, each suite, each
-    # task) after every episode has run, and its keys override those groups' means. {benchmark.md "A.2"}
+
+
     score: bool = False
-    # Every condition as declared (a sparse list stays sparse; each keeps its own max_steps / timeout_s / suite),
-    # where `conditions` can only say tasks x seeds x variants. The eval runs these when present.
+
+
     condition_list: list[BenchmarkConditionSpec] | None = Field(default=None, max_length=5000)
-    # An episode's wall-clock limit (seconds) when a condition sets none; past it the episode ends truncated.
+
     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
-    # The card each benchmark instance runs on (L4 or RTX-PRO-6000); None takes the platform's default (L4). The
-    # simulation never runs on a CPU. {gs-plans/benchmark-internals/design.md "一、规则"}
+
+
     gpu: str | None = Field(default=None, max_length=32)
-    # How many environments one instance runs at once when an eval does not say; None takes 1.
+
     envs: int | None = Field(default=None, ge=1, le=65536)
-    # The parameters its @seq.setup declares — `def setup(self, envs, *, noise_std: float = 0.02)` — each with its type
-    # and default, which an eval may set (--param benchmark.noise_std=0); None: it declares none, or an SDK from before
-    # them. {gs-plans/eval-adapters/36}
+
+
+
     params: dict[str, InferParam] | None = Field(default=None, max_length=32)
-    # Whether the benchmark is batched (binds OBSERVE and STEP and steps many environments in one call).
+
     batched: bool = False
-    # The Dockerfile's build context, as for a deployment.
+
     image_context: CodeBundle | None = None
-    # The physics engine the benchmark declares (`@seq.benchmark(engine="mujoco")`): its icon in the console. None:
-    # undeclared, or an SDK from before it.
+
+
     engine: str | None = Field(default=None, pattern=KIND_NAME)
 
     @model_validator(mode="after")

{sequence_base-0.3.27 → sequence_base-0.3.29}/sequence_base/contract/connect.py

@@ -1,9 +1,9 @@
 """
-契约 3 — connect / lease (client → gateway; control plane, first call + renewal).
+Contract 3 — connect / lease (client → gateway; control plane, first call + renewal).
 
 Control plane / data plane split: `connect(model)` goes through the gateway once (admission → acquire →
 ensure worker up) and hands back the *direct* coordinates the client then uses to hit the worker's
-`/act` without the gateway in the hot path (契约 4). The cold-start fallback is a defined wire body,
+`/act` without the gateway in the hot path (contract 4). The cold-start fallback is a defined wire body,
 not an HTTP header alone — a 503 returns `WarmingError` (contract/errors.py), so `503 + Retry-After`
 and the warming ETA are typed and checkable.
 """
@@ -13,7 +13,7 @@ from datetime import datetime
 
 from pydantic import BaseModel, ConfigDict, Field
 
-# The 503 cold/warming body is defined once in contract.errors and reused here — no second shape.
+
 from sequence_base.contract.errors import WarmingError
 from sequence_base.contract.io import ActionContract, ObservationContract
 
@@ -43,7 +43,7 @@ class ConnectResponse(BaseModel):
     """200 — the full set of coordinates for a direct worker connection.
 
     `direct_secret` is a plaintext platform-minted bearer for the worker's `/act`; it is on the
-    allow-list of fields permitted to carry a secret value in the down direction (契约 6 / goal 15)."""
+    allow-list of fields permitted to carry a secret value in the down direction (contract 6 / goal 15)."""
 
     model_config = ConfigDict(extra="forbid")
 
@@ -53,9 +53,9 @@ class ConnectResponse(BaseModel):
     lease: Lease
     warming: bool = Field(default=False, description="True → worker still warming; see warming_eta_s")
     warming_eta_s: int | None = Field(default=None, description="Seconds until warm, when warming")
-    # The contracts this session is held to, so the client can check and assemble before the first act.
+
     action: ActionContract | None = None
     observation: ObservationContract | None = None
     embodiment: str | None = None
-    # The deployment's own description of its inputs and outputs (DeploymentPolicy.io), when the author wrote one.
+
     io: str | None = None