@qawolf/cli 2.2.2 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +424 -57
- package/dist/runner-sdk.js +373 -22
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +14 -0
- package/skills/qawolf-cli/references/run-results.md +15 -0
- package/skills/qawolf-cli/references/runner.md +292 -44
package/dist/cli.js
CHANGED
|
@@ -8405,7 +8405,7 @@ var agentMessages = {
|
|
|
8405
8405
|
conflictingSessionList: "Pass --sessions alone, without --session or a session argument.",
|
|
8406
8406
|
emptySessionList: "Pass at least one session id with --sessions.",
|
|
8407
8407
|
sessionListNeedsFollow: "Pass --follow when using --sessions.",
|
|
8408
|
-
answerSendFailed: (reason) => `The answer could not be sent: ${reason}. The session is still waiting, so try again.`,
|
|
8408
|
+
answerSendFailed: (reason) => `The answer could not be sent: ${reason.replace(/\.$/, "")}. The session is still waiting, so try again.`,
|
|
8409
8409
|
blocked: (sessionId) => `QA Wolf asked a question and cannot continue until it is answered. Answer it with qawolf agent send "<your answer>" --session ${sessionId}.`,
|
|
8410
8410
|
detachHint: "Press Ctrl-C to stop following. The session keeps running in the background.",
|
|
8411
8411
|
detached: (sessionId) => `Stopped following. The session is still running — pick it back up with ${followAgain(sessionId)}.`,
|
|
@@ -8450,6 +8450,7 @@ var authErrorMessages = {
|
|
|
8450
8450
|
notFound404Record: (noun, id) => `QA Wolf has no ${noun} ${id} (HTTP 404).`,
|
|
8451
8451
|
notFound404: (noun) => noun === undefined ? "QA Wolf found nothing matching the request (HTTP 404)." : `QA Wolf found nothing matching the ${noun} request (HTTP 404).`,
|
|
8452
8452
|
failedWithStatus: (status, noun) => `QA Wolf API${noun ? ` ${noun}` : ""} request failed (HTTP ${status}).`,
|
|
8453
|
+
notSent: "Nothing was sent, so this request did not take effect.",
|
|
8453
8454
|
networkUnreachable: (options) => `Could not reach the QA Wolf API at ${options.baseUrl}${options.noun ? ` to fetch ${options.noun}` : ""}${options.cause ? ` (${options.cause})` : ""}. Check your network connection and QAWOLF_HOST_URL.`,
|
|
8454
8455
|
timedOut: (timeoutMs, noun) => `The QA Wolf API${noun ? ` ${noun}` : ""} request timed out after ${formatSeconds(timeoutMs)}. The work may still be finishing on the platform.`,
|
|
8455
8456
|
unexpectedResponse: (noun) => `Unexpected${noun ? ` ${noun}` : ""} response from the QA Wolf API.`
|
|
@@ -15677,9 +15678,9 @@ async function requestWithRetry(args) {
|
|
|
15677
15678
|
const unreachable = result.error.kind === "network" || result.error.kind === "timeout";
|
|
15678
15679
|
return {
|
|
15679
15680
|
ok: false,
|
|
15680
|
-
...args.describe(result.error),
|
|
15681
15681
|
...mayHaveArrived ? { mayHaveArrived } : {},
|
|
15682
|
-
...unreachable ? { unreachable } : {}
|
|
15682
|
+
...unreachable ? { unreachable } : {},
|
|
15683
|
+
...args.describe(result.error)
|
|
15683
15684
|
};
|
|
15684
15685
|
}
|
|
15685
15686
|
await sleep2(backoff);
|
|
@@ -15694,6 +15695,13 @@ function callPublicApi(trpc, contract, input, options) {
|
|
|
15694
15695
|
}
|
|
15695
15696
|
return trpc.mutation(path, input, contract.output, options);
|
|
15696
15697
|
}
|
|
15698
|
+
var notSentCodes = new Set([
|
|
15699
|
+
"ConnectionRefused",
|
|
15700
|
+
"EAI_AGAIN",
|
|
15701
|
+
"ECONNREFUSED",
|
|
15702
|
+
"ENOTFOUND",
|
|
15703
|
+
"UND_ERR_CONNECT_TIMEOUT"
|
|
15704
|
+
]);
|
|
15697
15705
|
function makeCallPublicApiMethod(trpc, deps, readBackoffMs) {
|
|
15698
15706
|
return async (contract, input, options) => {
|
|
15699
15707
|
const sent = applyWorkspaceId(contract.input, input, deps.workspaceId);
|
|
@@ -15701,7 +15709,17 @@ function makeCallPublicApiMethod(trpc, deps, readBackoffMs) {
|
|
|
15701
15709
|
return requestWithRetry({
|
|
15702
15710
|
call: () => callPublicApi(trpc, contract, sent, options),
|
|
15703
15711
|
backoffMs: contract.kind === "read" ? readBackoffMs : [],
|
|
15704
|
-
describe: (err) =>
|
|
15712
|
+
describe: (err) => {
|
|
15713
|
+
const failure = describeRequestError(err, deps.baseUrl, contract.name, subject);
|
|
15714
|
+
const code = err.kind === "network" ? errorCode(err.cause.cause) ?? errorCode(err.cause) : undefined;
|
|
15715
|
+
if (contract.kind !== "write" || !code || !notSentCodes.has(code))
|
|
15716
|
+
return failure;
|
|
15717
|
+
return {
|
|
15718
|
+
...failure,
|
|
15719
|
+
error: `${failure.error} ${authMessages.errors.request.notSent}`,
|
|
15720
|
+
mayHaveArrived: false
|
|
15721
|
+
};
|
|
15722
|
+
},
|
|
15705
15723
|
sleep: deps.sleep
|
|
15706
15724
|
});
|
|
15707
15725
|
};
|
|
@@ -16584,7 +16602,8 @@ function createTrpcClient(apiKey, deps) {
|
|
|
16584
16602
|
return withLogging(path, () => sendWireRequest(deps.fetch, url, {
|
|
16585
16603
|
body,
|
|
16586
16604
|
headers: { ...authHeader, "content-type": "application/json" },
|
|
16587
|
-
method: "POST"
|
|
16605
|
+
method: "POST",
|
|
16606
|
+
redirect: "error"
|
|
16588
16607
|
}, schema, options?.timeoutMs ?? defaultTimeoutMs));
|
|
16589
16608
|
}
|
|
16590
16609
|
};
|
|
@@ -17113,6 +17132,37 @@ var defaultIdSchemas = {
|
|
|
17113
17132
|
};
|
|
17114
17133
|
var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
|
|
17115
17134
|
|
|
17135
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
|
|
17136
|
+
var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
|
|
17137
|
+
var buildIdSchema = string2().regex(/^[a-z0-9]{24}obld$/, "Expected a build id from build.requestUpload.").describe("The id of the build, from build.requestUpload.");
|
|
17138
|
+
var makeBuildResourceSchema = (ids) => resource({
|
|
17139
|
+
appId: string2().describe("The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
|
|
17140
|
+
appName: string2().optional().describe("The app's display name, when the file names one."),
|
|
17141
|
+
branch: string2().optional().describe("The branch the uploader said the build came from."),
|
|
17142
|
+
buildNumber: string2().optional().describe("versionCode (Android) or CFBundleVersion (iOS), when the file has one."),
|
|
17143
|
+
commitSha: string2().optional().describe("The commit the uploader said the build came from."),
|
|
17144
|
+
createdAt: exports_iso.datetime().describe("When the build was created."),
|
|
17145
|
+
deletedAt: exports_iso.datetime().optional().describe("When the build was deleted. Runs never install it after."),
|
|
17146
|
+
environmentId: ids.environment.optional().describe("The environment whose runs install the build while it is the newest one there for its app and platform. Absent: only a run created with the build installs it."),
|
|
17147
|
+
fileName: string2().describe("The uploaded file's name."),
|
|
17148
|
+
id: buildIdSchema,
|
|
17149
|
+
platform: buildPlatformSchema,
|
|
17150
|
+
sizeBytes: number2().int().optional().describe("The file's size in bytes."),
|
|
17151
|
+
version: string2().optional().describe("versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.")
|
|
17152
|
+
}, { urlFieldDescription: "Absolute URL of the team's Builds page." });
|
|
17153
|
+
var makeBuildEnvironmentSelectorSchema = (ids) => union([
|
|
17154
|
+
strictObject({
|
|
17155
|
+
id: ids.environment.describe("The id of an existing environment. Never creates an environment. Send an alias through name instead.")
|
|
17156
|
+
}),
|
|
17157
|
+
strictObject({
|
|
17158
|
+
baseEphemeralEnvironment: string2().trim().min(1).max(255).optional().describe("The alias or name of the environment a created ephemeral environment copies from. Only valid with ephemeral."),
|
|
17159
|
+
ephemeral: boolean2().optional().describe("Requests an ephemeral environment when the name creates one, such as a pull request's. A name that matches an existing environment keeps that environment's kind."),
|
|
17160
|
+
name: string2().trim().min(1).max(255).describe("The environment's alias or name, as deployment.reportStatus takes it. Creates the environment when none matches. It keeps its base's URL.")
|
|
17161
|
+
})
|
|
17162
|
+
], {
|
|
17163
|
+
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
17164
|
+
});
|
|
17165
|
+
|
|
17116
17166
|
// node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
|
|
17117
17167
|
var makeFlowSelectionSchema = (ids) => object({
|
|
17118
17168
|
flowIds: array(ids.flow).default([]),
|
|
@@ -17125,6 +17175,7 @@ var makeFlowSelectionSchema = (ids) => object({
|
|
|
17125
17175
|
var makeCreateRunContract = (ids) => {
|
|
17126
17176
|
const input = object({
|
|
17127
17177
|
aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
|
|
17178
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("Builds to install in this run only. Each replaces the environment's latest build of its app and platform."),
|
|
17128
17179
|
chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
|
|
17129
17180
|
environmentId: ids.environmentRef,
|
|
17130
17181
|
environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
|
|
@@ -17589,14 +17640,14 @@ var makeInspectMobileOnRunnerContract = (ids) => {
|
|
|
17589
17640
|
annotationJustifications: {
|
|
17590
17641
|
destructiveHint: "Does not change application data, edit tests, or stop the runner.",
|
|
17591
17642
|
openWorldHint: "Inspects the existing QA Wolf mobile runner without submitting application actions or contacting arbitrary services.",
|
|
17592
|
-
readOnlyHint: "Reads mobile session status, contexts, page source, or elements
|
|
17643
|
+
readOnlyHint: "Reads mobile session status, contexts, page source, or elements and refreshes activity, which can cancel an inactivity shutdown."
|
|
17593
17644
|
},
|
|
17594
17645
|
annotations: {
|
|
17595
17646
|
destructiveHint: false,
|
|
17596
17647
|
openWorldHint: false,
|
|
17597
|
-
readOnlyHint:
|
|
17648
|
+
readOnlyHint: false
|
|
17598
17649
|
},
|
|
17599
|
-
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This
|
|
17650
|
+
description: `Inspect one thing on a mobile or Windows interactive runner: the Appium session's status, the contexts available (WebViews on mobile, top-level windows on Windows), the current context's page source, or the elements at a point, carrying some text, or matching a selector. This refreshes the inactivity timer and can extend the runner's billed lifetime. Mobile and Windows only — a browser runner answers \`runner-is-not-mobile\`; call \`runner.inspect\` for a browser's equivalent surface instead. \`what: "session"\` always answers with the session's own status rather than \`screen-needs-a-run\`, since that is the question it exists to answer; the other three request kinds need a live session first and answer the same \`screen-needs-a-run\` or \`screen-not-ready\` outcomes \`runner.performAction\` and \`runner.takeScreenshot\` use, instead of reading anything when there is none. \`screen-needs-a-run\` means no Appium session has started on this runner yet — call \`runner.runFlow\` with a flow that opens one, then inspect again. \`screen-not-ready\` means the runner's Appium session exists but did not answer this instant, or more than one is somehow live — retry once; if it persists, relaunch the runner. \`runner-is-not-mobile\` means there is nothing here to inspect, and retrying will never help — launch an \`android\`, \`ios\` or \`windows\` runner instead. \`invalid-selector\` (elements by selector only) means the selector itself could not be parsed under the given \`strategy\` — distinct from a selector that parsed fine but matched nothing, which answers \`matches: []\` instead. ${retryableRunnerUnreachableDescription}`,
|
|
17600
17651
|
input,
|
|
17601
17652
|
kind: "read",
|
|
17602
17653
|
name: "runner.inspectMobile",
|
|
@@ -17963,7 +18014,7 @@ var makeRecordOnRunnerContract = (ids) => {
|
|
|
17963
18014
|
openWorldHint: false,
|
|
17964
18015
|
readOnlyHint: false
|
|
17965
18016
|
},
|
|
17966
|
-
description: "Control video recording on a
|
|
18017
|
+
description: "Control video recording on a browser, mobile, Windows, or Mac runner. Start requires a caller-generated UUID; stop targets that UUID so retries cannot stop a later recording. Manual capture spans runs and suppresses automatic capture. Auto settings affect subsequent full runs. The URL opens recording history after the runner terminates. Videos may be unavailable after abrupt pod loss.",
|
|
17967
18018
|
input,
|
|
17968
18019
|
kind: "write",
|
|
17969
18020
|
name: "runner.record",
|
|
@@ -18043,6 +18094,7 @@ var makeTriggerActionSchema = (ids) => object({
|
|
|
18043
18094
|
investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
|
|
18044
18095
|
kind: triggerActionKindSchema.default("createSuite"),
|
|
18045
18096
|
runConcurrencyLimit: string2().trim().min(1).max(255).optional().describe(`How many runs of the resulting suite may execute at once: a whole number from 1 to 1000, "unlimited", or a concurrency expression, which the server validates. It replaces the environment's limit rather than capping below it. Omit it to leave the environment's limit in charge.`),
|
|
18097
|
+
suggestCoverage: boolean2().optional().describe("Whether QA Wolf explores the environment after the resulting runs and suggests coverage that nothing tests yet. Defaults to false."),
|
|
18046
18098
|
tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
|
|
18047
18099
|
}).describe("What the trigger runs when it fires.");
|
|
18048
18100
|
var makeTriggerScheduleFields = (ids) => ({
|
|
@@ -18565,6 +18617,173 @@ var makeGetAttemptContract = (ids) => {
|
|
|
18565
18617
|
};
|
|
18566
18618
|
};
|
|
18567
18619
|
|
|
18620
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/create.js
|
|
18621
|
+
var makeCreateBuildContract = (ids) => {
|
|
18622
|
+
const input = object({
|
|
18623
|
+
branch: string2().trim().min(1).max(255).optional().describe("The branch the build came from. Shown with the build."),
|
|
18624
|
+
buildId: buildIdSchema.describe("The buildId build.requestUpload answered with. Upload the file first."),
|
|
18625
|
+
commitSha: string2().trim().min(1).max(255).optional().describe("The commit the build came from. Shown with the build."),
|
|
18626
|
+
environment: makeBuildEnvironmentSelectorSchema(ids).optional().describe("The environment whose runs install the build from now on, until a newer build of the same app and platform arrives. Omit for a build that only runs created with it install."),
|
|
18627
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18628
|
+
}).superRefine((value, context) => {
|
|
18629
|
+
if (value.environment !== undefined && "name" in value.environment && value.environment.baseEphemeralEnvironment !== undefined && value.environment.ephemeral !== true) {
|
|
18630
|
+
context.addIssue({
|
|
18631
|
+
code: "custom",
|
|
18632
|
+
message: "baseEphemeralEnvironment is only valid with ephemeral.",
|
|
18633
|
+
path: ["environment", "baseEphemeralEnvironment"]
|
|
18634
|
+
});
|
|
18635
|
+
}
|
|
18636
|
+
});
|
|
18637
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18638
|
+
return {
|
|
18639
|
+
annotationJustifications: {
|
|
18640
|
+
destructiveHint: "Creates a build. With an environment, later runs there install it instead of the previous build.",
|
|
18641
|
+
openWorldHint: "Reads the uploaded file from QA Wolf storage only.",
|
|
18642
|
+
readOnlyHint: "Creates a build, and can create the environment it names."
|
|
18643
|
+
},
|
|
18644
|
+
annotations: {
|
|
18645
|
+
destructiveHint: false,
|
|
18646
|
+
openWorldHint: false,
|
|
18647
|
+
readOnlyHint: false
|
|
18648
|
+
},
|
|
18649
|
+
description: "Create a build from a file uploaded with build.requestUpload. Reads the app ID, name, version and build number from the file before it answers, or refuses a file that isn't an app. Calling it again with the same buildId answers the build the first call created, unchanged: a repeated call's branch, commitSha and environment are ignored.",
|
|
18650
|
+
input,
|
|
18651
|
+
kind: "write",
|
|
18652
|
+
name: "build.create",
|
|
18653
|
+
output
|
|
18654
|
+
};
|
|
18655
|
+
};
|
|
18656
|
+
|
|
18657
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/delete.js
|
|
18658
|
+
var makeDeleteBuildContract = (ids) => {
|
|
18659
|
+
const input = object({
|
|
18660
|
+
buildId: buildIdSchema,
|
|
18661
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18662
|
+
});
|
|
18663
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18664
|
+
return {
|
|
18665
|
+
annotationJustifications: {
|
|
18666
|
+
destructiveHint: "Deletes the build. Runs never install it after, and when it is an environment's latest build, runs there install the previous one instead, if its file is still kept.",
|
|
18667
|
+
openWorldHint: "Changes QA Wolf data and storage only.",
|
|
18668
|
+
readOnlyHint: "Deletes one build."
|
|
18669
|
+
},
|
|
18670
|
+
annotations: {
|
|
18671
|
+
destructiveHint: true,
|
|
18672
|
+
openWorldHint: false,
|
|
18673
|
+
readOnlyHint: false
|
|
18674
|
+
},
|
|
18675
|
+
description: "Delete a build. Runs never install a deleted build. Deleting an environment's latest build makes the previous one its latest. Runs install that build only if its file is still kept: only the latest builds of static environments are kept past the bucket's expiry, 180 days after upload on QA Wolf's cloud. Answers the build with deletedAt set. Deleting a deleted build answers it unchanged.",
|
|
18676
|
+
input,
|
|
18677
|
+
kind: "write",
|
|
18678
|
+
name: "build.delete",
|
|
18679
|
+
output
|
|
18680
|
+
};
|
|
18681
|
+
};
|
|
18682
|
+
|
|
18683
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/get.js
|
|
18684
|
+
var makeGetBuildContract = (ids) => {
|
|
18685
|
+
const input = object({
|
|
18686
|
+
buildId: buildIdSchema,
|
|
18687
|
+
workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
|
|
18688
|
+
});
|
|
18689
|
+
const output = object({ build: makeBuildResourceSchema(ids) });
|
|
18690
|
+
return {
|
|
18691
|
+
annotationJustifications: {
|
|
18692
|
+
destructiveHint: "Does not change the build.",
|
|
18693
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
18694
|
+
readOnlyHint: "Reads one build."
|
|
18695
|
+
},
|
|
18696
|
+
annotations: {
|
|
18697
|
+
destructiveHint: false,
|
|
18698
|
+
openWorldHint: false,
|
|
18699
|
+
readOnlyHint: true
|
|
18700
|
+
},
|
|
18701
|
+
description: "Get a build: its app, platform, version and environment. Deleted builds are returned too.",
|
|
18702
|
+
input,
|
|
18703
|
+
kind: "read",
|
|
18704
|
+
name: "build.get",
|
|
18705
|
+
output
|
|
18706
|
+
};
|
|
18707
|
+
};
|
|
18708
|
+
|
|
18709
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/list.js
|
|
18710
|
+
var makeListBuildsContract = (ids) => {
|
|
18711
|
+
const input = object({
|
|
18712
|
+
appId: string2().trim().min(1).optional().describe("Only list builds of this package name or bundle ID."),
|
|
18713
|
+
environmentId: ids.environment.optional().describe("Only list builds on this environment."),
|
|
18714
|
+
latestOnly: boolean2().default(false).describe("List only the builds the environment's next run installs: the newest undeleted build of each app and platform. Requires environmentId."),
|
|
18715
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list builds from. Required when authenticating with an organization or user API key."),
|
|
18716
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
|
|
18717
|
+
}).refine((value) => !value.latestOnly || value.environmentId !== undefined, {
|
|
18718
|
+
message: "latestOnly requires environmentId.",
|
|
18719
|
+
path: ["latestOnly"]
|
|
18720
|
+
});
|
|
18721
|
+
const output = object({
|
|
18722
|
+
builds: array(makeBuildResourceSchema(ids)).describe("Undeleted builds, newest first."),
|
|
18723
|
+
nextCursor: nextCursorSchema
|
|
18724
|
+
});
|
|
18725
|
+
return {
|
|
18726
|
+
annotationJustifications: {
|
|
18727
|
+
destructiveHint: "Does not change any build.",
|
|
18728
|
+
openWorldHint: "Reads QA Wolf data only.",
|
|
18729
|
+
readOnlyHint: "Lists builds."
|
|
18730
|
+
},
|
|
18731
|
+
annotations: {
|
|
18732
|
+
destructiveHint: false,
|
|
18733
|
+
openWorldHint: false,
|
|
18734
|
+
readOnlyHint: true
|
|
18735
|
+
},
|
|
18736
|
+
description: "List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs.",
|
|
18737
|
+
input,
|
|
18738
|
+
kind: "read",
|
|
18739
|
+
name: "build.list",
|
|
18740
|
+
output
|
|
18741
|
+
};
|
|
18742
|
+
};
|
|
18743
|
+
|
|
18744
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
|
|
18745
|
+
var maxBuildFileBytes = 500 * 1024 * 1024;
|
|
18746
|
+
var makeRequestBuildUploadContract = (ids) => {
|
|
18747
|
+
const input = object({
|
|
18748
|
+
buildId: buildIdSchema.optional().describe("Send the buildId of an earlier answer to get a fresh URL for the same build. Omit for a new build."),
|
|
18749
|
+
fileName: string2().regex(/^[A-Za-z0-9._-]{1,255}$/, "A file name is one path segment of letters, digits, dots, dashes and underscores, at most 255 characters.").refine((fileName) => /\.(apk|aab|ipa)$/i.test(fileName), "A build is an .apk, .aab or .ipa file.").describe("The file's name, such as `app-release.apk`, `app-release.aab` or `App.ipa`. Its extension sets the platform."),
|
|
18750
|
+
fileSizeBytes: number2().int().min(1).max(maxBuildFileBytes).describe("The file's exact size in bytes, at most 500 MB. The URL accepts only a file of this size."),
|
|
18751
|
+
workspaceId: ids.workspace.optional().describe("The workspace to upload into. Required when authenticating with an organization or user API key.")
|
|
18752
|
+
});
|
|
18753
|
+
const output = object({
|
|
18754
|
+
buildId: buildIdSchema.describe("Send this to build.create after the PUT."),
|
|
18755
|
+
expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
|
|
18756
|
+
uploadHeaders: record(string2(), string2()).describe("Send these headers with the PUT, exactly. The URL is signed for them."),
|
|
18757
|
+
uploadUrl: string2().describe("Send the file's bytes here with a single HTTP PUT carrying uploadHeaders, for example `curl -X PUT -H 'Content-Type: application/octet-stream' -H 'x-goog-if-generation-match: 0' --upload-file app.apk \"<uploadUrl>\"`. The URL only creates the file: it refuses to overwrite one.")
|
|
18758
|
+
});
|
|
18759
|
+
return {
|
|
18760
|
+
annotationJustifications: {
|
|
18761
|
+
destructiveHint: "The URL only creates a new file. It cannot overwrite or delete one.",
|
|
18762
|
+
openWorldHint: "The upload target is QA Wolf's run inputs storage, not an external service.",
|
|
18763
|
+
readOnlyHint: "Returns an expiring URL that permits writing one file to the workspace's storage."
|
|
18764
|
+
},
|
|
18765
|
+
annotations: {
|
|
18766
|
+
destructiveHint: false,
|
|
18767
|
+
openWorldHint: false,
|
|
18768
|
+
readOnlyHint: false
|
|
18769
|
+
},
|
|
18770
|
+
description: "Get a URL to upload an app build: an .apk, .aab or .ipa, up to 500 MB. PUT the file there with uploadHeaders, then call build.create with the buildId.",
|
|
18771
|
+
input,
|
|
18772
|
+
kind: "write",
|
|
18773
|
+
name: "build.requestUpload",
|
|
18774
|
+
output
|
|
18775
|
+
};
|
|
18776
|
+
};
|
|
18777
|
+
|
|
18778
|
+
// node_modules/@qawolf/api-contracts/dist/v1/build/index.js
|
|
18779
|
+
var makeBuildContracts = (ids) => ({
|
|
18780
|
+
create: makeCreateBuildContract(ids),
|
|
18781
|
+
delete: makeDeleteBuildContract(ids),
|
|
18782
|
+
get: makeGetBuildContract(ids),
|
|
18783
|
+
list: makeListBuildsContract(ids),
|
|
18784
|
+
requestUpload: makeRequestBuildUploadContract(ids)
|
|
18785
|
+
});
|
|
18786
|
+
|
|
18568
18787
|
// node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/resource.js
|
|
18569
18788
|
var makeCodeHostIntegrationResourceSchema = () => resource({
|
|
18570
18789
|
connectedAt: exports_iso.datetime().describe("When the code host was connected to the workspace."),
|
|
@@ -18801,6 +19020,7 @@ var makeReportDeploymentStatusContract = (ids) => {
|
|
|
18801
19020
|
error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
|
|
18802
19021
|
});
|
|
18803
19022
|
const input = strictObject({
|
|
19023
|
+
builds: array(buildIdSchema).min(1).max(20).optional().describe("The builds this deployment ships, from build.create. Runs this deployment starts install them. A report that omits this field keeps the stored builds."),
|
|
18804
19024
|
deployTarget: httpUrl().max(2048).describe("The URL the deployment serves, e.g. a preview URL. A mobile pipeline leaves it unset and reports a service instead.").optional(),
|
|
18805
19025
|
environment: environment.describe("Selects the environment the deployment reports into.").optional(),
|
|
18806
19026
|
environmentVariables: record(string2(), string2()).describe("Environment variable overrides for the runs this deployment requests. A report that omits this field keeps the stored values. A report that sends it replaces them.").optional(),
|
|
@@ -19694,12 +19914,28 @@ var makeGetIssueContract = (ids) => {
|
|
|
19694
19914
|
};
|
|
19695
19915
|
|
|
19696
19916
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/finding.js
|
|
19697
|
-
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "
|
|
19917
|
+
var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question", "dismissed" and "superseded". "superseded" means a newer run replaced this run before the investigation concluded. New values can appear.';
|
|
19918
|
+
var investigationQuestionSchema = object({
|
|
19919
|
+
answers: array(object({
|
|
19920
|
+
description: string2().optional(),
|
|
19921
|
+
title: string2(),
|
|
19922
|
+
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
19923
|
+
})),
|
|
19924
|
+
body: string2().optional().describe("Markdown details under the question: what the test expects, what the app does and what each answer changes. A value a person must copy is in a code block."),
|
|
19925
|
+
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
19926
|
+
text: string2()
|
|
19927
|
+
});
|
|
19698
19928
|
var makeInvestigationFindingSchema = (ids) => object({
|
|
19699
19929
|
actual: string2().optional(),
|
|
19700
19930
|
commitHash: string2().optional().describe("The commit of a commit fix. Same as `fix.commitHash`."),
|
|
19701
19931
|
decidedBy: _enum(["agent", "user"]).optional().describe("Who decided: the AI on its own, or a person who approved or dismissed it. Absent until someone decides."),
|
|
19702
19932
|
disputeReason: string2().optional().describe("Why a person disputed what the AI did. Present on a proposal the AI made again after that dispute."),
|
|
19933
|
+
earlierQuestions: array(object({
|
|
19934
|
+
answer: string2(),
|
|
19935
|
+
answeredAt: exports_iso.datetime(),
|
|
19936
|
+
body: string2().optional(),
|
|
19937
|
+
text: string2()
|
|
19938
|
+
})).optional().describe("Questions about this cause that a person already answered, oldest first. The AI acted on each answer."),
|
|
19703
19939
|
expected: string2().optional(),
|
|
19704
19940
|
findingId: string2(),
|
|
19705
19941
|
fix: discriminatedUnion("type", [
|
|
@@ -19726,15 +19962,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
19726
19962
|
reason: string2().describe("Why the investigation reached the verdict."),
|
|
19727
19963
|
verdict: string2().describe('Whether the pull request caused the failure. Known values: "caused", "not-caused" and "unclear". New values can appear.')
|
|
19728
19964
|
}).optional().describe("Whether the pull request the run tested caused this finding. Absent on a run that didn't test a pull request, and when the investigation didn't say."),
|
|
19729
|
-
question:
|
|
19730
|
-
answers: array(object({
|
|
19731
|
-
description: string2().optional(),
|
|
19732
|
-
title: string2(),
|
|
19733
|
-
value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
|
|
19734
|
-
})),
|
|
19735
|
-
comparisonId: string2().optional().describe('The failed screenshot comparison a screenshot question is about, as `run listScreenshotComparisons` names it. Its answers are "bug" (the old screenshot is right), "maintenance" (both are right) and "baseline" (the new screenshot is right).'),
|
|
19736
|
-
text: string2()
|
|
19737
|
-
}).optional().describe("The question waiting for a person, with the answers offered."),
|
|
19965
|
+
question: investigationQuestionSchema.optional().describe("The question waiting for a person, with the answers offered."),
|
|
19738
19966
|
response: object({
|
|
19739
19967
|
answer: string2().optional(),
|
|
19740
19968
|
at: exports_iso.datetime(),
|
|
@@ -19746,6 +19974,7 @@ var makeInvestigationFindingSchema = (ids) => object({
|
|
|
19746
19974
|
steps: array(string2()).optional(),
|
|
19747
19975
|
subSessionIds: array(ids.chatSession),
|
|
19748
19976
|
summary: string2().optional(),
|
|
19977
|
+
supersededByRunId: ids.run.optional().describe('The newer run that replaced this run, on a "superseded" finding.'),
|
|
19749
19978
|
updatedAt: exports_iso.datetime()
|
|
19750
19979
|
});
|
|
19751
19980
|
|
|
@@ -19755,6 +19984,17 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
19755
19984
|
const output = resource({
|
|
19756
19985
|
baselineChanges: _enum(["automatic", "needs-approval"]).describe('How the investigation can make a new screenshot the baseline. "automatic": it can accept a baseline on its own. ' + '"needs-approval": it proposes the baseline on a fix-proposed finding, and accepts it only after a person applies the proposal.'),
|
|
19757
19986
|
findings: array(makeInvestigationFindingSchema(ids)),
|
|
19987
|
+
questionsFromOtherRuns: array(object({
|
|
19988
|
+
answer: string2().optional().describe(`The person's answer, when status is "answered".`),
|
|
19989
|
+
answeredAt: exports_iso.datetime().optional(),
|
|
19990
|
+
body: string2().optional(),
|
|
19991
|
+
findingId: string2(),
|
|
19992
|
+
flowIds: array(ids.flow),
|
|
19993
|
+
headline: string2().optional().describe("The cause that the question is about."),
|
|
19994
|
+
runId: ids.run,
|
|
19995
|
+
status: string2().describe('Known values: "open" (waiting for a person) and "answered". New values can appear.'),
|
|
19996
|
+
text: string2()
|
|
19997
|
+
})).optional().describe("Questions that the workspace's other run investigations asked about the same flows in the last 7 days, newest first."),
|
|
19758
19998
|
runId: ids.run,
|
|
19759
19999
|
sessionId: ids.chatSession.optional().describe("The investigation session. Absent when the run has none."),
|
|
19760
20000
|
status: _enum(["investigating", "finished", "not-investigated", "not-enabled"]).describe('Whether the lead or any child investigator is still working. "not-investigated" when the run has no investigation. ' + '"not-enabled" when automatic investigation does not cover this run, because its workspace has it off or investigates only pull request runs: read its failures with run.get and attempt.get instead.'),
|
|
@@ -19782,9 +20022,55 @@ var makeGetInvestigationContract = (ids) => {
|
|
|
19782
20022
|
};
|
|
19783
20023
|
};
|
|
19784
20024
|
|
|
20025
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
|
|
20026
|
+
var makeFindInvestigationQuestionsContract = (ids) => {
|
|
20027
|
+
const input = object({
|
|
20028
|
+
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
20029
|
+
environmentId: ids.environmentRef.optional().describe("Only list the questions of runs in this environment. Omit to list the questions of every environment."),
|
|
20030
|
+
statuses: array(_enum(["open"])).min(1).default(["open"]).describe(`Question statuses to include. "open" (waiting for a person's answer) is the only status today.`),
|
|
20031
|
+
workspaceId: ids.workspace.optional().describe("The workspace to list questions from. Required when authenticating with an organization or user API key.")
|
|
20032
|
+
});
|
|
20033
|
+
const output = object({
|
|
20034
|
+
nextCursor: nextCursorSchema,
|
|
20035
|
+
questions: array(resource({
|
|
20036
|
+
askedAt: exports_iso.datetime().describe("When the investigation first recorded the finding that asks the question."),
|
|
20037
|
+
findingId: string2(),
|
|
20038
|
+
flows: array(object({ flowId: ids.flow, name: string2() })).describe("The failed flows the question is about."),
|
|
20039
|
+
headline: string2().optional(),
|
|
20040
|
+
question: investigationQuestionSchema,
|
|
20041
|
+
runId: ids.run,
|
|
20042
|
+
sessionId: ids.chatSession.describe("The investigation session. Answer the question by sending the person's answer to it with agent.send."),
|
|
20043
|
+
summary: string2().optional()
|
|
20044
|
+
}, { urlFieldDescription: "The run in the QA Wolf app." })).describe("Questions that wait for a person's answer, the most recently recorded first. A page can hold fewer than limit questions, or none, while nextCursor is present.")
|
|
20045
|
+
});
|
|
20046
|
+
return {
|
|
20047
|
+
annotationJustifications: {
|
|
20048
|
+
destructiveHint: "Does not answer, dismiss or change any question.",
|
|
20049
|
+
openWorldHint: "Reads recorded QA Wolf findings without changing the application under test.",
|
|
20050
|
+
readOnlyHint: "Lists the open questions of a workspace's investigations without answering them."
|
|
20051
|
+
},
|
|
20052
|
+
annotations: {
|
|
20053
|
+
destructiveHint: false,
|
|
20054
|
+
openWorldHint: false,
|
|
20055
|
+
readOnlyHint: true
|
|
20056
|
+
},
|
|
20057
|
+
description: "List the questions the QA Wolf AI investigating failed runs is waiting for a person to answer, across a workspace's runs. " + "Each question names its run, flows, details and offered answers. " + "To answer one, send the person's answer to its sessionId with agent.send.",
|
|
20058
|
+
input,
|
|
20059
|
+
kind: "read",
|
|
20060
|
+
name: "investigation.question.find",
|
|
20061
|
+
output
|
|
20062
|
+
};
|
|
20063
|
+
};
|
|
20064
|
+
|
|
20065
|
+
// node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
|
|
20066
|
+
var makeInvestigationQuestionContracts = (ids) => ({
|
|
20067
|
+
find: makeFindInvestigationQuestionsContract(ids)
|
|
20068
|
+
});
|
|
20069
|
+
|
|
19785
20070
|
// node_modules/@qawolf/api-contracts/dist/v1/investigation/index.js
|
|
19786
20071
|
var makeInvestigationContracts = (ids) => ({
|
|
19787
|
-
get: makeGetInvestigationContract(ids)
|
|
20072
|
+
get: makeGetInvestigationContract(ids),
|
|
20073
|
+
question: makeInvestigationQuestionContracts(ids)
|
|
19788
20074
|
});
|
|
19789
20075
|
|
|
19790
20076
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/addFlows.js
|
|
@@ -19874,6 +20160,35 @@ var makeCreateIssueContract = (ids) => {
|
|
|
19874
20160
|
};
|
|
19875
20161
|
};
|
|
19876
20162
|
|
|
20163
|
+
// node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
|
|
20164
|
+
var makeDecideSuggestionContract = (ids) => {
|
|
20165
|
+
const input = object({
|
|
20166
|
+
decision: _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip before the flow joins. activate: retry a suggestion that QA Wolf held."),
|
|
20167
|
+
issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
|
|
20168
|
+
skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
|
|
20169
|
+
}).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
|
|
20170
|
+
const output = object({
|
|
20171
|
+
issue: makeIssueResourceSchema(ids)
|
|
20172
|
+
});
|
|
20173
|
+
return {
|
|
20174
|
+
annotationJustifications: {
|
|
20175
|
+
destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
|
|
20176
|
+
openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
|
|
20177
|
+
readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
|
|
20178
|
+
},
|
|
20179
|
+
annotations: {
|
|
20180
|
+
destructiveHint: false,
|
|
20181
|
+
openWorldHint: true,
|
|
20182
|
+
readOnlyHint: false
|
|
20183
|
+
},
|
|
20184
|
+
description: "Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. " + "Add turns on the suggested flow in the environment. Report files a potential bug. " + "Skip declines the suggestion. Undo takes back a decision before the flow joins. " + "The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided.",
|
|
20185
|
+
input,
|
|
20186
|
+
kind: "write",
|
|
20187
|
+
name: "issue.decideSuggestion",
|
|
20188
|
+
output
|
|
20189
|
+
};
|
|
20190
|
+
};
|
|
20191
|
+
|
|
19877
20192
|
// node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
|
|
19878
20193
|
var issueActivityTypeSchema = _enum([
|
|
19879
20194
|
"created",
|
|
@@ -20133,6 +20448,35 @@ var makeLegacyTriggerContracts = (ids) => ({
|
|
|
20133
20448
|
resume: makeResumeLegacyTriggerContract(ids)
|
|
20134
20449
|
});
|
|
20135
20450
|
|
|
20451
|
+
// node_modules/@qawolf/api-contracts/dist/v1/mcpServer/connect.js
|
|
20452
|
+
var makeConnectMcpServerContract = (ids) => {
|
|
20453
|
+
const input = object({
|
|
20454
|
+
server: string2().trim().min(1).describe("The server to connect, by its catalog id or name, such as linear or Linear."),
|
|
20455
|
+
workspaceId: ids.workspace.optional().describe("The workspace to connect the server to. Required when authenticating with an organization or user API key.")
|
|
20456
|
+
});
|
|
20457
|
+
const output = object({
|
|
20458
|
+
authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
|
|
20459
|
+
serverName: string2().describe("The catalog name of the server.")
|
|
20460
|
+
});
|
|
20461
|
+
return {
|
|
20462
|
+
annotationJustifications: {
|
|
20463
|
+
destructiveHint: "Starts a sign-in without changing or removing existing connections.",
|
|
20464
|
+
openWorldHint: "Asks the external server's OAuth provider for a sign-in page.",
|
|
20465
|
+
readOnlyHint: "Records a pending connection on the workspace."
|
|
20466
|
+
},
|
|
20467
|
+
annotations: {
|
|
20468
|
+
destructiveHint: false,
|
|
20469
|
+
openWorldHint: true,
|
|
20470
|
+
readOnlyHint: false
|
|
20471
|
+
},
|
|
20472
|
+
description: "Start connecting an MCP server from the workspace's catalog, such as Linear, so Tester can use its tools. Returns a sign-in link to show the user.",
|
|
20473
|
+
input,
|
|
20474
|
+
kind: "write",
|
|
20475
|
+
name: "mcpServer.connect",
|
|
20476
|
+
output
|
|
20477
|
+
};
|
|
20478
|
+
};
|
|
20479
|
+
|
|
20136
20480
|
// node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
|
|
20137
20481
|
var investigationSessionId = string2().trim().min(1).max(100).optional();
|
|
20138
20482
|
|
|
@@ -20216,6 +20560,7 @@ var makeDiagnoseRunContract = (ids) => {
|
|
|
20216
20560
|
// node_modules/@qawolf/api-contracts/dist/v1/run/find.js
|
|
20217
20561
|
var makeFindRunsContract = (ids) => {
|
|
20218
20562
|
const input = object({
|
|
20563
|
+
buildId: buildIdSchema.optional().describe("Only include runs that installed this build."),
|
|
20219
20564
|
createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include runs created after this instant, e.g. the runs since a deploy."),
|
|
20220
20565
|
...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
|
|
20221
20566
|
environmentId: ids.environmentRef,
|
|
@@ -20340,6 +20685,7 @@ var makeGetRunContract = (ids) => {
|
|
|
20340
20685
|
const output = resource({
|
|
20341
20686
|
...makeRunSummaryFields(ids),
|
|
20342
20687
|
blockingBugCount: number2().int().nonnegative().describe("How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved."),
|
|
20688
|
+
builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
|
|
20343
20689
|
flows,
|
|
20344
20690
|
runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
|
|
20345
20691
|
}, { urlFieldDescription: "Absolute URL of the run page." });
|
|
@@ -20816,7 +21162,7 @@ var makeReadRunnerJournalContract = (ids) => {
|
|
|
20816
21162
|
openWorldHint: false,
|
|
20817
21163
|
readOnlyHint: false
|
|
20818
21164
|
},
|
|
20819
|
-
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. ${retryableRunnerUnreachableDescription}`,
|
|
21165
|
+
description: `Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: \`run-status\` settles it, \`run-logs\` and \`run-events\` carry what it produced, and \`recorder\` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. Polling \`runner.get\` or \`runner.list\` does not count as activity, so the inactivity clock keeps running until the runner is reaped. The journal lives only on the runner: once it is terminated or stops after inactivity, the journal is gone and this read answers not-found. ${retryableRunnerUnreachableDescription}`,
|
|
20820
21166
|
input,
|
|
20821
21167
|
kind: "read",
|
|
20822
21168
|
name: "runner.readJournal",
|
|
@@ -20966,7 +21312,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
|
|
|
20966
21312
|
openWorldHint: false,
|
|
20967
21313
|
readOnlyHint: false
|
|
20968
21314
|
},
|
|
20969
|
-
description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all
|
|
21315
|
+
description: `Take one screenshot of an interactive runner's screen. This refreshes the inactivity timer and can extend the runner's billed lifetime. On a runner with a browser the image is the whole virtual desktop, browser window and all. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
|
|
20970
21316
|
input,
|
|
20971
21317
|
kind: "read",
|
|
20972
21318
|
name: "runner.takeScreenshot",
|
|
@@ -21101,6 +21447,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21101
21447
|
attempt: {
|
|
21102
21448
|
get: makeGetAttemptContract(resolvedIds)
|
|
21103
21449
|
},
|
|
21450
|
+
build: makeBuildContracts(resolvedIds),
|
|
21104
21451
|
codeHostIntegration: {
|
|
21105
21452
|
find: makeFindCodeHostIntegrationsContract(resolvedIds),
|
|
21106
21453
|
listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
|
|
@@ -21138,6 +21485,7 @@ var makeContractsV1 = (ids) => {
|
|
|
21138
21485
|
issue: {
|
|
21139
21486
|
addFlows: makeAddFlowsToIssueContract(resolvedIds),
|
|
21140
21487
|
create: makeCreateIssueContract(resolvedIds),
|
|
21488
|
+
decideSuggestion: makeDecideSuggestionContract(resolvedIds),
|
|
21141
21489
|
find: makeFindIssuesContract(resolvedIds),
|
|
21142
21490
|
get: makeGetIssueContract(resolvedIds),
|
|
21143
21491
|
listActivity: makeListIssueActivityContract(resolvedIds),
|
|
@@ -21145,6 +21493,9 @@ var makeContractsV1 = (ids) => {
|
|
|
21145
21493
|
update: makeUpdateIssueContract(resolvedIds)
|
|
21146
21494
|
},
|
|
21147
21495
|
legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
|
|
21496
|
+
mcpServer: {
|
|
21497
|
+
connect: makeConnectMcpServerContract(resolvedIds)
|
|
21498
|
+
},
|
|
21148
21499
|
promotion: makePromotionContracts(resolvedIds),
|
|
21149
21500
|
run: {
|
|
21150
21501
|
acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
|
|
@@ -23672,7 +24023,7 @@ function startUpdateCheck(deps) {
|
|
|
23672
24023
|
// package.json
|
|
23673
24024
|
var package_default = {
|
|
23674
24025
|
name: "@qawolf/cli",
|
|
23675
|
-
version: "2.
|
|
24026
|
+
version: "2.4.0",
|
|
23676
24027
|
description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
23677
24028
|
keywords: [
|
|
23678
24029
|
"automation",
|
|
@@ -23744,7 +24095,7 @@ var package_default = {
|
|
|
23744
24095
|
"@clack/prompts": "1.5.1",
|
|
23745
24096
|
"@napi-rs/keyring": "1.3.0",
|
|
23746
24097
|
"@oxc-node/core": "0.1.0",
|
|
23747
|
-
"@qawolf/api-contracts": "0.
|
|
24098
|
+
"@qawolf/api-contracts": "0.104.0",
|
|
23748
24099
|
"@qawolf/emails": "1.1.1",
|
|
23749
24100
|
"@qawolf/flow-targets": "2.0.0",
|
|
23750
24101
|
"@qawolf/flows": "0.3.0",
|
|
@@ -23868,7 +24219,7 @@ function withAuthContext(signals, fn, deps = {}) {
|
|
|
23868
24219
|
baseUrl: apiBaseUrl,
|
|
23869
24220
|
fetch: globalThis.fetch,
|
|
23870
24221
|
logger: ctx.log("trpc"),
|
|
23871
|
-
workspaceId: resolved.workspaceId
|
|
24222
|
+
workspaceId: deps.workspaceId ?? resolved.workspaceId
|
|
23872
24223
|
});
|
|
23873
24224
|
try {
|
|
23874
24225
|
const result = await fn({
|
|
@@ -39408,6 +39759,20 @@ function makeInteractiveRunnerDeps(options) {
|
|
|
39408
39759
|
|
|
39409
39760
|
// src/commands/runner/context.ts
|
|
39410
39761
|
var runnerFlagDescription = "Runner to target. Defaults to QAWOLF_RUNNER_ID, then this directory's stored runner";
|
|
39762
|
+
function workspaceIdOption() {
|
|
39763
|
+
return new Option2("--workspace-id <id>", "Workspace to work in for this command only. Defaults to the one 'qawolf auth switch' saved, and is never saved itself").argParser((value) => {
|
|
39764
|
+
const trimmed = value.trim();
|
|
39765
|
+
if (!trimmed)
|
|
39766
|
+
throw new InvalidArgumentError2("Give a workspace id.");
|
|
39767
|
+
return trimmed;
|
|
39768
|
+
});
|
|
39769
|
+
}
|
|
39770
|
+
function withRunnerContext(signals, fn, deps = {}) {
|
|
39771
|
+
return (opts, command) => withAuthContext(signals, fn, {
|
|
39772
|
+
...deps,
|
|
39773
|
+
workspaceId: command.optsWithGlobals().workspaceId
|
|
39774
|
+
})(opts, command);
|
|
39775
|
+
}
|
|
39411
39776
|
function runnerDeps(ctx) {
|
|
39412
39777
|
return makeInteractiveRunnerDeps({
|
|
39413
39778
|
cwd: process.cwd(),
|
|
@@ -39425,7 +39790,7 @@ Every action in a see-and-act loop is followed by a look at the result, so ask f
|
|
|
39425
39790
|
|
|
39426
39791
|
Coordinates are pixels on the same screenshot you just read. The runner serves one see-or-act request at a time, so never have two in flight; when the next few steps are already known, send them as one \`runner actions\` sequence instead. Bounds are checked before anything is sent, so an over-long --text or an out-of-range coordinate comes back immediately naming the limit.
|
|
39427
39792
|
|
|
39428
|
-
On a 4, the answer may have been lost with the action in flight: take a screenshot before repeating a click, and repeat only what the screen says did not happen.
|
|
39793
|
+
On a 4, unless the message says nothing was sent, the answer may have been lost with the action in flight: take a screenshot before repeating a click, and repeat only what the screen says did not happen.
|
|
39429
39794
|
|
|
39430
39795
|
# Mobile
|
|
39431
39796
|
|
|
@@ -39710,7 +40075,7 @@ Both succeed when there was nothing to do, and say which: \`wasRunning\` is fals
|
|
|
39710
40075
|
`;
|
|
39711
40076
|
|
|
39712
40077
|
// src/commands/runner/guides/workflow.md
|
|
39713
|
-
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
|
|
40078
|
+
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\nEvery runner command works in the workspace `qawolf auth switch` saved, unless it is given `--workspace-id <id>`. The flag holds for that one command and is never saved, so sessions on one machine working on different workspaces do not move each other. Since runner ids are scoped to a team, pass the same `--workspace-id` to every command that drives a runner you launched with it; leave it off one and that command looks for the runner in the saved workspace.\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:\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, unless the message says nothing was sent. 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";
|
|
39714
40079
|
|
|
39715
40080
|
// src/commands/runner/guides/index.ts
|
|
39716
40081
|
var runnerGuides = {
|
|
@@ -39745,7 +40110,7 @@ Mobile:
|
|
|
39745
40110
|
$ qawolf runner actions '[{"type":"tap","selector":"//*[@content-desc=\\"Email\\"]"},{"type":"type","text":"hello@example.com"},{"type":"tap","x":540,"y":1650}]' --screenshot after-login.jpg
|
|
39746
40111
|
$ qawolf runner actions '[{"type":"fill","selector":"name == \\"Postal code\\"","strategy":"ios-predicate","text":"94107"},{"type":"swipe","from":{"x":540,"y":1600},"to":{"x":540,"y":600}}]'`;
|
|
39747
40112
|
function registerRunnerActionsCommand(runner, signals) {
|
|
39748
|
-
declareCommandKind(runner.command("actions <sequence>"), "write").description("Perform a sequence of up to ten raw actions on a runner's screen in one request, as a JSON array of the same actions `runner act` takes. Use - to read the array from stdin. Actions run back to back, so batch only steps whose targets are on the screen you last saw, and end the sequence at the step that changes the page. Each result carries an effect: performed, not-performed, or unknown when the runner stopped answering and the action may have landed").option("--continue-on-failure", "Carry on past an action that reached the runner and did not take effect; a runner that cannot be reached or a screen that cannot serve still ends the sequence").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Save a JPEG of the screen after the last action to this file. With --screenshot-mode each, one file per action, with the action's index before the extension. - writes the final frame to stdout and moves the confirmation to stderr").addOption(new Option2("--screenshot-mode <mode>", "Defaults to final when --screenshot is given, none otherwise").choices([...screenshotModes])).addHelpText("after", actionsExamples).addHelpText("after", runnerGuides.actions).action((sequence, opts, command) =>
|
|
40113
|
+
declareCommandKind(runner.command("actions <sequence>"), "write").description("Perform a sequence of up to ten raw actions on a runner's screen in one request, as a JSON array of the same actions `runner act` takes. Use - to read the array from stdin. Actions run back to back, so batch only steps whose targets are on the screen you last saw, and end the sequence at the step that changes the page. Each result carries an effect: performed, not-performed, or unknown when the runner stopped answering and the action may have landed").option("--continue-on-failure", "Carry on past an action that reached the runner and did not take effect; a runner that cannot be reached or a screen that cannot serve still ends the sequence").option("--runner <id>", runnerFlagDescription).option("--screenshot <path>", "Save a JPEG of the screen after the last action to this file. With --screenshot-mode each, one file per action, with the action's index before the extension. - writes the final frame to stdout and moves the confirmation to stderr").addOption(new Option2("--screenshot-mode <mode>", "Defaults to final when --screenshot is given, none otherwise").choices([...screenshotModes])).addHelpText("after", actionsExamples).addHelpText("after", runnerGuides.actions).action((sequence, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerActions(ctx, {
|
|
39749
40114
|
actions: sequence,
|
|
39750
40115
|
continueOnFailure: opts.continueOnFailure === true,
|
|
39751
40116
|
runner: opts.runner,
|
|
@@ -39916,7 +40281,7 @@ Examples:
|
|
|
39916
40281
|
$ echo 'console.log(await page.title())' | qawolf runner exec -
|
|
39917
40282
|
$ qawolf runner exec snippet.ts --file flows/checkout.flow.ts`;
|
|
39918
40283
|
function registerRunnerExecCommand(runner, signals) {
|
|
39919
|
-
declareCommandKind(runner.command("exec <file>"), "write").description("Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin").option("--file <path>", "File whose scope the snippet is evaluated in; it and the directory's other files travel with it").option("--runner <id>", runnerFlagDescription).addHelpText("after", execExamples).addHelpText("after", runnerGuides.exec).action((file, opts, command) =>
|
|
40284
|
+
declareCommandKind(runner.command("exec <file>"), "write").description("Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin").option("--file <path>", "File whose scope the snippet is evaluated in; it and the directory's other files travel with it").option("--runner <id>", runnerFlagDescription).addHelpText("after", execExamples).addHelpText("after", runnerGuides.exec).action((file, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerExec(ctx, { contextFile: opts.file, runner: opts.runner, source: file }, runnerDeps(ctx)))(opts, command));
|
|
39920
40285
|
}
|
|
39921
40286
|
|
|
39922
40287
|
// src/domains/interactiveRunner/highlightSelector.ts
|
|
@@ -39991,7 +40356,7 @@ Examples:
|
|
|
39991
40356
|
$ qawolf runner highlight-selector "#checkout" && qawolf runner screenshot
|
|
39992
40357
|
$ qawolf runner highlight-selector`;
|
|
39993
40358
|
function registerRunnerHighlightSelectorCommand(runner, signals) {
|
|
39994
|
-
declareCommandKind(runner.command("highlight-selector [selector]"), "write").description("Highlight what a selector matches on a runner's live page, so the next screenshot shows it. Omit the selector to clear the highlight").option("--runner <id>", runnerFlagDescription).addHelpText("after", highlightExamples).addHelpText("after", runnerGuides.highlightSelector).action((selector, opts, command) =>
|
|
40359
|
+
declareCommandKind(runner.command("highlight-selector [selector]"), "write").description("Highlight what a selector matches on a runner's live page, so the next screenshot shows it. Omit the selector to clear the highlight").option("--runner <id>", runnerFlagDescription).addHelpText("after", highlightExamples).addHelpText("after", runnerGuides.highlightSelector).action((selector, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerHighlightSelector(ctx, { runner: opts.runner, selector }, runnerDeps(ctx)))(opts, command));
|
|
39995
40360
|
}
|
|
39996
40361
|
|
|
39997
40362
|
// src/domains/interactiveRunner/importPackage.ts
|
|
@@ -40102,7 +40467,7 @@ Examples:
|
|
|
40102
40467
|
$ qawolf runner import-package dayjs
|
|
40103
40468
|
$ qawolf runner import-package dayjs --package-version 1.11.13`;
|
|
40104
40469
|
function registerRunnerImportPackageCommand(runner, signals) {
|
|
40105
|
-
declareCommandKind(runner.command("import-package <name>"), "write").description("Install a package into a runner's live run, so a snippet or a selection can import it").option("--package-version <version>", "Version to install", "latest").option("--runner <id>", runnerFlagDescription).addHelpText("after", importPackageExamples).addHelpText("after", runnerGuides.importPackage).action((name, opts, command) =>
|
|
40470
|
+
declareCommandKind(runner.command("import-package <name>"), "write").description("Install a package into a runner's live run, so a snippet or a selection can import it").option("--package-version <version>", "Version to install", "latest").option("--runner <id>", runnerFlagDescription).addHelpText("after", importPackageExamples).addHelpText("after", runnerGuides.importPackage).action((name, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerImportPackage(ctx, { name, runner: opts.runner, version: opts.packageVersion }, runnerDeps(ctx)))(opts, command));
|
|
40106
40471
|
}
|
|
40107
40472
|
|
|
40108
40473
|
// src/core/interactiveRunner/inspectRequest.ts
|
|
@@ -40319,22 +40684,22 @@ async function handleRunnerInspectMobile(ctx, options, deps) {
|
|
|
40319
40684
|
|
|
40320
40685
|
// src/commands/runner/inspectMobile.register.ts
|
|
40321
40686
|
function registerRunnerInspectMobileCommands(inspect, signals) {
|
|
40322
|
-
declareCommandKind(inspect.command("session"), "read").description("Print the Appium session's status: ready, or why not").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40687
|
+
declareCommandKind(inspect.command("session"), "read").description("Print the Appium session's status: ready, or why not").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspectMobile(ctx, {
|
|
40323
40688
|
flags: blankInspectMobileFlags,
|
|
40324
40689
|
runner: opts.runner,
|
|
40325
40690
|
what: "session"
|
|
40326
40691
|
}, runnerDeps(ctx)))(opts, command));
|
|
40327
|
-
declareCommandKind(inspect.command("contexts"), "read").description("List the WebView contexts available, and which is current").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40692
|
+
declareCommandKind(inspect.command("contexts"), "read").description("List the WebView contexts available, and which is current").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspectMobile(ctx, {
|
|
40328
40693
|
flags: blankInspectMobileFlags,
|
|
40329
40694
|
runner: opts.runner,
|
|
40330
40695
|
what: "contexts"
|
|
40331
40696
|
}, runnerDeps(ctx)))(opts, command));
|
|
40332
|
-
declareCommandKind(inspect.command("page-source"), "read").description("Print the current context's page source, as a tree").option("--context <name>", "Read this context instead of the current one").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40697
|
+
declareCommandKind(inspect.command("page-source"), "read").description("Print the current context's page source, as a tree").option("--context <name>", "Read this context instead of the current one").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspectMobile(ctx, {
|
|
40333
40698
|
flags: { ...blankInspectMobileFlags, context: opts.context },
|
|
40334
40699
|
runner: opts.runner,
|
|
40335
40700
|
what: "page"
|
|
40336
40701
|
}, runnerDeps(ctx)))(opts, command));
|
|
40337
|
-
declareCommandKind(inspect.command("elements"), "read").description("Find elements at a screen point, carrying some text, or matching a selector").option("--context <name>", "Read this context instead of the current one").option("--partial", "text: match text containing this, rather than exactly this").option("--runner <id>", runnerFlagDescription).option("--selector <selector>", "Resolved the same way a screen object's own selector is").option("--strategy <strategy>", "selector: xpath, ios-predicate, or shadow (defaults to xpath)").option("--text <text>", "text: the text to match").option("--x <pixels>", "point: whole pixels on the device's own screen").option("--y <pixels>", "point: whole pixels on the device's own screen").action((opts, command) =>
|
|
40702
|
+
declareCommandKind(inspect.command("elements"), "read").description("Find elements at a screen point, carrying some text, or matching a selector").option("--context <name>", "Read this context instead of the current one").option("--partial", "text: match text containing this, rather than exactly this").option("--runner <id>", runnerFlagDescription).option("--selector <selector>", "Resolved the same way a screen object's own selector is").option("--strategy <strategy>", "selector: xpath, ios-predicate, or shadow (defaults to xpath)").option("--text <text>", "text: the text to match").option("--x <pixels>", "point: whole pixels on the device's own screen").option("--y <pixels>", "point: whole pixels on the device's own screen").action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspectMobile(ctx, {
|
|
40338
40703
|
flags: {
|
|
40339
40704
|
context: opts.context,
|
|
40340
40705
|
partial: opts.partial,
|
|
@@ -40363,17 +40728,17 @@ Examples:
|
|
|
40363
40728
|
$ qawolf runner inspect elements --selector "//android.widget.Button[@text='Sign in']"`;
|
|
40364
40729
|
function registerRunnerInspectCommands(runner, signals) {
|
|
40365
40730
|
const inspect = runner.command("inspect").description("Read one thing off a runner's live page (browser) or Appium session (mobile)").addHelpText("after", inspectExamples).addHelpText("after", runnerGuides.inspect);
|
|
40366
|
-
declareCommandKind(inspect.command("element-html"), "read").description("Print the HTML of the first element a selector matches").requiredOption("--selector <selector>", "Playwright selector to inspect").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40731
|
+
declareCommandKind(inspect.command("element-html"), "read").description("Print the HTML of the first element a selector matches").requiredOption("--selector <selector>", "Playwright selector to inspect").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspect(ctx, {
|
|
40367
40732
|
flags: { name: undefined, selector: opts.selector },
|
|
40368
40733
|
runner: opts.runner,
|
|
40369
40734
|
what: "element-html"
|
|
40370
40735
|
}, runnerDeps(ctx)))(opts, command));
|
|
40371
|
-
declareCommandKind(inspect.command("page-html"), "read").description("Print the page's HTML, simplified for a model to read").option("--selector <selector>", "Limit the output to this subtree").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40736
|
+
declareCommandKind(inspect.command("page-html"), "read").description("Print the page's HTML, simplified for a model to read").option("--selector <selector>", "Limit the output to this subtree").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspect(ctx, {
|
|
40372
40737
|
flags: { name: undefined, selector: opts.selector },
|
|
40373
40738
|
runner: opts.runner,
|
|
40374
40739
|
what: "page-html"
|
|
40375
40740
|
}, runnerDeps(ctx)))(opts, command));
|
|
40376
|
-
declareCommandKind(inspect.command("variable"), "read").description("Print a top-level variable's value from the running workflow").requiredOption("--name <name>", "Name of the variable to read").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
40741
|
+
declareCommandKind(inspect.command("variable"), "read").description("Print a top-level variable's value from the running workflow").requiredOption("--name <name>", "Name of the variable to read").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerInspect(ctx, {
|
|
40377
40742
|
flags: { name: opts.name, selector: undefined },
|
|
40378
40743
|
runner: opts.runner,
|
|
40379
40744
|
what: "variable"
|
|
@@ -40648,17 +41013,19 @@ Mobile:
|
|
|
40648
41013
|
$ qawolf runner act fill --selector 'name == "Postal code"' --strategy ios-predicate --text 94107
|
|
40649
41014
|
$ qawolf runner act swipe --from 540,1600 --to 540,600 --duration-ms 1500`;
|
|
40650
41015
|
|
|
40651
|
-
// src/commands/runner/
|
|
40652
|
-
var defaultScreenshotPath = "screenshot.jpg";
|
|
41016
|
+
// src/commands/runner/screenshotExamples.ts
|
|
40653
41017
|
var screenshotExamples = `
|
|
40654
41018
|
Examples:
|
|
40655
41019
|
$ qawolf runner screenshot
|
|
40656
41020
|
$ qawolf runner screenshot --out screens/step-3.jpg
|
|
40657
41021
|
$ qawolf runner screenshot --out - > step-3.jpg
|
|
40658
41022
|
$ qawolf runner screenshot --out - | my-vision-tool`;
|
|
41023
|
+
|
|
41024
|
+
// src/commands/runner/interact.register.ts
|
|
41025
|
+
var defaultScreenshotPath = "screenshot.jpg";
|
|
40659
41026
|
function registerRunnerInteractCommands(runner, signals) {
|
|
40660
|
-
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) =>
|
|
40661
|
-
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, 0 when only --scroll-y is given").option("--scroll-y <delta>", "scroll: vertical wheel delta, 0 when only --scroll-x is given").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) =>
|
|
41027
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerScreenshot(ctx, { out: opts.out, runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
41028
|
+
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, 0 when only --scroll-y is given").option("--scroll-y <delta>", "scroll: vertical wheel delta, 0 when only --scroll-x is given").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) => withRunnerContext(signals, (ctx) => handleRunnerAct(ctx, {
|
|
40662
41029
|
flags: {
|
|
40663
41030
|
button: opts.button,
|
|
40664
41031
|
durationMs: opts.durationMs,
|
|
@@ -40871,11 +41238,11 @@ Examples:
|
|
|
40871
41238
|
$ qawolf runner keepalive
|
|
40872
41239
|
$ qawolf runner keepalive --runner ci`;
|
|
40873
41240
|
function registerRunnerLifecycleCommands(runner, signals) {
|
|
40874
|
-
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) =>
|
|
40875
|
-
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) =>
|
|
40876
|
-
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) =>
|
|
40877
|
-
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) =>
|
|
40878
|
-
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) =>
|
|
41241
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerLaunch(ctx, { id: opts.id, name: opts.name }, runnerDeps(ctx)))(opts, command));
|
|
41242
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
|
|
41243
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerTerminate(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
41244
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerStopRun(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
41245
|
+
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) => withRunnerContext(signals, (ctx) => handleRunnerKeepalive(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
|
|
40879
41246
|
}
|
|
40880
41247
|
|
|
40881
41248
|
// src/domains/interactiveRunner/promoteSnapshot.ts
|
|
@@ -40932,7 +41299,7 @@ Examples:
|
|
|
40932
41299
|
$ qawolf runner promote-snapshot --screenshot checkout-1-actual.png --baseline checkout-1.png
|
|
40933
41300
|
$ qawolf runner events run-events --tail 20 | jq 'select(.type == "imageDiffArtifact")'`;
|
|
40934
41301
|
function registerRunnerPromoteSnapshotCommand(runner, signals) {
|
|
40935
|
-
declareCommandKind(runner.command("promote-snapshot"), "write").description("Accept a run's screenshot as the new baseline for an image diff, on the runner that produced it").requiredOption("--screenshot <path>", "The screenshot to promote, as the image diff named it").requiredOption("--baseline <path>", "The baseline to replace, as the image diff named it").option("--runner <id>", runnerFlagDescription).addHelpText("after", promoteSnapshotExamples).addHelpText("after", runnerGuides.promoteSnapshot).action((opts, command) =>
|
|
41302
|
+
declareCommandKind(runner.command("promote-snapshot"), "write").description("Accept a run's screenshot as the new baseline for an image diff, on the runner that produced it").requiredOption("--screenshot <path>", "The screenshot to promote, as the image diff named it").requiredOption("--baseline <path>", "The baseline to replace, as the image diff named it").option("--runner <id>", runnerFlagDescription).addHelpText("after", promoteSnapshotExamples).addHelpText("after", runnerGuides.promoteSnapshot).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerPromoteSnapshot(ctx, {
|
|
40936
41303
|
baselinePath: opts.baseline,
|
|
40937
41304
|
runner: opts.runner,
|
|
40938
41305
|
screenshotPath: opts.screenshot
|
|
@@ -41126,7 +41493,7 @@ Examples:
|
|
|
41126
41493
|
$ qawolf runner events run-logs --run <runId> --follow
|
|
41127
41494
|
$ qawolf runner events console --since 120 --json`;
|
|
41128
41495
|
function registerRunnerEventsCommand(runner, signals) {
|
|
41129
|
-
declareCommandKind(runner.command("events <stream>"), "read").description(`Print a runner's journal, one entry per line. QA Wolf writes ${knownJournalStreams.join(", ")}`).option("--follow", "Keep reading as new entries arrive. Reading counts as activity, so a follow left open keeps the runner alive and billing", false).option("--run <id>", "Restrict run-scoped streams to one run").option("--runner <id>", runnerFlagDescription).option("--since <sequence>", "Read entries after this sequence").option("--tail <count>", "Read only the newest <count> entries").option("--timeout <seconds>", "Give up following after this long. Reading keeps the runner alive, so a follow left open would otherwise bill until the terminal closed", String(defaultFollowTimeoutSeconds)).addHelpText("after", eventsExamples).addHelpText("after", runnerGuides.events).action((stream, opts, command) =>
|
|
41496
|
+
declareCommandKind(runner.command("events <stream>"), "read").description(`Print a runner's journal, one entry per line. QA Wolf writes ${knownJournalStreams.join(", ")}`).option("--follow", "Keep reading as new entries arrive. Reading counts as activity, so a follow left open keeps the runner alive and billing", false).option("--run <id>", "Restrict run-scoped streams to one run").option("--runner <id>", runnerFlagDescription).option("--since <sequence>", "Read entries after this sequence").option("--tail <count>", "Read only the newest <count> entries").option("--timeout <seconds>", "Give up following after this long. Reading keeps the runner alive, so a follow left open would otherwise bill until the terminal closed", String(defaultFollowTimeoutSeconds)).addHelpText("after", eventsExamples).addHelpText("after", runnerGuides.events).action((stream, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerEvents(ctx, {
|
|
41130
41497
|
envelope: Boolean(command.optsWithGlobals().json),
|
|
41131
41498
|
follow: opts.follow,
|
|
41132
41499
|
run: opts.run,
|
|
@@ -41600,7 +41967,7 @@ Examples:
|
|
|
41600
41967
|
$ qawolf runner run flows/checkout.flow.ts --lines 4-9 --lines-file pages/login.ts
|
|
41601
41968
|
$ qawolf runner run flows/checkout.flow.ts --env-id staging`;
|
|
41602
41969
|
function registerRunCommand(runner, signals) {
|
|
41603
|
-
declareCommandKind(runner.command("run <flowFile>"), "write").description("Run a flow on an interactive runner, shipping the flow and what it imports").option("--follow", "Report the run's status until it settles: in progress, then passed or failed", false).option("--logs", "Stream every log line the run produces while following. Implies --follow", false).option("--run-events", "Stream the run's progress events as JSON lines while following. Implies --follow", false).option("--recorder-events", "Stream the browser actions the runner records as JSON lines while following, from an anchor taken just before submission: the recorder is runner-wide, not run-scoped. Implies --follow", false).option("--env-id <env>", "QA Wolf environment whose variables the run is given, by id or alias. Defaults to QAWOLF_ENVIRONMENT. QA Wolf reads and decrypts them itself, so they never leave the server and no size limit applies to them").option("--env-file <path>", "Dotenv file on this machine whose variables the run is given. Pass this or --env-id, not both").option("--lines <start-end>", "Run only these 1-indexed lines against the browser as it stands, instead of the whole flow from a fresh one").option("--lines-file <path>", "File the --lines range lives in. Defaults to <flowFile>; pass it only when the lines are in another file, such as a page object").option("--runner <id>", runnerFlagDescription).option("--timeout <seconds>", "Give up following after this long. Following keeps the runner alive, so a run that never settles would otherwise bill until the terminal closed", String(defaultFollowTimeoutSeconds)).addHelpText("after", runExamples2).addHelpText("after", runnerGuides.run).action((flowFile, opts, command) =>
|
|
41970
|
+
declareCommandKind(runner.command("run <flowFile>"), "write").description("Run a flow on an interactive runner, shipping the flow and what it imports").option("--follow", "Report the run's status until it settles: in progress, then passed or failed", false).option("--logs", "Stream every log line the run produces while following. Implies --follow", false).option("--run-events", "Stream the run's progress events as JSON lines while following. Implies --follow", false).option("--recorder-events", "Stream the browser actions the runner records as JSON lines while following, from an anchor taken just before submission: the recorder is runner-wide, not run-scoped. Implies --follow", false).option("--env-id <env>", "QA Wolf environment whose variables the run is given, by id or alias. Defaults to QAWOLF_ENVIRONMENT. QA Wolf reads and decrypts them itself, so they never leave the server and no size limit applies to them").option("--env-file <path>", "Dotenv file on this machine whose variables the run is given. Pass this or --env-id, not both").option("--lines <start-end>", "Run only these 1-indexed lines against the browser as it stands, instead of the whole flow from a fresh one").option("--lines-file <path>", "File the --lines range lives in. Defaults to <flowFile>; pass it only when the lines are in another file, such as a page object").option("--runner <id>", runnerFlagDescription).option("--timeout <seconds>", "Give up following after this long. Following keeps the runner alive, so a run that never settles would otherwise bill until the terminal closed", String(defaultFollowTimeoutSeconds)).addHelpText("after", runExamples2).addHelpText("after", runnerGuides.run).action((flowFile, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRun(ctx, {
|
|
41604
41971
|
entryPoint: flowFile,
|
|
41605
41972
|
envFile: opts.envFile,
|
|
41606
41973
|
envId: opts.envId,
|
|
@@ -41791,26 +42158,26 @@ async function handleRunnerRecordings(ctx, options, deps) {
|
|
|
41791
42158
|
// src/commands/runner/recording.register.ts
|
|
41792
42159
|
function registerRunnerRecordingCommands(runner, signals) {
|
|
41793
42160
|
const record = runner.command("record").description("Control video recording on a browser, mobile, Windows, or Mac runner").addHelpText("after", runnerGuides.record);
|
|
41794
|
-
declareCommandKind(record.command("start"), "write").description("Start manual video capture across runs. Requires a ready screen and suppresses automatic capture until stopped").option("--recording-id <uuid>", "Recording UUID. Generated when omitted; reuse it when retrying this start").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
42161
|
+
declareCommandKind(record.command("start"), "write").description("Start manual video capture across runs. Requires a ready screen and suppresses automatic capture until stopped").option("--recording-id <uuid>", "Recording UUID. Generated when omitted; reuse it when retrying this start").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRecord(ctx, {
|
|
41795
42162
|
command: { action: "start", recordingId: opts.recordingId },
|
|
41796
42163
|
runner: opts.runner
|
|
41797
42164
|
}, runnerDeps(ctx)))(opts, command));
|
|
41798
|
-
declareCommandKind(record.command("stop <recording-id>"), "write").description("Stop the recording with this UUID and publish it. Retrying cannot stop a later recording").option("--runner <id>", runnerFlagDescription).action((recordingId, opts, command) =>
|
|
42165
|
+
declareCommandKind(record.command("stop <recording-id>"), "write").description("Stop the recording with this UUID and publish it. Retrying cannot stop a later recording").option("--runner <id>", runnerFlagDescription).action((recordingId, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRecord(ctx, {
|
|
41799
42166
|
command: { action: "stop", recordingId },
|
|
41800
42167
|
runner: opts.runner
|
|
41801
42168
|
}, runnerDeps(ctx)))(opts, command));
|
|
41802
|
-
declareCommandKind(record.command("status"), "read").description("Show the active recording and automatic recording setting").option("--runner <id>", runnerFlagDescription).action((opts, command) =>
|
|
42169
|
+
declareCommandKind(record.command("status"), "read").description("Show the active recording and automatic recording setting").option("--runner <id>", runnerFlagDescription).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRecord(ctx, {
|
|
41803
42170
|
command: { action: "status" },
|
|
41804
42171
|
runner: opts.runner
|
|
41805
42172
|
}, runnerDeps(ctx)))(opts, command));
|
|
41806
42173
|
declareCommandKind(record.command("auto"), "write").addArgument(new Argument2("<setting>", "Automatic recording setting").choices([
|
|
41807
42174
|
"on",
|
|
41808
42175
|
"off"
|
|
41809
|
-
])).description("Enable or disable automatic recording for subsequent full runs").option("--runner <id>", runnerFlagDescription).action((setting, opts, command) =>
|
|
42176
|
+
])).description("Enable or disable automatic recording for subsequent full runs").option("--runner <id>", runnerFlagDescription).action((setting, opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRecord(ctx, {
|
|
41810
42177
|
command: { action: "auto", enabled: setting === "on" },
|
|
41811
42178
|
runner: opts.runner
|
|
41812
42179
|
}, runnerDeps(ctx)))(opts, command));
|
|
41813
|
-
declareCommandKind(runner.command("list-recordings"), "read").description("Read a page of published video recordings, including after the runner terminates. Platform URLs persist; video URLs expire").option("--runner <id>", runnerFlagDescription).option("--recording-id <uuid>", "Look up one recording; an empty result means it is not published or does not exist").option("--page-token <token>", "Continue from nextPageToken returned by the previous page").addHelpText("after", runnerGuides.listRecordings).action((opts, command) =>
|
|
42180
|
+
declareCommandKind(runner.command("list-recordings"), "read").description("Read a page of published video recordings, including after the runner terminates. Platform URLs persist; video URLs expire").option("--runner <id>", runnerFlagDescription).option("--recording-id <uuid>", "Look up one recording; an empty result means it is not published or does not exist").option("--page-token <token>", "Continue from nextPageToken returned by the previous page").addHelpText("after", runnerGuides.listRecordings).action((opts, command) => withRunnerContext(signals, (ctx) => handleRunnerRecordings(ctx, {
|
|
41814
42181
|
runner: opts.runner,
|
|
41815
42182
|
...opts.recordingId === undefined ? {} : { recordingId: opts.recordingId },
|
|
41816
42183
|
...opts.pageToken === undefined ? {} : { pageToken: opts.pageToken }
|
|
@@ -41819,7 +42186,7 @@ function registerRunnerRecordingCommands(runner, signals) {
|
|
|
41819
42186
|
|
|
41820
42187
|
// src/commands/runner/index.ts
|
|
41821
42188
|
function registerRunnerCommand(program, signals) {
|
|
41822
|
-
const runner = declareReferenceGuide(program.command("runner"), runnerWorkflowGuide).description("Drive an interactive runner on the QA Wolf platform");
|
|
42189
|
+
const runner = declareReferenceGuide(program.command("runner"), runnerWorkflowGuide).description("Drive an interactive runner on the QA Wolf platform").addOption(workspaceIdOption()).configureHelp({ showGlobalOptions: true });
|
|
41823
42190
|
registerRunnerLifecycleCommands(runner, signals);
|
|
41824
42191
|
registerRunCommand(runner, signals);
|
|
41825
42192
|
registerRunnerEventsCommand(runner, signals);
|
|
@@ -41863,4 +42230,4 @@ createProgram({ signals }).parseAsync().catch(() => {
|
|
|
41863
42230
|
process.exitCode = 1;
|
|
41864
42231
|
}).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
|
|
41865
42232
|
|
|
41866
|
-
//# debugId=
|
|
42233
|
+
//# debugId=F41EBBF938D33FDB64756E2164756E21
|