portacode 2.2.18__tar.gz → 2.2.20.dev0__tar.gz

{portacode-2.2.18 → portacode-2.2.20.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 2.2.18
+Version: 2.2.20.dev0
 Summary: Device agent for the AI platform that builds, tests, deploys, and operates real software
 Home-page: https://portacode.com/
 Author: Meena Erian
@@ -47,6 +47,7 @@ Requires-Dist: ntplib>=0.4.0
 Requires-Dist: importlib_resources>=6.0
 Requires-Dist: requests>=2.31
 Requires-Dist: httpx>=0.27
+Requires-Dist: playwright<2,>=1.45
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.2.18'
-__version_tuple__ = version_tuple = (2, 2, 18)
+__version__ = version = '2.2.20.dev0'
+__version_tuple__ = version_tuple = (2, 2, 20, 'dev0')
 
 __commit_id__ = commit_id = None

portacode-2.2.20.dev0/portacode/browser_cli.py

@@ -0,0 +1,106 @@
+"""Local Playwright automation usable by humans, agents, and Portafiles."""
+from __future__ import annotations
+
+import json
+import re
+import time
+from pathlib import Path
+
+import click
+
+
+def run_browser_script(*, url: str, script: str, output_dir: Path, record_video: bool,
+                       width: int, height: int, timeout_ms: int) -> dict:
+    from playwright.sync_api import sync_playwright
+
+    output_dir.mkdir(parents=True, exist_ok=True)
+    shots: list[str] = []
+    values: list[object] = []
+    video_dir = output_dir / "video"
+    if record_video:
+        video_dir.mkdir(exist_ok=True)
+
+    with sync_playwright() as pw:
+        launch = {"headless": True}
+        alpine = Path("/usr/bin/chromium-browser")
+        if alpine.exists():
+            launch.update(executable_path=str(alpine), args=["--no-sandbox"])
+        browser = pw.chromium.launch(**launch)
+        context_args = {"viewport": {"width": width, "height": height}}
+        if record_video:
+            context_args.update(record_video_dir=str(video_dir), record_video_size={
+                "width": min(width, 1280), "height": min(height, 720),
+            })
+        context = browser.new_context(**context_args)
+        page = context.new_page()
+        page.set_default_timeout(timeout_ms)
+
+        def screenshot(name="screenshot", full_page=False):
+            safe = re.sub(r"[^A-Za-z0-9_.-]+", "-", str(name)).strip("-") or "screenshot"
+            path = output_dir / f"{len(shots) + 1:02d}-{safe}.png"
+            page.screenshot(path=str(path), full_page=bool(full_page))
+            shots.append(str(path))
+            return str(path)
+
+        def dom(selector="body", max_chars=8000):
+            """Return a useful, bounded DOM fragment without flooding model context."""
+            limit = min(max(int(max_chars), 200), 20000)
+            locator = page.locator(selector).first
+            return locator.evaluate(
+                "(node, limit) => node.outerHTML.slice(0, limit)", limit
+            )
+
+        def emit(value):
+            values.append(value)
+            return value
+
+        started = time.monotonic()
+        try:
+            if url:
+                page.goto(url, wait_until="domcontentloaded")
+            scope = {"page": page, "context": context, "screenshot": screenshot,
+                     "dom": dom, "emit": emit}
+            exec(compile(script, "<portacode-browser>", "exec"), {"__builtins__": __builtins__}, scope)
+            result = {"ok": True, "url": page.url, "title": page.title(), "values": values,
+                      "screenshots": shots, "duration_seconds": round(time.monotonic() - started, 3)}
+        except Exception as exc:
+            failure = screenshot("failure")
+            result = {"ok": False, "error": str(exc), "url": page.url,
+                      "screenshots": shots, "failure_screenshot": failure}
+        video = page.video
+        context.close()
+        if video:
+            try:
+                result["video"] = video.path()
+            except Exception:
+                pass
+        browser.close()
+        return result
+
+
+@click.group("browser")
+def browser_group():
+    """Run flexible Playwright automation on this device."""
+
+
+@browser_group.command("run")
+@click.option("--url", default="", help="Initial URL to open.")
+@click.option("--script", help="Python Playwright statements; page/context are pre-defined.")
+@click.option("--script-file", type=click.Path(exists=True, dir_okay=False, path_type=Path))
+@click.option("--output-dir", type=click.Path(file_okay=False, path_type=Path),
+              default=Path("./portacode-browser-artifacts"), show_default=True)
+@click.option("--record-video/--no-record-video", default=False)
+@click.option("--width", default=1280, type=click.IntRange(320, 1920))
+@click.option("--height", default=720, type=click.IntRange(240, 1080))
+@click.option("--timeout-ms", default=10000, type=click.IntRange(250, 60000))
+def browser_run(url, script, script_file, output_dir, record_video, width, height, timeout_ms):
+    """Execute SCRIPT with page, context, screenshot(), dom(), and emit()."""
+    if bool(script) == bool(script_file):
+        raise click.UsageError("Provide exactly one of --script or --script-file")
+    source = script if script is not None else script_file.read_text(encoding="utf-8")
+    result = run_browser_script(url=url, script=source, output_dir=output_dir,
+                                record_video=record_video, width=width, height=height,
+                                timeout_ms=timeout_ms)
+    click.echo(json.dumps(result, indent=2, default=str))
+    if not result["ok"]:
+        raise click.exceptions.Exit(1)

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode/cli.py

@@ -42,6 +42,10 @@ def cli() -> None:
     """Portacode command-line interface."""
 
 
+from .browser_cli import browser_group
+cli.add_command(browser_group)
+
+
 @cli.group()
 def prepare() -> None:
     """Prepare supported developer tools for this Portacode device."""

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode/connection/handlers/browser_handlers.py

@@ -7,6 +7,7 @@ import json
 import logging
 import os
 import re
+import shutil
 import time
 from pathlib import Path
 from typing import Any, Dict
@@ -79,6 +80,7 @@ const run = async cfg => {
     else if(op==='wait') s.ms ? await page.waitForTimeout(s.ms) : await page.waitForLoadState(s.state||'domcontentloaded');
     else if(op==='assert') { const kind=s.kind||'visible'; if(kind==='visible') await l.waitFor({state:'visible'}); else if(kind==='hidden') await l.waitFor({state:'hidden'}); else if(kind==='text'){const got=await l.textContent();if(!String(got||'').includes(String(s.value)))throw Error(`expected text ${s.value}`); } else if(kind==='url'){if(!page.url().includes(String(s.value)))throw Error(`expected URL ${s.value}`);} else throw Error('unsupported assertion'); }
     else if(op==='read') { if(s.attribute) value=await l.getAttribute(s.attribute); else if(s.kind==='value') value=await l.inputValue(); else if(s.kind==='count') value=await l.count(); else value=(await l.innerText()).slice(0,8000); }
+    else if(op==='dom') { const target=s.selector?page.locator(s.selector).first():page.locator('body'); const limit=Math.min(Math.max(Number(s.max_chars)||8000,200),20000); value=await target.evaluate((node,limit)=>node.outerHTML.slice(0,limit),limit); }
     else if(op==='screenshot') { const b=await page.screenshot({type:'jpeg',quality:cfg.image_quality,fullPage:!!s.full_page}); out.screenshots.push({step:i,data:b.toString('base64'),mime_type:'image/jpeg'}); }
     else throw Error(`unsupported operation: ${op}`);
     out.steps.push({i,op,ok:true,...(value===null?{}:{value})});
@@ -124,18 +126,19 @@ async def _node_path() -> str:
     _NODE_PATH_LOCK = _loop_lock(_NODE_PATH_LOCK)
     async with _NODE_PATH_LOCK:
         if _NODE_PATH is None:
-            npm = await asyncio.create_subprocess_exec(
-                "npm", "root", "-g", stdout=asyncio.subprocess.PIPE,
-                stderr=asyncio.subprocess.PIPE,
-            )
-            npm_out, npm_err = await npm.communicate()
-            if npm.returncode:
-                raise RuntimeError(
-                    f"Unable to locate global Node modules: {npm_err.decode(errors='replace')[:300]}"
+            paths = ["/opt/portacode-playwright/node_modules"]
+            if shutil.which("npm"):
+                npm = await asyncio.create_subprocess_exec(
+                    "npm", "root", "-g", stdout=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.PIPE,
                 )
-            _NODE_PATH = os.pathsep.join(filter(None, [
-                "/opt/portacode-playwright/node_modules", npm_out.decode().strip(),
-            ]))
+                npm_out, npm_err = await npm.communicate()
+                if npm.returncode:
+                    raise RuntimeError(
+                        f"Unable to locate global Node modules: {npm_err.decode(errors='replace')[:300]}"
+                    )
+                paths.append(npm_out.decode().strip())
+            _NODE_PATH = os.pathsep.join(filter(None, paths))
     return _NODE_PATH
 
 

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode/connection/handlers/proxmox_infra.py

@@ -2547,6 +2547,7 @@ def _cacheable_bootstrap_steps(package_manager: str) -> List[Dict[str, Any]]:
             "name": "install_playwright_chromium",
             "cmd": (
                 "install -d -m 755 /opt/ms-playwright && "
+                "python3 -m pip install 'playwright>=1.45,<2' && "
                 "npm install --prefix /opt/portacode-playwright playwright@latest && "
                 "playwright_cli=/opt/portacode-playwright/node_modules/playwright/cli.js && "
                 "test -f \"$playwright_cli\" && "
@@ -2573,6 +2574,7 @@ def _cacheable_bootstrap_steps(package_manager: str) -> List[Dict[str, Any]]:
             "cmd": (
                 "apk add --no-cache chromium nss freetype harfbuzz ca-certificates "
                 "font-freefont ffmpeg && "
+                "python3 -m pip install 'playwright>=1.45,<2' && "
                 "PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install --ignore-scripts "
                 "--prefix /opt/portacode-playwright playwright@latest && "
                 "test -f /opt/portacode-playwright/node_modules/playwright/cli.js && "

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode/connection/handlers/test_browser_handlers.py

@@ -1,6 +1,7 @@
 import unittest
 import asyncio
 import json
+import os
 from types import SimpleNamespace
 from unittest.mock import AsyncMock, Mock, patch
 
@@ -24,6 +25,31 @@ class BrowserRunHandlerTests(unittest.IsolatedAsyncioTestCase):
         with self.assertRaisesRegex(ValueError, "four explicit screenshots"):
             await self.handler.execute({"session_id": "safe", "steps": [{"op": "screenshot"}] * 5})
 
+    async def test_fixed_playwright_runtime_does_not_require_npm(self):
+        browser_handlers._NODE_PATH = None
+        with (
+            patch.object(browser_handlers.shutil, "which", return_value=None),
+            patch.object(browser_handlers.asyncio, "create_subprocess_exec", AsyncMock()) as spawn,
+        ):
+            path = await browser_handlers._node_path()
+        self.assertEqual(path, "/opt/portacode-playwright/node_modules")
+        spawn.assert_not_awaited()
+
+    async def test_global_npm_modules_remain_a_supported_fallback(self):
+        browser_handlers._NODE_PATH = None
+        process = AsyncMock()
+        process.returncode = 0
+        process.communicate.return_value = (b"/usr/lib/node_modules\n", b"")
+        with (
+            patch.object(browser_handlers.shutil, "which", return_value="/usr/bin/npm"),
+            patch.object(browser_handlers.asyncio, "create_subprocess_exec", AsyncMock(return_value=process)),
+        ):
+            path = await browser_handlers._node_path()
+        self.assertEqual(
+            path,
+            os.pathsep.join(["/opt/portacode-playwright/node_modules", "/usr/lib/node_modules"]),
+        )
+
     async def test_reuses_worker_for_same_runtime_user_and_session(self):
         worker = AsyncMock()
         worker.run.return_value = {"ok": True, "steps": [], "screenshots": []}
@@ -114,3 +140,7 @@ class BrowserRunHandlerTests(unittest.IsolatedAsyncioTestCase):
 
     def test_null_nth_is_treated_as_omitted(self):
         self.assertIn("s.nth == null ? l : l.nth(s.nth)", browser_handlers._RUNNER)
+
+    def test_bounded_dom_operation_is_available(self):
+        self.assertIn("op==='dom'", browser_handlers._RUNNER)
+        self.assertIn("20000", browser_handlers._RUNNER)

portacode-2.2.20.dev0/portacode/tests/test_browser_cli.py

@@ -0,0 +1,31 @@
+import json
+from pathlib import Path
+from unittest.mock import patch
+
+from click.testing import CliRunner
+
+from portacode.cli import cli
+
+
+def test_browser_run_accepts_inline_python_and_returns_json(tmp_path):
+    result_payload = {"ok": True, "url": "https://example.test", "screenshots": []}
+    with patch("portacode.browser_cli.run_browser_script", return_value=result_payload) as run:
+        result = CliRunner().invoke(cli, [
+            "browser", "run", "--url", "https://example.test",
+            "--script", "emit(page.title())", "--output-dir", str(tmp_path),
+        ])
+    assert result.exit_code == 0
+    assert json.loads(result.output)["ok"] is True
+    assert run.call_args.kwargs["script"] == "emit(page.title())"
+
+
+def test_browser_run_requires_exactly_one_script_source():
+    result = CliRunner().invoke(cli, ["browser", "run"])
+    assert result.exit_code == 2
+    assert "exactly one" in result.output
+
+
+def test_browser_run_propagates_failure_exit_code(tmp_path):
+    with patch("portacode.browser_cli.run_browser_script", return_value={"ok": False, "error": "boom"}):
+        result = CliRunner().invoke(cli, ["browser", "run", "--script", "raise Exception()"])
+    assert result.exit_code == 1

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 2.2.18
+Version: 2.2.20.dev0
 Summary: Device agent for the AI platform that builds, tests, deploys, and operates real software
 Home-page: https://portacode.com/
 Author: Meena Erian
@@ -47,6 +47,7 @@ Requires-Dist: ntplib>=0.4.0
 Requires-Dist: importlib_resources>=6.0
 Requires-Dist: requests>=2.31
 Requires-Dist: httpx>=0.27
+Requires-Dist: playwright<2,>=1.45
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode.egg-info/SOURCES.txt

@@ -268,6 +268,7 @@ portacode/README.md
 portacode/__init__.py
 portacode/__main__.py
 portacode/_version.py
+portacode/browser_cli.py
 portacode/cli.py
 portacode/codex_loopback_proxy.py
 portacode/codex_prepare.py
@@ -375,6 +376,7 @@ portacode/link_capture/bin/__pycache__/link_capture_wrapper.cpython-38.pyc
 portacode/static/js/test-ntp-clock.html
 portacode/static/js/utils/ntp-clock.js
 portacode/tests/test_automation_v2_inputs.py
+portacode/tests/test_browser_cli.py
 portacode/tests/test_cli_service_logs.py
 portacode/tests/test_codex_app_server.py
 portacode/tests/test_codex_handlers.py

{portacode-2.2.18 → portacode-2.2.20.dev0}/portacode.egg-info/requires.txt

@@ -13,6 +13,7 @@ ntplib>=0.4.0
 importlib_resources>=6.0
 requests>=2.31
 httpx>=0.27
+playwright<2,>=1.45
 
 [:platform_system == "Windows"]
 pywinpty>=2.0

{portacode-2.2.18 → portacode-2.2.20.dev0}/setup.py

@@ -68,6 +68,7 @@ setup(
         "importlib_resources>=6.0",
         "requests>=2.31",
         "httpx>=0.27",
+        "playwright>=1.45,<2",
     ],
     extras_require={
         "dev": ["black", "flake8", "pytest"],