@unotest/protocol 0.6.2 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `@unotest/protocol` are documented in this file.
 
+## [0.9.0] - 2026-06-11
+
+### Added
+
+- **`ScenariosPayload`** — the `GET /api/scenarios` response now carries both
+  the scenario list and the folder list (including empty dirs), so the viewer's
+  tree can render and manage folders.
+- **`validateSegmentName`** — shared scenario-file-stem / folder-name validation
+  (single FS-safe path segment), used by both the viewer-server writer and the
+  client form.
+
+### Changed
+
+- **`RUNNER_CONFIG_KEYS`** now includes `UNOTEST_NETWORK` and `UNOTEST_CONSOLE`,
+  so the viewer's Variables panel groups them under "Runner config" rather than
+  app data.
+
 ## [0.6.2] - 2026-06-05
 
 Maintenance release: version bump to keep the `@unotest` ecosystem in

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Readable } from 'node:stream';
+
 /** User-facing project directory containing scenarios + helpers + collections. */
 declare const UNOTEST_DIR = "unotest";
 /** Subdir under `unotest/` for `.test.js` scenarios. */
@@ -37,6 +39,12 @@ declare const COMMANDS_FILE = "commands.jsonl";
  *  from the page-snapshot (semantic-DOM YAML) which lives in
  *  failure-bundles. */
 declare const RUNTIME_FILE = "runtime.json";
+/** Read-only page-outline snapshot the in-page picker overlay hit-tests
+ *  against, written by the runner when the picker arms (and on self-heal).
+ *  Lives at `unotest/.runs/<runId>/picker-snapshot.txt`. The viewer's
+ *  Snapshot inspector tab fetches it via the run-dir asset endpoint to show
+ *  "what the picker sees" for diagnosing ref/coverage gaps. */
+declare const PICKER_SNAPSHOT_FILE = "picker-snapshot.txt";
 /** Per-project shared breakpoint store. Path is relative to project root
  *  (NOT under `unotest/.runs/`). Schema: `BreakpointsFile` in
  *  `protocol/breakpoints-file.ts`. */
@@ -44,6 +52,19 @@ declare const DEBUGGER_FILE = "unotest/.debugger.json";
 /** Project env file edited by the viewer's env-variable editor. Relative
  *  to project root. Surfaced as `EnvFile` (`protocol/env-file.ts`). */
 declare const ENV_FILE = "unotest/.env";
+/** Secret scenario variables, beside `.env` under `unotest/`. Same KEY=VALUE
+ *  format; secrecy is a property of THIS file (not a name heuristic). */
+declare const SECRETS_FILE = "unotest/.secrets";
+/** Per-environment overlay file for `.env` / `.secrets`. `unotest/.env`
+ *  (+ `.secrets`) hold shared defaults; `unotest/.env.<name>` overrides them
+ *  for a named environment (`staging`, `production`, …), selected at run time
+ *  via `UNOTEST_ENV` / `--env`. Overlay wins over base; ambient process.env
+ *  still wins over both. No env name → base file only. */
+declare function envFileFor(envName?: string): string;
+declare function secretsFileFor(envName?: 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;
 
 interface RegexLiteral {
     readonly kind: "regex";
@@ -137,8 +158,19 @@ interface CollectionRunRequest {
     /** Stop on first failure. Default `false` (continue-on-fail). */
     bail?: boolean;
 }
+/** Open a live AUTHORING-HOLD session (collaborative model, U1/U3): a
+ *  headed shared browser + draft stay open with NO running test; the human
+ *  and agent co-author the draft. Runs `unotest-web author <scenario>`. */
+interface AuthoringRunRequest {
+    kind: "authoring";
+    /** Scenario `name` — file stem relative to `unotest/e2e/`. A stub is
+     *  created if the file doesn't exist yet. */
+    scenario: string;
+    /** Authoring is visible by default — the human must see the live browser. */
+    headed?: boolean;
+}
 /** Discriminated union of every run-shape the viewer can request. */
-type RunRequest = ScenarioRunRequest | CollectionRunRequest;
+type RunRequest = ScenarioRunRequest | CollectionRunRequest | AuthoringRunRequest;
 /** All `kind` literals — useful for switch-completeness checks and for
  *  adapter `supportedKinds` lists. */
 type RunKind = RunRequest["kind"];
@@ -225,6 +257,57 @@ declare class RunnerNotConfiguredError extends Error {
     constructor(message: string);
 }
 
+/** Parsed scenario metadata from the mandatory header lines
+ *  (per design-v0/decisions.md, "Test source format"):
+ *
+ *      // id-<kebab-slug>
+ *      // <human title>
+ *      // #<6-hex-color>
+ *      function test_<...>() { ... }
+ *
+ *  All three lines are required; a file without a complete header is
+ *  rejected by the discovery service as parse-error (no legacy fallback). */
+interface ScenarioMeta {
+    /** Slug from `// id-<slug>`. Stable test identity across rename. */
+    id: string;
+    /** Human-readable title from `// <text>`. */
+    title: string;
+    /** Color identifier from `// #RRGGBB`. Used only in tab headers as a
+     *  thin colored strip — NOT a status signal. */
+    color: string;
+    /** File stem relative to `unotest/e2e/`, dirs as slashes.
+     *  Examples: `smoke-welcome`, `auth/signin-flow`.
+     *  Source-of-truth identity for CLI invocations and tab keys. */
+    name: string;
+    /** Project-relative path to the source file. */
+    path: string;
+}
+
+/** Response of `GET /api/scenarios`. Folders are listed independently of
+ *  the scenarios so an EMPTY directory under `unotest/e2e/` still renders
+ *  in the tree (the folder list isn't inferred from scenario paths). */
+interface ScenariosPayload {
+    scenarios: ScenarioMeta[];
+    /** Directory paths relative to `unotest/e2e/`, posix-separated, any
+     *  depth (e.g. `auth`, `auth/signup`, `autopark`). Excludes reserved
+     *  subtrees (`_helpers`, `_collections`) and any `_`/`.`-prefixed dir. */
+    folders: string[];
+}
+/** Filesystem-unsafe characters in a single path segment. Includes the
+ *  path separators (`\` `/`) so a valid segment is guaranteed to be ONE
+ *  level — no nesting smuggled through a name. Mirrors the block-list
+ *  rationale of `validateCollectionName`. */
+declare const SEGMENT_NAME_FORBIDDEN_RE: RegExp;
+/** Validate a single scenario-file stem or folder name. Returns `null` on
+ *  success, else a human-readable reason. Shared by the viewer-server
+ *  writer (authoritative) and the client form (pre-flight) so both agree.
+ *  Pure — safe to bundle in the browser.
+ *
+ *  Rejects: empty, `.`/`..`, `.`-prefix (hidden), `_`-prefix (reserved for
+ *  `_helpers`/`_collections`/templates), path separators + FS-unsafe
+ *  punctuation + control chars. */
+declare function validateSegmentName(name: string): string | null;
+
 /** Session profile — the kind of process a tab spawns. Mirrored by the
  *  viewer's TerminalStore.TermKind. */
 type TerminalKind = "local" | "claude" | "codex";
@@ -275,6 +358,222 @@ type TerminalServerMessage = TerminalOutputMessage | TerminalExitMessage | Termi
  *  directions use this single event name on `/ws/terminal`. */
 declare const TERMINAL_WS_EVENT = "terminal";
 
+type VariableCategory = "secret" | "app" | "runner";
+/** User-facing runner-config knobs documented in `unotest/.env`. Single source
+ *  of truth for "is this name our config?" — drives the viewer's "Runner
+ *  config" group and the add-variable dropdown.
+ *
+ *  NOT listed (so they never surface as user config): launcher-injected
+ *  run-control vars (UNOTEST_RUN_ID, UNOTEST_PARENT_RUN_ID,
+ *  UNOTEST_BUSY_SCENARIOS, UNOTEST_WORKER_*), session-log internals
+ *  (UNOTEST_SESSION_LOG_*), and path bootstrap (UNOTEST_DIR,
+ *  UNOTEST_PROJECT_ROOT, UNOTEST_CONFIG, UNOTEST_VIEWER_NO_OPEN). A user would
+ *  never put those in `unotest/.env`. */
+declare const RUNNER_CONFIG_KEYS: ReadonlySet<string>;
+/** True when `name` is a key the runner consumes as its own configuration. */
+declare function isRunnerConfigKey(name: string): boolean;
+/** Group a variable for the viewer. Secrecy from the source file; runner-vs-app
+ *  from the owned-key set. */
+declare function categorizeVariable(v: {
+    name: string;
+    source: "env" | "secrets";
+}): VariableCategory;
+/** An external scenario variable is referenced by a bare UPPER_SNAKE
+ *  identifier (`APP_BASE_URL`). App / secret names must match this to be
+ *  resolvable from a scenario; runner keys are validated against the set
+ *  above instead. Convention only — no value inspection. */
+declare function isExternalVarName(name: string): boolean;
+
+/** Quote on write only when the value would otherwise be ambiguous (spaces,
+ *  `#`, quotes, `=`, backslash, leading backtick, or newlines). Plain tokens
+ *  stay unquoted. Mirrors the viewer env-dotenv serializer. */
+declare function serializeEnvValue(value: string): string;
+/** Active (non-commented) assignment keys present in env-file `content`.
+ *  Used to detect duplicates / cross-file shadowing before an add. */
+declare function envKeys(content: string): Set<string>;
+/**
+ * Insert `KEY=VALUE` into env-file `content`. With `sectionLabel`, the line
+ * goes into the first `# --- <label> --- ` divider section — after the last
+ * assignment there (or its description comments if it has no vars yet). The
+ * label is matched as a whole word against DIVIDER lines only, so prose
+ * comments are never mistaken for a section. No such section → it is created
+ * at end-of-file. With no label the line is appended. Does NOT dedup — reject
+ * duplicates before calling.
+ */
+declare function insertEnvVar(content: string, key: string, value: string, sectionLabel?: string): string;
+/**
+ * Remove the assignment line for `key`, leaving every comment and other line
+ * untouched (we do not guess which comments "belong" to the key). Returns the
+ * new content and whether anything was removed.
+ */
+declare function removeEnvVar(content: string, key: string): {
+    content: string;
+    removed: boolean;
+};
+
+/** Which group the user is adding into. App/runner → `.env`, secret →
+ *  `.secrets`. Mirrors VariableCategory as an INPUT (the user's choice). */
+type VariableKind = VariableCategory;
+interface AddVariablePlanInput {
+    name: string;
+    kind: VariableKind;
+    /** Current text of `unotest/.env` (`""` if absent). */
+    envContent: string;
+    /** Current text of `unotest/.secrets` (`""` if absent). */
+    secretsContent: string;
+}
+type VariablePlanError = {
+    ok: false;
+    code: "duplicate" | "invalid-name" | "unknown-runner-key";
+    message: string;
+};
+type AddVariablePlan = {
+    ok: true;
+    target: "env" | "secrets";
+    sectionLabel?: string;
+    warnings: string[];
+} | VariablePlanError;
+/**
+ * Decide where a new variable goes and what to warn about — or reject it.
+ * Reject reasons: duplicate key in the target file; a non-UPPER_SNAKE app/
+ * secret name (a scenario could never reference it); a runner key not in the
+ * owned-config allowlist. Warnings (non-fatal): secret shadowing a same-named
+ * `.env` var, or vice-versa.
+ */
+declare function planAddVariable(input: AddVariablePlanInput): AddVariablePlan;
+/**
+ * Warning to show after deleting `name` from the file: if the shell
+ * environment still defines it with a DIFFERENT value, it will keep
+ * resolving from there (set-if-absent means ambient wins). Comparing values
+ * avoids a false positive when `.env` was merely flattened into process.env.
+ */
+declare function deleteShadowWarning(name: string, fileValue: string | undefined, ambientValue: string | undefined): string[];
+
+/** A single editor diagnostic. Superset of the `@unotest/dsl`
+ *  validator diagnostic: it unifies parse errors, the vocab validator,
+ *  and the platform linter behind one shape, tagged by `source`/`rule`
+ *  so consumers can theme or filter. Positions are 1-based; a parse
+ *  error with no recoverable position falls back to `1:1`. */
+interface DslDiagnostic {
+    severity: "error" | "warning" | "info";
+    /** 1-based line. */
+    line: number;
+    /** 1-based column. */
+    column: number;
+    /** 1-based end line, when the producer knows the span. */
+    endLine?: number;
+    /** 1-based end column, when the producer knows the span. */
+    endColumn?: number;
+    message: string;
+    /** Stable rule id, e.g. `"validator:unknown-function"`, `"validator:dsl"`,
+     *  a linter rule id, or `"parse"`. */
+    rule: string;
+    /** Which stage produced it — lets the UI group / colour by origin. */
+    source: "parse" | "validate" | "lint";
+}
+/** Coarse grouping for a vocab entry — drives completion icons and
+ *  ordering. `keyword` covers DSL control-flow / block words (`step`,
+ *  `if`, `for`, …); `helper` covers project-defined `flow_*` / mock
+ *  helpers surfaced from the workspace. */
+type DslVocabCategory = "action" | "assertion" | "selector" | "chain" | "navigation" | "read" | "wait" | "state" | "storage" | "multi-context" | "sandbox" | "escape-hatch" | "keyword" | "helper";
+/** One declared argument of a vocab entry — feeds signature help and
+ *  the snippet placeholders in `insertText`. `kind` is the validator's
+ *  arg-kind string (`"locatorLike"`, `"stringLike"`, `"number"`,
+ *  `"any"`, …); the editor treats it as an opaque label. */
+interface DslVocabArg {
+    label: string;
+    kind: string;
+    required: boolean;
+}
+/** A single autocomplete-able item: a vocab function, a DSL keyword, or
+ *  a project helper. Serializable — crosses the REST boundary verbatim
+ *  and is cached by the browser (the vocab is static per platform). */
+interface DslVocabEntry {
+    name: string;
+    category: DslVocabCategory;
+    args: DslVocabArg[];
+    /** Return-kind string (`"void"`, `"string"`, `"locator"`, …). */
+    returns: string;
+    /** Snippet body with `${n:label}` placeholders, e.g.
+     *  `click(${1:locator})`. */
+    insertText: string;
+    /** Human-readable signature for hover / signature-help, e.g.
+     *  `getByRole(role, { name?, exact? })`. Richer than the bare arg
+     *  list — includes option-object shape. */
+    signature?: string;
+    /** Prose description (markdown) for hover and the completion info
+     *  panel. */
+    doc?: string;
+    /** Locator capability from the function contract. `"chainableLocator"`
+     *  entries can be chained off a locator (offered after `.`); any value
+     *  other than `"none"` produces a locator (so it fits a `locator`
+     *  argument slot). Absent for keywords / helpers that have no contract. */
+    locatorCapability?: "none" | "locator" | "chainableLocator";
+}
+/** Per-request file context for {@link IDslLanguageService.validate}.
+ *  The viewer owns workspace discovery, so it supplies the things the
+ *  platform validator can't know on its own. */
+interface DslValidateContext {
+    /** Names of project helpers (`flow_*`, mocks) so their calls are not
+     *  flagged as unknown functions — mirrors how the lint runner
+     *  registers `unotest/e2e/_helpers/`. */
+    helperNames?: readonly string[];
+    /** Whether the source is a scenario or a helper definition file. */
+    fileKind?: "scenario" | "helper";
+}
+/** The DSL language service a platform exposes to the viewer. Two
+ *  concerns only: the static vocabulary (for completion / signature
+ *  help) and full source validation (parse + vocab validator + linter,
+ *  identical to the platform's own lint gate). */
+interface IDslLanguageService {
+    /** Static, serializable vocabulary for autocomplete and signature
+     *  help. Stable for the lifetime of the process — safe to cache. */
+    getVocab(): DslVocabEntry[];
+    /** Full diagnostics for one source string. Pure with respect to the
+     *  filesystem — all workspace knowledge arrives via `ctx`. */
+    validate(source: string, ctx?: DslValidateContext): DslDiagnostic[];
+}
+
+/** A spawned runner process. Structural superset of the bits of a Node
+ *  `ChildProcess` the viewer actually consumes — pid for the active-run
+ *  snapshot, stdout/stderr for log capture, exit/error for finalize,
+ *  kill for abort. Both `child_process` and Electron `utilityProcess`
+ *  satisfy this via a thin adapter. */
+interface ILaunchedProcess {
+    /** OS process id, or -1 if the spawn failed to produce one. */
+    readonly pid: number;
+    /** Captured stdout stream, or null when not piped. */
+    readonly stdout: Readable | null;
+    /** Captured stderr stream, or null when not piped. */
+    readonly stderr: Readable | null;
+    /** Register the exit handler. Called once when the process exits. */
+    onExit(cb: (code: number | null, signal: NodeJS.Signals | null) => void): void;
+    /** Register the spawn-error handler (e.g. bin not found). */
+    onError(cb: (err: Error) => void): void;
+    /** Terminate the process. Default signal SIGTERM. */
+    kill(signal?: NodeJS.Signals): void;
+}
+/** Everything the launcher needs to spawn one runner process. The caller
+ *  (RunnerService) has already merged the environment and resolved the bin
+ *  + argv from the `IRunnerAdapter`; the launcher only decides HOW to run
+ *  it. Pure data — no behaviour. */
+interface LaunchSpec {
+    /** Absolute path to the JS bin entry — `IRunnerAdapter.resolveBin()`. */
+    bin: string;
+    /** Argv to pass after the bin — `IRunnerAdapter.buildArgs(req)`. */
+    args: string[];
+    /** Fully-merged environment for the child. */
+    env: NodeJS.ProcessEnv;
+    /** Working directory — the workspace project root. */
+    cwd: string;
+}
+/** Spawns the runner JS under a Node-capable runtime. Injected into the
+ *  viewer's RunnerService so the spawn mechanism (system Node vs Electron
+ *  utilityProcess) is a deployment choice, not baked into the service. */
+interface IProcessLauncher {
+    launch(spec: LaunchSpec): ILaunchedProcess;
+}
+
 /** Contents of `unotest/.viewer.lock`. Written by viewer-server on
  *  startup, removed on graceful shutdown. Stale detection: `process.kill(
  *  pid, 0)` throws ESRCH if PID is dead → lockfile is stale, safe to
@@ -289,32 +588,6 @@ interface LockFile {
     startedAt: string;
 }
 
-/** Parsed scenario metadata from the mandatory header lines
- *  (per design-v0/decisions.md, "Test source format"):
- *
- *      // id-<kebab-slug>
- *      // <human title>
- *      // #<6-hex-color>
- *      function test_<...>() { ... }
- *
- *  All three lines are required; a file without a complete header is
- *  rejected by the discovery service as parse-error (no legacy fallback). */
-interface ScenarioMeta {
-    /** Slug from `// id-<slug>`. Stable test identity across rename. */
-    id: string;
-    /** Human-readable title from `// <text>`. */
-    title: string;
-    /** Color identifier from `// #RRGGBB`. Used only in tab headers as a
-     *  thin colored strip — NOT a status signal. */
-    color: string;
-    /** File stem relative to `unotest/e2e/`, dirs as slashes.
-     *  Examples: `smoke-welcome`, `auth/signin-flow`.
-     *  Source-of-truth identity for CLI invocations and tab keys. */
-    name: string;
-    /** Project-relative path to the source file. */
-    path: string;
-}
-
 /** Helper file metadata. Helpers live in `unotest/e2e/_helpers/**` as
  *  `snake_case` functions (`signin_as`, `seed_user`, …). The runner
  *  auto-discovers them; no import system in scenarios. */
@@ -325,6 +598,101 @@ interface HelperMeta {
     path: string;
 }
 
+/** Which kind of locator the in-page picker overlay should retarget to and
+ *  what DSL snippet to emit on pick. `locator` → an interactive element →
+ *  `click(<loc>)`; `text`/`visibility` → any named/interactive element →
+ *  `assertText`/`assertVisible`. See docs/recoder/plan.md. */
+type PickerMode = "locator" | "text" | "visibility";
+interface DbgCommandStep {
+    id: string;
+    cmd: "step";
+}
+interface DbgCommandContinue {
+    id: string;
+    cmd: "continue";
+}
+interface DbgCommandPause {
+    id: string;
+    cmd: "pause";
+}
+interface DbgCommandSetBp {
+    id: string;
+    cmd: "set-bp";
+    line: number;
+    col: number;
+}
+interface DbgCommandClearBp {
+    id: string;
+    cmd: "clear-bp";
+    line: number;
+    col: number;
+}
+interface DbgCommandAbort {
+    id: string;
+    cmd: "abort";
+}
+/** Start (or, if already active, re-mode) the in-page picker on the live
+ *  paused page. `execute=false` (default) is capture-only: clicks are
+ *  swallowed, never run — picks just record a locator/assertion.
+ *  `execute=true` turns the overlay into a Playwright-style recorder: real
+ *  clicks / typing / selects RUN on the page and are recorded as DSL actions
+ *  (`click`/`fill`/`press`/`selectOption`/`check`). In execute mode the
+ *  `text`/`visibility` modes still record an assertion without running the
+ *  click (swap mode to drop an assertion mid-flow). */
+interface DbgCommandPickerStart {
+    id: string;
+    cmd: "picker:start";
+    mode: PickerMode;
+    execute?: boolean;
+}
+/** Tear down the picker overlay. */
+interface DbgCommandPickerStop {
+    id: string;
+    cmd: "picker:stop";
+}
+/** On-demand: capture the current page outline (what the picker hit-tests
+ *  against) and write it to `picker-snapshot.txt`. Lets the viewer's Snapshot
+ *  tab show / refresh the snapshot without arming the picker. Cheap — runs
+ *  only when the user opens/refreshes the tab (the outline is expensive on
+ *  huge pages, so it is never captured on every pause). */
+interface DbgCommandSnapshot {
+    id: string;
+    cmd: "snapshot";
+}
+/** The DSL line a recorded action / pick renders to. Mirrors the in-page
+ *  recorder's verbs. `locator` → bare locator; `assertText`/`assertVisible`
+ *  → assertions; the rest → Playwright-style actions. */
+type RecordedActionKind = "locator" | "assertText" | "assertVisible" | "click" | "fill" | "press" | "selectOption" | "check" | "uncheck";
+/** Agent-driven, ref-safe record (collaborative authoring). The agent picks
+ *  an element by `ref` (from a snapshot of the SHARED page) + an action; the
+ *  runner resolves `ref→locator` (`RefResolver`) and emits a `locator:picked`
+ *  event the viewer inserts — so the agent NEVER hand-writes a locator. Same
+ *  resolution/insertion pipeline as the human's in-page picker. */
+interface DbgCommandRecord {
+    id: string;
+    cmd: "record";
+    ref: string;
+    action: RecordedActionKind;
+    /** Typed/selected value for `fill` / `selectOption`. */
+    value?: string;
+    /** Key for `press` (e.g. "Enter", "Control+A"). */
+    key?: string;
+    /** Expected text for `assertText` (else the element's textContent is used). */
+    text?: string;
+    /** Where the viewer drops the line. Default `append` (agent records a flow). */
+    placement?: "cursor" | "append";
+}
+/** Collaborative control token (Slice 3). Sets who may act on the shared
+ *  page: `agent` lets the agent record; `human` (default) blocks the agent.
+ *  Written by the viewer (Take control button) or the agent (take_wheel). */
+interface DbgCommandWheel {
+    id: string;
+    cmd: "wheel";
+    owner: "agent" | "human";
+}
+type DbgCommand = DbgCommandStep | DbgCommandContinue | DbgCommandPause | DbgCommandSetBp | DbgCommandClearBp | DbgCommandAbort | DbgCommandPickerStart | DbgCommandPickerStop | DbgCommandSnapshot | DbgCommandRecord | DbgCommandWheel;
+type DbgCommandKind = DbgCommand["cmd"];
+
 /** Terminal outcome reported by the runner via `run:finished`. */
 type RunOutcome = "completed" | "failed" | "aborted" | "interrupted";
 /** Scenario-level run-id. Format opaque to consumers; treat as string. */
@@ -427,6 +795,27 @@ interface PausedEvent extends RunArtifactBase {
         }[];
     };
 }
+/** Emitted by the in-page locator picker / action recorder (debug-pause)
+ *  when the user picks an element or performs a recorded action. The runner
+ *  resolved the picked `ref` to a locator (`RefResolver`) and rendered the
+ *  DSL snippet. The viewer inserts `snippet` per `placement`.
+ *  See docs/recoder/plan.md. */
+interface LocatorPickedEvent extends RunArtifactBase {
+    kind: "locator:picked";
+    mode: PickerMode;
+    /** Ready-to-insert DSL line, e.g. a bare locator
+     *  `getByRole("button", {name: "Sign in"})` (locator mode), an assertion
+     *  (`assertText(…)`), or a recorded action (`click(…)`, `fill(…)`). */
+    snippet: string;
+    /** Where the viewer drops the snippet:
+     *  - `cursor` — at the editor's caret (deliberate picks; user-placed).
+     *  - `append` — after the previous recorded line (execute-mode action
+     *    recorder, preserving order). */
+    placement: "cursor" | "append";
+    /** `stable` (testId / role+name / label / …) or `fragile` (css/nth-only).
+     *  Lets the viewer flag brittle picks. */
+    stability: "stable" | "fragile";
+}
 /** Emitted when execution resumes after a `paused` event. The `by` field
  *  records which debug command unblocked it — purely informational; the
  *  next `step:started` event carries the actual line/col. */
@@ -434,8 +823,14 @@ interface ResumedEvent extends RunArtifactBase {
     kind: "resumed";
     by: "step" | "continue";
 }
+/** Emitted when the collaborative control token changes owner (Slice 3), so
+ *  the viewer can live-update the "who's driving" badge over WS. */
+interface WheelChangedEvent extends RunArtifactBase {
+    kind: "wheel:changed";
+    owner: "agent" | "human";
+}
 /** Discriminated union of every JSONL event the scenario runner emits. */
-type RunArtifact = RunStartedEvent | StepStartedEvent | StepOkEvent | StepFailEvent | ScreenshotEvent | FailureBundleWrittenEvent | PausedEvent | ResumedEvent | RunFinishedEvent;
+type RunArtifact = RunStartedEvent | StepStartedEvent | StepOkEvent | StepFailEvent | ScreenshotEvent | FailureBundleWrittenEvent | PausedEvent | ResumedEvent | LocatorPickedEvent | WheelChangedEvent | RunFinishedEvent;
 interface CollectionRunStartedEvent extends RunArtifactBase {
     kind: "collection-run:started";
     runId: RunId;
@@ -584,37 +979,6 @@ type TabKind = ScenarioTab | HelperTab | CollectionTab | ScenarioRunTab | Collec
 /** All tab `kind` literals — useful for switch-completeness checks. */
 type TabKindName = TabKind["kind"];
 
-interface DbgCommandStep {
-    id: string;
-    cmd: "step";
-}
-interface DbgCommandContinue {
-    id: string;
-    cmd: "continue";
-}
-interface DbgCommandPause {
-    id: string;
-    cmd: "pause";
-}
-interface DbgCommandSetBp {
-    id: string;
-    cmd: "set-bp";
-    line: number;
-    col: number;
-}
-interface DbgCommandClearBp {
-    id: string;
-    cmd: "clear-bp";
-    line: number;
-    col: number;
-}
-interface DbgCommandAbort {
-    id: string;
-    cmd: "abort";
-}
-type DbgCommand = DbgCommandStep | DbgCommandContinue | DbgCommandPause | DbgCommandSetBp | DbgCommandClearBp | DbgCommandAbort;
-type DbgCommandKind = DbgCommand["cmd"];
-
 interface BreakpointEntry {
     line: number;
     col: number;
@@ -666,6 +1030,20 @@ interface RuntimeStateFile {
         file: string;
         line: number;
     }[];
+    /** Collaborative control token (Slice 3). `human` (default) → the agent may
+     *  NOT act (record); `agent` → the agent holds the wheel and may record. The
+     *  human (host) is never blocked. Absent ⇒ `human`. */
+    wheel?: "agent" | "human";
+    /** Session mode (U3). `debug` (default) runs a test (executor + pauses);
+     *  `authoring` holds a live browser + draft open with NO running test — the
+     *  picker/record work on the live page, not a pause. Lets the viewer enable
+     *  authoring controls. Absent ⇒ `debug`. */
+    mode?: "debug" | "authoring";
+    /** Playwright `connect()` ws endpoint of the debug run's SHARED browser,
+     *  when launched in share mode (`--debug`). Lets a second client (the MCP
+     *  server / agent) attach to the SAME live browser the human is debugging.
+     *  Absent for non-shared (normal) runs. Localhost only. */
+    wsEndpoint?: string;
     lastFailure: {
         line: number;
         col: number;
@@ -679,4 +1057,4 @@ interface RuntimeStateFile {
     updatedAt: number;
 }
 
-export { type BreakpointEntry, type BreakpointsFile, COLLECTIONS_SUBDIR, COLLECTION_NAME_FORBIDDEN_RE, COMMANDS_FILE, type CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionTab, DEBUGGER_FILE, type DbgCommand, type DbgCommandAbort, type DbgCommandClearBp, type DbgCommandContinue, type DbgCommandKind, type DbgCommandPause, type DbgCommandSetBp, type DbgCommandStep, E2E_SUBDIR, ENV_FILE, type EnvFile, type EnvUpdate, type EnvVar, type ErrorMessage, 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 IRunnerAdapter, LOCK_FILE, LOG_FILE, type LockFile, type LogLineMessage, type Matcher, type PausedEvent, RUNS_SUBDIR, RUNTIME_FILE, RUN_MANIFEST_FILE, RUN_SOURCES_FILE, type RegexLiteral, type ResumedEvent, type RunArtifact, type RunFinishedEvent, type RunId, type RunKind, type RunManifest, type RunMeta, type RunOutcome, type RunRequest, type RunSources, type RunStartedEvent, type RunStatus, RunnerAdapterNotFoundError, RunnerNotConfiguredError, type RuntimeState, type RuntimeStateFile, STDERR_FILE, STDOUT_FILE, STEPS_FILE, type ScenarioMeta, type ScenarioRunRequest, type ScenarioRunTab, type ScenarioTab, type ScreenshotEvent, type StepFailEvent, type StepOkEvent, type StepStartedEvent, 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, UNOTEST_DIR, UnsupportedRunKindError, type WsMessage, type WsMessageKind, isRegexLiteral, makeRunId, regexLiteral, sanitizeRunIdSegment, validateCollectionName };
+export { type AddVariablePlan, type AddVariablePlanInput, type AuthoringRunRequest, type BreakpointEntry, type BreakpointsFile, COLLECTIONS_SUBDIR, COLLECTION_NAME_FORBIDDEN_RE, COMMANDS_FILE, type CollectionMeta, type CollectionRunArtifact, type CollectionRunFinishedEvent, type CollectionRunRequest, type CollectionRunStartedEvent, type CollectionRunTab, type CollectionScenarioFinishedEvent, type CollectionScenarioStartedEvent, type CollectionTab, DEBUGGER_FILE, type DbgCommand, type DbgCommandAbort, type DbgCommandClearBp, type DbgCommandContinue, type DbgCommandKind, type DbgCommandPause, type DbgCommandPickerStart, type DbgCommandPickerStop, type DbgCommandRecord, type DbgCommandSetBp, type DbgCommandSnapshot, type DbgCommandStep, type DbgCommandWheel, type DslDiagnostic, type DslValidateContext, type DslVocabArg, type DslVocabCategory, type DslVocabEntry, E2E_SUBDIR, ENV_FILE, type EnvFile, type EnvUpdate, type EnvVar, type ErrorMessage, 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 IDslLanguageService, type ILaunchedProcess, type IProcessLauncher, type IRunnerAdapter, LOCK_FILE, LOG_FILE, type LaunchSpec, type LocatorPickedEvent, type LockFile, type LogLineMessage, type Matcher, PICKER_SNAPSHOT_FILE, type PausedEvent, type PickerMode, RUNNER_CONFIG_KEYS, RUNS_SUBDIR, RUNTIME_FILE, RUN_MANIFEST_FILE, RUN_SOURCES_FILE, type RecordedActionKind, type RegexLiteral, type ResumedEvent, type RunArtifact, type RunFinishedEvent, type RunId, type RunKind, type RunManifest, type RunMeta, type RunOutcome, type RunRequest, type RunSources, type RunStartedEvent, type RunStatus, RunnerAdapterNotFoundError, RunnerNotConfiguredError, type RuntimeState, type RuntimeStateFile, SECRETS_FILE, SEGMENT_NAME_FORBIDDEN_RE, STDERR_FILE, STDOUT_FILE, STEPS_FILE, type ScenarioMeta, type ScenarioRunRequest, type ScenarioRunTab, type ScenarioTab, type ScenariosPayload, type ScreenshotEvent, type StepFailEvent, type StepOkEvent, type StepStartedEvent, 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, UNOTEST_DIR, UnsupportedRunKindError, type VariableCategory, type VariableKind, type VariablePlanError, type WheelChangedEvent, type WsMessage, type WsMessageKind, activeEnvName, categorizeVariable, deleteShadowWarning, envFileFor, envKeys, insertEnvVar, isExternalVarName, isRegexLiteral, isRunnerConfigKey, makeRunId, planAddVariable, regexLiteral, removeEnvVar, sanitizeRunIdSegment, secretsFileFor, serializeEnvValue, validateCollectionName, validateSegmentName };

package/dist/index.js

@@ -1 +1 @@
-var _0x4f4e3a=_0x3104;(function(_0x1eb34e,_0x3b8ea7){var _0x1068b4={_0x1e67da:0x20d,_0x5695a2:0x209,_0x4493a2:0x1f8},_0x52fa40=_0x3104,_0x3c2fd3=_0x1eb34e();while(!![]){try{var _0x3568d2=parseInt(_0x52fa40(0x1ec))/0x1*(-parseInt(_0x52fa40(0x1f7))/0x2)+-parseInt(_0x52fa40(0x202))/0x3+parseInt(_0x52fa40(_0x1068b4._0x1e67da))/0x4+parseInt(_0x52fa40(0x201))/0x5+parseInt(_0x52fa40(_0x1068b4._0x5695a2))/0x6*(-parseInt(_0x52fa40(_0x1068b4._0x4493a2))/0x7)+-parseInt(_0x52fa40(0x1f9))/0x8+parseInt(_0x52fa40(0x1f2))/0x9;if(_0x3568d2===_0x3b8ea7)break;else _0x3c2fd3['push'](_0x3c2fd3['shift']());}catch(_0x556852){_0x3c2fd3['push'](_0x3c2fd3['shift']());}}}(_0x3e22,0x3e42c));var __defProp=Object[_0x4f4e3a(0x1f5)],__name=(_0x1f300e,_0x2bde85)=>__defProp(_0x1f300e,_0x4f4e3a(0x1f3),{'value':_0x2bde85,'configurable':!![]}),UNOTEST_DIR=_0x4f4e3a(0x204),E2E_SUBDIR='e2e',HELPERS_SUBDIR=_0x4f4e3a(0x20a),COLLECTIONS_SUBDIR='_collections',RUNS_SUBDIR='.runs',LOCK_FILE='.viewer.lock',LOG_FILE='.viewer.log',STEPS_FILE=_0x4f4e3a(0x210),HEARTBEAT_FILE='heartbeat',STDOUT_FILE=_0x4f4e3a(0x1e4),STDERR_FILE=_0x4f4e3a(0x1ee),COMMANDS_FILE=_0x4f4e3a(0x20c),RUNTIME_FILE=_0x4f4e3a(0x1e1),DEBUGGER_FILE=_0x4f4e3a(0x1e5),ENV_FILE=_0x4f4e3a(0x1ef);function isRegexLiteral(_0x5925e4){var _0x6fc145={_0x2d4185:0x207,_0x4ff995:0x1fc,_0x62b82f:0x1e7},_0x536744=_0x4f4e3a;return typeof _0x5925e4===_0x536744(_0x6fc145._0x2d4185)&&_0x5925e4!==null&&_0x5925e4[_0x536744(0x1fa)]===_0x536744(0x208)&&typeof _0x5925e4['source']===_0x536744(_0x6fc145._0x4ff995)&&typeof _0x5925e4[_0x536744(_0x6fc145._0x62b82f)]===_0x536744(0x1fc);}__name(isRegexLiteral,'isRegexLiteral');function regexLiteral(_0x4d5e36,_0x4b70cd=''){return{'kind':'regex','source':_0x4d5e36,'flags':_0x4b70cd};}__name(regexLiteral,_0x4f4e3a(0x205));var RAND_BYTES=0x3;function makeRunId(_0x17406f){var _0x419ccf={_0x20a001:0x20f},_0x3b6caf=_0x4f4e3a;const _0x48b905=sanitizeRunIdSegment(_0x17406f),_0x2743c1=Date['now']()[_0x3b6caf(_0x419ccf._0x20a001)](0x24),_0x491065=new Uint8Array(RAND_BYTES);globalThis[_0x3b6caf(0x1e3)]['getRandomValues'](_0x491065);let _0x590971='';for(let _0x2680ff=0x0;_0x2680ff<_0x491065['length'];_0x2680ff++){_0x590971+=_0x491065[_0x2680ff][_0x3b6caf(_0x419ccf._0x20a001)](0x10)[_0x3b6caf(0x1ed)](0x2,'0');}return _0x48b905+'-'+_0x2743c1+'-'+_0x590971;}function _0x3e22(){var _0x3b86fc=['BwfRzvj1BKLK','DgvYBwLUywW','mZK1ntmYoxbjqwvXza','BMfTzq','iIbKB2vZig5VDcbZDxbWB3j0ihj1BIbRAw5Kici','zgvMAw5LuhjVCgvYDhK','BgvUz3rO','mLD4BMnmza','nZbMsfzcEfm','mteWmZq0mfvov2HJta','A2LUza','DgvZDa','C3rYAw5N','C2fUAxrPEMvsDw5jzfnLz21LBNq','DMfSAwrHDgvdB2XSzwn0Aw9UtMfTzq','BxvZDcbIzsbHihn0CMLUzW','uNvUBMvYtM90q29UzMLNDxjLzevYCM9Y','mJiZmZq3nxDOt2LKwG','odm1mZiWthfYB0fm','CMvWBgfJzq','Dw5VDgvZDa','CMvNzxHmAxrLCMfS','BxvZDcbUB3qGy29UDgfPBIbCic8GoIaQid8GiIa8id4GFcbVCIbJB250CM9SignOyxjHy3rLCNm','B2jQzwn0','CMvNzxG','mZy0mdjoBNbuqMW','x2HLBhbLCNm','C3rHCNrZv2L0Aa','y29TBwfUzhmUANnVBMW','mte4mtC4ohr5yKTzrq','vw5ZDxbWB3j0zwrsDw5lAw5KrxjYB3i','Dg9tDhjPBMC','C3rLChmUANnVBMW','CNvUDgLTzs5QC29U','iI4G','y3j5ChrV','C3rKB3v0lMXVzW','Dw5VDgvZDc8UzgvIDwDNzxiUANnVBG','CNvU','zMXHz3m','C291CMnLCY5QC29U','BxvZDcbUB3qGyMuGzw1WDhK','uNvUBMvYqwrHChrLCK5VDezVDw5KrxjYB3i','BxvZDcbUB3qGyMuGiI4Iig9YiciUlIi','ndq5ntyZz3z2zeTV','CgfKu3rHCNq','C3rKzxjYlMXVzW','Dw5VDgvZDc8Uzw52'];_0x3e22=function(){return _0x3b86fc;};return _0x3e22();}__name(makeRunId,_0x4f4e3a(0x1f0));function _0x3104(_0x32baaa,_0x47d54f){_0x32baaa=_0x32baaa-0x1e1;var _0x3e22b5=_0x3e22();var _0x310442=_0x3e22b5[_0x32baaa];if(_0x3104['VuSBMU']===undefined){var _0x3aa3ac=function(_0x5330f7){var _0xfa99eb='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x1f300e='',_0x2bde85='';for(var _0x5925e4=0x0,_0x4d5e36,_0x4b70cd,_0x17406f=0x0;_0x4b70cd=_0x5330f7['charAt'](_0x17406f++);~_0x4b70cd&&(_0x4d5e36=_0x5925e4%0x4?_0x4d5e36*0x40+_0x4b70cd:_0x4b70cd,_0x5925e4++%0x4)?_0x1f300e+=String['fromCharCode'](0xff&_0x4d5e36>>(-0x2*_0x5925e4&0x6)):0x0){_0x4b70cd=_0xfa99eb['indexOf'](_0x4b70cd);}for(var _0x48b905=0x0,_0x2743c1=_0x1f300e['length'];_0x48b905<_0x2743c1;_0x48b905++){_0x2bde85+='%'+('00'+_0x1f300e['charCodeAt'](_0x48b905)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2bde85);};_0x3104['SVnHrU']=_0x3aa3ac,_0x3104['AaeHBO']={},_0x3104['VuSBMU']=!![];}var _0x7aba37=_0x3e22b5[0x0],_0x43b91a=_0x32baaa+_0x7aba37,_0x56bb48=_0x3104['AaeHBO'][_0x43b91a];return!_0x56bb48?(_0x310442=_0x3104['SVnHrU'](_0x310442),_0x3104['AaeHBO'][_0x43b91a]=_0x310442):_0x310442=_0x56bb48,_0x310442;}function sanitizeRunIdSegment(_0x3b310c){var _0x52fa43={_0x1eae77:0x203},_0x51e659=_0x4f4e3a;const _0x51667b=_0x3b310c['replace'](/[^a-zA-Z0-9_-]+/g,'-')[_0x51e659(_0x52fa43._0x1eae77)](/-+/g,'-')['replace'](/^-|-$/g,'');return _0x51667b['length']>0x0?_0x51667b:_0x51e659(0x1e6);}__name(sanitizeRunIdSegment,_0x4f4e3a(0x1fd));var COLLECTION_NAME_FORBIDDEN_RE=/[\\/:*?"<>|\x00-\x1f]/;function validateCollectionName(_0x9a1d82){var _0x51caec={_0x209a67:0x1e9,_0x46236c:0x1fb},_0x457e19=_0x4f4e3a;if(typeof _0x9a1d82!=='string')return _0x457e19(0x1ff);const _0x3912c4=_0x9a1d82['trim']();if(_0x3912c4[_0x457e19(0x1f6)]===0x0)return _0x457e19(_0x51caec._0x209a67);if(_0x3912c4==='.'||_0x3912c4==='..')return _0x457e19(0x1eb);if(_0x3912c4[_0x457e19(0x20b)]('.'))return'must\x20not\x20start\x20with\x20\x27.\x27';if(COLLECTION_NAME_FORBIDDEN_RE[_0x457e19(_0x51caec._0x46236c)](_0x3912c4))return _0x457e19(0x206);return null;}__name(validateCollectionName,_0x4f4e3a(0x1fe));var RUN_MANIFEST_FILE='manifest.json',RUN_SOURCES_FILE=_0x4f4e3a(0x1e8),UnsupportedRunKindError=class extends Error{static{__name(this,_0x4f4e3a(0x20e));}constructor(_0xf013ac,_0x19b4a5){var _0x35b3dd={_0x29a67a:0x20e},_0x49d706=_0x4f4e3a;super('runner\x20\x22'+_0x19b4a5+_0x49d706(0x1f4)+_0xf013ac+'\x22'),this[_0x49d706(0x1f3)]=_0x49d706(_0x35b3dd._0x29a67a);}},RunnerAdapterNotFoundError=class extends Error{static{__name(this,_0x4f4e3a(0x1ea));}constructor(_0x58d94b,_0x5ecedd){var _0x523fbe={_0x489149:0x1e2},_0x22eb67=_0x4f4e3a;super('cannot\x20load\x20runner\x20adapter\x20\x22'+_0x58d94b+_0x22eb67(_0x523fbe._0x489149)+_0x5ecedd),this['name']=_0x22eb67(0x1ea);}},RunnerNotConfiguredError=class extends Error{static{__name(this,_0x4f4e3a(0x200));}constructor(_0x4ef503){var _0x1ababb={_0x5bc125:0x200},_0x4c4f88=_0x4f4e3a;super(_0x4ef503),this[_0x4c4f88(0x1f3)]=_0x4c4f88(_0x1ababb._0x5bc125);}},TERMINAL_WS_EVENT=_0x4f4e3a(0x1f1);export{COLLECTIONS_SUBDIR,COLLECTION_NAME_FORBIDDEN_RE,COMMANDS_FILE,DEBUGGER_FILE,E2E_SUBDIR,ENV_FILE,HEARTBEAT_FILE,HELPERS_SUBDIR,LOCK_FILE,LOG_FILE,RUNS_SUBDIR,RUNTIME_FILE,RUN_MANIFEST_FILE,RUN_SOURCES_FILE,RunnerAdapterNotFoundError,RunnerNotConfiguredError,STDERR_FILE,STDOUT_FILE,STEPS_FILE,TERMINAL_WS_EVENT,UNOTEST_DIR,UnsupportedRunKindError,isRegexLiteral,makeRunId,regexLiteral,sanitizeRunIdSegment,validateCollectionName};
+const _0x1f0e61=_0x33f9;(function(_0x38cb05,_0x1ead2a){const _0x13d8d8={_0x4a53ac:0x25d,_0x17e566:0x234,_0x10c109:0x24b,_0x39c227:0x20d,_0x385608:0x200,_0x232f49:0x201},_0x39243a=_0x33f9,_0xc8ec76=_0x38cb05();while(!![]){try{const _0x36e89c=parseInt(_0x39243a(_0x13d8d8._0x4a53ac))/0x1*(-parseInt(_0x39243a(_0x13d8d8._0x17e566))/0x2)+-parseInt(_0x39243a(_0x13d8d8._0x10c109))/0x3+parseInt(_0x39243a(_0x13d8d8._0x39c227))/0x4*(-parseInt(_0x39243a(0x252))/0x5)+parseInt(_0x39243a(_0x13d8d8._0x385608))/0x6+parseInt(_0x39243a(0x205))/0x7+parseInt(_0x39243a(0x224))/0x8+-parseInt(_0x39243a(0x207))/0x9*(-parseInt(_0x39243a(_0x13d8d8._0x232f49))/0xa);if(_0x36e89c===_0x1ead2a)break;else _0xc8ec76['push'](_0xc8ec76['shift']());}catch(_0x21d4af){_0xc8ec76['push'](_0xc8ec76['shift']());}}}(_0x51ae,0x69c7c));var __defProp=Object['defineProperty'],__name=(_0x55616a,_0x2ea849)=>__defProp(_0x55616a,_0x1f0e61(0x211),{'value':_0x2ea849,'configurable':!![]}),UNOTEST_DIR=_0x1f0e61(0x1ee),E2E_SUBDIR=_0x1f0e61(0x258),HELPERS_SUBDIR=_0x1f0e61(0x22c),COLLECTIONS_SUBDIR='_collections',RUNS_SUBDIR=_0x1f0e61(0x21b),LOCK_FILE=_0x1f0e61(0x259),LOG_FILE=_0x1f0e61(0x22e),STEPS_FILE=_0x1f0e61(0x21c),HEARTBEAT_FILE='heartbeat',STDOUT_FILE=_0x1f0e61(0x254),STDERR_FILE=_0x1f0e61(0x220),COMMANDS_FILE=_0x1f0e61(0x1ed),RUNTIME_FILE=_0x1f0e61(0x250),PICKER_SNAPSHOT_FILE=_0x1f0e61(0x1ff),DEBUGGER_FILE=_0x1f0e61(0x20f),ENV_FILE=_0x1f0e61(0x221),SECRETS_FILE='unotest/.secrets';function _0x51ae(){const _0x2131f0=['AxnfEhrLCM5HBfzHCK5HBwu','iIbKB2vZig5VDcbZDxbWB3j0ihj1BIbRAw5Kici','vu5pvevtvf9ftLy','vw5ZDxbWB3j0zwrsDw5lAw5KrxjYB3i','vu5pvevtvf9mt0nbteu','vu5pvevtvf9dt05tt0Xf','zw52s2v5CW','A2LUza','C2vJCMv0','y2fUBM90igXVywqGCNvUBMvYigfKyxb0zxiGiG','CgLJA2vYlxnUyxbZAg90lNr4Da','ndi5nZy0ngPpvwDxCG','ody5otbMse50DgS','CMvNzxHmAxrLCMfS','C291CMnL','C3bSAxrmAw5LCW','mJeWodyXn3rywgPuvG','vu5pvevtvf9erujvr19ive1mx01bwf9cwvrfuW','ntq5re9iueDY','uNvUBMvYqwrHChrLCK5VDezVDw5KrxjYB3i','BxvZDcbUB3qGC3rHCNqGD2L0AcaNlIC','Aw52ywXPzc1Uyw1L','refuqujbu0vFvvjm','vu5pvevtvf9erujvr19lruvqx0nbteXt','mZmWotK2s3bYvKn3','vu5pvevtvf9erujvrW','Dw5VDgvZDc8UzgvIDwDNzxiUANnVBG','Dg9mB3DLCKnHC2u','BMfTzq','igLZigfSC28GC2v0igLUihvUB3rLC3qVlMvUDIdIGjqGDgHLihnLy3jLDcb2ywX1zsbUB3CGC2HHzg93CYbPDc4','Dw5VDgvZDc8UC2vJCMv0CW','C3rYAw5N','CNvU','vu5pvevtvf9erujvr19esvi','vu5pvevtvf9dqunirv9esvi','CgfKu3rHCNq','BxvZDcbUB3qGy29UDgfPBIbCic8GoIaQid8GiIa8id4GFcbVCIbJB250CM9SignOyxjHy3rLCNm','AgfZ','lNj1BNm','C3rLChmUANnVBMW','zw5KC1DPDgG','BgvUz3rO','AxnszwDLEeXPDgvYywW','C3rKzxjYlMXVzW','Dw5VDgvZDc8Uzw52','Dw5RBM93BI1YDw5UzxiTA2v5','vu5pvevtvf9mt0DFtevwruW','otu1nZzmu1HisMy','vu5pvevtvf9orvrxt1jl','C3rHCNrZv2L0Aa','ywrK','B2jQzwn0','DhjPBq','igLZigfSC28GC2v0igLUihvUB3rLC3qVlNnLy3jLDhmG4OcuihrOzsbZzwnYzxqGDMfSDwuGC2HHzg93CYb0AgLZig9Uzs4','vu5pvevtvf9qt1bvuf9huKfdrv9nuW','x2HLBhbLCNm','zw52q29UDgvUDa','lNzPzxDLCI5SB2C','CMvWBgfJzq','iI4G','C2XPy2u','C2fUAxrPEMvsDw5jzfnLz21LBNq','CMvNzxG','mtrMAhPIDMu','zhvWBgLJyxrL','Dg9tDhjPBMC','Aw5KzxHpzG','yxbW','AxnbC3nPz25Tzw50t2y','Aw5Zzxj0rw52vMfY','C2vJCMv0C0zPBgvgB3i','AM9PBG','uNvUBMvYtM90q29UzMLNDxjLzevYCM9Y','C291CMnLCY5QC29U','y3j5ChrV','DgvZDa','vu5pvevtvf9eruzbvuXux1rjtuvpvvrFtvm','C2vJCMv0CW','ChvZAa','zMLUzeLUzgv4','zgvSzxrLu2HHzg93v2fYBMLUzW','igLZig5VDcbHigTUB3DUihj1BM5LCIbZzxr0Aw5NiokaLcbJAg9VC2uGB25LigzYB20GDgHLihj1BM5LCI1JB25MAwCGBgLZDc4','BxvZDcbUB3qGC3rHCNqGD2L0AcaNxYCGkhjLC2vYDMvKkq','Axntzwn0Aw9UrgL2AwrLCG','ig11C3qGyMuGvvbqrvjFu05bs0uGkguUzY4Gqvbqx0jbu0vFvvjmksbZBYbHihnJzw5HCMLVignHBIbYzwzLCMvUy2uGAxqGyNKGBMfTzs4','y2f0zwDVCML6zvzHCMLHyMXL','mZq2odK5B01ouhby','iokaLcbWAwnRigeGzgLMzMvYzw50ig5HBwuGB3iGzwrPDcb0AguGzxHPC3rPBMCGDMfSDwuU','C2vYAwfSAxPLrw52vMfSDwu','iYaTls0G','BxvZDcbUB3qGyMuGzw1WDhK','CNvUDgLTzs5QC29U','igfSCMvHzhKGzxHPC3rZigLUia','ndvArK55CfK','zw52','C3rKB3v0lMXVzW','CMvTB3zLrw52vMfY','CNvUBMvY','vu5pvevtvf9cuK9xu0vs','ztjL','lNzPzxDLCI5SB2nR','vu5pvevtvf9erujvr19quKvwsuvxx0jzvevt','zMLSDgvY','C2vJCMv0C0nVBNrLBNq','mZGWnJnfCgf1D2C','C3bSAxq','qxbW','y29TBwfUzhmUANnVBMW','Dw5VDgvZDa','CgXHBKfKzfzHCMLHyMXL','vu5pvevtvf9iruferuq','DMfSAwrHDgvtzwDTzw50tMfTzq','C3bSAwnL','BxvZDcbUB3qGyMuGiI4Iig9YiciUlIi','BwfUAwzLC3qUANnVBG'];_0x51ae=function(){return _0x2131f0;};return _0x51ae();}function envFileFor(_0xc63703){return _0xc63703?ENV_FILE+'.'+_0xc63703:ENV_FILE;}__name(envFileFor,'envFileFor');function secretsFileFor(_0x45ac5d){return _0x45ac5d?SECRETS_FILE+'.'+_0x45ac5d:SECRETS_FILE;}__name(secretsFileFor,_0x1f0e61(0x23b));function activeEnvName(_0x27e8e9){const _0x268161=_0x1f0e61,_0x250b3b=_0x27e8e9[_0x268161(0x1f7)]?.['trim']();return _0x250b3b?_0x250b3b:void 0x0;}function _0x33f9(_0x2e96f1,_0x5b0908){_0x2e96f1=_0x2e96f1-0x1ec;const _0x51aebd=_0x51ae();let _0x33f91d=_0x51aebd[_0x2e96f1];if(_0x33f9['mirZHF']===undefined){var _0x56bae3=function(_0x51aad6){const _0x11a841='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x55616a='',_0x2ea849='';for(let _0xc63703=0x0,_0x45ac5d,_0x27e8e9,_0x250b3b=0x0;_0x27e8e9=_0x51aad6['charAt'](_0x250b3b++);~_0x27e8e9&&(_0x45ac5d=_0xc63703%0x4?_0x45ac5d*0x40+_0x27e8e9:_0x27e8e9,_0xc63703++%0x4)?_0x55616a+=String['fromCharCode'](0xff&_0x45ac5d>>(-0x2*_0xc63703&0x6)):0x0){_0x27e8e9=_0x11a841['indexOf'](_0x27e8e9);}for(let _0x53a502=0x0,_0x2a672f=_0x55616a['length'];_0x53a502<_0x2a672f;_0x53a502++){_0x2ea849+='%'+('00'+_0x55616a['charCodeAt'](_0x53a502)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2ea849);};_0x33f9['KPQEhF']=_0x56bae3,_0x33f9['FSigyn']={},_0x33f9['mirZHF']=!![];}const _0x273467=_0x51aebd[0x0],_0x5a525f=_0x2e96f1+_0x273467,_0x551b20=_0x33f9['FSigyn'][_0x5a525f];return!_0x551b20?(_0x33f91d=_0x33f9['KPQEhF'](_0x33f91d),_0x33f9['FSigyn'][_0x5a525f]=_0x33f91d):_0x33f91d=_0x551b20,_0x33f91d;}__name(activeEnvName,'activeEnvName');function isRegexLiteral(_0x53a502){const _0x9e11bf={_0x359d3b:0x228},_0x3b88e3=_0x1f0e61;return typeof _0x53a502===_0x3b88e3(_0x9e11bf._0x359d3b)&&_0x53a502!==null&&_0x53a502[_0x3b88e3(0x1fc)]==='regex'&&typeof _0x53a502[_0x3b88e3(0x203)]===_0x3b88e3(0x214)&&typeof _0x53a502['flags']==='string';}__name(isRegexLiteral,_0x1f0e61(0x21f));function regexLiteral(_0x2a672f,_0x50f6e0=''){const _0x35d2d4={_0x3b5303:0x233},_0x741b72=_0x1f0e61;return{'kind':_0x741b72(_0x35d2d4._0x3b5303),'source':_0x2a672f,'flags':_0x50f6e0};}__name(regexLiteral,_0x1f0e61(0x202));var RAND_BYTES=0x3;function makeRunId(_0x36f805){const _0x947e41={_0x58b3cc:0x236,_0x562653:0x23f},_0x2ad894=_0x1f0e61,_0x3d2060=sanitizeRunIdSegment(_0x36f805),_0x5160e2=Date['now']()[_0x2ad894(_0x947e41._0x58b3cc)](0x24),_0x2b69d4=new Uint8Array(RAND_BYTES);globalThis[_0x2ad894(_0x947e41._0x562653)]['getRandomValues'](_0x2b69d4);let _0x57fdcc='';for(let _0x4083cc=0x0;_0x4083cc<_0x2b69d4[_0x2ad894(0x21e)];_0x4083cc++){_0x57fdcc+=_0x2b69d4[_0x4083cc][_0x2ad894(_0x947e41._0x58b3cc)](0x10)[_0x2ad894(0x218)](0x2,'0');}return _0x3d2060+'-'+_0x5160e2+'-'+_0x57fdcc;}__name(makeRunId,'makeRunId');function sanitizeRunIdSegment(_0xe3bd1d){const _0x467364={_0x24e5be:0x21e},_0x4a8dee=_0x1f0e61,_0xe79735=_0xe3bd1d[_0x4a8dee(0x22f)](/[^a-zA-Z0-9_-]+/g,'-')['replace'](/-+/g,'-')[_0x4a8dee(0x22f)](/^-|-$/g,'');return _0xe79735[_0x4a8dee(_0x467364._0x24e5be)]>0x0?_0xe79735:_0x4a8dee(0x215);}__name(sanitizeRunIdSegment,_0x1f0e61(0x232));var COLLECTION_NAME_FORBIDDEN_RE=/[\\/:*?"<>|\x00-\x1f]/;function validateCollectionName(_0xbc4dce){const _0x479df4={_0x5351f5:0x229,_0x39eee9:0x21e,_0x5ab7b3:0x24f,_0x45ef4f:0x226,_0x4e9515:0x240,_0x3887ad:0x219},_0x268c8b=_0x1f0e61;if(typeof _0xbc4dce!=='string')return'must\x20be\x20a\x20string';const _0x3550bc=_0xbc4dce[_0x268c8b(_0x479df4._0x5351f5)]();if(_0x3550bc[_0x268c8b(_0x479df4._0x39eee9)]===0x0)return _0x268c8b(_0x479df4._0x5ab7b3);if(_0x3550bc==='.'||_0x3550bc==='..')return _0x268c8b(0x1f3);if(_0x3550bc[_0x268c8b(_0x479df4._0x45ef4f)]('.'))return _0x268c8b(0x209);if(COLLECTION_NAME_FORBIDDEN_RE[_0x268c8b(_0x479df4._0x4e9515)](_0x3550bc))return _0x268c8b(_0x479df4._0x3887ad);return null;}__name(validateCollectionName,'validateCollectionName');var RUN_MANIFEST_FILE=_0x1f0e61(0x1f4),RUN_SOURCES_FILE=_0x1f0e61(0x23e),UnsupportedRunKindError=class extends Error{static{__name(this,_0x1f0e61(0x1f8));}constructor(_0x9ee938,_0x2b19b5){const _0x1bf2d3=_0x1f0e61;super('runner\x20\x22'+_0x2b19b5+_0x1bf2d3(0x1f6)+_0x9ee938+'\x22'),this['name']=_0x1bf2d3(0x1f8);}},RunnerAdapterNotFoundError=class extends Error{static{__name(this,_0x1f0e61(0x208));}constructor(_0xcb36ad,_0x5d07d3){const _0x2818de={_0x529a02:0x1fe,_0x2cbf13:0x208},_0x2ecb25=_0x1f0e61;super(_0x2ecb25(_0x2818de._0x529a02)+_0xcb36ad+_0x2ecb25(0x230)+_0x5d07d3),this['name']=_0x2ecb25(_0x2818de._0x2cbf13);}},RunnerNotConfiguredError=class extends Error{static{__name(this,'RunnerNotConfiguredError');}constructor(_0x4570c2){const _0x59a39c={_0x3825bb:0x211},_0x3da234=_0x1f0e61;super(_0x4570c2),this[_0x3da234(_0x59a39c._0x3825bb)]=_0x3da234(0x23d);}},SEGMENT_NAME_FORBIDDEN_RE=/[\\/:*?"<>|\x00-\x1f]/;function validateSegmentName(_0x5c3b0e){const _0x5a3c1e={_0xa8ba3e:0x24f,_0x12b4c2:0x1f3,_0x5b4a98:0x226,_0x2bb7db:0x247,_0x30c8cd:0x240},_0x45da77=_0x1f0e61;if(typeof _0x5c3b0e!=='string')return'must\x20be\x20a\x20string';const _0xa31cd7=_0x5c3b0e['trim']();if(_0xa31cd7[_0x45da77(0x21e)]===0x0)return _0x45da77(_0x5a3c1e._0xa8ba3e);if(_0xa31cd7==='.'||_0xa31cd7==='..')return _0x45da77(_0x5a3c1e._0x12b4c2);if(_0xa31cd7[_0x45da77(_0x5a3c1e._0x5b4a98)]('.'))return _0x45da77(0x209);if(_0xa31cd7[_0x45da77(_0x5a3c1e._0x5b4a98)]('_'))return _0x45da77(_0x5a3c1e._0x2bb7db);if(SEGMENT_NAME_FORBIDDEN_RE[_0x45da77(_0x5a3c1e._0x30c8cd)](_0xa31cd7))return'must\x20not\x20contain\x20\x5c\x20/\x20:\x20*\x20?\x20\x22\x20<\x20>\x20|\x20or\x20control\x20characters';return null;}__name(validateSegmentName,_0x1f0e61(0x1f1));var TERMINAL_WS_EVENT='terminal',RUNNER_CONFIG_KEYS=new Set([_0x1f0e61(0x257),_0x1f0e61(0x1f0),'UNOTEST_SLOW_MO',_0x1f0e61(0x241),'UNOTEST_DEFAULT_NAVIGATION_TIMEOUT_MS',_0x1f0e61(0x22b),_0x1f0e61(0x1f9),'UNOTEST_TIMEZONE',_0x1f0e61(0x223),_0x1f0e61(0x20e),_0x1f0e61(0x216),'UNOTEST_DEBUG_MAX_BYTES',_0x1f0e61(0x25a),_0x1f0e61(0x206),_0x1f0e61(0x20c),_0x1f0e61(0x225),_0x1f0e61(0x1fa),_0x1f0e61(0x217),'NO_COLOR','FORCE_COLOR',_0x1f0e61(0x20b)]);function isRunnerConfigKey(_0x38536f){const _0x3a6264=_0x1f0e61;return RUNNER_CONFIG_KEYS[_0x3a6264(0x21a)](_0x38536f);}__name(isRunnerConfigKey,'isRunnerConfigKey');function categorizeVariable(_0x2b874){const _0x4c935b={_0x168734:0x203,_0x350445:0x242,_0x55f45b:0x1fd},_0x368e97=_0x1f0e61;if(_0x2b874[_0x368e97(_0x4c935b._0x168734)]===_0x368e97(_0x4c935b._0x350445))return _0x368e97(_0x4c935b._0x55f45b);return isRunnerConfigKey(_0x2b874['name'])?_0x368e97(0x256):_0x368e97(0x238);}__name(categorizeVariable,_0x1f0e61(0x24a));function isExternalVarName(_0xac84a0){const _0x4cc968={_0x3bbd51:0x240},_0x5b803e=_0x1f0e61;return/^[A-Z][A-Z0-9_]*$/[_0x5b803e(_0x4cc968._0x3bbd51)](_0xac84a0);}__name(isExternalVarName,_0x1f0e61(0x1f5));function serializeEnvValue(_0x58f93f){const _0xa7ee4f={_0x1e58da:0x240,_0x1e72ab:0x22f},_0x479ca7=_0x1f0e61;if(_0x58f93f==='')return'';if(/[\s#"'=\\]|^[`]/['test'](_0x58f93f)||/[\n\r]/[_0x479ca7(_0xa7ee4f._0x1e58da)](_0x58f93f)){const _0x397997=_0x58f93f[_0x479ca7(_0xa7ee4f._0x1e72ab)](/\\/g,'\x5c\x5c')[_0x479ca7(0x22f)](/"/g,'\x5c\x22')[_0x479ca7(_0xa7ee4f._0x1e72ab)](/\n/g,'\x5cn')[_0x479ca7(_0xa7ee4f._0x1e72ab)](/\r/g,'\x5cr');return'\x22'+_0x397997+'\x22';}return _0x58f93f;}__name(serializeEnvValue,_0x1f0e61(0x24d));function envKeys(_0x534855){const _0x25e112={_0x37da95:0x25e,_0x4b476b:0x229,_0x51891e:0x240,_0x24be55:0x227},_0x56be10=_0x1f0e61,_0x23cfac=new Set();for(const _0x2ba23f of _0x534855[_0x56be10(_0x25e112._0x37da95)](/\r?\n/)){const _0x6e3c9=_0x2ba23f[_0x56be10(_0x25e112._0x4b476b)]();if(_0x6e3c9===''||_0x6e3c9[_0x56be10(0x226)]('#'))continue;const _0x111485=_0x6e3c9['indexOf']('=');if(_0x111485<=0x0)continue;const _0x36d4cc=_0x6e3c9['slice'](0x0,_0x111485)[_0x56be10(0x229)]();if(/^[A-Za-z_][A-Za-z0-9_]*$/[_0x56be10(_0x25e112._0x51891e)](_0x36d4cc))_0x23cfac[_0x56be10(_0x25e112._0x24be55)](_0x36d4cc);}return _0x23cfac;}__name(envKeys,_0x1f0e61(0x1fb));function isSectionDivider(_0x59aa3b){const _0x4c6a02={_0x41c6a4:0x226},_0x46402d=_0x1f0e61,_0x537627=_0x59aa3b[_0x46402d(0x229)]();return _0x537627[_0x46402d(_0x4c6a02._0x41c6a4)]('#')&&/---/[_0x46402d(0x240)](_0x537627);}__name(isSectionDivider,_0x1f0e61(0x248));function isAssignmentLine(_0x8ece7d){const _0x1a0f81={_0x1d0949:0x237,_0x527170:0x231},_0x2814aa=_0x1f0e61,_0x25dd6b=_0x8ece7d[_0x2814aa(0x229)]();if(_0x25dd6b===''||_0x25dd6b[_0x2814aa(0x226)]('#'))return![];const _0x318078=_0x25dd6b[_0x2814aa(_0x1a0f81._0x1d0949)]('=');return _0x318078>0x0&&/^[A-Za-z_][A-Za-z0-9_]*$/[_0x2814aa(0x240)](_0x25dd6b[_0x2814aa(_0x1a0f81._0x527170)](0x0,_0x318078)[_0x2814aa(0x229)]());}__name(isAssignmentLine,'isAssignmentLine');function isAssignmentOf(_0x2d8764,_0x3b91d7){const _0x1b74e2=_0x1f0e61,_0x24bfb6=_0x2d8764[_0x1b74e2(0x229)]();if(_0x24bfb6===''||_0x24bfb6[_0x1b74e2(0x226)]('#'))return![];const _0xa82690=_0x24bfb6['indexOf']('=');if(_0xa82690<=0x0)return![];return _0x24bfb6[_0x1b74e2(0x231)](0x0,_0xa82690)[_0x1b74e2(0x229)]()===_0x3b91d7;}__name(isAssignmentOf,_0x1f0e61(0x239));function splitLines(_0x20d72d){const _0x45a3eb={_0x2de1f2:0x21d,_0xe1cf45:0x231,_0x281fc2:0x25e},_0x5c4cb8=_0x1f0e61,_0x2c281a=_0x20d72d[_0x5c4cb8(_0x45a3eb._0x2de1f2)]('\x0a'),_0x3355ad=_0x2c281a?_0x20d72d[_0x5c4cb8(_0x45a3eb._0xe1cf45)](0x0,-0x1):_0x20d72d;return{'lines':_0x3355ad===''?[]:_0x3355ad[_0x5c4cb8(_0x45a3eb._0x281fc2)]('\x0a'),'trailingNewline':_0x2c281a};}__name(splitLines,_0x1f0e61(0x204));function joinLines(_0x50f552,_0x14d8b8){const _0x2117fc=_0x1f0e61,_0x93be1b=_0x50f552[_0x2117fc(0x23c)]('\x0a');return _0x14d8b8||_0x93be1b===''?_0x93be1b+'\x0a':_0x93be1b;}__name(joinLines,'joinLines');function insertEnvVar(_0x188c04,_0x3e47bc,_0x2940c5,_0xed420d){const _0x2b7248={_0xd59b30:0x210,_0x288b8b:0x229,_0x5eab7d:0x243},_0x4859a1=_0x1f0e61,_0x37c865=_0x3e47bc+'='+serializeEnvValue(_0x2940c5),{lines:_0x5d31ae,trailingNewline:_0x134cb9}=splitLines(_0x188c04);if(_0xed420d){const _0x4bf986=new RegExp('\x5cb'+_0xed420d[_0x4859a1(_0x2b7248._0xd59b30)]()+'\x5cb'),_0x374d59=_0x5d31ae[_0x4859a1(0x244)](_0x3bc857=>isSectionDivider(_0x3bc857)&&_0x4bf986[_0x4859a1(0x240)](_0x3bc857[_0x4859a1(0x210)]()));if(_0x374d59!==-0x1){let _0x5f0b95=_0x5d31ae['length'];for(let _0x1466cf=_0x374d59+0x1;_0x1466cf<_0x5d31ae[_0x4859a1(0x21e)];_0x1466cf++){if(isSectionDivider(_0x5d31ae[_0x1466cf])){_0x5f0b95=_0x1466cf;break;}}let _0x49654c=-0x1,_0x1879bb=-0x1;for(let _0x55e7d2=_0x374d59+0x1;_0x55e7d2<_0x5f0b95;_0x55e7d2++){if(_0x5d31ae[_0x55e7d2][_0x4859a1(_0x2b7248._0x288b8b)]()!=='')_0x1879bb=_0x55e7d2;if(isAssignmentLine(_0x5d31ae[_0x55e7d2]))_0x49654c=_0x55e7d2;}const _0x3333f6=_0x49654c>=0x0?_0x49654c:_0x1879bb,_0x322b38=_0x3333f6>=0x0?_0x3333f6+0x1:_0x374d59+0x1;return _0x5d31ae[_0x4859a1(0x1f2)](_0x322b38,0x0,_0x37c865),joinLines(_0x5d31ae,_0x134cb9||_0x5d31ae['length']>0x0);}if(_0x5d31ae['length']>0x0)_0x5d31ae['push']('');return _0x5d31ae[_0x4859a1(_0x2b7248._0x5eab7d)](_0x4859a1(0x24e)+_0xed420d+'\x20---',_0x37c865),joinLines(_0x5d31ae,!![]);}return _0x5d31ae[_0x4859a1(0x243)](_0x37c865),joinLines(_0x5d31ae,!![]);}__name(insertEnvVar,_0x1f0e61(0x23a));function removeEnvVar(_0x52edbb,_0x248430){const _0x2d1812={_0x2bc4bc:0x25b},_0x202974=_0x1f0e61,{lines:_0x206f2b,trailingNewline:_0x45a27c}=splitLines(_0x52edbb),_0x4f6dfe=_0x206f2b[_0x202974(_0x2d1812._0x2bc4bc)](_0x42693d=>!isAssignmentOf(_0x42693d,_0x248430)),_0x23c17d=_0x4f6dfe[_0x202974(0x21e)]!==_0x206f2b[_0x202974(0x21e)];return{'content':joinLines(_0x4f6dfe,_0x45a27c),'removed':_0x23c17d};}__name(removeEnvVar,_0x1f0e61(0x255));var SECTION_BY_KIND={'app':_0x1f0e61(0x1ec),'runner':'Runner','secret':void 0x0};function planAddVariable(_0x1699f1){const _0x39dd5f={_0x4ec17c:0x222,_0x3dee5e:0x25c,_0x5f393b:0x21a,_0x71ccda:0x1fd,_0x3bc962:0x242,_0x5bf886:0x213,_0x1c05ff:0x221,_0xa68ea5:0x235,_0x5da33b:0x251,_0x1f2001:0x24c},_0x1156a9=_0x1f0e61,{name:_0x10c3e7,kind:_0x4f2b4f}=_0x1699f1;if(_0x4f2b4f===_0x1156a9(0x256)){if(!isRunnerConfigKey(_0x10c3e7))return{'ok':![],'code':_0x1156a9(_0x39dd5f._0x4ec17c),'message':_0x10c3e7+_0x1156a9(0x246)};}else{if(!isExternalVarName(_0x10c3e7))return{'ok':![],'code':_0x1156a9(0x20a),'message':_0x10c3e7+_0x1156a9(0x249)};}const _0x3bc757=envKeys(_0x1699f1[_0x1156a9(0x22d)])['has'](_0x10c3e7),_0xcd7eb7=envKeys(_0x1699f1[_0x1156a9(_0x39dd5f._0x3dee5e)])[_0x1156a9(_0x39dd5f._0x5f393b)](_0x10c3e7),_0x58d91e=_0x4f2b4f===_0x1156a9(_0x39dd5f._0x71ccda)?_0x1156a9(_0x39dd5f._0x3bc962):_0x1156a9(0x253),_0x579a83=_0x58d91e==='secrets'?_0xcd7eb7:_0x3bc757,_0xf67b1e=_0x58d91e==='secrets'?_0x1156a9(_0x39dd5f._0x5bf886):_0x1156a9(_0x39dd5f._0x1c05ff);if(_0x579a83)return{'ok':![],'code':_0x1156a9(_0x39dd5f._0xa68ea5),'message':_0x10c3e7+_0x1156a9(_0x39dd5f._0x5da33b)+_0xf67b1e+_0x1156a9(_0x39dd5f._0x1f2001)};const _0x849263=[];return _0x4f2b4f===_0x1156a9(_0x39dd5f._0x71ccda)&&_0x3bc757&&_0x849263[_0x1156a9(0x243)](_0x10c3e7+_0x1156a9(0x212)),_0x4f2b4f!==_0x1156a9(0x1fd)&&_0xcd7eb7&&_0x849263['push'](_0x10c3e7+_0x1156a9(0x22a)),{'ok':!![],'target':_0x58d91e,'sectionLabel':SECTION_BY_KIND[_0x4f2b4f],'warnings':_0x849263};}__name(planAddVariable,_0x1f0e61(0x1ef));function deleteShadowWarning(_0xf8edb1,_0x4962ce,_0x4e53ce){if(_0x4e53ce!==void 0x0&&_0x4e53ce!==_0x4962ce)return[_0xf8edb1+'\x20is\x20also\x20set\x20in\x20your\x20shell\x20environment\x20—\x20it\x20will\x20keep\x20resolving\x20from\x20there\x20(the\x20environment\x20wins\x20over\x20the\x20file).'];return[];}__name(deleteShadowWarning,_0x1f0e61(0x245));export{COLLECTIONS_SUBDIR,COLLECTION_NAME_FORBIDDEN_RE,COMMANDS_FILE,DEBUGGER_FILE,E2E_SUBDIR,ENV_FILE,HEARTBEAT_FILE,HELPERS_SUBDIR,LOCK_FILE,LOG_FILE,PICKER_SNAPSHOT_FILE,RUNNER_CONFIG_KEYS,RUNS_SUBDIR,RUNTIME_FILE,RUN_MANIFEST_FILE,RUN_SOURCES_FILE,RunnerAdapterNotFoundError,RunnerNotConfiguredError,SECRETS_FILE,SEGMENT_NAME_FORBIDDEN_RE,STDERR_FILE,STDOUT_FILE,STEPS_FILE,TERMINAL_WS_EVENT,UNOTEST_DIR,UnsupportedRunKindError,activeEnvName,categorizeVariable,deleteShadowWarning,envFileFor,envKeys,insertEnvVar,isExternalVarName,isRegexLiteral,isRunnerConfigKey,makeRunId,planAddVariable,regexLiteral,removeEnvVar,sanitizeRunIdSegment,secretsFileFor,serializeEnvValue,validateCollectionName,validateSegmentName};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unotest/protocol",
-  "version": "0.6.2",
+  "version": "0.9.0",
   "description": "Cross-runner protocol for the @unotest ecosystem: shared TypeScript types, path constants, the IRunnerAdapter contract that lets @unotest/viewer drive @unotest/web, @unotest/mobile (and future runners) through the same surface. Pure types + pure functions only — zero runtime deps, browser-safe.",
   "license": "MIT",
   "publishConfig": {