@validate.qa/runner 1.0.8 → 1.0.12

package/dist/cli.js

@@ -263,14 +263,16 @@ var require_ai_provider = __commonJS({
       { id: "minimax-m2.7", label: "MiniMax M2.7", provider: "minimax", description: "Fast M2.7 tier (Highspeed); auto-fails over to standard M2.7, ~200K ctx", contextWindow: 2e5 },
       { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", provider: "anthropic", description: "Anthropic - fast & intelligent, 200k ctx", contextWindow: 2e5 },
       { id: "nvidia-nemotron-nano", label: "NVIDIA Nemotron Nano", provider: "nvidia", description: "NVIDIA NIM - Nemotron 30B Nano, reasoning model, 128k ctx", contextWindow: 128e3 },
-      { id: "nvidia-kimi-k2.6", label: "NVIDIA Kimi K2.6", provider: "nvidia", description: "NVIDIA NIM - Moonshot Kimi K2.6, multimodal coding and agentic model, 256k ctx", contextWindow: 256e3 }
+      { id: "nvidia-kimi-k2.6", label: "NVIDIA Kimi K2.6", provider: "nvidia", description: "NVIDIA NIM - Moonshot Kimi K2.6, multimodal coding and agentic model, 256k ctx", contextWindow: 256e3 },
+      { id: "deepseek-v4-flash", label: "DeepSeek V4 Flash", provider: "deepseek", description: "DeepSeek - V4 Flash, OpenAI-compatible, 1M ctx", contextWindow: 1e6 }
     ];
     var PROVIDER_DEFAULT_MODEL = {
       openai: "gpt-4o",
       xai: "grok-build-0.1",
       anthropic: "claude-sonnet-4-6",
       minimax: "minimax-m3",
-      nvidia: "nvidia-nemotron-nano"
+      nvidia: "nvidia-nemotron-nano",
+      deepseek: "deepseek-v4-flash"
     };
     function getContextConfig(modelId) {
       const info = exports2.AI_MODEL_CATALOG.find((m) => m.id === modelId);
@@ -321,7 +323,8 @@ var require_ai_provider = __commonJS({
       "minimax-m2.7-highspeed": { strong: "MiniMax-M2.7-highspeed", fast: "MiniMax-M2.7-highspeed", agent: "MiniMax-M2.7-highspeed" },
       "claude-sonnet-4-6": { strong: "claude-sonnet-4-6", fast: "claude-sonnet-4-6", agent: "claude-sonnet-4-6" },
       "nvidia-nemotron-nano": { strong: "nvidia/nemotron-3-nano-30b-a3b", fast: "nvidia/nemotron-3-nano-30b-a3b", agent: "nvidia/nemotron-3-nano-30b-a3b" },
-      "nvidia-kimi-k2.6": { strong: "moonshotai/kimi-k2.6", fast: "moonshotai/kimi-k2.6", agent: "moonshotai/kimi-k2.6" }
+      "nvidia-kimi-k2.6": { strong: "moonshotai/kimi-k2.6", fast: "moonshotai/kimi-k2.6", agent: "moonshotai/kimi-k2.6" },
+      "deepseek-v4-flash": { strong: "deepseek-v4-flash", fast: "deepseek-v4-flash", agent: "deepseek-v4-flash" }
     };
     var _requestModelStorage = new async_hooks_1.AsyncLocalStorage();
     function withModelContext(modelId, fn) {
@@ -383,6 +386,9 @@ var require_ai_provider = __commonJS({
       if (modelId === "nvidia/nemotron-3-nano-30b-a3b") {
         return { chat_template_kwargs: { enable_thinking: false } };
       }
+      if (modelId === "deepseek-v4-flash") {
+        return { thinking: { type: "disabled" } };
+      }
       return {};
     }
     exports2.MINIMAX_FALLBACK_CHAIN = ["MiniMax-M3", "MiniMax-M2.7-highspeed", "MiniMax-M2.7"];
@@ -484,6 +490,11 @@ var require_ai_provider = __commonJS({
         if (!apiKey)
           throw new Error("NVIDIA_API_KEY is required when using an NVIDIA model");
         client = new openai_1.default({ apiKey, baseURL: process.env.NVIDIA_API_BASE ?? "https://integrate.api.nvidia.com/v1" });
+      } else if (provider === "deepseek") {
+        const apiKey = process.env.DEEPSEEK_API_KEY;
+        if (!apiKey)
+          throw new Error("DEEPSEEK_API_KEY is required when using a DeepSeek model");
+        client = new openai_1.default({ apiKey, baseURL: process.env.DEEPSEEK_API_BASE ?? "https://api.deepseek.com" });
       } else {
         const apiKey = process.env.OPENAI_API_KEY;
         if (!apiKey)
@@ -517,6 +528,8 @@ var require_ai_provider = __commonJS({
         return !!process.env.ANTHROPIC_API_KEY?.trim();
       if (provider === "nvidia")
         return !!process.env.NVIDIA_API_KEY?.trim();
+      if (provider === "deepseek")
+        return !!process.env.DEEPSEEK_API_KEY?.trim();
       return false;
     }
     function getAvailableModels() {
@@ -1544,6 +1557,21 @@ function buildAppiumCode(testName, target, steps) {
     `    await driver.keys(text);`,
     `  }`,
     `}`,
+    ``,
+    `async function __textCandidates(el: WebdriverIO.Element) {`,
+    `  const __values: string[] = [];`,
+    `  const __push = (__value: unknown) => {`,
+    `    if (typeof __value !== 'string') return;`,
+    `    const __trimmed = __value.trim();`,
+    `    if (__trimmed.length === 0 || __values.includes(__trimmed)) return;`,
+    `    __values.push(__trimmed);`,
+    `  };`,
+    `  __push(await el.getText().catch(() => ''));`,
+    `  for (const __attr of ['text', 'content-desc', 'contentDescription', 'name', 'label', 'value']) {`,
+    `    __push(await el.getAttribute(__attr).catch(() => ''));`,
+    `  }`,
+    `  return __values;`,
+    `}`,
     ...hasSwipe ? [
       ``,
       `// Read the device window with a few retries (matches the runtime executor).`,
@@ -1630,8 +1658,8 @@ function buildAppiumCode(testName, target, steps) {
     } else if (step.action === "assertText" && hasSelector) {
       lines.push(`    {`);
       lines.push(`      const __expected = ${toJsStringLiteral(step.assertion ?? "")};`);
-      lines.push(`      const __actual = await (await findFirst(driver, ${candidatesLiteral})).getText();`);
-      lines.push(`      if (!__actual.includes(__expected)) {`);
+      lines.push(`      const __actual = await __textCandidates(await findFirst(driver, ${candidatesLiteral}));`);
+      lines.push(`      if (!__actual.some((__value) => __value.includes(__expected))) {`);
       lines.push(`        throw new Error('Assertion failed: expected text to contain ' + JSON.stringify(__expected) + ' but got ' + JSON.stringify(__actual));`);
       lines.push(`      }`);
       lines.push(`    }`);
@@ -12038,7 +12066,7 @@ var require_kill_tree = __commonJS({
     var node_child_process_1 = require("child_process");
     var node_util_1 = require("util");
     var node_fs_1 = require("fs");
-    var execFileAsync2 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var PS_TIMEOUT_MS = 2e3;
     var PS_BUFFER = 1024 * 1024;
     async function gracefulCloseWithTreeKill(options) {
@@ -12092,7 +12120,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -12130,7 +12158,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -12207,7 +12235,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -311576,6 +311604,13 @@ var require_mobile_discovery_agent = __commonJS({
     var mobile_generator_js_1 = require_mobile_generator();
     var mobile_exploration_state_js_1 = require_mobile_exploration_state();
     var discover_planner_js_1 = require_discover_planner();
+    function checkpointErrorMessage(err) {
+      return err instanceof Error ? err.message : String(err);
+    }
+    function isTerminalDiscoveryCheckpointError(err) {
+      const message = checkpointErrorMessage(err);
+      return /Discovery plan checkpoint rejected|Discovery run is .*not RUNNING|not RUNNING|cancelled/i.test(message);
+    }
     var EXPLORE_BUDGET_DEEP = 60;
     var EXPLORE_BUDGET_SURVEY = 40;
     function platformForMedium(medium) {
@@ -311706,14 +311741,22 @@ Plan: ${planResult.scenarios.length} scenarios, ${planResult.featureGroups.lengt
         const plans = toPlans(scenarios);
         const coverageGaps = planResult.coverageGaps && planResult.coverageGaps.length > 0 ? planResult.coverageGaps : void 0;
         if (callbacks?.onPlanReady) {
-          await callbacks.onPlanReady({
-            scenarios,
-            featureGroups,
-            fallbackUsed: planResult.fallbackUsed ?? false,
-            fallbackReason: planResult.fallbackReason
-          }).then(() => log2("Plan checkpoint: scenario plan POSTed to server")).catch((err) => {
-            log2(`Plan checkpoint POST failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
-          });
+          try {
+            await callbacks.onPlanReady({
+              scenarios,
+              featureGroups,
+              fallbackUsed: planResult.fallbackUsed ?? false,
+              fallbackReason: planResult.fallbackReason
+            });
+            log2("Plan checkpoint: scenario plan POSTed to server");
+          } catch (err) {
+            const message = checkpointErrorMessage(err);
+            if (isTerminalDiscoveryCheckpointError(err)) {
+              log2(`Plan checkpoint rejected for inactive discovery run: ${message}`);
+              throw err;
+            }
+            log2(`Plan checkpoint POST failed (non-fatal): ${message}`);
+          }
         }
         if (isSurvey) {
           const duration2 = (Date.now() - startTime) / 1e3;
@@ -321095,7 +321138,7 @@ var require_update = __commonJS({
 var require_opts_arg = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/opts-arg.js"(exports2, module2) {
     "use strict";
-    var { promisify: promisify2 } = require("util");
+    var { promisify: promisify3 } = require("util");
     var fs = require("fs");
     var optsArg = (opts) => {
       if (!opts)
@@ -321109,9 +321152,9 @@ var require_opts_arg = __commonJS({
       else
         throw new TypeError("invalid options argument");
       opts.mkdir = opts.mkdir || opts.fs.mkdir || fs.mkdir;
-      opts.mkdirAsync = promisify2(opts.mkdir);
+      opts.mkdirAsync = promisify3(opts.mkdir);
       opts.stat = opts.stat || opts.fs.stat || fs.stat;
-      opts.statAsync = promisify2(opts.stat);
+      opts.statAsync = promisify3(opts.stat);
       opts.statSync = opts.statSync || opts.fs.statSync || fs.statSync;
       opts.mkdirSync = opts.mkdirSync || opts.fs.mkdirSync || fs.mkdirSync;
       return opts;
@@ -325204,7 +325247,7 @@ var require_process_inventory = __commonJS({
     var node_child_process_1 = require("child_process");
     var node_os_1 = __importDefault(require("os"));
     var node_util_1 = require("util");
-    var execFileAsync2 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var DEFAULT_LIMIT = 60;
     var DEFAULT_TIMEOUT_MS = 800;
     var MAX_COMMAND_LENGTH = 320;
@@ -325266,7 +325309,7 @@ var require_process_inventory = __commonJS({
       const timer = setTimeout(() => controller.abort(), timeoutMs);
       timer.unref?.();
       try {
-        const { stdout } = await execFileAsync2(command, args, {
+        const { stdout } = await execFileAsync3(command, args, {
           maxBuffer: 1024 * 1024,
           signal: controller.signal
         });
@@ -326288,7 +326331,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.8",
+      version: "1.0.12",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -326421,6 +326464,8 @@ function shouldUseAuthState(tags, playwrightCode) {
 
 // src/services/appium-executor.ts
 init_dist();
+var import_node_child_process2 = require("child_process");
+var import_node_util2 = require("util");
 var import_runner_core8 = __toESM(require_dist2());
 
 // src/services/appium-lifecycle.ts
@@ -327601,6 +327646,8 @@ async function startMobileNetworkCapture(options) {
 
 // src/services/appium-executor.ts
 var DEFAULT_STEP_TIMEOUT_MS = 1e4;
+var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
+var MOBILE_TEXT_ATTRIBUTE_NAMES = ["text", "content-desc", "contentDescription", "name", "label", "value"];
 var WebDriverTransportError = class extends Error {
   isTransport = true;
   constructor(message) {
@@ -327922,6 +327969,18 @@ async function sendKeysToFocusedInput(sessionId, value) {
     body: JSON.stringify({ text: value, value: Array.from(value) })
   });
 }
+function encodeAndroidInputText(value) {
+  return value.replace(/%/g, "%25").replace(/\s/g, "%s");
+}
+async function sendAndroidTextToFocusedInput(deviceId, value) {
+  if (!deviceId) {
+    throw new Error("Android keyboard fallback requires a device id");
+  }
+  await execFileAsync2("adb", ["-s", deviceId, "shell", "input", "text", encodeAndroidInputText(value)], {
+    timeout: 1e4,
+    windowsHide: true
+  });
+}
 async function trySendElementValue(sessionId, elementId, value) {
   try {
     await wdRequest(`/session/${sessionId}/element/${elementId}/value`, {
@@ -327970,7 +328029,7 @@ async function executeTap(sessionId, step) {
   }
   await tapCoordinates(sessionId, bounds);
 }
-async function executeType(sessionId, step) {
+async function executeType(sessionId, step, context) {
   if (step.value === void 0 || step.value === null || step.value === "") return;
   const value = String(step.value);
   const bounds = boundsFromStep(step);
@@ -328019,6 +328078,7 @@ async function executeType(sessionId, step) {
   if (bounds) {
     if (!tappedBounds) {
       await tapCoordinates(sessionId, bounds);
+      tappedBounds = true;
       await new Promise((resolve) => setTimeout(resolve, MOBILE_FOCUS_SETTLE_MS));
     }
     try {
@@ -328029,6 +328089,17 @@ async function executeType(sessionId, step) {
       lastInputError = error2;
     }
   }
+  if (context.platform === "ANDROID" && tappedBounds) {
+    try {
+      context.log?.("  Appium active-element send failed; using Android focused-keyboard input fallback");
+      await sendAndroidTextToFocusedInput(context.deviceId, value);
+      await new Promise((resolve) => setTimeout(resolve, MOBILE_FOCUS_SETTLE_MS));
+      return;
+    } catch (error2) {
+      if (isTransportError(error2)) throw error2;
+      lastInputError = error2;
+    }
+  }
   throw new Error(`TYPE step could not send text to the focused target${lastInputError instanceof Error ? `: ${lastInputError.message}` : ""}`);
 }
 async function executeClear(sessionId, step) {
@@ -328123,9 +328194,29 @@ async function executeAssertText(sessionId, step) {
   const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/text`);
   const actualText = typeof result?.value === "string" ? result.value : "";
-  if (!actualText.includes(step.assertion)) {
-    throw new Error(`Text assertion failed: expected "${step.assertion}" to be contained in "${actualText}"`);
+  const textCandidates = await readElementTextCandidates(sessionId, elementId, actualText);
+  if (!textCandidates.some((value) => value.includes(step.assertion))) {
+    throw new Error(`Text assertion failed: expected "${step.assertion}" to be contained in ${JSON.stringify(textCandidates)}`);
+  }
+}
+async function readElementTextCandidates(sessionId, elementId, actualText) {
+  const values = [];
+  const push = (value) => {
+    if (typeof value !== "string") return;
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || values.includes(trimmed)) return;
+    values.push(trimmed);
+  };
+  push(actualText);
+  for (const attr of MOBILE_TEXT_ATTRIBUTE_NAMES) {
+    try {
+      const result = await wdRequest(`/session/${sessionId}/element/${elementId}/attribute/${encodeURIComponent(attr)}`);
+      push(result?.value);
+    } catch (err) {
+      if (isTransportError(err)) throw err;
+    }
   }
+  return values;
 }
 async function executeMobileTest(options) {
   const logLines = [];
@@ -328250,7 +328341,11 @@ async function executeMobileTest(options) {
             await executeTap(sessionId, step);
             break;
           case "type":
-            await executeType(sessionId, step);
+            await executeType(sessionId, step, {
+              platform: options.target.platform,
+              deviceId: selectedDevice.id,
+              log: log2
+            });
             break;
           case "clear":
             await executeClear(sessionId, step);
@@ -332009,23 +332104,39 @@ ${finalVerifyResult.logs ?? ""}`;
         log.fail("ERROR - No mobile steps");
         return;
       }
+      const maxRetries = typeof run2.retryCount === "number" && Number.isFinite(run2.retryCount) ? Math.max(0, Math.min(2, Math.floor(run2.retryCount))) : 0;
       setExecutorBusy(true);
-      let result2;
+      let result2 = null;
+      const attemptLogs = [];
       try {
-        result2 = await executeMobileTest({
-          steps: mobileSteps,
-          target: {
-            appId: target.appId,
-            platform: target.platform,
-            platformVersion: target.platformVersion,
-            recordedDeviceId: target.recordedDeviceId,
-            launchMode: target.launchMode,
-            deeplink: target.deeplink
-          }
-        });
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+          if (attempt > 0) {
+            log.info(`Retrying mobile test after failed Appium step (${attempt}/${maxRetries})`);
+          }
+          result2 = await executeMobileTest({
+            steps: mobileSteps,
+            target: {
+              appId: target.appId,
+              platform: target.platform,
+              platformVersion: target.platformVersion,
+              recordedDeviceId: target.recordedDeviceId,
+              launchMode: target.launchMode,
+              deeplink: target.deeplink
+            }
+          });
+          attemptLogs.push(`--- Appium attempt ${attempt + 1}/${maxRetries + 1} ---
+${result2.logs}`);
+          if (result2.passed || result2.environmental || attempt >= maxRetries) break;
+        }
       } finally {
         setExecutorBusy(false);
       }
+      if (!result2) {
+        throw new Error("Appium execution did not produce a result.");
+      }
+      if (attemptLogs.length > 1) {
+        result2 = { ...result2, logs: attemptLogs.join("\n\n") };
+      }
       const duration2 = Date.now() - startTime;
       const status = result2.environmental ? "ERROR" : result2.passed ? "PASSED" : "FAILED";
       const reportedError = result2.environmental ? `CONFIG_ISSUE: ${result2.environmental}` : result2.error ?? void 0;

package/dist/cli.mjs

@@ -268,14 +268,16 @@ var require_ai_provider = __commonJS({
       { id: "minimax-m2.7", label: "MiniMax M2.7", provider: "minimax", description: "Fast M2.7 tier (Highspeed); auto-fails over to standard M2.7, ~200K ctx", contextWindow: 2e5 },
       { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", provider: "anthropic", description: "Anthropic - fast & intelligent, 200k ctx", contextWindow: 2e5 },
       { id: "nvidia-nemotron-nano", label: "NVIDIA Nemotron Nano", provider: "nvidia", description: "NVIDIA NIM - Nemotron 30B Nano, reasoning model, 128k ctx", contextWindow: 128e3 },
-      { id: "nvidia-kimi-k2.6", label: "NVIDIA Kimi K2.6", provider: "nvidia", description: "NVIDIA NIM - Moonshot Kimi K2.6, multimodal coding and agentic model, 256k ctx", contextWindow: 256e3 }
+      { id: "nvidia-kimi-k2.6", label: "NVIDIA Kimi K2.6", provider: "nvidia", description: "NVIDIA NIM - Moonshot Kimi K2.6, multimodal coding and agentic model, 256k ctx", contextWindow: 256e3 },
+      { id: "deepseek-v4-flash", label: "DeepSeek V4 Flash", provider: "deepseek", description: "DeepSeek - V4 Flash, OpenAI-compatible, 1M ctx", contextWindow: 1e6 }
     ];
     var PROVIDER_DEFAULT_MODEL = {
       openai: "gpt-4o",
       xai: "grok-build-0.1",
       anthropic: "claude-sonnet-4-6",
       minimax: "minimax-m3",
-      nvidia: "nvidia-nemotron-nano"
+      nvidia: "nvidia-nemotron-nano",
+      deepseek: "deepseek-v4-flash"
     };
     function getContextConfig(modelId) {
       const info = exports.AI_MODEL_CATALOG.find((m) => m.id === modelId);
@@ -326,7 +328,8 @@ var require_ai_provider = __commonJS({
       "minimax-m2.7-highspeed": { strong: "MiniMax-M2.7-highspeed", fast: "MiniMax-M2.7-highspeed", agent: "MiniMax-M2.7-highspeed" },
       "claude-sonnet-4-6": { strong: "claude-sonnet-4-6", fast: "claude-sonnet-4-6", agent: "claude-sonnet-4-6" },
       "nvidia-nemotron-nano": { strong: "nvidia/nemotron-3-nano-30b-a3b", fast: "nvidia/nemotron-3-nano-30b-a3b", agent: "nvidia/nemotron-3-nano-30b-a3b" },
-      "nvidia-kimi-k2.6": { strong: "moonshotai/kimi-k2.6", fast: "moonshotai/kimi-k2.6", agent: "moonshotai/kimi-k2.6" }
+      "nvidia-kimi-k2.6": { strong: "moonshotai/kimi-k2.6", fast: "moonshotai/kimi-k2.6", agent: "moonshotai/kimi-k2.6" },
+      "deepseek-v4-flash": { strong: "deepseek-v4-flash", fast: "deepseek-v4-flash", agent: "deepseek-v4-flash" }
     };
     var _requestModelStorage = new async_hooks_1.AsyncLocalStorage();
     function withModelContext(modelId, fn) {
@@ -388,6 +391,9 @@ var require_ai_provider = __commonJS({
       if (modelId === "nvidia/nemotron-3-nano-30b-a3b") {
         return { chat_template_kwargs: { enable_thinking: false } };
       }
+      if (modelId === "deepseek-v4-flash") {
+        return { thinking: { type: "disabled" } };
+      }
       return {};
     }
     exports.MINIMAX_FALLBACK_CHAIN = ["MiniMax-M3", "MiniMax-M2.7-highspeed", "MiniMax-M2.7"];
@@ -489,6 +495,11 @@ var require_ai_provider = __commonJS({
         if (!apiKey)
           throw new Error("NVIDIA_API_KEY is required when using an NVIDIA model");
         client = new openai_1.default({ apiKey, baseURL: process.env.NVIDIA_API_BASE ?? "https://integrate.api.nvidia.com/v1" });
+      } else if (provider === "deepseek") {
+        const apiKey = process.env.DEEPSEEK_API_KEY;
+        if (!apiKey)
+          throw new Error("DEEPSEEK_API_KEY is required when using a DeepSeek model");
+        client = new openai_1.default({ apiKey, baseURL: process.env.DEEPSEEK_API_BASE ?? "https://api.deepseek.com" });
       } else {
         const apiKey = process.env.OPENAI_API_KEY;
         if (!apiKey)
@@ -522,6 +533,8 @@ var require_ai_provider = __commonJS({
         return !!process.env.ANTHROPIC_API_KEY?.trim();
       if (provider === "nvidia")
         return !!process.env.NVIDIA_API_KEY?.trim();
+      if (provider === "deepseek")
+        return !!process.env.DEEPSEEK_API_KEY?.trim();
       return false;
     }
     function getAvailableModels() {
@@ -1549,6 +1562,21 @@ function buildAppiumCode(testName, target, steps) {
     `    await driver.keys(text);`,
     `  }`,
     `}`,
+    ``,
+    `async function __textCandidates(el: WebdriverIO.Element) {`,
+    `  const __values: string[] = [];`,
+    `  const __push = (__value: unknown) => {`,
+    `    if (typeof __value !== 'string') return;`,
+    `    const __trimmed = __value.trim();`,
+    `    if (__trimmed.length === 0 || __values.includes(__trimmed)) return;`,
+    `    __values.push(__trimmed);`,
+    `  };`,
+    `  __push(await el.getText().catch(() => ''));`,
+    `  for (const __attr of ['text', 'content-desc', 'contentDescription', 'name', 'label', 'value']) {`,
+    `    __push(await el.getAttribute(__attr).catch(() => ''));`,
+    `  }`,
+    `  return __values;`,
+    `}`,
     ...hasSwipe ? [
       ``,
       `// Read the device window with a few retries (matches the runtime executor).`,
@@ -1635,8 +1663,8 @@ function buildAppiumCode(testName, target, steps) {
     } else if (step.action === "assertText" && hasSelector) {
       lines.push(`    {`);
       lines.push(`      const __expected = ${toJsStringLiteral(step.assertion ?? "")};`);
-      lines.push(`      const __actual = await (await findFirst(driver, ${candidatesLiteral})).getText();`);
-      lines.push(`      if (!__actual.includes(__expected)) {`);
+      lines.push(`      const __actual = await __textCandidates(await findFirst(driver, ${candidatesLiteral}));`);
+      lines.push(`      if (!__actual.some((__value) => __value.includes(__expected))) {`);
       lines.push(`        throw new Error('Assertion failed: expected text to contain ' + JSON.stringify(__expected) + ' but got ' + JSON.stringify(__actual));`);
       lines.push(`      }`);
       lines.push(`    }`);
@@ -12043,7 +12071,7 @@ var require_kill_tree = __commonJS({
     var node_child_process_1 = __require("child_process");
     var node_util_1 = __require("util");
     var node_fs_1 = __require("fs");
-    var execFileAsync2 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var PS_TIMEOUT_MS = 2e3;
     var PS_BUFFER = 1024 * 1024;
     async function gracefulCloseWithTreeKill(options) {
@@ -12097,7 +12125,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -12135,7 +12163,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -12212,7 +12240,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync2("ps", ["-A", "-o", "pid=,ppid="], {
+        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -311581,6 +311609,13 @@ var require_mobile_discovery_agent = __commonJS({
     var mobile_generator_js_1 = require_mobile_generator();
     var mobile_exploration_state_js_1 = require_mobile_exploration_state();
     var discover_planner_js_1 = require_discover_planner();
+    function checkpointErrorMessage(err) {
+      return err instanceof Error ? err.message : String(err);
+    }
+    function isTerminalDiscoveryCheckpointError(err) {
+      const message = checkpointErrorMessage(err);
+      return /Discovery plan checkpoint rejected|Discovery run is .*not RUNNING|not RUNNING|cancelled/i.test(message);
+    }
     var EXPLORE_BUDGET_DEEP = 60;
     var EXPLORE_BUDGET_SURVEY = 40;
     function platformForMedium(medium) {
@@ -311711,14 +311746,22 @@ Plan: ${planResult.scenarios.length} scenarios, ${planResult.featureGroups.lengt
         const plans = toPlans(scenarios);
         const coverageGaps = planResult.coverageGaps && planResult.coverageGaps.length > 0 ? planResult.coverageGaps : void 0;
         if (callbacks?.onPlanReady) {
-          await callbacks.onPlanReady({
-            scenarios,
-            featureGroups,
-            fallbackUsed: planResult.fallbackUsed ?? false,
-            fallbackReason: planResult.fallbackReason
-          }).then(() => log2("Plan checkpoint: scenario plan POSTed to server")).catch((err) => {
-            log2(`Plan checkpoint POST failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
-          });
+          try {
+            await callbacks.onPlanReady({
+              scenarios,
+              featureGroups,
+              fallbackUsed: planResult.fallbackUsed ?? false,
+              fallbackReason: planResult.fallbackReason
+            });
+            log2("Plan checkpoint: scenario plan POSTed to server");
+          } catch (err) {
+            const message = checkpointErrorMessage(err);
+            if (isTerminalDiscoveryCheckpointError(err)) {
+              log2(`Plan checkpoint rejected for inactive discovery run: ${message}`);
+              throw err;
+            }
+            log2(`Plan checkpoint POST failed (non-fatal): ${message}`);
+          }
         }
         if (isSurvey) {
           const duration2 = (Date.now() - startTime) / 1e3;
@@ -321100,7 +321143,7 @@ var require_update = __commonJS({
 var require_opts_arg = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/opts-arg.js"(exports, module) {
     "use strict";
-    var { promisify: promisify2 } = __require("util");
+    var { promisify: promisify3 } = __require("util");
     var fs = __require("fs");
     var optsArg = (opts) => {
       if (!opts)
@@ -321114,9 +321157,9 @@ var require_opts_arg = __commonJS({
       else
         throw new TypeError("invalid options argument");
       opts.mkdir = opts.mkdir || opts.fs.mkdir || fs.mkdir;
-      opts.mkdirAsync = promisify2(opts.mkdir);
+      opts.mkdirAsync = promisify3(opts.mkdir);
       opts.stat = opts.stat || opts.fs.stat || fs.stat;
-      opts.statAsync = promisify2(opts.stat);
+      opts.statAsync = promisify3(opts.stat);
       opts.statSync = opts.statSync || opts.fs.statSync || fs.statSync;
       opts.mkdirSync = opts.mkdirSync || opts.fs.mkdirSync || fs.mkdirSync;
       return opts;
@@ -325209,7 +325252,7 @@ var require_process_inventory = __commonJS({
     var node_child_process_1 = __require("child_process");
     var node_os_1 = __importDefault(__require("os"));
     var node_util_1 = __require("util");
-    var execFileAsync2 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var DEFAULT_LIMIT = 60;
     var DEFAULT_TIMEOUT_MS = 800;
     var MAX_COMMAND_LENGTH = 320;
@@ -325271,7 +325314,7 @@ var require_process_inventory = __commonJS({
       const timer = setTimeout(() => controller.abort(), timeoutMs);
       timer.unref?.();
       try {
-        const { stdout } = await execFileAsync2(command, args, {
+        const { stdout } = await execFileAsync3(command, args, {
           maxBuffer: 1024 * 1024,
           signal: controller.signal
         });
@@ -326293,7 +326336,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.8",
+      version: "1.0.12",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -326427,6 +326470,8 @@ function shouldUseAuthState(tags, playwrightCode) {
 // src/services/appium-executor.ts
 init_dist();
 var import_runner_core8 = __toESM(require_dist2());
+import { execFile as execFile2 } from "child_process";
+import { promisify as promisify2 } from "util";
 
 // src/services/appium-lifecycle.ts
 import { spawn, execFileSync } from "child_process";
@@ -327609,6 +327654,8 @@ async function startMobileNetworkCapture(options) {
 
 // src/services/appium-executor.ts
 var DEFAULT_STEP_TIMEOUT_MS = 1e4;
+var execFileAsync2 = promisify2(execFile2);
+var MOBILE_TEXT_ATTRIBUTE_NAMES = ["text", "content-desc", "contentDescription", "name", "label", "value"];
 var WebDriverTransportError = class extends Error {
   isTransport = true;
   constructor(message) {
@@ -327930,6 +327977,18 @@ async function sendKeysToFocusedInput(sessionId, value) {
     body: JSON.stringify({ text: value, value: Array.from(value) })
   });
 }
+function encodeAndroidInputText(value) {
+  return value.replace(/%/g, "%25").replace(/\s/g, "%s");
+}
+async function sendAndroidTextToFocusedInput(deviceId, value) {
+  if (!deviceId) {
+    throw new Error("Android keyboard fallback requires a device id");
+  }
+  await execFileAsync2("adb", ["-s", deviceId, "shell", "input", "text", encodeAndroidInputText(value)], {
+    timeout: 1e4,
+    windowsHide: true
+  });
+}
 async function trySendElementValue(sessionId, elementId, value) {
   try {
     await wdRequest(`/session/${sessionId}/element/${elementId}/value`, {
@@ -327978,7 +328037,7 @@ async function executeTap(sessionId, step) {
   }
   await tapCoordinates(sessionId, bounds);
 }
-async function executeType(sessionId, step) {
+async function executeType(sessionId, step, context) {
   if (step.value === void 0 || step.value === null || step.value === "") return;
   const value = String(step.value);
   const bounds = boundsFromStep(step);
@@ -328027,6 +328086,7 @@ async function executeType(sessionId, step) {
   if (bounds) {
     if (!tappedBounds) {
       await tapCoordinates(sessionId, bounds);
+      tappedBounds = true;
       await new Promise((resolve) => setTimeout(resolve, MOBILE_FOCUS_SETTLE_MS));
     }
     try {
@@ -328037,6 +328097,17 @@ async function executeType(sessionId, step) {
       lastInputError = error2;
     }
   }
+  if (context.platform === "ANDROID" && tappedBounds) {
+    try {
+      context.log?.("  Appium active-element send failed; using Android focused-keyboard input fallback");
+      await sendAndroidTextToFocusedInput(context.deviceId, value);
+      await new Promise((resolve) => setTimeout(resolve, MOBILE_FOCUS_SETTLE_MS));
+      return;
+    } catch (error2) {
+      if (isTransportError(error2)) throw error2;
+      lastInputError = error2;
+    }
+  }
   throw new Error(`TYPE step could not send text to the focused target${lastInputError instanceof Error ? `: ${lastInputError.message}` : ""}`);
 }
 async function executeClear(sessionId, step) {
@@ -328131,9 +328202,29 @@ async function executeAssertText(sessionId, step) {
   const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/text`);
   const actualText = typeof result?.value === "string" ? result.value : "";
-  if (!actualText.includes(step.assertion)) {
-    throw new Error(`Text assertion failed: expected "${step.assertion}" to be contained in "${actualText}"`);
+  const textCandidates = await readElementTextCandidates(sessionId, elementId, actualText);
+  if (!textCandidates.some((value) => value.includes(step.assertion))) {
+    throw new Error(`Text assertion failed: expected "${step.assertion}" to be contained in ${JSON.stringify(textCandidates)}`);
+  }
+}
+async function readElementTextCandidates(sessionId, elementId, actualText) {
+  const values = [];
+  const push = (value) => {
+    if (typeof value !== "string") return;
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || values.includes(trimmed)) return;
+    values.push(trimmed);
+  };
+  push(actualText);
+  for (const attr of MOBILE_TEXT_ATTRIBUTE_NAMES) {
+    try {
+      const result = await wdRequest(`/session/${sessionId}/element/${elementId}/attribute/${encodeURIComponent(attr)}`);
+      push(result?.value);
+    } catch (err) {
+      if (isTransportError(err)) throw err;
+    }
   }
+  return values;
 }
 async function executeMobileTest(options) {
   const logLines = [];
@@ -328258,7 +328349,11 @@ async function executeMobileTest(options) {
             await executeTap(sessionId, step);
             break;
           case "type":
-            await executeType(sessionId, step);
+            await executeType(sessionId, step, {
+              platform: options.target.platform,
+              deviceId: selectedDevice.id,
+              log: log2
+            });
             break;
           case "clear":
             await executeClear(sessionId, step);
@@ -332017,23 +332112,39 @@ ${finalVerifyResult.logs ?? ""}`;
         log.fail("ERROR - No mobile steps");
         return;
       }
+      const maxRetries = typeof run2.retryCount === "number" && Number.isFinite(run2.retryCount) ? Math.max(0, Math.min(2, Math.floor(run2.retryCount))) : 0;
       setExecutorBusy(true);
-      let result2;
+      let result2 = null;
+      const attemptLogs = [];
       try {
-        result2 = await executeMobileTest({
-          steps: mobileSteps,
-          target: {
-            appId: target.appId,
-            platform: target.platform,
-            platformVersion: target.platformVersion,
-            recordedDeviceId: target.recordedDeviceId,
-            launchMode: target.launchMode,
-            deeplink: target.deeplink
-          }
-        });
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+          if (attempt > 0) {
+            log.info(`Retrying mobile test after failed Appium step (${attempt}/${maxRetries})`);
+          }
+          result2 = await executeMobileTest({
+            steps: mobileSteps,
+            target: {
+              appId: target.appId,
+              platform: target.platform,
+              platformVersion: target.platformVersion,
+              recordedDeviceId: target.recordedDeviceId,
+              launchMode: target.launchMode,
+              deeplink: target.deeplink
+            }
+          });
+          attemptLogs.push(`--- Appium attempt ${attempt + 1}/${maxRetries + 1} ---
+${result2.logs}`);
+          if (result2.passed || result2.environmental || attempt >= maxRetries) break;
+        }
       } finally {
         setExecutorBusy(false);
       }
+      if (!result2) {
+        throw new Error("Appium execution did not produce a result.");
+      }
+      if (attemptLogs.length > 1) {
+        result2 = { ...result2, logs: attemptLogs.join("\n\n") };
+      }
       const duration2 = Date.now() - startTime;
       const status = result2.environmental ? "ERROR" : result2.passed ? "PASSED" : "FAILED";
       const reportedError = result2.environmental ? `CONFIG_ISSUE: ${result2.environmental}` : result2.error ?? void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@validate.qa/runner",
-  "version": "1.0.8",
+  "version": "1.0.12",
   "description": "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
   "bin": {
     "validate-runner": "dist/cli.js"