simulo 0.33.1__tar.gz → 0.35.0__tar.gz

{simulo-0.33.1/src/simulo.egg-info → simulo-0.35.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo
-Version: 0.33.1
+Version: 0.35.0
 Summary: Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://docs.simulo.ai
 Project-URL: Quickstart, https://docs.simulo.ai/getting-started/quickstart/
 Project-URL: Examples, https://github.com/simulo-org/simulo-samples
 Project-URL: Console, https://console.simulo.ai
-Keywords: simulo,robotics,robotics simulation,robot training,robot learning,reinforcement learning,cloud robotics,cloud simulation,GPU simulation,policy training,physical AI,embodied AI,NVIDIA Isaac Sim,Isaac Lab,OpenUSD,USD,URDF,ONNX,MCAP,Python SDK
+Keywords: simulo,robotics,robotics simulation,robot training,robot learning,reinforcement learning,cloud robotics,cloud simulation,GPU simulation,policy training,physical AI,embodied AI,OpenUSD,USD,URDF,ONNX,MCAP,Python SDK
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -31,14 +31,16 @@ Classifier: Topic :: System :: Distributed Computing
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: simulo-interfaces<0.25,>=0.24.0
+Requires-Dist: simulo-interfaces<0.27,>=0.26.0
 Requires-Dist: mcap<2,>=1.3
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: usd-core<27,>=26.5
+Provides-Extra: viz
+Requires-Dist: simulo-viz<0.2,>=0.1.0; python_version >= "3.12" and extra == "viz"
 Provides-Extra: assets
 Requires-Dist: usd-core<27,>=26.5; extra == "assets"
 Provides-Extra: dev
-Requires-Dist: black==26.5.1; extra == "dev"
+Requires-Dist: black==26.10.1; extra == "dev"
 Requires-Dist: isort==8.0.1; extra == "dev"
 Requires-Dist: ruff==0.15.21; extra == "dev"
 Requires-Dist: mypy==2.3.0; extra == "dev"
@@ -122,7 +124,7 @@ simulo policy get policy_x:best   # download a verified checkpoint
 simulo export policy_x:best       # export a verified ONNX bundle
 simulo recordings                 # download MCAP rollout recordings
 simulo outputs                    # retrieve other saved outputs
-simulo view                       # view a running --viewstream job in 3D
+simulo view                       # view a running job in 3D (live view is on by default)
 simulo cancel                     # stop a queued or running job
 ```
 

{simulo-0.33.1 → simulo-0.35.0}/PYPI.md

@@ -66,7 +66,7 @@ simulo policy get policy_x:best   # download a verified checkpoint
 simulo export policy_x:best       # export a verified ONNX bundle
 simulo recordings                 # download MCAP rollout recordings
 simulo outputs                    # retrieve other saved outputs
-simulo view                       # view a running --viewstream job in 3D
+simulo view                       # view a running job in 3D (live view is on by default)
 simulo cancel                     # stop a queued or running job
 ```
 

{simulo-0.33.1 → simulo-0.35.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo"
-version = "0.33.1"
+version = "0.35.0"
 description = "Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs."
 readme = "PYPI.md"
 requires-python = ">=3.11"
@@ -23,8 +23,6 @@ keywords = [
     "policy training",
     "physical AI",
     "embodied AI",
-    "NVIDIA Isaac Sim",
-    "Isaac Lab",
     "OpenUSD",
     "USD",
     "URDF",
@@ -59,7 +57,7 @@ classifiers = [
 # mcap: used by `simulo recordings` to read back a downloaded recording and
 # verify it (message count) — MIT-licensed, deps only lz4+zstandard.
 dependencies = [
-    "simulo-interfaces>=0.24.0,<0.25",
+    "simulo-interfaces>=0.26.0,<0.27",
     "mcap>=1.3,<2",
     # Hardened XML parsing for URDF ingestion (USD Asset Catalogs, PR-12 fix
     # loop 2, security NIT): stdlib xml.etree.ElementTree relies on
@@ -70,6 +68,8 @@ dependencies = [
     # featherweight promise below (that promise was about avoiding
     # usd-core's tens of MB via an opt-in extra; usd-core itself joined the
     # base footprint in 0.13.1 — see its own comment just below).
+    # Uncapped on purpose: the floor keeps the hardened XML parser; an upper
+    # bound is added only when a release breaks it.
     "defusedxml>=0.7.1",
     # usd-core: simulator-free but tens of MB — moved from the `assets`
     # extra into the base install in 0.13.1 so `pip install simulo` covers
@@ -81,6 +81,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+viz = ["simulo-viz>=0.1.0,<0.2; python_version >= '3.12'"]
 # `assets` — kept for backward compatibility with `pip install
 # "simulo[assets]"` (the 0.13.0-era spelling): usd-core moved into the base
 # install above in 0.13.1, so this extra is now redundant (its dep is
@@ -104,7 +105,7 @@ assets = ["usd-core>=26.5,<27"]
 # `pytest-timeout` is pinned EXACT because it enforces the suite's hang bound;
 # changing the plugin under an unchanged timeout would change that guard's behavior.
 dev = [
-    "black==26.5.1",
+    "black==26.10.1",
     "isort==8.0.1",
     "ruff==0.15.21",
     "mypy==2.3.0",
@@ -193,6 +194,7 @@ markers = [
     "isaac: requires NVIDIA Isaac Sim / IsaacLab (skipped on dev machines and in PR CI)",
     "gpu: requires a CUDA GPU (skipped on dev machines and in PR CI)",
     "requires_execution_backend: end-to-end test that needs a live execution backend in the loop; skipped in CPU/unit runs",
+    "smoke: a short fundamental-path test; the hosted smoke job in simulo-ci.yml runs only these, and local CI runs every test",
 ]
 
 # --- Formatters / linters --------------------------------------------------

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/__init__.py

@@ -129,6 +129,7 @@ from simulo.interfaces import (
 # re-exported here like every other concrete authoring type — no exclusion
 # needed any more.
 from simulo.interfaces.authoring import (
+    ActionChannel,
     ArrowMarker,
     AssetEntity,
     AssetSource,
@@ -143,6 +144,8 @@ from simulo.interfaces.authoring import (
     DomeLight,
     GroundPlane,
     LightConfig,
+    LineMarker,
+    ObjectVariants,
     PointMarker,
     PolicyCheckpoint,
     PolicyInput,
@@ -210,6 +213,7 @@ __all__ = [
     "Digest",
     # authoring value types (eager, real) — the rest of the vocabulary the
     # lazy resolver below does not carry
+    "ActionChannel",
     "Collision",
     "RigidPhysics",
     "DeformableMaterial",
@@ -219,6 +223,7 @@ __all__ = [
     "USDAsset",
     "URDFAsset",
     "LightConfig",
+    "ObjectVariants",
     "DistantLight",
     "DomeLight",
     "TerrainConfig",
@@ -238,6 +243,7 @@ __all__ = [
     "SphereMarker",
     "ArrowMarker",
     "PointMarker",
+    "LineMarker",
     # lazy, mode-aware (the learning names + save_output)
     "ActuatorGainsConfig",
     "ArticulationConfig",
@@ -310,8 +316,13 @@ def __getattr__(name: str) -> object:
     Fires only for attributes missing from the module dict — i.e. never for the
     real platform exports above. Delegates the learning names to the thin
     client's internal resolver (discovery stand-in vs. real
-    ``simulo.core`` class, by mode); everything else is a genuine ``AttributeError``.
+    ``simulo.core`` class, by mode), and read ``__version__`` from installed
+    package metadata on demand. Unknown names raise ``AttributeError``.
     """
+    if name == "__version__":
+        from importlib.metadata import version
+
+        return version("simulo")
     if name in _LEARNING_NAMES:
         return _resolve_learning(name)
     removed_hints = {

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/_client/_runner.py

@@ -23,7 +23,7 @@ from __future__ import annotations
 
 import time
 from pathlib import Path
-from typing import Any, NoReturn, Optional
+from typing import Any, Mapping, NoReturn, Optional
 
 from simulo.interfaces.ids import JobId, JobPublicId
 from simulo.interfaces.platform.enums import JobStatus, JobType
@@ -91,6 +91,8 @@ class JobHandle:
         base_url: Optional[str] = None,
         token: Optional[str] = None,
         job_type: Optional[JobType] = None,
+        runtime_budget_s: Optional[int] = None,
+        job_args: Optional[Mapping[str, Any]] = None,
         input_checkpoint: Optional[str] = None,
         compare_checkpoint: Optional[str] = None,
         deferred_stdout: str = "",
@@ -104,6 +106,8 @@ class JobHandle:
         self._base_url = base_url
         self._token = token
         self._job_type = job_type
+        self._runtime_budget_s = runtime_budget_s
+        self._job_args = dict(job_args or {})
         self._input_checkpoint = input_checkpoint
         self._compare_checkpoint = compare_checkpoint
         self._deferred_stdout = deferred_stdout
@@ -149,6 +153,16 @@ class JobHandle:
         """Declared type for a cloud submission; absent on legacy local handles."""
         return self._job_type
 
+    @property
+    def runtime_budget_s(self) -> Optional[int]:
+        """The effective server-resolved time limit, in seconds, when served."""
+        return self._runtime_budget_s
+
+    @property
+    def job_args(self) -> Mapping[str, Any]:
+        """Training arguments for submit guidance, including declared defaults when known."""
+        return self._job_args
+
     @property
     def input_checkpoint(self) -> Optional[str]:
         """Policy checkpoint requested with ``simulo run --from``."""

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/_client/app.py

@@ -48,12 +48,14 @@ from typing import (
 
 from simulo._client import config, credentials, registry
 from simulo._client._runner import JobFailedError, JobHandle, JobResultUnavailable
+from simulo._client.repeatable_episodes import requested_repeatable_episodes
 from simulo._client.runtime import DEFAULT_RUNTIME
+from simulo._client.system_requests import effective_resources, validate_resources
+from simulo._client.training_algorithm import validate_training_algorithm
 from simulo.interfaces.ids import JobId, parse_job_public_id
 from simulo.interfaces.platform import JobCallbackProtocol, JobType, normalize_job_tags
 from simulo.interfaces.platform.app import Mount
 from simulo.interfaces.platform.enums import SystemType
-from simulo.interfaces.platform.systems import SYSTEM_SPECS
 
 if TYPE_CHECKING:  # typing-only; avoids a module-scope dependency on the HTTP client
     from simulo._client.preflight_api import PreflightOutcome
@@ -131,19 +133,43 @@ def spawn_recorder() -> Iterator[list["JobHandle"]]:
 # through arbitrary user code" reason.
 # ---------------------------------------------------------------------------
 
-_VIEWSTREAM_REQUESTED = False
+_VIEWSTREAM_REQUESTED: Optional[bool] = None
+_VIEWSTREAM_NOTICE: Optional[str] = None
 
 
 @contextlib.contextmanager
-def viewstream_requested(enabled: bool) -> Iterator[None]:
-    """Scope ``--viewstream`` for one ``simulo run`` submit call."""
-    global _VIEWSTREAM_REQUESTED
+def viewstream_requested(enabled: Optional[bool], *, notice: Optional[str] = None) -> Iterator[None]:
+    """Scope one resolved live-view request for one ``simulo run`` submit call."""
+    global _VIEWSTREAM_REQUESTED, _VIEWSTREAM_NOTICE
     previous = _VIEWSTREAM_REQUESTED
+    previous_notice = _VIEWSTREAM_NOTICE
     _VIEWSTREAM_REQUESTED = enabled
+    _VIEWSTREAM_NOTICE = notice
     try:
         yield
     finally:
         _VIEWSTREAM_REQUESTED = previous
+        _VIEWSTREAM_NOTICE = previous_notice
+
+
+# ---------------------------------------------------------------------------
+# 3D-recording ambient signal — `simulo run --record-3d COPIES` scopes an
+# execution option without placing it in package arguments or the manifest.
+# ---------------------------------------------------------------------------
+
+_RECORDING_COPIES_REQUESTED: Optional[int] = None
+
+
+@contextlib.contextmanager
+def recording_copies_requested(copies: Optional[int]) -> Iterator[None]:
+    """Scope an optional 3D recording copy count for one submit."""
+    global _RECORDING_COPIES_REQUESTED
+    previous = _RECORDING_COPIES_REQUESTED
+    _RECORDING_COPIES_REQUESTED = copies
+    try:
+        yield
+    finally:
+        _RECORDING_COPIES_REQUESTED = previous
 
 
 # ---------------------------------------------------------------------------
@@ -526,7 +552,9 @@ def _spawn_cloud(
     package_path: Path,
     creds: Optional[dict[str, Any]],
     *,
-    viewstream: bool = False,
+    viewstream: Optional[bool] = None,
+    recording_copies: Optional[int] = None,
+    repeatable_episodes: Optional[bool] = None,
     input_checkpoint: Optional[str] = None,
     compare_checkpoint: Optional[str] = None,
     require_success: Optional[float] = None,
@@ -536,6 +564,7 @@ def _spawn_cloud(
     app_name: Optional[str] = None,
     job_type: JobType,
     tags: Sequence[str] = (),
+    job_args: Optional[Mapping[str, Any]] = None,
 ) -> JobHandle:
     """Tar the bundle, preflight it, upload it, create the job, and return a
     cloud JobHandle.
@@ -599,7 +628,7 @@ def _spawn_cloud(
     job-create call's top-level ``assets`` field, never ``args``.
     """
     from simulo._client.asset_pins import (
-        DEFAULT_ASSET_RUNTIME,
+        asset_runtime_for_runtime_id,
         collect_asset_refs,
         resolve_and_pin_assets,
     )
@@ -630,15 +659,12 @@ def _spawn_cloud(
     package_id = str(package_id)
     source_digest = str(manifest.get("source_digest", ""))
     args = dict(manifest.get("args") or {})
-    # The requested GPU system tier (system-tier-catalog-1362, M50-persistence)
-    # — already validated at `@app.job(system=...)` decoration time and
-    # recorded on THIS job's own manifest entry as `resources["system"]`
-    # (the tier's wire value, e.g. "tier1"; see `decorate()`'s
-    # `resources["system"] = system.value`). Read from the already-parsed
-    # manifest rather than threaded in as a new parameter, since the value
-    # already lives there, keyed by this same `job_name`.
+    # CLI selections override this job's declared resources for this submit.
+    # They never enter args or rewrite the packaged manifest. Omitted options
+    # retain their existing wire representation for servers awaiting adoption.
     job_entry = manifest.get("jobs", {}).get(job_name) or {}
-    system = (job_entry.get("resources") or {}).get("system")
+    allocation = effective_resources(job_entry.get("resources") or {})
+    system = allocation.pop("system", None)
     manifest_version = manifest.get("manifest_version")
     if not isinstance(manifest_version, int) or isinstance(manifest_version, bool):
         raise RuntimeError(
@@ -689,8 +715,10 @@ def _spawn_cloud(
             archive_size=len(archive_bytes),
             job_type=job_type,
             input_checkpoint=input_checkpoint,
-            viewstream=viewstream,
+            viewstream=viewstream is True,
             assets=[] if not asset_refs else None,
+            **({"system": system} if system is not None else {}),
+            **allocation,
         )
         deferred_stdout, deferred_stderr = _handle_preflight_outcome(outcome, job_name=job_name)
 
@@ -700,13 +728,15 @@ def _spawn_cloud(
     # package is uploaded — so a missing/unpinned/unvalidated ref fails in seconds.
     # Returns the top-level `assets: [{ref, digest}]` for create_job; `[]`
     # when the app mounts no registry assets (no resolve call is made then).
-    asset_pins = resolve_and_pin_assets(
-        client,
-        collect_asset_refs(manifest),
-        runtime=DEFAULT_ASSET_RUNTIME,
-        frozen=frozen_assets,
-        strict=strict_assets,
-    )
+    asset_pins: list[dict[str, str]] = []
+    if asset_refs:
+        asset_pins = resolve_and_pin_assets(
+            client,
+            asset_refs,
+            runtime=asset_runtime_for_runtime_id(str(manifest["runtime_id"])),
+            frozen=frozen_assets,
+            strict=strict_assets,
+        )
 
     client.create_package(
         package_id=package_id,
@@ -720,7 +750,10 @@ def _spawn_cloud(
         package_id=package_id,
         job_name=job_name,
         args=args,
+        runtime_id=str(manifest["runtime_id"]),
         viewstream=viewstream,
+        recording_copies=recording_copies,
+        repeatable_episodes=repeatable_episodes,
         input_checkpoint=input_checkpoint,
         compare_checkpoint=compare_checkpoint,
         require_success=require_success,
@@ -731,7 +764,16 @@ def _spawn_cloud(
         job_type=job_type,
         tags=tags,
         manifest_version=manifest_version,
+        **allocation,
     )
+    # A submitted entrypoint can call ``spawn()`` more than once.  The
+    # resolved notice describes the run-level opt-in, so print it once only
+    # after the first successful job-create response.  Do not consume it when
+    # create_job raises: then the run did not successfully submit anything.
+    global _VIEWSTREAM_NOTICE
+    if _VIEWSTREAM_NOTICE is not None:
+        print(_VIEWSTREAM_NOTICE, file=sys.stderr)
+        _VIEWSTREAM_NOTICE = None
 
     raw_public_id = record.get("public_id")
     try:
@@ -756,6 +798,8 @@ def _spawn_cloud(
         base_url=base_url,
         token=token,
         job_type=job_type,
+        runtime_budget_s=record.get("runtime_budget_s"),
+        job_args=job_args if job_args is not None else args,
         input_checkpoint=input_checkpoint,
         compare_checkpoint=compare_checkpoint,
         deferred_stdout=deferred_stdout,
@@ -813,6 +857,12 @@ class JobFunction:
         # job/success contract as ``simulo run``.  This happens before the
         # intent marker, bundle construction, asset resolution, or network I/O.
         self._app.validate_job_submission(self._spec.name)
+        if self._spec.job_type is JobType.TRAIN:
+            parameter = inspect.signature(self._spec.fn).parameters.get("algorithm")
+            if "algorithm" in kwargs:
+                validate_training_algorithm(kwargs["algorithm"])
+            elif parameter is not None and parameter.default is not inspect.Parameter.empty:
+                validate_training_algorithm(parameter.default)
 
         # Intent-to-submit is recorded FIRST — before any packaging or network
         # I/O — so a submit that fails partway (or times out AFTER the server
@@ -861,6 +911,8 @@ class JobFunction:
                         package_path,
                         creds,
                         viewstream=_VIEWSTREAM_REQUESTED,
+                        recording_copies=_RECORDING_COPIES_REQUESTED,
+                        repeatable_episodes=requested_repeatable_episodes(),
                         input_checkpoint=_INPUT_CHECKPOINT_REF,
                         compare_checkpoint=_COMPARE_CHECKPOINT_REF,
                         require_success=_REQUIRE_SUCCESS,
@@ -870,6 +922,12 @@ class JobFunction:
                         app_name=self._app.name,
                         job_type=self._spec.job_type,
                         tags=_JOB_TAGS_REQUESTED,
+                        job_args={
+                            name: parameter.default
+                            for name, parameter in inspect.signature(self._spec.fn).parameters.items()
+                            if parameter.default is not inspect.Parameter.empty
+                        }
+                        | kwargs,
                     )
 
                 if _SPAWN_RECORDER is None:
@@ -1256,6 +1314,8 @@ class App:
         type: Union[JobType, str],
         callbacks: Sequence[JobCallbackProtocol] = ...,
         system: Optional[SystemType] = ...,
+        gpus: Optional[int] = ...,
+        gpus_per_node: Optional[int] = ...,
         timeout: Optional[int] = ...,
         retries: int = ...,
         **extra: Any,
@@ -1269,6 +1329,8 @@ class App:
         type: Union[JobType, str],
         callbacks: Sequence[JobCallbackProtocol] = ...,
         system: Optional[SystemType] = ...,
+        gpus: Optional[int] = ...,
+        gpus_per_node: Optional[int] = ...,
         timeout: Optional[int] = ...,
         retries: int = ...,
         **extra: Any,
@@ -1281,6 +1343,8 @@ class App:
         type: Optional[Union[JobType, str]] = None,
         callbacks: Sequence[JobCallbackProtocol] = (),
         system: Optional[SystemType] = None,
+        gpus: Optional[int] = None,
+        gpus_per_node: Optional[int] = None,
         timeout: Optional[int] = None,
         retries: int = 0,
         **extra: Any,
@@ -1298,23 +1362,16 @@ class App:
                 pass it alongside keyword options).
             callbacks: Lifecycle callbacks from :mod:`simulo.callbacks`, recorded
                 into the package manifest and honored at execution.
-            system: The GPU system tier to request, as a
-                :class:`simulo.SystemType` member (e.g.
-                ``simulo.SystemType.TIER_1``), recorded in the job's resource
-                spec as ``resources["system"]`` (the tier's wire value, e.g.
-                ``"tier1"``). Validated HERE, at decoration time, against the
-                published catalog: a value that is not a ``SystemType`` member
-                (a raw string such as ``"tier1"`` included) raises
-                ``TypeError``, and a tier the platform cannot provision yet
-                raises ``ValueError``. ``simulo systems`` lists every tier and
-                which are available today. The selection is recorded on the
-                job AND scheduled against: the control plane filters a tiered
-                worker's claim to its own tier plus untiered work, so the tier
-                decides which GPU model runs the job. It is not a priority
-                setting. ``simulo systems`` reports this package's catalog,
-                not which tiers your platform has deployed. Naming a tier it
-                has no fleet for is refused when you submit, and the error
-                names the tiers it does have.
+            system: Accelerator memory class as a :class:`simulo.SystemType` member.
+                Omitted means Tier 1 (16 GB). Tier 2 is 24 GB, Tier 3 is 48 GB,
+                and Tier 4 is 96 GB per accelerator. Hardware within a class can
+                change. The built-in catalog enables Tier 1 and Tier 2 only;
+                the server must also check its fleet readiness at submission.
+            gpus: Total GPU count, a positive integer. Omitted means one GPU.
+                Today's built-in policy permits one GPU per job.
+            gpus_per_node: Optional positive integer layout constraint. All GPUs
+                must run on one machine, so this must equal the total GPU count.
+                It never multiplies ``gpus``. Counts reject booleans.
             timeout: Requested runtime limit for one managed execution, in
                 seconds (a positive integer; validated HERE, at decoration
                 time — a zero, negative, or non-integer value raises
@@ -1339,7 +1396,7 @@ class App:
             ValueError: ``timeout`` is not ``None`` and is not a positive
                 integer. ``True`` and ``False`` are not accepted as timeouts.
                 Also raised when ``system`` names a tier the platform cannot
-                provision yet (``SYSTEM_SPECS[system].available`` is false).
+                provision, or a GPU count/layout is unsupported by the built-in policy.
             JobDeclarationError: ``produces=`` or ``consumes=`` was passed. Outputs are
                 not declared on the decorator. Callbacks declare their own
                 supported outputs. Return small JSON values from the job, or use a named
@@ -1381,28 +1438,12 @@ class App:
                 "@app.job(system=simulo.SystemType.TIER_1). Run `simulo systems` to list the "
                 "tiers and which are available today. Remove gpu=."
             )
-        if system is not None:
-            # Static lookups against the published catalog — no fleet state
-            # is consulted. A raw string is refused even when it spells a
-            # valid wire value, so the one accepted spelling is the enum.
-            if not isinstance(system, SystemType):
-                raise JobDeclarationError(
-                    "@app.job(system=...) must be a simulo.SystemType member, e.g. "
-                    f"system=simulo.SystemType.TIER_1; got {system!r}. Run `simulo systems` to "
-                    "list the tiers."
-                )
-            spec = SYSTEM_SPECS[system]
-            if not spec.available:
-                available = ", ".join(
-                    f"SystemType.{tier.name} ({entry.gpu_model})"
-                    for tier, entry in SYSTEM_SPECS.items()
-                    if entry.available
-                )
-                raise ValueError(
-                    f"@app.job(system=SystemType.{system.name}) ({spec.gpu_model}) is not available on "
-                    f"the platform yet. Available today: {available}. Run `simulo systems` for the "
-                    "full catalog."
-                )
+        if system is not None and not isinstance(system, SystemType):
+            raise JobDeclarationError(
+                "@app.job(system=...) must be a simulo.SystemType member, e.g. "
+                f"system=simulo.SystemType.TIER_1; got {system!r}. Run `simulo systems` to list the tiers."
+            )
+        requested_resources = validate_resources(system, gpus, gpus_per_node)
 
         def decorate(func: F) -> JobFunction:
             location = Path(func.__code__.co_filename).name
@@ -1420,9 +1461,7 @@ class App:
                     f"{location}: Job {func.__name__!r} has invalid type={type!r}. Valid job types: {valid}. "
                     'Example: @app.job(type="train").'
                 ) from None
-            resources: dict[str, Any] = {}
-            if system is not None:
-                resources["system"] = system.value
+            resources = dict(requested_resources)
             resources.update(extra)
             policy_params = [
                 name

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/_client/asset.py

@@ -1,7 +1,7 @@
 """``Asset`` — a read-only, registry-resolved mount (implements ``AssetProtocol``).
 
 A registry asset ref is ``[<publisher>/]<kind>/<name>[:v<N>]`` (e.g.
-``robot/so-arm-100:v3``, ``simulo/world/warehouse:v2``, or the unpinned
+``robot/so-arm-100:v3``, ``simulo/world/warehouse:v3``, or the unpinned
 ``robot/forklift`` — resolved to an exact version **at submit**). The grammar
 is the ONE shared parser from ``simulo.interfaces.platform.asset_catalog`` — the
 CLI, the control plane, the worker, and the console all parse through it, so the
@@ -148,7 +148,7 @@ class Asset:
     """A read-only, registry-resolved resource mounted into running jobs.
 
     A registry ref is ``[<publisher>/]<kind>/<name>[:v<N>]`` (e.g.
-    ``simulo/robot/cartpole:v1``); :meth:`from_registry` names one, and :attr:`path`
+    ``simulo/robot/cartpole:v5``); :meth:`from_registry` names one, and :attr:`path`
     resolves to its read-only mount inside a running job. ``Asset`` is also how a
     task names USD/URDF model sources to load into a scene — :meth:`usd` /
     :meth:`urdf`.

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/_client/asset_pins.py

@@ -24,14 +24,33 @@ from typing import Any, Dict, List, Mapping, Optional, Sequence, TextIO
 
 from simulo._client.runtime_display import display_runtime
 from simulo._client.submit_api import AssetPinError, SubmitApiClient
-from simulo.interfaces.platform.asset_catalog import DEFAULT_ASSET_RUNTIME, ResolvedAssetPin, parse_asset_ref
+from simulo.interfaces.platform.asset_catalog import (
+    DEFAULT_ASSET_RUNTIME,
+    ResolvedAssetPin,
+    parse_asset_ref,
+)
+from simulo.interfaces.platform.runtimes import RUNTIME_ID_BY_ASSET_RUNTIME
 
 #: Re-exported from ``simulo.interfaces.platform.asset_catalog`` (current code and tests
 #: "Runtime-string seam", 2026-07-17 — hoisted there so the CLIENT's resolve
 #: request and the VALIDATOR's finalize call can never send different runtime
 #: strings). Kept as a module attribute here too — existing call sites
 #: (``app.py``, tests) import it from this module.
-__all__ = ["DEFAULT_ASSET_RUNTIME", "collect_asset_refs", "resolve_and_pin_assets"]
+__all__ = ["DEFAULT_ASSET_RUNTIME", "asset_runtime_for_runtime_id", "collect_asset_refs", "resolve_and_pin_assets"]
+
+
+def asset_runtime_for_runtime_id(runtime_id: str) -> str:
+    """Return the catalog label published for a requested job runtime.
+
+    Asset validation records catalog labels while manifests request job runtime
+    identifiers. There is no safe label for an unlisted runtime: resolving an
+    asset under Isaac would make the validation result describe a different
+    runtime from the job that will mount it.
+    """
+    for asset_runtime, mapped_runtime_id in RUNTIME_ID_BY_ASSET_RUNTIME.items():
+        if runtime_id == mapped_runtime_id:
+            return asset_runtime
+    raise AssetPinError(f"runtime {runtime_id!r} has no published asset catalog mapping")
 
 
 def collect_asset_refs(manifest: Mapping[str, Any]) -> List[str]:

{simulo-0.33.1 → simulo-0.35.0}/src/simulo/_client/bundle.py

@@ -4,9 +4,10 @@ Shared by ``simulo run`` (the CLI) and ``JobFunction.spawn`` — the *submit* pa
 discover the app's metadata and write the package (manifest + source bundle) to
 disk. The manifest builder reads only the public ``App`` surface, so it works in
 discovery mode (where submit runs). ``ensure_bundle`` memoises the written package
-per *submission* — ``(app, entry_file, job_name, args)`` — so re-submitting the
-same file and job with the same args reuses the package, while a second spawn with
-a different entry file, job, or args writes a distinct package (no clobber).
+per *submission* — ``(app, entry_file, job_name, args, captured assets)`` — so
+re-submitting the same file and job with the same args and captured assets reuses
+the package. Package identity hashes source, entry file, job, canonical args,
+and the canonical asset list; changing any of those writes a distinct package.
 
 Submit NEVER executes a job and NEVER invokes the backend — it only writes the
 package. This module imports no heavy library; it stays on the torch-free side of
@@ -59,9 +60,9 @@ DEFAULT_OUT_SUBPATH = (".simulo", "packages")
 #: capture — see ``asset.py``) — included so a LATER spawn() in the same process,
 #: after user code has constructed MORE assets since an earlier spawn() with
 #: the identical ``(app, entry_file, job_name, args)``, is never served a stale cached bundle
-#: whose ``resources`` predates those constructions (``package_id`` itself never
-#: changes with the asset set — see the package-hash-invariance rule — so the
-#: `package_id` re-check below cannot by itself catch this staleness).
+#: whose ``resources`` predates those constructions. The package id also hashes
+#: resources, but a cache hit does not rebuild the manifest or recompute the id,
+#: so this key must still distinguish the captured asset set.
 _BUNDLE_CACHE: dict[tuple[int, str, str, str, tuple[str, ...]], tuple[Path, str]] = {}
 
 
@@ -197,7 +198,8 @@ def ensure_bundle(
     This is the *submit* primitive: the manifest is built from the live app object
     (no second discovery import) with the submitted job's ``args`` recorded, and
     the source tree is written to ``<out>/<bundle_dir_name(package_id)>/`` — the
-    per-submission directory keyed on source + entry file + ``job_name`` + ``args`` (named by
+    per-submission directory keyed on source + entry file + ``job_name`` + canonical
+    ``args`` + canonical asset list (named by
     the id's short, filesystem-safe form; see ``packaging.bundle_dir_name``).
     Memoised per submission (``(id(app), entry_file, job_name, canonical_json(args), sorted
     extra_assets uris)``) so re-submitting the same job with the same args AND the