site-agent-pro 1.0.7 → 1.0.9

package/README.md

@@ -76,7 +76,7 @@ site-agent-pro init
 
 ### 2. Run an Audit
 
-The agent handles everything else, including **automatically installing its own browser** on the first run.
+The agent handles everything else. It automatically uses your existing Google Chrome or Edge browser (saving disk space and time). If no system browser is found, it safely self-heals by downloading its own.
 
 ```bash
 # Run a quick audit
@@ -104,10 +104,8 @@ Artifacts are saved to `runs/<run-id>/`:
 | `accessibility.json` | axe-core violation list |
 | `site-checks.json` | SEO, performance, security, CRO, content, mobile checks |
 | `click-replay.webp` | Compact animated activity replay with click screenshots and overlays for all recorded actions |
-| `*.webm` | Full browser session video recording (enabled via `RECORD_VIDEO=true`) |
+| `*.webm` | Full browser session video recording (enabled via `RECORD_VIDEO=true` in `.env`), now featuring a red mouse cursor tracking the agent's exact movements |
 | `inputs.json` | Run configuration and timing metadata |
-| `trade-executions.json` | Optional deterministic trade validation/execution records when trade mode is enabled |
-| `trade-instruction.json` | Optional standalone trade CLI input copy when `npm run trade:run` is used |
 
 ---
 
@@ -232,7 +230,7 @@ For full control, import the lower-level API directly:
 import { runAuditJob, buildCustomTaskSuite, normalizeCustomTasks } from "site-agent-pro";
 ```
 
-> **Note:** site-agent-pro requires Playwright's Chromium browser. Run `` once after installing the package.
+> **Note:** site-agent-pro automatically uses your system's Google Chrome or Chromium. You do not need to manually install Playwright browsers.
 
 ---
 
@@ -244,7 +242,7 @@ npm run dashboard
 
 | URL | Purpose |
 |---|---|
-| `http://localhost:4173/` | Public submission form — enter URL, paste instructions, or upload text/JSON tasks |
+| `http://localhost:4173/` | Public submission form — enter URL, paste instructions, and select the number of agents (1-5) |
 | `http://localhost:4173/dashboard` | Internal run dashboard — inspect all results |
 | `/submissions/<id>` | Submission progress tracking |
 | `/r/<token>` | Public shareable report link (valid 30 days) |

package/dist/core/runner.js

@@ -1751,6 +1751,39 @@ export async function runTaskSuite(options) {
                 warn(`Web3 wallet injection failed: ${cleanErrorMessage(walletError)}`);
             }
         }
+        if (config.recordVideo) {
+            await context.addInitScript(() => {
+                document.addEventListener("DOMContentLoaded", () => {
+                    const box = document.createElement("div");
+                    box.id = "playwright-mouse-pointer";
+                    box.style.position = "fixed";
+                    box.style.left = "0";
+                    box.style.top = "0";
+                    box.style.width = "20px";
+                    box.style.height = "20px";
+                    box.style.background = "rgba(255,0,0,0.4)";
+                    box.style.border = "2px solid red";
+                    box.style.borderRadius = "50%";
+                    box.style.pointerEvents = "none";
+                    box.style.zIndex = "2147483647";
+                    box.style.transform = "translate(-50%, -50%)";
+                    box.style.transition = "background 0.2s, transform 0.2s";
+                    document.documentElement.appendChild(box);
+                    document.addEventListener("mousemove", (event) => {
+                        box.style.left = event.clientX + "px";
+                        box.style.top = event.clientY + "px";
+                    }, true);
+                    document.addEventListener("mousedown", (event) => {
+                        box.style.background = "rgba(255,0,0,0.8)";
+                        box.style.transform = "translate(-50%, -50%) scale(0.7)";
+                    }, true);
+                    document.addEventListener("mouseup", (event) => {
+                        box.style.background = "rgba(255,0,0,0.4)";
+                        box.style.transform = "translate(-50%, -50%) scale(1)";
+                    }, true);
+                });
+            });
+        }
         page = await context.newPage();
         page.setDefaultNavigationTimeout(config.navigationTimeoutMs);
         page.setDefaultTimeout(config.navigationTimeoutMs);

package/dist/submissions/html.js

@@ -585,43 +585,13 @@ export function renderLandingPage(args) {
                   <strong>Instructions</strong>
                   <textarea name="instructions" placeholder="- Find the main signup path and explain whether it is clear&#10;- Check what a new user is supposed to do first&#10;- Try the pricing flow and stop before entering private details">${escapeHtml(args.submittedInstructions ?? "")}</textarea>
                 </label>
-                <label class="file-row">
-                  <strong>Instruction file (optional)</strong>
-                  <input type="file" name="instructions_file" accept=".txt,.md,.json,.csv,text/plain,application/json" />
-                </label>
                 <div class="config-row">
                   <select class="config-select" name="agents">
                     ${[1, 2, 3, 4, 5]
             .map((count) => `<option value="${count}" ${selectedAgentCount === count ? "selected" : ""}>${count} agent${count === 1 ? "" : "s"}</option>`)
             .join("")}
                   </select>
-                  <label class="toggle-chip">
-                    <input type="checkbox" name="trade_enabled" ${selectedTradeOptions.enabled ? "checked" : ""} />
-                    <span>Enable onchain execution</span>
-                  </label>
-                  <label class="toggle-chip">
-                    <input type="checkbox" name="trade_dry_run" ${selectedTradeOptions.dryRun ? "checked" : ""} />
-                    <span>Dry run</span>
-                  </label>
-                  <select class="config-select" name="trade_strategy">
-                    ${[
-            ["auto", "trade: auto"],
-            ["deposit_only", "trade: deposit only"],
-            ["dapp_only", "trade: dapp only"]
-        ]
-            .map(([value, label]) => `<option value="${value}" ${selectedTradeOptions.strategy === value ? "selected" : ""}>${label}</option>`)
-            .join("")}
-                  </select>
-                  <select class="config-select" name="trade_confirmations">
-                    ${[0, 1, 2, 3]
-            .map((count) => `<option value="${count}" ${selectedTradeOptions.confirmations === count ? "selected" : ""}>${count} conf${count === 1 ? "" : "s"}</option>`)
-            .join("")}
-                  </select>
-                  <span class="tag on">tabs and links</span>
-                  <span class="tag on">mobile notes</span>
-                  <span class="tag on">honest feedback</span>
                 </div>
-                <p class="scope-note">Wallet secrets stay in <code>.env</code>. These controls only decide whether this run may use the configured wallet and whether it should broadcast or stay in dry-run mode.</p>
               </form>
               <p class="launch-note">${launchNote}</p>
               <div class="link-row">

package/dist/utils/browser.js

@@ -1,17 +1,72 @@
 import { execSync } from "node:child_process";
+import fs from "node:fs";
 import { chromium } from "playwright";
-import { info } from "./log.js";
+import { info, warn } from "./log.js";
+/**
+ * Discovers a system-installed Chrome/Chromium/Edge browser path.
+ */
+export function findSystemChrome() {
+    const envPaths = [
+        process.env.CHROME_PATH,
+        process.env.PUPPETEER_EXECUTABLE_PATH,
+        process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH
+    ];
+    for (const p of envPaths) {
+        if (p && fs.existsSync(p))
+            return p;
+    }
+    const isMac = process.platform === "darwin";
+    const isWin = process.platform === "win32";
+    const isLinux = process.platform === "linux";
+    let standardPaths = [];
+    if (isMac) {
+        standardPaths = [
+            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+            "/Applications/Chromium.app/Contents/MacOS/Chromium",
+            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"
+        ];
+    }
+    else if (isWin) {
+        const prefixes = [
+            process.env.LOCALAPPDATA,
+            process.env.PROGRAMFILES,
+            process.env["PROGRAMFILES(X86)"]
+        ].filter(Boolean);
+        for (const prefix of prefixes) {
+            standardPaths.push(`${prefix}\\Google\\Chrome\\Application\\chrome.exe`, `${prefix}\\Chromium\\Application\\chrome.exe`, `${prefix}\\Microsoft\\Edge\\Application\\msedge.exe`);
+        }
+    }
+    else if (isLinux) {
+        standardPaths = [
+            "/usr/bin/google-chrome",
+            "/usr/bin/google-chrome-stable",
+            "/usr/bin/chromium-browser",
+            "/usr/bin/chromium",
+            "/usr/bin/microsoft-edge-stable"
+        ];
+    }
+    return standardPaths.find((p) => fs.existsSync(p));
+}
 /**
  * Professional self-healing browser launcher.
- * If the Playwright browser is missing, it automatically installs it.
+ * Tries system Chromium -> Playwright bundled -> Auto-installs if missing.
  */
 export async function launchWithSelfHealing(launchOptions) {
+    const sysPath = findSystemChrome();
+    if (sysPath) {
+        try {
+            return await chromium.launch({ ...launchOptions, executablePath: sysPath });
+        }
+        catch (err) {
+            warn(`System browser at ${sysPath} failed to launch: ${err.message}. Falling back to bundled Chromium.`);
+        }
+    }
     try {
         return await chromium.launch(launchOptions);
     }
     catch (err) {
         if (err.message.includes("Executable doesn't exist") || err.message.includes("playwright install")) {
-            info("🚀 Playwright browser missing. Automatically installing Chromium...");
+            info("🚀 Bundled Playwright browser missing. Automatically installing Chromium...");
             try {
                 execSync("npx playwright install chromium", { stdio: "inherit" });
                 info("✅ Browser installed successfully! Retrying launch...");
@@ -28,12 +83,21 @@ export async function launchWithSelfHealing(launchOptions) {
  * Self-healing launcher for persistent context (e.g. for MetaMask/Web3 flows).
  */
 export async function launchPersistentWithSelfHealing(userDataDir, options) {
+    const sysPath = findSystemChrome();
+    if (sysPath) {
+        try {
+            return await chromium.launchPersistentContext(userDataDir, { ...options, executablePath: sysPath });
+        }
+        catch (err) {
+            warn(`System browser at ${sysPath} failed to launch: ${err.message}. Falling back to bundled Chromium.`);
+        }
+    }
     try {
         return await chromium.launchPersistentContext(userDataDir, options);
     }
     catch (err) {
         if (err.message.includes("Executable doesn't exist") || err.message.includes("playwright install")) {
-            info("🚀 Playwright browser missing. Automatically installing Chromium...");
+            info("🚀 Bundled Playwright browser missing. Automatically installing Chromium...");
             try {
                 execSync("npx playwright install chromium", { stdio: "inherit" });
                 info("✅ Browser installed successfully! Retrying launch...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "site-agent-pro",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "description": "AI-powered browser agent that tests websites like a real user and produces evidence-based, scored reports.",
   "bin": {
@@ -29,7 +29,6 @@
     "format": "prettier --write .",
     "lint": "eslint .",
     "browser:install": "playwright install chromium",
-    "postinstall": "playwright install chromium",
     "paystack:test": "tsx src/paystack/test-paystack.ts"
   },
   "dependencies": {