@qawolf/cli 1.2.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;
@@ -134044,7 +134044,7 @@ var require_snapshot_utils = __commonJS((exports, module) => {
 // node_modules/undici/lib/mock/snapshot-recorder.js
 var require_snapshot_recorder = __commonJS((exports, module) => {
   var { writeFile, readFile, mkdir } = __require("node:fs/promises");
-  var { dirname: dirname10, resolve: resolve9 } = __require("node:path");
+  var { dirname: dirname11, resolve: resolve9 } = __require("node:path");
   var { setTimeout: setTimeout3, clearTimeout: clearTimeout2 } = __require("node:timers");
   var { InvalidArgumentError: InvalidArgumentError3, UndiciError } = require_errors6();
   var { hashId, isUrlExcludedFactory, normalizeHeaders, createHeaderFilters } = require_snapshot_utils();
@@ -134239,7 +134239,7 @@ var require_snapshot_recorder = __commonJS((exports, module) => {
         throw new InvalidArgumentError3("Snapshot path is required");
       }
       const resolvedPath = resolve9(path4);
-      await mkdir(dirname10(resolvedPath), { recursive: true });
+      await mkdir(dirname11(resolvedPath), { recursive: true });
       const data2 = Array.from(this.#snapshots.entries()).map(([hash2, snapshot]) => ({
         hash: hash2,
         snapshot
@@ -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: {
@@ -155273,6 +155273,10 @@ var flowsMessages = {
   title: "Flows",
   remoteTitle: "Remote Flows",
   flowCount: (count) => pluralize(count, "flow"),
+  list: {
+    remoteRequiresEnv: "--remote requires --env <env> to pick the environment to list",
+    flagsRequireRemote: "--env and --include-drafts require --remote"
+  },
   pull: {
     downloadingBundle: "Downloading flows bundle",
     fetchingEnvVars: "Fetching environment variables",
@@ -155622,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";
 
@@ -170022,7 +170035,8 @@ async function validateApiKey(deps) {
 }
 // src/shell/logger.ts
 var import_pino = __toESM(require_pino(), 1);
-import { join as join4 } from "node:path";
+import { mkdirSync as mkdirSync2, openSync } from "node:fs";
+import { dirname, join as join4 } from "node:path";
 function defaultLogPath() {
   return join4(envPaths("qawolf", { suffix: "" }).log, "cli.log");
 }
@@ -170036,7 +170050,8 @@ function resolveStderrLevel(env2, verbose) {
 }
 function createLoggingSystem(opts) {
   const { stderrLevel, logPath } = opts;
-  const dest = import_pino.default.destination({ dest: logPath, mkdir: true, sync: false });
+  mkdirSync2(dirname(logPath), { recursive: true });
+  const dest = import_pino.default.destination({ fd: openSync(logPath, "a"), sync: false });
   const fileLogger = import_pino.default({ level: "debug" }, dest);
   const levelNums = {
     trace: 10,
@@ -171158,45 +171173,6 @@ async function getIdentity(apiKey, deps) {
   return { ok: true, data: parsed.data };
 }
 
-// src/shell/platform/getRemoteFlows.ts
-var remoteFlowSchema = exports_external.object({
-  executionTarget: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]),
-  id: exports_external.string(),
-  name: exports_external.string(),
-  path: exports_external.string(),
-  tags: exports_external.array(exports_external.string())
-});
-var remoteFlowsResponseSchema = exports_external.object({
-  flows: exports_external.array(remoteFlowSchema)
-});
-async function getRemoteFlows(apiKey, deps) {
-  const url2 = `${deps.baseUrl}/api/v0/flows?includeDrafts=false`;
-  let response;
-  try {
-    response = await deps.fetch(url2, {
-      headers: { Authorization: `Bearer ${apiKey}` },
-      signal: AbortSignal.timeout(15000)
-    });
-  } catch (error51) {
-    return { ok: false, error: { kind: "network", cause: toError(error51) } };
-  }
-  if (!response.ok) {
-    const body = await response.text().catch(() => "");
-    return {
-      ok: false,
-      error: { kind: "http", status: response.status, body }
-    };
-  }
-  const json2 = await response.json().catch(() => {
-    return;
-  });
-  const parsed = remoteFlowsResponseSchema.safeParse(json2);
-  if (!parsed.success) {
-    return { ok: false, error: { kind: "parse", cause: parsed.error } };
-  }
-  return { ok: true, data: parsed.data };
-}
-
 // src/shell/platform/types.ts
 var environmentListItemSchema = exports_external.object({
   envId: exports_external.string(),
@@ -171250,10 +171226,10 @@ async function listTeamStorageFiles(trpc, args, deps) {
 }
 
 // src/shell/platform/teamStorageAssets.ts
-import { dirname as dirname2, join as join8 } from "node:path";
+import { dirname as dirname3, join as join8 } from "node:path";
 
 // src/shell/platform/teamStorageAssetManifest.ts
-import { dirname } from "node:path";
+import { dirname as dirname2 } from "node:path";
 var assetManifestSchema = exports_external.object({
   version: exports_external.literal(1),
   files: exports_external.array(exports_external.object({
@@ -171297,7 +171273,7 @@ async function writeAssetManifest(assetsAbs, files, fs2) {
     }))
   };
   const path2 = assetManifestPath(assetsAbs);
-  await fs2.mkdir(dirname(path2), { recursive: true });
+  await fs2.mkdir(dirname2(path2), { recursive: true });
   await fs2.writeFile(path2, `${JSON.stringify(manifest, undefined, 2)}
 `);
 }
@@ -171463,7 +171439,7 @@ async function writeAssetSnapshot(args) {
   await args.deps.fs.mkdir(args.tmpAssets, { recursive: true });
   for (const { file: file2, relativePath } of args.safeFiles) {
     const dest = join8(args.tmpAssets, relativePath);
-    await args.deps.fs.mkdir(dirname2(dest), { recursive: true });
+    await args.deps.fs.mkdir(dirname3(dest), { recursive: true });
     if (args.reusable.has(relativePath)) {
       await args.deps.fs.copyFile(join8(args.assetsAbs, relativePath), dest);
       continue;
@@ -171502,14 +171478,6 @@ function createPlatformClient(apiKey, deps) {
         sleep: deps.sleep
       });
     },
-    async getRemoteFlows() {
-      return requestWithRetry({
-        call: () => getRemoteFlows(apiKey, deps),
-        backoffMs: requestBackoffMs2,
-        describe: (err) => describeRequestError(err, deps.baseUrl, "flows"),
-        sleep: deps.sleep
-      });
-    },
     getFlowsBundleUrl: getFlowsBundleUrlImpl,
     callPublicApi: makeCallPublicApiMethod(trpc, deps, requestBackoffMs2),
     async getEnvVars(envId) {
@@ -173418,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, {
@@ -173630,7 +173598,7 @@ function registerAuthCommand(program2, signals) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.2.0",
+  version: "1.3.2",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -173690,16 +173658,17 @@ var package_default = {
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
-    "@qawolf/api-contracts": "0.1.0",
+    "@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",
@@ -174217,13 +174186,13 @@ function renderResults(ui, results) {
 }
 
 // src/domains/flows/ensureDeps.ts
-import { dirname as dirname3, join as join10 } from "node:path";
+import { dirname as dirname4, join as join10 } from "node:path";
 function findEnvDir(flowPath, fs2) {
-  let dir = dirname3(flowPath);
+  let dir = dirname4(flowPath);
   while (true) {
     if (fs2.existsSync(join10(dir, "package.json")))
       return dir;
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir)
       return;
     dir = parent;
@@ -174256,7 +174225,7 @@ import { fileURLToPath } from "url";
 
 // node_modules/fdir/dist/index.mjs
 import { createRequire as createRequire2 } from "module";
-import { basename, dirname as dirname4, normalize as normalize2, relative as relative2, resolve, sep as sep3 } from "path";
+import { basename, dirname as dirname5, normalize as normalize2, relative as relative2, resolve, sep as sep3 } from "path";
 import * as nativeFs from "fs";
 var __require2 = /* @__PURE__ */ createRequire2(import.meta.url);
 function cleanPath(path2) {
@@ -174420,7 +174389,7 @@ function build$2(options, isSynchronous) {
 function isRecursive(path2, resolved, state) {
   if (state.options.useRealPaths)
     return isRecursiveUsingRealPaths(resolved, state);
-  let parent = dirname4(path2);
+  let parent = dirname5(path2);
   let depth = 1;
   while (parent !== state.root && depth < 2) {
     const resolvedPath = state.symlinks.get(parent);
@@ -174428,7 +174397,7 @@ function isRecursive(path2, resolved, state) {
     if (isSameRoot)
       depth++;
     else
-      parent = dirname4(parent);
+      parent = dirname5(parent);
   }
   state.symlinks.set(path2, resolved);
   return depth > 1;
@@ -174624,7 +174593,7 @@ var Walker = class {
           } else {
             resolvedPath = useRealPaths ? resolvedPath : path2;
             const filename = basename(resolvedPath);
-            const directoryPath$1 = normalizePath(dirname4(resolvedPath), this.state.options);
+            const directoryPath$1 = normalizePath(dirname5(resolvedPath), this.state.options);
             resolvedPath = this.joinPath(filename, directoryPath$1);
             this.pushFile(resolvedPath, files, this.state.counts, filters);
           }
@@ -175173,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 = [
@@ -175192,7 +175162,8 @@ var pinnedPackages = [
   {
     name: "appium-uiautomator2-driver",
     version: appiumUiautomator2DriverVersion
-  }
+  },
+  { name: "expect-webdriverio", version: expectWebdriverioVersion }
 ];
 
 // src/domains/runtimeEnv/managedEnvDir.ts
@@ -175702,14 +175673,80 @@ function handleFlowsList(ctx, pattern) {
 
 // src/domains/flows/listRemote.ts
 var import_picomatch2 = __toESM(require_picomatch2(), 1);
-async function flowsListRemote(ctx, pattern) {
-  const result = await ctx.platform.getRemoteFlows();
+
+// node_modules/@qawolf/api-contracts/dist/v1/ids.js
+var defaultIdSchemas = {
+  environment: exports_external.string().min(1).describe("The id of the environment."),
+  flow: exports_external.string().min(1).describe("The id of the flow."),
+  run: exports_external.string().min(1).describe("The id of the run.")
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/flow/index.js
+var makeListFlowsContract = (ids) => {
+  const input = exports_external.object({
+    environmentId: ids.environment,
+    includeDrafts: exports_external.boolean().default(false).describe("Include draft flows in the listing.")
+  });
+  const executionTarget = exports_external.union([exports_external.string().min(1), exports_external.record(exports_external.string(), exports_external.unknown())]).describe("The target the flow executes against, as a preset or object.");
+  const output = exports_external.object({
+    flows: exports_external.array(exports_external.object({
+      executionTarget,
+      flowId: ids.flow,
+      name: exports_external.string(),
+      path: exports_external.string().describe("The flow file path, relative to the repo."),
+      tags: exports_external.array(exports_external.string())
+    }))
+  });
+  return {
+    description: "List the flows of an environment at its latest reconciled commit.",
+    input,
+    kind: "read",
+    name: "flow.list",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/run/index.js
+var makeCreateRunContract = (ids) => {
+  const input = exports_external.object({
+    environmentId: ids.environment,
+    environmentVariables: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+    flowIds: exports_external.array(ids.flow).min(1),
+    ignoreRules: exports_external.boolean().default(false)
+  });
+  const output = exports_external.object({ runId: ids.run });
+  return {
+    description: "Create a run for selected flows in an environment.",
+    input,
+    kind: "write",
+    name: "run.create",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/index.js
+var makeContractsV1 = (ids) => ({
+  flow: {
+    list: makeListFlowsContract(ids)
+  },
+  run: {
+    create: makeCreateRunContract(ids)
+  }
+});
+var publicContractsV1 = makeContractsV1(defaultIdSchemas);
+
+// src/domains/flows/listRemote.ts
+async function flowsListRemote(ctx, pattern, options) {
+  const result = await ctx.platform.callPublicApi(publicContractsV1.flow.list, {
+    environmentId: options.env,
+    includeDrafts: options.includeDrafts
+  });
   if (!result.ok) {
     return { error: result.error };
   }
   const matches = pattern ? import_picomatch2.default(pattern) : undefined;
   const items = result.value.flows.filter((f2) => !matches || matches(f2.path)).map((f2) => ({
-    id: f2.id,
+    flowId: f2.flowId,
     file: f2.path,
     name: f2.name,
     tags: f2.tags,
@@ -175739,7 +175776,7 @@ async function flowsListRemote(ctx, pattern) {
 }
 
 // src/domains/flows/pull/handler.ts
-import { dirname as dirname6, join as join23, resolve as resolve7 } from "node:path";
+import { dirname as dirname7, join as join23, resolve as resolve7 } from "node:path";
 
 // src/shell/manifest/io.ts
 import { createHash as createHash2 } from "node:crypto";
@@ -176130,7 +176167,7 @@ async function writeEnvFile(envDir, vars, fs2 = makeDefaultFs()) {
 }
 
 // src/domains/flows/pull/extract.ts
-import { dirname as dirname5, resolve as resolve6 } from "node:path";
+import { dirname as dirname6, resolve as resolve6 } from "node:path";
 import { createGunzip } from "node:zlib";
 
 // node_modules/tar/dist/esm/index.min.js
@@ -179394,7 +179431,7 @@ async function handleEntry(args) {
     total: args.getTotal()
   });
   args.addTotal(size);
-  args.fs.mkdirSync(dirname5(target), { recursive: true });
+  args.fs.mkdirSync(dirname6(target), { recursive: true });
   const chunks = [];
   await new Promise((res, rej) => {
     entry.on("data", (chunk) => chunks.push(chunk));
@@ -179498,7 +179535,7 @@ async function handleFlowsPull(ctx, opts, deps) {
     return { error: validation.error };
   }
   const destAbs = resolve7(opts.out ?? join23(".qawolf", opts.env));
-  const assetsAbs = join23(dirname6(destAbs), "assets");
+  const assetsAbs = join23(dirname7(destAbs), "assets");
   await resolvedDeps.fs.mkdir(assetsAbs, { recursive: true });
   const yes = opts.yes ?? false;
   let archive;
@@ -180034,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 dirname9, 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";
@@ -180075,7 +180112,10 @@ async function readPackageJson(pkgPath, fs3) {
 }
 
 // src/domains/runtimeEnv/innerHop.ts
-import { dirname as dirname7, join as join26 } from "node:path";
+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
 import { symlink } from "node:fs/promises";
@@ -180084,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(dirname7(target), { recursive: true });
+      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 dirname8, 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;
@@ -180112,28 +180162,33 @@ 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 });
     }
-    const parent = dirname8(dir);
+    const parent = dirname9(dir);
     if (parent === dir)
       return { satisfying: undefined, rejected };
     dir = parent;
@@ -180149,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 {};
   }
@@ -180167,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) {
@@ -180182,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 });
@@ -180195,6 +180250,7 @@ async function prepareRunDir(args) {
   const outerHop = await populateOuterHop({
     projectDir,
     runDir,
+    depsRoot,
     fs: fs3,
     ...args.onInstallStart !== undefined ? { onInstallStart: args.onInstallStart } : {}
   });
@@ -180221,38 +180277,38 @@ async function stageFlowFiles(args) {
   }
   if (files.length > 1) {
     return Promise.all(files.map(async (f3) => {
-      const dirHash = createHash3("sha256").update(dirname9(f3)).digest("hex").slice(0, 8);
-      const subDir = join28(execDir, dirHash);
+      const dirHash = createHash3("sha256").update(dirname10(f3)).digest("hex").slice(0, 8);
+      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 {
@@ -180309,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 {
@@ -180420,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";
@@ -180495,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();
@@ -180834,12 +180890,12 @@ Install Android Studio and open Tools > SDK Manager.`);
 }
 
 // src/shell/manifest/lookup.ts
-import { basename as basename5, dirname as dirname10, relative as relative6 } from "node:path";
+import { basename as basename5, dirname as dirname11, relative as relative6 } from "node:path";
 async function findFlowStamp(flowAbsPath) {
   let envDir;
-  let current = dirname10(flowAbsPath);
-  while (current !== dirname10(current)) {
-    const parent2 = dirname10(current);
+  let current = dirname11(flowAbsPath);
+  while (current !== dirname11(current)) {
+    const parent2 = dirname11(current);
     if (basename5(parent2) === ".qawolf") {
       envDir = current;
       break;
@@ -180914,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";
@@ -181260,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";
@@ -181359,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 },
@@ -181427,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"];
@@ -181441,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;
@@ -181449,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;
@@ -181486,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);
@@ -181495,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 {
@@ -181517,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) {
@@ -181525,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) {
@@ -181538,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,
@@ -181574,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 },
@@ -181583,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);
@@ -181594,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,
@@ -181636,28 +181756,29 @@ 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 mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename as basename6, join as join32 } from "node:path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+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;
-  mkdirSync2(dir, { recursive: true });
+  mkdirSync3(dir, { recursive: true });
   writeFileSync2(dest, readFileSync2(assetPath));
   return dest;
 }
@@ -181807,7 +181928,7 @@ function makePooledDispatch(resolvedDir) {
 }
 
 // src/commands/flows/buildRunReporter.ts
-import { dirname as dirname11 } from "node:path";
+import { dirname as dirname12 } from "node:path";
 
 // src/shell/reporter/createConsoleReporter.ts
 import { styleText as styleText3 } from "node:util";
@@ -181957,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) {
@@ -181996,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 = [];
@@ -182035,7 +182156,7 @@ function buildRunReporter(flags, deps) {
   const junit = createJUnitReporter({
     outputPath: resolveJUnitOutputPath(flags.junit, flags.outputDir),
     writeFile: (path9, content) => {
-      deps.fs.mkdirSync(dirname11(path9), { recursive: true });
+      deps.fs.mkdirSync(dirname12(path9), { recursive: true });
       deps.fs.writeFileSync(path9, content);
     },
     stderr
@@ -182083,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;
@@ -182187,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),
@@ -182206,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();
@@ -182280,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 }
@@ -182321,8 +182442,8 @@ var listExamples = `
 Examples:
   $ qawolf flows list
   $ qawolf flows list "flows/checkout/**"
-  $ qawolf flows list --remote
-  $ qawolf flows list "**/checkout/**" --remote`;
+  $ qawolf flows list --remote --env staging
+  $ qawolf flows list "**/checkout/**" --remote --env staging --include-drafts`;
 var pullExamples = `
 Examples:
   $ qawolf flows pull --env staging
@@ -182334,9 +182455,23 @@ function registerFlowsCommand(program2, signals) {
   registerRunWorkerCommand(flows, signals);
   declareCommandKind(flows.command("list [pattern]"), "local", {
     kindNote: "read with --remote"
-  }).description("List flows matching [pattern] from the local project, or from QA Wolf with --remote").option("--remote", "List flows from the QA Wolf platform instead of the local project", false).addHelpText("after", listExamples).action((pattern, opts, command) => {
+  }).description("List flows matching [pattern] from the local project, or from a QA Wolf environment with --remote").option("--remote", "List flows from the QA Wolf platform instead of the local project", false).option("--env <env>", "Environment to list flows from (required with --remote)").option("--include-drafts", "Include draft flows in the listing (requires --remote)", false).addHelpText("after", listExamples).action((pattern, opts, command) => {
     if (opts.remote) {
-      return withAuthContext(signals, (ctx) => flowsListRemote(ctx, pattern))(opts, command);
+      const env3 = opts.env;
+      if (env3 === undefined) {
+        return withContext(signals, async () => ({
+          error: flowsMessages.list.remoteRequiresEnv
+        }))(opts, command);
+      }
+      return withAuthContext(signals, (ctx) => flowsListRemote(ctx, pattern, {
+        env: env3,
+        includeDrafts: opts.includeDrafts
+      }))(opts, command);
+    }
+    if (opts.env !== undefined || opts.includeDrafts) {
+      return withContext(signals, async () => ({
+        error: flowsMessages.list.flagsRequireRemote
+      }))(opts, command);
     }
     return withContext(signals, (ctx) => handleFlowsList(ctx, pattern))(opts, command);
   });
@@ -182346,7 +182481,7 @@ function registerFlowsCommand(program2, signals) {
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname12, 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 {
@@ -182384,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);
@@ -182405,12 +182540,12 @@ async function writeWithPrompt(ctx, filePath, content, yes, deps) {
       return;
     }
   }
-  await deps.fs.mkdir(dirname12(filePath), { recursive: true });
+  await deps.fs.mkdir(dirname13(filePath), { recursive: true });
   await deps.fs.writeFile(filePath, content);
   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) {
@@ -182469,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 {
@@ -182495,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);
@@ -182543,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 });
@@ -182632,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,
@@ -182779,39 +182914,6 @@ Examples:
   });
 }
 
-// node_modules/@qawolf/api-contracts/dist/v1/ids.js
-var defaultIdSchemas = {
-  environment: exports_external.string().min(1).describe("The id of the environment."),
-  flow: exports_external.string().min(1).describe("The id of the flow."),
-  run: exports_external.string().min(1).describe("The id of the run.")
-};
-
-// node_modules/@qawolf/api-contracts/dist/v1/run/index.js
-var makeCreateRunContract = (ids) => {
-  const input = exports_external.object({
-    environmentId: ids.environment,
-    environmentVariables: exports_external.record(exports_external.string(), exports_external.string()).optional(),
-    flowIds: exports_external.array(ids.flow).min(1),
-    ignoreRules: exports_external.boolean().default(false)
-  });
-  const output = exports_external.object({ runId: ids.run });
-  return {
-    description: "Create a run for selected flows in an environment.",
-    input,
-    kind: "write",
-    name: "run.create",
-    output
-  };
-};
-
-// node_modules/@qawolf/api-contracts/dist/v1/index.js
-var makeContractsV1 = (ids) => ({
-  run: {
-    create: makeCreateRunContract(ids)
-  }
-});
-var publicContractsV1 = makeContractsV1(defaultIdSchemas);
-
 // src/core/publicApi/flagSpecs.ts
 var kebabCase = (field) => field.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
 function flagKind(schema) {
@@ -182908,8 +183010,16 @@ function buildSpec(contract, path9) {
     contract
   };
 }
-function buildCommandSpecs(tree) {
-  const walk3 = (node2, path9) => Object.entries(node2).flatMap(([key, value]) => isContract(value) ? [buildSpec(value, [...path9, key])] : walk3(value, [...path9, key]));
+function buildCommandSpecs(tree, options = {}) {
+  const skip = options.skipContractNames;
+  const walk3 = (node2, path9) => Object.entries(node2).flatMap(([key, value]) => {
+    const childPath = [...path9, key];
+    if (!isContract(value))
+      return walk3(value, childPath);
+    if (skip?.has(childPath.join(".")))
+      return [];
+    return [buildSpec(value, childPath)];
+  });
   return walk3(tree, []);
 }
 
@@ -182980,6 +183090,7 @@ async function handlePublicApiCommand(ctx, spec, options) {
 var groupDescriptions = {
   run: "Trigger and manage QA Wolf runs on the platform"
 };
+var handWrittenContractNames = new Set(["flow.list"]);
 function resolveGroup(parent2, segment) {
   const existing = parent2.commands.find((command) => command.name() === segment);
   return existing ?? parent2.command(segment).description(groupDescriptions[segment] ?? `QA Wolf public API ${segment} commands`);
@@ -183005,7 +183116,9 @@ function registerSpec(program2, signals, spec, authDeps) {
   command.action((options, leaf) => withAuthContext(signals, (ctx) => handlePublicApiCommand(ctx, spec, options), authDeps ?? {})(options, leaf));
 }
 function registerPublicApiCommands(program2, signals, options = {}) {
-  const specs = buildCommandSpecs(options.contracts ?? publicContractsV1);
+  const specs = buildCommandSpecs(options.contracts ?? publicContractsV1, {
+    skipContractNames: handWrittenContractNames
+  });
   for (const spec of specs) {
     registerSpec(program2, signals, spec, options.authDeps);
   }
@@ -183046,4 +183159,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=2C8E0221ECEF946764756E2164756E21
+//# debugId=724E44C8F9B9A9E264756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.2.0",
+  "version": "1.3.2",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -60,16 +60,17 @@
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
     "@playwright/test": "1.60.0",
-    "@qawolf/api-contracts": "0.1.0",
+    "@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`).
@@ -41,7 +46,7 @@ write on timeout: it may have reached the server the first time.
 | `qawolf auth logout`      | local                      | Remove stored credentials                                                                                              |
 | `qawolf auth whoami`      | read                       | Show authentication status                                                                                             |
 | `qawolf doctor`           | local                      | Diagnose problems running flows locally                                                                                |
-| `qawolf flows list`       | local (read with --remote) | List flows matching [pattern] from the local project, or from QA Wolf with --remote                                    |
+| `qawolf flows list`       | local (read with --remote) | List flows matching [pattern] from the local project, or from a QA Wolf environment with --remote                      |
 | `qawolf flows pull`       | read                       | Download an environment's flows into the local .qawolf/<env>/ cache                                                    |
 | `qawolf flows run`        | local (read with --env)    | Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment |
 | `qawolf init`             | local                      | Scaffold a QA Wolf project in the current directory                                                                    |