auto-browser-langchain 1.2.1__py3-none-any.whl

auto_browser_langchain/__init__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from .node import AutoBrowserNode
+from .tool import AutoBrowserTool
+
+__all__ = ["AutoBrowserTool", "AutoBrowserNode"]

auto_browser_langchain/node.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+import json
+from typing import Any, TypedDict
+
+import httpx
+
+
+class BrowserState(TypedDict, total=False):
+    session_id: str
+    current_url: str
+    screenshot_url: str
+    goal: str
+    result: str
+    error: str
+
+
+class AutoBrowserNode:
+    def __init__(
+        self,
+        base_url: str = "http://localhost:8000",
+        bearer_token: str | None = None,
+        timeout: float = 60.0,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.bearer_token = bearer_token
+        self.timeout = timeout
+
+    def _headers(self) -> dict[str, str]:
+        headers: dict[str, str] = {"Content-Type": "application/json"}
+        if self.bearer_token:
+            headers["Authorization"] = f"Bearer {self.bearer_token}"
+        return headers
+
+    async def call_tool(self, name: str, arguments: dict[str, Any]) -> dict[str, Any]:
+        async with httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout) as client:
+            response = await client.post(
+                "/mcp/tools/call",
+                json={"name": name, "arguments": arguments},
+                headers=self._headers(),
+            )
+            response.raise_for_status()
+            return response.json()
+
+    async def create_session(self, start_url: str | None = None) -> str:
+        arguments: dict[str, Any] = {}
+        if start_url:
+            arguments["start_url"] = start_url
+        result = await self.call_tool("browser.create_session", arguments)
+        content = result.get("content", [{}])
+        data = json.loads(content[0].get("text", "{}"))
+        session_id = data.get("session_id") or data.get("id")
+        if not session_id:
+            raise KeyError("browser.create_session did not return a session id")
+        return str(session_id)
+
+    async def observe(self, session_id: str) -> dict[str, Any]:
+        result = await self.call_tool("browser.observe", {"session_id": session_id})
+        content = result.get("content", [{}])
+        return json.loads(content[0].get("text", "{}"))
+
+    async def run(self, state: BrowserState) -> BrowserState:
+        session_id = state.get("session_id")
+        if not session_id:
+            session_id = await self.create_session()
+            state = {**state, "session_id": session_id}
+        observation = await self.observe(session_id)
+        return {
+            **state,
+            "current_url": observation.get("url", ""),
+            "screenshot_url": observation.get("screenshot_url", ""),
+        }

auto_browser_langchain/tool.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Optional, Type
+
+import httpx
+
+try:
+    from langchain_core.tools import BaseTool
+    from pydantic import BaseModel
+    from pydantic import Field as PydanticField
+
+    _LANGCHAIN_AVAILABLE = True
+except ImportError:
+    _LANGCHAIN_AVAILABLE = False
+    BaseTool = object
+    BaseModel = object
+    PydanticField = lambda *args, **kwargs: None  # noqa: E731
+
+
+if _LANGCHAIN_AVAILABLE:
+    class AutoBrowserInput(BaseModel):
+        action: str = PydanticField(description="MCP tool name, e.g. 'browser.observe'")
+        arguments: dict[str, Any] = PydanticField(default_factory=dict, description="Tool arguments")
+else:
+    AutoBrowserInput = None  # type: ignore[assignment]
+
+
+class AutoBrowserTool(BaseTool):
+    name: str = "auto_browser"
+    description: str = (
+        "Control a real browser via auto-browser. "
+        "Use 'action' for the MCP tool name (e.g. 'browser.navigate', 'browser.observe', "
+        "'browser.click') and 'arguments' for its parameters. "
+        "Call browser.create_session first to get a session_id."
+    )
+    if _LANGCHAIN_AVAILABLE:
+        args_schema: Type[AutoBrowserInput] = AutoBrowserInput
+
+    base_url: str = "http://localhost:8000"
+    bearer_token: Optional[str] = None
+    timeout: float = 60.0
+
+    def _run(self, action: str, arguments: dict[str, Any] | None = None) -> str:
+        import asyncio
+
+        return asyncio.get_event_loop().run_until_complete(self._arun(action, arguments or {}))
+
+    async def _arun(self, action: str, arguments: dict[str, Any] | None = None) -> str:
+        headers: dict[str, str] = {"Content-Type": "application/json"}
+        if self.bearer_token:
+            headers["Authorization"] = f"Bearer {self.bearer_token}"
+        payload = {"name": action, "arguments": arguments or {}}
+        async with httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout) as client:
+            response = await client.post("/mcp/tools/call", json=payload, headers=headers)
+            response.raise_for_status()
+            data = response.json()
+        if data.get("isError"):
+            content = data.get("content", [{}])
+            return f"ERROR: {content[0].get('text', 'Unknown error')}"
+        content = data.get("content", [{}])
+        return content[0].get("text", json.dumps(data))
+
+    @classmethod
+    def list_tools(
+        cls,
+        base_url: str = "http://localhost:8000",
+        bearer_token: str | None = None,
+    ) -> list[dict]:
+        headers: dict[str, str] = {}
+        if bearer_token:
+            headers["Authorization"] = f"Bearer {bearer_token}"
+        with httpx.Client(base_url=base_url, timeout=10) as client:
+            response = client.get("/mcp/tools", headers=headers)
+            response.raise_for_status()
+            return response.json()

auto_browser_langchain-1.2.1.dist-info/METADATA

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: auto-browser-langchain
+Version: 1.2.1
+Summary: LangChain / LangGraph / CrewAI integration for auto-browser
+Project-URL: Homepage, https://github.com/LvcidPsyche/auto-browser
+Project-URL: Repository, https://github.com/LvcidPsyche/auto-browser
+Project-URL: Changelog, https://github.com/LvcidPsyche/auto-browser/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/LvcidPsyche/auto-browser/issues
+License: MIT
+Keywords: auto-browser,browser-automation,crewai,langchain,langgraph
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.28; extra == 'crewai'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.2; extra == 'langchain'
+Description-Content-Type: text/markdown
+
+# auto-browser LangChain Integration
+
+Install from this directory with the optional extras that match your stack:
+
+```bash
+pip install .[langchain]
+pip install .[crewai]
+```
+
+See:
+- `examples/langchain-integration.md`
+- `examples/crewai-integration.md`

auto_browser_langchain-1.2.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+auto_browser_langchain/__init__.py,sha256=4MeaK2l6cy26qzEiQo_CJlcw-aGgXN65792YgvJ6NXg,154
+auto_browser_langchain/node.py,sha256=WAey1p8r1j0pMllBas0GLvZwa9Z372RSwUF0S8M1ZzI,2521
+auto_browser_langchain/tool.py,sha256=luvdoglaCH5CyBk_N9G8KFGwJdgdlGBu0yZeZd53m1k,2853
+auto_browser_langchain-1.2.1.dist-info/METADATA,sha256=GBbBGPJBDK4SdZ12mpO5o1kr12YTwnhSAt-L9zspLeE,1404
+auto_browser_langchain-1.2.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+auto_browser_langchain-1.2.1.dist-info/RECORD,,

auto_browser_langchain-1.2.1.dist-info/WHEEL

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