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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo-interfaces
-Version: 0.10.0
+Version: 0.12.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.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo-interfaces"
-version = "0.10.0"
+version = "0.12.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,19 @@ 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 >=: these are rule-set tools whose
+# defaults change between releases, so an unbounded lower bound lets CI silently
+# resolve a newer release than a developer's environment has — "clean locally" and
+# "hundreds of errors in CI" both true of one commit (2026-08-01: ruff 0.15.21 ->
+# 0.16.1 flagged 1088 findings from new default rules, zero of them real).
+# 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.12.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
@@ -105,10 +106,11 @@ from simulo.interfaces.authoring.primitives import (
     Sphere,
     Transform,
 )
+from simulo.interfaces.authoring.prop import PropProtocol, PropStateProtocol
 from simulo.interfaces.authoring.record import RecordConfig
 from simulo.interfaces.authoring.robot import RobotProtocol, RobotStateProtocol
 from simulo.interfaces.authoring.scene import SceneGroupProtocol, SceneProtocol
-from simulo.interfaces.authoring.sensor import CameraProtocol, SensorProtocol
+from simulo.interfaces.authoring.sensor import CameraProtocol
 from simulo.interfaces.authoring.terrain import (
     GroundPlane,
     RoughTerrain,
@@ -139,7 +141,7 @@ __all__ = [
     "DeformablePhysics",
     "Physics",
     # asset (model-source specs)
-    "Asset",
+    "AssetSource",
     "USDAsset",
     "URDFAsset",
     # light
@@ -179,11 +181,12 @@ __all__ = [
     # scene (MIRROR — the concrete classes live in the backend package)
     "SceneProtocol",
     "SceneGroupProtocol",
-    # robot / sensor / actuator (MIRROR — the concrete classes live in the
-    # backend package and explicitly inherit these Protocols)
+    # robot / prop / sensor / actuator (MIRROR — the concrete classes live in
+    # the backend package and explicitly inherit these Protocols)
     "RobotProtocol",
     "RobotStateProtocol",
-    "SensorProtocol",
+    "PropProtocol",
+    "PropStateProtocol",
     "CameraProtocol",
     "ActuatorProtocol",
 ]

{simulo_interfaces-0.10.0 → simulo_interfaces-0.12.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.12.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.12.0}/src/simulo/interfaces/authoring/pose.py

@@ -17,8 +17,8 @@ class Pose:
         xyz: Position as (x, y, z)
         quat_wxyz: Orientation as quaternion (w, x, y, z)
 
-    Example:
-        ```python
+    Example::
+
         # Using named arguments
         pose = Pose(position=[0.5, 0.3, 0.7], orientation=[1, 0, 0, 0])
 
@@ -27,7 +27,6 @@ class Pose:
 
         # Position only (identity rotation)
         pose = Pose.from_xyz(0.5, 0.3, 0.7)
-        ```
     """
 
     xyz: Tuple[float, float, float] = (0.0, 0.0, 0.0)

simulo_interfaces-0.12.0/src/simulo/interfaces/authoring/prop.py

@@ -0,0 +1,210 @@
+"""``PropProtocol`` — the declared contract for a movable scene prop.
+
+A MIRROR, not a relocation (the same mechanism as the Robot and Scene
+contracts in this package): the concrete ``Prop`` implementation stays in the
+backend package, because reading and writing a prop's pose reaches through a
+live engine handle and cannot exist in a zero-dependency package. What CAN
+live here is the declared public surface — what a prop is constructed from,
+how its live state is read, and how its pose is written.
+
+Why this contract exists at all
+-------------------------------
+
+A scene holds two kinds of movable thing: robots, which the simulation drives
+through joints, and *props* — the block on the table, the crate to push, the
+ball to catch. Robots have carried a full pose surface since the beginning
+(``robot.state.pose``, ``set_root_pose``, ``reset``). Props carried none: a
+shape handed to ``scene.add(...)`` is pure authoring data, so the only way to
+reach the spawned body's pose was the engine-private scene index.
+
+That gap is what kept manipulation demos *scripted*. An episodic task must
+re-randomise its object at the start of every episode and read the object's
+height back to score the lift — both of which are prop pose access. This
+contract closes it.
+
+``PrimitiveShape``, not every entity
+------------------------------------
+
+A prop is built from a :class:`~simulo.interfaces.authoring.primitives.PrimitiveShape`
+carrying **rigid** physics. That restriction is the honest one rather than a
+convenience: a pose that can be read and written is the simulation's own
+rigid-body state, and only a rigid body has one. A visual-only shape (no
+physics) and a deformable one have no rigid-body pose to write, so the
+implementation refuses them at construction, naming the prop — rather than
+accepting them and silently doing nothing at reset time, which would surface
+much later as "my object never moves".
+
+A shape that only needs to be *visible* does not need a prop at all: hand it
+straight to ``scene.add(shape, at=...)`` exactly as before. ``Prop`` is
+strictly the opt-in for "I also need to read or write where this thing is".
+
+Tensors, not ``Pose``
+---------------------
+
+Every batched member here is ``TensorLike`` with the environment count as its
+leading dimension, and the write methods take the same. ``Pose`` remains the
+*authoring* type — where the prop spawns, written once as
+``Cuboid(pose=Pose.from_xyz(...))``. It is deliberately NOT the runtime type:
+a ``Pose`` is one pose, and the entire purpose of this surface is giving each
+of thousands of environments a *different* pose on the same call. See
+``PropProtocol.set_pose`` for the full reasoning.
+
+Enforcement is the standard four layers for a mirror — the type checker alone
+is NOT sufficient (measured on the Scene mirror): mypy catches signature
+*shape* divergence at the backend definition site but is silent on parameter
+renames and on a property degrading to a plain attribute. Those are caught by
+the signature-conformance test in the backend package's suite (per-member,
+both directions, plus member-set equality with a pinned omissions allowlist),
+and the constructor is pinned separately by a ``__call__``-Protocol in the
+backend's static conformance checks (type checkers exempt ``__init__`` from
+override checks). The Protocol stays structural for any other implementer.
+"""
+
+from typing import Optional, Protocol, runtime_checkable
+
+from simulo.interfaces.authoring.primitives import PrimitiveShape
+from simulo.interfaces.runtime.tensors import TensorLike
+
+
+@runtime_checkable
+class PropStateProtocol(Protocol):
+    """The live prop-state contract — batched, read-only, zero-copy.
+
+    Obtained from a prop as ``prop.state``; never constructed directly. The
+    three members are exactly the rigid-body half of
+    :class:`~simulo.interfaces.authoring.robot.RobotStateProtocol` and carry
+    the same names for the same quantities — a prop has no joints, so the
+    three joint members simply do not appear. Code that reads
+    ``robot.state.pose`` reads ``prop.state.pose`` identically.
+
+    Each member is a live view of the simulation's own state buffers: reading
+    one returns the current values without copying, at the same cost inside a
+    training loop's hot path as anywhere else. All members carry the
+    environment batch as their leading dimension (the scene's ``num_envs``).
+
+    **Read a member each time you need it — do not hold the returned tensor
+    across steps, and do not write into it.** The tensor IS the simulation's
+    own memory: the engine refreshes these buffers by rebinding them to new
+    tensors, so a tensor held across a step can silently serve stale values,
+    and writing into one writes into the simulation. The accessor
+    (``prop.state`` itself) may be held freely.
+
+    Members raise ``RuntimeError`` until the simulation runtime has attached
+    the prop — read them from ``on_start`` onward. The ``state`` accessor
+    itself is always available and is the same object on every access.
+    """
+
+    @property
+    def pose(self) -> TensorLike:
+        """Pose in the world frame, shape ``(num_envs, 7)``:
+        ``[x, y, z, qw, qx, qy, qz]`` (position + w-first quaternion)."""
+        ...
+
+    @property
+    def linear_velocity(self) -> TensorLike:
+        """Linear velocity in the world frame, shape ``(num_envs, 3)``:
+        ``[vx, vy, vz]``."""
+        ...
+
+    @property
+    def angular_velocity(self) -> TensorLike:
+        """Angular velocity in the world frame, shape ``(num_envs, 3)``:
+        ``[wx, wy, wz]``."""
+        ...
+
+
+@runtime_checkable
+class PropProtocol(Protocol):
+    """The prop authoring contract — a rigid body whose pose you can read and write.
+
+    This is the surface authoring code may rely on when it creates a prop,
+    adds it to a scene, and moves it: the shape it was built from, its
+    identity in the scene, its live state, its spawn pose, and the pose /
+    velocity writes an episodic reset needs.
+    """
+
+    # -- Construction-time configuration ----------------------------------
+
+    shape: PrimitiveShape
+    """The primitive shape this prop spawns, carrying its size, material, and
+    rigid physics. The shape's own ``pose`` is where the prop spawns."""
+
+    # -- Identity and attachment ------------------------------------------
+
+    @property
+    def name(self) -> Optional[str]:
+        """Prop name — taken from the shape, or set by the scene when added."""
+        ...
+
+    @property
+    def path(self) -> Optional[str]:
+        """Scene path — set by the scene when the prop is added."""
+        ...
+
+    @property
+    def state(self) -> PropStateProtocol:
+        """The grouped live prop state — the supported, typed state surface.
+
+        Always available (the accessor is the same object on every access);
+        its members read straight through to the simulation's state buffers
+        and raise ``RuntimeError`` until the simulation runtime has attached
+        the prop — read them from ``on_start`` onward.
+        """
+        ...
+
+    @property
+    def default_pose(self) -> TensorLike:
+        """The prop's spawn pose in the **world** frame, ``(num_envs, 7)``.
+
+        The pose the prop was authored at, already offset by each
+        environment's own origin — so it is directly comparable with
+        ``state.pose`` and directly usable as the base for a randomised
+        reset. Index it with the environments being reset
+        (``prop.default_pose[env_ids]``), perturb, and write it back with
+        :meth:`set_pose`.
+
+        Raises ``RuntimeError`` until the simulation runtime has attached the
+        prop.
+        """
+        ...
+
+    # -- Pose writes ------------------------------------------------------
+
+    def set_pose(self, pose: TensorLike, env_ids: Optional[TensorLike] = ...) -> None:
+        """Write the prop's pose directly (teleport, not control), world frame.
+
+        Args:
+            pose: ``(num_envs, 7)`` — or ``(len(env_ids), 7)`` when ``env_ids``
+                is given — as ``[x, y, z, qw, qx, qy, qz]``.
+            env_ids: Environment indices to write; ``None`` writes every
+                environment. Passing the subset being reset is what makes a
+                partial episodic reset possible: the environments that did not
+                finish keep the pose they had.
+        """
+        ...
+
+    def set_velocity(self, velocity: TensorLike, env_ids: Optional[TensorLike] = ...) -> None:
+        """Write the prop's velocity directly (teleport, not control), world frame.
+
+        Args:
+            velocity: ``(num_envs, 6)`` — or ``(len(env_ids), 6)`` when
+                ``env_ids`` is given — as ``[vx, vy, vz, wx, wy, wz]``.
+            env_ids: Environment indices to write; ``None`` writes every
+                environment.
+
+        A reset that moves a prop should zero its velocity too, or the body
+        arrives at its new pose still carrying the momentum it had at the end
+        of the previous episode.
+        """
+        ...
+
+    # -- Lifecycle --------------------------------------------------------
+
+    def reset(self, env_ids: Optional[TensorLike] = ...) -> None:
+        """Return the prop to its spawn pose with zero velocity.
+
+        Args:
+            env_ids: Environment indices to reset; ``None`` resets every
+                environment.
+        """
+        ...

{simulo_interfaces-0.10.0 → simulo_interfaces-0.12.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.12.0}/src/simulo/interfaces/platform/__init__.py

@@ -7,7 +7,6 @@ implementation-free — concrete behaviour lives in the future
 ``simulo`` client and the ``simulo-backend`` SDK.
 """
 
-from simulo.interfaces.platform.app import AppProtocol, JobFunctionProtocol, Mount
 from simulo.interfaces.platform.artifacts import (
     DECLARED_OUTPUT_MISSING_CODE,
     JOB_ARTIFACT_DOWNLOAD_ROUTE_TEMPLATE,
@@ -97,7 +96,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 ArtifactKind, JobStatus, ResourceKind, ResumePolicy
+from simulo.interfaces.platform.enums import ArtifactKind
 from simulo.interfaces.platform.manifest import (
     FINDING_CLASSIFICATIONS,
     MAX_PREFLIGHT_BODY_BYTES,
@@ -112,15 +111,18 @@ 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,
     LOG_TAIL_MAX_BYTES,
     TERMINAL_JOB_STATUSES,
-    JobRecord,
 )
 from simulo.interfaces.platform.runtime import RuntimeProtocol
 from simulo.interfaces.platform.submit import (
@@ -154,8 +156,6 @@ from simulo.interfaces.platform.submit import (
     WORKER_JOB_RECORDINGS_PRESIGN_ROUTE_TEMPLATE,
     WORKER_JOB_RECORDINGS_ROUTE_TEMPLATE,
     WORKER_LEASE_HEADER,
-    ModelRecord,
-    RecordingRecord,
     canonical_pypi_name,
     is_platform_pinned,
 )
@@ -163,9 +163,6 @@ from simulo.interfaces.platform.volume import VolumeProtocol
 
 __all__ = [
     # enums
-    "JobStatus",
-    "ResumePolicy",
-    "ResourceKind",
     "ArtifactKind",
     # domain dataclasses
     "Tag",
@@ -206,7 +203,6 @@ __all__ = [
     "OUTPUT_FLAG_ANOMALY",
     "DECLARED_OUTPUT_MISSING_CODE",
     # job-run contract (run record schema + jobs HTTP API shape)
-    "JobRecord",
     "TERMINAL_JOB_STATUSES",
     "JOBS_API_DEFAULT_PORT",
     "JOBS_ROUTE",
@@ -216,6 +212,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",
@@ -240,8 +241,6 @@ __all__ = [
     "MAX_COMPLETE_MESSAGE_CHARS",
     "MAX_COMPLETE_REASON_CODE_CHARS",
     "MODEL_KINDS",
-    "ModelRecord",
-    "RecordingRecord",
     "RESERVED_RUNTIME_ENV_KEYS",
     "RESERVED_RUNTIME_ENV_PREFIXES",
     "PLATFORM_PINNED_PACKAGES",
@@ -328,9 +327,6 @@ __all__ = [
     "AssetProtocol",
     "VolumeProtocol",
     "JobCallbackProtocol",
-    "JobFunctionProtocol",
-    "AppProtocol",
-    "Mount",
     "DebugSessionProtocol",
     "ReplaySessionProtocol",
     "VisualizationSessionProtocol",

{simulo_interfaces-0.10.0 → simulo_interfaces-0.12.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.12.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.12.0}/src/simulo/interfaces/runtime/__init__.py

@@ -28,14 +28,13 @@ from simulo.interfaces.runtime.policy import PolicyProtocol
 from simulo.interfaces.runtime.scenario import ScenarioProtocol
 from simulo.interfaces.runtime.task import TaskProtocol
 from simulo.interfaces.runtime.tensors import TensorLike
-from simulo.interfaces.runtime.trainer import PolicyExporterProtocol, TrainerProtocol
+from simulo.interfaces.runtime.trainer import TrainerProtocol
 
 __all__ = [
     "TensorLike",
     "TaskProtocol",
     "PolicyProtocol",
     "TrainerProtocol",
-    "PolicyExporterProtocol",
     "PlayerProtocol",
     "LearningEnvProtocol",
     "ScenarioProtocol",

{simulo_interfaces-0.10.0 → simulo_interfaces-0.12.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.12.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.12.0}/src/simulo_interfaces.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ src/simulo/interfaces/authoring/materials.py
 src/simulo/interfaces/authoring/physics.py
 src/simulo/interfaces/authoring/pose.py
 src/simulo/interfaces/authoring/primitives.py
+src/simulo/interfaces/authoring/prop.py
 src/simulo/interfaces/authoring/record.py
 src/simulo/interfaces/authoring/robot.py
 src/simulo/interfaces/authoring/scene.py

{simulo_interfaces-0.10.0 → simulo_interfaces-0.12.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