@qawolf/cli 2.3.0 → 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 CHANGED
@@ -17132,6 +17132,37 @@ var defaultIdSchemas = {
17132
17132
  };
17133
17133
  var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
17134
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
+
17135
17166
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
17136
17167
  var makeFlowSelectionSchema = (ids) => object({
17137
17168
  flowIds: array(ids.flow).default([]),
@@ -17144,6 +17175,7 @@ var makeFlowSelectionSchema = (ids) => object({
17144
17175
  var makeCreateRunContract = (ids) => {
17145
17176
  const input = object({
17146
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."),
17147
17179
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
17148
17180
  environmentId: ids.environmentRef,
17149
17181
  environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
@@ -17608,14 +17640,14 @@ var makeInspectMobileOnRunnerContract = (ids) => {
17608
17640
  annotationJustifications: {
17609
17641
  destructiveHint: "Does not change application data, edit tests, or stop the runner.",
17610
17642
  openWorldHint: "Inspects the existing QA Wolf mobile runner without submitting application actions or contacting arbitrary services.",
17611
- readOnlyHint: "Reads mobile session status, contexts, page source, or elements without refreshing the runner's inactivity timer."
17643
+ readOnlyHint: "Reads mobile session status, contexts, page source, or elements and refreshes activity, which can cancel an inactivity shutdown."
17612
17644
  },
17613
17645
  annotations: {
17614
17646
  destructiveHint: false,
17615
17647
  openWorldHint: false,
17616
- readOnlyHint: true
17648
+ readOnlyHint: false
17617
17649
  },
17618
- 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 does not refresh the runner's inactivity timer. 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}`,
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}`,
17619
17651
  input,
17620
17652
  kind: "read",
17621
17653
  name: "runner.inspectMobile",
@@ -17982,7 +18014,7 @@ var makeRecordOnRunnerContract = (ids) => {
17982
18014
  openWorldHint: false,
17983
18015
  readOnlyHint: false
17984
18016
  },
17985
- description: "Control video recording on a Playwright 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.",
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.",
17986
18018
  input,
17987
18019
  kind: "write",
17988
18020
  name: "runner.record",
@@ -18062,6 +18094,7 @@ var makeTriggerActionSchema = (ids) => object({
18062
18094
  investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
18063
18095
  kind: triggerActionKindSchema.default("createSuite"),
18064
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."),
18065
18098
  tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
18066
18099
  }).describe("What the trigger runs when it fires.");
18067
18100
  var makeTriggerScheduleFields = (ids) => ({
@@ -18584,6 +18617,173 @@ var makeGetAttemptContract = (ids) => {
18584
18617
  };
18585
18618
  };
18586
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
+
18587
18787
  // node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/resource.js
18588
18788
  var makeCodeHostIntegrationResourceSchema = () => resource({
18589
18789
  connectedAt: exports_iso.datetime().describe("When the code host was connected to the workspace."),
@@ -18820,6 +19020,7 @@ var makeReportDeploymentStatusContract = (ids) => {
18820
19020
  error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
18821
19021
  });
18822
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."),
18823
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(),
18824
19025
  environment: environment.describe("Selects the environment the deployment reports into.").optional(),
18825
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(),
@@ -19713,12 +19914,28 @@ var makeGetIssueContract = (ids) => {
19713
19914
  };
19714
19915
 
19715
19916
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/finding.js
19716
- var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "dismissed". New values can appear.';
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
+ });
19717
19928
  var makeInvestigationFindingSchema = (ids) => object({
19718
19929
  actual: string2().optional(),
19719
19930
  commitHash: string2().optional().describe("The commit of a commit fix. Same as `fix.commitHash`."),
19720
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."),
19721
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."),
19722
19939
  expected: string2().optional(),
19723
19940
  findingId: string2(),
19724
19941
  fix: discriminatedUnion("type", [
@@ -19745,15 +19962,7 @@ var makeInvestigationFindingSchema = (ids) => object({
19745
19962
  reason: string2().describe("Why the investigation reached the verdict."),
19746
19963
  verdict: string2().describe('Whether the pull request caused the failure. Known values: "caused", "not-caused" and "unclear". New values can appear.')
19747
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."),
19748
- question: object({
19749
- answers: array(object({
19750
- description: string2().optional(),
19751
- title: string2(),
19752
- value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
19753
- })),
19754
- 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).'),
19755
- text: string2()
19756
- }).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."),
19757
19966
  response: object({
19758
19967
  answer: string2().optional(),
19759
19968
  at: exports_iso.datetime(),
@@ -19765,6 +19974,7 @@ var makeInvestigationFindingSchema = (ids) => object({
19765
19974
  steps: array(string2()).optional(),
19766
19975
  subSessionIds: array(ids.chatSession),
19767
19976
  summary: string2().optional(),
19977
+ supersededByRunId: ids.run.optional().describe('The newer run that replaced this run, on a "superseded" finding.'),
19768
19978
  updatedAt: exports_iso.datetime()
19769
19979
  });
19770
19980
 
@@ -19774,6 +19984,17 @@ var makeGetInvestigationContract = (ids) => {
19774
19984
  const output = resource({
19775
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.'),
19776
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."),
19777
19998
  runId: ids.run,
19778
19999
  sessionId: ids.chatSession.optional().describe("The investigation session. Absent when the run has none."),
19779
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.'),
@@ -19801,9 +20022,55 @@ var makeGetInvestigationContract = (ids) => {
19801
20022
  };
19802
20023
  };
19803
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
+
19804
20070
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/index.js
19805
20071
  var makeInvestigationContracts = (ids) => ({
19806
- get: makeGetInvestigationContract(ids)
20072
+ get: makeGetInvestigationContract(ids),
20073
+ question: makeInvestigationQuestionContracts(ids)
19807
20074
  });
19808
20075
 
19809
20076
  // node_modules/@qawolf/api-contracts/dist/v1/issue/addFlows.js
@@ -19893,6 +20160,35 @@ var makeCreateIssueContract = (ids) => {
19893
20160
  };
19894
20161
  };
19895
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
+
19896
20192
  // node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
19897
20193
  var issueActivityTypeSchema = _enum([
19898
20194
  "created",
@@ -20152,6 +20448,35 @@ var makeLegacyTriggerContracts = (ids) => ({
20152
20448
  resume: makeResumeLegacyTriggerContract(ids)
20153
20449
  });
20154
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
+
20155
20480
  // node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
20156
20481
  var investigationSessionId = string2().trim().min(1).max(100).optional();
20157
20482
 
@@ -20235,6 +20560,7 @@ var makeDiagnoseRunContract = (ids) => {
20235
20560
  // node_modules/@qawolf/api-contracts/dist/v1/run/find.js
20236
20561
  var makeFindRunsContract = (ids) => {
20237
20562
  const input = object({
20563
+ buildId: buildIdSchema.optional().describe("Only include runs that installed this build."),
20238
20564
  createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include runs created after this instant, e.g. the runs since a deploy."),
20239
20565
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
20240
20566
  environmentId: ids.environmentRef,
@@ -20359,6 +20685,7 @@ var makeGetRunContract = (ids) => {
20359
20685
  const output = resource({
20360
20686
  ...makeRunSummaryFields(ids),
20361
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."),
20362
20689
  flows,
20363
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.")
20364
20691
  }, { urlFieldDescription: "Absolute URL of the run page." });
@@ -20835,7 +21162,7 @@ var makeReadRunnerJournalContract = (ids) => {
20835
21162
  openWorldHint: false,
20836
21163
  readOnlyHint: false
20837
21164
  },
20838
- 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}`,
20839
21166
  input,
20840
21167
  kind: "read",
20841
21168
  name: "runner.readJournal",
@@ -20985,7 +21312,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
20985
21312
  openWorldHint: false,
20986
21313
  readOnlyHint: false
20987
21314
  },
20988
- description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
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}`,
20989
21316
  input,
20990
21317
  kind: "read",
20991
21318
  name: "runner.takeScreenshot",
@@ -21120,6 +21447,7 @@ var makeContractsV1 = (ids) => {
21120
21447
  attempt: {
21121
21448
  get: makeGetAttemptContract(resolvedIds)
21122
21449
  },
21450
+ build: makeBuildContracts(resolvedIds),
21123
21451
  codeHostIntegration: {
21124
21452
  find: makeFindCodeHostIntegrationsContract(resolvedIds),
21125
21453
  listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
@@ -21157,6 +21485,7 @@ var makeContractsV1 = (ids) => {
21157
21485
  issue: {
21158
21486
  addFlows: makeAddFlowsToIssueContract(resolvedIds),
21159
21487
  create: makeCreateIssueContract(resolvedIds),
21488
+ decideSuggestion: makeDecideSuggestionContract(resolvedIds),
21160
21489
  find: makeFindIssuesContract(resolvedIds),
21161
21490
  get: makeGetIssueContract(resolvedIds),
21162
21491
  listActivity: makeListIssueActivityContract(resolvedIds),
@@ -21164,6 +21493,9 @@ var makeContractsV1 = (ids) => {
21164
21493
  update: makeUpdateIssueContract(resolvedIds)
21165
21494
  },
21166
21495
  legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
21496
+ mcpServer: {
21497
+ connect: makeConnectMcpServerContract(resolvedIds)
21498
+ },
21167
21499
  promotion: makePromotionContracts(resolvedIds),
21168
21500
  run: {
21169
21501
  acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
@@ -23691,7 +24023,7 @@ function startUpdateCheck(deps) {
23691
24023
  // package.json
23692
24024
  var package_default = {
23693
24025
  name: "@qawolf/cli",
23694
- version: "2.3.0",
24026
+ version: "2.4.0",
23695
24027
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
23696
24028
  keywords: [
23697
24029
  "automation",
@@ -23763,7 +24095,7 @@ var package_default = {
23763
24095
  "@clack/prompts": "1.5.1",
23764
24096
  "@napi-rs/keyring": "1.3.0",
23765
24097
  "@oxc-node/core": "0.1.0",
23766
- "@qawolf/api-contracts": "0.98.1",
24098
+ "@qawolf/api-contracts": "0.104.0",
23767
24099
  "@qawolf/emails": "1.1.1",
23768
24100
  "@qawolf/flow-targets": "2.0.0",
23769
24101
  "@qawolf/flows": "0.3.0",
@@ -41898,4 +42230,4 @@ createProgram({ signals }).parseAsync().catch(() => {
41898
42230
  process.exitCode = 1;
41899
42231
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
41900
42232
 
41901
- //# debugId=EE62A061E9D077A764756E2164756E21
42233
+ //# debugId=F41EBBF938D33FDB64756E2164756E21
@@ -7365,6 +7365,37 @@ var defaultIdSchemas = {
7365
7365
  };
7366
7366
  var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
7367
7367
 
7368
+ // node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
7369
+ var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
7370
+ 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.");
7371
+ var makeBuildResourceSchema = (ids) => resource({
7372
+ appId: string2().describe("The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`."),
7373
+ appName: string2().optional().describe("The app's display name, when the file names one."),
7374
+ branch: string2().optional().describe("The branch the uploader said the build came from."),
7375
+ buildNumber: string2().optional().describe("versionCode (Android) or CFBundleVersion (iOS), when the file has one."),
7376
+ commitSha: string2().optional().describe("The commit the uploader said the build came from."),
7377
+ createdAt: exports_iso.datetime().describe("When the build was created."),
7378
+ deletedAt: exports_iso.datetime().optional().describe("When the build was deleted. Runs never install it after."),
7379
+ 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."),
7380
+ fileName: string2().describe("The uploaded file's name."),
7381
+ id: buildIdSchema,
7382
+ platform: buildPlatformSchema,
7383
+ sizeBytes: number2().int().optional().describe("The file's size in bytes."),
7384
+ version: string2().optional().describe("versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.")
7385
+ }, { urlFieldDescription: "Absolute URL of the team's Builds page." });
7386
+ var makeBuildEnvironmentSelectorSchema = (ids) => union([
7387
+ strictObject({
7388
+ id: ids.environment.describe("The id of an existing environment. Never creates an environment. Send an alias through name instead.")
7389
+ }),
7390
+ strictObject({
7391
+ 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."),
7392
+ 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."),
7393
+ 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.")
7394
+ })
7395
+ ], {
7396
+ error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
7397
+ });
7398
+
7368
7399
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
7369
7400
  var makeFlowSelectionSchema = (ids) => object({
7370
7401
  flowIds: array(ids.flow).default([]),
@@ -7377,6 +7408,7 @@ var makeFlowSelectionSchema = (ids) => object({
7377
7408
  var makeCreateRunContract = (ids) => {
7378
7409
  const input = object({
7379
7410
  aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
7411
+ 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."),
7380
7412
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
7381
7413
  environmentId: ids.environmentRef,
7382
7414
  environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
@@ -7844,14 +7876,14 @@ var makeInspectMobileOnRunnerContract = (ids) => {
7844
7876
  annotationJustifications: {
7845
7877
  destructiveHint: "Does not change application data, edit tests, or stop the runner.",
7846
7878
  openWorldHint: "Inspects the existing QA Wolf mobile runner without submitting application actions or contacting arbitrary services.",
7847
- readOnlyHint: "Reads mobile session status, contexts, page source, or elements without refreshing the runner's inactivity timer."
7879
+ readOnlyHint: "Reads mobile session status, contexts, page source, or elements and refreshes activity, which can cancel an inactivity shutdown."
7848
7880
  },
7849
7881
  annotations: {
7850
7882
  destructiveHint: false,
7851
7883
  openWorldHint: false,
7852
- readOnlyHint: true
7884
+ readOnlyHint: false
7853
7885
  },
7854
- 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 does not refresh the runner's inactivity timer. 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}`,
7886
+ 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}`,
7855
7887
  input,
7856
7888
  kind: "read",
7857
7889
  name: "runner.inspectMobile",
@@ -8220,7 +8252,7 @@ var makeRecordOnRunnerContract = (ids) => {
8220
8252
  openWorldHint: false,
8221
8253
  readOnlyHint: false
8222
8254
  },
8223
- description: "Control video recording on a Playwright 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.",
8255
+ 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.",
8224
8256
  input,
8225
8257
  kind: "write",
8226
8258
  name: "runner.record",
@@ -8301,6 +8333,7 @@ var makeTriggerActionSchema = (ids) => object({
8301
8333
  investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
8302
8334
  kind: triggerActionKindSchema.default("createSuite"),
8303
8335
  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.`),
8336
+ suggestCoverage: boolean2().optional().describe("Whether QA Wolf explores the environment after the resulting runs and suggests coverage that nothing tests yet. Defaults to false."),
8304
8337
  tagNames: array(string2().min(1)).default([]).describe("Tags naming the flows to run. Combined with flowIds.")
8305
8338
  }).describe("What the trigger runs when it fires.");
8306
8339
  var makeTriggerScheduleFields = (ids) => ({
@@ -8823,6 +8856,173 @@ var makeGetAttemptContract = (ids) => {
8823
8856
  };
8824
8857
  };
8825
8858
 
8859
+ // node_modules/@qawolf/api-contracts/dist/v1/build/create.js
8860
+ var makeCreateBuildContract = (ids) => {
8861
+ const input = object({
8862
+ branch: string2().trim().min(1).max(255).optional().describe("The branch the build came from. Shown with the build."),
8863
+ buildId: buildIdSchema.describe("The buildId build.requestUpload answered with. Upload the file first."),
8864
+ commitSha: string2().trim().min(1).max(255).optional().describe("The commit the build came from. Shown with the build."),
8865
+ 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."),
8866
+ workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
8867
+ }).superRefine((value, context) => {
8868
+ if (value.environment !== undefined && "name" in value.environment && value.environment.baseEphemeralEnvironment !== undefined && value.environment.ephemeral !== true) {
8869
+ context.addIssue({
8870
+ code: "custom",
8871
+ message: "baseEphemeralEnvironment is only valid with ephemeral.",
8872
+ path: ["environment", "baseEphemeralEnvironment"]
8873
+ });
8874
+ }
8875
+ });
8876
+ const output = object({ build: makeBuildResourceSchema(ids) });
8877
+ return {
8878
+ annotationJustifications: {
8879
+ destructiveHint: "Creates a build. With an environment, later runs there install it instead of the previous build.",
8880
+ openWorldHint: "Reads the uploaded file from QA Wolf storage only.",
8881
+ readOnlyHint: "Creates a build, and can create the environment it names."
8882
+ },
8883
+ annotations: {
8884
+ destructiveHint: false,
8885
+ openWorldHint: false,
8886
+ readOnlyHint: false
8887
+ },
8888
+ 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.",
8889
+ input,
8890
+ kind: "write",
8891
+ name: "build.create",
8892
+ output
8893
+ };
8894
+ };
8895
+
8896
+ // node_modules/@qawolf/api-contracts/dist/v1/build/delete.js
8897
+ var makeDeleteBuildContract = (ids) => {
8898
+ const input = object({
8899
+ buildId: buildIdSchema,
8900
+ workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
8901
+ });
8902
+ const output = object({ build: makeBuildResourceSchema(ids) });
8903
+ return {
8904
+ annotationJustifications: {
8905
+ 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.",
8906
+ openWorldHint: "Changes QA Wolf data and storage only.",
8907
+ readOnlyHint: "Deletes one build."
8908
+ },
8909
+ annotations: {
8910
+ destructiveHint: true,
8911
+ openWorldHint: false,
8912
+ readOnlyHint: false
8913
+ },
8914
+ 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.",
8915
+ input,
8916
+ kind: "write",
8917
+ name: "build.delete",
8918
+ output
8919
+ };
8920
+ };
8921
+
8922
+ // node_modules/@qawolf/api-contracts/dist/v1/build/get.js
8923
+ var makeGetBuildContract = (ids) => {
8924
+ const input = object({
8925
+ buildId: buildIdSchema,
8926
+ workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
8927
+ });
8928
+ const output = object({ build: makeBuildResourceSchema(ids) });
8929
+ return {
8930
+ annotationJustifications: {
8931
+ destructiveHint: "Does not change the build.",
8932
+ openWorldHint: "Reads QA Wolf data only.",
8933
+ readOnlyHint: "Reads one build."
8934
+ },
8935
+ annotations: {
8936
+ destructiveHint: false,
8937
+ openWorldHint: false,
8938
+ readOnlyHint: true
8939
+ },
8940
+ description: "Get a build: its app, platform, version and environment. Deleted builds are returned too.",
8941
+ input,
8942
+ kind: "read",
8943
+ name: "build.get",
8944
+ output
8945
+ };
8946
+ };
8947
+
8948
+ // node_modules/@qawolf/api-contracts/dist/v1/build/list.js
8949
+ var makeListBuildsContract = (ids) => {
8950
+ const input = object({
8951
+ appId: string2().trim().min(1).optional().describe("Only list builds of this package name or bundle ID."),
8952
+ environmentId: ids.environment.optional().describe("Only list builds on this environment."),
8953
+ 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."),
8954
+ workspaceId: ids.workspace.optional().describe("The workspace to list builds from. Required when authenticating with an organization or user API key."),
8955
+ ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
8956
+ }).refine((value) => !value.latestOnly || value.environmentId !== undefined, {
8957
+ message: "latestOnly requires environmentId.",
8958
+ path: ["latestOnly"]
8959
+ });
8960
+ const output = object({
8961
+ builds: array(makeBuildResourceSchema(ids)).describe("Undeleted builds, newest first."),
8962
+ nextCursor: nextCursorSchema
8963
+ });
8964
+ return {
8965
+ annotationJustifications: {
8966
+ destructiveHint: "Does not change any build.",
8967
+ openWorldHint: "Reads QA Wolf data only.",
8968
+ readOnlyHint: "Lists builds."
8969
+ },
8970
+ annotations: {
8971
+ destructiveHint: false,
8972
+ openWorldHint: false,
8973
+ readOnlyHint: true
8974
+ },
8975
+ description: "List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs.",
8976
+ input,
8977
+ kind: "read",
8978
+ name: "build.list",
8979
+ output
8980
+ };
8981
+ };
8982
+
8983
+ // node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
8984
+ var maxBuildFileBytes = 500 * 1024 * 1024;
8985
+ var makeRequestBuildUploadContract = (ids) => {
8986
+ const input = object({
8987
+ 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."),
8988
+ 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."),
8989
+ 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."),
8990
+ workspaceId: ids.workspace.optional().describe("The workspace to upload into. Required when authenticating with an organization or user API key.")
8991
+ });
8992
+ const output = object({
8993
+ buildId: buildIdSchema.describe("Send this to build.create after the PUT."),
8994
+ expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
8995
+ uploadHeaders: record(string2(), string2()).describe("Send these headers with the PUT, exactly. The URL is signed for them."),
8996
+ 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.")
8997
+ });
8998
+ return {
8999
+ annotationJustifications: {
9000
+ destructiveHint: "The URL only creates a new file. It cannot overwrite or delete one.",
9001
+ openWorldHint: "The upload target is QA Wolf's run inputs storage, not an external service.",
9002
+ readOnlyHint: "Returns an expiring URL that permits writing one file to the workspace's storage."
9003
+ },
9004
+ annotations: {
9005
+ destructiveHint: false,
9006
+ openWorldHint: false,
9007
+ readOnlyHint: false
9008
+ },
9009
+ 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.",
9010
+ input,
9011
+ kind: "write",
9012
+ name: "build.requestUpload",
9013
+ output
9014
+ };
9015
+ };
9016
+
9017
+ // node_modules/@qawolf/api-contracts/dist/v1/build/index.js
9018
+ var makeBuildContracts = (ids) => ({
9019
+ create: makeCreateBuildContract(ids),
9020
+ delete: makeDeleteBuildContract(ids),
9021
+ get: makeGetBuildContract(ids),
9022
+ list: makeListBuildsContract(ids),
9023
+ requestUpload: makeRequestBuildUploadContract(ids)
9024
+ });
9025
+
8826
9026
  // node_modules/@qawolf/api-contracts/dist/v1/codeHostIntegration/resource.js
8827
9027
  var makeCodeHostIntegrationResourceSchema = () => resource({
8828
9028
  connectedAt: exports_iso.datetime().describe("When the code host was connected to the workspace."),
@@ -9059,6 +9259,7 @@ var makeReportDeploymentStatusContract = (ids) => {
9059
9259
  error: "Send environment as either { id } or { name }, with optional ephemeral and baseEphemeralEnvironment."
9060
9260
  });
9061
9261
  const input = strictObject({
9262
+ 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."),
9062
9263
  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(),
9063
9264
  environment: environment.describe("Selects the environment the deployment reports into.").optional(),
9064
9265
  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(),
@@ -9952,12 +10153,28 @@ var makeGetIssueContract = (ids) => {
9952
10153
  };
9953
10154
 
9954
10155
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/finding.js
9955
- var investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "dismissed". New values can appear.';
10156
+ 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.';
10157
+ var investigationQuestionSchema = object({
10158
+ answers: array(object({
10159
+ description: string2().optional(),
10160
+ title: string2(),
10161
+ value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
10162
+ })),
10163
+ 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."),
10164
+ 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).'),
10165
+ text: string2()
10166
+ });
9956
10167
  var makeInvestigationFindingSchema = (ids) => object({
9957
10168
  actual: string2().optional(),
9958
10169
  commitHash: string2().optional().describe("The commit of a commit fix. Same as `fix.commitHash`."),
9959
10170
  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."),
9960
10171
  disputeReason: string2().optional().describe("Why a person disputed what the AI did. Present on a proposal the AI made again after that dispute."),
10172
+ earlierQuestions: array(object({
10173
+ answer: string2(),
10174
+ answeredAt: exports_iso.datetime(),
10175
+ body: string2().optional(),
10176
+ text: string2()
10177
+ })).optional().describe("Questions about this cause that a person already answered, oldest first. The AI acted on each answer."),
9961
10178
  expected: string2().optional(),
9962
10179
  findingId: string2(),
9963
10180
  fix: discriminatedUnion("type", [
@@ -9984,15 +10201,7 @@ var makeInvestigationFindingSchema = (ids) => object({
9984
10201
  reason: string2().describe("Why the investigation reached the verdict."),
9985
10202
  verdict: string2().describe('Whether the pull request caused the failure. Known values: "caused", "not-caused" and "unclear". New values can appear.')
9986
10203
  }).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."),
9987
- question: object({
9988
- answers: array(object({
9989
- description: string2().optional(),
9990
- title: string2(),
9991
- value: string2().describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance", "bug" and "baseline". New values can appear.')
9992
- })),
9993
- 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).'),
9994
- text: string2()
9995
- }).optional().describe("The question waiting for a person, with the answers offered."),
10204
+ question: investigationQuestionSchema.optional().describe("The question waiting for a person, with the answers offered."),
9996
10205
  response: object({
9997
10206
  answer: string2().optional(),
9998
10207
  at: exports_iso.datetime(),
@@ -10004,6 +10213,7 @@ var makeInvestigationFindingSchema = (ids) => object({
10004
10213
  steps: array(string2()).optional(),
10005
10214
  subSessionIds: array(ids.chatSession),
10006
10215
  summary: string2().optional(),
10216
+ supersededByRunId: ids.run.optional().describe('The newer run that replaced this run, on a "superseded" finding.'),
10007
10217
  updatedAt: exports_iso.datetime()
10008
10218
  });
10009
10219
 
@@ -10013,6 +10223,17 @@ var makeGetInvestigationContract = (ids) => {
10013
10223
  const output = resource({
10014
10224
  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.'),
10015
10225
  findings: array(makeInvestigationFindingSchema(ids)),
10226
+ questionsFromOtherRuns: array(object({
10227
+ answer: string2().optional().describe(`The person's answer, when status is "answered".`),
10228
+ answeredAt: exports_iso.datetime().optional(),
10229
+ body: string2().optional(),
10230
+ findingId: string2(),
10231
+ flowIds: array(ids.flow),
10232
+ headline: string2().optional().describe("The cause that the question is about."),
10233
+ runId: ids.run,
10234
+ status: string2().describe('Known values: "open" (waiting for a person) and "answered". New values can appear.'),
10235
+ text: string2()
10236
+ })).optional().describe("Questions that the workspace's other run investigations asked about the same flows in the last 7 days, newest first."),
10016
10237
  runId: ids.run,
10017
10238
  sessionId: ids.chatSession.optional().describe("The investigation session. Absent when the run has none."),
10018
10239
  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.'),
@@ -10040,9 +10261,55 @@ var makeGetInvestigationContract = (ids) => {
10040
10261
  };
10041
10262
  };
10042
10263
 
10264
+ // node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
10265
+ var makeFindInvestigationQuestionsContract = (ids) => {
10266
+ const input = object({
10267
+ ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
10268
+ environmentId: ids.environmentRef.optional().describe("Only list the questions of runs in this environment. Omit to list the questions of every environment."),
10269
+ 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.`),
10270
+ workspaceId: ids.workspace.optional().describe("The workspace to list questions from. Required when authenticating with an organization or user API key.")
10271
+ });
10272
+ const output = object({
10273
+ nextCursor: nextCursorSchema,
10274
+ questions: array(resource({
10275
+ askedAt: exports_iso.datetime().describe("When the investigation first recorded the finding that asks the question."),
10276
+ findingId: string2(),
10277
+ flows: array(object({ flowId: ids.flow, name: string2() })).describe("The failed flows the question is about."),
10278
+ headline: string2().optional(),
10279
+ question: investigationQuestionSchema,
10280
+ runId: ids.run,
10281
+ sessionId: ids.chatSession.describe("The investigation session. Answer the question by sending the person's answer to it with agent.send."),
10282
+ summary: string2().optional()
10283
+ }, { urlFieldDescription: "The run in the QA Wolf app." })).describe("Questions that wait for a person's answer, the most recently recorded first. A page can hold fewer than limit questions, or none, while nextCursor is present.")
10284
+ });
10285
+ return {
10286
+ annotationJustifications: {
10287
+ destructiveHint: "Does not answer, dismiss or change any question.",
10288
+ openWorldHint: "Reads recorded QA Wolf findings without changing the application under test.",
10289
+ readOnlyHint: "Lists the open questions of a workspace's investigations without answering them."
10290
+ },
10291
+ annotations: {
10292
+ destructiveHint: false,
10293
+ openWorldHint: false,
10294
+ readOnlyHint: true
10295
+ },
10296
+ description: "List the questions the QA Wolf AI investigating failed runs is waiting for a person to answer, across a workspace's runs. " + "Each question names its run, flows, details and offered answers. " + "To answer one, send the person's answer to its sessionId with agent.send.",
10297
+ input,
10298
+ kind: "read",
10299
+ name: "investigation.question.find",
10300
+ output
10301
+ };
10302
+ };
10303
+
10304
+ // node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
10305
+ var makeInvestigationQuestionContracts = (ids) => ({
10306
+ find: makeFindInvestigationQuestionsContract(ids)
10307
+ });
10308
+
10043
10309
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/index.js
10044
10310
  var makeInvestigationContracts = (ids) => ({
10045
- get: makeGetInvestigationContract(ids)
10311
+ get: makeGetInvestigationContract(ids),
10312
+ question: makeInvestigationQuestionContracts(ids)
10046
10313
  });
10047
10314
 
10048
10315
  // node_modules/@qawolf/api-contracts/dist/v1/issue/addFlows.js
@@ -10132,6 +10399,35 @@ var makeCreateIssueContract = (ids) => {
10132
10399
  };
10133
10400
  };
10134
10401
 
10402
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
10403
+ var makeDecideSuggestionContract = (ids) => {
10404
+ const input = object({
10405
+ 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."),
10406
+ issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
10407
+ skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
10408
+ }).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
10409
+ const output = object({
10410
+ issue: makeIssueResourceSchema(ids)
10411
+ });
10412
+ return {
10413
+ annotationJustifications: {
10414
+ destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
10415
+ openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
10416
+ readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
10417
+ },
10418
+ annotations: {
10419
+ destructiveHint: false,
10420
+ openWorldHint: true,
10421
+ readOnlyHint: false
10422
+ },
10423
+ 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.",
10424
+ input,
10425
+ kind: "write",
10426
+ name: "issue.decideSuggestion",
10427
+ output
10428
+ };
10429
+ };
10430
+
10135
10431
  // node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
10136
10432
  var issueActivityTypeSchema = _enum([
10137
10433
  "created",
@@ -10391,6 +10687,35 @@ var makeLegacyTriggerContracts = (ids) => ({
10391
10687
  resume: makeResumeLegacyTriggerContract(ids)
10392
10688
  });
10393
10689
 
10690
+ // node_modules/@qawolf/api-contracts/dist/v1/mcpServer/connect.js
10691
+ var makeConnectMcpServerContract = (ids) => {
10692
+ const input = object({
10693
+ server: string2().trim().min(1).describe("The server to connect, by its catalog id or name, such as linear or Linear."),
10694
+ workspaceId: ids.workspace.optional().describe("The workspace to connect the server to. Required when authenticating with an organization or user API key.")
10695
+ });
10696
+ const output = object({
10697
+ authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
10698
+ serverName: string2().describe("The catalog name of the server.")
10699
+ });
10700
+ return {
10701
+ annotationJustifications: {
10702
+ destructiveHint: "Starts a sign-in without changing or removing existing connections.",
10703
+ openWorldHint: "Asks the external server's OAuth provider for a sign-in page.",
10704
+ readOnlyHint: "Records a pending connection on the workspace."
10705
+ },
10706
+ annotations: {
10707
+ destructiveHint: false,
10708
+ openWorldHint: true,
10709
+ readOnlyHint: false
10710
+ },
10711
+ 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.",
10712
+ input,
10713
+ kind: "write",
10714
+ name: "mcpServer.connect",
10715
+ output
10716
+ };
10717
+ };
10718
+
10394
10719
  // node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
10395
10720
  var investigationSessionId = string2().trim().min(1).max(100).optional();
10396
10721
 
@@ -10474,6 +10799,7 @@ var makeDiagnoseRunContract = (ids) => {
10474
10799
  // node_modules/@qawolf/api-contracts/dist/v1/run/find.js
10475
10800
  var makeFindRunsContract = (ids) => {
10476
10801
  const input = object({
10802
+ buildId: buildIdSchema.optional().describe("Only include runs that installed this build."),
10477
10803
  createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include runs created after this instant, e.g. the runs since a deploy."),
10478
10804
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
10479
10805
  environmentId: ids.environmentRef,
@@ -10598,6 +10924,7 @@ var makeGetRunContract = (ids) => {
10598
10924
  const output = resource({
10599
10925
  ...makeRunSummaryFields(ids),
10600
10926
  blockingBugCount: number2().int().nonnegative().describe("How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved."),
10927
+ builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
10601
10928
  flows,
10602
10929
  runId: ids.run.describe("The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.")
10603
10930
  }, { urlFieldDescription: "Absolute URL of the run page." });
@@ -11074,7 +11401,7 @@ var makeReadRunnerJournalContract = (ids) => {
11074
11401
  openWorldHint: false,
11075
11402
  readOnlyHint: false
11076
11403
  },
11077
- 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}`,
11404
+ 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}`,
11078
11405
  input,
11079
11406
  kind: "read",
11080
11407
  name: "runner.readJournal",
@@ -11224,7 +11551,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
11224
11551
  openWorldHint: false,
11225
11552
  readOnlyHint: false
11226
11553
  },
11227
- description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
11554
+ 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}`,
11228
11555
  input,
11229
11556
  kind: "read",
11230
11557
  name: "runner.takeScreenshot",
@@ -11359,6 +11686,7 @@ var makeContractsV1 = (ids) => {
11359
11686
  attempt: {
11360
11687
  get: makeGetAttemptContract(resolvedIds)
11361
11688
  },
11689
+ build: makeBuildContracts(resolvedIds),
11362
11690
  codeHostIntegration: {
11363
11691
  find: makeFindCodeHostIntegrationsContract(resolvedIds),
11364
11692
  listRepositories: makeListCodeHostRepositoriesContract(resolvedIds)
@@ -11396,6 +11724,7 @@ var makeContractsV1 = (ids) => {
11396
11724
  issue: {
11397
11725
  addFlows: makeAddFlowsToIssueContract(resolvedIds),
11398
11726
  create: makeCreateIssueContract(resolvedIds),
11727
+ decideSuggestion: makeDecideSuggestionContract(resolvedIds),
11399
11728
  find: makeFindIssuesContract(resolvedIds),
11400
11729
  get: makeGetIssueContract(resolvedIds),
11401
11730
  listActivity: makeListIssueActivityContract(resolvedIds),
@@ -11403,6 +11732,9 @@ var makeContractsV1 = (ids) => {
11403
11732
  update: makeUpdateIssueContract(resolvedIds)
11404
11733
  },
11405
11734
  legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
11735
+ mcpServer: {
11736
+ connect: makeConnectMcpServerContract(resolvedIds)
11737
+ },
11406
11738
  promotion: makePromotionContracts(resolvedIds),
11407
11739
  run: {
11408
11740
  acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
@@ -16142,4 +16474,4 @@ export {
16142
16474
  createRunnerSdk
16143
16475
  };
16144
16476
 
16145
- //# debugId=6228F1BDD956959964756E2164756E21
16477
+ //# debugId=87F77F3A03400AEC64756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.3.0",
3
+ "version": "2.4.0",
4
4
  "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
5
5
  "keywords": [
6
6
  "automation",
@@ -72,7 +72,7 @@
72
72
  "@clack/prompts": "1.5.1",
73
73
  "@napi-rs/keyring": "1.3.0",
74
74
  "@oxc-node/core": "0.1.0",
75
- "@qawolf/api-contracts": "0.98.1",
75
+ "@qawolf/api-contracts": "0.104.0",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "@qawolf/flows": "0.3.0",
@@ -142,6 +142,11 @@ that `url`; never guess a route and never send a repository link in its place.
142
142
  | `qawolf auth logout` | local | Remove stored credentials |
143
143
  | `qawolf auth switch` | local | Choose which workspace to work in |
144
144
  | `qawolf auth whoami` | read | Show authentication status |
145
+ | `qawolf build create` | write | 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. |
146
+ | `qawolf build delete` | write | 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. |
147
+ | `qawolf build get` | read | Get a build: its app, platform, version and environment. Deleted builds are returned too. |
148
+ | `qawolf build list` | read | List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs. |
149
+ | `qawolf build requestUpload` | write | 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. |
145
150
  | `qawolf codeHostIntegration find` | read | List the workspace's code host integrations (GitHub or GitLab). A connected integration lets QA Wolf read repositories and receive the code host's webhooks. codeHostIntegration.listRepositories pages the repositories each integration covers. |
146
151
  | `qawolf codeHostIntegration listRepositories` | read | List the repositories the workspace's code host integrations cover, alphabetical by full name. The list reflects the last sync from the code host; codeHostIntegration.find lists the integrations themselves. |
147
152
  | `qawolf deployment find` | read | List the deployments QA Wolf has received for the workspace, newest first. A deployment arrives through a code host integration's webhook or through deployment.reportStatus, and is what a deployment trigger evaluates against. deployment.listTriggerEvaluations reports each trigger's verdict for one deployment. |
@@ -179,8 +184,10 @@ that `url`; never guess a route and never send a repository link in its place.
179
184
  | `qawolf install browsers` | local | Install Playwright browsers used by the project's web flows |
180
185
  | `qawolf install clear` | local | Remove the managed runtime cache (all installed runtime versions) |
181
186
  | `qawolf investigation get` | read | Read what the QA Wolf AI investigating a run has concluded: one finding per cause of its failures, with the question waiting for a person and any answer or dispute the investigation hasn't acted on yet. A run that automatic investigation does not cover answers status "not-enabled". |
187
+ | `qawolf investigation question find` | read | 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. |
182
188
  | `qawolf issue addFlows` | write | Add flows to a coverage request owned by the caller's team. Flows already covered stay covered. Bug reports and blockers link to flows through the runs that reproduce them; use run.diagnose to record one. |
183
189
  | `qawolf issue create` | write | Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. A user can create a blocker only when they can see the workspace's blockers; a team or organization API key credits it to the workspace's automation user. Link its failed flows afterwards with run.diagnose. |
190
+ | `qawolf issue decideSuggestion` | write | 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. |
184
191
  | `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
185
192
  | `qawolf issue get` | read | Get an issue by id. |
186
193
  | `qawolf issue listActivity` | read | List an issue's activity, oldest first: creation, status and priority changes, and the flows that started or stopped reproducing it. Use it to measure time to fix or to find issues that came back. |
@@ -189,6 +196,7 @@ that `url`; never guess a route and never send a repository link in its place.
189
196
  | `qawolf legacyTrigger find` | read | List a workspace's legacy per-environment triggers; trigger.find lists the current ones. For migration only; it goes when legacy triggers go. adaptiveFlowSelection becomes a generativeSuite action, which takes no tags. |
190
197
  | `qawolf legacyTrigger pause` | write | Pause one legacy trigger, the older per-environment kind, so it stops firing; use trigger.pause for a current one. Its copies in pull request environments pause too. For migration only; it goes when legacy triggers go. |
191
198
  | `qawolf legacyTrigger resume` | write | Resume one legacy trigger, the older per-environment kind; use trigger.resume for a current one. Its copies in pull request environments resume too, and a scheduled one jumps to the next upcoming slot even if it was not paused. For migration only; it goes when legacy triggers go. |
199
+ | `qawolf mcpServer connect` | write | 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. |
192
200
  | `qawolf promotion find` | read | List environment promotions, newest first. A promotion moves the flow changes made in a head environment into its base environment. Filter by status conflicted to find the promotions whose conflicts still need a resolution. |
193
201
  | `qawolf promotion get` | read | Read one environment promotion: its status, the conflicting paths and commit hashes while it is conflicted or resolving, the commit it landed when promoted, and the AI task resolving it. Poll it after environment.promote to learn how the promotion settled. It does not serve file contents; a resolver reads both branches from the flow code repository. |
194
202
  | `qawolf promotion resolve` | write | Submit the resolution of a conflicted promotion: the full resolved contents of every conflicting path to keep, and every conflicting path to delete. Together they must cover exactly the paths in the promotion's conflict, and both commit hashes must match the conflict's; if a branch moved since, the call is refused as stale-conflict and promotion.get has the current conflict. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied. |
@@ -192,6 +192,21 @@ Every documented field of the `run.get` response. `[]` marks an array, so
192
192
  - `supersededBy.runId` — The id of the run.
193
193
  - `supersededBy.url` — Absolute URL of the replacement run's page.
194
194
  - `blockingBugCount` — 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.
195
+ - `builds` — The builds the run installs, one per app and platform. Empty when the run has none.
196
+ - `builds[].appId` — The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`.
197
+ - `builds[].appName` — The app's display name, when the file names one.
198
+ - `builds[].branch` — The branch the uploader said the build came from.
199
+ - `builds[].buildNumber` — versionCode (Android) or CFBundleVersion (iOS), when the file has one.
200
+ - `builds[].commitSha` — The commit the uploader said the build came from.
201
+ - `builds[].createdAt` — When the build was created.
202
+ - `builds[].deletedAt` — When the build was deleted. Runs never install it after.
203
+ - `builds[].environmentId` — 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.
204
+ - `builds[].fileName` — The uploaded file's name.
205
+ - `builds[].id` — The id of the build, from build.requestUpload.
206
+ - `builds[].platform` — One of: android, ios
207
+ - `builds[].sizeBytes` — The file's size in bytes.
208
+ - `builds[].version` — versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.
209
+ - `builds[].url` — Absolute URL of the team's Builds page.
195
210
  - `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
196
211
  - `flows[].attempts` — The flow's finished execution attempts, oldest first, including manual Wolf Browser attempts. Present once at least one attempt has finished, so a flow that passed after retries also lists its failed attempts. Artifact URLs appear only on attempts that reached a verdict, and on a manual attempt only when its Wolf Browser run kept them. They stay valid for at least a day (call run.get again for fresh ones), and can return 404 when the attempt did not produce that artifact.
197
212
  - `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.