crawlio-browser 1.3.0 → 1.4.1

package/dist/mcp-server/init-EJMNI6KH.js

@@ -0,0 +1,774 @@
+import {
+  PKG_VERSION
+} from "./chunk-DUJTVASE.js";
+
+// src/mcp-server/init.ts
+import { execFileSync, spawn } from "child_process";
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, copyFileSync } from "fs";
+import { join, resolve, dirname, sep, basename } from "path";
+import { homedir, platform } from "os";
+import { createServer as createNetServer } from "net";
+import { createInterface } from "readline";
+import { fileURLToPath } from "url";
+var PORTAL_URL = "http://127.0.0.1:3001";
+var HEALTH_URL = `${PORTAL_URL}/health`;
+var MCP_URL = `${PORTAL_URL}/mcp`;
+var HOME = homedir();
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+var green = (s) => `\x1B[32m${s}\x1B[0m`;
+var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var RESET = "\x1B[0m";
+var LOGO_GRADIENT = [
+  "\x1B[38;5;87m",
+  // bright cyan
+  "\x1B[38;5;80m",
+  // cyan
+  "\x1B[38;5;74m",
+  // steel cyan
+  "\x1B[38;5;68m",
+  // steel blue
+  "\x1B[38;5;62m",
+  // medium blue
+  "\x1B[38;5;56m"
+  // deep blue
+];
+function parseFlags(argv) {
+  const opts = {
+    portal: false,
+    full: false,
+    dryRun: false,
+    plugin: false,
+    cloudflare: false,
+    agents: [],
+    yes: false
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--portal") opts.portal = true;
+    else if (arg === "--full") opts.full = true;
+    else if (arg === "--dry-run") opts.dryRun = true;
+    else if (arg === "--plugin") opts.plugin = true;
+    else if (arg === "--cloudflare") opts.cloudflare = true;
+    else if (arg === "--yes" || arg === "-y") opts.yes = true;
+    else if (arg === "-a" && i + 1 < argv.length) {
+      opts.agents.push(argv[++i]);
+    }
+  }
+  return opts;
+}
+function buildAddMcpArgs(options) {
+  const args = ["-y", "add-mcp"];
+  const pkg = `crawlio-browser@${PKG_VERSION}`;
+  if (options.portal) {
+    args.push(MCP_URL);
+  } else if (options.full) {
+    args.push(`${pkg} --full`);
+  } else {
+    args.push(pkg);
+  }
+  args.push("--name", "crawlio-browser", "--global", "--yes");
+  for (const agent of options.agents) {
+    args.push("-a", agent);
+  }
+  return args;
+}
+function buildStdioEntry(options) {
+  const args = ["-y", `crawlio-browser@${PKG_VERSION}`];
+  if (options?.full) args.push("--full");
+  return { command: "npx", args };
+}
+function buildPortalEntry() {
+  return { type: "http", url: MCP_URL };
+}
+function isAlreadyConfigured(config) {
+  if ("crawlio-browser" in config.mcpServers || "crawlio-agent" in config.mcpServers) return true;
+  for (const entry of Object.values(config.mcpServers)) {
+    const e = entry;
+    const args = e?.args;
+    if (args?.some((a) => typeof a === "string" && a.includes("crawlio-browser"))) return true;
+    const cmd = e?.command;
+    if (cmd?.includes("crawlio-browser")) return true;
+  }
+  return false;
+}
+function buildCloudflareEntry(accountId, apiToken) {
+  return {
+    command: "npx",
+    args: ["-y", "@cloudflare/mcp-server-cloudflare@0.2.0", "run", accountId],
+    env: { CLOUDFLARE_API_TOKEN: apiToken }
+  };
+}
+function isCloudflareConfigured(config) {
+  return "cloudflare" in config.mcpServers || "cloudflare-bindings" in config.mcpServers || "cloudflare-builds" in config.mcpServers;
+}
+async function confirm(question, defaultYes = true) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return defaultYes;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const hint = defaultYes ? "[Y/n]" : "[y/N]";
+  return new Promise((resolve2) => {
+    rl.question(`  ${question} ${dim(hint)} `, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      resolve2(a === "" ? defaultYes : a === "y" || a === "yes");
+    });
+  });
+}
+function findMcpConfig() {
+  const candidates = [
+    join(process.cwd(), ".mcp.json"),
+    join(HOME, ".mcp.json"),
+    join(HOME, ".claude", "mcp.json")
+    // Claude Code global config
+  ];
+  for (const p of candidates) {
+    if (!existsSync(p)) continue;
+    try {
+      const raw = readFileSync(p, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (parsed && typeof parsed === "object" && "mcpServers" in parsed) {
+        return { path: p, config: parsed };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function findConflictingConfigs() {
+  const locations = [
+    join(process.cwd(), ".mcp.json"),
+    join(HOME, ".mcp.json"),
+    join(HOME, ".claude", "mcp.json"),
+    // Claude Code project config (if different from cwd)
+    join(process.cwd(), ".claude", "mcp.json")
+  ];
+  const conflicts = [];
+  for (const p of locations) {
+    if (!existsSync(p)) continue;
+    try {
+      const raw = readFileSync(p, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (parsed?.mcpServers && isAlreadyConfigured(parsed)) {
+        conflicts.push(p);
+      }
+    } catch {
+    }
+  }
+  return conflicts;
+}
+async function healthCheck() {
+  try {
+    const res = await fetch(HEALTH_URL);
+    if (!res.ok) return { ok: false };
+    const data = await res.json();
+    return { ok: true, toolCount: data.toolCount, bridgeConnected: data.bridgeConnected };
+  } catch {
+    return { ok: false };
+  }
+}
+async function waitForHealth(retries, delayMs) {
+  for (let i = 0; i < retries; i++) {
+    const result = await healthCheck();
+    if (result.ok) return result;
+    await new Promise((r) => setTimeout(r, delayMs));
+  }
+  return { ok: false };
+}
+function getServerEntryPath() {
+  return resolve(dirname(fileURLToPath(import.meta.url)), "index.js");
+}
+function resolveNodePath() {
+  try {
+    const cmd = platform() === "win32" ? "where" : "which";
+    const result = execFileSync(cmd, ["node"], { encoding: "utf-8", timeout: 5e3 }).trim();
+    const firstLine = result.split("\n")[0].trim();
+    if (firstLine && existsSync(firstLine)) return firstLine;
+  } catch {
+  }
+  return process.execPath;
+}
+function isPortFree(port) {
+  return new Promise((resolve2) => {
+    const srv = createNetServer();
+    srv.once("error", () => resolve2(false));
+    srv.once("listening", () => {
+      srv.close(() => resolve2(true));
+    });
+    srv.listen(port, "127.0.0.1");
+  });
+}
+function generatePlist(nodePath, serverPath) {
+  const logDir = join(HOME, "Library/Logs/Crawlio");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.crawlio.browser</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${serverPath}</string>
+    <string>--portal</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logDir}/server.log</string>
+  <key>StandardErrorPath</key>
+  <string>${logDir}/server.err</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+  </dict>
+</dict>
+</plist>`;
+}
+async function ensurePortalRunning(dryRun) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("Portal Server")}`);
+  const health = await healthCheck();
+  if (health.ok) {
+    console.log(`    ${green("+")} Server already running on ${PORTAL_URL}`);
+    return;
+  }
+  const serverPath = getServerEntryPath();
+  const nodePath = resolveNodePath();
+  if (dryRun) {
+    console.log(`    ${dim("~")} Node path: ${nodePath}`);
+    console.log(`    ${dim("~")} Server entry: ${serverPath}`);
+    if (platform() === "darwin") {
+      const plistPath = join(HOME, "Library/LaunchAgents/com.crawlio.browser.plist");
+      console.log(`    ${dim("~")} Would write plist to: ${plistPath}`);
+      console.log(`    ${dim("~")} Would run: launchctl load ${plistPath}`);
+    } else {
+      console.log(`    ${dim("~")} Would spawn detached: ${nodePath} ${serverPath} --portal`);
+    }
+    return;
+  }
+  if (platform() === "darwin") {
+    const plistDir = join(HOME, "Library/LaunchAgents");
+    const plistPath = join(plistDir, "com.crawlio.browser.plist");
+    const logDir = join(HOME, "Library/Logs/Crawlio");
+    mkdirSync(logDir, { recursive: true });
+    mkdirSync(plistDir, { recursive: true });
+    try {
+      execFileSync("launchctl", ["unload", plistPath], { stdio: "ignore" });
+    } catch {
+    }
+    writeFileSync(plistPath, generatePlist(nodePath, serverPath));
+    try {
+      execFileSync("launchctl", ["load", plistPath]);
+    } catch {
+      return startDetachedServer(serverPath, nodePath);
+    }
+    const result = await waitForHealth(5, 1e3);
+    if (result.ok) {
+      console.log(`    ${green("+")} Server running on ${PORTAL_URL}`);
+      console.log(`    ${green("+")} Auto-start on login configured (launchd)`);
+      return;
+    }
+    const portFree = await isPortFree(3001);
+    if (!portFree) {
+      console.log(`    ${yellow("!")} Port 3001 is already in use by another process`);
+      console.log(`    ${dim("  Try: npx crawlio-browser --portal --port 3002")}`);
+      return;
+    }
+    console.log(`    ${yellow("!")} launchd loaded but server not responding, falling back...`);
+    return startDetachedServer(serverPath, nodePath);
+  }
+  return startDetachedServer(serverPath, nodePath);
+}
+async function startDetachedServer(serverPath, nodePath) {
+  const crawlioDir = join(HOME, ".crawlio");
+  mkdirSync(crawlioDir, { recursive: true });
+  const pidFile = join(crawlioDir, "server.pid");
+  const child = spawn(nodePath, [serverPath, "--portal"], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  if (child.pid) {
+    writeFileSync(pidFile, String(child.pid));
+  }
+  const result = await waitForHealth(5, 1e3);
+  if (result.ok) {
+    console.log(`    ${green("+")} Server running on ${PORTAL_URL}`);
+    console.log(`    ${dim("  PID saved to ~/.crawlio/server.pid")}`);
+  } else {
+    const portFree = await isPortFree(3001);
+    if (!portFree) {
+      console.log(`    ${yellow("!")} Port 3001 is already in use by another process`);
+      console.log(`    ${dim("  Try: npx crawlio-browser --portal --port 3002")}`);
+    } else {
+      console.log(`    ${yellow("!")} Server started but health check failed \u2014 check logs`);
+    }
+  }
+}
+function installBrowserSkill(dryRun) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("Skills")}`);
+  const claudeDir = join(HOME, ".claude");
+  if (!existsSync(claudeDir)) {
+    console.log(`    ${dim("  i ~/.claude not found \u2014 skipping skill install")}`);
+    return;
+  }
+  const moduleDir = dirname(fileURLToPath(import.meta.url));
+  const skillSrcDir = resolve(moduleDir, "..", "..", "skills", "browser-automation");
+  const skillFiles = ["SKILL.md", "reference.md"];
+  if (!existsSync(join(skillSrcDir, "SKILL.md"))) {
+    console.log(`    ${yellow("!")} Skill source not found at ${dim(skillSrcDir)}`);
+    return;
+  }
+  const userDest = join(claudeDir, "skills", "browser-automation");
+  const projectClaudeDir = join(process.cwd(), ".claude");
+  const projectDest = existsSync(projectClaudeDir) ? join(projectClaudeDir, "skills", "browser-automation") : null;
+  if (dryRun) {
+    console.log(`    ${dim("~")} Would copy SKILL.md + reference.md to ${userDest}`);
+    if (projectDest) {
+      console.log(`    ${dim("~")} Would copy SKILL.md + reference.md to ${projectDest}`);
+    }
+    return;
+  }
+  mkdirSync(userDest, { recursive: true });
+  for (const file of skillFiles) {
+    const src = join(skillSrcDir, file);
+    if (existsSync(src)) copyFileSync(src, join(userDest, file));
+  }
+  console.log(`    ${green("+")} Skill installed to ${dim(userDest)}`);
+  if (projectDest) {
+    mkdirSync(projectDest, { recursive: true });
+    for (const file of skillFiles) {
+      const src = join(skillSrcDir, file);
+      if (existsSync(src)) copyFileSync(src, join(projectDest, file));
+    }
+    console.log(`    ${green("+")} Skill installed to ${dim(projectDest)}`);
+  }
+}
+function extractSkillName(relativePath) {
+  const parts = relativePath.split(/[/\\]/);
+  if (parts.length < 3 || parts[0] !== "skills") return null;
+  return parts[1];
+}
+function installPlugin(dryRun) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("Plugins")}`);
+  const pluginsDir = join(HOME, ".crawlio", "plugins");
+  const pluginDir = join(pluginsDir, "crawlio-plugin");
+  if (dryRun) {
+    console.log(`    ${dim("~")} Plugin target: ${pluginDir}`);
+    console.log(`    ${dim("~")} Would clone: https://github.com/Crawlio-app/crawlio-plugin.git`);
+    return;
+  }
+  mkdirSync(pluginsDir, { recursive: true });
+  if (existsSync(join(pluginDir, ".claude-plugin", "plugin.json"))) {
+    console.log(`    ${green("+")} Plugin already installed at ${dim(pluginDir)}`);
+    try {
+      execFileSync("git", ["-C", pluginDir, "pull", "--ff-only"], { stdio: "ignore", timeout: 15e3 });
+      console.log(`    ${green("+")} Updated to latest`);
+    } catch {
+    }
+  } else {
+    try {
+      execFileSync("git", ["clone", "https://github.com/Crawlio-app/crawlio-plugin.git", pluginDir], {
+        timeout: 3e4,
+        stdio: "pipe"
+      });
+      console.log(`    ${green("+")} Cloned to ${dim(pluginDir)}`);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      console.log(`    ${yellow("!")} Clone failed: ${msg.slice(0, 150)}`);
+      return;
+    }
+  }
+  if (existsSync(join(HOME, ".claude"))) {
+    const claudeSkillsDir = join(HOME, ".claude", "skills");
+    mkdirSync(claudeSkillsDir, { recursive: true });
+    try {
+      const allFiles = readdirSync(pluginDir, { recursive: true, encoding: "utf-8" });
+      const skillFiles = allFiles.filter(
+        (f) => f.includes(`skills${sep}`) && f.endsWith(".md")
+      );
+      const installedSkills = [];
+      for (const relative of skillFiles) {
+        const skillName = extractSkillName(relative);
+        if (!skillName) continue;
+        const fileName = basename(relative);
+        const destDir = join(claudeSkillsDir, skillName);
+        mkdirSync(destDir, { recursive: true });
+        writeFileSync(join(destDir, fileName), readFileSync(join(pluginDir, relative), "utf-8"));
+        installedSkills.push(skillName);
+      }
+      if (installedSkills.length > 0) {
+        console.log(`    ${green("+")} ${installedSkills.length} skills copied to ${dim(claudeSkillsDir)} (${installedSkills.join(", ")})`);
+      }
+    } catch {
+    }
+    const agentsSrcDir = join(pluginDir, "agents");
+    if (existsSync(agentsSrcDir)) {
+      const agentsDestDir = join(HOME, ".claude", "agents");
+      mkdirSync(agentsDestDir, { recursive: true });
+      const agentFiles = readdirSync(agentsSrcDir, { encoding: "utf-8" }).filter((f) => f.endsWith(".md"));
+      for (const file of agentFiles) {
+        copyFileSync(join(agentsSrcDir, file), join(agentsDestDir, file));
+      }
+      if (agentFiles.length > 0) {
+        console.log(`    ${green("+")} ${agentFiles.length} agent(s) copied to ${dim(agentsDestDir)}`);
+      }
+    }
+  }
+}
+async function promptInput(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return "";
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(`    ${question} `, (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    });
+  });
+}
+async function verifyCloudflareToken(apiToken) {
+  try {
+    const res = await fetch("https://api.cloudflare.com/client/v4/accounts", {
+      headers: { Authorization: `Bearer ${apiToken}` }
+    });
+    if (!res.ok) {
+      return { ok: false, error: `HTTP ${res.status} \u2014 check token permissions` };
+    }
+    const data = await res.json();
+    if (!data.success) {
+      return { ok: false, error: data.errors?.[0]?.message || "Unknown error" };
+    }
+    return {
+      ok: true,
+      accounts: (data.result || []).map((a) => ({ id: a.id, name: a.name }))
+    };
+  } catch (error) {
+    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+async function cloudflareFlow(options) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("Cloudflare Integration")}`);
+  console.log(`    ${dim("Workers, KV, D1, R2, Queues, AI \u2014 89 tools via MCP")}`);
+  console.log("");
+  let apiToken = process.env.CLOUDFLARE_API_TOKEN || "";
+  if (apiToken) {
+    console.log(`    ${green("+")} Found CLOUDFLARE_API_TOKEN in environment`);
+  } else {
+    console.log(`    ${dim("Create a token at:")} ${cyan("https://dash.cloudflare.com/profile/api-tokens")}`);
+    console.log(`    ${dim("Recommended template: 'Edit Cloudflare Workers'")}`);
+    console.log("");
+    if (options.dryRun) {
+      console.log(`    ${dim("~")} Would prompt for API token`);
+      return;
+    }
+    apiToken = await promptInput("API Token:");
+    if (!apiToken) {
+      console.log(`    ${yellow("!")} No token provided \u2014 skipping Cloudflare setup`);
+      return;
+    }
+  }
+  const mask = apiToken.length > 12 ? apiToken.slice(0, 8) + "..." + apiToken.slice(-4) : "***";
+  console.log(`    ${dim("Verifying")} ${dim(mask)}`);
+  const verification = await verifyCloudflareToken(apiToken);
+  if (!verification.ok) {
+    console.log(`    ${yellow("!")} Token verification failed: ${verification.error}`);
+    return;
+  }
+  if (!verification.accounts || verification.accounts.length === 0) {
+    console.log(`    ${yellow("!")} No accounts found for this token`);
+    return;
+  }
+  let account;
+  if (verification.accounts.length === 1) {
+    account = verification.accounts[0];
+  } else {
+    console.log("");
+    console.log(`    Found ${verification.accounts.length} accounts:`);
+    for (let i = 0; i < verification.accounts.length; i++) {
+      const a = verification.accounts[i];
+      console.log(`      ${dim(`${i + 1}.`)} ${a.name} ${dim(`(${a.id.slice(0, 8)}...)`)}`);
+    }
+    const envAccountId = process.env.CLOUDFLARE_ACCOUNT_ID || "";
+    const envMatch = envAccountId ? verification.accounts.find((a) => a.id === envAccountId) : null;
+    if (envMatch) {
+      account = envMatch;
+      console.log(`    ${green("+")} Using CLOUDFLARE_ACCOUNT_ID from environment`);
+    } else if (options.yes) {
+      account = verification.accounts[0];
+    } else {
+      const choice = await promptInput(`Select account [1-${verification.accounts.length}]:`);
+      const idx = parseInt(choice, 10) - 1;
+      if (isNaN(idx) || idx < 0 || idx >= verification.accounts.length) {
+        account = verification.accounts[0];
+        console.log(`    ${dim("Using first account")}`);
+      } else {
+        account = verification.accounts[idx];
+      }
+    }
+  }
+  console.log(`    ${green("+")} ${account.name} ${dim(`(${account.id.slice(0, 8)}...)`)}`);
+  const entry = buildCloudflareEntry(account.id, apiToken);
+  if (options.dryRun) {
+    console.log(`    ${dim("~")} Would add cloudflare MCP server with 89 tools`);
+    console.log(`    ${dim("~")} Account: ${account.name} (${account.id})`);
+    return;
+  }
+  const mcpConfig = findMcpConfig();
+  if (mcpConfig) {
+    if (isCloudflareConfigured(mcpConfig.config)) {
+      const overwrite = options.yes || await confirm("Cloudflare already configured. Overwrite?", false);
+      if (!overwrite) {
+        console.log(`    ${dim("Kept existing configuration")}`);
+        return;
+      }
+      delete mcpConfig.config.mcpServers["cloudflare-bindings"];
+      delete mcpConfig.config.mcpServers["cloudflare-builds"];
+    }
+    mcpConfig.config.mcpServers["cloudflare"] = entry;
+    writeFileSync(mcpConfig.path, JSON.stringify(mcpConfig.config, null, 2) + "\n");
+    console.log(`    ${green("+")} Added cloudflare to ${mcpConfig.path}`);
+  } else {
+    const configPath = join(process.cwd(), ".mcp.json");
+    const config = { mcpServers: { cloudflare: entry } };
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    console.log(`    ${green("+")} Created ${configPath} with cloudflare`);
+  }
+  console.log(`    ${green("+")} 89 Cloudflare tools ready (Workers, KV, D1, R2, Queues, AI)`);
+}
+async function portalFlow(options) {
+  await ensurePortalRunning(options.dryRun);
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("MCP Configuration")} ${dim("(portal mode)")}`);
+  runAddMcp(options);
+}
+async function configureMetaMcp(found, options) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("MCP Configuration")} ${dim("(.mcp.json)")}`);
+  if (isAlreadyConfigured(found.config)) {
+    console.log(`    ${green("+")} crawlio-browser already configured in ${dim(found.path)}`);
+    return;
+  }
+  const conflicts = findConflictingConfigs();
+  if (conflicts.length > 0) {
+    console.log(`    ${yellow("!")} crawlio-browser already configured in:`);
+    for (const c of conflicts) {
+      console.log(`      ${dim("\u2192")} ${c}`);
+    }
+    console.log(`    ${yellow("!")} Adding a second entry would cause a port collision (port 9333)`);
+    if (!options.yes) {
+      const proceed = await confirm("Add anyway? (not recommended)", false);
+      if (!proceed) {
+        console.log(`    ${dim("Skipped \u2014 using existing configuration")}`);
+        return;
+      }
+    } else {
+      console.log(`    ${dim("Skipped \u2014 existing configuration takes priority")}`);
+      return;
+    }
+  }
+  if (!options.yes) {
+    const proceed = await confirm("Add crawlio-browser to this config?");
+    if (!proceed) {
+      console.log(`    ${dim("Skipped")}`);
+      return;
+    }
+  }
+  const entry = options.portal ? buildPortalEntry() : buildStdioEntry({ full: options.full });
+  if (options.dryRun) {
+    console.log(`    ${dim("~")} Would add to ${found.path}:`);
+    console.log(`    ${dim("~")} "crawlio-browser": ${JSON.stringify(entry)}`);
+    return;
+  }
+  found.config.mcpServers["crawlio-browser"] = entry;
+  writeFileSync(found.path, JSON.stringify(found.config, null, 2) + "\n");
+  console.log(`    ${green("+")} Added crawlio-browser to ${found.path}`);
+}
+function configureStdioClients(options) {
+  console.log("");
+  console.log(`  ${cyan("\u25C6")} ${bold("MCP Configuration")} ${dim("(stdio mode)")}`);
+  runAddMcp(options);
+}
+function runAddMcp(options) {
+  const npxBin = platform() === "win32" ? "npx.cmd" : "npx";
+  const args = buildAddMcpArgs(options);
+  if (options.dryRun) {
+    console.log(`    ${dim("~")} Would run: ${npxBin} ${args.join(" ")}`);
+    return;
+  }
+  try {
+    const output = execFileSync(npxBin, args, {
+      encoding: "utf-8",
+      timeout: 6e4,
+      env: { ...process.env, npm_config_yes: "true" }
+    });
+    const lines = output.split("\n").filter((l) => l.trim());
+    let configuredCount = 0;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed) {
+        console.log(`    ${green("+")} ${trimmed}`);
+        configuredCount++;
+      }
+    }
+    if (configuredCount === 0) {
+      console.log(`    ${dim("  add-mcp ran but no clients detected")}`);
+    }
+  } catch (error) {
+    const errObj = error;
+    const code = errObj?.code;
+    const msg = error instanceof Error ? error.message : String(error);
+    if (code === "ENOENT") {
+      console.log(`    ${yellow("!")} ${npxBin} not found in PATH \u2014 install Node.js 18+ and retry`);
+    } else if (code === "ETIMEDOUT" || msg.includes("ETIMEDOUT") || msg.includes("timed out")) {
+      console.log(`    ${yellow("!")} add-mcp timed out \u2014 check network and retry`);
+    } else {
+      console.log(`    ${yellow("!")} add-mcp failed: ${msg.slice(0, 200)}`);
+    }
+    const target = options.portal ? MCP_URL : "crawlio-browser";
+    console.log(`    ${dim(`  Manual: npx add-mcp ${target} --name crawlio-browser --global`)}`);
+  }
+}
+var LOGO_LINES = [
+  " \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2557    \u2588\u2588\u2557 \u2588\u2588\u2557      \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2551    \u2588\u2588\u2551 \u2588\u2588\u2551      \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557",
+  "\u2588\u2588\u2551      \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2551      \u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551",
+  "\u2588\u2588\u2551      \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551      \u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551",
+  "\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551  \u2588\u2588\u2551 \u2588\u2588\u2551  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  " \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D  \u255A\u2550\u2550\u255D\u255A\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D"
+];
+function printBanner() {
+  console.log("");
+  for (let i = 0; i < LOGO_LINES.length; i++) {
+    console.log(`  ${LOGO_GRADIENT[i]}${LOGO_LINES[i]}${RESET}`);
+  }
+  console.log("");
+  console.log(`  ${dim("Browser automation via MCP")}  ${dim("\xB7")}  ${dim("v" + PKG_VERSION)}`);
+  console.log("");
+}
+function printRule() {
+  console.log(`  ${dim("\u2500".repeat(56))}`);
+}
+function printBox(title, lines, footer) {
+  const width = 56;
+  const border = (s) => cyan(s);
+  console.log(`  ${border("\u250C\u2500")} ${bold(title)} ${border("\u2500".repeat(Math.max(0, width - title.length - 4)))}${border("\u2510")}`);
+  console.log(`  ${border("\u2502")}${" ".repeat(width)}${border("\u2502")}`);
+  for (const line of lines) {
+    const padding = Math.max(0, width - stripAnsi(line).length);
+    console.log(`  ${border("\u2502")}  ${line}${" ".repeat(padding - 2)}${border("\u2502")}`);
+  }
+  console.log(`  ${border("\u2502")}${" ".repeat(width)}${border("\u2502")}`);
+  if (footer) {
+    console.log(`  ${border("\u251C\u2500")} ${bold(footer.title)} ${border("\u2500".repeat(Math.max(0, width - footer.title.length - 4)))}${border("\u2524")}`);
+    console.log(`  ${border("\u2502")}${" ".repeat(width)}${border("\u2502")}`);
+    for (const line of footer.lines) {
+      const padding = Math.max(0, width - stripAnsi(line).length);
+      console.log(`  ${border("\u2502")}  ${line}${" ".repeat(padding - 2)}${border("\u2502")}`);
+    }
+    console.log(`  ${border("\u2502")}${" ".repeat(width)}${border("\u2502")}`);
+  }
+  console.log(`  ${border("\u2514")}${border("\u2500".repeat(width))}${border("\u2518")}`);
+}
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+async function printSummary(options) {
+  console.log("");
+  const statusLines = [];
+  if (options.portal) {
+    const health = await healthCheck();
+    if (health.ok) {
+      statusLines.push(`${green("+")} Mode        Portal (${health.toolCount ?? "?"} tools)`);
+    } else {
+      statusLines.push(`${yellow("!")} Portal      Not responding`);
+    }
+    if (health.bridgeConnected) {
+      statusLines.push(`${green("+")} Extension   Connected`);
+    } else {
+      statusLines.push(`${dim("i")} Extension   Not connected yet`);
+    }
+  } else {
+    const modeLabel = options.full ? "Full mode" : "Code mode";
+    statusLines.push(`${green("+")} Mode        ${modeLabel} (3 tools, 128 commands)`);
+  }
+  statusLines.push(`${green("+")} Skill       Browser automation installed`);
+  statusLines.push(`${green("+")} Extension   ${cyan("https://crawlio.app/agent")}`);
+  if (options.cloudflare) {
+    const mcpCfg = findMcpConfig();
+    if (mcpCfg && "cloudflare" in mcpCfg.config.mcpServers) {
+      statusLines.push(`${green("+")} Cloudflare  89 tools (Workers, KV, D1, R2)`);
+    } else {
+      statusLines.push(`${yellow("!")} Cloudflare  Not configured`);
+    }
+  }
+  const nextLines = [];
+  nextLines.push(`1. Install the Chrome extension`);
+  nextLines.push(`2. Open any MCP client (Claude Code, Cursor, etc.)`);
+  nextLines.push(`3. Ask your AI to use crawlio-browser tools`);
+  nextLines.push(``);
+  if (!options.portal) {
+    nextLines.push(`${dim("Tip: use --portal for multi-client or ChatGPT Desktop")}`);
+  } else {
+    nextLines.push(`${dim("Tip: portal running at " + PORTAL_URL)}`);
+  }
+  printBox("Setup Complete", statusLines, { title: "What's Next", lines: nextLines });
+  console.log("");
+}
+async function runInit(argv) {
+  const options = parseFlags(argv);
+  printBanner();
+  printRule();
+  if (options.dryRun) {
+    console.log(`  ${yellow("\u25C7")} ${bold(yellow("Dry Run"))} ${dim("\u2014 showing what init would do without executing")}`);
+    console.log("");
+  }
+  console.log(`  ${cyan("\u25C6")} ${bold("Preflight")}`);
+  const nodeVersion = parseInt(process.versions.node.split(".")[0], 10);
+  if (nodeVersion < 18) {
+    console.log(`    ${yellow("!")} Node.js ${process.versions.node} \u2014 18+ required`);
+    console.log(`    ${dim("  Install via: https://nodejs.org")}`);
+    process.exit(1);
+  }
+  console.log(`    ${green("+")} Node.js ${process.versions.node} \u2014 OK`);
+  if (options.portal) {
+    await portalFlow(options);
+  } else {
+    const mcpConfig = findMcpConfig();
+    if (mcpConfig) {
+      await configureMetaMcp(mcpConfig, options);
+    } else {
+      configureStdioClients(options);
+    }
+  }
+  installBrowserSkill(options.dryRun);
+  if (options.plugin) {
+    installPlugin(options.dryRun);
+  }
+  if (options.cloudflare) {
+    await cloudflareFlow(options);
+  }
+  printRule();
+  await printSummary(options);
+}
+export {
+  buildAddMcpArgs,
+  buildCloudflareEntry,
+  buildPortalEntry,
+  buildStdioEntry,
+  extractSkillName,
+  findConflictingConfigs,
+  findMcpConfig,
+  installBrowserSkill,
+  isAlreadyConfigured,
+  isCloudflareConfigured,
+  parseFlags,
+  runInit,
+  verifyCloudflareToken
+};