doc-detective 4.41.6 → 4.42.0

package/dist/common/src/types/generated/config_v3.d.ts

@@ -363,7 +363,7 @@ export type Condition11 = string | [string, ...string[]];
 /**
  * Click or tap an element.
  */
-export type Click1 = ClickElementSimple | ClickElementDetailed | boolean;
+export type Click1 = (true | false) | ClickElementSimple | ClickElementDetailed;
 /**
  * Identifier for the element to click. Can be a selector, element text, ARIA name, ID, or test ID.
  */
@@ -419,7 +419,7 @@ export type ClickElementDetailed = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -674,7 +674,7 @@ export type FindElementDetailed = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -740,7 +740,7 @@ export type ByName5 = string;
 /**
  * Click or tap an element.
  */
-export type Click2 = ClickElementSimple1 | ClickElementDetailed1 | boolean;
+export type Click2 = (true | false) | ClickElementSimple1 | ClickElementDetailed1;
 /**
  * Identifier for the element to click. Can be a selector, element text, ARIA name, ID, or test ID.
  */
@@ -796,7 +796,7 @@ export type ClickElementDetailed1 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -891,7 +891,7 @@ export type TypeKeysDetailed = {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -988,7 +988,7 @@ export type ElementCriteria = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -1037,7 +1037,7 @@ export type ElementCriteria1 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -1307,7 +1307,7 @@ export type GoToURLDetailed = {
              * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
              */
             elementAttribute?: {
-                [k: string]: string | number | boolean;
+                [k: string]: boolean | number | string;
             };
             /**
              * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -1516,9 +1516,9 @@ export type HTTPRequestDetailed = ({
     url?: HTTPRequestSimple1;
     openApi?: (string & OperationID) | (OpenApi & OpenAPIDefinitionHttpRequest);
     /**
-     * Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.
+     * Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails. A single integer is treated as a one-item list.
      */
-    statusCodes?: number[];
+    statusCodes?: number | number[];
     /**
      * Method of the HTTP request
      */
@@ -2342,7 +2342,7 @@ export type TypeKeysDetailed1 = {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -2439,7 +2439,7 @@ export type ElementCriteria2 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -2488,7 +2488,7 @@ export type ElementCriteria3 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -2654,7 +2654,11 @@ export type Condition59 = string | [string, ...string[]];
 /**
  * Takes a screenshot in PNG format.
  */
-export type Screenshot1 = ScreenshotSimple | CaptureScreenshotDetailed | CaptureScreenshot;
+export type Screenshot1 = CaptureScreenshot | ScreenshotSimple | CaptureScreenshotDetailed;
+/**
+ * If `true`, captures a screenshot. If `false`, doesn't capture a screenshot.
+ */
+export type CaptureScreenshot = boolean;
 /**
  * File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.
  */
@@ -2750,7 +2754,7 @@ export type CropByElementDetailed = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -2945,10 +2949,6 @@ export type ExactlyOneAnnotationType = {
 } | {
     [k: string]: unknown;
 };
-/**
- * If `true`, captures a screenshot. If `false`, doesn't capture a screenshot.
- */
-export type CaptureScreenshot = boolean;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -3312,7 +3312,11 @@ export type Condition71 = string | [string, ...string[]];
 /**
  * Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself — `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]
  */
-export type Record1 = RecordSimple | RecordDetailed | RecordBoolean;
+export type Record1 = RecordBoolean | RecordSimple | RecordDetailed;
+/**
+ * If `true`, starts recording — auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record.
+ */
+export type RecordBoolean = boolean;
 /**
  * File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.
  */
@@ -3374,10 +3378,6 @@ export type RecordingCheckpoints = RecordingCheckpointsBoolean | RecordingCheckp
  * If `true`, enables checkpoints with default settings.
  */
 export type RecordingCheckpointsBoolean = boolean;
-/**
- * If `true`, starts recording — auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record.
- */
-export type RecordBoolean = boolean;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -4001,7 +4001,7 @@ export type ElementCriteria4 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -4060,7 +4060,7 @@ export type ElementCriteria5 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -4426,7 +4426,7 @@ export type ElementDetailed = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -4481,7 +4481,7 @@ export type ElementDetailed1 = ({
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: string | number | boolean;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -5127,10 +5127,9 @@ export type Condition119 = string | [string, ...string[]];
 /**
  * Pause (in milliseconds) before performing the next action.
  */
-export type Wait1 = WaitSimple | WaitEnvironmentVariable | WaitBoolean;
-export type WaitSimple = number;
+export type Wait1 = WaitSimple | WaitEnvironmentVariable;
+export type WaitSimple = number | boolean;
 export type WaitEnvironmentVariable = string;
-export type WaitBoolean = boolean;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -5738,9 +5737,9 @@ export type HerettoCMSIntegrations = HerettoCMSIntegration[];
  */
 export interface Config {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/config_v3.schema.json";
+    $schema?: string;
     /**
      * Identifier for the configuration.
      */
@@ -5884,9 +5883,9 @@ export interface Config {
  */
 export interface Context {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/context_v3.schema.json";
+    $schema?: string;
     /**
      * Unique identifier for the context.
      */
@@ -5928,6 +5927,10 @@ export interface Browser {
      * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
      */
     explicit?: boolean;
+    /**
+     * The browser version the session reported, for example `131.0.6778.85`. Present only in test results, for contexts that started a browser. System-populated: an authored value is dropped during context resolution.
+     */
+    version?: string;
     /**
      * If `true`, runs the browser in headless mode.
      */
@@ -5973,6 +5976,10 @@ export interface Browser1 {
      * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
      */
     explicit?: boolean;
+    /**
+     * The browser version the session reported, for example `131.0.6778.85`. Present only in test results, for contexts that started a browser. System-populated: an authored value is dropped during context resolution.
+     */
+    version?: string;
     /**
      * If `true`, runs the browser in headless mode.
      */
@@ -6109,9 +6116,9 @@ export interface MarkupDefinition {
 }
 export interface Common {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -6168,6 +6175,10 @@ export interface Common {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -6338,6 +6349,10 @@ export interface CheckLinkDetailed1 {
      * Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.
      */
     statusCodes?: number | number[];
+    /**
+     * Time each request attempt may take, in milliseconds. If no response arrives in time, the step fails.
+     */
+    timeout?: number;
     /**
      * Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).
      */
@@ -6351,9 +6366,9 @@ export interface RequestHeadersObject {
 }
 export interface Common1 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -6410,6 +6425,10 @@ export interface Common1 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -6629,9 +6648,9 @@ export interface ByCriteria2 {
 }
 export interface Common2 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -6688,6 +6707,10 @@ export interface Common2 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -7108,9 +7131,9 @@ export interface ABrowserEngineStringSurfaceTakesBrowserReadiness {
 }
 export interface Common3 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -7167,6 +7190,10 @@ export interface Common3 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -7374,9 +7401,9 @@ export interface NewWindowConflictsWithASurfaceWindowOrTabSelector {
 }
 export interface Common4 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -7433,6 +7460,10 @@ export interface Common4 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -7656,9 +7687,9 @@ export interface ResponseBodyObject {
 }
 export interface Common5 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -7715,6 +7746,10 @@ export interface Common5 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -7939,16 +7974,25 @@ export interface RunShellCommandDetailed {
             delayMs?: number;
         };
         /**
-         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. `true` or `{}` uses a terminal 120 columns wide by 30 rows tall. An object with `cols` and `rows` sets the size, for TUIs whose layout depends on the width. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
          */
-        tty?: boolean;
+        tty?: boolean | {
+            /**
+             * Terminal width in columns (what the process reads as `process.stdout.columns`).
+             */
+            cols?: number;
+            /**
+             * Terminal height in rows (what the process reads as `process.stdout.rows`).
+             */
+            rows?: number;
+        };
     };
 }
 export interface Common6 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -8005,6 +8049,10 @@ export interface Common6 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -8229,17 +8277,26 @@ export interface RunCodeDetailed {
             delayMs?: number;
         };
         /**
-         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. `true` or `{}` uses a terminal 120 columns wide by 30 rows tall. An object with `cols` and `rows` sets the size, for TUIs whose layout depends on the width. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
          */
-        tty?: boolean;
+        tty?: boolean | {
+            /**
+             * Terminal width in columns (what the process reads as `process.stdout.columns`).
+             */
+            cols?: number;
+            /**
+             * Terminal height in rows (what the process reads as `process.stdout.rows`).
+             */
+            rows?: number;
+        };
     };
     [k: string]: unknown;
 }
 export interface Common7 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -8296,6 +8353,10 @@ export interface Common7 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -8533,9 +8594,9 @@ export interface ByCriteria15 {
 }
 export interface Common8 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -8592,6 +8653,10 @@ export interface Common8 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -8863,9 +8928,9 @@ export interface ABrowserEngineStringSurfaceTakesBrowserReadiness1 {
 }
 export interface Common9 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -8922,6 +8987,10 @@ export interface Common9 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -9251,7 +9320,7 @@ export interface ElementFindingFields {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9306,7 +9375,7 @@ export interface ElementFindingFields1 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9361,7 +9430,7 @@ export interface ElementFindingFields2 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9416,7 +9485,7 @@ export interface ElementFindingFields3 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9471,7 +9540,7 @@ export interface ElementFindingFields4 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9526,7 +9595,7 @@ export interface ElementFindingFields5 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -9679,9 +9748,9 @@ export interface AppCapturesDonTSupportCropYet {
 }
 export interface Common10 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -9738,6 +9807,10 @@ export interface Common10 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -9888,9 +9961,9 @@ export interface SaveCookie {
 }
 export interface Common11 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -9947,6 +10020,10 @@ export interface Common11 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -10241,9 +10318,9 @@ export interface RecordingCheckpointsDetailed {
 }
 export interface Common12 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -10300,6 +10377,10 @@ export interface Common12 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -10456,9 +10537,9 @@ export interface StopRecordDetailed {
 }
 export interface Common13 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -10515,6 +10596,10 @@ export interface Common13 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -10815,9 +10900,9 @@ export interface ByCriteria30 {
 }
 export interface Common14 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -10874,6 +10959,10 @@ export interface Common14 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -11183,9 +11272,18 @@ export interface ProcessDescriptor {
      */
     workingDirectory?: string;
     /**
-     * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the descriptor is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+     * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. `true` or `{}` uses a terminal 120 columns wide by 30 rows tall. An object with `cols` and `rows` sets the size, for TUIs whose layout depends on the width. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the descriptor is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
      */
-    tty?: boolean;
+    tty?: boolean | {
+        /**
+         * Terminal width in columns (what the process reads as `process.stdout.columns`).
+         */
+        cols?: number;
+        /**
+         * Terminal height in rows (what the process reads as `process.stdout.rows`).
+         */
+        rows?: number;
+    };
     /**
      * Conditions that must all be met before the process is considered ready and the descriptor completes. Omit to consider the process ready as soon as it is spawned. Specify any combination; every condition given must pass before `timeout` elapses. Note: a process that forks a daemon and then exits (common for some Docker images and databases) is treated as having exited before becoming ready and the descriptor fails — use `port`, `httpGet`, or `delayMs` for those rather than a condition that depends on the foreground process staying alive.
      */
@@ -11373,9 +11471,18 @@ export interface ProcessDescriptor1 {
      */
     workingDirectory?: string;
     /**
-     * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the descriptor is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+     * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. `true` or `{}` uses a terminal 120 columns wide by 30 rows tall. An object with `cols` and `rows` sets the size, for TUIs whose layout depends on the width. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the descriptor is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
      */
-    tty?: boolean;
+    tty?: boolean | {
+        /**
+         * Terminal width in columns (what the process reads as `process.stdout.columns`).
+         */
+        cols?: number;
+        /**
+         * Terminal height in rows (what the process reads as `process.stdout.rows`).
+         */
+        rows?: number;
+    };
     /**
      * Conditions that must all be met before the process is considered ready and the descriptor completes. Omit to consider the process ready as soon as it is spawned. Specify any combination; every condition given must pass before `timeout` elapses. Note: a process that forks a daemon and then exits (common for some Docker images and databases) is treated as having exited before becoming ready and the descriptor fails — use `port`, `httpGet`, or `delayMs` for those rather than a condition that depends on the foreground process staying alive.
      */
@@ -11404,9 +11511,9 @@ export interface ProcessDescriptor1 {
 }
 export interface Common15 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -11463,6 +11570,10 @@ export interface Common15 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -11613,9 +11724,9 @@ export interface LoadVariables1 {
 }
 export interface Common16 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -11672,6 +11783,10 @@ export interface Common16 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -11892,9 +12007,9 @@ export interface ByCriteria32 {
 }
 export interface Common17 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -11951,6 +12066,10 @@ export interface Common17 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -12101,9 +12220,9 @@ export interface LoadCookie {
 }
 export interface Common18 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -12160,6 +12279,10 @@ export interface Common18 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -12501,9 +12624,9 @@ export interface ByCriteria38 {
 }
 export interface Common19 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -12560,6 +12683,10 @@ export interface Common19 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -12710,9 +12837,9 @@ export interface Wait {
 }
 export interface Common20 {
     /**
-     * JSON Schema for this object.
+     * JSON Schema URL for editor support. Doc Detective ignores it.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    $schema?: string;
     /**
      * ID of the step.
      */
@@ -12769,6 +12896,10 @@ export interface Common20 {
      * Wall-clock duration of this step in milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's elapsed time — the attempt the reported `result` describes — not the sum across attempts. A step that was skipped or never executed reports `0`. Distinct from the `duration` input that some actions accept (for example a `click`'s press duration). Present only in test results; system-populated.
      */
     durationMs?: number;
+    /**
+     * When this step started, as an ISO 8601 UTC timestamp with milliseconds. When a routing `retry` action re-ran the step, this is the FINAL attempt's start, matching `durationMs`. Absent for a step that was skipped or never executed. Present only in test results; system-populated.
+     */
+    startedAt?: string;
     [k: string]: unknown;
 }
 /**
@@ -13008,7 +13139,7 @@ export interface ElementFindingFields6 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13063,7 +13194,7 @@ export interface ElementFindingFields7 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13118,7 +13249,7 @@ export interface ElementFindingFields8 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13173,7 +13304,7 @@ export interface ElementFindingFields9 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13228,7 +13359,7 @@ export interface ElementFindingFields10 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13283,7 +13414,7 @@ export interface ElementFindingFields11 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13483,7 +13614,7 @@ export interface ElementFindingFields12 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13538,7 +13669,7 @@ export interface ElementFindingFields13 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13593,7 +13724,7 @@ export interface ElementFindingFields14 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13648,7 +13779,7 @@ export interface ElementFindingFields15 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13703,7 +13834,7 @@ export interface ElementFindingFields16 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13758,7 +13889,7 @@ export interface ElementFindingFields17 {
      * Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.
      */
     elementAttribute?: {
-        [k: string]: number | boolean | string;
+        [k: string]: boolean | number | string;
     };
     /**
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
@@ -13971,9 +14102,18 @@ export interface RunShellCommandDetailed1 {
             delayMs?: number;
         };
         /**
-         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. `true` or `{}` uses a terminal 120 columns wide by 30 rows tall. An object with `cols` and `rows` sets the size, for TUIs whose layout depends on the width. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
          */
-        tty?: boolean;
+        tty?: boolean | {
+            /**
+             * Terminal width in columns (what the process reads as `process.stdout.columns`).
+             */
+            cols?: number;
+            /**
+             * Terminal height in rows (what the process reads as `process.stdout.rows`).
+             */
+            rows?: number;
+        };
     };
 }
 /**
@@ -14122,9 +14262,21 @@ export interface EnvironmentDetails {
      */
     platform: "linux" | "mac" | "windows";
     /**
-     * The processor architecture of the system running Doc Detective.
+     * The processor architecture of the system running Doc Detective, as reported by Node.js `os.arch()`.
+     */
+    arch?: "arm" | "arm64" | "ia32" | "loong64" | "mips" | "mipsel" | "ppc" | "ppc64" | "riscv64" | "s390" | "s390x" | "x64";
+    /**
+     * The version of Doc Detective that ran, for example `4.42.0`.
+     */
+    docDetectiveVersion?: string;
+    /**
+     * The Node.js version that ran Doc Detective, without the leading `v`, for example `24.15.0`.
+     */
+    nodeVersion?: string;
+    /**
+     * The operating system release, as Node.js's `os.release()` reports it, for example `6.8.0-1017-azure` on Linux or `10.0.26200` on Windows.
      */
-    arch?: "arm32" | "arm64" | "x32" | "x64";
+    osRelease?: string;
 }
 /**
  * Default visual theme for screenshot and recording annotations. Specs and tests can override this value with their own `annotationDefaults` fields (test level wins over spec level, which wins over config level), and an individual annotation's `style` wins over all of them. Fields left unset fall back to Doc Detective's built-in theme. Setting a theme here keeps every annotated image in a doc set visually consistent.