@qawolf/cli 2.13.1 → 2.14.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 +396 -54
- package/dist/runner-sdk.js +392 -51
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +12 -7
- package/skills/qawolf-cli/references/run-results.md +6 -5
package/dist/cli.js
CHANGED
|
@@ -18649,14 +18649,17 @@ var issueFileSchema = object({
|
|
|
18649
18649
|
sizeBytes: number2().int().nonnegative()
|
|
18650
18650
|
});
|
|
18651
18651
|
|
|
18652
|
+
// node_modules/@qawolf/api-contracts/dist/v1/extensibleValue.js
|
|
18653
|
+
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
18654
|
+
|
|
18652
18655
|
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
18653
|
-
var buildPlatformSchema =
|
|
18656
|
+
var buildPlatformSchema = extensibleValue(["android", "ios", "linux"], "The OS the build runs on, read from its file type. `linux` builds are Electron apps that Electron flows launch.");
|
|
18654
18657
|
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.");
|
|
18655
18658
|
var makeBuildResourceSchema = (ids) => resource({
|
|
18656
|
-
appId: string2().describe("The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
|
|
18659
|
+
appId: string2().describe("The package name (Android, Linux) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
|
|
18657
18660
|
appName: string2().optional().describe("The app's display name, when the file names one."),
|
|
18658
18661
|
branch: string2().optional().describe("The branch the uploader said the build came from."),
|
|
18659
|
-
buildNumber: string2().optional().describe("versionCode (Android)
|
|
18662
|
+
buildNumber: string2().optional().describe("versionCode (Android), CFBundleVersion (iOS) or RPM release (Linux), when the file has one."),
|
|
18660
18663
|
commitSha: string2().optional().describe("The commit the uploader said the build came from."),
|
|
18661
18664
|
createdAt: exports_iso.datetime().describe("When the build was created."),
|
|
18662
18665
|
deletedAt: exports_iso.datetime().optional().describe("When the build was deleted. Runs never install it after."),
|
|
@@ -18665,7 +18668,7 @@ var makeBuildResourceSchema = (ids) => resource({
|
|
|
18665
18668
|
id: buildIdSchema,
|
|
18666
18669
|
platform: buildPlatformSchema,
|
|
18667
18670
|
sizeBytes: number2().int().optional().describe("The file's size in bytes."),
|
|
18668
|
-
version: string2().optional().describe("versionName (Android)
|
|
18671
|
+
version: string2().optional().describe("versionName (Android), CFBundleShortVersionString (iOS) or package version (Linux), when the file has one.")
|
|
18669
18672
|
}, { urlFieldDescription: "Absolute URL of the team's Builds page." });
|
|
18670
18673
|
var makeBuildEnvironmentSelectorSchema = (ids) => union([
|
|
18671
18674
|
strictObject({
|
|
@@ -19624,18 +19627,22 @@ var triggerDayOfWeekSchema = _enum([
|
|
|
19624
19627
|
"saturday",
|
|
19625
19628
|
"sunday"
|
|
19626
19629
|
]).describe("A day of the week, named rather than numbered.");
|
|
19627
|
-
var
|
|
19628
|
-
var
|
|
19630
|
+
var actionKindDescription = "createSuite runs the flows named by flowIds and tagNames. generativeSuite lets QA Wolf choose the flows from the deployment's changes, and is not available to a schedule.";
|
|
19631
|
+
var triggerActionKindSchema = _enum(["createSuite", "generativeSuite", "startAgent"]).describe(`${actionKindDescription} startAgent starts a QA Wolf session that carries out instructions.`);
|
|
19632
|
+
var triggerConfigurationActionKindSchema = _enum(["createSuite", "generativeSuite"]).describe(actionKindDescription);
|
|
19633
|
+
var triggerActionKindField = triggerActionKindSchema.default("createSuite");
|
|
19634
|
+
var triggerConfigurationActionKindField = triggerConfigurationActionKindSchema.default("createSuite");
|
|
19635
|
+
var makeTriggerActionSchema = (ids, actionKind) => object({
|
|
19629
19636
|
flowIds: array(ids.flow).default([]).describe("Flows to run. Combined with tagNames."),
|
|
19630
|
-
instructions: string2().min(1).optional().describe("
|
|
19637
|
+
instructions: string2().min(1).optional().describe("For generativeSuite, optional guidance for QA Wolf. For startAgent, required: the task QA Wolf carries out each time the trigger fires."),
|
|
19631
19638
|
investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
|
|
19632
|
-
kind:
|
|
19639
|
+
kind: actionKind,
|
|
19633
19640
|
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.`),
|
|
19634
19641
|
suggestCoverage: boolean2().optional().describe("Whether QA Wolf explores the environment after the resulting runs and suggests coverage that nothing tests yet. Defaults to false."),
|
|
19635
19642
|
tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
|
|
19636
19643
|
}).describe("What the trigger runs when it fires.");
|
|
19637
|
-
var makeTriggerScheduleFields = (ids) => ({
|
|
19638
|
-
action: makeTriggerActionSchema(ids),
|
|
19644
|
+
var makeTriggerScheduleFields = (ids, actionKind) => ({
|
|
19645
|
+
action: makeTriggerActionSchema(ids, actionKind),
|
|
19639
19646
|
cadence: triggerCadenceSchema,
|
|
19640
19647
|
dayOfWeek: triggerDayOfWeekSchema.optional().describe("The day a weekly schedule fires on, read in timezoneId. Required when cadence is weekly."),
|
|
19641
19648
|
daysOfWeek: array(triggerDayOfWeekSchema).min(1).refine((daysOfWeek) => new Set(daysOfWeek).size === daysOfWeek.length, {
|
|
@@ -19792,7 +19799,48 @@ var checkScheduleRepeat = (value, ctx) => {
|
|
|
19792
19799
|
};
|
|
19793
19800
|
|
|
19794
19801
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
|
|
19802
|
+
var startAgentInstructionsMaxLength = 1e4;
|
|
19803
|
+
var suiteOnlyFields = [
|
|
19804
|
+
"investigateFailures",
|
|
19805
|
+
"runConcurrencyLimit",
|
|
19806
|
+
"suggestCoverage"
|
|
19807
|
+
];
|
|
19808
|
+
var checkStartAgent = (action, ctx) => {
|
|
19809
|
+
if (action.flowIds.length + action.tagNames.length > 0) {
|
|
19810
|
+
ctx.addIssue({
|
|
19811
|
+
code: "custom",
|
|
19812
|
+
message: "flowIds and tagNames do not apply when the action is startAgent.",
|
|
19813
|
+
path: ["action", "flowIds"]
|
|
19814
|
+
});
|
|
19815
|
+
}
|
|
19816
|
+
for (const field of suiteOnlyFields.filter((name) => action[name] !== undefined)) {
|
|
19817
|
+
ctx.addIssue({
|
|
19818
|
+
code: "custom",
|
|
19819
|
+
message: `${field} does not apply when the action is startAgent.`,
|
|
19820
|
+
path: ["action", field]
|
|
19821
|
+
});
|
|
19822
|
+
}
|
|
19823
|
+
if (action.instructions === undefined || !action.instructions.trim()) {
|
|
19824
|
+
ctx.addIssue({
|
|
19825
|
+
code: "custom",
|
|
19826
|
+
message: "A startAgent action needs instructions.",
|
|
19827
|
+
path: ["action", "instructions"]
|
|
19828
|
+
});
|
|
19829
|
+
return;
|
|
19830
|
+
}
|
|
19831
|
+
if (action.instructions.trim().length > startAgentInstructionsMaxLength) {
|
|
19832
|
+
ctx.addIssue({
|
|
19833
|
+
code: "custom",
|
|
19834
|
+
message: `instructions must be at most ${startAgentInstructionsMaxLength} characters.`,
|
|
19835
|
+
path: ["action", "instructions"]
|
|
19836
|
+
});
|
|
19837
|
+
}
|
|
19838
|
+
};
|
|
19795
19839
|
var checkAction = (action, ctx) => {
|
|
19840
|
+
if (action.kind === "startAgent") {
|
|
19841
|
+
checkStartAgent(action, ctx);
|
|
19842
|
+
return;
|
|
19843
|
+
}
|
|
19796
19844
|
const namesFlows = action.flowIds.length + action.tagNames.length > 0;
|
|
19797
19845
|
if (action.kind === "generativeSuite") {
|
|
19798
19846
|
if (namesFlows) {
|
|
@@ -19807,7 +19855,7 @@ var checkAction = (action, ctx) => {
|
|
|
19807
19855
|
if (action.instructions !== undefined) {
|
|
19808
19856
|
ctx.addIssue({
|
|
19809
19857
|
code: "custom",
|
|
19810
|
-
message: "instructions apply to a generativeSuite action only.",
|
|
19858
|
+
message: "instructions apply to a generativeSuite or startAgent action only.",
|
|
19811
19859
|
path: ["action", "instructions"]
|
|
19812
19860
|
});
|
|
19813
19861
|
}
|
|
@@ -19848,8 +19896,8 @@ var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? chec
|
|
|
19848
19896
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
|
|
19849
19897
|
var patternSyntax = "The pattern ignores case: * matches any text, / included; {main,hotfix} matches any one of its comma-separated options; a leading ! matches every value the rest does not; every other character, ? and [ included, matches only itself.";
|
|
19850
19898
|
var describePattern = (meaning) => `${meaning} ${patternSyntax}`;
|
|
19851
|
-
var makeTriggerDeploymentFields = (ids) => ({
|
|
19852
|
-
action: makeTriggerActionSchema(ids),
|
|
19899
|
+
var makeTriggerDeploymentFields = (ids, actionKind) => ({
|
|
19900
|
+
action: makeTriggerActionSchema(ids, actionKind),
|
|
19853
19901
|
branchPattern: string2().min(1).optional().describe(describePattern("Only fire for deployments of a branch matching this pattern.")),
|
|
19854
19902
|
deployTargetPattern: string2().min(1).optional().describe(describePattern("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry.")),
|
|
19855
19903
|
environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
|
|
@@ -19858,54 +19906,62 @@ var makeTriggerDeploymentFields = (ids) => ({
|
|
|
19858
19906
|
servicePattern: string2().min(1).optional().describe(describePattern("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it."))
|
|
19859
19907
|
});
|
|
19860
19908
|
|
|
19909
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/describedFields.js
|
|
19910
|
+
var triggerDescriptionMaxLength = 500;
|
|
19911
|
+
var triggerDescriptionSchema = string2().trim().min(1).max(triggerDescriptionMaxLength);
|
|
19912
|
+
var triggerPausedReasonSchema = _enum(["no-owner", "owner-left-team"]).describe("Why QA Wolf paused the trigger. no-owner: it runs AI and no person owns it, as when a team API key made it. owner-left-team: its owner is no longer a member. A person resumes it by taking ownership in the app.");
|
|
19913
|
+
|
|
19861
19914
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
|
|
19862
|
-
var
|
|
19915
|
+
var makeFlatConfigurationArms = (ids, actionKind) => [
|
|
19863
19916
|
object({
|
|
19864
|
-
...makeTriggerScheduleFields({
|
|
19865
|
-
environmentId: ids.environment,
|
|
19866
|
-
flow: ids.flow
|
|
19867
|
-
}),
|
|
19917
|
+
...makeTriggerScheduleFields({ environmentId: ids.environment, flow: ids.flow }, actionKind),
|
|
19868
19918
|
kind: literal("schedule")
|
|
19869
19919
|
}),
|
|
19870
19920
|
object({
|
|
19871
|
-
...makeTriggerDeploymentFields(ids),
|
|
19921
|
+
...makeTriggerDeploymentFields(ids, actionKind),
|
|
19872
19922
|
kind: literal("deployment")
|
|
19873
|
-
})
|
|
19923
|
+
})
|
|
19924
|
+
];
|
|
19925
|
+
var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
|
|
19926
|
+
...makeFlatConfigurationArms(ids, triggerConfigurationActionKindField),
|
|
19874
19927
|
object({
|
|
19875
19928
|
actionCount: number2().int().describe("How many actions it runs."),
|
|
19876
19929
|
kind: literal("advanced"),
|
|
19877
19930
|
whenCount: number2().int().describe("How many separate match conditions it has.")
|
|
19878
19931
|
})
|
|
19879
19932
|
]);
|
|
19933
|
+
var makeTriggerDefinitionSchema = (ids) => discriminatedUnion("kind", makeFlatConfigurationArms(ids, triggerActionKindField)).optional().catch(undefined).describe("The trigger's full configuration, which trigger.update accepts back. Absent for an advanced trigger, and for a kind this client does not know.");
|
|
19880
19934
|
var makeTriggerResourceSchema = (ids) => resource({
|
|
19881
19935
|
configuration: makeTriggerConfigurationSchema(ids),
|
|
19882
19936
|
createdAt: exports_iso.datetime(),
|
|
19937
|
+
definition: makeTriggerDefinitionSchema(ids),
|
|
19938
|
+
description: string2().optional().describe("What the trigger is for, in the team's words."),
|
|
19883
19939
|
id: ids.trigger,
|
|
19884
19940
|
isPaused: boolean2().describe("A paused trigger never fires, on any path."),
|
|
19885
19941
|
name: string2(),
|
|
19886
19942
|
nextScheduledAt: exports_iso.datetime().optional().describe("When a schedule trigger next fires. Absent for a deployment trigger, and while a schedule trigger is paused."),
|
|
19887
19943
|
pausedAt: exports_iso.datetime().optional().describe("When it was paused."),
|
|
19944
|
+
pausedReason: triggerPausedReasonSchema.optional().catch(undefined),
|
|
19888
19945
|
updatedAt: exports_iso.datetime()
|
|
19889
19946
|
}, { urlFieldDescription: "Absolute URL of the team's triggers page." });
|
|
19890
19947
|
|
|
19891
19948
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/create.js
|
|
19892
19949
|
var makeCreateTriggerContract = (ids) => {
|
|
19893
19950
|
const commonFields = {
|
|
19951
|
+
description: triggerDescriptionSchema.optional().describe("What the trigger is for, in the team's words."),
|
|
19952
|
+
isPaused: boolean2().optional().describe("Create the trigger paused, so it never fires until trigger.resume. Defaults to false."),
|
|
19894
19953
|
name: string2().trim().min(1).max(255),
|
|
19895
19954
|
workspaceId: ids.workspace.optional().describe("The workspace to create the trigger in. Required when authenticating with an organization or user API key.")
|
|
19896
19955
|
};
|
|
19897
19956
|
const input = discriminatedUnion("kind", [
|
|
19898
19957
|
object({
|
|
19899
19958
|
...commonFields,
|
|
19900
|
-
...makeTriggerScheduleFields({
|
|
19901
|
-
environmentId: ids.environmentRef,
|
|
19902
|
-
flow: ids.flow
|
|
19903
|
-
}),
|
|
19959
|
+
...makeTriggerScheduleFields({ environmentId: ids.environmentRef, flow: ids.flow }, triggerActionKindField),
|
|
19904
19960
|
kind: literal("schedule")
|
|
19905
19961
|
}),
|
|
19906
19962
|
object({
|
|
19907
19963
|
...commonFields,
|
|
19908
|
-
...makeTriggerDeploymentFields(ids),
|
|
19964
|
+
...makeTriggerDeploymentFields(ids, triggerActionKindField),
|
|
19909
19965
|
kind: literal("deployment")
|
|
19910
19966
|
})
|
|
19911
19967
|
]).superRefine(checkTriggerConfiguration);
|
|
@@ -19921,7 +19977,7 @@ var makeCreateTriggerContract = (ids) => {
|
|
|
19921
19977
|
openWorldHint: true,
|
|
19922
19978
|
readOnlyHint: false
|
|
19923
19979
|
},
|
|
19924
|
-
description: "Create a trigger. A schedule trigger
|
|
19980
|
+
description: "Create a trigger. A schedule trigger fires on a cadence; " + "a deployment trigger fires when a matching deployment is reported. Its action runs " + "flows, or, as startAgent, starts a QA Wolf session that carries out its instructions. " + "A startAgent trigger made with a team API key has no owner, so it stays paused until " + "a person takes ownership of it in the app.",
|
|
19925
19981
|
input,
|
|
19926
19982
|
kind: "write",
|
|
19927
19983
|
name: "trigger.create",
|
|
@@ -20050,21 +20106,20 @@ var makeDeleteTriggerContract = (ids) => {
|
|
|
20050
20106
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/update.js
|
|
20051
20107
|
var makeUpdateTriggerContract = (ids) => {
|
|
20052
20108
|
const commonFields = {
|
|
20109
|
+
description: triggerDescriptionSchema.optional().describe("What the trigger is for, in the team's words. Omit it to keep the current description."),
|
|
20110
|
+
isPaused: boolean2().optional().describe("Pause or resume the trigger once the configuration is written. Omit it to leave the trigger as it is. To keep a running trigger from firing on the new configuration, pause it with trigger.pause first."),
|
|
20053
20111
|
name: string2().trim().min(1).max(255),
|
|
20054
20112
|
triggerId: ids.trigger
|
|
20055
20113
|
};
|
|
20056
20114
|
const input = discriminatedUnion("kind", [
|
|
20057
20115
|
object({
|
|
20058
20116
|
...commonFields,
|
|
20059
|
-
...makeTriggerScheduleFields({
|
|
20060
|
-
environmentId: ids.environmentRef,
|
|
20061
|
-
flow: ids.flow
|
|
20062
|
-
}),
|
|
20117
|
+
...makeTriggerScheduleFields({ environmentId: ids.environmentRef, flow: ids.flow }, triggerActionKindField),
|
|
20063
20118
|
kind: literal("schedule")
|
|
20064
20119
|
}),
|
|
20065
20120
|
object({
|
|
20066
20121
|
...commonFields,
|
|
20067
|
-
...makeTriggerDeploymentFields(ids),
|
|
20122
|
+
...makeTriggerDeploymentFields(ids, triggerActionKindField),
|
|
20068
20123
|
kind: literal("deployment")
|
|
20069
20124
|
})
|
|
20070
20125
|
]).superRefine(checkTriggerConfiguration);
|
|
@@ -20080,7 +20135,7 @@ var makeUpdateTriggerContract = (ids) => {
|
|
|
20080
20135
|
openWorldHint: true,
|
|
20081
20136
|
readOnlyHint: false
|
|
20082
20137
|
},
|
|
20083
|
-
description: "Replace a trigger's configuration. Every field is written, so read the
|
|
20138
|
+
description: "Replace a trigger's configuration. " + "Every configuration field is written, so read the trigger first and send its " + "definition back with your changes applied. isPaused and description are kept " + "when omitted.",
|
|
20084
20139
|
input,
|
|
20085
20140
|
kind: "write",
|
|
20086
20141
|
name: "trigger.update",
|
|
@@ -20221,6 +20276,7 @@ var makeGetAttemptContract = (ids) => {
|
|
|
20221
20276
|
const failuresTruncated = boolean2().optional().describe("True when the attempt reached the 100-failure limit, so failures may leave some out. Present whenever failures is.");
|
|
20222
20277
|
const artifactUrls = {
|
|
20223
20278
|
logsUrl: url().optional(),
|
|
20279
|
+
networkLogsUrl: url().optional().describe("Signed URL for the attempt's iOS network log, as NDJSON: request and connection lines are HAR 1.2 entries, DNS and WebSocket lines are `_qawolf` objects, and the last line is a summary. For up to 2 minutes after the attempt ends, the file can be partial or 404 while the runner uploads it; it is final once the summary line is there. Signed for every attempt; after that, a 404 means the attempt captured no network."),
|
|
20224
20280
|
traceUrl: url().optional(),
|
|
20225
20281
|
videoUrl: url().optional()
|
|
20226
20282
|
};
|
|
@@ -20329,7 +20385,7 @@ var makeDeleteBuildContract = (ids) => {
|
|
|
20329
20385
|
openWorldHint: false,
|
|
20330
20386
|
readOnlyHint: false
|
|
20331
20387
|
},
|
|
20332
|
-
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
|
|
20388
|
+
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. On QA Wolf's cloud, the latest builds of static environments are always kept. Otherwise the newest 50 builds of each app and platform in an environment, and the newest 100 with no environment, are kept up to 180 days after upload; older ones are deleted 7 days after they fall out. The builds of a terminated preview environment are deleted 7 days after it terminates. Answers the build with deletedAt set. Deleting a deleted build answers it unchanged.",
|
|
20333
20389
|
input,
|
|
20334
20390
|
kind: "write",
|
|
20335
20391
|
name: "build.delete",
|
|
@@ -20432,7 +20488,7 @@ var makeRequestBuildDownloadContract = (ids) => {
|
|
|
20432
20488
|
var makeRequestBuildUploadContract = (ids) => {
|
|
20433
20489
|
const input = object({
|
|
20434
20490
|
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."),
|
|
20435
|
-
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 .
|
|
20491
|
+
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|deb|rpm)$/i.test(fileName), "A build is an .apk, .aab, .ipa, .deb or .rpm file.").describe("The file's name, such as `app-release.apk`, `app-release.aab`, `App.ipa` or `my-app_1.0.0_amd64.deb`. Its extension sets the platform."),
|
|
20436
20492
|
fileSizeBytes: number2().int().min(1).describe("The file's exact size in bytes, at most the workspace's limit, 1 GB by default. The URL accepts only a file of this size."),
|
|
20437
20493
|
workspaceId: ids.workspace.optional().describe("The workspace to upload into. Required when authenticating with an organization or user API key.")
|
|
20438
20494
|
});
|
|
@@ -20453,7 +20509,7 @@ var makeRequestBuildUploadContract = (ids) => {
|
|
|
20453
20509
|
openWorldHint: false,
|
|
20454
20510
|
readOnlyHint: false
|
|
20455
20511
|
},
|
|
20456
|
-
description: "Get a URL to upload an app build: an .apk, .aab or .
|
|
20512
|
+
description: "Get a URL to upload an app build: an .apk, .aab, .ipa, or a Linux Electron app as a .deb or .rpm, up to 1 GB by default. PUT the file there with uploadHeaders, then call build.create with the buildId.",
|
|
20457
20513
|
input,
|
|
20458
20514
|
kind: "write",
|
|
20459
20515
|
name: "build.requestUpload",
|
|
@@ -20514,6 +20570,66 @@ var makeFindCodeHostIntegrationsContract = (ids) => {
|
|
|
20514
20570
|
};
|
|
20515
20571
|
};
|
|
20516
20572
|
|
|
20573
|
+
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/findForRepository.js
|
|
20574
|
+
var scpLikeUser = /^([^@/]+)@[^@/:]+:(?!\/\/)/;
|
|
20575
|
+
function carriesCredentials(url2) {
|
|
20576
|
+
const trimmed = url2.trim();
|
|
20577
|
+
if (URL.canParse(trimmed)) {
|
|
20578
|
+
const { password, username } = new URL(trimmed);
|
|
20579
|
+
return password !== "" || username !== "" && username !== "git";
|
|
20580
|
+
}
|
|
20581
|
+
const user = scpLikeUser.exec(trimmed)?.[1];
|
|
20582
|
+
return user !== undefined && user !== "git";
|
|
20583
|
+
}
|
|
20584
|
+
var settingsUrl = url().describe("Absolute URL of the workspace's integrations settings page.");
|
|
20585
|
+
var makeFindCodeHostIntegrationForRepositoryContract = (ids) => {
|
|
20586
|
+
const input = object({
|
|
20587
|
+
url: string2().min(1).max(2048).refine((url2) => !carriesCredentials(url2), {
|
|
20588
|
+
message: "The URL carries credentials, and it is sent in the request address. Remove the credentials, such as a token before the host, and send the URL again."
|
|
20589
|
+
}).describe(`The repository's URL, as a CI job or a git remote names it: "https://github.com/acme/storefront", "ssh://git@github.com/acme/storefront.git" or "git@gitlab.com:acme/web/storefront.git". The URL is sent in the request address, so it must carry no credentials: QA Wolf refuses one with a user other than "git" or a password. QA Wolf does not fetch or store the URL.`),
|
|
20590
|
+
workspaceId: ids.workspace.optional().describe("The workspace to check. Required when authenticating with an organization or user API key.")
|
|
20591
|
+
});
|
|
20592
|
+
const output = discriminatedUnion("coverage", [
|
|
20593
|
+
object({
|
|
20594
|
+
coverage: literal("covered").describe("A code host integration of the workspace covers the repository."),
|
|
20595
|
+
fullName: string2().describe(`The repository's full name as QA Wolf knows it, such as "acme/storefront". Report deployments of this repository with this exact name.`),
|
|
20596
|
+
permissions: object({
|
|
20597
|
+
code: _enum(["no-access", "read", "write"]).describe(`Access to the repository's code and commits. The QA Wolf Code GitHub app has "write" once QA Wolf turns on code access for the workspace, and "no-access" until then. With "no-access", QA Wolf only knows about changes pushed straight to a branch when a deployment report includes them.`),
|
|
20598
|
+
pullRequests: _enum(["read", "write"]).describe("Access to the repository's pull requests.")
|
|
20599
|
+
}).describe("What the covering integration lets QA Wolf do in the repository."),
|
|
20600
|
+
provider: _enum(["github", "gitlab"]).describe("The code host the covering integration connects."),
|
|
20601
|
+
settingsUrl
|
|
20602
|
+
}),
|
|
20603
|
+
object({
|
|
20604
|
+
coverage: literal("not-covered").describe("No code host integration of the workspace covers the repository, or the integration is suspended. QA Wolf only knows the changes a deployment report includes."),
|
|
20605
|
+
settingsUrl
|
|
20606
|
+
}),
|
|
20607
|
+
object({
|
|
20608
|
+
coverage: literal("unsupported-host").describe("The URL names a code host QA Wolf does not connect to. QA Wolf connects to github.com and gitlab.com.")
|
|
20609
|
+
}),
|
|
20610
|
+
object({
|
|
20611
|
+
coverage: literal("unrecognized-url").describe("The URL is not a repository URL QA Wolf recognizes.")
|
|
20612
|
+
})
|
|
20613
|
+
]);
|
|
20614
|
+
return {
|
|
20615
|
+
annotationJustifications: {
|
|
20616
|
+
destructiveHint: "Does not connect, disconnect or change code host integrations.",
|
|
20617
|
+
openWorldHint: "Answers from QA Wolf integration records without contacting the URL, GitHub or GitLab.",
|
|
20618
|
+
readOnlyHint: "Looks the repository up in the workspace's integrations and stores nothing."
|
|
20619
|
+
},
|
|
20620
|
+
annotations: {
|
|
20621
|
+
destructiveHint: false,
|
|
20622
|
+
openWorldHint: false,
|
|
20623
|
+
readOnlyHint: true
|
|
20624
|
+
},
|
|
20625
|
+
description: "Check whether QA Wolf can read a repository through the workspace's code host integrations, and what it can access: the repository's code and its pull requests. A CI job calls this before reporting a deployment to decide which changes to include. Not covered means QA Wolf only knows the changes the report includes; settingsUrl is where a workspace admin connects the code host.",
|
|
20626
|
+
input,
|
|
20627
|
+
kind: "read",
|
|
20628
|
+
name: "codeHostIntegration.findForRepository",
|
|
20629
|
+
output
|
|
20630
|
+
};
|
|
20631
|
+
};
|
|
20632
|
+
|
|
20517
20633
|
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/listRepositories.js
|
|
20518
20634
|
var makeListCodeHostRepositoriesContract = (ids) => {
|
|
20519
20635
|
const input = object({
|
|
@@ -20544,6 +20660,13 @@ var makeListCodeHostRepositoriesContract = (ids) => {
|
|
|
20544
20660
|
};
|
|
20545
20661
|
};
|
|
20546
20662
|
|
|
20663
|
+
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/index.js
|
|
20664
|
+
var makeCodeHostIntegrationContracts = (ids) => ({
|
|
20665
|
+
find: makeFindCodeHostIntegrationsContract(ids),
|
|
20666
|
+
findForRepository: makeFindCodeHostIntegrationForRepositoryContract(ids),
|
|
20667
|
+
listRepositories: makeListCodeHostRepositoriesContract(ids)
|
|
20668
|
+
});
|
|
20669
|
+
|
|
20547
20670
|
// node_modules/@qawolf/api-contracts/dist/v1/deployment/resource.js
|
|
20548
20671
|
var makeDeploymentResourceSchema = (ids) => resource({
|
|
20549
20672
|
branch: string2().optional().describe("The git branch the deployed commit is on. Absent when neither the deployer nor the code host declared one."),
|
|
@@ -20675,16 +20798,44 @@ var makeListDeploymentTriggerEvaluationsContract = (ids) => {
|
|
|
20675
20798
|
// node_modules/@qawolf/api-contracts/dist/v1/deployment/reportStatusChanges.js
|
|
20676
20799
|
var maxChangesBytes = 256 * 1024;
|
|
20677
20800
|
var text = (max) => string2().trim().min(1).max(max);
|
|
20678
|
-
var
|
|
20801
|
+
var sha = (description) => string2().regex(/^[0-9a-f]{7,64}$/iu).describe(description).optional();
|
|
20802
|
+
var number4 = (description) => number2().int().positive().describe(description).optional();
|
|
20803
|
+
var sharedFields = {
|
|
20679
20804
|
changedPaths: array(text(1024)).max(1000).describe("Paths of the files this change touched, without their contents.").optional(),
|
|
20680
20805
|
description: text(4000).describe("The pull request description or the commit message body. Ticket ids and titles belong here or in the title.").optional(),
|
|
20681
|
-
kind: _enum(["pull-request", "commit"]).describe("pull-request for a merged pull request, commit for a commit pushed without one."),
|
|
20682
20806
|
title: text(512).describe('The pull request title or the commit subject, e.g. "Recalculate the cart total with discounts".'),
|
|
20683
20807
|
url: httpUrl().max(2048).describe("A link to the pull request or commit.").optional()
|
|
20684
|
-
}
|
|
20808
|
+
};
|
|
20809
|
+
var changeItem = discriminatedUnion("kind", [
|
|
20810
|
+
strictObject({
|
|
20811
|
+
...sharedFields,
|
|
20812
|
+
kind: literal("pull-request").describe("A merged pull or merge request."),
|
|
20813
|
+
mergeCommitSha: sha("The sha of the commit the pull request landed as: its merge, squash or last rebased commit, at least 7 characters. Lets QA Wolf list a pull request it also reads from your code host only once."),
|
|
20814
|
+
number: number4("The pull or merge request number. Lets QA Wolf list a pull request it also reads from your code host only once.")
|
|
20815
|
+
}),
|
|
20816
|
+
strictObject({
|
|
20817
|
+
...sharedFields,
|
|
20818
|
+
kind: literal("commit").describe("A commit, such as one pushed without a pull request."),
|
|
20819
|
+
pullRequestNumber: number4('The number of the pull or merge request the commit came in through, e.g. 12 for "Fix the total (#12)".'),
|
|
20820
|
+
sha: sha("The commit sha, at least 7 characters. Lets QA Wolf list a commit it also reads from your code host only once.")
|
|
20821
|
+
})
|
|
20822
|
+
]);
|
|
20823
|
+
var collectionProblem = discriminatedUnion("kind", [
|
|
20824
|
+
strictObject({
|
|
20825
|
+
kind: literal("filter-failed").describe("The filter that edits the changes before they're sent failed, so the changes it would have sent are missing.")
|
|
20826
|
+
}),
|
|
20827
|
+
strictObject({
|
|
20828
|
+
kind: literal("history-unavailable").describe("The CI checkout's git history was too shallow to hold every change since the previous deploy, so changes are missing.")
|
|
20829
|
+
}),
|
|
20830
|
+
strictObject({
|
|
20831
|
+
kind: literal("since-not-found").describe("The commit or tag the changes are collected since isn't in the CI checkout, so the changes couldn't be read.")
|
|
20832
|
+
})
|
|
20833
|
+
]);
|
|
20685
20834
|
var deploymentReportChanges = strictObject({
|
|
20835
|
+
ci: text(64).describe('The CI system that collected the changes, e.g. "GitHub Actions". QA Wolf names it when it tells you collecting them went wrong.').optional(),
|
|
20686
20836
|
items: array(changeItem).max(250).describe("The pull requests and commits the deployment ships, newest first.").optional(),
|
|
20687
20837
|
omittedCount: number2().int().nonnegative().describe("How many pull requests or commits you left out of items to stay within the limits.").optional(),
|
|
20838
|
+
problems: array(collectionProblem).max(10).describe("What went wrong collecting the changes, so QA Wolf can tell you in the Inbox and work with what it has. Send items too when only some changes are missing. Empty or absent means collecting them went fine.").optional(),
|
|
20688
20839
|
releaseNotes: text(16000).describe("Release notes written for the deployment.").optional()
|
|
20689
20840
|
}).refine((value) => new TextEncoder().encode(JSON.stringify(value)).length <= maxChangesBytes, { message: "changes must be at most 256 KB." });
|
|
20690
20841
|
|
|
@@ -20724,7 +20875,7 @@ var makeReportDeploymentStatusContract = (ids) => {
|
|
|
20724
20875
|
});
|
|
20725
20876
|
const input = strictObject({
|
|
20726
20877
|
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."),
|
|
20727
|
-
changes: deploymentReportChanges.describe("What the deployment changed, as text a reader can act on, which lets a trigger where QA Wolf chooses the flows work without a pull request: each merged pull request or pushed commit with its title, description and changed file paths, plus release notes. Code is never accepted: there is no field for diffs or file contents, and unknown keys are refused. A report that omits this field keeps the stored summary, a report that sends it replaces it, and one with no items
|
|
20878
|
+
changes: deploymentReportChanges.describe("What the deployment changed, as text a reader can act on, which lets a trigger where QA Wolf chooses the flows work without a pull request: each merged pull request or pushed commit with its title, description and changed file paths, plus release notes. Code is never accepted: there is no field for diffs or file contents, and unknown keys are refused. A report that omits this field keeps the stored summary, a report that sends it replaces it, and one with no items, no release notes and no problems counts as not sent. Triggers are evaluated on the first success report, so send it on that report or earlier. In the QA Wolf CLI, pass it as one JSON value.").optional(),
|
|
20728
20879
|
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(),
|
|
20729
20880
|
environment: environment.describe("Selects the environment the deployment reports into.").optional(),
|
|
20730
20881
|
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(),
|
|
@@ -21685,6 +21836,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
21685
21836
|
text: string2().optional().describe("A person's answer in their own words, when they typed one."),
|
|
21686
21837
|
type: string2().describe('Known values: "answer", "dispute" and "reply". New values can appear.')
|
|
21687
21838
|
}).optional().describe("A person's answer or dispute that the investigation hasn't acted on yet."),
|
|
21839
|
+
revalidationSkippedAttemptId: string2().optional().describe("The failed attempt whose linked bug revalidation could not finish because the runner was unavailable."),
|
|
21688
21840
|
state: string2().describe(investigationFindingStateDescription),
|
|
21689
21841
|
steps: array(string2()).optional(),
|
|
21690
21842
|
subSessionIds: array(ids.chatSession),
|
|
@@ -21701,8 +21853,18 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
21701
21853
|
completion: object({
|
|
21702
21854
|
remainingFlows: array(object({
|
|
21703
21855
|
flowId: ids.flow,
|
|
21704
|
-
reason: string2()
|
|
21856
|
+
reason: string2(),
|
|
21857
|
+
runAttemptId: string2().optional()
|
|
21705
21858
|
})),
|
|
21859
|
+
transferredFlows: array(object({
|
|
21860
|
+
flowId: ids.flow,
|
|
21861
|
+
runId: ids.run,
|
|
21862
|
+
status: _enum([
|
|
21863
|
+
"checkpoint-pending",
|
|
21864
|
+
"checkpoint-saved",
|
|
21865
|
+
"source-unavailable"
|
|
21866
|
+
])
|
|
21867
|
+
})).optional(),
|
|
21706
21868
|
waitingFlowIds: array(ids.flow)
|
|
21707
21869
|
}).optional().describe("Current per-flow completion check. Continue every remaining flow before ending. Questions cover only waitingFlowIds. Missing completion means coverage cannot be verified."),
|
|
21708
21870
|
findings: array(makeInvestigationFindingSchema(ids)),
|
|
@@ -22095,6 +22257,35 @@ var makeListIssueCommentsContract = (ids) => {
|
|
|
22095
22257
|
};
|
|
22096
22258
|
};
|
|
22097
22259
|
|
|
22260
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/markFixReadyForReview.js
|
|
22261
|
+
var makeMarkFixReadyForReviewContract = (ids) => {
|
|
22262
|
+
const input = object({ issueId: ids.issue });
|
|
22263
|
+
const output = object({
|
|
22264
|
+
fix: object({
|
|
22265
|
+
id: string2().describe("The fix's ID."),
|
|
22266
|
+
pullRequestUrl: url().describe("The fix's pull request, which is now ready for review.")
|
|
22267
|
+
}),
|
|
22268
|
+
outcome: _enum(["marked-ready", "already-ready"]).describe("marked-ready: this call marked the draft pull request ready for review. already-ready: the pull request was already ready for review.")
|
|
22269
|
+
});
|
|
22270
|
+
return {
|
|
22271
|
+
annotationJustifications: {
|
|
22272
|
+
destructiveHint: "Marks a draft pull request ready for review and never removes or overwrites data.",
|
|
22273
|
+
openWorldHint: "Changes a pull request in the team's own repository on its code host.",
|
|
22274
|
+
readOnlyHint: "Changes the draft state of the fix's pull request."
|
|
22275
|
+
},
|
|
22276
|
+
annotations: {
|
|
22277
|
+
destructiveHint: false,
|
|
22278
|
+
openWorldHint: true,
|
|
22279
|
+
readOnlyHint: false
|
|
22280
|
+
},
|
|
22281
|
+
description: "Mark the draft pull request of the bug's fix ready for review, so the code host asks its code owners. " + "The pull request stays a draft unless a loop's instructions ask for this. " + "Only a QA Wolf session that a loop started can call it. " + "Refused as no-fix-pull-request when the bug's fix has no open pull request.",
|
|
22282
|
+
input,
|
|
22283
|
+
kind: "write",
|
|
22284
|
+
name: "issue.markFixReadyForReview",
|
|
22285
|
+
output
|
|
22286
|
+
};
|
|
22287
|
+
};
|
|
22288
|
+
|
|
22098
22289
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
|
|
22099
22290
|
var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
22100
22291
|
const input = object({
|
|
@@ -22124,6 +22315,76 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
|
22124
22315
|
};
|
|
22125
22316
|
};
|
|
22126
22317
|
|
|
22318
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/requestFix.js
|
|
22319
|
+
var codeFixStates = [
|
|
22320
|
+
"sent",
|
|
22321
|
+
"fixing",
|
|
22322
|
+
"pull-request-open",
|
|
22323
|
+
"no-fix",
|
|
22324
|
+
"failed"
|
|
22325
|
+
];
|
|
22326
|
+
var makeRequestFixForIssueContract = (ids) => {
|
|
22327
|
+
const input = object({
|
|
22328
|
+
issueId: ids.issue,
|
|
22329
|
+
repository: string2().regex(/^[\w.-]+\/[\w.-]+$/, "repository must be owner/name").optional().describe("The repository, as owner/name, that the loop's instructions name. Omit it to let QA Wolf pick the bug's repository.")
|
|
22330
|
+
});
|
|
22331
|
+
const output = object({
|
|
22332
|
+
fix: object({
|
|
22333
|
+
id: string2().describe("The fix's ID."),
|
|
22334
|
+
repository: string2().describe("The repository, as owner/name, whose coding agent fixes the bug."),
|
|
22335
|
+
state: _enum(codeFixStates).describe("sent: QA Wolf started the team's workflow. fixing: the coding agent started. pull-request-open: the fix has a pull request. no-fix and failed: the fix ended.")
|
|
22336
|
+
}),
|
|
22337
|
+
outcome: _enum(["requested", "joined-open-fix"]).describe("requested: this call started a new fix. joined-open-fix: the bug already had an open fix, and this is it.")
|
|
22338
|
+
});
|
|
22339
|
+
return {
|
|
22340
|
+
annotationJustifications: {
|
|
22341
|
+
destructiveHint: "Starts a fix and never removes or overwrites data.",
|
|
22342
|
+
openWorldHint: "Starts a workflow in the team's own repository on its code host.",
|
|
22343
|
+
readOnlyHint: "Records a fix and starts the team's coding agent."
|
|
22344
|
+
},
|
|
22345
|
+
annotations: {
|
|
22346
|
+
destructiveHint: false,
|
|
22347
|
+
openWorldHint: true,
|
|
22348
|
+
readOnlyHint: false
|
|
22349
|
+
},
|
|
22350
|
+
description: "Hand a bug report to the team's own coding agent, which fixes it in the team's CI. " + "Only a QA Wolf session that a loop started can call it, when the loop's instructions use /coding-agent. " + "A bug has one open fix: a second request returns that fix.",
|
|
22351
|
+
input,
|
|
22352
|
+
kind: "write",
|
|
22353
|
+
name: "issue.requestFix",
|
|
22354
|
+
output
|
|
22355
|
+
};
|
|
22356
|
+
};
|
|
22357
|
+
|
|
22358
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/retryFix.js
|
|
22359
|
+
var makeRetryFixForIssueContract = (ids) => {
|
|
22360
|
+
const input = object({ issueId: ids.issue });
|
|
22361
|
+
const output = object({
|
|
22362
|
+
fix: object({
|
|
22363
|
+
id: string2().describe("The ID of the fix that makes the extra try."),
|
|
22364
|
+
repository: string2().describe("The repository, as owner/name, whose coding agent fixes the bug."),
|
|
22365
|
+
state: _enum(codeFixStates).describe("sent: QA Wolf started the team's workflow. fixing: the coding agent started. pull-request-open: the fix has a pull request. no-fix and failed: the fix ended.")
|
|
22366
|
+
}),
|
|
22367
|
+
outcome: _enum(["requested", "joined-open-fix"]).describe("requested: this call started the extra try. joined-open-fix: the extra try was already open, and this is it.")
|
|
22368
|
+
});
|
|
22369
|
+
return {
|
|
22370
|
+
annotationJustifications: {
|
|
22371
|
+
destructiveHint: "Starts a fix and never removes or overwrites data.",
|
|
22372
|
+
openWorldHint: "Starts a workflow in the team's own repository on its code host.",
|
|
22373
|
+
readOnlyHint: "Records a fix and starts the team's coding agent."
|
|
22374
|
+
},
|
|
22375
|
+
annotations: {
|
|
22376
|
+
destructiveHint: false,
|
|
22377
|
+
openWorldHint: true,
|
|
22378
|
+
readOnlyHint: false
|
|
22379
|
+
},
|
|
22380
|
+
description: "Ask the team's coding agent for one more try at a bug that the check of its fix still shows. " + "QA Wolf sends the same agent the failure of the check's run, as a new fix on the same branch, and checks again. " + "Only a QA Wolf session that a loop started can call it, when the loop's instructions ask for it. " + "A bug gets one extra try at most. " + "Refused as bug-not-still-showing when the check of the bug's fix does not show the bug, and as no-tries-left after the extra try.",
|
|
22381
|
+
input,
|
|
22382
|
+
kind: "write",
|
|
22383
|
+
name: "issue.retryFix",
|
|
22384
|
+
output
|
|
22385
|
+
};
|
|
22386
|
+
};
|
|
22387
|
+
|
|
22127
22388
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/update.js
|
|
22128
22389
|
var makeUpdateIssueContract = (ids) => {
|
|
22129
22390
|
const descriptionSchema = string2().describe(issueDescriptionDescription);
|
|
@@ -22169,7 +22430,10 @@ var makeIssueContracts = (ids) => ({
|
|
|
22169
22430
|
get: makeGetIssueContract(ids),
|
|
22170
22431
|
listActivity: makeListIssueActivityContract(ids),
|
|
22171
22432
|
listComments: makeListIssueCommentsContract(ids),
|
|
22433
|
+
markFixReadyForReview: makeMarkFixReadyForReviewContract(ids),
|
|
22172
22434
|
removeFlows: makeRemoveFlowsFromIssueContract(ids),
|
|
22435
|
+
requestFix: makeRequestFixForIssueContract(ids),
|
|
22436
|
+
retryFix: makeRetryFixForIssueContract(ids),
|
|
22173
22437
|
update: makeUpdateIssueContract(ids)
|
|
22174
22438
|
});
|
|
22175
22439
|
|
|
@@ -22519,6 +22783,7 @@ var runAlertNotificationsSchema = array(runAlertNotificationSchema).describe("Wh
|
|
|
22519
22783
|
var makeFlowAttemptsSchema = (ids) => {
|
|
22520
22784
|
const artifactUrls = {
|
|
22521
22785
|
logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
|
|
22786
|
+
networkLogsUrl: url().optional().describe("Signed URL for the attempt's iOS network log, as NDJSON: request and connection lines are HAR 1.2 entries, DNS and WebSocket lines are `_qawolf` objects, and the last line is a summary. For up to 2 minutes after the attempt ends, the file can be partial or 404 while the runner uploads it; it is final once the summary line is there. Signed for every attempt; after that, a 404 means the attempt captured no network."),
|
|
22522
22787
|
traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
|
|
22523
22788
|
videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
|
|
22524
22789
|
};
|
|
@@ -22588,7 +22853,6 @@ var makeFlowFailureSchema = (ids) => {
|
|
|
22588
22853
|
};
|
|
22589
22854
|
|
|
22590
22855
|
// node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
|
|
22591
|
-
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
22592
22856
|
var attemptCount = number2().int().positive().describe("How many attempts reported it.");
|
|
22593
22857
|
var runBuildVersionSchema = object({
|
|
22594
22858
|
appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
|
|
@@ -23520,6 +23784,88 @@ var makeListTagsContract = (ids) => {
|
|
|
23520
23784
|
};
|
|
23521
23785
|
};
|
|
23522
23786
|
|
|
23787
|
+
// node_modules/@qawolf/api-contracts/dist/v1/tag/contracts.js
|
|
23788
|
+
var makeTagContracts = (ids) => ({
|
|
23789
|
+
create: makeCreateTagContract(ids),
|
|
23790
|
+
list: makeListTagsContract(ids)
|
|
23791
|
+
});
|
|
23792
|
+
|
|
23793
|
+
// node_modules/@qawolf/api-contracts/dist/v1/usage/breakdown.js
|
|
23794
|
+
var maxUsageBreakdownDays = 366;
|
|
23795
|
+
var usageGroupings = [
|
|
23796
|
+
"day",
|
|
23797
|
+
"week",
|
|
23798
|
+
"month",
|
|
23799
|
+
"workspace",
|
|
23800
|
+
"environment",
|
|
23801
|
+
"platform",
|
|
23802
|
+
"source",
|
|
23803
|
+
"trigger",
|
|
23804
|
+
"user"
|
|
23805
|
+
];
|
|
23806
|
+
var usageDay = string2().regex(/^\d{4}-\d{2}-\d{2}$/).describe("A UTC day as YYYY-MM-DD.");
|
|
23807
|
+
var totals = object({
|
|
23808
|
+
flowRuns: number2().describe("Flow runs that used credits. A flow run counts once for each source that used its credits (its trigger, and each person who reran it), on the day of that source's first charge."),
|
|
23809
|
+
runCredits: number2().describe("Credits that flow runs used."),
|
|
23810
|
+
sessionCredits: number2().describe("Credits of runners open outside a run. In a row, the exact share of the session time, so it can be a fraction."),
|
|
23811
|
+
sessionSeconds: number2().describe("Seconds of runners open outside a run.")
|
|
23812
|
+
});
|
|
23813
|
+
var group = object({
|
|
23814
|
+
day: string2().optional(),
|
|
23815
|
+
environment: string2().optional(),
|
|
23816
|
+
month: string2().optional(),
|
|
23817
|
+
platform: string2().optional(),
|
|
23818
|
+
source: string2().optional(),
|
|
23819
|
+
trigger: string2().optional(),
|
|
23820
|
+
user: string2().optional(),
|
|
23821
|
+
week: string2().optional(),
|
|
23822
|
+
workspace: string2().optional()
|
|
23823
|
+
}).describe("The value of each groupBy grouping for this row. day and week are YYYY-MM-DD (a week starts on Monday), month is YYYY-MM, platform is web, ios, android, windows or mac, and source is person, trigger, api, unknown or session-time. workspace, environment, trigger and user hold ids, named in labels. A grouping is absent when the usage has no value for it, for example the environment of a runner opened through the API, or the trigger of session time.");
|
|
23824
|
+
var labels = record(string2(), string2()).describe("Names by id. An id with no name was deleted, or belongs to a workspace you cannot see.");
|
|
23825
|
+
var makeUsageBreakdownContract = (ids) => {
|
|
23826
|
+
const input = object({
|
|
23827
|
+
from: usageDay.describe("The first UTC day of the range, YYYY-MM-DD."),
|
|
23828
|
+
groupBy: array(_enum(usageGroupings)).max(2).default([]).describe("Up to two groupings, for example [day, environment]. Empty gives one row with all usage."),
|
|
23829
|
+
limit: number2().int().min(1).max(1000).default(100).describe("The most rows to return, most credits first. The rest are added up in others."),
|
|
23830
|
+
scope: _enum(["workspace", "organization"]).default("workspace").describe("workspace reads one workspace. organization reads every workspace of its organization whose usage you can see. It needs an organization API key or a billing manager; with a user credential, send workspaceId to name the organization. An organization API key is not a billing manager: it sees only the workspaces whose Usage page is open to customers."),
|
|
23831
|
+
to: usageDay.describe(`The last UTC day of the range, YYYY-MM-DD. The range holds at most ${maxUsageBreakdownDays} days, including both ends.`),
|
|
23832
|
+
workspaceId: ids.workspace.optional().describe("The workspace to read, or whose organization to read. Required with a user API key, and with an organization API key for the workspace scope.")
|
|
23833
|
+
});
|
|
23834
|
+
const output = object({
|
|
23835
|
+
labels: object({
|
|
23836
|
+
environments: labels,
|
|
23837
|
+
triggers: labels,
|
|
23838
|
+
users: labels,
|
|
23839
|
+
workspaces: labels
|
|
23840
|
+
}),
|
|
23841
|
+
others: totals.optional().describe("The rows after limit, added up. Absent when none was left out."),
|
|
23842
|
+
rows: array(totals.extend({ group })).describe("Most credits first."),
|
|
23843
|
+
totals: totals.describe("All usage of the range. sessionCredits here are whole credits, counted for each UTC month and platform, so the rows can add up to a little less.")
|
|
23844
|
+
});
|
|
23845
|
+
return {
|
|
23846
|
+
annotationJustifications: {
|
|
23847
|
+
destructiveHint: "Only reads usage.",
|
|
23848
|
+
openWorldHint: "Reads QA Wolf usage records only.",
|
|
23849
|
+
readOnlyHint: "Adds up recorded usage without changing anything."
|
|
23850
|
+
},
|
|
23851
|
+
annotations: {
|
|
23852
|
+
destructiveHint: false,
|
|
23853
|
+
openWorldHint: false,
|
|
23854
|
+
readOnlyHint: true
|
|
23855
|
+
},
|
|
23856
|
+
description: "Show where credits went over a range of UTC days, grouped by time, workspace, environment, platform, source, trigger or user. Use it to find what uses the most credits, or to build a usage dashboard. Credits only, no dollar amounts.",
|
|
23857
|
+
input,
|
|
23858
|
+
kind: "read",
|
|
23859
|
+
name: "usage.breakdown",
|
|
23860
|
+
output
|
|
23861
|
+
};
|
|
23862
|
+
};
|
|
23863
|
+
|
|
23864
|
+
// node_modules/@qawolf/api-contracts/dist/v1/usage/index.js
|
|
23865
|
+
var makeUsageContracts = (ids) => ({
|
|
23866
|
+
breakdown: makeUsageBreakdownContract(ids)
|
|
23867
|
+
});
|
|
23868
|
+
|
|
23523
23869
|
// node_modules/@qawolf/api-contracts/dist/v1/index.js
|
|
23524
23870
|
var makeContractsV1 = (ids) => {
|
|
23525
23871
|
const resolvedIds = {
|
|
@@ -23541,10 +23887,7 @@ var makeContractsV1 = (ids) => {
|
|
|
23541
23887
|
get: makeGetAttemptContract(resolvedIds)
|
|
23542
23888
|
},
|
|
23543
23889
|
build: makeBuildContracts(resolvedIds),
|
|
23544
|
-
codeHostIntegration:
|
|
23545
|
-
find: makeFindCodeHostIntegrationsContract(resolvedIds),
|
|
23546
|
-
listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
|
|
23547
|
-
},
|
|
23890
|
+
codeHostIntegration: makeCodeHostIntegrationContracts(resolvedIds),
|
|
23548
23891
|
deployment: makeDeploymentContracts(resolvedIds),
|
|
23549
23892
|
email: {
|
|
23550
23893
|
find: makeFindEmailsContract(resolvedIds),
|
|
@@ -23599,11 +23942,9 @@ var makeContractsV1 = (ids) => {
|
|
|
23599
23942
|
runner: makeRunnerContracts(resolvedIds),
|
|
23600
23943
|
skill: makeSkillContracts(),
|
|
23601
23944
|
suggestion: makeSuggestionContracts(resolvedIds),
|
|
23602
|
-
tag:
|
|
23603
|
-
|
|
23604
|
-
|
|
23605
|
-
},
|
|
23606
|
-
trigger: makeTriggerContracts(resolvedIds)
|
|
23945
|
+
tag: makeTagContracts(resolvedIds),
|
|
23946
|
+
trigger: makeTriggerContracts(resolvedIds),
|
|
23947
|
+
usage: makeUsageContracts(resolvedIds)
|
|
23607
23948
|
};
|
|
23608
23949
|
};
|
|
23609
23950
|
var publicContractsV1 = makeContractsV1(defaultIdSchemas);
|
|
@@ -26111,7 +26452,7 @@ function startUpdateCheck(deps) {
|
|
|
26111
26452
|
// package.json
|
|
26112
26453
|
var package_default = {
|
|
26113
26454
|
name: "@qawolf/cli",
|
|
26114
|
-
version: "2.
|
|
26455
|
+
version: "2.14.0",
|
|
26115
26456
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
26116
26457
|
keywords: [
|
|
26117
26458
|
"automation",
|
|
@@ -26183,7 +26524,7 @@ var package_default = {
|
|
|
26183
26524
|
"@clack/prompts": "1.5.1",
|
|
26184
26525
|
"@napi-rs/keyring": "1.3.0",
|
|
26185
26526
|
"@oxc-node/core": "0.1.0",
|
|
26186
|
-
"@qawolf/api-contracts": "0.
|
|
26527
|
+
"@qawolf/api-contracts": "0.142.0",
|
|
26187
26528
|
"@qawolf/emails": "1.1.1",
|
|
26188
26529
|
"@qawolf/flow-targets": "2.0.0",
|
|
26189
26530
|
commander: "14.0.3",
|
|
@@ -28390,6 +28731,7 @@ var uploadExamples = `
|
|
|
28390
28731
|
Examples:
|
|
28391
28732
|
$ qawolf build upload app-release.apk
|
|
28392
28733
|
$ qawolf build upload App.ipa --environment-id <id>
|
|
28734
|
+
$ qawolf build upload my-app_1.0.0_amd64.deb --environment-id <id>
|
|
28393
28735
|
$ qawolf build upload app-release.aab --environment-name pr-42 --environment-ephemeral --environment-base-ephemeral-environment staging --branch feat/login --commit-sha 1a2b3c4
|
|
28394
28736
|
|
|
28395
28737
|
Without an environment flag, the build belongs to no environment: only a run
|
|
@@ -28405,7 +28747,7 @@ var toUploadOptions = (filePath, opts) => ({
|
|
|
28405
28747
|
workspaceId: opts.workspaceId
|
|
28406
28748
|
});
|
|
28407
28749
|
function registerBuildUploadCommand(build, signals) {
|
|
28408
|
-
declareCommandKind(build.command("upload <file>"), "write").description("Upload an app file (.apk, .aab or .
|
|
28750
|
+
declareCommandKind(build.command("upload <file>"), "write").description("Upload an app file (.apk, .aab, .ipa, or a Linux Electron .deb or .rpm, up to 1 GB by default) and create a build from it. Runs build requestUpload, the PUT and build create in one step").option("--environment-id <id>", "Put the build on this existing environment: its runs install it from now on, until a newer build of the same app and platform arrives").option("--environment-name <name>", "Put the build on the environment with this alias or name, and create the environment when none matches").option("--environment-ephemeral", "With --environment-name, create an ephemeral environment when the name creates one, such as a pull request's").option("--environment-base-ephemeral-environment <name>", "With --environment-ephemeral, the alias or name of the environment a created ephemeral environment copies from").option("--branch <branch>", "The branch the build came from").option("--commit-sha <sha>", "The commit the build came from").option("--workspace-id <id>", "The workspace to upload into. Required when authenticating with an organization or user API key").addHelpText("after", uploadExamples).action((filePath, opts, command) => withAuthContext(signals, (ctx) => handleBuildUpload(ctx, toUploadOptions(filePath, opts), {
|
|
28409
28751
|
openFile: (path) => openFileAsBlob(ctx.fs, path),
|
|
28410
28752
|
putFile: (args) => putSignedUrl(args)
|
|
28411
28753
|
}))(opts, command));
|
|
@@ -44797,4 +45139,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
44797
45139
|
process.exitCode = 1;
|
|
44798
45140
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
44799
45141
|
|
|
44800
|
-
//# debugId=
|
|
45142
|
+
//# debugId=723F7DBFDEE8DCFF64756E2164756E21
|