@qawolf/cli 2.1.0 → 2.2.0

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
@@ -16804,6 +16804,7 @@ var agentSessionStatusSchema = _enum(agentSessionStatuses).describe('Where the w
16804
16804
  var agentReplySchema = object({
16805
16805
  askedAt: exports_iso.datetime().describe("When the AI wrote this, as an ISO 8601 timestamp."),
16806
16806
  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."),
16807
+ 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
16808
  text: string2().describe("What the AI said.")
16808
16809
  });
16809
16810
 
@@ -16934,12 +16935,13 @@ var uploadedFileNameSchema = teamStoragePathSchema.refine((fileName) => teamStor
16934
16935
  // node_modules/@qawolf/api-contracts/dist/v1/file/requestDownload.js
16935
16936
  var makeRequestFileDownloadContract = (ids) => {
16936
16937
  const input = object({
16937
- filePath: teamStoragePathSchema.describe("The file's path in team storage, as file.requestUpload answered with."),
16938
+ filePath: teamStoragePathSchema.describe("The file's path in team storage, as the filePath file.requestUpload answered with."),
16938
16939
  workspaceId: ids.workspace.optional().describe("The workspace the file belongs to. Required when authenticating with an organization or user API key.")
16939
16940
  });
16940
16941
  const output = object({
16941
16942
  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."),
16943
+ filePath: string2().describe("The file's path in team storage."),
16944
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
16943
16945
  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
16946
  });
16945
16947
  return {
@@ -16970,7 +16972,8 @@ var makeRequestFileUploadContract = (ids) => {
16970
16972
  const output = object({
16971
16973
  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
16974
  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."),
16975
+ 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."),
16976
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
16974
16977
  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
16978
  });
16976
16979
  return {
@@ -16984,7 +16987,7 @@ var makeRequestFileUploadContract = (ids) => {
16984
16987
  openWorldHint: false,
16985
16988
  readOnlyHint: false
16986
16989
  },
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.",
16990
+ 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
16991
  input,
16989
16992
  kind: "write",
16990
16993
  name: "file.requestUpload",
@@ -17076,7 +17079,7 @@ var makeCreateRunContract = (ids) => {
17076
17079
  aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
17077
17080
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
17078
17081
  environmentId: ids.environmentRef,
17079
- environmentVariables: record(string2(), string2()).optional(),
17082
+ environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
17080
17083
  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
17084
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
17082
17085
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
@@ -17310,7 +17313,8 @@ var runnerNameSchema = _enum([
17310
17313
  "playwright",
17311
17314
  "android",
17312
17315
  "ios",
17313
- "windows"
17316
+ "windows",
17317
+ "mac"
17314
17318
  ]);
17315
17319
  var runnerWorkspaceRequirement = "Read it from whoami.";
17316
17320
  var runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;
@@ -18005,14 +18009,6 @@ var makeTriggerScheduleFields = (ids) => ({
18005
18009
  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
18010
  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
18011
  });
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
18012
 
18017
18013
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
18018
18014
  var checkAction = (action, ctx) => {
@@ -18114,6 +18110,17 @@ var checkDeployment = (value, ctx) => {
18114
18110
  };
18115
18111
  var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? checkSchedule(value, ctx) : checkDeployment(value, ctx);
18116
18112
 
18113
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
18114
+ var makeTriggerDeploymentFields = (ids) => ({
18115
+ action: makeTriggerActionSchema(ids),
18116
+ branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
18117
+ 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."),
18118
+ environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
18119
+ environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
18120
+ 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.'),
18121
+ servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
18122
+ });
18123
+
18117
18124
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
18118
18125
  var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
18119
18126
  object({
@@ -18459,13 +18466,14 @@ var makeGetAttemptContract = (ids) => {
18459
18466
  error: string2().optional(),
18460
18467
  startedAt: exports_iso.datetime().optional()
18461
18468
  });
18469
+ const artifactUrls = {
18470
+ logsUrl: url().optional(),
18471
+ traceUrl: url().optional(),
18472
+ videoUrl: url().optional()
18473
+ };
18462
18474
  const output = discriminatedUnion("artifactStatus", [
18463
18475
  response.extend({
18464
- artifacts: object({
18465
- logsUrl: url().optional(),
18466
- traceUrl: url().optional(),
18467
- videoUrl: url().optional()
18468
- }),
18476
+ artifacts: object(artifactUrls),
18469
18477
  artifactStatus: literal("signed"),
18470
18478
  attempt: attempt.extend({
18471
18479
  kind: literal("automated"),
@@ -18486,7 +18494,8 @@ var makeGetAttemptContract = (ids) => {
18486
18494
  attempt: attempt.extend({
18487
18495
  kind: literal("manual"),
18488
18496
  status: literal("passed")
18489
- })
18497
+ }),
18498
+ 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
18499
  })
18491
18500
  ]);
18492
18501
  return {
@@ -18594,7 +18603,7 @@ var makeDeploymentResourceSchema = (ids) => resource({
18594
18603
  environmentName: string2().optional().describe("The environment's name. Absent when the environment has since been deleted."),
18595
18604
  id: ids.deployment,
18596
18605
  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.'),
18606
+ 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
18607
  service: string2().optional().describe("Which application was deployed, as the deployer named it. Absent when the deployer named none."),
18599
18608
  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
18609
  }, {
@@ -18631,7 +18640,7 @@ var makeFindDeploymentsContract = (ids) => {
18631
18640
  };
18632
18641
 
18633
18642
  // 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.");
18643
+ 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
18644
  var conditionVerdictSchema = discriminatedUnion("outcome", [
18636
18645
  object({
18637
18646
  kind: conditionKindSchema,
@@ -18717,7 +18726,7 @@ var deploymentReportMetadata = strictObject({
18717
18726
  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
18727
  pullRequestNumber: number2().int().positive().describe("The number of the pull request the deployment belongs to. Requires repository.").optional(),
18719
18728
  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()
18729
+ 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
18730
  }).refine((value) => value.pullRequestNumber === undefined || value.repository !== undefined, {
18722
18731
  message: "repository is required when pullRequestNumber is provided.",
18723
18732
  path: ["pullRequestNumber"]
@@ -19010,7 +19019,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
19010
19019
  kind: _enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
19011
19020
  name: string2(),
19012
19021
  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)."),
19022
+ 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
19023
  terminatedAt: exports_iso.datetime().optional().describe("When the environment was terminated, if it has been."),
19015
19024
  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
19025
  }, { urlFieldDescription: "Absolute URL of the environment page." });
@@ -19146,14 +19155,14 @@ var makeGetEnvironmentContract = (ids) => {
19146
19155
  annotationJustifications: {
19147
19156
  destructiveHint: "Does not alter environment settings or concurrency limits.",
19148
19157
  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."
19158
+ readOnlyHint: "Retrieves an environment's configuration, release readiness and code-reconciliation state."
19150
19159
  },
19151
19160
  annotations: {
19152
19161
  destructiveHint: false,
19153
19162
  openWorldHint: false,
19154
19163
  readOnlyHint: true
19155
19164
  },
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.",
19165
+ 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
19166
  input,
19158
19167
  kind: "read",
19159
19168
  name: "environment.get",
@@ -19564,7 +19573,7 @@ var openIssueStatuses = [
19564
19573
  "paused"
19565
19574
  ];
19566
19575
  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."),
19576
+ 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
19577
  createdAt: exports_coerce.date().describe("When the issue was created."),
19569
19578
  description: string2().describe("The issue description in Markdown."),
19570
19579
  issueId: ids.issue,
@@ -19585,25 +19594,25 @@ var makeFindIssuesContract = (ids) => {
19585
19594
  const input = object({
19586
19595
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
19587
19596
  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."),
19597
+ type: publicIssueTypeSchema.describe("The issue type to include: bug report (`bug`), blocker (`maintenance`), or coverage request (`coverageRequest`)."),
19589
19598
  workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
19590
19599
  });
19591
19600
  const output = object({
19592
- issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
19601
+ issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, blockers, or coverage requests, newest first."),
19593
19602
  nextCursor: nextCursorSchema
19594
19603
  });
19595
19604
  return {
19596
19605
  annotationJustifications: {
19597
19606
  destructiveHint: "Does not edit issue details, statuses or coverage associations.",
19598
19607
  openWorldHint: "Reads QA Wolf issue records without publishing updates to linked trackers.",
19599
- readOnlyHint: "Lists workspace bug reports, maintenance reports or coverage requests."
19608
+ readOnlyHint: "Lists workspace bug reports, blockers or coverage requests."
19600
19609
  },
19601
19610
  annotations: {
19602
19611
  destructiveHint: false,
19603
19612
  openWorldHint: false,
19604
19613
  readOnlyHint: true
19605
19614
  },
19606
- description: "List the team's bug reports, maintenance reports, or coverage requests, newest first.",
19615
+ description: "List the team's bug reports, blockers, or coverage requests, newest first.",
19607
19616
  input,
19608
19617
  kind: "read",
19609
19618
  name: "issue.find",
@@ -19750,7 +19759,7 @@ var makeAddFlowsToIssueContract = (ids) => {
19750
19759
  openWorldHint: false,
19751
19760
  readOnlyHint: false
19752
19761
  },
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.",
19762
+ 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
19763
  input,
19755
19764
  kind: "write",
19756
19765
  name: "issue.addFlows",
@@ -19780,7 +19789,18 @@ var makeCreateIssueContract = (ids) => {
19780
19789
  ...commonFields,
19781
19790
  effort: _enum(["extraSmall", "small", "medium", "large", "extraLarge"]).describe("The effort to repair the flows."),
19782
19791
  priority: _enum(["low", "medium", "high", "urgent"]),
19783
- reason: _enum(["dataChanged", "flowNeedsWork", "other", "uiChanged"]).describe("Why the flows need maintenance."),
19792
+ reason: _enum([
19793
+ "featureNotAvailable",
19794
+ "needsTestData",
19795
+ "needsAccess",
19796
+ "needsConfirmation",
19797
+ "environmentUnavailable",
19798
+ "qaWolfQueue",
19799
+ "dataChanged",
19800
+ "flowNeedsWork",
19801
+ "other",
19802
+ "uiChanged"
19803
+ ]).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
19804
  type: literal("maintenance")
19785
19805
  })
19786
19806
  ]);
@@ -19798,7 +19818,7 @@ var makeCreateIssueContract = (ids) => {
19798
19818
  openWorldHint: true,
19799
19819
  readOnlyHint: false
19800
19820
  },
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.",
19821
+ 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
19822
  input,
19803
19823
  kind: "write",
19804
19824
  name: "issue.create",
@@ -19863,7 +19883,7 @@ var makeListIssueActivityContract = (ids) => {
19863
19883
  // node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
19864
19884
  var makeRemoveFlowsFromIssueContract = (ids) => {
19865
19885
  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."),
19886
+ 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
19887
  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
19888
  issueId: ids.issue
19869
19889
  });
@@ -19881,7 +19901,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
19881
19901
  openWorldHint: true,
19882
19902
  readOnlyHint: false
19883
19903
  },
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.",
19904
+ 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
19905
  input,
19886
19906
  kind: "write",
19887
19907
  name: "issue.removeFlows",
@@ -19898,7 +19918,7 @@ var makeUpdateIssueContract = (ids) => {
19898
19918
  issueId: ids.issue,
19899
19919
  name: nameSchema.optional(),
19900
19920
  priority: issuePrioritySchema.optional(),
19901
- status: issueStatusSchema.optional()
19921
+ 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
19922
  }).refine((update) => update.description !== undefined || update.name !== undefined || update.priority !== undefined || update.status !== undefined, {
19903
19923
  message: "At least one of description, name, priority, or status is required."
19904
19924
  });
@@ -19937,8 +19957,12 @@ var branchScope = union([
19937
19957
  ]);
19938
19958
  var codeHostingServiceRepository = union([
19939
19959
  object({ kind: literal("any") }),
19940
- object({ kind: literal("none") }),
19941
- object({ id: string2(), kind: literal("by-id") })
19960
+ 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."),
19961
+ object({
19962
+ 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.`),
19963
+ id: string2(),
19964
+ kind: literal("by-id")
19965
+ })
19942
19966
  ]);
19943
19967
  var makeLegacyTriggerSchema = (ids) => {
19944
19968
  const base = {
@@ -20126,14 +20150,14 @@ var makeDiagnoseRunContract = (ids) => {
20126
20150
  annotationJustifications: {
20127
20151
  destructiveHint: "Can replace a flow's existing diagnosis association and change externally reported run information.",
20128
20152
  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."
20153
+ readOnlyHint: "Records failed flows as reproductions of a selected bug report or blocker."
20130
20154
  },
20131
20155
  annotations: {
20132
20156
  destructiveHint: true,
20133
20157
  openWorldHint: true,
20134
20158
  readOnlyHint: false
20135
20159
  },
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.",
20160
+ 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
20161
  input,
20138
20162
  kind: "write",
20139
20163
  name: "run.diagnose",
@@ -20176,35 +20200,15 @@ var makeFindRunsContract = (ids) => {
20176
20200
  };
20177
20201
  };
20178
20202
 
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
- });
20203
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
20204
+ var makeFlowAttemptsSchema = (ids) => {
20202
20205
  const artifactUrls = {
20203
20206
  logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
20204
20207
  traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
20205
20208
  videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
20206
20209
  };
20207
20210
  const automatedKind = literal("automated").describe("The attempt ran on a QA Wolf runner.");
20211
+ 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
20212
  const automatedAttempt = discriminatedUnion("status", [
20209
20213
  object({
20210
20214
  ...artifactUrls,
@@ -20212,7 +20216,8 @@ var makeGetRunContract = (ids) => {
20212
20216
  completedAt: exports_iso.datetime(),
20213
20217
  kind: automatedKind,
20214
20218
  startedAt: exports_iso.datetime(),
20215
- status: literal("passed")
20219
+ status: literal("passed"),
20220
+ url: attemptUrl
20216
20221
  }),
20217
20222
  object({
20218
20223
  ...artifactUrls,
@@ -20220,7 +20225,8 @@ var makeGetRunContract = (ids) => {
20220
20225
  completedAt: exports_iso.datetime(),
20221
20226
  kind: automatedKind,
20222
20227
  startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
20223
- status: literal("failed")
20228
+ status: literal("failed"),
20229
+ url: attemptUrl
20224
20230
  }),
20225
20231
  object({
20226
20232
  attemptId: ids.runAttempt.optional(),
@@ -20228,18 +20234,47 @@ var makeGetRunContract = (ids) => {
20228
20234
  completedAt: exports_iso.datetime().optional(),
20229
20235
  kind: automatedKind,
20230
20236
  startedAt: exports_iso.datetime().optional(),
20231
- status: literal("canceled").describe("The attempt was terminated without reaching a verdict.")
20237
+ status: literal("canceled").describe("The attempt was terminated without reaching a verdict."),
20238
+ url: attemptUrl
20232
20239
  })
20233
20240
  ]);
20234
20241
  const manualAttempt = object({
20242
+ ...artifactUrls,
20235
20243
  attemptId: ids.runAttempt.optional(),
20236
20244
  completedAt: exports_iso.datetime(),
20237
20245
  kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
20238
20246
  startedAt: exports_iso.datetime(),
20239
- status: literal("passed")
20247
+ status: literal("passed"),
20248
+ url: attemptUrl
20240
20249
  });
20241
20250
  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.");
20251
+ 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.");
20252
+ };
20253
+
20254
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
20255
+ var makeFlowFailureSchema = (ids) => {
20256
+ const diagnosis = object({
20257
+ issueId: ids.issue,
20258
+ type: _enum(["bug", "maintenance"])
20259
+ }).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.");
20260
+ const optedOutOfInvestigation = object({
20261
+ 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.")
20262
+ }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
20263
+ return object({
20264
+ diagnosis,
20265
+ error: string2(),
20266
+ optedOutOfInvestigation
20267
+ });
20268
+ };
20269
+
20270
+ // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
20271
+ var makeGetRunContract = (ids) => {
20272
+ const flowStatus = _enum(publicRunStatusValues);
20273
+ const input = object({
20274
+ 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."),
20275
+ runId: ids.run
20276
+ });
20277
+ const attempts = makeFlowAttemptsSchema(ids);
20243
20278
  const failedFlow = object({
20244
20279
  attempts,
20245
20280
  failure: makeFlowFailureSchema(ids),
@@ -20293,14 +20328,14 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
20293
20328
  annotationJustifications: {
20294
20329
  destructiveHint: "Ends the investigation of the selected failures and changes externally reported run information.",
20295
20330
  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."
20331
+ readOnlyHint: "Records failed flows as needing no bug report or blocker."
20297
20332
  },
20298
20333
  annotations: {
20299
20334
  destructiveHint: true,
20300
20335
  openWorldHint: true,
20301
20336
  readOnlyHint: false
20302
20337
  },
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.",
20338
+ 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
20339
  input,
20305
20340
  kind: "write",
20306
20341
  name: "run.optOutOfInvestigation",
@@ -20311,13 +20346,20 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
20311
20346
  // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
20312
20347
  var makeReattemptRunContract = (ids) => {
20313
20348
  const input = object({
20349
+ 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."),
20350
+ aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive the new attempts' results."),
20351
+ chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive the new attempts' results."),
20314
20352
  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
20353
  runId: ids.run
20354
+ }).refine((value) => !(value.aiTaskId && value.chatSessionId), {
20355
+ message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
20356
+ path: ["chatSessionId"]
20316
20357
  });
20317
20358
  const output = resource({
20318
20359
  reattemptedFlowIds: array(ids.flow).describe("The flows a new attempt was requested for."),
20319
20360
  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
20361
+ runId: ids.run,
20362
+ 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
20363
  }, { urlFieldDescription: "Absolute URL of the run page." });
20322
20364
  return {
20323
20365
  annotationJustifications: {
@@ -20330,7 +20372,7 @@ var makeReattemptRunContract = (ids) => {
20330
20372
  openWorldHint: true,
20331
20373
  readOnlyHint: false
20332
20374
  },
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.",
20375
+ 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
20376
  input,
20335
20377
  kind: "write",
20336
20378
  name: "run.reattempt",
@@ -20876,7 +20918,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
20876
20918
  openWorldHint: false,
20877
20919
  readOnlyHint: false
20878
20920
  },
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}`,
20921
+ 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
20922
  input,
20881
20923
  kind: "read",
20882
20924
  name: "runner.takeScreenshot",
@@ -23582,7 +23624,7 @@ function startUpdateCheck(deps) {
23582
23624
  // package.json
23583
23625
  var package_default = {
23584
23626
  name: "@qawolf/cli",
23585
- version: "2.1.0",
23627
+ version: "2.2.0",
23586
23628
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
23587
23629
  keywords: [
23588
23630
  "automation",
@@ -23654,7 +23696,7 @@ var package_default = {
23654
23696
  "@clack/prompts": "1.5.1",
23655
23697
  "@napi-rs/keyring": "1.3.0",
23656
23698
  "@oxc-node/core": "0.1.0",
23657
- "@qawolf/api-contracts": "0.91.0",
23699
+ "@qawolf/api-contracts": "0.98.1",
23658
23700
  "@qawolf/emails": "1.1.1",
23659
23701
  "@qawolf/flow-targets": "2.0.0",
23660
23702
  "@qawolf/flows": "0.3.0",
@@ -38770,9 +38812,10 @@ function buildRunnerAction(type, flags) {
38770
38812
  const to = flags.to === undefined ? undefined : parsePoint("--to", flags.to);
38771
38813
  if (to !== undefined && !to.ok)
38772
38814
  return to;
38815
+ const button = flags.button ?? (type === "click" ? "left" : undefined);
38773
38816
  const candidate = {
38774
38817
  type,
38775
- ...flags.button === undefined ? {} : { button: flags.button },
38818
+ ...button === undefined ? {} : { button },
38776
38819
  ...flags.durationMs === undefined ? {} : { duration_ms: toNumber(flags.durationMs) },
38777
38820
  ...from === undefined ? {} : { from: from.value },
38778
38821
  ...flags.keys === undefined ? {} : { keys: flags.keys },
@@ -40587,7 +40630,7 @@ Examples:
40587
40630
  $ qawolf runner screenshot --out - | my-vision-tool`;
40588
40631
  function registerRunnerInteractCommands(runner, signals) {
40589
40632
  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, {
40633
+ 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
40634
  flags: {
40592
40635
  button: opts.button,
40593
40636
  durationMs: opts.durationMs,
@@ -41787,4 +41830,4 @@ createProgram({ signals }).parseAsync().catch(() => {
41787
41830
  process.exitCode = 1;
41788
41831
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
41789
41832
 
41790
- //# debugId=FFFD1A9214AB797D64756E2164756E21
41833
+ //# debugId=59930438C8ECAB2864756E2164756E21
@@ -7104,6 +7104,7 @@ var agentSessionStatusSchema = _enum(agentSessionStatuses).describe('Where the w
7104
7104
  var agentReplySchema = object({
7105
7105
  askedAt: exports_iso.datetime().describe("When the AI wrote this, as an ISO 8601 timestamp."),
7106
7106
  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."),
7107
+ 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."),
7107
7108
  text: string2().describe("What the AI said.")
7108
7109
  });
7109
7110
 
@@ -7234,12 +7235,13 @@ var uploadedFileNameSchema = teamStoragePathSchema.refine((fileName) => teamStor
7234
7235
  // node_modules/@qawolf/api-contracts/dist/v1/file/requestDownload.js
7235
7236
  var makeRequestFileDownloadContract = (ids) => {
7236
7237
  const input = object({
7237
- filePath: teamStoragePathSchema.describe("The file's path in team storage, as file.requestUpload answered with."),
7238
+ filePath: teamStoragePathSchema.describe("The file's path in team storage, as the filePath file.requestUpload answered with."),
7238
7239
  workspaceId: ids.workspace.optional().describe("The workspace the file belongs to. Required when authenticating with an organization or user API key.")
7239
7240
  });
7240
7241
  const output = object({
7241
7242
  expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
7242
- path: string2().describe("The file's path in team storage."),
7243
+ filePath: string2().describe("The file's path in team storage."),
7244
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
7243
7245
  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.')
7244
7246
  });
7245
7247
  return {
@@ -7270,7 +7272,8 @@ var makeRequestFileUploadContract = (ids) => {
7270
7272
  const output = object({
7271
7273
  contentType: string2().describe("Send this as the PUT's `Content-Type` header, exactly. The URL is signed for it and refuses any other value."),
7272
7274
  expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
7273
- 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."),
7275
+ 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."),
7276
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
7274
7277
  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.`)
7275
7278
  });
7276
7279
  return {
@@ -7284,7 +7287,7 @@ var makeRequestFileUploadContract = (ids) => {
7284
7287
  openWorldHint: false,
7285
7288
  readOnlyHint: false
7286
7289
  },
7287
- 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.",
7290
+ 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.",
7288
7291
  input,
7289
7292
  kind: "write",
7290
7293
  name: "file.requestUpload",
@@ -7376,7 +7379,7 @@ var makeCreateRunContract = (ids) => {
7376
7379
  aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
7377
7380
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
7378
7381
  environmentId: ids.environmentRef,
7379
- environmentVariables: record(string2(), string2()).optional(),
7382
+ environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
7380
7383
  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),
7381
7384
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
7382
7385
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
@@ -7611,7 +7614,8 @@ var runnerNameSchema = _enum([
7611
7614
  "playwright",
7612
7615
  "android",
7613
7616
  "ios",
7614
- "windows"
7617
+ "windows",
7618
+ "mac"
7615
7619
  ]);
7616
7620
  var runnerWorkspaceRequirement = "Read it from whoami.";
7617
7621
  var runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;
@@ -8311,14 +8315,6 @@ var makeTriggerScheduleFields = (ids) => ({
8311
8315
  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.'),
8312
8316
  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.")
8313
8317
  });
8314
- var makeTriggerDeploymentFields = (ids) => ({
8315
- action: makeTriggerActionSchema(ids),
8316
- branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
8317
- 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."),
8318
- environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
8319
- environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
8320
- servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
8321
- });
8322
8318
 
8323
8319
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
8324
8320
  var checkAction = (action, ctx) => {
@@ -8420,6 +8416,17 @@ var checkDeployment = (value, ctx) => {
8420
8416
  };
8421
8417
  var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? checkSchedule(value, ctx) : checkDeployment(value, ctx);
8422
8418
 
8419
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
8420
+ var makeTriggerDeploymentFields = (ids) => ({
8421
+ action: makeTriggerActionSchema(ids),
8422
+ branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
8423
+ 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."),
8424
+ environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
8425
+ environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
8426
+ 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.'),
8427
+ servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
8428
+ });
8429
+
8423
8430
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
8424
8431
  var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
8425
8432
  object({
@@ -8765,13 +8772,14 @@ var makeGetAttemptContract = (ids) => {
8765
8772
  error: string2().optional(),
8766
8773
  startedAt: exports_iso.datetime().optional()
8767
8774
  });
8775
+ const artifactUrls = {
8776
+ logsUrl: url().optional(),
8777
+ traceUrl: url().optional(),
8778
+ videoUrl: url().optional()
8779
+ };
8768
8780
  const output = discriminatedUnion("artifactStatus", [
8769
8781
  response.extend({
8770
- artifacts: object({
8771
- logsUrl: url().optional(),
8772
- traceUrl: url().optional(),
8773
- videoUrl: url().optional()
8774
- }),
8782
+ artifacts: object(artifactUrls),
8775
8783
  artifactStatus: literal("signed"),
8776
8784
  attempt: attempt.extend({
8777
8785
  kind: literal("automated"),
@@ -8792,7 +8800,8 @@ var makeGetAttemptContract = (ids) => {
8792
8800
  attempt: attempt.extend({
8793
8801
  kind: literal("manual"),
8794
8802
  status: literal("passed")
8795
- })
8803
+ }),
8804
+ 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.")
8796
8805
  })
8797
8806
  ]);
8798
8807
  return {
@@ -8900,7 +8909,7 @@ var makeDeploymentResourceSchema = (ids) => resource({
8900
8909
  environmentName: string2().optional().describe("The environment's name. Absent when the environment has since been deleted."),
8901
8910
  id: ids.deployment,
8902
8911
  provider: _enum(["github", "gitlab", "api"]).optional().describe("How QA Wolf received the deployment: a GitHub webhook, a GitLab webhook, or the deployment.reportStatus API."),
8903
- 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.'),
8912
+ 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.`),
8904
8913
  service: string2().optional().describe("Which application was deployed, as the deployer named it. Absent when the deployer named none."),
8905
8914
  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.")
8906
8915
  }, {
@@ -8937,7 +8946,7 @@ var makeFindDeploymentsContract = (ids) => {
8937
8946
  };
8938
8947
 
8939
8948
  // node_modules/@qawolf/api-contracts/dist/v1/deployment/listTriggerEvaluations.js
8940
- 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.");
8949
+ 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.");
8941
8950
  var conditionVerdictSchema = discriminatedUnion("outcome", [
8942
8951
  object({
8943
8952
  kind: conditionKindSchema,
@@ -9023,7 +9032,7 @@ var deploymentReportMetadata = strictObject({
9023
9032
  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(),
9024
9033
  pullRequestNumber: number2().int().positive().describe("The number of the pull request the deployment belongs to. Requires repository.").optional(),
9025
9034
  ref: string2().trim().min(1).max(255).describe("The branch or ref that was deployed.").optional(),
9026
- repository: string2().trim().min(1).max(255).describe('The owner/name of the repository, e.g. "acme/web".').optional()
9035
+ 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()
9027
9036
  }).refine((value) => value.pullRequestNumber === undefined || value.repository !== undefined, {
9028
9037
  message: "repository is required when pullRequestNumber is provided.",
9029
9038
  path: ["pullRequestNumber"]
@@ -9316,7 +9325,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
9316
9325
  kind: _enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
9317
9326
  name: string2(),
9318
9327
  runConcurrencyLimit: string2().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
9319
- 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)."),
9328
+ 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."),
9320
9329
  terminatedAt: exports_iso.datetime().optional().describe("When the environment was terminated, if it has been."),
9321
9330
  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.")
9322
9331
  }, { urlFieldDescription: "Absolute URL of the environment page." });
@@ -9452,14 +9461,14 @@ var makeGetEnvironmentContract = (ids) => {
9452
9461
  annotationJustifications: {
9453
9462
  destructiveHint: "Does not alter environment settings or concurrency limits.",
9454
9463
  openWorldHint: "Reads QA Wolf environment state without updating the connected Git provider.",
9455
- readOnlyHint: "Retrieves an environment's configuration, run health and code-reconciliation state."
9464
+ readOnlyHint: "Retrieves an environment's configuration, release readiness and code-reconciliation state."
9456
9465
  },
9457
9466
  annotations: {
9458
9467
  destructiveHint: false,
9459
9468
  openWorldHint: false,
9460
9469
  readOnlyHint: true
9461
9470
  },
9462
- 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.",
9471
+ 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.",
9463
9472
  input,
9464
9473
  kind: "read",
9465
9474
  name: "environment.get",
@@ -9870,7 +9879,7 @@ var openIssueStatuses = [
9870
9879
  "paused"
9871
9880
  ];
9872
9881
  var makeIssueResourceSchema = (ids) => resource({
9873
- coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug and maintenance reports, whose flows are listed under reproductions."),
9882
+ coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
9874
9883
  createdAt: exports_coerce.date().describe("When the issue was created."),
9875
9884
  description: string2().describe("The issue description in Markdown."),
9876
9885
  issueId: ids.issue,
@@ -9891,25 +9900,25 @@ var makeFindIssuesContract = (ids) => {
9891
9900
  const input = object({
9892
9901
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
9893
9902
  statuses: array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to backlog, pending, in-progress, and paused issues."),
9894
- type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
9903
+ type: publicIssueTypeSchema.describe("The issue type to include: bug report (`bug`), blocker (`maintenance`), or coverage request (`coverageRequest`)."),
9895
9904
  workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
9896
9905
  });
9897
9906
  const output = object({
9898
- issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
9907
+ issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, blockers, or coverage requests, newest first."),
9899
9908
  nextCursor: nextCursorSchema
9900
9909
  });
9901
9910
  return {
9902
9911
  annotationJustifications: {
9903
9912
  destructiveHint: "Does not edit issue details, statuses or coverage associations.",
9904
9913
  openWorldHint: "Reads QA Wolf issue records without publishing updates to linked trackers.",
9905
- readOnlyHint: "Lists workspace bug reports, maintenance reports or coverage requests."
9914
+ readOnlyHint: "Lists workspace bug reports, blockers or coverage requests."
9906
9915
  },
9907
9916
  annotations: {
9908
9917
  destructiveHint: false,
9909
9918
  openWorldHint: false,
9910
9919
  readOnlyHint: true
9911
9920
  },
9912
- description: "List the team's bug reports, maintenance reports, or coverage requests, newest first.",
9921
+ description: "List the team's bug reports, blockers, or coverage requests, newest first.",
9913
9922
  input,
9914
9923
  kind: "read",
9915
9924
  name: "issue.find",
@@ -10056,7 +10065,7 @@ var makeAddFlowsToIssueContract = (ids) => {
10056
10065
  openWorldHint: false,
10057
10066
  readOnlyHint: false
10058
10067
  },
10059
- 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.",
10068
+ 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.",
10060
10069
  input,
10061
10070
  kind: "write",
10062
10071
  name: "issue.addFlows",
@@ -10086,7 +10095,18 @@ var makeCreateIssueContract = (ids) => {
10086
10095
  ...commonFields,
10087
10096
  effort: _enum(["extraSmall", "small", "medium", "large", "extraLarge"]).describe("The effort to repair the flows."),
10088
10097
  priority: _enum(["low", "medium", "high", "urgent"]),
10089
- reason: _enum(["dataChanged", "flowNeedsWork", "other", "uiChanged"]).describe("Why the flows need maintenance."),
10098
+ reason: _enum([
10099
+ "featureNotAvailable",
10100
+ "needsTestData",
10101
+ "needsAccess",
10102
+ "needsConfirmation",
10103
+ "environmentUnavailable",
10104
+ "qaWolfQueue",
10105
+ "dataChanged",
10106
+ "flowNeedsWork",
10107
+ "other",
10108
+ "uiChanged"
10109
+ ]).describe('What the blocked flows wait on. "qaWolfQueue" is only for full-service workspaces. "dataChanged", "flowNeedsWork", "other" and "uiChanged" are deprecated and still accepted.'),
10090
10110
  type: literal("maintenance")
10091
10111
  })
10092
10112
  ]);
@@ -10104,7 +10124,7 @@ var makeCreateIssueContract = (ids) => {
10104
10124
  openWorldHint: true,
10105
10125
  readOnlyHint: false
10106
10126
  },
10107
- 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.",
10127
+ 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.",
10108
10128
  input,
10109
10129
  kind: "write",
10110
10130
  name: "issue.create",
@@ -10169,7 +10189,7 @@ var makeListIssueActivityContract = (ids) => {
10169
10189
  // node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
10170
10190
  var makeRemoveFlowsFromIssueContract = (ids) => {
10171
10191
  const input = object({
10172
- 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."),
10192
+ 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."),
10173
10193
  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."),
10174
10194
  issueId: ids.issue
10175
10195
  });
@@ -10187,7 +10207,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
10187
10207
  openWorldHint: true,
10188
10208
  readOnlyHint: false
10189
10209
  },
10190
- 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.",
10210
+ 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.",
10191
10211
  input,
10192
10212
  kind: "write",
10193
10213
  name: "issue.removeFlows",
@@ -10204,7 +10224,7 @@ var makeUpdateIssueContract = (ids) => {
10204
10224
  issueId: ids.issue,
10205
10225
  name: nameSchema.optional(),
10206
10226
  priority: issuePrioritySchema.optional(),
10207
- status: issueStatusSchema.optional()
10227
+ 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.")
10208
10228
  }).refine((update) => update.description !== undefined || update.name !== undefined || update.priority !== undefined || update.status !== undefined, {
10209
10229
  message: "At least one of description, name, priority, or status is required."
10210
10230
  });
@@ -10243,8 +10263,12 @@ var branchScope = union([
10243
10263
  ]);
10244
10264
  var codeHostingServiceRepository = union([
10245
10265
  object({ kind: literal("any") }),
10246
- object({ kind: literal("none") }),
10247
- object({ id: string2(), kind: literal("by-id") })
10266
+ 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."),
10267
+ object({
10268
+ 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.`),
10269
+ id: string2(),
10270
+ kind: literal("by-id")
10271
+ })
10248
10272
  ]);
10249
10273
  var makeLegacyTriggerSchema = (ids) => {
10250
10274
  const base = {
@@ -10432,14 +10456,14 @@ var makeDiagnoseRunContract = (ids) => {
10432
10456
  annotationJustifications: {
10433
10457
  destructiveHint: "Can replace a flow's existing diagnosis association and change externally reported run information.",
10434
10458
  openWorldHint: "Recorded diagnosis changes can update run-related messages in configured external integrations.",
10435
- readOnlyHint: "Records failed flows as reproductions of a selected bug or maintenance issue."
10459
+ readOnlyHint: "Records failed flows as reproductions of a selected bug report or blocker."
10436
10460
  },
10437
10461
  annotations: {
10438
10462
  destructiveHint: true,
10439
10463
  openWorldHint: true,
10440
10464
  readOnlyHint: false
10441
10465
  },
10442
- 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.",
10466
+ 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.",
10443
10467
  input,
10444
10468
  kind: "write",
10445
10469
  name: "run.diagnose",
@@ -10482,35 +10506,15 @@ var makeFindRunsContract = (ids) => {
10482
10506
  };
10483
10507
  };
10484
10508
 
10485
- // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
10486
- var makeFlowFailureSchema = (ids) => {
10487
- const diagnosis = object({
10488
- issueId: ids.issue,
10489
- type: _enum(["bug", "maintenance"])
10490
- }).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.");
10491
- const optedOutOfInvestigation = object({
10492
- 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.")
10493
- }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
10494
- return object({
10495
- diagnosis,
10496
- error: string2(),
10497
- optedOutOfInvestigation
10498
- });
10499
- };
10500
-
10501
- // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
10502
- var makeGetRunContract = (ids) => {
10503
- const flowStatus = _enum(publicRunStatusValues);
10504
- const input = object({
10505
- 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."),
10506
- runId: ids.run
10507
- });
10509
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
10510
+ var makeFlowAttemptsSchema = (ids) => {
10508
10511
  const artifactUrls = {
10509
10512
  logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
10510
10513
  traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
10511
10514
  videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
10512
10515
  };
10513
10516
  const automatedKind = literal("automated").describe("The attempt ran on a QA Wolf runner.");
10517
+ 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.");
10514
10518
  const automatedAttempt = discriminatedUnion("status", [
10515
10519
  object({
10516
10520
  ...artifactUrls,
@@ -10518,7 +10522,8 @@ var makeGetRunContract = (ids) => {
10518
10522
  completedAt: exports_iso.datetime(),
10519
10523
  kind: automatedKind,
10520
10524
  startedAt: exports_iso.datetime(),
10521
- status: literal("passed")
10525
+ status: literal("passed"),
10526
+ url: attemptUrl
10522
10527
  }),
10523
10528
  object({
10524
10529
  ...artifactUrls,
@@ -10526,7 +10531,8 @@ var makeGetRunContract = (ids) => {
10526
10531
  completedAt: exports_iso.datetime(),
10527
10532
  kind: automatedKind,
10528
10533
  startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
10529
- status: literal("failed")
10534
+ status: literal("failed"),
10535
+ url: attemptUrl
10530
10536
  }),
10531
10537
  object({
10532
10538
  attemptId: ids.runAttempt.optional(),
@@ -10534,18 +10540,47 @@ var makeGetRunContract = (ids) => {
10534
10540
  completedAt: exports_iso.datetime().optional(),
10535
10541
  kind: automatedKind,
10536
10542
  startedAt: exports_iso.datetime().optional(),
10537
- status: literal("canceled").describe("The attempt was terminated without reaching a verdict.")
10543
+ status: literal("canceled").describe("The attempt was terminated without reaching a verdict."),
10544
+ url: attemptUrl
10538
10545
  })
10539
10546
  ]);
10540
10547
  const manualAttempt = object({
10548
+ ...artifactUrls,
10541
10549
  attemptId: ids.runAttempt.optional(),
10542
10550
  completedAt: exports_iso.datetime(),
10543
10551
  kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
10544
10552
  startedAt: exports_iso.datetime(),
10545
- status: literal("passed")
10553
+ status: literal("passed"),
10554
+ url: attemptUrl
10546
10555
  });
10547
10556
  const attempt = union([automatedAttempt, manualAttempt]);
10548
- 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.");
10557
+ 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.");
10558
+ };
10559
+
10560
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
10561
+ var makeFlowFailureSchema = (ids) => {
10562
+ const diagnosis = object({
10563
+ issueId: ids.issue,
10564
+ type: _enum(["bug", "maintenance"])
10565
+ }).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.");
10566
+ const optedOutOfInvestigation = object({
10567
+ 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.")
10568
+ }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
10569
+ return object({
10570
+ diagnosis,
10571
+ error: string2(),
10572
+ optedOutOfInvestigation
10573
+ });
10574
+ };
10575
+
10576
+ // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
10577
+ var makeGetRunContract = (ids) => {
10578
+ const flowStatus = _enum(publicRunStatusValues);
10579
+ const input = object({
10580
+ 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."),
10581
+ runId: ids.run
10582
+ });
10583
+ const attempts = makeFlowAttemptsSchema(ids);
10549
10584
  const failedFlow = object({
10550
10585
  attempts,
10551
10586
  failure: makeFlowFailureSchema(ids),
@@ -10599,14 +10634,14 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
10599
10634
  annotationJustifications: {
10600
10635
  destructiveHint: "Ends the investigation of the selected failures and changes externally reported run information.",
10601
10636
  openWorldHint: "Recorded opt-outs can update run-related messages in configured external integrations.",
10602
- readOnlyHint: "Records failed flows as needing no bug or maintenance report."
10637
+ readOnlyHint: "Records failed flows as needing no bug report or blocker."
10603
10638
  },
10604
10639
  annotations: {
10605
10640
  destructiveHint: true,
10606
10641
  openWorldHint: true,
10607
10642
  readOnlyHint: false
10608
10643
  },
10609
- 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.",
10644
+ 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.",
10610
10645
  input,
10611
10646
  kind: "write",
10612
10647
  name: "run.optOutOfInvestigation",
@@ -10617,13 +10652,20 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
10617
10652
  // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
10618
10653
  var makeReattemptRunContract = (ids) => {
10619
10654
  const input = object({
10655
+ 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."),
10656
+ aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive the new attempts' results."),
10657
+ chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive the new attempts' results."),
10620
10658
  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."),
10621
10659
  runId: ids.run
10660
+ }).refine((value) => !(value.aiTaskId && value.chatSessionId), {
10661
+ message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
10662
+ path: ["chatSessionId"]
10622
10663
  });
10623
10664
  const output = resource({
10624
10665
  reattemptedFlowIds: array(ids.flow).describe("The flows a new attempt was requested for."),
10625
10666
  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."),
10626
- runId: ids.run
10667
+ runId: ids.run,
10668
+ 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.`)
10627
10669
  }, { urlFieldDescription: "Absolute URL of the run page." });
10628
10670
  return {
10629
10671
  annotationJustifications: {
@@ -10636,7 +10678,7 @@ var makeReattemptRunContract = (ids) => {
10636
10678
  openWorldHint: true,
10637
10679
  readOnlyHint: false
10638
10680
  },
10639
- 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.",
10681
+ 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.",
10640
10682
  input,
10641
10683
  kind: "write",
10642
10684
  name: "run.reattempt",
@@ -11182,7 +11224,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
11182
11224
  openWorldHint: false,
11183
11225
  readOnlyHint: false
11184
11226
  },
11185
- 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}`,
11227
+ 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}`,
11186
11228
  input,
11187
11229
  kind: "read",
11188
11230
  name: "runner.takeScreenshot",
@@ -16032,4 +16074,4 @@ export {
16032
16074
  createRunnerSdk
16033
16075
  };
16034
16076
 
16035
- //# debugId=991A751E681DB2D264756E2164756E21
16077
+ //# debugId=56D1BCF300A31BCC64756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.1.0",
3
+ "version": "2.2.0",
4
4
  "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
5
5
  "keywords": [
6
6
  "automation",
@@ -72,7 +72,7 @@
72
72
  "@clack/prompts": "1.5.1",
73
73
  "@napi-rs/keyring": "1.3.0",
74
74
  "@oxc-node/core": "0.1.0",
75
- "@qawolf/api-contracts": "0.91.0",
75
+ "@qawolf/api-contracts": "0.98.1",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "@qawolf/flows": "0.3.0",
@@ -151,7 +151,7 @@ that `url`; never guess a route and never send a repository link in its place.
151
151
  | `qawolf environment create` | write | Create an environment on the caller's team and return it in the environment.get shape. This can also create a branch on the team's connected Git provider. |
152
152
  | `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
153
153
  | `qawolf environment find` | read | List the team's environments, newest first. |
154
- | `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. |
154
+ | `qawolf environment get` | read | 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. |
155
155
  | `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. |
156
156
  | `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. |
157
157
  | `qawolf environment promote` | write | Declare a preview environment's work accepted, typically when its pull request merges: its flow changes are promoted into its base environment and the environment is terminated once they land. Returns the promotion in pending; poll promotion.get to learn how it settled. Calling again while a promotion is open returns that promotion. A conflict settles the promotion conflicted and cancels the environment's in-progress runs; promotion.get names the conflicting paths. Use environment.terminate instead when the work is abandoned. |
@@ -159,7 +159,7 @@ that `url`; never guess a route and never send a repository link in its place.
159
159
  | `qawolf environment terminate` | write | Terminate a preview environment, typically when its pull request closes without merging: its flow changes are not promoted into its base. Returns the environment, now terminated. A terminated environment cannot be terminated again. Use environment.promote instead when the work is accepted. |
160
160
  | `qawolf environment update` | write | Update an environment owned by the caller's team and return it in the environment.get shape. Omitted fields remain unchanged. |
161
161
  | `qawolf file requestDownload` | read | Get a URL for reading a file out of the caller's team storage. Answers 404 when nothing is stored at that path. |
162
- | `qawolf file requestUpload` | write | 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. |
162
+ | `qawolf file requestUpload` | write | 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. |
163
163
  | `qawolf flow addTag` | write | Assign an existing tag to the selected flows. Create tags with tag.create. Flows that already carry the tag are reported in skippedFlows. |
164
164
  | `qawolf flow getHistory` | read | List one flow's results across runs in an environment, newest first, with status, attempts, duration, and diagnosis. Use it to spot flakiness, failure streaks, and duration trends. |
165
165
  | `qawolf flow removeTag` | write | Remove a tag from the selected flows. Succeeds whether or not each flow carried the tag; the flows that did not are reported in skippedFlows. |
@@ -173,12 +173,12 @@ that `url`; never guess a route and never send a repository link in its place.
173
173
  | `qawolf install browsers` | local | Install Playwright browsers used by the project's web flows |
174
174
  | `qawolf install clear` | local | Remove the managed runtime cache (all installed runtime versions) |
175
175
  | `qawolf investigation get` | read | Read what the QA Wolf AI investigating a run has concluded: one finding per cause of its failures, with the question waiting for a person and any answer or dispute the investigation hasn't acted on yet. A run that automatic investigation does not cover answers status "not-enabled". |
176
- | `qawolf issue addFlows` | write | 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. |
177
- | `qawolf issue create` | write | 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. |
178
- | `qawolf issue find` | read | List the team's bug reports, maintenance reports, or coverage requests, newest first. |
176
+ | `qawolf issue addFlows` | write | 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. |
177
+ | `qawolf issue create` | write | 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. |
178
+ | `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
179
179
  | `qawolf issue get` | read | Get an issue by id. |
180
180
  | `qawolf issue listActivity` | read | List an issue's activity, oldest first: creation, status and priority changes, and the flows that started or stopped reproducing it. Use it to measure time to fix or to find issues that came back. |
181
- | `qawolf issue removeFlows` | write | 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. |
181
+ | `qawolf issue removeFlows` | write | 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. |
182
182
  | `qawolf issue update` | write | Update an issue owned by the caller's team. Omitted fields remain unchanged. |
183
183
  | `qawolf legacyTrigger find` | read | List a workspace's legacy per-environment triggers; trigger.find lists the current ones. For migration only; it goes when legacy triggers go. adaptiveFlowSelection becomes a generativeSuite action, which takes no tags. |
184
184
  | `qawolf legacyTrigger pause` | write | Pause one legacy trigger, the older per-environment kind, so it stops firing; use trigger.pause for a current one. Its copies in pull request environments pause too. For migration only; it goes when legacy triggers go. |
@@ -188,12 +188,12 @@ that `url`; never guess a route and never send a repository link in its place.
188
188
  | `qawolf promotion resolve` | write | Submit the resolution of a conflicted promotion: the full resolved contents of every conflicting path to keep, and every conflicting path to delete. Together they must cover exactly the paths in the promotion's conflict, and both commit hashes must match the conflict's; if a branch moved since, the call is refused as stale-conflict and promotion.get has the current conflict. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied. |
189
189
  | `qawolf run acceptScreenshotBaseline` | write | Make the new screenshot of a failed screenshot comparison the baseline, so later runs compare with it. Use it only when the difference is an intended change of the app, not a bug, noise, or a page that was not ready. Every later run of every environment of the workspace compares with the new baseline. Refuses without changing anything when the baseline changed since the run. |
190
190
  | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
191
- | `qawolf run diagnose` | write | 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. |
191
+ | `qawolf run diagnose` | write | 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. |
192
192
  | `qawolf run find` | read | List an environment's recent runs, newest first, including failed-attempt discovery metadata. |
193
193
  | `qawolf run get` | read | Get a run's status, per-flow results, links, and how many of its bugs are blocking. |
194
194
  | `qawolf run listScreenshotComparisons` | read | List the screenshot comparisons that failed a run's flows, with the expected, actual and diff images of each. Only comparisons that caused a failure are listed: a screenshot that differs within tolerance, or that differs on a line that did not fail, is left out. Each comparison tells whether its baseline changed since the run and whether the baseline still passes in other environments. The image URLs expire after a few minutes; fetch the preview URLs to look at the images. The first call for an image makes its missing JPEG preview and keeps it in team storage, so later calls reuse it. |
195
- | `qawolf run optOutOfInvestigation` | write | 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. |
196
- | `qawolf run reattempt` | write | 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. |
195
+ | `qawolf run optOutOfInvestigation` | write | 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. |
196
+ | `qawolf run reattempt` | write | 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. |
197
197
  | `qawolf run restoreScreenshotBaseline` | write | Undo a screenshot baseline change that accepted a failed comparison of the run: put back the baseline it replaced, so later runs compare with the old baseline again. Use it when a person disputes a baseline the AI accepted. Refuses without changing anything when the baseline changed again since. |
198
198
  | `qawolf run stop` | write | Stop a run, including its queued flows and automatic retries. Stopping is asynchronous and can update run-status messages and commit statuses in connected integrations. Repeated requests are safe, and finished runs keep their results. A run that is still being created returns not found; retry once run.get returns the run. If run.get returns a different runId, use that ID. Poll run.get for results. |
199
199
  | `qawolf runner act` | write | 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 |
@@ -193,7 +193,7 @@ Every documented field of the `run.get` response. `[]` marks an array, so
193
193
  - `supersededBy.url` — Absolute URL of the replacement run's page.
194
194
  - `blockingBugCount` — How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved.
195
195
  - `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
196
- - `flows[].attempts` — 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.
196
+ - `flows[].attempts` — 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.
197
197
  - `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.
198
198
  - `flows[].attempts[].traceUrl` — Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`).
199
199
  - `flows[].attempts[].videoUrl` — Signed URL for the attempt's screen recording.
@@ -201,6 +201,7 @@ Every documented field of the `run.get` response. `[]` marks an array, so
201
201
  - `flows[].attempts[].kind` — One of: automated, manual
202
202
  - `flows[].attempts[].startedAt` — Absent when the attempt failed before it could start.
203
203
  - `flows[].attempts[].status` — One of: passed, failed, canceled
204
+ - `flows[].attempts[].url` — 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.
204
205
  - `flows[].attempts[].canceledReason` — Why the attempt was canceled. userCanceled means a person stopped it; do not immediately retry that activity.
205
206
  - `flows[].failure.diagnosis` — 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.
206
207
  - `flows[].failure.diagnosis.issueId` — The id of the issue.
@@ -583,7 +583,7 @@ other browser actions with action-not-supported-on-mobile. Use - to read a whole
583
583
  stdin
584
584
 
585
585
  Options:
586
- --button <button> click: left, right, wheel, back or forward
586
+ --button <button> click: left (default), right, wheel, back or forward
587
587
  --duration-ms <ms> swipe: how long it takes, up to 10000. Slow scrolls, fast flings
588
588
  --from <x,y> swipe: the point it starts at
589
589
  --keys <keys...> keypress: modifiers and the key, e.g. Control a