@qawolf/cli 1.3.0 → 1.3.2

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 join32(s3) {
+    BufferList.prototype.join = function join33(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 join32(s3) {
+    BufferList.prototype.join = function join33(s3) {
       if (this.length === 0)
         return "";
       var p3 = this.head;
@@ -155181,7 +155181,7 @@ var authMessages = {
       rejected403: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 403). Check that your API key has access to this environment.`,
       notFound404: (noun) => `QA Wolf API could not find ${noun ? `${noun} for that environment` : "that environment"} (HTTP 404). Check the --env value.`,
       failedWithStatus: (status, noun) => `QA Wolf API${noun ? ` ${noun}` : ""} request failed (HTTP ${status}).`,
-      networkUnreachable: (baseUrl, noun) => `Could not reach the QA Wolf API at ${baseUrl}${noun ? ` to fetch ${noun}` : ""}. Check your network connection and QAWOLF_API_URL.`,
+      networkUnreachable: (baseUrl, noun) => `Could not reach the QA Wolf API at ${baseUrl}${noun ? ` to fetch ${noun}` : ""}. Check your network connection and QAWOLF_HOST_URL.`,
       unexpectedResponse: (noun) => `Unexpected${noun ? ` ${noun}` : ""} response from the QA Wolf API.`
     },
     bundle: {
@@ -155626,6 +155626,15 @@ function makeDefaultFs() {
   };
 }
 
+// src/shell/resolveHostUrl.ts
+var defaultHostUrl = "https://app.qawolf.com";
+function resolveHostUrl(env2) {
+  const configuredHostUrl = env2["QAWOLF_HOST_URL"]?.trim();
+  if (!configuredHostUrl)
+    return defaultHostUrl;
+  return configuredHostUrl.replace(/\/+$/, "");
+}
+
 // src/domains/auth/resolve.ts
 import { Entry as Entry3 } from "@napi-rs/keyring";
 
@@ -173377,7 +173386,7 @@ function buildBaseContext(command, signals) {
     logPath: defaultLogPath(),
     ...verboseWrite ? { verboseWrite } : {}
   });
-  const apiBaseUrl = env2["QAWOLF_API_URL"]?.replace(/\/+$/, "") || "https://app.qawolf.com";
+  const apiBaseUrl = resolveHostUrl(env2);
   return {
     ctx: {
       ui: createUI(outputMode, {
@@ -173589,7 +173598,7 @@ function registerAuthCommand(program2, signals) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.3.0",
+  version: "1.3.2",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -173652,13 +173661,14 @@ var package_default = {
     "@qawolf/api-contracts": "0.2.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
-    "@qawolf/flows": "0.1.1",
+    "@qawolf/flows": "0.1.4",
     "@qawolf/testkit": "1.1.1",
     appium: "2.11.3",
     "appium-uiautomator2-driver": "3.7.0",
     "appium-xcuitest-driver": "9.10.5",
     commander: "14.0.3",
     "env-paths": "4.0.0",
+    "expect-webdriverio": "5.6.5",
     picomatch: "4.0.4",
     pino: "10.3.1",
     playwright: "1.58.2",
@@ -175132,13 +175142,14 @@ import { createHash } from "node:crypto";
 import { join as join12, resolve as resolve3 } from "node:path";
 
 // src/generated/dependencyVersions.ts
-var flowsVersion = "0.1.1";
+var flowsVersion = "0.1.4";
 var playwrightVersion = "1.58.2";
 var emailsVersion = "1.1.1";
 var testkitVersion = "1.1.1";
 var appiumVersion = "2.11.3";
 var appiumXcuitestDriverVersion = "9.10.5";
 var appiumUiautomator2DriverVersion = "3.7.0";
+var expectWebdriverioVersion = "5.6.5";
 
 // src/domains/runtimeEnv/pinnedPackages.ts
 var pinnedPackages = [
@@ -175151,7 +175162,8 @@ var pinnedPackages = [
   {
     name: "appium-uiautomator2-driver",
     version: appiumUiautomator2DriverVersion
-  }
+  },
+  { name: "expect-webdriverio", version: expectWebdriverioVersion }
 ];
 
 // src/domains/runtimeEnv/managedEnvDir.ts
@@ -180059,7 +180071,7 @@ async function defaultRunWebFlowDeps(cwd = process.cwd(), signals) {
 
 // src/domains/runtimeEnv/prepareRunDir.ts
 import { createHash as createHash3 } from "node:crypto";
-import { basename as basename4, dirname as dirname10, join as join28, resolve as resolve8, sep as sep4 } from "node:path";
+import { basename as basename4, dirname as dirname10, join as join29, resolve as resolve8, sep as sep4 } from "node:path";
 
 // src/shell/copyDir.ts
 import { cp, readdir as readdir2 } from "node:fs/promises";
@@ -180100,6 +180112,9 @@ async function readPackageJson(pkgPath, fs3) {
 }
 
 // src/domains/runtimeEnv/innerHop.ts
+import { join as join27 } from "node:path";
+
+// src/domains/runtimeEnv/linkPinnedPackages.ts
 import { dirname as dirname8, join as join26 } from "node:path";
 
 // src/domains/runtimeEnv/symlinkDir.ts
@@ -180109,25 +180124,35 @@ async function createDirSymlink(source, target) {
   await symlink(source, target, linkType);
 }
 
-// src/domains/runtimeEnv/innerHop.ts
-async function populateInnerHop(args) {
-  const { depsRoot, execDir, fs: fs3 } = args;
+// src/domains/runtimeEnv/linkPinnedPackages.ts
+async function linkPinnedPackages(args) {
+  const { depsRoot, nodeModulesDir, fs: fs3 } = args;
   const managedModules = join26(depsRoot, "node_modules");
-  const innerModules = join26(execDir, "node_modules");
-  await fs3.mkdir(innerModules, { recursive: true });
+  await fs3.mkdir(nodeModulesDir, { recursive: true });
   for (const { name } of pinnedPackages) {
     const segments = name.split("/");
-    const target = join26(innerModules, ...segments);
+    const target = join26(nodeModulesDir, ...segments);
     if (segments.length > 1) {
       await fs3.mkdir(dirname8(target), { recursive: true });
     }
+    await fs3.rm(target, { recursive: true, force: true });
     await createDirSymlink(join26(managedModules, ...segments), target);
   }
 }
 
+// src/domains/runtimeEnv/innerHop.ts
+async function populateInnerHop(args) {
+  const { depsRoot, execDir, fs: fs3 } = args;
+  await linkPinnedPackages({
+    depsRoot,
+    nodeModulesDir: join27(execDir, "node_modules"),
+    fs: fs3
+  });
+}
+
 // src/domains/runtimeEnv/outerHop.ts
 import { lstat } from "node:fs/promises";
-import { dirname as dirname9, join as join27 } from "node:path";
+import { dirname as dirname9, join as join28 } from "node:path";
 var executorPackageNames = new Set(pinnedPackages.map((p3) => p3.name));
 async function populateOuterHop(args) {
   const { projectDir, runDir, fs: fs3 } = args;
@@ -180137,23 +180162,28 @@ async function populateOuterHop(args) {
   const depNames = Object.keys(installableDeps);
   const { satisfying, rejected } = await findSatisfyingNodeModulesDir(projectDir, depNames, fs3);
   if (satisfying !== undefined) {
-    await createDirSymlink(satisfying, join27(runDir, "node_modules"));
+    await createDirSymlink(satisfying, join28(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);
+  await linkPinnedPackages({
+    depsRoot: args.depsRoot,
+    nodeModulesDir: join28(runDir, "node_modules"),
+    fs: fs3
+  });
   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 candidate = join28(dir, "node_modules");
     const stats = await lstatSafe(candidate);
     if (stats !== undefined && stats.isDirectory() && !stats.isSymbolicLink()) {
-      const missing = depNames.filter((name) => !fs3.existsSync(join27(candidate, name, "package.json")));
+      const missing = depNames.filter((name) => !fs3.existsSync(join28(candidate, name, "package.json")));
       if (missing.length === 0)
         return { satisfying: candidate, rejected };
       rejected.push({ dir: candidate, missing });
@@ -180174,7 +180204,7 @@ async function lstatSafe(path3) {
 async function readInstallableDeps(projectDir, fs3) {
   let content;
   try {
-    content = await fs3.readFile(join27(projectDir, "package.json"));
+    content = await fs3.readFile(join28(projectDir, "package.json"));
   } catch {
     return {};
   }
@@ -180192,8 +180222,8 @@ async function readInstallableDeps(projectDir, fs3) {
   return Object.fromEntries(Object.entries(rawDeps).filter(([name]) => !executorPackageNames.has(name)).filter((entry) => typeof entry[1] === "string"));
 }
 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/
+  await fs3.writeFile(join28(runDir, "package.json"), JSON.stringify({ name: "qawolf-run", private: true, dependencies: deps }, undefined, 2));
+  await fs3.writeFile(join28(runDir, ".npmrc"), `@qawolf:registry=https://registry.npmjs.org/
 `);
   const result = await install(runDir);
   if (result.exitCode !== 0) {
@@ -180207,10 +180237,10 @@ async function prepareRunDir(args) {
   const { files, projectDir, depsRoot, runRoot } = args;
   const fs3 = args.fs ?? makeDefaultFs();
   const runId = buildRunId(projectDir, files);
-  const runDir = join28(runRoot, runId);
+  const runDir = join29(runRoot, runId);
   await fs3.rm(runDir, { recursive: true, force: true });
   await fs3.mkdir(runDir, { recursive: true });
-  const execDir = join28(runDir, "exec");
+  const execDir = join29(runDir, "exec");
   await fs3.mkdir(execDir, { recursive: true });
   await populateInnerHop({ depsRoot, execDir, fs: fs3 });
   const stagedFiles = await stageFlowFiles({ files, projectDir, execDir, fs: fs3 });
@@ -180220,6 +180250,7 @@ async function prepareRunDir(args) {
   const outerHop = await populateOuterHop({
     projectDir,
     runDir,
+    depsRoot,
     fs: fs3,
     ...args.onInstallStart !== undefined ? { onInstallStart: args.onInstallStart } : {}
   });
@@ -180247,37 +180278,37 @@ async function stageFlowFiles(args) {
   if (files.length > 1) {
     return Promise.all(files.map(async (f3) => {
       const dirHash = createHash3("sha256").update(dirname10(f3)).digest("hex").slice(0, 8);
-      const subDir = join28(execDir, dirHash);
+      const subDir = join29(execDir, dirHash);
       await fs3.mkdir(subDir, { recursive: true });
-      const dest = join28(subDir, basename4(f3));
+      const dest = join29(subDir, basename4(f3));
       await fs3.copyFile(f3, dest);
       return dest;
     }));
   }
-  await Promise.all(files.map((f3) => fs3.copyFile(f3, join28(execDir, basename4(f3)))));
-  return files.map((f3) => join28(execDir, basename4(f3)));
+  await Promise.all(files.map((f3) => fs3.copyFile(f3, join29(execDir, basename4(f3)))));
+  return files.map((f3) => join29(execDir, basename4(f3)));
 }
 function remapPath(file2, projectDir, execDir) {
   if (file2 === projectDir)
     return execDir;
   if (file2.startsWith(projectDir + sep4)) {
-    return join28(execDir, file2.slice(projectDir.length + 1));
+    return join29(execDir, file2.slice(projectDir.length + 1));
   }
   return file2;
 }
 
 // src/shell/testkit.ts
-import { join as join29 } from "node:path";
+import { join as join30 } from "node:path";
 function notAvailableLocally(name) {
   throw new Error(runnerMessages.notAvailableLocally(name));
 }
 async function loadSdkDeps(cwd) {
-  const testkitDir = join29(cwd, "node_modules", "@qawolf", "testkit");
+  const testkitDir = join30(cwd, "node_modules", "@qawolf", "testkit");
   try {
     const clientMod = await import(resolveFromEnvDir(cwd, "@qawolf/testkit/client"));
     if (typeof clientMod.createTestkitClient !== "function")
       throw new Error("createTestkitClient is not a function");
-    const scopeMod = await import(join29(testkitDir, "dist", "clientScope.js"));
+    const scopeMod = await import(join30(testkitDir, "dist", "clientScope.js"));
     if (typeof scopeMod.configureTestkitClient !== "function")
       throw new Error("configureTestkitClient is not a function");
     return {
@@ -180334,9 +180365,9 @@ async function registerLazyEmailsClient(getInbox, cwd, deps) {
 }
 
 // src/commands/flows/envVarDeps.ts
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 function envFilePath(envDir) {
-  return join30(envDir, ".env");
+  return join31(envDir, ".env");
 }
 async function readEnv(envDir, fs3) {
   try {
@@ -180445,7 +180476,7 @@ async function createFlowRuntimeDeps({
 }
 
 // src/shell/appium/createAppiumServer.ts
-import { join as join31 } from "node:path";
+import { join as join32 } from "node:path";
 
 // src/shell/appium/spawnAppium.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -180520,7 +180551,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 ?? join31(envPaths("qawolf").data, "appium");
+  const appiumHome2 = params?.options?.appiumHome ?? join32(envPaths("qawolf").data, "appium");
   const timeoutMs3 = params?.options?.startTimeoutMs ?? defaultStartTimeoutMs;
   const bin = resolveAppiumBinFn(envDir);
   const port = await findFreePortFn();
@@ -180939,7 +180970,7 @@ function formatError2(browser, result) {
 }
 
 // src/domains/runner/runAndroidFlow.ts
-import path13 from "node:path";
+import path12 from "node:path";
 
 // src/shell/appium/createAndroidLaunchContext.ts
 import { writeFile } from "node:fs/promises";
@@ -181285,66 +181316,6 @@ function createRunner({
 }
 
 // src/domains/runner/runWebFlowUtils.ts
-import crypto from "node:crypto";
-import os6 from "node:os";
-import path12 from "node:path";
-function createLaunch({
-  browsers,
-  contextSetup,
-  launchBrowserOpts,
-  signals,
-  timeout,
-  traceMode = "off",
-  tracePath
-}) {
-  const openBrowsers = [];
-  const openContexts = [];
-  const tracingEnabled = traceMode !== "off";
-  let closed = false;
-  const closeAll = async () => {
-    if (closed)
-      return;
-    closed = true;
-    if (tracingEnabled && tracePath !== undefined) {
-      await Promise.allSettled(openContexts.map((c2) => c2.tracing.stop({ path: tracePath })));
-    }
-    await Promise.allSettled(openContexts.map((c2) => c2.close()));
-    await Promise.allSettled(openBrowsers.map((b4) => b4.close()));
-  };
-  const unregister = signals.register(closeAll);
-  const trackContext = async (ctx) => {
-    openContexts.push(ctx);
-    if (tracingEnabled) {
-      await ctx.tracing.start({ screenshots: true, snapshots: true });
-    }
-  };
-  const launch = async (launchOpts) => {
-    const browserName = normalizeBrowserName(launchOpts?.browser);
-    const bt2 = browsers[browserName];
-    if (launchOpts?.persistentContext === true) {
-      const userDataDir = launchOpts.userDataDir ?? path12.join(os6.tmpdir(), `qawolf-${crypto.randomUUID()}`);
-      const context2 = await bt2.launchPersistentContext(userDataDir, {
-        ...launchBrowserOpts,
-        ...contextSetup
-      });
-      context2.setDefaultTimeout(timeout);
-      await trackContext(context2);
-      const page = await context2.newPage();
-      return { browserType: browserName, context: context2, page };
-    }
-    const browser = await bt2.launch(launchBrowserOpts);
-    openBrowsers.push(browser);
-    const context = await browser.newContext(contextSetup);
-    context.setDefaultTimeout(timeout);
-    await trackContext(context);
-    return { browser, browserType: browserName, context };
-  };
-  const cleanup = async () => {
-    unregister();
-    await closeAll();
-  };
-  return { launch, cleanup };
-}
 function normalizeBrowserName(browser) {
   if (browser === "chrome" || browser === "msedge")
     return "chromium";
@@ -181384,7 +181355,7 @@ async function runAndroidFlow({
       throw new Error("runAndroidFlow: legacy flow functions are not supported; use flow() from @qawolf/flows/android");
     }
   } catch (err) {
-    const flowName2 = path13.basename(flowPath, path13.extname(flowPath));
+    const flowName2 = path12.basename(flowPath, path12.extname(flowPath));
     return {
       passed: false,
       testCounts: { passed: 0, total: 0 },
@@ -181452,13 +181423,13 @@ async function runAndroidFlow({
 }
 
 // src/domains/runner/runWebFlow.ts
-import path16 from "node:path";
+import path17 from "node:path";
 
 // src/domains/runner/initFlowRuntime.ts
-import path14 from "node:path";
+import path13 from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 async function runnerPathInDir(dir, fs9) {
-  const pkgPath = path14.join(dir, "node_modules", "@qawolf", "flows", "package.json");
+  const pkgPath = path13.join(dir, "node_modules", "@qawolf", "flows", "package.json");
   try {
     const pkg = JSON.parse(await fs9.readFile(pkgPath));
     const entry = pkg.exports?.["./_runner"];
@@ -181466,7 +181437,7 @@ async function runnerPathInDir(dir, fs9) {
     if (typeof importPath !== "string") {
       throw new Error(`@qawolf/flows at ${pkgPath} does not export "./_runner" with an "import" condition`);
     }
-    return path14.resolve(path14.dirname(pkgPath), importPath);
+    return path13.resolve(path13.dirname(pkgPath), importPath);
   } catch (err) {
     if (!isNoEntError(err))
       throw err;
@@ -181474,12 +181445,12 @@ async function runnerPathInDir(dir, fs9) {
   }
 }
 async function findFlowsRunnerPath(flowPath, fs9) {
-  let dir = path14.dirname(flowPath);
+  let dir = path13.dirname(flowPath);
   while (true) {
     const result = await runnerPathInDir(dir, fs9);
     if (result !== undefined)
       return result;
-    const parent2 = path14.dirname(dir);
+    const parent2 = path13.dirname(dir);
     if (parent2 === dir)
       throw new Error(`@qawolf/flows not found in node_modules above: ${flowPath}`);
     dir = parent2;
@@ -181511,7 +181482,7 @@ async function doInit(flowPath, timeout, fs9, depsRoot) {
   });
 }
 function initFlowRuntime(flowPath, options, fs9 = makeDefaultFs()) {
-  const startDir = path14.dirname(flowPath);
+  const startDir = path13.dirname(flowPath);
   let p3 = initCache.get(startDir);
   if (!p3) {
     p3 = doInit(flowPath, options.timeout, fs9, options.depsRoot);
@@ -181520,13 +181491,137 @@ function initFlowRuntime(flowPath, options, fs9 = makeDefaultFs()) {
   return p3;
 }
 
-// src/domains/runner/web/contextSetup.ts
+// src/domains/runner/createLaunch.ts
+import crypto from "node:crypto";
+import os6 from "node:os";
 import path15 from "node:path";
+
+// src/domains/runner/web/artifactPaths.ts
+import path14 from "node:path";
+function indexedArtifactPath(basePath, index2) {
+  if (index2 === 0)
+    return basePath;
+  const ext = path14.extname(basePath);
+  const base = path14.basename(basePath, ext);
+  return path14.join(path14.dirname(basePath), `${base}-${index2 + 1}${ext}`);
+}
+function createContextArtifacts(contextSetup, tracePath) {
+  let contextIndex = 0;
+  const harPaths = [];
+  const tracePaths = [];
+  const nextSetup = (overrides = {}) => {
+    const index2 = contextIndex;
+    contextIndex += 1;
+    const setup = { ...contextSetup, ...overrides };
+    if (contextSetup.recordHar !== undefined && overrides.recordHar === undefined) {
+      setup.recordHar = {
+        ...contextSetup.recordHar,
+        path: indexedArtifactPath(contextSetup.recordHar.path, index2)
+      };
+    }
+    if (setup.recordHar !== undefined)
+      harPaths.push(setup.recordHar.path);
+    return { setup, index: index2 };
+  };
+  const nextTracePath = (index2) => {
+    if (tracePath === undefined)
+      return;
+    const contextTracePath = indexedArtifactPath(tracePath, index2);
+    tracePaths.push(contextTracePath);
+    return contextTracePath;
+  };
+  const artifactPaths = () => ({
+    harPaths: [...harPaths],
+    tracePaths: [...tracePaths]
+  });
+  return { nextSetup, nextTracePath, artifactPaths };
+}
+
+// src/domains/runner/createLaunch.ts
+function createLaunch({
+  browsers,
+  contextSetup,
+  launchBrowserOpts,
+  signals,
+  timeout,
+  traceMode = "off",
+  tracePath
+}) {
+  const openBrowsers = [];
+  const openContexts = [];
+  const traceByContext = new Map;
+  const tracingEnabled = traceMode !== "off";
+  const { nextSetup, nextTracePath, artifactPaths } = createContextArtifacts(contextSetup, tracePath);
+  let closePromise;
+  const closeAll = () => {
+    closePromise ??= (async () => {
+      if (tracingEnabled) {
+        await Promise.allSettled(openContexts.map((c2) => {
+          const contextTracePath = traceByContext.get(c2);
+          return contextTracePath === undefined ? Promise.resolve() : c2.tracing.stop({ path: contextTracePath });
+        }));
+      }
+      await Promise.allSettled(openContexts.map((c2) => c2.close()));
+      await Promise.allSettled(openBrowsers.map((b4) => b4.close()));
+    })();
+    return closePromise;
+  };
+  const unregister = signals.register(closeAll);
+  const trackContext = async (ctx, index2) => {
+    openContexts.push(ctx);
+    if (tracingEnabled) {
+      const contextTracePath = nextTracePath(index2);
+      if (contextTracePath !== undefined) {
+        traceByContext.set(ctx, contextTracePath);
+      }
+      await ctx.tracing.start({ screenshots: true, snapshots: true });
+    }
+  };
+  const instrumentBrowser = (browser) => {
+    const originalNewContext = browser.newContext.bind(browser);
+    browser.newContext = async (opts) => {
+      const { setup, index: index2 } = nextSetup(opts);
+      const context = await originalNewContext(setup);
+      context.setDefaultTimeout(timeout);
+      await trackContext(context, index2);
+      return context;
+    };
+  };
+  const launch = async (launchOpts) => {
+    const browserName = normalizeBrowserName(launchOpts?.browser);
+    const bt2 = browsers[browserName];
+    if (launchOpts?.persistentContext === true) {
+      const userDataDir = launchOpts.userDataDir ?? path15.join(os6.tmpdir(), `qawolf-${crypto.randomUUID()}`);
+      const { setup, index: index2 } = nextSetup();
+      const context2 = await bt2.launchPersistentContext(userDataDir, {
+        ...launchBrowserOpts,
+        ...setup
+      });
+      context2.setDefaultTimeout(timeout);
+      await trackContext(context2, index2);
+      const page = await context2.newPage();
+      return { browserType: browserName, context: context2, page };
+    }
+    const browser = await bt2.launch(launchBrowserOpts);
+    openBrowsers.push(browser);
+    instrumentBrowser(browser);
+    const context = await browser.newContext({});
+    return { browser, browserType: browserName, context };
+  };
+  const cleanup = async () => {
+    unregister();
+    await closeAll();
+  };
+  return { launch, cleanup, artifactPaths };
+}
+
+// src/domains/runner/web/contextSetup.ts
+import path16 from "node:path";
 function harFlowPath(outputDir, flowName) {
-  return path15.join(outputDir, "har", `${flowName}.har`);
+  return path16.join(outputDir, "har", `${flowName}.har`);
 }
 function traceFlowPath(outputDir, flowName) {
-  return path15.join(outputDir, "trace", `${flowName}.zip`);
+  return path16.join(outputDir, "trace", `${flowName}.zip`);
 }
 function buildHarContextOpts(harPath, harContent) {
   return {
@@ -181542,7 +181637,7 @@ async function initHar(fs9, options, flowName) {
   if (harMode === "off")
     return { harMode, harPath: undefined };
   const harPath = harFlowPath(options.outputDir, flowName);
-  await fs9.mkdir(path15.dirname(harPath), { recursive: true });
+  await fs9.mkdir(path16.dirname(harPath), { recursive: true });
   return { harMode, harPath };
 }
 async function initTrace(fs9, options, flowName) {
@@ -181550,7 +181645,7 @@ async function initTrace(fs9, options, flowName) {
   if (traceMode === "off")
     return { traceMode, tracePath: undefined };
   const tracePath = traceFlowPath(options.outputDir, flowName);
-  await fs9.mkdir(path15.dirname(tracePath), { recursive: true });
+  await fs9.mkdir(path16.dirname(tracePath), { recursive: true });
   return { traceMode, tracePath };
 }
 async function maybeCleanupTrace(fs9, tracePath, passed, traceMode, warn) {
@@ -181563,7 +181658,7 @@ async function maybeCleanupTrace(fs9, tracePath, passed, traceMode, warn) {
   }
 }
 function buildContextSetup(videoSize, options, harPath) {
-  const videosDir = options.artifactDir ?? path15.join(options.outputDir, "videos");
+  const videosDir = options.artifactDir ?? path16.join(options.outputDir, "videos");
   const harOpts = harPath !== undefined ? buildHarContextOpts(harPath, options.harContent ?? "omit") : {};
   return options.video !== "off" ? {
     viewport: videoSize,
@@ -181599,7 +181694,7 @@ async function runWebFlow({
       depsRoot: deps.depsRoot
     });
   } catch (err) {
-    const flowName2 = path16.basename(flowPath, path16.extname(flowPath));
+    const flowName2 = path17.basename(flowPath, path17.extname(flowPath));
     return {
       passed: false,
       testCounts: { passed: 0, total: 0 },
@@ -181608,7 +181703,7 @@ async function runWebFlow({
     };
   }
   const isLegacy = typeof exported === "function";
-  const flowName = isLegacy ? path16.basename(flowPath, path16.extname(flowPath)) : exported.name;
+  const flowName = isLegacy ? path17.basename(flowPath, path17.extname(flowPath)) : exported.name;
   const runFn = isLegacy ? exported : exported.run;
   const { harMode, harPath } = await initHar(deps.fs, options, flowName);
   const { traceMode, tracePath } = await initTrace(deps.fs, options, flowName);
@@ -181619,7 +181714,7 @@ async function runWebFlow({
     slowMo: options.slowMo,
     ...options.executablePath !== undefined ? { executablePath: options.executablePath } : {}
   };
-  const { launch, cleanup } = createLaunch({
+  const { launch, cleanup, artifactPaths } = createLaunch({
     browsers: {
       chromium: deps.chromium,
       firefox: deps.firefox,
@@ -181661,25 +181756,26 @@ async function runWebFlow({
   } finally {
     await cleanup();
     const warn = (message) => deps.logger?.warn(message);
-    if (harPath !== undefined) {
-      await maybeCleanupHar(deps.fs, harPath, passed, harMode, warn);
+    const assigned = artifactPaths();
+    for (const contextHarPath of assigned.harPaths) {
+      await maybeCleanupHar(deps.fs, contextHarPath, passed, harMode, warn);
     }
-    if (tracePath !== undefined) {
-      await maybeCleanupTrace(deps.fs, tracePath, passed, traceMode, warn);
+    for (const contextTracePath of assigned.tracePaths) {
+      await maybeCleanupTrace(deps.fs, contextTracePath, passed, traceMode, warn);
     }
   }
 }
 
 // src/shell/embeddedWorkerCli.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename as basename6, join as join32 } from "node:path";
+import { basename as basename6, join as join33 } from "node:path";
 var embeddedCliPathEnv = "QAWOLF_EMBEDDED_CLI_PATH";
 function extractEmbeddedWorkerCli() {
   const assetPath = process.env[embeddedCliPathEnv];
   if (assetPath === undefined || assetPath === "")
     return;
-  const dir = join32(getDataDir(), "worker");
-  const dest = join32(dir, basename6(assetPath));
+  const dir = join33(getDataDir(), "worker");
+  const dest = join33(dir, basename6(assetPath));
   if (existsSync3(dest))
     return dest;
   mkdirSync3(dir, { recursive: true });
@@ -181982,7 +182078,7 @@ function createCompositeReporter(reporters) {
   };
 }
 // src/shell/reporter/createJUnitReporter.ts
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 
 // src/shell/reporter/junitXml.ts
 function escapeXml(str) {
@@ -182021,7 +182117,7 @@ ${suites}`;
 
 // src/shell/reporter/createJUnitReporter.ts
 function resolveJUnitOutputPath(junit, outputDir) {
-  return typeof junit === "string" && junit.trim() !== "" ? junit : join33(outputDir, "junit-report.xml");
+  return typeof junit === "string" && junit.trim() !== "" ? junit : join34(outputDir, "junit-report.xml");
 }
 function createJUnitReporter(deps) {
   const flows = [];
@@ -182108,11 +182204,11 @@ function buildFlowsRunDeps(args) {
 
 // src/commands/flows/loadEnvFile.ts
 import { readFile } from "node:fs/promises";
-import { join as join34 } from "node:path";
+import { join as join35 } from "node:path";
 async function loadEnvFile(envDir) {
   let content;
   try {
-    content = await readFile(join34(envDir, ".env"), "utf8");
+    content = await readFile(join35(envDir, ".env"), "utf8");
   } catch (err) {
     if (isNoEntError(err))
       return;
@@ -182212,7 +182308,7 @@ async function handleFlowsRun(ctx, pattern, flags, deps) {
 }
 
 // src/commands/flows/hybridRunDefaults.ts
-import { join as join35, resolve as resolve9 } from "node:path";
+import { join as join36, resolve as resolve9 } from "node:path";
 function makeDefaultHybridDeps(fs9) {
   return {
     expandPatterns: (patterns, cwd, logger) => expandPatterns(patterns, cwd, logger, fs9),
@@ -182231,7 +182327,7 @@ async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
   if (validation !== "ok") {
     return { error: validation.error, exitCode: 2 };
   }
-  const envDir = resolve9(join35(".qawolf", flags.env));
+  const envDir = resolve9(join36(".qawolf", flags.env));
   const patternArgs = buildPatternArgs(pattern);
   const globFlows = () => resolvedDeps.expandPatterns(patternArgs, envDir, ctx.log("flows"));
   let files = await globFlows();
@@ -182305,7 +182401,7 @@ async function runWorker(signals) {
       throw new Error("worker subprocess currently supports web flows only");
     await configureTestkit(input.resolvedDir);
     const fs9 = makeDefaultFs();
-    const apiBaseUrl = process.env["QAWOLF_API_URL"]?.replace(/\/+$/, "") || "https://app.qawolf.com";
+    const apiBaseUrl = resolveHostUrl(process.env);
     const flowRuntimeDeps = await createFlowRuntimeDeps({
       envDir: input.resolvedDir,
       ctx: { apiBaseUrl, configDir: getConfigDir(), fs: fs9 }
@@ -182385,7 +182481,7 @@ function registerFlowsCommand(program2, signals) {
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname13, join as join36, relative as relative7 } from "node:path";
+import { dirname as dirname13, join as join37, relative as relative7 } from "node:path";
 
 // src/domains/init/templates.ts
 var qawolfConfigTs = `export default {
@@ -182423,9 +182519,9 @@ function makeDefaultInitDeps() {
 async function handleInit(ctx, opts, deps = makeDefaultInitDeps()) {
   ctx.ui.gap();
   ctx.ui.intro(initMessages.title);
-  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");
+  const configPath = join37(deps.cwd, "qawolf.config.ts");
+  const flowPath = join37(deps.cwd, "src", "flows", "example.flow.ts");
+  const gitignorePath = join37(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);
@@ -182449,7 +182545,7 @@ async function writeWithPrompt(ctx, filePath, content, yes, deps) {
   ctx.ui.step(initMessages.createdFile(relPath));
 }
 async function ensurePackageJson(ctx, yes, deps) {
-  const pkgPath = join36(deps.cwd, "package.json");
+  const pkgPath = join37(deps.cwd, "package.json");
   if (!await deps.fs.pathExists(pkgPath)) {
     const confirmed2 = await ctx.ui.confirm(initMessages.createPackageJsonPrompt, { yes });
     if (!confirmed2.ok || !confirmed2.value) {
@@ -182508,19 +182604,19 @@ Examples:
 }
 
 // src/commands/install/android.ts
-import { join as join39 } from "node:path";
+import { join as join40 } 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 join37 } from "node:path";
+import { join as join38 } 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 = join37(deps.androidHome, "licenses", "android-sdk-license");
+  const licenseFile = join38(deps.androidHome, "licenses", "android-sdk-license");
   if (deps.checkExists(licenseFile)) {
     ctx.ui.info(installMessages.android.licensesAlreadyAccepted);
   } else {
@@ -182534,7 +182630,7 @@ async function installAvds(ctx, specs, deps) {
   for (const spec of specs) {
     if (installedImages.has(spec.systemImage))
       continue;
-    const systemImg = join37(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
+    const systemImg = join38(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
     if (deps.checkExists(systemImg)) {
       ctx.ui.info(installMessages.android.systemImageAlreadyInstalled(spec.systemImage));
       installedImages.add(spec.systemImage);
@@ -182582,9 +182678,9 @@ async function installAvds(ctx, specs, deps) {
 }
 
 // src/domains/install/android/driver.ts
-import { join as join38 } from "node:path";
+import { join as join39 } from "node:path";
 var appiumEnv = {
-  APPIUM_HOME: join38(envPaths("qawolf").data, "appium")
+  APPIUM_HOME: join39(envPaths("qawolf").data, "appium")
 };
 async function installUiautomator2Driver(ctx, deps) {
   const listResult = await deps.spawn(deps.appiumBinPath, ["driver", "list", "--installed"], { env: appiumEnv });
@@ -182671,8 +182767,8 @@ async function handleInstallAndroid(ctx, pattern, envDir) {
     arch: process.arch,
     androidHome: androidHome2,
     checkExists: (path9) => fs9.existsSync(path9),
-    sdkManagerPath: join39(androidHome2, "cmdline-tools", "latest", "bin", "sdkmanager"),
-    avdManagerPath: join39(androidHome2, "cmdline-tools", "latest", "bin", "avdmanager"),
+    sdkManagerPath: join40(androidHome2, "cmdline-tools", "latest", "bin", "sdkmanager"),
+    avdManagerPath: join40(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,
@@ -183063,4 +183159,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=64AB4032821CC8E864756E2164756E21
+//# debugId=724E44C8F9B9A9E264756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -63,13 +63,14 @@
     "@qawolf/api-contracts": "0.2.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
-    "@qawolf/flows": "0.1.1",
+    "@qawolf/flows": "0.1.4",
     "@qawolf/testkit": "1.1.1",
     "appium": "2.11.3",
     "appium-uiautomator2-driver": "3.7.0",
     "appium-xcuitest-driver": "9.10.5",
     "commander": "14.0.3",
     "env-paths": "4.0.0",
+    "expect-webdriverio": "5.6.5",
     "picomatch": "4.0.4",
     "pino": "10.3.1",
     "playwright": "1.58.2",

package/skills/qawolf-cli/SKILL.md

@@ -19,6 +19,11 @@ environment variable (or stored credentials from `qawolf auth login`).
 their table entry notes a flag that switches them to `read`.
 Verify with `qawolf auth whoami`. Never print or log the key.
 
+Commands use `https://app.qawolf.com` by default. Set `QAWOLF_HOST_URL` to
+target another deployment host, for example
+`https://app.staging.example.com`. `QAWOLF_API_URL` is a separate API endpoint
+and does not select the deployment host used by CLI commands.
+
 ## Output
 
 When consuming output programmatically, always pass `--json` (or `--agent`).