narada 0.1.30__tar.gz → 0.1.32__tar.gz

{narada-0.1.30 → narada-0.1.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: narada
-Version: 0.1.30
+Version: 0.1.32
 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
@@ -9,7 +9,7 @@ Author-email: Narada <support@narada.ai>
 License-Expression: Apache-2.0
 Requires-Python: >=3.12
 Requires-Dist: aiohttp>=3.12.13
-Requires-Dist: narada-core==0.0.8
+Requires-Dist: narada-core==0.0.10
 Requires-Dist: playwright>=1.53.0
 Requires-Dist: rich>=14.0.0
 Requires-Dist: semver>=3.0.4

{narada-0.1.30 → narada-0.1.32}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "narada"
-version = "0.1.30"
+version = "0.1.32"
 description = "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.8",
+    "narada-core==0.0.10",
     "aiohttp>=3.12.13",
     "playwright>=1.53.0",
     "rich>=14.0.0",

{narada-0.1.30 → narada-0.1.32}/src/narada/__init__.py

@@ -1,3 +1,8 @@
+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_core.errors import (
     NaradaError,
     NaradaExtensionMissingError,
@@ -8,12 +13,6 @@ from narada_core.errors import (
 )
 from narada_core.models import Agent, File, Response, ResponseContent
 
-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
-
 __all__ = [
     "__version__",
     "Agent",

{narada-0.1.30 → narada-0.1.32}/src/narada/client.py

@@ -11,6 +11,10 @@ from uuid import uuid4
 
 import aiohttp
 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_core.errors import (
     NaradaExtensionMissingError,
     NaradaExtensionUnauthenticatedError,
@@ -26,19 +30,14 @@ from playwright.async_api import (
     ElementHandle,
     Page,
     Playwright,
-    async_playwright,
 )
+from playwright.async_api import TimeoutError as PlaywrightTimeoutError
 from playwright.async_api import (
-    TimeoutError as PlaywrightTimeoutError,
+    async_playwright,
 )
 from playwright.async_api._context_manager import PlaywrightContextManager
 from rich.console import Console
 
-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
-
 
 @dataclass
 class _LaunchBrowserResult:

{narada-0.1.30 → narada-0.1.32}/src/narada/window.py

@@ -4,28 +4,35 @@ import time
 from abc import ABC
 from http import HTTPStatus
 from pathlib import Path
-from typing import IO, Any, Optional, TypeVar, overload
+from typing import IO, Any, TypeVar, overload
 
 import aiohttp
+from narada.config import BrowserConfig
 from narada_core.actions.models import (
-    ActionTraceItem,
+    AgenticMouseAction,
+    AgenticMouseActionRequest,
     AgenticSelectorAction,
     AgenticSelectorRequest,
     AgenticSelectorResponse,
-    AgenticMouseActionRequest,
-    AgenticMouseAction,
     AgenticSelectors,
     AgentResponse,
     AgentUsage,
     CloseWindowRequest,
     ExtensionActionRequest,
     ExtensionActionResponse,
+    GetFullHtmlRequest,
+    GetFullHtmlResponse,
+    GetScreenshotRequest,
+    GetScreenshotResponse,
+    GetSimplifiedHtmlRequest,
+    GetSimplifiedHtmlResponse,
     GoToUrlRequest,
     PrintMessageRequest,
     ReadGoogleSheetRequest,
     ReadGoogleSheetResponse,
-    WriteGoogleSheetRequest,
     RecordedClick,
+    WriteGoogleSheetRequest,
+    parse_action_trace,
 )
 from narada_core.errors import (
     NaradaAgentTimeoutError_INTERNAL_DO_NOT_USE,
@@ -35,6 +42,7 @@ from narada_core.errors import (
 from narada_core.models import (
     Agent,
     File,
+    McpServer,
     RemoteDispatchChatHistoryItem,
     Response,
     UserResourceCredentials,
@@ -42,8 +50,6 @@ from narada_core.models import (
 from playwright.async_api import BrowserContext
 from pydantic import BaseModel
 
-from narada.config import BrowserConfig
-
 _StructuredOutput = TypeVar("_StructuredOutput", bound=BaseModel)
 
 
@@ -123,6 +129,7 @@ class BaseBrowserWindow(ABC):
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
         user_resource_credentials: UserResourceCredentials | None = None,
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         callback_url: str | None = None,
         callback_secret: str | None = None,
@@ -145,6 +152,7 @@ class BaseBrowserWindow(ABC):
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
         user_resource_credentials: UserResourceCredentials | None = None,
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         callback_url: str | None = None,
         callback_secret: str | None = None,
@@ -166,6 +174,7 @@ class BaseBrowserWindow(ABC):
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
         user_resource_credentials: UserResourceCredentials | None = None,
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         callback_url: str | None = None,
         callback_secret: str | None = None,
@@ -207,6 +216,10 @@ class BaseBrowserWindow(ABC):
             body["attachment"] = attachment
         if user_resource_credentials is not None:
             body["userResourceCredentials"] = user_resource_credentials
+        if mcp_servers is not None:
+            body["mcpServers"] = [
+                server.model_dump(mode="json") for server in mcp_servers
+            ]
         if variables is not None:
             body["variables"] = variables
         if callback_url is not None:
@@ -272,6 +285,7 @@ class BaseBrowserWindow(ABC):
         output_schema: None = None,
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         timeout: int = 1000,
     ) -> AgentResponse[None]: ...
@@ -287,6 +301,7 @@ class BaseBrowserWindow(ABC):
         output_schema: type[_StructuredOutput],
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         timeout: int = 1000,
     ) -> AgentResponse[_StructuredOutput]: ...
@@ -301,6 +316,7 @@ class BaseBrowserWindow(ABC):
         output_schema: type[BaseModel] | None = None,
         attachment: File | None = None,
         time_zone: str = "America/Los_Angeles",
+        mcp_servers: list[McpServer] | None = None,
         variables: dict[str, str] | None = None,
         timeout: int = 1000,
     ) -> AgentResponse:
@@ -313,6 +329,7 @@ class BaseBrowserWindow(ABC):
             output_schema=output_schema,
             attachment=attachment,
             time_zone=time_zone,
+            mcp_servers=mcp_servers,
             variables=variables,
             timeout=timeout,
         )
@@ -321,7 +338,7 @@ class BaseBrowserWindow(ABC):
 
         action_trace_raw = response_content.get("actionTrace")
         action_trace = (
-            [ActionTraceItem.model_validate(item) for item in action_trace_raw]
+            parse_action_trace(action_trace_raw)
             if action_trace_raw is not None
             else None
         )
@@ -356,14 +373,13 @@ class BaseBrowserWindow(ABC):
             AgenticSelectorRequest(
                 action=action,
                 selectors=selectors,
-                response_model=response_model,
                 fallback_operator_query=fallback_operator_query,
             ),
             timeout=timeout,
         )
 
         if result is None:
-            return {"value": None}
+            return AgenticSelectorResponse(value=None)
 
         return result
 
@@ -437,6 +453,34 @@ class BaseBrowserWindow(ABC):
             timeout=timeout,
         )
 
+    async def get_full_html(self, *, timeout: int | None = None) -> GetFullHtmlResponse:
+        """Gets the full HTML content of the current page."""
+        return await self._run_extension_action(
+            GetFullHtmlRequest(),
+            GetFullHtmlResponse,
+            timeout=timeout,
+        )
+
+    async def get_simplified_html(
+        self, *, timeout: int | None = None
+    ) -> GetSimplifiedHtmlResponse:
+        """Gets the simplified HTML content of the current page."""
+        return await self._run_extension_action(
+            GetSimplifiedHtmlRequest(),
+            GetSimplifiedHtmlResponse,
+            timeout=timeout,
+        )
+
+    async def get_screenshot(
+        self, *, timeout: int | None = None
+    ) -> GetScreenshotResponse:
+        """Takes a screenshot of the current browser window."""
+        return await self._run_extension_action(
+            GetScreenshotRequest(),
+            GetScreenshotResponse,
+            timeout=timeout,
+        )
+
     @overload
     async def _run_extension_action(
         self,