@qawolf/cli 2.1.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.js CHANGED
@@ -8440,6 +8440,7 @@ var authErrorMessages = {
8440
8440
  rejected401: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 401). Check your API key.`,
8441
8441
  rejected402: (noun) => `QA Wolf API refused the${noun ? ` ${noun}` : ""} request (HTTP 402): billing prevented it.`,
8442
8442
  rejected403: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 403). Check that your API key has access to this environment.`,
8443
+ blocked403: (noun) => `The${noun ? ` ${noun}` : ""} request was blocked before it reached the QA Wolf API (HTTP 403), so your API key was not checked.`,
8443
8444
  notFound404Environment: (noun) => `QA Wolf API could not find ${noun ? `${noun} for that environment` : "that environment"} (HTTP 404). Check the --env value.`,
8444
8445
  notFound404Runner: (runnerId) => runnerId === undefined ? "That runner is not running (HTTP 404)." : `Runner ${runnerId} is not running (HTTP 404).`,
8445
8446
  runnerIsGone: "It was never launched, or it has since been terminated or idled out.",
@@ -8935,10 +8936,10 @@ var lifecycleMessages = {
8935
8936
  launched: (id, url) => `Launched runner ${id}. ${pageAt(url)}`,
8936
8937
  launchedForCommand: (id, url) => `No runner was given, so launched ${id} for this command. Its browser is fresh: nothing has been run on it and nothing is signed in. It bills until it is terminated or idles out, so terminate it with qawolf runner terminate --runner ${id} when you are done. ${pageAt(url)}`,
8937
8938
  noRunnerIdForImport: `${noRunnerId} An install also needs a live run to go into, which a runner gets from qawolf runner run.`,
8938
- noRunnerIdForHighlight: `${noRunnerId} Highlighting also needs a live page to draw on, which a runner gets from its first run: run a flow on it with qawolf runner run.`,
8939
- noRunnerIdForInspect: `${noRunnerId} Inspecting also needs a page, which a runner gets from its first run: run a flow on it with qawolf runner run.`,
8939
+ noRunnerIdForHighlight: `${noRunnerId} A playwright runner has a page to draw on as soon as it launches.`,
8940
+ noRunnerIdForInspect: `${noRunnerId} A playwright runner can be inspected as soon as it launches, and any other runner once a flow has run on it with qawolf runner run.`,
8940
8941
  noRunnerIdForPromoteSnapshot: `${noRunnerId} A baseline is replaced on the runner that produced the screenshot, so it has to be the runner the diff came from.`,
8941
- noRunnerIdForScreenshot: `${noRunnerId} A screenshot also needs a screen, which a runner gets from its first run: run a flow on it with qawolf runner run.`,
8942
+ noRunnerIdForScreenshot: `${noRunnerId} A playwright runner has a screen as soon as it launches, and any other runner once a flow has run on it with qawolf runner run.`,
8942
8943
  noRunnerId,
8943
8944
  wasNotRunning: (id) => `Runner ${id} was not running.`,
8944
8945
  terminated: (id) => `Terminated runner ${id}.`,
@@ -15446,6 +15447,15 @@ function applyWorkspaceId(inputSchema, input, workspaceId) {
15446
15447
  return { ...input, workspaceId };
15447
15448
  }
15448
15449
 
15450
+ // src/core/parseJson.ts
15451
+ function parseJson(text) {
15452
+ try {
15453
+ return JSON.parse(text);
15454
+ } catch {
15455
+ return;
15456
+ }
15457
+ }
15458
+
15449
15459
  // src/shell/platform/describeNotFound.ts
15450
15460
  var m = authMessages.errors.request;
15451
15461
  var saysNothingMore = (reason) => /^(\w+ )*not ?found\.?$/i.test(reason.trim());
@@ -15563,7 +15573,7 @@ function describeRequestError(err, baseUrl, noun, notFound) {
15563
15573
  ...body
15564
15574
  };
15565
15575
  if (err.status === 403)
15566
- return { error: m2.request.rejected403(noun), ...body };
15576
+ return parseJson(err.body) === undefined ? { error: m2.request.blocked403(noun) } : { error: m2.request.rejected403(noun), ...body };
15567
15577
  if (err.status === 404)
15568
15578
  return describeNotFound(notFound, noun, reason);
15569
15579
  return { error: m2.request.failedWithStatus(err.status, noun), ...body };
@@ -16804,6 +16814,7 @@ var agentSessionStatusSchema = _enum(agentSessionStatuses).describe('Where the w
16804
16814
  var agentReplySchema = object({
16805
16815
  askedAt: exports_iso.datetime().describe("When the AI wrote this, as an ISO 8601 timestamp."),
16806
16816
  choices: array(string2()).optional().describe("The answers the AI offered, when the reply is a question with a fixed set of them. Answer by sending one of these back through agent.send."),
16817
+ id: string2().min(1).describe("Stays the same while the AI is still writing this reply, so a reply that a later check returns again, longer, replaces the one with this id."),
16807
16818
  text: string2().describe("What the AI said.")
16808
16819
  });
16809
16820
 
@@ -16934,12 +16945,13 @@ var uploadedFileNameSchema = teamStoragePathSchema.refine((fileName) => teamStor
16934
16945
  // node_modules/@qawolf/api-contracts/dist/v1/file/requestDownload.js
16935
16946
  var makeRequestFileDownloadContract = (ids) => {
16936
16947
  const input = object({
16937
- filePath: teamStoragePathSchema.describe("The file's path in team storage, as file.requestUpload answered with."),
16948
+ filePath: teamStoragePathSchema.describe("The file's path in team storage, as the filePath file.requestUpload answered with."),
16938
16949
  workspaceId: ids.workspace.optional().describe("The workspace the file belongs to. Required when authenticating with an organization or user API key.")
16939
16950
  });
16940
16951
  const output = object({
16941
16952
  expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
16942
- path: string2().describe("The file's path in team storage."),
16953
+ filePath: string2().describe("The file's path in team storage."),
16954
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
16943
16955
  readUrl: string2().describe('Fetch the file\'s bytes from here, for example `curl -o journeys.csv "<readUrl>"`. Write it to a file and read that file, rather than printing the contents, so a large file costs one line of output instead of all of it.')
16944
16956
  });
16945
16957
  return {
@@ -16970,7 +16982,8 @@ var makeRequestFileUploadContract = (ids) => {
16970
16982
  const output = object({
16971
16983
  contentType: string2().describe("Send this as the PUT's `Content-Type` header, exactly. The URL is signed for it and refuses any other value."),
16972
16984
  expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
16973
- path: string2().describe("Where the file lives in team storage. Send this to agent.send as a filePath, and the AI fetches it from there."),
16985
+ filePath: string2().describe("Where the file lives in team storage. Send it as filePath to file.requestDownload, or in agent.send's filePaths so the AI fetches it from there."),
16986
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
16974
16987
  uploadUrl: string2().describe(`Send the file's bytes here with a single HTTP PUT carrying the returned contentType, for example \`curl -H 'Content-Type: application/octet-stream' --upload-file "journeys.csv" "<uploadUrl>"\`. Upload the bytes from the shell rather than through this API, so a large file never has to be written out as text.`)
16975
16988
  });
16976
16989
  return {
@@ -16984,7 +16997,7 @@ var makeRequestFileUploadContract = (ids) => {
16984
16997
  openWorldHint: false,
16985
16998
  readOnlyHint: false
16986
16999
  },
16987
- description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the path in filePaths.",
17000
+ description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the returned filePath in filePaths.",
16988
17001
  input,
16989
17002
  kind: "write",
16990
17003
  name: "file.requestUpload",
@@ -17076,7 +17089,7 @@ var makeCreateRunContract = (ids) => {
17076
17089
  aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
17077
17090
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
17078
17091
  environmentId: ids.environmentRef,
17079
- environmentVariables: record(string2(), string2()).optional(),
17092
+ environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
17080
17093
  ignoreRules: boolean2().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),
17081
17094
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
17082
17095
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
@@ -17310,7 +17323,8 @@ var runnerNameSchema = _enum([
17310
17323
  "playwright",
17311
17324
  "android",
17312
17325
  "ios",
17313
- "windows"
17326
+ "windows",
17327
+ "mac"
17314
17328
  ]);
17315
17329
  var runnerWorkspaceRequirement = "Read it from whoami.";
17316
17330
  var runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;
@@ -18005,14 +18019,6 @@ var makeTriggerScheduleFields = (ids) => ({
18005
18019
  timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily or weekly schedule fires, as "HH:mm". Required when cadence is daily or weekly.'),
18006
18020
  timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against.")
18007
18021
  });
18008
- var makeTriggerDeploymentFields = (ids) => ({
18009
- action: makeTriggerActionSchema(ids),
18010
- branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
18011
- deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
18012
- environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
18013
- environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
18014
- servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
18015
- });
18016
18022
 
18017
18023
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
18018
18024
  var checkAction = (action, ctx) => {
@@ -18114,6 +18120,17 @@ var checkDeployment = (value, ctx) => {
18114
18120
  };
18115
18121
  var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? checkSchedule(value, ctx) : checkDeployment(value, ctx);
18116
18122
 
18123
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
18124
+ var makeTriggerDeploymentFields = (ids) => ({
18125
+ action: makeTriggerActionSchema(ids),
18126
+ branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
18127
+ deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
18128
+ environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
18129
+ environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
18130
+ repositoryPattern: string2().min(1).optional().describe('Only fire for deployments from a repository whose "owner/name" matches this pattern, such as acme/web or acme/*. A deployment that names no repository never matches it.'),
18131
+ servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
18132
+ });
18133
+
18117
18134
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
18118
18135
  var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
18119
18136
  object({
@@ -18459,13 +18476,14 @@ var makeGetAttemptContract = (ids) => {
18459
18476
  error: string2().optional(),
18460
18477
  startedAt: exports_iso.datetime().optional()
18461
18478
  });
18479
+ const artifactUrls = {
18480
+ logsUrl: url().optional(),
18481
+ traceUrl: url().optional(),
18482
+ videoUrl: url().optional()
18483
+ };
18462
18484
  const output = discriminatedUnion("artifactStatus", [
18463
18485
  response.extend({
18464
- artifacts: object({
18465
- logsUrl: url().optional(),
18466
- traceUrl: url().optional(),
18467
- videoUrl: url().optional()
18468
- }),
18486
+ artifacts: object(artifactUrls),
18469
18487
  artifactStatus: literal("signed"),
18470
18488
  attempt: attempt.extend({
18471
18489
  kind: literal("automated"),
@@ -18486,7 +18504,8 @@ var makeGetAttemptContract = (ids) => {
18486
18504
  attempt: attempt.extend({
18487
18505
  kind: literal("manual"),
18488
18506
  status: literal("passed")
18489
- })
18507
+ }),
18508
+ evidence: object(artifactUrls).optional().describe("Signed links to the logs, trace, and video that the Wolf Browser run kept. Absent when it kept none. The artifacts field stays empty for a manual attempt.")
18490
18509
  })
18491
18510
  ]);
18492
18511
  return {
@@ -18594,7 +18613,7 @@ var makeDeploymentResourceSchema = (ids) => resource({
18594
18613
  environmentName: string2().optional().describe("The environment's name. Absent when the environment has since been deleted."),
18595
18614
  id: ids.deployment,
18596
18615
  provider: _enum(["github", "gitlab", "api"]).optional().describe("How QA Wolf received the deployment: a GitHub webhook, a GitLab webhook, or the deployment.reportStatus API."),
18597
- repository: string2().optional().describe('The repository the deployment came from, as "owner/name". Absent when neither the code host nor the deployment report named one.'),
18616
+ repository: string2().optional().describe(`The repository the deployment came from, as "owner/name". Absent when neither the code host nor the deployment report named one. A trigger's repositoryPattern matches against it.`),
18598
18617
  service: string2().optional().describe("Which application was deployed, as the deployer named it. Absent when the deployer named none."),
18599
18618
  status: _enum(["pending", "success", "failure", "inactive"]).optional().describe("The deployment's lifecycle status, in the vocabulary deployment.reportStatus accepts. Absent when no status was ever reported.")
18600
18619
  }, {
@@ -18631,7 +18650,7 @@ var makeFindDeploymentsContract = (ids) => {
18631
18650
  };
18632
18651
 
18633
18652
  // node_modules/@qawolf/api-contracts/dist/v1/deployment/listTriggerEvaluations.js
18634
- var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, or the service it deployed.");
18653
+ var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service", "repository"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, the service it deployed, or the repository it came from.");
18635
18654
  var conditionVerdictSchema = discriminatedUnion("outcome", [
18636
18655
  object({
18637
18656
  kind: conditionKindSchema,
@@ -18717,7 +18736,7 @@ var deploymentReportMetadata = strictObject({
18717
18736
  commitUrl: httpUrl().max(2048).describe("A link to the deployed commit in your code host. Send this when QA Wolf cannot resolve the commit itself, for example when the QA Wolf GitHub App is not installed.").optional(),
18718
18737
  pullRequestNumber: number2().int().positive().describe("The number of the pull request the deployment belongs to. Requires repository.").optional(),
18719
18738
  ref: string2().trim().min(1).max(255).describe("The branch or ref that was deployed.").optional(),
18720
- repository: string2().trim().min(1).max(255).describe('The owner/name of the repository, e.g. "acme/web".').optional()
18739
+ repository: string2().trim().min(1).max(255).describe(`The owner/name of the repository, e.g. "acme/web". A deployment trigger's repositoryPattern matches against it.`).optional()
18721
18740
  }).refine((value) => value.pullRequestNumber === undefined || value.repository !== undefined, {
18722
18741
  message: "repository is required when pullRequestNumber is provided.",
18723
18742
  path: ["pullRequestNumber"]
@@ -19010,7 +19029,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
19010
19029
  kind: _enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
19011
19030
  name: string2(),
19012
19031
  runConcurrencyLimit: string2().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
19013
- status: _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)."),
19032
+ status: _enum(["blocked", "needs-investigation", "ready", "running"]).describe("Release readiness from the environment's open bugs and runs, not its Git reconciliation state: blocked (an open urgent, high, or unprioritized bug reproduces here), needs-investigation (failures await triage), running (flows are executing), or ready (none of these, the greenlit state). It only reports. It never stops runs, validation, or publishing."),
19014
19033
  terminatedAt: exports_iso.datetime().optional().describe("When the environment was terminated, if it has been."),
19015
19034
  variablesUrl: url().optional().describe("Absolute URL of the page where a person saves this environment's variables. Give it to the user when a login or key is missing, rather than collecting the value yourself. Absent once the environment is terminated, because that page no longer exists.")
19016
19035
  }, { urlFieldDescription: "Absolute URL of the environment page." });
@@ -19146,14 +19165,14 @@ var makeGetEnvironmentContract = (ids) => {
19146
19165
  annotationJustifications: {
19147
19166
  destructiveHint: "Does not alter environment settings or concurrency limits.",
19148
19167
  openWorldHint: "Reads QA Wolf environment state without updating the connected Git provider.",
19149
- readOnlyHint: "Retrieves an environment's configuration, run health and code-reconciliation state."
19168
+ readOnlyHint: "Retrieves an environment's configuration, release readiness and code-reconciliation state."
19150
19169
  },
19151
19170
  annotations: {
19152
19171
  destructiveHint: false,
19153
19172
  openWorldHint: false,
19154
19173
  readOnlyHint: true
19155
19174
  },
19156
- 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.",
19175
+ description: "Read a single environment's name, kind, release readiness status, 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.",
19157
19176
  input,
19158
19177
  kind: "read",
19159
19178
  name: "environment.get",
@@ -19564,7 +19583,7 @@ var openIssueStatuses = [
19564
19583
  "paused"
19565
19584
  ];
19566
19585
  var makeIssueResourceSchema = (ids) => resource({
19567
- coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug and maintenance reports, whose flows are listed under reproductions."),
19586
+ coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
19568
19587
  createdAt: exports_coerce.date().describe("When the issue was created."),
19569
19588
  description: string2().describe("The issue description in Markdown."),
19570
19589
  issueId: ids.issue,
@@ -19585,25 +19604,25 @@ var makeFindIssuesContract = (ids) => {
19585
19604
  const input = object({
19586
19605
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
19587
19606
  statuses: array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to backlog, pending, in-progress, and paused issues."),
19588
- type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
19607
+ type: publicIssueTypeSchema.describe("The issue type to include: bug report (`bug`), blocker (`maintenance`), or coverage request (`coverageRequest`)."),
19589
19608
  workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
19590
19609
  });
19591
19610
  const output = object({
19592
- issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
19611
+ issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, blockers, or coverage requests, newest first."),
19593
19612
  nextCursor: nextCursorSchema
19594
19613
  });
19595
19614
  return {
19596
19615
  annotationJustifications: {
19597
19616
  destructiveHint: "Does not edit issue details, statuses or coverage associations.",
19598
19617
  openWorldHint: "Reads QA Wolf issue records without publishing updates to linked trackers.",
19599
- readOnlyHint: "Lists workspace bug reports, maintenance reports or coverage requests."
19618
+ readOnlyHint: "Lists workspace bug reports, blockers or coverage requests."
19600
19619
  },
19601
19620
  annotations: {
19602
19621
  destructiveHint: false,
19603
19622
  openWorldHint: false,
19604
19623
  readOnlyHint: true
19605
19624
  },
19606
- description: "List the team's bug reports, maintenance reports, or coverage requests, newest first.",
19625
+ description: "List the team's bug reports, blockers, or coverage requests, newest first.",
19607
19626
  input,
19608
19627
  kind: "read",
19609
19628
  name: "issue.find",
@@ -19750,7 +19769,7 @@ var makeAddFlowsToIssueContract = (ids) => {
19750
19769
  openWorldHint: false,
19751
19770
  readOnlyHint: false
19752
19771
  },
19753
- description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug and maintenance reports link to flows through the runs that reproduce them; use run.diagnose to record one.",
19772
+ description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug reports and blockers link to flows through the runs that reproduce them; use run.diagnose to record one.",
19754
19773
  input,
19755
19774
  kind: "write",
19756
19775
  name: "issue.addFlows",
@@ -19780,7 +19799,18 @@ var makeCreateIssueContract = (ids) => {
19780
19799
  ...commonFields,
19781
19800
  effort: _enum(["extraSmall", "small", "medium", "large", "extraLarge"]).describe("The effort to repair the flows."),
19782
19801
  priority: _enum(["low", "medium", "high", "urgent"]),
19783
- reason: _enum(["dataChanged", "flowNeedsWork", "other", "uiChanged"]).describe("Why the flows need maintenance."),
19802
+ reason: _enum([
19803
+ "featureNotAvailable",
19804
+ "needsTestData",
19805
+ "needsAccess",
19806
+ "needsConfirmation",
19807
+ "environmentUnavailable",
19808
+ "qaWolfQueue",
19809
+ "dataChanged",
19810
+ "flowNeedsWork",
19811
+ "other",
19812
+ "uiChanged"
19813
+ ]).describe('What the blocked flows wait on. "qaWolfQueue" is only for full-service workspaces. "dataChanged", "flowNeedsWork", "other" and "uiChanged" are deprecated and still accepted.'),
19784
19814
  type: literal("maintenance")
19785
19815
  })
19786
19816
  ]);
@@ -19798,7 +19828,7 @@ var makeCreateIssueContract = (ids) => {
19798
19828
  openWorldHint: true,
19799
19829
  readOnlyHint: false
19800
19830
  },
19801
- description: "Create a bug report, maintenance report, or coverage request issue for the caller's team. " + "A user can create a maintenance report only when they can see the workspace's maintenance reports; " + "a team or organization API key credits it to the workspace's automation user. " + "Link its failed flows afterwards with run.diagnose.",
19831
+ description: "Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. " + "A user can create a blocker only when they can see the workspace's blockers; " + "a team or organization API key credits it to the workspace's automation user. " + "Link its failed flows afterwards with run.diagnose.",
19802
19832
  input,
19803
19833
  kind: "write",
19804
19834
  name: "issue.create",
@@ -19863,7 +19893,7 @@ var makeListIssueActivityContract = (ids) => {
19863
19893
  // node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
19864
19894
  var makeRemoveFlowsFromIssueContract = (ids) => {
19865
19895
  const input = object({
19866
- environmentId: ids.environment.optional().describe("The environment whose bug or maintenance reproductions to remove. Required when a selected flow is linked in more than one environment."),
19896
+ environmentId: ids.environment.optional().describe("The environment whose bug report or blocker reproductions to remove. Required when a selected flow is linked in more than one environment."),
19867
19897
  flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows to remove from the issue."),
19868
19898
  issueId: ids.issue
19869
19899
  });
@@ -19881,7 +19911,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
19881
19911
  openWorldHint: true,
19882
19912
  readOnlyHint: false
19883
19913
  },
19884
- description: "Remove flows from a coverage request or remove bug/maintenance reproductions in an environment. " + "Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. " + "For reports, omit environmentId only when each selected flow is linked in at most one environment.",
19914
+ description: "Remove flows from a coverage request or remove bug report or blocker reproductions in an environment. " + "Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. " + "For reports, omit environmentId only when each selected flow is linked in at most one environment.",
19885
19915
  input,
19886
19916
  kind: "write",
19887
19917
  name: "issue.removeFlows",
@@ -19898,7 +19928,7 @@ var makeUpdateIssueContract = (ids) => {
19898
19928
  issueId: ids.issue,
19899
19929
  name: nameSchema.optional(),
19900
19930
  priority: issuePrioritySchema.optional(),
19901
- status: issueStatusSchema.optional()
19931
+ status: issueStatusSchema.optional().describe("Bug reports and blockers allow only these changes: pending to canceled or archived, canceled to archived, and resolved to archived. Requesting pending or inProgress on a bug report resolved in the last 7 days reopens it. The stored status is inProgress when a flow still reproduces it, and pending otherwise. Never set resolved on a bug report: it resolves on its own once its flows pass. A coverage request can move to backlog, pending, paused, inProgress, resolved or archived.")
19902
19932
  }).refine((update) => update.description !== undefined || update.name !== undefined || update.priority !== undefined || update.status !== undefined, {
19903
19933
  message: "At least one of description, name, priority, or status is required."
19904
19934
  });
@@ -19937,8 +19967,12 @@ var branchScope = union([
19937
19967
  ]);
19938
19968
  var codeHostingServiceRepository = union([
19939
19969
  object({ kind: literal("any") }),
19940
- object({ kind: literal("none") }),
19941
- object({ id: string2(), kind: literal("by-id") })
19970
+ object({ kind: literal("none") }).describe("The trigger ran with the code host integration's features off. It is not a repository filter and maps to no repositoryPattern."),
19971
+ object({
19972
+ fullName: string2().describe(`The repository's full name on the code host, such as "acme/storefront", as codeHostIntegration.listRepositories reports it and as a current trigger's repositoryPattern matches it.`),
19973
+ id: string2(),
19974
+ kind: literal("by-id")
19975
+ })
19942
19976
  ]);
19943
19977
  var makeLegacyTriggerSchema = (ids) => {
19944
19978
  const base = {
@@ -20126,14 +20160,14 @@ var makeDiagnoseRunContract = (ids) => {
20126
20160
  annotationJustifications: {
20127
20161
  destructiveHint: "Can replace a flow's existing diagnosis association and change externally reported run information.",
20128
20162
  openWorldHint: "Recorded diagnosis changes can update run-related messages in configured external integrations.",
20129
- readOnlyHint: "Records failed flows as reproductions of a selected bug or maintenance issue."
20163
+ readOnlyHint: "Records failed flows as reproductions of a selected bug report or blocker."
20130
20164
  },
20131
20165
  annotations: {
20132
20166
  destructiveHint: true,
20133
20167
  openWorldHint: true,
20134
20168
  readOnlyHint: false
20135
20169
  },
20136
- description: "Diagnose failed flows in a run as reproductions of a bug or maintenance report owned by the caller's team. " + "The issue's type selects the diagnosis. " + "Each flow must have failed in the run. " + "A flow that is already diagnosed in the run moves to this issue, and may stay linked to other open reports. " + "The diagnosis appears on the run, and the reproduction appears under the issue's reproductions. " + "Coverage requests cannot be diagnosed; use issue.addFlows to cover flows instead.",
20170
+ description: "Link failed flows in a run to an existing bug report or blocker owned by the caller's team, recording them as its reproductions. " + "It does not explain why a run failed; read investigation.get or attempt.get for that. " + "The issue's type selects the diagnosis. " + "Each flow must have failed in the run. " + "A flow that is already diagnosed in the run moves to this issue, and may stay linked to other open reports. " + "The diagnosis appears on the run, and the reproduction appears under the issue's reproductions. " + "Coverage requests cannot be diagnosed; use issue.addFlows to cover flows instead.",
20137
20171
  input,
20138
20172
  kind: "write",
20139
20173
  name: "run.diagnose",
@@ -20176,35 +20210,15 @@ var makeFindRunsContract = (ids) => {
20176
20210
  };
20177
20211
  };
20178
20212
 
20179
- // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
20180
- var makeFlowFailureSchema = (ids) => {
20181
- const diagnosis = object({
20182
- issueId: ids.issue,
20183
- type: _enum(["bug", "maintenance"])
20184
- }).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
20185
- const optedOutOfInvestigation = object({
20186
- by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
20187
- }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
20188
- return object({
20189
- diagnosis,
20190
- error: string2(),
20191
- optedOutOfInvestigation
20192
- });
20193
- };
20194
-
20195
- // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
20196
- var makeGetRunContract = (ids) => {
20197
- const flowStatus = _enum(publicRunStatusValues);
20198
- const input = object({
20199
- flowStatuses: array(flowStatus).min(1).optional().describe("Return only the flows whose status is one of these. A suite run can " + "hold hundreds of flows, so start an investigation with failed " + "alone. A flow that passed after a retry reads passed, so add " + "passed when a flaky flow is missing from the answer. Omit to " + "return every flow. The run-level fields are unaffected."),
20200
- runId: ids.run
20201
- });
20213
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
20214
+ var makeFlowAttemptsSchema = (ids) => {
20202
20215
  const artifactUrls = {
20203
20216
  logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
20204
20217
  traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
20205
20218
  videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
20206
20219
  };
20207
20220
  const automatedKind = literal("automated").describe("The attempt ran on a QA Wolf runner.");
20221
+ const attemptUrl = url().optional().describe("Absolute URL of the attempt's page in the app, which opens this flow at this attempt. Link this page to show one flow's attempt: the run page opens a different flow. Absent only in replies from servers older than this field.");
20208
20222
  const automatedAttempt = discriminatedUnion("status", [
20209
20223
  object({
20210
20224
  ...artifactUrls,
@@ -20212,7 +20226,8 @@ var makeGetRunContract = (ids) => {
20212
20226
  completedAt: exports_iso.datetime(),
20213
20227
  kind: automatedKind,
20214
20228
  startedAt: exports_iso.datetime(),
20215
- status: literal("passed")
20229
+ status: literal("passed"),
20230
+ url: attemptUrl
20216
20231
  }),
20217
20232
  object({
20218
20233
  ...artifactUrls,
@@ -20220,7 +20235,8 @@ var makeGetRunContract = (ids) => {
20220
20235
  completedAt: exports_iso.datetime(),
20221
20236
  kind: automatedKind,
20222
20237
  startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
20223
- status: literal("failed")
20238
+ status: literal("failed"),
20239
+ url: attemptUrl
20224
20240
  }),
20225
20241
  object({
20226
20242
  attemptId: ids.runAttempt.optional(),
@@ -20228,18 +20244,47 @@ var makeGetRunContract = (ids) => {
20228
20244
  completedAt: exports_iso.datetime().optional(),
20229
20245
  kind: automatedKind,
20230
20246
  startedAt: exports_iso.datetime().optional(),
20231
- status: literal("canceled").describe("The attempt was terminated without reaching a verdict.")
20247
+ status: literal("canceled").describe("The attempt was terminated without reaching a verdict."),
20248
+ url: attemptUrl
20232
20249
  })
20233
20250
  ]);
20234
20251
  const manualAttempt = object({
20252
+ ...artifactUrls,
20235
20253
  attemptId: ids.runAttempt.optional(),
20236
20254
  completedAt: exports_iso.datetime(),
20237
20255
  kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
20238
20256
  startedAt: exports_iso.datetime(),
20239
- status: literal("passed")
20257
+ status: literal("passed"),
20258
+ url: attemptUrl
20240
20259
  });
20241
20260
  const attempt = union([automatedAttempt, manualAttempt]);
20242
- const attempts = array(attempt).optional().describe("The flow's finished execution attempts, oldest first, including " + "manual Wolf Browser attempts. Present once at least one attempt has " + "finished, so a flow that passed after retries also lists its failed " + "attempts. Artifact URLs appear only on automated attempts that " + "reached a verdict, stay valid for at least a day (call run.get " + "again for fresh ones), and can return 404 when the attempt did not " + "produce that artifact.");
20261
+ return array(attempt).optional().describe("The flow's finished execution attempts, oldest first, including " + "manual Wolf Browser attempts. Present once at least one attempt has " + "finished, so a flow that passed after retries also lists its failed " + "attempts. Artifact URLs appear only on attempts that reached a " + "verdict, and on a manual attempt only when its Wolf Browser run " + "kept them. They stay valid for at least a day (call run.get again " + "for fresh ones), and can return 404 when the attempt did not " + "produce that artifact.");
20262
+ };
20263
+
20264
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
20265
+ var makeFlowFailureSchema = (ids) => {
20266
+ const diagnosis = object({
20267
+ issueId: ids.issue,
20268
+ type: _enum(["bug", "maintenance"])
20269
+ }).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
20270
+ const optedOutOfInvestigation = object({
20271
+ by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
20272
+ }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
20273
+ return object({
20274
+ diagnosis,
20275
+ error: string2(),
20276
+ optedOutOfInvestigation
20277
+ });
20278
+ };
20279
+
20280
+ // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
20281
+ var makeGetRunContract = (ids) => {
20282
+ const flowStatus = _enum(publicRunStatusValues);
20283
+ const input = object({
20284
+ flowStatuses: array(flowStatus).min(1).optional().describe("Return only the flows whose status is one of these. A suite run can " + "hold hundreds of flows, so start an investigation with failed " + "alone. A flow that passed after a retry reads passed, so add " + "passed when a flaky flow is missing from the answer. Omit to " + "return every flow. The run-level fields are unaffected."),
20285
+ runId: ids.run
20286
+ });
20287
+ const attempts = makeFlowAttemptsSchema(ids);
20243
20288
  const failedFlow = object({
20244
20289
  attempts,
20245
20290
  failure: makeFlowFailureSchema(ids),
@@ -20293,14 +20338,14 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
20293
20338
  annotationJustifications: {
20294
20339
  destructiveHint: "Ends the investigation of the selected failures and changes externally reported run information.",
20295
20340
  openWorldHint: "Recorded opt-outs can update run-related messages in configured external integrations.",
20296
- readOnlyHint: "Records failed flows as needing no bug or maintenance report."
20341
+ readOnlyHint: "Records failed flows as needing no bug report or blocker."
20297
20342
  },
20298
20343
  annotations: {
20299
20344
  destructiveHint: true,
20300
20345
  openWorldHint: true,
20301
20346
  readOnlyHint: false
20302
20347
  },
20303
- description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug or maintenance report. ' + "Each flow must have failed in the run and still be under investigation. " + "A flow that already has a diagnosis cannot be opted out. " + "A team or organization key records the opt-out as the workspace's automation user. " + "To link a failure to a report instead, use run.diagnose.",
20348
+ description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug report or blocker. ' + "Each flow must have failed in the run and still be under investigation. " + "A flow that already has a diagnosis cannot be opted out. " + "A team or organization key records the opt-out as the workspace's automation user. " + "To link a failure to a report instead, use run.diagnose.",
20304
20349
  input,
20305
20350
  kind: "write",
20306
20351
  name: "run.optOutOfInvestigation",
@@ -20311,13 +20356,20 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
20311
20356
  // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
20312
20357
  var makeReattemptRunContract = (ids) => {
20313
20358
  const input = object({
20359
+ afterCommit: string2().regex(/^[0-9a-f]{40}$/u, "afterCommit must be a full 40-character commit hash").optional().describe("A commit you published to the environment's flow code branch. " + "The request is refused until the environment has synced this " + "commit or a later one, so the new attempts run it. Omit to run " + "whatever code the environment has synced."),
20360
+ aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive the new attempts' results."),
20361
+ chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive the new attempts' results."),
20314
20362
  flowIds: 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."),
20315
20363
  runId: ids.run
20364
+ }).refine((value) => !(value.aiTaskId && value.chatSessionId), {
20365
+ message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
20366
+ path: ["chatSessionId"]
20316
20367
  });
20317
20368
  const output = resource({
20318
20369
  reattemptedFlowIds: array(ids.flow).describe("The flows a new attempt was requested for."),
20319
20370
  reattemptedInRunIds: array(ids.run).describe("The runs the new attempts were added to, which is where to poll " + "for their results. It is this run alone unless a flow had kept " + "failing in later runs, because the attempt then goes to the " + "latest of them."),
20320
- runId: ids.run
20371
+ runId: ids.run,
20372
+ tracking: _enum(["registered", "failed", "not-requested"]).describe(`Whether the conversation named by aiTaskId or chatSessionId will receive the new attempts' results: "registered" when it will, "failed" when the attempts were requested but the registration failed, "not-requested" when neither id was given or the AI task has no conversation to notify.`)
20321
20373
  }, { urlFieldDescription: "Absolute URL of the run page." });
20322
20374
  return {
20323
20375
  annotationJustifications: {
@@ -20330,7 +20382,7 @@ var makeReattemptRunContract = (ids) => {
20330
20382
  openWorldHint: true,
20331
20383
  readOnlyHint: false
20332
20384
  },
20333
- description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the latest flow code. Poll run.get for results.",
20385
+ description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the flow code the environment has synced when the " + "request arrives: after publishing a fix, pass afterCommit so the " + "request waits for that commit instead of rerunning older code. " + "Poll run.get for results, or pass aiTaskId or chatSessionId to be " + "notified when they settle.",
20334
20386
  input,
20335
20387
  kind: "write",
20336
20388
  name: "run.reattempt",
@@ -20876,7 +20928,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
20876
20928
  openWorldHint: false,
20877
20929
  readOnlyHint: false
20878
20930
  },
20879
- 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; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
20931
+ 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; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
20880
20932
  input,
20881
20933
  kind: "read",
20882
20934
  name: "runner.takeScreenshot",
@@ -23582,7 +23634,7 @@ function startUpdateCheck(deps) {
23582
23634
  // package.json
23583
23635
  var package_default = {
23584
23636
  name: "@qawolf/cli",
23585
- version: "2.1.0",
23637
+ version: "2.2.1",
23586
23638
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
23587
23639
  keywords: [
23588
23640
  "automation",
@@ -23654,7 +23706,7 @@ var package_default = {
23654
23706
  "@clack/prompts": "1.5.1",
23655
23707
  "@napi-rs/keyring": "1.3.0",
23656
23708
  "@oxc-node/core": "0.1.0",
23657
- "@qawolf/api-contracts": "0.91.0",
23709
+ "@qawolf/api-contracts": "0.98.1",
23658
23710
  "@qawolf/emails": "1.1.1",
23659
23711
  "@qawolf/flow-targets": "2.0.0",
23660
23712
  "@qawolf/flows": "0.3.0",
@@ -24164,15 +24216,6 @@ async function handleAgentGet(ctx, options, deps) {
24164
24216
  // src/shell/agent/sessionStore.ts
24165
24217
  import { join as join14 } from "node:path";
24166
24218
 
24167
- // src/core/parseJson.ts
24168
- function parseJson(text) {
24169
- try {
24170
- return JSON.parse(text);
24171
- } catch {
24172
- return;
24173
- }
24174
- }
24175
-
24176
24219
  // src/shell/jsonFile.ts
24177
24220
  var pendingWrites = 0;
24178
24221
  async function readJsonFile(fs, path, schema) {
@@ -38770,9 +38813,10 @@ function buildRunnerAction(type, flags) {
38770
38813
  const to = flags.to === undefined ? undefined : parsePoint("--to", flags.to);
38771
38814
  if (to !== undefined && !to.ok)
38772
38815
  return to;
38816
+ const button = flags.button ?? (type === "click" ? "left" : undefined);
38773
38817
  const candidate = {
38774
38818
  type,
38775
- ...flags.button === undefined ? {} : { button: flags.button },
38819
+ ...button === undefined ? {} : { button },
38776
38820
  ...flags.durationMs === undefined ? {} : { duration_ms: toNumber(flags.durationMs) },
38777
38821
  ...from === undefined ? {} : { from: from.value },
38778
38822
  ...flags.keys === undefined ? {} : { keys: flags.keys },
@@ -39354,7 +39398,7 @@ On mobile, send tap and swipe, never click or drag. The other browser actions, d
39354
39398
 
39355
39399
  # Before the first run
39356
39400
 
39357
- A runner has no screen until its first run, so act exits 2 until then, except navigate, which exits 1 (action-failed): it skips the screen but still needs the runner to have run something. With no runner named at all, act launches one and says so on stderr.
39401
+ A playwright runner's screen starts as it launches, so act works on it before anything has run. Any other runner has no screen until its first run, so act exits 2 on it until then. With no runner named at all, act launches one and says so on stderr.
39358
39402
  `;
39359
39403
 
39360
39404
  // src/commands/runner/guides/actions.txt
@@ -39401,7 +39445,7 @@ History is not unbounded: a size cap drops the oldest entries on a long-lived ru
39401
39445
  $ qawolf runner events recorder --tail 5 | jq -r '.code // .type'
39402
39446
  $ qawolf runner events recorder --tail 5 | jq -r '[.locator] + (.alternates // []) | @tsv'
39403
39447
 
39404
- \`code\` is absent on events with no call of their own, such as a navigation, which is why the first line falls back to \`type\`. Use these to turn a session you drove by pixel coordinates into durable selectors, and to check that a click landed on the element you meant rather than near it. The stream is empty until the runner's first run gives it a browser context, so an early empty answer means "not yet", not "broken". Do not add --json here: it wraps each line in an envelope and these field paths stop matching.
39448
+ \`code\` is absent on events with no call of their own, such as a navigation, which is why the first line falls back to \`type\`. Use these to turn a session you drove by pixel coordinates into durable selectors, and to check that a click landed on the element you meant rather than near it. The stream stays empty while a playwright runner still shows its welcome page, and on any other runner until its first run, so an early empty answer means "not yet", not "broken". Do not add --json here: it wraps each line in an envelope and these field paths stop matching.
39405
39449
 
39406
39450
  # Following
39407
39451
 
@@ -39428,7 +39472,7 @@ The snippet imports nothing of yours by default. Pass --file <path> to evaluate
39428
39472
 
39429
39473
  # Failures
39430
39474
 
39431
- exec exits 2 until the runner's first run, since there is no page to evaluate against. On a 4 the message says the snippet could not be evaluated, but a lost answer looks the same from outside, so treat a 4 from a snippet that changes something as "may have run" rather than "did not run", and check its effect before running it again. With no runner named at all, exec launches one and says so on stderr.
39475
+ A playwright runner has a page to evaluate against as soon as it launches. On a 4 the message says the snippet could not be evaluated, but a lost answer looks the same from outside, so treat a 4 from a snippet that changes something as "may have run" rather than "did not run", and check its effect before running it again. With no runner named at all, exec launches one and says so on stderr.
39432
39476
  `;
39433
39477
 
39434
39478
  // src/commands/runner/guides/formatGuide.ts
@@ -39515,27 +39559,12 @@ It is a read with a cost: keeping the clock reset keeps a billed pod alive. Call
39515
39559
  `;
39516
39560
 
39517
39561
  // src/commands/runner/guides/launch.txt
39518
- var launch_default = `# Ids
39519
-
39520
- Runner ids are yours to choose and are scoped to your team, so agent-1 is a fine id. Launching an id that is already running attaches to that runner instead of starting and billing a second one, and the answer says which happened: read \`alreadyRunning\`. Reusing one id is therefore the cheap and safe pattern. The same id with a different --name is refused rather than silently ignored.
39521
-
39522
- launch takes its id from --id and never reads QAWOLF_RUNNER_ID. A bare \`qawolf runner launch\` invents a random id, bills a pod under it and stores it, so a harness that exported the variable and then launched without --id ends up with a pod it is not addressing. Pass --id whenever you have an id in mind.
39523
-
39524
- Launching an id that differs from QAWOLF_RUNNER_ID prints a warning on stderr naming both ids: the variable still outranks the directory default, so commands that omit --runner keep going to whatever it names, not the runner you just launched. That is expected when you launch an additional runner on purpose. Address that one with --runner rather than re-exporting the variable, which would repoint every other runner-less command too.
39525
-
39526
- # The page
39527
-
39528
- Either answer carries a \`url\`, which launch prints, as does a command that launched its own runner. It is a QA Wolf page showing what the runner is doing, where a person can also take over with their own mouse and keyboard. Hand it to a person who asks what your runner is up to. The page opens for anyone on the runner's team, however the runner was launched. There is nothing to see until the runner's first run starts its screen, so the page waits until then. You read the screen with \`screenshot\`, not with the page.
39529
-
39530
- # Browser or mobile
39531
-
39532
- --name also chooses between a browser and a mobile device: --name android or --name ios starts an Appium session instead of a browser. A command built for the other kind answers a failureReason naming the mismatch rather than doing something approximate: runner-is-not-mobile from inspect session, contexts, page-source and elements on a browser runner, and runner-is-not-a-browser from inspect element-html and page-html on a mobile one. Launch the right family up front rather than discovering it from a refusal mid-session.
39533
- `;
39562
+ var launch_default = "# Ids\n\nRunner ids are yours to choose and are scoped to your team, so agent-1 is a fine id. Launching an id that is already running attaches to that runner instead of starting and billing a second one, and the answer says which happened: read `alreadyRunning`. Reusing one id is therefore the cheap and safe pattern. --name does not change a runner that is already running: the answer's `runnerName` says what you attached to.\n\nlaunch takes its id from --id and never reads QAWOLF_RUNNER_ID. A bare `qawolf runner launch` invents a random id, bills a pod under it and stores it, so a harness that exported the variable and then launched without --id ends up with a pod it is not addressing. Pass --id whenever you have an id in mind.\n\nLaunching an id that differs from QAWOLF_RUNNER_ID prints a warning on stderr naming both ids: the variable still outranks the directory default, so commands that omit --runner keep going to whatever it names, not the runner you just launched. That is expected when you launch an additional runner on purpose. Address that one with --runner rather than re-exporting the variable, which would repoint every other runner-less command too.\n\n# The page\n\nEither answer carries a `url`, which launch prints, as does a command that launched its own runner. It is a QA Wolf page showing what the runner is doing, where a person can also take over with their own mouse and keyboard. Hand it to a person who asks what your runner is up to. The page opens for anyone on the runner's team, however the runner was launched. A playwright runner's screen starts as it launches, showing a QA Wolf welcome page. Any other runner's screen starts with its first run, so its page waits until then. You read the screen with `screenshot`, not with the page.\n\n# Browser or mobile\n\n--name also chooses between a browser and a mobile device: --name android or --name ios starts an Appium session instead of a browser. A command built for the other kind answers a failureReason naming the mismatch rather than doing something approximate: runner-is-not-mobile from inspect session, contexts, page-source and elements on a browser runner, and runner-is-not-a-browser from inspect element-html and page-html on a mobile one. Launch the right family up front rather than discovering it from a refusal mid-session.\n";
39534
39563
 
39535
39564
  // src/commands/runner/guides/list.txt
39536
39565
  var list_default = `# What the list holds
39537
39566
 
39538
- The list names the runners this directory has launched that are still running, and marks the one a command with no --runner would reach. It also includes the runner named by QAWOLF_RUNNER_ID even though this directory did not launch it, so a harness handed a runner sees it alongside the ones it started itself. Use the id column with --runner to address any of them; addressing one does not make it the default.
39567
+ The list names every active runner on your team, marking the ones this directory launched and the default, the one a command with no --runner would reach. --here keeps only this directory's runners and the one QAWOLF_RUNNER_ID names. Use the id column with --runner to address any of them; addressing one does not make it the default.
39539
39568
 
39540
39569
  Every runner is looked up before it is listed, so a runner that idled out is absent rather than reported. The lookup neither starts a runner nor resets an inactivity clock, which is what separates list from keepalive: listing tells you what is there and changes nothing. A lookup that cannot be answered fails the command rather than returning a shorter list, because a short list reads as the whole truth.
39541
39570
 
@@ -39626,7 +39655,7 @@ var screenshot_default = `# Reading the screen
39626
39655
 
39627
39656
  The image is a real JPEG on disk, decoded, because every coding harness can open an image file. Read it with whatever vision you have. --out - writes the JPEG bytes to stdout instead, on their own, for a caller that is a process rather than an agent: the confirmation, and the JSON line under --json, goes to stderr so nothing follows the image on stdout. A terminal on stdout is refused: redirect or pipe it.
39628
39657
 
39629
- A runner has no screen until its first run, so until then screenshot exits 2. It never launches a runner. When you are about to act anyway, \`act --screenshot\` performs the action and returns the screen in one call.
39658
+ A playwright runner's screen starts as it launches. Any other runner has no screen until its first run, so until then screenshot exits 2 on it. It never launches a runner. When you are about to act anyway, \`act --screenshot\` performs the action and returns the screen in one call.
39630
39659
  `;
39631
39660
 
39632
39661
  // src/commands/runner/guides/stopOrTerminate.txt
@@ -39640,7 +39669,7 @@ Both succeed when there was nothing to do, and say which: \`wasRunning\` is fals
39640
39669
  `;
39641
39670
 
39642
39671
  // src/commands/runner/guides/workflow.md
39643
- var workflow_default = "An interactive runner is a live pod with a browser or a mobile device in it. You launch one, look at it, act on it, run flows on it, and read what it recorded. Everything is a plain request to one host, so there is no connection to hold open. This guide covers what spans commands; each command's own help below covers the rest.\n\n## Which runner a command reaches\n\nCommands that target a runner find one in this order: `--runner`, then `QAWOLF_RUNNER_ID`, then the runner stored for the current directory, which `qawolf runner launch` sets. Setting the environment variable once is the most robust for a harness whose working directory may not be stable, with two catches:\n\n- `qawolf runner launch` is not in that order: it takes its id from `--id` and never reads `QAWOLF_RUNNER_ID`. Pass `--id` whenever you have an id in mind.\n- A runner id that is set is treated as found, whether or not anything is running under it. Exporting `QAWOLF_RUNNER_ID=agent-1` turns off the auto-launch described next: instead of starting `agent-1`, commands try to reach it and fail with exit code `8`, naming the id and saying the variable is what chose it. Launch that id once yourself and the rest follows.\n\nIf nothing names a runner, the commands that change something launch one and say so on stderr, naming it: `run`, `act` and `exec`. Read that announcement. The browser it just started is fresh: nothing has been run on it, nothing is signed in, and no page is open. Acting as though your earlier setup survived is the single most likely way to drive the wrong page.\n\nNo read command ever launches a runner. `screenshot`, `events` and `keepalive` tell you there is no runner rather than quietly billing one, and so does `terminate`.\n\n## The order that matters\n\nA freshly launched runner has no screen. The virtual desktop starts with the runner's first run and nothing else starts it, so until you have run something:\n\n- `screenshot` and `act` fail with exit code `2`, except `navigate`, which fails with exit code `1` (`action-failed`): it skips the screen but still needs the runner to have run something\n- `exec` fails with exit code `2`\n- `events recorder` reads as empty\n\nNone of that is a fault, and none of it clears on its own. Only `qawolf runner run <flow>` starts the screen. A bare navigate does not: it fails until the first run, however long you wait.\n\nSo the first thing you do to a new runner has to put a browser on it. That means a flow file and a `package.json` on disk, even if all you want is to drive the browser by hand; there is no \"just give me a screen\" call. Once one run has happened, the screenshot-and-act loop works for the rest of the runner's life. A `--lines` selection is the one call that does not need a run first.\n\n## Exit codes\n\nRetry on the exit code, not on the message text:\n\n- `4` is transient, with one exception. The screen is up but cannot serve this instant: restarting after a display-size change, or busy with another request. Retry in a second or two, and bound the retries. The exception is a command that changes something, where a `4` can instead mean the answer was lost with the work in flight. For `act` and `actions`, take a screenshot first and repeat only what the screen says did not happen. For `run`, poll `run-status` instead of submitting again, since a second submission risks a second billed run. For `exec`, check the effect the snippet was meant to have before running it again.\n- `6` means the work ran out of the time it is given.\n- `8` means there is no such runner. It was never launched, or it was terminated, or it idled out. Retrying never brings one back, so stop and launch the id or name one that is running. The message says which runner was meant and whether `--runner`, `QAWOLF_RUNNER_ID` or this directory's stored default chose it; read that line before you pick an id to launch.\n- `2` will not clear on its own. Nothing has run on this runner yet, so run a flow; or the runner has no browser at all, so launch with `--name playwright` instead; or the action belongs to the other runner family, so send `tap`, `swipe` or `fill` to a mobile runner and the browser actions to a browser runner. The message says which.\n\n`act`, `actions`, `run` and `exec` are the commands whose lost answer may still have taken effect.\n\n## End to end\n\nRun from a directory holding a flow and a `package.json`. The run is what starts the screen, so it is not optional even though the goal here is to drive by hand.\n\n```sh\nexport QAWOLF_API_KEY=... # the only credential\nexport QAWOLF_RUNNER_ID=agent-1 # so no command below needs --runner\n\nqawolf runner launch --id agent-1 --json # --id, not the variable; read .alreadyRunning and .url\nqawolf runner run flows/smoke.flow.ts --follow # starts the screen; exit 1 if it failed\n\nqawolf runner act navigate --url https://example.com/login --screenshot step-1.jpg # then read step-1.jpg yourself\nqawolf runner act click --button left --x 480 --y 260 --screenshot step-2.jpg\nqawolf runner act type --text \"someone@example.com\" --screenshot step-3.jpg\n\nqawolf runner inspect element-html --selector \"#email\"\nqawolf runner inspect variable --name cart | jq .total\n\nqawolf runner run flows/smoke.flow.ts --lines 12-40 --follow # just those lines\nqawolf runner events recorder --tail 5 | jq -r '[.locator] + (.alternates // []) | @tsv'\nqawolf runner terminate\n```\n\nOn a mobile runner, launch with `--name android` or `--name ios`, and drive it with `tap`, `swipe`, `fill` and `type` instead of the browser actions.\n";
39672
+ var workflow_default = "An interactive runner is a live pod with a browser or a mobile device in it. You launch one, look at it, act on it, run flows on it, and read what it recorded. Everything is a plain request to one host, so there is no connection to hold open. This guide covers what spans commands; each command's own help below covers the rest.\n\n## Which runner a command reaches\n\nCommands that target a runner find one in this order: `--runner`, then `QAWOLF_RUNNER_ID`, then the runner stored for the current directory, which `qawolf runner launch` sets. Setting the environment variable once is the most robust for a harness whose working directory may not be stable, with two catches:\n\n- `qawolf runner launch` is not in that order: it takes its id from `--id` and never reads `QAWOLF_RUNNER_ID`. Pass `--id` whenever you have an id in mind.\n- A runner id that is set is treated as found, whether or not anything is running under it. Exporting `QAWOLF_RUNNER_ID=agent-1` turns off the auto-launch described next: instead of starting `agent-1`, commands try to reach it and fail with exit code `8`, naming the id and saying the variable is what chose it. Launch that id once yourself and the rest follows.\n\nIf nothing names a runner, the commands that change something launch one and say so on stderr, naming it: `run`, `act`, `actions` and `exec`. Read that announcement. The browser it just started is fresh: nothing has been run on it, nothing is signed in, and it shows only the QA Wolf welcome page. Acting as though your earlier setup survived is the single most likely way to drive the wrong page.\n\nNo read command ever launches a runner. `screenshot`, `events` and `keepalive` tell you there is no runner rather than quietly billing one, and so does `terminate`.\n\n## The order that matters\n\nA playwright runner's screen starts as it launches, showing a QA Wolf welcome page, so the screenshot-and-act loop works before you run anything.\n\nAny other runner, such as a mobile one, has no screen until its first run, and nothing else starts it. Until you have run something on it, `screenshot` and `act` fail with exit code `2`. That is not a fault, and it does not clear on its own: run a flow with `qawolf runner run <flow>`, which needs a flow file and a `package.json` on disk.\n\n## Exit codes\n\nRetry on the exit code, not on the message text:\n\n- `4` is transient, with one exception. The screen cannot serve this instant: still coming up just after launch, restarting after a display-size change, or busy with another request. Retry in a second or two, and bound the retries. The exception is a command that changes something, where a `4` can instead mean the answer was lost with the work in flight. For `act` and `actions`, take a screenshot first and repeat only what the screen says did not happen. For `run`, poll `run-status` instead of submitting again, since a second submission risks a second billed run. For `exec`, check the effect the snippet was meant to have before running it again.\n- `6` means the work ran out of the time it is given.\n- `7` means billing prevented the request, such as a plan that does not cover the runner you asked for. The message says what was refused and what clears it.\n- `8` means there is no such runner. It was never launched, or it was terminated, or it idled out. Retrying never brings one back, so stop and launch the id or name one that is running. The message says which runner was meant and whether `--runner`, `QAWOLF_RUNNER_ID` or this directory's stored default chose it; read that line before you pick an id to launch.\n- `2` will not clear on its own. Nothing has run on this runner yet, so run a flow; or the runner has no browser at all, so launch with `--name playwright` instead; or the action belongs to the other runner family, so send `tap`, `swipe` or `fill` to a mobile runner and the browser actions to a browser runner. The message says which.\n\n`act`, `actions`, `run` and `exec` are the commands whose lost answer may still have taken effect.\n\n## End to end\n\nRun from a directory holding a flow and a `package.json`.\n\n```sh\nexport QAWOLF_API_KEY=... # the only credential\nexport QAWOLF_RUNNER_ID=agent-1 # so no command below needs --runner\n\nqawolf runner launch --id agent-1 --json # --id, not the variable; read .alreadyRunning and .url\nqawolf runner run flows/smoke.flow.ts --follow # exit 1 if it failed\n\nqawolf runner act navigate --url https://example.com/login --screenshot step-1.jpg # then read step-1.jpg yourself\nqawolf runner act click --button left --x 480 --y 260 --screenshot step-2.jpg\nqawolf runner act type --text \"someone@example.com\" --screenshot step-3.jpg\n\nqawolf runner inspect element-html --selector \"#email\"\nqawolf runner inspect variable --name cart | jq .total\n\nqawolf runner run flows/smoke.flow.ts --lines 12-40 --follow # just those lines\nqawolf runner events recorder --tail 5 | jq -r '[.locator] + (.alternates // []) | @tsv'\nqawolf runner terminate\n```\n\nOn a mobile runner, launch with `--name android` or `--name ios`, and drive it with `tap`, `swipe`, `fill` and `type` instead of the browser actions.\n";
39644
39673
 
39645
39674
  // src/commands/runner/guides/index.ts
39646
39675
  var runnerGuides = {
@@ -40587,7 +40616,7 @@ Examples:
40587
40616
  $ qawolf runner screenshot --out - | my-vision-tool`;
40588
40617
  function registerRunnerInteractCommands(runner, signals) {
40589
40618
  declareCommandKind(runner.command("screenshot"), "read").description("Save a JPEG of an interactive runner's screen to a file, or write it to stdout with --out -").option("--out <path>", "File to write the image to. - writes the JPEG bytes to stdout on their own and moves the confirmation, JSON included, to stderr", defaultScreenshotPath).option("--runner <id>", runnerFlagDescription).addHelpText("after", screenshotExamples).addHelpText("after", runnerGuides.screenshot).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerScreenshot(ctx, { out: opts.out, runner: opts.runner }, runnerDeps(ctx)))(opts, command));
40590
- declareCommandKind(runner.command("act <action>"), "write").description("Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin").option("--button <button>", "click: left, right, wheel, back or forward").option("--duration-ms <ms>", "swipe: how long it takes, up to 10000. Slow scrolls, fast flings").option("--from <x,y>", "swipe: the point it starts at").option("--keys <keys...>", "keypress: modifiers and the key, e.g. Control a").option("--path <json>", "drag: JSON array of points to drag through").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Also save a JPEG of the screen, taken after the action, to this file, in place of a separate screenshot. An action that did not take effect answers with one too. - writes it to stdout and moves the confirmation, JSON included, to stderr").option("--scroll-x <delta>", "scroll: horizontal wheel delta").option("--scroll-y <delta>", "scroll: vertical wheel delta").option("--selector <selector>", "tap or fill: the element to act on, as a screen object would find it. tap takes it in place of --x and --y").option("--strategy <strategy>", "how --selector is resolved: xpath (default), ios-predicate or shadow").option("--text <text>", "type: the text to type into what has focus. fill: the field's new value").option("--to <x,y>", "swipe: the point it ends at").option("--url <url>", "navigate: the http or https URL to go to").option("--x <pixels>", "click, tap and the like: x, in screenshot pixels").option("--y <pixels>", "click, tap and the like: y, in screenshot pixels").addHelpText("after", actExamples).addHelpText("after", runnerGuides.act).action((action, opts, command) => withAuthContext(signals, (ctx) => handleRunnerAct(ctx, {
40619
+ declareCommandKind(runner.command("act <action>"), "write").description("Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin").option("--button <button>", "click: left (default), right, wheel, back or forward").option("--duration-ms <ms>", "swipe: how long it takes, up to 10000. Slow scrolls, fast flings").option("--from <x,y>", "swipe: the point it starts at").option("--keys <keys...>", "keypress: modifiers and the key, e.g. Control a").option("--path <json>", "drag: JSON array of points to drag through").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Also save a JPEG of the screen, taken after the action, to this file, in place of a separate screenshot. An action that did not take effect answers with one too. - writes it to stdout and moves the confirmation, JSON included, to stderr").option("--scroll-x <delta>", "scroll: horizontal wheel delta").option("--scroll-y <delta>", "scroll: vertical wheel delta").option("--selector <selector>", "tap or fill: the element to act on, as a screen object would find it. tap takes it in place of --x and --y").option("--strategy <strategy>", "how --selector is resolved: xpath (default), ios-predicate or shadow").option("--text <text>", "type: the text to type into what has focus. fill: the field's new value").option("--to <x,y>", "swipe: the point it ends at").option("--url <url>", "navigate: the http or https URL to go to").option("--x <pixels>", "click, tap and the like: x, in screenshot pixels").option("--y <pixels>", "click, tap and the like: y, in screenshot pixels").addHelpText("after", actExamples).addHelpText("after", runnerGuides.act).action((action, opts, command) => withAuthContext(signals, (ctx) => handleRunnerAct(ctx, {
40591
40620
  flags: {
40592
40621
  button: opts.button,
40593
40622
  durationMs: opts.durationMs,
@@ -40725,7 +40754,7 @@ async function handleRunnerList(ctx, options, deps) {
40725
40754
  if (!listed.ok) {
40726
40755
  return { ...failureFields(listed), exitCode: exitCodes.network };
40727
40756
  }
40728
- const items = options.here ? listed.items.filter((item) => item.launchedHere) : listed.items;
40757
+ const items = options.here ? listed.items.filter((item) => item.launchedHere || item.isDefault) : listed.items;
40729
40758
  if (ctx.ui.mode === "json") {
40730
40759
  ctx.ui.json(items);
40731
40760
  return;
@@ -40801,7 +40830,7 @@ Examples:
40801
40830
  $ qawolf runner keepalive --runner ci`;
40802
40831
  function registerRunnerLifecycleCommands(runner, signals) {
40803
40832
  declareCommandKind(runner.command("launch"), "write").description("Launch an interactive runner and make it this directory's default").option("--id <id>", "Id to launch under. Relaunching an id attaches to that runner").option("--name <family>", "Runner family to run, e.g. playwright").addHelpText("after", launchExamples).addHelpText("after", runnerGuides.launch).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerLaunch(ctx, { id: opts.id, name: opts.name }, runnerDeps(ctx)))(opts, command));
40804
- declareCommandKind(runner.command("list"), "read").description("List the runners running on your team").option("--here", "Only the runners this directory launched").addHelpText("after", listExamples2).addHelpText("after", runnerGuides.list).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
40833
+ declareCommandKind(runner.command("list"), "read").description("List the runners running on your team").option("--here", "Only the runners this directory launched or QAWOLF_RUNNER_ID names").addHelpText("after", listExamples2).addHelpText("after", runnerGuides.list).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
40805
40834
  declareCommandKind(runner.command("terminate"), "write").description("End an interactive runner, and the pod it runs on with it").option("--runner <id>", runnerFlagDescription).addHelpText("after", runnerGuides.stopOrTerminate).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerTerminate(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
40806
40835
  declareCommandKind(runner.command("stop-run"), "write").description("Stop what a runner is currently executing, leaving the runner up").option("--runner <id>", runnerFlagDescription).addHelpText("after", runnerGuides.stopOrTerminate).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerStopRun(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
40807
40836
  declareCommandKind(runner.command("keepalive"), "read").description("Reset a runner's inactivity clock, for a caller that pauses between actions").option("--runner <id>", runnerFlagDescription).addHelpText("after", keepaliveExamples).addHelpText("after", runnerGuides.keepalive).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerKeepalive(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
@@ -41787,4 +41816,4 @@ createProgram({ signals }).parseAsync().catch(() => {
41787
41816
  process.exitCode = 1;
41788
41817
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
41789
41818
 
41790
- //# debugId=FFFD1A9214AB797D64756E2164756E21
41819
+ //# debugId=F8E2C24048CC67D764756E2164756E21