@qawolf/cli 2.5.0 → 2.6.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 +129 -21
- package/dist/runner-sdk.js +127 -19
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +3 -1
- package/skills/qawolf-cli/references/run-results.md +20 -0
package/dist/cli.js
CHANGED
|
@@ -17133,6 +17133,16 @@ var defaultIdSchemas = {
|
|
|
17133
17133
|
};
|
|
17134
17134
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
17135
17135
|
|
|
17136
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/files.js
|
|
17137
|
+
var maxAttachedFilesPerRequest = 10;
|
|
17138
|
+
var attachedFilePathsSchema = array(teamStoragePathSchema).min(1).max(maxAttachedFilesPerRequest).refine((filePaths) => new Set(filePaths).size === filePaths.length, "filePaths must be unique");
|
|
17139
|
+
var attachedFilePathsDescription = "Paths of files in the team's storage to attach to the bug report, such as the files the bug was reproduced with. " + `At most ${maxAttachedFilesPerRequest} files, each at most 100 MB. ` + "QA Wolf keeps a copy of each file as it is now, so later changes to the original do not change the report. " + "If any path has no file, nothing is attached and the error names the path.";
|
|
17140
|
+
var issueFileSchema = object({
|
|
17141
|
+
fileId: string2().describe("The id of the attached file."),
|
|
17142
|
+
name: string2().describe("The file's name, taken from the last segment of the path it was attached from."),
|
|
17143
|
+
sizeBytes: number2().int().nonnegative()
|
|
17144
|
+
});
|
|
17145
|
+
|
|
17136
17146
|
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
17137
17147
|
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
17138
17148
|
var buildIdSchema = string2().regex(/^[a-z0-9]{24}obld$/, "Expected a build id from build.requestUpload.").describe("The id of the build, from build.requestUpload.");
|
|
@@ -18742,6 +18752,36 @@ var makeListBuildsContract = (ids) => {
|
|
|
18742
18752
|
};
|
|
18743
18753
|
};
|
|
18744
18754
|
|
|
18755
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestDownload.js
|
|
18756
|
+
var makeRequestBuildDownloadContract = (ids) => {
|
|
18757
|
+
const input = object({
|
|
18758
|
+
buildId: buildIdSchema,
|
|
18759
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18760
|
+
});
|
|
18761
|
+
const output = object({
|
|
18762
|
+
expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
|
|
18763
|
+
fileName: string2().describe("The name of the build's file."),
|
|
18764
|
+
readUrl: string2().describe('Fetch the build\'s file from here, for example `curl -o app.apk "<readUrl>"`.')
|
|
18765
|
+
});
|
|
18766
|
+
return {
|
|
18767
|
+
annotationJustifications: {
|
|
18768
|
+
destructiveHint: "Does not change the build or its file.",
|
|
18769
|
+
openWorldHint: "Access is limited to the build files of the authorized workspace.",
|
|
18770
|
+
readOnlyHint: "Returns an expiring read URL for a build's file."
|
|
18771
|
+
},
|
|
18772
|
+
annotations: {
|
|
18773
|
+
destructiveHint: false,
|
|
18774
|
+
openWorldHint: false,
|
|
18775
|
+
readOnlyHint: true
|
|
18776
|
+
},
|
|
18777
|
+
description: "Get a URL to download a build's file. Deleted builds can be downloaded while their file exists. Answers 404 when the file has expired.",
|
|
18778
|
+
input,
|
|
18779
|
+
kind: "read",
|
|
18780
|
+
name: "build.requestDownload",
|
|
18781
|
+
output
|
|
18782
|
+
};
|
|
18783
|
+
};
|
|
18784
|
+
|
|
18745
18785
|
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
18746
18786
|
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
18747
18787
|
var makeRequestBuildUploadContract = (ids) => {
|
|
@@ -18782,6 +18822,7 @@ var makeBuildContracts = (ids) => ({
|
|
|
18782
18822
|
delete: makeDeleteBuildContract(ids),
|
|
18783
18823
|
get: makeGetBuildContract(ids),
|
|
18784
18824
|
list: makeListBuildsContract(ids),
|
|
18825
|
+
requestDownload: makeRequestBuildDownloadContract(ids),
|
|
18785
18826
|
requestUpload: makeRequestBuildUploadContract(ids)
|
|
18786
18827
|
});
|
|
18787
18828
|
|
|
@@ -19389,6 +19430,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
19389
19430
|
});
|
|
19390
19431
|
const output = object({
|
|
19391
19432
|
missingNames: array(string2()).describe("Requested names the environment does not have, sorted alphabetically."),
|
|
19433
|
+
secretNames: array(string2()).describe("Requested names that hold write-only secrets, sorted alphabetically. Their values are never returned; flows still receive them at run time."),
|
|
19392
19434
|
variables: array(object({
|
|
19393
19435
|
name: string2().describe("The stored variable name."),
|
|
19394
19436
|
value: string2().describe("The variable's secret value. Handle as a secret.")
|
|
@@ -19405,7 +19447,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
19405
19447
|
openWorldHint: false,
|
|
19406
19448
|
readOnlyHint: true
|
|
19407
19449
|
},
|
|
19408
|
-
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and
|
|
19450
|
+
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and write-only secrets go to secretNames; neither fails the call.",
|
|
19409
19451
|
input,
|
|
19410
19452
|
kind: "read",
|
|
19411
19453
|
name: "environment.getVariable",
|
|
@@ -19845,6 +19887,7 @@ var makeIssueResourceSchema = (ids) => resource({
|
|
|
19845
19887
|
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
|
|
19846
19888
|
createdAt: exports_coerce.date().describe("When the issue was created."),
|
|
19847
19889
|
description: string2().describe("The issue description in Markdown."),
|
|
19890
|
+
files: array(issueFileSchema).default([]).describe("Files attached to a bug report, oldest first. Always empty on blockers and coverage requests."),
|
|
19848
19891
|
issueId: ids.issue,
|
|
19849
19892
|
name: string2(),
|
|
19850
19893
|
number: number2().int(),
|
|
@@ -20102,6 +20145,34 @@ var makeAddFlowsToIssueContract = (ids) => {
|
|
|
20102
20145
|
};
|
|
20103
20146
|
};
|
|
20104
20147
|
|
|
20148
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/attachFiles.js
|
|
20149
|
+
var makeAttachFilesToIssueContract = (ids) => {
|
|
20150
|
+
const input = object({
|
|
20151
|
+
filePaths: attachedFilePathsSchema.describe(attachedFilePathsDescription),
|
|
20152
|
+
issueId: ids.issue
|
|
20153
|
+
});
|
|
20154
|
+
const output = object({
|
|
20155
|
+
issue: makeIssueResourceSchema(ids)
|
|
20156
|
+
});
|
|
20157
|
+
return {
|
|
20158
|
+
annotationJustifications: {
|
|
20159
|
+
destructiveHint: "Adds files to the bug report without removing or replacing the ones already attached.",
|
|
20160
|
+
openWorldHint: "Copies files within QA Wolf storage without publishing anything outside QA Wolf.",
|
|
20161
|
+
readOnlyHint: "Copies files from the team's storage and attaches the copies to a bug report."
|
|
20162
|
+
},
|
|
20163
|
+
annotations: {
|
|
20164
|
+
destructiveHint: false,
|
|
20165
|
+
openWorldHint: false,
|
|
20166
|
+
readOnlyHint: false
|
|
20167
|
+
},
|
|
20168
|
+
description: "Attach files from the team's storage to a bug report owned by the caller's team, for example the files a bug was reproduced with. " + "Files already attached stay attached. Upload a file with file.requestUpload first.",
|
|
20169
|
+
input,
|
|
20170
|
+
kind: "write",
|
|
20171
|
+
name: "issue.attachFiles",
|
|
20172
|
+
output
|
|
20173
|
+
};
|
|
20174
|
+
};
|
|
20175
|
+
|
|
20105
20176
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
|
|
20106
20177
|
var makeCreateIssueContract = (ids) => {
|
|
20107
20178
|
const commonFields = {
|
|
@@ -20113,6 +20184,7 @@ var makeCreateIssueContract = (ids) => {
|
|
|
20113
20184
|
const input = discriminatedUnion("type", [
|
|
20114
20185
|
object({
|
|
20115
20186
|
...commonFields,
|
|
20187
|
+
filePaths: attachedFilePathsSchema.optional().describe(attachedFilePathsDescription),
|
|
20116
20188
|
type: literal("bug")
|
|
20117
20189
|
}),
|
|
20118
20190
|
object({
|
|
@@ -20308,6 +20380,19 @@ var makeUpdateIssueContract = (ids) => {
|
|
|
20308
20380
|
};
|
|
20309
20381
|
};
|
|
20310
20382
|
|
|
20383
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/contracts.js
|
|
20384
|
+
var makeIssueContracts = (ids) => ({
|
|
20385
|
+
addFlows: makeAddFlowsToIssueContract(ids),
|
|
20386
|
+
attachFiles: makeAttachFilesToIssueContract(ids),
|
|
20387
|
+
create: makeCreateIssueContract(ids),
|
|
20388
|
+
decideSuggestion: makeDecideSuggestionContract(ids),
|
|
20389
|
+
find: makeFindIssuesContract(ids),
|
|
20390
|
+
get: makeGetIssueContract(ids),
|
|
20391
|
+
listActivity: makeListIssueActivityContract(ids),
|
|
20392
|
+
removeFlows: makeRemoveFlowsFromIssueContract(ids),
|
|
20393
|
+
update: makeUpdateIssueContract(ids)
|
|
20394
|
+
});
|
|
20395
|
+
|
|
20311
20396
|
// node_modules/@qawolf/api-contracts/dist/v1/legacyTrigger/resource.js
|
|
20312
20397
|
var namedIdentity = object({ id: string2(), name: string2() });
|
|
20313
20398
|
var branchScope = union([
|
|
@@ -20661,6 +20746,39 @@ var makeFlowFailureSchema = (ids) => {
|
|
|
20661
20746
|
});
|
|
20662
20747
|
};
|
|
20663
20748
|
|
|
20749
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
|
|
20750
|
+
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
20751
|
+
var attemptCount = number2().int().positive().describe("How many attempts reported it.");
|
|
20752
|
+
var runBuildVersionSchema = object({
|
|
20753
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
|
|
20754
|
+
expected: object({
|
|
20755
|
+
buildId: buildIdSchema,
|
|
20756
|
+
version: string2().optional()
|
|
20757
|
+
}).optional().describe("The run's build of this app. Absent for an app it got none of."),
|
|
20758
|
+
kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings."),
|
|
20759
|
+
observed: array(object({
|
|
20760
|
+
attempts: attemptCount,
|
|
20761
|
+
buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
|
|
20762
|
+
version: string2().optional()
|
|
20763
|
+
})).describe("What attempts installed, one entry per build or version."),
|
|
20764
|
+
platform: buildPlatformSchema,
|
|
20765
|
+
unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
|
|
20766
|
+
warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app. notTested: attempts reported installs on this platform, but none installed the run's build. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
|
|
20767
|
+
});
|
|
20768
|
+
var runSiteVersionSchema = object({
|
|
20769
|
+
expected: object({
|
|
20770
|
+
from: extensibleValue(["deployment", "latestDeployment"], "deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run."),
|
|
20771
|
+
version: string2().describe("The deployed commit.")
|
|
20772
|
+
}).optional().describe("The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service."),
|
|
20773
|
+
observed: array(object({
|
|
20774
|
+
attempts: attemptCount,
|
|
20775
|
+
source: extensibleValue(["header", "meta", "versionPath", "frameworkBuildId", "fingerprint"], "Where the attempt read the version."),
|
|
20776
|
+
version: string2()
|
|
20777
|
+
})).describe("What attempts saw, one entry per version and source."),
|
|
20778
|
+
origin: string2().describe("The site origin the attempts visited."),
|
|
20779
|
+
warnings: array(extensibleValue(["changedDuringRun", "unexpectedVersion"], "changedDuringRun: attempts saw different versions from one source. unexpectedVersion: the site served another commit than expected.")).describe("Why the site may not be the version the run should test.")
|
|
20780
|
+
});
|
|
20781
|
+
|
|
20664
20782
|
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
20665
20783
|
var makeGetRunContract = (ids) => {
|
|
20666
20784
|
const flowStatus = _enum(publicRunStatusValues);
|
|
@@ -20687,8 +20805,10 @@ var makeGetRunContract = (ids) => {
|
|
|
20687
20805
|
...makeRunSummaryFields(ids),
|
|
20688
20806
|
blockingBugCount: number2().int().nonnegative().describe("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."),
|
|
20689
20807
|
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
20808
|
+
buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
|
|
20690
20809
|
flows,
|
|
20691
|
-
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
|
|
20810
|
+
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead."),
|
|
20811
|
+
siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one.")
|
|
20692
20812
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
20693
20813
|
return {
|
|
20694
20814
|
annotationJustifications: {
|
|
@@ -21038,7 +21158,7 @@ var makeLaunchRunnerContract = (ids) => {
|
|
|
21038
21158
|
openWorldHint: true,
|
|
21039
21159
|
readOnlyHint: false
|
|
21040
21160
|
},
|
|
21041
|
-
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one,
|
|
21161
|
+
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one, whatever runnerName is sent, so read `runnerName` in the answer for what is running. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner, so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running, and launching the same id again attaches to it.",
|
|
21042
21162
|
input,
|
|
21043
21163
|
kind: "write",
|
|
21044
21164
|
name: "runner.launch",
|
|
@@ -21186,17 +21306,14 @@ var unchangedFilesSchema = record(string2(), string2().min(1)).superRefine((hash
|
|
|
21186
21306
|
var makeRunFlowOnRunnerContract = (ids) => {
|
|
21187
21307
|
const input = object({
|
|
21188
21308
|
entryPointPath: runFilePathSchema.describe("Path of the flow file to run, as it appears in `files`."),
|
|
21189
|
-
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run."),
|
|
21190
|
-
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit
|
|
21309
|
+
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run. With `environmentId`, they are added on top of that environment's variables for this run only, replacing any of the same name; the environment itself is not changed."),
|
|
21310
|
+
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit`; `env` cannot replace these three."),
|
|
21191
21311
|
files: runFilesSchema.describe("Every file the run needs keyed by its path — the flow file, everything it imports, package.json and tsconfig.json. A runner holds no copy of your project, so what runs is exactly what is sent here."),
|
|
21192
21312
|
flowId: ids.flow.optional().describe("The QA Wolf flow this run is for. The run then sees it as `QAWOLF_WORKFLOW_ID`, the same value a platform run of that flow sees, so fixtures named and cleaned up by it match across both. Omitted, the flow whose file is at `entryPointPath` on the named environment's flow-code branch stands in; a file not in QA Wolf yet, or a run given no environment, leaves the run with no `QAWOLF_WORKFLOW_ID`."),
|
|
21193
21313
|
id: runnerIdSchema.describe("Id of the runner to run the flow on."),
|
|
21194
21314
|
selection: runSelectionSchema.optional().describe("Run only these lines, inside the page the runner is already on, instead of running the whole flow from a fresh browser. Omit to run the whole entry point."),
|
|
21195
21315
|
unchangedFiles: unchangedFilesSchema.optional().describe("Files this runner already holds from an earlier run, keyed by path with a hex SHA-256 of the content it should hold. Send this to make `files` only what changed. The runner refuses with `needs-full-sync` if it holds none of a referenced path, so it never runs something other than what was asked for. Omit it to send every file."),
|
|
21196
21316
|
workspaceId: ids.workspace.optional().describe(runnerWorkspaceIdDescription)
|
|
21197
|
-
}).refine((request) => request.env === undefined || request.environmentId === undefined, {
|
|
21198
|
-
error: "Send env or environmentId, not both. An environment's variables are taken as they are stored, so there is no order in which the two would combine.",
|
|
21199
|
-
path: ["environmentId"]
|
|
21200
21317
|
}).refine((request) => Object.hasOwn(request.files, request.entryPointPath), {
|
|
21201
21318
|
error: "The entry point must be one of the files.",
|
|
21202
21319
|
path: ["files"]
|
|
@@ -21483,16 +21600,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21483
21600
|
update: makeUpdateFlowContract(resolvedIds)
|
|
21484
21601
|
},
|
|
21485
21602
|
investigation: makeInvestigationContracts(resolvedIds),
|
|
21486
|
-
issue:
|
|
21487
|
-
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
21488
|
-
create: makeCreateIssueContract(resolvedIds),
|
|
21489
|
-
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
21490
|
-
find: makeFindIssuesContract(resolvedIds),
|
|
21491
|
-
get: makeGetIssueContract(resolvedIds),
|
|
21492
|
-
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
21493
|
-
removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
|
|
21494
|
-
update: makeUpdateIssueContract(resolvedIds)
|
|
21495
|
-
},
|
|
21603
|
+
issue: makeIssueContracts(resolvedIds),
|
|
21496
21604
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
21497
21605
|
mcpServer: {
|
|
21498
21606
|
connect: makeConnectMcpServerContract(resolvedIds)
|
|
@@ -24024,7 +24132,7 @@ function startUpdateCheck(deps) {
|
|
|
24024
24132
|
// package.json
|
|
24025
24133
|
var package_default = {
|
|
24026
24134
|
name: "@qawolf/cli",
|
|
24027
|
-
version: "2.
|
|
24135
|
+
version: "2.6.0",
|
|
24028
24136
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
24029
24137
|
keywords: [
|
|
24030
24138
|
"automation",
|
|
@@ -24096,7 +24204,7 @@ var package_default = {
|
|
|
24096
24204
|
"@clack/prompts": "1.5.1",
|
|
24097
24205
|
"@napi-rs/keyring": "1.3.0",
|
|
24098
24206
|
"@oxc-node/core": "0.1.0",
|
|
24099
|
-
"@qawolf/api-contracts": "0.
|
|
24207
|
+
"@qawolf/api-contracts": "0.107.0",
|
|
24100
24208
|
"@qawolf/emails": "1.1.1",
|
|
24101
24209
|
"@qawolf/flow-targets": "2.0.0",
|
|
24102
24210
|
"@qawolf/flows": "0.3.0",
|
|
@@ -42270,4 +42378,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
42270
42378
|
process.exitCode = 1;
|
|
42271
42379
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
42272
42380
|
|
|
42273
|
-
//# debugId=
|
|
42381
|
+
//# debugId=5F33B8D66BC6D61964756E2164756E21
|
package/dist/runner-sdk.js
CHANGED
|
@@ -7365,6 +7365,16 @@ var defaultIdSchemas = {
|
|
|
7365
7365
|
};
|
|
7366
7366
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
7367
7367
|
|
|
7368
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/files.js
|
|
7369
|
+
var maxAttachedFilesPerRequest = 10;
|
|
7370
|
+
var attachedFilePathsSchema = array(teamStoragePathSchema).min(1).max(maxAttachedFilesPerRequest).refine((filePaths) => new Set(filePaths).size === filePaths.length, "filePaths must be unique");
|
|
7371
|
+
var attachedFilePathsDescription = "Paths of files in the team's storage to attach to the bug report, such as the files the bug was reproduced with. " + `At most ${maxAttachedFilesPerRequest} files, each at most 100 MB. ` + "QA Wolf keeps a copy of each file as it is now, so later changes to the original do not change the report. " + "If any path has no file, nothing is attached and the error names the path.";
|
|
7372
|
+
var issueFileSchema = object({
|
|
7373
|
+
fileId: string2().describe("The id of the attached file."),
|
|
7374
|
+
name: string2().describe("The file's name, taken from the last segment of the path it was attached from."),
|
|
7375
|
+
sizeBytes: number2().int().nonnegative()
|
|
7376
|
+
});
|
|
7377
|
+
|
|
7368
7378
|
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
7369
7379
|
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
7370
7380
|
var buildIdSchema = string2().regex(/^[a-z0-9]{24}obld$/, "Expected a build id from build.requestUpload.").describe("The id of the build, from build.requestUpload.");
|
|
@@ -8980,6 +8990,36 @@ var makeListBuildsContract = (ids) => {
|
|
|
8980
8990
|
};
|
|
8981
8991
|
};
|
|
8982
8992
|
|
|
8993
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestDownload.js
|
|
8994
|
+
var makeRequestBuildDownloadContract = (ids) => {
|
|
8995
|
+
const input = object({
|
|
8996
|
+
buildId: buildIdSchema,
|
|
8997
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
8998
|
+
});
|
|
8999
|
+
const output = object({
|
|
9000
|
+
expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
|
|
9001
|
+
fileName: string2().describe("The name of the build's file."),
|
|
9002
|
+
readUrl: string2().describe('Fetch the build\'s file from here, for example `curl -o app.apk "<readUrl>"`.')
|
|
9003
|
+
});
|
|
9004
|
+
return {
|
|
9005
|
+
annotationJustifications: {
|
|
9006
|
+
destructiveHint: "Does not change the build or its file.",
|
|
9007
|
+
openWorldHint: "Access is limited to the build files of the authorized workspace.",
|
|
9008
|
+
readOnlyHint: "Returns an expiring read URL for a build's file."
|
|
9009
|
+
},
|
|
9010
|
+
annotations: {
|
|
9011
|
+
destructiveHint: false,
|
|
9012
|
+
openWorldHint: false,
|
|
9013
|
+
readOnlyHint: true
|
|
9014
|
+
},
|
|
9015
|
+
description: "Get a URL to download a build's file. Deleted builds can be downloaded while their file exists. Answers 404 when the file has expired.",
|
|
9016
|
+
input,
|
|
9017
|
+
kind: "read",
|
|
9018
|
+
name: "build.requestDownload",
|
|
9019
|
+
output
|
|
9020
|
+
};
|
|
9021
|
+
};
|
|
9022
|
+
|
|
8983
9023
|
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
8984
9024
|
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
8985
9025
|
var makeRequestBuildUploadContract = (ids) => {
|
|
@@ -9020,6 +9060,7 @@ var makeBuildContracts = (ids) => ({
|
|
|
9020
9060
|
delete: makeDeleteBuildContract(ids),
|
|
9021
9061
|
get: makeGetBuildContract(ids),
|
|
9022
9062
|
list: makeListBuildsContract(ids),
|
|
9063
|
+
requestDownload: makeRequestBuildDownloadContract(ids),
|
|
9023
9064
|
requestUpload: makeRequestBuildUploadContract(ids)
|
|
9024
9065
|
});
|
|
9025
9066
|
|
|
@@ -9627,6 +9668,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
9627
9668
|
});
|
|
9628
9669
|
const output = object({
|
|
9629
9670
|
missingNames: array(string2()).describe("Requested names the environment does not have, sorted alphabetically."),
|
|
9671
|
+
secretNames: array(string2()).describe("Requested names that hold write-only secrets, sorted alphabetically. Their values are never returned; flows still receive them at run time."),
|
|
9630
9672
|
variables: array(object({
|
|
9631
9673
|
name: string2().describe("The stored variable name."),
|
|
9632
9674
|
value: string2().describe("The variable's secret value. Handle as a secret.")
|
|
@@ -9643,7 +9685,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
9643
9685
|
openWorldHint: false,
|
|
9644
9686
|
readOnlyHint: true
|
|
9645
9687
|
},
|
|
9646
|
-
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and
|
|
9688
|
+
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and write-only secrets go to secretNames; neither fails the call.",
|
|
9647
9689
|
input,
|
|
9648
9690
|
kind: "read",
|
|
9649
9691
|
name: "environment.getVariable",
|
|
@@ -10083,6 +10125,7 @@ var makeIssueResourceSchema = (ids) => resource({
|
|
|
10083
10125
|
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
|
|
10084
10126
|
createdAt: exports_coerce.date().describe("When the issue was created."),
|
|
10085
10127
|
description: string2().describe("The issue description in Markdown."),
|
|
10128
|
+
files: array(issueFileSchema).default([]).describe("Files attached to a bug report, oldest first. Always empty on blockers and coverage requests."),
|
|
10086
10129
|
issueId: ids.issue,
|
|
10087
10130
|
name: string2(),
|
|
10088
10131
|
number: number2().int(),
|
|
@@ -10340,6 +10383,34 @@ var makeAddFlowsToIssueContract = (ids) => {
|
|
|
10340
10383
|
};
|
|
10341
10384
|
};
|
|
10342
10385
|
|
|
10386
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/attachFiles.js
|
|
10387
|
+
var makeAttachFilesToIssueContract = (ids) => {
|
|
10388
|
+
const input = object({
|
|
10389
|
+
filePaths: attachedFilePathsSchema.describe(attachedFilePathsDescription),
|
|
10390
|
+
issueId: ids.issue
|
|
10391
|
+
});
|
|
10392
|
+
const output = object({
|
|
10393
|
+
issue: makeIssueResourceSchema(ids)
|
|
10394
|
+
});
|
|
10395
|
+
return {
|
|
10396
|
+
annotationJustifications: {
|
|
10397
|
+
destructiveHint: "Adds files to the bug report without removing or replacing the ones already attached.",
|
|
10398
|
+
openWorldHint: "Copies files within QA Wolf storage without publishing anything outside QA Wolf.",
|
|
10399
|
+
readOnlyHint: "Copies files from the team's storage and attaches the copies to a bug report."
|
|
10400
|
+
},
|
|
10401
|
+
annotations: {
|
|
10402
|
+
destructiveHint: false,
|
|
10403
|
+
openWorldHint: false,
|
|
10404
|
+
readOnlyHint: false
|
|
10405
|
+
},
|
|
10406
|
+
description: "Attach files from the team's storage to a bug report owned by the caller's team, for example the files a bug was reproduced with. " + "Files already attached stay attached. Upload a file with file.requestUpload first.",
|
|
10407
|
+
input,
|
|
10408
|
+
kind: "write",
|
|
10409
|
+
name: "issue.attachFiles",
|
|
10410
|
+
output
|
|
10411
|
+
};
|
|
10412
|
+
};
|
|
10413
|
+
|
|
10343
10414
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
|
|
10344
10415
|
var makeCreateIssueContract = (ids) => {
|
|
10345
10416
|
const commonFields = {
|
|
@@ -10351,6 +10422,7 @@ var makeCreateIssueContract = (ids) => {
|
|
|
10351
10422
|
const input = discriminatedUnion("type", [
|
|
10352
10423
|
object({
|
|
10353
10424
|
...commonFields,
|
|
10425
|
+
filePaths: attachedFilePathsSchema.optional().describe(attachedFilePathsDescription),
|
|
10354
10426
|
type: literal("bug")
|
|
10355
10427
|
}),
|
|
10356
10428
|
object({
|
|
@@ -10546,6 +10618,19 @@ var makeUpdateIssueContract = (ids) => {
|
|
|
10546
10618
|
};
|
|
10547
10619
|
};
|
|
10548
10620
|
|
|
10621
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/contracts.js
|
|
10622
|
+
var makeIssueContracts = (ids) => ({
|
|
10623
|
+
addFlows: makeAddFlowsToIssueContract(ids),
|
|
10624
|
+
attachFiles: makeAttachFilesToIssueContract(ids),
|
|
10625
|
+
create: makeCreateIssueContract(ids),
|
|
10626
|
+
decideSuggestion: makeDecideSuggestionContract(ids),
|
|
10627
|
+
find: makeFindIssuesContract(ids),
|
|
10628
|
+
get: makeGetIssueContract(ids),
|
|
10629
|
+
listActivity: makeListIssueActivityContract(ids),
|
|
10630
|
+
removeFlows: makeRemoveFlowsFromIssueContract(ids),
|
|
10631
|
+
update: makeUpdateIssueContract(ids)
|
|
10632
|
+
});
|
|
10633
|
+
|
|
10549
10634
|
// node_modules/@qawolf/api-contracts/dist/v1/legacyTrigger/resource.js
|
|
10550
10635
|
var namedIdentity = object({ id: string2(), name: string2() });
|
|
10551
10636
|
var branchScope = union([
|
|
@@ -10899,6 +10984,39 @@ var makeFlowFailureSchema = (ids) => {
|
|
|
10899
10984
|
});
|
|
10900
10985
|
};
|
|
10901
10986
|
|
|
10987
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
|
|
10988
|
+
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
10989
|
+
var attemptCount = number2().int().positive().describe("How many attempts reported it.");
|
|
10990
|
+
var runBuildVersionSchema = object({
|
|
10991
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
|
|
10992
|
+
expected: object({
|
|
10993
|
+
buildId: buildIdSchema,
|
|
10994
|
+
version: string2().optional()
|
|
10995
|
+
}).optional().describe("The run's build of this app. Absent for an app it got none of."),
|
|
10996
|
+
kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings."),
|
|
10997
|
+
observed: array(object({
|
|
10998
|
+
attempts: attemptCount,
|
|
10999
|
+
buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
|
|
11000
|
+
version: string2().optional()
|
|
11001
|
+
})).describe("What attempts installed, one entry per build or version."),
|
|
11002
|
+
platform: buildPlatformSchema,
|
|
11003
|
+
unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
|
|
11004
|
+
warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app. notTested: attempts reported installs on this platform, but none installed the run's build. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
|
|
11005
|
+
});
|
|
11006
|
+
var runSiteVersionSchema = object({
|
|
11007
|
+
expected: object({
|
|
11008
|
+
from: extensibleValue(["deployment", "latestDeployment"], "deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run."),
|
|
11009
|
+
version: string2().describe("The deployed commit.")
|
|
11010
|
+
}).optional().describe("The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service."),
|
|
11011
|
+
observed: array(object({
|
|
11012
|
+
attempts: attemptCount,
|
|
11013
|
+
source: extensibleValue(["header", "meta", "versionPath", "frameworkBuildId", "fingerprint"], "Where the attempt read the version."),
|
|
11014
|
+
version: string2()
|
|
11015
|
+
})).describe("What attempts saw, one entry per version and source."),
|
|
11016
|
+
origin: string2().describe("The site origin the attempts visited."),
|
|
11017
|
+
warnings: array(extensibleValue(["changedDuringRun", "unexpectedVersion"], "changedDuringRun: attempts saw different versions from one source. unexpectedVersion: the site served another commit than expected.")).describe("Why the site may not be the version the run should test.")
|
|
11018
|
+
});
|
|
11019
|
+
|
|
10902
11020
|
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
10903
11021
|
var makeGetRunContract = (ids) => {
|
|
10904
11022
|
const flowStatus = _enum(publicRunStatusValues);
|
|
@@ -10925,8 +11043,10 @@ var makeGetRunContract = (ids) => {
|
|
|
10925
11043
|
...makeRunSummaryFields(ids),
|
|
10926
11044
|
blockingBugCount: number2().int().nonnegative().describe("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."),
|
|
10927
11045
|
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
11046
|
+
buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
|
|
10928
11047
|
flows,
|
|
10929
|
-
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
|
|
11048
|
+
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead."),
|
|
11049
|
+
siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one.")
|
|
10930
11050
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
10931
11051
|
return {
|
|
10932
11052
|
annotationJustifications: {
|
|
@@ -11276,7 +11396,7 @@ var makeLaunchRunnerContract = (ids) => {
|
|
|
11276
11396
|
openWorldHint: true,
|
|
11277
11397
|
readOnlyHint: false
|
|
11278
11398
|
},
|
|
11279
|
-
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one,
|
|
11399
|
+
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one, whatever runnerName is sent, so read `runnerName` in the answer for what is running. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner, so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running, and launching the same id again attaches to it.",
|
|
11280
11400
|
input,
|
|
11281
11401
|
kind: "write",
|
|
11282
11402
|
name: "runner.launch",
|
|
@@ -11424,17 +11544,14 @@ var unchangedFilesSchema = record(string2(), string2().min(1)).superRefine((hash
|
|
|
11424
11544
|
var makeRunFlowOnRunnerContract = (ids) => {
|
|
11425
11545
|
const input = object({
|
|
11426
11546
|
entryPointPath: runFilePathSchema.describe("Path of the flow file to run, as it appears in `files`."),
|
|
11427
|
-
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run."),
|
|
11428
|
-
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit
|
|
11547
|
+
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run. With `environmentId`, they are added on top of that environment's variables for this run only, replacing any of the same name; the environment itself is not changed."),
|
|
11548
|
+
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit`; `env` cannot replace these three."),
|
|
11429
11549
|
files: runFilesSchema.describe("Every file the run needs keyed by its path — the flow file, everything it imports, package.json and tsconfig.json. A runner holds no copy of your project, so what runs is exactly what is sent here."),
|
|
11430
11550
|
flowId: ids.flow.optional().describe("The QA Wolf flow this run is for. The run then sees it as `QAWOLF_WORKFLOW_ID`, the same value a platform run of that flow sees, so fixtures named and cleaned up by it match across both. Omitted, the flow whose file is at `entryPointPath` on the named environment's flow-code branch stands in; a file not in QA Wolf yet, or a run given no environment, leaves the run with no `QAWOLF_WORKFLOW_ID`."),
|
|
11431
11551
|
id: runnerIdSchema.describe("Id of the runner to run the flow on."),
|
|
11432
11552
|
selection: runSelectionSchema.optional().describe("Run only these lines, inside the page the runner is already on, instead of running the whole flow from a fresh browser. Omit to run the whole entry point."),
|
|
11433
11553
|
unchangedFiles: unchangedFilesSchema.optional().describe("Files this runner already holds from an earlier run, keyed by path with a hex SHA-256 of the content it should hold. Send this to make `files` only what changed. The runner refuses with `needs-full-sync` if it holds none of a referenced path, so it never runs something other than what was asked for. Omit it to send every file."),
|
|
11434
11554
|
workspaceId: ids.workspace.optional().describe(runnerWorkspaceIdDescription)
|
|
11435
|
-
}).refine((request) => request.env === undefined || request.environmentId === undefined, {
|
|
11436
|
-
error: "Send env or environmentId, not both. An environment's variables are taken as they are stored, so there is no order in which the two would combine.",
|
|
11437
|
-
path: ["environmentId"]
|
|
11438
11555
|
}).refine((request) => Object.hasOwn(request.files, request.entryPointPath), {
|
|
11439
11556
|
error: "The entry point must be one of the files.",
|
|
11440
11557
|
path: ["files"]
|
|
@@ -11721,16 +11838,7 @@ var makeContractsV1 = (ids) => {
|
|
|
11721
11838
|
update: makeUpdateFlowContract(resolvedIds)
|
|
11722
11839
|
},
|
|
11723
11840
|
investigation: makeInvestigationContracts(resolvedIds),
|
|
11724
|
-
issue:
|
|
11725
|
-
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
11726
|
-
create: makeCreateIssueContract(resolvedIds),
|
|
11727
|
-
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
11728
|
-
find: makeFindIssuesContract(resolvedIds),
|
|
11729
|
-
get: makeGetIssueContract(resolvedIds),
|
|
11730
|
-
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
11731
|
-
removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
|
|
11732
|
-
update: makeUpdateIssueContract(resolvedIds)
|
|
11733
|
-
},
|
|
11841
|
+
issue: makeIssueContracts(resolvedIds),
|
|
11734
11842
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
11735
11843
|
mcpServer: {
|
|
11736
11844
|
connect: makeConnectMcpServerContract(resolvedIds)
|
|
@@ -16507,4 +16615,4 @@ export {
|
|
|
16507
16615
|
createRunnerSdk
|
|
16508
16616
|
};
|
|
16509
16617
|
|
|
16510
|
-
//# debugId=
|
|
16618
|
+
//# debugId=75C8CC52E0AB71DC64756E2164756E21
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qawolf/cli",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.6.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.107.0",
|
|
76
76
|
"@qawolf/emails": "1.1.1",
|
|
77
77
|
"@qawolf/flow-targets": "2.0.0",
|
|
78
78
|
"@qawolf/flows": "0.3.0",
|
|
@@ -148,6 +148,7 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
148
148
|
| `qawolf build delete` | write | Delete a build. Runs never install a deleted build. Deleting an environment's latest build makes the previous one its latest. Runs install that build only if its file is still kept: only the latest builds of static environments are kept past the bucket's expiry, 180 days after upload on QA Wolf's cloud. Answers the build with deletedAt set. Deleting a deleted build answers it unchanged. |
|
|
149
149
|
| `qawolf build get` | read | Get a build: its app, platform, version and environment. Deleted builds are returned too. |
|
|
150
150
|
| `qawolf build list` | read | List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs. |
|
|
151
|
+
| `qawolf build requestDownload` | read | Get a URL to download a build's file. Deleted builds can be downloaded while their file exists. Answers 404 when the file has expired. |
|
|
151
152
|
| `qawolf build requestUpload` | write | Get a URL to upload an app build: an .apk, .aab or .ipa, up to 500 MB. PUT the file there with uploadHeaders, then call build.create with the buildId. |
|
|
152
153
|
| `qawolf codeHostIntegration find` | read | List the workspace's code host integrations (GitHub or GitLab). A connected integration lets QA Wolf read repositories and receive the code host's webhooks. codeHostIntegration.listRepositories pages the repositories each integration covers. |
|
|
153
154
|
| `qawolf codeHostIntegration listRepositories` | read | List the repositories the workspace's code host integrations cover, alphabetical by full name. The list reflects the last sync from the code host; codeHostIntegration.find lists the integrations themselves. |
|
|
@@ -165,7 +166,7 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
165
166
|
| `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
|
|
166
167
|
| `qawolf environment find` | read | List the team's environments, newest first. |
|
|
167
168
|
| `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. |
|
|
168
|
-
| `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
|
|
169
|
+
| `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 write-only secrets go to secretNames; neither fails the call. |
|
|
169
170
|
| `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. |
|
|
170
171
|
| `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. |
|
|
171
172
|
| `qawolf environment setVariable` | write | Create or replace an environment variable. If the user asks to create one for "my email" without naming it, use DEFAULT_EMAIL. The value is never returned. |
|
|
@@ -188,6 +189,7 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
188
189
|
| `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". |
|
|
189
190
|
| `qawolf investigation question find` | read | List the questions the QA Wolf AI investigating failed runs is waiting for a person to answer, across a workspace's runs. Each question names its run, flows, details and offered answers. To answer one, send the person's answer to its sessionId with agent.send. |
|
|
190
191
|
| `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. |
|
|
192
|
+
| `qawolf issue attachFiles` | write | Attach files from the team's storage to a bug report owned by the caller's team, for example the files a bug was reproduced with. Files already attached stay attached. Upload a file with file.requestUpload first. |
|
|
191
193
|
| `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. |
|
|
192
194
|
| `qawolf issue decideSuggestion` | write | Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. Add turns on the suggested flow in the environment. Report files a potential bug. Skip declines the suggestion. Undo takes back a decision before the flow joins. The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided. |
|
|
193
195
|
| `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
|
|
@@ -207,6 +207,17 @@ Every documented field of the `run.get` response. `[]` marks an array, so
|
|
|
207
207
|
- `builds[].sizeBytes` — The file's size in bytes.
|
|
208
208
|
- `builds[].version` — versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.
|
|
209
209
|
- `builds[].url` — Absolute URL of the team's Builds page.
|
|
210
|
+
- `buildVersions` — The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds.
|
|
211
|
+
- `buildVersions[].appId` — The package name (Android) or bundle ID (iOS) of the app.
|
|
212
|
+
- `buildVersions[].expected` — The run's build of this app. Absent for an app it got none of.
|
|
213
|
+
- `buildVersions[].expected.buildId` — The id of the build, from build.requestUpload.
|
|
214
|
+
- `buildVersions[].kind` — One of build, info; newer servers may add values, so ignore any you don't know. build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings.
|
|
215
|
+
- `buildVersions[].observed` — What attempts installed, one entry per build or version.
|
|
216
|
+
- `buildVersions[].observed[].attempts` — How many attempts reported it.
|
|
217
|
+
- `buildVersions[].observed[].buildId` — Absent when the file is not one of the team's builds.
|
|
218
|
+
- `buildVersions[].platform` — One of: android, ios
|
|
219
|
+
- `buildVersions[].unreportedAttempts` — Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK.
|
|
220
|
+
- `buildVersions[].warnings` — Why the installed apps may not be what the run should test.
|
|
210
221
|
- `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
|
|
211
222
|
- `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.
|
|
212
223
|
- `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.
|
|
@@ -225,6 +236,15 @@ Every documented field of the `run.get` response. `[]` marks an array, so
|
|
|
225
236
|
- `flows[].failure.optedOutOfInvestigation.by` — One of: user, system
|
|
226
237
|
- `flows[].flowId` — The id of the flow.
|
|
227
238
|
- `flows[].status` — One of: failed, queued, running, passed, canceled
|
|
239
|
+
- `siteVersions` — The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one.
|
|
240
|
+
- `siteVersions[].expected` — The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service.
|
|
241
|
+
- `siteVersions[].expected.from` — One of deployment, latestDeployment; newer servers may add values, so ignore any you don't know. deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run.
|
|
242
|
+
- `siteVersions[].expected.version` — The deployed commit.
|
|
243
|
+
- `siteVersions[].observed` — What attempts saw, one entry per version and source.
|
|
244
|
+
- `siteVersions[].observed[].attempts` — How many attempts reported it.
|
|
245
|
+
- `siteVersions[].observed[].source` — One of header, meta, versionPath, frameworkBuildId, fingerprint; newer servers may add values, so ignore any you don't know. Where the attempt read the version.
|
|
246
|
+
- `siteVersions[].origin` — The site origin the attempts visited.
|
|
247
|
+
- `siteVersions[].warnings` — Why the site may not be the version the run should test.
|
|
228
248
|
- `url` — Absolute URL of the run page.
|
|
229
249
|
|
|
230
250
|
<!-- fields:end -->
|