feat: unify card runtime and event-driven web ui

route_helpers.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+import json
+
+from fastapi import Request
+
+
+async def read_json_request(request: Request) -> dict:
+    try:
+        payload = await request.json()
+    except (json.JSONDecodeError, UnicodeDecodeError) as exc:
+        raise ValueError("request body must be valid JSON") from exc
+    if not isinstance(payload, dict):
+        raise ValueError("request body must be a JSON object")
+    return payload