simulo-interfaces 0.17.0__tar.gz → 0.19.0__tar.gz

{simulo_interfaces-0.17.0/src/simulo_interfaces.egg-info → simulo_interfaces-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo-interfaces
-Version: 0.17.0
+Version: 0.19.0
 Summary: Type contracts for the Simulo SDK. Installed automatically as a dependency of the simulo package.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo-interfaces"
-version = "0.17.0"
+version = "0.19.0"
 description = "Type contracts for the Simulo SDK. Installed automatically as a dependency of the simulo package."
 readme = "PYPI.md"
 requires-python = ">=3.11"

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0}/src/simulo/interfaces/platform/__init__.py

@@ -9,14 +9,6 @@ implementation-free — concrete behaviour lives in the future
 
 from simulo.interfaces.platform.asset import AssetProtocol
 from simulo.interfaces.platform.asset_catalog import (
-    ADMIN_ASSET_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_BY_NUMBER_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_DEPRECATE_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_UPLOAD_COMPLETE_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_UPLOAD_PARTS_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSION_VALIDATE_ROUTE_TEMPLATE,
-    ADMIN_ASSET_VERSIONS_ROUTE_TEMPLATE,
     ASSET_BASE_MODES,
     ASSET_CORRUPT_CODE,
     ASSET_DIGEST_MISMATCH_CODE,
@@ -78,7 +70,7 @@ from simulo.interfaces.platform.asset_catalog import (
 from simulo.interfaces.platform.callbacks import JobCallbackProtocol
 from simulo.interfaces.platform.debug import DebugSessionProtocol, ReplaySessionProtocol, VisualizationSessionProtocol
 from simulo.interfaces.platform.domain import Checkpoint, Job, Package, Project, Resource, Tag, TrainedModel
-from simulo.interfaces.platform.enums import OutputKind
+from simulo.interfaces.platform.enums import OutputKind, SystemType
 from simulo.interfaces.platform.job_events import (
     MAX_PUBLIC_ASSET_FINDING_COUNT,
     MAX_PUBLIC_JOB_EVENT_ATTEMPT,
@@ -248,11 +240,16 @@ from simulo.interfaces.platform.submit import (
     canonical_pypi_name,
     is_platform_pinned,
 )
+from simulo.interfaces.platform.systems import SYSTEM_SPECS, SystemSpec
 from simulo.interfaces.platform.volume import VolumeProtocol
 
 __all__ = [
     # enums
     "OutputKind",
+    "SystemType",
+    # systems (GPU system-tier catalog, issue #1362)
+    "SystemSpec",
+    "SYSTEM_SPECS",
     # closed public job-event contract (#656)
     "PUBLIC_JOB_EVENT_SCHEMA_VERSION",
     "WORKER_JOB_EVENTS_ROUTE_TEMPLATE",
@@ -404,15 +401,7 @@ __all__ = [
     "ASSET_VERSION_VALIDATE_ROUTE_TEMPLATE",
     "ASSET_VERSION_REPORT_ROUTE_TEMPLATE",
     "ASSET_VERSION_DOWNLOAD_ROUTE_TEMPLATE",
-    # asset catalog — admin routes
-    "ADMIN_ASSET_VERSIONS_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_UPLOAD_PARTS_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_UPLOAD_COMPLETE_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_VALIDATE_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_DEPRECATE_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_BY_NUMBER_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_ROUTE_TEMPLATE",
-    "ADMIN_ASSET_VERSION_ROUTE_TEMPLATE",
+    # asset catalog — staff routes
     # asset catalog — worker routes
     "WORKER_JOB_ASSET_VALIDATION_PRESIGN_ROUTE_TEMPLATE",
     "WORKER_JOB_ASSET_VALIDATION_ROUTE_TEMPLATE",

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0}/src/simulo/interfaces/platform/asset_catalog.py

@@ -4,7 +4,7 @@ This is the **canonical, single source of truth** for the reference grammar, the
 route constants, the size caps, the wire dataclasses, and the reserved-word /
 role / verdict enumerations that carry a USD *asset* (a versioned robot, world, or prop
 package) from the laptop client to the cloud catalog and back into a job. It
-lands **before any consumer** — the control plane (customer, ``/admin/*`` and
+lands **before any consumer** — the control plane (customer, ``/staff/*`` and
 ``/internal/worker/*`` routes), the thin ``simulo`` client (``simulo asset ...``
 + the ``simulo run`` submit-time pin resolver), the ``simulo-backend`` worker
 (claim → download → validate), and the ``simulo-console`` catalog browser all
@@ -155,18 +155,6 @@ the two frozensets stay separate constants (identical value today) so a future r
 publish role can split them without an API change. A missing role answers one line
 naming the role and who can grant it.
 
-## Admin endpoints (``require_admin_key`` — the ONLY producers of global rows)
-
-The ``/admin`` mirrors of initiate / parts / complete / validate / deprecate /
-reactivate / delete, plus reads that **include the origin block**. Admin *initiate*
-(:data:`ADMIN_ASSET_VERSIONS_ROUTE_TEMPLATE`) REQUIRES origin:
-``{origin_type, origin_ref, origin_url?, origin_digest?}`` where ``origin_type``
-is one of :data:`ASSET_ORIGIN_TYPES`. Customer serializers exclude origin **by
-construction** — :class:`AssetRecord` / :class:`AssetVersionRecord` carry no
-origin field at all, so ``show --json`` and console payloads can never contain
-it. An org publish records ``origin_type="customer_upload"`` for schema
-symmetry.
-
 ## Worker endpoints (``require_worker`` + lease header)
 
 * The existing claim response
@@ -504,33 +492,6 @@ ASSET_VERSION_REPORT_ROUTE_TEMPLATE = "/v1/asset-versions/{version_id}/report"
 #: :data:`ASSET_NOT_EXPORTABLE_CODE`. ``.format(version_id=...)``.
 ASSET_VERSION_DOWNLOAD_ROUTE_TEMPLATE = "/v1/asset-versions/{version_id}/download"
 
-# --------------------------------------------------------------------------
-# Admin routes  (require_admin_key; the ONLY producers of global rows)
-# --------------------------------------------------------------------------
-#
-# Mirrors of initiate/parts/complete/validate/deprecate/delete, plus reads that
-# INCLUDE the origin block. Same two path families under /admin.
-
-#: ``POST`` — admin initiate (REQUIRES origin). ``.format(kind=..., name=...)``.
-ADMIN_ASSET_VERSIONS_ROUTE_TEMPLATE = "/admin/assets/{kind}/{name}/versions"
-#: ``POST`` — admin batch part presigns. ``.format(version_id=...)``.
-ADMIN_ASSET_VERSION_UPLOAD_PARTS_ROUTE_TEMPLATE = "/admin/asset-versions/{version_id}/upload/parts"
-#: ``POST`` — admin complete multipart upload. ``.format(version_id=...)``.
-ADMIN_ASSET_VERSION_UPLOAD_COMPLETE_ROUTE_TEMPLATE = "/admin/asset-versions/{version_id}/upload/complete"
-#: ``POST`` — admin revalidate. ``.format(version_id=...)``.
-ADMIN_ASSET_VERSION_VALIDATE_ROUTE_TEMPLATE = "/admin/asset-versions/{version_id}/validate"
-#: ``POST`` — admin deprecate by ``vN``. ``.format(kind=..., name=..., version=<int>)``.
-ADMIN_ASSET_VERSION_DEPRECATE_ROUTE_TEMPLATE = "/admin/assets/{kind}/{name}/versions/v{version}/deprecate"
-#: ``POST`` — admin reactivate (un-deprecate) by ``vN`` (global catalog, admin-only).
-#: ``.format(kind=..., name=..., version=<int>)``.
-ADMIN_ASSET_VERSION_REACTIVATE_ROUTE_TEMPLATE = "/admin/assets/{kind}/{name}/versions/v{version}/reactivate"
-#: ``DELETE`` — admin delete by ``vN``. ``.format(kind=..., name=..., version=<int>)``.
-ADMIN_ASSET_VERSION_BY_NUMBER_ROUTE_TEMPLATE = "/admin/assets/{kind}/{name}/versions/v{version}"
-#: ``GET`` — admin asset read (INCLUDES origin). ``.format(kind=..., name=...)``.
-ADMIN_ASSET_ROUTE_TEMPLATE = "/admin/assets/{kind}/{name}"
-#: ``GET`` — admin version read (INCLUDES origin). ``.format(version_id=...)``.
-ADMIN_ASSET_VERSION_ROUTE_TEMPLATE = "/admin/asset-versions/{version_id}"
-
 # --------------------------------------------------------------------------
 # Worker routes  (bearer = static WORKER_TOKEN; + lease header, see submit.py)
 # --------------------------------------------------------------------------

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0}/src/simulo/interfaces/platform/enums.py

@@ -44,6 +44,28 @@ class ResumePolicy(StrEnum):
     """Resume only on explicit request. Reserved: currently behaves like ``NEVER``."""
 
 
+class SystemType(StrEnum):
+    """An abstract GPU system tier.
+
+    Each tier's hardware profile and fleet-provisioning state lives in
+    :data:`simulo.interfaces.platform.systems.SYSTEM_SPECS`, keyed by these
+    members. The AWS instance type behind a tier is never part of this name —
+    see :class:`simulo.interfaces.platform.systems.SystemSpec`'s own docstring.
+    """
+
+    TIER_1 = "tier1"
+    """Entry tier — always available."""
+
+    TIER_2 = "tier2"
+    """Mid tier — always available."""
+
+    TIER_3 = "tier3"
+    """High tier — not yet available on the deployable fleet."""
+
+    TIER_4 = "tier4"
+    """Top tier — not yet available on the deployable fleet."""
+
+
 class ResourceKind(StrEnum):
     """Kind of a registry-resolved, read-only resource mount."""
 

simulo_interfaces-0.19.0/src/simulo/interfaces/platform/systems.py

@@ -0,0 +1,106 @@
+"""GPU system-tier catalog — the closed hardware contract behind `SystemType`.
+
+`SYSTEM_SPECS` is the single published source of truth for what each tier
+means: the marketing GPU name, its VRAM, the host's vCPU/memory, whether the
+tier is provisionable on the deployable fleet today, and (internal-only) the
+AWS instance type behind it. Nothing here schedules a job against real
+hardware — selection stays record-only until a later milestone adds live
+enforcement.
+
+Stdlib-only (`dataclasses` plus the sibling `enums` module): this file must
+import nothing else, so the package's zero-runtime-dependency guarantee
+(`test_no_heavy_deps.py`) holds.
+"""
+
+from dataclasses import dataclass
+
+from simulo.interfaces.platform.enums import SystemType
+
+# Shared dataclass options: immutable value objects (frozen), memory-lean
+# (slots), and keyword-only construction (kw_only) — see `platform/domain.py`'s
+# identical `_DC` for the full rationale.
+_DC = {"frozen": True, "slots": True, "kw_only": True}
+
+
+@dataclass(**_DC)
+class SystemSpec:
+    """One GPU tier's hardware profile and fleet-provisioning state.
+
+    `gpu_model` (e.g. `"T4"`) is the user-facing marketing name — the only
+    hardware identity a CLI table, `--json` output, or documentation page may
+    ever show. `instance_type` is the AWS EC2 instance type behind the tier,
+    kept here ONLY for an offline fleet crosscheck against the deployable
+    CloudFormation allowlist and the control plane's own bookkeeping — it
+    must never reach a user-facing surface. Hiding it is deliberate: a future
+    author copying an AWS SKU into an example is exactly how `gpu="L4"`
+    (actually Tier 3, not provisionable) ended up in 40 tracked files before
+    this catalog existed.
+    """
+
+    system: SystemType
+    gpu_model: str
+    vram_gb: int
+    vcpu: int
+    memory_gb: int
+    max_parallel_envs: int | None
+    available: bool
+    instance_type: str
+
+
+# vcpu/memory_gb: AWS's published instance-type specifications
+# (https://docs.aws.amazon.com/ec2/latest/instancetypes/ac.html, confirmed at
+# M20-system-catalog implementation time, 2026-09-07) for
+# g4dn.xlarge/g5.xlarge/g6.xlarge/g6e.xlarge. vram_gb: each GPU model's
+# published VRAM capacity (NVIDIA product specifications) — deliberately NOT
+# the ~22/44 GiB AWS's own instance-type page reports as *usable* GPU memory
+# on g5/g6/g6e after ECC/hypervisor reservation, since `vram_gb` documents the
+# hardware users are told they are getting (`gpu_model`), not a fleet
+# provisioning detail.
+SYSTEM_SPECS: dict[SystemType, SystemSpec] = {
+    SystemType.TIER_1: SystemSpec(
+        system=SystemType.TIER_1,
+        gpu_model="T4",
+        vram_gb=16,
+        vcpu=4,
+        memory_gb=16,
+        # Measured ceiling for g4dn.xlarge's default workload (`.claude/skills/isaaclab/SKILL.md`,
+        # `.claude/skills/aws-infra/SKILL.md`, `cloud-infra/gpu-worker/gpu-worker.yaml`): 16
+        # parallel environments; a 4096-environment run exhausted GPU memory and made the
+        # instance unrecoverable. `aws-infra/SKILL.md` is explicit that this is
+        # workload/instance evidence for the template's default workload, not a universal
+        # constant — re-benchmark before relying on it for a different workload shape.
+        max_parallel_envs=16,
+        available=True,
+        instance_type="g4dn.xlarge",
+    ),
+    SystemType.TIER_2: SystemSpec(
+        system=SystemType.TIER_2,
+        gpu_model="A10G",
+        vram_gb=24,
+        vcpu=4,
+        memory_gb=16,
+        max_parallel_envs=None,
+        available=True,
+        instance_type="g5.xlarge",
+    ),
+    SystemType.TIER_3: SystemSpec(
+        system=SystemType.TIER_3,
+        gpu_model="L4",
+        vram_gb=24,
+        vcpu=4,
+        memory_gb=16,
+        max_parallel_envs=None,
+        available=False,
+        instance_type="g6.xlarge",
+    ),
+    SystemType.TIER_4: SystemSpec(
+        system=SystemType.TIER_4,
+        gpu_model="L40S",
+        vram_gb=48,
+        vcpu=4,
+        memory_gb=32,
+        max_parallel_envs=None,
+        available=False,
+        instance_type="g6e.xlarge",
+    ),
+}

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0/src/simulo_interfaces.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo-interfaces
-Version: 0.17.0
+Version: 0.19.0
 Summary: Type contracts for the Simulo SDK. Installed automatically as a dependency of the simulo package.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause

{simulo_interfaces-0.17.0 → simulo_interfaces-0.19.0}/src/simulo_interfaces.egg-info/SOURCES.txt

@@ -38,6 +38,7 @@ src/simulo/interfaces/platform/policy_bundle.py
 src/simulo/interfaces/platform/runs.py
 src/simulo/interfaces/platform/runtime.py
 src/simulo/interfaces/platform/submit.py
+src/simulo/interfaces/platform/systems.py
 src/simulo/interfaces/platform/volume.py
 src/simulo/interfaces/runtime/__init__.py
 src/simulo/interfaces/runtime/anomaly.py