simulo-interfaces 0.10.0__tar.gz → 0.11.0__tar.gz

{simulo_interfaces-0.10.0/src/simulo_interfaces.egg-info → simulo_interfaces-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo-interfaces
-Version: 0.10.0
+Version: 0.11.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
@@ -16,13 +16,14 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Provides-Extra: dev
-Requires-Dist: black>=24.0; extra == "dev"
-Requires-Dist: isort>=5.13; extra == "dev"
-Requires-Dist: ruff>=0.5; extra == "dev"
-Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: black==26.5.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"
 Requires-Dist: pytest>=8.2; extra == "dev"
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.1; extra == "dev"
+Requires-Dist: packaging>=23; extra == "dev"
 Provides-Extra: release
 Requires-Dist: commitizen>=3.27; extra == "release"
 Requires-Dist: build>=1.2; extra == "release"

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo-interfaces"
-version = "0.10.0"
+version = "0.11.0"
 description = "Type contracts for the Simulo SDK. Installed automatically as a dependency of the simulo package."
 readme = "PYPI.md"
 requires-python = ">=3.11"
@@ -26,7 +26,16 @@ classifiers = [
 dependencies = []
 
 [project.optional-dependencies]
-dev = ["black>=24.0", "isort>=5.13", "ruff>=0.5", "mypy>=1.10", "pytest>=8.2", "build>=1.2", "twine>=5.1"]
+# black/isort/ruff/mypy pinned EXACT, not >=: see simulo-backend/pyproject.toml's
+# `dev` extra for the full rationale (2026-08-01 ruff 0.15.21->0.16.1 CI incident).
+# Keep in lockstep with `.github/workflows/simulo-interfaces-ci.yml`'s
+# `ruff`/`black`/`isort`/`mypy` steps, which resolve their versions from THIS extra
+# (`pip install -e ".[dev]"`).
+dev = ["black==26.5.1", "isort==8.0.1", "ruff==0.15.21", "mypy==2.3.0", "pytest>=8.2", "build>=1.2",
+       "twine>=5.1", "packaging>=23"]
+# `packaging` is a direct test dependency, not incidental: the consumer-pin guard parses
+# PEP 508 requirements with it. It arrives transitively via pytest today, which is exactly
+# why it is declared here — a transitive dep that disappears takes the guard with it.
 # `dev` carries build/twine but deliberately not commitizen; `release` below
 # adds commitizen for cutting version bumps without a second build/twine copy.
 release = ["commitizen>=3.27", "build>=1.2", "twine>=5.1"]

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/authoring/__init__.py

@@ -11,9 +11,10 @@ working because only this definition exists.
 
 Relocated so far — Wave C1: ``pose`` (``Pose``), ``materials`` (``Material``,
 ``SurfaceMaterial``), ``physics`` (``Physics``, ``Collision``, ``RigidPhysics``,
-``DeformableMaterial``, ``DeformablePhysics``), ``asset`` (``Asset``,
+``DeformableMaterial``, ``DeformablePhysics``), ``asset`` (``AssetSource``,
 ``USDAsset``, ``URDFAsset`` — the model-source specs, distinct from the thin
-client's registry-handle ``simulo.Asset``), and ``light`` (``Light``,
+client's registry-handle ``simulo.Asset``; renamed from ``Asset`` — owner
+decision — to resolve that exact name collision), and ``light`` (``Light``,
 ``LightConfig``, ``DistantLight``, ``DomeLight``). Wave C2: ``terrain``
 (``Terrain``, ``TerrainConfig``, ``GroundPlane``, ``SubTerrainConfig``,
 ``RoughTerrain``), ``primitives`` (``PrimitiveShape``, ``Cone``,
@@ -85,7 +86,7 @@ docstring, is the source of truth for what lands here and when.
 """
 
 from simulo.interfaces.authoring.actuator import ActuatorProtocol
-from simulo.interfaces.authoring.asset import Asset, URDFAsset, USDAsset
+from simulo.interfaces.authoring.asset import AssetSource, URDFAsset, USDAsset
 from simulo.interfaces.authoring.entity import AssetEntity, Entity
 from simulo.interfaces.authoring.light import DistantLight, DomeLight, Light, LightConfig
 from simulo.interfaces.authoring.materials import Material, SurfaceMaterial
@@ -139,7 +140,7 @@ __all__ = [
     "DeformablePhysics",
     "Physics",
     # asset (model-source specs)
-    "Asset",
+    "AssetSource",
     "USDAsset",
     "URDFAsset",
     # light

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/authoring/asset.py

@@ -1,10 +1,16 @@
 """Model-source asset specs — USD/URDF sources a scene loads.
 
-Owns the canonical ``Asset`` / ``USDAsset`` / ``URDFAsset`` model-source
+Owns the canonical ``AssetSource`` / ``USDAsset`` / ``URDFAsset`` model-source
 dataclasses. Distinct from the thin client's user-facing ``simulo.Asset``
 registry handle (a catalog ref like ``robot/so-arm-100:v3``): these classes
 name a USD/URDF *file source* to load into a scene, and the backend consumes
 them when it builds the simulation.
+
+Renamed from ``Asset`` (owner decision): the old name collided with the
+thin client's registry-handle ``simulo.Asset`` — same name, different
+constructor, different members, both user-facing. Nothing failed on the
+collision (both expose ``.usd()``/``.urdf()``, the handle's just returns
+``Any``), which is exactly why it was worth a rename rather than a shim.
 """
 
 from dataclasses import dataclass
@@ -12,16 +18,16 @@ from typing import TYPE_CHECKING
 
 
 @dataclass
-class Asset:
-    """Base asset class."""
+class AssetSource:
+    """Base model-source asset class."""
 
     if TYPE_CHECKING:
-        # ``Asset.usd`` / ``Asset.urdf`` are attached dynamically below (they
-        # return the ``USDAsset`` / ``URDFAsset`` subclasses, which are defined
-        # after this class). These declarations never execute; they exist so a
-        # type checker sees the convenience aliases with their precise
-        # signatures instead of rejecting ``Asset.usd(...)`` as an unknown
-        # attribute.
+        # ``AssetSource.usd`` / ``AssetSource.urdf`` are attached dynamically
+        # below (they return the ``USDAsset`` / ``URDFAsset`` subclasses,
+        # which are defined after this class). These declarations never
+        # execute; they exist so a type checker sees the convenience aliases
+        # with their precise signatures instead of rejecting
+        # ``AssetSource.usd(...)`` as an unknown attribute.
         @classmethod
         def usd(cls, path: str) -> "USDAsset": ...
 
@@ -30,7 +36,7 @@ class Asset:
 
 
 @dataclass
-class USDAsset(Asset):
+class USDAsset(AssetSource):
     """USD file asset.
 
     Attributes:
@@ -59,7 +65,7 @@ class USDAsset(Asset):
 
 
 @dataclass
-class URDFAsset(Asset):
+class URDFAsset(AssetSource):
     """URDF file asset.
 
     Attributes:
@@ -81,12 +87,13 @@ class URDFAsset(Asset):
         return cls(path=path)
 
 
-# Alias for convenience — callers reach for `Asset.usd(...)` / `Asset.urdf(...)`.
-# Attached dynamically; the TYPE_CHECKING declarations on Asset above are what
-# let a type checker see them.
-Asset.usd = USDAsset.usd  # type: ignore[method-assign]
-Asset.urdf = URDFAsset.urdf  # type: ignore[method-assign]
+# Alias for convenience — callers reach for `AssetSource.usd(...)` /
+# `AssetSource.urdf(...)`.
+# Attached dynamically; the TYPE_CHECKING declarations on AssetSource above
+# are what let a type checker see them.
+AssetSource.usd = USDAsset.usd  # type: ignore[method-assign]
+AssetSource.urdf = URDFAsset.urdf  # type: ignore[method-assign]
 
 # Explicit public surface — keeps the TYPE_CHECKING import (needed for the
 # static-only `usd`/`urdf` declarations above) off the star-import namespace.
-__all__ = ["Asset", "USDAsset", "URDFAsset"]
+__all__ = ["AssetSource", "USDAsset", "URDFAsset"]

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/authoring/entity.py

@@ -3,7 +3,7 @@
 from dataclasses import dataclass, field
 from typing import Optional, Tuple
 
-from simulo.interfaces.authoring.asset import Asset
+from simulo.interfaces.authoring.asset import AssetSource
 from simulo.interfaces.authoring.materials import Material
 from simulo.interfaces.authoring.physics import DeformablePhysics, RigidPhysics
 from simulo.interfaces.authoring.pose import Pose
@@ -147,7 +147,7 @@ class Entity:
     @staticmethod
     def from_asset(
         name: str,
-        asset: Asset,
+        asset: AssetSource,
         pose: Optional[Pose] = None,
     ) -> "AssetEntity":
         """Create an entity from a USD or URDF asset.
@@ -177,4 +177,4 @@ class AssetEntity(Entity):
             existing dataclass field ordering. Callers always supply this.
     """
 
-    asset: Optional[Asset] = None
+    asset: Optional[AssetSource] = None

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/authoring/robot.py

@@ -61,7 +61,7 @@ entry in the backend conformance test's documented-omissions allowlist):
 
 from typing import Any, Dict, List, Optional, Protocol, Tuple, runtime_checkable
 
-from simulo.interfaces.authoring.asset import Asset
+from simulo.interfaces.authoring.asset import AssetSource
 from simulo.interfaces.authoring.pose import Pose
 from simulo.interfaces.runtime.tensors import TensorLike
 
@@ -142,7 +142,7 @@ class RobotProtocol(Protocol):
     # -- Construction-time configuration (plain data members: genuinely
     # -- mutable attributes on the implementation, per mirror-fidelity rule).
 
-    asset: Asset
+    asset: AssetSource
     """Model source (USD or URDF) defining the robot."""
 
     initial_pose: Pose

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/platform/__init__.py

@@ -112,9 +112,13 @@ from simulo.interfaces.platform.manifest import (
 )
 from simulo.interfaces.platform.runs import (
     JOB_CANCEL_ROUTE_TEMPLATE,
+    JOB_LIST_SCOPES,
     JOB_LOGS_ROUTE_TEMPLATE,
     JOB_RESULT_ROUTE_TEMPLATE,
     JOB_ROUTE_TEMPLATE,
+    JOB_SCOPE_MINE,
+    JOB_SCOPE_ORG,
+    JOB_SCOPE_QUERY_PARAM,
     JOBS_API_DEFAULT_PORT,
     JOBS_ROUTE,
     LOG_CHUNK_MAX_BYTES,
@@ -216,6 +220,11 @@ __all__ = [
     "JOB_RESULT_ROUTE_TEMPLATE",
     "LOG_CHUNK_MAX_BYTES",
     "LOG_TAIL_MAX_BYTES",
+    # user scoping (issue #651)
+    "JOB_SCOPE_QUERY_PARAM",
+    "JOB_SCOPE_MINE",
+    "JOB_SCOPE_ORG",
+    "JOB_LIST_SCOPES",
     # submit / worker / recordings wire contract (PR-0)
     "PACKAGES_ROUTE",
     "PACKAGE_ARCHIVE_ROUTE_TEMPLATE",

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/platform/asset.py

@@ -7,8 +7,8 @@ from typing import Protocol, runtime_checkable
 class AssetProtocol(Protocol):
     """Read-only mounted cloud resource handle (Rule #6). FORWARD.
 
-    Distinct from ``simulo.interfaces.authoring.asset.Asset`` (a USD/URDF
-    model-source simulation asset).
+    Distinct from ``simulo.interfaces.authoring.asset.AssetSource`` (a
+    USD/URDF model-source simulation asset).
 
     This is the user-facing *handle* protocol; the asset-catalog **wire**
     contract (ref grammar, routes, caps, wire dataclasses) lives in

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo/interfaces/platform/runs.py

@@ -92,6 +92,31 @@ That scoping is additive at the transport layer: the :class:`JobRecord`
 fields and route shapes defined here do not change, only the server-side
 filtering they are evaluated under.
 
+**User scoping (``?scope=``, additive):** within one organization,
+``GET /v1/jobs`` and every per-job route (``{job_id}``, ``{job_id}/logs``,
+``{job_id}/result``, and the sibling recordings/models/artifacts/view-session
+routes documented in ``submit.py``) additionally accept an optional
+``?scope=mine|org`` query parameter, resolved server-side:
+
+* ``mine`` (the default — the value an old client that never sends the
+  parameter gets) — only jobs this caller themselves submitted
+  (``submitted_by_user_id`` on the job row).
+* ``org`` — every job in the caller's organization. An explicit opt-in,
+  never the default, and available to any active member (no additional role
+  beyond org membership — the platform's existing flat-permission model for
+  jobs, ``JOB_CREATE_ROLES``/``JOB_CANCEL_ROLES``).
+* any other value → 422 (Job.md "List All Jobs Using CLI" AF-3, invalid
+  filter option).
+
+``POST /v1/jobs/{job_id}/cancel`` is a deliberate exception: it is NOT scope-
+gated and keeps resolving org-wide regardless of ``?scope=`` — any active
+member may cancel any job in their org, matching cancel's existing,
+unchanged authorization model.
+
+:class:`JobRecord` gains ``submitted_by_user_id`` (below) precisely so an
+``org``-scoped listing is attributable — a shared view of everyone's jobs
+must say whose job each row is.
+
 Errors use the platform-standard shape (NFR contract)::
 
     {"error": {"code": "job_not_found", "message": "...", "request_id": "req_..."}}
@@ -125,9 +150,20 @@ JOB_RESULT_ROUTE_TEMPLATE = "/v1/jobs/{job_id}/result"
 #: executor); 202 ``{"cancel_requested": true}`` (running — the executor
 #: stops it within one heartbeat interval); 409 ``job_not_running``
 #: (already terminal); 404 ``job_not_found``. Full semantics in the module
-#: docstring above.
+#: docstring above. NOT scope-gated (module docstring's "User scoping" note)
+#: — cancel keeps resolving org-wide regardless of ``?scope=``.
 JOB_CANCEL_ROUTE_TEMPLATE = "/v1/jobs/{job_id}/cancel"
 
+#: The ``?scope=`` query parameter name accepted by ``GET /v1/jobs`` and
+#: every per-job read route (module docstring's "User scoping" section).
+JOB_SCOPE_QUERY_PARAM = "scope"
+#: Default / explicit-opt-in-only values for :data:`JOB_SCOPE_QUERY_PARAM`.
+JOB_SCOPE_MINE = "mine"
+JOB_SCOPE_ORG = "org"
+#: The closed domain of ``?scope=`` — any other value is a 422 (Job.md "List
+#: All Jobs Using CLI" AF-3).
+JOB_LIST_SCOPES = (JOB_SCOPE_MINE, JOB_SCOPE_ORG)
+
 #: Upper bound on the log bytes a single ``/logs`` response carries. The server
 #: may return fewer bytes (never more); clients keep reading from ``next_offset``.
 #: This is a server-side response-size POLICY value, not a structural wire
@@ -247,6 +283,18 @@ class JobRecord:
     whenever :attr:`status_reason` is ``None``. Engine-neutral by contract (a user
     surface: never names the underlying simulation runtime)."""
 
+    submitted_by_user_id: Optional[str] = None
+    """Id of the user who submitted this run, or ``None`` when unknown (the
+    submitting user's account was later deleted — the id column is nullable
+    with ``ON DELETE SET NULL``, so a job's provenance can outlive the user).
+
+    Additive + tolerant like ``assets``/``seed``/``status_reason``: a control
+    plane that predates the field omits it and a consumer sees the ``None``
+    default. Populated on every record regardless of ``?scope=`` — it is what
+    makes an ``org``-scoped listing attributable (module docstring's "User
+    scoping" section): a shared view of everyone's jobs must say whose job
+    each row is, not just that it exists."""
+
     outputs: Optional[JobOutputsSummary] = None
     """Typed outputs summary of the run — a **rendering input,
     never a status**: ``completed ⚠ 1 anomaly`` is drawn from here while

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0/src/simulo_interfaces.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo-interfaces
-Version: 0.10.0
+Version: 0.11.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
@@ -16,13 +16,14 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Provides-Extra: dev
-Requires-Dist: black>=24.0; extra == "dev"
-Requires-Dist: isort>=5.13; extra == "dev"
-Requires-Dist: ruff>=0.5; extra == "dev"
-Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: black==26.5.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"
 Requires-Dist: pytest>=8.2; extra == "dev"
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.1; extra == "dev"
+Requires-Dist: packaging>=23; extra == "dev"
 Provides-Extra: release
 Requires-Dist: commitizen>=3.27; extra == "release"
 Requires-Dist: build>=1.2; extra == "release"

{simulo_interfaces-0.10.0 → simulo_interfaces-0.11.0}/src/simulo_interfaces.egg-info/requires.txt

@@ -1,12 +1,13 @@
 
 [dev]
-black>=24.0
-isort>=5.13
-ruff>=0.5
-mypy>=1.10
+black==26.5.1
+isort==8.0.1
+ruff==0.15.21
+mypy==2.3.0
 pytest>=8.2
 build>=1.2
 twine>=5.1
+packaging>=23
 
 [release]
 commitizen>=3.27