sequence-base 0.3.26__tar.gz → 0.3.28__tar.gz

{sequence_base-0.3.26 → sequence_base-0.3.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sequence-base
-Version: 0.3.26
+Version: 0.3.28
 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.28/pyproject.toml

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

@@ -11,9 +11,7 @@ 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 +96,11 @@ 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 +108,37 @@ 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.26 → sequence_base-0.3.28}/sequence_base/codec/image.py

@@ -16,19 +16,8 @@ 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 +37,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 +48,6 @@ 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 +72,6 @@ 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 +79,7 @@ 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.28/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.28/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.28/sequence_base/constants/version.py

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

{sequence_base-0.3.26 → sequence_base-0.3.28}/sequence_base/contract/__init__.py

@@ -2,7 +2,6 @@
 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.
 """
-# contract 4 — /act data plane (obs/action DATA types)
 from sequence_base.contract.act import (
     ActionChunk,
     ActionSpace,
@@ -12,10 +11,8 @@ 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 +34,6 @@ from sequence_base.contract.policy import (
     VolumeRef,
 )
 
-# contract 2 — deployments
 from sequence_base.contract.deployments import (
     MAX_CODE_BUNDLE_BYTES,
     Autoscaler,
@@ -53,10 +49,8 @@ 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 +78,6 @@ from sequence_base.contract.eval import (
     TaskAgg,
 )
 
-# contract 6 — accounts / secret / billing
 from sequence_base.contract.accounts import (
     BootstrapResponse,
     SecretCreateRequest,
@@ -93,10 +86,8 @@ 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 +100,27 @@ 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.26 → sequence_base-0.3.28}/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 (full picture in docs/platform/accounts.md).
 
 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,6 @@ 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 +49,6 @@ 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 +61,12 @@ 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.26 → sequence_base-0.3.28}/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.26 → sequence_base-0.3.28}/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,
@@ -19,7 +19,7 @@ from pydantic import BaseModel, ConfigDict, Field, model_validator
 from sequence_base.contract.accounts import SecretRef
 from sequence_base.contract.deployments import CodeBundle, DeploymentState, InferParam
 from sequence_base.contract.flags import BENCHMARK_BATCHED, BENCHMARK_BINDABLE, SeqFlags
-from sequence_base.contract.policy import ActionContract, ImageSpec, VolumeRef
+from sequence_base.contract.policy import KIND_NAME, ActionContract, ImageSpec, VolumeRef
 
 __all__ = [
     "Variant",
@@ -60,10 +60,6 @@ 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,18 +99,16 @@ 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)
+    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))
@@ -130,7 +124,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")
 
@@ -158,41 +152,20 @@ 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
+    engine: str | None = Field(default=None, pattern=KIND_NAME)
 
     @model_validator(mode="after")
     def _param_names(self) -> "BenchmarkRegisterRequest":

{sequence_base-0.3.26 → sequence_base-0.3.28}/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,6 @@ 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 +42,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 +52,7 @@ 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

{sequence_base-0.3.26 → sequence_base-0.3.28}/sequence_base/contract/deployments.py

@@ -1,5 +1,5 @@
 """
-契约 2 — `POST /v1/deployments` (SDK `seq deploy` → gateway) and its responses.
+Contract 2 — `POST /v1/deployments` (SDK `seq deploy` → gateway) and its responses.
 
 The request is the normalized wire form of a PolicySpec: one big body (new config adds a field, never a
 new endpoint) whose sub-shapes reuse contract 1's types
@@ -25,6 +25,7 @@ from sequence_base.contract.templates import TEMPLATE_SCHEME, parse_template
 from sequence_base.contract.volumes import VOL_SCHEME, parse_vol
 from sequence_base.contract.io import Embodiment, ObservationContract
 from sequence_base.contract.policy import (
+    KIND_NAME,
     ActionContract,
     Concurrency,
     ImageSpec,
@@ -52,15 +53,10 @@ class Resources(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     gpu: list[str]
-    # Physical cores and GiB the worker requests, billed per second at the greater of the request and what it uses.
-    # None requests the minimum (0.125 cores, 0.125 GiB) and the worker may use more. A limit caps what it may use;
-    # None leaves it free to burst.
     cpu: float | None = Field(default=None, ge=0.125, le=64)
     cpu_limit: float | None = Field(default=None, ge=0.125, le=128)
     memory_gb: float | None = Field(default=None, ge=0.125, le=1024)
     memory_limit_gb: float | None = Field(default=None, ge=0.125, le=1024)
-    # 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)
 
     @model_validator(mode="after")
@@ -77,16 +73,10 @@ class Autoscaler(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     min_containers: int = 0
-    # Accepted and ignored: limits count GPUs (`max_gpus`). sequence-ai <= 0.28 still sends it and does not pin
-    # sequence-base, so removing it would break their deploys; it goes when no supported SDK sends it.
     max_containers: int | None = None
-    # The most GPUs this deployment may hold at once. None: no cap of its own — only the account's and the platform's
-    # GPU limits bound it. Limits count cards, never machines. {gs-plans/parallel/serving.md "1. 限制按卡数,不按台数"}
     max_gpus: int | None = Field(default=None, ge=1, le=256)
     buffer_containers: int | None = None
     scaledown_window: int = 600
-    # When every slot is taken and no card is left: queue the new robot before its control loop starts, or refuse it at
-    # once; how long a queued robot waits before it is told why. {gs-plans/parallel/serving-queue.md "connect 的处理顺序"}
     on_full: Literal["queue", "reject"] = "queue"
     queue_timeout_s: int = Field(default=120, ge=5, le=3600)
 
@@ -116,11 +106,11 @@ class VolumeAttach(BaseModel):
 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 "四、推理行为"}
+    this type, and refuses any other.
 
     `min` / `max` (a number's bounds, inclusive) and `choices` (the values it may take) — declared as
     `Annotated[int, seq.Range(1, 10)]` / `seq.OneOf(...)` — refuse any other value before inference, saying which are
-    allowed; None (left off the wire) holds it to its type alone. {gs-plans/deploy-serving/35 "允许声明范围或可选值"}"""
+    allowed; None (left off the wire) holds it to its type alone."""
 
     model_config = ConfigDict(extra="forbid")
 
@@ -182,25 +172,12 @@ class DeploymentPolicy(BaseModel):
     streaming: bool = False
     frames_per_chunk: int | None = None
     secrets: list[SecretRef] = Field(default_factory=list)
-    # The observation contract the worker checks every /act against (None: undeclared), and per-robot
-    # contracts for a multi-embodiment policy — the worker picks one by the session's embodiment.
     observation: ObservationContract | None = None
     embodiments: dict[str, Embodiment] | None = None
-    # Did the author declare `action=` (or embodiments)? SDKs before contract 0.4.14 always sent an `action` (a
-    # placeholder when none was declared); only a declared contract is enforced on the worker and handed to the robot.
-    # None (an older SDK) is treated as undeclared, so an older policy is never refused for the placeholder it never
-    # chose. A current SDK sends `action` only when declared. {io-contract.md "旧 SDK 写的 POLICY 照样能 BUILD"}
     action_declared: bool | None = None
-    # The author's own description of what infer() takes and returns; stored, handed to the robot at connect, never
-    # interpreted by the platform.
     io: str | None = Field(default=None, max_length=4000)
-    # The inference parameters @seq.infer takes beyond the observation (name -> type, default). None: an older
-    # SDK that did not look; {}: the policy declares none.
+    family: str | None = Field(default=None, pattern=KIND_NAME)
     params: dict[str, InferParam] | None = Field(default=None, max_length=32)
-    # The platform models the policy calls while it runs (`@seq.policy(models=[...])`), by full catalogue id
-    # (accounts/sequences/models/<name>): the act key that drives this deployment may call exactly these on /v1/chat
-    # and /v1/decide, and nothing else it could spend on. None: the policy calls none (and an older SDK never sent it).
-    # {gs-plans models-api/11, user 2026-10-04 "act key should have ability to call any model involved in the policy"}
     models: list[str] | None = Field(default=None, max_length=16)
 
     @model_validator(mode="after")
@@ -208,7 +185,6 @@ class DeploymentPolicy(BaseModel):
         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")
-        # A declared model is a catalogue id: no blanks, no duplicates (the gateway checks each one exists).
         for model in self.models or []:
             if not model or model != model.strip() or "/" not in model:
                 raise ValueError(f"policy model {model!r} is not a catalogue id (accounts/sequences/models/<name>)")
@@ -264,26 +240,15 @@ class DeploymentRequest(BaseModel):
 
     name: str
     image: ImageSpec
-    # None: a policy without a checkpoint — no weights volume is made, copied or mounted. {gs-plans/storage T13}
     weights: VolumeMount | None = None
     resources: Resources
     policy: DeploymentPolicy
-    # 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)
     autoscaler: Autoscaler = Field(default_factory=Autoscaler)
-    # Every field optional: an omitted @seq.concurrent serves one robot session per model copy, one copy per card.
     concurrency: Concurrency = Field(default_factory=Concurrency)
     timeouts: Timeouts | None = None
-    # Weights in several named parts: `weights` is the first and `weights_name` its name; `extra_weights` the others,
-    # each provisioned like `weights`. @seq.load then receives {name: directory}. Both None (and absent from the wire):
-    # one weights path, as before. {gs-plans/customization/options.md "多份权重文件(BASE + LORA …)"}
     weights_name: str | None = None
     extra_weights: dict[str, VolumeMount] | None = None
 
@@ -293,7 +258,7 @@ class DeploymentRequest(BaseModel):
         """The name is how a robot addresses the model (`connect(model=name)`) and how the console lists it, so
         it is a slug: letters, digits, `.`, `_`, `-`, starting with a letter or digit, at most 64 characters.
         A raw POST once registered "hfcheck-missing hf://nobody/x" — a space, a scheme and a slash in a name.
-        {LIVE 2026-10-02: THREE DEPLOYMENTS NAMED "<SLUG> HF://…" WERE ACCEPTED 202 WITH AN EMPTY WEIGHTS URI}"""
+        """
         if not _NAME.fullmatch(v):
             raise ValueError("name must be 1-64 letters, digits, '.', '_' or '-', starting with a letter or digit")
         return v
@@ -325,9 +290,7 @@ class DeploymentRequest(BaseModel):
         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://", "s3://", "https://")
 
 
@@ -357,5 +320,4 @@ class DeploymentStatusResponse(BaseModel):
     status: DeploymentState
     model: str
     error: str | None = Field(default=None, description="Build-failure reason; set only when FAILED")
-    # Why a deployment that was serving was marked FAILED: its workers kept dying of the same cause.
     reason: Literal["gpu_out_of_memory", "host_out_of_memory", "crashed"] | None = None