@unotest/protocol 0.32.0 → 0.35.0

package/dist/index.d.ts

@@ -159,6 +159,30 @@ declare const ARTIFACTS_ROOT_ENV = "UNOTEST_ARTIFACTS_ROOT";
  *  back to the source root. Blank is treated as unset — an exported but
  *  empty variable must not relocate anything. */
 declare function artifactsRootFrom(env: Record<string, string | undefined>, projectRoot: string): string;
+/** Where failure bundles live, as path SEGMENTS — the one spelling of
+ *  `.unotest/failures` in the monorepo. Segments rather than a string
+ *  because two kinds of caller need it: one joins it onto a native
+ *  filesystem path (web, on Windows too), the other builds a posix path
+ *  for a container or compares an artifact-relative one (box-runner,
+ *  boxd, the viewer's asset allowlist). */
+declare const FAILURES_DIR_SEGMENTS: readonly [".unotest", "failures"];
+/** Posix `<root>/.unotest/failures`. For container and artifact-relative
+ *  paths; a native filesystem path joins `FAILURES_DIR_SEGMENTS` instead. */
+declare function failuresRootUnder(root: string): string;
+/** Where THIS process writes and reads failure bundles.
+ *
+ *  Hung off the artifact root by default, which is the project root on
+ *  every local run. A box overrides it, and has to: the run executes in a
+ *  container with exactly two mounts, and the default sits outside both —
+ *  the bundle directory could not be created at all, so a failed run
+ *  showed no screenshot, no trace and no page.html. The override puts the
+ *  bundles inside the environment's artifact tree, which both the run and
+ *  the viewer already have. */
+declare const FAILURES_ROOT_ENV = "UNOTEST_FAILURES_ROOT";
+/** Resolve the failures root from a process-env-like record, falling back
+ *  to what the caller derives from the artifact root. Blank is treated as
+ *  unset, like every other root here. */
+declare function failuresRootFrom(env: Record<string, string | undefined>, defaultRoot: string): string;
 /** Read an environment name from a process-env-like record (`UNOTEST_ENV`),
  *  normalising empty/blank to `undefined` (= base only). */
 declare function activeEnvName(env: Record<string, string | undefined>): string | undefined;
@@ -225,6 +249,13 @@ declare function requireRunDirFor(runsRoot: string, runId: string): string;
 /** Project-relative runs root for a target + environment:
  *  `unotest/.runs<suffix>[.<env>]`. */
 declare function projectRunsRoot(suffix?: string, envName?: string): string;
+/** Where an environment's failure bundles live, under an artifact root.
+ *  Inside the runs tree rather than beside it, because that tree is the
+ *  one directory both sides of a box already have: a run's container
+ *  mounts it, and so does the viewer that serves the screenshots. Every
+ *  spawner (`box-runner` for containers, `boxd` for host processes) hands
+ *  this to `UNOTEST_FAILURES_ROOT` in its own coordinates. */
+declare function failuresRootIn(artifactsRoot: string, envName?: string): string;
 /** Project-relative directory of one run, shard included. The single
  *  place that knows how a run id becomes a path — every writer and reader
  *  goes through here, so the layout cannot drift between them. */
@@ -931,6 +962,21 @@ type CiRunErrorCode =
  | "no-collections"
 /** Not a readable request. */
  | "malformed"
+/** A cloud-minted token whose `exp` has passed, with nothing else wrong
+ *  with it: this box's operator key signed it, for the right kind, for
+ *  this box. Its own code because the answer differs from every other
+ *  refusal — ask the cloud for another pair and retry, rather than "this
+ *  credential is wrong". Only the holder of a genuinely signed token for
+ *  THIS box ever sees it, so it tells a guesser nothing. */
+ | "expired"
+/** This box has never read the operator's revocation list, so it cannot
+ *  tell a live cloud-minted token from a withdrawn one and takes
+ *  neither. A state of the BOX: send the SAME token again after
+ *  `retryAfterSeconds`, never mint a new one. */
+ | "revocation-list-unavailable"
+/** A cloud-minted token that names no project, on a box that serves
+ *  several. The message lists them; the token has to name one. */
+ | "ambiguous-project"
 /** The bundle could not be installed on the box. Retryable. */
  | "storage";
 interface CiRunError {
@@ -1215,6 +1261,17 @@ declare const BUNDLE_UPLOAD_PATH = "/api/box/bundles";
  *  credential — `BOX_READ_TOKEN_ENV` in `box-read.ts`. */
 declare const BOX_URL_ENV = "UNOTEST_BOX_URL";
 declare const BOX_TOKEN_ENV = "UNOTEST_BOX_TOKEN";
+/** What a hand-minted project token starts with. Cloud-signed tokens
+ *  carry no such prefix; the one thing the prefix is good for on the
+ *  client is recognising a push token pasted where a read token goes. */
+declare const BOX_PUSH_TOKEN_PREFIX = "unob_";
+/** What a CLOUD-signed box token starts with — push, read and picker
+ *  alike; the kind is inside the signed claims. Minted by `box create`
+ *  and `box access`, never by hand. */
+declare const BOX_SIGNED_TOKEN_PREFIX = "unos_";
+/** The whole shape of a cloud-signed token, checked before any network
+ *  call — box-kit's `encodeSignedToken` output. */
+declare const BOX_SIGNED_TOKEN: RegExp;
 /** Set by a box on every run it starts: which bundle the sources came
  *  from. The runner stamps it into the run's manifest, so history keeps
  *  the answer to "which code produced this" after the environment has
@@ -1341,6 +1398,21 @@ type BundleUploadErrorCode =
  | "min-version"
 /** The token's scope does not match where the bundle says it is from. */
  | "scope-mismatch"
+/** A cloud-minted token whose `exp` has passed, with nothing else wrong
+ *  with it: this box's operator key signed it, for the right kind, for
+ *  this box. Its own code because the answer differs from every other
+ *  refusal — ask the cloud for another pair and retry, rather than "this
+ *  credential is wrong". Only the holder of a genuinely signed token for
+ *  THIS box ever sees it, so it tells a guesser nothing. */
+ | "expired"
+/** This box has never read the operator's revocation list, so it cannot
+ *  tell a live cloud-minted token from a withdrawn one and takes
+ *  neither. A state of the BOX: send the SAME token again after
+ *  `retryAfterSeconds`, never mint a new one. */
+ | "revocation-list-unavailable"
+/** A cloud-minted token that names no project, on a box that serves
+ *  several. The message lists them; the token has to name one. */
+ | "ambiguous-project"
 /** The box could not store it (disk, permissions). Retryable. */
  | "storage";
 interface BundleUploadError {
@@ -1522,6 +1594,21 @@ type BoxValuesErrorCode =
  | "reserved"
 /** Not a readable request. */
  | "malformed"
+/** A cloud-minted token whose `exp` has passed, with nothing else wrong
+ *  with it: this box's operator key signed it, for the right kind, for
+ *  this box. Its own code because the answer differs from every other
+ *  refusal — ask the cloud for another pair and retry, rather than "this
+ *  credential is wrong". Only the holder of a genuinely signed token for
+ *  THIS box ever sees it, so it tells a guesser nothing. */
+ | "expired"
+/** This box has never read the operator's revocation list, so it cannot
+ *  tell a live cloud-minted token from a withdrawn one and takes
+ *  neither. A state of the BOX: send the SAME token again after
+ *  `retryAfterSeconds`, never mint a new one. */
+ | "revocation-list-unavailable"
+/** A cloud-minted token that names no project, on a box that serves
+ *  several. The message lists them; the token has to name one. */
+ | "ambiguous-project"
 /** The box could not write its state. Retryable. */
  | "storage";
 interface BoxValuesError {
@@ -1562,6 +1649,315 @@ interface BoxEnvValuesView {
     secrets: string[];
 }
 
+declare const RUN_MANIFEST_FILE = "manifest.json";
+interface RunManifest {
+    /** Format-version of this manifest. Bump only on breaking schema
+     *  changes — additive optional fields don't require it. Starts at 1. */
+    schemaVersion: 1;
+    /** Identifies which RunRequest variant produced this run. */
+    kind: RunKind;
+    /** Original (un-sanitized) `ref` from the request — scenario `name`
+     *  for `kind:"scenario"`, collection `name` for `kind:"collection"`.
+     *  The `runId` directory uses a sanitized form; this carries the
+     *  human-readable original. */
+    ref: string;
+    /** Run-id of the parent collection-run when this is a child scenario
+     *  spawned inside a collection. Absent for top-level scenario-runs
+     *  and for collection-runs themselves. */
+    parentRunId?: string;
+    /** Adapter `name` that produced this run (`"@unotest/web"`,
+     *  `"@unotest/mobile"`). Lets the viewer pick rendering details for
+     *  runner-specific bundle contents without runner branches in core
+     *  logic. */
+    adapter: string;
+    /** Wallclock at runner start. Distinct from the first event's `t`
+     *  (which may have leading delay for adapter setup). */
+    startedAt: number;
+    /** Environment name the run resolved (`UNOTEST_ENV` / `--env`), absent
+     *  for base. Self-description only — placement already encodes it (the
+     *  run lives under `.runs<suffix>.<env>`), so nothing filters on this. */
+    env?: string;
+    /** Opt-in artifact-capture flags as resolved from the runner's env at
+     *  start (`UNOTEST_CONSOLE` / `UNOTEST_NETWORK`). Recorded here so the
+     *  viewer can tell "capture was disabled" apart from "capture was on but
+     *  the run aborted before writing console.json / network.json" — a
+     *  distinction the mere presence of those files can't make. Optional: runs
+     *  produced before this field existed simply omit it, and the viewer falls
+     *  back to a file-presence heuristic. */
+    capture?: {
+        console: boolean;
+        network: boolean;
+    };
+    /** Which test bundle produced this run, when the sources came from one
+     *  (`UNOTEST_BUNDLE_ID`, set by a box). Absent for every local run,
+     *  where the sources are simply the working directory.
+     *
+     *  Recorded so history stays readable after the fact: a box runs many
+     *  bundles into one environment, and "which code produced this red
+     *  run" is otherwise unanswerable once the environment moved on. */
+    bundleId?: string;
+    /** What set the run off. Absent on a manifest written before the field
+     *  existed, and on every run nobody described — both read as `cli`
+     *  (see {@link manifestTrigger}). */
+    trigger?: RunTrigger;
+}
+/** Who or what started a run. `schedule` — a box's own timer; `ci` — a
+ *  provider's push or pull request through the box; `manual` — a person
+ *  (or their agent) pressing Run in the viewer; `cli` — a terminal, which
+ *  is also the answer for a run that said nothing. */
+type RunTriggerKind = "schedule" | "ci" | "manual" | "cli";
+interface RunTrigger {
+    kind: RunTriggerKind;
+    /** Who, or which change: a login, `push a1b2c3d (feature/x)`. Absent when
+     *  the trigger has nobody to name (a schedule). */
+    by?: string;
+}
+/** `UNOTEST_RUN_TRIGGER` — a {@link RunTriggerKind}, set by whoever spawns
+ *  the runner: a box for its scheduled and CI runs, the viewer for a run
+ *  ordered from its UI. A terminal sets nothing. */
+declare const RUN_TRIGGER_ENV = "UNOTEST_RUN_TRIGGER";
+/** `UNOTEST_RUN_ACTOR` — the trigger's `by`, optional. */
+declare const RUN_ACTOR_ENV = "UNOTEST_RUN_ACTOR";
+/** The trigger the environment describes, or undefined when it describes
+ *  none — a value that is not a trigger kind is a caller's mistake and is
+ *  treated as silence rather than guessed at. */
+declare function runTriggerFromEnv(env: Readonly<Record<string, string | undefined>>): RunTrigger | undefined;
+/** The variables that hand a trigger to a runner — the inverse of
+ *  {@link runTriggerFromEnv}, so a box and the viewer spell them the same
+ *  way. */
+declare function runTriggerEnv(trigger: RunTrigger): Record<string, string>;
+/** A manifest's trigger, with the default spelled out: no field = `cli`. */
+declare function manifestTrigger(manifest: Pick<RunManifest, "trigger">): RunTrigger;
+
+/** Session-door root:
+ *
+ *    GET    /api/box/notify                                   every project
+ *    GET    /api/box/notify/<project>                         one project, secrets as set:true
+ *    PUT    /api/box/notify/<project>/channels/<id>           create or update
+ *    PATCH  /api/box/notify/<project>/channels/<id>           {"enabled": …}
+ *    DELETE /api/box/notify/<project>/channels/<id>
+ *    POST   /api/box/notify/<project>/channels/<id>/test
+ *    PUT/PATCH/DELETE /api/box/notify/<project>/rules/<id>
+ *    PUT/DELETE       /api/box/notify/<project>/quiet-hours
+ *    GET    /api/box/notify/<project>/series                  the ledger
+ *    POST   /api/box/notify/<project>/series/<key>/reset
+ *    PUT/DELETE       /api/box/notify/<project>/mutes/<id>
+ *    GET    /api/box/notify/<project>/preview?rule=<id>&state=<state>
+ */
+declare const BOX_NOTIFY_PATH = "/api/box/notify";
+declare function boxNotifyProjectPath(project: string): string;
+declare function boxNotifyChannelPath(project: string, channelId: string): string;
+declare function boxNotifyTestPath(project: string, channelId: string): string;
+declare function boxNotifyRulePath(project: string, ruleId: string): string;
+declare function boxNotifyQuietHoursPath(project: string): string;
+declare function boxNotifySeriesPath(project: string): string;
+/** The key (`project/env/kind:name`) travels as ONE segment. */
+declare function boxNotifySeriesResetPath(project: string, seriesKey: string): string;
+declare function boxNotifyMutePath(project: string, muteId: string): string;
+declare function boxNotifyPreviewPath(project: string, ruleId: string, state: BoxNotifyState): string;
+type BoxNotifyChannelKind = "slack" | "telegram" | "webhook";
+declare const BOX_NOTIFY_CHANNEL_KINDS: readonly BoxNotifyChannelKind[];
+type BoxNotifyTriggerKind = RunTriggerKind;
+declare const BOX_NOTIFY_TRIGGER_KINDS: readonly BoxNotifyTriggerKind[];
+/** What a rule subscribes to. `passed` is said only about runs that are
+ *  not scheduled ticks; a schedule says `recovered`. */
+type BoxNotifyEvent = "failed" | "recovered" | "not-run" | "passed";
+declare const BOX_NOTIFY_EVENTS: readonly BoxNotifyEvent[];
+/** What a message can be about — the events plus the reminder. */
+type BoxNotifyState = BoxNotifyEvent | "still-failing";
+declare const BOX_NOTIFY_STATES: readonly BoxNotifyState[];
+/** A credential as a page sees it: whether there is one. */
+interface BoxNotifySecret {
+    set: boolean;
+}
+interface BoxNotifyLastDelivery {
+    at: number;
+    outcome: "sent" | "failed";
+    error?: string;
+}
+interface BoxNotifyChannelCommon {
+    id: string;
+    name: string;
+    enabled: boolean;
+    lastDelivery?: BoxNotifyLastDelivery;
+}
+type BoxNotifyChannelView = BoxNotifyChannelCommon & ({
+    kind: "slack";
+    webhookUrl: BoxNotifySecret;
+} | {
+    kind: "telegram";
+    botToken: BoxNotifySecret;
+    chatId: string;
+    threadId?: string;
+}
+/** Header VALUES are credentials (the receiver's `Authorization`,
+ *  most of the time): the view keeps the names and says `{ set }`. */
+ | {
+    kind: "webhook";
+    url: string;
+    secret: BoxNotifySecret;
+    headers?: Record<string, BoxNotifySecret>;
+});
+interface BoxNotifyRule {
+    id: string;
+    name?: string;
+    enabled: boolean;
+    /** Absent = every environment of the project. */
+    environments?: string[];
+    triggers: BoxNotifyTriggerKind[];
+    events: BoxNotifyEvent[];
+    /** Channel ids. */
+    channels: string[];
+    afterFailures: number;
+    /** Milliseconds. */
+    repeatEvery?: number;
+}
+type BoxNotifyMuteScope = {
+    series: string;
+} | {
+    project: true;
+};
+interface BoxNotifyMute {
+    id: string;
+    scope: BoxNotifyMuteScope;
+    /** Unix milliseconds; absent = until unmuted. */
+    until?: number;
+    by: string;
+    reason?: string;
+    at: number;
+}
+interface BoxNotifyQuietHours {
+    from: string;
+    to: string;
+    /** IANA zone. */
+    tz: string;
+}
+interface BoxNotifyProjectView {
+    project: string;
+    channels: BoxNotifyChannelView[];
+    rules: BoxNotifyRule[];
+    mutes: BoxNotifyMute[];
+    quietHours?: BoxNotifyQuietHours;
+}
+interface BoxNotifyView {
+    projects: BoxNotifyProjectView[];
+}
+/** One series of the ledger, as the page's table shows it. */
+interface BoxNotifySeriesEntry {
+    /** `<project>/<environment>/<kind>:<name>`. */
+    key: string;
+    environment: string;
+    target: {
+        kind: "collection" | "scenario";
+        name: string;
+    };
+    state: "ok" | "failed";
+    /** The daemon's word for why (`tests-failed`, `not-arrived`, …). */
+    reason: string;
+    since: number;
+    failures: number;
+    lastNotifiedAt?: number;
+    /** The mute covering it now, if any. */
+    mute?: BoxNotifyMute;
+}
+interface BoxNotifySeriesView {
+    project: string;
+    series: BoxNotifySeriesEntry[];
+}
+/** The text a rule would send for one state — the daemon renders it from
+ *  a made-up run so the page can show it next to the rule. */
+interface BoxNotifyPreview {
+    state: BoxNotifyState;
+    title: string;
+    lines: string[];
+    url?: string;
+}
+/** `POST …/test` — what happened to the test event. */
+type BoxNotifyTestResult = 
+/** `note` — a caveat on a delivery that went through: the channel is
+ *  switched off, so real events will not follow yet. */
+{
+    status: "sent";
+    channel: string;
+    note?: string;
+} | {
+    status: "failed";
+    channel: string;
+    message: string;
+};
+/** What a write answers with: which record, and what became of it. */
+interface BoxNotifyChanged {
+    status: "created" | "updated" | "removed";
+    id: string;
+}
+/** `PUT …/channels/<id>`. On an update a secret left out is KEPT — the
+ *  page never has the value to send back; on a create it is required. */
+type BoxNotifyChannelWrite = {
+    name: string;
+    enabled?: boolean;
+} & ({
+    kind: "slack";
+    webhookUrl?: string;
+} | {
+    kind: "telegram";
+    botToken?: string;
+    chatId: string;
+    threadId?: string;
+} | {
+    kind: "webhook";
+    url: string;
+    secret?: string;
+    headers?: Record<string, string>;
+});
+interface BoxNotifyEnabledPatch {
+    enabled: boolean;
+}
+/** `PUT …/rules/<id>`. `enabled` absent keeps the rule's switch as it is
+ *  (a new rule is on). */
+interface BoxNotifyRuleWrite {
+    name?: string;
+    enabled?: boolean;
+    environments?: string[];
+    triggers?: BoxNotifyTriggerKind[];
+    events?: BoxNotifyEvent[];
+    channels: string[];
+    afterFailures?: number;
+    repeatEvery?: number;
+}
+interface BoxNotifyMuteWrite {
+    scope: BoxNotifyMuteScope;
+    until?: number;
+    reason?: string;
+}
+type BoxNotifyQuietHoursWrite = BoxNotifyQuietHours;
+/** Why a notify request was refused. A code, not a message — the CLI and
+ *  the page turn each into their own advice. */
+type BoxNotifyErrorCode = 
+/** No actor on the session door. */
+"unauthorized" | "unknown-project" | "unknown-channel" | "unknown-rule" | "unknown-mute" | "unknown-series"
+/** The body is not what the route takes, or the daemon's schema refused
+ *  it (a rule naming no channel, a duplicate name, a bad zone). */
+ | "malformed" | "storage";
+interface BoxNotifyError {
+    error: {
+        code: BoxNotifyErrorCode;
+        message: string;
+    };
+}
+declare function parseBoxNotifyView(value: unknown): BoxNotifyView | null;
+declare function parseBoxNotifyProjectView(value: unknown): BoxNotifyProjectView | null;
+declare function parseBoxNotifySeriesView(value: unknown): BoxNotifySeriesView | null;
+declare function parseBoxNotifyPreview(value: unknown): BoxNotifyPreview | null;
+declare function parseBoxNotifyTestResult(value: unknown): BoxNotifyTestResult | null;
+declare function parseBoxNotifyChanged(value: unknown): BoxNotifyChanged | null;
+/** The daemon's refusal, or null when the body is not one of ours. */
+declare function parseBoxNotifyError(value: unknown): BoxNotifyError | null;
+declare function isBoxNotifyState(value: unknown): value is BoxNotifyState;
+/** The trigger a preview is rendered with, from a rule's first trigger —
+ *  kept here so the daemon and the page name the same sample actor. */
+declare function boxNotifyPreviewTrigger(kind: BoxNotifyTriggerKind): RunTrigger;
+declare function parseBoxNotifyMuteScope(value: unknown): BoxNotifyMuteScope | null;
+
 /** The personal read token, for people and agents that would rather not
  *  repeat it on every command line. Deliberately NOT `UNOTEST_BOX_TOKEN`
  *  (see {@link BOX_TOKEN_ENV}): one is the project's push credential, the
@@ -1645,14 +2041,40 @@ type BoxReadErrorCode =
  *  and the right response is to wait — which is why it is not folded
  *  into "could not reach the box", whose advice is to check the URL. */
  | "unavailable"
+/** A cloud-minted token whose `exp` has passed, with nothing else wrong
+ *  with it: this box's operator key signed it, for the right kind, for
+ *  this box. Its own code because the answer differs from every other
+ *  refusal — ask the cloud for another pair and retry, rather than "this
+ *  credential is wrong". Only the holder of a genuinely signed token for
+ *  THIS box ever sees it, so it tells a guesser nothing. */
+ | "expired"
+/** The box cannot judge a cloud-minted token yet: it has never read the
+ *  operator's revocation list, and a token that cannot be checked against
+ *  it is refused rather than trusted. A state of the BOX, not of the
+ *  token — which is why it is not folded into `unauthorized`: the answer
+ *  is to send the same token again shortly ({@link
+ *  BoxReadErrorBody.error.retryAfterSeconds}, and a `Retry-After`
+ *  header), never to mint a new one. */
+ | "revocation-list-unavailable"
 /** Not a readable request. */
  | "malformed";
+/** How long a box asks a caller to wait before presenting the same token
+ *  again after {@link BoxReadErrorCode} `revocation-list-unavailable`. One
+ *  number for both doors of a box — the guard's read door and the daemon's
+ *  push door — because a client that meets one meets the other on the same
+ *  box in the same state. Roughly a tick of the updater, which is what has
+ *  to happen for the answer to change. */
+declare const BOX_REVOCATIONS_RETRY_AFTER_SECONDS = 60;
 /** The body of a refusal. Named `…Body` because the CLIENT's exception
  *  class is `BoxReadError` — this is the JSON it was built from. */
 interface BoxReadErrorBody {
     error: {
         code: BoxReadErrorCode;
         message: string;
+        /** How long to wait before sending the SAME request again. Only on the
+         *  refusals that are worth retrying unchanged — today
+         *  `revocation-list-unavailable`; the header carries the same number. */
+        retryAfterSeconds?: number;
     };
 }
 /** Parse a refusal. Null when the body is not one of ours — an HTML
@@ -1665,6 +2087,55 @@ declare function parseBoxReadError(value: unknown): BoxReadErrorBody | null;
  *  not recognise is not a box answering. */
 declare function parseBoxReadEnvironments(value: unknown): BoxReadEnvironment[] | null;
 
+declare const BOX_RUNS_SEGMENT = "runs";
+/** Set by the guard, forwarded by the viewer verbatim, verified by the
+ *  daemon: WHO clicked, in a form the thing in between cannot write.
+ *  Named here because three packages have to spell it identically and
+ *  this is the one they all already depend on — the signing and the
+ *  verification live on the box side (`@unotest/box-kit`), which is
+ *  where the secret is. */
+declare const ACTOR_TICKET_HEADER = "x-unotest-actor-ticket";
+/** Set by the guard on its own requests to the daemon. The daemon reads
+ *  the actor label only next to a valid one. */
+declare const GUARD_SECRET_HEADER = "x-unotest-guard-secret";
+/** `/api/box/envs/<project>/<env>/runs`. */
+declare function boxRunsPath(project: string, environment: string): string;
+/** `/api/box/envs/<project>/<env>/runs/<runId>`. */
+declare function boxRunPath(project: string, environment: string, runId: string): string;
+/** What the viewer asks for. Deliberately not the viewer's own
+ *  `RunRequest`: that one carries local concerns (worker counts, debug
+ *  flags) the box decides for itself, and a box route that accepted them
+ *  would be a second way to configure a run. */
+interface BoxRunRequest {
+    kind: "collection" | "scenario";
+    /** Collection name, or a scenario ref (`folder/test`). */
+    ref: string;
+}
+/** The daemon accepted the ticket. The run has NOT started — on a busy
+ *  box it may wait behind a suite for a while, which is the whole point
+ *  of there being one queue.
+ *
+ *  No ticket name: the queue's file names are the box's own business,
+ *  and stopping a run goes back through `DELETE …/runs/<runId>` rather
+ *  than through the queue directly. The run id is the only handle a
+ *  caller needs, and the only one it is given. */
+interface BoxRunAccepted {
+    runId: string;
+    acceptedAt: number;
+}
+type BoxRunState = "queued" | "running" | "finished";
+interface BoxRunStatus {
+    runId: string;
+    state: BoxRunState;
+    /** Present once the run ended. `null` when it died on a signal. */
+    exitCode?: number | null;
+    startedAt?: number;
+    finishedAt?: number;
+}
+declare function parseBoxRunRequest(value: unknown): BoxRunRequest | null;
+declare function parseBoxRunAccepted(value: unknown): BoxRunAccepted | null;
+declare function parseBoxRunStatus(value: unknown): BoxRunStatus | null;
+
 declare const WORKSPACE_SCHEMA_VERSION = 1;
 /** Written by the host beside the artifacts it manages:
  *  `<artifactsRoot>/unotest/.workspace.json`. In the artifact tree and
@@ -1927,55 +2398,6 @@ interface CollectionMeta {
     prepare: string | null;
 }
 
-declare const RUN_MANIFEST_FILE = "manifest.json";
-interface RunManifest {
-    /** Format-version of this manifest. Bump only on breaking schema
-     *  changes — additive optional fields don't require it. Starts at 1. */
-    schemaVersion: 1;
-    /** Identifies which RunRequest variant produced this run. */
-    kind: RunKind;
-    /** Original (un-sanitized) `ref` from the request — scenario `name`
-     *  for `kind:"scenario"`, collection `name` for `kind:"collection"`.
-     *  The `runId` directory uses a sanitized form; this carries the
-     *  human-readable original. */
-    ref: string;
-    /** Run-id of the parent collection-run when this is a child scenario
-     *  spawned inside a collection. Absent for top-level scenario-runs
-     *  and for collection-runs themselves. */
-    parentRunId?: string;
-    /** Adapter `name` that produced this run (`"@unotest/web"`,
-     *  `"@unotest/mobile"`). Lets the viewer pick rendering details for
-     *  runner-specific bundle contents without runner branches in core
-     *  logic. */
-    adapter: string;
-    /** Wallclock at runner start. Distinct from the first event's `t`
-     *  (which may have leading delay for adapter setup). */
-    startedAt: number;
-    /** Environment name the run resolved (`UNOTEST_ENV` / `--env`), absent
-     *  for base. Self-description only — placement already encodes it (the
-     *  run lives under `.runs<suffix>.<env>`), so nothing filters on this. */
-    env?: string;
-    /** Opt-in artifact-capture flags as resolved from the runner's env at
-     *  start (`UNOTEST_CONSOLE` / `UNOTEST_NETWORK`). Recorded here so the
-     *  viewer can tell "capture was disabled" apart from "capture was on but
-     *  the run aborted before writing console.json / network.json" — a
-     *  distinction the mere presence of those files can't make. Optional: runs
-     *  produced before this field existed simply omit it, and the viewer falls
-     *  back to a file-presence heuristic. */
-    capture?: {
-        console: boolean;
-        network: boolean;
-    };
-    /** Which test bundle produced this run, when the sources came from one
-     *  (`UNOTEST_BUNDLE_ID`, set by a box). Absent for every local run,
-     *  where the sources are simply the working directory.
-     *
-     *  Recorded so history stays readable after the fact: a box runs many
-     *  bundles into one environment, and "which code produced this red
-     *  run" is otherwise unanswerable once the environment moved on. */
-    bundleId?: string;
-}
-
 /** Snapshot file holding entry + every helper source that was loaded. */
 declare const RUN_SOURCES_FILE = "sources.json";
 interface RunSources {
@@ -2346,6 +2768,17 @@ declare function removeEnvVar(content: string, key: string): {
     content: string;
     removed: boolean;
 };
+/**
+ * Replace the value of an existing `KEY=…` line in place — same line,
+ * same neighbours, same comments. Returns `replaced: false` and the
+ * content untouched when no assignment for `key` exists; the caller then
+ * inserts (see `insertEnvVar`). Together they are an upsert that never
+ * moves a variable a person placed deliberately.
+ */
+declare function replaceEnvVar(content: string, key: string, value: string): {
+    content: string;
+    replaced: boolean;
+};
 
 /** Which group the user is adding into. App/runner → `.env`, secret →
  *  `.secrets`. Mirrors VariableCategory as an INPUT (the user's choice). */
@@ -2894,4 +3327,4 @@ declare const JUDGE_ENV: {
     readonly skipPreflight: "UNOTEST_JUDGE_SKIP_PREFLIGHT";
 };
 
-export { ARTIFACTS_ROOT_ENV, type AddVariablePlan, type AddVariablePlanInput, type AppPathPickerSpec, type AppServerEvent, type AuthoringRunRequest, BLOBS_DIR, BOX_ENV_VALUES_SEGMENT, BOX_READ_ENVIRONMENTS_PATH, BOX_READ_ENVIRONMENT_HEADER, BOX_READ_TOKEN_ENV, BOX_READ_TOKEN_PREFIX, BOX_REVEAL_SEGMENT, BOX_SECRET_NAMES_ENV, 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 BoxReadEnvironment, type BoxReadErrorBody, type BoxReadErrorCode, 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 BundleUploadError, type BundleUploadErrorCode, type BundleUploadOk, type BundleUploadResponse, type BundleUploadStatus, type BundleVariableGap, CI_RUN_PATH, 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 CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionScheduleEntry, type CollectionTab, DAY_INDEX_FILE, DAY_SHORT, 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 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, FREQ_FIELDS, type FailureBundleWrittenEvent, type FsBreakpointsChangedMessage, type FsCollectionRunStepMessage, type FsCollectionsChangedMessage, type FsHelpersChangedMessage, type FsRunFinishedMessage, type FsRunStartedMessage, type FsRunStepMessage, type FsScenariosChangedMessage, 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_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_INDEX_SCHEMA_VERSION, RUN_MANIFEST_FILE, RUN_SOURCES_FILE, 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, 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 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, WEEK_CHIP_ORDER, WORKSPACE_FILE, WORKSPACE_SCHEMA_VERSION, type WheelChangedEvent, type WorkspaceBundle, type WorkspaceFile, type WsMessage, type WsMessageKind, activeEnvName, artifactsRootFrom, blobPathFor, blobRelPathFor, blobRelSegmentsFor, blobsRootFor, boxEnvSecretRevealPath, boxEnvSecretsRevealPath, boxEnvValuePath, boxEnvValuesPath, boxValueKindOfSegment, boxValuePath, boxValuesPath, canonicalScheduleSet, categorizeVariable, compareQueueTicketNames, cronFromSpec, debugDirFor, debuggerFileFor, declaredEnvKeys, decodeNameList, deleteShadowWarning, describeBundle, describeCron, describeSpec, describeTicketCi, encodeNameList, envFileFor, envKeys, envLayerFilesFor, envNamesFromDirListing, foldScenarioRun, formatNextTick, insertEnvVar, isAnnotationLine, isEnvVarName, isExternalVarName, isFailingStatus, isQueueDirName, isRecord, isRegexLiteral, isRunnerConfigKey, isRunnerSetting, isRunsDirName, isTerminalRuntimeState, makeQueueTicketName, makeRunId, mergeSchedules, nextTickFromSpec, parseAppServerEvent, parseBoxEnvValuesReplaceRequest, parseBoxReadEnvironments, parseBoxReadError, parseBoxSecretRevealResponse, parseBoxSecretsRevealResponse, parseBoxValueSetRequest, parseBoxValuesReplaceRequest, parseBoxValuesResponse, parseBundleManifest, parseBundleUploadResponse, parseCiProvider, parseCiRunRequest, parseCiRunResponse, parseEnvContent, parseQueueTicket, parseQueueTicketName, parseScenarioAnnotations, parseScheduleEntry, parseSchedulesDoc, parseSchedulesJson, parseWorkspaceFile, planAddVariable, projectQueueRoot, projectRunDirFor, projectRunsRoot, queueDirFor, queuePriorityFromRank, queuePriorityRank, regexLiteral, removeEnvVar, requireRunDirFor, reservedBoxValueNames, runDirFor, runIdStartedAt, runsDirFor, sanitizeRunIdSegment, scenarioIndexFileName, scenarioRefFromFileName, scheduleTarget, secretsFileFor, secretsLayerFilesFor, serializeEnvValue, shardDaysDescending, shardDirFor, shardPathForRunId, shardPathForTimestamp, specFromCron, testDirFor, validateCollectionName, validateSegmentName };
+export { ACTOR_TICKET_HEADER, ARTIFACTS_ROOT_ENV, type AddVariablePlan, type AddVariablePlanInput, type AppPathPickerSpec, type AppServerEvent, type AuthoringRunRequest, BLOBS_DIR, 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 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 BundleUploadError, type BundleUploadErrorCode, type BundleUploadOk, type BundleUploadResponse, type BundleUploadStatus, type BundleVariableGap, CI_RUN_PATH, 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 CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionScheduleEntry, type CollectionTab, DAY_INDEX_FILE, DAY_SHORT, 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 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 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_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 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, WEEK_CHIP_ORDER, WORKSPACE_FILE, WORKSPACE_SCHEMA_VERSION, type WheelChangedEvent, type WorkspaceBundle, type WorkspaceFile, type WsMessage, type WsMessageKind, activeEnvName, 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, foldScenarioRun, formatNextTick, insertEnvVar, isAnnotationLine, isBoxNotifyState, isEnvVarName, isExternalVarName, isFailingStatus, isQueueDirName, isRecord, isRegexLiteral, isRunnerConfigKey, isRunnerSetting, isRunsDirName, isTerminalRuntimeState, makeQueueTicketName, makeRunId, manifestTrigger, mergeSchedules, nextTickFromSpec, parseAppServerEvent, parseBoxEnvValuesReplaceRequest, parseBoxNotifyChanged, parseBoxNotifyError, parseBoxNotifyMuteScope, parseBoxNotifyPreview, parseBoxNotifyProjectView, parseBoxNotifySeriesView, parseBoxNotifyTestResult, parseBoxNotifyView, parseBoxReadEnvironments, parseBoxReadError, parseBoxRunAccepted, parseBoxRunRequest, parseBoxRunStatus, parseBoxSecretRevealResponse, parseBoxSecretsRevealResponse, parseBoxValueSetRequest, parseBoxValuesReplaceRequest, parseBoxValuesResponse, parseBundleManifest, parseBundleUploadResponse, parseCiProvider, parseCiRunRequest, parseCiRunResponse, 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 };