reactor-runtime 3.2.0__tar.gz → 3.2.2__tar.gz

{reactor_runtime-3.2.0 → reactor_runtime-3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactor-runtime
-Version: 3.2.0
+Version: 3.2.2
 Summary: A Python framework for building real-time, interactive video models
 Author: Reactor
 Author-email: Reactor <team@reactor.inc>
@@ -18,7 +18,7 @@ Requires-Dist: numpy>=2.1
 Requires-Dist: prometheus-client>=0.26.0
 Requires-Dist: protobuf>=7.35.1
 Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: reactor-webrtc==0.10.0
+Requires-Dist: reactor-webrtc==0.12.0
 Requires-Dist: uvicorn>=0.49.0
 Requires-Python: >=3.12
 Project-URL: Source, https://github.com/reactor-team/reactor-runtime

{reactor_runtime-3.2.0 → reactor_runtime-3.2.2}/pyproject.toml

@@ -92,7 +92,7 @@ pythonpath = ["."]
 
 [project]
 name = "reactor-runtime"
-version = "3.2.0"
+version = "3.2.2"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"
@@ -115,7 +115,7 @@ dependencies = [
     "prometheus-client>=0.26.0",
     "protobuf>=7.35.1",
     "pyyaml>=6.0.3",
-    "reactor-webrtc==0.10.0",
+    "reactor-webrtc==0.12.0",
     "uvicorn>=0.49.0",
 ]
 

{reactor_runtime-3.2.0 → reactor_runtime-3.2.2}/pyproject.toml.orig

@@ -20,7 +20,7 @@ version = "1.20260814.7"
 
 [project]
 name = "reactor-runtime"
-version = "3.2.0"
+version = "3.2.2"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"
@@ -41,7 +41,7 @@ dependencies = [
     "prometheus-client>=0.26.0",
     "protobuf>=7.35.1",
     "pyyaml>=6.0.3",
-    "reactor-webrtc==0.10.0",
+    "reactor-webrtc==0.12.0",
     "uvicorn>=0.49.0",
 ]
 

{reactor_runtime-3.2.0 → reactor_runtime-3.2.2}/src/reactor_runtime/core/values.py

@@ -64,11 +64,24 @@ class InputFrame:
         metadata: What the sender attached to this frame, as the bytes it sent,
             or ``None`` for a frame that carried nothing. Decoding them is the
             model's business: the transport treats them as opaque.
+        capture_time_us: When the sender says this frame was captured, in
+            microseconds, or ``None`` for a frame that carried no stamp. The value
+            the sender declared, unrounded — a client that stamps several tracks
+            from one clock reading therefore delivers that one value on all of
+            them, which is what makes a multi-camera capture readable as a single
+            moment. A sender that declares nothing has its transport read a clock
+            for it, so a stamped frame is the normal case. It rides with the
+            metadata, so a sender or a transport that carries neither leaves both
+            unset. Unlike ``pts``, it is a reading of another machine's clock:
+            differences between stamps from one sender are that source's own
+            timing, while anything subtracted from a local clock is mostly the
+            offset between two clocks that drift independently.
     """
 
     data: npt.NDArray[Any]
     pts: float | None = None
     metadata: bytes | None = None
+    capture_time_us: int | None = None
 
 
 class TrackKind(StrEnum):

{reactor_runtime-3.2.0 → reactor_runtime-3.2.2}/src/reactor_runtime/transport/webrtc/peer.py

@@ -581,8 +581,10 @@ class WebRTCPeer:
     ) -> Callable[[bytes, int, int, rw.FrameMetadata | None], None]:
         """Build the callback that turns one decoded video frame into an InputFrame.
 
-        The fourth argument is the metadata the sender attached, when the trailer
-        was there to read and the receiver transform is in place to strip it.
+        The fourth argument is the trailer the sender attached, when it was there
+        to read and the receiver transform is in place to strip it. It carries the
+        sender's own bytes and, beside them, the capture time the sender declared
+        for the frame, which reaches the model as that frame's capture time.
         """
 
         def sink(
@@ -591,10 +593,14 @@ class WebRTCPeer:
             if self._stop_event.is_set():
                 return
             metadata = bytes(meta.user_data) if meta is not None else b""
+            # Zero is the trailer's "unset", and it is not a clock reading: a frame
+            # captured at the epoch is not what a sender means by it.
+            capture_us = meta.capture_time_us if meta is not None else 0
             frame = InputFrame(
                 data=bgra_to_rgb(bgra, width, height),
                 # An empty trailer is a frame the sender attached nothing to.
                 metadata=metadata or None,
+                capture_time_us=capture_us or None,
             )
             self._fire(self._cb_media, name, frame)