@qawolf/cli 2.1.0 → 2.2.1
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 +145 -116
- package/dist/runner-sdk.js +122 -79
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +12 -12
- package/skills/qawolf-cli/references/run-results.md +2 -1
- package/skills/qawolf-cli/references/runner.md +39 -42
package/dist/cli.js
CHANGED
|
@@ -8440,6 +8440,7 @@ var authErrorMessages = {
|
|
|
8440
8440
|
rejected401: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 401). Check your API key.`,
|
|
8441
8441
|
rejected402: (noun) => `QA Wolf API refused the${noun ? ` ${noun}` : ""} request (HTTP 402): billing prevented it.`,
|
|
8442
8442
|
rejected403: (noun) => `QA Wolf API rejected the${noun ? ` ${noun}` : ""} request (HTTP 403). Check that your API key has access to this environment.`,
|
|
8443
|
+
blocked403: (noun) => `The${noun ? ` ${noun}` : ""} request was blocked before it reached the QA Wolf API (HTTP 403), so your API key was not checked.`,
|
|
8443
8444
|
notFound404Environment: (noun) => `QA Wolf API could not find ${noun ? `${noun} for that environment` : "that environment"} (HTTP 404). Check the --env value.`,
|
|
8444
8445
|
notFound404Runner: (runnerId) => runnerId === undefined ? "That runner is not running (HTTP 404)." : `Runner ${runnerId} is not running (HTTP 404).`,
|
|
8445
8446
|
runnerIsGone: "It was never launched, or it has since been terminated or idled out.",
|
|
@@ -8935,10 +8936,10 @@ var lifecycleMessages = {
|
|
|
8935
8936
|
launched: (id, url) => `Launched runner ${id}. ${pageAt(url)}`,
|
|
8936
8937
|
launchedForCommand: (id, url) => `No runner was given, so launched ${id} for this command. Its browser is fresh: nothing has been run on it and nothing is signed in. It bills until it is terminated or idles out, so terminate it with qawolf runner terminate --runner ${id} when you are done. ${pageAt(url)}`,
|
|
8937
8938
|
noRunnerIdForImport: `${noRunnerId} An install also needs a live run to go into, which a runner gets from qawolf runner run.`,
|
|
8938
|
-
noRunnerIdForHighlight: `${noRunnerId}
|
|
8939
|
-
noRunnerIdForInspect: `${noRunnerId}
|
|
8939
|
+
noRunnerIdForHighlight: `${noRunnerId} A playwright runner has a page to draw on as soon as it launches.`,
|
|
8940
|
+
noRunnerIdForInspect: `${noRunnerId} A playwright runner can be inspected as soon as it launches, and any other runner once a flow has run on it with qawolf runner run.`,
|
|
8940
8941
|
noRunnerIdForPromoteSnapshot: `${noRunnerId} A baseline is replaced on the runner that produced the screenshot, so it has to be the runner the diff came from.`,
|
|
8941
|
-
noRunnerIdForScreenshot: `${noRunnerId} A
|
|
8942
|
+
noRunnerIdForScreenshot: `${noRunnerId} A playwright runner has a screen as soon as it launches, and any other runner once a flow has run on it with qawolf runner run.`,
|
|
8942
8943
|
noRunnerId,
|
|
8943
8944
|
wasNotRunning: (id) => `Runner ${id} was not running.`,
|
|
8944
8945
|
terminated: (id) => `Terminated runner ${id}.`,
|
|
@@ -15446,6 +15447,15 @@ function applyWorkspaceId(inputSchema, input, workspaceId) {
|
|
|
15446
15447
|
return { ...input, workspaceId };
|
|
15447
15448
|
}
|
|
15448
15449
|
|
|
15450
|
+
// src/core/parseJson.ts
|
|
15451
|
+
function parseJson(text) {
|
|
15452
|
+
try {
|
|
15453
|
+
return JSON.parse(text);
|
|
15454
|
+
} catch {
|
|
15455
|
+
return;
|
|
15456
|
+
}
|
|
15457
|
+
}
|
|
15458
|
+
|
|
15449
15459
|
// src/shell/platform/describeNotFound.ts
|
|
15450
15460
|
var m = authMessages.errors.request;
|
|
15451
15461
|
var saysNothingMore = (reason) => /^(\w+ )*not ?found\.?$/i.test(reason.trim());
|
|
@@ -15563,7 +15573,7 @@ function describeRequestError(err, baseUrl, noun, notFound) {
|
|
|
15563
15573
|
...body
|
|
15564
15574
|
};
|
|
15565
15575
|
if (err.status === 403)
|
|
15566
|
-
return { error: m2.request.rejected403(noun), ...body };
|
|
15576
|
+
return parseJson(err.body) === undefined ? { error: m2.request.blocked403(noun) } : { error: m2.request.rejected403(noun), ...body };
|
|
15567
15577
|
if (err.status === 404)
|
|
15568
15578
|
return describeNotFound(notFound, noun, reason);
|
|
15569
15579
|
return { error: m2.request.failedWithStatus(err.status, noun), ...body };
|
|
@@ -16804,6 +16814,7 @@ var agentSessionStatusSchema = _enum(agentSessionStatuses).describe('Where the w
|
|
|
16804
16814
|
var agentReplySchema = object({
|
|
16805
16815
|
askedAt: exports_iso.datetime().describe("When the AI wrote this, as an ISO 8601 timestamp."),
|
|
16806
16816
|
choices: array(string2()).optional().describe("The answers the AI offered, when the reply is a question with a fixed set of them. Answer by sending one of these back through agent.send."),
|
|
16817
|
+
id: string2().min(1).describe("Stays the same while the AI is still writing this reply, so a reply that a later check returns again, longer, replaces the one with this id."),
|
|
16807
16818
|
text: string2().describe("What the AI said.")
|
|
16808
16819
|
});
|
|
16809
16820
|
|
|
@@ -16934,12 +16945,13 @@ var uploadedFileNameSchema = teamStoragePathSchema.refine((fileName) => teamStor
|
|
|
16934
16945
|
// node_modules/@qawolf/api-contracts/dist/v1/file/requestDownload.js
|
|
16935
16946
|
var makeRequestFileDownloadContract = (ids) => {
|
|
16936
16947
|
const input = object({
|
|
16937
|
-
filePath: teamStoragePathSchema.describe("The file's path in team storage, as file.requestUpload answered with."),
|
|
16948
|
+
filePath: teamStoragePathSchema.describe("The file's path in team storage, as the filePath file.requestUpload answered with."),
|
|
16938
16949
|
workspaceId: ids.workspace.optional().describe("The workspace the file belongs to. Required when authenticating with an organization or user API key.")
|
|
16939
16950
|
});
|
|
16940
16951
|
const output = object({
|
|
16941
16952
|
expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
|
|
16942
|
-
|
|
16953
|
+
filePath: string2().describe("The file's path in team storage."),
|
|
16954
|
+
path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
|
|
16943
16955
|
readUrl: string2().describe('Fetch the file\'s bytes from here, for example `curl -o journeys.csv "<readUrl>"`. Write it to a file and read that file, rather than printing the contents, so a large file costs one line of output instead of all of it.')
|
|
16944
16956
|
});
|
|
16945
16957
|
return {
|
|
@@ -16970,7 +16982,8 @@ var makeRequestFileUploadContract = (ids) => {
|
|
|
16970
16982
|
const output = object({
|
|
16971
16983
|
contentType: string2().describe("Send this as the PUT's `Content-Type` header, exactly. The URL is signed for it and refuses any other value."),
|
|
16972
16984
|
expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
|
|
16973
|
-
|
|
16985
|
+
filePath: string2().describe("Where the file lives in team storage. Send it as filePath to file.requestDownload, or in agent.send's filePaths so the AI fetches it from there."),
|
|
16986
|
+
path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
|
|
16974
16987
|
uploadUrl: string2().describe(`Send the file's bytes here with a single HTTP PUT carrying the returned contentType, for example \`curl -H 'Content-Type: application/octet-stream' --upload-file "journeys.csv" "<uploadUrl>"\`. Upload the bytes from the shell rather than through this API, so a large file never has to be written out as text.`)
|
|
16975
16988
|
});
|
|
16976
16989
|
return {
|
|
@@ -16984,7 +16997,7 @@ var makeRequestFileUploadContract = (ids) => {
|
|
|
16984
16997
|
openWorldHint: false,
|
|
16985
16998
|
readOnlyHint: false
|
|
16986
16999
|
},
|
|
16987
|
-
description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the
|
|
17000
|
+
description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the returned filePath in filePaths.",
|
|
16988
17001
|
input,
|
|
16989
17002
|
kind: "write",
|
|
16990
17003
|
name: "file.requestUpload",
|
|
@@ -17076,7 +17089,7 @@ var makeCreateRunContract = (ids) => {
|
|
|
17076
17089
|
aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
|
|
17077
17090
|
chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
|
|
17078
17091
|
environmentId: ids.environmentRef,
|
|
17079
|
-
environmentVariables: record(string2(), string2()).optional(),
|
|
17092
|
+
environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
|
|
17080
17093
|
ignoreRules: boolean2().describe("Ignore this team's sequencing rules for this run. By default they are honoured: the flows your selection depends on are added to the run, and flows run in the order the rules require. Set this to run exactly what you selected, in any order.").default(false),
|
|
17081
17094
|
pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
|
|
17082
17095
|
repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
|
|
@@ -17310,7 +17323,8 @@ var runnerNameSchema = _enum([
|
|
|
17310
17323
|
"playwright",
|
|
17311
17324
|
"android",
|
|
17312
17325
|
"ios",
|
|
17313
|
-
"windows"
|
|
17326
|
+
"windows",
|
|
17327
|
+
"mac"
|
|
17314
17328
|
]);
|
|
17315
17329
|
var runnerWorkspaceRequirement = "Read it from whoami.";
|
|
17316
17330
|
var runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;
|
|
@@ -18005,14 +18019,6 @@ var makeTriggerScheduleFields = (ids) => ({
|
|
|
18005
18019
|
timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily or weekly schedule fires, as "HH:mm". Required when cadence is daily or weekly.'),
|
|
18006
18020
|
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.")
|
|
18007
18021
|
});
|
|
18008
|
-
var makeTriggerDeploymentFields = (ids) => ({
|
|
18009
|
-
action: makeTriggerActionSchema(ids),
|
|
18010
|
-
branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
|
|
18011
|
-
deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
|
|
18012
|
-
environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
|
|
18013
|
-
environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
|
|
18014
|
-
servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
|
|
18015
|
-
});
|
|
18016
18022
|
|
|
18017
18023
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
|
|
18018
18024
|
var checkAction = (action, ctx) => {
|
|
@@ -18114,6 +18120,17 @@ var checkDeployment = (value, ctx) => {
|
|
|
18114
18120
|
};
|
|
18115
18121
|
var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? checkSchedule(value, ctx) : checkDeployment(value, ctx);
|
|
18116
18122
|
|
|
18123
|
+
// node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
|
|
18124
|
+
var makeTriggerDeploymentFields = (ids) => ({
|
|
18125
|
+
action: makeTriggerActionSchema(ids),
|
|
18126
|
+
branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
|
|
18127
|
+
deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
|
|
18128
|
+
environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
|
|
18129
|
+
environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
|
|
18130
|
+
repositoryPattern: string2().min(1).optional().describe('Only fire for deployments from a repository whose "owner/name" matches this pattern, such as acme/web or acme/*. A deployment that names no repository never matches it.'),
|
|
18131
|
+
servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
|
|
18132
|
+
});
|
|
18133
|
+
|
|
18117
18134
|
// node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
|
|
18118
18135
|
var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
|
|
18119
18136
|
object({
|
|
@@ -18459,13 +18476,14 @@ var makeGetAttemptContract = (ids) => {
|
|
|
18459
18476
|
error: string2().optional(),
|
|
18460
18477
|
startedAt: exports_iso.datetime().optional()
|
|
18461
18478
|
});
|
|
18479
|
+
const artifactUrls = {
|
|
18480
|
+
logsUrl: url().optional(),
|
|
18481
|
+
traceUrl: url().optional(),
|
|
18482
|
+
videoUrl: url().optional()
|
|
18483
|
+
};
|
|
18462
18484
|
const output = discriminatedUnion("artifactStatus", [
|
|
18463
18485
|
response.extend({
|
|
18464
|
-
artifacts: object(
|
|
18465
|
-
logsUrl: url().optional(),
|
|
18466
|
-
traceUrl: url().optional(),
|
|
18467
|
-
videoUrl: url().optional()
|
|
18468
|
-
}),
|
|
18486
|
+
artifacts: object(artifactUrls),
|
|
18469
18487
|
artifactStatus: literal("signed"),
|
|
18470
18488
|
attempt: attempt.extend({
|
|
18471
18489
|
kind: literal("automated"),
|
|
@@ -18486,7 +18504,8 @@ var makeGetAttemptContract = (ids) => {
|
|
|
18486
18504
|
attempt: attempt.extend({
|
|
18487
18505
|
kind: literal("manual"),
|
|
18488
18506
|
status: literal("passed")
|
|
18489
|
-
})
|
|
18507
|
+
}),
|
|
18508
|
+
evidence: object(artifactUrls).optional().describe("Signed links to the logs, trace, and video that the Wolf Browser run kept. Absent when it kept none. The artifacts field stays empty for a manual attempt.")
|
|
18490
18509
|
})
|
|
18491
18510
|
]);
|
|
18492
18511
|
return {
|
|
@@ -18594,7 +18613,7 @@ var makeDeploymentResourceSchema = (ids) => resource({
|
|
|
18594
18613
|
environmentName: string2().optional().describe("The environment's name. Absent when the environment has since been deleted."),
|
|
18595
18614
|
id: ids.deployment,
|
|
18596
18615
|
provider: _enum(["github", "gitlab", "api"]).optional().describe("How QA Wolf received the deployment: a GitHub webhook, a GitLab webhook, or the deployment.reportStatus API."),
|
|
18597
|
-
repository: string2().optional().describe(
|
|
18616
|
+
repository: string2().optional().describe(`The repository the deployment came from, as "owner/name". Absent when neither the code host nor the deployment report named one. A trigger's repositoryPattern matches against it.`),
|
|
18598
18617
|
service: string2().optional().describe("Which application was deployed, as the deployer named it. Absent when the deployer named none."),
|
|
18599
18618
|
status: _enum(["pending", "success", "failure", "inactive"]).optional().describe("The deployment's lifecycle status, in the vocabulary deployment.reportStatus accepts. Absent when no status was ever reported.")
|
|
18600
18619
|
}, {
|
|
@@ -18631,7 +18650,7 @@ var makeFindDeploymentsContract = (ids) => {
|
|
|
18631
18650
|
};
|
|
18632
18651
|
|
|
18633
18652
|
// node_modules/@qawolf/api-contracts/dist/v1/deployment/listTriggerEvaluations.js
|
|
18634
|
-
var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, or the
|
|
18653
|
+
var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service", "repository"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, the service it deployed, or the repository it came from.");
|
|
18635
18654
|
var conditionVerdictSchema = discriminatedUnion("outcome", [
|
|
18636
18655
|
object({
|
|
18637
18656
|
kind: conditionKindSchema,
|
|
@@ -18717,7 +18736,7 @@ var deploymentReportMetadata = strictObject({
|
|
|
18717
18736
|
commitUrl: httpUrl().max(2048).describe("A link to the deployed commit in your code host. Send this when QA Wolf cannot resolve the commit itself, for example when the QA Wolf GitHub App is not installed.").optional(),
|
|
18718
18737
|
pullRequestNumber: number2().int().positive().describe("The number of the pull request the deployment belongs to. Requires repository.").optional(),
|
|
18719
18738
|
ref: string2().trim().min(1).max(255).describe("The branch or ref that was deployed.").optional(),
|
|
18720
|
-
repository: string2().trim().min(1).max(255).describe(
|
|
18739
|
+
repository: string2().trim().min(1).max(255).describe(`The owner/name of the repository, e.g. "acme/web". A deployment trigger's repositoryPattern matches against it.`).optional()
|
|
18721
18740
|
}).refine((value) => value.pullRequestNumber === undefined || value.repository !== undefined, {
|
|
18722
18741
|
message: "repository is required when pullRequestNumber is provided.",
|
|
18723
18742
|
path: ["pullRequestNumber"]
|
|
@@ -19010,7 +19029,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
|
|
|
19010
19029
|
kind: _enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
|
|
19011
19030
|
name: string2(),
|
|
19012
19031
|
runConcurrencyLimit: string2().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
|
|
19013
|
-
status: _enum(["blocked", "needs-investigation", "ready", "running"]).describe("
|
|
19032
|
+
status: _enum(["blocked", "needs-investigation", "ready", "running"]).describe("Release readiness from the environment's open bugs and runs, not its Git reconciliation state: blocked (an open urgent, high, or unprioritized bug reproduces here), needs-investigation (failures await triage), running (flows are executing), or ready (none of these, the greenlit state). It only reports. It never stops runs, validation, or publishing."),
|
|
19014
19033
|
terminatedAt: exports_iso.datetime().optional().describe("When the environment was terminated, if it has been."),
|
|
19015
19034
|
variablesUrl: url().optional().describe("Absolute URL of the page where a person saves this environment's variables. Give it to the user when a login or key is missing, rather than collecting the value yourself. Absent once the environment is terminated, because that page no longer exists.")
|
|
19016
19035
|
}, { urlFieldDescription: "Absolute URL of the environment page." });
|
|
@@ -19146,14 +19165,14 @@ var makeGetEnvironmentContract = (ids) => {
|
|
|
19146
19165
|
annotationJustifications: {
|
|
19147
19166
|
destructiveHint: "Does not alter environment settings or concurrency limits.",
|
|
19148
19167
|
openWorldHint: "Reads QA Wolf environment state without updating the connected Git provider.",
|
|
19149
|
-
readOnlyHint: "Retrieves an environment's configuration,
|
|
19168
|
+
readOnlyHint: "Retrieves an environment's configuration, release readiness and code-reconciliation state."
|
|
19150
19169
|
},
|
|
19151
19170
|
annotations: {
|
|
19152
19171
|
destructiveHint: false,
|
|
19153
19172
|
openWorldHint: false,
|
|
19154
19173
|
readOnlyHint: true
|
|
19155
19174
|
},
|
|
19156
|
-
description: "Read a single environment's name, kind,
|
|
19175
|
+
description: "Read a single environment's name, kind, release readiness status, flow-code branch and reconciliation state, run concurrency limit, and termination state. If flowCodeBranch exists, use its syncStatus for Git reconciliation and read lastSyncedCommitHash only when syncStatus is reconciled.",
|
|
19157
19176
|
input,
|
|
19158
19177
|
kind: "read",
|
|
19159
19178
|
name: "environment.get",
|
|
@@ -19564,7 +19583,7 @@ var openIssueStatuses = [
|
|
|
19564
19583
|
"paused"
|
|
19565
19584
|
];
|
|
19566
19585
|
var makeIssueResourceSchema = (ids) => resource({
|
|
19567
|
-
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug and
|
|
19586
|
+
coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
|
|
19568
19587
|
createdAt: exports_coerce.date().describe("When the issue was created."),
|
|
19569
19588
|
description: string2().describe("The issue description in Markdown."),
|
|
19570
19589
|
issueId: ids.issue,
|
|
@@ -19585,25 +19604,25 @@ var makeFindIssuesContract = (ids) => {
|
|
|
19585
19604
|
const input = object({
|
|
19586
19605
|
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
19587
19606
|
statuses: array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to backlog, pending, in-progress, and paused issues."),
|
|
19588
|
-
type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance
|
|
19607
|
+
type: publicIssueTypeSchema.describe("The issue type to include: bug report (`bug`), blocker (`maintenance`), or coverage request (`coverageRequest`)."),
|
|
19589
19608
|
workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
|
|
19590
19609
|
});
|
|
19591
19610
|
const output = object({
|
|
19592
|
-
issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports,
|
|
19611
|
+
issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, blockers, or coverage requests, newest first."),
|
|
19593
19612
|
nextCursor: nextCursorSchema
|
|
19594
19613
|
});
|
|
19595
19614
|
return {
|
|
19596
19615
|
annotationJustifications: {
|
|
19597
19616
|
destructiveHint: "Does not edit issue details, statuses or coverage associations.",
|
|
19598
19617
|
openWorldHint: "Reads QA Wolf issue records without publishing updates to linked trackers.",
|
|
19599
|
-
readOnlyHint: "Lists workspace bug reports,
|
|
19618
|
+
readOnlyHint: "Lists workspace bug reports, blockers or coverage requests."
|
|
19600
19619
|
},
|
|
19601
19620
|
annotations: {
|
|
19602
19621
|
destructiveHint: false,
|
|
19603
19622
|
openWorldHint: false,
|
|
19604
19623
|
readOnlyHint: true
|
|
19605
19624
|
},
|
|
19606
|
-
description: "List the team's bug reports,
|
|
19625
|
+
description: "List the team's bug reports, blockers, or coverage requests, newest first.",
|
|
19607
19626
|
input,
|
|
19608
19627
|
kind: "read",
|
|
19609
19628
|
name: "issue.find",
|
|
@@ -19750,7 +19769,7 @@ var makeAddFlowsToIssueContract = (ids) => {
|
|
|
19750
19769
|
openWorldHint: false,
|
|
19751
19770
|
readOnlyHint: false
|
|
19752
19771
|
},
|
|
19753
|
-
description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug and
|
|
19772
|
+
description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug reports and blockers link to flows through the runs that reproduce them; use run.diagnose to record one.",
|
|
19754
19773
|
input,
|
|
19755
19774
|
kind: "write",
|
|
19756
19775
|
name: "issue.addFlows",
|
|
@@ -19780,7 +19799,18 @@ var makeCreateIssueContract = (ids) => {
|
|
|
19780
19799
|
...commonFields,
|
|
19781
19800
|
effort: _enum(["extraSmall", "small", "medium", "large", "extraLarge"]).describe("The effort to repair the flows."),
|
|
19782
19801
|
priority: _enum(["low", "medium", "high", "urgent"]),
|
|
19783
|
-
reason: _enum([
|
|
19802
|
+
reason: _enum([
|
|
19803
|
+
"featureNotAvailable",
|
|
19804
|
+
"needsTestData",
|
|
19805
|
+
"needsAccess",
|
|
19806
|
+
"needsConfirmation",
|
|
19807
|
+
"environmentUnavailable",
|
|
19808
|
+
"qaWolfQueue",
|
|
19809
|
+
"dataChanged",
|
|
19810
|
+
"flowNeedsWork",
|
|
19811
|
+
"other",
|
|
19812
|
+
"uiChanged"
|
|
19813
|
+
]).describe('What the blocked flows wait on. "qaWolfQueue" is only for full-service workspaces. "dataChanged", "flowNeedsWork", "other" and "uiChanged" are deprecated and still accepted.'),
|
|
19784
19814
|
type: literal("maintenance")
|
|
19785
19815
|
})
|
|
19786
19816
|
]);
|
|
@@ -19798,7 +19828,7 @@ var makeCreateIssueContract = (ids) => {
|
|
|
19798
19828
|
openWorldHint: true,
|
|
19799
19829
|
readOnlyHint: false
|
|
19800
19830
|
},
|
|
19801
|
-
description: "Create a bug report, maintenance
|
|
19831
|
+
description: "Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. " + "A user can create a blocker only when they can see the workspace's blockers; " + "a team or organization API key credits it to the workspace's automation user. " + "Link its failed flows afterwards with run.diagnose.",
|
|
19802
19832
|
input,
|
|
19803
19833
|
kind: "write",
|
|
19804
19834
|
name: "issue.create",
|
|
@@ -19863,7 +19893,7 @@ var makeListIssueActivityContract = (ids) => {
|
|
|
19863
19893
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
|
|
19864
19894
|
var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
19865
19895
|
const input = object({
|
|
19866
|
-
environmentId: ids.environment.optional().describe("The environment whose bug or
|
|
19896
|
+
environmentId: ids.environment.optional().describe("The environment whose bug report or blocker reproductions to remove. Required when a selected flow is linked in more than one environment."),
|
|
19867
19897
|
flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows to remove from the issue."),
|
|
19868
19898
|
issueId: ids.issue
|
|
19869
19899
|
});
|
|
@@ -19881,7 +19911,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
|
|
|
19881
19911
|
openWorldHint: true,
|
|
19882
19912
|
readOnlyHint: false
|
|
19883
19913
|
},
|
|
19884
|
-
description: "Remove flows from a coverage request or remove bug
|
|
19914
|
+
description: "Remove flows from a coverage request or remove bug report or blocker reproductions in an environment. " + "Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. " + "For reports, omit environmentId only when each selected flow is linked in at most one environment.",
|
|
19885
19915
|
input,
|
|
19886
19916
|
kind: "write",
|
|
19887
19917
|
name: "issue.removeFlows",
|
|
@@ -19898,7 +19928,7 @@ var makeUpdateIssueContract = (ids) => {
|
|
|
19898
19928
|
issueId: ids.issue,
|
|
19899
19929
|
name: nameSchema.optional(),
|
|
19900
19930
|
priority: issuePrioritySchema.optional(),
|
|
19901
|
-
status: issueStatusSchema.optional()
|
|
19931
|
+
status: issueStatusSchema.optional().describe("Bug reports and blockers allow only these changes: pending to canceled or archived, canceled to archived, and resolved to archived. Requesting pending or inProgress on a bug report resolved in the last 7 days reopens it. The stored status is inProgress when a flow still reproduces it, and pending otherwise. Never set resolved on a bug report: it resolves on its own once its flows pass. A coverage request can move to backlog, pending, paused, inProgress, resolved or archived.")
|
|
19902
19932
|
}).refine((update) => update.description !== undefined || update.name !== undefined || update.priority !== undefined || update.status !== undefined, {
|
|
19903
19933
|
message: "At least one of description, name, priority, or status is required."
|
|
19904
19934
|
});
|
|
@@ -19937,8 +19967,12 @@ var branchScope = union([
|
|
|
19937
19967
|
]);
|
|
19938
19968
|
var codeHostingServiceRepository = union([
|
|
19939
19969
|
object({ kind: literal("any") }),
|
|
19940
|
-
object({ kind: literal("none") }),
|
|
19941
|
-
object({
|
|
19970
|
+
object({ kind: literal("none") }).describe("The trigger ran with the code host integration's features off. It is not a repository filter and maps to no repositoryPattern."),
|
|
19971
|
+
object({
|
|
19972
|
+
fullName: string2().describe(`The repository's full name on the code host, such as "acme/storefront", as codeHostIntegration.listRepositories reports it and as a current trigger's repositoryPattern matches it.`),
|
|
19973
|
+
id: string2(),
|
|
19974
|
+
kind: literal("by-id")
|
|
19975
|
+
})
|
|
19942
19976
|
]);
|
|
19943
19977
|
var makeLegacyTriggerSchema = (ids) => {
|
|
19944
19978
|
const base = {
|
|
@@ -20126,14 +20160,14 @@ var makeDiagnoseRunContract = (ids) => {
|
|
|
20126
20160
|
annotationJustifications: {
|
|
20127
20161
|
destructiveHint: "Can replace a flow's existing diagnosis association and change externally reported run information.",
|
|
20128
20162
|
openWorldHint: "Recorded diagnosis changes can update run-related messages in configured external integrations.",
|
|
20129
|
-
readOnlyHint: "Records failed flows as reproductions of a selected bug or
|
|
20163
|
+
readOnlyHint: "Records failed flows as reproductions of a selected bug report or blocker."
|
|
20130
20164
|
},
|
|
20131
20165
|
annotations: {
|
|
20132
20166
|
destructiveHint: true,
|
|
20133
20167
|
openWorldHint: true,
|
|
20134
20168
|
readOnlyHint: false
|
|
20135
20169
|
},
|
|
20136
|
-
description: "
|
|
20170
|
+
description: "Link failed flows in a run to an existing bug report or blocker owned by the caller's team, recording them as its reproductions. " + "It does not explain why a run failed; read investigation.get or attempt.get for that. " + "The issue's type selects the diagnosis. " + "Each flow must have failed in the run. " + "A flow that is already diagnosed in the run moves to this issue, and may stay linked to other open reports. " + "The diagnosis appears on the run, and the reproduction appears under the issue's reproductions. " + "Coverage requests cannot be diagnosed; use issue.addFlows to cover flows instead.",
|
|
20137
20171
|
input,
|
|
20138
20172
|
kind: "write",
|
|
20139
20173
|
name: "run.diagnose",
|
|
@@ -20176,35 +20210,15 @@ var makeFindRunsContract = (ids) => {
|
|
|
20176
20210
|
};
|
|
20177
20211
|
};
|
|
20178
20212
|
|
|
20179
|
-
// node_modules/@qawolf/api-contracts/dist/v1/run/
|
|
20180
|
-
var
|
|
20181
|
-
const diagnosis = object({
|
|
20182
|
-
issueId: ids.issue,
|
|
20183
|
-
type: _enum(["bug", "maintenance"])
|
|
20184
|
-
}).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
|
|
20185
|
-
const optedOutOfInvestigation = object({
|
|
20186
|
-
by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
|
|
20187
|
-
}).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
|
|
20188
|
-
return object({
|
|
20189
|
-
diagnosis,
|
|
20190
|
-
error: string2(),
|
|
20191
|
-
optedOutOfInvestigation
|
|
20192
|
-
});
|
|
20193
|
-
};
|
|
20194
|
-
|
|
20195
|
-
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
20196
|
-
var makeGetRunContract = (ids) => {
|
|
20197
|
-
const flowStatus = _enum(publicRunStatusValues);
|
|
20198
|
-
const input = object({
|
|
20199
|
-
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."),
|
|
20200
|
-
runId: ids.run
|
|
20201
|
-
});
|
|
20213
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
|
|
20214
|
+
var makeFlowAttemptsSchema = (ids) => {
|
|
20202
20215
|
const artifactUrls = {
|
|
20203
20216
|
logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
|
|
20204
20217
|
traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
|
|
20205
20218
|
videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
|
|
20206
20219
|
};
|
|
20207
20220
|
const automatedKind = literal("automated").describe("The attempt ran on a QA Wolf runner.");
|
|
20221
|
+
const attemptUrl = url().optional().describe("Absolute URL of the attempt's page in the app, which opens this flow at this attempt. Link this page to show one flow's attempt: the run page opens a different flow. Absent only in replies from servers older than this field.");
|
|
20208
20222
|
const automatedAttempt = discriminatedUnion("status", [
|
|
20209
20223
|
object({
|
|
20210
20224
|
...artifactUrls,
|
|
@@ -20212,7 +20226,8 @@ var makeGetRunContract = (ids) => {
|
|
|
20212
20226
|
completedAt: exports_iso.datetime(),
|
|
20213
20227
|
kind: automatedKind,
|
|
20214
20228
|
startedAt: exports_iso.datetime(),
|
|
20215
|
-
status: literal("passed")
|
|
20229
|
+
status: literal("passed"),
|
|
20230
|
+
url: attemptUrl
|
|
20216
20231
|
}),
|
|
20217
20232
|
object({
|
|
20218
20233
|
...artifactUrls,
|
|
@@ -20220,7 +20235,8 @@ var makeGetRunContract = (ids) => {
|
|
|
20220
20235
|
completedAt: exports_iso.datetime(),
|
|
20221
20236
|
kind: automatedKind,
|
|
20222
20237
|
startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
|
|
20223
|
-
status: literal("failed")
|
|
20238
|
+
status: literal("failed"),
|
|
20239
|
+
url: attemptUrl
|
|
20224
20240
|
}),
|
|
20225
20241
|
object({
|
|
20226
20242
|
attemptId: ids.runAttempt.optional(),
|
|
@@ -20228,18 +20244,47 @@ var makeGetRunContract = (ids) => {
|
|
|
20228
20244
|
completedAt: exports_iso.datetime().optional(),
|
|
20229
20245
|
kind: automatedKind,
|
|
20230
20246
|
startedAt: exports_iso.datetime().optional(),
|
|
20231
|
-
status: literal("canceled").describe("The attempt was terminated without reaching a verdict.")
|
|
20247
|
+
status: literal("canceled").describe("The attempt was terminated without reaching a verdict."),
|
|
20248
|
+
url: attemptUrl
|
|
20232
20249
|
})
|
|
20233
20250
|
]);
|
|
20234
20251
|
const manualAttempt = object({
|
|
20252
|
+
...artifactUrls,
|
|
20235
20253
|
attemptId: ids.runAttempt.optional(),
|
|
20236
20254
|
completedAt: exports_iso.datetime(),
|
|
20237
20255
|
kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
|
|
20238
20256
|
startedAt: exports_iso.datetime(),
|
|
20239
|
-
status: literal("passed")
|
|
20257
|
+
status: literal("passed"),
|
|
20258
|
+
url: attemptUrl
|
|
20240
20259
|
});
|
|
20241
20260
|
const attempt = union([automatedAttempt, manualAttempt]);
|
|
20242
|
-
|
|
20261
|
+
return array(attempt).optional().describe("The flow's finished execution attempts, oldest first, including " + "manual Wolf Browser attempts. Present once at least one attempt has " + "finished, so a flow that passed after retries also lists its failed " + "attempts. Artifact URLs appear only on attempts that reached a " + "verdict, and on a manual attempt only when its Wolf Browser run " + "kept them. They stay valid for at least a day (call run.get again " + "for fresh ones), and can return 404 when the attempt did not " + "produce that artifact.");
|
|
20262
|
+
};
|
|
20263
|
+
|
|
20264
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
|
|
20265
|
+
var makeFlowFailureSchema = (ids) => {
|
|
20266
|
+
const diagnosis = object({
|
|
20267
|
+
issueId: ids.issue,
|
|
20268
|
+
type: _enum(["bug", "maintenance"])
|
|
20269
|
+
}).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
|
|
20270
|
+
const optedOutOfInvestigation = object({
|
|
20271
|
+
by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
|
|
20272
|
+
}).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
|
|
20273
|
+
return object({
|
|
20274
|
+
diagnosis,
|
|
20275
|
+
error: string2(),
|
|
20276
|
+
optedOutOfInvestigation
|
|
20277
|
+
});
|
|
20278
|
+
};
|
|
20279
|
+
|
|
20280
|
+
// node_modules/@qawolf/api-contracts/dist/v1/run/get.js
|
|
20281
|
+
var makeGetRunContract = (ids) => {
|
|
20282
|
+
const flowStatus = _enum(publicRunStatusValues);
|
|
20283
|
+
const input = object({
|
|
20284
|
+
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."),
|
|
20285
|
+
runId: ids.run
|
|
20286
|
+
});
|
|
20287
|
+
const attempts = makeFlowAttemptsSchema(ids);
|
|
20243
20288
|
const failedFlow = object({
|
|
20244
20289
|
attempts,
|
|
20245
20290
|
failure: makeFlowFailureSchema(ids),
|
|
@@ -20293,14 +20338,14 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
|
|
|
20293
20338
|
annotationJustifications: {
|
|
20294
20339
|
destructiveHint: "Ends the investigation of the selected failures and changes externally reported run information.",
|
|
20295
20340
|
openWorldHint: "Recorded opt-outs can update run-related messages in configured external integrations.",
|
|
20296
|
-
readOnlyHint: "Records failed flows as needing no bug or
|
|
20341
|
+
readOnlyHint: "Records failed flows as needing no bug report or blocker."
|
|
20297
20342
|
},
|
|
20298
20343
|
annotations: {
|
|
20299
20344
|
destructiveHint: true,
|
|
20300
20345
|
openWorldHint: true,
|
|
20301
20346
|
readOnlyHint: false
|
|
20302
20347
|
},
|
|
20303
|
-
description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug or
|
|
20348
|
+
description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug report or blocker. ' + "Each flow must have failed in the run and still be under investigation. " + "A flow that already has a diagnosis cannot be opted out. " + "A team or organization key records the opt-out as the workspace's automation user. " + "To link a failure to a report instead, use run.diagnose.",
|
|
20304
20349
|
input,
|
|
20305
20350
|
kind: "write",
|
|
20306
20351
|
name: "run.optOutOfInvestigation",
|
|
@@ -20311,13 +20356,20 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
|
|
|
20311
20356
|
// node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
|
|
20312
20357
|
var makeReattemptRunContract = (ids) => {
|
|
20313
20358
|
const input = object({
|
|
20359
|
+
afterCommit: string2().regex(/^[0-9a-f]{40}$/u, "afterCommit must be a full 40-character commit hash").optional().describe("A commit you published to the environment's flow code branch. " + "The request is refused until the environment has synced this " + "commit or a later one, so the new attempts run it. Omit to run " + "whatever code the environment has synced."),
|
|
20360
|
+
aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive the new attempts' results."),
|
|
20361
|
+
chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive the new attempts' results."),
|
|
20314
20362
|
flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").optional().describe("The flows to reattempt. Every named flow must be eligible or the " + "whole request is rejected. Omit to reattempt every eligible flow."),
|
|
20315
20363
|
runId: ids.run
|
|
20364
|
+
}).refine((value) => !(value.aiTaskId && value.chatSessionId), {
|
|
20365
|
+
message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
|
|
20366
|
+
path: ["chatSessionId"]
|
|
20316
20367
|
});
|
|
20317
20368
|
const output = resource({
|
|
20318
20369
|
reattemptedFlowIds: array(ids.flow).describe("The flows a new attempt was requested for."),
|
|
20319
20370
|
reattemptedInRunIds: array(ids.run).describe("The runs the new attempts were added to, which is where to poll " + "for their results. It is this run alone unless a flow had kept " + "failing in later runs, because the attempt then goes to the " + "latest of them."),
|
|
20320
|
-
runId: ids.run
|
|
20371
|
+
runId: ids.run,
|
|
20372
|
+
tracking: _enum(["registered", "failed", "not-requested"]).describe(`Whether the conversation named by aiTaskId or chatSessionId will receive the new attempts' results: "registered" when it will, "failed" when the attempts were requested but the registration failed, "not-requested" when neither id was given or the AI task has no conversation to notify.`)
|
|
20321
20373
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
20322
20374
|
return {
|
|
20323
20375
|
annotationJustifications: {
|
|
@@ -20330,7 +20382,7 @@ var makeReattemptRunContract = (ids) => {
|
|
|
20330
20382
|
openWorldHint: true,
|
|
20331
20383
|
readOnlyHint: false
|
|
20332
20384
|
},
|
|
20333
|
-
description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the
|
|
20385
|
+
description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the flow code the environment has synced when the " + "request arrives: after publishing a fix, pass afterCommit so the " + "request waits for that commit instead of rerunning older code. " + "Poll run.get for results, or pass aiTaskId or chatSessionId to be " + "notified when they settle.",
|
|
20334
20386
|
input,
|
|
20335
20387
|
kind: "write",
|
|
20336
20388
|
name: "run.reattempt",
|
|
@@ -20876,7 +20928,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
|
|
|
20876
20928
|
openWorldHint: false,
|
|
20877
20929
|
readOnlyHint: false
|
|
20878
20930
|
},
|
|
20879
|
-
description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
|
|
20931
|
+
description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
|
|
20880
20932
|
input,
|
|
20881
20933
|
kind: "read",
|
|
20882
20934
|
name: "runner.takeScreenshot",
|
|
@@ -23582,7 +23634,7 @@ function startUpdateCheck(deps) {
|
|
|
23582
23634
|
// package.json
|
|
23583
23635
|
var package_default = {
|
|
23584
23636
|
name: "@qawolf/cli",
|
|
23585
|
-
version: "2.1
|
|
23637
|
+
version: "2.2.1",
|
|
23586
23638
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
23587
23639
|
keywords: [
|
|
23588
23640
|
"automation",
|
|
@@ -23654,7 +23706,7 @@ var package_default = {
|
|
|
23654
23706
|
"@clack/prompts": "1.5.1",
|
|
23655
23707
|
"@napi-rs/keyring": "1.3.0",
|
|
23656
23708
|
"@oxc-node/core": "0.1.0",
|
|
23657
|
-
"@qawolf/api-contracts": "0.
|
|
23709
|
+
"@qawolf/api-contracts": "0.98.1",
|
|
23658
23710
|
"@qawolf/emails": "1.1.1",
|
|
23659
23711
|
"@qawolf/flow-targets": "2.0.0",
|
|
23660
23712
|
"@qawolf/flows": "0.3.0",
|
|
@@ -24164,15 +24216,6 @@ async function handleAgentGet(ctx, options, deps) {
|
|
|
24164
24216
|
// src/shell/agent/sessionStore.ts
|
|
24165
24217
|
import { join as join14 } from "node:path";
|
|
24166
24218
|
|
|
24167
|
-
// src/core/parseJson.ts
|
|
24168
|
-
function parseJson(text) {
|
|
24169
|
-
try {
|
|
24170
|
-
return JSON.parse(text);
|
|
24171
|
-
} catch {
|
|
24172
|
-
return;
|
|
24173
|
-
}
|
|
24174
|
-
}
|
|
24175
|
-
|
|
24176
24219
|
// src/shell/jsonFile.ts
|
|
24177
24220
|
var pendingWrites = 0;
|
|
24178
24221
|
async function readJsonFile(fs, path, schema) {
|
|
@@ -38770,9 +38813,10 @@ function buildRunnerAction(type, flags) {
|
|
|
38770
38813
|
const to = flags.to === undefined ? undefined : parsePoint("--to", flags.to);
|
|
38771
38814
|
if (to !== undefined && !to.ok)
|
|
38772
38815
|
return to;
|
|
38816
|
+
const button = flags.button ?? (type === "click" ? "left" : undefined);
|
|
38773
38817
|
const candidate = {
|
|
38774
38818
|
type,
|
|
38775
|
-
...
|
|
38819
|
+
...button === undefined ? {} : { button },
|
|
38776
38820
|
...flags.durationMs === undefined ? {} : { duration_ms: toNumber(flags.durationMs) },
|
|
38777
38821
|
...from === undefined ? {} : { from: from.value },
|
|
38778
38822
|
...flags.keys === undefined ? {} : { keys: flags.keys },
|
|
@@ -39354,7 +39398,7 @@ On mobile, send tap and swipe, never click or drag. The other browser actions, d
|
|
|
39354
39398
|
|
|
39355
39399
|
# Before the first run
|
|
39356
39400
|
|
|
39357
|
-
A runner
|
|
39401
|
+
A playwright runner's screen starts as it launches, so act works on it before anything has run. Any other runner has no screen until its first run, so act exits 2 on it until then. With no runner named at all, act launches one and says so on stderr.
|
|
39358
39402
|
`;
|
|
39359
39403
|
|
|
39360
39404
|
// src/commands/runner/guides/actions.txt
|
|
@@ -39401,7 +39445,7 @@ History is not unbounded: a size cap drops the oldest entries on a long-lived ru
|
|
|
39401
39445
|
$ qawolf runner events recorder --tail 5 | jq -r '.code // .type'
|
|
39402
39446
|
$ qawolf runner events recorder --tail 5 | jq -r '[.locator] + (.alternates // []) | @tsv'
|
|
39403
39447
|
|
|
39404
|
-
\`code\` is absent on events with no call of their own, such as a navigation, which is why the first line falls back to \`type\`. Use these to turn a session you drove by pixel coordinates into durable selectors, and to check that a click landed on the element you meant rather than near it. The stream
|
|
39448
|
+
\`code\` is absent on events with no call of their own, such as a navigation, which is why the first line falls back to \`type\`. Use these to turn a session you drove by pixel coordinates into durable selectors, and to check that a click landed on the element you meant rather than near it. The stream stays empty while a playwright runner still shows its welcome page, and on any other runner until its first run, so an early empty answer means "not yet", not "broken". Do not add --json here: it wraps each line in an envelope and these field paths stop matching.
|
|
39405
39449
|
|
|
39406
39450
|
# Following
|
|
39407
39451
|
|
|
@@ -39428,7 +39472,7 @@ The snippet imports nothing of yours by default. Pass --file <path> to evaluate
|
|
|
39428
39472
|
|
|
39429
39473
|
# Failures
|
|
39430
39474
|
|
|
39431
|
-
|
|
39475
|
+
A playwright runner has a page to evaluate against as soon as it launches. On a 4 the message says the snippet could not be evaluated, but a lost answer looks the same from outside, so treat a 4 from a snippet that changes something as "may have run" rather than "did not run", and check its effect before running it again. With no runner named at all, exec launches one and says so on stderr.
|
|
39432
39476
|
`;
|
|
39433
39477
|
|
|
39434
39478
|
// src/commands/runner/guides/formatGuide.ts
|
|
@@ -39515,27 +39559,12 @@ It is a read with a cost: keeping the clock reset keeps a billed pod alive. Call
|
|
|
39515
39559
|
`;
|
|
39516
39560
|
|
|
39517
39561
|
// src/commands/runner/guides/launch.txt
|
|
39518
|
-
var launch_default =
|
|
39519
|
-
|
|
39520
|
-
Runner ids are yours to choose and are scoped to your team, so agent-1 is a fine id. Launching an id that is already running attaches to that runner instead of starting and billing a second one, and the answer says which happened: read \`alreadyRunning\`. Reusing one id is therefore the cheap and safe pattern. The same id with a different --name is refused rather than silently ignored.
|
|
39521
|
-
|
|
39522
|
-
launch takes its id from --id and never reads QAWOLF_RUNNER_ID. A bare \`qawolf runner launch\` invents a random id, bills a pod under it and stores it, so a harness that exported the variable and then launched without --id ends up with a pod it is not addressing. Pass --id whenever you have an id in mind.
|
|
39523
|
-
|
|
39524
|
-
Launching an id that differs from QAWOLF_RUNNER_ID prints a warning on stderr naming both ids: the variable still outranks the directory default, so commands that omit --runner keep going to whatever it names, not the runner you just launched. That is expected when you launch an additional runner on purpose. Address that one with --runner rather than re-exporting the variable, which would repoint every other runner-less command too.
|
|
39525
|
-
|
|
39526
|
-
# The page
|
|
39527
|
-
|
|
39528
|
-
Either answer carries a \`url\`, which launch prints, as does a command that launched its own runner. It is a QA Wolf page showing what the runner is doing, where a person can also take over with their own mouse and keyboard. Hand it to a person who asks what your runner is up to. The page opens for anyone on the runner's team, however the runner was launched. There is nothing to see until the runner's first run starts its screen, so the page waits until then. You read the screen with \`screenshot\`, not with the page.
|
|
39529
|
-
|
|
39530
|
-
# Browser or mobile
|
|
39531
|
-
|
|
39532
|
-
--name also chooses between a browser and a mobile device: --name android or --name ios starts an Appium session instead of a browser. A command built for the other kind answers a failureReason naming the mismatch rather than doing something approximate: runner-is-not-mobile from inspect session, contexts, page-source and elements on a browser runner, and runner-is-not-a-browser from inspect element-html and page-html on a mobile one. Launch the right family up front rather than discovering it from a refusal mid-session.
|
|
39533
|
-
`;
|
|
39562
|
+
var launch_default = "# Ids\n\nRunner ids are yours to choose and are scoped to your team, so agent-1 is a fine id. Launching an id that is already running attaches to that runner instead of starting and billing a second one, and the answer says which happened: read `alreadyRunning`. Reusing one id is therefore the cheap and safe pattern. --name does not change a runner that is already running: the answer's `runnerName` says what you attached to.\n\nlaunch takes its id from --id and never reads QAWOLF_RUNNER_ID. A bare `qawolf runner launch` invents a random id, bills a pod under it and stores it, so a harness that exported the variable and then launched without --id ends up with a pod it is not addressing. Pass --id whenever you have an id in mind.\n\nLaunching an id that differs from QAWOLF_RUNNER_ID prints a warning on stderr naming both ids: the variable still outranks the directory default, so commands that omit --runner keep going to whatever it names, not the runner you just launched. That is expected when you launch an additional runner on purpose. Address that one with --runner rather than re-exporting the variable, which would repoint every other runner-less command too.\n\n# The page\n\nEither answer carries a `url`, which launch prints, as does a command that launched its own runner. It is a QA Wolf page showing what the runner is doing, where a person can also take over with their own mouse and keyboard. Hand it to a person who asks what your runner is up to. The page opens for anyone on the runner's team, however the runner was launched. A playwright runner's screen starts as it launches, showing a QA Wolf welcome page. Any other runner's screen starts with its first run, so its page waits until then. You read the screen with `screenshot`, not with the page.\n\n# Browser or mobile\n\n--name also chooses between a browser and a mobile device: --name android or --name ios starts an Appium session instead of a browser. A command built for the other kind answers a failureReason naming the mismatch rather than doing something approximate: runner-is-not-mobile from inspect session, contexts, page-source and elements on a browser runner, and runner-is-not-a-browser from inspect element-html and page-html on a mobile one. Launch the right family up front rather than discovering it from a refusal mid-session.\n";
|
|
39534
39563
|
|
|
39535
39564
|
// src/commands/runner/guides/list.txt
|
|
39536
39565
|
var list_default = `# What the list holds
|
|
39537
39566
|
|
|
39538
|
-
The list names the
|
|
39567
|
+
The list names every active runner on your team, marking the ones this directory launched and the default, the one a command with no --runner would reach. --here keeps only this directory's runners and the one QAWOLF_RUNNER_ID names. Use the id column with --runner to address any of them; addressing one does not make it the default.
|
|
39539
39568
|
|
|
39540
39569
|
Every runner is looked up before it is listed, so a runner that idled out is absent rather than reported. The lookup neither starts a runner nor resets an inactivity clock, which is what separates list from keepalive: listing tells you what is there and changes nothing. A lookup that cannot be answered fails the command rather than returning a shorter list, because a short list reads as the whole truth.
|
|
39541
39570
|
|
|
@@ -39626,7 +39655,7 @@ var screenshot_default = `# Reading the screen
|
|
|
39626
39655
|
|
|
39627
39656
|
The image is a real JPEG on disk, decoded, because every coding harness can open an image file. Read it with whatever vision you have. --out - writes the JPEG bytes to stdout instead, on their own, for a caller that is a process rather than an agent: the confirmation, and the JSON line under --json, goes to stderr so nothing follows the image on stdout. A terminal on stdout is refused: redirect or pipe it.
|
|
39628
39657
|
|
|
39629
|
-
A runner has no screen until its first run, so until then screenshot exits 2. It never launches a runner. When you are about to act anyway, \`act --screenshot\` performs the action and returns the screen in one call.
|
|
39658
|
+
A playwright runner's screen starts as it launches. Any other runner has no screen until its first run, so until then screenshot exits 2 on it. It never launches a runner. When you are about to act anyway, \`act --screenshot\` performs the action and returns the screen in one call.
|
|
39630
39659
|
`;
|
|
39631
39660
|
|
|
39632
39661
|
// src/commands/runner/guides/stopOrTerminate.txt
|
|
@@ -39640,7 +39669,7 @@ Both succeed when there was nothing to do, and say which: \`wasRunning\` is fals
|
|
|
39640
39669
|
`;
|
|
39641
39670
|
|
|
39642
39671
|
// src/commands/runner/guides/workflow.md
|
|
39643
|
-
var workflow_default = "An interactive runner is a live pod with a browser or a mobile device in it. You launch one, look at it, act on it, run flows on it, and read what it recorded. Everything is a plain request to one host, so there is no connection to hold open. This guide covers what spans commands; each command's own help below covers the rest.\n\n## Which runner a command reaches\n\nCommands that target a runner find one in this order: `--runner`, then `QAWOLF_RUNNER_ID`, then the runner stored for the current directory, which `qawolf runner launch` sets. Setting the environment variable once is the most robust for a harness whose working directory may not be stable, with two catches:\n\n- `qawolf runner launch` is not in that order: it takes its id from `--id` and never reads `QAWOLF_RUNNER_ID`. Pass `--id` whenever you have an id in mind.\n- A runner id that is set is treated as found, whether or not anything is running under it. Exporting `QAWOLF_RUNNER_ID=agent-1` turns off the auto-launch described next: instead of starting `agent-1`, commands try to reach it and fail with exit code `8`, naming the id and saying the variable is what chose it. Launch that id once yourself and the rest follows.\n\nIf nothing names a runner, the commands that change something launch one and say so on stderr, naming it: `run`, `act` and `exec`. Read that announcement. The browser it just started is fresh: nothing has been run on it, nothing is signed in, and
|
|
39672
|
+
var workflow_default = "An interactive runner is a live pod with a browser or a mobile device in it. You launch one, look at it, act on it, run flows on it, and read what it recorded. Everything is a plain request to one host, so there is no connection to hold open. This guide covers what spans commands; each command's own help below covers the rest.\n\n## Which runner a command reaches\n\nCommands that target a runner find one in this order: `--runner`, then `QAWOLF_RUNNER_ID`, then the runner stored for the current directory, which `qawolf runner launch` sets. Setting the environment variable once is the most robust for a harness whose working directory may not be stable, with two catches:\n\n- `qawolf runner launch` is not in that order: it takes its id from `--id` and never reads `QAWOLF_RUNNER_ID`. Pass `--id` whenever you have an id in mind.\n- A runner id that is set is treated as found, whether or not anything is running under it. Exporting `QAWOLF_RUNNER_ID=agent-1` turns off the auto-launch described next: instead of starting `agent-1`, commands try to reach it and fail with exit code `8`, naming the id and saying the variable is what chose it. Launch that id once yourself and the rest follows.\n\nIf nothing names a runner, the commands that change something launch one and say so on stderr, naming it: `run`, `act`, `actions` and `exec`. Read that announcement. The browser it just started is fresh: nothing has been run on it, nothing is signed in, and it shows only the QA Wolf welcome page. Acting as though your earlier setup survived is the single most likely way to drive the wrong page.\n\nNo read command ever launches a runner. `screenshot`, `events` and `keepalive` tell you there is no runner rather than quietly billing one, and so does `terminate`.\n\n## The order that matters\n\nA playwright runner's screen starts as it launches, showing a QA Wolf welcome page, so the screenshot-and-act loop works before you run anything.\n\nAny other runner, such as a mobile one, has no screen until its first run, and nothing else starts it. Until you have run something on it, `screenshot` and `act` fail with exit code `2`. That is not a fault, and it does not clear on its own: run a flow with `qawolf runner run <flow>`, which needs a flow file and a `package.json` on disk.\n\n## Exit codes\n\nRetry on the exit code, not on the message text:\n\n- `4` is transient, with one exception. The screen cannot serve this instant: still coming up just after launch, restarting after a display-size change, or busy with another request. Retry in a second or two, and bound the retries. The exception is a command that changes something, where a `4` can instead mean the answer was lost with the work in flight. For `act` and `actions`, take a screenshot first and repeat only what the screen says did not happen. For `run`, poll `run-status` instead of submitting again, since a second submission risks a second billed run. For `exec`, check the effect the snippet was meant to have before running it again.\n- `6` means the work ran out of the time it is given.\n- `7` means billing prevented the request, such as a plan that does not cover the runner you asked for. The message says what was refused and what clears it.\n- `8` means there is no such runner. It was never launched, or it was terminated, or it idled out. Retrying never brings one back, so stop and launch the id or name one that is running. The message says which runner was meant and whether `--runner`, `QAWOLF_RUNNER_ID` or this directory's stored default chose it; read that line before you pick an id to launch.\n- `2` will not clear on its own. Nothing has run on this runner yet, so run a flow; or the runner has no browser at all, so launch with `--name playwright` instead; or the action belongs to the other runner family, so send `tap`, `swipe` or `fill` to a mobile runner and the browser actions to a browser runner. The message says which.\n\n`act`, `actions`, `run` and `exec` are the commands whose lost answer may still have taken effect.\n\n## End to end\n\nRun from a directory holding a flow and a `package.json`.\n\n```sh\nexport QAWOLF_API_KEY=... # the only credential\nexport QAWOLF_RUNNER_ID=agent-1 # so no command below needs --runner\n\nqawolf runner launch --id agent-1 --json # --id, not the variable; read .alreadyRunning and .url\nqawolf runner run flows/smoke.flow.ts --follow # exit 1 if it failed\n\nqawolf runner act navigate --url https://example.com/login --screenshot step-1.jpg # then read step-1.jpg yourself\nqawolf runner act click --button left --x 480 --y 260 --screenshot step-2.jpg\nqawolf runner act type --text \"someone@example.com\" --screenshot step-3.jpg\n\nqawolf runner inspect element-html --selector \"#email\"\nqawolf runner inspect variable --name cart | jq .total\n\nqawolf runner run flows/smoke.flow.ts --lines 12-40 --follow # just those lines\nqawolf runner events recorder --tail 5 | jq -r '[.locator] + (.alternates // []) | @tsv'\nqawolf runner terminate\n```\n\nOn a mobile runner, launch with `--name android` or `--name ios`, and drive it with `tap`, `swipe`, `fill` and `type` instead of the browser actions.\n";
|
|
39644
39673
|
|
|
39645
39674
|
// src/commands/runner/guides/index.ts
|
|
39646
39675
|
var runnerGuides = {
|
|
@@ -40587,7 +40616,7 @@ Examples:
|
|
|
40587
40616
|
$ qawolf runner screenshot --out - | my-vision-tool`;
|
|
40588
40617
|
function registerRunnerInteractCommands(runner, signals) {
|
|
40589
40618
|
declareCommandKind(runner.command("screenshot"), "read").description("Save a JPEG of an interactive runner's screen to a file, or write it to stdout with --out -").option("--out <path>", "File to write the image to. - writes the JPEG bytes to stdout on their own and moves the confirmation, JSON included, to stderr", defaultScreenshotPath).option("--runner <id>", runnerFlagDescription).addHelpText("after", screenshotExamples).addHelpText("after", runnerGuides.screenshot).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerScreenshot(ctx, { out: opts.out, runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
40590
|
-
declareCommandKind(runner.command("act <action>"), "write").description("Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin").option("--button <button>", "click: left, right, wheel, back or forward").option("--duration-ms <ms>", "swipe: how long it takes, up to 10000. Slow scrolls, fast flings").option("--from <x,y>", "swipe: the point it starts at").option("--keys <keys...>", "keypress: modifiers and the key, e.g. Control a").option("--path <json>", "drag: JSON array of points to drag through").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Also save a JPEG of the screen, taken after the action, to this file, in place of a separate screenshot. An action that did not take effect answers with one too. - writes it to stdout and moves the confirmation, JSON included, to stderr").option("--scroll-x <delta>", "scroll: horizontal wheel delta").option("--scroll-y <delta>", "scroll: vertical wheel delta").option("--selector <selector>", "tap or fill: the element to act on, as a screen object would find it. tap takes it in place of --x and --y").option("--strategy <strategy>", "how --selector is resolved: xpath (default), ios-predicate or shadow").option("--text <text>", "type: the text to type into what has focus. fill: the field's new value").option("--to <x,y>", "swipe: the point it ends at").option("--url <url>", "navigate: the http or https URL to go to").option("--x <pixels>", "click, tap and the like: x, in screenshot pixels").option("--y <pixels>", "click, tap and the like: y, in screenshot pixels").addHelpText("after", actExamples).addHelpText("after", runnerGuides.act).action((action, opts, command) => withAuthContext(signals, (ctx) => handleRunnerAct(ctx, {
|
|
40619
|
+
declareCommandKind(runner.command("act <action>"), "write").description("Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin").option("--button <button>", "click: left (default), right, wheel, back or forward").option("--duration-ms <ms>", "swipe: how long it takes, up to 10000. Slow scrolls, fast flings").option("--from <x,y>", "swipe: the point it starts at").option("--keys <keys...>", "keypress: modifiers and the key, e.g. Control a").option("--path <json>", "drag: JSON array of points to drag through").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Also save a JPEG of the screen, taken after the action, to this file, in place of a separate screenshot. An action that did not take effect answers with one too. - writes it to stdout and moves the confirmation, JSON included, to stderr").option("--scroll-x <delta>", "scroll: horizontal wheel delta").option("--scroll-y <delta>", "scroll: vertical wheel delta").option("--selector <selector>", "tap or fill: the element to act on, as a screen object would find it. tap takes it in place of --x and --y").option("--strategy <strategy>", "how --selector is resolved: xpath (default), ios-predicate or shadow").option("--text <text>", "type: the text to type into what has focus. fill: the field's new value").option("--to <x,y>", "swipe: the point it ends at").option("--url <url>", "navigate: the http or https URL to go to").option("--x <pixels>", "click, tap and the like: x, in screenshot pixels").option("--y <pixels>", "click, tap and the like: y, in screenshot pixels").addHelpText("after", actExamples).addHelpText("after", runnerGuides.act).action((action, opts, command) => withAuthContext(signals, (ctx) => handleRunnerAct(ctx, {
|
|
40591
40620
|
flags: {
|
|
40592
40621
|
button: opts.button,
|
|
40593
40622
|
durationMs: opts.durationMs,
|
|
@@ -40725,7 +40754,7 @@ async function handleRunnerList(ctx, options, deps) {
|
|
|
40725
40754
|
if (!listed.ok) {
|
|
40726
40755
|
return { ...failureFields(listed), exitCode: exitCodes.network };
|
|
40727
40756
|
}
|
|
40728
|
-
const items = options.here ? listed.items.filter((item) => item.launchedHere) : listed.items;
|
|
40757
|
+
const items = options.here ? listed.items.filter((item) => item.launchedHere || item.isDefault) : listed.items;
|
|
40729
40758
|
if (ctx.ui.mode === "json") {
|
|
40730
40759
|
ctx.ui.json(items);
|
|
40731
40760
|
return;
|
|
@@ -40801,7 +40830,7 @@ Examples:
|
|
|
40801
40830
|
$ qawolf runner keepalive --runner ci`;
|
|
40802
40831
|
function registerRunnerLifecycleCommands(runner, signals) {
|
|
40803
40832
|
declareCommandKind(runner.command("launch"), "write").description("Launch an interactive runner and make it this directory's default").option("--id <id>", "Id to launch under. Relaunching an id attaches to that runner").option("--name <family>", "Runner family to run, e.g. playwright").addHelpText("after", launchExamples).addHelpText("after", runnerGuides.launch).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerLaunch(ctx, { id: opts.id, name: opts.name }, runnerDeps(ctx)))(opts, command));
|
|
40804
|
-
declareCommandKind(runner.command("list"), "read").description("List the runners running on your team").option("--here", "Only the runners this directory launched").addHelpText("after", listExamples2).addHelpText("after", runnerGuides.list).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
|
|
40833
|
+
declareCommandKind(runner.command("list"), "read").description("List the runners running on your team").option("--here", "Only the runners this directory launched or QAWOLF_RUNNER_ID names").addHelpText("after", listExamples2).addHelpText("after", runnerGuides.list).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
|
|
40805
40834
|
declareCommandKind(runner.command("terminate"), "write").description("End an interactive runner, and the pod it runs on with it").option("--runner <id>", runnerFlagDescription).addHelpText("after", runnerGuides.stopOrTerminate).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerTerminate(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
40806
40835
|
declareCommandKind(runner.command("stop-run"), "write").description("Stop what a runner is currently executing, leaving the runner up").option("--runner <id>", runnerFlagDescription).addHelpText("after", runnerGuides.stopOrTerminate).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerStopRun(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
40807
40836
|
declareCommandKind(runner.command("keepalive"), "read").description("Reset a runner's inactivity clock, for a caller that pauses between actions").option("--runner <id>", runnerFlagDescription).addHelpText("after", keepaliveExamples).addHelpText("after", runnerGuides.keepalive).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerKeepalive(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
@@ -41787,4 +41816,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
41787
41816
|
process.exitCode = 1;
|
|
41788
41817
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
41789
41818
|
|
|
41790
|
-
//# debugId=
|
|
41819
|
+
//# debugId=F8E2C24048CC67D764756E2164756E21
|