narada 0.1.26__tar.gz → 0.1.28__tar.gz

{narada-0.1.26 → narada-0.1.28}/PKG-INFO

@@ -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.26 → narada-0.1.28}/pyproject.toml

@@ -1,16 +1,17 @@
 [project]
 name = "narada"
-version = "0.1.26"
+version = "0.1.28"
 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.5",
+    "narada-core==0.0.6",
     "aiohttp>=3.12.13",
     "playwright>=1.53.0",
     "rich>=14.0.0",
+    "semver>=3.0.4",
 ]
 
 [project.urls]

{narada-0.1.26 → narada-0.1.28}/src/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-0.1.26 → narada-0.1.28}/src/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-0.1.28/src/narada/utils.py

@@ -0,0 +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-0.1.28/src/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/src/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/src/narada/utils.py

@@ -1,5 +0,0 @@
-from typing import Never
-
-
-def assert_never() -> Never:
-    raise AssertionError("Expected code to be unreachable")