@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.
@@ -7110,6 +7110,7 @@ var agentReplySchema = object({
7110
7110
 
7111
7111
  // node_modules/@qawolf/api-contracts/dist/v1/agent/wait.js
7112
7112
  var maxAgentWaitSeconds = 45;
7113
+ var maxAgentWaitSecondsWithProgress = 170;
7113
7114
  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.');
7114
7115
 
7115
7116
  // node_modules/@qawolf/api-contracts/dist/v1/run/summary.js
@@ -7142,6 +7143,54 @@ var makeRunSummaryFields = (ids) => ({
7142
7143
  }).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.")
7143
7144
  });
7144
7145
 
7146
+ // node_modules/@qawolf/api-contracts/dist/v1/activity/wait.js
7147
+ var maxActivityWaitItems = 50;
7148
+ var makeActivityWaitContract = (ids) => {
7149
+ const cursors = record(string2().min(1), string2().min(1));
7150
+ const runIds = array(ids.run);
7151
+ const sessionIds = array(ids.chatSession);
7152
+ const input = object({
7153
+ 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."),
7154
+ 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.`),
7155
+ sessionIds: sessionIds.max(maxActivityWaitItems).optional().describe("The Tester sessions you are waiting on, as agent.send answered with."),
7156
+ 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.`)
7157
+ });
7158
+ const output = object({
7159
+ 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."),
7160
+ runs: array(object({
7161
+ finished: boolean2().describe("True once the status is passed, failed, canceled, superseded or not-found. A finished run never changes again."),
7162
+ runId: ids.run.describe("The run id you sent."),
7163
+ 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.`),
7164
+ url: string2().optional().describe("Absolute URL of the run page. Absent while the run is still being created, and when it is not found.")
7165
+ })).describe("Every run you sent, in the order you sent them."),
7166
+ sessions: array(object({
7167
+ nextCursor: string2().min(1).describe("Send back under this session's id in cursors to read only what follows."),
7168
+ 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."),
7169
+ sessionId: ids.chatSession,
7170
+ 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.')
7171
+ })).describe("Every session you sent, in the order you sent them."),
7172
+ waitSeconds: number2().int().describe("The hold this call was allowed, in seconds, after clamping."),
7173
+ 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.')
7174
+ });
7175
+ return {
7176
+ annotationJustifications: {
7177
+ destructiveHint: "Does not cancel work, stop runs or edit tests.",
7178
+ openWorldHint: "Reads QA Wolf sessions and runs without posting to external services.",
7179
+ readOnlyHint: "Retrieves session replies and statuses and run statuses without sending work."
7180
+ },
7181
+ annotations: {
7182
+ destructiveHint: false,
7183
+ openWorldHint: false,
7184
+ readOnlyHint: true
7185
+ },
7186
+ 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.`,
7187
+ input,
7188
+ kind: "read",
7189
+ name: "activity.wait",
7190
+ output
7191
+ };
7192
+ };
7193
+
7145
7194
  // node_modules/@qawolf/api-contracts/dist/v1/deployment/didNotRunReason.js
7146
7195
  var didNotRunReasonSchema = _enum([
7147
7196
  "billing-prevented",
@@ -7365,6 +7414,16 @@ var defaultIdSchemas = {
7365
7414
  };
7366
7415
  var workspaceForEnvironmentRef = (workspace) => workspace.optional().describe("The workspace the environment belongs to, which an alias resolves in. Read it from whoami.");
7367
7416
 
7417
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/files.js
7418
+ var maxAttachedFilesPerRequest = 10;
7419
+ var attachedFilePathsSchema = array(teamStoragePathSchema).min(1).max(maxAttachedFilesPerRequest).refine((filePaths) => new Set(filePaths).size === filePaths.length, "filePaths must be unique");
7420
+ 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.";
7421
+ var issueFileSchema = object({
7422
+ fileId: string2().describe("The id of the attached file."),
7423
+ name: string2().describe("The file's name, taken from the last segment of the path it was attached from."),
7424
+ sizeBytes: number2().int().nonnegative()
7425
+ });
7426
+
7368
7427
  // node_modules/@qawolf/api-contracts/dist/v1/build/resource.js
7369
7428
  var buildPlatformSchema = _enum(["android", "ios"]).describe("The platform the build runs on, read from its file type.");
7370
7429
  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.");
@@ -7519,6 +7578,9 @@ var makeListScreenshotComparisonsContract = (ids) => {
7519
7578
  };
7520
7579
  };
7521
7580
 
7581
+ // node_modules/@qawolf/api-contracts/dist/v1/run/wait.js
7582
+ 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.`);
7583
+
7522
7584
  // node_modules/@qawolf/api-contracts/dist/v1/runner/actionSequence.js
7523
7585
  var maxActionsPerRequest = 10;
7524
7586
  var screenshotModes = ["none", "final", "each"];
@@ -8307,6 +8369,13 @@ var runSelectionSchema = object({
8307
8369
  error: "A selection's startLine must not be after its endLine.",
8308
8370
  path: ["startLine"]
8309
8371
  });
8372
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatFields.js
8373
+ var triggerScheduleRepeatFields = {
8374
+ 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."),
8375
+ 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."),
8376
+ 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.')
8377
+ };
8378
+
8310
8379
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configuration.js
8311
8380
  var isTimezone = (value) => {
8312
8381
  try {
@@ -8316,7 +8385,7 @@ var isTimezone = (value) => {
8316
8385
  return false;
8317
8386
  }
8318
8387
  };
8319
- var triggerCadenceSchema = _enum(["hourly", "daily", "weekly"]).describe("How often the schedule fires.");
8388
+ var triggerCadenceSchema = _enum(["hourly", "daily", "weekly", "monthly"]).describe("How often the schedule fires.");
8320
8389
  var triggerDayOfWeekSchema = _enum([
8321
8390
  "monday",
8322
8391
  "tuesday",
@@ -8344,11 +8413,74 @@ var makeTriggerScheduleFields = (ids) => ({
8344
8413
  message: "Expected each day to be named at most once."
8345
8414
  }).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."),
8346
8415
  environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
8416
+ ...triggerScheduleRepeatFields,
8347
8417
  minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
8348
- 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.'),
8418
+ 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.'),
8349
8419
  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.")
8350
8420
  });
8351
8421
 
8422
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatRules.js
8423
+ var hourlyEveryValues = [1, 2, 3, 4, 6, 8, 12];
8424
+ var maxEvery = {
8425
+ daily: 31,
8426
+ monthly: 12,
8427
+ weekly: 12
8428
+ };
8429
+ var dayOfWeekNames = [
8430
+ "sunday",
8431
+ "monday",
8432
+ "tuesday",
8433
+ "wednesday",
8434
+ "thursday",
8435
+ "friday",
8436
+ "saturday"
8437
+ ];
8438
+ var calendarDayOf = (startDate) => {
8439
+ const date = new Date(`${startDate}T00:00:00Z`);
8440
+ return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(startDate) ? date : undefined;
8441
+ };
8442
+ var everyIssue = (value, every) => {
8443
+ if (value.cadence === "hourly") {
8444
+ return hourlyEveryValues.includes(every) ? undefined : "every must divide a day evenly when cadence is hourly: 1, 2, 3, 4, 6, 8 or 12.";
8445
+ }
8446
+ const max = maxEvery[value.cadence];
8447
+ return every > max ? `every is at most ${max} when cadence is ${value.cadence}.` : undefined;
8448
+ };
8449
+ var startDateIssue = (value, startDate) => {
8450
+ const day = calendarDayOf(startDate);
8451
+ if (day === undefined)
8452
+ return "startDate must be a real calendar date.";
8453
+ if (value.cadence === "weekly" && value.dayOfWeek !== undefined && dayOfWeekNames[day.getUTCDay()] !== value.dayOfWeek)
8454
+ return "startDate must fall on dayOfWeek.";
8455
+ if (value.cadence === "monthly" && value.dayOfMonth !== undefined && day.getUTCDate() !== value.dayOfMonth)
8456
+ return "startDate must fall on dayOfMonth.";
8457
+ return;
8458
+ };
8459
+ var checkScheduleRepeat = (value, ctx) => {
8460
+ const every = value.every ?? 1;
8461
+ const issue = (message, field) => ctx.addIssue({ code: "custom", message, path: [field] });
8462
+ const everyMessage = everyIssue(value, every);
8463
+ if (everyMessage !== undefined)
8464
+ issue(everyMessage, "every");
8465
+ if (value.cadence === "hourly")
8466
+ return;
8467
+ if (every > 1 && value.daysOfWeek !== undefined)
8468
+ issue("daysOfWeek applies only when every is 1.", "daysOfWeek");
8469
+ if (every > 1 && value.startDate === undefined) {
8470
+ issue("startDate is required when every is more than 1.", "startDate");
8471
+ return;
8472
+ }
8473
+ if (value.startDate === undefined)
8474
+ return;
8475
+ if (every === 1) {
8476
+ issue("startDate applies only when every is more than 1.", "startDate");
8477
+ return;
8478
+ }
8479
+ const startDateMessage = startDateIssue(value, value.startDate);
8480
+ if (startDateMessage !== undefined)
8481
+ issue(startDateMessage, "startDate");
8482
+ };
8483
+
8352
8484
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
8353
8485
  var checkAction = (action, ctx) => {
8354
8486
  const namesFlows = action.flowIds.length + action.tagNames.length > 0;
@@ -8380,24 +8512,32 @@ var checkAction = (action, ctx) => {
8380
8512
  var requiredScheduleFields = {
8381
8513
  daily: ["timeOfDay", "timezoneId"],
8382
8514
  hourly: ["timezoneId"],
8515
+ monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
8383
8516
  weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
8384
8517
  };
8385
8518
  var optionalScheduleFields = {
8386
- daily: ["daysOfWeek"],
8387
- hourly: ["daysOfWeek", "minuteOfHour"],
8388
- weekly: []
8519
+ daily: ["daysOfWeek", "every", "startDate"],
8520
+ hourly: ["daysOfWeek", "every", "minuteOfHour"],
8521
+ monthly: ["every", "startDate"],
8522
+ weekly: ["every", "startDate"]
8389
8523
  };
8390
8524
  var cadencesUsingField = {
8525
+ dayOfMonth: "a monthly cadence",
8391
8526
  dayOfWeek: "a weekly cadence",
8392
8527
  daysOfWeek: "an hourly or daily cadence",
8528
+ every: "any cadence",
8393
8529
  minuteOfHour: "an hourly cadence",
8394
- timeOfDay: "a daily or weekly cadence",
8395
- timezoneId: "an hourly, daily or weekly cadence"
8530
+ startDate: "a daily, weekly or monthly cadence",
8531
+ timeOfDay: "a daily, weekly or monthly cadence",
8532
+ timezoneId: "an hourly, daily, weekly or monthly cadence"
8396
8533
  };
8397
8534
  var scheduleFields = [
8535
+ "dayOfMonth",
8398
8536
  "dayOfWeek",
8399
8537
  "daysOfWeek",
8538
+ "every",
8400
8539
  "minuteOfHour",
8540
+ "startDate",
8401
8541
  "timeOfDay",
8402
8542
  "timezoneId"
8403
8543
  ];
@@ -8427,6 +8567,7 @@ var checkScheduleFields = (value, ctx) => {
8427
8567
  };
8428
8568
  var checkSchedule = (value, ctx) => {
8429
8569
  checkScheduleFields(value, ctx);
8570
+ checkScheduleRepeat(value, ctx);
8430
8571
  if (value.action.kind === "generativeSuite") {
8431
8572
  ctx.addIssue({
8432
8573
  code: "custom",
@@ -8705,7 +8846,7 @@ var makeAgentGetContract = (ids) => {
8705
8846
  const input = object({
8706
8847
  cursor: string2().min(1).optional().describe("Opaque cursor copied from this same session's previous nextCursor. Omit to read from its first reply."),
8707
8848
  sessionId: ids.chatSession.describe("The id agent.send answered with."),
8708
- 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.`)
8849
+ 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.`)
8709
8850
  });
8710
8851
  const output = resource({
8711
8852
  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."),
@@ -8728,7 +8869,7 @@ var makeAgentGetContract = (ids) => {
8728
8869
  openWorldHint: false,
8729
8870
  readOnlyHint: true
8730
8871
  },
8731
- 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.',
8872
+ 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.`,
8732
8873
  input,
8733
8874
  kind: "read",
8734
8875
  name: "agent.get",
@@ -8980,6 +9121,36 @@ var makeListBuildsContract = (ids) => {
8980
9121
  };
8981
9122
  };
8982
9123
 
9124
+ // node_modules/@qawolf/api-contracts/dist/v1/build/requestDownload.js
9125
+ var makeRequestBuildDownloadContract = (ids) => {
9126
+ const input = object({
9127
+ buildId: buildIdSchema,
9128
+ workspaceId: ids.workspace.optional().describe("The workspace of the build. Required when authenticating with an organization or user API key.")
9129
+ });
9130
+ const output = object({
9131
+ expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
9132
+ fileName: string2().describe("The name of the build's file."),
9133
+ readUrl: string2().describe('Fetch the build\'s file from here, for example `curl -o app.apk "<readUrl>"`.')
9134
+ });
9135
+ return {
9136
+ annotationJustifications: {
9137
+ destructiveHint: "Does not change the build or its file.",
9138
+ openWorldHint: "Access is limited to the build files of the authorized workspace.",
9139
+ readOnlyHint: "Returns an expiring read URL for a build's file."
9140
+ },
9141
+ annotations: {
9142
+ destructiveHint: false,
9143
+ openWorldHint: false,
9144
+ readOnlyHint: true
9145
+ },
9146
+ 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.",
9147
+ input,
9148
+ kind: "read",
9149
+ name: "build.requestDownload",
9150
+ output
9151
+ };
9152
+ };
9153
+
8983
9154
  // node_modules/@qawolf/api-contracts/dist/v1/build/requestUpload.js
8984
9155
  var maxBuildFileBytes = 500 * 1024 * 1024;
8985
9156
  var makeRequestBuildUploadContract = (ids) => {
@@ -9020,6 +9191,7 @@ var makeBuildContracts = (ids) => ({
9020
9191
  delete: makeDeleteBuildContract(ids),
9021
9192
  get: makeGetBuildContract(ids),
9022
9193
  list: makeListBuildsContract(ids),
9194
+ requestDownload: makeRequestBuildDownloadContract(ids),
9023
9195
  requestUpload: makeRequestBuildUploadContract(ids)
9024
9196
  });
9025
9197
 
@@ -9627,6 +9799,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
9627
9799
  });
9628
9800
  const output = object({
9629
9801
  missingNames: array(string2()).describe("Requested names the environment does not have, sorted alphabetically."),
9802
+ 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."),
9630
9803
  variables: array(object({
9631
9804
  name: string2().describe("The stored variable name."),
9632
9805
  value: string2().describe("The variable's secret value. Handle as a secret.")
@@ -9643,7 +9816,7 @@ var makeGetEnvironmentVariableContract = (ids) => {
9643
9816
  openWorldHint: false,
9644
9817
  readOnlyHint: true
9645
9818
  },
9646
- 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.",
9819
+ 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.",
9647
9820
  input,
9648
9821
  kind: "read",
9649
9822
  name: "environment.getVariable",
@@ -10056,13 +10229,7 @@ var makeUpdateFlowContract = (ids) => {
10056
10229
  };
10057
10230
 
10058
10231
  // node_modules/@qawolf/api-contracts/dist/v1/issue/index.js
10059
- var issuePrioritySchema = _enum([
10060
- "unprioritized",
10061
- "low",
10062
- "medium",
10063
- "high",
10064
- "urgent"
10065
- ]);
10232
+ 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.");
10066
10233
  var issueStatusSchema = _enum([
10067
10234
  "backlog",
10068
10235
  "pending",
@@ -10083,6 +10250,7 @@ var makeIssueResourceSchema = (ids) => resource({
10083
10250
  coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
10084
10251
  createdAt: exports_coerce.date().describe("When the issue was created."),
10085
10252
  description: string2().describe("The issue description in Markdown."),
10253
+ files: array(issueFileSchema).default([]).describe("Files attached to a bug report, oldest first. Always empty on blockers and coverage requests."),
10086
10254
  issueId: ids.issue,
10087
10255
  name: string2(),
10088
10256
  number: number2().int(),
@@ -10261,6 +10429,51 @@ var makeGetInvestigationContract = (ids) => {
10261
10429
  };
10262
10430
  };
10263
10431
 
10432
+ // node_modules/@qawolf/api-contracts/dist/v1/investigation/question/answer.js
10433
+ var maxAnswersPerCall = 50;
10434
+ var findingIdSchema = string2().min(1).max(80);
10435
+ var findingIdsOf = ({ answers = {}, replies = {} }) => [
10436
+ ...Object.keys(answers),
10437
+ ...Object.keys(replies)
10438
+ ];
10439
+ var makeAnswerInvestigationQuestionsContract = (ids) => {
10440
+ const input = object({
10441
+ 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."),
10442
+ 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."),
10443
+ runId: ids.run
10444
+ }).refine((sent) => findingIdsOf(sent).length > 0, {
10445
+ message: "Send at least one answer or reply."
10446
+ }).refine((sent) => findingIdsOf(sent).length <= maxAnswersPerCall, {
10447
+ message: `Send at most ${maxAnswersPerCall} answers and replies in one call.`
10448
+ }).refine((sent) => new Set(findingIdsOf(sent)).size === findingIdsOf(sent).length, { message: "Answer each question once, as an answer or as a reply." });
10449
+ const output = resource({
10450
+ answeredFindingIds: array(string2()).describe("The questions this call answered. The investigation receives the answers and acts on them."),
10451
+ refused: array(object({
10452
+ findingId: string2(),
10453
+ message: string2().describe("Why the answer was not recorded."),
10454
+ reason: string2().describe('Known values: "answer-not-offered", "environment-terminated", "not-asking", "not-found", "response-pending" and "superseded". New values can appear.')
10455
+ })).describe("The answers that were not recorded."),
10456
+ runId: ids.run
10457
+ }, { urlFieldDescription: "The run in the QA Wolf app." });
10458
+ return {
10459
+ annotationJustifications: {
10460
+ 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.",
10461
+ openWorldHint: "A bug report the investigation files from an answer can reach the workspace's configured integrations.",
10462
+ readOnlyHint: "Records answers to the questions of a run's investigation."
10463
+ },
10464
+ annotations: {
10465
+ destructiveHint: true,
10466
+ openWorldHint: true,
10467
+ readOnlyHint: false
10468
+ },
10469
+ 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.",
10470
+ input,
10471
+ kind: "write",
10472
+ name: "investigation.question.answer",
10473
+ output
10474
+ };
10475
+ };
10476
+
10264
10477
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/question/find.js
10265
10478
  var makeFindInvestigationQuestionsContract = (ids) => {
10266
10479
  const input = object({
@@ -10278,7 +10491,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
10278
10491
  headline: string2().optional(),
10279
10492
  question: investigationQuestionSchema,
10280
10493
  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."),
10494
+ sessionId: ids.chatSession.describe("The investigation session. Read what it is doing with agent.get."),
10282
10495
  summary: string2().optional()
10283
10496
  }, { 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
10497
  });
@@ -10293,7 +10506,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
10293
10506
  openWorldHint: false,
10294
10507
  readOnlyHint: true
10295
10508
  },
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.",
10509
+ 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.",
10297
10510
  input,
10298
10511
  kind: "read",
10299
10512
  name: "investigation.question.find",
@@ -10303,6 +10516,7 @@ var makeFindInvestigationQuestionsContract = (ids) => {
10303
10516
 
10304
10517
  // node_modules/@qawolf/api-contracts/dist/v1/investigation/question/index.js
10305
10518
  var makeInvestigationQuestionContracts = (ids) => ({
10519
+ answer: makeAnswerInvestigationQuestionsContract(ids),
10306
10520
  find: makeFindInvestigationQuestionsContract(ids)
10307
10521
  });
10308
10522
 
@@ -10340,17 +10554,95 @@ var makeAddFlowsToIssueContract = (ids) => {
10340
10554
  };
10341
10555
  };
10342
10556
 
10557
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/attachFiles.js
10558
+ var makeAttachFilesToIssueContract = (ids) => {
10559
+ const input = object({
10560
+ filePaths: attachedFilePathsSchema.describe(attachedFilePathsDescription),
10561
+ issueId: ids.issue
10562
+ });
10563
+ const output = object({
10564
+ issue: makeIssueResourceSchema(ids)
10565
+ });
10566
+ return {
10567
+ annotationJustifications: {
10568
+ destructiveHint: "Adds files to the bug report without removing or replacing the ones already attached.",
10569
+ openWorldHint: "Copies files within QA Wolf storage without publishing anything outside QA Wolf.",
10570
+ readOnlyHint: "Copies files from the team's storage and attaches the copies to a bug report."
10571
+ },
10572
+ annotations: {
10573
+ destructiveHint: false,
10574
+ openWorldHint: false,
10575
+ readOnlyHint: false
10576
+ },
10577
+ 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.",
10578
+ input,
10579
+ kind: "write",
10580
+ name: "issue.attachFiles",
10581
+ output
10582
+ };
10583
+ };
10584
+
10585
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/commentResource.js
10586
+ var issueCommentAuthorSchema = discriminatedUnion("type", [
10587
+ object({
10588
+ email: string2(),
10589
+ name: string2().optional().describe("Absent when the person has not set a name."),
10590
+ type: literal("user")
10591
+ }),
10592
+ object({ type: literal("former-user") }),
10593
+ object({ type: literal("team-api-key") }),
10594
+ object({ type: literal("system") })
10595
+ ]).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`).");
10596
+ var makeIssueCommentResourceSchema = (ids) => resource({
10597
+ author: issueCommentAuthorSchema,
10598
+ body: string2().describe("The comment in GitHub-flavored Markdown."),
10599
+ commentId: string2().describe("The id of the comment."),
10600
+ createdAt: exports_coerce.date().describe("When the comment was written."),
10601
+ issueId: ids.issue.describe("The issue the comment is on."),
10602
+ viaQaWolfAi: boolean2().describe("Whether the author wrote the comment through QA Wolf AI.")
10603
+ }, { urlFieldDescription: "Absolute URL of the issue page." });
10604
+
10605
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/comment.js
10606
+ var maxCommentLength = 1e4;
10607
+ var makeCommentOnIssueContract = (ids) => {
10608
+ const input = object({
10609
+ body: string2().trim().min(1).max(maxCommentLength).describe("The comment in GitHub-flavored Markdown."),
10610
+ issueId: ids.issue.describe("The bug report, blocker, or coverage request to comment on.")
10611
+ });
10612
+ const output = object({
10613
+ comment: makeIssueCommentResourceSchema(ids)
10614
+ });
10615
+ return {
10616
+ annotationJustifications: {
10617
+ destructiveHint: "Adds a comment without removing or changing anything else on the issue.",
10618
+ 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.",
10619
+ readOnlyHint: "Records a comment on the issue."
10620
+ },
10621
+ annotations: {
10622
+ destructiveHint: false,
10623
+ openWorldHint: false,
10624
+ readOnlyHint: false
10625
+ },
10626
+ 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.",
10627
+ input,
10628
+ kind: "write",
10629
+ name: "issue.comment",
10630
+ output
10631
+ };
10632
+ };
10633
+
10343
10634
  // node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
10344
10635
  var makeCreateIssueContract = (ids) => {
10345
10636
  const commonFields = {
10346
10637
  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."),
10347
10638
  name: string2().trim().min(1).max(255),
10348
- priority: issuePrioritySchema.optional().describe('Defaults to "unprioritized" for bug reports and coverage requests.'),
10639
+ priority: issuePrioritySchema.optional().describe(`${issuePrioritySchema.description} Defaults to "unprioritized" for bug reports and coverage requests.`),
10349
10640
  workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
10350
10641
  };
10351
10642
  const input = discriminatedUnion("type", [
10352
10643
  object({
10353
10644
  ...commonFields,
10645
+ filePaths: attachedFilePathsSchema.optional().describe(attachedFilePathsDescription),
10354
10646
  type: literal("bug")
10355
10647
  }),
10356
10648
  object({
@@ -10482,6 +10774,35 @@ var makeListIssueActivityContract = (ids) => {
10482
10774
  };
10483
10775
  };
10484
10776
 
10777
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/listComments.js
10778
+ var makeListIssueCommentsContract = (ids) => {
10779
+ const input = object({
10780
+ issueId: ids.issue.describe("The bug report, blocker, or coverage request whose comments to list."),
10781
+ ...makePaginationInputFields({ defaultLimit: 50, maxLimit: 200 })
10782
+ });
10783
+ const output = object({
10784
+ comments: array(makeIssueCommentResourceSchema(ids)).describe("The issue's comments, oldest first."),
10785
+ nextCursor: nextCursorSchema
10786
+ });
10787
+ return {
10788
+ annotationJustifications: {
10789
+ destructiveHint: "Does not edit the issue or its comments.",
10790
+ openWorldHint: "Reads QA Wolf comments without reading or changing linked trackers.",
10791
+ readOnlyHint: "Lists the comments on one issue."
10792
+ },
10793
+ annotations: {
10794
+ destructiveHint: false,
10795
+ openWorldHint: false,
10796
+ readOnlyHint: true
10797
+ },
10798
+ description: "List the comments on a bug report, blocker (issue type `maintenance`), or coverage request, oldest first, with who wrote each one.",
10799
+ input,
10800
+ kind: "read",
10801
+ name: "issue.listComments",
10802
+ output
10803
+ };
10804
+ };
10805
+
10485
10806
  // node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
10486
10807
  var makeRemoveFlowsFromIssueContract = (ids) => {
10487
10808
  const input = object({
@@ -10546,6 +10867,21 @@ var makeUpdateIssueContract = (ids) => {
10546
10867
  };
10547
10868
  };
10548
10869
 
10870
+ // node_modules/@qawolf/api-contracts/dist/v1/issue/contracts.js
10871
+ var makeIssueContracts = (ids) => ({
10872
+ addFlows: makeAddFlowsToIssueContract(ids),
10873
+ attachFiles: makeAttachFilesToIssueContract(ids),
10874
+ comment: makeCommentOnIssueContract(ids),
10875
+ create: makeCreateIssueContract(ids),
10876
+ decideSuggestion: makeDecideSuggestionContract(ids),
10877
+ find: makeFindIssuesContract(ids),
10878
+ get: makeGetIssueContract(ids),
10879
+ listActivity: makeListIssueActivityContract(ids),
10880
+ listComments: makeListIssueCommentsContract(ids),
10881
+ removeFlows: makeRemoveFlowsFromIssueContract(ids),
10882
+ update: makeUpdateIssueContract(ids)
10883
+ });
10884
+
10549
10885
  // node_modules/@qawolf/api-contracts/dist/v1/legacyTrigger/resource.js
10550
10886
  var namedIdentity = object({ id: string2(), name: string2() });
10551
10887
  var branchScope = union([
@@ -10695,6 +11031,7 @@ var makeConnectMcpServerContract = (ids) => {
10695
11031
  });
10696
11032
  const output = object({
10697
11033
  authorizationUrl: string2().url().describe("The server's sign-in page. Show it to the user: the connection is ready once they approve access there."),
11034
+ 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."),
10698
11035
  serverName: string2().describe("The catalog name of the server.")
10699
11036
  });
10700
11037
  return {
@@ -10899,12 +11236,46 @@ var makeFlowFailureSchema = (ids) => {
10899
11236
  });
10900
11237
  };
10901
11238
 
11239
+ // node_modules/@qawolf/api-contracts/dist/v1/run/versions.js
11240
+ var extensibleValue = (values, meanings) => string2().describe(`One of ${values.join(", ")}; newer servers may add values, so ignore any you don't know. ${meanings}`);
11241
+ var attemptCount = number2().int().positive().describe("How many attempts reported it.");
11242
+ var runBuildVersionSchema = object({
11243
+ appId: string2().describe("The package name (Android) or bundle ID (iOS) of the app."),
11244
+ expected: object({
11245
+ buildId: buildIdSchema,
11246
+ version: string2().optional()
11247
+ }).optional().describe("The run's build of this app. Absent for an app it got none of."),
11248
+ 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."),
11249
+ observed: array(object({
11250
+ attempts: attemptCount,
11251
+ buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
11252
+ version: string2().optional()
11253
+ })).describe("What attempts installed, one entry per build or version."),
11254
+ platform: buildPlatformSchema,
11255
+ unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
11256
+ 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.")
11257
+ });
11258
+ var runSiteVersionSchema = object({
11259
+ expected: object({
11260
+ from: extensibleValue(["deployment", "latestDeployment"], "deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run."),
11261
+ version: string2().describe("The deployed commit.")
11262
+ }).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."),
11263
+ observed: array(object({
11264
+ attempts: attemptCount,
11265
+ source: extensibleValue(["header", "meta", "versionPath", "frameworkBuildId", "fingerprint"], "Where the attempt read the version."),
11266
+ version: string2()
11267
+ })).describe("What attempts saw, one entry per version and source."),
11268
+ origin: string2().describe("The site origin the attempts visited."),
11269
+ 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.")
11270
+ });
11271
+
10902
11272
  // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
10903
11273
  var makeGetRunContract = (ids) => {
10904
11274
  const flowStatus = _enum(publicRunStatusValues);
10905
11275
  const input = object({
10906
11276
  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."),
10907
- runId: ids.run
11277
+ runId: ids.run,
11278
+ 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.`)
10908
11279
  });
10909
11280
  const attempts = makeFlowAttemptsSchema(ids);
10910
11281
  const failedFlow = object({
@@ -10925,8 +11296,12 @@ var makeGetRunContract = (ids) => {
10925
11296
  ...makeRunSummaryFields(ids),
10926
11297
  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
11298
  builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
11299
+ 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."),
10928
11300
  flows,
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.")
11301
+ 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."),
11302
+ siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
11303
+ waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
11304
+ wokeOn: runWakeReasonSchema.optional()
10930
11305
  }, { urlFieldDescription: "Absolute URL of the run page." });
10931
11306
  return {
10932
11307
  annotationJustifications: {
@@ -10939,7 +11314,7 @@ var makeGetRunContract = (ids) => {
10939
11314
  openWorldHint: false,
10940
11315
  readOnlyHint: true
10941
11316
  },
10942
- description: "Get a run's status, per-flow results, links, and how many of its bugs are blocking.",
11317
+ 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.`,
10943
11318
  input,
10944
11319
  kind: "read",
10945
11320
  name: "run.get",
@@ -11276,7 +11651,7 @@ var makeLaunchRunnerContract = (ids) => {
11276
11651
  openWorldHint: true,
11277
11652
  readOnlyHint: false
11278
11653
  },
11279
- 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.",
11654
+ 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.",
11280
11655
  input,
11281
11656
  kind: "write",
11282
11657
  name: "runner.launch",
@@ -11424,17 +11799,14 @@ var unchangedFilesSchema = record(string2(), string2().min(1)).superRefine((hash
11424
11799
  var makeRunFlowOnRunnerContract = (ids) => {
11425
11800
  const input = object({
11426
11801
  entryPointPath: runFilePathSchema.describe("Path of the flow file to run, as it appears in `files`."),
11427
- env: runEnvironmentSchema.optional().describe("Environment variables to make available to the run."),
11428
- 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."),
11802
+ 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."),
11803
+ 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."),
11429
11804
  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."),
11430
11805
  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`."),
11431
11806
  id: runnerIdSchema.describe("Id of the runner to run the flow on."),
11432
11807
  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."),
11433
11808
  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."),
11434
11809
  workspaceId: ids.workspace.optional().describe(runnerWorkspaceIdDescription)
11435
- }).refine((request) => request.env === undefined || request.environmentId === undefined, {
11436
- 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.",
11437
- path: ["environmentId"]
11438
11810
  }).refine((request) => Object.hasOwn(request.files, request.entryPointPath), {
11439
11811
  error: "The entry point must be one of the files.",
11440
11812
  path: ["files"]
@@ -11679,6 +12051,9 @@ var makeContractsV1 = (ids) => {
11679
12051
  runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
11680
12052
  };
11681
12053
  return {
12054
+ activity: {
12055
+ wait: makeActivityWaitContract(resolvedIds)
12056
+ },
11682
12057
  agent: {
11683
12058
  get: makeAgentGetContract(resolvedIds),
11684
12059
  send: makeAgentSendContract(resolvedIds)
@@ -11721,16 +12096,7 @@ var makeContractsV1 = (ids) => {
11721
12096
  update: makeUpdateFlowContract(resolvedIds)
11722
12097
  },
11723
12098
  investigation: makeInvestigationContracts(resolvedIds),
11724
- issue: {
11725
- addFlows: makeAddFlowsToIssueContract(resolvedIds),
11726
- create: makeCreateIssueContract(resolvedIds),
11727
- decideSuggestion: makeDecideSuggestionContract(resolvedIds),
11728
- find: makeFindIssuesContract(resolvedIds),
11729
- get: makeGetIssueContract(resolvedIds),
11730
- listActivity: makeListIssueActivityContract(resolvedIds),
11731
- removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
11732
- update: makeUpdateIssueContract(resolvedIds)
11733
- },
12099
+ issue: makeIssueContracts(resolvedIds),
11734
12100
  legacyTrigger: makeLegacyTriggerContracts(resolvedIds),
11735
12101
  mcpServer: {
11736
12102
  connect: makeConnectMcpServerContract(resolvedIds)
@@ -16507,4 +16873,4 @@ export {
16507
16873
  createRunnerSdk
16508
16874
  };
16509
16875
 
16510
- //# debugId=F5D9BC086D8A595464756E2164756E21
16876
+ //# debugId=B5473BEAD8EDFE4164756E2164756E21