@qawolf/cli 1.15.0 → 1.16.0

package/dist/cli.js

@@ -326098,11 +326098,13 @@ var interactMessages = {
   actionFlagsWithStdin: '"-" reads the whole action from stdin, so an action flag passed alongside it would be ignored. Pipe the action in on its own, or name the action type and use flags.',
   actionMayHaveHappened: "The runner could not be reached, which does not mean the action was not performed: it may have stopped answering mid-action. Take a screenshot before repeating it.",
   actionNotJson: `Stdin did not hold a JSON action. Pipe one object, for example '{"type":"click","button":"left","x":480,"y":260}'.`,
+  actionNotSupportedOnMobile: (type) => `A mobile runner has a touchscreen, so it cannot perform ${type} as asked. It taps with a left-button click, swipes with drag, and types into whatever the last tap focused.`,
   actionPerformed: (type) => `Performed ${type}.`,
   actionAnsweredUnknown: (failureReason) => `The runner answered "${failureReason}", which this version of the CLI does not know how to report. Upgrade with npm install -g @qawolf/cli.`,
   screenshotAnsweredUnknown: (failureReason) => `The runner answered "${failureReason}", which this version of the CLI does not know how to report. Upgrade with npm install -g @qawolf/cli.`,
   runnerHasNoScreen: "This runner does not run a browser on a virtual desktop, so there is nothing about it to see or drive. Retrying will never help: launch a playwright runner instead.",
   runnerHasNoScreenToEvaluate: "The runner could not evaluate the snippet. This covers a runner that is still starting or busy, and also one with no live page to evaluate against: a freshly launched runner has no page until a run opens one, so run a flow on it with qawolf runner run first. If it is not a runner that runs a browser at all, this will never clear. It is not proof the snippet did not run, so do not resubmit one that mutates the page without reading qawolf runner events console first.",
+  inspectNeedsABrowserRunner: "This runner is a mobile device, and element and page HTML are a browser's shapes. Retrying will never help. Launch a playwright runner to inspect one.",
   nothingToInspect: (errorMessage2) => `The runner had nothing to inspect${errorMessage2 === undefined ? "" : `: ${errorMessage2}`}. There is no live page, nothing matched the selector, or no variable has that name; a runner cannot tell those apart. Run a flow on it first, or check the selector or name.`,
   inspectAnsweredUnknown: (failureReason) => `The runner answered "${failureReason}", which this version of the CLI does not know how to report. Upgrade with npm install -g @qawolf/cli.`,
   screenNeedsARun: "This runner has not run anything yet, so its screen has never started. Waiting will not clear this and there is nothing to retry: run a flow on it with qawolf runner run, then ask again. Evaluating a snippet does not start a screen.",
@@ -342183,7 +342185,7 @@ var makeCreateRunContract = (ids) => {
     aiTaskId: ids.aiTask.describe("The AI task whose conversation should receive run status updates.").optional(),
     environmentId: ids.environmentRef,
     environmentVariables: exports_external.record(exports_external.string(), exports_external.string()).optional(),
-    ignoreRules: exports_external.boolean().default(false),
+    ignoreRules: exports_external.boolean().describe("Ignore this team's sequencing rules for this run. By default they are honoured: the flows your selection depends on are added to the run, and flows run in the order the rules require. Set this to run exactly what you selected, in any order.").default(false),
     pullRequestNumber: exports_external.number().int().positive().describe("The number of the pull request to associate with the run.").optional(),
     repository: exports_external.string().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional()
   }).and(makeFlowSelectionSchema(ids));
@@ -342272,7 +342274,7 @@ function refusalForRunEnvironmentVariableName(name) {
     return `${reservedRunEnvironmentVariableName} is reserved by QA Wolf and set for you.`;
   return;
 }
-var maxRunEnvironmentVariables = 100;
+var maxRunEnvironmentVariables = 200;
 var maxRunEnvironmentValueLength = 8 * 1024;
 var runEnvironmentSchema = exports_external.record(exports_external.string(), exports_external.string().max(maxRunEnvironmentValueLength)).superRefine((environment, refinementContext) => {
   for (const name of Object.keys(environment)) {
@@ -342366,18 +342368,30 @@ var makeInspectOnRunnerContract = () => {
     }),
     exports_external.object({
       errorMessage: exports_external.string().optional().describe("What the runner said, when it said anything."),
-      failureReason: exports_external.enum(["nothing-to-inspect", "runner-unreachable"]),
+      failureReason: exports_external.enum([
+        "nothing-to-inspect",
+        "runner-is-not-a-browser",
+        "runner-unreachable"
+      ]),
       outcome: exports_external.literal("failure")
     })
   ]);
   return {
-    description: "Inspect one thing on an interactive runner: an element's HTML, the page's HTML simplified for a model, or a top-level variable's value as JSON. `nothing-to-inspect` means the runner had nothing to answer with: no live page, no element matching the selector, or no variable under that name. A runner cannot tell those apart, so it reports the one reason and puts whatever it did say in `errorMessage`. " + retryableRunnerUnreachableDescription,
+    description: "Inspect one thing on an interactive runner: an element's HTML, the page's HTML simplified for a model, or a top-level variable's value as JSON. `nothing-to-inspect` means the runner had nothing to answer with: no live page, no element matching the selector, or no variable under that name. A runner cannot tell those apart, so it reports the one reason and puts whatever it did say in `errorMessage`. `runner-is-not-a-browser` on a mobile runner — call `runner.inspectMobile` for its equivalent surface instead. " + retryableRunnerUnreachableDescription,
     input,
     kind: "read",
     name: "runner.inspect",
     output
   };
 };
+// node_modules/@qawolf/api-contracts/dist/v1/runner/outcome.js
+function makeRunnerFailureSchema(reasons) {
+  return exports_external.object({
+    failureReason: exports_external.enum(reasons),
+    outcome: exports_external.literal("failure")
+  });
+}
+
 // node_modules/@qawolf/api-contracts/dist/v1/runner/journal.js
 var journalEntrySchema = exports_external.object({
   payload: exports_external.unknown(),
@@ -342434,14 +342448,6 @@ var runFilesSchema = exports_external.record(exports_external.string(), exports_
 }).refine((files) => runFilesByteLength(files) <= maxRunFilesByteLength, {
   error: `The files in one request may carry at most ${maxRunFilesByteLength} bytes in total.`
 });
-// node_modules/@qawolf/api-contracts/dist/v1/runner/outcome.js
-function makeRunnerFailureSchema(reasons) {
-  return exports_external.object({
-    failureReason: exports_external.enum(reasons),
-    outcome: exports_external.literal("failure")
-  });
-}
-
 // node_modules/@qawolf/api-contracts/dist/v1/runner/screen.js
 var screenFailureReasons = [
   "runner-has-no-screen",
@@ -342454,6 +342460,7 @@ var runnerHasNoScreenDescription = "`runner-has-no-screen` if this runner is not
 
 // node_modules/@qawolf/api-contracts/dist/v1/runner/performAction.js
 var unreachableDescription = "`runner-unreachable` if the runner could not be reached: it may still be starting, it may have terminated after inactivity, or it may have stopped answering mid-action. This does not mean the action was not performed — take a screenshot before repeating it.";
+var notSupportedOnMobileDescription = "`action-not-supported-on-mobile` if the runner is a mobile device and this action has no touchscreen equivalent: `double_click`, `scroll`, `move`, `keypress` and `navigate`, and a `click` whose `button` is not `left`, are all pointer-device concepts a touchscreen has nothing to offer for. `click` taps, `drag` swipes between its path's first and last point, and `type` types into whatever the last tap focused.";
 var maxActionErrorMessageLength = 1000;
 var makePerformActionOnRunnerContract = () => {
   const input = exports_external.object({
@@ -342468,6 +342475,7 @@ var makePerformActionOnRunnerContract = () => {
     }),
     makeRunnerFailureSchema([
       ...screenFailureReasons,
+      "action-not-supported-on-mobile",
       runnerUnreachableFailureReason
     ])
   ]);
@@ -342476,7 +342484,7 @@ var makePerformActionOnRunnerContract = () => {
     failure
   ]);
   return {
-    description: `Perform one raw browser action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate. Coordinates are whole pixels on the runner's virtual desktop, in the same space as \`runner.takeScreenshot\`. One action per request, and the runner serves one at a time. The action shapes follow the computer-use vocabulary, minus \`screenshot\` (use \`runner.takeScreenshot\`) and \`wait\` (delay on the caller's side). A success means the action took effect. \`action-failed\`, with a reason, if it reached the runner and did not take effect. On a runner image with a browser, the first action on a runner that has never run anything starts its browser and waits for it, so it can take up to a minute to answer — no \`runner.runFlow\` is needed before acting; if the browser is still starting when the wait runs out, the answer is \`screen-not-ready\` and retrying converges. \`screen-needs-a-run\` if the browser could not be started that way — usually a runner whose runs all finished without starting its desktop; call \`runner.runFlow\` with a flow that opens a browser. ${screenNotReadyDescription} A \`navigate\` does not go through the screen, so a screen that is not ready does not stop it. ${runnerHasNoScreenDescription} ${unreachableDescription}`,
+    description: `Perform one raw browser action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate. Coordinates are whole pixels on the runner's virtual desktop, in the same space as \`runner.takeScreenshot\`. One action per request, and the runner serves one at a time. The action shapes follow the computer-use vocabulary, minus \`screenshot\` (use \`runner.takeScreenshot\`) and \`wait\` (delay on the caller's side). A success means the action took effect. \`action-failed\`, with a reason, if it reached the runner and did not take effect. On a runner image with a browser, the first action on a runner that has never run anything starts its browser and waits for it, so it can take up to a minute to answer — no \`runner.runFlow\` is needed before acting; if the browser is still starting when the wait runs out, the answer is \`screen-not-ready\` and retrying converges. On a mobile runner, the same \`screen-needs-a-run\` and \`screen-not-ready\` outcomes mean no Appium session has started yet, or it did not answer this instant; \`runner.runFlow\` is what starts one, same as a browser. \`screen-needs-a-run\` if the browser could not be started that way — usually a runner whose runs all finished without starting its desktop; call \`runner.runFlow\` with a flow that opens a browser. ${screenNotReadyDescription} A \`navigate\` does not go through the screen, so a screen that is not ready does not stop it. ${runnerHasNoScreenDescription} ${notSupportedOnMobileDescription} ${unreachableDescription}`,
     input,
     kind: "write",
     name: "runner.performAction",
@@ -343268,7 +343276,7 @@ var makeTakeScreenshotOnRunnerContract = () => {
     ])
   ]);
   return {
-    description: `Take one screenshot of an interactive runner's screen. The image is the runner's whole virtual desktop, browser window and all. ${screenNeedsARunDescription} ${screenNotReadyDescription} ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
+    description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all. On a mobile runner it is the device's own screen, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
     input,
     kind: "read",
     name: "runner.takeScreenshot",
@@ -345866,7 +345874,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.15.0",
+  version: "1.16.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -345926,7 +345934,7 @@ var package_default = {
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.30.0",
+    "@qawolf/api-contracts": "0.32.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",
@@ -356462,7 +356470,7 @@ function readNpmDependencies(packageJsonContent) {
 }
 
 // src/domains/interactiveRunner/runnerCallOptions.ts
-var runnerCallOptions = { timeoutMs: 60000 };
+var runnerCallOptions = { timeoutMs: 90000 };
 
 // src/domains/interactiveRunner/runnerIds.ts
 function parseRunnerId(id) {
@@ -357021,6 +357029,11 @@ async function handleRunnerInspect(ctx, options, deps) {
           error: interactiveRunnerMessages.nothingToInspect(failure.errorMessage),
           exitCode: exitCodes.invalidArgs
         };
+      case "runner-is-not-a-browser":
+        return {
+          error: interactiveRunnerMessages.inspectNeedsABrowserRunner,
+          exitCode: exitCodes.invalidArgs
+        };
       case "runner-unreachable":
         return {
           error: interactiveRunnerMessages.runnerUnreachable,
@@ -357238,6 +357251,50 @@ function parseBrowserAction(candidate) {
   return { action: parsed.data, ok: true };
 }
 
+// src/domains/interactiveRunner/performActionFailure.ts
+function describePerformActionFailure(options) {
+  const { actionType, failure } = options;
+  const { failureReason } = failure;
+  switch (failureReason) {
+    case "action-failed":
+      return {
+        error: interactiveRunnerMessages.actionFailed(failure.errorMessage),
+        exitCode: exitCodes.testFailure
+      };
+    case "action-not-supported-on-mobile":
+      return {
+        error: interactiveRunnerMessages.actionNotSupportedOnMobile(actionType),
+        exitCode: exitCodes.invalidArgs
+      };
+    case "screen-needs-a-run":
+      return {
+        error: interactiveRunnerMessages.screenNeedsARun,
+        exitCode: exitCodes.invalidArgs
+      };
+    case "screen-not-ready":
+      return {
+        error: interactiveRunnerMessages.screenNotReady,
+        exitCode: exitCodes.network
+      };
+    case "runner-has-no-screen":
+      return {
+        error: interactiveRunnerMessages.runnerHasNoScreen,
+        exitCode: exitCodes.invalidArgs
+      };
+    case "runner-unreachable":
+      return {
+        error: interactiveRunnerMessages.actionMayHaveHappened,
+        exitCode: exitCodes.network
+      };
+    default: {
+      return {
+        error: interactiveRunnerMessages.actionAnsweredUnknown(failureReason),
+        exitCode: exitCodes.network
+      };
+    }
+  }
+}
+
 // src/domains/interactiveRunner/performAction.ts
 var stdinArgument2 = "-";
 async function readAction(type, flags, deps) {
@@ -357280,41 +357337,10 @@ async function handleRunnerAct(ctx, options, deps) {
     ctx.ui.output({ action: built.action, outcome: "success" }, interactiveRunnerMessages.actionPerformed(built.action.type));
     return;
   }
-  const failure = result.value;
-  const { failureReason } = failure;
-  switch (failureReason) {
-    case "action-failed":
-      return {
-        error: interactiveRunnerMessages.actionFailed(failure.errorMessage),
-        exitCode: exitCodes.testFailure
-      };
-    case "screen-needs-a-run":
-      return {
-        error: interactiveRunnerMessages.screenNeedsARun,
-        exitCode: exitCodes.invalidArgs
-      };
-    case "screen-not-ready":
-      return {
-        error: interactiveRunnerMessages.screenNotReady,
-        exitCode: exitCodes.network
-      };
-    case "runner-has-no-screen":
-      return {
-        error: interactiveRunnerMessages.runnerHasNoScreen,
-        exitCode: exitCodes.invalidArgs
-      };
-    case "runner-unreachable":
-      return {
-        error: interactiveRunnerMessages.actionMayHaveHappened,
-        exitCode: exitCodes.network
-      };
-    default: {
-      return {
-        error: interactiveRunnerMessages.actionAnsweredUnknown(failureReason),
-        exitCode: exitCodes.network
-      };
-    }
-  }
+  return describePerformActionFailure({
+    actionType: built.action.type,
+    failure: result.value
+  });
 }
 
 // src/domains/interactiveRunner/takeScreenshot.ts
@@ -357969,6 +357995,9 @@ function buildRunFileDelta(options) {
   }
   const heldHashes = new Map(held.files.map((entry) => [entry.path, entry.contentHash]));
   const alwaysSent = new Set([options.entryPointPath, runPackageJsonPath]);
+  if (options.selectionPath !== undefined) {
+    alwaysSent.add(options.selectionPath);
+  }
   const files = {};
   const unchangedFiles = {};
   for (const [path9, content] of Object.entries(options.files)) {
@@ -358056,7 +358085,8 @@ async function submitRun(ctx, options, deps) {
     entryPointPath: options.entryPointPath,
     files: options.files,
     held,
-    runnerId: options.resolved.runnerId
+    runnerId: options.resolved.runnerId,
+    selectionPath: options.selection?.path
   });
   const first2 = await sendRunFlowRequest(ctx, options, delta);
   if (first2.type === "needs-full-sync") {
@@ -358224,4 +358254,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=DD39A64EAC42A5D564756E2164756E21
+//# debugId=A9041D278FF748EF64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -60,7 +60,7 @@
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.30.0",
+    "@qawolf/api-contracts": "0.32.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",