Add cloud browser support to narada-pyodide

packages/narada-core/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "narada-core"
-version = "0.0.17"
+version = "0.0.18"
 description = "Code shared by the `narada` and `narada-pyodide` packages."
 license = "Apache-2.0"
 readme = "README.md"

packages/narada-pyodide/pyproject.toml

@@ -1,14 +1,14 @@
 
 [project]
 name = "narada-pyodide"
-version = "0.0.43"
+version = "0.0.44"
 description = "Pyodide-compatible Python client SDK for Narada"
 license = "Apache-2.0"
 readme = "README.md"
 authors = [{ name = "Narada", email = "support@narada.ai" }]
 requires-python = ">=3.12"
 dependencies = [
-    "narada-core==0.0.17",
+    "narada-core==0.0.18",
     # Must be a supported version in https://pyodide.org/en/stable/usage/packages-in-pyodide.html
     "packaging==24.2",
 ]
@@ -23,7 +23,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [dependency-groups]
-dev = ["pyodide-py>=0.27.7"]
+dev = ["pyodide-py>=0.27.7", "pytest>=8.4.1", "pytest-asyncio>=1.0.0"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/narada"]

packages/narada-pyodide/src/narada/__init__.py

@@ -1,19 +1,22 @@
+from narada_core.errors import (
+    NaradaError,
+    NaradaTimeoutError,
+)
+from narada_core.models import Agent, File, Response, ResponseContent
+
 from narada.client import Narada
 from narada.utils import download_file, render_html
 from narada.version import __version__
 from narada.window import (
+    CloudBrowserWindow,
     LocalBrowserWindow,
     RemoteBrowserWindow,
 )
-from narada_core.errors import (
-    NaradaError,
-    NaradaTimeoutError,
-)
-from narada_core.models import Agent, File, Response, ResponseContent
 
 __all__ = [
     "__version__",
     "Agent",
+    "CloudBrowserWindow",
     "download_file",
     "File",
     "LocalBrowserWindow",

packages/narada-pyodide/src/narada/client.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 import logging
 import os
 from typing import Any
@@ -9,6 +10,7 @@
 from pyodide.http import pyfetch
 
 from narada.version import __version__
+from narada.window import CloudBrowserWindow
 
 
 class Narada:
@@ -52,3 +54,43 @@ async def _validate_sdk_config(self) -> None:
                 f"narada-pyodide<={__version__} is not supported. Please reload the page to "
                 f"upgrade to version {package_config.min_required_version} or higher."
             )
+
+    async def open_and_initialize_cloud_browser_window(
+        self,
+        *,
+        session_name: str | None = None,
+        session_timeout: int | None = None,
+        require_extension: bool = True,
+    ) -> CloudBrowserWindow:
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
+        endpoint_url = (
+            f"{base_url}/cloud-browser/create-and-initialize-cloud-browser-session"
+        )
+        request_body = {
+            "session_name": session_name,
+            "session_timeout": session_timeout,
+            "require_extension": require_extension,
+        }
+
+        resp = await pyfetch(
+            endpoint_url,
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "x-api-key": self._api_key,
+            },
+            body=json.dumps(request_body),
+        )
+        if not resp.ok:
+            raise RuntimeError(
+                "Failed to create and initialize cloud browser session: "
+                f"{resp.status} {await resp.text()}\n"
+                f"Endpoint URL: {endpoint_url}"
+            )
+
+        response_data = await resp.json()
+        return CloudBrowserWindow(
+            browser_window_id=response_data["browser_window_id"],
+            session_id=response_data["session_id"],
+            api_key=self._api_key,
+        )