@unotest/web 0.45.0 → 0.46.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.46.0] - 2026-10-02
+
+### Minor Changes
+
+- 5a047cc: Assertions take a regex and can wait for the opposite. `assertText(loc, expected, {not})` accepts a `/regex/` as well as a string, and `{not: true}` passes once the text stops matching, for a spinner label that has to go away. New `assertTexts(loc, [...])` checks a whole list in order, with the element count, and `assertAttribute(loc, name, expected, {not})` waits for an attribute value such as `aria-expanded`. A string still compares whole by default, `{exact: false}` for a substring, so existing scenarios behave as before. The "From @playwright/test" page maps `toHaveText`, `not.toHaveText` and `toHaveAttribute`.
+- b6b4558: New DSL function `assertSchema(value, schema)`: checks a value against a JSON Schema (draft 2020-12), such as one your app generates from its zod schemas with `z.toJSONSchema` and the scenario reads with `readJson`. When the value breaks the schema, the step fails naming every broken field by path with what is wrong there (`/tags/1: must be string`), not only the first one. A `$ref` inside the schema (`#/$defs/...`) is followed; a `$ref` to another file is refused, as is a schema that declares another draft or is itself invalid. `format` is not checked. `@unotest/web` now depends on `ajv`.
+- d9bb5af: The page console in scenarios: `consoleEntries({level?, since?})` returns what the active page logged as `[{level, text, url}]`, `pageErrors({since?})` the errors it threw that nothing caught as `[{message, stack}]`, and `assertNoConsoleErrors({includePageErrors?, since?})` fails on either, quoting the first three. Pages are recorded from the moment they open, extension pages (`chrome-extension://`) included, so a scenario acts first and asks afterwards; `since` takes a time from `nowMs()`. `UNOTEST_CONSOLE` still decides alone whether a run writes `console.json` into its artifacts and failure bundles.
+- 8241cfb: New DSL function `env(name)`: returns an environment value as a string, or `null` when the name is not set, so a test can decide on it (skip a live-only check, pick a target) instead of failing on a missing variable. It reads what a bare `UPPER_SNAKE` name reads: the environment the run started in, then `unotest/.env`. A secret, from `unotest/.secrets` or injected by a box, is refused: write its bare name where the value is typed, and it stays masked.
+- 25702f0: A new browser profile for every test: `launch: { profile: 'per-test' }` starts each `test_*` in a new browser on a new, empty profile directory, so an extension loads again, its service worker starts from scratch and nothing in `chrome.storage`, `localStorage` or the tabs carries over; with one test per file, a suite of N files runs on N profiles. The directory is removed after a passing test and kept in the run folder after a failing one; the run log names it. Browser extensions and the service-worker functions (`waitForServiceWorker`, `evaluateInServiceWorker`, `extensionId`) now work on per-test profiles too, not only with `launch.userDataDir`, and `mockRoute` answers the worker's own requests in every test. It cannot be combined with `launch.userDataDir`, and it is refused with `storageState`, with more than one worker and on a box; `UNOTEST_USER_DATA_DIR` overrides it with one shared profile. An agent joined to a debug run follows it into each test's browser.
+- 8241cfb: New DSL function `skip(reason, condition?)`: a test ends itself as skipped when it does not apply here, for example `skip('no live API configured', env('LIVE_API') == null)`. Without a condition it always skips; with a false one the test goes on. `skip` is a test guard: it stands in the `test_*` body next to the steps, like `step(...)` and `teardown(...)`, and the validator accepts it there. The run reports skipped with the reason, neither passed nor failed: the CLI prints `○ test: … skipped: <reason>` and counts `1 skipped`, a collection counts `skipped=N(test=N)`, and `run_test` answers `outcome: "skipped"` with `skipReason`. The viewer does not know skipped yet: it shows such a run as passed, without the reason. The exit code stays 0. Nothing after the call runs; teardown blocks registered before it still play. A skip after a failed soft step, or a skipped test whose teardown fails, is a failed test. A new lint rule, `lint:skip-outside-test` (error), reports `skip()` anywhere else: inside a step or a block, in a helper or a `flow_*`. Validator contracts gain an optional `testGuard` flag: a function marked with it may stand as a direct child of a `test_*` body. On the wire a skipped run is `completed` with a new optional `skipReason` field on `run:finished` and in the runtime state, so readers that predate it still see a finished run.
+- 0fa0343: A test's time budget, set where you expect it. The config key `testTimeoutMs` (default 300000) is the deadline of one test: an action still running when it runs out is cut there, the test fails naming `testTimeoutMs`, and its teardown blocks still play. `30000` gives every test 30 s. The new DSL function `setTestTimeout(ms)`, the counterpart of Playwright's `test.setTimeout`, gives one test its own budget, longer or shorter, counted from the test's start; the error then names `setTestTimeout(ms)`. `UNOTEST_MAX_DURATION_MS` still overrides the config for a run and keeps its name in the error. A new lint rule, `lint:set-test-timeout-outside-test` (error), reports `setTestTimeout()` outside a `test_*` body. Running out of time fails the test; Stop in the viewer still aborts the run.
+- 3f18c02: Actions (`click`, `doubleClick`, `fill`, `press`, `check`, `uncheck`, `hover`, `selectOption`, `dragAndDrop`), navigation (`goto`, `reload`, `goBack`, `goForward`, `waitForUrl`, `waitForNavigation`) waits (`waitFor`, `waitForText`, `waitForCount`) and assertions (`assertText`, `assertTexts`, `assertAttribute`, `assertVisible`, `assertHidden`, `assertValue`, `assertCount`, `assertUrl`, `assertNeverAppears`) now refuse an option they do not take, naming the ones they do: `click(btn, {timout: 5000})` used to wait the default 3 s without a word.
+
+  **Migration:** a misspelled option in these functions now fails naming the supported ones — fix the spelling the message points at. `noWaitAfter` on `click` and `fill` never had an effect; it is now refused, so remove it.
+
+- fefe1e7: The file oracles now read only where `readFile` does. `waitForFile`, `assertNoFile`, `waitForJsonLine`, `readJsonLine`, `assertNoJsonLine`, `waitForFileCount` and `assertFileCount` take a path relative to `sandbox.shellCwd`, or an absolute one inside the project, the run's downloads or a directory listed in the new `sandbox.readRoots`. Anything else (`../` out of them, an absolute path elsewhere, a symlink that leads out) fails the step with a scenario error naming the path and the directories it left. The check repeats on every read of a wait, so a file that appears as a symlink out is refused when it appears.
+
+  `readFile` and `readFileInfo` are stricter too: a file that does not exist yet is judged by the nearest directory above it that does, so a path under a directory symlinked out of the project is refused instead of reported missing. They also read from `sandbox.readRoots`.
+
+  Migration: a scenario that waits on or reads a file by an absolute path outside the project, such as a background listener's log in `/tmp`, now fails with that error. List the directory in the config: `sandbox: { readRoots: ['/tmp/my-listener'] }`.
+
+- bb538e7: `webServer` in the config takes one server or a list — a front and the fake backends it talks to, each with its own readiness `url`. A list starts all at once, the first scenario runs once every `url` answers, and the servers stop in reverse order; if one does not come up, the ones that did are stopped and the error names each that failed. Two entries on one `url` are refused. `app-server` prints one event per server. Type change: `UnotestConfig.webServer` is now always a list once the config is parsed (an object in the file still works).
+
+### Patch Changes
+
+- cd4664d: Stopping a `webServer` the run started now waits until the server itself has exited, not only the shell that launched it. On Linux the shell exits at once on the stop signal while the server is still shutting down, so the next step could find its port still taken or its shutdown output unwritten.
+- Updated dependencies [8241cfb]
+- Updated dependencies [0fa0343]
+  - @unotest/dsl@0.46.0
+  - @unotest/protocol@0.46.0
+  - @unotest/viewer@0.46.0
+  - @unotest/core@0.46.0
+  - @unotest/grounder-client@0.46.0
+
 ## [0.45.0] - 2026-10-01
 
 ### Minor Changes
@@ -1490,7 +1524,7 @@ picker on` fetches this project's own access and writes the three grounder
 
   That screen named one command:
 
-                      npx @unotest/web bundle push --run --env ENVIRONMENT
+                        npx @unotest/web bundle push --run --env ENVIRONMENT
 
   In a project that has just been created, the command refuses with `no box
 address` before it does anything: the project holds neither the box's address
@@ -1499,8 +1533,8 @@ address` before it does anything: the project holds neither the box's address
 
   The screen now names both steps, in the order they have to happen:
 
-                      npx @unotest/web box access larch
-                      npx @unotest/web bundle push --run --env ENVIRONMENT
+                        npx @unotest/web box access larch
+                        npx @unotest/web bundle push --run --env ENVIRONMENT
 
   The box's own name is filled in when its licence carries one. `box access`
   with no name refuses, and its refusal offers to create a box — to somebody who

package/README.md

@@ -38,6 +38,8 @@ Testing a browser extension? `launch` in `unotest.config` starts the browser
 with a profile (`userDataDir`) and extra arguments (`args`, e.g.
 `--load-extension=./ext`; Chromium only). On a profile every scenario shares
 one browser context — no isolation between them, and the run log says so.
+`profile: 'per-test'` instead gives every test a new browser on a new,
+empty profile: a suite of N files runs on N profiles.
 
 ## 2. Open the viewer
 

package/dist/config/schema.d.ts

@@ -109,19 +109,19 @@ declare const FailureBundleConfigSchema: z.ZodObject<{
 type FailureBundleConfig = z.infer<typeof FailureBundleConfigSchema>;
 declare const DialogPolicySchema: z.ZodEnum<["accept", "dismiss", "manual"]>;
 type DialogPolicy = z.infer<typeof DialogPolicySchema>;
-declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>;
+declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>;
 type LinterRuleId = z.infer<typeof LinterRuleIdSchema>;
 declare const LinterSeveritySchema: z.ZodEnum<["off", "warn", "error"]>;
 type LinterSeverity = z.infer<typeof LinterSeveritySchema>;
 declare const LinterConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>, z.ZodEnum<["off", "warn", "error"]>>;
+    rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>, z.ZodEnum<["off", "warn", "error"]>>;
 }, "strict", z.ZodTypeAny, {
     enabled: boolean;
-    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
 }, {
     enabled: boolean;
-    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
 }>;
 type LinterConfig = z.infer<typeof LinterConfigSchema>;
 declare const QueueConfigSchema: z.ZodObject<{
@@ -201,6 +201,11 @@ declare const SandboxConfigSchema: z.ZodObject<{
      *  against it and may not escape it. Defaults to the project root
      *  (the runner's cwd). */
     uploadDir: z.ZodOptional<z.ZodString>;
+    /** More directories a scenario may read files from, beside the project
+     *  and the run's downloads: `readFile`, `waitForFile` and the other file
+     *  oracles. For a file a background process writes outside the project.
+     *  Relative entries resolve against `shellCwd`. */
+    readRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     shellCwd?: string | undefined;
     shellTimeoutMs?: number | undefined;
@@ -208,6 +213,7 @@ declare const SandboxConfigSchema: z.ZodObject<{
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
+    readRoots?: string[] | undefined;
 }, {
     shellCwd?: string | undefined;
     shellTimeoutMs?: number | undefined;
@@ -215,6 +221,7 @@ declare const SandboxConfigSchema: z.ZodObject<{
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
+    readRoots?: string[] | undefined;
 }>;
 type SandboxConfig = z.infer<typeof SandboxConfigSchema>;
 declare const WebServerConfigSchema: z.ZodObject<{
@@ -245,6 +252,93 @@ declare const WebServerConfigSchema: z.ZodObject<{
     timeoutMs?: number | undefined;
 }>;
 type WebServerConfig = z.infer<typeof WebServerConfigSchema>;
+/** `webServer`: one server, or several (a front and its fake backends),
+ *  each with its own readiness URL. Always a list once parsed, so no
+ *  consumer asks which form it got. Two entries on one URL would probe
+ *  the same server twice and start neither for sure — refused. */
+declare const WebServersConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
+    /** Shell command that starts the app under test (`npm run dev`,
+     *  `python manage.py runserver`, …). Runs in the user's shell from the
+     *  project root. */
+    command: z.ZodString;
+    /** URL probed for readiness — any HTTP response counts as up. Usually
+     *  equals `baseUrl`; declared explicitly because a dev server may
+     *  answer on a different path/port than the tests navigate to. */
+    url: z.ZodString;
+    /** When the URL is already up, reuse that server instead of spawning a
+     *  second one (default true — covers a dev server the user or the
+     *  viewer already started). `false` makes an occupied URL an error,
+     *  Playwright-style for CI strictness. */
+    reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+    /** How long to wait for the URL to come up after spawning. */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}, {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>, z.ZodArray<z.ZodObject<{
+    /** Shell command that starts the app under test (`npm run dev`,
+     *  `python manage.py runserver`, …). Runs in the user's shell from the
+     *  project root. */
+    command: z.ZodString;
+    /** URL probed for readiness — any HTTP response counts as up. Usually
+     *  equals `baseUrl`; declared explicitly because a dev server may
+     *  answer on a different path/port than the tests navigate to. */
+    url: z.ZodString;
+    /** When the URL is already up, reuse that server instead of spawning a
+     *  second one (default true — covers a dev server the user or the
+     *  viewer already started). `false` makes an occupied URL an error,
+     *  Playwright-style for CI strictness. */
+    reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+    /** How long to wait for the URL to come up after spawning. */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}, {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>, "many">]>, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}[], {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+} | {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}[]>, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}[], {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+} | {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}[]>;
 declare const EnvConfigSchema: z.ZodObject<{
     /** Variable names whose base `.env` value is deliberately shared by
      *  every environment. Only names that become a HOST are checked, so
@@ -262,7 +356,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
      *  is expected to be running already (current behaviour). When set, the
      *  CLI ensures it per run; `npx @unotest/web app-server` / the viewer
      *  hold a long-lived instance and runs then reuse it. */
-    webServer: z.ZodOptional<z.ZodObject<{
+    webServer: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         /** Shell command that starts the app under test (`npm run dev`,
          *  `python manage.py runserver`, …). Runs in the user's shell from the
          *  project root. */
@@ -288,7 +382,63 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         url: string;
         reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
-    }>>;
+    }>, z.ZodArray<z.ZodObject<{
+        /** Shell command that starts the app under test (`npm run dev`,
+         *  `python manage.py runserver`, …). Runs in the user's shell from the
+         *  project root. */
+        command: z.ZodString;
+        /** URL probed for readiness — any HTTP response counts as up. Usually
+         *  equals `baseUrl`; declared explicitly because a dev server may
+         *  answer on a different path/port than the tests navigate to. */
+        url: z.ZodString;
+        /** When the URL is already up, reuse that server instead of spawning a
+         *  second one (default true — covers a dev server the user or the
+         *  viewer already started). `false` makes an occupied URL an error,
+         *  Playwright-style for CI strictness. */
+        reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+        /** How long to wait for the URL to come up after spawning. */
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        command: string;
+        url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }, {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }>, "many">]>, {
+        command: string;
+        url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }[], {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[]>, {
+        command: string;
+        url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }[], {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[]>>;
     browsers: z.ZodArray<z.ZodEnum<["chromium", "firefox", "webkit"]>, "many">;
     channel: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["chrome", "msedge", "chrome-beta", "chromium"]>, z.ZodEffects<z.ZodLiteral<"bundled">, null, "bundled">, z.ZodNull]>>;
     viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -329,12 +479,15 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
      *  context per scenario. */
     launch: z.ZodOptional<z.ZodObject<{
         userDataDir: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodLiteral<"per-test">>;
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     }, {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     }>>;
     retry: z.ZodObject<{
@@ -432,6 +585,11 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
      *  Unset → 60000. A pass cut by it leaves the rest of the stand as the
      *  test set it, and the run result says which blocks did not finish. */
     teardownTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    /** Wall-clock budget of one test, a deadline: an action still running
+     *  when it runs out is cut there and the test fails, its teardown blocks
+     *  still play. Unset → 300000. `UNOTEST_MAX_DURATION_MS` overrides it for
+     *  a run; `setTestTimeout(ms)` inside a test overrides both for that test. */
+    testTimeoutMs: z.ZodOptional<z.ZodNumber>;
     /** Cross-environment declarations (`.env.<name>` overlays). */
     env: z.ZodObject<{
         /** Variable names whose base `.env` value is deliberately shared by
@@ -445,13 +603,13 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     }>;
     linter: z.ZodObject<{
         enabled: z.ZodBoolean;
-        rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>, z.ZodEnum<["off", "warn", "error"]>>;
+        rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format"]>, z.ZodEnum<["off", "warn", "error"]>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     }, {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     }>;
     mcp: z.ZodObject<{
         transport: z.ZodLiteral<"stdio">;
@@ -528,6 +686,11 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
          *  against it and may not escape it. Defaults to the project root
          *  (the runner's cwd). */
         uploadDir: z.ZodOptional<z.ZodString>;
+        /** More directories a scenario may read files from, beside the project
+         *  and the run's downloads: `readFile`, `waitForFile` and the other file
+         *  oracles. For a file a background process writes outside the project.
+         *  Relative entries resolve against `shellCwd`. */
+        readRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
         shellCwd?: string | undefined;
         shellTimeoutMs?: number | undefined;
@@ -535,6 +698,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     }, {
         shellCwd?: string | undefined;
         shellTimeoutMs?: number | undefined;
@@ -542,6 +706,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     env: {
@@ -573,7 +738,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
@@ -595,6 +760,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
     baseUrl?: string | undefined;
     webServer?: {
@@ -602,7 +768,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         url: string;
         reuseExistingServer: boolean;
         timeoutMs: number;
-    } | undefined;
+    }[] | undefined;
     channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | null | undefined;
     viewport?: {
         width?: number | undefined;
@@ -615,10 +781,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     maxContexts?: number | undefined;
     launch?: {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
 }, {
     env: {
         shared?: string[] | undefined;
@@ -649,7 +817,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
@@ -665,6 +833,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
     baseUrl?: string | undefined;
     webServer?: {
@@ -672,7 +841,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         url: string;
         reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
-    } | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[] | undefined;
     channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | "bundled" | null | undefined;
     viewport?: {
         width?: number | undefined;
@@ -685,10 +859,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     maxContexts?: number | undefined;
     launch?: {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
     schedules?: {
         collection: string;
         cron: string;
@@ -725,7 +901,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
@@ -747,6 +923,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
     baseUrl?: string | undefined;
     webServer?: {
@@ -754,7 +931,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         url: string;
         reuseExistingServer: boolean;
         timeoutMs: number;
-    } | undefined;
+    }[] | undefined;
     channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | null | undefined;
     viewport?: {
         width?: number | undefined;
@@ -767,10 +944,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     maxContexts?: number | undefined;
     launch?: {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
 }, {
     env: {
         shared?: string[] | undefined;
@@ -801,7 +980,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
@@ -817,6 +996,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
     baseUrl?: string | undefined;
     webServer?: {
@@ -824,7 +1004,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
         url: string;
         reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
-    } | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[] | undefined;
     channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | "bundled" | null | undefined;
     viewport?: {
         width?: number | undefined;
@@ -837,10 +1022,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     maxContexts?: number | undefined;
     launch?: {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
     schedules?: {
         collection: string;
         cron: string;
@@ -852,4 +1039,4 @@ type UnotestConfig = z.infer<typeof UnotestConfigSchema>;
 type UnotestConfigInput = z.input<typeof UnotestConfigSchema>;
 declare const DEFAULT_CONFIG: UnotestConfig;
 
-export { BROWSER_CHANNEL_WORDS, type Browser, type BrowserChannel, BrowserChannelSchema, BrowserSchema, DEFAULT_CONFIG, type DialogPolicy, DialogPolicySchema, type EnvConfig, EnvConfigSchema, type FailureBundleConfig, FailureBundleConfigSchema, type LinterConfig, LinterConfigSchema, type LinterRuleId, LinterRuleIdSchema, type LinterSeverity, LinterSeveritySchema, type McpConfig, McpConfigSchema, type QueueConfig, QueueConfigSchema, type RetryConfig, RetryConfigSchema, type RetryReason, RetryReasonSchema, SYSTEM_BROWSER_CHANNELS, type SandboxConfig, SandboxConfigSchema, type ScheduleConfig, ScheduleSchema, type UnotestConfig, type UnotestConfigInput, UnotestConfigSchema, type Viewport, ViewportSchema, type WebServerConfig, WebServerConfigSchema };
+export { BROWSER_CHANNEL_WORDS, type Browser, type BrowserChannel, BrowserChannelSchema, BrowserSchema, DEFAULT_CONFIG, type DialogPolicy, DialogPolicySchema, type EnvConfig, EnvConfigSchema, type FailureBundleConfig, FailureBundleConfigSchema, type LinterConfig, LinterConfigSchema, type LinterRuleId, LinterRuleIdSchema, type LinterSeverity, LinterSeveritySchema, type McpConfig, McpConfigSchema, type QueueConfig, QueueConfigSchema, type RetryConfig, RetryConfigSchema, type RetryReason, RetryReasonSchema, SYSTEM_BROWSER_CHANNELS, type SandboxConfig, SandboxConfigSchema, type ScheduleConfig, ScheduleSchema, type UnotestConfig, type UnotestConfigInput, UnotestConfigSchema, type Viewport, ViewportSchema, type WebServerConfig, WebServerConfigSchema, WebServersConfigSchema };