@qawolf/cli 1.1.0 → 1.2.0

package/README.md

@@ -23,7 +23,7 @@ Try it without installing:
 npx @qawolf/cli --help
 ```
 
-Supported Node versions: active LTS and newer (currently Node 22+). See [nodejs.org](https://nodejs.org).
+Supported Node versions: Node 20.19+. Node 20 reached [end-of-life](https://endoflife.date/nodejs) on 2026-04-30 and no longer receives security updates; it remains supported here only for environments still pinned to Node 20. Prefer Node 22+ where possible.
 
 ### Standalone binaries
 

package/dist/cli.js

@@ -8514,7 +8514,7 @@ var require_BufferList = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join31(s3) {
+    BufferList.prototype.join = function join32(s3) {
       if (this.length === 0)
         return "";
       var p3 = this.head;
@@ -23070,7 +23070,7 @@ var require_BufferList2 = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join31(s3) {
+    BufferList.prototype.join = function join32(s3) {
       if (this.length === 0)
         return "";
       var p3 = this.head;
@@ -155130,6 +155130,15 @@ function errorCode(err) {
 function isNoEntError(err) {
   return errorCode(err) === "ENOENT";
 }
+var missingPackagePattern = /Cannot find (?:package|module) '([^']+)'/;
+var pathLikeSpecifierPattern = /^(?:\.|\/|[A-Za-z]:[\\/])/;
+function extractMissingPackage(text) {
+  const specifier = missingPackagePattern.exec(text)?.[1];
+  if (specifier === undefined || pathLikeSpecifierPattern.test(specifier)) {
+    return;
+  }
+  return specifier;
+}
 
 // src/core/messages/auth.ts
 var authMessages = {
@@ -155391,7 +155400,10 @@ var runnerMessages = {
   retrying: (attempt, maxAttempts) => `Retrying (${attempt} of ${maxAttempts})...`,
   screenshot: (path) => `Screenshot: ${path}`,
   managedRuntimeNote: (dir) => `Using managed runtime — override with --deps <dir> or QAWOLF_RUNTIME_DIR:
-${dir}`
+${dir}`,
+  installingProjectDeps: (count) => `Installing ${pluralize(count, "project dependency", "project dependencies")}…`,
+  outerHopCandidateRejected: (dir, missing) => `outer-hop candidate rejected: ${dir} missing ${missing.join(", ")}`,
+  moduleNotFoundHint: (pkg, projectDir) => projectDir === undefined ? `Hint: '${pkg}' could not be resolved. Run from within your flows project so its dependencies can be found.` : `Hint: '${pkg}' could not be resolved. Ensure it is declared in ${projectDir}/package.json "dependencies" and run npm install in that project.`
 };
 // node_modules/env-paths/index.js
 import path from "node:path";
@@ -173618,7 +173630,7 @@ function registerAuthCommand(program2, signals) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.1.0",
+  version: "1.2.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -173676,6 +173688,7 @@ var package_default = {
   dependencies: {
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
+    "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
     "@qawolf/api-contracts": "0.1.0",
     "@qawolf/emails": "1.1.1",
@@ -173709,7 +173722,7 @@ var package_default = {
     typescript: "6.0.3"
   },
   engines: {
-    node: ">=22.15.0"
+    node: ">=20.19.0"
   },
   packageManager: "bun@1.3.13"
 };
@@ -174035,15 +174048,15 @@ async function checkFileAssets(deps) {
 
 // src/domains/doctor/checks/nodeVersion.ts
 async function checkNodeVersion(deps) {
-  const minMajor = extractMajor(deps.enginesNode, /^>=\s*(\d+)/);
-  if (minMajor === undefined) {
+  const min = parseVersion(deps.enginesNode, /^>=\s*(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+  if (min === undefined) {
     return {
       name: "node-version",
       status: "fail",
       detail: doctorMessages.nodeVersion.couldNotParseEngines(deps.enginesNode)
     };
   }
-  const actual = extractMajor(deps.processVersion, /^v?(\d+)/);
+  const actual = parseVersion(deps.processVersion, /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
   if (actual === undefined) {
     return {
       name: "node-version",
@@ -174051,7 +174064,7 @@ async function checkNodeVersion(deps) {
       detail: doctorMessages.nodeVersion.couldNotParseVersion(deps.processVersion)
     };
   }
-  if (actual < minMajor) {
+  if (compareVersions(actual, min) < 0) {
     return {
       name: "node-version",
       status: "fail",
@@ -174065,9 +174078,18 @@ async function checkNodeVersion(deps) {
     version: deps.processVersion.replace(/^v/, "")
   };
 }
-function extractMajor(input, pattern) {
-  const captured = input.trim().match(pattern)?.[1];
-  return captured === undefined ? undefined : Number.parseInt(captured, 10);
+function parseVersion(input, pattern) {
+  const match = input.trim().match(pattern);
+  if (match?.[1] === undefined)
+    return;
+  return [
+    Number.parseInt(match[1], 10),
+    match[2] === undefined ? 0 : Number.parseInt(match[2], 10),
+    match[3] === undefined ? 0 : Number.parseInt(match[3], 10)
+  ];
+}
+function compareVersions(a2, b2) {
+  return a2[0] - b2[0] || a2[1] - b2[1] || a2[2] - b2[2];
 }
 
 // src/domains/doctor/checks/npmRegistry.ts
@@ -180085,28 +180107,35 @@ var executorPackageNames = new Set(pinnedPackages.map((p3) => p3.name));
 async function populateOuterHop(args) {
   const { projectDir, runDir, fs: fs3 } = args;
   if (projectDir === undefined)
-    return;
-  const nearestNm = await findNearestNodeModulesDir(projectDir);
-  if (nearestNm !== undefined) {
-    await createDirSymlink(nearestNm, join27(runDir, "node_modules"));
-    return;
-  }
+    return { mode: "none" };
   const installableDeps = await readInstallableDeps(projectDir, fs3);
-  if (Object.keys(installableDeps).length > 0) {
-    await installOuterDeps(runDir, installableDeps, fs3);
-  }
-}
-async function findNearestNodeModulesDir(startDir) {
+  const depNames = Object.keys(installableDeps);
+  const { satisfying, rejected } = await findSatisfyingNodeModulesDir(projectDir, depNames, fs3);
+  if (satisfying !== undefined) {
+    await createDirSymlink(satisfying, join27(runDir, "node_modules"));
+    return { mode: "symlink", nodeModulesDir: satisfying };
+  }
+  if (depNames.length === 0)
+    return { mode: "none" };
+  args.onInstallStart?.(depNames.length);
+  await installOuterDeps(runDir, installableDeps, fs3, args.install ?? spawnNpmInstall);
+  return { mode: "install", depCount: depNames.length, rejected };
+}
+async function findSatisfyingNodeModulesDir(startDir, depNames, fs3) {
+  const rejected = [];
   let dir = startDir;
   while (true) {
     const candidate = join27(dir, "node_modules");
     const stats = await lstatSafe(candidate);
     if (stats !== undefined && stats.isDirectory() && !stats.isSymbolicLink()) {
-      return candidate;
+      const missing = depNames.filter((name) => !fs3.existsSync(join27(candidate, name, "package.json")));
+      if (missing.length === 0)
+        return { satisfying: candidate, rejected };
+      rejected.push({ dir: candidate, missing });
     }
     const parent = dirname8(dir);
     if (parent === dir)
-      return;
+      return { satisfying: undefined, rejected };
     dir = parent;
   }
 }
@@ -180124,7 +180153,12 @@ async function readInstallableDeps(projectDir, fs3) {
   } catch {
     return {};
   }
-  const parsed = JSON.parse(content);
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return {};
+  }
   if (typeof parsed !== "object" || parsed === null)
     return {};
   const rawDeps = parsed["dependencies"];
@@ -180132,11 +180166,11 @@ async function readInstallableDeps(projectDir, fs3) {
     return {};
   return Object.fromEntries(Object.entries(rawDeps).filter(([name]) => !executorPackageNames.has(name)).filter((entry) => typeof entry[1] === "string"));
 }
-async function installOuterDeps(runDir, deps, fs3) {
+async function installOuterDeps(runDir, deps, fs3, install) {
   await fs3.writeFile(join27(runDir, "package.json"), JSON.stringify({ name: "qawolf-run", private: true, dependencies: deps }, undefined, 2));
   await fs3.writeFile(join27(runDir, ".npmrc"), `@qawolf:registry=https://registry.npmjs.org/
 `);
-  const result = await spawnNpmInstall(runDir);
+  const result = await install(runDir);
   if (result.exitCode !== 0) {
     throw new Error(`Failed to install project dependencies into ${runDir}: ${result.stderr.trim()}`);
   }
@@ -180158,10 +180192,16 @@ async function prepareRunDir(args) {
   if (projectDir !== undefined) {
     await writeExecSubpathImports({ execDir, fs: fs3 });
   }
-  await populateOuterHop({ projectDir, runDir, fs: fs3 });
+  const outerHop = await populateOuterHop({
+    projectDir,
+    runDir,
+    fs: fs3,
+    ...args.onInstallStart !== undefined ? { onInstallStart: args.onInstallStart } : {}
+  });
   return {
     files: stagedFiles,
     runDir,
+    outerHop,
     cleanup: () => fs3.rm(runDir, { recursive: true, force: true })
   };
 }
@@ -180244,8 +180284,143 @@ function resolveDepsRoot(args) {
   }, { fs: fs3 });
 }
 
-// src/shell/appium/createAppiumServer.ts
+// src/domains/emails/configureEmails.ts
+async function loadSdkDeps2(cwd) {
+  try {
+    const emailsPath = resolveFromEnvDir(cwd, "@qawolf/emails");
+    return await import(emailsPath);
+  } catch (err) {
+    throw new Error("Could not load @qawolf/emails. Install it in your project: `npm install @qawolf/emails` or `bun add @qawolf/emails`.", { cause: err });
+  }
+}
+async function configureEmails(config2, cwd, deps) {
+  const { createEmailsClient, configureEmailsClient } = deps ?? await loadSdkDeps2(cwd);
+  const client = await createEmailsClient({
+    ...config2,
+    pollForEmailsDefaultTimeoutMs: 60000,
+    waitForMessagesDefaultDelayMs: 1000
+  });
+  configureEmailsClient(client);
+  return client;
+}
+async function registerLazyEmailsClient(getInbox, cwd, deps) {
+  const { configureEmailsClient } = deps ?? await loadSdkDeps2(cwd);
+  configureEmailsClient({ getInbox });
+}
+
+// src/commands/flows/envVarDeps.ts
 import { join as join30 } from "node:path";
+function envFilePath(envDir) {
+  return join30(envDir, ".env");
+}
+async function readEnv(envDir, fs3) {
+  try {
+    return parseDotenv(await fs3.readFile(envFilePath(envDir)));
+  } catch (err) {
+    if (isNoEntError(err))
+      return {};
+    throw err;
+  }
+}
+async function writeEnv(envDir, fs3, vars) {
+  const target = envFilePath(envDir);
+  const tmp = `${target}.${process.pid}.tmp`;
+  await fs3.writeFile(tmp, serializeDotenv(vars), { mode: 384 });
+  await fs3.rename(tmp, target);
+}
+function makeEnvVarDeps(envDir, fs3) {
+  return {
+    setEnvironmentVariable: async (key, value) => {
+      const vars = await readEnv(envDir, fs3);
+      vars[key] = value;
+      await writeEnv(envDir, fs3, vars);
+      process.env[key] = value;
+    },
+    fetchLatestEnvironmentVariables: async () => {
+      const vars = await readEnv(envDir, fs3);
+      for (const [key, value] of Object.entries(vars)) {
+        process.env[key] = value;
+      }
+    }
+  };
+}
+
+// src/commands/flows/flowRuntimeDeps.ts
+async function maybeGetIdentityTeamId(platform) {
+  const identity = await platform.getIdentity();
+  return identity.ok ? identity.value.team.id : undefined;
+}
+function lazyGetInbox({
+  envDir,
+  ctx,
+  platform,
+  env: env2,
+  resolveApiKeyFn,
+  configureEmailsFn,
+  createPlatform
+}) {
+  let getInboxPromise;
+  async function configure() {
+    const explicitEmailerUrl = env2["EMAILER_URL"];
+    let teamId = env2["CLOUD_AGENTS_INBOX_TEAM_ID"];
+    const apiKeyResult = explicitEmailerUrl === undefined ? await resolveApiKeyFn(ctx.configDir, ctx.fs) : undefined;
+    if (teamId === undefined && platform !== undefined) {
+      teamId = await maybeGetIdentityTeamId(platform);
+    }
+    if (teamId === undefined && apiKeyResult !== undefined) {
+      const identityPlatform = createPlatform(apiKeyResult.key, {
+        baseUrl: ctx.apiBaseUrl,
+        fetch: globalThis.fetch,
+        ...ctx.log ? { logger: ctx.log("trpc") } : {}
+      });
+      teamId = await maybeGetIdentityTeamId(identityPlatform);
+    }
+    const teamIdPart = teamId !== undefined ? { teamId } : {};
+    if (explicitEmailerUrl !== undefined) {
+      const client2 = await configureEmailsFn({ emailerUrl: explicitEmailerUrl, ...teamIdPart }, envDir);
+      return client2.getInbox;
+    }
+    if (apiKeyResult === undefined) {
+      throw new Error("getInbox requires EMAILER_URL, QAWOLF_API_KEY, or stored QA Wolf credentials. Run 'qawolf auth login'.");
+    }
+    const client = await configureEmailsFn({ apiKey: apiKeyResult.key, url: `${ctx.apiBaseUrl}/api`, ...teamIdPart }, envDir);
+    return client.getInbox;
+  }
+  return async (...args) => {
+    getInboxPromise ??= configure();
+    const getInbox = await getInboxPromise;
+    return getInbox(...args);
+  };
+}
+async function createFlowRuntimeDeps({
+  envDir,
+  ctx,
+  platform,
+  env: env2 = process.env,
+  resolveApiKeyFn = resolveApiKey,
+  configureEmailsFn = configureEmails,
+  createPlatform = createPlatformClient
+}) {
+  const getInbox = lazyGetInbox({
+    envDir,
+    ctx,
+    platform,
+    env: env2,
+    resolveApiKeyFn,
+    configureEmailsFn,
+    createPlatform
+  });
+  try {
+    await registerLazyEmailsClient(getInbox, envDir);
+  } catch {}
+  return {
+    ...makeEnvVarDeps(envDir, ctx.fs),
+    getInbox
+  };
+}
+
+// src/shell/appium/createAppiumServer.ts
+import { join as join31 } from "node:path";
 
 // src/shell/appium/spawnAppium.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -180320,7 +180495,7 @@ async function createAppiumServer(envDir, signals, params) {
   const spawnFn = params?.deps?.spawn ?? defaultSpawnAppium;
   const findFreePortFn = params?.deps?.findFreePort ?? findFreePort;
   const resolveAppiumBinFn = params?.deps?.resolveAppiumBin ?? resolveAppiumBin;
-  const appiumHome2 = params?.options?.appiumHome ?? join30(envPaths("qawolf").data, "appium");
+  const appiumHome2 = params?.options?.appiumHome ?? join31(envPaths("qawolf").data, "appium");
   const timeoutMs3 = params?.options?.startTimeoutMs ?? defaultStartTimeoutMs;
   const bin = resolveAppiumBinFn(envDir);
   const port = await findFreePortFn();
@@ -180806,6 +180981,9 @@ function createAndroidLaunchContext({
 import path11 from "node:path";
 import { pathToFileURL } from "node:url";
 
+// src/shell/resolver/detectRuntimeCapabilities.ts
+import nodeModule2 from "node:module";
+
 // src/shell/resolver/registerFlowModuleResolver.ts
 import nodeModule from "node:module";
 
@@ -180872,6 +181050,50 @@ function registerFlowModuleResolver() {
   registerHooks({ resolve: flowResolveHook });
 }
 
+// src/shell/resolver/detectRuntimeCapabilities.ts
+function detectRuntimeCapabilities() {
+  return {
+    isBun: globalThis.Bun !== undefined,
+    hasSyncHooks: resolveRegisterHooks(nodeModule2) !== undefined,
+    hasNativeTypeScript: Boolean(process.features.typescript),
+    hasAsyncRegister: typeof nodeModule2.register === "function"
+  };
+}
+
+// src/shell/resolver/selectFlowLoaderStrategy.ts
+function selectFlowLoaderStrategy(caps) {
+  if (caps.isBun)
+    return "none";
+  if (caps.hasNativeTypeScript) {
+    return caps.hasSyncHooks ? "sync-alias" : "none";
+  }
+  return caps.hasAsyncRegister ? "oxc-transpile" : "unsupported";
+}
+
+// src/shell/resolver/registerFlowLoader.ts
+async function defaultRegisterOxcLoader() {
+  try {
+    await import("@oxc-node/core/register");
+  } catch (cause) {
+    throw new Error(`Failed to load the @oxc-node/core TypeScript loader needed to run flows on Node ${process.version}. Ensure @oxc-node/core is installed for this platform (${process.platform}-${process.arch}).`, { cause });
+  }
+}
+async function registerFlowLoader(deps = {}) {
+  const {
+    capabilities = detectRuntimeCapabilities(),
+    registerSyncAlias = registerFlowModuleResolver,
+    registerOxcLoader = defaultRegisterOxcLoader
+  } = deps;
+  const strategy = selectFlowLoaderStrategy(capabilities);
+  if (strategy === "sync-alias") {
+    registerSyncAlias();
+  } else if (strategy === "oxc-transpile") {
+    await registerOxcLoader();
+  } else if (strategy === "unsupported") {
+    throw new Error(`Running TypeScript flows requires Node 20.6+ (for module.register) or a runtime with native TypeScript support. Current runtime: ${process.version}. Upgrade Node to 20.6 or newer.`);
+  }
+}
+
 // src/domains/runner/executorPlugin.ts
 import path10 from "node:path";
 var executorImportDetect = /from ['"]@qawolf\/(?:flows|testkit|emails)/;
@@ -180971,7 +181193,7 @@ async function loadFlowDefault(args) {
     depsRoot = ""
   } = args;
   if (bundleFlow === undefined) {
-    registerFlowModuleResolver();
+    await registerFlowLoader();
     return importDefaultExport(pathToFileURL(flowPath).href, flowPath);
   }
   const code = await bundleFlow(flowPath, depsRoot);
@@ -181180,6 +181402,7 @@ async function runAndroidFlow({
     callback: async (flowDeps) => {
       const androidDeps = {
         ...Object.fromEntries(unsupportedAndroidDepNames.map((name) => [name, notSupported(name)])),
+        ...deps.flowRuntimeDeps,
         inputs: flowDeps.flowInputs,
         workflowInputs: flowDeps.flowInputs,
         setOutput: flowDeps.setOutput,
@@ -181390,6 +181613,7 @@ async function runWebFlow({
     callback: async (flowDeps) => {
       const webDeps = {
         ...Object.fromEntries(unsupportedWebDepNames.map((name) => [name, notSupported(name)])),
+        ...deps.flowRuntimeDeps,
         launch,
         launchWithGpu: launch,
         isGpuAvailable: () => false,
@@ -181423,14 +181647,14 @@ async function runWebFlow({
 
 // src/shell/embeddedWorkerCli.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename as basename6, join as join31 } from "node:path";
+import { basename as basename6, join as join32 } from "node:path";
 var embeddedCliPathEnv = "QAWOLF_EMBEDDED_CLI_PATH";
 function extractEmbeddedWorkerCli() {
   const assetPath = process.env[embeddedCliPathEnv];
   if (assetPath === undefined || assetPath === "")
     return;
-  const dir = join31(getDataDir(), "worker");
-  const dest = join31(dir, basename6(assetPath));
+  const dir = join32(getDataDir(), "worker");
+  const dest = join32(dir, basename6(assetPath));
   if (existsSync3(dest))
     return dest;
   mkdirSync2(dir, { recursive: true });
@@ -181675,6 +181899,12 @@ function createConsoleReporter(deps) {
       deps.stderr.write(`${formatted}
 
 `);
+      const missingPackage = extractMissingPackage(errStr);
+      if (missingPackage !== undefined) {
+        deps.stderr.write(`${styleText3("yellow", `${indent}${runnerMessages.moduleNotFoundHint(missingPackage, deps.projectDir)}`)}
+
+`);
+      }
       const counts = tests.total > 0 ? `${tests.passed}/${tests.total} tests ` : "";
       deps.stdout.write(`  ${styleText3("red", "✗")} ${counts}passed ${styleText3("dim", fmtDuration(durationMs))}
 `);
@@ -181727,7 +181957,7 @@ function createCompositeReporter(reporters) {
   };
 }
 // src/shell/reporter/createJUnitReporter.ts
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 
 // src/shell/reporter/junitXml.ts
 function escapeXml(str) {
@@ -181766,7 +181996,7 @@ ${suites}`;
 
 // src/shell/reporter/createJUnitReporter.ts
 function resolveJUnitOutputPath(junit, outputDir) {
-  return typeof junit === "string" && junit.trim() !== "" ? junit : join32(outputDir, "junit-report.xml");
+  return typeof junit === "string" && junit.trim() !== "" ? junit : join33(outputDir, "junit-report.xml");
 }
 function createJUnitReporter(deps) {
   const flows = [];
@@ -181795,7 +182025,11 @@ function createJUnitReporter(deps) {
 function buildRunReporter(flags, deps) {
   const stdout2 = deps.stdout ?? process.stdout;
   const stderr = deps.stderr ?? process.stderr;
-  const console2 = createConsoleReporter({ stdout: stdout2, stderr });
+  const console2 = createConsoleReporter({
+    stdout: stdout2,
+    stderr,
+    ...deps.projectDir !== undefined ? { projectDir: deps.projectDir } : {}
+  });
   if (flags.junit === undefined)
     return console2;
   const junit = createJUnitReporter({
@@ -181811,7 +182045,15 @@ function buildRunReporter(flags, deps) {
 
 // src/commands/flows/buildFlowsRunDeps.ts
 function buildFlowsRunDeps(args) {
-  const { ctx, resolvedDir, android, runWebFlowDeps, flags } = args;
+  const {
+    ctx,
+    resolvedDir,
+    android,
+    runWebFlowDeps,
+    flowRuntimeDeps,
+    flags,
+    projectDir
+  } = args;
   return {
     peekFlowMeta: makePeekFlowMeta(ctx.fs),
     installBrowsers: (innerCtx, browsers) => installBrowserList(innerCtx, browsers, {
@@ -181820,9 +182062,9 @@ function buildFlowsRunDeps(args) {
       playwrightCliPath: resolvePlaywrightCli(resolvedDir, process.platform)
     }),
     runWebFlow,
-    runWebFlowDeps,
+    runWebFlowDeps: { ...runWebFlowDeps, flowRuntimeDeps },
     runAndroidFlow,
-    runAndroidFlowDeps: android.deps,
+    runAndroidFlowDeps: { ...android.deps, flowRuntimeDeps },
     bootAndroid: android.boot,
     shutdownAndroid: android.shutdown,
     createPooledDispatch: makePooledDispatch(resolvedDir),
@@ -181832,7 +182074,8 @@ function buildFlowsRunDeps(args) {
     reporter: buildRunReporter(flags, {
       fs: ctx.fs,
       stdout: { write: (text3) => ctx.ui.write(text3) },
-      stderr: { write: (text3) => ctx.ui.write(text3) }
+      stderr: { write: (text3) => ctx.ui.write(text3) },
+      ...projectDir !== undefined ? { projectDir } : {}
     }),
     now: () => Date.now()
   };
@@ -181840,11 +182083,11 @@ function buildFlowsRunDeps(args) {
 
 // src/commands/flows/loadEnvFile.ts
 import { readFile } from "node:fs/promises";
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 async function loadEnvFile(envDir) {
   let content;
   try {
-    content = await readFile(join33(envDir, ".env"), "utf8");
+    content = await readFile(join34(envDir, ".env"), "utf8");
   } catch (err) {
     if (isNoEntError(err))
       return;
@@ -181880,15 +182123,34 @@ async function runStagedFlows(args) {
     files,
     projectDir,
     depsRoot: runtimeEnv.depsRoot,
-    runRoot: runStagingRoot()
+    runRoot: runStagingRoot(),
+    onInstallStart: (depCount) => ctx.ui.info(runnerMessages.installingProjectDeps(depCount))
   });
+  if (staged.outerHop.mode === "install") {
+    const log31 = ctx.log("runner");
+    for (const candidate of staged.outerHop.rejected) {
+      log31.debug(runnerMessages.outerHopCandidateRejected(candidate.dir, candidate.missing));
+    }
+  }
   const unregisterCleanup = ctx.signals.register(staged.cleanup);
   try {
     const resolvedDir = runtimeEnv.depsRoot;
     await deps.configureTestkit(resolvedDir);
     const android = createAndroidDeps(resolvedDir, ctx.signals);
     const runWebFlowDeps = await deps.runWebFlowDeps(resolvedDir, ctx.signals);
-    return await deps.flowsRun(ctx, staged.files, flags, buildFlowsRunDeps({ ctx, resolvedDir, android, runWebFlowDeps, flags }));
+    const flowRuntimeDeps = await deps.createFlowRuntimeDeps({
+      envDir: resolvedDir,
+      ctx
+    });
+    return await deps.flowsRun(ctx, staged.files, flags, buildFlowsRunDeps({
+      ctx,
+      resolvedDir,
+      android,
+      runWebFlowDeps,
+      flowRuntimeDeps,
+      flags,
+      projectDir
+    }));
   } finally {
     unregisterCleanup();
     await staged.cleanup();
@@ -181903,6 +182165,7 @@ function makeDefaultDeps2(fs9) {
     prepareRunDir: (args) => prepareRunDir({ ...args, fs: fs9 }),
     configureTestkit,
     runWebFlowDeps: defaultRunWebFlowDeps,
+    createFlowRuntimeDeps,
     flowsRun
   };
 }
@@ -181924,7 +182187,7 @@ async function handleFlowsRun(ctx, pattern, flags, deps) {
 }
 
 // src/commands/flows/hybridRunDefaults.ts
-import { join as join34, resolve as resolve9 } from "node:path";
+import { join as join35, resolve as resolve9 } from "node:path";
 function makeDefaultHybridDeps(fs9) {
   return {
     expandPatterns: (patterns, cwd, logger) => expandPatterns(patterns, cwd, logger, fs9),
@@ -181933,7 +182196,8 @@ function makeDefaultHybridDeps(fs9) {
     prepareRunDir: (args) => prepareRunDir({ ...args, fs: fs9 }),
     configureTestkit,
     flowsRun,
-    runWebFlowDeps: defaultRunWebFlowDeps
+    runWebFlowDeps: defaultRunWebFlowDeps,
+    createFlowRuntimeDeps
   };
 }
 async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
@@ -181942,7 +182206,7 @@ async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
   if (validation !== "ok") {
     return { error: validation.error, exitCode: 2 };
   }
-  const envDir = resolve9(join34(".qawolf", flags.env));
+  const envDir = resolve9(join35(".qawolf", flags.env));
   const patternArgs = buildPatternArgs(pattern);
   const globFlows = () => resolvedDeps.expandPatterns(patternArgs, envDir, ctx.log("flows"));
   let files = await globFlows();
@@ -182015,7 +182279,16 @@ async function runWorker(signals) {
     if (input.flow.kind !== "web")
       throw new Error("worker subprocess currently supports web flows only");
     await configureTestkit(input.resolvedDir);
-    const runWebFlowDeps = await defaultRunWebFlowDeps(input.resolvedDir, signals);
+    const fs9 = makeDefaultFs();
+    const apiBaseUrl = process.env["QAWOLF_API_URL"]?.replace(/\/+$/, "") || "https://app.qawolf.com";
+    const flowRuntimeDeps = await createFlowRuntimeDeps({
+      envDir: input.resolvedDir,
+      ctx: { apiBaseUrl, configDir: getConfigDir(), fs: fs9 }
+    });
+    const runWebFlowDeps = {
+      ...await defaultRunWebFlowDeps(input.resolvedDir, signals),
+      flowRuntimeDeps
+    };
     const reporter = {};
     const deps = {
       peekFlowMeta: unavailable("peekFlowMeta"),
@@ -182073,7 +182346,7 @@ function registerFlowsCommand(program2, signals) {
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname12, join as join35, relative as relative7 } from "node:path";
+import { dirname as dirname12, join as join36, relative as relative7 } from "node:path";
 
 // src/domains/init/templates.ts
 var qawolfConfigTs = `export default {
@@ -182111,9 +182384,9 @@ function makeDefaultInitDeps() {
 async function handleInit(ctx, opts, deps = makeDefaultInitDeps()) {
   ctx.ui.gap();
   ctx.ui.intro(initMessages.title);
-  const configPath = join35(deps.cwd, "qawolf.config.ts");
-  const flowPath = join35(deps.cwd, "src", "flows", "example.flow.ts");
-  const gitignorePath = join35(deps.cwd, ".qawolf", ".gitignore");
+  const configPath = join36(deps.cwd, "qawolf.config.ts");
+  const flowPath = join36(deps.cwd, "src", "flows", "example.flow.ts");
+  const gitignorePath = join36(deps.cwd, ".qawolf", ".gitignore");
   await writeWithPrompt(ctx, configPath, qawolfConfigTs, opts.yes, deps);
   await writeWithPrompt(ctx, flowPath, exampleFlowTs, opts.yes, deps);
   await writeWithPrompt(ctx, gitignorePath, qawolfGitignore, opts.yes, deps);
@@ -182137,7 +182410,7 @@ async function writeWithPrompt(ctx, filePath, content, yes, deps) {
   ctx.ui.step(initMessages.createdFile(relPath));
 }
 async function ensurePackageJson(ctx, yes, deps) {
-  const pkgPath = join35(deps.cwd, "package.json");
+  const pkgPath = join36(deps.cwd, "package.json");
   if (!await deps.fs.pathExists(pkgPath)) {
     const confirmed2 = await ctx.ui.confirm(initMessages.createPackageJsonPrompt, { yes });
     if (!confirmed2.ok || !confirmed2.value) {
@@ -182196,19 +182469,19 @@ Examples:
 }
 
 // src/commands/install/android.ts
-import { join as join38 } from "node:path";
+import { join as join39 } from "node:path";
 
 // src/domains/install/android/index.ts
 import { parseExecutionTarget as parseExecutionTarget4 } from "@qawolf/flow-targets";
 
 // src/domains/install/android/avd.ts
-import { join as join36 } from "node:path";
+import { join as join37 } from "node:path";
 async function installAvds(ctx, specs, deps) {
   const versionResult = await deps.spawn(deps.sdkManagerPath, ["--version"]);
   if (versionResult.exitCode !== 0) {
     throw new Error(installMessages.android.sdkmanagerNotFound(deps.sdkManagerPath));
   }
-  const licenseFile = join36(deps.androidHome, "licenses", "android-sdk-license");
+  const licenseFile = join37(deps.androidHome, "licenses", "android-sdk-license");
   if (deps.checkExists(licenseFile)) {
     ctx.ui.info(installMessages.android.licensesAlreadyAccepted);
   } else {
@@ -182222,7 +182495,7 @@ async function installAvds(ctx, specs, deps) {
   for (const spec of specs) {
     if (installedImages.has(spec.systemImage))
       continue;
-    const systemImg = join36(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
+    const systemImg = join37(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
     if (deps.checkExists(systemImg)) {
       ctx.ui.info(installMessages.android.systemImageAlreadyInstalled(spec.systemImage));
       installedImages.add(spec.systemImage);
@@ -182270,9 +182543,9 @@ async function installAvds(ctx, specs, deps) {
 }
 
 // src/domains/install/android/driver.ts
-import { join as join37 } from "node:path";
+import { join as join38 } from "node:path";
 var appiumEnv = {
-  APPIUM_HOME: join37(envPaths("qawolf").data, "appium")
+  APPIUM_HOME: join38(envPaths("qawolf").data, "appium")
 };
 async function installUiautomator2Driver(ctx, deps) {
   const listResult = await deps.spawn(deps.appiumBinPath, ["driver", "list", "--installed"], { env: appiumEnv });
@@ -182359,8 +182632,8 @@ async function handleInstallAndroid(ctx, pattern, envDir) {
     arch: process.arch,
     androidHome: androidHome2,
     checkExists: (path9) => fs9.existsSync(path9),
-    sdkManagerPath: join38(androidHome2, "cmdline-tools", "latest", "bin", "sdkmanager"),
-    avdManagerPath: join38(androidHome2, "cmdline-tools", "latest", "bin", "avdmanager"),
+    sdkManagerPath: join39(androidHome2, "cmdline-tools", "latest", "bin", "sdkmanager"),
+    avdManagerPath: join39(androidHome2, "cmdline-tools", "latest", "bin", "avdmanager"),
     expandPatterns: (patterns, cwd) => expandPatterns(patterns, cwd ?? process.cwd(), undefined, fs9),
     peekFlowMeta: makePeekFlowMeta(fs9),
     resolveDepsRoot: async (files) => envDir ?? (await resolveDepsRoot({ files, fs: fs9 })).depsRoot,
@@ -182773,4 +183046,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=1EAFDAECED4A4A1164756E2164756E21
+//# debugId=2C8E0221ECEF946764756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -58,6 +58,7 @@
   "dependencies": {
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
+    "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
     "@qawolf/api-contracts": "0.1.0",
     "@qawolf/emails": "1.1.1",
@@ -91,7 +92,7 @@
     "typescript": "6.0.3"
   },
   "engines": {
-    "node": ">=22.15.0"
+    "node": ">=20.19.0"
   },
   "packageManager": "bun@1.3.13"
 }