narada 0.1.32__py3-none-any.whl → 0.1.33a1__py3-none-any.whl

narada/__init__.py

@@ -2,7 +2,7 @@ from narada.client import Narada
 from narada.config import BrowserConfig, ProxyConfig
 from narada.utils import download_file, render_html
 from narada.version import __version__
-from narada.window import LocalBrowserWindow, RemoteBrowserWindow
+from narada.window import CloudBrowserWindow, LocalBrowserWindow, RemoteBrowserWindow
 from narada_core.errors import (
     NaradaError,
     NaradaExtensionMissingError,
@@ -17,6 +17,7 @@ __all__ = [
     "__version__",
     "Agent",
     "BrowserConfig",
+    "CloudBrowserWindow",
     "download_file",
     "File",
     "LocalBrowserWindow",

narada/client.py

@@ -14,7 +14,11 @@ import semver
 from narada.config import BrowserConfig, ProxyConfig
 from narada.utils import assert_never
 from narada.version import __version__
-from narada.window import LocalBrowserWindow, create_side_panel_url
+from narada.window import (
+    LocalBrowserWindow,
+    CloudBrowserWindow,
+    create_side_panel_url,
+)
 from narada_core.errors import (
     NaradaExtensionMissingError,
     NaradaExtensionUnauthenticatedError,
@@ -57,10 +61,12 @@ class Narada:
     _console: Console
     _playwright_context_manager: PlaywrightContextManager | None = None
     _playwright: Playwright | None = None
+    _cloud_windows: set[CloudBrowserWindow]
 
     def __init__(self, *, api_key: str | None = None) -> None:
         self._api_key = api_key or os.environ["NARADA_API_KEY"]
         self._console = Console()
+        self._cloud_windows = set()
 
     async def __aenter__(self) -> Narada:
         await self._validate_sdk_config()
@@ -70,6 +76,11 @@ class Narada:
         return self
 
     async def __aexit__(self, *args: Any) -> None:
+        async with asyncio.TaskGroup() as tg:
+            for cloud_window in self._cloud_windows:
+                tg.create_task(cloud_window.cleanup())
+        self._cloud_windows.clear()
+
         if self._playwright_context_manager is None:
             return
 
@@ -133,6 +144,121 @@ class Narada:
             context=side_panel_page.context,
         )
 
+    async def open_and_initialize_cloud_browser_window(
+        self,
+        config: BrowserConfig | None = None,
+        session_name: str | None = None,
+        session_timeout: int | None = None,
+    ) -> CloudBrowserWindow:
+        """Creates a cloud browser by calling the backend.
+
+        The backend creates a cloud browser session and returns
+        a CDP WebSocket URL. This method connects to it, initializes the extension,
+        and returns a CloudBrowserWindow instance.
+        """
+        assert self._playwright is not None
+        playwright = self._playwright
+
+        config = config or BrowserConfig()
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
+        request_body = {
+            "session_name": session_name,
+            "session_timeout": session_timeout,
+        }
+        endpoint_url = f"{base_url}/cloud-browser/create-cloud-browser-session"
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                endpoint_url,
+                headers={"x-api-key": self._api_key},
+                json=request_body,
+                timeout=aiohttp.ClientTimeout(
+                    total=180
+                ),  # 3 minutes for session startup
+            ) as resp:
+                if not resp.ok:
+                    error_text = await resp.text()
+                    raise RuntimeError(
+                        f"Failed to create cloud browser session: {resp.status} {error_text}\n"
+                        f"Endpoint URL: {endpoint_url}"
+                    )
+                response_data = await resp.json()
+
+        cdp_websocket_url = response_data["cdp_websocket_url"]
+        session_id = response_data["session_id"]
+        login_url = response_data["login_url"]
+        cdp_auth_headers = response_data.get("cdp_auth_headers")
+
+        # Connect to browser via CDP with authentication headers
+        try:
+            browser = await playwright.chromium.connect_over_cdp(
+                cdp_websocket_url, headers=cdp_auth_headers
+            )
+        except Exception:
+            # Clean up the session if CDP connection fails
+            try:
+                async with aiohttp.ClientSession() as cleanup_session:
+                    async with cleanup_session.post(
+                        f"{base_url}/cloud-browser/stop-cloud-browser-session",
+                        headers={"x-api-key": self._api_key},
+                        json={"session_id": session_id},
+                        timeout=aiohttp.ClientTimeout(total=10),
+                    ) as resp:
+                        if resp.ok:
+                            logging.info(
+                                f"Cleaned up session {session_id} after CDP connection failure"
+                            )
+                        else:
+                            logging.warning(
+                                f"Failed to cleanup session {session_id}: {resp.status}"
+                            )
+            except Exception as cleanup_error:
+                logging.warning(
+                    f"Error cleaning up session {session_id}: {cleanup_error}"
+                )
+            # Re-raise the original connection error
+            raise
+        context = (
+            browser.contexts[0] if browser.contexts else await browser.new_context()
+        )
+
+        # Navigate to login URL (provided by backend with custom token)
+        initialization_page = await context.new_page()
+        await initialization_page.goto(
+            login_url, wait_until="domcontentloaded", timeout=60_000
+        )
+
+        # Wait for sign-in to process to complete.
+        await asyncio.sleep(15)  # TODO: improve it in the future
+        await initialization_page.reload(wait_until="domcontentloaded", timeout=60_000)
+
+        # Wait for browser window ID
+        browser_window_id = await self._wait_for_browser_window_id(
+            initialization_page, config
+        )
+
+        # TODO: consider this
+        # Get side panel page
+        # side_panel_url = create_side_panel_url(config, browser_window_id)
+        # side_panel_page = next(
+        #     (p for p in context.pages if p.url == side_panel_url), None
+        # )
+        # await self._fix_download_behavior(side_panel_page)
+
+        cloud_window = CloudBrowserWindow(
+            browser_window_id=browser_window_id,
+            session_id=session_id,
+            api_key=self._api_key,
+        )
+
+        # Track the window for cleanup in __aexit__
+        self._cloud_windows.add(cloud_window)
+
+        if config.interactive:
+            self._print_success_message(browser_window_id)
+
+        return cloud_window
+
     async def initialize_in_existing_browser_window(
         self, config: BrowserConfig | None = None
     ) -> LocalBrowserWindow:

narada/window.py

@@ -1,4 +1,5 @@
 import asyncio
+import logging
 import os
 import time
 from abc import ABC
@@ -47,9 +48,13 @@ from narada_core.models import (
     Response,
     UserResourceCredentials,
 )
-from playwright.async_api import BrowserContext
+from playwright.async_api import (
+    BrowserContext,
+)
 from pydantic import BaseModel
 
+logger = logging.getLogger(__name__)
+
 _StructuredOutput = TypeVar("_StructuredOutput", bound=BaseModel)
 
 
@@ -552,9 +557,10 @@ class LocalBrowserWindow(BaseBrowserWindow):
         config: BrowserConfig,
         context: BrowserContext,
     ) -> None:
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
         super().__init__(
             api_key=api_key,
-            base_url=os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2"),
+            base_url=base_url,
             browser_window_id=browser_window_id,
         )
         self._browser_process_id = browser_process_id
@@ -586,9 +592,10 @@ class LocalBrowserWindow(BaseBrowserWindow):
 
 class RemoteBrowserWindow(BaseBrowserWindow):
     def __init__(self, *, browser_window_id: str, api_key: str | None = None) -> None:
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
         super().__init__(
             api_key=api_key or os.environ["NARADA_API_KEY"],
-            base_url=os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2"),
+            base_url=base_url,
             browser_window_id=browser_window_id,
         )
 
@@ -596,5 +603,51 @@ class RemoteBrowserWindow(BaseBrowserWindow):
         return f"RemoteBrowserWindow(browser_window_id={self.browser_window_id})"
 
 
+class CloudBrowserWindow(BaseBrowserWindow):
+    """A browser window that connects to a backend-cloud browser session via CDP.
+
+    This class connects to a cloud browser session created by the backend API and provides
+    the same interface as other browser window classes for agent operations.
+    """
+
+    def __init__(
+        self,
+        *,
+        browser_window_id: str,
+        session_id: str,
+        api_key: str | None = None,
+    ) -> None:
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
+        super().__init__(
+            api_key=api_key or os.environ["NARADA_API_KEY"],
+            base_url=base_url,
+            browser_window_id=browser_window_id,
+        )
+        self._session_id = session_id
+
+    async def cleanup(self) -> None:
+        """Stop the cloud browser session."""
+        try:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    f"{self._base_url}/cloud-browser/stop-cloud-browser-session",
+                    headers={"x-api-key": self._api_key},
+                    json={
+                        "session_id": self._session_id,
+                    },
+                    timeout=aiohttp.ClientTimeout(total=10),
+                ) as resp:
+                    if resp.ok:
+                        response_data = await resp.json()
+                        if not response_data.get("success"):
+                            logger.warning(
+                                f"Failed to stop session: {response_data.get('message')}"
+                            )
+                    else:
+                        logger.warning(f"Failed to stop session: {resp.status}")
+        except Exception as e:
+            logger.warning(f"Error calling stop session endpoint: {e}")
+
+
 def create_side_panel_url(config: BrowserConfig, browser_window_id: str) -> str:
     return f"chrome-extension://{config.extension_id}/sidepanel.html?browserWindowId={browser_window_id}"

{narada-0.1.32.dist-info → narada-0.1.33a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: narada
-Version: 0.1.32
+Version: 0.1.33a1
 Summary: Python client SDK for Narada
 Project-URL: Homepage, https://github.com/NaradaAI/narada-python-sdk/narada
 Project-URL: Repository, https://github.com/NaradaAI/narada-python-sdk

narada-0.1.33a1.dist-info/RECORD

@@ -0,0 +1,10 @@
+narada/__init__.py,sha256=gVa9HUFTeHot7VR2XPtCEsVeRiK7MDJJvKU1eEhLqXQ,1013
+narada/client.py,sha256=Ea-zyJo6rZCQNi1higShelILkR9FLpNrtYoFse7heUA,26630
+narada/config.py,sha256=S0B8GNd-0td_69oKaPN60WAq_ODeYU7avE_KAxN5vCg,3052
+narada/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+narada/utils.py,sha256=gdLwNMXPpRohDcIIe0cB3KhvZ8X1QfAlKVh1sXWeJmk,1284
+narada/version.py,sha256=kwW6yy0_4Pf3kt888eeCG0VwBb2L2rCkrkpdZEC_3rA,193
+narada/window.py,sha256=e3pXn-wQMKm8QRvtAKfep0iGQE2LP9doP85z1t6VVpI,23036
+narada-0.1.33a1.dist-info/METADATA,sha256=e3h7vEqdOHWEedcZw83trCPHVUPUry3FiE8gWu1aifM,5149
+narada-0.1.33a1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+narada-0.1.33a1.dist-info/RECORD,,

narada-0.1.32.dist-info/RECORD

@@ -1,10 +0,0 @@
-narada/__init__.py,sha256=HPaTpe3-kHtuFxtdADlFTaPWTyZx5RaKdbt9o9YpTYE,967
-narada/client.py,sha256=GHz4iFsQmvPMfes1gBED6sSdi0tdIpZx6ttFNSeRpFg,21649
-narada/config.py,sha256=S0B8GNd-0td_69oKaPN60WAq_ODeYU7avE_KAxN5vCg,3052
-narada/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-narada/utils.py,sha256=gdLwNMXPpRohDcIIe0cB3KhvZ8X1QfAlKVh1sXWeJmk,1284
-narada/version.py,sha256=kwW6yy0_4Pf3kt888eeCG0VwBb2L2rCkrkpdZEC_3rA,193
-narada/window.py,sha256=YpIiukGcSVGimLB1sJIUII1Nte29YfvoiOp2SUVldZE,21104
-narada-0.1.32.dist-info/METADATA,sha256=XrG2QDIePHLKCuSwAx5GHNceWQ02LD6WZCdVjf4Mbgs,5147
-narada-0.1.32.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-narada-0.1.32.dist-info/RECORD,,