@qawolf/cli 2.5.0 → 2.7.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 +408 -42
- package/dist/runner-sdk.js +406 -40
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +9 -3
- package/skills/qawolf-cli/references/run-results.md +22 -0
package/dist/runner-sdk.js
CHANGED
|
@@ -7110,6 +7110,7 @@ var agentReplySchema = object({
|
|
|
7110
7110
|
|
|
7111
7111
|
// node_modules/@qawolf/api-contracts/dist/v1/agent/wait.js
|
|
7112
7112
|
var maxAgentWaitSeconds = 45;
|
|
7113
|
+
var maxAgentWaitSecondsWithProgress = 170;
|
|
7113
7114
|
var agentWakeReasonSchema = _enum(["reply", "status", "timeout"]).describe('Why a held check answered. "reply" means the AI said something new, "status" means the session settled or needs you, "timeout" means the hold ran out with nothing new.');
|
|
7114
7115
|
|
|
7115
7116
|
// node_modules/@qawolf/api-contracts/dist/v1/run/summary.js
|
|
@@ -7142,6 +7143,54 @@ var makeRunSummaryFields = (ids) => ({
|
|
|
7142
7143
|
}).optional().describe("The run that replaced this one, present only when `status` is `superseded`. A newer deployment to the same branch and environment (and service, when the deployment named one) cancels the older run's unfinished flows and takes over. Deduplication ignores the commit, so the replacement may be testing a later commit than this run did. Only the direct replacement is named; that run can itself be superseded.")
|
|
7143
7144
|
});
|
|
7144
7145
|
|
|
7146
|
+
// node_modules/@qawolf/api-contracts/dist/v1/activity/wait.js
|
|
7147
|
+
var maxActivityWaitItems = 50;
|
|
7148
|
+
var makeActivityWaitContract = (ids) => {
|
|
7149
|
+
const cursors = record(string2().min(1), string2().min(1));
|
|
7150
|
+
const runIds = array(ids.run);
|
|
7151
|
+
const sessionIds = array(ids.chatSession);
|
|
7152
|
+
const input = object({
|
|
7153
|
+
cursors: cursors.optional().describe("Each session's nextCursor from the previous answer, keyed by its session id. A session without one is read from its first reply."),
|
|
7154
|
+
runIds: runIds.max(maxActivityWaitItems).optional().describe(`The runs you are waiting on, including a run still being created. Send at least one session or run, and at most ${maxActivityWaitItems} together.`),
|
|
7155
|
+
sessionIds: sessionIds.max(maxActivityWaitItems).optional().describe("The Tester sessions you are waiting on, as agent.send answered with."),
|
|
7156
|
+
waitSeconds: number2().int().min(0).optional().describe(`How long the server may hold this call open, in seconds. Defaults to ${maxAgentWaitSeconds}. A larger value clamps to ${maxAgentWaitSeconds}, or to ${maxAgentWaitSecondsWithProgress} when the call carries a progress token. Pass more than ${maxAgentWaitSeconds} only when your instructions say your client keeps the call open while progress arrives.`)
|
|
7157
|
+
});
|
|
7158
|
+
const output = object({
|
|
7159
|
+
open: object({ cursors, runIds, sessionIds }).describe("Everything still worth waiting on: each session whose status is not completed, failed, cancelled or not-found, with its new cursor, and each run that has not finished. Send it as the next call's input."),
|
|
7160
|
+
runs: array(object({
|
|
7161
|
+
finished: boolean2().describe("True once the status is passed, failed, canceled, superseded or not-found. A finished run never changes again."),
|
|
7162
|
+
runId: ids.run.describe("The run id you sent."),
|
|
7163
|
+
status: _enum([...publicRunSummaryStatusValues, "not-found"]).describe(`The run's status, as run.get reports it. A run still being created reads "queued". "not-found" means no run has this id: its creation failed, was skipped or never finished, or the run is gone.`),
|
|
7164
|
+
url: string2().optional().describe("Absolute URL of the run page. Absent while the run is still being created, and when it is not found.")
|
|
7165
|
+
})).describe("Every run you sent, in the order you sent them."),
|
|
7166
|
+
sessions: array(object({
|
|
7167
|
+
nextCursor: string2().min(1).describe("Send back under this session's id in cursors to read only what follows."),
|
|
7168
|
+
replies: array(agentReplySchema).describe("What the AI has said since the cursor, oldest first, as agent.get returns it. Empty when it said nothing new."),
|
|
7169
|
+
sessionId: ids.chatSession,
|
|
7170
|
+
status: _enum([...agentSessionStatuses, "not-found"]).describe('Where the work stands, as agent.get reports it. "working" means the AI is still on it. "waiting-for-you" means it asked a question that agent.send must answer. "completed" means it finished, and a new agent.send continues it. "failed" and "cancelled" are settled. "not-found" means the session is gone and will not change.')
|
|
7171
|
+
})).describe("Every session you sent, in the order you sent them."),
|
|
7172
|
+
waitSeconds: number2().int().describe("The hold this call was allowed, in seconds, after clamping."),
|
|
7173
|
+
wokeOn: _enum(["activity", "timeout"]).describe('"activity" means a session replied or changed status, or a run finished, or a session or run was not found; every item with news is in this answer. "timeout" means the hold ran out with nothing new.')
|
|
7174
|
+
});
|
|
7175
|
+
return {
|
|
7176
|
+
annotationJustifications: {
|
|
7177
|
+
destructiveHint: "Does not cancel work, stop runs or edit tests.",
|
|
7178
|
+
openWorldHint: "Reads QA Wolf sessions and runs without posting to external services.",
|
|
7179
|
+
readOnlyHint: "Retrieves session replies and statuses and run statuses without sending work."
|
|
7180
|
+
},
|
|
7181
|
+
annotations: {
|
|
7182
|
+
destructiveHint: false,
|
|
7183
|
+
openWorldHint: false,
|
|
7184
|
+
readOnlyHint: true
|
|
7185
|
+
},
|
|
7186
|
+
description: `Wait on many QA Wolf AI (Tester) sessions and runs in one call. Pass every Tester session and run you are waiting on. The call returns as soon as any session replies or changes status or any run finishes, and reports every item with news. Send back open as the next call's input, and call again as soon as it returns. Pass waitSeconds above ${maxAgentWaitSeconds} only when your instructions say your client keeps the call open while progress arrives.`,
|
|
7187
|
+
input,
|
|
7188
|
+
kind: "read",
|
|
7189
|
+
name: "activity.wait",
|
|
7190
|
+
output
|
|
7191
|
+
};
|
|
7192
|
+
};
|
|
7193
|
+
|
|
7145
7194
|
// node_modules/@qawolf/api-contracts/dist/v1/deployment/didNotRunReason.js
|
|
7146
7195
|
var didNotRunReasonSchema = _enum([
|
|
7147
7196
|
"billing-prevented",
|
|
@@ -7365,6 +7414,16 @@ var defaultIdSchemas = {
|
|
|
7365
7414
|
};
|
|
7366
7415
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
7367
7416
|
|
|
7417
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/files.js
|
|
7418
|
+
var maxAttachedFilesPerRequest = 10;
|
|
7419
|
+
var attachedFilePathsSchema = array(teamStoragePathSchema).min(1).max(maxAttachedFilesPerRequest).refine((filePaths) => new Set(filePaths).size === filePaths.length, "filePaths must be unique");
|
|
7420
|
+
var attachedFilePathsDescription = "Paths of files in the team's storage to attach to the bug report, such as the files the bug was reproduced with. " + `At most ${maxAttachedFilesPerRequest} files, each at most 100 MB. ` + "QA Wolf keeps a copy of each file as it is now, so later changes to the original do not change the report. " + "If any path has no file, nothing is attached and the error names the path.";
|
|
7421
|
+
var issueFileSchema = object({
|
|
7422
|
+
fileId: string2().describe("The id of the attached file."),
|
|
7423
|
+
name: string2().describe("The file's name, taken from the last segment of the path it was attached from."),
|
|
7424
|
+
sizeBytes: number2().int().nonnegative()
|
|
7425
|
+
});
|
|
7426
|
+
|
|
7368
7427
|
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
7369
7428
|
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
7370
7429
|
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.");
|
|
@@ -7519,6 +7578,9 @@ var makeListScreenshotComparisonsContract = (ids) => {
|
|
|
7519
7578
|
};
|
|
7520
7579
|
};
|
|
7521
7580
|
|
|
7581
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/wait.js
|
|
7582
|
+
var runWakeReasonSchema = _enum(["status", "timeout"]).describe(`Why a held check answered. "status" means the run's status differs from the one the check started with, or the run was already terminal; "timeout" means the hold ran out with the status unchanged.`);
|
|
7583
|
+
|
|
7522
7584
|
// node_modules/@qawolf/api-contracts/dist/v1/runner/actionSequence.js
|
|
7523
7585
|
var maxActionsPerRequest = 10;
|
|
7524
7586
|
var screenshotModes = ["none", "final", "each"];
|
|
@@ -8307,6 +8369,13 @@ var runSelectionSchema = object({
|
|
|
8307
8369
|
error: "A selection's startLine must not be after its endLine.",
|
|
8308
8370
|
path: ["startLine"]
|
|
8309
8371
|
});
|
|
8372
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatFields.js
|
|
8373
|
+
var triggerScheduleRepeatFields = {
|
|
8374
|
+
dayOfMonth: number2().int().min(1).max(28).optional().describe("The day of the month a monthly schedule fires on, from 1 to 28 so it exists in every month. Required when cadence is monthly."),
|
|
8375
|
+
every: number2().int().min(1).optional().describe("How many hours, days, weeks or months sit between fires. Defaults to 1. Hourly takes 1, 2, 3, 4, 6, 8 or 12, counted from midnight in timezoneId; daily takes up to 31, and weekly and monthly up to 12."),
|
|
8376
|
+
startDate: string2().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('The date of the first fire, as "YYYY-MM-DD" in timezoneId, for a daily, weekly or monthly schedule whose every is more than 1. Later fires repeat every N units from it. A weekly start date falls on dayOfWeek and a monthly one on dayOfMonth. Required when every is more than 1.')
|
|
8377
|
+
};
|
|
8378
|
+
|
|
8310
8379
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configuration.js
|
|
8311
8380
|
var isTimezone = (value) => {
|
|
8312
8381
|
try {
|
|
@@ -8316,7 +8385,7 @@ var isTimezone = (value) => {
|
|
|
8316
8385
|
return false;
|
|
8317
8386
|
}
|
|
8318
8387
|
};
|
|
8319
|
-
var triggerCadenceSchema = _enum(["hourly", "daily", "weekly"]).describe("How often the schedule fires.");
|
|
8388
|
+
var triggerCadenceSchema = _enum(["hourly", "daily", "weekly", "monthly"]).describe("How often the schedule fires.");
|
|
8320
8389
|
var triggerDayOfWeekSchema = _enum([
|
|
8321
8390
|
"monday",
|
|
8322
8391
|
"tuesday",
|
|
@@ -8344,11 +8413,74 @@ var makeTriggerScheduleFields = (ids) => ({
|
|
|
8344
8413
|
message: "Expected each day to be named at most once."
|
|
8345
8414
|
}).optional().describe("The only days an hourly or daily schedule fires on, read in timezoneId. Name each day at most once. Omitting it fires on every day."),
|
|
8346
8415
|
environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
|
|
8416
|
+
...triggerScheduleRepeatFields,
|
|
8347
8417
|
minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
|
|
8348
|
-
timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily or
|
|
8418
|
+
timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily, weekly or monthly schedule fires, as "HH:mm". Required when cadence is daily, weekly or monthly.'),
|
|
8349
8419
|
timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against.")
|
|
8350
8420
|
});
|
|
8351
8421
|
|
|
8422
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatRules.js
|
|
8423
|
+
var hourlyEveryValues = [1, 2, 3, 4, 6, 8, 12];
|
|
8424
|
+
var maxEvery = {
|
|
8425
|
+
daily: 31,
|
|
8426
|
+
monthly: 12,
|
|
8427
|
+
weekly: 12
|
|
8428
|
+
};
|
|
8429
|
+
var dayOfWeekNames = [
|
|
8430
|
+
"sunday",
|
|
8431
|
+
"monday",
|
|
8432
|
+
"tuesday",
|
|
8433
|
+
"wednesday",
|
|
8434
|
+
"thursday",
|
|
8435
|
+
"friday",
|
|
8436
|
+
"saturday"
|
|
8437
|
+
];
|
|
8438
|
+
var calendarDayOf = (startDate) => {
|
|
8439
|
+
const date = new Date(`${startDate}T00:00:00Z`);
|
|
8440
|
+
return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(startDate) ? date : undefined;
|
|
8441
|
+
};
|
|
8442
|
+
var everyIssue = (value, every) => {
|
|
8443
|
+
if (value.cadence === "hourly") {
|
|
8444
|
+
return hourlyEveryValues.includes(every) ? undefined : "every must divide a day evenly when cadence is hourly: 1, 2, 3, 4, 6, 8 or 12.";
|
|
8445
|
+
}
|
|
8446
|
+
const max = maxEvery[value.cadence];
|
|
8447
|
+
return every > max ? `every is at most ${max} when cadence is ${value.cadence}.` : undefined;
|
|
8448
|
+
};
|
|
8449
|
+
var startDateIssue = (value, startDate) => {
|
|
8450
|
+
const day = calendarDayOf(startDate);
|
|
8451
|
+
if (day === undefined)
|
|
8452
|
+
return "startDate must be a real calendar date.";
|
|
8453
|
+
if (value.cadence === "weekly" && value.dayOfWeek !== undefined && dayOfWeekNames[day.getUTCDay()] !== value.dayOfWeek)
|
|
8454
|
+
return "startDate must fall on dayOfWeek.";
|
|
8455
|
+
if (value.cadence === "monthly" && value.dayOfMonth !== undefined && day.getUTCDate() !== value.dayOfMonth)
|
|
8456
|
+
return "startDate must fall on dayOfMonth.";
|
|
8457
|
+
return;
|
|
8458
|
+
};
|
|
8459
|
+
var checkScheduleRepeat = (value, ctx) => {
|
|
8460
|
+
const every = value.every ?? 1;
|
|
8461
|
+
const issue = (message, field) => ctx.addIssue({ code: "custom", message, path: [field] });
|
|
8462
|
+
const everyMessage = everyIssue(value, every);
|
|
8463
|
+
if (everyMessage !== undefined)
|
|
8464
|
+
issue(everyMessage, "every");
|
|
8465
|
+
if (value.cadence === "hourly")
|
|
8466
|
+
return;
|
|
8467
|
+
if (every > 1 && value.daysOfWeek !== undefined)
|
|
8468
|
+
issue("daysOfWeek applies only when every is 1.", "daysOfWeek");
|
|
8469
|
+
if (every > 1 && value.startDate === undefined) {
|
|
8470
|
+
issue("startDate is required when every is more than 1.", "startDate");
|
|
8471
|
+
return;
|
|
8472
|
+
}
|
|
8473
|
+
if (value.startDate === undefined)
|
|
8474
|
+
return;
|
|
8475
|
+
if (every === 1) {
|
|
8476
|
+
issue("startDate applies only when every is more than 1.", "startDate");
|
|
8477
|
+
return;
|
|
8478
|
+
}
|
|
8479
|
+
const startDateMessage = startDateIssue(value, value.startDate);
|
|
8480
|
+
if (startDateMessage !== undefined)
|
|
8481
|
+
issue(startDateMessage, "startDate");
|
|
8482
|
+
};
|
|
8483
|
+
|
|
8352
8484
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
|
|
8353
8485
|
var checkAction = (action, ctx) => {
|
|
8354
8486
|
const namesFlows = action.flowIds.length + action.tagNames.length > 0;
|
|
@@ -8380,24 +8512,32 @@ var checkAction = (action, ctx) => {
|
|
|
8380
8512
|
var requiredScheduleFields = {
|
|
8381
8513
|
daily: ["timeOfDay", "timezoneId"],
|
|
8382
8514
|
hourly: ["timezoneId"],
|
|
8515
|
+
monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
|
|
8383
8516
|
weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
|
|
8384
8517
|
};
|
|
8385
8518
|
var optionalScheduleFields = {
|
|
8386
|
-
daily: ["daysOfWeek"],
|
|
8387
|
-
hourly: ["daysOfWeek", "minuteOfHour"],
|
|
8388
|
-
|
|
8519
|
+
daily: ["daysOfWeek", "every", "startDate"],
|
|
8520
|
+
hourly: ["daysOfWeek", "every", "minuteOfHour"],
|
|
8521
|
+
monthly: ["every", "startDate"],
|
|
8522
|
+
weekly: ["every", "startDate"]
|
|
8389
8523
|
};
|
|
8390
8524
|
var cadencesUsingField = {
|
|
8525
|
+
dayOfMonth: "a monthly cadence",
|
|
8391
8526
|
dayOfWeek: "a weekly cadence",
|
|
8392
8527
|
daysOfWeek: "an hourly or daily cadence",
|
|
8528
|
+
every: "any cadence",
|
|
8393
8529
|
minuteOfHour: "an hourly cadence",
|
|
8394
|
-
|
|
8395
|
-
|
|
8530
|
+
startDate: "a daily, weekly or monthly cadence",
|
|
8531
|
+
timeOfDay: "a daily, weekly or monthly cadence",
|
|
8532
|
+
timezoneId: "an hourly, daily, weekly or monthly cadence"
|
|
8396
8533
|
};
|
|
8397
8534
|
var scheduleFields = [
|
|
8535
|
+
"dayOfMonth",
|
|
8398
8536
|
"dayOfWeek",
|
|
8399
8537
|
"daysOfWeek",
|
|
8538
|
+
"every",
|
|
8400
8539
|
"minuteOfHour",
|
|
8540
|
+
"startDate",
|
|
8401
8541
|
"timeOfDay",
|
|
8402
8542
|
"timezoneId"
|
|
8403
8543
|
];
|
|
@@ -8427,6 +8567,7 @@ var checkScheduleFields = (value, ctx) => {
|
|
|
8427
8567
|
};
|
|
8428
8568
|
var checkSchedule = (value, ctx) => {
|
|
8429
8569
|
checkScheduleFields(value, ctx);
|
|
8570
|
+
checkScheduleRepeat(value, ctx);
|
|
8430
8571
|
if (value.action.kind === "generativeSuite") {
|
|
8431
8572
|
ctx.addIssue({
|
|
8432
8573
|
code: "custom",
|
|
@@ -8705,7 +8846,7 @@ var makeAgentGetContract = (ids) => {
|
|
|
8705
8846
|
const input = object({
|
|
8706
8847
|
cursor: string2().min(1).optional().describe("Opaque cursor copied from this same session's previous nextCursor. Omit to read from its first reply."),
|
|
8707
8848
|
sessionId: ids.chatSession.describe("The id agent.send answered with."),
|
|
8708
|
-
waitSeconds: number2().int().min(0).optional().describe(`How long the server may hold this check open, in seconds. Defaults to ${maxAgentWaitSeconds}
|
|
8849
|
+
waitSeconds: number2().int().min(0).optional().describe(`How long the server may hold this check open, in seconds. Defaults to ${maxAgentWaitSeconds}. Pass 0 to answer at once. A larger value clamps to ${maxAgentWaitSeconds}, or to ${maxAgentWaitSecondsWithProgress} when the call carries a progress token. Pass more than ${maxAgentWaitSeconds} only when your instructions say your client keeps the call open while progress arrives. A held check answers the moment a reply or status change arrives. Check again as soon as a held check returns.`)
|
|
8709
8850
|
});
|
|
8710
8851
|
const output = resource({
|
|
8711
8852
|
nextCursor: string2().min(1).describe("Send back as cursor on the next check to read only what follows. Always present, even with no replies. Belongs to this session alone."),
|
|
@@ -8728,7 +8869,7 @@ var makeAgentGetContract = (ids) => {
|
|
|
8728
8869
|
openWorldHint: false,
|
|
8729
8870
|
readOnlyHint: true
|
|
8730
8871
|
},
|
|
8731
|
-
description:
|
|
8872
|
+
description: `Monitor a QA Wolf AI session by reading its status and replies. After agent.send, share the returned session URL before monitoring. Pass waitSeconds ${maxAgentWaitSeconds} so the server holds the check open and answers the moment a reply or status change arrives. Check again as soon as it returns; never sleep between checks or loop without waitSeconds. Pass the nextCursor from one response as the cursor on the next check; it then reads only what is new, and only for the session that minted it. Continue monitoring silently when the status is unchanged and no replies come back; do not narrate waiting, announce the next check, or ask whether to keep monitoring. Report only substantive new progress, questions, blockers, or the final outcome. A status of "waiting-for-you" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Surface an explicit request for user input even if the status still says "working". Include the session URL when reporting a blocker or final outcome. On "completed", stop status checks and verify the requested result before claiming success. For new flows, validation, publication in the target environment, and readiness are separate checks; a Git push or final reply does not prove the flow is active. If every requested result is verified but status remains "working", report the mismatch and stop monitoring. Stop on "failed" or "cancelled" and report any confirmed partial result.`,
|
|
8732
8873
|
input,
|
|
8733
8874
|
kind: "read",
|
|
8734
8875
|
name: "agent.get",
|
|
@@ -8980,6 +9121,36 @@ var makeListBuildsContract = (ids) => {
|
|
|
8980
9121
|
};
|
|
8981
9122
|
};
|
|
8982
9123
|
|
|
9124
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestDownload.js
|
|
9125
|
+
var makeRequestBuildDownloadContract = (ids) => {
|
|
9126
|
+
const input = object({
|
|
9127
|
+
buildId: buildIdSchema,
|
|
9128
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
9129
|
+
});
|
|
9130
|
+
const output = object({
|
|
9131
|
+
expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
|
|
9132
|
+
fileName: string2().describe("The name of the build's file."),
|
|
9133
|
+
readUrl: string2().describe('Fetch the build\'s file from here, for example `curl -o app.apk "<readUrl>"`.')
|
|
9134
|
+
});
|
|
9135
|
+
return {
|
|
9136
|
+
annotationJustifications: {
|
|
9137
|
+
destructiveHint: "Does not change the build or its file.",
|
|
9138
|
+
openWorldHint: "Access is limited to the build files of the authorized workspace.",
|
|
9139
|
+
readOnlyHint: "Returns an expiring read URL for a build's file."
|
|
9140
|
+
},
|
|
9141
|
+
annotations: {
|
|
9142
|
+
destructiveHint: false,
|
|
9143
|
+
openWorldHint: false,
|
|
9144
|
+
readOnlyHint: true
|
|
9145
|
+
},
|
|
9146
|
+
description: "Get a URL to download a build's file. Deleted builds can be downloaded while their file exists. Answers 404 when the file has expired.",
|
|
9147
|
+
input,
|
|
9148
|
+
kind: "read",
|
|
9149
|
+
name: "build.requestDownload",
|
|
9150
|
+
output
|
|
9151
|
+
};
|
|
9152
|
+
};
|
|
9153
|
+
|
|
8983
9154
|
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
8984
9155
|
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
8985
9156
|
var makeRequestBuildUploadContract = (ids) => {
|
|
@@ -9020,6 +9191,7 @@ var makeBuildContracts = (ids) => ({
|
|
|
9020
9191
|
delete: makeDeleteBuildContract(ids),
|
|
9021
9192
|
get: makeGetBuildContract(ids),
|
|
9022
9193
|
list: makeListBuildsContract(ids),
|
|
9194
|
+
requestDownload: makeRequestBuildDownloadContract(ids),
|
|
9023
9195
|
requestUpload: makeRequestBuildUploadContract(ids)
|
|
9024
9196
|
});
|
|
9025
9197
|
|
|
@@ -9627,6 +9799,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
9627
9799
|
});
|
|
9628
9800
|
const output = object({
|
|
9629
9801
|
missingNames: array(string2()).describe("Requested names the environment does not have, sorted alphabetically."),
|
|
9802
|
+
secretNames: array(string2()).describe("Requested names that hold write-only secrets, sorted alphabetically. Their values are never returned; flows still receive them at run time."),
|
|
9630
9803
|
variables: array(object({
|
|
9631
9804
|
name: string2().describe("The stored variable name."),
|
|
9632
9805
|
value: string2().describe("The variable's secret value. Handle as a secret.")
|
|
@@ -9643,7 +9816,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
9643
9816
|
openWorldHint: false,
|
|
9644
9817
|
readOnlyHint: true
|
|
9645
9818
|
},
|
|
9646
|
-
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and
|
|
9819
|
+
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and write-only secrets go to secretNames; neither fails the call.",
|
|
9647
9820
|
input,
|
|
9648
9821
|
kind: "read",
|
|
9649
9822
|
name: "environment.getVariable",
|
|
@@ -10056,13 +10229,7 @@ var makeUpdateFlowContract = (ids) => {
|
|
|
10056
10229
|
};
|
|
10057
10230
|
|
|
10058
10231
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/index.js
|
|
10059
|
-
var issuePrioritySchema = _enum([
|
|
10060
|
-
"unprioritized",
|
|
10061
|
-
"low",
|
|
10062
|
-
"medium",
|
|
10063
|
-
"high",
|
|
10064
|
-
"urgent"
|
|
10065
|
-
]);
|
|
10232
|
+
var issuePrioritySchema = _enum(["unprioritized", "low", "medium", "high", "urgent"]).describe("An open bug report at unprioritized, high or urgent priority blocks its suite and CI gate. Low and medium don't block. Priority never makes a blocker or coverage request block.");
|
|
10066
10233
|
var issueStatusSchema = _enum([
|
|
10067
10234
|
"backlog",
|
|
10068
10235
|
"pending",
|
|
@@ -10083,6 +10250,7 @@ var makeIssueResourceSchema = (ids) => resource({
|
|
|
10083
10250
|
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
|
|
10084
10251
|
createdAt: exports_coerce.date().describe("When the issue was created."),
|
|
10085
10252
|
description: string2().describe("The issue description in Markdown."),
|
|
10253
|
+
files: array(issueFileSchema).default([]).describe("Files attached to a bug report, oldest first. Always empty on blockers and coverage requests."),
|
|
10086
10254
|
issueId: ids.issue,
|
|
10087
10255
|
name: string2(),
|
|
10088
10256
|
number: number2().int(),
|
|
@@ -10261,6 +10429,51 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
10261
10429
|
};
|
|
10262
10430
|
};
|
|
10263
10431
|
|
|
10432
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/answer.js
|
|
10433
|
+
var maxAnswersPerCall = 50;
|
|
10434
|
+
var findingIdSchema = string2().min(1).max(80);
|
|
10435
|
+
var findingIdsOf = ({ answers = {}, replies = {} }) => [
|
|
10436
|
+
...Object.keys(answers),
|
|
10437
|
+
...Object.keys(replies)
|
|
10438
|
+
];
|
|
10439
|
+
var makeAnswerInvestigationQuestionsContract = (ids) => {
|
|
10440
|
+
const input = object({
|
|
10441
|
+
answers: record(findingIdSchema, string2().min(1)).optional().describe("Offered answers, keyed by the question's findingId. Each value is the `value` of one of the question's offered answers, such as maintenance or bug."),
|
|
10442
|
+
replies: record(findingIdSchema, string2().trim().min(1).max(1000)).optional().describe("The person's own words, keyed by the question's findingId, for a question that none of the offered answers fits."),
|
|
10443
|
+
runId: ids.run
|
|
10444
|
+
}).refine((sent) => findingIdsOf(sent).length > 0, {
|
|
10445
|
+
message: "Send at least one answer or reply."
|
|
10446
|
+
}).refine((sent) => findingIdsOf(sent).length <= maxAnswersPerCall, {
|
|
10447
|
+
message: `Send at most ${maxAnswersPerCall} answers and replies in one call.`
|
|
10448
|
+
}).refine((sent) => new Set(findingIdsOf(sent)).size === findingIdsOf(sent).length, { message: "Answer each question once, as an answer or as a reply." });
|
|
10449
|
+
const output = resource({
|
|
10450
|
+
answeredFindingIds: array(string2()).describe("The questions this call answered. The investigation receives the answers and acts on them."),
|
|
10451
|
+
refused: array(object({
|
|
10452
|
+
findingId: string2(),
|
|
10453
|
+
message: string2().describe("Why the answer was not recorded."),
|
|
10454
|
+
reason: string2().describe('Known values: "answer-not-offered", "environment-terminated", "not-asking", "not-found", "response-pending" and "superseded". New values can appear.')
|
|
10455
|
+
})).describe("The answers that were not recorded."),
|
|
10456
|
+
runId: ids.run
|
|
10457
|
+
}, { urlFieldDescription: "The run in the QA Wolf app." });
|
|
10458
|
+
return {
|
|
10459
|
+
annotationJustifications: {
|
|
10460
|
+
destructiveHint: "Records a person's answer that cannot be changed, and the investigation acts on it, for example by filing a bug or publishing a test fix.",
|
|
10461
|
+
openWorldHint: "A bug report the investigation files from an answer can reach the workspace's configured integrations.",
|
|
10462
|
+
readOnlyHint: "Records answers to the questions of a run's investigation."
|
|
10463
|
+
},
|
|
10464
|
+
annotations: {
|
|
10465
|
+
destructiveHint: true,
|
|
10466
|
+
openWorldHint: true,
|
|
10467
|
+
readOnlyHint: false
|
|
10468
|
+
},
|
|
10469
|
+
description: "Answer the questions the QA Wolf AI investigating a failed run is waiting on, as the signed-in person. " + "List the questions with investigation.question.find, and answer only with the person's approval. " + "The first answer to a question wins, and the investigation acts on it. " + "Only a person's own sign-in or user API key can answer; a team or organization key cannot.",
|
|
10470
|
+
input,
|
|
10471
|
+
kind: "write",
|
|
10472
|
+
name: "investigation.question.answer",
|
|
10473
|
+
output
|
|
10474
|
+
};
|
|
10475
|
+
};
|
|
10476
|
+
|
|
10264
10477
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
|
|
10265
10478
|
var makeFindInvestigationQuestionsContract = (ids) => {
|
|
10266
10479
|
const input = object({
|
|
@@ -10278,7 +10491,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
10278
10491
|
headline: string2().optional(),
|
|
10279
10492
|
question: investigationQuestionSchema,
|
|
10280
10493
|
runId: ids.run,
|
|
10281
|
-
sessionId: ids.chatSession.describe("The investigation session.
|
|
10494
|
+
sessionId: ids.chatSession.describe("The investigation session. Read what it is doing with agent.get."),
|
|
10282
10495
|
summary: string2().optional()
|
|
10283
10496
|
}, { 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
10497
|
});
|
|
@@ -10293,7 +10506,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
10293
10506
|
openWorldHint: false,
|
|
10294
10507
|
readOnlyHint: true
|
|
10295
10508
|
},
|
|
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
|
|
10509
|
+
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 them, call investigation.question.answer with the run and the person's answers.",
|
|
10297
10510
|
input,
|
|
10298
10511
|
kind: "read",
|
|
10299
10512
|
name: "investigation.question.find",
|
|
@@ -10303,6 +10516,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
10303
10516
|
|
|
10304
10517
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
|
|
10305
10518
|
var makeInvestigationQuestionContracts = (ids) => ({
|
|
10519
|
+
answer: makeAnswerInvestigationQuestionsContract(ids),
|
|
10306
10520
|
find: makeFindInvestigationQuestionsContract(ids)
|
|
10307
10521
|
});
|
|
10308
10522
|
|
|
@@ -10340,17 +10554,95 @@ var makeAddFlowsToIssueContract = (ids) => {
|
|
|
10340
10554
|
};
|
|
10341
10555
|
};
|
|
10342
10556
|
|
|
10557
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/attachFiles.js
|
|
10558
|
+
var makeAttachFilesToIssueContract = (ids) => {
|
|
10559
|
+
const input = object({
|
|
10560
|
+
filePaths: attachedFilePathsSchema.describe(attachedFilePathsDescription),
|
|
10561
|
+
issueId: ids.issue
|
|
10562
|
+
});
|
|
10563
|
+
const output = object({
|
|
10564
|
+
issue: makeIssueResourceSchema(ids)
|
|
10565
|
+
});
|
|
10566
|
+
return {
|
|
10567
|
+
annotationJustifications: {
|
|
10568
|
+
destructiveHint: "Adds files to the bug report without removing or replacing the ones already attached.",
|
|
10569
|
+
openWorldHint: "Copies files within QA Wolf storage without publishing anything outside QA Wolf.",
|
|
10570
|
+
readOnlyHint: "Copies files from the team's storage and attaches the copies to a bug report."
|
|
10571
|
+
},
|
|
10572
|
+
annotations: {
|
|
10573
|
+
destructiveHint: false,
|
|
10574
|
+
openWorldHint: false,
|
|
10575
|
+
readOnlyHint: false
|
|
10576
|
+
},
|
|
10577
|
+
description: "Attach files from the team's storage to a bug report owned by the caller's team, for example the files a bug was reproduced with. " + "Files already attached stay attached. Upload a file with file.requestUpload first.",
|
|
10578
|
+
input,
|
|
10579
|
+
kind: "write",
|
|
10580
|
+
name: "issue.attachFiles",
|
|
10581
|
+
output
|
|
10582
|
+
};
|
|
10583
|
+
};
|
|
10584
|
+
|
|
10585
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/commentResource.js
|
|
10586
|
+
var issueCommentAuthorSchema = discriminatedUnion("type", [
|
|
10587
|
+
object({
|
|
10588
|
+
email: string2(),
|
|
10589
|
+
name: string2().optional().describe("Absent when the person has not set a name."),
|
|
10590
|
+
type: literal("user")
|
|
10591
|
+
}),
|
|
10592
|
+
object({ type: literal("former-user") }),
|
|
10593
|
+
object({ type: literal("team-api-key") }),
|
|
10594
|
+
object({ type: literal("system") })
|
|
10595
|
+
]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), or QA Wolf itself (`system`).");
|
|
10596
|
+
var makeIssueCommentResourceSchema = (ids) => resource({
|
|
10597
|
+
author: issueCommentAuthorSchema,
|
|
10598
|
+
body: string2().describe("The comment in GitHub-flavored Markdown."),
|
|
10599
|
+
commentId: string2().describe("The id of the comment."),
|
|
10600
|
+
createdAt: exports_coerce.date().describe("When the comment was written."),
|
|
10601
|
+
issueId: ids.issue.describe("The issue the comment is on."),
|
|
10602
|
+
viaQaWolfAi: boolean2().describe("Whether the author wrote the comment through QA Wolf AI.")
|
|
10603
|
+
}, { urlFieldDescription: "Absolute URL of the issue page." });
|
|
10604
|
+
|
|
10605
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/comment.js
|
|
10606
|
+
var maxCommentLength = 1e4;
|
|
10607
|
+
var makeCommentOnIssueContract = (ids) => {
|
|
10608
|
+
const input = object({
|
|
10609
|
+
body: string2().trim().min(1).max(maxCommentLength).describe("The comment in GitHub-flavored Markdown."),
|
|
10610
|
+
issueId: ids.issue.describe("The bug report, blocker, or coverage request to comment on.")
|
|
10611
|
+
});
|
|
10612
|
+
const output = object({
|
|
10613
|
+
comment: makeIssueCommentResourceSchema(ids)
|
|
10614
|
+
});
|
|
10615
|
+
return {
|
|
10616
|
+
annotationJustifications: {
|
|
10617
|
+
destructiveHint: "Adds a comment without removing or changing anything else on the issue.",
|
|
10618
|
+
openWorldHint: "Today it changes only QA Wolf records. It does not post the comment to a linked tracker or to any other service of the workspace.",
|
|
10619
|
+
readOnlyHint: "Records a comment on the issue."
|
|
10620
|
+
},
|
|
10621
|
+
annotations: {
|
|
10622
|
+
destructiveHint: false,
|
|
10623
|
+
openWorldHint: false,
|
|
10624
|
+
readOnlyHint: false
|
|
10625
|
+
},
|
|
10626
|
+
description: "Comment on a bug report, blocker (issue type `maintenance`), or coverage request owned by the caller's team. " + "The comment changes nothing else on the issue, such as its status or priority.",
|
|
10627
|
+
input,
|
|
10628
|
+
kind: "write",
|
|
10629
|
+
name: "issue.comment",
|
|
10630
|
+
output
|
|
10631
|
+
};
|
|
10632
|
+
};
|
|
10633
|
+
|
|
10343
10634
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
|
|
10344
10635
|
var makeCreateIssueContract = (ids) => {
|
|
10345
10636
|
const commonFields = {
|
|
10346
10637
|
description: string2().optional().describe("The issue description in Markdown, which is stored as rich text. Text without Markdown is stored as written, one paragraph per line."),
|
|
10347
10638
|
name: string2().trim().min(1).max(255),
|
|
10348
|
-
priority: issuePrioritySchema.optional().describe(
|
|
10639
|
+
priority: issuePrioritySchema.optional().describe(`${issuePrioritySchema.description} Defaults to "unprioritized" for bug reports and coverage requests.`),
|
|
10349
10640
|
workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
|
|
10350
10641
|
};
|
|
10351
10642
|
const input = discriminatedUnion("type", [
|
|
10352
10643
|
object({
|
|
10353
10644
|
...commonFields,
|
|
10645
|
+
filePaths: attachedFilePathsSchema.optional().describe(attachedFilePathsDescription),
|
|
10354
10646
|
type: literal("bug")
|
|
10355
10647
|
}),
|
|
10356
10648
|
object({
|
|
@@ -10482,6 +10774,35 @@ var makeListIssueActivityContract = (ids) => {
|
|
|
10482
10774
|
};
|
|
10483
10775
|
};
|
|
10484
10776
|
|
|
10777
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/listComments.js
|
|
10778
|
+
var makeListIssueCommentsContract = (ids) => {
|
|
10779
|
+
const input = object({
|
|
10780
|
+
issueId: ids.issue.describe("The bug report, blocker, or coverage request whose comments to list."),
|
|
10781
|
+
...makePaginationInputFields({ defaultLimit: 50, maxLimit: 200 })
|
|
10782
|
+
});
|
|
10783
|
+
const output = object({
|
|
10784
|
+
comments: array(makeIssueCommentResourceSchema(ids)).describe("The issue's comments, oldest first."),
|
|
10785
|
+
nextCursor: nextCursorSchema
|
|
10786
|
+
});
|
|
10787
|
+
return {
|
|
10788
|
+
annotationJustifications: {
|
|
10789
|
+
destructiveHint: "Does not edit the issue or its comments.",
|
|
10790
|
+
openWorldHint: "Reads QA Wolf comments without reading or changing linked trackers.",
|
|
10791
|
+
readOnlyHint: "Lists the comments on one issue."
|
|
10792
|
+
},
|
|
10793
|
+
annotations: {
|
|
10794
|
+
destructiveHint: false,
|
|
10795
|
+
openWorldHint: false,
|
|
10796
|
+
readOnlyHint: true
|
|
10797
|
+
},
|
|
10798
|
+
description: "List the comments on a bug report, blocker (issue type `maintenance`), or coverage request, oldest first, with who wrote each one.",
|
|
10799
|
+
input,
|
|
10800
|
+
kind: "read",
|
|
10801
|
+
name: "issue.listComments",
|
|
10802
|
+
output
|
|
10803
|
+
};
|
|
10804
|
+
};
|
|
10805
|
+
|
|
10485
10806
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
|
|
10486
10807
|
var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
10487
10808
|
const input = object({
|
|
@@ -10546,6 +10867,21 @@ var makeUpdateIssueContract = (ids) => {
|
|
|
10546
10867
|
};
|
|
10547
10868
|
};
|
|
10548
10869
|
|
|
10870
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/contracts.js
|
|
10871
|
+
var makeIssueContracts = (ids) => ({
|
|
10872
|
+
addFlows: makeAddFlowsToIssueContract(ids),
|
|
10873
|
+
attachFiles: makeAttachFilesToIssueContract(ids),
|
|
10874
|
+
comment: makeCommentOnIssueContract(ids),
|
|
10875
|
+
create: makeCreateIssueContract(ids),
|
|
10876
|
+
decideSuggestion: makeDecideSuggestionContract(ids),
|
|
10877
|
+
find: makeFindIssuesContract(ids),
|
|
10878
|
+
get: makeGetIssueContract(ids),
|
|
10879
|
+
listActivity: makeListIssueActivityContract(ids),
|
|
10880
|
+
listComments: makeListIssueCommentsContract(ids),
|
|
10881
|
+
removeFlows: makeRemoveFlowsFromIssueContract(ids),
|
|
10882
|
+
update: makeUpdateIssueContract(ids)
|
|
10883
|
+
});
|
|
10884
|
+
|
|
10549
10885
|
// node_modules/@qawolf/api-contracts/dist/v1/legacyTrigger/resource.js
|
|
10550
10886
|
var namedIdentity = object({ id: string2(), name: string2() });
|
|
10551
10887
|
var branchScope = union([
|
|
@@ -10695,6 +11031,7 @@ var makeConnectMcpServerContract = (ids) => {
|
|
|
10695
11031
|
});
|
|
10696
11032
|
const output = object({
|
|
10697
11033
|
authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
|
|
11034
|
+
connectionName: string2().describe("The name of the workspace connection the sign-in authorizes. It differs from serverName when the workspace already reaches the server under another name and that connection needs authorizing again."),
|
|
10698
11035
|
serverName: string2().describe("The catalog name of the server.")
|
|
10699
11036
|
});
|
|
10700
11037
|
return {
|
|
@@ -10899,12 +11236,46 @@ var makeFlowFailureSchema = (ids) => {
|
|
|
10899
11236
|
});
|
|
10900
11237
|
};
|
|
10901
11238
|
|
|
11239
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
|
|
11240
|
+
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
11241
|
+
var attemptCount = number2().int().positive().describe("How many attempts reported it.");
|
|
11242
|
+
var runBuildVersionSchema = object({
|
|
11243
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
|
|
11244
|
+
expected: object({
|
|
11245
|
+
buildId: buildIdSchema,
|
|
11246
|
+
version: string2().optional()
|
|
11247
|
+
}).optional().describe("The run's build of this app. Absent for an app it got none of."),
|
|
11248
|
+
kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings."),
|
|
11249
|
+
observed: array(object({
|
|
11250
|
+
attempts: attemptCount,
|
|
11251
|
+
buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
|
|
11252
|
+
version: string2().optional()
|
|
11253
|
+
})).describe("What attempts installed, one entry per build or version."),
|
|
11254
|
+
platform: buildPlatformSchema,
|
|
11255
|
+
unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
|
|
11256
|
+
warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app. notTested: attempts reported installs on this platform, but none installed the run's build. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
|
|
11257
|
+
});
|
|
11258
|
+
var runSiteVersionSchema = object({
|
|
11259
|
+
expected: object({
|
|
11260
|
+
from: extensibleValue(["deployment", "latestDeployment"], "deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run."),
|
|
11261
|
+
version: string2().describe("The deployed commit.")
|
|
11262
|
+
}).optional().describe("The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service."),
|
|
11263
|
+
observed: array(object({
|
|
11264
|
+
attempts: attemptCount,
|
|
11265
|
+
source: extensibleValue(["header", "meta", "versionPath", "frameworkBuildId", "fingerprint"], "Where the attempt read the version."),
|
|
11266
|
+
version: string2()
|
|
11267
|
+
})).describe("What attempts saw, one entry per version and source."),
|
|
11268
|
+
origin: string2().describe("The site origin the attempts visited."),
|
|
11269
|
+
warnings: array(extensibleValue(["changedDuringRun", "unexpectedVersion"], "changedDuringRun: attempts saw different versions from one source. unexpectedVersion: the site served another commit than expected.")).describe("Why the site may not be the version the run should test.")
|
|
11270
|
+
});
|
|
11271
|
+
|
|
10902
11272
|
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
10903
11273
|
var makeGetRunContract = (ids) => {
|
|
10904
11274
|
const flowStatus = _enum(publicRunStatusValues);
|
|
10905
11275
|
const input = object({
|
|
10906
11276
|
flowStatuses: array(flowStatus).min(1).optional().describe("Return only the flows whose status is one of these. A suite run can " + "hold hundreds of flows, so start an investigation with failed " + "alone. A flow that passed after a retry reads passed, so add " + "passed when a flaky flow is missing from the answer. Omit to " + "return every flow. The run-level fields are unaffected."),
|
|
10907
|
-
runId: ids.run
|
|
11277
|
+
runId: ids.run,
|
|
11278
|
+
waitSeconds: number2().int().min(0).optional().describe(`How long the server may hold this check open, in seconds, waiting for the run's status to change. Defaults to 0, which answers at once. A larger value clamps to ${maxAgentWaitSeconds}, or to ${maxAgentWaitSecondsWithProgress} when the call carries a progress token. Pass more than ${maxAgentWaitSeconds} only when your instructions say your client keeps the call open while progress arrives. A held check answers the moment the status changes, and at once when the run is already terminal. A held check also waits while the run is still being created.`)
|
|
10908
11279
|
});
|
|
10909
11280
|
const attempts = makeFlowAttemptsSchema(ids);
|
|
10910
11281
|
const failedFlow = object({
|
|
@@ -10925,8 +11296,12 @@ var makeGetRunContract = (ids) => {
|
|
|
10925
11296
|
...makeRunSummaryFields(ids),
|
|
10926
11297
|
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
11298
|
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
11299
|
+
buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
|
|
10928
11300
|
flows,
|
|
10929
|
-
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
|
|
11301
|
+
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."),
|
|
11302
|
+
siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
|
|
11303
|
+
waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
|
|
11304
|
+
wokeOn: runWakeReasonSchema.optional()
|
|
10930
11305
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
10931
11306
|
return {
|
|
10932
11307
|
annotationJustifications: {
|
|
@@ -10939,7 +11314,7 @@ var makeGetRunContract = (ids) => {
|
|
|
10939
11314
|
openWorldHint: false,
|
|
10940
11315
|
readOnlyHint: true
|
|
10941
11316
|
},
|
|
10942
|
-
description:
|
|
11317
|
+
description: `Get a run's status, per-flow results, links, and how many of its bugs are blocking. Call it without waitSeconds for an immediate answer. To wait on a run that is still queued or running, pass waitSeconds up to ${maxAgentWaitSeconds}: the server holds the check open and answers the moment the status changes. A held check also waits while the run is still being created. After a held check returns, call again only while status is queued or running. Stop when status is passed, failed, canceled, or superseded.`,
|
|
10943
11318
|
input,
|
|
10944
11319
|
kind: "read",
|
|
10945
11320
|
name: "run.get",
|
|
@@ -11276,7 +11651,7 @@ var makeLaunchRunnerContract = (ids) => {
|
|
|
11276
11651
|
openWorldHint: true,
|
|
11277
11652
|
readOnlyHint: false
|
|
11278
11653
|
},
|
|
11279
|
-
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one,
|
|
11654
|
+
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one, whatever runnerName is sent, so read `runnerName` in the answer for what is running. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner, so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running, and launching the same id again attaches to it.",
|
|
11280
11655
|
input,
|
|
11281
11656
|
kind: "write",
|
|
11282
11657
|
name: "runner.launch",
|
|
@@ -11424,17 +11799,14 @@ var unchangedFilesSchema = record(string2(), string2().min(1)).superRefine((hash
|
|
|
11424
11799
|
var makeRunFlowOnRunnerContract = (ids) => {
|
|
11425
11800
|
const input = object({
|
|
11426
11801
|
entryPointPath: runFilePathSchema.describe("Path of the flow file to run, as it appears in `files`."),
|
|
11427
|
-
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run."),
|
|
11428
|
-
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit
|
|
11802
|
+
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run. With `environmentId`, they are added on top of that environment's variables for this run only, replacing any of the same name; the environment itself is not changed."),
|
|
11803
|
+
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit`; `env` cannot replace these three."),
|
|
11429
11804
|
files: runFilesSchema.describe("Every file the run needs keyed by its path — the flow file, everything it imports, package.json and tsconfig.json. A runner holds no copy of your project, so what runs is exactly what is sent here."),
|
|
11430
11805
|
flowId: ids.flow.optional().describe("The QA Wolf flow this run is for. The run then sees it as `QAWOLF_WORKFLOW_ID`, the same value a platform run of that flow sees, so fixtures named and cleaned up by it match across both. Omitted, the flow whose file is at `entryPointPath` on the named environment's flow-code branch stands in; a file not in QA Wolf yet, or a run given no environment, leaves the run with no `QAWOLF_WORKFLOW_ID`."),
|
|
11431
11806
|
id: runnerIdSchema.describe("Id of the runner to run the flow on."),
|
|
11432
11807
|
selection: runSelectionSchema.optional().describe("Run only these lines, inside the page the runner is already on, instead of running the whole flow from a fresh browser. Omit to run the whole entry point."),
|
|
11433
11808
|
unchangedFiles: unchangedFilesSchema.optional().describe("Files this runner already holds from an earlier run, keyed by path with a hex SHA-256 of the content it should hold. Send this to make `files` only what changed. The runner refuses with `needs-full-sync` if it holds none of a referenced path, so it never runs something other than what was asked for. Omit it to send every file."),
|
|
11434
11809
|
workspaceId: ids.workspace.optional().describe(runnerWorkspaceIdDescription)
|
|
11435
|
-
}).refine((request) => request.env === undefined || request.environmentId === undefined, {
|
|
11436
|
-
error: "Send env or environmentId, not both. An environment's variables are taken as they are stored, so there is no order in which the two would combine.",
|
|
11437
|
-
path: ["environmentId"]
|
|
11438
11810
|
}).refine((request) => Object.hasOwn(request.files, request.entryPointPath), {
|
|
11439
11811
|
error: "The entry point must be one of the files.",
|
|
11440
11812
|
path: ["files"]
|
|
@@ -11679,6 +12051,9 @@ var makeContractsV1 = (ids) => {
|
|
|
11679
12051
|
runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
|
|
11680
12052
|
};
|
|
11681
12053
|
return {
|
|
12054
|
+
activity: {
|
|
12055
|
+
wait: makeActivityWaitContract(resolvedIds)
|
|
12056
|
+
},
|
|
11682
12057
|
agent: {
|
|
11683
12058
|
get: makeAgentGetContract(resolvedIds),
|
|
11684
12059
|
send: makeAgentSendContract(resolvedIds)
|
|
@@ -11721,16 +12096,7 @@ var makeContractsV1 = (ids) => {
|
|
|
11721
12096
|
update: makeUpdateFlowContract(resolvedIds)
|
|
11722
12097
|
},
|
|
11723
12098
|
investigation: makeInvestigationContracts(resolvedIds),
|
|
11724
|
-
issue:
|
|
11725
|
-
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
11726
|
-
create: makeCreateIssueContract(resolvedIds),
|
|
11727
|
-
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
11728
|
-
find: makeFindIssuesContract(resolvedIds),
|
|
11729
|
-
get: makeGetIssueContract(resolvedIds),
|
|
11730
|
-
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
11731
|
-
removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
|
|
11732
|
-
update: makeUpdateIssueContract(resolvedIds)
|
|
11733
|
-
},
|
|
12099
|
+
issue: makeIssueContracts(resolvedIds),
|
|
11734
12100
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
11735
12101
|
mcpServer: {
|
|
11736
12102
|
connect: makeConnectMcpServerContract(resolvedIds)
|
|
@@ -16507,4 +16873,4 @@ export {
|
|
|
16507
16873
|
createRunnerSdk
|
|
16508
16874
|
};
|
|
16509
16875
|
|
|
16510
|
-
//# debugId=
|
|
16876
|
+
//# debugId=B5473BEAD8EDFE4164756E2164756E21
|