@xbrowser/cli 1.23.0 → 1.24.0

package/dist/{recovery-LGY25LIM.js → recovery-5C4FBA5O.js}

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

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

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-LPW6QS4M.js";
+} from "./chunk-FNXA6FDM.js";
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";

package/dist/{recovery-LMJW537X.js → recovery-IMZUGWSS.js}

@@ -3,7 +3,8 @@ import {
 } from "./chunk-3OD76SUE.js";
 import {
   HumanInteractionManager
-} from "./chunk-XTUAUFL3.js";
+} from "./chunk-SOPN4XDK.js";
+import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";
 

package/dist/server-NPINOVJS.js

@@ -0,0 +1,243 @@
+import {
+  executeChain,
+  executeCommand
+} from "./chunk-BROEUPL3.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-YVMWMNHD.js

@@ -0,0 +1,240 @@
+import {
+  executeChain,
+  executeCommand
+} from "./chunk-A7RZYSWM.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "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": {
@@ -130,4 +130,4 @@
   "optionalDependencies": {
     "undici": "^7.29.1"
   }
-}
+}