@qawolf/cli 1.14.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,11 +342185,18 @@ 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));
-  const output = resource({ runId: ids.run }, { urlFieldDescription: "Absolute URL of the run page." });
+  const output = resource({
+    excludedFlows: exports_external.array(exports_external.object({
+      flowId: ids.flow,
+      name: exports_external.string().describe("The name of the flow."),
+      reason: exports_external.enum(["deleted", "not-on-branch"]).describe('Why the flow cannot run: "deleted" means the flow was deleted, "not-on-branch" means the flow has no file at the commit the run was created from.')
+    })).describe("Explicitly requested flows that were left out of the run, each with the reason. Flows selected through tags are not reported here."),
+    runId: ids.run
+  }, { urlFieldDescription: "Absolute URL of the run page." });
   return {
     description: "Create a run for the selected flows and/or tags in an environment.",
     input,
@@ -342265,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)) {
@@ -342359,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(),
@@ -342427,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",
@@ -342447,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({
@@ -342461,6 +342475,7 @@ var makePerformActionOnRunnerContract = () => {
     }),
     makeRunnerFailureSchema([
       ...screenFailureReasons,
+      "action-not-supported-on-mobile",
       runnerUnreachableFailureReason
     ])
   ]);
@@ -342469,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",
@@ -342547,7 +342562,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
   kind: exports_external.enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
   name: exports_external.string(),
   runConcurrencyLimit: exports_external.string().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
-  status: exports_external.enum(["blocked", "needs-investigation", "ready", "running"]).describe("Standing health across the environment's runs: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
+  status: exports_external.enum(["blocked", "needs-investigation", "ready", "running"]).describe("Standing health across the environment's runs, not its Git reconciliation state: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
   terminatedAt: exports_external.iso.datetime().optional().describe("When the environment was terminated, if it has been.")
 }, { urlFieldDescription: "Absolute URL of the environment page." });
 
@@ -342556,6 +342571,7 @@ var makeFindEnvironmentsContract = (ids) => {
   const input = exports_external.object({
     includeTerminated: exports_external.boolean().default(false).describe("Also list terminated environments. By default only environments that have not been terminated are listed."),
     kind: exports_external.enum(["static", "preview"]).optional().describe("Only list environments of this kind. Omit to list both."),
+    workspaceId: ids.workspace.optional().describe("The workspace to list environments from. Required when authenticating with an organization or user API key."),
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
   });
   const output = exports_external.object({
@@ -342601,7 +342617,7 @@ var makeGetEnvironmentContract = (ids) => {
   });
   const output = makeEnvironmentResourceSchema(ids);
   return {
-    description: "Read a single environment's name, kind, health status, run concurrency limit, and termination state.",
+    description: "Read a single environment's name, kind, standing run health, flow-code branch and reconciliation state, run concurrency limit, and termination state. If flowCodeBranch exists, use its syncStatus for Git reconciliation and read lastSyncedCommitHash only when syncStatus is reconciled.",
     input,
     kind: "read",
     name: "environment.get",
@@ -342643,7 +342659,7 @@ var makeSetEnvironmentVariableContract = (ids) => {
 var makeCreateEnvironmentContract = (ids) => {
   const input = exports_external.object({
     name: exports_external.string().min(1).max(255).regex(/\S/, "Environment name cannot be blank.").describe("Display name of the new environment."),
-    workspaceId: ids.workspace.optional().describe("The workspace to create the environment in. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace to create the environment in. Required when authenticating with an organization or user API key.")
   });
   const output = makeEnvironmentResourceSchema(ids);
   return {
@@ -342683,9 +342699,10 @@ var makeTagResourceSchema = () => resource({
 }, {
   urlFieldDescription: "Absolute URL of the team's tag settings page."
 });
-var makeCreateTagContract = () => {
+var makeCreateTagContract = (ids) => {
   const input = exports_external.object({
-    name: exports_external.string().trim().min(1).max(255).refine((name) => !name.includes(","), "Tag names cannot include commas.")
+    name: exports_external.string().trim().min(1).max(255).refine((name) => !name.includes(","), "Tag names cannot include commas."),
+    workspaceId: ids.workspace.optional().describe("The workspace to create the tag in. Required when authenticating with an organization or user API key.")
   });
   const output = makeTagResourceSchema();
   return {
@@ -342809,7 +342826,7 @@ var makeFindIssuesContract = (ids) => {
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
     statuses: exports_external.array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to pending, in-progress, and paused issues."),
     type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
-    workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
   });
   const output = exports_external.object({
     issues: exports_external.array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
@@ -342863,7 +342880,7 @@ var makeCreateIssueContract = (ids) => {
     description: exports_external.string().optional().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed."),
     name: exports_external.string().trim().min(1).max(255),
     priority: issuePrioritySchema.optional().describe('Defaults to "unprioritized".'),
-    workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
   };
   const input = exports_external.discriminatedUnion("type", [
     exports_external.object({
@@ -343025,6 +343042,25 @@ var makeGetRunContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
+var makeReattemptRunContract = (ids) => {
+  const input = exports_external.object({
+    flowIds: exports_external.array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").optional().describe("The flows to reattempt. Every named flow must be eligible or the " + "whole request is rejected. Omit to reattempt every eligible flow."),
+    runId: ids.run
+  });
+  const output = resource({
+    reattemptedFlowIds: exports_external.array(ids.flow).describe("The flows a new attempt was requested for."),
+    runId: ids.run
+  }, { urlFieldDescription: "Absolute URL of the run page." });
+  return {
+    description: "Request new attempts for a run's flows, in the same run. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the latest flow code. Poll run.get for results.",
+    input,
+    kind: "write",
+    name: "run.reattempt",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/runner/evaluateSnippet.js
 var maxSnippetCodeLength = 64 * 1024;
 var makeEvaluateSnippetOnRunnerContract = () => {
@@ -343240,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",
@@ -343253,6 +343289,7 @@ var makeListTagsContract = (ids) => {
   const input = exports_external.object({
     includeFlowIds: exports_external.boolean().default(false).describe("Also return the ids of the flows that carry each tag."),
     names: exports_external.array(exports_external.string().trim().min(1)).min(1).max(100).optional().describe("Only list tags with these names. Matching is case sensitive. Omit to list all tags."),
+    workspaceId: ids.workspace.optional().describe("The workspace to list tags from. Required when authenticating with an organization or user API key."),
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
   });
   const output = exports_external.object({
@@ -343300,7 +343337,8 @@ var makeContractsV1 = (ids) => {
     run: {
       create: makeCreateRunContract(resolvedIds),
       find: makeFindRunsContract(resolvedIds),
-      get: makeGetRunContract(resolvedIds)
+      get: makeGetRunContract(resolvedIds),
+      reattempt: makeReattemptRunContract(resolvedIds)
     },
     runner: {
       evaluateSnippet: makeEvaluateSnippetOnRunnerContract(),
@@ -343315,7 +343353,7 @@ var makeContractsV1 = (ids) => {
       terminate: makeTerminateRunnerContract()
     },
     tag: {
-      create: makeCreateTagContract(),
+      create: makeCreateTagContract(resolvedIds),
       list: makeListTagsContract(resolvedIds)
     }
   };
@@ -345836,7 +345874,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.14.0",
+  version: "1.16.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -345896,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.27.0",
+    "@qawolf/api-contracts": "0.32.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",
@@ -356432,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) {
@@ -356991,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,
@@ -357208,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) {
@@ -357250,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
@@ -357939,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)) {
@@ -358026,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") {
@@ -358194,4 +358254,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=9D7349D928400D0E64756E2164756E21
+//# debugId=A9041D278FF748EF64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.14.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.27.0",
+    "@qawolf/api-contracts": "0.32.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",

package/skills/qawolf-cli/SKILL.md

@@ -118,7 +118,7 @@ current branch.
 | `qawolf environment create` | write | Create an environment on the caller's team and return it in the environment.get shape. |
 | `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
 | `qawolf environment find` | read | List the team's environments, newest first. |
-| `qawolf environment get` | read | Read a single environment's name, kind, health status, run concurrency limit, and termination state. |
+| `qawolf environment get` | read | Read a single environment's name, kind, standing run health, flow-code branch and reconciliation state, run concurrency limit, and termination state. If flowCodeBranch exists, use its syncStatus for Git reconciliation and read lastSyncedCommitHash only when syncStatus is reconciled. |
 | `qawolf environment getVariable` | read | Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and do not fail the call. |
 | `qawolf environment listVariableNames` | read | Use this to answer which QA Wolf environment variables are available to test code. Returns names only; values never leave the server. |
 | `qawolf environment setVariable` | write | Create or replace an environment variable. If the user asks to create one for "my email" without naming it, use DEFAULT_EMAIL. The value is never returned. |
@@ -141,6 +141,7 @@ current branch.
 | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
 | `qawolf run find` | read | List an environment's recent runs, newest first. |
 | `qawolf run get` | read | Get a run's status, per-flow results, and links. |
+| `qawolf run reattempt` | write | Request new attempts for a run's flows, in the same run. A flow is eligible once its result is failed or canceled and QA Wolf's automatic retries have finished. A fully investigated run no longer accepts reattempts. Attempts run with the latest flow code. Poll run.get for results. |
 | `qawolf runner act` | write | Perform one raw action on a runner's screen: click, double_click, scroll, move, drag, keypress, navigate or type. Use - to read a whole action as JSON from stdin |
 | `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events, run-logs, run-status |
 | `qawolf runner exec` | write | Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin |