praisonai-browser 0.0.1__tar.gz

praisonai_browser-0.0.1/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: praisonai-browser
+Version: 0.0.1
+Summary: Browser automation for PraisonAI — Chrome extension bridge, CDP, and Playwright agents extracted from the praisonai wrapper.
+Author: Mervin Praison
+License: MIT
+Project-URL: Homepage, https://docs.praison.ai
+Project-URL: Repository, https://github.com/mervinpraison/PraisonAI
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: praisonaiagents>=1.6.126
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12.0
+Requires-Dist: click>=8.4.2
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110.0; extra == "server"
+Requires-Dist: uvicorn>=0.27.0; extra == "server"
+Requires-Dist: websockets>=12.0; extra == "server"
+Requires-Dist: aiohttp>=3.9.0; extra == "server"
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40.0; extra == "playwright"
+Provides-Extra: all
+Requires-Dist: praisonai-browser[playwright,server]; extra == "all"
+
+# PraisonAI Browser
+
+Browser automation for [PraisonAI](https://github.com/mervinpraison/PraisonAI) — Chrome extension bridge, CDP/hybrid agents, and Playwright automation as a standalone package or part of the full `praisonai` stack.
+
+## Install
+
+```bash
+pip install "praisonai-browser[all]"
+
+# Or via the umbrella product
+pip install "praisonai[browser]"
+```
+
+## Quickstart
+
+```bash
+praisonai-browser start --port 8765
+praisonai-browser run "Search for AI news on Google"
+praisonai-browser doctor
+```
+
+With the full stack: `praisonai browser start`, `praisonai browser run "..."`.
+
+## Stack
+
+```
+praisonaiagents  (browser protocols)
+   └── praisonai-browser  (this package)
+        └── praisonai     (wrapper shims: praisonai.browser.*)
+```
+
+Old import paths (`praisonai.browser`, `python -m praisonai.browser.server`) keep working via wrapper shims.
+
+Boundary details: `src/praisonai/tests/PRAISONAI_BROWSER_MANIFEST.md`.

praisonai_browser-0.0.1/README.md

@@ -0,0 +1,34 @@
+# PraisonAI Browser
+
+Browser automation for [PraisonAI](https://github.com/mervinpraison/PraisonAI) — Chrome extension bridge, CDP/hybrid agents, and Playwright automation as a standalone package or part of the full `praisonai` stack.
+
+## Install
+
+```bash
+pip install "praisonai-browser[all]"
+
+# Or via the umbrella product
+pip install "praisonai[browser]"
+```
+
+## Quickstart
+
+```bash
+praisonai-browser start --port 8765
+praisonai-browser run "Search for AI news on Google"
+praisonai-browser doctor
+```
+
+With the full stack: `praisonai browser start`, `praisonai browser run "..."`.
+
+## Stack
+
+```
+praisonaiagents  (browser protocols)
+   └── praisonai-browser  (this package)
+        └── praisonai     (wrapper shims: praisonai.browser.*)
+```
+
+Old import paths (`praisonai.browser`, `python -m praisonai.browser.server`) keep working via wrapper shims.
+
+Boundary details: `src/praisonai/tests/PRAISONAI_BROWSER_MANIFEST.md`.

praisonai_browser-0.0.1/praisonai_browser/__init__.py

@@ -0,0 +1,48 @@
+"""Browser automation package for PraisonAI.
+
+Provides a bridge server for Chrome Extension ↔ PraisonAI Agent communication.
+
+Example:
+    praisonai-browser start --port 8765
+
+    from praisonai_browser import BrowserServer
+    server = BrowserServer(port=8765)
+    server.start()
+"""
+
+from __future__ import annotations
+
+from praisonai_browser._version import __version__
+
+
+def __getattr__(name: str):
+    if name == "BrowserServer":
+        from .server import BrowserServer
+        return BrowserServer
+    if name == "BrowserAgent":
+        from .agent import BrowserAgent
+        return BrowserAgent
+    if name == "SessionManager":
+        from .sessions import SessionManager
+        return SessionManager
+    if name == "CDPBrowserAgent":
+        from .cdp_agent import CDPBrowserAgent
+        return CDPBrowserAgent
+    if name == "run_cdp_only":
+        from .cdp_agent import run_cdp_only
+        return run_cdp_only
+    if name == "run_hybrid":
+        from .cdp_agent import run_hybrid
+        return run_hybrid
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "__version__",
+    "BrowserServer",
+    "BrowserAgent",
+    "SessionManager",
+    "CDPBrowserAgent",
+    "run_cdp_only",
+    "run_hybrid",
+]

praisonai_browser-0.0.1/praisonai_browser/__main__.py

@@ -0,0 +1,18 @@
+"""Console entry: ``praisonai-browser``."""
+
+from __future__ import annotations
+
+import sys
+
+
+def main(argv: list[str] | None = None) -> None:
+    from praisonai_browser.cli.app import app
+
+    args = argv if argv is not None else sys.argv[1:]
+    if not args:
+        args = ["--help"]
+    app(args=args, prog_name="praisonai-browser")
+
+
+if __name__ == "__main__":
+    main()

praisonai_browser-0.0.1/praisonai_browser/_protocol_bridge.py

@@ -0,0 +1,75 @@
+"""Map between agents-tier browser protocols and praisonai_browser runtime dicts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Union
+
+from praisonaiagents.tools.protocols.browser import (
+    BrowserAction,
+    BrowserActionType,
+    BrowserObservation,
+    BrowserSession,
+)
+
+# Agent/runtime actions that extend the base protocol enum (now in BrowserActionType).
+_EXTRA_ACTIONS = frozenset()
+
+
+def observation_from_dict(data: Dict[str, Any]) -> BrowserObservation:
+    """Convert a runtime observation dict to agents-tier ``BrowserObservation``."""
+    return BrowserObservation.from_dict(data)
+
+
+def observation_to_dict(observation: Union[BrowserObservation, Dict[str, Any]]) -> Dict[str, Any]:
+    if isinstance(observation, BrowserObservation):
+        return observation.to_dict()
+    return observation
+
+
+def _action_type_from_name(name: str) -> Union[BrowserActionType, str]:
+    try:
+        return BrowserActionType(name)
+    except ValueError:
+        # Extra actions extend the base protocol enum; pass them through as
+        # strings (BrowserActionType is a str subclass, so this stays compatible).
+        if name in _EXTRA_ACTIONS:
+            return name
+        return BrowserActionType.WAIT
+
+
+def action_from_agent_dict(data: Dict[str, Any]) -> BrowserAction:
+    """Convert agent/runtime action dict to agents-tier ``BrowserAction``."""
+    raw = data.get("action", "wait")
+    action_type = _action_type_from_name(str(raw))
+    text = data.get("text") or data.get("value")
+    return BrowserAction(
+        action=action_type,
+        selector=data.get("selector"),
+        text=text,
+        url=data.get("url"),
+        direction=data.get("direction"),
+        thought=data.get("thought", ""),
+        done=bool(data.get("done", False)),
+        error=data.get("error"),
+    )
+
+
+def action_to_agent_dict(action: BrowserAction) -> Dict[str, Any]:
+    """Convert agents-tier action to runtime dict (extension/CDP wire format)."""
+    payload = action.to_dict()
+    if action.text is not None:
+        payload["value"] = action.text
+    return payload
+
+
+def session_from_dict(data: Dict[str, Any]) -> BrowserSession:
+    return BrowserSession(
+        session_id=data.get("session_id", data.get("id", "")),
+        goal=data.get("goal", data.get("task", "")),
+        status=data.get("status", "pending"),
+        steps=data.get("steps", []),
+        current_url=data.get("current_url", data.get("url")),
+        started_at=data.get("started_at"),
+        ended_at=data.get("ended_at"),
+        error=data.get("error"),
+    )

praisonai_browser-0.0.1/praisonai_browser/_version.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"