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

{simulo_interfaces-0.18.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.18.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.18.0 → simulo_interfaces-0.19.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo-interfaces"
-version = "0.18.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.18.0 → simulo_interfaces-0.19.0}/src/simulo/interfaces/platform/__init__.py

@@ -70,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,
@@ -240,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",

{simulo_interfaces-0.18.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.18.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.18.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.18.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