@unotest/protocol 0.47.0 → 0.49.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/index.d.ts CHANGED
@@ -222,6 +222,11 @@ declare function makeRunId(name: string): string;
222
222
  * to a literal `run` segment — uniqueness still comes from the ts +
223
223
  * random suffix appended by `makeRunId`. */
224
224
  declare function sanitizeRunIdSegment(name: string): string;
225
+ /** Whether `value` has the shape {@link makeRunId} gives — one directory
226
+ * name, nothing that could climb out of a runs root. For an id read from
227
+ * somewhere a suite writes (a collection's journal names its scenarios'
228
+ * runs) before it is ever joined into a path. */
229
+ declare function isRunId(value: string): boolean;
225
230
 
226
231
  /** Epoch millis encoded in a runId, or null when the id does not follow
227
232
  * `makeRunId`'s shape. Callers must handle null rather than guess — an
@@ -430,6 +435,10 @@ interface RunStartedEvent extends RunArtifactBase {
430
435
  runId: RunId;
431
436
  /** Scenario `name` (file stem relative to `e2e/`). */
432
437
  scenario: string;
438
+ /** The `test_*` function this run is, as written in the file. Absent on
439
+ * the run of a FILE that holds several tests (it groups them) and on
440
+ * runs written before 0.49.0. */
441
+ test?: string;
433
442
  }
434
443
  /** Every event of a step carries the browser context it was written in,
435
444
  * once the test has opened a second one (`newContext()`): 0 is the run's
@@ -817,7 +826,25 @@ interface ToolResultEvent extends RunArtifactBase {
817
826
  };
818
827
  }
819
828
  /** Discriminated union of every JSONL event the scenario runner emits. */
820
- type RunArtifact = RunStartedEvent | StepStartedEvent | StepOkEvent | StepFailEvent | StepBlockStartedEvent | StepBlockFinishedEvent | TeardownStartedEvent | TeardownFinishedEvent | TeardownSkippedEvent | NoteEvent | LogEvent | LoopIterationEvent | ScreenshotEvent | DownloadEvent | JudgeVerdictEvent | VisualAssertEvent | FailureBundleWrittenEvent | PausedEvent | ResumedEvent | LocatorPickedEvent | WheelChangedEvent | ProbeResultEvent | ToolCallEvent | ToolResultEvent | RunFinishedEvent;
829
+ type RunArtifact = RunStartedEvent | StepStartedEvent | StepOkEvent | StepFailEvent | StepBlockStartedEvent | StepBlockFinishedEvent | TeardownStartedEvent | TeardownFinishedEvent | TeardownSkippedEvent | NoteEvent | LogEvent | LoopIterationEvent | ScreenshotEvent | DownloadEvent | JudgeVerdictEvent | VisualAssertEvent | FailureBundleWrittenEvent | PausedEvent | ResumedEvent | LocatorPickedEvent | WheelChangedEvent | ProbeResultEvent | ToolCallEvent | ToolResultEvent | FileRunTestStartedEvent | FileRunTestFinishedEvent | RunFinishedEvent;
830
+ /** How one test of a group ended — the line a file run writes for it, and
831
+ * the entry a collection reports for each test of the file it ran. */
832
+ interface TestRunOutcome {
833
+ /** The `test_*` function, as written in the file. */
834
+ test: string;
835
+ testRunId: RunId;
836
+ outcome: RunOutcome;
837
+ /** Set when the test skipped itself; the outcome is then `completed`. */
838
+ skipReason?: string;
839
+ }
840
+ interface FileRunTestStartedEvent extends RunArtifactBase {
841
+ kind: "file-run:test-started";
842
+ test: string;
843
+ testRunId: RunId;
844
+ }
845
+ interface FileRunTestFinishedEvent extends RunArtifactBase, TestRunOutcome {
846
+ kind: "file-run:test-finished";
847
+ }
821
848
  interface CollectionRunStartedEvent extends RunArtifactBase {
822
849
  kind: "collection-run:started";
823
850
  runId: RunId;
@@ -837,6 +864,9 @@ interface CollectionScenarioFinishedEvent extends RunArtifactBase {
837
864
  scenarioRunId: RunId;
838
865
  scenario: string;
839
866
  outcome: RunOutcome;
867
+ /** One entry per test when the scenario file held several: the outcome
868
+ * above is the worst of them. Absent for a one-test file. Since 0.49.0. */
869
+ tests?: TestRunOutcome[];
840
870
  }
841
871
  interface CollectionRunFinishedEvent extends RunArtifactBase {
842
872
  kind: "collection-run:finished";
@@ -849,6 +879,9 @@ interface ScenarioRunRequest {
849
879
  kind: "scenario";
850
880
  /** Scenario `name` — file stem relative to `unotest/e2e/`. */
851
881
  scenario: string;
882
+ /** One `test_*` of the file instead of all of them, by function name.
883
+ * Since 0.49.0. */
884
+ test?: string;
852
885
  /** Run with browser visible (web) / device window visible (mobile).
853
886
  * Adapter maps this to the runner's preferred env / arg. */
854
887
  headed?: boolean;
@@ -900,9 +933,26 @@ type RunRequest = ScenarioRunRequest | CollectionRunRequest | AuthoringRunReques
900
933
  /** All `kind` literals — useful for switch-completeness checks and for
901
934
  * adapter `supportedKinds` lists. */
902
935
  type RunKind = RunRequest["kind"];
936
+ type TestSelection = {
937
+ tests: readonly string[];
938
+ } | {
939
+ refusal: string;
940
+ };
941
+ /** `requested` is the `--test` value: absent plays every entry, a name
942
+ * plays that test — written as the function is, or without `test_`. A
943
+ * name the file does not have is refused with the names it does, so the
944
+ * next try is a copy, not a guess. */
945
+ declare function selectTests(entries: readonly string[], requested: string | undefined, scenario: string): TestSelection;
946
+ /** A run asked for a test its file does not have. The message is the
947
+ * refusal {@link selectTests} words, the same on every surface. */
948
+ declare class UnknownTestError extends Error {
949
+ constructor(refusal: string);
950
+ }
903
951
 
904
- /** Lifecycle stage as inferred by the server when listing runs. */
905
- type RunStatus = "running" | "passed" | "failed" | "aborted" | "interrupted";
952
+ /** Lifecycle stage as inferred by the server when listing runs.
953
+ * `skipped` is a run that finished `completed` after the test skipped
954
+ * itself (`skip(reason)`): it proved nothing, so it is not `passed`. */
955
+ type RunStatus = "running" | "passed" | "skipped" | "failed" | "aborted" | "interrupted";
906
956
  interface RunMeta {
907
957
  runId: RunId;
908
958
  kind: RunKind;
@@ -920,11 +970,18 @@ interface RunMeta {
920
970
  status: RunStatus;
921
971
  /** Terminal outcome from `run:finished`, or null if still running. */
922
972
  outcome: RunOutcome | null;
923
- /** Run-id of the parent collection-run when this is a child scenario
924
- * spawned inside one. Absent for top-level scenarios and for
925
- * collection-runs themselves. Populated by the writer from the
926
- * child's `manifest.json`. */
973
+ /** Why the test skipped itself, from `run:finished`. Present exactly
974
+ * when `status` is `skipped`. */
975
+ skipReason?: string;
976
+ /** Run-id of the group this run belongs to: a collection-run, or the
977
+ * run of a file with several tests. Absent for top-level runs and for
978
+ * collection-runs themselves. Populated from the child's
979
+ * `manifest.json`. */
927
980
  parentRunId?: string;
981
+ /** The `test_*` function this run is, from its manifest. Absent on the
982
+ * run of a file with several tests (it groups them), on collection-runs
983
+ * and on runs written before 0.49.0. */
984
+ test?: string;
928
985
  /** Which test bundle produced this run, from its manifest. Absent for
929
986
  * every local run; on a box it is what tells two runs of the same
930
987
  * scenario apart when the environment moved to another bundle between
@@ -934,8 +991,8 @@ interface RunMeta {
934
991
 
935
992
  /** Bumped when a line's shape changes incompatibly. A file whose header
936
993
  * carries a different version is discarded and rebuilt rather than
937
- * half-parsed. */
938
- declare const RUN_INDEX_SCHEMA_VERSION = 2;
994
+ * half-parsed. 3: `skipped` status — a v2 line filed a skip as passed. */
995
+ declare const RUN_INDEX_SCHEMA_VERSION = 3;
939
996
  /** How many past outcomes a scenario's rolling window keeps. Twelve is
940
997
  * enough to see a flake and small enough that the whole field of them
941
998
  * fits one JSON file. Exported so the fold and everything that renders
@@ -959,6 +1016,9 @@ interface ScenarioLatestEntry {
959
1016
  lastAt: number;
960
1017
  /** Wall-clock of the last run, or null if it never finished. */
961
1018
  lastDurationMs: number | null;
1019
+ /** Why the last run skipped itself. Present exactly when `lastStatus`
1020
+ * is `skipped`, so a tile can say why it is grey without a run read. */
1021
+ lastSkipReason?: string;
962
1022
  /** Up to {@link SCENARIO_RECENT_WINDOW} past outcomes, OLDEST FIRST.
963
1023
  * Answers the one question a single last status cannot: does this
964
1024
  * test flake. Kept here rather than fetched per scenario because the
@@ -971,7 +1031,15 @@ interface ScenarioLatestEntry {
971
1031
  failStreak: number;
972
1032
  /** Start of the current failing streak, or null when not failing. */
973
1033
  failingSince: number | null;
974
- }
1034
+ /** The same state per test, for a file with several `test_*`: keyed by
1035
+ * function name, folded from the file runs' journals and from runs of a
1036
+ * single test (`--test`) once the file is known to hold several. The
1037
+ * fields above are then the FILE's — the last run of it. Absent for a
1038
+ * one-test file. Since 0.49.0. */
1039
+ tests?: Record<string, TestLatestEntry>;
1040
+ }
1041
+ /** A test's own rolling state inside its file's entry. */
1042
+ type TestLatestEntry = Omit<ScenarioLatestEntry, "tests">;
975
1043
  interface ScenariosLatest {
976
1044
  v: number;
977
1045
  scenarios: Record<string, ScenarioLatestEntry>;
@@ -979,17 +1047,310 @@ interface ScenariosLatest {
979
1047
  /** Status values that count as a failure for streak purposes. `aborted`
980
1048
  * is excluded: the user stopped it, the test did not fail. */
981
1049
  declare function isFailingStatus(status: RunStatus): boolean;
1050
+ /** The status a finished run is listed under: a `completed` run that
1051
+ * skipped itself proved nothing, so it is not `passed`. */
1052
+ declare function runStatusOf(outcome: RunOutcome, skipReason: string | undefined): RunStatus;
982
1053
  /** Fold one newer run into a scenario's rolling state. Pure so the live
983
- * path and the rebuild path cannot disagree about what a streak is. */
984
- declare function foldScenarioRun(prev: ScenarioLatestEntry | undefined, run: Pick<RunMeta, "runId" | "status" | "startedAt" | "durationMs">): ScenarioLatestEntry;
1054
+ * path and the rebuild path cannot disagree about what a streak is. A
1055
+ * file's per-test state rides along untouched: the file's own run says
1056
+ * nothing about any one test. */
1057
+ declare function foldScenarioRun(prev: ScenarioLatestEntry | undefined, run: Pick<RunMeta, "runId" | "status" | "startedAt" | "durationMs" | "skipReason">): ScenarioLatestEntry;
1058
+ /** Fold one newer run of `test` into its file's entry, under `tests`. */
1059
+ declare function foldTestRun(entry: ScenarioLatestEntry, test: string, run: Pick<RunMeta, "runId" | "status" | "startedAt" | "durationMs" | "skipReason">): ScenarioLatestEntry;
985
1060
  /** Filename for a scenario's index. `encodeURIComponent` because scenario
986
1061
  * refs carry `/` (`big-table/edit-dialog`) and must not become nested
987
1062
  * directories — and because it is reversible, so the ref can be read
988
1063
  * back off the filename without a side table. */
989
1064
  declare function scenarioIndexFileName(ref: string): string;
1065
+ /** Filename for the index of one test of a file with several: the runs
1066
+ * its file runs played. `@` never appears raw in an encoded ref, so the
1067
+ * name cannot collide with a scenario's own index. */
1068
+ declare function testIndexFileName(ref: string, test: string): string;
990
1069
  /** Inverse of `scenarioIndexFileName`. */
991
1070
  declare function scenarioRefFromFileName(fileName: string): string | null;
992
1071
 
1072
+ /** The variable a box injects an environment's target under — what the
1073
+ * suite's `baseUrl` auto-wires from. */
1074
+ declare const TARGET_ENV_VAR = "APP_BASE_URL";
1075
+ /** The run's id, set by a box on every run it starts. */
1076
+ declare const RUN_ID_ENV = "UNOTEST_RUN_ID";
1077
+ /** The environment a run belongs to: its runs suffix and the overlay the
1078
+ * suite loads. */
1079
+ declare const ENVIRONMENT_ENV = "UNOTEST_ENV";
1080
+ /** `0` tells the runner not to write editor typings. */
1081
+ declare const EDITOR_TYPES_ENV = "UNOTEST_EDITOR_TYPES";
1082
+ /** Set by a lease holder on every child it spawns. A process that sees
1083
+ * it is already covered by someone's slot and must not queue again —
1084
+ * this is the "top-level run" boundary (a collection's scenario
1085
+ * subprocesses). Value: the holder's runId, for diagnostics. */
1086
+ declare const QUEUE_LEASE_ENV = "UNOTEST_QUEUE_LEASE";
1087
+ /** What a box says about a run by setting it on the run's process: which
1088
+ * run, of which environment, from which bundle, who asked, under whose
1089
+ * queue slot, which of its values are secret. An environment's values
1090
+ * are refused under these names, and a run gets them written after the
1091
+ * values — a value spelled like one would otherwise speak for the box
1092
+ * (`UNOTEST_BUNDLE_ID=""` turns a box run into a local one).
1093
+ *
1094
+ * Not every `UNOTEST_*` ({@link isRunnerSetting}): an operator sets the
1095
+ * runner's own settings on an environment on purpose, and a box's browser
1096
+ * policy (`UNOTEST_BROWSER_CHANNEL`) is overridable there by design. */
1097
+ declare const RUN_IDENTITY_ENV_NAMES: readonly string[];
1098
+ declare function isRunIdentityEnvName(name: string): boolean;
1099
+ /** Why such a name is not a value, worded once for the box's refusal and
1100
+ * for the CLI that refuses it before asking. */
1101
+ declare function runIdentityRefusal(names: readonly string[]): string;
1102
+ /** The values an environment hands a run, less any spelled like the
1103
+ * run's identity — one stored before the box refused such names. */
1104
+ declare function withoutRunIdentity(values: Readonly<Record<string, string>>): Record<string, string>;
1105
+ /** Prefix of the runner's own settings (`UNOTEST_HEADED`,
1106
+ * `UNOTEST_LOG_LEVEL`, …). They configure the machine a run happens on,
1107
+ * never the suite, so an environment on a box neither receives them from
1108
+ * `env push` nor is asked for them by a bundle's declared names. One
1109
+ * predicate for both sides: they used to disagree, and a box warned about
1110
+ * names a push could never have sent. */
1111
+ declare const RUNNER_SETTING_PREFIX = "UNOTEST_";
1112
+ declare function isRunnerSetting(name: string): boolean;
1113
+ /** Token-door root, relative to the box origin. The project is decided by
1114
+ * the token (`Authorization: Bearer <token>`), so the path names only the
1115
+ * environment:
1116
+ *
1117
+ * PATCH /api/box/values/<env> merge into the three layers
1118
+ * PUT /api/box/values/<env> replace all three layers
1119
+ * PUT /api/box/values/<env>/target {"value": "https://…"}
1120
+ * DELETE /api/box/values/<env>/target back to the config's
1121
+ * PUT /api/box/values/<env>/variables/<NAME> {"value": "…"}
1122
+ * DELETE /api/box/values/<env>/variables/<NAME>
1123
+ * PUT /api/box/values/<env>/secrets/<NAME> {"value": "…"}
1124
+ * DELETE /api/box/values/<env>/secrets/<NAME>
1125
+ */
1126
+ declare const BOX_VALUES_PATH = "/api/box/values";
1127
+ /** Session-door root: the same operations for a signed-in admin, with the
1128
+ * project spelled out because a session is not scoped to one. Reachable
1129
+ * through the guard only, which stamps the actor; also answers
1130
+ * `GET …/values` with the readable view ({@link BoxEnvValuesView}), and
1131
+ * reveals secrets on request:
1132
+ *
1133
+ * PUT /api/box/envs/<project>/<env>/values the batch,
1134
+ * with `null` for a secret to keep ({@link BoxEnvValuesReplaceRequest})
1135
+ * GET /api/box/envs/<project>/<env>/values/secrets/<NAME>/reveal
1136
+ * GET /api/box/envs/<project>/<env>/values/reveal all secrets
1137
+ */
1138
+ declare const BOX_ENV_VALUES_SEGMENT = "values";
1139
+ /** The verb a reveal path ends with. `reveal` is a legal variable name, so
1140
+ * the verb never sits in a NAME slot: for one secret it hangs BELOW the
1141
+ * name (a name has no children, nothing else can be there), for all of
1142
+ * them it hangs off the values root beside the kind segments, where a
1143
+ * name never appears. Each shape is distinct by segment count and literal
1144
+ * alone — no route has to lean on the HTTP method to tell a secret called
1145
+ * `reveal` from the verb. */
1146
+ declare const BOX_REVEAL_SEGMENT = "reveal";
1147
+ type BoxValueKind = "target" | "variable" | "secret";
1148
+ /** Kind for a path segment, or null for anything else. */
1149
+ declare function boxValueKindOfSegment(segment: string): Exclude<BoxValueKind, "target"> | null;
1150
+ /** `/api/box/values/<env>` — the batch. */
1151
+ declare function boxValuesPath(environment: string): string;
1152
+ /** `/api/box/values/<env>/target` or `/api/box/values/<env>/<kind>/<NAME>`. */
1153
+ declare function boxValuePath(environment: string, kind: BoxValueKind, name?: string): string;
1154
+ /** `/api/box/envs/<project>/<env>/values`. */
1155
+ declare function boxEnvValuesPath(project: string, environment: string): string;
1156
+ /** `/api/box/envs/<project>/<env>/values/target` or `…/values/<kind>/<NAME>`. */
1157
+ declare function boxEnvValuePath(project: string, environment: string, kind: BoxValueKind, name?: string): string;
1158
+ /** `/api/box/envs/<project>/<env>/values/secrets/<NAME>/reveal` — one
1159
+ * secret's value, session door only. */
1160
+ declare function boxEnvSecretRevealPath(project: string, environment: string, name: string): string;
1161
+ /** `/api/box/envs/<project>/<env>/values/reveal` — every secret's value,
1162
+ * session door only. Not under `secrets/` — see {@link BOX_REVEAL_SEGMENT}
1163
+ * for why the verb sits beside the kinds rather than among the names. */
1164
+ declare function boxEnvSecretsRevealPath(project: string, environment: string): string;
1165
+ /** The batch: what the environment should hold from now on. Whole layers,
1166
+ * not a diff — a name absent here is removed from the box. `target`
1167
+ * absent = drop the override, back to the operator's config. What the
1168
+ * admin's page sends; `env push` merges instead
1169
+ * ({@link BoxValuesMergeRequest}). */
1170
+ interface BoxValuesReplaceRequest {
1171
+ target?: string;
1172
+ variables: Record<string, string>;
1173
+ secrets: Record<string, string>;
1174
+ }
1175
+ /** The token-door merge, `PATCH /api/box/values/<env>`: every name in the
1176
+ * batch is set, a name the box holds and the batch does not stays — a
1177
+ * value someone put there with `env set` is not the pusher's to drop
1178
+ * silently. `target` absent keeps the override. A name sent in the other
1179
+ * layer than the box holds it moves there.
1180
+ *
1181
+ * `prune` drops what the batch does not carry, target included — except
1182
+ * runner settings ({@link isRunnerSetting}): a push never sends those, so
1183
+ * their absence from a batch says nothing about whether they are wanted. */
1184
+ interface BoxValuesMergeRequest extends BoxValuesReplaceRequest {
1185
+ prune?: boolean;
1186
+ }
1187
+ /** The session-door batch: the same whole-layer replace, except that a
1188
+ * secret may be sent as `null` — "keep whatever the box holds". The
1189
+ * admin's page never has the values of secrets it did not reveal, and
1190
+ * revealing them all just to send them back would fill the audit log
1191
+ * with looks nobody took. A name absent from `secrets` is still removed;
1192
+ * `null` keeps only a secret that exists (the box decides what a `null`
1193
+ * for an unknown name means). The token door has no such sentinel: a
1194
+ * pusher holds the real values. */
1195
+ interface BoxEnvValuesReplaceRequest extends Omit<BoxValuesReplaceRequest, "secrets"> {
1196
+ secrets: Record<string, string | null>;
1197
+ }
1198
+ interface BoxValueSetRequest {
1199
+ value: string;
1200
+ }
1201
+ /** Null for anything we will not act on. Names are validated here so a
1202
+ * key that could not be a variable never reaches a store; the RESERVED
1203
+ * name ({@link TARGET_ENV_VAR}) is not a parse failure — the box answers
1204
+ * it with its own code, because the fix is different ("send it as the
1205
+ * target", not "fix your JSON"). */
1206
+ declare function parseBoxValuesReplaceRequest(value: unknown): BoxValuesReplaceRequest | null;
1207
+ /** The session-door batch; `null` is a legal secret value, nothing else
1208
+ * beyond {@link parseBoxValuesReplaceRequest} changes. */
1209
+ declare function parseBoxEnvValuesReplaceRequest(value: unknown): BoxEnvValuesReplaceRequest | null;
1210
+ /** The token-door merge: the replace batch plus an optional `prune`. */
1211
+ declare function parseBoxValuesMergeRequest(value: unknown): BoxValuesMergeRequest | null;
1212
+ declare function parseBoxValueSetRequest(value: unknown): BoxValueSetRequest | null;
1213
+ /** Names in a batch that may not be set as a variable or a secret. */
1214
+ declare function reservedBoxValueNames(request: {
1215
+ variables: Record<string, unknown>;
1216
+ secrets: Record<string, unknown>;
1217
+ }): string[];
1218
+ /** The target ({@link TARGET_ENV_VAR}) and the run's identity
1219
+ * ({@link RUN_IDENTITY_ENV_NAMES}): the box sets them itself. */
1220
+ declare function isReservedBoxValueName(name: string): boolean;
1221
+ /** Names per layer; `target` says whether the override is among them. */
1222
+ interface BoxValueNames {
1223
+ target: boolean;
1224
+ variables: string[];
1225
+ secrets: string[];
1226
+ }
1227
+ /** What the environment holds after a batch, by NAME, and what the batch
1228
+ * took away — so the CLI can say "removed STALE_KEY" instead of leaving
1229
+ * the pusher to diff two listings. */
1230
+ interface BoxValuesReplaced {
1231
+ status: "replaced";
1232
+ environment: string;
1233
+ /** Whether a target override is now in place. */
1234
+ target: boolean;
1235
+ variables: string[];
1236
+ secrets: string[];
1237
+ removed: BoxValueNames;
1238
+ }
1239
+ /** What a merge did, by NAME: what the environment holds now, what the
1240
+ * batch set, what it left in place (`kept` — on the box, not in the
1241
+ * batch), what `prune` took away, and the names that changed layer
1242
+ * (`moved.secrets` = was a variable, now a secret). A moved name is in
1243
+ * `set`, never in `removed`: it is still there. */
1244
+ interface BoxValuesMerged {
1245
+ status: "merged";
1246
+ environment: string;
1247
+ target: boolean;
1248
+ variables: string[];
1249
+ secrets: string[];
1250
+ set: BoxValueNames;
1251
+ kept: BoxValueNames;
1252
+ removed: BoxValueNames;
1253
+ moved: {
1254
+ variables: string[];
1255
+ secrets: string[];
1256
+ };
1257
+ }
1258
+ interface BoxValueChanged {
1259
+ status: "set" | "removed";
1260
+ environment: string;
1261
+ kind: BoxValueKind;
1262
+ name?: string;
1263
+ }
1264
+ /** Why a values request was refused. A code, not a message — the CLI
1265
+ * turns each into its own advice. */
1266
+ type BoxValuesErrorCode =
1267
+ /** Missing, unknown or revoked token; or no actor on the session door. */
1268
+ "unauthorized"
1269
+ /** The token may push bundles but was not minted with the values scope. */
1270
+ | "forbidden"
1271
+ /** A valid token for a project this box does not serve. */
1272
+ | "scope-mismatch"
1273
+ /** The token's project has no environment of that name. */
1274
+ | "unknown-environment"
1275
+ /** A reveal, or a `null` in a session-door batch, named a secret the
1276
+ * environment does not hold. */
1277
+ | "unknown-secret"
1278
+ /** A variable or secret named {@link TARGET_ENV_VAR} — send it as the
1279
+ * target instead. */
1280
+ | "reserved"
1281
+ /** Not a readable request. */
1282
+ | "malformed"
1283
+ /** The box has the path but not the method — the daemon's router says
1284
+ * so for any path. On the values door it means a box older than the
1285
+ * request: a merging `env push` against a box that only replaces. The
1286
+ * box changed nothing. */
1287
+ | "method"
1288
+ /** A cloud-minted token whose `exp` has passed, with nothing else wrong
1289
+ * with it: this box's operator key signed it, for the right kind, for
1290
+ * this box. Its own code because the answer differs from every other
1291
+ * refusal — ask the cloud for another pair and retry, rather than "this
1292
+ * credential is wrong". Only the holder of a genuinely signed token for
1293
+ * THIS box ever sees it, so it tells a guesser nothing. */
1294
+ | "expired"
1295
+ /** This box has never read the operator's revocation list, so it cannot
1296
+ * tell a live cloud-minted token from a withdrawn one and takes
1297
+ * neither. A state of the BOX: send the SAME token again after
1298
+ * `retryAfterSeconds`, never mint a new one. */
1299
+ | "revocation-list-unavailable"
1300
+ /** A cloud-minted token that names no project, on a box that serves
1301
+ * several. The message lists them; the token has to name one. */
1302
+ | "ambiguous-project"
1303
+ /** The box could not write its state. Retryable. */
1304
+ | "storage";
1305
+ /** On an `unknown-environment` refusal, from a box that says it: the
1306
+ * project the caller's token belongs to and the environments it has —
1307
+ * so a client can list them and name the command that adds the missing
1308
+ * one. Never another project's names. */
1309
+ interface UnknownEnvironmentDetail {
1310
+ project: string;
1311
+ environments: string[];
1312
+ }
1313
+ interface BoxValuesError {
1314
+ error: {
1315
+ code: BoxValuesErrorCode;
1316
+ message: string;
1317
+ } & Partial<UnknownEnvironmentDetail>;
1318
+ }
1319
+ /** The detail of a refusal, when it is there and readable. Advisory: a
1320
+ * field of the wrong shape drops the detail, never the refusal. */
1321
+ declare function parseUnknownEnvironmentDetail(error: Record<string, unknown>): Partial<UnknownEnvironmentDetail>;
1322
+ type BoxValuesResponse = BoxValuesReplaced | BoxValuesMerged | BoxValueChanged | BoxValuesError;
1323
+ /** Parse a box's answer. Null when the body is not one of ours at all —
1324
+ * a proxy's HTML error page, a captive portal — which the caller reports
1325
+ * as "that URL is not a box". */
1326
+ declare function parseBoxValuesResponse(value: unknown): BoxValuesResponse | null;
1327
+ /** One secret's value, from `GET …/secrets/<NAME>/reveal`. */
1328
+ interface BoxSecretRevealResponse {
1329
+ value: string;
1330
+ }
1331
+ /** Every secret's value by name, from `GET …/values/reveal`. */
1332
+ type BoxSecretsRevealResponse = Record<string, string>;
1333
+ declare function parseBoxSecretRevealResponse(value: unknown): BoxSecretRevealResponse | null;
1334
+ declare function parseBoxSecretsRevealResponse(value: unknown): BoxSecretsRevealResponse | null;
1335
+ /** What an admin sees: where each non-secret value comes from, and the
1336
+ * NAMES of the secrets. A secret's value is never in the view — it comes
1337
+ * back only through a reveal ({@link parseBoxSecretRevealResponse}), one
1338
+ * request per look. */
1339
+ interface BoxEnvValuesView {
1340
+ project: string;
1341
+ environment: string;
1342
+ target: {
1343
+ configured: string;
1344
+ override: string | null;
1345
+ };
1346
+ variables: {
1347
+ name: string;
1348
+ value: string;
1349
+ source: "config" | "box";
1350
+ }[];
1351
+ secrets: string[];
1352
+ }
1353
+
993
1354
  declare const BOX_RUNS_SEGMENT = "runs";
994
1355
  /** Set by the guard, forwarded by the viewer verbatim, verified by the
995
1356
  * daemon: WHO clicked, in a form the thing in between cannot write.
@@ -1013,6 +1374,9 @@ interface BoxRunRequest {
1013
1374
  kind: "collection" | "scenario";
1014
1375
  /** Collection name, or a scenario ref (`folder/test`). */
1015
1376
  ref: string;
1377
+ /** With `kind: "scenario"`: one `test_*` of the file, by function name.
1378
+ * Since 0.49.0. */
1379
+ test?: string;
1016
1380
  }
1017
1381
  /** The daemon accepted the ticket. The run has NOT started — on a busy
1018
1382
  * box it may wait behind a suite for a while, which is the whole point
@@ -1158,7 +1522,7 @@ interface CiRunError {
1158
1522
  error: {
1159
1523
  code: CiRunErrorCode;
1160
1524
  message: string;
1161
- };
1525
+ } & Partial<UnknownEnvironmentDetail>;
1162
1526
  }
1163
1527
  type CiRunResponse = CiRunAccepted | CiRunError;
1164
1528
  /** Why a run's state was not given. The door's own refusals, plus one:
@@ -1188,6 +1552,51 @@ declare function parseCiRunResponse(value: unknown): CiRunResponse | null;
1188
1552
  /** Structural validation of the CI provenance carried on a queue ticket.
1189
1553
  * Shared by the ticket parser and by whoever reads a ticket back. */
1190
1554
  declare function parseCiProvider(value: unknown): CiProviderId | null;
1555
+ /** `GET /api/box/ci/runs/<runId>/lines?after=<n>` — what the run printed,
1556
+ * for a CI log. Same door and same owner rule as the status: a run this
1557
+ * token ordered, and nothing else. */
1558
+ declare function ciRunLinesPath(runId: string): string;
1559
+ /** The query parameter the cursor travels in. */
1560
+ declare const CI_RUN_LINES_AFTER = "after";
1561
+ /** Most lines one answer carries; `next` leads on to the rest. */
1562
+ declare const CI_RUN_LINES_MAX = 500;
1563
+ /** One line of a run, read off its journal. The box decides what is
1564
+ * worth a CI log (a scenario starting and ending, a failed step with its
1565
+ * error, `log` and `note`); the client decides how it looks. Secrets are
1566
+ * masked before the line leaves the box. */
1567
+ interface CiRunLine {
1568
+ kind: "scenario-started" | "step-failed" | "log" | "note" | "scenario-finished";
1569
+ /** Display label of what the line belongs to: the scenario file, or
1570
+ * `file › test` for one test of a file of several. Not a ref — nothing
1571
+ * is to be built from it. */
1572
+ scenario: string;
1573
+ /** `step-failed`: `file:line ErrorName: message`; `log` / `note`: the
1574
+ * text (a note as `label: text`); the scenario lines: empty. */
1575
+ text: string;
1576
+ /** `scenario-finished` only. */
1577
+ outcome?: RunOutcome;
1578
+ /** `scenario-finished` only: the test skipped itself (`skip(reason)`),
1579
+ * so the `completed` above proved nothing. A field beside the outcome,
1580
+ * not an outcome of its own: a client older than it rejects an answer
1581
+ * whose outcome it does not know, and drops a key it does not. */
1582
+ skipReason?: string;
1583
+ }
1584
+ interface CiRunLines {
1585
+ runId: string;
1586
+ lines: CiRunLine[];
1587
+ /** The cursor for the next ask: lines already given out, counted from
1588
+ * the start of the run. Stable — a line once given is never given
1589
+ * again under another number. */
1590
+ next: number;
1591
+ /** The journal has its ending: no line will follow. */
1592
+ done: boolean;
1593
+ }
1594
+ type CiRunLinesResponse = CiRunLines | CiRunStatusError;
1595
+ /** Parse a box's answer. Null when it is not one of ours. A refusal is in
1596
+ * the status vocabulary — and an older box, which has no such route,
1597
+ * answers `malformed`, which this parser does not take: the caller reads
1598
+ * that as "this box does not stream lines". */
1599
+ declare function parseCiRunLinesResponse(value: unknown): CiRunLinesResponse | null;
1191
1600
 
1192
1601
  /** Queue root under `unotest/`, mirroring the two axes of `runsDirFor`:
1193
1602
  * TARGET (dash) and ENVIRONMENT (dot) — `.queue`, `.queue-mobile`,
@@ -1206,11 +1615,7 @@ declare const QUEUE_SLOTS_DIR = "slots";
1206
1615
  /** Mutex file for the all-or-nothing weight claim in a global pool.
1207
1616
  * Short-lived by construction; a stale one is reaped like any lease. */
1208
1617
  declare const QUEUE_MUTEX_FILE = ".mutex";
1209
- /** Set by a lease holder on every child it spawns. A process that sees
1210
- * it is already covered by someone's slot and must not queue again —
1211
- * this is the "top-level run" boundary (a collection's scenario
1212
- * subprocesses). Value: the holder's runId, for diagnostics. */
1213
- declare const QUEUE_LEASE_ENV = "UNOTEST_QUEUE_LEASE";
1618
+
1214
1619
  /** Escape hatch: `1` runs without touching the queue at all. */
1215
1620
  declare const QUEUE_DISABLED_ENV = "UNOTEST_NO_QUEUE";
1216
1621
  /** Optional host-wide weight pool shared by every environment on the
@@ -1661,6 +2066,78 @@ type BundleUploadResponse = BundleUploadOk | BundleUploadError;
1661
2066
  * a proxy's HTML error page, a captive portal — which the caller reports
1662
2067
  * as "that URL is not a box" rather than as a bundle problem. */
1663
2068
  declare function parseBundleUploadResponse(value: unknown): BundleUploadResponse | null;
2069
+ /** `DELETE /api/box/bundles/<id>` with the project token, body optional:
2070
+ * `{"switchTo": "<id>"}` points every environment that runs the bundle at
2071
+ * another one of the same project first. */
2072
+ interface BundleRemoveRequest {
2073
+ switchTo?: string;
2074
+ }
2075
+ /** Null for a body that is not one; an absent body is `{}`. */
2076
+ declare function parseBundleRemoveRequest(value: unknown): BundleRemoveRequest | null;
2077
+ /** The bundle and its files are gone from the token's project. */
2078
+ interface BundleRemoved {
2079
+ status: "removed";
2080
+ bundleId: string;
2081
+ project: string;
2082
+ }
2083
+ /** `switchTo` was asked and the bundle was current somewhere: those
2084
+ * environments are switching, and the bundle is still there. Removal is
2085
+ * a second `bundle rm` once the switches land — the box keeps no pending
2086
+ * removal that a restart could drop without a word. */
2087
+ interface BundleSwitching {
2088
+ status: "switching";
2089
+ bundleId: string;
2090
+ project: string;
2091
+ switchTo: string;
2092
+ environments: string[];
2093
+ }
2094
+ type BundleRemoveOk = BundleRemoved | BundleSwitching;
2095
+ /** What holds a bundle that may not be removed yet. `current`: the
2096
+ * environment runs it; `followsBranch` is set when that environment
2097
+ * follows a branch and cannot be switched by hand. `waiting` / `running`:
2098
+ * a ticket in its queue — a run, or a switch to it — asked for it. */
2099
+ interface BundleUse {
2100
+ environment: string;
2101
+ reason: "current" | "waiting" | "running";
2102
+ followsBranch?: string;
2103
+ }
2104
+ type BundleRemoveErrorCode =
2105
+ /** Missing, unknown or revoked token. */
2106
+ "unauthorized"
2107
+ /** A token for a project this box does not serve. */
2108
+ | "scope-mismatch"
2109
+ /** See {@link BundleUploadErrorCode}. */
2110
+ | "expired" | "revocation-list-unavailable" | "ambiguous-project"
2111
+ /** The token's project holds no such bundle. Said the same way whether
2112
+ * another project holds it or none does: a token learns nothing about
2113
+ * projects that are not its own. */
2114
+ | "unknown-bundle"
2115
+ /** `switchTo` names a bundle the token's project does not hold. */
2116
+ | "unknown-target"
2117
+ /** Something still uses the bundle — `uses` says what. Nothing changed. */
2118
+ | "in-use"
2119
+ /** Not a bundle id, or not a readable body. */
2120
+ | "malformed"
2121
+ /** The box has the path but not the method: older than bundle removal.
2122
+ * Nothing changed. */
2123
+ | "method"
2124
+ /** The box could not remove it. Retryable. */
2125
+ | "storage";
2126
+ interface BundleRemoveErrorDetail {
2127
+ /** On `in-use`. */
2128
+ uses?: BundleUse[];
2129
+ /** The project the presented token is scoped to. */
2130
+ project?: string;
2131
+ }
2132
+ interface BundleRemoveError {
2133
+ error: {
2134
+ code: BundleRemoveErrorCode;
2135
+ message: string;
2136
+ } & BundleRemoveErrorDetail;
2137
+ }
2138
+ type BundleRemoveResponse = BundleRemoveOk | BundleRemoveError;
2139
+ /** Parse a box's answer to a removal; null when it is not one of ours. */
2140
+ declare function parseBundleRemoveResponse(value: unknown): BundleRemoveResponse | null;
1664
2141
 
1665
2142
  /** Engine for this run: `chromium` | `firefox` | `webkit`. Overrides the
1666
2143
  * first entry of `config.browsers`. */
@@ -1687,203 +2164,6 @@ declare function encodeNameList(names: readonly string[]): string;
1687
2164
  /** Decode a `*_NAMES_ENV` value; unset / blank → []. */
1688
2165
  declare function decodeNameList(raw: string | undefined): string[];
1689
2166
 
1690
- /** The variable a box injects an environment's target under — what the
1691
- * suite's `baseUrl` auto-wires from. */
1692
- declare const TARGET_ENV_VAR = "APP_BASE_URL";
1693
- /** Prefix of the runner's own settings (`UNOTEST_HEADED`,
1694
- * `UNOTEST_LOG_LEVEL`, …). They configure the machine a run happens on,
1695
- * never the suite, so an environment on a box neither receives them from
1696
- * `env push` nor is asked for them by a bundle's declared names. One
1697
- * predicate for both sides: they used to disagree, and a box warned about
1698
- * names a push could never have sent. */
1699
- declare const RUNNER_SETTING_PREFIX = "UNOTEST_";
1700
- declare function isRunnerSetting(name: string): boolean;
1701
- /** Token-door root, relative to the box origin. The project is decided by
1702
- * the token (`Authorization: Bearer <token>`), so the path names only the
1703
- * environment:
1704
- *
1705
- * PUT /api/box/values/<env> replace all three layers
1706
- * PUT /api/box/values/<env>/target {"value": "https://…"}
1707
- * DELETE /api/box/values/<env>/target back to the config's
1708
- * PUT /api/box/values/<env>/variables/<NAME> {"value": "…"}
1709
- * DELETE /api/box/values/<env>/variables/<NAME>
1710
- * PUT /api/box/values/<env>/secrets/<NAME> {"value": "…"}
1711
- * DELETE /api/box/values/<env>/secrets/<NAME>
1712
- */
1713
- declare const BOX_VALUES_PATH = "/api/box/values";
1714
- /** Session-door root: the same operations for a signed-in admin, with the
1715
- * project spelled out because a session is not scoped to one. Reachable
1716
- * through the guard only, which stamps the actor; also answers
1717
- * `GET …/values` with the readable view ({@link BoxEnvValuesView}), and
1718
- * reveals secrets on request:
1719
- *
1720
- * PUT /api/box/envs/<project>/<env>/values the batch,
1721
- * with `null` for a secret to keep ({@link BoxEnvValuesReplaceRequest})
1722
- * GET /api/box/envs/<project>/<env>/values/secrets/<NAME>/reveal
1723
- * GET /api/box/envs/<project>/<env>/values/reveal all secrets
1724
- */
1725
- declare const BOX_ENV_VALUES_SEGMENT = "values";
1726
- /** The verb a reveal path ends with. `reveal` is a legal variable name, so
1727
- * the verb never sits in a NAME slot: for one secret it hangs BELOW the
1728
- * name (a name has no children, nothing else can be there), for all of
1729
- * them it hangs off the values root beside the kind segments, where a
1730
- * name never appears. Each shape is distinct by segment count and literal
1731
- * alone — no route has to lean on the HTTP method to tell a secret called
1732
- * `reveal` from the verb. */
1733
- declare const BOX_REVEAL_SEGMENT = "reveal";
1734
- type BoxValueKind = "target" | "variable" | "secret";
1735
- /** Kind for a path segment, or null for anything else. */
1736
- declare function boxValueKindOfSegment(segment: string): Exclude<BoxValueKind, "target"> | null;
1737
- /** `/api/box/values/<env>` — the batch. */
1738
- declare function boxValuesPath(environment: string): string;
1739
- /** `/api/box/values/<env>/target` or `/api/box/values/<env>/<kind>/<NAME>`. */
1740
- declare function boxValuePath(environment: string, kind: BoxValueKind, name?: string): string;
1741
- /** `/api/box/envs/<project>/<env>/values`. */
1742
- declare function boxEnvValuesPath(project: string, environment: string): string;
1743
- /** `/api/box/envs/<project>/<env>/values/target` or `…/values/<kind>/<NAME>`. */
1744
- declare function boxEnvValuePath(project: string, environment: string, kind: BoxValueKind, name?: string): string;
1745
- /** `/api/box/envs/<project>/<env>/values/secrets/<NAME>/reveal` — one
1746
- * secret's value, session door only. */
1747
- declare function boxEnvSecretRevealPath(project: string, environment: string, name: string): string;
1748
- /** `/api/box/envs/<project>/<env>/values/reveal` — every secret's value,
1749
- * session door only. Not under `secrets/` — see {@link BOX_REVEAL_SEGMENT}
1750
- * for why the verb sits beside the kinds rather than among the names. */
1751
- declare function boxEnvSecretsRevealPath(project: string, environment: string): string;
1752
- /** The batch: what the environment should hold from now on. Whole layers,
1753
- * not a diff — a name absent here is removed from the box, so the local
1754
- * files stay the single description of the environment and nothing
1755
- * lingers on the box that nobody can see from the repository. `target`
1756
- * absent = drop the override, back to the operator's config. */
1757
- interface BoxValuesReplaceRequest {
1758
- target?: string;
1759
- variables: Record<string, string>;
1760
- secrets: Record<string, string>;
1761
- }
1762
- /** The session-door batch: the same whole-layer replace, except that a
1763
- * secret may be sent as `null` — "keep whatever the box holds". The
1764
- * admin's page never has the values of secrets it did not reveal, and
1765
- * revealing them all just to send them back would fill the audit log
1766
- * with looks nobody took. A name absent from `secrets` is still removed;
1767
- * `null` keeps only a secret that exists (the box decides what a `null`
1768
- * for an unknown name means). The token door has no such sentinel: a
1769
- * pusher holds the real values. */
1770
- interface BoxEnvValuesReplaceRequest extends Omit<BoxValuesReplaceRequest, "secrets"> {
1771
- secrets: Record<string, string | null>;
1772
- }
1773
- interface BoxValueSetRequest {
1774
- value: string;
1775
- }
1776
- /** Null for anything we will not act on. Names are validated here so a
1777
- * key that could not be a variable never reaches a store; the RESERVED
1778
- * name ({@link TARGET_ENV_VAR}) is not a parse failure — the box answers
1779
- * it with its own code, because the fix is different ("send it as the
1780
- * target", not "fix your JSON"). */
1781
- declare function parseBoxValuesReplaceRequest(value: unknown): BoxValuesReplaceRequest | null;
1782
- /** The session-door batch; `null` is a legal secret value, nothing else
1783
- * beyond {@link parseBoxValuesReplaceRequest} changes. */
1784
- declare function parseBoxEnvValuesReplaceRequest(value: unknown): BoxEnvValuesReplaceRequest | null;
1785
- declare function parseBoxValueSetRequest(value: unknown): BoxValueSetRequest | null;
1786
- /** Names in a batch that may not be set as a variable or a secret. */
1787
- declare function reservedBoxValueNames(request: {
1788
- variables: Record<string, unknown>;
1789
- secrets: Record<string, unknown>;
1790
- }): string[];
1791
- /** What the environment holds after a batch, by NAME, and what the batch
1792
- * took away — so the CLI can say "removed STALE_KEY" instead of leaving
1793
- * the pusher to diff two listings. */
1794
- interface BoxValuesReplaced {
1795
- status: "replaced";
1796
- environment: string;
1797
- /** Whether a target override is now in place. */
1798
- target: boolean;
1799
- variables: string[];
1800
- secrets: string[];
1801
- removed: {
1802
- target: boolean;
1803
- variables: string[];
1804
- secrets: string[];
1805
- };
1806
- }
1807
- interface BoxValueChanged {
1808
- status: "set" | "removed";
1809
- environment: string;
1810
- kind: BoxValueKind;
1811
- name?: string;
1812
- }
1813
- /** Why a values request was refused. A code, not a message — the CLI
1814
- * turns each into its own advice. */
1815
- type BoxValuesErrorCode =
1816
- /** Missing, unknown or revoked token; or no actor on the session door. */
1817
- "unauthorized"
1818
- /** The token may push bundles but was not minted with the values scope. */
1819
- | "forbidden"
1820
- /** A valid token for a project this box does not serve. */
1821
- | "scope-mismatch"
1822
- /** The token's project has no environment of that name. */
1823
- | "unknown-environment"
1824
- /** A reveal, or a `null` in a session-door batch, named a secret the
1825
- * environment does not hold. */
1826
- | "unknown-secret"
1827
- /** A variable or secret named {@link TARGET_ENV_VAR} — send it as the
1828
- * target instead. */
1829
- | "reserved"
1830
- /** Not a readable request. */
1831
- | "malformed"
1832
- /** A cloud-minted token whose `exp` has passed, with nothing else wrong
1833
- * with it: this box's operator key signed it, for the right kind, for
1834
- * this box. Its own code because the answer differs from every other
1835
- * refusal — ask the cloud for another pair and retry, rather than "this
1836
- * credential is wrong". Only the holder of a genuinely signed token for
1837
- * THIS box ever sees it, so it tells a guesser nothing. */
1838
- | "expired"
1839
- /** This box has never read the operator's revocation list, so it cannot
1840
- * tell a live cloud-minted token from a withdrawn one and takes
1841
- * neither. A state of the BOX: send the SAME token again after
1842
- * `retryAfterSeconds`, never mint a new one. */
1843
- | "revocation-list-unavailable"
1844
- /** A cloud-minted token that names no project, on a box that serves
1845
- * several. The message lists them; the token has to name one. */
1846
- | "ambiguous-project"
1847
- /** The box could not write its state. Retryable. */
1848
- | "storage";
1849
- interface BoxValuesError {
1850
- error: {
1851
- code: BoxValuesErrorCode;
1852
- message: string;
1853
- };
1854
- }
1855
- type BoxValuesResponse = BoxValuesReplaced | BoxValueChanged | BoxValuesError;
1856
- /** Parse a box's answer. Null when the body is not one of ours at all —
1857
- * a proxy's HTML error page, a captive portal — which the caller reports
1858
- * as "that URL is not a box". */
1859
- declare function parseBoxValuesResponse(value: unknown): BoxValuesResponse | null;
1860
- /** One secret's value, from `GET …/secrets/<NAME>/reveal`. */
1861
- interface BoxSecretRevealResponse {
1862
- value: string;
1863
- }
1864
- /** Every secret's value by name, from `GET …/values/reveal`. */
1865
- type BoxSecretsRevealResponse = Record<string, string>;
1866
- declare function parseBoxSecretRevealResponse(value: unknown): BoxSecretRevealResponse | null;
1867
- declare function parseBoxSecretsRevealResponse(value: unknown): BoxSecretsRevealResponse | null;
1868
- /** What an admin sees: where each non-secret value comes from, and the
1869
- * NAMES of the secrets. A secret's value is never in the view — it comes
1870
- * back only through a reveal ({@link parseBoxSecretRevealResponse}), one
1871
- * request per look. */
1872
- interface BoxEnvValuesView {
1873
- project: string;
1874
- environment: string;
1875
- target: {
1876
- configured: string;
1877
- override: string | null;
1878
- };
1879
- variables: {
1880
- name: string;
1881
- value: string;
1882
- source: "config" | "box";
1883
- }[];
1884
- secrets: string[];
1885
- }
1886
-
1887
2167
  declare const RUN_MANIFEST_FILE = "manifest.json";
1888
2168
  interface RunManifest {
1889
2169
  /** Format-version of this manifest. Bump only on breaking schema
@@ -1896,10 +2176,14 @@ interface RunManifest {
1896
2176
  * The `runId` directory uses a sanitized form; this carries the
1897
2177
  * human-readable original. */
1898
2178
  ref: string;
1899
- /** Run-id of the parent collection-run when this is a child scenario
1900
- * spawned inside a collection. Absent for top-level scenario-runs
1901
- * and for collection-runs themselves. */
2179
+ /** Run-id of the group this run belongs to: the collection-run that
2180
+ * spawned this scenario, or the file run when this is one test of a
2181
+ * file with several. Absent for top-level runs and for collection-runs
2182
+ * themselves. */
1902
2183
  parentRunId?: string;
2184
+ /** The `test_*` function this run is. Absent on the run of a file with
2185
+ * several tests, which groups them. Since 0.49.0. */
2186
+ test?: string;
1903
2187
  /** Adapter `name` that produced this run (`"@unotest/web"`,
1904
2188
  * `"@unotest/mobile"`). Lets the viewer pick rendering details for
1905
2189
  * runner-specific bundle contents without runner branches in core
@@ -2407,6 +2691,15 @@ interface WorkspaceFile {
2407
2691
  * environment follows then. A viewer older than this field ignores it;
2408
2692
  * a host older than it never writes it — and nothing is offered. */
2409
2693
  follow?: WorkspaceFollow;
2694
+ /** The box's own version — what its operator sees, not the suite's
2695
+ * `@unotest/web`, which the viewer knows itself and which a customer
2696
+ * used to read as the box's (#229). A host older than the field writes
2697
+ * nothing, and the viewer labels only what it knows. */
2698
+ boxVersion?: string;
2699
+ /** The lowest `@unotest/web` this box runs suites on — the run
2700
+ * contract's floor, raised by the operator's config. A viewer running
2701
+ * on an older one says so. */
2702
+ minWebVersion?: string;
2410
2703
  }
2411
2704
  interface WorkspaceFollow {
2412
2705
  path: string;
@@ -2626,7 +2919,29 @@ interface CollectionMeta {
2626
2919
  * for the want of a table. A schedules entry may still name its own
2627
2920
  * `prepare` (it wins for that tick), and `--no-prepare` skips it. */
2628
2921
  prepare: string | null;
2629
- }
2922
+ /** Optional `viewport:` from the YAML — the browser window of every
2923
+ * scenario this collection runs, over the project's `viewport`.
2924
+ * `null` is the real window (no size emulation); `{width, height}` an
2925
+ * emulated size. Absent → the project's setting applies. A setting
2926
+ * of the collection, not of a scenario file: the same scenario run on
2927
+ * its own keeps the project's. Since 0.49.0. */
2928
+ viewport?: CollectionViewport;
2929
+ }
2930
+ /** `viewport:` of a collection: the real window, or an emulated size. */
2931
+ type CollectionViewport = {
2932
+ width: number;
2933
+ height: number;
2934
+ } | null;
2935
+ /** Read a collection's raw `viewport:` value. Shared by the parsers of
2936
+ * the runner and the viewer so both accept and refuse the same values;
2937
+ * each wraps `reason` in its own error with the file's path. */
2938
+ declare function parseCollectionViewport(raw: unknown): {
2939
+ ok: true;
2940
+ viewport: CollectionViewport;
2941
+ } | {
2942
+ ok: false;
2943
+ reason: string;
2944
+ };
2630
2945
 
2631
2946
  /** The collection `init` writes into a new project, and the one the box's
2632
2947
  * screen shows as an example. Named once so the two cannot disagree:
@@ -2840,6 +3155,34 @@ declare function isAnnotationLine(line: string): boolean;
2840
3155
  * comments and stops at the first line of code — an `// @expect-fail`
2841
3156
  * further down the file is a comment about a step, not about the test. */
2842
3157
  declare function parseScenarioAnnotations(source: string): ScenarioAnnotations;
3158
+ /** The markers of ONE `test_*` in a file that may hold several.
3159
+ *
3160
+ * Two places mark a test, and each says whom it is about by where it sits:
3161
+ *
3162
+ * - the `//` lines directly above its `function` line — consecutive,
3163
+ * no blank line between — belong to THAT test, the first one of the
3164
+ * file included;
3165
+ * - the file's leading comments, set apart from the first function by a
3166
+ * blank line, mark EVERY test in the file.
3167
+ *
3168
+ * // @expect-fail <- every test in the file
3169
+ *
3170
+ * // The badge must stay hidden.
3171
+ * // @expect-fail <- test_badge_hidden only
3172
+ * function test_badge_hidden() { ... }
3173
+ *
3174
+ * Adjacency is the rule a reader already applies: a comment touching a
3175
+ * function is about that function. Reading the block above the FIRST test
3176
+ * as the file's would put every test of the file under an expected
3177
+ * failure for a marker its author wrote above one, and a real red in its
3178
+ * neighbours would hide behind it. In a one-test file both readings
3179
+ * agree, which is why {@link parseScenarioAnnotations} keeps its own.
3180
+ *
3181
+ * `functionLine` is the 1-based line of the `function` keyword, as the
3182
+ * DSL parser reports it. Line-based like the rest of this module: only
3183
+ * `//` lines that stand alone count — `foo(); // @expect-fail` is a note
3184
+ * about `foo()`. */
3185
+ declare function parseTestAnnotations(source: string, functionLine: number): ScenarioAnnotations;
2843
3186
 
2844
3187
  /** Parsed scenario metadata from the mandatory header lines
2845
3188
  * (per design-v0/decisions.md, "Test source format"):
@@ -2869,6 +3212,18 @@ interface ScenarioMeta {
2869
3212
  * healthy state, and a green one is the alarm. See
2870
3213
  * {@link ./scenario-annotations.ts}. */
2871
3214
  expectFail: boolean;
3215
+ /** The `test_*` functions of a file that holds several, in file order —
3216
+ * each its own run, its own row under the file. Absent for a file with
3217
+ * one test, which stays a single row. Since 0.49.0. */
3218
+ tests?: ScenarioTest[];
3219
+ }
3220
+ /** One `test_*` of a scenario file with several. */
3221
+ interface ScenarioTest {
3222
+ /** The function name, as written: `test_badge_hidden`. */
3223
+ name: string;
3224
+ /** Marked `// @expect-fail` — by the file's leading block or by the
3225
+ * comments touching its own `function` line. */
3226
+ expectFail: boolean;
2872
3227
  }
2873
3228
 
2874
3229
  /** Response of `GET /api/scenarios`. Folders are listed independently of
@@ -3027,6 +3382,37 @@ declare function replaceEnvVar(content: string, key: string, value: string): {
3027
3382
  replaced: boolean;
3028
3383
  };
3029
3384
 
3385
+ /** A secret's name and the value that must never be shown. */
3386
+ interface SecretValue {
3387
+ name: string;
3388
+ value: string;
3389
+ }
3390
+ /** What stands where a secret's value was. */
3391
+ declare function secretMark(name: string): string;
3392
+ /** The order masking needs: longest value first, so a secret that is a
3393
+ * substring of another does not mask the longer one partly; empty values
3394
+ * dropped, since they would match everywhere. */
3395
+ declare function orderSecretValues(secrets: Iterable<SecretValue>): SecretValue[];
3396
+ /** `text` with every value of `ordered` (see {@link orderSecretValues})
3397
+ * replaced by its mark. */
3398
+ declare function maskSecretValues(text: string, ordered: readonly SecretValue[]): string;
3399
+
3400
+ interface Version {
3401
+ major: number;
3402
+ minor: number;
3403
+ patch: number;
3404
+ }
3405
+ /** The lowest version a pin admits, or null when the pin says nothing we
3406
+ * can reason about (`*`, `latest`, a git URL, a workspace protocol). Null
3407
+ * means "unknown", and the caller treats unknown as "do not guess". */
3408
+ declare function lowestVersionOf(pin: string): Version | null;
3409
+ declare function compareVersions(a: Version, b: Version): number;
3410
+ /** True when the pin may install something older than the minimum. An
3411
+ * unreadable pin or minimum is NOT below: refusing over a version string
3412
+ * this check cannot read would break a legitimate setup, and a version
3413
+ * that really is too old fails loudly on its own. */
3414
+ declare function isBelowMinimum(pin: string, minimum: string): boolean;
3415
+
3030
3416
  /** Which group the user is adding into. App/runner → `.env`, secret →
3031
3417
  * `.secrets`. Mirrors VariableCategory as an INPUT (the user's choice). */
3032
3418
  type VariableKind = VariableCategory;
@@ -3481,6 +3867,14 @@ interface RuntimeStateFile {
3481
3867
  /** True when the failure happened inside a `step.soft(...)` block —
3482
3868
  * the run went on past it. Since 0.31.0. */
3483
3869
  soft?: boolean;
3870
+ /** `note(label, value)` calls of the failing statement's `step(...)`
3871
+ * block (the innermost one), in call order, secrets masked. Empty
3872
+ * when the block noted nothing; absent from runners that do not
3873
+ * collect them. Since 0.49.0. */
3874
+ notes?: Array<{
3875
+ label: string;
3876
+ text: string;
3877
+ }>;
3484
3878
  } | null;
3485
3879
  /** Every `step.soft(...)` block that failed so far, in run order —
3486
3880
  * what the test's verdict lists. Absent on runs recorded before
@@ -3712,4 +4106,4 @@ interface CloudApiRouteMatch {
3712
4106
  */
3713
4107
  declare function matchCloudApiRoute(method: string, path: string): CloudApiRouteMatch | undefined;
3714
4108
 
3715
- export { ACTOR_TICKET_HEADER, ARTIFACTS_ROOT_ENV, type AddVariablePlan, type AddVariablePlanInput, type AppPathPickerSpec, type AppServerEvent, type ApprovalAction, type ApprovalPrice, type AuthoringRunRequest, BLOBS_DIR, BOX_DELETE_CONSEQUENCE, BOX_ENV_VALUES_SEGMENT, BOX_NOTIFY_CHANNEL_KINDS, BOX_NOTIFY_EVENTS, BOX_NOTIFY_PATH, BOX_NOTIFY_STATES, BOX_NOTIFY_TRIGGER_KINDS, BOX_PUSH_TOKEN_PREFIX, BOX_READ_ENVIRONMENTS_PATH, BOX_READ_ENVIRONMENT_HEADER, BOX_READ_TOKEN_ENV, BOX_READ_TOKEN_PREFIX, BOX_REVEAL_SEGMENT, BOX_REVOCATIONS_RETRY_AFTER_SECONDS, BOX_RUNS_SEGMENT, BOX_SECRET_NAMES_ENV, BOX_SIGNED_TOKEN, BOX_SIGNED_TOKEN_PREFIX, BOX_TOKEN_ENV, BOX_URL_ENV, BOX_VALUES_PATH, BOX_VARIABLE_NAMES_ENV, BROWSER_CHANNEL_ENV, BROWSER_ENV, BUNDLED_BROWSER_CHANNEL, BUNDLE_ID_ENV, BUNDLE_MANIFEST_FILE, BUNDLE_SCHEMA_VERSION, BUNDLE_UPLOAD_PATH, type BoxEnvValuesReplaceRequest, type BoxEnvValuesView, type BoxNotifyChanged, type BoxNotifyChannelKind, type BoxNotifyChannelView, type BoxNotifyChannelWrite, type BoxNotifyEnabledPatch, type BoxNotifyError, type BoxNotifyErrorCode, type BoxNotifyEvent, type BoxNotifyLastDelivery, type BoxNotifyMute, type BoxNotifyMuteScope, type BoxNotifyMuteWrite, type BoxNotifyPreview, type BoxNotifyProjectView, type BoxNotifyQuietHours, type BoxNotifyQuietHoursWrite, type BoxNotifyRule, type BoxNotifyRuleWrite, type BoxNotifySecret, type BoxNotifySeriesEntry, type BoxNotifySeriesView, type BoxNotifyState, type BoxNotifyTestResult, type BoxNotifyTriggerKind, type BoxNotifyView, type BoxReadEnvironment, type BoxReadErrorBody, type BoxReadErrorCode, type BoxReadInstall, type BoxRunAccepted, type BoxRunRequest, type BoxRunState, type BoxRunStatus, type BoxSecretRevealResponse, type BoxSecretsRevealResponse, type BoxValueChanged, type BoxValueKind, type BoxValueSetRequest, type BoxValuesError, type BoxValuesErrorCode, type BoxValuesReplaceRequest, type BoxValuesReplaced, type BoxValuesResponse, type BreakpointEntry, type BreakpointsFile, type BundleGitInfo, type BundleManifest, type BundleScopeMismatch, type BundleUnmappedRepo, type BundleUploadError, type BundleUploadErrorCode, type BundleUploadErrorDetail, type BundleUploadOk, type BundleUploadResponse, type BundleUploadStatus, type BundleVariableGap, CI_RUNS_PATH, CI_RUN_PATH, CLOUD_API_ROUTES, COLLECTIONS_SUBDIR, COLLECTION_NAME_FORBIDDEN_RE, COMMANDS_FILE, type CheckSeverity, type CiProviderId, type CiQueuedRun, type CiRunAccepted, type CiRunError, type CiRunErrorCode, type CiRunRequest, type CiRunResponse, type CiRunStatusError, type CiRunStatusErrorCode, type CiRunStatusResponse, type CloudApiRoute, type CloudApiRouteMatch, type CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionScheduleEntry, type CollectionTab, type ContextTagged, DAY_INDEX_FILE, DAY_SHORT, DEFAULT_COLLECTION_NAME, type DbgCommand, type DbgCommandAbort, type DbgCommandClearBp, type DbgCommandContinue, type DbgCommandKind, type DbgCommandPause, type DbgCommandPickerStart, type DbgCommandPickerStop, type DbgCommandProbe, type DbgCommandRecord, type DbgCommandSetBp, type DbgCommandSnapshot, type DbgCommandStep, type DbgCommandWheel, type DebugCapabilities, type DoctorCheck, type DoctorContext, type DownloadEvent, type DslDiagnostic, type DslValidateContext, type DslVocabArg, type DslVocabCategory, type DslVocabEntry, E2E_SUBDIR, ENV_FILE, EXPECT_FAIL_ANNOTATION, type EnqueueRunInput, type EnvChangedMessage, type EnvFile, type EnvUpdate, type EnvVar, type ErrorMessage, FAILURES_DIR_SEGMENTS, FAILURES_ROOT_ENV, FREQ_FIELDS, type FailureBundleWrittenEvent, type FirstRunCommandInput, type FsBreakpointsChangedMessage, type FsCollectionRunStepMessage, type FsCollectionsChangedMessage, type FsHelpersChangedMessage, type FsRunFinishedMessage, type FsRunStartedMessage, type FsRunStepMessage, type FsScenariosChangedMessage, GUARD_SECRET_HEADER, HEARTBEAT_FILE, HELPERS_SUBDIR, type HelperMeta, type HelperTab, type HostRequirement, type IDslLanguageService, type ILaunchedProcess, type IProcessLauncher, type IRunQueue, type IRunnerAdapter, InvalidBlobHashError, JUDGE_ENV, JUDGE_ROUTES, type JudgeErrorResponse, type JudgeHealthResponse, type JudgeRequest, type JudgeVerdict, type JudgeVerdictEvent, LOCK_FILE, LOG_FILE, type LaunchSpec, type LocatorPickedEvent, type LockFile, type LogEvent, type LogLineMessage, type LoopIterationEvent, type Matcher, type NoteEvent, type OverviewTab, PICKER_INCLUDED_TEXT, PICKER_SNAPSHOT_FILE, type ParsedTicketName, type PausedEvent, type PickerMode, type ProbeMatch, type ProbePinned, type ProbeResult, type ProbeResultEvent, QUEUE_DISABLED_ENV, QUEUE_GLOBAL_DIR_ENV, QUEUE_GLOBAL_SLOTS_ENV, QUEUE_LEASE_ENV, QUEUE_MUTEX_FILE, QUEUE_PRIORITIES, QUEUE_RUNNING_DIR, QUEUE_SCHEMA_VERSION, QUEUE_SLOTS_DIR, QUEUE_SUBDIR, QUEUE_TICKETS_DIR, type QueueChangedMessage, type QueueEntry, type QueuePoolState, type QueuePriority, type QueueProducer, type QueueProducerKind, type QueueSnapshot, type QueueTicket, type QueueTicketCi, type QueueTicketKind, type QueueTicketSource, RUNNER_CONFIG_KEYS, RUNNER_SETTING_PREFIX, RUNS_SUBDIR, RUNTIME_FILE, RUN_ACTOR_ENV, RUN_INDEX_SCHEMA_VERSION, RUN_MANIFEST_FILE, RUN_SOURCES_FILE, RUN_TRIGGER_ENV, type RecordedActionKind, type RegexLiteral, type ResumedEvent, type RunArtifact, type RunFinishedEvent, type RunId, type RunIndexEntry, type RunIndexHeader, type RunKind, type RunManifest, type RunMeta, type RunOutcome, type RunQueueLease, type RunQueueTicketHandle, type RunRequest, type RunSources, type RunStartedEvent, type RunStatus, type RunTrigger, type RunTriggerKind, RunnerAdapterNotFoundError, RunnerNotConfiguredError, type RuntimeState, type RuntimeStateFile, SCENARIOS_INDEX_DIR, SCENARIOS_LATEST_FILE, SCENARIO_RECENT_WINDOW, SCHEDULES_FILE, SCHEDULES_FINGERPRINT_ENV, SECRETS_FILE, SEGMENT_NAME_FORBIDDEN_RE, SNAPSHOTS_SUBDIR, STDERR_FILE, STDOUT_FILE, STEPS_FILE, type ScenarioAnnotations, type ScenarioLatestEntry, type ScenarioMeta, type ScenarioRunRequest, type ScenarioRunTab, type ScenarioScheduleEntry, type ScenarioTab, type ScenariosLatest, type ScenariosPayload, type ScheduleEntry, type ScheduleFreq, type ScheduleSpec, type ScreenshotEvent, type SnapshotTab, type SoftFailureRecord, type StepBlockFinishedEvent, type StepBlockStartedEvent, type StepFailEvent, type StepOkEvent, type StepPosition, type StepStartedEvent, TARGET_ENV_VAR, TERMINAL_RUNTIME_STATES, TERMINAL_WS_EVENT, type TabKind, type TabKindName, type TeardownFailureRecord, type TeardownFinishedEvent, type TeardownSkippedEvent, type TeardownStartedEvent, type TeardownStateRecord, type TerminalClientMessage, type TerminalCloseMessage, type TerminalDataMessage, type TerminalErrorMessage, type TerminalExitMessage, type TerminalKind, type TerminalOutputMessage, type TerminalResizeMessage, type TerminalServerMessage, type TerminalSpawnMessage, type ToolCallEvent, type ToolResultEvent, UNOTEST_DIR, UnplaceableRunIdError, UnsupportedRunKindError, type VariableCategory, type VariableKind, type VariablePlanError, type VisualAssertEvent, type VisualFailureRecord, WEEK_CHIP_ORDER, WORKSPACE_FILE, WORKSPACE_SCHEMA_VERSION, type WheelChangedEvent, type WorkspaceBundle, type WorkspaceFile, type WorkspaceFollow, type WsMessage, type WsMessageKind, activeEnvName, approvalActionText, approvalConsequence, approvalPrice, approvalPriceLabel, artifactsRootFrom, blobPathFor, blobRelPathFor, blobRelSegmentsFor, blobsRootFor, boxEnvSecretRevealPath, boxEnvSecretsRevealPath, boxEnvValuePath, boxEnvValuesPath, boxNotifyChannelPath, boxNotifyMutePath, boxNotifyPreviewPath, boxNotifyPreviewTrigger, boxNotifyProjectPath, boxNotifyQuietHoursPath, boxNotifyRulePath, boxNotifySeriesPath, boxNotifySeriesResetPath, boxNotifyTestPath, boxRunPath, boxRunsPath, boxValueKindOfSegment, boxValuePath, boxValuesPath, canonicalScheduleSet, categorizeVariable, compareQueueTicketNames, cronFromSpec, debugDirFor, debuggerFileFor, declaredEnvKeys, decodeNameList, deleteShadowWarning, describeBundle, describeCron, describeSpec, describeTicketCi, encodeNameList, envFileFor, envKeys, envLayerFilesFor, envNamesFromDirListing, failuresRootFrom, failuresRootIn, failuresRootUnder, firstRunCommand, foldScenarioRun, formatNextTick, insertEnvVar, isAnnotationLine, isBoxNotifyState, isEnvVarName, isExternalVarName, isFailingStatus, isQueueDirName, isRecord, isRegexLiteral, isRunnerConfigKey, isRunnerSetting, isRunsDirName, isTerminalRuntimeState, makeQueueTicketName, makeRunId, manifestTrigger, matchCloudApiRoute, mergeSchedules, nextTickFromSpec, parseAppServerEvent, parseBoxEnvValuesReplaceRequest, parseBoxNotifyChanged, parseBoxNotifyError, parseBoxNotifyMuteScope, parseBoxNotifyPreview, parseBoxNotifyProjectView, parseBoxNotifySeriesView, parseBoxNotifyTestResult, parseBoxNotifyView, parseBoxReadEnvironments, parseBoxReadError, parseBoxReadInstall, parseBoxRunAccepted, parseBoxRunRequest, parseBoxRunStatus, parseBoxSecretRevealResponse, parseBoxSecretsRevealResponse, parseBoxValueSetRequest, parseBoxValuesReplaceRequest, parseBoxValuesResponse, parseBundleManifest, parseBundleUploadResponse, parseCiProvider, parseCiRunRequest, parseCiRunResponse, parseCiRunStatusResponse, parseEnvContent, parseQueueTicket, parseQueueTicketName, parseScenarioAnnotations, parseScheduleEntry, parseSchedulesDoc, parseSchedulesJson, parseWorkspaceFile, planAddVariable, projectQueueRoot, projectRunDirFor, projectRunsRoot, queueDirFor, queuePriorityFromRank, queuePriorityRank, regexLiteral, removeEnvVar, replaceEnvVar, requireRunDirFor, reservedBoxValueNames, runDirFor, runIdStartedAt, runTriggerEnv, runTriggerFromEnv, runsDirFor, sanitizeRunIdSegment, scenarioIndexFileName, scenarioRefFromFileName, scheduleTarget, secretsFileFor, secretsLayerFilesFor, serializeEnvValue, shardDaysDescending, shardDirFor, shardPathForRunId, shardPathForTimestamp, specFromCron, testDirFor, validateCollectionName, validateSegmentName };
4109
+ export { ACTOR_TICKET_HEADER, ARTIFACTS_ROOT_ENV, type AddVariablePlan, type AddVariablePlanInput, type AppPathPickerSpec, type AppServerEvent, type ApprovalAction, type ApprovalPrice, type AuthoringRunRequest, BLOBS_DIR, BOX_DELETE_CONSEQUENCE, BOX_ENV_VALUES_SEGMENT, BOX_NOTIFY_CHANNEL_KINDS, BOX_NOTIFY_EVENTS, BOX_NOTIFY_PATH, BOX_NOTIFY_STATES, BOX_NOTIFY_TRIGGER_KINDS, BOX_PUSH_TOKEN_PREFIX, BOX_READ_ENVIRONMENTS_PATH, BOX_READ_ENVIRONMENT_HEADER, BOX_READ_TOKEN_ENV, BOX_READ_TOKEN_PREFIX, BOX_REVEAL_SEGMENT, BOX_REVOCATIONS_RETRY_AFTER_SECONDS, BOX_RUNS_SEGMENT, BOX_SECRET_NAMES_ENV, BOX_SIGNED_TOKEN, BOX_SIGNED_TOKEN_PREFIX, BOX_TOKEN_ENV, BOX_URL_ENV, BOX_VALUES_PATH, BOX_VARIABLE_NAMES_ENV, BROWSER_CHANNEL_ENV, BROWSER_ENV, BUNDLED_BROWSER_CHANNEL, BUNDLE_ID_ENV, BUNDLE_MANIFEST_FILE, BUNDLE_SCHEMA_VERSION, BUNDLE_UPLOAD_PATH, type BoxEnvValuesReplaceRequest, type BoxEnvValuesView, type BoxNotifyChanged, type BoxNotifyChannelKind, type BoxNotifyChannelView, type BoxNotifyChannelWrite, type BoxNotifyEnabledPatch, type BoxNotifyError, type BoxNotifyErrorCode, type BoxNotifyEvent, type BoxNotifyLastDelivery, type BoxNotifyMute, type BoxNotifyMuteScope, type BoxNotifyMuteWrite, type BoxNotifyPreview, type BoxNotifyProjectView, type BoxNotifyQuietHours, type BoxNotifyQuietHoursWrite, type BoxNotifyRule, type BoxNotifyRuleWrite, type BoxNotifySecret, type BoxNotifySeriesEntry, type BoxNotifySeriesView, type BoxNotifyState, type BoxNotifyTestResult, type BoxNotifyTriggerKind, type BoxNotifyView, type BoxReadEnvironment, type BoxReadErrorBody, type BoxReadErrorCode, type BoxReadInstall, type BoxRunAccepted, type BoxRunRequest, type BoxRunState, type BoxRunStatus, type BoxSecretRevealResponse, type BoxSecretsRevealResponse, type BoxValueChanged, type BoxValueKind, type BoxValueNames, type BoxValueSetRequest, type BoxValuesError, type BoxValuesErrorCode, type BoxValuesMergeRequest, type BoxValuesMerged, type BoxValuesReplaceRequest, type BoxValuesReplaced, type BoxValuesResponse, type BreakpointEntry, type BreakpointsFile, type BundleGitInfo, type BundleManifest, type BundleRemoveError, type BundleRemoveErrorCode, type BundleRemoveErrorDetail, type BundleRemoveOk, type BundleRemoveRequest, type BundleRemoveResponse, type BundleRemoved, type BundleScopeMismatch, type BundleSwitching, type BundleUnmappedRepo, type BundleUploadError, type BundleUploadErrorCode, type BundleUploadErrorDetail, type BundleUploadOk, type BundleUploadResponse, type BundleUploadStatus, type BundleUse, type BundleVariableGap, CI_RUNS_PATH, CI_RUN_LINES_AFTER, CI_RUN_LINES_MAX, CI_RUN_PATH, CLOUD_API_ROUTES, COLLECTIONS_SUBDIR, COLLECTION_NAME_FORBIDDEN_RE, COMMANDS_FILE, type CheckSeverity, type CiProviderId, type CiQueuedRun, type CiRunAccepted, type CiRunError, type CiRunErrorCode, type CiRunLine, type CiRunLines, type CiRunLinesResponse, type CiRunRequest, type CiRunResponse, type CiRunStatusError, type CiRunStatusErrorCode, type CiRunStatusResponse, type CloudApiRoute, type CloudApiRouteMatch, type CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionScheduleEntry, type CollectionTab, type CollectionViewport, type ContextTagged, DAY_INDEX_FILE, DAY_SHORT, DEFAULT_COLLECTION_NAME, type DbgCommand, type DbgCommandAbort, type DbgCommandClearBp, type DbgCommandContinue, type DbgCommandKind, type DbgCommandPause, type DbgCommandPickerStart, type DbgCommandPickerStop, type DbgCommandProbe, type DbgCommandRecord, type DbgCommandSetBp, type DbgCommandSnapshot, type DbgCommandStep, type DbgCommandWheel, type DebugCapabilities, type DoctorCheck, type DoctorContext, type DownloadEvent, type DslDiagnostic, type DslValidateContext, type DslVocabArg, type DslVocabCategory, type DslVocabEntry, E2E_SUBDIR, EDITOR_TYPES_ENV, ENVIRONMENT_ENV, ENV_FILE, EXPECT_FAIL_ANNOTATION, type EnqueueRunInput, type EnvChangedMessage, type EnvFile, type EnvUpdate, type EnvVar, type ErrorMessage, FAILURES_DIR_SEGMENTS, FAILURES_ROOT_ENV, FREQ_FIELDS, type FailureBundleWrittenEvent, type FileRunTestFinishedEvent, type FileRunTestStartedEvent, type FirstRunCommandInput, type FsBreakpointsChangedMessage, type FsCollectionRunStepMessage, type FsCollectionsChangedMessage, type FsHelpersChangedMessage, type FsRunFinishedMessage, type FsRunStartedMessage, type FsRunStepMessage, type FsScenariosChangedMessage, GUARD_SECRET_HEADER, HEARTBEAT_FILE, HELPERS_SUBDIR, type HelperMeta, type HelperTab, type HostRequirement, type IDslLanguageService, type ILaunchedProcess, type IProcessLauncher, type IRunQueue, type IRunnerAdapter, InvalidBlobHashError, JUDGE_ENV, JUDGE_ROUTES, type JudgeErrorResponse, type JudgeHealthResponse, type JudgeRequest, type JudgeVerdict, type JudgeVerdictEvent, LOCK_FILE, LOG_FILE, type LaunchSpec, type LocatorPickedEvent, type LockFile, type LogEvent, type LogLineMessage, type LoopIterationEvent, type Matcher, type NoteEvent, type OverviewTab, PICKER_INCLUDED_TEXT, PICKER_SNAPSHOT_FILE, type ParsedTicketName, type PausedEvent, type PickerMode, type ProbeMatch, type ProbePinned, type ProbeResult, type ProbeResultEvent, QUEUE_DISABLED_ENV, QUEUE_GLOBAL_DIR_ENV, QUEUE_GLOBAL_SLOTS_ENV, QUEUE_LEASE_ENV, QUEUE_MUTEX_FILE, QUEUE_PRIORITIES, QUEUE_RUNNING_DIR, QUEUE_SCHEMA_VERSION, QUEUE_SLOTS_DIR, QUEUE_SUBDIR, QUEUE_TICKETS_DIR, type QueueChangedMessage, type QueueEntry, type QueuePoolState, type QueuePriority, type QueueProducer, type QueueProducerKind, type QueueSnapshot, type QueueTicket, type QueueTicketCi, type QueueTicketKind, type QueueTicketSource, RUNNER_CONFIG_KEYS, RUNNER_SETTING_PREFIX, RUNS_SUBDIR, RUNTIME_FILE, RUN_ACTOR_ENV, RUN_IDENTITY_ENV_NAMES, RUN_ID_ENV, RUN_INDEX_SCHEMA_VERSION, RUN_MANIFEST_FILE, RUN_SOURCES_FILE, RUN_TRIGGER_ENV, type RecordedActionKind, type RegexLiteral, type ResumedEvent, type RunArtifact, type RunFinishedEvent, type RunId, type RunIndexEntry, type RunIndexHeader, type RunKind, type RunManifest, type RunMeta, type RunOutcome, type RunQueueLease, type RunQueueTicketHandle, type RunRequest, type RunSources, type RunStartedEvent, type RunStatus, type RunTrigger, type RunTriggerKind, RunnerAdapterNotFoundError, RunnerNotConfiguredError, type RuntimeState, type RuntimeStateFile, SCENARIOS_INDEX_DIR, SCENARIOS_LATEST_FILE, SCENARIO_RECENT_WINDOW, SCHEDULES_FILE, SCHEDULES_FINGERPRINT_ENV, SECRETS_FILE, SEGMENT_NAME_FORBIDDEN_RE, SNAPSHOTS_SUBDIR, STDERR_FILE, STDOUT_FILE, STEPS_FILE, type ScenarioAnnotations, type ScenarioLatestEntry, type ScenarioMeta, type ScenarioRunRequest, type ScenarioRunTab, type ScenarioScheduleEntry, type ScenarioTab, type ScenarioTest, type ScenariosLatest, type ScenariosPayload, type ScheduleEntry, type ScheduleFreq, type ScheduleSpec, type ScreenshotEvent, type SecretValue, type SnapshotTab, type SoftFailureRecord, type StepBlockFinishedEvent, type StepBlockStartedEvent, type StepFailEvent, type StepOkEvent, type StepPosition, type StepStartedEvent, TARGET_ENV_VAR, TERMINAL_RUNTIME_STATES, TERMINAL_WS_EVENT, type TabKind, type TabKindName, type TeardownFailureRecord, type TeardownFinishedEvent, type TeardownSkippedEvent, type TeardownStartedEvent, type TeardownStateRecord, type TerminalClientMessage, type TerminalCloseMessage, type TerminalDataMessage, type TerminalErrorMessage, type TerminalExitMessage, type TerminalKind, type TerminalOutputMessage, type TerminalResizeMessage, type TerminalServerMessage, type TerminalSpawnMessage, type TestLatestEntry, type TestRunOutcome, type TestSelection, type ToolCallEvent, type ToolResultEvent, UNOTEST_DIR, type UnknownEnvironmentDetail, UnknownTestError, UnplaceableRunIdError, UnsupportedRunKindError, type VariableCategory, type VariableKind, type VariablePlanError, type Version, type VisualAssertEvent, type VisualFailureRecord, WEEK_CHIP_ORDER, WORKSPACE_FILE, WORKSPACE_SCHEMA_VERSION, type WheelChangedEvent, type WorkspaceBundle, type WorkspaceFile, type WorkspaceFollow, type WsMessage, type WsMessageKind, activeEnvName, approvalActionText, approvalConsequence, approvalPrice, approvalPriceLabel, artifactsRootFrom, blobPathFor, blobRelPathFor, blobRelSegmentsFor, blobsRootFor, boxEnvSecretRevealPath, boxEnvSecretsRevealPath, boxEnvValuePath, boxEnvValuesPath, boxNotifyChannelPath, boxNotifyMutePath, boxNotifyPreviewPath, boxNotifyPreviewTrigger, boxNotifyProjectPath, boxNotifyQuietHoursPath, boxNotifyRulePath, boxNotifySeriesPath, boxNotifySeriesResetPath, boxNotifyTestPath, boxRunPath, boxRunsPath, boxValueKindOfSegment, boxValuePath, boxValuesPath, canonicalScheduleSet, categorizeVariable, ciRunLinesPath, compareQueueTicketNames, compareVersions, cronFromSpec, debugDirFor, debuggerFileFor, declaredEnvKeys, decodeNameList, deleteShadowWarning, describeBundle, describeCron, describeSpec, describeTicketCi, encodeNameList, envFileFor, envKeys, envLayerFilesFor, envNamesFromDirListing, failuresRootFrom, failuresRootIn, failuresRootUnder, firstRunCommand, foldScenarioRun, foldTestRun, formatNextTick, insertEnvVar, isAnnotationLine, isBelowMinimum, isBoxNotifyState, isEnvVarName, isExternalVarName, isFailingStatus, isQueueDirName, isRecord, isRegexLiteral, isReservedBoxValueName, isRunId, isRunIdentityEnvName, isRunnerConfigKey, isRunnerSetting, isRunsDirName, isTerminalRuntimeState, lowestVersionOf, makeQueueTicketName, makeRunId, manifestTrigger, maskSecretValues, matchCloudApiRoute, mergeSchedules, nextTickFromSpec, orderSecretValues, parseAppServerEvent, parseBoxEnvValuesReplaceRequest, parseBoxNotifyChanged, parseBoxNotifyError, parseBoxNotifyMuteScope, parseBoxNotifyPreview, parseBoxNotifyProjectView, parseBoxNotifySeriesView, parseBoxNotifyTestResult, parseBoxNotifyView, parseBoxReadEnvironments, parseBoxReadError, parseBoxReadInstall, parseBoxRunAccepted, parseBoxRunRequest, parseBoxRunStatus, parseBoxSecretRevealResponse, parseBoxSecretsRevealResponse, parseBoxValueSetRequest, parseBoxValuesMergeRequest, parseBoxValuesReplaceRequest, parseBoxValuesResponse, parseBundleManifest, parseBundleRemoveRequest, parseBundleRemoveResponse, parseBundleUploadResponse, parseCiProvider, parseCiRunLinesResponse, parseCiRunRequest, parseCiRunResponse, parseCiRunStatusResponse, parseCollectionViewport, parseEnvContent, parseQueueTicket, parseQueueTicketName, parseScenarioAnnotations, parseScheduleEntry, parseSchedulesDoc, parseSchedulesJson, parseTestAnnotations, parseUnknownEnvironmentDetail, parseWorkspaceFile, planAddVariable, projectQueueRoot, projectRunDirFor, projectRunsRoot, queueDirFor, queuePriorityFromRank, queuePriorityRank, regexLiteral, removeEnvVar, replaceEnvVar, requireRunDirFor, reservedBoxValueNames, runDirFor, runIdStartedAt, runIdentityRefusal, runStatusOf, runTriggerEnv, runTriggerFromEnv, runsDirFor, sanitizeRunIdSegment, scenarioIndexFileName, scenarioRefFromFileName, scheduleTarget, secretMark, secretsFileFor, secretsLayerFilesFor, selectTests, serializeEnvValue, shardDaysDescending, shardDirFor, shardPathForRunId, shardPathForTimestamp, specFromCron, testDirFor, testIndexFileName, validateCollectionName, validateSegmentName, withoutRunIdentity };