@ada-mcp/mcp-server 0.1.12 → 0.1.14

package/README.md

@@ -8,27 +8,27 @@ ADA MCP server package that supports:
 
 ## 标准安装（Cursor / MCP）
 
-请使用 **`@ada-mcp/launcher@0.1.7`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
+请使用 **`@ada-mcp/launcher@0.1.11`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
 
 ```json
 {
   "mcpServers": {
     "ada-mcp": {
       "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/launcher@0.1.7"]
+      "args": ["dlx", "@ada-mcp/launcher@0.1.11"]
     }
   }
 }
 ```
 
-本包版本：**`@ada-mcp/mcp-server@0.1.10`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
+本包版本：**`@ada-mcp/mcp-server@0.1.14`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
 
 直接调试本包（无 launcher 拉包前测速）：
 
 ```bash
-pnpm dlx @ada-mcp/mcp-server@0.1.10
+pnpm dlx @ada-mcp/mcp-server@0.1.14
 # npx 等价：
-npx -y @ada-mcp/mcp-server@0.1.10
+npx -y @ada-mcp/mcp-server@0.1.14
 ```
 
 ## 启动时自动安装依赖（默认仅 Playwright）
@@ -83,27 +83,27 @@ npx -y @ada-mcp/mcp-server@0.1.10
 在标准 `args` 后追加，例如安装全部依赖：
 
 ```json
-"args": ["dlx", "@ada-mcp/launcher@0.1.7", "--install-deps=all"]
+"args": ["dlx", "@ada-mcp/launcher@0.1.11", "--install-deps=all"]
 ```
 
 ## Cursor MCP 配置
 
-**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.7`
+**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.11`
 
-**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.7`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
+**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.11`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
 
 ```json
 {
   "mcpServers": {
     "ada-mcp": {
       "command": "npx",
-      "args": ["-y", "@ada-mcp/launcher@0.1.7"]
+      "args": ["-y", "@ada-mcp/launcher@0.1.11"]
     }
   }
 }
 ```
 
-Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.10`（无 launcher 拉包测速）。
+Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.14`（无 launcher 拉包测速）。
 
 ## Remote mode
 

package/dist/cli.cjs

@@ -2728,16 +2728,16 @@ var init_src = __esm({
   }
 });
 
-// ../ada-agent/dist/bundled-config.generated.js
+// ../ada-agent/src/bundled-config.generated.ts
 var bundledDefaultConfigYaml;
 var init_bundled_config_generated = __esm({
-  "../ada-agent/dist/bundled-config.generated.js"() {
+  "../ada-agent/src/bundled-config.generated.ts"() {
     "use strict";
     bundledDefaultConfigYaml = 'agent:\r\n  id: "ada-agent-local"\r\n  mode: "foreground"\r\n  setupOnFirstRun: true\r\n\r\nbootstrapUI:\r\n  enabled: true\r\n  mode: "auto" # auto | cli | gui\r\n  host: "127.0.0.1"\r\n  port: 17650\r\n  autoOpenBrowser: true\r\n  sessionTtlSec: 600\r\n  secretsProvider: "auto" # auto | keychain | credman | file\r\n  native:\r\n    enabled: false\r\n    command: "" # e.g. ./bootstrap-ui / .\\bootstrap-ui.exe\r\n    args: []\r\n    timeoutMs: 120000\r\n    fallbackToWeb: true\r\n\r\ntransport:\r\n  mode: "auto"\r\n  streamProtocol: "websocket"\r\n  requestPath: "/api/v1/execute"\r\n  healthPath: "/health"\r\n  streamPath: "/ws"\r\n  requestTimeoutMs: 15000\r\n\r\ngraphics:\r\n  enabled: false\r\n  fallbackOnSemanticFailure: false\r\n  minConfidence: 0.8\r\n\r\nmonitoring:\r\n  enabled: false\r\n  platforms: ["web", "android", "ios", "harmony"] # \u53EF\u9009\u5B50\u96C6\r\n  sampleEvery: 1 # \u6BCF N \u6761\u64CD\u4F5C\u91C7\u6837\u4E00\u6B21\uFF0C1 \u8868\u793A\u5168\u91CF\r\n  outputDir: "artifacts/monitoring"\r\n  onFailureOnly: false # true \u65F6\u4EC5\u5931\u8D25\u64CD\u4F5C\u6293\u56FE\uFF0C\u6027\u80FD\u66F4\u4F18\r\n  groupBySession: true # \u6309 sessionId/requestId \u5206\u5C42\u5F52\u6863\r\n  nonBlocking: true # true \u65F6\u76D1\u63A7\u5F02\u6B65\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u94FE\u8DEF\r\n  resolution:\r\n    maxWidth: 1280\r\n    maxHeight: 720\r\n    keepAspectRatio: true # \u4FDD\u6301\u6BD4\u4F8B\uFF0C\u907F\u514D\u76D1\u63A7\u56FE\u50CF\u53D8\u5F62\r\n\r\nqueue:\r\n  inboxDir: "tasks/inbox"\r\n  processedDir: "tasks/processed"\r\n  failedDir: "tasks/failed"\r\n  pollIntervalMs: 3000\r\n  maxFileRetryAttempts: 2\r\n\r\ndependencies:\r\n  autoInstallOnStart: true\r\n  playwrightBrowser: "chromium" # chromium | firefox | webkit | all\r\n  playwrightInstallTargets: ["chromium"] # chromium | chrome | msedge | firefox | webkit | all\r\n  playwrightDownloadHost: "https://cdn.playwright.dev"\r\n  # \u56FD\u5185 npm \u955C\u50CF\uFF08\u6309\u4F18\u5148\u7EA7\uFF1Binstall-deps \u542F\u52A8\u65F6\u6D4B\u901F\u9009\u6700\u5FEB\uFF0C\u65E0\u9700\u7528\u6237\u914D\u7F6E\uFF09\r\n  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com" # \u963F\u91CC\u4E91 / npmmirror\uFF08\u63A8\u8350\uFF09\r\n    - "https://mirrors.cloud.tencent.com/npm" # \u817E\u8BAF\u4E91\r\n    - "https://repo.huaweicloud.com/repository/npm" # \u534E\u4E3A\u4E91\r\n    - "https://registry.npmjs.org" # \u5B98\u65B9\u515C\u5E95\r\n  playwrightHostCandidates:\r\n    - "https://cdn.playwright.dev"\r\n    - "https://playwright.azureedge.net"\r\n    - "https://npmmirror.com/mirrors/playwright"\r\n    - "https://cdn.npmmirror.com/binaries/playwright"\r\n  # \u539F\u751F WebDriver\uFF08geckodriver / chromedriver\uFF09\u7EDF\u4E00\u653E\u5728\u9879\u76EE dirver \u76EE\u5F55\r\n  nativeDriversDir: "dirver"\r\n  geckodriverVersion: "latest" # \u5982 0.36.0\uFF1Binstall-deps --only=selenium \u65F6\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\r\n  chromedriverVersion: "latest" # \u5982 137\u3001135\u3001match-chrome\uFF08\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C\uFF09\r\n\r\nappium:\r\n  serverUrl: "http://127.0.0.1:4723"\r\n  requiredDrivers: ["uiautomator2", "xcuitest", "harmonyos"]\r\n';
   }
 });
 
-// ../ada-agent/dist/config.js
+// ../ada-agent/src/config.ts
 function mergeConfig(base, overrides) {
   return {
     ...base,
@@ -2803,10 +2803,9 @@ function maskToken(token) {
 }
 var import_promises2, import_node_path2, DEFAULT_CONFIG_RELATIVE, LOCAL_DATA_DIR, EFFECTIVE_CONFIG_FILE, defaultConfig;
 var init_config = __esm({
-  "../ada-agent/dist/config.js"() {
-    "use strict";
-    import_promises2 = __toESM(require("node:fs/promises"), 1);
-    import_node_path2 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/config.ts"() {
+    import_promises2 = __toESM(require("node:fs/promises"));
+    import_node_path2 = __toESM(require("node:path"));
     init_js_yaml();
     init_src();
     init_bundled_config_generated();
@@ -2898,7 +2897,7 @@ var init_config = __esm({
   }
 });
 
-// ../ada-agent/dist/secrets.js
+// ../ada-agent/src/secrets.ts
 function resolveProvider(provider) {
   if (provider === "keychain" || provider === "credman") {
     return "file";
@@ -2930,23 +2929,21 @@ async function loadSecret(provider, cwd = process.cwd()) {
 }
 var import_promises3, import_node_path3, SECRET_FILE;
 var init_secrets = __esm({
-  "../ada-agent/dist/secrets.js"() {
-    "use strict";
-    import_promises3 = __toESM(require("node:fs/promises"), 1);
-    import_node_path3 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/secrets.ts"() {
+    import_promises3 = __toESM(require("node:fs/promises"));
+    import_node_path3 = __toESM(require("node:path"));
     init_config();
     SECRET_FILE = "secrets.json";
   }
 });
 
-// ../ada-agent/dist/logger.js
+// ../ada-agent/src/logger.ts
 function log(level, payload) {
   baseLog(level, payload);
 }
 var baseLog;
 var init_logger = __esm({
-  "../ada-agent/dist/logger.js"() {
-    "use strict";
+  "../ada-agent/src/logger.ts"() {
     init_src();
     baseLog = createJsonLogger("ada-agent");
   }
@@ -3471,7 +3468,7 @@ var init_src2 = __esm({
   }
 });
 
-// ../ada-agent/dist/dependency-installer.js
+// ../ada-agent/src/dependency-installer.ts
 function shouldUseShell(command) {
   if (process.platform !== "win32") {
     return false;
@@ -3673,13 +3670,19 @@ async function ensureNodeEnvironmentForInstall(onLogLine) {
     const nodeMajor = majorOf(nodeVersion.stdout);
     onLogLine?.(`[deps] Node \u7248\u672C\u68C0\u6D4B\uFF1A\u7CFB\u7EDF=${nodeVersion.stdout}\uFF0C\u5185\u7F6E=${runtimeNode}`);
     if (runtimeMajor !== null && nodeMajor !== null && nodeMajor > runtimeMajor) {
-      onLogLine?.(`[deps][warn] \u7CFB\u7EDF Node.js \u4E3B\u7248\u672C\uFF08${nodeMajor}\uFF09\u9AD8\u4E8E\u5185\u7F6E\u4E3B\u7248\u672C\uFF08${runtimeMajor}\uFF09\u3002\u5B89\u88C5\u5C06\u7EE7\u7EED\uFF0C\u8FD0\u884C\u65F6\u4EE5\u5185\u7F6E Node \u4E3A\u51C6\u3002`);
+      onLogLine?.(
+        `[deps][warn] \u7CFB\u7EDF Node.js \u4E3B\u7248\u672C\uFF08${nodeMajor}\uFF09\u9AD8\u4E8E\u5185\u7F6E\u4E3B\u7248\u672C\uFF08${runtimeMajor}\uFF09\u3002\u5B89\u88C5\u5C06\u7EE7\u7EED\uFF0C\u8FD0\u884C\u65F6\u4EE5\u5185\u7F6E Node \u4E3A\u51C6\u3002`
+      );
     }
     if (nodeMajor === null || nodeMajor < requiredNodeMajor) {
-      onLogLine?.(`[deps][warn] \u7CFB\u7EDF Node.js \u7248\u672C\u4E3A ${nodeVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNodeMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`);
+      onLogLine?.(
+        `[deps][warn] \u7CFB\u7EDF Node.js \u7248\u672C\u4E3A ${nodeVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNodeMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
+      );
     }
   } else {
-    onLogLine?.(`[deps][warn] \u672A\u4ECE PATH \u68C0\u6D4B\u5230 node\uFF0C\u5F53\u524D\u8FD0\u884C\u65F6 Node.js=${runtimeNode}\uFF08\u53EF\u6267\u884C\u7A0B\u5E8F\u5185\u7F6E\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`);
+    onLogLine?.(
+      `[deps][warn] \u672A\u4ECE PATH \u68C0\u6D4B\u5230 node\uFF0C\u5F53\u524D\u8FD0\u884C\u65F6 Node.js=${runtimeNode}\uFF08\u53EF\u6267\u884C\u7A0B\u5E8F\u5185\u7F6E\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
+    );
   }
   const npmVersion = await runCommandCapture("npm", ["-v"]);
   if (npmVersion.code !== 0) {
@@ -3690,7 +3693,9 @@ ${npmVersion.stderr || npmVersion.stdout}`.trim());
   }
   const npmMajor = majorOf(npmVersion.stdout);
   if (npmMajor === null || npmMajor < requiredNpmMajor) {
-    onLogLine?.(`[deps][warn] \u7CFB\u7EDF npm \u7248\u672C\u4E3A ${npmVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNpmMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`);
+    onLogLine?.(
+      `[deps][warn] \u7CFB\u7EDF npm \u7248\u672C\u4E3A ${npmVersion.stdout}\uFF08\u5EFA\u8BAE >= ${requiredNpmMajor}\uFF09\uFF0C\u7EE7\u7EED\u5C1D\u8BD5\u5B89\u88C5\u3002`
+    );
   }
 }
 function appiumDriverPackageName(driver) {
@@ -3814,18 +3819,19 @@ async function detectBestRegistry(config, baseProxy) {
     return cached;
   }
   progress("registry.probe.start", { candidates });
-  const probeResults = await Promise.all(candidates.map(async (candidate) => {
-    progress("registry.probe.try", { candidate });
-    const latency = await probeRegistryLatency(candidate);
-    progress("registry.probe.result", { candidate, latencyMs: latency });
-    return { candidate, latency };
-  }));
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => {
+      progress("registry.probe.try", { candidate });
+      const latency = await probeRegistryLatency(candidate);
+      progress("registry.probe.result", { candidate, latencyMs: latency });
+      return { candidate, latency };
+    })
+  );
   let best = candidates[0] ?? normalizeRegistryUrl(baseProxy);
   let bestLatency = Number.POSITIVE_INFINITY;
   let bestPriority = Number.POSITIVE_INFINITY;
   for (const { candidate, latency } of probeResults) {
-    if (latency === null)
-      continue;
+    if (latency === null) continue;
     const priority = registryPriorityIndex(candidates, candidate);
     if (latency < bestLatency || latency === bestLatency && priority < bestPriority) {
       best = candidate;
@@ -3910,20 +3916,22 @@ async function rankPlaywrightHosts(config) {
   const candidates = playwrightHostCandidates(config);
   const browserVersion = resolveChromiumBrowserVersion();
   progress("playwright.host.probe.start", { candidates, browserVersion: browserVersion || void 0 });
-  const probeResults = await Promise.all(candidates.map(async (candidate) => {
-    progress("playwright.host.probe.try", { candidate });
-    const artifactLatency = browserVersion ? await probePlaywrightBrowserArtifact(candidate, browserVersion) : null;
-    const rootLatency = await probePlaywrightHostLatency(candidate);
-    const latency = artifactLatency ?? rootLatency;
-    const artifactOk = artifactLatency !== null;
-    progress("playwright.host.probe.result", {
-      candidate,
-      latencyMs: latency,
-      artifactOk,
-      browserVersion: browserVersion || void 0
-    });
-    return { candidate, latency, artifactOk, priority: playwrightHostPriorityIndex(candidates, candidate) };
-  }));
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => {
+      progress("playwright.host.probe.try", { candidate });
+      const artifactLatency = browserVersion ? await probePlaywrightBrowserArtifact(candidate, browserVersion) : null;
+      const rootLatency = await probePlaywrightHostLatency(candidate);
+      const latency = artifactLatency ?? rootLatency;
+      const artifactOk = artifactLatency !== null;
+      progress("playwright.host.probe.result", {
+        candidate,
+        latencyMs: latency,
+        artifactOk,
+        browserVersion: browserVersion || void 0
+      });
+      return { candidate, latency, artifactOk, priority: playwrightHostPriorityIndex(candidates, candidate) };
+    })
+  );
   const reachable = probeResults.filter((x) => x.latency !== null);
   const withArtifact = reachable.filter((x) => x.artifactOk);
   const pool = withArtifact.length > 0 ? withArtifact : reachable;
@@ -3948,7 +3956,9 @@ async function runInstallWithPriority(config, packages, onLogLine) {
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
   const pnpmProxy = await detectBestRegistry(config, pnpmProxyRegistry());
   progress("packages.install.start", { packages, npmProxy, pnpmProxy });
-  onLogLine?.(`[deps] \u5728\u7EBF\u5B89\u88C5\u5305: ${packages.join(" ")} (registry \u63A2\u6D4B: npm=${npmProxy}, pnpm=${pnpmProxy}\uFF1B\u987A\u5E8F: pnpm -> pnpm-proxy -> npm -> npm-proxy)`);
+  onLogLine?.(
+    `[deps] \u5728\u7EBF\u5B89\u88C5\u5305: ${packages.join(" ")} (registry \u63A2\u6D4B: npm=${npmProxy}, pnpm=${pnpmProxy}\uFF1B\u987A\u5E8F: pnpm -> pnpm-proxy -> npm -> npm-proxy)`
+  );
   const strategies = [
     {
       name: "pnpm",
@@ -3995,7 +4005,9 @@ async function runInstallWithPriority(config, packages, onLogLine) {
       });
     }
   }
-  throw new Error(`Dependency install failed after all strategies: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  throw new Error(
+    `Dependency install failed after all strategies: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+  );
 }
 async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
@@ -4054,7 +4066,9 @@ async function runAppiumDriverInstallWithPriority(config, driver, onLogLine) {
       }
     }
   }
-  throw new Error(`Appium driver install failed after all strategies (${driver}): ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  throw new Error(
+    `Appium driver install failed after all strategies (${driver}): ${lastError instanceof Error ? lastError.message : String(lastError)}`
+  );
 }
 async function verifyPlaywrightSelfTest(onLogLine) {
   onLogLine?.("[playwright] \u81EA\u68C0\uFF1A\u542F\u52A8 Chromium \u7A7A\u767D\u9875");
@@ -4073,7 +4087,9 @@ async function installPlaywrightBrowser(config, onLogLine, options) {
   const rawTargets = playwrightInstallTargets(config);
   const targets = expandPlaywrightInstallTargets(rawTargets);
   if (rawTargets.length > 0 && targets.length > rawTargets.length) {
-    onLogLine?.("[playwright] \u914D\u7F6E\u4EC5\u542B chrome/msedge \u901A\u9053\uFF0C\u5DF2\u81EA\u52A8\u52A0\u5165 chromium\uFF08\u81EA\u68C0\u9700 Playwright \u5185\u7F6E\u6D4F\u89C8\u5668\uFF09");
+    onLogLine?.(
+      "[playwright] \u914D\u7F6E\u4EC5\u542B chrome/msedge \u901A\u9053\uFF0C\u5DF2\u81EA\u52A8\u52A0\u5165 chromium\uFF08\u81EA\u68C0\u9700 Playwright \u5185\u7F6E\u6D4F\u89C8\u5668\uFF09"
+    );
   }
   progress("playwright.browser.install.start", { targets: targets.length > 0 ? targets : ["all"] });
   onLogLine?.("[playwright] \u5F00\u59CB\u5728\u7EBF\u5B89\u88C5\u6D4F\u89C8\u5668");
@@ -4094,7 +4110,9 @@ async function installPlaywrightBrowser(config, onLogLine, options) {
     if (i > 0) {
       onLogLine?.(`[playwright] \u4E0A\u4E00\u955C\u50CF\u5931\u8D25\uFF0C\u6539\u8BD5 ${host}`);
     }
-    onLogLine?.(`[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${host}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`);
+    onLogLine?.(
+      `[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${host}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`
+    );
     try {
       await runCommand2(command, installArgs, {
         env: { PLAYWRIGHT_DOWNLOAD_HOST: host },
@@ -4208,7 +4226,10 @@ function configWithPlaywrightTargets(config, targets) {
 }
 async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
   const root = await resolveWorkspaceRoot2(process.cwd());
-  const driversDir = import_node_path5.default.resolve(root, options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver");
+  const driversDir = import_node_path5.default.resolve(
+    root,
+    options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver"
+  );
   const seleniumWebdriverInstalled = hasPackage("selenium-webdriver");
   if (seleniumWebdriverInstalled) {
     onLogLine?.("[selenium] npm \u5305 selenium-webdriver \u5DF2\u5B89\u88C5");
@@ -4219,9 +4240,13 @@ async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
   const chromeVer = options?.chromedriverVersion ?? config.dependencies.chromedriverVersion ?? "latest";
   try {
     const catalog = await listChromedriverCfTVersions();
-    onLogLine?.(`[selenium] \u53EF\u9009 chromedriver \u4E3B\u7248\u672C\uFF08chrome-for-testing\uFF09: ${catalog.slice(0, 12).map((x) => x.major).join(", ")}${catalog.length > 12 ? "\u2026" : ""}`);
+    onLogLine?.(
+      `[selenium] \u53EF\u9009 chromedriver \u4E3B\u7248\u672C\uFF08chrome-for-testing\uFF09: ${catalog.slice(0, 12).map((x) => x.major).join(", ")}${catalog.length > 12 ? "\u2026" : ""}`
+    );
   } catch (error) {
-    onLogLine?.(`[selenium] \u65E0\u6CD5\u62C9\u53D6 chromedriver \u7248\u672C\u5217\u8868: ${error instanceof Error ? error.message : String(error)}`);
+    onLogLine?.(
+      `[selenium] \u65E0\u6CD5\u62C9\u53D6 chromedriver \u7248\u672C\u5217\u8868: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
   const resolved = await ensureNativeWebDrivers({
     workspaceRoot: root,
@@ -4240,27 +4265,82 @@ async function ensureSeleniumNativeDrivers(config, options, onLogLine) {
     chromedriverPath: resolved.chromedriverPath
   };
 }
-async function prepareInstallHomes(onLogLine) {
+function installScopeNeedsMobileEnv(only) {
+  return only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
+}
+async function pathIsExistingDirectory(dirPath) {
+  try {
+    const stat = await import_promises5.default.stat(dirPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function prepareInstallHomes(onLogLine, options) {
   const root = await resolveWorkspaceRoot2(process.cwd());
-  const projectAndroidHome = import_node_path5.default.join(root, "android-sdk");
-  const projectAppiumHome = import_node_path5.default.join(root, "appium");
+  const projectAndroidHome = import_node_path5.default.join(root, "ANDROID_HOME");
+  const projectAppiumHome = import_node_path5.default.join(root, "APPIUM_HOME");
   const envAndroid = (process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? "").trim();
   const envAppium = (process.env.APPIUM_HOME ?? "").trim();
-  const androidHome = envAndroid || projectAndroidHome;
-  const appiumHome = envAppium || projectAppiumHome;
-  const usedProjectFallbackAndroid = !envAndroid;
-  const usedProjectFallbackAppium = !envAppium;
-  await import_promises5.default.mkdir(androidHome, { recursive: true });
-  await import_promises5.default.mkdir(appiumHome, { recursive: true });
+  const requireMobile = options?.requireMobileEnv === true;
+  let androidFromSystem = false;
+  let appiumFromSystem = false;
+  let androidHome = projectAndroidHome;
+  let appiumHome = projectAppiumHome;
+  if (envAndroid) {
+    if (await pathIsExistingDirectory(envAndroid)) {
+      androidFromSystem = true;
+      androidHome = envAndroid;
+      onLogLine?.(`[deps] \u4F7F\u7528\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF ANDROID_HOME=${envAndroid}`);
+    } else {
+      onLogLine?.(`[deps][warn] \u7CFB\u7EDF ANDROID_HOME / ANDROID_SDK_ROOT \u6307\u5411\u7684\u76EE\u5F55\u4E0D\u5B58\u5728: ${envAndroid}`);
+      onLogLine?.(`[deps][warn] \u8BF7\u4FEE\u6B63\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF\uFF0C\u6216\u5220\u9664\u9519\u8BEF\u914D\u7F6E\u540E\u91CD\u8BD5\u3002`);
+      onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAndroidHome}`);
+    }
+  } else {
+    onLogLine?.("[deps][warn] \u672A\u68C0\u6D4B\u5230\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF ANDROID_HOME \u6216 ANDROID_SDK_ROOT\u3002");
+    onLogLine?.(
+      "[deps][warn] \u8BF7\u5728\u7CFB\u7EDF/\u7EC8\u7AEF\u914D\u7F6E ANDROID_HOME\uFF08\u6307\u5411 Android SDK \u6839\u76EE\u5F55\uFF0C\u4E14\u5305\u542B platform-tools\uFF09\u3002"
+    );
+    onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAndroidHome}`);
+  }
+  if (envAppium) {
+    if (await pathIsExistingDirectory(envAppium)) {
+      appiumFromSystem = true;
+      appiumHome = envAppium;
+      onLogLine?.(`[deps] \u4F7F\u7528\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF APPIUM_HOME=${envAppium}`);
+    } else {
+      onLogLine?.(`[deps][warn] \u7CFB\u7EDF APPIUM_HOME \u6307\u5411\u7684\u76EE\u5F55\u4E0D\u5B58\u5728: ${envAppium}`);
+      onLogLine?.(`[deps][warn] \u8BF7\u4FEE\u6B63\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF\uFF0C\u6216\u5220\u9664\u9519\u8BEF\u914D\u7F6E\u540E\u91CD\u8BD5\u3002`);
+      onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAppiumHome}`);
+    }
+  } else {
+    onLogLine?.("[deps][warn] \u672A\u68C0\u6D4B\u5230\u7CFB\u7EDF\u73AF\u5883\u53D8\u91CF APPIUM_HOME\u3002");
+    onLogLine?.("[deps][warn] \u8BF7\u5728\u7CFB\u7EDF/\u7EC8\u7AEF\u914D\u7F6E APPIUM_HOME\uFF08Appium \u9A71\u52A8\u4E0E\u6269\u5C55\u7684\u5B89\u88C5\u76EE\u5F55\uFF09\u3002");
+    onLogLine?.(`[deps] \u5B89\u88C5\u8FC7\u7A0B\u5C06\u4F7F\u7528\u9879\u76EE\u9ED8\u8BA4\u76EE\u5F55: ${projectAppiumHome}`);
+  }
+  if (requireMobile && !androidFromSystem && !appiumFromSystem) {
+    onLogLine?.(
+      "[deps][warn] \u5F53\u524D\u5B89\u88C5\u5305\u542B Appium/\u79FB\u52A8\u7AEF\u80FD\u529B\uFF0C\u5EFA\u8BAE\u5728\u5B8C\u6210 install-deps \u524D\u914D\u7F6E\u7CFB\u7EDF ANDROID_HOME \u4E0E APPIUM_HOME\u3002"
+    );
+  }
+  await import_promises5.default.mkdir(projectAndroidHome, { recursive: true });
+  await import_promises5.default.mkdir(projectAppiumHome, { recursive: true });
+  if (androidHome !== projectAndroidHome) {
+    await import_promises5.default.mkdir(androidHome, { recursive: true }).catch(() => void 0);
+  }
+  if (appiumHome !== projectAppiumHome) {
+    await import_promises5.default.mkdir(appiumHome, { recursive: true }).catch(() => void 0);
+  }
   process.env.ANDROID_HOME = androidHome;
   process.env.ANDROID_SDK_ROOT = androidHome;
   process.env.APPIUM_HOME = appiumHome;
-  onLogLine?.(`[deps] \u73AF\u5883\u76EE\u5F55: ANDROID_HOME=${androidHome} APPIUM_HOME=${appiumHome}` + (usedProjectFallbackAndroid || usedProjectFallbackAppium ? "\uFF08\u5DF2\u4F7F\u7528\u9879\u76EE\u76EE\u5F55\u515C\u5E95\uFF09" : ""));
+  onLogLine?.(`[deps] \u73AF\u5883\u76EE\u5F55: ANDROID_HOME=${androidHome} APPIUM_HOME=${appiumHome}`);
   return {
     androidHome,
     appiumHome,
-    usedProjectFallbackAndroid,
-    usedProjectFallbackAppium
+    androidFromSystem,
+    appiumFromSystem
   };
 }
 function resolveRequestedDrivers(config, only) {
@@ -4303,14 +4383,16 @@ async function ensureDriverDependencies(config, options) {
   const pwOverride = filterPlaywrightTargetsOverride(options?.playwrightInstallTargetsOverride);
   const configForPlaywright = pwOverride?.length ? configWithPlaywrightTargets(config, pwOverride) : config;
   const state = await loadInstallState();
-  const homes = await prepareInstallHomes(onLogLine);
+  const needPlaywright = only === "all" || only === "playwright";
+  const needSelenium = only === "all" || only === "selenium";
+  const needAppium = only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
+  const homes = await prepareInstallHomes(onLogLine, {
+    requireMobileEnv: installScopeNeedsMobileEnv(only)
+  });
   progress("deps.ensure.start");
   onLogLine?.("[deps] \u5F00\u59CB\u68C0\u6D4B / \u5B89\u88C5\u4F9D\u8D56\u2026");
   await ensureNodeEnvironmentForInstall(onLogLine);
   const missing = [];
-  const needPlaywright = only === "all" || only === "playwright";
-  const needSelenium = only === "all" || only === "selenium";
-  const needAppium = only === "all" || only === "appium" || only === "drivers" || only === "mobile" || only === "android" || only === "ios" || only === "harmony";
   const requestedDrivers = options?.appiumRequiredDriversOverride !== void 0 ? normalizeAppiumDriverTokens(options.appiumRequiredDriversOverride) : resolveRequestedDrivers(config, only);
   const needDrivers = requestedDrivers.length > 0;
   const installedPackages = [];
@@ -4356,7 +4438,9 @@ async function ensureDriverDependencies(config, options) {
         }
       });
       if (force) {
-        onLogLine?.(userRequestedBrowserTargets ? "[playwright] --force\uFF1A\u91CD\u65B0\u5B89\u88C5\u5F53\u524D\u52FE\u9009\u7684\u6D4F\u89C8\u5668\u901A\u9053" : "[playwright] --force\uFF1A\u6309\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684\u76EE\u6807\u91CD\u65B0\u5B89\u88C5\u6D4F\u89C8\u5668");
+        onLogLine?.(
+          userRequestedBrowserTargets ? "[playwright] --force\uFF1A\u91CD\u65B0\u5B89\u88C5\u5F53\u524D\u52FE\u9009\u7684\u6D4F\u89C8\u5668\u901A\u9053" : "[playwright] --force\uFF1A\u6309\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684\u76EE\u6807\u91CD\u65B0\u5B89\u88C5\u6D4F\u89C8\u5668"
+        );
       }
       await installPlaywrightBrowser(configForPlaywright, onLogLine, {
         force: force || reinstallForTargets || !launchOk
@@ -4428,7 +4512,10 @@ async function ensureDriverDependencies(config, options) {
   let availableChromedriverMajors;
   if (needSelenium) {
     const root = await resolveWorkspaceRoot2(process.cwd());
-    nativeDriversDir = import_node_path5.default.resolve(root, options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver");
+    nativeDriversDir = import_node_path5.default.resolve(
+      root,
+      options?.nativeDriversDir ?? config.dependencies.nativeDriversDir ?? "dirver"
+    );
     availableChromedriverMajors = await listLocalChromedriverVersions(nativeDriversDir);
     const resolved = await resolveNativeDrivers({
       workspaceRoot: root,
@@ -4503,13 +4590,12 @@ async function getDependencyHealth(config) {
 }
 var import_node_module, import_node_fs, import_node_child_process2, import_promises5, import_node_path5, require2, DEFAULT_NPM_REGISTRY_CANDIDATES, detectedBestRegistryByKey, PROGRESS_STEPS, DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, PLAYWRIGHT_HOST_FALLBACK, PW_INSTALL_TARGETS;
 var init_dependency_installer = __esm({
-  "../ada-agent/dist/dependency-installer.js"() {
-    "use strict";
+  "../ada-agent/src/dependency-installer.ts"() {
     import_node_module = require("node:module");
     import_node_fs = require("node:fs");
     import_node_child_process2 = require("node:child_process");
-    import_promises5 = __toESM(require("node:fs/promises"), 1);
-    import_node_path5 = __toESM(require("node:path"), 1);
+    import_promises5 = __toESM(require("node:fs/promises"));
+    import_node_path5 = __toESM(require("node:path"));
     init_logger();
     init_config();
     init_src2();
@@ -4780,7 +4866,7 @@ var init_src4 = __esm({
   }
 });
 
-// ../ada-agent/dist/plugin-registry.js
+// ../ada-agent/src/plugin-registry.ts
 function buildPluginHost() {
   const host = new PluginHost();
   registerRuntimePlugins(host);
@@ -4791,13 +4877,12 @@ function listBuiltInPluginManifests() {
   return registerRuntimePlugins(host);
 }
 var init_plugin_registry = __esm({
-  "../ada-agent/dist/plugin-registry.js"() {
-    "use strict";
+  "../ada-agent/src/plugin-registry.ts"() {
     init_src4();
   }
 });
 
-// ../ada-agent/dist/doctor.js
+// ../ada-agent/src/doctor.ts
 async function dirExists2(dirPath) {
   try {
     const stat = await import_promises6.default.stat(dirPath);
@@ -4974,11 +5059,10 @@ async function checkAppiumServer(serverUrl) {
 }
 var import_promises6, import_node_net, import_node_path7, import_node_url, import_node_child_process3;
 var init_doctor = __esm({
-  "../ada-agent/dist/doctor.js"() {
-    "use strict";
-    import_promises6 = __toESM(require("node:fs/promises"), 1);
-    import_node_net = __toESM(require("node:net"), 1);
-    import_node_path7 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/doctor.ts"() {
+    import_promises6 = __toESM(require("node:fs/promises"));
+    import_node_net = __toESM(require("node:net"));
+    import_node_path7 = __toESM(require("node:path"));
     import_node_url = require("node:url");
     import_node_child_process3 = require("node:child_process");
     init_dependency_installer();
@@ -4987,7 +5071,7 @@ var init_doctor = __esm({
   }
 });
 
-// ../ada-agent/dist/setup-cli.js
+// ../ada-agent/src/setup-cli.ts
 function parseTags(raw) {
   return raw.split(",").map((s) => s.trim()).filter(Boolean);
 }
@@ -5001,7 +5085,9 @@ async function runSetupCli() {
   const rl = import_promises7.default.createInterface({ input: import_node_process.stdin, output: import_node_process.stdout });
   try {
     console.log("[ADA-AGENT] setup wizard (CLI mode)");
-    const serverUrl = ensureServerUrl((await rl.question("Server URL (e.g. https://ada-control.example.com): ")).trim());
+    const serverUrl = ensureServerUrl(
+      (await rl.question("Server URL (e.g. https://ada-control.example.com): ")).trim()
+    );
     const tenant = (await rl.question("Tenant [default]: ")).trim() || "default";
     const environment = (await rl.question("Environment [prod]: ")).trim() || "prod";
     const authTypeInput = (await rl.question("Auth type [token/device_code] (default token): ")).trim();
@@ -5030,14 +5116,13 @@ async function runSetupCli() {
 }
 var import_promises7, import_node_process;
 var init_setup_cli = __esm({
-  "../ada-agent/dist/setup-cli.js"() {
-    "use strict";
-    import_promises7 = __toESM(require("node:readline/promises"), 1);
+  "../ada-agent/src/setup-cli.ts"() {
+    import_promises7 = __toESM(require("node:readline/promises"));
     import_node_process = require("node:process");
   }
 });
 
-// ../ada-agent/dist/setup-native.js
+// ../ada-agent/src/setup-native.ts
 function normalizeOutput(raw) {
   const parsed = JSON.parse(raw);
   if (!parsed.serverUrl || !parsed.tenant || !parsed.environment) {
@@ -5100,13 +5185,12 @@ async function runSetupNative(config) {
 }
 var import_node_child_process4;
 var init_setup_native = __esm({
-  "../ada-agent/dist/setup-native.js"() {
-    "use strict";
+  "../ada-agent/src/setup-native.ts"() {
     import_node_child_process4 = require("node:child_process");
   }
 });
 
-// ../ada-agent/dist/setup-state.js
+// ../ada-agent/src/setup-state.ts
 function normalizePlaywrightTargets(raw) {
   const list = (raw ?? []).map((x) => String(x).toLowerCase().trim()).filter((x) => PW_TARGET.has(x));
   if (list.includes("all")) {
@@ -5174,8 +5258,7 @@ async function persistAgentSetup(config, input2) {
 }
 var PW_TARGET;
 var init_setup_state = __esm({
-  "../ada-agent/dist/setup-state.js"() {
-    "use strict";
+  "../ada-agent/src/setup-state.ts"() {
     init_config();
     init_secrets();
     PW_TARGET = /* @__PURE__ */ new Set([
@@ -5189,7 +5272,7 @@ var init_setup_state = __esm({
   }
 });
 
-// ../ada-agent/dist/bootstrap-ui.js
+// ../ada-agent/src/bootstrap-ui.ts
 function parseDependencyInstallScope(value) {
   if (value === "all" || value === "playwright" || value === "mobile" || value === "android" || value === "ios" || value === "harmony" || value === "appium" || value === "drivers") {
     return value;
@@ -5575,7 +5658,10 @@ async function runSetupUi(config) {
             try {
               saved = await persistAgentSetup(config, payload);
             } catch (error) {
-              abortSetup(500, error instanceof Error ? error.message : String(error));
+              abortSetup(
+                500,
+                error instanceof Error ? error.message : String(error)
+              );
               return;
             }
             res.writeHead(200, {
@@ -5682,9 +5768,8 @@ async function openBrowser(url) {
 }
 var import_node_http, import_node_crypto, import_node_url2;
 var init_bootstrap_ui = __esm({
-  "../ada-agent/dist/bootstrap-ui.js"() {
-    "use strict";
-    import_node_http = __toESM(require("node:http"), 1);
+  "../ada-agent/src/bootstrap-ui.ts"() {
+    import_node_http = __toESM(require("node:http"));
     import_node_crypto = require("node:crypto");
     import_node_url2 = require("node:url");
     init_setup_state();
@@ -5888,7 +5973,7 @@ var init_src6 = __esm({
   }
 });
 
-// ../ada-agent/dist/transport-client.js
+// ../ada-agent/src/transport-client.ts
 function joinUrl(base, suffix) {
   const normalizedBase = base.replace(/\/$/, "");
   if (!suffix.startsWith("/")) {
@@ -5986,14 +6071,11 @@ async function createRuntimeTransport(config, secret) {
 }
 var TransportExecutor;
 var init_transport_client = __esm({
-  "../ada-agent/dist/transport-client.js"() {
-    "use strict";
+  "../ada-agent/src/transport-client.ts"() {
     init_src5();
     init_src6();
     init_logger();
     TransportExecutor = class {
-      transport;
-      mode;
       constructor(transport, mode) {
         this.transport = transport;
         this.mode = mode;
@@ -6024,7 +6106,7 @@ var init_transport_client = __esm({
   }
 });
 
-// ../ada-agent/dist/task-loader.js
+// ../ada-agent/src/task-loader.ts
 function isObject3(value) {
   return typeof value === "object" && value !== null;
 }
@@ -6064,9 +6146,8 @@ async function loadTaskFile(filePath) {
 }
 var import_promises8, allowedCommands;
 var init_task_loader = __esm({
-  "../ada-agent/dist/task-loader.js"() {
-    "use strict";
-    import_promises8 = __toESM(require("node:fs/promises"), 1);
+  "../ada-agent/src/task-loader.ts"() {
+    import_promises8 = __toESM(require("node:fs/promises"));
     allowedCommands = /* @__PURE__ */ new Set([
       "click",
       "type",
@@ -6347,7 +6428,7 @@ var init_src7 = __esm({
   }
 });
 
-// ../ada-agent/dist/monitoring.js
+// ../ada-agent/src/monitoring.ts
 function shouldMonitorCommand(command, config, index) {
   if (!config.monitoring.enabled) {
     return false;
@@ -6440,7 +6521,7 @@ async function captureOperationMonitor(command, result, index, context) {
 }
 var import_promises9, import_node_path8, import_jimp;
 var init_monitoring = __esm({
-  "../ada-agent/dist/monitoring.js"() {
+  "../ada-agent/src/monitoring.ts"() {
     "use strict";
     import_promises9 = __toESM(require("node:fs/promises"), 1);
     import_node_path8 = __toESM(require("node:path"), 1);
@@ -6449,7 +6530,7 @@ var init_monitoring = __esm({
   }
 });
 
-// ../ada-agent/dist/runtime.js
+// ../ada-agent/src/runtime.ts
 async function runTaskset(commands, options = {}) {
   const executor = new TaskExecutor(buildPluginHost());
   const results = [];
@@ -6466,12 +6547,14 @@ async function runTaskset(commands, options = {}) {
         executeLocal
       });
       if (options.config.monitoring.nonBlocking) {
-        monitorJobs.push(monitorJob.catch((error) => {
-          log("warn", {
-            event: "monitor.capture.unhandled",
-            details: { requestId: cmd.requestId, message: error instanceof Error ? error.message : String(error) }
-          });
-        }));
+        monitorJobs.push(
+          monitorJob.catch((error) => {
+            log("warn", {
+              event: "monitor.capture.unhandled",
+              details: { requestId: cmd.requestId, message: error instanceof Error ? error.message : String(error) }
+            });
+          })
+        );
       } else {
         await monitorJob;
       }
@@ -6483,22 +6566,25 @@ async function runTaskset(commands, options = {}) {
   return results;
 }
 async function runDemoTaskset(options = {}) {
-  await runTaskset([
-    {
-      requestId: "req-web-1",
-      sessionId: "session-web",
-      platform: "web",
-      command: "click",
-      payload: { locator: { testId: "login-btn" } }
-    },
-    {
-      requestId: "req-ios-1",
-      sessionId: "session-ios",
-      platform: "ios",
-      command: "swipe",
-      payload: { from: [0.5, 0.8], to: [0.5, 0.2] }
-    }
-  ], options);
+  await runTaskset(
+    [
+      {
+        requestId: "req-web-1",
+        sessionId: "session-web",
+        platform: "web",
+        command: "click",
+        payload: { locator: { testId: "login-btn" } }
+      },
+      {
+        requestId: "req-ios-1",
+        sessionId: "session-ios",
+        platform: "ios",
+        command: "swipe",
+        payload: { from: [0.5, 0.8], to: [0.5, 0.2] }
+      }
+    ],
+    options
+  );
 }
 async function runForegroundLoop(skipDemo = false, options = {}) {
   log("info", { event: "agent.runtime.ready", details: { mode: "foreground" } });
@@ -6508,8 +6594,7 @@ async function runForegroundLoop(skipDemo = false, options = {}) {
   await runDemoTaskset(options);
 }
 var init_runtime = __esm({
-  "../ada-agent/dist/runtime.js"() {
-    "use strict";
+  "../ada-agent/src/runtime.ts"() {
     init_src7();
     init_plugin_registry();
     init_logger();
@@ -6517,7 +6602,7 @@ var init_runtime = __esm({
   }
 });
 
-// ../ada-agent/dist/queue-runner.js
+// ../ada-agent/src/queue-runner.ts
 async function ensureDirs(config) {
   await import_promises10.default.mkdir(config.queue.inboxDir, { recursive: true });
   await import_promises10.default.mkdir(config.queue.processedDir, { recursive: true });
@@ -6612,10 +6697,9 @@ async function watchQueue(config, shouldStop, options = {}) {
 }
 var import_promises10, import_node_path9;
 var init_queue_runner = __esm({
-  "../ada-agent/dist/queue-runner.js"() {
-    "use strict";
-    import_promises10 = __toESM(require("node:fs/promises"), 1);
-    import_node_path9 = __toESM(require("node:path"), 1);
+  "../ada-agent/src/queue-runner.ts"() {
+    import_promises10 = __toESM(require("node:fs/promises"));
+    import_node_path9 = __toESM(require("node:path"));
     init_task_loader();
     init_runtime();
     init_logger();
@@ -7092,10 +7176,13 @@ function resolveAndroidSdkRoot() {
   });
   const adbPath = (adbLookup.stdout ?? "").split(/\r?\n/).map((line) => line.trim()).find(Boolean);
   const adbSdkRoot = adbPath ? import_node_path14.default.dirname(import_node_path14.default.dirname(adbPath)) : null;
+  const workspaceRoot = process.cwd();
+  const projectAndroidHome = import_node_path14.default.join(workspaceRoot, "ANDROID_HOME");
   const candidates = [
     process.env.ANDROID_SDK_ROOT,
     process.env.ANDROID_HOME,
     persisted.androidHome,
+    (0, import_node_fs5.existsSync)(projectAndroidHome) ? projectAndroidHome : null,
     adbSdkRoot,
     process.env.LOCALAPPDATA ? import_node_path14.default.join(process.env.LOCALAPPDATA, "Android", "Sdk") : null,
     process.env.USERPROFILE ? import_node_path14.default.join(process.env.USERPROFILE, "AppData", "Local", "Android", "Sdk") : null
@@ -7128,10 +7215,11 @@ function hasAppiumDriver(homeDir, driverName) {
 }
 function resolveAppiumHome(platform) {
   const persisted = loadPersistedHomes();
+  const projectAppiumHome = import_node_path14.default.join(process.cwd(), "APPIUM_HOME");
   const candidates = [
     process.env.APPIUM_HOME,
     persisted.appiumHome,
-    process.cwd(),
+    (0, import_node_fs5.existsSync)(projectAppiumHome) ? projectAppiumHome : null,
     process.env.USERPROFILE,
     process.env.USERPROFILE ? import_node_path14.default.join(process.env.USERPROFILE, ".appium") : null
   ].map((v) => typeof v === "string" ? v.trim() : "").filter(Boolean);

package/package.json

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