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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactor-runtime
-Version: 3.2.0
+Version: 3.2.1
 Summary: A Python framework for building real-time, interactive video models
 Author: Reactor
 Author-email: Reactor <team@reactor.inc>

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

@@ -92,7 +92,7 @@ pythonpath = ["."]
 
 [project]
 name = "reactor-runtime"
-version = "3.2.0"
+version = "3.2.1"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"

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

@@ -20,7 +20,7 @@ version = "1.20260814.7"
 
 [project]
 name = "reactor-runtime"
-version = "3.2.0"
+version = "3.2.1"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"

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

@@ -64,11 +64,21 @@ 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: The microsecond the sender stamped this frame as it went
+            to the wire — its capture instant for a source that sends as it
+            captures — or ``None`` for a frame that carried no stamp. The wire
+            value, unrounded, in the unit the sender's own SDK works in. 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.1}/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 microsecond the sender stamped
+        the frame at, which reaches the model as that frame's capture time.
         """
 
         def sink(
@@ -591,10 +593,15 @@ class WebRTCPeer:
             if self._stop_event.is_set():
                 return
             metadata = bytes(meta.user_data) if meta is not None else b""
+            # The trailer leaves the stamp zero when the sender set none. Zero is
+            # not a clock reading, so it is the absence of a stamp rather than a
+            # frame captured at the epoch.
+            capture_us = meta.timestamp 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)