@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
|
-
|
|
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
|
-
|
|
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
|
|
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(
|
|
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
|
|
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(
|
|
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("
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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,
|
|
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,
|
|
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,
|
|
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
|
|
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([
|
|
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
|
|
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
|
|
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
|
|
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({
|
|
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
|
|
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: "
|
|
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/
|
|
20180
|
-
var
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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
|
-
...
|
|
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=
|
|
41833
|
+
//# debugId=59930438C8ECAB2864756E2164756E21
|
package/dist/runner-sdk.js
CHANGED
|
@@ -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
|
-
|
|
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
|
-
|
|
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
|
|
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(
|
|
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
|
|
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(
|
|
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("
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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,
|
|
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,
|
|
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,
|
|
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
|
|
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([
|
|
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
|
|
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
|
|
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
|
|
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({
|
|
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
|
|
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: "
|
|
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/
|
|
10486
|
-
var
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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=
|
|
16077
|
+
//# debugId=56D1BCF300A31BCC64756E2164756E21
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qawolf/cli",
|
|
3
|
-
"version": "2.
|
|
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.
|
|
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,
|
|
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
|
|
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
|
|
177
|
-
| `qawolf issue create` | write | Create a bug report, maintenance
|
|
178
|
-
| `qawolf issue find` | read | List the team's bug reports,
|
|
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
|
|
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 |
|
|
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
|
|
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
|
|
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
|
|
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
|