@ada-mcp/mcp-server 0.1.19 → 0.1.20

package/dist/cli.cjs

@@ -3005,14 +3005,55 @@ async function resolveNativeDriversDir(workspaceRoot) {
   }
   return import_node_path4.default.join(root, DEFAULT_NATIVE_DRIVERS_DIR);
 }
-function platformArchiveSuffix() {
+function geckodriverMirrorBase() {
+  const fromEnv = process.env.ADA_GECKODRIVER_MIRROR?.trim();
+  return (fromEnv || DEFAULT_GECKODRIVER_MIRROR).replace(/\/$/, "");
+}
+function geckodriverPlatformAsset(tag) {
+  const t = tag.startsWith("v") ? tag : `v${tag}`;
   if (process.platform === "win32") {
-    return "win64.zip";
+    const winSuffix = process.arch === "arm64" ? "win-aarch64" : process.arch === "ia32" ? "win32" : "win64";
+    return { fileName: `geckodriver-${t}-${winSuffix}.zip`, archiveKind: "zip" };
   }
   if (process.platform === "darwin") {
-    return process.arch === "arm64" ? "macos-aarch64.zip" : "macos.zip";
+    const macSuffix = process.arch === "arm64" ? "macos-aarch64" : "macos";
+    return { fileName: `geckodriver-${t}-${macSuffix}.tar.gz`, archiveKind: "tar.gz" };
+  }
+  const linuxSuffix = process.arch === "arm64" ? "linux-aarch64" : process.arch === "ia32" ? "linux32" : "linux64";
+  return { fileName: `geckodriver-${t}-${linuxSuffix}.tar.gz`, archiveKind: "tar.gz" };
+}
+function parseSemverTuple(version2) {
+  const m = version2.replace(/^v/i, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) {
+    return null;
+  }
+  return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function compareSemverDesc(a, b) {
+  const pa = parseSemverTuple(a);
+  const pb = parseSemverTuple(b);
+  if (!pa || !pb) {
+    return 0;
+  }
+  for (let i = 0; i < 3; i += 1) {
+    if (pa[i] !== pb[i]) {
+      return pb[i] - pa[i];
+    }
   }
-  return "linux64.zip";
+  return 0;
+}
+async function fetchGeckodriverLatestFromMirror(mirrorBase) {
+  const res = await fetch(`${mirrorBase}/`);
+  if (!res.ok) {
+    return null;
+  }
+  const html = await res.text();
+  const tags = /* @__PURE__ */ new Set();
+  for (const m of html.matchAll(/href="v(\d+\.\d+\.\d+)\//gi)) {
+    tags.add(`v${m[1]}`);
+  }
+  const sorted = Array.from(tags).sort(compareSemverDesc);
+  return sorted[0] ?? null;
 }
 function platformChromeLabel() {
   if (process.platform === "win32") {
@@ -3197,6 +3238,21 @@ async function extractZip(zipPath, destDir) {
   }
   await runCommand("unzip", ["-o", zipPath, "-d", destDir]);
 }
+async function extractTarGz(archivePath, destDir) {
+  await import_promises4.default.mkdir(destDir, { recursive: true });
+  if (process.platform === "win32") {
+    await runCommand("tar", ["-xzf", archivePath, "-C", destDir]);
+    return;
+  }
+  await runCommand("tar", ["-xzf", archivePath, "-C", destDir]);
+}
+async function extractDriverArchive(archivePath, destDir, kind) {
+  if (kind === "zip") {
+    await extractZip(archivePath, destDir);
+    return;
+  }
+  await extractTarGz(archivePath, destDir);
+}
 async function findFileRecursive(dir, fileName) {
   const entries = await import_promises4.default.readdir(dir, { withFileTypes: true });
   for (const ent of entries) {
@@ -3224,13 +3280,26 @@ async function fetchGeckodriverReleaseVersion(requested) {
   if (requested && requested !== "latest") {
     return requested.startsWith("v") ? requested : `v${requested}`;
   }
-  const res = await fetch("https://api.github.com/repos/mozilla/geckodriver/releases/latest");
-  if (!res.ok) {
-    throw new Error(`Failed to fetch geckodriver latest release: HTTP ${res.status}`);
+  const mirrorLatest = await fetchGeckodriverLatestFromMirror(geckodriverMirrorBase());
+  if (mirrorLatest) {
+    return mirrorLatest;
   }
-  const json3 = await res.json();
-  const tag = json3.tag_name ?? "v0.36.0";
-  return tag.startsWith("v") ? tag : `v${tag}`;
+  try {
+    const res = await fetch("https://api.github.com/repos/mozilla/geckodriver/releases/latest");
+    if (res.ok) {
+      const json3 = await res.json();
+      const tag = json3.tag_name ?? "v0.36.0";
+      return tag.startsWith("v") ? tag : `v${tag}`;
+    }
+  } catch {
+  }
+  return "v0.36.0";
+}
+function buildGeckodriverDownloadUrls(tag) {
+  const { fileName, archiveKind } = geckodriverPlatformAsset(tag);
+  const mirror = `${geckodriverMirrorBase()}/${tag}/${fileName}`;
+  const github = `${GITHUB_GECKODRIVER_RELEASES}/download/${tag}/${fileName}`;
+  return { mirror, github, fileName, archiveKind };
 }
 async function listChromedriverCfTVersions() {
   const res = await fetch(CHROME_FOR_TESTING_JSON);
@@ -3474,26 +3543,39 @@ async function downloadToFile(url2, destPath) {
 async function downloadGeckodriver(driversDir, versionInput, onLogLine) {
   const tag = await fetchGeckodriverReleaseVersion(versionInput);
   const version2 = tag.replace(/^v/, "");
-  const suffix = platformArchiveSuffix();
-  const assetName = `geckodriver-${tag}-${suffix}`.replace("vv", "v");
-  const url2 = `https://github.com/mozilla/geckodriver/releases/download/${tag}/geckodriver-${tag}-${suffix}`;
+  const { mirror, github, fileName, archiveKind } = buildGeckodriverDownloadUrls(tag);
   await import_promises4.default.mkdir(driversDir, { recursive: true });
-  const zipPath = import_node_path4.default.join(driversDir, `_download_geckodriver_${version2}.zip`);
+  const archiveExt = archiveKind === "zip" ? "zip" : "tar.gz";
+  const archivePath = import_node_path4.default.join(driversDir, `_download_geckodriver_${version2}.${archiveExt}`);
   const extractDir = import_node_path4.default.join(driversDir, `_extract_geckodriver_${version2}`);
-  onLogLine?.(`[selenium] \u4E0B\u8F7D geckodriver ${tag} \u2192 ${driversDir}`);
-  onLogLine?.(`[selenium] URL: ${url2}`);
-  await downloadToFile(url2, zipPath);
+  onLogLine?.(`[selenium] ?? geckodriver ${tag}?${fileName}?? ${driversDir}`);
+  onLogLine?.(`[selenium] ??: ${mirror}`);
+  let downloaded = false;
+  try {
+    await downloadToFile(mirror, archivePath);
+    downloaded = true;
+  } catch (mirrorError) {
+    onLogLine?.(
+      `[selenium][warn] ?????????: ${mirrorError instanceof Error ? mirrorError.message : String(mirrorError)}`
+    );
+    onLogLine?.(`[selenium] ?? GitHub: ${github}`);
+    await downloadToFile(github, archivePath);
+    downloaded = true;
+  }
+  if (!downloaded) {
+    throw new Error(`geckodriver download failed for ${tag}`);
+  }
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
-  await extractZip(zipPath, extractDir);
+  await extractDriverArchive(archivePath, extractDir, archiveKind);
   const found = await findFileRecursive(extractDir, geckodriverExeName());
   if (!found) {
-    throw new Error(`geckodriver binary not found after extracting ${assetName}`);
+    throw new Error(`geckodriver binary not found after extracting ${fileName}`);
   }
   const dest = import_node_path4.default.join(driversDir, geckodriverExeName());
   await copyExecutable(found, dest);
-  await import_promises4.default.rm(zipPath, { force: true });
+  await import_promises4.default.rm(archivePath, { force: true });
   await import_promises4.default.rm(extractDir, { recursive: true, force: true });
-  onLogLine?.(`[selenium] geckodriver \u5DF2\u5199\u5165: ${dest}`);
+  onLogLine?.(`[selenium] geckodriver ???: ${dest}`);
   return { path: dest, version: tag };
 }
 async function downloadChromedriver(driversDir, versionInput, onLogLine) {
@@ -3653,7 +3735,7 @@ async function ensureNativeWebDrivers(options = {}) {
   }
   return resolved;
 }
-var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON;
+var import_node_child_process, import_promises4, import_node_path4, DEFAULT_NATIVE_DRIVERS_DIR, CHROME_FOR_TESTING_JSON, DEFAULT_GECKODRIVER_MIRROR, GITHUB_GECKODRIVER_RELEASES, SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES;
 var init_src2 = __esm({
   "../../packages/native-drivers/src/index.ts"() {
     "use strict";
@@ -3662,6 +3744,46 @@ var init_src2 = __esm({
     import_node_path4 = __toESM(require("node:path"), 1);
     DEFAULT_NATIVE_DRIVERS_DIR = "dirver";
     CHROME_FOR_TESTING_JSON = "https://googlechromelabs.github.io/chrome-for-testing/known-good-versions-with-downloads.json";
+    DEFAULT_GECKODRIVER_MIRROR = "https://mirrors.huaweicloud.com/geckodriver";
+    GITHUB_GECKODRIVER_RELEASES = "https://github.com/mozilla/geckodriver/releases";
+    SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES = [
+      {
+        browser: "Chrome/Chromium",
+        platforms: "Windows/Linux/macOS",
+        vendor: "\u8C37\u6B4C",
+        url: "https://chromedriver.storage.googleapis.com/index.html"
+      },
+      {
+        browser: "Firefox",
+        platforms: "Windows/Linux/macOS",
+        vendor: "Mozilla / ?????",
+        url: `${DEFAULT_GECKODRIVER_MIRROR}/v0.36.0/?????????????? ${GITHUB_GECKODRIVER_RELEASES}?`
+      },
+      {
+        browser: "Edge",
+        platforms: "win10",
+        vendor: "\u5FAE\u8F6F",
+        url: "https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/"
+      },
+      {
+        browser: "Internet Explorer",
+        platforms: "Windows",
+        vendor: "Selenium \u9879\u76EE\u7EC4",
+        url: "https://selenium-release.storage.googleapis.com/index.html"
+      },
+      {
+        browser: "Safari",
+        platforms: "macOS El Capitan \u53CA\u66F4\u9AD8\u7248\u672C",
+        vendor: "\u82F9\u679C",
+        url: "\uFF08\u7CFB\u7EDF\u5185\u7F6E\uFF0C\u65E0\u9700\u5355\u72EC\u4E0B\u8F7D\uFF09"
+      },
+      {
+        browser: "Opera",
+        platforms: "Windows/macOS/Linux",
+        vendor: "Opera",
+        url: "https://github.com/operasoftware/operachromiumdriver/releases"
+      }
+    ];
   }
 });
 
@@ -4128,6 +4250,32 @@ function appiumDriverPackageName(driver) {
   }
   return null;
 }
+function resolveAppiumDriverInstallTargets(driver, appiumMajor, compatibleSpecs) {
+  const pkg = appiumDriverPackageName(driver);
+  if (appiumMajor !== null && appiumMajor >= 3) {
+    if (!APPIUM3_BUILTIN_DRIVER_NAMES.has(driver)) {
+      const envHarmony = process.env.ADA_APPIUM_DRIVER_SPEC_HARMONYOS?.trim();
+      if (driver === "harmonyos" && (envHarmony || pkg)) {
+        return [envHarmony || pkg];
+      }
+      return pkg ? [pkg] : [driver];
+    }
+    const envOverride = driver === "uiautomator2" ? process.env.ADA_APPIUM_DRIVER_SPEC_UIAUTOMATOR2?.trim() : driver === "xcuitest" ? process.env.ADA_APPIUM_DRIVER_SPEC_XCUITEST?.trim() : "";
+    if (envOverride) {
+      return [envOverride, driver];
+    }
+    return [driver];
+  }
+  const baseTarget = pkg ?? driver;
+  return compatibleSpecs.length > 0 ? compatibleSpecs : [baseTarget];
+}
+function buildAppiumDriverInstallArgs(target, appiumMajor) {
+  const useNpmPackageSpec = appiumMajor === null || appiumMajor < 3 || target.includes("@") || target.startsWith("appium-") || target.includes("/");
+  if (useNpmPackageSpec) {
+    return ["exec", "appium", "driver", "install", "--source=npm", target];
+  }
+  return ["exec", "appium", "driver", "install", target];
+}
 async function getAppiumMajorVersion() {
   let version2 = "";
   try {
@@ -4553,13 +4701,14 @@ async function runAppiumDriverInstallWithPriority(config2, driver, onLogLine) {
   onLogLine?.(`[appium] \u5B89\u88C5\u9A71\u52A8: ${driver}`);
   const compatibleSpecs = await resolveCompatibleDriverSpecs(driver);
   const appiumMajor = await getAppiumMajorVersion();
-  const directPackage = appiumDriverPackageName(driver);
-  const baseTarget = directPackage ?? driver;
-  const targets = appiumMajor !== null && appiumMajor < 3 ? compatibleSpecs.length > 0 ? compatibleSpecs : [baseTarget] : [baseTarget, ...compatibleSpecs];
-  const uniqueTargets = Array.from(new Set(targets.filter(Boolean)));
+  if (appiumMajor !== null && appiumMajor >= 3) {
+    onLogLine?.(`[appium] \u68C0\u6D4B\u5230 Appium ${appiumMajor}.x\uFF0C\u4F7F\u7528\u5B98\u65B9\u9A71\u52A8\u540D\u5B89\u88C5\uFF08\u5982 uiautomator2\uFF09`);
+  }
+  const uniqueTargets = resolveAppiumDriverInstallTargets(driver, appiumMajor, compatibleSpecs);
   let lastError = void 0;
   for (const target of uniqueTargets) {
-    const installArgs = ["exec", "appium", "driver", "install", "--source=npm", target];
+    const installArgs = buildAppiumDriverInstallArgs(target, appiumMajor);
+    onLogLine?.(`[appium] \u6267\u884C: npm ${installArgs.join(" ")}`);
     const strategies = [
       {
         name: "npm",
@@ -5182,7 +5331,7 @@ async function getDependencyHealth(config2) {
     missingAppiumDrivers
   };
 }
-var import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, PINNED_PLAYWRIGHT_VERSION, PINNED_ZOD_VERSION, depsHumanLog, DEFAULT_NPM_REGISTRY_CANDIDATES, detectedBestRegistryByKey, PROGRESS_STEPS, PROGRESS_HUMAN_LABELS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, CHINA_NPM_REGISTRY_HINTS, CHINA_PLAYWRIGHT_HOST_PRIORITY, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
+var import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, PINNED_PLAYWRIGHT_VERSION, PINNED_ZOD_VERSION, depsHumanLog, DEFAULT_NPM_REGISTRY_CANDIDATES, APPIUM3_BUILTIN_DRIVER_NAMES, detectedBestRegistryByKey, PROGRESS_STEPS, PROGRESS_HUMAN_LABELS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, CHINA_NPM_REGISTRY_HINTS, CHINA_PLAYWRIGHT_HOST_PRIORITY, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
 var init_dependency_installer = __esm({
   "../ada-agent/src/dependency-installer.ts"() {
     import_node_module = require("node:module");
@@ -5202,6 +5351,16 @@ var init_dependency_installer = __esm({
       "https://repo.huaweicloud.com/repository/npm",
       "https://registry.npmjs.org"
     ];
+    APPIUM3_BUILTIN_DRIVER_NAMES = /* @__PURE__ */ new Set([
+      "uiautomator2",
+      "xcuitest",
+      "espresso",
+      "mac2",
+      "windows",
+      "safari",
+      "gecko",
+      "chromium"
+    ]);
     detectedBestRegistryByKey = /* @__PURE__ */ new Map();
     PROGRESS_STEPS = [
       "deps.ensure.start",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",

package/plugins/driver-selenium.cjs

@@ -232,6 +232,46 @@ var import_node_child_process = require("node:child_process");
 var import_promises = __toESM(require("node:fs/promises"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 var DEFAULT_NATIVE_DRIVERS_DIR = "dirver";
+var DEFAULT_GECKODRIVER_MIRROR = "https://mirrors.huaweicloud.com/geckodriver";
+var GITHUB_GECKODRIVER_RELEASES = "https://github.com/mozilla/geckodriver/releases";
+var SELENIUM_DRIVER_MANUAL_DOWNLOAD_REFERENCES = [
+  {
+    browser: "Chrome/Chromium",
+    platforms: "Windows/Linux/macOS",
+    vendor: "\u8C37\u6B4C",
+    url: "https://chromedriver.storage.googleapis.com/index.html"
+  },
+  {
+    browser: "Firefox",
+    platforms: "Windows/Linux/macOS",
+    vendor: "Mozilla / ?????",
+    url: `${DEFAULT_GECKODRIVER_MIRROR}/v0.36.0/?????????????? ${GITHUB_GECKODRIVER_RELEASES}?`
+  },
+  {
+    browser: "Edge",
+    platforms: "win10",
+    vendor: "\u5FAE\u8F6F",
+    url: "https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/"
+  },
+  {
+    browser: "Internet Explorer",
+    platforms: "Windows",
+    vendor: "Selenium \u9879\u76EE\u7EC4",
+    url: "https://selenium-release.storage.googleapis.com/index.html"
+  },
+  {
+    browser: "Safari",
+    platforms: "macOS El Capitan \u53CA\u66F4\u9AD8\u7248\u672C",
+    vendor: "\u82F9\u679C",
+    url: "\uFF08\u7CFB\u7EDF\u5185\u7F6E\uFF0C\u65E0\u9700\u5355\u72EC\u4E0B\u8F7D\uFF09"
+  },
+  {
+    browser: "Opera",
+    platforms: "Windows/macOS/Linux",
+    vendor: "Opera",
+    url: "https://github.com/operasoftware/operachromiumdriver/releases"
+  }
+];
 async function fileExists(filePath) {
   try {
     await import_promises.default.access(filePath);