narada 0.1.26__py3-none-any.whl → 0.1.28__py3-none-any.whl

narada/__init__.py

@@ -1,5 +1,3 @@
-import importlib.metadata
-
 from narada_core.errors import (
     NaradaError,
     NaradaExtensionMissingError,
@@ -12,20 +10,15 @@ from narada_core.models import Agent, File, Response, ResponseContent
 
 from narada.client import Narada
 from narada.config import BrowserConfig
-from narada.render_html import render_html
+from narada.utils import download_file, render_html
+from narada.version import __version__
 from narada.window import LocalBrowserWindow, RemoteBrowserWindow
 
-# Get version from package metadata
-try:
-    __version__ = importlib.metadata.version("narada")
-except Exception:
-    # Fallback version if package metadata is not available
-    __version__ = "unknown"
-
 __all__ = [
     "__version__",
     "Agent",
     "BrowserConfig",
+    "download_file",
     "File",
     "LocalBrowserWindow",
     "Narada",

narada/client.py

@@ -9,6 +9,8 @@ from dataclasses import dataclass
 from typing import Any
 from uuid import uuid4
 
+import aiohttp
+import semver
 from narada_core.errors import (
     NaradaExtensionMissingError,
     NaradaExtensionUnauthenticatedError,
@@ -16,6 +18,7 @@ from narada_core.errors import (
     NaradaTimeoutError,
     NaradaUnsupportedBrowserError,
 )
+from narada_core.models import _SdkConfig
 from playwright._impl._errors import Error as PlaywrightError
 from playwright.async_api import (
     ElementHandle,
@@ -31,6 +34,7 @@ from rich.console import Console
 
 from narada.config import BrowserConfig
 from narada.utils import assert_never
+from narada.version import __version__
 from narada.window import LocalBrowserWindow, create_side_panel_url
 
 
@@ -58,6 +62,8 @@ class Narada:
         self._console = Console()
 
     async def __aenter__(self) -> Narada:
+        await self._validate_sdk_config()
+
         self._playwright_context_manager = async_playwright()
         self._playwright = await self._playwright_context_manager.__aenter__()
         return self
@@ -70,6 +76,40 @@ class Narada:
         self._playwright_context_manager = None
         self._playwright = None
 
+    async def _fetch_sdk_config(self) -> _SdkConfig | None:
+        base_url = os.getenv("NARADA_API_BASE_URL", "https://api.narada.ai/fast/v2")
+        url = f"{base_url}/sdk/config"
+
+        try:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(
+                    url, headers={"x-api-key": self._api_key}
+                ) as resp:
+                    if not resp.ok:
+                        logging.warning(
+                            "Failed to fetch SDK config: %s %s",
+                            resp.status,
+                            await resp.text(),
+                        )
+                        return None
+
+                    return _SdkConfig.model_validate(await resp.json())
+        except Exception as e:
+            logging.warning("Failed to fetch SDK config: %s", e)
+            return None
+
+    async def _validate_sdk_config(self) -> None:
+        config = await self._fetch_sdk_config()
+        if config is None:
+            return
+
+        package_config = config.packages["narada"]
+        if semver.compare(__version__, package_config.min_required_version) < 0:
+            raise RuntimeError(
+                f"narada<={__version__} is not supported. Please upgrade to version "
+                f"{package_config.min_required_version} or higher."
+            )
+
     async def open_and_initialize_browser_window(
         self, config: BrowserConfig | None = None
     ) -> LocalBrowserWindow:

narada/utils.py

@@ -1,5 +1,46 @@
+import webbrowser
+from pathlib import Path
+from tempfile import NamedTemporaryFile
 from typing import Never
 
 
 def assert_never() -> Never:
     raise AssertionError("Expected code to be unreachable")
+
+
+def download_file(filename: str, content: str | bytes) -> None:
+    """
+    Downloads a file to the user's Downloads directory.
+
+    Args:
+        filename: The name of the file to save. Can include subdirectories
+                  (e.g., "reports/2025/data.csv") relative to the Downloads
+                  directory.
+        content: The content to write. If str, writes in text mode (UTF-8).
+                 If bytes, writes in binary mode.
+    """
+    path = Path.home() / "Downloads" / filename
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if isinstance(content, str):
+        path.write_text(content, encoding="utf-8")
+    else:
+        path.write_bytes(content)
+
+
+def render_html(html: str) -> None:
+    """
+    Renders HTML content by opening it in the default browser.
+
+    Args:
+        html: The HTML content to render.
+    """
+    with NamedTemporaryFile(
+        mode="w+t",
+        encoding="utf-8",
+        suffix=".html",
+        delete=False,
+    ) as temp:
+        temp.write(html)
+        path = temp.name
+
+    webbrowser.open_new_tab(f"file://{path}")

narada/version.py

@@ -0,0 +1,7 @@
+import importlib.metadata
+
+try:
+    __version__ = importlib.metadata.version("narada")
+except Exception:
+    # Fallback version if package metadata is not available
+    __version__ = "unknown"

{narada-0.1.26.dist-info → narada-0.1.28.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: narada
-Version: 0.1.26
+Version: 0.1.28
 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,9 +9,10 @@ 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.5
+Requires-Dist: narada-core==0.0.6
 Requires-Dist: playwright>=1.53.0
 Requires-Dist: rich>=14.0.0
+Requires-Dist: semver>=3.0.4
 Description-Content-Type: text/markdown
 
 <p align="center">

narada-0.1.28.dist-info/RECORD

@@ -0,0 +1,10 @@
+narada/__init__.py,sha256=Jk941BV4iy70Ei2MmHkNXEOkZUHBa6Lij_jZZRfiyhg,936
+narada/client.py,sha256=r_aBtqVYEBsr5N9E79qzl8q498F6cnSyejqZWSbB4qU,16768
+narada/config.py,sha256=tvj16P_qAHOFB2O_VlrcizA8SrbmS_Nmkm2r7ltG-VM,1345
+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=OGuEs778xjxHivzWlJIIHKZPqGd4Sn9_YVArt_8TYoU,17762
+narada-0.1.28.dist-info/METADATA,sha256=jVmIONyot5rg8HLvqMIpSIjj2h25ycOoTbQcnb_8TnQ,5146
+narada-0.1.28.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+narada-0.1.28.dist-info/RECORD,,

{narada-0.1.26.dist-info → narada-0.1.28.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

narada/render_html.py

@@ -1,21 +0,0 @@
-import webbrowser
-from tempfile import NamedTemporaryFile
-
-
-def render_html(html: str) -> None:
-    """
-    Renders HTML content by opening it in the default browser.
-
-    Args:
-        html: The HTML content to render.
-    """
-    with NamedTemporaryFile(
-        mode="w+t",
-        encoding="utf-8",
-        suffix=".html",
-        delete=False,
-    ) as temp:
-        temp.write(html)
-        path = temp.name
-
-    webbrowser.open_new_tab(f"file://{path}")

narada-0.1.26.dist-info/RECORD

@@ -1,10 +0,0 @@
-narada/__init__.py,sha256=kGBirP2C3ENrBHpSQ2wEKZe0kTFCRBJSnImiSqVYeRk,1097
-narada/client.py,sha256=jksBBWdSJP88fP1DpLYoyJNNdgkUMrEKlcuYenARzaI,15265
-narada/config.py,sha256=tvj16P_qAHOFB2O_VlrcizA8SrbmS_Nmkm2r7ltG-VM,1345
-narada/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-narada/render_html.py,sha256=uJgh6AApSl6KJHEpj8KGbZrukOn7Z8sU1EWkRVVwI2Y,461
-narada/utils.py,sha256=6NxADP1BxWLYLv40tAFlaGVxoyA_7k3dPUA-sFBQIZw,116
-narada/window.py,sha256=OGuEs778xjxHivzWlJIIHKZPqGd4Sn9_YVArt_8TYoU,17762
-narada-0.1.26.dist-info/METADATA,sha256=btpib6q-h8LelhpEj-hPp_IXyVKEUtoHpf7hZvuYmPw,5117
-narada-0.1.26.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-narada-0.1.26.dist-info/RECORD,,