mini-agent-framework 0.2.0__tar.gz → 0.2.2__tar.gz

{mini_agent_framework-0.2.0/src/mini_agent_framework.egg-info → mini_agent_framework-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-agent-framework
-Version: 0.2.0
+Version: 0.2.2
 Summary: A dynamic, need-based multi-agent AI framework with session memory, action tracking, tool approval, and browser automation
 Author-email: ayyandurai <ayyandurai456@gmail.com>
 License-Expression: MIT
@@ -25,6 +25,7 @@ Requires-Dist: fastapi>=0.111
 Requires-Dist: uvicorn>=0.24
 Provides-Extra: browser
 Requires-Dist: playwright>=1.38; extra == "browser"
+Requires-Dist: playwright-stealth; extra == "browser"
 Dynamic: license-file
 
 # mini-agent-framework
@@ -438,12 +439,23 @@ playwright install chromium
 ```
 
 ```python
-from mini_agent.registry.builtin import BROWSER_TOOLS
+from mini_agent.registry.builtin import init_browser, BROWSER_TOOLS
+
+# headless=True  → invisible (default)
+# headless=False → visible GUI window
+init_browser(headless=False)
 orch.register_tools(BROWSER_TOOLS)
 ```
 
 Available: `browser_open`, `browser_click`, `browser_fill`, `browser_select`, `browser_scroll`, `browser_extract`, `browser_screenshot`, `browser_read`, `browser_observe`, `browser_navigate`, `browser_tabs`, `browser_download`, `browser_dialog`, `browser_wait`, `browser_check`, `browser_close`, `browser_javascript`, `browser_upload`.
 
+To toggle between modes at runtime:
+
+```python
+init_browser(headless=False)  # switch to visible mode
+init_browser(headless=True)   # switch back to headless
+```
+
 ---
 
 ## Configuration

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/README.md

@@ -409,12 +409,23 @@ playwright install chromium
 ```
 
 ```python
-from mini_agent.registry.builtin import BROWSER_TOOLS
+from mini_agent.registry.builtin import init_browser, BROWSER_TOOLS
+
+# headless=True  → invisible (default)
+# headless=False → visible GUI window
+init_browser(headless=False)
 orch.register_tools(BROWSER_TOOLS)
 ```
 
 Available: `browser_open`, `browser_click`, `browser_fill`, `browser_select`, `browser_scroll`, `browser_extract`, `browser_screenshot`, `browser_read`, `browser_observe`, `browser_navigate`, `browser_tabs`, `browser_download`, `browser_dialog`, `browser_wait`, `browser_check`, `browser_close`, `browser_javascript`, `browser_upload`.
 
+To toggle between modes at runtime:
+
+```python
+init_browser(headless=False)  # switch to visible mode
+init_browser(headless=True)   # switch back to headless
+```
+
 ---
 
 ## Configuration

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mini-agent-framework"
-version = "0.2.0"
+version = "0.2.2"
 description = "A dynamic, need-based multi-agent AI framework with session memory, action tracking, tool approval, and browser automation"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -30,7 +30,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-browser = ["playwright>=1.38"]
+browser = ["playwright>=1.38", "playwright-stealth"]
 
 [project.scripts]
 mini-agent-install-browser = "mini_agent.cli:install_browser"

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/src/mini_agent/registry/browser/engine.py

@@ -22,6 +22,12 @@ from .exceptions import (
     BrowserTimeoutError,
     TabNotFoundError,
 )
+try:
+    from playwright_stealth import stealth_sync
+    _STEALTH_AVAILABLE = True
+except ImportError:
+    _STEALTH_AVAILABLE = False
+
 from .logger import get_logger
 
 logger = get_logger(__name__)
@@ -77,8 +83,10 @@ class BrowserManager:
         slow_mo_ms: int = 0,
         extra_launch_args: Optional[List[str]] = None,
         proxy: Optional[Dict[str, str]] = None,
+        stealth: bool = True,
     ):
         self.headless = headless
+        self.stealth = stealth
         self.browser_type = browser_type
         self.downloads_dir = os.path.abspath(downloads_dir)
         self.screenshots_dir = os.path.abspath(screenshots_dir)
@@ -167,6 +175,11 @@ class BrowserManager:
     async def open_tab(self, url: Optional[str] = None) -> str:
         self._ensure_started()
         page = await self._context.new_page()
+        if self.stealth:
+            if _STEALTH_AVAILABLE:
+                await stealth_sync(page)
+            else:
+                logger.warning("Stealth enabled but playwright_stealth not installed. Run: pip install playwright-stealth")
         self._tab_counter += 1
         tab_id = f"tab-{self._tab_counter}"
         state = TabState(page=page, tab_id=tab_id)

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/src/mini_agent/registry/browser/session.py

@@ -23,6 +23,7 @@ class BrowserSession:
         default_timeout_ms: int = 30_000,
         slow_mo_ms: int = 0,
         proxy: Optional[Dict[str, str]] = None,
+        stealth: bool = True,
     ):
         self._manager = BrowserManager(
             headless=headless,
@@ -34,6 +35,7 @@ class BrowserSession:
             default_timeout_ms=default_timeout_ms,
             slow_mo_ms=slow_mo_ms,
             proxy=proxy,
+            stealth=stealth,
         )
         self._registry = ToolRegistry(self._manager)
         self._started = False

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/src/mini_agent/registry/builtin/__init__.py

@@ -32,6 +32,10 @@ def _get_browser_tools():
     from .browser_tools import BROWSER_TOOLS
     return BROWSER_TOOLS
 
+def _get_init_browser():
+    from .browser_tools import init_browser
+    return init_browser
+
 BUILTIN_TOOLS = FILE_TOOLS + WEB_TOOLS + DATA_TOOLS + MATH_TOOLS + SYSTEM_TOOLS + BASH_TOOL
 
 
@@ -40,6 +44,8 @@ def __getattr__(name):
         return BUILTIN_TOOLS + _get_browser_tools()
     if name == "BROWSER_TOOLS":
         return _get_browser_tools()
+    if name == "init_browser":
+        return _get_init_browser()
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
 
 __all__ = [
@@ -52,4 +58,5 @@ __all__ = [
     "SYSTEM_TOOLS",
     "BASH_TOOL",
     "BROWSER_TOOLS",
+    "init_browser",
 ]

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/src/mini_agent/registry/builtin/browser_tools.py

@@ -28,6 +28,35 @@ _lock = threading.Lock()
 _agent = None
 _loop = None
 _IMPORT_ERROR = None
+_headless_mode = True
+_stealth_mode = True
+
+
+def init_browser(headless: bool = True, stealth: bool = True):
+    """Configure browser mode before registering BROWSER_TOOLS.
+
+    Call BEFORE register_tools(BROWSER_TOOLS), or to restart with a
+    different setting at any point.
+
+    Parameters
+    ----------
+    headless : bool
+        True  → invisible browser (default)
+        False → visible GUI window
+    stealth : bool
+        True  → enable Playwright stealth (avoids bot detection, default)
+        False → disable stealth (debugging)
+    """
+    global _headless_mode, _stealth_mode, _agent, _loop
+    if _agent is not None:
+        try:
+            _loop.run_until_complete(_agent._manager.shutdown())
+        except Exception:
+            pass
+        _agent = None
+        _loop = None
+    _headless_mode = headless
+    _stealth_mode = stealth
 
 
 def _auto_install_chromium():
@@ -66,7 +95,7 @@ def _ensure_browser():
         try:
             _loop = asyncio.new_event_loop()
             asyncio.set_event_loop(_loop)
-            _agent = BrowserSession(headless=True)
+            _agent = BrowserSession(headless=_headless_mode, stealth=_stealth_mode)
             _loop.run_until_complete(_agent.start())
         except Exception as e:
             error_msg = str(e).lower()
@@ -75,7 +104,7 @@ def _ensure_browser():
                     _auto_install_chromium()
                     _loop = asyncio.new_event_loop()
                     asyncio.set_event_loop(_loop)
-                    _agent = BrowserSession(headless=True)
+                    _agent = BrowserSession(headless=_headless_mode, stealth=_stealth_mode)
                     _loop.run_until_complete(_agent.start())
                     return
                 except Exception as retry_err:

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2/src/mini_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-agent-framework
-Version: 0.2.0
+Version: 0.2.2
 Summary: A dynamic, need-based multi-agent AI framework with session memory, action tracking, tool approval, and browser automation
 Author-email: ayyandurai <ayyandurai456@gmail.com>
 License-Expression: MIT
@@ -25,6 +25,7 @@ Requires-Dist: fastapi>=0.111
 Requires-Dist: uvicorn>=0.24
 Provides-Extra: browser
 Requires-Dist: playwright>=1.38; extra == "browser"
+Requires-Dist: playwright-stealth; extra == "browser"
 Dynamic: license-file
 
 # mini-agent-framework
@@ -438,12 +439,23 @@ playwright install chromium
 ```
 
 ```python
-from mini_agent.registry.builtin import BROWSER_TOOLS
+from mini_agent.registry.builtin import init_browser, BROWSER_TOOLS
+
+# headless=True  → invisible (default)
+# headless=False → visible GUI window
+init_browser(headless=False)
 orch.register_tools(BROWSER_TOOLS)
 ```
 
 Available: `browser_open`, `browser_click`, `browser_fill`, `browser_select`, `browser_scroll`, `browser_extract`, `browser_screenshot`, `browser_read`, `browser_observe`, `browser_navigate`, `browser_tabs`, `browser_download`, `browser_dialog`, `browser_wait`, `browser_check`, `browser_close`, `browser_javascript`, `browser_upload`.
 
+To toggle between modes at runtime:
+
+```python
+init_browser(headless=False)  # switch to visible mode
+init_browser(headless=True)   # switch back to headless
+```
+
 ---
 
 ## Configuration

{mini_agent_framework-0.2.0 → mini_agent_framework-0.2.2}/src/mini_agent_framework.egg-info/requires.txt

@@ -8,3 +8,4 @@ uvicorn>=0.24
 
 [browser]
 playwright>=1.38
+playwright-stealth