@validate.qa/runner 1.0.9 → 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(`    }`);
@@ -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;
@@ -326288,7 +326331,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.9",
+      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"
@@ -327604,6 +327647,7 @@ 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) {
@@ -328150,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 = [];
@@ -332040,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(`    }`);
@@ -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;
@@ -326293,7 +326336,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.9",
+      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"
@@ -327612,6 +327655,7 @@ 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) {
@@ -328158,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 = [];
@@ -332048,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.9",
+  "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"