@qawolf/cli 2.3.0 → 2.4.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 +352 -20
- package/dist/runner-sdk.js +350 -18
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +8 -0
- package/skills/qawolf-cli/references/run-results.md +15 -0
package/dist/cli.js
CHANGED
|
@@ -17132,6 +17132,37 @@ var defaultIdSchemas = {
|
|
|
17132
17132
|
};
|
|
17133
17133
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
17134
17134
|
|
|
17135
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
17136
|
+
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
17137
|
+
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.");
|
|
17138
|
+
var makeBuildResourceSchema = (ids) => resource({
|
|
17139
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
|
|
17140
|
+
appName: string2().optional().describe("The app's display name, when the file names one."),
|
|
17141
|
+
branch: string2().optional().describe("The branch the uploader said the build came from."),
|
|
17142
|
+
buildNumber: string2().optional().describe("versionCode (Android) or CFBundleVersion (iOS), when the file has one."),
|
|
17143
|
+
commitSha: string2().optional().describe("The commit the uploader said the build came from."),
|
|
17144
|
+
createdAt: exports_iso.datetime().describe("When the build was created."),
|
|
17145
|
+
deletedAt: exports_iso.datetime().optional().describe("When the build was deleted. Runs never install it after."),
|
|
17146
|
+
environmentId: ids.environment.optional().describe("The environment whose runs install the build while it is the newest one there for its app and platform. Absent: only a run created with the build installs it."),
|
|
17147
|
+
fileName: string2().describe("The uploaded file's name."),
|
|
17148
|
+
id: buildIdSchema,
|
|
17149
|
+
platform: buildPlatformSchema,
|
|
17150
|
+
sizeBytes: number2().int().optional().describe("The file's size in bytes."),
|
|
17151
|
+
version: string2().optional().describe("versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.")
|
|
17152
|
+
}, { urlFieldDescription: "Absolute URL of the team's Builds page." });
|
|
17153
|
+
var makeBuildEnvironmentSelectorSchema = (ids) => union([
|
|
17154
|
+
strictObject({
|
|
17155
|
+
id: ids.environment.describe("The id of an existing environment. Never creates an environment. Send an alias through name instead.")
|
|
17156
|
+
}),
|
|
17157
|
+
strictObject({
|
|
17158
|
+
baseEphemeralEnvironment: string2().trim().min(1).max(255).optional().describe("The alias or name of the environment a created ephemeral environment copies from. Only valid with ephemeral."),
|
|
17159
|
+
ephemeral: boolean2().optional().describe("Requests an ephemeral environment when the name creates one, such as a pull request's. A name that matches an existing environment keeps that environment's kind."),
|
|
17160
|
+
name: string2().trim().min(1).max(255).describe("The environment's alias or name, as deployment.reportStatus takes it. Creates the environment when none matches. It keeps its base's URL.")
|
|
17161
|
+
})
|
|
17162
|
+
], {
|
|
17163
|
+
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
17164
|
+
});
|
|
17165
|
+
|
|
17135
17166
|
// node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
|
|
17136
17167
|
var makeFlowSelectionSchema = (ids) => object({
|
|
17137
17168
|
flowIds: array(ids.flow).default([]),
|
|
@@ -17144,6 +17175,7 @@ var makeFlowSelectionSchema = (ids) => object({
|
|
|
17144
17175
|
var makeCreateRunContract = (ids) => {
|
|
17145
17176
|
const input = object({
|
|
17146
17177
|
aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
|
|
17178
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("Builds to install in this run only. Each replaces the environment's latest build of its app and platform."),
|
|
17147
17179
|
chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
|
|
17148
17180
|
environmentId: ids.environmentRef,
|
|
17149
17181
|
environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
|
|
@@ -17608,14 +17640,14 @@ var makeInspectMobileOnRunnerContract = (ids) => {
|
|
|
17608
17640
|
annotationJustifications: {
|
|
17609
17641
|
destructiveHint: "Does not change application data, edit tests, or stop the runner.",
|
|
17610
17642
|
openWorldHint: "Inspects the existing QA Wolf mobile runner without submitting application actions or contacting arbitrary services.",
|
|
17611
|
-
readOnlyHint: "Reads mobile session status, contexts, page source, or elements
|
|
17643
|
+
readOnlyHint: "Reads mobile session status, contexts, page source, or elements and refreshes activity, which can cancel an inactivity shutdown."
|
|
17612
17644
|
},
|
|
17613
17645
|
annotations: {
|
|
17614
17646
|
destructiveHint: false,
|
|
17615
17647
|
openWorldHint: false,
|
|
17616
|
-
readOnlyHint:
|
|
17648
|
+
readOnlyHint: false
|
|
17617
17649
|
},
|
|
17618
|
-
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This
|
|
17650
|
+
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This refreshes the inactivity timer and can extend the runner's billed lifetime. Mobile and Windows only — a browser runner answers \`runner-is-not-mobile\`; call \`runner.inspect\` for a browser's equivalent surface instead. \`what: "session"\` always answers with the session's own status rather than \`screen-needs-a-run\`, since that is the question it exists to answer; the other three request kinds need a live session first and answer the same \`screen-needs-a-run\` or \`screen-not-ready\` outcomes \`runner.performAction\` and \`runner.takeScreenshot\` use, instead of reading anything when there is none. \`screen-needs-a-run\` means no Appium session has started on this runner yet — call \`runner.runFlow\` with a flow that opens one, then inspect again. \`screen-not-ready\` means the runner's Appium session exists but did not answer this instant, or more than one is somehow live — retry once; if it persists, relaunch the runner. \`runner-is-not-mobile\` means there is nothing here to inspect, and retrying will never help — launch an \`android\`, \`ios\` or \`windows\` runner instead. \`invalid-selector\` (elements by selector only) means the selector itself could not be parsed under the given \`strategy\` — distinct from a selector that parsed fine but matched nothing, which answers \`matches: []\` instead. ${retryableRunnerUnreachableDescription}`,
|
|
17619
17651
|
input,
|
|
17620
17652
|
kind: "read",
|
|
17621
17653
|
name: "runner.inspectMobile",
|
|
@@ -17982,7 +18014,7 @@ var makeRecordOnRunnerContract = (ids) => {
|
|
|
17982
18014
|
openWorldHint: false,
|
|
17983
18015
|
readOnlyHint: false
|
|
17984
18016
|
},
|
|
17985
|
-
description: "Control video recording on a
|
|
18017
|
+
description: "Control video recording on a browser, mobile, Windows, or Mac runner. Start requires a caller-generated UUID; stop targets that UUID so retries cannot stop a later recording. Manual capture spans runs and suppresses automatic capture. Auto settings affect subsequent full runs. The URL opens recording history after the runner terminates. Videos may be unavailable after abrupt pod loss.",
|
|
17986
18018
|
input,
|
|
17987
18019
|
kind: "write",
|
|
17988
18020
|
name: "runner.record",
|
|
@@ -18062,6 +18094,7 @@ var makeTriggerActionSchema = (ids) => object({
|
|
|
18062
18094
|
investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
|
|
18063
18095
|
kind: triggerActionKindSchema.default("createSuite"),
|
|
18064
18096
|
runConcurrencyLimit: string2().trim().min(1).max(255).optional().describe(`How many runs of the resulting suite may execute at once: a whole number from 1 to 1000, "unlimited", or a concurrency expression, which the server validates. It replaces the environment's limit rather than capping below it. Omit it to leave the environment's limit in charge.`),
|
|
18097
|
+
suggestCoverage: boolean2().optional().describe("Whether QA Wolf explores the environment after the resulting runs and suggests coverage that nothing tests yet. Defaults to false."),
|
|
18065
18098
|
tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
|
|
18066
18099
|
}).describe("What the trigger runs when it fires.");
|
|
18067
18100
|
var makeTriggerScheduleFields = (ids) => ({
|
|
@@ -18584,6 +18617,173 @@ var makeGetAttemptContract = (ids) => {
|
|
|
18584
18617
|
};
|
|
18585
18618
|
};
|
|
18586
18619
|
|
|
18620
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/create.js
|
|
18621
|
+
var makeCreateBuildContract = (ids) => {
|
|
18622
|
+
const input = object({
|
|
18623
|
+
branch: string2().trim().min(1).max(255).optional().describe("The branch the build came from. Shown with the build."),
|
|
18624
|
+
buildId: buildIdSchema.describe("The buildId build.requestUpload answered with. Upload the file first."),
|
|
18625
|
+
commitSha: string2().trim().min(1).max(255).optional().describe("The commit the build came from. Shown with the build."),
|
|
18626
|
+
environment: makeBuildEnvironmentSelectorSchema(ids).optional().describe("The environment whose runs install the build from now on, until a newer build of the same app and platform arrives. Omit for a build that only runs created with it install."),
|
|
18627
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18628
|
+
}).superRefine((value, context) => {
|
|
18629
|
+
if (value.environment !== undefined && "name" in value.environment && value.environment.baseEphemeralEnvironment !== undefined && value.environment.ephemeral !== true) {
|
|
18630
|
+
context.addIssue({
|
|
18631
|
+
code: "custom",
|
|
18632
|
+
message: "baseEphemeralEnvironment is only valid with ephemeral.",
|
|
18633
|
+
path: ["environment", "baseEphemeralEnvironment"]
|
|
18634
|
+
});
|
|
18635
|
+
}
|
|
18636
|
+
});
|
|
18637
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18638
|
+
return {
|
|
18639
|
+
annotationJustifications: {
|
|
18640
|
+
destructiveHint: "Creates a build. With an environment, later runs there install it instead of the previous build.",
|
|
18641
|
+
openWorldHint: "Reads the uploaded file from QA Wolf storage only.",
|
|
18642
|
+
readOnlyHint: "Creates a build, and can create the environment it names."
|
|
18643
|
+
},
|
|
18644
|
+
annotations: {
|
|
18645
|
+
destructiveHint: false,
|
|
18646
|
+
openWorldHint: false,
|
|
18647
|
+
readOnlyHint: false
|
|
18648
|
+
},
|
|
18649
|
+
description: "Create a build from a file uploaded with build.requestUpload. Reads the app ID, name, version and build number from the file before it answers, or refuses a file that isn't an app. Calling it again with the same buildId answers the build the first call created, unchanged: a repeated call's branch, commitSha and environment are ignored.",
|
|
18650
|
+
input,
|
|
18651
|
+
kind: "write",
|
|
18652
|
+
name: "build.create",
|
|
18653
|
+
output
|
|
18654
|
+
};
|
|
18655
|
+
};
|
|
18656
|
+
|
|
18657
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/delete.js
|
|
18658
|
+
var makeDeleteBuildContract = (ids) => {
|
|
18659
|
+
const input = object({
|
|
18660
|
+
buildId: buildIdSchema,
|
|
18661
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18662
|
+
});
|
|
18663
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18664
|
+
return {
|
|
18665
|
+
annotationJustifications: {
|
|
18666
|
+
destructiveHint: "Deletes the build. Runs never install it after, and when it is an environment's latest build, runs there install the previous one instead, if its file is still kept.",
|
|
18667
|
+
openWorldHint: "Changes QA Wolf data and storage only.",
|
|
18668
|
+
readOnlyHint: "Deletes one build."
|
|
18669
|
+
},
|
|
18670
|
+
annotations: {
|
|
18671
|
+
destructiveHint: true,
|
|
18672
|
+
openWorldHint: false,
|
|
18673
|
+
readOnlyHint: false
|
|
18674
|
+
},
|
|
18675
|
+
description: "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.",
|
|
18676
|
+
input,
|
|
18677
|
+
kind: "write",
|
|
18678
|
+
name: "build.delete",
|
|
18679
|
+
output
|
|
18680
|
+
};
|
|
18681
|
+
};
|
|
18682
|
+
|
|
18683
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/get.js
|
|
18684
|
+
var makeGetBuildContract = (ids) => {
|
|
18685
|
+
const input = object({
|
|
18686
|
+
buildId: buildIdSchema,
|
|
18687
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18688
|
+
});
|
|
18689
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18690
|
+
return {
|
|
18691
|
+
annotationJustifications: {
|
|
18692
|
+
destructiveHint: "Does not change the build.",
|
|
18693
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
18694
|
+
readOnlyHint: "Reads one build."
|
|
18695
|
+
},
|
|
18696
|
+
annotations: {
|
|
18697
|
+
destructiveHint: false,
|
|
18698
|
+
openWorldHint: false,
|
|
18699
|
+
readOnlyHint: true
|
|
18700
|
+
},
|
|
18701
|
+
description: "Get a build: its app, platform, version and environment. Deleted builds are returned too.",
|
|
18702
|
+
input,
|
|
18703
|
+
kind: "read",
|
|
18704
|
+
name: "build.get",
|
|
18705
|
+
output
|
|
18706
|
+
};
|
|
18707
|
+
};
|
|
18708
|
+
|
|
18709
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/list.js
|
|
18710
|
+
var makeListBuildsContract = (ids) => {
|
|
18711
|
+
const input = object({
|
|
18712
|
+
appId: string2().trim().min(1).optional().describe("Only list builds of this package name or bundle ID."),
|
|
18713
|
+
environmentId: ids.environment.optional().describe("Only list builds on this environment."),
|
|
18714
|
+
latestOnly: boolean2().default(false).describe("List only the builds the environment's next run installs: the newest undeleted build of each app and platform. Requires environmentId."),
|
|
18715
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list builds from. Required when authenticating with an organization or user API key."),
|
|
18716
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
|
|
18717
|
+
}).refine((value) => !value.latestOnly || value.environmentId !== undefined, {
|
|
18718
|
+
message: "latestOnly requires environmentId.",
|
|
18719
|
+
path: ["latestOnly"]
|
|
18720
|
+
});
|
|
18721
|
+
const output = object({
|
|
18722
|
+
builds: array(makeBuildResourceSchema(ids)).describe("Undeleted builds, newest first."),
|
|
18723
|
+
nextCursor: nextCursorSchema
|
|
18724
|
+
});
|
|
18725
|
+
return {
|
|
18726
|
+
annotationJustifications: {
|
|
18727
|
+
destructiveHint: "Does not change any build.",
|
|
18728
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
18729
|
+
readOnlyHint: "Lists builds."
|
|
18730
|
+
},
|
|
18731
|
+
annotations: {
|
|
18732
|
+
destructiveHint: false,
|
|
18733
|
+
openWorldHint: false,
|
|
18734
|
+
readOnlyHint: true
|
|
18735
|
+
},
|
|
18736
|
+
description: "List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs.",
|
|
18737
|
+
input,
|
|
18738
|
+
kind: "read",
|
|
18739
|
+
name: "build.list",
|
|
18740
|
+
output
|
|
18741
|
+
};
|
|
18742
|
+
};
|
|
18743
|
+
|
|
18744
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
18745
|
+
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
18746
|
+
var makeRequestBuildUploadContract = (ids) => {
|
|
18747
|
+
const input = object({
|
|
18748
|
+
buildId: buildIdSchema.optional().describe("Send the buildId of an earlier answer to get a fresh URL for the same build. Omit for a new build."),
|
|
18749
|
+
fileName: string2().regex(/^[A-Za-z0-9._-]{1,255}$/, "A file name is one path segment of letters, digits, dots, dashes and underscores, at most 255 characters.").refine((fileName) => /\.(apk|aab|ipa)$/i.test(fileName), "A build is an .apk, .aab or .ipa file.").describe("The file's name, such as `app-release.apk`, `app-release.aab` or `App.ipa`. Its extension sets the platform."),
|
|
18750
|
+
fileSizeBytes: number2().int().min(1).max(maxBuildFileBytes).describe("The file's exact size in bytes, at most 500 MB. The URL accepts only a file of this size."),
|
|
18751
|
+
workspaceId: ids.workspace.optional().describe("The workspace to upload into. Required when authenticating with an organization or user API key.")
|
|
18752
|
+
});
|
|
18753
|
+
const output = object({
|
|
18754
|
+
buildId: buildIdSchema.describe("Send this to build.create after the PUT."),
|
|
18755
|
+
expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
|
|
18756
|
+
uploadHeaders: record(string2(), string2()).describe("Send these headers with the PUT, exactly. The URL is signed for them."),
|
|
18757
|
+
uploadUrl: string2().describe("Send the file's bytes here with a single HTTP PUT carrying uploadHeaders, for example `curl -X PUT -H 'Content-Type: application/octet-stream' -H 'x-goog-if-generation-match: 0' --upload-file app.apk \"<uploadUrl>\"`. The URL only creates the file: it refuses to overwrite one.")
|
|
18758
|
+
});
|
|
18759
|
+
return {
|
|
18760
|
+
annotationJustifications: {
|
|
18761
|
+
destructiveHint: "The URL only creates a new file. It cannot overwrite or delete one.",
|
|
18762
|
+
openWorldHint: "The upload target is QA Wolf's run inputs storage, not an external service.",
|
|
18763
|
+
readOnlyHint: "Returns an expiring URL that permits writing one file to the workspace's storage."
|
|
18764
|
+
},
|
|
18765
|
+
annotations: {
|
|
18766
|
+
destructiveHint: false,
|
|
18767
|
+
openWorldHint: false,
|
|
18768
|
+
readOnlyHint: false
|
|
18769
|
+
},
|
|
18770
|
+
description: "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.",
|
|
18771
|
+
input,
|
|
18772
|
+
kind: "write",
|
|
18773
|
+
name: "build.requestUpload",
|
|
18774
|
+
output
|
|
18775
|
+
};
|
|
18776
|
+
};
|
|
18777
|
+
|
|
18778
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/index.js
|
|
18779
|
+
var makeBuildContracts = (ids) => ({
|
|
18780
|
+
create: makeCreateBuildContract(ids),
|
|
18781
|
+
delete: makeDeleteBuildContract(ids),
|
|
18782
|
+
get: makeGetBuildContract(ids),
|
|
18783
|
+
list: makeListBuildsContract(ids),
|
|
18784
|
+
requestUpload: makeRequestBuildUploadContract(ids)
|
|
18785
|
+
});
|
|
18786
|
+
|
|
18587
18787
|
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/resource.js
|
|
18588
18788
|
var makeCodeHostIntegrationResourceSchema = () => resource({
|
|
18589
18789
|
connectedAt: exports_iso.datetime().describe("When the code host was connected to the workspace."),
|
|
@@ -18820,6 +19020,7 @@ var makeReportDeploymentStatusContract = (ids) => {
|
|
|
18820
19020
|
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
18821
19021
|
});
|
|
18822
19022
|
const input = strictObject({
|
|
19023
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("The builds this deployment ships, from build.create. Runs this deployment starts install them. A report that omits this field keeps the stored builds."),
|
|
18823
19024
|
deployTarget: httpUrl().max(2048).describe("The URL the deployment serves, e.g. a preview URL. A mobile pipeline leaves it unset and reports a service instead.").optional(),
|
|
18824
19025
|
environment: environment.describe("Selects the environment the deployment reports into.").optional(),
|
|
18825
19026
|
environmentVariables: record(string2(), string2()).describe("Environment variable overrides for the runs this deployment requests. A report that omits this field keeps the stored values. A report that sends it replaces them.").optional(),
|
|
@@ -19713,12 +19914,28 @@ var makeGetIssueContract = (ids) => {
|
|
|
19713
19914
|
};
|
|
19714
19915
|
|
|
19715
19916
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/finding.js
|
|
19716
|
-
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "
|
|
19917
|
+
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question", "dismissed" and "superseded". "superseded" means a newer run replaced this run before the investigation concluded. New values can appear.';
|
|
19918
|
+
var investigationQuestionSchema = object({
|
|
19919
|
+
answers: array(object({
|
|
19920
|
+
description: string2().optional(),
|
|
19921
|
+
title: string2(),
|
|
19922
|
+
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
19923
|
+
})),
|
|
19924
|
+
body: string2().optional().describe("Markdown details under the question: what the test expects, what the app does and what each answer changes. A value a person must copy is in a code block."),
|
|
19925
|
+
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
19926
|
+
text: string2()
|
|
19927
|
+
});
|
|
19717
19928
|
var makeInvestigationFindingSchema = (ids) => object({
|
|
19718
19929
|
actual: string2().optional(),
|
|
19719
19930
|
commitHash: string2().optional().describe("The commit of a commit fix. Same as `fix.commitHash`."),
|
|
19720
19931
|
decidedBy: _enum(["agent", "user"]).optional().describe("Who decided: the AI on its own, or a person who approved or dismissed it. Absent until someone decides."),
|
|
19721
19932
|
disputeReason: string2().optional().describe("Why a person disputed what the AI did. Present on a proposal the AI made again after that dispute."),
|
|
19933
|
+
earlierQuestions: array(object({
|
|
19934
|
+
answer: string2(),
|
|
19935
|
+
answeredAt: exports_iso.datetime(),
|
|
19936
|
+
body: string2().optional(),
|
|
19937
|
+
text: string2()
|
|
19938
|
+
})).optional().describe("Questions about this cause that a person already answered, oldest first. The AI acted on each answer."),
|
|
19722
19939
|
expected: string2().optional(),
|
|
19723
19940
|
findingId: string2(),
|
|
19724
19941
|
fix: discriminatedUnion("type", [
|
|
@@ -19745,15 +19962,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
19745
19962
|
reason: string2().describe("Why the investigation reached the verdict."),
|
|
19746
19963
|
verdict: string2().describe('Whether the pull request caused the failure. Known values: "caused", "not-caused" and "unclear". New values can appear.')
|
|
19747
19964
|
}).optional().describe("Whether the pull request the run tested caused this finding. Absent on a run that didn't test a pull request, and when the investigation didn't say."),
|
|
19748
|
-
question:
|
|
19749
|
-
answers: array(object({
|
|
19750
|
-
description: string2().optional(),
|
|
19751
|
-
title: string2(),
|
|
19752
|
-
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
19753
|
-
})),
|
|
19754
|
-
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
19755
|
-
text: string2()
|
|
19756
|
-
}).optional().describe("The question waiting for a person, with the answers offered."),
|
|
19965
|
+
question: investigationQuestionSchema.optional().describe("The question waiting for a person, with the answers offered."),
|
|
19757
19966
|
response: object({
|
|
19758
19967
|
answer: string2().optional(),
|
|
19759
19968
|
at: exports_iso.datetime(),
|
|
@@ -19765,6 +19974,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
19765
19974
|
steps: array(string2()).optional(),
|
|
19766
19975
|
subSessionIds: array(ids.chatSession),
|
|
19767
19976
|
summary: string2().optional(),
|
|
19977
|
+
supersededByRunId: ids.run.optional().describe('The newer run that replaced this run, on a "superseded" finding.'),
|
|
19768
19978
|
updatedAt: exports_iso.datetime()
|
|
19769
19979
|
});
|
|
19770
19980
|
|
|
@@ -19774,6 +19984,17 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
19774
19984
|
const output = resource({
|
|
19775
19985
|
baselineChanges: _enum(["automatic", "needs-approval"]).describe('How the investigation can make a new screenshot the baseline. "automatic": it can accept a baseline on its own. ' + '"needs-approval": it proposes the baseline on a fix-proposed finding, and accepts it only after a person applies the proposal.'),
|
|
19776
19986
|
findings: array(makeInvestigationFindingSchema(ids)),
|
|
19987
|
+
questionsFromOtherRuns: array(object({
|
|
19988
|
+
answer: string2().optional().describe(`The person's answer, when status is "answered".`),
|
|
19989
|
+
answeredAt: exports_iso.datetime().optional(),
|
|
19990
|
+
body: string2().optional(),
|
|
19991
|
+
findingId: string2(),
|
|
19992
|
+
flowIds: array(ids.flow),
|
|
19993
|
+
headline: string2().optional().describe("The cause that the question is about."),
|
|
19994
|
+
runId: ids.run,
|
|
19995
|
+
status: string2().describe('Known values: "open" (waiting for a person) and "answered". New values can appear.'),
|
|
19996
|
+
text: string2()
|
|
19997
|
+
})).optional().describe("Questions that the workspace's other run investigations asked about the same flows in the last 7 days, newest first."),
|
|
19777
19998
|
runId: ids.run,
|
|
19778
19999
|
sessionId: ids.chatSession.optional().describe("The investigation session. Absent when the run has none."),
|
|
19779
20000
|
status: _enum(["investigating", "finished", "not-investigated", "not-enabled"]).describe('Whether the lead or any child investigator is still working. "not-investigated" when the run has no investigation. ' + '"not-enabled" when automatic investigation does not cover this run, because its workspace has it off or investigates only pull request runs: read its failures with run.get and attempt.get instead.'),
|
|
@@ -19801,9 +20022,55 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
19801
20022
|
};
|
|
19802
20023
|
};
|
|
19803
20024
|
|
|
20025
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
|
|
20026
|
+
var makeFindInvestigationQuestionsContract = (ids) => {
|
|
20027
|
+
const input = object({
|
|
20028
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
20029
|
+
environmentId: ids.environmentRef.optional().describe("Only list the questions of runs in this environment. Omit to list the questions of every environment."),
|
|
20030
|
+
statuses: array(_enum(["open"])).min(1).default(["open"]).describe(`Question statuses to include. "open" (waiting for a person's answer) is the only status today.`),
|
|
20031
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list questions from. Required when authenticating with an organization or user API key.")
|
|
20032
|
+
});
|
|
20033
|
+
const output = object({
|
|
20034
|
+
nextCursor: nextCursorSchema,
|
|
20035
|
+
questions: array(resource({
|
|
20036
|
+
askedAt: exports_iso.datetime().describe("When the investigation first recorded the finding that asks the question."),
|
|
20037
|
+
findingId: string2(),
|
|
20038
|
+
flows: array(object({ flowId: ids.flow, name: string2() })).describe("The failed flows the question is about."),
|
|
20039
|
+
headline: string2().optional(),
|
|
20040
|
+
question: investigationQuestionSchema,
|
|
20041
|
+
runId: ids.run,
|
|
20042
|
+
sessionId: ids.chatSession.describe("The investigation session. Answer the question by sending the person's answer to it with agent.send."),
|
|
20043
|
+
summary: string2().optional()
|
|
20044
|
+
}, { urlFieldDescription: "The run in the QA Wolf app." })).describe("Questions that wait for a person's answer, the most recently recorded first. A page can hold fewer than limit questions, or none, while nextCursor is present.")
|
|
20045
|
+
});
|
|
20046
|
+
return {
|
|
20047
|
+
annotationJustifications: {
|
|
20048
|
+
destructiveHint: "Does not answer, dismiss or change any question.",
|
|
20049
|
+
openWorldHint: "Reads recorded QA Wolf findings without changing the application under test.",
|
|
20050
|
+
readOnlyHint: "Lists the open questions of a workspace's investigations without answering them."
|
|
20051
|
+
},
|
|
20052
|
+
annotations: {
|
|
20053
|
+
destructiveHint: false,
|
|
20054
|
+
openWorldHint: false,
|
|
20055
|
+
readOnlyHint: true
|
|
20056
|
+
},
|
|
20057
|
+
description: "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.",
|
|
20058
|
+
input,
|
|
20059
|
+
kind: "read",
|
|
20060
|
+
name: "investigation.question.find",
|
|
20061
|
+
output
|
|
20062
|
+
};
|
|
20063
|
+
};
|
|
20064
|
+
|
|
20065
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
|
|
20066
|
+
var makeInvestigationQuestionContracts = (ids) => ({
|
|
20067
|
+
find: makeFindInvestigationQuestionsContract(ids)
|
|
20068
|
+
});
|
|
20069
|
+
|
|
19804
20070
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/index.js
|
|
19805
20071
|
var makeInvestigationContracts = (ids) => ({
|
|
19806
|
-
get: makeGetInvestigationContract(ids)
|
|
20072
|
+
get: makeGetInvestigationContract(ids),
|
|
20073
|
+
question: makeInvestigationQuestionContracts(ids)
|
|
19807
20074
|
});
|
|
19808
20075
|
|
|
19809
20076
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/addFlows.js
|
|
@@ -19893,6 +20160,35 @@ var makeCreateIssueContract = (ids) => {
|
|
|
19893
20160
|
};
|
|
19894
20161
|
};
|
|
19895
20162
|
|
|
20163
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
|
|
20164
|
+
var makeDecideSuggestionContract = (ids) => {
|
|
20165
|
+
const input = object({
|
|
20166
|
+
decision: _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip before the flow joins. activate: retry a suggestion that QA Wolf held."),
|
|
20167
|
+
issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
|
|
20168
|
+
skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
|
|
20169
|
+
}).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
|
|
20170
|
+
const output = object({
|
|
20171
|
+
issue: makeIssueResourceSchema(ids)
|
|
20172
|
+
});
|
|
20173
|
+
return {
|
|
20174
|
+
annotationJustifications: {
|
|
20175
|
+
destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
|
|
20176
|
+
openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
|
|
20177
|
+
readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
|
|
20178
|
+
},
|
|
20179
|
+
annotations: {
|
|
20180
|
+
destructiveHint: false,
|
|
20181
|
+
openWorldHint: true,
|
|
20182
|
+
readOnlyHint: false
|
|
20183
|
+
},
|
|
20184
|
+
description: "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.",
|
|
20185
|
+
input,
|
|
20186
|
+
kind: "write",
|
|
20187
|
+
name: "issue.decideSuggestion",
|
|
20188
|
+
output
|
|
20189
|
+
};
|
|
20190
|
+
};
|
|
20191
|
+
|
|
19896
20192
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
|
|
19897
20193
|
var issueActivityTypeSchema = _enum([
|
|
19898
20194
|
"created",
|
|
@@ -20152,6 +20448,35 @@ var makeLegacyTriggerContracts = (ids) => ({
|
|
|
20152
20448
|
resume: makeResumeLegacyTriggerContract(ids)
|
|
20153
20449
|
});
|
|
20154
20450
|
|
|
20451
|
+
// node_modules/@qawolf/api-contracts/dist/v1/mcpServer/connect.js
|
|
20452
|
+
var makeConnectMcpServerContract = (ids) => {
|
|
20453
|
+
const input = object({
|
|
20454
|
+
server: string2().trim().min(1).describe("The server to connect, by its catalog id or name, such as linear or Linear."),
|
|
20455
|
+
workspaceId: ids.workspace.optional().describe("The workspace to connect the server to. Required when authenticating with an organization or user API key.")
|
|
20456
|
+
});
|
|
20457
|
+
const output = object({
|
|
20458
|
+
authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
|
|
20459
|
+
serverName: string2().describe("The catalog name of the server.")
|
|
20460
|
+
});
|
|
20461
|
+
return {
|
|
20462
|
+
annotationJustifications: {
|
|
20463
|
+
destructiveHint: "Starts a sign-in without changing or removing existing connections.",
|
|
20464
|
+
openWorldHint: "Asks the external server's OAuth provider for a sign-in page.",
|
|
20465
|
+
readOnlyHint: "Records a pending connection on the workspace."
|
|
20466
|
+
},
|
|
20467
|
+
annotations: {
|
|
20468
|
+
destructiveHint: false,
|
|
20469
|
+
openWorldHint: true,
|
|
20470
|
+
readOnlyHint: false
|
|
20471
|
+
},
|
|
20472
|
+
description: "Start connecting an MCP server from the workspace's catalog, such as Linear, so Tester can use its tools. Returns a sign-in link to show the user.",
|
|
20473
|
+
input,
|
|
20474
|
+
kind: "write",
|
|
20475
|
+
name: "mcpServer.connect",
|
|
20476
|
+
output
|
|
20477
|
+
};
|
|
20478
|
+
};
|
|
20479
|
+
|
|
20155
20480
|
// node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
|
|
20156
20481
|
var investigationSessionId = string2().trim().min(1).max(100).optional();
|
|
20157
20482
|
|
|
@@ -20235,6 +20560,7 @@ var makeDiagnoseRunContract = (ids) => {
|
|
|
20235
20560
|
// node_modules/@qawolf/api-contracts/dist/v1/run/find.js
|
|
20236
20561
|
var makeFindRunsContract = (ids) => {
|
|
20237
20562
|
const input = object({
|
|
20563
|
+
buildId: buildIdSchema.optional().describe("Only include runs that installed this build."),
|
|
20238
20564
|
createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include runs created after this instant, e.g. the runs since a deploy."),
|
|
20239
20565
|
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
20240
20566
|
environmentId: ids.environmentRef,
|
|
@@ -20359,6 +20685,7 @@ var makeGetRunContract = (ids) => {
|
|
|
20359
20685
|
const output = resource({
|
|
20360
20686
|
...makeRunSummaryFields(ids),
|
|
20361
20687
|
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."),
|
|
20688
|
+
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
20362
20689
|
flows,
|
|
20363
20690
|
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.")
|
|
20364
20691
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
@@ -20835,7 +21162,7 @@ var makeReadRunnerJournalContract = (ids) => {
|
|
|
20835
21162
|
openWorldHint: false,
|
|
20836
21163
|
readOnlyHint: false
|
|
20837
21164
|
},
|
|
20838
|
-
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. ${retryableRunnerUnreachableDescription}`,
|
|
21165
|
+
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. Polling \`runner.get\` or \`runner.list\` does not count as activity, so the inactivity clock keeps running until the runner is reaped. The journal lives only on the runner: once it is terminated or stops after inactivity, the journal is gone and this read answers not-found. ${retryableRunnerUnreachableDescription}`,
|
|
20839
21166
|
input,
|
|
20840
21167
|
kind: "read",
|
|
20841
21168
|
name: "runner.readJournal",
|
|
@@ -20985,7 +21312,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
|
|
|
20985
21312
|
openWorldHint: false,
|
|
20986
21313
|
readOnlyHint: false
|
|
20987
21314
|
},
|
|
20988
|
-
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
|
|
21315
|
+
description: `Take one screenshot of an interactive runner's screen. This refreshes the inactivity timer and can extend the runner's billed lifetime. On a runner with a browser the image is the whole virtual desktop, browser window and all. On a mobile runner it is the device's own screen, 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}`,
|
|
20989
21316
|
input,
|
|
20990
21317
|
kind: "read",
|
|
20991
21318
|
name: "runner.takeScreenshot",
|
|
@@ -21120,6 +21447,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21120
21447
|
attempt: {
|
|
21121
21448
|
get: makeGetAttemptContract(resolvedIds)
|
|
21122
21449
|
},
|
|
21450
|
+
build: makeBuildContracts(resolvedIds),
|
|
21123
21451
|
codeHostIntegration: {
|
|
21124
21452
|
find: makeFindCodeHostIntegrationsContract(resolvedIds),
|
|
21125
21453
|
listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
|
|
@@ -21157,6 +21485,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21157
21485
|
issue: {
|
|
21158
21486
|
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
21159
21487
|
create: makeCreateIssueContract(resolvedIds),
|
|
21488
|
+
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
21160
21489
|
find: makeFindIssuesContract(resolvedIds),
|
|
21161
21490
|
get: makeGetIssueContract(resolvedIds),
|
|
21162
21491
|
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
@@ -21164,6 +21493,9 @@ var makeContractsV1 = (ids) => {
|
|
|
21164
21493
|
update: makeUpdateIssueContract(resolvedIds)
|
|
21165
21494
|
},
|
|
21166
21495
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
21496
|
+
mcpServer: {
|
|
21497
|
+
connect: makeConnectMcpServerContract(resolvedIds)
|
|
21498
|
+
},
|
|
21167
21499
|
promotion: makePromotionContracts(resolvedIds),
|
|
21168
21500
|
run: {
|
|
21169
21501
|
acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
|
|
@@ -23691,7 +24023,7 @@ function startUpdateCheck(deps) {
|
|
|
23691
24023
|
// package.json
|
|
23692
24024
|
var package_default = {
|
|
23693
24025
|
name: "@qawolf/cli",
|
|
23694
|
-
version: "2.
|
|
24026
|
+
version: "2.4.0",
|
|
23695
24027
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
23696
24028
|
keywords: [
|
|
23697
24029
|
"automation",
|
|
@@ -23763,7 +24095,7 @@ var package_default = {
|
|
|
23763
24095
|
"@clack/prompts": "1.5.1",
|
|
23764
24096
|
"@napi-rs/keyring": "1.3.0",
|
|
23765
24097
|
"@oxc-node/core": "0.1.0",
|
|
23766
|
-
"@qawolf/api-contracts": "0.
|
|
24098
|
+
"@qawolf/api-contracts": "0.104.0",
|
|
23767
24099
|
"@qawolf/emails": "1.1.1",
|
|
23768
24100
|
"@qawolf/flow-targets": "2.0.0",
|
|
23769
24101
|
"@qawolf/flows": "0.3.0",
|
|
@@ -41898,4 +42230,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
41898
42230
|
process.exitCode = 1;
|
|
41899
42231
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
41900
42232
|
|
|
41901
|
-
//# debugId=
|
|
42233
|
+
//# debugId=F41EBBF938D33FDB64756E2164756E21
|
package/dist/runner-sdk.js
CHANGED
|
@@ -7365,6 +7365,37 @@ 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/build/resource.js
|
|
7369
|
+
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
7370
|
+
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.");
|
|
7371
|
+
var makeBuildResourceSchema = (ids) => resource({
|
|
7372
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
|
|
7373
|
+
appName: string2().optional().describe("The app's display name, when the file names one."),
|
|
7374
|
+
branch: string2().optional().describe("The branch the uploader said the build came from."),
|
|
7375
|
+
buildNumber: string2().optional().describe("versionCode (Android) or CFBundleVersion (iOS), when the file has one."),
|
|
7376
|
+
commitSha: string2().optional().describe("The commit the uploader said the build came from."),
|
|
7377
|
+
createdAt: exports_iso.datetime().describe("When the build was created."),
|
|
7378
|
+
deletedAt: exports_iso.datetime().optional().describe("When the build was deleted. Runs never install it after."),
|
|
7379
|
+
environmentId: ids.environment.optional().describe("The environment whose runs install the build while it is the newest one there for its app and platform. Absent: only a run created with the build installs it."),
|
|
7380
|
+
fileName: string2().describe("The uploaded file's name."),
|
|
7381
|
+
id: buildIdSchema,
|
|
7382
|
+
platform: buildPlatformSchema,
|
|
7383
|
+
sizeBytes: number2().int().optional().describe("The file's size in bytes."),
|
|
7384
|
+
version: string2().optional().describe("versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.")
|
|
7385
|
+
}, { urlFieldDescription: "Absolute URL of the team's Builds page." });
|
|
7386
|
+
var makeBuildEnvironmentSelectorSchema = (ids) => union([
|
|
7387
|
+
strictObject({
|
|
7388
|
+
id: ids.environment.describe("The id of an existing environment. Never creates an environment. Send an alias through name instead.")
|
|
7389
|
+
}),
|
|
7390
|
+
strictObject({
|
|
7391
|
+
baseEphemeralEnvironment: string2().trim().min(1).max(255).optional().describe("The alias or name of the environment a created ephemeral environment copies from. Only valid with ephemeral."),
|
|
7392
|
+
ephemeral: boolean2().optional().describe("Requests an ephemeral environment when the name creates one, such as a pull request's. A name that matches an existing environment keeps that environment's kind."),
|
|
7393
|
+
name: string2().trim().min(1).max(255).describe("The environment's alias or name, as deployment.reportStatus takes it. Creates the environment when none matches. It keeps its base's URL.")
|
|
7394
|
+
})
|
|
7395
|
+
], {
|
|
7396
|
+
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
7397
|
+
});
|
|
7398
|
+
|
|
7368
7399
|
// node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
|
|
7369
7400
|
var makeFlowSelectionSchema = (ids) => object({
|
|
7370
7401
|
flowIds: array(ids.flow).default([]),
|
|
@@ -7377,6 +7408,7 @@ var makeFlowSelectionSchema = (ids) => object({
|
|
|
7377
7408
|
var makeCreateRunContract = (ids) => {
|
|
7378
7409
|
const input = object({
|
|
7379
7410
|
aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
|
|
7411
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("Builds to install in this run only. Each replaces the environment's latest build of its app and platform."),
|
|
7380
7412
|
chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
|
|
7381
7413
|
environmentId: ids.environmentRef,
|
|
7382
7414
|
environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
|
|
@@ -7844,14 +7876,14 @@ var makeInspectMobileOnRunnerContract = (ids) => {
|
|
|
7844
7876
|
annotationJustifications: {
|
|
7845
7877
|
destructiveHint: "Does not change application data, edit tests, or stop the runner.",
|
|
7846
7878
|
openWorldHint: "Inspects the existing QA Wolf mobile runner without submitting application actions or contacting arbitrary services.",
|
|
7847
|
-
readOnlyHint: "Reads mobile session status, contexts, page source, or elements
|
|
7879
|
+
readOnlyHint: "Reads mobile session status, contexts, page source, or elements and refreshes activity, which can cancel an inactivity shutdown."
|
|
7848
7880
|
},
|
|
7849
7881
|
annotations: {
|
|
7850
7882
|
destructiveHint: false,
|
|
7851
7883
|
openWorldHint: false,
|
|
7852
|
-
readOnlyHint:
|
|
7884
|
+
readOnlyHint: false
|
|
7853
7885
|
},
|
|
7854
|
-
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This
|
|
7886
|
+
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This refreshes the inactivity timer and can extend the runner's billed lifetime. Mobile and Windows only — a browser runner answers \`runner-is-not-mobile\`; call \`runner.inspect\` for a browser's equivalent surface instead. \`what: "session"\` always answers with the session's own status rather than \`screen-needs-a-run\`, since that is the question it exists to answer; the other three request kinds need a live session first and answer the same \`screen-needs-a-run\` or \`screen-not-ready\` outcomes \`runner.performAction\` and \`runner.takeScreenshot\` use, instead of reading anything when there is none. \`screen-needs-a-run\` means no Appium session has started on this runner yet — call \`runner.runFlow\` with a flow that opens one, then inspect again. \`screen-not-ready\` means the runner's Appium session exists but did not answer this instant, or more than one is somehow live — retry once; if it persists, relaunch the runner. \`runner-is-not-mobile\` means there is nothing here to inspect, and retrying will never help — launch an \`android\`, \`ios\` or \`windows\` runner instead. \`invalid-selector\` (elements by selector only) means the selector itself could not be parsed under the given \`strategy\` — distinct from a selector that parsed fine but matched nothing, which answers \`matches: []\` instead. ${retryableRunnerUnreachableDescription}`,
|
|
7855
7887
|
input,
|
|
7856
7888
|
kind: "read",
|
|
7857
7889
|
name: "runner.inspectMobile",
|
|
@@ -8220,7 +8252,7 @@ var makeRecordOnRunnerContract = (ids) => {
|
|
|
8220
8252
|
openWorldHint: false,
|
|
8221
8253
|
readOnlyHint: false
|
|
8222
8254
|
},
|
|
8223
|
-
description: "Control video recording on a
|
|
8255
|
+
description: "Control video recording on a browser, mobile, Windows, or Mac runner. Start requires a caller-generated UUID; stop targets that UUID so retries cannot stop a later recording. Manual capture spans runs and suppresses automatic capture. Auto settings affect subsequent full runs. The URL opens recording history after the runner terminates. Videos may be unavailable after abrupt pod loss.",
|
|
8224
8256
|
input,
|
|
8225
8257
|
kind: "write",
|
|
8226
8258
|
name: "runner.record",
|
|
@@ -8301,6 +8333,7 @@ var makeTriggerActionSchema = (ids) => object({
|
|
|
8301
8333
|
investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
|
|
8302
8334
|
kind: triggerActionKindSchema.default("createSuite"),
|
|
8303
8335
|
runConcurrencyLimit: string2().trim().min(1).max(255).optional().describe(`How many runs of the resulting suite may execute at once: a whole number from 1 to 1000, "unlimited", or a concurrency expression, which the server validates. It replaces the environment's limit rather than capping below it. Omit it to leave the environment's limit in charge.`),
|
|
8336
|
+
suggestCoverage: boolean2().optional().describe("Whether QA Wolf explores the environment after the resulting runs and suggests coverage that nothing tests yet. Defaults to false."),
|
|
8304
8337
|
tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
|
|
8305
8338
|
}).describe("What the trigger runs when it fires.");
|
|
8306
8339
|
var makeTriggerScheduleFields = (ids) => ({
|
|
@@ -8823,6 +8856,173 @@ var makeGetAttemptContract = (ids) => {
|
|
|
8823
8856
|
};
|
|
8824
8857
|
};
|
|
8825
8858
|
|
|
8859
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/create.js
|
|
8860
|
+
var makeCreateBuildContract = (ids) => {
|
|
8861
|
+
const input = object({
|
|
8862
|
+
branch: string2().trim().min(1).max(255).optional().describe("The branch the build came from. Shown with the build."),
|
|
8863
|
+
buildId: buildIdSchema.describe("The buildId build.requestUpload answered with. Upload the file first."),
|
|
8864
|
+
commitSha: string2().trim().min(1).max(255).optional().describe("The commit the build came from. Shown with the build."),
|
|
8865
|
+
environment: makeBuildEnvironmentSelectorSchema(ids).optional().describe("The environment whose runs install the build from now on, until a newer build of the same app and platform arrives. Omit for a build that only runs created with it install."),
|
|
8866
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
8867
|
+
}).superRefine((value, context) => {
|
|
8868
|
+
if (value.environment !== undefined && "name" in value.environment && value.environment.baseEphemeralEnvironment !== undefined && value.environment.ephemeral !== true) {
|
|
8869
|
+
context.addIssue({
|
|
8870
|
+
code: "custom",
|
|
8871
|
+
message: "baseEphemeralEnvironment is only valid with ephemeral.",
|
|
8872
|
+
path: ["environment", "baseEphemeralEnvironment"]
|
|
8873
|
+
});
|
|
8874
|
+
}
|
|
8875
|
+
});
|
|
8876
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
8877
|
+
return {
|
|
8878
|
+
annotationJustifications: {
|
|
8879
|
+
destructiveHint: "Creates a build. With an environment, later runs there install it instead of the previous build.",
|
|
8880
|
+
openWorldHint: "Reads the uploaded file from QA Wolf storage only.",
|
|
8881
|
+
readOnlyHint: "Creates a build, and can create the environment it names."
|
|
8882
|
+
},
|
|
8883
|
+
annotations: {
|
|
8884
|
+
destructiveHint: false,
|
|
8885
|
+
openWorldHint: false,
|
|
8886
|
+
readOnlyHint: false
|
|
8887
|
+
},
|
|
8888
|
+
description: "Create a build from a file uploaded with build.requestUpload. Reads the app ID, name, version and build number from the file before it answers, or refuses a file that isn't an app. Calling it again with the same buildId answers the build the first call created, unchanged: a repeated call's branch, commitSha and environment are ignored.",
|
|
8889
|
+
input,
|
|
8890
|
+
kind: "write",
|
|
8891
|
+
name: "build.create",
|
|
8892
|
+
output
|
|
8893
|
+
};
|
|
8894
|
+
};
|
|
8895
|
+
|
|
8896
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/delete.js
|
|
8897
|
+
var makeDeleteBuildContract = (ids) => {
|
|
8898
|
+
const input = object({
|
|
8899
|
+
buildId: buildIdSchema,
|
|
8900
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
8901
|
+
});
|
|
8902
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
8903
|
+
return {
|
|
8904
|
+
annotationJustifications: {
|
|
8905
|
+
destructiveHint: "Deletes the build. Runs never install it after, and when it is an environment's latest build, runs there install the previous one instead, if its file is still kept.",
|
|
8906
|
+
openWorldHint: "Changes QA Wolf data and storage only.",
|
|
8907
|
+
readOnlyHint: "Deletes one build."
|
|
8908
|
+
},
|
|
8909
|
+
annotations: {
|
|
8910
|
+
destructiveHint: true,
|
|
8911
|
+
openWorldHint: false,
|
|
8912
|
+
readOnlyHint: false
|
|
8913
|
+
},
|
|
8914
|
+
description: "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.",
|
|
8915
|
+
input,
|
|
8916
|
+
kind: "write",
|
|
8917
|
+
name: "build.delete",
|
|
8918
|
+
output
|
|
8919
|
+
};
|
|
8920
|
+
};
|
|
8921
|
+
|
|
8922
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/get.js
|
|
8923
|
+
var makeGetBuildContract = (ids) => {
|
|
8924
|
+
const input = object({
|
|
8925
|
+
buildId: buildIdSchema,
|
|
8926
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
8927
|
+
});
|
|
8928
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
8929
|
+
return {
|
|
8930
|
+
annotationJustifications: {
|
|
8931
|
+
destructiveHint: "Does not change the build.",
|
|
8932
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
8933
|
+
readOnlyHint: "Reads one build."
|
|
8934
|
+
},
|
|
8935
|
+
annotations: {
|
|
8936
|
+
destructiveHint: false,
|
|
8937
|
+
openWorldHint: false,
|
|
8938
|
+
readOnlyHint: true
|
|
8939
|
+
},
|
|
8940
|
+
description: "Get a build: its app, platform, version and environment. Deleted builds are returned too.",
|
|
8941
|
+
input,
|
|
8942
|
+
kind: "read",
|
|
8943
|
+
name: "build.get",
|
|
8944
|
+
output
|
|
8945
|
+
};
|
|
8946
|
+
};
|
|
8947
|
+
|
|
8948
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/list.js
|
|
8949
|
+
var makeListBuildsContract = (ids) => {
|
|
8950
|
+
const input = object({
|
|
8951
|
+
appId: string2().trim().min(1).optional().describe("Only list builds of this package name or bundle ID."),
|
|
8952
|
+
environmentId: ids.environment.optional().describe("Only list builds on this environment."),
|
|
8953
|
+
latestOnly: boolean2().default(false).describe("List only the builds the environment's next run installs: the newest undeleted build of each app and platform. Requires environmentId."),
|
|
8954
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list builds from. Required when authenticating with an organization or user API key."),
|
|
8955
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
|
|
8956
|
+
}).refine((value) => !value.latestOnly || value.environmentId !== undefined, {
|
|
8957
|
+
message: "latestOnly requires environmentId.",
|
|
8958
|
+
path: ["latestOnly"]
|
|
8959
|
+
});
|
|
8960
|
+
const output = object({
|
|
8961
|
+
builds: array(makeBuildResourceSchema(ids)).describe("Undeleted builds, newest first."),
|
|
8962
|
+
nextCursor: nextCursorSchema
|
|
8963
|
+
});
|
|
8964
|
+
return {
|
|
8965
|
+
annotationJustifications: {
|
|
8966
|
+
destructiveHint: "Does not change any build.",
|
|
8967
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
8968
|
+
readOnlyHint: "Lists builds."
|
|
8969
|
+
},
|
|
8970
|
+
annotations: {
|
|
8971
|
+
destructiveHint: false,
|
|
8972
|
+
openWorldHint: false,
|
|
8973
|
+
readOnlyHint: true
|
|
8974
|
+
},
|
|
8975
|
+
description: "List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs.",
|
|
8976
|
+
input,
|
|
8977
|
+
kind: "read",
|
|
8978
|
+
name: "build.list",
|
|
8979
|
+
output
|
|
8980
|
+
};
|
|
8981
|
+
};
|
|
8982
|
+
|
|
8983
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
8984
|
+
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
8985
|
+
var makeRequestBuildUploadContract = (ids) => {
|
|
8986
|
+
const input = object({
|
|
8987
|
+
buildId: buildIdSchema.optional().describe("Send the buildId of an earlier answer to get a fresh URL for the same build. Omit for a new build."),
|
|
8988
|
+
fileName: string2().regex(/^[A-Za-z0-9._-]{1,255}$/, "A file name is one path segment of letters, digits, dots, dashes and underscores, at most 255 characters.").refine((fileName) => /\.(apk|aab|ipa)$/i.test(fileName), "A build is an .apk, .aab or .ipa file.").describe("The file's name, such as `app-release.apk`, `app-release.aab` or `App.ipa`. Its extension sets the platform."),
|
|
8989
|
+
fileSizeBytes: number2().int().min(1).max(maxBuildFileBytes).describe("The file's exact size in bytes, at most 500 MB. The URL accepts only a file of this size."),
|
|
8990
|
+
workspaceId: ids.workspace.optional().describe("The workspace to upload into. Required when authenticating with an organization or user API key.")
|
|
8991
|
+
});
|
|
8992
|
+
const output = object({
|
|
8993
|
+
buildId: buildIdSchema.describe("Send this to build.create after the PUT."),
|
|
8994
|
+
expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
|
|
8995
|
+
uploadHeaders: record(string2(), string2()).describe("Send these headers with the PUT, exactly. The URL is signed for them."),
|
|
8996
|
+
uploadUrl: string2().describe("Send the file's bytes here with a single HTTP PUT carrying uploadHeaders, for example `curl -X PUT -H 'Content-Type: application/octet-stream' -H 'x-goog-if-generation-match: 0' --upload-file app.apk \"<uploadUrl>\"`. The URL only creates the file: it refuses to overwrite one.")
|
|
8997
|
+
});
|
|
8998
|
+
return {
|
|
8999
|
+
annotationJustifications: {
|
|
9000
|
+
destructiveHint: "The URL only creates a new file. It cannot overwrite or delete one.",
|
|
9001
|
+
openWorldHint: "The upload target is QA Wolf's run inputs storage, not an external service.",
|
|
9002
|
+
readOnlyHint: "Returns an expiring URL that permits writing one file to the workspace's storage."
|
|
9003
|
+
},
|
|
9004
|
+
annotations: {
|
|
9005
|
+
destructiveHint: false,
|
|
9006
|
+
openWorldHint: false,
|
|
9007
|
+
readOnlyHint: false
|
|
9008
|
+
},
|
|
9009
|
+
description: "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.",
|
|
9010
|
+
input,
|
|
9011
|
+
kind: "write",
|
|
9012
|
+
name: "build.requestUpload",
|
|
9013
|
+
output
|
|
9014
|
+
};
|
|
9015
|
+
};
|
|
9016
|
+
|
|
9017
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/index.js
|
|
9018
|
+
var makeBuildContracts = (ids) => ({
|
|
9019
|
+
create: makeCreateBuildContract(ids),
|
|
9020
|
+
delete: makeDeleteBuildContract(ids),
|
|
9021
|
+
get: makeGetBuildContract(ids),
|
|
9022
|
+
list: makeListBuildsContract(ids),
|
|
9023
|
+
requestUpload: makeRequestBuildUploadContract(ids)
|
|
9024
|
+
});
|
|
9025
|
+
|
|
8826
9026
|
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/resource.js
|
|
8827
9027
|
var makeCodeHostIntegrationResourceSchema = () => resource({
|
|
8828
9028
|
connectedAt: exports_iso.datetime().describe("When the code host was connected to the workspace."),
|
|
@@ -9059,6 +9259,7 @@ var makeReportDeploymentStatusContract = (ids) => {
|
|
|
9059
9259
|
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
9060
9260
|
});
|
|
9061
9261
|
const input = strictObject({
|
|
9262
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("The builds this deployment ships, from build.create. Runs this deployment starts install them. A report that omits this field keeps the stored builds."),
|
|
9062
9263
|
deployTarget: httpUrl().max(2048).describe("The URL the deployment serves, e.g. a preview URL. A mobile pipeline leaves it unset and reports a service instead.").optional(),
|
|
9063
9264
|
environment: environment.describe("Selects the environment the deployment reports into.").optional(),
|
|
9064
9265
|
environmentVariables: record(string2(), string2()).describe("Environment variable overrides for the runs this deployment requests. A report that omits this field keeps the stored values. A report that sends it replaces them.").optional(),
|
|
@@ -9952,12 +10153,28 @@ var makeGetIssueContract = (ids) => {
|
|
|
9952
10153
|
};
|
|
9953
10154
|
|
|
9954
10155
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/finding.js
|
|
9955
|
-
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "
|
|
10156
|
+
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question", "dismissed" and "superseded". "superseded" means a newer run replaced this run before the investigation concluded. New values can appear.';
|
|
10157
|
+
var investigationQuestionSchema = object({
|
|
10158
|
+
answers: array(object({
|
|
10159
|
+
description: string2().optional(),
|
|
10160
|
+
title: string2(),
|
|
10161
|
+
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
10162
|
+
})),
|
|
10163
|
+
body: string2().optional().describe("Markdown details under the question: what the test expects, what the app does and what each answer changes. A value a person must copy is in a code block."),
|
|
10164
|
+
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
10165
|
+
text: string2()
|
|
10166
|
+
});
|
|
9956
10167
|
var makeInvestigationFindingSchema = (ids) => object({
|
|
9957
10168
|
actual: string2().optional(),
|
|
9958
10169
|
commitHash: string2().optional().describe("The commit of a commit fix. Same as `fix.commitHash`."),
|
|
9959
10170
|
decidedBy: _enum(["agent", "user"]).optional().describe("Who decided: the AI on its own, or a person who approved or dismissed it. Absent until someone decides."),
|
|
9960
10171
|
disputeReason: string2().optional().describe("Why a person disputed what the AI did. Present on a proposal the AI made again after that dispute."),
|
|
10172
|
+
earlierQuestions: array(object({
|
|
10173
|
+
answer: string2(),
|
|
10174
|
+
answeredAt: exports_iso.datetime(),
|
|
10175
|
+
body: string2().optional(),
|
|
10176
|
+
text: string2()
|
|
10177
|
+
})).optional().describe("Questions about this cause that a person already answered, oldest first. The AI acted on each answer."),
|
|
9961
10178
|
expected: string2().optional(),
|
|
9962
10179
|
findingId: string2(),
|
|
9963
10180
|
fix: discriminatedUnion("type", [
|
|
@@ -9984,15 +10201,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
9984
10201
|
reason: string2().describe("Why the investigation reached the verdict."),
|
|
9985
10202
|
verdict: string2().describe('Whether the pull request caused the failure. Known values: "caused", "not-caused" and "unclear". New values can appear.')
|
|
9986
10203
|
}).optional().describe("Whether the pull request the run tested caused this finding. Absent on a run that didn't test a pull request, and when the investigation didn't say."),
|
|
9987
|
-
question:
|
|
9988
|
-
answers: array(object({
|
|
9989
|
-
description: string2().optional(),
|
|
9990
|
-
title: string2(),
|
|
9991
|
-
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
9992
|
-
})),
|
|
9993
|
-
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
9994
|
-
text: string2()
|
|
9995
|
-
}).optional().describe("The question waiting for a person, with the answers offered."),
|
|
10204
|
+
question: investigationQuestionSchema.optional().describe("The question waiting for a person, with the answers offered."),
|
|
9996
10205
|
response: object({
|
|
9997
10206
|
answer: string2().optional(),
|
|
9998
10207
|
at: exports_iso.datetime(),
|
|
@@ -10004,6 +10213,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
10004
10213
|
steps: array(string2()).optional(),
|
|
10005
10214
|
subSessionIds: array(ids.chatSession),
|
|
10006
10215
|
summary: string2().optional(),
|
|
10216
|
+
supersededByRunId: ids.run.optional().describe('The newer run that replaced this run, on a "superseded" finding.'),
|
|
10007
10217
|
updatedAt: exports_iso.datetime()
|
|
10008
10218
|
});
|
|
10009
10219
|
|
|
@@ -10013,6 +10223,17 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
10013
10223
|
const output = resource({
|
|
10014
10224
|
baselineChanges: _enum(["automatic", "needs-approval"]).describe('How the investigation can make a new screenshot the baseline. "automatic": it can accept a baseline on its own. ' + '"needs-approval": it proposes the baseline on a fix-proposed finding, and accepts it only after a person applies the proposal.'),
|
|
10015
10225
|
findings: array(makeInvestigationFindingSchema(ids)),
|
|
10226
|
+
questionsFromOtherRuns: array(object({
|
|
10227
|
+
answer: string2().optional().describe(`The person's answer, when status is "answered".`),
|
|
10228
|
+
answeredAt: exports_iso.datetime().optional(),
|
|
10229
|
+
body: string2().optional(),
|
|
10230
|
+
findingId: string2(),
|
|
10231
|
+
flowIds: array(ids.flow),
|
|
10232
|
+
headline: string2().optional().describe("The cause that the question is about."),
|
|
10233
|
+
runId: ids.run,
|
|
10234
|
+
status: string2().describe('Known values: "open" (waiting for a person) and "answered". New values can appear.'),
|
|
10235
|
+
text: string2()
|
|
10236
|
+
})).optional().describe("Questions that the workspace's other run investigations asked about the same flows in the last 7 days, newest first."),
|
|
10016
10237
|
runId: ids.run,
|
|
10017
10238
|
sessionId: ids.chatSession.optional().describe("The investigation session. Absent when the run has none."),
|
|
10018
10239
|
status: _enum(["investigating", "finished", "not-investigated", "not-enabled"]).describe('Whether the lead or any child investigator is still working. "not-investigated" when the run has no investigation. ' + '"not-enabled" when automatic investigation does not cover this run, because its workspace has it off or investigates only pull request runs: read its failures with run.get and attempt.get instead.'),
|
|
@@ -10040,9 +10261,55 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
10040
10261
|
};
|
|
10041
10262
|
};
|
|
10042
10263
|
|
|
10264
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
|
|
10265
|
+
var makeFindInvestigationQuestionsContract = (ids) => {
|
|
10266
|
+
const input = object({
|
|
10267
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
10268
|
+
environmentId: ids.environmentRef.optional().describe("Only list the questions of runs in this environment. Omit to list the questions of every environment."),
|
|
10269
|
+
statuses: array(_enum(["open"])).min(1).default(["open"]).describe(`Question statuses to include. "open" (waiting for a person's answer) is the only status today.`),
|
|
10270
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list questions from. Required when authenticating with an organization or user API key.")
|
|
10271
|
+
});
|
|
10272
|
+
const output = object({
|
|
10273
|
+
nextCursor: nextCursorSchema,
|
|
10274
|
+
questions: array(resource({
|
|
10275
|
+
askedAt: exports_iso.datetime().describe("When the investigation first recorded the finding that asks the question."),
|
|
10276
|
+
findingId: string2(),
|
|
10277
|
+
flows: array(object({ flowId: ids.flow, name: string2() })).describe("The failed flows the question is about."),
|
|
10278
|
+
headline: string2().optional(),
|
|
10279
|
+
question: investigationQuestionSchema,
|
|
10280
|
+
runId: ids.run,
|
|
10281
|
+
sessionId: ids.chatSession.describe("The investigation session. Answer the question by sending the person's answer to it with agent.send."),
|
|
10282
|
+
summary: string2().optional()
|
|
10283
|
+
}, { urlFieldDescription: "The run in the QA Wolf app." })).describe("Questions that wait for a person's answer, the most recently recorded first. A page can hold fewer than limit questions, or none, while nextCursor is present.")
|
|
10284
|
+
});
|
|
10285
|
+
return {
|
|
10286
|
+
annotationJustifications: {
|
|
10287
|
+
destructiveHint: "Does not answer, dismiss or change any question.",
|
|
10288
|
+
openWorldHint: "Reads recorded QA Wolf findings without changing the application under test.",
|
|
10289
|
+
readOnlyHint: "Lists the open questions of a workspace's investigations without answering them."
|
|
10290
|
+
},
|
|
10291
|
+
annotations: {
|
|
10292
|
+
destructiveHint: false,
|
|
10293
|
+
openWorldHint: false,
|
|
10294
|
+
readOnlyHint: true
|
|
10295
|
+
},
|
|
10296
|
+
description: "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.",
|
|
10297
|
+
input,
|
|
10298
|
+
kind: "read",
|
|
10299
|
+
name: "investigation.question.find",
|
|
10300
|
+
output
|
|
10301
|
+
};
|
|
10302
|
+
};
|
|
10303
|
+
|
|
10304
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
|
|
10305
|
+
var makeInvestigationQuestionContracts = (ids) => ({
|
|
10306
|
+
find: makeFindInvestigationQuestionsContract(ids)
|
|
10307
|
+
});
|
|
10308
|
+
|
|
10043
10309
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/index.js
|
|
10044
10310
|
var makeInvestigationContracts = (ids) => ({
|
|
10045
|
-
get: makeGetInvestigationContract(ids)
|
|
10311
|
+
get: makeGetInvestigationContract(ids),
|
|
10312
|
+
question: makeInvestigationQuestionContracts(ids)
|
|
10046
10313
|
});
|
|
10047
10314
|
|
|
10048
10315
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/addFlows.js
|
|
@@ -10132,6 +10399,35 @@ var makeCreateIssueContract = (ids) => {
|
|
|
10132
10399
|
};
|
|
10133
10400
|
};
|
|
10134
10401
|
|
|
10402
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
|
|
10403
|
+
var makeDecideSuggestionContract = (ids) => {
|
|
10404
|
+
const input = object({
|
|
10405
|
+
decision: _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip before the flow joins. activate: retry a suggestion that QA Wolf held."),
|
|
10406
|
+
issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
|
|
10407
|
+
skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
|
|
10408
|
+
}).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
|
|
10409
|
+
const output = object({
|
|
10410
|
+
issue: makeIssueResourceSchema(ids)
|
|
10411
|
+
});
|
|
10412
|
+
return {
|
|
10413
|
+
annotationJustifications: {
|
|
10414
|
+
destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
|
|
10415
|
+
openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
|
|
10416
|
+
readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
|
|
10417
|
+
},
|
|
10418
|
+
annotations: {
|
|
10419
|
+
destructiveHint: false,
|
|
10420
|
+
openWorldHint: true,
|
|
10421
|
+
readOnlyHint: false
|
|
10422
|
+
},
|
|
10423
|
+
description: "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.",
|
|
10424
|
+
input,
|
|
10425
|
+
kind: "write",
|
|
10426
|
+
name: "issue.decideSuggestion",
|
|
10427
|
+
output
|
|
10428
|
+
};
|
|
10429
|
+
};
|
|
10430
|
+
|
|
10135
10431
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
|
|
10136
10432
|
var issueActivityTypeSchema = _enum([
|
|
10137
10433
|
"created",
|
|
@@ -10391,6 +10687,35 @@ var makeLegacyTriggerContracts = (ids) => ({
|
|
|
10391
10687
|
resume: makeResumeLegacyTriggerContract(ids)
|
|
10392
10688
|
});
|
|
10393
10689
|
|
|
10690
|
+
// node_modules/@qawolf/api-contracts/dist/v1/mcpServer/connect.js
|
|
10691
|
+
var makeConnectMcpServerContract = (ids) => {
|
|
10692
|
+
const input = object({
|
|
10693
|
+
server: string2().trim().min(1).describe("The server to connect, by its catalog id or name, such as linear or Linear."),
|
|
10694
|
+
workspaceId: ids.workspace.optional().describe("The workspace to connect the server to. Required when authenticating with an organization or user API key.")
|
|
10695
|
+
});
|
|
10696
|
+
const output = object({
|
|
10697
|
+
authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
|
|
10698
|
+
serverName: string2().describe("The catalog name of the server.")
|
|
10699
|
+
});
|
|
10700
|
+
return {
|
|
10701
|
+
annotationJustifications: {
|
|
10702
|
+
destructiveHint: "Starts a sign-in without changing or removing existing connections.",
|
|
10703
|
+
openWorldHint: "Asks the external server's OAuth provider for a sign-in page.",
|
|
10704
|
+
readOnlyHint: "Records a pending connection on the workspace."
|
|
10705
|
+
},
|
|
10706
|
+
annotations: {
|
|
10707
|
+
destructiveHint: false,
|
|
10708
|
+
openWorldHint: true,
|
|
10709
|
+
readOnlyHint: false
|
|
10710
|
+
},
|
|
10711
|
+
description: "Start connecting an MCP server from the workspace's catalog, such as Linear, so Tester can use its tools. Returns a sign-in link to show the user.",
|
|
10712
|
+
input,
|
|
10713
|
+
kind: "write",
|
|
10714
|
+
name: "mcpServer.connect",
|
|
10715
|
+
output
|
|
10716
|
+
};
|
|
10717
|
+
};
|
|
10718
|
+
|
|
10394
10719
|
// node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
|
|
10395
10720
|
var investigationSessionId = string2().trim().min(1).max(100).optional();
|
|
10396
10721
|
|
|
@@ -10474,6 +10799,7 @@ var makeDiagnoseRunContract = (ids) => {
|
|
|
10474
10799
|
// node_modules/@qawolf/api-contracts/dist/v1/run/find.js
|
|
10475
10800
|
var makeFindRunsContract = (ids) => {
|
|
10476
10801
|
const input = object({
|
|
10802
|
+
buildId: buildIdSchema.optional().describe("Only include runs that installed this build."),
|
|
10477
10803
|
createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include runs created after this instant, e.g. the runs since a deploy."),
|
|
10478
10804
|
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
10479
10805
|
environmentId: ids.environmentRef,
|
|
@@ -10598,6 +10924,7 @@ var makeGetRunContract = (ids) => {
|
|
|
10598
10924
|
const output = resource({
|
|
10599
10925
|
...makeRunSummaryFields(ids),
|
|
10600
10926
|
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
|
+
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
10601
10928
|
flows,
|
|
10602
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.")
|
|
10603
10930
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
@@ -11074,7 +11401,7 @@ var makeReadRunnerJournalContract = (ids) => {
|
|
|
11074
11401
|
openWorldHint: false,
|
|
11075
11402
|
readOnlyHint: false
|
|
11076
11403
|
},
|
|
11077
|
-
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. ${retryableRunnerUnreachableDescription}`,
|
|
11404
|
+
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. Polling \`runner.get\` or \`runner.list\` does not count as activity, so the inactivity clock keeps running until the runner is reaped. The journal lives only on the runner: once it is terminated or stops after inactivity, the journal is gone and this read answers not-found. ${retryableRunnerUnreachableDescription}`,
|
|
11078
11405
|
input,
|
|
11079
11406
|
kind: "read",
|
|
11080
11407
|
name: "runner.readJournal",
|
|
@@ -11224,7 +11551,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
|
|
|
11224
11551
|
openWorldHint: false,
|
|
11225
11552
|
readOnlyHint: false
|
|
11226
11553
|
},
|
|
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
|
|
11554
|
+
description: `Take one screenshot of an interactive runner's screen. This refreshes the inactivity timer and can extend the runner's billed lifetime. On a runner with a browser the image is the whole virtual desktop, browser window and all. On a mobile runner it is the device's own screen, 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}`,
|
|
11228
11555
|
input,
|
|
11229
11556
|
kind: "read",
|
|
11230
11557
|
name: "runner.takeScreenshot",
|
|
@@ -11359,6 +11686,7 @@ var makeContractsV1 = (ids) => {
|
|
|
11359
11686
|
attempt: {
|
|
11360
11687
|
get: makeGetAttemptContract(resolvedIds)
|
|
11361
11688
|
},
|
|
11689
|
+
build: makeBuildContracts(resolvedIds),
|
|
11362
11690
|
codeHostIntegration: {
|
|
11363
11691
|
find: makeFindCodeHostIntegrationsContract(resolvedIds),
|
|
11364
11692
|
listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
|
|
@@ -11396,6 +11724,7 @@ var makeContractsV1 = (ids) => {
|
|
|
11396
11724
|
issue: {
|
|
11397
11725
|
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
11398
11726
|
create: makeCreateIssueContract(resolvedIds),
|
|
11727
|
+
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
11399
11728
|
find: makeFindIssuesContract(resolvedIds),
|
|
11400
11729
|
get: makeGetIssueContract(resolvedIds),
|
|
11401
11730
|
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
@@ -11403,6 +11732,9 @@ var makeContractsV1 = (ids) => {
|
|
|
11403
11732
|
update: makeUpdateIssueContract(resolvedIds)
|
|
11404
11733
|
},
|
|
11405
11734
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
11735
|
+
mcpServer: {
|
|
11736
|
+
connect: makeConnectMcpServerContract(resolvedIds)
|
|
11737
|
+
},
|
|
11406
11738
|
promotion: makePromotionContracts(resolvedIds),
|
|
11407
11739
|
run: {
|
|
11408
11740
|
acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
|
|
@@ -16142,4 +16474,4 @@ export {
|
|
|
16142
16474
|
createRunnerSdk
|
|
16143
16475
|
};
|
|
16144
16476
|
|
|
16145
|
-
//# debugId=
|
|
16477
|
+
//# debugId=87F77F3A03400AEC64756E2164756E21
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qawolf/cli",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.4.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.104.0",
|
|
76
76
|
"@qawolf/emails": "1.1.1",
|
|
77
77
|
"@qawolf/flow-targets": "2.0.0",
|
|
78
78
|
"@qawolf/flows": "0.3.0",
|
|
@@ -142,6 +142,11 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
142
142
|
| `qawolf auth logout` | local | Remove stored credentials |
|
|
143
143
|
| `qawolf auth switch` | local | Choose which workspace to work in |
|
|
144
144
|
| `qawolf auth whoami` | read | Show authentication status |
|
|
145
|
+
| `qawolf build create` | write | Create a build from a file uploaded with build.requestUpload. Reads the app ID, name, version and build number from the file before it answers, or refuses a file that isn't an app. Calling it again with the same buildId answers the build the first call created, unchanged: a repeated call's branch, commitSha and environment are ignored. |
|
|
146
|
+
| `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. |
|
|
147
|
+
| `qawolf build get` | read | Get a build: its app, platform, version and environment. Deleted builds are returned too. |
|
|
148
|
+
| `qawolf build list` | read | List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs. |
|
|
149
|
+
| `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. |
|
|
145
150
|
| `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. |
|
|
146
151
|
| `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. |
|
|
147
152
|
| `qawolf deployment find` | read | List the deployments QA Wolf has received for the workspace, newest first. A deployment arrives through a code host integration's webhook or through deployment.reportStatus, and is what a deployment trigger evaluates against. deployment.listTriggerEvaluations reports each trigger's verdict for one deployment. |
|
|
@@ -179,8 +184,10 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
179
184
|
| `qawolf install browsers` | local | Install Playwright browsers used by the project's web flows |
|
|
180
185
|
| `qawolf install clear` | local | Remove the managed runtime cache (all installed runtime versions) |
|
|
181
186
|
| `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". |
|
|
187
|
+
| `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. |
|
|
182
188
|
| `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. |
|
|
183
189
|
| `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. |
|
|
190
|
+
| `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. |
|
|
184
191
|
| `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
|
|
185
192
|
| `qawolf issue get` | read | Get an issue by id. |
|
|
186
193
|
| `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. |
|
|
@@ -189,6 +196,7 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
189
196
|
| `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. |
|
|
190
197
|
| `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. |
|
|
191
198
|
| `qawolf legacyTrigger resume` | write | Resume one legacy trigger, the older per-environment kind; use trigger.resume for a current one. Its copies in pull request environments resume too, and a scheduled one jumps to the next upcoming slot even if it was not paused. For migration only; it goes when legacy triggers go. |
|
|
199
|
+
| `qawolf mcpServer connect` | write | Start connecting an MCP server from the workspace's catalog, such as Linear, so Tester can use its tools. Returns a sign-in link to show the user. |
|
|
192
200
|
| `qawolf promotion find` | read | List environment promotions, newest first. A promotion moves the flow changes made in a head environment into its base environment. Filter by status conflicted to find the promotions whose conflicts still need a resolution. |
|
|
193
201
|
| `qawolf promotion get` | read | Read one environment promotion: its status, the conflicting paths and commit hashes while it is conflicted or resolving, the commit it landed when promoted, and the AI task resolving it. Poll it after environment.promote to learn how the promotion settled. It does not serve file contents; a resolver reads both branches from the flow code repository. |
|
|
194
202
|
| `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. |
|
|
@@ -192,6 +192,21 @@ Every documented field of the `run.get` response. `[]` marks an array, so
|
|
|
192
192
|
- `supersededBy.runId` — The id of the run.
|
|
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
|
+
- `builds` — The builds the run installs, one per app and platform. Empty when the run has none.
|
|
196
|
+
- `builds[].appId` — The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`.
|
|
197
|
+
- `builds[].appName` — The app's display name, when the file names one.
|
|
198
|
+
- `builds[].branch` — The branch the uploader said the build came from.
|
|
199
|
+
- `builds[].buildNumber` — versionCode (Android) or CFBundleVersion (iOS), when the file has one.
|
|
200
|
+
- `builds[].commitSha` — The commit the uploader said the build came from.
|
|
201
|
+
- `builds[].createdAt` — When the build was created.
|
|
202
|
+
- `builds[].deletedAt` — When the build was deleted. Runs never install it after.
|
|
203
|
+
- `builds[].environmentId` — The environment whose runs install the build while it is the newest one there for its app and platform. Absent: only a run created with the build installs it.
|
|
204
|
+
- `builds[].fileName` — The uploaded file's name.
|
|
205
|
+
- `builds[].id` — The id of the build, from build.requestUpload.
|
|
206
|
+
- `builds[].platform` — One of: android, ios
|
|
207
|
+
- `builds[].sizeBytes` — The file's size in bytes.
|
|
208
|
+
- `builds[].version` — versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.
|
|
209
|
+
- `builds[].url` — Absolute URL of the team's Builds page.
|
|
195
210
|
- `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
|
|
196
211
|
- `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
212
|
- `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.
|