@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/cli.js
CHANGED
|
@@ -16878,6 +16878,7 @@ var agentReplySchema = object({
|
|
|
16878
16878
|
|
|
16879
16879
|
// node_modules/@qawolf/api-contracts/dist/v1/agent/wait.js
|
|
16880
16880
|
var maxAgentWaitSeconds = 45;
|
|
16881
|
+
var maxAgentWaitSecondsWithProgress = 170;
|
|
16881
16882
|
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.');
|
|
16882
16883
|
|
|
16883
16884
|
// node_modules/@qawolf/api-contracts/dist/v1/run/summary.js
|
|
@@ -16910,6 +16911,54 @@ var makeRunSummaryFields = (ids) => ({
|
|
|
16910
16911
|
}).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.")
|
|
16911
16912
|
});
|
|
16912
16913
|
|
|
16914
|
+
// node_modules/@qawolf/api-contracts/dist/v1/activity/wait.js
|
|
16915
|
+
var maxActivityWaitItems = 50;
|
|
16916
|
+
var makeActivityWaitContract = (ids) => {
|
|
16917
|
+
const cursors = record(string2().min(1), string2().min(1));
|
|
16918
|
+
const runIds = array(ids.run);
|
|
16919
|
+
const sessionIds = array(ids.chatSession);
|
|
16920
|
+
const input = object({
|
|
16921
|
+
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."),
|
|
16922
|
+
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.`),
|
|
16923
|
+
sessionIds: sessionIds.max(maxActivityWaitItems).optional().describe("The Tester sessions you are waiting on, as agent.send answered with."),
|
|
16924
|
+
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.`)
|
|
16925
|
+
});
|
|
16926
|
+
const output = object({
|
|
16927
|
+
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."),
|
|
16928
|
+
runs: array(object({
|
|
16929
|
+
finished: boolean2().describe("True once the status is passed, failed, canceled, superseded or not-found. A finished run never changes again."),
|
|
16930
|
+
runId: ids.run.describe("The run id you sent."),
|
|
16931
|
+
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.`),
|
|
16932
|
+
url: string2().optional().describe("Absolute URL of the run page. Absent while the run is still being created, and when it is not found.")
|
|
16933
|
+
})).describe("Every run you sent, in the order you sent them."),
|
|
16934
|
+
sessions: array(object({
|
|
16935
|
+
nextCursor: string2().min(1).describe("Send back under this session's id in cursors to read only what follows."),
|
|
16936
|
+
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."),
|
|
16937
|
+
sessionId: ids.chatSession,
|
|
16938
|
+
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.')
|
|
16939
|
+
})).describe("Every session you sent, in the order you sent them."),
|
|
16940
|
+
waitSeconds: number2().int().describe("The hold this call was allowed, in seconds, after clamping."),
|
|
16941
|
+
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.')
|
|
16942
|
+
});
|
|
16943
|
+
return {
|
|
16944
|
+
annotationJustifications: {
|
|
16945
|
+
destructiveHint: "Does not cancel work, stop runs or edit tests.",
|
|
16946
|
+
openWorldHint: "Reads QA Wolf sessions and runs without posting to external services.",
|
|
16947
|
+
readOnlyHint: "Retrieves session replies and statuses and run statuses without sending work."
|
|
16948
|
+
},
|
|
16949
|
+
annotations: {
|
|
16950
|
+
destructiveHint: false,
|
|
16951
|
+
openWorldHint: false,
|
|
16952
|
+
readOnlyHint: true
|
|
16953
|
+
},
|
|
16954
|
+
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.`,
|
|
16955
|
+
input,
|
|
16956
|
+
kind: "read",
|
|
16957
|
+
name: "activity.wait",
|
|
16958
|
+
output
|
|
16959
|
+
};
|
|
16960
|
+
};
|
|
16961
|
+
|
|
16913
16962
|
// node_modules/@qawolf/api-contracts/dist/v1/deployment/didNotRunReason.js
|
|
16914
16963
|
var didNotRunReasonSchema = _enum([
|
|
16915
16964
|
"billing-prevented",
|
|
@@ -17133,6 +17182,16 @@ var defaultIdSchemas = {
|
|
|
17133
17182
|
};
|
|
17134
17183
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
17135
17184
|
|
|
17185
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/files.js
|
|
17186
|
+
var maxAttachedFilesPerRequest = 10;
|
|
17187
|
+
var attachedFilePathsSchema = array(teamStoragePathSchema).min(1).max(maxAttachedFilesPerRequest).refine((filePaths) => new Set(filePaths).size === filePaths.length, "filePaths must be unique");
|
|
17188
|
+
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.";
|
|
17189
|
+
var issueFileSchema = object({
|
|
17190
|
+
fileId: string2().describe("The id of the attached file."),
|
|
17191
|
+
name: string2().describe("The file's name, taken from the last segment of the path it was attached from."),
|
|
17192
|
+
sizeBytes: number2().int().nonnegative()
|
|
17193
|
+
});
|
|
17194
|
+
|
|
17136
17195
|
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
17137
17196
|
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
17138
17197
|
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.");
|
|
@@ -17287,6 +17346,9 @@ var makeListScreenshotComparisonsContract = (ids) => {
|
|
|
17287
17346
|
};
|
|
17288
17347
|
};
|
|
17289
17348
|
|
|
17349
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/wait.js
|
|
17350
|
+
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.`);
|
|
17351
|
+
|
|
17290
17352
|
// node_modules/@qawolf/api-contracts/dist/v1/runner/actionSequence.js
|
|
17291
17353
|
var maxActionsPerRequest = 10;
|
|
17292
17354
|
var screenshotModes = ["none", "final", "each"];
|
|
@@ -18069,6 +18131,13 @@ var runSelectionSchema = object({
|
|
|
18069
18131
|
error: "A selection's startLine must not be after its endLine.",
|
|
18070
18132
|
path: ["startLine"]
|
|
18071
18133
|
});
|
|
18134
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatFields.js
|
|
18135
|
+
var triggerScheduleRepeatFields = {
|
|
18136
|
+
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."),
|
|
18137
|
+
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."),
|
|
18138
|
+
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.')
|
|
18139
|
+
};
|
|
18140
|
+
|
|
18072
18141
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configuration.js
|
|
18073
18142
|
var isTimezone = (value) => {
|
|
18074
18143
|
try {
|
|
@@ -18078,7 +18147,7 @@ var isTimezone = (value) => {
|
|
|
18078
18147
|
return false;
|
|
18079
18148
|
}
|
|
18080
18149
|
};
|
|
18081
|
-
var triggerCadenceSchema = _enum(["hourly", "daily", "weekly"]).describe("How often the schedule fires.");
|
|
18150
|
+
var triggerCadenceSchema = _enum(["hourly", "daily", "weekly", "monthly"]).describe("How often the schedule fires.");
|
|
18082
18151
|
var triggerDayOfWeekSchema = _enum([
|
|
18083
18152
|
"monday",
|
|
18084
18153
|
"tuesday",
|
|
@@ -18106,11 +18175,74 @@ var makeTriggerScheduleFields = (ids) => ({
|
|
|
18106
18175
|
message: "Expected each day to be named at most once."
|
|
18107
18176
|
}).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."),
|
|
18108
18177
|
environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
|
|
18178
|
+
...triggerScheduleRepeatFields,
|
|
18109
18179
|
minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
|
|
18110
|
-
timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily or
|
|
18180
|
+
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.'),
|
|
18111
18181
|
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.")
|
|
18112
18182
|
});
|
|
18113
18183
|
|
|
18184
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatRules.js
|
|
18185
|
+
var hourlyEveryValues = [1, 2, 3, 4, 6, 8, 12];
|
|
18186
|
+
var maxEvery = {
|
|
18187
|
+
daily: 31,
|
|
18188
|
+
monthly: 12,
|
|
18189
|
+
weekly: 12
|
|
18190
|
+
};
|
|
18191
|
+
var dayOfWeekNames = [
|
|
18192
|
+
"sunday",
|
|
18193
|
+
"monday",
|
|
18194
|
+
"tuesday",
|
|
18195
|
+
"wednesday",
|
|
18196
|
+
"thursday",
|
|
18197
|
+
"friday",
|
|
18198
|
+
"saturday"
|
|
18199
|
+
];
|
|
18200
|
+
var calendarDayOf = (startDate) => {
|
|
18201
|
+
const date = new Date(`${startDate}T00:00:00Z`);
|
|
18202
|
+
return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(startDate) ? date : undefined;
|
|
18203
|
+
};
|
|
18204
|
+
var everyIssue = (value, every) => {
|
|
18205
|
+
if (value.cadence === "hourly") {
|
|
18206
|
+
return hourlyEveryValues.includes(every) ? undefined : "every must divide a day evenly when cadence is hourly: 1, 2, 3, 4, 6, 8 or 12.";
|
|
18207
|
+
}
|
|
18208
|
+
const max = maxEvery[value.cadence];
|
|
18209
|
+
return every > max ? `every is at most ${max} when cadence is ${value.cadence}.` : undefined;
|
|
18210
|
+
};
|
|
18211
|
+
var startDateIssue = (value, startDate) => {
|
|
18212
|
+
const day = calendarDayOf(startDate);
|
|
18213
|
+
if (day === undefined)
|
|
18214
|
+
return "startDate must be a real calendar date.";
|
|
18215
|
+
if (value.cadence === "weekly" && value.dayOfWeek !== undefined && dayOfWeekNames[day.getUTCDay()] !== value.dayOfWeek)
|
|
18216
|
+
return "startDate must fall on dayOfWeek.";
|
|
18217
|
+
if (value.cadence === "monthly" && value.dayOfMonth !== undefined && day.getUTCDate() !== value.dayOfMonth)
|
|
18218
|
+
return "startDate must fall on dayOfMonth.";
|
|
18219
|
+
return;
|
|
18220
|
+
};
|
|
18221
|
+
var checkScheduleRepeat = (value, ctx) => {
|
|
18222
|
+
const every = value.every ?? 1;
|
|
18223
|
+
const issue = (message, field) => ctx.addIssue({ code: "custom", message, path: [field] });
|
|
18224
|
+
const everyMessage = everyIssue(value, every);
|
|
18225
|
+
if (everyMessage !== undefined)
|
|
18226
|
+
issue(everyMessage, "every");
|
|
18227
|
+
if (value.cadence === "hourly")
|
|
18228
|
+
return;
|
|
18229
|
+
if (every > 1 && value.daysOfWeek !== undefined)
|
|
18230
|
+
issue("daysOfWeek applies only when every is 1.", "daysOfWeek");
|
|
18231
|
+
if (every > 1 && value.startDate === undefined) {
|
|
18232
|
+
issue("startDate is required when every is more than 1.", "startDate");
|
|
18233
|
+
return;
|
|
18234
|
+
}
|
|
18235
|
+
if (value.startDate === undefined)
|
|
18236
|
+
return;
|
|
18237
|
+
if (every === 1) {
|
|
18238
|
+
issue("startDate applies only when every is more than 1.", "startDate");
|
|
18239
|
+
return;
|
|
18240
|
+
}
|
|
18241
|
+
const startDateMessage = startDateIssue(value, value.startDate);
|
|
18242
|
+
if (startDateMessage !== undefined)
|
|
18243
|
+
issue(startDateMessage, "startDate");
|
|
18244
|
+
};
|
|
18245
|
+
|
|
18114
18246
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
|
|
18115
18247
|
var checkAction = (action, ctx) => {
|
|
18116
18248
|
const namesFlows = action.flowIds.length + action.tagNames.length > 0;
|
|
@@ -18142,24 +18274,32 @@ var checkAction = (action, ctx) => {
|
|
|
18142
18274
|
var requiredScheduleFields = {
|
|
18143
18275
|
daily: ["timeOfDay", "timezoneId"],
|
|
18144
18276
|
hourly: ["timezoneId"],
|
|
18277
|
+
monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
|
|
18145
18278
|
weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
|
|
18146
18279
|
};
|
|
18147
18280
|
var optionalScheduleFields = {
|
|
18148
|
-
daily: ["daysOfWeek"],
|
|
18149
|
-
hourly: ["daysOfWeek", "minuteOfHour"],
|
|
18150
|
-
|
|
18281
|
+
daily: ["daysOfWeek", "every", "startDate"],
|
|
18282
|
+
hourly: ["daysOfWeek", "every", "minuteOfHour"],
|
|
18283
|
+
monthly: ["every", "startDate"],
|
|
18284
|
+
weekly: ["every", "startDate"]
|
|
18151
18285
|
};
|
|
18152
18286
|
var cadencesUsingField = {
|
|
18287
|
+
dayOfMonth: "a monthly cadence",
|
|
18153
18288
|
dayOfWeek: "a weekly cadence",
|
|
18154
18289
|
daysOfWeek: "an hourly or daily cadence",
|
|
18290
|
+
every: "any cadence",
|
|
18155
18291
|
minuteOfHour: "an hourly cadence",
|
|
18156
|
-
|
|
18157
|
-
|
|
18292
|
+
startDate: "a daily, weekly or monthly cadence",
|
|
18293
|
+
timeOfDay: "a daily, weekly or monthly cadence",
|
|
18294
|
+
timezoneId: "an hourly, daily, weekly or monthly cadence"
|
|
18158
18295
|
};
|
|
18159
18296
|
var scheduleFields = [
|
|
18297
|
+
"dayOfMonth",
|
|
18160
18298
|
"dayOfWeek",
|
|
18161
18299
|
"daysOfWeek",
|
|
18300
|
+
"every",
|
|
18162
18301
|
"minuteOfHour",
|
|
18302
|
+
"startDate",
|
|
18163
18303
|
"timeOfDay",
|
|
18164
18304
|
"timezoneId"
|
|
18165
18305
|
];
|
|
@@ -18189,6 +18329,7 @@ var checkScheduleFields = (value, ctx) => {
|
|
|
18189
18329
|
};
|
|
18190
18330
|
var checkSchedule = (value, ctx) => {
|
|
18191
18331
|
checkScheduleFields(value, ctx);
|
|
18332
|
+
checkScheduleRepeat(value, ctx);
|
|
18192
18333
|
if (value.action.kind === "generativeSuite") {
|
|
18193
18334
|
ctx.addIssue({
|
|
18194
18335
|
code: "custom",
|
|
@@ -18467,7 +18608,7 @@ var makeAgentGetContract = (ids) => {
|
|
|
18467
18608
|
const input = object({
|
|
18468
18609
|
cursor: string2().min(1).optional().describe("Opaque cursor copied from this same session's previous nextCursor. Omit to read from its first reply."),
|
|
18469
18610
|
sessionId: ids.chatSession.describe("The id agent.send answered with."),
|
|
18470
|
-
waitSeconds: number2().int().min(0).optional().describe(`How long the server may hold this check open, in seconds. Defaults to ${maxAgentWaitSeconds}
|
|
18611
|
+
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.`)
|
|
18471
18612
|
});
|
|
18472
18613
|
const output = resource({
|
|
18473
18614
|
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."),
|
|
@@ -18490,7 +18631,7 @@ var makeAgentGetContract = (ids) => {
|
|
|
18490
18631
|
openWorldHint: false,
|
|
18491
18632
|
readOnlyHint: true
|
|
18492
18633
|
},
|
|
18493
|
-
description:
|
|
18634
|
+
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.`,
|
|
18494
18635
|
input,
|
|
18495
18636
|
kind: "read",
|
|
18496
18637
|
name: "agent.get",
|
|
@@ -18742,6 +18883,36 @@ var makeListBuildsContract = (ids) => {
|
|
|
18742
18883
|
};
|
|
18743
18884
|
};
|
|
18744
18885
|
|
|
18886
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestDownload.js
|
|
18887
|
+
var makeRequestBuildDownloadContract = (ids) => {
|
|
18888
|
+
const input = object({
|
|
18889
|
+
buildId: buildIdSchema,
|
|
18890
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18891
|
+
});
|
|
18892
|
+
const output = object({
|
|
18893
|
+
expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
|
|
18894
|
+
fileName: string2().describe("The name of the build's file."),
|
|
18895
|
+
readUrl: string2().describe('Fetch the build\'s file from here, for example `curl -o app.apk "<readUrl>"`.')
|
|
18896
|
+
});
|
|
18897
|
+
return {
|
|
18898
|
+
annotationJustifications: {
|
|
18899
|
+
destructiveHint: "Does not change the build or its file.",
|
|
18900
|
+
openWorldHint: "Access is limited to the build files of the authorized workspace.",
|
|
18901
|
+
readOnlyHint: "Returns an expiring read URL for a build's file."
|
|
18902
|
+
},
|
|
18903
|
+
annotations: {
|
|
18904
|
+
destructiveHint: false,
|
|
18905
|
+
openWorldHint: false,
|
|
18906
|
+
readOnlyHint: true
|
|
18907
|
+
},
|
|
18908
|
+
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.",
|
|
18909
|
+
input,
|
|
18910
|
+
kind: "read",
|
|
18911
|
+
name: "build.requestDownload",
|
|
18912
|
+
output
|
|
18913
|
+
};
|
|
18914
|
+
};
|
|
18915
|
+
|
|
18745
18916
|
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
18746
18917
|
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
18747
18918
|
var makeRequestBuildUploadContract = (ids) => {
|
|
@@ -18782,6 +18953,7 @@ var makeBuildContracts = (ids) => ({
|
|
|
18782
18953
|
delete: makeDeleteBuildContract(ids),
|
|
18783
18954
|
get: makeGetBuildContract(ids),
|
|
18784
18955
|
list: makeListBuildsContract(ids),
|
|
18956
|
+
requestDownload: makeRequestBuildDownloadContract(ids),
|
|
18785
18957
|
requestUpload: makeRequestBuildUploadContract(ids)
|
|
18786
18958
|
});
|
|
18787
18959
|
|
|
@@ -19389,6 +19561,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
19389
19561
|
});
|
|
19390
19562
|
const output = object({
|
|
19391
19563
|
missingNames: array(string2()).describe("Requested names the environment does not have, sorted alphabetically."),
|
|
19564
|
+
secretNames: array(string2()).describe("Requested names that hold write-only secrets, sorted alphabetically. Their values are never returned; flows still receive them at run time."),
|
|
19392
19565
|
variables: array(object({
|
|
19393
19566
|
name: string2().describe("The stored variable name."),
|
|
19394
19567
|
value: string2().describe("The variable's secret value. Handle as a secret.")
|
|
@@ -19405,7 +19578,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
|
|
|
19405
19578
|
openWorldHint: false,
|
|
19406
19579
|
readOnlyHint: true
|
|
19407
19580
|
},
|
|
19408
|
-
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and
|
|
19581
|
+
description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and write-only secrets go to secretNames; neither fails the call.",
|
|
19409
19582
|
input,
|
|
19410
19583
|
kind: "read",
|
|
19411
19584
|
name: "environment.getVariable",
|
|
@@ -19818,13 +19991,7 @@ var makeUpdateFlowContract = (ids) => {
|
|
|
19818
19991
|
};
|
|
19819
19992
|
|
|
19820
19993
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/index.js
|
|
19821
|
-
var issuePrioritySchema = _enum([
|
|
19822
|
-
"unprioritized",
|
|
19823
|
-
"low",
|
|
19824
|
-
"medium",
|
|
19825
|
-
"high",
|
|
19826
|
-
"urgent"
|
|
19827
|
-
]);
|
|
19994
|
+
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.");
|
|
19828
19995
|
var issueStatusSchema = _enum([
|
|
19829
19996
|
"backlog",
|
|
19830
19997
|
"pending",
|
|
@@ -19845,6 +20012,7 @@ var makeIssueResourceSchema = (ids) => resource({
|
|
|
19845
20012
|
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
|
|
19846
20013
|
createdAt: exports_coerce.date().describe("When the issue was created."),
|
|
19847
20014
|
description: string2().describe("The issue description in Markdown."),
|
|
20015
|
+
files: array(issueFileSchema).default([]).describe("Files attached to a bug report, oldest first. Always empty on blockers and coverage requests."),
|
|
19848
20016
|
issueId: ids.issue,
|
|
19849
20017
|
name: string2(),
|
|
19850
20018
|
number: number2().int(),
|
|
@@ -20023,6 +20191,51 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
20023
20191
|
};
|
|
20024
20192
|
};
|
|
20025
20193
|
|
|
20194
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/answer.js
|
|
20195
|
+
var maxAnswersPerCall = 50;
|
|
20196
|
+
var findingIdSchema = string2().min(1).max(80);
|
|
20197
|
+
var findingIdsOf = ({ answers = {}, replies = {} }) => [
|
|
20198
|
+
...Object.keys(answers),
|
|
20199
|
+
...Object.keys(replies)
|
|
20200
|
+
];
|
|
20201
|
+
var makeAnswerInvestigationQuestionsContract = (ids) => {
|
|
20202
|
+
const input = object({
|
|
20203
|
+
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."),
|
|
20204
|
+
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."),
|
|
20205
|
+
runId: ids.run
|
|
20206
|
+
}).refine((sent) => findingIdsOf(sent).length > 0, {
|
|
20207
|
+
message: "Send at least one answer or reply."
|
|
20208
|
+
}).refine((sent) => findingIdsOf(sent).length <= maxAnswersPerCall, {
|
|
20209
|
+
message: `Send at most ${maxAnswersPerCall} answers and replies in one call.`
|
|
20210
|
+
}).refine((sent) => new Set(findingIdsOf(sent)).size === findingIdsOf(sent).length, { message: "Answer each question once, as an answer or as a reply." });
|
|
20211
|
+
const output = resource({
|
|
20212
|
+
answeredFindingIds: array(string2()).describe("The questions this call answered. The investigation receives the answers and acts on them."),
|
|
20213
|
+
refused: array(object({
|
|
20214
|
+
findingId: string2(),
|
|
20215
|
+
message: string2().describe("Why the answer was not recorded."),
|
|
20216
|
+
reason: string2().describe('Known values: "answer-not-offered", "environment-terminated", "not-asking", "not-found", "response-pending" and "superseded". New values can appear.')
|
|
20217
|
+
})).describe("The answers that were not recorded."),
|
|
20218
|
+
runId: ids.run
|
|
20219
|
+
}, { urlFieldDescription: "The run in the QA Wolf app." });
|
|
20220
|
+
return {
|
|
20221
|
+
annotationJustifications: {
|
|
20222
|
+
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.",
|
|
20223
|
+
openWorldHint: "A bug report the investigation files from an answer can reach the workspace's configured integrations.",
|
|
20224
|
+
readOnlyHint: "Records answers to the questions of a run's investigation."
|
|
20225
|
+
},
|
|
20226
|
+
annotations: {
|
|
20227
|
+
destructiveHint: true,
|
|
20228
|
+
openWorldHint: true,
|
|
20229
|
+
readOnlyHint: false
|
|
20230
|
+
},
|
|
20231
|
+
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.",
|
|
20232
|
+
input,
|
|
20233
|
+
kind: "write",
|
|
20234
|
+
name: "investigation.question.answer",
|
|
20235
|
+
output
|
|
20236
|
+
};
|
|
20237
|
+
};
|
|
20238
|
+
|
|
20026
20239
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
|
|
20027
20240
|
var makeFindInvestigationQuestionsContract = (ids) => {
|
|
20028
20241
|
const input = object({
|
|
@@ -20040,7 +20253,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
20040
20253
|
headline: string2().optional(),
|
|
20041
20254
|
question: investigationQuestionSchema,
|
|
20042
20255
|
runId: ids.run,
|
|
20043
|
-
sessionId: ids.chatSession.describe("The investigation session.
|
|
20256
|
+
sessionId: ids.chatSession.describe("The investigation session. Read what it is doing with agent.get."),
|
|
20044
20257
|
summary: string2().optional()
|
|
20045
20258
|
}, { 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.")
|
|
20046
20259
|
});
|
|
@@ -20055,7 +20268,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
20055
20268
|
openWorldHint: false,
|
|
20056
20269
|
readOnlyHint: true
|
|
20057
20270
|
},
|
|
20058
|
-
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
|
|
20271
|
+
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.",
|
|
20059
20272
|
input,
|
|
20060
20273
|
kind: "read",
|
|
20061
20274
|
name: "investigation.question.find",
|
|
@@ -20065,6 +20278,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
|
|
|
20065
20278
|
|
|
20066
20279
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
|
|
20067
20280
|
var makeInvestigationQuestionContracts = (ids) => ({
|
|
20281
|
+
answer: makeAnswerInvestigationQuestionsContract(ids),
|
|
20068
20282
|
find: makeFindInvestigationQuestionsContract(ids)
|
|
20069
20283
|
});
|
|
20070
20284
|
|
|
@@ -20102,17 +20316,95 @@ var makeAddFlowsToIssueContract = (ids) => {
|
|
|
20102
20316
|
};
|
|
20103
20317
|
};
|
|
20104
20318
|
|
|
20319
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/attachFiles.js
|
|
20320
|
+
var makeAttachFilesToIssueContract = (ids) => {
|
|
20321
|
+
const input = object({
|
|
20322
|
+
filePaths: attachedFilePathsSchema.describe(attachedFilePathsDescription),
|
|
20323
|
+
issueId: ids.issue
|
|
20324
|
+
});
|
|
20325
|
+
const output = object({
|
|
20326
|
+
issue: makeIssueResourceSchema(ids)
|
|
20327
|
+
});
|
|
20328
|
+
return {
|
|
20329
|
+
annotationJustifications: {
|
|
20330
|
+
destructiveHint: "Adds files to the bug report without removing or replacing the ones already attached.",
|
|
20331
|
+
openWorldHint: "Copies files within QA Wolf storage without publishing anything outside QA Wolf.",
|
|
20332
|
+
readOnlyHint: "Copies files from the team's storage and attaches the copies to a bug report."
|
|
20333
|
+
},
|
|
20334
|
+
annotations: {
|
|
20335
|
+
destructiveHint: false,
|
|
20336
|
+
openWorldHint: false,
|
|
20337
|
+
readOnlyHint: false
|
|
20338
|
+
},
|
|
20339
|
+
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.",
|
|
20340
|
+
input,
|
|
20341
|
+
kind: "write",
|
|
20342
|
+
name: "issue.attachFiles",
|
|
20343
|
+
output
|
|
20344
|
+
};
|
|
20345
|
+
};
|
|
20346
|
+
|
|
20347
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/commentResource.js
|
|
20348
|
+
var issueCommentAuthorSchema = discriminatedUnion("type", [
|
|
20349
|
+
object({
|
|
20350
|
+
email: string2(),
|
|
20351
|
+
name: string2().optional().describe("Absent when the person has not set a name."),
|
|
20352
|
+
type: literal("user")
|
|
20353
|
+
}),
|
|
20354
|
+
object({ type: literal("former-user") }),
|
|
20355
|
+
object({ type: literal("team-api-key") }),
|
|
20356
|
+
object({ type: literal("system") })
|
|
20357
|
+
]).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`).");
|
|
20358
|
+
var makeIssueCommentResourceSchema = (ids) => resource({
|
|
20359
|
+
author: issueCommentAuthorSchema,
|
|
20360
|
+
body: string2().describe("The comment in GitHub-flavored Markdown."),
|
|
20361
|
+
commentId: string2().describe("The id of the comment."),
|
|
20362
|
+
createdAt: exports_coerce.date().describe("When the comment was written."),
|
|
20363
|
+
issueId: ids.issue.describe("The issue the comment is on."),
|
|
20364
|
+
viaQaWolfAi: boolean2().describe("Whether the author wrote the comment through QA Wolf AI.")
|
|
20365
|
+
}, { urlFieldDescription: "Absolute URL of the issue page." });
|
|
20366
|
+
|
|
20367
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/comment.js
|
|
20368
|
+
var maxCommentLength = 1e4;
|
|
20369
|
+
var makeCommentOnIssueContract = (ids) => {
|
|
20370
|
+
const input = object({
|
|
20371
|
+
body: string2().trim().min(1).max(maxCommentLength).describe("The comment in GitHub-flavored Markdown."),
|
|
20372
|
+
issueId: ids.issue.describe("The bug report, blocker, or coverage request to comment on.")
|
|
20373
|
+
});
|
|
20374
|
+
const output = object({
|
|
20375
|
+
comment: makeIssueCommentResourceSchema(ids)
|
|
20376
|
+
});
|
|
20377
|
+
return {
|
|
20378
|
+
annotationJustifications: {
|
|
20379
|
+
destructiveHint: "Adds a comment without removing or changing anything else on the issue.",
|
|
20380
|
+
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.",
|
|
20381
|
+
readOnlyHint: "Records a comment on the issue."
|
|
20382
|
+
},
|
|
20383
|
+
annotations: {
|
|
20384
|
+
destructiveHint: false,
|
|
20385
|
+
openWorldHint: false,
|
|
20386
|
+
readOnlyHint: false
|
|
20387
|
+
},
|
|
20388
|
+
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.",
|
|
20389
|
+
input,
|
|
20390
|
+
kind: "write",
|
|
20391
|
+
name: "issue.comment",
|
|
20392
|
+
output
|
|
20393
|
+
};
|
|
20394
|
+
};
|
|
20395
|
+
|
|
20105
20396
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
|
|
20106
20397
|
var makeCreateIssueContract = (ids) => {
|
|
20107
20398
|
const commonFields = {
|
|
20108
20399
|
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."),
|
|
20109
20400
|
name: string2().trim().min(1).max(255),
|
|
20110
|
-
priority: issuePrioritySchema.optional().describe(
|
|
20401
|
+
priority: issuePrioritySchema.optional().describe(`${issuePrioritySchema.description} Defaults to "unprioritized" for bug reports and coverage requests.`),
|
|
20111
20402
|
workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
|
|
20112
20403
|
};
|
|
20113
20404
|
const input = discriminatedUnion("type", [
|
|
20114
20405
|
object({
|
|
20115
20406
|
...commonFields,
|
|
20407
|
+
filePaths: attachedFilePathsSchema.optional().describe(attachedFilePathsDescription),
|
|
20116
20408
|
type: literal("bug")
|
|
20117
20409
|
}),
|
|
20118
20410
|
object({
|
|
@@ -20244,6 +20536,35 @@ var makeListIssueActivityContract = (ids) => {
|
|
|
20244
20536
|
};
|
|
20245
20537
|
};
|
|
20246
20538
|
|
|
20539
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/listComments.js
|
|
20540
|
+
var makeListIssueCommentsContract = (ids) => {
|
|
20541
|
+
const input = object({
|
|
20542
|
+
issueId: ids.issue.describe("The bug report, blocker, or coverage request whose comments to list."),
|
|
20543
|
+
...makePaginationInputFields({ defaultLimit: 50, maxLimit: 200 })
|
|
20544
|
+
});
|
|
20545
|
+
const output = object({
|
|
20546
|
+
comments: array(makeIssueCommentResourceSchema(ids)).describe("The issue's comments, oldest first."),
|
|
20547
|
+
nextCursor: nextCursorSchema
|
|
20548
|
+
});
|
|
20549
|
+
return {
|
|
20550
|
+
annotationJustifications: {
|
|
20551
|
+
destructiveHint: "Does not edit the issue or its comments.",
|
|
20552
|
+
openWorldHint: "Reads QA Wolf comments without reading or changing linked trackers.",
|
|
20553
|
+
readOnlyHint: "Lists the comments on one issue."
|
|
20554
|
+
},
|
|
20555
|
+
annotations: {
|
|
20556
|
+
destructiveHint: false,
|
|
20557
|
+
openWorldHint: false,
|
|
20558
|
+
readOnlyHint: true
|
|
20559
|
+
},
|
|
20560
|
+
description: "List the comments on a bug report, blocker (issue type `maintenance`), or coverage request, oldest first, with who wrote each one.",
|
|
20561
|
+
input,
|
|
20562
|
+
kind: "read",
|
|
20563
|
+
name: "issue.listComments",
|
|
20564
|
+
output
|
|
20565
|
+
};
|
|
20566
|
+
};
|
|
20567
|
+
|
|
20247
20568
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
|
|
20248
20569
|
var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
20249
20570
|
const input = object({
|
|
@@ -20308,6 +20629,21 @@ var makeUpdateIssueContract = (ids) => {
|
|
|
20308
20629
|
};
|
|
20309
20630
|
};
|
|
20310
20631
|
|
|
20632
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/contracts.js
|
|
20633
|
+
var makeIssueContracts = (ids) => ({
|
|
20634
|
+
addFlows: makeAddFlowsToIssueContract(ids),
|
|
20635
|
+
attachFiles: makeAttachFilesToIssueContract(ids),
|
|
20636
|
+
comment: makeCommentOnIssueContract(ids),
|
|
20637
|
+
create: makeCreateIssueContract(ids),
|
|
20638
|
+
decideSuggestion: makeDecideSuggestionContract(ids),
|
|
20639
|
+
find: makeFindIssuesContract(ids),
|
|
20640
|
+
get: makeGetIssueContract(ids),
|
|
20641
|
+
listActivity: makeListIssueActivityContract(ids),
|
|
20642
|
+
listComments: makeListIssueCommentsContract(ids),
|
|
20643
|
+
removeFlows: makeRemoveFlowsFromIssueContract(ids),
|
|
20644
|
+
update: makeUpdateIssueContract(ids)
|
|
20645
|
+
});
|
|
20646
|
+
|
|
20311
20647
|
// node_modules/@qawolf/api-contracts/dist/v1/legacyTrigger/resource.js
|
|
20312
20648
|
var namedIdentity = object({ id: string2(), name: string2() });
|
|
20313
20649
|
var branchScope = union([
|
|
@@ -20457,6 +20793,7 @@ var makeConnectMcpServerContract = (ids) => {
|
|
|
20457
20793
|
});
|
|
20458
20794
|
const output = object({
|
|
20459
20795
|
authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
|
|
20796
|
+
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."),
|
|
20460
20797
|
serverName: string2().describe("The catalog name of the server.")
|
|
20461
20798
|
});
|
|
20462
20799
|
return {
|
|
@@ -20661,12 +20998,46 @@ var makeFlowFailureSchema = (ids) => {
|
|
|
20661
20998
|
});
|
|
20662
20999
|
};
|
|
20663
21000
|
|
|
21001
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
|
|
21002
|
+
var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
|
|
21003
|
+
var attemptCount = number2().int().positive().describe("How many attempts reported it.");
|
|
21004
|
+
var runBuildVersionSchema = object({
|
|
21005
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
|
|
21006
|
+
expected: object({
|
|
21007
|
+
buildId: buildIdSchema,
|
|
21008
|
+
version: string2().optional()
|
|
21009
|
+
}).optional().describe("The run's build of this app. Absent for an app it got none of."),
|
|
21010
|
+
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."),
|
|
21011
|
+
observed: array(object({
|
|
21012
|
+
attempts: attemptCount,
|
|
21013
|
+
buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
|
|
21014
|
+
version: string2().optional()
|
|
21015
|
+
})).describe("What attempts installed, one entry per build or version."),
|
|
21016
|
+
platform: buildPlatformSchema,
|
|
21017
|
+
unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
|
|
21018
|
+
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.")
|
|
21019
|
+
});
|
|
21020
|
+
var runSiteVersionSchema = object({
|
|
21021
|
+
expected: object({
|
|
21022
|
+
from: extensibleValue(["deployment", "latestDeployment"], "deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run."),
|
|
21023
|
+
version: string2().describe("The deployed commit.")
|
|
21024
|
+
}).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."),
|
|
21025
|
+
observed: array(object({
|
|
21026
|
+
attempts: attemptCount,
|
|
21027
|
+
source: extensibleValue(["header", "meta", "versionPath", "frameworkBuildId", "fingerprint"], "Where the attempt read the version."),
|
|
21028
|
+
version: string2()
|
|
21029
|
+
})).describe("What attempts saw, one entry per version and source."),
|
|
21030
|
+
origin: string2().describe("The site origin the attempts visited."),
|
|
21031
|
+
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.")
|
|
21032
|
+
});
|
|
21033
|
+
|
|
20664
21034
|
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
20665
21035
|
var makeGetRunContract = (ids) => {
|
|
20666
21036
|
const flowStatus = _enum(publicRunStatusValues);
|
|
20667
21037
|
const input = object({
|
|
20668
21038
|
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."),
|
|
20669
|
-
runId: ids.run
|
|
21039
|
+
runId: ids.run,
|
|
21040
|
+
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.`)
|
|
20670
21041
|
});
|
|
20671
21042
|
const attempts = makeFlowAttemptsSchema(ids);
|
|
20672
21043
|
const failedFlow = object({
|
|
@@ -20687,8 +21058,12 @@ var makeGetRunContract = (ids) => {
|
|
|
20687
21058
|
...makeRunSummaryFields(ids),
|
|
20688
21059
|
blockingBugCount: number2().int().nonnegative().describe("How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved."),
|
|
20689
21060
|
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
21061
|
+
buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
|
|
20690
21062
|
flows,
|
|
20691
|
-
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
|
|
21063
|
+
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."),
|
|
21064
|
+
siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
|
|
21065
|
+
waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
|
|
21066
|
+
wokeOn: runWakeReasonSchema.optional()
|
|
20692
21067
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
20693
21068
|
return {
|
|
20694
21069
|
annotationJustifications: {
|
|
@@ -20701,7 +21076,7 @@ var makeGetRunContract = (ids) => {
|
|
|
20701
21076
|
openWorldHint: false,
|
|
20702
21077
|
readOnlyHint: true
|
|
20703
21078
|
},
|
|
20704
|
-
description:
|
|
21079
|
+
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.`,
|
|
20705
21080
|
input,
|
|
20706
21081
|
kind: "read",
|
|
20707
21082
|
name: "run.get",
|
|
@@ -21038,7 +21413,7 @@ var makeLaunchRunnerContract = (ids) => {
|
|
|
21038
21413
|
openWorldHint: true,
|
|
21039
21414
|
readOnlyHint: false
|
|
21040
21415
|
},
|
|
21041
|
-
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one,
|
|
21416
|
+
description: "Launch an interactive runner on the caller's team under an id the caller chooses. Send `initialUrl` so its browser comes up on the page the work starts from, which saves a separate navigation and the browser's cold start. Launching the same id again returns the runner already running rather than starting a second one, whatever runnerName is sent, so read `runnerName` in the answer for what is running. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner, so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running, and launching the same id again attaches to it.",
|
|
21042
21417
|
input,
|
|
21043
21418
|
kind: "write",
|
|
21044
21419
|
name: "runner.launch",
|
|
@@ -21186,17 +21561,14 @@ var unchangedFilesSchema = record(string2(), string2().min(1)).superRefine((hash
|
|
|
21186
21561
|
var makeRunFlowOnRunnerContract = (ids) => {
|
|
21187
21562
|
const input = object({
|
|
21188
21563
|
entryPointPath: runFilePathSchema.describe("Path of the flow file to run, as it appears in `files`."),
|
|
21189
|
-
env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run."),
|
|
21190
|
-
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit
|
|
21564
|
+
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."),
|
|
21565
|
+
environmentId: ids.environmentRef.optional().describe("A QA Wolf environment whose variables the run is given, by id or alias. QA Wolf reads and decrypts them itself, so they never travel in the request and the count and length limits on `env` do not apply to them. The run also gets `QAWOLF_ENVIRONMENT_ID`, `QAWOLF_ENVIRONMENT_NAME` and `QAWOLF_TEAM_API_KEY`, as a cloud run on that environment does, so a flow can save environment variables with `@qawolf/testkit`; `env` cannot replace these three."),
|
|
21191
21566
|
files: runFilesSchema.describe("Every file the run needs keyed by its path — the flow file, everything it imports, package.json and tsconfig.json. A runner holds no copy of your project, so what runs is exactly what is sent here."),
|
|
21192
21567
|
flowId: ids.flow.optional().describe("The QA Wolf flow this run is for. The run then sees it as `QAWOLF_WORKFLOW_ID`, the same value a platform run of that flow sees, so fixtures named and cleaned up by it match across both. Omitted, the flow whose file is at `entryPointPath` on the named environment's flow-code branch stands in; a file not in QA Wolf yet, or a run given no environment, leaves the run with no `QAWOLF_WORKFLOW_ID`."),
|
|
21193
21568
|
id: runnerIdSchema.describe("Id of the runner to run the flow on."),
|
|
21194
21569
|
selection: runSelectionSchema.optional().describe("Run only these lines, inside the page the runner is already on, instead of running the whole flow from a fresh browser. Omit to run the whole entry point."),
|
|
21195
21570
|
unchangedFiles: unchangedFilesSchema.optional().describe("Files this runner already holds from an earlier run, keyed by path with a hex SHA-256 of the content it should hold. Send this to make `files` only what changed. The runner refuses with `needs-full-sync` if it holds none of a referenced path, so it never runs something other than what was asked for. Omit it to send every file."),
|
|
21196
21571
|
workspaceId: ids.workspace.optional().describe(runnerWorkspaceIdDescription)
|
|
21197
|
-
}).refine((request) => request.env === undefined || request.environmentId === undefined, {
|
|
21198
|
-
error: "Send env or environmentId, not both. An environment's variables are taken as they are stored, so there is no order in which the two would combine.",
|
|
21199
|
-
path: ["environmentId"]
|
|
21200
21572
|
}).refine((request) => Object.hasOwn(request.files, request.entryPointPath), {
|
|
21201
21573
|
error: "The entry point must be one of the files.",
|
|
21202
21574
|
path: ["files"]
|
|
@@ -21441,6 +21813,9 @@ var makeContractsV1 = (ids) => {
|
|
|
21441
21813
|
runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
|
|
21442
21814
|
};
|
|
21443
21815
|
return {
|
|
21816
|
+
activity: {
|
|
21817
|
+
wait: makeActivityWaitContract(resolvedIds)
|
|
21818
|
+
},
|
|
21444
21819
|
agent: {
|
|
21445
21820
|
get: makeAgentGetContract(resolvedIds),
|
|
21446
21821
|
send: makeAgentSendContract(resolvedIds)
|
|
@@ -21483,16 +21858,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21483
21858
|
update: makeUpdateFlowContract(resolvedIds)
|
|
21484
21859
|
},
|
|
21485
21860
|
investigation: makeInvestigationContracts(resolvedIds),
|
|
21486
|
-
issue:
|
|
21487
|
-
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
21488
|
-
create: makeCreateIssueContract(resolvedIds),
|
|
21489
|
-
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
21490
|
-
find: makeFindIssuesContract(resolvedIds),
|
|
21491
|
-
get: makeGetIssueContract(resolvedIds),
|
|
21492
|
-
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
21493
|
-
removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
|
|
21494
|
-
update: makeUpdateIssueContract(resolvedIds)
|
|
21495
|
-
},
|
|
21861
|
+
issue: makeIssueContracts(resolvedIds),
|
|
21496
21862
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
21497
21863
|
mcpServer: {
|
|
21498
21864
|
connect: makeConnectMcpServerContract(resolvedIds)
|
|
@@ -24024,7 +24390,7 @@ function startUpdateCheck(deps) {
|
|
|
24024
24390
|
// package.json
|
|
24025
24391
|
var package_default = {
|
|
24026
24392
|
name: "@qawolf/cli",
|
|
24027
|
-
version: "2.
|
|
24393
|
+
version: "2.7.0",
|
|
24028
24394
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
24029
24395
|
keywords: [
|
|
24030
24396
|
"automation",
|
|
@@ -24096,7 +24462,7 @@ var package_default = {
|
|
|
24096
24462
|
"@clack/prompts": "1.5.1",
|
|
24097
24463
|
"@napi-rs/keyring": "1.3.0",
|
|
24098
24464
|
"@oxc-node/core": "0.1.0",
|
|
24099
|
-
"@qawolf/api-contracts": "0.
|
|
24465
|
+
"@qawolf/api-contracts": "0.114.0",
|
|
24100
24466
|
"@qawolf/emails": "1.1.1",
|
|
24101
24467
|
"@qawolf/flow-targets": "2.0.0",
|
|
24102
24468
|
"@qawolf/flows": "0.3.0",
|
|
@@ -42270,4 +42636,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
42270
42636
|
process.exitCode = 1;
|
|
42271
42637
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
42272
42638
|
|
|
42273
|
-
//# debugId=
|
|
42639
|
+
//# debugId=4123DE9F7A00111E64756E2164756E21
|