@qawolf/cli 2.5.0 → 2.7.0

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