auto-browser-langchain 1.2.1__tar.gz

auto_browser_langchain-1.2.1/.gitignore

@@ -0,0 +1,51 @@
+.env
+.autonomous/
+.agents/
+docs/brainstorms/
+HANDOFF.md
+CODEX_*.md
+data/artifacts/*
+!data/artifacts/.gitkeep
+data/uploads/*
+!data/uploads/.gitkeep
+data/auth/*
+!data/auth/.gitkeep
+data/approvals/*
+!data/approvals/.gitkeep
+data/audit/*
+!data/audit/.gitkeep
+data/witness/*
+!data/witness/.gitkeep
+data/db/*
+!data/db/.gitkeep
+data/jobs/*
+!data/jobs/.gitkeep
+data/sessions/*
+!data/sessions/.gitkeep
+data/browser-sessions/*
+!data/browser-sessions/.gitkeep
+data/ssh/*
+!data/ssh/.gitkeep
+data/browser-profile/*
+!data/browser-profile/.gitkeep
+data/downloads/*
+!data/downloads/.gitkeep
+data/tunnels/*
+!data/tunnels/.gitkeep
+data/host-bridge/*
+!data/host-bridge/.gitkeep
+data/cli-home/*
+!data/cli-home/.gitkeep
+__pycache__/
+*.pyc
+.venv*/
+.pytest_cache/
+.pytest-cache*/
+.pytest-tmp*/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+build/
+dist/
+*.egg-info/

auto_browser_langchain-1.2.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,12 @@
+# 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/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-1.2.1/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-1.2.1/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/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "auto-browser-langchain"
+version = "1.2.1"
+description = "LangChain / LangGraph / CrewAI integration for auto-browser"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.27",
+]
+keywords = ["auto-browser", "langchain", "langgraph", "crewai", "browser-automation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+[project.optional-dependencies]
+langchain = ["langchain-core>=0.2"]
+crewai = ["crewai>=0.28"]
+
+[project.urls]
+Homepage = "https://github.com/LvcidPsyche/auto-browser"
+Repository = "https://github.com/LvcidPsyche/auto-browser"
+Changelog = "https://github.com/LvcidPsyche/auto-browser/blob/main/CHANGELOG.md"
+Issues = "https://github.com/LvcidPsyche/auto-browser/issues"