reactor-runtime 3.8.2__tar.gz → 3.8.3__tar.gz

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactor-runtime
-Version: 3.8.2
+Version: 3.8.3
 Summary: A Python framework for building real-time, interactive video models
 Author: Reactor
 Author-email: Reactor <team@reactor.inc>
@@ -124,6 +124,8 @@ class MyModel(ReactorApp):
 
 Command handlers and lifecycle hooks run between steps, never during one. A model has one method per lifecycle hook kind (`@session_started`, `@session_ended`, `@connected`, `@disconnected`, `@file_uploaded`). A subclass extends an inherited hook by overriding that method and calling `super()`; the override runs whether or not it repeats the decorator. Marking a second method with the same kind, in one class or in a subclass, fails when the class is defined, so a hook is never dropped in silence. The default `run()` is the loop that drives the three hooks, and it reports each step that runs with `complete_step()`, which is what the runtime counts a session's steps by. To write that report yourself, for example to keep extra files with the step, return a `StepCompleted(output=..., files=...)` from `process_output()` instead of the `Output`. Override `run()` to write your own loop against `emit()`, `send()`, `complete_step()`, `@event`, `self.connected`, and the tracks; `process_input()`, `generate()`, and `process_output()` are then not called, and your loop calls `complete_step(StepCompleted(output=...))` each time it finishes a unit of work. Do that for a loop that is not one step per emit, such as a renderer that emits several times per step or a model that must block on an input.
 
+A command handler refuses by raising `CommandError(code, message)`: `code` is a short, stable token the client branches on, and `message` reaches the client unchanged, so write it for them and name the codes in the command's description. The runtime answers that command's request with the failure, so the caller learns on its own call, no other client in the session hears about a command it did not send, and the runtime records that the command failed. Do not refuse by sending an error message and returning: the runtime counts that as success and acknowledges the command. Any other exception a handler raises reaches the client as an internal error with a fixed message, so catch what a check raises and raise a `CommandError` with a code of its own. The waypoint example's `set_image` does both.
+
 A session can start with its setup already in hand: `POST /start_session` takes a `starting_input` of state values and commands, which the runtime applies on the normal command path before any client connects. A system client sends them, a connection the runtime opens itself, so a handler that takes `client` gets a `ClientInfo` whose `system` is true. The step loop takes its first step only once every starting command has landed, uploads included, so no step runs on the defaults the starting input replaces. In a live session the system client then leaves and the loop waits for a viewer, as it always does; a model with its own `run()` sees the system client connect like any client. A live session stays `waiting` while its starting input applies, because the system client does not occupy it, and `/events` journals the system client's `connection_opened` and `connection_closed` as `waiting -> waiting`. A session with `steps` is occupied by the system client until it ends, so it streams with no other client. `steps` is a whole number from 1 to 10,000. The runtime ends it itself once the model has reported that many steps, with a normal stop whose close reason is "Session ended: the requested steps are complete." A session with `steps` has no client to correct its starting input, so a starting command the runtime cannot apply (an upload whose bytes never arrive, or arguments the contract refuses) ends it at once with the reason `start_refused` and the refusal as its close reason. If the handler of a starting command fails instead, by raising `CommandError` or any other exception, every step the model has not reported yet is recorded with the handler's message, so a session at step 3 of 4 saves steps 3 and 4 with that error, and the session ends with the reason `error`. The model keeps running and takes the next session.
 
 A model can keep each step it reports as a folder of files, turned on in `reactor.yaml`:

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/README.md

@@ -97,6 +97,8 @@ class MyModel(ReactorApp):
 
 Command handlers and lifecycle hooks run between steps, never during one. A model has one method per lifecycle hook kind (`@session_started`, `@session_ended`, `@connected`, `@disconnected`, `@file_uploaded`). A subclass extends an inherited hook by overriding that method and calling `super()`; the override runs whether or not it repeats the decorator. Marking a second method with the same kind, in one class or in a subclass, fails when the class is defined, so a hook is never dropped in silence. The default `run()` is the loop that drives the three hooks, and it reports each step that runs with `complete_step()`, which is what the runtime counts a session's steps by. To write that report yourself, for example to keep extra files with the step, return a `StepCompleted(output=..., files=...)` from `process_output()` instead of the `Output`. Override `run()` to write your own loop against `emit()`, `send()`, `complete_step()`, `@event`, `self.connected`, and the tracks; `process_input()`, `generate()`, and `process_output()` are then not called, and your loop calls `complete_step(StepCompleted(output=...))` each time it finishes a unit of work. Do that for a loop that is not one step per emit, such as a renderer that emits several times per step or a model that must block on an input.
 
+A command handler refuses by raising `CommandError(code, message)`: `code` is a short, stable token the client branches on, and `message` reaches the client unchanged, so write it for them and name the codes in the command's description. The runtime answers that command's request with the failure, so the caller learns on its own call, no other client in the session hears about a command it did not send, and the runtime records that the command failed. Do not refuse by sending an error message and returning: the runtime counts that as success and acknowledges the command. Any other exception a handler raises reaches the client as an internal error with a fixed message, so catch what a check raises and raise a `CommandError` with a code of its own. The waypoint example's `set_image` does both.
+
 A session can start with its setup already in hand: `POST /start_session` takes a `starting_input` of state values and commands, which the runtime applies on the normal command path before any client connects. A system client sends them, a connection the runtime opens itself, so a handler that takes `client` gets a `ClientInfo` whose `system` is true. The step loop takes its first step only once every starting command has landed, uploads included, so no step runs on the defaults the starting input replaces. In a live session the system client then leaves and the loop waits for a viewer, as it always does; a model with its own `run()` sees the system client connect like any client. A live session stays `waiting` while its starting input applies, because the system client does not occupy it, and `/events` journals the system client's `connection_opened` and `connection_closed` as `waiting -> waiting`. A session with `steps` is occupied by the system client until it ends, so it streams with no other client. `steps` is a whole number from 1 to 10,000. The runtime ends it itself once the model has reported that many steps, with a normal stop whose close reason is "Session ended: the requested steps are complete." A session with `steps` has no client to correct its starting input, so a starting command the runtime cannot apply (an upload whose bytes never arrive, or arguments the contract refuses) ends it at once with the reason `start_refused` and the refusal as its close reason. If the handler of a starting command fails instead, by raising `CommandError` or any other exception, every step the model has not reported yet is recorded with the handler's message, so a session at step 3 of 4 saves steps 3 and 4 with that error, and the session ends with the reason `error`. The model keeps running and takes the next session.
 
 A model can keep each step it reports as a folder of files, turned on in `reactor.yaml`:

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/pyproject.toml

@@ -10,7 +10,7 @@ module-name = [
 namespace = true
 
 [tool.reactor-wire]
-version = "1.20261013.10"
+version = "1.20261013.11"
 
 [tool.ruff]
 line-length = 100
@@ -95,7 +95,7 @@ pythonpath = ["."]
 
 [project]
 name = "reactor-runtime"
-version = "3.8.2"
+version = "3.8.3"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/pyproject.toml.orig

@@ -16,11 +16,11 @@ namespace = true
 # gates the pin against proto/, so a release cannot ship a schema older than the
 # sources it was built from.
 [tool.reactor-wire]
-version = "1.20261013.10"
+version = "1.20261013.11"
 
 [project]
 name = "reactor-runtime"
-version = "3.8.2"
+version = "3.8.3"
 description = "A Python framework for building real-time, interactive video models"
 readme = "README.md"
 license = "Apache-2.0"

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_runtime/core/__init__.py

@@ -43,6 +43,7 @@ from reactor_runtime.core.transport import (
 from reactor_runtime.core.typespec import TypeSpec
 from reactor_runtime.core.values import (
     ClientConnectionStat,
+    ClientEnvironment,
     ClientStatsBatch,
     ClientTrackDirection,
     ClientTrackStat,
@@ -68,6 +69,7 @@ __all__ = [
     "ClientConnected",
     "ClientConnectionStat",
     "ClientDisconnected",
+    "ClientEnvironment",
     "ClientStatsBatch",
     "ClientTrackDirection",
     "ClientTrackStat",

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_runtime/core/values.py

@@ -78,10 +78,13 @@ class ClientTrackStat:
     connection identity itself rather than trusting anything the payload might
     claim, because the payload carries none.
 
-    ``kind``/``direction``/``codec`` are fixed, structural facts about the
-    track — never a new value at runtime — so they stay their own fields;
-    :attr:`metrics` is where the actual measurements live, because that set
-    grows as new stats become worth reporting, without a schema change.
+    The typed fields carry the facts about the track that are not numbers:
+    ``kind``/``direction``/``codec`` are fixed for the track, and
+    ``codec_implementation``/``hardware_codec`` describe it at the time of
+    the reading, since the client's engine can switch implementation
+    mid-session. :attr:`metrics` is where the actual measurements live,
+    because that set grows as new stats become worth reporting, without a
+    schema change.
 
     Attributes:
         timestamp: When the client took this reading, on its own clock, in
@@ -105,6 +108,12 @@ class ClientTrackStat:
             query time.
         frame_stages: Where the track's frames spent their time since the
             client's previous batch, stage by stage.
+        codec_implementation: The encoder (a track the client sends) or
+            decoder (one it receives) the client runs for a video track, as
+            its media engine names it, e.g. ``"libvpx"``; empty when unknown.
+        hardware_codec: Whether the client's media engine reports that
+            implementation as power efficient, which in practice means
+            hardware accelerated; ``None`` when the client does not say.
     """
 
     timestamp: int
@@ -115,6 +124,33 @@ class ClientTrackStat:
     paused: bool
     metrics: Mapping[str, float]
     frame_stages: tuple[FrameStage, ...] = ()
+    codec_implementation: str = ""
+    hardware_codec: bool | None = None
+
+
+@dataclass(frozen=True)
+class ClientEnvironment:
+    """The SDK and the system a client runs on, as it describes them.
+
+    Every field is empty when the client does not know it.
+
+    Attributes:
+        sdk_type: The SDK, e.g. ``"python"``, ``"js"``, ``"cpp"``.
+        sdk_version: The SDK's version, e.g. ``"1.10.0"``.
+        os: The operating system, e.g. ``"macos"``, ``"linux"``, or
+            ``"browser"`` for the JavaScript SDK.
+        os_version: The operating system's version as the client reads it.
+        arch: The CPU architecture, e.g. ``"aarch64"``.
+        device_model: The device's hardware model as the system names it,
+            e.g. ``"iPhone15,2"``.
+    """
+
+    sdk_type: str = ""
+    sdk_version: str = ""
+    os: str = ""
+    os_version: str = ""
+    arch: str = ""
+    device_model: str = ""
 
 
 @dataclass(frozen=True)
@@ -124,18 +160,21 @@ class ClientConnectionStat:
     e.g. ``"available_outgoing_bitrate_bps"`` (the client engine's own
     estimate of outgoing headroom — the encoder's own belief, not a
     measurement of the user's internet) or ``"time_to_connect_ms"`` (how long
-    this connection waited to establish, start to "ready") — the latter a
-    one-time fact a client reports once rather than repeating on every batch,
-    which is why :class:`ClientStatsBatch` carries this as optional.
+    this connection waited to establish, start to "ready"). A client sends
+    this reading on every batch; a one-time fact like ``"time_to_connect_ms"``
+    is in ``metrics`` only on the first batch after connecting.
 
     Attributes:
         timestamp: When the client took this reading, on its own clock, in
             epoch milliseconds.
         metrics: The reading's measurements, by name.
+        environment: What the client runs on, sent on every batch; ``None``
+            from a client that does not send it.
     """
 
     timestamp: int
     metrics: Mapping[str, float]
+    environment: ClientEnvironment | None = None
 
 
 @dataclass(frozen=True)
@@ -144,15 +183,14 @@ class ClientStatsBatch:
 
     Mirrors the wire's ``ClientStats`` message: per-track readings alongside
     a fact set that applies to the whole connection rather than any one
-    track. A client typically sends ``connection_stat`` once, on its first
-    batch after connecting, and omits it on every batch after — most batches
-    therefore carry ``track_stats`` only.
+    track. A client sends ``connection_stat`` on every batch; a client that
+    predates it sends none.
 
     Attributes:
         track_stats: One reading per track this batch reports on. Empty on a
             batch that carries only ``connection_stat``.
-        connection_stat: This batch's connection-wide reading, or ``None`` on
-            a batch that doesn't carry one — the common case.
+        connection_stat: This batch's connection-wide reading, or ``None``
+            from a client that does not send one.
     """
 
     track_stats: Sequence[ClientTrackStat]

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_runtime/runner/client_stats.py

@@ -15,7 +15,7 @@ import time
 from collections.abc import Callable, Iterable, Mapping
 from typing import Any
 
-from reactor_runtime.core import ClientStatsBatch, ConnId, FrameStage
+from reactor_runtime.core import ClientEnvironment, ClientStatsBatch, ConnId, FrameStage
 
 # The SDK sends a batch every few seconds, with a few tracks and a few dozen
 # metrics each; these limits are far above that.
@@ -75,7 +75,13 @@ def fits(batch: ClientStatsBatch) -> bool:
         return False
     names = [name for metrics in readings for name in metrics]
     names += [stage.name for stat in batch.track_stats for stage in stat.frame_stages]
-    names += [field for stat in batch.track_stats for field in (stat.track_name, stat.codec)]
+    names += [
+        field
+        for stat in batch.track_stats
+        for field in (stat.track_name, stat.codec, stat.codec_implementation)
+    ]
+    if batch.connection_stat is not None and batch.connection_stat.environment is not None:
+        names += list(environment_detail(batch.connection_stat.environment).values())
     return all(len(name) <= MAX_NAME_LENGTH for name in names)
 
 
@@ -96,6 +102,8 @@ def to_detail(batch: ClientStatsBatch) -> dict[str, Any]:
                 "paused": stat.paused,
                 "metrics": _finite(stat.metrics),
                 "frame_stages": frame_stages_detail(stat.frame_stages),
+                "codec_implementation": stat.codec_implementation,
+                "hardware_codec": stat.hardware_codec,
             }
             for stat in batch.track_stats
         ],
@@ -103,6 +111,11 @@ def to_detail(batch: ClientStatsBatch) -> dict[str, Any]:
             {
                 "timestamp": batch.connection_stat.timestamp,
                 "metrics": _finite(batch.connection_stat.metrics),
+                "environment": (
+                    environment_detail(batch.connection_stat.environment)
+                    if batch.connection_stat.environment is not None
+                    else None
+                ),
             }
             if batch.connection_stat is not None
             else None
@@ -110,6 +123,18 @@ def to_detail(batch: ClientStatsBatch) -> dict[str, Any]:
     }
 
 
+def environment_detail(environment: ClientEnvironment) -> dict[str, str]:
+    """Shape what a client runs on for a fact's detail."""
+    return {
+        "sdk_type": environment.sdk_type,
+        "sdk_version": environment.sdk_version,
+        "os": environment.os,
+        "os_version": environment.os_version,
+        "arch": environment.arch,
+        "device_model": environment.device_model,
+    }
+
+
 def frame_stages_detail(stages: Iterable[FrameStage]) -> list[dict[str, Any]]:
     """Shape a track's stage times for a fact's detail.
 

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_runtime/transport/webrtc/client_stats.py

@@ -13,6 +13,7 @@ from google.protobuf.message import DecodeError
 
 from reactor_runtime.core import (
     ClientConnectionStat,
+    ClientEnvironment,
     ClientStatsBatch,
     ClientTrackDirection,
     ClientTrackStat,
@@ -105,25 +106,56 @@ def _decode_frame_stages(stat: platform_pb2.ClientTrackStat) -> tuple[FrameStage
     )
 
 
+def _decode_codec_implementation(
+    stat: platform_pb2.ClientTrackStat,
+) -> tuple[str, bool | None]:
+    """Read which encoder or decoder a video track runs; an audio track has none."""
+    if stat.kind != platform_pb2.TrackKind.TRACK_KIND_VIDEO:
+        return "", None
+    hardware = stat.hardware_codec if stat.HasField("hardware_codec") else None
+    return stat.codec_implementation, hardware
+
+
+def _decode_environment(stat: platform_pb2.ClientConnectionStat) -> ClientEnvironment | None:
+    """Read what the client runs on, or ``None`` from a client that does not say."""
+    if not stat.HasField("environment"):
+        return None
+    env = stat.environment
+    return ClientEnvironment(
+        sdk_type=env.sdk_type,
+        sdk_version=env.sdk_version,
+        os=env.os,
+        os_version=env.os_version,
+        arch=env.arch,
+        device_model=env.device_model,
+    )
+
+
+def _decode_track_stat(stat: platform_pb2.ClientTrackStat) -> ClientTrackStat:
+    """Convert one decoded ``ClientTrackStat`` into a plain value."""
+    codec_implementation, hardware_codec = _decode_codec_implementation(stat)
+    return ClientTrackStat(
+        timestamp=stat.timestamp,
+        track_name=stat.track_name,
+        kind=_TRACK_KINDS.get(stat.kind),
+        direction=_TRACK_DIRECTIONS.get(stat.direction),
+        codec=_decode_codec(stat),
+        paused=stat.paused,
+        metrics=dict(stat.metrics),
+        frame_stages=_decode_frame_stages(stat),
+        codec_implementation=codec_implementation,
+        hardware_codec=hardware_codec,
+    )
+
+
 def _decode_client_stats(message: platform_pb2.ClientStats) -> ClientStatsBatch:
     """Convert a decoded ``ClientStats`` batch into plain values."""
-    track_stats = [
-        ClientTrackStat(
-            timestamp=stat.timestamp,
-            track_name=stat.track_name,
-            kind=_TRACK_KINDS.get(stat.kind),
-            direction=_TRACK_DIRECTIONS.get(stat.direction),
-            codec=_decode_codec(stat),
-            paused=stat.paused,
-            metrics=dict(stat.metrics),
-            frame_stages=_decode_frame_stages(stat),
-        )
-        for stat in message.track_stats
-    ]
+    track_stats = [_decode_track_stat(stat) for stat in message.track_stats]
     connection_stat = None
     if message.HasField("connection_stat"):
         connection_stat = ClientConnectionStat(
             timestamp=message.connection_stat.timestamp,
             metrics=dict(message.connection_stat.metrics),
+            environment=_decode_environment(message.connection_stat),
         )
     return ClientStatsBatch(track_stats=track_stats, connection_stat=connection_stat)

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_runtime/transport/webrtc/pacer.py

@@ -102,6 +102,10 @@ class MediaPacer:
         self._stop = threading.Event()
         self._stop.set()
         self._lifecycle_lock = threading.Lock()
+        # Set once by stop(), under ``_room``: a stopped pacer is finished and
+        # takes no more media. ``_stop`` cannot mark this, because it is also
+        # set before start(), when submissions are still accepted.
+        self._closed = False
 
         # One black frame marks a boundary (start of the connection, or a
         # flush); after it the pacer repeats the last metadata-carrying frame
@@ -151,26 +155,32 @@ class MediaPacer:
             # chunk so a batching model's whole chunk always fits. Re-read
             # each iteration so a concurrent set_depth applies mid-chunk.
             capacity = max(self._depth, chunk.n_frames)
-            if chunk.wait:
-                with self._room:
+            # The checks and the put share one critical section with stop(),
+            # so a frame either lands before stop() drains the queue or is
+            # refused.
+            with self._room:
+                if self._closed:
+                    aborted = True
+                    break
+                if chunk.wait:
                     while (
                         not self._stop.is_set()
                         and self._epoch == epoch
                         and self._queue.qsize() >= capacity
                     ):
                         self._room.wait(timeout=0.1)
-                if self._stop.is_set() or self._epoch != epoch:
-                    aborted = True
-                    break
-            else:
-                # A flush mid-chunk abandons the rest of it on this path too;
-                # the flushed run's tail must not trickle in after the cut.
-                if self._epoch != epoch:
-                    aborted = True
-                    break
-                if self._queue.qsize() >= capacity:
-                    break
-            self._queue.put_nowait((frame, time.perf_counter()))
+                    if self._stop.is_set() or self._epoch != epoch:
+                        aborted = True
+                        break
+                else:
+                    # A flush mid-chunk abandons the rest of it on this path too;
+                    # the flushed run's tail must not trickle in after the cut.
+                    if self._epoch != epoch:
+                        aborted = True
+                        break
+                    if self._queue.qsize() >= capacity:
+                        break
+                self._queue.put_nowait((frame, time.perf_counter()))
             enqueued += 1
         if enqueued < chunk.n_frames and not chunk.wait and not aborted:
             dropped = chunk.n_frames - enqueued
@@ -219,34 +229,47 @@ class MediaPacer:
             self._room.notify_all()
 
     def start(self) -> None:
-        """Start the pacing thread, idempotently."""
+        """Start the pacing thread, idempotently. A stopped pacer stays stopped."""
         with self._lifecycle_lock:
-            if not self._stop.is_set():
+            if not self._stop.is_set() or self._closed:
                 return
             self._stop.clear()
             self._thread = threading.Thread(target=self._pacing_loop, name="media-pacer")
             self._thread.start()
 
     def stop(self) -> None:
-        """Stop the pacing thread and wait for it to finish.
+        """Stop the pacing thread, wait for it to finish, and release held media.
+
+        Stopping is final: from then on :meth:`submit` enqueues nothing and
+        :meth:`start` does nothing. Once the thread has stopped, the queued
+        frames and the last delivered frame are dropped, also on a pacer that
+        was never started. A frame is a view into the model's whole output
+        array, so a stopped pacer that kept one would keep that array alive
+        for as long as the pacer itself is reachable.
 
         Raises:
             RuntimeError: If the thread does not stop within two seconds.
         """
         with self._lifecycle_lock:
-            if self._stop.is_set():
-                return
             self._stop.set()
             thread = self._thread
             self._thread = None
-        # Wake any producer blocked in a backpressure submit, so teardown
-        # cannot deadlock behind a queue nobody will drain.
+        # Refuse further media, and wake any producer blocked in a backpressure
+        # submit, so teardown cannot deadlock behind a queue nobody will drain.
         with self._room:
+            self._closed = True
             self._room.notify_all()
         if thread is not None:
             thread.join(timeout=2.0)
             if thread.is_alive():
                 raise RuntimeError("media pacer thread did not stop within 2s")
+        with self._room:
+            while True:
+                try:
+                    self._queue.get_nowait()
+                except queue.Empty:
+                    break
+            self._last_frame = None
 
     def _pacing_loop(self) -> None:
         """Deliver one frame per tick at a steady cadence until stopped."""

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_wire/v1/platform_pb2.py

@@ -25,7 +25,7 @@ _sym_db = _symbol_database.Default()
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1ereactor_wire/v1/platform.proto\x12\x0freactor_wire.v1\x1a\x1cgoogle/protobuf/struct.proto\"\x06\n\x04Ping\"\x0f\n\rRequestSchema\"@\n\x0bModelSchema\x12\x31\n\x07openapi\x18\x01 \x01(\x0b\x32\x17.google.protobuf.StructR\x07openapi\"p\n\x0c\x46ileUploaded\x12\x1b\n\tupload_id\x18\x01 \x01(\tR\x08uploadId\x12\x12\n\x04name\x18\x02 \x01(\tR\x04name\x12\x1b\n\tmime_type\x18\x03 \x01(\tR\x08mimeType\x12\x12\n\x04size\x18\x04 \x01(\x03R\x04size\"8\n\x0bRequestClip\x12)\n\x10\x64uration_seconds\x18\x01 \x01(\x01R\x0f\x64urationSeconds\"\x12\n\x10RequestRecording\"\xf5\x01\n\tClipReady\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId\x12\x12\n\x04kind\x18\x02 \x01(\tR\x04kind\x12!\n\x0cstart_marker\x18\x03 \x01(\x01R\x0bstartMarker\x12\x1d\n\nend_marker\x18\x04 \x01(\x01R\tendMarker\x12\x1d\n\nnow_marker\x18\x05 \x01(\x01R\tnowMarker\x12\x31\n\x15predicted_ready_at_ms\x18\x06 \x01(\x03R\x12predictedReadyAtMs\x12!\n\x0cplaylist_url\x18\x07 \x01(\tR\x0bplaylistUrl\"$\n\nClipFailed\x12\x16\n\x06reason\x18\x01 \x01(\tR\x06reason\"\x97\x01\n\nModeration\x12\x16\n\x06\x61\x63tion\x18\x01 \x01(\tR\x06\x61\x63tion\x12\x1d\n\ninput_kind\x18\x02 \x01(\tR\tinputKind\x12\x18\n\x07\x63ommand\x18\x03 \x01(\tR\x07\x63ommand\x12\x1e\n\ncategories\x18\x04 \x03(\tR\ncategories\x12\x18\n\x07message\x18\x05 \x01(\tR\x07message\"&\n\x0cSessionEnded\x12\x16\n\x06reason\x18\x01 \x01(\tR\x06reason\"\xa3\x04\n\x0f\x43lientTrackStat\x12\x1c\n\ttimestamp\x18\x01 \x01(\x03R\ttimestamp\x12\x1d\n\ntrack_name\x18\x02 \x01(\tR\ttrackName\x12.\n\x04kind\x18\x03 \x01(\x0e\x32\x1a.reactor_wire.v1.TrackKindR\x04kind\x12=\n\tdirection\x18\x04 \x01(\x0e\x32\x1f.reactor_wire.v1.TrackDirectionR\tdirection\x12>\n\x0bvideo_codec\x18\x05 \x01(\x0e\x32\x1b.reactor_wire.v1.VideoCodecH\x00R\nvideoCodec\x12>\n\x0b\x61udio_codec\x18\x06 \x01(\x0e\x32\x1b.reactor_wire.v1.AudioCodecH\x00R\naudioCodec\x12\x16\n\x06paused\x18\x07 \x01(\x08R\x06paused\x12G\n\x07metrics\x18\x08 \x03(\x0b\x32-.reactor_wire.v1.ClientTrackStat.MetricsEntryR\x07metrics\x12>\n\x0c\x66rame_stages\x18\t \x03(\x0b\x32\x1b.reactor_wire.v1.FrameStageR\x0b\x66rameStages\x1a:\n\x0cMetricsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\x01R\x05value:\x02\x38\x01\x42\x07\n\x05\x63odec\"S\n\nFrameStage\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x19\n\x08total_ms\x18\x02 \x01(\x01R\x07totalMs\x12\x16\n\x06\x66rames\x18\x03 \x01(\x04R\x06\x66rames\"\xbe\x01\n\x14\x43lientConnectionStat\x12\x1c\n\ttimestamp\x18\x01 \x01(\x03R\ttimestamp\x12L\n\x07metrics\x18\x02 \x03(\x0b\x32\x32.reactor_wire.v1.ClientConnectionStat.MetricsEntryR\x07metrics\x1a:\n\x0cMetricsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\x01R\x05value:\x02\x38\x01\"\xa0\x01\n\x0b\x43lientStats\x12\x41\n\x0btrack_stats\x18\x01 \x03(\x0b\x32 .reactor_wire.v1.ClientTrackStatR\ntrackStats\x12N\n\x0f\x63onnection_stat\x18\x02 \x01(\x0b\x32%.reactor_wire.v1.ClientConnectionStatR\x0e\x63onnectionStat*\x94\x01\n\nVideoCodec\x12\x1b\n\x17VIDEO_CODEC_UNSPECIFIED\x10\x00\x12\x13\n\x0fVIDEO_CODEC_VP8\x10\x01\x12\x13\n\x0fVIDEO_CODEC_VP9\x10\x02\x12\x13\n\x0fVIDEO_CODEC_AV1\x10\x03\x12\x14\n\x10VIDEO_CODEC_H264\x10\x04\x12\x14\n\x10VIDEO_CODEC_H265\x10\x05*?\n\nAudioCodec\x12\x1b\n\x17\x41UDIO_CODEC_UNSPECIFIED\x10\x00\x12\x14\n\x10\x41UDIO_CODEC_OPUS\x10\x01*S\n\tTrackKind\x12\x1a\n\x16TRACK_KIND_UNSPECIFIED\x10\x00\x12\x14\n\x10TRACK_KIND_VIDEO\x10\x01\x12\x14\n\x10TRACK_KIND_AUDIO\x10\x02*m\n\x0eTrackDirection\x12\x1f\n\x1bTRACK_DIRECTION_UNSPECIFIED\x10\x00\x12\x1c\n\x18TRACK_DIRECTION_RECVONLY\x10\x01\x12\x1c\n\x18TRACK_DIRECTION_SENDONLY\x10\x02\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1ereactor_wire/v1/platform.proto\x12\x0freactor_wire.v1\x1a\x1cgoogle/protobuf/struct.proto\"\x06\n\x04Ping\"\x0f\n\rRequestSchema\"@\n\x0bModelSchema\x12\x31\n\x07openapi\x18\x01 \x01(\x0b\x32\x17.google.protobuf.StructR\x07openapi\"p\n\x0c\x46ileUploaded\x12\x1b\n\tupload_id\x18\x01 \x01(\tR\x08uploadId\x12\x12\n\x04name\x18\x02 \x01(\tR\x04name\x12\x1b\n\tmime_type\x18\x03 \x01(\tR\x08mimeType\x12\x12\n\x04size\x18\x04 \x01(\x03R\x04size\"8\n\x0bRequestClip\x12)\n\x10\x64uration_seconds\x18\x01 \x01(\x01R\x0f\x64urationSeconds\"\x12\n\x10RequestRecording\"\xf5\x01\n\tClipReady\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId\x12\x12\n\x04kind\x18\x02 \x01(\tR\x04kind\x12!\n\x0cstart_marker\x18\x03 \x01(\x01R\x0bstartMarker\x12\x1d\n\nend_marker\x18\x04 \x01(\x01R\tendMarker\x12\x1d\n\nnow_marker\x18\x05 \x01(\x01R\tnowMarker\x12\x31\n\x15predicted_ready_at_ms\x18\x06 \x01(\x03R\x12predictedReadyAtMs\x12!\n\x0cplaylist_url\x18\x07 \x01(\tR\x0bplaylistUrl\"$\n\nClipFailed\x12\x16\n\x06reason\x18\x01 \x01(\tR\x06reason\"\x97\x01\n\nModeration\x12\x16\n\x06\x61\x63tion\x18\x01 \x01(\tR\x06\x61\x63tion\x12\x1d\n\ninput_kind\x18\x02 \x01(\tR\tinputKind\x12\x18\n\x07\x63ommand\x18\x03 \x01(\tR\x07\x63ommand\x12\x1e\n\ncategories\x18\x04 \x03(\tR\ncategories\x12\x18\n\x07message\x18\x05 \x01(\tR\x07message\"&\n\x0cSessionEnded\x12\x16\n\x06reason\x18\x01 \x01(\tR\x06reason\"\x95\x05\n\x0f\x43lientTrackStat\x12\x1c\n\ttimestamp\x18\x01 \x01(\x03R\ttimestamp\x12\x1d\n\ntrack_name\x18\x02 \x01(\tR\ttrackName\x12.\n\x04kind\x18\x03 \x01(\x0e\x32\x1a.reactor_wire.v1.TrackKindR\x04kind\x12=\n\tdirection\x18\x04 \x01(\x0e\x32\x1f.reactor_wire.v1.TrackDirectionR\tdirection\x12>\n\x0bvideo_codec\x18\x05 \x01(\x0e\x32\x1b.reactor_wire.v1.VideoCodecH\x00R\nvideoCodec\x12>\n\x0b\x61udio_codec\x18\x06 \x01(\x0e\x32\x1b.reactor_wire.v1.AudioCodecH\x00R\naudioCodec\x12\x16\n\x06paused\x18\x07 \x01(\x08R\x06paused\x12G\n\x07metrics\x18\x08 \x03(\x0b\x32-.reactor_wire.v1.ClientTrackStat.MetricsEntryR\x07metrics\x12>\n\x0c\x66rame_stages\x18\t \x03(\x0b\x32\x1b.reactor_wire.v1.FrameStageR\x0b\x66rameStages\x12\x31\n\x14\x63odec_implementation\x18\n \x01(\tR\x13\x63odecImplementation\x12*\n\x0ehardware_codec\x18\x0b \x01(\x08H\x01R\rhardwareCodec\x88\x01\x01\x1a:\n\x0cMetricsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\x01R\x05value:\x02\x38\x01\x42\x07\n\x05\x63odecB\x11\n\x0f_hardware_codec\"S\n\nFrameStage\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x19\n\x08total_ms\x18\x02 \x01(\x01R\x07totalMs\x12\x16\n\x06\x66rames\x18\x03 \x01(\x04R\x06\x66rames\"\x84\x02\n\x14\x43lientConnectionStat\x12\x1c\n\ttimestamp\x18\x01 \x01(\x03R\ttimestamp\x12L\n\x07metrics\x18\x02 \x03(\x0b\x32\x32.reactor_wire.v1.ClientConnectionStat.MetricsEntryR\x07metrics\x12\x44\n\x0b\x65nvironment\x18\x03 \x01(\x0b\x32\".reactor_wire.v1.ClientEnvironmentR\x0b\x65nvironment\x1a:\n\x0cMetricsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\x01R\x05value:\x02\x38\x01\"\xb5\x01\n\x11\x43lientEnvironment\x12\x19\n\x08sdk_type\x18\x01 \x01(\tR\x07sdkType\x12\x1f\n\x0bsdk_version\x18\x02 \x01(\tR\nsdkVersion\x12\x0e\n\x02os\x18\x03 \x01(\tR\x02os\x12\x1d\n\nos_version\x18\x04 \x01(\tR\tosVersion\x12\x12\n\x04\x61rch\x18\x05 \x01(\tR\x04\x61rch\x12!\n\x0c\x64\x65vice_model\x18\x06 \x01(\tR\x0b\x64\x65viceModel\"\xa0\x01\n\x0b\x43lientStats\x12\x41\n\x0btrack_stats\x18\x01 \x03(\x0b\x32 .reactor_wire.v1.ClientTrackStatR\ntrackStats\x12N\n\x0f\x63onnection_stat\x18\x02 \x01(\x0b\x32%.reactor_wire.v1.ClientConnectionStatR\x0e\x63onnectionStat*\x94\x01\n\nVideoCodec\x12\x1b\n\x17VIDEO_CODEC_UNSPECIFIED\x10\x00\x12\x13\n\x0fVIDEO_CODEC_VP8\x10\x01\x12\x13\n\x0fVIDEO_CODEC_VP9\x10\x02\x12\x13\n\x0fVIDEO_CODEC_AV1\x10\x03\x12\x14\n\x10VIDEO_CODEC_H264\x10\x04\x12\x14\n\x10VIDEO_CODEC_H265\x10\x05*?\n\nAudioCodec\x12\x1b\n\x17\x41UDIO_CODEC_UNSPECIFIED\x10\x00\x12\x14\n\x10\x41UDIO_CODEC_OPUS\x10\x01*S\n\tTrackKind\x12\x1a\n\x16TRACK_KIND_UNSPECIFIED\x10\x00\x12\x14\n\x10TRACK_KIND_VIDEO\x10\x01\x12\x14\n\x10TRACK_KIND_AUDIO\x10\x02*m\n\x0eTrackDirection\x12\x1f\n\x1bTRACK_DIRECTION_UNSPECIFIED\x10\x00\x12\x1c\n\x18TRACK_DIRECTION_RECVONLY\x10\x01\x12\x1c\n\x18TRACK_DIRECTION_SENDONLY\x10\x02\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -36,14 +36,14 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_CLIENTTRACKSTAT_METRICSENTRY']._serialized_options = b'8\001'
   _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._loaded_options = None
   _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._serialized_options = b'8\001'
-  _globals['_VIDEOCODEC']._serialized_start=1836
-  _globals['_VIDEOCODEC']._serialized_end=1984
-  _globals['_AUDIOCODEC']._serialized_start=1986
-  _globals['_AUDIOCODEC']._serialized_end=2049
-  _globals['_TRACKKIND']._serialized_start=2051
-  _globals['_TRACKKIND']._serialized_end=2134
-  _globals['_TRACKDIRECTION']._serialized_start=2136
-  _globals['_TRACKDIRECTION']._serialized_end=2245
+  _globals['_VIDEOCODEC']._serialized_start=2204
+  _globals['_VIDEOCODEC']._serialized_end=2352
+  _globals['_AUDIOCODEC']._serialized_start=2354
+  _globals['_AUDIOCODEC']._serialized_end=2417
+  _globals['_TRACKKIND']._serialized_start=2419
+  _globals['_TRACKKIND']._serialized_end=2502
+  _globals['_TRACKDIRECTION']._serialized_start=2504
+  _globals['_TRACKDIRECTION']._serialized_end=2613
   _globals['_PING']._serialized_start=81
   _globals['_PING']._serialized_end=87
   _globals['_REQUESTSCHEMA']._serialized_start=89
@@ -65,15 +65,17 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_SESSIONENDED']._serialized_start=804
   _globals['_SESSIONENDED']._serialized_end=842
   _globals['_CLIENTTRACKSTAT']._serialized_start=845
-  _globals['_CLIENTTRACKSTAT']._serialized_end=1392
-  _globals['_CLIENTTRACKSTAT_METRICSENTRY']._serialized_start=1325
-  _globals['_CLIENTTRACKSTAT_METRICSENTRY']._serialized_end=1383
-  _globals['_FRAMESTAGE']._serialized_start=1394
-  _globals['_FRAMESTAGE']._serialized_end=1477
-  _globals['_CLIENTCONNECTIONSTAT']._serialized_start=1480
-  _globals['_CLIENTCONNECTIONSTAT']._serialized_end=1670
-  _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._serialized_start=1325
-  _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._serialized_end=1383
-  _globals['_CLIENTSTATS']._serialized_start=1673
-  _globals['_CLIENTSTATS']._serialized_end=1833
+  _globals['_CLIENTTRACKSTAT']._serialized_end=1506
+  _globals['_CLIENTTRACKSTAT_METRICSENTRY']._serialized_start=1420
+  _globals['_CLIENTTRACKSTAT_METRICSENTRY']._serialized_end=1478
+  _globals['_FRAMESTAGE']._serialized_start=1508
+  _globals['_FRAMESTAGE']._serialized_end=1591
+  _globals['_CLIENTCONNECTIONSTAT']._serialized_start=1594
+  _globals['_CLIENTCONNECTIONSTAT']._serialized_end=1854
+  _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._serialized_start=1420
+  _globals['_CLIENTCONNECTIONSTAT_METRICSENTRY']._serialized_end=1478
+  _globals['_CLIENTENVIRONMENT']._serialized_start=1857
+  _globals['_CLIENTENVIRONMENT']._serialized_end=2038
+  _globals['_CLIENTSTATS']._serialized_start=2041
+  _globals['_CLIENTSTATS']._serialized_end=2201
 # @@protoc_insertion_point(module_scope)

{reactor_runtime-3.8.2 → reactor_runtime-3.8.3}/src/reactor_wire/v1/platform_pb2.pyi

@@ -129,7 +129,7 @@ class SessionEnded(_message.Message):
     def __init__(self, reason: _Optional[str] = ...) -> None: ...
 
 class ClientTrackStat(_message.Message):
-    __slots__ = ("timestamp", "track_name", "kind", "direction", "video_codec", "audio_codec", "paused", "metrics", "frame_stages")
+    __slots__ = ("timestamp", "track_name", "kind", "direction", "video_codec", "audio_codec", "paused", "metrics", "frame_stages", "codec_implementation", "hardware_codec")
     class MetricsEntry(_message.Message):
         __slots__ = ("key", "value")
         KEY_FIELD_NUMBER: _ClassVar[int]
@@ -146,6 +146,8 @@ class ClientTrackStat(_message.Message):
     PAUSED_FIELD_NUMBER: _ClassVar[int]
     METRICS_FIELD_NUMBER: _ClassVar[int]
     FRAME_STAGES_FIELD_NUMBER: _ClassVar[int]
+    CODEC_IMPLEMENTATION_FIELD_NUMBER: _ClassVar[int]
+    HARDWARE_CODEC_FIELD_NUMBER: _ClassVar[int]
     timestamp: int
     track_name: str
     kind: TrackKind
@@ -155,7 +157,9 @@ class ClientTrackStat(_message.Message):
     paused: bool
     metrics: _containers.ScalarMap[str, float]
     frame_stages: _containers.RepeatedCompositeFieldContainer[FrameStage]
-    def __init__(self, timestamp: _Optional[int] = ..., track_name: _Optional[str] = ..., kind: _Optional[_Union[TrackKind, str]] = ..., direction: _Optional[_Union[TrackDirection, str]] = ..., video_codec: _Optional[_Union[VideoCodec, str]] = ..., audio_codec: _Optional[_Union[AudioCodec, str]] = ..., paused: _Optional[bool] = ..., metrics: _Optional[_Mapping[str, float]] = ..., frame_stages: _Optional[_Iterable[_Union[FrameStage, _Mapping]]] = ...) -> None: ...
+    codec_implementation: str
+    hardware_codec: bool
+    def __init__(self, timestamp: _Optional[int] = ..., track_name: _Optional[str] = ..., kind: _Optional[_Union[TrackKind, str]] = ..., direction: _Optional[_Union[TrackDirection, str]] = ..., video_codec: _Optional[_Union[VideoCodec, str]] = ..., audio_codec: _Optional[_Union[AudioCodec, str]] = ..., paused: _Optional[bool] = ..., metrics: _Optional[_Mapping[str, float]] = ..., frame_stages: _Optional[_Iterable[_Union[FrameStage, _Mapping]]] = ..., codec_implementation: _Optional[str] = ..., hardware_codec: _Optional[bool] = ...) -> None: ...
 
 class FrameStage(_message.Message):
     __slots__ = ("name", "total_ms", "frames")
@@ -168,7 +172,7 @@ class FrameStage(_message.Message):
     def __init__(self, name: _Optional[str] = ..., total_ms: _Optional[float] = ..., frames: _Optional[int] = ...) -> None: ...
 
 class ClientConnectionStat(_message.Message):
-    __slots__ = ("timestamp", "metrics")
+    __slots__ = ("timestamp", "metrics", "environment")
     class MetricsEntry(_message.Message):
         __slots__ = ("key", "value")
         KEY_FIELD_NUMBER: _ClassVar[int]
@@ -178,9 +182,27 @@ class ClientConnectionStat(_message.Message):
         def __init__(self, key: _Optional[str] = ..., value: _Optional[float] = ...) -> None: ...
     TIMESTAMP_FIELD_NUMBER: _ClassVar[int]
     METRICS_FIELD_NUMBER: _ClassVar[int]
+    ENVIRONMENT_FIELD_NUMBER: _ClassVar[int]
     timestamp: int
     metrics: _containers.ScalarMap[str, float]
-    def __init__(self, timestamp: _Optional[int] = ..., metrics: _Optional[_Mapping[str, float]] = ...) -> None: ...
+    environment: ClientEnvironment
+    def __init__(self, timestamp: _Optional[int] = ..., metrics: _Optional[_Mapping[str, float]] = ..., environment: _Optional[_Union[ClientEnvironment, _Mapping]] = ...) -> None: ...
+
+class ClientEnvironment(_message.Message):
+    __slots__ = ("sdk_type", "sdk_version", "os", "os_version", "arch", "device_model")
+    SDK_TYPE_FIELD_NUMBER: _ClassVar[int]
+    SDK_VERSION_FIELD_NUMBER: _ClassVar[int]
+    OS_FIELD_NUMBER: _ClassVar[int]
+    OS_VERSION_FIELD_NUMBER: _ClassVar[int]
+    ARCH_FIELD_NUMBER: _ClassVar[int]
+    DEVICE_MODEL_FIELD_NUMBER: _ClassVar[int]
+    sdk_type: str
+    sdk_version: str
+    os: str
+    os_version: str
+    arch: str
+    device_model: str
+    def __init__(self, sdk_type: _Optional[str] = ..., sdk_version: _Optional[str] = ..., os: _Optional[str] = ..., os_version: _Optional[str] = ..., arch: _Optional[str] = ..., device_model: _Optional[str] = ...) -> None: ...
 
 class ClientStats(_message.Message):
     __slots__ = ("track_stats", "connection_stat")