add api for post browser-use tasks

api/browser_rpc_client.py

@@ -0,0 +1,31 @@
+from typing import Any
+
+import httpx
+
+
+class BrowserRpcError(RuntimeError): ...
+
+
+async def run_browser_task(rpc_url: str, task: str, timeout_sec: float) -> dict[str, Any]:
+    payload = {"task": task}
+
+    timeout = httpx.Timeout(timeout_sec)
+    async with httpx.AsyncClient(timeout=timeout) as client:
+        try:
+            response = await client.post(rpc_url, json=payload)
+        except httpx.HTTPError as exc:
+            raise BrowserRpcError(f"Transport error: {exc}")
+
+    if response.status_code >= 400:
+        body = response.text
+        raise BrowserRpcError(f"RPC HTTP: {response.status_code}: {body}")
+
+    try:
+        data = response.json()
+    except ValueError as exc:
+        raise BrowserRpcError("RPC returned non-JSON response")
+
+    if not isinstance(data, dict):
+        raise BrowserRpcError("RPC returned invalid payload type")
+
+    return data