@validate.qa/runner 1.0.34 → 1.0.35

package/dist/cli.mjs

@@ -1354,11 +1354,13 @@ function escapeEnvValue(value) {
   const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r");
   return `"${escaped}"`;
 }
-var API_PREFIX, AUDIO_CHUNK_DURATION_MS, ACTION_BATCH_INTERVAL_MS, ACTION_BATCH_MAX_SIZE, MOBILE_SCREENSHOT_INTERVAL_MS, MOBILE_ACTION_BATCH_MAX_SIZE, MOBILE_BRIDGE_PORT, MOBILE_SNAPSHOT_MAX_SIZE_BYTES, MOBILE_APP_ID_MAX_LENGTH, MOBILE_APP_ID_PATTERN, MOBILE_FOCUS_SETTLE_MS, MOBILE_DEFAULT_SWIPE_DISTANCE, MOBILE_MAX_SWIPE_DISTANCE, SELECTOR_PRIORITIES, MOBILE_STEP_TYPES, BLOCKED_ENV_VARS, SPAWNED_ENV_ALLOWLIST;
+var API_PREFIX, SUPPORT_EMAIL, PLATFORM_ADMIN_EMAIL, AUDIO_CHUNK_DURATION_MS, ACTION_BATCH_INTERVAL_MS, ACTION_BATCH_MAX_SIZE, MOBILE_SCREENSHOT_INTERVAL_MS, MOBILE_ACTION_BATCH_MAX_SIZE, MOBILE_BRIDGE_PORT, MOBILE_SNAPSHOT_MAX_SIZE_BYTES, MOBILE_APP_ID_MAX_LENGTH, MOBILE_APP_ID_PATTERN, MOBILE_FOCUS_SETTLE_MS, MOBILE_DEFAULT_SWIPE_DISTANCE, MOBILE_MAX_SWIPE_DISTANCE, SELECTOR_PRIORITIES, MOBILE_STEP_TYPES, BLOCKED_ENV_VARS, SPAWNED_ENV_ALLOWLIST;
 var init_constants = __esm({
   "../shared/dist/constants.js"() {
     "use strict";
     API_PREFIX = "/api";
+    SUPPORT_EMAIL = "support@validate.qa";
+    PLATFORM_ADMIN_EMAIL = "admin@validate.qa";
     AUDIO_CHUNK_DURATION_MS = 3e4;
     ACTION_BATCH_INTERVAL_MS = 2e3;
     ACTION_BATCH_MAX_SIZE = 10;
@@ -2562,6 +2564,8 @@ var init_audit_pricing = __esm({
       // Current defaults
       "grok-build-0.1": { input: 1, output: 2 },
       "claude-opus-4-7": { input: 5, output: 25 },
+      // Introductory pricing through 2026-08-31 ($2/$10); standard is $3/$15.
+      "claude-sonnet-5": { input: 2, output: 10 },
       "claude-sonnet-4-6": { input: 3, output: 15 },
       "claude-haiku-4-5-20251001": { input: 1, output: 5 },
       "gpt-4o": { input: 2.5, output: 10 },
@@ -3598,7 +3602,7 @@ var init_agent_env = __esm({
       "CommonProgramFiles"
     ]);
     ALLOW_PREFIX = [
-      // AI provider / CLI config (grok-build, claude-code, claude-code-minimax)
+      // AI provider / CLI config (grok-build, claude-code)
       "GROK_",
       "XAI_",
       "ANTHROPIC_",
@@ -3905,8 +3909,10 @@ __export(dist_exports, {
   MOBILE_STEP_TYPES: () => MOBILE_STEP_TYPES,
   PLAN_DEFINITIONS: () => PLAN_DEFINITIONS,
   PLAN_ORDER: () => PLAN_ORDER,
+  PLATFORM_ADMIN_EMAIL: () => PLATFORM_ADMIN_EMAIL,
   SELECTOR_PRIORITIES: () => SELECTOR_PRIORITIES,
   SHARED_PRICING_PLAN_MAP: () => SHARED_PRICING_PLAN_MAP,
+  SUPPORT_EMAIL: () => SUPPORT_EMAIL,
   TRANSIENT_CONTROL_ROLES: () => TRANSIENT_CONTROL_ROLES,
   TRIAL_DURATION_DAYS: () => TRIAL_DURATION_DAYS,
   UI_VARIANTS: () => UI_VARIANTS,
@@ -298974,7 +298980,8 @@ var require_bootstrap_grok_auth = __commonJS({
       const home = process.env.HOME ?? "/home/appuser";
       const authPath = node_path_1.default.join(home, ".grok", "auth.json");
       const b64 = process.env.GROK_AUTH_JSON_B64;
-      if (node_fs_1.default.existsSync(authPath)) {
+      const force = process.env.GROK_AUTH_FORCE_RESEED === "true" || process.env.GROK_AUTH_FORCE_RESEED === "1";
+      if (!force && node_fs_1.default.existsSync(authPath)) {
         return;
       }
       if (!b64) {
@@ -298985,7 +298992,7 @@ var require_bootstrap_grok_auth = __commonJS({
         node_fs_1.default.mkdirSync(dir, { recursive: true, mode: 448 });
         node_fs_1.default.writeFileSync(authPath, Buffer.from(b64, "base64"));
         node_fs_1.default.chmodSync(authPath, 384);
-        console.log(`[grok-auth][runner] Seeded ${authPath} from GROK_AUTH_JSON_B64`);
+        console.log(force ? `[grok-auth][runner] Force-reseeded ${authPath} from GROK_AUTH_JSON_B64` : `[grok-auth][runner] Seeded ${authPath} from GROK_AUTH_JSON_B64`);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         console.warn(`[grok-auth][runner] Failed to seed auth.json: ${message}`);
@@ -299630,6 +299637,37 @@ var require_proven_actions_adapter = __commonJS({
   }
 });
 
+// ../runner-core/dist/services/agentic-cli-constants.js
+var require_agentic_cli_constants = __commonJS({
+  "../runner-core/dist/services/agentic-cli-constants.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.GROK_CLI_DEFAULT_REASONING_EFFORT = exports.GROK_CLI_DEFAULT_MODEL = exports.CLAUDE_CODE_DEFAULT_EFFORT = exports.CLAUDE_CODE_DEFAULT_MODEL = exports.MODEL_CLAUDE_CODE = exports.MODEL_GROK_BUILD = void 0;
+    exports.isGrokBuildModel = isGrokBuildModel;
+    exports.isClaudeCodeModel = isClaudeCodeModel;
+    exports.getAgenticEngine = getAgenticEngine;
+    exports.MODEL_GROK_BUILD = "grok-build";
+    function isGrokBuildModel(id) {
+      return id === exports.MODEL_GROK_BUILD;
+    }
+    exports.MODEL_CLAUDE_CODE = "claude-code";
+    function isClaudeCodeModel(id) {
+      return id === exports.MODEL_CLAUDE_CODE;
+    }
+    function getAgenticEngine(modelId) {
+      if (isGrokBuildModel(modelId))
+        return "grok-build";
+      if (isClaudeCodeModel(modelId))
+        return "claude-code";
+      return "native";
+    }
+    exports.CLAUDE_CODE_DEFAULT_MODEL = "claude-sonnet-5";
+    exports.CLAUDE_CODE_DEFAULT_EFFORT = "max";
+    exports.GROK_CLI_DEFAULT_MODEL = "grok-4.5";
+    exports.GROK_CLI_DEFAULT_REASONING_EFFORT = "high";
+  }
+});
+
 // ../runner-core/dist/services/grok-cli.js
 var require_grok_cli = __commonJS({
   "../runner-core/dist/services/grok-cli.js"(exports) {
@@ -299640,6 +299678,7 @@ var require_grok_cli = __commonJS({
     exports.runGrok = runGrok;
     var node_child_process_1 = __require("child_process");
     var shared_1 = (init_dist(), __toCommonJS(dist_exports));
+    var agentic_cli_constants_js_1 = require_agentic_cli_constants();
     function extractAssistantJson(stdout) {
       const tryParse = (s) => {
         const trimmed = s.trim();
@@ -299734,7 +299773,8 @@ var require_grok_cli = __commonJS({
     function runGrok(options) {
       const {
         prompt,
-        model = "grok-build",
+        model = agentic_cli_constants_js_1.GROK_CLI_DEFAULT_MODEL,
+        reasoningEffort = agentic_cli_constants_js_1.GROK_CLI_DEFAULT_REASONING_EFFORT,
         maxTurns,
         // undefined = let grok decide when to quit
         timeoutMs = 6e5,
@@ -299763,6 +299803,9 @@ var require_grok_cli = __commonJS({
           "--always-approve",
           "--no-alt-screen"
         ];
+        if (reasoningEffort) {
+          args.push("--reasoning-effort", reasoningEffort);
+        }
         if (typeof maxTurns === "number" && maxTurns > 0) {
           args.push("--max-turns", String(maxTurns));
         }
@@ -299908,7 +299951,7 @@ var require_grok_per_test_healer = __commonJS({
     var HEAL_MCP_CAPABILITIES = ["core", "core-navigation", "core-input", "core-tabs", "testing"];
     var grok_cli_js_1 = require_grok_cli();
     var DEFAULT_MAX_ATTEMPTS = 3;
-    var DEFAULT_TIMEOUT_MS = 30 * 60 * 1e3;
+    var DEFAULT_TIMEOUT_MS2 = 30 * 60 * 1e3;
     var IDLE_WATCHDOG_MS = 10 * 60 * 1e3;
     function getMaxAttempts() {
       const raw = process.env.GROK_PER_TEST_HEAL_MAX_ATTEMPTS;
@@ -299918,7 +299961,7 @@ var require_grok_per_test_healer = __commonJS({
     function getAttemptTimeoutMs() {
       const raw = process.env.GROK_PER_TEST_HEAL_TIMEOUT_MS;
       const parsed = raw ? parseInt(raw, 10) : NaN;
-      return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_TIMEOUT_MS;
+      return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_TIMEOUT_MS2;
     }
     async function executeGrokPerTestHeal2(playwrightCode, steps, baseUrl, options = {}) {
       const externalLogSink = options.onLog;
@@ -300331,7 +300374,7 @@ Output the JSON envelope exactly ONCE as your final message, then exit.`;
         "-p",
         'Read BRIEF.md in this directory. Heal TEST_UNDER_HEAL.spec.ts as instructed. Your FINAL assistant message MUST be ONLY a JSON object \u2014 no prose around it \u2014 with this shape: {"verdict":"fix|app_bug|config_issue|prereq_unmet|state_stale|test_invalid","playwrightCode":"<full file if verdict=fix>","changeDescription":"<one sentence>","reason":"<terse, when not fix>","confidence":"high|medium|low"}',
         "-m",
-        "grok-build",
+        "grok-4.5",
         // streaming-json: per-event NDJSON so the UI's GrokSessionLog drawer can
         // show progress instead of a frozen "starting…" until the final envelope.
         "--output-format",
@@ -301551,7 +301594,7 @@ When done with all ${input.tests.length} tests in this chunk, exit.`;
         "-p",
         "Read BRIEF.md in this directory. Heal every test under tests/*.spec.ts as instructed and emit a verdict file per test under verdicts/<testCaseId>.json (write to .tmp then rename \u2014 the runner is polling). When done, exit.",
         "-m",
-        "grok-build",
+        "grok-4.5",
         // streaming-json so per-token output reaches the UI for live progress.
         "--output-format",
         "streaming-json",
@@ -309040,47 +309083,6 @@ var require_sitemap_builder = __commonJS({
   }
 });
 
-// ../runner-core/dist/services/agentic-cli-constants.js
-var require_agentic_cli_constants = __commonJS({
-  "../runner-core/dist/services/agentic-cli-constants.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.CLAUDE_CODE_MINIMAX_FALLBACK_CHAIN = exports.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL = exports.CLAUDE_CODE_DEFAULT_MODEL = exports.MODEL_CLAUDE_CODE_MINIMAX = exports.MODEL_CLAUDE_CODE = exports.MODEL_GROK_BUILD = void 0;
-    exports.isGrokBuildModel = isGrokBuildModel;
-    exports.isClaudeCodeModel = isClaudeCodeModel;
-    exports.isClaudeCodeMinimaxModel = isClaudeCodeMinimaxModel;
-    exports.getAgenticEngine = getAgenticEngine;
-    exports.MODEL_GROK_BUILD = "grok-build";
-    function isGrokBuildModel(id) {
-      return id === exports.MODEL_GROK_BUILD;
-    }
-    exports.MODEL_CLAUDE_CODE = "claude-code";
-    function isClaudeCodeModel(id) {
-      return id === exports.MODEL_CLAUDE_CODE;
-    }
-    exports.MODEL_CLAUDE_CODE_MINIMAX = "claude-code-minimax";
-    function isClaudeCodeMinimaxModel(id) {
-      return id === exports.MODEL_CLAUDE_CODE_MINIMAX;
-    }
-    function getAgenticEngine(modelId) {
-      if (isGrokBuildModel(modelId))
-        return "grok-build";
-      if (isClaudeCodeMinimaxModel(modelId))
-        return "claude-code-minimax";
-      if (isClaudeCodeModel(modelId))
-        return "claude-code";
-      return "native";
-    }
-    exports.CLAUDE_CODE_DEFAULT_MODEL = "claude-sonnet-4-6";
-    exports.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL = "MiniMax-M3";
-    exports.CLAUDE_CODE_MINIMAX_FALLBACK_CHAIN = [
-      "MiniMax-M3",
-      "MiniMax-M2.7-highspeed",
-      "MiniMax-M2.7"
-    ];
-  }
-});
-
 // ../runner-core/dist/services/auth-capture-run.js
 var require_auth_capture_run = __commonJS({
   "../runner-core/dist/services/auth-capture-run.js"(exports) {
@@ -309884,7 +309886,7 @@ var require_grok_survey_runner = __commonJS({
     var scrub_credentials_js_1 = require_scrub_credentials();
     var agentic_survey_prompts_js_1 = require_agentic_survey_prompts();
     var MCP_CAPABILITIES = ["core", "core-navigation", "core-input", "core-tabs", "testing"];
-    var DEFAULT_TIMEOUT_MS = 15 * 60 * 1e3;
+    var DEFAULT_TIMEOUT_MS2 = 15 * 60 * 1e3;
     var RETRY_TIMEOUT_MS = 5 * 60 * 1e3;
     function extractCredentials(vars) {
       if (!vars)
@@ -310320,7 +310322,7 @@ var require_grok_survey_runner = __commonJS({
     }
     async function runGrokSurveyOnRunner(ctx, options = {}) {
       const maxTurns = options.maxTurns;
-      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
       const logs2 = [];
       const log2 = (line) => {
         logs2.push(line);
@@ -310454,7 +310456,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
       try {
         const result = await (0, grok_cli_js_1.runGrok)({
           prompt: kickoffPrompt,
-          model: "grok-build",
+          model: "grok-4.5",
           maxTurns,
           timeoutMs,
           homeDir: grokHomeDir,
@@ -310501,7 +310503,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
         try {
           const retryResult = await (0, grok_cli_js_1.runGrok)({
             prompt: fixPrompt,
-            model: "grok-build",
+            model: "grok-4.5",
             // Retry: also let grok decide turns; the shorter retry budget lives
             // in the wall-clock timeout below.
             timeoutMs: RETRY_TIMEOUT_MS,
@@ -310634,20 +310636,19 @@ var require_canvas_detector = __commonJS({
         return { kind: "override", canvasMode: false };
       if (opts.engine === "claude-code")
         return { kind: "canvas-mode", canvasMode: true };
-      if (opts.engine === "claude-code-minimax" || opts.engine === "native")
+      if (opts.engine === "native")
         return { kind: "bail" };
       return { kind: "proceed", canvasMode: false };
     }
     function modelSupportsVision(modelId) {
       if (!modelId)
         return false;
-      if (modelId === "claude-code-minimax")
-        return false;
       if (modelId === "claude-code")
         return true;
       if (modelId === "grok-build")
         return false;
       const visionCapable = /* @__PURE__ */ new Set([
+        "claude-sonnet-5",
         "claude-sonnet-4-6",
         "claude-opus-4-7",
         "claude-haiku-4-5",
@@ -311824,7 +311825,7 @@ var require_grok_discovery_runner = __commonJS({
       "core-tabs",
       "testing"
     ];
-    var DEFAULT_TIMEOUT_MS = 20 * 60 * 1e3;
+    var DEFAULT_TIMEOUT_MS2 = 20 * 60 * 1e3;
     var RETRY_TIMEOUT_MS = 6 * 60 * 1e3;
     var DEFAULT_TARGET = { min: 6, max: 15 };
     var WATCHER_DEBOUNCE_MS = 500;
@@ -311988,7 +311989,7 @@ var require_grok_discovery_runner = __commonJS({
       const manifestFeatureRoutes = Array.isArray(manifestShape?.feature?.pages) ? manifestShape.feature.pages.filter((r) => typeof r === "string" && r.length > 0) : [];
       const featureRoutes = manifestFeatureRoutes.length > 0 ? manifestFeatureRoutes : ctx.featureContext?.pageIntel?.map((p) => p.route) ?? ctx.focusAreas ?? [];
       const targetTestCount = options.targetTestCount ?? DEFAULT_TARGET;
-      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
       const logs2 = [];
       const log2 = (line) => {
         logs2.push(line);
@@ -312593,7 +312594,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
         try {
           const result = await (0, grok_cli_js_1.runGrok)({
             prompt: kickoffPrompt,
-            model: "grok-build",
+            model: "grok-4.5",
             timeoutMs,
             homeDir: grokHomeDir,
             cwd: runDir,
@@ -312673,7 +312674,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           try {
             const retryResult = await (0, grok_cli_js_1.runGrok)({
               prompt: fixPrompt,
-              model: "grok-build",
+              model: "grok-4.5",
               timeoutMs: RETRY_TIMEOUT_MS,
               homeDir: grokHomeDir,
               cwd: runDir,
@@ -312905,7 +312906,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
       const manifestFeatureRoutes = Array.isArray(manifestShape?.feature?.pages) ? manifestShape.feature.pages.filter((r) => typeof r === "string" && r.length > 0) : [];
       const featureRoutes = manifestFeatureRoutes.length > 0 ? manifestFeatureRoutes : ctx.featureContext?.pageIntel?.map((p) => p.route) ?? ctx.focusAreas ?? [];
       const targetTestCount = options.targetTestCount ?? DEFAULT_TARGET;
-      const callerTimeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+      const callerTimeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
       const call1TimeoutMs = Math.max(callerTimeoutMs, GROK_V2_CALL1_TIMEOUT_MS);
       const logs2 = [];
       const log2 = (line) => {
@@ -313422,24 +313423,12 @@ var require_claude_cli = __commonJS({
       return s.includes("authentication_failed") || s.includes("oauth_org_not_allowed") || s.includes("invalid_grant") || s.includes("401 unauthorized") || s.includes("invalid api key") || s.includes("invalid bearer token") || /\boauth token\b.*\b(expired|invalid)\b/.test(s) || /\b(token|credentials?)\b.*\bexpired\b/.test(s);
     }
     function runClaudeOnce(options) {
-      const { prompt, model = "claude-sonnet-4-6", provider = "anthropic", maxTurns, timeoutMs = 6e5, cwd, mcpConfigPath, addDirs, appendSystemPrompt, disallowedTools = ["Task"], onChunk, idleKillMs = 5 * 60 * 1e3, abortRef } = options;
+      const { prompt, model = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL, effort = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_EFFORT, provider = "anthropic", maxTurns, timeoutMs = 6e5, cwd, mcpConfigPath, addDirs, appendSystemPrompt, disallowedTools = ["Task"], onChunk, idleKillMs = 5 * 60 * 1e3, abortRef } = options;
       return new Promise((resolve, reject) => {
-        let oauthToken;
-        let minimaxBaseUrl;
-        let minimaxApiKey;
-        if (provider === "minimax") {
-          minimaxBaseUrl = process.env.MINIMAX_ANTHROPIC_BASE_URL;
-          minimaxApiKey = process.env.MINIMAX_API_KEY;
-          if (!minimaxBaseUrl || !minimaxApiKey) {
-            reject(new ClaudeSpawnError("Claude Code (MiniMax) engine selected but MINIMAX_ANTHROPIC_BASE_URL and/or MINIMAX_API_KEY are not set. Set both as Railway env vars on the runner service.", -1, "", "", true));
-            return;
-          }
-        } else {
-          oauthToken = process.env.CLAUDE_CODE_OAUTH_TOKEN;
-          if (!oauthToken) {
-            reject(new ClaudeSpawnError("Claude Code engine selected but CLAUDE_CODE_OAUTH_TOKEN is not set. Set it as a Railway env var on the runner service.", -1, "", "", true));
-            return;
-          }
+        const oauthToken = process.env.CLAUDE_CODE_OAUTH_TOKEN;
+        if (!oauthToken) {
+          reject(new ClaudeSpawnError("Claude Code engine selected but CLAUDE_CODE_OAUTH_TOKEN is not set. Set it as a Railway env var on the runner service.", -1, "", "", true));
+          return;
         }
         const args = [
           "-p",
@@ -313461,8 +313450,8 @@ var require_claude_cli = __commonJS({
           // Stateless container — don't write session transcripts to disk.
           "--no-session-persistence"
         ];
-        if (provider === "minimax") {
-          args.push("--bare");
+        if (effort && effort.trim().length > 0) {
+          args.push("--effort", effort.trim());
         }
         if (typeof maxTurns === "number" && maxTurns > 0) {
           args.push("--max-turns", String(maxTurns));
@@ -313487,21 +313476,9 @@ var require_claude_cli = __commonJS({
             MCP_TIMEOUT: process.env.MCP_TIMEOUT ?? "120000"
           }
         });
-        if (provider === "minimax") {
-          spawnEnv.ANTHROPIC_BASE_URL = minimaxBaseUrl;
-          spawnEnv.ANTHROPIC_API_KEY = minimaxApiKey;
-          spawnEnv.ANTHROPIC_AUTH_TOKEN = minimaxApiKey;
-          delete spawnEnv.CLAUDE_CODE_OAUTH_TOKEN;
-          delete spawnEnv.ANTHROPIC_MODEL;
-          delete spawnEnv.ANTHROPIC_DEFAULT_SONNET_MODEL;
-          delete spawnEnv.ANTHROPIC_DEFAULT_OPUS_MODEL;
-          delete spawnEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL;
-          delete spawnEnv.ANTHROPIC_SMALL_FAST_MODEL;
-        } else {
-          spawnEnv.CLAUDE_CODE_OAUTH_TOKEN = oauthToken;
-          delete spawnEnv.ANTHROPIC_API_KEY;
-          delete spawnEnv.ANTHROPIC_AUTH_TOKEN;
-        }
+        spawnEnv.CLAUDE_CODE_OAUTH_TOKEN = oauthToken;
+        delete spawnEnv.ANTHROPIC_API_KEY;
+        delete spawnEnv.ANTHROPIC_AUTH_TOKEN;
         const isWindows = process.platform === "win32";
         const proc = (0, node_child_process_1.spawn)("claude", args, {
           env: spawnEnv,
@@ -313613,7 +313590,7 @@ var require_claude_cli = __commonJS({
           }
           if (exitCode !== 0) {
             const authFailure = looksLikeAuthFailure(stdout + "\n" + stderr);
-            const msg = authFailure ? provider === "minimax" ? "claude --bare session failed to authenticate against MiniMax \u2014 MINIMAX_API_KEY is missing, expired, or rejected by MINIMAX_ANTHROPIC_BASE_URL. Verify both env vars on the runner service." : "claude session failed to authenticate \u2014 CLAUDE_CODE_OAUTH_TOKEN is missing, expired, or invalid. Regenerate it with `claude setup-token` and update the Railway env var on the runner service." : `claude exited with code ${exitCode}${signal ? ` (signal=${signal})` : ""}`;
+            const msg = authFailure ? "claude session failed to authenticate \u2014 CLAUDE_CODE_OAUTH_TOKEN is missing, expired, or invalid. Regenerate it with `claude setup-token` and update the Railway env var on the runner service." : `claude exited with code ${exitCode}${signal ? ` (signal=${signal})` : ""}`;
             reject(new ClaudeSpawnError(msg, exitCode, stderr.trim(), stdout.trim(), authFailure));
             return;
           }
@@ -313626,39 +313603,8 @@ var require_claude_cli = __commonJS({
         });
       });
     }
-    function minimaxClaudeFallbackModels(requested) {
-      const chain = agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_FALLBACK_CHAIN;
-      const idx = chain.indexOf(requested);
-      if (idx === -1)
-        return [requested];
-      return chain.slice(idx);
-    }
     async function runClaude(options) {
-      if (options.provider !== "minimax")
-        return runClaudeOnce(options);
-      const requested = options.model ?? agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL;
-      const chain = minimaxClaudeFallbackModels(requested);
-      if (chain.length <= 1)
-        return runClaudeOnce({ ...options, model: requested });
-      let lastError;
-      for (let i = 0; i < chain.length; i++) {
-        const model = chain[i];
-        const isLast = i === chain.length - 1;
-        try {
-          const result = await runClaudeOnce({ ...options, model });
-          if (i > 0)
-            console.warn(`[claude-cli] MiniMax CLI failover succeeded on ${model} (requested ${requested})`);
-          return result;
-        } catch (err) {
-          lastError = err;
-          const spawnErr = err instanceof ClaudeSpawnError ? err : null;
-          if (isLast || spawnErr?.isAuthError || spawnErr?.isTimeout)
-            throw err;
-          const reason = err instanceof Error ? err.message : String(err);
-          console.warn(`[claude-cli] MiniMax CLI ${model} failed (${reason}) \u2014 failing over to ${chain[i + 1]}`);
-        }
-      }
-      throw lastError;
+      return runClaudeOnce(options);
     }
   }
 });
@@ -314043,6 +313989,8 @@ var require_claude_pricing = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.computeClaudeCostUsd = computeClaudeCostUsd;
     var CLAUDE_PRICE_PER_M = {
+      // Introductory pricing through 2026-08-31 ($2/$10); standard is $3/$15.
+      "claude-sonnet-5": { input: 2, output: 10 },
       "claude-sonnet-4-6": { input: 3, output: 15 },
       "claude-haiku-4-5-20251001": { input: 1, output: 5 },
       "claude-opus-4-7": { input: 5, output: 25 }
@@ -314082,7 +314030,7 @@ var require_claude_survey_runner = __commonJS({
     var agentic_survey_prompts_js_1 = require_agentic_survey_prompts();
     var MCP_CAPABILITIES = ["core", "core-navigation", "core-input", "core-tabs", "testing"];
     var CANVAS_MODE_EXTRA_CAPABILITIES = ["vision"];
-    var DEFAULT_TIMEOUT_MS = 15 * 60 * 1e3;
+    var DEFAULT_TIMEOUT_MS2 = 15 * 60 * 1e3;
     var RETRY_TIMEOUT_MS = 5 * 60 * 1e3;
     async function logResultFile(path, log2) {
       try {
@@ -314094,10 +314042,10 @@ ${preview}`);
         log2("[diagnostic] result file does not exist \u2014 Claude never wrote it");
       }
     }
-    async function runClaudeSurveyOnRunner(ctx, options = {}, provider = "anthropic") {
+    async function runClaudeSurveyOnRunner(ctx, options = {}) {
       const maxTurns = options.maxTurns;
-      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-      const claudeDefaultModel = provider === "minimax" ? agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL : agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
+      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+      const claudeDefaultModel = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
       const logs2 = [];
       const log2 = (line) => {
         logs2.push(line);
@@ -314241,7 +314189,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
         console.log(`[claude-survey] ${line}`);
       };
       const onAudit = options.onAudit;
-      const claudeProviderLabel = provider === "minimax" ? "minimax" : "anthropic";
+      const claudeProviderLabel = "anthropic";
       const claudeModelLabel = claudeDefaultModel;
       const surveyExploreCallType = "surveyExplore";
       const sessionStartedAt = Date.now();
@@ -314277,7 +314225,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
             groupId: auditGroupId,
             callType: surveyExploreCallType,
             model: claudeModelLabel,
-            provider: claudeProviderLabel,
+            provider: "anthropic",
             durationMs: turn.durationMs ?? 0,
             promptTokens,
             completionTokens,
@@ -314320,7 +314268,6 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
         const result = await (0, claude_cli_js_1.runClaude)({
           prompt: kickoffPrompt,
           model: claudeDefaultModel,
-          provider,
           maxTurns,
           timeoutMs,
           cwd: runDir,
@@ -314380,7 +314327,6 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           const retryResult = await (0, claude_cli_js_1.runClaude)({
             prompt: fixPrompt,
             model: claudeDefaultModel,
-            provider,
             timeoutMs: RETRY_TIMEOUT_MS,
             cwd: runDir,
             mcpConfigPath,
@@ -314436,7 +314382,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
             groupId: auditGroupId,
             callType: surveyExploreCallType,
             model: claudeModelLabel,
-            provider: claudeProviderLabel,
+            provider: "anthropic",
             durationMs: sessionDurationMs,
             promptTokens: sessionInputTokens,
             completionTokens: sessionOutputTokens,
@@ -314812,11 +314758,11 @@ var require_claude_discovery_adapter = __commonJS({
     var PER_TEST_IDLE_KILL_MS = 10 * 60 * 1e3;
     var PER_TEST_MAX_TURNS = 120;
     function createClaudeDiscoveryAdapter(args) {
-      const { provider, claudeDefaultModel } = args;
+      const { claudeDefaultModel } = args;
       return {
-        engine: provider === "minimax" ? "claude-code-minimax" : "claude-code",
+        engine: "claude-code",
         auditModel: claudeDefaultModel,
-        auditProvider: provider,
+        auditProvider: "anthropic",
         computeSessionCostUsd(usage) {
           return (0, claude_pricing_js_1.computeClaudeCostUsd)(claudeDefaultModel, {
             inputTokens: usage.inputTokens,
@@ -314857,7 +314803,7 @@ var require_claude_discovery_adapter = __commonJS({
               prompt,
               appendSystemPrompt,
               model: claudeDefaultModel,
-              provider,
+              provider: "anthropic",
               maxTurns: PER_TEST_MAX_TURNS,
               // A per-test session needs only browser MCP + the file tools — never a
               // shell. Disallow Bash to shrink the off-task surface (and Task, the
@@ -314929,17 +314875,17 @@ var require_claude_discovery_runner = __commonJS({
     ];
     var CALL1_TIMEOUT_MS = 38 * 60 * 1e3;
     var DISCOVERY_IDLE_KILL_MS = 15 * 60 * 1e3;
-    var DEFAULT_TIMEOUT_MS = 20 * 60 * 1e3;
+    var DEFAULT_TIMEOUT_MS2 = 20 * 60 * 1e3;
     var DEFAULT_TARGET = { min: 6, max: 15 };
-    async function runClaudeDiscoveryOnRunner(ctx, callbackOptions, options = {}, provider = "anthropic") {
-      const claudeDefaultModel = provider === "minimax" ? agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL : agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
-      const claudeProviderLabel = provider === "minimax" ? "minimax" : "anthropic";
+    async function runClaudeDiscoveryOnRunner(ctx, callbackOptions, options = {}) {
+      const claudeDefaultModel = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
+      const claudeProviderLabel = "anthropic";
       const featureName = ctx.featureName ?? "Untitled Feature";
       const manifestShape = (0, grok_discovery_runner_js_1.narrowManifest)(ctx.featureContextManifest);
       const manifestFeatureRoutes = Array.isArray(manifestShape?.feature?.pages) ? manifestShape.feature.pages.filter((r) => typeof r === "string" && r.length > 0) : [];
       const featureRoutes = manifestFeatureRoutes.length > 0 ? manifestFeatureRoutes : ctx.featureContext?.pageIntel?.map((p) => p.route) ?? ctx.focusAreas ?? [];
       const targetTestCount = options.targetTestCount ?? DEFAULT_TARGET;
-      const callerTimeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+      const callerTimeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
       const call1TimeoutMs = Math.max(callerTimeoutMs, CALL1_TIMEOUT_MS);
       const logs2 = [];
       const log2 = (line) => {
@@ -315186,7 +315132,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
               groupId: ctx.sessionId ?? featureName,
               callType: featureExploreCallType,
               model: claudeModelLabel,
-              provider: claudeProviderLabel,
+              provider: "anthropic",
               durationMs: turn.durationMs ?? 0,
               promptTokens,
               completionTokens,
@@ -315297,7 +315243,6 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
             // they actually get put there.
             appendSystemPrompt: canvasMode ? (0, agentic_discovery_prompts_js_1.buildAuthoringRules)() + (0, canvas_detector_js_1.buildCanvasModeAuthoringAddendum)() : (0, agentic_discovery_prompts_js_1.buildAuthoringRules)(),
             model: claudeDefaultModel,
-            provider,
             timeoutMs: call1TimeoutMs,
             idleKillMs: DISCOVERY_IDLE_KILL_MS,
             cwd: runDir,
@@ -315407,7 +315352,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
               groupId: ctx.sessionId ?? featureName,
               callType: featureExploreCallType,
               model: claudeModelLabel,
-              provider: claudeProviderLabel,
+              provider: "anthropic",
               durationMs: sessionDurationMs,
               promptTokens: sessionInputTokens,
               completionTokens: sessionOutputTokens,
@@ -315499,7 +315444,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
             },
             onAudit,
             auditGroupId: ctx.sessionId ?? featureName,
-            adapter: (0, claude_discovery_adapter_js_1.createClaudeDiscoveryAdapter)({ provider, claudeDefaultModel })
+            adapter: (0, claude_discovery_adapter_js_1.createClaudeDiscoveryAdapter)({ claudeDefaultModel })
           });
           log2(`Verify + Call 2: complete \u2014 ${capturedTests.length} test(s) saved, ${localUnverified.length} unverified`);
         }
@@ -316425,7 +316370,7 @@ var require_discover_agent = __commonJS({
       } else if (cached === "standard") {
         return { renderType: "standard", canvasMode: false, probeRan: false };
       } else {
-        const bailEligible = engine === "native" || engine === "claude-code-minimax";
+        const bailEligible = engine === "native";
         const cannotConfirm = (reason) => {
           const note = bailEligible ? ` \u26A0 engine=${engine} would have bailed on canvas \u2014 if discovery loops, set Settings \u2192 App renderer manually.` : "";
           log2(`[canvas] preflight could not run: ${reason} \u2014 proceeding as standard.${note}`);
@@ -316744,7 +316689,7 @@ Respond with ONLY valid JSON:
             // wiring is in place when it does.
             onAudit: onAICall
           };
-          const cliResult = surveyEngine === "claude-code-minimax" ? await (0, claude_survey_runner_js_1.runClaudeSurveyOnRunner)(ctx, surveyOpts, "minimax") : surveyEngine === "claude-code" ? await (0, claude_survey_runner_js_1.runClaudeSurveyOnRunner)(ctx, surveyOpts, "anthropic") : await (0, grok_survey_runner_js_1.runGrokSurveyOnRunner)(ctx, surveyOpts);
+          const cliResult = surveyEngine === "claude-code" ? await (0, claude_survey_runner_js_1.runClaudeSurveyOnRunner)(ctx, surveyOpts) : await (0, grok_survey_runner_js_1.runGrokSurveyOnRunner)(ctx, surveyOpts);
           logs2.push(`${surveyEngine} survey runner finished cleanly.`);
           onLog?.("done", logs2.join("\n"));
           return {
@@ -317266,7 +317211,7 @@ Fatal error: ${msg}`);
             // through the existing DiscoveryAuditCallback (→ aiAuditBatch).
             onAudit: onAICall
           };
-          const cliResult = deepEngine === "claude-code-minimax" ? await (0, claude_discovery_runner_js_1.runClaudeDiscoveryOnRunner)(ctx, deepCallbacks, deepOpts, "minimax") : deepEngine === "claude-code" ? await (0, claude_discovery_runner_js_1.runClaudeDiscoveryOnRunner)(ctx, deepCallbacks, deepOpts, "anthropic") : await (0, grok_discovery_runner_js_1.runGrokDiscoveryOnRunner)(ctx, deepCallbacks, deepOpts);
+          const cliResult = deepEngine === "claude-code" ? await (0, claude_discovery_runner_js_1.runClaudeDiscoveryOnRunner)(ctx, deepCallbacks, deepOpts) : await (0, grok_discovery_runner_js_1.runGrokDiscoveryOnRunner)(ctx, deepCallbacks, deepOpts);
           logs2.push(`${deepEngine} deep discovery finished cleanly. ${cliResult.testsEmitted} tests emitted, ${cliResult.unverified.length} unverified.`);
           onLog?.("done", logs2.join("\n"));
           return {
@@ -328146,9 +328091,8 @@ var require_framework_import_runner = __commonJS({
       const imp = ctx.frameworkImport;
       if (!imp)
         throw new Error("runFrameworkImportOnRunner: ctx.frameworkImport is required");
-      const engine = (0, agentic_cli_constants_js_1.getAgenticEngine)(ctx.exploreModel);
-      const provider = engine === "claude-code-minimax" ? "minimax" : "anthropic";
-      const model = provider === "minimax" ? agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL : agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
+      const provider = "anthropic";
+      const model = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
       log2("=== Framework Import Runner (Claude CLI, no browser) ===");
       log2(`Source: ${imp.source}${imp.source === "github" ? ` (${imp.repoOwner}/${imp.repoName}@${imp.branch ?? "default"})` : ""}`);
       const runDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "framework-import-"));
@@ -329278,8 +329222,8 @@ var require_repo_analysis_runner = __commonJS({
       const maxEndpointsPerFeature = intEnv("REPO_ANALYSIS_MAX_ENDPOINTS_PER_FEATURE", 80, 1, 400);
       const maxFacts = intEnv("REPO_ANALYSIS_MAX_FACTS", 40, 1, 120);
       const engine = (0, agentic_cli_constants_js_1.getAgenticEngine)(ctx.exploreModel);
-      const provider = engine === "claude-code-minimax" ? "minimax" : "anthropic";
-      const model = provider === "minimax" ? agentic_cli_constants_js_1.CLAUDE_CODE_MINIMAX_DEFAULT_MODEL : agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
+      const provider = "anthropic";
+      const model = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
       log2("=== Repo Analysis Runner (Claude CLI, no browser) ===");
       log2(`Source: ${imp.source}${imp.source === "github" ? ` (${imp.repoOwner}/${imp.repoName}@${imp.branch ?? "default"})` : ""}`);
       const runDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "repo-analysis-"));
@@ -329762,7 +329706,7 @@ var require_process_inventory = __commonJS({
     var node_util_1 = __require("util");
     var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var DEFAULT_LIMIT = 60;
-    var DEFAULT_TIMEOUT_MS = 800;
+    var DEFAULT_TIMEOUT_MS2 = 800;
     var MAX_COMMAND_LENGTH = 320;
     function roundOne(value) {
       return Math.round(value * 10) / 10;
@@ -329911,7 +329855,7 @@ var require_process_inventory = __commonJS({
     }
     async function getBrowserProcessInventory2(options = {}) {
       const limit = Math.max(1, Math.min(200, options.limit ?? DEFAULT_LIMIT));
-      const timeoutMs = Math.max(100, Math.min(5e3, options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
+      const timeoutMs = Math.max(100, Math.min(5e3, options.timeoutMs ?? DEFAULT_TIMEOUT_MS2));
       try {
         const rawProcesses = process.platform === "win32" ? await collectWindowsProcesses(timeoutMs) : await collectUnixProcesses(timeoutMs);
         const processes = [...rawProcesses].sort((a, b) => (b.cpuPct ?? 0) - (a.cpuPct ?? 0) || (b.rssMB ?? 0) - (a.rssMB ?? 0)).slice(0, limit);
@@ -330878,7 +330822,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.34",
+      version: "1.0.35",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -330886,6 +330830,7 @@ var require_package4 = __commonJS({
       scripts: {
         build: "tsup",
         dev: "tsx src/cli.ts",
+        test: "node --import tsx --test src/version-check.test.ts",
         "test:mobile": "node --import tsx --test src/runner.mobile-ai-env.test.ts src/services/mobile/mobile-network-capture.smoke.test.ts src/services/mobile/mobile-host-proxy.test.ts",
         prepublishOnly: "npm run build"
       },
@@ -331014,6 +330959,136 @@ function shouldUseAuthState(tags, playwrightCode) {
   return !tags.includes(INLINE_LOGIN_TAG) && !hasLegacyInlineLogin;
 }
 
+// src/version-check.ts
+var RUNNER_NPM_PACKAGE = "@validate.qa/runner";
+var NPM_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(RUNNER_NPM_PACKAGE)}/latest`;
+var DEFAULT_TIMEOUT_MS = 8e3;
+function parseSemver(raw) {
+  const cleaned = raw.trim().replace(/^v/i, "");
+  const match = cleaned.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ?? null
+  };
+}
+function compareSemver(a, b) {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  if (!pa || !pb) return null;
+  if (pa.major !== pb.major) return pa.major < pb.major ? -1 : 1;
+  if (pa.minor !== pb.minor) return pa.minor < pb.minor ? -1 : 1;
+  if (pa.patch !== pb.patch) return pa.patch < pb.patch ? -1 : 1;
+  if (pa.prerelease === pb.prerelease) return 0;
+  if (pa.prerelease === null) return 1;
+  if (pb.prerelease === null) return -1;
+  return pa.prerelease < pb.prerelease ? -1 : pa.prerelease > pb.prerelease ? 1 : 0;
+}
+function isVersionOutdated(current, latest) {
+  const cmp = compareSemver(current, latest);
+  return cmp === -1;
+}
+function shouldSkipVersionCheck() {
+  if (process.env.RUNNER_CLOUD === "true") {
+    return "cloud runner (RUNNER_CLOUD=true)";
+  }
+  if (process.env.VALIDATE_RUNNER_ALLOW_OUTDATED === "1" || process.env.VALIDATE_RUNNER_ALLOW_OUTDATED === "true") {
+    return "VALIDATE_RUNNER_ALLOW_OUTDATED is set";
+  }
+  return null;
+}
+async function fetchLatestRunnerVersion(timeoutMs = DEFAULT_TIMEOUT_MS, fetchImpl = fetch) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetchImpl(NPM_LATEST_URL, {
+      headers: {
+        Accept: "application/json",
+        // Identify ourselves; helps npm operators + caching intermediaries.
+        "User-Agent": `${RUNNER_NPM_PACKAGE}-version-check`
+      },
+      signal: controller.signal
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" && body.version.length > 0 ? body.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function checkRunnerVersion(currentVersion, opts = {}) {
+  const skip = shouldSkipVersionCheck();
+  if (skip) {
+    return { outdated: false, currentVersion, latestVersion: null, skippedReason: skip };
+  }
+  const latestVersion = await fetchLatestRunnerVersion(opts.timeoutMs, opts.fetchImpl);
+  if (!latestVersion) {
+    return {
+      outdated: false,
+      currentVersion,
+      latestVersion: null,
+      skippedReason: "could not reach npm registry (or response was invalid)"
+    };
+  }
+  if (!parseSemver(currentVersion) || !parseSemver(latestVersion)) {
+    return {
+      outdated: false,
+      currentVersion,
+      latestVersion,
+      skippedReason: "unparseable version string"
+    };
+  }
+  return {
+    outdated: isVersionOutdated(currentVersion, latestVersion),
+    currentVersion,
+    latestVersion
+  };
+}
+function formatUpgradeInstructions(latestVersion) {
+  const lines = [
+    "",
+    "\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557",
+    "\u2551  VALIDATE.QA RUNNER UPDATE REQUIRED                              \u2551",
+    "\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563",
+    "\u2551  A newer runner is published on npm. Each runner release changes \u2551",
+    "\u2551  the workflow, so this version can no longer run.                \u2551",
+    `\u2551  Latest:  ${latestVersion.padEnd(54)}\u2551`,
+    "\u2551                                                                  \u2551",
+    "\u2551  Upgrade with:                                                   \u2551",
+    `\u2551    npm install -g ${RUNNER_NPM_PACKAGE}@latest`.padEnd(69) + "\u2551",
+    "\u2551                                                                  \u2551",
+    "\u2551  Then restart:                                                   \u2551",
+    "\u2551    validate-runner start                                         \u2551",
+    "\u2551    # or: npx @validate.qa/runner@latest start                    \u2551",
+    "\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D",
+    ""
+  ];
+  return lines.join("\n");
+}
+async function enforceRunnerUpToDate(currentVersion, opts = {}) {
+  const log2 = opts.log ?? ((msg) => console.error(msg));
+  const result = await checkRunnerVersion(currentVersion, opts);
+  if (result.skippedReason && !result.outdated) {
+    if (result.skippedReason.startsWith("could not reach") || result.skippedReason.startsWith("unparseable")) {
+      log2(`\u26A0  Runner version check skipped: ${result.skippedReason}`);
+    }
+    return result;
+  }
+  if (result.outdated && result.latestVersion) {
+    log2(formatUpgradeInstructions(result.latestVersion));
+    log2(`  Installed: ${result.currentVersion}`);
+    log2(`  Required:  ${result.latestVersion} (or newer)`);
+    log2("");
+    const exit = opts.exitFn ?? ((code) => process.exit(code));
+    exit(1);
+  }
+  return result;
+}
+
 // src/services/appium-executor.ts
 init_dist();
 
@@ -336050,13 +336125,31 @@ function buildHeaders(authToken, projectId) {
   return {
     "Content-Type": "application/json",
     Authorization: `Bearer ${authToken}`,
-    "X-Project-Id": projectId
+    "X-Project-Id": projectId,
+    // Lets the server force-upgrade outdated local installs on /pending too
+    // (not only heartbeat), so they cannot claim work after a new npm publish.
+    "X-Runner-Version": RUNNER_VERSION,
+    "X-Runner-Name": RUNNER_NAME
   };
 }
+var RunnerUpgradeRequiredError = class extends Error {
+  latestVersion;
+  constructor(message, latestVersion) {
+    super(message);
+    this.name = "RunnerUpgradeRequiredError";
+    this.latestVersion = latestVersion;
+  }
+};
 async function fetchPendingRuns(serverUrl, headers) {
   const res = await fetch(`${serverUrl}/api/runner/pending`, { headers, signal: AbortSignal.timeout(3e4) });
   if (!res.ok) {
     if (res.status === 401) throw new Error("Runner token is invalid or expired. Run: validate.qa-runner login");
+    if (res.status === 426) {
+      const body = await res.json().catch(() => null);
+      const latest = typeof body?.latestRunnerVersion === "string" ? body.latestRunnerVersion : null;
+      const msg = typeof body?.error === "string" ? body.error : "A newer @validate.qa/runner is required. Run: npm install -g @validate.qa/runner@latest";
+      throw new RunnerUpgradeRequiredError(msg, latest);
+    }
     if (res.status === 429) {
       const retryAfter = res.headers.get("Retry-After");
       const waitSecs = retryAfter ? parseInt(retryAfter, 10) : 60;
@@ -338569,10 +338662,34 @@ async function startRunner(opts) {
   }
   console.log("");
   log.ok(`Runner started - waiting for test runs...${enableMobile ? " (web + mobile)" : ""}`);
+  log.info(`Version:  ${RUNNER_VERSION}`);
   log.dim("Press Ctrl+C to stop");
   console.log("");
   let runsCompleted = 0;
   let activeRuns = 0;
+  const VERSION_RECHECK_MS = Math.max(
+    6e4,
+    envInt("VALIDATE_RUNNER_VERSION_CHECK_MS", 15 * 6e4)
+  );
+  const exitForUpgrade = (latestVersion, installed) => {
+    console.error(formatUpgradeInstructions(latestVersion));
+    console.error(`  Installed: ${installed}`);
+    console.error(`  Required:  ${latestVersion} (or newer)`);
+    console.error("");
+    process.exit(1);
+  };
+  const recheckRunnerVersion = async () => {
+    if (activeRuns > 0) return;
+    const result = await checkRunnerVersion(RUNNER_VERSION);
+    if (result.outdated && result.latestVersion) {
+      log.warn("A newer runner was published on npm \u2014 shutting down so you can upgrade.");
+      exitForUpgrade(result.latestVersion, RUNNER_VERSION);
+    }
+  };
+  const versionRecheckTimer = setInterval(() => {
+    void recheckRunnerVersion();
+  }, VERSION_RECHECK_MS);
+  versionRecheckTimer.unref?.();
   const MAX_CONCURRENT = Math.max(1, envInt("MAX_CONCURRENT", DEFAULT_MAX_CONCURRENT));
   const MAX_PROJECT_CONCURRENT = Math.max(1, envInt("MAX_PROJECT_CONCURRENT", DEFAULT_MAX_PROJECT_CONCURRENT));
   const TYPE_LIMITS = {
@@ -338798,6 +338915,22 @@ async function startRunner(opts) {
         if (body && Array.isArray(body.commands) && body.commands.length > 0) {
           void handleControlCommands(body.commands);
         }
+        if (body && body.forceUpgrade === true && typeof body.latestRunnerVersion === "string" && isVersionOutdated(RUNNER_VERSION, body.latestRunnerVersion) && activeRuns === 0) {
+          log.warn(
+            typeof body.upgradeMessage === "string" && body.upgradeMessage ? body.upgradeMessage : "Server requires a newer runner version \u2014 shutting down."
+          );
+          exitForUpgrade(body.latestRunnerVersion, RUNNER_VERSION);
+        }
+      } else if (response.status === 426) {
+        const body = await response.json().catch(() => null);
+        const latest = typeof body?.latestRunnerVersion === "string" ? body.latestRunnerVersion : null;
+        if (latest) {
+          exitForUpgrade(latest, RUNNER_VERSION);
+        }
+        log.warn(
+          typeof body?.error === "string" ? body.error : "Server rejected this runner version (HTTP 426). Upgrade @validate.qa/runner."
+        );
+        process.exit(1);
       }
     } catch {
     }
@@ -339038,6 +339171,10 @@ async function startRunner(opts) {
         consecutivePollErrors = 0;
       }
     } catch (err) {
+      if (err instanceof RunnerUpgradeRequiredError) {
+        log.warn(err.message);
+        exitForUpgrade(err.latestVersion ?? "latest", RUNNER_VERSION);
+      }
       const message = err instanceof Error ? err.message : String(err);
       consecutivePollErrors++;
       const backoffMs = Math.min(pollIntervalMs * Math.pow(2, consecutivePollErrors - 1), MAX_BACKOFF_MS);
@@ -339057,7 +339194,11 @@ async function startRunner(opts) {
 var pkg = require_package4();
 var program = new Command();
 program.name("validate-runner").description("validate.qa local test runner - execute Playwright and Appium tests on your machine").version(pkg.version);
+async function requireLatestRunner() {
+  await enforceRunnerUpToDate(pkg.version);
+}
 program.command("login").description("Save runner credentials for future use").requiredOption("--token <token>", "Runner token (urt_... from validate.qa dashboard)").requiredOption("--server <url>", "validate.qa server URL").option("--project <id>", "Project ID (from dashboard URL)").action(async (opts) => {
+  await requireLatestRunner();
   const serverUrl = opts.server.replace(/\/+$/, "");
   if (!opts.token.startsWith("urt_") && !opts.token.startsWith("rt_") && !opts.token.startsWith("eyJ")) {
     console.error("\u26A0  Token should start with urt_ (from the dashboard Runner Token)");
@@ -339089,6 +339230,7 @@ program.command("login").description("Save runner credentials for future use").r
   console.log("Run: validate-runner start");
 });
 program.command("start").description("Start the local test runner").option("--token <token>", "Runner token (overrides saved credentials)").option("--server <url>", "Server URL (overrides saved credentials)").option("--project <id>", "Project ID (overrides saved credentials)").option("--mode <mode>", "Runner mode: playwright-native (default)", "playwright-native").option("--poll-interval <ms>", "Poll interval in milliseconds", "2000").option("--mobile", "Enable mobile testing (Appium + mobile bridge server)").option("--tunnel", "Enable ngrok tunnel for mobile bridge (allows HTTPS dashboard to connect)").action(async (opts) => {
+  await requireLatestRunner();
   const saved = loadCredentials();
   const authToken = opts.token || process.env.AUTH_TOKEN || saved?.token;
   const serverUrl = (opts.server || process.env.SERVER_URL || saved?.serverUrl)?.replace(/\/+$/, "");
@@ -339141,6 +339283,7 @@ program.command("logout").description("Clear saved runner credentials").action((
   console.log("\u2713  Credentials cleared");
 });
 program.command("status").description("Check connection to validate.qa server").action(async () => {
+  await requireLatestRunner();
   const saved = loadCredentials();
   if (!saved) {
     console.log("No saved credentials. Run: validate-runner login");