@xbrowser/cli 1.22.0 → 1.23.1

package/dist/{plugin-singleton-FCNDN3FX.js → plugin-singleton-GJO7EZXB.js}

@@ -1,7 +1,7 @@
 import {
   getPluginLoader,
   resetPluginLoader
-} from "./chunk-PIWNMC36.js";
+} from "./chunk-A3MORKYR.js";
 import "./chunk-KFQGP6VL.js";
 export {
   getPluginLoader,

package/dist/{recovery-NXC35EQN.js → recovery-67DMH2OM.js}

@@ -1,9 +1,9 @@
-import {
-  HumanInteractionManager
-} from "./chunk-TEXCXIBW.js";
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
+import {
+  HumanInteractionManager
+} from "./chunk-W44UXZSC.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{recovery-L5GLDX4O.js → recovery-6RI2FE3E.js}

@@ -1,9 +1,10 @@
+import {
+  HumanInteractionManager
+} from "./chunk-LPW6QS4M.js";
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
-import {
-  HumanInteractionManager
-} from "./chunk-NKW4A74J.js";
+import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";
 

package/dist/{recovery-MDWAVXE4.js → recovery-LGY25LIM.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-OMU63E6J.js";
+} from "./chunk-FBQZ3PVD.js";
 import {
   buildViewerUrl
 } from "./chunk-TZPKFUBT.js";

package/dist/server-DZUIBVVR.js

@@ -0,0 +1,243 @@
+import {
+  executeChain,
+  executeCommand
+} from "./chunk-LFX24QJZ.js";
+import "./chunk-2Q3GQRUP.js";
+import "./chunk-JKVUFP3G.js";
+import "./chunk-3OD76SUE.js";
+import "./chunk-ZTHE5RBZ.js";
+import "./chunk-Q2DFJQGS.js";
+import "./chunk-7OP2ISEY.js";
+import "./chunk-GYB5BOSP.js";
+import "./chunk-MYH6FIBZ.js";
+import "./chunk-GDKLH7ZY.js";
+import "./chunk-WYETQ5C7.js";
+import "./chunk-75DNUI6M.js";
+import "./chunk-KFQGP6VL.js";
+
+// src/mcp/server.ts
+var TOOLS = [
+  {
+    name: "browser_navigate",
+    description: "Navigate to a URL and optionally run follow-up commands as a chain. Use this to open pages. Session auto-creates; pass session to isolate state.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to navigate to" },
+        session: { type: "string", description: "Session name (default: mcp)" },
+        chain: {
+          type: "string",
+          description: 'Optional follow-up command chain joined by && (e.g. `click "#btn" && text .result`). Full command list: xbrowser --help'
+        }
+      },
+      required: ["url"]
+    }
+  },
+  {
+    name: "browser_act",
+    description: "Run an interaction command on the current page: click / fill / type / press / select / check / hover / scroll / wait / eval. Selectors support CSS and text= prefix.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: {
+          type: "string",
+          description: "Command word, e.g. click / fill / press / wait / eval"
+        },
+        args: {
+          type: "object",
+          description: 'Command parameters, e.g. { selector: "#input", value: "hello" }'
+        },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["command"]
+    }
+  },
+  {
+    name: "browser_read",
+    description: "Read page content: text / html / title / url. Cheaper than snapshot for plain content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        kind: { type: "string", enum: ["text", "html", "title", "url"] },
+        selector: { type: "string", description: "Optional CSS selector to scope the read" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["kind"]
+    }
+  },
+  {
+    name: "browser_snapshot",
+    description: "Accessibility-tree snapshot of interactive elements \u2014 the token-efficient way for an agent to see the page. Returns refs usable with browser_act selectors.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        interactiveOnly: { type: "boolean", description: "Only interactive elements (default true)" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      }
+    }
+  },
+  {
+    name: "browser_screenshot",
+    description: "Take a screenshot. Returns the file path (use screenshot --base64 chain for inline images).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        output: { type: "string", description: "Output PNG path" },
+        fullPage: { type: "boolean" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      }
+    }
+  },
+  {
+    name: "browser_network",
+    description: "Inspect captured network requests: list / top / analyze.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: { type: "string", enum: ["list", "top", "analyze"] },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["action"]
+    }
+  },
+  {
+    name: "browser_replay",
+    description: "Replay a recorded flow with the self-healing engine \u2014 survives site redesigns via selector cascade (semantic candidates \u2192 fingerprints \u2192 coordinates \u2192 knowledge base). Deterministic, no LLM cost.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        file: { type: "string", description: "Path to recorded YAML/JSON" },
+        slowMo: { type: "number", description: "ms delay between steps" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["file"]
+    }
+  }
+];
+var DEFAULT_SESSION = "mcp";
+async function runTool(name, args) {
+  const session = args.session || DEFAULT_SESSION;
+  const sessionOpts = { sessionName: session };
+  const text = (v) => ({ content: [{ type: "text", text: JSON.stringify(v, null, 2) }] });
+  switch (name) {
+    case "browser_navigate": {
+      const url = args.url;
+      let chain = `goto ${url}`;
+      if (args.chain) chain += ` && ${args.chain}`;
+      const result = await executeChain(chain, sessionOpts);
+      return text({ ok: result.success, steps: result.steps?.map((s) => ({ command: s.command, success: s.success })) });
+    }
+    case "browser_act": {
+      const command = args.command;
+      const cmdArgs = args.args || {};
+      const result = await executeCommand(command, cmdArgs, session, {});
+      return text(result);
+    }
+    case "browser_read": {
+      const kind = args.kind;
+      const params = {};
+      if (args.selector) params.selector = args.selector;
+      const result = await executeCommand(kind, params, session, {});
+      return text(result);
+    }
+    case "browser_snapshot": {
+      const params = { interactiveOnly: args.interactiveOnly !== false };
+      const result = await executeCommand("snapshot", params, session, {});
+      return text(result);
+    }
+    case "browser_screenshot": {
+      const params = {
+        output: args.output || `output/mcp-${Date.now()}.png`,
+        ...args.fullPage ? { fullPage: true } : {}
+      };
+      const result = await executeCommand("screenshot", params, session, {});
+      return text(result);
+    }
+    case "browser_network": {
+      const result = await executeCommand(`network:${args.action}`, {}, session, {});
+      return text(result);
+    }
+    case "browser_replay": {
+      const params = {
+        file: args.file,
+        ...typeof args.slowMo === "number" ? { slowMo: args.slowMo } : {}
+      };
+      const result = await executeCommand("replay", params, session, {});
+      return text(result);
+    }
+    default:
+      throw new Error(`unknown tool: ${name}`);
+  }
+}
+function reply(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+}
+function replyError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + "\n");
+}
+async function handleRequest(req) {
+  if (req.id === void 0) return;
+  switch (req.method) {
+    case "initialize":
+      reply(req.id, {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: { name: "xbrowser", version: process.env.npm_package_version || "1.23.0" }
+      });
+      break;
+    case "notifications/initialized":
+      break;
+    case "tools/list":
+      reply(req.id, { tools: TOOLS });
+      break;
+    case "tools/call": {
+      const toolName = req.params.name;
+      const toolArgs = req.params.arguments || {};
+      try {
+        const result = await runTool(toolName, toolArgs);
+        reply(req.id, { content: result.content });
+      } catch (err) {
+        reply(req.id, {
+          content: [{ type: "text", text: `Error: ${err.message}` }],
+          isError: true
+        });
+      }
+      break;
+    }
+    default:
+      replyError(req.id, -32601, `method not found: ${req.method}`);
+  }
+}
+var inflight = 0;
+function startMcpStdio() {
+  let buffer = "";
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+    let idx;
+    while ((idx = buffer.indexOf("\n")) >= 0) {
+      const line = buffer.slice(0, idx).trim();
+      buffer = buffer.slice(idx + 1);
+      if (!line) continue;
+      try {
+        const req = JSON.parse(line);
+        inflight++;
+        handleRequest(req).catch((e) => {
+          if (req.id !== void 0) replyError(req.id, -32603, e.message);
+        }).finally(() => {
+          inflight--;
+          if (stdinClosed && inflight === 0) process.exit(0);
+        });
+      } catch {
+      }
+    }
+  });
+  let stdinClosed = false;
+  process.stdin.on("end", () => {
+    stdinClosed = true;
+    if (inflight === 0) process.exit(0);
+  });
+}
+export {
+  startMcpStdio
+};

package/dist/server-HU4F5KN7.js

@@ -0,0 +1,240 @@
+import {
+  executeChain,
+  executeCommand
+} from "./chunk-TBSS7ES4.js";
+import "./chunk-JKVUFP3G.js";
+import "./chunk-3OD76SUE.js";
+import "./chunk-ZTHE5RBZ.js";
+import "./chunk-Q2DFJQGS.js";
+import "./chunk-IFKJO2UR.js";
+import "./chunk-GYB5BOSP.js";
+import "./chunk-MYH6FIBZ.js";
+import "./chunk-GDKLH7ZY.js";
+import "./chunk-KFQGP6VL.js";
+
+// src/mcp/server.ts
+var TOOLS = [
+  {
+    name: "browser_navigate",
+    description: "Navigate to a URL and optionally run follow-up commands as a chain. Use this to open pages. Session auto-creates; pass session to isolate state.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to navigate to" },
+        session: { type: "string", description: "Session name (default: mcp)" },
+        chain: {
+          type: "string",
+          description: 'Optional follow-up command chain joined by && (e.g. `click "#btn" && text .result`). Full command list: xbrowser --help'
+        }
+      },
+      required: ["url"]
+    }
+  },
+  {
+    name: "browser_act",
+    description: "Run an interaction command on the current page: click / fill / type / press / select / check / hover / scroll / wait / eval. Selectors support CSS and text= prefix.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: {
+          type: "string",
+          description: "Command word, e.g. click / fill / press / wait / eval"
+        },
+        args: {
+          type: "object",
+          description: 'Command parameters, e.g. { selector: "#input", value: "hello" }'
+        },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["command"]
+    }
+  },
+  {
+    name: "browser_read",
+    description: "Read page content: text / html / title / url. Cheaper than snapshot for plain content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        kind: { type: "string", enum: ["text", "html", "title", "url"] },
+        selector: { type: "string", description: "Optional CSS selector to scope the read" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["kind"]
+    }
+  },
+  {
+    name: "browser_snapshot",
+    description: "Accessibility-tree snapshot of interactive elements \u2014 the token-efficient way for an agent to see the page. Returns refs usable with browser_act selectors.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        interactiveOnly: { type: "boolean", description: "Only interactive elements (default true)" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      }
+    }
+  },
+  {
+    name: "browser_screenshot",
+    description: "Take a screenshot. Returns the file path (use screenshot --base64 chain for inline images).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        output: { type: "string", description: "Output PNG path" },
+        fullPage: { type: "boolean" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      }
+    }
+  },
+  {
+    name: "browser_network",
+    description: "Inspect captured network requests: list / top / analyze.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: { type: "string", enum: ["list", "top", "analyze"] },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["action"]
+    }
+  },
+  {
+    name: "browser_replay",
+    description: "Replay a recorded flow with the self-healing engine \u2014 survives site redesigns via selector cascade (semantic candidates \u2192 fingerprints \u2192 coordinates \u2192 knowledge base). Deterministic, no LLM cost.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        file: { type: "string", description: "Path to recorded YAML/JSON" },
+        slowMo: { type: "number", description: "ms delay between steps" },
+        session: { type: "string", description: "Session name (default: mcp)" }
+      },
+      required: ["file"]
+    }
+  }
+];
+var DEFAULT_SESSION = "mcp";
+async function runTool(name, args) {
+  const session = args.session || DEFAULT_SESSION;
+  const sessionOpts = { sessionName: session };
+  const text = (v) => ({ content: [{ type: "text", text: JSON.stringify(v, null, 2) }] });
+  switch (name) {
+    case "browser_navigate": {
+      const url = args.url;
+      let chain = `goto ${url}`;
+      if (args.chain) chain += ` && ${args.chain}`;
+      const result = await executeChain(chain, sessionOpts);
+      return text({ ok: result.success, steps: result.steps?.map((s) => ({ command: s.command, success: s.success })) });
+    }
+    case "browser_act": {
+      const command = args.command;
+      const cmdArgs = args.args || {};
+      const result = await executeCommand(command, cmdArgs, session, {});
+      return text(result);
+    }
+    case "browser_read": {
+      const kind = args.kind;
+      const params = {};
+      if (args.selector) params.selector = args.selector;
+      const result = await executeCommand(kind, params, session, {});
+      return text(result);
+    }
+    case "browser_snapshot": {
+      const params = { interactiveOnly: args.interactiveOnly !== false };
+      const result = await executeCommand("snapshot", params, session, {});
+      return text(result);
+    }
+    case "browser_screenshot": {
+      const params = {
+        output: args.output || `output/mcp-${Date.now()}.png`,
+        ...args.fullPage ? { fullPage: true } : {}
+      };
+      const result = await executeCommand("screenshot", params, session, {});
+      return text(result);
+    }
+    case "browser_network": {
+      const result = await executeCommand(`network:${args.action}`, {}, session, {});
+      return text(result);
+    }
+    case "browser_replay": {
+      const params = {
+        file: args.file,
+        ...typeof args.slowMo === "number" ? { slowMo: args.slowMo } : {}
+      };
+      const result = await executeCommand("replay", params, session, {});
+      return text(result);
+    }
+    default:
+      throw new Error(`unknown tool: ${name}`);
+  }
+}
+function reply(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+}
+function replyError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + "\n");
+}
+async function handleRequest(req) {
+  if (req.id === void 0) return;
+  switch (req.method) {
+    case "initialize":
+      reply(req.id, {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: { name: "xbrowser", version: process.env.npm_package_version || "1.23.0" }
+      });
+      break;
+    case "notifications/initialized":
+      break;
+    case "tools/list":
+      reply(req.id, { tools: TOOLS });
+      break;
+    case "tools/call": {
+      const toolName = req.params.name;
+      const toolArgs = req.params.arguments || {};
+      try {
+        const result = await runTool(toolName, toolArgs);
+        reply(req.id, { content: result.content });
+      } catch (err) {
+        reply(req.id, {
+          content: [{ type: "text", text: `Error: ${err.message}` }],
+          isError: true
+        });
+      }
+      break;
+    }
+    default:
+      replyError(req.id, -32601, `method not found: ${req.method}`);
+  }
+}
+var inflight = 0;
+function startMcpStdio() {
+  let buffer = "";
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+    let idx;
+    while ((idx = buffer.indexOf("\n")) >= 0) {
+      const line = buffer.slice(0, idx).trim();
+      buffer = buffer.slice(idx + 1);
+      if (!line) continue;
+      try {
+        const req = JSON.parse(line);
+        inflight++;
+        handleRequest(req).catch((e) => {
+          if (req.id !== void 0) replyError(req.id, -32603, e.message);
+        }).finally(() => {
+          inflight--;
+          if (stdinClosed && inflight === 0) process.exit(0);
+        });
+      } catch {
+      }
+    }
+  });
+  let stdinClosed = false;
+  process.stdin.on("end", () => {
+    stdinClosed = true;
+    if (inflight === 0) process.exit(0);
+  });
+}
+export {
+  startMcpStdio
+};

package/dist/{session-replayer-XM5L7LFD.js → session-replayer-N665T3G5.js}

@@ -222,20 +222,31 @@ var SessionReplayer = class {
         break;
       }
       case "scroll": {
-        const [dir, distStr] = (action.value || "down:300").split(":");
-        const dist = Number(distStr) || 300;
-        const sign = dir === "up" ? -1 : dir === "left" ? 0 : 1;
         const selector = await this.resolveAndWait(action).catch(() => void 0);
-        if (selector) {
-          await page.evaluate(`
-            (function() {
-              const el = ${queryJS(selector)};
-              if (el) el.scrollTop += ${sign * dist};
-            })()
-          `).catch(() => {
+        if (action.value) {
+          const [dir, distStr] = action.value.split(":");
+          const dist = Number(distStr) || 300;
+          const dx = dir === "left" ? -dist : dir === "right" ? dist : 0;
+          const dy = dir === "up" ? -dist : dir === "down" ? dist : 0;
+          if (selector) {
+            await page.evaluate(`
+              (function() {
+                const el = ${queryJS(selector)};
+                if (el) { el.scrollLeft += ${dx}; el.scrollTop += ${dy}; }
+              })()
+            `).catch(() => {
+            });
+          } else {
+            await page.evaluate(`window.scrollBy(${dx}, ${dy})`).catch(() => {
+            });
+          }
+        } else if (typeof action.scrollX === "number" || typeof action.scrollY === "number") {
+          const sx = action.scrollX ?? 0;
+          const sy = action.scrollY ?? 0;
+          await page.evaluate(`window.scrollTo(${sx}, ${sy})`).catch(() => {
           });
         } else {
-          await page.evaluate(`window.scrollBy(0, ${sign * dist})`).catch(() => {
+          await page.evaluate(`window.scrollBy(0, 300)`).catch(() => {
           });
         }
         break;
@@ -406,12 +417,6 @@ var SessionReplayer = class {
         }, selector);
         break;
       }
-      case "scroll": {
-        await page.evaluate(() => {
-          window.scrollBy(action.scrollX ?? 0, action.scrollY ?? 0);
-        });
-        break;
-      }
       default:
         break;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.22.0",
+  "version": "1.23.1",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {
@@ -72,30 +72,34 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "lint": "eslint src/ bin/ --ext .ts",
+    "lint": "eslint src/ bin/ tests/ --ext .ts",
+    "lint:plugins": "eslint .xcli/plugins/ --ext .ts --max-warnings 0",
     "lint:plugin-contract": "node lint-scripts/check-plugin-contract.mjs && node lint-scripts/check-plugin-status.mjs",
     "lint:plugin-status": "node lint-scripts/check-plugin-status.mjs --update",
     "stealth:check": "vitest run tests/cdp-driver/stealth-health.test.ts tests/cdp-driver/stealth-audit.test.ts tests/cdp-driver/stealth-probe.test.ts",
     "lint:docs": "node lint-scripts/check-docs-consistency.mjs",
     "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
+    "typecheck:plugins": "tsc -p tsconfig.plugins.json --noEmit",
     "start": "node dist/cli.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
-    "validate": "npm run typecheck && npm run lint && npm run lint:docs && npm run lint:plugin-contract && npm run build && npm test",
+    "test:arena": "vitest run --config vitest.arena.config.ts",
+    "validate": "npm run typecheck && npm run typecheck:plugins && npm run lint && npm run lint:plugins && npm run lint:docs && npm run lint:plugin-contract && npm run build && npm test",
     "prepare": "husky"
   },
   "dependencies": {
-    "@dyyz1993/xcli-core": "^0.19.0",
+    "@dyyz1993/xcli-core": "^0.19.1",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@types/turndown": "^5.0.6",
     "cheerio": "^1.2.0",
-    "imapflow": "^1.3.3",
+    "imapflow": "^1.7.8",
     "lucide-react": "^1.14.0",
     "react-markdown": "^10.1.0",
     "react-syntax-highlighter": "^16.1.1",
     "remark-gfm": "^4.0.1",
-    "sharp": "^0.34.5",
+    "sharp": "^0.35.4",
     "turndown": "^7.2.4",
     "turndown-plugin-gfm": "^1.0.2",
     "ws": "^8.21.0",
@@ -124,6 +128,6 @@
     ]
   },
   "optionalDependencies": {
-    "undici": "^7.28.0"
+    "undici": "^7.29.1"
   }
 }