@qawolf/cli 1.30.0 → 1.31.0

package/dist/cli.js

@@ -8382,12 +8382,13 @@ function isTimeoutError(err) {
 }
 var missingPackagePattern = /Cannot find (?:package|module) '([^']+)'/;
 var pathLikeSpecifierPattern = /^(?:\.|\/|[A-Za-z]:[\\/])/;
-function extractMissingPackage(text) {
+var sourceFileSpecifierPattern = /\.(?:[cm]?[jt]sx?)$/;
+function extractMissingSpecifier(text) {
   const specifier = missingPackagePattern.exec(text)?.[1];
   if (specifier === undefined || pathLikeSpecifierPattern.test(specifier)) {
     return;
   }
-  return specifier;
+  return sourceFileSpecifierPattern.test(specifier) ? { kind: "path-alias", specifier } : { kind: "package", specifier };
 }
 
 // src/core/formatSeconds.ts
@@ -8435,7 +8436,14 @@ var authErrorMessages = {
     rejected401: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 401). Check your API key.`,
     rejected402: (noun) => `QA Wolf API refused the${noun ? ` ${noun}` : ""} request (HTTP 402): billing prevented it.`,
     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.`,
+    notFound404Environment: (noun) => `QA Wolf API could not find ${noun ? `${noun} for that environment` : "that environment"} (HTTP 404). Check the --env value.`,
+    notFound404Runner: (runnerId) => runnerId === undefined ? "That runner is not running (HTTP 404)." : `Runner ${runnerId} is not running (HTTP 404).`,
+    runnerIsGone: "It was never launched, or it has since been terminated or idled out.",
+    launchTheRunner: (runnerId) => runnerId === undefined ? "Launch one with qawolf runner launch --id <id>, or name a running one with --runner." : `Launch it with qawolf runner launch --id ${runnerId}, or send this to a different runner with --runner.`,
+    notFound404Run: (runId) => `QA Wolf has no run ${runId ?? "by that id"} on this team (HTTP 404).`,
+    runIdMayBeRunnerLocal: (runId) => `A run id printed by qawolf runner run belongs to that runner rather than to the platform, so this command cannot resolve it. Read that run with qawolf runner events run-status --run ${runId ?? "<id>"}.`,
+    notFound404Record: (noun, id) => `QA Wolf has no ${noun} ${id} (HTTP 404).`,
+    notFound404: (noun) => noun === undefined ? "QA Wolf found nothing matching the request (HTTP 404)." : `QA Wolf found nothing matching the ${noun} request (HTTP 404).`,
     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_HOST_URL.`,
     timedOut: (timeoutMs, noun) => `The QA Wolf API${noun ? ` ${noun}` : ""} request timed out after ${formatSeconds(timeoutMs)}. The work may still be finishing on the platform.`,
@@ -8888,7 +8896,14 @@ var lifecycleMessages = {
   terminated: (id) => `Terminated runner ${id}.`,
   runStopped: (id) => `Stopped the run on runner ${id}. The runner is still up, on whatever page the run reached.`,
   nothingToStop: (id) => `Runner ${id} had nothing to stop. The run had already finished, or none had been submitted.`,
-  runnerUnreachable: "The runner could not be reached. It may still be starting, or it may have terminated after inactivity. Retry, or launch it again."
+  runnerUnreachable: "The runner could not be reached. It may still be starting, or it may have terminated after inactivity. Retry, or launch it again.",
+  runnerIdCameFrom: (id, source) => ({
+    environment: `The id ${id} came from QAWOLF_RUNNER_ID.`,
+    flag: `The id ${id} came from --runner.`,
+    given: `The id ${id} is the one this call named.`,
+    launched: `Runner ${id} was launched for this command.`,
+    stored: `The id ${id} came from the runner this directory last launched, recorded in .qawolf.`
+  })[source]
 };
 
 // src/core/messages/interactiveRunner/list.ts
@@ -8987,7 +9002,9 @@ ${dir}`,
   ].join(`
 `),
   outerHopCarriedOver: (names) => `Carried over ${pluralize(names.length, "undeclared package")} from the project node_modules: ${listNames(names)}. Declare them in package.json "dependencies".`,
-  moduleNotFoundHint: (pkg, projectDir) => projectDir === undefined ? `Hint: '${pkg}' could not be resolved. Run from within your flows project so its dependencies can be found.` : `Hint: '${pkg}' could not be resolved. Ensure it is declared in ${projectDir}/package.json "dependencies" and run npm install in that project.`
+  moduleNotFoundHint: (pkg, projectDir) => projectDir === undefined ? `Hint: '${pkg}' could not be resolved. Run from within your flows project so its dependencies can be found.` : `Hint: '${pkg}' could not be resolved. Ensure it is declared in ${projectDir}/package.json "dependencies" and run npm install in that project.`,
+  tsconfigUnparsedNotice: (projectDir) => `Not resolving path aliases: ${projectDir}/tsconfig.json is not valid JSON. Comments and trailing commas are not supported, here or on the platform. Remove them so "compilerOptions.paths" can be read.`,
+  pathAliasNotFoundHint: (specifier, projectDir) => projectDir === undefined ? `Hint: '${specifier}' looks like a tsconfig path alias. Run from within your flows project so its tsconfig.json can be found.` : `Hint: '${specifier}' looks like a tsconfig path alias. Ensure "compilerOptions.paths" in ${projectDir}/tsconfig.json maps it to a file that exists.`
 };
 // src/core/messages/updateCheck.ts
 var updateCheckMessages = {
@@ -9111,7 +9128,8 @@ var exitCodes = {
   network: 4,
   config: 5,
   timeout: 6,
-  payment: 7
+  payment: 7,
+  notFound: 8
 };
 function exit(code, message, proc = process) {
   if (message !== undefined && message.length > 0) {
@@ -15110,6 +15128,47 @@ function createLoggingSystem(opts) {
   };
 }
 
+// src/core/publicApi/notFoundSubject.ts
+var runnerRoutesThatNameNoRunner = new Set([
+  "runner.launch",
+  "runner.list"
+]);
+var runRoutesThatResolveOneRun = new Set([
+  "run.diagnose",
+  "run.get",
+  "run.reattempt",
+  "run.stop"
+]);
+var recordFieldNouns = [
+  ["sessionId", "session"],
+  ["triggerId", "trigger"],
+  ["issueId", "issue"],
+  ["flowId", "flow"],
+  ["filePath", "file"]
+];
+function field(input, name) {
+  if (typeof input !== "object" || input === null)
+    return;
+  const value = input[name];
+  return typeof value === "string" ? value : undefined;
+}
+function notFoundSubject(contractName, input) {
+  if (contractName.startsWith("runner.") && !runnerRoutesThatNameNoRunner.has(contractName)) {
+    return { kind: "runner", runnerId: field(input, "id") };
+  }
+  if (runRoutesThatResolveOneRun.has(contractName)) {
+    return { kind: "run", runId: field(input, "runId") };
+  }
+  for (const [name, noun] of recordFieldNouns) {
+    const id = field(input, name);
+    if (id !== undefined)
+      return { id, kind: "record", noun };
+  }
+  if (field(input, "environmentId") !== undefined)
+    return { kind: "environment" };
+  return { kind: "other" };
+}
+
 // src/core/publicApi/flagKind.ts
 function flagKind(schema) {
   if (schema.type === "string")
@@ -15280,6 +15339,42 @@ function applyWorkspaceId(inputSchema, input, workspaceId) {
   return { ...input, workspaceId };
 }
 
+// src/shell/platform/describeNotFound.ts
+var m = authMessages.errors.request;
+var saysNothingMore = (reason) => /^(\w+ )*not ?found\.?$/i.test(reason.trim());
+function describeNotFound(subject, noun, reason) {
+  const explained = reason && !saysNothingMore(reason) ? reason : undefined;
+  const say = (own) => {
+    const body = [explained ? undefined : own.guess, own.guidance].filter((line) => line);
+    return {
+      error: explained ? `${explained} (HTTP 404)` : own.statement,
+      exitCode: exitCodes.notFound,
+      ...body.length > 0 ? { errorBody: body.join(`
+`) } : {}
+    };
+  };
+  switch (subject?.kind) {
+    case "runner":
+      return say({
+        guess: m.runnerIsGone,
+        guidance: m.launchTheRunner(subject.runnerId),
+        statement: m.notFound404Runner(subject.runnerId)
+      });
+    case "run":
+      return say({
+        guess: m.runIdMayBeRunnerLocal(subject.runId),
+        statement: m.notFound404Run(subject.runId)
+      });
+    case "record":
+      return say({ statement: m.notFound404Record(subject.noun, subject.id) });
+    case "other":
+      return say({ statement: m.notFound404(noun) });
+    case "environment":
+    case undefined:
+      return say({ statement: m.notFound404Environment(noun) });
+  }
+}
+
 // src/shell/platform/parseErrorBody.ts
 var defaultMaxLength = 1024;
 function asRecord(value) {
@@ -15322,69 +15417,69 @@ function clip(message, maxLength) {
 }
 
 // src/shell/platform/describeErrors.ts
-var m = authMessages.errors;
+var m2 = authMessages.errors;
 var inlineReasonMaxLength = 200;
 function describeIdentityError(err) {
   if (err.kind === "http") {
     if (err.status === 401 || err.status === 403) {
       return {
-        error: m.identity.invalidOrUnauthorized,
+        error: m2.identity.invalidOrUnauthorized,
         ...err.status === 401 ? { exitCode: exitCodes.auth } : {}
       };
     }
     return {
-      error: m.identity.couldNotVerify(parseErrorBody(err.body, inlineReasonMaxLength), err.status)
+      error: m2.identity.couldNotVerify(parseErrorBody(err.body, inlineReasonMaxLength), err.status)
     };
   }
   if (err.kind === "network") {
-    return { error: m.identity.couldNotVerifyNetwork(err.cause.message) };
+    return { error: m2.identity.couldNotVerifyNetwork(err.cause.message) };
   }
   if (err.kind === "timeout") {
-    return { error: m.identity.timedOut(err.timeoutMs) };
+    return { error: m2.identity.timedOut(err.timeoutMs) };
   }
-  return { error: m.identity.unexpectedFormat };
+  return { error: m2.identity.unexpectedFormat };
 }
-function describeRequestError(err, baseUrl, noun) {
+function describeRequestError(err, baseUrl, noun, notFound) {
   if (err.kind === "http") {
     const reason = parseErrorBody(err.body);
     const body = reason ? { errorBody: reason } : {};
     if (err.status === 401)
       return {
-        error: m.request.rejected401(noun),
+        error: m2.request.rejected401(noun),
         exitCode: exitCodes.auth,
         ...body
       };
     if (err.status === 402)
       return {
-        error: m.request.rejected402(noun),
+        error: m2.request.rejected402(noun),
         exitCode: exitCodes.payment,
         ...body
       };
     if (err.status === 403)
-      return { error: m.request.rejected403(noun), ...body };
+      return { error: m2.request.rejected403(noun), ...body };
     if (err.status === 404)
-      return { error: m.request.notFound404(noun), ...body };
-    return { error: m.request.failedWithStatus(err.status, noun), ...body };
+      return describeNotFound(notFound, noun, reason);
+    return { error: m2.request.failedWithStatus(err.status, noun), ...body };
   }
   if (err.kind === "network") {
-    return { error: m.request.networkUnreachable(baseUrl, noun) };
+    return { error: m2.request.networkUnreachable(baseUrl, noun) };
   }
   if (err.kind === "timeout") {
-    return { error: m.request.timedOut(err.timeoutMs, noun) };
+    return { error: m2.request.timedOut(err.timeoutMs, noun) };
   }
-  return { error: m.request.unexpectedResponse(noun) };
+  return { error: m2.request.unexpectedResponse(noun) };
 }
 function describeBundleDownloadError(err) {
   if (err.kind === "http") {
     if (err.status === 401 || err.status === 403)
-      return m.bundle.linkExpired;
-    return m.bundle.failedWithStatus(err.status);
+      return m2.bundle.linkExpired;
+    return m2.bundle.failedWithStatus(err.status);
   }
   if (err.kind === "network")
-    return m.bundle.networkUnreachable;
+    return m2.bundle.networkUnreachable;
   if (err.kind === "timeout")
-    return m.bundle.timedOut(err.timeoutMs);
-  return m.bundle.malformed;
+    return m2.bundle.timedOut(err.timeoutMs);
+  return m2.bundle.malformed;
 }
 function describeTeamStorageDownloadError(path, err) {
   if (err.kind === "http") {
@@ -15445,12 +15540,16 @@ function callPublicApi(trpc, contract, input, options) {
   return trpc.mutation(path, input, contract.output, options);
 }
 function makeCallPublicApiMethod(trpc, deps, readBackoffMs) {
-  return async (contract, input, options) => requestWithRetry({
-    call: () => callPublicApi(trpc, contract, applyWorkspaceId(contract.input, input, deps.workspaceId), options),
-    backoffMs: contract.kind === "read" ? readBackoffMs : [],
-    describe: (err) => describeRequestError(err, deps.baseUrl, contract.name),
-    sleep: deps.sleep
-  });
+  return async (contract, input, options) => {
+    const sent = applyWorkspaceId(contract.input, input, deps.workspaceId);
+    const subject = notFoundSubject(contract.name, sent);
+    return requestWithRetry({
+      call: () => callPublicApi(trpc, contract, sent, options),
+      backoffMs: contract.kind === "read" ? readBackoffMs : [],
+      describe: (err) => describeRequestError(err, deps.baseUrl, contract.name, subject),
+      sleep: deps.sleep
+    });
+  };
 }
 
 // node_modules/superjson/dist/double-indexed-kv.js
@@ -20095,7 +20194,7 @@ function p$1(l, e) {
 function g(l, e) {
   return (e.label ?? String(e.value)).toLowerCase().includes(l.toLowerCase());
 }
-function m2(l, e) {
+function m3(l, e) {
   if (e)
     return l ? e : e[0];
 }
@@ -20145,7 +20244,7 @@ var T$1 = class T extends V {
       this.userInput === "\t" && this._clearUserInput(), this._setUserInput(u, true), this.isNavigating = false;
       return;
     }
-    i || s ? (this.#e = findCursor(this.#e, i ? -1 : 1, this.filteredOptions), this.focusedValue = this.filteredOptions[this.#e]?.value, this.multiple || (this.selectedValues = [this.focusedValue]), this.isNavigating = true) : n ? this.value = m2(this.multiple, this.selectedValues) : this.multiple ? this.focusedValue !== undefined && (t.name === "tab" || this.isNavigating && t.name === "space") ? this.toggleSelected(this.focusedValue) : this.isNavigating = false : (this.focusedValue && (this.selectedValues = [this.focusedValue]), this.isNavigating = false);
+    i || s ? (this.#e = findCursor(this.#e, i ? -1 : 1, this.filteredOptions), this.focusedValue = this.filteredOptions[this.#e]?.value, this.multiple || (this.selectedValues = [this.focusedValue]), this.isNavigating = true) : n ? this.value = m3(this.multiple, this.selectedValues) : this.multiple ? this.focusedValue !== undefined && (t.name === "tab" || this.isNavigating && t.name === "space") ? this.toggleSelected(this.focusedValue) : this.isNavigating = false : (this.focusedValue && (this.selectedValues = [this.focusedValue]), this.isNavigating = false);
   }
   deselectAll() {
     this.selectedValues = [];
@@ -21466,7 +21565,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.30.0",
+  version: "1.31.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -21884,12 +21983,15 @@ async function followSession(ctx, options, deps) {
 
 // src/core/resolveId.ts
 async function resolveIdFrom(options) {
-  if (options.given !== undefined)
-    return options.given;
+  if (options.given !== undefined) {
+    return { id: options.given, source: "flag" };
+  }
   const fromEnvironment = options.env[options.environmentVariable]?.trim();
-  if (fromEnvironment)
-    return fromEnvironment;
-  return options.readStored();
+  if (fromEnvironment) {
+    return { id: fromEnvironment, source: "environment" };
+  }
+  const stored = await options.readStored();
+  return stored === undefined ? undefined : { id: stored, source: "stored" };
 }
 
 // src/domains/agent/resolveSessionId.ts
@@ -21901,12 +22003,12 @@ function chooseGivenSessionId(given) {
   }
   return { ok: true, sessionId: argument ?? flag };
 }
-var resolveSessionId = (session, deps) => resolveIdFrom({
+var resolveSessionId = async (session, deps) => (await resolveIdFrom({
   env: deps.env,
   environmentVariable: sessionIdEnvironmentVariable,
   given: session,
   readStored: deps.store.readLastSessionId
-});
+}))?.id;
 
 // src/domains/agent/get.ts
 function renderSession(ctx, session) {
@@ -27226,7 +27328,7 @@ var Jr = I.writev;
 var ht = Symbol("_autoClose");
 var H = Symbol("_close");
 var te = Symbol("_ended");
-var m3 = Symbol("_fd");
+var m4 = Symbol("_fd");
 var Ni = Symbol("_finished");
 var tt = Symbol("_flags");
 var Ai = Symbol("_flush");
@@ -27253,7 +27355,7 @@ var Me = Symbol("_defaultFlag");
 var bt = Symbol("_errored");
 var _t = class extends A2 {
   [bt] = false;
-  [m3];
+  [m4];
   [U2];
   [Ci];
   [j] = false;
@@ -27263,10 +27365,10 @@ var _t = class extends A2 {
   constructor(t, e) {
     if (e = e || {}, super(e), this.readable = true, this.writable = false, typeof t != "string")
       throw new TypeError("path must be a string");
-    this[bt] = false, this[m3] = typeof e.fd == "number" ? e.fd : undefined, this[U2] = t, this[Ci] = e.readSize || 16 * 1024 * 1024, this[j] = false, this[Fi] = typeof e.size == "number" ? e.size : 1 / 0, this[ee] = this[Fi], this[ht] = typeof e.autoClose == "boolean" ? e.autoClose : true, typeof this[m3] == "number" ? this[zt]() : this[at]();
+    this[bt] = false, this[m4] = typeof e.fd == "number" ? e.fd : undefined, this[U2] = t, this[Ci] = e.readSize || 16 * 1024 * 1024, this[j] = false, this[Fi] = typeof e.size == "number" ? e.size : 1 / 0, this[ee] = this[Fi], this[ht] = typeof e.autoClose == "boolean" ? e.autoClose : true, typeof this[m4] == "number" ? this[zt]() : this[at]();
   }
   get fd() {
-    return this[m3];
+    return this[m4];
   }
   get path() {
     return this[U2];
@@ -27281,7 +27383,7 @@ var _t = class extends A2 {
     I.open(this[U2], "r", (t, e) => this[Ht](t, e));
   }
   [Ht](t, e) {
-    t ? this[Ut](t) : (this[m3] = e, this.emit("open", e), this[zt]());
+    t ? this[Ut](t) : (this[m4] = e, this.emit("open", e), this[zt]());
   }
   [vi]() {
     return Buffer.allocUnsafe(Math.min(this[Ci], this[ee]));
@@ -27292,16 +27394,16 @@ var _t = class extends A2 {
       let t = this[vi]();
       if (t.length === 0)
         return process.nextTick(() => this[Ii](null, 0, t));
-      I.read(this[m3], t, 0, t.length, null, (e, i, r) => this[Ii](e, i, r));
+      I.read(this[m4], t, 0, t.length, null, (e, i, r) => this[Ii](e, i, r));
     }
   }
   [Ii](t, e, i) {
     this[j] = false, t ? this[Ut](t) : this[ki](e, i) && this[zt]();
   }
   [H]() {
-    if (this[ht] && typeof this[m3] == "number") {
-      let t = this[m3];
-      this[m3] = undefined, I.close(t, (e) => e ? this.emit("error", e) : this.emit("close"));
+    if (this[ht] && typeof this[m4] == "number") {
+      let t = this[m4];
+      this[m4] = undefined, I.close(t, (e) => e ? this.emit("error", e) : this.emit("close"));
     }
   }
   [Ut](t) {
@@ -27317,7 +27419,7 @@ var _t = class extends A2 {
       case "finish":
         return false;
       case "drain":
-        return typeof this[m3] == "number" && this[zt](), false;
+        return typeof this[m4] == "number" && this[zt](), false;
       case "error":
         return this[bt] ? false : (this[bt] = true, super.emit(t, ...e));
       default:
@@ -27340,7 +27442,7 @@ var Be = class extends _t {
       if (!this[j]) {
         this[j] = true;
         do {
-          let e = this[vi](), i = e.length === 0 ? 0 : I.readSync(this[m3], e, 0, e.length, null);
+          let e = this[vi](), i = e.length === 0 ? 0 : I.readSync(this[m4], e, 0, e.length, null);
           if (!this[ki](i, e))
             break;
         } while (true);
@@ -27352,9 +27454,9 @@ var Be = class extends _t {
     }
   }
   [H]() {
-    if (this[ht] && typeof this[m3] == "number") {
-      let t = this[m3];
-      this[m3] = undefined, I.closeSync(t), this.emit("close");
+    if (this[ht] && typeof this[m4] == "number") {
+      let t = this[m4];
+      this[m4] = undefined, I.closeSync(t), this.emit("close");
     }
   }
 };
@@ -27369,15 +27471,15 @@ var et = class extends Qr {
   [U2];
   [ie];
   [ht];
-  [m3];
+  [m4];
   [Me];
   [tt];
   [Ni] = false;
   [ot];
   constructor(t, e) {
-    e = e || {}, super(e), this[U2] = t, this[m3] = typeof e.fd == "number" ? e.fd : undefined, this[ie] = e.mode === undefined ? 438 : e.mode, this[ot] = typeof e.start == "number" ? e.start : undefined, this[ht] = typeof e.autoClose == "boolean" ? e.autoClose : true;
+    e = e || {}, super(e), this[U2] = t, this[m4] = typeof e.fd == "number" ? e.fd : undefined, this[ie] = e.mode === undefined ? 438 : e.mode, this[ot] = typeof e.start == "number" ? e.start : undefined, this[ht] = typeof e.autoClose == "boolean" ? e.autoClose : true;
     let i = this[ot] !== undefined ? "r+" : "w";
-    this[Me] = e.flags === undefined, this[tt] = e.flags === undefined ? i : e.flags, this[m3] === undefined && this[at]();
+    this[Me] = e.flags === undefined, this[tt] = e.flags === undefined ? i : e.flags, this[m4] === undefined && this[at]();
   }
   emit(t, ...e) {
     if (t === "error") {
@@ -27388,7 +27490,7 @@ var et = class extends Qr {
     return super.emit(t, ...e);
   }
   get fd() {
-    return this[m3];
+    return this[m4];
   }
   get path() {
     return this[U2];
@@ -27400,16 +27502,16 @@ var et = class extends Qr {
     I.open(this[U2], this[tt], this[ie], (t, e) => this[Ht](t, e));
   }
   [Ht](t, e) {
-    this[Me] && this[tt] === "r+" && t && t.code === "ENOENT" ? (this[tt] = "w", this[at]()) : t ? this[Ut](t) : (this[m3] = e, this.emit("open", e), this[gt] || this[Ai]());
+    this[Me] && this[tt] === "r+" && t && t.code === "ENOENT" ? (this[tt] = "w", this[at]()) : t ? this[Ut](t) : (this[m4] = e, this.emit("open", e), this[gt] || this[Ai]());
   }
   end(t, e) {
-    return t && this.write(t, e), this[te] = true, !this[gt] && !this[Y].length && typeof this[m3] == "number" && this[Pt](null, 0), this;
+    return t && this.write(t, e), this[te] = true, !this[gt] && !this[Y].length && typeof this[m4] == "number" && this[Pt](null, 0), this;
   }
   write(t, e) {
-    return typeof t == "string" && (t = Buffer.from(t, e)), this[te] ? (this.emit("error", new Error("write() after end()")), false) : this[m3] === undefined || this[gt] || this[Y].length ? (this[Y].push(t), this[ke] = true, false) : (this[gt] = true, this[ve](t), true);
+    return typeof t == "string" && (t = Buffer.from(t, e)), this[te] ? (this.emit("error", new Error("write() after end()")), false) : this[m4] === undefined || this[gt] || this[Y].length ? (this[Y].push(t), this[ke] = true, false) : (this[gt] = true, this[ve](t), true);
   }
   [ve](t) {
-    I.write(this[m3], t, 0, t.length, this[ot], (e, i) => this[Pt](e, i));
+    I.write(this[m4], t, 0, t.length, this[ot], (e, i) => this[Pt](e, i));
   }
   [Pt](t, e) {
     t ? this[Ut](t) : (this[ot] !== undefined && typeof e == "number" && (this[ot] += e), this[Y].length ? this[Ai]() : (this[gt] = false, this[te] && !this[Ni] ? (this[Ni] = true, this[H](), this.emit("finish")) : this[ke] && (this[ke] = false, this.emit("drain"))));
@@ -27421,13 +27523,13 @@ var et = class extends Qr {
       this[ve](this[Y].pop());
     else {
       let t = this[Y];
-      this[Y] = [], Jr(this[m3], t, this[ot], (e, i) => this[Pt](e, i));
+      this[Y] = [], Jr(this[m4], t, this[ot], (e, i) => this[Pt](e, i));
     }
   }
   [H]() {
-    if (this[ht] && typeof this[m3] == "number") {
-      let t = this[m3];
-      this[m3] = undefined, I.close(t, (e) => e ? this.emit("error", e) : this.emit("close"));
+    if (this[ht] && typeof this[m4] == "number") {
+      let t = this[m4];
+      this[m4] = undefined, I.close(t, (e) => e ? this.emit("error", e) : this.emit("close"));
     }
   }
 };
@@ -27447,15 +27549,15 @@ var Wt = class extends et {
     this[Ht](null, t);
   }
   [H]() {
-    if (this[ht] && typeof this[m3] == "number") {
-      let t = this[m3];
-      this[m3] = undefined, I.closeSync(t), this.emit("close");
+    if (this[ht] && typeof this[m4] == "number") {
+      let t = this[m4];
+      this[m4] = undefined, I.closeSync(t), this.emit("close");
     }
   }
   [ve](t) {
     let e = true;
     try {
-      this[Pt](null, I.writeSync(this[m3], t, 0, t.length, this[ot])), e = false;
+      this[Pt](null, I.writeSync(this[m4], t, 0, t.length, this[ot])), e = false;
     } finally {
       if (e)
         try {
@@ -30589,10 +30691,10 @@ async function resolveEnvChoice(args) {
 
 // src/core/flowFailureHint.ts
 function flowFailureHint(errText, projectDir) {
-  const missingPackage = extractMissingPackage(errText);
-  if (missingPackage === undefined)
+  const missing = extractMissingSpecifier(errText);
+  if (missing === undefined)
     return;
-  return runnerMessages.moduleNotFoundHint(missingPackage, projectDir);
+  return missing.kind === "path-alias" ? runnerMessages.pathAliasNotFoundHint(missing.specifier, projectDir) : runnerMessages.moduleNotFoundHint(missing.specifier, projectDir);
 }
 
 // src/shell/reporter/createCompositeReporter.ts
@@ -31127,7 +31229,7 @@ async function defaultRunWebFlowDeps(envDir = process.cwd(), signals) {
 
 // src/domains/runtimeEnv/prepareRunDir.ts
 import { createHash as createHash4 } from "node:crypto";
-import { join as join40, resolve as resolve9 } from "node:path";
+import { join as join41, resolve as resolve9 } from "node:path";
 
 // src/domains/runtimeEnv/execSubpathImports.ts
 import { join as join33 } from "node:path";
@@ -31354,16 +31456,266 @@ async function installOuterDeps(runDir, deps, fs, install) {
   }
 }
 
+// src/domains/runtimeEnv/rewriteStagedAliases.ts
+import { join as join38 } from "node:path";
+
+// src/core/aliasImports/rewriteAliasImports.ts
+import { posix as posix3 } from "node:path";
+
+// src/core/aliasImports/collectAliasSpecifiers.ts
+function isRelativeSpecifier(specifier) {
+  return specifier.startsWith("./") || specifier.startsWith("../");
+}
+function collectAliasSpecifiers(options) {
+  const { sourceFile, typescript: compiler } = options;
+  const specifiers = [];
+  const addCandidate = (literal) => {
+    if (isRelativeSpecifier(literal.text))
+      return;
+    specifiers.push({
+      end: literal.getEnd(),
+      specifier: literal.text,
+      start: literal.getStart(sourceFile)
+    });
+  };
+  for (const statement of sourceFile.statements) {
+    if (compiler.isImportDeclaration(statement)) {
+      const phase = statement.importClause?.phaseModifier;
+      if (phase === compiler.SyntaxKind.TypeKeyword)
+        continue;
+      if (compiler.isStringLiteral(statement.moduleSpecifier)) {
+        addCandidate(statement.moduleSpecifier);
+      }
+      continue;
+    }
+    if (compiler.isExportDeclaration(statement) && !statement.isTypeOnly) {
+      const { moduleSpecifier } = statement;
+      if (moduleSpecifier !== undefined && compiler.isStringLiteral(moduleSpecifier)) {
+        addCandidate(moduleSpecifier);
+      }
+    }
+  }
+  const visit = (node) => {
+    if (compiler.isCallExpression(node) && node.expression.kind === compiler.SyntaxKind.ImportKeyword) {
+      const [firstArgument] = node.arguments;
+      if (firstArgument !== undefined && (compiler.isStringLiteral(firstArgument) || compiler.isNoSubstitutionTemplateLiteral(firstArgument))) {
+        addCandidate(firstArgument);
+      }
+      return;
+    }
+    compiler.forEachChild(node, visit);
+  };
+  visit(sourceFile);
+  return specifiers;
+}
+
+// src/core/aliasImports/filePathVariants.ts
+var sourceExtensionPattern = /\.(js|ts)$/;
+var sourceExtensions2 = [".ts", ".js"];
+function filePathVariants(importPath) {
+  const hasSourceExtension = sourceExtensionPattern.test(importPath);
+  const base = importPath.replace(sourceExtensionPattern, "");
+  const siblings = sourceExtensions2.map((extension) => base + extension);
+  const indexes = hasSourceExtension ? [] : sourceExtensions2.map((extension) => `${base}/index${extension}`);
+  return [...new Set([importPath, ...siblings, ...indexes])];
+}
+
+// src/core/aliasImports/tsconfigPaths.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function isTsconfigPaths(value) {
+  return isRecord2(value) && Object.values(value).every((targets) => Array.isArray(targets) && targets.every((target) => typeof target === "string"));
+}
+function parseTsconfigContent(tsconfigContent) {
+  let parsed;
+  try {
+    parsed = JSON.parse(tsconfigContent);
+  } catch {
+    return { type: "unparseable" };
+  }
+  if (!isRecord2(parsed))
+    return { paths: undefined, type: "parsed" };
+  const compilerOptions = parsed["compilerOptions"];
+  if (!isRecord2(compilerOptions))
+    return { paths: undefined, type: "parsed" };
+  const paths = compilerOptions["paths"];
+  return {
+    paths: isTsconfigPaths(paths) ? paths : undefined,
+    type: "parsed"
+  };
+}
+function parseTsconfigPaths(tsconfigContent) {
+  const parsed = parseTsconfigContent(tsconfigContent);
+  return parsed.type === "parsed" ? parsed.paths : undefined;
+}
+function parseWildcardPattern(pattern) {
+  const wildcard = pattern.indexOf("*");
+  if (wildcard === -1 || wildcard !== pattern.lastIndexOf("*"))
+    return;
+  return {
+    prefix: pattern.slice(0, wildcard),
+    suffix: pattern.slice(wildcard + 1)
+  };
+}
+function matchesWildcard(importPath, { prefix, suffix }) {
+  return importPath.length >= prefix.length + suffix.length && importPath.startsWith(prefix) && importPath.endsWith(suffix);
+}
+function longestPrefixMatch(importPath, paths) {
+  return Object.entries(paths).flatMap(([pattern, targets]) => {
+    const parsed = parseWildcardPattern(pattern);
+    if (parsed === undefined || !matchesWildcard(importPath, parsed)) {
+      return [];
+    }
+    return [{ pattern: parsed, targets }];
+  }).reduce((best, candidate) => best === undefined || candidate.pattern.prefix.length > best.pattern.prefix.length ? candidate : best, undefined);
+}
+function resolvePathAlias(importPath, paths) {
+  if (paths === undefined)
+    return;
+  const [exactTarget] = paths[importPath] ?? [];
+  if (exactTarget !== undefined)
+    return exactTarget;
+  const match = longestPrefixMatch(importPath, paths);
+  if (match === undefined)
+    return;
+  const [target] = match.targets;
+  if (target === undefined)
+    return;
+  const substituted = importPath.slice(match.pattern.prefix.length, importPath.length - match.pattern.suffix.length);
+  return target.replace("*", substituted);
+}
+
+// src/core/aliasImports/rewriteAliasImports.ts
+function findTargetFilePath(options) {
+  return filePathVariants(posix3.normalize(options.aliasTarget)).find((candidate) => options.projectFilePaths.has(candidate));
+}
+function toRelativeSpecifier(options) {
+  const relativePath = posix3.relative(posix3.dirname(options.importingFilePath), options.targetFilePath);
+  return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+}
+function applyEdit(code, edit) {
+  const quote = code.slice(edit.start, edit.start + 1);
+  return code.slice(0, edit.start) + quote + edit.relativeSpecifier + quote + code.slice(edit.end);
+}
+function rewriteAliasImports(options) {
+  const { code, importingFilePath, projectFilePaths, tsconfigPaths } = options;
+  const compiler = options.typescript;
+  if (tsconfigPaths === undefined)
+    return code;
+  const sourceFile = compiler.createSourceFile(importingFilePath, code, compiler.ScriptTarget.Latest, true);
+  const edits = collectAliasSpecifiers({
+    sourceFile,
+    typescript: compiler
+  }).flatMap((candidate) => {
+    const aliasTarget = resolvePathAlias(candidate.specifier, tsconfigPaths);
+    if (aliasTarget === undefined)
+      return [];
+    const targetFilePath = findTargetFilePath({
+      aliasTarget,
+      projectFilePaths
+    });
+    if (targetFilePath === undefined)
+      return [];
+    return [
+      {
+        end: candidate.end,
+        relativeSpecifier: toRelativeSpecifier({
+          importingFilePath,
+          targetFilePath
+        }),
+        start: candidate.start
+      }
+    ];
+  });
+  return edits.sort((left, right) => right.start - left.start).reduce(applyEdit, code);
+}
+
+// src/domains/runtimeEnv/rewriteStagedAliases.ts
+var skippedDirs = new Set(["node_modules", ".git", ".qawolf"]);
+var sourceExtensions3 = [".ts", ".js"];
+async function rewriteStagedAliases(args) {
+  const tsconfig = await readStagedTsconfig(args);
+  if (tsconfig.type === "unparseable") {
+    args.onTsconfigUnparsed?.();
+    return [];
+  }
+  if (tsconfig.type === "absent" || tsconfig.paths === undefined)
+    return [];
+  const tsconfigPaths = tsconfig.paths;
+  const stagedPaths = await listStagedSourceFiles({
+    dir: args.execDir,
+    fs: args.fs,
+    prefix: ""
+  });
+  const projectFilePaths = new Set(stagedPaths);
+  const aliasPrefixes = Object.keys(tsconfigPaths).map((pattern) => pattern.split("*")[0] ?? pattern);
+  const mentionsAnAlias = (code) => aliasPrefixes.some((prefix) => code.includes(prefix));
+  const { default: typescript } = await import("typescript");
+  const rewriteOne = async (stagedPath) => {
+    const absolutePath = join38(args.execDir, stagedPath);
+    const code = await args.fs.readFile(absolutePath);
+    if (!mentionsAnAlias(code))
+      return;
+    const rewritten = rewriteAliasImports({
+      code,
+      importingFilePath: stagedPath,
+      projectFilePaths,
+      tsconfigPaths,
+      typescript
+    });
+    if (rewritten === code)
+      return;
+    await args.fs.writeFile(absolutePath, rewritten);
+    return stagedPath;
+  };
+  const rewrittenPaths = [];
+  for await (const stagedPath of batchMap(stagedPaths, rewriteOne, flowBatchSize)) {
+    if (stagedPath !== undefined)
+      rewrittenPaths.push(stagedPath);
+  }
+  return rewrittenPaths;
+}
+async function readStagedTsconfig(options) {
+  let content;
+  try {
+    content = await options.fs.readFile(join38(options.execDir, "tsconfig.json"));
+  } catch (err) {
+    if (isNoEntError(err))
+      return { type: "absent" };
+    throw err;
+  }
+  return parseTsconfigContent(content);
+}
+async function listStagedSourceFiles(options) {
+  const entries = await options.fs.readdirWithTypes(options.dir);
+  const nested = await Promise.all(entries.map(async (entry) => {
+    if (skippedDirs.has(entry.name))
+      return [];
+    const stagedPath = options.prefix === "" ? entry.name : `${options.prefix}/${entry.name}`;
+    if (entry.isDirectory()) {
+      return listStagedSourceFiles({
+        dir: join38(options.dir, entry.name),
+        fs: options.fs,
+        prefix: stagedPath
+      });
+    }
+    const isSource = sourceExtensions3.some((extension) => entry.name.endsWith(extension));
+    return entry.isFile() && isSource ? [stagedPath] : [];
+  }));
+  return nested.flat();
+}
+
 // src/domains/runtimeEnv/stageFlowFiles.ts
 import { createHash as createHash3 } from "node:crypto";
-import { basename as basename6, dirname as dirname12, join as join39, sep as sep4 } from "node:path";
+import { basename as basename6, dirname as dirname12, join as join40, sep as sep4 } from "node:path";
 
 // src/shell/copyDir.ts
 import { cp, readdir as readdir2 } from "node:fs/promises";
-import { basename as basename5, join as join38 } from "node:path";
+import { basename as basename5, join as join39 } from "node:path";
 async function copyDirExcluding(source, destination, excludedNames) {
   const entries = await readdir2(source, { withFileTypes: true });
-  await Promise.all(entries.filter((entry) => !excludedNames.has(entry.name)).map((entry) => cp(join38(source, entry.name), join38(destination, entry.name), {
+  await Promise.all(entries.filter((entry) => !excludedNames.has(entry.name)).map((entry) => cp(join39(source, entry.name), join39(destination, entry.name), {
     recursive: true,
     filter: (path) => !excludedNames.has(basename5(path))
   })));
@@ -31380,14 +31732,14 @@ async function stageFlowFiles(args) {
   if (files.length > 1) {
     return Promise.all(files.map((f) => stageOneFile(f, execDir, fs)));
   }
-  await Promise.all(files.map((f) => fs.copyFile(f, join39(execDir, basename6(f)))));
-  return files.map((f) => join39(execDir, basename6(f)));
+  await Promise.all(files.map((f) => fs.copyFile(f, join40(execDir, basename6(f)))));
+  return files.map((f) => join40(execDir, basename6(f)));
 }
 async function stageOneFile(file, execDir, fs) {
   const dirHash = createHash3("sha256").update(dirname12(file)).digest("hex").slice(0, 8);
-  const subDir = join39(execDir, dirHash);
+  const subDir = join40(execDir, dirHash);
   await fs.mkdir(subDir, { recursive: true });
-  const dest = join39(subDir, basename6(file));
+  const dest = join40(subDir, basename6(file));
   await fs.copyFile(file, dest);
   return dest;
 }
@@ -31395,7 +31747,7 @@ function remapPath(file, projectDir, execDir) {
   if (file === projectDir)
     return execDir;
   if (file.startsWith(projectDir + sep4)) {
-    return join39(execDir, file.slice(projectDir.length + 1));
+    return join40(execDir, file.slice(projectDir.length + 1));
   }
   return;
 }
@@ -31405,15 +31757,21 @@ async function prepareRunDir(args) {
   const { files, projectDir, depsRoot, runRoot } = args;
   const fs = args.fs ?? makeDefaultFs();
   const runId = buildRunId(projectDir, files);
-  const runDir = join40(runRoot, runId);
+  const runDir = join41(runRoot, runId);
   await fs.rm(runDir, { recursive: true, force: true });
   await fs.mkdir(runDir, { recursive: true });
-  const execDir = join40(runDir, "exec");
+  const execDir = join41(runDir, "exec");
   await fs.mkdir(execDir, { recursive: true });
   await populateInnerHop({ depsRoot, execDir, fs });
   const stagedFiles = await stageFlowFiles({ files, projectDir, execDir, fs });
   if (projectDir !== undefined) {
     await writeExecSubpathImports({ execDir, fs });
+    const onTsconfigUnparsed = args.onTsconfigUnparsed;
+    await rewriteStagedAliases({
+      execDir,
+      fs,
+      ...onTsconfigUnparsed !== undefined ? { onTsconfigUnparsed: () => onTsconfigUnparsed(projectDir) } : {}
+    });
   }
   const outerHop = await populateOuterHop({
     projectDir,
@@ -31439,17 +31797,17 @@ function buildRunId(projectDir, files) {
 }
 
 // src/shell/testkit.ts
-import { join as join41 } from "node:path";
+import { join as join42 } from "node:path";
 function notAvailableLocally(name) {
   throw new Error(runnerMessages.notAvailableLocally(name));
 }
 async function loadSdkDeps(cwd) {
-  const testkitDir = join41(cwd, "node_modules", "@qawolf", "testkit");
+  const testkitDir = join42(cwd, "node_modules", "@qawolf", "testkit");
   try {
     const clientMod = await importFromPath(resolveFromEnvDir(cwd, "@qawolf/testkit/client"));
     if (typeof clientMod.createTestkitClient !== "function")
       throw new Error("createTestkitClient is not a function");
-    const scopeMod = await importFromPath(join41(testkitDir, "dist", "clientScope.js"));
+    const scopeMod = await importFromPath(join42(testkitDir, "dist", "clientScope.js"));
     if (typeof scopeMod.configureTestkitClient !== "function")
       throw new Error("configureTestkitClient is not a function");
     return {
@@ -31507,9 +31865,9 @@ async function registerLazyEmailsClient(getInbox, cwd, deps) {
 }
 
 // src/commands/flows/envVarDeps.ts
-import { join as join42 } from "node:path";
+import { join as join43 } from "node:path";
 function envFilePath(envDir) {
-  return join42(envDir, ".env");
+  return join43(envDir, ".env");
 }
 async function readEnv(envDir, fs) {
   try {
@@ -31633,7 +31991,7 @@ async function selectRunByTag(args) {
 }
 
 // src/commands/flows/runStagedFlows.ts
-import { join as join46 } from "node:path";
+import { join as join47 } from "node:path";
 
 // src/shell/appium/createAppiumServer.ts
 import { existsSync as existsSync2 } from "node:fs";
@@ -32939,14 +33297,14 @@ async function runWebFlow({
 
 // src/shell/embeddedWorkerCli.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename as basename7, join as join43 } from "node:path";
+import { basename as basename7, join as join44 } from "node:path";
 var embeddedCliPathEnv = "QAWOLF_EMBEDDED_CLI_PATH";
 function extractEmbeddedWorkerCli() {
   const assetPath = process.env[embeddedCliPathEnv];
   if (assetPath === undefined || assetPath === "")
     return;
-  const dir = join43(getDataDir(), "worker");
-  const dest = join43(dir, basename7(assetPath));
+  const dir = join44(getDataDir(), "worker");
+  const dest = join44(dir, basename7(assetPath));
   if (existsSync3(dest))
     return dest;
   mkdirSync3(dir, { recursive: true });
@@ -33184,7 +33542,7 @@ ${styleText5("dim", "─".repeat(width))}
   };
 }
 // src/shell/reporter/createJUnitReporter.ts
-import { join as join44 } from "node:path";
+import { join as join45 } from "node:path";
 
 // src/shell/reporter/junitXml.ts
 function escapeXml(str) {
@@ -33223,7 +33581,7 @@ ${suites}`;
 
 // src/shell/reporter/createJUnitReporter.ts
 function resolveJUnitOutputPath(junit, outputDir) {
-  return typeof junit === "string" && junit.trim() !== "" ? junit : join44(outputDir, "junit-report.xml");
+  return typeof junit === "string" && junit.trim() !== "" ? junit : join45(outputDir, "junit-report.xml");
 }
 function createJUnitReporter(deps) {
   const flows = [];
@@ -33314,11 +33672,11 @@ function buildFlowsRunDeps(args) {
 
 // src/commands/flows/loadEnvFile.ts
 import { readFile } from "node:fs/promises";
-import { join as join45 } from "node:path";
+import { join as join46 } from "node:path";
 async function loadEnvFile(envDir) {
   let content;
   try {
-    content = await readFile(join45(envDir, ".env"), "utf8");
+    content = await readFile(join46(envDir, ".env"), "utf8");
   } catch (err) {
     if (isNoEntError(err))
       return;
@@ -33356,14 +33714,15 @@ async function runStagedFlows(args) {
     projectDir,
     depsRoot: runtimeEnv.depsRoot,
     runRoot: runStagingRoot(),
-    onInstallStart: (depCount) => ctx.ui.info(runnerMessages.installingProjectDeps(depCount))
+    onInstallStart: (depCount) => ctx.ui.info(runnerMessages.installingProjectDeps(depCount)),
+    onTsconfigUnparsed: (dir) => ctx.ui.warn(runnerMessages.tsconfigUnparsedNotice(dir))
   });
   if (staged.outerHop.mode === "install") {
     const log = ctx.log("runner");
     for (const candidate of staged.outerHop.rejected) {
       log.debug(runnerMessages.outerHopCandidateRejected(candidate.dir, candidate.missing));
     }
-    const ownModules = projectDir === undefined ? undefined : join46(projectDir, "node_modules");
+    const ownModules = projectDir === undefined ? undefined : join47(projectDir, "node_modules");
     const own = staged.outerHop.rejected.find((c) => c.dir === ownModules);
     if (own !== undefined) {
       ctx.ui.warn(runnerMessages.outerHopFallbackNotice(own.dir, own.missing));
@@ -33459,7 +33818,7 @@ async function chooseEnv(ctx, files, allEnvs) {
 }
 
 // src/commands/flows/hybridRunDefaults.ts
-import { join as join47, resolve as resolve10 } from "node:path";
+import { join as join48, resolve as resolve10 } from "node:path";
 
 // src/core/selectFlowFiles.ts
 function selectFlowFiles(args) {
@@ -33564,7 +33923,7 @@ async function handleHybridFlowsRun(ctx, pattern, flags, options = {}) {
   if (validation !== "ok") {
     return { error: validation.error, exitCode: 2 };
   }
-  const envDir = resolve10(join47(".qawolf", flags.env));
+  const envDir = resolve10(join48(".qawolf", flags.env));
   const patternArgs = buildPatternArgs(pattern);
   const globFlows = () => resolvedDeps.expandPatterns(patternArgs, envDir, ctx.log("flows"));
   let files = await globFlows();
@@ -33760,12 +34119,12 @@ function registerFlowsCommand(program, signals, deps = { withResolvedEnv }) {
 }
 
 // src/domains/init/init.ts
-import { dirname as dirname14, join as join49, relative as relative9 } from "node:path";
+import { dirname as dirname14, join as join50, relative as relative9 } from "node:path";
 
 // src/domains/init/ensurePackageJson.ts
-import { join as join48 } from "node:path";
+import { join as join49 } from "node:path";
 async function ensurePackageJson(ctx, yes, deps) {
-  const pkgPath = join48(deps.cwd, "package.json");
+  const pkgPath = join49(deps.cwd, "package.json");
   if (!await deps.fs.pathExists(pkgPath)) {
     const confirmed = await ctx.ui.confirm(initMessages.createPackageJsonPrompt, { yes });
     if (!confirmed.ok || !confirmed.value) {
@@ -33791,7 +34150,7 @@ async function ensurePackageJson(ctx, yes, deps) {
     ctx.ui.warn(initMessages.packageJsonInvalidJson);
     return;
   }
-  if (!isRecord2(parsed)) {
+  if (!isRecord3(parsed)) {
     ctx.ui.warn(initMessages.packageJsonNotAnObject);
     return;
   }
@@ -33842,14 +34201,14 @@ async function ensurePackageJson(ctx, yes, deps) {
     ctx.ui.warn(initMessages.typeChanged(label));
   }
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readSection(ctx, pkg, key) {
   const value = pkg[key];
   if (value === undefined)
     return {};
-  if (isRecord2(value))
+  if (isRecord3(value))
     return value;
   ctx.ui.warn(initMessages.packageJsonMalformedSection(key));
   return;
@@ -33891,9 +34250,9 @@ function makeDefaultInitDeps() {
 async function handleInit(ctx, opts, deps = makeDefaultInitDeps()) {
   ctx.ui.gap();
   ctx.ui.intro(initMessages.title);
-  const configPath = join49(deps.cwd, "qawolf.config.ts");
-  const flowPath = join49(deps.cwd, "src", "flows", "example.flow.ts");
-  const gitignorePath = join49(deps.cwd, ".qawolf", ".gitignore");
+  const configPath = join50(deps.cwd, "qawolf.config.ts");
+  const flowPath = join50(deps.cwd, "src", "flows", "example.flow.ts");
+  const gitignorePath = join50(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);
@@ -33928,7 +34287,7 @@ Examples:
 }
 
 // src/domains/install/android/avd.ts
-import { join as join50 } from "node:path";
+import { join as join51 } from "node:path";
 async function installAvds(ctx, specs, deps) {
   const sdkManagerPath = sdkManagerBin(deps.androidHome, deps.platform);
   const avdManagerPath = avdManagerBin(deps.androidHome, deps.platform);
@@ -33938,7 +34297,7 @@ async function installAvds(ctx, specs, deps) {
   if (versionResult.exitCode !== 0) {
     throw new Error(installMessages.android.sdkmanagerNotFound(sdkManagerPath));
   }
-  const licenseFile = join50(deps.androidHome, "licenses", "android-sdk-license");
+  const licenseFile = join51(deps.androidHome, "licenses", "android-sdk-license");
   if (deps.checkExists(licenseFile)) {
     ctx.ui.info(installMessages.android.licensesAlreadyAccepted);
   } else {
@@ -33953,7 +34312,7 @@ async function installAvds(ctx, specs, deps) {
   for (const spec of specs) {
     if (installedImages.has(spec.systemImage))
       continue;
-    const systemImg = join50(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
+    const systemImg = join51(deps.androidHome, ...spec.systemImage.split(";"), "system.img");
     if (deps.checkExists(systemImg)) {
       ctx.ui.info(installMessages.android.systemImageAlreadyInstalled(spec.systemImage));
       installedImages.add(spec.systemImage);
@@ -34394,14 +34753,14 @@ function parseKeyValueRecord(flag, pairs) {
   }
   return { ok: true, record };
 }
-var isRecord3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function setAtPath(input, path, value) {
   const leaf = path[path.length - 1];
   if (leaf === undefined)
     return;
   const target = path.slice(0, -1).reduce((node, segment) => {
     const existing = node[segment];
-    const next = isRecord3(existing) ? existing : {};
+    const next = isRecord4(existing) ? existing : {};
     node[segment] = next;
     return next;
   }, input);
@@ -34620,8 +34979,8 @@ var chooseRunnerId = (runner, deps) => resolveIdFrom({
 async function resolveRunner(ctx, options, deps) {
   const chosen = await chooseRunnerId(options.runner, deps);
   if (chosen !== undefined) {
-    const parsed = parseRunnerId(chosen);
-    return parsed.ok ? { runnerId: parsed.id, type: "resolved" } : {
+    const parsed = parseRunnerId(chosen.id);
+    return parsed.ok ? { runnerId: parsed.id, source: chosen.source, type: "resolved" } : {
       error: parsed.error,
       exitCode: exitCodes.invalidArgs,
       type: "failed"
@@ -34644,6 +35003,7 @@ async function resolveRunner(ctx, options, deps) {
   }
   return {
     runnerId: launched.value.id,
+    source: "launched",
     type: "launched",
     url: launched.value.url
   };
@@ -34654,6 +35014,21 @@ function announceRunner(ctx, resolved) {
   }
 }
 
+// src/domains/interactiveRunner/runnerRequestFailure.ts
+function runnerRequestFailure(failure, runner) {
+  const fields = failureFields(failure);
+  if (failure.exitCode !== exitCodes.notFound) {
+    return { ...fields, exitCode: failure.exitCode ?? exitCodes.network };
+  }
+  const cameFrom = interactiveRunnerMessages.runnerIdCameFrom(runner.runnerId, runner.source);
+  return {
+    ...fields,
+    errorBody: fields.errorBody ? `${fields.errorBody}
+${cameFrom}` : cameFrom,
+    exitCode: exitCodes.notFound
+  };
+}
+
 // src/core/interactiveRunner/runFiles.ts
 import { isAbsolute as isAbsolute5, relative as relative10, resolve as resolve11, sep as sep5 } from "node:path";
 function toCollectedPath(cwd, path) {
@@ -34765,10 +35140,7 @@ async function handleRunnerExec(ctx, options, deps) {
     ...scope.files === undefined ? {} : { files: scope.files }
   }, runnerCallOptions);
   if (!result.ok) {
-    return {
-      ...failureFields(result),
-      exitCode: result.exitCode ?? exitCodes.network
-    };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "failure") {
     return describeEvaluateSnippetFailure(result.value);
@@ -34791,7 +35163,7 @@ async function handleRunnerExec(ctx, options, deps) {
 }
 
 // src/shell/interactiveRunner/collectRunFiles.ts
-import { join as join52 } from "node:path";
+import { join as join53 } from "node:path";
 
 // src/core/interactiveRunner/getImports.ts
 function getImports(options) {
@@ -34830,46 +35202,7 @@ function isPathAlias(importPath, paths) {
 }
 
 // src/core/interactiveRunner/resolveImportPath.ts
-import { dirname as dirname15, join as join51, normalize as normalize3 } from "node:path/posix";
-
-// src/core/interactiveRunner/tsconfigPaths.ts
-function isRecord4(value) {
-  return typeof value === "object" && value !== null;
-}
-function isTsconfigPaths(value) {
-  return isRecord4(value) && Object.values(value).every((targets) => Array.isArray(targets) && targets.every((target) => typeof target === "string"));
-}
-function parseTsconfigPaths(tsconfigContent) {
-  let parsed;
-  try {
-    parsed = JSON.parse(tsconfigContent);
-  } catch {
-    return;
-  }
-  if (!isRecord4(parsed))
-    return;
-  const compilerOptions = parsed["compilerOptions"];
-  if (!isRecord4(compilerOptions))
-    return;
-  const paths = compilerOptions["paths"];
-  return isTsconfigPaths(paths) ? paths : undefined;
-}
-function resolvePathAlias(importPath, paths) {
-  if (paths === undefined)
-    return;
-  for (const [pattern, targets] of Object.entries(paths)) {
-    const prefix = pattern.replace("*", "");
-    if (!importPath.startsWith(prefix))
-      continue;
-    const [target] = targets;
-    if (target !== undefined) {
-      return target.replace("*", importPath.slice(prefix.length));
-    }
-  }
-  return;
-}
-
-// src/core/interactiveRunner/resolveImportPath.ts
+import { dirname as dirname15, join as join52, normalize as normalize3 } from "node:path/posix";
 var supportedExtensions = [".ts", ".js"];
 function candidatesForExplicitExtension(options) {
   const matching = supportedExtensions.find((extension) => options.importPath.endsWith(extension));
@@ -34883,7 +35216,7 @@ function candidatesForExplicitExtension(options) {
 }
 function resolveImportPath(options) {
   const aliasTarget = resolvePathAlias(options.importPath, options.tsconfigPaths);
-  const resolvedPath = aliasTarget === undefined ? normalize3(join51(dirname15(options.importingFilePath), options.importPath)) : normalize3(aliasTarget);
+  const resolvedPath = aliasTarget === undefined ? normalize3(join52(dirname15(options.importingFilePath), options.importPath)) : normalize3(aliasTarget);
   const hasExplicitExtension = supportedExtensions.some((extension) => options.importPath.endsWith(extension));
   const candidates = hasExplicitExtension ? candidatesForExplicitExtension({
     importPath: options.importPath,
@@ -34907,7 +35240,7 @@ function resolveImportPath(options) {
 var tsconfigPath = "tsconfig.json";
 async function collectRunFiles(options) {
   const held = await listShippablePaths(options);
-  const readFile = (path) => options.fs.readFile(join52(options.cwd, path));
+  const readFile = (path) => options.fs.readFile(join53(options.cwd, path));
   const tsconfigContent = held.has(tsconfigPath) ? await readFile(tsconfigPath).catch(() => {
     return;
   }) : undefined;
@@ -34990,7 +35323,7 @@ function makeRunnerId() {
 }
 
 // src/shell/interactiveRunner/runFilesManifest.ts
-import { join as join53 } from "node:path";
+import { join as join54 } from "node:path";
 var manifestFileName = "runner-files.json";
 var manifestSchema2 = object({
   files: array(object({ contentHash: string2(), path: string2() })),
@@ -34998,8 +35331,8 @@ var manifestSchema2 = object({
   version: literal(1)
 });
 function makeRunFilesManifestStore(options) {
-  const directory = join53(options.cwd, qawolfDir);
-  const path = join53(directory, manifestFileName);
+  const directory = join54(options.cwd, qawolfDir);
+  const path = join54(directory, manifestFileName);
   return {
     read: () => readJsonFile(options.fs, path, manifestSchema2),
     async write(manifest) {
@@ -35010,7 +35343,7 @@ function makeRunFilesManifestStore(options) {
 }
 
 // src/shell/interactiveRunner/runnerStore.ts
-import { join as join54 } from "node:path";
+import { join as join55 } from "node:path";
 var storeFileName2 = "runner.json";
 var runnersDirName = "runners";
 var storedRunnerSchema = object({
@@ -35021,10 +35354,10 @@ var storeSchema2 = object({
   defaultRunnerId: string2().optional()
 });
 function makeRunnerStore(options) {
-  const directory = join54(options.cwd, qawolfDir);
-  const path = join54(directory, storeFileName2);
-  const runnersDir = join54(directory, runnersDirName);
-  const runnerPath = (runnerId) => join54(runnersDir, `${encodeURIComponent(runnerId)}.json`);
+  const directory = join55(options.cwd, qawolfDir);
+  const path = join55(directory, storeFileName2);
+  const runnersDir = join55(directory, runnersDirName);
+  const runnerPath = (runnerId) => join55(runnersDir, `${encodeURIComponent(runnerId)}.json`);
   const writeAtomically = (target, contents) => writeJsonFileAtomically(options.fs, target, contents);
   const readDefaultRunnerId = async () => {
     const stored = await readJsonFile(options.fs, path, storeSchema2);
@@ -35050,7 +35383,7 @@ function makeRunnerStore(options) {
     },
     readDefaultRunnerId,
     async readRunners() {
-      const runners = await Promise.all((await readRunnerFileNames()).map((name) => readJsonFile(options.fs, join54(runnersDir, name), storedRunnerSchema)));
+      const runners = await Promise.all((await readRunnerFileNames()).map((name) => readJsonFile(options.fs, join55(runnersDir, name), storedRunnerSchema)));
       return runners.filter((runner) => !!runner).sort((left, right) => left.id.localeCompare(right.id));
     },
     async rememberLaunch(runner) {
@@ -35062,7 +35395,7 @@ function makeRunnerStore(options) {
       await Promise.all(runnerIds.map((runnerId) => options.fs.rm(runnerPath(runnerId), { force: true })));
       const names = await readRunnerFileNames();
       await Promise.all(names.map(async (name) => {
-        const runnerFile = join54(runnersDir, name);
+        const runnerFile = join55(runnersDir, name);
         const contents = await options.fs.readFile(runnerFile).catch(() => {
           return;
         });
@@ -35177,7 +35510,7 @@ async function handleRunnerHighlightSelector(ctx, options, deps) {
   const selector = options.selector ?? "";
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.highlightSelector, { id: resolved.runnerId, selector }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   const { outcome } = result.value;
   switch (outcome) {
@@ -35240,7 +35573,7 @@ function registerRunnerHighlightSelectorCommand(runner, signals) {
 }
 
 // src/domains/interactiveRunner/importPackage.ts
-import { join as join55 } from "node:path";
+import { join as join56 } from "node:path";
 
 // src/core/interactiveRunner/npmDependencies.ts
 var sectionsInPrecedenceOrder = ["dependencies", "devDependencies"];
@@ -35281,7 +35614,7 @@ function readNpmDependencies(packageJsonContent) {
 // src/domains/interactiveRunner/importPackage.ts
 var defaultPackageVersion = "latest";
 async function handleRunnerImportPackage(ctx, options, deps) {
-  const content = await deps.readFile(join55(deps.cwd, runPackageJsonPath)).catch(() => {
+  const content = await deps.readFile(join56(deps.cwd, runPackageJsonPath)).catch(() => {
     return;
   });
   if (content === undefined) {
@@ -35313,10 +35646,7 @@ async function handleRunnerImportPackage(ctx, options, deps) {
     packageVersion
   }, runnerCallOptions);
   if (!result.ok) {
-    return {
-      ...failureFields(result),
-      exitCode: result.exitCode ?? exitCodes.network
-    };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "failure") {
     const failure = result.value;
@@ -35383,7 +35713,7 @@ async function handleRunnerInspect(ctx, options, deps) {
   }
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.inspect, { id: resolved.runnerId, request: built.request }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "failure") {
     const failure = result.value;
@@ -35518,7 +35848,7 @@ async function handleRunnerInspectMobile(ctx, options, deps) {
   }
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.inspectMobile, { id: resolved.runnerId, request: built.request }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "success") {
     const value = result.value;
@@ -35810,14 +36140,11 @@ async function handleRunnerAct(ctx, options, deps) {
     ...options.screenshot === undefined ? {} : { withScreenshot: true }
   }, runnerCallOptions);
   if (!result.ok) {
-    const fields = failureFields(result);
-    return {
+    const fields = runnerRequestFailure(result, resolved);
+    return result.mayHaveArrived ? {
       ...fields,
-      ...result.mayHaveArrived ? {
-        error: appendSentence(fields.error, interactiveRunnerMessages.actionMayHaveHappened)
-      } : {},
-      exitCode: exitCodes.network
-    };
+      error: appendSentence(fields.error, interactiveRunnerMessages.actionMayHaveHappened)
+    } : fields;
   }
   const answer = result.value;
   if (answer.outcome === "success") {
@@ -35862,9 +36189,8 @@ async function handleRunnerScreenshot(ctx, options, deps) {
     };
   }
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.takeScreenshot, { id: resolved.runnerId }, runnerCallOptions);
-  if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
-  }
+  if (!result.ok)
+    return runnerRequestFailure(result, resolved);
   if (result.value.outcome === "success") {
     const written = await deps.writeScreenshot({
       imageJpegBase64: result.value.imageJpegBase64,
@@ -35969,20 +36295,16 @@ var unreachableFailure = {
   error: interactiveRunnerMessages.runnerUnreachable,
   exitCode: exitCodes.network
 };
-async function readJournal(ctx, runnerId, request) {
+async function readJournal(ctx, runner, request) {
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.readJournal, {
-    id: runnerId,
+    id: runner.runnerId,
     stream: request.stream,
     ...request.runId === undefined ? {} : { runId: request.runId },
     ...request.sinceSequence === undefined ? {} : { sinceSequence: request.sinceSequence },
     ...request.tail === undefined ? {} : { tail: request.tail }
   }, runnerCallOptions);
   if (!result.ok) {
-    return {
-      ...failureFields(result),
-      exitCode: exitCodes.network,
-      type: "failed"
-    };
+    return { ...runnerRequestFailure(result, runner), type: "failed" };
   }
   if (result.value.outcome === "failure") {
     result.value.failureReason;
@@ -35997,7 +36319,7 @@ async function handleRunnerKeepalive(ctx, options, deps) {
   if (resolved.type === "failed") {
     return { ...failureFields(resolved), exitCode: resolved.exitCode };
   }
-  const window = await readJournal(ctx, resolved.runnerId, {
+  const window = await readJournal(ctx, resolved, {
     stream: "run-status",
     tail: 1
   });
@@ -36106,7 +36428,7 @@ async function handleRunnerStopRun(ctx, options, deps) {
   }
   const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.stopRun, { id: resolved.runnerId }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "failure") {
     result.value.failureReason;
@@ -36129,7 +36451,7 @@ async function handleRunnerTerminate(ctx, options, deps) {
     id: resolved.runnerId
   }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   await deps.store.forgetRunner(resolved.runnerId).catch(() => {
     ctx.ui.warn(interactiveRunnerMessages.defaultNotForgotten(resolved.runnerId));
@@ -36177,7 +36499,7 @@ async function handleRunnerPromoteSnapshot(ctx, options, deps) {
     screenshotPath: options.screenshotPath
   }, runnerCallOptions);
   if (!result.ok) {
-    return { ...failureFields(result), exitCode: exitCodes.network };
+    return runnerRequestFailure(result, resolved);
   }
   if (result.value.outcome === "success") {
     ctx.ui.output(result.value, interactiveRunnerMessages.snapshotPromoted(options.screenshotPath, options.baselinePath));
@@ -36301,12 +36623,12 @@ function parseEventsOptions(options) {
 }
 
 // src/domains/interactiveRunner/journalCursor.ts
-function createJournalCursor(ctx, runnerId, request) {
+function createJournalCursor(ctx, runner, request) {
   let sinceSequence = request.sinceSequence;
   let tail = request.tail;
   let warnedUnsearchedHistory = false;
   return async function read() {
-    const window = await readJournal(ctx, runnerId, {
+    const window = await readJournal(ctx, runner, {
       ...request,
       sinceSequence,
       tail
@@ -36328,8 +36650,8 @@ function createJournalCursor(ctx, runnerId, request) {
     return { entries: window.value.entries, type: "entries" };
   };
 }
-function createPrintingCursor(ctx, runnerId, request, format) {
-  const read = createJournalCursor(ctx, runnerId, request);
+function createPrintingCursor(ctx, runner, request, format) {
+  const read = createJournalCursor(ctx, runner, request);
   return async () => {
     const window = await read();
     if (window.type !== "entries")
@@ -36370,7 +36692,7 @@ async function handleRunnerEvents(ctx, options, deps) {
   if (!known.includes(parsed.value.stream)) {
     ctx.ui.warn(interactiveRunnerMessages.unknownStream(parsed.value.stream, known));
   }
-  const read = createJournalCursor(ctx, resolved.runnerId, parsed.value);
+  const read = createJournalCursor(ctx, resolved, parsed.value);
   const unreachable = createUnreachableBudget(pollIntervalMs3);
   const maxPolls = Math.max(1, Math.ceil(timeout.seconds * 1000 / pollIntervalMs3));
   for (let poll = 1;; poll++) {
@@ -36426,12 +36748,12 @@ var anchorPollIntervalMs = 1000;
 async function resolveRecorderAnchor(ctx, resolved, deps) {
   if (resolved.type === "launched")
     return { ok: true, sinceSequence: 0 };
-  return anchorRecorderCursor(ctx, resolved.runnerId, deps);
+  return anchorRecorderCursor(ctx, resolved, deps);
 }
-async function anchorRecorderCursor(ctx, runnerId, deps) {
+async function anchorRecorderCursor(ctx, runner, deps) {
   const unreachable = createUnreachableBudget(anchorPollIntervalMs);
   for (;; ) {
-    const anchor = await readJournal(ctx, runnerId, {
+    const anchor = await readJournal(ctx, runner, {
       stream: "recorder",
       tail: 1
     });
@@ -36451,13 +36773,13 @@ function createFollowPrinters(ctx, options) {
   const jsonLine = (payload) => JSON.stringify(payload);
   const printers = [];
   if (options.logs) {
-    printers.push(createPrintingCursor(ctx, options.runnerId, { runId: options.runId, stream: "run-logs" }, formatRunLogLine));
+    printers.push(createPrintingCursor(ctx, options.runner, { runId: options.runId, stream: "run-logs" }, formatRunLogLine));
   }
   if (options.runEvents) {
-    printers.push(createPrintingCursor(ctx, options.runnerId, { runId: options.runId, stream: "run-events" }, jsonLine));
+    printers.push(createPrintingCursor(ctx, options.runner, { runId: options.runId, stream: "run-events" }, jsonLine));
   }
   if (options.recorderSinceSequence !== undefined) {
-    printers.push(createPrintingCursor(ctx, options.runnerId, { sinceSequence: options.recorderSinceSequence, stream: "recorder" }, jsonLine));
+    printers.push(createPrintingCursor(ctx, options.runner, { sinceSequence: options.recorderSinceSequence, stream: "recorder" }, jsonLine));
   }
   return printers;
 }
@@ -36476,7 +36798,7 @@ function reportSettlement2(ctx, settlement) {
 }
 async function followRun(ctx, options, deps) {
   const printers = createFollowPrinters(ctx, options);
-  const readStatus = createJournalCursor(ctx, options.runnerId, {
+  const readStatus = createJournalCursor(ctx, options.runner, {
     runId: options.runId,
     stream: "run-status"
   });
@@ -36523,7 +36845,7 @@ async function followRun(ctx, options, deps) {
     }
     if (poll >= maxPolls) {
       return {
-        error: interactiveRunnerMessages.followTimedOut(options.runId, options.runnerId, options.timeoutSeconds),
+        error: interactiveRunnerMessages.followTimedOut(options.runId, options.runner.runnerId, options.timeoutSeconds),
         exitCode: exitCodes.timeout
       };
     }
@@ -36731,10 +37053,7 @@ async function sendRunFlowRequest(ctx, options, delta) {
   }, runnerCallOptions);
   if (!result.ok) {
     return {
-      failure: {
-        ...failureFields(result),
-        exitCode: result.exitCode ?? exitCodes.network
-      },
+      failure: runnerRequestFailure(result, options.resolved),
       type: "failed"
     };
   }
@@ -36867,7 +37186,7 @@ async function handleRunnerRun(ctx, options, deps) {
     recorderSinceSequence,
     runEvents: options.runEvents,
     runId,
-    runnerId: resolved.runnerId,
+    runner: resolved,
     timeoutSeconds: timeout.seconds
   }, deps);
 }
@@ -36939,4 +37258,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=65A771FAB553A0D964756E2164756E21
+//# debugId=59D2DE48FE68917864756E2164756E21