reactor-runtime 2.2.0__tar.gz → 2.2.1__tar.gz

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactor_runtime
-Version: 2.2.0
+Version: 2.2.1
 Summary: Reactor runtime with public model API
 Author-email: Reactor <team@reactor.inc>
 Requires-Python: >=3.9

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reactor_runtime"
-version = "2.2.0"
+version = "2.2.1"
 description = "Reactor runtime with public model API"
 authors = [
 	{ name = "Reactor", email = "team@reactor.inc" }

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime/capabilities.py

@@ -14,6 +14,7 @@ The version field allows clients and tooling to detect schema changes.
 from __future__ import annotations
 
 import dataclasses
+import logging
 from dataclasses import dataclass, field
 from typing import Any, Dict, Literal, Optional, get_args, get_origin
 
@@ -25,21 +26,32 @@ from reactor_runtime.interface.tracks.descriptors import Audio
 from reactor_runtime.interface.tracks.input import INPUT_REGISTRY
 from reactor_runtime.interface.tracks.output import OUTPUT_REGISTRY
 from reactor_runtime.interface.upload import UploadedFile
+from reactor_runtime.utils.typing import unwrap_optional
 
 
-CAPABILITIES_VERSION = "1.2"
+logger = logging.getLogger(__name__)
 
-_TYPE_MAP = {
+CAPABILITIES_VERSION = "1.3"
+
+_TYPE_MAP: Dict[type, str] = {
     int: "integer",
     float: "number",
     str: "string",
     bool: "boolean",
-    UploadedFile: "file",
+}
+
+_UPLOADED_FILE_SCHEMA: Dict[str, Any] = {
+    "type": "object",
+    "format": "file-reference",
 }
 
 
 def _resolve_type(raw_type: Any) -> Dict[str, Any]:
-    """Resolve a type annotation into a JSON-friendly schema fragment."""
+    """Resolve a type annotation into an OpenAPI 3.1 JSON Schema fragment."""
+    inner = unwrap_optional(raw_type)
+    if inner is not None:
+        return _resolve_type(inner)
+
     origin = get_origin(raw_type)
 
     if origin is Literal:
@@ -55,12 +67,22 @@ def _resolve_type(raw_type: Any) -> Dict[str, Any]:
         return {"type": base, "enum": values}
 
     if isinstance(raw_type, type):
-        return {"type": _TYPE_MAP.get(raw_type, raw_type.__name__)}
-
-    if isinstance(raw_type, str):
-        return {"type": raw_type}
+        if raw_type is UploadedFile:
+            return dict(_UPLOADED_FILE_SCHEMA)
+        json_type = _TYPE_MAP.get(raw_type)
+        if json_type is not None:
+            return {"type": json_type}
+        logger.warning(
+            '_resolve_type: unsupported class %r, falling back to {"type": "object"}',
+            raw_type,
+        )
+        return {"type": "object"}
 
-    return {"type": str(raw_type)}
+    logger.warning(
+        '_resolve_type: unsupported annotation %r, falling back to {"type": "object"}',
+        raw_type,
+    )
+    return {"type": "object"}
 
 
 def _apply_field_info(schema: Dict[str, Any], info: FieldInfo) -> None:
@@ -95,7 +117,7 @@ def _field_schema(
     elif field_infos is not None:
         info = field_infos.get(f.name)
 
-    if default_val is not dataclasses.MISSING and default_val is not None:
+    if default_val is not dataclasses.MISSING:
         schema["default"] = default_val
     elif f.default_factory is not dataclasses.MISSING:
         schema["default"] = f.default_factory()

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime/interface/model/decorators.py

@@ -13,6 +13,7 @@ from typing import Any, Callable, List, Tuple, Type, Union, get_type_hints
 from reactor_runtime.interface.events.event import Event, _snake_to_pascal
 from reactor_runtime.interface.model.input_fields import FieldInfo, _NO_DEFAULT
 from reactor_runtime.interface.upload import UploadedFile
+from reactor_runtime.utils.typing import unwrap_optional
 
 _CONNECTED_ATTR = "__reactor_connected__"
 _DISCONNECTED_ATTR = "__reactor_disconnected__"
@@ -160,6 +161,14 @@ def make_event_class(
     return make_dataclass(class_name, fields, bases=(Event,))
 
 
+def _is_uploaded_file(raw_type: Any) -> bool:
+    """Return ``True`` if *raw_type* is ``UploadedFile`` or ``Optional[UploadedFile]``."""
+    if raw_type is UploadedFile:
+        return True
+    inner = unwrap_optional(raw_type)
+    return inner is UploadedFile
+
+
 def _make_event_from_method(func: Callable, event_name: str) -> Type[Event]:
     """Generate an Event subclass from a method's signature.
 
@@ -182,7 +191,7 @@ def _make_event_from_method(func: Callable, event_name: str) -> Type[Event]:
             continue
         param_type = hints.get(param_name, Any)
 
-        if param_type is UploadedFile:
+        if _is_uploaded_file(param_type):
             upload_fields.add(param_name)
 
         if param.default != inspect.Parameter.empty:

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime/interface/pipeline/input_state.py

@@ -22,6 +22,7 @@ from typing import Any, ClassVar, Dict, Set, get_type_hints
 
 from reactor_runtime.interface.model.input_fields import FieldInfo, _NO_DEFAULT
 from reactor_runtime.interface.upload import UploadedFile
+from reactor_runtime.utils.typing import unwrap_optional
 
 _MISSING = object()
 
@@ -74,7 +75,7 @@ class InputState:
         for name in list(annotations):
             raw = cls.__dict__.get(name, _MISSING)
             ann = resolved_hints.get(name, annotations[name])
-            is_upload = ann is UploadedFile
+            is_upload = ann is UploadedFile or unwrap_optional(ann) is UploadedFile
             if name.startswith("_"):
                 private.add(name)
             elif is_upload:

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime/runtimes/http/http_runtime.py

@@ -495,11 +495,15 @@ class HttpRuntime(Runtime):
         await self._handle_incoming_data_channel_message(message)
 
     async def _download_uploaded_file(self, upload_id: str) -> bytes:
-        """Read an uploaded file from the local in-memory store."""
+        """Read an uploaded file from the local in-memory store.
+
+        The data is retained so the same upload can be read multiple times
+        within a session.  The entire store is cleared on session cleanup.
+        """
         entry = self._upload_store.get(upload_id)
         if entry is None or "data" not in entry:
             raise FileNotFoundError(f"Upload {upload_id} not found in local store")
-        return entry.pop("data")
+        return entry["data"]
 
     def _on_ping_received(self) -> None:
         """Forward client ping to the WebRTC client's watchdog."""

reactor_runtime-2.2.1/src/reactor_runtime/utils/typing.py

@@ -0,0 +1,22 @@
+# Copyright (c) 2026 Reactor Technologies, Inc. All rights reserved.
+"""Shared type-annotation helpers used across the runtime."""
+
+from __future__ import annotations
+
+import types
+from typing import Any, Optional, Union, get_args, get_origin
+
+
+def unwrap_optional(raw_type: Any) -> Optional[Any]:
+    """If *raw_type* is ``Optional[X]`` (``Union[X, None]``), return ``X``.
+
+    Supports both ``typing.Union`` and Python 3.10+ ``X | None`` syntax.
+    Returns ``None`` when *raw_type* is not an Optional.
+    """
+    origin = get_origin(raw_type)
+    if origin is not Union and origin is not types.UnionType:
+        return None
+    args = [a for a in get_args(raw_type) if a is not type(None)]
+    if len(args) == 1:
+        return args[0]
+    return None

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactor_runtime
-Version: 2.2.0
+Version: 2.2.1
 Summary: Reactor runtime with public model API
 Author-email: Reactor <team@reactor.inc>
 Requires-Python: >=3.9

{reactor_runtime-2.2.0 → reactor_runtime-2.2.1}/src/reactor_runtime.egg-info/SOURCES.txt

@@ -118,6 +118,7 @@ src/reactor_runtime/utils/loader.py
 src/reactor_runtime/utils/log.py
 src/reactor_runtime/utils/messages.py
 src/reactor_runtime/utils/schema.py
+src/reactor_runtime/utils/typing.py
 src/template/README.md
 src/template/__init__.py
 src/template/config.yml